# GroupDocs — Complete Documentation

> Central documentation index for GroupDocs on-premise document processing SDKs. Explore developer documentation and guides for all product families.

---

## .NET Standard 2.0 API Limitations

Path: /signature/net/net-standard-2-0-api-limitations/

## Limitations of .NET Standard 2.0 compared to .NET API

### Limitations

1. Because of the lack of Windows fonts in target OS (Android, macOS, Linux, etc), fonts used in documents are substituted with available fonts, this might lead to inaccurate document layout when rendering the document to PNG, JPG, and PDF.
2. If GroupDocs.Signature for .NET Standard is intended to be used in a Linux environment, an additional NuGet package should be referenced to make it work correctly with graphics: [SkiaSharp.NativeAssets.Linux](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux) for Ubuntu (it also should work on most Debian-based Linux distributions) or [Goelze.SkiaSharp.NativeAssets.AlpineLinux](https://www.nuget.org/packages/Goelze.SkiaSharp.NativeAssets.AlpineLinux) for Alpine Linux.  

#### Recommendations

When using GroupDocs.Signature in a non-Windows environment in order to improve rendering results we do recommend installing the following packages:

1. libgdiplus - is the Mono library that provides a GDI+-compatible API on non-Windows operating systems.
2. libc6-dev - package contains the symlinks, headers, and object files needed to compile and link programs which use the standard C library.
3. ttf-mscorefonts-installer - package with Microsoft compatible fonts.

To install packages on Debian-based Linux distributions use [apt-get](https://wiki.debian.org/apt-get) utility:

1. sudo apt-get install libgdiplus
2. sudo apt-get install libc6-dev
3. sudo apt-get install ttf-mscorefonts-installer

---

## Load document from Amazon S3 Storage

Path: /signature/java/load-document-from-amazon-s3-storage/

Following example demonstrates how to process with documents from Amazon S3 Storage.

```java
public static void run()
{
    String key = "sample.docx";
    try {
        InputStream stream = downloadFile(key);
 
        Signature signature = new Signature(stream);
 
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
        options.setEncodeType(QrCodeTypes.QR);
        options.setLeft(100);
        options.setTop(100);
 
        // sign document to file
        signature.sign("signedSample.docx", options);
 
        System.out.print("\nSource document signed successfully.\n" );
    }catch(Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
public static InputStream downloadFile(String key)
{
    AWSCredentials credentials = new BasicAWSCredentials(
            "<AWS accesskey>",
            "<AWS secretkey>"
    );
    AmazonS3 s3client = AmazonS3ClientBuilder.standard()
                                             .withCredentials(new AWSStaticCredentialsProvider(credentials))
                                             .withRegion(Regions.US_EAST_2)
                                             .build();
    String bucketName = "my-bucket";
 
    S3Object s3object = s3client.getObject(bucketName, key);
    S3ObjectInputStream inputStream = s3object.getObjectContent();
    return inputStream;
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to load document from Amazon S3 Storage

Path: /signature/net/load-document-from-amazon-s3-storage/

Following example demonstrates how to process with documents from Amazon S3 Storage.

```csharp
public static void Run()
{
    string key = "sample.docx";
    string outputFilePath = "SignedSample";
    using (Stream stream = DownloadFile(key))
    {
        using (Signature signature = new Signature(stream))
        {
            QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
            {
                EncodeType = QRCodeTypes.QR,
                Left = 100,
                Top = 100
            };
            // sign document to file
            signature.Sign(outputFilePath, options);
        }
    }
    Console.WriteLine("\nSource document signed successfully.\nFile saved at " + outputFilePath);
}

public static Stream DownloadFile(string key)
{
    AmazonS3Client client = new AmazonS3Client();
    string bucketName = "my-bucket";
    GetObjectRequest request = new GetObjectRequest
    {
        Key = key,
        BucketName = bucketName
    };
    using (GetObjectResponse response = client.GetObject(request))
    {
        MemoryStream stream = new MemoryStream();
        response.ResponseStream.CopyTo(stream);
        stream.Position = 0;
        return stream;
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign Document with Barcode Signature

Path: /signature/python-net/esign-document-with-barcode-signature/

## What is a Barcode?

A **barcode** or **bar code** is a way of presenting data in a visual, machine-readable form. Generally speaking, barcode is an image of a rectangular form that consists of parallel black lines and white spaces of different widths.  
Barcodes are used in various areas where quick identification is necessary - as part of the purchase process in retail stores, in warehouses to track inventory, and on invoices to assist in accounting, among many other uses.

![Barcode](/signature/python-net/images/esign-document-with-barcode-signature.gif)

Barcodes allow storing of product-related data like manufacturing and expiry dates, manufacturer name, country of origin, and product price. There are plenty of barcode types nowadays because different companies use different combinations of numbers and bars in their barcodes depending on their needs. From the document signature perspective, Barcode may contain different characters (letters, digits, or symbols) and may have various lengths and sizes depending on the type and settings to keep signature information, title, subject, or short encrypted data.  

## How to eSign Document with Barcode Signature

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) supports a wide range of Barcode types that can be used to create electronic signatures within the documents. Please refer to the [BarcodeTypes](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/barcodetypes/#fields) description to get the full list of supported barcodes.  
To specify different options for Barcode signature GroupDocs.Signature for Python via .NET provides [BarcodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesignoptions) class. The main fields are:

* [encode_type](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesignoptions/encode_type) - specifies the Barcode type (AustralianPost, Codabar, EAN13, OPC, etc.);
* [text](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions/text) - specifies the Barcode text.

Here are the steps to eSign a document with the Barcode signature using GroupDocs.Signature for Python via .NET API:
* Create a new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [BarcodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesignoptions) object according to your requirements and specify the Barcode type by setting the [encode_type](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesignoptions/encode_type) property with one of the predefined supported types. Set the [text](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions/text) property value.
* Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [BarcodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesignoptions) to it.

This example shows how to sign a PDF document with a Barcode signature using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import BarcodeSignOptions
from groupdocs.signature.domain import BarcodeTypes
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create barcode signature options
        options = BarcodeSignOptions()
        
        # Set barcode text
        options.text = "John Smith"
        
        # Set barcode type
        options.encode_type = BarcodeTypes.QR
        
        # Set barcode position
        options.left = 100
        options.top = 100
        
        # Set barcode size
        options.width = 100
        options.height = 100
        
        # Set barcode colors
        options.fore_color = gsd.Color.BLUE
        options.back_color = gsd.Color.WHITE
        options.border_color = gsd.Color.BLACK
        
        # Set barcode border
        options.border_visiblity = True
        options.border_dash_style = gsd.DashStyle.DASH
        options.border_weight = 2
        
        # Sign document
        sign.sign("./SampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-barcode-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Barcode Signature Options

You can customize the barcode signature further with additional options:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import BarcodeSignOptions
from groupdocs.signature.domain import BarcodeTypes
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create barcode signature options
        options = BarcodeSignOptions("JohnSmith")
        
        # Setup Barcode encoding type
        options.encode_type = BarcodeTypes.QR
        
        # Set signature position and size
        options.left = 100
        options.top = 100
        options.width = 200
        options.height = 100
        
        # Set advanced options
        options.fore_color = gsd.Color.BLUE
        options.back_color = gsd.Color.WHITE
        options.opacity = 0.8
        options.rotation_angle = 45
        
        # Set barcode alignment
        options.horizontal_alignment = gsd.HorizontalAlignment.CENTER
        options.vertical_alignment = gsd.VerticalAlignment.CENTER
        
        # Add border
        options.border_color = gsd.Color.BLACK
        options.border_dash_style = gsd.DashStyle.SOLID
        options.border_weight = 2
        
        # Sign document
        sign.sign("./SampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-barcode-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Different Barcode Types

GroupDocs.Signature supports various barcode types. Here's an example showing how to use different barcode types:

{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import BarcodeSignOptions
from groupdocs.signature.domain import BarcodeTypes

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create barcode signature options
    options = BarcodeSignOptions("1234567890")
    
    # Setup different Barcode encoding types
    # For numeric data
    options.encode_type = BarcodeTypes.EAN_13
    
    # For alphanumeric data
    # options.encode_type = BarcodeTypes.CODE_128
    
    # For QR codes
    # options.encode_type = BarcodeTypes.QR
    
    # For 2D barcodes
    # options.encode_type = BarcodeTypes.DATA_MATRIX
    
    # Set signature position
    options.left = 100
    options.top = 100
    
    # Sign document
    sign.sign("SampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-barcode-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide demonstrates how to use [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) to add barcode-based signatures to documents. It covers creating, configuring, and applying barcode signatures with support for various barcode types and customization options. For further exploration, refer to related guides on document information and advanced signing techniques.




## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)


### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign Image with Metadata signature

Path: /signature/python-net/esign-image-with-metadata-signature/

## Overview 
Metadata signature for Image document is an electronic signature based on image metadata standard. Most image formats support metadata specification or [EXIF](https://en.wikipedia.org/wiki/Exif). Image metadata is dictionary map with unique whole short identifier in range 0-65535, Some identifiers are reserved by [EXIF specification.](https://www.exiv2.org/tags.html) From signature perspective image metadata may content any hidden value of standard (int,char, string) or custom type (user defined class), be encrypted and decrypted back by known key over Search method.

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [ImageMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/imagemetadatasignature) class to specify Metadata e-signature for image documents. Image document metadata contains pair with unique identifier Id and its Value.  
Image document metadata could keep big amount of data that provides ability to keep serialized custom objects with additional encryption in there.

### Here are the steps to add metadata signatures into Image with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several [ImageMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/imagemetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Image with Metadata signature

This example shows how to sign png image with metadata e-signatures

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import MetadataSignOptions
from groupdocs.signature.domain import ImageMetadataSignature
from datetime import datetime

# Initialize signature
with signature.Signature("sample.png") as sign:
    # Create metadata options
    options = MetadataSignOptions()
    
    # Specify different Metadata Signatures and add them to options signature collection
    imgs_metadata_id = 41996
    
    # Create several Image Metadata signatures with different types
    options.add(ImageMetadataSignature(imgs_metadata_id, "Mr.Scherlock Holmes"))  # String value
    imgs_metadata_id += 1
    options.add(ImageMetadataSignature(imgs_metadata_id, datetime.now()))         # Date Time value
    imgs_metadata_id += 1
    options.add(ImageMetadataSignature(imgs_metadata_id, 123456))                 # Integer value
    imgs_metadata_id += 1
    options.add(ImageMetadataSignature(imgs_metadata_id, 123.456))                # Double value
    imgs_metadata_id += 1
    options.add(ImageMetadataSignature(imgs_metadata_id, 123.456))                # Decimal value
    imgs_metadata_id += 1
    options.add(ImageMetadataSignature(imgs_metadata_id, 123.456))                # Float value
    
    # Sign document
    sign.sign("SampleSigned.png", options)
```

{{< /tab >}}
{{< tab "sample.png" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.png](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-metadata-signature/esign-image-with-metadata-signature/sample.png)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign document with Barcode signature

Path: /signature/java/esign-document-with-barcode-signature/

## What is a Barcode?

A **barcode** or **bar code** is a way of presenting data in a visual, machine-readable form. Generally speaking, barcode is an image of rectangular form that consists of parallel black lines and white spaces of different widths.  
Barcodes are used in various areas where quick identification is necessary - as part of the purchase process in retail stores, in warehouses to track inventory, and on invoices to assist in accounting, among many other uses.

![](/signature/java/images/esign-document-with-barcode-signature.gif)

Barcodes allow to store product related data like manufacturing and expiry dates, manufacturer name, country of the origin and product price. There are plenty of barcode types nowadays because different companies use different amount of number and bar combinations in their barcodes dependent on their needs. From document signature perspective Barcode may contain different characters (letters, digits or symbols) and have a various length and its size depending on the type and settings to keep signature information, title, subject or short encrypted data.  

## eSign document with Barcode signature

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) for Java supports wide range or Barcode types that can be used to create electronic signature within the documents. Please refer to [BarcodeTypes](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.barcodes/BarcodeTypes) description to get the full list of supported barcodes.  
To specify different options for Barcode signature GroupDocs.Signature for Java provides [BarcodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions) class. The main fields are:

*   [getEncodeType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions#getEncodeType()) - specifies Barcode type (AustralianPost, Codabar, EAN13, OPC, etc.);
*   [getText](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#getText()) - specifies Barcode text. 

Here are the steps to eSign document with Barcode signature using GroupDocs.Signature for .NET API:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [BarcodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions) object according to your requirements and specify Barcode type by setting [setEncodeType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions#setEncodeType()) from predefined supported types. Set [setText](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setText(java.lang.String)) property value.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [BarcodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions) to it.
    

This example shows how to sign PDF document with Barcode signature.

```java
Signature signature = new Signature("sample.pdf");
try 
{
    // setup options with text of signature
    BarcodeSignOptions signOptions = new BarcodeSignOptions("12345678");
    // setup Barcode encoding type
    signOptions.setEncodeType(BarcodeTypes.Code128);
    // set signature position
    signOptions.setLeft(100);
    signOptions.setTop(100);
    // sign document   
    signature.sign("SampleSigned.pdf", signOptions);    
}catch (Exception e){
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update Barcode signatures in document

Path: /signature/java/update-barcode-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) class to manipulate barcode signatures location, size and textual content. 

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to update Barcode signature in the document with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
*   Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [BarcodeSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature);      
*   Select from list [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) object(s) that should be updated;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    
This example shows how to update Barcode signature that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
Signature signature = new Signature("sampleSigned.pdf");
try 
{
    BarcodeSearchOptions options = new BarcodeSearchOptions();

    List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class,options);
    if (signatures.size() > 0)
    {

        BarcodeSignature barcodeSignature = signatures.get(0);
        barcodeSignature.setLeft(100);
        barcodeSignature.setTop(100);
        boolean result = signature.update("sampleSigned.pdf",barcodeSignature);
        if (result)
        {
            System.out.print("Signature with Barcode '"+barcodeSignature.getText()+"' and encode type '"+barcodeSignature.getEncodeType().getTypeName()+"' was updated in the document ['"+fileName+"'].");
        }
        else
        {
            System.out.print("Signature was not updated in the document! Signature with Barcode"+barcodeSignature.getText()+"' and encode type '"+barcodeSignature.getEncodeType().getTypeName()+"' was not found!");
        }
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update Barcode signatures in document

Path: /signature/net/update-barcode-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) class to manipulate barcode signatures location, size and textual content.
Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

### Here are the steps to update Barcode signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [BarcodeSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature);
* Select from list [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.

This example shows how to update Barcode signature that was found using  [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    BarcodeSearchOptions options = new BarcodeSearchOptions();
    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
    if (signatures.Count > 0)
    {
        BarcodeSignature barcodeSignature = signatures[0];
        // change position
        barcodeSignature.Left = 100;
        barcodeSignature.Top = 100;
        bool result = signature.Update(barcodeSignature);
        if (result)
        {
            Console.WriteLine($"Signature with Barcode '{barcodeSignature.Text}' was updated!");
        }
        else
        {
            Console.WriteLine($"Signature was not updated in the document!");
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Update Barcode signatures in document

Path: /signature/nodejs-java/update-barcode-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [BarcodeSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/barcodesignature) class to manipulate barcode signatures' location, size, and textual content. Please be aware that the [Update](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/update/) method modifies the same document that was passed to the constructor of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class.

### Here are the steps to update a Barcode signature in the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) object with the desired properties.
* Call the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method to obtain a list of [BarcodeSignatures](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/barcodesignature).
* Select from the list the [BarcodeSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/barcodesignature) object(s) that should be updated.
* Call the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) object's [Update](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/update/) method and pass one or several signatures to it.

This example shows how to update Barcode signature that was found using  [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method.

```csharp
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF_SIGNED; 
  const fileName = path.basename(filePath);

  // Copy source file since the update method works with the same document
  const outputFilePath = path.join(Constants.OutputPath, 'UpdateBarcode', fileName);
  const dir = path.dirname(outputFilePath);
  if (!fs.existsSync(dir)) {
      fs.mkdirSync(dir, { recursive: true });
  }

  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize BarcodeSearchOptions
  const options = new signatureLib.BarcodeSearchOptions();

  // Search for barcode signatures in the document
  const signatures = signature.search(signatureLib.BarcodeSignature.class, options).toArray();

  if (signatures.length > 0) {
    const barcodeSignature = signatures[0];
    barcodeSignature.setLeft(100);
    barcodeSignature.setTop(100);

    // Update the barcode signature in the document
    const result = signature.update(outputFilePath, barcodeSignature);

    if (result) {
      console.log(`\nSignature with Barcode '${barcodeSignature.getText()}' and encode type '${barcodeSignature.getEncodeType().getTypeName()}' was updated in the document ['${fileName}'].`);
    } else {
      console.log(`\nSignature was not updated in the document! Signature with Barcode '${barcodeSignature.getText()}' and encode type '${barcodeSignature.getEncodeType().getTypeName()}' was not found!`);
    }
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Implement custom encryption with QR-Code signatures

Path: /signature/net/implement-custom-encryption-with-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into QR-code signature custom objects. This feature is implemented over object serialization to string and further encryption. There is ability to provide custom encryption. This procedure requires implementation of interface [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) with two methods to encrypt and decrypt data.

Here are the steps to embed into QR-code text with custom encryption with GroupDocs.Signature:

* Define custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
* Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/formatattribute) attribute to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/skipserializationattribute) to mark property of class as not serialize
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object with [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) value  
* Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object according to your requirements and custom object to [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
// Define class that implements IDataEncryption interface
private class CustomXOREncryption : IDataEncryption
{
    /// <summary>
    /// Gets or sets non empty key for encryption (at least one character)
    /// </summary>
    public int Key { get; set; }
    /// <summary>
    /// Encode method to encrypt string.
    /// </summary>
    /// <param name="source">Source string to encode.</param>
    /// <returns>Returns enccrypted string</returns>
    public string Encode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Decode method to obtain decrypted string.
    /// </summary>
    /// <param name="source">Source string to decode.</param>
    /// <returns>Returns decrypted string</returns>
    public string Decode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Using XOR operation get encoded / decoded string
    /// </summary>
    /// <param name="source"></param>
    /// <returns></returns>
    private string Process(string source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.Length);
        char chTmp;
        for (int index = 0; index < src.Length; ++index)
        {
            chTmp = src[index];
            chTmp = (char)(chTmp ^ this.Key);
            dst.Append(chTmp);
        }
        return dst.ToString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Sign documents with custom encrypted objects and values into QR-code signatures

This example shows how to add custom object into metadata signature to Image document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create data encryption
    IDataEncryption encryption = new CustomXOREncryption();
    // create custom object
    DocumentSignatureData documentSignatureData = new DocumentSignatureData()
    {
        ID = Guid.NewGuid().ToString(),
        Author = Environment.UserName,
        Signed = DateTime.Now,
        DataFactor = 11.22M
    };
    // setup QR-Code options
    QrCodeSignOptions options = new QrCodeSignOptions()
    {
        // set custom object to serialize to QR Code
        Data = documentSignatureData,
        // QR-code type
        EncodeType = QrCodeTypes.QR,
        // specify serialization encryption
        DataEncryption = encryption,
        // locate and aligh signature
        Height = 100,
        Width = 100,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() { Right = 10, Bottom = 10 }
    };
    // sign document to file
    signature.Sign("QRCodeCustomEncryption.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign Image with Metadata signature

Path: /signature/java/esign-image-with-metadata-signature/

Metadata signature for Image document is an electronic signature based on image metadata standard. Most image formats support metadata specification or [EXIF](https://en.wikipedia.org/wiki/Exif). Image metadata is dictionary map with unique whole short identifier in range 0-65535, Some identifiers are reserved by [EXIF specification.](https://www.exiv2.org/tags.html) From signature perspective image metadata may content any hidden value of standard (int,char, string) or custom type (user defined class), be encrypted and decrypted back by known key over Search method.

GroupDocs.Signature provides [ImageMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/ImageMetadataSignature) class to specify Metadata e-signature for image documents. Image document metadata contains pair with unique identifier Id and its Value.  
Image document metadata could keep big amount of data that provides ability to keep serialized custom objects with additional encryption in there. See more examples [here]({{< ref "signature/java/developer-guide/advanced-usage/signing/sign-document-with-secure-custom-metadata-signatures/_index.md" >}}).

Here are the steps to add metadata signatures into Image with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements.    
*   Instantiate one or several [ImageMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/ImageMetadataSignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to metadata signatures collection ([getSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#getSignatures())) via [add](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignatureCollection#add(com.groupdocs.signature.domain.signatures.metadata.MetadataSignature)) or addRange method.    
*   Call [sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it.  

  

## How to eSign Image with Metadata signature

This example shows how to sign png image with metadata e-signatures

```java
Signature signature = new Signature("sample.jpg");

// create Metadata option with predefined Metadata text
MetadataSignOptions options = new MetadataSignOptions();

// Specify different Metadata Signatures and add them to options signature collection
int imgsMetadataId = 41996;

// Create several Image Metadata signatures with different types
ImageMetadataSignature[] signatures = new ImageMetadataSignature[]
        {
                new ImageMetadataSignature(imgsMetadataId++, 123456), // int
                new ImageMetadataSignature(imgsMetadataId++, "Mr.Scherlock Holmes"), // string
                new ImageMetadataSignature(imgsMetadataId++,new Date()), // date time
                new ImageMetadataSignature(imgsMetadataId++, 123.456), //decimal value
        };
options.getSignatures().addRange(signatures);

// sign document to file
signature.sign("SampleSigned.jpg", options);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.   
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Iterative Digital signing of the PDF document

Path: /signature/net/iterative-digital-signing-of-the-pdf-document/

 
### How to apply digital signatures iteratively to a PDF document
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) class to specify different amount of settings for Digital signature

* digital certificate (file on local disk [CertificateFilePath](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/certificatefilepath/) or stream [CertificateStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/certificatestream/)) (required)
* password of digital certificate [Password](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/password/) (required)
* digital signature details ([Reason](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/reason/), [Contact](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/contact/), [Location](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/location/))

### How to add Digital signature:

* Define the paths for the input PDF file, the digital certificates, and specify the output path where the signed documents will be saved.
* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with the required certificate and its password, and configure additional properties such as reason, contact, location, and position.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.
* After signing, update the document path for the next iteration.
* Analyze the [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) to check the newly created signatures if needed.
* Iterate through each certificate, repeating the above steps for each one.

This example demonstrates how to iteratively sign a PDF document with multiple digital certificates. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
string filePath = "sample.pdf";
string fileName = Path.GetFileName(filePath);

string[] certificatePaths = new string[] { "certificate1.pfx", "certificate2.pfx" };

string outputFilePath = Path.Combine("output folder path", "SignWithDigitalIterative", fileName);
int iteration = 1;
string documentFile = filePath;

foreach (var certificatePath in certificatePaths)
{
    using (Signature signature = new Signature(documentFile))
    {
        DigitalSignOptions options = new DigitalSignOptions(certificatePath)
        {
            Password = "1234567890", // Certificate password
            Reason = $"Approved-{iteration}", // Digital certificate details
            Contact = $"John{iteration} Smith{iteration}",
            Location = $"Location-{iteration}",
            AllPages = true, // Sign all pages
            Left = 10 + 100 * (iteration - 1),
            Top = 10 + 100 * (iteration - 1),
            Width = 160,
            Height = 80,
            Margin = new Padding() { Bottom = 10, Right = 10 }
        };

        SignResult signResult = signature.Sign(outputFilePath, options);
        documentFile = outputFilePath;
        Console.WriteLine($"\nSource document signed successfully {iteration++}-" +
                          $"time with {signResult.Succeeded.Count} signature(s).\n" +
                          $"File saved at {outputFilePath}.");
    }
}
```
### Iteratively sign with custom appearance and image

This example demonstrates how to iteratively sign a PDF document with multiple digital certificates, customizing the appearance and adding an image to each signature. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

Here are the steps:
* Setting up variables: define the paths for the input PDF file, the digital certificates, and specify the output path where the signed documents will be saved.
```csharp
// File paths for source document, image, and output files
string sourceFile = "sample.pdf";
string imageFilePath = "image.jpg";
string signedFile = "signed.pdf";
string resultOutputFile = "result.pdf";

// Paths to digital certificates for signing
string[] certificatePaths = new string[] { certificateFilePath1, certificateFilePath2 };
int iteration = 0;
```

* Helper method to generate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with the required certificate and its password, and configure additional properties such as reason, contact, location, and position. An image and custom appearance labels are also set.

```csharp
private static DigitalSignOptions CreateDigitalSignOptions(string certificatePath, 
    string imageFilePath, int iteration)
{
    return new DigitalSignOptions(certificatePath)
    {
        Password = "1234567890",             // Certificate password
        Reason = "Sign",                     // Signature reason
        Contact = $"JohnSmith{iteration}",   // Contact details
        Location = $"Office{iteration}",     // Signature location
        Visible = true,
        Left = 80 + iteration * 5,           // Positioning for visibility
        Top = 600 + iteration * 5,
        Height = 50 + iteration * 5,
        Width = 200 + iteration * 5,
        ImageFilePath = imageFilePath,       // Image appearance for signature
        Appearance = new PdfDigitalSignatureAppearance
        {
            ReasonLabel = "Reason Label",
            DigitalSignedLabel = "Digital Signed Label"
        }
    };
}
```

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.
* After signing, update the document path for the next iteration.
* Analyze the [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) to check the newly created signatures if needed.
* Iterate through each certificate, repeating the above steps for each one.

```csharp
foreach (var certificatePath in certificatePaths)
{
    using (Signature signature = new Signature("sample.pdf"))
    {
        // Generate signature options with helper method
        DigitalSignOptions options = CreateDigitalSignOptions(certificatePath, imageFilePath,
            iteration);

        // Update output file name on second iteration
        if (iteration == 1) signedFile = resultOutputFile;

        // Sign document and display result
        SignResult signResult = signature.Sign(signedFile, options);
        Console.WriteLine(
            $"\nDocument signed successfully {iteration + 1}-time with " +
            $"{signResult.Succeeded.Count} signature(s).\nFile saved at {signedFile}.");
        iteration++;
    }
}
```
### Customize digital appearance with color, image and font

This example demonstrates how to apply a digital signature with a customized appearance, including a foreground color, image, and specific font settings.

Here are the steps:
* Setting up variables: define the paths for the input PDF file, the digital certificates, and specify the output path where the signed documents will be saved.
```csharp
// File paths for source document, image, and output files
string sourceFile = "sample.pdf";
string imageFilePath = "image.jpg";
string signedFile = "signed.pdf";
string resultOutputFile = "result.pdf";

// Paths to digital certificates for signing
string[] certificatePaths = new string[] { certificateFilePath1, certificateFilePath2 };
int iteration = 0;
```

* Helper method to generate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with the required certificate and its password, and configure additional properties such as reason, contact, location, and position. An image and custom appearance labels are also set.

```csharp
private static DigitalSignOptions CreateDigitalSignOptions(string certificatePath, 
    string imageFilePath, int iteration)
{
    return new DigitalSignOptions(certificatePath)
    {
        // Specify the type of signature
        SignatureType = SignatureType.Digital,

        // Provide the certificate password
        Password = "1234567890",

        // Digital certificate details for signature metadata
        Reason = "Sign",                            // Reason for the signature
        Contact = "JohnSmith" + iteration,          // Contact information of the signer
        Location = "Office1" + iteration,           // Location where the document is signed

        // Enable visibility of the signature on the document
        Visible = true,

        // Specify the position and size of the signature on the page
        Left = 400,                                 // Horizontal position (X-axis)
        Top = 20 + iteration * 70,                  // Vertical position (Y-axis)
        Height = 70,                                // Height of the signature area
        Width = 200,                                // Width of the signature area

        // Add an image to represent the digital certificate's appearance
        ImageFilePath = imageFilePath,              // Path to the image file

        // Customize the signature's appearance
        Appearance = new PdfDigitalSignatureAppearance
        {
            // Set a custom font color for the signature text
            Foreground = Color.FromArgb(50, Color.Gray), 

            // Apply specific font settings for the signature
            FontFamilyName = "TimesNewRoman",        // Font family name
            FontSize = 12                            // Font size
        }
    };
}
```

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.
* After signing, update the document path for the next iteration.
* Analyze the [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) to check the newly created signatures if needed.
* Iterate through each certificate, repeating the above steps for each one.

```csharp
foreach (var certificatePath in certificatePaths)
{
    using (Signature signature = new Signature("sample.pdf"))
    {
        // Generate signature options with helper method
        DigitalSignOptions options = CreateDigitalSignOptions(certificatePath, imageFilePath, 
            iteration);

        // Update output file name on second iteration
        if (iteration == 1) signedFile = resultOutputFile;

        // Sign document and display result
        SignResult signResult = signature.Sign(signedFile, options);
        Console.WriteLine(
            $"\nDocument signed successfully {iteration + 1}-time with " +
            $"{signResult.Succeeded.Count} signature(s).\nFile saved at {signedFile}.");
        iteration++;
    }
}
```
The following image demonstrates the result:
![Digital](/signature/net/images/iterative-digital-signing-of-the-pdf-document_custom_colors.png)

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign document with Royal Mail Mailmark 2D Barcode signature

Path: /signature/net/sign-document-with-mailmark-2d/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [Mailmark2D](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/mailmark2d/mailmark2d) class to create Royal Mail Mailmark 2D barcode. These barcodes can store various data, including information about the sender, recipient, postage, and destination. The use of Mailmark 2D barcodes allows for more accurate and detailed tracking of mail items throughout their journey in the postal system.

Here are the steps how to add Mailmark2D Barcode signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the  [Mailmark2D](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/mailmark2d/mailmark2d/) object with all required additional options.
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/) object with all required additional options and set Mailmark2D object into Data property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add Mailmark2D signature to document. We use enum [Mailmark2DType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/mailmark2dtype/) to specify 2D barcode type, on which depends barcode form:

![Types](/signature/net/images/mailmark2dtype.png)

```csharp
using (Signature signature = new Signature(filePath))
{
    // create Mailmark2D data object
    Mailmark2D mailmark2D = new Mailmark2D()
    {
        UPUCountryID = "JGB ",
        InformationTypeID = "0",
        Class = "1",
        SupplyChainID = 123,
        ItemID = 1234,
        DestinationPostCodeAndDPS = "QWE1",
        RTSFlag = "0",
        ReturnToSenderPostCode = "QWE2",
        DataMatrixType = Mailmark2DType.Type_7,
        CustomerContentEncodeMode = DataMatrixEncodeMode.C40,
        CustomerContent = "CUSTOM"
    };

    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        Left = 100,
        Top = 100,
        // setup Data property to Mailmark2D instance
        Data = mailmark2D
    };

    // sign document to file
    var signResult = signature.Sign(outputFilePath, options);
            
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Pdf Digitally signing

Path: /signature/net/sign-document-with-digital-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) class to specify different amount of settings for Digital signature

* digital certificate (file on local disk [CertificateFilePath](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/certificatefilepath/) or stream [CertificateStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/certificatestream/)) (required)
* password of digital certificate [Password](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/password/) (required)
* digital signature details ([Reason](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/reason/), [Contact](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/contact/), [Location](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/location/))
* signature image as digital signature appearance on document page ([ImageFilePath](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/imagefilepath) or [ImageStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/imagestream))
* image signature appearance on document page ([Alignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/horizontalalignment), [Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/margin) etc.)

Here are the steps to add Digital signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with required certificate and its password.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add Digital signature to document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // initialize digital option with certificate file path
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // certifiate password
        Password = "1234567890",
        // digital certificate details
        Reason = "Sign",
        Contact = "JohnSmith",
        Location = "Office1",
        // image as digital certificate appearance on document pages
        ImageFilePath = "sample.jpg",
        //
        AllPages = true,
        Width = 80,
        Height = 60,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() {  Bottom = 10, Right = 10},
    };
    signature.Sign("signed.pdf", options);
}
```

### Add Long-Term Validation (LTV)(Long-Term Validation) information for a signature

What is Long-Term Validation (LTV) for Digital Signatures?

Long-Term Validation (LTV) is a method used to ensure the continued validity of digital signatures over time, even after the signing certificate expires or is revoked. LTV embeds additional information within the signed document, such as the certificate’s revocation status, timestamp, and the certificate chain, which allows anyone verifying the signature in the future to determine its authenticity, even if the original certificate is no longer available.

Why is LTV Important?

Digital signatures rely on certificates, which have expiration dates. Once the signing certificate expires or is revoked, the signature may no longer be considered valid. However, many legal, financial, and regulatory scenarios require documents to remain valid for years or decades. LTV solves this problem by embedding validation data directly into the signed document, ensuring that the signature’s authenticity can be verified at any point in the future.

Here is an example of how to implement Long-Term Validation (LTV) for a PDF document using GroupDocs.Signature:

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // initialize digital option with certificate file path
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // certifiate password
        Password = "1234567890",
        // digital certificate details
        Reason = "Sign",
        Contact = "JohnSmith",
        Location = "Office1",
        AllPages = true,
        Width = 80,
        Height = 60,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() {Bottom = 10, Right = 10},
        
        // Enable Long-Term Validation (LTV) to ensure signature validity over time
        UseLtv = true
    };
    signature.Sign("signed.pdf", options);
}
```
After signing a document with LTV support, you can check whether the signature includes LTV data using Adobe Acrobat.
Here is the example of signature detailes in Adobe Acrobat:
![LTV](/signature/net/images/sign-document-with-ltv-advanced.png) 


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Deleting Barcode signatures - advanced

Path: /signature/java/deleting-barcode-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) class to manipulate barcode signatures and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method.  
Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete Barcode signature from the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) object with desired properties;
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature);  
    
*   Select from list [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) object(s) that should be removed from the document;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not.

Here are the alternative steps to delete Barcode signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) methods.

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate one or several [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) objects with signature Id(s) passed to constructor;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it;
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not. 

## Delete Barcode signature from the document after Search

This example shows how to delete Barcode signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("signed.docx");
BarcodeSearchOptions options = new BarcodeSearchOptions();
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);
List<BaseSignature> signaturesToDelete = new ArrayList<BaseSignature>();
// collect signatures to delete
for (BarcodeSignature temp : signatures)
{
    if (temp.getText().contains("John"))
    {
        signaturesToDelete.add(temp);
    }
}
// delete signatures
DeleteResult deleteResult = signature.delete("signed.docx",signaturesToDelete);
if (deleteResult.getSucceeded().size() == signaturesToDelete.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : "+deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : "+deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Delete Barcode signature from the document by known signature Identifier

This example shows how to delete Barcode signature in the document by known signature Id (that was obtained by  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method previously).

```java
// initialize Signature instance
Signature signature = new Signature("signed.docx");
// read from some data source signature Id value
String[] signatureIdList = new String[]
        {
                "1a5fbc08-4b96-43d9-b650-578b16fbb877",
                "b0123987-b0d4-4004-86ec-30ab5c41ac7e"
        };
// create list of Barcode Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList)
{
    signatures.add(new BarcodeSignature(item));
}
// delete required signatures
DeleteResult deleteResult = signature.delete("signed.docx",signatures);
if (deleteResult.getSucceeded().size() == signatures.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : " + deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : " + deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Barcode signatures from documents

Path: /signature/java/delete-barcode-signatures-from-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) class to manipulate barcode signatures and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method.

Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete Barcode signature from the document with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature);  
*   Select from list [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) object(s) that should be removed from the document;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it. or not.     

This example shows how to delete Barcode signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
Signature signature = new Signature("signed.docx");
try
{
    BarcodeSearchOptions options = new BarcodeSearchOptions();
 
    // search for Barcode signatures in document
    List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class,options);
    if (signatures.size() > 0)
    {
        BarcodeSignature barcodeSignature = signatures.get(0);
        boolean result = signature.delete("signed.docx", barcodeSignature);
        if (result)
        {
            System.out.print("Signature with Barcode "+barcodeSignature.getText()+" and encode type "+barcodeSignature.getEncodeType().getTypeName()+" was updated in the document [signed.docx].");
        }
        else
        {
            System.out.print("Signature was not updated in the document! Signature with Barcode "+barcodeSignature.getText()+" and encode type "+barcodeSignature.getEncodeType().getTypeName()+" was not found!");
        }
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Deleting Barcode signatures - advanced

Path: /signature/net/deleting-barcode-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) class to manipulate barcode signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to delete Barcode signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature);
* Select from list [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

Here are the alternative steps to delete Barcode signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) objects with signature Id(s) passed to constructor;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it;
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

## Delete Barcode signature from the document after Search

This example shows how to delete Barcode signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.docx"))
{
    BarcodeSearchOptions options = new BarcodeSearchOptions();
    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
    List<BaseSignature> signaturesToDelete = new List<BaseSignature>();
    // collect signatures to delete
    foreach (BarcodeSignature temp in signatures)
    {
        if (temp.Text.Contains("John"))
        {
            signaturesToDelete.Add(temp);
        }
    }
    // delete signatures
    DeleteResult deleteResult = signature.Delete(signaturesToDelete);
    if (deleteResult.Succeeded.Count == signaturesToDelete.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Delete Barcode signature from the document by known signature Identifier  

This example shows how to delete Barcode signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously).

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.docx"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of Barcode Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new BarcodeSignature(p)));
    // delete required signatures
    DeleteResult deleteResult = signature.Delete(signatures);
    if (deleteResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Barcode signatures from documents

Path: /signature/net/delete-barcode-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) class to manipulate barcode signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

## How to delete Barcode signature from the document
Here are the steps to delete Barcode signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature);
* Select from list [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.

This example shows how to delete Barcode signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("signed.docx"))
{
    BarcodeSearchOptions options = new BarcodeSearchOptions();
    // search for Barcode signatures in document
    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
    if (signatures.Count > 0)
    {
        BarcodeSignature barcodeSignature = signatures[0];
        bool result = signature.Delete(barcodeSignature);
        if (result)
        {
            Console.WriteLine(
                $"Signature with Barcode '{barcodeSignature.Text}' and " +
                $"encode type '{barcodeSignature.EncodeType.TypeName}' " +
                $"was deleted from document ['{fileName}']."
            );
        }
        else
        {
            Console.WriteLine(
                $"Signature was not deleted from the document! " +
                $"Signature with Barcode '{barcodeSignature.Text}' and " +
                $"encode type '{barcodeSignature.EncodeType.TypeName}' " +
                $"was not found!"
            );
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Barcode signatures from documents

Path: /signature/nodejs-java/delete-barcode-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides [BarcodeSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/barcodesignature) class to manipulate barcode signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class.

## How to delete Barcode signature from the document
Here are the steps to delete Barcode signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.search/barcodesearchoptions/) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search(com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [BarcodeSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/barcodesignature);
* Select from list [BarcodeSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/barcodesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/delete) method and pass one or several signatures to it.

This example shows how to delete Barcode signature that was found using [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search(com.groupdocs.signature.options.search.SearchOptions)) method.

```javascript
  const filePath = Constants.SAMPLE_PDF_SIGNED; 
  const fileName = path.basename(filePath);

  const outputDirectory = path.join(Constants.OutputPath, 'DeleteBarcode');
  if (!fs.existsSync(outputDirectory)) {
    fs.mkdirSync(outputDirectory, { recursive: true });
  }

  // Copy source file since the delete method works with the same Document
  const outputFilePath = path.join(outputDirectory, fileName);

  fs.copyFileSync(filePath, outputFilePath);

  const signature = new signatureLib.Signature(outputFilePath);

  const options = new signatureLib.BarcodeSearchOptions();

  // Search for Barcode signatures in the document
  const signatures =  signature.search(signatureLib.BarcodeSignature.class, options).toArray();
  if (signatures.length > 0) {
     const barcodeSignature = signatures[0];
     const isDeleted = signature.delete(outputFilePath, barcodeSignature);
  
     const barcodeText = barcodeSignature.getText();
     const encodeTypeName = barcodeSignature.getEncodeType().getTypeName();
  
     if (isDeleted) {
         console.log(
             `Signature with Barcode '${barcodeText}' and encode type '${encodeTypeName}' was successfully deleted from the document '${fileName}'.`
         );
     } else {
         console.log(
             `Failed to delete the signature! Barcode '${barcodeText}' with encode type '${encodeTypeName}' was not removed from the document '${fileName}'.`
         );
     }
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## How to update Barcode signature in advance

Path: /signature/net/updating-barcode-signatures-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) class to manipulate barcode signatures location, size, textual content and encode type over [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) object to analyze if signatures were successfully processed.

Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. The [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) contains list of successfully updated signatures and ones that failed. The Barcode signature could be failed to update due to several reasons:

* if signature object was initialized with constructor by incorrect signature identifier;
* if signature object was not found;
* there was an error occurred while updating signature in the document.

Here are the steps to update Barcode signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [BarcodeSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature);
* Select from list [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

Here are the alternative steps to update Barcode signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) objects with signature Id(s) passed to constructor;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it;
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

The following table describes changeable properties for Barcode signatures dependent on document type.

| Document Type / Signature Property | Left | Top | Width | Height | EncodeType | Text | IsSignature |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) |
| Spreadsheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Pdf | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Presentation | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Word Processing | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |

## Update Barcode signature in the document after Search

This example shows how to update Barcode signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.pdf"))
{
    BarcodeSearchOptions options = new BarcodeSearchOptions();
    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
    // adjust signature properties
    foreach (BarcodeSignature temp in signatures)
    {
        // apply some condition to adjust signature properties
        if (temp.Text == "Test1")
        {
            temp.Left = temp.Left + 10;
            temp.Top = temp.Top + 10;
        }
        temp.IsSignature = true;
    }
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures.ConvertAll(p => (BaseSignature)p));
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("\nAll signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Update Barcode signature in document by known signature Identifier  

This example shows how to update Barcode signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously).

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.xlsx"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of Barcode Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new BarcodeSignature(p)));
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures);
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Composing signature with linear gradient brush background

Path: /signature/net/composing-signature-with-linear-gradient-brush-background/

  
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [LInearGradientBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/lineargradientbrush) class to specify filling signature background with linear gradients

Here are the steps to use Linear gradient brush with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with all required additional options and setup [Background.Brush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/background/brush) property with instance of  [LInearGradientBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/lineargradientbrush)
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.  
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

This example shows how to use Texture brush for signature background. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // adjust signature appearance brush
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new LinearGradientBrush(Color.LimeGreen, Color.White, 45)
        },
        // locate signature
        Width = 100,
        Height = 80,
        VerticalAlignment = Domain.VerticalAlignment.Center,
        HorizontalAlignment = Domain.HorizontalAlignment.Center,
        Margin = new Padding() { Top = 20, Right = 20 },
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image
    };
    // sign document to file
    signature.Sign("signed.docx", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Barcode signatures from documents

Path: /signature/python-net/delete-barcode-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [BarcodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/barcodesignature) class to manipulate barcode signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

## How to delete Barcode signature from the document
Here are the steps to delete Barcode signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain list of [BarcodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/barcodesignature);
* Select from list [BarcodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/barcodesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.

This example shows how to delete Barcode signature that was found using [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method.

```python
import groupdocs.signature as signature
from groupdocs.signature.options import BarcodeSearchOptions

# Initialize signature
with signature.Signature("signed.docx") as sign:
    # Create search options
    options = BarcodeSearchOptions()
    
    # Search for barcode signatures in document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        barcode_signature = signatures[0]
        result = sign.delete(barcode_signature)
        
        if result:
            print(
                f"Signature with Barcode '{barcode_signature.text}' and "
                f"encode type '{barcode_signature.encode_type.type_name}' "
                f"was deleted from document ['{fileName}']."
            )
        else:
            print(
                f"Signature was not deleted from the document! "
                f"Signature with Barcode '{barcode_signature.text}' and "
                f"encode type '{barcode_signature.encode_type.type_name}' "
                f"was not found!"
            )
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Advanced search for Barcode signatures

Path: /signature/java/advanced-search-for-barcode-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) class to specify different options to search for Barcode Signatures.

Here are the steps to search for barcode signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) object according to your requirements and specify search options   
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) to it.
    

This example shows how to make advanced search for Barcode signature in the document.

```java
Signature signature = new Signature("sample.pdf");
BarcodeSearchOptions options = new BarcodeSearchOptions();
options.setAllPages(true); // this value is set by default
// single page number
options.setPageNumber(1);
        // setup extended search in pages setup
PagesSetup pagesSetup  = new PagesSetup() ;
pagesSetup.setFirstPage(true);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(false);
options.setPagesSetup(pagesSetup);
 
// specify special barcode type to search
options.setEncodeType(BarcodeTypes.Code39Standard);
// specify text match type
options.setMatchType(TextMatchType.Contains);
// specify text pattern to search
options.setText("12345678");
 
// search for signatures in document
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (BarcodeSignature barcodeSignature : signatures) {
    System.out.print("Barcode signature found at page " + barcodeSignature.getPageNumber() + " with type " + barcodeSignature.getEncodeType() + " and text " + barcodeSignature.getText());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Advanced search for Barcode signatures

Path: /signature/net/advanced-search-for-barcode-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) class to specify different options to search for Barcode Signatures.

Here are the steps to search for barcode signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) object according to your requirements and specify search options
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) to it.

This example shows how to make advanced search for Barcode signature in the document with enabled options to grab barcode electronic signature context.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    BarcodeSearchOptions options = new BarcodeSearchOptions()
    {
        // specify special pages to search on
        AllPages = false,
        // single page number
        PageNumber = 1,
        // setup extended search in pages setup
        PagesSetup = new PagesSetup() { FirstPage = true, LastPage = true, OddPages = false, EvenPages = false },
        // specify special barcode type to search
        EncodeType = BarcodeTypes.Code39Standard,
        // specify text match type
        MatchType = TextMatchType.Contains,
        // specify text pattern to search
        Text = "12345678",
        // set field for barcode images returning
        ReturnContent = true,
        // specify type of returned barcode images
        ReturnContentType = FileType.PNG
    };
    // search for signatures in document
    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var barcodeSignature in signatures)
    {
        Console.WriteLine("Barcode signature found at page {0} with type {1} and text {2}", barcodeSignature.PageNumber, barcodeSignature.EncodeType, barcodeSignature.Text);
        Console.WriteLine("Barcode signature size {0} and format {1}", barcodeSignature.Content?.Length, barcodeSignature.Format);
        Console.WriteLine($"Location at {barcodeSignature.Left}-{barcodeSignature.Top}. Size is {barcodeSignature.Width}x{barcodeSignature.Height}.");
    }
    //Save Barcode images
    string outputPath = Path.Combine(Constants.OutputPath, "SearchForBarcodeAdvanced");
    if (!Directory.Exists(outputPath))
    {
        Directory.CreateDirectory(outputPath);
    }
    int i = 0;
    foreach (BarcodeSignature barcodeSignature in signatures)
    {
        if (barcodeSignature.Content != null)
        {
            string outputFilePath = Path.Combine(outputPath, $"image{i}{barcodeSignature.Format?.Extension}");
            using (FileStream fs = new FileStream(outputFilePath, FileMode.Create))
            {
                fs.Write(barcodeSignature.Content, 0, barcodeSignature.Content.Length);
            }
        }
        i++;
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Locating signature on page with different measure units

Path: /signature/java/locating-signature-on-page-with-different-measure-units/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) supports locating signature on document page with different measure units. Enumeration [MeasureType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/MeasureType) handles following types 

*   [MeasureType.Pixels](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/MeasureType#Pixels) allows to locate signature position and size with pixels (default value)
*   [MeasureType.Millimeters](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/MeasureType#Millimeters) allows to locate signature on page and setup size by setting millimeters
*   [MeasureType.Percents](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/MeasureType#Percents) allows to locate signature position, size with percentage of page size  
      

Here are the steps to locate and size signature area with different measure unit types:

*   Set property [setLocationMeasureType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setLocationMeasureType(int)) with of one values above to specify how to implement values in properties [setLeft](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IRectangle#setLeft(int)), [setTop](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IRectangle#setTop(int))    
*   Set property [setSizeMeasureType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setSizeMeasureType(int)) with of one values above to specify how to implement size of signature values in properties [setWidth](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IRectangle#setWidth(int)), [setHeight](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IRectangle#setHeight(int))    
*   Set property [setMarginMeasureType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setMarginMeasureType(int)) with of one values above to specify how to implement values in property [setMargin](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setMargin(com.groupdocs.signature.domain.Padding))

## Set signature positioning in millimeters

This example shows how to specify positioning in millimeters.

```java
 // instantiating the signature object
final Signature signature = new Signature("sample.docx");
try
{
    // setup options with text of signature
    BarcodeSignOptions signOptions = new BarcodeSignOptions("12345678");
    // setup Barcode encoding type
    signOptions.setEncodeType(BarcodeTypes.Code128);
    // set signature position in absolute position
    signOptions.setLocationMeasureType(MeasureType.Millimeters);
    signOptions.setLeft(40);
    signOptions.setTop(50);
    // set signature area in millimeters
    signOptions.setSizeMeasureType(MeasureType.Millimeters);
    signOptions.setWidth(20);
    signOptions.setHeight(10);
    // set margin in millimeters
    signOptions.setMarginMeasureType(MeasureType.Millimeters);
    Padding padding = new Padding();
    padding.setTop(5);
    padding.setLeft(5);
    padding.setRight(5);
    signOptions.setMargin(padding);
 
    // sign document    
    SignResult signResult = signature.sign("signedSample.docx", options);
    // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for(BaseSignature temp : signResult.getSucceeded())
    {
     System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    } 
}catch (Exception e){
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## Set signature positioning in percents

This example shows how to set different positioning properties in percentage.

```java
 // instantiating the signature object
final Signature signature = new Signature("sample.pdf");
try
{
   // setup options with text of signature
   BarcodeSignOptions signOptions = new BarcodeSignOptions("12345678");
   // setup Barcode encoding type
   signOptions.setEncodeType(BarcodeTypes.Code128);
   // set signature position in absolute position
   signOptions.setLocationMeasureType(MeasureType.Percents);
   signOptions.setLeft(5);
   signOptions.setTop(5);
   // set signature area in percents
   signOptions.setSizeMeasureType(MeasureType.Percents);
   signOptions.setWidth(10);
   signOptions.setHeight(5);
   // set margin in millimeters
   signOptions.setMarginMeasureType(MeasureType.Percents);
   Padding padding = new Padding();
   padding.setTop(1);
   padding.setLeft(1);
   padding.setRight(1);
   signOptions.setMargin(padding);
 
   // sign document          
   SignResult signResult = signature.sign("signed.docx", options);
    // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for(BaseSignature temp : signResult.getSucceeded())
    {
        System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }          
}catch (Exception e){
       throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update Barcode Signatures in Document

Path: /signature/python-net/update-barcode-signatures-in-document/

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides functionality to manipulate barcode signatures' location, size, and textual content.
Please note that the [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method modifies the same document that was passed to the constructor of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

### Here are the steps to update a Barcode signature in a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter
* Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesearchoptions) object with desired properties
* Call the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain a list of barcode signatures
* Select from the list the [BarcodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/barcodesignature) object(s) that should be updated
* Call the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object's [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method and pass one or several signatures to it

This example shows how to update a Barcode signature that was found using the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import BarcodeSearchOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create search options
    options = BarcodeSearchOptions()
    
    # Search for barcode signatures in document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        # Get first barcode signature
        barcode_signature = signatures[0]
        
        # Change position
        barcode_signature.left = 100
        barcode_signature.top = 100
        
        # Update the signature
        result = sign.update(barcode_signature)
        
        if result.updated_count > 0:
            print(f"Signature with barcode '{barcode_signature.text}' was updated!")
        else:
            print("Signature was not updated in the document!")
```


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Search for Barcode e-signatures

Path: /signature/java/search-for-barcode-e-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides an easy and straightforward way to find all Barcode signatures that are present in a document.  
For the most simpler use case - just find all Barcode signatures within document its only needed to instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) class and pass it to [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

Here are the exact steps to search for Barcode signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) object according to your requirements and specify search options  
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) to it.
    

This example shows how to search for Barcode signature in the document.

```java
Signature signature = new Signature("sample.pdf");
BarcodeSearchOptions options = new BarcodeSearchOptions();
// search for signatures in document
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (BarcodeSignature barcodeSignature : signatures)
{
    System.out.print("Barcode signature found at page "+barcodeSignature.getPageNumber()+" with type "+barcodeSignature.getEncodeType()+" and text "+ barcodeSignature.getText());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for Barcode e-signatures

Path: /signature/net/search-for-barcode-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides an easy and straightforward way to find all Barcode signatures that are present in a document.  
For the most simpler use case - just find all Barcode signatures within document its only needed to instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) class and pass it to [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

Here are the exact steps to search for Barcode signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) object according to your requirements and specify search options
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) to it.

This example shows how to search for Barcode signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // search for signatures in document
    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(SignatureType.Barcode);

    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var barcodeSignature in signatures)
    {
        Console.WriteLine("Barcode signature found at page {0} with type {1} and text {2}",
            barcodeSignature.PageNumber, barcodeSignature.EncodeType, barcodeSignature.Text);
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for Barcode e-signatures

Path: /signature/nodejs-java/search-for-barcode-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides an easy and straightforward way to find all Barcode signatures that are present in a document.  
For the simpler use case - just find all Barcode signatures within document its only needed to instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) class and pass it to [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method.

Here are the exact steps to search for Barcode signatures within the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) object according to your requirements and specify search options.
* Call the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) to it.

This example shows how to search for Barcode signature in the document.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 

  const signature = new signatureLib.Signature(filePath);
  const options = new signatureLib.BarcodeSearchOptions();
  options.setAllPages(true); // this value is set by default

  // Search for signatures in the document
  const signatures = signature.search(signatureLib.BarcodeSignature.class, options).toArray();
  console.log('\nSource document contains the following signatures.');

  for (const barcodeSignature of signatures) {
    console.log(`Barcode signature found at page ${barcodeSignature.getPageNumber()} with type ${barcodeSignature.getEncodeType()} and text ${barcodeSignature.getText()}`);
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for Barcode e-Signatures

Path: /signature/python-net/search-for-barcode-e-signatures/


[GroupDocs.Signature](https://products.groupdocs.com/signature/python-net) provides the ability to search for barcode signatures in documents. Barcode signatures can be used to store various types of information in a compact format.

## What is a Barcode Signature?

A barcode signature is a visual representation of data that can be scanned and read by machines. It typically consists of parallel black lines and white spaces of varying widths. Barcodes are commonly used for:
- Product identification
- Inventory tracking
- Document verification
- Data encoding

## How to Search for Barcode Signatures

The [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class provides the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method which allows you to search for barcode signatures in documents. Here's how to use it:

1. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class and pass the source document path as a parameter.
2. Instantiate the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesearchoptions/) object with the required options.
3. Call the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class instance and pass the [BarcodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesearchoptions/) to it.
4. Process the search results.

Here's an example of how to search for barcode signatures in a document:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import BarcodeSearchOptions
from groupdocs.signature.domain import BarcodeSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    options = BarcodeSearchOptions()
    
    # Search for signatures
    result = signature.search(options)
    
    print(f"Found {len(result)} signatures")
    
    # Process found signatures
    for barcode_signature in result:
        print(f"Barcode type: {barcode_signature.barcode_type}")
        print(f"Barcode text: {barcode_signature.text}")
        print(f"Page number: {barcode_signature.page_number}")
        print(f"Position: X={barcode_signature.left}, Y={barcode_signature.top}")
        print(f"Size: Width={barcode_signature.width}, Height={barcode_signature.height}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/search-for-electronic-signatures-in-document/search-for-barcode-e-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Advanced Search Options

The [BarcodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesearchoptions/) class provides various properties to customize the search process:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import BarcodeSearchOptions
from groupdocs.signature.domain import BarcodeSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    options = BarcodeSearchOptions()
    
    # Specify pages to search
    options.pages = [1, 2]  # Search only on pages 1 and 2
    
    # Specify barcode types to search for
    options.barcode_type = "Code128"  # Search only for Code128 barcodes
    
    # Search for signatures
    result = signature.search(options)
    
    print(f"Found {len(result)} signatures")
    
    # Process found signatures
    for barcode_signature in result:
        print(f"Barcode type: {barcode_signature.barcode_type}")
        print(f"Barcode text: {barcode_signature.text}")
        print(f"Page number: {barcode_signature.page_number}")
        print(f"Position: X={barcode_signature.left}, Y={barcode_signature.top}")
        print(f"Size: Width={barcode_signature.width}, Height={barcode_signature.height}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/search-for-electronic-signatures-in-document/search-for-barcode-e-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Additional Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our examples:

* [GroupDocs.Signature for Python via .NET Examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)
* [GroupDocs.Signature for Python via .NET Plugins](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Plugins)
* [GroupDocs.Signature for Python via .NET Showcase Apps](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Showcase)

### Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to search for barcode signatures in documents with our free online apps:

* [Search for Barcode Signatures Online](https://products.groupdocs.app/signature/family)

---

## 5 Secure Methods to Add Watermarks to Word Documents

Path: /watermark/net/secure-methods-add-watermark-to-word/



## Overview

Microsoft Word's built-in watermark feature provides minimal document protection—anyone can remove standard watermarks by double-clicking the header and pressing delete. This guide demonstrates **five professional watermarking methods** using GroupDocs.Watermark for .NET, ranging from basic header watermarks to advanced password-protected solutions that resist removal attempts.

**What you'll learn:**
- Why standard Word watermarks fail to protect sensitive documents
- How to implement 5 increasingly secure watermarking techniques with code examples
- When to use each protection level based on your security requirements
- Visual demonstrations of each method's effectiveness

## Why Word's Built-in Watermarks Aren't Secure

Standard Microsoft Word watermarks have a critical security flaw: they're stored as simple shape objects in document headers. Any user can:
1. Double-click the header area to enter edit mode
2. Select the watermark shape
3. Press Delete to remove it completely

This makes built-in watermarks unsuitable for:
- Confidential business documents
- Legal contracts and agreements
- Copyright-protected materials
- Documents requiring compliance controls

GroupDocs.Watermark for .NET solves this problem by providing programmatic watermarking with multiple protection levels.

{{< alert style="info" >}} For the **complete working code** and detailed explanations, please refer to the [full repository here](https://github.com/groupdocs-watermark/protect-word-documents-using-groupdocs-watermark-dotnet/).  
{{< /alert >}}

## 📂 Repository Structure

    Protect-Word-Documents-using-GroupDocs.Watermark-for-.NET/
    │
    ├── GroupDocs.Watermark-for-.NET-Word-Protection-Sample.csproj  # .NET 6 project file
    ├── Program.cs                                                  # Entry point: runs protection routines
    │   ├── AddSimpleHeaderWatermark                                # Basic watermark in header
    │   ├── AddTiledWatermark                                       # Repeated tiled watermark
    │   ├── AddTiledImageWatermark                                  # Repeated tiled image watermark
    │   ├── AddLockedSectionWatermark                               # Password-protected hidden section
    │   └── AddLockedHeaderWatermark                                # Locked header + editable content
    ├── Resources/                                                  # Input/output test files(create 
    |                                                                   this folder where you need)
    └── README.md                                                   # This documentation
  
## Method 1: Simple Header Watermark

**Protection Level:** Low | **Difficulty:** Easy | **Best For:** Internal documents, drafts

This method inserts a watermark into the document header as a shape object. While easy to implement, it offers minimal protection and can be removed by editing the header.

### Implementation

```csharp
private static void AddSimpleHeaderWatermark()
{
    Console.WriteLine("Adding simple header watermark...");
    var loadOptions = new WordProcessingLoadOptions();
    using (var watermarker = new Watermarker(InputFile, loadOptions))
    {
        var watermark = new TextWatermark("Confidential", new Font("Arial", 19))
        {
            VerticalAlignment = VerticalAlignment.Center,
            HorizontalAlignment = HorizontalAlignment.Center,
            RotateAngle = 25,
            ForegroundColor = Color.Red,
            Opacity = 0.8
        };
        watermarker.Add(watermark);
        watermarker.Save(Path.Combine(OutputDir, "header_watermark.docx"));
    }
    Console.WriteLine("Header watermark added.");
}
```
**Watch how easily it's removed:**

![how-to](/watermark/net/images/use-cases/secure-methods-add-watermark-to-word/2_remove_text_watermark_in_header.gif)

### Security Considerations

- **Vulnerability:** Can be deleted by double-clicking the header and selecting the watermark shape
- **Use Case:** Quick internal documents where high security isn't required
- **Advantage:** Simple to implement with minimal code

## Method 2: Tiled Watermarks

**Protection Level:** Medium | **Difficulty:** Easy | **Best For:** Multi-page documents requiring moderate security

Tiled watermarks create multiple instances across each page, making manual removal tedious and time-consuming. This method provides effective deterrence for documents longer than a few pages.

### Implementation

```csharp
private static void AddTiledWatermark()
{
    Console.WriteLine("Adding tiled watermark...");
    var loadOptions = new WordProcessingLoadOptions();
    using (var watermarker = new Watermarker(InputFile, loadOptions))
    {
        var watermark = new TextWatermark("Protected Document", new Font("Arial", 19))
        {
            VerticalAlignment = VerticalAlignment.Center,
            HorizontalAlignment = HorizontalAlignment.Center,
            RotateAngle = 25,
            ForegroundColor = Color.Red,
            Opacity = 0.9,
            TileOptions = new TileOptions
            {
                LineSpacing = new MeasureValue
                {
                    MeasureType = TileMeasureType.Percent,
                    Value = 12
                },
                WatermarkSpacing = new MeasureValue
                {
                    MeasureType = TileMeasureType.Percent,
                    Value = 12
                }
            }
        };
        var options = new WordProcessingWatermarkSectionOptions
        {
            Name = "TiledShape",
            AlternativeText = "Repeated watermark"
        };
        watermarker.Add(watermark, options);
        watermarker.Save(Path.Combine(OutputDir, "tiled_watermark.docx"));
    }
    Console.WriteLine("Tiled watermark added.");
}
```

**See the tiled protection in action:**

![how-to](/watermark/net/images/use-cases/secure-methods-add-watermark-to-word/3_tiled_watermark.gif)


### Key Features

- **Multiple Instances:** Creates 15-20+ watermark copies per page
- **Spacing Control:** Customize `LineSpacing` and `WatermarkSpacing` as percentages
- **Removal Deterrent:** Deleting all instances becomes impractical for multi-page documents
- **Ideal For:** Contracts, proposals, client-facing documents

## Method 3: Image Tiled Watermarks

**Protection Level:** Medium-High | **Difficulty:** Easy | **Best For:** Brand protection, copyright claims

Image watermarks use company logos, signatures, or custom graphics instead of text. When tiled, they create a professional security layer that's harder to replicate than simple text.

### Implementation

```csharp
private static void AddImageWatermark()
{    
    using (Watermarker watermarker = new Watermarker(InputFile))
    {
        // Create the image watermark object
        var watermark = new ImageWatermark("logo.png");
        
        // Configure tile options
        watermark.TileOptions = new TileOptions()
        {
            LineSpacing = new MeasureValue()
            {
                MeasureType = TileMeasureType.Percent,
                Value = 10
            },
            WatermarkSpacing = new MeasureValue()
            {
                MeasureType = TileMeasureType.Percent,
                Value = 8
            },
        };
        
        // Set watermark properties
        watermark.Opacity = 0.7;
        watermark.RotateAngle = -30;
        
        // Add watermark
        watermarker.Add(watermark);
        watermarker.Save(Path.Combine(OutputDir, "image_watermark_word.docx"));
    }
} 
```

**See the professional image watermark in action:**
![how-to](/watermark/net/images/use-cases/secure-methods-add-watermark-to-word/3.1_tiled_image_watermark.gif)


### Security Advantages

- **Unique Visual Elements:** Logos and graphics are harder to recreate than text
- **Brand Authentication:** Company seals and official stamps establish document authenticity
- **Supported Formats:** PNG, JPG, and other image formats
- **Professional Appearance:** Maintains document aesthetics while providing protection

## Method 4: Password-Protected Hidden Section

**Protection Level:** High | **Difficulty:** Medium | **Best For:** Confidential documents requiring strong security

This advanced technique places the watermark in a password-protected section configured for "form fields only" mode. Users cannot edit or remove the watermark without the password.

### Implementation

```csharp
private static void AddLockedWatermark_AllowOnlyFormFields()
{
    Console.WriteLine("Adding locked watermark (allow form fields)...");
    using (var watermarker = new Watermarker(InputFile))
    {
        var watermark = new TextWatermark("Do Not Edit", 
        new Font("Arial", 36, FontStyle.Bold | FontStyle.Italic))
        {
            HorizontalAlignment = HorizontalAlignment.Center,
            VerticalAlignment = VerticalAlignment.Center,
            Opacity = 0.4,
            RotateAngle = 45,
            ForegroundColor = Color.Red
        };
        
        var options = new WordProcessingWatermarkPagesOptions
        {
            IsLocked = true,
            Password = "012345",
            LockType = WordProcessingLockType.AllowOnlyFormFields
        };
        
        watermarker.Add(watermark, options);
        watermarker.Save(Path.Combine(OutputDir, "locked_allow_form_fields.docx"));
    }
    Console.WriteLine("Locked watermark added (AllowOnlyFormFields).");
}
```

**Watch the locked header protection:**
![how-to](/watermark/net/images/use-cases/secure-methods-add-watermark-to-word/4_allow_only_form_fields.gif)


### Configuration Options

- **IsLocked:** Set to `true` to enable password protection
- **Password:** Choose a strong password for document protection
- **LockType:** Use `AllowOnlyFormFields` to restrict editing
- **Use Case:** Legal documents, financial reports, intellectual property

### Important Considerations

When using password-protected sections, the hidden section occupies space in the document structure. For documents that completely fill available space, this may cause layout issues such as extra blank pages.

## Method 5: Locked Header with Editable Content Ranges

**Protection Level:** Very High | **Difficulty:** Medium | **Best For:** Documents requiring both security and user interaction

This sophisticated approach locks the header section (containing the watermark) while allowing specific document areas to remain editable. It combines maximum watermark security with controlled user access.

### Implementation

```csharp
private static void AddLockedHeaderWatermark()
{
    Console.WriteLine("Adding locked header watermark...");
    var loadOptions = new WordProcessingLoadOptions();
    using (var watermarker = new Watermarker(InputFile, loadOptions))
    {
        var watermark = new TextWatermark("Company Confidential", new Font("Arial", 19))
        {
            VerticalAlignment = VerticalAlignment.Center,
            HorizontalAlignment = HorizontalAlignment.Center,
            RotateAngle = 25,
            ForegroundColor = Color.Red,
            Opacity = 0.8
        };
        
        var options = new WordProcessingWatermarkSectionOptions
        {
            SectionIndex = 0,
            IsLocked = true,
            Password = "012345",
            LockType = WordProcessingLockType.ReadOnly
        };
        
        watermarker.Add(watermark, options);
        watermarker.Save(Path.Combine(OutputDir, "locked_header_watermark.docx"));
    }
    Console.WriteLine("Locked header watermark added.");
}
```


**Watch the locked header protection:**
![how-to](/watermark/net/images/use-cases/secure-methods-add-watermark-to-word/5_watermark_locked_in_header.gif)


### How It Works

1. **Header Protection:** The entire header section is locked with read-only protection
2. **Password Security:** Requires authentication to modify the watermark
3. **Editable Ranges:** Document body sections can be marked as editable
4. **Granular Control:** Different users can be assigned different editing permissions

### Visual Trade-offs

When documents with editable ranges are opened in Microsoft Word, editable sections appear highlighted in yellow. This visual indicator helps users identify where they can type, but may affect the document's professional appearance in some contexts.

### Ideal Applications

- Template documents with fixed branding
- Forms requiring user input
- Collaborative documents with protected headers
- Scenarios requiring granular editing permissions

## Choosing the Right Protection Method

| Method | Protection Level | Difficulty | Best Use Case | Removal Difficulty |
|--------|-----------------|------------|---------------|-------------------|
| Simple Header | Low | Easy | Internal drafts | Very Easy |
| Tiled Text | Medium | Easy | Multi-page proposals | Tedious |
| Tiled Image | Medium-High | Easy | Brand protection | Difficult |
| Password-Protected Section | High | Medium | Confidential documents | Very Difficult |
| Locked Header + Editable Ranges | Very High | Medium | Templates & forms | Very Difficult |

## Common Questions

**Q: Does adding watermarks increase file size?**  
A: Yes, but minimally. Simple header watermarks add negligible size. Tiled watermarks add more due to multiple shape objects, but the increase is typically under 5% for text watermarks.

**Q: Can I watermark other file formats?**  
A: Yes. GroupDocs.Watermark for .NET supports 40+ file formats including PDF, Excel, PowerPoint, images, and more.

**Q: Do I need Microsoft Word installed?**  
A: No. GroupDocs.Watermark is a standalone .NET library that works independently of Microsoft Office.

**Q: Can users still print watermarked documents?**  
A: Yes. Watermarks remain visible in printed copies unless you configure them otherwise using opacity and visibility settings.

**Q: How do I remove password protection for testing?**  
A: During development, use simple passwords like "012345" as shown in examples. For production, implement secure password management.

## Conclusion

Microsoft Word's built-in watermarks are insufficient for documents requiring real security. GroupDocs.Watermark for .NET provides five progressively secure protection methods, from simple header watermarks for internal use to advanced password-protected solutions for confidential documents.

Choose the protection level that matches your document's sensitivity:
- Use **simple headers** for low-risk internal documents
- Implement **tiled watermarks** for contracts and proposals
- Apply **password protection** for confidential business documents
- Deploy **locked headers with editable ranges** for templates and collaborative documents

Not every file needs maximum security, but critical documents deserve more than Word's easily-removable watermarks. Start protecting your documents today with GroupDocs.Watermark for .NET.


---

## About Search Engines

Path: /search/java/about-search-engines/

This page is about the classification of search engines and what place GroupDocs.Search API occupies in this classification. There are a large number of ways to classify search engines. Here are the main ones.

According to the search area, search engines can conditionally be divided into 3 groups:

*   Global. Global search engines are designed to search for information throughout the Internet or a significant part of it.
*   Local. Local search engines are designed to search for information on any part of the global network, for example, one or more sites, or on a local network. Such search engines are usually used inside private (corporate) networks or in e-commerce systems (online stores).
*   Personal. Personal search engines are used to search among files on personal computers or in small local networks.

According to the data source, search engines are divided into the following groups:

*   Desktop search engines. Desktop search tools search for information on a user's PC, including web browser history, email archives, text documents, sound files, images, and videos.
*   Federated search engines. Federated search is an information retrieval technology that allows user to simultaneously search multiple search resources of different types. The user makes one request, which applies to databases, indexes, or other search engines participating in the federation. The search results are then combined to present to the user. Federated search is used, for example, to integrate disparate information resources within one large organization.
*   Human search engines. The human search engine is a search engine that uses human participation to filter search results and help users refine their search query. The goal is to provide users with a limited number of relevant results, in contrast to traditional search engines, which often return many results, which may or may not be relevant.
*   Metasearch engines. Metasearch engine is a tool for searching information on the Internet, which uses search results of web search engines to get its own results. Metasearch engines receive data from a user and immediately makes requests to search engines. Received results are handled and presented to users.
*   Web search engines. Web search engine is a software system designed to search on the Internet. Search results are usually presented as a set of links to web pages, images, videos, infographics, articles, and other types of files.

By type of content, search engines are divided into:

*   Full text search engines. Full-text search means searching for one or more documents in a full-text database. Each of these documents is a separate file in some format. Full-text search is different from searching by metadata or by parts of original texts presented in databases (such as titles, annotations, individual sections or bibliographic references) and is usually performed across the entire content of each indexed document.
*   Image search engines. The image search engine is a computer system for viewing, searching and retrieving images from a large database of digital images. To be able to search for images, some metadata are added to images specified manually or using image recognition systems.
*   Video search engines. Video search engines are computer programs designed to search for videos stored on digital devices. The search is be performed in indexed metadata that is automatically produced from audiovisual material.

By type of interaction interface, search engines are divided into:

*   Normal search. Normal search involves entering a search query and subsequent retrieval of search results as a list.
*   Incremental search. Incremental search is a type of search interface, which is characterized by the provision of search results to the user in the process of typing a search query. The user can also choose the option of ending his search query from the proposed list.
*   Semantic search. Semantic search refers to search with meaning, in contrast to lexical search, where the search engine searches for literal matches of words or their variants, without understanding the general meaning of the query.
*   Selection-based search. A selection-based search system is a search engine in which a user makes a search query by selecting from the proposed options.
*   Voice search. Voice search is an interface that allows users to enter search queries by speaking them into the microphone of a digital device.

Database management systems are also search engines, because they always have facilities for indexing data and performing searches on them. Various databases differ in the way data is stored and the types of indexes created:

*   Relational database management system. A relational database is a digital database based on the relational or table-oriented model of data.
*   Document store. A document-oriented database is a computer program designed to store, retrieve and manage document-oriented information, also known as semi-structured data.
*   Key-value store. A key-value database is a data storage paradigm for storing, retrieving, and managing associative arrays, as well as a data structure, better known today as a dictionary or hash table.
*   Graph database management system. A graph database is a database that uses graph structures for semantic queries with nodes, edges, and properties to represent and store data.
*   Object database management system. An object database is a database in which information is represented in the form of objects as used in object-oriented programming.
*   Multi-model database management system. A multi-model database management system is a DBMS that provides the ability to store and work with data using various paradigms.

In accordance with the above types of classification, GroupDocs.Search API refers to the following types of search engines:

*   By search area – personal or corporate (local) full-text search engine.
*   By data source – desktop or federated full-text search index.
*   By type of content – full-text search database, image search engine (reverse image search, OCR). In addition, the API can also extract metadata from image and video files, as well as add arbitrary optional fields to any indexed documents.
*   By the type of interaction interface – normal with the ability to retrieve results by chunks.
*   By type of index – nosql document store database.

---

## About Search Engines

Path: /search/net/about-search-engines/

This page is about the classification of search engines and what place GroupDocs.Search API occupies in this classification. There are a large number of ways to classify search engines. Here are the main ones.

According to the search area, search engines can conditionally be divided into 3 groups:

*   Global. Global search engines are designed to search for information throughout the Internet or a significant part of it.
*   Local. Local search engines are designed to search for information on any part of the global network, for example, one or more sites, or on a local network. Such search engines are usually used inside private (corporate) networks or in e-commerce systems (online stores).
*   Personal. Personal search engines are used to search among files on personal computers or in small local networks.

According to the data source, search engines are divided into the following groups:

*   Desktop search engines. Desktop search tools search for information on a user's PC, including web browser history, email archives, text documents, sound files, images, and videos.
*   Federated search engines. Federated search is an information retrieval technology that allows user to simultaneously search multiple search resources of different types. The user makes one request, which applies to databases, indexes, or other search engines participating in the federation. The search results are then combined to present to the user. Federated search is used, for example, to integrate disparate information resources within one large organization.
*   Human search engines. The human search engine is a search engine that uses human participation to filter search results and help users refine their search query. The goal is to provide users with a limited number of relevant results, in contrast to traditional search engines, which often return many results, which may or may not be relevant.
*   Metasearch engines. Metasearch engine is a tool for searching information on the Internet, which uses search results of web search engines to get its own results. Metasearch engines receive data from a user and immediately makes requests to search engines. Received results are handled and presented to users.
*   Web search engines. Web search engine is a software system designed to search on the Internet. Search results are usually presented as a set of links to web pages, images, videos, infographics, articles, and other types of files.

By type of content, search engines are divided into:

*   Full text search engines. Full-text search means searching for one or more documents in a full-text database. Each of these documents is a separate file in some format. Full-text search is different from searching by metadata or by parts of original texts presented in databases (such as titles, annotations, individual sections or bibliographic references) and is usually performed across the entire content of each indexed document.
*   Image search engines. The image search engine is a computer system for viewing, searching and retrieving images from a large database of digital images. To be able to search for images, some metadata are added to images specified manually or using image recognition systems.
*   Video search engines. Video search engines are computer programs designed to search for videos stored on digital devices. The search is be performed in indexed metadata that is automatically produced from audiovisual material.

By type of interaction interface, search engines are divided into:

*   Normal search. Normal search involves entering a search query and subsequent retrieval of search results as a list.
*   Incremental search. Incremental search is a type of search interface, which is characterized by the provision of search results to the user in the process of typing a search query. The user can also choose the option of ending his search query from the proposed list.
*   Semantic search. Semantic search refers to search with meaning, in contrast to lexical search, where the search engine searches for literal matches of words or their variants, without understanding the general meaning of the query.
*   Selection-based search. A selection-based search system is a search engine in which a user makes a search query by selecting from the proposed options.
*   Voice search. Voice search is an interface that allows users to enter search queries by speaking them into the microphone of a digital device.

Database management systems are also search engines, because they always have facilities for indexing data and performing searches on them. Various databases differ in the way data is stored and the types of indexes created:

*   Relational database management system. A relational database is a digital database based on the relational or table-oriented model of data.
*   Document store. A document-oriented database is a computer program designed to store, retrieve and manage document-oriented information, also known as semi-structured data.
*   Key-value store. A key-value database is a data storage paradigm for storing, retrieving, and managing associative arrays, as well as a data structure, better known today as a dictionary or hash table.
*   Graph database management system. A graph database is a database that uses graph structures for semantic queries with nodes, edges, and properties to represent and store data.
*   Object database management system. An object database is a database in which information is represented in the form of objects as used in object-oriented programming.
*   Multi-model database management system. A multi-model database management system is a DBMS that provides the ability to store and work with data using various paradigms.

In accordance with the above types of classification, GroupDocs.Search API refers to the following types of search engines:

*   By search area – personal or corporate (local) full-text search engine.
*   By data source – desktop or federated full-text search index.
*   By type of content – full-text search database, image search engine (reverse image search, OCR). In addition, the API can also extract metadata from image and video files, as well as add arbitrary optional fields to any indexed documents.
*   By the type of interaction interface – normal with the ability to retrieve results by chunks.
*   By type of index – nosql document store database.

---

## About Search Engines

Path: /search/nodejs-java/about-search-engines/

This page is about the classification of search engines and what place GroupDocs.Search API occupies in this classification. There are a large number of ways to classify search engines. Here are the main ones.

According to the search area, search engines can conditionally be divided into 3 groups:

*   Global. Global search engines are designed to search for information throughout the Internet or a significant part of it.
*   Local. Local search engines are designed to search for information on any part of the global network, for example, one or more sites, or on a local network. Such search engines are usually used inside private (corporate) networks or in e-commerce systems (online stores).
*   Personal. Personal search engines are used to search among files on personal computers or in small local networks.

According to the data source, search engines are divided into the following groups:

*   Desktop search engines. Desktop search tools search for information on a user's PC, including web browser history, email archives, text documents, sound files, images, and videos.
*   Federated search engines. Federated search is an information retrieval technology that allows user to simultaneously search multiple search resources of different types. The user makes one request, which applies to databases, indexes, or other search engines participating in the federation. The search results are then combined to present to the user. Federated search is used, for example, to integrate disparate information resources within one large organization.
*   Human search engines. The human search engine is a search engine that uses human participation to filter search results and help users refine their search query. The goal is to provide users with a limited number of relevant results, in contrast to traditional search engines, which often return many results, which may or may not be relevant.
*   Metasearch engines. Metasearch engine is a tool for searching information on the Internet, which uses search results of web search engines to get its own results. Metasearch engines receive data from a user and immediately makes requests to search engines. Received results are handled and presented to users.
*   Web search engines. Web search engine is a software system designed to search on the Internet. Search results are usually presented as a set of links to web pages, images, videos, infographics, articles, and other types of files.

By type of content, search engines are divided into:

*   Full text search engines. Full-text search means searching for one or more documents in a full-text database. Each of these documents is a separate file in some format. Full-text search is different from searching by metadata or by parts of original texts presented in databases (such as titles, annotations, individual sections or bibliographic references) and is usually performed across the entire content of each indexed document.
*   Image search engines. The image search engine is a computer system for viewing, searching and retrieving images from a large database of digital images. To be able to search for images, some metadata are added to images specified manually or using image recognition systems.
*   Video search engines. Video search engines are computer programs designed to search for videos stored on digital devices. The search is be performed in indexed metadata that is automatically produced from audiovisual material.

By type of interaction interface, search engines are divided into:

*   Normal search. Normal search involves entering a search query and subsequent retrieval of search results as a list.
*   Incremental search. Incremental search is a type of search interface, which is characterized by the provision of search results to the user in the process of typing a search query. The user can also choose the option of ending his search query from the proposed list.
*   Semantic search. Semantic search refers to search with meaning, in contrast to lexical search, where the search engine searches for literal matches of words or their variants, without understanding the general meaning of the query.
*   Selection-based search. A selection-based search system is a search engine in which a user makes a search query by selecting from the proposed options.
*   Voice search. Voice search is an interface that allows users to enter search queries by speaking them into the microphone of a digital device.

Database management systems are also search engines, because they always have facilities for indexing data and performing searches on them. Various databases differ in the way data is stored and the types of indexes created:

*   Relational database management system. A relational database is a digital database based on the relational or table-oriented model of data.
*   Document store. A document-oriented database is a computer program designed to store, retrieve and manage document-oriented information, also known as semi-structured data.
*   Key-value store. A key-value database is a data storage paradigm for storing, retrieving, and managing associative arrays, as well as a data structure, better known today as a dictionary or hash table.
*   Graph database management system. A graph database is a database that uses graph structures for semantic queries with nodes, edges, and properties to represent and store data.
*   Object database management system. An object database is a database in which information is represented in the form of objects as used in object-oriented programming.
*   Multi-model database management system. A multi-model database management system is a DBMS that provides the ability to store and work with data using various paradigms.

In accordance with the above types of classification, GroupDocs.Search API refers to the following types of search engines:

*   By search area – personal or corporate (local) full-text search engine.
*   By data source – desktop or federated full-text search index.
*   By type of content – full-text search database, image search engine (reverse image search, OCR). In addition, the API can also extract metadata from image and video files, as well as add arbitrary optional fields to any indexed documents.
*   By the type of interaction interface – normal with the ability to retrieve results by chunks.
*   By type of index – nosql document store database.

---

## Accept or reject detected changes

Path: /comparison/python-net/accept-or-reject-detected-changes/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) lets you programmatically accept or reject individual changes before producing the final result.

## Accept or reject changes (files on disk)

Compare files, update change actions, and apply them to the output.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    comparer.compare()
    changes = comparer.get_changes()

    # Example: reject the first change
    if changes:
        changes[0].comparison_action = gc.ComparisonAction.REJECT

    with open("result.docx", "wb") as out_stream:
        comparer.apply_changes(out_stream, gc.ApplyChangeOptions(changes=changes))
```

🔹 Use case: Remove undesired edits from the final deliverable while keeping approved changes.

The result is as follows:

|                            Accepted changes                             |                             Rejected changes                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/python-net/images/accepted-changes.png) | ![](/comparison/python-net/images/rejected-changes.png) |

## Accept or reject changes (streams)

Work entirely with streams and persist the merged result.

```python
import groupdocs.comparison as gc

with open("source.docx", "rb") as src, open("target.docx", "rb") as tgt:
    with gc.Comparer(src) as comparer:
        comparer.add(tgt)
        comparer.compare()
        changes = comparer.get_changes()
        if changes:
            changes[0].comparison_action = gc.ComparisonAction.REJECT
        with open("result.docx", "wb") as out_stream:
            comparer.apply_changes(out_stream, gc.ApplyChangeOptions(changes=changes))
```

🔹 Use case: Integrate approval workflows in services that don’t use local file paths.



---

## Accept or Reject detected changes

Path: /comparison/java/accept-or-reject-detected-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to apply or discard specific changes between source and target documents and save output document with (or without) selected changes. 

To apply/reject changes to output document, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method.
4.  Call the [getChanges()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getChanges--) method to get changes list.
5.  Call the [setComparisonAction()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/changeinfo/#setComparisonAction-com.groupdocs.comparison.result.ComparisonAction-) method of the appropriate change object. Specify the [ComparisonAction.ACCEPT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction#ACCEPT) or the [ComparisonAction.REJECT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction#REJECT) value.
6.  Call the [applyChanges()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#applyChanges-java.lang.String-com.groupdocs.comparison.options.save.SaveOptions-com.groupdocs.comparison.options.ApplyChangeOptions-) method. Specify the collection of changes.

The [ApplyChangeOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/applychangeoptions/) class includes the following properties:

- [getChanges](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/applychangeoptions/#getChanges--) is a list of changes that must be applied (or not) to the output document
- [isSaveOriginalState](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/applychangeoptions/#isSaveOriginalState--) is an option to reep the original state of the compared result after applying changes

The following code snippets show how to accept/reject changes:

## Accept or Reject changes for documents stored at local disk

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.ApplyChangeOptions;
import com.groupdocs.comparison.options.save.SaveOptions;
import com.groupdocs.comparison.result.ChangeInfo;
import com.groupdocs.comparison.result.ComparisonAction;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final Path resultPath = comparer.compare();
    ChangeInfo[] changes = comparer.getChanges();
    changes[0].setComparisonAction(ComparisonAction.REJECT);
    comparer.applyChanges("result.docx", new SaveOptions(), new ApplyChangeOptions(changes));
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                            Accepted changes                             |                             Rejected changes                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/java/images/accepted-changes.png) | ![](/comparison/java/images/rejected-changes.png) |



## Accept or reject changes for documents provided as a stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.ApplyChangeOptions;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.save.SaveOptions;
import com.groupdocs.comparison.result.ChangeInfo;
import com.groupdocs.comparison.result.ComparisonAction;
import java.nio.file.Path;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.FileOutputStream;
import java.io.OutputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream)) {
    comparer.add(targetInputStream);
    final Path resultPath = comparer.compare(new SaveOptions(), new CompareOptions());
    ChangeInfo[] changes = comparer.getChanges();
    changes[0].setComparisonAction(ComparisonAction.REJECT);
    comparer.applyChanges(resultOutputStream, new ApplyChangeOptions(changes));
}
```
{{< /tab >}}
{{< /tabs >}}

## Accept or reject detected changes using SaveOriginalState option

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.ApplyChangeOptions;
import com.groupdocs.comparison.result.ChangeInfo;
import com.groupdocs.comparison.result.ComparisonAction;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final Path resultPath = comparer.compare();
    ChangeInfo[] changes = comparer.getChanges();
    changes[0].setComparisonAction(ComparisonAction.REJECT);
    ApplyChangeOptions changeOptions = new ApplyChangeOptions();
    changeOptions.setChanges(changes);
    changeOptions.setSaveOriginalState(true);
    comparer.applyChanges(resultFileWithRejectedChange, changeOptions);
    changes = comparer.getChanges();
    changes[0].setComparisonAction(ComparisonAction.ACCEPT);
    comparer.applyChanges(resultFileWithAcceptedChange, new ApplyChangeOptions(changes));
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Accept or Reject detected changes

Path: /comparison/net/accept-or-reject-detected-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to apply or discard specific changes between source and target documents and save output document with (or without) selected changes. 

To apply/reject changes to output document, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare/index) method.
4.  Call the [GetChanges](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/getchanges/index) method to get changes list.
5.  Set the [ComparisonAction](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.result/changeinfo/properties/comparisonaction) of the appropriate change object to the [ComparisonAction.Accept](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.result/comparisonaction) or [ComparisonAction.Reject](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.result/comparisonaction) value.
6.  Call the [ApplyChanges](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/applychanges/index) method. Specify the collection of changes.

[ApplyChangeOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/applychangeoptions) class includes the following properties:

- [Changes](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/applychangeoptions/properties/changes) is a list of changes that must be applied (or not) to the output document
- [SaveOriginalState](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/applychangeoptions/properties/saveoriginalstate) is an option to reep the original state of the compared result after applying changes

The following code snippets show how to accept/reject changes:

## Accept or Reject changes for documents stored at local disk

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using GroupDocs.Comparison.Result;
using System.IO;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare();
    ChangeInfo[] changes = comparer.GetChanges();
    changes[0].ComparisonAction = ComparisonAction.Reject;
    comparer.ApplyChanges(File.Create("result.docx"), new SaveOptions(), new ApplyChangeOptions() 
    { 
      Changes = changes 
    });
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                            Accepted changes                             |                             Rejected changes                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/net/images/accepted-changes.png) | ![](/comparison/net/images/rejected-changes.png) |



## Accept or reject changes for documents provided as a stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using GroupDocs.Comparison.Result;
using System.IO;
// ...

using (Comparer comparer = new Comparer(File.OpenRead("source.docx")))
{
    comparer.Add(File.OpenRead("target.docx"));
    comparer.Compare(new SaveOptions(), new CompareOptions());
    ChangeInfo[] changes = comparer.GetChanges(new GetChangeOptions());
    changes[0].ComparisonAction = ComparisonAction.Reject;
    comparer.ApplyChanges(File.Create("result.docx"), new SaveOptions(), new ApplyChangeOptions() 
    { 
      Changes = changes 
    });
}
```
{{< /tab >}}
{{< /tabs >}}

## Accept or reject detected changes using SaveOriginalState option

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using GroupDocs.Comparison.Result;
using System.IO;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare();
    ChangeInfo[] changes = comparer.GetChanges();
    changes[0].ComparisonAction = ComparisonAction.Reject;
    comparer.ApplyChanges("resultWithRejectedChange.docx", new ApplyChangeOptions() 
    { 
      Changes = changes, SaveOriginalState = true 
    });
    changes = comparer.GetChanges();
    changes[0].ComparisonAction = ComparisonAction.Accept;
    comparer.ApplyChanges("resultWithAcceptedChange.docx", new ApplyChangeOptions() 
    { 
      Changes = changes 
    });
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Accept or Reject detected changes

Path: /comparison/nodejs-java/accept-or-reject-detected-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to apply or discard specific changes between the source and target documents and save the output document with (or without) the selected changes. 

The `ApplyChangeOptions` class includes the following properties:

- `getChanges` is a list of changes that must be applied (or not) to the output document
- `isSaveOriginalState` is an option to keep the original state of the compared result after applying changes

The following code snippets show how to accept/reject changes:

## Accept or Reject changes for documents stored on a local disk

The following example compares two DOCX files from disk, rejects the first detected change, and saves an updated result document.

```javascript
'use strict';

// Import GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Load Java integration and import utility class for working with Java collections
const java = require('java');
let Arrays = java.import('java.util.Arrays');

// Define file paths for source, target, and result documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const resultFile = 'result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add the target document to be compared against the source
comparer.add(targetFile);

// Perform the comparison operation (changes are detected but not yet applied)
comparer.compare();

// Retrieve the list of detected changes (array of ChangeInfo objects)
let changes = comparer.getChanges();

// Mark the first change in the list as rejected
changes[0].setComparisonAction(groupdocs.ComparisonAction.REJECT);

// Create options for applying changes
const applyChangeOptions = new groupdocs.ApplyChangeOptions();

// Specify the changes to apply by wrapping the JavaScript array with Arrays.asList
applyChangeOptions.setChanges(Arrays.asList(changes));

// Apply the selected changes and save the result document
comparer.applyChanges(resultFile, applyChangeOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and performs the comparison. It then retrieves all detected changes, marks the first change as rejected using `setComparisonAction()`, wraps the changes array in a Java List, and applies the changes to create a result document where the rejected change is not included.

The result is as follows:

|                            Accepted changes                             |                             Rejected changes                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/nodejs-java/images/accepted-changes.png) | ![](/comparison/nodejs-java/images/rejected-changes.png) |

## Accept or reject changes for documents provided as a stream

The following example loads documents from Java streams, rejects the first change, and writes the result to a new file.

```javascript
'use strict';

// Import GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import Java interop and required classes
const java = require('java');
const InputStream = java.import('java.io.FileInputStream');
const Arrays = java.import('java.util.Arrays');

// Create InputStream objects for source and target documents
const sourceInputStream = new InputStream('sample-files/source.docx');
const targetInputStream = new InputStream('sample-files/target.docx');

// Initialize comparer with source document stream
const comparer = new groupdocs.Comparer(sourceInputStream);

// Add target document stream to comparer
comparer.add(targetInputStream);

// Perform comparison and generate a result document on disk
comparer.compare('result.docx');

// Retrieve list of detected changes
let changes = comparer.getChanges();

// Reject the first detected change
changes[0].setComparisonAction(groupdocs.ComparisonAction.REJECT);

// Configure options for applying changes
const applyOptions = new groupdocs.ApplyChangeOptions();

// Convert JavaScript array of changes to a Java List using Arrays.asList
const javaList = Arrays.asList(changes);
applyOptions.setChanges(javaList);

// Apply the selected changes and save them into a separate result file
comparer.applyChanges('result_rejected.docx', applyOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates the same workflow using Java input streams instead of file paths. It creates `InputStream` objects for both source and target documents, initializes the comparer with the source stream, adds the target stream, performs the comparison, retrieves changes, marks the first change as rejected, and applies the changes to save a new result file.

## Accept or reject detected changes using the SaveOriginalState option

The following example shows how to apply different actions to the same comparison result while optionally preserving the original state.

```javascript
'use strict';

// Import GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import Java interop helper for working with Java collections
const java = require('java');
const Arrays = java.import('java.util.Arrays');

// Define file paths for source, target, and multiple result documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const resultFile = 'result.docx';
const resultFileWithRejectedChange = 'rejected.docx';
const resultFileWithAcceptedChange = 'accepted.docx';

// Initialize comparer with the source document and add the target
const comparer = new groupdocs.Comparer(sourceFile);
comparer.add(targetFile);

// Run the comparison and save the initial merged result
comparer.compare(resultFile);

// Reject first change and save result while keeping original state
let changes = comparer.getChanges();
changes[0].setComparisonAction(groupdocs.ComparisonAction.REJECT);
const rejectOptions = new groupdocs.ApplyChangeOptions();
rejectOptions.setSaveOriginalState(true);          // keep original state unchanged
rejectOptions.setChanges(Arrays.asList(changes));  // apply only the updated change list
comparer.applyChanges(resultFileWithRejectedChange, rejectOptions);

// Accept first change and save another variant of the document
changes = comparer.getChanges();
changes[0].setComparisonAction(groupdocs.ComparisonAction.ACCEPT);
const acceptOptions = new groupdocs.ApplyChangeOptions();
acceptOptions.setChanges(Arrays.asList(changes));
comparer.applyChanges(resultFileWithAcceptedChange, acceptOptions);

// Exit the process
process.exit(0);
```

This example shows how to create multiple result documents from the same comparison with different change actions. It first saves the initial comparison result, then creates one result file with the first change rejected (using `setSaveOriginalState(true)` to preserve the original comparison state), and another result file with the first change accepted. This allows you to generate multiple variants of the document with different change selections.

---

## Add area annotation

Path: /annotation/java/add-area-annotation/

Area annotation allows you to mark up a rectangle area within the document page and annotate it as shown in the picture below. 

![](/annotation/java/images/add-area-annotation.png)

You can use the following methods to set the properties of the [AreaAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/) class:
https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/#setBackgroundColor-java.lang.Integer-
*   [setBackgroundColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/#setBackgroundColor-java.lang.Integer-) defines the area background color
*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position at the document page
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPenColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/#setPenColor-java.lang.Integer-) defines the frame color
*   [setPenStyle()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/#setPenStyle-java.lang.Byte-) defines the frame line style (solid, dash, dot etc.)
*   [setPenWidth()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/#setPenWidth-java.lang.Byte-) defines the frame line width in pixels

To add an area annotation to document, follow these steps:  

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [AreaAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [AreaAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.  

The following code snippet shows how to add [AreaAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/areaannotation/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
// This example demonstrates adding area annotation.

// Create an instance of Reply class and add comments
Reply reply1 = new Reply();
reply1.setComment("First comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());

Reply reply2 = new Reply();
reply2.setComment("Second comment");
reply2.setRepliedOn(Calendar.getInstance().getTime());

java.util.List<Reply> replies =  new ArrayList<Reply>();
replies.add(reply1);
replies.add(reply2);

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBackgroundColor(65535);
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setCreatedOn(Calendar.getInstance().getTime());
    area.setMessage("This is area annotation");
    area.setOpacity(0.7);
    area.setPageNumber(0);
    area.setPenColor(65535);
    area.setPenStyle(PenStyle.Dot);
    area.setPenWidth((byte) 3);
    area.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(area);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Add area annotation

Path: /annotation/net/add-area-annotation/

Area annotation allows you to mark up a rectangle area within the document page and annotate it as shown in the picture below. 

![](/annotation/net/images/add-area-annotation.png)

You can set the following properties of the [AreaAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/areaannotation) class:

*   [BackgroundColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/backgroundcolor) defines the area background color
*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/box) defines the annotation position at the document page
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/opacity) - allows you to set the annotation opacity
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/pencolor) defines the frame color
*   [PenStyle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penstyle) defines the frame line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penwidth) - defines the frame line width in pixels

To add an area annotation to document, follow these steps:  

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [AreaAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/areaannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [AreaAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/areaannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.  

The following code snippet shows how to add [AreaAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/areaannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	AreaAnnotation area = new AreaAnnotation
    {
     	BackgroundColor = 65535,
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Message = "This is area annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = 65535,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(area);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Add button component

Path: /annotation/java/add-button-component/

Button component creates a button component as shown in the picture below: 

![](/annotation/net/images/add-button-component.png)

You can specify the following properties of the [ButtonComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/) class:

*   [Box](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position
*   [PenColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/#setPenColor-java.lang.Integer-) defines the frame color

To add a button component, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class. Specify the input document path or stream.
2.   Instantiate the [ButtonComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [ButtonComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/) class.
4.   Call the [Save](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add [ButtonComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
try(final Annotator annotator = new Annotator(Constants.INPUT_PDF)) {
	ButtonComponent buttonComponent = new ButtonComponent();
	buttonComponent.setCreatedOn(new Date());
	buttonComponent.setStyle(BorderStyle.DASHED);
	buttonComponent.setMessage("This is button component");
	buttonComponent.setBorderColor(1422623);
	buttonComponent.setPenColor(14527697);
	buttonComponent.setButtonColor(10832612);
	buttonComponent.setPageNumber(0);
	buttonComponent.setBorderWidth(12);
	buttonComponent.setBox(new Rectangle(100, 300, 90, 30));

	Reply reply1 = new Reply();
	reply1.setComment("First comment");
	reply1.setRepliedOn(new Date());

	Reply reply2 = new Reply();
	reply2.setComment("Second comment");
	reply2.setRepliedOn(new Date());

	List<Reply> replies = new ArrayList<>();
	replies.add(reply1);
	replies.add(reply2);

	buttonComponent.setReplies(replies);

	annotator.add(buttonComponent);
	annotator.save("result_button_component.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add button component

Path: /annotation/net/add-button-component/

Button component creates a button component as shown in the picture below: 

![](/annotation/net/images/add-button-component.png)

You can specify the following properties of the [ButtonComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/properties/box) defines the annotation position
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent/properties/pencolor) defines the frame color

To add a button component, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [ButtonComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [ButtonComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/buttoncomponent) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add [ButtonComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/cropdowncomponent) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	ButtonComponent button = new ButtonComponent
    {
        CreatedOn = DateTime.Now,
        Style = BorderStyle.Dashed,
        Message = "This is button component",
        BorderColor = 1422623,
        PenColor = 14527697,
        ButtonColor = 10832612,
        PageNumber = 0,
        BorderWidth = 12,
        Box = new Rectangle(100, 300, 90, 30),
        Replies = new List<Reply>
            {
                new Reply
                {
                    Comment = "First comment",
                    RepliedOn = DateTime.Now
                },
                new Reply
                {
                    Comment = "Second comment",
                    RepliedOn = DateTime.Now
                }
            }
    };
    annotator.Add(button);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add checkbox component

Path: /annotation/java/add-checkbox-component/

Checkbox component creates a checkbox as shown in the picture below: 

![](/annotation/net/images/add-checkbox-component.png)

You can specify the following properties of the [CheckBoxComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/) class:

*   [Box](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position
*   [PenColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/#setPenColor-java.lang.Integer-) defines the frame color

To add a checkbox component, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class. Specify the input document path or stream.
2.   Instantiate the [CheckboxComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [CheckboxComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/) class.
4.   Call the [Save](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add [CheckboxComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
try(final Annotator annotator = new Annotator(Constants.INPUT_PDF)) {
	CheckBoxComponent checkbox = new CheckBoxComponent();
	checkbox.setChecked(true);
	checkbox.setBox(new Rectangle(100, 100, 100, 100));
	checkbox.setPenColor(65535);
	checkbox.setStyle(BoxStyle.STAR);
	Reply reply1 = new Reply();
	reply1.setComment("First comment");
	reply1.setRepliedOn(new Date());

	Reply reply2 = new Reply();
	reply2.setComment("Second comment");
	reply2.setRepliedOn(new Date());

	List<Reply> replies = new ArrayList<>();
	replies.add(reply1);
	replies.add(reply2);

	checkbox.setReplies(replies);

	annotator.add(checkbox);
	annotator.save("result_checkbox_component.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add checkbox component

Path: /annotation/net/add-checkbox-component/

Checkbox component creates a checkbox as shown in the picture below: 

![](/annotation/net/images/add-checkbox-component.png)

You can specify the following properties of the [CheckBoxComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/properties/box) defines the annotation position
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent/properties/pencolor) defines the frame color

To add a checkbox component, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [CheckboxComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [CheckboxComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/checkboxcomponent) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add [CheckboxComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/cropdowncomponent) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	CheckBoxComponent checkbox = new CheckBoxComponent
    {
        Checked = true,
        Box = new Rectangle(100, 100, 100, 100),
        PenColor = 65535,
        Style = BoxStyle.Star,
        Replies = new List<Reply>
            {
                new Reply
                {
                    Comment = "First comment",
                    RepliedOn = DateTime.Now
                },
                new Reply
                {
                    Comment = "Second comment",
                    RepliedOn = DateTime.Now
                }
            }
    };
    annotator.Add(checkbox);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add document password

Path: /merger/java/add-document-password/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to add document password. Here are the steps to add document password:

*   Initialize [AddPasswordOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/AddPasswordOptions) class with new document password;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [addPassword](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#addPassword(com.groupdocs.merger.domain.options.interfaces.IAddPasswordOptions)) method and pass [AddPasswordOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/AddPasswordOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to add document password.

```java
String filePath = "c:\sample.pptx";
String filePathOut = "c:\output\result.pptx";

AddPasswordOptions addOptions = new AddPasswordOptions("SAMPLE_PASSWORD");

Merger merger = new Merger(filePath);        
merger.addPassword(addOptions);
merger.save(filePathOut);
```

---

## Add document password

Path: /merger/net/add-document-password/

**GroupDocs.Merger** allows to add document password. Here are the steps to add document password:

*   Initialize [AddPasswordOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/addpasswordoptions) class with new document password;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [AddPassword](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/addpassword) method and pass [AddPasswordOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/addpasswordoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to add document password.

```csharp
string filePath = @"c:\sample.pptx";
string filePathOut = @"c:\output\result.pptx";

AddPasswordOptions addOptions = new AddPasswordOptions("SAMPLE_PASSWORD");

using (Merger merger = new Merger(filePath))
{
    merger.AddPassword(addOptions);
    merger.Save(filePathOut);
}
```

---

## Add document password

Path: /merger/python-net/add-document-password/

**GroupDocs.Merger** allows to add document password. Here are the steps to add document password:

*   Initialize [AddPasswordOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/addpasswordoptions) class with new document password;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger) object with source document path or stream;
*   Call [AddPassword](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/addpassword) method and pass [AddPasswordOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/addpasswordoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to add document password.

```python
with gm.Merger(constants.sample_pptx) as merger:
    add_password_options = gm.domain.options.AddPasswordOptions("SomePasswordString")
    merger.add_password(add_password_options)
    merger.save(constants.output_pptx)
```

---

## Add dropdown component

Path: /annotation/java/add-dropdown-component/

Dropdown component creates a combo box as shown in the picture below: 

![](/annotation/net/images/add-dropdown-component.png)

You can specify the following properties of the [DropdownComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/) class:

*   [Box](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position
*   [PenColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/#setPenColor-java.lang.Integer-) defines the frame color
*   [PenStyle](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/#setPenStyle-java.lang.Byte-) defines the frame line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/#setPenWidth-java.lang.Byte-) defines the frame line width in pixels.

To add a dropdown component, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class. Specify the input document path or stream.
2.   Instantiate the [DropdownComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [DropdownComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/) class.
4.   Call the [Save](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add [DropdownComponent](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
try(final Annotator annotator = new Annotator(Constants.INPUT_PDF)) {
	DropdownComponent dropdownComponent = new DropdownComponent();
	dropdownComponent.setOptions(new ArrayList<>(Arrays.asList("Item1", "Item2", "Item3")));
	dropdownComponent.setSelectedOption(null);
	dropdownComponent.setPlaceholder("Choose option");
	dropdownComponent.setBox(new Rectangle(100, 100, 100, 100));
	dropdownComponent.setCreatedOn(new Date());
	dropdownComponent.setMessage("This is dropdown component");
	dropdownComponent.setPageNumber(0);
	dropdownComponent.setPenColor(65535);
	dropdownComponent.setPenStyle(PenStyle.DOT);
	dropdownComponent.setPenWidth((byte) 3);

	List<Reply> replies = new ArrayList<>();
	Reply reply1 = new Reply();
	reply1.setComment("First comment");
	reply1.setRepliedOn(new Date());

	Reply reply2 = new Reply();
	reply2.setComment("Second comment");
	reply2.setRepliedOn(new Date());

	replies.add(reply1);
	replies.add(reply2);

	dropdownComponent.setReplies(replies);
	annotator.add(dropdownComponent);
	annotator.save("result_dropdown_component.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add dropdown component

Path: /annotation/net/add-dropdown-component/

Dropdown component creates a combo box as shown in the picture below: 

![](/annotation/net/images/add-dropdown-component.png)

You can specify the following properties of the [DropdownComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/properties/box) defines the annotation position
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/properties/pencolor) defines the frame color
*   [PenStyle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/properties/penstyle) defines the frame line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent/properties/penwidth) defines the frame line width in pixels.

To add a dropdown component, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [DropdownComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [DropdownComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add [DropdownComponent](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.formatspecificcomponents.pdf/dropdowncomponent) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	DropdownComponent dropdown = new DropdownComponent
    {
        Options = new List<string> { "Item1", "Item2", "Item3" },
        SelectedOption = null,
        Placeholder = "Choose option",
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Message = "This is dropdown component",
        PageNumber = 0,
        PenColor = 65535,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        Replies = new List<Reply>
        {
            new Reply
            {
                Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(dropdown);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add replies to annotation

Path: /annotation/java/add-replies-to-annotation/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) allows you to collaborate over document using annotations and annotation replies. 
  
To update an annotation reply, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [User](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/user/) class.
3.   Instantiate the [Reply](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/reply/) class(es).
4.   Instantiate the annotation object of the appropriate type. Available annotation types are listed [here](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/).
5.   Assign the [User](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/user/) class to `Reply.User` property (by default it is "Guest").
6.   Assign the [Reply](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/reply/) class(es) to the `Replies` collection created at previous steps.
7.   Call the  [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the annotation.
8.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add replies to annotation:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding replies to annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of User class and add data
    User user1 = new User();
    user1.setId(1);
    user1.setName("Tom");
    user1.setEmail("somemail@mail.com");
    User user2 = new User();
    user2.setId(2);
    user2.setName("Jack");
    user2.setEmail("somebody@mail.com");
    User user3 = new User();
    user3.setId(3);
    user3.setName("Mike");
    user3.setEmail("somemike@mail.com");
    
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBackgroundColor(65535);
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setCreatedOn(Calendar.getInstance().getTime());
    area.setMessage("This is area annotation");
    area.setOpacity(0.7);
    area.setPageNumber(0);
    area.setPenColor(65535);
    area.setPenStyle(PenStyle.Dot);
    area.setPenWidth((byte) 3);

    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setId(1);
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());
    reply1.setUser(user1);

    Reply reply2 = new Reply();
    reply2.setId(2);
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());
    reply2.setUser(user2);

    Reply reply3 = new Reply();
    reply3.setId(3);
    reply3.setComment("Third comment");
    reply3.setRepliedOn(Calendar.getInstance().getTime());
    reply3.setUser(user1);

    Reply reply4 = new Reply();
    reply4.setId(4);
    reply4.setComment("Fourth comment");
    reply4.setRepliedOn(Calendar.getInstance().getTime());
    reply4.setUser(user2);
    
    Reply reply5 = new Reply();
    reply5.setId(5);
    reply5.setComment("Five comment");
    reply5.setRepliedOn(Calendar.getInstance().getTime());
    reply5.setUser(user3);

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);
    replies.add(reply3);
    replies.add(reply4);
    replies.add(reply5);

    area.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(area);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add replies to annotation

Path: /annotation/net/add-replies-to-annotation/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to collaborate over document using annotations and annotation replies. 
  
To update an annotation reply, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [User](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models/user) class.
3.   Instantiate the [Reply](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models/reply) class(es).
4.   Instantiate the annotation object of the appropriate type. Available annotation types are listed [here](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels).
5.   Assign the [User](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models/user) class to `Reply.User` property (by default it is "Guest").
6.   Assign the [Reply](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models/reply) class(es) to the `Replies` collection created at previous steps.
7.   Call the  [Add](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/add) method of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the annotation.
8.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add replies to annotation:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	User user1 = new User
	{
		Id = 1,
		Name = "Tom",
		Email = "somemail@mail.com"
	};
	User user2 = new User
	{
		Id = 2,
		Name = "Jack",
		Email = "somebody@mail.com"
	};
	AreaAnnotation area = new AreaAnnotation
	{
		Box = new Rectangle(100, 100, 100, 100),
		CreatedOn = DateTime.Now,
		Message = "This is an area annotation",
		PageNumber = 0,
		Replies = new List<Reply>
		{
			new Reply
			{
				Id = 1,
				Comment = "First comment",
				RepliedOn = DateTime.Now,
				User = user1
			},
			new Reply
			{
				Id = 2,
				Comment = "Second comment",
				RepliedOn = DateTime.Now,
				User = user2,
			}
		}
	};
annotator.Add(area);
annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add text watermarks

Path: /watermark/net/basic-usage/add-text/

One of the main features of the GroupDocs.Watermark library is adding text watermarks to documents. You may add watermarks to documents or images from local disks, as well as from streams. For a full list of supported document formats, check [Supported formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}}).

To add a text watermark perform the following steps:

1. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) an instance of the `Watermarker` class for a local file or file stream;
2. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/textwatermark/constructors/main) an instance of the `TextWatermark` class and specify the desired text and font for the watermark;
3. (Optionally.) Specify the watermark [color](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/textwatermark/properties/foregroundcolor), [horizontal](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/horizontalalignment) and [vertical](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/verticalalignment) alignments;
4. Call the [Add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/add) method to apply the watermark to the document;
5. Call the [Save](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/4) method to store the document in a new location.

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Common;
using GroupDocs.Watermark.Watermarks;

// Specify an absolute or relative path to your document.
using (Watermarker watermarker = new Watermarker("C:\\Docs\\contract.docx"))
{
    // Specify the desired text and font for the watermark
    TextWatermark watermark = new TextWatermark("Contract Draft", 
        new Font("Arial", 60, FontStyle.Bold));
    // Specify font color and text opacity, rotation and alignments
    watermark.ForegroundColor = Color.DarkGreen;
    watermark.Opacity = 0.5;
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    // Apply the watermark
    watermarker.Add(watermark);
    // Save the resulting document
    watermarker.Save("C:\\Docs\\watermarked-contract.docx");
}
```
Run the program. A new watermarked document will appear in the specified path.

![Adding text watermarks](/watermark/net/images/watermarking/add-text.png)

### What's next

GroupDocs.Watermark offers many more capabilities for adding text watermarks. For example, it allows specifying background and foreground colors, formatting, text opacity, use of absolute or relative positioning, and so on. To learn more about this, see the [Adding text watermarks]({{< ref "watermark/net/developer-guide/advanced-usage/adding-watermarks/adding-text-watermarks.md" >}}) article of the "Advanced usage" section.
---

## Add text watermarks

Path: /watermark/nodejs-java/add-text/

One of the main features of the GroupDocs.Watermark library is adding text watermarks to documents. You may add watermarks to documents or images from local disks, as well as from streams. For a full list of supported document formats, check [Supported formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}}).

To add a text watermark perform follow next code sample:


```js
const groupdocs.watermark = require('@groupdocs/groupdocs.watermark')

function addATextWatermark() {
  const watermarker = new groupdocs.watermark.Watermarker("sample.docx");

  const watermark = new groupdocs.watermark.TextWatermark('top secret', new groupdocs.watermark.Font('Arial', 36));
  watermark.setForegroundColor(groupdocs.watermark.Color.getRed());
  watermark.setHorizontalAlignment(groupdocs.watermark.HorizontalAlignment.Center);
  watermark.setVerticalAlignment(groupdocs.watermark.VerticalAlignment.Center);

  watermarker.add(watermark);
  watermarker.save("sample.docx");
  watermarker.close();
}
```

Run the program. A new watermarked document will appear in the specified path.

### What's next

GroupDocs.Watermark offers many more capabilities for adding text watermarks. For example, it allows specifying background and foreground colors, formatting, text opacity, use of absolute or relative positioning, and so on.
---

## Add text watermarks

Path: /watermark/python-net/add-text/

One of the main features of the GroupDocs.Watermark library is adding text watermarks to documents. You may add watermarks to documents or images from local disks, as well as from streams. For a full list of supported document formats, check [Supported formats]({{< ref "watermark/python-net/getting-started/supported-document-formats.md" >}}).

To add a text watermark perform follow next code sample:

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwс

def run():
  with gw.Watermarker("sample.docx") as watermarker:
      font = gww.Font("Arial", 36.0)
      watermark = gww.TextWatermark("top secret", font)
      watermark.foreground_color = gww.Color.red;
      watermark.horizontal_alignment = gwс.HorizontalAlignment.CENTER
      watermark.vertical_alignment = gwс.VerticalAlignment.CENTER

      watermarker.add(watermark)
      watermarker.save(join(output_directory, "result.docx"))
```

Run the program. A new watermarked document will appear in the specified path.

### What's next

GroupDocs.Watermark offers many more capabilities for adding text watermarks. For example, it allows specifying background and foreground colors, formatting, text opacity, use of absolute or relative positioning, and so on.
---

## Add watermark

Path: /conversion/nodejs-java/add-watermark/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/nodejs-java) allows you to apply a watermark to the converted document.  You can set the following options for controlling how the watermark will be stamped in the converted document:

### WatermarkOptions

*   **[Text](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarktextoptions/#getText--)** -  watermark text
*   **[Font](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarktextoptions/#getWatermarkFont--)** -  watermark font name
*   **[Color](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarktextoptions/#getColor--)** - watermark color
*   **[Width](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarkoptions/#getWidth--)** - watermark width
*   **[Height ](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarkoptions/#getHeight--)** -  watermark height
*   **[Top](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarkoptions/#getTop--)** -  watermark top position
*   **[Left ](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarkoptions/#getLeft--)** - watermark left position
*   **[RotationAngle](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarkoptions/#getRotationAngle--)** -  watermark rotation angle
*   **[Transparency](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarkoptions/#getTransparency--)** -  watermark transparency
*   **[Background](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/watermarkoptions/#getBackground--)** -  specifies that the watermark is stamped as background. If the value is true, the watermark is laid at the bottom. By default is false and the watermark is laid on top.

  
To add a watermark, follow these steps:

1.   Create an instance of the [Converter](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion/Converter) class and pass the source document path as a constructor parameter.
2.   Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/ConvertOptions) class e.g. (**[PdfConvertOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/PdfConvertOptions)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/WordProcessingConvertOptions)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/SpreadsheetConvertOptions)**, etc.)
3.   Create an instance of the [WatermarkOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/WatermarkOptions) class. Set needed properties to specify the watermark color, width, height, text, image, etc.
4.   Call the [setWatermark](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/commonconvertoptions/#setWatermark-com.groupdocs.conversion.options.convert.WatermarkOptions-) method of the [ConvertOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/ConvertOptions) instance with the instance of the [WatermarkOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/WatermarkOptions) class created in the previous step. 
5.   Call the [convert](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion/Converter#convert(java.lang.String,%20com.groupdocs.conversion.options.convert.ConvertOptions)) method of the [Converter](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion/Converter) class instance and pass the filename of the converted document and the instance of [ConvertOptions](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/ConvertOptions) from the previous step.

The following code snippet shows how to apply a watermark to the output document:

```js
const converter = new groupdocs.conversion.Converter('sample.docx')

const watermark = new groupdocs.conversion.WatermarkTextOptions("Sample watermark")
watermark.setColor("red")
watermark.setWidth(100)
watermark.setHeight(100)
watermark.setBackground(true)

const convertOptions = new groupdocs.conversion.PdfConvertOptions()
convertOptions.setWatermark(watermark)

converter.convert('converted.pdf', convertOptions)
```
---

## Adding a Watermark to Converted Documents

Path: /conversion/java/add-watermark/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) provides a flexible way to apply watermarks to documents during the conversion process. This feature can be useful for branding, security, or informational purposes. You can customize various aspects of the watermark, such as its text, size, color, position, and transparency.

{{< alert style="tip" >}}
Looking for advanced watermarking capabilities? While GroupDocs.Conversion offers basic watermarking, you can explore [GroupDocs.Watermark](https://products.groupdocs.com/watermark/) for a comprehensive solution with enhanced features.
{{< /alert >}}
### WatermarkOptions

You can control how the watermark appears in the converted document using the [WatermarkOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/) class. Here are the key properties you can set:
| Option | Description |
|--------|-------------|
|[**setText()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarktextoptions/#setText-java.lang.String-) | The content of the watermark text. |
|[**setWatermarkFont()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarktextoptions/#setWatermarkFont-com.groupdocs.conversion.options.convert.Font-) | The font family of the watermark text. |
|[**setColor()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarktextoptions/#setColor-java.awt.Color-) | The color of the watermark text. |
|[**setWidth()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setWidth-int-) | The width of the watermark. |
|[**setHeight()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setHeight-int-) | The height of the watermark. |
|[**setTop()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setTop-int-) | The distance from the top edge of the document. |
|[**setLeft()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setLeft-int-) | The distance from the left edge of the document. |
|[**setRotationAngle()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setRotationAngle-int-) | The angle at which the watermark is rotated. |
|[**setTransparency()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setTransparency-double-) | The transparency level of the watermark (0 is fully transparent, 1 is fully opaque). |
|[**setBackground()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setBackground-boolean-) |  Determines whether the watermark is stamped as a background. If set to `true`, the watermark appears behind the document content. By default, it is set to `false`, meaning the watermark will appear on top of the content. |
|[**setAutoAlign()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/watermarkoptions/#setAutoAlign-boolean-) | Enables or disables automatic alignment of the watermark on the document. When set to `true`, the watermark will be automatically positioned to best fit the content layout, ensuring optimal visibility and aesthetics. When set to `false`, the watermark will retain its manually defined position. |

### Steps to Add a Watermark

- **Initialize the Converter**: Create an instance of the `Converter` class, providing the path to the source document.
- **Set Conversion Options**: Instantiate the appropriate `ConvertOptions` class (e.g., `PdfConvertOptions`, `WordProcessingConvertOptions`, `SpreadsheetConvertOptions`, etc.).
- **Configure Watermark Options**: Create an instance of the `WatermarkOptions` class and configure the properties to specify the watermark's appearance.
- **Apply the Watermark**: Use the `setWatermark` method of the `ConvertOptions` instance to apply the watermark settings.
- **Convert the Document**: Call the `convert` method on the `Converter` instance, passing the output file name and the configured `ConvertOptions` instance.

### Example: Add a Text Watermark to Converted Document

The following Java code snippet demonstrates how to apply a text watermark to a document during conversion to PDF:

{{< tabs "code-example">}}
{{< tab "AddWatermarkToConvertedDocument.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.convert.WatermarkTextOptions;

public class AddWatermarkToConvertedDocument {
    public static void convert() {
        // Initialize the converter with the source document
        try(Converter converter = new Converter("annual-review.docx")){

            // Set conversion options for PDF
            PdfConvertOptions options = new PdfConvertOptions();

            // Configure watermark options
            WatermarkTextOptions watermark = new WatermarkTextOptions("Sample Watermark");
            watermark.setColor(Color.RED);        // Set watermark color to red
            watermark.setWidth(100);              // Set watermark width
            watermark.setHeight(100);             // Set watermark height
            watermark.setBackground(true);        // Set watermark as background
            
            // Apply the watermark to the conversion options
            options.setWatermark(watermark);

            // Convert the document and apply the watermark
            converter.convert("addTextWatermark.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "annual-review.docx" >}}  
{{< tab-text >}}
`annual-review.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/add-watermark/annual-review.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "addTextWatermark.pdf" >}}  
{{< tab-text >}}
`addTextWatermark.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/add-watermark/addTextWatermark.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

By following these steps and adjusting the settings, you can easily add customized watermarks to your converted documents using GroupDocs.Conversion.
---

## Adding class name to input controls

Path: /editor/java/adding-class-name-to-input-controls/

Almost all formats within WordProcessing format family, like DOC(X/M), ODT etc., support input controls of different kinds. WordProcessing documents can contain different buttons, textboxes, check-boxes, combo-boxes, input fields, dropdown lists, radio-buttons, date/time pickers and much more, which are internally present as Structured Document Tag (SDT) entities or Fields ("Insert > Quick Parts > Document Property/Field"). **[GroupDocs.Editor](https://products.groupdocs.com/editor/java)** supports all of these entities and preserves them while converting the document to the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance. Finally, when generating a HTML document from [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) in order to edit it in the WYSIWYG HTML-editor, these input controls are translated into the most appropriate HTML structures and elements. Additionally, when input document contains not only input controls, but also user-entered data, this data is also preserved and will be present in the output HTML document.

In some specific use-cases the end-user may require not to edit the entire document content, but only edit and/or gather data, entered into the input controls. For such case it is required to identify all these input controls in some way in order to fetching them, to distinguish them from all other HTML elements, when working on client-side. For achieving this purpose the GroupDocs.Editor has an ability to set an unique user-provided CSS class name for all such input controls in HTML markup. Starting from version 20.2 there is an option `InputControlsClassName` (`getInputControlsClassName()` / `setInputControlsClassName(String value)`) in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions) class. It has the next appearance:

```java
public String getInputControlsClassName()
public void setInputControlsClassName(String)
```

By default it has a NULL value — class names are not applied to the HTML elements. However, if user will set a valid class name, all the input control elements (like INPUT, BUTTON, SELECT etc.) will have a "class" HTML attribute with specified class name. For example:

```java
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.setInputControlsClassName("myClass1");
```

Finally, when "class" attribute with specified class name is applied to all HTML elements, that represent input controls, client code is able to work with them by, for example, traversing the HTML DOM and gathering and/or manipulating with data.

## Complete example

Code example below demonstrates editing a sample DOCX file "Fields.docx", that contains 3 input controls: a textbox, a checkbox, and a drop down list. This file is edited twice: 1st time with default `WordProcessingEditOptions`, where no custom class name is specified, and 2nd time with custom value in the `InputControlsClassName` property using a `setInputControlsClassName(String value)` method. As a result, two resultant HTML files are produced.

```java
import com.groupdocs.editor.Editor;
import com.groupdocs.editor.editoptions.WordProcessingEditOptions;
import com.groupdocs.editor.formats.EditableDocument;

import java.nio.file.Files;
import java.nio.file.Paths;
// ...

Editor editor = new Editor("Fields.docx");

WordProcessingEditOptions optionsWithoutClassName = new WordProcessingEditOptions();

WordProcessingEditOptions optionsWithClassName = new WordProcessingEditOptions();
optionsWithClassName.setInputControlsClassName("myClass1");

EditableDocument docWithoutClassName = editor.edit(optionsWithoutClassName);
EditableDocument docWithClassName = editor.edit(optionsWithClassName);

Files.write(Paths.get("input-controls-without-custom-classname.html"),
		docWithoutClassName.getEmbeddedHtml().getBytes());

Files.write(Paths.get("input-controls-with-custom-classname.html"),
		docWithClassName.getEmbeddedHtml().getBytes());

docWithoutClassName.dispose();
docWithClassName.dispose();
editor.dispose();
```

Reference files to download:
- Input "[Fields.docx](/editor/java/sample-files/Fields.docx)"
- Output HTML "[input-controls-without-custom-classname.html](/editor/java/sample-files/input-controls-without-custom-classname.html)"
- Output HTML "[input-controls-with-custom-classname.html](/editor/java/sample-files/input-controls-with-custom-classname.html)"

Screenshot below shows the difference in HTML markup between these two output HTML files: without on the left side and with `class` attribute with a `"myClass1"` value on the right side.

![input controls without and with custom classname - side-by-side comparison](/editor/java/images/input-controls-without-with-custom-classname-side-by-side.png)
---

## Adding class name to input controls

Path: /editor/net/adding-class-name-to-input-controls/

Almost all formats within WordProcessing format family, like DOC(X/M), ODT etc., support input controls of different kinds. WordProcessing documents can contain different buttons, textboxes, check-boxes, combo-boxes, input fields, dropdown lists, radio-buttons, date/time pickers and much more, which are internally present as Structured Document Tag (SDT) entities or Fields ("Insert > Quick Parts > Document Property/Field"). **[GroupDocs.Editor](https://products.groupdocs.com/editor/net)** supports all of these entities and preserves them while converting the document to the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance. Finally, when generating a HTML document from [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) in order to edit it in the WYSIWYG HTML-editor, these input controls are translated into the most appropriate HTML structures and elements. Additionally, when input document contains not only input controls, but also user-entered data, this data is also preserved and will be present in the output HTML document.

In some specific use-cases the end-user may require not to edit the entire document content, but only edit and/or gather data, entered into the input controls. For such case it is required to identify all these input controls in some way in order to fetching them, to distinguish them from all other HTML elements, when working on client-side. For achieving this purpose the GroupDocs.Editor has an ability to set an unique user-provided CSS class name for all such input controls in HTML markup. Starting from version 20.2 there is an option [`InputControlsClassName`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions/inputcontrolsclassname/) in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class. It has the next appearance:

```csharp
public string InputControlsClassName {get; set;}
```

By default it has a NULL value — class names are not applied to the HTML elements. However, if user will set a valid class name, all the input control elements (like INPUT, BUTTON, SELECT etc.) will have a "class" HTML attribute with specified class name. For example:

{{< tabs "Signature">}}
{{< tab "C#" >}}
```csharp
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.InputControlsClassName = "myClass1";
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim editOptions As WordProcessingEditOptions = New WordProcessingEditOptions
editOptions.InputControlsClassName = "myClass1"
```
{{< /tab >}}
{{< /tabs >}}

Finally, when "class" attribute with specified class name is applied to all HTML elements, that represent input controls, client code is able to work with them by, for example, traversing the HTML DOM and gathering and/or manipulating with data.

## Complete example

Code example below demonstrates editing a sample DOCX file "Fields.docx", that contains 3 input controls: a textbox, a checkbox, and a drop down list. This file is edited twice: 1st time with default `WordProcessingEditOptions`, where no custom class name is specified, and 2nd time with custom value in the `InputControlsClassName` property. As a result, two resultant HTML files are produced.

{{< tabs "Complete example">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;
// ...

Editor editor = new Editor("Fields.docx");

WordProcessingEditOptions optionsWithoutClassName = new WordProcessingEditOptions();

WordProcessingEditOptions optionsWithClassName = new WordProcessingEditOptions();
optionsWithClassName.InputControlsClassName = "myClass1";

EditableDocument docWithoutClassName = editor.Edit(optionsWithoutClassName);
EditableDocument docWithClassName = editor.Edit(optionsWithClassName);

System.IO.File.WriteAllText("input-controls-without-custom-classname.html", 
    docWithoutClassName.GetEmbeddedHtml());
System.IO.File.WriteAllText("input-controls-with-custom-classname.html", 
    docWithClassName.GetEmbeddedHtml());

docWithoutClassName.Dispose();
docWithClassName.Dispose();
editor.Dispose();
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Editor.Formats
Imports GroupDocs.Editor.Options
' ...

Dim editor As Editor = New Editor("Fields.docx")

Dim optionsWithoutClassName As New WordProcessingEditOptions()

Dim optionsWithClassName As New WordProcessingEditOptions()
With optionsWithClassName
    .InputControlsClassName = "myClass1"
End With

Dim docWithoutClassName As EditableDocument = editor.Edit(optionsWithoutClassName)
Dim docWithClassName As EditableDocument = editor.Edit(optionsWithClassName)

System.IO.File.WriteAllText("input-controls-without-custom-classname.html",
                            docWithoutClassName.GetEmbeddedHtml())
System.IO.File.WriteAllText("input-controls-with-custom-classname.html",
                            docWithClassName.GetEmbeddedHtml())

docWithoutClassName.Dispose()
docWithClassName.Dispose()
editor.Dispose()
```
{{< /tab >}}
{{< /tabs >}}

Reference files to download:
- Input "[Fields.docx](/editor/net/sample-files/Fields.docx)"
- Output HTML "[input-controls-without-custom-classname.html](/editor/net/sample-files/input-controls-without-custom-classname.html)"
- Output HTML "[input-controls-with-custom-classname.html](/editor/net/sample-files/input-controls-with-custom-classname.html)"

Screenshot below shows the difference in HTML markup between these two output HTML files: without on the left side and with `class` attribute with a `"myClass1"` value on the right side.

![input controls without and with custom classname - side-by-side comparison](/editor/net/images/input-controls-without-with-custom-classname-side-by-side.png)

---

## Adding class name to input controls

Path: /editor/nodejs-java/adding-class-name-to-input-controls/



Almost all formats within the WordProcessing format family, such as DOC(X/M), ODT, etc., support input controls of various kinds. These documents can contain buttons, textboxes, checkboxes, combo-boxes, input fields, dropdown lists, radio-buttons, date/time pickers, and more, which are internally represented as Structured Document Tag (SDT) entities or Fields. **[GroupDocs.Editor](https://products.groupdocs.com/editor/nodejs-java)** supports all of these entities and preserves them when converting the document to an [EditableDocument](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/editabledocument) instance. When generating an HTML document from an [EditableDocument](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/editabledocument) to edit in a WYSIWYG HTML-editor on the client-side, these input controls are translated into the most appropriate HTML elements. Additionally, any user-entered data in these controls is preserved in the output HTML document.

### Why apply class names to input controls?

In specific scenarios, users may need to work only with input controls to edit or gather data entered on the client-side. For such cases, identifying input controls by assigning a unique CSS class name is essential. This helps distinguish these controls from other HTML elements, making them easier to manipulate or gather data from using client-side JavaScript.

Starting from version 20.8, the `inputControlsClassName` option is available in the `WordProcessingEditOptions` class, allowing users to assign a CSS class to all input controls in the HTML markup. The following methods are available:

```javascript
getInputControlsClassName(): string;
setInputControlsClassName(className: string): void;
```

In **Node.js**, you can assign a class name to input controls as follows:

```javascript
const WordProcessingEditOptions = groupdocs.options.WordProcessingEditOptions;

let editOptions = new WordProcessingEditOptions();
editOptions.inputControlsClassName = "myClass1";  // Assign a class name
```

In **Java**, this can be done similarly:

```java
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.setInputControlsClassName("myClass1");  // Assign a class name
```

### Example

After assigning the class name to input controls, all HTML elements representing input controls (e.g., `<input>`, `<button>`, `<select>`) will include the class attribute. For example:

```html
<input type="text" class="myClass1" />
<select class="myClass1">
  <option>Option 1</option>
</select>
```

This allows client-side JavaScript to easily target these input elements, for instance, to gather data or apply further manipulations:

```javascript
const inputs = document.querySelectorAll('.myClass1');
// Now you can loop through or manipulate these inputs
inputs.forEach(input => {
  console.log(input.value);
});
```
---

## Adding text watermarks

Path: /watermark/java/adding-text-watermarks/

Following code snippet shows how to add text watermark to a document. If the document consists of multiple parts (pages, worksheets, slides, frames etc), the watermark will be added to all of them.

**advanced\_usage.adding\_text\_watermarks.AddTextWatermark**

```java
// Specify an absolute or relative path to your image. Ex: "C:\\Docs\\image.png"
Watermarker watermarker = new Watermarker("image.png");                                   
                                                                                                   
// Initialize the font to be used for watermark                                                    
Font font = new Font("Arial", 19, FontStyle.Bold | FontStyle.Italic);                              
                                                                                                   
// Create the watermark object                                                                     
TextWatermark watermark = new TextWatermark("Test watermark", font);                               
                                                                                                   
// Set watermark properties                                                                        
watermark.setForegroundColor(Color.getRed());                                                      
watermark.setBackgroundColor(Color.getBlue());                                                     
watermark.setTextAlignment(TextAlignment.Right);                                                   
watermark.setOpacity(0.5);                                                                         
                                                                                                   
// Add watermark                                                                                   
watermarker.add(watermark);                                                                        
                                                                                                   
watermarker.save("image.png");                                                           
                                                                                                   
watermarker.close();                                                                             
```

## Sizing and positioning of watermark

### Absolute watermark positioning

Using GroupDocs.Watermark, you can also add watermark to some absolute position in the document. Following example shows how to add a text watermark with absolute positioning using methods [setX](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setX(double)), [setY](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setY(double)), [setWidth](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setWidth(double)) and [setHeight](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setHeight(double)). The values of all properties for absolute sizing and positioning are measured in default document units.

**advanced\_usage.adding\_text\_watermarks.AddWatermarkToAbsolutePosition**

```java
// Specify an absolute or relative path to your image. Ex: "C:\\Docs\\image.png"
Watermarker watermarker = new Watermarker("image.png");                                   
                                                                                                   
Font font = new Font("Times New Roman", 8);                                                        
TextWatermark watermark = new TextWatermark("Test watermark", font);                               
                                                                                                   
// Set watermark coordinates                                                                       
watermark.setX(10);                                                                                
watermark.setY(20);                                                                                
                                                                                                   
// Set watermark size                                                                              
watermark.setWidth(100);                                                                           
watermark.setHeight(40);                                                                           
                                                                                                   
watermarker.add(watermark);                                                                        
watermarker.save("image.png");                                                           
                                                                                                   
watermarker.close();                                                                             
```

{{< alert style="warning" >}}Note that the origin of coordinates may be different for different document types (relative positioning doesn't have these specifics and can be used as a unified positioning approach).{{< /alert >}}

Following are the origin of the coordinates for different formats of the documents.

| Document Format | Unit of Measure | Origin of Coordinates |
| --- | --- | --- |
| PDF | Point | Left bottom corner of page |
| WordProcessing | Point | Left top corner of page  |
| Spreadsheet | Point | Left top corner of worksheet  |
| Presentation | Point | Left top corner of slide  |
| Image | Pixel | Left top corner of image (frame)  |
| Diagram | Point | Left top corner of page |

### Relative watermark positioning 

Instead of exact coordinates, you can also use parent relative alignment. Furthermore, you can also set offset from parent's borders by using [Margins](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#getMargins()) property as shown in below example. Following example shows how to align the watermark vertically and horizontally.

**advanced\_usage.adding\_text\_watermarks.AddWatermarkToRelativePosition**

```java
// Specify an absolute or relative path to your image. Ex: "C:\\Docs\\image.png
Watermarker watermarker = new Watermarker("image.png");                                  
                                                                                                  
Font font = new Font("Calibri", 12);                                                              
TextWatermark watermark = new TextWatermark("Test watermark", font);                              
watermark.setHorizontalAlignment(HorizontalAlignment.Right);                                      
watermark.setVerticalAlignment(VerticalAlignment.Bottom);                                         
                                                                                                  
// Set absolute margins. Values are measured in document units.                                   
watermark.getMargins().setRight(10);                                                              
watermark.getMargins().setBottom(5);                                                              
                                                                                                  
watermarker.add(watermark);                                                                       
watermarker.save("image.png");                                                          
                                                                                                  
watermarker.close();                                                                            
```

{{< alert style="warning" >}}Excel worksheets don't have explicit borders, therefore, the most right bottom non-empty cell is used to determine working area size.{{< /alert >}}

### Using [setMarginType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/Margins#setMarginType(int))

In the example above, absolute margin values are used. This means that margins are measured in document units. But you can set relative margins for a watermark as well (as shown in below example).

**advanced\_usage.adding\_text\_watermarks.AddWatermarkWithMarginType**

```java
// Specify an absolute or relative path to your image. Ex: "C:\\Docs\\image.png"
Watermarker watermarker = new Watermarker("image.png");                                   
                                                                                                   
Font font = new Font("Calibri", 12);                                                               
TextWatermark watermark = new TextWatermark("Test watermark", font);                               
watermark.setHorizontalAlignment(HorizontalAlignment.Right);                                       
watermark.setVerticalAlignment(VerticalAlignment.Bottom);                                          
                                                                                                   
// Set relative margins. Margin value will be interpreted as a portion                             
// of appropriate parent dimension. If this type is chosen, margin value                           
// must be between 0.0 and 1.0.                                                                    
watermark.getMargins().setMarginType(MarginType.RelativeToParentDimensions);                       
watermark.getMargins().setRight(0.1);                                                              
watermark.getMargins().setBottom(0.2);                                                             
                                                                                                   
watermarker.add(watermark);                                                                        
watermarker.save("image.png");                                                           
                                                                                                   
watermarker.close();                                                                             
```

### Size types

In most cases, to add good looking watermark, you should consider the size of the page/slide/frame on which it will be placed. [setSizingType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setSizingType(int)) and [setScaleFactor](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setScaleFactor(double)) methods can be used to scale the watermark depending on the parent size.

**advanced\_usage.adding\_text\_watermarks.AddWatermarkWithSizeType**

```java
// Specify an absolute or relative path to your image. Ex: "C:\\Docs\\image.png"
Watermarker watermarker = new Watermarker("image.png");                                   
                                                                                                   
Font font = new Font("Calibri", 12);                                                               
TextWatermark watermark = new TextWatermark("This is a test watermark", font);                     
                                                                                                   
// Set sizing type                                                                                 
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                       
                                                                                                   
// Set watermark scale                                                                             
watermark.setScaleFactor(0.5);                                                                     
                                                                                                   
watermarker.add(watermark);                                                                        
watermarker.save("image.png");                                                           
                                                                                                   
watermarker.close();                                                                             
```

{{< alert style="info" >}}Using of relative size and positioning is the simplest way to add watermark to a document of any type.{{< /alert >}}

### Watermark rotation

GroupDocs.Watermark API also supports rotation of the watermark. You can use [setRotateAngle](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setRotateAngle(double)) method to define watermark rotation angle in degrees. A positive value means clockwise rotation.

**advanced\_usage.adding\_text\_watermarks.AddTextWatermarkWithRotationAngle**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\test.docx"
Watermarker watermarker = new Watermarker("test.docx");                                   
                                                                                                   
Font font = new Font("Calibri", 8);                                                                
TextWatermark watermark = new TextWatermark("Test watermark", font);                               
watermark.setHorizontalAlignment(HorizontalAlignment.Right);                                       
watermark.setVerticalAlignment(VerticalAlignment.Top);                                             
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                       
watermark.setScaleFactor(0.5);                                                                     
                                                                                                   
// Set rotation angle                                                                              
watermark.setRotateAngle(45);                                                                      
                                                                                                   
watermarker.add(watermark);                                                                        
watermarker.save("test.docx");                                                           
                                                                                                   
watermarker.close();                                                                             
```

If rotation angle is set, it is assumed that watermark size is equal to axis-aligned bounding box size. The following picture illustrates what is the watermark bounding box and how it is used for sizing and positioning. The picture shows a result of execution of the above code snippet. The actual watermark bounds are colored in blue and the bounding box is colored in red. As you can see, the bounding box size is used to calculate watermark relative size.

![](/watermark/java/images/adding-text-watermarks.jpg)

### Considering parent margins

For most document formats you can set page margins when working with a document. By default, GroupDocs.Watermark ignores document margins and uses maximum available space for watermarking as shown in below image.

![](/watermark/java/images/adding-text-watermarks_1.png)

As you can see, the watermark goes beyond page margins. To change this behavior, call [setConsiderParentMargins](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setConsiderParentMargins(boolean)) method with true (as shown in below example).

**advanced\_usage.adding\_text\_watermarks.AddWatermarkWithParentMargin**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\input.vsdx"
Watermarker watermarker = new Watermarker("input.vsdx");                                    
                                                                                                     
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 42));                
watermark.setHorizontalAlignment(HorizontalAlignment.Right);                                         
watermark.setVerticalAlignment(VerticalAlignment.Top);                                               
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                         
watermark.setScaleFactor(1);                                                                         
watermark.setRotateAngle(45);                                                                        
watermark.setForegroundColor(Color.getRed());                                                        
watermark.setBackgroundColor(Color.getAqua());                                                       
                                                                                                     
// Add watermark considering parent margins                                                          
watermark.setConsiderParentMargins(true);                                                            
                                                                                                     
watermarker.add(watermark);                                                                          
watermarker.save("input.vsdx");                                                            
                                                                                                     
watermarker.close();                                                                               
```

Now, the watermark is aligned with respect to page margins.

![](/watermark/java/images/adding-text-watermarks_2.png)

## Watermark in documents of different types

Watermarks in documents of different types are represented by different objects. Some of these objects do not support some watermark properties. For example, the background color can not be set for WordArt object which is used as text watermark in a Word document. The full list of supported properties for all document types is available at [Features Overview]({{< ref "/watermark/java/getting-started/features-overview.md" >}}).

---

## Adding watermark to images inside a document

Path: /watermark/java/adding-watermark-to-images-inside-a-document/

The most of the document formats allow you to place images inside a document. If you want to add watermark to images inside a document then it can be possible using GroupDocs.Watermark. Following are the steps to add watermark to the images of any document.

1.  Load the document 
2.  Create and initialize watermark object 
3.  Set watermark properties 
4.  [Find](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#getImages()) images in the document
5.  [Add](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WatermarkableImage#add(com.groupdocs.watermark.Watermark)) watermark to all found images
6.  Save the document

**advanced\_usage.add\_watermarks\_to\_images.AddWatermarkToImagesInsideDocument**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
// Initialize text watermark                                                                             
TextWatermark textWatermark = new TextWatermark("Protected image", new Font("Arial", 8));                
textWatermark.setHorizontalAlignment(HorizontalAlignment.Center);                                        
textWatermark.setVerticalAlignment(VerticalAlignment.Center);                                            
textWatermark.setRotateAngle(45);                                                                        
textWatermark.setSizingType(SizingType.ScaleToParentDimensions);                                         
textWatermark.setScaleFactor(1);                                                                         
                                                                                                         
// Initialize image watermark                                                                            
ImageWatermark imageWatermark = new ImageWatermark("protect.jpg");                                
                                                                                                         
imageWatermark.setHorizontalAlignment(HorizontalAlignment.Center);                                       
imageWatermark.setVerticalAlignment(VerticalAlignment.Center);                                           
imageWatermark.setRotateAngle(-45);                                                                      
imageWatermark.setSizingType(SizingType.ScaleToParentDimensions);                                        
imageWatermark.setScaleFactor(1);                                                                        
                                                                                                         
// Find all images in a document                                                                         
WatermarkableImageCollection images = watermarker.getImages();                                           
                                                                                                         
for (int i = 0; i < images.getCount(); i++)                                                              
{                                                                                                        
    if (images.get_Item(i).getWidth() > 100 && images.get_Item(i).getHeight() > 100)                     
    {                                                                                                    
        if (i % 2 == 0)                                                                                  
        {                                                                                                
            images.get_Item(i).add(textWatermark);                                                       
        }                                                                                                
        else                                                                                             
        {                                                                                                
            images.get_Item(i).add(imageWatermark);                                                      
        }                                                                                                
    }                                                                                                    
}                                                                                                        
                                                                                                         
imageWatermark.close();                                                                                  
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

---

## Alias dictionary

Path: /search/java/alias-dictionary/

An instance of the [AliasDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary) class contains all the aliases defined in an index. Information on using aliases to search is provided on the [Using aliases]({{< ref "search/java/developer-guide/advanced-usage/searching/using-aliases.md" >}}) page.

To get the number of existing aliases, use the [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary#getCount()) method.

Use the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary#add(java.lang.String,%20java.lang.String)) method to add new alias-replacement pair.

Use the [addRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary#addRange(com.groupdocs.search.dictionaries.AliasReplacementPair%5B%5D)) method to add a collection of new alias-replacement pairs.

To remove an alias from the dictionary, use the [remove](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary#remove(java.lang.String)) method.

The [contains](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary#contains(java.lang.String)) method is used to check for the presence of a particular alias in the dictionary.

To get a replacement for a particular alias, use the [getText](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary#getText(java.lang.String)) method.

The [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/AliasDictionary#clear()) method is used to remove all existing aliases from the dictionary.

To export the list of aliases with replacements to a file, use the [exportDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import the list of aliases from a file, use the [importDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the alias dictionary.



```java
String indexFolder = "c:\\MyIndex\\";
 
// Creating or opening an index from the specified folder
Index index = new Index(indexFolder);
 
if (index.getDictionaries().getAliasDictionary().getCount() > 0) {
    // Deleting all existing aliases
    index.getDictionaries().getAliasDictionary().clear();
}
 
// Adding aliases to the alias dictionary
index.getDictionaries().getAliasDictionary().add("t", "(theory OR relativity)");
index.getDictionaries().getAliasDictionary().add("e", "(Einstein OR Albert)");
AliasReplacementPair[] pairs = new AliasReplacementPair[] {
    new AliasReplacementPair("d", "daterange(2017-01-01 ~~ 2019-12-31)"),
    new AliasReplacementPair("n", "(100 ~~ 900)"),
};
index.getDictionaries().getAliasDictionary().addRange(pairs);
 
if (index.getDictionaries().getAliasDictionary().contains("e")) {
    // Getting an alias replacement
    String replacement = index.getDictionaries().getAliasDictionary().getText("e");
    System.out.println("e - " + replacement);
}
 
// Export aliases to a file
index.getDictionaries().getAliasDictionary().exportDictionary("C:\\Aliases.dat");
 
// Import aliases from a file
index.getDictionaries().getAliasDictionary().importDictionary("C:\\Aliases.dat");
 
// Search in the index
SearchResult result = index.search("@t OR @e");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Alias dictionary

Path: /search/net/alias-dictionary/

An instance of the [AliasDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary) class contains all the aliases defined in an index. Information on using aliases to search is provided on the [Using aliases]({{< ref "search/net/developer-guide/advanced-usage/searching/using-aliases.md" >}}) page.

To get the number of existing aliases, use the [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary/properties/count) property.

Use the [Add](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary/methods/add) method to add new alias-replacement pair.

Use the [AddRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary/methods/addrange/index) method to add a collection of new alias-replacement pairs.

To remove an alias from the dictionary, use the [Remove](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary/methods/remove) method.

The [Contains](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary/methods/contains) method is used to check for the presence of a particular alias in the dictionary.

To get a replacement for a particular alias, use the [GetText](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary/methods/gettext) method.

The [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/aliasdictionary/methods/clear) method is used to remove all existing aliases from the dictionary.

To export the list of aliases with replacements to a file, use the [ExportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/exportdictionary) method.

To import the list of aliases from a file, use the [ImportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/importdictionary) method.

The following example demonstrates the use of methods of the alias dictionary.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
 
// Creating or opening an index from the specified folder
Index index = new Index(indexFolder);
 
if (index.Dictionaries.AliasDictionary.Count > 0)
{
    // Deleting all existing aliases
    index.Dictionaries.AliasDictionary.Clear();
}
 
// Adding aliases to the alias dictionary
index.Dictionaries.AliasDictionary.Add("t", "(theory OR relativity)");
index.Dictionaries.AliasDictionary.Add("e", "(Einstein OR Albert)");
AliasReplacementPair[] pairs = new AliasReplacementPair[]
{
    new AliasReplacementPair("d", "daterange(2017-01-01 ~~ 2019-12-31)"),
    new AliasReplacementPair("n", "(100 ~~ 900)"),
};
index.Dictionaries.AliasDictionary.AddRange(pairs);
 
if (index.Dictionaries.AliasDictionary.Contains("e"))
{
    // Getting an alias replacement
    string replacement = index.Dictionaries.AliasDictionary.GetText("e");
    Console.WriteLine("e - " + replacement);
}
 
// Export aliases to a file
index.Dictionaries.AliasDictionary.ExportDictionary(@"C:\Aliases.dat");
 
// Import aliases from a file
index.Dictionaries.AliasDictionary.ImportDictionary(@"C:\Aliases.dat");
 
// Search in the index
SearchResult result = index.Search("@t OR @e");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Alias dictionary

Path: /search/nodejs-java/alias-dictionary/

An instance of the [AliasDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary) class contains all the aliases defined in an index. Information on using aliases to search is provided on the [Using aliases]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/using-aliases.md" >}}) page.

To get the number of existing aliases, use the [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary#getCount()) method.

Use the [add](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary#add(java.lang.String,%20java.lang.String)) method to add new alias-replacement pair.

Use the [addRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary#addRange(com.groupdocs.search.dictionaries.AliasReplacementPair%5B%5D)) method to add a collection of new alias-replacement pairs.

To remove an alias from the dictionary, use the [remove](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary#remove(java.lang.String)) method.

The [contains](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary#contains(java.lang.String)) method is used to check for the presence of a particular alias in the dictionary.

To get a replacement for a particular alias, use the [getText](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary#getText(java.lang.String)) method.

The [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/AliasDictionary#clear()) method is used to remove all existing aliases from the dictionary.

To export the list of aliases with replacements to a file, use the [exportDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import the list of aliases from a file, use the [importDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the alias dictionary.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating or opening an index from the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

if (index.getDictionaries().getAliasDictionary().getCount() > 0) {
  // Deleting all existing aliases
  index.getDictionaries().getAliasDictionary().clear();
}

// Adding aliases to the alias dictionary
index.getDictionaries().getAliasDictionary().add('t', '(gravida OR promotion)');
index.getDictionaries().getAliasDictionary().add('e', '(viverra OR farther)');
const pairs = java.newArray('com.groupdocs.search.dictionaries.AliasReplacementPair', [
  new groupdocs.search.AliasReplacementPair('d', 'daterange(2017-01-01 ~~ 2019-12-31)'),
  new groupdocs.search.AliasReplacementPair('n', '(400 ~~ 4000)'),
]);
index.getDictionaries().getAliasDictionary().addRange(pairs);

if (index.getDictionaries().getAliasDictionary().contains('e')) {
  // Getting an alias replacement
  const replacement = index.getDictionaries().getAliasDictionary().getText('e');
  console.log('e - ' + replacement);
}

// Export aliases to a file
const fileName = Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/aliasDictionary/Aliases.dat';
index.getDictionaries().getAliasDictionary().exportDictionary(fileName);

// Import aliases from a file
index.getDictionaries().getAliasDictionary().importDictionary(fileName);

// Search in the index
const query = '@t OR @e';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Attachments in PDF document

Path: /watermark/net/attachments-in-pdf-document/

## Extract all attachments from PDF document

GroupDocs.Watermark API allows you to extract [attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfcontent/properties/attachments) in PDF document. Following code performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfExtractAllAttachments**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfAttachment attachment in pdfContent.Attachments)
    {
        Console.WriteLine("Name: {0}", attachment.Name);
        Console.WriteLine("Description: {0}", attachment.Description);
        Console.WriteLine("File type: {0}", attachment.GetDocumentInfo().FileType);

        // Save the attached file on disk
        File.WriteAllBytes(Path.Combine("SampleFiles\Output", attachment.Name), attachment.Content);
    }
}
```

## Add an attachment to PDF document

The API also allows you to add attachments to the PDF document. Following code snippet shows how to remove an attachment

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfAddAttachment**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Add the attachment
    pdfContent.Attachments.Add(File.ReadAllBytes("sample.docx"), "sample doc", "sample doc as attachment");

    // Save changes
    watermarker.Save("document.pdf");
}
```

## Remove attachment from PDF document

The API also allows you to remove attachments from the PDF document. Following code snippet shows how to remove an attachment.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveAttachment**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    for (int i = pdfContent.Attachments.Count - 1; i >= 0; i--)
    {
        PdfAttachment attachment = pdfContent.Attachments[i];

        // Remove all attached pdf files with a particular name
        if (attachment.Name.Contains("sample") && attachment.GetDocumentInfo().FileType == FileType.DOCX)
        {
            pdfContent.Attachments.RemoveAt(i);
        }
    }

    watermarker.Save("document.pdf");
}
```

## Search for images attachments

In case you want to search for all the images attachments in a PDF document, you can use GroupDocs.Watermark. Following code sample shows how to search images attachments of PDF document.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfSearchImageInAttachment**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    // Consider only the attached images
    watermarker.SearchableObjects.PdfSearchableObjects = PdfSearchableObjects.AttachedImages;

    // Search for similar images
    WatermarkableImageCollection possibleWatermarks = watermarker.GetImages();
    Console.WriteLine("Found {0} image(s).", possibleWatermarks.Count);
}
```

---

## Attachments in PDF document

Path: /watermark/python-net/attachments-in-pdf-document/


## Extract all attachments from PDF document
This sample extracts every embedded file from a PDF, prints basic metadata (name, description, file type), and writes the attachment bytes to an output folder.

```python
import os
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

output_dir = os.path.join("SampleFiles", "Output")
os.makedirs(output_dir, exist_ok=True)

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for attachment in pdf_content.attachments:
        print("Name:", attachment.name)
        print("Description:", attachment.description)
        print("File type:", attachment.get_document_info().file_type)

        with open(os.path.join(output_dir, attachment.name), "wb") as f:
            f.write(attachment.content)
```

## Add an attachment to PDF document
This sample embeds an external file into the PDF as an attachment, assigning a display name and description, and then saves the updated document.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    with open("sample.docx", "rb") as f:
        pdf_content.attachments.add(f.read(), "sample doc", "sample doc as attachment")

    watermarker.save("document.pdf")
```

## Remove attachment from PDF document
This sample finds and removes attachments that match custom criteria (for example, a name containing "sample" and the DOCX file type), and then saves the PDF.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
from groupdocs.watermark.common import FileType

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for i in range(pdf_content.attachments.count - 1, -1, -1):
        attachment = pdf_content.attachments[i]
        if ("sample" in attachment.name) and (attachment.get_document_info().file_type == FileType.DOCX):
            pdf_content.attachments.remove_at(i)

    watermarker.save("document.pdf")
```

## Search for images attachments
This sample limits the search scope to images inside attachments and returns the found image collection for further processing or inspection.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.common as gwc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    watermarker.searchable_objects.pdf_searchable_objects = gwc.PdfSearchableObjects.ATTACHED_IMAGES
    images = watermarker.get_images()
    print("Found", images.count, "image(s).")
```



---

## eSign document with Barcode signature

Path: /signature/net/esign-document-with-barcode-signature/

## What is a Barcode?

A **barcode** or **bar code** is a way of presenting data in a visual, machine-readable form. Generally speaking, barcode is an image of a rectangular form that consists of parallel black lines and white spaces of different widths.  
Barcodes are used in various areas where quick identification is necessary - as part of the purchase process in retail stores, in warehouses to track inventory, and on invoices to assist in accounting, among many other uses.

![Barcode](/signature/net/images/esign-document-with-barcode-signature.gif)

Barcodes allow storing of product-related data like manufacturing and expiry dates, manufacturer name, country of origin, and product price. There are plenty of barcode types nowadays because different companies use different combinations of numbers and bars in their barcodes depending on their needs. From the document signature perspective, Barcode may contain different characters (letters, digits, or symbols) and may have various lengths and sizes depending on the type and settings to keep signature information, title, subject, or short encrypted data.  

## How to eSign document with Barcode signature

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) supports a wide range of Barcode types that can be used to create electronic signatures within the documents. Please refer to the [BarcodeTypes](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodetypes/#fields) description to get the full list of supported barcodes.  
To specify different options for Barcode signature GroupDocs.Signature for .NET provides [BarcodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions) class. The main fields are:

* [EncodeType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions/encodetype) - specifies the Barcode type (AustralianPost, Codabar, EAN13, OPC, etc.);
* [Text](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/text) - specifies the Barcode text.


Here are the steps to eSign a document with the Barcode signature using GroupDocs.Signature for .NET API:
* Create a new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [BarcodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions) object according to your requirements and specify the Barcode type by setting the [EncodeType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions/encodetype) property with one of the predefined supported types. Set the [Text](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/text) property value.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [BarcodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions) to it.

This example shows how to sign a PDF document with a Barcode signature.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    BarcodeSignOptions options = new BarcodeSignOptions("JohnSmith")
    {
        // setup Barcode encoding type
        EncodeType = BarcodeTypes.Code128,
        // set signature position
        Left = 100,
        Top = 100
    };
    signature.Sign("SampleSigned.pdf", options);
}
```

### Summary
This guide demonstrates how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) to add barcode-based signatures to documents. It covers creating, configuring, and applying barcode signatures with support for various barcode types and customization options. For further exploration, refer to related guides on document information and advanced signing techniques.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign document with Barcode signature

Path: /signature/nodejs-java/esign-document-with-barcode-signature/

## What is a Barcode?

A **barcode** or **bar code** is a way of presenting data in a visual, machine-readable form. Generally speaking, barcode is an image of a rectangular form that consists of parallel black lines and white spaces of different widths.  
Barcodes are used in various areas where quick identification is necessary - as part of the purchase process in retail stores, in warehouses to track inventory, and on invoices to assist in accounting, among many other uses.

![Barcode](/signature/nodejs-java/images/esign-document-with-barcode-signature.gif)

Barcodes allow storing of product-related data like manufacturing and expiry dates, manufacturer name, country of origin, and product price. There are plenty of barcode types nowadays because different companies use different combinations of numbers and bars in their barcodes depending on their needs. From the document signature perspective, Barcode may contain different characters (letters, digits, or symbols) and may have various lengths and sizes depending on the type and settings to keep signature information, title, subject, or short encrypted data.  

## How to eSign document with Barcode signature

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) supports a wide range of Barcode types that can be used to create electronic signatures within the documents. Please refer to the [BarcodeTypes](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain.barcodetypes#fields) description to get the full list of supported barcodes.  
To specify different options for Barcode signature, GroupDocs.Signature for Node.Js via Java provides [BarcodeSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.barcodesignoptions) class. The main fields are:

* [EncodeType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/barcodesignoptions/encodetype) - specifies the Barcode type (AustralianPost, Codabar, EAN13, OPC, etc.);
* [Text](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions/text) - specifies the Barcode text.

Here are the steps to eSign a document with the Barcode signature using GroupDocs.Signature for Node.Js via Java API:
* Create a new instance of [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.signature) class and pass the source document path as a constructor parameter.
* Instantiate the [BarcodeSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.barcodesignoptions) object according to your requirements and specify the Barcode type by setting the [EncodeType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.barcodesignoptions#encodetype) property with one of the predefined supported types. Set the [Text](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.barcodesignoptions#text) property value.
* Call the [sign](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.signature#sign) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.signature) class instance and pass the [BarcodeSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.barcodesignoptions) to it.

This example shows how to sign a PDF document with a Barcode signature.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF; 
  const fileName = path.basename(filePath);

  const outputFilePath = path.join(Constants.OutputPath, 'SignPdfWithBarcode', fileName);
  const signature = new signatureLib.Signature(filePath);

  // Create barcode option with predefined barcode text
  const options = new signatureLib.BarcodeSignOptions('JohnSmith');
  // Setup barcode encoding type
  options.setEncodeType(signatureLib.BarcodeTypes.Code128);
  // Set signature position
  options.setLeft(100);
  options.setTop(100);
  options.setWidth(200);
  options.setHeight(50);
  
  // Sign document to file
  signature.sign(outputFilePath, options);
  console.log(`\nSource document signed successfully.\nFile saved at ${outputFilePath}`);
```

### Summary
This guide demonstrates how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) to add barcode-based signatures to documents. It covers creating, configuring, and applying barcode signatures with support for various barcode types and customization options. For further exploration, refer to related guides on document information and advanced signing techniques.

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature Node.Js for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Barcodes Syntax and Properties

Path: /assembly/java/barcodes-syntax-and-properties/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.2.0 or later releases.{{< /alert >}}

## Inserting Barcodes Dynamically

You can insert barcode images to your documents dynamically using barcode tags. To declare a dynamically inserted barcode image within your template, perform the following steps:

1.  Add a textbox to your template at the place where you want a barcode image to be inserted.
2.  Set common image attributes such as size, rotation angle, and others for the textbox, making the textbox look like a barcode image without bars and text.
3.  Specify a barcode tag within the textbox using the following syntax:

```java
<<barcode [barcode_expression] -barcode_type>>
```

During run-time, an expression declared within a barcode tag is evaluated, its value is encoded using the specified barcode type, and the tag's containing textbox is filled with a corresponding barcode image. The tag itself is removed from the textbox then.  
To specify a barcode type within a barcode tag, you can use one of the predefined identifiers described in the following table:

| Identifier | Description |
| --- | --- |
| codabar | CODABAR Barcode |
| code11 | CODE 11 barcode |
| code39S | Standard CODE 39 barcode |
| code39E | Extended CODE 39 barcode |
| code93S | Standard CODE 93 barcode |
| code93E | Extended CODE 93 barcode |
| code128 | CODE 128 barcode |
| code128GS1 | GS1 CODE 128 barcode specification. The barcode text must contain parentheses for A |
| ean8 | EAN-8 barcode |
| ean13 | EAN-13 barcode |
| ean14 | EAN-14 barcode |
| scc14 | SCC-14 barcode |
| sscc18 | SSCC-18 barcode |
| upca | UPC-A barcode |
| upce | UPC-E barcode |
| isbn | ISBN barcode |
| issn | ISSN barcode |
| ismn | ISMN barcode |
| stf | Standard 2 of 5 barcode |
| itf | Interleaved 2 of 5 barcode |
| mtf | Matrix 2 of 5 barcode |
| ip25 | Italian Post 25 barcode |
| iatatf | IATA 2 of 5 barcode. IATA (International Air Transport Assosiation) uses this barcode for the management of air cargo |
| itf14 | ITF14 barcode |
| itf6 | ITF-6 barcode |
| msi | MSI Plessey barcode |
| vin | VIN (Vehicle Identification Number) barcode |
| dpi | Deutschen Post barcode, also known as Identcode, CodeIdentcode, German Postal 2 of 5 Identcode, Deutsche Post AG Identcode, Deutsche Frachtpost Identcode, Deutsche Post AG (DHL) |
| dpl | Deutsche Post Leitcode barcode, also known as German Postal 2 of 5 Leitcode, CodeLeitcode, Leitcode, Deutsche Post AG (DHL) |
| opc | OPC (Optical Product Code) barcode, also known as VCA barcode, VCA OPC, Vision Council of America OPC barcode |
| pzn | PZN barcode, also known as Pharma Zentral Nummer, Pharmazentralnummer |
| code16K | Code 16K barcode |
| pharmacode | Represents Pharmacode barcode, also known as Code32 |
| dm | DataMatrix barcode |
| qr | QR Code barcode |
| aztec | Aztec barcode |
| pdf417 | Pdf417 barcode |
| macroPdf417 | MacroPdf417 barcode |
| dmGS1 | DataMatrix barcode with GS1 string format |
| microPdf417 | MicroPdf417 barcode |
| qrGS1 | QR barcode with GS1 string format |
| maxiCode | MaxiCode barcode |
| dotCode | DotCode barcode |
| ap | Australia Post Customer barcode |
| postnet | Postnet barcode |
| planet | Planet barcode |
| oneCode | USPS OneCode barcode |
| rm4scc | RM4SCC barcode. RM4SCC (Royal Mail 4-state Customer Code) is used for automated mail sort process in UK |
| databarOD | Databar omni-directional barcode |
| databarT | Databar truncated barcode |
| databarL | Databar limited barcode |
| databarE | Databar expanded barcode |
| databarES | Databar expanded stacked barcode |
| databarS | Databar stacked barcode |
| databarSOD | Databar stacked omni-directional barcode |
| sp | Singapore Post barcode |
| ape | Australian Post Domestic eParcel barcode |
| spp | Swiss Post Parcel barcode. Supported types: Domestic Mail, International Mail, Additional Services |
| patchCode | Patch code barcode |
| code32 | Code32 barcode |
| dltf | DataLogic 2 of 5 barcode |
| dkix | Dutch KIX barcode |
| codablockF | Codablock F barcode |
| codablockFGS1 | GS1 Codablock F barcode |
| code128GS1UPCA | GS1-128 AI 8102 Coupon Extended barcode |
| databarGS1UPCA | UPCA & GS1 Databar Coupon barcode |

### Scaling Barcode Symbols

You can scale barcode symbols of dynamically inserted barcode images specifying the scale attribute for a barcode tag as follows.

```java
<<barcode [barcode_expression] -barcode_type scale="scaling_hint">>
```

A scale attribute affects the width and height of a 2D barcode symbol and the width of a 1D barcode symbol. The value of a scale attribute represents the percent of barcode symbol scaling.  
The value of a scale attribute, however, is just a hint. That is, actual scaling of a barcode symbol can be not precisely equal to the specified one. The reason is that scaling can damage a barcode symbol in a way it to become unreadable by barcode scanners. That is why, the engine calculates actual scaling not to bring such a damage trying to be as close to the specified scaling as possible at the same time.

### Configuring Initial Scaling of Barcode Symbols

You can affect initial scaling of all barcode symbols generated by a single DocumentAssembler instance through the **DocumentAssembler.BarcodeSettings.BaseXDimension** and **DocumentAssembler.BarcodeSettings.BaseYDimension** properties. These properties define the smallest width and height of the unit of barcode modules respectively. That is, for example, to make all barcode symbols twice larger by default, you can use the following code:

```java
DocumentAssembler assembler = new DocumentAssembler();
assembler.BarcodeSettings.BaseXDimension *= 2f;
assembler.BarcodeSettings.BaseYDimension *= 2f;
```

Values of the **DocumentAssembler.BarcodeSettings.BaseXDimension** and **DocumentAssembler.BarcodeSettings.BaseYDimension** properties are measured in units defined by the **DocumentAssembler.BarcodeSettings.GraphicsUnit** property.

{{< alert style="warning" >}}When the scale attribute is provided for a barcode tag, actual x- and y-dimensions are calculated by the engine as the corresponding percent of base x- and y-dimensions.{{< /alert >}}

### Setting Height of 1D Barcode Symbols

The height of a 1D barcode symbol is not affected by the scale attribute of the corresponding barcode tag. However, you can set the height applying the barHeight attribute as follows:

```java
<<barcode [barcode_expression] -barcode_type barHeight="height">>
```

The value of a barHeight attribute specifies the percent of the overall barcode image height. That is, for example, to set the height of a barcode symbol equal to two thirds of its overall barcode image height, you can use the following barcode tag:

```java
<<barcode ["736192"] -codabar barHeight="67">>
```

### Customizing Fore and Back Colors of Barcode Images

The fore color of a dynamically inserted barcode image is used to render the barcode's symbol and text. This color is derived from the font of the corresponding barcode tag. The background color of the image is derived from the solid fill of the textbox containing the tag.

### Customizing Font and Placement of Barcode Text

The font used to render barcode text of a dynamically inserted barcode image derives the following attributes from the font of the corresponding barcode tag:

*   Name
*   Size
*   Style (bold and italic)
*   Color

The placement of barcode text of a dynamically inserted barcode image – leftward, rightward, or centered – is defined by text alignment of the corresponding barcode tag.

### Using Barcode Text Auto-Correction

For a dynamically inserted barcode image, the engine automatically corrects barcode text that does not conform the barcode's specification, if possible.

{{< alert style="warning" >}}The auto-correction is not possible for barcodes of some types like Databar.{{< /alert >}}

To disable the auto-correction making the engine throw an exception in case of an invalid barcode text, you can set the **DocumentAssembler.BarcodeSettings.UseAutoCorrection** property to false.

### Example with Output

```java
<<barcode ["736192"] -codabar>>
```

Generated barcode for above mentioned syntax is:

![](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Images/output.PNG?raw=true)

---

## Barcodes Syntax and Properties

Path: /assembly/net/barcodes-syntax-and-properties/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.2.0 or later releases.{{< /alert >}}

## Inserting Barcodes Dynamically

You can insert barcode images to your documents dynamically using barcode tags. To declare a dynamically inserted barcode image within your template, perform the following steps:

1.  Add a textbox to your template at the place where you want a barcode image to be inserted.
2.  Set common image attributes such as size, rotation angle, and others for the textbox, making the textbox look like a barcode image without bars and text.
3.  Specify a barcode tag within the textbox using the following syntax:

```csharp
<<barcode [barcode_expression] -barcode_type>>
```

During run-time, an expression declared within a barcode tag is evaluated, its value is encoded using the specified barcode type, and the tag's containing textbox is filled with a corresponding barcode image. The tag itself is removed from the textbox then.  
To specify a barcode type within a barcode tag, you can use one of the predefined identifiers described in the following table:

| Identifier | Description |
| --- | --- |
| codabar | CODABAR Barcode |
| code11 | CODE 11 barcode |
| code39S | Standard CODE 39 barcode |
| code39E | Extended CODE 39 barcode |
| code93S | Standard CODE 93 barcode |
| code93E | Extended CODE 93 barcode |
| code128 | CODE 128 barcode |
| code128GS1 | GS1 CODE 128 barcode specification. The barcode text must contain parentheses for A |
| ean8 | EAN-8 barcode |
| ean13 | EAN-13 barcode |
| ean14 | EAN-14 barcode |
| scc14 | SCC-14 barcode |
| sscc18 | SSCC-18 barcode |
| upca | UPC-A barcode |
| upce | UPC-E barcode |
| isbn | ISBN barcode |
| issn | ISSN barcode |
| ismn | ISMN barcode |
| stf | Standard 2 of 5 barcode |
| itf | Interleaved 2 of 5 barcode |
| mtf | Matrix 2 of 5 barcode |
| ip25 | Italian Post 25 barcode |
| iatatf | IATA 2 of 5 barcode. IATA (International Air Transport Assosiation) uses this barcode for the management of air cargo |
| itf14 | ITF14 barcode |
| itf6 | ITF-6 barcode |
| msi | MSI Plessey barcode |
| vin | VIN (Vehicle Identification Number) barcode |
| dpi | Deutschen Post barcode, also known as Identcode, CodeIdentcode, German Postal 2 of 5 Identcode, Deutsche Post AG Identcode, Deutsche Frachtpost Identcode, Deutsche Post AG (DHL) |
| dpl | Deutsche Post Leitcode barcode, also known as German Postal 2 of 5 Leitcode, CodeLeitcode, Leitcode, Deutsche Post AG (DHL) |
| opc | OPC (Optical Product Code) barcode, also known as VCA barcode, VCA OPC, Vision Council of America OPC barcode |
| pzn | PZN barcode, also known as Pharma Zentral Nummer, Pharmazentralnummer |
| code16K | Code 16K barcode |
| pharmacode | Represents Pharmacode barcode, also known as Code32 |
| dm | DataMatrix barcode |
| qr | QR Code barcode |
| aztec | Aztec barcode |
| pdf417 | Pdf417 barcode |
| macroPdf417 | MacroPdf417 barcode |
| dmGS1 | DataMatrix barcode with GS1 string format |
| microPdf417 | MicroPdf417 barcode |
| qrGS1 | QR barcode with GS1 string format |
| maxiCode | MaxiCode barcode |
| dotCode | DotCode barcode |
| ap | Australia Post Customer barcode |
| postnet | Postnet barcode |
| planet | Planet barcode |
| oneCode | USPS OneCode barcode |
| rm4scc | RM4SCC barcode. RM4SCC (Royal Mail 4-state Customer Code) is used for automated mail sort process in UK |
| databarOD | Databar omni-directional barcode |
| databarT | Databar truncated barcode |
| databarL | Databar limited barcode |
| databarE | Databar expanded barcode |
| databarES | Databar expanded stacked barcode |
| databarS | Databar stacked barcode |
| databarSOD | Databar stacked omni-directional barcode |
| sp | Singapore Post barcode |
| ape | Australian Post Domestic eParcel barcode |
| spp | Swiss Post Parcel barcode. Supported types: Domestic Mail, International Mail, Additional Services |
| patchCode | Patch code barcode |
| code32 | Code32 barcode |
| dltf | DataLogic 2 of 5 barcode |
| dkix | Dutch KIX barcode |
| codablockF | Codablock F barcode |
| codablockFGS1 | GS1 Codablock F barcode |
| code128GS1UPCA | GS1-128 AI 8102 Coupon Extended barcode |
| databarGS1UPCA | UPCA & GS1 Databar Coupon barcode |

### Scaling Barcode Symbols

You can scale barcode symbols of dynamically inserted barcode images specifying the scale attribute for a barcode tag as follows.

```csharp
<<barcode [barcode_expression] -barcode_type scale="scaling_hint">>
```

A scale attribute affects the width and height of a 2D barcode symbol and the width of a 1D barcode symbol. The value of a scale attribute represents the percent of barcode symbol scaling.  
The value of a scale attribute, however, is just a hint. That is, actual scaling of a barcode symbol can be not precisely equal to the specified one. The reason is that scaling can damage a barcode symbol in a way it to become unreadable by barcode scanners. That is why, the engine calculates actual scaling not to bring such a damage trying to be as close to the specified scaling as possible at the same time.

### Configuring Initial Scaling of Barcode Symbols

You can affect initial scaling of all barcode symbols generated by a single DocumentAssembler instance through the **DocumentAssembler.BarcodeSettings.BaseXDimension** and **DocumentAssembler.BarcodeSettings.BaseYDimension** properties. These properties define the smallest width and height of the unit of barcode modules respectively. That is, for example, to make all barcode symbols twice larger by default, you can use the following code:

```csharp
DocumentAssembler assembler = new DocumentAssembler();
assembler.BarcodeSettings.BaseXDimension *= 2f;
assembler.BarcodeSettings.BaseYDimension *= 2f;
```

Values of the **DocumentAssembler.BarcodeSettings.BaseXDimension** and **DocumentAssembler.BarcodeSettings.BaseYDimension** properties are measured in units defined by the **DocumentAssembler.BarcodeSettings.GraphicsUnit** property.

{{< alert style="warning" >}}When the scale attribute is provided for a barcode tag, actual x- and y-dimensions are calculated by the engine as the corresponding percent of base x- and y-dimensions.{{< /alert >}}

### Setting Height of 1D Barcode Symbols

The height of a 1D barcode symbol is not affected by the scale attribute of the corresponding barcode tag. However, you can set the height applying the barHeight attribute as follows:

```csharp
<<barcode [barcode_expression] -barcode_type barHeight="height">>
```

The value of a barHeight attribute specifies the percent of the overall barcode image height. That is, for example, to set the height of a barcode symbol equal to two thirds of its overall barcode image height, you can use the following barcode tag:

```csharp
<<barcode ["736192"] -codabar barHeight="67">>
```

### Customizing Fore and Back Colors of Barcode Images

The fore color of a dynamically inserted barcode image is used to render the barcode's symbol and text. This color is derived from the font of the corresponding barcode tag. The background color of the image is derived from the solid fill of the textbox containing the tag.

### Customizing Font and Placement of Barcode Text

The font used to render barcode text of a dynamically inserted barcode image derives the following attributes from the font of the corresponding barcode tag:

*   Name
*   Size
*   Style (bold and italic)
*   Color

The placement of barcode text of a dynamically inserted barcode image – leftward, rightward, or centered – is defined by text alignment of the corresponding barcode tag.

### Using Barcode Text Auto-Correction

For a dynamically inserted barcode image, the engine automatically corrects barcode text that does not conform the barcode's specification, if possible.

{{< alert style="warning" >}}The auto-correction is not possible for barcodes of some types like Databar.{{< /alert >}}

To disable the auto-correction making the engine throw an exception in case of an invalid barcode text, you can set the **DocumentAssembler.BarcodeSettings.UseAutoCorrection** property to false.

### Setting Barcode Image Resolution

You can set horizontal and vertical resolution for dynamically inserted barcode images in DPI (dots per inch) using the **DocumentAssembler.BarcodeSettings.Resolution** property. That is, for example, to set both horizontal and vertical resolution to 300 DPI, you can use the following code:

```csharp
DocumentAssembler assembler = new DocumentAssembler();
assembler.BarcodeSettings.Resolution = 300;
```

{{< alert style="warning" >}}By default, horizontal and vertical resolution of dynamically inserted barcode images is 96 DPI{{< /alert >}}

### Example with Output

```csharp
<<barcode ["736192"] -codabar>>
```

Generated bar code for the above mentioned syntax is:

![](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Screenshots/Barcode.png?raw=true)

---

## Batch Word Document Comparison with Performance Optimization in Node.js

Path: /comparison/nodejs-java/optimize-document-comparison-performance/


{{< alert style="info" >}} 💡For the **complete working code** and detailed explanations, please refer to the [full repository here](https://github.com/groupdocs-comparison/batch-document-comparison-performance).  
This repository contains all source files, helper classes, and configuration examples.{{< /alert >}}


## Overview

This use‑case demonstrates how to perform high‑throughput batch comparison of Word documents (DOCX/DOC) with **GroupDocs.Comparison for Node.js via Java**. It shows how to:

- Discover matching source‑target file pairs.
- Compare documents sequentially or in parallel.
- Apply performance‑tuned `CompareOptions`.
- Monitor progress and generate a summary report.

The approach is ideal for scenarios such as document version control, compliance auditing, or large‑scale content migration where thousands of document pairs must be examined quickly and reliably.

## Prerequisites

- **Node.js** v20 LTS or newer. (`node --version`)
- **Java Runtime / JDK** 8+ (recommended 17 LTS). (`java -version`)
- **JAVA_HOME** environment variable pointing to the JDK installation.
- **GroupDocs.Comparison npm package** (`@groupdocs/groupdocs.comparison`).
- A **temporary or permanent GroupDocs.Comparison license** (place the key in `src/utils/licenseHelper.js`).

## Installation

```bash
# Clone the sample repository (or copy the relevant files into your project)
git clone https://github.com/groupdocs-comparison/batch-document-comparison-performance
cd batch-document-comparison-performance/src

# Install Node.js dependencies
npm install
```

{{< alert style="info" >}}💡 The `package.json` declares the required Node version (`>=20.0.0`) and the GroupDocs.Comparison dependency (`^25.11.0`).{{< /alert >}}

## Repository Structure

```
sample-project/
├─ src/
│  ├─ batchComparison.js          # Core comparison utilities
│  ├─ examples/                 # Ready‑to‑run demos
│  │   ├─ basicBatchComparison.js      # Sequential processing
│  │   ├─ parallelBatchComparison.js   # Parallel processing (configurable concurrency)
│  │   ├─ optimizedBatchComparison.js # Performance‑tuned run
│  │   ├─ batchWithProgress.js        # Progress‑bar demo
│  │   └─ performanceBenchmark.js     # Benchmark sequential vs parallel
│  └─ utils/
│      ├─ fileHelper.js          # File‑system helpers
│      ├─ licenseHelper.js       # License loading
│      ├─ performanceMonitor.js  # Timing & memory helpers
│      └─ constants.js           # Shared constants
├─ sample-files/                # Input Word docs (source/ & target/ subfolders)
├─ output/                      # Generated comparison results
├─ README.md
└─ package.json
```

## Usage Example

The following steps walk you through a **parallel batch comparison** – the fastest strategy for large workloads.

1. **Prepare the input directories**
   - Place matching Word files in `sample-files/source/` and `sample-files/target/`.
   - Filenames must be identical (e.g., `contract_v1.docx` in both folders).

2. **Run the parallel example**

   ```bash
   # Windows (cmd) – the script sets the required Java option
   npm run example:parallel
   ```

   The script executes `src/examples/parallelBatchComparison.js`, which:
   - Calls `findWordPairs` to locate matching pairs.
   - Processes the pairs in batches (default concurrency = 5).
   - Emits a progress line after each batch.
   - Writes comparison results to `output/` as `comparison_<basename>.docx`.

3. **Inspect the generated report**

   After the run completes, a summary is printed to the console. It includes total documents, success rate, total duration, average time per document, and throughput.

   ```text
   ================================================================================
   Batch Comparison Summary
   ================================================================================
   Total Documents:     120
   Successful:          118
   Failed:              2
   Success Rate:        98.33%

   Performance Metrics:
     Total Duration:    42.67s
     Average Duration:   360.42ms per document
     Throughput:        2.76 documents/second
     Concurrency:        5
   ================================================================================
   ```

4. **(Optional) Run the optimized demo**

   If you need the fastest possible run, use the tuned example that disables unnecessary comparison features:

   ```bash
   npm run example:optimized
   ```

   This script supplies a `CompareOptions` object that:
   - Disables style detection when not required.
   - Generates a lightweight summary page only.
   - Sets `sensitivity` to `Medium` for a good speed‑accuracy trade‑off.

{{< alert style="warning" >}}⚠️ **Memory‑Intensive Workloads** – If you encounter `Java heap space` or Node `out of memory` errors, reduce the `concurrency` value in `parallelBatchComparison.js` or launch Node with a larger heap (`node --max-old-space-size=4096`).{{< /alert >}}

## Notes

- **License** – The sample uses a temporary license. Replace the placeholder in `src/utils/licenseHelper.js` with your permanent license string for production use.
- **Java Options** – The npm scripts prepend `JAVA_TOOL_OPTIONS=--enable-native-access=ALL-UNNAMED`. Adjust or remove this flag if your Java version does not require it.
- **Error Handling** – Individual pair failures are logged but do not abort the batch. The summary report lists both successes and failures.
- **Performance Tuning** – Experiment with the `concurrency` variable and `CompareOptions` to find the optimal balance for your hardware and document sizes.

## See Also

-   [Legal Document Comparison API: Automate Contract Review with Node.js](https://blog.groupdocs.com/comparison/legal-document-comparison-api-contract-review-automation-nodejs/)
-   [Optimize Document Comparison Performance: Scale to Millions of Files with Node.js](https://blog.groupdocs.com/comparison/optimize-document-comparison-performance-scale-millions-files-nodejs/)
- [Free Support Forum](https://forum.groupdocs.com/c/comparison/12)
- [GitHub Repository – Full Source Code](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Node.js-via-Java)

---

## Boolean search

Path: /search/java/boolean-search/

This page contains the boolean search definition, a description of all boolean operators used for boolean search, and boolean query examples.

## Boolean search terms

Boolean search is a type of search that allows you to combine queries with boolean operators AND, OR, NOT to create a boolean query and further obtain more relevant results. For example, a boolean query might be "Albert AND Einstein". This will limit the search results to only documents that contain both words.

## Operator AND

The AND operator allows you to find only those documents that are found for each nested search query separately. The following example demonstrates the use of the AND operator in text and object form queries. The queries search for documents in the text of which there are both words "theory" and "relativity".



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.search("theory AND relativity");
 
// Search with object query
SearchQuery wordQuery1 = SearchQuery.createWordQuery("theory");
SearchQuery wordQuery2 = SearchQuery.createWordQuery("relativity");
SearchQuery andQuery = SearchQuery.createAndQuery(wordQuery1, wordQuery2);
SearchResult result2 = index.search(andQuery);
```

## Operator OR

The OR operator allows you to find all the documents that are found for at least one nested search query. The example demonstrates the use of the OR operator in text and object form queries. The queries search for documents in the text of which there is at least one of the words "Einstein" and "relativity".



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.search("Einstein OR relativity");
 
// Search with object query
SearchQuery wordQuery1 = SearchQuery.createWordQuery("Einstein");
SearchQuery wordQuery2 = SearchQuery.createWordQuery("relativity");
SearchQuery orQuery = SearchQuery.createOrQuery(wordQuery1, wordQuery2);
SearchResult result2 = index.search(orQuery);
```

## Operator NOT

The NOT operator allows you to invert the result of a nested search query and find all documents in which for the nested search query are found no occurrences. The example demonstrates the use of the NOT operator in text and object form queries. The queries search for documents in the text of which the word "relativity" is presented but the word "Einstein" is not.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.search("relativity AND NOT Einstein");
 
// Search with object query
SearchQuery wordQuery1 = SearchQuery.createWordQuery("relativity");
SearchQuery wordQuery2 = SearchQuery.createWordQuery("Einstein");
SearchQuery notQuery = SearchQuery.createNotQuery(wordQuery2);
SearchQuery andQuery = SearchQuery.createAndQuery(wordQuery1, notQuery);
SearchResult result2 = index.search(andQuery);
```

## Complex queries

Boolean search operators can be combined using parentheses. The example below shows how to use parentheses to construct complex boolean search queries. In the example the query is presented in text and object form and searches for documents containing the words "theory" and "relativity" and not containing the words "Einstein" and "Albert".



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.search("(theory AND relativity) AND NOT (Einstein OR Albert)");
 
// Search with object query
SearchQuery theoryWordQuery = SearchQuery.createWordQuery("theory");
SearchQuery relativityWordQuery = SearchQuery.createWordQuery("relativity");
SearchQuery andQuery = SearchQuery.createAndQuery(theoryWordQuery, relativityWordQuery);
 
SearchQuery einsteinWordQuery = SearchQuery.createWordQuery("Einstein");
SearchQuery albertWordQuery = SearchQuery.createWordQuery("Albert");
SearchQuery orQuery = SearchQuery.createOrQuery(einsteinWordQuery, albertWordQuery);
SearchQuery notQuery = SearchQuery.createNotQuery(orQuery);
 
SearchQuery rootQuery = SearchQuery.createAndQuery(andQuery, notQuery);
SearchResult result2 = index.search(rootQuery);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Boolean search

Path: /search/net/boolean-search/

This page contains the boolean search definition, a description of all boolean operators used for boolean search, and boolean query examples.

## Boolean search terms

Boolean search is a type of search that allows you to combine queries with boolean operators AND, OR, NOT to create a boolean query and further obtain more relevant results. For example, a boolean query might be "Albert AND Einstein". This will limit the search results to only documents that contain both words.

## Operator AND

The AND operator allows you to find only those documents that are found for each nested search query separately. The following example demonstrates the use of the AND operator in text and object form queries. The queries search for documents in the text of which there are both words "theory" and "relativity".

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.Search("theory AND relativity");
 
// Search with object query
SearchQuery wordQuery1 = SearchQuery.CreateWordQuery("theory");
SearchQuery wordQuery2 = SearchQuery.CreateWordQuery("relativity");
SearchQuery andQuery = SearchQuery.CreateAndQuery(wordQuery1, wordQuery2);
SearchResult result2 = index.Search(andQuery);
```

## Operator OR

The OR operator allows you to find all the documents that are found for at least one nested search query. The example demonstrates the use of the OR operator in text and object form queries. The queries search for documents in the text of which there is at least one of the words "Einstein" and "relativity".

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.Search("Einstein OR relativity");
 
// Search with object query
SearchQuery wordQuery1 = SearchQuery.CreateWordQuery("Einstein");
SearchQuery wordQuery2 = SearchQuery.CreateWordQuery("relativity");
SearchQuery orQuery = SearchQuery.CreateOrQuery(wordQuery1, wordQuery2);
SearchResult result2 = index.Search(orQuery);
```

## Operator NOT

The NOT operator allows you to invert the result of a nested search query and find all documents in which for the nested search query are found no occurrences. The example demonstrates the use of the NOT operator in text and object form queries. The queries search for documents in the text of which the word "relativity" is presented but the word "Einstein" is not.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.Search("relativity AND NOT Einstein");
 
// Search with object query
SearchQuery wordQuery1 = SearchQuery.CreateWordQuery("relativity");
SearchQuery wordQuery2 = SearchQuery.CreateWordQuery("Einstein");
SearchQuery notQuery = SearchQuery.CreateNotQuery(wordQuery2);
SearchQuery andQuery = SearchQuery.CreateAndQuery(wordQuery1, notQuery);
SearchResult result2 = index.Search(andQuery);
```

## Complex queries

Boolean search operators can be combined using parentheses. The example below shows how to use parentheses to construct complex boolean search queries. In the example the query is presented in text and object form and searches for documents containing the words "theory" and "relativity" and not containing the words "Einstein" and "Albert".

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.Search("(theory AND relativity) AND NOT (Einstein OR Albert)");
 
// Search with object query
SearchQuery theoryWordQuery = SearchQuery.CreateWordQuery("theory");
SearchQuery relativityWordQuery = SearchQuery.CreateWordQuery("relativity");
SearchQuery andQuery = SearchQuery.CreateAndQuery(theoryWordQuery, relativityWordQuery);
 
SearchQuery einsteinWordQuery = SearchQuery.CreateWordQuery("Einstein");
SearchQuery albertWordQuery = SearchQuery.CreateWordQuery("Albert");
SearchQuery orQuery = SearchQuery.CreateOrQuery(einsteinWordQuery, albertWordQuery);
SearchQuery notQuery = SearchQuery.CreateNotQuery(orQuery);
 
SearchQuery rootQuery = SearchQuery.CreateAndQuery(andQuery, notQuery);
SearchResult result2 = index.Search(rootQuery);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Boolean search

Path: /search/nodejs-java/boolean-search/

This page contains the boolean search definition, a description of all boolean operators used for boolean search, and boolean query examples.

## Boolean search terms

Boolean search is a type of search that allows you to combine queries with boolean operators AND, OR, NOT to create a boolean query and further obtain more relevant results. For example, a boolean query might be "Albert AND Einstein". This will limit the search results to only documents that contain both words.

## Operator AND

The AND operator allows you to find only those documents that are found for each nested search query separately. The following example demonstrates the use of the AND operator in text and object form queries. The queries search for documents in the text of which there are both words "theory" and "relativity".

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search with text query
const query1 = 'theory AND relativity';
const result1 = index.search(query1);

// Search with object query
const wordQuery1 = groupdocs.search.SearchQuery.createWordQuery('theory');
const wordQuery2 = groupdocs.search.SearchQuery.createWordQuery('relativity');
const andQuery = groupdocs.search.SearchQuery.createAndQuery(wordQuery1, wordQuery2);
const result2 = index.search(andQuery);
```

## Operator OR

The OR operator allows you to find all the documents that are found for at least one nested search query. The example demonstrates the use of the OR operator in text and object form queries. The queries search for documents in the text of which there is at least one of the words "Einstein" and "relativity".

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search with text query
const query1 = 'Einstein OR relativity';
const result1 = index.search(query1);

// Search with object query
const wordQuery1 = groupdocs.search.SearchQuery.createWordQuery('Einstein');
const wordQuery2 = groupdocs.search.SearchQuery.createWordQuery('relativity');
const orQuery = groupdocs.search.SearchQuery.createOrQuery(wordQuery1, wordQuery2);
const result2 = index.search(orQuery);
```

## Operator NOT

The NOT operator allows you to invert the result of a nested search query and find all documents in which for the nested search query are found no occurrences. The example demonstrates the use of the NOT operator in text and object form queries. The queries search for documents in the text of which the word "relativity" is presented but the word "Einstein" is not.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search with text query
const query1 = 'relativity AND NOT Einstein';
const result1 = index.search(query1);

// Search with object query
const wordQuery1 = groupdocs.search.SearchQuery.createWordQuery('relativity');
const wordQuery2 = groupdocs.search.SearchQuery.createWordQuery('Einstein');
const notQuery = groupdocs.search.SearchQuery.createNotQuery(wordQuery2);
const andQuery = groupdocs.search.SearchQuery.createAndQuery(wordQuery1, notQuery);
const result2 = index.search(andQuery);
```

## Complex queries

Boolean search operators can be combined using parentheses. The example below shows how to use parentheses to construct complex boolean search queries. In the example the query is presented in text and object form and searches for documents containing the words "theory" and "relativity" and not containing the words "Einstein" and "Albert".

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search with text query
const query1 = '(sportsman AND favourable) AND NOT (Kynynmound OR Murray)';
const result1 = index.search(query1);

// Search with object query
const word1Query = groupdocs.search.SearchQuery.createWordQuery('sportsman');
const word2Query = groupdocs.search.SearchQuery.createWordQuery('favourable');
const andQuery = groupdocs.search.SearchQuery.createAndQuery(word1Query, word2Query);

const word3Query = groupdocs.search.SearchQuery.createWordQuery('Kynynmound');
const word4Query = groupdocs.search.SearchQuery.createWordQuery('Murray');
const orQuery = groupdocs.search.SearchQuery.createOrQuery(word3Query, word4Query);
const notQuery = groupdocs.search.SearchQuery.createNotQuery(orQuery);

const rootQuery = groupdocs.search.SearchQuery.createAndQuery(andQuery, notQuery);
const result2 = index.search(rootQuery);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Bubble Chart in Word Processing Document

Path: /assembly/java/bubble-chart-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bubble Chart report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bubble Chart in Microsoft Word Document

### Creating a Bubble Chart

Please follow below steps to create bubble chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "X Y(Scatter)" in the sidebar, you will see a gallery of charts.
3.  Select the "Bubble" and press "OK" to insert the chart and Worksheet template to your document.
4.  Right click chart and select 'Edit Data' to provide chart data. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/bubble-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   Retrieve total Contract Prices by Months.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>><<x [key + 1]>>
```

#### Chart Data (Excel)

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" width="623" style="width: 467.5pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">X-Values</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Total Contract Price&lt;&lt;y [sum(c =&gt; c.getPrice())]&gt;&gt;&lt;&lt;size[count()]&gt;&gt;</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Size</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.7</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.7</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">10</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.2</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.6</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.8</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">8</span></p></td></tr></tbody></table>
### Download Bubble Chart Template

Please download the sample Bubble Chart document we created in this article:

*   [Bubble Chart.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Bubble%20Chart.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 25ca4f457bde680504eb2c9cfbb2b8db >}}

## Bubble Chart in OpenOffice Document

To be investigated.

---

## Bubble Chart in Word Processing Document

Path: /assembly/net/bubble-chart-in-word-processing-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bubble Chart in Microsoft Word Document

### Creating a Bubble Chart

Please follow below steps to create a bubble chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "X Y(Scatter)" in the sidebar, you will see a gallery of charts.
3.  Select the "Bubble" and press "OK" to insert the chart and Worksheet template to your document.
4.  Right click the chart and select 'Edit Data' to provide chart data. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/bubble-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   A report must show variation in the sales/orders prices.
*   It must show which sale/order lie in which month.
*   A report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Orders Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>><<x [Key]>>
```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">X-Values</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total orders by months&lt;&lt;y [Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;size [Count()]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Size</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">0.7</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">2.7</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">10</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">4</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">2.6</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">0.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">8</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bubble Chart Template

Please download the sample Bubble Chart document we created in this article:

*   [Bubble Chart.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Bubble%20Chart.docx?raw=true) (Template for CustomObject and JSON examples) 
*   [Bubble Chart\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Bubble%20Chart_DB.docx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 9e78f4c0567a542c595a0027fd3aed6e >}}



#### Database Entities

{{< gist GroupDocsGists 039535cb95e1970a920ff6ac122460dd >}}



#### Using DataSet

{{< gist GroupDocsGists 3b515503bba9c85164ecc49650c400f3 >}}



#### Using XML DataSource

{{< gist GroupDocsGists d4d5bafbcffd75cae091fd2334e1f388 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists e4a019cd106e563c0391aa7c2d0f4e78 >}}



## Bubble Chart in OpenOffice Document

To be investigated.

---

## Build your first search solution

Path: /search/java/build-your-first-search-solution/

This brief guide describes the basic steps for creating your first search index.

## Step #1: Create new index

First of all you need to create an index. An index can be created in memory or on disk. An index created in memory cannot be saved after exiting your program. In contrast, an index created on disk may be loaded in the future to continue working. Details on creating an index are described in the section [Creating an index]({{< ref "search/java/developer-guide/advanced-usage/creating-an-index/_index.md" >}}). The following example shows how to create an index on disk.



```java
String indexFolder = "c:\\MyIndex\\"; // Specify the path to the index folder
Index index = new Index(indexFolder);
```

## Step #2: Open existing index

To continue working with a previously created index, it must be loaded. Each constructor of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class by default loads the index, if it exists at the specified path. And only an explicit indication causes an index to be overwritten. The following example shows how to load an existing index.



```java
String indexFolder = "c:\\MyIndex\\"; // Specify the path to the index folder
Index index = new Index(indexFolder);
```

## Step #3: Subscribe to index events

After creating an index, you need to add documents to the index for indexing. Indexing documents can be successful or unsuccessful for various reasons, for example, due to read errors from the disk or the presence of a password to access a document. To receive information about indexing errors, you can subscribe to the ErrorOccurred event. To work with events, see the section [Search index events]({{< ref "search/java/developer-guide/advanced-usage/creating-an-index/search-index-events.md" >}}). The following example shows how to subscribe to the ErrorOccurred event.



```java
index.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
    public void invoke(Object sender, IndexErrorEventArgs args) {
        System.out.println(args.getMessage()); // Writing error messages to the console
    }
});
```

## Step #4: Add files synchronously

Document indexing can be performed synchronously or asynchronously. Synchronous indexing means that a thread that started the indexing process will be busy until the operation is completed. The following example shows how to perform indexing synchronously.



```java
String indexFolder = "c:\\MyIndex\\"; // Specify path to the index folder
String documentsFolder = "c:\\MyDocuments\\"; // Specify the path to a folder containing documents to search
 
Index index = new Index(indexFolder); // Creating an index in the specified folder
 
index.add(documentsFolder); // Synchronous indexing documents from the specified folder
```

## Step #5: Add files asynchronously

More often, however, it is necessary to perform indexing asynchronously, with the ability to execute other tasks in the thread that launched the operation. A detailed description of all aspects of the indexing process is provided in the section [Indexing]({{< ref "search/java/developer-guide/advanced-usage/indexing/_index.md" >}}). The following example shows how to perform indexing asynchronously.



```java
String indexFolder = "c:\\MyIndex\\"; // Specify path to the index folder
String documentsFolder = "c:\\MyDocuments\\"; // Specify the path to a folder containing documents to search
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().StatusChanged.add(new EventHandler<BaseIndexEventArgs>() {
    public void invoke(Object sender, BaseIndexEventArgs args) {
        if (args.getStatus() != IndexStatus.InProgress) {
            // A notification of the operation completion should be here
        }
    }
});
 
// Setting the flag for asynchronous indexing
IndexingOptions options = new IndexingOptions();
options.setAsync(true);
 
// Asynchronous indexing documents from the specified folder
// The current method terminates before the operation completes
index.add(documentsFolder, options);
```

## Step #6: Perform search

When documents are indexed, the index is ready to handle search queries. The following types of search queries are supported: simple, fuzzy, case sensitive, boolean, phrasal, faceted, with wildcards, and others. Description of search queries of various types is presented in the section [Searching]({{< ref "search/java/developer-guide/advanced-usage/searching/_index.md" >}}). The example below shows how to perform simple search in an index.



```java
String query = "Einstein"; // Specify a search query
SearchResult result = index.search(query); // Searching in the index
```

## Step #7: Use search results

When a search is completed, you need to somehow interpret a result. The result can be represented by a simple list of documents found, or the words and phrases found can be highlighted in the text of the document. For more information on processing search results, see [Search results]({{< ref "search/java/developer-guide/advanced-usage/searching/search-results.md" >}}). The example below shows how to list found documents in the console.



```java
// Search in index
SearchResult result = index.search(query);
 
// Printing the result
System.out.println("Documents found: " + result.getDocumentCount());
System.out.println("Total occurrences found: " + result.getOccurrenceCount());
for (int i = 0; i < result.getDocumentCount(); i++) {
    FoundDocument document = result.getFoundDocument(i);
    System.out.println("\tDocument: " + document.getDocumentInfo().getFilePath());
    System.out.println("\tOccurrences: " + document.getOccurrenceCount());
}
```

The following example shows how to highlight search results in the text of a document. Detailed information on how to highlight search results is described in the section [Highlighting search results]({{< ref "search/java/developer-guide/advanced-usage/searching/highlighting-search-results.md" >}}).



```java
SearchResult result = index.search(query); // Search in the index
if (result.getDocumentCount() > 0)
{
    FoundDocument document = result.getFoundDocument(0); // Getting the first found document
    OutputAdapter outputAdapter = new FileOutputAdapter("c:\\Highlighted.html"); // Creating the output adapter to a file
    HtmlHighlighter highlighter = new HtmlHighlighter(outputAdapter); // Creating the highlighter object
    index.highlight(document, highlighter); // Generating output HTML formatted document with highlighted search results
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Build your first search solution

Path: /search/net/build-your-first-search-solution/

This brief guide describes the basic steps for creating your first search index.

## Step #1: Create new index

First of all you need to create an index. An index can be created in memory or on disk. An index created in memory cannot be saved after exiting your program. In contrast, an index created on disk may be loaded in the future to continue working. Details on creating an index are described in the section [Creating an index]({{< ref "search/net/developer-guide/advanced-usage/creating-an-index/_index.md" >}}). The following example shows how to create an index on disk.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\"; // Specify the path to the index folder
Index index = new Index(indexFolder);
```

## Step #2: Open existing index

To continue working with a previously created index, it must be loaded. Each constructor of the **[Index](https://reference.groupdocs.com/net/search/groupdocs.search/index)** class by default loads the index, if it exists at the specified path. And only an explicit indication causes an index to be overwritten. The following example shows how to load an existing index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\"; // Specify the path to the index folder
Index index = new Index(indexFolder);
```

## Step #3: Subscribe to index events

After creating an index, you need to add documents to the index for indexing. Indexing documents can be successful or unsuccessful for various reasons, for example, due to read errors from the disk or the presence of a password to access a document. To receive information about indexing errors, you can subscribe to the ErrorOccurred event. To work with events, see the section [Search index events]({{< ref "search/net/developer-guide/advanced-usage/creating-an-index/search-index-events.md" >}}). The following example shows how to subscribe to the ErrorOccurred event.

**C#**

```csharp
index.Events.ErrorOccurred += (sender, args) =>
{
    Console.WriteLine(args.Message); // Writing error messages to the console
};
```

## Step #4: Add files synchronously

Document indexing can be performed synchronously or asynchronously. Synchronous indexing means that a thread that started the indexing process will be busy until the operation is completed. The following example shows how to perform indexing synchronously.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\"; // Specify path to the index folder
string documentsFolder = @"c:\MyDocuments\"; // Specify the path to a folder containing documents to search
 
Index index = new Index(indexFolder); // Creating an index in the specified folder
 
index.Add(documentsFolder); // Synchronous indexing documents from the specified folder
```

## Step #5: Add files asynchronously

More often, however, it is necessary to perform indexing asynchronously, with the ability to execute other tasks in the thread that launched the operation. A detailed description of all aspects of the indexing process is provided in the section [Indexing]({{< ref "search/net/developer-guide/advanced-usage/indexing/_index.md" >}}). The following example shows how to perform indexing asynchronously.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\"; // Specify path to the index folder
string documentsFolder = @"c:\MyDocuments\"; // Specify the path to a folder containing documents to search
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.StatusChanged += (sender, args) =>
{
    if (args.Status != IndexStatus.InProgress)
    {
        // There should be a code indicating the completion of the operation
    }
};
 
// Setting the flag for asynchronous indexing
IndexingOptions options = new IndexingOptions();
options.IsAsync = true;
 
// Asynchronous indexing documents from the specified folder
// The current method terminates before the operation completes
index.Add(documentsFolder, options);
```

## Step #6: Perform search

When documents are indexed, the index is ready to handle search queries. The following types of search queries are supported: simple, fuzzy, case sensitive, boolean, phrasal, faceted, with wildcards, and others. Description of search queries of various types is presented in the section [Searching]({{< ref "search/net/developer-guide/advanced-usage/searching/_index.md" >}}). The example below shows how to perform simple search in an index.

**C#**

```csharp
string query = "Einstein"; // Specify a search query
SearchResult result = index.Search(query); // Searching in the index
```

## Step #7: Use search results

When a search is completed, you need to somehow interpret a result. The result can be represented by a simple list of documents found, or the words and phrases found can be highlighted in the text of the document. For more information on processing search results, see [Search results]({{< ref "search/net/developer-guide/advanced-usage/searching/search-results.md" >}}). The example below shows how to list found documents in the console.

**C#**

```csharp
// Search in index
SearchResult result = index.Search(query);
 
// Printing the result
Console.WriteLine("Documents found: " + result.DocumentCount);
Console.WriteLine("Total occurrences found: " + result.OccurrenceCount);
for (int i = 0; i < result.DocumentCount; i++)
{
    FoundDocument document = result.GetFoundDocument(i);
    Console.WriteLine("\tDocument: " + document.DocumentInfo.FilePath);
    Console.WriteLine("\tOccurrences: " + document.OccurrenceCount);
}
```

The following example shows how to highlight search results in the text of a document. Detailed information on how to highlight search results is described in the section [Highlighting search results]({{< ref "search/net/developer-guide/advanced-usage/searching/highlighting-search-results.md" >}}).

**C#**

```csharp
SearchResult result = index.Search(query, options); // Search in the index
if (result.DocumentCount > 0)
{
    FoundDocument document = result.GetFoundDocument(0); // Getting the first found document
    OutputAdapter outputAdapter = new FileOutputAdapter(@"c:\Highlighted.html"); // Creating the output adapter to a file
    HtmlHighlighter highlighter = new HtmlHighlighter(outputAdapter); // Creating the highlighter object
    index.Highlight(document, highlighter); // Generating output HTML formatted document with highlighted search results
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Build your first search solution

Path: /search/nodejs-java/build-your-first-search-solution/

This brief guide describes the basic steps for creating your first search index.

## Step #1: Create new index

First of all you need to create an index. An index can be created in memory or on disk. An index created in memory cannot be saved after exiting your program. In contrast, an index created on disk may be loaded in the future to continue working. Details on creating an index are described in the section [Creating an index]({{< ref "search/nodejs-java/developer-guide/advanced-usage/creating-an-index/_index.md" >}}). The following example shows how to create an index on disk.

```javascript
const indexFolder = 'c:/MyIndex/'; // Specify the path to the index folder
const index = new groupdocs.search.Index(indexFolder);
```

## Step #2: Open existing index

To continue working with a previously created index, it must be loaded. Each constructor of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class by default loads the index, if it exists at the specified path. And only an explicit indication causes an index to be overwritten. The following example shows how to load an existing index.

```javascript
const indexFolder = 'c:/MyIndex/'; // Specify the path to the index folder
const index = new groupdocs.search.Index(indexFolder);
```

## Step #3: Subscribe to index events

After creating an index, you need to add documents to the index for indexing. Indexing documents can be successful or unsuccessful for various reasons, for example, due to read errors from the disk or the presence of a password to access a document. To receive information about indexing errors, you can subscribe to the ErrorOccurred event. To work with events, see the section [Search index events]({{< ref "search/nodejs-java/developer-guide/advanced-usage/creating-an-index/search-index-events.md" >}}). The following example shows how to subscribe to the ErrorOccurred event.

```javascript
const eventHandler = java.newProxy('com.groupdocs.search.events.EventHandler', {
  invoke: function (sender, args) {
    console.log(args.getMessage()); // Writing error messages to the console
  },
});
index.getEvents().ErrorOccurred.add(eventHandler);
```

## Step #4: Add files synchronously

Document indexing can be performed synchronously or asynchronously. Synchronous indexing means that a thread that started the indexing process will be busy until the operation is completed. The following example shows how to perform indexing synchronously.

```javascript
const indexFolder = 'c:/MyIndex/'; // Specify path to the index folder
const documentsFolder = 'c:/MyDocuments/'; // Specify the path to a folder containing documents to search

const index = new groupdocs.search.Index(indexFolder); // Creating an index in the specified folder

index.add(documentsFolder); // Synchronous indexing documents from the specified folder
```

## Step #5: Add files asynchronously

More often, however, it is necessary to perform indexing asynchronously, with the ability to execute other tasks in the thread that launched the operation. A detailed description of all aspects of the indexing process is provided in the section [Indexing]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/_index.md" >}}). The following example shows how to perform indexing asynchronously.

```javascript
const indexFolder = 'c:/MyIndex/'; // Specify path to the index folder
const documentsFolder = 'c:/MyDocuments/'; // Specify the path to a folder containing documents to search
 
// Creating an index
const index = new groupdocs.search.Index(indexFolder);
 
// Subscribing to the event
const statusChangedHandler = java.newProxy('com.groupdocs.search.events.EventHandler', {
  invoke: function (sender, args) {
    console.log('Status changed: ' + args.getStatus());
    if (
      String(args.getStatus()) == String(groupdocs.search.IndexStatus.Ready) ||
      String(args.getStatus()) == String(groupdocs.search.IndexStatus.Failed)
    ) {
      // There should be a code indicating the completion of the operation
      console.log('Indexing completed.');
    }
  },
});
index.getEvents().StatusChanged.add(statusChangedHandler);
 
// Setting the flag for asynchronous indexing
const options = new groupdocs.search.IndexingOptions();
options.setAsync(true);
 
// Asynchronous indexing documents from the specified folder
// The current method terminates before the operation completes
index.add(documentsFolder, options);
```

## Step #6: Perform search

When documents are indexed, the index is ready to handle search queries. The following types of search queries are supported: simple, fuzzy, case sensitive, boolean, phrasal, faceted, with wildcards, and others. Description of search queries of various types is presented in the section [Searching]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/_index.md" >}}). The example below shows how to perform simple search in an index.

```javascript
const query = 'Einstein'; // Specify a search query
const result = index.search(query); // Searching in the index
```

## Step #7: Use search results

When a search is completed, you need to somehow interpret a result. The result can be represented by a simple list of documents found, or the words and phrases found can be highlighted in the text of the document. For more information on processing search results, see [Search results]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-results.md" >}}). The example below shows how to list found documents in the console.

```javascript
// Search in the index
const result = index.search(query);
 
// Printing the result
console.log('Documents found: ' + result.getDocumentCount());
console.log('Total occurrences found: ' + result.getOccurrenceCount());
for (let i = 0; i < result.getDocumentCount(); i++) {
  const document = result.getFoundDocument(i);
  console.log('\tDocument: ' + document.getDocumentInfo().getFilePath());
  console.log('\tOccurrences: ' + document.getOccurrenceCount());
}
```

The following example shows how to highlight search results in the text of a document. Detailed information on how to highlight search results is described in the section [Highlighting search results]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/highlighting-search-results.md" >}}).

```javascript
const result = index.search(query); // Search in the index
if (result.getDocumentCount() > 0) {
  const document = result.getFoundDocument(0); // Getting the first found document
  const filePath = Utils.OutputPath + 'BasicUsage/Highlighted.html';
  const outputAdapter = new groupdocs.search.FileOutputAdapter(groupdocs.search.OutputFormat.Html, filePath); // Creating the output adapter to a file
  const highlighter = new groupdocs.search.DocumentHighlighter(outputAdapter); // Creating the highlighter object
  index.highlight(document, highlighter); // Generating output HTML formatted document with highlighted search results
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Bulleted List in Word Processing Document

Path: /assembly/java/bulleted-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bulleted List in Microsoft Word Document

### Creating a Bulleted List

Practising the following steps you can insert Bulleted List in MS Word 2013.

1.  Add a bullet list at the place where you want it.
2.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must show all the clients in a bulleted list format.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**Template Syntax**

```java
We provide support for the following clients:
•<<foreach [in getClients()]>><<[getName()]>>
<</foreach>>
```

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Bulleted%20List.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 0d492aa10208d139d02c698495c6ae63 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Bulleted List in Word Processing Document

Path: /assembly/net/bulleted-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bulleted List in Microsoft Word Document

### Creating a Bulleted List

Practising the following steps you can insert Bulleted List in MS Word 2013.

1.  Add a bullet list at the place where you want it.
2.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share the information of the products with the following key requirements:

*   Report must show all the products in a bulleted list format.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**Template Syntax**

```csharp
We provide support for the following products:
. <<foreach [in products]>><<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Bulleted%20List.docx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Bulleted List\_XML.docx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Bulleted%20List_XML.docx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 9b55cff16b005121e40cc9080920821a >}}



#### Database Entities

{{< gist GroupDocsGists 28411995912ff7684a0dce651dcb5f09 >}}



#### Using DataSet

{{< gist GroupDocsGists 73097d50587221a303300a8355f4608f >}}



#### Using XML DataSource

{{< gist GroupDocsGists 17d59b45b1d6056076533e12f2b4008e >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 2a3c9f8c8ed6f9ce9e1e686ff7245078 >}}



## Bulleted List in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Bulleted List' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Bulleted List\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Bulleted%20List_OpenDocument.odt?raw=true) (use same template for database, dataset and JSON examples)
*   [Bulleted List\_XML\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Bulleted%20List_XML_OpenDocument.odt?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 97560bb8f4b8d87296065dbc1297b21e >}}



#### Database Entities

{{< gist GroupDocsGists a29cba37db08cbb72fc17e55d8af9597 >}}



#### Using DataSet

{{< gist GroupDocsGists 96f83f5c5af219b723240fb4aa1ffd50 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 9c2371892822f0ac46cf7ad61e16fa14 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 9b056e349187d03f4c6d8f1aab80c6a0 >}}



### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Business Case of a Shopping Store

Path: /assembly/net/business-case-of-a-shopping-store/

{{< alert style="info" >}}This business case has been conceived for the demonstration purpose and serves well for a typical shopping store. There may be simpler or complex scenarios in real life businesses.{{< /alert >}}

## Business Case

1.  There are many customers of the shopping store.
2.  The store offers multiple products.
3.  A customer may place multiple orders.
4.  An order may have many products.
5.  The data may or may not be stored in a database system.

## Reporting Requirements

1.  A report based on some criteria is to be generated.
2.  The report can be in any of the formats: Documents, Spreadsheets, Presentations.
3.  The report developer must be able to define templates and then generate reports.

## Business Objects

### Custom Objects

Here are our customer objects:

{{< gist GroupDocsGists cd8768711ff88414192c3f50a9b7c918 >}}



### Database Entities

![](https://raw.githubusercontent.com/groupdocsassembly/GroupDocs_Assembly_NET/master/Examples/Data/Data%20Sources/Database%20Backup/database.PNG)

## Templates Location

There is a fixed location of templates somewhere /Date/Source/. The report developer may create any number of templates and can create sub directories under /Data/Source/ in order to organize the templates as per convenience.

## Reports Location

The reports can be placed anywhere under directory /Data/Destination/. The report developer can create sub directories and give name to the output reports as per convenience.

---

## Business Case of Manager-Client Contract System

Path: /assembly/java/business-case-of-manager-client-contract-system/

{{< alert style="info" >}}This business case has been conceived for the demonstration purpose and serves well for a typical manager-client system. There may be simpler or complex scenarios in real life businesses.{{< /alert >}}

## Business Case

1.  There are many managers offering their services.
2.  There are multiple clients in the market.
3.  A manager can sign multiple contracts and start working.
4.  A contract may contain multiple clients.
5.  The data is fetched from custom objects and report is generated.

## Reporting Requirements

1.  A report based on some criteria is to be generated.
2.  The report can be in any of the formats: Documents, Spreadsheets, Presentations.
3.  The report developer must be able to define templates and then generate reports.

## Business Objects

### Custom Objects

Here are our customer objects:

{{< gist GroupDocsGists ffcdf1d202f0e706b98796c722e438e3 >}}



## Templates Location

There is a fixed location of templates somewhere /Date/Source/. The report developer may create any number of templates and can create sub directories under /Data/Source/ in order to organize the templates as per convenience.

## Reports Location

The reports can be placed anywhere under directory /Data/Destination/. The report developer can create sub directories and give name to the output reports as per convenience.

---

## Character replacement during indexing

Path: /search/java/character-replacement-during-indexing/

Character replacement during indexing can be used, for example, to convert all text to lowercase characters or to remove diacritics from text. Such replacements can reduce the size of an index on disk if the case of characters or diacritics are not significant. See also [Character replacements]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/character-replacements.md" >}}) page in the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The example below demonstrates how to configure and use character replacements during indexing.



```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";
 
// Enabling character replacements in the index settings
IndexSettings settings = new IndexSettings();
settings.setUseCharacterReplacements(true);
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Configuring character replacements
// Deleting all existing character replacements from the dictionary
index.getDictionaries().getCharacterReplacements().clear();
// Creating new character replacements
CharacterReplacementPair[] characterReplacements = new CharacterReplacementPair[Character.MAX_VALUE + 1];
for (int i = 0; i < characterReplacements.length; i++)
{
    char character = (char)i;
    char replacement = Character.toLowerCase(character);
    characterReplacements[i] = new CharacterReplacementPair(character, replacement);
}
// Adding character replacements to the dictionary
index.getDictionaries().getCharacterReplacements().addRange(characterReplacements);
 
// Indexing documents from the specified folder
index.add(documentFolder);
 
// Searching in the index
// Case-sensitive search is no longer possible for this index, since all characters are lowercase
// By default, case-insensitive search is performed
SearchResult result = index.search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Character replacement during indexing

Path: /search/nodejs-java/character-replacement-during-indexing/

Character replacement during indexing can be used, for example, to convert all text to lowercase characters or to remove diacritics from text. Such replacements can reduce the size of an index on disk if the case of characters or diacritics are not significant. See also [Character replacements]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/character-replacements.md" >}}) page in the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The example below demonstrates how to configure and use character replacements during indexing.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Enabling character replacements in the index settings
const settings = new groupdocs.search.IndexSettings();
settings.setUseCharacterReplacements(true);

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Configuring character replacements
// Deleting all existing character replacements from the dictionary
index.getDictionaries().getCharacterReplacements().clear();
// Creating new character replacements
const count = 65536;
const array = new Array(count);
for (let i = 0; i < count; i++) {
  const text = String.fromCharCode(i);
  const character = java.newChar(text);
  const replacement = java.newChar(text.toLowerCase()[0]);
  array[i] = new groupdocs.search.CharacterReplacementPair(character, replacement);
}
const characterReplacements = java.newArray('com.groupdocs.search.dictionaries.CharacterReplacementPair', array);
// Adding character replacements to the dictionary
index.getDictionaries().getCharacterReplacements().addRange(characterReplacements);

// Indexing documents from the specified folder
index.add(documentFolder);

// Searching in the index
// Case-sensitive search is no longer possible for this index, since all characters are lowercase
// By default, case-insensitive search is performed
const query = 'Einstein';
const options = new groupdocs.search.SearchOptions();
options.setUseCaseSensitiveSearch(true);
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Character replacement during Indexing

Path: /search/net/character-replacement-during-indexing/

Character replacement during indexing can be used, for example, to convert all text to lowercase characters or to remove diacritics from text. Such replacements can reduce the size of an index on disk if the case of characters or diacritics are not significant. See also [Character replacements]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/character-replacements.md" >}}) page in the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The example below demonstrates how to configure and use character replacements during indexing.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Enabling character replacements in the index settings
IndexSettings settings = new IndexSettings();
settings.UseCharacterReplacements = true;
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Configuring character replacements
// Deleting all existing character replacements from the dictionary
index.Dictionaries.CharacterReplacements.Clear();
// Creating new character replacements
CharacterReplacementPair[] characterReplacements = new CharacterReplacementPair[Char.MaxValue + 1];
for (int i = 0; i < characterReplacements.Length; i++)
{
    char character = (char)i;
    char replacement = Char.ToLower(character);
    characterReplacements[i] = new CharacterReplacementPair(character, replacement);
}
// Adding character replacements to the dictionary
index.Dictionaries.CharacterReplacements.AddRange(characterReplacements);
 
// Indexing documents from the specified folder
index.Add(documentFolder);
 
// Searching in the index
// Case-sensitive search is no longer possible for this index, since all characters are lowercase
// By default, case-insensitive search is performed
SearchResult result = index.Search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Chart Series Coloring in Word Processing Document

Path: /assembly/java/chart-series-coloring-in-word-processing-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Word Processing Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
2.  Select "Column" in the sidebar, you will see a gallery of charts
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/chart-series-coloring-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine)
5.  Save your Document

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The Report must be generated in the Word Processing Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Chart Data (Excel)

|   | Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>> |
| --- | --- |
| Category 1 | 4.3 |
| Category 2 | 2.5 |
| Category 3 | 3.5 |
| Category 4 | 4.5 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Dynamic%20Chart%20Series%20Color.docx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```java
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists 589a697fc7c7371d408a52bb32d94740 >}}



---

## Chart Series Coloring in Word Processing Document

Path: /assembly/net/chart-series-coloring-in-word-processing-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Word Processing Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
2.  Select "Column" in the sidebar, you will see a gallery of charts
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/chart-series-coloring-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The Report must be generated in the Word Processing Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Chart Data (Excel)

|   | Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>> |
| --- | --- |
| Category 1 | 4.3 |
| Category 2 | 2.5 |
| Category 3 | 3.5 |
| Category 4 | 4.5 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Chart%20Series%20Color.docx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```csharp
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists 492c3768cdc6ab44f3323171dd2aa512 >}}



---

## Classifier initialization

Path: /classification/net/classifier-initialization/

Initialization of **Classifier** class:

```csharp
var classifier = new Classifier();
```

**Classifier** class is thread-safe.

---

## ClassNotFoundException BouncyCastleProvider exception

Path: /viewer/java/classnotfoundexception-bouncycastleprovider/


GroupDocs.Viewer for Java  API depends on Bouncy Castle for encryption and decryption features, that is; if the program is required to load or save encrypted spreadsheets, it is required to add reference of `bcprov-jdk16-1.46.jar` in the project’s class path.

## Symptoms

You may get exception like `java.lang.ClassNotFoundException: org.bouncycastle.jce.provider.BouncyCastleProvider`.

## Solution

The solution is actually very simple as detailed below.

* Download `bcprov-jdk16-1.46.jar` library as JAR file from [Maven repository](https://mvnrepository.com/artifact/org.bouncycastle/bcprov-jdk16/1.46).
* Put the file into your project directory.
* Reference the `bcprov-jdk16-1.46.jar` in the class path of the project.

Alternatively, you can add the dependency in the pom.xml and let the project resolve the dependency via maven.

```xml
<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcprov-jdk16</artifactId>
    <version>1.46</version>
</dependency>
```

---

## Column Chart in Word Processing Document

Path: /assembly/java/column-chart-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Column Chart Report with Filtered, Ordered and Grouped Data in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft Word Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "Column" in the sidebar, you will see a gallery of charts.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/column-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must show total Contract Prices by Quarters
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Quarters<<foreach [in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x [key.getName()]>>
```

#### Chart Data (Excel)

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" width="710" style="width: 532.45pt; margin-left: 15.75pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="98" valign="top" style="width: 73.65pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">1st Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 0 &amp;&amp; c.getDate().getMonth() &lt;= 2).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">2nd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 3 &amp;&amp; c.getDate().getMonth() &lt;= 5).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">3rd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 6 &amp;&amp; c.getDate().getMonth() &lt;= 8).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">4th Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 9 &amp;&amp; c.getDate().getMonth() &lt;= 11).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 1</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr></tbody></table>
### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 0b6e4846e90cffde96b3072f7b117399 >}}

## Column Chart in OpenOffice Document

To be investigated.

---

## Column Chart in Word Processing Document

Path: /assembly/net/column-chart-in-word-processing-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft Word Document

### Creating a Column Chart

Practicing the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialogue box.
2.  Select "Column" in the sidebar, you will see a gallery of charts.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/column-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must show the quantity of sales/orders.
*   Sales/orders quantity must represented by Quarters.
*   It must associate order quantity with the corresponding customer.
*   A report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Quantity by Quarters<<foreach [in orders
.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>><<x [Key.CustomerName]>>

```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1st Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 1 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 3).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2nd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 4 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 6).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3rd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 7 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 9).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4th Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 10 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 12).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 1</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.docx?raw=true) (Template for CustomObject and JSON examples) 
*   [Chart Template\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB.docx?raw=true) (Template for DataSet, DataBase examples)
*   [Chart Template\_XML.docx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML.docx?raw=true) (Template for XML examples) 

### Generating The Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist GroupDocsGists 48b05daa8212398d47512b1713c2d1e4 >}}



#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist GroupDocsGists 2221cf16adb17137c5d1ab49c8c6b7b9 >}}



#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist GroupDocsGists 2ef82dbe9f01c347801e13e86f8b01f8 >}}



#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist GroupDocsGists 80569b97044698f7346ea3597dcc466a >}}



#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist GroupDocsGists ff5500a0fe88f9e38a6e16957d1feeaf >}}



## Column Chart in OpenOffice Document

To be investigated.

---

## Common List Image in Word Processing Document

Path: /assembly/java/common-list-image-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List Image report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common List in Microsoft Word Document

### Creating a Common List

Please follow below steps to create Common List Image document in MS Word 2013:

1.  Insert the desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show multiple managers' picture and name.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
<<foreach [in getManagers()]>> <<image [getPhoto()]>>
<<[getName()]>>
<</foreach>>
```

### Download Common List Template

Please download the sample Common List document we created in this article:

*   [Common List.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Common%20List.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 7cd019cb76fce4150c04affa0f8ebfe6 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common List Image in Word Processing Document

Path: /assembly/net/common-list-image-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List Image report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Common List in Microsoft Word Document

### Creating a Common List

Please follow below steps to create Common List Image document in MS Word 2013:

1.  Insert the desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers with the following key requirements:

*   A report must show multiple customers' picture and name.
*   A report must be generated in the Word Processing Document.  
      
  

{{< alert style="info" >}}See how to use images in MS Word [here](https://www.youtube.com/watch?v=jIX01CSvo8Q&index=9&list=PL25CTxMCj5vOzsaE9Rwjwd4-OwvdaWmJ8).{{< /alert >}}

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<img src="/assembly/net/images/common-list-image-word-processing-document.png" alt="common-list-image-word-processing-document" style="width:230px"/>

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Common List Template

Please download the sample Common List document we created in this article:

*   [Common List.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Common%20List.docx?raw=true)  
      

{{< alert style="warning" >}}Use this template for DB, Dataset, JSON and XML examples also.{{< /alert >}}

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 3c02ef8ceedaba2b31b0794f0969cebb >}}



#### Database Entities

{{< gist GroupDocsGists ae11c8026236558833331c50c58994d8 >}}



#### Using DataSet

{{< gist GroupDocsGists 35f51e69caac0c2106fba241ee8124af >}}



#### Using XML DataSource

{{< gist GroupDocsGists e51e0318d2617333e3a9f3c45427831f >}}



#### Using JSON DataSource

{{< gist GroupDocsGists b8b1078c1c26628a4a34c39df62de4cd >}}



## Common List in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [Wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Common List' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Common List\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Common%20List_OpenDocument.odt?raw=true) (use same template for database, dataset, JSON and XML examples)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 76155c47654d1a18daa10d4dafc1dd64 >}}



#### Database Entities

{{< gist GroupDocsGists 60cdea23654e56e2d957375d94728a6f >}}



#### Using DataSet

{{< gist GroupDocsGists bac67fd885cee995bbf6f05e0d80ca2f >}}



#### Using XML DataSource

{{< gist GroupDocsGists 3166364847840c7b0750f3228d54e6e5 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 755618eef568adbe5dbaad0531c47ef6 >}}



### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common Master-Detail Image in Word Processing Document

Path: /assembly/java/common-master-detail-image-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail Image report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common Master-Detail Image in Microsoft Word Document

### Creating a Common Master-Detail Image

Please follow below steps you can create Common Master-Detail Template in MS Word 2013.

1.  Insert a desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers and clients with the following key requirements:

*   Report must show managers' picture and name.
*   It must associate the managers with their clients.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
<<foreach [in getManagers()]
>> >" style="outline: 0px !important;">
<<[getName()]>>
Clients: <<foreach [in getContracts()]>><<[indexOf() != 0 ? ", " : ""]>><<[getClient().getName()]>><</foreach>>
 
<</foreach>>
```

### Download Common Master-DetailTemplate

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Common%20Master-Detail.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists ba824939d097cefaa3ba6ee6de30f9d5 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common Master-Detail Image in Word Processing Document

Path: /assembly/net/common-master-detail-image-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail Image report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Common Master-Detail Image in Microsoft Word Document

### Creating a Common Master-Detail Image

Please follow below steps you can create Common Master-Detail Template in MS Word 2013.

1.  Insert the desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and products with the following key requirements:

*   Report must show customers' picture and name.
*   It must associate the customers with their products.
*   Report must be generated in the Word Processing Document.

{{< alert style="info" >}}See how to use images in MS Word here.{{< /alert >}}

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

&lt;&lt;foreach \[in customers\]>>

<table class="gd-assembly1"cellspacing="0" cellpadding="0" style="border-collapse: collapse; float: bottom; margin-top: 0pt; margin-right: 9pt; margin-bottom: 0pt; margin-left: 9pt; width: 132.15pt; height: 132.15pt ">
	<tbody>
		<tr>
			<td style="vertical-align: top;">&lt;&lt;image [customer.Photo]>></td>
		</tr>
	</tbody>
</table>

**&lt;&lt;[CustomerName]>>**

**Products: &lt;&lt;foreach [in Order]>>&lt;&lt;[IndexOf() != 0 ? ", " : ""]>>&lt;&lt;[Product.ProductName]>>&lt;&lt;/foreach>>**

&lt;&lt;/foreach>>

{{< alert style="success" >}}

For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).

{{< /alert >}}

### Download Common Master-DetailTemplate

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Common%20Master-Detail.docx?raw=true) (Template for CustomObject and JSON examples)
*   [Common Master-Detail\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Common%20Master-Detail_DB.docx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists f659589cae0f24c5500f9e2fd39c8ff5 >}}

#### Database Entities

{{< gist GroupDocsGists 0f0827a650b0b0e4db55ddca1efa8033 >}}

#### Using DataSet

{{< gist GroupDocsGists 004ac14e5a96b877eefe0b42a7e6e5ef >}}

#### Using XML DataSource

{{< gist GroupDocsGists a8303e24fefbd71ceff390a32e13668b >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 721f9f83f25c880bc9f57383f17d0d6e >}}

## Common Master-Detail in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Common Master-Detail' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Common Master-Detail\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Common%20Master-Detail_OpenDocument.odt?raw=true) (use same template for JSON examples)
*   [Common Master-Detail\_DB\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Common%20Master-Detail_DB_OpenDocument.odt?raw=true) (use same template for database and dataset and XML examples)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 9e3a02f4a1f5b7ef54ccb059dd96a039 >}}

#### Database Entities

{{< gist GroupDocsGists b271cec9679d51438f4990085f37ba02 >}}

#### Using DataSet

{{< gist GroupDocsGists 3d522b9b2cae2e11647d4089a4f2dfd7 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 4a676c7c9c231e5fc4f489d36aa8d370 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 352b28ee4af2e26ca54a188d5bdbfd16 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Compare Excel Spreadsheets. Advanced Cell-by-Cell Analysis in C#

Path: /comparison/net/compare-excel-spreadsheets/


{{< alert style="info" >}} 💡For the **complete working code** and detailed explanations, please refer to the [full repository here](https://github.com/groupdocs-comparison/net-excel-comparison-sample).  
This repository contains all source files, helper classes, and configuration examples to implement Excel spreadsheet comparison in your .NET applications.{{< /alert >}}

This article demonstrates how to compare **Excel spreadsheets** (XLSX, XLS) using **GroupDocs.Comparison for .NET**.\
The sample project provides ready-to-use examples that enable developers to quickly identify cell-level differences with customizable styling, visibility controls, summary pages, and advanced comparison options.

Excel spreadsheet comparison is essential for **financial auditing**, **data validation**, **version control**, **compliance reporting**, and **collaborative editing**.  
With GroupDocs.Comparison for .NET, you can automate Excel comparison workflows and generate result documents that highlight insertions, deletions, and modifications with configurable visual styles.

> 💡 Use this approach when you need to automatically detect and highlight differences between Excel spreadsheet versions without manual review.

## Prerequisites

Before proceeding, make sure you have:

-   **GroupDocs.Comparison for .NET** installed. [Get a free trial](https://purchase.groupdocs.com/temp-license/100078).
-   **.NET SDK** 6.0 or later installed.
-   **Visual Studio** 2019 or later (recommended) or any .NET-compatible IDE.
-   A valid **GroupDocs.Comparison license** file (temporary license available for evaluation).

## Installation

Clone or download the [sample repository](https://github.com/groupdocs-comparison/net-excel-comparison-sample).

```bash
git clone https://github.com/groupdocs-comparison/net-excel-comparison-sample.git
cd net-excel-comparison-sample/CompareExcelSpreadsheets
```

Install the GroupDocs.Comparison NuGet package:

```bash
dotnet add package GroupDocs.Comparison
```

Or via Package Manager Console in Visual Studio:

```powershell
Install-Package GroupDocs.Comparison
```

## Repository Structure

The project includes:

    compare-excel-spreadsheets-dotnet/
     ├── CompareExcelSpreadsheets/
     │   ├── Program.cs                    # Main program with all comparison examples
     │   └── CompareExcelSpreadsheets.csproj  # Project file with dependencies
     ├── sample-files/                     # Input Excel files (source.xlsx, target.xlsx)
     ├── output/                           # Generated comparison results
     └── README.md

## Usage Examples

Below are simplified versions of the sample code. For the full implementation, see the [repository](https://github.com/groupdocs-comparison/net-excel-comparison-sample).

### Basic Comparison

The `BasicComparison` method performs a straightforward comparison using default settings:

```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;

private static void BasicComparison(string sourcePath, string targetPath, string resultPath)
{
    EnsureFileExists(sourcePath, "source Excel file");
    EnsureFileExists(targetPath, "target Excel file");

    using (var comparer = new Comparer(sourcePath))
    {
        comparer.Add(targetPath);
        comparer.Compare(resultPath);
    }

    Console.WriteLine("Basic comparison completed.");
}
```

This code uses GroupDocs.Comparison's `Comparer` class to compare two Excel files with default styling, highlighting all differences automatically.

### Styled Comparison with Custom Formatting

The `StyledComparison` method applies custom styling and generates a summary page:

```csharp
private static void StyledComparison(string sourcePath, string targetPath, string resultPath)
{
    EnsureFileExists(sourcePath, "source Excel file");
    EnsureFileExists(targetPath, "target Excel file");

    var compareOptions = new CompareOptions
    {
        InsertedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Green,
            IsUnderline = true,
            IsBold = true,
            IsItalic = true
        },
        DeletedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Brown,
            IsUnderline = true,
            IsBold = true,
            IsItalic = true
        },
        ChangedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Firebrick,
            IsUnderline = true,
            IsBold = true,
            IsItalic = true
        },
        GenerateSummaryPage = true,
        ShowDeletedContent = false,
    };

    using (var comparer = new Comparer(sourcePath))
    {
        comparer.Add(targetPath);
        comparer.Compare(resultPath, compareOptions);
    }

    Console.WriteLine("Styled comparison completed (changes highlighted, summary page generated).");
}
```

This example demonstrates GroupDocs.Comparison's `CompareOptions` and `StyleSettings` classes for custom formatting. Inserted cells appear in green, deleted cells in brown, and changed cells in firebrick, all with bold, italic, and underline formatting.

### Hide Inserted Content

The `HideInsertedContentComparison` method focuses on deletions and modifications:

```csharp
private static void HideInsertedContentComparison(string sourcePath, string targetPath, string resultPath)
{
    EnsureFileExists(sourcePath, "source Excel file");
    EnsureFileExists(targetPath, "target Excel file");

    var compareOptions = new CompareOptions
    {
        ShowInsertedContent = false
    };

    using (var comparer = new Comparer(sourcePath))
    {
        comparer.Add(targetPath);
        comparer.Compare(resultPath, compareOptions);
    }

    Console.WriteLine("Comparison completed (inserted content hidden).");
}
```

By setting `ShowInsertedContent` to `false`, this sample suppresses the display of any newly added cells in the result document, making deletions and modifications more prominent.

### Hide Deleted Content

The `HideDeletedContentComparison` method focuses on additions and modifications:

```csharp
private static void HideDeletedContentComparison(string sourcePath, string targetPath, string resultPath)
{
    EnsureFileExists(sourcePath, "source Excel file");
    EnsureFileExists(targetPath, "target Excel file");

    var compareOptions = new CompareOptions
    {
        ShowDeletedContent = false
    };

    using (var comparer = new Comparer(sourcePath))
    {
        comparer.Add(targetPath);
        comparer.Compare(resultPath, compareOptions);
    }

    Console.WriteLine("Comparison completed (deleted content hidden).");
}
```

Setting `ShowDeletedContent` to `false` removes any visual indication of deleted cells, highlighting only additions and changes.

### Leave Gaps for Deleted Content

The `LeaveGapsComparison` method preserves document structure:

```csharp
private static void LeaveGapsComparison(string sourcePath, string targetPath, string resultPath)
{
    EnsureFileExists(sourcePath, "source Excel file");
    EnsureFileExists(targetPath, "target Excel file");

    var compareOptions = new CompareOptions
    {
        LeaveGaps = true
    };

    using (var comparer = new Comparer(sourcePath))
    {
        comparer.Add(targetPath);
        comparer.Compare(resultPath, compareOptions);
    }

    Console.WriteLine("Comparison completed (gaps left for deleted content).");
}
```

Enabling `LeaveGaps` retains empty cells where deletions occurred, keeping the spreadsheet's layout intact and making the missing content immediately visible.

### Hide Both Inserted and Deleted Content

The `HideBothContentComparison` method shows only modifications:

```csharp
private static void HideBothContentComparison(string sourcePath, string targetPath, string resultPath)
{
    EnsureFileExists(sourcePath, "source Excel file");
    EnsureFileExists(targetPath, "target Excel file");

    var compareOptions = new CompareOptions
    {
        ShowInsertedContent = false,
        ShowDeletedContent = false,
        LeaveGaps = true
    };

    using (var comparer = new Comparer(sourcePath))
    {
        comparer.Add(targetPath);
        comparer.Compare(resultPath, compareOptions);
    }

    Console.WriteLine("Comparison completed (both inserted and deleted content hidden, gaps left).");
}
```

Both `ShowInsertedContent` and `ShowDeletedContent` are disabled, while `LeaveGaps` remains true to keep the layout. The result highlights only cells that changed value, ideal for change-impact analysis.

### License Management

Apply the GroupDocs.Comparison license before performing comparisons:

```csharp
private static void ApplyLicense()
{
    string licensePath = "path to your license file";
    License license = new License();
    license.SetLicense(licensePath);
}
```

Update the `licensePath` variable with the path to your license file. Without a valid license, the library runs in evaluation mode with limited capabilities.

### File Validation

The `EnsureFileExists` helper method validates file presence:

```csharp
private static void EnsureFileExists(string path, string description)
{
    if (!File.Exists(path))
    {
        throw new FileNotFoundException($"The {description} was not found. Path: {path}", path);
    }
}
```

This helper validates file existence before any comparison operation, providing a clear exception message that aids debugging.

## Running the Examples

1. Place your Excel files in the `sample-files` directory:
   - `source.xlsx` - The original Excel file
   - `target.xlsx` - The modified Excel file to compare against

2. Update the license path in `Program.cs`:
   ```csharp
   string licensePath = "path to your license file";
   ```

3. Run the project:
   ```bash
   dotnet run
   ```

4. Check the `output` directory for comparison results:
   - `result_basic.xlsx` - Basic comparison result
   - `result_styled.xlsx` - Styled comparison with summary page
   - `result_hide_inserted.xlsx` - Result with inserted content hidden
   - `result_hide_deleted.xlsx` - Result with deleted content hidden
   - `result_leave_gaps.xlsx` - Result with gaps for deleted content
   - `result_hide_both.xlsx` - Result showing only modifications

## Notes

- Replace file paths with your actual document locations.
- Default styling uses standard colors for inserted, deleted, and modified content.
- Summary page generation provides a consolidated view of all changes in a single page.
- Visibility controls allow you to focus on specific change types based on your analysis needs.
- The `LeaveGaps` option preserves document structure, making it easier to identify where content was removed.
- For detailed examples and advanced scenarios, see the [full repository](https://github.com/groupdocs-comparison/net-excel-comparison-sample).

## See Also

- [Compare Documents]({{< ref "comparison/net/comparison-basic/compare-documents" >}})
- [Customize Changes Styles]({{< ref "comparison/net/advanced-usage/comparison/customize-changes-styles" >}})
- [Compare Excel Spreadsheets: Advanced Cell-by-Cell Analysis with C#](https://blog.groupdocs.com/comparison/compare-excel-spreadsheets-advanced-cell-by-cell-analysis-csharp/)

---

## Compare Markdown documents

Path: /comparison/python-net/compare-markdown-documents/


# Compare Markdown documents in Python

[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) provides a simple way to **compare Markdown documents** and highlight differences in content, formatting, and structure. This is especially useful for developers working with versioned documentation, README files, or technical writing where precise change detection is needed.

With the API, you can:

- Compare two or more **Markdown (.md) files**  
- Highlight insertions, deletions, and modifications  
- Export results to a single Markdown file or another supported format  

## How to compare Markdown files in Python

To compare Markdown documents, follow these steps:

1. Create an instance of the `Comparer` class and load the source Markdown file.  
2. Add one or more target Markdown files for comparison.  
3. Call the `compare()` method and provide the path for the result file.  

## Example: Compare Markdown documents

```python
import groupdocs.comparison as gc

source_path = "source.md"
target_path = "target.md"
result_path = "result.md"

# Initialize the comparer with the source Markdown document
with gc.Comparer(source_path) as comparer:

    # Add the target Markdown document
    comparer.add(target_path)

    # Compare and save the results
    comparer.compare(result_path)
```
---

## Compare multiple documents protected by password

Path: /comparison/java/compare-multiple-documents-protected-by-password/


{{< alert style="info" >}}This feature is available only for Word documents, PowerPoint, and Open Document presentations.{{< /alert >}}

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare more that two password-protected documents.

To compare several password-protected documents, follow these steps:

1.  Instantiate the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object. Specify source document password.
2.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream and the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object created in the previous step.
3.  Instantiate another [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object and specify target document password.
4.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-com.groupdocs.comparison.options.load.LoadOptions-) method and specify the target document path or stream and the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object created at previous step. Repeat steps 3-4 for every target document.
5.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method.

The following code snippets shows how to compare several password-protected documents:

## Compare several password-protected documents from local disk

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.words.revision.*;
import java.awt.*;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx", new LoadOptions("source-password"))) {
    comparer.add("target.docx", new LoadOptions("target-password"));
    comparer.add("target2.docx", new LoadOptions("target-password"));
    comparer.add("target3.docx", new LoadOptions("target-password"));
    final Path resultPath = comparer.compare("result.docx");
}
```
{{< /tab >}}
{{< /tabs >}}

## Compare several password-protected documents from stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.words.revision.*;
import java.awt.*;
import java.nio.file.Path;
import java.io.FileInputStream;
import java.io.InputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream, new LoadOptions("source-password"))) {
    comparer.add(targetInputStream1, new LoadOptions("target-password"));
    comparer.add(targetInputStream2, new LoadOptions("target-password"));
    comparer.add(targetInputStream3, new LoadOptions("target-password"));
    final Path resultPath = comparer.compare(resultInputStream);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Compare multiple documents protected by password

Path: /comparison/net/compare-multiple-documents-protected-by-password/


{{< alert style="info" >}}This feature is available only for Word documents, PowerPoint, and Open Document presentations.{{< /alert >}}

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare more that two password-protected documents.

To compare several password-protected documents, follow these steps:

1.  Instantiate the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object. Specify source document password.
2.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream and the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object created in the previous step.
3.  Instantiate another [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object and specify target document password.
4.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method and specify the target document path or stream and the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object created at previous step. Repeat steps 3-4 for every target document.
5.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare/index) method.

The following code snippets shows how to compare several password-protected documents:

## Compare several password-protected documents from local disk

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx", new LoadOptions() { Password = "1234" }))
{
    comparer.Add("target1.docx", new LoadOptions() { Password = "5678" });
    comparer.Add("target2.docx", new LoadOptions() { Password = "5678" });
    comparer.Add("target3.docx", new LoadOptions() { Password = "5678" });
    comparer.Compare("result.docx");
}
```
{{< /tab >}}
{{< /tabs >}}

## Compare several password-protected documents from stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer(
    File.OpenRead("source.docx"), new LoadOptions() { Password = "1234" }))
{
    comparer.Add(File.OpenRead("target1.docx"), new LoadOptions() { Password = "5678" });
    comparer.Add(File.OpenRead("target2.docx"), new LoadOptions() { Password = "5678" });
    comparer.Add(File.OpenRead("target3.docx"), new LoadOptions() { Password = "5678" });
    comparer.Compare(File.Create("result.docx"));
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Compare multiple documents protected by password

Path: /comparison/nodejs-java/compare-multiple-documents-protected-by-password/


{{< alert style="info" >}}This feature is available only for Word documents, PowerPoint, and Open Document presentations.{{< /alert >}}

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare more than two password-protected documents.

The following code snippets show how to compare several password-protected documents:

## Compare several password-protected documents from a local disk

The following example compares a password-protected source document with three password-protected target documents from disk and saves a combined result.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for the source document, three target documents, and the output result
const sourceFile = 'sample-files/source_protected.docx';
const targetFile1 = 'sample-files/target_protected.docx';
const targetFile2 = 'sample-files/target2_protected.docx';
const targetFile3 = 'sample-files/target3_protected.docx';
const resultFile = 'result.docx';

// Create a Comparer instance for the source file, providing its password via LoadOptions
const comparer = new groupdocs.Comparer(sourceFile, new groupdocs.LoadOptions('1234'));

// Add the target documents with their passwords
comparer.add(targetFile1, new groupdocs.LoadOptions('5678'));
comparer.add(targetFile2, new groupdocs.LoadOptions('5678'));
comparer.add(targetFile3, new groupdocs.LoadOptions('5678'));

// Perform the comparison and save the merged result to the specified output file
comparer.compare(resultFile);

// Terminate the process with a success exit code
process.exit(0);
```

This disk-based example:

1. Creates a `Comparer` instance for the password-protected source document using `LoadOptions`.
2. Adds each protected target document with its corresponding `LoadOptions` (containing the password) via `add()`.
3. Calls `compare()` to generate a single result that merges changes across all password-protected documents.

## Compare several password-protected documents from a stream

The following example performs the same operation using Java input streams instead of file paths.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import Java bridge and FileInputStream class
const java = require('java');
const InputStream = java.import('java.io.FileInputStream');

// Define file paths for the protected documents and the result
const sourcePath = 'sample-files/source_protected.docx';
const targetPath1 = 'sample-files/target_protected.docx';
const targetPath2 = 'sample-files/target2_protected.docx';
const targetPath3 = 'sample-files/target3_protected.docx';
const resultPath = 'result_multiple_protected.docx';

// Create input streams for source and targets
const sourceStream = new InputStream(sourcePath);
const targetStream1 = new InputStream(targetPath1);
const targetStream2 = new InputStream(targetPath2);
const targetStream3 = new InputStream(targetPath3);

// Initialize comparer for the protected source document
const comparer = new groupdocs.Comparer(sourceStream, new groupdocs.LoadOptions('1234'));

// Add protected target documents using their passwords
comparer.add(targetStream1, new groupdocs.LoadOptions('5678'));
comparer.add(targetStream2, new groupdocs.LoadOptions('5678'));
comparer.add(targetStream3, new groupdocs.LoadOptions('5678'));

// Compare all documents and save the combined result
comparer.compare(resultPath);

// Terminate the process with a success exit code
process.exit(0);
```

In the stream-based scenario:

1. Input streams are opened for the source and each protected target document.
2. The `Comparer` is initialized with the source stream and its password through `LoadOptions`.
3. Target streams are added with their own `LoadOptions` instances that specify passwords.
4. The `compare()` method runs the multi-document comparison and outputs the merged result file.

---

## Compare multiple documents protected by password

Path: /comparison/python-net/compare-multiple-documents-protected-by-password/


{{< alert style="info" >}}This feature is available only for Word documents, PowerPoint, and Open Document presentations.{{< /alert >}}

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to compare more than two password-protected documents.

To compare several password-protected documents, follow these steps:

1.  Instantiate the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object. Specify the password for the source document.
2.  Instantiate the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify the source document path or stream and the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object created in the previous step.
3.  Instantiate another `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object and specify the password for the target document.
4.  Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-com.groupdocs.comparison.options.load.LoadOptions-)--> method and specify the target document path or stream and the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object created in step 3. Repeat steps 3 and 4 for every target document.
5.  Call the `compare()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#compare-java.lang.String-)--> method.

The following code snippets show how to compare several password-protected documents:

## Compare several password-protected documents from a local disk

```python
import groupdocs.comparison as gc

def compare_multiple_documents_protected_path(source_path, target_paths, source_password, target_passwords, output_file_name):
    # Initialize the comparer with the source file path and load options
    load_options_source = gc.options.LoadOptions()
    load_options_source.password = source_password
    comparer = gc.Comparer(source_path, load_options_source)

    # Add target files and load options
    for target_path, target_password in zip(target_paths, target_passwords):
        load_options_target = gc.options.LoadOptions()
        load_options_target.password = target_password
        comparer.add(target_path, load_options_target)

    # Perform the compare operation and save the result
    comparer.compare(output_file_name)

    print(f"\nDocuments compared successfully.\nCheck output in {output_file_name}.")
    
```

## Compare several password-protected documents from a stream

```python
import groupdocs.comparison as gc

def compare_multiple_documents_protected_path(source_path, target_paths, source_password, target_passwords, output_file_name):
    # Initialize the comparer with the source stream and load options
    with open(source_path, 'rb') as source_stream:
        load_options_source = gc.options.LoadOptions()
        load_options_source.password = source_password
        comparer = gc.Comparer(source_stream, load_options_source)

        # Add target streams and load options
        target_streams = []
        for target_path, target_password in zip(target_paths, target_passwords):
            target_stream = open(target_path, 'rb')
            target_streams.append(target_stream)
            load_options_target = gc.options.LoadOptions()
            load_options_target.password = target_password
            comparer.add(target_stream, load_options_target)

        # Perform the compare operation and save the result
        comparer.compare(output_file_name)

        # Close target streams after comparison
        for target_stream in target_streams:
            target_stream.close()

    print(f"\nDocuments compared successfully.\nCheck output in {output_file_name}.")
```
---

## Compare Word Documents in Node.js

Path: /comparison/nodejs-java/legal-document-comparison/


{{< alert style="info" >}} 💡For the **complete working code** and detailed explanations, please refer to the [full repository here](https://github.com/groupdocs-comparison/nodejs-compare-word-documents-sample).  
This repository contains all source files, helper classes, and configuration examples to implement Word document comparison in your Node.js applications.{{< /alert >}}


This article demonstrates how to compare **Word documents** (DOCX) using **GroupDocs.Comparison for Node.js via Java**.\
The sample project provides ready-to-use examples that enable developers to quickly identify document differences with customizable styling, password protection support, and stream-based processing.

Word document comparison is essential for **legal document review**, **contract versioning**, **compliance auditing**, and **document version control**.  
With GroupDocs.Comparison for Node.js via Java, you can automate document comparison workflows and generate result documents that highlight insertions, deletions, and modifications with configurable visual styles.


> 💡 Use this approach when you need to automatically detect and highlight differences between Word document versions without manual review.

## Prerequisites

Before proceeding, make sure you have:

-   **GroupDocs.Comparison for Node.js via Java** installed. [Get a free trial](https://purchase.groupdocs.com/temp-license/107398).
-   **Node.js** >=20.0.0 installed.
-   **Java Runtime / JDK** 8+ (Java 17 recommended).
-   `JAVA_HOME` environment variable configured.


## Installation

Clone or download the [sample repository](https://github.com/groupdocs-comparison/nodejs-compare-word-documents-sample).

``` bash
git clone https://github.com/groupdocs-comparison/nodejs-compare-word-documents-sample.git
cd nodejs-compare-word-documents-sample
```

Install dependencies with npm:

``` bash
npm install
```

## Repository Structure

The project includes:

    nodejs-compare-word-documents-sample/
     ├── src/
     │   ├── compareWordDocuments.js      # Core comparison functions
     │   ├── examples/
     │   │   ├── basicComparison.js       # Basic comparison example
     │   │   ├── advancedComparison.js    # Advanced styling example
     │   │   ├── passwordProtectedComparison.js  # Password-protected comparison
     │   │   └── streamComparison.js      # Stream-based comparison
     │   └── utils/
     │       ├── fileHelper.js            # File utilities
     │       ├── licenseHelper.js         # License management
     │       └── constants.js             # Configuration constants
     ├── sample-files/                    # Input Word documents
     ├── package.json
     └── README.md
    

## Usage Example

Below is a simplified version of the sample code. For the full implementation, see the [repository](https://github.com/groupdocs-comparison/nodejs-compare-word-documents-sample).

### Basic comparison

`compareWordDocuments.js` provides the core function for comparing Word documents:

``` javascript
const { compareWordDocuments } = require('./src/compareWordDocuments');

// Compare two Word documents
await compareWordDocuments(
  'sample-files/source.docx',
  'sample-files/target.docx',
  'output/result.docx'
);
```

### Advanced comparison with custom styling

`compareWordDocuments.js` also includes a function for custom styling:

``` javascript
const { compareWordDocumentsWithStyles } = require('./src/compareWordDocuments');
const java = require('java');
const Color = java.import('java.awt.Color');

// Configure custom styles
const styleConfig = {
  inserted: {
    highlightColor: Color.BLUE,
    fontColor: Color.BLUE,
    bold: true,
    underline: true
  },
  deleted: {
    highlightColor: Color.RED,
    fontColor: Color.RED,
    bold: true,
    strikethrough: true
  },
  changed: {
    highlightColor: Color.GREEN,
    fontColor: Color.GREEN,
    bold: true,
    underline: true
  },
  generateSummaryPage: true
};

await compareWordDocumentsWithStyles(
  'sample-files/source.docx',
  'sample-files/target.docx',
  'output/result_styled.docx',
  styleConfig
);
```

### Compare password-protected documents

`passwordProtectedComparison.js` demonstrates handling encrypted documents:

``` javascript
const { compareWordDocuments } = require('./src/compareWordDocuments');

await compareWordDocuments(
  'sample-files/source_protected.docx',
  'sample-files/target_protected.docx',
  'output/result_protected.docx',
  {
    loadOptions: {
      sourcePassword: 'source_password_123',
      targetPassword: 'target_password_123'
    }
  }
);
```

### Stream-based comparison

`streamComparison.js` shows how to compare documents using Java input streams:

``` javascript
const groupdocs = require('@groupdocs/groupdocs.comparison');
const java = require('java');
const FileInputStream = java.import('java.io.FileInputStream');

const sourceInputStream = new FileInputStream('sample-files/source.docx');
const targetInputStream = new FileInputStream('sample-files/target.docx');

const comparer = new groupdocs.Comparer(sourceInputStream);
comparer.add(targetInputStream);

await comparer.compare('output/result_stream.docx');

sourceInputStream.close();
targetInputStream.close();
```

## Notes

-   Replace file paths with your actual document locations.
-   Default styling uses blue for inserted content, red for deleted content, and green for modified content.
-   Summary page generation provides a consolidated view of all changes in a single page.
-   Stream-based comparison is useful when documents are loaded from memory or network sources.
-   For detailed examples and advanced scenarios, see the [full repository](https://github.com/groupdocs-comparison/nodejs-compare-word-documents-sample).

## See Also

-   [Compare Documents]({{< ref "comparison/nodejs-java/comparison-basic/compare-documents" >}})
-   [Customize Changes Styles]({{< ref "comparison/nodejs-java/advanced-usage/comparison/customize-changes-styles" >}})
-   [Load Password-Protected Documents]({{< ref "comparison/nodejs-java/advanced-usage/loading/load-password-protected-documents" >}})
-   [Legal Document Comparison API: Automate Contract Review with Node.js](https://blog.groupdocs.com/comparison/legal-document-comparison-api-contract-review-automation-nodejs/)
-   [Optimize Document Comparison Performance: Scale to Millions of Files with Node.js](https://blog.groupdocs.com/comparison/optimize-document-comparison-performance-scale-millions-files-nodejs/)


---

## Composing signature with linear gradient brush background

Path: /signature/java/composing-signature-with-linear-gradient-brush-background/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [LinearGradientBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/LinearGradientBrush) class to specify filling signature background with linear gradients

 Here are the steps to use Linear gradient brush with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate the [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) object with all required additional options and setup [Background.setBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/Background#setBrush(com.groupdocs.signature.domain.extensions.Brush)) property with instance of  [LinearGradientBrush ](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/LinearGradientBrush)  
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) to it.   
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

This example shows how to use Texture brush for signature background. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
Signature signature = new Signature("sample.docx");
TextSignOptions options = new TextSignOptions("John Smith");
 
// adjust signature appearance brush
 
// setup background
Background background = new Background();
background.setColor(Color.GREEN);
background.setTransparency(0.5);
background.setBrush(new LinearGradientBrush(Color.GREEN, Color.WHITE, 45));
options.setBackground(background);
 
// locate signature
options.setWidth(100);
options.setHeight(80);
options.setVerticalAlignment(VerticalAlignment.Center);
options.setHorizontalAlignment(HorizontalAlignment.Center);
Padding padding = new Padding();
padding.setTop(20);
padding.setRight(20);
options.setMargin(padding);
 
// set alternative signature implementation on document page
options.setSignatureImplementation(TextSignatureImplementation.Image);
 
// sign document to file
SignResult signResult = signature.sign("signed.docx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Convert documents for RAG pipelines

Path: /markdown/net/convert-for-rag/


Retrieval-augmented generation (RAG) systems need documents in a clean, structured text format for chunking and embedding. Markdown is ideal — it preserves document structure (headings, lists, tables) while being easy to parse.

{{< mermaid class="text-center" >}}
flowchart LR
    A["PDF / DOCX / XLSX"]
    B["GroupDocs.Markdown"]
    C["Markdown"]
    D["Text Chunking"]
    E["Vector Embeddings"]
    F["LLM Query"]
    A --> B --> C --> D --> E --> F
{{< /mermaid >}}

### Basic conversion for RAG

{{< tabs "rag-basic">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Convert document to Markdown — skip images for text-only RAG
var options = new ConvertOptions
{
    ImageExportStrategy = new SkipImagesStrategy(),
    Flavor = MarkdownFlavor.CommonMark
};

string markdown = MarkdownConverter.ToMarkdown("professional-services.pdf", options);

// Split into chunks by headings
string[] chunks = markdown.Split(
    new[] { "\n## ", "\n# " },
    StringSplitOptions.RemoveEmptyEntries);

foreach (string chunk in chunks)
{
    // Send each chunk to your embedding model
    Console.WriteLine($"Chunk ({chunk.Length} chars): {chunk.Substring(0, Math.Min(80, chunk.Length))}...");
}
```
{{< /tab >}}
{{< tab "professional-services.pdf" >}}  
{{< tab-text >}}
`professional-services.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/use-cases/professional-services.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "rag-basic.txt" >}}  
```text
Chunk (7889 chars): 

**Professional Services**

A catalog of engagements offered by Meridian Ou...
```
[Download full output](/markdown/net/_output_files/developer-guide/use-cases/convert-for-rag/RagBasic/rag-basic.txt)
{{< /tab >}}
{{< /tabs >}}

### Batch processing a document library

{{< tabs "rag-batch">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    ImageExportStrategy = new SkipImagesStrategy()
};

string[] files = Directory.GetFiles("documents", "*.pdf");

foreach (string file in files)
{
    try
    {
        string markdown = MarkdownConverter.ToMarkdown(file, options);
        string outputPath = Path.ChangeExtension(file, ".md");
        File.WriteAllText(outputPath, markdown);
        Console.WriteLine($"Converted: {file}");
    }
    catch (GroupDocsMarkdownException ex)
    {
        Console.WriteLine($"Skipped {file}: {ex.Message}");
    }
}
```
{{< /tab >}}
{{< tab "rag-batch.zip" >}}  
```text
documents/business-plan.md (7 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/use-cases/convert-for-rag/RagBatch/rag-batch.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Convert documents for RAG pipelines

Path: /markdown/python-net/convert-for-rag/


Retrieval-augmented generation (RAG) systems need documents in a clean, structured text format for chunking and embedding. Markdown is ideal -- it preserves document structure (headings, lists, tables) while being easy to parse.

{{< mermaid class="text-center" >}}
flowchart LR
    A["PDF / DOCX / XLSX"]
    B["GroupDocs.Markdown"]
    C["Markdown"]
    D["Text Chunking"]
    E["Vector Embeddings"]
    F["LLM Query"]
    A --> B --> C --> D --> E --> F
{{< /mermaid >}}

### Basic conversion for RAG

{{< tabs "convert-for-rag-basic">}}
{{< tab "convert_for_rag.py" >}}  
```python
import re
from groupdocs.markdown import MarkdownConverter, ConvertOptions, SkipImagesStrategy, MarkdownFlavor

def convert_for_rag():
    """Convert a PDF to Markdown for RAG pipelines, then split into chunks by heading."""

    # Step 1: Configure conversion for text-only RAG (skip images)
    options = ConvertOptions()
    options.image_export_strategy = SkipImagesStrategy()
    options.flavor = MarkdownFlavor.COMMON_MARK

    # Step 2: Convert the document using keyword argument for options
    markdown = MarkdownConverter.to_markdown("business-plan.pdf", convert_options=options)

    # Step 3: Split the Markdown into chunks by heading markers
    chunks = re.split(r"\n#{1,2} ", markdown)

    # Step 4: Process each chunk (e.g., send to an embedding model)
    for chunk in chunks:
        if chunk.strip():
            print(f"Chunk ({len(chunk)} chars): {chunk[:80]}...")

if __name__ == "__main__":
    convert_for_rag()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/use-cases/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "convert-rag.txt" >}}  
```text
Chunk (36184 chars): 



**HOME**** ****BASED**** ****PROFESSIONAL**** **



**SERVICES**** **



***...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/convert-for-rag/convert_for_rag/convert-rag.txt)
{{< /tab >}}
{{< tab "convert-rag.txt" >}}  
```text
Chunk (34602 chars): 



**HOME BASED PROFESSIONAL SERVICES *Business Plan* TABLE OF CONTENTS** 



I...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/convert-for-rag/convert_for_rag/convert-rag.txt)
{{< /tab >}}
{{< /tabs >}}

### Batch processing a document library

{{< tabs "batch-convert-for-rag">}}
{{< tab "batch_convert_for_rag.py" >}}  
```python
import os
import glob
from groupdocs.markdown import MarkdownConverter, ConvertOptions, SkipImagesStrategy, GroupDocsMarkdownException

def batch_convert_for_rag():
    """Batch-convert all PDFs in a folder to Markdown for RAG ingestion."""

    # Step 1: Configure conversion to skip images (text-only RAG)
    options = ConvertOptions()
    options.image_export_strategy = SkipImagesStrategy()

    # Step 2: Find all PDF files in the documents folder
    files = glob.glob("documents/*.pdf")

    # Step 3: Convert each file, handling errors gracefully
    for file in files:
        try:
            markdown = MarkdownConverter.to_markdown(file, convert_options=options)
            output_path = os.path.splitext(file)[0] + ".md"
            with open(output_path, "w", encoding="utf-8") as f:
                f.write(markdown)
            print(f"Converted: {file}")
        except GroupDocsMarkdownException as ex:
            print(f"Skipped {file}: {ex}")

if __name__ == "__main__":
    batch_convert_for_rag()
```
{{< /tab >}}
{{< tab "batch-convert-rag.txt" >}}  
```text
Converted: documents\business-plan.pdf
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/convert-for-rag/batch_convert_for_rag/batch-convert-rag.txt)
{{< /tab >}}
{{< tab "batch-convert-rag.zip" >}}  
```text
documents/business-plan.txt (32 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/convert-for-rag/batch_convert_for_rag/batch-convert-rag.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Convert PST or OST documents to different formats

Path: /conversion/net/convert-pst-or-ost-document-contents-to-different-formats/

GroupDocs.Conversion provides a flexible API to control the conversion of documents that contain other documents. 

The following code snippet shows how to convert each constituent
 file of the Outlook Offline Data File (OST) to a different format based on its content type:

```csharp
var index = 1;
LoadOptions LoadOptionsProvider(LoadContext loadContext)
{
    if (loadContext.SourceFormat == EmailFileType.Ost)
    {
        return new PersonalStorageLoadOptions
        {
            Folder = @"Root - Mailbox",
            Depth = 2
        };
    }
    return null;
}

Stream ConvertedStreamProvider(SaveContext saveContext)
{
    string outputFile = $"converted-{index++}.{saveContext.TargetFormat.Extension}";
    return new FileStream(outputFile, FileMode.Create);
}

ConvertOptions ConvertOptionsProvider(ConvertContext convertContext)
{
    if (convertContext.SourceFormat == EmailFileType.Msg)
    {
        return new PdfConvertOptions();
    }
    return new WordProcessingConvertOptions();
}

using (var converter = new Converter("sample.ost", LoadOptionsProvider))
{
    converter.Convert(ConvertedStreamProvider, ConvertOptionsProvider);
}

```
---

## Convert to HTML with advanced options

Path: /conversion/java/convert-to-html-with-advanced-options/


To convert documents to HTML with advanced options using [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/), you can utilize the [WebConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webconvertoptions/) class. This class provides various properties to customize the HTML output according to your requirements:
| Option | Description |
|--------|-------------|
|[**setUsePdf()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webconvertoptions/#setUsePdf-boolean-) | If `true`, the input firstly is converted to PDF and after that to desired format. |  
|[**setFixedLayout()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webconvertoptions/#setFixedLayout-boolean-) | If `true` fixed layout will be used e.g. absolutely positioned html elements <br>`Default: true`. |
|[**setFixedLayoutShowBorders()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webconvertoptions/#setFixedLayoutShowBorders-boolean-) | Show page borders when converting to fixed layout. `Default: true`. |
|[**setZoom()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webconvertoptions/#setZoom-int-) | Specifies the zoom level in percentage. `Default: 100`. |


The following code snippet shows how to convert to HTML with advanced options:

{{< tabs "code-example">}}
{{< tab "ConvertToHtmlWithAdvancedOptions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WebConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

public class ConvertToHtmlWithAdvancedOptions {
    public static void convert() {
        // Instantiate the WordProcessingLoadOptions
        WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
        loadOptions.setPassword("12345");

        // Initialize the converter with the source document
        try(Converter converter = new Converter("password_protected.docx", () -> loadOptions)) {
            // Instantiate the WebConvertOptions
            WebConvertOptions options = new WebConvertOptions();
            options.setUsePdf(true); // Convert via PDF to maintain layout
            options.setFixedLayout(true); // Use fixed layout
            options.setFixedLayoutShowBorders(true); // Show borders in fixed layout
            options.setZoom(100); // Set zoom level to 100%

            // Convert to HTML with the specified options
            converter.convert("converted_with_options.html", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "password_protected.docx" >}}  
{{< tab-text >}}
`password_protected.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-html-with-advanced-options/password_protected.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_options.html" >}}  
{{< tab-text >}}
`converted_with_options.html` is converted HTML document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-html-with-advanced-options/converted_with_options.html) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

In this example, the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class is initialized with the source document. The [WebConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) are then configured to convert the document via PDF, use a fixed layout with borders, and set the zoom level to 100%. Finally, the convert method is called to perform the conversion with the specified options.

By utilizing these options, you can effectively control the HTML conversion process to meet your specific needs.
---

## Convert to HTML with advanced options

Path: /conversion/nodejs-java/convert-to-html-with-advanced-options/

**[GroupDocs.Conversion](#)** provides [MarkupConvertOptions](#) to give you control over conversion result. The following options could be set:
*   [setFixedLayout](#) controls the HTML generation. If it's set to *true*, fixed layout will be used e.g. absolutely positioned HTML element.
*   [setZoom](#) specifies the zoom level in percentage. The default value is 100.
*   [setUsePdf](#). Sometimes, for better rendering and elements positioning the source document should be converted to PDF first. If this property is set to *true*, the input firstly is converted to PDF and after that to desired format.   

The following code snippet shows how to convert to HTML with advanced options:

```js
const loadOptions = new groupdocs.conversion.WordProcessingLoadOptions()
loadOptions.setPassword("12345");

const converter = new groupdocs.conversion.Converter('sample.docx', loadOptions)
const convertOptions = new groupdocs.conversion.MarkupConvertOptions();
convertOptions.setPageNumber(2);
convertOptions.setFixedLayout(true);
convertOptions.setPagesCount(1);

converter.convert("converted.html", convertOptions);
```

---

## Custom cache implementation

Path: /viewer/net/how-to-use-custom-cache-implementation/

By default, GroupDocs.Viewer implements caching to local. But you can cache rendering result in your own way, for example, using Redis Cache. To do this, use the `ICache` interface implementation.  

This example uses the StackExchange.Redis NuGet package: https://www.nuget.org/packages/StackExchange.Redis/. Download and install it before you start.

To implement a custom cache using the Redis Cache, follow these steps:


{{< alert style="info" >}}
Before running this example, start the Redis using the following command: `docker run -d --name viewer-cache -p 6379:6379 redis`.
{{< /alert >}}

1. Create the RedisCache class that implements the [ICache](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.caching/icache) interface.
2. Instantiate the RedisCache class.
3. Instantiate the [ViewerSettings](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewersettings) class. Specify the RedisCache object as a parameter of the constructor.
4. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) class. Specify the [ViewerSettings](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewersettings) object as a parameter of the constructor.
5. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method of the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) class.

The following code snippet shows how to implement a custom caching using Redis Cache:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using System.IO;
using System.Linq;
using System.Diagnostics;
using System.Collections.Generic;
using System.Xml.Serialization;

using GroupDocs.Viewer.Caching;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer;

using StackExchange.Redis;
// ...

// Specify the cache parameters.
var serverAddress = "127.0.0.1:6379";
var filePath = "sample.docx";

// Create the cache.
RedisCache cache = new RedisCache(serverAddress, filePath);
ViewerSettings settings = new ViewerSettings(cache);

using (Viewer viewer = new Viewer(filePath, settings))
{
    // Create HTML files.
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();

    // Display rendering time.
    PrintTimeTaken(() => viewer.View(viewOptions), "The first call to View method took {0} ms.");
    // Display time to get cached results.
    PrintTimeTaken(() => viewer.View(viewOptions), "The second call to View method took {0} ms.");
}

// Get and display time taken.
static void PrintTimeTaken(Action action, string format)
{
    Stopwatch stopwatch = new Stopwatch();
    stopwatch.Start();
    action.Invoke();
    stopwatch.Stop();

    Console.WriteLine(format, stopwatch.ElapsedMilliseconds);
}

public class RedisCache : ICache, IDisposable
{
    private readonly string _cacheKeyPrefix;
    private readonly ConnectionMultiplexer _redis;
    private readonly IDatabase _db;
    private readonly string _host;

    public RedisCache(string host, string cacheKeyPrefix)
    {
        _host = host;
        _cacheKeyPrefix = cacheKeyPrefix;
        _redis = ConnectionMultiplexer.Connect(_host);
        _db = _redis.GetDatabase();
    }

    public void Set(string key, object data)
    {
        if (data == null)
            return;

        string prefixedKey = GetPrefixedKey(key);
        MemoryStream memoryStream = null;

        if (data is Stream)
        {
            memoryStream = data is MemoryStream
                ? data as MemoryStream
                : CopyToMemoryStream(data as Stream);
        }
        else
        {
            memoryStream = new MemoryStream();

            XmlSerializer serializer = new XmlSerializer(data.GetType());
            serializer.Serialize(memoryStream, data);
        }

        _db.StringSet(prefixedKey, RedisValue.CreateFrom(memoryStream));
    }

    private MemoryStream CopyToMemoryStream(Stream data)
    {
        MemoryStream result = new MemoryStream();
        data.Position = 0;
        data.CopyTo(result);
        return result;
    }

    public bool TryGetValue<TEntry>(string key, out TEntry value)
    {
        var prefixedKey = GetPrefixedKey(key);
        var redisValue = _db.StringGet(prefixedKey);
        if (redisValue.HasValue)
        {
            var data = typeof(TEntry) == typeof(Stream)
                ? ReadStream(redisValue)
                : Deserialize<TEntry>(redisValue);
            value = (TEntry)data;
            return true;
        }

        value = default;
        return false;
    }

    public IEnumerable<string> GetKeys(string filter)
    {
        return _redis.GetServer(_host).Keys(pattern: $"*{filter}*")
            .Select(x => x.ToString().Replace(_cacheKeyPrefix, string.Empty))
            .Where(x => x.StartsWith(filter, StringComparison.InvariantCultureIgnoreCase))
            .ToList();
    }

    private string GetPrefixedKey(string key)
        => $"{_cacheKeyPrefix}{key}";

    private object ReadStream(RedisValue redisValue) =>
         new MemoryStream(redisValue);

    private T Deserialize<T>(RedisValue redisValue)
    {
        object data;
        using (MemoryStream stream = new MemoryStream(redisValue))
        {
            XmlSerializer serializer = new XmlSerializer(typeof(T));

            try
            {
                data = serializer.Deserialize(stream);
            }
            catch (InvalidOperationException)
            {
                data = null;
            }
            catch (NullReferenceException)
            {
                data = null;
            }
        }

        return (T)data;
    }

    public void Dispose()
    {
        _redis.Dispose();
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports System.IO
Imports System.Linq
Imports System.Diagnostics
Imports System.Collections.Generic
Imports System.Runtime.InteropServices
Imports System.Xml.Serialization

Imports GroupDocs.Viewer.Caching
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer

Imports StackExchange.Redis

Module Program
    Public Sub Main()
        ' Specify the cache parameters.
        Dim serverAddress As String = "127.0.0.1:6379"
        Dim filePath As String = "sample.docx"

        ' Create the cache.
        Dim cache As RedisCache = New RedisCache(serverAddress, filePath)
        Dim settings As ViewerSettings = New ViewerSettings(cache)

        Using viewer As Viewer = New Viewer(filePath, settings)
            ' Create HTML files.
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()

            ' Display rendering time.
            PrintTimeTaken(Sub() viewer.View(viewOptions), "The first call to View method took {0} ms.")
            ' Display time to get cached results.
            PrintTimeTaken(Sub() viewer.View(viewOptions), "The second call to View method took {0} ms.")
        End Using
    End Sub

    ' Get and display time taken.
    Private Sub PrintTimeTaken(action As Action, format As String)
        Dim stopwatch As Stopwatch = New Stopwatch()
        stopwatch.Start()
        action.Invoke()
        stopwatch.Stop()

        Console.WriteLine(format, stopwatch.ElapsedMilliseconds)
    End Sub


    Public Class RedisCache
        Implements ICache, IDisposable

        Private ReadOnly _cacheKeyPrefix As String
        Private ReadOnly _redis As ConnectionMultiplexer
        Private ReadOnly _db As IDatabase
        Private ReadOnly _host As String

        Public Sub New(host As String, cacheKeyPrefix As String)
            _host = host
            _cacheKeyPrefix = cacheKeyPrefix
            _redis = ConnectionMultiplexer.Connect(_host)
            _db = _redis.GetDatabase()
        End Sub

        Private Function CopyToMemoryStream(data As Stream) As MemoryStream
            Dim result As New MemoryStream()
            data.Position = 0
            data.CopyTo(result)
            Return result
        End Function

        Public Sub [Set](key As String, value As Object) Implements ICache.[Set]
            If value Is Nothing Then
                Return
            End If

            Dim prefixedKey As String = GetPrefixedKey(key)
            Dim memoryStream As MemoryStream = Nothing

            If TypeOf value Is Stream Then
                memoryStream = If(TypeOf value Is MemoryStream, DirectCast(value, MemoryStream), CopyToMemoryStream(DirectCast(value, Stream)))
            Else
                memoryStream = New MemoryStream()
                Dim serializer As New XmlSerializer(value.GetType())
                serializer.Serialize(memoryStream, value)
            End If

            _db.StringSet(prefixedKey, RedisValue.CreateFrom(memoryStream))
        End Sub

        Public Function TryGetValue(Of TEntry)(key As String, <Out> ByRef value As TEntry) As Boolean Implements ICache.TryGetValue
            Dim prefixedKey As String = GetPrefixedKey(key)
            Dim redisValue As RedisValue = _db.StringGet(prefixedKey)
            If redisValue.HasValue Then
                Dim data As Object = If(GetType(TEntry) = GetType(Stream), ReadStream(redisValue), Deserialize(Of TEntry)(redisValue))
                value = DirectCast(data, TEntry)
                Return True
            End If

            value = Nothing
            Return False
        End Function

        Public Function ICache_GetKeys(filter As String) As IEnumerable(Of String) Implements ICache.GetKeys
            Return _redis.GetServer(_host).Keys(pattern:=$"*{filter}*").Select(Function(x) x.ToString().Replace(_cacheKeyPrefix, String.Empty)).Where(Function(x) x.StartsWith(filter, StringComparison.InvariantCultureIgnoreCase)).ToList()
        End Function

        Private Function GetPrefixedKey(key As String) As String
            Return $"{_cacheKeyPrefix}{key}"
        End Function

        Private Function ReadStream(redisValue As RedisValue) As Object
            Return New MemoryStream(redisValue)
        End Function

        Private Function Deserialize(Of T)(redisValue As RedisValue) As T
            Dim data As Object
            Using stream As New MemoryStream(redisValue)
                Dim serializer As New XmlSerializer(GetType(T))

                Try
                    data = serializer.Deserialize(stream)
                Catch ex As InvalidOperationException
                    data = Nothing
                Catch ex As NullReferenceException
                    data = Nothing
                End Try
            End Using

            Return DirectCast(data, T)
        End Function

        Public Sub Dispose()
            _redis.Dispose()
        End Sub

        Public Sub IDisposable_Dispose() Implements IDisposable.Dispose
            Throw New NotImplementedException
        End Sub
    End Class
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-use-custom-cache-implementation.png)
---

## Detect file type of container item

Path: /parser/net/detect-file-type-of-container-item/

# Detect file type of container item

GroupDocs.Parser provides the functionality to detect a file type of container items by [DetectFileType](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/containeritem/methods/detectfiletype) method. [FileTypeDetectionMode](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/filetypedetectionmode) parameter provides the ability to control file type detection:

- Default. The file type is detected by the file extension; if the file extension  isn't recognized, the file type is detected by the file content.
- Extension. The file type is detected only by the file extension.
- Content. The file type is detected only by the file content.

Here are the steps to detect a file type of container items:

- Instantiate [Parser ](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser)object for the initial document;
- Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain the collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects;
- Check if *collection* isn't *null* (container extraction is supported for the document);
- Iterate through the collection and call [DetectFileType](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/containeritem/methods/detectfiletype) method.

The following example shows how to detect a file type of container items:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();
    // Check if container extraction is supported
    if (attachments == null)
    {
        Console.WriteLine("Container extraction isn't supported");
    }
    // Iterate over attachments
    foreach (ContainerItem item in attachments)
    {
        // Detect the file type
        Options.FileType fileType = item.DetectFileType(Options.FileTypeDetectionMode.Default);
         
        // Print the name and file type
        Console.WriteLine(string.Format("{0}: {1}", item.Name, fileType));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Determine the file type

Path: /viewer/java/how-to-determine-file-type/

A file type is a standard way that information is encoded for storage in a computer file. For example, Microsoft Word (.docx) and Adobe PDF (.pdf) are two different file types.

Using GroupDocs.Viewer for Java, you can determine the file type using the file extension.

To determine the file type from the file extension, call the [fromExtension()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/filetype/#fromExtension-java.lang.String-) method of [FileType](https://reference.groupdocs.com/viewer/java/groupdocs.viewer/filetype/).

The following code snippet shows how to determine a file type using the file extension:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.FileType;
// ...

String extension = ".docx";
FileType fileType = FileType.fromExtension(extension);

System.out.println("\nExtension " + extension + "; File type: " + fileType);
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/java/images/how-to-determine-file-type.png)

---

## Determine the file type

Path: /viewer/net/how-to-determine-file-type/

A file type is a standard way that information is encoded for storage in a computer file. For example, Microsoft Word (.docx) and Adobe PDF (.pdf) are two different file types.

Using GroupDocs.Viewer, you can determine the file type in one of the following ways:
* [File extension](#determine-file-type-by-the-file-extension);
* [Media type](#determine-file-type-by-media-type);
* [File signature](#determine-file-type-by-stream).

## Determine the file type by the file extension

To determine the file type from the file extension, use the [FromExtension()](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype/fromextension/#fromextension) method of [FileType](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype/).

The following code snippet shows how to determine a file type using the file extension:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
// ...

// Specify a file extension.
string extension = ".docx";
// Set a file type using the extension.
FileType fileType = FileType.FromExtension(extension);
// Display the extension and the file type.
Console.WriteLine($"Extension {extension}; File type: {fileType}.");
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        ' Specify a file extension.
        Dim extension As String = ".docx"
        ' Set a file type using the extension.
        Dim fileType As FileType = FileType.FromExtension(extension)
        ' Display the extension and the file type.
        Console.WriteLine($"Extension {extension}; File type: {fileType}.")
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-determine-file-type.png)

## Determine file type by media type

If you receive a file via the Internet, you can check its media type header using the [FromMediaType()](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype/methods/frommediatype) method of the [FileType](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype) class.

The following code snippet shows how to determine a file type using the media header:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
// ...

string mediaType = "application/pdf";
FileType fileType = FileType.FromMediaType(mediaType);
Console.WriteLine($"Media-type {mediaType}; File type: {fileType}.");
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Dim mediaType As String = "application/pdf"
        Dim fileType As FileType = FileType.FromMediaType(mediaType)
        Console.WriteLine($"Media-type {mediaType}; File type: {fileType}.")
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-determine-file-type_1.png)

## Determine file type by the stream

When you do not know a file extension or media type header, you can try determining file type by using the [FromStream()](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype/methods/fromstream) method of the [FileType](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype) class. GroupDocs.Viewer will try reading the signature and mapping it to the file type.

The following code snippet shows how to determine a file type using the file signature:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using System;
using System.IO;
using GroupDocs.Viewer;
// ...

using (Stream stream = File.OpenRead("sample.docx"))
{
    FileType fileType = FileType.FromStream(stream);
    Console.WriteLine($"File type: {fileType}.");
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports System.IO
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Using stream As Stream = File.OpenRead("sample.docx")
            Dim fileType As FileType = FileType.FromStream(stream)
            Console.WriteLine($"File type: {fileType}.")
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-determine-file-type_2.png)

---

## Email attachments

Path: /watermark/java/email-attachments/

## Extracting all attachments from email message

GroupDocs.Watermark allows you to get the information about the [attachments](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/EmailContent#getAttachments()) in an email message. Below is the code snippet for extracting attachments from Email.

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailExtractAllAttachments**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg"      
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                              
                                                                                                             
EmailContent content = watermarker.getContent(EmailContent.class);                                           
for (EmailAttachment attachment : content.getAttachments())                                                  
{                                                                                                            
    System.out.println("Name: " + attachment.getName());                                                     
    System.out.println("File format: " + attachment.getDocumentInfo().getFileType());                        
                                                                                                             
    FileOutputStream outputStream = new FileOutputStream("SampleFiles\\Output" + "\\" + attachment.getName());
    outputStream.write(attachment.getContent());                                                             
    outputStream.close();                                                                                    
}                                                                                                            
                                                                                                             
watermarker.close();                                                                                         
```

## Removing particular attachment from email message

Using GroupDocs.Watermark, you can [remove](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/RemoveOnlyListBase#remove(T)) any particular attachment from an email message. Below is the code for removing specific attachment:

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailRemoveAttachment**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                         
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg"        
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                                
                                                                                                               
EmailContent content = watermarker.getContent(EmailContent.class);                                             
for (int i = content.getAttachments().getCount() - 1; i >= 0; i--)                                             
{                                                                                                              
    EmailAttachment attachment = content.getAttachments().get_Item(i);                                         
                                                                                                               
    // Remove all attached files with a particular name and format                                             
    if (attachment.getName().contains("sample") && attachment.getDocumentInfo().getFileType() == FileType.DOCX)
    {                                                                                                          
        content.getAttachments().removeAt(i);                                                                  
    }                                                                                                          
}                                                                                                              
                                                                                                               
// Save changes                                                                                                
watermarker.save("message.msg");                                                                     
                                                                                                               
watermarker.close();                                                                                           
```

## Adding attachment to email message

You can also add attachments to the email messages using GroupDocs.Watermark. Following is the code sample for adding an attachment:

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailAddAttachment**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                 
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg"
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                        
                                                                                                       
EmailContent content = watermarker.getContent(EmailContent.class);                                     
                                                                                                       
File attachmentFile = new File("sample.msg");                                                 
byte[] attachmentBytes = new byte[(int) attachmentFile.length()];                                      
InputStream attachmentInputStream = new FileInputStream(attachmentFile);                               
attachmentInputStream.read(attachmentBytes);                                                           
attachmentInputStream.close();                                                                         
                                                                                                       
content.getAttachments().add(attachmentBytes, "sample.msg");                                           
                                                                                                       
// Save changes                                                                                        
watermarker.save("message.msg");                                                             
                                                                                                       
watermarker.close();                                                                                   
```

---

## Email attachments

Path: /watermark/net/email-attachments/

## Extracting all attachments from email message

GroupDocs.Watermark allows you to get the information about the [attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.email/emailcontent/properties/attachments) in an email message. Below is the code snippet for extracting attachments from Email.

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailExtractAllAttachments**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    EmailContent content = watermarker.GetContent<EmailContent>();
    foreach (EmailAttachment attachment in content.Attachments)
    {
        Console.WriteLine("Name: {0}", attachment.Name);
        Console.WriteLine("File format: {0}", attachment.GetDocumentInfo().FileType);
        File.WriteAllBytes(Path.Combine("SampleFiles\Output", attachment.Name), attachment.Content);
    }
}
```

## Removing particular attachment from email message

Using GroupDocs.Watermark, you can [remove](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common.removeonlylistbase/1/methods/removeat) any particular attachment from an email message. Below is the code for removing specific attachment:

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailRemoveAttachment**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    EmailContent content = watermarker.GetContent<EmailContent>();
    for (int i = content.Attachments.Count - 1; i >= 0; i--)
    {
        EmailAttachment attachment = content.Attachments[i];

        // Remove all attached files with a particular name and format
        if (attachment.Name.Contains("sample") && attachment.GetDocumentInfo().FileType == FileType.DOCX)
        {
            content.Attachments.RemoveAt(i);
        }
    }

    // Save changes
    watermarker.Save("message.msg");
}
```

## Adding attachment to email message

You can also [add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.email/emailattachmentcollection/methods/add) attachments to the email messages using GroupDocs.Watermark. Following is the code sample for adding an attachment:

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailAddAttachment**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    EmailContent content = watermarker.GetContent<EmailContent>();
    content.Attachments.Add(File.ReadAllBytes("sample.msg"), "sample.msg");

    // Save changes
    watermarker.Save("message.msg");
}
```

---

## Email attachments

Path: /watermark/python-net/email-attachments/


## Extracting all attachments from email message

```python
import os
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email

output_dir = os.path.join("SampleFiles", "Output")
os.makedirs(output_dir, exist_ok=True)

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    content = watermarker.get_content(gwc_email.EmailContent)
    for attachment in content.attachments:
        print("Name:", attachment.name)
        print("File format:", attachment.get_document_info().file_type)
        with open(os.path.join(output_dir, attachment.name), "wb") as f:
            f.write(attachment.content)
```

## Removing particular attachment from email message

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email
from groupdocs.watermark.common import FileType

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    content = watermarker.get_content(gwc_email.EmailContent)
    for i in range(content.attachments.count - 1, -1, -1):
        attachment = content.attachments[i]
        if ("sample" in attachment.name) and (attachment.get_document_info().file_type == FileType.DOCX):
            content.attachments.remove_at(i)
    watermarker.save("message.msg")
```

## Adding attachment to email message

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    content = watermarker.get_content(gwc_email.EmailContent)
    with open("sample.msg", "rb") as f:
        content.attachments.add(f.read(), "sample.msg")
    watermarker.save("message.msg")
```



---

## eSign Image with Metadata signature

Path: /signature/net/esign-image-with-metadata-signature/

## Overview 
Metadata signature for Image document is an electronic signature based on image metadata standard. Most image formats support metadata specification or [EXIF](https://en.wikipedia.org/wiki/Exif). Image metadata is dictionary map with unique whole short identifier in range 0-65535, Some identifiers are reserved by [EXIF specification.](https://www.exiv2.org/tags.html) From signature perspective image metadata may content any hidden value of standard (int,char, string) or custom type (user defined class), be encrypted and decrypted back by known key over Search method.

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagemetadatasignature) class to specify Metadata e-signature for image documents. Image document metadata contains pair with unique identifier Id and its Value.  
Image document metadata could keep big amount of data that provides ability to keep serialized custom objects with additional encryption in there. See more examples [here]({{< ref "signature/net/developer-guide/advanced-usage/signing/sign-document-with-secure-custom-metadata-signatures/_index.md" >}}).

### Here are the steps to add metadata signatures into Image with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several [ImageMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagemetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Image with Metadata signature

This example shows how to sign png image with metadata e-signatures

```csharp
using (Signature signature = new Signature("sample.png"))
{
    // create Metadata option with predefined Metadata text
    var options = new MetadataSignOptions();
    // Specify different Metadata Signatures and add them to options signature collection
    ushort imgsMetadataId = 41996;
    // Create several Image Metadata signatures with different types
    options
        .Add(new ImageMetadataSignature(imgsMetadataId++, "Mr.Scherlock Holmes")) // String value
        .Add(new ImageMetadataSignature(imgsMetadataId++, DateTime.Now))          // Date Time value
        .Add(new ImageMetadataSignature(imgsMetadataId++, 123456))                // Integer value
        .Add(new ImageMetadataSignature(imgsMetadataId++, 123.456D))              // Double value
        .Add(new ImageMetadataSignature(imgsMetadataId++, 123.456M))              // Decimal value
        .Add(new ImageMetadataSignature(imgsMetadataId++, 123.456F));             // Float value

    // add these signatures to options
    options.Signatures.AddRange(signatures);
    signature.Sign("SampleSigned.png", options);
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Existing objects in diagram document

Path: /watermark/java/existing-objects-in-diagram-document/

The watermarks in Visio documents are usually represented by shapes. But sometimes document headers&footers can also be used to display text that can be considered as the watermark. GroupDocs.Watermark API allows you to find and remove watermarks of both types in Visio document.

## Removing watermark from a particular page

Removing watermark from a particular page of a Visio document using GroupDocs.Watermark consists of following steps.

1.  Load the document
2.  Create and initialize image/text search criteria
3.  Find possible watermarks
4.  Remove found watermarks
5.  Save the document

Following code sample shows how to remove watermark from a particular page.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramRemoveWatermark**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                                                         
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx"                          
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                                                   
                                                                                                                                   
DiagramContent content = watermarker.getContent(DiagramContent.class);                                                             
                                                                                                                                   
// Initialize search criteria                                                                                                      
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");                                       
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");                                                    
                                                                                                                                   
// Call FindWatermarks method for the first page                                                                                   
PossibleWatermarkCollection possibleWatermarks = content.getPages().get_Item(0).search(textSearchCriteria.or(imageSearchCriteria));
                                                                                                                                   
// Remove all found watermarks                                                                                                     
possibleWatermarks.clear();                                                                                                        
                                                                                                                                   
watermarker.save("diagram.vsdx");                                                                                        
                                                                                                                                   
watermarker.close();                                                                                                               
```

## Working with shapes

### Extracting information about all shapes

[Search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#search()) method searches watermarks of all mentioned types, but in some cases, it's necessary to analyze only one type of Visio objects. Following code sample shows how to get information about all the shapes in a Visio document.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramGetShapesInformation**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx"
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                         
                                                                                                         
DiagramContent content = watermarker.getContent(DiagramContent.class);                                   
for (DiagramPage page : content.getPages())                                                              
{                                                                                                        
    for (DiagramShape shape : page.getShapes())                                                          
    {                                                                                                    
        if (shape.getImage() != null)                                                                    
        {                                                                                                
            System.out.println(shape.getImage().getWidth());                                             
            System.out.println(shape.getImage().getHeight());                                            
            System.out.println(shape.getImage().getBytes().length);                                      
        }                                                                                                
                                                                                                         
        System.out.println(shape.getName());                                                             
        System.out.println(shape.getX());                                                                
        System.out.println(shape.getY());                                                                
        System.out.println(shape.getWidth());                                                            
        System.out.println(shape.getHeight());                                                           
        System.out.println(shape.getRotateAngle());                                                      
        System.out.println(shape.getText());                                                             
        System.out.println(shape.getId());                                                               
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.close();                                                                                     
```

### Removing a particular shape

You can also remove a particular shape from a page using GroupDocs.Watermark API (as shown in the sample code below).

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramRemoveShape()**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                                
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"  
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                          
                                                                                                          
DiagramContent content = watermarker.getContent(DiagramContent.class);                                    
                                                                                                          
// Remove shape by index                                                                                  
content.getPages().get_Item(0).getShapes().removeAt(0);                                                   
                                                                                                          
// Remove shape by reference                                                                              
content.getPages().get_Item(0).getShapes().remove(content.getPages().get_Item(0).getShapes().get_Item(0));
                                                                                                          
watermarker.save("diagram.vsdx");                                                               
                                                                                                          
watermarker.close();                                                                                      
```

### Removing shapes with particular text formatting

You can also find and remove the shapes with a particular text formatting from a Visio document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramRemoveTextShapesWithParticularTextFormatting**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                                            
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx"             
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                                      
                                                                                                                      
DiagramContent content = watermarker.getContent(DiagramContent.class);                                                
for (DiagramPage page : content.getPages())                                                                           
{                                                                                                                     
    for (int i = page.getShapes().getCount() - 1; i >= 0; i--)                                                        
    {                                                                                                                 
        for (FormattedTextFragment fragment : page.getShapes().get_Item(i).getFormattedTextFragments())               
        {                                                                                                             
            if (fragment.getForegroundColor().equals(Color.getRed()) && fragment.getFont().getFamilyName() == "Arial")
            {                                                                                                         
                page.getShapes().removeAt(i);                                                                         
                break;                                                                                                
            }                                                                                                         
        }                                                                                                             
    }                                                                                                                 
}                                                                                                                     
                                                                                                                      
watermarker.save("diagram.vsdx");                                                                           
                                                                                                                      
watermarker.close();                                                                                                  
```

### Removing hyperlink associated with a particular shape

Using GroupDocs.Watermark for Java, you can also remove hyperlink associated with a particular shape inside a Visio document. Use following code sample to achieve this functionality.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramRemoveHyperlinks**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx"
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                         
                                                                                                         
DiagramContent content = watermarker.getContent(DiagramContent.class);                                   
DiagramShape shape = content.getPages().get_Item(0).getShapes().get_Item(0);                             
for (int i = shape.getHyperlinks().getCount() - 1; i >= 0; i--)                                          
{                                                                                                        
    if (shape.getHyperlinks().get_Item(i).getAddress().contains("http://someurl.com"))                   
    {                                                                                                    
        shape.getHyperlinks().removeAt(i);                                                               
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.save("diagram.vsdx");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

### Replacing text for particular shapes

Since version 18.1. GroupDocs.Watermark allows you to replace the text for particular shapes. Following code sample shows how to replace shapes' text.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramReplaceTextForParticularShapes**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                              
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                        
                                                                                                        
DiagramContent content = watermarker.getContent(DiagramContent.class);                                  
for (DiagramShape shape : content.getPages().get_Item(0).getShapes())                                   
{                                                                                                       
    if (shape.getText() != null && shape.getText().contains("© Aspose 2016"))                           
    {                                                                                                   
        shape.setText("© GroupDocs 2017");                                                              
    }                                                                                                   
}                                                                                                       
                                                                                                        
// Save changes                                                                                         
watermarker.save("diagram.vsdx");                                                             
                                                                                                        
watermarker.close();                                                                                    
```

### Replacing text for particular shapes with formatted text

You can also replace the text with a formatted text as shown in the following code sample.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramReplaceTextWithFormatting**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                                                                  
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx"                                   
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                                                            
                                                                                                                                            
DiagramContent content = watermarker.getContent(DiagramContent.class);                                                                      
for (DiagramShape shape : content.getPages().get_Item(0).getShapes())                                                                       
{                                                                                                                                           
    if (shape.getText() != null && shape.getText().contains("© Aspose 2016"))                                                               
    {                                                                                                                                       
        shape.getFormattedTextFragments().clear();                                                                                          
        shape.getFormattedTextFragments().add("© GroupDocs 2017", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                                       
}                                                                                                                                           
                                                                                                                                            
// Save changes                                                                                                                             
watermarker.save("diagram.vsdx");                                                                                                 
                                                                                                                                            
watermarker.close();                                                                                                                        
```

### Replacing shape image

Since version 18.1. GroupDocs.Watermark also allows you to replace the image of particular shapes as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramReplaceShapeImage**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                                
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx" 
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                          
                                                                                                          
DiagramContent content = watermarker.getContent(DiagramContent.class);                                    
for (DiagramShape shape : content.getPages().get_Item(0).getShapes())                                     
{                                                                                                         
    if (shape.getImage() != null)                                                                         
    {                                                                                                     
        File imageFile = new File("test.png");                                                     
        byte[] imageBytes = new byte[(int) imageFile.length()];                                           
        InputStream imageInputStream = new FileInputStream(imageFile);                                    
        imageInputStream.read(imageBytes);                                                                
        imageInputStream.close();                                                                         
                                                                                                          
        shape.setImage(new DiagramWatermarkableImage(imageBytes));                                        
    }                                                                                                     
}                                                                                                         
                                                                                                          
// Save changes                                                                                           
watermarker.save("diagram.vsdx");                                                               
                                                                                                          
watermarker.close();                                                                                      
```

## Working with headers and footers

### Extracting information about all headers and footers

The API allows you to extract information about all the headers and footers in a Visio document using following code.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramGetHeaderFooterInformation**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx"
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                         
                                                                                                         
DiagramContent content = watermarker.getContent(DiagramContent.class);                                   
                                                                                                         
// Get header&footer font settings                                                                       
System.out.println(content.getHeaderFooter().getFont().getFamilyName());                                 
System.out.println(content.getHeaderFooter().getFont().getSize());                                       
System.out.println(content.getHeaderFooter().getFont().getBold());                                       
System.out.println(content.getHeaderFooter().getFont().getItalic());                                     
System.out.println(content.getHeaderFooter().getFont().getUnderline());                                  
System.out.println(content.getHeaderFooter().getFont().getStrikeout());                                  
                                                                                                         
// Get text contained in headers&footers                                                                 
System.out.println(content.getHeaderFooter().getHeaderLeft());                                           
System.out.println(content.getHeaderFooter().getHeaderCenter());                                         
System.out.println(content.getHeaderFooter().getHeaderRight());                                          
System.out.println(content.getHeaderFooter().getFooterLeft());                                           
System.out.println(content.getHeaderFooter().getFooterCenter());                                         
System.out.println(content.getHeaderFooter().getFooterRight());                                          
                                                                                                         
// Get text color                                                                                        
System.out.println(content.getHeaderFooter().getTextColor().toArgb());                                   
                                                                                                         
// Get header&footer margins                                                                             
System.out.println(content.getHeaderFooter().getFooterMargin());                                         
System.out.println(content.getHeaderFooter().getHeaderMargin());                                         
                                                                                                         
watermarker.close();                                                                                     
```

### Removing or replacing a particular header and footer

Following code sample shows how to remove and replace a particular header and footer in a Visio document.

**advanced\_usage.add\_watermarks\_to\_diagrams.DiagramRemoveOrReplaceHeaderFooter**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\diagram.vsdx"
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);                         
                                                                                                         
DiagramContent content = watermarker.getContent(DiagramContent.class);                                   
                                                                                                         
// Remove header                                                                                         
content.getHeaderFooter().setHeaderCenter(null);                                                         
                                                                                                         
// Replace footer                                                                                        
content.getHeaderFooter().setFooterCenter("Footer center");                                              
content.getHeaderFooter().getFont().setSize(19);                                                         
content.getHeaderFooter().getFont().setFamilyName("Calibri");                                            
content.getHeaderFooter().setTextColor(Color.getRed());                                                  
                                                                                                         
watermarker.save("diagram.vsdx");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

---

## Existing objects in diagrams

Path: /watermark/net/existing-objects-in-diagram-document/

The watermarks in Visio documents are usually represented by shapes. But sometimes document headers&footers can also be used to display text that can be considered as the watermark. GroupDocs.Watermark API allows you to find and remove watermarks of both types in Visio document.

## Removing watermark from a particular page

Removing watermark from a particular page of a Visio document using GroupDocs.Watermark consists of following steps.

1. Load the document
2. Create and initialize image/text search criteria
3. [Find](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.contentpart/search/methods/1) possible watermarks
4. Remove found watermarks
5. Save the document

Following code sample shows how to remove watermark from a particular page.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramRemoveWatermark**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();

    // Initialize search criteria
    ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");
    TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");

    // Call FindWatermarks method for the first page
    PossibleWatermarkCollection possibleWatermarks = content.Pages[0]
        .Search(textSearchCriteria.Or(imageSearchCriteria));

    // Remove all found watermarks
    possibleWatermarks.Clear();
    watermarker.Save("diagram.vsdx");
}
```

## Working with shapes

### Extracting information about all shapes

*[Search](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.contentpart/search/methods/1)* method searches watermarks of all mentioned types, but in some cases, it's necessary to analyze only one type of Visio objects. Following code sample shows how to get information about all the shapes in a Visio document.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramGetShapesInformation**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();
    foreach (DiagramPage page in content.Pages)
    {
        foreach (DiagramShape shape in page.Shapes)
        {
            if (shape.Image != null)
            {
                Console.WriteLine(shape.Image.Width);
                Console.WriteLine(shape.Image.Height);
                Console.WriteLine(shape.Image.GetBytes().Length);
            }

            Console.WriteLine(shape.Name);
            Console.WriteLine(shape.X);
            Console.WriteLine(shape.Y);
            Console.WriteLine(shape.Width);
            Console.WriteLine(shape.Height);
            Console.WriteLine(shape.RotateAngle);
            Console.WriteLine(shape.Text);
            Console.WriteLine(shape.Id);
        }
    }
}
```

### Removing a particular shape

You can also remove a particular shape from a page using GroupDocs.Watermark API (as shown in the sample code below).

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramRemoveShape()**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();

    // Remove shape by index
    content.Pages[0].Shapes.RemoveAt(0);

    // Remove shape by reference
    content.Pages[0].Shapes.Remove(content.Pages[0].Shapes[0]);

    watermarker.Save("diagram.vsdx");
}
```

### Removing shapes with particular text formatting

You can also find and remove the shapes with a particular text formatting from a Visio document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramRemoveTextShapesWithParticularTextFormatting**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();
    foreach (DiagramPage page in content.Pages)
    {
        for (int i = page.Shapes.Count - 1; i >= 0; i--)
        {
            foreach (FormattedTextFragment fragment in page.Shapes[i].FormattedTextFragments)
            {
                if (fragment.ForegroundColor == Color.Red && fragment.Font.FamilyName == "Arial")
                {
                    page.Shapes.RemoveAt(i);
                    break;
                }
            }
        }
    }

    watermarker.Save("diagram.vsdx");
}
```

### Removing hyperlink associated with a particular shape

Using GroupDocs.Watermark for .NET, you can also remove hyperlink associated with a particular shape inside a Visio document. Use following code sample to achieve this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramRemoveHyperlinks**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();
    DiagramShape shape = content.Pages[0].Shapes[0];
    for (int i = shape.Hyperlinks.Count - 1; i >= 0; i--)
    {
        if (shape.Hyperlinks[i].Address.Contains("http://someurl.com"))
        {
            shape.Hyperlinks.RemoveAt(i);
        }
    }

    watermarker.Save("diagram.vsdx");
}
```

### Replacing text for particular shapes

Since version 18.1. GroupDocs.Watermark allows you to replace the text for particular shapes. Following code sample shows how to replace shapes' text.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramReplaceTextForParticularShapes**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();
    foreach (DiagramShape shape in content.Pages[0].Shapes)
    {
        if (shape.Text != null && shape.Text.Contains("© Aspose 2016"))
        {
            shape.Text = "© GroupDocs 2017";
        }
    }

    // Save changes
    watermarker.Save("diagram.vsdx");
}
```

### Replacing text for particular shapes with formatted text

You can also replace the text with a formatted text as shown in the following code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramReplaceTextWithFormatting**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();
    foreach (DiagramShape shape in content.Pages[0].Shapes)
    {
        if (shape.Text != null && shape.Text.Contains("© Aspose 2016"))
        {
            shape.FormattedTextFragments.Clear();
            shape.FormattedTextFragments.Add("© GroupDocs 2017", 
                new Font("Calibri", 19, FontStyle.Bold), Color.Red, Color.Aqua);
        }
    }

    // Save changes
    watermarker.Save("diagram.vsdx");
}
```

### Replacing shape image

Since version 18.1. GroupDocs.Watermark also allows you to replace the image of particular shapes as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramReplaceShapeImage**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();
    foreach (DiagramShape shape in content.Pages[0].Shapes)
    {
        if (shape.Image != null)
        {
            shape.Image = new DiagramWatermarkableImage(File.ReadAllBytes("test.png"));
        }
    }

    // Save changes
    watermarker.Save("diagram.vsdx");
}
```

## Working with headers and footers

### Extracting information about all headers and footers

The API allows you to extract information about all the headers&footers in a Visio document using following code.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramGetHeaderFooterInformation**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();

    // Get header&footer font settings
    Console.WriteLine(content.HeaderFooter.Font.FamilyName);
    Console.WriteLine(content.HeaderFooter.Font.Size);
    Console.WriteLine(content.HeaderFooter.Font.Bold);
    Console.WriteLine(content.HeaderFooter.Font.Italic);
    Console.WriteLine(content.HeaderFooter.Font.Underline);
    Console.WriteLine(content.HeaderFooter.Font.Strikeout);

    // Get text contained in headers&footers
    Console.WriteLine(content.HeaderFooter.HeaderLeft);
    Console.WriteLine(content.HeaderFooter.HeaderCenter);
    Console.WriteLine(content.HeaderFooter.HeaderRight);
    Console.WriteLine(content.HeaderFooter.FooterLeft);
    Console.WriteLine(content.HeaderFooter.FooterCenter);
    Console.WriteLine(content.HeaderFooter.FooterRight);

    // Get text color
    Console.WriteLine(content.HeaderFooter.TextColor.ToArgb());

    // Get header&footer margins
    Console.WriteLine(content.HeaderFooter.FooterMargin);
    Console.WriteLine(content.HeaderFooter.HeaderMargin);
}
```

### Removing or replacing a particular header and footer

Following code sample shows how to remove and replace a particular header&footer in a Visio document.

**AdvancedUsage.AddingWatermarks.AddWatermarksToDiagrams.DiagramRemoveOrReplaceHeaderFooter**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\diagram.vsdx"
using (Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions))
{
    DiagramContent content = watermarker.GetContent<DiagramContent>();

    // Remove header
    content.HeaderFooter.HeaderCenter = null;

    // Replace footer
    content.HeaderFooter.FooterCenter = "Footer center";
    content.HeaderFooter.Font.Size = 19;
    content.HeaderFooter.Font.FamilyName = "Calibri";
    content.HeaderFooter.TextColor = Color.Red;

    watermarker.Save("diagram.vsdx");
}
```

---

## Existing objects in diagrams

Path: /watermark/python-net/existing-objects-in-diagram-document/


Watermarks in Visio documents are usually shapes; sometimes headers and footers also contain text considered as watermark. You can find and remove watermarks of both types.

## Removing watermark from a particular page

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx
import groupdocs.watermark.search.searchcriteria as gws_sc

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    image_criteria = gws_sc.ImageDctHashSearchCriteria("logo.png")
    text_criteria = gws_sc.TextSearchCriteria("Company Name")
    possible = content.pages[0].search(text_criteria.or_(image_criteria))
    possible.clear()
    watermarker.save("diagram.vsdx")
```

## Working with shapes

### Extracting information about all shapes

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    for page in content.pages:
        for shape in page.shapes:
            if shape.image is not None:
                print(shape.image.width)
                print(shape.image.height)
                print(len(shape.image.get_bytes()))
            print(shape.name)
            print(shape.x)
            print(shape.y)
            print(shape.width)
            print(shape.height)
            print(shape.rotate_angle)
            print(shape.text)
            print(shape.id)
```

### Removing a particular shape

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    content.pages[0].shapes.remove_at(0)
    content.pages[0].shapes.remove(content.pages[0].shapes[0])
    watermarker.save("diagram.vsdx")
```

### Removing shapes with particular text formatting

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx
import groupdocs.watermark.watermarks as gww

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    for page in content.pages:
        for i in range(page.shapes.count - 1, -1, -1):
            for fragment in page.shapes[i].formatted_text_fragments:
                if fragment.foreground_color == gww.Color.red and fragment.font.family_name == "Arial":
                    page.shapes.remove_at(i)
                    break
    watermarker.save("diagram.vsdx")
```

### Removing hyperlink associated with a particular shape

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    shape = content.pages[0].shapes[0]
    for i in range(shape.hyperlinks.count - 1, -1, -1):
        if "http://someurl.com" in shape.hyperlinks[i].address:
            shape.hyperlinks.remove_at(i)
    watermarker.save("diagram.vsdx")
```

### Replacing text for particular shapes

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    for shape in content.pages[0].shapes:
        if shape.text and "© Aspose 2016" in shape.text:
            shape.text = "© GroupDocs 2017"
    watermarker.save("diagram.vsdx")
```

### Replacing text for particular shapes with formatted text

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx
import groupdocs.watermark.watermarks as gww

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    for shape in content.pages[0].shapes:
        if shape.text and "© Aspose 2016" in shape.text:
            shape.formatted_text_fragments.clear()
            shape.formatted_text_fragments.add(
                "© GroupDocs 2017", gww.Font("Calibri", 19.0, gww.FontStyle.BOLD), gww.Color.red, gww.Color.aqua
            )
    watermarker.save("diagram.vsdx")
```

### Replacing shape image

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    for shape in content.pages[0].shapes:
        if shape.image is not None:
            with open("test.png", "rb") as f:
                shape.image = gwc_vsdx.DiagramWatermarkableImage(f.read())
    watermarker.save("diagram.vsdx")
```

## Working with headers and footers

### Extracting information about all headers and footers

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    print(content.header_footer.font.family_name)
    print(content.header_footer.font.size)
    print(content.header_footer.font.bold)
    print(content.header_footer.font.italic)
    print(content.header_footer.font.underline)
    print(content.header_footer.font.strikeout)
    print(content.header_footer.header_left)
    print(content.header_footer.header_center)
    print(content.header_footer.header_right)
    print(content.header_footer.footer_left)
    print(content.header_footer.footer_center)
    print(content.header_footer.footer_right)
    print(content.header_footer.text_color.to_argb())
    print(content.header_footer.footer_margin)
    print(content.header_footer.header_margin)
```

### Removing or replacing a particular header and footer

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.diagram as gwc_vsdx
import groupdocs.watermark.watermarks as gww

load_options = gw.DiagramLoadOptions()
with gw.Watermarker("diagram.vsdx", load_options) as watermarker:
    content = watermarker.get_content(gwc_vsdx.DiagramContent)
    content.header_footer.header_center = None
    content.header_footer.footer_center = "Footer center"
    content.header_footer.font.size = 19
    content.header_footer.font.family_name = "Calibri"
    content.header_footer.text_color = gww.Color.red
    watermarker.save("diagram.vsdx")
```



---

## Existing objects in word processing document

Path: /watermark/net/existing-objects-in-word-processing-document/

Watermarks in Word documents are usually represented by shapes. Using GroupDocs.Watermark API you can easily remove shape of any type from any level of document structure.

## Removing watermark from a particular section

Removing watermark from a particular section of a Word document using GroupDocs.Watermark consists of following steps.

1. Load the document
2. Create and initialize [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/imagesearchcriteria) or [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textsearchcriteria) search criteria  
3. [Find](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents/contentpart/methods/search) possible watermarks
4. Remove found watermarks
5. Save the document

Following code sample shows how to remove watermark from a particular section.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingRemoveWatermarkFromSection**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    // Initialize search criteria
    ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");
    TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");

    // Call Search method for the section
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
    PossibleWatermarkCollection possibleWatermarks = content.Sections[0].Search(textSearchCriteria.Or(imageSearchCriteria));

    // Remove all found watermarks
    for (int i = possibleWatermarks.Count - 1; i >= 0; i--)
    {
        possibleWatermarks.RemoveAt(i);
    }

    watermarker.Save("document.docx");
}
```

### Search for particular header or footer  

You can also call *[Search](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents/contentpart/methods/search)* method for a particular [header or footer](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingheaderfooter) as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingFindWatermarkInHeaderFooter**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    // Initialize search criteria
    ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");
    TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");

    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
    PossibleWatermarkCollection possibleWatermarks = content.Sections[0]
        .HeadersFooters[OfficeHeaderFooterType.HeaderPrimary]
        .Search(textSearchCriteria.Or(imageSearchCriteria));
    // Remove all found watermarks
    for (int i = possibleWatermarks.Count - 1; i >= 0; i--)
    {
        possibleWatermarks.RemoveAt(i);
    }

    watermarker.Save("document.docx");
}
```

## Extracting information about all shapes in a word document

*[Search](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/search)* method returns a collection of*[PossibleWatermark](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search/possiblewatermark)* instances for all document types. But in some cases, it's necessary to get more information about Word shapes than common API offers. GroupDocs.Watermark enables you to extract the information about all the [shapes](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingsection/properties/shapes) as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingGetShapesInformation**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
    foreach (WordProcessingSection section in content.Sections)
    {
        foreach (WordProcessingShape shape in section.Shapes)
        {
            if (shape.HeaderFooter != null)
            {
                Console.WriteLine("In header/footer");
            }

            Console.WriteLine(shape.ShapeType);
            Console.WriteLine(shape.Width);
            Console.WriteLine(shape.Height);
            Console.WriteLine(shape.IsWordArt);
            Console.WriteLine(shape.RotateAngle);
            Console.WriteLine(shape.AlternativeText);
            Console.WriteLine(shape.Name);
            Console.WriteLine(shape.X);
            Console.WriteLine(shape.Y);
            Console.WriteLine(shape.Text);

            if (shape.Image != null)
            {
                Console.WriteLine(shape.Image.Width);
                Console.WriteLine(shape.Image.Height);
                Console.WriteLine(shape.Image.GetBytes().Length);
            }

            Console.WriteLine(shape.HorizontalAlignment);
            Console.WriteLine(shape.VerticalAlignment);
            Console.WriteLine(shape.RelativeHorizontalPosition);
            Console.WriteLine(shape.RelativeVerticalPosition);
        }
    }
}
```

## Working with shape types

You can extract information about the existing shapes of particular types. The *[GroupDocs.Watermark.Contents.WordProcessing.WordProcessingShapeType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshapetype)* enum is available to check the types possibly available shapes.

The following code snippet demonstrates the usage of *[WordProcessingShapeType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshapetype)* enum.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingShapeTypeUsage**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
    foreach (WordProcessingSection section in content.Sections)
    {
        foreach (WordProcessingShape shape in section.Shapes)
        {
            //Check for Diagonal Corners Rounded shapes
            if (shape.ShapeType == WordProcessingShapeType.DiagonalCornersRounded)
            {
                Console.WriteLine("Diagonal Corners Rounded shape found");

                //Write text on all Diagonal Corners Rounded shapes
                shape.FormattedTextFragments.Add("I am Diagonal Corner Rounded", new Font("Calibri", 8, FontStyle.Bold), Color.Red, Color.Aqua);
            }
        }
    }

    watermarker.Save("document.docx");
}
```

## Removing a particular shape

You can also remove a particular [shape](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape) from a Word document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingRemoveShape**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();

    // Remove shape by index
    content.Sections[0].Shapes.RemoveAt(0);

    // Remove shape by reference
    content.Sections[0].Shapes.Remove(content.Sections[0].Shapes[0]);

    watermarker.Save("document.docx");
}
```

## Removing shapes with particular text formatting

You can also find and remove the shapes with a particular [text formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/formattedtextfragments) from a Word document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingRemoveShapesWithParticularTextFormatting**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
    foreach (WordProcessingSection section in content.Sections)
    {
        for (int i = section.Shapes.Count - 1; i >= 0; i--)
        {
            foreach (FormattedTextFragment fragment in section.Shapes[i].FormattedTextFragments)
            {
                if (fragment.ForegroundColor == Color.Red && fragment.Font.FamilyName == "Arial")
                {
                    section.Shapes.RemoveAt(i);
                    break;
                }
            }
        }
    }

    watermarker.Save("document.docx");
}
```

## Removing or replacing hyperlink associated with a particular shape

Using GroupDocs.Watermark for .NET, you can also remove or replace [hyperlink](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/hyperlink) associated with a particular shape inside a Word document. Use following code sample to achieve this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingRemoveHyperlinks**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();

    // Replace hyperlink
    content.Sections[0].Shapes[0].Hyperlink = "https://www.groupdocs.com/";

    // Remove hyperlink
    content.Sections[0].Shapes[1].Hyperlink = null;

    watermarker.Save("document.docx");
}
```

## Replacing text for particular shapes

### Replacing shape's text

GroupDocs.Watermark supports replacing [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/text) for particular shapes in a Word document. Following code sample shows the usage of this feature.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingReplaceTextForParticularShape**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();

    // Set shape's text
    foreach (WordProcessingShape shape in content.Sections[0].Shapes)
    {
        if (shape.Text.Contains("Some text"))
        {
            shape.Text = "Another text";
        }
    }

    // Save document
    watermarker.Save("document.docx");
}
```

### Replacing shape's text with formatted text

You can also replace the [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/text) of the shapes with [formatted text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/formattedtextfragments) as shown in the following code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingReplaceShapeTextWithFormattedText**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();

    // Set shape's text
    foreach (WordProcessingShape shape in content.Sections[0].Shapes)
    {
        if (shape.Text.Contains("Some text"))
        {
            shape.FormattedTextFragments.Clear();
            shape.FormattedTextFragments.Add("Another text", new Font("Calibri", 19, FontStyle.Bold), Color.Red, Color.Aqua);
        }
    }

    // Save document
    watermarker.Save("document.docx");
}
```

## Replacing shape's image

GroupDocs.Watermark also allows you to replace the [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/image) of the particular shapes in a Word document as shown in the following code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingReplaceShapeImage**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();

    // Set shape image
    foreach (WordProcessingShape shape in content.Sections[0].Shapes)
    {
        if (shape.Image != null)
        {
            shape.Image = new WordProcessingWatermarkableImage(File.ReadAllBytes("test.png"));
        }
    }

    // Save document
    watermarker.Save("document.docx");
}
```

## Modifying shape properties

GroupDocs.Watermark also provides the feature of modifying properties ([AlternativeText](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/alternativetext), [RotateAngle](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/rotateangle), [X](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/x), [Y](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/y), [Height](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/height), [Width](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/width) or [BehindText](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingshape/properties/behindtext)) of particular shapes in a Word document. Following code sample shows how to use this feature.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingModifyShapeProperties**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();

    // Change shape properties
    foreach (WordProcessingShape shape in content.Sections[0].Shapes)
    {
        if (shape.Text.Contains("Some text"))
        {
            shape.AlternativeText = "watermark";
            shape.RotateAngle = 30;
            shape.X = 200;
            shape.Y = 200;
            shape.Height = 100;
            shape.Width = 400;
            shape.BehindText = false;
        }
    }

    // Save document
    watermarker.Save("document.docx");
}
```


---

## Existing objects in word processing document

Path: /watermark/python-net/existing-objects-in-word-processing-document/


Watermarks in Word documents are usually represented by shapes. Using GroupDocs.Watermark you can remove shapes of any type from any level of the document structure, or inspect and modify them.

## Removing watermark from a particular section
This sample searches a section for shapes matching image or text criteria and removes the found watermarks.

Steps:

1. Load the document
2. Create and initialize image or text search criteria
3. Find possible watermarks
4. Remove found watermarks
5. Save the document

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp
import groupdocs.watermark.search.searchcriteria as gws_sc

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    image_criteria = gws_sc.ImageDctHashSearchCriteria("logo.png")
    text_criteria = gws_sc.TextSearchCriteria("Company Name")

    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    possible = content.sections[0].search(text_criteria.or_(image_criteria))

    for i in range(len(possible) - 1, -1, -1):
        possible.remove_at(i)

    watermarker.save("document.docx")
```

### Search for particular header or footer
This sample narrows the search to a specific header or footer and removes matching shapes.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp
import groupdocs.watermark.search.searchcriteria as gws_sc
import groupdocs.watermark.common as gwc

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    image_criteria = gws_sc.ImageDctHashSearchCriteria("logo.png")
    text_criteria = gws_sc.TextSearchCriteria("Company Name")

    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    header_footer = content.sections[0].headers_footers[gwc.OfficeHeaderFooterType.HEADER_PRIMARY]
    possible = header_footer.search(text_criteria.or_(image_criteria))

    for i in range(len(possible) - 1, -1, -1):
        possible.remove_at(i)

    watermarker.save("document.docx")
```

## Extracting information about all shapes in a Word document
This sample iterates all shapes across sections and prints type, geometry, alignment, position, text, and image details.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for section in content.sections:
        for shape in section.shapes:
            if shape.header_footer is not None:
                print("In header/footer")

            print(shape.shape_type)
            print(shape.width)
            print(shape.height)
            print(shape.is_word_art)
            print(shape.rotate_angle)
            print(shape.alternative_text)
            print(shape.name)
            print(shape.x)
            print(shape.y)
            print(shape.text)

            if shape.image is not None:
                print(shape.image.width)
                print(shape.image.height)
                print(len(shape.image.get_bytes()))

            print(shape.horizontal_alignment)
            print(shape.vertical_alignment)
            print(shape.relative_horizontal_position)
            print(shape.relative_vertical_position)
```

## Working with shape types
This sample detects specific shape types and modifies their formatted text fragments if matched.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for section in content.sections:
        for shape in section.shapes:
            if shape.shape_type == gwc_wp.WordProcessingShapeType.DIAGONAL_CORNERS_ROUNDED:
                print("Diagonal Corners Rounded shape found")
                shape.formatted_text_fragments.add(
                    "I am Diagonal Corner Rounded",
                    gww.Font("Calibri", 8.0, gww.FontStyle.BOLD),
                    gww.Color.red,
                    gww.Color.aqua,
                )

    watermarker.save("document.docx")
```

## Removing a particular shape
This sample removes shapes by index and by reference within a section, then saves the document.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)

    # Remove shape by index
    content.sections[0].shapes.remove_at(0)

    # Remove shape by reference
    shp = content.sections[0].shapes[0]
    content.sections[0].shapes.remove(shp)

    watermarker.save("document.docx")
```

## Removing shapes with particular text formatting
This sample deletes shapes whose formatted text matches a condition (for example, red Arial fragments).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp
import groupdocs.watermark.watermarks as gww

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for section in content.sections:
        for i in range(section.shapes.count - 1, -1, -1):
            for fragment in section.shapes[i].formatted_text_fragments:
                if fragment.foreground_color == gww.Color.red and fragment.font.family_name == "Arial":
                    section.shapes.remove_at(i)
                    break

    watermarker.save("document.docx")
```

## Removing or replacing hyperlink associated with a particular shape
This sample updates or clears hyperlinks assigned to shapes.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)

    # Replace hyperlink
    content.sections[0].shapes[0].hyperlink = "https://www.groupdocs.com/"

    # Remove hyperlink
    content.sections[0].shapes[1].hyperlink = None

    watermarker.save("document.docx")
```

## Replacing text for particular shapes
These samples show how to replace shape text either plainly or using formatted text fragments.

### Replacing shape's text
This sample finds shapes containing target text and replaces it with new plain text.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for shape in content.sections[0].shapes:
        if "Some text" in (shape.text or ""):
            shape.text = "Another text"

    watermarker.save("document.docx")
```

### Replacing shape's text with formatted text
This sample clears existing formatted fragments and inserts new text with specific font, style, and colors.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp
import groupdocs.watermark.watermarks as gww

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for shape in content.sections[0].shapes:
        if "Some text" in (shape.text or ""):
            shape.formatted_text_fragments.clear()
            shape.formatted_text_fragments.add(
                "Another text",
                gww.Font("Calibri", 19.0, gww.FontStyle.BOLD),
                gww.Color.red,
                gww.Color.aqua,
            )

    watermarker.save("document.docx")
```

## Replacing shape's image
This sample replaces the raster image content of shapes with a new image loaded from disk.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for shape in content.sections[0].shapes:
        if shape.image is not None:
            with open("test.png", "rb") as f:
                img_bytes = f.read()
            shape.image = gwc_wp.WordProcessingWatermarkableImage(img_bytes)

    watermarker.save("document.docx")
```

## Modifying shape properties
This sample updates shape properties like alternative text, rotation, position, layering, width, and height.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for shape in content.sections[0].shapes:
        if "Some text" in (shape.text or ""):
            shape.alternative_text = "watermark"
            shape.rotate_angle = 30
            shape.x = 200
            shape.y = 200
            shape.height = 100
            shape.width = 400
            shape.behind_text = False

    watermarker.save("document.docx")
```



---

## Exporting metadata properties

Path: /metadata/java/exporting-metadata-properties/

This example demonstrates how to export metadata properties to an Excel workbook. For more information please refer to the [ExportManager](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.export/ExportManager) class.

**advanced\_usage.ExportingMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDoc)) {
	RootMetadataPackage root = metadata.getRootPackage();
	if (root != null) {
		// Initialize the export manager with the root metadata package to export the whole metadata tree
		ExportManager manager = new ExportManager(root);
		manager.export(Constants.OutputXls, ExportFormat.Xls);
	}
} 
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Exporting metadata properties

Path: /metadata/net/exporting-metadata-properties/

This example demonstrates how to export metadata properties to an Excel workbook. For more information please refer to the [ExportManager](https://reference.groupdocs.com/metadata/net/groupdocs.metadata.export/exportmanager) class.

**AdvancedUsage.ExportingMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(@"D:\input.doc"))
{
	RootMetadataPackage root = metadata.GetRootPackage();
	if (root != null)
	{
		// Initialize the export manager with the root metadata package to export the whole metadata tree
		ExportManager manager = new ExportManager(root);
		manager.Export(@"D:\export.xls", ExportFormat.Xls);
	}
} 
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Exporting metadata properties

Path: /metadata/python-net/exporting-metadata-properties/

This example demonstrates how to export metadata properties to an Excel workbook. For more information please refer to the `ExportManager` class.

**advanced_usage.exporting_metadata_properties**


```python
def run():
    with gm.Metadata(r"D:\\input.doc") as metadata:
        root = metadata.get_root_package()
        if root is not None:
            # Initialize the export manager with the root metadata package to export the whole metadata tree
            manager = gm.export.ExportManager(root)
            manager.export(r"D:\\export.xls", gm.export.ExportFormat.XLS)
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Extract barcodes from document

Path: /parser/java/extract-barcodes-from-document/


GroupDocs.Parser provides the functionality to extract barcodes from documents by the [GetBarcodes](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getBarcodes()) method:

```java
Iterable<PageBarcodeArea> getBarcodes()
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [Value](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea#getValue()) | A string value that represents a value of the barcode page area. |
| [CodeTypeName](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea#getCodeTypeName()) | A string value than represents a type name of the barcode. |

Here are the steps to extract all barcodes from the whole document:

- Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser) object for the initial document;
- Check if the document supports barcodes extraction;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getBarcodes()) method and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to extract barcodes from a document:

```java
// Create an instance of Parser class
try(Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
	// Check if the document supports barcodes extraction
	if (!parser.getFeatures().isBarcodes()) {
		System.out.println("Document doesn't support barcodes extraction.");
		return;
	}

	// Extract barcodes from the document.
	Iterable<PageBarcodeArea> barcodes = parser.getBarcodes();

	// Iterate over barcodes
	for(PageBarcodeArea barcode : barcodes)
	{
		// Print the page index
		System.out.println("Page: " + barcode.getPage().getIndex());
		// Print the barcode value
		System.out.println("Value: " + barcode.getValue());
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract barcodes from document

Path: /parser/net/extract-barcodes-from-document/


GroupDocs.Parser provides the functionality to extract barcodes from documents by the [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/getbarcodes) method:

```csharp
IEnumerable<PageBarcodeArea> GetBarcodes();
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [Value](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/properties/value) | A string value that represents a value of the barcode page area. |
| [CodeTypeName](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/properties/codetypename) | A string value than represents a type name of the barcode. |
| [Confidence](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/confidence/) | The level of confidence of the parsered barcode. |
| [Angle](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/angle/) | The angle of the barcode. |

Here are the steps to extract all barcodes from the whole document:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
- Check if the document supports barcodes extraction;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/getbarcodes) method and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to extract barcodes from a document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Check if the document supports barcodes extraction
    if (!parser.Features.Barcodes)
    {
        Console.WriteLine("Document doesn't support barcodes extraction.");
        return;
    }

    // Extract barcodes from the document.
    IEnumerable<PageBarcodeArea> barcodes = parser.GetBarcodes();

    // Iterate over barcodes
    foreach (PageBarcodeArea barcode in barcodes)
    {
        // Print the page index
        Console.WriteLine("Page: " + barcode.Page.Index.ToString());
        // Print the barcode value
        Console.WriteLine("Value: " + barcode.Value);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online Barcode Scanner App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to scan barcode from your files or mobile phone camera with our free online [GroupDocs Scanner App](https://products.groupdocs.app/scanner/scan-barcode) which is build with GroupDocs.Parser .Net.
---

## Extract data from ZIP archives

Path: /parser/python-net/extract-data-from-zip-archives/


GroupDocs.Parser provides functionality to extract data from ZIP archives and other container formats, allowing you to iterate through archive contents and parse individual files.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample ZIP archives for testing
- Understanding of container/archive concepts

## Detect and iterate through archive items

To iterate through files in a ZIP archive:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./archive.zip") as parser:
    # Get container items (files in the archive)
    attachments = parser.get_container()
    
    # Check if container extraction is supported
    if attachments is None:
        print("Container extraction isn't supported")
    else:
        # Iterate over attachments
        for idx, attachment in enumerate(attachments):
            print(f"
File {idx + 1}:")
            print(f"  Name: {attachment.name}")
            print(f"  Size: {attachment.size} bytes")
            print(f"  File Path: {attachment.file_path}")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns a collection of container items representing files in the ZIP archive, or `None` if container extraction is not supported.

## Extract text from files in ZIP archive

To extract text from specific files within an archive:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class for the archive
with Parser("./documents.zip") as parser:
    # Get container items
    attachments = parser.get_container()
    
    if attachments is None:
        print("Container extraction not supported")
    else:
        # Iterate over attachments
        for attachment in attachments:
            print(f"
Processing: {attachment.name}")
            
            try:
                # Get parser for the attachment
                with attachment.open_parser() as file_parser:
                    # Extract text from the file
                    text_reader = file_parser.get_text()
                    
                    if text_reader:
                        text = text_reader
                        print(f"  Extracted {len(text)} characters")
                        print(f"  Preview: {text[:100]}...")
                    else:
                        print(f"  Text extraction not supported for this file")
            
            except Exception as e:
                print(f"  Error: {e}")
```

{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [documents.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives/documents.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Opens each file in the archive and extracts text content using a nested parser.

## Detect file type of container items

To identify file types within an archive:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("mixed_files.zip") as parser:
    # Get container items
    attachments = parser.get_container()
    
    if attachments:
        print("Archive Contents:\n")
        
        # Group files by type
        files_by_type = {}
        
        for attachment in attachments:
            # Get file info
            try:
                with attachment.open_parser() as file_parser:
                    info = file_parser.get_document_info()
                    file_type = info.file_type.extension if info and info.file_type else "unknown"
                    
                    if file_type not in files_by_type:
                        files_by_type[file_type] = []
                    
                    files_by_type[file_type].append(attachment.name)
            
            except:
                if "unknown" not in files_by_type:
                    files_by_type["unknown"] = []
                files_by_type["unknown"].append(attachment.name)
        
        # Print summary
        for file_type, files in sorted(files_by_type.items()):
            print(f"
{file_type.upper()} files ({len(files)}):")
            for filename in files:
                print(f"  - {filename}")
```

{{< /tab >}}
{{< tab "mixed_files.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [mixed_files.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives/mixed_files.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Categorizes archive contents by file type.

## Extract specific files from archive

To extract only specific files based on criteria:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

def extract_specific_files(archive_path, output_dir, extensions=None):
    """
    Extract specific files from ZIP archive based on extension.
    
    Args:
        archive_path: Path to ZIP archive
        output_dir: Directory to save extracted files
        extensions: List of extensions to extract (e.g., ['.pdf', '.docx'])
    """
    os.makedirs(output_dir, exist_ok=True)
    
    with Parser(archive_path) as parser:
        attachments = parser.get_container()
        
        if not attachments:
            print("No files found in archive")
            return
        
        extracted_count = 0
        
        for attachment in attachments:
            # Check extension filter
            if extensions:
                file_ext = os.path.splitext(attachment.name)[1].lower()
                if file_ext not in extensions:
                    continue
            
            print(f"Extracting: {attachment.name}")
            
            try:
                # Open parser for the file
                with attachment.open_parser() as file_parser:
                    # Extract text
                    text_reader = file_parser.get_text()
                    
                    if text_reader:
                        # Save to output directory
                        output_file = os.path.join(output_dir, f"{attachment.name}.txt")
                        
                        with open(output_file, 'w', encoding='utf-8') as f:
                            f.write(text_reader)
                        
                        extracted_count += 1
                        print(f"  Saved to: {output_file}")
            
            except Exception as e:
                print(f"  Error: {e}")
        
        print(f"
Extracted {extracted_count} files")

# Usage - extract only PDF and DOCX files
extract_specific_files("documents.zip", "extracted", ['.pdf', '.docx'])
```

{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [documents.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives/documents.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts and processes only files matching specified extensions.

## Process nested archives

To handle ZIP files within ZIP files:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def process_archive_recursively(parser, level=0):
    """
    Recursively process archives and nested archives.
    """
    indent = "  " * level
    
    # Get container items
    attachments = parser.get_container()
    
    if not attachments:
        return
    
    for attachment in attachments:
        print(f"{indent} {attachment.name} ({attachment.size} bytes)")
        
        try:
            # Open parser for the attachment
            with attachment.open_parser() as file_parser:
                # Check if it's also a container (nested archive)
                nested_attachments = file_parser.get_container()
                
                if nested_attachments:
                    print(f"{indent}  └─ [Archive - processing nested items]")
                    process_archive_recursively(file_parser, level + 2)
                else:
                    # Try to extract text
                    text_reader = file_parser.get_text()
                    if text_reader:
                        text = text_reader
                        print(f"{indent}  └─ Text: {len(text)} characters")
        
        except Exception as e:
            print(f"{indent}  └─ Error: {e}")

# Usage
print("Archive Structure:\n")
with Parser("nested_archive.zip") as parser:
    process_archive_recursively(parser)
```

{{< /tab >}}
{{< tab "nested_archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [nested_archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives/nested_archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Recursively processes nested ZIP archives, showing the complete hierarchy.

## Extract metadata from archive files

To extract metadata from files within an archive:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_archive_metadata(archive_path):
    """
    Extract metadata from all files in an archive.
    """
    results = []
    
    with Parser(archive_path) as parser:
        attachments = parser.get_container()
        
        if not attachments:
            print("No files in archive")
            return results
        
        for attachment in attachments:
            file_info = {
                'name': attachment.name,
                'size': attachment.size,
                'path': attachment.file_path
            }
            
            try:
                with attachment.open_parser() as file_parser:
                    # Get metadata
                    metadata = file_parser.get_metadata()
                    
                    if metadata:
                        file_info['metadata'] = {}
                        for item in metadata:
                            file_info['metadata'][item.name] = str(item.value)
                    
                    # Get document info
                    info = file_parser.get_document_info()
                    if info:
                        file_info['file_type'] = info.file_type.extension
                        file_info['page_count'] = info.page_count
            
            except Exception as e:
                file_info['error'] = str(e)
            
            results.append(file_info)
    
    return results

# Usage
metadata_list = extract_archive_metadata("documents.zip")

print("Archive Metadata Report:\n")
for item in metadata_list:
    print(f"File: {item['name']}")
    print(f"  Size: {item['size']} bytes")
    if 'file_type' in item:
        print(f"  Type: {item['file_type']}")
    if 'page_count' in item:
        print(f"  Pages: {item['page_count']}")
    if 'metadata' in item:
        print(f"  Metadata: {len(item['metadata'])} properties")
    print()
```

{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [documents.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives/documents.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Generates a comprehensive metadata report for all files in the archive.

## Create archive inventory

To create a detailed inventory of archive contents:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import json

def create_archive_inventory(archive_path, output_json):
    """
    Create detailed inventory of ZIP archive contents.
    """
    inventory = {
        'archive': archive_path,
        'total_files': 0,
        'total_size': 0,
        'files': []
    }
    
    with Parser(archive_path) as parser:
        attachments = parser.get_container()
        
        if attachments:
            for attachment in attachments:
                file_entry = {
                    'name': attachment.name,
                    'size': attachment.size,
                    'path': attachment.file_path,
                    'extractable': False
                }
                
                try:
                    with attachment.open_parser() as file_parser:
                        # Check if text extraction is supported
                        if file_parser.features.text:
                            text_reader = file_parser.get_text()
                            if text_reader:
                                text = text_reader
                                file_entry['extractable'] = True
                                file_entry['text_length'] = len(text)
                                file_entry['word_count'] = len(text.split())
                except:
                    pass
                
                inventory['files'].append(file_entry)
                inventory['total_size'] += attachment.size
                inventory['total_files'] += 1
    
    # Save to JSON
    with open(output_json, 'w', encoding='utf-8') as f:
        json.dump(inventory, f, indent=2, ensure_ascii=False)
    
    print(f"Inventory created: {output_json}")
    print(f"  Total files: {inventory['total_files']}")
    print(f"  Total size: {inventory['total_size']:,} bytes")
    print(f"  Extractable: {sum(1 for f in inventory['files'] if f['extractable'])}")

# Usage
create_archive_inventory("archive.zip", "inventory.json")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a JSON inventory file with detailed information about archive contents.

## Notes

- The `get_container()` method returns `None` if container extraction is not supported
- Use `open_parser()` on attachments to create a parser for individual files
- Nested archives can be processed recursively
- Each attachment has properties: `name`, `size`, and `file_path`
- The parser automatically handles nested containers (ZIP within ZIP)
- Always use context managers (`with` statements) to ensure proper resource cleanup
- Some files within archives may not support text extraction

## Related pages

- [Iterate through container items]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items" >}})
- [Detect file type of container item]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-archives/detect-file-type-of-container-item" >}})
- [Extract data from attachments]({{< ref "parser/python-net/developer-guide/basic-usage/extract-data-from-attachments-and-zip-archives" >}})


---

## Extract formatted text from document

Path: /parser/java/extract-formatted-text-from-document/

GroupDocs.Parser provides the functionality to extract a formatted text from documents by the [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method:

```java
TextReader getFormattedText(FormattedTextOptions options);
```

The method returns an instance of [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class with an extracted text. [FormattedTextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextOptions) has the following constructor:

```java
FormattedTextOptions(FormattedTextMode mode);
```

[FormattedTextMode](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/FormattedTextMode) enumeration has the following members:

| Member | Description |
| --- | --- |
| Html | HTML format. |
| Markdown | Markdown format. |
| PlainText | Plain text format. |

[TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class extends [*java.io.Reader*](http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true) and adds the following members:

| Member | Description |
| --- | --- |
| [readLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readLine()) | Reads a line of characters from the text reader and returns the data as a string. |
| [readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) | Reads all characters from the current position to the end of the text reader and returns them as one string. |

Here are the steps to extract a HTML formatted text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [FormattedTextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextOptions) with HTML text mode;
*   Call [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Check if *reader* isn't *null* (formatted text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a document text as HTML text:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Formatted text extraction isn't suppported" : reader.readToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document

Path: /parser/python-net/extract-hyperlinks-from-document/


GroupDocs.Parser provides functionality to extract hyperlinks from documents including their text, URL, and position information.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents containing hyperlinks
- Basic understanding of hyperlink structure

## Extract hyperlinks from document

To extract all hyperlinks from a document:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Check if hyperlink extraction is supported
    if not parser.features.hyperlinks:
        print("Document doesn't support hyperlink extraction")
        return
    
    # Extract hyperlinks from the document
    hyperlinks = parser.get_hyperlinks()
    
    if hyperlinks:
        # Iterate over hyperlinks
        for hyperlink in hyperlinks:
            # Print the hyperlink text
            print(f"Text: {hyperlink.text}")
            # Print the hyperlink URL
            print(f"URL: {hyperlink.url}")
            # Print page number
            print(f"Page: {hyperlink.page.index + 1}")
            print()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns a collection of `PageHyperlinkArea` objects representing all hyperlinks found in the document, or `None` if hyperlink extraction is not supported.

## Extract hyperlinks with position information

To extract hyperlinks with detailed position data:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("document.docx") as parser:
    # Check if hyperlink extraction is supported
    if not parser.features.hyperlinks:
        print("Hyperlink extraction not supported")
        return
    
    # Extract hyperlinks
    hyperlinks = parser.get_hyperlinks()
    
    if hyperlinks:
        for idx, hyperlink in enumerate(hyperlinks):
            print(f"Hyperlink {idx + 1}:")
            print(f"  Text: {hyperlink.text}")
            print(f"  URL: {hyperlink.url}")
            print(f"  Page: {hyperlink.page.index + 1}")
            print(f"  Position: ({hyperlink.rectangle.left}, {hyperlink.rectangle.top})")
            print(f"  Size: {hyperlink.rectangle.width}x{hyperlink.rectangle.height}")
            print()
```

{{< /tab >}}
{{< tab "document.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/document.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Displays comprehensive information about each hyperlink including text, URL, page number, and position coordinates.

## Extract and validate URLs

To extract hyperlinks and validate URL formats:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import re

def is_valid_url(url):
    """
    Basic URL validation.
    """
    url_pattern = re.compile(
        r'^(https?|ftp)://'  # Protocol
        r'([a-zA-Z0-9.-]+)'   # Domain
        r'(:[0-9]+)?'         # Optional port
        r'(/.*)?$'            # Optional path
    )
    return url_pattern.match(url) is not None

# Create an instance of Parser class
with Parser("webpage.html") as parser:
    if not parser.features.hyperlinks:
        print("Hyperlink extraction not supported")
        return
    
    # Extract hyperlinks
    hyperlinks = parser.get_hyperlinks()
    
    if hyperlinks:
        valid_links = []
        invalid_links = []
        
        for hyperlink in hyperlinks:
            if is_valid_url(hyperlink.url):
                valid_links.append(hyperlink)
            else:
                invalid_links.append(hyperlink)
        
        print(f"Valid hyperlinks: {len(valid_links)}")
        print(f"Invalid hyperlinks: {len(invalid_links)}")
        
        print("\nValid URLs:")
        for link in valid_links[:10]:  # Show first 10
            print(f"  {link.text} -> {link.url}")
```

{{< /tab >}}
{{< tab "webpage.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [webpage.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/webpage.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Categorizes hyperlinks into valid and invalid based on URL format validation.

## Export hyperlinks to CSV

To export hyperlinks to a CSV file:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import csv

def export_hyperlinks_to_csv(file_path, output_csv):
    """
    Extract hyperlinks and save to CSV file.
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return False
        
        hyperlinks = parser.get_hyperlinks()
        
        if not hyperlinks:
            print("No hyperlinks found")
            return False
        
        # Write to CSV
        with open(output_csv, 'w', newline='', encoding='utf-8') as csvfile:
            fieldnames = ['Text', 'URL', 'Page', 'X', 'Y', 'Width', 'Height']
            writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
            
            writer.writeheader()
            
            for hyperlink in hyperlinks:
                writer.writerow({
                    'Text': hyperlink.text or '',
                    'URL': hyperlink.url or '',
                    'Page': hyperlink.page.index + 1,
                    'X': hyperlink.rectangle.left,
                    'Y': hyperlink.rectangle.top,
                    'Width': hyperlink.rectangle.width,
                    'Height': hyperlink.rectangle.height
                })
        
        print(f"Hyperlinks exported to {output_csv}")
        return True

# Usage
export_hyperlinks_to_csv("document.pdf", "hyperlinks.csv")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "hyperlinks.csv" >}}
{{< tab-text >}}
The following sample file is used in this example: [hyperlinks.csv](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/hyperlinks.csv)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a CSV file containing all hyperlinks with their properties.

## Group hyperlinks by domain

To analyze hyperlink distribution by domain:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from urllib.parse import urlparse
from collections import defaultdict

def analyze_hyperlinks_by_domain(file_path):
    """
    Group hyperlinks by domain and show statistics.
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return
        
        hyperlinks = parser.get_hyperlinks()
        
        if not hyperlinks:
            print("No hyperlinks found")
            return
        
        # Group by domain
        by_domain = defaultdict(list)
        
        for hyperlink in hyperlinks:
            try:
                parsed_url = urlparse(hyperlink.url)
                domain = parsed_url.netloc or "internal"
                by_domain[domain].append(hyperlink)
            except:
                by_domain["invalid"].append(hyperlink)
        
        # Print statistics
        print(f"Total hyperlinks: {sum(len(links) for links in by_domain.values())}")
        print(f"Unique domains: {len(by_domain)}
")
        
        # Sort by count
        sorted_domains = sorted(by_domain.items(), key=lambda x: len(x[1]), reverse=True)
        
        print(f"{'Domain':<40} {'Count':<10}")
        print("-" * 50)
        for domain, links in sorted_domains[:20]:  # Top 20
            print(f"{domain:<40} {len(links):<10}")

# Usage
analyze_hyperlinks_by_domain("article.html")
```

{{< /tab >}}
{{< tab "article.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [article.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/article.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides statistical analysis of hyperlinks grouped by domain.

## Extract hyperlinks with filtering

To extract only specific types of hyperlinks:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_filtered_hyperlinks(file_path, url_pattern=None, text_pattern=None):
    """
    Extract hyperlinks with optional filtering by URL or text pattern.
    """
    import re
    
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return []
        
        hyperlinks = parser.get_hyperlinks()
        
        if not hyperlinks:
            return []
        
        filtered_links = []
        
        for hyperlink in hyperlinks:
            # Apply URL pattern filter
            if url_pattern and not re.search(url_pattern, hyperlink.url, re.IGNORECASE):
                continue
            
            # Apply text pattern filter
            if text_pattern and hyperlink.text and not re.search(text_pattern, hyperlink.text, re.IGNORECASE):
                continue
            
            filtered_links.append(hyperlink)
        
        return filtered_links

# Usage examples

# Extract only PDF links
pdf_links = extract_filtered_hyperlinks("document.html", url_pattern=r'\.pdf$')
print(f"Found {len(pdf_links)} PDF links")

# Extract links containing "download"
download_links = extract_filtered_hyperlinks("document.html", text_pattern=r'download')
print(f"Found {len(download_links)} download links")

# Extract external links (http/https)
external_links = extract_filtered_hyperlinks("document.html", url_pattern=r'^https?://')
print(f"Found {len(external_links)} external links")
```

{{< /tab >}}
{{< tab "document.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/document.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< tab ".pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [.pdf](../../../../../../../../../.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns only hyperlinks matching the specified criteria.

## Batch hyperlink extraction

To extract hyperlinks from multiple documents:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from pathlib import Path
import json

def batch_extract_hyperlinks(input_dir, output_json):
    """
    Extract hyperlinks from all documents in a directory.
    """
    extensions = ['.pdf', '.docx', '.doc', '.html', '.htm']
    
    all_hyperlinks = {}
    
    for file_path in Path(input_dir).rglob('*'):
        if file_path.suffix.lower() in extensions:
            print(f"Processing: {file_path.name}")
            
            try:
                with Parser(str(file_path)) as parser:
                    if not parser.features.hyperlinks:
                        continue
                    
                    hyperlinks = parser.get_hyperlinks()
                    
                    if hyperlinks:
                        link_list = []
                        for link in hyperlinks:
                            link_list.append({
                                'text': link.text or '',
                                'url': link.url or '',
                                'page': link.page.index + 1
                            })
                        
                        all_hyperlinks[file_path.name] = {
                            'count': len(link_list),
                            'links': link_list
                        }
                
            except Exception as e:
                print(f"  Error: {e}")
    
    # Save to JSON
    with open(output_json, 'w', encoding='utf-8') as f:
        json.dump(all_hyperlinks, f, indent=2, ensure_ascii=False)
    
    total_links = sum(doc['count'] for doc in all_hyperlinks.values())
    print(f"
Total documents: {len(all_hyperlinks)}")
    print(f"Total hyperlinks: {total_links}")
    print(f"Saved to {output_json}")

# Usage
batch_extract_hyperlinks("documents", "all_hyperlinks.json")
```

{{< /tab >}}
{{< tab "all_hyperlinks.json" >}}
{{< tab-text >}}
The following sample file is used in this example: [all_hyperlinks.json](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document/all_hyperlinks.json)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Processes multiple documents and generates a comprehensive JSON report of all hyperlinks.

## Notes

- The `get_hyperlinks()` method returns `None` if hyperlink extraction is not supported
- Always check `parser.features.hyperlinks` before extracting hyperlinks
- Hyperlinks include both internal (anchors) and external (URLs) links
- The `text` property contains the visible link text
- The `url` property contains the actual hyperlink target
- Position coordinates are in document-specific units
- Some documents may have hyperlinks without visible text

## Related pages

- [Extract hyperlinks from document page]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page" >}})
- [Extract hyperlinks from document page area]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area" >}})
- [Extract text areas]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-areas" >}})


---

## Extract images from document

Path: /parser/java/extract-images-from-document/

GroupDocs.Parser provides the functionality to extract images from documents by the [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method:

```java
Iterable<PageImageArea> getImages();
```

This method returns a collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getFileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getFileType()) | The format of the image. |
| [getRotation](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getRotation()) | The rotation angle of the image. |
| [getImageStream](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream()) | Returns the image stream. |
| [getImageStream(ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream(com.groupdocs.parser.options.ImageOptions)) | Returns the image stream in a different format. |
| [save(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String)) | Saves the image to the file. |
| [save(String, ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String,%20com.groupdocs.parser.options.ImageOptions)) | Saves the image to the file in a different format. |

[ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class is used to define the image format into which the image is converted. The following image formats are supported:

*   Bmp
*   Gif
*   Jpeg
*   Png
*   WebP

Here are the steps to extract images from the whole document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects;
*   Check if *collection* isn't *null* (images extraction is supported for the document);
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract all images from the whole document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Extract images
    Iterable<PageImageArea> images = parser.getImages();
    // Check if images extraction is supported
    if (images == null) {
        System.out.println("Images extraction isn't supported");
        return;
    }
    // Iterate over images
    for (PageImageArea image : images) {
        // Print a page index, rectangle and image type:
        System.out.println(String.format("Page: %d, R: %s, Type: %s", image.getPage().getIndex(), image.getRectangle(), image.getFileType()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from document

Path: /parser/net/extract-images-from-document/

GroupDocs.Parser provides the functionality to extract images from documents by the [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method:

```csharp
IEnumerable<PageImageArea> GetImages();
```

The methods return a collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area. |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/filetype) | The format of the image. |
| [Rotation](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/rotation) | The rotation angle of the image. |
| Stream [GetImageStream()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/getimagestream) | Returns the image stream. |
| Stream [GetImageStream(ImageOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.pageimagearea/getimagestream/methods/1) | Returns the image stream in a different format. |
| [Save(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/save) | Saves the image to the file. |
| [Save(string, ImageOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.pageimagearea/save/methods/1) | Saves the image to the file in a different format. |

[ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class is used to define the image format into which the image is converted. The following image formats are supported:

*   Bmp
*   Gif
*   Jpeg
*   Png
*   WebP

Here are the steps to extract images from the whole document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects;
*   Check if *collection* isn't *null* (images extraction is supported for the document);
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract images from a document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract images
    IEnumerable<PageImageArea> images = parser.GetImages();
    
    // Check if image extraction is supported
    if (images == null)
    {
        Console.WriteLine("Image extraction isn't supported");
        return;
    }
    
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Print page index and image type
        Console.WriteLine($"Page: {image.Page.Index + 1}, Type: {image.FileType}");
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract images from document

Path: /parser/python-net/extract-images-from-document/


GroupDocs.Parser provides functionality to extract images from various document formats including PDF, Word, Excel, PowerPoint, and more.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents containing images
- Write access to save extracted images (optional)

## Extract images from document

To extract all images from a document:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Extract images
    images = parser.get_images()
    
    # Check if image extraction is supported
    if images is None:
        print("Image extraction isn't supported")
    else:
        # Iterate over images
        for idx, image in enumerate(images):
            # Print image information
            print(f"Image {idx + 1}:")
            print(f"  Page: {image.page.index + 1}")
            print(f"  Type: {image.file_type}")
            print(f"  Size: {image.rectangle.width}x{image.rectangle.height}")
            print(f"  Position: ({image.rectangle.left}, {image.rectangle.top})")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns a collection of `PageImageArea` objects representing all images found in the document, or `None` if image extraction is not supported.

## Save extracted images to files

To save extracted images to disk:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

# Create output directory
output_dir = "extracted_images"
os.makedirs(output_dir, exist_ok=True)

# Create an instance of Parser class
with Parser("./sample.docx") as parser:
    # Extract images
    images = parser.get_images()
    
    if images is None:
        print("Image extraction isn't supported")
    else:
        # Iterate over images and save them
        for idx, image in enumerate(images):
            # Get file extension based on image type
            extension = image.file_type.extension
            
            # Generate filename
            filename = f"image_{idx + 1}{extension}"
            filepath = os.path.join(output_dir, filename)
            
            # Save image to file
            image.save(filepath)
            print(f"Saved: {filepath}")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Saves each extracted image to a separate file with the appropriate file extension (.png, .jpg, .gif, etc.).

## Extract images with metadata

To extract images along with detailed metadata:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pptx") as parser:
    # Check if image extraction is supported
    if not parser.features.images:
        print("Document doesn't support image extraction")
        return
    
    # Extract images
    images = parser.get_images()
    
    if images:
        print(f"Found {len(list(images))} images
")
        
        images = parser.get_images()  # Re-extract as iterator was consumed
        for idx, image in enumerate(images):
            print(f"Image {idx + 1}:")
            print(f"  Page: {image.page.index + 1}")
            print(f"  Format: {image.file_type}")
            print(f"  Rotation: {image.rotation}°")
            print(f"  Rectangle: {image.rectangle}")
            print(f"  Width: {image.rectangle.width}")
            print(f"  Height: {image.rectangle.height}")
            print()
```

{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pptx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document/sample.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Displays comprehensive information about each image including position, size, format, and rotation angle.

## Get image stream

To work with image data as a stream:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import ImageOptions, ImageFormat

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Extract images
    images = parser.get_images()
    
    if images:
        for idx, image in enumerate(images):
            # Get image stream
            image_stream = image.get_image_stream()
            
            # Read image data
            image_data = image_stream.read()
            print(f"Image {idx + 1}: {len(image_data)} bytes, format: {image.file_type}")
            
            # Optionally convert to PNG
            png_options = ImageOptions(ImageFormat.PNG)
            png_stream = image.get_image_stream(png_options)
            png_data = png_stream.read()
            print(f"  Converted to PNG: {len(png_data)} bytes")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "ImageFormat.PNG" >}}
{{< tab-text >}}
The following sample file is used in this example: [ImageFormat.PNG](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document/ImageFormat.PNG)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides access to raw image data as a stream, with optional format conversion.

## Convert images during extraction

To convert images to a specific format during extraction:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import ImageOptions, ImageFormat
import os

# Create output directory
output_dir = "converted_images"
os.makedirs(output_dir, exist_ok=True)

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Extract images
    images = parser.get_images()
    
    if images:
        # Create image options for PNG format
        png_options = ImageOptions(ImageFormat.PNG)
        
        for idx, image in enumerate(images):
            # Save image as PNG (regardless of original format)
            filename = f"image_{idx + 1}.png"
            filepath = os.path.join(output_dir, filename)
            
            # Save with conversion
            image.save(filepath, png_options)
            print(f"Saved as PNG: {filepath}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "ImageFormat.PNG" >}}
{{< tab-text >}}
The following sample file is used in this example: [ImageFormat.PNG](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document/ImageFormat.PNG)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** All extracted images are converted to PNG format before saving, regardless of their original format.

## Batch image extraction

Extract images from multiple documents:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os
from pathlib import Path

def extract_images_from_directory(input_dir, output_dir):
    """
    Extract images from all documents in a directory.
    """
    os.makedirs(output_dir, exist_ok=True)
    
    # Supported document extensions
    extensions = ['.pdf', '.docx', '.doc', '.xlsx', '.pptx', '.ppt']
    
    for file_path in Path(input_dir).rglob('*'):
        if file_path.suffix.lower() in extensions:
            print(f"
Processing: {file_path.name}")
            
            try:
                with Parser(str(file_path)) as parser:
                    images = parser.get_images()
                    
                    if images is None:
                        print(f"  Image extraction not supported")
                        continue
                    
                    # Create subdirectory for this document
                    doc_output_dir = os.path.join(output_dir, file_path.stem)
                    os.makedirs(doc_output_dir, exist_ok=True)
                    
                    # Save images
                    image_count = 0
                    for idx, image in enumerate(images):
                        filename = f"image_{idx + 1}{image.file_type.extension}"
                        filepath = os.path.join(doc_output_dir, filename)
                        image.save(filepath)
                        image_count += 1
                    
                    print(f"  Extracted {image_count} images")
                    
            except Exception as e:
                print(f"  Error: {e}")

# Usage
extract_images_from_directory("input_documents", "extracted_images")
```

{{< /tab >}}
{{< /tabs >}}

## Notes

- The `get_images()` method returns `None` if image extraction is not supported for the document format
- Always check `parser.features.images` before attempting to extract images
- Supported output formats: BMP, GIF, JPEG, PNG, WebP
- Images are extracted with their original quality and resolution
- The `rotation` property indicates the image rotation angle (0, 90, 180, or 270 degrees)
- Use `get_image_stream()` for memory-efficient processing of large images

## Related pages

- [Extract images from document page]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page" >}})
- [Extract images from document page area]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area" >}})
- [Extract images to files]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-to-files" >}})


---

## Extract metadata from documents

Path: /parser/python-net/extract-metadata-from-documents/


GroupDocs.Parser allows extracting metadata (document properties, file information) from various document formats including PDF, Emails, Ebooks, Microsoft Office (Word, PowerPoint, Excel), LibreOffice, and many others.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents for testing
- Understanding of document metadata concepts

## Extract metadata from documents

To extract metadata from documents, use the `get_metadata()` method:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Extract metadata from the document
    metadata = parser.get_metadata()
    
    # Check if metadata extraction is supported
    if metadata is None:
        print("Metadata extraction isn't supported")
    else:
        # Iterate over metadata items
        for item in metadata:
            # Print metadata name and value
            print(f"{item.name}: {item.value}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns a collection of `MetadataItem` objects containing document properties such as author, title, creation date, modified date, etc., or `None` if metadata extraction is not supported.

## Common metadata properties

Typical metadata properties include:

- **Author:** Document creator
- **Title:** Document title
- **Subject:** Document subject or description
- **Keywords:** Document keywords
- **CreatedTime:** Creation date and time
- **ModifiedTime:** Last modification date and time
- **Application:** Application used to create the document
- **Pages:** Number of pages (for some formats)

## Extract specific metadata fields

To extract and display specific metadata fields:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def get_metadata_value(metadata, field_name):
    """
    Get a specific metadata value by field name.
    """
    for item in metadata:
        if item.name.lower() == field_name.lower():
            return item.value
    return None

# Create an instance of Parser class
with Parser("document.docx") as parser:
    # Extract metadata
    metadata = parser.get_metadata()
    
    if metadata:
        # Convert to list for reuse
        metadata_list = list(metadata)
        
        # Extract specific fields
        author = get_metadata_value(metadata_list, "Author")
        title = get_metadata_value(metadata_list, "Title")
        created = get_metadata_value(metadata_list, "CreatedTime")
        modified = get_metadata_value(metadata_list, "ModifiedTime")
        
        # Print specific metadata
        print(f"Document Information:")
        print(f"  Title: {title}")
        print(f"  Author: {author}")
        print(f"  Created: {created}")
        print(f"  Modified: {modified}")
```

{{< /tab >}}
{{< tab "document.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/document.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Retrieves specific metadata fields by name, making it easy to access commonly used properties.

## Export metadata to dictionary

To convert metadata to a Python dictionary:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_metadata_as_dict(file_path):
    """
    Extract document metadata as a dictionary.
    """
    with Parser(file_path) as parser:
        metadata = parser.get_metadata()
        
        if metadata is None:
            return None
        
        # Convert to dictionary
        metadata_dict = {}
        for item in metadata:
            metadata_dict[item.name] = item.value
        
        return metadata_dict

# Usage
metadata = extract_metadata_as_dict("report.pdf")

if metadata:
    print("Document Metadata:")
    for key, value in metadata.items():
        print(f"  {key}: {value}")
else:
    print("Metadata extraction not supported")
```

{{< /tab >}}
{{< tab "report.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [report.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/report.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns metadata as a dictionary with field names as keys and field values as values.

## Export metadata to JSON

To export metadata to JSON format:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import json

def export_metadata_to_json(file_path, output_file):
    """
    Extract metadata and save to JSON file.
    """
    with Parser(file_path) as parser:
        metadata = parser.get_metadata()
        
        if metadata is None:
            print("Metadata extraction not supported")
            return False
        
        # Build metadata dictionary
        metadata_dict = {
            'file_path': file_path,
            'properties': {}
        }
        
        for item in metadata:
            # Convert value to string for JSON serialization
            value = str(item.value) if item.value is not None else None
            metadata_dict['properties'][item.name] = value
        
        # Save to JSON
        with open(output_file, 'w', encoding='utf-8') as f:
            json.dump(metadata_dict, f, indent=2, ensure_ascii=False)
        
        print(f"Metadata exported to {output_file}")
        return True

# Usage
export_metadata_to_json("sample.docx", "metadata.json")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "metadata.json" >}}
{{< tab-text >}}
The following sample file is used in this example: [metadata.json](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/metadata.json)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a JSON file containing all document metadata in a structured format.

## Batch metadata extraction

To extract metadata from multiple documents:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from pathlib import Path
import csv

def batch_extract_metadata(input_dir, output_csv):
    """
    Extract metadata from all documents in a directory and save to CSV.
    """
    extensions = ['.pdf', '.docx', '.doc', '.xlsx', '.xls', '.pptx', '.ppt']
    
    results = []
    
    for file_path in Path(input_dir).rglob('*'):
        if file_path.suffix.lower() in extensions:
            print(f"Processing: {file_path.name}")
            
            try:
                with Parser(str(file_path)) as parser:
                    metadata = parser.get_metadata()
                    
                    if metadata:
                        # Extract common fields
                        meta_dict = {'file_name': file_path.name}
                        
                        for item in metadata:
                            meta_dict[item.name] = str(item.value) if item.value else ""
                        
                        results.append(meta_dict)
                    
            except Exception as e:
                print(f"  Error: {e}")
    
    # Save to CSV
    if results:
        # Get all unique field names
        all_fields = set()
        for result in results:
            all_fields.update(result.keys())
        
        # Write CSV
        with open(output_csv, 'w', newline='', encoding='utf-8') as csvfile:
            writer = csv.DictWriter(csvfile, fieldnames=sorted(all_fields))
            writer.writeheader()
            writer.writerows(results)
        
        print(f"
Extracted metadata from {len(results)} documents")
        print(f"Saved to {output_csv}")

# Usage
batch_extract_metadata("documents", "metadata_report.csv")
```

{{< /tab >}}
{{< tab "metadata_report.csv" >}}
{{< tab-text >}}
The following sample file is used in this example: [metadata_report.csv](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/metadata_report.csv)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Processes all documents in a directory, extracts metadata, and generates a CSV report.

## Metadata comparison

To compare metadata between documents:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def compare_metadata(file1, file2):
    """
    Compare metadata between two documents.
    """
    def get_metadata_dict(file_path):
        with Parser(file_path) as parser:
            metadata = parser.get_metadata()
            if metadata:
                return {item.name: item.value for item in metadata}
            return {}
    
    metadata1 = get_metadata_dict(file1)
    metadata2 = get_metadata_dict(file2)
    
    # Find common and unique fields
    all_fields = set(metadata1.keys()) | set(metadata2.keys())
    common_fields = set(metadata1.keys()) & set(metadata2.keys())
    
    print(f"Comparing: {file1} vs {file2}
")
    print(f"{'Field':<20} {'File 1':<30} {'File 2':<30} {'Match':<10}")
    print("-" * 95)
    
    for field in sorted(all_fields):
        val1 = str(metadata1.get(field, "N/A"))[:30]
        val2 = str(metadata2.get(field, "N/A"))[:30]
        match = "Yes" if field in common_fields and metadata1.get(field) == metadata2.get(field) else "No"
        
        print(f"{field:<20} {val1:<30} {val2:<30} {match:<10}")

# Usage
compare_metadata("version1.docx", "version2.docx")
```

{{< /tab >}}
{{< tab "version1.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [version1.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/version1.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "version2.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [version2.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-metadata/extract-metadata-from-documents/version2.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides a side-by-side comparison of metadata fields from two documents.

## Notes

- The `get_metadata()` method returns `None` if metadata extraction is not supported
- Use `parser.features.metadata` to check if metadata extraction is available
- Metadata properties vary by document format
- Some formats provide more metadata than others
- Date/time values are typically returned as string or datetime objects
- Metadata extraction is lightweight and fast

## Related pages

- [Get document info]({{< ref "parser/python-net/developer-guide/basic-usage/get-document-info" >}})
- [Extract text from documents]({{< ref "parser/python-net/developer-guide/basic-usage/extract-text-from-documents" >}})
- [Supported document formats]({{< ref "parser/python-net/supported-document-formats" >}})


---

## Extract tables from document

Path: /parser/python-net/extract-tables-from-document/


GroupDocs.Parser provides functionality to extract tables from various document formats including **Excel spreadsheets (XLS, XLSX)**, Word documents, PDFs, and PowerPoint presentations.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents containing tables
- Understanding of table structure (rows, columns, cells)

## Extract tables from document

To extract all tables from a document:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.xlsx") as parser:
    # Check if table extraction is supported
    if not parser.features.tables:
        print("Table extraction isn't supported")
        return
    
    # Extract tables from the document
    tables = parser.get_tables(None)
    
    if tables:
        table_index = 0
        for table in tables:
            table_index += 1
            print(f"
=== Table {table_index} ===")
            print(f"Rows: {table.row_count}, Columns: {table.column_count}")
            
            # Iterate over rows
            for row_index in range(table.row_count):
                # Iterate over columns
                for col_index in range(table.column_count):
                    # Get table cell
                    cell = table[row_index, col_index]
                    if cell:
                        print(f"{cell.text}\t", end="")
                print()  # New line after each row
```

{{< /tab >}}
{{< tab "sample.xlsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.xlsx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document/sample.xlsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts all tables from the document with automatic table detection, returning structured table data with rows, columns, and cell values.

## Extract tables from Excel spreadsheets

To extract tables from Excel files:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Excel file path
excel_path = "data.xlsx"

# Create an instance of Parser class
with Parser(excel_path) as parser:
    # Check if table extraction is supported
    if not parser.features.tables:
        print("Table extraction not supported for this file")
        return
    
    # Extract tables (pass None for automatic detection)
    tables = parser.get_tables(None)
    
    if tables:
        for table_idx, table in enumerate(tables):
            print(f"
Table {table_idx + 1}:")
            print(f"Size: {table.row_count} rows × {table.column_count} columns")
            print(f"Page: {table.page.index + 1}")
            
            # Print table data
            for row in table.rows:
                row_data = []
                for cell in row.cells:
                    cell_text = cell.text if cell else ""
                    row_data.append(cell_text)
                print(" | ".join(row_data))
```

{{< /tab >}}
{{< tab "data.xlsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [data.xlsx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document/data.xlsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts structured table data from Excel spreadsheets, including all sheets and tables.

## Extract tables with custom layout

To extract tables when you know the exact table structure:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTableAreaOptions
from groupdocs.parser.templates import TemplateTableLayout

# Create an instance of Parser class
with Parser("invoice.pdf") as parser:
    # Check if table extraction is supported
    if not parser.features.tables:
        print("Table extraction not supported")
        return
    
    # Define table layout (column and row separators in points)
    # Columns: x-coordinates of vertical separators
    # Rows: y-coordinates of horizontal separators
    layout = TemplateTableLayout(
        [50, 95, 275, 415, 485, 545],  # Column separators
        [325, 340, 365, 395]            # Row separators
    )
    
    # Create options for table extraction
    options = PageTableAreaOptions(layout)
    
    # Extract tables with custom layout
    tables = parser.get_tables(options)
    
    if tables:
        for table in tables:
            print(f"
Table: {table.row_count} rows × {table.column_count} columns")
            
            # Print table content
            for row in table.rows:
                for cell in row.cells:
                    if cell:
                        print(f"{cell.text} | ", end="")
                print()
```

{{< /tab >}}
{{< tab "invoice.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [invoice.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document/invoice.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts tables using predefined column and row positions, useful for structured documents like invoices or forms.

## Convert table to CSV

To export extracted tables to CSV format:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import csv
import os

def export_tables_to_csv(file_path, output_dir):
    """
    Extract tables from document and save as CSV files.
    """
    os.makedirs(output_dir, exist_ok=True)
    
    with Parser(file_path) as parser:
        if not parser.features.tables:
            print("Table extraction not supported")
            return
        
        tables = parser.get_tables(None)
        
        if not tables:
            print("No tables found")
            return
        
        for table_idx, table in enumerate(tables):
            # Create CSV filename
            csv_filename = f"table_{table_idx + 1}.csv"
            csv_path = os.path.join(output_dir, csv_filename)
            
            # Write table to CSV
            with open(csv_path, 'w', newline='', encoding='utf-8') as csvfile:
                writer = csv.writer(csvfile)
                
                # Write table rows
                for row in table.rows:
                    row_data = []
                    for cell in row.cells:
                        cell_text = cell.text if cell else ""
                        row_data.append(cell_text)
                    writer.writerow(row_data)
            
            print(f"Saved: {csv_path}")

# Usage
export_tables_to_csv("report.xlsx", "exported_tables")
```

{{< /tab >}}
{{< tab "report.xlsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [report.xlsx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document/report.xlsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Converts each extracted table to a separate CSV file preserving the table structure.

## Get table cell properties

To access detailed cell information:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("document.docx") as parser:
    if not parser.features.tables:
        print("Table extraction not supported")
        return
    
    tables = parser.get_tables(None)
    
    if tables:
        for table in tables:
            print(f"
Table: {table.row_count}×{table.column_count}")
            print(f"Position: {table.rectangle}")
            
            # Access specific cell
            if table.row_count > 0 and table.column_count > 0:
                cell = table[0, 0]  # First cell
                if cell:
                    print(f"
First cell:")
                    print(f"  Text: {cell.text}")
                    print(f"  Row index: {cell.row_index}")
                    print(f"  Column index: {cell.column_index}")
                    print(f"  Row span: {cell.row_span}")
                    print(f"  Column span: {cell.column_span}")
```

{{< /tab >}}
{{< tab "document.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document/document.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides access to individual cell properties including text, position, and span information.

## Extract tables from multiple pages

To extract tables with page information:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("report.pdf") as parser:
    if not parser.features.tables:
        print("Table extraction not supported")
        return
    
    # Get document info
    info = parser.get_document_info()
    print(f"Document has {info.page_count} pages")
    
    # Extract all tables
    tables = parser.get_tables(None)
    
    if tables:
        # Group tables by page
        tables_by_page = {}
        for table in tables:
            page_num = table.page.index + 1
            if page_num not in tables_by_page:
                tables_by_page[page_num] = []
            tables_by_page[page_num].append(table)
        
        # Print summary
        print(f"
Found {len(list(tables))} tables across {len(tables_by_page)} pages")
        
        for page_num in sorted(tables_by_page.keys()):
            page_tables = tables_by_page[page_num]
            print(f"
Page {page_num}: {len(page_tables)} table(s)")
            
            for idx, table in enumerate(page_tables):
                print(f"  Table {idx + 1}: {table.row_count}×{table.column_count}")
```

{{< /tab >}}
{{< tab "report.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [report.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document/report.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts all tables and organizes them by page number.

## Process large tables efficiently

To handle large tables with many rows:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def process_large_table(file_path, max_rows_to_print=10):
    """
    Process large tables efficiently, showing only a preview.
    """
    with Parser(file_path) as parser:
        if not parser.features.tables:
            print("Table extraction not supported")
            return
        
        tables = parser.get_tables(None)
        
        if tables:
            for table_idx, table in enumerate(tables):
                print(f"\nTable {table_idx + 1}:")
                print(f"Total size: {table.row_count} rows × {table.column_count} columns")
                
                # Print header (first row)
                if table.row_count > 0:
                    print("\nHeader:")
                    for col in range(table.column_count):
                        cell = table[0, col]
                        if cell:
                            print(f"  Column {col + 1}: {cell.text}")
                
                # Print preview of data
                rows_to_show = min(max_rows_to_print, table.row_count)
                print(f"
Showing first {rows_to_show} rows:")
                
                for row in range(rows_to_show):
                    row_data = []
                    for col in range(table.column_count):
                        cell = table[row, col]
                        cell_text = cell.text[:20] if cell and cell.text else ""  # Truncate long text
                        row_data.append(cell_text)
                    print(" | ".join(row_data))

# Usage
process_large_table("large_spreadsheet.xlsx")
```

{{< /tab >}}
{{< tab "large_spreadsheet.xlsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [large_spreadsheet.xlsx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document/large_spreadsheet.xlsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Notes

- Always check `parser.features.tables` before attempting table extraction
- Pass `None` to `get_tables()` for automatic table detection
- Use `TemplateTableLayout` for documents with known table structures
- Table coordinates are in document-specific units (points or pixels)
- Cells can span multiple rows or columns (check `row_span` and `column_span`)
- Empty cells return `None` when accessed via indexer
- The `get_tables()` method returns `None` if table extraction is not supported

## Related pages

- [Extract tables from document page]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page" >}})
- [Working with templates]({{< ref "parser/python-net/developer-guide/advanced-usage/template-based-parsing/working-with-templates" >}})
- [Get document info]({{< ref "parser/python-net/developer-guide/basic-usage/get-document-info" >}})


---

## Extract Tables from PDF Documents

Path: /parser/net/best-ways-extract-tables-from-pdf/


## Overview

Extracting structured table data from PDF documents is a critical requirement for modern business automation. Manual data entry from PDF tables is time-consuming, error-prone, and doesn't scale. This guide demonstrates **multiple professional table extraction methods** using GroupDocs.Parser for .NET, ranging from simple page-specific extraction to comprehensive document-wide processing that automatically detects and extracts all tables.

**What you'll learn:**
- Why automated table extraction is essential for business document processing
- How to implement multiple table extraction techniques with complete code examples
- When to use each extraction method based on your document structure
- Visual demonstrations of extracted tables with formatted output
- Best practices for processing tables from invoices, reports, and financial documents

## Business Needs Challenge

Modern businesses face the critical challenge of efficiently **extracting document data** from PDF files containing structured tables. Manual data entry is time-consuming, error-prone, and doesn't scale. Organizations need automated solutions to **parse document** structures and **extract tables** programmatically to access critical business information.

### Common Document Processing Requirements

**1. Invoice and Financial Document Processing**

Businesses receive hundreds of invoices, receipts, and financial statements daily. Each document contains critical **table extraction** needs:
- **Extract document data** from invoice line items (product names, quantities, prices)
- **Parse document** tables to capture billing addresses, tax calculations, and totals
- **Extract tables** containing payment terms, discounts, and shipping information
- Automatically process vendor invoices for accounts payable automation

**Solution:** Automatic **table extraction** eliminates manual data entry, reduces processing time from hours to seconds, and ensures 100% accuracy when **extracting tables** from financial documents. With programmatic **table extraction**, businesses can process thousands of invoices daily, extract all relevant data, and integrate directly into accounting systems.

**2. Report and Analytics Data Extraction**

Organizations generate and receive numerous reports containing analytical data in tabular format:
- **Extract document data** from sales reports with product performance metrics
- **Parse document** tables containing quarterly financial results and KPIs
- **Extract tables** from operational reports with inventory levels, production metrics, and resource utilization
- Process regulatory compliance reports with structured data requirements

**Solution:** Automated **table extraction** enables businesses to **extract tables** from reports programmatically, transforming static PDF documents into actionable data. This allows for real-time data analysis, automated reporting pipelines, and seamless integration with business intelligence tools. By **extracting document data** automatically, organizations can make data-driven decisions faster and maintain accurate records.

**3. Purchase Orders and Supply Chain Documents**

Supply chain operations depend on accurate data extraction from purchase orders, shipping manifests, and inventory reports:
- **Extract document data** from purchase orders including SKU numbers, quantities, and unit prices
- **Parse document** tables to capture supplier information, delivery dates, and shipping addresses
- **Extract tables** containing inventory levels, stock movements, and warehouse locations
- Process shipping manifests with item lists, tracking numbers, and delivery confirmations

**Solution:** **Table extraction** automates the entire supply chain document processing workflow. By **extracting tables** from purchase orders and shipping documents, businesses can automatically update inventory systems, track shipments, and reconcile orders without manual intervention. This **table extraction** capability ensures supply chain visibility and reduces processing errors.

### Why Automatic Table Extraction Matters

Traditional manual data extraction is inefficient and costly. **Table extraction** technology solves these challenges by:

- **Eliminating Manual Errors:** Automated **table extraction** ensures consistent, accurate data capture
- **Scaling Operations:** **Extract tables** from hundreds of documents in minutes, not days
- **Reducing Costs:** Cut data entry costs by up to 90% with automated **table extraction**
- **Improving Speed:** **Parse document** files instantly and **extract document data** in real-time
- **Enabling Integration:** **Extract tables** directly into databases, ERP systems, and analytics platforms

{{< alert style="info" >}} For the **complete working code** and detailed explanations, please refer to the [full repository here](https://github.com/groupdocs-parser/Pdf-tables-extraction-using-groupdocs-parser).  
{{< /alert >}}

## 📂 Repository Structure

    Pdf-tables-extraction-using-groupdocs-parser/
    │
    ├── Program.cs                 # Entry point: table extraction methods
    │   ├── ExtractTablesPerParticluarPage    # Extract tables from specific page
    │   ├── ExtractAllTablesFromDocument      # Extract all tables from document
    │   ├── ProcessTable                      # Format and display tables
    │   └── GetCellText                       # Access individual cells
    ├── Invoices.pdf              # Sample PDF with invoice tables
    ├── TablesReport.pdf          # Sample PDF with multiple tables
    ├── Operations.pdf            # Sample PDF document
    ├── document-page-01.png      # Source document preview
    ├── console-output-01.png     # Extracted tables output
    └── README.md                 # Documentation

## Method 1: Extract Tables from a Specific Page

**Use Case:** Page-specific extraction | **Difficulty:** Easy | **Best For:** Documents with known table locations, single-page processing

This method extracts tables from a specific page of a PDF document. It's ideal when you know which page contains the tables you need, such as extracting invoice line items from the first page or processing specific report sections.

### Implementation

```csharp
static void ExtractTablesPerParticluarPage()
{
    string sample = "Invoices.pdf";
    
    // Initialize parser with PDF document
    using (var parser = new Parser(sample))
    {
        // Get document information
        var documentInfo = parser.GetDocumentInfo();
        int pageCount = documentInfo.PageCount;
        
        // Extract tables from first page (pageIndex = 0)
        var pageIndex = 0;
        var tables = parser.GetTables(pageIndex);

        if (tables != null && tables.Any())
        {
            int tableNumber = 1;
            foreach (var table in tables)
            {
                // Process each table
                // Display table dimensions and content
                Console.WriteLine($"  Table {tableNumber}: {table.RowCount} rows x {table.ColumnCount} columns");
                ProcessTable(table);
                tableNumber++;
            }
        }
    }
}
```

**Source Document:**
![PDF Document Page](/parser/net/images/use-cases/best-ways-extract-tables-from-pdf-document-page-01.png)

**Extracted Tables Output:**
![Console Output](/parser/net/images/use-cases/best-ways-extract-tables-from-pdf-console-output-01.png)

### Key Features

- **Page Targeting:** Specify exact page index (0-based) for precise extraction
- **Multiple Tables:** Automatically detects and extracts all tables on the specified page
- **Table Metadata:** Access row count, column count, and page information
- **Ideal For:** Invoices, single-page reports, forms with known structure

### When to Use This Method

- Processing invoices where line items are always on page 1
- Extracting data from specific report sections
- Working with forms that have consistent page layouts
- Quick extraction from known document locations

## Method 2: Extract All Tables from Entire Document

**Use Case:** Full document processing | **Difficulty:** Easy | **Best For:** Multi-page documents, comprehensive data extraction

This method extracts all tables from all pages of a PDF document and organizes them by page. It's perfect for processing complete documents where you need comprehensive table data across multiple pages.

### Implementation

```csharp
static void ExtractAllTablesFromDocument()
{
    string sample = "TablesReport.pdf";

    using (var parser = new Parser(sample))
    {   
        // Get all tables from entire document
        var tables = parser.GetTables();

        if (tables != null && tables.Any())
        {
            // Group tables by page index
            var tablesByPage = tables
                .GroupBy(table => table.Page.Index)
                .OrderBy(group => group.Key);

            foreach (var pageGroup in tablesByPage)
            {
                int pageIndex = pageGroup.Key;
                Console.WriteLine($"Tables in the Page {pageIndex + 1}");
                Console.WriteLine();

                int tableNumber = 1;
                foreach (var table in pageGroup)
                {
                    Console.WriteLine($"  Table {tableNumber}: {table.RowCount} rows x {table.ColumnCount} columns");
                    ProcessTable(table);
                    tableNumber++;
                }
                Console.WriteLine();
            }
        }
    }
}
```

### Key Features

- **Complete Coverage:** Extracts tables from every page automatically
- **Page Organization:** Groups tables by page for easy navigation
- **Scalable Processing:** Handles documents with hundreds of pages
- **Ideal For:** Financial reports, multi-page invoices, comprehensive data extraction

### When to Use This Method

- Processing complete financial reports with tables across multiple pages
- Extracting all data from multi-page invoices
- Comprehensive document analysis requiring all table data
- Batch processing scenarios where complete extraction is needed

## Method 3: Access Individual Table Cells with Formatted Output

**Use Case:** Cell-level processing | **Difficulty:** Medium | **Best For:** Data transformation, custom formatting, cell-by-cell analysis

This method provides granular access to individual table cells and formats the output for display or further processing. It calculates optimal column widths and creates formatted table displays with proper alignment.

### Implementation

```csharp
static void ProcessTable(PageTableArea table)
{
    // Calculate column widths for proper alignment using LINQ
    int[] columnWidths = Enumerable.Range(0, table.ColumnCount)
        .Select(col => Math.Max(3, Enumerable.Range(0, table.RowCount)
            .Max(row => table[row, col]?.Text?.Length ?? 0)))
        .ToArray();

    // Display table with borders
    string separator = "+" + string.Join("+", columnWidths.Select(w => new string('-', w + 2))) + "+";
    
    // Display header row (first row)
    Console.WriteLine("    " + separator);
    Console.Write("    |");
    for (int col = 0; col < table.ColumnCount; col++)
    {
        string cellText = GetCellText(table, 0, col);
        Console.Write($" {cellText.PadRight(columnWidths[col])} |");
    }
    Console.WriteLine();
    Console.WriteLine("    " + separator);

    // Display data rows
    for (int row = 1; row < table.RowCount; row++)
    {
        Console.Write("    |");
        for (int col = 0; col < table.ColumnCount; col++)
        {
            string cellText = GetCellText(table, row, col);
            Console.Write($" {cellText.PadRight(columnWidths[col])} |");
        }
        Console.WriteLine();
    }
    Console.WriteLine("    " + separator);
}

static string GetCellText(PageTableArea table, int row, int col)
{
    return table[row, col]?.Text ?? "";
}
```

### Key Features

- **Dynamic Column Sizing:** Automatically calculates optimal column widths based on content
- **Formatted Display:** Creates professional table borders and alignment
- **Cell-Level Access:** Direct access to any cell by row and column index
- **Header Separation:** Visually separates header row from data rows
- **Ideal For:** Console output, data validation, custom formatting requirements

### Advanced Cell Processing

You can extend this method to:
- Filter specific columns or rows
- Apply data transformations to cell values
- Validate cell content against business rules
- Export to CSV, Excel, or database formats
- Perform calculations on numeric cells

## Method 4: Extract Tables with LINQ for Efficient Processing

**Use Case:** Advanced filtering and processing | **Difficulty:** Medium | **Best For:** Complex data extraction, filtering, and transformation

This method demonstrates how to use LINQ queries to filter, group, and process extracted tables efficiently. It's ideal for scenarios requiring conditional extraction or data transformation.

### Implementation

```csharp
static void ExtractTablesWithFiltering()
{
    string sample = "TablesReport.pdf";

    using (var parser = new Parser(sample))
    {
        var tables = parser.GetTables();

        if (tables != null && tables.Any())
        {
            // Filter tables with more than 5 rows
            var largeTables = tables
                .Where(table => table.RowCount > 5)
                .ToList();

            // Group by page and count tables per page
            var tablesPerPage = tables
                .GroupBy(table => table.Page.Index)
                .Select(group => new
                {
                    Page = group.Key + 1,
                    TableCount = group.Count(),
                    TotalRows = group.Sum(t => t.RowCount)
                })
                .OrderBy(x => x.Page);

            // Extract specific columns from all tables
            foreach (var table in tables)
            {
                if (table.ColumnCount >= 2)
                {
                    // Extract first two columns from each table
                    var firstTwoColumns = Enumerable.Range(0, table.RowCount)
                        .Select(row => new
                        {
                            Column1 = GetCellText(table, row, 0),
                            Column2 = GetCellText(table, row, 1)
                        })
                        .ToList();
                }
            }
        }
    }
}
```

### Key Features

- **LINQ Integration:** Leverage powerful LINQ queries for table processing
- **Flexible Filtering:** Filter tables by size, page, or content criteria
- **Data Aggregation:** Calculate statistics across multiple tables
- **Selective Extraction:** Extract specific columns or rows based on conditions
- **Ideal For:** Complex data analysis, conditional extraction, data transformation pipelines

## Choosing the Right Extraction Method

| Method | Use Case | Difficulty | Best For | Processing Speed |
|--------|----------|------------|----------|------------------|
| Page-Specific Extraction | Known table location | Easy | Single-page documents, invoices | Fast |
| Full Document Extraction | Complete data extraction | Easy | Multi-page reports, comprehensive analysis | Medium |
| Cell-Level Processing | Custom formatting, validation | Medium | Data transformation, custom output | Fast |
| LINQ-Based Processing | Complex filtering, aggregation | Medium | Advanced data analysis, conditional extraction | Medium |

## Key Features of GroupDocs.Parser Table Extraction

### Automatic Table Detection

- **No Templates Required:** Automatically detects table structures in PDF documents
- **Smart Recognition:** Identifies table boundaries, rows, and columns automatically
- **Multiple Table Support:** Extracts multiple tables from a single page or document
- **Format Preservation:** Maintains table structure and cell relationships

### Extraction Capabilities

- **Page-Specific Extraction:** Target tables on specific pages for efficient processing
- **Full Document Processing:** Extract all tables across entire documents
- **Cell-Level Access:** Access individual cells by row and column coordinates
- **Table Metadata:** Retrieve table dimensions (rows × columns) and page information
- **Structured Output:** Formatted table display with headers and values

### What You Can Extract

- Table headers and data rows with precise positioning
- Cell values with accurate text extraction
- Table dimensions (rows × columns) for validation
- Multi-page table extraction with page organization
- Tables organized by page for easy navigation

## Common Questions

**Q: Do I need templates to extract tables?**  
A: No. GroupDocs.Parser automatically detects table structures in PDF documents without requiring templates. Templates are optional and used for advanced scenarios with scanned documents or complex layouts.

**Q: Can I extract tables from scanned PDFs?**  
A: Yes, with OCR support. GroupDocs.Parser can work with OCR connectors to extract tables from scanned PDFs. Template-based extraction is recommended for scanned documents with consistent layouts.

**Q: How accurate is automatic table detection?**  
A: Automatic table detection works excellently for text-based PDFs with clear table structures. Accuracy depends on document quality and table formatting. Well-structured tables achieve near-perfect extraction.

**Q: Can I extract specific columns or rows?**  
A: Yes. Once tables are extracted, you can access individual cells by row and column index, allowing you to filter, transform, or extract specific data elements.

**Q: Does GroupDocs.Parser support other document formats?**  
A: Yes. GroupDocs.Parser supports 50+ document formats including Word, Excel, PowerPoint, and more. However, this guide focuses on PDF table extraction.

**Q: How do I handle documents with multiple tables per page?**  
A: The `GetTables()` method returns all tables found on a page. You can iterate through the collection and process each table individually, or filter them based on size, position, or content.

**Q: Can I export extracted tables to other formats?**  
A: Yes. After extraction, you can process table data and export to CSV, Excel, JSON, or database formats using standard .NET libraries or GroupDocs conversion APIs.

## Conclusion

Extracting tables from PDF documents is essential for modern business automation. GroupDocs.Parser for .NET provides multiple extraction methods, from simple page-specific extraction to comprehensive document-wide processing with advanced filtering and formatting capabilities.

Choose the extraction method that matches your requirements:
- Use **page-specific extraction** for documents with known table locations
- Implement **full document extraction** for comprehensive data collection
- Apply **cell-level processing** for custom formatting and validation
- Deploy **LINQ-based processing** for complex filtering and transformation

Whether you need to **extract document data** from invoices, **parse document** reports, or **extract tables** from any PDF document, GroupDocs.Parser provides the solution to transform unstructured PDF documents into structured, actionable data. Start extracting tables programmatically today and eliminate manual data entry from your document processing workflows.


---

## Extract text from Emails

Path: /parser/java/extract-text-from-emails/

To extract a text from emails [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method is used. This method allows to extract a text from the entire document. Pagination and raw mode is not supported for emails.

Here are the steps to extract a text from an email:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial email;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null*. For an empty email [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from the email:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleMsg)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the email
        System.out.println(reader.readToEnd());
    }
}

```

GroupDocs.Parser also allows to extract a text from emails as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from an email as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial email;
*   Call [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example shows how to extract a text from an email as HTML:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleMsg)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the email
        System.out.println(reader.readToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Emails

Path: /parser/net/extract-text-from-emails/

To extract a text from emails [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method is used. This method allows to extract a text from the entire document. Pagination and raw mode is not supported for emails.

Here are the steps to extract a text from an email:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial email;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null*. For an empty email [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns an empty [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object ([reader.ReadToEnd](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader.readtoend?view=netframework-2.0) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from the email:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the email
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

GroupDocs.Parser also allows to extract a text from emails as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from an email as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial email;
*   Call [GetFormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a text from an email as HTML:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // Print a formatted text from the document
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from EPUB eBooks

Path: /parser/java/extract-text-from-epub-ebooks/

To extract a text from EPUB e-books [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) and [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) methods are used. These methods allow to extract a text from the entire document or a text from the selected page. Raw mode is not supported for EPUB.

Here are the steps to extract a text from EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial e-book;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null*. For empty EPUB e-book [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from EPUB e-book:
```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleEpub)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the e-book
        System.out.println(reader.readToEnd());
    }
}
```

Here are the steps to extract a text from the page of EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial e-book;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and obtain [IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo) object with [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) property;
*   Call [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the page of EPUB e-book:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleEpub)) {
    // Get the e-book info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Iterate over pages
    for (int p = 0; p < documentInfo.getPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p)) {
            // Print a text from the e-book
            System.out.println(reader.readToEnd());
        }
    }
}
```

GroupDocs.Parser also allows to extract a text from EPUB e-books as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from EPUB e-book as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial e-book;
*   Call [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example shows how to extract a text from EPUB e-book as HTML:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleEpub)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the e-book
        System.out.println(reader.readToEnd());
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from EPUB eBooks

Path: /parser/net/extract-text-from-epub-ebooks/

To extract a text from EPUB e-books [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) and [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) methods is used. These methods allow to extract a text from the entire document or a text from the selected page. Raw mode is not supported for EPUB.

Here are the steps to extract a text from EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial e-book;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null*. For empty EPUB e-book [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns an empty [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object ([reader.ReadToEnd](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader.readtoend?view=netframework-2.0) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from EPUB e-book:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the e-book
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

Here are the steps to extract a text from the page of EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial e-book;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and obtain [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) object with [page count](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount);
*   Call [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method with the page index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the page of EPUB e-book:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
   
    // Iterate over pages
    for(int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.PageCount));
   
        // Extract a text into the reader
        using(TextReader reader = parser.GetText(p))
        {
            // Print a text from the e-book
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

GroupDocs.Parser also allows to extract a text from EPUB e-books as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from EPUB e-book as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial e-book;
*   Call [GetFormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a text from EPUB e-book as HTML:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // Print a formatted text from the e-book
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from HTML documents

Path: /parser/java/extract-text-from-html-documents/

To extract a text from HTML documents [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method is used. This method allows to extract a text from the entire document. Pagination and raw mode is not supported for emails.

Here are the steps to extract a text from HTML document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null*. For an HTML document [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from HTML document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleHtml)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the document
        System.out.println(reader.readToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)
    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).

---

## Extract text from HTML documents

Path: /parser/net/extract-text-from-html-documents/

To extract a text from HTML documents [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method is used. This method allows to extract a text from the entire document. Pagination and raw mode is not supported for emails.

Here are the steps to extract a text from HTML document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null*. For an HTML document [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns an empty [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object ([reader.ReadToEnd](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader.readtoend?view=netframework-2.0) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from HTML document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the email
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft Office Excel spreadsheets

Path: /parser/java/extract-text-from-microsoft-office-excel-spreadsheets/

To extract a text from Microsoft Office Excel spreadsheets [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) and [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method is used. These methods allow to extract a text from the entire document or a text from the selected page.

Here are the steps to extract a text from Microsoft Office Excel spreadsheets:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns null value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns null. For empty Microsoft Office Excel spreadsheets [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).{{< /alert >}}

The following example demonstrates how to extract a text from Microsoft Office Excel spreadsheets:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the spreadsheet
        System.out.println(reader.readToEnd());
    }
}
```

Here are the steps to extract a text from the sheet of Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and obtain [IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo) object with [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) property;
*   Call [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method with the sheet index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    // Get the spreadsheet info
    IDocumentInfo spreadsheetInfo = parser.getDocumentInfo();
    // Iterate over sheets
    for (int p = 0; p < spreadsheetInfo.getPageCount(); p++) {
        // Print a sheet number
        System.out.println(String.format("Sheet %d/%d", p + 1, spreadsheetInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p)) {
            // Print a text from the spreadsheet
            System.out.println(reader.readToEnd());
        }
    }
}
```

Raw mode allows to increase the speed of text extraction due to poor formatting accuracy. [getText(TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(com.groupdocs.parser.options.TextOptions)) and [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) methods are used to extract a text in raw mode.

{{< alert style="warning" >}}Some spreadsheets may have different sheet numbers in raw and accurate modes. Use [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) instead of [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) in raw mode.{{< /alert >}}

Here are the steps to extract a raw text from the sheet of Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Instantiate [TextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextOptions) object with *true* parameter;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method;
*   Use [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) instead of [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) to avoid extra calculations;
*   Call [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) method with the sheet index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader "class in com.groupdocs.parser.data") object;
*   Read a text from *reader*.

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    // Get the document info
    DocumentInfo documentInfo = parser.getDocumentInfo() instanceof DocumentInfo
            ? (DocumentInfo) parser.getDocumentInfo()
            : null;
    // Check if the document has pages
    if (documentInfo == null || documentInfo.getRawPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.getRawPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p, new TextOptions(true))) {
            // Print a text from the document
            // We ignore null-checking as we have checked text extraction feature support earlier
            System.out.println(reader.readToEnd());
        }
    }
}
```

GroupDocs.Parser also allows to extract a text from Microsoft Office Excel spreadsheets as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from Microsoft Office Excel spreadsheet as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Call [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example shows how to extract a text from Microsoft Office Excel spreadsheet as HTML:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the spreadsheet
        System.out.println(reader.readToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft Office Excel spreadsheets

Path: /parser/net/extract-text-from-microsoft-office-excel-spreadsheets/


## Overview

This guide demonstrates how to extract text content from Microsoft Office Excel spreadsheets (.xls, .xlsx) using the GroupDocs.Parser for .NET API. You'll learn different text extraction methods suitable for various document processing scenarios, from simple Excel text retrieval to advanced sheet-by-sheet parsing operations.

## Extraction Methods Comparison

| Method | Use Case | Performance | Output Quality |
|--------|----------|-------------|----------------|
| **Whole Document** | Extract all text at once | Fast | Standard |
| **Sheet-by-Sheet** | Process individual worksheets | Medium | Standard |
| **Raw Mode** | High-speed bulk processing | Fastest | Lower formatting accuracy |
| **Formatted Text** | Preserve formatting (HTML/Markdown) | Slower | Highest |

## Method 1: Extract Text from Entire Spreadsheet

**When to use:** When you need all text content from the Excel workbook and don't need to distinguish between different worksheets for your document parsing workflow.

To extract text from Microsoft Office Excel spreadsheets using the .NET parser library, the [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method is used. This text extraction API method retrieves content from the entire document.

### Steps:
1. Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet
2. Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object
3. Read text from the reader

{{< alert style="warning" >}}
[GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null*. For empty Microsoft Office Excel spreadsheets [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns an empty [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object ([reader.ReadToEnd](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader.readtoend?view=netframework-2.0) method returns an empty string).
{{< /alert >}}

**Example:**
```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the spreadsheet
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## Method 2: Extract Text from Individual Sheets

**When to use:** When you need to process each Excel worksheet separately for your C# spreadsheet parser application, maintain sheet organization, or perform sheet-specific data extraction operations.

This Excel parsing method uses [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) to extract text from specific sheets. Each worksheet is treated as a separate page in the document parsing process.

### Steps:
1. Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet
2. Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and obtain [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) object with [page count](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount)
3. Call [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method with the sheet index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object
4. Read text from the reader

**Example:**
```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
   
    // Iterate over sheets
    for(int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a sheet number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.PageCount));
   
        // Extract a text into the reader
        using(TextReader reader = parser.GetText(p))
        {
            // Print a text from the spreadsheet sheet
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## Method 3: High-Speed Raw Text Extraction

**When to use:** When processing large Excel files or multiple spreadsheets where parsing speed is more important than formatting accuracy. Ideal for Excel data mining, content indexing, or bulk document processing scenarios in enterprise applications.

Raw mode increases text extraction performance by sacrificing formatting accuracy in the .NET parser. Use [GetText(TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/1) and [GetText(pageIndex, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) methods for high-speed raw mode extraction.

{{< alert style="warning" >}}
Some spreadsheets may have different sheet numbers in raw and accurate modes. Use [IDocumentInfo.RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) instead of [IDocumentInfo.PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) in raw mode.
{{< /alert >}}

### Steps:
1. Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet
2. Instantiate [TextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textoptions) object with *true* parameter
3. Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method
4. Use [RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) instead of [PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) to avoid extra calculations
5. Call [GetText(pageIndex, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) method with the sheet index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object
6. Read text from the reader

**Example:**
```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if (documentInfo == null || documentInfo.RawPageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
    // Iterate over sheets
    for (int p = 0; p < documentInfo.RawPageCount; p++)
    {
        // Print a sheet number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.RawPageCount));
        // Extract a text into the reader
        using (TextReader reader = parser.GetText(p, new TextOptions(true)))
        {
            // Print a text from the spreadsheet sheet
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## Method 4: Extract Formatted Text (HTML)

**When to use:** When you need to preserve the visual structure and formatting of Excel spreadsheet data using the .NET document parser, or when integrating extracted content into web applications or formatted reports.

The GroupDocs.Parser text extraction library allows extracting text from Microsoft Office Excel spreadsheets as HTML, Markdown, and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

### Steps:
1. Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet
2. Call [GetFormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object
3. Read text from the reader

**Example:**
```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // Print a formatted text from the sheet
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## Supported Excel Formats

- **.xls** - Microsoft Excel 97-2003 Workbook
- **.xlsx** - Microsoft Excel Open XML Workbook

## Common Use Cases

### Enterprise Document Processing
- **Excel Data Mining**: Extract text for search indexing and content analysis using C# parser methods
- **Spreadsheet Report Generation**: Convert Excel workbook data to text-based reports
- **Content Migration**: Move spreadsheet data between different document management systems

### Business Intelligence & Analytics
- **Text Analytics on Excel Files**: Analyze comments, notes, and text data within .xls/.xlsx spreadsheets
- **Compliance Document Processing**: Extract text content for regulatory reporting from Excel documents  
- **Audit Trails**: Document text content changes over time in spreadsheet parser workflows

### Integration Scenarios
- **Enterprise Search Systems**: Index Excel spreadsheet content for full-text search capabilities
- **Automated Data Pipelines**: Extract text as part of automated document processing workflows
- **Content Management Systems**: Process uploaded Excel files automatically using the .NET parsing API

## Performance Considerations

### File Size Impact
- **Small files** (< 1MB): All methods perform similarly
- **Medium files** (1-10MB): Raw mode provides noticeable speed improvement
- **Large files** (> 10MB): Raw mode recommended for bulk processing

### Memory Usage
- Sheet-by-sheet processing uses less memory than whole document extraction
- Raw mode is more memory-efficient for large files
- Consider processing sheets individually for very large workbooks

## Troubleshooting

### Common Issues

**Null TextReader Response**
- Verify the file format is supported (.xls, .xlsx)
- Check if the file is corrupted or password-protected
- Ensure the file path is correct and accessible

**Empty Text Output**
- Confirm the spreadsheet contains text data (not just numbers/formulas)
- Check if the sheets contain visible content
- Verify the file isn't completely empty

**Performance Issues**
- Use raw mode for large files or bulk processing
- Process sheets individually instead of extracting the entire document
- Consider file size limitations in your environment

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft Office PowerPoint presentations

Path: /parser/java/extract-text-from-microsoft-office-powerpoint/

To extract a text from Microsoft Office PowerPoint presentations [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) and [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method is used. These methods allow to extract a text from the entire presentation or a text from the selected slide.

Here are the steps to extract a text from Microsoft Office PowerPoint presentations:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns null value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns null. For empty Microsoft Office PowerPoint presentation [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).{{< /alert >}}

The following example demonstrates how to extract a text from Microsoft Office PowerPoint presentation:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePptx)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the presentation
        System.out.println(reader.readToEnd());
    }
}
```

Here are the steps to extract a text from the slide of Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and obtain [IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo) object with [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) property;
*   Call [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method with the slide index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader "class in com.groupdocs.parser.data") object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the slide of Microsoft Office PowerPoint presentation:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePptx)) {
    // Get the presentation info
    IDocumentInfo presentationInfo = parser.getDocumentInfo();
    // Iterate over slides
    for (int p = 0; p < presentationInfo.getPageCount(); p++) {
        // Print a slide number
        System.out.println(String.format("Slide %d/%d", p + 1, presentationInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p)) {
            // Print a text from the presentation
            System.out.println(reader.readToEnd());
        }
    }
}
```

Raw mode allows to increase the speed of text extraction due to poor formatting accuracy. [getText(TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(com.groupdocs.parser.options.TextOptions)) and [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) methods are used to extract a text in raw mode.

{{< alert style="warning" >}}Raw mode is not supported for password-protected presentations.{{< /alert >}}{{< alert style="warning" >}}Some presentations may have different slide numbers in raw and accurate modes. Use [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) instead of [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) in raw mode.{{< /alert >}}

Here are the steps to extract a raw text from the slide of Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Instantiate [TextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextOptions) object with *true* parameter;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method;
*   Use [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) instead of [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) to avoid extra calculations;
*   Call [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) method with the slide index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a raw text from the slide of Microsoft Office PowerPoint presentation:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePptx)) {
    // Check if the document supports text extraction
    if (!parser.getFeatures().isText()) {
        System.out.println("Document isn't supports text extraction.");
        return;
    }
    // Get the document info
    DocumentInfo documentInfo = parser.getDocumentInfo() instanceof DocumentInfo
            ? (DocumentInfo) parser.getDocumentInfo()
            : null;
    // Check if the document has pages
    if (documentInfo == null || documentInfo.getRawPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.getRawPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p, new TextOptions(true))) {
            // Print a text from the document
            // We ignore null-checking as we have checked text extraction feature support earlier
            System.out.println(reader.readToEnd());
        }
    }
}
```

GroupDocs.Parser also allows to extract a text from Microsoft Office PowerPoint presentations as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/java/developer-guide/advanced-usage/extract-data-from-various-formats/extract-data-from-microsoft-office-powerpoint/extract-metadata-from-powerpoint.md" >}}).

Here are the steps to extract a text from Microsoft Office PowerPoint presentation as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Call [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example shows how to extract a text from Microsoft Office PowerPoint presentation as HTML:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePptx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the presentation
        System.out.println(reader.readToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft Office PowerPoint presentations

Path: /parser/net/extract-text-from-microsoft-office-powerpoint-presentations/

To extract a text from Microsoft Office PowerPoint presentations [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) and [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method is used. These methods allow to extract a text from the entire presentation or a text from the selected slide.

Here are the steps to extract a text from Microsoft Office PowerPoint presentations:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial presentation;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}GetText method returns null value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive GetText method returns null. For empty Microsoft Office PowerPoint presentations GetText method returns an empty TextReader object (reader.ReadToEnd method returns an empty string).{{< /alert >}}

The following example demonstrates how to extract a text from Microsoft Office PowerPoint presentation:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the presentation
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

Here are the steps to extract a text from the sheet of Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial presentation;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and obtain [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) object with [page count](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount);
*   Call [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method with the sheet index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the slide of Microsoft Office PowerPoint presentation:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    
    // Iterate over slides
    for(int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Slide {0}/{1}", p + 1, documentInfo.PageCount));
    
        // Extract a text into the reader
        using(TextReader reader = parser.GetText(p))
        {
            // Print a text from the presentation slide
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

Raw mode allows to increase the speed of text extraction due to poor formatting accuracy. [GetText(TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/1) and [GetText(pageIndex, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) methods are used to extract a text in raw mode.

{{< alert style="warning" >}}Raw mode is not supported for password-protected presentations.{{< /alert >}}{{< alert style="warning" >}}Some presentations may have different slide numbers in raw and accurate modes. Use [IDocumentInfo.RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) instead of [IDocumentInfo.PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) in raw mode.{{< /alert >}}

Here are the steps to extract a raw text from the sheet of Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial presentation;
*   Instantiate [TextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textoptions) object with *true* parameter;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method;
*   Use [RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) instead of [PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) to avoid extra calculations;
*   Call [GetText(pageIndex, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) method with the sheet index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a raw text from the slide of Microsoft Office PowerPoint presentation:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has slides
    if (documentInfo == null || documentInfo.RawPageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
    // Iterate over slides
    for (int p = 0; p < documentInfo.RawPageCount; p++)
    {
        // Print a slide number 
        Console.WriteLine(string.Format("Slide {0}/{1}", p + 1, documentInfo.RawPageCount));
        // Extract a text into the reader
        using (TextReader reader = parser.GetText(p, new TextOptions(true)))
        {
            // Print a text from the presentation slide
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

GroupDocs.Parser also allows to extract a text from Microsoft Office PowerPoint presentations as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from Microsoft Office PowerPoint presentation as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial presentation;
*   Call [GetFormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a text from Microsoft Office PowerPoint presentation as HTML:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // Print a formatted text from the presentation
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft Office Word documents

Path: /parser/java/extract-text-from-microsoft-office-word-documents/

To extract a text from Microsoft Office Word documents [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) and [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) methods are used. These methods allow to extract a text from the entire document or a text from the selected page. [TextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextOptions) parameter is ignored for Microsoft Office Words documents.

Here are the steps to extract a text from Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns null value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns null. For empty Microsoft Office Word document [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).{{< /alert >}}

The following example demonstrates how to extract a text from Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the document
        System.out.println(reader.readToEnd());
    }
}
```

Here are the steps to extract a text from the page of Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and obtain [IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo) object with [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) property;
*   Call [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}Text extraction from Microsoft Office Word document page is more resource consuming operation. Use text extraction from the entire document where it is applicable.{{< /alert >}}

The following example demonstrates how to extract a text from the page of Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocxWithToc)) {
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Iterate over pages
    for (int p = 0; p < documentInfo.getPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p)) {
            // Print a text from the document
            System.out.println(reader.readToEnd());
        }
    }
}
```

GroupDocs.Parser also allows to extract a text from Microsoft Office Word documents as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from Microsoft Office Word document as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example shows how to extract a text from Microsoft Office Word document as HTML:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the document
        System.out.println(reader.readToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft Office Word documents

Path: /parser/net/extract-text-from-microsoft-office-word-documents/

To extract a text from Microsoft Office Word documents [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) and [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) methods are used. These methods allow to extract a text from the entire document or a text from the selected page. [TextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textoptions) parameter is ignored for Microsoft Office Words documents.

Here are the steps to extract a text from Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null*. For empty Microsoft Office Word document [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns an empty [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object ([reader.ReadToEnd](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader.readtoend?view=netframework-2.0) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract text from a Word document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract text into the reader
    using (TextReader reader = parser.GetText())
    {
        // If text extraction isn't supported, reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

Here are the steps to extract a text from the page of Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and obtain [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) object with [page count](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount);
*   Call [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method with the page index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
Text extraction from Microsoft Office Word document page is more resource consuming operation. Use text extraction from the entire document where it is applicable.
{{< /alert >}}

The following example demonstrates how to extract a text from the page of Microsoft Office Word document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
  
    // Iterate over pages
    for(int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.PageCount));
  
        // Extract a text into the reader
        using(TextReader reader = parser.GetText(p))
        {
            // Print a text from the document
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

GroupDocs.Parser also allows to extract a text from Microsoft Office Word documents as HTML, Markdown and formatted plain text. For more details, see [Extract Formatted Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/extract-formatted-text-from-document.md" >}}).

Here are the steps to extract a text from Microsoft Office Word document as HTML:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetFormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a text from Microsoft Office Word document as HTML:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // Print a formatted text from the document
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)
    
### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft OneNote sections

Path: /parser/java/extract-text-from-microsoft-onenote-sections/

To extract a text from Microsoft OneNote Sections [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) and [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) methods are used. These methods allow to extract a text from the entire document or a text from the selected page. Raw mode is not supported for Microsoft OneNote.

Here are the steps to extract a text from Microsoft OneNote Section:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial section;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null*. For empty Microsoft OneNote Section [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).  
{{< /alert >}}
  
The following example demonstrates how to extract a text from Microsoft OneNote Section:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleOne)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the section
        System.out.println(reader.readToEnd());
    }
}
```

Here are the steps to extract a text from the page of Microsoft OneNote Section:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial section;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and obtain [IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo) object with [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) property;
*   Call [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the page of Microsoft OneNote Section:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleOne)) {
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Iterate over pages
    for (int p = 0; p < documentInfo.getPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p)) {
            // Print a text from the section page
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from Microsoft OneNote sections

Path: /parser/net/extract-text-from-microsoft-onenote-sections/

To extract a text from Microsoft OneNote Sections [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) and [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) methods are used. These methods allow to extract a text from the entire document or a text from the selected page. Raw mode is not supported for Microsoft OneNote.

Here are the steps to extract a text from Microsoft OneNote Section:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial section;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null*. For empty Microsoft OneNote Section [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns an empty [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object ([reader.ReadToEnd](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader.readtoend?view=netframework-2.0) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from Microsoft OneNote Section:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the section
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

Here are the steps to extract a text from the page of Microsoft OneNote Section:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial section;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and obtain [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) object with [page count](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount);
*   Call [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method with the page index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the page of Microsoft OneNote Section:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
   
    // Iterate over pages
    for(int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.PageCount));
   
        // Extract a text into the reader
        using(TextReader reader = parser.GetText(p))
        {
            // Print a text from the section
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from PDF documents

Path: /parser/java/extract-text-from-pdf-documents/

To extract a text from PDF documents [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) and [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) methods are used. These methods allow to extract a text from the entire document or a text from the selected page.

Here are the steps to extract a text from PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader ) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns *null*. For empty PDF document [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method returns an empty [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object ([readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract a text from PDF document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the document
        System.out.println(reader.readToEnd());
    }
}
```

Here are the steps to extract a text from the page of PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and obtain [IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo "interface in com.groupdocs.parser.options") object with [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) property;
*   Call [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the page of PDF document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Iterate over pages
    for (int p = 0; p < documentInfo.getPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p)) {
            // Print a text from the document page
            System.out.println(reader.readToEnd());
        }
    }
}
```
Raw mode allows to increase the speed of text extraction due to poor formatting accuracy. [getText(TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(com.groupdocs.parser.options.TextOptions)) and [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) methods are used to extract a text in raw mode.

{{< alert style="warning" >}}
Some documents may have different page numbers in raw and accurate modes. Use [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) instead of [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) in raw mode.
{{< /alert >}}

Here are the steps to extract a raw text from the page of PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [TextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextOptions) object with *true* parameter;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method;
*   Use [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) instead of [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) to avoid extra calculations;
*   Call [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a raw text from the page of PDF document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Check if the document supports text extraction
    if (!parser.getFeatures().isText()) {
        System.out.println("Document isn't supports text extraction.");
        return;
    }
    // Get the document info
    DocumentInfo documentInfo = parser.getDocumentInfo() instanceof DocumentInfo
            ? (DocumentInfo) parser.getDocumentInfo()
            : null;
    // Check if the document has pages
    if (documentInfo == null || documentInfo.getRawPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.getRawPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p, new TextOptions(true))) {
            // Print a text from the document
            // We ignore null-checking as we have checked text extraction feature support earlier
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from PDF documents

Path: /parser/net/extract-text-from-pdf-documents/

To extract a text from PDF documents [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) and [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method is used. These methods allow to extract a text from the entire document or a text from the selected page.

Here are the steps to extract a text from PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

{{< alert style="warning" >}}
[GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null* value if text extraction isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns *null*. For empty PDF document [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method returns an empty [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object ([reader.ReadToEnd](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader.readtoend?view=netframework-2.0) method returns an empty string).
{{< /alert >}}

The following example demonstrates how to extract text from a PDF document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract text into the reader
    using (TextReader reader = parser.GetText())
    {
        // If text extraction isn't supported, reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

Here are the steps to extract a text from the page of PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and obtain [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) object with [page count](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount);
*   Call [GetText(pageIndex)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method with the page index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a text from the page of PDF document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
   
    // Iterate over pages
    for(int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.PageCount));
   
        // Extract a text into the reader
        using(TextReader reader = parser.GetText(p))
        {
            // Print a text from the document
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

Raw mode allows to increase the speed of text extraction due to poor formatting accuracy. [GetText(TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/1) and [GetText(pageIndex, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) methods are used to extract a text in raw mode.

{{< alert style="warning" >}}
Some documents may have different page numbers in raw and accurate modes. Use [DocumentInfo.RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) instead of [IDocumentInfo.PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) in raw mode.
{{< /alert >}}

Here are the steps to extract a raw text from the page of PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [TextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textoptions) object with *true* parameter;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo);
*   Use [RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) instead of [PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) to avoid extra calculations;
*   Call [GetText(pageIndex, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) method with the sheet index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example demonstrates how to extract a raw text from the page of PDF document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if (documentInfo == null || documentInfo.RawPageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.RawPageCount; p++)
    {
        // Print a pagenumber 
        Console.WriteLine(string.Format("Slide {0}/{1}", p + 1, documentInfo.RawPageCount));
        // Extract a text into the reader
        using (TextReader reader = parser.GetText(p, new TextOptions(true)))
        {
            // Print a text from the document page
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from ZIP archive files

Path: /parser/java/extract-text-from-zip-archive-files/

To extract files from ZIP archives [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects.

Zip Entry can contain the following metadata:

| Name | Description |
| --- | --- |
| date | The time and date at which the file indicated by the Zip Entry was last modified. |
| crc | The 32-bit CRC (Cyclic Redundancy Check) on the contents of the Zip Entry. |

These metadata refer to a container element itself, not a document.

Here are the steps to extract an email text from Zip archives:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and obtain [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object to extract a text.

The following example shows how to extract a text from Zip archives:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleZip)) {
    // Extract attachments from the container
    Iterable<ContainerItem> attachments = parser.getContainer();
    // Check if container extraction is supported
    if (attachments == null) {
        System.out.println("Container extraction isn't supported");
    }
    // Iterate over zip entities
    for (ContainerItem item : attachments) {
        // Print the file path
        System.out.println(item.getFilePath());
        // Print metadata
        for (MetadataItem metadata : item.getMetadata()) {
            System.out.println(String.format("%s: %s", metadata.getName(), metadata.getValue()));
        }
        try {
            // Create Parser object for the zip entity content
            try (Parser attachmentParser = item.openParser()) {
                // Extract an zip entity text
                try (TextReader reader = attachmentParser.getText()) {
                    System.out.println(reader == null ? "No text" : reader.readToEnd());
                }
            }
        } catch (UnsupportedDocumentFormatException ex) {
            System.out.println("Isn't supported.");
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free Online Document Parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from ZIP archive files

Path: /parser/net/extract-text-from-zip-archive-files/

To extract files from ZIP archives [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects.

Zip Entry can contain the following metadata:

| Name | Description |
| --- | --- |
| date | The time and date at which the file indicated by the Zip Entry was last modified. |

These metadata refer to a container element itself, not a document.

Here are the steps to extract an email text from Zip archives:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial archive;
*   Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and get container item names, sizes and obtain content.

The following example shows how to extract a text from Zip archives:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();

    // Iterate over files
    foreach(ContainerItem item in attachments)
    {
		// Print the file path
		Console.WriteLine(item.FilePath);

        // Print metadata
        foreach(MetadataItem metadata in item.Metadata)
        {
            Console.WriteLine(string.Format("{0}: {1}", metadata.Name, metadata.Value));
        }
       
        try
        {
            // Create Parser object for the file content
            using (Parser fileParser = item.OpenParser())
            {
                // Extract the file text
                using (TextReader reader = fileParser.GetText())
                {
                    Console.WriteLine(reader == null ? "No text" : reader.ReadToEnd());
                }
            }
        }
        catch (UnsupportedDocumentFormatException)
        {
            Console.WriteLine("Isn't supported.");
        }
	}
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free Online Document Parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text in Accurate mode

Path: /parser/net/extract-text-in-accurate-mode/

GroupDocs.Parser provides the functionality to extract text from documents.

The **Accurate** mode is default text extraction mode and it means that text quality wlll be the best possible.

You can extract the whole document text or only a document page.

To extract a text from the document in the Accurate mode, [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) and [GetText(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) methods of [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) class are used:

```csharp
TextReader GetText();
TextReader GetText(int pageIndex);
```

Methods return an instance of [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) class with the extracted text. The first method extracts text from the whole document. The second method extracts text from the document page. To retrieve the total number of document pages [GetDocumentIn](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo)[fo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo)  method is used (see below).

## Extract text

Here are the steps to extract text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Check if *reader* isn't null (text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract text from a document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## Extract text from a document page

Here are the steps to extract text from a document page:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [Features.Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/text) property to check if text extraction is supported for the document;
*   Call [GetText(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method with the page index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a text from the document page:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Check if the document supports text extraction
    if(!parser.Features.Text)
    {
        Console.WriteLine("Document isn't supports text extraction.");
        return;   
	}

    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if(documentInfo.PageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
 
    // Iterate over pages
    for(int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.PageCount));
 
        // Extract a text into the reader
        using(TextReader reader = parser.GetText(p))
        {
            // Print a text from the document
            // We ignore null-checking as we have checked text extraction feature support earlier
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text in Accurate mode

Path: /parser/python-net/extract-text-in-accurate-mode/


GroupDocs.Parser provides the functionality to extract text from documents with the highest quality.

The **Accurate** mode is the default text extraction mode, providing the best possible text quality from documents.

You can extract text from the entire document or from individual pages.

## Prerequisites

Before you begin, ensure you have:
- GroupDocs.Parser for Python via .NET installed
- A valid license or trial
- Sample documents for testing

## Extract text from document

To extract text from the entire document in Accurate mode, use the `get_text()` method:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Extract text from the document
    text_reader = parser.get_text()
    
    # Check if text extraction is supported
    if text_reader is None:
        print("Text extraction isn't supported")
    else:
        # Print the extracted text
        print(text_reader)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** The method returns a `TextReader` object containing the entire document text, or `None` if text extraction is not supported for the document format.

## Extract text from document page

To extract text from a specific page:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Check if text extraction is supported
    if not parser.features.text:
        print("Document doesn't support text extraction")
        return
    
    # Get document info
    info = parser.get_document_info()
    
    # Check if document has pages
    if info.page_count == 0:
        print("Document has no pages")
        return
    
    # Iterate over pages
    for page_index in range(info.page_count):
        # Print page number
        print(f"
Page {page_index + 1}/{info.page_count}")
        
        # Extract text from the page
        text_reader = parser.get_text(page_index)
        
        # Print the page text
        if text_reader is not None:
            print(text_reader)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** The method extracts text from each page individually, allowing you to process documents page by page.

## Extract text with error handling

Here's a robust example with error handling:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_text_safely(file_path):
    try:
        with Parser(file_path) as parser:
            # Check feature support
            if not parser.features.text:
                print(f"Text extraction not supported for {file_path}")
                return None
            
            # Extract text
            text_reader = parser.get_text()
            if text_reader is not None:
                return text_reader
            
    except Exception as e:
        print(f"Error extracting text: {e}")
        return None

# Usage
text = extract_text_safely("sample.docx")
if text:
    print(f"Extracted {len(text)} characters")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Notes

- **Accurate mode** is the default and provides the best text quality
- The `get_text()` method returns `None` if text extraction is not supported
- Use `parser.features.text` to check if text extraction is available before calling `get_text()`
- For better performance with large documents, consider extracting text page by page

## Related pages

- [Extract text in Raw mode]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-in-raw-mode" >}})
- [Search text in documents]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/search-text" >}})
- [Extract text areas]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-areas" >}})


---

## Extract text in Accurate Mode

Path: /parser/java/extract-text-in-accurate-mode/

GroupDocs.Parser provides the functionality to extract text from documents.

The **Accurate** mode is default text extraction mode and it means that text quality will be the best possible.

You can extract the whole document text or only a document page.

To extract a text from the document in the Accurate mode, [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) and [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) methods are used:

```java
TextReader getText();
TextReader getText(int pageIndex);
```

The methods return an instance of [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class with an extracted text. The first method extracts a text from the whole document. The second method extracts a text from the document page. To retrieve the total number of document pages [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method is used (see below).

[TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class extends [*java.io.Reader*](http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true) and adds the following members:

| Member | Description |
| --- | --- |
| [readLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readLine()) | Reads a line of characters from the text reader and returns the data as a string. |
| [readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) | Reads all characters from the current position to the end of the text reader and returns them as one string. |

## Extract text

Here are the steps to extract a text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Check if *reader* isn't *null* (text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a text from a document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
} 
```

## Extract text from page

Here are the steps to extract a text from the document page:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [isText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isText()) property to check if text extraction is supported for the document;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method;
*   Call [getText(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader "class in com.groupdocs.parser.data") object;
*   Read a text from *reader*.

The following example shows how to extract a text from the document page:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Check if the document supports text extraction
    if (!parser.getFeatures().isText()) {
        System.out.println("Document isn't supports text extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Check if the document has pages
    if (documentInfo.getPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.getPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p)) {
            // Print a text from the document
            // We ignore null-checking as we have checked text extraction feature support earlier
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extracting common image information

Path: /metadata/java/extracting-common-image-information/

For all supported image formats the GroupDocs.Metadata API allows extracting common image properties such as width and height, MIME type, byte order, etc. Please see the code snippet below for more information on the feature.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an image
2.  Extract the root metadata package
3.  Use the [getImageType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ImageRootPackage#getImageType()) method to obtain file format information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.ImageReadFileFormatProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPng)) {
	ImageRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getImageType().getFileFormat());
	System.out.println(root.getImageType().getByteOrder());
	System.out.println(root.getImageType().getMimeType());
	System.out.println(root.getImageType().getExtension());
	System.out.println(root.getImageType().getWidth());
	System.out.println(root.getImageType().getHeight());
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Extracting Common Image Information

Path: /metadata/net/extracting-common-image-information/

For all supported image formats the GroupDocs.Metadata API allows extracting common image properties such as width and height, MIME type, byte order, etc. Please see the code snippet below for more information on the feature.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an image
2.  Extract the root metadata package
3.  Use the [FileType](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/imagerootpackage/properties/filetype) property to obtain file format information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.ImageReadFileFormatProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPng))
{
	var root = metadata.GetRootPackage<ImageRootPackage>();

	Console.WriteLine(root.FileType.FileFormat);
	Console.WriteLine(root.FileType.ByteOrder);
	Console.WriteLine(root.FileType.MimeType);
	Console.WriteLine(root.FileType.Extension);
	Console.WriteLine(root.FileType.Width);
	Console.WriteLine(root.FileType.Height);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Extracting MakerNote metadata

Path: /metadata/java/extracting-makernote-metadata/

## What is MakerNote?

MakerNote metadata refers to image information that is written by digital cameras of different manufacturers. Usually, MakerNote metadata properties contain camera settings and some other conditions under which the shot was taken. Most manufacturers store MakerNote properties in a proprietary binary format derived from EXIF. GroupDocs.Metadata allows extracting MakerNote metadata saved by the following manufacturers:

*   Canon
*   Nikon
*   Panasonic
*   Sony

## Read all MakerNote properties in the form of TIFF/EXIF tags

Utilizing the GroupDocs.Metadata API the user is able to read all metadata properties regardless of the exact MakerNote format.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a raw image file that contains MakerNote metadata
2.  Extract the MakerNote package using the [getMakerNotePackage](https://reference.groupdocs.com/java/metadata/com.groupdocs.metadata.core/JpegRootPackage#getMakerNotePackage()) method
3.  Iterate through the EXIF tags 

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.jpeg.maker\_note.MakerNoteReadAllTags**

```csharp
try (Metadata metadata = new Metadata(Constants.CanonJpeg)) {
	JpegRootPackage root = metadata.getRootPackageGeneric();
	if (root.getMakerNotePackage() != null) {
		for (TiffTag tag : root.getMakerNotePackage().toList()) {

			// Please note that tag ids used by camera manufacturers may intersect with the ids defined in the TIFF/EXIF specification
			System.out.println(String.format("%s = %s", tag.getTagID(), tag.getValue()));
		}
	}
}
```

To help you with interpreting extracted tags we implemented classes representing specific MakerNote metadata packages. Please cast the return value of the [getMakerNotePackage](https://reference.groupdocs.com/java/metadata/com.groupdocs.metadata.core/JpegRootPackage#getMakerNotePackage()) method to one of the classes listed below to get more format-specific capabilities:

*   [CanonMakerNotePackage](https://reference.groupdocs.com/java/metadata/com.groupdocs.metadata.core/CanonMakerNotePackage)
*   [NikonMakerNotePackage](https://reference.groupdocs.com/java/metadata/com.groupdocs.metadata.core/NikonMakerNotePackage)
*   [PanasonicMakerNotePackage](https://reference.groupdocs.com/java/metadata/com.groupdocs.metadata.core/PanasonicMakerNotePackage)
*   [SonyMakerNotePackage](https://reference.groupdocs.com/java/metadata/com.groupdocs.metadata.core/SonyMakerNotePackage)

## Read Canon MakerNote properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.jpeg.maker\_note.MakerNoteReadCanonProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.CanonJpeg)) {
	JpegRootPackage root = metadata.getRootPackageGeneric();
	CanonMakerNotePackage makerNote = (CanonMakerNotePackage) root.getMakerNotePackage();
	if (makerNote != null) {
		System.out.println(makerNote.getCanonFirmwareVersion());
		System.out.println(makerNote.getCanonImageType());
		System.out.println(makerNote.getOwnerName());
		System.out.println(makerNote.getCanonModelID());

		// ...

		if (makerNote.getCameraSettings() != null) {
			System.out.println(makerNote.getCameraSettings().getAFPoint());
			System.out.println(makerNote.getCameraSettings().getCameraIso());
			System.out.println(makerNote.getCameraSettings().getContrast());
			System.out.println(makerNote.getCameraSettings().getDigitalZoom());

			// ...
		}
	}
} 
```

## Read Nikon MakerNote properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.jpeg.maker\_note.MakerNoteReadNikonProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.NikonJpeg)) {
	JpegRootPackage root = metadata.getRootPackageGeneric();
	NikonMakerNotePackage makerNote = (NikonMakerNotePackage) root.getMakerNotePackage();
	if (makerNote != null) {

		System.out.println(makerNote.getColorMode());
		System.out.println(makerNote.getFlashSetting());
		System.out.println(makerNote.getFlashType());
		System.out.println(makerNote.getFocusMode());
		System.out.println(makerNote.getQuality());
		System.out.println(makerNote.getSharpness());

		// ...
	}
}
```

## Read Panasonic MakerNote properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.jpeg.maker\_note.MakerNoteReadPanasonicProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.PanasonicJpeg)) {
	JpegRootPackage root = metadata.getRootPackageGeneric();
	PanasonicMakerNotePackage makerNote = (PanasonicMakerNotePackage) root.getMakerNotePackage();
	if (makerNote != null) {

		System.out.println(makerNote.getAccessorySerialNumber());
		System.out.println(makerNote.getAccessoryType());
		System.out.println(makerNote.getMacroMode());
		System.out.println(makerNote.getLensSerialNumber());
		System.out.println(makerNote.getLensType());

		// ...
	}
} 
```

## Read Sony MakerNote properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.jpeg.maker\_note.MakerNoteReadSonyProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.SonyJpeg)) {
	JpegRootPackage root = metadata.getRootPackageGeneric();
	SonyMakerNotePackage makerNote = (SonyMakerNotePackage) root.getMakerNotePackage();
	if (makerNote != null) {

		System.out.println(makerNote.getCreativeStyle());
		System.out.println(makerNote.getColorMode());
		System.out.println(makerNote.getJpegQuality());
		System.out.println(makerNote.getBrightness());
		System.out.println(makerNote.getSharpness());

		// ...
	}
} 
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Extracting MakerNote Metadata

Path: /metadata/net/extracting-makernote-metadata/

### What is MakerNote?

MakerNote metadata refers to image information that is written by digital cameras of different manufacturers. Usually, MakerNote metadata properties contain camera settings and some other conditions under which the shot was taken. Most manufacturers store MakerNote properties in a proprietary binary format derived from EXIF. GroupDocs.Metadata allows extracting MakerNote metadata saved by the following manufacturers:

*   Canon
*   Nikon
*   Panasonic
*   Sony

### Read all MakerNote Properties in the Form of TIFF/EXIF Tags

Utilizing the GroupDocs.Metadata API the user is able to read all metadata properties regardless of the exact MakerNote format.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a raw image file that contains MakerNote metadata
2.  Extract the MakerNote package using the [MakerNotePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/jpegrootpackage/properties/makernotepackage) property
3.  Iterate through the EXIF tags 

```csharp
using (Metadata metadata = new Metadata(Constants.CanonJpeg))
{
	var root = metadata.GetRootPackage<JpegRootPackage>();
	if (root.MakerNotePackage != null)
	{
		foreach (var tag in root.MakerNotePackage.ToList())
		{
			// Please note that tag ids used by camera manufacturers may intersect with the ids defined in the TIFF/EXIF specification
			Console.WriteLine("{0} = {1}", (int) tag.TagID, tag.Value);
		}
	}
}
```

To help you with interpreting extracted tags we implemented classes representing specific MakerNote metadata packages. Please cast the return value of the [MakerNotePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/jpegrootpackage/properties/makernotepackage) property to one of the classes listed below to get more format-specific capabilities:

*   [CanonMakerNotePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif.makernote/canonmakernotepackage)
*   [NikonMakerNotePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif.makernote/nikonmakernotepackage)
*   [PanasonicMakerNotePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif.makernote/panasonicmakernotepackage)
*   [SonyMakerNotePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif.makernote/sonymakernotepackage)

### Read Canon MakerNote Properties

```csharp
using (Metadata metadata = new Metadata(Constants.CanonJpeg))
{
	var root = metadata.GetRootPackage<JpegRootPackage>();
	var makerNote = (CanonMakerNotePackage)root.MakerNotePackage;
	if (makerNote != null)
	{
		Console.WriteLine(makerNote.CanonFirmwareVersion);
		Console.WriteLine(makerNote.CanonImageType);
		Console.WriteLine(makerNote.OwnerName);
		Console.WriteLine(makerNote.CanonModelID);

		// ...

		if (makerNote.CameraSettings != null)
		{
			Console.WriteLine(makerNote.CameraSettings.AFPoint);
			Console.WriteLine(makerNote.CameraSettings.CameraIso);
			Console.WriteLine(makerNote.CameraSettings.Contrast);
			Console.WriteLine(makerNote.CameraSettings.DigitalZoom);

			// ...
		}
	}
}
```

### Read Nikon MakerNote Properties

```csharp
using (Metadata metadata = new Metadata(Constants.NikonJpeg))
{
	var root = metadata.GetRootPackage<JpegRootPackage>();
	var makerNote = (NikonMakerNotePackage) root.MakerNotePackage;
	if (makerNote != null)
	{
		Console.WriteLine(makerNote.ColorMode);
		Console.WriteLine(makerNote.FlashSetting);
		Console.WriteLine(makerNote.FlashType);
		Console.WriteLine(makerNote.FocusMode);
		Console.WriteLine(makerNote.Quality);
		Console.WriteLine(makerNote.Sharpness);

		// ...
	}
}
```

### Read Panasonic MakerNote Properties

```csharp
using (Metadata metadata = new Metadata(Constants.PanasonicJpeg))
{
	var root = metadata.GetRootPackage<JpegRootPackage>();
	var makerNote = (PanasonicMakerNotePackage) root.MakerNotePackage;

	if (makerNote != null)
	{
		Console.WriteLine(makerNote.AccessorySerialNumber);
		Console.WriteLine(makerNote.AccessoryType);
		Console.WriteLine(makerNote.MacroMode);
		Console.WriteLine(makerNote.LensSerialNumber);
		Console.WriteLine(makerNote.LensType);

		// ...
	}
}
```

### Read Sony MakerNote Properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Jpeg.MakerNote.MakerNote.MakerNote.MakerNoteReadSonyProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.SonyJpeg))
{
	var root = metadata.GetRootPackage<JpegRootPackage>();
	var makerNote = (SonyMakerNotePackage)root.MakerNotePackage;
	if (makerNote != null)
	{
		Console.WriteLine(makerNote.CreativeStyle);
		Console.WriteLine(makerNote.ColorMode);
		Console.WriteLine(makerNote.JpegQuality);
		Console.WriteLine(makerNote.Brightness);
		Console.WriteLine(makerNote.Sharpness);

		// ...
	}
}
```

---

## Features overview

Path: /conversion/net/features-overview/


## File conversion
This article describes the salient features of file conversion API using C#.

GroupDocs.Conversion main feature is the ability to convert any document from any of supported source document formats into any supported target format (check the list of [supported formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})). All these conversions are possible without any additional software installed (like Microsoft Office, Apache Open Office, Adobe Acrobat Reader and others).
GroupDocs.Conversion provides a flexible set of settings to customize the conversion process to fulfill your needs:

### Convert specific document page(s)

Along with the whole document conversion to the desired target format, it could be useful to convert specific document pages or page ranges. For such partial document conversion, you should specify desired page numbers to convert using the [Pages](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pages) property of the `ConvertOptions` class.

### Auto-detect source document format

In some cases, the source file could be presented in a form of a byte stream, so the file extension is unknown.
Luckily GroupDocs.Conversion for .NET is smart enough to [detect source document format](({{< ref "conversion/net/developer-guide/advanced-usage/loading/loading-files-from-different-sources/load-file-from-stream.md#get-information-about-files-from-a-stream" >}})) on the fly.

### Load source document with extended options

There are lots of modifications that are possible during the file conversion process:

- specify a password for [password-protected documents]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-password-protected-document.md" >}});
- show/hide document [comments]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-wordprocessing-document-with-options.md" >}}) and [annotations]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-pdf-document-with-options.md" >}});
- [show/hide markup and track changes]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-wordprocessing-document-with-options.md" >}}) for Word documents;
- [show hidden sheets]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-spreadsheet-document-with-options.md" >}}) when converting Excel files or not;
- set the [text file encoding]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-txt-document-with-options.md" >}}) and many more;

### Obtain all supported conversion formats list

You can obtain the [complete list of possible conversions]({{< ref "conversion/net/developer-guide/basic-usage/get-possible-conversions.md" >}}) that are supported by GroupDocs.Conversion for .NET library. Also, it is possible to get [allowed conversions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/get-default-convert-options-for-target-format.md" >}}) for the specific file format.

### Fonts replacement

It is a common use case when a source document references some specific fonts that are not present in the environment where you launch your application. GroupDocs.Conversion for .NET provides a solution - you can [substitute missing fonts]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-wordprocessing-document-with-options#specify-font-substitution" >}}) with fonts of your choice that will preserve your document appearance.

### Watermarking converted document

You can [add a text or an image watermark]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/add-watermark.md" >}}) to any page of the converted document and choose its desired dimensions, color and font size.

## Document information extraction

GroupDocs.Conversion allows to obtain basic [information about source document]({{< ref "conversion/net/developer-guide/basic-usage/get-document-info.md" >}}) - file type, pages count etc. Dependent on the source file type some format-specific information can be extracted, for example:

- [CAD]({{< ref "conversion/net/developer-guide/basic-usage/get-document-info.md#cad-drawings" >}}) - list of layers and layouts in a CAD document;
- [Email]({{< ref "conversion/net/developer-guide/basic-usage/get-document-info.md#emails" >}}) – list of attachments;
- [PDF]({{< ref "conversion/net/developer-guide/basic-usage/get-document-info.md#pdf-documents" >}}) – title, author, table of contents and more;
- [Project Management]({{< ref "conversion/net/developer-guide/basic-usage/get-document-info.md#project-management-documents" >}}) – project start and end dates.

## Load documents from different sources

With GroupDocs.Conversion you are not limited to [local files]({{< ref "conversion/net/developer-guide/advanced-usage/loading/loading-files-from-different-sources/load-file-from-local-disk.md" >}}) only. It also supports loading documents from [stream]({{< ref "conversion/net/developer-guide/advanced-usage/loading/loading-files-from-different-sources/load-file-from-stream.md" >}}), [FTP]({{< ref "conversion/net/developer-guide/advanced-usage/loading/loading-files-from-different-sources/load-file-from-ftp.md" >}}), [remote URLs]({{< ref "conversion/net/developer-guide/advanced-usage/loading/loading-files-from-different-sources/load-file-from-url.md" >}}), as wel as from [Amazon S3]({{< ref "conversion/net/developer-guide/advanced-usage/loading/loading-files-from-different-sources/load-file-from-amazon-s3-storage.md" >}}) and [Azure]({{< ref "conversion/net/developer-guide/advanced-usage/loading/loading-files-from-different-sources/load-file-from-azure-blob-storage.md" >}}) clouds.

## Caching results

GroupDocs.Conversion supports [conversion result caching]({{< ref "conversion/net/developer-guide/advanced-usage/caching/" >}}) to local disk by default. However, any type of cache storage can be supported by implementing appropriate interfaces – Amazon S3, Dropbox, Google Drive, Windows Azure, Redis or any other.


---

## Features overview

Path: /conversion/nodejs-java/features-overview/

## File conversion

GroupDocs.Conversion main feature is the ability to convert any document from any of supported source document formats into any supported target format (check the list of [supported formats]({{< ref "conversion/nodejs-java/getting-started/supported-document-formats.md" >}})). All these conversions are possible without any additional software installed (like MS Office, Apache Open Office, Adobe Acrobat Reader and others).
GroupDocs.Conversion provides a flexible set of settings to customize the conversion process to fulfill your needs:

### Convert specific document page(s)

Along with the whole document conversion to the desired target format, it could be useful to convert specific document pages or page ranges.

### Auto-detect source document format

In some cases, the source file could be presented in a form of a byte stream, so the file extension is unknown.
Luckily GroupDocs.Conversion for Node.js via Java is smart enough to detect source document format on the fly.

### Load source document with extended options

There are lots of modifications that are possible during the file conversion process:

- specify a password for [password-protected documents]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/load-password-protected-document.md" >}});
- show/hide document [comments]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-wordprocessing-document-with-options.md" >}}) and [annotations]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-pdf-document-with-options.md" >}});
- [show/hide markup and track changes]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-wordprocessing-document-with-options.md" >}}) for Word documents;
- [show hidden sheets]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-spreadsheet-document-with-options.md" >}}) when converting Excel files or not;
- set the [text file encoding]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-txt-document-with-options.md" >}}) and many more;

### Obtain all supported conversion formats list

You can obtain the [complete list of possible conversions]({{< ref "conversion/nodejs-java/developer-guide/basic-usage/get-possible-conversions.md" >}}) that are supported by GroupDocs.Conversion for Node.js via Java library. Also, it is possible to get allowed conversions for the specific file format.

### Fonts replacement

It is a common use case when a source document references some specific fonts that are not present in the environment where you launch your application. GroupDocs.Conversion for Node.js via Java provides a solution - you can [substitute missing fonts]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-wordprocessing-document-with-options#specify-font-substitution" >}}) with fonts of your choice that will preserve your document appearance.

## Document information extraction

GroupDocs.Conversion allows to obtain basic [information about source document]({{< ref "conversion/nodejs-java/developer-guide/basic-usage/get-document-info.md" >}}) - file type, pages count etc. Dependent on the source file type some format-specific information can be extracted, for example:

- CAD - list of layers and layouts in a CAD document;
- Email – list of attachments;
- PDF – title, author, table of contents and more;
- Project Management – project start and end dates.

## Load documents from different sources

With GroupDocs.Conversion you are not limited to [local files]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/loading-documents-from-different-sources/load-document-from-local-disk.md" >}}) only. It also supports loading documents from [stream]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/loading-documents-from-different-sources/load-document-from-stream.md" >}}) and [remote URLs]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/loading/loading-documents-from-different-sources/load-document-from-url.md" >}}).

---

## Features overview

Path: /markdown/net/features-overview/


## Overview

GroupDocs.Markdown for .NET converts documents from various formats into clean, structured Markdown. It uses a custom DOM-based renderer that gives full control over every aspect of the output.

## Supported Input Formats

Convert from 20+ document formats including Word (DOCX, DOC, RTF), Excel (XLSX, XLS, CSV), PDF, EPUB, MOBI, TXT, and CHM. See the full list of [supported formats]({{< ref "markdown/net/getting-started/supported-document-formats.md" >}}).

## Key Features

### Static Convenience Methods

One-liner conversions that throw on failure — no result-checking ceremony:

```csharp
string md = MarkdownConverter.ToMarkdown("business-plan.docx");
MarkdownConverter.ToFile("business-plan.docx", "output.md");
```

### Markdown Flavor Control

Target GitHub Flavored Markdown (pipe tables, strikethrough) or strict CommonMark:

```csharp
var options = new ConvertOptions { Flavor = MarkdownFlavor.GitHub };
```

### Flexible Image Handling

Choose how images are processed during conversion:
- **Base64 embedding** — images inline in the Markdown (default)
- **File system export** — save images to disk with relative paths
- **Skip** — omit images from the output
- **Custom** — rename, replace, or redirect images via callback

### YAML Front Matter

Extract document metadata into YAML front matter for static site generators (Jekyll, Hugo, Docusaurus):

```csharp
var options = new ConvertOptions { IncludeFrontMatter = true };
```

### Heading Level Offset

Shift all heading levels when embedding converted content inside a larger document:

```csharp
var options = new ConvertOptions { HeadingLevelOffset = 2 };
// # Title → ### Title
```

### Spreadsheet Options

Control how Excel and CSV tables are rendered:
- Column and row truncation with ellipsis indicators
- Custom sheet separators
- Hidden worksheet filtering

### Document Inspection

Retrieve document metadata (format, page count, title, author) without performing a full conversion:

```csharp
DocumentInfo info = MarkdownConverter.GetInfo("business-plan.docx");
```

### Page Selection

Convert specific pages or worksheets instead of the full document:

```csharp
var options = new ConvertOptions { PageNumbers = new[] { 1, 3, 5 } };
```

### Relative Image Paths

Control how image file paths appear in the Markdown output:

```csharp
var strategy = new ExportImagesToFileSystemStrategy("output/images")
{
    ImagesRelativePath = "images"
};
```

### Image Replacement

Replace images in the source document with different images during conversion using `IImageSavingHandler`.

### Async API

All static and instance methods have async counterparts with true async file I/O:

```csharp
string md = await MarkdownConverter.ToMarkdownAsync("business-plan.docx");
```

### Proper Error Handling

Specific exception types for common error scenarios:
- `DocumentProtectedException` — wrong or missing password
- `InvalidFormatException` — corrupt or unrecognized file
- `GroupDocsMarkdownException` — general conversion error

### Conversion Warnings

Non-fatal issues are reported via `ConvertResult.Warnings` — for example, when spreadsheet tables are truncated.

### Password-Protected Documents

Load encrypted documents by providing a password via `LoadOptions`:

```csharp
var loadOptions = new LoadOptions(FileFormat.Docx) { Password = "secret" };
```

### Cross-Platform Support

Works on Windows, Linux, and macOS with .NET Framework 4.6.2+, .NET 6.0+, .NET 8.0+, and .NET 10.0+.

---

## Features overview

Path: /merger/nodejs-java/features-overview/

  
## Node.js Merger API Features 
- Join two or more documents into one document, join specific pages or page ranges from several source documents into single resultant document.
- Split a source document to several resultant documents.
- Move page to another position within a document.
- Remove single page or a collection of specific page numbers from the source document.
- Rotate pages within document by setting rotation angle to 90,180 or 270 degrees.
- Swap two pages positions within the source document. The result is a new document where two pages have their positions exchanged.
- Extract specified page or page ranges from source document. The result is a new document that contains only specified pages from the source document.
- Change orientation operation lets to set page orientation (portrait, landscape) for specific or all pages of the document.
- Manage document password protection: add/update/delete document password and check its existence.
- Get the basic information about source document - file type, size, pages count, page height and width etc.
- Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure. Preview can be generated for all document pages (by default) or for specific page numbers or page range.


---

## Features overview

Path: /merger/python-net/features-overview/

  
## Python Merger API Features 
- Join two or more documents into one document, join specific pages or page ranges from several source documents into single resultant document.
- Split a source document to several resultant documents.
- Move page to another position within a document.
- Remove single page or a collection of specific page numbers from the source document.
- Rotate pages within document by setting rotation angle to 90,180 or 270 degrees.
- Swap two pages positions within the source document. The result is a new document where two pages have their positions exchanged.
- Extract specified page or page ranges from source document. The result is a new document that contains only specified pages from the source document.
- Change orientation operation lets to set page orientation (portrait, landscape) for specific or all pages of the document.
- Manage document password protection: add/update/delete document password and check its existence.
- Get the basic information about source document - file type, size, pages count, page height and width etc.
- Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure. Preview can be generated for all document pages (by default) or for specific page numbers or page range.


---

## Features overview

Path: /viewer/java/features-overview/

  
## Rendering Documents

We use the term ["rendering"]({{< ref "viewer/java/developer-guide/rendering-documents/_index.md" >}}) in GroupDocs.Viewer to describe the process of converting a document into a file format, paginated, or that has the concept of pages. For example, when you have a DOCX file with three pages then after rendering this file to HTML you will get three HTML files on the output that represent each of the pages in the document.

![Rendering diagram](/viewer/net/images/getting-started/features-overview/rendering.png)

### Rendering to HTML

Rendering to HTML will suit the best when you have the following requirements:

* You are writing a web-based application;
* Document content should be displayed inside web-browser;
* You need an ability to interact with rendered document text - select, copy or search;
* You want to view document pages separately;
* Zooming in a document without quality loss for most cases;
* You want to rotate, reorder pages or add watermarks.

GroupDocs.Viewer for Java provides two resources management options for CSS, fonts, images, etc.:

* Rendering to **HTML with external resources** - stores page resources near to HTML which allows to reuse common resources across separate pages and dramatically reduce page size and loading speed.
* Rendering to **HTML with embedded resources** - integrates page resources into HTML and makes each document page self-sufficient. The drawback is that page size and loading speed may decrease.

### Rendering to PNG or JPEG

Rendering to PNG or JPEG will suit the best when you have the following requirements:

* You are writing any type of application;
* You don’t need to render textual content or want to restrict interaction with rendered document text. For example: prevent text copying. There is still an ability for you to extract document text if you want to add selectable text layer over the page image (described below).
* You want to view document pages separately;
* You want to rotate, reorder pages or add watermarks.

Following is a brief description of both image formats which may help you to choose the most suitable for your case.  

* **PNG** **format** is a lossless raster graphics file format that works with full-color images and supports transparency. There is no ability to adjust the quality of saved PNG image. PNG is a good choice for storing line drawings, text, and iconic graphics at small file sizes.
* **JPEG** **format** is a lossy compressed file format which allows to adjust the quality of the saved image — when it is reduced, the details are removed and noise is added to the image, but the size becomes more compact. JPEG is optimal for images with a large number of colors (for example, for photos). It’s is a common choice to use JPEG on the Web because of its compression.

### Rendering to PDF

GroupDocs.Viewer renders a document to a single PDF document, so rendering to PDF will suit the best when you have the following requirements:

* You are going to print documents;
* You want to send documents via email.
* You don’t want to display document pages separately since all pages of a source document are rendered as a single PDF document.

## Retrieving Document Information

GroupDocs.Viewer for Java allows to obtain basic information about source documents such as file type, pages count, text with coordinates, etc.

For the following document formats additional information can also be extracted:

* Archive – list of folders contained in archive;
* CAD - list of layers and layouts in a CAD document;
* Email – list of folders contained in an Outlook data file document;
* PDF – information about document printing restrictions;
* Project Management – project start and end dates.

### Text extraction

You can opt to extract document text when rendering to PNG or JPEG, document text can be extracted along with separate words coordinates.

This may be helpful when you want to add selectable text layer over the page image.

## Processing attachments

We use the term "attachments" in GroupDocs.Viewer for email attachments, embedded files, and compressed files.

With GroupDocs.Viewer you can list and save:

* Email attachments;
* Files that are embedded in PDF files;
* Email messages contained by Outlook and LotusNotes data files;
* Compressed files.

## Output transformation

GroupDocs.Viewer for Java provides a set of options to apply different document page transformations:

* Rotate pages - change page orientation when rendering to HTML, JPG, PNG and PDF.
* Add text watermark - add text watermark to each of the rendered pages.
* Reorder pages - render pages in order you prefer or reorder pages when rendering to PDF.

## Caching results

GroupDocs.Viewer for Java provides a document viewer API that supports caching in order to boost document loading speed and optimize application performance.

Documents cache is saved to a local disk by default. However, document viewer API also provides document cache interfaces that can be implemented for 3rd party storage support - FTP, Amazon S3, Dropbox, Google Drive, Microsoft Azure, Redis or any other.

---

## Features overview

Path: /viewer/net/features-overview/


## Rendering Documents

We use the term ["rendering"]({{< ref "viewer/net/developer-guide/rendering-documents/_index.md" >}}) in GroupDocs.Viewer to describe the process of converting a document into a file format, paginated, or that has the concept of pages. For example, when you have a DOCX file with three pages then after rendering this file to HTML you'll get three HTML files on the output that represent each of the pages in the document.

![Rendering diagram](/viewer/net/images/getting-started/features-overview/rendering.png)

### Rendering to HTML

Rendering to HTML will suit the best when you have the following requirements:

* You are writing a web-based application;
* Document content should be displayed inside web-browser;
* You need an ability to interact with rendered document text - select, copy or search;
* You want to view document pages separately;
* Zooming in a document without quality loss for most cases;
* You want to rotate, reorder pages or add watermarks.

GroupDocs.Viewer for .NET provides two resources management options for CSS, fonts, images, etc.:

* Rendering to **HTML with external resources** - stores page resources near to HTML which allows to reuse common resources across separate pages and dramatically reduce page size and loading speed.
* Rendering to **HTML with embedded resources** - integrates page resources into HTML and makes each document page self-sufficient. The drawback is that page size and loading speed may decrease.

### Rendering to PNG or JPEG

Rendering to PNG or JPEG will suit the best when you have the following requirements:

* You are writing any type of application;
* You don’t need to render textual content or want to restrict interaction with rendered document text. For example: prevent text copying. There is still an ability for you to extract document text if you want to add selectable text layer over the page image (described below).
* You want to view document pages separately;
* You want to rotate, reorder pages or add watermarks.

Following is a brief description of both image formats which may help you to choose the most suitable for your case.  

* **PNG** **format** is a lossless raster graphics file format that works with full-color images and supports transparency. There is no ability to adjust the quality of saved PNG image. PNG is a good choice for storing line drawings, text, and iconic graphics at small file sizes.
* **JPEG** **format** is a lossy compressed file format which allows to adjust the quality of the saved image — when it is reduced, the details are removed and noise is added to the image, but the size becomes more compact. JPEG is optimal for images with a large number of colors (for example, for photos). It’s is a common choice to use JPEG on the Web because of its compression.

### Rendering to PDF

GroupDocs.Viewer renders a document to a single PDF document, so rendering to PDF will suit the best when you have the following requirements:

* You are going to print documents;
* You want to send documents via email.
* You don’t want to display document pages separately since all pages of a source document are rendered as a single PDF document.

## Retrieving Document Information

GroupDocs.Viewer for .NET allows to obtain basic information about source documents such as file type, pages count, text with coordinates, etc.

For the following document formats additional information can also be extracted:

* Archive – list of folders contained in archive;
* CAD - list of layers and layouts in a CAD document;
* Email – list of folders contained in an Outlook data file document;
* PDF – information about document printing restrictions;
* Project Management – project start and end dates.

### Text extraction

You can opt to extract document text when rendering to PNG or JPEG, document text can be extracted along with separate words coordinates.

This may be helpful when you want to add selectable text layer over the page image.

## Processing attachments

We use the term "attachments" in GroupDocs.Viewer for email attachments, embedded files, and compressed files.

With GroupDocs.Viewer you can list and save:

* Email attachments;
* Files that are embedded in PDF files;
* Email messages contained by Outlook and LotusNotes data files;
* Compressed files.

## Output transformation

GroupDocs.Viewer for .NET provides a set of options to apply different document page transformations:

* Rotate pages - change page orientation when rendering to HTML, JPG, PNG and PDF.
* Add text watermark - add text watermark to each of the rendered pages.
* Reorder pages - render pages in order you prefer or reorder pages when rendering to PDF.

## Caching results

GroupDocs.Viewer for .NET provides a document viewer API that supports caching in order to boost document loading speed and optimize application performance.

Documents cache is saved to a local disk by default. However, document viewer API also provides document cache interfaces that can be implemented for 3rd party storage support - FTP, Amazon S3, Dropbox, Google Drive, Microsoft Azure, Redis or any other.

---

## Features overview

Path: /viewer/nodejs-java/features-overview/

  
## Rendering Documents

We use the term ["rendering"]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/_index.md" >}}) in GroupDocs.Viewer to describe the process of converting a document into a file format, paginated, or that has the concept of pages. For example, when you have a DOCX file with three pages then after rendering this file to HTML you will get three HTML files on the output that represent each of the pages in the document.

![Rendering diagram](/viewer/nodejs-java/images/getting-started/features-overview/rendering.png)

### Rendering to HTML

Rendering to HTML will suit the best when you have the following requirements:

* You are writing a web-based application;
* Document content should be displayed inside web-browser;
* You need an ability to interact with rendered document text - select, copy or search;
* You want to view document pages separately;
* Zooming in a document without quality loss for most cases;
* You want to rotate, reorder pages or add watermarks.

GroupDocs.Viewer for Node.js provides two resources management options for CSS, fonts, images, etc.:

* Rendering to **HTML with external resources** - stores page resources near to HTML which allows to reuse common resources across separate pages and dramatically reduce page size and loading speed.
* Rendering to **HTML with embedded resources** - integrates page resources into HTML and makes each document page self-sufficient. The drawback is that page size and loading speed may decrease.

### Rendering to PNG or JPEG

Rendering to PNG or JPEG will suit the best when you have the following requirements:

* You are writing any type of application;
* You don’t need to render textual content or want to restrict interaction with rendered document text. For example: prevent text copying. There is still an ability for you to extract document text if you want to add selectable text layer over the page image (described below).
* You want to view document pages separately;
* You want to rotate, reorder pages or add watermarks.

Following is a brief description of both image formats which may help you to choose the most suitable for your case.  

* **PNG** **format** is a lossless raster graphics file format that works with full-color images and supports transparency. There is no ability to adjust the quality of saved PNG image. PNG is a good choice for storing line drawings, text, and iconic graphics at small file sizes.
* **JPEG** **format** is a lossy compressed file format which allows to adjust the quality of the saved image — when it is reduced, the details are removed and noise is added to the image, but the size becomes more compact. JPEG is optimal for images with a large number of colors (for example, for photos). It’s is a common choice to use JPEG on the Web because of its compression.

### Rendering to PDF

GroupDocs.Viewer renders a document to a single PDF document, so rendering to PDF will suit the best when you have the following requirements:

* You are going to print documents;
* You want to send documents via email.
* You don’t want to display document pages separately since all pages of a source document are rendered as a single PDF document.

## Retrieving Document Information

GroupDocs.Viewer for Node.js allows to obtain basic information about source documents such as file type, pages count, text with coordinates, etc.

For the following document formats additional information can also be extracted:

* Archive – list of folders contained in archive;
* CAD - list of layers and layouts in a CAD document;
* Email – list of folders contained in an Outlook data file document;
* PDF – information about document printing restrictions;
* Project Management – project start and end dates.

### Text extraction

You can opt to extract document text when rendering to PNG or JPEG, document text can be extracted along with separate words coordinates.

This may be helpful when you want to add selectable text layer over the page image.

## Processing attachments

We use the term "attachments" in GroupDocs.Viewer for email attachments, embedded files, and compressed files.

With GroupDocs.Viewer you can list and save:

* Email attachments;
* Files that are embedded in PDF files;
* Email messages contained by Outlook and LotusNotes data files;
* Compressed files.

## Output transformation

GroupDocs.Viewer for Node.js provides a set of options to apply different document page transformations:

* Rotate pages - change page orientation when rendering to HTML, JPG, PNG and PDF.
* Add text watermark - add text watermark to each of the rendered pages.
* Reorder pages - render pages in order you prefer or reorder pages when rendering to PDF.

## Caching results

GroupDocs.Viewer for Node.js provides a document viewer API that supports caching in order to boost document loading speed and optimize application performance.

Documents cache is saved to a local disk by default. However, document viewer API also provides document cache interfaces that can be implemented for 3rd party storage support - FTP, Amazon S3, Dropbox, Google Drive, Microsoft Azure, Redis or any other.

---

## Features overview

Path: /watermark/net/features-overview/

## Watermark

A watermark is an image or text that is intentionally superimposed onto document or image. Its purpose is to make it more difficult for the original document or image to be copied or used without permission.

GroupDocs.Watermark for .NET API presents a wide range of features related to watermark. Some key features are listed below.

1. Adding text/image watermark to supported document formats
2. Searching and removing text/image watermark in supported document formats
3. Searching watermarks in particular objects
4. Adding watermark to images inside a document
5. Modifying existing watermark objects in supported document formats
6. Extracting information of watermark objects in a document
7. PDF document rasterization
8. Getting document information
9. Searching watermarks by text formatting (font, color etc)
10. Modifying hyperlinks associated with document entities (all formats)
11. Setting background image for charts in Excel and PowerPoint document
12. Modifying PDF and email attachments
13. Using *Dynabic.Metered* account to use API in licensed mode

## Add watermark

Following are the watermark types that can be added to each supported document format.

| Document Format      | Watermark Type |
| -------------------- | --- |
| PDF                  | XObject (image and text) |
|                      | Artifact (image and text)  |
|                      | Annotation (image and text) |
| Word                 | Shape (image and text) |
| Excel                | Shape (image and text) |
|                      | Header & Footer (image and text) |
|                      | Background image |
| PowerPoint           | Shape (image and text) |
| Visio                | Shape (image and text) |
| Raster Image Formats | Text |
|                      | Image |
| Multi-page TIFF      | Text |
|                      | Image |
| Animated GIF         | Text |
|                      | Image |

## Search watermark

Following are the watermark types that can be found using GroupDocs.Watermark.

| Format     | Watermark type |
| ---------- | --- |
| PDF        | XObject (image and text) |
|            | Artifact (image and text) |
|            | Annotation (image and text) |
|            | Regular text |
| Word       | Shape (image and text) |
|            | Regular text |
|            | Hyperlinks |
| Excel      | Shape (image and text) |
|            | Header&Footer (image and text) |
|            | Background image |
|            | Text and formulas in cells |
|            | Hyperlinks |
| PowerPoint | Shape (image and text) |
|            | Hyperlinks |
| Visio      | Shape (image and text) |
|            | Diagram comments |
|            | Hyperlinks |
| Email      | Attached and embedded images |
|            | Subject and body text fragments |

## Remove watermark

Following are the watermark types that can be removed using GroupDocs.Watermark.

| Format     | Watermark type |
| ---------- | --- |
| PDF        | XObject (image and text) |
|            | Artifact (image and text) |
|            | Annotation (image and text) |
|            | Regular text |
| Word       | Shape (image and text) |
|            | Regular text |
|            | Hyperlinks |
| Excel      | Shape (image and text) |
|            | Header&Footer (image and text) |
|            | Background image |
|            | Text and formulas in cells |
|            | Hyperlinks |
| PowerPoint | Shape (image and text) |
|            | Hyperlinks |
| Visio      | Shape (image and text) |
|            | Diagram comments |
|            | Hyperlinks |
| Email      | Attached and embedded images |
|            | Subject and body text fragments |

## Document information extraction

GroupDocs.Watermark allows obtaining basic information about source document - file type, size, pages count, page height and width etc.  
This may be quite useful for generating document preview and precise watermark placing inside document.

## Preview document pages

Document preview feature allows generating image representations of document pages. This may be helpful for better understanding about document content and its structure,  
set proper watermark position inside document, apply appropriate watermark styling etc. Preview can be generated for all document pages (by default) or for specific page numbers or page range.

Supported image formats for document preview are:

* PNG;
* JPG;
* BMP.

---

## Features Overview

Path: /annotation/java/features-overview/

## Adding, editing, and removing annotations

GroupDocs.Annotation for Java main feature is document annotation that supports over 13 different annotation types for more 35 file formats.

You can use various graphic, text, and watermark annotation types. See available annotation types in the list below.

### Graphic annotations

*   Area marks an area with a rectangle and adds notes to it
*   Arrow draws an arrow in a document
*   Distance measures the distance between objects in a document
*   Point sticks comments to any point in a document
*   Polyline draws shapes and freehand lines
*   Redaction fills the black rectangle with a fixed position (use if you want to hide some text)
*   Text field adds a rectangle with text inside
*   Ellipse draws elliptic annotation in a document

### Text annotations

*   Highlight highlights and comments selected text
*   Replacement replaces the original text with the user’s text
*   Strikeout marks text with a strike-through styling
*   Underline marks text with an underline styling

### Watermark annotations

*   Horizontal adds horizontal text watermark
*   Diagonal adds diagonal text watermark

## Import annotations

GroupDocs.Annotation for Java provides the ability to work with annotations added by other software.

## Adding and removing comments

Each annotation type supports comment collaboration. Add, remove, or reply to comments for any annotation.

## Export of annotated document

GroupDocs.Annotation for Java saves the annotated document in the origin format for most supported file types. For details, see [list of supported formats]({{< ref "annotation/java/getting-started/supported-document-formats.md" >}})

## Generation of document pages previews & thumbnails

GroupDocs.Annotation for Java allows you to render document pages as images for your desktop, mobile, or web front-end applications. You can view any document, calculate the annotation coordinates more precisely, or generate a preview or thumbnails.

## Caching results

By default, GroupDocs.Annotation stores the cache on a local disk. 
Nevertheless, however GroupDocs.Annotation allows you to use a custom cache by implementing appropriate interfaces such as Amazon S3, Dropbox, Google Drive, Windows Azure, Redis, or others.

---

## Features Overview

Path: /annotation/net/features-overview/

## Adding, editing, and removing annotations

GroupDocs.Annotation for .NET main feature is document annotation that supports over 13 different annotation types for more 35 file formats.

You can use various graphic, text, and watermark annotation types. See available annotation types in the list below.

### Graphic annotations

*   Area marks an area with a rectangle and adds notes to it
*   Arrow draws an arrow in a document
*   Distance measures the distance between objects in a document
*   Point sticks comments to any point in a document
*   Polyline draws shapes and freehand lines
*   Redaction fills the black rectangle with a fixed position (use if you want to hide some text)
*   Text field adds a rectangle with text inside
*   Ellipse draws elliptic annotation in a document

### Text annotations

*   Highlight highlights and comments selected text
*   Replacement replaces the original text with the user’s text
*   Strikeout marks text with a strike-through styling
*   Underline marks text with an underline styling

### Watermark annotations

*   Horizontal adds horizontal text watermark
*   Diagonal adds diagonal text watermark

## Import annotations

GroupDocs.Annotation for .NET provides the ability to work with annotations added by other software.

## Adding and removing comments

Each annotation type supports comment collaboration. Add, remove, or reply to comments for any annotation.

## Export of annotated document

GroupDocs.Annotation for .NET saves the annotated document in the origin format for most supported file types. For details, see [list of supported formats]({{< ref "annotation/net/getting-started/supported-document-formats.md" >}})

## Generation of document pages previews & thumbnails

GroupDocs.Annotation for .NET allows you to render document pages as images for your desktop, mobile, or web front-end applications. You can view any document, calculate the annotation coordinates more precisely, or generate a preview or thumbnails.

## Caching results

By default, GroupDocs.Annotation stores the cache on a local disk. 
Nevertheless, however GroupDocs.Annotation allows you to use a custom cache by implementing appropriate interfaces such as Amazon S3, Dropbox, Google Drive, Windows Azure, Redis, or others.

---

## Features Overview

Path: /assembly/python-net/features-overview/

GroupDocs.Assembly for Python via .NET is an API that allows you to generate documents in popular *microsoft office* and email file formats based upon template documents and data obtained from various sources including databases, XML, JSON, OData, objects of custom .NET types, external documents, and more. The following is the list of salient features which are offered by the GroupDocs.Assembly API:

*   Multiple data formats support
*   Use formulae & perform sequential data operations
*   Apply upper, lower, capital, firstcap formatting to strings in template syntax
*   Template syntax support formatting of ordinal, cardinal, alphabetic numeric nature
*   Support template documents with custom variables & text comments within template syntax tags
*   Dynamically insert out document content in report
*   Dynamically configure background color of html documents & generate barcode in reports
*   Dynamically insert hyperlinks in reports & apply attributes to email message body
*   Dynamically attach email attachments
*   Support of next field analogue of Microsoft Word
*   Update fields during word processing document assembly
*   Apply formula during spreadsheet assembly
*   Template formatting for numeric, text, image, date-time, chart elements
*   Conditional formatting of template text elements
*   Linq-based template syntax
*   Change format of assembled file using explicit specifications or file extension
*   Auto-removal of empty paragraphs
*   Generate various report types, e.g., charts, image, tables, lists and more
*   Inline template syntax errors in generated documents instead of exception throwing.
*   Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources

Following is the detail given about how the features are offered with their usage and limits.

## Data Sources

### Data Formats

| Feature | Support in GroupDocs.Assembly for Python via .NET |
| --- | --- |
| Database | Supported (using DataSet, DataTable, etc.) |
| XML | Supported (using DataSet.ReadXml or XML deserialization of custom objects) |
| OData | Supported (using deserialization of custom objects through WCF or [third-party .NET libraries](https://en.wikipedia.org/wiki/Open_Data_Protocol#.NET) |
| JSON | Supported (using a third-party component like [Json.NET](http://www.newtonsoft.com/json) on DataSet or custom objects in .NET |
| Custom .NET Objects | Supported |
| Ability to use Spreadsheet as Table of Data | Supported |
| Ability to use Word processing Table as Table of Data | Supported |

### Data Manipulation Capabilities

| Feature | Support in GroupDocs.Assembly for Python via .NET |
| --- | --- |
| Formulas | Supported (using C# syntax subset) |
| Sequential Data Operations (filtering, ordering, grouping, aggregating, etc.) | Supported (through LINQ syntax for data sources of all types) |
| Type Member Invocation | Supported |
| Built-In Data Relation Support | Supported |
| Data Processing Customization | Supported (using external .NET types) |
| External Document Import | Supported |

### Explicit Support for Multiple Data Sources

A new overload [**DocumentAssembler.AssembleDocument**](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler/methods/assembledocument/index) is added in the new release. Using this overload user can reference multiple data source objects and their members in the template. Overload accepts an array of data source names and an array of data sources. Learn more about support of multiple data sources in [this](https://docs.groupdocs.com/assembly/net/working-with-multiple-data-sources/) article.

## Template Formats, Elements and Syntax

### Template Document Formats

#### Word Processing Document Formats

Word Processing Document formats including Microsoft Word Document and OpenOffice document formats are supported. For more details, please visit [Support for Word Processing Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportfor-word-processing-document-formats" >}}#SupportedDocumentFormats-SupportforWordProcessingDocumentFormats).

#### Spreadsheet Document Formats

Spreadsheet Document formats including Microsoft Excel Workbook and OpenOffice spreadsheet document formats are supported. For more details, please visit [Support for Spreadsheet Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportfor-spreadsheet-document-formats" >}}#SupportedDocumentFormats-SupportforSpreadsheetDocumentFormats).

#### Presentation Document Formats

Presentation Document formats including Microsoft PowerPoint Presentation and OpenOffice presentation document formats are supported. For more details, please visit [Support for Presentation Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportfor-presentation-document-formats" >}}#SupportedDocumentFormats-SupportforPresentationDocumentFormats).

#### Email Document Formats

Email Document formats is supported. For more details, please visit [Support for Email Document Formats](https://docs.asposeptyltd.com/display/assemblynet/Supported+Document+Formats#SupportedDocumentFormats-EmailDocumentFormats).

#### More Document Formats

HTML and Plain Text document formats are supported by the GroupDocs.Assembly API. More Document formats including PDF, Epub and XPS document formats will be supported in the future releases. For more details, please visit [Support for more Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportformore-document-formats" >}}#SupportedDocumentFormats-SupportformoreDocumentFormats).

#### Dynamic Merging of Table Cells

You can merge table cells with equal textual contents within your reports dynamically using **cellMerge** tag. For the detail, please visit [Merging Table Cells Dynamically](https://docs.groupdocs.com/assembly/net/merging-table-cells-dynamically/).

#### Textual Comments within Template Syntax Tags

An optional comment providing a human-readable explanation ignored by the engine

```python
<<tag_name [expression] –switch1 –switch2 ... // optional_comment >>
```

#### In-lining of Syntax Error Messages into Templates 

In-lining of syntax error messages into templates instead of exception throwing. For the detail, please visit [Use of In-line Syntax Error Messages into Templates](https://docs.groupdocs.com/assembly/net/use-of-in-line-syntax-error-messages-into-templates/).

### Template Elements

| Feature | Support in GroupDocs.Assembly for Python via .NET |
| --- | --- |
| Formatted Text Blocks | Supported |
| HTML Blocks | Supported |
| Repeated Blocks (including list items and table rows) | Supported |
| Conditional Blocks | Supported (including list items and table rows) |
| Pivot Tables | To be supported |
| Images | Supported |
| Charts | Supported |
| Barcodes (through barcode fonts) | Supported |
| Bound Form Controls | To be supported |
| Hyperlinks to URI or Bookmarks | Supported |

### Template Syntax Formats for Expression Results

#### Specifying String Formats

API provides a useful feature to format strings in template syntax. String formatting such as upper, lower, capital, etc.

| String Format | Description |
| --- | --- |
| lower | Converts a string to lower case ("the string") |
| upper | Converts a string to upper case ("THE STRING") |
| caps | Capitalizes a first letter of every word in a string ("The String") |
| firstCap | Capitalizes the first letter of the first word in a string ("The string") |

#### Specifying Numeric Formats

Using GroupDocs.Assembly for Python via .NET user can also do numeric formatting in template syntax. Numeric formatting such as ordinal, cardinal, alphabetic, etc.

| Number Format | Description |
| --- | --- |
| alphabetic | Formats an integer number as an upper-case letter (A, B, C, ...) |
| roman | Formats an integer number as an upper-case Roman numeral (I, II, III, ...) |
| ordinal | Appends an ordinal suffix to an integer number (1st, 2nd, 3rd, ...) |
| ordinalText | Converts an integer number to its ordinal text representation (First, Second, Third, ...) |
| cardinal | Converts an integer number to its text representation (One, Two, Three, ...) |
| hex | Formats an integer number as hexadecimal (8, 9, A, B, C, D, E, F, 10, 11, ...) |
| arabicDash | Encloses an integer number with dashes (- 1 -, - 2 -, - 3 -, ...) |

#### Variables in Template Documents

API permits users to define variables in template documents as follows:

```python
<<var [st = "Hello, "]>><<[st]>><<var[st = "World!"]>><<[st]>>
```

### Support for Outer Document Insertion

You can insert contents of outer documents to your reports dynamically.

### Barcode Image Generation

Barcode images can be generated in reports dynamically.

### Support for Analogue of Microsoft Word NEXT Field

This feature allows user to implement a new <<next>> tag. The tag should be supported only within data bands created by using <<foreach>> tag.

### Setting Background Color Dynamically

For [HTML documents](https://docs.groupdocs.com/assembly/net/bulleted-list-in-html-document/), a background color can not be set dynamically using the backColor tag

```python
<<backColor ["red"]>>text with red background<</backColor>>

```

Aside this, you can use the HTML style attribute to achieve this.

### Setting Email Message Attributes Dynamically

In addition to an email message body, you can use GroupDocs.Assembly to set the following email message attributes dynamically using the same template syntax:

*   Subject
*   From
*   To
*   CC
*   BCC

For example, given that recipients is an enumeration of strings "Named Recipient <[named@example.com](mailto:named@example.com)\>" and "[unnamed@example.com](mailto:unnamed@example.com)", you can use the following template to set the To attribute for an email message.

```python
<<foreach [r in recipients]>><<[r]>>; <</foreach>>

```

During runtime, the To attribute is set to the following value then.

```python
Named Recipient <named@example.com>; unnamed@example.com

```

### Building Email Message Attachments Dynamically

GroupDocs.Assembly enables you to build contents of documents attached to email messages dynamically. To do this, attach template documents (of file formats supported by GroupDocs.Assembly) to your template email message. Then, while assembling the email message, the engine assembles the attached documents as well using the same data sources.

### Ability to Update Fields

API permits users to update fields while assembling Word Processing documents.

### Ability to Calculate Formulas

API allows users to calculate formula while assembling Spreadsheet documents.

### Template Elements Formatting

| Feature | Support in GroupDocs.Assembly for Python via .NET |
| --- | --- |
| Numeric/Date-Time Value Formatting | Supported |
| Text Formatting | Supported |
| Conditional Text Formatting | Supported (only through conditional blocks) |
| Image Formatting | Supported (WYSIWYG) |
| Chart Formatting | Supported (WYSIWYG) |

### Template Syntax

| Feature | Support in GroupDocs.Assembly for Python via .NET |
| --- | --- |
| [LINQ-based](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/) | Supported |
| [Mustache](https://mustache.github.io/mustache.5.html) | To be supported |

### Changing Output File Format 

GroupDocs.Assembly provides a powerful feature to change the target file format of an assembled document using file extension or explicit specification.

### Loading HTML and Saving To HTML with External Resource Files

Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources. Please visit the following articles for the detail:

*   [Loading of template documents from HTML with resources](https://docs.groupdocs.com/assembly/net/loading-of-template-documents-from-html-with-resources/)
*   [Saving to HTML with External Resource Files](https://docs.groupdocs.com/assembly/net/saving-to-html-with-external-resource-files/)

### Numbering Restart in Nested Numbered List 

The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using *<<restartNum>>* tags. In particular, this feature is useful when working with a nested numbered list within a data band. Please visit [this article](https://docs.groupdocs.com/assembly/net/numbered-list-in-word-processing-document/#numbering-restart-in-nested-numbered-list) for more details

  

  

## Metered Licensing

The GroupDocs.Assembly.Metered public class has been added to provide metered licensing. This feature is supported in GroupDocs.Assembly for Python via .NET 16.12.0.


---

## Features Overview

Path: /comparison/java/features-overview/


## File comparison

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to detect differences between source and target files for changes at paragraphs, words, and characters levels. It can identify styling and formatting changes like bold, italic, underlines, strike-troughs, font types, etc.

## Apply/Reject changes between documents

Every difference between compared documents can be applied or rejected and then exported to the output document.

## Document information extraction

GroupDocs.Comparison allows obtaining basic information about source documents - file type, size, page count, etc. For example, you can use this to generate previews of compared documents.

## Comparison summary report

Once the comparison process is complete, you can save a differences summary report that lists all changes in compared documents.

---

## Features Overview

Path: /comparison/net/features-overview/


## File comparison

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to detect differences between source and target files for changes at paragraphs, words, and characters levels. It can identify styling and formatting changes like bold, italic, underlines, strike-troughs, font types, etc.

## Apply/Reject changes between documents

Every difference between compared documents can be applied or rejected and then exported to the output document.

## Document information extraction

GroupDocs.Comparison allows obtaining basic information about source documents - file type, size, page count, etc. For example, you can use this to generate previews of compared documents.

## Comparison summary report

Once the comparison process is complete, you can save a differences summary report that lists all changes in compared documents.

---

## Features Overview

Path: /comparison/nodejs-java/features-overview/


## File comparison

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) is a library that helps you identify differences between two files, whether they are at the paragraph, word, or character level. It can even detect changes in styling and formatting, such as bold, italic, underlines, strike-throughs, and font types. 

## Apply/Reject changes between documents

Each difference identified between the compared documents can be either accepted or rejected, and subsequently, the results can be exported to the output document.

## Document information extraction

GroupDocs.Comparison allows obtaining basic information about the source files, such as file type, size, and page count, which can be used for generating previews of the compared documents.

## Comparison summary report

Once the comparison process is complete, you can save a summary report that lists all the differences between the compared documents.

---

## Features Overview

Path: /comparison/python-net/features-overview/


## File comparison

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) is a library that helps you identify differences between two files, whether they are at the paragraph, word, or character level. It can even detect changes in styling and formatting, such as bold, italic, underlines, strike-throughs, and font types. 

## Apply/Reject changes between documents

Each difference identified between the compared documents can be either accepted or rejected, and subsequently, the results can be exported to the output document.

## Document information extraction

GroupDocs.Comparison allows obtaining basic information about the source files, such as file type, size, and page count, which can be used for generating previews of the compared documents.

## Comparison summary report

Once the comparison process is complete, you can save a summary report that lists all the differences between the compared documents.

---

## Features Overview

Path: /editor/java/features-overview/

GroupDocs.Editor allows you to edit files and documents across wide range of [supported document types]({{< ref "editor/java/getting-started/supported-document-formats.md" >}}). Below, the short list of possible actions:

## Document editing

The main feature of GroupDocs.Editor is an ability to edit most popular document formats using front-end WYSIWYG editors without any additional applications. No Open Office or MS Office is required to edit a Word Processing documents, Spreadsheets or Presentations. You can just load document via GroupDocs.Editor into any WYSIWYG editor, edit document in a way you want and save it back to original document format.

## Editing options and output customizations

GroupDocs.Editor provides a set of options to customize editing process dependent on document type:

* Word Processing documents - ability to edit document in a flow or paged mode; consider language information for multi-language document editing; manage font extraction to provide same document editing and appearance behaviour in different environments.
* Spreadsheets - supports multi-tabbed spreadsheets editing by ability to specify index of currently edited worksheet.
* Comma-Separated Values and Tab-Separated Values - options to specify separator; flexible numeric and dates conversion; memory usage optimization for large files;
* XML files - fix incorrect document structure; URIs and e-mail addresses recognition; highlight and formatting options etc.

## Document information extraction

GroupDocs.Editor provides an ability to extract basic information about edited document:

* Document type;
* Document size;
* Pages count;
* etc.

---

## Features Overview

Path: /editor/net/features-overview/

GroupDocs.Editor allows you to edit files and documents across wide range of [supported document types]({{< ref "editor/net/getting-started/supported-document-formats.md" >}}). Below, the short list of possible actions:

## Document editing

The main feature of GroupDocs.Editor is an ability to edit most popular document formats using front-end WYSIWYG editors without any additional applications. No Open Office or MS Office is required to edit Word Processing documents, Spreadsheets or Presentations. You can just load document via GroupDocs.Editor into any WYSIWYG editor, edit document in a way you want and save it back to original document format.

## Editing options and output customizations

GroupDocs.Editor provides a set of options to customize editing process dependent on document type:

* Word Processing documents - ability to edit document in a flow or paged mode; consider language information for multi-language document editing; manage font extraction to provide same document editing and appearance behaviour in different environments.
* Spreadsheets - supports multi-tabbed spreadsheets editing by ability to specify index of currently edited worksheet.
* Comma-Separated Values and Tab-Separated Values - options to specify separator; flexible numeric and dates conversion; memory usage optimization for large files;
* XML files - fix incorrect document structure; URIs and e-mail addresses recognition; highlight and formatting options etc.

## Document information extraction

GroupDocs.Editor provides an ability to extract basic information about edited document:

* Document type;
* Document size;
* Pages count;
* etc.

---

## Features Overview

Path: /editor/nodejs-java/features-overview/

GroupDocs.Editor allows you to edit files and documents across wide range of [supported document types]({{< ref "editor/nodejs-java/getting-started/supported-document-formats.md" >}}). Below, the short list of possible actions:

## Document editing

The main feature of GroupDocs.Editor is an ability to edit most popular document formats using front-end WYSIWYG editors without any additional applications. No Open Office or MS Office is required to edit a Word Processing documents, Spreadsheets or Presentations. You can just load document via GroupDocs.Editor into any WYSIWYG editor, edit document in a way you want and save it back to original document format.

## Editing options and output customizations

GroupDocs.Editor provides a set of options to customize editing process dependent on document type:

* Word Processing documents - ability to edit document in a flow or paged mode; consider language information for multi-language document editing; manage font extraction to provide same document editing and appearance behaviour in different environments.
* Spreadsheets - supports multi-tabbed spreadsheets editing by ability to specify index of currently edited worksheet.
* Comma-Separated Values and Tab-Separated Values - options to specify separator; flexible numeric and dates conversion; memory usage optimization for large files;
* XML files - fix incorrect document structure; URIs and e-mail addresses recognition; highlight and formatting options etc.

## Document information extraction

GroupDocs.Editor provides an ability to extract basic information about edited document:

* Document type;
* Document size;
* Pages count;
* etc.

---

## Features Overview

Path: /merger/java/features-overview/

GroupDocs.Merger allows you to join multiple documents and manipulate single document structure across wide range of [supported document formats]({{< ref "merger/java/getting-started/supported-document-formats.md" >}}). Below, the short list of possible actions:

## Multiple document operations

### Join Documents

This feature lets you merge two or more documents into one document, join specific pages or page ranges from several source documents into single resultant document.  
Joined documents should be of the same format.

## Single document operations

### Split Document

**Split** operation allows to divide a source document to several resultant documents.

### Move Page

**MovePage** allows to move page to another position within a document.

### Remove Pages

**RemovePages** feature provides an ability to remove single page or a collection of specific page numbers from the source document.

### Rotate Pages

**RotatePages** operation lets you rotate pages within document. You can rotate pages by setting rotation angle to 90,180 or 270 degrees.

### Swap Page

**SwapPages** operation allows to swap two pages positions within the source document. The result is a new document where two pages have their positions exchanged.

### Extract Pages

**ExtractPages** feature allows to extract specified page or page ranges from source document. The result is a new document that contains only specified pages from the source document.

### Change Pages Orientation

**ChangeOrientation** operation lets you set page orientation (portrait, landscape) for specific or all pages of the document.

## Document security operations

GroupDocs.Merger API allows to manage document password-protection through the following security operations:

* Check for password-protection;
* Set document password if document is not protected with password;
* Update password if document is password-protected already;
* Remove password if document is password-protected.

## Document information extraction

GroupDocs.Merger allows to obtain basic information about source document - file type, size, pages count, page height and width etc.  
This may be quite useful for generating document preview.

## Preview document pages

Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure. Preview can be generated for all document pages (by default) or for specific page numbers or page range.

Supported image formats for document preview are:

* PNG;
* JPG;
* BMP.

## Logging while processing document

GroupDocs.Merger allows to log document manipulation processes info through [ILogger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.logging/ILogger) interface. There is ability to use built-in [ConsoleLogger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.logging/ConsoleLogger) or implement own logging logic.

---

## Features Overview

Path: /merger/net/features-overview/

GroupDocs.Merger allows you to join multiple documents and manipulate single document structure across wide range of [supported document types]({{< ref "merger/net/getting-started/supported-document-formats.md" >}}), [supported audio types]({{< ref "merger/net/getting-started/supported-audio-formats.md" >}}), [supported archive types]({{< ref "merger/net/getting-started/supported-archive-formats.md" >}}) and [supported cross-merging types]({{< ref "merger/net/getting-started/supported-cross-merging-formats.md" >}}). Below, the short list of possible actions:

## Multiple document operations 

### Join Documents

This feature lets you [merge]({{< ref "merger/net/developer-guide/merge/_index.md" >}}) two or more documents into one document, join specific pages or page ranges from several source documents into single resultant document.

## Single document operations

### Split Document

**Split** operation allows to [divide]({{< ref "merger/net/developer-guide/single-document-operations/split-document.md" >}}) a source document to several resultant documents.

### Move Page

**MovePage** allows to [move page]({{< ref "merger/net/developer-guide/single-document-operations/move-page.md" >}}) to another position within a document.

### Remove Pages

**RemovePages** feature provides an ability to [remove]({{< ref "merger/net/developer-guide/single-document-operations/remove-pages.md" >}}) single page or a collection of specific page numbers from the source document.

### Rotate Pages

**RotatePages** operation lets you [rotate pages]({{< ref "merger/net/developer-guide/single-document-operations/rotate-pages.md" >}}) within document. You can rotate pages by setting rotation angle to 90,180 or 270 degrees.

### Swap Pages

**SwapPages** operation allows to [swap]({{< ref "merger/net/developer-guide/single-document-operations/swap-pages.md" >}}) two pages positions within the source document. The result is a new document where two pages have their positions exchanged.

### Extract Pages

**ExtractPages** feature allows to [extract]({{< ref "merger/net/developer-guide/single-document-operations/extract-pages.md" >}}) specified page or page ranges from source document. The result is a new document that contains only specified pages from the source document.

### Change Pages Orientation

**ChangeOrientation** operation lets you [set page orientation]({{< ref "merger/net/developer-guide/single-document-operations/change-page-orientation.md" >}}) (portrait, landscape) for specific or all pages of the document.

## Document security operations

GroupDocs.Merger API allows to manage document password-protection through the following security operations:

* [Check for password-protection]({{< ref "merger/net/developer-guide/security-operations/check-document-password-protection.md" >}});
* [Set document password]({{< ref "merger/net/developer-guide/security-operations/add-document-password.md" >}}) if document is not protected with password;
* [Update password]({{< ref "merger/net/developer-guide/security-operations/update-document-password.md" >}}) if document is password-protected already;
* [Remove password]({{< ref "merger/net/developer-guide/security-operations/remove-document-password.md" >}}) if document is password-protected.

## Document information extraction

GroupDocs.Merger allows to obtain basic information about source document - file type, size, pages count, page height and width etc.  
This may be quite useful for generating document preview.

## Preview document pages

Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure. Preview can be generated for all document pages (by default) or for specific page numbers or page range.

Supported image formats for document preview are:

* PNG;
* JPG;
* BMP.

## Logging while processing document

GroupDocs.Merger allows to log document manipulation processes info through [ILogger](https://reference.groupdocs.com/merger/net/groupdocs.merger.logging/ilogger) interface. There is ability to use built-in [ConsoleLogger](https://reference.groupdocs.com/merger/net/groupdocs.merger.logging/consolelogger) or implement own logging logic.

---

## Features Overview

Path: /metadata/java/features-overview/

*   Reading, updating and removing metadata in a variety of formats
*   Searching, updating and removing particular metadata properties that satisfy a specification
*   Using tags to easily manipulate most common metadata properties in a unified manner
*   Working with password-protected documents
*   Extracting information about hidden document pages, digital signatures, user comments, revisions, etc
*   Working with the most popular metadata standards: IPTC, XMP, EXIF, Image Resources
*   Manipulating native metadata properties in various formats, extracting technical information from images, audio and video files
*   Calculating common document statistics (word count, character count, etc)
*   Detecting the format and MIME type of a file by its internal structure
*   Working with various audio tags (ID3, Lyrics, APE)

---

## Features Overview

Path: /metadata/net/features-overview/

## GroupDocs.Metadata for .NET Features
A .NET metadata API can be effectively used in removing, updating and reading metadata in a variety of formats. It is very effective in removing metadata from photos. Supporting iptc metadata, exif metadata and xmp metadata. Below list shows the features supported by GroupDocs.Metadata for .NET API.

*   Reading, updating and removing metadata in a variety of formats
*   Searching, updating and removing particular metadata properties that satisfy a specified predicate
*   Using tags to easily manipulate most common metadata properties in a unified manner
*   Working with password-protected documents
*   Extracting information about hidden document pages, digital signatures, user comments, revisions, etc
*   Working with the most popular metadata standards: IPTC, XMP, EXIF, Image Resources
*   Manipulating native metadata properties in various formats, extracting technical information from images, audio and video files
*   Calculating common document statistics (word count, character count, etc)
*   Detecting the format and MIME type of a file by its internal structure
*   Working with various audio tags (ID3, Lyrics, APE)

---

## Features Overview

Path: /metadata/nodejs-java/features-overview/

*   Reading, updating and removing metadata in a variety of formats
*   Searching, updating and removing particular metadata properties that satisfy a specification
*   Using tags to easily manipulate most common metadata properties in a unified manner
*   Working with password-protected documents
*   Extracting information about hidden document pages, digital signatures, user comments, revisions, etc
*   Working with the most popular metadata standards: IPTC, XMP, EXIF, Image Resources
*   Manipulating native metadata properties in various formats, extracting technical information from images, audio and video files
*   Calculating common document statistics (word count, character count, etc)
*   Detecting the format and MIME type of a file by its internal structure
*   Working with various audio tags (ID3, Lyrics, APE)

---

## Features Overview

Path: /metadata/python-net/features-overview/

*   Reading, updating and removing metadata in a variety of formats
*   Searching, updating and removing particular metadata properties that satisfy a specification
*   Using tags to easily manipulate most common metadata properties in a unified manner
*   Working with password-protected documents
*   Extracting information about hidden document pages, digital signatures, user comments, revisions, etc
*   Working with the most popular metadata standards: IPTC, XMP, EXIF, Image Resources
*   Manipulating native metadata properties in various formats, extracting technical information from images, audio and video files
*   Calculating common document statistics (word count, character count, etc)
*   Detecting the format and MIME type of a file by its internal structure
*   Working with various audio tags (ID3, Lyrics, APE)

---

## Features Overview

Path: /parser/java/features-overview/

{{< alert style="info" >}}GroupDocs.Parser is a feature-reach document data parsing API. Here you may find description of the most important features.{{< /alert >}}


## Parse Document by Template

GroupDocs.Parser allows to parse documents by user-defined templates.

It is easy to crate a template with data field definitions, table definitions. Then it's easy to use the template (just pass the  [Template](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/Template
) object to [parseByTemplate(Template)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseByTemplate(com.groupdocs.parser.templates.Template)) method) and extract data such as prices, invoices, tables from your typical documents.

## Extract Text

GroupDocs.Parser provides several text extraction methods that cover various text retrieval scenarios.

*   Extract a plain text from any of the supported documents;
*   Extract HTML or Markdown formatted text for a fast preview;
*   Extract structured text;
*   Extract text areas with coordinates, text style and other info;
*   Search a text by a keyword or regular expression; get a text around of the found word.

Below different text extraction aspects are described:

### Accurate Text Extraction Mode

One of the most demanded features is accurate text extraction. GroupDocs.Parser allows to easily implement it using simple [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method.

### Raw Text Extraction Mode

GroupDocs.Parser provides a way to increase text extraction performance with **Raw** text extraction mode for some formats. The text doesn't not look so accurate, but performance is higher.

This feature is useful in those text extraction scenarios when text quality may not be the best, but performance is critical.

### Extract Formatted Text

In additional to standard text extraction modes, GroupDocs.Parser API provides a method [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) to extract a formatted text for those cases when simple plain text is not enough and you may need to keep formatting like text style, table layout etc.

At this moment the following formats are supported:

*   Plain Text
*   Markdown
*   HTML

#### Plain Text

With Plain Text mode GroupDocs.Parser performs formatting in plain text making extracted text look closer to original. This is achieved due to special text positioning, box-drawing characters etc.

#### Markdown

This mode is useful when you need to export the extracted text to any system that supports [Markdown](https://en.wikipedia.org/wiki/Markdown)\-formatted text.

At this moment the following formattings are supported:

*   Bold text
*   Italic text
*   Hyperlinks
*   Headings
*   Numbering and bullets lists
*   Tables

#### HTML

GroupDocs.Parser also supports HTML formatting.

Following HTML tags are now supported when extracting text with this formatting mode:

| Tag | Description |
| --- | --- |
| `<p>` | Paragraph is surrounded by `<p>` tag |
| `<a>` | Hyperlinks |
| `<b>` | Text with Bold font is surrounded by `<b>` tag |
| `<i>` | Text with Italic font is surrounded by `<i>` tag |
| `<h1>` – `<h6>` | If the heading has 'Heading X' style, it's surrounded by `<hX>` tag |
| `<ol>`/`<ul>` | Numbering and bullets lists |
| `<table>` | Tables |

### Extract Structured Text

Many document formats do not contain only a text. Usually, the text could be organized into paragraphs divided into parts with headers. Also, the text can contain hyperlinks, lists, tables. For this scenario, GroupDocs.Parser provides structured text extraction with the ability to extract a text with its structure. This feature is easy to use - you simply call [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method that returns [*org.w3c.dom.Document*](https://docs.oracle.com/javase/7/docs/api/org/w3c/dom/Document.html?is-external=true) object with structured text in XML form.

### Extract Text Areas

GroupDocs.Parser provides API that allow to extract text areas with coordinates and text style.

This feature allows to implement advanced scenarios related to text analytics in your applications. Just call [getTextAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getTextAreas()) method and you will get all text area objects.

### Search Text in Documents

GroupDocs.Parser allows to perform search over loaded document using keywords or regular expression. Please use [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and then loop through the collection of search results.

## Extract Metadata

GroupDocs.Parser provides API that allows to extract metadata from supported document formats with simple [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method call.

## Extract Images

GroupDocs.Parser supports Images extraction from documents. You may call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method that returns all info about document images and allows to save them.

## Extract Containers and Attachments

GroupDocs.Parser allows to extract data (text, images, other supported extraction methods) from formats that contain other documents like ZIP archives, Pdf portfolios, emails, OST containers.

You can simply call [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and work with extracted attached or archived documents as with usual document files.

## Parse Form Data

GroupDocs.Parser provides the functionality to parse form data from PDF documents. You may call [parseForm](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseForm()) method and iterate through extracted form fields.

## Extract Table of Contents

GroupDocs.Parser allows to extract table of contents from some document formats. To do it, you may call [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method.

---

## Features Overview

Path: /parser/net/features-overview/

{{< alert style="info" >}}GroupDocs.Parser is a feature-rich document data parsing API. Here you may find description of the most important features.{{< /alert >}}


## Parse Data from Documents

GroupDocs.Parser allows to parse documents by user-defined templates.

It is easy to create a template with data field definitions, table definitions. Then it's easy to use the template (just pass the  [Template](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/template) object to [ParseByTemplate](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parsebytemplate) method) and extract data such as prices, invoices, tables from your typical documents.

## Extract Text

GroupDocs.Parser provides several text extraction methods that cover various text retrieval scenarios.

*   Extract a plain text from any of the supported documents;
*   Extract HTML or Markdown formatted text for a fast preview;
*   Extract structured text;
*   Extract text areas with coordinates, text style and other info;
*   Search a text by a keyword or regular expression; get a text around of the found word.

Below different text extraction aspects are described:

### Accurate Text Extraction Mode

One of the most demanded features is accurate text extraction. GroupDocs.Parser allows to easily implement it using simple [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method.

### Raw Text Extraction Mode

GroupDocs.Parser provides a way to increase text extraction performance with **Raw** text extraction mode for some formats. The text doesn't not look so accurate, but performance is higher.

This feature is useful in those text extraction scenarios when text quality may not be the best, but performance is critical.

### Extract Formatted Text

In additional to standard text extraction modes, GroupDocs.Parser API provides a method [GetFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) to extract a formatted text for those cases when simple plain text is not enough and you may need to keep formatting like text style, table layout etc.

At this moment the following formats are supported:

*   Plain Text
*   Markdown
*   HTML

#### Plain Text

With Plain Text mode GroupDocs.Parser performs formatting in plain text making extracted text look closer to original. This is achieved due to special text positioning, box-drawing characters etc.

#### Markdown

This mode is useful when you need to export the extracted text to any system that supports [Markdown](https://en.wikipedia.org/wiki/Markdown)\-formatted text.

At this moment the following formatting are supported:

*   Bold text
*   Italic text
*   Hyperlinks
*   Headings
*   Numbering and bullets lists
*   Tables

#### HTML

GroupDocs.Parser also supports HTML formatting.

Following HTML tags are now supported when extracting text with this formatting mode:

| Tag | Description |
| --- | --- |
| `<p>` | Paragraph is surrounded by `<p>` tag |
| `<a>` | Hyperlinks |
| `<b>` | Text with Bold font is surrounded by `<b>` tag |
| `<i>` | Text with Italic font is surrounded by `<i>` tag |
| `<h1>` – `<h6>` | If the heading has 'Heading X' style, it's surrounded by `<hX>` tag |
| `<ol>`/`<ul>` | Numbering and bullets lists |
| `<table>` | Tables |

### Extract Structured Text

Many document formats do not contain only a text. Usually, the text could be organized into paragraphs divided into parts with headers. Also, the text can contain hyperlinks, lists, tables. For this scenario, GroupDocs.Parser provides structured text extraction with the ability to extract a text with its structure. This feature is easy to use - you simply call [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method that returns [XmlReader](https://docs.microsoft.com/en-us/dotnet/api/system.xml.xmlreader?view=netframework-2.0) with structured text in XML form.

### Extract Text Areas

GroupDocs.Parser provides API that allow to extract text areas with coordinates and text style.

This feature allows to implement advanced scenarios related to text analytics in your applications. Just call [GetTextAreas](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettextareas) method and you will get all text area objects.

### Search Text in Documents

GroupDocs.Parser allows to perform search over loaded document using keywords or regular expression. Please use [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and then loop through the collection of search results.

## Extract Metadata

GroupDocs.Parser provides API that allows to extract metadata from supported document formats with simple [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method call.

## Extract Images

GroupDocs.Parser supports Images extraction from documents. You may call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method that returns all info about document images and allows to save them.

## Extract Data from Attachments and ZIP Archives

GroupDocs.Parser allows to extract data (text, images, other supported extraction methods) from formats that contain other documents like ZIP archives, PDF portfolios, emails, OST containers.

You can simply call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and work with extracted attached or archived documents as with usual document files.

## Parse Form Data

GroupDocs.Parser provides the functionality to parse form data from PDF documents. You may call [ParseForm](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parseform) method and iterate through extracted form fields.

## Extract Table of Contents

GroupDocs.Parser allows to extract table of contents from some document formats. To do it, you may call [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method.

---

## Features Overview

Path: /parser/python-net/features-overview/


{{< alert style="info" >}}GroupDocs.Parser is a feature-rich document data parsing API. Here you may find description of the most important features.{{< /alert >}}

## Parse Data from Documents

GroupDocs.Parser allows to parse documents by user-defined templates.

It is easy to create a template with data field definitions and table definitions. Then it's easy to use the template (just pass the Template object to `parse_by_template` method) and extract data such as prices, invoices, tables from your typical documents.

## Extract Text

GroupDocs.Parser provides several text extraction methods that cover various text retrieval scenarios.

*   Extract plain text from any of the supported documents
*   Extract HTML or Markdown formatted text for a fast preview
*   Extract structured text
*   Extract text areas with coordinates, text style and other info
*   Search text by a keyword or regular expression; get text around the found word

Below different text extraction aspects are described:

### Accurate Text Extraction Mode

One of the most demanded features is accurate text extraction. GroupDocs.Parser allows to easily implement it using simple `get_text` method.

### Raw Text Extraction Mode

GroupDocs.Parser provides a way to increase text extraction performance with **Raw** text extraction mode for some formats. The text doesn't look so accurate, but performance is higher.

This feature is useful in those text extraction scenarios when text quality may not be the best, but performance is critical.

### Extract Formatted Text

In addition to standard text extraction modes, GroupDocs.Parser API provides a method `get_formatted_text` to extract formatted text for those cases when simple plain text is not enough and you may need to keep formatting like text style, table layout etc.

At this moment the following formats are supported:

*   Plain Text
*   Markdown
*   HTML

#### Plain Text

With Plain Text mode GroupDocs.Parser performs formatting in plain text making extracted text look closer to original. This is achieved due to special text positioning, box-drawing characters etc.

#### Markdown

This mode is useful when you need to export the extracted text to any system that supports [Markdown](https://en.wikipedia.org/wiki/Markdown)-formatted text.

At this moment the following formatting are supported:

*   Bold text
*   Italic text
*   Hyperlinks
*   Headings
*   Numbering and bullets lists
*   Tables

#### HTML

GroupDocs.Parser also supports HTML formatting.

Following HTML tags are now supported when extracting text with this formatting mode:

| Tag | Description |
| --- | --- |
| `<p>` | Paragraph is surrounded by `<p>` tag |
| `<a>` | Hyperlinks |
| `<b>` | Text with Bold font is surrounded by `<b>` tag |
| `<i>` | Text with Italic font is surrounded by `<i>` tag |
| `<h1>` – `<h6>` | If the heading has 'Heading X' style, it's surrounded by `<hX>` tag |
| `<ol>`/`<ul>` | Numbering and bullets lists |
| `<table>` | Tables |

### Extract Structured Text

Many document formats do not contain only text. Usually, the text is organized into paragraphs divided into parts with headers. Also, the text can contain hyperlinks, lists, tables. For this scenario, GroupDocs.Parser provides structured text extraction with the ability to extract text with its structure. This feature is easy to use - you simply call `get_structure` method that returns XML with structured text.

### Extract Text Areas

GroupDocs.Parser provides API that allows to extract text areas with coordinates and text style.

This feature allows to implement advanced scenarios related to text analytics in your applications. Just call `get_text_areas` method and you will get all text area objects.

### Search Text in Documents

GroupDocs.Parser allows to perform search over loaded document using keywords or regular expressions. Use the `search` method and then loop through the collection of search results.

## Extract Metadata

GroupDocs.Parser provides API that allows to extract metadata from supported document formats with simple `get_metadata` method call.

## Extract Images

GroupDocs.Parser supports image extraction from documents. You may call `get_images` method that returns all info about document images and allows to save them.

## Extract Tables

GroupDocs.Parser allows to extract tables from documents preserving their structure. You can use `get_tables` method to extract tables from the entire document or specific pages.

## Extract Data from Attachments and ZIP Archives

GroupDocs.Parser allows to extract data (text, images, other supported extraction methods) from formats that contain other documents like ZIP archives, PDF portfolios, emails, OST containers.

You can simply call `get_container` method and work with extracted attached or archived documents as with usual document files.

## Extract Document Information

GroupDocs.Parser provides the ability to get basic document information such as file type, page count, and size. This can be done using the `get_document_info` method.

## Extract Table of Contents

GroupDocs.Parser allows to extract table of contents from some document formats. To do it, you may call `get_toc` method.

---

## Features Overview

Path: /redaction/java/features-overview/


## Document Redaction

Redacted meaning is that a process of modifying or editing a document to remove the confidential information before publishing it. GroupDocs.Redaction is a quality redaction software, providing a single format-independent interface for redacting sensitive and classified information from the PDF, Word, Excel, PowerPoint documents and images, including the ability to change metadata and remove comments. With GroupDocs.Redaction tool you can redact PDF and save redacted document, transforming all pages into raster images or keep the document in its original format for further editing.

Choosing the most appropriate redaction mode depends on your reasons to sanitize the classified information from the document. Let’s review in detail what are the differences between rasterization and saving in original format and how to choose the most suitable for your case.  

#### Rasterization

Rasterization is a process when the GroupDocs.Redaction product creates a new PDF file and adds raster images of redacted document's pages to it. So the new document contains no searchable text, no metadata from the original document. At the same time, annotations (comments, badges,etc.) remain visible - but not clickable. You have to use DeleteAnnotationRedaction to completely remove them before rasterizing the document.

Rasterization is the best option to choose if:   

*   you have to conform regulations of authorities, requesting PDF as a format;
    
*   you need to pass the document to third parties;
*   you need this document to be opened on different platforms.  
    

For all these cases rasterization is the right option.

#### Keeping Original Format

GroupDocs.Redaction can save the document in its original format after the redactions were applied.

Keeping original format is the best option to choose if:   

*   you need to continue working and editing this document in its original application bring sure that all sensitive data were removed;
    
*   you have to pass this document to someone else in your company for editing, but without sensitive data;
    
*   you need to pass the document to third parties, like contractors, but hide your sensitive information.  
    

#### Spreadsheet Redactions

A special case of keeping original format is redacting spreadsheets with data. With GroupDocs.Redaction you can set the scope of a single worksheet or even a column on it to limit textual redactions only to this scope. In this case a regular expression will be matched only in a given scope, not the entire document.

#### Metadata Redactions

Saving the document in an original format requires deleting or redacting its metadata to remove all sensitive information. For these purposes GroupDocs.Redaction provides metadata redactions.

#### Annotation Redactions

Annotation redactions allow you to remove specific or any annotations (comments, badges, etc.) from the document. You can use regular expressions to match annotations you need to redact out.

#### Image Redactions

With GroupDocs.Redaction OCR support, you can extract a text from an image, search it for data and redact sensitive data within the image. As an alternative, you can put a colored box over a given area, such as header, footer, or an area, where customer's data are expected to appear. Also you can use it to edit exif data or use it as an exif eraser.

#### Remove Page Redactions

Remove Page redactions allow you to remove pages from PDF documents, slides from presentations and worksheets from spreadsheet documents. You can specify the page range and its relative position to remove.

You can use GroupDocs.Redaction to redact all kinds of embedded images within a document:

*   Redact each page of a PDF file, created from paper page scans;

*   Create a rasterized PDF file, and edit its pages as images;

*   Redact all images within a PDF, Microsoft Office or Open Office document.

---

## Features Overview

Path: /redaction/net/features-overview/

## Document Redaction Tool

Redacted meaning is that a process of modifying or editing a document to remove the confidential information before publishing it. GroupDocs.Redaction is a quality redaction software, providing a single format-independent interface for redacting sensitive and classified information from the PDF, Word, Excel, PowerPoint documents and images, including the ability to change metadata and remove comments. With GroupDocs.Redaction tool you can redact PDF and save redacted document, transforming all pages into raster images or keep the document in its original format for further editing.

Choosing the most appropriate redaction mode depends on your reasons to sanitize the classified information from the document. Let’s review in detail what are the differences between rasterization and saving in original format and how to choose the most suitable for your case.  

#### Rasterization

You can black out parts of PDF or other supported document type with our redaction toolkit and create a new PDF file with raster images of redacted document's pages. The sanitized document contains no searchable text, no metadata from the original document. At the same time, annotations (comments, badges,etc.) remain visible - but not clickable. You can use DeleteAnnotationRedaction to delete all comments in the document.

Rasterization is the best option to choose if:  

*   you have to conform regulations of authorities, requesting PDF as a format;
    
*   you have a PDF file as an original format;  
    
*   you need to pass the document to third parties;
*   you need this document to be opened on different platforms.  
    

For all these cases rasterization is the right option.

#### Keeping Original Format

GroupDocs.Redaction toolkit can save the document in its original format after the redactions were applied.

Keeping original format is the best option to choose if:  

*   you need to continue working and editing this document in its original application bring sure that all sensitive data were removed;
    
*   you have to pass this document to someone else in your company for editing, but without sensitive data;
    
*   you need to pass the document to third parties, like contractors, but hide your sensitive information.  
    

#### Spreadsheet Redactions

A special case of keeping original format is redacting spreadsheets with data. With GroupDocs.Redaction you can set the scope of a single worksheet or even a column on it to limit textual redactions only to this scope. In this case a regular expression will be matched only in a given scope, not the entire document.

#### Metadata Redactions

Saving the document in an original format requires deleting or redacting its metadata to remove all sensitive information. For these purposes GroupDocs.Redaction provides metadata redactions.

#### Annotation Redactions

Annotation redactions allow you to remove specific or any annotations (comments, badges, etc.) from the document. You can use regular expressions to match annotations you need to redact out.

#### Remove Page Redactions

Remove Page redactions allow you to remove pages from PDF documents, slides from presentations and worksheets from spreadsheet documents. You can specify the page range and its relative position to remove.

## Image Redactions

With GroupDocs.Redaction OCR support, you can extract a text from an image, search it for data and redact sensitive data within the image. As an alternative, you can put a colored box over a given area, such as header, footer, or an area, where customer's data are expected to appear. Also you can use it to edit exif data or use it as an exif eraser.

You can use GroupDocs.Redaction to redact all kinds of embedded images within a document:

*   Redact each page of a PDF file, created from paper page scans;

*   Create a rasterized PDF file, and edit its pages as images;

*   Redact all images within a PDF, Microsoft Office or Open Office document.

---

## Features Overview

Path: /redaction/python-net/features-overview/

## Document Redaction Tool

Redacted meaning is that a process of modifying or editing a document to remove the confidential information before publishing it. GroupDocs.Redaction is a quality redaction software, providing a single format-independent interface for redacting sensitive and classified information from the PDF, Word, Excel, PowerPoint documents and images, including the ability to change metadata and remove comments. With GroupDocs.Redaction tool you can redact PDF and save redacted document, transforming all pages into raster images or keep the document in its original format for further editing.

Choosing the most appropriate redaction mode depends on your reasons to sanitize the classified information from the document. Let’s review in detail what are the differences between rasterization and saving in original format and how to choose the most suitable for your case.  

#### Rasterization

You can black out parts of PDF or other supported document type with our redaction toolkit and create a new PDF file with raster images of redacted document's pages. The sanitized document contains no searchable text, no metadata from the original document. At the same time, annotations (comments, badges,etc.) remain visible - but not clickable. You can use DeleteAnnotationRedaction to delete all comments in the document.

Rasterization is the best option to choose if:  

*   you have to conform regulations of authorities, requesting PDF as a format;
    
*   you have a PDF file as an original format;  
    
*   you need to pass the document to third parties;

*   you need this document to be opened on different platforms.  
    

For all these cases rasterization is the right option.

#### Keeping Original Format

GroupDocs.Redaction toolkit can save the document in its original format after the redactions were applied.

Keeping original format is the best option to choose if:  

*   you need to continue working and editing this document in its original application bring sure that all sensitive data were removed;
    
*   you have to pass this document to someone else in your company for editing, but without sensitive data;
    
*   you need to pass the document to third parties, like contractors, but hide your sensitive information.  
    

#### Spreadsheet Redactions

A special case of keeping original format is redacting spreadsheets with data. With GroupDocs.Redaction you can set the scope of a single worksheet or even a column on it to limit textual redactions only to this scope. In this case a regular expression will be matched only in a given scope, not the entire document.

#### Metadata Redactions

Saving the document in an original format requires deleting or redacting its metadata to remove all sensitive information. For these purposes GroupDocs.Redaction provides metadata redactions.

#### Annotation Redactions

Annotation redactions allow you to remove specific or any annotations (comments, badges, etc.) from the document. You can use regular expressions to match annotations you need to redact out.

#### Remove Page Redactions

Remove Page redactions allow you to remove pages from PDF documents, slides from presentations and worksheets from spreadsheet documents. You can specify the page range and its relative position to remove.

## Image Redactions

With GroupDocs.Redaction OCR support, you can extract a text from an image, search it for data and redact sensitive data within the image. As an alternative, you can put a colored box over a given area, such as header, footer, or an area, where customer's data are expected to appear. Also you can use it to edit exif data or use it as an exif eraser.

You can use GroupDocs.Redaction to redact all kinds of embedded images within a document:

*   Redact each page of a PDF file, created from paper page scans;

*   Create a rasterized PDF file, and edit its pages as images;

*   Redact all images within a PDF, Microsoft Office or Open Office document.

---

## Features Overview

Path: /signature/java/features-overview/

## Sign document

Document signatures could be created and added to the document via collection of different options that specify all possible visualization features – color settings, alignment, font, margins, padding and different styling.   
Following signature types are supported: 

*   Native text signatures as text stamps, text labels with big amount of settings for visualization effects, opacity, colors, fonts, etc.;
*   Text as image signatures with big scope of additional options to specify how text will look, colors, and extra image effects;
*   Image signatures with options to specify extra image effects, rotation etc.;
*   Digital signatures based on certificate files and ability to support digital signature by document type (PDF, Spreadsheet, Word Processing documents);
*   Barcode/qr-code signatures with variety of options;
*   Metadata signatures to keep hidden signatures inside the document;
*   Form-field signatures.

## Search for signatures

Obtain signatures list applied to document:

*   Digital signatures information from PDF, Spreadsheet, Word Processing documents;
*   Barcode/QR-code signatures information from all supported formats;
*   Metadata signatures information from all supported formats;
*   Form-field signatures information from all supported formats.

## Verify signatures

Determine whether document contains signatures that meet the specified criteria.   
Supported signature types are: 

*   Digital signatures;
*   Barcode/QR-code signatures;
*   Metadata signatures;
*   Form-field signatures.

## Document information extraction

GroupDocs.Signature allows to obtain basic information about source document - file type, size, pages count, page height and width etc. This may be quite useful for generating document preview and precise signature placing inside document.

## Preview document pages

Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure, set proper signature position inside document, apply appropriate signature styling etc. Preview can be generated for all document pages (by default) or for specific page numbers or page range.

Supported image formats for document preview are:
*   PNG;
*   JPG;
*   BMP.

---

## Features Overview

Path: /signature/net/features-overview/

## Electronic signature

**Electronic Signature** is an abstract concept that means data in electronic form associated with a certain document and expressing the consent of the signatory with the information contained in the document.
GroupDocs.Signature provides various electronic signature implementations as follows:

* Native text signatures as text stamps, text labels, annotation, stickers, watermarks with big amount of settings for visualization effects, opacity, colors, fonts, etc.;
* Text as image signatures with big scope of additional options to specify how text will look, colors, and extra image effects;
* Image signatures with options to specify extra image effects, rotation etc.;
* Digital signatures based on digital certificate files and ability to support digital signature by document type (PDF, Microsoft Word documents and Microsoft Excel spreadsheets);
* Barcode/QR-code signatures with variety of options;
* Generated stamp looking image signatures based on predefined lines with custom text, colors, width, etc;
* Metadata signatures to keep hidden signatures inside the document;
* Form-field signatures.

Signing documents in .NET with our electronic signature (eSign) API is easy, reliable and secure. Document signatures could be created and added to the document via collection of different options that specify all possible visualization features – color settings, alignment, font, margins, padding and different styling. Depending on the application requirements, you can sign documents with one or several signature types at the same time.

## Search for signatures

Obtain signatures list applied to document:

* Text signatures information from all supported formats;
* Image signatures information;
* Digital signatures information from PDF, Microsoft Word documents and Microsoft Excel spreadsheets;
* Barcode/QR-code signatures information from all supported formats;
* Metadata signatures information from all supported formats;
* Form-field signatures information from all supported formats.

## Verify signatures

Determine whether document contains signatures that meet the specified criteria.
Supported signature types are:

* Text signatures;
* Digital signatures;
* Barcode/QR-code signatures;
* Metadata signatures;
* Form-field signatures.

## Document information extraction

GroupDocs.Signature allows to obtain basic information about source document - file type, size, pages count, page height and width etc.  
This may be quite useful for generating document preview and precise signature placing inside document.

## Preview document pages

Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure,  
set proper signature position inside document, apply appropriate signature styling etc. Preview can be generated for all document pages (by default) or for specific page numbers or page range.

Supported image formats for document preview are:

* PNG;
* JPG;
* BMP.

---

## Features Overview

Path: /signature/nodejs-java/features-overview/

## Electronic signature

**Electronic Signature** is an abstract concept that means data in electronic form associated with a certain document and expressing the consent of the signatory with the information contained in the document.
GroupDocs.Signature provides various electronic signature implementations as follows:

* Native text signatures as text stamps, text labels, annotation, stickers, watermarks with big amount of settings for visualization effects, opacity, colors, fonts, etc.;
* Text as image signatures with big scope of additional options to specify how text will look, colors, and extra image effects;
* Image signatures with options to specify extra image effects, rotation etc.;
* Digital signatures based on digital certificate files and ability to support digital signature by document type (PDF, Microsoft Word documents and Microsoft Excel spreadsheets);
* Barcode/QR-code signatures with variety of options;
* Generated stamp looking image signatures based on predefined lines with custom text, colors, width, etc;
* Metadata signatures to keep hidden signatures inside the document;
* Form-field signatures.

Signing documents in Node.js with our electronic signature (eSign) API is easy, reliable and secure. Document signatures could be created and added to the document via collection of different options that specify all possible visualization features – color settings, alignment, font, margins, padding and different styling. Depending on the application requirements, you can sign documents with one or several signature types at the same time.

## Search for signatures

Obtain signatures list applied to document:

* Text signatures information from all supported formats;
* Image signatures information;
* Digital signatures information from PDF, Microsoft Word documents and Microsoft Excel spreadsheets;
* Barcode/QR-code signatures information from all supported formats;
* Metadata signatures information from all supported formats;
* Form-field signatures information from all supported formats.

## Verify signatures

Determine whether document contains signatures that meet the specified criteria.
Supported signature types are:

* Text signatures;
* Digital signatures;
* Barcode/QR-code signatures;
* Metadata signatures;
* Form-field signatures.

## Document information extraction

GroupDocs.Signature allows to obtain basic information about source document - file type, size, pages count, page height and width etc.  
This may be quite useful for generating document preview and precise signature placing inside document.

## Preview document pages

Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure,  
set proper signature position inside document, apply appropriate signature styling etc. Preview can be generated for all document pages (by default) or for specific page numbers or page range.

Supported image formats for document preview are:

* PNG;
* JPG;
* BMP.

---

## Features Overview

Path: /watermark/java/features-overview/


**GroupDocs.Watermark for Java** is a complete **watermark solution** that allows you to **add**, **search**, and **remove watermarks** from a wide range of file formats. Whether you're looking to **protect documents with watermarks**, apply **custom watermark** styles, or **automate watermarking** for enterprise workflows — this product has you covered.

---

## What is a Watermark?

A **watermark** is a visible or invisible text or image placed over content to show ownership, confidentiality, or branding. It helps with:

- **Document security**
- **Content protection with watermarking**
- Preventing unauthorized use or distribution
- Adding branding, copyright, or classification labels like “Confidential” or “Draft”

---

## Key Features

Here’s what you can do with GroupDocs.Watermark for Java:

1. **Add watermark to document** (text or image)
2. **Search and remove watermark** (text/image) from supported formats
3. Add watermark to **images inside documents**
4. **Customize watermark** appearance (fonts, position, rotation, transparency, color)
5. Modify or update existing watermarks
6. Search watermark by formatting (font, color, etc.)
7. Extract watermark details (type, position, content)
8. **Watermark automation for enterprise** — batch watermarking
9. Modify document attachments, hyperlinks, and background images
10. Rasterize PDF pages and preview document content
11. **Use watermark** with a Dynabic.Metered account for licensed mode

---

## How to Add Watermark in Documents

You can **add watermark to Word, Excel, PowerPoint, PDF**, Visio, TIFF, GIF, and image formats.

| Document Format      | Watermark Type                      |
|----------------------|--------------------------------------|
| **PDF**              | XObject, Artifact, Annotation (text/image) |
| **Word**             | Shape (text/image)                   |
| **Excel**            | Shape, Header/Footer, Background     |
| **PowerPoint**       | Shape (text/image)                   |
| **Visio**            | Shape (text/image)                   |
| **Raster Images**    | Text, Image                          |
| **Multi-page TIFF**  | Text, Image                          |
| **Animated GIF**     | Text, Image                          |

---

## How to Search Watermark in Files

You can detect different types of watermarks using **GroupDocs watermark** detection engine.

| Format      | Watermark Types Found                        |
|-------------|----------------------------------------------|
| **PDF**     | XObject, Artifact, Annotation, Regular Text  |
| **Word**    | Shape, Regular Text, Hyperlinks              |
| **Excel**   | Shape, Header/Footer, Background, Hyperlinks, Text in cells |
| **PowerPoint** | Shape, Hyperlinks                         |
| **Visio**   | Shape, Comments, Hyperlinks                  |
| **Email**   | Embedded images, Subject, Body               |

---

## How to Remove Watermark from a Document

You can easily **delete watermark from** documents using smart search features:

| Format      | Removable Watermark Types                    |
|-------------|----------------------------------------------|
| **PDF**     | XObject, Artifact, Annotation, Regular Text  |
| **Word**    | Shape, Regular Text, Hyperlinks              |
| **Excel**   | Shape, Header/Footer, Background, Formulas   |
| **PowerPoint** | Shape, Hyperlinks                         |
| **Visio**   | Shape, Comments, Hyperlinks                  |
| **Email**   | Embedded images, Subject, Body               |

Want to know **how to remove watermark from free** samples or how to **remove watermark in Word or PDF**? We’ve got examples for you.

---

## Document Info Extraction

Use the API to retrieve:

- File type
- Size
- Page count
- Page height and width

Useful for preview generation and **precise watermark positioning**.

---

## Document Preview (Pages to Image)

You can render pages as images (PNG, JPG, BMP) to:

- **Preview watermark placement**
- Fine-tune watermark styling
- Show document content in UI

Preview specific pages or the full document. Helpful for **customized product** use cases.

---

## Advanced Scenarios

- **Add text to document** using your own fonts or styling
- **Add image watermark** to photos or scanned pages
- Modify **hyperlinks**, **attachments**, and **backgrounds**
- Set **background image for Excel charts**
- Automate with **Java batch watermarking**

---

## Online Tools

Need to test without installing? Use [GroupDocs Online](https://products.groupdocs.app/watermark) to:

- **Add watermark to online** documents
- Try **remove watermark** features instantly
- See real **watermark examples for documents**

---

## Learn More

- How to watermark [files]({{< ref "/watermark/java/developer-guide/basic-usage/_index.md" >}})
- How to put watermark in [PDF]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-pdf-documents/_index.md" >}})
- How to [remove]({{< ref "/watermark/java/developer-guide/advanced-usage/searching-and-modifying-watermarks/_index.md" >}}) watermarks
- Add watermark to [slides]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-presentation-documents/_index.md" >}})
---

**GroupDocs.Watermark for Java** is your complete solution for **custom watermarking**, **document security**, and **content protection**. It supports **Word files**, PDFs, images, and many other formats.

Start protecting your documents with smart watermarking today.

---

## Features Overview

Path: /watermark/nodejs-java/features-overview/


## What Is GroupDocs.Watermark?

GroupDocs.Watermark for Java is a powerful API for managing watermarks in the documents of different file formats. It provides the effective watermarking methods that allow you to add watermarks that are hard to be automatically removed by third-party tools. It also allows you to search and remove previously added watermarks of popular types (including watermarks added by third-party tools) in a document. The API provides straightforward and easy to use set of methods to add, search, and remove watermarks in supported file formats.

## Why Use GroupDocs.Watermark as a Developer?

*   Fetch all Documents of Various Formats from a Folder and Apply or Remove Watermarks
*   Add or Remove Watermark from a Particular Section or whole Document
*   Attach Watermark to all Images in a Particular Section, Page, Slide, or Document
*   Assign Watermark to only Particular Frames of a Multi-Framed Image
*   Allocate Hidden Watermark to PDF that only Appears when Printing Document
*   Set Watermark to all Attachments in an Excel Document & all Image Shapes in Slides
*   Place Watermark or Remove it from the Background Images of Spreadsheet or Slides
*   Employ Watermark to Supported Files in all Attachments of an Email or PDF Document
*   Apply or Remove Watermark as XObjects, Artifacts & Annotations in PDF Documents
*   Eliminate Watermark Containing Text with Particular Formatting
*   Look for Image Watermarks that Resemble a Particular Image
*   Identify Text Watermark Even if there are Unreadable Characters between Letters
*   Search Watermarks Based on Specific Parameters or by Combining Multiple Criteria
*   Specify Font Formatting to Look for Matching Text Watermark
*   Programmatically Extract Page Setup & Other Information for Supported Formats
*   Add Watermark to Images inside any Header & Footer in Supported Document Formats
*   Add Watermark to Image Shapes in a Word Document & Lock Watermarks to Restrict Editing
*   Protect Text Watermark using Unreadable Characters in Presentations
*   Rasterize Particular Page or Whole PDF Document to Protect Added Watermarks
*   Change Text Formatting While Replacing Existing Text Watermark
*   Align Watermark to Bleed Box, Art Box, Crop Box, or Trim Box in PDF Document
---

## Filtering annotations by type on saving document

Path: /annotation/java/filtering-annotation-types/

To save the annotations of specific types only, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class. Call the [setAnnotationType()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/#setAnnotationTypes-int-) method and specify the annotation type(s) to save.
3.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method with the output document path or stream. Specify the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class as a parameter.

The following code snippet shows how to save only pages with specific annotation type:

{{< tabs "example1">}}
{{< tab "Java" >}}
// This example demonstrates saving result document with specified annotations.

// Create an instance of Annotator class
Annotator annotator = new Annotator(Constants.ANNOTATED_BIG);
try {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setBackgroundColor(65535);
    area.setPageNumber(1);
    
    // Create an instance of EllipseAnnotation class and set options
    EllipseAnnotation ellipse = new EllipseAnnotation();
    ellipse.setBox(new Rectangle(100, 100, 100, 100));
    ellipse.setBackgroundColor(123456);
    ellipse.setPageNumber(4);
    
    List<AnnotationBase> tmp0 = new ArrayList<AnnotationBase>();
    tmp0.add(area);
    tmp0.add(ellipse);
    annotator.add(tmp0);
    
    SaveOptions tmp1 = new SaveOptions();
    tmp1.setAnnotationTypes(AnnotationType.Ellipse);
    
    // Add annotation and save to file
    annotator.save(outputPath, tmp1);
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Filtering annotations by type on saving document

Path: /annotation/net/filtering-annotation-types/

To save only annotations of specific types, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class. Set the [AnnotationType](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions/properties/annotationtypes) property by specifying annotation type(s) to save.
3.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method with the output document path or stream. Specify the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class as a parameter.

The following code snippet shows how to save only pages with specific annotation type:

{{< tabs "example1">}}
{{< tab "C#" >}}
using (Annotator annotator = new Annotator("input.pdf"))
{
	AreaAnnotation area = new AreaAnnotation()
    {
    	Box = new Rectangle(100, 100, 100, 100),
        BackgroundColor = 65535,
        PageNumber = 1
    };
    EllipseAnnotation ellipse = new EllipseAnnotation()
    {
        Box = new Rectangle(100, 100, 100, 100),
        BackgroundColor = 123456,
        PageNumber = 1
    };
    annotator.Add(new List<AnnotationBase>() { area, ellipse });
	
	//Result file will contains only ellipse annotations.
    annotator.Save("result.pdf" new SaveOptions { AnnotationTypes = AnnotationType.Ellipse});
}
```
{{< /tab >}}
{{< /tabs >}}

If you need to save annotations of several types, use the **OR** operator ("|").

The following code snippet shows how to save pages with specific annotation types:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	...
    annotator.Save("result.pdf" new SaveOptions { AnnotationTypes = AnnotationType.Ellipse|AnnotationType.Watermark});
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load from local disk

Path: /watermark/net/load-from-local-disk/

The following example demonstrates how to create a [watermarker](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) for a local file system document:

**AdvancedUsage.LoadingDocuments.LoadFromLocalDisk**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
string filePath = "document.docx";
using (Watermarker watermarker = new Watermarker(filePath))
{
    // use watermarker methods to manage watermarks
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
    watermarker.Add(watermark);
    watermarker.Save("document.docx");
}
```

---

## Generate sample report for document with variable

Path: /assembly/python-net/barcode/


## Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**Template Syntax**

```python
assembler = ga.DocumentAssembler()
dataSource = ga.data.XmlDataSource("datasource.xml")
DataSourceInfo = ga.DataSourceInfo(dataSource)
array = [DataSourceInfo]
print(assembler.assemble_document(input.ppt, output.ppt, array))
```

**DataSource XML**
```xml
<Product>
    <Discount>0</Discount>
    <ProductID>1</ProductID>
    <ProductName>LG Nexus 5</ProductName>
    <ProductPrice>350</ProductPrice>
    <UnitsInStock>5</UnitsInStock>
	<Barcode>123456789qwertyu0025</Barcode>
  </Product>
```

## The Recipe

*   Set up the source document data path
*   Set up the source document template path
*   Set up destination report path
*   Instantiate [DocumentAssembler](https://reference.groupdocs.com/python-net/assembly/groupdocs.assembly/documentassembler) class
*   Generate report

## More resources

### Advanced usage topics

To learn more about library features, please refer to the[advanced usage section]({{< ref "assembly/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Assembly for .NET examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
    
*   [GroupDocs.Assembly for Java examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)

*   [GroupDocs.Assembly for Python via .NET examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

---

## Generating document preview - advanced

Path: /signature/java/generating-document-preview-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [PreviewOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions) class to specify different options to manage document pages preview generation process. Since 20.3 version there's ability to hide signatures from documents. Using property [setHideSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions#setHideSignatures(boolean)) of [PreviewOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions) will allow to hide signatures from document preview.  
  
Here are the steps to generate document preview with GroupDocs.Signature with hidden signatures:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate the [PreviewOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions) object with:
    
    *   delegate for each page stream creation (see [PageStreamFactory](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PageStreamFactory));   
        
    *   property [setHideSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions#setHideSignatures(boolean)) set to true  
        
    *   image preview format - PNG / JPG / BMP, 
        
    *   page numbers to process;
        
    *   custom size of preview images (if needed).   
        
        {{< alert style="info" >}} Stream that were created by createPageStream delegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument closePageStream to clean up resources.{{< /alert >}}
*   Call [generatePreview](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#generatePreview(com.groupdocs.signature.options.PreviewOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [PreviewOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions) to it.
    

## Generate document preview without signatures on it

```java
public static void getPreview()
{
    // The path to the documents directory.
    String filePath = "C:\signed.pdf";
 
    Signature signature = new Signature(filePath);
    try
    {
        // create preview options object
        PreviewOptions previewOption = new PreviewOptions(new PageStreamFactory() {
            @Override
            public OutputStream createPageStream(int pageNumber) {
                return generateStream(pageNumber);
            }
 
            @Override
            public void closePageStream(int pageNumber, OutputStream pageStream) {
                releasePageStream(pageNumber, pageStream);
            }
        });
        previewOption.setPreviewFormat(PreviewFormats.JPEG);
        previewOption.setHideSignatures(true);
        // generate preview
        signature.generatePreview(previewOption);
 
    }catch (Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
 
 
private static OutputStream generateStream(int pageNumber)
{
    try {
        Path path = Paths.get("C:\\GeneratePreviewHideSignatures\\");
 
        if (!Files.exists(path)) {
 
            Files.createDirectory(path);
            System.out.println("Directory created");
        } else {
 
            System.out.println("Directory already exists");
        }
        File filePath = new File(path+"\\image-"+pageNumber+".jpg");
 
        return new FileOutputStream(filePath);
    }catch (Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
 
}
 
private static void releasePageStream(int pageNumber, OutputStream pageStream)
{
    try {
        pageStream.close();
        String imageFilePath = new File("C:\\GeneratePreviewHideSignatures", "image-" +pageNumber +  ".jpg").getPath();
        System.out.print("Image file "+imageFilePath+" is ready for preview");
    }catch (Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Generating document preview - advanced

Path: /signature/net/generating-document-preview-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) class to specify different options to manage document pages preview generation process. Since 19.12 version there's ability to hide signatures from documents. Using property [HideSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions/hidesignatures) of [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) will allow to hide signatures from document preview.  
  
Here are the steps to generate document preview with GroupDocs.Signature with hidden signatures:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) object with:
* delegate for each page stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/createpagestream));  
* property [HideSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions/hidesignatures) set to true;
* image preview format - PNG / JPG / BMP;
* page numbers to process;
* custom size of preview images (if needed).  
{{< alert style="info" >}}
Stream that were created by CreatePageStreamdelegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument [ReleasePageStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/releasepagestream) to clean up resources.  
{{< /alert >}}  
* Call GeneratePreview method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) to it.

## Generate document preview without signatures on it

```csharp
public static void GetPreview()
{
    // The path to the documents directory.
    string filePath = Constants.SAMPLE_WORD_SIGNED;
    using (Signature signature = new Signature(filePath))
    {
        // create preview options object
        PreviewOptions previewOption = new PreviewOptions(CreatePageStream, ReleasePageStream)
        {
            PreviewFormat = PreviewOptions.PreviewFormats.JPEG,
            // set property to hide all known signatures
            HideSignatures = true
        };
        // generate preview
        signature.GeneratePreview(previewOption);
    }
}

private static Stream CreatePageStream(PreviewPageData pageData)
{
    string imageFilePath = Path.Combine("GeneratePreviewFolder", "image-" + pageData.PageNumber.ToString() + ".jpg");
    var folder = Path.GetDirectoryName(imageFilePath);
    if(!Directory.Exists(folder))
    {
       Directory.CreateDirectory(folder);
    }
    return new System.IO.FileStream(imageFilePath, FileMode.Create);
}

private static void ReleasePageStream(PreviewPageData pageData, Stream pageStream)
{
    pageStream.Dispose();
    string imageFilePath = Path.Combine("GeneratePreviewFolder", "image-" + pageData.PageNumber.ToString() + ".jpg");
    Console.WriteLine("Image file {0} is ready for preview", imageFilePath);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Generating Report using Multiple Data Sources in Word Processing Document

Path: /assembly/java/generating-report-using-multiple-data-sources-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a report. This report will fetch data from multiple data sources.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Generating Report in Microsoft Word Document

### Creating a Template

1.  Add a bullet list at the place where you want it to display clients' names.
2.  Insert a table with two columns, that will show managers' and their contact prices.
3.  Save your Document

### Reporting Requirement

As a report developer, you are required to generate a report that fetches data from two different data sources (e:g custom object, excel data table). Report must show following information:

*   Bulleted list of clients
*   A table showing managers' along with their contract prices and sum of contract prices

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

We provide support for the following clients:
```
- <<foreach [in getClients()]>><<[getName()]>>
<</foreach>>
```

**Total Contract Prices by Managers**

| **Manager**                                                  | **Total Contract Price**                                     |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| **<<foreach [group in contracts**<br />    **.groupBy(c => c.Manager)**<br />    **.orderBy(g => g.key)]>>**<br />**<<[group.key]>>** | <<[group.sum(<br />    c => c.Contract_Price)]>><br /><</foreach>> |

### Download Template

Get template from here:

*   [Multiple DS.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Multiple%20DS.docx?raw=true)

### Generating the ReportGenerating Report using Excel Data Source and Custom Objects

{{< gist GroupDocsGists b9d4a5a09feb9868d1da9e07f3496f00 >}}



---

## Generating Report using Multiple Data Sources in Word Processing Document

Path: /assembly/net/generating-report-using-multiple-data-sources-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a report. This report will fetch data from multiple data sources.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Generating Report in Microsoft Word Document

### Creating a Template

1.  Insert a desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Add a bullet list at the place where you want it
4.  Save your Document

### Reporting Requirement

As a report developer, you are required to generate a report that fetches data from two different data sources (e:g XML, JSON). Report must show following information:

*   Customer name and picture
*   List of products

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

&lt;&lt;foreach [in customers]>>

<table class="gd-assembly1"cellspacing="0" cellpadding="0" style="border-collapse: collapse; float: bottom; margin-top: 0pt; margin-right: 9pt; margin-bottom: 0pt; margin-left: 9pt; width: 132.15pt; height: 132.15pt ">
	<tbody>
		<tr>
			<td style="vertical-align: top;">&lt;&lt;image [customer.Photo]>></td>
		</tr>
	</tbody>
</table>

**&lt;&lt;[CustomerName]>>**

&lt;&lt;/foreach>>

**List of Products**

```csharp
We provide support for the following products:
. <<foreach [in products]>><<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Get template from here.

*   [Multiple DS.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Multiple%20DS.docx?raw=true)

### Generating the Report

{{< gist GroupDocsGists c4e760407e1a84ba8ca863cf96faede0 >}}

## Generating Report in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating a report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

Get template from here.

*   [Multiple DS.odt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Multiple%20DS.odt?raw=true)

### Generating the Report

{{< gist GroupDocsGists b2875d58468c1f71d70f4f9bc1cec833 >}}



---

## Get default convert options for a target format

Path: /conversion/net/get-default-convert-options-for-target-format/

**[GroupDocs.Conversion](https://products.groupdocs.com/conversion/net)** allows you to get default predefined convert options for a desired target document format. This will allow you to get predefined convert options runtime, knowing the desired target format.

To get default convert options, follow these steps:

1.   Create an instance of [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class and pass source document path as a constructor parameter.
2.   Invoke the [GetPossibleConversions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/getpossibleconversions) converter method.
3.   Use the [file type](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/possibleconversions/item) or [file extension](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/possibleconversions/item/#possibleconversions-indexer-2-of-2) indexer of the received possible conversion and read the [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/targetconversion/convertoptions) property.
4.   Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class instance and pass the filename of the converted document and the instance of [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) from the previous step.

The following code snippet shows how to get predefined convert options for a desired target format:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    var possibleConversion = converter.GetPossibleConversions();
    var convertOptions = possibleConversion["pdf"].ConvertOptions;
    converter.Convert(outputFile, convertOptions);
}
```


---

## Get Default Load Options

Path: /conversion/python-net/developer-guide/loading-documents/get-default-load-options/


*GroupDocs.Conversion for Python via .NET* enables you to retrieve default load options for specific document formats, useful for setting format-specific defaults at runtime.

To obtain default load options for a document format, use the `get_possible_conversions_by_extension` method, passing the source document’s file extension (e.g., `"docx"` for Word documents). This example demonstrates how to retrieve the default load options.

```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.load import WordProcessingLoadOptions

def get_default_load_options():
    # Step 1: Retrieve possible conversions for a DOCX extension
    possible_conversions = Converter.get_possible_conversions_by_extension("docx")

    # Step 2: Use the default load options 
    default_load_options = possible_conversions.load_options

    # You can also instantiate load options by yourself
    word_processing_load_options = WordProcessingLoadOptions()

if __name__ == "__main__":
    get_default_load_options()
```

### Explanation

- **Retrieve Default Load Options**: The `get_possible_conversions_by_extension` method returns possible conversions along with default load options for a specified format.
- **Using Default Load Options**: The `default_load_options` object holds settings that can be used directly for initializing conversions.
- **Manual Load Options Initialization**: Alternatively, you can create specific load options (e.g., `WordProcessingLoadOptions`) manually if customization is required.

By retrieving and using these default settings, you can streamline conversions while preserving format-specific options.

For further details, consult the [API Reference](https://reference.groupdocs.com/conversion/python-net/).

---

## Get default load options for a source format

Path: /conversion/java/get-default-load-options-for-source-format/

**[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java)** allows you to get default load options for the source document format. This will allow you to get default load options runtime, knowing the source format.

To get default options, follow these steps:

1.   Call the static [getPossibleConversion](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#getPossibleConversions--) method of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class with source file extension as a parameter.
2.   From received possible conversion read the [LoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/loadoptions/) property.
3.   Create an instance of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class and pass source document path as a constructor parameter and load options from the previous step.
4.   Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) class e.g. (**[PdfConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/spreadsheetconvertoptions/)** etc.).
5.   Call the [Convert](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#convert-java.lang.String-com.groupdocs.conversion.options.convert.ConvertOptions-) method of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class instance and pass filename for the converted document and the instance of [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) from the previous step.

The following code snippet shows how to get default load options for a Word processing document:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.PossibleConversions;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

public static void getDefaultLoadOptions()
{
    // Step 1: Retrieve possible conversions for a DOCX extension
    PossibleConversions possibleConversions = Converter.getPossibleConversions("docx");

    // Step 2: Use the default load options 
    WordProcessingLoadOptions loadOptions = (WordProcessingLoadOptions) possibleConversions.getLoadOptions();
    loadOptions.setPassword("12345");

    // Step 3: Specify source file path and load options
    Converter converter = new Converter("password_protected.docx", () -> loadOptions);

    // Step 4: Specify output file location and convert options
    PdfConvertOptions convertOptions = new PdfConvertOptions();

    // Step 5: Convert and save to output path
    converter.convert("outputFile.pdf", convertOptions);

}

public static void main(String[] args){
    getDefaultLoadOptions();
}
```

---

## Get document info

Path: /metadata/java/get-document-info/

GroupDocs.Metadata allows users to get document information which includes:

*   [File format](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/FileTypePackage#getFileFormat()) (detected by the internal structure)
*   [File extension](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/FileTypePackage#getExtension())
*   [MIME type](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/FileTypePackage#getMimeType())
*   [Number of pages](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IDocumentInfo#getPageCount())
*   [File size](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IDocumentInfo#getSize())
*   A [value](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IDocumentInfo#isEncrypted()) indicating whether a file is encrypted

The following code sample demonstrates how to extract basic format information from a file.

**basic\_usage.GetDocumentInfo**

```csharp
// Constants.InputXlsx is an absolute or relative path to your document. Ex: @"C:\Docs\source.xlsx"
try (Metadata metadata = new Metadata(Constants.InputXlsx)) {
	if (metadata.getFileFormat() != FileFormat.Unknown) {
		IDocumentInfo info = metadata.getDocumentInfo();
		System.out.println(String.format("File format: %s", info.getFileType().getFileFormat()));
		System.out.println(String.format("File extension: %s", info.getFileType().getExtension()));
		System.out.println(String.format("MIME Type: %s", info.getFileType().getMimeType()));
		System.out.println(String.format("Number of pages: %s", info.getPageCount()));
		System.out.println(String.format("Document size: %s bytes", info.getSize()));
		System.out.println(String.format("Is document encrypted: %s", info.isEncrypted()));
	}
}
```

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Get document info

Path: /metadata/net/get-document-info/

GroupDocs.Metadata allows users to get meta information of a document which includes:

*   [File format](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/filetypepackage/properties/fileformat) (detected by the internal structure)
*   [File extension](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/filetypepackage/properties/extension)
*   [MIME type](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/filetypepackage/properties/mimetype)
*   [Number of pages](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/idocumentinfo/properties/pagecount)
*   [File size](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/idocumentinfo/properties/size)
*   A [value](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/idocumentinfo/properties/isencrypted) indicating whether a file is encrypted

The following code sample demonstrates how to extract basic format information from a file.

**BasicUsage.GetDocumentInfo**

```csharp
// Constants.InputXlsx is an absolute or relative path to your document. Ex: @"C:\Docs\source.xlsx"
using (Metadata metadata = new Metadata(Constants.InputXlsx))
{
	if (metadata.FileFormat != FileFormat.Unknown)
	{
		IDocumentInfo info = metadata.GetDocumentInfo();
		Console.WriteLine("File format: {0}", info.FileType.FileFormat);
		Console.WriteLine("File extension: {0}", info.FileType.Extension);
		Console.WriteLine("MIME Type: {0}", info.FileType.MimeType);
		Console.WriteLine("Number of pages: {0}", info.PageCount);
		Console.WriteLine("Document size: {0} bytes", info.Size);
		Console.WriteLine("Is document encrypted: {0}", info.IsEncrypted);
	}
}
```

## More resources
### Advanced usage topics
To learn more about document watermarking features and get familiar how to manage watermarks and more, please refer to the [advanced usage section]({{< ref "metadata/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Get document info

Path: /metadata/nodejs-java/get-document-info/

GroupDocs.Metadata allows users to get document information which includes:

*   __File format__ (detected by the internal structure)
*   __File extension__
*   __MIME type__
*   __Number of pages__
*   __File size__
*   A __value__ indicating whether a file is encrypted

The following code sample demonstrates how to extract basic format information from a file.

**basic\_usage.GetDocumentInfo**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata("input.xlsx");

    if (metadata.getFileFormat() != groupdocs.metadata.FileFormat.Unknown) {
        var info = metadata.getDocumentInfo();
        console.log(`File format: ${info.getFileType().getFileFormat()}`);
        console.log(`File extension: ${info.getFileType().getExtension()}`);
        console.log(`MIME Type: ${info.getFileType().getMimeType()}`);
        console.log(`Number of pages: ${info.getPageCount()}`);
        console.log(`Document size: ${info.getSize()}`);
        console.log(`Is document encrypted: ${info.isEncrypted()}`);
    }
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Get document info

Path: /metadata/python-net/get-document-info/

GroupDocs.Metadata allows users to get document information which includes:

*   __File format__ (detected by the internal structure)
*   __File extension__
*   __MIME type__
*   __Number of pages__
*   __File size__
*   A __value__ indicating whether a file is encrypted

The following code sample demonstrates how to extract basic format information from a file.

**basic\_usage.GetDocumentInfo**


```python
with gm.Metadata(constants.input_xlsx) as metadata:
        info = metadata.get_document_info()
        print(f"File format: {info.file_type.file_format}")
        print(f"File extension: {info.file_type.extension}")
        print(f"MIME Type: {info.file_type.mime_type}")
        print(f"Number of pages: {info.page_count}")
        print(f"Document size: {info.size} bytes")
        print(f"Is document encrypted: {info.is_encrypted}")
```


## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Get document Info

Path: /watermark/java/get-document-info/

GroupDocs.Watermark allows to get document information which includes:

*   [FileType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/IDocumentInfo#getFileType())
*   [PageCount](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/IDocumentInfo#getPageCount())
*   [FileSize](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/IDocumentInfo#getSize())
*   [IsEncrypted](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/IDocumentInfo#isEncrypted())

The following code samples demonstrate how to get document information.

## Get document information from a file from local disk

This example demostrates how to get document information from the local file.

**basic\_usage.GetDocumentInfoForTheFileFromLocalDisk**

```java
// Specify an absolute or relative path to your document. Ex.: "C:\\Docs\\source.docx"
Watermarker watermarker = new Watermarker("source.docx");                                      
IDocumentInfo info = watermarker.getDocumentInfo();                                                 
System.out.println("File type: " + info.getFileType());                                             
System.out.println("Number of pages: " + info.getPageCount());                                      
System.out.println("Document size: " + info.getSize() + " bytes");
watermarker.dispose();
```

## Get document information from a stream

This example demonstrates how to get document information from the file stream.

**basic\_usage.GetDocumentInfoForTheFileFromStream**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\source.docx"
FileInputStream stream = new FileInputStream("source.docx");                                  
Watermarker watermarker = new Watermarker(stream);                                                     
IDocumentInfo info = watermarker.getDocumentInfo();                                                    
System.out.println("File type: " + info.getFileType());                                                
System.out.println("Number of pages: " + info.getPageCount());                                         
System.out.println("Document size: " + info.getSize() + " bytes");
watermarker.dispose();
stream.close();
```

---

## Get HTML markup in different forms

Path: /editor/java/get-html-markup-in-different-forms/

> This demonstration shows how to open input document, convert it to intermediate [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), and get HTML markup in different forms depending on client requirements.

## Preparations

When input document is loaded into [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class and opened for edit by transforming to the intermediate [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class, it is possible to generate and get HTML markup in different forms. Code below shows all variations of such procedure.

First of all user needs to load document into [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class and open it for editing, what is demonstrated in the code below.

```java
String inputFilePath = "C:\\input_path\\document.docx"; //path to some document
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
Editor editor = new Editor(inputFilePath, loadOptions); //passing path and load options (via delegate) to the constructor
EditableDocument document = editor.edit(new WordProcessingEditOptions()); //opening document for editing with format-specific edit options

```

Piece of code above has prepared a ready-to-use instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class, that contains the original document in its own intermediate format and is able to generate HTML markup in different forms.

## Getting whole HTML content

The most default and standard method for generating HTML markup is parameterless [getContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getContent--) method:

```java
String htmlContent = document.getContent();
```

If document has external resources (stylesheets, fonts, images), they are referenced via different HTML elements: stylesheets are specified through LINK elements, while images — through IMG. When using the [getContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getContent--) method, such external resources will be referenced by external links. For example:

```java
<link href="stylesheet.css" rel="stylesheet"/>
<IMG src="image.png"/"> 
```

Quite often on the web-server, where such HTML will be edited, resources are processed by specific HTTP handler. In such cases it is required to adjust paths to such endpoints. More advanced overload of the [getContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getContent--) method can help:

```java
String externalImagesPrefix = "http://www.mywebsite.com/images/id=";
String externalCssPrefix = "http://www.mywebsite.com/css/id=";
String prefixedHtmlContent = document.getContent(externalImagesPrefix, externalCssPrefix);
```

In the example above specified prefixes will be added to every external link in the document's markup. For example, with the code above link will be the next:

```java
<link href="http://www.mywebsite.com/css/id=stylesheet.css" rel="stylesheet"/>
<IMG src="http://www.mywebsite.com/css/id=image.png"/"> 
```

## Getting HTML BODY content

Lot of HTML WYSIWYG editors are not able to process the whole HTML document, with HEAD section and so on. They are able only to process inner content of HTML->BODY element. In order to obtain such part of HTML markup, [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class contains the [getBodyContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getBodyContent--) method, which, as previous one, has two overloads, that are provided below:

```java
String bodyContent = document.getBodyContent();
String externalImagesPrefix = "http://www.mywebsite.com/images/id=";
String prefixedBodyContent = document.getBodyContent(externalImagesPrefix); 
```

First parameterless overload, like previous one, leaves links to the external images intact. Second, that obtains external resource prefix, adds this prefix to every url in the 'src' attribute of every IMG tag, that is found inside HTML->BODY markup.

## Getting base64-encoded content

Sometimes it is necessary to obtain all content of all document with all used resources into one single string. GroupDocs.Editor allows to do this:

```java
String embeddedHtmlContent = document.getEmbeddedHtml();
```

In such string all stylesheets will be placed into the STYLE elements in the HTML->HEAD section, all images in IMG elements will be serialized with base64 encoding and placed directly in the 'src' attributes. All fonts and images, which are used in stylesheets, will also be serialized and stored in appropriate locations in the corresponding stylesheet. Such string will be fully autonomous and self-sufficient.

## Conclusion

This guide has explained different ways of obtaining HTML markup from a document in different forms.

---

## Get HTML markup in different forms

Path: /editor/net/get-html-markup-in-different-forms/

> This demonstration shows how to open input document, convert it to intermediate [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), and get HTML markup in different forms depending on client requirements.

## Preparations

When input document is loaded into [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class and opened for edit by transforming to the intermediate [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, it is possible to generate and get HTML markup in different forms. Code below shows all variations of such procedure.

First of all user needs to load document into [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class and open it for editing, what is demonstrated in the code below.

```csharp
string inputFilePath = "C:\\input_path\\document.docx"; //path to some document
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
Editor editor = new Editor(inputFilePath, loadOptions); //passing path and load options to the constructor
EditableDocument document = editor.Edit(new WordProcessingEditOptions()); //opening document for editing with format-specific edit options
```

Piece of code above has prepared a ready-to-use instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, that contains the original document in its own intermediate format and is able to generate HTML markup in different forms.

## Getting whole HTML content

The most default and standard method for generating HTML markup is parameterless [GetContent](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcontent) method:

```csharp
string htmlContent = document.GetContent();

```

If document has external resources (stylesheets, fonts, images), they are referenced via different HTML elements: stylesheets are specified through LINK elements, while images — through IMG. When using the [GetContent()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcontent) method, such external resources will be referenced by external links. For example:

```html
<link href="stylesheet.css" rel="stylesheet"/>
<IMG src="image.png"/>
```

Quite often on the web-server, where such HTML will be edited, resources are processed by specific HTTP handler. In such cases it is required to adjust paths to such endpoints. More advanced overload of the [GetContent()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcontent) method can help:

```csharp
string externalImagesPrefix = "http://www.mywebsite.com/images/id=";
string externalCssPrefix = "http://www.mywebsite.com/css/id=";
string prefixedHtmlContent = document.GetContent(externalImagesPrefix, externalCssPrefix);
```

In the example above specified prefixes will be added to every external link in the document's markup. For example, with the code above link will be the next:

```html
<link href="http://www.mywebsite.com/css/id=stylesheet.css" rel="stylesheet"/>
.....
<IMG src="http://www.mywebsite.com/css/id=image.png"/> 
```

Starting from the GroupDocs.Editor for .NET [version 23.9](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-9-release-notes/) it is possible not only to specify the prefix, but also a template format string, where one or more placeholders mark the places, where resource names will be recorded. If specified string contains valid placeholder(s), then a GroupDocs.Editor will replace the placeholder with a resource name. Otherwise, if placeholder(s) are not found, GroupDocs.Editor will treat it as a prefix string. For example, the next code sample shows specifying the template string for the external images and stylesheets:

```csharp
string externalImagesTemplate = "http://www.mywebsite.com/images/{0}/expires=3600&token={0}";
string externalCssTemplate = "http://www.mywebsite.com/css/{0}/expires=60&token={0}";
string templatedHtmlContent = document.GetContent(externalImagesTemplate, externalCssTemplate);
```

In the example above the resource names will be placed inside the placeholders in the specified template strings, so, if the original document contains a stylesheet and two images named "`foo.jpeg`" and "`bar.png`", the output HTML markup will be the next:

```html
<link href="http://www.mywebsite.com/css/stylesheet.css/expires=60&token=stylesheet.css" rel="stylesheet"/>
.....
<IMG src="http://www.mywebsite.com/images/foo.jpeg/expires=3600&token=foo.jpeg"/>
.....
<IMG src="http://www.mywebsite.com/images/bar.png/expires=3600&token=bar.png"/>
```

## Getting HTML BODY content

Lot of HTML WYSIWYG editors are not able to process the whole HTML document, with HEAD section and so on. They are able only to process inner content of HTML->BODY element. In order to obtain such part of HTML markup, [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class contains the [GetBodyContent()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcontent) method, which, as previous one, has two overloads, that are provided below:

```csharp
string bodyContent = document.GetBodyContent();
string externalImagesPrefix = "http://www.mywebsite.com/images/id=";
string prefixedBodyContent = document.GetBodyContent(externalImagesPrefix); 
```

First parameterless overload, like previous one, leaves links to the external images intact. Second, that obtains external resource prefix, adds this prefix to every url in the 'src' attribute of every IMG tag, that is found inside HTML->BODY markup.

As in previous sample, starting from the [version 23.9](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-9-release-notes/) it may be not only a prefix, but also a template string.

## Getting base64-encoded content

Sometimes it is necessary to obtain all content of all document with all used resources into one single string.GroupDocs.Editor allows to do this:

```csharp
string embeddedHtmlContent = document.GetEmbeddedHtml();
```

In such string all stylesheets will be placed into the STYLE elements in the HTML->HEAD section, all images in IMG elements will be serialized with base64 encoding and placed directly in the 'src' attributes. All fonts and images, which are used in stylesheets, will also be serialized and stored in appropriate locations in the corresponding stylesheet. Such string will be fully autonomous and self-sufficient.

## Conclusion

This guide has explained different ways of obtaining HTML markup from a document in different forms.

---

## Get HTML Markup in Different Forms

Path: /editor/nodejs-java/get-html-markup-in-different-forms/


> This guide demonstrates how to open an input document, convert it to an intermediate `EditableDocument`, and get HTML markup in different forms depending on client requirements using GroupDocs.Editor for Node.js via Java.

## Preparations

When an input document is loaded into the `Editor` class and opened for editing by transforming it into the intermediate `EditableDocument` class, it is possible to generate and get HTML markup in different forms. The code below shows various methods to achieve this.

First, you need to load the document into the `Editor` class and open it for editing, as demonstrated in the code below.

```javascript
// Import necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Specify the input file path
const inputFilePath = 'C:\\input_path\\document.docx'; // Path to some document

// Create load options
const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();

// Create an Editor instance with the input file and load options
const editor = new groupdocsEditor.Editor(inputFilePath, loadOptions);

// Open the document for editing with format-specific edit options
const editOptions = new groupdocsEditor.WordProcessingEditOptions();
const document = editor.edit(editOptions);
```

The code above prepares a ready-to-use instance of the `EditableDocument` class, which contains the original document in its own intermediate format and is able to generate HTML markup in different forms.

## Getting Whole HTML Content

The most default and standard method for generating HTML markup is the parameterless `getContent()` method:

```javascript
const htmlContent = document.getContent();
```

If the document has external resources (stylesheets, fonts, images), they are referenced via different HTML elements: stylesheets are specified through `<link>` elements, while images through `<img>`. When using the `getContent()` method, such external resources will be referenced by external links. For example:

```html
<link href="stylesheet.css" rel="stylesheet"/>
<img src="image.png"/>
```

Quite often on the web server where such HTML will be edited, resources are processed by specific HTTP handlers. In such cases, it is required to adjust paths to such endpoints. A more advanced overload of the `getContent()` method can help:

```javascript
const externalImagesPrefix = "http://www.mywebsite.com/images/id=";
const externalCssPrefix = "http://www.mywebsite.com/css/id=";
const prefixedHtmlContent = document.getContent(externalImagesPrefix, externalCssPrefix);
```

In the example above, the specified prefixes will be added to every external link in the document's markup. For example, with the code above, the links will be as follows:

```html
<link href="http://www.mywebsite.com/css/id=stylesheet.css" rel="stylesheet"/>
<img src="http://www.mywebsite.com/images/id=image.png"/>
```

## Getting HTML BODY Content

Many HTML WYSIWYG editors are not able to process the whole HTML document with the `<head>` section and so on. They are able only to process the inner content of the HTML `<body>` element. To obtain such a part of the HTML markup, the `EditableDocument` class contains the `getBodyContent()` method, which, like the previous one, has two overloads, as shown below:

```javascript
const bodyContent = document.getBodyContent();
const externalImagesPrefix = "http://www.mywebsite.com/images/id=";
const prefixedBodyContent = document.getBodyContent(externalImagesPrefix);
```

The first parameterless overload, like the previous one, leaves links to the external images intact. The second, which accepts the external resource prefix, adds this prefix to every URL in the `src` attribute of every `<img>` tag found inside the HTML `<body>` markup.

## Getting Base64-Encoded Content

Sometimes it is necessary to obtain all the content of the document with all used resources into one single string. GroupDocs.Editor allows you to do this:

```javascript
const embeddedHtmlContent = document.getEmbeddedHtml();
```

In such a string, all stylesheets will be placed into `<style>` elements in the HTML `<head>` section, and all images in `<img>` elements will be serialized with base64 encoding and placed directly in the `src` attributes. All fonts and images used in stylesheets will also be serialized and stored in appropriate locations in the corresponding stylesheet. Such a string will be fully autonomous and self-sufficient.

## Conclusion

This guide has explained different ways of obtaining HTML markup from a document in different forms using GroupDocs.Editor for Node.js via Java. Depending on your application's requirements, you can choose the most suitable method to extract the HTML content for editing or displaying purposes.

---

By following this guide, you can effectively work with the `EditableDocument` class to get HTML markup in various forms, facilitating seamless integration with HTML-based WYSIWYG editors or other applications.

**Note:** Be sure to replace the paths and variables in the code examples with the actual values used in your application.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Get possible conversions

Path: /conversion/net/get-possible-conversions/

There are multiple target formats available when converting documents with **[GroupDocs.Conversion](https://products.groupdocs.com/conversion/net)** and you can always refer to [supported file formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}}) documentation for more details.

But what about getting possible conversions programmatically? For example, it could allow end-users to select the target format for a specific document or to display the complete list of supported formats. 
Fortunately GroupDocs.Conversion API provides several ways to achieve this, so please check the available options below.

## Get possible conversions for a specific document

When you need to know possible conversions for a provided source document you can do this by following the below steps:

1.   Create an instance of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class by passing the source document path as the constructor's parameter.
2.   Call the [GetPossibleConversions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/getpossibleconversions) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) object.

The method will return the [PossibleConversions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/possibleconversions) collection with a complete list of possible conversions for the source document type.

The following code snippet shows how to get possible conversions of the source document:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PossibleConversions conversions = converter.GetPossibleConversions();
    Console.WriteLine("The source document is of type {0} and could be converted to:", conversions.Source.Extension);

    foreach (var conversion in conversions.All)
    {
        Console.WriteLine("\t {0} as {1} conversion.",
            conversion.Format,
            conversion.IsPrimary ? "primary" : "secondary");
    }    
}
```

Or you can use a [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
PossibleConversions conversions = FluentConverter.Load("sample.docx").GetPossibleConversions();
Console.WriteLine("The source document is of type {0} and could be converted to:", conversions.Source.Extension);

foreach (var conversion in conversions.All)
{
     Console.WriteLine("\t {0} as {1} conversion.",
        conversion.Format,
        conversion.IsPrimary ? "primary" : "secondary");
}    

```

## Get all available conversions 

If it is required to programmatically obtain a collection of all supported conversions it is as easy as calling a static [GetAllPossibleConversions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/getallpossibleconversions) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class.

The following code snippet shows how to get all possible conversions:

```csharp
var allPossibleConversions = Converter.GetAllPossibleConversions();
foreach (var possibleConversions in allPossibleConversions)
{
    Console.WriteLine($"Source format: {possibleConversions.Source.Description}");
    foreach (var conversion in possibleConversions.All)
    {
        Console.WriteLine("\t...can be converted to {0} format as {1} conversion.",
            conversion.Format,
            conversion.IsPrimary ? "primary" : "secondary");        
    }
}
```

---

## Get possible conversions

Path: /conversion/nodejs-java/get-possible-conversions/

There are multiple target formats available when converting documents with **[GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java)** and you can always refer to [supported file formats]({{< ref "conversion/nodejs-java/getting-started/supported-document-formats.md" >}}) documentation for more details.  
But what about getting possible conversions programmatically? For example, it could allow end-users to select the target format for a specific document or to display the complete list of supported formats. 
Fortunately GroupDocs.Conversion API provides several ways to achieve this, so please check the available options below.

## Get possible conversions for a specific document

When you need to know possible conversions for a provided source document you can do this by following the below steps:

1.   Create an instance of the [Converter](#) class by passing the source document path as the constructor's parameter.
2.   Call the [getPossibleConversions](#) method of the converter object.

The method will return the [PossibleConversions](#) collection with a complete list of possible conversions for the source document type.

The following code snippet shows how to get possible conversions of the source document:

```js
const sourceFile = "sample.docx";
const converter = new groupdocs.conversion.Converter(sourceFile);
const conversions = converter.getPossibleConversions();
console.log(
  util.format(
    '%s is of type %s and could be converted to:\n',
    inputFilePath,
    conversions.getSource().getExtension()
  )
);

const items = conversions.getAll();
console.log(items);

items.spliterator().getExactSizeIfKnown();

for (let i = 0; i < items.size(); i += 1) {
  const item = items.get(i);
  console.log(
    `\t ${item.getFormat().getExtension()} as ${
      item.isPrimary() ? 'primary' : 'secondary'
    } conversion.\n`
  );
}
```
## Get all available conversions 

If it is required to programmatically obtain a collection of all supported conversions it is as easy as calling the [getAllPossibleConversions](#) method of the [Converter](#) class.

The following code snippet shows how to get all possible conversions:

```js
const sourceFile = "sample.docx";
const converter = new groupdocs.conversion.Converter(sourceFile);
const conversions = converter.getPossibleConversions();
console.log(
  util.format(
    'Source format: %s \n',
    conversions.getSource().getDescription()
  )
);

const items = conversions.getAll();
items.spliterator().getExactSizeIfKnown();

for (let i = 0; i < items.size(); i += 1) {
  const item = items.get(i)
  console.log(util.format('\t...can be converted to %s format as %s conversion.\n'), item.getFormat(),  item.isPrimary() ? 'primary' : 'secondary');
}
```
---

## Get Possible Conversions

Path: /conversion/python-net/developer-guide/converting-documents/get-possible-conversions/


GroupDocs.Conversion offers several methods to retrieve possible conversions:

- **`Converter.get_all_possible_conversions()`**: Retrieves all available primary and secondary conversions for every supported file type.
- **`Converter.get_possible_conversions_by_extension(extension: str)`**: Retrieves possible conversions for a specific file extension, e.g., `"docx"`.
- **`converter.get_possible_conversions()`**: Retrieves possible conversions for the currently loaded file.

### Types of Conversions
* **Primary Conversion**: A direct conversion from one format to another, providing higher quality and better performance.
* **Secondary Conversion**: An indirect conversion that requires the source file to be first converted to an intermediate format before reaching the final format.

## Example 1: Get All Possible Conversions

The following example demonstrates how to retrieve and display all primary and secondary conversions for every supported file type.

{{< tabs "example-1">}}
{{< tab "get_all_possible_conversions.py" >}}  
```python
from groupdocs.conversion import Converter

def get_all_possible_conversions():
    # Get all possible conversions
    all_possible_conversions = Converter.get_all_possible_conversions()

    for possible_conversion in all_possible_conversions:
        # Filter primary conversions
        primary_conversions = [conversion.format for conversion in possible_conversion.all if conversion.is_primary]
        # Filter secondary conversions
        secondary_conversions = [conversion.format for conversion in possible_conversion.all if not conversion.is_primary]

        # Print out the source format and it's conversions
        print(f" **Source format** : {possible_conversion.source.description}")
        print(f"  - **Primary conversions**: {primary_conversions}")
        print(f"  - **Secondary conversions**: {secondary_conversions}")
        print()

if __name__ == "__main__":
    get_all_possible_conversions()
```
{{< /tab >}}
{{< tab "Console Output" >}}  
 **Source format**: Drawing Exchange Format File (dxf)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: AutoCAD Drawing Database File (dwg)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: MicroStation Design File (dgn)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

<details>
<summary>See Complete List</summary>

**Source format**: Design Web Format File (dwf)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Stereolithography File (stl)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Industry Foundation Classes File (ifc)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Initial Graphics Exchange Specification (IGES) (igs)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: AutoCAD Drawing Template (dwt)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Design Web Format File (dwfx)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Common File Format File (cf2)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: ZIP Compressed File (zip)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: RAR Compressed Archive (rar)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: 7-Zip Compressed File (7z)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Consolidated Unix File Archive (tar)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Gnu Zipped Archive (gz)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Gzip Compressed File (gzip)
  - **Primary conversions**: [zip, 7z, tar, gz, gzip, bz2, lz, z, xz, cpio, lzma, zst, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Bzip2 Compressed File (bz2)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Lzip Compressed File (lz)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Unix Compressed File (z)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Xz Compressed File (xz)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: CPIO Compressed File (cpio)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Windows Cabinet File (cab)
  - **Primary conversions**: [zip, 7z, tar, gz, gzip, bz2, lz, z, xz, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: LZMA Compressed File (lzma)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Zstandard (Zstd) Compressed File (zst)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: ISO File Format (iso)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Uuencoded archive (uue)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Visio Drawing File (vsd)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing File (vsdx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Stencil File (vss)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing Template (vst)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Stencil XML File (vsx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Template XML File (vtx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Web Drawing (vdw)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing XML File (vdx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Stencil File (vssx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing Template (vstx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Macro-Enabled Drawing (vsdm)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Macro-Enabled Stencil File (vssm)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Macro-Enabled Drawing Template (vstm)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PLT (HPGL) (plt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Open eBook File (epub)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Mobipocket eBook (mobi)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Amazon Kindle�s proprietary e-book file format (azw3)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Outlook Mail Message (msg)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: E-Mail Message (eml)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Apple Mail Message (emlx)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Vcf document format (vcf)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Mbox document format (mbox)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: JSON based Geographic File Format (geojson)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Geography Markup Language File Format (gml)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Keyhole Markup Language (kml)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: GPS Exchange File Format (gpx)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JSON based Topology File Format (topojson)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenStreetMap File Format (osm)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Tagged Image File Format (tiff)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Tagged Image File Format (tif)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG Image (jpg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG Image (jpeg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Portable Network Graphic (png)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Graphical Interchange Format File (gif)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Bitmap Image File (bmp)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Icon File (ico)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Adobe Photoshop Document (psd)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Windows Metafile (wmf)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Enhanced Windows Metafile (emf)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: DICOM Image (dcm)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: DICOM Image (dicom)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: WebP Image (webp)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Digital Negative Specification (dng)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Core Image File (jp2)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Graphic File (odg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Code Stream (j2c)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Code Stream (j2k)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Image File (jpx)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Image File (jpf)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Image File (jpm)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: CorelDraw Vector Graphic Drawing (cdr)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Corel Metafile Exchange (cmx)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Device Independent Bitmap File (dib)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Code Stream (jpc)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: DjVu Image (djvu)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Graphic Template (otg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Adobe Illustrator Artwork (ai)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Windows Compressed Enhanced Metafile (emz)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Compressed Windows Metafile (wmz)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Compressed Scalable Vector Graphics File (svgz)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Truevision TGA (TARGA) (tga)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Adobe Photoshop Big (psb)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Flat XML ODF Template (fodg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG File Interchange Format (jfif)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: HEIC File Format (heic)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OneNote Document (one)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Scalable Vector Graphics File (svg)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Encapsulated PostScript File (eps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Computer Graphics Metafile (cgm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: XML Paper Specification File (xps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: LaTeX Source Document (tex)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PostScript File (ps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Printer Command Language Document (pcl)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: XML Paper Specification File (oxps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Portable Document Format File (pdf)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Presentation (ppt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Slide Show (pps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Presentation (pptx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Slide Show (ppsx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Flat XML Presentation (odp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Presentation Template (otp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Presentation Template (potx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Template (pot)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Macro-Enabled Presentation Template (potm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Macro-Enabled Presentation (pptm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Macro-Enabled Slide (ppsm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Flat XML Presentation (fodp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Project Template (mpt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Project File (mpp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Project Exchange File (mpx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Primavera XER format (xer)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Outlook Personal Information Store File (pst)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Outlook Offline Data File (ost)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Lotus Notes Storage Format (nsf)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Outlook file for Mac Operating System. (olm)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Excel Spreadsheet (xls)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Open XML Spreadsheet (xlsx)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Excel Open XML Macro-Enabled Spreadsheet (xlsm)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Excel Binary Spreadsheet (xlsb)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Spreadsheet (ods)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Spreadsheet Template (ots)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Excel Open XML Spreadsheet Template (xltx)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Macro-Enabled Template (xlt)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Macro-Enabled Template (xltm)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Tab Separated Values File (tsv)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Add-in (xlam)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Csv document format (csv)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Flat XML Spreadsheet (fods)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: StarOffice Calc Spreadsheet (sxc)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Apple iWork Numbers (numbers)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: CHM File (chm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Hypertext Markup Language File (htm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Hypertext Markup Language File (html)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: MIME HTML File (mhtml)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: MHTML Web Archive (mht)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Word Document (doc)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Open XML Macro-Enabled Document (docm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Word Open XML Document (docx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Document Template (dot)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Open XML Macro-Enabled Document Template (dotm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Open XML Document Template (dotx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Rich Text Format File (rtf)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Text Document (odt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Document Template (ott)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Plain Text File (txt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Markdown Documentation File (md)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: XML File (xml)
  - **Primary conversions**: [epub, mobi, azw3, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, json, xml, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]

 **Source format**: Json File (json)
  - **Primary conversions**: [epub, mobi, azw3, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, json, xml, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]

 **Source format**: Extensible Business Reporting Language. (xbrl)
  - **Primary conversions**: [xbrl, ixbrl]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Inline XBRL. (ixbrl)
  - **Primary conversions**: [xbrl, ixbrl]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: TrueType Font (Ttf)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Embedded OpenType Font Format (eot)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: OpenType font (otf)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Compact Font Format (cff)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: PostScript Fonts (pfb)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Web Open Font Format (woff)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Web Open Font Format 2 (woff2)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Log File (log)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Sql File (sql)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Publisher format (pub)
  - **Primary conversions**: [pdf]
  - **Secondary conversions**: []

 **Source format**: FilmBox format (fbx)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: 3D Studio (3ds)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Microsoft 3D Manufacturing Format (3mf)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Additive manufacturing file format (amf)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: 3D Studio Max�s ASCII Scene Exporter format (ase)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: AVEVA Plant Design Management System Model (rvm)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Collada (dae)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Google Draco (drc)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Khronos Group�s glTF (gltf)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Wavefront Obj (obj)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Polygon File Format or Stanford Triangle Format (ply)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Siemens JT File (jt)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Universal3D (u3d)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Universal Scene Description (usd)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Universal Scene Description Archive (usdz)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: The Virtual Reality Modeling Language (vrml)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: DirectX's X file (x)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: GLB file (glb)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Autodesk Maya ASCII (ma)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Autodesk Maya Binary (mb)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

</details>
{{< /tab >}}
{{< /tabs >}}

## Example 2: Get Possible Conversions by File Extension

The following example demonstrates how to retrieve and display possible conversions for the "docx" extension, which corresponds to a Microsoft Word Open XML Document.

{{< tabs "example-2">}}
{{< tab "get_all_possible_conversions_by_file_extension.py" >}}  
```python
from groupdocs.conversion import Converter

def get_all_possible_conversions_by_file_extension():
    # Get all possible conversions
    possible_conversion = Converter.get_possible_conversions_by_extension("docx")

    # Filter primary conversions
    primary_conversions = [conversion.format for conversion in possible_conversion.all if conversion.is_primary]
    # Filter secondary conversions
    secondary_conversions = [conversion.format for conversion in possible_conversion.all if not conversion.is_primary]

    # Print out the source format and it's conversions
    print(f" **Source format**: {possible_conversion.source.description}")
    print(f"  - **Primary conversions**: {primary_conversions}")
    print(f"  - **Secondary conversions**: {secondary_conversions}")
    print()

if __name__ == "__main__":
    get_all_possible_conversions_by_file_extension()
```
{{< /tab >}}
{{< tab "Console Output" >}}  
 **Source format**: Microsoft Word Open XML Document (docx)
 - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
 - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]
{{< /tab >}}
{{< /tabs >}}

## Example 3: Get Possible Conversions for Current File

The following example demonstrates how to retrieve and display possible conversions for a file passed to the `Converter` class constructor.

{{< tabs "example-3">}}
{{< tab "get_all_possible_conversions_for_current_file.py" >}}  
```python
from groupdocs.conversion import Converter

def get_all_possible_conversions_for_current_file():
    with Converter("./cost-analysis.xlsx") as converter:
        # Get possible conversions
        possible_conversion = converter.get_possible_conversions()

        # Filter primary conversions
        primary_conversions = [conversion.format for conversion in possible_conversion.all if conversion.is_primary]
        # Filter secondary conversions
        secondary_conversions = [conversion.format for conversion in possible_conversion.all if not conversion.is_primary]

        # Print out the source format and it's conversions
        print(f" **Source format**: {possible_conversion.source.description}")
        print(f"  - **Primary conversions**: {primary_conversions}")
        print(f"  - **Secondary conversions**: {secondary_conversions}")
        print()

if __name__ == "__main__":
    get_all_possible_conversions_for_current_file()
```
{{< /tab >}}
{{< tab "Console Output" >}}  
**Source format**: Microsoft Excel Open XML Spreadsheet (xlsx)
 - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/get-possible-conversions/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tabs >}}

---

## Get supported file formats

Path: /annotation/java/get-supported-file-formats/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) allows you to get the list of supported file formats. To do this, follow these steps:

1.   Call the [getSupportedFileTypes](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options/filetype/#getSupportedFileTypes--) method of the [FileType](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options/filetype/) class.
2.   Enumerate through the collection of [FileType](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options/filetype/) objects.

The following code snippet shows how to get supported file formats list:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates file types support

// Get list of supported file
List<FileType> fileTypes = FileType.getSupportedFileTypes();
Iterator tmp0 = (fileTypes).iterator();

// Iterating elements and print file types
while (tmp0.hasNext()) {
    FileType fileType = (FileType) tmp0.next();
    System.out.println(fileType.getExtension());
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Get supported file formats

Path: /annotation/net/get-supported-file-formats/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to get the list of supported file formats. To do this, follow these steps:

1.   Call the [GetSupportedFileTypes](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/filetype/methods/getsupportedfiletypes) method of the [FileType](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/filetype) class.
2.   Enumerate through the collection of [FileType](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/filetype) objects.

The following code snippet shows how to get supported file formats list:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
IEnumerable<FileType> supportedFileTypes = FileType
	.GetSupportedFileTypes()
	.OrderBy(f => f.Extension);

foreach (FileType fileType in supportedFileTypes)
	Console.WriteLine(fileType);
```
{{< /tab >}}
{{< /tabs >}}

---

## Get supported file formats

Path: /comparison/java/get-supported-document-formats/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to get the list of all [supported file formats]({{< ref "comparison/java/getting-started/supported-document-formats.md" >}}). To do this, follow these steps:

1. Call the [getSupportedFileTypes](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/filetype/#getSupportedFileTypes--) method of the [FileType](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/filetype/) class.
2. Enumerate through the collection of the [FileType](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/filetype/) objects.

The following code snippet shows how to get list of supported file formats:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.result.FileType;
// ...

Iterable<FileType> fileTypes = FileType.getSupportedFileTypes();
for (FileType fileType : fileTypes) {
    System.out.println(fileType);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/get-supported-formats.png)

---

## Get supported file formats

Path: /comparison/net/get-supported-document-formats/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to get the list of all [supported file formats]({{< ref "comparison/net/getting-started/supported-document-formats.md" >}}). To do this, follow these steps:

1. Call the [GetSupportedFileTypes](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/filetype/methods/getsupportedfiletypes) method of the [FileType](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/filetype) class.
2. Enumerate through the collection of the [FileType](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/filetype) objects.

The following code snippet shows how to get list of supported file formats:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using System;
using System.Collections.Generic;
using System.Linq;
using GroupDocs.Comparison.Result;
// ...

IEnumerable<FileType> supportedFileTypes = FileType
	.GetSupportedFileTypes()
	.OrderBy(f => f.Extension);

foreach (FileType fileType in supportedFileTypes)
	Console.WriteLine(fileType);
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/get-supported-formats.png)

---

## Get supported file formats

Path: /comparison/nodejs-java/get-supported-document-formats/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to get the list of all [supported file formats]({{< ref "comparison/nodejs-java/getting-started/supported-document-formats.md" >}}).

The following code snippet shows how to obtain a list of supported file formats and print them to the console.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Get a collection of all supported file types
const fileTypes = groupdocs.FileType.getSupportedFileTypes();

// Iterate through the collection and print each supported format
let count = 0;
while (fileTypes.size() > count) {
  console.log(fileTypes.get(count).toString());
  count++;
}

// Exit the process when enumeration is complete
process.exit(0);
```

This example:

1. Calls `getSupportedFileTypes` on the `FileType` class to retrieve supported formats.
2. Iterates through the returned collection of `FileType` objects and writes their string representations to the console.

The result is as follows:

![](/comparison/nodejs-java/images/get-supported-formats.png)

---

## Get supported file formats

Path: /comparison/python-net/get-supported-document-formats/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to get the list of all [supported file formats]({{< ref "comparison/python-net/getting-started/supported-document-formats.md" >}}). To do this, follow these steps:

1. Call the `getSupportedFileTypes`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.result/filetype/#getSupportedFileTypes- -)--> method of the `FileType`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.result/filetype/)--> class.
2. Enumerate through the collection of the `FileType`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.result/filetype/)--> objects.

The following code snippet shows how to obtain a list of supported file formats:


```python
import groupdocs.comparison as gc

def run():
    try:
        # Retrieve the supported file types
        supported_file_types = gc.result.FileType.get_supported_file_types()

        for file_type in sorted(supported_file_types, key=lambda x: x.extension):
            print(file_type)

        print("\nSupported file types retrieved successfully.")
        
    except Exception as error:
        print("An error occurred while retrieving supported file types:", error)
```

The result is as follows:

![](/comparison/python-net/images/get-supported-formats.png)

---

## Get supported file formats

Path: /parser/java/get-supported-file-formats/

GroupDocs.Parser allows to get the list of all the supported file formats by the [getSupportedFileTypes](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType#getSupportedFileTypes()) static method:

```java
Iterable<FileType> FileType.getSupportedFileTypes();
```

This method returns a collection of [FileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType) items with the following members:

| Member | Description |
| --- | --- |
| [getFileFormat](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType#getFileFormat()) | File type name e.g. "Microsoft Word Document". |
| [getExtension](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType#getExtension()) | Filename suffix (including the period ".") e.g. ".doc". |

Also [FileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType) contains static fields that represent all the supported file formats.

Here are the steps to get all the supported file formats:

*   Call [getSupportedFileTypes](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType#getSupportedFileTypes()) static method and obtain a collection of [FileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType) objects;
*   Iterate through the collection and call  [getFileFormat](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType#getFileFormat()) or [getExtension](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType#getExtension()) of [FileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FileType).

The following example shows how to print all the supported file types:

```java
// Get a collection of supported file formats
Iterable<FileType> supportedFileTypes = FileType.getSupportedFileTypes();
// Iterate over collection and print file format information
for (FileType fileType : supportedFileTypes) {
    System.out.println(fileType);
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Get supported file formats

Path: /parser/net/get-supported-file-formats/

GroupDocs.Parser allows to get the list of all the supported file formats by the [GetSupportedFileTypes](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype/methods/getsupportedfiletypes) static method:

```csharp
IEnumerable<FileType> FileType.GetSupportedFileTypes();

```

This method returns a collection of [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype) items with the following members:

| Member | Description |
| --- | --- |
| [FileFormat](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype/properties/fileformat) | File type name e.g. "Microsoft Word Document". |
| [Extension](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype/properties/extension) | Filename suffix (including the period ".") e.g. ".doc". |

Also [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype) contains static fields that represent all the supported file formats.

Here are the steps to get all the supported file formats:

*   Call [GetSupportedFileTypes](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype/methods/getsupportedfiletypes) static method and obtain a collection of [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype) objects;
*   Iterate through the collection and get [FileFormat](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype/properties/fileformat) or [Extension](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype/properties/extension) of [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/filetype).

The following example shows how to print all the supported file types:

```csharp
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes();

foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType);
}

```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Get supported file formats

Path: /parser/python-net/get-supported-file-formats/


[GroupDocs.Parser](https://products.groupdocs.com/parser/python-net) allows you to get the list of all [supported file formats]({{< ref "parser/python-net/supported-document-formats.md" >}}). To do this, follow these steps:

1. Call the `get_supported_file_types` method of the `FileType` class
2. Enumerate through the collection of `FileType` objects

The following code snippet shows how to obtain a list of supported file formats:

## Get all supported file formats
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser.options import FileType

# Get all supported file types
supported_file_types = FileType.get_supported_file_types()

# Iterate through the collection
for file_type in sorted(supported_file_types, key=lambda x: x.extension):
    print(f"{file_type.extension} - {file_type.file_format}")

print(f"
Total supported formats: {len(list(supported_file_types))}")
```

{{< /tab >}}
{{< /tabs >}}

## Filter supported formats by category

You can filter supported formats based on your needs:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser.options import FileType

# Get all supported file types
supported_file_types = FileType.get_supported_file_types()

# Define format categories
word_formats = [".doc", ".docx", ".docm", ".dot", ".dotx", ".dotm", ".odt", ".ott", ".rtf"]
excel_formats = [".xls", ".xlsx", ".xlsm", ".xlsb", ".xlt", ".xltx", ".xltm", ".ods"]
pdf_formats = [".pdf"]

print("Word Processing Formats:")
for file_type in supported_file_types:
    if file_type.extension.lower() in word_formats:
        print(f"  {file_type.extension} - {file_type.file_format}")

print("Spreadsheet Formats:")
for file_type in supported_file_types:
    if file_type.extension.lower() in excel_formats:
        print(f"  {file_type.extension} - {file_type.file_format}")

print("PDF Formats:")
for file_type in supported_file_types:
    if file_type.extension.lower() in pdf_formats:
        print(f"  {file_type.extension} - {file_type.file_format}")
```

{{< /tab >}}
{{< /tabs >}}

## Check if a specific format is supported

You can check if a particular file format is supported:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser.options import FileType

def is_format_supported(extension):
    """Check if a file format is supported by GroupDocs.Parser"""
    supported_file_types = FileType.get_supported_file_types()
    
    for file_type in supported_file_types:
        if file_type.extension.lower() == extension.lower():
            return True
    return False

# Check various formats
formats_to_check = [".pdf", ".docx", ".xlsx", ".txt", ".unknown"]

for ext in formats_to_check:
    if is_format_supported(ext):
        print(f"{ext} - Supported")
    else:
        print(f"{ext} - Not Supported")
```

{{< /tab >}}
{{< /tabs >}}

## Get format details

You can retrieve detailed information about each supported format:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser.options import FileType

# Get all supported file types
supported_file_types = FileType.get_supported_file_types()

# Display format details
print("Supported Document Formats:\n")
print(f"{'Extension':<12} {'Format Name':<50}")
print("-" * 62)

for file_type in sorted(supported_file_types, key=lambda x: x.extension):
    print(f"{file_type.extension:<12} {file_type.file_format:<50}")
```

{{< /tab >}}
{{< /tabs >}}

## Practical usage example

Here's a practical example of validating user input:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import FileType
import os

def process_file(file_path):
    """Process a file if its format is supported"""
    
    # Get file extension
    _, ext = os.path.splitext(file_path)
    
    # Check if format is supported
    supported_file_types = FileType.get_supported_file_types()
    is_supported = any(ft.extension.lower() == ext.lower() for ft in supported_file_types)
    
    if not is_supported:
        print(f"Error: File format '{ext}' is not supported")
        return False
    
    try:
        # Process the file
        with Parser(file_path) as parser:
            doc_info = parser.get_document_info()
            print(f"Processing: {file_path}")
            print(f"Format: {doc_info.file_type.file_format}")
            print(f"Pages: {doc_info.page_count}")
            
            # Extract text
            text_reader = parser.get_text()
            if text_reader:
                print("Text extraction successful")
                return True
    except Exception as e:
        print(f"Error processing file: {e}")
        return False

# Example usage
process_file("sample.pdf")
process_file("sample.docx")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/get-supported-file-formats/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/basic-usage/get-supported-file-formats/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about document data extraction features, please refer to the [advanced usage section]({{< ref "parser/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may find more code examples in our GitHub repository:

*   [GroupDocs.Parser for Python via .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET)

### Free online document parser

Along with the full-featured library, we provide a free online document parser app. You are welcome to extract data from PDF, DOCX, XLSX, and more with our [Free Online Document Parser App](https://products.groupdocs.app/parser).


---

## Get supported file formats

Path: /redaction/java/get-supported-file-formats/

### Get supported file formats

GroupDocs.Redaction allows to get the list of all supported file formats by these steps:

*   Call *getSupportedFileTypes *of *FileType* class;
*   Enumerate through the collection of *FileType *objects*.*

The following example demonstrates how to get supported file formats list.



```java
Iterable<FileType> supportedFileTypes = FileType.getSupportedFileTypes();
Iterator iterator = supportedFileTypes.iterator();      
while (iterator.hasNext())
{
    FileType fileType = (FileType)iterator.next();
    System.out.println(fileType);
}
```

---

## Get supported file formats

Path: /redaction/net/get-supported-file-formats/

GroupDocs.Redaction allows to get the list of all supported file formats by these steps:

*   Call [GetSupportedFileTypes](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/filetype/methods/getsupportedfiletypes)of [FileType](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/filetype) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/filetype)objects*.*

The following example demonstrates how to get supported file formats list.

```csharp
IEnumerable<FileType> supportedFileTypes = FileType
	.GetSupportedFileTypes()
	.OrderBy(f => f.Extension);

foreach (FileType fileType in supportedFileTypes)
	Console.WriteLine(fileType);
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Get supported file formats

Path: /redaction/python-net/get-supported-file-formats/

GroupDocs.Redaction allows to get the list of all supported file formats by these steps:

*   Call [GetSupportedFileTypes](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/filetype/get_supported_file_types/) of [FileType](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/filetype/) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/filetype/) objects*.*

The following example demonstrates how to get supported file formats list.

```python
import groupdocs.redaction as gr

def run():

    supported_file_types = gr.FileType.get_supported_file_types()

    for file_type in sorted(supported_file_types, key=lambda x: x.extension):
        print(file_type);
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Get supported file formats

Path: /signature/java/get-supported-file-formats/

With [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) you can get the [list of file formats]({{< ref "signature/java/getting-started/supported-document-formats.md" >}}) that allow adding electronic signatures by following the below steps:

*   Call static function [getSupportedFileTypes](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.documentpreview/FileType#getSupportedFileTypes()) of [FileType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.documentpreview/FileType) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.documentpreview/FileType) objects.

The following code sample demonstrates how to get supported file formats list.

```java
java.util.List<FileType> supportedFileTypes = FileType.getSupportedFileTypes();
for(FileType fileType : supportedFileTypes){
    System.out.print(fileType.getExtension());
}
```

## More resources
### Advanced Usage Topics
To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    
### Free Online App
Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Get supported file formats

Path: /signature/net/get-supported-document-formats/


## Overview

With [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) you can get the [list of file formats]({{< ref "signature/net/getting-started/supported-document-formats.md" >}}) that allow adding electronic signatures by following the below steps:

* Call static function [GetSupportedFileTypes](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/filetype/getsupportedfiletypes) of [FileType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/filetype) class;
* Enumerate through the collection of [FileType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/filetype) objects.

The following code sample demonstrates how to get supported file formats list.

```csharp
IEnumerable<FileType> supportedFileTypes = FileType
    .GetSupportedFileTypes()
    .OrderBy(f => f.Extension);

foreach (FileType fileType in supportedFileTypes)
    Console.WriteLine(fileType);
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Get supported file formats

Path: /signature/nodejs-java/get-supported-document-formats/


## Overview

With [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java), you can retrieve the list of file formats that allow adding electronic signatures by following these steps:

1. Call the static function [GetSupportedFileTypes](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/filetype/getsupportedfiletypes) of the [FileType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/filetype) class.
2. Enumerate through the collection of [FileType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/filetype) objects.

This will give you the supported document formats for adding electronic signatures.
The following code sample demonstrates how to get supported file formats list.

```javascript
    const supportedFileTypes = signatureLib.FileType.getSupportedFileTypes().toArray();

    supportedFileTypes.forEach((fileType) => {
        console.log('\n' + fileType.getExtension());
    });
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Get supported file types

Path: /merger/java/get-supported-file-types/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to get the list of all [supported file types]({{< ref "merger/java/getting-started/supported-document-formats.md" >}}) by following the below steps:
*   Call [getSupportedFileTypes](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain/FileType#getSupportedFileTypes()) method of [FileType](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain/FileType) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain/FileType) objects.

The following code sample demonstrates how to get supported file formats list.

```java
List<FileType> fileTypes = FileType.getSupportedFileTypes();

for(FileType fileType : fileTypes)
{
    System.out.print(fileType.getExtension());
}
```

---

## Get supported file types

Path: /merger/net/get-supported-file-types/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to get the list of all [supported file types]({{< ref "merger/net/getting-started/supported-document-formats.md" >}}) by following the below steps:

*   Call [GetSupportedFileTypes](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain/filetype/getsupportedfiletypes) of [FileType](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain/filetype) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain/filetype) objects.

The following code sample demonstrates how to get supported file formats list.

```csharp
IEnumerable<FileType> supportedFileTypes = FileType
	.GetSupportedFileTypes()
	.OrderBy(f => f.Extension);

foreach (FileType fileType in supportedFileTypes)
	Console.WriteLine(fileType);
```

---

## Get supported file types

Path: /merger/nodejs-java/get-supported-file-types/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to get the list of all [supported file types]({{< ref "merger/nodejs-java/getting-started/supported-document-formats.md" >}}) by following the below steps:
*   Call [getSupportedFileTypes](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain/FileType#getSupportedFileTypes()) method of [FileType](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain/FileType) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain/FileType) objects.

The following code sample demonstrates how to get supported file formats list.

```js
const supportedFileTypes = groupdocs.merger.FileType.getSupportedFileTypes().toArray();
supportedFileTypes.forEach((fileType) => {
    console.log('\n' + fileType.getExtension());
});
```

---

## Get supported file types

Path: /merger/python-net/get-supported-file-types/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to get the list of all [supported file types]({{< ref "merger/python-net/getting-started/supported-document-formats.md" >}}) by following the below steps:
*   Call [getSupportedFileTypes](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain/filetype/getsupportedfiletypes/) method of [FileType](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain/FileType) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain/FileType) objects.

The following code sample demonstrates how to get supported file formats list.

```python
supported_file_types = gm.domain.FileType.get_supported_file_types()
    for supported_file_type in supported_file_types:
        print(f"Property value: {supported_file_type.extension}")
})
```

---

## Getting Document Information

Path: /conversion/java/get-document-info/

[GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/) provides a consistent way to extract metadata from source documents, regardless of how they were loaded—whether from a file, a stream, or cloud storage.

**Getting Basic Document Information**

To retrieve document information, use the `Converter.getDocumentInfo()` method. It returns an [IDocumentInfo](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.contracts.documentinfo/idocumentinfo/) object, which contains general metadata applicable to all supported document formats, including:
- **File format**
- **Creation date**
- **File size**
- **Page count**

Below is an example demonstrating how to get basic information about a document:

{{< tabs "code-example-1">}}
{{< tab "GetDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.IDocumentInfo;

public class GetSourceDocumentInfo {
    public static void convert() {
        try(Converter converter = new Converter("lorem-ipsum.txt")) {

            IDocumentInfo info = converter.getDocumentInfo();
            // Print basic document info
            System.out.println("Format: " + info.getFormat());
            System.out.println("Pages count: " + info.getPagesCount());
            System.out.println("Creation date: " + info.getCreationDate());
            System.out.println("Size, bytes: " + info.getSize());
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}

{{< tab "Expected output" >}}  
```yaml
Format: txt
Pages count: 3
Creation date: Sat Jan 01 02:00:00 EET 1
Size, bytes: 7794
```
{{< /tab >}}
{{< tab "lorem-ipsum.txt" >}}  
{{< tab-text >}}
`lorem-ipsum.txt` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/lorem-ipsum.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Format-Specific Metadata**

Depending on the document type, additional metadata can be extracted. Below are examples of how to retrieve format-specific document information:

## PDF Documents

For PDFs, additional information such as title, author, version, and table of contents can be retrieved:
{{< tabs "code-example-2">}}
{{< tab "GetPdfDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.PdfDocumentInfo;
import com.groupdocs.conversion.contracts.documentinfo.TableOfContentsItem;

public class GetPdfDocumentInfo {
    public static void convert() {
        try (Converter converter = new Converter("sample-with-toc.pdf")) {
            PdfDocumentInfo pdfInfo = (PdfDocumentInfo) converter.getDocumentInfo();
            // Print PDF document info
            System.out.println("Author: " + pdfInfo.getAuthor());
            System.out.println("Creation Date: " + pdfInfo.getCreationDate());
            System.out.println("Title: " + pdfInfo.getTitle());
            System.out.println("Version: " + pdfInfo.getVersion());
            System.out.println("Pages Count: " + pdfInfo.getPagesCount());
            System.out.println("Width: " + pdfInfo.getWidth());
            System.out.println("Height: " + pdfInfo.getHeight());
            System.out.println("Is Landscaped: " + pdfInfo.isLandscape());
            System.out.println("Is Password-Protected: " + pdfInfo.isPasswordProtected());
            System.out.println("Table of contents:");

            for (TableOfContentsItem item : pdfInfo.getTableOfContents()){
                System.out.printf(" Page %s: Title:  %s\n", item.getPage(), item.getTitle());
            }
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: null
Creation Date: Wed Aug 12 16:41:29 EEST 2020
Title: null
Version: 1.7
Pages Count: 5
Width: 612.0
Height: 792.0
Is Landscaped: false
Is Password-Protected: false
Table of contents:
 Page 1: Title:  Page 1 heading!
 Page 2: Title:  Page 2 heading!
 Page 3: Title:  Page 3 heading!
 Page 4: Title:  Page 4 heading!
```
{{< /tab >}}
{{< tab "sample-with-toc.pdf" >}}  
{{< tab-text >}}
`sample-with-toc.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/sample-with-toc.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Word Documents (DOC, DOCX, etc.)

For word documents, you can retrieve the title, author, word count, line count, password protection status:
{{< tabs "code-example-3">}}
{{< tab "GetWordDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.TableOfContentsItem;
import com.groupdocs.conversion.contracts.documentinfo.WordProcessingDocumentInfo;

public class GetWordDocumentInfo {
    public static void convert() {
        try (Converter converter = new Converter("business-plan.doc")) {
            WordProcessingDocumentInfo doc_info = (WordProcessingDocumentInfo) converter.getDocumentInfo();
            // Print DOC document info
            System.out.println("Author: "+ doc_info.getAuthor());
            System.out.println("Creation Date: "+ doc_info.getCreationDate());
            System.out.println("Format: "+ doc_info.getFormat());
            System.out.println("Is Password Protected: "+ doc_info.isPasswordProtected());
            System.out.println("Lines: "+ doc_info.getLines());
            System.out.println("Pages Count: "+ doc_info.getPagesCount());
            System.out.println("Size, bytes: "+ doc_info.getSize());
            System.out.println("Title: "+ doc_info.getTitle());
            System.out.println("Words: "+ doc_info.getWords());
            System.out.println("Table of contents:");

            for(TableOfContentsItem toc_item : doc_info.getTableOfContents()){
                System.out.printf(" Page %s: Title: %s\n", toc_item.getPage(),toc_item.getTitle());
            }
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: GroupDocs
Creation Date: Sun Nov 03 12:05:00 EET 2024
Format: doc
Is Password Protected: false
Lines: 180
Pages Count: 19
Size, bytes: 414208
Title: 
Words: 3789
Table of contents:
 Page 3: Title: INTRODUCTION
 Page 5: Title: 1. EXECUTIVE SUMMARY
 Page 6: Title: 2. COMPANY OVERVIEW
 Page 7: Title: 3. BUSINESS DESCRIPTION
 Page 8: Title: 4. MARKET ANALYSIS
 Page 10: Title: 5. OPERATING PLAN
 Page 11: Title: 6. MARKETING AND SALES PLAN
 Page 12: Title: 7. FINANCIAL PLAN
 Page 16: Title: APPENDIX
 Page 17: Title: Instructions for Getting Started with Estimated Start-Up Costs
 Page 19: Title: Instructions for Getting Started on Profit & Loss Projections
```
{{< /tab >}}
{{< tab "business-plan.doc" >}}  
{{< tab-text >}}
`business-plan.doc` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/business-plan.doc) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Spreadsheets (Excel, CSV, etc.)

For spreadsheet documents, you can retrieve the author, number of worksheets, and password protection status:
{{< tabs "code-example-7">}}
{{< tab "GetSpDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.SpreadsheetDocumentInfo;

public class GetSpDocumentInfo {
    public static void convert() {
        try (Converter converter = new Converter("cost-analysis.xlsx")) {
            SpreadsheetDocumentInfo doc_info = (SpreadsheetDocumentInfo) converter.getDocumentInfo();
            // Print XLSX document info
            System.out.println("Author: "+ doc_info.getAuthor());
            System.out.println("Creation Date: "+ doc_info.getCreationDate());
            System.out.println("Format: "+ doc_info.getFormat());
            System.out.println("Is Password Protected: "+ doc_info.isPasswordProtected());
            System.out.println("Pages Count: "+ doc_info.getPagesCount());
            System.out.println("Size, bytes: "+ doc_info.getSize());
            System.out.println("Title: "+ doc_info.getTitle());
            System.out.println("Worksheets Count: "+ doc_info.getWorksheetsCount());
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: GroupDocs
Creation Date: Thu Feb 23 18:52:46 EET 2023
Format: xlsx
Is Password Protected: false
Pages Count: 0
Size, bytes: 78940
Title: Cost Analysis
Worksheets Count: 1
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Presentation Documents (PPT, PPTX)

For presentation files, you can extract title, author, and encryption status:
{{< tabs "code-example-6">}}
{{< tab "GetPresentationDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.PresentationDocumentInfo;

public class GetPresentationDocumentInfo {
    public static void convert() {
        try (Converter converter = new Converter("presentation-template.pptx")) {
            PresentationDocumentInfo doc_info = (PresentationDocumentInfo) converter.getDocumentInfo();
            // Print PPTX document info
            System.out.println("Author: "+ doc_info.getAuthor());
            System.out.println("Creation Date: "+ doc_info.getCreationDate());
            System.out.println("Format: "+ doc_info.getFormat());
            System.out.println("Is Password Protected: "+ doc_info.isPasswordProtected());
            System.out.println("Pages Count: "+ doc_info.getPagesCount());
            System.out.println("Size, bytes: "+ doc_info.getSize());
            System.out.println("Title: "+ doc_info.getTitle());
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: GroupDocs
Creation Date: Sat Mar 04 14:58:10 EET 2023
Format: pptx
Is Password Protected: false
Pages Count: 3
Size, bytes: 35210
Title: TEST
```
{{< /tab >}}
{{< tab "presentation-template.pptx" >}}  
{{< tab-text >}}
`presentation-template.pptx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/presentation-template.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Image Files (JPG, PNG, TIFF, etc.)

For images, details such as dimensions and bits per pixel can be extracted:
{{< tabs "code-example-5">}}
{{< tab "GetImageDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.ImageDocumentInfo;

public class GetImageDocumentInfo {
    public static void convert() {
        try (Converter converter = new Converter("infographic-elements.tiff")) {
            ImageDocumentInfo doc_info = (ImageDocumentInfo) converter.getDocumentInfo();
            System.out.println("Bits per Pixel: "+ doc_info.getBitsPerPixel());
            System.out.println("Creation Date: "+ doc_info.getCreationDate());
            System.out.println("Format: "+ doc_info.getFormat());
            System.out.println("Height: "+ doc_info.getHeight());
            System.out.println("Width: "+ doc_info.getWidth());
            System.out.println("Size, bytes: "+ doc_info.getSize());
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Bits per Pixel: 32
Creation Date: Sun Feb 09 13:43:01 EET 2025
Format: tiff
Height: 2000
Width: 1500
Size, bytes: 1734560
```
{{< /tab >}}
{{< tab "infographic-elements.tiff" >}}  
{{< tab-text >}}
`infographic-elements.tiff` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/infographic-elements.tiff) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## CAD Drawings (DWG, DXF, etc.)

For CAD drawings, you can extract layout and layer details:
{{< tabs "code-example-8">}}
{{< tab "GetCadDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.CadDocumentInfo;

public class GetCadDocumentInfo {
    public static void convert() {
        try (Converter converter = new Converter("blocks-and-tables.dwg")) {
            CadDocumentInfo doc_info = (CadDocumentInfo) converter.getDocumentInfo();
            // Print DWG document info
            System.out.println("Creation Date: "+ doc_info.getCreationDate());
            System.out.println("Format: "+ doc_info.getFormat());
            System.out.println("Height: "+ doc_info.getHeight());
            System.out.println("Width: "+ doc_info.getWidth());
            System.out.println("Size, bytes: "+ doc_info.getSize());

            System.out.println("Layouts:");
            for(String layout: doc_info.getLayouts()){
                System.out.println(" Layout: "+ layout);
            }

            System.out.println("Layers:");
            for(String layer : doc_info.getLayers()){
                System.out.println(" Layer: "+ layer);
            }
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Creation Date: Sun Feb 09 13:52:09 EET 2025
Format: dwg
Height: 16
Width: 26
Size, bytes: 258848
Layouts:
 Layout: Model
 Layout: ISO A1
Layers:
 Layer: Text
 Layer: Viewports
 Layer: Walls
 Layer: Stairs
 Layer: Deck
 Layer: Cabinetry
 Layer: Schedules
 Layer: Appliances
 Layer: Doors
 Layer: Power
 Layer: Lighting
 Layer: BDRTXT
 Layer: BRDTITLE
 Layer: 0
 Layer: DB - Windows
 Layer: Defpoints
 Layer: Dimensions
```
{{< /tab >}}
{{< tab "blocks-and-tables.dwg" >}}  
{{< tab-text >}}
`blocks-and-tables.dwg` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/blocks-and-tables.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Email Messages (MSG, EML)

For emails, metadata such as encryption status, signature status, and attachments can be retrieved:
{{< tabs "code-example-9">}}
{{< tab "GetEmailDocumentInfo.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.EmailDocumentInfo;

public class GetEmailDocumentInfo {
    public static void convert() {
        try (Converter converter = new Converter("invitation.eml")) {
            EmailDocumentInfo doc_info = (EmailDocumentInfo) converter.getDocumentInfo();
            // Print EML document info
            System.out.println("Creation Date: "+ doc_info.getCreationDate());
            System.out.println("Format: "+ doc_info.getFormat());
            System.out.println("Is Encrypted: "+ doc_info.isEncrypted());
            System.out.println("Is Body in HTML: "+ doc_info.isHtml());
            System.out.println("Is Signed: "+ doc_info.isSigned());
            System.out.println("Size: "+ doc_info.getSize());
            System.out.println("Attachments Count: "+ doc_info.getAttachmentsCount());

            for(String attachment_name : doc_info.getAttachmentsNames()){
                System.out.println("Attachment Name: "+ attachment_name);
            }
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Creation Date: Tue Apr 25 14:28:29 EEST 2017
Format: eml
Is Encrypted: false
Is Body in HTML: true
Is Signed: false
Size: 91948
Attachments Count: 0
```
{{< /tab >}}
{{< tab "invitation.eml" >}}  
{{< tab-text >}}
`invitation.eml` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/get-document-info/invitation.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Conclusion

GroupDocs.Conversion provides a powerful way to extract essential metadata from various document formats. This allows users to analyze, filter, and manage document properties efficiently. For more advanced use cases, refer to the official [GroupDocs.Conversion API documentation](https://reference.groupdocs.com/conversion/java/).

---

## Getting Possible Conversions

Path: /conversion/java/get-possible-conversions/


[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) supports a wide range of target formats for document conversion. While you can refer to the [supported file formats]({{< ref "conversion/java/supported-document-formats.md" >}}) documentation, the API also provides ways to programmatically retrieve possible conversions. This feature is useful for dynamically presenting conversion options to end-users or for system integrations.

## Get Possible Conversions for a Specific Document

To determine the possible conversion formats for a specific source document, follow these steps:

- **Initialize the Converter**: Create an instance of the `Converter` class by passing the source document path to its constructor.
- **Retrieve Conversions**: Call the `getPossibleConversions` method of the Converter object.
- **Process Results**: The method returns a `PossibleConversions` collection containing all the target formats supported for the given source document.

**Example Code**:

{{< tabs "code-example">}}
{{< tab "SpecificDocumentConversions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.PossibleConversions;
import com.groupdocs.conversion.contracts.TargetConversion;
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.StreamSupport;

public class SpecificDocumentConversions {
    public static void convert() {
        String sourceFile = "cost-analysis.xlsx";
        // Initialize the converter with the source document
        try(Converter converter = new Converter(sourceFile)){
            // Get possible conversions for the document
            PossibleConversions conversions = converter.getPossibleConversions();

            // Filter primary conversions
            List<String> primaryConversions = StreamSupport.stream(conversions.getAll().spliterator(), false)
                    .filter(TargetConversion::isPrimary)
                    .map(conversion -> conversion.getFormat().getExtension())
                    .collect(Collectors.toList());

            // Filter secondary conversions
            List<String> secondaryConversions = StreamSupport.stream(conversions.getAll().spliterator(), false)
                    .filter(conversion -> !conversion.isPrimary())
                    .map(conversion -> conversion.getFormat().getExtension())
                    .collect(Collectors.toList());

            // Print out the source format and its conversions
            System.out.println(" **Source format**: " + conversions.getSource().getDescription());
            System.out.println("  - **Primary conversions**: " + primaryConversions);
            System.out.println("  - **Secondary conversions**: " + secondaryConversions);

        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Console Output" >}}  
{{< tab-text >}}
 **Source format**: Microsoft Excel Open XML Spreadsheet (xlsx)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, emz, wmz, svgz, tga, psb, ppt, pps, pptx, ppsx, odp, otp, potx, potm, pptm, ppsm, fodp, svg, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md, ml]
{{< /tab-text >}}
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/get-possible-conversions/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get All Available Conversions

If you need to retrieve all supported conversions across different document types, you can do this by calling the `getAllPossibleConversions` method of the `Converter` class.

- **Initialize the Converter**: Create an instance of the `Converter` class without specifying a source document.
- **Retrieve All Conversions**: Call the `getAllPossibleConversions` method.
- **Process Results**: Iterate through the returned `PossibleConversions` collection to explore all source and target format combinations.

{{< tabs "code-example1">}}
{{< tab "AllAvailableConversions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.PossibleConversions;
import com.groupdocs.conversion.contracts.TargetConversion;
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.StreamSupport;

public class AllAvailableConversions {
    public static void convert() {
 // Get all possible conversions
        List<PossibleConversions> allPossibleConversions = Converter.getAllPossibleConversions();

        for (PossibleConversions possibleConversions : allPossibleConversions) {
            // Filter primary conversions
            List<String> primaryConversions = StreamSupport.stream(possibleConversions.getAll().spliterator(), false)
                    .filter(TargetConversion::isPrimary)
                    .map(conversion -> conversion.getFormat().getExtension())
                    .collect(Collectors.toList());

            // Filter secondary conversions
            List<String> secondaryConversions = StreamSupport.stream(possibleConversions.getAll().spliterator(),false)
                    .filter(conversion -> !conversion.isPrimary())
                    .map(conversion -> conversion.getFormat().getExtension())
                    .collect(Collectors.toList());

            // Print out the source format and its conversions
            System.out.println(" **Source format** : " + possibleConversions.getSource().getDescription());
            System.out.println("  - **Primary conversions**: " + primaryConversions);
            System.out.println("  - **Secondary conversions**: " + secondaryConversions);
            System.out.println();
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Console Output" >}}  
 **Source format**: Drawing Exchange Format File (dxf)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: AutoCAD Drawing Database File (dwg)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: MicroStation Design File (dgn)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

<details>
<summary>See Complete List</summary>

**Source format**: Design Web Format File (dwf)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Stereolithography File (stl)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Industry Foundation Classes File (ifc)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Initial Graphics Exchange Specification (IGES) (igs)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: AutoCAD Drawing Template (dwt)
  - **Primary conversions**: [dxf, dwf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Design Web Format File (dwfx)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Common File Format File (cf2)
  - **Primary conversions**: [dxf, ifc, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: ZIP Compressed File (zip)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: RAR Compressed Archive (rar)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: 7-Zip Compressed File (7z)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Consolidated Unix File Archive (tar)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Gnu Zipped Archive (gz)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Gzip Compressed File (gzip)
  - **Primary conversions**: [zip, 7z, tar, gz, gzip, bz2, lz, z, xz, cpio, lzma, zst, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Bzip2 Compressed File (bz2)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Lzip Compressed File (lz)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Unix Compressed File (z)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Xz Compressed File (xz)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: CPIO Compressed File (cpio)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Windows Cabinet File (cab)
  - **Primary conversions**: [zip, 7z, tar, gz, gzip, bz2, lz, z, xz, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: LZMA Compressed File (lzma)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Zstandard (Zstd) Compressed File (zst)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: ISO File Format (iso)
  - **Primary conversions**: [zip, 7z, tar, cpio, iso, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Uuencoded archive (uue)
  - **Primary conversions**: [gz, gzip, bz2, lz, z, xz, lzma, zst, uue, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: []

 **Source format**: Visio Drawing File (vsd)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing File (vsdx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Stencil File (vss)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing Template (vst)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Stencil XML File (vsx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Template XML File (vtx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Web Drawing (vdw)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing XML File (vdx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Stencil File (vssx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Drawing Template (vstx)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Macro-Enabled Drawing (vsdm)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Macro-Enabled Stencil File (vssm)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Visio Macro-Enabled Drawing Template (vstm)
  - **Primary conversions**: [vsd, vsdx, vsx, vtx, vdx, vssx, vstx, vsdm, vssm, vstm, epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PLT (HPGL) (plt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, fbx, 3ds, obj, u3d, glb, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Open eBook File (epub)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Mobipocket eBook (mobi)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Amazon Kindle�s proprietary e-book file format (azw3)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Outlook Mail Message (msg)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: E-Mail Message (eml)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Apple Mail Message (emlx)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Vcf document format (vcf)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Mbox document format (mbox)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: JSON based Geographic File Format (geojson)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Geography Markup Language File Format (gml)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Keyhole Markup Language (kml)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: GPS Exchange File Format (gpx)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JSON based Topology File Format (topojson)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenStreetMap File Format (osm)
  - **Primary conversions**: [geojson, kml, gpx, topojson, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Tagged Image File Format (tiff)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Tagged Image File Format (tif)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG Image (jpg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG Image (jpeg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Portable Network Graphic (png)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Graphical Interchange Format File (gif)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Bitmap Image File (bmp)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Icon File (ico)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Adobe Photoshop Document (psd)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Windows Metafile (wmf)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Enhanced Windows Metafile (emf)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: DICOM Image (dcm)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: DICOM Image (dicom)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: WebP Image (webp)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Digital Negative Specification (dng)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Core Image File (jp2)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Graphic File (odg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Code Stream (j2c)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Code Stream (j2k)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Image File (jpx)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Image File (jpf)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Image File (jpm)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: CorelDraw Vector Graphic Drawing (cdr)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Corel Metafile Exchange (cmx)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Device Independent Bitmap File (dib)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG 2000 Code Stream (jpc)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: DjVu Image (djvu)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Graphic Template (otg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Adobe Illustrator Artwork (ai)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Windows Compressed Enhanced Metafile (emz)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Compressed Windows Metafile (wmz)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Compressed Scalable Vector Graphics File (svgz)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Truevision TGA (TARGA) (tga)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Adobe Photoshop Big (psb)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Flat XML ODF Template (fodg)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: JPEG File Interchange Format (jfif)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: HEIC File Format (heic)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OneNote Document (one)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Scalable Vector Graphics File (svg)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Encapsulated PostScript File (eps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Computer Graphics Metafile (cgm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]
  - **Secondary conversions**: [eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: XML Paper Specification File (xps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: LaTeX Source Document (tex)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PostScript File (ps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Printer Command Language Document (pcl)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: XML Paper Specification File (oxps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Portable Document Format File (pdf)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Presentation (ppt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Slide Show (pps)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Presentation (pptx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Slide Show (ppsx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Flat XML Presentation (odp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Presentation Template (otp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Presentation Template (potx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Template (pot)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Macro-Enabled Presentation Template (potm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Macro-Enabled Presentation (pptm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: PowerPoint Open XML Macro-Enabled Slide (ppsm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Flat XML Presentation (fodp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Project Template (mpt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Project File (mpp)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Project Exchange File (mpx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Primavera XER format (xer)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, mpp, mpx, xer, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Outlook Personal Information Store File (pst)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Outlook Offline Data File (ost)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Lotus Notes Storage Format (nsf)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Outlook file for Mac Operating System. (olm)
  - **Primary conversions**: [epub, mobi, azw3, eml, emlx, msg, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Excel Spreadsheet (xls)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Open XML Spreadsheet (xlsx)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Excel Open XML Macro-Enabled Spreadsheet (xlsm)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Excel Binary Spreadsheet (xlsb)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Spreadsheet (ods)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Spreadsheet Template (ots)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Excel Open XML Spreadsheet Template (xltx)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Macro-Enabled Template (xlt)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Macro-Enabled Template (xltm)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Tab Separated Values File (tsv)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Microsoft Excel Add-in (xlam)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Csv document format (csv)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: OpenDocument Flat XML Spreadsheet (fods)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: StarOffice Calc Spreadsheet (sxc)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: Apple iWork Numbers (numbers)
  - **Primary conversions**: [epub, mobi, azw3, eps, xps, tex, ps, pcl, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, htm, html, mhtml, mht, json, xml]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]

 **Source format**: CHM File (chm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Hypertext Markup Language File (htm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Hypertext Markup Language File (html)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: MIME HTML File (mhtml)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: MHTML Web Archive (mht)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Word Document (doc)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Open XML Macro-Enabled Document (docm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Word Open XML Document (docx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Document Template (dot)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Open XML Macro-Enabled Document Template (dotm)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Word Open XML Document Template (dotx)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Rich Text Format File (rtf)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Text Document (odt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: OpenDocument Document Template (ott)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Plain Text File (txt)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Markdown Documentation File (md)
  - **Primary conversions**: [epub, mobi, azw3, tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: XML File (xml)
  - **Primary conversions**: [epub, mobi, azw3, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, json, xml, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]

 **Source format**: Json File (json)
  - **Primary conversions**: [epub, mobi, azw3, pdf, xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc, json, xml, htm, html, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp]

 **Source format**: Extensible Business Reporting Language. (xbrl)
  - **Primary conversions**: [xbrl, ixbrl]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Inline XBRL. (ixbrl)
  - **Primary conversions**: [xbrl, ixbrl]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: TrueType Font (Ttf)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Embedded OpenType Font Format (eot)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: OpenType font (otf)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Compact Font Format (cff)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: PostScript Fonts (pfb)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Web Open Font Format (woff)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Web Open Font Format 2 (woff2)
  - **Primary conversions**: [Ttf, woff, woff2]
  - **Secondary conversions**: []

 **Source format**: Log File (log)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Sql File (sql)
  - **Primary conversions**: [tiff, tif, jpg, jpeg, png, gif, bmp, ico, psd, wmf, emf, dcm, dicom, webp, jp2, j2k, emz, wmz, svgz, tga, psb, jfif, eps, xps, tex, ps, pcl, svg, pdf, ppt, pps, pptx, ppsx, odp, otp, potx, pot, potm, pptm, ppsm, fodp, htm, html, mhtml, mht, doc, docm, docx, dot, dotm, dotx, rtf, odt, ott, txt, md]
  - **Secondary conversions**: [xls, xlsx, xlsm, xlsb, ods, xltx, xlt, xltm, tsv, xlam, csv, fods, dif, sxc]

 **Source format**: Microsoft Publisher format (pub)
  - **Primary conversions**: [pdf]
  - **Secondary conversions**: []

 **Source format**: FilmBox format (fbx)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: 3D Studio (3ds)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Microsoft 3D Manufacturing Format (3mf)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Additive manufacturing file format (amf)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: 3D Studio Max�s ASCII Scene Exporter format (ase)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: AVEVA Plant Design Management System Model (rvm)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Collada (dae)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Google Draco (drc)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Khronos Group�s glTF (gltf)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Wavefront Obj (obj)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Polygon File Format or Stanford Triangle Format (ply)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Siemens JT File (jt)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Universal3D (u3d)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Universal Scene Description (usd)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Universal Scene Description Archive (usdz)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: The Virtual Reality Modeling Language (vrml)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: DirectX's X file (x)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: GLB file (glb)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Autodesk Maya ASCII (ma)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

 **Source format**: Autodesk Maya Binary (mb)
  - **Primary conversions**: [pdf, fbx, 3ds, amf, rvm, dae, drc, gltf, obj, ply, u3d, usd, usdz, glb]
  - **Secondary conversions**: []

</details>
{{< /tab >}}
{{< /tabs >}}

By utilizing these API features, you can provide dynamic, user-friendly document conversion capabilities tailored to your application's needs.
---

## GroupDocs Watermark Overview

Path: /watermark/java/groupdocs-watermark-overview/


**GroupDocs.Watermark for Java** is a powerful API that helps you **add**, **search**, and **remove watermarks** from documents, images, presentations, and more. Whether you need to **protect documents with watermarks**, **customize watermark content**, or **automate watermarking at scale**, this library gives you everything you need.

---

## What You Can Do

With GroupDocs.Watermark for Java, you can:

- **Add watermark to document** – Add image or text watermarks to PDF, Word, Excel, PowerPoint, Visio, and many other formats.
- **Customize watermark** – Choose your own text, fonts, size, transparency, rotation, or position.
- **Use invisible watermarking for documents** – Protect content without affecting how it looks.
- **Remove watermark from document** – Detect and delete unwanted watermarks using smart search.
- **Put watermark on document** for branding, copyright, or confidentiality.
- **Print with watermark** for internal or public sharing.
- **Automate watermarking** across multiple files and folders in your system.
- **Use watermark examples** provided to help you get started quickly.

---

## Supported File Formats

You can **add watermarks to** and **remove watermarks from**:

- Word files (DOC, DOCX)
- PDF files
- Excel spreadsheets (XLS, XLSX)
- PowerPoint presentations (PPT, PPTX)
- Visio diagrams
- Images (JPG, PNG, BMP, GIF)
- OpenDocument formats (ODT, ODS, ODP)
- Email formats (EML, MSG)

...and many others. See full list of supported [formats]({{< ref "/watermark/java/getting-started/supported-document-formats.md" >}})

---

## Why Use Watermarks?

Watermarks help with:

- **Document security**
- **Content protection with watermarking**
- **Copyright protection**
- **Brand identity**
- **Confidential information labeling**
- **Audit trails and verification**

---

## Smart Watermarking Features

- **How to add watermark in document** – Choose between text or image watermarks.
- **How to put watermark in** Word, PDF, Excel, PowerPoint, and more.
- **How to remove watermark from a document** using advanced detection logic.
- **Watermark automation for enterprise** with batch processing and flexible APIs.
- **Customize watermark appearance** with fonts, size, opacity, and layout.
- **Invisible watermarking** to track document usage or detect tampering.

---

## 📦 Integration & Deployment

GroupDocs.Watermark for Java is:

- Easy to integrate into any Java application (desktop, web, or server).
- Compatible with Windows, Linux, and macOS.
- Available as a **standalone watermark solution** – no need for Microsoft Office or Adobe Acrobat.
- Licensed for commercial use, with a free trial available.

---

## 🚀 Get Started

Want to learn **how to add a watermark to** your document? Need to **remove watermark** from an existing file?

Start with our easy-to-follow [examples]({{< ref "/watermark/java/getting-started/how-to-run.md" >}}) and guides.


Or explore how to:

- **Add watermark to slides**
- **Add image watermark**
- **Add text to document**
- **Delete watermark from** PDF or Word
- **Remove watermark in spreadsheet**
- **Watermark online**
- **Create watermark** with custom settings
- **Use watermark** in batch jobs

---

## 💡 Use Cases

- **Add “Confidential” watermark** to protect sensitive files
- **Remove watermark** from templates before publishing
- **Put watermark on document** to brand it with your logo or company name
- **Add watermark online** in cloud-based apps or services
- **Generate documents** with pre-applied watermarks
- **Customize watermark** per department or user

---

## Try It Free

Try **GroupDocs watermark** features now:

- [Download Free Trial](https://releases.groupdocs.com/watermark/java/)
- [Explore Online Demos](https://products.groupdocs.app/watermark)

---

GroupDocs.Watermark for Java is your all-in-one **document watermarking solution**. Whether you're working with **word files**, PDFs, spreadsheets, or slides — you can **add**, **customize**, or **remove watermarks** effortlessly and securely.

---

**Need help?**  
Visit our [Support Forum](https://forum.groupdocs.com/c/watermark/)


---

## GroupDocs.Comparison Overview

Path: /comparison/java/groupdocs-comparison-overview/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) – API for comparing and merging two or more files in applications on the Java platform. The compiled file shows line-by-line differences in content, paragraphs, characters, styles, shapes and positions.

The API provides the following features:

- GroupDocs.Comparison supports 100+ file formats without any additional software
- Wide range of options to customize the comparison process
- Information extraction – file type, page count, etc.
- Handful differences categorization and highlight
- Content structure, styling and formatting changes detection
- Ability to apply or reject detected changes and save result document 

You can use GroupDocs.Comparison across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 5 and higher

---

## GroupDocs.Comparison Overview

Path: /comparison/net/groupdocs-comparison-overview/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) is a powerful cross-platform library that allows you to implement in your applications the ability to compare and merge two or more files of [the various formats]({{< ref "comparison/net/getting-started/supported-document-formats.md" >}}). The compiled file shows line-by-line differences in content, paragraphs, characters, styles, shapes, and positions.

The API provides the following features:

- A wide range of options to customize the comparison process;
- Information extraction - file type, number of pages, etc.;
- Classification of several differences and their allocation;
- Detection of changes in content structure, style, and formatting;
- Ability to apply or reject the detected changes and save the output documents.

---

## GroupDocs.Metadata Overview

Path: /metadata/java/product-overview/

## What is GroupDocs.Metadata?

GroupDocs.Metadata for Java is a full featured class library which allows users to read and edit metadata associated with various document, image, audio, video and many other formats. It works with most notable metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3 and format-specific metadata properties. The Metadata API is very flexible and easy to operate with. It provides extended capabilities allowing working with metadata in a unified way regardless of the file format. 

## Why use GroupDocs.Metadata?

*   Work with most popular metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3, document properties, etc
*   Manage audio metadata: ID3 tag (ID3v1, ID3v2), Lyrics3 tag, APE
*   Create, modify and remove metadata associated with supported formats with a few lines of code
*   Identify built-in, custom and hidden metadata
*   Work with password-protected documents
*   Render image previews for supported formats to easily create UI for you application
*   Detect the format and MIME type of a loaded file by its internal structure
*   Use predefined tags to manipulate metadata properties in a unified way across all supported formats
*   Detect and remove digital signatures associated with a loaded file
*   Inspect office documents to extract user comments, form fields, hidden pages, etc
*   Work with a variety of document, image, video and audio formats
*   Manage metadata in e-books, torrent files, archives, electronic business cards, saved emails, etc

## Get started with GroupDocs.Metadata for Java

If you are new to GroupDocs.Metadata, see the following topics first:

* [System requirements](/metadata/java/system-requirements/)
* [Installation (build tools)](/metadata/java/installation/)
* [Installation (manual)](/metadata/java/installation-manual/)
* [Licensing](/metadata/java/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Metadata or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/metadata/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).
---

## GroupDocs.Metadata Overview

Path: /metadata/net/product-overview/

## What is Metadata?
The metadata is a data which shows information about other data. It should not be considered as the content of the data. Various types of metadata are existed such as: descriptive, structural, administrative, reference, statistical and legal metadata     

## What is GroupDocs.Metadata?

GroupDocs.Metadata for .NET is a full featured class library which allows users to read and edit metadata associated with various document, image, audio, video and many other formats. It works with most notable metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3 and format-specific metadata properties. The Metadata API is very flexible and easy to operate with. It provides extended capabilities allowing working with metadata in a unified way regardless of the file format. 

## Why use GroupDocs.Metadata?

*   Work with most popular metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3, document properties, etc
*   Manage audio metadata: ID3 tag (ID3v1, ID3v2), Lyrics3 tag, APE      
*   Create, modify and remove metadata associated with supported formats with a few lines of code
*   Identify built-in, custom and hidden metadata
*   Work with password-protected documents
*   Render image previews for supported formats to easily create UI for you application
*   Detect the format and MIME type of a loaded file by its internal structure
*   Use predefined tags to manipulate metadata properties in a unified way across all supported formats
*   Detect and remove digital signatures associated with a loaded file
*   Inspect office documents to extract user comments, form fields, hidden pages, etc
*   Work with a variety of document, image, video and audio formats
*   Manage metadata in e-books, torrent files, archives, electronic business cards, saved emails, etc

---

## GroupDocs.Redaction Overview

Path: /redaction/java/groupdocs-redaction-overview/

## What is redaction?

Lets try to know about what is redaction or what does redacted mean. The redaction is the editing a document for the purpose to remove or hide the confidential or sensitive information.

## What Is GroupDocs.Redaction?

GroupDocs.Redaction is a powerful [sanitization](https://en.wikipedia.org/wiki/Sanitization_(classified_information)) API that allows to remove or mask classified information from over 30 document types. The main purpose of GroupDocs.Redaction product is an ability to optionally save redacted documents in PDF, transforming all pages into raster images or save redacted document in its original format for further editing.

GroupDocs.Redaction provides a single format-independent interface for removing sensitive and classified information from the documents, including the document's metadata and annotations.

## Why Use GroupDocs.Redaction as a Developer?

*   No additional software is required to remove sensitive information;
    
*   An ability to set page range rendering document as PDF;
    
*   Easy way to redact different types of data: text, metadata, annotations and comments;
    
*   Document information extraction - file type, page count etc.;
    
*   An extensible architecture, allowing user to add custom document formats and types of redactions.

---

## GroupDocs.Redaction Overview

Path: /redaction/net/groupdocs-redaction-overview/

## What is redaction?

Lets try to know about what is redaction or what does redacted mean. The redaction is the editing a document for the purpose to remove or hide the confidential or sensitive information.


## What is GroupDocs.Redaction?

GroupDocs.Redaction is a fast, powerful and high quality document redaction tool, providing [sanitization](https://en.wikipedia.org/wiki/Sanitization_(classified_information)) API for .NET (C#, VB, etc) which allows you to redact PDF, Microsoft Word, Excel, PowerPoint and image files, remove the classified information from over 30 document types. The API provides flexible and fully customizable document redaction options with an ability to optionally save all types of redacted documents as PDF, transforming all pages into raster images or save the redacted document in its original format for further editing.  

GroupDocs.Redaction provides a single format-independent interface to clear EXIF metadata in image, delete comments in Word or Excel, redact PDF documents text, metadata and comments.

Our document redaction software is simple, intuitive and complete. With only a few lines of code you can redact text, comments and metadata without installing any additional software and at the same time configure redaction options to fulfill your needs.

Black out text in PDF, Word, Excel, PowerPoint and image files and many more with GroupDocs.Redaction for .NET. 

## Why Use GroupDocs.Redaction?

*   Over 30 formats supported;
*   No additional software installation is required;
*   Great variety of redaction options;
*   Customizable document redaction tool;
*   An ability to set page range for rendering document as PDF;
    
*   Easy way to redact different types of data: text, metadata, annotations and comments;
    
*   An extensible architecture, allowing user to add custom document formats and types of redactions;
*   Document information;
*   Online support.

---

## GroupDocs.Redaction Overview

Path: /redaction/python-net/groupdocs-redaction-overview/

## What is Redaction?

Redaction is the process of editing a document to remove or obscure confidential or sensitive information before its public release or distribution.


## What is GroupDocs.Redaction?

GroupDocs.Redaction for Python via .NET is a robust and high-performance document redaction API that enables developers to remove sensitive content from various file formats, including PDF, Microsoft Word, Excel, PowerPoint, and image files. The API supports redacting classified information from over 50 different document types.

This library provides highly customizable redaction options, allowing you to save redacted documents in their original format for further editing or convert them into sanitized PDF documents with all pages rendered as raster images.

GroupDocs.Redaction for Python via .NET offers a unified interface to clear EXIF metadata from images, delete comments from Word or Excel files, and redact text, metadata, and annotations from PDF documents.

The API is simple, intuitive, and comprehensive. With just a few lines of Python code, you can redact text, comments, and metadata seamlessly, without the need for any additional software. Its flexible architecture allows for highly configurable redaction operations tailored to your specific requirements.

Use GroupDocs.Redaction for Python via .NET to mask sensitive information in PDF, Word, Excel, PowerPoint, image files, and many more.

## Why Use GroupDocs.Redaction?

*   Supports over 50 file formats.
*   No need for third-party software installations.
*   Comprehensive redaction options for various content types.
*   Fully customizable and adaptable redaction workflow.
*   Capability to specify page ranges for rendering as PDF.
*   Redaction support for text, metadata, annotations, and comments.
*   Extensible architecture for adding custom formats and redaction types.
*   Built-in document inspection features.
*   Complete online support and documentation.

---

## GroupDocs.Search Overview

Path: /search/java/groupdocs-search-overview/

## What Is GroupDocs.Search?

GroupDocs.Search is a powerful [full-text search](https://en.wikipedia.org/wiki/Full-text_search) API that allows you to search through over 70 document formats in your applications. To make it possible to search instantly across thousands of documents, they must be added to the index.

## Why Use GroupDocs.Search as a Developer?

*   No additional software is required to search through documents of supported formats.
*   Great variety of indexing and search options are provided to meet any requirements.
*   Wide selection of search types is available in text or object form queries.
*   High indexing and search performance is achieved by unique algorithms and data structures, optimizations and multi-threaded execution.
*   Various ways of visualizing search results in the text of documents are supported.

---

## GroupDocs.Search Overview

Path: /search/net/groupdocs-search-overview/

## What Is GroupDocs.Search?

GroupDocs.Search is a powerful [full-text search](https://en.wikipedia.org/wiki/Full-text_search) API that allows you to search through over 70 document formats in your applications. To make it possible to search instantly across thousands of documents, they must be added to the index.

## Why Use GroupDocs.Search as a Developer?

* No additional software is required to search through documents of supported formats.
* Great variety of indexing and search options are provided to meet any requirements.
* Wide selection of search types is available in text or object form queries.
* High indexing and search performance is achieved by unique algorithms and data structures, optimizations and multi-threaded execution.
* Various ways of visualizing search results in the text of documents are supported.

---

## GroupDocs.Search Overview

Path: /search/nodejs-java/groupdocs-search-overview/

## What Is GroupDocs.Search?

GroupDocs.Search is a powerful [full-text search](https://en.wikipedia.org/wiki/Full-text_search) API that allows you to search through over 70 document formats in your applications. To make it possible to search instantly across thousands of documents, they must be added to the index.

## Why Use GroupDocs.Search as a Developer?

*   No additional software is required to search through documents of supported formats.
*   Great variety of indexing and search options are provided to meet any requirements.
*   Wide selection of search types is available in text or object form queries.
*   High indexing and search performance is achieved by unique algorithms and data structures, optimizations and multi-threaded execution.
*   Various ways of visualizing search results in the text of documents are supported.

---

## Handling incorrect document password exception

Path: /signature/java/handling-incorrect-document-password-exception/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports handling incorrect password passed to open protected documents over class [IncorrectPasswordException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/IncorrectPasswordException).

Here are the steps to handle incorrect password exception when working with protected documents with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.
    
*   Cover the code that works with [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object methods ([sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)), [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)), [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)), [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)), [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))) with try - catch block including catching [IncorrectPasswordException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/IncorrectPasswordException) exception. 

## Handling incorrect password exception

Following example demonstrates how to handle incorrect password exception.

```java
// initialize LoadOptions with incorrect Password
LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("1");
Signature signature = new Signature("ProtectedPwd.pdf", loadOptions);
 
try
{
    QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
    options.setEncodeType(QrCodeTypes.QR);
    options.setLeft(100);
    options.setTop(100);
    // try to sign document to file, we expect for PasswordRequiredException
    signature.sign(outputFilePath, options);
    System.out.print("\nSource document signed successfully.\nFile saved at " + outputFilePath);
}
catch (IncorrectPasswordException ex)
{
    System.out.print("HandlingIncorrectPasswordException: " + ex.getMessage());
}
catch (GroupDocsSignatureException ex)
{
    System.out.print("Common GroupDocsSignatureException: " + ex.getMessage());
}
catch (java.lang.RuntimeException ex)
{
    System.out.print("Common Exception happens only at user code level: " + ex.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Handling incorrect document password exception

Path: /signature/net/handling-incorrect-document-password-exception/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports handling incorrect password passed to open protected documents over class [IncorrectPasswordException](https://reference.groupdocs.com/signature/net/groupdocs.signature/incorrectpasswordexception).

Here are the steps to handle incorrect password exception when working with protected documents with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Cover the code that works with [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object methods ([Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/#sign_4), [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify), [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search), [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update), [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete)) with try - catch block including catching [IncorrectPasswordException](https://reference.groupdocs.com/signature/net/groupdocs.signature/incorrectpasswordexception) exception.

## Handling incorrect password exception

Following example demonstrates how to handle incorrect password exception.

```csharp
// initialize LoadOptions with incorrect Password
LoadOptions loadOptions = new LoadOptions() { Password = "1" };
using (Signature signature = new Signature("ProtectedPwd.pdf", loadOptions))
{
    try
    {
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
        {
            EncodeType = QrCodeTypes.QR,
            Left = 100,
            Top = 100
        };
        // try to sign document to file, we expect for PasswordRequiredException
        signature.Sign(outputFilePath, options);
        Console.WriteLine("\nSource document signed successfully.\nFile saved at " + outputFilePath);
    }
    catch (IncorrectPasswordException ex)
    {
        Console.WriteLine($"HandlingIncorrectPasswordException: {ex.Message}");
    }
    catch (GroupDocsSignatureException ex)
    {
        Console.WriteLine($"Common GroupDocsSignatureException: {ex.Message}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Common Exception happens only at user code level: {ex.Message}");
    }
    finally
    {
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Handling the ID3v1 tag

Path: /metadata/java/handling-the-id3v1-tag/

## What is ID3v1?

ID3v1 is a metadata tag that is usually used with MP3 audio files. The whole tag occupies 128 bytes and allows adding metadata properties such as title, artist, album, track number, etc.The ID3v1 standard was introduced in 1996 but it's still widely supported by various audio players and decoders. To get more information about ID3v1 tags please visit [http://id3.org/ID3v1](http://id3.org/ID3v1).

## Reading an ID3v1 tag

The following steps show how to read the ID3v1 tag in an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the ID3v1 tag by using the [Mp3RootPackage.getID3V1](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getID3V1()) method
4.  If the ID3v1 tag is not null then check for all of its metadata properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3ReadID3V1Tag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithID3V1)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	if (root.getID3V1() != null) {

		System.out.println(root.getID3V1().getAlbum());
		System.out.println(root.getID3V1().getArtist());
		System.out.println(root.getID3V1().getTitle());
		System.out.println(root.getID3V1().getVersion());
		System.out.println(root.getID3V1().getComment());

		// ...
	}
}
```

## Updating an ID3v1 tag

The following are the steps to update the ID3v1 tag in an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Create the ID3v1 tag if it's missing
4.  Update ID3v1 fields using the [Mp3RootPackage.getID3V1](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getID3V1()) method
5.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

The following code snippet shows how to update the ID3v1 tag in an MP3 file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3UpdateID3V1Tag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithID3V1)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	if (root.getID3V1() == null) {
		root.setID3V1(new ID3V1Tag());
	}

	root.getID3V1().setAlbum("test album");
	root.getID3V1().setArtist("test artist");
	root.getID3V1().setTitle("test title");
	root.getID3V1().setComment("test comment");
	root.getID3V1().setYear("2019");

	// ...

	metadata.save(Constants.OutputMp3);
}
```

## Removing an ID3v1 tag

To remove the ID3v1 tag from an MP3 audio just pass null to the [Mp3RootPackage.setID3V1](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#setID3V1(com.groupdocs.metadata.core.ID3V1Tag)) method as a parameter. The code sample below shows how to remove the ID3v1 tag from an MP3 file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3RemoveID3V1Tag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithID3V1)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	root.setID3V1(null);
	metadata.save(Constants.OutputMp3);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Handling the ID3v1 tag

Path: /metadata/net/handling-the-id3v1-tag/

## What is ID3v1?

ID3v1 is a metadata tag that is usually used with MP3 audio files. The whole tag occupies 128 bytes and allows adding metadata properties such as title, artist, album, track number, etc.The ID3v1 standard was introduced in 1996 but it's still widely supported by various audio players and decoders. To get more information about ID3v1 tags please visit [http://id3.org/ID3v1](http://id3.org/ID3v1).

## Reading an ID3v1 tag

The following steps show how to read the ID3v1 tag in an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the ID3v1 tag by using the [Mp3RootPackage.ID3V1](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/id3v1) property
4.  If the ID3v1 tag is not null then check for all of its properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3ReadID3V1Tag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithID3V1))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	if (root.ID3V1 != null)
	{
		Console.WriteLine(root.ID3V1.Album);
		Console.WriteLine(root.ID3V1.Artist);
		Console.WriteLine(root.ID3V1.Title);
		Console.WriteLine(root.ID3V1.Version);
		Console.WriteLine(root.ID3V1.Comment);

		// ...
	}
}
```

## Updating an ID3v1 tag

The following are the steps to update the ID3v1 tag in an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Create the ID3v1 tag if it's missing
4.  Update ID3v1 fields using the [Mp3RootPackage.ID3V1](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/id3v1) property
5.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

The following code snippet shows how to update the ID3v1 tag in an MP3 file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3UpdateID3V1Tag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithID3V1))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	if (root.ID3V1 == null)
	{
		root.ID3V1 = new ID3V1Tag();
	}
	root.ID3V1.Album = "test album";
	root.ID3V1.Artist = "test artist";
	root.ID3V1.Title = "test title";
	root.ID3V1.Comment = "test comment";
	root.ID3V1.Year = "2019";

	// ...

	metadata.Save(Constants.OutputMp3);
}
```

## Removing an ID3v1 tag

To remove the ID3v1 tag from an MP3 audio just assign null to the [Mp3RootPackage.ID3V1](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/id3v1) property. The code sample below shows how to remove the ID3v1 tag from an MP3 file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3RemoveID3V1Tag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithID3V1))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	root.ID3V1 = null;
	metadata.Save(Constants.OutputMp3);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## How to add attachment to PDF document

Path: /merger/java/how-to-add-attachment-to-pdf-document/

It is a known fact PDF files are great for demonstration purposes as your printed content will look the same as it appears on device screen and no formatting will be lost. Another valuable, but less known feature, is that PDF format provides an easy way to organize your documents when you need to store multiple related files alongside. You can just attach other documents like PDF or Microsoft Word documents, Excel spreadsheets, PowerPoint presentations, images, audio or video files to your original PDF document and if you move it to another location, all attachments will move too.

Many desktop tools provide an ability to attach files to a PDF document via their user interfaces, but what if you need to do the same programmatically? Here is where GroupDocs.Merger will come to the rescue.   
Please check the guide below and learn how to add PDF document attachment in 3 steps.

## How to add attachment to PDF document

**[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** provides an ability to add PDF document attachment. Here are the steps for it:

*   Instantiate [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) object with source document path or stream;
*   Call [importDocument](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#importDocument(com.groupdocs.merger.domain.options.interfaces.IImportDocumentOptions)) method and pass [PdfAttachmentOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/PdfAttachmentOptions) object to it with a file path to document that is being embedded into PDF;
*   Call [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add add PowerPoint presentation attachment to PDF document:

```java
PdfAttachmentOptions olePdfOptions = new PdfAttachmentOptions("c:\presentation-attachment.ppt");

Merger merger = new Merger("c:\sample.pdf");
{
    merger.importDocument(olePdfOptions);
    merger.save("c:\document-with-attachment.pdf");
}
```

---

## How to add attachment to PDF document

Path: /merger/net/how-to-add-attachment-to-pdf-document/

It is a known fact PDF files are great for demonstration purposes as your printed content will look the same as it appears on device screen and no formatting will be lost. Another valuable, but less known feature, is that PDF format provides an easy way to organize your documents when you need to store multiple related files alongside. You can just attach other documents like PDF or Microsoft Word documents, Excel spreadsheets, PowerPoint presentations, images, audio or video files to your original PDF document and if you move it to another location, all attachments will move too.

Many desktop tools provide an ability to attach files to a PDF document via their user interfaces, but what if you need to do the same programmatically? Here is where GroupDocs.Merger will come to the rescue.   
Please check the guide below and learn how to add PDF document attachment in 3 steps.

## How to add attachment to PDF document

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides an ability to add PDF document attachment. Here are the steps for it:

*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [ImportDocument](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/importdocument) method and pass [PdfAttachmentOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pdfattachmentoptions) object to it with a file path to document that is being embedded into PDF;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add add PowerPoint presentation attachment to PDF document:

```csharp
using (Merger merger = new Merger(@"c:\sample.pdf"))
{
	PdfAttachmentOptions pdfAttachmentOptions = new PdfAttachmentOptions(@"c:\presentation-attachment.ppt");
    merger.ImportDocument(pdfAttachmentOptions);
    merger.Save(@"c:\document-with-attachment.pdf");
}

```

---

## How to integrate GroupDocs.Viewer in ASP.NET Core Web application

Path: /viewer/net/how-to-integrate-groupdocs-viewer-in-asp-net-core-web-app/

This page describes how to develop a simple ASP.NET Core Web application that uses GroupDocs.Viewer for .NET as a rendering engine. The page describes how to create an application and to add required packages using the terminal, but you can do the same with Visual Studio. The following image shows the simplified application diagram:

![Simplified diagram of the web application that we're going to build](/viewer/net/images/showcases/how-to-integrate-groupdocs-viewer-ui-in-asp-net-core-web-app/simplified-app-diagram.png)

You can also find this sample application in the [demo projects repository](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/tree/master/Demos/ASP.NET%20Core) at GitHub.

## Prerequisites

To build the application from scratch, download .NET or .NET Core 3.1 SDK at <https://dotnet.microsoft.com/download> and then install it.

## Create an application

Create a web application by executing the [.NET CLI](https://docs.microsoft.com/en-us/dotnet/core/tools/) command in the directory named `my-viewer-app`:

{{< tabs "example1">}}
{{< tab "Shell" >}}
```sh
dotnet new web
```
{{< /tab >}}
{{< /tabs >}}

Check that project and configuration files has been created.

## Install packages

Add required packages using the .NET CLI tool. To do this, execute the following commands in the `my-viewer-app` directory:

{{< tabs "example2">}}
{{< tab "Shell" >}}
```sh
dotnet add package GroupDocs.Viewer.UI
dotnet add package GroupDocs.Viewer.UI.SelfHost.Api
dotnet add package GroupDocs.Viewer.UI.Api.Local.Storage
dotnet add package GroupDocs.Viewer.UI.Api.Local.Cache
```
{{< /tab >}}
{{< /tabs >}}
These commands add the following packages to the application:

* GroupDocs.Viewer.UI contains a middleware that serves the client application at the /viewer endpoint that you configure in the next step.
* GroupDocs.Viewer.UI.SelfHost.Api contains a middleware with a rendering engine based on GroupDocs.Viewer for .NET. You configure it at the /viewer-api endpoint.
* GroupDocs.Viewer.UI.Api.Local.Storage contains an implementation for the storage using a local disk to read and write files uploaded using UI.
* GroupDocs.Viewer.UI.Api.Local.Cache contains implementation for the cache storage. The cache stores output files produced by the rendering engine, such as the rendered HTML pages.

## Configure middleware

Open the `Startup.cs` file and add the following lines to `ConfigureServices` method:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
services
    .AddGroupDocsViewerUI();

services
    .AddControllers()
    .AddGroupDocsViewerSelfHostApi()
    .AddLocalStorage("./Files")
    .AddLocalCache("./Cache");
```
{{< /tab >}}
{{< /tabs >}}

Add the following lines to the `Configure` method to register UI and API endpoints:

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
app
    .UseRouting()
    .UseEndpoints(endpoints =>
    {
        endpoints.MapGroupDocsViewerUI(options =>
        {
            options.UIPath = "/viewer";
            options.APIEndpoint = "/viewer-api";
        });
        endpoints.MapGroupDocsViewerApi(options =>
        {
            options.ApiPath = "/viewer-api";
        });
    });
```
{{< /tab >}}
{{< /tabs >}}

This code registers `/viewer` middleware that serves client application files and `/viewer-api` middleware that renders content for the client application.

The `Startup.cs` file is as follows:

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;

namespace my_viewer_app
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services
                .AddGroupDocsViewerUI();

            services
                .AddControllers()
                .AddGroupDocsViewerSelfHostApi()
                .AddLocalStorage("./Files")
                .AddLocalCache("./Cache");
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            app
                .UseRouting()
                .UseEndpoints(endpoints =>
                {
                    endpoints.MapGroupDocsViewerUI(options =>
                    {
                        options.UIPath = "/viewer";
                        options.APIEndpoint = "/viewer-api";
                    });

                    endpoints.MapGroupDocsViewerApi(options =>
                    {
                        options.ApiPath = "/viewer-api";
                    });
                });
        }
    }
}
```
{{< /tab >}}
{{< /tabs >}}

If you use the [new program style](https://docs.microsoft.com/en-us/dotnet/core/tutorials/top-level-templates) with top-level statements, global using directives, and implicit using directives, the `Startup.cs` is as follows:

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
var builder = WebApplication.CreateBuilder(args);

builder.Services
        .AddGroupDocsViewerUI();

builder.Services
        .AddControllers()
        .AddGroupDocsViewerSelfHostApi()
        .AddLocalStorage("./Files")
        .AddLocalCache("./Cache");

var app = builder.Build();

app
    .UseRouting()
    .UseEndpoints(endpoints =>
    {
        endpoints.MapGroupDocsViewerUI(options =>
        {
            options.UIPath = "/viewer";
            options.APIEndpoint = "/viewer-api";
        });
        endpoints.MapGroupDocsViewerApi(options =>
        {
            options.ApiPath = "/viewer-api";
        });
    });

app.Run();
```
{{< /tab >}}
{{< /tabs >}}

## Create folders for files and cache

On a local disk, create folders for files and cache by executing the following commands:

{{< tabs "example7">}}
{{< tab "Shell" >}}
```sh
mkdir Files
mkdir Cache
```
{{< /tab >}}
{{< /tabs >}}

## Run the application

To run the application, execute the `dotnet run` command in the `my-viewer-app` directory. The output should be as follows:  

```verilog
Building...
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:7153
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5081
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\my-viewer-app
```

In the browser, open one of the endpoints listed in the output above and add the `/viewer` path to see the viewer application in action:

![GroupDocs.Viewer.Ui in ASP.NET Core Web application](/viewer/net/images/showcases/how-to-integrate-groupdocs-viewer-ui-in-asp-net-core-web-app/groupdocs-viewer-ui-asp-net-core-web-app.png)

To upload files, click the folder icon or copy your files to the `Files` directory. You can also specify the path to the directory in the `AddLocalStorage` extension method.

## Resources

* [GroupDocs.Viewer.UI package repository](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET-UI)
* [GroupDocs.Viewer for .NET Demos and Examples](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET)
* [GroupDocs.Viewer Online App](https://products.groupdocs.app/viewer/total)

---

## How to merge JPG images using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-jpg-images-using-csharp/


## JPG Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple JPG documents in the preferred order and save them as a single file.

## About JPG File Format

JPEG is a type of image format that is saved using the method of lossy compression. The output image, as result of compression, is a trade-off between storage size and image quality. Users can adjust the compression level to achieve the desired quality level while at the same time reduce the storage size. Image quality is negligibly affected if 10:1 compression is applied to the image. The higher the compression value, the higher the degradation in image quality.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### Source JPG images

!["Sample1.jpg"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/net/images/jpg/sample3.jpg)

### How to merge JPG files as photo collage

The following example demonstrates how to merge image files as photo collage with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinmode) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```csharp
// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.jpg"))
{
    // Define image join options with horizontal join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
    // Add another image file to merge
    merger.Join(@"c:\sample2.jpg", joinOptions);
    // Define image join options with vertical join mode
    joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
    // Add next image file to merge
    merger.Join(@"c:\sample3.jpg", joinOptions);
    // Merge image files and save result
    merger.Save(@"c:\merged.jpg");
}
```

### Result merged JPG image

!["Merged.jpg"](/merger/net/images/jpg/merged_grid.jpg)

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge JPG Live Demo

GroupDocs.Merger for .NET provides an online [**JPG Merger App**](https://products.groupdocs.app/merger/jpg), which allows you to try it for free and check its quality and accuracy.
---

## How to merge JPG images using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-jpg-images-using-java/


## JPG Merger Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple JPG documents in the preferred order and save them as a single file.

## About JPG File Format

JPEG is a type of image format that is saved using the method of lossy compression. The output image, as result of compression, is a trade-off between storage size and image quality. Users can adjust the compression level to achieve the desired quality level while at the same time reduce the storage size. Image quality is negligibly affected if 10:1 compression is applied to the image. The higher the compression value, the higher the degradation in image quality.

### Download and Configure

You can follow the steps below to reference GroupDocs.Merger for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/merger/java):

1. Unpack zip archive .
2. Switch to **lib** folder.
3. Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4. After this you should add the merger **dependency** block to your *pom.xm*l project file.

### Source JPG images

!["Sample1.jpg"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/java/images/jpg/sample3.jpg)

### How to merge JPG files as photo collage

The following example demonstrates how to merge image files as photo collage with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```java
// Load the source image file
Merger merger = new Merger("c:\sample1.jpg")

// Define image join options with horizontal join mode
ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
// Add another image file to merge
merger.join("c:\sample2.jpg", joinOptions);
// Define image join options with vertical join mode
joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
// Add next image file to merge
merger.join("c:\sample3.jpg", joinOptions);
// Merge image files and save result
merger.save("c:\merged.jpg");
```

### Result merged JPG image

!["Merged.jpg"](/merger/java/images/jpg/merged_grid.jpg)

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge JPG Live Demo

GroupDocs.Merger for Java provides an online [**JPG Merger App**](https://products.groupdocs.app/merger/jpg), which allows you to try it for free and check its quality and accuracy.
---

## How to save document with password

Path: /signature/net/save-signed-document-with-password/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving signed document with password protection. This ability is supported over [Password](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/saveoptions/password) property of [SaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/saveoptions) class that should be passed to [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method.

Here are the steps to protect signed document with password with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the [SaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/saveoptions) object and specify [Password](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/saveoptions/password) property with required password string.  
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signatureoptions and [SaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/saveoptions) object to it.

Following example demonstrates how to save signed document with password.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create QRCode option with predefined QRCode text
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        // setup QRCode encoding type
        EncodeType = QrCodeTypes.QR,
        // set signature position
        Left = 100,
        Top = 100
    };
    SaveOptions saveOptions = new SaveOptions()
    {
        Password = "1234567890",
        UseOriginalPassword = false
    };
    // sign document to file
    signature.Sign("SignedProtected.pdf", signOptions, saveOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## How to use custom cache implementation

Path: /conversion/java/how-to-use-custom-cache-implementation/


[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) provides built-in caching to the local drive for improved performance. However, for greater flexibility, the library allows developers to implement custom caching mechanisms by extending the [ICache](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.caching/icache/) interface. This approach enables storing conversion results in alternate storage systems, such as memory caches, distributed caches, or databases.

This guide demonstrates how to implement a custom caching mechanism using **Redis**, a popular distributed in-memory cache, with [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java).

## Steps to Implement a Redis-Based Custom Cache

1.   Implement the [ICache](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.caching/icache/) interface to define the caching logic using **Redis** as the backend.
2.   Create an instance of the **Redis-based** implementation.
3.   Use a delegate to instantiate the [ConverterSettings](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/convertersettings/) class. Configure the cache for [ConverterSettings](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/convertersettings/) using the `setCache` method and pass the custom cache instance.
4.   Create a [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) instance, providing the path to the source document and the custom [ConverterSettings](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/convertersettings/) delegate as parameters.
5.   Instantiate the desired [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) class (e.g., [PdfConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/) for PDF conversion).
6.   Call the [convert](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#convert-java.lang.String-com.groupdocs.conversion.options.convert.ConvertOptions-) method of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class to process the document.

The following code demonstrates how to implement a custom **Redis-based** caching mechanism for GroupDocs.Conversion:

{{< tabs "code-example">}}
{{< tab "CustomCacheImplementation.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.ConverterSettings;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import java.time.Duration;
import java.time.Instant;

public class CustomCacheImplementation {
    public static void convert() {

        // Define cache key prefix
        String cacheKeyPrefix = "myPrefix:";

        // Create an instance of the Redis-based custom cache
        RedisCache cache = new RedisCache(cacheKeyPrefix);

        // Configure the ConverterSettings with custom cache
        ConverterSettings settingsFactory = new ConverterSettings();
        settingsFactory.setCache(cache);

        // Initialize the Converter with the source document and settings
        try(Converter converter = new Converter("professional-services.pdf", ()-> settingsFactory)) {
            // Define conversion options for PDF
            PdfConvertOptions options = new PdfConvertOptions();

            // Measure time taken for the first conversion
            Instant start = Instant.now();
            converter.convert("converted.pdf", options);
            Instant end = Instant.now();
            System.out.println(String.format("Time taken on first Convert call: %d ms", Duration.between(start, end).toMillis()));

            // Measure time taken for the second conversion (cached result)
            start = Instant.now();
            converter.convert("converted-1.pdf", options);
            end = Instant.now();
            System.out.println(String.format("Time taken on second Convert call: %d ms", Duration.between(start, end).toMillis()));
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "RedisCache.java" >}}  
{{< tab-text >}}
```java
import com.groupdocs.conversion.caching.ICache;
import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisPool;
import redis.clients.jedis.JedisPoolConfig;
import redis.clients.jedis.util.Pool;

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.util.List;
import java.util.Set;
import java.util.stream.Collectors;

public class RedisCache implements ICache, AutoCloseable {
    private final String cacheKeyPrefix;
    private final Pool<Jedis> jedisPool;

    public RedisCache(String cacheKeyPrefix) {
        this.cacheKeyPrefix = cacheKeyPrefix;
        String host = "192.168.222.4";
        this.jedisPool = new JedisPool(new JedisPoolConfig(), host);
    }

    public void set(String key, Object data) {
        if (data == null) {
            return;
        }

        String prefixedKey = getPrefixedKey(key);
        try (ByteArrayOutputStream outputStream = new ByteArrayOutputStream()) {

            byte[] buf = new byte[8192];
            int length;
            while ((length = ((InputStream)data).read(buf)) != -1) {
                outputStream.write(buf, 0, length);
            }

            try (Jedis jedis = jedisPool.getResource()) {
                jedis.set(prefixedKey.getBytes(), outputStream.toByteArray());
            }
        } catch (Exception e) {
            throw new RuntimeException("Error setting data to Redis", e);
        }
    }

    public Object tryGetValue(String key) {
        String prefixedKey = getPrefixedKey(key);
        try (Jedis jedis = jedisPool.getResource()) {
            byte[] data = jedis.get(prefixedKey.getBytes());
            if (data != null) {
                return new ByteArrayInputStream(data);
            }
        } catch (Exception e) {
            throw new RuntimeException("Error getting data from Redis", e);
        }
        return null;
    }

    public List<String> getKeys(String filter) {
        try (Jedis jedis = jedisPool.getResource()) {
            Set<String> keys = jedis.keys("*" + filter + "*");
            return keys.stream()
                    .map(key -> key.replace(cacheKeyPrefix, ""))
                    .filter(key -> key.toLowerCase().startsWith(filter.toLowerCase()))
                    .collect(Collectors.toList());
        }
    }

    private String getPrefixedKey(String key) {
        return cacheKeyPrefix + key;
    }

    @Override
    public void close() {
        jedisPool.close();
    }
}
```
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

This approach provides a robust solution for integrating a custom caching layer, optimizing document conversion workflows in both performance and scalability.
---

## How to use custom cache implementation

Path: /conversion/net/how-to-use-custom-cache-implementation/

**[GroupDocs.Conversion](https://products.groupdocs.com/conversion/net)** implements caching to local drive out of the box. For flexibility GroupDocs.Conversion provides and extension point which allows you to cache conversion result in your own way. You can do this by using [ICache](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.caching/icache) interface implementation.  
Let's see how to implement some custom cache implementation using this extension point.

## Using Redis cache

To implement the Redis cache, follow these steps:

1.   Create *RedisCache* class which implements [ICache](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.caching/icache) interface
2.   Instantiate the *RedisCache* class
3.   Declare a delegate which will be used from [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) classes factory of [ConverterSettings](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertersettings). In the body of this delegate, instantiate [ConverterSettings](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertersettings) class and set property [Cache](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertersettings/cache) with the *RedisCache* class instance from previous step
4.   Instantiate [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class with path to source document and the delegate from the previous step as constructor's parameters
5.   Create instance of [PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions) class
6.   Call [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method of [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) instance

Below is the code that demonstrates how to use custom caching for GroupDocs.Conversion.

```csharp
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters.Binary;
using GroupDocs.Conversion.Caching;
using GroupDocs.Conversion.Options.Convert;
using StackExchange.Redis;
namespace GroupDocs.Conversion.Examples.CSharp.AdvancedUsage.Caching
{
    internal class HowToUseCustomCacheImplementation
    {
        /// <summary>
        /// This example demonstrates how to implement custom cache when rendering document.
        /// </summary>
        public static void Run()
        {
            string outputDirectory = Constants.GetOutputDirectoryPath();
            
            RedisCache cache = new RedisCache("sample_");
            Func<ConverterSettings> settingsFactory = () => new ConverterSettings
            {
                Cache = cache
            };
            using (Converter converter = new Converter(Constants.SAMPLE_DOCX, settingsFactory))
            {
                PdfConvertOptions options = new PdfConvertOptions();
                Stopwatch stopWatch = Stopwatch.StartNew();
                converter.Convert("converted.pdf", options);
                stopWatch.Stop();
                Console.WriteLine("Time taken on first call to Convert method {0} (ms).", stopWatch.ElapsedMilliseconds);
                stopWatch.Restart();
                converter.Convert("converted-1.pdf", options);
                stopWatch.Stop();
                Console.WriteLine("Time taken on second call to Convert method {0} (ms).", stopWatch.ElapsedMilliseconds);
            }
            Console.WriteLine($"\nSource document rendered successfully.\nCheck output in {outputDirectory}.");
        }
    }
    public class RedisCache : ICache, IDisposable
    {
        private readonly string _cacheKeyPrefix;
        private readonly ConnectionMultiplexer _redis;
        private readonly IDatabase _db;
        private readonly string _host = "192.168.0.1:6379";
        public RedisCache(string cacheKeyPrefix)
        {
            _cacheKeyPrefix = cacheKeyPrefix;
            _redis = ConnectionMultiplexer.Connect(_host);
            _db = _redis.GetDatabase();
        }
        public void Set(string key, object data)
        {
            if (data == null)
                return;
            string prefixedKey = GetPrefixedKey(key);
            using (MemoryStream stream = GetStream(data))
            {
                _db.StringSet(prefixedKey, RedisValue.CreateFrom(stream));
            }
        }
        public bool TryGetValue(string key, out object value)
        {
            var prefixedKey = GetPrefixedKey(key);
            var redisValue = _db.StringGet(prefixedKey);
            if (redisValue.HasValue)
            {
                var data = Deserialize(redisValue);
                value = data;
                return true;
            }

            value = default;
            return false;
        }
        public IEnumerable<string> GetKeys(string filter)
        {
            return _redis.GetServer(_host).Keys(pattern: $"*{filter}*")
                .Select(x => x.ToString().Replace(_cacheKeyPrefix, string.Empty))
                .Where(x => x.StartsWith(filter, StringComparison.InvariantCultureIgnoreCase))
                .ToList();
        }
        private string GetPrefixedKey(string key)
            => $"{_cacheKeyPrefix}{key}";
        private object Deserialize(RedisValue redisValue)
        {
            object data;
            using (MemoryStream stream = new MemoryStream(redisValue))
            {
                BinaryFormatter formatter = new BinaryFormatter
                {
                    Binder = new IgnoreAssemblyVersionSerializationBinder()
                };
                try
                {
                    data = formatter.Deserialize(stream);
                }
                catch (SerializationException)
                {
                    data = null;
                }
            }
            return data;
        }
        private MemoryStream GetStream(object data)
        {
            MemoryStream result = new MemoryStream();
            if (data is Stream stream)
            {
                stream.Position = 0;
                stream.CopyTo(result);
            }
            else
            {
                BinaryFormatter formatter = new BinaryFormatter();
                formatter.Serialize(result, data);
            }
            return result;
        }
        public void Dispose()
        {
            _redis.Dispose();
        }
        private class IgnoreAssemblyVersionSerializationBinder : SerializationBinder
        {
            public override Type BindToType(string assemblyName, string typeName)
            {
                string assembly = Assembly.GetExecutingAssembly().FullName;
                Type type = Type.GetType($"{typeName}, {assembly}");
                return type;
            }
        }
    }
}

```

---

## How to use custom cache implementation

Path: /viewer/java/how-to-use-custom-cache-implementation/


By default, GroupDocs.Viewer implements caching to local. But you can cache rendering result in your own way. To do this, use the `Cache` interface implementation.

## Implementing Memory Cache

In this section we build the custom `MemoryCache` class that is based on `HashMap` and demonstrate how to use it in GroupDocs.Viewer.

The complete listing of the `MemoryCache.java` file is below:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.caching.Cache;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class MemoryCache implements Cache {
    private final Map<String, Object> data = new HashMap<>();
    private final String mPrefix;

    public MemoryCache(String prefix) {
        this.mPrefix = prefix;
    }

    @Override
    public void set(String key, Object value) {
        data.put(mPrefix + key, value);
    }

    @Override
    public Object get(String key) {
        return data.get(mPrefix + key);
    }

    @Override
    public List<String> getKeys(String filter) {
        List<String> result = new ArrayList<>();
        for (String key : data.keySet()) {
            if (key.contains(filter)) {
                result.add(key);
            }
        }
        return result;
    }
}
```
{{< /tab >}}
{{< /tabs >}}

Example usage of `MemoryCache` type.

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.ViewerSettings;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

MemoryCache memoryCache = new MemoryCache("cache-key-prefix-");
ViewerSettings viewerSettings = new ViewerSettings(memoryCache);

try (Viewer viewer = new Viewer("sample.docx", viewerSettings)) {
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources();

    long currentTimeMillis = System.currentTimeMillis();
    viewer.view(options);
    currentTimeMillis = System.currentTimeMillis() - currentTimeMillis;
    System.out.println("Time taken on first call to View method " + currentTimeMillis + " (ms).");

    currentTimeMillis = System.currentTimeMillis();
    viewer.view(options);
    currentTimeMillis = System.currentTimeMillis() - currentTimeMillis;
    System.out.println("Time taken on second call to View method " + currentTimeMillis + " (ms).");
}
```
{{< /tab >}}
{{< /tabs >}}

After running the code above the similar output will be printed in a console:

![](/viewer/java/images/how-to-use-custom-cache-implementation.png)

## Using Custom Model Classes for Caching

Default Viewer models implements the serializable interface. But you may want to use other library for serialization. Lots of them want you to annotate classes and fields of classes that should be serialized.
You can create custom models with appropriate fields and configure GroupDocs.Viewer to use these models.

To do this, follow these steps:

1. Create custom models, implementing Viewer model's interfaces, like `ViewInfo`, `FileInfo`, and so on (see full list of interfaces in the `CacheableFactory` class).
2. Create custom model factory (`CustomFactory`) extending class `CacheableFactory`. Each method in the class must be overridden to return the instance of your cache model.
3. Configure GroupDocs.Viewer to use the `CustomFactory` using the `CacheableFactory.setInstance(new CustomFactory())` method before creating the `Viewer` object.
4. Configure the GroupDocs.Viewer cache as usual. GroupDocs.Viewer put your model's objects into the `set` method of the cache implementation so you can serialize it in any way.

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
public class CustomFileInfoJackson implements FileInfo {
    @JsonProperty("FileType")
    private final String mFileType;
    @JsonProperty("Encrypted")
    private boolean mEncrypted;

    @JsonCreator
    public CustomFileInfoJackson(@JsonProperty("FileType") String fileType) {
        mFileType = fileType;
    }

    @Override
    public FileType getFileType() {
        return FileType.valueOf(mFileType);
    }

    @Override
    public boolean isEncrypted() {
        return mEncrypted;
    }

    @Override
    public void setEncrypted(boolean encrypted) {
        mEncrypted = encrypted;
    }
}
```
{{< /tab >}}
{{< /tabs >}}

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
public class CustomFactory extends CacheableFactory {

    //...

    @Override
    public FileInfo newFileInfo(FileType fileType) {
        return new CustomFileInfoJackson(fileType.name());
    }

    //...

}
```
{{< /tab >}}
{{< /tabs >}}

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
public class JacksonCache implements Cache {

    //...

    @Override
    public void set(String key, Object value) {
        final byte[] bytes;
        if (value instanceof InputStream) {
            bytes = IOUtils.toByteArray((InputStream) value);
        } else {
            // Serialize in any way
            bytes = jacksonMapper.writeValueAsBytes(value);
        }
        // Here bytes could be written to file or sent somewhere
        mData.put(key, bytes);
    }

    //...

    @Override
    public <T> T get(String key, Class<T> clazz) {
        final byte[] bytes = mData.get(key);
        if (InputStream.class.equals(clazz)) {
            return (T) new ByteArrayInputStream(bytes);
        } else {
            // Deserialize in any way
            return jacksonMapper.readValue(bytes, clazz);
        }
    }

    //...

}
```
{{< /tab >}}
{{< /tabs >}}

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.ViewerSettings;
import com.groupdocs.viewer.caching.Cache;
import com.groupdocs.viewer.caching.extra.CacheableFactory;
// ...

CacheableFactory.setInstance(new CustomFactory());

Cache cache = new JacksonCache();
ViewerSettings settings = new ViewerSettings(cache);
try (Viewer viewer = new Viewer("document.doc", settings)) {
    // Do work
}

```
{{< /tab >}}
{{< /tabs >}}
---

## HTML

Path: /parser/net/html/

The following example shows how to extract HTML formatted text:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Formatted text extraction isn't suppported" : reader.ReadToEnd());
    }
}
```

The following HTML tags are supported by the API:

| Tag | Description |
| --- | --- |
| `<p>` | Paragraph is surrounded by `<p>` tag |
| `<a>` | Hyperlinks |
| `<b>` | Text with Bold font is surrounded by `<a>` tag |
| `<i>` | Text with Italic font is surrounded by `<i>` tag |
| `<h>` - `<h6>` | If the heading has 'Heading X' style, it's surrounded by `<hX>` tag |
| `<ol>` / `<ul>` | Numbering and bullets lists |
| `<table>` | Tables |

The following Microsoft Word document is used as input document:

![](/parser/net/images/html.png)

The following HTML document is extracted using the example above:

![](/parser/net/images/html_1.png)

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Save signed Image with different output file type

Path: /signature/java/save-signed-image-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports saving of Image signed documents with different formats. Each of document type has list of compatible saving type. These values are listed in enum [ImageSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/ImagesSaveFileFormat).

Here are the steps to save signed Image document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java):

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate required signature options.
*   Instantiate the [ImageSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/ImagesSaveOptions) object according to your requirements and specify [FileFormat](https://reference.groupdocs.com/net/signature/groupdocs.signature.options/imagesaveoptions/properties/fileformat) as one of predefined values from [ImageSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/ImagesSaveFileFormat).  
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signatureoptions and object [ImageSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/ImagesSaveOptions) to it.
    

Following example demonstrates how to save signed Image document with different output type

```java
Signature signature = new Signature("sample.jpg");
// create QRCode option with predefined QRCode text
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
ImagesSaveOptions saveOptions = new ImagesSaveOptions();
saveOptions.setFileFormat(ImagesSaveFileFormat.Svg);
saveOptions.setOverwriteExistingFiles(true);
// sign document to file
signature.sign("signed.svg", signOptions, saveOptions);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to save signed Image with different output file type

Path: /signature/net/save-signed-image-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving of Image signed documents with different formats. Each of document type has list of compatible saving type. These values are listed in enum [ImageSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesavefileformat).

Here are the steps to save signed Image document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the [ImageSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesaveoptions) object according to your requirements and specify [FileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesaveoptions/fileformat) as one of predefined values from [ImageSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesavefileformat).  
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signatureoptions and object [ImageSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesaveoptions) to it.

Following example demonstrates how to save signed Image document with different output type

```csharp
using (Signature signature = new Signature("sample.jpg"))
{
    // create QRCode option with predefined QRCode text
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        // setup QRCode encoding type
        EncodeType = QRCodeTypes.QR,
        // set signature position
        Left = 100,
        Top = 100
    };
    ImageSaveOptions saveOptions = new ImageSaveOptions()
    {
        FileFormat = ImageSaveFileFormat.Svg,
        OverwriteExistingFiles = true
    };
    // sign document to file
    signature.Sign("signed.svg", signOptions, saveOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Implement custom encryption with Metadata signatures

Path: /signature/java/implement-custom-encryption-with-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to embed into Metadata signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption but allows to provide custom encryption. This procedure requires implementation of interface [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) with two methods to encrypt and decrypt data.

Here are the steps to embed into Metadata values with custom encryption with GroupDocs.Signature: 

*   Define custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
*   Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.
*   Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like  [FormatAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/FormatAttribute) to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/SkipSerializationAttribute) to mark property of class as not serialize 
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter
*   Create one or several objects of [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) object with  MetadataSignature[.setValue](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setValue(java.lang.Object)) as object instance. Setup MetadataSignature[.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) property or use same for [MetadataSignOptions.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) if all signatures should be encrypted.
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements, add all metadata signatures to its collection and setup if needed [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) property
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it.
    

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
// Define class that implements IDataEncryption interface
public class CustomXOREncryption implements IDataEncryption
{
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final int getKey(){ return auto_Key; }
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final void setKey(int value){ auto_Key = value; }
    private int auto_Key;
 
    /**
     * <p>
     * Encode method to encrypt string.
     * </p>
     * @return Returns enccrypted string
     * @param source Source string to encode.
     */
    public final String encode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Decode method to obtain decrypted string.
     * </p>
     * @return Returns decrypted string
     * @param source Source string to decode.
     */
    public final String decode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Using XOR operation get encoded / decoded string
     * </p>
     * @return
     * @param source
     */
    private String process(String source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.length());
        char chTmp;
        for (int index = 0; index < src.length(); ++index)
        {
            chTmp = src.charAt(index);
            chTmp = (char)(chTmp ^ this.getKey());
            dst.append(chTmp);
        }
        return dst.toString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.   

```java
public class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Implementation of embedding custom object into Metadata signature

This example shows how to embed custom object into Metadata signature.

```java
Signature signature = new Signature("sample.docx");
 
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();
 
// set encryption for all metadata signatures for this options
// if you need separate encryption use own MetadataSignature.DataEncryption property
options.setDataEncryption(encryption);
 
 
// create custom object
DocumentSignatureData documentSignature = new DocumentSignatureData();
documentSignature.setID(java.util.UUID.randomUUID().toString());
documentSignature.setAuthor(System.getenv("USERNAME"));
documentSignature.setSigned(new java.util.Date());
documentSignature.setDataFactor(new java.math.BigDecimal("11.22"));
 
// setup signature metadata
WordProcessingMetadataSignature mdSignature = new WordProcessingMetadataSignature("Signature", documentSignature);
 
// setup signature metadata
WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
 
// setup data of document id
WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", java.util.UUID.randomUUID().toString());
 
// add signatures to options
options.getSignatures().add(mdSignature);
options.getSignatures().add(mdAuthor);
options.getSignatures().add(mdDocId);
 
// sign document to file
SignResult signResult = signature.sign("MetadataCustomEncryptionObject.docx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Implement custom encryption with Metadata signatures

Path: /signature/net/implement-custom-encryption-with-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into Metadata signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption but allows to provide custom encryption. This procedure requires implementation of interface [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) with two methods to encrypt and decrypt data.

Here are the steps to embed into Metadata values with custom encryption with GroupDocs.Signature:

* Define custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
* Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.
* Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like  [FormatAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/formatattribute) to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/skipserializationattribute) to mark property of class as not serialize.
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Create one or several objects of [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) object with  [MetadataSignature.Value](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/value) as object instance. Setup [MetadataSignature.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/dataencryption) property or use same for [MetadataSignOptions.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/dataencryption) if all signatures should be encrypted.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements, add all metadata signatures to its collection and setup if needed [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/dataencryption) property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
// Define class that implements IDataEncryption interface
private class CustomXOREncryption : IDataEncryption
{
    /// <summary>
    /// Gets or sets non empty key for encryption (at least one character)
    /// </summary>
    public int Key { get; set; }
    /// <summary>
    /// Encode method to encrypt string.
    /// </summary>
    /// <param name="source">Source string to encode.</param>
    /// <returns>Returns enccrypted string</returns>
    public string Encode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Decode method to obtain decrypted string.
    /// </summary>
    /// <param name="source">Source string to decode.</param>
    /// <returns>Returns decrypted string</returns>
    public string Decode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Using XOR operation get encoded / decoded string
    /// </summary>
    /// <param name="source"></param>
    /// <returns></returns>
    private string Process(string source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.Length);
        char chTmp;
        for (int index = 0; index < src.Length; ++index)
        {
            chTmp = src[index];
            chTmp = (char)(chTmp ^ this.Key);
            dst.Append(chTmp);
        }
        return dst.ToString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Implementation of embedding custom object into Metadata signature

This example shows how to embed custom object into Metadata signature.

```csharp
 using (Signature signature = new Signature("sample.docx"))
{
    // create data encryption
    IDataEncryption encryption = new CustomXOREncryption();
    // setup options with text of signature
    MetadataSignOptions options = new MetadataSignOptions()
    {
        // set encryption for all metadata signatures for this options
        // if you need separate encryption use own MetadataSignature.DataEncryption property
        DataEncryption = encryption
    };
    // create custom object
    DocumentSignatureData documentSignatureData = new DocumentSignatureData()
    {
        ID = Guid.NewGuid().ToString(),
        Author = Environment.UserName,
        Signed = DateTime.Now,
        DataFactor = 11.22M
    };
    // setup signature metadata
    WordProcessingMetadataSignature mdSignature = new WordProcessingMetadataSignature("Signature", documentSignatureData);
    // setup signature metadata
    WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
    // setup data of document id
    WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", Guid.NewGuid().ToString());
    // add signatures to options
    options.Signatures.Add(mdSignature);
    options.Signatures.Add(mdAuthor);
    options.Signatures.Add(mdDocId);
    // sign document to file
    signature.Sign("MetadataCustomEncryptionObject.docx", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Implement custom encryption with QR-code signatures

Path: /signature/java/implement-custom-encryption-with-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to embed into QR-code signature custom objects. This feature is implemented over object serialization to string and further encryption. There is ability to provide custom encryption. This procedure requires implementation of interface [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) with two methods to encrypt and decrypt data.

Here are the steps to embed into QR-code text with custom encryption with GroupDocs.Signature: 

*   Define custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
*   Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/FormatAttribute) attribute to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/SkipSerializationAttribute) to mark property of class as not serialize 
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) object with [setData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions#setData(java.lang.Object)) value 
*   Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) object according to your requirements and custom object to [setData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions#setData(java.lang.Object)) property.
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) to it.
    
This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
public class CustomXOREncryption implements IDataEncryption
{
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final int getKey(){ return auto_Key; }
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final void setKey(int value){ auto_Key = value; }
    private int auto_Key;
 
    /**
     * <p>
     * Encode method to encrypt string.
     * </p>
     * @return Returns enccrypted string
     * @param source Source string to encode.
     */
    public final String encode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Decode method to obtain decrypted string.
     * </p>
     * @return Returns decrypted string
     * @param source Source string to decode.
     */
    public final String decode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Using XOR operation get encoded / decoded string
     * </p>
     * @return
     * @param source
     */
    private String process(String source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.length());
        char chTmp;
        for (int index = 0; index < src.length(); ++index)
        {
            chTmp = src.charAt(index);
            chTmp = (char)(chTmp ^ this.getKey());
            dst.append(chTmp);
        }
        return dst.toString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```java
public class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Sign documents with custom encrypted objects and values into QR-code signatures

This example shows how to add custom object into metadata signature to Image document.

```java
Signature signature = new Signature("sample.pdf");
 
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
// create custom object
DocumentSignatureData documentSignature = new DocumentSignatureData();
documentSignature.setID(java.util.UUID.randomUUID().toString());
documentSignature.setAuthor(System.getenv("USERNAME"));
documentSignature.setSigned(new java.util.Date());
documentSignature.setDataFactor(new java.math.BigDecimal("11.22"));
 
// setup QR-Code options
QrCodeSignOptions options = new QrCodeSignOptions();
// set custom object to serialize to QR Code
options.setData(documentSignature);
// QR-code type
options.setEncodeType(QrCodeTypes.QR);
// specify serialization encryption
options.setDataEncryption(encryption);
// locate and aligh signature
options.setHeight(100);
options.setWidth(100);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding() ;
padding.setRight(10);
padding.setBottom(10);
options.setMargin(padding);
 
// sign document to file
signature.sign(QRCodeCustomEncryption.pdf, options);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## In-Paragraph List in Word Processing Document

Path: /assembly/java/in-paragraph-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-ParagraphList report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Paragraph List in Microsoft Word Document

### Creating a In-Paragraph List

Practising the following steps you can create In-Paragraph List Template in MS Word 2013.

1.  Write a sentence, for example, "We provide support for the following clients:".
2.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe about the clients with the following key requirements:

*   A descriptive or informative line like "We provide support for the following clients:".
*   Show all the clients along with the above sentence.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients: <<foreach [in getClients()]>>
<<[indexOf() != 0 ? ", " : ""]>><<[getName()]>><</foreach>>
```

### Download In-Paragraph List Template

Please download the sample In-Paragraph List document we created in this article:

*   [In-Paragraph List.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/In-Paragraph%20List.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists f3761bb8dd9ededf05862d904c90c2c9 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Paragraph List in Word Processing Document

Path: /assembly/net/in-paragraph-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-ParagraphList report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Paragraph List in Microsoft Word Document

### Creating a In-Paragraph List

Practicing the following steps you can create In-Paragraph List Template in MS Word 2013.

1.  Write a sentence, for example "We provide support for the following products:".
2.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   A descriptive or informative line like "We provide support for the following products:".
*   Show all the products along with the above sentence.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[IndexOf() != 0 ? ", " : ""]>>
<<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Paragraph List Template

Please download the sample In-Paragraph List document we created in this article:

*   [In-Paragraph List.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Paragraph%20List.docx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [In-Paragraph List\_XML.docx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Paragraph%20List_XML.docx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 7775ae4897672251532b3d83e751747f >}}

#### Database Entities

{{< gist GroupDocsGists 68e2eb6091b3ee906eba1f90e5622ec3 >}}

#### Using DataSet

{{< gist GroupDocsGists 6bdec421567135d03c820817338b2c1a >}}

#### Using XML DataSource

{{< gist GroupDocsGists c40e3a2f3a7e262bc7b538293a0f9d36 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 9164646f73917ebe7e06afa78c28e333 >}}

## In-Paragraph List in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [Wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'In-Paragraph List' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Paragraph List\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Paragraph%20List_OpenDocument.odt?raw=true) (use same template for database, dataset and JSON examples)
*   [In-Paragraph List\_XML\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Paragraph%20List_XML_OpenDocument.odt?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists ad17c8a96d43e55fd31a2e786eff308d >}}

#### Database Entities

{{< gist GroupDocsGists 41977a1de07bf0a29e41d83de181bb9b >}}

#### Using DataSet

{{< gist GroupDocsGists aa9772303065899b4860b8a951bbe3ad >}}

#### Using XML DataSource

{{< gist GroupDocsGists 70e8a390639f9334e01720353ca2cf35 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 9a4c83a74acee10a435682fc887af522 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List in Word Processing Document

Path: /assembly/java/in-table-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List in Microsoft Word Document

### Creating a In-Table List

Practicing the following steps you can create In-Table List Template in MS Word 2013.

1.  Click the on the document where you want to insert the table.
2.  Press "Insert" tab.
3.  Add a 2x3 table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers with the following key requirements:

*   Report must show managers' name.
*   It must show the sum of contract prices against each manager.
*   It must sum up all the contract prices for all the managers.
*   All the representation must be in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

| **Manager**                                       | **Contract Price**                                           |
| ------------------------------------------------- | ------------------------------------------------------------ |
| **<<foreach [in getManagers()]>><<[getName()]>>** | <<[getContracts().sum(<br />  c => c.getPrice())]>><</foreach>> |
| **Total:**                                        | <<[getManagers().sum(<br />  m => m.getContracts().sum(<br />    c => c.getPrice()))]>> |

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/In-Table%20List.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists fd010ddc315293d33632406a05aec5e6 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List in Word Processing Document

Path: /assembly/net/in-table-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List in Microsoft Word Document

### Creating an In-Table List

Practicing the following steps you can create In-Table List Template in MS Word 2013.

1.  Click the on the document where you want to insert the table.
2.  Press "Insert" tab.
3.  Add a 2x3 table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and the total order prices with the following key requirements:

*   Report must show customers' name.
*   It must show the sum of orders prices against each customer.
*   It must sum up all the order prices for all the customers.
*   All the representation must be in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> Price</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in customers</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order</span><span style="font-family: Calibri; font-size: 11pt;">.</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">m =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">m.</span><span style="font-family: Calibri; font-size: 11pt;">Order</span><span style="font-family: Calibri; font-size: 11pt;">.</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List.docx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List_DB.docx?raw=true) (Template for DataBase examples)
*   [In-Table List\_DS.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List_DT.docx?raw=true) (Template for DataSet examples)
*   [In-Table List\_XML.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List_XML.docx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists c1e5875214d69d535f9497bbae8badd3 >}}

#### Database Entities

{{< gist GroupDocsGists 5b9c83f4ed8afa9e3c5f9d5574c37cb9 >}}

#### Using DataSet

{{< gist GroupDocsGists 27bd50f40372a495f29ed21482cc8cc0 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 8782c7886ede5301cf9569990c590e0e >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 0d7ef7b3f529f21945e8f81eb175148b >}}

## In-Table List in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List_OpenDocument.odt?raw=true) (use same template for JSON examples)
*   [In-Table List\_DB\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List_DB_OpenDocument.odt?raw=true)
*   [In-Table List\_DS\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List_DT_OpenDocument.odt?raw=true)
*   [In-Table List\_XML\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List_XML_OpenDocument.odt?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 7ebc6ef9bef6655ff2c1003dd06b16fb >}}

#### Database Entities

{{< gist GroupDocsGists 49adfc32195f068d17c17e2de6b8f7c1 >}}

#### Using DataSet

{{< gist GroupDocsGists 635301c45c8de36a33bf7352789cd956 >}}

#### Using XML DataSource

{{< gist GroupDocsGists c7b61f988ec8a61132b5f33b0455c3a7 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 142356d018b504b0e1d50ea9cbd90d40 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List With Alternate Content in Word Processing Document

Path: /assembly/java/in-table-list-with-alternate-content-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList WithAlternateContent report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List With Alternate Content in Microsoft Word Document

### Creating a In-Table List With Alternate Content

Practising the following steps you can create In-Table List With Alternate Content Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2X3 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent your clients and their prices with the following key requirements:

*   Report must show each client along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="571" style="width: 428pt; border-collapse: collapse;"><tbody><tr style="height: 15.75pt;"><td width="380" style="width: 285pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 15.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">Client</span></b></p></td><td width="191" style="width: 143pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 15.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">Contract Price</span></b></p></td></tr><tr style="height: 16.5pt;"><td width="571" colspan="2" style="width: 428pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 16.5pt;"><p class="MsoNormal" align="center" style="margin-bottom: 0.0001pt; text-align: center; line-height: normal;"><b><span style="color: black;">&lt;&lt;if [!getContracts().any()]&gt;&gt;No data</span></b></p></td></tr><tr style="height: 30.75pt;"><td width="380" style="width: 285pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">&lt;&lt;else&gt;&gt;&lt;&lt;foreach [in getContracts()]&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</span></b></p></td><td width="191" style="width: 143pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">&lt;&lt;[getPrice()]&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr style="height: 30.75pt;"><td width="380" style="width: 285pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">Total:</span></b></p></td><td width="191" style="width: 143pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">&lt;&lt;[getContracts().sum(<br>&nbsp; c =&gt; c.getPrice())]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr></tbody></table>

### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/In-Table%20List%20with%20Alternate%20Content.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 53b3177d14f48335422fe6e762e9d57e >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List With Alternate Content in Word Processing Document

Path: /assembly/net/in-table-list-with-alternate-content-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List With Alternate Content report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}

## In-Table List With Alternate Content in Microsoft Word Document

### Creating a In-Table List With Alternate Content

Practicing the following steps you can create In-Table List With Alternate Content Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2X3 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent your products and their prices with the following key requirements:

*   Report must show each product along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td>Products</td>
			<td>Order Price</td>
		</tr>
		<tr align="center">
			<td colspan="2">&lt;&lt;if [!Any()]>>No data</td>
		</tr>
		<tr>
			<td>&lt;&lt;else>>&lt;&lt;foreach [in orders]>><br>&lt;&lt;[Product.ProductName]>></td>
			<td>&lt;&lt;[Price]>>&lt;&lt;/foreach>></td>
		</tr>
		<tr>
			<td>Total:</td>
			<td>&lt;&lt;[Sum(c => c.Price)]>>&lt;&lt;/if>></td>
		</tr>
	</tbody>
</table>

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content.docx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List With Alternate Content\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content_DB.docx?raw=true) (Template for DataBase examples)
*   [In-Table List With Alternate Content\_DS.docx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content_DT.docx?raw=true) (Template for DataSet examples)
*   [In-Table List With Alternate Content\_XML.docx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content_XML.docx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs f626dc3ae330f654a481 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 5ff853b9ae1f50adeef5 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 60dc72a869561606b285 >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 583e9e7adbdf2985ec71 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs db90df496aee126c1db9 >}}

## In-Table List With Alternate Content in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List with Alternate Content' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List With Alternate Content\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content_OpenDocument.odt?raw=true) (use same template for JSON examples)
*   [In-Table List With Alternate Content\_DB\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content_DB_OpenDocument.odt?raw=true)
*   [In-Table List With Alternate Content\_DS\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content_DT_OpenDocument.odt?raw=true)
*   [In-Table List With Alternate Content\_XML\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Alternate%20Content_XML_OpenDocument.odt?raw=true)

### Generating the report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs d4af481bdc81750096c1 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 0a05f8fbca8e3e226d49 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 5e609e88739302d10f7e >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 59333326143ba5180bee >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 4cc6b9bdd03ef2daf75d >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Filtering Grouping and Ordering in Word Processing Document

Path: /assembly/java/in-table-list-with-filtering-grouping-and-ordering-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList with Filtering, Grouping, and Ordering report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Microsoft Word Document

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practicing the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x2 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent managers' contract information with the following key requirements:

*   Report must show each manager along with sum of prices of his contracts.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

| **Manager**                                                  | **Contract Price**                       |
| ------------------------------------------------------------ | ---------------------------------------- |
| **<<foreach [in getContracts()<br />    .where(c => c.getDate().getYear() + 1900 == 2015)<br />    .groupBy(c => c.getManager())<br />    .orderBy(g => g.key.getName())]>><br /><<[key.getName()]>>** | <<[sum(c => c.getPrice())]>><</foreach>> |

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 729c3fe954b072ffea852e64521ecca4 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Filtering Grouping and Ordering in Word Processing Document

Path: /assembly/net/in-table-list-with-filtering-grouping-and-ordering-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List with Filtering, Grouping, and Ordering report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Microsoft Word Document

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practising the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press the "Insert" tab to insert the table.
3.  Insert a 2x2 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with the following key requirements:

*   Report must show each customer along with sum of prices of his orders.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> Price</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">orders</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&nbsp;&nbsp;&nbsp; .</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Where</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">c.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">OrderDate</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Year</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> == </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">2015</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">)</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&nbsp;&nbsp;&nbsp; .</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">GroupBy</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">c.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">)</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&nbsp;&nbsp;&nbsp; .</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">OrderBy</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">(g =&gt; </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">g.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Key</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">)]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Key</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.docx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB.docx?raw=true) (Template for DataSet, DataBase examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_XML.docx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML.docx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 1c97ce506e4b165e9bf131d26d943b8a >}}

#### Database Entities

{{< gist GroupDocsGists 1b4113a3fdc60a346e9fab3ece19ea3a >}}

#### Using DataSet

{{< gist GroupDocsGists 26fe1eeb21bb94d062f3fae206068cdd >}}

#### Using XML DataSource

{{< gist GroupDocsGists 95591cb01f8feeb8318415ba7bf18d4c >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 0ed1c013e8309329e1ee71569a179960 >}}

## In-Table List with Filtering, Grouping, and Ordering in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List with Filtering, Grouping, and Ordering' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List with Filtering, Grouping, and Ordering\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_OpenDocument.odt?raw=true) (use same template for JSON example)
*   [In-Table List with Filtering, Grouping, and Ordering\_DB\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB_OpenDocument.odt?raw=true) (use same template for dataset examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_XML\_OpenDocument.odt](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML_OpenDocument.odt?raw=true)

### Generating the report

#### Custom Objects

{{< gist GroupDocsGists b70e818dbbcf0fa9577e8dd54734fdbe >}}

#### Database Entities

{{< gist GroupDocsGists 24899d1a3827a0d2b9fb0852d768983b >}}

#### Using DataSet

{{< gist GroupDocsGists 4e9929b8e6f24ecf73efb8f430f6e264 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 549f4b28bf37d8538d0d3d62c85edac8 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 6b3952f609dab8283974f13f8a931612 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Highlighted Rows in Word Processing Document

Path: /assembly/java/in-table-list-with-highlighted-rows-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Table Report with Highlighted Rows in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List with Highlighted Rows in Microsoft Word Document

### Creating a In-Table List with Highlighted Rows

Practicing the following steps you can create In-Table List with Highlighted Rows Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Click the cell you want to highlight.
5.  Click "Design" tab, and then select Shading.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show all the client names with price.
*   Show single client and his single contract price in a single row.
*   It must highlight the record with contract price more than or equal to 1000000.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoTableGridLight" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="623" valign="top" style="width: 467.25pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 1pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p><table class="MsoTable15Grid1Light" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>Client</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>Contract Price</b></p></td></tr><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; background-color: rgb(255, 242, 204); background-image: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>&lt;&lt;foreach [in getContracts()]&gt;&gt;&lt;&lt;if [getPrice() &gt;= 1000000]&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; background-color: rgb(255, 242, 204); background-image: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&lt;&lt;[getPrice()]&gt;&gt;</p></td></tr><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>&lt;&lt;else&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&lt;&lt;[getPrice()]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</p></td></tr><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>Total:</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&lt;&lt;[getContracts().sum(</p><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp; c =&gt; c.getPrice())]&gt;&gt;</p></td></tr></tbody></table><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td></tr></tbody></table>
### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we created in this article:

*   [In-Table List with Highlighted Rows.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists a5e01834349c8c1239d377e6e18530d1 >}}



### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Highlighted Rows in Word Processing Document

Path: /assembly/net/in-table-list-with-highlighted-rows-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Table Report with Highlighted Rows in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List with Highlighted Rows in Microsoft Word Document

### Creating a In-Table List with Highlighted Rows

Practising the following steps you can create In-Table List with Highlighted Rows Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Click the cell you want to highlight.
5.  Click "Design" tab, and then select Shading.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with a specific filtering condition with the following key requirements:

*   The report must show each customer along with his orders.
*   Show single Customer and his single order price in a single row.
*   It must highlight the record with order price more than or equal to 400.
*   It must show sum of the order prices.
*   It must represent all the information in tabular form.
*   The report must be generated in the Word Processing Document.  
      
  

{{< alert style="info" >}}See the video demonstration of In-Table List with Highlighted Rows in MS Word [here](https://www.youtube.com/watch?v=3OTxNUFslnI&t=22s&index=12&list=PL25CTxMCj5vOzsaE9Rwjwd4-OwvdaWmJ8).{{< /alert >}}

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> Price</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">orders</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;if [</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Price</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> &gt;= </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">400</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we created in this article:

*   [In-Table List with Highlighted Rows.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows.docx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List with Highlighted Rows\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DB.docx?raw=true) (Template for DataBase examples)
*   [In-Table List with Highlighted Rows\_DT.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DT.docx?raw=true) (Template for DataSet examples)
*   [In-Table List with Highlighted Rows\_XML.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows_XML.docx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 1033c5c1bb8a5471f625c2140105873c >}}

#### Database Entities

{{< gist GroupDocsGists bbe70a3f1788555adf592cc9fc0b311b >}}

#### Using DataSet

{{< gist GroupDocsGists d95bbc65a11583ee65fad4d16fb3af8d >}}

#### Using XML DataSource

{{< gist GroupDocsGists e8e6f9892b0f782b67af404dbaac7be9 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 9be406b730e0e5f1e4737f2cbddb433e >}}

## In-Table List with Highlighted Rows in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List with Highlighted Rows' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List with Highlighted Rows\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows_OpenDocument.odt?raw=true) (use same template for JSON examples)
*   [In-Table List with Highlighted Rows\_DB\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DB_OpenDocument.odt?raw=true)
*   [In-Table List with Highlighted Rows\_DT\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DT_OpenDocument.odt?raw=true)
*   [In-Table List with Highlighted Rows\_XML\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Highlighted%20Rows_XML_OpenDocument.odt?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists d4e522dda6c19bda804d9380dd323d0f >}}

#### Database Entities

{{< gist GroupDocsGists 7d345d02b15969d518a09a358de94e8c >}}

#### Using DataSet

{{< gist GroupDocsGists f702cb4696b6a7389f0f6db8c41a16ad >}}

#### Using XML DataSource

{{< gist GroupDocsGists 4f4cc14d93826cc3fe8e20ab9f638bb0 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 2d25f54dbbb829aab100d6d883fde692 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table Master-Detail in Word Processing Document

Path: /assembly/java/in-table-master-detail-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableMaster-Detail report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in Microsoft Word Document

### Creating a In-Table Master-Detail

Practising the following steps you can create In-Table Master-Detail Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show each manager along with his total contract prices.
*   It must also show each individual client within the contract.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="iksweb">
	<tbody>
		<tr>
      <td><b>Manager/Client</b></td>
      <td><b>Contract Price</b></td>
		</tr>
		<tr>
      <td><b>&lt;&lt;foreach [in getManagers()]>>&lt;&lt;[getName()]>></b></td>
			<td>&lt;&lt;[getContracts().sum(c => c.getPrice())]>></td>
		</tr>
		<tr>
      <td><i>&lt;&lt;foreach [in getContracts()]>><br\>&lt;&lt;[getClient().getName()]>></i></td>
			<td>&lt;&lt;[getPrice()]>>&lt;&lt;/foreach>>&lt;&lt;/foreach>></td>
		</tr>
		<tr>
      <td><b>Total:</b></td>
			<td>&lt;&lt;[getManagers().sum(<br\>  m => m.getContracts().sum(<br\>    c => c.getPrice()))]>></td>
		</tr>
	</tbody>
</table>

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/In-Table%20Master-Detail.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 0a3ab37eccadc39a30691c4a2bc4de4f >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table Master-Detail in Word Processing Document

Path: /assembly/net/in-table-master-detail-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table Master-Detail report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in Microsoft Word Document

### Creating a In-Table Master-Detail

Practising the following steps you can create In-Table Master-Detail Template in MS Word 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' total orders prices and price of each product separately with the following key requirements:

*   A report must show each customer along with his total orders prices.
*   It must also show each individual product ordered by the customers.
*   It must show the sum of the order prices.
*   It must represent all the information in tabular form.
*   A report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> Price</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">customers</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order</span><span style="font-family: Calibri; font-size: 11pt;">.</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-style: italic; font-weight: normal;">&lt;&lt;foreach [in </span><span style="font-family: Calibri; font-size: 11pt; font-style: italic; font-weight: normal;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-style: italic; font-weight: normal;">]&gt;&gt; &lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-style: italic; font-weight: normal;">Product.ProductName</span><span style="font-family: Calibri; font-size: 11pt; font-style: italic; font-weight: normal;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;&lt;&lt;/foreach&gt;&gt;&lt;&lt;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">/foreach&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">m =&gt; m.</span><span style="font-family: Calibri; font-size: 11pt;">Order</span><span style="font-family: Calibri; font-size: 11pt;">.</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail.docx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table Master-Detail\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail_DB.docx?raw=true) (Template for DataBase examples)
*   [In-Table Master-Detail\_DT.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail_DT.docx?raw=true) (Template for DataSet examples)
*   [In-Table Master-Detail\_XML.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail_XML.docx?raw=true) (Template for XML examples)

### Generating The Report 

#### Custom Objects

{{< gist GroupDocsGists 0c9c371de4a0e97f58384c7a3922e1e9 >}}

#### Database Entities

{{< gist GroupDocsGists 69995be149e0ba4df9f772e11ffcd201 >}}

#### Using DataSet

{{< gist GroupDocsGists 1cab3c775fca172a61e5fedf759e98fd >}}

#### Using XML DataSource

{{< gist GroupDocsGists 66346cd4ff23a842584ce3edd2ce6496 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists e466dc482c38d06da8b0232170f07edc >}}

## In-Table Master-Detail in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [Wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table Master-Detail' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table Master-Detail\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail_OpenDocument.odt?raw=true) (use same template for JSON examples)
*   [In-Table Master-Detail\_DB\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail_DB_OpenDocument.odt?raw=true)
*   [In-Table Master-Detail\_DT\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail_DT_OpenDocument.odt?raw=true)
*   [In-Table Master-Detail\_XML\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20Master-Detail_XML_OpenDocument.odt?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 4d9c4fe37f1b1690a0e75d0e61798193 >}}



#### Database Entities

{{< gist GroupDocsGists 522b7dc7c6e244757c90266eb03c61ea >}}



#### Using DataSet

{{< gist GroupDocsGists 91707a723c6fcf87ff7a7a44a535042f >}}



#### Using XML DataSource

{{< gist GroupDocsGists c959d853310470c7b0a2364c0005b1ca >}}



#### Using JSON DataSource

{{< gist GroupDocsGists df00a8418bcc73893339e993881aa0ea >}}



### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Individual Series Point Coloring in Word Processing Document

Path: /assembly/java/individual-series-point-coloring-in-word-processing-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Word Processing Document

Please follow below steps to can create Pie Chart in MS Word 2013.

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "Pie".
3.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/individual-series-point-coloring-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Word Processing Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

|   | Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor [Color] >> |
| --- | --- |
| A | 8.2 |
| B | 3.2 |
| C | 1.5 |
| D | 1.2 |

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Dynamic%20Chart%20Point%20Series%20Color.docx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```java
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists 7717437473f5630cdbe6e7acb93230eb >}}



---

## Individual Series Point Coloring in Word Processing Document

Path: /assembly/net/individual-series-point-coloring-in-word-processing-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Word Processing Document

Please follow below steps to can create Pie Chart in MS Word 2013.

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "Pie".
3.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/individual-series-point-coloring-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine)
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Word Processing Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

|   | Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor [Color] >> |
| --- | --- |
| A | 8.2 |
| B | 3.2 |
| C | 1.5 |
| D | 1.2 |

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Chart%20Point%20Series%20Color.docx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```csharp
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists fb1400ea59b283001465944f5a2780d8 >}}



---

## Inserting Bookmarks Dynamically

Path: /assembly/java/inserting-bookmarks-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.3 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Inserting Hyperlinks Dynamically

### Dynamic insertion of bookmarks for Word Processing documents and emails with HTML and RTF bodies

You can insert bookmarks to your reports dynamically using bookmark tags. Syntax of a bookmark tag is defined as follows.

```java
<<bookmark [bookmark_expression]>>
bookmarked_content
<</bookmark>>
```

Here, **bookmark\_expression** defines the name of a bookmark to be inserted during run-time. This expression is mandatory and must return a non-empty value. While building a report, **bookmark\_expression** is evaluated and its result is used to construct a bookmark start and end that replace corresponding opening and closing bookmark tags respectively.

{{< alert style="warning" >}}A bookmark tag cannot be used within a chart.{{< /alert >}}

The following code snippet shows how simple you call the document assembler to generate report from the template:

{{< gist GroupDocsGists ecbe5e7331f08a3f0bccd81a1ef57995 dynamicBookmarkInsertionWord_20.3.java >}}

### Dynamic naming of cell ranges for Spreadsheet documents

Template syntax and usage of Document Assembler is same as above section for dynamic naming of cell ranges for Spreadsheet documents. The difference is that it results to insertion of named cell ranges instead of bookmarks.

#### Download Templates

*   [Dynamic Bookmarks.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Hyperlink.docx)
*   [Dynamic Cell Ranges.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Hyperlink.docx)

---

## Inserting Bookmarks Dynamically

Path: /assembly/net/inserting-bookmarks-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.1 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Inserting Hyperlinks Dynamically

### Dynamic insertion of bookmarks for Word Processing documents and emails with HTML and RTF bodies

You can insert bookmarks to your reports dynamically using bookmark tags. Syntax of a bookmark tag is defined as follows.

```csharp
<<bookmark [bookmark_expression]>>
bookmarked_content
<</bookmark>>
```

Here, **bookmark\_expression** defines the name of a bookmark to be inserted during run-time. This expression is mandatory and must return a non-empty value. While building a report, **bookmark\_expression** is evaluated and its result is used to construct a bookmark start and end that replace corresponding opening and closing bookmark tags respectively.

{{< alert style="warning" >}}A bookmark tag cannot be used within a chart.{{< /alert >}}

The following code snippet shows how simple you call the document assembler to generate report from the template:

{{< gist GroupDocsGists fe5688b6d99e17223084d5098e9324fa DynamicBookmarkInsertionWord.cs >}}

### Dynamic naming of cell ranges for Spreadsheet documents

Template syntax and usage of Document Assembler is same as above section for dynamic naming of cell ranges for Spreadsheet documents. The difference is that it results to insertion of named cell ranges instead of bookmarks.

### Download Templates

*   [Dynamic Bookmarks.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Hyperlink.docx)
*   [Dynamic Cell Ranges.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Hyperlink.docx)

---

## Inserting edited slide into existing presentation

Path: /editor/java/inserting-edited-slide-into-existing-presentation/

By default the full presentation editing pipeline (cycle) is the next:

1. Load presentation in a form of a file or stream into constructor of the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class.
2. Select a specific slide to edit and specify its index in the [getSlideNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions#getSlideNumber--) property of [PresentationEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions) class.
3. Open presentation for editing by calling [Editor.edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#edit--) method, passing [PresentationEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions) instance with selected slide into it, and obtaining [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance from this method.
4. Emitting HTML and CSS markup, which represents a content of an edited document, from [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, using different methods like [getContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getContent--).
5. Passing this HTML and CSS markup into the WYSIWYG editor, which is located on client-side and is running in the browser.
6. End-user edits the document content in the WYSIWYG editor.
7. Edited document content, in form of HTML and CSS markup, is passed back to the server-side.
8. Then this content is passed into the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class, by using the [fromFile()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromFile-java.lang.String-java.lang.String-), [fromMarkup()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkup-java.lang.String-java.util.List-com.groupdocs.editor.htmlcss.resources.IHtmlResource--), or [fromBodyMarkupAndResourceFolder()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkupAndResourceFolder-java.lang.String-java.lang.String-) static methods.
9. Created [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, which holds an edited document content, is passed into the [Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#save(java.lang.String)) method.
10. [Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#save(java.lang.String)) method generates a new presentation, which contains only one single slide — those slide, that was edited on the client-side and which content was passed via [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class into this method.

Before GroupDocs.Editor version 20.11 this was the only pipeline, accessible for the customer.

Starting from version 20.11, the 10th step of described pipeline can be altered — edited slide can be inserted into original presentation, which was loaded on the 1st step.

[PresentationSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions) class now contains two new properties: integer [getSlideNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions#getSlideNumber--) and boolean flag [setInsertAsNewSlide()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions#setInsertAsNewSlide-boolean-). Both of them have "usual" default values: [getSlideNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions#getSlideNumber--) has '0' and [getInsertAsNewSlide()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions#setInsertAsNewSlide-boolean-) is set to 'false'.

```java
public int getSlideNumber() {}
public setSlideNumber() {}
public boolean getInsertAsNewSlide() {}
public setInsertAsNewSlide() {}
```

By default, when these properties are not touched or at least [getSlideNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions#getSlideNumber--) has a default value '0', GroupDocs.Editor will generate new single-slide presentation, as in previous versions. However, if [getSlideNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions#getSlideNumber--) property contains number, distinct from '0', and valid presentation is loaded into [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class (it is expected to be the original presentation, which was edited, but it actually can be any presentation, even those, which has no relation to the original), then edited slide will be **inserted** into given presentation.

## SlideNumber property

[getSlideNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions#getSlideNumber--) property, if it is not zero, defines, *where*, at *which exact position* in the given presentation the new edited slide should be inserted. `InsertAsNewSlide` parameter, which is a boolean flag, determines, *how* this slide should be inserted: should it *replace* the existing slide, that is located on specified position ('`false'`, default value), or it should be *injected between* existing slides, without rewriting them, and thus increasing the total amount of slides in the given presentation by one.

Because default '`0`' value of `SlideNumber` parameter is reserved, actual slide numbering starts from `1`. This is different from widely used 0-based indexing, however, makes sense, thus it is not an *index* of a slide, but rather *number* of a slide, the same as MS PowerPoint uses, for instance. This means that, for example, for given presentation, that consists of 5 slides, 1st one has a '`1`' slide number, and 5th — '`5`'. If user has specified a slide number, which exceeds the total amount of slides in presentation, this number will be automatically adjusted to the latest. This means that if, for example, for the same 5-slide presentation user will specify a '`6`', '`7`' or even '`Int`', it will be internally set a '`5`' — number of the latest slide.

Along with positive slide numbers, the `SlideNumber` property also supports negative numbering, which implies count from the end of presentation. In this case, '-1' is treated as the last slide, '-2' — the last but one, and so on. Again, like with positive numbering, in case when number exceeds the amount of slides, it will be adjusted to the closest — first slide for negative numbers.

Part of source code below explains this numbering system:

```java
PresentationSaveOptions saveOptions = new PresentationSaveOptions(PresentationFormats.Pptx)

//let's say we have presentation with 5 slides

saveOptions.setSlideNumber(0);  // default value, given presentation will be ignored

//positive numbering
saveOptions.setSlideNumber(1);  // first slide
saveOptions.setSlideNumber(2);  // second slide 
saveOptions.setSlideNumber(3);  // third slide 
saveOptions.setSlideNumber(4);  // fourth slide 
saveOptions.setSlideNumber(5);  // fifth slide 
saveOptions.setSlideNumber(6);  // fifth slide, because value '6' exceeds the slides amount '5' and thus is adjusted to the closest

//negative numbering
saveOptions.setSlideNumber(-1);  // fifth slide, which is first from end (last)
saveOptions.setSlideNumber(-2);  // fourth slide, which is second from end (last but one)
saveOptions.setSlideNumber(-3);  // third slide, which is third from end
saveOptions.setSlideNumber(-4);  // second slide, which is fourth from end
saveOptions.setSlideNumber(-5);  // first slide, which is fifth from end
saveOptions.setSlideNumber(-6);  // first slide, because value '-6' exceeds the slides amount '5' and thus is adjusted to the closest
```

## InsertAsNewSlide property

[getInsertAsNewSlide()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions#getInsertAsNewSlide--) property complements the previously described [getSlideNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions#getSlideNumber--) property and is ignored, when `SlideNumber` is set to '`0`'. If `SlideNumber` points on the slide of specific number,  [getInsertAsNewSlide()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions#getInsertAsNewSlide--) determines how to treat this slide number and how to insert the slide:

* If  [getInsertAsNewSlide()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions#getInsertAsNewSlide--)  property has default '`false`' value, the existing slide in given presentation will be completely erased, and the content of the new slide (which is located in the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance) will be putted on this place. As a result, presentation will preserve the same untouched amount of slides, but one of its slides (specified by the `SlideNumber`) will be replaced onto new one.
* If [getInsertAsNewSlide()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions#getInsertAsNewSlide--) property has '`true`' value, the edited slide, obtained from [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, will be injected among existing slides in given presentation, so its amount of slides will be incremented by one. New slide is inserted at position, specified by `SlideNumber`, and all subsequent slides (following or preceding) will be shifted to the end or to the beginning accordingly, depending on positive or negative numbering.

Source code below shows, how slide number is treated when `InsertAsNewSlide` property is enabled:

```java
PresentationSaveOptions saveOptions = new PresentationSaveOptions(PresentationFormats.Pptx)

//let's say we have presentation with 5 slides
saveOptions.setSlideNumber(0);  // default value, given presentation will be ignored, as well as InsertAsNewSlide
saveOptions.setInsertAsNewSlide(true);//

//positive numbering
saveOptions.setSlideNumber(1);  // new slide is injected as first, while all following (including 'old' 1st) are shifting to the end
saveOptions.setSlideNumber(2);  // new slide is injected as second, while 2nd, 3rh, 4th and 5th are shifting to the end
saveOptions.setSlideNumber(3);  // new slide is injected as third, while 3rh, 4th and 5th are shifting to the end
saveOptions.setSlideNumber(4);  // new slide is injected as fourth, while 4th and 5th are shifting to the end
saveOptions.setSlideNumber(5);  // new slide is injected as fifth, while 5th is shifting to the end and becomes 6th
saveOptions.setSlideNumber(6);  // new slide is injected as sixth, it already becomes the latest, none of existing slides are shifthing to the end
saveOptions.setSlideNumber(7);  // same as previous

//negative numbering
saveOptions.setSlideNumber(-1);  // new slide is inject as first from end (it becomes sixth if starting from beginning), none of existing slides are shifthing to the end
saveOptions.setSlideNumber(-2);  // new slide is inject as second from end (it becomes fifth if starting from beginning), following single slide is shifting to the end
saveOptions.setSlideNumber(-3);  // new slide is inject as third from end (it becomes fourth if starting from beginning), two following slides are shifting to the end
saveOptions.setSlideNumber(-4);  // new slide is inject as fourth from end (it becomes third if starting from beginning), three following slides are shifting to the end
saveOptions.setSlideNumber(-5);  // new slide is inject as fifth from end (it becomes second if starting from beginning), four following slides are shifting to the end
saveOptions.setSlideNumber(-6);  // new slide is inject as sixth from end (it becomes first if starting from beginning), five following slides are shifting to the end
saveOptions.setSlideNumber(-7);  // same as previous
```

---

## Inserting edited slide into existing presentation in Node.js and Java

Path: /editor/nodejs-java/inserting-edited-slide-into-existing-presentation/



## Introduction

GroupDocs.Editor for Node.js allows users to insert an edited slide into the original presentation, rather than creating a new presentation with only the edited slide. This updated functionality enhances the default editing process, which consists of the following steps:

1. Load a presentation from a file or stream into the `Editor` class.
2. Select a specific slide to edit by specifying its index in the `PresentationEditOptions`.
3. Open the presentation for editing with `Editor.edit()` and obtain an `EditableDocument` instance.
4. Extract HTML and CSS content from the `EditableDocument`.
5. Pass this content to a WYSIWYG editor on the client-side.
6. The end-user edits the content within the WYSIWYG editor.
7. The edited HTML and CSS content is sent back to the server.
8. Recreate an `EditableDocument` instance with the edited content using the `EditableDocument.fromMarkup()` method.
9. Pass the `EditableDocument` instance to the `Editor.save()` method.
10. In earlier versions, the `Editor.save()` method would generate a new presentation with just the edited slide. Starting from version 20.11, the edited slide can be inserted into the original presentation instead.

### PresentationSaveOptions

The `PresentationSaveOptions` class includes two key properties:

- `slideNumber`: Specifies the position where the edited slide should be inserted or replaced.
- `insertAsNewSlide`: A boolean flag that determines whether the edited slide should replace an existing slide or be inserted as a new one.

Here’s how these properties work in Node.js:

```javascript
let saveOptions = new groupdocs.options.PresentationSaveOptions();
saveOptions.slideNumber = 2;  // Inserts or replaces at the second slide position
saveOptions.insertAsNewSlide = true;  // Inserts a new slide, rather than replacing
```

### SlideNumber Property

The `slideNumber` property specifies where the new edited slide will be inserted. If set to `0`, a new single-slide presentation will be created. Slide numbering starts from `1`, similar to how Microsoft PowerPoint numbers slides. If the slide number exceeds the total number of slides, the new slide will be inserted at the last position.

Both positive and negative values are supported:

- Positive values count from the beginning of the presentation (1-based).
- Negative values count from the end of the presentation (`-1` for the last slide, `-2` for the second to last, etc.).

Here’s how to use the `slideNumber` property in Node.js:

```javascript
let saveOptions = new groupdocs.options.PresentationSaveOptions();
saveOptions.slideNumber = 1;  // Insert at the first slide position
saveOptions.slideNumber = -1; // Insert as the last slide
```

### InsertAsNewSlide Property

The `insertAsNewSlide` property determines whether the edited slide should be inserted as a new slide or replace the existing slide at the specified position:

- `false` (default): The existing slide at the `slideNumber` position will be replaced by the edited slide.
- `true`: The edited slide will be inserted as a new slide, pushing subsequent slides to the next positions.

#### Example in Node.js:

```javascript
saveOptions.insertAsNewSlide = true;  // Insert the slide as a new slide
```

### Example Code for Node.js

The following example demonstrates how to insert an edited slide into an existing presentation using Node.js:

```javascript
const groupdocs = require('groupdocs-editor');

// Load the presentation
const editor = new groupdocs.Editor('path/to/presentation.pptx');

// Get the editable document for the second slide
const presentationEditOptions = new groupdocs.options.PresentationEditOptions();
presentationEditOptions.slideNumber = 1;
const editableDocument = editor.edit(presentationEditOptions);

// Get the edited content from a WYSIWYG editor (mockup example)
const editedContent = '<html>...edited content...</html>';

// Recreate the editable document from the edited markup
const updatedDocument = groupdocs.EditableDocument.fromMarkup(editedContent, []);

// Save the edited slide and insert it as a new slide
const saveOptions = new groupdocs.options.PresentationSaveOptions();
saveOptions.slideNumber = 2;
saveOptions.insertAsNewSlide = true;

editor.save(updatedDocument, 'path/to/updated_presentation.pptx', saveOptions);
```

---

## Inserting edited worksheet into existing spreadsheet

Path: /editor/java/inserting-edited-worksheet-into-existing-spreadsheet/

By default and from the moment when a Spreadsheet module was released to public, the full spreadsheet editing pipeline was the next:

1. Loading spreadsheet in a form of a file or stream into constructor of the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class.
2. Selecting a specific worksheet to edit and specifying its index in the [getWorksheetIndex()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheeteditoptions/#getWorksheetIndex()) property of [SpreadsheetEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheeteditoptions) class.
3. Opening a spreadsheet for editing by calling [Editor.edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#edit--) method, passing [SpreadsheetEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheeteditoptions) instance with selected worksheet into it, and obtaining [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance from this method.
4. Emitting HTML and CSS markup, which represents a content of an edited document, from [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, using different methods like [getContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getContent--).
5. Passing this HTML and CSS markup into the WYSIWYG editor, which is located on client-side and is running in the browser.
6. End-user edits the document content in the WYSIWYG editor.
7. Edited document content, in form of HTML and CSS markup, is passed back to the server-side.
8. Creating a new instance of the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class by passing the edited content, obtained from server, into the [fromFile()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromFile-java.lang.String-java.lang.String-), [fromMarkup()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkup-java.lang.String-java.util.List-com.groupdocs.editor.htmlcss.resources.IHtmlResource--), or [fromMarkupAndResourceFolder()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkupAndResourceFolder-java.lang.String-java.lang.String-) static methods (depending from content).
9. Creating an instance of [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) class with format of output spreadsheet file.
10. Calling an [Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method by passing the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), output stream for the document, and a [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) options, into it. This will generate a new spreadsheet, which contains only one single worksheet — those worksheet, that was edited on the client-side and which content was passed via [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class into this method.

Before GroupDocs.Editor version 20.11 this was the only pipeline, accessible for the customer.

Starting from the version 20.11, the last 10th step can be altered — edited worksheet can be inserted into original spreadsheet, which was loaded on the 1st step.

[SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) class now contains two new properties: integer [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) and boolean flag [getInsertAsNewWorksheet()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getInsertAsNewWorksheet--). Both of them have "usual" default values: `getWorksheetNumber()` has `0` and `getInsertAsNewWorksheet()` is set to `false`.

```java
public int getWorksheetNumber() { get; set; }
public boolean getInsertAsNewWorksheet() { get; set; }
```

By default, when these properties are not touched or at least [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) has a default value '0', the GroupDocs.Editor will generate new single-worksheet spreadsheet, as in previous versions. However, if [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) property contains number, distinct from '0', and valid spreadsheet is loaded into [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class (it is expected to be the original spreadsheet, which was edited, but it actually can be any spreadsheet, even those, which has no relation to the original), then edited worksheet will be **inserted** into given spreadsheet.

## WorksheetNumber property

[getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) property, if it is not a zero, defines, where, at which exact position in the given spreadsheet the new edited worksheet should be inserted. [getInsertAsNewWorksheet()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getInsertAsNewWorksheet--) parameter, which is a boolean flag, determines, how this worksheet should be inserted: should it replace the existing worksheet, that is located on specified position ('false', default value), or it should be injected between existing worksheets, without rewriting them, and thus increasing the total amount of worksheets in the given spreadsheet by one.

Because default `0` value of [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) parameter is reserved, actual worksheet numbering starts from `1`. This is different from widely used 0-based indexing, however, makes sense, thus it is not an index of a worksheet, but rather number of a worksheet, the same as MS Excel uses, for instance. This means that, for example, for given spreadsheet, that consists of 5 worksheets, 1st one has a '1' worksheet number, and 5th — `5`. If user has specified a worksheet number, which exceeds the total amount of worksheets in spreadsheet, this number will be automatically adjusted to the latest. This means that if, for example, for the same 5-worksheet spreadsheet the user will specify a '6', '7' or even 'Int32.MaxValue', it will be internally set a `5` — number of the latest worksheet.

Along with positive worksheet numbers, the [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) property also supports negative numbering, which implies count from the end of spreadsheet. In this case, `-1` is treated as the last worksheet, `-2` — the last but one, and so on. Again, like with positive numbering, in case when number exceeds the amount of worksheets, it will be adjusted to the closest — first worksheet for negative numbers.

Part of source code below explains this numbering system:

```java
SpreadsheetSaveOptions saveOptions = new SpreadsheetSaveOptions(Formats.SpreadsheetFormats.Xlsx)
  
//let's say we have a spreadsheet with 5 worksheets
  
saveOptions.setWorksheetNumber(0);  // default value, given spreadsheet will be ignored and new will be created
  
//positive numbering
saveOptions.setWorksheetNumber(1);  // first worksheet
saveOptions.setWorksheetNumber(2);  // second worksheet
saveOptions.setWorksheetNumber(3);  // third worksheet
saveOptions.setWorksheetNumber(4);  // fourth worksheet
saveOptions.setWorksheetNumber(5);  // fifth worksheet
saveOptions.setWorksheetNumber(6);  // fifth worksheet, because value '6' exceeds the worksheets amount '5' and thus is adjusted to the closest
  
//negative numbering
saveOptions.setWorksheetNumber(-1);  // fifth worksheet, which is first from end (last)
saveOptions.setWorksheetNumber(-2);  // fourth worksheet, which is second from end (last but one)
saveOptions.setWorksheetNumber(-3);  // third worksheet, which is third from end
saveOptions.setWorksheetNumber(-4);  // second worksheet, which is fourth from end
saveOptions.setWorksheetNumber(-5);  // first worksheet, which is fifth from end
saveOptions.setWorksheetNumber(-6);  // first worksheet, because value '-6' exceeds the worksheets amount '5' and thus is adjusted to the closest
```

## InsertAsNewWorksheet property

[getInsertAsNewWorksheet()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getInsertAsNewWorksheet--)  property complements the previously described [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) property and is ignored, when [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) is set to `0`. If [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--) points on the worksheet of specific number, the [getInsertAsNewWorksheet()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getInsertAsNewWorksheet--) determines how to treat this worksheet number and how to insert the worksheet:

* [getInsertAsNewWorksheet()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getInsertAsNewWorksheet--) property has default 'false' value, the existing worksheet in given spreadsheet will be completely erased, and the content of the new worksheet (which is located in the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance) will be putted on this place. As a result, a spreadsheet will preserve the same untouched amount of worksheets, but one of its worksheets (specified by the [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--)) will be replaced onto new one.
* If [getInsertAsNewWorksheet()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getInsertAsNewWorksheet--) property has 'true' value, the edited worksheet, obtained from [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, will be injected among existing worksheets in given spreadsheet, so its amount of worksheets will be incremented by one. New worksheet is inserted at position, specified by [getWorksheetNumber()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--), and all subsequent worksheets (following or preceding) will be shifted to the end or to the beginning accordingly, depending on positive or negative numbering.

Source code below shows, how worksheet number is treated when [getInsertAsNewWorksheet()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getInsertAsNewWorksheet--) property is enabled:

```java
SpreadsheetSaveOptions saveOptions = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx)
  
//let's say we have a spreadsheet with 5 worksheets
  
saveOptions.setWorksheetNumber(0);  // default value, given spreadsheet will be ignored, as well as InsertAsNewWorksheet
  
saveOptions.setInsertAsNewWorksheet(true);  //enabling the adding of worksheet instead of replacing
  
//positive numbering
saveOptions.setWorksheetNumber(1);  // new worksheet is injected as first, while all following (including 'old' 1st) are shifting to the end
saveOptions.setWorksheetNumber(2);  // new worksheet is injected as second, while 2nd, 3rh, 4th and 5th are shifting to the end
saveOptions.setWorksheetNumber(3);  // new worksheet is injected as third, while 3rh, 4th and 5th are shifting to the end
saveOptions.setWorksheetNumber(4);  // new worksheet is injected as fourth, while 4th and 5th are shifting to the end
saveOptions.setWorksheetNumber(5);  // new worksheet is injected as fifth, while 5th is shifting to the end and becomes 6th
saveOptions.setWorksheetNumber(6);  // new worksheet is injected as sixth, it already becomes the latest, none of existing worksheets are shifting to the end
saveOptions.setWorksheetNumber(7);  // same as previous
  
//negative numbering
saveOptions.setWorksheetNumber(-1);  // new worksheet is inject as first from end (it becomes sixth if starting from beginning), none of existing worksheets are shifting to the end
saveOptions.setWorksheetNumber(-2);  // new worksheet is inject as second from end (it becomes fifth if starting from beginning), following single worksheet is shifting to the end
saveOptions.setWorksheetNumber(-3);  // new worksheet is inject as third from end (it becomes fourth if starting from beginning), two following worksheets are shifting to the end
saveOptions.setWorksheetNumber(-4);  // new worksheet is inject as fourth from end (it becomes third if starting from beginning), three following worksheets are shifting to the end
saveOptions.setWorksheetNumber(-5);  // new worksheet is inject as fifth from end (it becomes second if starting from beginning), four following worksheets are shifting to the end
saveOptions.setWorksheetNumber(-6);  // new worksheet is inject as sixth from end (it becomes first if starting from beginning), five following worksheets are shifting to the end
saveOptions.setWorksheetNumber(-7);  // same as previous
```

### Additional notes

It is worth mentioning that the described new feature doesn't modify the original spreadsheet document, which was originally loaded into the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class through its constructor. When saving a spreadsheet and inserting the edited worksheet into existing spreadsheet, the GroupDocs.Editor creates a full and exact copy of the original document, and only then adds or replaces the worksheet onto the edited. So the original document is not touched in any case.

From this point it is clear that the GroupDocs.Editor cannot insert edited worksheet into existing spreadsheet document, if this document is not available. For example, original spreadsheet document was loaded into the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class, then opened for edit and stored somewhere for consequent editing. Then, in order to create an output spreadsheet from edited document, a new [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) instance was created from another document. In such case, if new loaded document is not a spreadsheet, the feature with inserting a worksheet will not work (because there is no source, into which the worksheet can be inserted). Also this means that for such scenario the "output" source spreadsheet may not be the same document as the "original" source spreadsheet. For example, it is absolutely legal and working scenario, when user initially loads a spreadsheet named "A" into the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class, edits (let's say) 2nd worksheet from it, then creates a new instance of the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class and loads another spreadsheet named "B" into it, and finally creates an output document from "B", where edited worksheet is injected on 5th position.

[SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) class contains properties for protecting a worksheet from editing: [getPassword()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getPassword--) and [getWorksheetProtection()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#getWorksheetNumber--). When this options are applied and inserting an edited worksheet into existing spreadsheet is applied too, the worksheet protection is applied only to the edited worksheet, which is inserting, — all other worksheets are untouched.

---

## Inserting edited worksheet into existing spreadsheet

Path: /editor/net/inserting-edited-worksheet-into-existing-spreadsheet/

By default and from the moment when a Spreadsheet module was released to public, the full spreadsheet editing pipeline was the next:

1. Loading spreadsheet in a form of a file or stream into constructor of the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class.
2. Selecting a specific worksheet to edit and specifying its index in the [WorksheetIndex](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheeteditoptions/worksheetindex) property of [SpreadsheetEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheeteditoptions) class.
3. Opening a spreadsheet for editing by calling [Editor.Edit()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method, passing [SpreadsheetEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheeteditoptions) instance with selected worksheet into it, and obtaining [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance from this method.
4. Emitting HTML and CSS markup, which represents a content of an edited document, from [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, using different methods like [GetContent()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcontent).
5. Passing this HTML and CSS markup into the WYSIWYG editor, which is located on client-side and is running in the browser.
6. End-user edits the document content in the WYSIWYG editor.
7. Edited document content, in form of HTML and CSS markup, is passed back to the server-side.
8. Creating a new instance of the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class by passing the edited content, obtained from server, into the [FromFile](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fromfile), [FromMarkup](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkup), or [FromBodyMarkupAndResourceFolder](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder/) static methods (depending from content).
9. Creating an instance of [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) class with format of output spreadsheet file.
10. Calling an [Editor.Save](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method by passing the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), output stream for the document, and a [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) options, into it. This will generate a new spreadsheet, which contains only one single worksheet — those worksheet, that was edited on the client-side and which content was passed via [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class into this method.

Before GroupDocs.Editor version 20.10 this was the only pipeline, accessible for the customer.

Starting from the version 20.10, the last 10th step can be altered — edited worksheet can be inserted into original spreadsheet, which was loaded on the 1st step.

[SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) class now contains two new properties: integer [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) and boolean flag [InsertAsNewWorksheet](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/). Both of them have "usual" default values: `WorksheetNumber` has `0` and `InsertAsNewWorksheet` is set to `false`.

```csharp
public int WorksheetNumber { get; set; }
public bool InsertAsNewWorksheet { get; set; }
```

By default, when these properties are not touched or at least [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) has a default value '0', the GroupDocs.Editor will generate new single-worksheet spreadsheet, as in previous versions. However, if [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property contains number, distinct from '0', and valid spreadsheet is loaded into [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class (it is expected to be the original spreadsheet, which was edited, but it actually can be any spreadsheet, even those, which has no relation to the original), then edited worksheet will be **inserted** into given spreadsheet.

## WorksheetNumber property

[WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property, if it is not a zero, defines, where, at which exact position in the given spreadsheet the new edited worksheet should be inserted. [InsertAsNewWorksheet](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/) parameter, which is a boolean flag, determines, how this worksheet should be inserted: should it replace the existing worksheet, that is located on specified position ('false', default value), or it should be injected between existing worksheets, without rewriting them, and thus increasing the total amount of worksheets in the given spreadsheet by one.

Because default `0` value of [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) parameter is reserved, actual worksheet numbering starts from `1`. This is different from widely used 0-based indexing, however, makes sense, thus it is not an index of a worksheet, but rather number of a worksheet, the same as MS Excel uses, for instance. This means that, for example, for given spreadsheet, that consists of 5 worksheets, 1st one has a '1' worksheet number, and 5th — `5`. If user has specified a worksheet number, which exceeds the total amount of worksheets in spreadsheet, this number will be automatically adjusted to the latest. This means that if, for example, for the same 5-worksheet spreadsheet the user will specify a '6', '7' or even 'Int32.MaxValue', it will be internally set a `5` — number of the latest worksheet.

Along with positive worksheet numbers, the [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property also supports negative numbering, which implies count from the end of spreadsheet. In this case, `-1` is treated as the last worksheet, `-2` — the last but one, and so on. Again, like with positive numbering, in case when number exceeds the amount of worksheets, it will be adjusted to the closest — first worksheet for negative numbers.

Part of source code below explains this numbering system:

```csharp
SpreadsheetSaveOptions saveOptions = new SpreadsheetSaveOptions(Formats.SpreadsheetFormats.Xlsx)
  
//let's say we have a spreadsheet with 5 worksheets
  
saveOptions.WorksheetNumber = 0;  // default value, given spreadsheet will be ignored and new will be created
  
//positive numbering
saveOptions.WorksheetNumber =  1;  // first worksheet
saveOptions.WorksheetNumber =  2;  // second worksheet
saveOptions.WorksheetNumber =  3;  // third worksheet
saveOptions.WorksheetNumber =  4;  // fourth worksheet
saveOptions.WorksheetNumber =  5;  // fifth worksheet
saveOptions.WorksheetNumber =  6;  // fifth worksheet, because value '6' exceeds the worksheets amount '5' and thus is adjusted to the closest
  
//negative numbering
saveOptions.WorksheetNumber = -1;  // fifth worksheet, which is first from end (last)
saveOptions.WorksheetNumber = -2;  // fourth worksheet, which is second from end (last but one)
saveOptions.WorksheetNumber = -3;  // third worksheet, which is third from end
saveOptions.WorksheetNumber = -4;  // second worksheet, which is fourth from end
saveOptions.WorksheetNumber = -5;  // first worksheet, which is fifth from end
saveOptions.WorksheetNumber = -6;  // first worksheet, because value '-6' exceeds the worksheets amount '5' and thus is adjusted to the closest
```

## InsertAsNewWorksheet property

[InsertAsNewWorksheet](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/)  property complements the previously described [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property and is ignored, when [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) is set to `0`. If [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) points on the worksheet of specific number, the [InsertAsNewWorksheet](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/) determines how to treat this worksheet number and how to insert the worksheet:

* [InsertAsNewWorksheet](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/) property has default 'false' value, the existing worksheet in given spreadsheet will be completely erased, and the content of the new worksheet (which is located in the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance) will be putted on this place. As a result, a spreadsheet will preserve the same untouched amount of worksheets, but one of its worksheets (specified by the [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber)) will be replaced onto new one.
* If [InsertAsNewWorksheet](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/) property has 'true' value, the edited worksheet, obtained from [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, will be injected among existing worksheets in given spreadsheet, so its amount of worksheets will be incremented by one. New worksheet is inserted at position, specified by [WorksheetNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber), and all subsequent worksheets (following or preceding) will be shifted to the end or to the beginning accordingly, depending on positive or negative numbering.

Source code below shows, how worksheet number is treated when [InsertAsNewWorksheet](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/) property is enabled:

```csharp
SpreadsheetSaveOptions saveOptions = new SpreadsheetSaveOptions(Formats.SpreadsheetFormats.Xlsx)
  
//let's say we have a spreadsheet with 5 worksheets
  
saveOptions.WorksheetNumber = 0;  // default value, given spreadsheet will be ignored, as well as InsertAsNewWorksheet
  
saveOptions.InsertAsNewWorksheet = true;//enabling the adding of worksheet instead of replacing
  
//positive numbering
saveOptions.WorksheetNumber =  1;  // new worksheet is injected as first, while all following (including 'old' 1st) are shifting to the end
saveOptions.WorksheetNumber =  2;  // new worksheet is injected as second, while 2nd, 3rh, 4th and 5th are shifting to the end
saveOptions.WorksheetNumber =  3;  // new worksheet is injected as third, while 3rh, 4th and 5th are shifting to the end
saveOptions.WorksheetNumber =  4;  // new worksheet is injected as fourth, while 4th and 5th are shifting to the end
saveOptions.WorksheetNumber =  5;  // new worksheet is injected as fifth, while 5th is shifting to the end and becomes 6th
saveOptions.WorksheetNumber =  6;  // new worksheet is injected as sixth, it already becomes the latest, none of existing worksheets are shifting to the end
saveOptions.WorksheetNumber =  7;  // same as previous
  
//negative numbering
saveOptions.WorksheetNumber = -1;  // new worksheet is inject as first from end (it becomes sixth if starting from beginning), none of existing worksheets are shifting to the end
saveOptions.WorksheetNumber = -2;  // new worksheet is inject as second from end (it becomes fifth if starting from beginning), following single worksheet is shifting to the end
saveOptions.WorksheetNumber = -3;  // new worksheet is inject as third from end (it becomes fourth if starting from beginning), two following worksheets are shifting to the end
saveOptions.WorksheetNumber = -4;  // new worksheet is inject as fourth from end (it becomes third if starting from beginning), three following worksheets are shifting to the end
saveOptions.WorksheetNumber = -5;  // new worksheet is inject as fifth from end (it becomes second if starting from beginning), four following worksheets are shifting to the end
saveOptions.WorksheetNumber = -6;  // new worksheet is inject as sixth from end (it becomes first if starting from beginning), five following worksheets are shifting to the end
saveOptions.WorksheetNumber = -7;  // same as previous
```

### Additional notes

It is worth mentioning that the described new feature doesn't modify the original spreadsheet document, which was originally loaded into the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class through its constructor. When saving a spreadsheet and inserting the edited worksheet into existing spreadsheet, the GroupDocs.Editor creates a full and exact copy of the original document, and only then adds or replaces the worksheet onto the edited. So the original document is not touched in any case.

From this point it is clear that the GroupDocs.Editor cannot insert edited worksheet into existing spreadsheet document, if this document is not available. For example, original spreadsheet document was loaded into the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class, then opened for edit and stored somewhere for consequent editing. Then, in order to create an output spreadsheet from edited document, a new [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance was created from another document. In such case, if new loaded document is not a spreadsheet, the feature with inserting a worksheet will not work (because there is no source, into which the worksheet can be inserted). Also this means that for such scenario the "output" source spreadsheet may not be the same document as the "original" source spreadsheet. For example, it is absolutely legal and working scenario, when user initially loads a spreadsheet named "A" into the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class, edits (let's say) 2nd worksheet from it, then creates a new instance of the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class and loads another spreadsheet named "B" into it, and finally creates an output document from "B", where edited worksheet is injected on 5th position.

[SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) class contains properties for protecting a worksheet from editing: [Password](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/password) and [WorksheetProtection](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetprotection). When this options are applied and inserting an edited worksheet into existing spreadsheet is applied too, the worksheet protection is applied only to the edited worksheet, which is inserting, — all other worksheets are untouched.

---

## Inserting edited worksheet into existing spreadsheet in Node.js

Path: /editor/nodejs-java/inserting-edited-worksheet-into-existing-spreadsheet/


## Overview

Starting from version 24.6, GroupDocs.Editor for Node.js introduces the ability to insert an edited worksheet into an existing spreadsheet, changing the default behavior of overwriting the entire workbook with a new single worksheet. This feature provides more flexibility in managing Excel spreadsheets when editing individual worksheets.

### Default Editing Pipeline

the typical workflow for editing a spreadsheet was:

1. Load the spreadsheet into the `Editor` class using a file or stream.
2. Specify the worksheet to edit by setting its index in the `SpreadsheetEditOptions`.
3. Use the `Editor.edit()` method to get the `EditableDocument` containing the HTML and CSS representation of the selected worksheet.
4. Send the HTML/CSS content to a client-side WYSIWYG editor.
5. Once editing is complete, retrieve the modified HTML/CSS content from the client-side and pass it back to the server.
6. Create an instance of `EditableDocument` with the modified content.
7. Use `SpreadsheetSaveOptions` to configure how the spreadsheet should be saved.
8. Call `Editor.save()` to save the changes, creating a new spreadsheet that contains the edited worksheet only.

### New Feature: Inserting Edited Worksheet

This process can be enhanced by inserting the edited worksheet into the original spreadsheet instead of generating a new one with only the edited worksheet. 

The `SpreadsheetSaveOptions` class has two new properties:

- `worksheetNumber`: This defines the position where the edited worksheet should be inserted.
- `insertAsNewWorksheet`: A boolean flag that determines whether to replace an existing worksheet or insert the edited worksheet as a new one.

```javascript
let worksheetNumber = 1; // Set worksheet number
let insertAsNewWorksheet = true; // Insert the edited worksheet as a new one
```

If `worksheetNumber` is `0`, a new single-worksheet spreadsheet will be created. However, if a valid spreadsheet is loaded and `worksheetNumber` is greater than `0`, the edited worksheet will be inserted into the existing spreadsheet.

## WorksheetNumber Property

The `worksheetNumber` property determines where in the spreadsheet the new worksheet will be inserted. Worksheet numbering starts at `1`, similar to how Excel numbers worksheets, not the zero-based index typically used in programming.

If the number exceeds the number of worksheets in the spreadsheet, it will be adjusted to the last worksheet.

```javascript
let saveOptions = new SpreadsheetSaveOptions();
saveOptions.worksheetNumber = 2; // Insert into second worksheet
```

Additionally, negative numbers can be used to count from the end of the spreadsheet, where `-1` is the last worksheet, `-2` is the second to last, and so on. 

Example with positive and negative numbering:

```javascript
saveOptions.worksheetNumber = -1; // Insert as last worksheet
saveOptions.worksheetNumber = 5;  // Insert into fifth worksheet (or adjust if fewer exist)
```

## InsertAsNewWorksheet Property

The `insertAsNewWorksheet` property determines whether to replace the worksheet at the specified position or insert a new one.

- If `insertAsNewWorksheet` is `false`, the worksheet at the specified position is replaced by the edited one.
- If `insertAsNewWorksheet` is `true`, the edited worksheet is inserted, and existing worksheets are shifted accordingly.

```javascript
saveOptions.insertAsNewWorksheet = true;  // Enable inserting the edited worksheet as new
```

For example, inserting a worksheet in various positions:

```javascript
saveOptions.worksheetNumber = 3;  // Insert at the third worksheet
saveOptions.insertAsNewWorksheet = true;  // Keep existing worksheets and insert new one
```

### Example Code for Node.js

```javascript
const groupdocs = require('groupdocs-editor');
const Editor = groupdocs.Editor;
const SpreadsheetSaveOptions = groupdocs.options.SpreadsheetSaveOptions;
const SpreadsheetEditOptions = groupdocs.options.SpreadsheetEditOptions;

// Load the existing spreadsheet into the Editor
const editor = new Editor('Sample.xlsx');

// Prepare options for editing the spreadsheet
const editOptions = new SpreadsheetEditOptions();
editOptions.worksheetIndex = 1;  // Edit the second worksheet (0-based index)

// Get the editable document (HTML/CSS)
const editableDocument = editor.edit(editOptions);

// Simulate editing the document and retrieving it back as HTML
const editedContent = '<html>...edited content...</html>';
const resources = [];

// Create a new EditableDocument instance with the edited content
const updatedDocument = EditableDocument.fromMarkup(editedContent, resources);

// Prepare save options
const saveOptions = new SpreadsheetSaveOptions();
saveOptions.worksheetNumber = 2;  // Insert as second worksheet
saveOptions.insertAsNewWorksheet = true;  // Insert as new worksheet

// Save the updated spreadsheet
editor.save(updatedDocument, 'UpdatedSample.xlsx', saveOptions);
```

## Additional Notes

This new feature doesn't modify the original spreadsheet loaded into the `Editor` class. When the edited worksheet is inserted into the spreadsheet, the original document is copied, and the worksheet is added to the copy. Thus, the original spreadsheet remains unchanged.

It’s also important to note that inserting an edited worksheet requires that the loaded document is a valid spreadsheet. The `worksheetNumber` and `insertAsNewWorksheet` properties must be properly configured for the feature to work as expected.

---

## Install GroupDocs.Assembly for .NET and Apply License

Path: /assembly/net/basic-usage-install-and-license/


## Overview

Before you can start generating documents with GroupDocs.Assembly for .NET, you need to install the library and apply a license. This guide shows you how to install the package via NuGet and configure licensing to remove evaluation limitations.

The main classes involved are:
- [License](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/license/) - for applying licenses
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - for assembling documents

Here are the steps to get started:

* Install GroupDocs.Assembly package via NuGet Package Manager or Package Manager Console
* Apply a license from a file or stream using the `License.SetLicense` method
* Verify that the license is applied correctly before using DocumentAssembler

{{< alert style="info" >}}
Calling `License.SetLicense` multiple times is not harmful but wastes processor time. In Windows Forms or console applications, call it once during startup. In ASP.NET applications, call it in `Application_Start` method in Global.asax.cs.
{{< /alert >}}

## Install via NuGet Package Manager

The easiest way to install GroupDocs.Assembly is through NuGet Package Manager in Visual Studio.

1. Right-click your project in Solution Explorer
2. Select "Manage NuGet Packages"
3. Search for "GroupDocs.Assembly"
4. Click "Install" to install the latest version

## Install via Package Manager Console

Alternatively, you can install the package using Package Manager Console:

```csharp
// Run this command in Package Manager Console:
// Install-Package GroupDocs.Assembly
```

## Apply License from File

After installation, apply your license file to remove evaluation limitations:

```csharp
using GroupDocs.Assembly;

public static void ApplyLicenseFromFile()
{
    // Path to your license file
    string licensePath = "GroupDocs.Assembly.lic";
    
    // Apply the license
    License license = new License();
    license.SetLicense(licensePath);
    
    Console.WriteLine("License applied successfully from file.");
}
```

## Apply License from Stream

You can also load a license from a stream:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void ApplyLicenseFromStream()
{
    // Load license file into a stream
    using (FileStream stream = new FileStream("GroupDocs.Assembly.lic", FileMode.Open))
    {
        License license = new License();
        license.SetLicense(stream);
        
        Console.WriteLine("License applied successfully from stream.");
    }
}
```

## Verify License Application

To verify that your license is applied correctly, you can check for evaluation watermarks in generated documents. If no watermarks appear, the license is active.

```csharp
using GroupDocs.Assembly;

public static void VerifyLicense()
{
    License license = new License();
    license.SetLicense("GroupDocs.Assembly.lic");
    
    // Try to assemble a simple document
    DocumentAssembler assembler = new DocumentAssembler();
    // If license is valid, no evaluation watermark will appear
    Console.WriteLine("License verification: Check generated documents for watermarks.");
}
```

{{< alert style="warning" >}}
The license file contains a digital signature. Do not modify the license file, as even adding an extra line break will invalidate it.
{{< /alert >}}

### Advanced Usage Topics

To learn more about licensing options including metered licensing, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Install GroupDocs.Conversion for Java

Path: /conversion/java/installation/


**GroupDocs.Conversion for Java** enables seamless conversion between multiple document formats with high fidelity. This guide provides steps to integrate the library into your Java project.

### Prerequisites:

1. **Java Development Environment:** Ensure you have Java Development Kit (JDK) installed. The library supports versions 8 and above.
2. **Build Tool:** Compatible with Maven, Gradle, Kotlin and others for dependency management.
3. **GroupDocs.Conversion for Java License (optional):** Use the API in evaluation mode or apply for a free temporary license.

## Installation from GroupDocs Repository

All Java packages are hosted at [GroupDocs Artifact Repository](https://repository.groupdocs.com/). You can easily reference the GroupDocs.Conversion for Java API directly in your project using the following steps.

### Add GroupDocs Artifact Repository

First, you need to specify repository configuration/location in your project as follows:

{{< tabs "example1">}}
{{< tab "Maven" >}}
```xml
<repositories>
  <repository>
    <id>GroupDocs Artifact Repository</id>
    <name>GroupDocs Artifact Repository</name>
    <url>https://releases.groupdocs.com/java/repo/</url>
  </repository>
</repositories>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
repositories {
  maven {
    url "https://repository.groupdocs.com/repo/"
  }
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
repositories {
  maven(url = "https://repository.groupdocs.com/repo/")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<ivysettings>
  <settings defaultResolver="chain"/>
  <resolvers>
    <chain name="chain">
      <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
    </chain>
  </resolvers>
</ivysettings>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Conversion as a dependency

Then define the GroupDocs.Conversion for Java API dependency in your project as follows:

{{< tabs "example2">}}
{{< tab "Maven" >}}
```xml
<dependencies>
  <dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion</artifactId>
    <version>25.2</version>
  </dependency>
</dependencies>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
dependencies {
  implementation 'com.groupdocs:groupdocs-conversion:25.2'
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
dependencies {
  implementation("com.groupdocs:groupdocs-conversion:25.2")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<dependency org="com.groupdocs" name="groupdocs-conversion" rev="25.2">
  <artifact name="groupdocs-conversion" ext="jar"/>
</dependency>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
libraryDependencies += "com.groupdocs" % "groupdocs-conversion" % "25.2"
```
{{< /tab >}}
{{< /tabs >}}

## Manual JAR Download

You can also download the JAR files directly from the [GroupDocs Downloads page](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-conversion/) and include them in your project manually.

## Example: Creating a simple command line application

Create following project structure:

```log
|--- pom.xml
|--- sample.txt
|--- src
     |--- main
          |-- java
              |-- com
                  |-- mycompany
                      |-- app
                          |-- App.java
```

Below is a content of the project files:

{{< tabs "project-files">}}
{{< tab "App.java" >}}
```java
package com.mycompany.app;

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class App {
  public static void main(String[] args) {
    try (Converter converter = new Converter("sample.txt")) {
      converter.convert("sample.pdf", new PdfConvertOptions());
    }
    System.out.println("Conversion complete");
  }
}
```
{{< /tab >}}
{{< tab "pom.xml" >}}
```xml
<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.mycompany.app</groupId>
  <artifactId>conversion-helloworld</artifactId>
  <version>1.0-SNAPSHOT</version>

  <name>conversion-helloworld</name>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
          <archive>
            <manifest>
              <mainClass>com.mycompany.app.App</mainClass>
              <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
              <addDefaultSpecificationEntries>true</addDefaultSpecificationEntries>
            </manifest>
            <manifestEntries>
              <Specification-Vendor>My Company</Specification-Vendor>
              <Implementation-Vendor>My Company</Implementation-Vendor>
            </manifestEntries>
          </archive>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
        </configuration>
      </plugin>
    </plugins>
  </build>

  <repositories>
    <repository>
      <id>GroupDocs Artifact Repository</id>
      <name>GroupDocs Artifact Repository</name>
      <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
  </repositories>
</project>
```
{{< /tab >}}
{{< tab "sample.txt" >}}
```
Sample text
```
{{< /tab >}}
{{< /tabs >}}

To run the application first build it (from the root project directory where pom.xml is located):

```bash
mvn clean package
```

Next run it:

```bash
java -jar target/conversion-helloworld-1.0-SNAPSHOT-jar-with-dependencies.jar
```

Here is a program output:

```log
Conversion complete
```

After that you can see and open `sample.pdf` file in the root project directory

{{< alert style="info" >}}
Note: you can create and run this project in your favourite IDE instead. Also you can build and run it without Maven usage, for example using the IDE dependency and build system or for example using Gradle.
{{< /alert >}}

For more examples, visit the [developer guide]({{< ref "conversion/java/developer-guide" >}})

---

## Installation

Path: /conversion/python-net/getting-started/installation/


## Install Package from PyPI

PyPI (Python Package Index) is a repository of software packages for the Python programming language. Visit the [groupdocs-conversion-net](https://pypi.org/project/groupdocs-conversion-net/) package page for more details. 

### Installing the Package

To install the package, open a terminal and run the following command:

{{< tabs "example1">}}
{{< tab "Windows" >}}
```ps
py -m pip install groupdocs-conversion-net
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m pip install groupdocs-conversion-net
```
{{< /tab >}}
{{< /tabs >}}

When running the command on Windows, you can expect the following output:

```bash
Collecting groupdocs-conversion-net
  Downloading groupdocs_conversion_net-*24.12-py3-none-win_amd64*.whl.metadata (6.8 kB)
  Downloading groupdocs_conversion_net-24.12-py3-none-win_amd64.whl (220.3 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 220.3/220.3 MB 2.8 MB/s eta 0:00:00
Installing collected packages: groupdocs-conversion-net
Successfully installed groupdocs-conversion-net-24.12
```

### Adding the Package to `requirements.txt`

You can add the dependency to your `requirements.txt` file by including the following line:

```bash
groupdocs-conversion-net==24.12
```

Then, install the package using the following command:

```bash
pip install -r requirements.txt
```

## Download Package from Official Website

To download the GroupDocs.Conversion package for your operating system, please visit the official [GroupDocs Releases website](https://releases.groupdocs.com/conversion/python-net/). Currently, four OS-specific packages are available:

- **Windows 64-bit:** Package name ends with `amd64.whl`
- **Windows 32-bit:** Package name ends with `win32.whl`
- **macOS Apple Silicon:** Package name ends with `arm64.whl`
- **macOS Intel Silicon:** Package name ends with `x86_64.whl`

Choose the appropriate package based on your system's architecture.

### Copy Downloaded File

Copy the downloaded file into your project folder.

### Install Package Using Pip

To install package run the command specific to your your operation system. 

{{< tabs "example2">}}
{{< tab "Windows (64-bit)" >}}
```ps
py -m pip install groupdocs_conversion_net-24.12-py3-none-win_amd64.whl
```
{{< /tab >}}
{{< tab "Windows (32-bit)" >}}
```ps
py -m pip install groupdocs_conversion_net-24.12-py3-none-win32.whl
```
{{< /tab >}}
{{< tab "macOS (Apple Silicon)" >}}
```ps
python3 -m pip install groupdocs_conversion_net-24.12-py3-none-macosx_11_0_arm64.whl
```
{{< /tab >}}
{{< tab "macOS (Intel Silicon)" >}}
```ps
python3 -m pip install groupdocs_conversion_net-24.12-py3-none-macosx_10_14_x86_64.whl
```
{{< /tab >}}
{{< /tabs >}}

Expected output:

```bash
Processing groupdocs_conversion_net-24.12-py3-none-*.whl
Installing collected packages: groupdocs-conversion-net
Successfully installed groupdocs-conversion-net-24.12
```
---

## Install GroupDocs.Redaction for Python via .NET

Path: /redaction/python-net/installation/


## Install using PIP from PyPI

All Python packages are hosted at [PyPI](https://pypi.org/project/groupdocs-redaction-net). You can easily reference GroupDocs.Redaction for Python via .NET API directly in your Python project by installing it with the following command.

```batch
pip install groupdocs-redaction-net
```

## Download GroupDocs.Redaction from the official website

Visit [Download Center](https://releases.groupdocs.com/redaction/python-net/) and get the **GroupDocs.Redaction for Python via .NET** package.

1. Download the Wheel File: On the download page, locate the latest version of the **GroupDocs.Redaction** package.
Click on the download link to download the wheel file containing the package.
2. Choose the destination folder where you want to place the package.
3. Install package via pip using downloaded package. For example:

```batch 
pip install .../groupdocs_redaction_net-25.5-py3-none-win32.whl
```

---

## Installation

Path: /signature/python-net/installation/

## Install from PyPI

PyPI (Python Package Index) is the easiest way to download and install GroupDocs.Signature for Python. There are several ways to install it in your project.

### Install via pip

The simplest way to install GroupDocs.Signature is using pip, Python's package installer:

```bash
pip install groupdocs-signature-net
```

### Install in a Virtual Environment

It's recommended to install the package in a virtual environment to avoid conflicts with other Python packages:

```bash
# Create a virtual environment
python -m venv venv

# Activate the virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install the package
pip install groupdocs-signature-net
```

### Install with Specific Version

To install a specific version of the package:

```bash
pip install groupdocs-signature-net==25.4.0
```

## Install from Wheel File

You can also install GroupDocs.Signature using a wheel file downloaded from the [Downloads section](https://downloads.groupdocs.com/signature/python-net):

1. Download the appropriate wheel file for your Python version and system architecture
2. Install using pip:

```bash
pip install path/to/groupdocs_signature_net-25.4.0-py3-none-any.whl
```
  
## Verify Installation

To verify that the installation was successful, you can run this Python code:

```python
import groupdocs.signature as signature

# Create an instance of Signature class
signature = signature.Signature("sample.pdf")

# If no errors occur, the installation was successful
print("GroupDocs.Signature installed successfully!")
```

## System Requirements

Make sure your system meets the following requirements:
- Python 3.6 or later
- .NET Framework 4.7.2 or later
- Windows, macOS, or Linux operating system

For detailed system requirements, please refer to the [System Requirements](system-requirements.md) page.

---

## Install GroupDocs.Viewer for Python via .NET

Path: /viewer/python-net/installation/


## Install Package from PyPI

PyPI (Python Package Index) is a repository of software packages for the Python programming language. Visit the [groupdocs-viewer-net](https://pypi.org/project/groupdocs-viewer-net/) package page for more details. 

### Installing the Package

To install the package, open a terminal and run the following command:

{{< tabs "example1">}}
{{< tab "Linux" >}}
```bash
python3 -m pip install groupdocs-viewer-net
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m pip install groupdocs-viewer-net
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py -m pip install groupdocs-viewer-net
```
{{< /tab >}}
{{< /tabs >}}

When running the command on Windows, you can expect the following output:

```bash
Collecting groupdocs-viewer-net
  Downloading groupdocs_viewer_net-*25.12-py3-none-win_amd64*.whl.metadata (6.8 kB)
  Downloading groupdocs_viewer_net-25.12-py3-none-win_amd64.whl (193.3 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 193.3/193.3 MB 2.8 MB/s eta 0:00:00
Installing collected packages: groupdocs-viewer-net
Successfully installed groupdocs-viewer-net-25.12
``` 

### Adding the Package to `requirements.txt`

You can add the dependency to your `requirements.txt` file by including the following line:

```bash
groupdocs-viewer-net==25.12
```

Then, install the package using the following command:

```bash
pip install -r requirements.txt
```

## Download Package from Official Website

To download the GroupDocs.Viewer package for your operating system, please visit the official [GroupDocs Releases website](https://releases.groupdocs.com/viewer/python-net/). Currently, five OS-specific packages are available:

- **Windows 64-bit:** Package name ends with `amd64.whl`
- **Windows 32-bit:** Package name ends with `win32.whl`
- **Linux 64-bit:** Package name ends with `manylinux1_x86_64`
- **macOS Apple Silicon:** Package name ends with `arm64.whl`
- **macOS Intel Silicon:** Package name ends with `x86_64.whl`

Choose the appropriate package based on your system's architecture.

### Copy Downloaded File

Copy the downloaded file into your project folder.

### Install Package Using Pip

To install package run the command specific to your your operation system. 

{{< tabs "example2">}}
{{< tab "Linux (64-bit)" >}}
```bash
python3 -m pip install groupdocs_viewer_net-25.12-py3-none-manylinux_x86_64.whl
```
{{< /tab >}}
{{< tab "macOS (Apple Silicon)" >}}
```bash
python3 -m pip install groupdocs_viewer_net-25.12-py3-none-macosx_11_0_arm64.whl
```
{{< /tab >}}
{{< tab "macOS (Intel Silicon)" >}}
```bash
python3 -m pip install groupdocs_viewer_net-25.12-py3-none-macosx_10_14_x86_64.whl
```
{{< /tab >}}
{{< tab "Windows (64-bit)" >}}
```ps
py -m pip install groupdocs_viewer_net-25.12-py3-none-win_amd64.whl
```
{{< /tab >}}
{{< tab "Windows (32-bit)" >}}
```ps
py -m pip install groupdocs_viewer_net-25.12-py3-none-win32.whl
```
{{< /tab >}}
{{< /tabs >}}

Expected output:

```bash
Processing groupdocs_viewer_net-25.12-py3-none-*.whl
Installing collected packages: groupdocs-viewer-net
Successfully installed groupdocs-viewer-net-25.12
```

---

## Install GroupDocs.Watermark for Python via .NET

Path: /watermark/python-net/installation/


## Install using PIP from PyPI

All Python packages are hosted at [PyPI](https://pypi.org/project/groupdocs-watermark-net). You can easily reference GroupDocs.Watermark for Python via .NET API directly in your Python project by installing it with the following command.

```batch
pip install groupdocs-watermark-net
```

## Download GroupDocs.Watermark from the official website

Visit [https://releases.groupdocs.com/watermark/python-net/](https://releases.groupdocs.com/watermark/net/) and download the **GroupDocs.Watermark** assemblies.

1. Download the Wheel File: On the download page, locate the latest version of the **GroupDocs.Watermark** package.
Click on the download link to download the wheel file containing the package.
2. Choose the destination folder where you want to place the package.
3. Install package via pip using downloaded package. For example, 
```batch 
pip install .../groupdocs_watermark_net-24.5-py3-none-win32.whl
```

---

## Introducing GroupDocs.Assembly for .NET

Path: /assembly/net/introducing-groupdocs-assembly-for-net/


GroupDocs.Assembly for .NET is a document automation and reports generation API designed to create custom documents from templates. This .NET reporting API intelligently assembles the given data with the defined template document and it is a **report generator** which generates an output document based on the data source, in the template's format as or in the specified output format. Since GroupDocs.Assembly for .NET can generate documents based on a data source, essentially it serves two purposes: Document Automation and Report Generation.

## Document Automation Concept

As per Wikipedia, Document Automation can be described as:

> **Document automation** (also known as **document assembly**) is the design of systems and [workflows](https://en.wikipedia.org/wiki/Workflow) that assist in the creation of [electronic documents](https://en.wikipedia.org/wiki/Electronic_document). These include logic-based systems that use segments of pre-existing text and/or data to assemble a new document. This process is increasingly used within certain industries to assemble legal documents, contracts and letters. Document automation systems can also be used to automate all conditional text, variable text, and data contained within a set of documents.
> 
> Automation systems allow companies to minimize data entry, reduce the time spent proof-reading, and reduce the risks associated with human error. Additional benefits include: time and financial savings due to decreased paper handling, document loading, storage, distribution, postage/shipping, faxes, telephone, labor and waste.

For more information, please visit: [https://en.wikipedia.org/wiki/Document\_automation](https://en.wikipedia.org/wiki/Document_automation)

## Report Generation Concept

As per Wikipedia, Report Generation can be described as:

> A **report generator** is a computer program whose purpose is to take data from a source such as a database, XML stream or a spreadsheet, and use it to produce a document in a format which satisfies a particular human readership.
> 
> Report generation functionality is almost always\[[citation needed](https://en.wikipedia.org/wiki/Wikipedia:Citation_needed)\] present in [database systems](https://en.wikipedia.org/wiki/Database_systems), where the source of the data is the database itself. It can also be argued that report generation is part of the purpose of a [spreadsheet](https://en.wikipedia.org/wiki/Spreadsheet). Standalone report generators may work with multiple data sources and export reports to different document formats.

For more information, please visit: [https://en.wikipedia.org/wiki/Report\_generator](https://en.wikipedia.org/wiki/Report_generator)

## Supported Document Formats

GroupDocs.Assembly for .NET is capable to recognize and load multiple document formats in memory and populate these templates with the assigned data source. Therefore, you can create your templates in any of the supported document formats. The initial version of GroupDocs.Assembly supports word processing documents including Microsoft Word documents, spreadsheet documents including Microsoft Excel Workbooks and presentation documents including Microsoft PowerPoint Presentations. The future releases of GroupDocs.Assembly will be supporting more document formats and the [supported document formats]({{< ref "assembly/net/getting-started/supported-document-formats.md" >}}) section will be updated periodically whenever more document formats are supported in the future releases.

## Supported Output File Formats Depending on Input File Formats

The following table shows which output file formats are supported by GroupDocs.Assembly depending on input file formats:

| Input File Formats (from left to right) and Output File Formats (top down) | Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT) | Spreadsheet (XLS, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS) | Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP) | Email (EML, EMLX, MSG) | HTML, Markdown, and Plain Text |
| :- | :- | :- | :- | :- | :- |
| **Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT)** | Supported | Not Supported | Not Supported | Supported | Supported |
| **Spreadsheet (XLS, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS)** | Not Supported | Supported | Not Supported | Not Supported | Not Supported |
| **Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP)** | Not Supported | Not Supported | Supported | Not Supported | Not Supported |
| **Email (EML, EMLX, MSG)** | Not Supported | Not Supported | Not Supported | Supported | Not Supported |
| **HTML, PDF, XPS, TIFF** | Supported | Supported | Supported | Supported | Supported |
| **MHTML** | Supported | Supported | Not Supported | Supported | Supported |
| **Markdown, Plain Text, XAML, OpenXPS, EPUB, SVG, PS, PCL** | Supported | Not Supported | Not Supported | Supported | Supported |

## Supported Template Syntax

Essentially, the GroupDocs.Assembly for .NET engine supports LINQ but it does not support the actual LINQ syntax. Instead, the engine supports the underlying C# syntax for LINQ queries which is actually shorter than LINQ. This basically means that the developers can use the familiar and well documented C# syntax to write data binding/traversal queries right in the document templates. As a result, developers can enjoy many benefits including short and concise reporting syntax and binding to any type of supported data source including business objects. For more information about the supported LINQ based syntax, please visit [Template Syntax](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/). In future, [Mustache](https://mustache.github.io/mustache.5.html) template support is also planned.

## Supported Data Sources

GroupDocs.Assembly for .NET supports the following data sources:

*   Database
*   XML
*   OData
*   JSON
*   Custom .NET Objects

Furthermore, GroupDocs.Assembly for .NET support various Data Manipulation features. For more information, please visit [Data Sources]({{< ref "assembly/net/getting-started/features-overview.md#data-sources" >}}#FeaturesOverview-DataSources).

## Technical Support Channels

### Product Support Forums

The main channel of the Technical Support is [Product Support Forums](http://groupdocs.com/Community/Forums/Default.aspx). Post your question in the Forum and it will be answered within a few hours. Please try to report one issue per thread with all details required to reproduce the issue.

### Sales and License Related Technical Queries

For sales and License related technical queries please visit the [GroupDocs.Purcahse Froum](http://groupdocs.com/Community/forums/groupdocs.purchase/10/showforum.aspx). Please note that GroupDocs.Purchase is a private forum and will require you to sign up with [groupdocs.com](http://www.groupdocs.com) before you can view this forum.

---

## Introducing GroupDocs.Assembly for Java

Path: /assembly/java/introducing-groupdocs-assembly-for-java/

## Introduction to GroupDocs.Assembly for Java

GroupDocs.Assembly for Java is a Java API engine designed to generate documents based on templates. In essence, the engine accepts a template document and some data, assembles data with the template document as per syntax defined by the template document and then, generates the output document in the template's format or in the specified output format. Since GroupDocs.Assembly for Java can generate documents based on a data source, essentially it serves two purposes: Document Automation and Report Generation.

### Document Automation Concept

As per wikipedia, Document Automation can be described as:

> **Document automation** (also known as **document assembly**) is the design of systems and [workflows](https://en.wikipedia.org/wiki/Workflow) that assist in the creation of [electronic documents](https://en.wikipedia.org/wiki/Electronic_document). These include logic-based systems that use segments of pre-existing text and/or data to assemble a new document. This process is increasingly used within certain industries to assemble legal documents, contracts and letters. Document automation systems can also be used to automate all conditional text, variable text, and data contained within a set of documents.
> 
> Automation systems allow companies to minimize data entry, reduce the time spent proof-reading, and reduce the risks associated with human error. Additional benefits include: time and financial savings due to decreased paper handling, document loading, storage, distribution, postage/shipping, faxes, telephone, labor and waste.

For more information, please visit: [https://en.wikipedia.org/wiki/Document\_automation](https://en.wikipedia.org/wiki/Document_automation)

### Report Generation Concept

As per wikipedia, Report Generation can be described as:

> A **report generator** is a computer program whose purpose is to take data from a source such as a database, XML stream or a spreadsheet, and use it to produce a document in a format which satisfies a particular human readership.
> 
> Report generation functionality is almost always\[[citation needed](https://en.wikipedia.org/wiki/Wikipedia:Citation_needed)\] present in [database systems](https://en.wikipedia.org/wiki/Database_systems), where the source of the data is the database itself. It can also be argued that report generation is part of the purpose of a [spreadsheet](https://en.wikipedia.org/wiki/Spreadsheet). Standalone report generators may work with multiple data sources and export reports to different document formats.

For more information, please visit: [https://en.wikipedia.org/wiki/Report\_generator](https://en.wikipedia.org/wiki/Report_generator)

## Supported Document Formats

GroupDocs.Assembly for Java is capable to recognize and load multiple document formats in memory and populate these templates with the assigned data source. Therefore, you can create your templates in any of the supported document formats. The initial version of GroupDocs.Assembly supports word processing documents including Microsoft Word documents, spreadsheet documents including Microsoft Excel Workbooks and presentation documents including Microsoft PowerPoint Presentations. The future releases of GroupDocs.Assembly will be supporting more document formats and the [supported document formats]({{< ref "assembly/java/getting-started/supported-document-formats.md" >}}) section will be updated periodically whenever more document formats are supported in the future releases.

## Supported Output File Formats Depending on Input File Formats

The following table shows which output file formats are supported by GroupDocs.Assembly depending on input file formats:

| Input File Formats (from left to right) and Output File Formats (top down) | Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT) | Spreadsheet (XLS, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS) | Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTX, POTM, ODP) | Email (EML, EMLX, MSG) | HTML and Plain Text |
| --- | --- | --- | --- | --- | --- |
| Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT) | Supported | Not Supported | Not Supported | Supported | Supported |
| Spreadsheet (XLS, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS) | Not Supported | Supported | Not Supported | Not Supported | Not Supported |
| Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTX, POTM, ODP) | Not Supported | Not Supported | Supported | Not Supported | Not Supported |
| Email (EML, EMLX, MSG) | Not Supported | Not Supported | Not Supported | Supported | Not Supported |
| HTML, PDF, XPS, TIFF | Supported | Supported | Supported | Supported | Supported |
| MHTML | Supported | Supported | Not Supported | Supported | Supported |
| Plain Text, XAML, OpenXPS, EPUB, SVG, PS, PCL | Supported | Not Supported | Not Supported | Supported | Supported |

## Supported Template Syntax

Essentially, the GroupDocs.Assembly for Java engine supports LINQ but it does not support the actual LINQ syntax (LINQ extension method analogues are named using lower camel case). Developers can enjoy many benefits including short and concise reporting syntax and binding to any type of supported data source including business objects. For more information about the supported LINQ based syntax, please visit [Template Syntax](/pages/createpage.action?spaceKey=GDDR&title=Template+Syntax+-+Part+1+of+2). In future, [Mustache](https://mustache.github.io/mustache.5.html) template support is also planned.

## Supported Data Sources

GroupDocs.Assembly for Java supports the following data sources:

*   Database
*   XML
*   OData
*   JSON
*   Custom Java Objects

Furthermore, GroupDocs.Assembly for Java support various Data Manipulation features. For more information, please visit [Data Sources]({{< ref "assembly/java/getting-started/features-overview.md#data-sources" >}}).

## Technical Support Channels

### Product Support Forums

The main channel of the Technical Support is [Product Support Forums](http://groupdocs.com/Community/Forums/Default.aspx). Post your question in the Forum and it will be answered within a few hours. Please try to report one issue per thread with all details required to reproduce the issue.

### Sales and License Related Technical Queries

For sales and License related technical queries please visit the [GroupDocs.Purcahse Froum](http://groupdocs.com/Community/forums/groupdocs.purchase/10/showforum.aspx). Please note that GroupDocs.Purchase is a private forum and will require you to sign up with [groupdocs.com](http://www.groupdocs.com) before you can view this forum.

---

## Introducing GroupDocs.Classification for .NET

Path: /classification/net/introducing-groupdocs-classification-for-net/

## What Is GroupDocs.Classification?

GroupDocs.Classification for .NET is a powerful and intuitive library used for texts and documents classification with several taxonomies. Documents could be in various formats,including Microsoft Word and OpenDocument Writer file formats, PDF documents, RTF and TXT. Classification results can be easily customized with multiple and flexible options.

## Why Use GroupDocs.Classification as a Developer?

*   No additional software is required to classify texts or documents.
*   IAB-2 taxonomy for News/Cites classification.
*   Documents taxonomy for different document classes, such as Invoices, CVs, Forms, emails.
*   Sentiment taxonomy for the sentiment analysis (classification).  
    

## Online Demo

GroupDocs.Classification demo supports file and text classification with IAB-2 or Documents taxonomies (precision/recall balance has a default value for Documents taxonomy).

[https://products.groupdocs.app/classification](https://products.groupdocs.app/classification)

---

## Introducing GroupDocs.Parser for .NET

Path: /parser/net/introducing-groupdocs-parser-for-net/

## What Is GroupDocs.Parser?
GroupDocs.Parser is a powerful document data extraction API from over 50 document types in your applications.  
Many popular formats are supported: PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, ODT, ODS, RTF, EPUB and many others.
  
One of the most valuable features of GroupDocs.Parser is parsing documents with predefined templates. It's easy to define template and extract data from invoices, prices or other kinds of your typical documents.  
The API allows to easily extract text in accurate and quick modes. There are several advanced methods to extract text.  
The API also provides methods to extract images, extract metadata. You can do it with regular documents and containers like ZIP archives, OST/PST mail data files and PDF portfolios.  
If you want to extract PDF forms, GroupDocs.Parser also allows to do it.

## Why Use GroupDocs.Parser?  

*   No additional software is required for most document formats - extract text, metadata, and images from PDF, Office documents, and 50+ formats out of the box. Note: OCR functionality for scanned documents uses built-in OCR for English text, or you can integrate optional third-party OCR solutions for advanced needs (see [OCR usage]({{< ref "parser/net/developer-guide/advanced-usage/using-ocr/_index.md" >}}));
*   Online free document data extraction App for simple cases and powerful .Net library for many data extraction scenarios;     
*   Accurate and fast Raw text extraction modes;
*   Document information extraction - file type, page count etc;
*   Metadata extraction;
*   Images extraction;
*   Attachments extraction;
*   Parsing documents by user-generated templates;
*   Parsing PDF forms.

## Key Features

- Extract raw text and formatted text.  
- Search by keywords with advanced options (case sensitivity, whole word match, regex).  
- Work with document metadata and structured elements.  
- Extract images, attachments, and tables.  
- Use parsing templates to extract data fields with precision.  


## Getting Started

### Installation

Install **GroupDocs.Parser for .NET** via NuGet:

```powershell
Install-Package GroupDocs.Parser
```
### Simple Example – Extract Text

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using(TextReader reader = parser.GetText())
    {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

# Document Processing Guide

## Use Cases

* **Enterprise Search Systems** – Integrate full-text search in internal document management.
* **eDiscovery & Legal** – Extract and analyze text from legal files.
* **Financial Applications** – Parse invoices, receipts, and structured data using templates.
* **Data Migration** – Extract structured content for migration between document systems.

## Supported Formats

| Category | Formats |
|----------|---------|
| Documents | PDF, DOC, DOCX, RTF, TXT, ODT, EPUB |
| Spreadsheets | XLS, XLSX, ODS |
| Presentations | PPT, PPTX, ODP |
| Emails & Containers | MSG, EML, PST, OST, ZIP |
| Web & Markup | HTML, XHTML, XML |

Full List of Supported [Formats]({{< ref "parser/net/getting-started/supported-document-formats.md" >}})

## Resources

* [API Reference](https://reference.groupdocs.com/net/parser)
* [Examples on GitHub](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
* [Licensing](https://purchase.groupdocs.com/policies/use-license/)
* [Free Trial](https://purchase.groupdocs.com/temp-license/100308)

---

## Introducing GroupDocs.Parser for Java

Path: /parser/java/introducing-groupdocs-parser-for-java/

## What Is GroupDocs.Parser?

GroupDocs.Parser is a powerful document data extraction API from over 50 document types in your applications.
  
One of the most valuable features of GroupDocs.Parser is parsing documents with predefined templates. It's easy to define template and extract data from invoices, prices or other kinds of your typical documents.  

The API allows to easily extract text in accurate and quick modes. There are several advanced methods to extract text.  

The API also provides methods to extract images, extract metadata. You can do it with regular documents and containers like ZIP archives, OST/PST mail data files and PDF portfolios.  

If you want to extract PDF forms, GroupDocs.Parser also allows to do it.

## Why Use GroupDocs.Parser as a Developer?

*   No additional software is required to extract data from the documents;
*   Document information extraction - file type, page count etc;
*   Attachments and images extraction;
*   Parsing documents by user-generated templates;
*   Parsing PDF forms.

---

## Introducing GroupDocs.Signature for .NET

Path: /signature/net/introducing-groupdocs-signature-for-net/

## What Is GroupDocs.Signature?

GroupDocs.Signature for .NET is an electronic signature library that provides an ability to add stamps, barcodes, QR-codes, text, image, metadata, form fields and digital signatures to various document formats such as PDF, DOCX/DOC, PPTX/PPT, XLSX/XLS, JPG, PNG, TIFF, HTML and many others. With GroupDocs.Signature for .NET you can sign, search and verify document signatures using different signing option sets to suit all your needs.

## Why Use GroupDocs.Signature?

*   No additional software is required;    
*   Fast and efficient document eSign API;
*   Wide range of supported signature types: 
    *   Text Signature;
    *   Image Signature;
    *   Digital Signature;
    *   Electronic Signature;
    *   Barcode Signature;
    *   QR-code Signature;
    *   Stamp Signature;
    *   Metadata Signature;
    *   FormField Signature.
*   Search and verify document signatures;
*   Additional options set to customize signature, search and verification processes, apply signature styling, manage appearance etc.;
*   Document information extraction API;
*   Document preview API.

---

## Introducing GroupDocs.Signature for Java

Path: /signature/java/introducing-groupdocs-signature-for-java/

## What Is GroupDocs.Signature?

GroupDocs.Signature is a feature rich library which provides an ability to add stamps, barcodes and QR-codes, text, image, metadata, form field and digital signatures to documents of various formats like PDF, DOCX/DOC, PPTX/PPT, XLSX/XLS, JPG, PNG, TIFF, HTML and many others.   
Sign, search, verify document signatures for all popular document formats and set different signing options to suit your needs with GroupDocs.Signature for Java API.

## Why Use GroupDocs.Signature as a Developer?

*   No additional software is required to sign documents of different types;    
*   Wide range of supported signature types - Text, Image, Digital certificate, Barcode, QR-code, Stamp, Metadata, FormField;    
*   Huge additional options set to customize sign, search and verification processes, apply signature styling, manage appearance etc.;    
*   Document information extraction - file type, page count etc.;    
*   Generate document preview for precise placing the signature inside the document.

---

## Introducing GroupDocs.Signature for Node.js

Path: /signature/nodejs-java/introducing-groupdocs-signature-for-nodejs/

## What Is GroupDocs.Signature?

GroupDocs.Signature for Node.js is an electronic signature library that provides an ability to add stamps, barcodes, QR-codes, text, image, metadata, form fields and digital signatures to various document formats such as PDF, DOCX/DOC, PPTX/PPT, XLSX/XLS, JPG, PNG, TIFF, HTML and many others. With GroupDocs.Signature for Node.js you can sign, search and verify document signatures using different signing option sets to suit all your needs.

## Why Use GroupDocs.Signature?

*   No additional software is required;    
*   Fast and efficient document eSign API;
*   Wide range of supported signature types: 
    *   Text Signature;
    *   Image Signature;
    *   Digital Signature;
    *   Electronic Signature;
    *   Barcode Signature;
    *   QR-code Signature;
    *   Stamp Signature;
    *   Metadata Signature;
    *   FormField Signature.
*   Search and verify document signatures;
*   Additional options set to customize signature, search and verification processes, apply signature styling, manage appearance etc.;
*   Document information extraction API;
*   Document preview API.

---

## Introducing GroupDocs.Signature for Python via .NET

Path: /signature/python-net/introducing/

# Introducing GroupDocs.Signature for Python via .NET

GroupDocs.Signature for Python via .NET helps you add electronic signatures to documents in your Python applications. It's easy to use and works with many popular document formats like PDF, Word, Excel, PowerPoint, and images.

## Why Use GroupDocs.Signature for Python?

Need to sign documents in your Python app? GroupDocs.Signature makes it simple! You can:

- Add different types of signatures to documents
- Work with over 45 file formats
- Customize how signatures look and where they appear
- Search for and verify signatures
- All this without needing other software

## Getting Started

### System Requirements

- Python 3.5 or later
- .NET Core 3.1 or later
- Works on Windows, Linux, or macOS

### Installation

```bash
pip install groupdocs-signature
```

### Quick Example: Adding a Text Signature

```python
import groupdocs_signature as gs
import groupdocs_signature.options as options

# Open a document
with gs.Signature("sample.pdf") as signature:
    # Create text signature options
    opts = options.TextSignOptions("John Smith")
    opts.page_number = 1
    opts.position_x = 100
    opts.position_y = 100
    opts.font.font_size = 14
    
    # Sign the document
    signature.sign("signed.pdf", opts)
    
print("Document signed successfully!")
```

## Signature Types You Can Add

### Text Signature
Add text with custom fonts and colors.

### Image Signature
Put images like your handwritten signature on documents.

### Digital Signature
Use secure certificate-based signatures.

### Barcode Signature
Add barcodes to your documents.

### QR Code Signature
Put QR codes containing text or links in documents.

### Stamp Signature
Add official-looking stamps to documents.

### Metadata Signature
Hide signatures in document properties.

## Supported Document Formats

GroupDocs.Signature works with many popular formats including:

- PDF files
- Word documents (DOCX, DOC)
- Excel spreadsheets (XLSX, XLS)
- PowerPoint presentations (PPTX, PPT)
- Images (JPEG, PNG, TIFF)
- And many more!
---

## Introducing Web Report Generator

Path: /assembly/net/introducing-web-report-generator/

## Introduction to Web Report Generator Powered by GroupDocs.Assembly for .NET

Web Report Generator is an ASP.NET Web forms application using GroupDocs.Assembly for .NET that demonstrates the core functionalities provided by GroupDocs.Assembly for .NET. The Web Report Generator allows user to easily create reports based on: a) Predefined custom templates (created in [Supported Document Formats](https://docs.groupdocs.com/assembly/net/supported-document-formats/) following [Supported Template Syntax](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/)) and b) Your own database (MS SQL Server local OR Remote) tables, views and also with custom query. The UI of the application is kept very simple for easy understanding and developers can enhance the features as their own needs since it is an Open Source Project.

![](https://raw.githubusercontent.com/groupdocsassembly/GroupDocs_Assembly_NET/master/Examples/Data/Screenshots/reportgenrator.png)

## Features

*   Connect to MS SQL Server local OR remote by providing connection string.
*   Populate and use Tables from connected database.
*   Populate and use Views from connected database.
*   Create and use custom query over connected database.
*   Upload and use MS Word Template file.
*   Upload and use MS Excel Template file.
*   Upload and use MS Power Point Template file.
*   Generate Report in a format as per source Template Document format.
*   Download generated report from web browser.

## Development Environment

### Framework

Microsoft .NET Framework 3.5 or greater versions are supported.

### IDE

The application has been developed by using **Microsoft Visual Studio 2010**.Therefore, any IDE starting Visual Studio 2010 can be used.

### Data Source Development tool

The sample database (as data source) has been developed in **Microsoft SQL Server 2008 R2**. Hence, To attach the database, you need at least **Microsoft SQL Server 2008 R2** or greater versions.

**Note:** The database couldn't be restored in the earlier versions than **Microsoft SQL Server 2008 R2**

### Supported Browsers

Any of the following browsers are supported to browse the Web Report Generator:

*   Mozilla Firefox
*   Internet Explorer (version 9 or later)
*   Google Chrome
*   Apple Safari

## Technical Support Channels

### Product Support Forums

The main channel of the Technical Support are [Product Support Forums](http://groupdocs.com/Community/Forums/Default.aspx). Post your question in the Forum and it will be answered within a few hours. Please try to report one issue per thread with all details required to reproduce the issue.

### Sales and License Related Technical Queries

For sales and License related technical queries please visit the [GroupDocs.Purcahse Froum](http://groupdocs.com/Community/forums/groupdocs.purchase/10/showforum.aspx). Please note that GroupDocs.Purchase is a private forum and will require you to sign up with [groupdocs.com](http://www.groupdocs.com) before you can view this forum.

## Use and Contribute

### Clone Web Report Generator

Get our open source showcase project **GoupDocs.ReportGenerator** from the source control. For this purpose, please feel free to clone the latest version of the project from our official [Github repository](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/tree/master/Showcases/GroupDocs.ReportGenerator) to your local repository.

### How to Contribute?

All of our Showcase projects are open source, using [MIT license](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/LICENSE). Therefore, developers can freely use whole project or part of it in their applications. We would be happy if you want to contribute by suggesting or adding new feature or improving the existing ones, so other developers could also benefit from it. Happy coding!

---

## Introduction

Path: /editor/java/introduction/

> This article explains the most common and fundamental principles of GroupDocs.Editor, how it works, what is its purpose, and how it should be used.

[**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) is a Java GUI-less class library, which means that it has only programmatic interface (API). This fact means that in order to edit a document user must use GroupDocs.Editor in conjunction with some 3rd-party editor application, through which GUI the end-user is able to edit document content. For GroupDocs.Editor it is not important which exactly editor software is used. But because GroupDocs.Editor is aimed on web-development, it has the only requirement — 3rd-party editor should be compatible with HTML documents.

In order to edit a document with GroupDocs.Editor, user must perform several sequential steps: load document into GroupDocs.Editor (using optional load options), open document for editing (with optional edit options), generate HTML markup with resources (using different options and settings), and pass this markup to the 3rd-party WYSIWYG HTML-editor. Then end-user edits the document content, and when he finish editing and submits the edited document, this modified markup should be transferred back to the GroupDocs.Editor and converted to the output document of desired format.

From the GroupDocs.Editor perspective, this pipeline can be conditionally divided onto three main stages, that are described below.

## Loading document into the GroupDocs.Editor

On the *[loading document]({{< ref "editor/java/developer-guide/load-document.md" >}})* stage user should create an instance of [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class and pass an input document (through file path or byte stream) along with document load options. Loading options are not required and GroupDocs.Editor can automatically detect document format and select the most appropriate default options for the given format. But it is recommended to specify them explicitly. They are inevitable when trying to load password-protected documents.

```java
String inputFilePath = "C:\\input_path\\document.docx"; //path to some document
Editor editor = new Editor(inputFilePath); //passing path to the constructor, default WordProcessingLoadOptions will be applied automatically
```

After this stage document is ready to be opened and edited.

## Opening a document for editing

Because GroupDocs.Editor is GUI-less library, document cannot be edited directly into it. But in order to edit document in WYSIWYG HTML-editor, GroupDocs.Editor needs to generate an HTML-version of a document, because any WYSIWYG editor can work only with HTML/CSS markup. When instance of [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class is created on the 1st stage, user should *[open document for editing]({{< ref "editor/java/developer-guide/edit-document" >}})*

by calling an [edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#edit--) method of [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class. This method returns an instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class. This class can be described as a converted version of input document, that is stored in internal intermediate format, compatible with all formats, that GroupDocs.Editor supports. With [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) user can obtain HTML markup of the input document with different options, stylesheets, images, fonts, save HTML-document to disk, and other things. It is implied that HTML-markup, emitted by [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), then is passed into the client-side WYSIWYG HTML-editor, where end-user can actually edit the document.

Like with loading, [edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#edit--) method obtains optional [IEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ieditoptions) inheritors, that controls how exactly the document will be opened for edit.

```java
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.setEnableLanguageInformation(true);

EditableDocument readyToEdit = editor.edit(editOptions);
```

After this stage document is ready to be passed to the WYSIWYG HTML-editor and its content can be edited by the end-user.

## Saving a document

*[Saving a document]({{< ref "editor/java/developer-guide/save-document.md" >}})* is a final stage, which occurs when document content was edited in the WYSIWYG HTML-editor (or any other software, this has no difference for GroupDocs.Editor) and should be saved back as a document of some format (like DOCX, PDF, or XLSX, for example). At this stage user should create a new instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class with HTML-markup and resources of edited version of the original document, that was obtained from end-user. [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class contains several static methods, that allows to create its instances from HTML documents, that may be presented in different forms. And when [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance is ready, it is possible to save it as an ordinary document using a [save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save--) method of [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class.

```java
EditableDocument afterEdit = EditableDocument.fromMarkup("<body>HTML content of the document...</body>", null);
String outputFilePath = "C:\\output_path\\document.rtf";
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);
editor.save(afterEdit, outputFilePath, saveOptions);
```

Unlike with previous load options and edit options, save options are mandatory, because GroupDocs.Editor needs to know exact document format for saving.

## Detecting document type

Sometimes it is necessary to *[detect a document type and extract its metadata]({{< ref "editor/java/developer-guide/extracting-document-metainfo.md" >}})* before sending it for editing. For such scenarios GroupDocs.Editor allows to detect document type and extract its the most necessary metainfo depending on document type:

1. Is document encoded or not;
2. Exact document format;
3. Document size;
4. Number of pages (tabs);
5. Text encoding, if document is textual.

In order to detect document type and gather its meta info, user should load a desired document into the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class and then call a [getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getdocumentinfo--) method.

## Describing options

On every stage user can adjust (tune) the processing by different options:

1. [ILoadOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/iloadoptions) for *loading* document.
2. [IEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ieditoptions) for opening document for *editing*.
3. [ISaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/isaveoptions) for *saving* edited document.

Some of these options may be optional in specific cases, some are mandatory. For example, it is possible to load a document into the `Editor` class without loading options, — in such case GroupDocs.Editor will try to detect the document format automatically and apply the most appropriate default options for detected document format.

### Describing family formats

All document formats, which GroupDocs.Editor supports, are grouped into family formats. Each family format has lot of common features, so there is no options for each format — only for family format. Relation between formats, family formats, import/export formats and options is illustrated in the table below.

| Family format | Supported formats | Load | Save | Load options | Edit options | Save options | Metadata |
| --- | --- | --- | --- | --- | --- | --- | --- |
| WordProcessing | DOC, DOCX, DOCM, DOT,DOTX, DOTM, RTF,WordprocessingML Flat XML, ODT, OTT, Word 2003 XML | ![(tick)](/editor/java/images/check.png) | ![(tick)](/editor/java/images/check.png) | [WordProcessingLoadOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingloadoptions) | [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions) | [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) | [WordProcessingDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo) |
| Spreadsheet | XLS, XLT, XLSX, XLSM, XLSB, XLTX, XLTM, XLAM,SpreadsheetML XML, ODS, FODS, SXC, DIF | ![(tick)](/editor/java/images/check.png) | ![(tick)](/editor/java/images/check.png) | [SpreadsheetLoadOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetloadoptions) | [SpreadsheetEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheeteditoptions) | [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) | [SpreadsheetDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/spreadsheetdocumentinfo) |
| DSV | CSV, TSV, semicolon-separated,whitespace-separated, arbitrary separator | ![(tick)](/editor/java/images/check.png) | ![(tick)](/editor/java/images/check.png) | N/A | [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions) | [DelimitedTextSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtextsaveoptions) | N/A |
| Presentation | PPT, PPTX, PPTM, PPS, PPSX, PPSM,POT, POTX, POTM, ODP, OTP | ![(tick)](/editor/java/images/check.png) | ![(tick)](/editor/java/images/check.png) | [PresentationLoadOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationloadoptions) | [PresentationEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions) | [PresentationSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions) | [PresentationDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/presentationdocumentinfo) |
| XML | Any XML document | ![(tick)](/editor/java/images/check.png) | ![(error)](/editor/java/images/error.png) | N/A | [XmlEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions) | N/A | [TextualDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo) |
| TXT | Any text document | ![(tick)](/editor/java/images/check.png) | ![(tick)](/editor/java/images/check.png) | N/A | [TextEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/texteditoptions) | [TextSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/textsaveoptions) | [TextualDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo) |
| Fixed-layout format | PDF | ![(error)](/editor/java/images/error.png) | ![(tick)](/editor/java/images/check.png) | N/A | N/A | [PdfSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/pdfsaveoptions) | N/A |

### Additional materials

Detailed information about every stage of document processing along with source code examples, options explanations and so on, can be found in the next articles:

1. [Load document]({{< ref "editor/java/developer-guide/load-document.md" >}}
.    )
2. [Edit document]({{< ref "editor/java/developer-guide/edit-document" >}})
3. [Save document]({{< ref "editor/java/developer-guide/save-document.md" >}})

Complete description of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class, all its possibilities, members and purpose, along with source code example, is located in the next articles:

* [Working with EditableDocument]({{< ref "editor/java/developer-guide/editabledocument/_index.md" >}})
* [Get HTML markup in different forms]({{< ref "editor/java/developer-guide/editabledocument/get-html-markup-in-different-forms.md" >}})
* [Save HTML to folder]({{< ref "editor/java/developer-guide/editabledocument/save-html-to-folder.md" >}})
* [Working with resources]({{< ref "editor/java/developer-guide/editabledocument/working-with-resources.md" >}})
* [Create EditableDocument from file or markup]({{< ref "editor/java/developer-guide/editabledocument/create-editabledocument-from-file-or-markup.md" >}})

Detailed review of all supported family formats together with explaining their load/edit/save options, illustrated with source code, can be found in the next articles:

* [Working with WordProcessing documents]({{< ref "editor/java/developer-guide/edit-document/edit-word" >}})
* [Working with Spreadsheets]({{< ref "editor/java/developer-guide/edit-document/edit-excel" >}})
* [Working with DSV]({{< ref "editor/java/developer-guide/edit-document/how-to-edit-csv-file.md" >}})
* [Working with Presentations]({{< ref "editor/java/developer-guide/edit-document/edit-powerpoint" >}})
* [Working with text documents]({{< ref "editor/java/developer-guide/edit-document/edit-txt.md" >}})

---

## Introduction

Path: /editor/nodejs-java/introduction/


> This article explains the most common and fundamental principles of GroupDocs.Editor for Node.js via Java, how it works, what its purpose is, and how it should be used.

**GroupDocs.Editor for Node.js via Java** is a Node.js library that allows you to edit documents programmatically without a graphical user interface (GUI). It provides an API that enables you to manipulate documents within your Node.js applications. To edit a document, you need to use GroupDocs.Editor in conjunction with a third-party HTML editor application, through which the end-user can edit the document content via a GUI. GroupDocs.Editor is not concerned with which specific editor software is used, but since it is aimed at web development, the only requirement is that the third-party editor should be compatible with HTML documents.

To edit a document with GroupDocs.Editor, you need to perform several sequential steps:

1. **Load the document into GroupDocs.Editor** (using optional load options).
2. **Open the document for editing** (with optional edit options).
3. **Generate HTML markup with resources** (using different options and settings).
4. **Pass the markup to the third-party WYSIWYG HTML editor**.
5. **Edit the document content in the HTML editor**.
6. **Transfer the modified markup back to GroupDocs.Editor**.
7. **Convert the edited markup to the output document of the desired format**.

From the perspective of GroupDocs.Editor, this pipeline can be divided into three main stages, which are described below.

## Loading Document into GroupDocs.Editor

In the **[loading document](/editor/nodejs-java/developer-guide/load-document/)** stage, you should create an instance of the `Editor` class and pass an input document (through a file path or byte stream) along with document load options. Loading options are not required, and GroupDocs.Editor can automatically detect the document format and select the most appropriate default options for the given format. However, it is recommended to specify them explicitly, especially when dealing with password-protected documents.

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

const inputFilePath = 'C:\\input_path\\document.docx'; // Path to some document
const inputStream = fs.createReadStream(inputFilePath);
const editor = new groupdocsEditor.Editor(inputStream); // Passing the stream to the constructor; default WordProcessingLoadOptions will be applied automatically
```

After this stage, the document is ready to be opened and edited.

## Opening a Document for Editing

Since GroupDocs.Editor is a GUI-less library, the document cannot be edited directly within it. To edit the document in a WYSIWYG HTML editor, GroupDocs.Editor needs to generate an HTML version of the document, because any WYSIWYG editor works with HTML/CSS markup. After creating an instance of the `Editor` class in the first stage, you should **[open the document for editing](/editor/nodejs-java/developer-guide/edit-document/)** by calling the `edit()` method of the `Editor` class. This method returns an instance of the `EditableDocument` class. This class represents a converted version of the input document stored in an internal intermediate format compatible with all formats that GroupDocs.Editor supports. With `EditableDocument`, you can obtain the HTML markup of the input document with different options, stylesheets, images, fonts, save the HTML document to disk, and other operations. It is implied that the HTML markup emitted by `EditableDocument` is then passed to the client-side WYSIWYG HTML editor, where the end-user can actually edit the document.

Like with loading, the `edit()` method accepts optional `IEditOptions` inheritors that control how exactly the document will be opened for editing.

```javascript
const editOptions = new groupdocsEditor.WordProcessingEditOptions();
editOptions.setEnableLanguageInformation(true);

const readyToEdit = editor.edit(editOptions);
```

After this stage, the document is ready to be passed to the WYSIWYG HTML editor, and its content can be edited by the end-user.

## Saving a Document

**[Saving a document](/editor/nodejs-java/developer-guide/save-document/)** is the final stage, which occurs when the document content has been edited in the WYSIWYG HTML editor (or any other software—it makes no difference to GroupDocs.Editor) and should be saved back as a document in some format (like DOCX, PDF, or XLSX). At this stage, you should create a new instance of the `EditableDocument` class with the HTML markup and resources of the edited version of the original document obtained from the end-user. The `EditableDocument` class contains several static methods that allow you to create its instances from HTML documents that may be presented in different forms. Once the `EditableDocument` instance is ready, you can save it as an ordinary document using the `save()` method of the `Editor` class.

```javascript
const editedContent = '<body>HTML content of the document...</body>';
const afterEdit = groupdocsEditor.EditableDocument.fromMarkup(editedContent, null);
const outputFilePath = 'C:\\output_path\\document.rtf';
const saveOptions = new groupdocsEditor.WordProcessingSaveOptions(groupdocsEditor.WordProcessingFormats.Rtf);
editor.save(afterEdit, outputFilePath, saveOptions);
```

Unlike previous load options and edit options, save options are mandatory because GroupDocs.Editor needs to know the exact document format for saving.

## Detecting Document Type

Sometimes it is necessary to **[detect a document type and extract its metadata](/editor/nodejs-java/developer-guide/extracting-document-metainfo/)** before sending it for editing. For such scenarios, GroupDocs.Editor allows you to detect the document type and extract its most necessary metadata depending on the document type:

1. Is the document encoded or not?
2. Exact document format.
3. Document size.
4. Number of pages (or tabs).
5. Text encoding, if the document is textual.

To detect the document type and gather its metadata, you should load the desired document into the `Editor` class and then call the `getDocumentInfo()` method.

```javascript
const editor = new groupdocsEditor.Editor(inputStream);
const documentInfo = editor.getDocumentInfo();
```

## Describing Options

At every stage, you can adjust (tune) the processing by using different options:

1. `ILoadOptions` for **loading** the document.
2. `IEditOptions` for opening the document for **editing**.
3. `ISaveOptions` for **saving** the edited document.

Some of these options may be optional in specific cases, while others are mandatory. For example, it is possible to load a document into the `Editor` class without loading options—in such a case, GroupDocs.Editor will try to detect the document format automatically and apply the most appropriate default options for the detected document format.

### Describing Family Formats

All document formats supported by GroupDocs.Editor are grouped into family formats. Each family format has many common features, so there are no options for each format—only for the family format. The relation between formats, family formats, import/export formats, and options is illustrated in the table below.

| Family Format         | Supported Formats                                                                                   | Load                                   | Save                                   | Load Options                                                | Edit Options                                                 | Save Options                                                  | Metadata                                                                 |
|-----------------------|-----------------------------------------------------------------------------------------------------|----------------------------------------|----------------------------------------|-------------------------------------------------------------|--------------------------------------------------------------|---------------------------------------------------------------|--------------------------------------------------------------------------|
| WordProcessing        | DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, WordprocessingML Flat XML, ODT, OTT, Word 2003 XML           | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | `WordProcessingLoadOptions`                                  | `WordProcessingEditOptions`                                   | `WordProcessingSaveOptions`                                    | `WordProcessingDocumentInfo`                                              |
| Spreadsheet           | XLS, XLT, XLSX, XLSM, XLSB, XLTX, XLTM, XLAM, SpreadsheetML XML, ODS, FODS, SXC, DIF                | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | `SpreadsheetLoadOptions`                                     | `SpreadsheetEditOptions`                                      | `SpreadsheetSaveOptions`                                       | `SpreadsheetDocumentInfo`                                                 |
| DSV                   | CSV, TSV, semicolon-separated, whitespace-separated, arbitrary separator                             | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | N/A                                                         | `DelimitedTextEditOptions`                                    | `DelimitedTextSaveOptions`                                     | N/A                                                                      |
| Presentation          | PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP                                         | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | `PresentationLoadOptions`                                    | `PresentationEditOptions`                                     | `PresentationSaveOptions`                                      | `PresentationDocumentInfo`                                                |
| XML                   | Any XML document                                                                                    | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | ![error](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAhElEQVQ4T2NkoBAwUqifAEY/BiBaAVDC6ATITJoNwjGCKMkD8TaioShgsgagBqgDoHLEP4R0rJQDxH5DHASIRWB6wgYUg7iATCizAUxoADNVxigC0QK0V6I1g1EDpD6QlQSgHkWFAFcIlQEGakEATKhcAiHQA0RqlAzUAsYDZBrAFk4ikpW0QBpK9BJAKoQiIfT2EAJxBYAAAAAElFTkSuQmCC) | N/A                                                         | `XmlEditOptions`                                             | N/A                                                          | `TextualDocumentInfo`                                                     |
| TXT                   | Any text document                                                                                   | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | N/A                                                         | `TextEditOptions`                                            | `TextSaveOptions`                                             | `TextualDocumentInfo`                                                     |
| Fixed-layout format   | PDF                                                                                                 | ![error](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAhElEQVQ4T2NkoBAwUqifAEY/BiBaAVDC6ATITJoNwjGCKMkD8TaioShgsgagBqgDoHLEP4R0rJQDxH5DHASIRWB6wgYUg7iATCizAUxoADNVxigC0QK0V6I1g1EDpD6QlQSgHkWFAFcIlQEGakEATKhcAiHQA0RqlAzUAsYDZBrAFk4ikpW0QBpK9BJAKoQiIfT2EAJxBYAAAAAElFTkSuQmCC) | ![tick](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAAt0lEQVQ4T6WU0Q3CMBBF+5ZcAHZAK3YAm0Aj0Ar0AtIAtwAtwAtAKvSCpJcJtyddxhuHuZJJIwvqOaZ6V7ivAlUFc/xB85BUCSPuAmTAER4CimxCfAFctXr8FQCXX+jhV2AFVwzIrgVUgE0+uQ7JtwMgG8xH0cAHkEVDZgFSr4RAE6cUHgP0JtMDcKoCwLoY4+qwHIJ/AuhJeBWq1JkIBczXz/D32AyppAIpAHmV5nCXe/sdc3ibN43qAAAAAElFTkSuQmCC) | N/A                                                         | N/A                                                          | `PdfSaveOptions`                                              | N/A                                                                      |

### Additional Materials

Detailed information about every stage of document processing, along with source code examples and options explanations, can be found in the following articles:

1. [Load Document](/editor/nodejs-java/developer-guide/load-document/)
2. [Edit Document](/editor/nodejs-java/developer-guide/edit-document/)
3. [Save Document](/editor/nodejs-java/developer-guide/save-document/)

A complete description of the `EditableDocument` class, all its possibilities, members, and purpose, along with source code examples, is located in the following articles:

- [Working with EditableDocument](/editor/nodejs-java/developer-guide/editabledocument/)
- [Get HTML Markup in Different Forms](/editor/nodejs-java/developer-guide/editabledocument/get-html-markup-in-different-forms/)
- [Save HTML to Folder](/editor/nodejs-java/developer-guide/editabledocument/save-html-to-folder/)
- [Working with Resources](/editor/nodejs-java/developer-guide/editabledocument/working-with-resources/)
- [Create EditableDocument from File or Markup](/editor/nodejs-java/developer-guide/editabledocument/create-editabledocument-from-file-or-markup/)

A detailed review of all supported family formats, along with explanations of their load/edit/save options, illustrated with source code, can be found in the following articles:

- [Working with WordProcessing Documents](/editor/nodejs-java/developer-guide/edit-document/edit-word/)
- [Working with Spreadsheets](/editor/nodejs-java/developer-guide/edit-document/edit-excel/)
- [Working with DSV](/editor/nodejs-java/developer-guide/edit-document/how-to-edit-csv-file/)
- [Working with Presentations](/editor/nodejs-java/developer-guide/edit-document/edit-powerpoint/)
- [Working with Text Documents](/editor/nodejs-java/developer-guide/edit-document/edit-txt/)

---
---

## Iterate through container items

Path: /parser/java/iterate-through-container-items/

  
GroupDocs.Parser provides the functionality to extract items from containers by the [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method:

```java
Iterable<ContainerItem> getContainer();
```

This method returns a collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects:

| Member | Description |
| --- | --- |
| [getName](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getName()) | The name of the item. |
| [getDirectory](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getDirectory()) | The directory of the item. |
| [getFilePath](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getFilePath()) | The full path of the item. |
| [getSize](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getSize()) | The size of the item in bytes. |
| [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getMetadata()) | The collection of item metadata. |
| [openStream](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openStream()) | Opens the stream of the item content. |
| [openParser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openParser()) | Creates the Parser object for the item content. |
| [openParser(LoadOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openParser(com.groupdocs.parser.options.LoadOptions)) | Creates the Parser object for the item content with [LoadOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions). |
| [openParser(LoadOptions, ParserSettings)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openParser(com.groupdocs.parser.options.LoadOptions,%20com.groupdocs.parser.options.ParserSettings)) | Creates the Parser object for the item content with [LoadOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions) and [ParserSettings](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ParserSettings). |

Here are the steps to extract container from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and obtain collection of document [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and get container item names, sizes and obtain content.

The following example shows how to extract attachments from a container:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleZip)) {
    // Extract attachments from the container
    Iterable<ContainerItem> attachments = parser.getContainer();
    // Check if container extraction is supported
    if (attachments == null) {
        System.out.println("Container extraction isn't supported");
    }
    // Iterate over attachments
    for (ContainerItem item : attachments) {
        // Print an item name and size
        System.out.println(String.format("%s: &s", item.getName(), item.getSize()));
    }
}
```

Container represents both container-only files (like zip archives, outlook storage) and documents with attachments (like emails, PDF Portfolios).

In case of outlook storage (ost/pst files) container consists of email documents (msg files).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Iterate through container items

Path: /parser/net/iterate-through-container-items/

GroupDocs.Parser provides the functionality to extract items from containers by the [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method:

```csharp
IEnumerable<ContainerItem> GetContainer();
```

This method returns a collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects:

| Member | Description |
| --- | --- |
| [Name](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/name) | The name of the item. |
| [Directory](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/directory) | The directory of the item. |
| [FilePath](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/filepath) | The full path of the item. |
| [Size](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/size) | The size of the item in bytes. |
| [Metadata](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/metadata) | The collection of item metadata. |
| [DetectFileType](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/containeritem/methods/detectfiletype) | Detects a file type of the container item. |
| Stream [OpenStream()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/methods/openstream) | Opens the stream of the item content. |
| Parser [OpenParser()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/methods/openparser) | Creates the [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the item content. |
| Parser [OpenParser(LoadOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.containeritem/openparser/methods/1) | Creates the [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the item content with [LoadOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions). |
| Parser [OpenParser(LoadOptions, ParserSettings)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.containeritem/openparser/methods/2) | Creates the [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the item content with [LoadOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions) and [ParserSettings](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/parsersettings). |

Here are the steps to extract container from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and get container item names, sizes and obtain content.

The following example shows how to extract attachments from a container:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();
    // Check if container extraction is supported
    if(attachments == null)
    {
        Console.WriteLine("Container extraction isn't supported");
    }

    // Iterate over attachments
    foreach(ContainerItem item in attachments)
    {
        // Print an item name and size
        Console.WriteLine(string.Format("{0}: {1}", item.Name, item.Size));
    }
}
```

Container represents both container-only files (like zip archives, outlook storage) and documents with attachments (like emails, PDF Portfolios).

In case of outlook storage (ost/pst files) container consists of email documents (msg files)

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## List attachments

Path: /viewer/java/how-to-list-attachments/

To get a list of all attachments to a source file, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object. Specify a file that contains attachments.
2. Call the [getAttachments](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getAttachments--) method. It returns the attachment collection.
3. Iterate through the collection.

The following code snippet shows how to get a list of attachments from the MSG file:


{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.results.Attachment;
// ...

try (Viewer viewer = new Viewer("sample.msg")) {
    List<Attachment> attachments = viewer.getAttachments();

    System.out.println("\nAttachments:");
    for (Attachment attachment : attachments) {
        System.out.println(attachment);
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/java/images/how-to-list-attachments.png)

---

## List attachments

Path: /viewer/net/how-to-list-attachments/

To get a list of all attachments to a source file, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify a file that contains attachments.
2. Call the [GetAttachments](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getattachments) method. It returns the attachment collection.
3. Iterate through the collection.

The following code snippet shows how to get a list of attachments from the MSG file:


{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using System.Collections.Generic;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("sample.msg"))
{
    // Get list of attachments.
    IList<Attachment> attachments = viewer.GetAttachments();

    // Display list of attachments.
    Console.WriteLine("\nAttachments:");
    foreach (Attachment attachment in attachments)
        Console.WriteLine(attachment);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports System.Collections.Generic
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.msg")
            ' Get list of attachments.
            Dim attachments As IList(Of Attachment) = viewer.GetAttachments()
        
            ' Display list of attachments.
            Console.WriteLine(Global.Microsoft.VisualBasic.Constants.vbLf & "Attachments:")
            For Each attachment As Attachment In attachments
                Console.WriteLine(attachment)
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-list-attachments.png)

---

## Load CAD document with options

Path: /conversion/java/load-cad-document-with-options/


This documentation explains how to load CAD documents with configurable options using GroupDocs.Conversion for Java. It provides a flexible approach to handling and converting CAD files (such as DWG, DXF, and others) into various target formats (e.g., PDF, PNG, JPEG). Developers can customize the rendering and conversion process to suit their specific requirements using the [CadLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CadLoadOptions) class. The following options can be set:
| Option | Description |
|--------|-------------|
| [**setFormat()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CadLoadOptions#setFormat(com.groupdocs.conversion.filetypes.CadFileType)) | Allows you to the source document format explicitly with this property. Available options are: Dxf, Dwg, Dgn, Dwf, Stl, Ifc, Plt, Igs, Dwt. |
| [**setWidth()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CadLoadOptions#setWidth(int)) | Sets the desired page width. |
| [**setHeight()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CadLoadOptions#setHeight(int)) | Sets the desired page height. |
| [**setLayoutNames()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/CadLoadOptions#setLayoutNames(java.lang.String[])) | Specifies which CAD layout to be converted. |

### Specify layouts to be converted

The following code snippet shows how to convert a CAD document and convert only certain layouts:

{{< tabs "code-example">}}
{{< tab "ConvertCadAndSpecifyLayouts.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.CadLoadOptions;

public class ConvertCadAndSpecifyLayouts {
    public static void convert() {
        CadLoadOptions loadOptions =  new CadLoadOptions();
        loadOptions.setLayoutNames(new  String[]{ "Layout1", "Layout3" });

        try(Converter converter = new Converter("with_layers_and_layouts.dwg", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_layout.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "with_layers_and_layouts.dwg" >}}  
{{< tab-text >}}
`with_layers_and_layouts.dwg` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-cad-document-with-options/with_layers_and_layouts.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_layout.pdf" >}}  
{{< tab-text >}}
`converted_with_layout.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-cad-document-with-options/converted_with_layout.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


---

## Load CAD document with options

Path: /conversion/net/load-cad-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [CadLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/cadloadoptions) to give you control over how the source CAD document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/cadloadoptions/format)** | The source document type is auto-detected, but you could set the source document format explicitly with this property. Available options are: Dxf, Dwg, Dgn, Dwf, Stl, Ifc, Plt, Igs, Dwt |
|**[BackgroundColor](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/cadloadoptions/backgroundcolor/)** | Specifies the background color for a CAD document. |
|**[DrawType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/cadloadoptions/drawtype/)** | Specifies the type of drawing of a CAD document. |
|**[Width](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/cadloadoptions/width)** | Sets the desired page width |
|**[Height](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/cadloadoptions/height)** | Sets the desired page height |
|**[LayoutNames](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/cadloadoptions/layoutnames)** | Specifies which CAD layout to be converted |

### Specify layouts to be converted

The following code snippet shows how to convert a CAD document and convert only certain layouts:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CadLoadOptions
{
    LayoutNames = new []{ "Layout1", "Layout3" }
};
using (Converter converter = new Converter("with_layers_and_layouts.dwg", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify background color

The following code snippet shows how to convert a CAD document and specify its desired background color:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CadLoadOptions
{
    BackgroundColor = System.Drawing.Color.White
};
using (Converter converter = new Converter("sample.dwg", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```
---

## Load CAD document with options

Path: /conversion/nodejs-java/load-cad-document-with-options/

GroupDocs.Conversion provides [CadLoadOptions](#) to give you control over how the source CAD document will be processed. The following options could be set:

*   [**setFormat**](#) allows you to set the source document format explicitly with this property. Available options are: Dxf, Dwg, Dgn, Dwf, Stl, Ifc, Plt, Igs, Dwt.
*   [**setWidth**](#) sets the desired page width. 
*   [**setHeight**](#) sets the desired page height.
*   [**setLayoutNames**](#) specifies which CAD layout to be converted.

### Specify layouts to be converted

The following code snippet shows how to convert a CAD document and convert only certain layouts:

```js
const outputPath = "ConvertCadAndSpecifyLayouts.pdf"
  
const loadOptions = new groupdocs.conversion.CadLoadOptions()
loadOptions.setLayoutNames(["Layout1", "Layout3"]);
const converter = new groupdocs.conversion.Converter("with_layers_and_layouts.dwg", () => loadOptions);

const convertOptions = new groupdocs.conversion.PdfConvertOptions()
console.log(`Cad document converted successfully to ${outputPath} (cad & specify layouts)`)
converter.convert(outputPath, convertOptions)
```

### Specify width and height

The following code snippet shows how to convert a CAD document and specify the width and height:

```js
const outputPath = "convertCadAndSpecifyWidthAndHeight.tiff"

const loadOptions = new groupdocs.conversion.CadLoadOptions()
loadOptions.setWidth(1920);
loadOptions.setHeight(1080);

const converter = new groupdocs.conversion.Converter("with_layers_and_layouts.dwg", () => loadOptions);

const convertOptions = new groupdocs.conversion.ImageConvertOptions();
convertOptions.setFormat_ConvertOptions_New(groupdocs.conversion.ImageFileType.Tiff);

console.log(`Cad document converted successfully to ${outputPath} (cad & specify width and height)`)
converter.convert(outputPath, convertOptions)
```

---

## Load document from InputStream

Path: /merger/java/load-document-from-inputstream/

There might be the case when source or target document is not physically located on the disk. Instead, you have the document in the form of a InputStream. In this case, to avoid the overhead of saving InputStream as a file on disk, [**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) provides a way to work with document streams directly.   
The following are the steps to be followed:

*   Obtain document InputStream; 
*   Pass opened source document stream to [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) class constructor.

Following code snippet describes this case.

```java
try {
    InputStream stream = new FileInputStream("c:\\sample.docx");
    Merger merger = new Merger(stream);
    System.out.print("Document loaded from stream successfully.");
} catch (Exception e){
    throw new GroupDocsException(e.getMessage());
}
 
```

---

## Load document from local disk

Path: /annotation/java/load-document-from-local-disk/


The following code snippet shows how to load documents from local disk:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates loading document from file path.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setBackgroundColor(65535);
    
    // Add annotation and save to file
    annotator.add(area);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load document from local disk

Path: /annotation/net/load-document-from-local-disk/


The following code snippet shows how to load documents from local disk:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("source.docx"))
{
	AreaAnnotation area = new AreaAnnotation()
       {
       	Box = new Rectangle(100, 100, 100, 100),
       	BackgroundColor = 65535,
       };
       annotator.Add(area);
       annotator.Save("result.pdf", new SaveOptions());
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load document from local disk

Path: /conversion/java/load-document-from-local-disk/


To load the source file from a local disk, use the following implementations of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/Converter) class constructor:

* [Converter(String filePath)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#Converter-java.lang.String-)
* [Converter(String filePath, ConverterSettingsProvider settings)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#Converter-java.lang.String-com.groupdocs.conversion.contracts.ConverterSettingsProvider-)
* [Converter(String filePath, LoadOptionsProvider loadOptions)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#Converter-java.lang.String-com.groupdocs.conversion.contracts.LoadOptionsProvider-)
* [Converter(String filePath, LoadOptionsProvider loadOptions, ConverterSettingsProvider settings)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#Converter-java.lang.String-com.groupdocs.conversion.contracts.LoadOptionsProvider-com.groupdocs.conversion.contracts.ConverterSettingsProvider-)
* [Converter(String filePath, LoadOptionsForFileTypeProvider loadOptions)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#Converter-java.lang.String-com.groupdocs.conversion.contracts.LoadOptionsForFileTypeProvider-)
* [Converter(String filePath, LoadOptionsForFileTypeProvider loadOptions, ConverterSettingsProvider settings)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#Converter-java.lang.String-com.groupdocs.conversion.contracts.LoadOptionsForFileTypeProvider-com.groupdocs.conversion.contracts.ConverterSettingsProvider-)

All these constructors have the `filePath` string parameter which specifies the location of the source file. File path can be absolute or relative. If the source file does not exist, an exception occurs.

GroupDocs.Conversion opens the file for reading only when any other methods of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/Converter) class are called.

The following code snippet shows how to load a file from a local disk:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
Converter converter = new Converter("c:\\files\\sample.docx");
PdfConvertOptions options = new PdfConvertOptions();

converter.convert("converted.pdf", options);
```
---

## Load document from local disk

Path: /conversion/nodejs-java/load-document-from-local-disk/


To load the source file from a local disk, use the following implementations of the [Converter](#) class constructor:

* [Converter(String filePath)](#)
* [Converter(String filePath, ConverterSettingsProvider settings)](#)
* [Converter(String filePath, LoadOptionsProvider loadOptions)](#)
* [Converter(String filePath, LoadOptionsProvider loadOptions, ConverterSettingsProvider settings)](#)
* [Converter(String filePath, LoadOptionsForFileTypeProvider loadOptions)](#)
* [Converter(String filePath, LoadOptionsForFileTypeProvider loadOptions, ConverterSettingsProvider settings)](#)

All these constructors have the `filePath` string parameter which specifies the location of the source file. File path can be absolute or relative. If the source file does not exist, an exception occurs.

GroupDocs.Conversion will open the file for reading only when any other methods of the [Converter](#) class are called.

The following code snippet shows how to load a file from a local disk:

```js
const converter =  new groupdocs.conversion.Converter("sample.docx");
const convertOptions =  new groupdocs.conversion.PdfConvertOptions();

converter.convert("loadDocumentFromLocalDisk.pdf", convertOptions);
```
---

## Load document from local disk

Path: /merger/net/load-document-from-local-disk/

When the source document is located on the local disk **[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows you to load it via [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class constructor specifying absolute or relative path to it.  
The following code snippet shows how to load documents from local disk.

```csharp
string filePath = @"c:\sample.docx";
using (Merger merger = new Merger(filePath))
{
	Console.WriteLine($"Document loaded from local disk successfully.");
}
```

---

## Load document from local disk

Path: /parser/java/load-document-from-local-disk/

GroupDocs.Parser provides the functionality to extract data from documents on the local disk.

The following example shows how to load the document from the local disk:

```java
// Set the filePath
String filePath = Constants.SamplePdf;
// Create an instance of Parser class with the filePath
try (Parser parser = new Parser(filePath)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Load document using the local path string

Path: /viewer/java/load-document-from-local-disk/

You can load a document from a local disk using a path to a file. GroupDocs.Viewer opens the file in the read-only mode.

The following code snippet shows how to load a document using the local path string:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load document using the local path string

Path: /viewer/net/load-document-from-local-disk/

You can load a document from a local disk using a path to a file. GroupDocs.Viewer opens the file in the read-only mode.

The following code snippet shows how to load a document using the local path string:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Specify a path to a file.
string filePath = "sample.docx";

// Render the file.
using (Viewer viewer = new Viewer(filePath))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
} 
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Specify a path to a file.
        Dim filePath As String = "sample.docx"
    
        ' Render the file.
        Using viewer As Viewer = New Viewer(filePath)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Load document using the local path string

Path: /viewer/python-net/load-document-from-local-disk/

You can load a document from a local disk using a path to a file. GroupDocs.Viewer opens the file in the read-only mode.

The following code snippet shows how to load a document using the local path string:

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def load_document_from_local_disk():
    # Load document from local disk
    with Viewer("sample.docx") as viewer:
        html_options = HtmlViewOptions.for_embedded_resources("load_document_from_local_disk/document_from_local_disk_{0}.html")
        viewer.view(html_options)

if __name__ == "__main__":
    load_document_from_local_disk()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/loading-documents/loading-documents-from-different-sources/load-document-from-local-disk/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Load file from local disk

Path: /comparison/java/load-file-from-local-disk/


When the source file is located on the local disk, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to load it using the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) class constructor by specifying absolute or relative path. To load the target file located on the local disk, use the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify absolute or relative path as parameter.

The following code snippet shows how to load files from local disk:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.pdf")) {
    comparer.add("target.pdf");
    final Path resultPath = comparer.compare("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load file from local disk

Path: /comparison/net/load-file-from-local-disk/


When the source file is located on the local disk, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to load it using the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) class constructor by specifying absolute or relative path. To load the target file located on the local disk, use the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify absolute or relative path as parameter.

The following code snippet shows how to load files from local disk:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load file from local disk

Path: /comparison/nodejs-java/load-file-from-local-disk/


When the source file is located on the local disk, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to load it using the `Comparer` class constructor by specifying an absolute or relative path. To load the target file located on the local disk, use the `add()` method. Specify an absolute or relative path as the parameter.

The following code snippet shows how to load files from a local disk:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for the source, target, and result DOCX files
const sourceDocxPath = 'sample-files/source.docx';
const targetDocxPath = 'sample-files/target.docx';
const resultDocxPath = 'result.docx';

// Create a Comparer instance using the source document
const comparer = new groupdocs.Comparer(sourceDocxPath);

// Add the target document to the comparison set
comparer.add(targetDocxPath);

// Perform the comparison and write the merged result to the output file
comparer.compare(resultDocxPath);

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates the simplest way to compare documents from local disk storage. It creates a `Comparer` instance by passing the source document path directly to the constructor, adds the target document using the `add()` method with its file path, and then performs the comparison by calling `compare()` with the result file path. The result document will contain all detected differences between the source and target documents.

---

## Load file from local disk

Path: /comparison/python-net/load-file-from-local-disk/


When the source file is located on the local disk, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to load it using the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> class constructor by specifying an absolute or relative path. To load the target file located on the local disk, use the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method. Specify an absolute or relative path as the parameter.

The following code snippet shows how to load files from a local disk:

```python
import groupdocs.comparison as gc

def load_file_from_local_disk(output_file_path, source_file_path, target_file_path):  
    # Initialize comparer with the source document
    with gc.Comparer(source_file_path) as comparer:
        # Add the target document for comparison
        comparer.add(target_file_path)
        
        # Compare the documents and save the result
        comparer.compare(output_file_path)
    
    # Log the success message with the output file path
    print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
```
---

## Load file from local disk

Path: /conversion/net/load-file-from-local-disk/

To load the source file from a local disk, use the following implementations of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class constructor:

* [Converter(string filePath)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/converter/#constructor_7)
* [Converter(string filePath, Func<ConverterSettings> settings)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/converter/#constructor_8)
* [Converter(string filePath, Func<LoadOptions> loadOptions)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/converter/#constructor_9)
* [Converter(string filePath, Func<LoadOptions> loadOptions, Func<ConverterSettings> settings)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/converter/#constructor_10)
* [Converter(string filePath, Func<FileType, LoadOptions> loadOptions)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/converter/#constructor_11)
* [Converter(string filePath, Func<FileType, LoadOptions> loadOptions, Func<ConverterSettings> settings)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/converter/#constructor_12)

All these constructors have the `filePath` string parameter which specifies the location of the source file. File path can be absolute or relative. If the source file does not exist, an exception occurs.

GroupDocs.Conversion will open the file for reading only when any other methods of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class are called.

The following code snippet shows how to load a file from a local disk:

```csharp
public static void Run()
{
    // Specify source file location
    using (Converter converter = new Converter("c:\\files\\sample.docx")) 
    {
        PdfConvertOptions options = new PdfConvertOptions();
        // Specify output file location
        converter.Convert("c:\\files\\converted.pdf", options);
    }
}
```

You can also use the [FluentConverter.Load(string fileName)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/fluentconverter/load/#load_2) and [FluentConverter.Load(string[] fileName)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/fluentconverter/load/#load_3) [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}}) methods to load the source file from a local disk.

```csharp
public static void Run()
{
FluentConverter
    // Specify source file location
    .Load("c:\\files\\sample.docx")
    // Specify output file location
    .ConvertTo("c:\\files\\converted.pdf")
    .Convert();
}
```
---

## Load file from local disk

Path: /parser/python-net/load-file-from-local-disk/


When the document file is located on the local disk, [GroupDocs.Parser](https://products.groupdocs.com/parser/python-net) allows you to load it using the `Parser` class constructor by specifying an absolute or relative path.

The following code snippet shows how to load a document from a local disk:

## Load document by file path
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Specify the file path (absolute or relative)
file_path = "sample.docx"

# Create an instance of Parser class with the file path
with Parser(file_path) as parser:
    # Extract text from the document
    text_reader = parser.get_text()
    
    if text_reader is not None:
        # Print the extracted text
        print(text_reader)
    else:
        print("Text extraction isn't supported for this format")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-file-from-local-disk/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Load document with absolute path
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Specify an absolute file path
file_path = "sample.pdf"

# Create an instance of Parser class
with Parser(file_path) as parser:
    # Get document info
    doc_info = parser.get_document_info()
    
    print(f"File type: {doc_info.file_type.file_format}")
    print(f"Page count: {doc_info.page_count}")
    print(f"File size: {doc_info.size} bytes")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-file-from-local-disk/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Batch processing multiple files
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

def process_files_from_directory(directory_path):
    """Process all supported documents in a directory"""
    
    # Get all files in the directory
    for filename in os.listdir(directory_path):
        file_path = os.path.join(directory_path, filename)
        
        # Skip if not a file
        if not os.path.isfile(file_path):
            continue
        
        try:
            print(f"
Processing: {filename}")
            
            # Create parser instance
            with Parser(file_path) as parser:
                # Get document info
                doc_info = parser.get_document_info()
                print(f"  Type: {doc_info.file_type.file_format}")
                print(f"  Pages: {doc_info.page_count}")
                
                # Extract text
                text_reader = parser.get_text()
                if text_reader:
                    text = text_reader
                    print(f"  Characters: {len(text)}")
                    
        except Exception as e:
            print(f"  Error: {e}")
```

{{< /tab >}}
{{< /tabs >}}

## Error handling

It's good practice to handle potential errors when loading files:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

def safe_load_document(file_path):
    """Safely load a document with error handling"""
    
    # Check if file exists
    if not os.path.exists(file_path):
        print(f"Error: File not found - {file_path}")
        return None
    
    try:
        # Create parser instance
        parser = Parser(file_path)
        print(f"Document loaded successfully: {file_path}")
        return parser
        
    except Exception as e:
        print(f"Error loading document: {e}")
        return None

# Try to load a document
parser = safe_load_document("sample.pdf")

if parser:
    try:
        # Extract data
        text_reader = parser.get_text()
        if text_reader:
            print(text_reader)

```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-file-from-local-disk/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub examples

You may find more code examples in our GitHub repository:

*   [GroupDocs.Parser for Python via .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET)

### Free online document parser

Along with the full-featured library, we provide a free online document parser app. You are welcome to extract data from PDF, DOCX, XLSX, and more with our [Free Online Document Parser App](https://products.groupdocs.app/parser).


---

## Load from a local disk

Path: /markdown/net/load-from-a-local-disk/


GroupDocs.Markdown provides two ways to load a file from a local disk: the static one-liner API and the instance-based API.

### Using static method

The simplest approach -- pass a file path and get the Markdown string back:

{{< tabs "load-disk-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Convert a local file to Markdown in one call
string markdown = MarkdownConverter.ToMarkdown("business-plan.docx");

// Or save the result directly to a file
MarkdownConverter.ToFile("business-plan.docx", "load-disk-static.md");
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/loading/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-disk-static.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-from-a-local-disk/LoadDiskStatic/load-disk-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

When you need more control (e.g., conversion options, document info), create a `MarkdownConverter` instance:

{{< tabs "load-disk-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

using var converter = new MarkdownConverter("business-plan.docx");

// Retrieve document metadata
DocumentInfo info = converter.GetDocumentInfo();
Console.WriteLine($"Format: {info.FileFormat}, Pages: {info.PageCount}");

// Convert to Markdown
converter.Convert("load-disk-instance.md");
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/loading/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-disk-instance.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-from-a-local-disk/LoadDiskInstance/load-disk-instance.md)
{{< /tab >}}
{{< /tabs >}}

---

## Load from a local disk

Path: /markdown/python-net/load-from-a-local-disk/


GroupDocs.Markdown provides two ways to load a file from a local disk: the static one-liner API and the instance-based API.

### Using static method

The simplest approach -- pass a file path and get the Markdown string back:

{{< tabs "load-disk-static">}}
{{< tab "load_from_disk_static.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def load_from_disk_static():
    """Load and convert a local file to Markdown using the static API."""

    # Step 1: Convert a local file to a Markdown string in one call
    markdown = MarkdownConverter.to_markdown("business-plan.docx")

    # Step 2: Or save the result directly to a file on disk
    MarkdownConverter.to_file("business-plan.docx", "load-from-disk-static.md")

if __name__ == "__main__":
    load_from_disk_static()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/loading/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-from-disk-static.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



|  | TABLE OF CONTENTS TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc9437451" Introduction	 PAGEREF _Toc9437451 \h 3  HYPERLINK \l "_Toc9437452" 1.	Executive Summary	 PAGEREF _Toc9437452 \h 5  HYPERLINK \l "_Toc9437453" 2.	Company Overview	 PAGEREF _Toc9437453 \h 6  HYPERLINK \l "_Toc9437454" 3.	Business Description	 PAGEREF _Toc9437454 \h 7  HYPERLINK \l "_Toc9437
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-local-disk/load_from_disk_static/load-from-disk-static.txt)
{{< /tab >}}
{{< tab "load-from-disk-static.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-local-disk/load_from_disk_static/load-from-disk-static.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

When you need more control (e.g., conversion options, document info), create a `MarkdownConverter` instance:

{{< tabs "load-disk-instance">}}
{{< tab "load_from_disk_instance.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def load_from_disk_instance():
    """Load a local file with the instance API, inspect metadata, then convert."""

    # Step 1: Open the document with a context manager
    with MarkdownConverter("business-plan.docx") as converter:
        # Step 2: Retrieve document metadata before converting
        info = converter.get_document_info()
        print(f"Format: {info.file_format}, Pages: {info.page_count}")

        # Step 3: Convert to Markdown and print the result
        converter.convert("load-from-disk-instance.md")

if __name__ == "__main__":
    load_from_disk_instance()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/loading/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-from-disk-instance.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



|  | TABLE OF CONTENTS TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc9437451" Introduction	 PAGEREF _Toc9437451 \h 3  HYPERLINK \l "_Toc9437452" 1.	Executive Summary	 PAGEREF _Toc9437452 \h 5  HYPERLINK \l "_Toc9437453" 2.	Company Overview	 PAGEREF _Toc9437453 \h 6  HYPERLINK \l "_Toc9437454" 3.	Business Description	 PAGEREF _Toc9437454 \h 7  HYPERLINK \l "_Toc9437
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-local-disk/load_from_disk_instance/load-from-disk-instance.txt)
{{< /tab >}}
{{< tab "load-from-disk-instance.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-local-disk/load_from_disk_instance/load-from-disk-instance.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Load from a local disk

Path: /metadata/java/load-from-a-local-disk/

The following example demonstrates how to load a file from a local disk.

**advanced\_usage.loading\_files.LoadFromLocalDisk**

```csharp
// Constants.InputOne is an absolute or relative path to your document. Ex: @"C:\Docs\source.one"
try (Metadata metadata = new Metadata(Constants.InputOne)) {
	// Extract, edit or remove metadata here
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load from a local disk

Path: /metadata/net/load-from-a-local-disk/

The following example demonstrates how to load a file from a local disk.

**AdvancedUsage.LoadingFiles.LoadFromLocalDisk**

```csharp
var inputPath = @"C:\Docs\source.one";
using (Metadata metadata = new Metadata(inputPath))
{
	// Extract, edit or remove metadata here
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load from a local disk

Path: /metadata/nodejs-java/load-from-a-local-disk/

The following example demonstrates how to load a file from a local disk.

**advanced\_usage.loading\_files.LoadFromLocalDisk**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
try {
    const metadata = new groupdocs.metadata.Metadata("input.one");
  }
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load from a local disk

Path: /metadata/python-net/load-from-a-local-disk/

The following example demonstrates how to load a file from a local disk using GroupDocs.Metadata for Python via .NET.

**advanced_usage.loading_files.load_from_local_disk**


```python
def run():
    # Absolute or relative path to your document, e.g. r"C:\\Docs\\source.one"
    input_path = r"C:\\Docs\\source.one"

    with gm.Metadata(input_path) as metadata:
        # Extract, edit or remove metadata here
        # ...
        pass
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Load from local disc

Path: /redaction/java/load-from-local-disc/

### Load from local disc

*GroupDocs.Redaction.Redactor* class is a main class in Redaction API, providing functionality to open a document. When document is located on the local disk, you can pass its path to *Redactor *class constructor.

The following example demonstrates how to open a document from local disc:



```java
final Redactor redactor = new Redactor("sample.docx");
try 
{
    // Here we can use document instance to perform redactions   
    redactor.apply(new DeleteAnnotationRedaction());
    redactor.save();
}
finally { redactor.close(); }
```

---

## Load from local disc

Path: /redaction/net/load-from-local-disc/

[GroupDocs.Redaction.Redactor](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor) class is a main class in Redaction API, providing functionality to open a document. When document is located on the local disk, you can pass its path to [Redactor](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor)  class constructor.

The following example demonstrates how to open a document from local disc:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
   // Here we can use document instance to perform redactions   
   redactor.Apply(new DeleteAnnotationRedaction());
   redactor.Save();
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Load from local disc

Path: /redaction/python-net/load-from-local-disc/

[GroupDocs.Redaction.Redactor](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor/) class is a main class in Redaction API, providing functionality to open a document. When document is located on the local disk, you can pass its path to [Redactor](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor)  class constructor.

The following example demonstrates how to open a document from local disc:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options - remove all annotations
    del_red = grr.DeleteAnnotationRedaction()

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(del_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Load from local disk

Path: /watermark/java/load-from-local-disk/

The folowing example demontrates how to create a [watermarker](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker) for a local filesystem document:

**advanced\_usage.loading\_documents.LoadFromLocalDisk**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
String filePath = "document.docx";                                                                 
Watermarker watermarker = new Watermarker(filePath);                                                        
// use watermarker methods to manage watermarks                                                             
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));                       
                                                                                                            
watermarker.add(watermark);                                                                                 
watermarker.save("document.docx");                                                                
watermarker.close();                                                                                      
```


---

## Load Options

Path: /parser/python-net/load-options/


Use `groupdocs.parser.options.LoadOptions` to pass extra parameters when opening a document, such as a password or file type when loading from a stream.

## Open a password-protected document
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

options = LoadOptions("secret-password")

with Parser("protected.pdf", options) as parser:
    reader = parser.get_text()
    print(reader if reader else "Text extraction isn't supported.")
```

{{< /tab >}}
{{< tab "protected.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [protected.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-options/protected.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Load from a stream

When you read from a stream, provide `LoadOptions` so the parser knows how to open the content (for example, password-protected PDF streams).
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

with open("resources/protected.pdf", "rb") as stream:
    options = LoadOptions("secret-password")
    with Parser(stream, options) as parser:
        reader = parser.get_text()
        print(reader if reader else "Text extraction isn't supported.")
```

{{< /tab >}}
{{< tab "protected.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [protected.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-options/protected.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Tips

- Always dispose of streams and parsers with `with` statements.  
- If a password is wrong, the parser raises an exception (see [errors and exceptions]({{< ref "parser/python-net/developer-guide/advanced-usage/loading/load-password-protected-documents.md" >}})).  
- For additional options (e.g., file type hints), see the [`LoadOptions` API reference](https://reference.groupdocs.com/parser/python-net/groupdocs.parser.options/loadoptions/).


---

## Load the password-protected documents

Path: /annotation/java/load-password-protected-documents/


[GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) allows you to annotate the password-protected documents.

To load a password protected file, follow these steps:

1. Instantiate the [LoadOptions](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the source document password as a parameter.
2. Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the document path or stream and the the [LoadOptions](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) object.


The following code snippet shows how to load a password protected file:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates annotating documents that are protected with a password.

// Create an instance of LoadOptions class and set password
LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("1234");

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath", loadOptions);
try {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setBackgroundColor(65535);
    
    // Add annotation and save to file
    annotator.add(area);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load the password-protected documents

Path: /annotation/net/load-password-protected-documents/


[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to annotate documents that are protected with a password.

To load a password protected file, follow these steps:

1. Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the document path or stream.
2. Instantiate the [LoadOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/loadoptions) class. Specify the source document password as a parameter.

The following code snippet shows how to load a password protected file:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf", new LoadOptions() { Password = "1234" }))
{
 	AreaAnnotation area = new AreaAnnotation()
    {
       	Box = new Rectangle(100, 100, 100, 100),
       	BackgroundColor = 65535,
    };
    annotator.Add(area);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Loading of template documents from HTML with resources

Path: /assembly/java/loading-of-template-documents-from-html-with-resources/

{{< alert style="info" >}}This feature is supported by version 19.5. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

# Loading of template documents from HTML with resources

[GroupDocs.Assembly](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/package-summary) provides a great feature which is loading of HTML template documents referencing external resource files to be assembled and saved to non-HTML formats. 

Since version 19.5, when loading an HTML document from a file, its containing folder is used as a base URI to resolve external resource files' relative URIs to absolute ones by default as shown in the following example. The following code snippet shows the way of API usage:

{{< gist GroupDocsGists 381806c98068837063997a0a4a687529 >}}

The following code snippet shows the default folder used to resolve external resource files' relative URIs are overridden by an explicitly specified folder.

{{< gist GroupDocsGists 9cf9468c519b98d916b1c37f8be9dc9a >}}



---

## Loading of template documents from HTML with resources

Path: /assembly/net/loading-of-template-documents-from-html-with-resources/

{{< alert style="info" >}}This feature is supported by version 19.5. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

GroupDocs.Assembly provides a great feature which is loading of HTML template documents referencing external resource files to be assembled and saved to non-HTML formats. 

Since version 19.5, when loading an HTML document from a file, its containing folder is used as a base URI to resolve external resource files' relative URIs to absolute ones by default as shown in the following example. The following code snippet shows the way of API usage:

{{< gist GroupDocsGists bfd1b9daaa9a1b0a020a20a3f56413f2 >}}

The following code snippet shows the default folder used to resolve external resource files' relative URIs are overridden by an explicitly specified folder.

{{< gist GroupDocsGists bd0d6a7a7cca104bbe73c4938f2a6cf7 >}}



---

## Loading specific file formats

Path: /parser/net/loading-specific-file-formats/

In some cases it's required to specify the document format manually to guarantee correct output produced by GroupDocs.Parser. The following are the cases when the document format must be specified manually:

*   Markdown documents
*   MHTML documents
*   OTP documents (OpenDocument Presentation Template)
*   Databases
*   Emails from remote servers

Here are the steps to specify the document format for Markup document.

*   Instantiate the [LoadOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions) object and pass the document format in [LoadOptions(FileFormat)](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions/constructors/1) constructor;
*   Create [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object and call any method.

The following example shows how to specify the document format for Markup document:  

```csharp
// Create an instance of Parser class for markdown document
using (Parser parser = new Parser(stream, new LoadOptions(FileFormat.Markup)))
{
    // Check if text extraction is supported
    if (!parser.Features.Text)
    {
        Console.WriteLine("Text extraction isn't supported.");
        return;
    }
    using (TextReader reader = parser.GetText())
    {
        // Print the document text
        // Markdown is detected; text without special symbols is printed
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).

---

## Locating signature on page with different measure units

Path: /signature/net/locating-signature-on-page-with-different-measure-units/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) supports locating signature on document page with different measure units. Enumeration [MeasureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/measuretype) handles following types

* [MeasureType.Pixels](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/measuretype) allows to locate signature position and size with pixels (default value)
* [MeasureType.Millimeters](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/measuretype) allows to locate signature on page and setup size by setting millimeters
* [MeasureType.Percents](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/measuretype) allows to locate signature position, size with percentage of page size  
  
Here are the steps to locate and size signature area with different measure unit types:

* Set property [LocationMeasureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/locationmeasuretype) with of one values above to specify how to implement values in properties [Left](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/left), [Top](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/top)
* Set property [SizeMeasureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/sizemeasuretype) with of one values above to specify how to implement size of signature values in properties [Width](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/width), [Height](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/height)
* Set property [MarginMeasureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/marginmeasuretype) with of one values above to specify how to implement values in property [Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/margin)

## Set signature positioning in millimeters

This example shows how to specify positioning in millimeters.

```csharp
 using (Signature signature = new Signature("sample.docx"))
 {
     // create barcode option with predefined barcode text
     BarcodeSignOptions options = new BarcodeSignOptions("12345678")
     {
         // setup Barcode encoding type
         EncodeType = BarcodeTypes.Code128,
         // set signature position in absolute position
         LocationMeasureType = MeasureType.Millimeters,
         Left = 40,
         Top = 50,
         // set signature area in millimeters
         SizeMeasureType = MeasureType.Millimeters,
         Width = 20,
         Height = 10,
         // set margin in millimeters
         MarginMeasureType = MeasureType.Millimeters,
         Margin = new Padding() { Left =5, Top = 5, Right = 5 },
     };
     // sign document to file
     signature.Sign("signedSample.docx", options);
 }
```

## Set signature positioning in percents

This example shows how to set different positioning properties in percentage.

```csharp
 using (Signature signature = new Signature("sample.pdf"))
 {
     // create barcode option with predefined barcode text
     BarcodeSignOptions options = new BarcodeSignOptions("12345678")
     {
         // setup Barcode encoding type
         EncodeType = BarcodeTypes.Code128,
         // set signature position in absolute position
         LocationMeasureType = MeasureType.Percents,
         Left = 5,
         Top = 5,
         // set signature area in millimeters
         SizeMeasureType = MeasureType.Percents,
         Width = 10,
         Height = 5,
         // set margin in millimeters
         MarginMeasureType = MeasureType.Percents,
         Margin = new Padding() { Left = 1, Top = 1, Right = 1 },
     };
     // sign document to file
     signature.Sign("signed.docx", options);
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Locking watermark in word processing document

Path: /watermark/java/locking-watermark-in-word-processing-document/

There might be the case when you need to lock the watermarks in a Word document to restrict the editing. To deal with such cases, GroupDocs.Watermark provides 5 variants of locking Word document when adding watermark.

*   **AllowOnlyRevisions**: user can only add revision marks to the document.
*   **AllowOnlyComments**: user can only modify comments in the document.
*   **AllowOnlyFormFields**: the document is split into one-page sections and locked section with watermark is added between each two adjacent document sections.
*   **ReadOnly**: the entire document is read-only.
*   **ReadOnlyWithEditableContent**: the document is read-only, but all the content except the watermark is marked as editable.

[setLockType()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkBaseOptions#setLockType(int)) method has been added to [WordProcessingWatermarkBaseOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkBaseOptions) class (and all descendants) to set any of the above-mentioned lock types. [WordProcessingLockType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingLockType) enum is used to define the lock type. The following code samples show how to lock watermark in different scenarios.

## Adding watermark to all pages

This example uses [WordProcessingWatermarkPagesOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkPagesOptions) with empty setPageNumbers().

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingAddLockedWatermarkToAllPages**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
TextWatermark watermark = new TextWatermark("Watermark text", new Font("Arial", 19));                      
watermark.setForegroundColor(Color.getRed());                                                              
                                                                                                           
WordProcessingWatermarkPagesOptions options = new WordProcessingWatermarkPagesOptions();                   
options.setLocked(true);                                                                                   
options.setLockType(WordProcessingLockType.AllowOnlyFormFields);                                           
                                                                                                           
// To protect with password                                                                                
//options.setPassword("7654321");                                                                          
                                                                                                           
watermarker.add(watermark, options);                                                                       
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Adding watermark to particular pages

This example uses [WordProcessingWatermarkPagesOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkPagesOptions) calling setPageNumbers() with numbers of two pages.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingAddLockedWatermarkToParticularPages**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
TextWatermark watermark = new TextWatermark("Watermark text", new Font("Arial", 19));                      
watermark.setForegroundColor(Color.getRed());                                                              
                                                                                                           
WordProcessingWatermarkPagesOptions options = new WordProcessingWatermarkPagesOptions();                   
options.setPageNumbers(new int[] { 1, 3 });                                                                
options.setLocked(true);                                                                                   
options.setLockType(WordProcessingLockType.AllowOnlyComments);                                             
                                                                                                           
// To protect with password                                                                                
//options.Password = "7654321";                                                                            
                                                                                                           
watermarker.add(watermark, options);                                                                       
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Adding watermark to a section

This example uses [WordProcessingWatermarkSectionOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkSectionOptions) calling [setSectionIndex()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkSectionOptions#setSectionIndex(int)).

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingAddLockedWatermarkToSection**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
TextWatermark watermark = new TextWatermark("Watermark text", new Font("Arial", 19));                      
watermark.setForegroundColor(Color.getRed());                                                              
                                                                                                           
WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();               
options.setSectionIndex(0);                                                                                
options.setLocked(true);                                                                                   
options.setLockType(WordProcessingLockType.ReadOnlyWithEditableContent);                                   
                                                                                                           
// To protect with password                                                                                
//options.setPassword("7654321");                                                                          
                                                                                                           
watermarker.add(watermark, options);                                                                       
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

---

## Merge HTML

Path: /merger/java/merge/html/


HTML (Hyper Text Markup Language) is the extension for web pages created for display in browsers. Known as language of the web, HTML has evolved with requirements of new information requirements to be displayed as part of web pages. The latest variant is known as HTML 5 that gives a lot of flexibility for working with the language. HTML pages are either received from server, where these are hosted, or can be loaded from local system as well.

## How to merge HTML files programmatically

When you need to merge multiple HTML pages into a single file you can do this  with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/java) and all content like text, images, tables, graphs, forms etc. will be preserved.

The following in an example of how to merge HTML files programmatically:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source HTML file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another HTML file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other HTML documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged HTML file as parameter.

```java
// Load the source HTML file
Merger merger = new Merger("c:\sample1.html")

// Add another HTML file to merge
merger.join("c:\sample2.html");
// Merge HTML files and save result
merger.save("c:\merged.html");
```

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge HTML Live Demo

GroupDocs.Merger for Java provides an online [**HTML Merger App**](https://products.groupdocs.app/merger/html), which allows you to try it for free and check its quality and accuracy.

---

## Merge HTML

Path: /merger/nodejs-java/merge/html/


HTML (Hyper Text Markup Language) is the extension for web pages created for display in browsers. Known as language of the web, HTML has evolved with requirements of new information requirements to be displayed as part of web pages. The latest variant is known as HTML 5 that gives a lot of flexibility for working with the language. HTML pages are either received from server, where these are hosted, or can be loaded from local system as well.

## How to merge HTML files programmatically

When you need to merge multiple HTML pages into a single file you can do this  with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) and all content like text, images, tables, graphs, forms etc. will be preserved.

The following in an example of how to merge HTML files programmatically:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source HTML file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another HTML file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other HTML documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged HTML file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.html');
merger.join('c:/sample2.html');
merger.save('c:/merged.html');
```

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge HTML Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**HTML Merger App**](https://products.groupdocs.app/merger/html), which allows you to try it for free and check its quality and accuracy.

---

## Merge HTML

Path: /merger/python-net/merge/html/


HTML (Hyper Text Markup Language) is the extension for web pages created for display in browsers. Known as language of the web, HTML has evolved with requirements of new information requirements to be displayed as part of web pages. The latest variant is known as HTML 5 that gives a lot of flexibility for working with the language. HTML pages are either received from server, where these are hosted, or can be loaded from local system as well.

## How to merge HTML files programmatically

When you need to merge multiple HTML pages into a single file you can do this  with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) and all content like text, images, tables, graphs, forms etc. will be preserved.

The following in an example of how to merge HTML files programmatically:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source HTML file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another HTML file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other HTML documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged HTML file as parameter.

```python
with gm.Merger("c:/sample1.html") as merger:
    merger.join("c:/sample2.html")
    merger.save("c:/merged.html")
```

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge HTML Live Demo

GroupDocs.Merger for Python via .NET provides an online [**HTML Merger App**](https://products.groupdocs.app/merger/html), which allows you to try it for free and check its quality and accuracy.

---

## Merge images

Path: /merger/java/merge/images/


## How to merge image files in Java

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple JPG documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine image documents of any JPG, PNG or BMP extensions.

The following example demonstrates how to merge image files with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```java
// Load the source image file
Merger merger = new Merger("c:\sample1.jpg")

// Define image join options with vertical join mode
ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
// Add another image file to merge
merger.join("c:\sample2.jpg", joinOptions);
// Merge image files and save result
merger.save("c:\merged.jpg");
```

### Merge different image file formats

This section describes how to merge different image file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge JPG images in Java]({{< ref "merger/java/getting-started/use-cases/how-to-merge-jpg-images-using-java.md" >}})
* [How to merge PNG images in Java]({{< ref "merger/java/getting-started/use-cases/how-to-merge-png-images-using-java.md" >}})
* [How to merge BMP images in Java]({{< ref "merger/java/getting-started/use-cases/how-to-merge-bmp-images-using-java.md" >}})

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Images Live Demo

GroupDocs.Merger offers the following free online tools to test its quality and accuracy:
* [**JPG Merger App**](https://products.groupdocs.app/merger/jpg)
* [**PNG Merger App**](https://products.groupdocs.app/merger/png)
* [**BMP Merger App**](https://products.groupdocs.app/merger/bmp)
---

## Merge images

Path: /merger/nodejs-java/merge/images/


## How to merge image files in Node.js via Java

[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) allows developers to combine multiple JPG documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine image documents of any JPG, PNG or BMP extensions.

The following example demonstrates how to merge image files with several lines of Node.js via Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.jpg');
const imageJoinModeVertical = groupdocs.merger.ImageJoinMode.Vertical;
const imageJoinOptions = new groupdocs.merger.ImageJoinOptions(imageJoinModeVertical);
merger.join('c:/sample2.jpg', imageJoinOptions);
merger.save('c:/merged.jpg');
```

### Merge different image file formats

This section describes how to merge different image file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge JPG images in Node.js via Java]({{< ref "merger/nodejs-java/getting-started/use-cases/how-to-merge-jpg-images-using-nodejs-java.md" >}})
* [How to merge PNG images in Node.js via Java]({{< ref "merger/nodejs-java/getting-started/use-cases/how-to-merge-png-images-using-nodejs-java.md" >}})
* [How to merge BMP images in Node.js via Java]({{< ref "merger/nodejs-java/getting-started/use-cases/how-to-merge-bmp-images-using-nodejs-java.md" >}})

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Images Live Demo

GroupDocs.Merger offers the following free online tools to test its quality and accuracy:
* [**JPG Merger App**](https://products.groupdocs.app/merger/jpg)
* [**PNG Merger App**](https://products.groupdocs.app/merger/png)
* [**BMP Merger App**](https://products.groupdocs.app/merger/bmp)
---

## Merge images

Path: /merger/python-net/merge/images/


## How to merge image files in Python via .NET

[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) allows developers to combine multiple JPG documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine image documents of any JPG, PNG or BMP extensions.

The following example demonstrates how to merge image files with several lines of Python via .NET code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```python
with gm.Merger("c:/sample1.jpg") as merger:
    image_join_mode = gm.domain.options.ImageJoinMode.HORIZONTAL
    image_join_options = gm.domain.options.ImageJoinOptions(image_join_mode)
    merger.join("c:/sample2.jpg", join_options = image_join_options)
    merger.save("c:/merged.jpg")
```

### Merge different image file formats

This section describes how to merge different image file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge JPG images in Python via .NET]({{< ref "merger/python-net/getting-started/use-cases/how-to-merge-jpg-images-using-python-net.md" >}})
* [How to merge PNG images in Python via .NET]({{< ref "merger/python-net/getting-started/use-cases/how-to-merge-png-images-using-python-net.md" >}})
* [How to merge BMP images in Python via .NET]({{< ref "merger/python-net/getting-started/use-cases/how-to-merge-bmp-images-using-python-net.md" >}})

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Images Live Demo

GroupDocs.Merger offers the following free online tools to test its quality and accuracy:
* [**JPG Merger App**](https://products.groupdocs.app/merger/jpg)
* [**PNG Merger App**](https://products.groupdocs.app/merger/png)
* [**BMP Merger App**](https://products.groupdocs.app/merger/bmp)
---

## Merge PDF

Path: /merger/java/merge-pdf/


## How to merge PDF files in Java

**[GroupDocs.Merger](https://products.groupdocs.com/merger/java)**  allows developers to merge PDF files when it's needed to organize multiple
 PDF files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine PDF documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge PDF files with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source PDF file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PDF file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other PDF documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged PDF file as parameter.

```java
// Load the source PDF file
Merger merger = new Merger("c:\sample1.pdf")

// Add another PDF file to merge
merger.join("c:\sample2.pdf");
// Merge PDF files and save result
merger.save("c:\merged.pdf");
```

Also, please read the following article: [How to properly merge PDF streams]({{< ref "merger/java/getting-started/use-cases/how-to-properly-merge-documents-using-java.md" >}})

### About PDF File Format

Portable Document Format (PDF) is a type of document created by Adobe back in the 1990s. The purpose of this file format was to introduce a standard for representation of documents and other reference material in a format that is independent of application software, hardware as well as Operating System. PDF files can be opened in Adobe Acrobat Reader/Writer as well in most modern browsers like Chrome, Safari, Firefox via extensions/plug-ins.

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PDF Live Demo

GroupDocs.Merger for Java provides an online [**PDF Merger App**](https://products.groupdocs.app/merger/pdf), which allows you to try it for free and check its quality and accuracy.

[!["Merge PDF"](/merger/java/images/merge/merge-pdf.png)](https://products.groupdocs.app/merger/pdf)
---

## Merge PDF

Path: /merger/nodejs-java/merge-pdf/


## How to merge PDF files in Node.js via Java

**[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java)**  allows developers to merge PDF files when it's needed to organize multiple
 PDF files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine PDF documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge PDF files with several lines of Node.js via Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source PDF file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PDF file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other PDF documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged PDF file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.pdf');
merger.join('c:/sample2.pdf');
merger.save('c:/merged.pdf');
```

### About PDF File Format

Portable Document Format (PDF) is a type of document created by Adobe back in the 1990s. The purpose of this file format was to introduce a standard for representation of documents and other reference material in a format that is independent of application software, hardware as well as Operating System. PDF files can be opened in Adobe Acrobat Reader/Writer as well in most modern browsers like Chrome, Safari, Firefox via extensions/plug-ins.

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PDF Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**PDF Merger App**](https://products.groupdocs.app/merger/pdf), which allows you to try it for free and check its quality and accuracy.

[!["Merge PDF"](/merger/java/images/merge/merge-pdf.png)](https://products.groupdocs.app/merger/pdf)
---

## Merge PDF

Path: /merger/python-net/merge-pdf/


## How to merge PDF files in Python via .NET

**[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net)**  allows developers to merge PDF files when it's needed to organize multiple
 PDF files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine PDF documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge PDF files with several lines of Python via .NET code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source PDF file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PDF file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other PDF documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PDF file as parameter.

```python
with gm.Merger("c:/sample1.pdf") as merger:
    merger.join("c:/sample2.pdf")
    merger.save("c:/merged.pdf")
```

### About PDF File Format

Portable Document Format (PDF) is a type of document created by Adobe back in the 1990s. The purpose of this file format was to introduce a standard for representation of documents and other reference material in a format that is independent of application software, hardware as well as Operating System. PDF files can be opened in Adobe Acrobat Reader/Writer as well in most modern browsers like Chrome, Safari, Firefox via extensions/plug-ins.

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PDF Live Demo

GroupDocs.Merger for Python via .NET provides an online [**PDF Merger App**](https://products.groupdocs.app/merger/pdf), which allows you to try it for free and check its quality and accuracy.

[!["Merge PDF"](/merger/net/images/merge/merge-pdf.png)](https://products.groupdocs.app/merger/pdf)
---

## Migrating to GroupDocs.Assembly 18.9 or Higher

Path: /assembly/java/migrating-to-groupdocs-assembly-18-9-or-higher/

{{< alert style="info" >}}This document describes the changes to the GroupDocs.Assembly API from version 18.7 to 18.9 or greater that may be of interest to module/application developers. It includes not only new and updated public methods, added & removed classes etc., but also a description of any changes in the behaviour behind the scenes in GroupDocs.Assembly.{{< /alert >}}

### Breaking changes

Removed members of DocumentAssembler were replaced with new ones. Removed members were not marked as obsolete (deprecated) before removal as usual, because this would complicate migration to new members of DocumentAssembler in Java. Thus, we have introduced a breaking change and customers need to migrate their code from removed members of DocumentAssembler to newly added ones when upgrading to the new version of GroupDocs.Assembly.

Since version 18.9, the Metered licensing security has been improved. Metered licensing is now applicable only in Java runtime version *8u101* or above. Please use other types of licensing if you are using v18.9 or greater in Java 7.

### Newly added types

**Java**

```java
/**
  * Provides information on a single data source object to be used to assemble a document from a template.
  */
public class DataSourceInfo
```

**Java**

```java
/**
  * A utility class providing constants. Specifies the format of a file.
  */
public final class FileFormat
```

**Java**

```java
/**
  * Specifies additional options for loading and saving of a document to be assembled.
  */
public class LoadSaveOptions
```

### New members of DocumentAssembler

**Java**

```java
/**
  * Loads a template document from the specified source path, populates the template document with data from the specified single or multiple sources, and stores the result document to the target path using default {@link com.groupdocs.assembly.LoadSaveOptions}.
  * 
  * @param sourcePath The path to a template document to be populated with data.
  * @param targetPath The path to a result document.
  * @param dataSourceInfos Provides information on data source objects to be used.
  */
public void assembleDocument(String sourcePath, String targetPath, DataSourceInfo... dataSourceInfos) throws Exception
```

**Java**

```java
/**
  * Loads a template document from the specified source path, populates the template document with data from the specified single or multiple sources, and stores the result document to the target path using the given {@link com.groupdocs.assembly.LoadSaveOptions}.
  * 
  * @param sourcePath The path to a template document to be populated with data.
  * @param targetPath The path to a result document.
  * @param loadSaveOptions Specifies additional options for document loading and saving.
  * @param dataSourceInfos Provides information on data source objects to be used.
  */
public void assembleDocument(String sourcePath, String targetPath, LoadSaveOptions loadSaveOptions, DataSourceInfo... dataSourceInfos) throws Exception
```

**Java**

```java
/**
  * Loads a template document from the specified source stream, populates the template document with data from the specified single or multiple sources, and stores the result document to the target stream using default {@link com.groupdocs.assembly.LoadSaveOptions}.
  * 
  * @param sourceStream The stream to read a template document from.
  * @param targetStream The stream to write a result document.
  * @param dataSourceInfos Provides information on data source objects to be used.
  */
public void assembleDocument(InputStream sourceStream, OutputStream targetStream, DataSourceInfo... dataSourceInfos) throws Exception
```

**Java**

```java
/**
  * Loads a template document from the specified source stream, populates the template document with data from the specified single or multiple sources, and stores the result document to the target stream using the given {@link com.groupdocs.assembly.LoadSaveOptions}.
  * 
  * @param sourceStream The stream to read a template document from.
  * @param targetStream The stream to write a result document.
  * @param loadSaveOptions Specifies additional options for document loading and saving.
  * @param dataSourceInfos Provides information on data source objects to be used.
  */
public void assembleDocument(InputStream sourceStream, OutputStream targetStream, LoadSaveOptions loadSaveOptions, DataSourceInfo... dataSourceInfos) throws Exception
```

### Removed members of DocumentAssembler

**Java**

```java
public void assembleDocument(String sourcePath, String targetPath, Object dataSource)
public void assembleDocument(String sourcePath, String targetPath, Object dataSource, String dataSourceName)
public void assembleDocument(String sourcePath, String targetPath, Object[] dataSources, String[] dataSourceNames)
public void assembleDocument(InputStream sourceStream, OutputStream targetStream, Object dataSource)
public void assembleDocument(InputStream sourceStream, OutputStream targetStream, Object dataSource, String dataSourceName)
public void assembleDocument(InputStream sourceStream, OutputStream targetStream, Object[] dataSources, String[] dataSourceNames)
```

### Breaking changes

Removed members of DocumentAssembler were replaced with new ones. Removed members were not marked as obsolete (deprecated) before removal as usual, because this would complicate migration to new members of DocumentAssembler in Java. Thus, we have introduced a breaking change and customers need to migrate their code from removed members of DocumentAssembler to newly added ones when upgrading to the new version of GroupDocs.Assembly.

### Migrating code from removed members of DocumentAssembler to newly added ones

The following table shows how to migrate code from removed members of DocumentAssembler to newly added ones.

| Old Code                                                     | New Code                                                     |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| `assembler.assembleDocument(sourcePath, targetPath, dataSource);` | `assembler.assembleDocument(sourcePath, targetPath, new DataSourceInfo(dataSource));` |
| `assembler.assembleDocument(sourcePath, targetPath, dataSource, dataSourceName);` | `assembler.assembleDocument(sourcePath, targetPath, new DataSourceInfo(dataSource, dataSourceName));` |
| `Object[] dataSources = new Object[] { dataSource1, dataSource2 };<br/>String[] dataSourceNames = new String[] { dataSourceName1, dataSourceName2 };<br/> <br/>assembler.assembleDocument(sourcePath, targetPath, dataSources, dataSourceNames);<br/>` | `assembler.assembleDocument(sourcePath, targetPath, new DataSourceInfo(dataSource1, dataSourceName1), new DataSourceInfo(dataSource2, dataSourceName2));` |
| `assembler.assembleDocument(sourceStream, targetStream, dataSource);` | `assembler.assembleDocument(sourceStream, targetStream, new DataSourceInfo(dataSource));` |
| `assembler.assembleDocument(sourceStream, targetStream, dataSource, dataSourceName);` | `assembler.assembleDocument(sourceStream, targetStream, new DataSourceInfo(dataSource, dataSourceName));` |
| `Object[] dataSources = new Object[] { dataSource1, dataSource2 };<br/>String[] dataSourceNames = new String[] { dataSourceName1, dataSourceName2 };<br/> <br/>assembler.assembleDocument(sourceStream, targetStream, dataSources, dataSourceNames);` | `assembler.assembleDocument(sourceStream, targetStream, new DataSourceInfo(dataSource1, dataSourceName1), new DataSourceInfo(dataSource2, dataSourceName2));` |


---

## Migrating to GroupDocs.Assembly 3.0.0 or Higher

Path: /assembly/net/migrating-to-groupdocs-assembly-3-0-0-or-higher/

## Reasons to Migrate

Just to endeavor the report generation task more smoothly, we released **GroupDocs.Assembly for .NET 3.0.0**.

### Namespace(s)

In **GroupDocs.Assembly for .NET 3.0.0** only a single **using GroupDocs.Assembly;** namespace is required to generate reports in any of the supported formats. Whereas, in **GroupDocs.Assembly for .NET 1.3.0** to generate a report in any of the supported format a separate namespace of that format is required to be added, given are the namespaces:

1.  using Groupdocs.Assembly;
2.  using Groupdocs.Assembly.Cells;
3.  using Groupdocs.Assembly.Data;
4.  using Groupdocs.Assembly.Exceptions;
5.  using Groupdocs.Assembly.Pdf;
6.  using Groupdocs.Assembly.Slides;
7.  using Groupdocs.Assembly.Words;

### Support of Multiple Data Sources

**GroupDocs.Assembly for .NET 3.0.0** supports following data sources:

*   Database
*   XML
*   JSON
*   OData
*   Custom .NET Objects

### Easy Template Syntax

**Next Generation GroupDocs.Assembly for .NET** engine supports the underlying C# syntax for LINQ queries which is actually shorter than LINQ. This basically means that the developers can use the familiar and well documented C# syntax to write data binding/traversal queries right in the document templates. As a result, developers can enjoy many benefits including short and concise reporting syntax and binding to any type of supported data source including business objects.

### Template Editing

In **GroupDocs.Assembly for .NET 1.3.0** user need to edit the template through code. However, template editing in **GroupDocs.Assembly for .NET 3.0.0** is quite straightforward. Font size, text alignment and other similar context is dealt on the template end.

### Comfy Code

Code to generate reports has been shrunk to fewer lines in **GroupDocs.Assembly for .NET 3.0.0**. A user does not need to write the bulk of lines of code to generate big reports. Instead, he/she will have to write 2 to 3 lines of code to generate business documents and reports.

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}

{{< gist GroupDocsGists 73103f412435effbc30b8f2c5b2366ba >}}
---

## Move page

Path: /merger/java/move-page/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) provides a move page feature which allows you to manipulate page ordering by moving any page(s) to new position within a document.   
This can be done by following the steps below:

*   Initialise [MoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/MoveOptions) class and specify current and new page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [movePage](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#movePage(com.groupdocs.merger.domain.options.interfaces.IMoveOptions)) method and pass [MoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/MoveOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates on how to move page to a new position:

```java
String filePath = "c:\sample.xlsx";
String filePathOut = "c:\output\result.xlsx";
 
int pageNumber = 6;
int newPageNumber = 1;
MoveOptions moveOptions = new MoveOptions(pageNumber, newPageNumber);

Merger merger = new Merger(filePath);

merger.movePage(moveOptions);
merger.save(filePathOut);
```

---

## Move page

Path: /merger/net/move-page/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides a move page feature which allows you to manipulate page ordering by moving any page(s) to new position within a document.   
This can be done by following the steps below:

*   Initialise [MoveOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/moveoptions) class and specify current and new page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [MovePage](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/movepage) method and pass [MoveOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/moveoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and pass desired file path to save resultant document.

The following code sample demonstrates on how to move page to a new position:

```csharp
int pageNumber = 6;
int newPageNumber = 1;
MoveOptions moveOptions = new MoveOptions(pageNumber, newPageNumber);

using (Merger merger = new Merger(@"c:\sample.xlsx"))
{
    merger.MovePage(moveOptions);
    merger.Save(@"c:\result.xlsx");
}
```

---

## Move page

Path: /merger/nodejs-java/move-page/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) provides a move page feature which allows you to manipulate page ordering by moving any page(s) to new position within a document.   
This can be done by following the steps below:

*   Initialise [MoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/MoveOptions) class and specify current and new page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [movePage](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#movePage(com.groupdocs.merger.domain.options.interfaces.IMoveOptions)) method and pass [MoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/MoveOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates on how to move page to a new position:

```js
const inputFilePath = `c:/sample.xlsx`; 
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output/result.xlsx`;
const moveOptions = new groupdocs.merger.MoveOptions(2, 1);
merger.movePage(moveOptions);
merger.save(outputPath);
```

---

## Move page

Path: /merger/python-net/move-page/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) provides a move page feature which allows you to manipulate page ordering by moving any page(s) to new position within a document.   
This can be done by following the steps below:

*   Initialise [MoveOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/MoveOptions) class and specify current and new page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/net/merger/groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [movePage](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/movepage/) method and pass [MoveOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/MoveOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and pass desired file path to save resultant document.

The following code sample demonstrates on how to move page to a new position:

```python
with gm.Merger("c:/sample.xlsx") as merger:
    move_options = gm.domain.options.MoveOptions(2, 1)
    merger.move_page(move_options)
    merger.save("c:/result.xlsx")
```

---

## Multicolored Numbered List in Word Processing Document

Path: /assembly/java/multicolored-numbered-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Word Processing Document format.{{< /alert >}}

## Multicolored Numbered List in Microsoft Word Document

### Creating a Multicolored Numbered List

Practicing the following steps you can create Multicolored Numbered List Template in MS Word 2013.

1.  In your document, write a sentence like "We provide support for the following clients:".
2.  Start numbered list.
3.  Go to the "Design" tab and select color to make it colored list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the clients in numbered list.
*   It must highlight the products.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

We provide support for the following clients:

<ol>
	<li>&lt;&lt;foreach [in getClients()]>>&lt;&lt;if [indexOf() % 2 == 0]>>&lt;&lt;[getName()]>></li>
	<li style="background-color: #ceffbc">&lt;&lt;else>>&lt;&lt;[getName()]>></li>
</ol>

​		&lt;&lt;/if>>&lt;&lt;/foreach>>

### Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Multicolored%20Numbered%20List.docx?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 4987c248fc7dc91dbbe9c56980c059fa >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Multicolored Numbered List in Word Processing Document

Path: /assembly/net/multicolored-numbered-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Multicolored Numbered List in Microsoft Word Document

### Creating a Multicolored Numbered List

Practising the following steps you can create Multicolored Numbered List Template in MS Word 2013.

1.  In your document, write a sentence like "We provide support for the following products:".
2.  Start numbered list.
3.  Go to the "Design" tab and select color to make it colored list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in the numbered list.
*   It must highlight the products.
*   The report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> Price</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">orders</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;if [</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Price</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> &gt;= </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">400</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Multicolored%20Numbered%20List.docx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Multicolored Numbered List\_XML.docx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Multicolored%20Numbered%20List_XML.docx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists fa4d00eab89dede91869524e42ec3e82 >}}

#### Database Entities

{{< gist GroupDocsGists a0582f9343a9ce4eb4de20e8e854bbaf >}}

#### Using DataSet

{{< gist GroupDocsGists 10d852a60e3747d957141763e7f12f44 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 1f7ef36623b51c6816e6f678b4f1f1f0 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 229f359d8b6a4e05cc58328b514e4178 >}}

## Multicolored Numbered List in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Multicolored Numbered List' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Multicolored Numbered List\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Multicolored%20Numbered%20List_OpenDocument.odt?raw=true) (use same template for database, dataset and JSON examples)
*   [Multicolored Numbered List\_XML\_OpenDocument.odt](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Multicolored%20Numbered%20List_XML_OpenDocument.odt?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 53a1a19e7f6f83e72773f85b9b9e0482 >}}

#### Database Entities

{{< gist GroupDocsGists 06e400b065b2894b62b96934dc0cacc4 >}}

#### Using DataSet

{{< gist GroupDocsGists c726d5c9ef612bb19b637a2c26a29819 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 714da880022eb0442cd10dc9ca7a3899 >}}

####  Using JSON DataSource

{{< gist GroupDocsGists 6bc0892dd0c6889ffff94618dcd04c06 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Numbered List in Word Processing Document

Path: /assembly/java/numbered-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Numbered List in Microsoft Word Document

### Creating a Numbered List

Practising the following steps you can create Numbered List Template in MS Word 2013.

1.  In your document, write a sentence like "We provide support for the following clients:".
2.  Start numbered list.
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the client names in a numbered list.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
1.	<<foreach [in getClients()]>><<[getName()]>>
<</foreach>>
```

### Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Numbered%20List.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 31fe6f6c5e1080d024c0ec2480830933 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

## Restart Numbering in Nested Numbered List 

{{< alert style="info" >}}This feature is supported by version 19.7 or greater.{{< /alert >}}


The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using *<<restartNum>>* tags. In particular, this feature is useful when working with a nested numbered list within a data band.

Assume that we are picking *Order* and *Service* classes as defined in the following *Custom Objects* of our business use case.

{{< gist GroupDocsGists ffcdf1d202f0e706b98796c722e438e3 >}}

Given that orders is an enumeration of Order instances, you could try to use the following template to output information on several orders in one document.

```java
<<foreach [in getContracts()]>><<[getClient().getName()]>> (Manager: <<[getManager().getName()]>>)
1.  <<foreach [service in getServices()]>><<[service.getName()]>>
<</foreach>><</foreach>>
```

The generated report will look as follows:

```
A Company (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
B Ltd. (Manager: John Smith)
	3.	Regular Cleaning
	4.	Oven Cleaning
C & D (Manager: John Smith)
	5.	Regular Cleaning
	6.	Oven Cleaning
E Corp. (Manager: Tony Anderson)
	7.	Regular Cleaning
	8.	Oven Cleaning
	9.	Carpet Cleaning
F & Partners (Manager: Tony Anderson)
	10.	Regular Cleaning
	11.	Oven Cleaning
	12.	Carpet Cleaning
```

However, there would be a single numbered list across all orders, which is not applicable for this scenario. Hence, you can make the list numbering to restart for every order by putting a *<<restartNum>>* tag into your template before a corresponding *<<foreach>>* tag as follows:

```java
<<foreach [in getContracts()]>><<[getClient().getName()]>> (Manager: <<[getManager().getName()]>>)
1.  <<restartNum>><<foreach [service in getServices()]>><<[service.getName()]>>
<</foreach>><</foreach>>
```
```
 Then, the generated report will look as follows:

A Company (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
B Ltd. (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
C & D (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
E Corp. (Manager: Tony Anderson)
	1.	Regular Cleaning
	2.	Oven Cleaning
	3.	Carpet Cleaning
F & Partners (Manager: Tony Anderson)
	1.	Regular Cleaning
	2.	Oven Cleaning
	3.	Carpet Cleaning
```

Download Numbered List Template

Please download the sample Numbered List template we created in this article:

*    [Numbered List\_RestartNum.docx](attachments/29360197/85426183.docx) (Template for DataBase, DataSet and JSON Data examples)

---

## Numbered List in Word Processing Document

Path: /assembly/net/numbered-list-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Numbered List in Microsoft Word Document

### Creating a Numbered List

Practising the following steps you can create Numbered List Template in MS Word 2013.

1.  In your document, write a sentence like "We provide support for the following products:".
2.  Start numbered list.
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in the numbered list.
*   The report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
1.	<<foreach [in products]>><<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Numbered%20List.docx?raw=true) (Template for DataBase, DataSet and JSON Data examples)
*   [Numbered List\_XML.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Numbered%20List_XML.docx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 09a797b200c1540363f826971a0d77d3 >}}

#### Database Entities

{{< gist GroupDocsGists 96b6ec9337b6da478cca8dff8ddb6108 >}}

#### Using DataSet

{{< gist GroupDocsGists d3018f38635db03060cbf8f61f1050a9 >}}

#### Using XML DataSource

{{< gist GroupDocsGists ab228e8733227e4f70082bf65400b6d8 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists fd6cf2b09033f95ef8adc3c19004433f >}}

## Numbered List in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Numbered List' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Numbered List\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Numbered%20List_OpenDocument.odt?raw=true) (use same template for database, dataset and JSON examples)
*   [Numbered List\_XML\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Numbered%20List_XML_OpenDocument.odt?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists cae108ae98bff77def2058d3712429c6 >}}

#### Database Entities

{{< gist GroupDocsGists 0ac8f49a57de8ea4d9d87e499a594808 >}}

#### Using DataSet

{{< gist GroupDocsGists 1e40425f2ab1ecf4d97bbdc48bd14940 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 13b78920844bf08e8609722c98edd401 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists c8ddee4c4a1fc5aad412eef350b830ef >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

## Numbering Restart in Nested Numbered List 

{{< alert style="info" >}}This feature is supported by version 19.7 or greater.{{< /alert >}}


The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using *<<restartNum>>* tags. In particular, this feature is useful when working with a nested numbered list within a data band.  

Assume that we are picking *Order* and *Service* classes as defined in the following *Custom Objects* of our business use case.

{{< gist GroupDocsGists cd8768711ff88414192c3f50a9b7c918 >}}

Given that orders is an enumeration of Order instances, you could try to use the following template to output information on several orders in one document.

```csharp
<<foreach [in orders]>><<[Customer.CustomerName]>> (<<[Customer.CustomerContactNumber]>>)
1.	<<foreach [in Services]>><<[ServiceName]>>
<</foreach>><</foreach>>
```

The generated report will look as follows:

```
Jane Doe (+9211874)
	1.	Regular Cleaning
	2.	Oven Cleaning
John Smith (+458789)
	3.	Regular Cleaning
	4.	Oven Cleaning
	5.	Carpet Cleaning
John Smith (+458789)
	6.	Regular Cleaning
	7.	Carpet Cleaning
John Smith (+458789)
	8.	Oven Cleaning
```

However, there would be a single numbered list across all orders, which is not applicable for this scenario. Hence, you can make the list numbering to restart for every order by putting a *<<restartNum>>* tag into your template before a corresponding *<<foreach>>* tag as follows:

```csharp
<<foreach [in orders]>><<[ Customer.CustomerName]>> (<<[Customer.CustomerContactNumber]>>)
1.	<<restartNum>><<foreach [in Services]>><<[ServiceName]>>
<</foreach>><</foreach>>
```

 Then, the generated report will look as follows:

```
Jane Doe (+9211874)
	1.	Regular Cleaning
	2.	Oven Cleaning
John Smith (+458789)
	1.	Regular Cleaning
	2.	Oven Cleaning
	3.	Carpet Cleaning
John Smith (+458789)
	1.	Regular Cleaning
	2.	Carpet Cleaning
John Smith (+458789)
	1.	Oven Cleaning
```

## Download Numbered List Template

Please download the sample Numbered List template we created in this article:

*   [Numbered List\_RestartNum.docx](attachments/34439255/85426181.docx) (Template for DataBase, DataSet and JSON Data examples)

---

## Obtain document form fields and signatures information

Path: /signature/java/obtain-document-form-fields-and-signatures-information/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) allows to get extended document information which includes:

* list of all existing [Form Field Signatures](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures.formfield/FormFieldSignature ) in the document. This list will contain all Form Fields elements in the document no matter if these components were added by GroupDocs Signature or any other third party software. Please be aware only Pdf and Word processing documents support these elements.
* list of [Text Signatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature ) previously added to document over [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.lang.String,%20com.groupdocs.signature.options.sign.SignOptions) ) method or updated by [Update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature) ) method;
* list of [Image Signatures](https://reference.groupdocs.com/java/signature/groupdocs.signature.domain.signatures/ImageSignature ) previously added to document over [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.lang.String,%20com.groupdocs.signature.options.sign.SignOptions) ) method or updated by [Update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature) ) method;
* list of [DigitalSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/DigitalSignature ) previously added to document over [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.lang.String,%20com.groupdocs.signature.options.sign.SignOptions) ) method or updated by [Update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature) ) method;
* list of [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature ) previously added to document over [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.lang.String,%20com.groupdocs.signature.options.sign.SignOptions) ) method or updated by [Update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature) ) method;
* list of [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature ) previously added to document over [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.lang.String,%20com.groupdocs.signature.options.sign.SignOptions) ) method or updated by [Update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature) ) method;
* list of [FormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/FormFieldSignature ) previously added to document over [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.lang.String,%20com.groupdocs.signature.options.sign.SignOptions) ) method or updated by [Update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature) ) method;

## Analyze document form fields and signatures information

The following code snippet demonstrates how to obtain information about document form fields, signatures and analyze them.

```java

	final Signature signature = new Signature("sampleSigned.pdf");
       
	IDocumentInfo documentInfo = signature.getDocumentInfo();
	System.out.print("Document properties "+ filePath);
	System.out.print(" - format : "+documentInfo.getFileType().getFileFormat());
	System.out.print(" - extension : "+documentInfo.getFileType().getExtension());
	System.out.print(" - size : "+documentInfo.getSize());
	System.out.print(" - page count : "+documentInfo.getPageCount());
	for (PageInfo pageInfo : documentInfo.getPages())
	{
		System.out.print(" - page-"+pageInfo.getPageNumber()+" Width "+pageInfo.getWidth()+", Height "+pageInfo.getHeight());
	}
	// display document Form Field signatures information
	System.out.print("Document Form Fields information: count = "+documentInfo.getFormFields().size());
	for (FormFieldSignature formField : documentInfo.getFormFields())
	{
		System.out.print(" - type #"+formField.getType()+": Name: "+formField.getName()+" Value: "+formField.getValue());
	}
	// display document Text signatures information
	System.out.print("Document Text signatures : "+documentInfo.getTextSignatures().size());
	for (TextSignature textSignature : documentInfo.getTextSignatures())
	{
		System.out.print(" - #"+textSignature.getSignatureId()+": Text: "+textSignature.getText()+" Location: "+textSignature.getLeft()+"x"+textSignature.getTop()+". Size: "+textSignature.getWidth()+"x"+textSignature.getHeight());
	}
	// display document Image signatures information
	System.out.print("Document Image signatures : "+documentInfo.getImageSignatures().size());
	for (ImageSignature imageSignature : documentInfo.getImageSignatures())
	{
		System.out.print(" - #"+imageSignature.getSignatureId()+": Size: "+imageSignature.getSize()+" bytes, Format: "+imageSignature.getFormat());
	}
	// display document Digital signatures information
	System.out.print("Document Digital signatures : "+documentInfo.getDigitalSignatures().size());
	for (DigitalSignature digitalSignature : documentInfo.getDigitalSignatures())
	{
		System.out.print(" - #"+digitalSignature.getSignatureId());
	}
	// display document Barcode signatures information
	System.out.print("Document Barcode signatures : "+documentInfo.getBarcodeSignatures().size());
	for (BarcodeSignature barcodeSignature : documentInfo.getBarcodeSignatures())
	{
		System.out.print(" - #"+barcodeSignature.getSignatureId()+": Type: "+barcodeSignature.getEncodeType().getTypeName()+". Text: "+barcodeSignature.getText());
	}
	// display document QrCode signatures information
	System.out.print("Document QR-Code signatures : "+documentInfo.getQrCodeSignatures().size());
	for (QrCodeSignature qrCodeSignature : documentInfo.getQrCodeSignatures())
	{
		System.out.print(" - #"+qrCodeSignature.getSignatureId()+": Type: "+qrCodeSignature.getEncodeType().getTypeName()+". Text: "+qrCodeSignature.getText());
	}
	// display document Form Fields signatures information
	System.out.print("Document Form Fields signatures : "+documentInfo.getFormFieldSignatures().size());
	for (FormFieldSignature formFieldSignature : documentInfo.getFormFields())
	{
		System.out.print(" - #"+formFieldSignature.getSignatureId()+" Type "+formFieldSignature.getType()+": Name: "+formFieldSignature.getName()+" Value: "+formFieldSignature.getValue());
	}
       

```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .java library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Obtain document form fields and signatures information

Path: /signature/net/obtain-document-form-fields-and-signatures-information/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) allows to get extended document information which includes:

* list of all existing [Form Field Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/formfieldsignature/) in the document. This list will contain all Form Fields elements in the document no matter if these components were added by GroupDocs Signature or any other third party software. Please be aware only Pdf and Word processing documents support these elements.
* list of [Text Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) previously added to document over [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method or updated by [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update) method;
* list of [Image Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) previously added to document over [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method or updated by [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update) method;
* list of [DigitalSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalsignature) previously added to document over [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method or updated by [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update) method;
* list of [BarcodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/barcodesignature) previously added to document over [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method or updated by [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update) method;
* list of [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) previously added to document over [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method or updated by [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update) method;
* list of [FormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/formfieldsignature/) previously added to document over [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method or updated by [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update) method;
* list of [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/) previously added to document over [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method or updated by [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update) method;

## Analyze document form fields and signatures information

The following code snippet demonstrates how to obtain information about document form fields, signatures and analyze them.

```csharp
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    IDocumentInfo documentInfo = signature.GetDocumentInfo();
    Console.WriteLine($"Document properties {Path.GetFileName(filePath)}:");
    Console.WriteLine($" - format : {documentInfo.FileType.FileFormat}");
    Console.WriteLine($" - extension : {documentInfo.FileType.Extension}");
    Console.WriteLine($" - size : {documentInfo.Size}");
    Console.WriteLine($" - page count : {documentInfo.PageCount}");
    foreach (PageInfo pageInfo in documentInfo.Pages)
    {
        Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
    }
    // display document Form Field signatures information
    Console.WriteLine($"Document Form Fields information: count = {documentInfo.FormFields.Count}");
    foreach (FormFieldSignature formField in documentInfo.FormFields)
    {
        Console.WriteLine($" - type #{formField.Type}: Name: {formField.Name} Value: {formField.Value}");
    }
    // display document Text signatures information
    Console.WriteLine($"Document Text signatures : {documentInfo.TextSignatures.Count}");
    foreach (TextSignature textSignature in documentInfo.TextSignatures)
    {
        Console.WriteLine($" - #{textSignature.SignatureId}: Text: {textSignature.Text}");
    }
    // display document Image signatures information
    Console.WriteLine($"Document Image signatures : {documentInfo.ImageSignatures.Count}");
    foreach (ImageSignature imageSignature in documentInfo.ImageSignatures)
    {
        Console.WriteLine($" - #{imageSignature.SignatureId}: Size: {imageSignature.Size} bytes, Format: {imageSignature.Format}.");
    }
    // display document Digital signatures information
    Console.WriteLine($"Document Digital signatures : {documentInfo.DigitalSignatures.Count}");
    foreach (DigitalSignature digitalSignature in documentInfo.DigitalSignatures)
    {
        Console.WriteLine($" - #{digitalSignature.SignatureId}.");
    }
    // display document Barcode signatures information
    Console.WriteLine($"Document Barcode signatures : {documentInfo.BarcodeSignatures.Count}");
    foreach (BarcodeSignature barcodeSignature in documentInfo.BarcodeSignatures)
    {
        Console.WriteLine($" - #{barcodeSignature.SignatureId}: Type: {barcodeSignature.EncodeType?.TypeName}. Text: {barcodeSignature.Text}");
    }
    // display document QrCode signatures information
    Console.WriteLine($"Document QR-Code signatures : {documentInfo.QrCodeSignatures.Count}");
    foreach (QrCodeSignature qrCodeSignature in documentInfo.QrCodeSignatures)
    {
        Console.WriteLine($" - #{qrCodeSignature.SignatureId}: Type: {qrCodeSignature.EncodeType?.TypeName}. Text: {qrCodeSignature.Text}");
    }
    // display document Form Fields signatures information
    Console.WriteLine($"Document Form Fields signatures : {documentInfo.FormFieldSignatures.Count}");
    foreach (FormFieldSignature formFieldSignature in documentInfo.FormFields)
    {
        Console.WriteLine($" - #{formFieldSignature.SignatureId} Type {formFieldSignature.Type}: Name: {formFieldSignature.Name} Value: {formFieldSignature.Value}");
    }
    // display document Metadata signatures information
    Console.WriteLine($"Document Metadata signatures : {documentInfo.MetadataSignatures.Count}");
    foreach (MetadataSignature metadataSignature in documentInfo.MetadataSignatures)
    {
        Console.WriteLine($" - #{metadataSignature.Name} = {metadataSignature.Value}.Type:{metadataSignature.Type}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## OCR Usage Basics

Path: /parser/java/ocr-usage-basics/

GroupDocs.Parser doesn't contain OCR functionality as a part of its distributable. Instead of it API for integrating any paid or free OCR solution is provided. See [this article]({{< ref "use-ocr-connector" >}}) for details how to integrate OCR soluton to GroupDocs.Parser. 

To use OCR functionality, Parser object must be properly initialized:

* Instantiate [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/parsersettings) object with the instance of class that implements OCR functionality;
* Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/) object with [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/parsersettings) object.

The following example shows how to create an instance of [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/) class with Aspose.OCR on-premise API connector:

```Java
// Create an instance of ParserSettings class with OCR Connector
ParserSettings settings = new ParserSettings(new AsposeOcrOnPremise());
// Create an instance of Parser class with settings
Parser parser = new Parser(Constants.SampleScan, settings);
```

[getText](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/#getText-com.groupdocs.parser.options.TextOptions-) and [getTextAreas](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/#getTextAreas-com.groupdocs.parser.options.PageTextAreaOptions-) methods from [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/) class are used to recognize a text from images.

To extract a text from image files or non-text PDF documents GetText method is used:

* Instantiate [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/parsersettings) object with the instance of class that implements OCR functionality;
* Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/) object with [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/parsersettings) object;
* Instantiate [TextOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/textoptions/) object with useOcr = true;
* Call [getText](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/#getText-com.groupdocs.parser.options.TextOptions-)(TextOptions) method with TextOptions parameter and obtain TextReader object;
* Check if the reader isn’t null (text extraction is supported for the document);
* Read a text from the reader.

The following example shows how to extract a text from the image file:

```Java
// Create an instance of ParserSettings class with OCR Connector
ParserSettings settings = new ParserSettings(new AsposeOcrOnPremise());
// Create an instance of Parser class with settings
try (Parser parser = new Parser(Constants.SampleScan, settings)) {
    // Create an instance of TextOptions to use OCR
    TextOptions options = new TextOptions(false, true);
    // Extract a text using OCR
    try (TextReader reader = parser.getText(options)) {
        // Print a text or 'not supported' message
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
}
```

To extract text areas from image files or non-text PDF documents GetTextAreas method is used:

* Instantiate [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/parsersettings) object with the instance of class that implements OCR functionality;
* Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/) object with [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/parsersettings) object;
* Instantiate [PageTextAreaOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/pagetextareaoptions) object with useOcr = true;
* Call [getTextAreas](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/#getTextAreas-com.groupdocs.parser.options.PageTextAreaOptions-)(PageTextAreaOptions) method and obtain the collection of [PageTextArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/pagetextarea) objects;
* Check if the collection isn’t null (text areas extraction is supported for the document);
* Iterate through the collection and get rectangles and texts.

The following example shows how to extract text areas from the image file:

```Java
// Create an instance of ParserSettings class with OCR Connector
ParserSettings settings = new ParserSettings(new AsposeOcrOnPremise());
// Create an instance of Parser class with settings
try (Parser parser = new Parser(Constants.SampleScan, settings)) {
    // Create an instance of PageTextAreaOptions to use OCR
    PageTextAreaOptions options = new PageTextAreaOptions(true);
    // Extract text areas
    java.lang.Iterable<PageTextArea> areas = parser.getTextAreas(options);
    // Check if text areas extraction is supported
    if (areas == null) {
        System.out.println("Text areas extraction isn't supported");
        return;
    }
    // Iterate over text areas
    for (PageTextArea a : areas) {
        // Print a text, position and size for an each text area
        System.out.println(a.getText());
        System.out.println(String.format("\tPosition: (%d; %d)",
                a.getRectangle().getLeft(),
                a.getRectangle().getTop()));
        System.out.println(String.format("\tSize: (%d; %d)",
                a.getRectangle().getSize().getWidth(),
                a.getRectangle().getSize().getHeight()));
    }
}
```

[TextOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/textoptions/) and [PageTextAreaOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/pagetextareaoptions) classes have the property OcrOptions. OcrOptions class has the following members:

| Member | Description |
| --- | --- |
| Rectangle | Is used to pass a rectangular area to restrict the area of the text recognition. |
| Handler | An instance of [OcrEventHandler](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocreventhandler) class to handle any warnings which occur while the text recognition. |

The following sections describe how to use this property.

## How to restrict the area of the text recognition

To restrict an area of the image for the text recognition [OcrOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocroptions) class is used. Set [Rectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocroptions/#getRectangle--) property to restrict the rectangular area for the text recognition.

The following example shows how to restrict the text recognition by the rectangular area:

```Java
// Create an instance of ParserSettings class with OCR Connector
ParserSettings settings = new ParserSettings(new AsposeOcrOnPremise());
// Create an instance of Parser class with settings
try (Parser parser = new Parser(Constants.SampleScan, settings)) {
    // Create an instance of OcrOptions to set a rectangle
    OcrOptions ocrOptions = new OcrOptions(new Rectangle(0, 0, 400, 200));
    // Create an instance of TextOptions to use OCR
    TextOptions options = new TextOptions(false, true, ocrOptions);
    // Extract a text using OCR
    try (TextReader reader = parser.getText(options)) {
        // Print a text or 'not supported' message
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
}
```

## How to handle warnings

To restrict an area of the image for the text recognition [OcrOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocroptions) class is used. Set [Handler](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocroptions/#getHandler--) property to handle warning messages. [hasWarnings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocreventhandler/#hasWarnings--) property of [OcrEventHandler](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocreventhandler) class is used to indicate if any warnings occur. Use [Warnings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocreventhandler/#getWarnings--) to get all warnings or [getWarnings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocreventhandler/#getWarnings-int-) method for warnings for the page. The empty list returns if no warning occurs during the text recognition.

The following example shows how to handle warning messages:

```Java
// Create an instance of ParserSettings class with OCR Connector
ParserSettings settings = new ParserSettings(new AsposeOcrOnPremise());
// Create an instance of Parser class with settings
try (Parser parser = new Parser(Constants.SampleScan, settings)) {
    // Create an instance of OcrEventHandler to handle warnings
    OcrEventHandler handler = new OcrEventHandler();
    // Create an instance of OcrOptions to set a handler
    OcrOptions ocrOptions = new OcrOptions(null, handler);
    // Create an instance of TextOptions to use OCR
    TextOptions options = new TextOptions(false, true, ocrOptions);
    // Extract a text using OCR
    try (TextReader reader = parser.getText(options)) {
        // Print a text or 'not supported' message
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
    if (handler.hasWarnings()) {
        System.out.println("The following warnings occur while text recognition:");
        for (String w : handler.getWarnings()) {
            System.out.println("\\t* " + w);
        }
    } else {
        System.out.println("Text recognition was performed without any warning.");
    }
}
```
---

## OCR Usage Basics

Path: /parser/net/ocr-usage-basics/

GroupDocs.Parser for .NET enables text recognition (OCR) in image files and PDF files composed of images.

It should be noted that not all languages ​​represented by the [Language](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/language/) class are currently supported for recognition without implicitly downloading additional resources from the internet. However, if internet access is available, all necessary resources will be downloaded implicitly when selecting any recognition language. Currently supported languages ​​without additional downloads: English, Chinese, Japanese, Korean, Arabic.

[GetText](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/gettext#gettext_1) and [GetTextAreas](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/gettextareas#gettextareas_1) methods from [Parser](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/) class are used to extract text from images.

To extract text from image files or non-text PDF documents GetText method is used:

* Instantiate [Parser](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/) object;
* Instantiate [TextOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/textoptions/) object with useOcr = true;
* Call [GetText](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/gettext#gettext_1)(TextOptions) method with TextOptions parameter and obtain TextReader object;
* Check if the reader isn’t null (text extraction is supported for the document);
* Read text from the reader.

The following example shows how to extract text from an image file:

```C#
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleScan))
{
    // Set OCR options
    TextOptions options = new TextOptions(false, true);
    options.OcrOptions = new OcrOptions();
    options.OcrOptions.Language = Language.Jpn;
    options.OcrOptions.PagePreviewOptions = new PagePreviewOptions();
    options.OcrOptions.PagePreviewOptions.Dpi = 144;
    // Extract text using OCR
    using (TextReader reader = parser.GetText(options))
    {
        // Print text or 'not supported' message
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

To extract text areas from image files or non-text PDF documents GetTextAreas method is used:

* Instantiate [Parser](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/) object;
* Instantiate [PageTextAreaOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/pagetextareaoptions) object with useOcr = true;
* Call [GetTextAreas](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/gettextareas/#gettextareas_1)(PageTextAreaOptions) method and obtain the collection of [PageTextArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagetextarea) objects;
* Check if the collection isn’t null (text areas extraction is supported for the document);
* Iterate through the collection and get rectangles and texts.

The following example shows how to extract text areas from the image file:

```C#
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleScan))
{
    // Create an instance of PageTextAreaOptions to use OCR
    PageTextAreaOptions options = new PageTextAreaOptions(true);
  
    // Extract text areas
    IEnumerable<PageTextArea> areas = parser.GetTextAreas(options);
    
    // Check if text areas extraction is supported
    if (areas == null)
    {
        Console.WriteLine("Text areas extraction isn't supported");
        return;
    }

    // Iterate over text areas
    foreach (PageTextArea a in areas)
    {
        // Print text, position and size for each text area
        Console.WriteLine(a.Text);
        Console.WriteLine("\tPosition: ({0}; {1})", a.Rectangle.Left, a.Rectangle.Top);
        Console.WriteLine("\tSize: ({0}; {1})", a.Rectangle.Size.Width, a.Rectangle.Size.Height);
    }
}
```

[TextOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/textoptions/) and [PageTextAreaOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/pagetextareaoptions) classes have the property OcrOptions. OcrOptions class has the following members:

| Member | Description |
| --- | --- |
| Rectangle | Is used to pass a rectangular area to restrict the area of the text recognition. |
| Handler | An instance of [OcrEventHandler](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocreventhandler) class to handle any warnings which occur while the text recognition. |

The following sections describe how to use this property.

## How to restrict the area of the text recognition

To restrict an area of the image for the text recognition [OcrOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions) class is used. Set [Rectangle](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions/rectangle) property to restrict the rectangular area for the text recognition.

The following example shows how to restrict the text recognition by the rectangular area:

```C#
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleScan))
{
    // Create an instance of OcrOptions to set a rectangle
    OcrOptions ocrOptions = new OcrOptions(new Data.Rectangle(0, 0, 400, 200));

    // Create an instance of TextOptions to use OCR
    TextOptions options = new TextOptions(false, true, ocrOptions);
    // Extract text using OCR
    using (TextReader reader = parser.GetText(options))
    {
        // Print text or 'not supported' message
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## How to handle warnings

To restrict an area of the image for the text recognition [OcrOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions) class is used. Set [Handler](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions/handler) property to handle warning messages. [HasWarnings](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocreventhandler/haswarnings) property of [OcrEventHandler](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocreventhandler) class is used to indicate if any warnings occur. Use [Warnings](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocreventhandler/warnings) to get all warnings or [GetWarnings](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocreventhandler/getwarnings) method for warnings for the page. the empty list returns if no warning occurs during the text recognition.

The following example shows how to handle warning messages:

```C#
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleScan))
{
    // Create an instance of OcrEventHandler to handle warnings
    OcrEventHandler handler = new OcrEventHandler();

    // Create an instance of OcrOptions to set a handler
    OcrOptions ocrOptions = new OcrOptions(handler);

    // Create an instance of TextOptions to use OCR
    TextOptions options = new TextOptions(false, true, ocrOptions);
    // Extract text using OCR
    using (TextReader reader = parser.GetText(options))
    {
        // Print text or 'not supported' message
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }

    if (handler.HasWarnings)
    {
        Console.WriteLine("The following warnings occur while the text recognition:");

        foreach (string w in handler.Warnings)
        {
            Console.WriteLine("\\t* " + w);
        }
    }
    else
    {
        Console.WriteLine("the text recognition was performed without any warning.");
    }
}
```
---

## Optimize a PDF file for a browser

Path: /viewer/java/optimization-pdf-for-web/

This optimization allows a browser to display the first pages of a PDF file when you open the document, instead of waiting for the entire file to download.

The following code snippet shows how to optimize a PDF file for browser:
{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setPdfOptimizationOptions(new PdfOptimizationOptions());
    viewOptions.getPdfOptimizationOptions().setLinearize(true);
     
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}



---

## Optimize a PDF file for a browser

Path: /viewer/net/optimization-pdf-for-web/

This optimization allows a browser to display the first pages of a PDF file when you open the document, instead of waiting for the entire file to download.

The following code snippet shows how to optimize a PDF file for browser:
{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions
    {
        Lineriaze = true
    };

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions With {
                .Lineriaze = True
                }

            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Optimize a PDF file for a browser

Path: /viewer/python-net/optimization-pdf-for-web/

This optimization allows a browser to display the first pages of a PDF file when you open the document, instead of waiting for the entire file to download.

The following code snippet shows how to optimize a PDF file for browser:
{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def optimize_pdf_for_web():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("optimize_pdf_for_web/optimized_spreadsheet.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.lineriaze = True

        viewer.view(viewOptions)

if __name__ == "__main__":
    optimize_pdf_for_web()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimization-pdf-for-web/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Pdf to Md

Path: /markdown/net/convert/export-pdf/


Use GroupDocs.Markdown to convert PDF documents to clean Markdown.

### Using static method

The simplest way to convert a PDF file:

{{< tabs "export-pdf-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Set license (optional)
if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

// Convert PDF to Markdown string
string markdown = MarkdownConverter.ToMarkdown("business-plan.pdf");

// Or save directly to a file
MarkdownConverter.ToFile("business-plan.pdf", "export-pdf-static.md");
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-pdf-static.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAIAAADHHcVbAAAAA3NCSVQICAjb4U/gAAAMWElEQVR4nO3dUWzV130H8L+nSnsgxYTa5kbEnhJgJpJ98aQseTAxUaoiW1RDSiseykoCNE9boyoIZEWLVImosoZSpeve0Ighax4iDRRpky02oWKbh2aVCralhGBANSAu4Lq5NJ60tz0c8t/lf6/h2jjg/M/nIz8c7v/v3z345atz/v9zTkNpaiwBgFj92aPuAAA8SoIQgKgJQgCiJggBiNo3Mv/+53/9r4tXbi6u1t/v/Pa6tjXzXV1cZTXVVFNNNdVc2poZ2SCcmr4xfv7KQr8y+NPc/97j6uIqq6mmmmqqqebS1szIBuH6tjUNDQ0Xp2988T8LqAIAX1NLOSIEgK+dhsyC+p/87FdpEP7dzm+va613jjVJkvVtax5b8efzXb04fWNBY1U11VRTTTXVXJ
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-pdf/ExportPdfStatic/export-pdf-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-pdf-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

using var converter = new MarkdownConverter("business-plan.pdf");
var options = new ConvertOptions
{
    ImageExportStrategy = new ExportImagesToFileSystemStrategy("images")
    {
        ImagesRelativePath = "images"
    },
    HeadingLevelOffset = 1
};

converter.Convert("export-pdf-instance.md", options);
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-pdf-instance.zip" >}}  
```text
export-pdf-instance.md (7 KB)
images/img-001.png (3 KB)
images/img-002.jpg (73 KB)
images/img-003.jpg (76 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-pdf/ExportPdfInstance/export-pdf-instance.zip)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/net/getting-started/supported-document-formats" >}}).

---

## Pdf to Md

Path: /markdown/python-net/convert/export-pdf/


Use GroupDocs.Markdown to convert PDF documents to clean Markdown.

### Using static method

The simplest way to convert a PDF file:

{{< tabs "export-pdf-static">}}
{{< tab "export_pdf_to_markdown.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter

def export_pdf_to_markdown():
    """Convert a PDF document to Markdown using the static one-liner API."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Convert PDF to a Markdown string in one call
    markdown = MarkdownConverter.to_markdown("business-plan.pdf")

    # Step 3: Or save the conversion result directly to a file
    MarkdownConverter.to_file("business-plan.pdf", "export-pdf.md")

if __name__ == "__main__":
    export_pdf_to_markdown()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-pdf.txt" >}}  
```text
![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAHyAqYDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAABQYABAcIAwEJAv/EAGoQAAACBAoGBwMHBQkNBQYFBQEDAAQFERMhMUFRYXGBofAGFJGxweEHFSMkMzTRQ0TxAhYlNVJUghJFVWR0JjZCU2NldYSiCBciMkZWYmaFkpSy4naGlbTCc5akpcXSN7XE1eZyprbG1P/EABwBAAMAAwEBAQAAAAAAAAAAAAAEBQEDBgIHCP/EAD8RAAIAA
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-pdf/export_pdf_to_markdown/export-pdf.txt)
{{< /tab >}}
{{< tab "export-pdf.txt" >}}  
```text
![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAHyAqYDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAABQYABAcIAwEJAv/EAGoQAAACBAoGBwMHBQkNBQYFBQEDAAQFERMhMUFRYXGBofAGFJGxweEHFSMkMzTRQ0TxAhYlNVJUghJFVWR0JjZCU2NldYSiCBciMkZWYmaFkpSy4naGlbTCc5akpcXSN7XE1eZyprbG1P/EABwBAAMAAwEBAQAAAAAAAAAAAAAEBQEDBgIHCP/EAD8RAAIAA
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-pdf/export_pdf_to_markdown/export-pdf.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-pdf-instance">}}
{{< tab "export_pdf_with_options.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy

def export_pdf_with_options():
    """Convert a PDF to Markdown using the instance API with image export and heading offset."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Open the PDF document with a context manager
    with MarkdownConverter("business-plan.pdf") as converter:
        # Step 3: Configure the image export strategy to save images to disk
        strategy = ExportImagesToFileSystemStrategy("images")
        strategy.images_relative_path = "images"

        # Step 4: Set conversion options
        options = ConvertOptions()
        options.image_export_strategy = strategy
        options.heading_level_offset = 1  # shift all headings down one level

        # Step 

        # Step 5: Convert and save the Markdown output
        converter.convert("export-pdf-options.md", convert_options=options)

if __name__ == "__main__":
    export_pdf_with_options()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-pdf-options.zip" >}}  
```text
export-pdf-options.txt (34 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-pdf/export_pdf_with_options/export-pdf-options.zip)
{{< /tab >}}
{{< tab "export-pdf-options.zip" >}}  
```text
export-pdf-options.txt (33 KB)
images/img-001.jpg (60 KB)
images/img-002.png (470 bytes)
images/img-003.png (2 KB)
images/img-004.jpg (56 KB)
images/img-005.png (330 bytes)
images/img-006.png (438 bytes)
images/img-007.png (438 bytes)
images/img-008.png (438 bytes)
images/img-009.png (438 bytes)
[TRUNCATED] (35 files total)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-pdf/export_pdf_with_options/export-pdf-options.zip)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/python-net/getting-started/supported-document-formats" >}}).

---

## Pie Chart in Word Processing Document

Path: /assembly/java/pie-chart-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Pie Chart in Microsoft Word Document

### Creating a Pie Chart

Please follow below steps to can create Pie Chart in MS Word 2013.

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "Pie".
3.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/pie-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to share managers' contract prices dynamically with the following key requirements:

*   Report must show information on a Pie Chart.
*   It must indicate manager name with value (price of the contract).
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Price<<foreach [in getManagers()]>><<x [getName()]>>
```

#### Chart Data (Excel)

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td><td width="312" valign="bottom" style="width: 233.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Total Contract Price&lt;&lt;y [getContracts().sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">A</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">8.2</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">B</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">3.2</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">C</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">1.4</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">D</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">1.2</p></td></tr></tbody></table>
### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Pie Chart.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Pie%20Chart.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists f255d5a88a017636d67d2853a2b695eb >}}

## Pie Chart in OpenOffice Document

To be investigated.

---

## Pie Chart in Word Processing Document

Path: /assembly/net/pie-chart-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Pie Chart in Microsoft Word Document

### Creating a Pie Chart

Please follow below steps to can create Pie Chart in MS Word 2013.

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "Pie".
3.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/pie-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine)
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart.
*   It must indicate customer name with value (price of the orders purchased).
*   The report must be generated in the Word Processing Document.
      
  

{{< alert style="info" >}}See the video demonstration of Pie Chart in MS Word [here](https://www.youtube.com/watch?v=boKpFtW_TGE&list=PL25CTxMCj5vOzsaE9Rwjwd4-OwvdaWmJ8&index=13).{{< /alert >}}

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total Order Price&lt;&lt;y [</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">8.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.4</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.2</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: Working with GroupDocs.Assembly Engine.{{< /alert >}}

Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Pie Chart.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Pie%20Chart.docx?raw=true) (Template for CustomObject and JSON examples) 
*   [Pie Chart\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Pie%20Chart_DB.docx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists c33b871157bf4d925324201edb3a2dfd >}}

#### Database Entities

{{< gist GroupDocsGists e4e73891378c5bfa90ba25a945d64598 >}}

#### Using DataSet

{{< gist GroupDocsGists d3d2f7114bdc017607a4e08e7a4e3c9f >}}

#### Using XML DataSource

{{< gist GroupDocsGists 649de00eac7d607cf3ba501c7d130602 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 76375a01df61665860a7c60b31dbd200 >}}

## Pie Chart in OpenOffice Document

To be investigated.

---

## GroupDocs.Assembly for Java overview

Path: /assembly/java/product-overview/

A assembly is a document automation and reports generation API designed to create custom documents from templates.

With its powerful and straightforward API, you can execute the following actions:

*   Multiple data formats support
*   Use formulae & perform sequential data operations
*   Apply upper, lower, capital, firstcap formatting to strings in template syntax
*   Template syntax support formatting of ordinal, cardinal, alphabetic numeric nature
*   Support template documents with custom variables & text comments within template syntax tags
*   Dynamically insert out document content in report
*   Dynamically configure background color of html documents & generate barcode in reports
*   Dynamically insert hyperlinks in reports & apply attributes to email message body
*   Dynamically attach email attachments
*   Support of next field analogue of Microsoft Word
*   Update fields during word processing document assembly
*   Apply formula during spreadsheet assembly
*   Template formatting for numeric, text, image, date-time, chart elements
*   Conditional formatting of template text elements
*   Linq-based template syntax
*   Change format of assembled file using explicit specifications or file extension
*   Auto-removal of empty paragraphs
*   Generate various report types, e.g., charts, image, tables, lists and more
*   Inline template syntax errors in generated documents instead of exception throwing.
*   Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources

You can use GroupDocs.Assembly across multiple platforms and operation systems:

* Windows, Linux, and macOS

## Get started with GroupDocs.Assembly for Java

If you are new to GroupDocs.Assembly, see the following topics first:

* [System requirements](/assembly/java/system-requirements/)
* [Installation](/assembly/java/installation/)
* [Licensing](/assembly/java/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Assembly or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/assembly/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).
---

## GroupDocs.Assembly for Net overview

Path: /assembly/net/product-overview/

A assembly is a document automation and reports generation API designed to create custom documents from templates.

With its powerful and straightforward API, you can execute the following actions:

*   Multiple data formats support
*   Use formulae & perform sequential data operations
*   Apply upper, lower, capital, firstcap formatting to strings in template syntax
*   Template syntax support formatting of ordinal, cardinal, alphabetic numeric nature
*   Support template documents with custom variables & text comments within template syntax tags
*   Dynamically insert out document content in report
*   Dynamically configure background color of html documents & generate barcode in reports
*   Dynamically insert hyperlinks in reports & apply attributes to email message body
*   Dynamically attach email attachments
*   Support of next field analogue of Microsoft Word
*   Update fields during word processing document assembly
*   Apply formula during spreadsheet assembly
*   Template formatting for numeric, text, image, date-time, chart elements
*   Conditional formatting of template text elements
*   Linq-based template syntax
*   Change format of assembled file using explicit specifications or file extension
*   Auto-removal of empty paragraphs
*   Generate various report types, e.g., charts, image, tables, lists and more
*   Inline template syntax errors in generated documents instead of exception throwing.
*   Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources

You can use GroupDocs.Assembly across multiple platforms and operation systems:

* Windows, Linux, and macOS

## Get started with GroupDocs.Assembly for Net

If you are new to GroupDocs.Assembly, see the following topics first:

* [System requirements](/assembly/net/system-requirements/)
* [Installation](/assembly/net/installation/)
* [Licensing](/assembly/net/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Assembly or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/assembly/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).
---

## GroupDocs.Assembly for Python overview

Path: /assembly/python-net/product-overview/

A assembly is a document automation and reports generation API designed to create custom documents from templates.

With its powerful and straightforward API, you can execute the following actions:

*   Multiple data formats support
*   Use formulae & perform sequential data operations
*   Apply upper, lower, capital, firstcap formatting to strings in template syntax
*   Template syntax support formatting of ordinal, cardinal, alphabetic numeric nature
*   Support template documents with custom variables & text comments within template syntax tags
*   Dynamically insert out document content in report
*   Dynamically configure background color of html documents & generate barcode in reports
*   Dynamically insert hyperlinks in reports & apply attributes to email message body
*   Dynamically attach email attachments
*   Support of next field analogue of Microsoft Word
*   Update fields during word processing document assembly
*   Apply formula during spreadsheet assembly
*   Template formatting for numeric, text, image, date-time, chart elements
*   Conditional formatting of template text elements
*   Linq-based template syntax
*   Change format of assembled file using explicit specifications or file extension
*   Auto-removal of empty paragraphs
*   Generate various report types, e.g., charts, image, tables, lists and more
*   Inline template syntax errors in generated documents instead of exception throwing.
*   Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources

You can use GroupDocs.Assembly across multiple platforms and operation systems:

* Windows, Linux, and macOS

## Get started with GroupDocs.Assembly for Python via .NET

If you are new to GroupDocs.Assembly, see the following topics first:

* [System requirements](/assembly/python-net/system-requirements/)
* [Installation](/assembly/python-net/installation/)
* [Licensing](/assembly/python-net/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Assembly or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/assembly/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).
---

## GroupDocs.Comparison Overview

Path: /comparison/nodejs-java/groupdocs-comparison-overview/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) is a robust cross-platform library that enables you to integrate into your applications the feature of comparing and merging two or more files of [different formats]({{< ref "comparison/nodejs-java/getting-started/supported-document-formats.md" >}}). The resulting file displays differences in content line by line, including paragraphs, characters, styles, shapes, and positions.

The API provides the following features:

- GroupDocs.Comparison supports 100+ file formats without any additional software
- Wide range of options to customize the comparison process
- Information extraction – file type, page count, etc.
- Handful differences categorization and highlight
- Content structure, styling and formatting changes detection
- Ability to apply or reject detected changes and save result document 

You can use GroupDocs.Comparison across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 5 and higher

## Get started with GroupDocs.Comparison for Node.js via Java

If you are new to GroupDocs.Comparison, see the following topics first:

* [System requirements]({{< ref "comparison/nodejs-java/getting-started/system-requirements" >}})
* [Installation]({{< ref "comparison/nodejs-java/getting-started/installation" >}})
* [Licensing]({{< ref "comparison/nodejs-java/getting-started/licensing-and-evaluation-limitations.md" >}})
* [Basic usage]({{< ref "/comparison/nodejs-java/comparison-basic/compare-documents.md" >}})

## Technical support

If you encounter an issue while using GroupDocs.Comparison or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/comparison). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

---

## GroupDocs.Comparison Overview

Path: /comparison/python-net/groupdocs-comparison-overview/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) is a robust cross-platform library that enables you to integrate into your applications the feature of comparing and merging two or more files of [different formats]({{< ref "comparison/python-net/getting-started/supported-document-formats.md" >}}). The resulting file displays differences in content line by line, including paragraphs, characters, styles, shapes, and positions.

The API provides the following features:

- GroupDocs.Comparison supports 100+ file formats without any additional software
- Wide range of options to customize the comparison process
- Information extraction – file type, page count, etc.
- Handful differences categorization and highlight
- Content structure, styling and formatting changes detection
- Ability to apply or reject detected changes and save result document 

You can use GroupDocs.Comparison across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Python 3 and higher

## Get started with GroupDocs.Comparison for Python via .NET

If you are new to GroupDocs.Comparison, see the following topics first:

* [System requirements]({{< ref "comparison/python-net/getting-started/system-requirements" >}})
* [Installation]({{< ref "comparison/python-net/getting-started/installation" >}})
* [Licensing]({{< ref "comparison/python-net/getting-started/licensing-and-evaluation-limitations.md" >}})
* [Basic usage]({{< ref "/comparison/python-net/comparison-basic/compare-documents.md" >}})

## Technical support

If you encounter an issue while using GroupDocs.Comparison or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/comparison). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

---

## GroupDocs.Conversion for .NET overview

Path: /conversion/net/product-overview/


<!--img src="/conversion/net/images/home.png" alt="groupdocs-conversion-net-home" align="left" style="width:110px; margin: 0 30px 30px 0"/-->

GroupDocs.Conversion for .NET is a powerful and intuitive library for file conversion between a variety of supported document and image types, including all Microsoft Office and OpenDocument file formats, PDF documents, HTML, CAD, raster images (TIFF, JPEG, GIF, PNG, BMP) and many more. Conversion results can be easily customized and tuned with multiple and flexible options.
<!--
GroupDocs.Conversion allows to convert files between plenty of  popular  formats such as PDF, DOCX, XLSX, PPTX, EPUB, PNG, JPEG, TIFF and others.

By using GroupDocs.Conversion for .NET you can convert files without other  third-party applications like Microsoft Office or Adobe Acrobat!


------

## Benefits of using GroupDocs.Conversion
-->

Using GroupDocs.Conversion for .NET in your project gives you the following benefits:
<!--
- Rich set of document conversion features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of document conversion features
-->

- Thousands of different file conversion pairs for [multiple supported formats:]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}}) office documents, presentations, spreadsheets, images and much more.
- Independence from other applications. You can convert files without other third-party applications like Microsoft Office or Adobe Acrobat. 
- Ability to [convert whole document]({{< ref "conversion/net/developer-guide/basic-usage/convert" >}}) or [specific pages range]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/convert-specific-pages.md" >}}).
- [Place watermarks]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/add-watermark.md" >}}) at document pages during conversion.
- Huge amount of [additional options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/" >}}) to customize the appearance of the converted document.
- [Document information extraction]({{< ref "conversion/net/developer-guide/basic-usage/get-document-info" >}}) - file type, document page count etc.
- Increased conversion performance by [caching conversion results]({{< ref "conversion/net/developer-guide/advanced-usage/caching" >}}). Convert document once and use conversion results fast and efficiently.
- [Customizable caching]({{< ref "conversion/net/developer-guide/advanced-usage/caching/how-to-use-custom-cache-implementation.md" >}}). Caching to local disk is implemented by default and any type of storage can be supported by implementing caching interfaces – Amazon S3, Dropbox, Google Drive, Windows Azure and others.
- Performance. Designed to process thousands of files and utilize as minimum resources as possible.
- Scalability. Shipped as a single .NET assembly that can be deployed with any .NET application by simply [copying it]({{< ref "conversion/net/getting-started/installation.md#download-groupdocsconversion-from-the-official-website" >}}) or [installing via NuGet]({{< ref "conversion/net/getting-started/installation.md#install-groupdocsconversion-using-nuget-packages" >}}). You do not need to worry about any other services or modules.
- Simple and intuitive [public API](https://reference.groupdocs.com/conversion/net). All methods are doing what you would expect from them and nothing more.

<!--
### Independence from Other Applications

GroupDocs.Conversion does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Conversion a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Conversion is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Conversion is a single .NET assembly that can be deployed with any .NET application by simply copying it or installing via NuGet. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Conversion for .NET public API was designed to be simple and intuitive. All methods are doing what you would expect from them and nothing more.
-->
You can use GroupDocs.Conversion across [multiple platforms and operation systems]({{< ref "conversion/net/getting-started/system-requirements" >}}):

* Windows, Linux, and macOS
* .NET Framework 2.0 and higher
* .NET Core 2.1
* .NET 5 and higher

## Get started with GroupDocs.Conversion for .NET

If you are new to GroupDocs.Conversion, see the following topics first:

* [System requirements]({{< ref "conversion/net/getting-started/system-requirements" >}})
* [Installation]({{< ref "conversion/net/getting-started/installation" >}})
* [Licensing]({{< ref "conversion/net/getting-started/licensing-and-subscription" >}})
* [Basic usage]({{< ref "/conversion/net/developer-guide/basic-usage/" >}})

## Technical support

If you encounter an issue while using GroupDocs.Conversion or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/conversion). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).
---

## GroupDocs.Conversion for Node.js via Java overview

Path: /conversion/nodejs-java/product-overview/

GroupDocs.Conversion for Node.js via Java is a powerful and intuitive JavaScript package for file conversion between a variety of supported document and image types, including all Microsoft Office and OpenDocument file formats, PDF documents, HTML, CAD, raster images (TIFF, JPEG, GIF, PNG, BMP) and many more. Conversion results can be easily customized and tuned with multiple and flexible options.

Using GroupDocs.Conversion for Node.js via Java in your project gives you the following benefits:
<!--
- Rich set of document conversion features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of document conversion features
-->
- Thousands of different file conversion pairs for [multiple supported formats:]({{< ref "conversion/nodejs-java/getting-started/supported-document-formats.md" >}}) office documents, presentations, spreadsheets, images and much more.
- Independence from other applications. You can convert files without other third-party applications like Microsoft Office or Adobe Acrobat. 
- Ability to [convert whole document]({{< ref "conversion/nodejs-java/developer-guide/basic-usage/convert" >}}) or [specific pages range]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/converting/common-conversion-options/convert-specific-pages.md" >}}).
- Huge amount of [additional options]({{< ref "conversion/nodejs-java/developer-guide/advanced-usage/converting/conversion-options-by-document-family/" >}}) to customize the appearance of the converted document.
- [Document information extraction]({{< ref "conversion/nodejs-java/developer-guide/basic-usage/get-document-info" >}}) - file type, document page count etc.
- Performance. Designed to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradation from version to version.
- Provided as a single NPM package, easily deployable with any JavaScript application using NPM. You do not need to worry about any other services or modules.
- Simple and intuitive [public API](https://reference.groupdocs.com/conversion/nodejs-java). All methods are doing what you would expect from them and nothing more.


You can use GroupDocs.Conversion across [multiple platforms and operation systems]({{< ref "conversion/nodejs-java/getting-started/system-requirements" >}}):

* Windows, Linux, and macOS
* 32-bit or 64-bit operating system
* Node.js 18
* Java 8 and higher

## Get started with GroupDocs.Conversion for Node.js via Java

If you are new to GroupDocs.Conversion, see the following topics first:

* [System requirements]({{< ref "conversion/nodejs-java/getting-started/system-requirements" >}})
* [Installation]({{< ref "conversion/nodejs-java/getting-started/installation" >}})
* [Licensing]({{< ref "conversion/nodejs-java/getting-started/licensing-and-subscription" >}})
* [Basic usage]({{< ref "/conversion/nodejs-java/developer-guide/basic-usage/" >}})

## Technical support

If you encounter an issue while using GroupDocs.Conversion or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/conversion). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).


---

## GroupDocs.Markdown for .NET overview

Path: /markdown/net/product-overview/


## What is GroupDocs.Markdown?

GroupDocs.Markdown is a .NET library that converts documents from 20+ formats (PDF, Word, Excel, EPUB, TXT, CHM) into clean, structured Markdown. It uses a custom DOM-based renderer that gives full control over every aspect of the output.

Designed for AI/ML workflows, static site generators, and document processing pipelines — Markdown is the ideal format for language models, text analysis tools, and content management systems.

## Key capabilities

| Capability | Description |
|---|---|
| **20+ input formats** | PDF, DOCX, DOC, XLSX, XLS, CSV, EPUB, MOBI, TXT, CHM, RTF, ODT, and more |
| **Markdown flavors** | [GitHub Flavored Markdown or CommonMark]({{< ref "markdown/net/developer-guide/advanced-usage/markdown-flavor" >}}) |
| **Image handling** | [Base64 embed, file system, skip, or custom]({{< ref "markdown/net/developer-guide/advanced-usage/strategy/" >}}) with relative paths and image replacement |
| **YAML front matter** | [Auto-extract metadata]({{< ref "markdown/net/developer-guide/advanced-usage/front-matter" >}}) for Jekyll, Hugo, Docusaurus |
| **Document inspection** | [Read format, pages, title, author]({{< ref "markdown/net/developer-guide/basic-usage/get-document-info" >}}) without converting |
| **Spreadsheet control** | [Column/row truncation]({{< ref "markdown/net/developer-guide/advanced-usage/spreadsheet-options" >}}), sheet separators, hidden sheet filtering |
| **Heading offset** | [Shift heading levels]({{< ref "markdown/net/developer-guide/advanced-usage/heading-offset" >}}) for content embedding |
| **Async API** | [Non-blocking conversion]({{< ref "markdown/net/developer-guide/advanced-usage/async-api" >}}) for web and serverless |
| **Error handling** | [Specific exception types]({{< ref "markdown/net/developer-guide/advanced-usage/error-handling" >}}) and conversion warnings |

## Quick example

{{< tabs "quick-example" >}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// One-liner
string md = MarkdownConverter.ToMarkdown("business-plan.docx");
// # Quarterly Report
//
// ## Executive Summary
//
// This report covers the key initiatives...

// With options
var options = new ConvertOptions
{
    Flavor = MarkdownFlavor.GitHub,
    IncludeFrontMatter = true,
    HeadingLevelOffset = 1
};
MarkdownConverter.ToFile("business-plan.docx", "quick-example.md", options);
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "quick-example.md" >}}  
```text
---
title: "Meridian Outdoor Co. — Business Plan"
author: "Meridian Outdoor Co."
format: Docx
pages: 5
---

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/product-overview/QuickExample/quick-example.md)
{{< /tab >}}
{{< /tabs >}}

## Platform support

- Windows, Linux, macOS
- .NET Framework 4.6.2+
- .NET 6.0, 8.0, 10.0

## Get started

- [Quick start guide]({{< ref "markdown/net/getting-started/quick-start-guide" >}})
- [Installation]({{< ref "markdown/net/getting-started/installation" >}})
- [Features overview]({{< ref "markdown/net/getting-started/features-overview" >}})
- [API Reference](https://reference.groupdocs.com/markdown/net)

---

## GroupDocs.Metadata for Node.js overview

Path: /metadata/nodejs-java/product-overview/

GroupDocs.Metadata for Node.js via Java is a full featured class library which allows users to read and edit metadata associated with various document, image, audio, video and many other formats. It works with most notable metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3 and format-specific metadata properties. The Metadata API is very flexible and easy to operate with. It provides extended capabilities allowing working with metadata in a unified way regardless of the file format.

With its powerful and straightforward API, you can execute the following actions:

*   Work with most popular metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3, document properties, etc
*   Manage audio metadata: ID3 tag (ID3v1, ID3v2), Lyrics3 tag, APE
*   Create, modify and remove metadata associated with supported formats with a few lines of code
*   Identify built-in, custom and hidden metadata
*   Work with password-protected documents
*   Render image previews for supported formats to easily create UI for you application
*   Detect the format and MIME type of a loaded file by its internal structure
*   Use predefined tags to manipulate metadata properties in a unified way across all supported formats
*   Detect and remove digital signatures associated with a loaded file
*   Inspect office documents to extract user comments, form fields, hidden pages, etc
*   Work with a variety of document, image, video and audio formats
*   Manage metadata in e-books, torrent files, archives, electronic business cards, saved emails, etc

You can use GroupDocs.Metadata across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 8 and higher

## Get started with GroupDocs.Metadata for Node.js

If you are new to GroupDocs.Metadata, see the following topics first:

* [System requirements](/metadata/nodejs-java/system-requirements/)
* [Installation](/metadata/nodejs-java/installation/)
* [Licensing](/metadata/nodejs-java/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Metadata or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/metadata/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).
---

## GroupDocs.Metadata for Python overview

Path: /metadata/python-net/product-overview/

GroupDocs.Metadata for Python is a full featured class library which allows users to read and edit metadata associated with various document, image, audio, video and many other formats. It works with most notable metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3 and format-specific metadata properties. The Metadata API is very flexible and easy to operate with. It provides extended capabilities allowing working with metadata in a unified way regardless of the file format.

With its powerful and straightforward API, you can execute the following actions:

*   Work with most popular metadata standards: XMP, EXIF, IPTC, Image Resource Blocks, ID3, document properties, etc
*   Manage audio metadata: ID3 tag (ID3v1, ID3v2), Lyrics3 tag, APE
*   Create, modify and remove metadata associated with supported formats with a few lines of code
*   Identify built-in, custom and hidden metadata
*   Work with password-protected documents
*   Render image previews for supported formats to easily create UI for you application
*   Detect the format and MIME type of a loaded file by its internal structure
*   Use predefined tags to manipulate metadata properties in a unified way across all supported formats
*   Detect and remove digital signatures associated with a loaded file
*   Inspect office documents to extract user comments, form fields, hidden pages, etc
*   Work with a variety of document, image, video and audio formats
*   Manage metadata in e-books, torrent files, archives, electronic business cards, saved emails, etc

You can use GroupDocs.Metadata across multiple platforms and operation systems:

* Windows, Linux, and macOS

## Get started with GroupDocs.Metadata for Python via .NET

If you are new to GroupDocs.Metadata, see the following topics first:

* [System requirements](/metadata/python-net/system-requirements/)
* [Installation](/metadata/python-net/installation/)
* [Licensing](/metadata/python-net/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Metadata or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/metadata/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).
---

## GroupDocs.Parser Overview

Path: /parser/python-net/groupdocs-parser-overview/


[GroupDocs.Parser](https://products.groupdocs.com/parser/python-net) is a robust cross-platform library that enables you to integrate into your applications the feature of extracting text, images, metadata, and structured data from [different document formats]({{< ref "parser/python-net/supported-document-formats.md" >}}). The API provides comprehensive parsing capabilities including template-based extraction for structured documents, raw and formatted text extraction, and container processing.

The API provides the following features:

- GroupDocs.Parser supports 50+ file formats without any additional software
- Wide range of options to customize the extraction process
- Information extraction – file type, page count, etc.
- Text extraction in raw and formatted modes
- Template-based structured data extraction
- Metadata, images, tables, and attachments extraction
- Container processing (ZIP archives, email attachments, PDF portfolios)

You can use GroupDocs.Parser across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Python versions 3.5–3.13 supported

## Get started with GroupDocs.Parser for Python via .NET

If you are new to GroupDocs.Parser, see the following topics first:

* [System requirements]({{< ref "parser/python-net/system-requirements" >}})
* [Installation]({{< ref "parser/python-net/getting-started/installation" >}})
* [Licensing]({{< ref "parser/python-net/licensing-and-evaluation-limitations.md" >}})
* [Basic usage]({{< ref "/parser/python-net/developer-guide/basic-usage/extract-text-from-documents.md" >}})

## Technical support

If you encounter an issue while using GroupDocs.Parser or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/parser). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).


---

## GroupDocs.Total for Java overview

Path: /total/java/product-overview/


GroupDocs.Total for Java is a comprehensive suite of document automation .NET on-premise APIs offered by GroupDocs. We compile it monthly to ensure you have access to the latest versions of our document manipulation APIs.

With GroupDocs.Total for Java, developers can leverage all our APIs with a single license. Alternatively, you also have the option to order any individual API separately.

The products included in the GroupDocs.Total for Java suite are listed below.

| Product | Description |
|:--|---|
| [GroupDocs.Annotation for Java](https://docs.groupdocs.com/annotation/java/) | A powerful Java library for adding document annotation features to your applications, enabling users to annotate and collaborate on various document types. |
| [GroupDocs.Assembly for Java](https://docs.groupdocs.com/assembly/java/) | A Java library that allows you to generate documents based on templates, merging data from various sources into dynamic documents. |
| [GroupDocs.Comparison for Java](https://docs.groupdocs.com/comparison/java/) | A Java library for document comparison, enabling users to identify differences and visualize changes between two documents. | 
| [GroupDocs.Conversion for Java](https://docs.groupdocs.com/conversion/java/) | Convert documents between different formats using this Java library, supporting a wide range of document types and providing flexibility in format conversion. | 
| [GroupDocs.Editor for Java](https://docs.groupdocs.com/editor/java/) | Incorporate document editing capabilities into your Java applications, allowing users to edit and manipulate documents seamlessly. | 
| [GroupDocs.Merger for Java](https://docs.groupdocs.com/merger/java/) | Merge or split documents effortlessly in your Java applications using this library, providing various options for document manipulation. |
| [GroupDocs.Metadata for Java](https://docs.groupdocs.com/metadata/java/) | Access and modify metadata information in documents with this Java library, offering comprehensive metadata management features. | 
| [GroupDocs.Parser for Java](https://docs.groupdocs.com/parser/java/) | Extract data from documents with ease using this Java library, supporting text and metadata extraction from various document formats. |
| [GroupDocs.Redaction for Java](https://docs.groupdocs.com/redaction/java/) | Securely redact sensitive information from documents in your Java applications, ensuring data privacy and compliance with regulations. |
| [GroupDocs.Search for Java](https://docs.groupdocs.com/search/java/) | Implement powerful search functionality in your Java applications, enabling users to search and retrieve information from a variety of document types. | 
| [GroupDocs.Signature for Java](https://docs.groupdocs.com/signature/java/) | Add electronic and digital signatures to documents using this Java library, offering a range of signature options and customization features. | 
| [GroupDocs.Viewer for Java](https://docs.groupdocs.com/viewer/java/) | Embed document viewing capabilities into your Java applications, supporting a wide range of document formats for seamless viewing. |
| [GroupDocs.Watermark for Java](https://docs.groupdocs.com/watermark/java/) | Protect your documents by adding watermarks using this Java library, offering various watermarking options for enhanced document security. | 


You can use GroupDocs.Total across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 8 and higher

## Get started with GroupDocs.Total for Java

If you are new to GroupDocs.Total, see the following topics first:

* [System requirements](/total/java/system-requirements/)
* [Installation](/total/java/installation/)
* [Licensing](/total/java/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Total or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/total/8). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

---

## GroupDocs.Total for .NET overview

Path: /total/net/product-overview/


GroupDocs.Total for .NET is a comprehensive suite of document automation .NET on-premise APIs offered by GroupDocs. We compile it monthly to ensure you have access to the latest versions of our document manipulation APIs.

With GroupDocs.Total for .NET, developers can leverage all our APIs with a single license. Alternatively, you also have the option to order any individual API separately.

The products included in the GroupDocs.Total for .NET suite are listed below.

| Product | Description |
|:--|---|
| [GroupDocs.Conversion&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/conversion/net/) | Convert documents between different formats using this .NET library, supporting a wide range of document types and providing flexibility in format conversion. | 
| [GroupDocs.Viewer&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/viewer/net/) | Embed document viewing capabilities into your .NET applications, supporting a wide range of document formats for seamless viewing. |
| [GroupDocs.Comparison&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/comparison/net/) | A .NET library for document comparison, enabling users to identify differences and visualize changes between two documents. | 
| [GroupDocs.Watermark&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/watermark/net/) | Protect your documents by adding watermarks using this .NET library, offering various watermarking options for enhanced document security. | 
| [GroupDocs.Merger&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/merger/net/) | Merge or split documents effortlessly in your .NET applications using this library, providing various options for document manipulation. |
| [GroupDocs.Metadata&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/metadata/net/) | Access and modify metadata information in documents with this .NET library, offering comprehensive metadata management features. | 
| [GroupDocs.Search&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/search/net/) | Implement powerful search functionality in your .NET applications, enabling users to search and retrieve information from a variety of document types. | 
| [GroupDocs.Assembly&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/assembly/net/) | A .NET library that allows you to generate documents based on templates, merging data from various sources into dynamic documents. |
| [GroupDocs.Signature&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/signature/net/) | Add electronic and digital signatures to documents using this .NET library, offering a range of signature options and customization features. | 
| [GroupDocs.Editor&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/editor/net/) | Incorporate document editing capabilities into your .NET applications, allowing users to edit and manipulate documents seamlessly. | 
| [GroupDocs.Parser&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/parser/net/) | Extract data from documents with ease using this .NET library, supporting text and metadata extraction from various document formats. |
| [GroupDocs.Redaction&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/redaction/net/) | Securely redact sensitive information from documents in your .NET applications, ensuring data privacy and compliance with regulations. |
| [GroupDocs.Annotation&nbsp;for&nbsp;.NET](https://docs.groupdocs.com/annotation/net/) | A powerful .NET library for adding document annotation features to your applications, enabling users to annotate and collaborate on various document types. |

## Get started with GroupDocs.Total for .NET

If you are new to GroupDocs.Total, see the following topics first:

* [System requirements](/total/net/system-requirements/)
* [Installation](/total/net/installation/)
* [Licensing](/total/net/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Total or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/total/8). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

---

## GroupDocs.Viewer for Java overview

Path: /viewer/java/product-overview/

GroupDocs.Viewer for Java is a high-performance and cross-platform library that allows you to build desktop and web [file viewer applications](https://en.wikipedia.org/wiki/File_viewer).

With its powerful and straightforward API, you can execute the following actions:

* View documents in the [most popular file formats](/viewer/java/supported-document-formats/) (DOCX, XLSX, PPTX, PDF, DWG, PSD, HTML, ZIP, and more) by rendering them as HTML, PDF, PNG, and JPEG files. You no longer need third-party software to view files within your Java application.
* Load documents from [different sources](/viewer/java/loading-documents-from-different-sources/) (a file, a stream, a URL, an FTP server, Amazon S3, Azure Blob Storage, and so on).
* Open [password-protected documents](/viewer/java/load-password-protected-document/).
* Render the entire document or specific pages.
* Embed all external resources in the output HTML files, generate [responsive](/viewer/java/render-with-responsive-layout/) and [minified](/viewer/java/minify-html/) HTML pages.
* [Protect](/viewer/java/protect-pdf-documents/) the output PDF files and [reorder their pages](/viewer/java/reorder-pages/).
* [Rotate pages](/viewer/java/flip-or-rotate-pages/) in the output files.
* Specify whether to render notes and comments contained in the source document.
* Extract text from PDF files and images.
* [Extract archive contents](/viewer/java/how-to-extract-and-save-attachments/) and [save files](/viewer/java/how-to-extract-and-save-attachments/) attached to PDF documents, email messages, and Outlook data files.
* [Obtain basic information](/viewer/java/how-to-get-file-type-and-pages-count/) about the source document (the file type, number of pages, and page information).
* [Replace missing document fonts](/viewer/java/replace-missing-font/) or [specify a folder](/viewer/java/set-custom-fonts/) where GroupDocs.Viewer should look for these fonts.
* [Add text watermarks](/viewer/java/add-text-watermark/) to the output HTML, PDF, and image files.
* [Implement caching](/viewer/java/caching-results/) to increase document loading speed and optimize application performance.

You can use GroupDocs.Viewer across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 5 and higher

## Get started with GroupDocs.Viewer for Java

If you are new to GroupDocs.Viewer, see the following topics first:

* [System requirements](/viewer/java/system-requirements/)
* [Installation](/viewer/java/installation/)
* [Licensing](/viewer/java/licensing-and-subscription/)
* [Document rendering basics](/viewer/java/document-rendering-basics/)

## Technical support

If you encounter an issue while using GroupDocs.Viewer or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/viewer/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).


---

## GroupDocs.Viewer for .NET overview

Path: /viewer/net/product-overview/

GroupDocs.Viewer for .NET is a high-performance and cross-platform library that allows you to build desktop and web [file viewer applications](https://en.wikipedia.org/wiki/File_viewer).

With its powerful and straightforward API, you can execute the following actions:

* View documents in the [most popular file formats](/viewer/net/supported-document-formats/) (DOCX, XLSX, PPTX, PDF, DWG, PSD, HTML, ZIP, and more) by rendering them as HTML, PDF, PNG, and JPEG files. You no longer need third-party software to view files within your .NET application.
* Load documents from [different sources](/viewer/net/loading-documents-from-different-sources/) (a file, a stream, a URL, an FTP server, Amazon S3, Azure Blob Storage, and so on).
* Open [password-protected documents](/viewer/net/load-password-protected-document/).
* Render the entire document or specific pages.
* Embed all external resources in the output HTML files, generate [responsive](/viewer/net/render-with-responsive-layout/) and [minified](/viewer/net/minify-html/) HTML pages.
* [Protect](/viewer/net/protect-pdf-documents/) the output PDF files and [reorder their pages](/viewer/net/reorder-pages/).
* [Rotate pages](/viewer/net/flip-or-rotate-pages/) in the output files.
* Specify whether to render notes and comments contained in the source document.
* Extract text from PDF files and images.
* [Extract archive contents](/viewer/net/how-to-extract-and-save-attachments/) and [save files](/viewer/net/how-to-extract-and-save-attachments/) attached to PDF documents, email messages, and Outlook data files.
* [Obtain basic information](/viewer/net/how-to-get-file-type-and-pages-count/) about the source document (the file type, number of pages, and page information).
* [Replace missing document fonts](/viewer/net/replace-missing-font/) or [specify a folder](/viewer/net/set-custom-fonts/) where GroupDocs.Viewer should look for these fonts.
* [Add text watermarks](/viewer/net/add-text-watermark/) to the output HTML, PDF, and image files.
* [Implement caching](/viewer/net/caching-results/) to increase document loading speed and optimize application performance.

You can use GroupDocs.Viewer across multiple platforms and operation systems. There are two versions of the GroupDocs.Viewer — a "classic" GroupDocs.Viewer for .NET and a new GroupDocs.Viewer.CrossPlatform, which was released on March 2024.

GroupDocs.Viewer for .NET supports the maximum variety of operating systems and target platforms:

* Windows, Linux, and macOS
* .NET Framework 4.6.2 and higher
* .NET 6 and higher

However, it internally utilizes a System.Drawing library and thus [cannot be used on Linux on .NET 6.0 and above](https://learn.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only).

That's why the GroupDocs.Viewer.CrossPlatform was created — it is a System.Drawing-free and may be used on Linux on .NET 6.0 and above. However, it does not support .NET Framework, .NET Core and .NET 5.0.

## Get started with GroupDocs.Viewer for .NET

If you are new to GroupDocs.Viewer, see the following topics first:

* [System requirements](/viewer/net/system-requirements/)
* [Installation](/viewer/net/installation/)
* [Licensing](/viewer/net/licensing-and-subscription/)
* [Document rendering basics](/viewer/net/document-rendering-basics/)

## Technical support

If you encounter an issue while using GroupDocs.Viewer or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/viewer/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

---

## GroupDocs.Viewer for Node.js overview

Path: /viewer/nodejs-java/product-overview/

GroupDocs.Viewer for Node.js is a high-performance and cross-platform library that allows you to build desktop and web [file viewer applications](https://en.wikipedia.org/wiki/File_viewer).

With its powerful and straightforward API, you can execute the following actions:

* View documents in the [most popular file formats](/viewer/nodejs-java/supported-document-formats/) (DOCX, XLSX, PPTX, PDF, DWG, PSD, HTML, ZIP, and more) by rendering them as HTML, PDF, PNG, and JPEG files. You no longer need third-party software to view files within your Java application.
* Open [password-protected documents](/viewer/nodejs-java/load-password-protected-document/).
* Render the entire document or specific pages.
* Embed all external resources in the output HTML files, generate [responsive](/viewer/nodejs-java/render-with-responsive-layout/) and [minified](/viewer/nodejs-java/minify-html/) HTML pages.
* [Protect](/viewer/nodejs-java/protect-pdf-documents/) the output PDF files and [reorder their pages](/viewer/nodejs-java/reorder-pages/).
* [Rotate pages](/viewer/nodejs-java/flip-or-rotate-pages/) in the output files.
* Specify whether to render notes and comments contained in the source document.
* Extract text from PDF files and images.
* [Extract archive contents](/viewer/nodejs-java/how-to-extract-and-save-attachments/) and [save files](/viewer/nodejs-java/how-to-extract-and-save-attachments/) attached to PDF documents, email messages, and Outlook data files.
* [Obtain basic information](/viewer/nodejs-java/how-to-get-file-type-and-pages-count/) about the source document (the file type, number of pages, and page information).
* [Replace missing document fonts](/viewer/nodejs-java/replace-missing-font/) or [specify a folder](/viewer/nodejs-java/set-custom-fonts/) where GroupDocs.Viewer should look for these fonts.
* [Add text watermarks](/viewer/nodejs-java/add-text-watermark/) to the output HTML, PDF, and image files.
* [Implement caching](/viewer/nodejs-java/caching-results/) to increase document loading speed and optimize application performance.

You can use GroupDocs.Viewer across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 8 and higher

## Get started with GroupDocs.Viewer for Node.js

If you are new to GroupDocs.Viewer, see the following topics first:

* [System requirements](/viewer/nodejs-java/system-requirements/)
* [Installation](/viewer/nodejs-java/installation/)
* [Licensing](/viewer/nodejs-java/licensing-and-subscription/)
* [Document rendering basics](/viewer/nodejs-java/document-rendering-basics/)

## Technical support

If you encounter an issue while using GroupDocs.Viewer or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/viewer/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).


---

## GroupDocs.Watermark Overview

Path: /watermark/net/groupdocs-watermark-overview/


## Protect Your Documents with Smart Watermarking

**GroupDocs.Watermark for .NET** is a powerful and flexible API that helps developers **add, search, edit, or remove watermarks** from documents and images across more than 50 file formats.

Whether you need to **add a confidential watermark**, apply **invisible tracking for sensitive content**, or **automate watermarking at scale**, GroupDocs.Watermark offers the features and precision control you need — without relying on external software like Microsoft Office or Adobe Acrobat.

### Supported Formats

- Documents: **PDF, DOCX/DOC, RTF**
- Presentations: **PPTX/PPT**
- Spreadsheets: **XLSX/XLS**
- Images: **JPG, PNG, TIFF, GIF**, and [more]({{< ref "/watermark/net/getting-started/supported-document-formats.md" >}}) 

---

## Key Features

### Add or Remove Watermarks

- Add **text watermarks** or **image watermarks** to documents or images
- Remove watermarks even if they were added by third-party tools
- Detect and remove watermarks based on text, font, or formatting
- Protect watermarks from editing by locking them in the content structure

### Advanced Customization

- Set **custom font**, color, opacity, and positioning
- Apply watermarks to specific **pages**, **slides**, **sections**, or **frames**
- Align watermark to **bleed box**, **crop box**, **art box**, or **trim box** in PDFs
- Replace existing watermark text with updated formatting

### Invisible & Intelligent Watermarks

- Add **invisible watermarks** that only appear during printing
- Add **tracking watermarks** for audit or copyright protection
- Use OCR-like detection to find obfuscated or hidden text watermarks
- Match image-based watermarks using visual similarity

### Comprehensive Coverage

- Add watermarks to:
  - All **headers and footers**
  - All **attachments** in PDFs or emails
  - All **image shapes** in presentations or Word documents
- Rasterize content to protect watermarks from extraction
- Automatically find and process watermarks in multi-layered or structured content

---

## Real-World Use Cases

> 💡 You can use GroupDocs.Watermark for:

- Adding a **Confidential** watermark before sending internal files
- Protecting content with **invisible watermarks** for IP tracking
- Automating watermarking of **PDF invoices** or **Excel reports**
- **Removing unwanted watermarks** from third-party documents
- Inserting company logos or custom stamps on **Word or PowerPoint slides**

---

## Frequently Asked Questions

### ❓ How can I remove a watermark from a document?

Use the `Watermarker.Remove()` method to delete both visible and invisible watermarks. You can target specific types using watermark search filters.

### ❓ Can I insert a custom watermark on each slide of a presentation?

Yes, you can add text or image watermarks to all slides or selected ones in PPT/PPTX files.

### ❓ How do I add a diagonal watermark?

To add a diagonal watermark, set the desired rotation angle (e.g., 45 degrees) using the `RotationAngle` property. To repeat the watermark across the page, enable tiling with the `TileOptions`. You can also customize the watermark’s position, font, opacity, and size to achieve a polished, professional appearance.

---

## Learn More

- How to [add]({{< ref "watermark/net/developer-guide/basic-usage/add-text.md" >}}) a watermark to a document
- How to [remove]({{< ref "watermark/net/developer-guide/advanced-usage/searching-and-modifying-watermarks/removing-found-watermarks.md" >}}) watermark from PDF
- Supported File [Formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}})
- Code Examples [Gallery]({{< ref "watermark/net/getting-started/how-to-run-examples.md" >}})

---

Start protecting your content today with **GroupDocs.Watermark for .NET** — the complete solution for secure, flexible, and automated document watermarking.


---

## GroupDocs.Watermark Overview

Path: /watermark/nodejs-java/groupdocs-watermark-overview/


[GroupDocs.Watermark](https://products.groupdocs.com/watermark/nodejs-java) is a robust cross-platform library that allows to add watermarks that are hard to be automatically removed by third-party tools, search and remove previously added watermarks of popular types (including watermarks added by third-party tools) in a document.

The API provides the following features:

- Add text and image watermark to supported document formats.
- Search and remove text and image watermarks.
- Search watermarks in particular objects.
- Apply a watermark to images inside a document.
- Work with existing watermark objects.
- Extract information of watermark objects in a document.
- Perform PDF document rasterization.
- Fetch document basic information.
- Search watermarks by text formatting (font, color, etc.).
- Set background image for charts in Excel and PowerPoint documents.

You can use GroupDocs.Watermark across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 5 and higher

## Get started with GroupDocs.Watermark for Node.js via Java

If you are new to GroupDocs.Watermark, see the following topics first:

* [System requirements]({{< ref "watermark/nodejs-java/getting-started/system-requirements" >}})
* [Installation]({{< ref "watermark/nodejs-java/getting-started/installation" >}})
* [Licensing]({{< ref "watermark/nodejs-java/getting-started/evaluation-limitations-and-licensing.md" >}})
* [Basic usage]({{< ref "/watermark/nodejs-java/developer-guide/basic-usage/" >}})

## Technical support

If you encounter an issue while using GroupDocs.Watermark or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/watermark). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

---

## GroupDocs.Watermark for Python overview

Path: /watermark/python-net/product-overview/

[GroupDocs.Watermark](https://products.groupdocs.com/watermark/nodejs-java) is a robust cross-platform library that allows to add watermarks that are hard to be automatically removed by third-party tools, search and remove previously added watermarks of popular types (including watermarks added by third-party tools) in a document.

The API provides the following features:

- Add text and image watermark to supported document formats.
- Search and remove text and image watermarks.
- Search watermarks in particular objects.
- Apply a watermark to images inside a document.
- Work with existing watermark objects.
- Extract information of watermark objects in a document.
- Perform PDF document rasterization.
- Fetch document basic information.
- Search watermarks by text formatting (font, color, etc.).
- Set background image for charts in Excel and PowerPoint documents.

* Windows, Linux, and macOS
* .NET Core 3.1 and higher

## Get started with GroupDocs.Watermark for Python

If you are new to GroupDocs.Watermark, see the following topics first:

* [System requirements](/watermark/python-net/system-requirements/)
* [Installation](/watermark/python-net/installation/)
* [Licensing](/watermark/python-net/licensing-and-subscription/)

## Technical support

If you encounter an issue while using GroupDocs.Watermark or have a technical question, feel free to create a post in our [Free Support Forum](https://forum.groupdocs.com/c/watermark/9). If free support is not sufficient, you can submit a ticket to our [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).


---

## Product Overview

Path: /annotation/java/product-overview/

GroupDocs.Annotation is a powerful cross-platform library that allows you to implement in your applications the ability to annotate text or images in files of [various formats]({{< ref "annotation/java/getting-started/supported-document-formats.md" >}}).
Annotations may be comments, explanations with highlighted notes, watermarks, polylines, text or resource redactions, etc.

With a powerful and simple API, you can do the following.

* Annotate documents of any supported format;
* Use annotations of different types - text, graphics, watermarks, revisions, etc.;
* Customize annotations of each type, specifying the color, weight, and style of the font, opacity, etc.;
* Provide the user with the opportunity to collaborate through annotations, comments, and responses;
* Get file information such as file type, number of pages, etc.;
* Generate preview file for precise placement of annotations;
* Export or import annotations to a file.


You can use GroupDocs.Viewer across multiple platforms and operation systems:

* Windows, Linux, and macOS
* Java 5 and higher

---

## Product Overview

Path: /annotation/net/product-overview/

GroupDocs.Annotation is a powerful cross-platform library that allows you to implement in your applications the ability to annotate text or images in files of [various formats]({{< ref "annotation/net/getting-started/supported-document-formats.md" >}}).
Annotations may be comments, explanations with highlighted notes, watermarks, polylines, text or resource redactions, and so on.

With a powerful and simple API, you can do the following:

* Annotate documents of any supported format;
* Use annotations of different types - text, graphics, watermarks, revisions, etc.;
* Customize annotations of each type, specifying the color, weight, and style of the font, opacity, etc.;
* Provide the user with the opportunity to collaborate through annotations, comments, and responses;
* Get file information such as file type, number of pages, etc.;
* Generate preview file for precise placement of annotations;
* Export or import annotations to a file.

---

## Product Overview

Path: /classification/net/product-overview/

{{< alert style="info" >}}Welcome to GroupDocs.Classification for .NET GroupDocs.Classification is a .NET component built to allow developers to classify texts and documents, whether simple or complex. It allows developers to use three different taxonomies: IAB (version 2), that created by the Interactive Advertising Bureau, Documents taxonomy, that created by Aspose and simple Sentiment taxonomy (Negative/Positive). For the Sentiment taxonomy Chinese language is supported.{{< /alert >}}

## Product Description

GroupDocs.Classification is a robust .NET component that lets developers to analyze text and documents without using any document-related tool to open documents or extract text. It provides a simple Application Programming Interface (API) that is easy to learn and use.

GroupDocs.Classification for .NET is implemented using Managed C# and it can be used with any .NET language like C#, VB.NET and J# etc. It can be integrated with any kind of application either it's an ASP.NET Web Application or a Windows Application. 

So that the developers can get up and running quickly, GroupDocs.Classification for .NET provides fully featured demos and working examples written in C#. Using [these demos](https://github.com/groupdocs-classification/GroupDocs.Classification-for-.NET), developers can quickly learn about the features provided by GroupDocs.Classification for .NET.

The fast, light-weight component classify documents efficiently and helps your application perform better.

GroupDocs.Classification for .NET is multithread safe as long as only one thread works on a document at a time. It is a typical scenario to have one thread working on one document. Different threads can safely work on different documents at the same time.

## Declaration

All GroupDocs .NET components require Full Trust permission set. The reason is, GroupDocs.Classification .NET components need to access registry settings, system files other than virtual directory for certain operations like parsing fonts etc. Moreover, GroupDocs.Classification .NET Components are based on core .NET system classes that also require Full Trust permission set in many cases.

Internet Service Providers hosting multiple applications from different companies mostly enforce Medium Trust security level. In case of .NET 2.0, such security level applies the following constraints:

*   **OleDbPermission is not available**. This means you cannot use the ADO.NET managed OLE DB data provider to access databases.
*   **EventLogPermission is not available**. This means you cannot access the Windows event log.
*   **ReflectionPermission is not available**. This means you cannot use reflection.
*   **RegistryPermission is not available**. This means you cannot access the registry.
*   **WebPermission is restricted**. This means your application can only communicate with an address or range of addresses that you define in the <trust> element.
*   **FileIOPermission is restricted**. This means you can only access files in your application's virtual directory hierarchy.

Due to the reasons specified above, GroupDocs .NET components cannot be used on servers granting permission set other than Full Trust.

## Technical Support

GroupDocs provides unlimited free technical support for all its products. The support is available to all users, including evaluation. If you need help with GroupDocs.Classification, consider the following:

*   The main avenue for support is the [GroupDocs.Forums](https://forum.groupdocs.com/) . Post your question in the [GroupDocs.Classification Forum](https://forum.groupdocs.com/c/classification) and it will be answered within a few hours. The questions are answered directly by the GroupDocs.Classification development team.

*   Please note, GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

*   When expecting a reply in the forums, please allow for time zone differences.

If you have an issue with GroupDocs.Classification, follow these simple steps to make sure it is resolved in the most efficient way:

*   Make sure you use the latest GroupDocs.Classification version before reporting the issue, see GroupDocs.Classification for .NET NuGet to find out about the latest version.

*   Have a look through the forums, this documentation and API Reference before reporting the issue; maybe your question was already answered.

*   When reporting an issue, please include the original document and possibly a fragment of your code that causes the problem. If you need to attach multiple files, zip them into one. It is safe to attach your documents in GroupDocs.Forums since only you and GroupDocs developers will have access to the attached files.

*   Please try to report one issue per thread. If you have another issue, report it in a separate thread.

---

## Product Overview

Path: /editor/java/product-overview/

<img src="/editor/java/images/home.png" width="110" height="110" alt="groupdocs-editor-java-home" align="left" style="margin: 0 30px 30px 0"/>

GroupDocs.Editor for Java is a powerful and lightweight library which allows you to edit most popular document formats using 3rd party front-end WYSIWYG HTML-editors without any additional software.

GroupDocs.Editor supports most of the popular document formats such as PDF, DOCX, XLSX, PPTX, XPS and others.

By using GroupDocs.Editor for Java you can edit files of various formats and no third-party applications required!

## How GroupDocs.Editor Works?

GroupDocs.Editor is a Java class library (DLL), that is designed to allow users to load their documents of different format, open them for editing, edit, and save the edited version to some format, which may be the exactly same as input, or may differ. The most basic thing is that GroupDocs.Editor is GUI-less, it has no GUI, but only a public API, so it should be used within end-user environment, but not as the standalone application. Despite GroupDocs.Editor can be used anywhere, where Java Framework is installed, it is intended to be used in web applications. Main and most common GroupDocs.Editor usage scenario implies that GroupDocs.Editor is used in a web-application and is located on the server-side. Server-based code invokes GroupDocs.Editor methods, passes input documents and different parameters, and obtains results, that are transmitted to the client-side into the WYSIWYG HTML-editor, like CKEditor or TinyMCE. When user has edited the document in the browser and is sending back the edited content to the server, server-based code again invokes GroupDocs.Editor, passes edited content and obtains edited document in desired format.
  
## Benefits of using GroupDocs.Editor

Using GroupDocs.Editor for Java in your project gives you the following benefits:

- Rich set of file editing features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of file editing features

GroupDocs.Editor for Java main features are the following:

- Translate document to HTML/CSS markup with resources, that is compatible with HTML WYSIWYG editors;
- Save edited HTML/CSS to source document format;
- Export edited document to PDF format;
- Plenty of additional options to customize editing process - edit password protected documents, extract document fonts, export document language information (useful for spell-checkers), specify document encoding or write-protection during saving etc.
- Document information extraction - page count, size, encrypted flag etc.

### Platform Independence

GroupDocs.Editor for Java covers most of the popular development environments and deployment platforms. Its API can be used to develop applications for a wide range of operating systems, such as Windows, Linux, and Mac OS, and various platforms. Read ["System Requirements"]({{< ref "editor/java/getting-started/system-requirements" >}}) for more details.

You can use GroupDocs.Editor for Java to build any type of 32-bit or 64-bit Java application, including ASPJava, ASPJava Core, WCF, WinForms, etc.

### Independence from Other Applications

GroupDocs.Editor does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Editor a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Editor is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Editor is a single Java assembly that can be deployed with any Java application by simply copying it or installing via NuGet. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Editor for Java public API was designed to be simple and intuitive. The methods are doing what you wold expect from them and nothing more.

## Pricing and Policies

Please visit the ["Licensing and Subscription"]({{< ref "editor/java/getting-started/licensing-and-subscription.md" >}}) page for information on licenses and review the ["Pricing Information"](https://purchase.groupdocs.com/pricing/editor/java) page for details on pricing.

## Technical Support

We do provide free and paid support for all of our users, including evaluation. For more information on GroupDocs.Editor technical support please check ["Technical Support"]({{< ref "technical-support" >}}) page.

---

## Product Overview

Path: /editor/net/product-overview/


<img src="/editor/net/images/home.png" width="110" height="110" alt="groupdocs-editor-net-home" align="left" style="margin: 0 30px 30px 0"/>

GroupDocs.Editor for .NET is a powerful and lightweight library which allows you to edit most popular document formats using 3rd party front-end WYSIWYG HTML-editors without any additional software.

GroupDocs.Editor supports most of the popular document formats such as PDF, DOCX, XLSX, PPTX, XPS and others.

By using GroupDocs.Editor for .NET you can edit files of various formats and no third-party applications required!

## How GroupDocs.Editor Works?

GroupDocs.Editor is a .NET class library (DLL), that is designed to allow users to load their documents of different format, open them for editing, edit, and save the edited version to some format, which may be the exactly same as input, or may differ. The most basic thing is that GroupDocs.Editor is GUI-less, it has no GUI, but only a public API, so it should be used within end-user environment, but not as the standalone application. Despite GroupDocs.Editor can be used anywhere, where .NET Framework is installed, it is intended to be used in web applications. Main and most common GroupDocs.Editor usage scenario implies that GroupDocs.Editor is used in a web-application and is located on the server-side. Server-based code invokes GroupDocs.Editor methods, passes input documents and different parameters, and obtains results, that are transmitted to the client-side into the WYSIWYG HTML-editor, like CKEditor or TinyMCE. When user has edited the document in the browser and is sending back the edited content to the server, server-based code again invokes GroupDocs.Editor, passes edited content and obtains edited document in desired format.
  
## Benefits of using GroupDocs.Editor

Using GroupDocs.Editor for .NET in your project gives you the following benefits:

- Rich set of file editing features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of file editing features

GroupDocs.Editor for .NET main features are the following:

- Translate document to HTML/CSS markup with resources, that is compatible with HTML WYSIWYG editors;
- Save edited HTML/CSS to source document format;
- Export edited document to PDF format;
- Plenty of additional options to customize editing process - edit password protected documents, extract document fonts, export document language information (useful for spell-checkers), specify document encoding or write-protection during saving etc.
- Document information extraction - page count, size, encrypted flag etc.

### Platform Independence

GroupDocs.Editor for .NET covers most of the popular development environments and deployment platforms. Its API can be used to develop applications for a wide range of operating systems, such as Windows, Linux, and Mac OS, and various platforms. Read ["System Requirements"]({{< ref "editor/net/getting-started/system-requirements" >}}) for more details.

You can use GroupDocs.Editor for .NET to build any type of 32-bit or 64-bit .NET application, including ASP.NET, ASP.NET Core, WCF, WinForms, etc.

### Independence from Other Applications

GroupDocs.Editor does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Editor a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Editor is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Editor is a single .NET assembly that can be deployed with any .NET application by simply copying it or installing via NuGet. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Editor for .NET public API was designed to be simple and intuitive. The methods are doing what you wold expect from them and nothing more.

## Pricing and Policies

Please visit the ["Licensing and Subscription"]({{< ref "editor/net/getting-started/licensing-and-subscription.md" >}}) page for information on licenses and review the ["Pricing Information"](https://purchase.groupdocs.com/pricing/editor/net) page for details on pricing.

## Technical Support

We do provide free and paid support for all of our users, including evaluation. For more information on GroupDocs.Editor technical support please check ["Technical Support"]({{< ref "technical-support" >}}) page.

---

## Product Overview

Path: /editor/nodejs-java/product-overview/

<img src="/editor/nodejs-java/images/home.png" width="110" height="110" alt="groupdocs-editor-java-home" align="left" style="margin: 0 30px 30px 0"/>

GroupDocs.Editor for Node.js is a powerful and lightweight library which allows you to edit most popular document formats using 3rd party front-end WYSIWYG HTML-editors without any additional software.

GroupDocs.Editor supports most of the popular document formats such as PDF, DOCX, XLSX, PPTX, XPS and others.

By using GroupDocs.Editor for Node.js you can edit files of various formats and no third-party applications required!

## How GroupDocs.Editor Works?

GroupDocs.Editor is a Node.js library, that is designed to allow users to load their documents of different format, open them for editing, edit, and save the edited version to some format, which may be the exactly same as input, or may differ. The most basic thing is that GroupDocs.Editor is GUI-less, it has no GUI, but only a public API, so it should be used within end-user environment, but not as the standalone application. Main and most common GroupDocs.Editor usage scenario implies that GroupDocs.Editor is used in a web-application and is located on the server-side. Server-based code invokes GroupDocs.Editor methods, passes input documents and different parameters, and obtains results, that are transmitted to the client-side into the WYSIWYG HTML-editor, like CKEditor or TinyMCE. When user has edited the document in the browser and is sending back the edited content to the server, server-based code again invokes GroupDocs.Editor, passes edited content and obtains edited document in desired format.
  
## Benefits of using GroupDocs.Editor

Using GroupDocs.Editor for Node.js in your project gives you the following benefits:

- Rich set of file editing features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of file editing features

GroupDocs.Editor for Node.js main features are the following:

- Translate document to HTML/CSS markup with resources, that is compatible with HTML WYSIWYG editors;
- Save edited HTML/CSS to source document format;
- Export edited document to PDF format;
- Plenty of additional options to customize editing process - edit password protected documents, extract document fonts, export document language information (useful for spell-checkers), specify document encoding or write-protection during saving etc.
- Document information extraction - page count, size, encrypted flag etc.

### Platform Independence

GroupDocs.Editor for Node.js covers most of the popular development environments and deployment platforms. Its API can be used to develop applications for a wide range of operating systems, such as Windows, Linux, and Mac OS, and various platforms. Read ["System Requirements"]({{< ref "editor/nodejs-java/getting-started/system-requirements" >}}) for more details.

You can use GroupDocs.Editor for Node.js to build any type of Node.js application.

### Independence from Other Applications

GroupDocs.Editor does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Editor a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Editor is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Editor is a single Node.js assembly that can be deployed with any Node.js application by simply copying it or installing via npm. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Editor for Node.js public API was designed to be simple and intuitive. The methods are doing what you wold expect from them and nothing more.

## Pricing and Policies

Please visit the ["Licensing and Subscription"]({{< ref "editor/nodejs-java/getting-started/licensing-and-subscription.md" >}}) page for information on licenses and review the ["Pricing Information"](https://purchase.groupdocs.com/pricing/editor/nodejs-java) page for details on pricing.

## Technical Support

We do provide free and paid support for all of our users, including evaluation. For more information on GroupDocs.Editor technical support please check ["Technical Support"]({{< ref "technical-support" >}}) page.

---

## Product Overview

Path: /merger/java/product-overview/


<img src="/merger/java/images/home.png" alt="groupdocs-merger-java-home" align="left" style="width:110px; margin: 0 30px 30px 0"/>

GroupDocs.Merger for Java is a cross-platform class library that empowers your applications with file merge features.

GroupDocs.Merger supports most of the popular document formats such as PDF, DOCX, XLSX, PPTX, EPUB and others.

By using GroupDocs.Merger for Java you can merge multiple files into one file, split single file into several files, reorder, rotate and remove document pages  and no third-party applications required!

------

## Benefits of using GroupDocs.Merger

Using GroupDocs.Merger for Java in your project gives you the following benefits:

- Rich set of document manipulation features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of document manipulation features

GroupDocs.Merger for Java features can be divided into two main areas.

#### Multiple document operations

["File merge"]({{< ref "merger/java/developer-guide/merge" >}}) is the one main features of GroupDocs.Merger that allows you to combine several files together into a single files.

You can merge whole documents or particular pages from your documents by using only GroupDocs.Merger for Java class-library.

#### Single document operations

With GroupDocs.Merger for Java you can split document into collection of documents, rotate or reorder document pages, remove pages from document, protect document with password or remove password-protection from document and many more.

### Platform Independence

GroupDocs.Merger for Java covers most of the popular development environments and deployment platforms. Its API can be used to develop applications for a wide range of operating systems, such as Windows, Linux, and Mac OS, and various platforms. Read ["System Requirements"]({{< ref "merger/java/getting-started/system-requirements" >}}) for more details.

You can use GroupDocs.Merger for Java to build any type of 32-bit or 64-bit Java application.

### Independence from Other Applications

GroupDocs.Merger does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Merger a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Merger is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Merger is a single Java package that can be deployed with any Java application by simply copying it or installing via NuGet. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Merger for Java public API was designed to be simple and intuitive. The methods are doing what you wold expect from them and nothing more.

## Pricing and Policies

Please visit the ["Licensing and Subscription"]({{< ref "merger/java/getting-started/licensing-and-subscription.md" >}}) page for information on licenses and review the ["Pricing Information"](https://purchase.groupdocs.com/pricing/merger/java) page for details on pricing.

## Technical Support

We do provide free and paid support for all of our users, including evaluation. For more information on GroupDocs.Merger technical support please check ["Technical Support"]({{< ref "technical-support" >}}) page.

---

## Product Overview

Path: /merger/net/product-overview/


<img src="/merger/net/images/home.png" alt="groupdocs-merger-net-home" align="left" style="width:110px; margin: 0 30px 30px 0"/>

GroupDocs.Merger for .NET is a cross-platform class library that empowers your applications with file merge features.

GroupDocs.Merger supports most of the popular document formats such as PDF, DOCX, XLSX, PPTX, EPUB and others.

By using GroupDocs.Merger for .NET you can merge multiple files into one file, split single file into several files, reorder, rotate and remove document pages  and no third-party applications required!

------

## Benefits of using GroupDocs.Merger

Using GroupDocs.Merger for .NET in your project gives you the following benefits:

- Rich set of document manipulation features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of document manipulation features

GroupDocs.Merger for .NET features can be divided into two main areas.

#### Multiple document operations

["File merge"]({{< ref "merger/net/developer-guide/merge" >}}) is the one main features of GroupDocs.Merger that allows you to combine several files together into a single files.

You can merge whole documents or particular pages from your documents by using only GroupDocs.Merger for .NET class-library.

#### Single document operations

With GroupDocs.Merger for .NET you can split document into collection of documents, rotate or reorder document pages, remove pages from document, protect document with password or remove password-protection from document and many more.

### Platform Independence

GroupDocs.Merger for .NET covers most of the popular development environments and deployment platforms. Its API can be used to develop applications for a wide range of operating systems, such as Windows, Linux, and Mac OS, and various platforms. Read ["System Requirements"]({{< ref "merger/net/getting-started/system-requirements" >}}) for more details.

You can use GroupDocs.Merger for .NET to build any type of 32-bit or 64-bit .NET application, including ASP.NET, ASP.NET Core, WCF, WinForms, etc.

### Independence from Other Applications

GroupDocs.Merger does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Merger a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Merger is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Merger is a single .NET assembly that can be deployed with any .NET application by simply copying it or installing via NuGet. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Merger for .NET public API was designed to be simple and intuitive. The methods are doing what you wold expect from them and nothing more.

## Pricing and Policies

Please visit the ["Licensing and Subscription"]({{< ref "merger/net/getting-started/licensing-and-subscription.md" >}}) page for information on licenses and review the ["Pricing Information"](https://purchase.groupdocs.com/pricing/merger/net) page for details on pricing.

## Technical Support

We do provide free and paid support for all of our users, including evaluation. For more information on GroupDocs.Merger technical support please check ["Technical Support"]({{< ref "technical-support" >}}) page.

---

## Product Overview

Path: /merger/nodejs-java/product-overview/


<img src="/merger/java/images/home.png" alt="groupdocs-merger-nodejs-java-home" align="left" style="width:110px; margin: 0 30px 30px 0"/>

GroupDocs.Merger for Node.js via Java is a cross-platform class library that empowers your applications with file merge features.

GroupDocs.Merger supports most of the popular document formats such as PDF, DOCX, XLSX, PPTX, EPUB and others.

By using GroupDocs.Merger for Node.js via Java you can merge multiple files into one file, split single file into several files, reorder, rotate and remove document pages  and no third-party applications required!

------

## Benefits of using GroupDocs.Merger

Using GroupDocs.Merger for Node.js via Java in your project gives you the following benefits:

- Rich set of document manipulation features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of document manipulation features

GroupDocs.Merger for Node.js via Java features can be divided into two main areas.

#### Multiple document operations

["File merge"]({{< ref "merger/nodejs-java/developer-guide/merge" >}}) is the one main features of GroupDocs.Merger that allows you to combine several files together into a single files.

You can merge whole documents or particular pages from your documents by using only GroupDocs.Merger for Node.js via Java class-library.

#### Single document operations

With GroupDocs.Merger for Node.js via Java you can split document into collection of documents, rotate or reorder document pages, remove pages from document, protect document with password or remove password-protection from document and many more.

### Platform Independence

GroupDocs.Merger for Node.js via Java covers most of the popular development environments and deployment platforms. Its API can be used to develop applications for a wide range of operating systems, such as Windows, Linux, and Mac OS, and various platforms. Read ["System Requirements"]({{< ref "merger/nodejs-java/getting-started/system-requirements" >}}) for more details.

You can use GroupDocs.Merger for Node.js via Java to build any type of 32-bit or 64-bit Node.js via Java application.

### Independence from Other Applications

GroupDocs.Merger does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Merger a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Merger is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Merger is a single Node.js via Java package that can be deployed with any Node.js via Java application by simply copying it or installing via NuGet. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Merger for Node.js via Java public API was designed to be simple and intuitive. The methods are doing what you wold expect from them and nothing more.

## Pricing and Policies

Please visit the ["Licensing and Subscription"]({{< ref "merger/nodejs-java/getting-started/licensing-and-subscription.md" >}}) page for information on licenses and review the ["Pricing Information"](https://purchase.groupdocs.com/pricing/merger/nodejs-java) page for details on pricing.

## Technical Support

We do provide free and paid support for all of our users, including evaluation. For more information on GroupDocs.Merger technical support please check ["Technical Support"]({{< ref "technical-support" >}}) page.

---

## Product Overview

Path: /merger/python-net/product-overview/


<img src="/merger/net/images/home.png" alt="groupdocs-merger-python-net-home" align="left" style="width:110px; margin: 0 30px 30px 0"/>

GroupDocs.Merger for Python via .NET is a cross-platform class library that empowers your applications with file merge features.

GroupDocs.Merger supports most of the popular document formats such as PDF, DOCX, XLSX, PPTX, EPUB and others.

By using GroupDocs.Merger for Python via .NET you can merge multiple files into one file, split single file into several files, reorder, rotate and remove document pages  and no third-party applications required!

------

## Benefits of using GroupDocs.Merger

Using GroupDocs.Merger for Python via .NET in your project gives you the following benefits:

- Rich set of document manipulation features;
- Platform independence;
- Independence from third-party applications;
- Performance and scalability;
- Simple public API.

### Rich set of document manipulation features

GroupDocs.Merger for Python via .NET features can be divided into two main areas.

#### Multiple document operations

["File merge"]({{< ref "merger/python-net/developer-guide/merge" >}}) is the one main features of GroupDocs.Merger that allows you to combine several files together into a single files.

You can merge whole documents or particular pages from your documents by using only GroupDocs.Merger for Python via .NET class-library.

#### Single document operations

With GroupDocs.Merger for Python via .NET you can split document into collection of documents, rotate or reorder document pages, remove pages from document, protect document with password or remove password-protection from document and many more.

### Platform Independence

GroupDocs.Merger for Python via .NET covers most of the popular development environments and deployment platforms. Its API can be used to develop applications for a wide range of operating systems, such as Windows, Linux, and Mac OS, and various platforms. Read ["System Requirements"]({{< ref "merger/python-net/getting-started/system-requirements" >}}) for more details.

You can use GroupDocs.Merger for Python via .NET to build any type of 32-bit or 64-bit Python via .NET application.

### Independence from Other Applications

GroupDocs.Merger does not require third-party applications, for example, Microsoft Office, to be installed on the machine in order to work. All GroupDocs components are completely independent. This makes GroupDocs.Merger a great alternative to automation in terms of security, stability, scalability/speed, price and features for working with documents and related tasks.

### Performance and Scalability

We do care about performance. GroupDocs.Merger is designed to be used to process thousands of files and utilize as minimum resources as possible. We do performance testing to make sure we do not have performance degradations from version to version.

GroupDocs.Merger is a single Python via .NET package that can be deployed with any Python via .NET application by simply copying it or installing via NuGet. You do not need to worry about any other services or modules.

### Simple Public API

GroupDocs.Merger for Python via .NET public API was designed to be simple and intuitive. The methods are doing what you wold expect from them and nothing more.

## Pricing and Policies

Please visit the ["Licensing and Subscription"]({{< ref "merger/python-net/getting-started/licensing-and-subscription.md" >}}) page for information on licenses and review the ["Pricing Information"](https://purchase.groupdocs.com/pricing/merger/python-net) page for details on pricing.

## Technical Support

We do provide free and paid support for all of our users, including evaluation. For more information on GroupDocs.Merger technical support please check ["Technical Support"]({{< ref "technical-support" >}}) page.

---

## GroupDocs.Total for Python via .NET Overview

Path: /total/python-net/product-overview/


[GroupDocs.Total for Python via .NET](https://products.groupdocs.com/total/python-net/) is a powerful document processing SDK for Python developers.  
It enables you to compare, convert, view, sign, and watermark various document formats, including PDF, DOCX, XLSX, PPTX, and more — all within your Python applications.

## Technology Stack

**GroupDocs.Total for Python via .NET** is built on a hybrid technology stack that combines the flexibility of Python with the performance and reliability of the modern .NET runtime. Installing .NET runtime is not required as it is already embedded within package.

- **Programming Language:** Python  
- **Supported Platforms:** Windows; we also partially support macOS and Linux
- **Distribution Format:** Python wheel (`.whl`) packages available via [PyPI](https://pypi.org/project/groupdocs-total-net/) and the [official GroupDocs releases](https://releases.groupdocs.com/total/python-net/)

## Key Features

**GroupDocs.Total for Python via .NET** combines the functionality of multiple GroupDocs APIs into a single, unified solution for professional document automation.

With this toolkit, you can:

- **Convert** between more than 200 file formats, including Word, PDF, Excel, PowerPoint, images, and text files.  
- **Compare** and highlight differences between documents to track changes efficiently.  
- **Sign and verify** documents using digital or image-based signatures.  
- **Redact** sensitive information to ensure data privacy and compliance.  
- **Add or detect watermarks** to protect intellectual property and maintain branding.  
- **Merge or split** multi-page documents for flexible document management.  
- **Extract text, metadata, and structured data** from office files, images, and archives.  
- **Automate workflows** — combine operations like conversion, signing, and watermarking into a single processing pipeline.  

Free technical assistance is available to all users, provided directly by the GroupDocs product teams.

## Included APIs

The suite includes the following APIs:

| Product | Description |
|:--|:--|
| [GroupDocs.Conversion&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/conversion/python-net/) | Convert documents between multiple formats using this library, offering flexible and high-performance conversion options. |
| [GroupDocs.Viewer&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/viewer/python-net/) | Add document viewing capabilities to your Python applications, supporting a wide range of document types for seamless display. |
| [GroupDocs.Comparison&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/comparison/python-net/) | Compare documents and visualize changes to easily identify differences between file versions. |
| [GroupDocs.Watermark&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/watermark/python-net/) | Protect your files by adding text or image watermarks, with various customization and detection options. |
| [GroupDocs.Metadata&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/metadata/python-net/) | Access, edit, and manage metadata properties across multiple document formats. |
| [GroupDocs.Merger&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/merger/python-net/) | Merge, split, or rearrange pages within documents easily. |
| [GroupDocs.Assembly&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/assembly/python-net/) | Generate documents dynamically from templates by merging data from various sources. |
| [GroupDocs.Redaction&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/redaction/python-net/) | Securely remove or mask confidential content to maintain compliance and data privacy. |
| [GroupDocs.Signature&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET](https://docs.groupdocs.com/signature/python-net/) | Sign and verify documents with text, image, barcode/QR, and digital signatures. |

## Getting Started

To start working with GroupDocs.Total for Python via .NET, refer to the following sections:  
- [System Requirements]({{< ref "/total/python-net/getting-started/system-requirements.md" >}})  
- [Installation]({{< ref "/total/python-net/getting-started/installation.md" >}})  
- [Quick Start Guide]({{< ref "/total/python-net/getting-started/quick-start-guide.md" >}})  

These resources will help you set up and integrate the SDK into your projects quickly.

## Developer Guide

For detailed examples and advanced usage instructions, see the **Developer Guides** within the documentation of each individual GroupDocs product.

## Technical Support

If you encounter any issues or have suggestions for improvement, please visit the [Technical Support]({{< ref "/total/python-net/technical-support" >}}) page.  
It provides multiple support channels to help you get assistance and resolve issues efficiently.

---

## Reduce image quality

Path: /viewer/java/optimization-pdf-reduce-image-quality/


If the output PDF file contains images, you can reduce its size using image compression.

To enable image compression, set the [setCompressImages()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/#setCompressImages-boolean-) method to `true`. The GroupDocs.Viewer compresses all images in the file.

The [setImageQuality()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/#setImageQuality-int-) method determines the compression ratio. It is a quality value in percent. 100% means original quality.

The following code snippet shows how to compress images in the file:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setPdfOptimizationOptions(new PdfOptimizationOptions());
    viewOptions.getPdfOptimizationOptions().setCompressImages(true);
    viewOptions.getPdfOptimizationOptions().setImageQuality(50);
     
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}

The following image demonstrates the result:

![Reduce image quality](/viewer/java/images/pdf-rendering/optimization/optimization-pdf-reduce-image-quality.png)

---

## Reduce image quality

Path: /viewer/net/optimization-pdf-reduce-image-quality/


If the output PDF file contains images, you can reduce its size using image compression.

To enable image compression, set the [CompressImages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/compressimages/) property to `true`. The GroupDocs.Viewer compresses all images in the file.

The [ImageQuality](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/imagequality/) property determines the compression ratio. It is a quality value in percent. 100% means original quality.

The following code snippet shows how to compress images in the file:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions
    {
        CompressImages = true,
        ImageQuality = 50
    };
     
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions With {
                .CompressImages = True,
                .ImageQuality = 50
                }

            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Reduce image quality](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-reduce-image-quality.png)

---

## Reduce image quality

Path: /viewer/python-net/optimization-pdf-reduce-image-quality/


If the output PDF file contains images, you can reduce its size using image compression.

To enable image compression, set the [compress_images](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property to `True`. The GroupDocs.Viewer compresses all images in the file.

The [image_quality](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property determines the compression ratio. It is a quality value in percent. 100% means original quality.

The following code snippet shows how to compress images in the file:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def reduce_image_quality():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("reduce_image_quality/reduced_quality.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.compress_images = True
        viewOptions.pdf_optimization_options.image_quality = 50

        viewer.view(viewOptions)

if __name__ == "__main__":
    reduce_image_quality()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimize-images/optimization-pdf-reduce-image-quality/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Reduce image quality](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-reduce-image-quality.png)

---

## Remove annotations

Path: /viewer/java/optimization-pdf-remove-annotations/

If the output PDF file contains annotations, you can remove them to reduce the file size.

To remove annotations, set the [setRemoveAnnotations](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/#setRemoveAnnotations-boolean-) to `true`.

The following code snippet shows how to remove annotations from the file:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setPdfOptimizationOptions(new PdfOptimizationOptions());
    viewOptions.getPdfOptimizationOptions().setRemoveAnnotations(true);

    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}

The following image demonstrates the result:

![Remove annotations](/viewer/java/images/pdf-rendering/optimization/optimization-pdf-remove-annotations.png)

---

## Remove annotations

Path: /viewer/net/optimization-pdf-remove-annotations/

If the output PDF file contains annotations, you can remove them to reduce the file size.

To remove annotations, set the [RemoveAnnotations](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/removeannotations/) property to `true`.

The following code snippet shows how to remove annotations from the file:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions();
    viewOptions.PdfOptimizationOptions.RemoveAnnotations = true;

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions()
            viewOptions.PdfOptimizationOptions.RemoveAnnotations = True
        
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Remove annotations](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-remove-annotations.png)

---

## Remove annotations

Path: /viewer/python-net/optimization-pdf-remove-annotations/

If the output PDF file contains annotations, you can remove them to reduce the file size.

To remove annotations, set the [remove_annotations](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property to `True`.

The following code snippet shows how to remove annotations from the file:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def remove_annotations():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("remove_annotations/without_annotations.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.remove_annotations = True

        viewer.view(viewOptions)

if __name__ == "__main__":
    remove_annotations()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimize-content/optimization-pdf-remove-annotations/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Remove annotations](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-remove-annotations.png)

---

## Render CAD drawings and models as HTML, PDF, and image files

Path: /viewer/java/render-cad-drawings-and-models/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your CAD drawings and 3D models in HTML, PDF, PNG, and JPEG formats. You do not need to use AutoCAD or other CAD software to load and view CAD files within your Java application (web or desktop).

Create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance to get started with the GroupDocs.Viewer API. Pass a CAD drawing you want to view to the class constructor. You can load the drawing from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the drawing to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/cad" >}} {{< icon "gdoc_person" >}} View CAD files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported CAD file formats

GroupDocs.Viewer supports the following CAD and 3D file formats:

* [AutoCAD Drawing](https://docs.fileformat.com/cad/dwg/) (.DWG)
* [AutoCAD Drawing Template](https://docs.fileformat.com/cad/dwt) (.DWT)
* [Design Web Format](https://docs.fileformat.com/cad/dwf/) (.DWF)
* [Drawing Exchange Format](https://docs.fileformat.com/cad/dxf) (.DXF)
* [AutoCAD Plotter Document](https://docs.fileformat.com/cad/plt) (.PLT)
* [MicroStation Design File (V7)](https://docs.fileformat.com/cad/dgn) (.DGN)
* [Industry Foundation Classes](https://docs.fileformat.com/cad/ifc) (.IFC)
* [Stereolithography File](https://docs.fileformat.com/cad/stl) (.STL)
* [Wavefront 3D Object File](https://docs.fileformat.com/3d/obj/) (.OBJ)
* [Common File Format](https://docs.fileformat.com/cad/cf2/) (.CF2)
* [IGES (Initial Graphics Exchange Specification) Drawing](https://docs.fileformat.com/cad/igs/) (.IGS)
* [HPGL (Hewlett-Packard Graphics Language) Plot File](https://docs.fileformat.com/cad/hpgl/) (.HPG)

## Render CAD drawings as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a CAD file to HTML. During the conversion, GroupDocs.Viewer creates an [SVG](https://docs.fileformat.com/page-description-language/svg/) image from the CAD drawing and embeds this image in an [HTML](https://docs.fileformat.com/web/html/) document.

The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Create an HTML file for the drawing.
    // Specify the HTML file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to HTML](/viewer/java/images/rendering-basics/render-cad-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Create an HTML file for the drawing.
    // Specify the HTML file name and location of external resources.
    // {0} is replaced with the resource name.
   HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("output.html", "output/resource_{0}", "output/resource_{0}");
   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-cad-documents/render-to-html-external-resources.png)

## Render CAD drawings as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a CAD file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Create a PDF file for the drawing.
    // Specify the PDF file name.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PDF](/viewer/java/images/rendering-basics/render-cad-documents/render-cad-to-pdf.png)

## Render CAD drawings as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a CAD file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Create a PNG image for the drawing.
    PngViewOptions viewOptions = new PngViewOptions("output.png");
    // Set width and height.
    viewOptions.setWidth(1500);
    viewOptions.setHeight(1000);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PNG](/viewer/java/images/rendering-basics/render-cad-documents/render-cad-to-png-image.png)

## Render CAD drawings as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a CAD file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Create a JPG image for the drawing.
    PngViewOptions viewOptions = new PngViewOptions("output.png");
    // Set width and height.
    viewOptions.setWidth(1500);
    viewOptions.setHeight(1000);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Get information about existing layouts and layers

Follow the steps below to obtain information about layouts and layers contained in a CAD drawing. You can use this information to specify which layers and layouts to display in the output file.

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [CadViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/cadviewinfo) type.
3. Use the [CadViewInfo.getLayouts](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/cadviewinfo/#getLayouts--) and [CadViewInfo.getLayers](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/cadviewinfo/#getLayers--) properties to obtain the lists of layouts and layers in the CAD file.

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.CadViewInfo;
import com.groupdocs.viewer.results.Layer;
import com.groupdocs.viewer.results.Layout;
// ...
CadViewInfo info;
try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    info = (CadViewInfo) viewer.getViewInfo(ViewInfoOptions.forHtmlView());
}
// Display information about the CAD file.
System.out.println("File type: " + info.getFileType());
System.out.println("The number of pages: " + info.getPages().size());
// Display the list of existing layouts.
for (Layout layout : info.getLayouts()) {
    System.out.println(layout);
}
// Display the list of existing layers.
for (Layer layer : info.getLayers()) {
    System.out.println(layer);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a CAD file](/viewer/java/images/rendering-basics/render-cad-documents/retrieve-cad-file-information.png)

## Render all or specific layouts

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders only the model-space layout (*Model*). If you also need to render all paper space layouts contained in your CAD file, use the [CadOptions.setRenderLayouts](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setRenderLayouts-boolean-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

Each layout is rendered on a separate page.

The following example renders all layouts when converting a CAD drawing to PDF:

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.dwg")) {
    // Convert the document to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Render the Model and all non-empty paper space layouts. 
    viewOptions.getCadOptions().setRenderLayouts(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

To render a specific layout, pass the layout name to the [CadOptions.setLayoutName](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setLayoutName-java.lang.String-) method of a target view.

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.dwg")) {
    // Convert the document to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Specify the name of the layout to render.
    // If the specified layout is not found,
    // an exception occurs.
    viewOptions.getCadOptions().setLayoutName("Layout1");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
1. The `CadOptions.RenderLayouts` and `CadOptions.LayoutName` properties apply only to the following file formats: DWG, DWT, DXF, and DWF.

2. If you use the [CadOptions.setLayoutName](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setLayoutName-java.lang.String-) method to render a specific layout, the `CadOptions.RenderLayouts` option is ignored.{{< /alert >}}

## Render specific layers

A CAD drawing can contain many layers. Each layer is used to draw a specific object type. For example, the drawing below contains layers for walls, furniture, plants, and so on. You can control the visibility of objects on the drawing by turning specific layers on or off.

![Layers in a CAD file](/viewer/java/images/rendering-basics/render-cad-documents/autocad-drawing-layers.png)

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders all available layers. You can specify which layers to display in the output file, as described below:

1. Use the [setCadOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setCadOptions-com.groupdocs.viewer.options.CadOptions-) method for a target view:

  * [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
  * [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
  * [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
  * [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

2. Assign the list of layers you want to render to the [CadOptions.setLayers](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setLayers-java.util.List-com.groupdocs.viewer.results.Layer--) method.

The following example renders layers with walls and furniture to PDF:

{{< tabs "example9">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Convert the document to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Specify a list of layers to display.
    List<Layer> layers = new ArrayList<>();
    layers.add(CacheableFactory.getInstance().newLayer("Base"));
    layers.add(CacheableFactory.getInstance().newLayer("Walls"));
    layers.add(CacheableFactory.getInstance().newLayer("Furniture"));
    viewOptions.getCadOptions().setLayers(layers);

    viewOptions.getCadOptions().setLayoutName("Layout1");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render specific CAD layers](/viewer/java/images/rendering-basics/render-cad-documents/render-specific-layers.png)

---

## Render CAD drawings and models as HTML, PDF, and image files

Path: /viewer/net/render-cad-drawings-and-models/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your CAD drawings and 3D models in HTML, PDF, PNG, and JPEG formats. You do not need to use AutoCAD or other CAD software to load and view CAD files within your .NET application (web or desktop).

Create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance to get started with the GroupDocs.Viewer API. Pass a CAD drawing you want to view to the class constructor. You can load the drawing from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the drawing to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/cad" >}} {{< icon "gdoc_person" >}} View CAD files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported CAD file formats

GroupDocs.Viewer supports the following CAD and 3D file formats:

* [AutoCAD Drawing](https://docs.fileformat.com/cad/dwg/) (.DWG)
* [AutoCAD Drawing Template](https://docs.fileformat.com/cad/dwt) (.DWT)
* [Design Web Format](https://docs.fileformat.com/cad/dwf/) (.DWF)
* [Drawing Exchange Format](https://docs.fileformat.com/cad/dxf) (.DXF)
* [AutoCAD Plotter Document](https://docs.fileformat.com/cad/plt) (.PLT)
* [MicroStation Design File (V7)](https://docs.fileformat.com/cad/dgn) (.DGN)
* [Industry Foundation Classes](https://docs.fileformat.com/cad/ifc) (.IFC)
* [Stereolithography File](https://docs.fileformat.com/cad/stl) (.STL)
* [Wavefront 3D Object File](https://docs.fileformat.com/3d/obj/) (.OBJ)
* [Common File Format](https://docs.fileformat.com/cad/cf2/) (.CF2)
* [IGES (Initial Graphics Exchange Specification) Drawing](https://docs.fileformat.com/cad/igs/) (.IGS)
* [HPGL (Hewlett-Packard Graphics Language) Plot File](https://docs.fileformat.com/cad/hpgl/) (.HPG)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render CAD drawings as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a CAD file to HTML. During the conversion, GroupDocs.Viewer creates an [SVG](https://docs.fileformat.com/page-description-language/svg/) image from the CAD drawing and embeds this image in an [HTML](https://docs.fileformat.com/web/html/) document.

The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("HousePlan.dwg"))
{
    // Create an HTML file for the drawing.
    // Specify the HTML file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("HousePlan.dwg")
            ' Create an HTML file for the drawing.
            ' Specify the HTML file name.
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to HTML](/viewer/net/images/rendering-basics/render-cad-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("HousePlan.dwg"))
{
    // Create an HTML file for the drawing.
    // Specify the HTML file name and location of external resources.
    // {0} is replaced with the resource name.
    HtmlViewOptions viewOptions = HtmlViewOptions.ForExternalResources("output.html", "output/resource_{0}", "output/resource_{0}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("HousePlan.dwg")
            ' Create an HTML file for the drawing.
            ' Specify the HTML file name and location of external resources.
            ' {0} is replaced with the resource name.
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForExternalResources("output.html", "output/resource_{0}", "output/resource_{0}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-cad-documents/render-to-html-external-resources.png)

## Render CAD drawings as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a CAD file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("HousePlan.dwg"))
{
    // Create a PDF file for the drawing.
    // Specify the PDF file name.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("HousePlan.dwg")
            ' Create a PDF file for the drawing.
            ' Specify the PDF file name.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PDF](/viewer/net/images/rendering-basics/render-cad-documents/render-cad-to-pdf.png)

## Render CAD drawings as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a CAD file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("HousePlan.dwg"))
{
    // Create a PNG image for the drawing.
    PngViewOptions viewOptions = new PngViewOptions("output.png");
    // Set width and height.
    viewOptions.Width = 1500;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("HousePlan.dwg")
            ' Create a PNG image for the drawing.
            Dim viewOptions As PngViewOptions = New PngViewOptions("output.png")
            ' Set width and height.
            viewOptions.Width = 1500
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PNG](/viewer/net/images/rendering-basics/render-cad-documents/render-cad-to-png-image.png)

## Render CAD drawings as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a CAD file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("HousePlan.dwg"))
{
    // Create a JPG image for the drawing.
    JpgViewOptions viewOptions = new JpgViewOptions("output.jpg");
    // Set width and height.
    viewOptions.Width = 1500;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("HousePlan.dwg")
            ' Create a JPG image for the drawing.
            Dim viewOptions As JpgViewOptions = New JpgViewOptions("output.jpg")
            ' Set width and height.
            viewOptions.Width = 1500
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Get information about existing layouts and layers

Follow the steps below to obtain information about layouts and layers contained in a CAD drawing. You can use this information to specify which layers and layouts to display in the output file.

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.GetViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getviewinfo) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [CadViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/cadviewinfo) type.
3. Use the [CadViewInfo.Layouts](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/cadviewinfo/properties/layouts) and [CadViewInfo.Layers](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/cadviewinfo/properties/layers) properties to obtain the lists of layouts and layers in the CAD file.

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("HousePlan.dwg"))
{
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForHtmlView();
    // Enable this option to see the list of all layouts contained in the CAD file.
    viewInfoOptions.CadOptions.RenderLayouts = true;
    CadViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions) as CadViewInfo;

    if (viewInfo != null)
    {
        // Display information about the CAD file.
        Console.WriteLine($"File type: {viewInfo.FileType}");
        Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}");

        // Display the list of existing layouts.
        Console.WriteLine("The drawing contains the following layout(s):");
        foreach (Layout layout in viewInfo.Layouts)
            Console.WriteLine(layout.Name);

        // Display the list of existing layers.
        Console.WriteLine("The drawing contains the following layer(s):");
        foreach (Layer layer in viewInfo.Layers)
            Console.WriteLine(layer);
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("HousePlan.dwg")
            Dim viewInfoOptions As ViewInfoOptions = ViewInfoOptions.ForHtmlView()
            ' Enable this option to see the list of all layouts contained in the CAD file.
            viewInfoOptions.CadOptions.RenderLayouts = True
            Dim viewInfo As CadViewInfo = TryCast(viewer.GetViewInfo(viewInfoOptions), CadViewInfo)
        
            If viewInfo IsNot Nothing Then
                ' Display information about the CAD file.
                Console.WriteLine($"File type: {viewInfo.FileType}")
                Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}")
        
                ' Display the list of existing layouts.
                Console.WriteLine("The drawing contains the following layout(s):")
                For Each layout As Layout In viewInfo.Layouts
                    Console.WriteLine(layout.Name)
                Next
        
                ' Display the list of existing layers.
                Console.WriteLine("The drawing contains the following layer(s):")
                For Each layer As Layer In viewInfo.Layers
                    Console.WriteLine(layer)
                Next
            End If
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a CAD file](/viewer/net/images/rendering-basics/render-cad-documents/retrieve-cad-file-information.png)

## Render all or specific layouts

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders only the model-space layout (*Model*). If you also need to render all paper space layouts contained in your CAD file, enable the [CadOptions.RenderLayouts](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/properties/renderlayouts) option for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

Each layout is rendered on a separate page.

The following example renders all layouts when converting a CAD drawing to PDF:

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.dwg"))
{
   // Convert the document to PDF.
   PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
   // Render the Model and all non-empty paper space layouts. 
   viewOptions.CadOptions.RenderLayouts = true;
   viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.dwg")
            ' Convert the document to PDF.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions("output.pdf")
            ' Render the Model and all non-empty paper space layouts. 
            viewOptions.CadOptions.RenderLayouts = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

To render a specific layout, assign the layout name to the [CadOptions.LayoutName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/layoutname) property of a target view.

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.dwg"))
{
   // Convert the document to PDF.
   PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
   // Specify the name of the layout to render.
   // If the specified layout is not found,
   // an exception occurs.
   viewOptions.CadOptions.LayoutName = "Layout1";
   viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.dwg")
            ' Convert the document to PDF.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions("output.pdf")
            ' Specify the name of the layout to render.
            ' If the specified layout is not found,
            ' an exception occurs.
            viewOptions.CadOptions.LayoutName = "Layout1"
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
1. The [CadOptions.RenderLayouts](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/properties/renderlayouts) and [CadOptions.LayoutName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/layoutname) properties apply only to the following file formats: DWG, DWT, DXF, and DWF.

2. If you use the [CadOptions.LayoutName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/layoutname) property to render a specific layout, the [CadOptions.RenderLayouts](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/properties/renderlayouts) option is ignored.{{< /alert >}}

## Render specific layers

A CAD drawing can contain many layers. Each layer is used to draw a specific object type. For example, the drawing below contains layers for walls, furniture, plants, and so on. You can control the visibility of objects on the drawing by turning specific layers on or off.

![Layers in a CAD file](/viewer/net/images/rendering-basics/render-cad-documents/autocad-drawing-layers.png)

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders all available layers. You can specify which layers to display in the output file, as described below:

1. Access the [CadOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/cadoptions) property for a target view:

  * [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
  * [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
  * [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
  * [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

2. Assign the list of layers you want to render to the [CadOptions.Layers](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/layers) property.

The following example renders layers with walls and furniture to PDF:

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
using System.Collections.Generic;
// ...

using (Viewer viewer = new Viewer("HousePlan.dwg"))
{
    // Convert the document to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Specify a list of layers to display.
    viewOptions.CadOptions.Layers = new List<Layer>
    {
        new Layer("Base"),
        new Layer("Walls"),
        new Layer("Furniture")
    };
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
Imports System.Collections.Generic
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("HousePlan.dwg")
            ' Convert the document to PDF.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions("output.pdf")
            ' Specify a list of layers to display.
            viewOptions.CadOptions.Layers = New List(Of Layer) From {
                New Layer("Base"),
                New Layer("Walls"),
                New Layer("Furniture")
                }
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render specific CAD layers](/viewer/net/images/rendering-basics/render-cad-documents/render-specific-layers.png)

---

## Render CAD drawings and models as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-cad-drawings-and-models/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your CAD drawings and 3D models in HTML, PDF, PNG, and JPEG formats. You do not need to use AutoCAD or other CAD software to load and view CAD files within your Node.js application (web or desktop).

Create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance to get started with the GroupDocs.Viewer API. Pass a CAD drawing you want to view to the class constructor. You can load the drawing from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the drawing to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/cad" >}} {{< icon "gdoc_person" >}} View CAD files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported CAD file formats

GroupDocs.Viewer supports the following CAD and 3D file formats:

* [AutoCAD Drawing](https://docs.fileformat.com/cad/dwg/) (.DWG)
* [AutoCAD Drawing Template](https://docs.fileformat.com/cad/dwt) (.DWT)
* [Design Web Format](https://docs.fileformat.com/cad/dwf/) (.DWF)
* [Drawing Exchange Format](https://docs.fileformat.com/cad/dxf) (.DXF)
* [AutoCAD Plotter Document](https://docs.fileformat.com/cad/plt) (.PLT)
* [MicroStation Design File (V7)](https://docs.fileformat.com/cad/dgn) (.DGN)
* [Industry Foundation Classes](https://docs.fileformat.com/cad/ifc) (.IFC)
* [Stereolithography File](https://docs.fileformat.com/cad/stl) (.STL)
* [Wavefront 3D Object File](https://docs.fileformat.com/3d/obj/) (.OBJ)
* [Common File Format](https://docs.fileformat.com/cad/cf2/) (.CF2)
* [IGES (Initial Graphics Exchange Specification) Drawing](https://docs.fileformat.com/cad/igs/) (.IGS)
* [HPGL (Hewlett-Packard Graphics Language) Plot File](https://docs.fileformat.com/cad/hpgl/) (.HPG)

## Render CAD drawings as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a CAD file to HTML. During the conversion, GroupDocs.Viewer creates an [SVG](https://docs.fileformat.com/page-description-language/svg/) image from the CAD drawing and embeds this image in an [HTML](https://docs.fileformat.com/web/html/) document.

The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "render-cad-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
// Create an HTML file for the drawing.
// Specify the HTML file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-cad-to-html-embedded/dwg-to-html.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to HTML](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-cad-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
// Create an HTML file for the drawing.
// Specify the HTML file name and location of external resources.
// {0} is replaced with the resource name.
const viewOptions = HtmlViewOptions.forExternalResources("render-cad-to-html-external/dwg-to-html.html", "render-cad-to-html-external/dwg-to-html/resource_{0}", "render-cad-to-html-external/dwg-to-html/resource_{0}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/render-to-html-external-resources.png)

## Render CAD drawings as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a CAD file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-cad-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
// Create a PDF file for the drawing.
// Specify the PDF file name.
const viewOptions = PdfViewOptions("render-cad-to-pdf/dwg-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PDF](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/render-cad-to-pdf.png)

## Render CAD drawings as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a CAD file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-cad-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
// Create a PNG image for the drawing.
const viewOptions = PngViewOptions("render-cad-to-png/dwg-to-png.png")
// Set width and height.
viewOptions.setWidth(1500)
viewOptions.setHeight(1000)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PNG](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/render-cad-to-png-image.png)

## Render CAD drawings as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a CAD file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-cad-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
// Create a JPG image for the drawing.
const viewOptions = JpgViewOptions("render-cad-to-jpeg/dwg-to-jpg.jpg")
// Set width and height.
viewOptions.setWidth(1500)
viewOptions.setHeight(1000)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get information about existing layouts and layers

Follow the steps below to obtain information about layouts and layers contained in a CAD drawing. You can use this information to specify which layers and layouts to display in the output file.

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [CadViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/cadviewinfo) type.
3. Use the [CadViewInfo.getLayouts](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/cadviewinfo/#getLayouts--) and [CadViewInfo.getLayers](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/cadviewinfo/#getLayers--) properties to obtain the lists of layouts and layers in the CAD file.

{{< tabs "get-cad-layouts-and-layers-info">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
const viewOptions = ViewInfoOptions.forHtmlView()
const info = viewer.getViewInfo(viewOptions)

// Display information about the CAD file.
console.log("File type: " + info.getFileType())
console.log("The number of pages: " + info.getPages().size())
// Display the list of existing layouts.
const layouts = info.getLayouts();
for (let i = 0; i < layouts.size(); i++) {
    console.log(layouts.get(i).toString());
}

const layers = info.getLayers();
for (let i = 0; i < layers.size(); i++) {
    console.log(layers.get(i).toString());
}
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a CAD file](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/retrieve-cad-file-information.png)

## Render all or specific layouts

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders only the model-space layout (*Model*). If you also need to render all paper space layouts contained in your CAD file, use the [CadOptions.setRenderLayouts](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setRenderLayouts-boolean-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

Each layout is rendered on a separate page.

The following example renders all layouts when converting a CAD drawing to PDF:

{{< tabs "render-cad-all-layouts" docs-to-code-examples-skip >}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.dwg")
// Convert the document to PDF.
const viewOptions = PdfViewOptions("render-cad-all-layouts/dwg-to-pdf.pdf")
// Render the Model and all non-empty paper space layouts. 
viewOptions.getCadOptions().setRenderLayouts(true);

// Render first page
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

To render a specific layout, pass the layout name to the [CadOptions.setLayoutName](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setLayoutName-java.lang.String-) method of a target view.

{{< tabs "render-cad-specific-layout">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.dwg")
// Convert the document to PDF.
const viewOptions = PdfViewOptions("render-cad-specific-layout/dwg-to-pdf.pdf")
// Specify the name of the layout to render.
// If the specified layout is not found,
// an exception occurs.
viewOptions.getCadOptions().setLayoutName("Layout1");
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
1. The `CadOptions.RenderLayouts` and `CadOptions.LayoutName` properties apply only to the following file formats: DWG, DWT, DXF, and DWF.

2. If you use the [CadOptions.setLayoutName](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setLayoutName-java.lang.String-) method to render a specific layout, the `CadOptions.RenderLayouts` option is ignored.{{< /alert >}}

## Render specific layers

A CAD drawing can contain many layers. Each layer is used to draw a specific object type. For example, the drawing below contains layers for walls, furniture, plants, and so on. You can control the visibility of objects on the drawing by turning specific layers on or off.

![Layers in a CAD file](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/autocad-drawing-layers.png)

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders all available layers. You can specify which layers to display in the output file, as described below:

1. Use the [setCadOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/baseviewoptions/#setCadOptions-com.groupdocs.viewer.options.CadOptions-) method for a target view:

  * [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
  * [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
  * [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
  * [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

2. Assign the list of layers you want to render to the [CadOptions.setLayers](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setLayers-java.util.List-com.groupdocs.viewer.results.Layer--) method.

The following example renders layers with walls and furniture to PDF:

{{< tabs "render-cad-specific-layers" docs-to-code-examples-skip >}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions, CacheableFactory } from '@groupdocs/groupdocs.viewer';
import java from 'java';

const ArrayList = java.import("java.util.ArrayList")

const viewer = new Viewer("HousePlan.dwg")
// Convert the document to PDF.
const viewOptions = PdfViewOptions("render-cad-specific-layers/dwg-to-pdf.pdf")
// Specify a list of layers to display.
const layers = new ArrayList()
layers.add(CacheableFactory.getInstance().newLayer("QUADRANT"))
viewOptions.getCadOptions().setLayers(layers)

viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/render-cad-documents/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render specific CAD layers](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/render-specific-layers.png)

---

## Render CAD drawings and models as HTML, PDF, and image files

Path: /viewer/python-net/render-cad-drawings-and-models/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to render your CAD drawings and 3D models in HTML, PDF, PNG, and JPEG formats. You do not need to use AutoCAD or other CAD software to load and view CAD files within your Python application (web or desktop).

Create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance to get started with the GroupDocs.Viewer API. Pass a CAD drawing you want to view to the class constructor. You can load the drawing from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the drawing to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/cad" >}} {{< icon "gdoc_person" >}} View CAD files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported CAD file formats

GroupDocs.Viewer supports the following CAD and 3D file formats:

* [AutoCAD Drawing](https://docs.fileformat.com/cad/dwg/) (.DWG)
* [AutoCAD Drawing Template](https://docs.fileformat.com/cad/dwt) (.DWT)
* [Design Web Format](https://docs.fileformat.com/cad/dwf/) (.DWF)
* [Drawing Exchange Format](https://docs.fileformat.com/cad/dxf) (.DXF)
* [AutoCAD Plotter Document](https://docs.fileformat.com/cad/plt) (.PLT)
* [MicroStation Design File (V7)](https://docs.fileformat.com/cad/dgn) (.DGN)
* [Industry Foundation Classes](https://docs.fileformat.com/cad/ifc) (.IFC)
* [Stereolithography File](https://docs.fileformat.com/cad/stl) (.STL)
* [Wavefront 3D Object File](https://docs.fileformat.com/3d/obj/) (.OBJ)
* [Common File Format](https://docs.fileformat.com/cad/cf2/) (.CF2)
* [IGES (Initial Graphics Exchange Specification) Drawing](https://docs.fileformat.com/cad/igs/) (.IGS)
* [HPGL (Hewlett-Packard Graphics Language) Plot File](https://docs.fileformat.com/cad/hpgl/) (.HPG)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render CAD drawings as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a CAD file to HTML. During the conversion, GroupDocs.Viewer creates an [SVG](https://docs.fileformat.com/page-description-language/svg/) image from the CAD drawing and embeds this image in an [HTML](https://docs.fileformat.com/web/html/) document.

The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_cad_to_html():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Create an HTML file for the drawing.
        # Specify the HTML file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_cad_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_cad_to_html()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to HTML](/viewer/net/images/rendering-basics/render-cad-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_cad_to_html_external():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Create an HTML file for the drawing.
        # Specify the HTML file name and location of external resources.
        # {0} is replaced with the resource name.
        viewOptions = HtmlViewOptions.for_external_resources("render_cad_to_html_external/pdf_page_{0}.html", "render_cad_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_cad_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_cad_to_html_external()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-cad-documents/render-to-html-external-resources.png)

## Render CAD drawings as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a CAD file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_cad_to_pdf():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Create a PDF file for the drawing.
        # Specify the PDF file name.
        viewOptions = PdfViewOptions("render_cad_to_pdf/cad_drawing.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_cad_to_pdf()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PDF](/viewer/net/images/rendering-basics/render-cad-documents/render-cad-to-pdf.png)

## Render CAD drawings as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a CAD file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_cad_to_png():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Create a PNG image for the drawing.
        viewOptions = PngViewOptions("render_cad_to_png/cad_page_0.png")
        # Set width and height.
        viewOptions.width = 1500
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_cad_to_png()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a CAD file to PNG](/viewer/net/images/rendering-basics/render-cad-documents/render-cad-to-png-image.png)

## Render CAD drawings as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a CAD file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_cad_to_jpg():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Create a JPG image for the drawing.
        viewOptions = JpgViewOptions("render_cad_to_jpg/cad_to_jpg.jpg")
        # Set width and height.
        viewOptions.width = 1500
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_cad_to_jpg()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get information about existing layouts and layers

Follow the steps below to obtain information about layouts and layers contained in a CAD drawing. You can use this information to specify which layers and layouts to display in the output file.

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.get_view_info](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions

def get_cad_info():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        viewInfoOptions = ViewInfoOptions.for_html_view()
        cad_info = viewer.get_view_info(viewInfoOptions)
        # Display information about the CAD file.
        print("File type:", cad_info.file_type)
        print("Pages count:", len(cad_info.pages))

        print("\nView info retrieved successfully.")

if __name__ == "__main__":
    get_cad_info()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a CAD file](/viewer/net/images/rendering-basics/render-cad-documents/retrieve-cad-file-information.png)

## Render all or specific layouts

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders only the model-space layout (*Model*). If you also need to render all paper space layouts contained in your CAD file, enable the [CadOptions.render_layouts](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) option for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

Each layout is rendered on a separate page.

The following example renders all layouts when converting a CAD drawing to PDF:

{{< tabs "example7">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_all_layouts():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Convert the document to PDF.
        options = PdfViewOptions("render_all_layouts/all_layouts.pdf")
        # Render the Model and all non-empty paper space layouts. 
        options.cad_options.render_layouts = True
        viewer.view(options)

if __name__ == "__main__":
    render_all_layouts()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

To render a specific layout, assign the layout name to the [CadOptions.layout_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) property of a target view.

{{< tabs "example8">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_specific_layout():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Convert the document to PDF.
        options = PdfViewOptions("render_specific_layout/specific_layout.pdf")
        # Specify the name of the layout to render.
        # If the specified layout is not found,
        # an exception occurs.
        options.cad_options.layout_name = "layout1"
        viewer.view(options)

if __name__ == "__main__":
    render_specific_layout()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
1. The [CadOptions.RenderLayouts](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) and [CadOptions.layout_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) properties apply only to the following file formats: DWG, DWT, DXF, and DWF.

2. If you use the [CadOptions.layout_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) property to render a specific layout, the [CadOptions.render_layouts](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) option is ignored.{{< /alert >}}


## Render specific layers

A CAD drawing can contain many layers. Each layer is used to draw a specific object type. For example, the drawing below contains layers for walls, furniture, plants, and so on. You can control the visibility of objects on the drawing by turning specific layers on or off.

![Layers in a CAD file](/viewer/net/images/rendering-basics/render-cad-documents/autocad-drawing-layers.png)

When you convert a CAD drawing to HTML, PDF, or image format, GroupDocs.Viewer renders all available layers. You can specify which layers to display in the output file, as described below:

1. Access the [CadOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property for a target view:

  * [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
  * [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
  * [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
  * [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

2. Assign the list of layers you want to render to the [cad_options.layers](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/#properties) property.

The following example renders layers with walls and furniture to PDF:

{{< tabs "example9">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions
from groupdocs.viewer.results import Layer

def render_specific_layers():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Convert the document to PDF.
        options = PdfViewOptions("render_specific_layers/specific_layers.pdf")
        # Specify a list of layers to display.
        options.cad_options.layers = [
            Layer("QUADRANT")
        ]
        viewer.view(options)

if __name__ == "__main__":
    render_specific_layers()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render specific CAD layers](/viewer/net/images/rendering-basics/render-cad-documents/render-specific-layers.png)

---

## Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files

Path: /viewer/java/render-excel-and-apple-numbers-spreadsheets/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your spreadsheet files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Excel or other spreadsheet programs to load and view Excel documents within your Java application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a spreadsheet file you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/excel" >}} {{< icon "gdoc_person" >}} View Excel files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported spreadsheet file formats

GroupDocs.Viewer supports the following spreadsheet file formats:

* [Microsoft Excel Workbook](https://docs.fileformat.com/spreadsheet/xlsx) (.XLSX)
* [Microsoft Excel 97-2003 Workbook](https://docs.fileformat.com/spreadsheet/xls) (.XLS)
* [Microsoft Excel Binary Workbook](https://docs.fileformat.com/spreadsheet/xlsb) (.XLSB)
* [Microsoft Excel Macro-Enabled Workbook](https://docs.fileformat.com/spreadsheet/xlsm) (.XLSM)
* [Microsoft Excel Template](https://docs.fileformat.com/spreadsheet/xltx) (.XLTX)
* [Microsoft Excel 97-2003 Template](https://docs.fileformat.com/spreadsheet/xlt) (.XLT)
* [Microsoft Excel Macro-Enabled Template](https://docs.fileformat.com/spreadsheet/xltm) (.XLTM)
* [Microsoft Excel Add-In](https://docs.fileformat.com/spreadsheet/xlam/) (.XLAM)
* [XML Spreadsheet 2003](https://en.wikipedia.org/wiki/SpreadsheetML) (.XML)
* [OpenDocument Spreadsheet](https://docs.fileformat.com/spreadsheet/ods) (.ODS)
* [OpenDocument Spreadsheet Template](https://docs.fileformat.com/spreadsheet/ots/) (.OTS)
* [OpenDocument Flat XML Spreadsheet](https://docs.fileformat.com/spreadsheet/fods/) (.FODS)
* [Comma Separated Values File](https://docs.fileformat.com/spreadsheet/csv) (.CSV)
* [Tab Separated Values File](https://docs.fileformat.com/spreadsheet/tsv) (.TSV)
* [StarOffice Calc Spreadsheet](https://docs.fileformat.com/spreadsheet/sxc/) (.SXC)
* [Apple Numbers Spreadsheet](https://docs.fileformat.com/spreadsheet/numbers) (.NUMBERS)

## Render spreadsheets as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a spreadsheet file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

#### Convert an Excel workbook to HTML

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to HTML.
    // {0} is replaced with the current page number in the file names.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to HTML](/viewer/java/images/rendering-basics/render-spreadsheets/convert-excel-to-html.png)

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("Products.numbers")) {
    // Convert the spreadsheet to HTML.
    // {0} is replaced with the current page number in the file names.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to HTML](/viewer/java/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

#### Convert an Excel workbook to HTML

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to HTML.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("Products.numbers")) {
    // Convert the spreadsheet to HTML.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-spreadsheets/render-excel-to-html-external-resources.png)


### Convert all Excel worksheets to one HTML file

To convert all worksheets to one HTML file, use the [HtmlViewOptions.setRenderToSinglePage](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setRenderToSinglePage-boolean-) method. This feature is supported in both cases - when converting to HTML with embedded and external resources.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("Personal_net_worth_calculator.xlsx")) {
    // Convert all Excel worksheets to one HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page.html");
    // Enable converting all worksheets to one file.
    viewOptions.setRenderToSinglePage(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Convert all Excel worksheets to one HTML file](/viewer/java/images/rendering-basics/render-spreadsheets/convert-all-excel-worksheets-to-html.png)


## Render spreadsheets as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a spreadsheet file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

### Convert an Excel workbook to PDF

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to PDF](/viewer/java/images/rendering-basics/render-spreadsheets/render-excel-to-pdf.png)

### Convert an Apple Numbers spreadsheet to PDF

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("Products.numbers")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PDF](/viewer/java/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-pdf.png)

## Render spreadsheets as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a spreadsheet file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

### Convert an Excel workbook to PNG

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PNG.
    // {0} is replaced with the current page number in the file names.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(800);
    viewOptions.setHeight(900);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an Excel file to PNG](/viewer/java/images/rendering-basics/render-spreadsheets/render-excel-to-png.png)

### Convert an Apple Numbers spreadsheet to PNG

{{< tabs "example9">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("Products.numbers")) {
    // Convert the spreadsheet to PNG.
    // {0} is replaced with the current page number in the file names.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(800);
    viewOptions.setHeight(900);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PNG](/viewer/java/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-png.png)

## Render spreadsheets as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a spreadsheet file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

### Convert an Excel workbook to JPEG

{{< tabs "example10">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to JPEG.
    // {0} is replaced with the current page number in the file names.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(800);
    viewOptions.setHeight(900);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Convert an Apple Numbers spreadsheet to JPEG

{{< tabs "example11">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("Products.numbers")) {
    // Convert the spreadsheet to JPEG.
    // {0} is replaced with the current page number in the file names.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(800);
    viewOptions.setHeight(900);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Detect a CSV/TSV separator

If you load a CSV/TSV file to convert it to another format, use the [SpreadsheetOptions.setDetectSeparator](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setDetectSeparator-boolean-) method for a target view to automatically detect a delimiter used to separate values in the source file.

GroupDocs.Viewer can detect the following separators:

* A comma (the default separator)
* A semicolon

{{< tabs "example12">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.csv")) {
    // Convert the spreadsheet to HTML.
    // {0} is replaced with the current page number in the file names.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    // Detect a CSV/TSV separator.
    viewOptions.getSpreadsheetOptions().setDetectSeparator(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Get worksheet names

GroupDocs.Viewer allows you to obtain information about the source spreadsheet file. For example, you can retrieve worksheet names, as described below:

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method and pass the `ViewInfoOptions` instance to this method as a parameter.
3. Use the [getPages](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/#getPages--) method of the returned [ViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo) object to access to the list of worksheets and retrieve the worksheet names.

{{< tabs "example13">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.SpreadsheetOptions;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.Page;
import com.groupdocs.viewer.results.ViewInfo;
// ...

try (Viewer viewer = new Viewer("sample.xlsx")) {
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
    // Call this method to create a single page for each worksheet.
    viewInfoOptions.setSpreadsheetOptions(SpreadsheetOptions.forOnePagePerSheet());

    ViewInfo viewInfo = viewer.getViewInfo(viewInfoOptions);
    // Print the worksheet names in the console window.
    System.out.println("The document contains the following worksheets:");
    for (Page page : viewInfo.getPages()) {
        System.out.println(" - Worksheet " + page.getNumber() + ": '" + page.getName() + "'");
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Retrieve worksheet names](/viewer/java/images/rendering-basics/render-spreadsheets/retrieve-worksheet-names.png)

## See also

* [Split a worksheet into pages](/viewer/java/split-worksheet-into-pages/)
* [Specify spreadsheet rendering options](/viewer/java/specify-rendering-options/)

---

## Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files

Path: /viewer/net/render-excel-and-apple-numbers-spreadsheets/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your spreadsheet files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Excel or other spreadsheet programs to load and view Excel documents within your .NET application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a spreadsheet file you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/excel" >}} {{< icon "gdoc_person" >}} View Excel files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported spreadsheet file formats

GroupDocs.Viewer supports the following spreadsheet file formats:

* [Microsoft Excel Workbook](https://docs.fileformat.com/spreadsheet/xlsx) (.XLSX)
* [Microsoft Excel 97-2003 Workbook](https://docs.fileformat.com/spreadsheet/xls) (.XLS)
* [Microsoft Excel Binary Workbook](https://docs.fileformat.com/spreadsheet/xlsb) (.XLSB)
* [Microsoft Excel Macro-Enabled Workbook](https://docs.fileformat.com/spreadsheet/xlsm) (.XLSM)
* [Microsoft Excel Template](https://docs.fileformat.com/spreadsheet/xltx) (.XLTX)
* [Microsoft Excel 97-2003 Template](https://docs.fileformat.com/spreadsheet/xlt) (.XLT)
* [Microsoft Excel Macro-Enabled Template](https://docs.fileformat.com/spreadsheet/xltm) (.XLTM)
* [Microsoft Excel Add-In](https://docs.fileformat.com/spreadsheet/xlam/) (.XLAM)
* [XML Spreadsheet 2003](https://en.wikipedia.org/wiki/SpreadsheetML) (.XML)
* [OpenDocument Spreadsheet](https://docs.fileformat.com/spreadsheet/ods) (.ODS)
* [OpenDocument Spreadsheet Template](https://docs.fileformat.com/spreadsheet/ots/) (.OTS)
* [OpenDocument Flat XML Spreadsheet](https://docs.fileformat.com/spreadsheet/fods/) (.FODS)
* [Comma Separated Values File](https://docs.fileformat.com/spreadsheet/csv) (.CSV)
* [Tab Separated Values File](https://docs.fileformat.com/spreadsheet/tsv) (.TSV)
* [StarOffice Calc Spreadsheet](https://docs.fileformat.com/spreadsheet/sxc/) (.SXC)
* [Apple Numbers Spreadsheet](https://docs.fileformat.com/spreadsheet/numbers) (.NUMBERS)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render spreadsheets as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a spreadsheet file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

<a name="unique-ID"></a>
When rendering spreadsheets to HTML format, regardless of the exact rendering mode (one HTML file per one worksheet, or single HTML for all worksheets, embedded or external resources), there always is an HTML `<table>`, that contains all the data from a worksheet, and a set of different CSS properties, which are applied to different parts of this table (rows, cells, or their ranges) and decorate them. There always is a CSS stylesheet (embedded or external) with a set of rulesets and at-rules, which are binded with a HTML table and its content by different selectors.

In some cases it is required to embed the GroupDocs.Viewer into the other web-application. In this scenario may occur an issue, when the styles from the GroupDocs.Viewer interfere with the styles of the parent web application. In particular, when GroupDocs.Viewer converts the spreadsheet to the HTML, it creates several rulesets with `<TR>`, `<TD>`, `<COL>`, `<BR>` type-selector, and these rulesets may corrupt the behavior of the parent web-page.

It was a problem in the GroupDocs.Viewer before the version 24.3. Starting from [version 24.3](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-3-release-notes/), when rendering spreadsheet documents, the GroupDocs.Viewer adds the unique ID value to every HTML element and CSS selector in order to eliminate any interference with styles of the parent application. So now all the type-selectors are replaced to be the combined id-type descendant selectors like `#gdt-id-1 td`, `#gdt-id-2 tr`, and so on. This excludes any style conflicts once and for all.


### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

#### Convert an Excel workbook to HTML

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to HTML.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to HTML.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to HTML](/viewer/net/images/rendering-basics/render-spreadsheets/convert-excel-to-html.png)

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Products.numbers"))
{
    // Convert the spreadsheet to HTML.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Products.numbers")
            ' Convert the spreadsheet to HTML.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to HTML](/viewer/net/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

#### Convert an Excel workbook to HTML

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to HTML.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to HTML.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Products.numbers"))
{
    // Convert the spreadsheet to HTML.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Products.numbers")
            ' Convert the spreadsheet to HTML.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-spreadsheets/render-excel-to-html-external-resources.png)


### Convert all Excel worksheets to one HTML file

To convert all worksheets to one HTML file, set the [HtmlViewOptions.RenderToSinglePage](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/rendertosinglepage/) property to `true`. This feature is supported in both cases - when converting to HTML with embedded and external resources.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Personal_net_worth_calculator.xlsx"))
{
    // Convert all Excel worksheets to one HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page.html");
    // Enable converting all worksheets to one file.
    viewOptions.RenderToSinglePage = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Personal_net_worth_calculator.xlsx")
            ' Convert all Excel worksheets to one HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page.html")
            ' Enable converting all worksheets to one file.
            viewOptions.RenderToSinglePage = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Convert all Excel worksheets to one HTML file](/viewer/net/images/rendering-basics/render-spreadsheets/convert-all-excel-worksheets-to-html.png)


## Render spreadsheets as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a spreadsheet file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

### Convert an Excel workbook to PDF

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to PDF](/viewer/net/images/rendering-basics/render-spreadsheets/render-excel-to-pdf.png)

### Convert an Apple Numbers spreadsheet to PDF

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Products.numbers"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Products.numbers")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PDF](/viewer/net/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-pdf.png)

## Render spreadsheets as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a spreadsheet file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

### Convert an Excel workbook to PNG

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PNG.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PNG.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an Excel file to PNG](/viewer/net/images/rendering-basics/render-spreadsheets/render-excel-to-png.png)

### Convert an Apple Numbers spreadsheet to PNG

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Products.numbers"))
{
    // Convert the spreadsheet to PNG.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Products.numbers")
            ' Convert the spreadsheet to PNG.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PNG](/viewer/net/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-png.png)

## Render spreadsheets as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a spreadsheet file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

### Convert an Excel workbook to JPEG

{{< tabs "example10">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to JPEG.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to JPEG.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Convert an Apple Numbers spreadsheet to JPEG

{{< tabs "example11">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Products.numbers"))
{
    // Convert the spreadsheet to JPEG.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Products.numbers")
            ' Convert the spreadsheet to JPEG.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Detect a CSV/TSV separator

If you load a CSV/TSV file to convert it to another format, enable the [SpreadsheetOptions.DetectSeparator](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/properties/detectseparator) property for a target view to automatically detect a delimiter used to separate values in the source file.

GroupDocs.Viewer can detect the following separators:

* A comma (the default separator)
* A semicolon

{{< tabs "example12">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.csv"))
{
    // Convert the spreadsheet to HTML.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Detect a CSV/TSV separator.
    viewOptions.SpreadsheetOptions.DetectSeparator = true;
    viewer.View(viewOptions);
}          
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.csv")
            ' Convert the spreadsheet to HTML.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Detect a CSV/TSV separator.
            viewOptions.SpreadsheetOptions.DetectSeparator = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Get worksheet names

GroupDocs.Viewer allows you to obtain information about the source spreadsheet file. For example, you can retrieve worksheet names, as described below:

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.GetViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getviewinfo) method and pass the `ViewInfoOptions` instance to this method as a parameter.
3. Use the [Pages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/properties/pages) property of the returned [ViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo) object to iterate through the list of worksheets and retrieve the worksheet names.

{{< tabs "example13">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (var viewer = new Viewer("sample.xlsx"))
{
    var viewInfoOptions = ViewInfoOptions.ForHtmlView();
    // Call this method to create a single page for each worksheet.
    viewInfoOptions.SpreadsheetOptions = SpreadsheetOptions.ForOnePagePerSheet();

    var viewInfo = viewer.GetViewInfo(viewInfoOptions);

    // Print the worksheet names in the console window.
    Console.WriteLine("The document contains the following worksheets:");
    foreach (Page page in viewInfo.Pages)
    {
        Console.WriteLine($" - Worksheet {page.Number}: '{page.Name}'");
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.xlsx")
            Dim viewInfoOptions = ViewInfoOptions.ForHtmlView()
            ' Call this method to create a single page for each worksheet.
            viewInfoOptions.SpreadsheetOptions = SpreadsheetOptions.ForOnePagePerSheet()
        
            Dim viewInfo = viewer.GetViewInfo(viewInfoOptions)
        
            ' Print the worksheet names in the console window.
            Console.WriteLine("The document contains the following worksheets:")
            For Each page As Page In viewInfo.Pages
                Console.WriteLine($" - Worksheet {page.Number}: '{page.Name}'")
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Retrieve worksheet names](/viewer/net/images/rendering-basics/render-spreadsheets/retrieve-worksheet-names.png)

## See also

* [Split a worksheet into pages](/viewer/net/split-worksheet-into-pages/)
* [Specify spreadsheet rendering options](/viewer/net/specify-rendering-options/)

---

## Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-excel-and-apple-numbers-spreadsheets/

[GroupDocs.Viewer for Node.js](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your spreadsheet files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Excel or other spreadsheet programs to load and view Excel documents within your JavaScript application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](#) class instance. Pass a spreadsheet file you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](#) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/excel" >}} {{< icon "gdoc_person" >}} View Excel files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported spreadsheet file formats

GroupDocs.Viewer supports the following spreadsheet file formats:

* [Microsoft Excel Workbook](https://docs.fileformat.com/spreadsheet/xlsx) (.XLSX)
* [Microsoft Excel 97-2003 Workbook](https://docs.fileformat.com/spreadsheet/xls) (.XLS)
* [Microsoft Excel Binary Workbook](https://docs.fileformat.com/spreadsheet/xlsb) (.XLSB)
* [Microsoft Excel Macro-Enabled Workbook](https://docs.fileformat.com/spreadsheet/xlsm) (.XLSM)
* [Microsoft Excel Template](https://docs.fileformat.com/spreadsheet/xltx) (.XLTX)
* [Microsoft Excel 97-2003 Template](https://docs.fileformat.com/spreadsheet/xlt) (.XLT)
* [Microsoft Excel Macro-Enabled Template](https://docs.fileformat.com/spreadsheet/xltm) (.XLTM)
* [Microsoft Excel Add-In](https://docs.fileformat.com/spreadsheet/xlam/) (.XLAM)
* [XML Spreadsheet 2003](https://en.wikipedia.org/wiki/SpreadsheetML) (.XML)
* [OpenDocument Spreadsheet](https://docs.fileformat.com/spreadsheet/ods) (.ODS)
* [OpenDocument Spreadsheet Template](https://docs.fileformat.com/spreadsheet/ots/) (.OTS)
* [OpenDocument Flat XML Spreadsheet](https://docs.fileformat.com/spreadsheet/fods/) (.FODS)
* [Comma Separated Values File](https://docs.fileformat.com/spreadsheet/csv) (.CSV)
* [Tab Separated Values File](https://docs.fileformat.com/spreadsheet/tsv) (.TSV)
* [StarOffice Calc Spreadsheet](https://docs.fileformat.com/spreadsheet/sxc/) (.SXC)
* [Apple Numbers Spreadsheet](https://docs.fileformat.com/spreadsheet/numbers) (.NUMBERS)

## Render spreadsheets as HTML

Create an [HtmlViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a spreadsheet file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](#) method and specify the output file name.

#### Convert an Excel workbook to HTML

{{< tabs "render-excel-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("invoice.xlsx")
// Convert the spreadsheet to HTML.
// {0} is replaced with the current page number in the file names.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-excel-to-html-embedded/xlsx-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to HTML](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/convert-excel-to-html.png)

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "render-apple-numbers-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("Products.numbers")
// Convert the spreadsheet to HTML.
// {0} is replaced with the current page number in the file names.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-apple-numbers-to-html-embedded/numbers-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "Products.numbers" >}}
{{< tab-text >}}
`Products.numbers` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/Products.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to HTML](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](#) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

#### Convert an Excel workbook to HTML

{{< tabs "render-excel-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("invoice.xlsx")
// Convert the spreadsheet to HTML.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-excel-to-html-external/xlsx-to-html-page_{0}.html", "render-excel-to-html-external/xlsx-to-html-page_{0}/resource_{0}_{1}", "render-excel-to-html-external/xlsx-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "render-apple-numbers-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("Products.numbers")
// Convert the spreadsheet to HTML.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-apple-numbers-to-html-external/numbers-to-html-page_{0}.html", "render-apple-numbers-to-html-external/numbers-to-html-page_{0}/resource_{0}_{1}", "render-apple-numbers-to-html-external/numbers-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "Products.numbers" >}}
{{< tab-text >}}
`Products.numbers` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/Products.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/render-excel-to-html-external-resources.png)


### Convert all Excel worksheets to one HTML file

To convert all worksheets to one HTML file, use the [HtmlViewOptions.setRenderToSinglePage](#) method. This feature is supported in both cases - when converting to HTML with embedded and external resources.

{{< tabs "render-excel-all-worksheets-to-single-html">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("Personal_net_worth_calculator.xlsx")
// Convert all Excel worksheets to one HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-excel-all-worksheets-to-single-html/xlsx-to-html.html")
// Enable converting all worksheets to one file.
viewOptions.setRenderToSinglePage(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "Personal_net_worth_calculator.xlsx" >}}
{{< tab-text >}}
`Personal_net_worth_calculator.xlsx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/Personal_net_worth_calculator.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Convert all Excel worksheets to one HTML file](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/convert-all-excel-worksheets-to-html.png)


## Render spreadsheets as PDF

Create a [PdfViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a spreadsheet file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

### Convert an Excel workbook to PDF

{{< tabs "render-excel-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("invoice.xlsx")
// Convert the spreadsheet to PDF.
const viewOptions = PdfViewOptions("render-excel-to-pdf/xlsx-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to PDF](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/render-excel-to-pdf.png)

### Convert an Apple Numbers spreadsheet to PDF

{{< tabs "render-apple-numbers-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("Products.numbers")
// Convert the spreadsheet to PDF.
const viewOptions = PdfViewOptions("render-apple-numbers-to-pdf/numbers-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "Products.numbers" >}}
{{< tab-text >}}
`Products.numbers` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/Products.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PDF](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-pdf.png)

## Render spreadsheets as PNG

Create a [PngViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a spreadsheet file to PNG. Use the [PngViewOptions.setHeight](#) and [PngViewOptions.setWidth](#) methods to specify the output image size in pixels.

### Convert an Excel workbook to PNG

{{< tabs "render-excel-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("invoice.xlsx")
// Convert the spreadsheet to PNG.
// {0} is replaced with the current page number in the file names.
const viewOptions = PngViewOptions("render-excel-to-png/xlsx-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(800)
viewOptions.setHeight(900)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an Excel file to PNG](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/render-excel-to-png.png)

### Convert an Apple Numbers spreadsheet to PNG

{{< tabs "render-apple-numbers-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("Products.numbers")
// Convert the spreadsheet to PNG.
// {0} is replaced with the current page number in the file names.
const viewOptions = PngViewOptions("render-apple-numbers-to-png/numbers-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(800)
viewOptions.setHeight(900)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "Products.numbers" >}}
{{< tab-text >}}
`Products.numbers` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/Products.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PNG](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-png.png)

## Render spreadsheets as JPEG

Create a [JpgViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a spreadsheet file to JPEG. Use the [JpgViewOptions.setHeight](#) and [JpgViewOptions.setWidth](#) methods to specify the output image size in pixels.

### Convert an Excel workbook to JPEG

{{< tabs "render-excel-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("invoice.xlsx")
// Convert the spreadsheet to JPEG.
// {0} is replaced with the current page number in the file names.
const viewOptions = JpgViewOptions("render-excel-to-jpeg/xlsx-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(800)
viewOptions.setHeight(900)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Convert an Apple Numbers spreadsheet to JPEG

{{< tabs "render-apple-numbers-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("Products.numbers")
// Convert the spreadsheet to JPEG.
// {0} is replaced with the current page number in the file names.
const viewOptions = JpgViewOptions("render-apple-numbers-to-jpeg/numbers-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(800)
viewOptions.setHeight(900)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "Products.numbers" >}}
{{< tab-text >}}
`Products.numbers` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/Products.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Detect a CSV/TSV separator

If you load a CSV/TSV file to convert it to another format, use the [SpreadsheetOptions.setDetectSeparator](#) method for a target view to automatically detect a delimiter used to separate values in the source file.

GroupDocs.Viewer can detect the following separators:

* A comma (the default separator)
* A semicolon

{{< tabs "detect-csv-separator">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.csv")
// Convert the spreadsheet to JPEG.
// {0} is replaced with the current page number in the file names.
const viewOptions = HtmlViewOptions.forEmbeddedResources("detect-csv-separator/csv-to-html-page_{0}.html")
// Detect a CSV/TSV separator.
viewOptions.getSpreadsheetOptions().setDetectSeparator(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.csv" >}}
{{< tab-text >}}
`sample.csv` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.csv) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get worksheet names

GroupDocs.Viewer allows you to obtain information about the source spreadsheet file. For example, you can retrieve worksheet names, as described below:

1. Create a [ViewInfoOptions](#) instance for a specific view.
2. Call the [Viewer.getViewInfo](#) method and pass the `ViewInfoOptions` instance to this method as a parameter.
3. Use the [getPages](#) method of the returned [ViewInfo](#) object to access to the list of worksheets and retrieve the worksheet names.

{{< tabs "get-worksheet-names">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions, SpreadsheetOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.xlsx")
const viewInfoOptions = ViewInfoOptions.forHtmlView()
// Call this method to create a single page for each worksheet.
viewInfoOptions.setSpreadsheetOptions(SpreadsheetOptions.forOnePagePerSheet())
const viewInfo = viewer.getViewInfo(viewInfoOptions)
// Print the worksheet names in the console window.
console.log("The document contains the following worksheets:")
console.log(viewInfo.toString())
```
{{< /tab >}}
{{< tab "sample.xlsx" >}}
{{< tab-text >}}
`sample.xlsx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Retrieve worksheet names](/viewer/nodejs-java/images/rendering-basics/render-spreadsheets/retrieve-worksheet-names.png)

## See also

* [Split a worksheet into pages](/viewer/nodejs-java/split-worksheet-into-pages/)
* [Specify spreadsheet rendering options](/viewer/nodejs-java/specify-rendering-options/)

---

## Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files

Path: /viewer/python-net/render-excel-and-apple-numbers-spreadsheets/

[GroupDocs.Viewer for Python](https://products.groupdocs.com/viewer/python-net) allows you to render your spreadsheet files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Excel or other spreadsheet programs to load and view Excel documents within your Python application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass a spreadsheet file you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/excel" >}} {{< icon "gdoc_person" >}} View Excel files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported spreadsheet file formats

GroupDocs.Viewer supports the following spreadsheet file formats:

* [Microsoft Excel Workbook](https://docs.fileformat.com/spreadsheet/xlsx) (.XLSX)
* [Microsoft Excel 97-2003 Workbook](https://docs.fileformat.com/spreadsheet/xls) (.XLS)
* [Microsoft Excel Binary Workbook](https://docs.fileformat.com/spreadsheet/xlsb) (.XLSB)
* [Microsoft Excel Macro-Enabled Workbook](https://docs.fileformat.com/spreadsheet/xlsm) (.XLSM)
* [Microsoft Excel Template](https://docs.fileformat.com/spreadsheet/xltx) (.XLTX)
* [Microsoft Excel 97-2003 Template](https://docs.fileformat.com/spreadsheet/xlt) (.XLT)
* [Microsoft Excel Macro-Enabled Template](https://docs.fileformat.com/spreadsheet/xltm) (.XLTM)
* [Microsoft Excel Add-In](https://docs.fileformat.com/spreadsheet/xlam/) (.XLAM)
* [XML Spreadsheet 2003](https://en.wikipedia.org/wiki/SpreadsheetML) (.XML)
* [OpenDocument Spreadsheet](https://docs.fileformat.com/spreadsheet/ods) (.ODS)
* [OpenDocument Spreadsheet Template](https://docs.fileformat.com/spreadsheet/ots/) (.OTS)
* [OpenDocument Flat XML Spreadsheet](https://docs.fileformat.com/spreadsheet/fods/) (.FODS)
* [Comma Separated Values File](https://docs.fileformat.com/spreadsheet/csv) (.CSV)
* [Tab Separated Values File](https://docs.fileformat.com/spreadsheet/tsv) (.TSV)
* [StarOffice Calc Spreadsheet](https://docs.fileformat.com/spreadsheet/sxc/) (.SXC)
* [Apple Numbers Spreadsheet](https://docs.fileformat.com/spreadsheet/numbers) (.NUMBERS)

## Render spreadsheets as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a spreadsheet file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

#### Convert an Excel workbook to HTML

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_excel_to_html():
    # Load Excel spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to HTML.
        # {0} is replaced with the current page number in the file names.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_excel_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_excel_to_html()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to HTML](/viewer/python-net/images/rendering-basics/render-spreadsheets/convert-excel-to-html.png)

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_numbers_to_html():
    # Load Apple Numbers spreadsheet
    with Viewer("sample.numbers") as viewer:
        # Convert the spreadsheet to HTML.
        # {0} is replaced with the current page number in the file names.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_numbers_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_numbers_to_html()
```
{{< /tab >}}
{{< tab "sample.numbers" >}}
{{< tab-text >}}
`sample.numbers` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to HTML](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

#### Convert an Excel workbook to HTML

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_excel_to_html_external():
    # Load Excel spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to HTML.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_excel_to_html_external/pdf_page_{0}.html", "render_excel_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_excel_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_excel_to_html_external()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

#### Convert an Apple Numbers spreadsheet to HTML

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_numbers_to_html_external():
    # Load Apple Numbers spreadsheet
    with Viewer("sample.numbers") as viewer:
        # Convert the spreadsheet to HTML.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_numbers_to_html_external/pdf_page_{0}.html", "render_numbers_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_numbers_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_numbers_to_html_external()
```
{{< /tab >}}
{{< tab "sample.numbers" >}}
{{< tab-text >}}
`sample.numbers` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-excel-to-html-external-resources.png)


### Convert all Excel worksheets to one HTML file

To convert all worksheets to one HTML file, use the [HtmlViewOptions.render_to_single_page](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method. This feature is supported in both cases - when converting to HTML with embedded and external resources.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_excel_to_single_html():
    # Load Excel spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert all Excel worksheets to one HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_excel_to_single_html/page.html")
        # Enable converting all worksheets to one file.
        viewOptions.render_to_single_page = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_excel_to_single_html()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Convert all Excel worksheets to one HTML file](/viewer/python-net/images/rendering-basics/render-spreadsheets/convert-all-excel-worksheets-to-html.png)


## Render spreadsheets as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a spreadsheet file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

### Convert an Excel workbook to PDF

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_excel_to_pdf():
    # Load Excel spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_excel_to_pdf/spreadsheet.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_excel_to_pdf()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file to PDF](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-excel-to-pdf.png)

### Convert an Apple Numbers spreadsheet to PDF

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_numbers_to_pdf():
    # Load Apple Numbers spreadsheet
    with Viewer("sample.numbers") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_numbers_to_pdf/spreadsheet.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_numbers_to_pdf()
```
{{< /tab >}}
{{< tab "sample.numbers" >}}
{{< tab-text >}}
`sample.numbers` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PDF](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-pdf.png)

## Render spreadsheets as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a spreadsheet file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#methods) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#methods) methods to specify the output image size in pixels.

### Convert an Excel workbook to PNG

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_excel_to_png():
    # Load Excel spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PNG.
        # {0} is replaced with the current page number in the file names.
        viewOptions = PngViewOptions("render_excel_to_png/spreadsheet_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_excel_to_png()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an Excel file to PNG](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-excel-to-png.png)

### Convert an Apple Numbers spreadsheet to PNG

{{< tabs "example9">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_numbers_to_png():
    # Load Apple Numbers spreadsheet
    with Viewer("sample.numbers") as viewer:
        # Convert the spreadsheet to PNG.
        # {0} is replaced with the current page number in the file names.
        viewOptions = PngViewOptions("render_numbers_to_png/spreadsheet_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_numbers_to_png()
```
{{< /tab >}}
{{< tab "sample.numbers" >}}
{{< tab-text >}}
`sample.numbers` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Apple Numbers spreadsheet to PNG](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-apple-numbers-to-png.png)

## Render spreadsheets as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a spreadsheet file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#methods) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#methods) methods to specify the output image size in pixels.

### Convert an Excel workbook to JPEG

{{< tabs "example10">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_excel_to_jpg():
    # Load Excel spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to JPEG.
        # {0} is replaced with the current page number in the file names.
        viewOptions = JpgViewOptions("render_excel_to_jpg/excel_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_excel_to_jpg()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Convert an Apple Numbers spreadsheet to JPEG

{{< tabs "example11">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_numbers_to_jpg():
    # Load Apple Numbers spreadsheet
    with Viewer("sample.numbers") as viewer:
        # Convert the spreadsheet to JPEG.
        # {0} is replaced with the current page number in the file names.
        viewOptions = JpgViewOptions("render_numbers_to_jpg/numbers_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_numbers_to_jpg()
```
{{< /tab >}}
{{< tab "sample.numbers" >}}
{{< tab-text >}}
`sample.numbers` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.numbers) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Detect a CSV/TSV separator

If you load a CSV/TSV file to convert it to another format, use the [SpreadsheetOptions.detect_separator](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/#properties) method for a target view to automatically detect a delimiter used to separate values in the source file.

GroupDocs.Viewer can detect the following separators:

* A comma (the default separator)
* A semicolon

{{< tabs "example12">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_csv_with_separator_detection():
    # Load CSV file
    with Viewer("sample.csv") as viewer:
        # Convert the spreadsheet to HTML.
        # {0} is replaced with the current page number in the file names.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_csv_with_separator_detection/csv_with_separator_detection_{0}.html")
        # Detect a CSV/TSV separator.
        viewOptions.spreadsheet_options.detect_separator = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_csv_with_separator_detection()
```
{{< /tab >}}
{{< tab "sample.csv" >}}
{{< tab-text >}}
`sample.csv` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.csv) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get worksheet names

GroupDocs.Viewer allows you to obtain information about the source spreadsheet file. For example, you can retrieve worksheet names, as described below:

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewinfooptions/) instance for a specific view.
2. Call the [Viewer.get_view_info](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method and pass the `ViewInfoOptions` instance to this method as a parameter.
3. Use the [pages](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/viewinfo/#properties) method of the returned [ViewInfo](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/viewinfo/) object to access to the list of worksheets and retrieve the worksheet names.

{{< tabs "example13">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions, SpreadsheetOptions

def get_worksheet_names():
    # Load Excel spreadsheet
    with Viewer("sample.xlsx") as viewer:
        view_info_options = ViewInfoOptions.for_html_view()
        # Call this method to create a single page for each worksheet.
        view_info_options.spreadsheet_options = SpreadsheetOptions.for_one_page_per_sheet()
        view_info = viewer.get_view_info(view_info_options)
        # Print the worksheet names in the console window.
        print("Worksheets:")
        for page in view_info.pages:
            print(f" - Worksheet {page.number} name '{page.name}'")

if __name__ == "__main__":
    get_worksheet_names()
```
{{< /tab >}}
{{< tab "sample.xlsx" >}}
{{< tab-text >}}
`sample.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/render-excel-and-apple-numbers-spreadsheets/sample.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Retrieve worksheet names](/viewer/python-net/images/rendering-basics/render-spreadsheets/retrieve-worksheet-names.png)

## See also

* [Split a worksheet into pages](/viewer/python-net/split-worksheet-into-pages/)
* [Specify spreadsheet rendering options](/viewer/python-net/specify-rendering-options/)

---

## Render specific pages

Path: /viewer/java/view-specific-pages/

You can render part of the document pages only. You can specify a list of the document pages in the following ways:
* [Specify a list of pages as parameters of the View method](#specify-pages-as-parameters)
* [Specify a list of pages by using an array](#specify-pages-by-using-an-array)

## Specify pages as parameters

To specify pages as the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method parameters, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object.
2. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) (or the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/), or the [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/), or the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/)) object.
3. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method. Specify the page numbers as the last parameters.

The following code snippet shows how to render the first and third pages of a document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions, 1, 3);
}
```
{{< /tab >}}
{{< /tabs >}}

## Specify pages by using an array

To specify pages by using an array, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object;
2. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) (or the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/), or the [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/), or the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/)) object;
3. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method. Specify the page numbers array as the second parameter.

The following code snippet shows how to render the 1st, 2nd, and 4th pages of a document:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

int[] pageNumbers = new int[] { 1, 2, 4 };

try (Viewer viewer = new Viewer("sample.docx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions, pageNumbers);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Render specific pages

Path: /viewer/net/view-specific-pages/

You can render part of the document pages only. You can specify a list of the document pages in the following ways:
* [Specify a list of pages as parameters of the View method](#specify-pages-as-parameters)
* [Specify a list of pages by using an array](#specify-pages-by-using-an-array)

## Specify pages as parameters

To specify pages as the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method parameters, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object.
2. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) (or the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions), or the [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions), or the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)) object.
3. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method. Specify the page numbers as the last parameters.

The following code snippet shows how to render the first and third pages of a document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create view options.
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();

    // Specify the page numbers.
    viewer.View(viewOptions, 1, 3);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
    Using viewer As Viewer = New Viewer("sample.docx")
        ' Create view options.
        Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
    
        ' Specify the page numbers.
        viewer.View(viewOptions, 1, 3)
    End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Specify pages by using an array

To specify pages by using an array, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object;
2. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) (or the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions), or the [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions), or the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)) object;
3. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method. Specify the page numbers array as the second parameter.

The following code snippet shows how to render the 1st, 2nd, and 4th pages of a document:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create an array and specify page numbers.
int[] pageNumbers = new int[] { 1, 2, 4 };

using (Viewer viewer = new Viewer("sample.docx"))
{
   // Create view options.
   var viewOptions = HtmlViewOptions.ForEmbeddedResources();

   // Use array to render specific pages.
   viewer.View(viewOptions, pageNumbers);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Create an array and specify page numbers.
        Dim pageNumbers = New Integer() {1, 2, 4}
    
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create view options.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
    
            ' Use array to render specific pages.
            viewer.View(viewOptions, pageNumbers)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Render with responsive layout

Path: /viewer/java/render-with-responsive-layout/


Responsive design aims to make web pages render well on a variety of devices. GroupDocs.Viewer provides the [setRenderResponsive()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setRenderResponsive-boolean-) method of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class to render HTML pages with responsive layout. 

The following code snippet shows how to render a .docx document to HTML with responsive layout:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    // Render with responsive layout.
    viewOptions.setRenderResponsive(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Render with responsive layout

Path: /viewer/net/render-with-responsive-layout/


Responsive design aims to make web pages render well on a variety of devices. GroupDocs.Viewer provides the [RenderResponsive](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions/properties/renderresponsive) property of the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) class to render HTML pages with responsive layout. 

The following code snippet shows how to render a .docx document to HTML with responsive layout:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create view options.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    
    // Render the file with responsive layout.
    viewOptions.RenderResponsive = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create view options.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
        
            ' Render the file with responsive layout.
            viewOptions.RenderResponsive = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Render Word documents as HTML, PDF, and image files

Path: /viewer/java/render-word-documents/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your Microsoft Word documents in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Word or other word processors to load and view Word documents within your Java application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/word" >}} {{< icon "gdoc_person" >}} View Word files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Word Processing file formats

GroupDocs.Viewer supports the following Word Processing file formats:

* [Microsoft Word Document](https://docs.fileformat.com/word-processing/docx) (.DOCX)
* [Microsoft Word 97-2003 Document](https://docs.fileformat.com/word-processing/doc) (.DOC)
* [Microsoft Word Macro-Enabled Document](https://docs.fileformat.com/word-processing/docm) (.DOCM)
* [Microsoft Word 97-2003 Template](https://docs.fileformat.com/word-processing/dot) (.DOT)
* [Microsoft Word Macro-Enabled Template](https://docs.fileformat.com/word-processing/dotm) (.DOTM)
* [Microsoft Word Template](https://docs.fileformat.com/word-processing/dotx) (.DOTX)
* [OpenDocument Text](https://docs.fileformat.com/word-processing/odt) (.ODT)
* [OpenDocument Text Template](https://docs.fileformat.com/word-processing/ott) (.OTT)
* [Rich Text Document](https://docs.fileformat.com/word-processing/rtf) (.RTF)
* [Plain Text Document](https://docs.fileformat.com/word-processing/txt) (.TXT)

## Render Word documents as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Word file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
    // Create an HTML files.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to HTML](/viewer/java/images/rendering-basics/render-word-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
   // Create an HTML file for each page.
   // Specify the HTML file names and location of external resources.
   // {0} and {1} are replaced with the current page number and resource name, respectively.
   HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-word-documents/render-to-html-external-resources.png)

## Render Word documents as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Word file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
    // Create a PDF file for the document.
    // Specify the PDF file name.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to PDF](/viewer/java/images/rendering-basics/render-word-documents/render-to-pdf.png)

## Render Word documents as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Word file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
    // Create a PNG image for each document page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Word file to PNG](/viewer/java/images/rendering-basics/render-word-documents/render-to-png-image.png)

## Render Word documents as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Word file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
    // Create a JPG image for each document page.
    // {0} is replaced with the current page number in the image name.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Define page margins

Use the following methods to specify the size of page margins in the output files when you convert your Word documents to HTML, PDF, and image formats: 

* [WordProcessingOptions.setTopMargin](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/#setTopMargin-float-) specifies the distance (in points) between document content and the top edge of the page.
* [WordProcessingOptions.setBottomMargin](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/#setBottomMargin-float-) specifies the distance (in points) between document content and the bottom edge of the page.
* [WordProcessingOptions.setLeftMargin](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/#setLeftMargin-float-) specifies the distance (in points) between document content and the left edge of the page.
* [WordProcessingOptions.setRightMargin](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/#setRightMargin-float-) specifies the distance (in points) between document content and the right edge of the page.

You can access these methods for the following classes:

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions)
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) 

The example below converts a Word document to HTML and specifies page margins for the output file. 

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    // Specify the size of page margins in points.
    viewOptions.getWordProcessingOptions().setTopMargin(72);
    viewOptions.getWordProcessingOptions().setBottomMargin(72);
    viewOptions.getWordProcessingOptions().setLeftMargin(54);
    viewOptions.getWordProcessingOptions().setRightMargin(54);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render tracked changes

GroupDocs.Viewer does not render tracked changes (revisions made to a Word document) by default. If you want to display tracked changes in the output file, use the [WordProcessingOptions.setRenderTrackedChanges](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/#setRenderTrackedChanges-boolean-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

The following code example demonstrates how to render a Word document with tracked changes:

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
    // Convert the document to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Enable tracked changes rendering.
    viewOptions.getWordProcessingOptions().setRenderTrackedChanges(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render tracked changes to PDF](/viewer/java/images/rendering-basics/render-word-documents/render-track-changes-to-pdf.png)

## Render comments

Use the [ViewOptions.setRenderComments](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderComments-boolean-) method for a target view to display comments in the output file when you convert your document to HTML, PDF, PNG, or JPEG format.

The code example below renders a Word document with comments to PDF.

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx")) {
    // Convert the document to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Enable rendering comments.
    viewOptions.setRenderComments(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render comments to PDF](/viewer/java/images/rendering-basics/render-word-documents/render-comments-to-pdf.png)

## Unlink table of contents

When rendering to HTML or PDF, you can set [WordProcessingOptions.setUnlinkTableOfContents()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/#setUnlinkTableOfContents-boolean-) to `true` to unlink table of contents. For HTML rendering, `<a>` tags with relative links will be replaced with `<span>` tags, removing functionality but preserving visual appearance. For PDF rendering, the table of contents will be rendered as plain text without links to document sections.

The code example below renders a Word document with table of contents as a plain text without links.

{{< tabs "example9">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.docx"))
{
    // Convert the document to HTML.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    // Unlink table of contents.
    viewOptions.getWordProcessingOptions().setUnlinkTableOfContents(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Unlink table of contens in Word files](/viewer/net/images/rendering-basics/render-word-documents/unlink-table-of-contents.png)

## Disable updating fields when saving

The most of formats inside the WordProcessing family of formats, like DOC, DOCX, ODT and so on, have the concept of [fields](https://support.microsoft.com/en-us/office/list-of-field-codes-in-word-1ad6d91a-55a7-4a8d-b535-cf7888659a51), which are processed when the document is opened in some viewer application like Microsoft Word. When the input WordProcessing document is loaded to the GroupDocs.Viewer and saved to the HTML (with embedded or external resources), PDF, PNG, or JPEG output formats, all the fields within the input document are updated while saving, and this mimics the Microsoft Word behavior. But in some scenarios, for example, when field values are incorrect, there is no necessary and even not desirable to update fields.

Starting from the version [25.9](https://releases.groupdocs.com/viewer/java/release-notes/2025/groupdocs-viewer-for-java-25-9-release-notes/) the GroupDocs.Viewer for Java has obtained an ability to disable updating fields while saving the documents. The new public property [`setUpdateFields`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/#setUpdateFields-boolean-) of the [`java.lang.Boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) type was added to the [`WordProcessingOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/wordprocessingoptions/) class. By default the value of this property is set to `true`, so fields are updated, as before. In order to turn fields updating off, please set this property to `false`. Code sample below shows opening a sample DOCX document and saving to the HTML with embedded resources and PDF formats without updating fields during saving.

{{< tabs "example-UpdateFields">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

HtmlViewOptions htmlViewOptions = HtmlViewOptions.forEmbeddedResources();
htmlViewOptions.getWordProcessingOptions().setUpdateFields(false);

PdfViewOptions pdfViewOptions = new PdfViewOptions("output.pdf");
pdfViewOptions.getWordProcessingOptions().setUpdateFields(false);

try (Viewer viewer = new Viewer("resume.docx"))
{    
    viewer.view(htmlViewOptions);
    viewer.view(pdfViewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Remove or preserve JavaScript when saving to HTML

Most of WordProcessing formats like DOC, DOCX, ODT and so on are able to store the scripts, usually written on VBA. When the output format is PDF, PNG, or JPEG, there is no problem at all. But when the output format is HTML, this may lead to the situations when malicious or harmful VBA script(s) from input DOCX, for example, will be translated to the resultant HTML document. Before the [version 25.9](https://releases.groupdocs.com/viewer/java/release-notes/2025/groupdocs-viewer-for-java-25-9-release-notes/) the was no possibility for the GroupDocs.Viewer to disable scripts preserving and translation — all the VBA scripts were translated to the JavaScript in HTML. Starting from the version 25.9, for the security purposes script translation is disabled by default — all the links containing JavaScript are replaced with the harmless `"javascript:void(0)"` string in the resultant HTML markup. But it is possible to enable script translation, as it was present in the GroupDocs.Viewer before, by using a new public property `RemoveJavaScript` of the [`java.lang.Boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) type in the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class. By default this property has a `true` value — JavaScript will be removed from the resultant HTML document. For preserving the JavaScript, as it was in the previous versions of the GroupDocs.Viewer, the `false` value should be assigned to this property. Code sample below shows opening a sample DOCX document and rendering it to the HTML with embedded resources with and without JavaScript.

{{< tabs "example-RemoveJavaScript">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

HtmlViewOptions htmlViewOptionsWithoutJavaScript = HtmlViewOptions.forEmbeddedResources("without-js-page{0}.html");

HtmlViewOptions htmlViewOptionsWithJavaScript = HtmlViewOptions.forEmbeddedResources("with-js-page{0}.html");
htmlViewOptionsWithJavaScript.setRemoveJavaScript(false);

try (Viewer viewer = new Viewer("Doc-with-VBA.docx"))
{
    viewer.view(htmlViewOptionsWithoutJavaScript);
    viewer.view(htmlViewOptionsWithJavaScript);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Render Word documents as HTML, PDF, and image files

Path: /viewer/net/render-word-documents/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your Microsoft Word documents in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Word or other word processors to load and view Word documents within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/word" >}} {{< icon "gdoc_person" >}} View Word files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Word Processing file formats

GroupDocs.Viewer supports the following Word Processing file formats:

* [Microsoft Word Document](https://docs.fileformat.com/word-processing/docx) (.DOCX)
* [Microsoft Word 97-2003 Document](https://docs.fileformat.com/word-processing/doc) (.DOC)
* [Microsoft Word Macro-Enabled Document](https://docs.fileformat.com/word-processing/docm) (.DOCM)
* [Microsoft Word 97-2003 Template](https://docs.fileformat.com/word-processing/dot) (.DOT)
* [Microsoft Word Macro-Enabled Template](https://docs.fileformat.com/word-processing/dotm) (.DOTM)
* [Microsoft Word Template](https://docs.fileformat.com/word-processing/dotx) (.DOTX)
* [OpenDocument Text](https://docs.fileformat.com/word-processing/odt) (.ODT)
* [OpenDocument Text Template](https://docs.fileformat.com/word-processing/ott) (.OTT)
* [Rich Text Document](https://docs.fileformat.com/word-processing/rtf) (.RTF)
* [Plain Text Document](https://docs.fileformat.com/word-processing/txt) (.TXT)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render Word documents as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Word file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Create an HTML file for each document page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to HTML](/viewer/net/images/rendering-basics/render-word-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Create an HTML file for each document page.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Create an HTML file for each document page.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-word-documents/render-to-html-external-resources.png)

## Render Word documents as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Word file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Create a PDF file for the document.
    // Specify the PDF file name.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Create a PDF file for the document.
            ' Specify the PDF file name.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to PDF](/viewer/net/images/rendering-basics/render-word-documents/render-to-pdf.png)

## Render Word documents as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Word file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Create a PNG image for each document page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Create a PNG image for each document page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Word file to PNG](/viewer/net/images/rendering-basics/render-word-documents/render-to-png-image.png)

## Render Word documents as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Word file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Create a JPEG image for each document page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Create a JPEG image for each document page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Define page margins

Use the following properties to specify the size of page margins in the output files when you convert your Word documents to HTML, PDF, and image formats: 

* [WordProcessingOptions.TopMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/wordprocessingoptions/properties/topmargin) specifies the distance (in points) between document content and the top edge of the page.
* [WordProcessingOptions.BottomMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/wordprocessingoptions/properties/bottommargin) specifies the distance (in points) between document content and the bottom edge of the page.
* [WordProcessingOptions.LeftMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/wordprocessingoptions/properties/leftmargin) specifies the distance (in points) between document content and the left edge of the page.
* [WordProcessingOptions.RightMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/wordprocessingoptions/properties/rightmargin) specifies the distance (in points) between document content and the right edge of the page.

You can access these properties for the following classes:

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions)
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) 

The example below converts a Word document to HTML and specifies page margins for the output file. 

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Specify the size of page margins in points.
    viewOptions.WordProcessingOptions.TopMargin = 72;
    viewOptions.WordProcessingOptions.BottomMargin = 72;
    viewOptions.WordProcessingOptions.LeftMargin = 54;
    viewOptions.WordProcessingOptions.RightMargin = 54;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Create an HTML file for each document page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Specify the size of page margins in points.
            viewOptions.WordProcessingOptions.TopMargin = 72
            viewOptions.WordProcessingOptions.BottomMargin = 72
            viewOptions.WordProcessingOptions.LeftMargin = 54
            viewOptions.WordProcessingOptions.RightMargin = 54
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render tracked changes

GroupDocs.Viewer does not render tracked changes (revisions made to a Word document) by default. If you want to display tracked changes in the output file, enable the [WordProcessingOptions.RenderTrackedChanges](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/wordprocessingoptions/properties/rendertrackedchanges) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

The following code example demonstrates how to render a Word document with tracked changes:

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TrackChanges.docx"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable tracked changes rendering.
    viewOptions.WordProcessingOptions.RenderTrackedChanges = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TrackChanges.docx")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable tracked changes rendering.
            viewOptions.WordProcessingOptions.RenderTrackedChanges = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render tracked changes to PDF](/viewer/net/images/rendering-basics/render-word-documents/render-track-changes-to-pdf.png)

## Render comments

Enable the [ViewOptions.RenderComments](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/rendercomments) option for a target view to display comments in the output file when you convert your document to HTML, PDF, PNG, or JPEG format.

The code example below renders a Word document with comments to PDF.

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable comments rendering.
    viewOptions.RenderComments = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable comments rendering.
            viewOptions.RenderComments = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render comments to PDF](/viewer/net/images/rendering-basics/render-word-documents/render-comments-to-pdf.png)

## Unlink table of contents

When rendering to HTML or PDF, you can set [WordProcessingOptions.UnlinkTableOfContents](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/wordprocessingoptions/properties/unlinktableofcontents) to `true` to unlink table of contents. For HTML rendering, `<a>` tags with relative links will be replaced with `<span>` tags, removing functionality but preserving visual appearance. For PDF rendering, the table of contents will be rendered as plain text without links to document sections.

The code example below renders a Word document with table of contents as a plain text without links.

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.docx"))
{
    // Convert the document to HTML.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Unlink table of contents.
    viewOptions.WordProcessingOptions.UnlinkTableOfContents = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.docx")
            ' Convert the document to HTML.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
            ' Unlink table of contents.
            viewOptions.WordProcessingOptions.UnlinkTableOfContents = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Unlink table of contens in Word files](/viewer/net/images/rendering-basics/render-word-documents/unlink-table-of-contents.png)

## Disable updating fields when saving

The most of formats inside the WordProcessing family of formats, like DOC, DOCX, ODT and so on, have the concept of [fields](https://support.microsoft.com/en-us/office/list-of-field-codes-in-word-1ad6d91a-55a7-4a8d-b535-cf7888659a51), which are processed when the document is opened in some viewer application like Microsoft Word. When the input WordProcessing document is loaded to the GroupDocs.Viewer and saved to the HTML (with embedded or external resources), PDF, PNG, or JPEG output formats, all the fields within the input document are updated while saving, and this mimics the Microsoft Word behavior. But in some scenarios, for example, when field values are incorrect, there is no necessary and even not desirable to update fields.

Starting from the version [24.12](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-12-release-notes/) the GroupDocs.Viewer for .NET has obtained an ability to disable updating fields while saving the documents. The new public property [`UpdateFields`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/wordprocessingoptions/updatefields/) of the [`System.Boolean`](https://learn.microsoft.com/dotnet/api/system.boolean) type was added to the [`Options.WordProcessingOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/wordprocessingoptions/) class. By default the value of this property is set to `true`, so fields are updated, as before. In order to turn fields updating off, please set this property to `false`. Code sample below shows opening a sample DOCX document and saving to the HTML with embedded resources and PDF formats without updating fields during saving.

{{< tabs "example-UpdateFields">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

HtmlViewOptions htmlViewOptions = HtmlViewOptions.ForEmbeddedResources();
htmlViewOptions.WordProcessingOptions.UpdateFields = false;

PdfViewOptions pdfViewOptions = new PdfViewOptions("output.pdf");
pdfViewOptions.WordProcessingOptions.UpdateFields = false;

using (var viewer = new Viewer("resume.docx"))
{    
    viewer.View(htmlViewOptions);
	viewer.View(pdfViewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Dim htmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
htmlViewOptions.WordProcessingOptions.UpdateFields = False

Dim pdfViewOptions = New PdfViewOptions("output.pdf")
pdfViewOptions.WordProcessingOptions.UpdateFields = False

Using viewer = New Viewer("resume.docx")	
	viewer.View(htmlViewOptions)
	viewer.View(pdfViewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

## Remove or preserve JavaScript when saving to HTML

Most of WordProcessing formats like DOC, DOCX, ODT and so on are able to store the scripts, usually written on VBA. When the output format is PDF, PNG, or JPEG, there is no problem at all. But when the output format is HTML, this may lead to the situations when malicious or harmful VBA script(s) from input DOCX, for example, will be translated to the resultant HTML document. Before the [version 25.1](https://releases.groupdocs.com/viewer/net/release-notes/2025/groupdocs-viewer-for-net-25-1-release-notes/) the was no possibility for the GroupDocs.Viewer to disable scripts preserving and translation — all the VBA scripts were translated to the JavaScript in HTML. Starting from the version 25.1, for the security purposes script translation is disabled by default — all the links containing JavaScript are replaced with the harmless `"javascript:void(0)"` string in the resultant HTML markup. But it is possible to enable script translation, as it was present in the GroupDocs.Viewer before, by using a new public property `RemoveJavaScript` of the [`System.Boolean`](https://learn.microsoft.com/dotnet/api/system.boolean) type in the [`Options.HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) class. By default this property has a `true` value — JavaScript will be removed from the resultant HTML document. For preserving the JavaScript, as it was in the previous versions of the GroupDocs.Viewer, the `false` value should be assigned to this property. Code sample below shows opening a sample DOCX document and rendering it to the HTML with embedded resources with and without JavaScript.

{{< tabs "example-RemoveJavaScript">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

HtmlViewOptions htmlViewOptionsWithoutJavaScript = HtmlViewOptions.ForEmbeddedResources("without-js-page{0}.html");

HtmlViewOptions htmlViewOptionsWithJavaScript = HtmlViewOptions.ForEmbeddedResources("with-js-page{0}.html");
htmlViewOptionsWithJavaScript.RemoveJavaScript = false;

using (var viewer = new Viewer("Doc-with-VBA.docx"))
{
    viewer.View(htmlViewOptionsWithoutJavaScript);
    viewer.View(htmlViewOptionsWithJavaScript);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Dim htmlViewOptionsWithoutJavaScript = HtmlViewOptions.ForEmbeddedResources("without-js-page{0}.html")

Dim htmlViewOptionsWithJavaScript = HtmlViewOptions.ForEmbeddedResources("with-js-page{0}.html")
htmlViewOptionsWithJavaScript.RemoveJavaScript = false;

Using viewer = New Viewer("Doc-with-VBA.docx")	
	viewer.View(htmlViewOptionsWithoutJavaScript)
	viewer.View(htmlViewOptionsWithJavaScript)
End Using
```
{{< /tab >}}
{{< /tabs >}}


---

## Render Word documents as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-word-documents/

[GroupDocs.Viewer for Node.js](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your Microsoft Word documents in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Word or other word processors to load and view Word documents within your JavaScript application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](#) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](#) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/word" >}} {{< icon "gdoc_person" >}} View Word files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Word Processing file formats

GroupDocs.Viewer supports the following Word Processing file formats:

* [Microsoft Word Document](https://docs.fileformat.com/word-processing/docx) (.DOCX)
* [Microsoft Word 97-2003 Document](https://docs.fileformat.com/word-processing/doc) (.DOC)
* [Microsoft Word Macro-Enabled Document](https://docs.fileformat.com/word-processing/docm) (.DOCM)
* [Microsoft Word 97-2003 Template](https://docs.fileformat.com/word-processing/dot) (.DOT)
* [Microsoft Word Macro-Enabled Template](https://docs.fileformat.com/word-processing/dotm) (.DOTM)
* [Microsoft Word Template](https://docs.fileformat.com/word-processing/dotx) (.DOTX)
* [OpenDocument Text](https://docs.fileformat.com/word-processing/odt) (.ODT)
* [OpenDocument Text Template](https://docs.fileformat.com/word-processing/ott) (.OTT)
* [Rich Text Document](https://docs.fileformat.com/word-processing/rtf) (.RTF)
* [Plain Text Document](https://docs.fileformat.com/word-processing/txt) (.TXT)

## Render Word documents as HTML

Create an [HtmlViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a Word file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](#) method and specify the output file name.

{{< tabs "render-word-to-html-embedded-resources">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.docx")
// Create an HTML files.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-word-to-html-embedded-resources/docx-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to HTML](/viewer/nodejs-java/images/rendering-basics/render-word-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](#) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-word-to-html-external-resources">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.docx")
// Create an HTML file for each page.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-word-to-html-external-resources/docx-to-html-page_{0}.html", "render-word-to-html-external-resources/docx-to-html-page_{0}/resource_{0}_{1}", "render-word-to-html-external-resources/docx-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-word-documents/render-to-html-external-resources.png)

## Render Word documents as PDF

Create a [PdfViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a Word file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-word-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.docx")
// Create a PDF file for the document.
// Specify the PDF file name.
const viewOptions = PdfViewOptions("render-word-to-pdf/docx-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to PDF](/viewer/nodejs-java/images/rendering-basics/render-word-documents/render-to-pdf.png)

## Render Word documents as PNG

Create a [PngViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a Word file to PNG. Use the [PngViewOptions.setHeight](#) and [PngViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-word-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.docx")
// Create a PNG image for each document page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-word-to-png/docx-to-png-page_{0}.png")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Word file to PNG](/viewer/nodejs-java/images/rendering-basics/render-word-documents/render-to-png-image.png)

## Render Word documents as JPEG

Create a [JpgViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a Word file to JPEG. Use the [JpgViewOptions.setHeight](#) and [JpgViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-word-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.docx")
// Create a JPG image for each document page.
// {0} is replaced with the current page number in the image name.
const viewOptions = JpgViewOptions("render-word-to-jpeg/docx-to-jpg-page_{0}.jpg")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Define page margins

Use the following methods to specify the size of page margins in the output files when you convert your Word documents to HTML, PDF, and image formats: 

* [WordProcessingOptions.setTopMargin](#) specifies the distance (in points) between document content and the top edge of the page.
* [WordProcessingOptions.setBottomMargin](#) specifies the distance (in points) between document content and the bottom edge of the page.
* [WordProcessingOptions.setLeftMargin](#) specifies the distance (in points) between document content and the left edge of the page.
* [WordProcessingOptions.setRightMargin](#) specifies the distance (in points) between document content and the right edge of the page.

You can access these methods for the following classes:

* [HtmlViewOptions](#)
* [PdfViewOptions](#)
* [PngViewOptions](#)
* [JpgViewOptions](#) 

The example below converts a Word document to HTML and specifies page margins for the output file. 

{{< tabs "render-word-with-page-margins">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';
import java from 'java';

const viewer = new Viewer("resume.docx")
// Create an HTML file for each document page.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-word-with-page-margins/docx-to-html-page_{0}.html")
// Specify the size of page margins in points.
viewOptions.getWordProcessingOptions().setTopMargin(java.newDouble(72.0))
viewOptions.getWordProcessingOptions().setBottomMargin(java.newDouble(72.0))
viewOptions.getWordProcessingOptions().setLeftMargin(java.newDouble(54.0))
viewOptions.getWordProcessingOptions().setRightMargin(java.newDouble(54.0))
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render tracked changes

GroupDocs.Viewer does not render tracked changes (revisions made to a Word document) by default. If you want to display tracked changes in the output file, use the [WordProcessingOptions.setRenderTrackedChanges](#) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](#) 
* [PdfViewOptions](#)
* [PngViewOptions](#)
* [JpgViewOptions](#)

The following code example demonstrates how to render a Word document with tracked changes:

{{< tabs "render-word-with-tracked-changes">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.docx")
// Convert the document to PDF.
const viewOptions = PdfViewOptions("render-word-with-tracked-changes/docx-to-pdf.pdf")
// Enable tracked changes rendering.
viewOptions.getWordProcessingOptions().setRenderTrackedChanges(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render tracked changes to PDF](/viewer/nodejs-java/images/rendering-basics/render-word-documents/render-track-changes-to-pdf.png)

## Render comments

Use the [ViewOptions.setRenderComments](#) method for a target view to display comments in the output file when you convert your document to HTML, PDF, PNG, or JPEG format.

The code example below renders a Word document with comments to PDF.

{{< tabs "render-word-with-comments">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.docx")
// Convert the document to PDF.
const viewOptions = PdfViewOptions("render-word-with-comments/docx-to-pdf.pdf")
// Enable rendering comments.
viewOptions.setRenderComments(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.docx" >}}
{{< tab-text >}}
`resume.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-word-documents/resume.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render comments to PDF](/viewer/nodejs-java/images/rendering-basics/render-word-documents/render-comments-to-pdf.png)

---

## Render Word documents as HTML, PDF, and image files

Path: /viewer/python-net/render-word-documents/

[GroupDocs.Viewer for Python](https://products.groupdocs.com/viewer/python-net) allows you to render your Microsoft Word documents in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Word or other word processors to load and view Word documents within your Python application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](#) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/word" >}} {{< icon "gdoc_person" >}} View Word files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Word Processing file formats

GroupDocs.Viewer supports the following Word Processing file formats:

* [Microsoft Word Document](https://docs.fileformat.com/word-processing/docx) (.DOCX)
* [Microsoft Word 97-2003 Document](https://docs.fileformat.com/word-processing/doc) (.DOC)
* [Microsoft Word Macro-Enabled Document](https://docs.fileformat.com/word-processing/docm) (.DOCM)
* [Microsoft Word 97-2003 Template](https://docs.fileformat.com/word-processing/dot) (.DOT)
* [Microsoft Word Macro-Enabled Template](https://docs.fileformat.com/word-processing/dotm) (.DOTM)
* [Microsoft Word Template](https://docs.fileformat.com/word-processing/dotx) (.DOTX)
* [OpenDocument Text](https://docs.fileformat.com/word-processing/odt) (.ODT)
* [OpenDocument Text Template](https://docs.fileformat.com/word-processing/ott) (.OTT)
* [Rich Text Document](https://docs.fileformat.com/word-processing/rtf) (.RTF)
* [Plain Text Document](https://docs.fileformat.com/word-processing/txt) (.TXT)

## Render Word documents as HTML

Create an [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Word file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_word_to_html():
    # Load Word document
    with Viewer("sample.docx") as viewer:
        # Create an HTML files.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_word_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_to_html()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to HTML](/viewer/python-net/images/rendering-basics/render-word-documents/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_word_to_html_external():
    # Load Word document
    with Viewer("sample.docx") as viewer:
        # Create an HTML file for each page.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_word_to_html_external/pdf_page_{0}.html", "render_word_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_word_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_to_html_external()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-word-documents/render-to-html-external-resources.png)

## Render Word documents as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Word file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_word_to_pdf():
    # Load Word document
    with Viewer("sample.docx") as viewer:
        # Create a PDF file for the document.
        # Specify the PDF file name.
        viewOptions = PdfViewOptions("render_word_to_pdf/word_document.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_to_pdf()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Word file to PDF](/viewer/python-net/images/rendering-basics/render-word-documents/render-to-pdf.png)

## Render Word documents as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Word file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_word_to_png():
    # Load Word document
    with Viewer("sample.docx") as viewer:
        # Create a PNG image for each document page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_word_to_png/word_page_0_{0}.png")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_to_png()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Word file to PNG](/viewer/python-net/images/rendering-basics/render-word-documents/render-to-png-image.png)

## Render Word documents as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Word file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_word_to_jpg():
    # Load Word document
    with Viewer("sample.docx") as viewer:
        # Create a JPG image for each document page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = JpgViewOptions("render_word_to_jpg/word_to_jpg_{0}.jpg")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_to_jpg()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Define page margins

Use the following methods to specify the size of page margins in the output files when you convert your Word documents to HTML, PDF, and image formats: 

* [WordProcessingOptions.top_margin](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/wordprocessingoptions/#properties) specifies the distance (in points) between document content and the top edge of the page.
* [WordProcessingOptions.bottom_margin](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/wordprocessingoptions/#properties) specifies the distance (in points) between document content and the bottom edge of the page.
* [WordProcessingOptions.left_margin](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/wordprocessingoptions/#properties) specifies the distance (in points) between document content and the left edge of the page.
* [WordProcessingOptions.right_margin](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/wordprocessingoptions/#properties) specifies the distance (in points) between document content and the right edge of the page.

You can access these methods for the following classes:

* [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods)
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/) 

The example below converts a Word document to HTML and specifies page margins for the output file. 

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_word_with_margins():
    # Load Word document
    with Viewer("sample.docx") as viewer:
        # Create an HTML file for each document page.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_word_with_margins/word_with_margins_{0}.html")
        # Specify the size of page margins in points.
        viewOptions.word_processing_options.left_margin = 54.0
        viewOptions.word_processing_options.right_margin = 54.0
        viewOptions.word_processing_options.top_margin = 72.0
        viewOptions.word_processing_options.bottom_margin = 72.0
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_with_margins()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render tracked changes

GroupDocs.Viewer does not render tracked changes (revisions made to a Word document) by default. If you want to display tracked changes in the output file, use the [WordProcessingOptions.render_tracked_changes](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/wordprocessingoptions/#properties) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/) 

The following code example demonstrates how to render a Word document with tracked changes:

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_word_with_tracked_changes():
    # Load Word document
    with Viewer("with_tracked_changes.docx") as viewer:
        # Convert the document to PDF.
        viewOptions = PdfViewOptions("render_word_with_tracked_changes/word_with_tracked_changes.pdf")
        # Enable tracked changes rendering.
        viewOptions.word_processing_options.render_tracked_changes = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_with_tracked_changes()
```
{{< /tab >}}
{{< tab "with_tracked_changes.docx" >}}
{{< tab-text >}}
`with_tracked_changes.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/with_tracked_changes.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render tracked changes to PDF](/viewer/python-net/images/rendering-basics/render-word-documents/render-track-changes-to-pdf.png)

## Render comments

Use the [ViewOptions.render_comments](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/#properties) method for a target view to display comments in the output file when you convert your document to HTML, PDF, PNG, or JPEG format.

The code example below renders a Word document with comments to PDF.

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_word_with_comments():
    # Load Word document
    with Viewer("with_comment.docx") as viewer:
        # Convert the document to PDF.
        viewOptions = PdfViewOptions("render_word_with_comments/word_with_comments.pdf")
        # Enable rendering comments.
        viewOptions.render_comments = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_word_with_comments()
```
{{< /tab >}}
{{< tab "with_comment.docx" >}}
{{< tab-text >}}
`with_comment.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-word-documents/with_comment.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render comments to PDF](/viewer/python-net/images/rendering-basics/render-word-documents/render-comments-to-pdf.png)

---

## Reorder pages

Path: /viewer/java/reorder-pages/

GroupDocs.Viewer preserves the page order in the source document. Instead, you may reorder pages in the output PDF document.

To reorder pages, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object.
2. Create the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) object.
3. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method of the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) class. Specify the new page order in the last parameters.

The following code snippet shows how to reorder pages:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions();

    // Pass page numbers in the order you want to render them.                                     
    viewer.view(viewOptions, 2, 1);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Reorder pages

Path: /viewer/net/reorder-pages/

GroupDocs.Viewer preserves the page order in the source document. Instead, you may reorder pages in the output PDF document.

To reorder pages, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object.
2. Create the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) object.
3. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method of the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify the new page order in the last parameters.

The following code snippet shows how to reorder pages:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer;
// ...

using (Viewer viewer = new Viewer("sample.docx"))            
{     
    // Create view options.
    PdfViewOptions viewOptions = new PdfViewOptions();

    // Pass page numbers in the order you want to render them.                
    viewer.View(viewOptions, 2, 1);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create view options.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()

            ' Pass page numbers in the order you want to render them.                
            viewer.View(viewOptions, 2, 1)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Reorder pages

Path: /viewer/python-net/reorder-pages/

GroupDocs.Viewer preserves the page order in the source document. Instead, you may reorder pages in the output PDF document.

To reorder pages, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) object.
2. Create the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) object.
3. Call the [view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method of the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) object. Specify the new page order in the last parameters.

The following code snippet shows how to reorder pages:

{{< tabs "example1">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def reorder_pages():
    # Load document
    with Viewer("sample.docx") as viewer:
        # Create view options.
        viewOptions = PdfViewOptions("reorder_pages/reordered_pages.pdf")

        # Pass page numbers in the order you want to render them.
        viewer.view(viewOptions, [2, 1])

if __name__ == "__main__":
    reorder_pages()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/reorder-pages/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Save a modified file to the original source

Path: /metadata/java/save-a-modified-file-to-the-original-source/

This example shows how to save the modified content to the underlying file.

**advanced\_usage.saving\_files.SaveFileToOriginalSource**

```csharp
// Constants.InputPpt is an absolute or relative path to your document. Ex: @"C:\Docs\test.ppt"
File outputFile = new File(Constants.OutputPpt);
outputFile.delete();
Files.copy(new File(Constants.InputPpt).toPath(), outputFile.toPath());

try (Metadata metadata = new Metadata(Constants.OutputPpt)) {
	// Edit or remove metadata here
	// Saves the document to the underlying file
	metadata.save();
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Save a modified file to the original source

Path: /metadata/net/save-a-modified-file-to-the-original-source/

This example shows how to save the modified content to the underlying source.

**AdvancedUsage.SavingFiles.SaveFileToOriginalSource**

```csharp
// Constants.InputPpt is an absolute or relative path to your document. Ex: @"C:\Docs\test.ppt"
using (Metadata metadata = new Metadata(Constants.OutputPpt))
{
	// Edit or remove metadata here

	// Saves the document to the underlying source (stream or file)
	metadata.Save();
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Save a modified file to the original source

Path: /metadata/python-net/save-a-modified-file-to-the-original-source/

This example shows how to save the modified content to the underlying source.

**advanced_usage.saving_files.save_file_to_original_source**


```python
def run():
    # constants.output_ppt is an absolute or relative path to your document. Ex: r"C:\\Docs\\test.ppt"
    with gm.Metadata(constants.output_ppt) as metadata:
        # Edit or remove metadata here
        # ...

        # Saves the document to the underlying source (stream or file)
        metadata.save()
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Save document to the specified location

Path: /watermark/java/save-document-to-the-specified-location/

Following code shows usage of [save(String)](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#save(java.lang.String)) method.

**advanced\_usage.saving\_documents.SaveDocumentToTheSpecifiedLocation**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\test.doc"
Watermarker watermarker = new Watermarker("test.doc");                                  
                                                                                                 
// watermarking goes here                                                                        
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));            
watermarker.add(watermark);                                                                      
                                                                                                 
// Saves the document to the specified location                                                  
watermarker.save("test.doc");                                                          
                                                                                                 
watermarker.close();                                                                             
```

---

## Save file to local disk

Path: /conversion/net/save-file-to-local-disk/

To save the conversion results to a local disk, use the [Convert(string filePath, ConvertOptions convertOptions)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_16) implementation of the [Convert()](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/) method. This implementation accepts the path of the output file and converter options as parameters.

File path can be absolute or relative. If the resulting file does not exist, it will be created.

The following code snippet shows how to save a file to a local disk:

```csharp
public static void Run()
{
    // Specify source file location
    using (Converter converter = new Converter("c:\\files\\sample.docx")) 
    {
        PdfConvertOptions options = new PdfConvertOptions();
        // Specify output file location
        converter.Convert("c:\\files\\converted.pdf", options);
    }
}
```

You can also use the [ConvertTo(string fileName)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.fluent/iconversionto/convertto/#convertto_2) [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}}) method to save a file to a local disk:

```csharp
public static void Run()
{
FluentConverter
    // Specify source file location
    .Load("c:\\files\\sample.docx")
    // Specify output file location
    .ConvertTo("c:\\files\\converted.pdf")
    .Convert();
}
```

---

## Save image as base64

Path: /markdown/net/as-base64-strategy/


By default, `ConvertOptions` uses `ExportImagesAsBase64Strategy`, which embeds images as Base64 data URIs directly in the Markdown output. This keeps the output self-contained in a single file with no external image dependencies.

### Using static method

{{< tabs "base64-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Default behavior -- images are embedded as Base64
MarkdownConverter.ToFile("business-plan.pdf", "base64-static.md");
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "base64-static.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAIAAADHHcVbAAAAA3NCSVQICAjb4U/gAAAMWElEQVR4nO3dUWzV130H8L+nSnsgxYTa5kbEnhJgJpJ98aQseTAxUaoiW1RDSiseykoCNE9boyoIZEWLVImosoZSpeve0Ighax4iDRRpky02oWKbh2aVCralhGBANSAu4Lq5NJ60tz0c8t/lf6/h2jjg/M/nIz8c7v/v3z345atz/v9zTkNpaiwBgFj92aPuAAA8SoIQgKgJQgCiJggBiNo3Mv/+53/9r4tXbi6u1t/v/Pa6tjXzXV1cZTXVVFNNNdVc2poZ2SCcmr4xfv7KQr8y+NPc/97j6uIqq6mmmmqqqebS1szIBuH6tjUNDQ0Xp2988T8LqAIAX1NLOSIEgK+dhsyC+p/87FdpEP7dzm+va613jjVJkvVtax5b8efzXb04fWNBY1U11VRTTTXVXJ
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/as-base64-strategy/Base64Static/base64-static.md)
{{< /tab >}}
{{< /tabs >}}

### Specifying the strategy explicitly

If you want to be explicit, set `ImageExportStrategy` to a new `ExportImagesAsBase64Strategy`:

{{< tabs "base64-explicit">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    ImageExportStrategy = new ExportImagesAsBase64Strategy()
};

using var converter = new MarkdownConverter("business-plan.pdf");
converter.Convert("base64-explicit.md", options);
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "base64-explicit.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAIAAADHHcVbAAAAA3NCSVQICAjb4U/gAAAMWElEQVR4nO3dUWzV130H8L+nSnsgxYTa5kbEnhJgJpJ98aQseTAxUaoiW1RDSiseykoCNE9boyoIZEWLVImosoZSpeve0Ighax4iDRRpky02oWKbh2aVCralhGBANSAu4Lq5NJ60tz0c8t/lf6/h2jjg/M/nIz8c7v/v3z345atz/v9zTkNpaiwBgFj92aPuAAA8SoIQgKgJQgCiJggBiNo3Mv/+53/9r4tXbi6u1t/v/Pa6tjXzXV1cZTXVVFNNNdVc2poZ2SCcmr4xfv7KQr8y+NPc/97j6uIqq6mmmmqqqebS1szIBuH6tjUNDQ0Xp2988T8LqAIAX1NLOSIEgK+dhsyC+p/87FdpEP7dzm+va613jjVJkvVtax5b8efzXb04fWNBY1U11VRTTTXVXJ
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/as-base64-strategy/Base64Explicit/base64-explicit.md)
{{< /tab >}}
{{< /tabs >}}

---

## Save image as base64

Path: /markdown/python-net/as-base64-strategy/


By default, `ConvertOptions` uses `ExportImagesAsBase64Strategy`, which embeds images as Base64 data URIs directly in the Markdown output. This keeps the output self-contained in a single file with no external image dependencies.

### Using static method

{{< tabs "base64-static">}}
{{< tab "base64_static.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def base64_static():
    """Convert a PDF to Markdown with images embedded as Base64 (default behavior)."""

    # Step 1: Convert the document -- images are embedded as Base64 by default
    markdown = MarkdownConverter.to_markdown("business-plan.pdf")

    # Step 2: Print the self-contained Markdown output
    print(markdown)

if __name__ == "__main__":
    base64_static()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "base64-static.txt" >}}  
```text
![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAHyAqYDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAABQYABAcIAwEJAv/EAGoQAAACBAoGBwMHBQkNBQYFBQEDAAQFERMhMUFRYXGBofAGFJGxweEHFSMkMzTRQ0TxAhYlNVJUghJFVWR0JjZCU2NldYSiCBciMkZWYmaFkpSy4naGlbTCc5akpcXSN7XE1eZyprbG1P/EABwBAAMAAwEBAQAAAAAAAAAAAAAEBQEDBgIHCP/EAD8RAAIAA
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/as-base64-strategy/base64_static/base64-static.txt)
{{< /tab >}}
{{< tab "base64-static.txt" >}}  
```text
![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAHyAqYDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAABQYABAcIAwEJAv/EAGoQAAACBAoGBwMHBQkNBQYFBQEDAAQFERMhMUFRYXGBofAGFJGxweEHFSMkMzTRQ0TxAhYlNVJUghJFVWR0JjZCU2NldYSiCBciMkZWYmaFkpSy4naGlbTCc5akpcXSN7XE1eZyprbG1P/EABwBAAMAAwEBAQAAAAAAAAAAAAAEBQEDBgIHCP/EAD8RAAIAA
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/as-base64-strategy/base64_static/base64-static.txt)
{{< /tab >}}
{{< /tabs >}}

### Specifying the strategy explicitly

If you want to be explicit, set `image_export_strategy` to a new `ExportImagesAsBase64Strategy`:

{{< tabs "base64-explicit">}}
{{< tab "base64_explicit.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, ExportImagesAsBase64Strategy

def base64_explicit():
    """Explicitly set the Base64 image strategy and convert using the instance API."""

    # Step 1: Explicitly configure the Base64 image export strategy
    options = ConvertOptions()
    options.image_export_strategy = ExportImagesAsBase64Strategy()

    # Step 2: Open the document with a context manager
    with MarkdownConverter("business-plan.pdf") as converter:
        # Step 3: Convert using keyword argument for options
        converter.convert("base64-explicit.md", convert_options=options)

if __name__ == "__main__":
    base64_explicit()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "base64-explicit.txt" >}}  
```text
![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAHyAqYDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAABQYABAcIAwEJAv/EAGoQAAACBAoGBwMHBQkNBQYFBQEDAAQFERMhMUFRYXGBofAGFJGxweEHFSMkMzTRQ0TxAhYlNVJUghJFVWR0JjZCU2NldYSiCBciMkZWYmaFkpSy4naGlbTCc5akpcXSN7XE1eZyprbG1P/EABwBAAMAAwEBAQAAAAAAAAAAAAAEBQEDBgIHCP/EAD8RAAIAA
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/as-base64-strategy/base64_explicit/base64-explicit.txt)
{{< /tab >}}
{{< tab "base64-explicit.txt" >}}  
```text
![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAHyAqYDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAABQYABAcIAwEJAv/EAGoQAAACBAoGBwMHBQkNBQYFBQEDAAQFERMhMUFRYXGBofAGFJGxweEHFSMkMzTRQ0TxAhYlNVJUghJFVWR0JjZCU2NldYSiCBciMkZWYmaFkpSy4naGlbTCc5akpcXSN7XE1eZyprbG1P/EABwBAAMAAwEBAQAAAAAAAAAAAAAEBQEDBgIHCP/EAD8RAAIAA
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/as-base64-strategy/base64_explicit/base64-explicit.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Save in original format

Path: /redaction/java/save-in-original-format/

The following example demonstrates how to save file in its original format with current date as a suffix:



```java
final Redactor redactor = new Redactor("sample.docx");
try 
{
    // Here we can use document instance to perform redactions
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    SaveOptions saveOptions = new SaveOptions();
    saveOptions.setAddSuffix(true);
    saveOptions.setRasterizeToPDF(false);
    saveOptions.setRedactedFileSuffix(new SimpleDateFormat("dd-MM-yyyy").format(new Date()));
    // Saving in original format with date as DateTime.getNow().toShortDateString()a suffix
    redactor.save(saveOptions);
}
finally { redactor.close(); }
```

---

## Save in original format

Path: /redaction/net/save-in-original-format/

The following example demonstrates how to save file in its original format with current date as a suffix:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Here we can use document instance to perform redactions
    redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    // Saving in original format with date as a suffix
    redactor.Save(new SaveOptions() { AddSuffix = true, RasterizeToPDF = false, RedactedFileSuffix = DateTime.Now.ToShortDateString() });
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save in original format

Path: /redaction/python-net/save-in-original-format/

The following example demonstrates how to save file in its original format with current date as a suffix:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
from datetime import datetime

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        date_time_str = datetime.now().strftime("%Y-%m-%d %H-%M-%S")
        so.redacted_file_suffix = date_time_str

        result_path = redactor.save(so)
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save signed document with password

Path: /signature/java/save-signed-document-with-password/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class supports saving signed document with password protection. This ability is supported over [setPassword](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SaveOptions#setPassword(java.lang.String)) property of [SaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SaveOptions) class that should be passed to [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method.

Here are the steps to protect signed document with password with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate required signature options.    
*   Instantiate the [SaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SaveOptions) object and specify [setPassword](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SaveOptions#setPassword(java.lang.String)) property with required password string.      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signatureoptions and [SaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SaveOptions) object to it.
    
Following example demonstrates how to save signed document with password.

```java
Signature signature = new Signature("sample.pdf");
// create QRCode option with predefined QRCode text
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
SaveOptions saveOptions = new SaveOptions();
saveOptions.setPassword("1234567890");
saveOptions.setUseOriginalPassword(false);
 
// sign document to file
signature.sign("SignedProtected.pdf", signOptions, saveOptions);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Saving a File to Local Disk

Path: /conversion/java/save-file-to-local-disk/

To save the conversion results to a local disk, you can use the [convert(String filePath, ConvertOptions convertOptions)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#convert-java.lang.String-com.groupdocs.conversion.options.convert.ConvertOptions-) method. This implementation requires two parameters:

- `filePath` – The path where the output file will be saved. It can be an **absolute path** (e.g., *C:\\files\\converted.pdf)* or a **relative path** (e.g., *converted.pdf*).
- `convertOptions` – Options specifying the conversion settings, such as the output format or specific configurations related to the conversion process.

{{< alert style="note" >}}
- If the specified output file does not exist, it will be automatically created.
- If the file already exists, it may be overwritten unless specified otherwise in the options.
{{< /alert >}}

The following code snippet demonstrates how to convert a Word document (`.docx`) to a PDF file and save it to a specified directory on your local disk:

{{< tabs "code-example">}}
{{< tab "ConvertDocxToPdf.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class ConvertDocxToPdf {
    public static void convert() {
        // Specify the source file location
        Converter converter = new Converter("c:\\files\\business-plan.docx");
        
        // Define conversion options (in this case, converting to PDF)
        PdfConvertOptions options = new PdfConvertOptions();
    
        // Specify the output file location and perform the conversion
        converter.convert("c:\\files\\business-plan.pdf", options);
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/save-file-to-local-disk/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/save-file-to-local-disk/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation:
- **Source File Specification**:
The `Converter` object is initialized with the path to the source document (`business-plan.docx`).
- **Conversion Options**:
The `PdfConvertOptions` object is created to configure settings specific to PDF conversion. Depending on the library you are using, you may have options to customize aspects such as page size, orientation, or compression.
- **Saving the Converted File**:
The `convert()` method is called with the desired output file path (`c:\\files\\business-plan.pdf`) and the conversion options (`options`). The file will be saved in the specified directory.
---

## Scatter Chart in Word Processing Document

Path: /assembly/java/scatter-chart-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Scatter Chart in Microsoft Word Document

### Creating a Scatter Chart

Please follow below to create Scatter Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "XY (Scatter)".
3.  Preview "Scatter" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/scatter-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to show contract prices by month with the following key requirements:

*   Report must show information on a Scatter Chart.
*   It must indicate total contract prices by month.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>>
```

#### Chart Data (Excel)

| X-Values | Total Contract Price<<x [key + 1]>><<y [sum(c => c.getPrice())]>> |
| -------- | ------------------------------------------------------------ |
| 0.7      | 2.7                                                          |
| 1.8      | 3.2                                                          |
| 2.6      | 0.8                                                          |

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Scatter%20Chart.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 2b9e00fd18299d0e72191eb34c3747ec >}}

## Scatter Chart in OpenOffice Document

To be investigated.

---

## Scatter Chart in Word Processing Document

Path: /assembly/net/scatter-chart-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Scatter Chart in Microsoft Word Document

### Creating a Scatter Chart

Please follow below to create Scatter Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "XY (Scatter)".
3.  Preview "Scatter" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/scatter-chart-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to show your customers' orders prices by month with the following key requirements:

*   Report must show information on a Scatter Chart.
*   It must indicate Price of each order by month.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>>
```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">X-Values</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total Order Price&lt;&lt;x [Key]&gt;&gt;&lt;&lt;y [Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">0.7</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.7</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.6</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">0.8</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Scatter%20Chart.docx?raw=true) (Template for CustomObject and JSON examples) 
*   [Scatter Chart\_DB.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Scatter%20Chart_DB.docx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists b58d5e3a7c0e77704179853f00317eac >}}



#### Database Entities

{{< gist GroupDocsGists 9c75e081b2cfd9eec842eb74579371d9 >}}



#### Using DataSet

{{< gist GroupDocsGists c6d4141de31053cd4dbc0103655af031 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 88ca4c9e5703ac2f0fb7d861bcc1d296 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 15874464e2f9cb850e6531e3c17fc35f >}}



## Scatter Chart in OpenOffice Document

To be investigated.

---

## Search for embedded object with custom encryption of Metadata signatures

Path: /signature/java/search-for-embedded-object-with-custom-encryption-of-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides additional features when searching for Metadata Signatures that were previously encrypted and have embedded data objects. 
*   ability to search for embedded custom objects into metadata and decrypt them to original source values
*   ability to search for encrypted text of metadata signature and decrypt it        

Here are the steps to search and decrypt previously encrypted text of metadata and decrypt custom object from metadata signature ([MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature)) with GroupDocs.Signature API:
*   Implement custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default Signature has several encryption implementation you can use but allows user to customize it. There's ability to specify inline encryption to use
*   Define class with proper DataSerialization attribute      
*   Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) object value     
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions)  to it.    
*   Process each Metadata signature ([MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature)) and set property [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) to specify data encryption and call [getData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#getData(java.lang.Class)) method to retrieve object 
    

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
public class CustomXOREncryption implements IDataEncryption
{
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final int getKey(){ return auto_Key; }
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final void setKey(int value){ auto_Key = value; }
    private int auto_Key;
 
    /**
     * <p>
     * Encode method to encrypt string.
     * </p>
     * @return Returns enccrypted string
     * @param source Source string to encode.
     */
    public final String encode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Decode method to obtain decrypted string.
     * </p>
     * @return Returns decrypted string
     * @param source Source string to decode.
     */
    public final String decode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Using XOR operation get encoded / decoded string
     * </p>
     * @return
     * @param source
     */
    private String process(String source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.length());
        char chTmp;
        for (int index = 0; index < src.length(); ++index)
        {
            chTmp = src.charAt(index);
            chTmp = (char)(chTmp ^ this.getKey());
            dst.append(chTmp);
        }
        return dst.toString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```java
public static class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Search for embedded custom objects in metadata signatures

 This example shows how to decrypt previously embedded encrypted custom objects into metadata signature. [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) contains method [getData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#getData(java.lang.Class)) to retrieve object

```java
Signature signature = new Signature("MetadataCustomEncryptionObject.docx");
 
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
MetadataSearchOptions options = new MetadataSearchOptions();
options.setDataEncryption(encryption);
 
 
// search for signatures in document
List<WordProcessingMetadataSignature> signatures = signature.search(WordProcessingMetadataSignature.class,options);
System.out.print("\nSource document contains following signatures.");
// get required metadata signatures
WordProcessingMetadataSignature wordSignature = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("Signature")) {
        wordSignature = mdSign;
        break;
    }
}
if (wordSignature != null)
{
    DocumentSignatureData documentSignatureData = wordSignature.getData(DocumentSignatureData.class);
    if (documentSignatureData != null)
    {
        System.out.print("Signature has DocumentSignatureData object:\n ID = " + documentSignatureData.getID() + ", Author = " + documentSignatureData.getAuthor() + ", Signed = " + documentSignatureData.getSigned() + ", DataFactor " +documentSignatureData.getDataFactor());
    }
}
// get required metadata signatures
WordProcessingMetadataSignature mdAuthor = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("Author")) {
        mdAuthor = mdSign;
        break;
    }
}
if (mdAuthor != null)
{
    System.out.print("Metadata signature found. Name : "+mdAuthor.getName()+". Value: "+ mdAuthor.getData(String.class));
}
// get required metadata signatures
WordProcessingMetadataSignature mdDocId = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("DocumentId")) {
        mdDocId = mdSign;
        break;
    }
}
if (mdDocId != null)
{
    System.out.print("Metadata signature found. Name : "+mdDocId.getName()+ ". Value: " + mdDocId.getData(String.class));
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for embedded object with custom encryption of Metadata signatures

Path: /signature/net/search-for-embedded-object-with-custom-encryption-of-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides additional features when searching for Metadata Signature that were previously encrypted and have embedded data objects.

* ability to search for embedded custom objects into metadata and decrypt them to original source values
* ability to search for encrypted text of metadata signature and decrypt it  
  
Here are the steps to search and decrypt previously encrypted text of metadata and decrypt custom object from metadata signature ([MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature)) with GroupDocs.Signature API:

* Implement custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default Signature has several encryption implementation you can use but allows user to customize it. There's ability to specify inline encryption to use
* Define class with proper DataSerialization attribute  
* Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) object value
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) to it.
* Process each Metadata signature ([MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature)) and set property [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions/dataencryption) to specify data encryption and call [GetData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/getdata) method to retrieve object

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
// Define class that implements IDataEncryption interface
private class CustomXOREncryption : IDataEncryption
{
    /// <summary>
    /// Gets or sets non empty key for encryption (at least one character)
    /// </summary>
    public int Key { get; set; }
    /// <summary>
    /// Encode method to encrypt string.
    /// </summary>
    /// <param name="source">Source string to encode.</param>
    /// <returns>Returns enccrypted string</returns>
    public string Encode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Decode method to obtain decrypted string.
    /// </summary>
    /// <param name="source">Source string to decode.</param>
    /// <returns>Returns decrypted string</returns>
    public string Decode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Using XOR operation get encoded / decoded string
    /// </summary>
    /// <param name="source"></param>
    /// <returns></returns>
    private string Process(string source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.Length);
        char chTmp;
        for (int index = 0; index < src.Length; ++index)
        {
            chTmp = src[index];
            chTmp = (char)(chTmp ^ this.Key);
            dst.Append(chTmp);
        }
        return dst.ToString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
// setup CustomSerialization Attribute to setup customer serialization(see example above)
[CustomSerialization]
private class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Search for embedded custom objects in metadata signatures

 This example shows how to decrypt previously embedded encrypted custom objects into metadata signature. [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) contains method [GetData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/getdata) to retrieve object

```csharp
using (Signature signature = new Signature("MetadataCustomEncryptionObject.docx"))
{
    // create data encryption
    IDataEncryption encryption = new CustomXOREncryption();
    MetadataSearchOptions options = new MetadataSearchOptions()
    {
        DataEncryption = encryption
    };
    // search for signatures in document
    List<WordProcessingMetadataSignature> signatures = signature.Search<WordProcessingMetadataSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    // get required metadata signatures
    WordProcessingMetadataSignature mdSignature = signatures.FirstOrDefault(p => p.Name == "Signature");
    if (mdSignature != null)
    {
        DocumentSignatureData documentSignatureData = mdSignature.GetData<DocumentSignatureData>();
        if (documentSignatureData != null)
        {
            Console.WriteLine("Signature has DocumentSignatureData object:\n ID = {0}, Author = {1}, Signed = {2}, DataFactor {3}",
                documentSignatureData.ID, documentSignatureData.Author, documentSignatureData.Signed.ToShortDateString(), documentSignatureData.DataFactor);
        }
    }
    // get required metadata signatures
    WordProcessingMetadataSignature mdAuthor = signatures.FirstOrDefault(p => p.Name == "Author");
    if (mdAuthor != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdAuthor.Name, mdAuthor.GetData<string>());
    }
    // get required metadata signatures
    WordProcessingMetadataSignature mdDocId = signatures.FirstOrDefault(p => p.Name == "DocumentId");
    if (mdDocId != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdDocId.Name, mdDocId.GetData<string>());
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for embedded object with custom encryption of QR Code signatures

Path: /signature/net/search-for-embedded-object-with-custom-encryption-of-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides following abilities to search for embedded data objects in QR-code signatures ([QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature)) that were encrypted with custom encryption.  

* ability to search for embedded custom objects into metadata and decrypt them to original source values
* ability to search for custom encrypted QR-code signature and decrypt it  

Here are the steps to search and decrypt previously encrypted text of QR-Code and decrypt custom object from QR-Code signature with GroupDocs.Signature API:

* Implement (use) custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface.
* Create instance of custom encryption object
* Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object and setup [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions/dataencryption) value with custom encryption object implementation
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) to it.

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
// Define class that implements IDataEncryption interface
// Class could inherits Attribute to use it with class definition

public class CustomXOREncryption : IDataEncryption
{
    /// <summary>
    /// Gets or sets non empty key for encryption (at least one character)
    /// </summary>
    public int Key { get; set; }
    /// <summary>
    /// Encode method to encrypt string.
    /// </summary>
    /// <param name="source">Source string to encode.</param>
    /// <returns>Returns enccrypted string</returns>
    public string Encode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Decode method to obtain decrypted string.
    /// </summary>
    /// <param name="source">Source string to decode.</param>
    /// <returns>Returns decrypted string</returns>
    public string Decode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Using XOR operation get encoded / decoded string
    /// </summary>
    /// <param name="source"></param>
    /// <returns></returns>
    private string Process(string source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.Length);
        char chTmp;
        for (int index = 0; index < src.Length; ++index)
        {
            chTmp = src[index];
            chTmp = (char)(chTmp ^ this.Key);
            dst.Append(chTmp);
        }
        return dst.ToString();
    }
}
```

## Definition of class

This example shows how to define custom class for serialization.

```csharp
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Search for embedded custom objects in QR-code signatures

This example shows how to decrypt previously embedded encrypted custom objects into [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) contains method [GetData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature/getdata) to retrieve object

```csharp
// instantiating the signature object
using (Signature signature = new Signature("signed.pdf"))
{
    // setup search options
    QrCodeSearchOptions searchOptions = new QrCodeSearchOptions();
    // specify as true to search all pages of a document
    searchOptions.AllPages = true;
    searchOptions.DataEncryption = new CustomXOREncryptionAttribute();
    // search document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(searchOptions);
    // output signatures
    foreach (QrCodeSignature qrCodeSignature in signatures)
    {
        if (qrCodeSignature != null)
        {
            DocumentSignatureData docSignature = qrCodeSignature.GetData<DocumentSignatureData>();
            if (docSignature != null)
            {
                Console.WriteLine("Found DocumentSignature: #{0} by {1} from {2} DataFactor = {3}", docSignature.ID,
                    docSignature.Author, docSignature.Signed, docSignature.DataFactor.ToString("N2"));
            }
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for embedded object with custom encryption of QR-code signatures

Path: /signature/java/search-embed-obj-with-custom-encr-qr-codes/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides following abilities to search for embedded data objects in QR-code signatures ([QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature)) that were encrypted with custom encryption.  
*   ability to search for embedded custom objects into metadata and decrypt them to original source values
*   ability to search for custom encrypted QR-code signature and decrypt it  

Here are the steps to search and decrypt previously encrypted text of QR-Code and decrypt custom object from QR-Code signature with GroupDocs.Signature API:

*   Implement (use) custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface.    
*   Create instance of custom encryption object      
*   Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object and setup [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) value with custom encryption object implementation      
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) to it.
    

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
public class CustomXOREncryption implements IDataEncryption
{
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final int getKey(){ return auto_Key; }
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final void setKey(int value){ auto_Key = value; }
    private int auto_Key;
 
    /**
     * <p>
     * Encode method to encrypt string.
     * </p>
     * @return Returns enccrypted string
     * @param source Source string to encode.
     */
    public final String encode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Decode method to obtain decrypted string.
     * </p>
     * @return Returns decrypted string
     * @param source Source string to decode.
     */
    public final String decode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Using XOR operation get encoded / decoded string
     * </p>
     * @return
     * @param source
     */
    private String process(String source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.length());
        char chTmp;
        for (int index = 0; index < src.length(); ++index)
        {
            chTmp = src.charAt(index);
            chTmp = (char)(chTmp ^ this.getKey());
            dst.append(chTmp);
        }
        return dst.toString();
    }
}
```

## Definition of class

This example shows how to define custom class for serialization.

```java
public static class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Search for embedded custom objects in QR-code signatures

This example shows how to decrypt previously embedded encrypted custom objects into [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) contains method [getData](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/QrCodeSignature#getData(java.lang.Class)) to retrieve object

```java
Signature signature = new Signature("signed.pdf");
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
QrCodeSearchOptions options = new QrCodeSearchOptions();
 
// specify special pages to search on
options.setAllPages(true);
options.setDataEncryption(encryption);
 
 
// search for signatures in document
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class,options);
System.out.print("\nSource document contains following signatures:");
for (QrCodeSignature qrCodeSignature : signatures)
{
    System.out.print("QRCode signature found at page "+qrCodeSignature.getPageNumber()+" with type "+ qrCodeSignature.getEncodeType());
    DocumentSignatureData documentSignatureData = qrCodeSignature.getData(DocumentSignatureData.class);
    if (documentSignatureData != null)
    {
        System.out.print("QRCode signature has DocumentSignatureData object:\n ID = " + documentSignatureData.getID() + ", Author = " + documentSignatureData.getAuthor() + ", Signed = " + documentSignatureData.getSigned() + ", DataFactor "+documentSignatureData.getDataFactor());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search index events

Path: /search/java/search-index-events/

This page contains information about the purpose and use of all index events.

## OperationFinished event

The [OperationFinished](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#OperationFinished) event occurs when an index operation completes – indexing, updating, merging, deleting, or optimizing (segment merging). This event can be used to receive notification of the completion of an asynchronous operation. The following example demonstrates the use of the event.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().OperationFinished.add(new EventHandler<OperationFinishedEventArgs>() {
    public void invoke(Object sender, OperationFinishedEventArgs args) {
        System.out.println("Operation finished: " + args.getOperationType());
        System.out.println("Message: " + args.getMessage());
        System.out.println("Index folder: " + args.getIndexFolder());
        SimpleDateFormat df = new SimpleDateFormat("MM/dd/yyyy HH:mm:ss");
        System.out.println("Time: " + df.format(args.getTime()));
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
```

## ErrorOccurred event

The [ErrorOccured](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#ErrorOccurred) event occurs when an error happens in an index. Errors in an index can be caused, for example, by file system errors or unsupported formats of indexed documents. An example of receiving error notifications in the index is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
String query = "Einstein";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
    public void invoke(Object sender, IndexErrorEventArgs args) {
        System.out.println(args.getMessage());
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Searching in the index
SearchResult result = index.search(query);
```

## OperationProgressChanged event

The [OperationProgressChanged](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#OperationProgressChanged) event occurs when the progress of an indexing or updating operation changes. The example below demonstrates how to track the progress of an index operation.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().OperationProgressChanged.add(new EventHandler<OperationProgressEventArgs>() {
    public void invoke(Object sender, OperationProgressEventArgs args) {
        System.out.println("Last processed: " + args.getLastDocumentPath());
        System.out.println("Result: " + args.getLastDocumentStatus());
        System.out.println("Processed documents: " + args.getProcessedDocuments());
        System.out.println("Progress percentage: " + args.getProgressPercentage());
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
```

## OptimizationProgressChanged event

The [OptimizationProgressChanged](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#OptimizationProgressChanged) event occurs when the progress of an index optimization operation changes. The example below demonstrates how to track the progress of the index optimization operation.



```java
String indexFolder = "c:\\MyIndex\\";

// Opening an index
Index index = new Index(indexFolder);

// Subscribing to the event
index.getEvents().OptimizationProgressChanged.add(new EventHandler<OptimizationProgressEventArgs>() {
    public void invoke(Object sender, OptimizationProgressEventArgs args) {
        System.out.println("Processed segments: " + args.getProcessedSegments());
        System.out.println("Total segments: " + args.getTotalSegments());
        System.out.println("Progress percentage: " + args.getProgressPercentage());
    }
});

// Optimizing the index
index.optimize();
```

## PasswordRequired event

The [PasswordRequired](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#PasswordRequired) event occurs when an index requires a password to open a document. An example of processing this event is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().PasswordRequired.add(new EventHandler<PasswordRequiredEventArgs>() {
    public void invoke(Object sender, PasswordRequiredEventArgs args) {
        if (args.getDocumentFullPath().endsWith("ProtectedDocument.pdf")) {
            args.setPassword("123456");
        }
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
```

## FileIndexing event

The [FileIndexing](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#FileIndexing) event occurs immediately before the start of indexing a document. This event can be used for

*   Skipping indexing of the current document (see also [Document filtering during indexing]({{< ref "search/java/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}}) page);
*   Specifying the encoding of the current text document (see also [Text file encoding detection]({{< ref "search/java/developer-guide/advanced-usage/indexing/text-file-encoding-detection.md" >}}) page);
*   Specifying a custom text extractor for the current document (see also [Custom text extractors]({{< ref "search/java/developer-guide/advanced-usage/indexing/custom-text-extractors.md" >}}) page);
*   Setting additional arbitrary fields for the current document.

The following example demonstrates how to add additional fields to documents ending in "Protected.pdf" and how to skip indexing documents containing "important" text in their paths.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().FileIndexing.add(new EventHandler<FileIndexingEventArgs>() {
    public void invoke(Object sender, FileIndexingEventArgs args) {
        if (args.getDocumentFullPath().endsWith("Protected.pdf")) {
            args.setAdditionalFields(new DocumentField[] {
                new DocumentField("Tags", "Protected")
            });
        }
        if (!args.getDocumentFullPath().toLowerCase().contains("important")) {
            args.setSkipIndexing(true);
        }
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
```

## StatusChanged event

The [StatusChanged](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#StatusChanged) event occurs when an index status changes. The following example demonstrates how to use this event to notify the completion of an index operation.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().StatusChanged.add(new EventHandler<BaseIndexEventArgs>() {
    public void invoke(Object sender, BaseIndexEventArgs args) {
        if (args.getStatus() != IndexStatus.InProgress) {
            // A notification of the operation completion should be here
        }
    }
});
 
// Setting the flag for asynchronous indexing
IndexingOptions options = new IndexingOptions();
options.setAsync(true);
 
// Asynchronous indexing documents from the specified folder
// The method terminates before the operation completes
index.add(documentsFolder, options);
```

## SearchPhaseCompleted event

The [SearchPhaseCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#SearchPhaseCompleted) event occurs when a phase (or stage) of a search operation in an index completes. This event is used to study intermediate search results when tuning search queries. Information on the phases of different types of search is presented on the page [Search flow]({{< ref "search/java/developer-guide/advanced-usage/searching/search-flow.md" >}}). The following example demonstrates the use of this event.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Subscribing to the event
index.getEvents().SearchPhaseCompleted.add(new EventHandler<SearchPhaseEventArgs>() {
    public void invoke(Object sender, SearchPhaseEventArgs args) {
        System.out.println("Search phase: " + args.getSearchPhase());
        System.out.println("Words: " + args.getWords().length);
    }
});
 
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);
options.setUseWordFormsSearch(true);
options.getFuzzySearch().setEnabled(true);
options.setUseHomophoneSearch(true);
SearchResult result = index.search("Einstein", options);
```

## ImagePreparing event

The [ImagePreparing](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#ImagePreparing) event occurs immediately before adding indexed image to an index. The event can be used, for example, to save an image separately from its containing document, since it provides an image data stream. The following example demonstrates the use of this event.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";

// Creating an index
Index index = new Index(indexFolder);

// Subscribing to the event
index.getEvents().ImagePreparing.add(new EventHandler<ImagePreparingEventArgs>() {
    public void invoke(Object sender, ImagePreparingEventArgs args) {
        System.out.println("Document: " + args.getDocumentKey());
        System.out.println("Image inner path: " + String.join("/", args.getInnerPath()));
        System.out.println("Image index: " + args.getImageIndex());
        System.out.println("Image frames: " + args.getImageFrames().length);
    }
});

// Indexing files
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search index events

Path: /search/net/search-index-events/

This page contains information about the purpose and use of all index events.

## OperationFinished event

The [OperationFinished](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/operationfinished) event occurs when an index operation completes – indexing, updating, merging, or optimizing (segment merging). This event can be used to receive notification of the completion of an asynchronous operation. The following example demonstrates the use of the event.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.OperationFinished += (sender, args) =>
{
    // Writing operation details to the console
    Console.WriteLine("Operation finished: " + args.OperationType);
    Console.WriteLine("Message: " + args.Message);
    Console.WriteLine("Index folder: " + args.IndexFolder);
    Console.WriteLine("Time: " + args.Time);
};
 
// Indexing documents from the specified folder
IndexingOptions options = new IndexingOptions();
options.IsAsync = true; // Enabling asynchronous indexing mode
index.Add(documentsFolder, options);
```

## ErrorOccurred event

The [ErrorOccured](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/erroroccurred) event occurs when an error happens in an index. Errors in an index can be caused, for example, by file system errors or unsupported formats of indexed documents. An example of receiving error notifications in the index is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
string query = "Einstein";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.ErrorOccurred += (sender, args) =>
{
    // Writing an error message to the console
    Console.WriteLine(args.Message);
};
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Searching in the index
SearchResult result = index.Search(query);
```

## OperationProgressChanged event

The [OperationProgressChanged](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/operationprogresschanged) event occurs when the progress of an indexing or updating operation changes. The example below demonstrates how to track the progress of an index operation.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.OperationProgressChanged += (sender, args) =>
{
    Console.WriteLine("Last processed: " + args.LastDocumentPath);
    Console.WriteLine("Result: " + args.LastDocumentStatus);
    Console.WriteLine("Processed documents: " + args.ProcessedDocuments);
    Console.WriteLine("Progress percentage: " + args.ProgressPercentage);
};
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
```

## OptimizationProgressChanged event

The [OptimizationProgressChanged](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/optimizationprogresschanged) event occurs when the progress of an index optimization operation changes. The example below demonstrates how to track the progress of the index optimization operation.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";

// Opening an index
Index index = new Index(indexFolder);

// Subscribing to the event
index.Events.OptimizationProgressChanged += (sender, args) =>
{
    Console.WriteLine("Processed segments: " + args.ProcessedSegments);
    Console.WriteLine("Total segments: " + args.TotalSegments);
    Console.WriteLine("Progress percentage: " + args.ProgressPercentage);
};

// Optimizing the index
index.Optimize();
```

## PasswordRequired event

The [PasswordRequired](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/passwordrequired) event occurs when an index requires a password to open a document. An example of processing this event is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.PasswordRequired += (sender, args) =>
{
    if (args.DocumentFullPath.EndsWith("ProtectedDocument.pdf", StringComparison.InvariantCultureIgnoreCase))
    {
        args.Password = "123456";
    }
};
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
```

## FileIndexing event

The [FileIndexing](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/fileindexing) event occurs immediately before the start of indexing a document. This event can be used for

*   Skipping indexing of the current document (see also [Document filtering during indexing]({{< ref "search/net/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}}) page);
*   Specifying the encoding of the current text document (see also [Text file encoding detection]({{< ref "search/net/developer-guide/advanced-usage/indexing/text-file-encoding-detection.md" >}}) page);
*   Specifying a custom text extractor for the current document (see also [Custom text extractors]({{< ref "search/net/developer-guide/advanced-usage/indexing/custom-text-extractors.md" >}}) page);
*   Setting additional arbitrary fields for the current document..

The following example demonstrates how to add additional fields to documents ending in "Protected.pdf" and how to skip indexing documents containing "important" text in their paths.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.FileIndexing += (sender, args) =>
{
    if (args.DocumentFullPath.EndsWith("Protected.pdf", StringComparison.InvariantCultureIgnoreCase))
    {
        args.AdditionalFields = new DocumentField[]
        {
            new DocumentField("Tags", "Protected")
        };
    }
    if (!args.DocumentFullPath.ToLowerInvariant().Contains("important"))
    {
        args.SkipIndexing = true;
    }
};
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
```

## StatusChanged event

The [StatusChanged](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/statuschanged) event occurs when an index status changes. The following example demonstrates how to use this event to notify the completion of an index operation.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.StatusChanged += (sender, args) =>
{
    if (args.Status != IndexStatus.InProgress)
    {
        // A notification of the operation completion should be here
    }
};
 
// Setting the flag for asynchronous indexing
IndexingOptions options = new IndexingOptions();
options.IsAsync = true;
 
// Asynchronous indexing documents from the specified folder
// The method terminates before the operation completes
index.Add(documentsFolder, options);
```

## SearchPhaseCompleted event

The [SearchPhaseCompleted](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/searchphasecompleted) event occurs when a phase (or stage) of a search operation in an index completes. This event is used to study intermediate search results when tuning search queries. Information on the phases of different types of search is presented on the page [Search flow]({{< ref "search/net/developer-guide/advanced-usage/searching/search-flow.md" >}}). The following example demonstrates the use of this event.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Subscribing to the event
index.Events.SearchPhaseCompleted += (sender, args) =>
{
    Console.WriteLine("Search phase: " + args.SearchPhase);
    Console.WriteLine("Words: " + args.Words.Length);
    for (int i = 0; i < args.Words.Length; i++)
    {
        Console.WriteLine("\t" + args.Words[i]);
    }
    Console.WriteLine();
};
 
SearchOptions options = new SearchOptions();
options.UseSynonymSearch = true;
options.UseWordFormsSearch = true;
options.FuzzySearch.Enabled = true;
options.UseHomophoneSearch = true;
SearchResult result = index.Search("Einstein", options);
```

## ImagePreparing event

The [ImagePreparing](https://reference.groupdocs.com/search/net/groupdocs.search.events/eventhub/events/imagepreparing) event occurs immediately before adding indexed image to an index. The event can be used, for example, to save an image separately from its containing document, since it provides an image data stream. The following example demonstrates the use of this event.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating an index
Index index = new Index(indexFolder);

// Subscribing to the event
index.Events.ImagePreparing += (sender, args) =>
{
    Console.WriteLine("Document: " + args.DocumentKey);
    Console.WriteLine("Image inner path: " + string.Join("/", args.InnerPath));
    Console.WriteLine("Image index: " + args.ImageIndex);
    Console.WriteLine("Image frames: " + args.ImageFrames.Length);
};

// Indexing files
index.Add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search index events

Path: /search/nodejs-java/search-index-events/

This page contains information about the purpose and use of all index events.

## OperationFinished event

The [OperationFinished](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#OperationFinished) event occurs when an index operation completes – indexing, updating, merging, deleting, or optimizing (segment merging). This event can be used to receive notification of the completion of an asynchronous operation. The following example demonstrates the use of the event.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().OperationFinished.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log('Operation finished: ' + args.getOperationType());
      console.log('Message: ' + args.getMessage());
      console.log('Index folder: ' + args.getIndexFolder());
      const df = new SimpleDateFormat('MM/dd/yyyy HH:mm:ss');
      console.log('Time: ' + df.format(args.getTime()));
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);
```

## ErrorOccurred event

The [ErrorOccured](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#ErrorOccurred) event occurs when an error happens in an index. Errors in an index can be caused, for example, by file system errors or unsupported formats of indexed documents. An example of receiving error notifications in the index is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';
const query = 'Einstein';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().ErrorOccurred.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log(args.getMessage());
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Searching in the index
const result = index.search(query);
```

## OperationProgressChanged event

The [OperationProgressChanged](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#OperationProgressChanged) event occurs when the progress of an indexing or updating operation changes. The example below demonstrates how to track the progress of an index operation.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().OperationProgressChanged.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log('Last processed: ' + args.getLastDocumentPath());
      console.log('Result: ' + args.getLastDocumentStatus());
      console.log('Processed documents: ' + args.getProcessedDocuments());
      console.log('Progress percentage: ' + args.getProgressPercentage());
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);
```

## OptimizationProgressChanged event

The [OptimizationProgressChanged](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#OptimizationProgressChanged) event occurs when the progress of an index optimization operation changes. The example below demonstrates how to track the progress of the index optimization operation.

```javascript
const indexFolder = 'c:/MyIndex/';

// Opening an index
Index index = new Index(indexFolder);

// Subscribing to the event
index.getEvents().OptimizationProgressChanged.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log();
      console.log('Processed segments: ' + args.getProcessedSegments());
      console.log('Total segments: ' + args.getTotalSegments());
      console.log('Progress percentage: ' + args.getProgressPercentage());
    },
  }),
);

index.optimize();
```

## PasswordRequired event

The [PasswordRequired](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#PasswordRequired) event occurs when an index requires a password to open a document. An example of processing this event is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().PasswordRequired.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      if (args.getDocumentFullPath().endsWith('English.docx')) {
        args.setPassword('123456');
      } else if (args.getDocumentFullPath().endsWith('Lorem ipsum.docx')) {
        args.setPassword('123456');
      }
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);
```

## FileIndexing event

The [FileIndexing](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#FileIndexing) event occurs immediately before the start of indexing a document. This event can be used for

*   Skipping indexing of the current document (see also [Document filtering during indexing]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}}) page);
*   Specifying the encoding of the current text document (see also [Text file encoding detection]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/text-file-encoding-detection.md" >}}) page);
*   Specifying a custom text extractor for the current document (see also [Custom text extractors]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/custom-text-extractors.md" >}}) page);
*   Setting additional arbitrary fields for the current document.

The following example demonstrates how to add additional fields to documents ending in "Protected.pdf" and how to skip indexing documents containing "important" text in their paths.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
const additionalFields = java.newArray('com.groupdocs.search.common.DocumentField', [
  new groupdocs.search.DocumentField('Tags', 'Lorem'),
]);
index.getEvents().FileIndexing.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      if (args.getDocumentFullPath().endsWith('Lorem ipsum.docx')) {
        args.setAdditionalFields(additionalFields);
        console.log('Added field to: ' + args.getDocumentFullPath());
      }
      if (!args.getDocumentFullPath().toLowerCase().includes('lorem')) {
        args.setSkipIndexing(true);
        console.log('Skipped: ' + args.getDocumentFullPath());
      }
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);
```

## StatusChanged event

The [StatusChanged](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#StatusChanged) event occurs when an index status changes. The following example demonstrates how to use this event to notify the completion of an index operation.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().StatusChanged.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      if (
        String(args.getStatus()) == String(groupdocs.search.IndexStatus.Ready) ||
        String(args.getStatus()) == String(groupdocs.search.IndexStatus.Failed)
      ) {
        // A notification of the operation completion should be here
        console.log('Operation finished!');
      }
    },
  }),
);

// Setting the flag for asynchronous indexing
const options = new groupdocs.search.IndexingOptions();
options.setAsync(true);

// Asynchronous indexing documents from the specified folder
// The method terminates before the operation completes
index.add(documentsFolder, options);
```

## SearchPhaseCompleted event

The [SearchPhaseCompleted](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#SearchPhaseCompleted) event occurs when a phase (or stage) of a search operation in an index completes. This event is used to study intermediate search results when tuning search queries. Information on the phases of different types of search is presented on the page [Search flow]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-flow.md" >}}). The following example demonstrates the use of this event.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Subscribing to the event
index.getEvents().SearchPhaseCompleted.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log('Search phase: ' + args.getSearchPhase());
      console.log('Words: ' + args.getWords().length);
      const words = args.getWords();
      for (let i = 0; i <= words.length; i++) {
        const word = words[i];
        console.log('\t' + word);
      }
      console.log();
    },
  }),
);

const options = new groupdocs.search.SearchOptions();
options.setUseSynonymSearch(true);
options.setUseWordFormsSearch(true);
options.getFuzzySearch().setEnabled(true);
options.setUseHomophoneSearch(true);
const result = index.search('buy', options);
```

## ImagePreparing event

The [ImagePreparing](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#ImagePreparing) event occurs immediately before adding indexed image to an index. The event can be used, for example, to save an image separately from its containing document, since it provides an image data stream. The following example demonstrates the use of this event.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder, true);

// Subscribing to the event
index.getEvents().ImagePreparing.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log('Document: ' + args.getDocumentKey());
      console.log('Image index: ' + args.getImageIndex());
      console.log('Image frames: ' + args.getImageFrames().length);
    },
  }),
);

// Indexing files
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Searching watermarks

Path: /watermark/java/searching-watermarks/

## Searching possible watermarks 

GroupDocs.Watermark API allows you to search the possible watermarks placed in any document. You can also search the watermarks that are added using some third-party tool. The API provides [search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#search()) method to search watermarks in a whole document or in any part of the document. Following code snippet shows how to find and get all possible watermarks in a document.

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchWatermark**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
PossibleWatermarkCollection possibleWatermarks = watermarker.search();                                   
for (PossibleWatermark possibleWatermark : possibleWatermarks)                                           
{                                                                                                        
    if (possibleWatermark.getImageData() != null)                                                        
    {                                                                                                    
        System.out.println(possibleWatermark.getImageData().length);                                     
    }                                                                                                    
                                                                                                         
    System.out.println(possibleWatermark.getText());                                                     
    System.out.println(possibleWatermark.getX());                                                        
    System.out.println(possibleWatermark.getY());                                                        
    System.out.println(possibleWatermark.getRotateAngle());                                              
    System.out.println(possibleWatermark.getWidth());                                                    
    System.out.println(possibleWatermark.getHeight());                                                   
}                                                                                                        
                                                                                                         
watermarker.close();                                                                                     
```

## Search criteria

Usually, large documents may contain too many objects which can be considered as watermarks. Parameterless overload of [search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#search()) method returns only some of them, e.g. backgrounds or floating objects which could have been added during document post-processing. You can use [search criteria](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/SearchCriteria) to find objects with some specific parameters.

### Text search criteria

Following code snippet shows how to search for the watermarks that meet a particular [text criterion](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextSearchCriteria).

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchWatermarkWithSearchString**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
// Search by exact string                                                                                
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("© 2017");                                
                                                                                                         
// Find all possible watermarks containing some specific text                                            
PossibleWatermarkCollection possibleWatermarks = watermarker.search(textSearchCriteria);                 
                                                                                                         
System.out.println("Found " + possibleWatermarks.getCount() + " possible watermark(s)");                 
                                                                                                         
watermarker.close();                                                                                     
```

### Regular expression search criteria  

Regular expressions are also supported by [TextSearchCriteria](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextSearchCriteria). The below sample code uses a regular expression to search for watermarks.

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchWatermarkWithRegularExpression**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
Pattern pattern = Pattern.compile("© \\d{4}$");                                                          
                                                                                                         
// Search by regular expression                                                                          
TextSearchCriteria textSearchCriteria = new TextSearchCriteria(pattern);                                 
                                                                                                         
// Find possible watermarks using regular expression                                                     
PossibleWatermarkCollection possibleWatermarks = watermarker.search(textSearchCriteria);                 
                                                                                                         
System.out.println("Found " + possibleWatermarks.getCount() + " possible watermark(s).");                
                                                                                                         
watermarker.close();                                                                                     
```

{{< alert style="info" >}}
What happens when the user is passing [TextSearchCriteria](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextSearchCriteria) instance to the method?
1. It searches fragments of document's main text which match regular expression (or contain exact search string)
2. It checks text of other objects (shapes, XObjects, annotations etc.) if they match regular expression (or contain exact search string)
  
Search in the main text of a document is performed only if you pass [TextSearchCriteria](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextSearchCriteria) instance to [search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#search(com.groupdocs.watermark.search.SearchCriteria)) method.
{{< /alert >}}

### Image search criteria
Sometimes a document can contain image watermarks, and it's necessary to find them using sample picture. For example, you may want to find all possible image watermarks that are similar to a company logo. Following sample code searches for image watermarks that resemble with a particular image.
**advanced\_usage.searching\_and\_modifying\_watermarks.SearchImageWatermark**
```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
// Initialize criteria with the image                                                                    
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("watermark.jpg");        
                                                                                                         
//Set maximum allowed difference between images                                                          
imageSearchCriteria.setMaxDifference(0.9);                                                               
                                                                                                         
PossibleWatermarkCollection possibleWatermarks = watermarker.search(imageSearchCriteria);                
                                                                                                         
System.out.println("Found " + possibleWatermarks.getCount() + " possible watermark(s).");                
                                                                                                         
watermarker.close();                                                                                     
```

[setMaxDifference()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/ImageSearchCriteria#setMaxDifference(double)) method is used to set maximum allowed difference between sample image and possible watermark. The value should be between 0 and 1. The value 0 means that only identical images will be found.

Using of [ImageDctHashSearchCriteria](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/ImageDctHashSearchCriteria) is the most efficient way to find image watermark by a sample. This criterion uses DCT (Discrete Cosine Transform) based perceptual hash for image similarity comparison. But there are other image search criteria that are based on other algorithms:

*   [ImageColorHistogramSearchCriteria](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/ImageColorHistogramSearchCriteria) uses image color histograms for calculating image similarity. This criterion is invariant to rotation, scaling, and translation of the image.
*   [ImageThumbnailSearchCriteria](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/ImageThumbnailSearchCriteria) uses image binarized thumbnail for calculating image similarity. This criterion is invariant to rotation, scaling and insignificant changes of the color palette.

### Combined search criteria

GroupDocs.Watermark API also allows you to search watermarks by a combination ([And](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/AndSearchCriteria), [Or](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/OrSearchCriteria), [Not](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/NotSearchCriteria)) of different search criteria. Following sample code shows how to search watermark with the combination of different search criteria.

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchWatermarkWithCombinedSearch**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");             
imageSearchCriteria.setMaxDifference(0.9);                                                               
                                                                                                         
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");                          
                                                                                                         
RotateAngleSearchCriteria rotateAngleSearchCriteria = new RotateAngleSearchCriteria(30, 60);             
                                                                                                         
SearchCriteria combinedSearchCriteria = imageSearchCriteria.or(textSearchCriteria)                       
                                                           .and(rotateAngleSearchCriteria);              
PossibleWatermarkCollection possibleWatermarks = watermarker.search(combinedSearchCriteria);             
                                                                                                         
System.out.println("Found " + possibleWatermarks.getCount() + " possible watermark(s).");                
                                                                                                         
watermarker.close();                                                                                     
```

### Text formatting search criteria

GroupDocs.Watermark also enables you to search the watermarks on the basis of some particular text formatting. You can provide a search criterion containing font name, size, color etc and the API will find the watermarks with matching properties. Following code snippet shows how to search watermark with a particular [text formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextFormattingSearchCriteria).

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchWatermarkWithParticularTextFormatting**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
TextFormattingSearchCriteria criteria = new TextFormattingSearchCriteria();                              
criteria.setForegroundColorRange(new ColorRange());                                                      
criteria.getForegroundColorRange().setMinHue(-5);                                                        
criteria.getForegroundColorRange().setMaxHue(10);                                                        
criteria.getForegroundColorRange().setMinBrightness(0.01f);                                              
criteria.getForegroundColorRange().setMaxBrightness(0.99f);                                              
criteria.setBackgroundColorRange(new ColorRange());                                                      
criteria.getBackgroundColorRange().setEmpty(true);                                                       
criteria.setFontName("Arial");                                                                           
criteria.setMinFontSize(19);                                                                             
criteria.setMaxFontSize(42);                                                                             
criteria.setFontBold(true);                                                                              
                                                                                                         
PossibleWatermarkCollection watermarks = watermarker.search(criteria);                                   
// The code for working with found watermarks goes here.                                                 
                                                                                                         
System.out.println("Found " + watermarks.getCount() + " possible watermark(s).");                        
                                                                                                         
watermarker.close();                                                                                     
```

## Searching watermarks in particular objects

This feature allows you to specify which objects should be included in watermark search. Restricting searchable objects, you can significantly increase search performance. Following sample code shows how to set [searchable objects](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/WatermarkerSettings#setSearchableObjects(com.groupdocs.watermark.search.SearchableObjects)) globally (for all documents that will be created after that).

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchWatermarkInParticularObjectsAllInstances**

```java
WatermarkerSettings settings = new WatermarkerSettings();                                                                                                
settings.setSearchableObjects(new SearchableObjects());                                                                                                  
settings.getSearchableObjects().setWordProcessingSearchableObjects(WordProcessingSearchableObjects.Hyperlinks | WordProcessingSearchableObjects.Text);   
settings.getSearchableObjects().setSpreadsheetSearchableObjects(SpreadsheetSearchableObjects.HeadersFooters);                                            
settings.getSearchableObjects().setPresentationSearchableObjects(PresentationSearchableObjects.SlidesBackgrounds | PresentationSearchableObjects.Shapes);
settings.getSearchableObjects().setDiagramSearchableObjects(DiagramSearchableObjects.None);                                                              
settings.getSearchableObjects().setPdfSearchableObjects(PdfSearchableObjects.All);                                                                       
                                                                                                                                                         
String[] files = { "document.docx",                                                                                                             
                   "spreadsheet.xlsx",                                                                                                          
                   "presentation.pptx",                                                                                                         
                   "diagram.vsdx",                                                                                                              
                   "document.pdf" };                                                                                                            
                                                                                                                                                         
for (String file : files)                                                                                                                                
{                                                                                                                                                        
    Watermarker watermarker = new Watermarker(file, settings);                                                                                           
                                                                                                                                                         
    PossibleWatermarkCollection watermarks = watermarker.search();                                                                                       
                                                                                                                                                         
    // The code for working with found watermarks goes here.                                                                                             
                                                                                                                                                         
    System.out.println("In " + new File(file).getName() + " found " + watermarks.getCount() + " possible watermark(s).");                                
                                                                                                                                                         
    watermarker.close();                                                                                                                                 
}                                                                                                                                                        
```

### Searching for hyperlink watermarks  

You can also set [searchable objects](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#setSearchableObjects(com.groupdocs.watermark.search.SearchableObjects)) for a particular [Watermarker](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker) instance as shown in the sample code below.

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchWatermarkInParticularObjectsForParticularDocument**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
// Search for hyperlinks only.                                                                           
watermarker.getSearchableObjects().setPdfSearchableObjects(PdfSearchableObjects.Hyperlinks);             
PossibleWatermarkCollection watermarks = watermarker.search();                                           
                                                                                                         
// The code for working with found watermarks goes here.                                                 
                                                                                                         
System.out.println("Found " + watermarks.getCount() + " possible watermark(s).");                        
                                                                                                         
watermarker.close();                                                                                     
```

## Searching text watermark skipping unreadable characters

This feature allows finding text watermark even if it contains unreadable characters between the letters. The following code sample shows how to [skip unreadable characters](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextSearchCriteria#setSkipUnreadableCharacters(boolean)) when searching for the watermark.

**advanced\_usage.searching\_and\_modifying\_watermarks.SearchTextWatermarkSkippingUnreadableCharacters**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
String watermarkText = "Company name";                                                                   
TextSearchCriteria criterion = new TextSearchCriteria(watermarkText);                                    
                                                                                                         
// Enable skipping of unreadable characters                                                              
criterion.setSkipUnreadableCharacters(true);                                                             
                                                                                                         
PossibleWatermarkCollection result = watermarker.search(criterion);                                      
                                                                                                         
// ...                                                                                                   
                                                                                                         
System.out.println("Found " + result.getCount() + " possible watermark(s).");                            
                                                                                                         
watermarker.close();                                                                                     
```


---

## Searching watermarks

Path: /watermark/net/searching-watermarks/

## Searching possible watermarks

GroupDocs.Watermark API allows you to search the possible watermarks placed in any document. You can also search the watermarks that are added using some third-party tool. The API provides [Search](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/search) method to search watermarks in a whole document or in any part of the document. Following code snippet shows how to find and get all possible watermarks in a document.

**AdvancedUsage.SearchAndRemoveWatermarks.SearchWatermark**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search();
    foreach (PossibleWatermark possibleWatermark in possibleWatermarks)
    {
        if (possibleWatermark.ImageData != null)
        {
            Console.WriteLine(possibleWatermark.ImageData.Length);
        }

        Console.WriteLine($"Text {possibleWatermark.Text}");
        Console.WriteLine($"X {possibleWatermark.X}");
        Console.WriteLine($"Y {possibleWatermark.Y}");
        Console.WriteLine($"RotateAngle {possibleWatermark.RotateAngle}");
        Console.WriteLine($"Width {possibleWatermark.Width}");
        Console.WriteLine($"Height {possibleWatermark.Height}");
        Console.WriteLine($"PageNumber {possibleWatermark.PageNumber}");
        Console.WriteLine("");
    }
}
```

## Search criteria

Usually, large documents may contain too many objects which can be considered as watermarks. Parameterless overload of [Search](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/search) method returns only some of them, e.g. backgrounds or floating objects which could have been added during document post-processing. You can use [search criteria](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/) to find objects with some specific parameters.

### Text search criteria

Following code snippet shows how to search for the watermarks that meet a particular [text criterion](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textsearchcriteria).

**AdvancedUsage.SearchAndRemoveWatermarks.SearchWatermarkWithSearchString**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    // Search by exact string
    TextSearchCriteria textSearchCriteria = new TextSearchCriteria("© 2017");
    // Find all possible watermarks containing some specific text
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(textSearchCriteria);
    Console.WriteLine("Found {0} possible watermark(s)", possibleWatermarks.Count);
}
```

### Regular expression search criteria  

Regular expressions are also supported by [TextSearchCriteria](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textsearchcriteria). The below sample code uses a regular expression to search for watermarks.

**AdvancedUsage.SearchAndRemoveWatermarks.SearchWatermarkWithRegularExpression**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    Regex regex = new Regex(@"^© \d{4}$");
    // Search by regular expression
    TextSearchCriteria textSearchCriteria = new TextSearchCriteria(regex);
    // Find possible watermarks using regular expression
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(textSearchCriteria);
    Console.WriteLine("Found {0} possible watermark(s).", possibleWatermarks.Count);
}
```

{{< alert style="info" >}}
What happens when the user is passing [TextSearchCriteria](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textsearchcriteria) instance to the method?

1. It searches fragments of document's main text which match regular expression (or contain exact search string)
2. It checks text of other objects (shapes, XObjects, annotations etc.) if they match regular expression (or contain exact search string)

Search in the main text of a document is performed only if you pass [TextSearchCriteria](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textsearchcriteria) instance to [Search](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/search/methods/1) method.
{{< /alert >}}

### Image search criteria

Sometimes a document can contain image watermarks, and it's necessary to find them using sample picture. For example, you may want to find all possible image watermarks that are similar to a company logo. Following sample code searches for image watermarks that resemble with a particular image using.

**AdvancedUsage.SearchAndRemoveWatermarks.SearchImageWatermark**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    // Initialize criteria with the image
    ImageSearchCriteria imageSearchCriteria = 
        new ImageDctHashSearchCriteria("watermark.jpg");
    //Set maximum allowed difference between images
    imageSearchCriteria.MaxDifference = 0.9;
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(imageSearchCriteria);
    Console.WriteLine("Found {0} possible watermark(s).", possibleWatermarks.Count);
}
```

[MaxDifference](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/imagesearchcriteria/properties/maxdifference) property is used to set maximum allowed difference between sample image and possible watermark. The value should be between 0 and 1. The value 0 means that only identical images will be found.
Using of [ImageDctHashSearchCriteria](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/imagedcthashsearchcriteria) is the most efficient way to find image watermark by a sample. This criterion uses DCT (Discrete Cosine Transform) based perceptual hash for image similarity comparison. But there are other image search criteria that are based on other algorithms:

* [ImageColorHistogramSearchCriteria](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/imagecolorhistogramsearchcriteria) uses image color histograms for calculating image similarity. This criterion is invariant to rotation, scaling, and translation of the image.
* [ImageThumbnailSearchCriteria](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/imagethumbnailsearchcriteria) uses image binarized thumbnail for calculating image similarity. This criterion is invariant to rotation, scaling and insignificant changes of the color palette.

### Combined search criteria

GroupDocs.Watermark API also allows you to search watermarks by a combination ([And](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/andsearchcriteria), [Or](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/orsearchcriteria), [Not](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/notsearchcriteria)) of different search criteria. Following sample code shows how to search watermark with the combination of different search criteria.

**AdvancedUsage.SearchAndRemoveWatermarks.SearchWatermarkWithCombinedSearch**

```csharp
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");
    imageSearchCriteria.MaxDifference = 0.9;
    TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");
    RotateAngleSearchCriteria rotateAngleSearchCriteria = new RotateAngleSearchCriteria(30, 60);
    SearchCriteria combinedSearchCriteria = imageSearchCriteria
        .Or(textSearchCriteria).And(rotateAngleSearchCriteria);
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(combinedSearchCriteria);
    Console.WriteLine("Found {0} possible watermark(s).", possibleWatermarks.Count);
}
```

### Text formatting search criteria

GroupDocs.Watermark also enables you to search the watermarks on the basis of some particular text formatting. You can provide a search criterion containing font name, size, color etc and the API will find the watermarks with matching properties. Following code snippet shows how to search watermark with a particular [text formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textformattingsearchcriteria).

**AdvancedUsage.SearchAndRemoveWatermarks.SearchWatermarkWithParticularTextFormatting**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    TextFormattingSearchCriteria criteria = new TextFormattingSearchCriteria();
    criteria.ForegroundColorRange = new ColorRange();
    criteria.ForegroundColorRange.MinHue = -5;
    criteria.ForegroundColorRange.MaxHue = 10;
    criteria.ForegroundColorRange.MinBrightness = 0.01f;
    criteria.ForegroundColorRange.MaxBrightness = 0.99f;
    criteria.BackgroundColorRange = new ColorRange();
    criteria.BackgroundColorRange.IsEmpty = true;
    criteria.FontName = "Arial";
    criteria.MinFontSize = 19;
    criteria.MaxFontSize = 42;
    criteria.FontBold = true;

    PossibleWatermarkCollection watermarks = watermarker.Search(criteria);

    // The code for working with found watermarks goes here.
    Console.WriteLine("Found {0} possible watermark(s).", watermarks.Count);
}
```

## Searching watermarks in particular objects

This feature allows you to specify which objects should be included in watermark search. Restricting searchable objects, you can significantly increase search performance. Following sample code shows how to set [searchable objects](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarkersettings/properties/searchableobjects) globally (for all documents that will be created after that).

**AdvancedUsage.SearchAndRemoveWatermarks.SearchWatermarkInParticularObjectsAllInstances**

```csharp
WatermarkerSettings settings = new WatermarkerSettings();
settings.SearchableObjects = new SearchableObjects
    {
        WordProcessingSearchableObjects = WordProcessingSearchableObjects.Hyperlinks | WordProcessingSearchableObjects.Text,
        SpreadsheetSearchableObjects = SpreadsheetSearchableObjects.HeadersFooters,
        PresentationSearchableObjects = PresentationSearchableObjects.SlidesBackgrounds | PresentationSearchableObjects.Shapes,
        DiagramSearchableObjects = DiagramSearchableObjects.None,
        PdfSearchableObjects = PdfSearchableObjects.All
    };

string[] files = { "document.docx", "spreadsheet.xlsx", "presentation.pptx",
                   "diagram.vsdx", "document.pdf" };

foreach (string file in files)
{
    using (Watermarker watermarker = new Watermarker(file, settings))
    {
        PossibleWatermarkCollection watermarks = watermarker.Search();

        // The code for working with found watermarks goes here.
        Console.WriteLine("In {0} found {1} possible watermark(s).", 
            Path.GetFileName(file), watermarks.Count);
    }
}
```

### Searching for hyperlink watermarks  

You can also set [searchable objects](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/properties/searchableobjects) for a particular [Watermarker](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker) instance as shown in the sample code below.

**AdvancedUsage.SearchAndRemoveWatermarks.SearchWatermarkInParticularObjectsForParticularDocument**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    // Search for hyperlinks only.
    watermarker.SearchableObjects.PdfSearchableObjects = PdfSearchableObjects.Hyperlinks;
    PossibleWatermarkCollection watermarks = watermarker.Search();

    // The code for working with found watermarks goes here.
    Console.WriteLine("Found {0} hyperlink watermark(s).", watermarks.Count);
}
```

## Searching text watermark skipping unreadable characters

This feature allows finding text watermark even if it contains unreadable characters between the letters. The following code sample shows how to [skip unreadable characters](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textsearchcriteria/properties/skipunreadablecharacters) when searching for the watermark.

**AdvancedUsage.SearchAndRemoveWatermarks.SearchTextWatermarkSkippingUnreadableCharacters**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    string watermarkText = "Company name";
    TextSearchCriteria criterion = new TextSearchCriteria(watermarkText);

    // Enable skipping of unreadable characters
    criterion.SkipUnreadableCharacters = true;
    PossibleWatermarkCollection result = watermarker.Search(criterion);

    Console.WriteLine("Found {0} possible watermark(s).", result.Count);
}
```

---

## Searching watermarks

Path: /watermark/nodejs-java/searching-watermarks/

## Searching possible watermarks

GroupDocs.Watermark API allows you to search the possible watermarks placed in any document. You can also search the watermarks that are added using some third-party tool.  The API provides search method to search watermarks in a whole document or in any part of the document. Following code snippet shows how to find and get all possible watermarks in a document.

```js
// Create an instance of Watermarker
const watermarker = new groupdocsWatermark.Watermarker('sample.pdf');

const watermarks = watermarker.search();
  // Iterate through found watermarks
  for (const watermark of watermarks.getInnerList().toArray()) {
    console.log(watermark.getText());
    console.log(watermark.getRotateAngle());
    console.log(watermark.getX());
    console.log(watermark.getY());
    console.log(watermark.getWidth());
    console.log(watermark.getHeight())
  }
```


## Search criteria

You can use search criteria to find objects with some specific parameters.

### Text search criteria

Following code snippet shows how to search for the watermarks that meet a particular text criterion

```js
 // Create watermarker
const watermarker = new groupdocsWatermark.Watermarker('sample.pdf');

// Define search criteria
const searchCriteria = new groupdocsWatermark.TextSearchCriteria("test", false);

// Search for watermarks
const watermarks = watermarker.search(searchCriteria);
console.log(`Found ${watermarks.getCount()} possible watermark(s).`);
```

### Image search criteria

Sometimes a document can contain image watermarks, and it's necessary to find them using sample picture. For example, you may want to find all possible image watermarks that are similar to a company logo. Following sample code searches for image watermarks that resemble with a particular image using.

```js
 // Create watermarker
const watermarker = new groupdocsWatermark.Watermarker('sample.pdf');

// Initialize search criteria with the image
const imageSearchCriteria = new groupdocsWatermark.ImageDctHashSearchCriteria('logo.png');

// Set maximum allowed difference between images
imageSearchCriteria.setMaxDifference(0.9);

// Search for possible watermarks matching the criteria
const possibleWatermarks = watermarker.search(imageSearchCriteria);

console.log(`Found ${possibleWatermarks.getCount()} possible watermark(s).`);
```

MaxDifference property is used to set maximum allowed difference between sample image and possible watermark. The value should be between 0 and 1. The value 0 means that only identical images will be found.
Using of ImageDctHashSearchCriteria is the most efficient way to find image watermark by a sample. This criterion uses DCT (Discrete Cosine Transform) based perceptual hash for image similarity comparison. But there are other image search criteria that are based on other algorithms:

### Combined search criteria

GroupDocs.Watermark API also allows you to search watermarks by a combination of different search criteria. Following sample code shows how to search watermark with the combination of different search criteria.

```js
 // Create watermarker
const watermarker = new groupdocsWatermark.Watermarker('sample.pdf');

  // Define image search criteria
  const imageSearchCriteria = new groupdocsWatermark.ImageDctHashSearchCriteria('logo.png');
  imageSearchCriteria.setMaxDifference(0.9);

  // Define text search criteria
  const textSearchCriteria = new groupdocsWatermark.TextSearchCriteria("Company Name");

  // Define rotate angle search criteria
  const rotateAngleSearchCriteria = new groupdocsWatermark.RotateAngleSearchCriteria(30, 60);

  // Combine search criteria
  const combinedSearchCriteria = imageSearchCriteria.or(textSearchCriteria).and(rotateAngleSearchCriteria);

  // Search for possible watermarks
  const possibleWatermarks = watermarker.search(combinedSearchCriteria);

  // Output the results
  console.log(`Found ${possibleWatermarks.getCount()} possible watermark(s).`);
```
---

## Searching watermarks

Path: /watermark/python-net/searching-watermarks/


## Searching possible watermarks

Use `Watermarker.search()` to scan a document for objects that can be treated as watermarks. This includes watermarks added by third‑party tools.

```python
import groupdocs.watermark as gw

with gw.Watermarker("document.pdf") as watermarker:
    possible = watermarker.search()
    for wm in possible:
        if wm.image_data is not None:
            print(len(wm.image_data))

        print("Text", wm.text)
        print("X", wm.x)
        print("Y", wm.y)
        print("RotateAngle", wm.rotate_angle)
        print("Width", wm.width)
        print("Height", wm.height)
        print("PageNumber", wm.page_number)
        print("")
```

## Search criteria

Large documents may contain many candidates. Without parameters, `search()` returns a subset such as backgrounds or floating objects. Use dedicated criteria to narrow results.

### Text search criteria

Find watermarks by exact text.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    text_criteria = gws_sc.TextSearchCriteria("© 2017")
    possible = watermarker.search(text_criteria)
    print("Found", possible.count, "possible watermark(s)")
```

### Regular expression search criteria

Use regex with `TextSearchCriteria`.

```python
import re
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    regex = re.compile(r"^© \d{4}$")
    text_criteria = gws_sc.TextSearchCriteria(regex)
    possible = watermarker.search(text_criteria)
    print("Found", possible.count, "possible watermark(s)")
```

{{< alert style="info" >}}
When `TextSearchCriteria` is provided, the API also scans the main document text along with shapes, XObjects, annotations, and other objects.
{{< /alert >}}

### Image search criteria

Find image watermarks that are visually similar to a sample image using perceptual hashing (DCT hash). Control sensitivity with `max_difference` (0–1).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    image_criteria = gws_sc.ImageDctHashSearchCriteria("watermark.jpg")
    image_criteria.max_difference = 0.9
    possible = watermarker.search(image_criteria)
    print("Found", possible.count, "possible watermark(s)")
```

Other image criteria:

- `ImageColorHistogramSearchCriteria`: robust to rotation, scaling, translation.
- `ImageThumbnailSearchCriteria`: robust to rotation, scaling, minor color changes.

### Combined search criteria

Combine multiple criteria with logical And/Or/Not.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    image_criteria = gws_sc.ImageDctHashSearchCriteria("logo.png")
    image_criteria.max_difference = 0.9
    text_criteria = gws_sc.TextSearchCriteria("Company Name")
    angle_criteria = gws_sc.RotateAngleSearchCriteria(30, 60)

    combined = image_criteria.or_(text_criteria).and_(angle_criteria)
    possible = watermarker.search(combined)
    print("Found", possible.count, "possible watermark(s)")
```

### Text formatting search criteria

Find watermarks by text formatting such as font, size, and color ranges.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    criteria = gws_sc.TextFormattingSearchCriteria()
    criteria.foreground_color_range = gws_sc.ColorRange()
    criteria.foreground_color_range.min_hue = -5
    criteria.foreground_color_range.max_hue = 10
    criteria.foreground_color_range.min_brightness = 0.01
    criteria.foreground_color_range.max_brightness = 0.99
    criteria.background_color_range = gws_sc.ColorRange()
    criteria.background_color_range.is_empty = True
    criteria.font_name = "Arial"
    criteria.min_font_size = 19
    criteria.max_font_size = 42
    criteria.font_bold = True

    possible = watermarker.search(criteria)
    print("Found", possible.count, "possible watermark(s)")
```

## Searching watermarks in particular objects

Limit search to specific object types to improve performance, either globally via `WatermarkerSettings.searchable_objects` or per instance via `Watermarker.searchable_objects`.

```python
import os
import groupdocs.watermark as gw
import groupdocs.watermark.search as gws

settings = gw.WatermarkerSettings()
settings.searchable_objects = gws.SearchableObjects(
    word_processing_searchable_objects=gws.WordProcessingSearchableObjects.HYPERLINKS | gws.WordProcessingSearchableObjects.TEXT,
    spreadsheet_searchable_objects=gws.SpreadsheetSearchableObjects.HEADERS_FOOTERS,
    presentation_searchable_objects=gws.PresentationSearchableObjects.SLIDES_BACKGROUNDS | gws.PresentationSearchableObjects.SHAPES,
    diagram_searchable_objects=gws.DiagramSearchableObjects.NONE,
    pdf_searchable_objects=gws.PdfSearchableObjects.ALL,
)

files = ["document.docx", "spreadsheet.xlsx", "presentation.pptx", "diagram.vsdx", "document.pdf"]
for file in files:
    with gw.Watermarker(file, settings) as watermarker:
        possible = watermarker.search()
        print(f"In {os.path.basename(file)} found {possible.count} possible watermark(s).")
```

### Searching for hyperlink watermarks

Restrict search to hyperlinks for a specific `Watermarker` instance.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search as gws

with gw.Watermarker("document.pdf") as watermarker:
    watermarker.searchable_objects.pdf_searchable_objects = gws.PdfSearchableObjects.HYPERLINKS
    possible = watermarker.search()
    print("Found", possible.count, "hyperlink watermark(s)")
```

## Searching text watermark while skipping unreadable characters

Enable tolerant matching when text contains unreadable characters between letters.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    criterion = gws_sc.TextSearchCriteria("Company name")
    criterion.skip_unreadable_characters = True
    result = watermarker.search(criterion)
    print("Found", result.count, "possible watermark(s)")
```



---

## Set document metadata on save

Path: /comparison/java/set-document-metadata-on-save/


Document can contain some metadata information, such as author, organization, etc. [GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to select metadata source when saving output document.  

Possible metadata sources are as follows:

- Source document metadata
- Target document metadata
- User-defined metadata

To set output document metadata, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Instantiate the [SaveOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.save/SaveOptions) object. Call the [setCloneMetadataType()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.save/saveoptions/#setCloneMetadataType-com.groupdocs.comparison.options.enums.MetadataType-) method to set the appropriate [MetadataType](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.enums/metadatatype/) variant.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [SaveOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.save/saveoptions/) object as a parameter.

The following code snippets show how to set output document metadata:

## Set metadata from source file

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.enums.MetadataType;
import com.groupdocs.comparison.options.save.SaveOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final SaveOptions saveOptions = new SaveOptions();
    saveOptions.setCloneMetadataType(MetadataType.SOURCE);
    final Path resultPath = comparer.compare("result.docx", saveOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Set metadata from target file

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.enums.MetadataType;
import com.groupdocs.comparison.options.save.SaveOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final SaveOptions saveOptions = new SaveOptions();
    saveOptions.setCloneMetadataType(MetadataType.TARGET);
    final Path resultPath = comparer.compare("result.docx", saveOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Set user-defined metadata 

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.enums.MetadataType;
import com.groupdocs.comparison.options.save.SaveOptions;
import java.nio.file.Path;
import com.groupdocs.comparison.words.revision.*;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final FileAuthorMetadata fileAuthorMetadata = new FileAuthorMetadata();
    fileAuthorMetadata.setAuthor("Tom");
    fileAuthorMetadata.setCompany("GroupDocs");
    fileAuthorMetadata.setLastSaveBy("Jack");
    final SaveOptions saveOptions = new SaveOptions();
    saveOptions.setCloneMetadataType(MetadataType.FILEAUTHOR);
    saveOptions.setFileAuthorMetadata(fileAuthorMetadata);
    final Path resultPath = comparer.compare("result.docx", saveOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Set document metadata on save

Path: /comparison/net/set-document-metadata-on-save/


Document can contain some metadata information, such as author, organization, etc. [GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to select metadata source when saving output document.  

Possible metadata sources are as follows:

- Source document metadata
- Target document metadata
- User-defined metadata

To set output document metadata, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [SaveOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/saveoptions) object. Set the [CloneMetadataType](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/saveoptions/properties/clonemetadatatype) property to the appropriate [MetadataType](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/metadatatype) variant.
4.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare/index) method. Specify the [SaveOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/saveoptions) object as a parameter.

The following code snippets show how to set output document metadata:

## Set metadata from source file

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx", new SaveOptions() { CloneMetadataType = MetadataType.Source });
}
```
{{< /tab >}}
{{< /tabs >}}

## Set metadata from target file

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx", new SaveOptions() { CloneMetadataType = MetadataType.Target });
}
```
{{< /tab >}}
{{< /tabs >}}

## Set user-defined metadata 

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    SaveOptions saveOptions = new SaveOptions()
    {
        CloneMetadataType = MetadataType.FileAuthor,
        FileAuthorMetadata = new FileAuthorMetadata
        {
            Author = "Tom",
            Company = "GroupDocs",
            LastSaveBy = "Jack"
        }
    };
    comparer.Compare("result.docx", saveOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Set document metadata on save

Path: /comparison/nodejs-java/set-document-metadata-on-save/


A document can contain some metadata information, such as author, organization, etc. [GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to select metadata sources when saving the output document.  

Possible metadata sources are as follows:

- Source document metadata
- Target document metadata
- User-defined metadata

The following code snippets show how to set output document metadata.

## Set metadata from the source file

The following example copies metadata (author, company, etc.) from the source document into the comparison result.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and output documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const outputFile = 'result.docx';

// Create a Comparer instance for the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add the target document to compare against the source
comparer.add(targetFile);

// Configure save options (clone metadata from the source document)
const saveOptions = new groupdocs.SaveOptions();
saveOptions.setCloneMetadataType(groupdocs.MetadataType.SOURCE); // Use source metadata for the result

// Execute the comparison and save the result to the output file
comparer.compare(outputFile, saveOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `SaveOptions` object. It configures the metadata source by calling `setCloneMetadataType(MetadataType.SOURCE)`, which copies all metadata (author, company, creation date, etc.) from the source document into the result document. When the comparison is performed, the result file will contain the same metadata as the source document.

## Set metadata from the target file

The following example instead copies metadata from the target document into the result.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for the source, target, and output documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const outputFile = 'result.docx';

// Create a Comparer instance for the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add the target document to the comparison list
comparer.add(targetFile);

// Configure save options for the comparison result
const saveOptions = new groupdocs.SaveOptions();

// Clone metadata from the target document into the result
saveOptions.setCloneMetadataType(groupdocs.MetadataType.TARGET);

// Perform the comparison and save the result to the output file
comparer.compare(outputFile, saveOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example follows the same pattern but uses `setCloneMetadataType(MetadataType.TARGET)` instead. This copies all metadata from the target document into the result document, so the result file will have the same metadata properties as the target document rather than the source.

## Set user-defined metadata 

The following example uses a custom `FileAuthorMetadata` object to write explicit author information into the output document.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and output documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const outputFile = 'result.docx';

// Create a comparer instance for the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add the target document to be compared with the source
comparer.add(targetFile);

// Initialize metadata that will be written to the result file
const fileAuthorMetadata = new groupdocs.FileAuthorMetadata();

// Set the author information for the output document
fileAuthorMetadata.setAuthor('Tom');
fileAuthorMetadata.setCompany('GroupDocs');
fileAuthorMetadata.setLastSaveBy('Jack');

// Configure save options for the comparison result
const saveOptions = new groupdocs.SaveOptions();

// Attach the previously defined author metadata to the save options
saveOptions.setFileAuthorMetadata(fileAuthorMetadata);

// Execute the comparison and save the resulting document with the defined options
comparer.compare(outputFile, saveOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates how to set custom metadata for the result document. It creates a `FileAuthorMetadata` object and sets custom values for author, company, and last-save-by fields. This metadata object is then attached to the `SaveOptions` using `setFileAuthorMetadata()`. When the comparison is performed, the result document will contain these custom metadata values instead of copying from either the source or target document.

---

## Set document metadata on save

Path: /comparison/python-net/set-document-metadata-on-save/


A document can contain some metadata information, such as author, organization, etc. [GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to select metadata sources when saving the output document.  

Possible metadata sources are as follows:

- Source document metadata
- Target document metadata
- User-defined metadata

To set output document metadata, follow these steps:

1.  Instantiate the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify the source document path or stream.
2.  Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method. Specify the target document path or stream.
3.  Instantiate the `SaveOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.save/SaveOptions)--> object. Set the appropriate `MetadataType` via `clone_metadata_type`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.save/saveoptions/#setCloneMetadataType-com.groupdocs.comparison.options.enums.MetadataType-)--> property.
4.  Call the `compare()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#compare-java.lang.String-)--> method. Specify the `SaveOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.save/saveoptions/)--> object as a parameter.

The following code snippets show how to set output document metadata:

## Set metadata from the source file

```python
import groupdocs.comparison as gc

def set_document_metadata_on_save(output_file_path, source_file_path, target_file_path):
    # Initialize comparer with the source document
    with gc.Comparer(source_file_path) as comparer:
        # Add the target document for comparison
        comparer.add(target_file_path)
        
        # Set comparison options
        save_options = gc.options.SaveOptions()
        save_options.clone_metadata_type = gc.options.MetadataType.SOURCE
        
        # Compare the documents and save the result
        comparer.compare(output_file_path, save_options)
    
    # Log the success message with the output file path
    print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
```

## Set metadata from the target file

```python
import groupdocs.comparison as gc

def set_document_metadata_on_save(output_file_path, source_file_path, target_file_path):
    # Initialize comparer with the source document
    with gc.Comparer(source_file_path) as comparer:
        # Add the target document for comparison
        comparer.add(target_file_path)
        
        # Set comparison options
        save_options = gc.options.SaveOptions()
        save_options.clone_metadata_type = gc.options.MetadataType.TARGET
        
        # Compare the documents and save the result
        comparer.compare(output_file_path, save_options)
    
    # Log the success message with the output file path
    print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
```

## Set user-defined metadata 

```python
import groupdocs.comparison as gc

def set_document_metadata_on_save(output_file_path, source_file_path, target_file_path):
    # Initialize comparer with the source document
    with gc.Comparer(source_file_path) as comparer:
        # Add the target document for comparison
        comparer.add(target_file_path)
        
        # Set file author metadata
        file_author_metadata = gc.options.FileAuthorMetadata()
        file_author_metadata.author = "Tom"
        file_author_metadata.company = "GroupDocs"
        file_author_metadata.last_save_by = "Jack"

        # Set comparison options
        save_options = gc.options.SaveOptions()
        save_options.clone_metadata_type = gc.options.MetadataType.FILE_AUTHOR
        save_options.file_author_metadata = file_author_metadata
        
        # Compare the documents and save the result
        comparer.compare(output_file_path, save_options)
    
    # Log the success message with the output file path
    print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
```

---

## Set up logging

Path: /signature/net/how-to-set-up-logging/


By default logging is disabled when processing documents but product provides a way to save the log with embedded implementation to save events to console and file.

There is an interface that we can utilize:

* [ILogger](https://reference.groupdocs.com/net/signature/groupdocs.signature.logging/ilogger) - defines the interface for logging different process event like errors, warnings and information messages (traces).

There are classes that we can utilize:

* [ConsoleLogger](https://reference.groupdocs.com/net/signature/groupdocs.signature.logging/consolelogger) - defines the methods that are required for logging to console.
* [FileLogger](https://reference.groupdocs.com/net/signature/groupdocs.signature.logging/filelogger) - defines the methods that are required for logging to file.

There are 3 types of messages in the log file:

* Error - for unrecoverable exceptions
* Warning - for recoverable/expected/known exceptions
* Trace - for general information

## Logging to File

In this example, we'll log into the file so we need to use [FileLogger](https://reference.groupdocs.com/net/signature/groupdocs.signature.logging/filelogger) class.

```csharp
// Create logger and specify the output file
FileLogger fileLogger = new FileLogger("output.log");

// Create SignatureSettings and specify FileLogger
var settings = new SignatureSettings(fileLogger);

using (var signature = new Signature("sample.docx", settings))
{
    var options = new QrCodeSignOptions("JohnSmith");
    // sign document to file
    signature.Sign(outputFilePath, options);
}
```

## Logging to Console

In this example, we'll log into the console so we need to use [ConsoleLogger](https://reference.groupdocs.com/net/signature/groupdocs.signature.logging/consolelogger) class.

```csharp
// Create logger and specify the output file
var consoleLogger = new ConsoleLogger();

// Create SignatureSettings and specify ConsoleLogger instance
var settings = new SignatureSettings(consoleLogger);

using (var signature = new Signature("sample.docx", settings))
{
    var options = new QrCodeSignOptions("JohnSmith");
    // sign document to file
    signature.Sign(outputFilePath, options);
}
```

---

## Shapes in spreadsheet document

Path: /watermark/net/shapes-in-spreadsheet-document/


The watermarking API enables you extracting information about all shapes in an excel document, Removing a particular shape, Removing shapes with particular text formatting, Replacing text for particular shapes, Replacing shape image and more.

## Extracting information about all shapes in an excel document

[*Search*](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/search) method searches watermarks of all mentioned types, but in some cases, it's necessary to analyze only one class of Excel objects. Following code sample shows how to get information about all the [shapes](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetworksheet/properties/shapes) in an Excel document.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetGetShapesInformation**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        foreach (SpreadsheetShape shape in worksheet.Shapes)
        {
            Console.WriteLine(shape.AutoShapeType);
            Console.WriteLine(shape.MsoDrawingType);
            Console.WriteLine(shape.Text);
            if (shape.Image != null)
            {
                Console.WriteLine(shape.Image.Width);
                Console.WriteLine(shape.Image.Height);
                Console.WriteLine(shape.Image.GetBytes().Length);
            }

            Console.WriteLine(shape.Id);
            Console.WriteLine(shape.AlternativeText);
            Console.WriteLine(shape.X);
            Console.WriteLine(shape.Y);
            Console.WriteLine(shape.Width);
            Console.WriteLine(shape.Height);
            Console.WriteLine(shape.RotateAngle);
            Console.WriteLine(shape.IsWordArt);
            Console.WriteLine(shape.Name);
        }
    }
}
```

## Removing a particular shape

You can also remove a particular [shape](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetworksheet/properties/shapes) from the worksheet as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetRemoveShape**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();

    // Remove shape by index
    content.Worksheets[0].Shapes.RemoveAt(0);

    // Remove shape by reference
    content.Worksheets[0].Shapes.Remove(content.Worksheets[0].Shapes[0]);

    watermarker.Save("spreadsheet.xlsx");
}
```

## Removing shapes with particular text formatting

You can also find and remove the shapes with a [particular text formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/formattedtextfragments) from an Excel document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetRemoveTextShapesWithParticularTextFormatting**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet section in content.Worksheets)
    {
        for (int i = section.Shapes.Count - 1; i >= 0; i--)
        {
            foreach (FormattedTextFragment fragment in section.Shapes[i].FormattedTextFragments)
            {
                if (fragment.ForegroundColor == Color.Red && fragment.Font.FamilyName == "Arial")
                {
                    section.Shapes.RemoveAt(i);
                    break;
                }
            }
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

## Removing/replacing hyperlink associated with a particular shape

Using GroupDocs.Watermark for .NET, you can also remove/replace hyperlink associated with a particular [shape](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/hyperlink) or [chart](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetchart/properties/hyperlink) inside an Excel document. Use following code sample to achieve this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetRemoveHyperlinks**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();

    // Replace hyperlink
    content.Worksheets[0].Charts[0].Hyperlink = "https://www.aspose.com/";
    content.Worksheets[0].Shapes[0].Hyperlink = "https://www.groupdocs.com/";

    // Remove hyperlink
    content.Worksheets[1].Charts[0].Hyperlink = null;
    content.Worksheets[1].Shapes[0].Hyperlink = null;

    watermarker.Save("spreadsheet.xlsx");
}
```

{{< alert style="warning" >}}This feature is also supported for charts.{{< /alert >}}

## Replacing text for particular shapes

Since version 17.12, GroupDocs.Watermark supports replacing [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/text) for particular shapes in an Excel Worksheet. Following code sample shows the usage of this feature.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetReplaceTextForParticularShapes**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetShape shape in content.Worksheets[0].Shapes)
    {
        if (shape.Text == "© Aspose 2016")
        {
            shape.Text = "© GroupDocs 2017";
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

## Replacing text for particular shapes with formatted text

You can also replace the [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/text) of the shapes with [formatted text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/formattedtextfragments) as shown in the following code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetReplaceTextWithFormattingForParticularShapes**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetShape shape in content.Worksheets[0].Shapes)
    {
        if (shape.Text == "© Aspose 2016")
        {
            shape.FormattedTextFragments.Clear();
            shape.FormattedTextFragments.Add("© GroupDocs 2017", 
                new Font("Calibri", 19, FontStyle.Bold), Color.Red, Color.Aqua);
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

## Replacing shape image

GroupDocs.Watermark also allows you to replace the [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/image) of the particular shapes in an Excel Worksheet as shown in the following code sample. This feature is supported since version 17.12.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetReplaceImageOfParticularShapes**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetShape shape in content.Worksheets[0].Shapes)
    {
        if (shape.Image != null)
        {
            shape.Image = new SpreadsheetWatermarkableImage(File.ReadAllBytes("test.png"));
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

## Setting background image for particular shapes

Since version 17.12, GroupDocs.Watermark enables you to set the [background image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/imagefillformat) for the particular shapes in an Excel Worksheet. Following code sample shows the usage of this feature.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetSetBackgroundImageForParticularShapes**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetShape shape in content.Worksheets[0].Shapes)
    {
        if (shape.Text == "© Aspose 2016")
        {
            shape.ImageFillFormat.BackgroundImage = new SpreadsheetWatermarkableImage(
                File.ReadAllBytes("test.png"));
            shape.ImageFillFormat.Transparency = 0.5;
            shape.ImageFillFormat.TileAsTexture = true;
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

## Updating shape properties

Since version 17.12, GroupDocs.Watermark also provides the feature of modifying properties ([X](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/x), [Y](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/y), [Width](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/width), [Height](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/height), [RotateAngle](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/rotateangle) or [AlternativeText](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetshape/properties/alternativetext)) of particular shapes in an Excel Worksheet. Following code sample shows how to use this feature.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetUpdateShapeProperties**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetShape shape in content.Worksheets[0].Shapes)
    {
        if (shape.Text == "© Aspose 2019")
        {
            shape.AlternativeText = "watermark";
            shape.RotateAngle = 30;
            shape.X = 200;
            shape.Y = 200;
            shape.Width = 400;
            shape.Height = 100;
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```


---

## Shapes in spreadsheet document

Path: /watermark/python-net/shapes-in-spreadsheet-document/


## Extracting information about all shapes in an Excel document
This sample iterates all worksheets and prints shape metadata, text, positioning, size, rotation, and image details.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        for shape in worksheet.shapes:
            print(shape.auto_shape_type)
            print(shape.mso_drawing_type)
            print(shape.text)
            if shape.image is not None:
                print(shape.image.width)
                print(shape.image.height)
                print(len(shape.image.get_bytes())))

            print(shape.id)
            print(shape.alternative_text)
            print(shape.x)
            print(shape.y)
            print(shape.width)
            print(shape.height)
            print(shape.rotate_angle)
            print(shape.is_word_art)
            print(shape.name)
```

## Removing a particular shape
This sample removes shapes from a worksheet by index and by reference, then saves the workbook.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    content.worksheets[0].shapes.remove_at(0)
    content.worksheets[0].shapes.remove(content.worksheets[0].shapes[0])
    watermarker.save("spreadsheet.xlsx")
```

## Removing shapes with particular text formatting
This sample deletes shapes whose formatted text matches a condition (for example, red Arial fragments).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls
import groupdocs.watermark.watermarks as gww

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        for i in range(worksheet.shapes.count - 1, -1, -1):
            for fragment in worksheet.shapes[i].formatted_text_fragments:
                if fragment.foreground_color == gww.Color.red and fragment.font.family_name == "Arial":
                    worksheet.shapes.remove_at(i)
                    break
    watermarker.save("spreadsheet.xlsx")
```

## Removing/replacing hyperlink associated with a particular shape
This sample sets or clears hyperlinks on shapes and charts across worksheets.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    content.worksheets[0].charts[0].hyperlink = "https://www.aspose.com/"
    content.worksheets[0].shapes[0].hyperlink = "https://www.groupdocs.com/"
    content.worksheets[1].charts[0].hyperlink = None
    content.worksheets[1].shapes[0].hyperlink = None
    watermarker.save("spreadsheet.xlsx")
```

## Replacing text for particular shapes
This sample finds shapes by exact text and replaces their text content with new plain text.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for shape in content.worksheets[0].shapes:
        if shape.text == "© Aspose 2016":
            shape.text = "© GroupDocs 2017"
    watermarker.save("spreadsheet.xlsx")
```

## Replacing text for particular shapes with formatted text
This sample rebuilds a shape’s text using formatted fragments (font, style, and colors).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls
import groupdocs.watermark.watermarks as gww

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for shape in content.worksheets[0].shapes:
        if shape.text == "© Aspose 2016":
            shape.formatted_text_fragments.clear()
            shape.formatted_text_fragments.add(
                "© GroupDocs 2017",
                gww.Font("Calibri", 19.0, gww.FontStyle.BOLD),
                gww.Color.red,
                gww.Color.aqua,
            )
    watermarker.save("spreadsheet.xlsx")
```

## Replacing shape image
This sample replaces the image content of shapes with a new image loaded from disk.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for shape in content.worksheets[0].shapes:
        if shape.image is not None:
            with open("test.png", "rb") as f:
                shape.image = gwc_xls.SpreadsheetWatermarkableImage(f.read())
    watermarker.save("spreadsheet.xlsx")
```

## Setting background image for particular shapes
This sample assigns a background image to shapes and configures transparency and tiling options.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for shape in content.worksheets[0].shapes:
        if shape.text == "© Aspose 2016":
            with open("test.png", "rb") as f:
                shape.image_fill_format.background_image = gwc_xls.SpreadsheetWatermarkableImage(f.read())
            shape.image_fill_format.transparency = 0.5
            shape.image_fill_format.tile_as_texture = True
    watermarker.save("spreadsheet.xlsx")
```

## Updating shape properties
This sample updates several shape properties such as alternative text, rotation, position, and size.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for shape in content.worksheets[0].shapes:
        if shape.text == "© Aspose 2019":
            shape.alternative_text = "watermark"
            shape.rotate_angle = 30
            shape.x = 200
            shape.y = 200
            shape.width = 400
            shape.height = 100
    watermarker.save("spreadsheet.xlsx")
```



---

## Sign documents with additional image adjustments

Path: /signature/java/sign-documents-with-additional-image-adjustments/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) contains [ImageAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance) class that implements extra image adjustment setting like

*   gray-scale ([setGrayscale](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance#setGrayscale(boolean)))
*   brightness ([setBrightness](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance#setBrightness(float)))
*   contrast ([setContrast](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance#setContrast(float)))
*   gamma correction ([setGammaCorrection](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance#setGammaCorrection(float)))
*   border ([setBorder](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance#setBorder(com.groupdocs.signature.domain.Border)))

Base signature class [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) property [setAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setAppearance(com.groupdocs.signature.options.appearances.SignatureAppearance)) should be set with instance of [ImageAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance) class to provide additional image adjustment

Here are the steps to setup extra image appearance with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Compose object of[ImageAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance) object with all required additional options.    
*   Set  [SignOptions.setAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setAppearance(com.groupdocs.signature.options.appearances.SignatureAppearance)) property with [ImageAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/ImageAppearance)  object.      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) to it.
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

## Sign document with image appearance

This example shows how to specify extra image appearances. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult)  

```java
Signature signature = new Signature("sample.pdf");
ImageSignOptions options = new ImageSignOptions("sample.jpg");
 
    // set signature position
options.setLeft(100);
options.setTop(100);
 
    // set signature rectangle
options.setWidth(100);
options.setHeight(30);
 
    // set signature alignment
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setBottom(20);
padding.setRight(20);
options.setMargin(padding);
 
    // setup image additional appearance as Brightness and Border
ImageAppearance imageAppearance = new ImageAppearance();
 
imageAppearance.setGrayscale(true);
imageAppearance.setContrast(0.2f);
imageAppearance.setGammaCorrection(0.3f);
imageAppearance.setBrightness(0.9f);
Border border = new Border();
 
border.setColor(Color.GREEN);
border.setDashStyle(DashStyle.DashLongDashDot);
border.setTransparency(0.5);
border.setVisible(true);
border.setWeight(2);
 
imageAppearance.setBorder(border);
options.setAppearance(imageAppearance);
 
// sign document to file
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Sign PDF document with Text signature Sticker appearance

This example shows how to add Text signature to Pdf document with sticker look. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult)  

```java
Signature signature = new Signature("sample.docx");
{
    TextSignOptions options = new TextSignOptions("John Smith");

        // set signature position
    options.setLeft(100);
    options.setTop(100);
        // set signature rectangle
    options.setWidth(100);
    options.setHeight(30);
        // setup proper signature implementation
    options.setSignatureImplementation(TextSignatureImplementation.Sticker);
    PdfTextStickerAppearance appearance = new PdfTextStickerAppearance();
    // select sticker icon
    appearance.setIcon(PdfTextStickerIcon.Star);
    // setup if popup annotation will be opened by default
    appearance.setOpened(false);
    // text content of an annotation
    appearance.setContents("Sample");
    appearance.setSubject("Sample subject");
    appearance.setTitle("Sample Title");

    options.setAppearance(appearance);

        // set signature alignment
    options.setVerticalAlignment(VerticalAlignment.Bottom);
    options.setHorizontalAlignment(HorizontalAlignment.Right);
    Padding margin = new Padding();
    margin.setBottom(20);
    margin.setRight(20) ;
    options.setMargin(margin) ;
   
        // set text color and Font
    options.setForeColor(Color.RED);
    SignatureFont font =new SignatureFont();
    font.setSize(12); 
    font.setFamilyName("Comic Sans MS");
    options.setFont(font);

    // sign document to file
    signature.sign("signed.docx", options);
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with additional image adjustments

Path: /signature/net/sign-documents-with-additional-image-adjustments/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) contains [ImageAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance) class that implements extra image adjustment setting like

* gray-scale ([Grayscale](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance/grayscale))
* brightness ([Brightness](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance/brightness))
* contrast ([Contrast](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance/contrast))
* gamma correction ([GammaCorrection](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance/gammacorrection))
* border ([Border](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance/border))

Base signature class [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) property [Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) should be set with instance of [ImageAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance) class to provide additional image adjustment

Here are the steps to setup extra image appearance with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Compose object of[ImageAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance) object with all required additional options.
* Set [SignOptions.Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) property with [ImageAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/imageappearance)  object.  
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

## Sign document with image appearance

This example shows how to specify extra image appearances. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    ImageSignOptions options = new ImageSignOptions("sample.jpg")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // set signature alignment
        VerticalAlignment = Domain.VerticalAlignment.Bottom,
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Bottom = 20, Right = 20 },
        // setup image additional appearance as Brightness and Border
        Appearance = new ImageAppearance()
        {
            Grayscale = true,
            Contrast = 0.2f,
            GammaCorrection = 0.3f,
            Brightness = 0.9f,
            Border = new Border()
            {
                Color = Color.DarkGreen,
                DashStyle = DashStyle.DashLongDashDot,
                Transparency = 0.5,
                Visible = true,
                Weight = 2
            }
        }
    };
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

## Sign PDF document with Text signature Sticker appearance

This example shows how to add Text signature to Pdf document with sticker look. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // setup proper signature implementation
        SignatureImplementation = TextSignatureImplementation.Sticker,
        Appearance = new PdfTextStickerAppearance()
        {
            // select sticker icon
            Icon = PdfTextStickerIcon.Star,
            // setup if popup annotation will be opened by default
            Opened = false,
            // text content of an annotation
            Contents = "Sample",
            Subject = "Sample subject",
            Title = "Sample Title"
        },
        // set signature alignment
        VerticalAlignment = Domain.VerticalAlignment.Bottom,
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Bottom = 20, Right = 20 },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
    };
    // sign document to file
    signature.Sign("signed.docx", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign Documents with PKCS#11 in .NET

Path: /signature/net/signing-pdf-with-pkcs11-standard/


{{< alert style="info" >}} 💡For the **complete working code** and detailed explanations, please refer to the [full repository here](https://github.com/groupdocs-signature/esign-documents-with-pkcs11-using-groupdocs-signature-dotnet).  
This repository contains all source files, helper classes, and configuration examples to implement PKCS#11 digital signing in your .NET applications.{{< /alert >}}


This article demonstrates how to sign documents with **PKCS#11 hardware tokens** (HSMs, smart cards, USB tokens) using **GroupDocs.Signature for .NET**.\
The sample project integrates the [Pkcs11Interop](https://github.com/Pkcs11Interop/Pkcs11Interop) library, which provides a .NET interface for PKCS#11 devices.

PKCS#11 devices can include **hardware security modules (HSMs)**, **smart cards**, and **USB dongles**.  
USB dongles are often used in corporate environments as a portable way to securely store private keys.  
With GroupDocs.Signature for .NET, you can use a dongle in the same way as other PKCS#11 tokens to apply digital signatures to your documents.


> 💡 Use this approach when you need to securely sign documents with a private key stored in hardware rather than in a local file.

## Prerequisites

Before proceeding, make sure you have:

-   **GroupDocs.Signature for .NET** installed. [Get a free trial](https://releases.groupdocs.com/signature/net/).
-   A PKCS#11--compatible device (HSM, smart card, or token).
-   [Pkcs11Interop](https://github.com/Pkcs11Interop/Pkcs11Interop) library.
-   .NET 6.0 or later (the sample also supports .NET Framework 4.6.2).


## Installation

Clone or download the [sample repository](https://github.com/groupdocs-signature/esign-documents-with-pkcs11-using-groupdocs-signature-dotnet).

``` bash
git clone https://github.com/groupdocs-signature/esign-documents-with-pkcs11-using-groupdocs-signature-dotnet.git
```

Restore dependencies with NuGet:

``` bash
dotnet restore
```

## Repository Structure

The project includes:

    GroupDocs.Signature-for-.NET-PKCS11-Sample
     ├── GroupDocs.Signature-for-.NET-PKCS11-Sample.csproj
     ├── Helpers.cs              # Utility functions for PKCS#11
     ├── Pkcs11DigitalSigner.cs  # Integration with GroupDocs.Signature
     ├── Program.cs              # Main entry point
     └── Settings.cs             # PKCS#11 configuration
    

## Usage Example

Below is a simplified version of the sample code. For the full implementation, see the [repository](https://github.com/groupdocs-signature/esign-documents-with-pkcs11-using-groupdocs-signature-dotnet).

### Configure PKCS#11 settings

`Settings.cs` defines the PKCS#11 library path, token PIN, and certificate subject:

``` csharp
public static class Settings
{
    public static string Pkcs11LibraryPath = "<PKCS11_LIBRARY_PATH>";
    public static string TokenPin = "<TOKEN_PIN>";
    public static string CertificateSubject = "<CERT_SUBJECT>";
}
```

### Initialize PKCS#11 signer

`Pkcs11DigitalSigner.cs` integrates PKCS#11 with GroupDocs.Signature:

``` csharp
public class Pkcs11DigitalSigner
{
    public X509Certificate2 GetCertificateFromPkcs11()
    {
        // Load certificate directly from token
        // Uses Settings.Pkcs11LibraryPath and Settings.TokenPin
    }
}
```

### Sign a document

`Program.cs` shows how to sign using GroupDocs.Signature.

This example demonstrates two flows:\
1. **Directly from PKCS#11 device**\
2. **From Windows certificate store**

``` csharp
using GroupDocs.Signature;
using GroupDocs.Signature.Options;
using System;

class Program
{
    static void Main()
    {
        string filePath = "sample.pdf";
        string outputPath = "signed.pdf";

        // (1) Sign using PKCS#11 device
        var pkcs11Signer = new Pkcs11DigitalSigner();
        var certificate = pkcs11Signer.GetCertificateFromPkcs11();

        using (var signature = new Signature(filePath))
        {
            var options = new DigitalSignOptions(certificate)
            {
                Comments = "Signed with PKCS#11 device",
                SignTime = DateTime.Now
            };

            signature.Sign(outputPath, options);
        }

        // (2) Sign using certificate from Windows store
        // var windowsCert = Helpers.GetCertificateFromWindowsStore(Settings.CertificateSubject);
        // (sign in the same way with windowsCert)
    }
}
```

## Notes

-   Replace `<PKCS11_LIBRARY_PATH>`, `<TOKEN_PIN>`, and `<CERT_SUBJECT>` with your actual values.
-   Both PKCS#11 and Windows certificate store flows are supported. Choose the one that matches your infrastructure.
-   For detailed helper methods and advanced scenarios, see the [full repository](https://github.com/groupdocs-signature/esign-documents-with-pkcs11-using-groupdocs-signature-dotnet).


{{< alert style="warning" >}}
 **Early Implementation Notice**  
 This solution is currently provided as an early implementation for using PKCS#11 digital signature dongles with GroupDocs.Signature.  
 While it enables document signing with hardware tokens, we strongly recommend performing additional testing in your own environment to ensure it meets your compliance and security requirements.
 We would greatly appreciate your feedback, test results, and suggestions for improvements.  
 Your input will help us refine this functionality and explore new ideas to make it more robust and user-friendly.
{{< /alert >}}

## See Also

-   [Digital Signatures in GroupDocs.Signature](https://docs.groupdocs.com/signature/net/sign-document-with-digital-signature-advanced/)
-   [Iterative Digital Signing](https://blog.groupdocs.com/signature/iterative-digital-signing/)
-   [Custom Hash Signing with Azure Key Vault](https://blog.groupdocs.com/signature/custom-hash-sign-with-azure-key-vault/)


---

## Single Row Image in Word Processing Document

Path: /assembly/java/single-row-image-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Word Processing Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Single Row Image in Microsoft Word Document

### Creating a Single Row Image

Please follow below steps to create a Single Row Image in MS Word 2013:

1.  Insert the desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Write "Name" and "Age" to show name and age info of the customer.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent information of first single manager with the following key requirements:

*   Report must show image of the manager
*   It must show Name and age of manager
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="172" valign="top" style="width: 129.05pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><img width="153" height="142" src="" alt="<<image [manager.getPhoto()]>>"></p></td><td width="436" valign="top" style="width: 326.9pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><table class="MsoTable15Plain2" border="0" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="116" valign="top" style="width: 86.7pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="font-size: 16pt;">Name:</span></b></p></td><td width="305" valign="top" style="width: 228.9pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="font-size: 16pt;">&lt;&lt;[manager.getName()]&gt;&gt;</span></b></p></td></tr><tr><td width="116" valign="top" style="width: 86.7pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="font-size: 16pt;">Age:</span></b></p></td><td width="305" valign="top" style="width: 228.9pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="font-size: 16pt;">&lt;&lt;[manager.getAge()]&gt;&gt;</span></p></td></tr></tbody></table><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"></p></td></tr></tbody></table>
### Download Single Row Template

Please download the sample Single Row document we created in this article:

*   [Single Row.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Single%20Row.docx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 725fe50be45e904ba2ba1224c4e7b92d >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Single Row Image in Word Processing Document

Path: /assembly/net/single-row-image-in-word-processing-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Word Processing Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Single Row Image in Microsoft Word Document

### Creating a Single Row Image

Please follow below steps to create a Single Row Image in MS Word 2013:

1.  Insert the desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Write "Name" and "Contact Number" to show name and contact info of the customer.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent information of first single customer with the following key requirements:

*   The report must show image of the customer
*   It must show Name and Contact Number of the customer
*   The report must be generated in the Word Processing Document.

{{< alert style="info" >}}See how to use images in MS Word [here](https://www.youtube.com/watch?v=vTef7N7NAvg&index=3&list=PLoVseBOSg-uQ2pLcb_hyZO2KRl0fKBQlE).{{< /alert >}}

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="padding-left: 5.4pt; padding-right: 5.4pt; vertical-align: top; width: 118.25pt;"><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; float: left; margin-top: 0pt; margin-right: 9pt; margin-bottom: 0pt; margin-left: 9pt; width: 122pt;"><tbody><tr style="height: 112pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 110.45pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;image [</span><span style="font-family: Calibri; font-size: 11pt;">customer.</span><span style="font-family: Calibri; font-size: 11pt;">Photo</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"></p></td><td style="padding-left: 5.4pt; padding-right: 5.4pt; vertical-align: top; width: 316.1pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="padding-left: 5.4pt; padding-right: 5.4pt; vertical-align: top; width: 43.95pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 14pt; font-weight: bold;">Name:</span></p></td><td style="padding-left: 5.4pt; padding-right: 5.4pt; vertical-align: top; width: 274.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">customer</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">.</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr><td style="padding-left: 5.4pt; padding-right: 5.4pt; vertical-align: top; width: 75.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">Contact Number</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">:</span></p></td><td style="padding-left: 5.4pt; padding-right: 5.4pt; vertical-align: top; width: 218.1pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 16pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 16pt;">customer</span><span style="font-family: Calibri; font-size: 16pt;">.</span><span style="font-family: Calibri; font-size: 16pt;">CustomerContactNumber</span><span style="font-family: Calibri; font-size: 16pt;">]&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Single Row Template

Please download the sample Single Row document we created in this article:

*   [Single Row.docx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Single%20Row.docx?raw=true)

{{< alert style="warning" >}}Use this template for DB, Dataset, JSON and XML examples also.{{< /alert >}}

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists e4ef2f1f940cd5c58b0fd1f6124f6a92 >}}

#### Database Entities

{{< gist GroupDocsGists 420eb7a9d0f15a2d6e858bdb3bdcc66e >}}

#### Using DataSet

{{< gist GroupDocsGists 1e369e8ace11cb3fdcb53150b8d9f48f >}}

#### Using XML DataSource

{{< gist GroupDocsGists 02c8e5e0c36d87ab15009a9feae52ab5 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists d78908e0d7709e8ec4ad31923a76bb33 >}}

## Single Row in OpenOffice Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Single Row' report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Single Row\_OpenDocument.odt](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Single%20Row_OpenDocument.odt?raw=true) (use same template for database, dataset, JSON and XML examples)

### Generating the report

#### Custom Objects

{{< gist GroupDocsGists 000834545ad0e8443536352e6d5afbde >}}

#### Database Entities

{{< gist GroupDocsGists 804476aa766be758044c7980041657b4 >}}

#### Using DataSet

{{< gist GroupDocsGists d64512141f0dfcc92571310d15f44a51 >}}

#### Using XML DataSource

{{< gist GroupDocsGists e98f5364270740d0df85fa333c1ec4d2 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 1c1b9029ebb7449f7286ff257d136511 >}}

### ODT Template and Report in Apache OpenOffice

In order to check compatibility of ODT between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODT template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODT report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Supported Document Types

Path: /merger/nodejs-java/supported-document-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Extract pages | Move page | Remove pages | Swap pages | Change page orientation | Rotate pages | Import document | Cross-format merge to PDF / XPS | Cross-format merge to DOC / DOCX |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Open XML Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Word Open XML Macro-Enabled Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Word Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Word Open XML Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Word Open XML Macro-Enabled Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) |   |
| [MHT](https://docs.fileformat.com/web/mhtml/) | MHTML Web Archive |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [PDF](https://docs.fileformat.com/view/pdf/) | Portable Document Format File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | XML Paper Specification File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File  | ![(tick)](/merger/net/images/check.png)|     |     |     |     |     |     |     |     |   |     |     |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel Template File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Excel Open XML Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Excel Open XML Macro-Enabled Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Open XML Macro-Enabled Add-in | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Microsoft Visio Macro-Enabled Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Microsoft Visio Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Microsoft Visio Macro-Enabled Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Microsoft Visio Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Microsoft Visio Macro-Enabled Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VTX](https://docs.fileformat.com/image/vtx/) | Microsoft Visio 2003-2010 XML Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [ERR](https://docs.fileformat.com/misc/err/) | Error Log File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/merger/32), and our team will assist you.

{{< /alert >}}
---

## Supported Document Types

Path: /merger/python-net/supported-document-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Password protection | Join | Split | Extract pages | Move page | Remove pages | Swap pages | Change page orientation | Rotate pages | Import document | Cross-format merge to PDF / XPS | Cross-format merge to DOC / DOCX |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Open XML Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Word Open XML Macro-Enabled Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Word Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Word Open XML Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Word Open XML Macro-Enabled Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) |   |
| [MHT](https://docs.fileformat.com/web/mhtml/) | MHTML Web Archive |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [PDF](https://docs.fileformat.com/view/pdf/) | Portable Document Format File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | XML Paper Specification File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File  | ![(tick)](/merger/net/images/check.png)|     |     |     |     |     |     |     |     |   |     |     |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel Template File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Excel Open XML Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Excel Open XML Macro-Enabled Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Open XML Macro-Enabled Add-in | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio Drawing File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio Stencil File |   |   |   |   |   |   |   |   |   |   |   |   |
| [VST](https://docs.fileformat.com/image/vst/) | Visio Drawing Template |   |   |   |   |   |   |   |   |   |   |   |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Microsoft Visio Macro-Enabled Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Microsoft Visio Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Microsoft Visio Macro-Enabled Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Microsoft Visio Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Microsoft Visio Macro-Enabled Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VTX](https://docs.fileformat.com/image/vtx/) | Microsoft Visio 2003-2010 XML Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [ERR](https://docs.fileformat.com/misc/err/) | Error Log File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/merger/32), and our team will assist you.

{{< /alert >}}
---

## System Requirements

Path: /conversion/python-net/system-requirements/


## General Requirements

- [Python](https://www.python.org/downloads/) versions **3.9–3.11** are supported

## Supported Operating Systems

### Windows

* Microsoft Windows 11 (x64)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 7, 8, 8.1, Vista, XP (x64, x86)
* Microsoft Windows Server 2003 and later

### Linux and macOS (partial support)

GroupDocs.Conversion include macOS support for Intel and/or Apple Silicon (M-series) processors. Linux packages will be added in future releases.

## Additional System Libraries

### Linux and macOS System Requirements

GroupDocs.Conversion for Python via .NET relies on `libgdiplus` for processing images or documents that contain images. 

#### Linux installation

When using GroupDocs.Conversion in a Linux environment, the following packages should be installed for proper library operation:

1. **libgdiplus** - Mono library providing a GDI+-compatible API on non-Windows operating systems.  
2. **libx11-dev** - Required for drawing functions (image/font rendering).  
3. **fontconfig** - Enables font lookup for text rendering with System.Drawing.  
4. **ttf-mscorefonts-installer** - Provides Microsoft-compatible fonts required by GroupDocs.Total.

To install packages on Debian-based Linux distributions, use [apt-get](https://wiki.debian.org/apt-get):

```bash
sudo apt-get update
sudo apt-get install -y libgdiplus libx11-dev fontconfig ttf-mscorefonts-installer
```

If some packages are not available, you can add the contrib repository:

```bash
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
```

#### macOS installation

The library is required and can be installed using the [Homebrew](https://brew.sh/) package manager:

```ps
brew install mono-libgdiplus
```

Ensure `libgdiplus` is installed if you encounter issues with processing images or documents that contain images.
---

## Template Syntax - Part 1 of 2

Path: /assembly/java/template-syntax-part-1-of-2/

{{< alert style="info" >}}This article is the first part of the Template Syntax series of articles. For second part, please visit Template Syntax - Part 2 of 2.{{< /alert >}}

## Composing Template

A typical template for [GroupDocs.Assembly](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/package-frame) Engine is composed of common document contents and tags that describe the template's structure and data bindings. You can form these tags using just running text that can occupy multiple paragraphs to be more descriptive.

A tag body must meet the following requirements:

*   A tag body must be surrounded by "<<" and ">>" character sequences.
*   A tag body must contain only text nodes.
*   A tag body must not be located inside markup document nodes.

A tag body typically consists of the following elements:

*   A tag name
*   An expression surrounded by brackets
*   A set of switches available for the tag, each of which is preceded by the "-" character

```java
<<tag_name [expression] -switch1 -switch2 ...>>
```

An optional comment can be written to provide a human-readable explanation.

```java
<<tag_name [expression] –switch1 –switch2 ... // optional_comment >>
```

{{< alert style="warning" >}}The optional comment feature is supported by version 19.1 or greater{{< /alert >}}

Particular tags can have additional elements. Some tags require closing counterparts. A closing tag has the "/" character that precedes its name. This tag's name must match to the name of the corresponding opening tag.

```java
<</tag_name>>
```

**Note:** Tag body elements are case-sensitive.

## Composing Expressions

### Using Lexical Tokens

The following table describes lexical tokens that you can use in template expressions and restrictions on these tokens' usage comparing with [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029).

| Token | Restrictions |
| --- | --- |
| **Keyword** | Only the following tokens are reserved as keywords: `true`, `false`, `null`, `new`, and `in` |
| **Identifier** |<ul><br/>	<li>The feature of keyword escaping through the "@" character is not supported.</li><br/>	<li>Unicode character escapes are not permitted in identifiers.</li><br/></ul>|
| **Literal** | <ul><br/>	<li>32-bit Unicode character escapes are not supported</li><br/>	<li>Unsigned integer and decimal literals are not permitted</li><br/></ul>|
| **Operator** | See [Using Operators](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-operators) |

You can use the following identifiers that are not preceded by a member access operator in template expressions:

*   The name of a passed data source object
*   The name of an iteration variable within its scope (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/java/template-syntax-part-2-of-2/#outputting-sequential-data) for more information)
*   The name of a lambda function parameter within the scope of the lambda function
*   A fully or partially qualified name of a type that is known by the engine (see [Setting up Known External Types](https://docs.groupdocs.com/assembly/java/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information)
*   The name of a member of an object that is determined as follows:
    *   Inside a data band body, the object is resolved to the innermost iteration variable.
    *   Outside a data band body, the object is resolved to a passed data source.

The feature of the omitting of an object identifier while accessing the object's members is also known as the contextual object member access. See [Using Contextual Object Member Access](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-contextual-object-member-access) for more information.

### Using Types

[GroupDocs.Assembly](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/package-frame) Engine enables you to use external visible types in template expressions. A `visible type` is a public type with outer types (if any) are public as well. You can use a data source object of any visible type to pass it to the engine.

However, you can use the identifier of a visible type in template expressions only if the following additional requirements are met:

*   The type is not void.
*   The type does not represent an array.
*   The type is not an open or closed generic type.

Also, the engine enables you to use anonymous types in template expressions. Such types are useful while composing expressions with grouping by multiple keys. See [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/java/template-syntax-part-2-of-2/#enumeration-extension-methods) for the examples.

#### Type Members

GroupDocs.Assembly Engine enables you to access the following public (static and instance) members of accessible types in template expressions:

*   Fields
*   Methods
*   Constructors

However, you can use a functional type member in template expressions only if the following additional requirements are met:

*   The functional member returns a value.
*   The functional member does not take generic type arguments.

The engine supports the following features when dealing with functional members:

*   Overload resolution according to [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029)
*   Using of parameters taking a variable number of arguments

### Using Extension Methods

GroupDocs.Assembly Engine enables you to use the following built-in extension methods in template expressions:

*   Extension methods mimicking the ones for `IEnumerable<T>` (see [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/java/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information)
*   Extension methods for iteration variables (see [Extension Methods of Iteration Variables](https://docs.groupdocs.com/assembly/java/template-syntax-part-2-of-2/#extension-methods-of-iteration-variables) for more information)

### Using Operators

The following list contains predefined operators that GroupDocs.Assembly Engine enables you to use in template expressions.

*   **Primary:**
  
    ```java
    x.y f(x) a[x] new
    ```
    
*   **Unary:**
  
    ```java
    - ! ~ (T)x
    ```
    
*   **Binary:**
  
    ```java
    * / % + - << >> < > <= >= == != & ^ | && || ??
    ```
    
*   **Ternary:**
  
    ```java
    ?:
    ```
    

The engine follows operator precedence, associations and overload resolution rules declared at [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029) while evaluating template expressions. This behavior normally conforms to Java. But be aware of the following limitations and differences in the behavior comparing with the specification and Java behavior:

*   String equality and inequality check operators test string contents, rather than string references.
*   Whereas the object initializer syntax is supported (including objects of anonymous types), the collection initializer syntax is not.

Also, the engine enables you to use lifted operators in template expressions. In Java, operands of lifted operators are represented by primitive type class wrappers like Integer, Double, and others, in contrast to nullable types in C#. That is, for example, given that variables a and b are of the Integer type and the value of a is null, expression "a + b" is evaluated to null by the engine, whereas it throws an exception in Java during runtime.

### Using Lambda Functions

GroupDocs.Assembly Engine enables you to use lambda functions only as arguments of built-in enumeration extension methods in template expressions. See [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/java/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information.

You can use both explicit and implicit lambda function signatures in template expressions. If you do not specify the type of a parameter of a lambda function explicitly, the type is determined implicitly by the engine depending on the type of the corresponding enumeration.

### Using Data Sources

#### DataSet Objects

{{< alert style="info" >}}This link will explain you how we utilized the DataSet Objects in Business Layer.{{< /alert >}}

GroupDocs.Assembly Engine enables you to access `DataTable` objects contained within a particular `DataSet` instance by table names using the "." operator in template expressions. That is, for example, given that `ds` is a `DataSet` instance that contains a `DataTable` named "Persons", you can access the table using the following syntax.

```java
ds.Persons
```

**Note** Table names are case-insensitive.

#### DataTable Objects

GroupDocs.Assembly Engine enables you to treat [`DataTable`](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataTable) objects in template expressions as enumerations of their rows. That is, you can use template expressions evaluated to such objects in `foreach` tags (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/java/template-syntax-part-2-of-2/#outputting-sequential-data) for more information).

Also, you can normally apply enumeration extension methods (see [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/java/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information) to `DataTable` objects in template expressions. For example, given that persons is a `DataTable` instance, you can count its rows using the following syntax.

```java
persons.count()
```

#### DataTable Row Objects

GroupDocs.Assembly Engine enables you to access a data associated with a particular [`DataTable`](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataTable) row instance in template expressions using the "." operator. The following table describes, which identifiers you can use to access different kinds of the data.

| Data Kind       | Identifier | Examples of Template Expressions                             |
| --------------- | ---------- | ------------------------------------------------------------ |
| **Field Value** | Field name | Given that r is a row that has a field named "Name", you can access the field's value using the following syntax.<br />`r.Name` |
| **Parent Row** | Parent table name | Given that r is a row of a DataTable that has a parent DataTable named "City", you can access the parent row of r using the following syntax.<br />`r.City`<br />Given that the "City" DataTable has a field named "Name", you can access the field's value for the parent row using the following syntax.<br />`r.City.Name` |
| **Child Rows** | Child table name | Given that r is a row of a DataTable that has a child DataTable named "Persons", you can access the enumeration of the child rows of r using the following syntax.<br />`r.Persons`<br />Given that the "Persons" DataTable has a field named "Age", you can count the child rows that correspond to persons over thirty years old using the following syntax.<br />`r.Persons.count(p => p.Age > 30)` |


**Note:** Field and table names are case-insensitive.

To determine parent-child relationships for a particular `DataTable` instance, the engine uses [DataRelation](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataRelation) objects contained within the corresponding [`DataSet`](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataSet) instance. Thus, you can manage these relationships in a common way.

### Using Images

{{< alert style="info" >}}See Common List with Image template using images in it.{{< /alert >}}

You can insert images to your reports dynamically using image tags. To declare a dynamically inserted image within your template, please follow these steps:

1.  Add a textbox to your template at the place where you want an image to be inserted.
2.  Set common image attributes such as frame, size, and others for the textbox, making the textbox look like a blank inserted image.
3.  Specify an image tag within the textbox using the following syntax.
  
    ```java
    <<image [image_expression]>>
    ```
    

The expression declared within an image tag is used by the engine to build an image to be inserted. The expression must return a value of one of the following types:

*   A byte array containing an image data
*   An InputStream instance able to read an image data
*   A BufferedImage object
*   A string containing an image URI

While building a report, the following procedure is applied to an image tag:

*   The expression declared within the tag is evaluated and its result is used to form an image.
*   The corresponding textbox is filled with this image.
*   The tag is removed from the textbox.

**Note:** If the expression declared within an image tag returns a stream object, then it is closed by the engine as soon as the corresponding image is built.

By default, the engine stretches an image filling a textbox to the size of the textbox. However, you can change this behavior in the following ways:

*   To keep the size of the textbox and stretch the image within bounds of the textbox preserving the ratio of the image, use the *keepRatio* switch as follows:
  ```java
    <<image [image_expression] -keepRatio>>
  ```
  
*   To keep the width of the textbox and change its height preserving the ratio of the image, use the fitHeight switch as follows:
  ```java
    <<image [image_expression] -fitHeight>>
  ```
  
*   To keep the height of the textbox and change its width preserving the ratio of the image, use the fitWidth switch as follows:
  
    ```java
    <<image [image_expression] -fitWidth>>
    ```
    
* To change the size of the textbox according to the size of the image, use the fitSize switch as follows:

    ```java
    <<image [image_expression] -fitSize>>
    ```

### Adding Combobox and Dropdown List Items Dynamically

You can dynamically add items to comboboxes and dropdown lists defined in your template by taking the following steps:

1. Add a combobox or dropdown list content control to your template at a place where you want it to appear in a result document.
2. By editing content control properties, add an `item` tag to the title of this content control using the following syntax.

```java
<<item [value_expression] [display_name_expression]>>
```

Here, `value_expression` defines a value of a combobox or dropdown list item to be added dynamically. This expression is mandatory and must return a non-empty value.

In turn, `display_name_expression` defines a display name of the combobox or dropdown list item to be added. This expression is optional. If it is omitted, then during runtime, a value of `value_expression` is used as a display name as well.

**Note –** Values of both `value_expression` and `display_name_expression` can be of any types. During runtime, `Object.toString()` is invoked to get textual representations of these expressions’ values.

While building a report, `value_expression` and `display_name_expression` are evaluated and a corresponding combobox or dropdown list item is added. A declaring `item` tag is removed then.

A single `item` tag causes addition of a single combobox or dropdown list item during runtime. You can add multiple combobox or dropdown list items using multiple `item` tags as shown in the following snippet.

```java
<<item ...>><<item ...>>
```

Also, you can normally use `item` tags within data bands to add a combobox or dropdown list item per item of a data collection. For example, given that `clients` is a `DataTable` instance having a field named “Name”, you can use the following template to cover such a scenario.

```java
<<foreach [client in clients]>><<item [client.Name]>><</foreach>>
```

An `item` tag can also be combined with an `if` tag to add a combobox or dropdown list item depending on a condition as shown in the following snippet.

```java
<<if ...>><<item ...>><</if>>
```

Existing combobox and dropdown list items are not affected by `item` tags. Thus, you can combine both ways of adding combobox and dropdown list items using a template: static and dynamic.

**Note –** While inserting a combobox or dropdown list, Microsoft Word adds a default item that has to be removed manually, if the item is unwanted.

### Using Hyperlinks 

Using GroupDocs.Assembly, you can insert hyperlinks to URI or Bookmarks to your reports dynamically using link tags. The syntax of a link tag is defined below for various types of documents:

#### Word Processing and Emails

```java
<<link [uri_or_bookmark_expression][display_text_expression]>>
```

#### Spreadsheets

If the insertion of the link to cell A1 is required: 

```java
<<link ["A1"] ["Home"]>>
```

#### Presentations

```java
<<link ["Slide1"] ["Home"]>>
```

### Using Contextual Object Member Access

{{< alert style="info" >}}See [In-Table List with Filtering, Grouping, and Ordering](https://docs.groupdocs.com/assembly/java/in-table-list-with-filtering-grouping-and-ordering-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine) template Contextual Object Member Access in it.{{< /alert >}}

You can make your templates less cumbersome using the contextual object member access feature. This feature enables you to access members of some objects without specifying the objects' identifiers in template expressions. An object to which the feature can be applied is determined depending on a context as follows:

*   Inside a data band body, the object is resolved to the innermost iteration variable.
*   Outside a data band body, the object is resolved to a passed data source.

Obviously, inside a data band body, you can not use the feature to access members of an outer iteration variable or a passed data source object. With the exception of this restriction, you can use both contextual and common object member access syntax interchangeably depending on your needs and preferences.

Consider the following example. Given that `ds` is a `DataSet` instance containing a `DataTable` object named "Persons" that has fields named "Name" and "Age", you can use the following template to list the contents of the table.

| No. | Name | Age |
| --- | --- | --- |
|`<<foreach [p in ds.Persons]>><<[p.numberOf()]>>`|`<<[p.Name]>>`|`<<[p.Age]>><</foreach>>`|
|`Count: <<[ds.Persons.count()]>>`| | |

Alternatively, you can use the following template involving the contextual object member access syntax to get the same results.

| No. | Name | Age |
| --- | --- | --- |
|`<<foreach [in Persons]>><<[numberOf()]>>`|`<<[Name]>>`|`<<[Age]>><</foreach>> `|
|`Count: <<[Persons.count()]>> `| | |

### Using Conditional Blocks

You can use different document blocks to represent the same data depending on a condition with the help of conditional blocks. A conditional block represents a set of template options, each of which is bound with a conditional expression. At runtime, these conditional expressions are sequentially evaluated, until an expression that returns true is reached. Then, the conditional block is replaced with the corresponding template option populated with data.

A conditional block can have a default template option that is not bound with a conditional expression. At runtime, this template option is used, when none of conditional expressions return true. If a default template option is missing and none of conditional expressions return true, then the whole conditional block is removed during runtime.

You can use the following syntax to declare a conditional block:

```java
<<if [conditional_expression1]>>
template_option1
<<elseif [conditional_expression2]>>
template_option2
...
<<else>>
default_template_option
<</if>>
```

**Note:** A conditional expression must return a Boolean value.

#### Common Conditional Blocks

{{< alert style="info" >}}See [Multicolored Numbered List](https://docs.groupdocs.com/assembly/java/multicolored-numbered-list-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine) template using Common Conditional Blocks in it.{{< /alert >}}

A common conditional block is a conditional block which body starts and ends within paragraphs that belong to a single story or table cell.
If a conditional block belongs to a single paragraph, it can be used as a replacement for an expression tag that involves the ternary "?:" operator. For example, given that items is an enumeration, you can use the following template to represent the count of elements in the enumeration:

```java
You have chosen <<if [!items.any()]>>no items<<else>><<[items.count()]>> item(s)<</if>>.
```

**Note:** A template option of a common conditional block can be composed of multiple paragraphs, if needed.

You can normally use common conditional blocks within data bands. For example, given that items is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them and apply different formatting for even and odd elements:

```java
<<foreach [item in items]>><<if [indexOf() % 2 == 0]>><<[item]>>
<<else>><<[item]>>
<</if>><</foreach>>
```

In this case, the engine produces a report as follows:
```
item1  
item2  
item3
```

You can use data bands within common conditional blocks as well. For example, given the previous declaration of items, you can check whether the enumeration contains any elements before outputting their list:

```java
<<if [!items.any()]>>No data.
<<else>><<foreach [item in items]>><<[item]>>
<</foreach>><</if>>
```

#### Table-Row Conditional Block

{{< alert style="info" >}}See [In-Table List with Highlighted Rows](https://docs.groupdocs.com/assembly/java/in-table-list-with-highlighted-rows-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine) template using Table-Row Conditional Block.{{< /alert >}}

A table-row conditional block is a conditional block which body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:  
**Note:** Table rows occupied by different template options in the following template are highlighted with different colors.

td { border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; }

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if ...&gt;&gt; ...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;elseif ...&gt;&gt; ...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt; ...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">... &lt;&lt;/if&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td></tr></tbody></table>
The following examples in this section are given using client, an instance of the Client class, and clients, an enumeration of instances of the Client class that is defined as follows:

```java
public class Client
{
    public String getName { ... }
    public String getCountry { ... }
    public String getLocalAddress { ... }
    ...
}
```

Using table-row conditional blocks, you can pick to output a single row among several rows of a single document table depending on a condition like in the following example:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if [client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getCountry</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;"> == "New Zealand"]&gt;&gt;&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getName</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getLocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getName</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getCountry</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getLocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
You can normally use table-row conditional blocks within data bands to make elements of an enumeration look differently depending on a condition. Consider the following template:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in clients]&gt;&gt;&lt;&lt;if [</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getCountry</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;"> == "New Zealand"]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getName</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getLocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getName</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getCountry</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getLocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
In this case, the engine produces the report as below:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">A Company</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Australia</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">219-241 Cleveland St</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">STRAWBERRY HILLS&nbsp; NSW&nbsp; 1427</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">B Ltd.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Brazil</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Avenida João Jorge, 112, ap. 31</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Vila Industrial</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Campinas - SP</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">13035-680</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">C &amp; D</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Canada</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">101-3485 RUE DE LA MONTAGNE</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">MONTRÉAL (QUÉBEC) H3G 2A6</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">E Corp.</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">445 Mount Eden Road</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Mount Eden</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Auckland 1024</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">F &amp; Partners</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">20 Greens Road</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Tuahiwi</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Kaiapoi 7691</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">G &amp; Co.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Greece</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Karkisias 6</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">GR-111 42&nbsp; ATHINA</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">GRÉCE</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">H Group</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Hungary</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Budapest</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Fiktív utca 82., IV. em./28.</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">2806</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">I &amp; Sons</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">43 Vogel Street</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Roslyn</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Palmerston North 4414</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">J Ent.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Japan</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Hakusan 4-Ch?me 3-2</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Bunky?-ku, T?KY?</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">112-0001</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Japan</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="info" >}}**Note:** You can use common conditional blocks within table-row data bands as well.{{< /alert >}}

Also, you can use data bands inside table-row conditional blocks. For example, you can provide an alternate content for an empty table-row data band using the following template:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Client</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getcountry</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Local Address</span></p></td></tr><tr><td colspan="3" style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!clients.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">any</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">()]&gt;&gt;No data</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;foreach [in clients]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getName</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getCountry</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getLocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;/foreach&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 155.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 113.4pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 198.15pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
In case, the corresponding enumeration is empty, the engine produces a report as below:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Client</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">getCountry</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Local Address</span></p></td></tr><tr><td colspan="3" style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">No data</span></p></td></tr><tr style="height: 0pt;"><td style="width: 155.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 113.4pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 198.15pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="info" >}}**Note:** If tags denoting boundaries of a template option are contained within a single table cell, the option is considered to be a common template option, rather than a table-row one. That is, the option is considered to occupy contents within the cell, rather than the whole row. That is why, a single-cell alternate content in the previous example is located between an opening if and else tags, rather than between an else and closing if tags.{{< /alert >}}

A typical template for LINQ Reporting Engine is composed of common document contents and tags that describe the template’s structure and data bindings. You can form these tags using just running text that can occupy multiple paragraphs to be more descriptive.


---

## Template Syntax - Part 1 of 2

Path: /assembly/net/template-syntax-part-1-of-2/

{{< alert style="info" >}}This article is the first part of the Template Syntax series of articles. For second part, please visit Template Syntax - Part 2 of 2.{{< /alert >}}

## Composing Template

A typical template for GroupDocs.Assembly Engine is composed of common document contents and tags that describe the template's structure and data bindings. You can form these tags using just running text that can occupy multiple paragraphs to be more descriptive.

A tag body must meet the following requirements:

*   A tag body must be surrounded by "`<<`" and "`>>`" character sequences.
*   A tag body must contain only text nodes.
*   A tag body must not be located inside markup document nodes.

A tag body typically consists of the following elements:

*   A tag name
*   An expression surrounded by brackets
*   A set of switches available for the tag, each of which is preceded by the "`-`" character

```csharp
<<tag_name [expression] -switch1 -switch2 ...>>
```

An optional comment can be written to provide a human-readable explanation.

```csharp
<<tag_name [expression] –switch1 –switch2 ... // optional_comment >>
```

{{< alert style="warning" >}}The optional comment feature is supported by version 19.1 or greater{{< /alert >}}

Particular tags can have additional elements. Some tags require closing counterparts. A closing tag has the "`/`" character that precedes its name. This tag's name must match to the name of the corresponding opening tag.

```csharp
<</tag_name>>
```

**Note:** Tag body elements are case-sensitive.

## Composing Expressions

### Using Lexical Tokens

The following table describes lexical tokens that you can use in template expressions and restrictions on these tokens' usage comparing with [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029).

| Token | Restrictions |
| --- | --- |
| **Keyword** | Only the following tokens are reserved as keywords: `true`, `false`, `null`, `new`, and `in` |
| **Identifier** | <ul><li>The feature of keyword escaping through the "@" character is not supported.</li><li>Unicode character escapes are not permitted in identifiers.</li></ul> |
| **Literal** | None |
| **Operator** | See [Using Operators](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/) |

You can use the following identifiers that are not preceded by a member access operator in template expressions:

*   The name of a passed data source object
*   The name of an iteration variable within its scope (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#outputting-sequential-data) for more information)
*   The name of a lambda function parameter within the scope of the lambda function
*   A fully or partially qualified name of a type that is known by the engine (see [Setting up Known External Types](https://docs.groupdocs.com/assembly/net/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information)
*   The name of a member of an object that is determined as follows:
    *   Inside a data band body, the object is resolved to the innermost iteration variable.
    *   Outside a data band body, the object is resolved to a passed data source.

The feature of the omitting of an object identifier while accessing the object's members is also known as the contextual object member access. See [Using Contextual Object Member Access](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/) for more information.

### Using Types

GroupDocs.Assembly Engine enables you to use external visible types in template expressions. A `visible type` is a public type with outer types (if any) are public as well. You can use a data source object of any visible type to pass it to the engine.

However, you can use the identifier of a visible type in template expressions only if the following additional requirements are met:

*   The type is not void.
*   The type does not represent an array.
*   The type is not an open or closed generic type.

**Note:** Whereas using of generic types' identifiers is forbidden in template expressions, you can use identifiers of nullable types in the shorthand `"T?"` form.

Also, the engine enables you to use anonymous types in template expressions. Such types are useful while composing expressions with grouping by multiple keys. See [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#enumeration-extension-methods) for the examples.

#### Type Members

GroupDocs.Assembly Engine enables you to access the following public (static and instance) members of accessible types in template expressions:

*   Fields
*   Properties
*   Indexer getters
*   Methods
*   Constructors

However, you can use a functional type member in template expressions only if the following additional requirements are met:

*   The functional member returns a value.
*   The functional member does not have `ref` or `out` parameters.
*   The functional member does not take generic type arguments.

The engine supports the following features when dealing with functional members:

*   Overload resolution according to [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029)
*   Using of default parameter values without support of named parameters
*   Using of parameters taking a variable number of arguments

### Using Extension Methods

GroupDocs.Assembly Engine enables you to use the following built-in extension methods in template expressions:

*   Extension methods mimicking the ones for `IEnumerable<T>` (see [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information)
*   Extension methods for iteration variables (see [Extension Methods of Iteration Variables](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#extension-methods-of-iteration-variables) for more information)

**Note:** Extension methods, other than the built-in ones, can be used only in the form of plain static methods in template expressions.

### Using Operators

The following list contains predefined and user-defined operators that Document Assembler enables you to use in template expressions.

*   **Primary:**
  
    ```csharp
    x.y f(x) a[x] new x?.y a?[x]  
    ```
    
*   **Unary:**
  
    ```csharp
    - ! ~ (T)x
    ```
    
*   **Binary:**
  
    ```csharp
    * / % + - << >> < > <= >= == != & ^ | && || ??
    ```
    
*   **Ternary:**
  
    ```csharp
    ?:
    ```
    

The engine follows operator precedence, associativity and overload resolution rules declared at [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029) while evaluating template expressions. But be aware of the following limitations in the behavior comparing with the specification:

*   Implicit user-defined conversions are supported only when specified explicitly.
*   The indexing of multi-dimensional arrays is not supported.
*   Whereas the object initializer syntax is supported (including objects of anonymous types), the collection initializer syntax is not.

Also, the engine enables you to use lifted operators in template expressions.

### Using Lambda Functions

GroupDocs.Assembly Engine enables you to use lambda functions only as arguments of built-in enumeration extension methods in template expressions. See [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information.

**Note:** Lambda functions declared within template expressions are not interchangeable with delegates. Thus, you can not pass delegates as arguments to built-in enumeration extension methods.

You can use both explicit and implicit lambda function signatures in template expressions. If you do not specify the type of a parameter of a lambda function explicitly, the type is determined implicitly by the engine depending on the type of the corresponding enumeration.

### Using Data Sources

#### DataSet Objects

{{< alert style="info" >}}[This link](https://docs.groupdocs.com/assembly/net/the-business-layer/#dataset-source) will explain you how we utilized the DataSet Objects in Business Layer.{{< /alert >}}

GroupDocs.Assembly Engine enables you to access `DataTable` objects contained within a particular `DataSet` instance by table names using the "." operator in template expressions. That is, for example, given that `ds` is a `DataSet` instance that contains a `DataTable` named "Persons", you can access the table using the following syntax.

```csharp
ds.Persons
```

**Note** Table names are case-insensitive.

#### DataTable and DataView Objects

GroupDocs.Assembly Engine enables you to treat `DataTable` and `DataView` objects in template expressions as enumerations of their rows. That is, you can use template expressions evaluated to such objects in `foreach` tags (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#outputting-sequential-data) for more information).

Also, you can normally apply enumeration extension methods (see [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information) to `DataTable` and `DataView` objects in template expressions. For example, given that persons is a `DataTable` or `DataView` instance, you can count its rows using the following syntax.

```csharp
persons.Count()
```

#### DataRow and DataRowView Objects

GroupDocs.Assembly Engine enables you to access a data associated with a particular `DataRow` or `DataRowView` instance in template expressions using the "." operator. The following table describes, which identifiers you can use to access different kinds of the data.

| Data Kind | Identifier | Examples of Template Expressions |
| --- | --- | --- |
| **Field Value** | Field name | Given that `r` is a row that has a field named "Name", you can access the field’s value using the following syntax:<br />`r.Name`. |
| **Single Parent or Child Row** | Parent (child) table name | Given that `r` is a row of a `DataTable` that has a parent (child) `DataTable` named "City", you can access the single parent (child) row of `r` using the following syntax:<br />`r.City`.<br />Given that the "City" `DataTable` has a field named "Name", you can access the field’s value for the single parent (child) row using the following syntax:<br />`r.City.Name`. |
| **Enumeration of Child or Parent Rows** | Child (parent) table name | Given that `r` is a row of a `DataTable` that has a child (parent) `DataTable` named "Persons", you can access the enumeration of the child (parent) rows of `r` using the following syntax:<br />`r.Persons`.<br />Given that the "Persons" `DataTable` has a field named "Age", you can count the child (parent) rows that correspond to persons over thirty years old using the following syntax:<br />`r.Persons.Count(p => p.Age > 30)`. |

{{< alert style="warning" >}} Field and table names are case-insensitive.{{< /alert >}}

To determine parent-child relationships for a particular `DataTable` instance, the engine uses *[DataRelation](http://msdn.microsoft.com/en-us/library/system.data.datarelation(v=vs.110).aspx)* objects contained within the corresponding `DataSet` instance. Thus, you can manage these relationships in a common way.

{{< alert style="warning" >}}Instead of using of table names to access data of child or parent rows, you can also use relation names, which is useful when you deal with multiple relations to the same table.{{< /alert >}}

  

#### IDataReader Implementors

GroupDocs.Assembly Engine enables you to treat `IDataReader` implementors as enumerations of `IDataRecord` implementors in template expressions. That is, you can use `IDataReader` implementors in template expressions in the same way as `DataTable` objects. See [Working with DataTable and DataView Objects](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/) for more information.

However, you can not use IDataReader implementors in template expressions in conjunction with enumeration operations that require a caching of enumeration items. The examples of such operations are grouping and sorting. To work around this restriction, use DataTable objects instead.

#### IDataRecord Implementors

Document Assembler enables you to access field values of a particular `IDataRecord` implementor by field names using the "." operator in template expressions. To use this feature, one of the following conditions must be met:

*   The `IDataRecord` implementor represents an iteration variable upon enumerating an `IDataReader` implementor (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/#outputting-sequential-data) for more information).
*   The `IDataRecord` implementor does not implement the `IDataReader` interface.

The following example shows, how to use this feature. Given that `r` is an `IDataRecord` implementor that has a field named "Name", you can access the field's value using the following syntax.

```csharp
r.Name
```

**Note** Field names are case-insensitive.

### Using Images

You can insert images to your reports dynamically using image tags. To declare a dynamically inserted image within your template, please follow these steps:

1.  Add a textbox to your template at the place where you want an image to be inserted.
2.  Set common image attributes such as frame, size, and others for the textbox, making the textbox look like a blank inserted image.
3.  Specify an image tag within the textbox using the following syntax.
  
    ```csharp
    <<image [image_expression]>>
    
    ```
    

The expression declared within an image tag is used by the engine to build an image to be inserted. The expression must return a value of one of the following types:

*   A byte array containing an image data
*   A [Stream](http://msdn.microsoft.com/en-us/library/system.io.stream(v=vs.110).aspx) instance able to read an image data
*   An [Image](http://msdn.microsoft.com/en-us/library/system.drawing.image(v=vs.110).aspx) object
*   A string containing an image URI, path, or Base64-encoded image data

While building a report, the following procedure is applied to an image tag:

*   The expression declared within the tag is evaluated and its result is used to form an image.
*   The corresponding textbox is filled with this image.
*   The tag is removed from the textbox.

**Note:** If the expression declared within an image tag returns a stream object, then it is closed by the engine as soon as the corresponding image is built.

By default, the assembler stretches an image filling a textbox to the size of the textbox. However, you can change this behavior in the following ways:

*   To keep the size of the textbox and stretch the image within bounds of the textbox preserving the ratio of the image, use the *keepRatio* switch as follows:
  
    ```csharp
    <<image [image_expression] -keepRatio>>
    ```
    
*   To keep the width of the textbox and change its height preserving the ratio of the image, use the fitHeight switch as follows.
  
    ```csharp
    <<image [image_expression] -fitHeight>>
    ```
    
*   To keep the height of the textbox and change its width preserving the ratio of the image, use the fitWidth switch as follows.
  
    ```csharp
    <<image [image_expression] -fitWidth>>
    ```
    
*   To change the size of the textbox according to the size of the image, use the fitSize switch as follows.
  
    ```csharp
    <<image [image_expression] -fitSize>>
    ```
    
*   To change the size of the textbox according to the size of the image without increasing the size of the textbox, use the fitSizeLim switch as follows.
  
    ```csharp
    <<image [image_expression] -fitSizeLim>>
    ```
    
    {{< alert style="warning" >}}If the size of the image is greater than the size of the textbox, then the fitSizeLim switch acts like fitHeight or fitWidth. Otherwise, the fitSizeLim switch acts like fitSize.{{< /alert >}}
    

### Inserting Documents

You can insert contents of outer documents to your reports dynamically using doc tags. A doc tag denotes a placeholder within a template for a document to be inserted during runtime.

Syntax of a doc tag is defined as follows.

```csharp
<<doc [document_expression]>>
```

{{< alert style="warning" >}}A doc tag can be used almost anywhere in a template document except textboxes and charts.{{< /alert >}}

An expression declared within a doc tag is used by the assembler to load a document to be inserted during runtime. The expression must return a value of one of the following types:

*   A byte array containing document data
*   A [Stream](http://msdn.microsoft.com/en-us/library/system.io.stream(v=vs.110).aspx) instance able to read document data
*   An instance of the Document class
*   A string containing a document URI, path, or Base64-encoded document data

While building a report, an expression declared within a doc tag is evaluated and its result is used to load a document which content replaces the doc tag then.

{{< alert style="warning" >}}If an expression declared within a doc tag returns a stream object, then the stream is closed by the assembler as soon as a corresponding document is loaded.{{< /alert >}}

By default, a document being inserted is not checked against template syntax and is not populated with data. However, you can enable this by using a build switch as follows.

```csharp
<<doc [document_expression] -build>>
```

When a build switch is used, the assembler treats a document being inserted as a template that can access the following data available at the scope of a corresponding doc tag:

*   Data sources
*   Variables
*   A contextual object 
*   Known external types 

### Setting Checkbox Values Dynamically

You can set checkbox values to either checked or unchecked in your reports dynamically by taking the following steps:

1.  Add a checkbox content control to your template at a place where you want it to appear in a result document.
2.  By editing content control properties, add a check tag to the title of the checkbox content control using the following syntax.

```csharp
<<check [conditional_expression]>>
```

Here, conditional\_expression defines a condition upon which the value of the checkbox content control is to be set to checked (or unchecked, if the condition is not met). The conditional expression must return a Boolean value.

While building a report, a conditional expression declared within a check tag is evaluated and the value of its containing checkbox content control is set accordingly. The check tag itself is removed then.

{{< alert style="warning" >}}Dynamic checkbox value setting is available for Word Processing documents only.{{< /alert >}}

### Adding Combobox and Dropdown List Items Dynamically

You can dynamically add items to comboboxes and dropdown lists defined in your template by taking the following steps:

1. Add a combobox or dropdown list content control to your template at a place where you want it to appear in a result document.
2. By editing content control properties, add an `item` tag to the title of this content control using the following syntax.

```csharp
<<item [value_expression] [display_name_expression]>>
```

Here, `value_expression` defines a value of a combobox or dropdown list item to be added dynamically. This expression is mandatory and must return a non-empty value.

In turn, `display_name_expression` defines a display name of the combobox or dropdown list item to be added. This expression is optional. If it is omitted, then during runtime, a value of `value_expression` is used as a display name as well.

**Note –** Values of both `value_expression` and `display_name_expression` can be of any types. During runtime, `Object.ToString()` is invoked to get textual representations of these expressions’ values.

While building a report, `value_expression` and `display_name_expression` are evaluated and a corresponding combobox or dropdown list item is added. A declaring `item` tag is removed then.

A single `item` tag causes addition of a single combobox or dropdown list item during runtime. You can add multiple combobox or dropdown list items using multiple `item` tags as shown in the following snippet.

```csharp
<<item ...>><<item ...>>
```

Also, you can normally use `item` tags within data bands to add a combobox or dropdown list item per item of a data collection. For example, given that `clients` is a `DataTable` instance having a field named “Name”, you can use the following template to cover such a scenario.

```csharp
<<foreach [client in clients]>><<item [client.Name]>><</foreach>>
```

An `item` tag can also be combined with an `if` tag to add a combobox or dropdown list item depending on a condition as shown in the following snippet.

```csharp
<<if ...>><<item ...>><</if>>
```

Existing combobox and dropdown list items are not affected by `item` tags. Thus, you can combine both ways of adding combobox and dropdown list items using a template: static and dynamic.

**Note –** While inserting a combobox or dropdown list, Microsoft Word adds a default item that has to be removed manually, if the item is unwanted.

### Using Hyperlinks 

Using GroupDocs.Assembly, you can insert hyperlinks to URI or Bookmarks to your reports dynamically using link tags. The syntax of a link tag is defined below for various types of documents:

#### Word Processing and Emails

```csharp
<<link [uri_or_bookmark_expression][display_text_expression]>>
```

#### Spreadsheets

If the insertion of the link to cell A1 is required:

```csharp
<<link ["A1"] ["Home"]>>
```

#### Presentations

```csharp
<<link ["Slide1"] ["Home"]>>
```

### Using Contextual Object Member Access

You can make your templates less cumbersome using the contextual object member access feature. This feature enables you to access members of some objects without specifying the objects' identifiers in template expressions. An object to which the feature can be applied is determined depending on a context as follows:

*   Inside a data band body, the object is resolved to the innermost iteration variable.
*   Outside a data band body, the object is resolved to a passed data source.

Obviously, inside a data band body, you can not use the feature to access members of an outer iteration variable or a passed data source object. With the exception of this restriction, you can use both contextual and common object member access syntaxes interchangeably depending on your needs and preferences.

Consider the following example. Given that `ds` is a `DataSet` instance containing a `DataTable` object named "Persons" that has fields named "Name" and "Age", you can use the following template to list the contents of the table.

| No. | Name | Age |
| --- | --- | --- |
| `<<foreach [p in ds.Persons]>><<[p.NumberOf()]>>` | `<<[p.Name]>>` | `<<[p.Age]>><</foreach>>` |
| `Count: <<[ds.Persons.Count()]>>` |  |  |

Alternatively, you can use the following template involving the contextual object member access syntax to get the same results.

| No. | Name | Age |
| --- | --- | --- |
| `<<foreach [in Persons]>><<[NumberOf()]>>` | `<<[Name]>>` | `<<[Age]>><</foreach>>` |
| `Count: <<[Persons.Count()]>>` |  |  |

### Using Conditional Blocks

You can use different document blocks to represent the same data depending on a condition with the help of conditional blocks. A conditional block represents a set of template options, each of which is bound with a conditional expression. At runtime, these conditional expressions are sequentially evaluated, until an expression that returns true is reached. Then, the conditional block is replaced with the corresponding template option populated with data.  
A conditional block can have a default template option that is not bound with a conditional expression. At runtime, this template option is used, when none of conditional expressions return true. If a default template option is missing and none of conditional expressions return true, then the whole conditional block is removed during runtime.

You can use the following syntax to declare a conditional block:

```csharp
<<if [conditional_expression1]>>
template_option1
<<elseif [conditional_expression2]>>
template_option2
...
<<else>>
default_template_option
<</if>>
```

**Note:** A conditional expression must return a Boolean value.

#### Common Conditional Blocks

A common conditional block is a conditional block which body starts and ends within paragraphs that belong to a single story or table cell.  
If a conditional block belongs to a single paragraph, it can be used as a replacement for an expression tag that involves the ternary "?:" operator. For example, given that items is an enumeration, you can use the following template to represent the count of elements in the enumeration:

```csharp
You have chosen <<if [!items.Any()]>>no items<<else>><<[items.Count()]>> item(s)<</if>>.
```

**Note:** A template option of a common conditional block can be composed of multiple paragraphs, if needed.

You can normally use common conditional blocks within data bands. For example, given that items is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them and apply different formatting for even and odd elements:

```csharp
<<foreach \[item in items\]>><<if \[IndexOf() % 2 == 0\]>><<\[item\]>>  
<<else>><<\[item\]>>  
<</if>><</foreach>>
```

In this case, the engine produces a report as follows:

item1  
item2  
item3

You can use data bands within common conditional blocks as well. For example, given the previous declaration of items, you can check whether the enumeration contains any elements before outputting their list:

```csharp
<<if [!items.Any()]>>No data.
<<else>><<foreach [item in items]>><<[item]>>
<</foreach>><</if>>
```

#### Table-Row Conditional Block

A table-row conditional block is a conditional block which body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:  
**Note:** Table rows occupied by different template options in the following template are highlighted with different colors.

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if ...&gt;&gt; ...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;elseif ...&gt;&gt; ...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt; ...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">... &lt;&lt;/if&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td></tr></tbody></table>
The following examples in this section are given using client, an instance of the Client class, and clients, an enumeration of instances of the Client class that is defined as follows:

```csharp
public class Client
{
    public String Name { get { ... } }
    public String Country { get { ... } }
    public String LocalAddress { get { ... } }
    ...
}
```

Using table-row conditional blocks, you can pick to output a single row among several rows of a single document table depending on a condition like in the following example:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if [client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;"> == "New Zealand"]&gt;&gt;&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
You can normally use table-row conditional blocks within data bands to make elements of an enumeration look differently depending on a condition. Consider the following template:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in clients]&gt;&gt;&lt;&lt;if [</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;"> == "New Zealand"]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
In this case, the engine produces the report as below:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">A Company</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Australia</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">219-241 Cleveland St</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">STRAWBERRY HILLS&nbsp; NSW&nbsp; 1427</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">B Ltd.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Brazil</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Avenida João Jorge, 112, ap. 31</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Vila Industrial</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Campinas - SP</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">13035-680</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">C &amp; D</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Canada</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">101-3485 RUE DE LA MONTAGNE</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">MONTRÉAL (QUÉBEC) h2G 2A6</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">E Corp.</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">445 Mount Eden Road</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Mount Eden</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Auckland 1024</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">F &amp; Partners</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">20 Greens Road</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Tuahiwi</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Kaiapoi 7691</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">G &amp; Co.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Greece</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Karkisias 6</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">GR-111 42&nbsp; ATHINA</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">GRÉCE</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">H Group</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Hungary</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Budapest</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Fiktív utca 82., IV. em./28.</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">2806</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">I &amp; Sons</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">43 Vogel Street</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Roslyn</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Palmerston North 4414</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">J Ent.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Japan</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Hakusan 4-Ch?me 3-2</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Bunky?-ku, T?KY?</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">112-0001</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Japan</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="info" >}}**Note:** You can use common conditional blocks within table-row data bands as well.{{< /alert >}}

Also, you can use data bands inside table-row conditional blocks. For example, you can provide an alternate content for an empty table-row data band using the following template:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Client</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Local Address</span></p></td></tr><tr><td colspan="3" style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!clients.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Any</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">()]&gt;&gt;No data</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;foreach [in clients]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;/foreach&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 155.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 113.4pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 198.15pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
In case, the corresponding enumeration is empty, the engine produces a report as below:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Client</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Local Address</span></p></td></tr><tr><td colspan="3" style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">No data</span></p></td></tr><tr style="height: 0pt;"><td style="width: 155.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 113.4pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 198.15pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="info" >}}**Note:** If tags denoting boundaries of a template option are contained within a single table cell, the option is considered to be a common template option, rather than a table-row one. That is, the option is considered to occupy contents within the cell, rather than the whole row. That is why, a single-cell alternate content in the previous example is located between an opening if and else tags, rather than between an else and closing if tags.{{< /alert >}}


---

## Template Syntax - Part 1 of 2

Path: /assembly/python-net/template-syntax-part-1-of-2/

{{< alert style="info" >}}This article is the first part of the Template Syntax series of articles. For second part, please visit Template Syntax - Part 2 of 2.{{< /alert >}}

## Composing Template

A typical template for GroupDocs.Assembly Engine is composed of common document contents and tags that describe the template's structure and data bindings. You can form these tags using just running text that can occupy multiple paragraphs to be more descriptive.

A tag body must meet the following requirements:

*   A tag body must be surrounded by "`<<`" and "`>>`" character sequences.
*   A tag body must contain only text nodes.
*   A tag body must not be located inside markup document nodes.

A tag body typically consists of the following elements:

*   A tag name
*   An expression surrounded by brackets
*   A set of switches available for the tag, each of which is preceded by the "`-`" character

```csharp
<<tag_name [expression] -switch1 -switch2 ...>>
```

An optional comment can be written to provide a human-readable explanation.

```csharp
<<tag_name [expression] –switch1 –switch2 ... // optional_comment >>
```

{{< alert style="warning" >}}The optional comment feature is supported by version 19.1 or greater{{< /alert >}}

Particular tags can have additional elements. Some tags require closing counterparts. A closing tag has the "`/`" character that precedes its name. This tag's name must match to the name of the corresponding opening tag.

```csharp
<</tag_name>>
```

**Note:** Tag body elements are case-sensitive.

## Composing Expressions

### Using Lexical Tokens

The following table describes lexical tokens that you can use in template expressions and restrictions on these tokens' usage comparing with [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029).

| Token | Restrictions |
| --- | --- |
| **Keyword** | Only the following tokens are reserved as keywords: `true`, `false`, `null`, `new`, and `in` |
| **Identifier** | <ul><li>The feature of keyword escaping through the "@" character is not supported.</li><li>Unicode character escapes are not permitted in identifiers.</li></ul> |
| **Literal** | None |
| **Operator** | See [Using Operators](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/) |

You can use the following identifiers that are not preceded by a member access operator in template expressions:

*   The name of a passed data source object
*   The name of an iteration variable within its scope (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#outputting-sequential-data) for more information)
*   The name of a lambda function parameter within the scope of the lambda function
*   A fully or partially qualified name of a type that is known by the engine (see [Setting up Known External Types](https://docs.groupdocs.com/assembly/python-net/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information)
*   The name of a member of an object that is determined as follows:
    *   Inside a data band body, the object is resolved to the innermost iteration variable.
    *   Outside a data band body, the object is resolved to a passed data source.

The feature of the omitting of an object identifier while accessing the object's members is also known as the contextual object member access. See [Using Contextual Object Member Access](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/) for more information.

### Using Types

GroupDocs.Assembly Engine enables you to use external visible types in template expressions. A `visible type` is a public type with outer types (if any) are public as well. You can use a data source object of any visible type to pass it to the engine.

However, you can use the identifier of a visible type in template expressions only if the following additional requirements are met:

*   The type is not void.
*   The type does not represent an array.
*   The type is not an open or closed generic type.

**Note:** Whereas using of generic types' identifiers is forbidden in template expressions, you can use identifiers of nullable types in the shorthand `"T?"` form.

Also, the engine enables you to use anonymous types in template expressions. Such types are useful while composing expressions with grouping by multiple keys. See [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#enumeration-extension-methods) for the examples.

#### Type Members

GroupDocs.Assembly Engine enables you to access the following public (static and instance) members of accessible types in template expressions:

*   Fields
*   Properties
*   Indexer getters
*   Methods
*   Constructors

However, you can use a functional type member in template expressions only if the following additional requirements are met:

*   The functional member returns a value.
*   The functional member does not have `ref` or `out` parameters.
*   The functional member does not take generic type arguments.

The engine supports the following features when dealing with functional members:

*   Overload resolution according to [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029)
*   Using of default parameter values without support of named parameters
*   Using of parameters taking a variable number of arguments

### Using Extension Methods

GroupDocs.Assembly Engine enables you to use the following built-in extension methods in template expressions:

*   Extension methods mimicking the ones for `IEnumerable<T>` (see [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information)
*   Extension methods for iteration variables (see [Extension Methods of Iteration Variables](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#extension-methods-of-iteration-variables) for more information)

**Note:** Extension methods, other than the built-in ones, can be used only in the form of plain static methods in template expressions.

### Using Operators

The following list contains predefined and user-defined operators that Document Assembler enables you to use in template expressions.

*   **Primary:**
  
    ```csharp
    x.y f(x) a[x] new x?.y a?[x]  
    ```
    
*   **Unary:**
  
    ```csharp
    - ! ~ (T)x
    ```
    
*   **Binary:**
  
    ```csharp
    * / % + - << >> < > <= >= == != & ^ | && || ??
    ```
    
*   **Ternary:**
  
    ```csharp
    ?:
    ```
    

The engine follows operator precedence, associativity and overload resolution rules declared at [C# Language Specification 5.0](http://www.microsoft.com/en-us/download/details.aspx?id=7029) while evaluating template expressions. But be aware of the following limitations in the behavior comparing with the specification:

*   Implicit user-defined conversions are supported only when specified explicitly.
*   The indexing of multi-dimensional arrays is not supported.
*   Whereas the object initializer syntax is supported (including objects of anonymous types), the collection initializer syntax is not.

Also, the engine enables you to use lifted operators in template expressions.

### Using Lambda Functions

GroupDocs.Assembly Engine enables you to use lambda functions only as arguments of built-in enumeration extension methods in template expressions. See [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information.

**Note:** Lambda functions declared within template expressions are not interchangeable with delegates. Thus, you can not pass delegates as arguments to built-in enumeration extension methods.

You can use both explicit and implicit lambda function signatures in template expressions. If you do not specify the type of a parameter of a lambda function explicitly, the type is determined implicitly by the engine depending on the type of the corresponding enumeration.

### Using Data Sources

#### DataSet Objects

{{< alert style="info" >}}[This link](https://docs.groupdocs.com/assembly/python-net/the-business-layer/#dataset-source) will explain you how we utilized the DataSet Objects in Business Layer.{{< /alert >}}

GroupDocs.Assembly Engine enables you to access `DataTable` objects contained within a particular `DataSet` instance by table names using the "." operator in template expressions. That is, for example, given that `ds` is a `DataSet` instance that contains a `DataTable` named "Persons", you can access the table using the following syntax.

```csharp
ds.Persons
```

**Note** Table names are case-insensitive.

#### DataTable and DataView Objects

GroupDocs.Assembly Engine enables you to treat `DataTable` and `DataView` objects in template expressions as enumerations of their rows. That is, you can use template expressions evaluated to such objects in `foreach` tags (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#outputting-sequential-data) for more information).

Also, you can normally apply enumeration extension methods (see [Enumeration Extension Methods](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#enumeration-extension-methods) for more information) to `DataTable` and `DataView` objects in template expressions. For example, given that persons is a `DataTable` or `DataView` instance, you can count its rows using the following syntax.

```csharp
persons.Count()
```

#### DataRow and DataRowView Objects

GroupDocs.Assembly Engine enables you to access a data associated with a particular `DataRow` or `DataRowView` instance in template expressions using the "." operator. The following table describes, which identifiers you can use to access different kinds of the data.

| Data Kind | Identifier | Examples of Template Expressions |
| --- | --- | --- |
| **Field Value** | Field name | Given that `r` is a row that has a field named "Name", you can access the field’s value using the following syntax:<br />`r.Name`. |
| **Single Parent or Child Row** | Parent (child) table name | Given that `r` is a row of a `DataTable` that has a parent (child) `DataTable` named "City", you can access the single parent (child) row of `r` using the following syntax:<br />`r.City`.<br />Given that the "City" `DataTable` has a field named "Name", you can access the field’s value for the single parent (child) row using the following syntax:<br />`r.City.Name`. |
| **Enumeration of Child or Parent Rows** | Child (parent) table name | Given that `r` is a row of a `DataTable` that has a child (parent) `DataTable` named "Persons", you can access the enumeration of the child (parent) rows of `r` using the following syntax:<br />`r.Persons`.<br />Given that the "Persons" `DataTable` has a field named "Age", you can count the child (parent) rows that correspond to persons over thirty years old using the following syntax:<br />`r.Persons.Count(p => p.Age > 30)`. |

{{< alert style="warning" >}} Field and table names are case-insensitive.{{< /alert >}}

To determine parent-child relationships for a particular `DataTable` instance, the engine uses *[DataRelation](http://msdn.microsoft.com/en-us/library/system.data.datarelation(v=vs.110).aspx)* objects contained within the corresponding `DataSet` instance. Thus, you can manage these relationships in a common way.

{{< alert style="warning" >}}Instead of using of table names to access data of child or parent rows, you can also use relation names, which is useful when you deal with multiple relations to the same table.{{< /alert >}}

  

#### IDataReader Implementors

GroupDocs.Assembly Engine enables you to treat `IDataReader` implementors as enumerations of `IDataRecord` implementors in template expressions. That is, you can use `IDataReader` implementors in template expressions in the same way as `DataTable` objects. See [Working with DataTable and DataView Objects](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/) for more information.

However, you can not use IDataReader implementors in template expressions in conjunction with enumeration operations that require a caching of enumeration items. The examples of such operations are grouping and sorting. To work around this restriction, use DataTable objects instead.

#### IDataRecord Implementors

Document Assembler enables you to access field values of a particular `IDataRecord` implementor by field names using the "." operator in template expressions. To use this feature, one of the following conditions must be met:

*   The `IDataRecord` implementor represents an iteration variable upon enumerating an `IDataReader` implementor (see [Outputting Sequential Data](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-2-of-2/#outputting-sequential-data) for more information).
*   The `IDataRecord` implementor does not implement the `IDataReader` interface.

The following example shows, how to use this feature. Given that `r` is an `IDataRecord` implementor that has a field named "Name", you can access the field's value using the following syntax.

```csharp
r.Name
```

**Note** Field names are case-insensitive.

### Using Images

You can insert images to your reports dynamically using image tags. To declare a dynamically inserted image within your template, please follow these steps:

1.  Add a textbox to your template at the place where you want an image to be inserted.
2.  Set common image attributes such as frame, size, and others for the textbox, making the textbox look like a blank inserted image.
3.  Specify an image tag within the textbox using the following syntax.
  
    ```csharp
    <<image [image_expression]>>
    
    ```
    

The expression declared within an image tag is used by the engine to build an image to be inserted. The expression must return a value of one of the following types:

*   A byte array containing an image data
*   A [Stream](http://msdn.microsoft.com/en-us/library/system.io.stream(v=vs.110).aspx) instance able to read an image data
*   An [Image](http://msdn.microsoft.com/en-us/library/system.drawing.image(v=vs.110).aspx) object
*   A string containing an image URI, path, or Base64-encoded image data

While building a report, the following procedure is applied to an image tag:

*   The expression declared within the tag is evaluated and its result is used to form an image.
*   The corresponding textbox is filled with this image.
*   The tag is removed from the textbox.

**Note:** If the expression declared within an image tag returns a stream object, then it is closed by the engine as soon as the corresponding image is built.

By default, the assembler stretches an image filling a textbox to the size of the textbox. However, you can change this behavior in the following ways:

*   To keep the size of the textbox and stretch the image within bounds of the textbox preserving the ratio of the image, use the *keepRatio* switch as follows:
  
    ```csharp
    <<image [image_expression] -keepRatio>>
    ```
    
*   To keep the width of the textbox and change its height preserving the ratio of the image, use the fitHeight switch as follows.
  
    ```csharp
    <<image [image_expression] -fitHeight>>
    ```
    
*   To keep the height of the textbox and change its width preserving the ratio of the image, use the fitWidth switch as follows.
  
    ```csharp
    <<image [image_expression] -fitWidth>>
    ```
    
*   To change the size of the textbox according to the size of the image, use the fitSize switch as follows.
  
    ```csharp
    <<image [image_expression] -fitSize>>
    ```
    
*   To change the size of the textbox according to the size of the image without increasing the size of the textbox, use the fitSizeLim switch as follows.
  
    ```csharp
    <<image [image_expression] -fitSizeLim>>
    ```
    
    {{< alert style="warning" >}}If the size of the image is greater than the size of the textbox, then the fitSizeLim switch acts like fitHeight or fitWidth. Otherwise, the fitSizeLim switch acts like fitSize.{{< /alert >}}
    

### Inserting Documents

You can insert contents of outer documents to your reports dynamically using doc tags. A doc tag denotes a placeholder within a template for a document to be inserted during runtime.

Syntax of a doc tag is defined as follows.

```csharp
<<doc [document_expression]>>
```

{{< alert style="warning" >}}A doc tag can be used almost anywhere in a template document except textboxes and charts.{{< /alert >}}

An expression declared within a doc tag is used by the assembler to load a document to be inserted during runtime. The expression must return a value of one of the following types:

*   A byte array containing document data
*   A [Stream](http://msdn.microsoft.com/en-us/library/system.io.stream(v=vs.110).aspx) instance able to read document data
*   An instance of the Document class
*   A string containing a document URI, path, or Base64-encoded document data

While building a report, an expression declared within a doc tag is evaluated and its result is used to load a document which content replaces the doc tag then.

{{< alert style="warning" >}}If an expression declared within a doc tag returns a stream object, then the stream is closed by the assembler as soon as a corresponding document is loaded.{{< /alert >}}

By default, a document being inserted is not checked against template syntax and is not populated with data. However, you can enable this by using a build switch as follows.

```csharp
<<doc [document_expression] -build>>
```

When a build switch is used, the assembler treats a document being inserted as a template that can access the following data available at the scope of a corresponding doc tag:

*   Data sources
*   Variables
*   A contextual object 
*   Known external types 

### Setting Checkbox Values Dynamically

You can set checkbox values to either checked or unchecked in your reports dynamically by taking the following steps:

1.  Add a checkbox content control to your template at a place where you want it to appear in a result document.
2.  By editing content control properties, add a check tag to the title of the checkbox content control using the following syntax.

```csharp
<<check [conditional_expression]>>
```

Here, conditional\_expression defines a condition upon which the value of the checkbox content control is to be set to checked (or unchecked, if the condition is not met). The conditional expression must return a Boolean value.

While building a report, a conditional expression declared within a check tag is evaluated and the value of its containing checkbox content control is set accordingly. The check tag itself is removed then.

{{< alert style="warning" >}}Dynamic checkbox value setting is available for Word Processing documents only.{{< /alert >}}

### Adding Combobox and Dropdown List Items Dynamically

You can dynamically add items to comboboxes and dropdown lists defined in your template by taking the following steps:

1. Add a combobox or dropdown list content control to your template at a place where you want it to appear in a result document.
2. By editing content control properties, add an `item` tag to the title of this content control using the following syntax.

```csharp
<<item [value_expression] [display_name_expression]>>
```

Here, `value_expression` defines a value of a combobox or dropdown list item to be added dynamically. This expression is mandatory and must return a non-empty value.

In turn, `display_name_expression` defines a display name of the combobox or dropdown list item to be added. This expression is optional. If it is omitted, then during runtime, a value of `value_expression` is used as a display name as well.

**Note –** Values of both `value_expression` and `display_name_expression` can be of any types. During runtime, `Object.ToString()` is invoked to get textual representations of these expressions’ values.

While building a report, `value_expression` and `display_name_expression` are evaluated and a corresponding combobox or dropdown list item is added. A declaring `item` tag is removed then.

A single `item` tag causes addition of a single combobox or dropdown list item during runtime. You can add multiple combobox or dropdown list items using multiple `item` tags as shown in the following snippet.

```csharp
<<item ...>><<item ...>>
```

Also, you can normally use `item` tags within data bands to add a combobox or dropdown list item per item of a data collection. For example, given that `clients` is a `DataTable` instance having a field named “Name”, you can use the following template to cover such a scenario.

```csharp
<<foreach [client in clients]>><<item [client.Name]>><</foreach>>
```

An `item` tag can also be combined with an `if` tag to add a combobox or dropdown list item depending on a condition as shown in the following snippet.

```csharp
<<if ...>><<item ...>><</if>>
```

Existing combobox and dropdown list items are not affected by `item` tags. Thus, you can combine both ways of adding combobox and dropdown list items using a template: static and dynamic.

**Note –** While inserting a combobox or dropdown list, Microsoft Word adds a default item that has to be removed manually, if the item is unwanted.

### Using Hyperlinks 

Using GroupDocs.Assembly, you can insert hyperlinks to URI or Bookmarks to your reports dynamically using link tags. The syntax of a link tag is defined below for various types of documents:

#### Word Processing and Emails

```csharp
<<link [uri_or_bookmark_expression][display_text_expression]>>
```

#### Spreadsheets

If the insertion of the link to cell A1 is required:

```csharp
<<link ["A1"] ["Home"]>>
```

#### Presentations

```csharp
<<link ["Slide1"] ["Home"]>>
```

### Using Contextual Object Member Access

You can make your templates less cumbersome using the contextual object member access feature. This feature enables you to access members of some objects without specifying the objects' identifiers in template expressions. An object to which the feature can be applied is determined depending on a context as follows:

*   Inside a data band body, the object is resolved to the innermost iteration variable.
*   Outside a data band body, the object is resolved to a passed data source.

Obviously, inside a data band body, you can not use the feature to access members of an outer iteration variable or a passed data source object. With the exception of this restriction, you can use both contextual and common object member access syntaxes interchangeably depending on your needs and preferences.

Consider the following example. Given that `ds` is a `DataSet` instance containing a `DataTable` object named "Persons" that has fields named "Name" and "Age", you can use the following template to list the contents of the table.

| No. | Name | Age |
| --- | --- | --- |
| `<<foreach [p in ds.Persons]>><<[p.NumberOf()]>>` | `<<[p.Name]>>` | `<<[p.Age]>><</foreach>>` |
| `Count: <<[ds.Persons.Count()]>>` |  |  |

Alternatively, you can use the following template involving the contextual object member access syntax to get the same results.

| No. | Name | Age |
| --- | --- | --- |
| `<<foreach [in Persons]>><<[NumberOf()]>>` | `<<[Name]>>` | `<<[Age]>><</foreach>>` |
| `Count: <<[Persons.Count()]>>` |  |  |

### Using Conditional Blocks

You can use different document blocks to represent the same data depending on a condition with the help of conditional blocks. A conditional block represents a set of template options, each of which is bound with a conditional expression. At runtime, these conditional expressions are sequentially evaluated, until an expression that returns true is reached. Then, the conditional block is replaced with the corresponding template option populated with data.  
A conditional block can have a default template option that is not bound with a conditional expression. At runtime, this template option is used, when none of conditional expressions return true. If a default template option is missing and none of conditional expressions return true, then the whole conditional block is removed during runtime.

You can use the following syntax to declare a conditional block:

```csharp
<<if [conditional_expression1]>>
template_option1
<<elseif [conditional_expression2]>>
template_option2
...
<<else>>
default_template_option
<</if>>
```

**Note:** A conditional expression must return a Boolean value.

#### Common Conditional Blocks

A common conditional block is a conditional block which body starts and ends within paragraphs that belong to a single story or table cell.  
If a conditional block belongs to a single paragraph, it can be used as a replacement for an expression tag that involves the ternary "?:" operator. For example, given that items is an enumeration, you can use the following template to represent the count of elements in the enumeration:

```csharp
You have chosen <<if [!items.Any()]>>no items<<else>><<[items.Count()]>> item(s)<</if>>.
```

**Note:** A template option of a common conditional block can be composed of multiple paragraphs, if needed.

You can normally use common conditional blocks within data bands. For example, given that items is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them and apply different formatting for even and odd elements:

```csharp
<<foreach \[item in items\]>><<if \[IndexOf() % 2 == 0\]>><<\[item\]>>  
<<else>><<\[item\]>>  
<</if>><</foreach>>
```

In this case, the engine produces a report as follows:

item1  
item2  
item3

You can use data bands within common conditional blocks as well. For example, given the previous declaration of items, you can check whether the enumeration contains any elements before outputting their list:

```csharp
<<if [!items.Any()]>>No data.
<<else>><<foreach [item in items]>><<[item]>>
<</foreach>><</if>>
```

#### Table-Row Conditional Block

A table-row conditional block is a conditional block which body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:  
**Note:** Table rows occupied by different template options in the following template are highlighted with different colors.

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if ...&gt;&gt; ...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;elseif ...&gt;&gt; ...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(255, 242, 204);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt; ...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(222, 234, 246);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">... &lt;&lt;/if&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&nbsp;</span></p></td></tr></tbody></table>
The following examples in this section are given using client, an instance of the Client class, and clients, an enumeration of instances of the Client class that is defined as follows:

```csharp
public class Client
{
    public String Name { get { ... } }
    public String Country { get { ... } }
    public String LocalAddress { get { ... } }
    ...
}
```

Using table-row conditional blocks, you can pick to output a single row among several rows of a single document table depending on a condition like in the following example:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if [client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;"> == "New Zealand"]&gt;&gt;&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[client.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">...</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
You can normally use table-row conditional blocks within data bands to make elements of an enumeration look differently depending on a condition. Consider the following template:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in clients]&gt;&gt;&lt;&lt;if [</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;"> == "New Zealand"]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242);"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
In this case, the engine produces the report as below:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">A Company</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Australia</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">219-241 Cleveland St</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">STRAWBERRY HILLS&nbsp; NSW&nbsp; 1427</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">B Ltd.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Brazil</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Avenida João Jorge, 112, ap. 31</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Vila Industrial</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Campinas - SP</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">13035-680</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">C &amp; D</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Canada</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">101-3485 RUE DE LA MONTAGNE</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">MONTRÉAL (QUÉBEC) h2G 2A6</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">E Corp.</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">445 Mount Eden Road</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Mount Eden</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Auckland 1024</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">F &amp; Partners</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">20 Greens Road</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Tuahiwi</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Kaiapoi 7691</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">G &amp; Co.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Greece</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Karkisias 6</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">GR-111 42&nbsp; ATHINA</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">GRÉCE</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">H Group</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Hungary</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Budapest</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Fiktív utca 82., IV. em./28.</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">2806</span></p></td></tr><tr><td style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">I &amp; Sons</span></p></td><td colspan="2" style="background-color: rgb(226, 239, 217); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 279.5pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">43 Vogel Street</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Roslyn</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Palmerston North 4414</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 166.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">J Ent.</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 116.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Japan</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 151.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Hakusan 4-Ch?me 3-2</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Bunky?-ku, T?KY?</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">112-0001</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Japan</span></p></td></tr><tr style="height: 0pt;"><td style="width: 176.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 127.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 162.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="info" >}}**Note:** You can use common conditional blocks within table-row data bands as well.{{< /alert >}}

Also, you can use data bands inside table-row conditional blocks. For example, you can provide an alternate content for an empty table-row data band using the following template:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Client</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Local Address</span></p></td></tr><tr><td colspan="3" style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!clients.</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Any</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">()]&gt;&gt;No data</span></p></td></tr><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;foreach [in clients]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Name</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">LocalAddress</span><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;/foreach&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 155.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 113.4pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 198.15pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
In case, the corresponding enumeration is empty, the engine produces a report as below:

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 144.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Client</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 102.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Country</span></p></td><td style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 187.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">Local Address</span></p></td></tr><tr><td colspan="3" style="background-color: rgb(242, 242, 242); border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(127, 127, 127); font-family: &quot;Courier New&quot;; font-size: 11pt; font-weight: bold;">No data</span></p></td></tr><tr style="height: 0pt;"><td style="width: 155.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 113.4pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 198.15pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="info" >}}**Note:** If tags denoting boundaries of a template option are contained within a single table cell, the option is considered to be a common template option, rather than a table-row one. That is, the option is considered to occupy contents within the cell, rather than the whole row. That is why, a single-cell alternate content in the previous example is located between an opening if and else tags, rather than between an else and closing if tags.{{< /alert >}}


---

## Adding text watermarks

Path: /watermark/net/adding-text-watermarks/


Utilizing text watermarks is a savvy strategy to safeguard the integrity of document content. By overlaying sensitive documents with watermarks such as "Confidential" or "Draft," organizations can deter unauthorized distribution and reinforce data security protocols. This visual cue serves as a constant reminder of the document's restricted nature, prompting individuals to handle it with appropriate care. 

The following code snippet shows how to add text watermark to a document. 

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\sample.pdf"
using (Watermarker watermarker = new Watermarker("sample.pdf"))
{
    // Initialize the font to be used for watermark
    Font font = new Font("Arial", 19, FontStyle.Bold | FontStyle.Italic);

    // Create the watermark object
    TextWatermark watermark = new TextWatermark("Test watermark", font);

    // Set watermark properties
    watermark.ForegroundColor = Color.Red;
    watermark.BackgroundColor = Color.Blue;
    watermark.TextAlignment = TextAlignment.Right;
    watermark.Opacity = 0.5;

    // Add watermark
    watermarker.Add(watermark);
    watermarker.Save("output.pdf");
}
```

If the document consists of multiple parts (pages, worksheets, slides, frames, etc.), the watermark will be added to each of them. You can configure this behaivior through the [PageSetup](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/pagessetup/) property:

```csharp

var pages = new System.Collections.Generic.List<int>() { 1, 3 };

watermark.PagesSetup = new PagesSetup
{
    Pages = pages
};

```

## Sizing and positioning of watermark

### Absolute watermark positioning

Using GroupDocs.Watermark, you can also add watermark to some absolute position in the document. Following example shows how to add a text watermark with absolute positioning using properties [X](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/x), [Y](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/y), [Width](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/width) and [Height](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/height). The values of all properties for absolute sizing and positioning are measured in default document units.

```csharp
// Specify an absolute or relative path to your image. Ex: @"C:\Docs\image.png"
using (Watermarker watermarker = new Watermarker("image.png"))
{
    Font font = new Font("Times New Roman", 8);
    TextWatermark watermark = new TextWatermark("Test watermark", font);

    // Set watermark coordinates
    watermark.X = 10;
    watermark.Y = 20;

    // Set watermark size
    watermark.Width = 100;
    watermark.Height = 40;

    watermarker.Add(watermark);
    watermarker.Save("image.png");
}
```

{{< alert style="warning" >}}Note that the origin of coordinates may be different for different document types (relative positioning doesn't have these specifics and can be used as a unified positioning approach).{{< /alert >}}

Following are the origin of the coordinates for different formats of the documents.

| Document Format | Unit of Measure | Origin of Coordinates |
| --- | --- | --- |
| PDF | Point | Left bottom corner of page |
| WordProcessing | Point | Left top corner of page  |
| Spreadsheet | Point | Left top corner of worksheet  |
| Presentation | Point | Left top corner of slide  |
| Image | Pixel | Left top corner of image (frame)  |
| Diagram | Point | Left top corner of page |

### Relative watermark positioning 

Instead of exact coordinates, you can also use parent relative alignment. Furthermore, you can also set offset from parent's borders by using [Margins](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/margins) property as shown in below example. Following example shows how to align the watermark vertically and horizontally.

```csharp
// Specify an absolute or relative path to your image. Ex: @"C:\Docs\image.png"
using (Watermarker watermarker = new Watermarker("image.png"))
{
    Font font = new Font("Calibri", 12);
    TextWatermark watermark = new TextWatermark("Test watermark", font);
    watermark.HorizontalAlignment = HorizontalAlignment.Right;
    watermark.VerticalAlignment = VerticalAlignment.Bottom;

    // Set absolute margins. Values are measured in document units.
    watermark.Margins.Right = 10;
    watermark.Margins.Bottom = 5;

    watermarker.Add(watermark);
    watermarker.Save("image.png");
}
```

{{< alert style="warning" >}}Excel worksheets don't have explicit borders, therefore, the most right bottom non-empty cell is used to determine working area size.{{< /alert >}}

### Using the MarginType property

In the example above, absolute margin values are used. This means that margins are measured in document units. But you can set relative margins for a watermark as well (as shown in below example), using the [MarginType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/margins/properties/margintype) property

```csharp
// Specify an absolute or relative path to your image. Ex: @"C:\Docs\image.png"
using (Watermarker watermarker = new Watermarker("image.png"))
{
    Font font = new Font("Calibri", 12);
    TextWatermark watermark = new TextWatermark("Test watermark", font);
    watermark.HorizontalAlignment = HorizontalAlignment.Right;
    watermark.VerticalAlignment = VerticalAlignment.Bottom;

    // Set relative margins. Margin value will be interpreted as a portion
    // of appropriate parent dimension. If this type is chosen, margin value
    // must be between 0.0 and 1.0.
    watermark.Margins.MarginType = MarginType.RelativeToParentDimensions;
    watermark.Margins.Right = 0.1;
    watermark.Margins.Bottom = 0.2;

    watermarker.Add(watermark);
    watermarker.Save("image.png");
}
```

### Size types

In most cases, to add a good-looking watermark, you should consider the size of the page/slide/frame on which it will be placed. The [SizingType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/sizingtype) and [ScaleFactor](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/scalefactor) properties can be used to scale the watermark depending on the parent size.

```csharp
// Specify an absolute or relative path to your image. Ex: @"C:\Docs\image.png"
using (Watermarker watermarker = new Watermarker("image.png"))
{
    Font font = new Font("Calibri", 12);
    TextWatermark watermark = new TextWatermark("This is a test watermark", font);

    // Set sizing type
    watermark.SizingType = SizingType.ScaleToParentDimensions;

    // Set watermark scale
    watermark.ScaleFactor = 0.5;

    watermarker.Add(watermark);
    watermarker.Save("image.png");
}
```

{{< alert style="info" >}}Using of relative size and positioning is the simplest way to add watermark to a document of any type.{{< /alert >}}

### Watermark rotation

GroupDocs.Watermark API also supports rotation of the watermark. You can use [RotateAngle](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/rotateangle) property to define watermark rotation angle in degrees. A positive value means clockwise rotation.

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\test.docx"
using (Watermarker watermarker = new Watermarker("test.docx"))
{
    Font font = new Font("Calibri", 8);
    TextWatermark watermark = new TextWatermark("Test watermark", font);
    watermark.HorizontalAlignment = HorizontalAlignment.Right;
    watermark.VerticalAlignment = VerticalAlignment.Top;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 0.5;

    // Set rotation angle
    watermark.RotateAngle = 45;

    watermarker.Add(watermark);
    watermarker.Save("test.docx");
}
```

If rotation angle is set, it is assumed that watermark size is equal to axis-aligned bounding box size. The following picture illustrates what is the watermark bounding box and how it is used for sizing and positioning. The picture shows a result of execution of the above code snippet. The actual watermark bounds are colored in blue and the bounding box is colored in red. As you can see, the bounding box size is used to calculate watermark relative size.

![adding-text-watermarks](/watermark/net/images/adding-text-watermarks.png)

### Using custom fonts

GroupDocs.Watermark API provides ability to use custom TrueType fonts. For this you can configure [FolderPath](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/font/folderpath/) property through the Font class constructor with a folder path which contains fonts files.

```csharp
var fontsFolder = @"c:\CustomFonts\";
using (Watermarker watermarker = new Watermarker("test.pdf"))
{
    // Initialize the font to be used for watermark and a folder which contains that font
    Font font = new Font("CustomFontName", fontsFolder, 36);

    // Create the watermark object
    TextWatermark watermark = new TextWatermark("Test watermark", font);

    // Set watermark properties
    watermark.ForegroundColor = Color.Blue;                
    watermark.Opacity = 0.5;

    watermark.X = 10;
    watermark.Y = 10;

    // Add watermark
    watermarker.Add(watermark);

    watermarker.Save("result.pdf");
}
```

### Considering parent margins

For most document formats you can set page margins when working with a document. By default, GroupDocs.Watermark ignores document margins and uses maximum available space for watermarking as shown in below image.

![adding-text-watermarks_1](/watermark/net/images/adding-text-watermarks_1.png)

As you can see, the watermark goes beyond page margins. To change this behavior, set [ConsiderParentMargins](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/considerparentmargins) property to true (as shown in below example).


```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\input.vsdx"
using (Watermarker watermarker = new Watermarker("input.vsdx"))
{
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 42));
    watermark.HorizontalAlignment = HorizontalAlignment.Right;
    watermark.VerticalAlignment = VerticalAlignment.Top;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;
    watermark.RotateAngle = 45;
    watermark.ForegroundColor = Color.Red;
    watermark.BackgroundColor = Color.Aqua;

    // Add watermark considering parent margins
    watermark.ConsiderParentMargins = true;

    watermarker.Add(watermark);
    watermarker.Save("input.vsdx");
}
```

Now, the watermark is aligned with respect to page margins.

![adding-text-watermarks_2](/watermark/net/images/adding-text-watermarks_2.png)

## Watermark in documents of different types

Watermarks in documents of different types are represented by different objects. Some of these objects do not support some watermark properties. For example, the background color can not be set for WordArt object which is used as text watermark in a Word document. The full list of supported properties for all document types is available at [Features Overview]({{< ref "watermark/net/getting-started/features-overview.md" >}}).

---

## Adding text watermarks

Path: /watermark/nodejs-java/adding-text-watermarks/


Using text watermarks is an effective way to protect the integrity of document content. By marking sensitive documents with watermarks like "Confidential" or "Draft," organizations can discourage unauthorized sharing and strengthen data security measures. This visual indicator acts as a continual reminder of the document's restricted status, encouraging careful handling by anyone who views it.

The following code snippet shows how to add text watermark to a document. 

```js
const watermarker = new groupdocsWatermark.Watermarker('sample.pdf');
const watermark = new groupdocsWatermark.TextWatermark('Test watermark', new 
    groupdocsWatermark.Font('Arial', 36, groupdocsWatermark.FontStyle.Bold));

watermark.setTextAlignment(groupdocsWatermark.TextAlignment.Right);
watermark.setOpacity(0.4);
watermark.setForegroundColor(groupdocsWatermark.Color.getRed());
watermark.setBackgroundColor(groupdocsWatermark.Color.getBlue());

watermarker.add(watermark);

watermarker.save("result.pdf");
watermarker.close();
```

If the document consists of multiple parts (pages, worksheets, slides, frames, etc.), the watermark will be added to each of them. You can configure this behaivior through the [PagesSetup](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/pagessetup/) property:

```js

  const pagesSetup = new groupdocsWatermark.PagesSetup();
  pagesSetup.setFirstPage(true);
  pagesSetup.setOddPages(true);

  watermark.setPagesSetup(pagesSetup);

```

## Sizing and positioning of watermark

### Absolute watermark positioning

Using GroupDocs.Watermark, you can also add watermark to some absolute position in the document. Following example shows how to add a text watermark with absolute positioning using properties X, Y, Width and Height. The values of all properties for absolute sizing and positioning are measured in default document units.

```js
const watermarker = new groupdocsWatermark.Watermarker('sample.pdf');
const watermark = new groupdocsWatermark.TextWatermark('Test watermark', new 
    groupdocsWatermark.Font('Arial', 36, groupdocsWatermark.FontStyle.Bold));

watermark.setX(10.0);
watermark.setY(20.0);

watermark.setWidth(100.0);
watermark.setHeight(40.0);

watermarker.add(watermark);
watermarker.save("result.pdf");
watermarker.close();
```

### Using the MarginType property

In the example above, absolute margin values are used. This means that margins are measured in document units. But you can set relative margins for a watermark as well (as shown in below example), using the MarginType property

```js
const watermarker = new groupdocsWatermark.Watermarker('image.png');
const watermark = new groupdocsWatermark.TextWatermark('Test watermark', new 
    groupdocsWatermark.Font('Calibri', 32));

watermark.Margins.setMarginType(groupdocsWatermark.MarginType.RelativeToParentDimensions);
watermark.Margins.setRight(0.1);
watermark.Margins.setBottom(0.2);

watermarker.add(watermark);
watermarker.save("result.png");
watermarker.close();
```

### Watermark rotation

GroupDocs.Watermark API also supports rotation of the watermark. You can use [RotateAngle] property to define watermark rotation angle in degrees. A positive value means clockwise rotation.

```js
const watermarker = new groupdocsWatermark.Watermarker('test.docx');
const watermark = new groupdocsWatermark.TextWatermark('Test watermark', new 
    groupdocsWatermark.Font('Calibri', 32));

watermark.setHorizontalAlignment(groupdocsWatermark.HorizontalAlignment.Right);
watermark.setVerticalAlignment(groupdocsWatermark.VerticalAlignment.Top);
watermark.setSizingType(groupdocsWatermark.SizingType.ScaleToParentDimensions);
watermark.setScaleFactor(0.5);

// Set rotation angle
watermark.setRotateAngle(45.0);

watermarker.add(watermark);
watermarker.save("result.docx");
watermarker.close();
```


If rotation angle is set, it is assumed that watermark size is equal to axis-aligned bounding box size. The following picture illustrates what is the watermark bounding box and how it is used for sizing and positioning. The picture shows a result of execution of the above code snippet. The actual watermark bounds are colored in blue and the bounding box is colored in red. As you can see, the bounding box size is used to calculate watermark relative size.

![adding-text-watermarks](/watermark/net/images/adding-text-watermarks.png)

### Using custom fonts

GroupDocs.Watermark API provides ability to use custom TrueType fonts. For this you can configure FolderPath property through the Font class constructor with a folder path which contains fonts files.

```js
const watermarker = new groupdocsWatermark.Watermarker('test.pdf');

var fontsFolder = @"c:\CustomFonts\";
// Initialize the font to be used for watermark and folder with it
var font = new groupdocsWatermark.Font("OT Chekharda Bold Italic", fontsFolder, 36)
const watermark = new groupdocsWatermark.TextWatermark('top secret', font);

watermark.setForegroundColor(groupdocsWatermark.Color.getRed());
watermark.setX(10);
watermark.setY(100);
watermark.setOpacity(0.4);

watermarker.add(watermark);
watermarker.save(outputFilePath);
watermarker.close();
```
---

## Adding text watermarks

Path: /watermark/python-net/adding-text-watermarks/


Using text watermarks is an effective way to protect document content. By overlaying sensitive documents with watermarks such as "Confidential" or "Draft", you can deter unauthorized distribution and reinforce data security.

The following example shows how to add a text watermark to a document.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("sample.pdf") as watermarker:
    font = gww.Font("Arial", 19.0, gww.FontStyle.BOLD | gww.FontStyle.ITALIC)
    watermark = gww.TextWatermark("Test watermark", font)

    watermark.foreground_color = gww.Color.red
    watermark.background_color = gww.Color.blue
    watermark.text_alignment = gww.TextAlignment.RIGHT
    watermark.opacity = 0.5

    watermarker.add(watermark)
    watermarker.save("output.pdf")
```

If a document consists of multiple parts (pages, worksheets, slides, frames, etc.), the watermark will be added to each of them. You can configure this behavior via the `PagesSetup` property:

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("sample.pdf") as watermarker:
    font = gww.Font("Arial", 19.0)
    watermark = gww.TextWatermark("Test watermark", font)

    watermark.pages_setup = gww.PagesSetup()
    watermark.pages_setup.pages = [1, 3]

    watermarker.add(watermark)
    watermarker.save("output.pdf")
```

## Sizing and positioning of watermark

### Absolute watermark positioning

You can add a watermark to an absolute position by setting `x`, `y`, `width`, and `height`. Values are measured in default document units.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("image.png") as watermarker:
    font = gww.Font("Times New Roman", 8.0)
    watermark = gww.TextWatermark("Test watermark", font)

    watermark.x = 10
    watermark.y = 20
    watermark.width = 100
    watermark.height = 40

    watermarker.add(watermark)
    watermarker.save("image.png")
```

{{< alert style="warning" >}}Note that the origin of coordinates may be different for different document types (relative positioning doesn't have these specifics and can be used as a unified positioning approach).{{< /alert >}}

Following are the origin of the coordinates for different formats of the documents.

| Document Format | Unit of Measure | Origin of Coordinates |
| --- | --- | --- |
| PDF | Point | Left bottom corner of page |
| WordProcessing | Point | Left top corner of page  |
| Spreadsheet | Point | Left top corner of worksheet  |
| Presentation | Point | Left top corner of slide  |
| Image | Pixel | Left top corner of image (frame)  |
| Diagram | Point | Left top corner of page |


### Relative watermark positioning

Instead of exact coordinates, use parent-relative alignment and set offsets with `margins`.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("image.png") as watermarker:
    font = gww.Font("Calibri", 12.0)
    watermark = gww.TextWatermark("Test watermark", font)
    watermark.horizontal_alignment = gwc.HorizontalAlignment.RIGHT
    watermark.vertical_alignment = gwc.VerticalAlignment.BOTTOM

    watermark.margins.right = 10
    watermark.margins.bottom = 5

    watermarker.add(watermark)
    watermarker.save("image.png")
```

{{< alert style="warning" >}}Excel worksheets don't have explicit borders, therefore, the most right bottom non-empty cell is used to determine working area size.{{< /alert >}}


### Using the MarginType property

Set relative margins using `MarginType`, where values are interpreted as a portion of the parent size (0.0–1.0).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("image.png") as watermarker:
    font = gww.Font("Calibri", 12.0)
    watermark = gww.TextWatermark("Test watermark", font)
    watermark.horizontal_alignment = gwc.HorizontalAlignment.RIGHT
    watermark.vertical_alignment = gwc.VerticalAlignment.BOTTOM

    watermark.margins.margin_type = gww.MarginType.RELATIVE_TO_PARENT_DIMENSIONS
    watermark.margins.right = 0.1
    watermark.margins.bottom = 0.2

    watermarker.add(watermark)
    watermarker.save("image.png")
```

### Size types

Scale watermark depending on the parent size using `sizing_type` and `scale_factor`.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("image.png") as watermarker:
    font = gww.Font("Calibri", 12.0)
    watermark = gww.TextWatermark("This is a test watermark", font)

    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 0.5

    watermarker.add(watermark)
    watermarker.save("image.png")
```

{{< alert style="info" >}}Using of relative size and positioning is the simplest way to add watermark to a document of any type.{{< /alert >}}


### Watermark rotation

Rotate watermark by setting `rotate_angle` in degrees. Positive values mean clockwise.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("test.docx") as watermarker:
    font = gww.Font("Calibri", 8.0)
    watermark = gww.TextWatermark("Test watermark", font)
    watermark.horizontal_alignment = gwc.HorizontalAlignment.RIGHT
    watermark.vertical_alignment = gwc.VerticalAlignment.TOP
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 0.5
    watermark.rotate_angle = 45

    watermarker.add(watermark)
    watermarker.save("test.docx")
```

If rotation angle is set, it is assumed that watermark size is equal to axis-aligned bounding box size. The following picture illustrates what is the watermark bounding box and how it is used for sizing and positioning. The picture shows a result of execution of the above code snippet. The actual watermark bounds are colored in blue and the bounding box is colored in red. As you can see, the bounding box size is used to calculate watermark relative size.

![adding-text-watermarks](/watermark/python-net/images/adding-text-watermarks.png)


### Using custom fonts

You can use custom TrueType fonts by specifying a folder path in the `Font` constructor.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

fonts_folder = r"c:\\CustomFonts\\"
with gw.Watermarker("test.pdf") as watermarker:
    font = gww.Font("CustomFontName", fonts_folder, 36.0)
    watermark = gww.TextWatermark("Test watermark", font)

    watermark.foreground_color = gww.Color.blue
    watermark.opacity = 0.5
    watermark.x = 10
    watermark.y = 10

    watermarker.add(watermark)
    watermarker.save("result.pdf")
```

### Considering parent margins

By default, page margins are ignored and the maximum available space is used. To align with page margins, set `consider_parent_margins` to `True`.

![adding-text-watermarks_1](/watermark/python-net/images/adding-text-watermarks_1.png)

As you can see, the watermark goes beyond page margins. To change this behavior, set [ConsiderParentMargins](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/considerparentmargins) property to true (as shown in below example).


```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("input.vsdx") as watermarker:
    watermark = gww.TextWatermark("Test watermark", gww.Font("Arial", 42.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.RIGHT
    watermark.vertical_alignment = gwc.VerticalAlignment.TOP
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0
    watermark.rotate_angle = 45
    watermark.foreground_color = gww.Color.red
    watermark.background_color = gww.Color.aqua
    watermark.consider_parent_margins = True

    watermarker.add(watermark)
    watermarker.save("input.vsdx")
```


Now, the watermark is aligned with respect to page margins.

![adding-text-watermarks_2](/watermark/python-net/images/adding-text-watermarks_2.png)

## Watermark in documents of different types

Watermarks are represented by different objects in different formats. Some properties may not be supported for specific formats (for example, background color for WordArt in Word documents). See [Features Overview]({{< ref "watermark/python-net/getting-started/features-overview.md" >}}) for details.



---

## Adding watermark to images inside a document

Path: /watermark/net/adding-watermark-to-images-inside-a-document/

The most of the document formats allow you to place images inside a document. If you want to add watermark to images inside a document then it can be possible using GroupDocs.Watermark. Following are the steps to add watermark to the images of any document.

1. Load the document
2. Create and initialize watermark object
3. Set watermark properties
4. [Find](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/getimages) images in the document
5. [Add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.image/watermarkableimage/methods/add) watermark to all found images
6. Save the document

**AdvancedUsage.AddingWatermarks.AddWatermarksToImages.AddWatermarkToImagesInsideDocument**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    // Initialize text watermark
    TextWatermark textWatermark = new TextWatermark("Protected image", new Font("Arial", 8));
    textWatermark.HorizontalAlignment = HorizontalAlignment.Center;
    textWatermark.VerticalAlignment = VerticalAlignment.Center;
    textWatermark.RotateAngle = 45;
    textWatermark.SizingType = SizingType.ScaleToParentDimensions;
    textWatermark.ScaleFactor = 1;

    // Initialize image watermark
    using (ImageWatermark imageWatermark = new ImageWatermark("protect.jpg"))
    {
        imageWatermark.HorizontalAlignment = HorizontalAlignment.Center;
        imageWatermark.VerticalAlignment = VerticalAlignment.Center;
        imageWatermark.RotateAngle = -45;
        imageWatermark.SizingType = SizingType.ScaleToParentDimensions;
        imageWatermark.ScaleFactor = 1;

        // Find all images in a document
        WatermarkableImageCollection images = watermarker.GetImages();
        for (int i = 0; i < images.Count; i++)
        {
            if (images[i].Width > 100 && images[i].Height > 100)
            {
                if (i % 2 == 0)
                {
                    images[i].Add(textWatermark);
                }
                else
                {
                    images[i].Add(imageWatermark);
                }
            }
        }
    }

    watermarker.Save("document.pdf");
}
```

---

## Adding watermark to images inside a document

Path: /watermark/python-net/adding-watermark-to-images-inside-a-document/


Many document formats allow embedding images. To add watermarks to images inside a document, follow these steps:

1. Load the document
2. Create and initialize watermark object
3. Set watermark properties
4. Find images in the document
5. Add watermark to all found images
6. Save the document

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("document.pdf") as watermarker:
    text_watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    text_watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    text_watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    text_watermark.rotate_angle = 45
    text_watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    text_watermark.scale_factor = 1.0

    with gww.ImageWatermark("protect.jpg") as image_watermark:
        image_watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
        image_watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
        image_watermark.rotate_angle = -45
        image_watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
        image_watermark.scale_factor = 1.0

        images = watermarker.get_images()
        for i in range(images.count):
            if images[i].width > 100 and images[i].height > 100:
                if i % 2 == 0:
                    images[i].add(text_watermark)
                else:
                    images[i].add(image_watermark)

    watermarker.save("document.pdf")
```



---

## Save document to the same file or stream

Path: /watermark/net/save-document-to-the-same-file-or-stream/

Following code shows usage of [Save()](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/save) method.

**AdvancedUsage.SavingDocuments.SaveDocumentToTheSameFileOrStream**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\test.doc"
File.Copy("test-in.doc", "test-out.doc");
using (Watermarker watermarker = new Watermarker("test-out.doc"))
{
    // watermarking goes here
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
    watermarker.Add(watermark);

    // Saves the document to the underlying source (stream or file)
    watermarker.Save();
}
```

---

## Updating Barcode signatures with advanced options

Path: /signature/java/updating-barcode-signatures-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) class to manipulate barcode signatures location, size, textual content and encode type over [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) object to analyze if signatures were successfully processed.

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. The [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) contains list of successfully updated signatures and ones that failed. The Barcode signature could be failed to update due to several reasons:

*   if signature object was initialized with constructor by incorrect signature identifier;
*   if signature object was not found;
*   there was an error occurred while updating signature in the document.

Here are the steps to update Barcode signature in the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [BarcodeSignatures](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/BarcodeSignature);
*   Select from list [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) object(s) that should be updated;  
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not.

Here are the alternative steps to update Barcode signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) methods.

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
*   Instantiate one or several  [BarcodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BarcodeSignature) objects with signature Id(s) passed to constructor;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it;    
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not. 

The following table describes changeable properties for Barcode signatures dependent on document type.

| Document Type / Signature Property | Left | Top | Width | Height | EncodeType | Text | IsSignature |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) |
| Spreadsheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Pdf | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Presentation | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Word Processing | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |

## Update Barcode signature in the document after Search

This example shows how to update Barcode signature that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("sample.pdf");
BarcodeSearchOptions options = new BarcodeSearchOptions();
 
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);
List<BaseSignature> bS = new ArrayList<BaseSignature>();
// adjust signature properties
for (BarcodeSignature temp : signatures)
{
    // apply some condition to adjust signature properties
    temp.setLeft(temp.getLeft() + 100);
    temp.setTop(temp.getTop() + 100);
    temp.setSignature(true);
    bS.add(temp);
}
// update all found signatures
UpdateResult updateResult = signature.update("sample-updated.pdf", bS);
if (updateResult.getSucceeded().size() == signatures.size())
{
    System.out.print("\nAll signatures were successfully updated!");
}
else
{
    System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : "+updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Update Barcode signature in document by known signature Identifier

This example shows how to update Barcode signature in the document by known signature Id (that was obtained by  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method previously).

```java
// initialize Signature instance
Signature signature = new Signature("signed.xlsx");           
// read from some data source signature Id value
String[] signatureIdList = new String[]
        {
                "1dd21cf3-b904-4da9-9413-1ff1dab51974",
                "1a5fbc08-4b96-43d9-b650-578b16fbb877"
        };
// create list of Barcode Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList)
{
    BarcodeSignature temp = new BarcodeSignature(item);
    temp.setWidth(150);
    temp.setHeight(150);
    temp.setLeft(200);
    temp.setTop(200);
    signatures.add(temp);
}
// update all found signatures
UpdateResult updateResult = signature.update("signed.xlsx",signatures);
if (updateResult.getSucceeded().size() == signatures.size())
{
    System.out.print("\nAll signatures were successfully updated!");
}
else
{
    System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : "+updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Using Spreadsheets as Data Sources

Path: /assembly/java/using-spreadsheets-as-data-sources/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

Following classes are added in **[GroupDocs.Assembly.Data](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/package-frame)** namespace:

*   [DataTable](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataTable "class in com.groupdocs.assembly.system.data")
*   [DataColumn](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataColumn "class in com.groupdocs.assembly.system.data")
*   [DataColumnCollection](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataColumnCollection "class in com.groupdocs.assembly.system.data")

## The Recipe

*   Define template and output report documents
*   Assemble a document using the external document table as a data source

### Download

#### Data Source Document

*   [Contracts Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx?raw=true)

#### Template

*   [Using Spreadsheet as Table of Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Using%20Spreadsheet%20as%20Table%20of%20Data.docx?raw=true)

## The Code

{{< gist GroupDocsGists 86d9c857d97d50836f2ba5ef79143225 >}}



---

## Using Spreadsheets as Data Sources

Path: /assembly/net/using-spreadsheets-as-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 16.12.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Using Spreadsheets as Data Sources

Following classes are added in [GroupDocs.Assembly.Data](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/) namespace:

*   [DocumentTable](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttable)
*   [DocumentTableColumn](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecolumn)
*   [DocumentTableColumnCollection](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecolumncollection)
*   [DocumentTableOptions](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttableoptions)

## The Recipe

*   Define template and output report documents
*   Assemble a document using the external document table as a data source

### Download

#### Data Source Document

*   [Contracts Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx?raw=true)

#### Template

*   [Using Spreadsheet as Table of Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Using%20Spreadsheet%20as%20Table%20of%20Data.docx?raw=true)

## The Code

{{< gist GroupDocsGists 2cedc6e4a5c1e3f79c370104486124b4 >}}



---

## Verifying documents with exception handling

Path: /signature/java/verifying-documents-with-exception-handling/

---
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides different error messages due to validation issues, missing required data, files etc. For handling these exceptions class [GroupDocsSignatureException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/GroupDocsSignatureException) should be used.

Here are the steps to handle exceptions from GroupDocs.Signature while document verification:

*   Compose try-catch block above [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method with catching [GroupDocsSignatureException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/GroupDocsSignatureException) type error.
    

This example shows how to handle GroupDocs.Signature exceptions.

```java
try {
    Signature signature = new Signature(filePath);
    // create QRCode option with predefined QRCode text
    DigitalVerifyOptions options = new DigitalVerifyOptions();
    options.setCertificateFilePath(Constants.CertificatePfx);
    // skip password specification
    //options.setPassword("1234567890");
 
    // sign document to file
    VerificationResult result = signature.verify(options);
}catch(GroupDocsSignatureException ex){
    System.out.print("GroupDocs Signature Exception: " + ex.getMessage());
}
catch (Exception ex)
{
    System.out.print("System Exception: " + ex.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verifying documents with exception handling

Path: /signature/net/verifying-documents-with-exception-handling/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides different error messages due to validation issues, missing required data, files etc. For handling these exceptions class [GroupDocsSignatureException](https://reference.groupdocs.com/signature/net/groupdocs.signature/groupdocssignatureexception) should be used.

Here are the steps to handle exceptions from GroupDocs.Signature while document verification:

* Compose try-catch block above [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method with catching [GroupDocsSignatureException](https://reference.groupdocs.com/signature/net/groupdocs.signature/groupdocssignatureexception) type error.  

This example shows how to handle GroupDocs.Signature exceptions.

```csharp
try
{
    using (Signature signature = new Signature("sample.pdf"))
    {
        DigitalVerifyOptions options = new DigitalVerifyOptions()
        {
            CertificateFilePath = "dummy.pfx",
            // skip password specification
            // Password = "1234567890"
        };
        // sign document to file
        VerificationResult result = signature.Verify(options);
    }
}
catch (GroupDocsSignatureException ex)
{
    Console.WriteLine("GroupDocs Signature Exception: " + ex.Message);
}
catch (Exception ex)
{
    Console.WriteLine("System Exception: " + ex.Message);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Visual Studio Plugin to Explore GroupDocs.Assembly Examples

Path: /assembly/net/visual-studio-plugin-to-explore-groupdocs-assembly-examples/

## Visual Studio Plugin to Explore GroupDocs.Assembly Examples

GroupDocs.Assembly for .NET plugin is providing an ease to compile GroupDocs.Assembly for .NET 3.0.0 examples and to explore the examples. It has reduced the efforts to download examples and the DLL file from different resources (GitHub, NuGet). You can quickly run CSharp project. So all the manual steps to explore the examples have been exempted.

### Features

Following are the key features of the plugin

*   Appears in **File** menu in Visual Studio.
*   Downloads code sample automatically.
*   Downloads **GroupDocs.Assembly** library automatically.
*   Adds GroupDocs.Assembly reference automatically.
*   Provides **C#** examples.
*   Supports **Visual Studio 2010**, **2012** and **2013.**
*   Opens project in few steps.
*   Easy to download and install.
*   Easy to use.
*   Saves time and reduces effort.

### Download

Visual Studio Plugin for GroupDocs.Assembly for .NET Examples is available for download from following platforms.

*   [CodePlex](https://groupdocsassemblyvs.codeplex.com/)
*   [GitHub](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/releases/tag/vs1.0)
*   [Visual Studio Gallery](https://visualstudiogallery.msdn.microsoft.com/6b56e8a7-c57d-4d4c-b490-4cdaa18a29b2)

### Installation

Installation of Visual Studio Plugin for GroupDocs.Assembly Examples is very easy and simple. User just needs to download MSI file and run it. After finishing the installation, plugin will be integrated with Visual Studio and appear in **File** menu.  
You may need to add Newtonsoft.Json.DLL as reference in order to build any of the project (C#).

{{< alert style="info" >}}For video demonstration, watch How to Install on Youtube.{{< /alert >}}

### Usage

Just like installation, usage of the plugin is also very easy and user friendly. Here are some easy steps to run example projects in Visual Studio.

*   Go to **File** -> **GroupDocs** in Visual Studio.
*   Select **New GroupDocs.Assembly Example Project**.

After installation you will see following appearances:

![](assembly/net/images/visual-studio-plugin-to-explore-groupdocs-assembly-examples.jpg)

Here you can open CSharp project.

![](https://raw.githubusercontent.com/groupdocsassembly/GroupDocs_Assembly_NET/master/Examples/Data/Screenshots/12767883_946490572054489_1673855215_o.jpg)

### Supported Versions of Visual Studio

Visual Studio must be installed before installing the plugin. It supports following versions of Visual Studio

*   Visual Studio 2010
*   Visual Studio 2012
*   Visual Studio 2013

### Contribute

Visual Studio Plugin for GroupDocs.Assembly for .NET examples is open source and available for download. Developers can download it and get help to understand its working and extend its functionality. Following are the places from where code samples can be downloaded.

*   [CodePlex](https://groupdocsassemblyvs.codeplex.com/SourceControl/latest)
*   [Github](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/tree/master/Plugins/GroupDocs.Assembly%20VS%20Plugin)

Developers are always welcome to submit their feedback to improve the plugin.

---

## Watermarks in PDF document

Path: /watermark/java/watermarks-in-pdf-document/


Learn about how many ways the Groupdocs.watermark can add watermarks in PDF documents.

## XObjects
When [add()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#add(com.groupdocs.watermark.Watermark)) method of [Watermarker](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker) class is called, simple XObject is added to a PDF document.

{{< alert style="info" >}}
**PDF Reference 1.7**  

An external object (commonly called an XObject) is a graphics object whose contents are defined by a self-contained content stream, separate from the content stream in which it is used. There are three types of external objects:
*   An image XObject represents a sampled visual image such as a photograph.
*   A form XObject is a self-contained description of an arbitrary sequence of graphics objects.
*   A PostScript XObject contains a fragment of code expressed in the PostScript page description language. PostScript XObjects are no longer recommended to be used.
{{< /alert >}}

 Image XObject and Form XObject are used by GroupDocs.Watermark API to add [ImageWatermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark) and [TextWatermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/TextWatermark) respectively. XObjects are considered as a page real content, therefore, they are not removed by Adobe Acrobat during document sanitization.

## Artifacts
{{< alert style="info" >}}
**PDF Reference 1.7**  

The graphics objects in a document can be divided into two classes:
*   The real content of a document comprises objects representing material originally introduced by the document’s author.
*   Artifacts are graphics objects that are typically not part of the author’s original content but rather are generated by the PDF producer application in the course of pagination, layout, or other strictly mechanical processes. Artifacts may also be used to describe areas of the document where the author uses a graphical background, with the goal of enhancing the visual experience. In such a case, the background is not required for understanding the content.
{{< /alert >}}

According to artifact definition, the watermark can be represented by an artifact in a PDF document. The following example shows how artifact watermark can be added to a document with GroupDocs.Watermark using [PdfArtifactWatermarkOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PdfArtifactWatermarkOptions).
**advanced\_usage.add\_watermarks\_to\_pdf.PdfAddArtifactWatermark**
```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfArtifactWatermarkOptions options = new PdfArtifactWatermarkOptions();                                 
                                                                                                         
// Add text watermark                                                                                    
TextWatermark textWatermark = new TextWatermark("This is an artifact watermark", new Font("Arial", 8));  
textWatermark.setHorizontalAlignment(HorizontalAlignment.Right);                                         
watermarker.add(textWatermark, options);                                                                 
                                                                                                         
// Add image watermark                                                                                   
ImageWatermark imageWatermark = new ImageWatermark("logo.bmp");                                   
                                                                                                         
watermarker.add(imageWatermark, options);                                                                
                                                                                                         
imageWatermark.close();                                                                                  
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

## Annotations
{{< alert style="info" >}}
**PDF Reference 1.7** 

An annotation associates an object such as a note, sound, or movie with a location on a page of a PDF document, or provides a way to interact with the user by means of the mouse and keyboard. PDF includes a wide variety of standard annotation types.
A watermark annotation (PDF 1.6) is used to represent graphics that are expected to be printed at a fixed size and position on a page, regardless of the dimensions of the printed page.
{{< /alert >}}

Annotation is the third type of PDF entities by which a watermark can be represented. Use the following code snippet to add watermark annotation to a PDF document using [PdfAnnotationWatermarkOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PdfAnnotationWatermarkOptions).
**advanced\_usage.add\_watermarks\_to\_pdf.PdfAddAnnotationWatermark**
```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfAnnotationWatermarkOptions options = new PdfAnnotationWatermarkOptions();                             
                                                                                                         
// Add text watermark                                                                                    
TextWatermark textWatermark = new TextWatermark("This is a annotation watermark", new Font("Arial", 8)); 
textWatermark.setHorizontalAlignment(HorizontalAlignment.Left);                                          
textWatermark.setVerticalAlignment(VerticalAlignment.Top);                                               
watermarker.add(textWatermark, options);                                                                 
                                                                                                         
// Add image watermark                                                                                   
ImageWatermark imageWatermark = new ImageWatermark("protect.jpg");                                
                                                                                                         
imageWatermark.setHorizontalAlignment(HorizontalAlignment.Right);                                        
imageWatermark.setVerticalAlignment(VerticalAlignment.Top);                                              
watermarker.add(imageWatermark, options);                                                                
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
imageWatermark.close();                                                                                  
watermarker.close();                                                                                     
```

## Print-only annotations  

You can also add print only annotation watermark to the document using [setPrintOnly()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PdfAnnotationWatermarkOptions#setPrintOnly(boolean)) method of [PdfAnnotationWatermarkOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PdfAnnotationWatermarkOptions). The following code demonstrates this approach.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfAddPrintOnlyAnnotationWatermark**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                                          
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"                                   
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                                            
                                                                                                                                            
TextWatermark textWatermark = new TextWatermark("This is a print only test watermark. It won't appear in view mode.", new Font("Arial", 8));
Boolean isPrintOnly = true;                                                                                                                 
                                                                                                                                            
// Annotation will be printed, but not displayed in pdf viewing application                                                                 
PdfAnnotationWatermarkOptions options = new PdfAnnotationWatermarkOptions();                                                                
options.setPageIndex(0);                                                                                                                    
options.setPrintOnly(isPrintOnly);                                                                                                          
watermarker.add(textWatermark, options);                                                                                                    
                                                                                                                                            
watermarker.save("document.pdf");                                                                                                 
                                                                                                                                            
watermarker.close();                                                                                                                        
```

---

## Working with CSV Data Sources

Path: /assembly/java/working-with-csv-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 19.10 or later releases.{{< /alert >}}

To access CSV data while building a report, you can pass a *CsvDataSource* instance to the assembler as a data source. Using of *CsvDataSource* enables you to work with typed values rather than just strings in template documents. Although CSV as a format does not define a way to store values of types other than strings, *CsvDataSource* is capable to recognize values of the following types by their string representations:

*   Int32?
*   Int64?
*   Double?
*   Boolean?
*   DateTime?

{{< alert style="warning" >}}For recognition of data types to work, string representations of corresponding values must be formed using invariant culture settings.{{< /alert >}}

### Treating simple CSV data

In template documents, a *CsvDataSource* instance should be treated in the same way as if it was a *DataTable* instance (see "[Working with *DataTable* and *DataView* Objects](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-data-sources)" for more information) as shown in the following example.

Suppose we have CSV data like:
```
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

By using the template like following:

```
<<foreach \[in persons\]>>Name: <<\[Column1\]>>, Age: <<\[Column2\]>>, Date
of Birth: <<\[Column3\]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<\[persons.average(p => p.Column2)\]>>
```

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

{{< alert style="warning" >}}Using of the custom date-time format and the extension method involving arithmetic in the template document becomes possible, because text values of Column3 and Column2 are automatically converted to DateTime? and Int32? respectively.{{< /alert >}}

### Configure data source to read column names

By default, *CsvDataSource* uses column names such as "*Column1*", "*Column2*", and so on, as you can see from the previous example. However, *CsvDataSource* can be configured to read column names from the first line of CSV data as shown in the following example.

Suppose we have CSV data like:
```
Name,Age,Birth
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

By using the template like following:
```
<<foreach \[in persons\]>>Name: <<\[Name\]>>, Age: <<\[Age\]>>, Date of
Birth: <<\[Birth\]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<\[persons.average(p => p.Age)\]>>
```

The code should be written like:

{{< gist GroupDocsGists ecbe5e7331f08a3f0bccd81a1ef57995 SimpleCsvDS_Demo_19.10.java >}}

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

Also, you can use *CsvDataLoadOptions* to customize the following characters playing special roles while loading CSV data:

*   Value separator (the default is comma)
*   Single-line comment start (the default is sharp)
*   Quotation mark enabling to use other special characters within a value (the default is double quotes)

###  Download

#### Data Source Document

*   [Person.csv](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/XML%20DataSource/Managers.xml?raw=true)

#### Template

*   [Template Demo.txt](attachments/85819665/85917712.txt)

---

## Working with CSV Data Sources

Path: /assembly/net/working-with-csv-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 19.10 or later releases.{{< /alert >}}

To access CSV data while building a report, you can pass a [CsvDataSource](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/csvdatasource) instance to the assembler as a data source. Using of *CsvDataSource* enables you to work with typed values rather than just strings in template documents. Although CSV as a format does not define a way to store values of types other than strings, *CsvDataSource* is capable to recognize values of the following types by their string representations:

*   Int32?
*   Int64?
*   Double?
*   Boolean?
*   DateTime?

{{< alert style="warning" >}}For recognition of data types to work, string representations of corresponding values must be formed using invariant culture settings.{{< /alert >}}

### Treating simple CSV data

In template documents, a [CsvDataSource ](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/csvdatasource)instance should be treated in the same way as if it was a *DataTable* instance (see "[Working with *DataTable* and *DataView* Objects](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-data-sources)" for more information) as shown in the following example.

Suppose we have CSV data like:
```
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

By using the template like following:
```
<<foreach \[in persons\]>>Name: <<\[Column1\]>>, Age: <<\[Column2\]>>, Date
of Birth: <<\[Column3\]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<\[persons.Average(p => p.Column2)\]>>
```

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

{{< alert style="warning" >}}Using of the custom date-time format and the extension method involving arithmetic in the template document becomes possible, because text values of Column3 and Column2 are automatically converted to DateTime? and Int32? respectively.{{< /alert >}}

### Configure data source to read column names

By default, [CsvDataSource ](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/csvdatasource)uses column names such as "*Column1*", "*Column2*", and so on, as you can see from the previous example. However, *CsvDataSource* can be configured to read column names from the first line of CSV data as shown in the following example.

Suppose we have CSV data like:
```
Name,Age,Birth
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

By using the template like following:
```
<<foreach \[in persons\]>>Name: <<\[Name\]>>, Age: <<\[Age\]>>, Date of
Birth: <<\[Birth\]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<\[persons.Average(p => p.Age)\]>>
```

The code should be written like:
{{< gist GroupDocsGists f59b71ca7e6345f9ac817297f3707f5f >}}

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

Also, you can use *CsvDataLoadOptions* to customize the following characters playing special roles while loading CSV data:

*   Value separator (the default is comma)
*   Single-line comment start (the default is sharp)
*   Quotation mark enabling to use other special characters within a value (the default is double quotes)

###  Download

#### Data Source Document

*   [Person.csv](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/XML%20DataSource/Managers.xml?raw=true)

#### Template

*   [Demo Template.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Using%20Spreadsheet%20as%20Table%20of%20Data.docx?raw=true)

---

## Working with EXIF metadata

Path: /metadata/java/working-with-exif-metadata/

## What is EXIF?

According to the [specification](https://www.exif.org/Exif2-2.PDF), EXIF (Exchangeable image file format) is a standard that specifies the formats to be used for images, sound and tags in digital still cameras and in other systems handling the image and sound files recorded by digital still cameras. Despite the confusing definition and name of the format, EXIF is just a metadata standard. In fact, it simply defines a way to store metadata properties in a variety of well-known image and audio formats. The EXIF tag structure is borrowed from TIFF files. The [specification](https://www.exif.org/Exif2-2.PDF) declares a set of tags intended to store technical details such as the geolocation of the place where a picture was taken, the name of the camera owner, camera settings, etc. 

{{< alert style="info" >}}
Please refer to the [following article](https://en.wikipedia.org/wiki/Exif) to get more information on the standard.
{{< /alert >}}

## Reading basic EXIF properties

To access EXIF metadata in a file of any supported format, GroupDocs.Metadata provides the [IExif.getExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IExif#getExifPackage()) method. The following are the steps to read EXIF metadata:

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.getExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IExif#getExifPackage()) method

The following code snippet gets EXIF properties of a TIFF image and displays them on the screen. 

**advanced\_usage.working\_with\_metadata\_standards.exif.ReadBasicExifProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.TiffWithExif)) {
	IExif root = (IExif) metadata.getRootPackage();
	if (root.getExifPackage() != null) {
		System.out.println(root.getExifPackage().getArtist());
		System.out.println(root.getExifPackage().getCopyright());
		System.out.println(root.getExifPackage().getImageDescription());
		System.out.println(root.getExifPackage().getMake());
		System.out.println(root.getExifPackage().getModel());
		System.out.println(root.getExifPackage().getSoftware());
		System.out.println(root.getExifPackage().getImageWidth());
		System.out.println(root.getExifPackage().getImageLength());

		// ...

		System.out.println(root.getExifPackage().getExifIfdPackage().getBodySerialNumber());
		System.out.println(root.getExifPackage().getExifIfdPackage().getCameraOwnerName());
		System.out.println(root.getExifPackage().getExifIfdPackage().getUserComment());

		// ...

		System.out.println(root.getExifPackage().getGpsPackage().getAltitude());
		System.out.println(root.getExifPackage().getGpsPackage().getLatitudeRef());
		System.out.println(root.getExifPackage().getGpsPackage().getLongitudeRef());

		// ...
	}
}
```

## Reading all EXIF tags

In some cases, it's necessary to read all EXIF properties from a file, including custom ones. To achieve this the GroupDocs.Metadata API provides direct access to the EXIF tags extracted from a file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.getExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IExif#getExifPackage()) method
3.  Iterate through all EXIF tags on different levels

**advanced\_usage.working\_with\_metadata\_standards.exif.ReadExifTags**

```csharp
try (Metadata metadata = new Metadata(Constants.JpegWithExif)) {
	IExif root = (IExif) metadata.getRootPackage();
	if (root.getExifPackage() != null) {
		String pattern = "%s = %s";

		for (TiffTag tag : root.getExifPackage().toList()) {
			System.out.println(String.format(pattern, tag.getTagID(), tag.getValue()));
		}

		for (TiffTag tag : root.getExifPackage().getExifIfdPackage().toList()) {
			System.out.println(String.format(pattern, tag.getTagID(), tag.getValue()));
		}

		for (TiffTag tag : root.getExifPackage().getGpsPackage().toList()) {
			System.out.println(String.format(pattern, tag.getTagID(), tag.getValue()));
		}
	}
}
```

## Reading a specific EXIF tag

The GroupDocs.Metadata API also supports reading specific EXIF tags using a method that accepts the tag id as a parameter. Follow below-mentioned steps to read a specific EXIF tag.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.getExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IExif#getExifPackage()) method
3.  Get a specific tag using the [getByTiffTagID](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ExifDictionaryBasePackage#getByTiffTagID(int)) method

**advanced\_usage.working\_with\_metadata\_standards.exif.ReadSpecificExifTag**

```csharp
try (Metadata metadata = new Metadata(Constants.TiffWithExif)) {
    IExif root = (IExif) metadata.getRootPackage();
    if (root.getExifPackage() != null) {
        TiffAsciiTag software = (TiffAsciiTag) root.getExifPackage().getByTiffTagID(TiffTagID.Software);
        if (software != null) {
            System.out.println(String.format("Software: %s", software.getValue()));
        }
         
        TiffUndefinedTag comment = (TiffUndefinedTag)root.getExifPackage().getExifIfdPackage().getByTiffTagID(TiffTagID.UserComment);
        if (comment != null) {
            System.out.println(String.format("Comment: %s", comment.getInterpretedValue()));
        }
    }
}
```

## Updating EXIF properties

The GroupDocs.Metadata API facilitates the user to update EXIF metadata in a convenient way - using the [ExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ExifPackage) class methods. Follow the below steps to update EXIF metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.getExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IExif#getExifPackage()) method
3.  Assign values to desired EXIF properties
4.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.working\_with\_metadata\_standards.exif.UpdateExifProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputJpeg)) {
	IExif root = (IExif) metadata.getRootPackage();
	// Set the EXIF package if it's missing
	if (root.getExifPackage() == null) {
		root.setExifPackage(new ExifPackage());
	}

	root.getExifPackage().setCopyright("Copyright (C) 2011-2020 GroupDocs. All Rights Reserved.");
	root.getExifPackage().setImageDescription("test image");
	root.getExifPackage().setSoftware("GroupDocs.Metadata");

	// ...

	root.getExifPackage().getExifIfdPackage().setBodySerialNumber("test");
	root.getExifPackage().getExifIfdPackage().setCameraOwnerName("GroupDocs");
	root.getExifPackage().getExifIfdPackage().setUserComment("test comment");

	// ...

	metadata.save(Constants.OutputJpeg);
}
```

## Adding or updating custom EXIF tags

The GroupDocs.Metadata API allows adding or updating custom tags in an EXIF package.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.getExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IExif#getExifPackage()) method
3.  Set the EXIF package if it's missing
4.  Add any number of custom tags to the package
5.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.working\_with\_metadata\_standards.exif.SetCustomExifTag**

```csharp
try (Metadata metadata = new Metadata(Constants.TiffWithExif)) {
	IExif root = (IExif) metadata.getRootPackage();
	// Set the EXIF package if it's missing
	if (root.getExifPackage() == null) {
		root.setExifPackage(new ExifPackage());
	}

	// Add a known property
	root.getExifPackage().set(new TiffAsciiTag(TiffTagID.Artist, "test artist"));

	// Add a fully custom property (which is not described in the EXIF specification).
	// Please note that the chosen ID may intersect with the IDs used by some third party tools.
	root.getExifPackage().set(new TiffAsciiTag(65523, "custom"));
	metadata.save(Constants.OutputTiff);
}
```

Here is a full list of tags that can be added to an EXIF package:

*   [TiffAsciiTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffAsciiTag)
*   [TiffByteTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffByteTag)
*   [TiffDoubleTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffDoubleTag)
*   [TiffFloatTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffFloatTag)
*   [TiffLongTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffLongTag)
*   [TiffRationalTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffRationalTag)
*   [TiffSByteTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffSByteTag)
*   [TiffShortTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffShortTag)
*   [TiffSLongTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffSLongTag)
*   [TiffSRationalTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffSRationalTag)
*   [TiffSShortTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffSShortTag)
*   [TiffUndefinedTag](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TiffUndefinedTag)

## Removing EXIF metadata

To remove the EXIF package from a file just pass null to the [IExif.setExifPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IExif#setExifPackage(com.groupdocs.metadata.core.ExifPackage)) method. The code sample below shows how to remove EXIF metadata from a file.

**advanced\_usage.working\_with\_metadata\_standards.exif.RemoveExifMetadata**

```csharp
try (Metadata metadata = new Metadata(Constants.JpegWithExif)) {
	IExif root = (IExif) metadata.getRootPackage();
	root.setExifPackage(null);
	metadata.save(Constants.OutputJpeg);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with EXIF metadata

Path: /metadata/net/working-with-exif-metadata/

## What is EXIF?

According to the [specification](https://www.exif.org/Exif2-2.PDF), EXIF (Exchangeable image file format) is a standard that specifies the formats to be used for images, sound and tags in digital still cameras and in other systems handling the image and sound files recorded by digital still cameras. Despite the confusing definition and name of the format, EXIF is just a metadata standard. In fact, it simply defines a way to store metadata properties in a variety of well-known image and audio formats. The EXIF tag structure is borrowed from TIFF files. The [specification](https://www.exif.org/Exif2-2.PDF) declares a set of tags intended to store technical details such as the geolocation of the place where a picture was taken, the name of the camera owner, camera settings, etc. 

{{< alert style="info" >}}
Please refer to the [following article](https://en.wikipedia.org/wiki/Exif) to get more information on the standard.
{{< /alert >}}

## Reading basic EXIF properties

To access EXIF metadata in a file of any supported format, GroupDocs.Metadata provides the [IExif.ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/iexif/properties/exifpackage) property. The following are the steps to read EXIF metadata:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/iexif/properties/exifpackage) property

The following code snippet gets EXIF properties of a TIFF image and displays them on the screen. 

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Exif.ReadBasicExifProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.TiffWithExif))
{
	IExif root = metadata.GetRootPackage() as IExif;
	if (root != null && root.ExifPackage != null)
	{
		Console.WriteLine(root.ExifPackage.Artist);
		Console.WriteLine(root.ExifPackage.Copyright);
		Console.WriteLine(root.ExifPackage.ImageDescription);
		Console.WriteLine(root.ExifPackage.Make);
		Console.WriteLine(root.ExifPackage.Model);
		Console.WriteLine(root.ExifPackage.Software);
		Console.WriteLine(root.ExifPackage.ImageWidth);
		Console.WriteLine(root.ExifPackage.ImageLength);

		// ...

		Console.WriteLine(root.ExifPackage.ExifIfdPackage.BodySerialNumber);
		Console.WriteLine(root.ExifPackage.ExifIfdPackage.CameraOwnerName);
		Console.WriteLine(root.ExifPackage.ExifIfdPackage.UserComment);

		// ...

		Console.WriteLine(root.ExifPackage.GpsPackage.Altitude);
		Console.WriteLine(root.ExifPackage.GpsPackage.LatitudeRef);
		Console.WriteLine(root.ExifPackage.GpsPackage.LongitudeRef);

		// ...
	}
}
```

## Reading all EXIF tags

In some cases, it's necessary to read all EXIF properties from a file, including custom ones. To achieve this the GroupDocs.Metadata API provides direct access to the EXIF tags extracted from a file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/iexif/properties/exifpackage) property
3.  Iterate through all EXIF tags on different levels

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Exif.ReadExifTags**

```csharp
using (Metadata metadata = new Metadata(Constants.JpegWithExif))
{
	IExif root = metadata.GetRootPackage() as IExif;
	if (root != null && root.ExifPackage != null)
	{
		const string pattern = "{0} = {1}";

		foreach (TiffTag tag in root.ExifPackage.ToList())
		{
			Console.WriteLine(pattern, tag.TagID, tag.Value);
		}

		foreach (TiffTag tag in root.ExifPackage.ExifIfdPackage.ToList())
		{
			Console.WriteLine(pattern, tag.TagID, tag.Value);
		}

		foreach (TiffTag tag in root.ExifPackage.GpsPackage.ToList())
		{
			Console.WriteLine(pattern, tag.TagID, tag.Value);
		}
	}
}
```

## Reading a specific EXIF tag

The GroupDocs.Metadata API also supports reading specific EXIF tags using an indexer. Follow below-mentioned steps to read a specific EXIF tag.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/iexif/properties/exifpackage) property
3.  Get a specific tag using the [ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/exifpackage) class [indexer](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/exifdictionarybasepackage/properties/item)

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Exif.ReadSpecificExifTag**

```csharp
using (Metadata metadata = new Metadata(Constants.TiffWithExif))
{
    IExif root = metadata.GetRootPackage() as IExif;
    if (root != null && root.ExifPackage != null)
    {
        TiffAsciiTag software = (TiffAsciiTag)root.ExifPackage[TiffTagID.Software];
        if (software != null)
        {
            Console.WriteLine("Software: {0}", software.Value);
        }
 
        TiffUndefinedTag comment = (TiffUndefinedTag)root.ExifPackage.ExifIfdPackage[TiffTagID.UserComment];
        if (comment != null)
        {
            Console.WriteLine("Comment: {0}", comment.InterpretedValue);
        }
    }
}
```

## Updating EXIF properties

The GroupDocs.Metadata API facilitates the user to update EXIF metadata in a convenient way - using the [ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/exifpackage) class properties. Follow the below steps to update EXIF metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/iexif/properties/exifpackage) property
3.  Assign values to desired EXIF properties
4.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Exif.UpdateExifProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputJpeg))
{
	IExif root = metadata.GetRootPackage() as IExif;
	if (root != null)
	{
		// Set the EXIF package if it's missing
		if (root.ExifPackage == null)
		{
			root.ExifPackage = new ExifPackage();
		}

		root.ExifPackage.Copyright = "Copyright (C) 2011-2019 GroupDocs. All Rights Reserved.";
		root.ExifPackage.ImageDescription = "test image";
		root.ExifPackage.Software = "GroupDocs.Metadata";

		// ...

		root.ExifPackage.ExifIfdPackage.BodySerialNumber = "test";
		root.ExifPackage.ExifIfdPackage.CameraOwnerName = "GroupDocs";
		root.ExifPackage.ExifIfdPackage.UserComment = "test comment";

		// ...

		metadata.Save(Constants.OutputJpeg);
	}
}
```

## Adding or updating custom EXIF tags

The GroupDocs.Metadata API allows adding or updating custom tags in an EXIF package.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the [IExif.ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/iexif/properties/exifpackage) property
3.  Set the EXIF package if it's missing
4.  Add any number of custom tags to the package
5.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Exif.SetCustomExifTag**

```csharp
using (Metadata metadata = new Metadata(Constants.TiffWithExif))
{
	IExif root = metadata.GetRootPackage() as IExif;
	if (root != null)
	{
		// Set the EXIF package if it's missing
		if (root.ExifPackage == null)
		{
			root.ExifPackage = new ExifPackage();
		}

		// Add a known property
		root.ExifPackage.Set(new TiffAsciiTag(TiffTagID.Artist, "test artist"));

		// Add a fully custom property (which is not described in the EXIF specification).
		// Please note that the chosen ID may intersect with the IDs used by some third party tools.
		root.ExifPackage.Set(new TiffAsciiTag((TiffTagID)65523, "custom"));

		metadata.Save(Constants.OutputTiff);
	}
}
```

Here is a full list of tags that can be added to an EXIF package:

*   [TiffAsciiTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffasciitag)
*   [TiffByteTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffbytetag)
*   [TiffDoubleTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffdoubletag)
*   [TiffFloatTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tifffloattag)
*   [TiffLongTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tifflongtag)
*   [TiffRationalTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffrationaltag)
*   [TiffSByteTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffsbytetag)
*   [TiffShortTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffshorttag)
*   [TiffSLongTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffslongtag)
*   [TiffSRationalTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffsrationaltag)
*   [TiffSShortTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffsshorttag)
*   [TiffUndefinedTag](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/tiffundefinedtag)

## Removing EXIF metadata

To remove the EXIF package from a file just assign null to the [IExif.ExifPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.exif/iexif/properties/exifpackage) property. The code sample below shows how to remove EXIF metadata from a file.

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Exif.RemoveExifMetadata**

```csharp
using (Metadata metadata = new Metadata(Constants.JpegWithExif))
{
	IExif root = metadata.GetRootPackage() as IExif;
	if (root != null)
	{
		root.ExifPackage = null;
		metadata.Save(Constants.OutputJpeg);
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with EXIF metadata

Path: /metadata/nodejs-java/working-with-exif-metadata/

## What is EXIF?

According to the [specification](https://www.exif.org/Exif2-2.PDF), EXIF (Exchangeable image file format) is a standard that specifies the formats to be used for images, sound and tags in digital still cameras and in other systems handling the image and sound files recorded by digital still cameras. Despite the confusing definition and name of the format, EXIF is just a metadata standard. In fact, it simply defines a way to store metadata properties in a variety of well-known image and audio formats. The EXIF tag structure is borrowed from TIFF files. The [specification](https://www.exif.org/Exif2-2.PDF) declares a set of tags intended to store technical details such as the geolocation of the place where a picture was taken, the name of the camera owner, camera settings, etc. 

{{< alert style="info" >}}
Please refer to the [following article](https://en.wikipedia.org/wiki/Exif) to get more information on the standard.
{{< /alert >}}

## Reading basic EXIF properties

To access EXIF metadata in a file of any supported format, GroupDocs.Metadata provides the **IExif.getExifPackage** method. The following are the steps to read EXIF metadata:

1.   **Load** a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the **IExif.getExifPackage** method

The following code snippet gets EXIF properties of a TIFF image and displays them on the screen. 

**advanced\_usage.working\_with\_metadata\_standards.exif.ReadBasicExifProperties**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata(Constants.TiffWithExif);
    var root = metadata.getRootPackage();
            if (root.getExifPackage() != null) {
                console.log(root.getExifPackage().getArtist());
                console.log(root.getExifPackage().getSoftware());

                // ...

                console.log(root.getExifPackage().getExifIfdPackage().getBodySerialNumber());

                // ...

                console.log(root.getExifPackage().getGpsPackage().getAltitude());

                // ...
            }
```
{{< /tab >}}
{{< /tabs >}}


Here is a full list of tags that can be added to an EXIF package:

*   __TiffAsciiTag__
*   __TiffByteTag__
*   __TiffDoubleTag__
*   __TiffFloatTag__
*   __TiffLongTag__
*   __TiffRationalTag__
*   __TiffSByteTag__
*   __TiffShortTag__
*   __TiffSLongTag__
*   __TiffSRationalTag__
*   __TiffSShortTag__
*   __TiffUndefinedTag__

## Removing EXIF metadata

To remove the EXIF package from a file just pass null to the **IExif.setExifPackage** method. The code sample below shows how to remove EXIF metadata from a file.

**advanced\_usage.working\_with\_metadata\_standards.exif.RemoveExifMetadata**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata(Constants.TiffWithExif);
    var root = metadata.getRootPackage();
    root.setExifPackage(null);
    metadata.save(Constants.OutputJpeg);
}
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with EXIF metadata

Path: /metadata/python-net/working-with-exif-metadata/

## What is EXIF?

According to the specification, EXIF (Exchangeable image file format) is a standard that specifies the formats to be used for images, sound and tags in digital still cameras and in other systems handling the image and sound files recorded by digital still cameras. Despite the confusing definition and name of the format, EXIF is just a metadata standard. In fact, it simply defines a way to store metadata properties in a variety of well-known image and audio formats. The EXIF tag structure is borrowed from TIFF files. The specification declares a set of tags intended to store technical details such as the geolocation of the place where a picture was taken, the name of the camera owner, camera settings, etc. 

{{< alert style="info" >}}
Please refer to the following article to get more information on the standard: https://en.wikipedia.org/wiki/Exif
{{< /alert >}}

## Reading basic EXIF properties

To access EXIF metadata in a file of any supported format, GroupDocs.Metadata provides the `IExif.exif_package` property. The following are the steps to read EXIF metadata:

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the `IExif.exif_package` property

The following code snippet gets EXIF properties of a TIFF image and displays them on the screen. 

**advanced_usage.working_with_metadata_standards.exif.read_basic_exif_properties**


```python
def run():
    with gm.Metadata(constants.tiff_with_exif) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "exif_package") and root.exif_package is not None:
            print(root.exif_package.artist)
            print(root.exif_package.copyright)
            print(root.exif_package.image_description)
            print(root.exif_package.make)
            print(root.exif_package.model)
            print(root.exif_package.software)
            print(root.exif_package.image_width)
            print(root.exif_package.image_length)

            # ...

            print(root.exif_package.exif_ifd_package.body_serial_number)
            print(root.exif_package.exif_ifd_package.camera_owner_name)
            print(root.exif_package.exif_ifd_package.user_comment)

            # ...

            print(root.exif_package.gps_package.altitude)
            print(root.exif_package.gps_package.latitude_ref)
            print(root.exif_package.gps_package.longitude_ref)
```


## Reading all EXIF tags

In some cases, it's necessary to read all EXIF properties from a file, including custom ones. To achieve this the GroupDocs.Metadata API provides direct access to the EXIF tags extracted from a file.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the `IExif.exif_package` property
3.  Iterate through all EXIF tags on different levels

**advanced_usage.working_with_metadata_standards.exif.read_exif_tags**


```python
def run():
    with gm.Metadata(constants.jpeg_with_exif) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "exif_package") and root.exif_package is not None:
            pattern = "{0} = {1}"

            for tag in root.exif_package.to_list():
                print(pattern.format(tag.tag_id, tag.value))

            for tag in root.exif_package.exif_ifd_package.to_list():
                print(pattern.format(tag.tag_id, tag.value))

            for tag in root.exif_package.gps_package.to_list():
                print(pattern.format(tag.tag_id, tag.value))
```


## Reading a specific EXIF tag

The GroupDocs.Metadata API also supports reading specific EXIF tags using an indexer. Follow below-mentioned steps to read a specific EXIF tag.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the `IExif.exif_package` property
3.  Get a specific tag using the `ExifPackage` class indexer

**advanced_usage.working_with_metadata_standards.exif.read_specific_exif_tag**


```python
def run():
    with gm.Metadata(constants.tiff_with_exif) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "exif_package") and root.exif_package is not None:
            software = root.exif_package[TiffTagID.SOFTWARE]
            if software is not None:
                print(f"Software: {software.value}")

            comment = root.exif_package.exif_ifd_package[TiffTagID.USER_COMMENT]
            if comment is not None:
                print(f"Comment: {comment.interpreted_value}")
```


## Updating EXIF properties

The GroupDocs.Metadata API facilitates the user to update EXIF metadata in a convenient way - using the `ExifPackage` class properties. Follow the below steps to update EXIF metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the `IExif.exif_package` property
3.  Assign values to desired EXIF properties
4.  [Save]({{< ref "metadata/python-net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced_usage.working_with_metadata_standards.exif.update_exif_properties**


```python
def run():
    with gm.Metadata(constants.input_jpeg) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "exif_package") is False or root.exif_package is None:
            root.exif_package = gm.standards.exif.ExifPackage()

        root.exif_package.copyright = "Copyright (C) 2011-2019 GroupDocs. All Rights Reserved."
        root.exif_package.image_description = "test image"
        root.exif_package.software = "GroupDocs.Metadata"

        # ...

        root.exif_package.exif_ifd_package.body_serial_number = "test"
        root.exif_package.exif_ifd_package.camera_owner_name = "GroupDocs"
        root.exif_package.exif_ifd_package.user_comment = "test comment"

        # ...

        metadata.save(constants.output_jpeg)
```


## Adding or updating custom EXIF tags

The GroupDocs.Metadata API allows adding or updating custom tags in an EXIF package.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains EXIF metadata
2.  Extract the EXIF metadata package using the `IExif.exif_package` property
3.  Set the EXIF package if it's missing
4.  Add any number of custom tags to the package
5.  [Save]({{< ref "metadata/python-net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced_usage.working_with_metadata_standards.exif.set_custom_exif_tag**


```python
def run():
    with gm.Metadata(constants.tiff_with_exif) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "exif_package") is False or root.exif_package is None:
            root.exif_package = gm.standards.exif.ExifPackage()

        # Add a known property
        root.exif_package.set(gm.formats.image.TiffAsciiTag(TiffTagID.ARTIST, "test artist"))

        # Add a fully custom property (which is not described in the EXIF specification).
        # Please note that the chosen ID may intersect with the IDs used by some third party tools.
        root.exif_package.set(gm.formats.image.TiffAsciiTag(TiffTagID(65523), "custom"))

        metadata.save(constants.output_tiff)
```


Here is a full list of tags that can be added to an EXIF package:

*   `TiffAsciiTag`
*   `TiffByteTag`
*   `TiffDoubleTag`
*   `TiffFloatTag`
*   `TiffLongTag`
*   `TiffRationalTag`
*   `TiffSByteTag`
*   `TiffShortTag`
*   `TiffSLongTag`
*   `TiffSRationalTag`
*   `TiffSShortTag`
*   `TiffUndefinedTag`

## Removing EXIF metadata

To remove the EXIF package from a file just assign `None` to the `IExif.exif_package` property. The code sample below shows how to remove EXIF metadata from a file.

**advanced_usage.working_with_metadata_standards.exif.remove_exif_metadata**


```python
def run():
    with gm.Metadata(constants.jpeg_with_exif) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "exif_package"):
            root.exif_package = None
            metadata.save(constants.output_jpeg)
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Working with metadata in ASF files

Path: /metadata/java/working-with-metadata-in-asf-files/

## Reading ASF format-specific properties

The GroupDocs.Metadata API supports extracting format-specific information from ASF files.

The following are the steps to read native ASF metadata.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an ASF video
2.  Get the root metadata package
3.  Extract  the native metadata package using the [AsfRootPackage.getAsfPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/AsfRootPackage#getAsfPackage()) method
4.  Read the ASF metadata properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>video.asf.AsfReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputAsf)) {
	AsfRootPackage root = metadata.getRootPackageGeneric();
	AsfPackage asfPackage = root.getAsfPackage();

	// Display basic properties
	System.out.println(String.format("Creation date: %s", asfPackage.getCreationDate()));
	System.out.println(String.format("File id: %s", asfPackage.getFileID()));
	System.out.println(String.format("Flags: %s", asfPackage.getFlags()));

	// Display Asf Codec Information
	for (AsfCodec codecInfo : asfPackage.getCodecInformation()) {
		System.out.println(String.format("Codec type: %s", codecInfo.getCodecType()));
		System.out.println(String.format("Description: %s", codecInfo.getDescription()));
		System.out.println(String.format("Codec information: %s", codecInfo.getInformation()));
		System.out.println(codecInfo.getName());
	}

	// Display metadata descriptors
	for (AsfBaseDescriptor descriptor : asfPackage.getMetadataDescriptors()) {
		System.out.println(String.format("Name: %s", descriptor.getName()));
		System.out.println(String.format("Value: %s", descriptor.getValue()));
		System.out.println(String.format("Content type: %s", descriptor.getAsfContentType()));
		if (descriptor instanceof AsfMetadataDescriptor) {
			AsfMetadataDescriptor metadataDescriptor = (AsfMetadataDescriptor) descriptor;
			System.out.println(String.format("Language: %s", metadataDescriptor.getLanguage()));
			System.out.println(String.format("Stream number: %s", metadataDescriptor.getStreamNumber()));
			System.out.println(String.format("Original name: %s", metadataDescriptor.getOriginalName()));
		}
	}

	//Display the base stream properties
	for (AsfBaseStreamProperty property : asfPackage.getStreamProperties()) {
		System.out.println(String.format("Alternate bitrate: %s", property.getAlternateBitrate()));
		System.out.println(String.format("Average bitrate: %s", property.getAverageBitrate()));
		System.out.println(String.format("Average time per frame: %s", property.getAverageTimePerFrame()));
		System.out.println(String.format("Bitrate: %s", property.getBitrate()));
		System.out.println(String.format("Stream end time: %s", property.getEndTime()));
		System.out.println(String.format("Stream flags: %s", property.getFlags()));
		System.out.println(String.format("Stream language: %s", property.getLanguage()));
		System.out.println(String.format("Stream start time: %s", property.getStartTime()));
		System.out.println(String.format("Stream number: %s", property.getStreamNumber()));
		System.out.println(String.format("Stream type: %s", property.getStreamType()));

		//Display the audio stream properties
		if (property instanceof AsfAudioStreamProperty) {
			AsfAudioStreamProperty audioStreamProperty = (AsfAudioStreamProperty) property;
			System.out.println(String.format("Audio bits per sample: %s", audioStreamProperty.getBitsPerSample()));
			System.out.println(String.format("Audio channels: %s", audioStreamProperty.getChannels()));
			System.out.println(String.format("Audio format tag: %s", audioStreamProperty.getFormatTag()));
			System.out.println(String.format("Audio samples per second: %s", audioStreamProperty.getSamplesPerSecond()));
		}

		//Display the video stream properties
		if (property instanceof AsfVideoStreamProperty) {
			AsfVideoStreamProperty videoStreamProperty = (AsfVideoStreamProperty) property;
			System.out.println(String.format("Video bits per pixels: %s", videoStreamProperty.getBitsPerPixels()));
			System.out.println(String.format("Compression: %s", videoStreamProperty.getCompression()));
			System.out.println(String.format("Image height: %s", videoStreamProperty.getImageHeight()));
			System.out.println(String.format("Image width: %s", videoStreamProperty.getImageWidth()));
		}
	}
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in ASF files. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with Metadata in ASF Files

Path: /metadata/net/working-with-metadata-in-asf-files/

#  Working with metadata in ASF files

## Reading ASF format-specific properties

The GroupDocs.Metadata API supports extracting format-specific information from ASF files.

The following are the steps to read native ASF metadata.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an ASF video
2.  Get the root metadata package
3.  Extract  the native metadata package using [AsfRootPackage.AsfPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.video/asfrootpackage/properties/asfpackage)
4.  Read the ASF metadata properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Video.Asf.AsfReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputAsf))
{
	var root = metadata.GetRootPackage<AsfRootPackage>();
	var package = root.AsfPackage;

	// Display basic properties
	Console.WriteLine("Creation date: {0}", package.CreationDate);
	Console.WriteLine("File id: {0}", package.FileID);
	Console.WriteLine("Flags: {0}", package.Flags);

	// Display Asf Codec Information
	foreach (var codecInfo in package.CodecInformation)
	{
		Console.WriteLine("Codec type: {0}", codecInfo.CodecType);
		Console.WriteLine("Description: {0}", codecInfo.Description);
		Console.WriteLine("Codec information: {0}", codecInfo.Information);
		Console.WriteLine(codecInfo.Name);
	}

	// Display metadata descriptors
	foreach (AsfBaseDescriptor descriptor in package.MetadataDescriptors)
	{
		Console.WriteLine("Name: {0}", descriptor.Name);
		Console.WriteLine("Value: {0}", descriptor.Value);
		Console.WriteLine("Content type: {0}", descriptor.AsfContentType);

		AsfMetadataDescriptor metadataDescriptor = descriptor as AsfMetadataDescriptor;
		if (metadataDescriptor != null)
		{
			Console.WriteLine("Language: {0}", metadataDescriptor.Language);
			Console.WriteLine("Stream number: {0}", metadataDescriptor.StreamNumber);
			Console.WriteLine("Original name: {0}", metadataDescriptor.OriginalName);
		}
	}

	//Display the base stream properties
	foreach (AsfBaseStreamProperty property in package.StreamProperties)
	{
		Console.WriteLine("Alternate bitrate: {0}", property.AlternateBitrate);
		Console.WriteLine("Average bitrate: {0}", property.AverageBitrate);
		Console.WriteLine("Average time per frame: {0}", property.AverageTimePerFrame);
		Console.WriteLine("Bitrate: {0}", property.Bitrate);
		Console.WriteLine("Stream end time: {0}", property.EndTime);
		Console.WriteLine("Stream flags: {0}", property.Flags);
		Console.WriteLine("Stream language: {0}", property.Language);
		Console.WriteLine("Stream start time: {0}", property.StartTime);
		Console.WriteLine("Stream number: {0}", property.StreamNumber);
		Console.WriteLine("Stream type: {0}", property.StreamType);

		//Display the audio stream properties
		AsfAudioStreamProperty audioStreamProperty = property as AsfAudioStreamProperty;
		if (audioStreamProperty != null)
		{
			Console.WriteLine("Audio bits per sample: {0}", audioStreamProperty.BitsPerSample);
			Console.WriteLine("Audio channels: {0}", audioStreamProperty.Channels);
			Console.WriteLine("Audio format tag: {0}", audioStreamProperty.FormatTag);
			Console.WriteLine("Audio samples per second: {0}", audioStreamProperty.SamplesPerSecond);
		}

		//Display the video stream properties
		AsfVideoStreamProperty videoStreamProperty = property as AsfVideoStreamProperty;
		if (videoStreamProperty != null)
		{
			Console.WriteLine("Video bits per pixels: {0}", videoStreamProperty.BitsPerPixels);
			Console.WriteLine("Compression: {0}", videoStreamProperty.Compression);
			Console.WriteLine("Image height: {0}", videoStreamProperty.ImageHeight);
			Console.WriteLine("Image width: {0}", videoStreamProperty.ImageWidth);
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in Word Processing documents

Path: /metadata/java/working-with-metadata-in-word-processing-documents/

GroupDocs.Metadata for Java provides functionality that allows working with different kinds of WordProcessing documents such as DOC, DOCX, ODT, etc. For the full list of supported document formats please refer to [Supported document formats]({{< ref "metadata/java/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a document

The following sample of code will help you to detect the exact type of a loaded document and extract some additional file format information.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a WordProcessing document
2.  Extract the root metadata package
3.  Use the [getWordProcessingType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/WordProcessingRootPackage#getWordProcessingType()) method to obtain file format information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingReadFileFormatProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDoc)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();
	System.out.println(root.getWordProcessingType().getFileFormat());
	System.out.println(root.getWordProcessingType().getWordProcessingFormat());
	System.out.println(root.getWordProcessingType().getMimeType());
	System.out.println(root.getWordProcessingType().getExtension());
}
```

## Reading built-in metadata properties

To access built-in metadata of a WordProcessing document, please use the [getDocumentProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage#getDocumentProperties()) method defined in the [DocumentRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingReadBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDocx)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();
	System.out.println(root.getDocumentProperties().getAuthor());
	System.out.println(root.getDocumentProperties().getCreatedTime());
	System.out.println(root.getDocumentProperties().getCompany());
	System.out.println(root.getDocumentProperties().getCategory());
	System.out.println(root.getDocumentProperties().getKeywords());

	// ...
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a WordProcessing document please follow the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingReadCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDoc)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();

	IReadOnlyList<MetadataProperty> customProperties = root.getDocumentProperties().findProperties(new ContainsTagSpecification(Tags.getDocument().getBuiltIn()).not());

	for (MetadataProperty property : customProperties) {
		System.out.println(String.format("%s = %s", property.getName(), property.getValue()));
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [findProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MetadataPackage#findProperties(com.groupdocs.metadata.search.Specification)) method for a certain metadata package (instance of the [WordProcessingPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/WordProcessingPackage) class), the search result will contain only metadata properties that are specific for WordProcessing documents. 

## Inspecting WordProcessing documents

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about digital signatures associated with a document, extract user comments from the document content, obtain pieces of hidden text, work with document revisions, etc. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a WordProcessing document
2.  Extract the root metadata package
3.  Use the [getInspectionPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/WordProcessingRootPackage#getInspectionPackage()) method to inspect the document

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingReadInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDocx)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();
	if (root.getInspectionPackage().getComments() != null) {
		for (WordProcessingComment comment : root.getInspectionPackage().getComments()) {
			System.out.println(comment.getAuthor());
			System.out.println(comment.getCreatedDate());
			System.out.println(comment.getText());

			// ...
		}
	}

	if (root.getInspectionPackage().getDigitalSignatures() != null) {
		for (DigitalSignature signature : root.getInspectionPackage().getDigitalSignatures()) {
			System.out.println(signature.getCertificateSubject());
			System.out.println(signature.getComments());
			System.out.println(signature.getSignTime());

			// ...
		}
	}

	if (root.getInspectionPackage().getFields() != null) {
		for (WordProcessingField field : root.getInspectionPackage().getFields()) {
			System.out.println(field.getCode());
			System.out.println(field.getResult());
		}
	}

	if (root.getInspectionPackage().getHiddenText() != null) {
		for (String textFragment : root.getInspectionPackage().getHiddenText()) {
			System.out.println(textFragment);
		}
	}

	if (root.getInspectionPackage().getRevisions() != null) {
		for (WordProcessingRevision revision : root.getInspectionPackage().getRevisions()) {
			System.out.println(revision.getAuthor());
			System.out.println(revision.getDateTime());
			System.out.println(revision.getRevisionType());
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a WordProcessing document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingReadDocumentStatistics**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDocx)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentStatistics().getCharacterCount());
	System.out.println(root.getDocumentStatistics().getPageCount());
	System.out.println(root.getDocumentStatistics().getWordCount());
}
```

## Reading Dublin Core metadata

Dublin Core metadata is a set of certain metadata properties that are intended to describe various digital resources. Please find more information on the Dublin Core standard at [https://en.wikipedia.org/wiki/Dublin\_Core](https://en.wikipedia.org/wiki/Dublin_Core). The code sample below shows how to extract Dublin Core metadata from a WordProcessing document using the GroupDocs.Metadata API.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingReadDublinCoreProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDocx)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();

	if (root.getDublinCorePackage() != null) {
		System.out.println(root.getDublinCorePackage().getFormat());
		System.out.println(root.getDublinCorePackage().getContributor());
		System.out.println(root.getDublinCorePackage().getCoverage());
		System.out.println(root.getDublinCorePackage().getCreator());
		System.out.println(root.getDublinCorePackage().getSource());
		System.out.println(root.getDublinCorePackage().getDescription());

		// ...
	}
}
```

Please see the [DublinCorePackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DublinCorePackage) class to get more information on supported Dublin Core metadata properties.

## Updating built-In metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a WordProcessing document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingUpdateBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDoc)) {

	WordProcessingRootPackage root = metadata.getRootPackageGeneric();
	root.getDocumentProperties().setAuthor("test author");
	root.getDocumentProperties().setCreatedTime(new Date());
	root.getDocumentProperties().setCompany("GroupDocs");
	root.getDocumentProperties().setCategory("test category");
	root.getDocumentProperties().setKeywords("metadata, built-in, update");

	// ...

	metadata.save(Constants.OutputDoc);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a WordProcessing document. Please check the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingUpdateCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDocx)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().set("customProperty1", "some value");
	root.getDocumentProperties().set("customProperty2", 7);

	metadata.save(Constants.OutputDocx);
}
```

## Updating inspection properties

When you inspect a document GroupDocs.Metadata for Java forms a metadata package containing the extracted information. The package class also provides some basic methods that allow updating (or removing) the extracted properties. The following code sample demonstrates how to remove/update the inspection properties in a WordProcessing document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingUpdateInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDoc)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();
	root.getInspectionPackage().clearComments();
	root.getInspectionPackage().acceptAllRevisions();
	root.getInspectionPackage().clearFields();
	root.getInspectionPackage().clearHiddenText();
	metadata.save(Constants.OutputDoc);
}
```

## Updating document statistics

The document statistics described in [this section]({{< ref "metadata/java/developer-guide/advanced-usage/managing-metadata-for-specific-formats/documents/working-with-metadata-in-word-processing-documents.md" >}}) are not only calculated for WordProcessing documents, they can also be saved in the native metadata package with regular metadata properties. The following code sample demonstrates how to achieve this.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.word\_processing.<WBR>WordProcessingUpdateDocumentStatistics**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDoc)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();

	root.updateDocumentStatistics();

	metadata.save(Constants.OutputDoc);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in WordProcessing documents

Path: /metadata/net/working-with-metadata-in-wordprocessing-documents/

GroupDocs.Metadata for .NET provides functionality that allows working with different kinds of WordProcessing documents such as DOC, DOCX, ODT, etc. For the full list of supported document formats please refer to [Supported Document Formats]({{< ref "metadata/net/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a document

The following sample of code will help you to detect the exact type of a loaded document and extract some additional file format information.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a WordProcessing document
2.  Extract the root metadata package
3.  Use the [FileType](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/wordprocessingrootpackage/properties/filetype) property to obtain file format information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingReadFileFormatProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDoc))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	Console.WriteLine(root.FileType.FileFormat);
	Console.WriteLine(root.FileType.WordProcessingFormat);
	Console.WriteLine(root.FileType.MimeType);
	Console.WriteLine(root.FileType.Extension);
}
```

## Reading built-in metadata properties

To access built-in metadata of a WordProcessing document, please use the [DocumentProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1/properties/documentproperties) property defined in the [DocumentRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingReadBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	Console.WriteLine(root.DocumentProperties.Author);
	Console.WriteLine(root.DocumentProperties.CreatedTime);
	Console.WriteLine(root.DocumentProperties.Company);
	Console.WriteLine(root.DocumentProperties.Category);
	Console.WriteLine(root.DocumentProperties.Keywords);

	// ... 
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a WordProcessing document please follow the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingReadCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDoc))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();
	var customProperties = root.DocumentProperties.FindProperties(p => !p.Tags.Contains(Tags.Document.BuiltIn));

	foreach (var property in customProperties)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [FindProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/metadatapackage/methods/findproperties) method for a certain metadata package (instance of the [WordProcessingPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/wordprocessingpackage) class), the search result will contain only metadata properties that are specific for WordProcessing documents. 

## Inspecting WordProcessing documents

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about digital signatures associated with a document, extract user comments from the document content, obtain pieces of hidden text, work with document revisions, etc. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a WordProcessing document
2.  Extract the root metadata package
3.  Use the [InspectionPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/wordprocessingrootpackage/properties/inspectionpackage) property to inspect the document

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingReadInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();
	if (root.InspectionPackage.Comments != null)
	{
		foreach (var comment in root.InspectionPackage.Comments)
		{
			Console.WriteLine(comment.Author);
			Console.WriteLine(comment.CreatedDate);
			Console.WriteLine(comment.Text);
			// ... 
		}
	}

	if (root.InspectionPackage.DigitalSignatures != null)
	{
		foreach (var signature in root.InspectionPackage.DigitalSignatures)
		{
			Console.WriteLine(signature.CertificateSubject);
			Console.WriteLine(signature.Comments);
			Console.WriteLine(signature.SignTime);
			// ...
		}
	}

	if (root.InspectionPackage.Fields != null)
	{
		foreach (var field in root.InspectionPackage.Fields)
		{
			Console.WriteLine(field.Code);
			Console.WriteLine(field.Result);
		}
	}

	if (root.InspectionPackage.HiddenText != null)
	{
		foreach (var textFragment in root.InspectionPackage.HiddenText)
		{
			Console.WriteLine(textFragment);
		}
	}

	if (root.InspectionPackage.Revisions != null)
	{
		foreach (var revision in root.InspectionPackage.Revisions)
		{
			Console.WriteLine(revision.Author);
			Console.WriteLine(revision.DateTime);
			Console.WriteLine(revision.RevisionType);
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a WordProcessing document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingReadDocumentStatistics**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	Console.WriteLine(root.DocumentStatistics.CharacterCount);
	Console.WriteLine(root.DocumentStatistics.PageCount);
	Console.WriteLine(root.DocumentStatistics.WordCount);
}
```

## Reading dublin core metadata

Dublin Core metadata is a set of certain metadata properties that are intended to describe various digital resources. Please find more information on the Dublin Core standard at [https://en.wikipedia.org/wiki/Dublin\_Core](https://en.wikipedia.org/wiki/Dublin_Core). The code sample below shows how to extract Dublin Core metadata from a WordProcessing document using the GroupDocs.Metadata API.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingReadDublinCoreProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	if (root.DublinCorePackage != null)
	{
		Console.WriteLine(root.DublinCorePackage.Format);
		Console.WriteLine(root.DublinCorePackage.Contributor);
		Console.WriteLine(root.DublinCorePackage.Coverage);
		Console.WriteLine(root.DublinCorePackage.Creator);
		Console.WriteLine(root.DublinCorePackage.Source);
		Console.WriteLine(root.DublinCorePackage.Description);

		// ...
	}
}
```

Please see the the [DublinCorePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.dublincore/dublincorepackage) class to get more information on supported Dublin Core metadata properties.

## Updating built-in metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a WordProcessing document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingUpdateBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDoc))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	root.DocumentProperties.Author = "test author";
	root.DocumentProperties.CreatedTime = DateTime.Now;
	root.DocumentProperties.Company = "GroupDocs";
	root.DocumentProperties.Category = "test category";
	root.DocumentProperties.Keywords = "metadata, built-in, update";

	// ... 

	metadata.Save(Constants.OutputDoc);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a WordProcessing document. Please check the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingUpdateCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	root.DocumentProperties.Set("customProperty1", "some value");
	root.DocumentProperties.Set("customProperty2", 7);

	metadata.Save(Constants.OutputDocx);
}
```

## Updating inspection properties

When you inspect a document GroupDocs.Metadata for .NET forms a metadata package containing the extracted information. The package class also provides some basic methods that allow updating (or removing) the extracted properties. The following code sample demonstrates how to remove/update the inspection properties in a WordProcessing document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingUpdateInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDoc))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	root.InspectionPackage.ClearComments();
	root.InspectionPackage.AcceptAllRevisions();
	root.InspectionPackage.ClearFields();
	root.InspectionPackage.ClearHiddenText();

	metadata.Save(Constants.OutputDoc);
}
```

## Updating document statistics

The document statistics described in [this section]({{< ref "metadata/net/developer-guide/advanced-usage/managing-metadata-for-specific-formats/documents/working-with-metadata-in-wordprocessing-documents.md" >}}) are not only calculated for WordProcessing documents, they can also be saved in the native metadata package with regular metadata properties. The following code sample demonstrates how to achieve this.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.WordProcessing.<WBR>WordProcessingUpdateDocumentStatistics**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDoc))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();

	root.UpdateDocumentStatistics();

	metadata.Save(Constants.OutputDoc);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with slide backgrounds

Path: /watermark/java/working-with-slide-backgrounds/

## Extracting information about all slide backgrounds

The API allows you to extract information about all the slide backgrounds in a PowerPoint document as shown in the following code sample using method [getBackgroundImage()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PresentationImageFillFormat#getBackgroundImage()) of [PresentationSlide](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PresentationSlide).[getImageFillFormat()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PresentationBaseSlide#getImageFillFormat()).

**advanced\_usage.add\_watermarks\_to\_presentations.PresentationGetSlideBackgroundsInformation**

```java
PresentationLoadOptions loadOptions = new PresentationLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\presentation.pptx"
Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions);                              
                                                                                                                   
PresentationContent content = watermarker.getContent(PresentationContent.class);                                   
for (PresentationSlide slide : content.getSlides())                                                                
{                                                                                                                  
    if (slide.getImageFillFormat().getBackgroundImage() != null)                                                   
    {                                                                                                              
        System.out.println(slide.getImageFillFormat().getBackgroundImage().getWidth());                            
        System.out.println(slide.getImageFillFormat().getBackgroundImage().getHeight());                           
        System.out.println(slide.getImageFillFormat().getBackgroundImage().getBytes().length);                     
    }                                                                                                              
}                                                                                                                  
                                                                                                                   
watermarker.close();                                                                                               
```

## Removing a particular background

Following code sample shows how to remove the background image of a particular slide calling the method [setBackgroundImage()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PresentationImageFillFormat#setBackgroundImage(com.groupdocs.watermark.contents.PresentationWatermarkableImage)) with null.

**advanced\_usage.add\_watermarks\_to\_presentations.PresentationRemoveSlideBackground**

```java
PresentationLoadOptions loadOptions = new PresentationLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\presentation.pptx"
Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions);                              
                                                                                                                   
PresentationContent content = watermarker.getContent(PresentationContent.class);                                   
content.getSlides().get_Item(0).getImageFillFormat().setBackgroundImage(null);                                     
                                                                                                                   
watermarker.save("presentation.pptx");                                                                   
                                                                                                                   
watermarker.close();                                                                                               
```

## Adding watermark to all background Images

Using GroupDocs.Watermark, you can also [add](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WatermarkableImage#add(com.groupdocs.watermark.Watermark)) watermark to the background images that belong to a PowerPoint document as shown in the following code sample.

**advanced\_usage.add\_watermarks\_to\_presentations.PresentationAddWatermarkToSlideBackgroundImages**

```java
PresentationLoadOptions loadOptions = new PresentationLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\presentation.pptx"
Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions);                              
                                                                                                                   
// Initialize image or text watermark                                                                              
TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));                              
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                                      
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                          
watermark.setRotateAngle(45);                                                                                      
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                                       
watermark.setScaleFactor(1);                                                                                       
                                                                                                                   
PresentationContent content = watermarker.getContent(PresentationContent.class);                                   
for (PresentationSlide slide : content.getSlides())                                                                
{                                                                                                                  
    if (slide.getImageFillFormat().getBackgroundImage() != null)                                                   
    {                                                                                                              
        // Add watermark to the image                                                                              
        slide.getImageFillFormat().getBackgroundImage().add(watermark);                                            
    }                                                                                                              
}                                                                                                                  
                                                                                                                   
watermarker.save("presentation.pptx");                                                                   
                                                                                                                   
watermarker.close();                                                                                               
```

## Additional settings for slide background image

GroupDocs.Watermark for Java also provides the feature that allows you to [tile](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PresentationImageFillFormat#setTileAsTexture(boolean)) the picture across slide's background. You can also make the image [semi-transparent](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PresentationImageFillFormat#setTransparency(double)). Following code sample serves this purpose.

**advanced\_usage.add\_watermarks\_to\_presentations.PresentationSetTiledSemitransparentBackground**

```java
PresentationLoadOptions loadOptions = new PresentationLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\presentation.pptx"
Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions);                              
                                                                                                                   
PresentationContent content = watermarker.getContent(PresentationContent.class);                                   
PresentationSlide slide = content.getSlides().get_Item(0);                                                         
                                                                                                                   
File imageFile = new File("background.png");                                                                
byte[] imageBytes = new byte[(int) imageFile.length()];                                                            
InputStream imageInputStream = new FileInputStream(imageFile);                                                     
imageInputStream.read(imageBytes);                                                                                 
imageInputStream.close();                                                                                           
                                                                                                                   
slide.getImageFillFormat().setBackgroundImage(new PresentationWatermarkableImage(imageBytes));                     
slide.getImageFillFormat().setTileAsTexture(true);                                                                 
slide.getImageFillFormat().setTransparency(0.5);                                                                   
                                                                                                                   
watermarker.save("presentation.pptx");                                                                   
                                                                                                                   
watermarker.close();                                                                                               
```

## Settings background image for charts

GroupDocs.Watermark for Java also allows you to set the background image for a chart inside PowerPoint document using [getCharts()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PresentationBaseSlide#getCharts()) method. You can use following code sample to achieve this functionality.

**advanced\_usage.add\_watermarks\_to\_presentations.PresentationSetBackgroundImageForChart**

```java
PresentationLoadOptions loadOptions = new PresentationLoadOptions();                                                                             
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\presentation.pptx"                              
Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions);                                                            
                                                                                                                                                 
PresentationContent content = watermarker.getContent(PresentationContent.class);                                                                 
                                                                                                                                                 
File imageFile = new File("test.png");                                                                                                    
byte[] imageBytes = new byte[(int) imageFile.length()];                                                                                          
InputStream imageInputStream = new FileInputStream(imageFile);                                                                                   
imageInputStream.read(imageBytes);                                                                                                               
imageInputStream.close();                                                                                                                         
                                                                                                                                                 
                                                                                                                                                 
content.getSlides().get_Item(0).getCharts().get_Item(0).getImageFillFormat().setBackgroundImage(new PresentationWatermarkableImage(imageBytes)); 
content.getSlides().get_Item(0).getCharts().get_Item(0).getImageFillFormat().setTransparency(0.5);                                               
content.getSlides().get_Item(0).getCharts().get_Item(0).getImageFillFormat().setTileAsTexture(true);                                             
                                                                                                                                                 
watermarker.save("presentation.pptx");                                                                                                 
                                                                                                                                                 
watermarker.close();                                                                                                                             
```

---

## Working with slide backgrounds

Path: /watermark/net/working-with-slide-backgrounds/


The API allows you to extract information about all the slide backgrounds, Removing a particular background and Adding watermark to all background images

## Extracting information about all slide backgrounds

The API allows you to extract information about all the slide backgrounds in a PowerPoint document as shown in the following code sample using property [BackgroundImage](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.presentation/presentationimagefillformat/properties/backgroundimage) of [PresentationSlide.ImageFillFormat](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.presentation/presentationbaseslide/properties/imagefillformat).

**AdvancedUsage.AddingWatermarks.AddWatermarksToPresentations.PresentationGetSlideBackgroundsInformation**

```csharp
PresentationLoadOptions loadOptions = new PresentationLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\presentation.pptx"
using (Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions))
{
    PresentationContent content = watermarker.GetContent<PresentationContent>();
    foreach (PresentationSlide slide in content.Slides)
    {
        if (slide.ImageFillFormat.BackgroundImage != null)
        {
            Console.WriteLine(slide.ImageFillFormat.BackgroundImage.Width);
            Console.WriteLine(slide.ImageFillFormat.BackgroundImage.Height);
            Console.WriteLine(slide.ImageFillFormat.BackgroundImage.GetBytes().Length);
        }
    }
}
```

## Removing a particular background

Following code sample shows how to remove the background image of a particular slide setting the property [BackgroundImage](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.presentation/presentationimagefillformat/properties/backgroundimage) to null.

**AdvancedUsage.AddingWatermarks.<WBR>AddWatermarksToPresentations.<WBR>PresentationRemoveSlideBackground**

```csharp
PresentationLoadOptions loadOptions = new PresentationLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\presentation.pptx"
using (Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions))
{
    PresentationContent content = watermarker.GetContent<PresentationContent>();
    content.Slides[0].ImageFillFormat.BackgroundImage = null;

    watermarker.Save("presentation.pptx");
}
```

## Adding watermark to all background images

Using GroupDocs.Watermark, you can also [add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.image/watermarkableimage/methods/add) watermark to the background images that belong to a PowerPoint document as shown in the following code sample.

**AdvancedUsage.AddingWatermarks.<WBR>AddWatermarksToPresentations.<WBR>PresentationAddWatermarkToSlideBackgroundImages**

```csharp
PresentationLoadOptions loadOptions = new PresentationLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\presentation.pptx"
using (Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions))
{
    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;

    PresentationContent content = watermarker.GetContent<PresentationContent>();
    foreach (PresentationSlide slide in content.Slides)
    {
        if (slide.ImageFillFormat.BackgroundImage != null)
        {
            // Add watermark to the image
            slide.ImageFillFormat.BackgroundImage.Add(watermark);
        }
    }

    watermarker.Save("presentation.pptx");
}
```

## Additional settings for slide background image

GroupDocs.Watermark for .NET also provides the feature that allows you to [tile](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.presentation/presentationimagefillformat/properties/tileastexture) the picture across slide's background. You can also make the image [semi-transparent](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.presentation/presentationimagefillformat/properties/transparency). Following code sample serves this purpose.

**AdvancedUsage.AddingWatermarks.<WBR>AddWatermarksToPresentations.<WBR>PresentationSetTiledSemitransparentBackground**

```csharp
PresentationLoadOptions loadOptions = new PresentationLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\presentation.pptx"
using (Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions))
{
    PresentationContent content = watermarker.GetContent<PresentationContent>();
    PresentationSlide slide = content.Slides[0];
    slide.ImageFillFormat.BackgroundImage = 
        new PresentationWatermarkableImage(File.ReadAllBytes("background.png"));
    slide.ImageFillFormat.TileAsTexture = true;
    slide.ImageFillFormat.Transparency = 0.5;

    watermarker.Save("presentation.pptx");
}
```

## Settings background image for charts

GroupDocs.Watermark for .NET also allows you to set the background image for a chart inside PowerPoint document using [Charts](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.presentation/presentationbaseslide/properties/charts) property. You can use following code sample to achieve this functionality.

**AdvancedUsage.AddingWatermarks.<WBR>AddWatermarksToPresentations.<WBR>PresentationSetBackgroundImageForChart**

```csharp
PresentationLoadOptions loadOptions = new PresentationLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\presentation.pptx"
using (Watermarker watermarker = new Watermarker("presentation.pptx", loadOptions))
{
    PresentationContent content = watermarker.GetContent<PresentationContent>();
    content.Slides[0].Charts[0].ImageFillFormat.BackgroundImage = 
        new PresentationWatermarkableImage(File.ReadAllBytes("test.png"));
    content.Slides[0].Charts[0].ImageFillFormat.Transparency = 0.5;
    content.Slides[0].Charts[0].ImageFillFormat.TileAsTexture = true;

    watermarker.Save("presentation.pptx");
}
```


---

## Working with slide backgrounds

Path: /watermark/python-net/working-with-slide-backgrounds/


The API allows you to extract information about all slide backgrounds, remove a particular background, and add watermark to all background images.

## Extracting information about all slide backgrounds
This sample iterates slides and prints size and byte-length details for each background image.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.presentation as gwc_ppt

load_options = gw.PresentationLoadOptions()
with gw.Watermarker("presentation.pptx", load_options) as watermarker:
    content = watermarker.get_content(gwc_ppt.PresentationContent)
    for slide in content.slides:
        if slide.image_fill_format.background_image is not None:
            print(slide.image_fill_format.background_image.width)
            print(slide.image_fill_format.background_image.height)
            print(len(slide.image_fill_format.background_image.get_bytes()))
```

## Removing a particular background
This sample clears the background image for a specific slide and saves the updated presentation.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.presentation as gwc_ppt

load_options = gw.PresentationLoadOptions()
with gw.Watermarker("presentation.pptx", load_options) as watermarker:
    content = watermarker.get_content(gwc_ppt.PresentationContent)
    content.slides[0].image_fill_format.background_image = None
    watermarker.save("presentation.pptx")
```

## Adding watermark to all background images
This sample applies a centered, rotated text watermark to every slide background image in the deck.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.presentation as gwc_ppt
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.PresentationLoadOptions()
with gw.Watermarker("presentation.pptx", load_options) as watermarker:
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    content = watermarker.get_content(gwc_ppt.PresentationContent)
    for slide in content.slides:
        if slide.image_fill_format.background_image is not None:
            slide.image_fill_format.background_image.add(watermark)

    watermarker.save("presentation.pptx")
```

## Additional settings for slide background image
This sample sets a custom background image and adjusts tiling and transparency options for a specific slide.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.presentation as gwc_ppt

load_options = gw.PresentationLoadOptions()
with gw.Watermarker("presentation.pptx", load_options) as watermarker:
    content = watermarker.get_content(gwc_ppt.PresentationContent)
    slide = content.slides[0]
    with open("background.png", "rb") as f:
        slide.image_fill_format.background_image = gwc_ppt.PresentationWatermarkableImage(f.read())
    slide.image_fill_format.tile_as_texture = True
    slide.image_fill_format.transparency = 0.5
    watermarker.save("presentation.pptx")
```

## Settings background image for charts
This sample assigns a background image to a chart and configures its transparency and tiling behavior.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.presentation as gwc_ppt

load_options = gw.PresentationLoadOptions()
with gw.Watermarker("presentation.pptx", load_options) as watermarker:
    content = watermarker.get_content(gwc_ppt.PresentationContent)
    with open("test.png", "rb") as f:
        content.slides[0].charts[0].image_fill_format.background_image = \
            gwc_ppt.PresentationWatermarkableImage(f.read())
    content.slides[0].charts[0].image_fill_format.transparency = 0.5
    content.slides[0].charts[0].image_fill_format.tile_as_texture = True
    watermarker.save("presentation.pptx")
```



---

## Working with Word Processing Documents

Path: /assembly/java/working-with-word-processing-documents/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}

## Working with Word Processing Documents

GroupDocs.Assembly allows you to use data bands in table rows in **Word Processing Documents**. A table-row data band is a data band whose body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in word processing document is as follows:

| **Client**                               | **Manager**         | **Contract Price**                           |
| ---------------------------------------- | ------------------- | -------------------------------------------- |
| **<<foreach [c in ds]>> <<[c.Client]>>** | **<<[c.Manager]>>** | **<<[c.Contact_Price]>> &lt;&lt;/foreach>>** |

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block whose body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

<table class="confluenceTable"><tbody><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;if ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;elseif ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;else&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>... &lt;&lt;/if&gt;&gt;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p><div><strong><br></strong></div></td></tr></tbody></table>
{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}
### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Working%20With%20Table%20Row%20Data%20Bands.docx)

### The Code

{{< gist GroupDocsGists 0e730b80b6d31a54dde848eb4d6ad9cd >}}



---

## Working with Word Processing Documents

Path: /assembly/net/working-with-word-processing-documents/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Working with Word Processing Documents

GroupDocs.Assembly allows you to use data bands in table rows in **Word Processing Documents**. A table-row data band is a data band which body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in word processing document is as follows:

<table class="gd-assembly">
	<tbody>
		<tr>
			<td>Manager</td>
			<td>Manager</td>
			<td>Contract Price</td>
		</tr>
		<tr>
			<td>&lt;&lt;foreach [c in ds]>>&lt;&lt;[c.Client]>></td>
			<td>&lt;&lt;[c.Manager]>></td>
			<td>&lt;&lt;[c.Price]>>&lt;&lt;/foreach>></td>
		</tr>
	</tbody>
</table>

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block which body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

|                        |         |                 |
| ---------------------- | ------- | --------------- |
| **&lt;&lt;if ...>> ...**     | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;elseif ...>> ...** | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;else>> ...**       | **...** | **...**         |
| **...**                | **...** | **...**         |
| **...**                | **...** | **... &lt;&lt;/if>>** |
|                        |         |                 |

### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Working%20With%20Table%20Row%20Data%20Bands.docx)

### The Code

{{< gist GroupDocsGists 27da0b61c198e330a28eb8f5aea5e56b >}}



---

## Working with worksheet backgrounds

Path: /watermark/java/working-with-worksheet-backgrounds/

## Extracting information about all worksheet backgrounds in an Excel document

The API allows you to extract [information](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetWorksheet#getBackgroundImage()) about all the worksheet backgrounds in an Excel document as shown in the following code sample.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetGetInformationOfWorksheetBackgrounds**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                   
{                                                                                                                
    if (worksheet.getBackgroundImage() != null)                                                                  
    {                                                                                                            
        System.out.println(worksheet.getBackgroundImage().getWidth());                                           
        System.out.println(worksheet.getBackgroundImage().getHeight());                                          
        System.out.println(worksheet.getBackgroundImage().getBytes().length);                                    
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.close();                                                                                             
```

## Removing a particular background

Following code sample can be used to remove the [background](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetWorksheet#getBackgroundImage()) of a particular worksheet.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetRemoveWorksheetBackground**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
content.getWorksheets().get_Item(0).setBackgroundImage(null);                                                    
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Adding watermark to all backgrounds in an Excel worksheet

You can [add](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WatermarkableImage#add(com.groupdocs.watermark.Watermark)) watermark to the background images that belong to an Excel document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetAddWatermarkToBackgroundImages**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
// Initialize image or text watermark                                                                            
TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));                            
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                                    
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                        
watermark.setRotateAngle(45);                                                                                    
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                                     
watermark.setScaleFactor(1);                                                                                     
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                   
{                                                                                                                
    if (worksheet.getBackgroundImage() != null)                                                                  
    {                                                                                                            
        // Add watermark to the image                                                                            
        worksheet.getBackgroundImage().add(watermark);                                                           
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Settings background image for charts

GroupDocs.Watermark for Java also allows you to set the [background image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetChart#getImageFillFormat()) for a chart inside an Excel document. Following code sample shows how to achieve this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetSetBackgroundImageForChart**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                                                                 
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"                                  
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                                                               
                                                                                                                                                   
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                                                     
                                                                                                                                                   
File imageFile = new File("test.png");                                                                                                      
byte[] imageBytes = new byte[(int) imageFile.length()];                                                                                            
InputStream imageInputStream = new FileInputStream(imageFile);                                                                                     
imageInputStream.read(imageBytes);                                                                                                                 
imageInputStream.close();                                                                                                                          
                                                                                                                                                   
content.getWorksheets().get_Item(0).getCharts().get_Item(0).getImageFillFormat().setBackgroundImage(new SpreadsheetWatermarkableImage(imageBytes));
content.getWorksheets().get_Item(0).getCharts().get_Item(0).getImageFillFormat().setTransparency(0.5);                                             
content.getWorksheets().get_Item(0).getCharts().get_Item(0).getImageFillFormat().setTileAsTexture(true);                                           
                                                                                                                                                   
watermarker.save("spreadsheet.xlsx");                                                                                                    
                                                                                                                                                   
watermarker.close();                                                                                                                               
```

---

## Working with ZIP archives

Path: /metadata/java/working-with-zip-archives/

## Get ZIP format metadata

The API allows detecting ZIP archives and reading format metadata. The following steps are needed to be followed:

*   [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a ZIP archive
*   Get the root metadata package
*   Extract  the native metadata package using the [ZipRootPackage.getZipPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ZipRootPackage#getZipPackage()) method
*   Read the ZIP archive properties
*   Loop through [ZipPackage.getFiles](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ZipPackage#getFiles()) to extract information about the archived files 

The following code snippet shows how to get metadata from a ZIP archive.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>archive.ZipReadNativeMetadataProperties**

```csharp
Charset charset = Charset.forName("cp866");

try (Metadata metadata = new Metadata(Constants.InputZip)) {
    ZipRootPackage root = metadata.getRootPackageGeneric();

    System.out.println(root.getZipPackage().getComment());
    System.out.println(root.getZipPackage().getTotalEntries());

    for (ZipFile file : root.getZipPackage().getFiles()) {
        System.out.println(file.getName());
        System.out.println(file.getCompressedSize());
        System.out.println(file.getCompressionMethod());
        System.out.println(file.getFlags());
        System.out.println(file.getModificationDateTime());
        System.out.println(file.getUncompressedSize());

        // Use a specific encoding for the file names
        System.out.println(new String(file.getRawName(), charset));
    }
}
```

## Updating the user comment

GroupDocs.Metadata for Java allows you to update the user comment in a ZIP archive. The following steps are needed to be followed:

*   [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a ZIP archive
*   Get the root metadata package
*   Update the comment using the [ZipPackage.setComment](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ZipPackage#setComment(java.lang.String)) method
*   Save the changes

The following code snippet demonstrates the usage of this feature.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>archive.ZipUpdateArchiveComment**

```csharp
try (Metadata metadata = new Metadata(Constants.InputZip)) {
	ZipRootPackage root = metadata.getRootPackageGeneric();

	root.getZipPackage().setComment("updated comment");

	metadata.save(Constants.OutputZip);
}
```

## Removing the user comment

GroupDocs.Metadata for Java allows you to remove the user comment associated with a ZIP archive. The following code snippet demonstrates the usage of this feature.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>archive.ZipRemoveArchiveComment**

```csharp
try (Metadata metadata = new Metadata(Constants.InputZip)) {
	ZipRootPackage root = metadata.getRootPackageGeneric();

	root.getZipPackage().setComment(null);

	metadata.save(Constants.OutputZip);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with ZIP archives

Path: /metadata/net/working-with-zip-archives/

## Get ZIP format metadata

The API allows detecting ZIP archives and reading format metadata. The following steps are needed to be followed:

*   [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a ZIP archive
*   Get the root metadata package
*   Extract  the native metadata package using [ZipRootPackage.ZipPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.archive/ziprootpackage/properties/zippackage)
*   Read the ZIP archive properties
*   Loop through [ZipPackage.Files](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.archive/zippackage/properties/files) to extract information about archived files 

The following code snippet shows how to get metadata from a ZIP archive.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Archive.ZipReadNativeMetadataProperties**

```csharp
Encoding encoding = Encoding.GetEncoding(866);
using (Metadata metadata = new Metadata(Constants.InputZip))
{
	var root = metadata.GetRootPackage<ZipRootPackage>();

	Console.WriteLine(root.ZipPackage.Comment);
	Console.WriteLine(root.ZipPackage.TotalEntries);

	foreach (var file in root.ZipPackage.Files)
	{
		Console.WriteLine(file.Name);
		Console.WriteLine(file.CompressedSize);
		Console.WriteLine(file.CompressionMethod);
		Console.WriteLine(file.Flags);
		Console.WriteLine(file.ModificationDateTime);
		Console.WriteLine(file.UncompressedSize);

		// Use a specific encoding for the file names
		Console.WriteLine(encoding.GetString(file.RawName));
	}
}
```

## Updating the user comment

GroupDocs.Metadata for .NET allows you to update the user comment in a ZIP archive. The following steps are needed to be followed:

*   [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a ZIP archive
*   Get the root metadata package
*   Update the comment using the [ZipPackage.Comment](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.archive/zippackage/properties/comment) setter
*   Save the changes

The following code snippet demonstrates the usage of this feature.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Archive.ZipUpdateArchiveComment**

```csharp
using (Metadata metadata = new Metadata(Constants.InputZip))
{
	var root = metadata.GetRootPackage<ZipRootPackage>();
	root.ZipPackage.Comment = "updated comment";

	metadata.Save(Constants.OutputZip);
}
```

## Removing the user comment

GroupDocs.Metadata for .NET allows you to remove the user comment associated with a ZIP archive. The following code snippet demonstrates the usage of this feature.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Archive.ZipRemoveArchiveComment**

```csharp
using (Metadata metadata = new Metadata(Constants.InputZip))
{
	var root = metadata.GetRootPackage<ZipRootPackage>();
	root.ZipPackage.Comment = null;

	metadata.Save(Constants.OutputZip);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Features Overview

Path: /signature/python-net/features-overview/

## Electronic signature

**Electronic Signature** is an abstract concept that means data in electronic form associated with a certain document and expressing the consent of the signatory with the information contained in the document.
GroupDocs.Signature provides various electronic signature implementations as follows:

* Native text signatures as text stamps, text labels, annotation, stickers, watermarks with big amount of settings for visualization effects, opacity, colors, fonts, etc.;
* Text as image signatures with big scope of additional options to specify how text will look, colors, and extra image effects;
* Image signatures with options to specify extra image effects, rotation etc.;
* Digital signatures based on digital certificate files and ability to support digital signature by document type (PDF, Microsoft Word documents and Microsoft Excel spreadsheets);
* Barcode/QR-code signatures with variety of options;
* Generated stamp looking image signatures based on predefined lines with custom text, colors, width, etc;
* Metadata signatures to keep hidden signatures inside the document;
* Form-field signatures.

Signing documents in Python with our electronic signature (eSign) API is easy, reliable and secure. Here's a simple example of how to add a text signature:

```python
import groupdocs.signature as signature

# Initialize signature handler
signature_handler = signature.Signature("sample.pdf")

# Create text signature options
text_options = signature.TextSignOptions("John Smith")
text_options.set_left(100)
text_options.set_top(100)

# Sign document with text signature
signature_handler.sign("output.pdf", text_options)
```

## Search for signatures

Obtain signatures list applied to document:

* Text signatures information from all supported formats;
* Image signatures information;
* Digital signatures information from PDF, Microsoft Word documents and Microsoft Excel spreadsheets;
* Barcode/QR-code signatures information from all supported formats;
* Metadata signatures information from all supported formats;
* Form-field signatures information from all supported formats.

Example of searching for signatures:

```python
import groupdocs.signature as signature

# Initialize signature handler
signature_handler = signature.Signature("signed.pdf")

# Search for text signatures
text_signatures = signature_handler.search(signature.TextSearchOptions())
for text_signature in text_signatures:
    print(f"Found text signature: {text_signature.text}")
```

## Verify signatures

Determine whether document contains signatures that meet the specified criteria.
Supported signature types are:

* Text signatures;
* Digital signatures;
* Barcode/QR-code signatures;
* Metadata signatures;
* Form-field signatures.

Example of verifying signatures:

```python
import groupdocs.signature as signature

# Initialize signature handler
signature_handler = signature.Signature("signed.pdf")

# Verify digital signatures
verify_options = signature.DigitalVerifyOptions("certificate.pfx", "password")
verify_result = signature_handler.verify(verify_options)
print(f"Verification result: {verify_result.is_valid}")
```

## Document information extraction

GroupDocs.Signature allows to obtain basic information about source document - file type, size, pages count, page height and width etc.  
This may be quite useful for generating document preview and precise signature placing inside document.

Example of getting document information:

```python
import groupdocs.signature as signature

# Initialize signature handler
signature_handler = signature.Signature("sample.pdf")

# Get document info
document_info = signature_handler.get_document_info()
print(f"Pages count: {document_info.page_count}")
print(f"File size: {document_info.file_size} bytes")
```

## Preview document pages

Document preview feature allows to generate image representations of document pages. This may be helpful for better understanding about document content and its structure,  
set proper signature position inside document, apply appropriate signature styling etc. Preview can be generated for all document pages (by default) or for specific page numbers or page range.

Supported image formats for document preview are:

* PNG;
* JPG;
* BMP.

Example of generating document preview:

```python
import groupdocs.signature as signature

# Initialize signature handler
signature_handler = signature.Signature("sample.pdf")

# Create preview options
preview_options = signature.PreviewOptions(lambda page_number: f"preview_{page_number}.png")
preview_options.set_page_numbers([1, 2])  # Generate preview for pages 1 and 2

# Generate preview
signature_handler.generate_preview(preview_options)
```

---

## Verify Barcode signatures in the document

Path: /signature/java/verify-barcode-signatures-in-the-document/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [BarcodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/BarcodeVerifyOptions) class to specify different options for verification of Barcode signatures.

Here are the steps to verify Barcode signature within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate the [BarcodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/BarcodeVerifyOptions) object according to your requirements and specify verification options  
    
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [BarcodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/BarcodeVerifyOptions) to it.
    

  

  
This example shows how to verify Barcode signature in the document.

```java
Signature signature = new Signature("sample.pdf");
BarcodeVerifyOptions options = new BarcodeVerifyOptions();
options.setAllPages(true); // this value is set by default
options.setText("John");
options.setMatchType(TextMatchType.Contains);

// verify document signature
VerificationResult result = signature.verify(options);
if (result.isValid())
{
    System.out.print("\nDocument was verified successfully!");
}
else
{
    System.out.print("\nDocument failed verification process.");
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verify Barcode signatures in the document

Path: /signature/net/verify-barcode-signatures-in-the-document/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [BarcodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodeverifyoptions) class to specify different options for verification of Barcode signatures.

Here are the steps to verify Barcode signature within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [BarcodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodeverifyoptions) object according to your requirements and specify verification options
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [BarcodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodeverifyoptions) to it.
  
This example shows how to verify Barcode signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    BarcodeVerifyOptions options = new BarcodeVerifyOptions()
    {
        AllPages = true, // this value is set by default
        Text = "John",
        MatchType = TextMatchType.Contains
        // set encode type
        // if this value is not set any barcode type will be valid
        EncodeType = BarcodeTypes.Code128
    };

    // verify document signatures
    VerificationResult result = signature.Verify(options);
    if (result.IsValid)
    {
        Console.WriteLine("\nDocument was verified successfully!");
    }
    else
    {
        Console.WriteLine("\nDocument failed verification process.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify Barcode signatures in the document

Path: /signature/nodejs-java/verify-barcode-signatures-in-the-document/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [BarcodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/barcodeverifyoptions) class to specify different options for verifying Barcode signatures.

Here are the steps to verify a Barcode signature within the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [BarcodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/barcodeverifyoptions) object according to your requirements and specify the verification options.
* Call the [Verify](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/verify) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [BarcodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/barcodeverifyoptions) to it.

This example shows how to verify Barcode signature in the document.

```csharp
 // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 
  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize BarcodeVerifyOptions
  const options = new signatureLib.BarcodeVerifyOptions();
  options.setAllPages(true); // This value is set by default
  options.setText('John');
  options.setMatchType(signatureLib.TextMatchType.Contains);

  // Verify document signatures
  const result = signature.verify(options);

  if (result.isValid()) {
    console.log('\nDocument was verified successfully!');
  } else {
    console.log('\nDocument failed the verification process.');
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Load document from Azure Blob Storage

Path: /signature/java/load-document-from-azure-blob-storage/

Following example demonstrates how to process documents from Azure Blob Storage.

```java
public static void run() throws Exception
{
    String key = "sample.docx";
    String outputFilePath = new File(Constants.OutputPath, "SignFromStream//signedSample.docx").getPath();
    try {
        ByteArrayOutputStream stream = downloadFile(key);
 
        Signature signature = new Signature(new ByteArrayInputStream(stream.toByteArray()));
 
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
        options.setEncodeType(QrCodeTypes.QR);
        options.setLeft(100);
        options.setTop(100);
 
 
        // sign document to file
        signature.sign(outputFilePath, options);
 
        System.out.print("\nSource document signed successfully.\nFile saved at " + outputFilePath);
    }catch(Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
public static final String STORAGE_CONNECTION_STRING
        = "DefaultEndpointsProtocol=https;"
        + "AccountName=Ram;" //Your account name.
        + "AccountKey=key"; //your account key.
 
public static ByteArrayOutputStream downloadFile(String blobName) throws Exception
{
    CloudBlobContainer container = getContainer();
 
    CloudBlob blob = container.getBlockBlobReference(blobName);
    ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();
    blob.download(memoryStream);
    //memoryStream.Position = 0;
    return memoryStream;
}
 
private static CloudBlobContainer getContainer() throws Exception
{
    String containerName = "***";
 
    CloudStorageAccount cloudStorageAccount = CloudStorageAccount.parse(STORAGE_CONNECTION_STRING);
    CloudBlobClient cloudBlobClient = cloudStorageAccount.createCloudBlobClient();
    CloudBlobContainer container = cloudBlobClient.getContainerReference(containerName);
    container.createIfNotExists();
 
    return container;
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to load a document from Azure Blob Storage

Path: /signature/net/load-document-from-azure-blob-storage/

Following example demonstrates how to process documents from Azure Blob Storage.

```csharp
public static void Run()
{
    string blobName = "sample.docx";
    string outputFilePath = "SignedSample";
    using (Stream stream = DownloadFile(blobName))
    {
        using (Signature signature = new Signature(stream))
        {
            QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
            {
                EncodeType = QRCodeTypes.QR,
                Left = 100,
                Top = 100
            };
            // sign document to file
            signature.Sign(outputFilePath, options);
        }
    }
    Console.WriteLine("\nSource document signed successfully.\nFile saved at " + outputFilePath);
}

public static Stream DownloadFile(string blobName)
{
    CloudBlobContainer container = GetContainer();

    CloudBlob blob = container.GetBlobReference(blobName);
    MemoryStream memoryStream = new MemoryStream();
    blob.DownloadToStream(memoryStream);
    memoryStream.Position = 0;
    return memoryStream;
}

private static CloudBlobContainer GetContainer()
{
    string accountName = "***";
    string accountKey = "***";
    string endpoint = $"https://{accountName}.blob.core.windows.net/";
    string containerName = "***";

    StorageCredentials storageCredentials = new StorageCredentials(accountName, accountKey);
    CloudStorageAccount cloudStorageAccount = new CloudStorageAccount(
        storageCredentials, new Uri(endpoint), null, null, null);
    CloudBlobClient cloudBlobClient = cloudStorageAccount.CreateCloudBlobClient();

    CloudBlobContainer container = cloudBlobClient.GetContainerReference(containerName);
    container.CreateIfNotExists();

    return container;
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign Document with Digital Signature

Path: /signature/python-net/sign-document-with-digital-signature/


## Introduction

In today's digital age, ensuring the authenticity and integrity of electronic documents is crucial. One highly effective method for achieving this is through the use of digital signatures. In this guide, we will explore the world of digital signatures, explaining what they are, why they are essential, and how you can utilize GroupDocs.Signature for Python via .NET to seamlessly eSign your documents.

## What is a Digital Signature?

A digital signature is a cryptographic mechanism for verifying the authenticity and integrity of electronic documents. It provides strong assurance that the document originated from a known sender and has not been tampered with by unauthorized sources. Digital signatures are typically represented by certificates containing private (for signing) and public (for verification) keys. Various public key cryptography standards, such as PFX format, are commonly used for this purpose.
The picture below shows how a digital signature looks on a PDF document page by default.

![Digital](/signature/python-net/images/esign-document-with-digital-signature.png)

## Why Use Digital Signatures?

- **Enhanced Security:** Digital signatures provide a higher level of document security, making it extremely challenging for unauthorized parties to alter the content.
- **Authentication:** They offer a reliable way to verify the identity of the document sender.
- **Non-repudiation:** Digital signatures prevent senders from denying the authenticity of the signed document.

## How to Sign a Document with a Digital Signature

**[GroupDocs.Signature for Python via .NET](https://products.groupdocs.com/signature/python-net)** supports the creation of digital signatures based on existing PFX certificates. To specify various settings the library provides the [DigitalSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/) class that allows adjusting digital signature properties in the document:

* The [certificate_file_path](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/certificate_file_path/) or [certificate_stream](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/certificate_stream/) properties define the certificate source;
* The [password](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/password/) property specifies the certificate password;
* The [contact](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/contact/), [reason](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/reason/) and [location](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/location/) properties specify additional descriptions;
* The [visible](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/visible/) property specifies whether the signature should be visible on the document page or not;
* The [xades_type](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/xades_type/) property defines whether the e-signature should be of an XML Advanced Electronic Signature type.

### Follow these steps to sign your documents with a digital signature

1. Install the GroupDocs.Signature package using pip:
```bash
pip install groupdocs-signature
```

2. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
3. Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/) object with the required certificate and its password.
4. Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [DigitalSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/) to it.

The example below shows how to sign a PDF document with a digital e-signature using Python. We can sign any other supported document format in the same way.

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import DigitalSignOptions

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create digital signature options
    options = DigitalSignOptions("certificate.pfx")
    
    # Set certificate password
    options.password = "1234567890"
    
    # Optional: setup image file path
    options.image_file_path = "sample.jpg"
    
    # Set signature position
    options.left = 100
    options.top = 100
    
    # Sign document
    sign.sign("sampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-digital-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "sample.jpg" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.jpg](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-digital-signature/sample.jpg)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Digital Signature Options

You can customize the digital signature further with additional options:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import DigitalSignOptions

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create digital signature options
    options = DigitalSignOptions("certificate.pfx")
    
    # Set certificate password
    options.password = "1234567890"
    
    # Set signature appearance
    options.visible = True
    options.image_file_path = "signature.jpg"
    
    # Set signature position and size
    options.left = 100
    options.top = 100
    options.width = 200
    options.height = 100
    
    # Set additional information
    options.contact = "John Smith"
    options.reason = "Approval"
    options.location = "New York"
    
    # Set XAdES type
    options.xades_type = signature.XAdESType.XAdES
    
    # Sign document
    sign.sign("sampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-digital-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "signature.jpg" >}}
{{< tab-text >}}
The following sample file is used in this example: [signature.jpg](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-digital-signature/signature.jpg)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Loading Certificate from Stream

You can also load the certificate from a stream:

{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import DigitalSignOptions

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Load certificate from stream
    with open("certificate.pfx", "rb") as cert_stream:
        # Create digital signature options
        options = DigitalSignOptions(cert_stream)
        
        # Set certificate password
        options.password = "1234567890"
        
        # Set signature position
        options.left = 100
        options.top = 100
        
        # Sign document
        sign.sign("sampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-digital-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide demonstrates how to use [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) to sign documents with digital signatures. It explains how to load documents, configure certificate-based signatures, and save signed files securely. Advanced features, including signature appearance customization and validation, are also covered. Refer to related resources for additional details on digital signing workflows.


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)


### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign PDF with Metadata signature

Path: /signature/python-net/esign-pdf-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [PdfMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/pdfmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) instance.
PDF document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
PDF document metadata contains 3 fields: Name, Value and TagPrefix, combination of Name and Tag prefix should be unique.

PDF document metadata could keep big amount of data that provides ability to keep serialized custom objects with additional encryption in there. 

### Here are the steps to add metadata signatures into PDF document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several [PdfMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/pdfmetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign PDF with Metadata signature

This example shows how to sign PDF document with several e-signatures as metadata.

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import MetadataSignOptions
from groupdocs.signature.domain import PdfMetadataSignature
from datetime import datetime

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create metadata options
    options = MetadataSignOptions()
    
    # Add metadata signatures
    options.add(PdfMetadataSignature("Author", "Mr.Scherlock Holmes"))  # String value
    options.add(PdfMetadataSignature("CreatedOn", datetime.now()))      # DateTime values
    options.add(PdfMetadataSignature("DocumentId", 123456))            # Integer value
    options.add(PdfMetadataSignature("SignatureId", 123.456))          # Double value
    options.add(PdfMetadataSignature("Amount", 123.456))               # Decimal value
    options.add(PdfMetadataSignature("Total", 123.456))                # Float value
    
    # Sign document
    sign.sign("SampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-metadata-signature/esign-pdf-with-metadata-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## How to eSign PDF with standard metadata signatures

This example shows how to sign PDF document with standard embedded PDF document metadata signatures. If PDF metadata signature already exists with same name its value will be overwritten.

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import MetadataSignOptions
from groupdocs.signature.domain import PdfMetadataSignature, PdfMetadataSignatures
from datetime import datetime, timedelta

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create metadata options
    options = MetadataSignOptions()
    
    # Using standard Pdf Metadata Signatures with new values
    signatures = [
        PdfMetadataSignatures.AUTHOR.clone("Mr.Scherlock Holmes"),
        PdfMetadataSignatures.CREATE_DATE.clone(datetime.now() - timedelta(days=1)),
        PdfMetadataSignatures.METADATA_DATE.clone(datetime.now() - timedelta(days=2)),
        PdfMetadataSignatures.CREATOR_TOOL.clone("GD.Signature-Test"),
        PdfMetadataSignatures.MODIFY_DATE.clone(datetime.now() - timedelta(days=13)),
        PdfMetadataSignatures.PRODUCER.clone("GroupDocs-Producer"),
        PdfMetadataSignatures.ENTRY.clone("Signature"),
        PdfMetadataSignatures.KEYWORDS.clone("GroupDocs, Signature, Metadata, Creation Tool"),
        PdfMetadataSignatures.TITLE.clone("Metadata Example"),
        PdfMetadataSignatures.SUBJECT.clone("Metadata Test Example"),
        PdfMetadataSignatures.DESCRIPTION.clone("Metadata Test example description"),
        PdfMetadataSignatures.CREATOR.clone("GroupDocs.Signature")
    ]
    
    # Add signatures to options
    options.signatures.extend(signatures)
    
    # Sign document
    sign.sign("sample_signed.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-metadata-signature/esign-pdf-with-metadata-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Implement custom serialization with QR-Code signatures

Path: /signature/net/implement-custom-serialization-with-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into QR-code signature custom objects. This feature is implemented over object serialization to string and further encryption. There is ability to provide custom encryption. This procedure requires implementation of interface [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) with two methods to encrypt and decrypt data.

Here are the steps to embed into QR-code text with custom encryption with GroupDocs.Signature:

* Define custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
* Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/formatattribute) attribute to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/skipserializationattribute) to mark property of class as not serialize
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object with [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) value  
* Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object according to your requirements and custom object to [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
class CustomSerializationAttribute : Attribute, IDataSerializer
{
    public T Deserialize<T>(string source) where T : class
    {
        return JsonConvert.DeserializeObject<T>(source);
    }
    public string Serialize(object data)
    {
        var serializerSettings = new JsonSerializerSettings { NullValueHandling = NullValueHandling.Ignore };
        return JsonConvert.SerializeObject(data, serializerSettings);
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
// setup CustomSerialization Attribute to setup customer serialization(see example above)
[CustomSerialization]
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Sign documents with custom encrypted objects and values into QR-code signatures

This example shows how to add custom object into metadata signature to Image document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create data encryption
    IDataEncryption encryption = new CustomXOREncryption();
    // create custom object
    DocumentSignatureData documentSignatureData = new DocumentSignatureData()
    {
        ID = Guid.NewGuid().ToString(),
        Author = Environment.UserName,
        Signed = DateTime.Now,
        DataFactor = 11.22M
    };
    // setup QR-Code options
    QrCodeSignOptions options = new QrCodeSignOptions()
    {
        // set custom object to serialize to QR Code
        Data = documentSignatureData,
        // QR-code type
        EncodeType = QrCodeTypes.QR,
        // specify serialization encryption
        DataEncryption = encryption,
        // locate and aligh signature
        Height = 100,
        Width = 100,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() { Right = 10, Bottom = 10 }
    };
    // sign document to file
    signature.Sign("QRCodeCustomSerialization.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign document with Digital signature

Path: /signature/java/esign-document-with-digital-signature/

## What is a Digital Signature?

A digital electronic signature is a scheme for verifying the document's authenticity. A valid digital signature gives a recipient very strong reason to believe that the document was created or updated by a known sender and that the document was not altered by unknown source. For documents, the digital signature is represented by certificate with private (to sign) and public (to verify) keys. Most often certificates of various public key cryptography standards are used for this purpose, for example PFX format (see specification [here](https://en.wikipedia.org/wiki/PKCS_12)). These digital signature certificates could be obtained from the operation system or generated manually with proper tools or trusted sources. 

Digital signature as certificate file of PFX format allows to sign document after each creation or change with certificate and specify several optional parameters like subject, title, reason, contact etc. Most document viewers or editors support digital signatures verification that allows users to ensure document is from trusted source. Office documents format such as Word processing documents (DOC, DOCX, ODT, OTT), Spreadsheet files (XLSX, XLS, ODS, OTS) support digital signature without any visual appearance on document pages. PDF document format supports digital signature with alternative visual appearance on specific document page with custom image and labels. Picture below shows how digital signature looks by default on PDF document page..

![](/signature/java/images/esign-document-with-digital-signature.png)

## How to eSign document with Digital signature   

GroupDocs.Signature supports creation of digital signature based on existing PFX certificate. To specify different settings library provides [DigitalSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions) class that allows to adjust digital signature properties in the document:

*   Certificate source from [getCertificateFilePath](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#getCertificateFilePath()) or [getCertificateStream](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#getCertificateStream());
*   Certificate [getPassword](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#getPassword());
*   [getContact](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#getContact()), [getReason](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#getReason()) and [getLocation](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#getLocation()) properties to set additional description;
*   [setVisible](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#setVisible(boolean)) property to specify whether signature should be visible on document page or not;

Here are the steps to add Digital signature into document with GroupDocs.Signature:

*   Create new instance of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions) object with required certificate and its password.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions) to it.   
    

This example shows how to sign PDF document with digital e-signature.

```java
Signature signature = new Signature("sample.pdf");

DigitalSignOptions options = new DigitalSignOptions("certificate.pfx");

    // optional: setup image file path
options.setImageFilePath("sample.jpg");
    //
options.setLeft(100);
options.setTop(100);
options.setPassword("1234567890");

// sign document to file
signature.sign("sampleSigned.pdf", options);
```

## More resources 

### Advanced Usage Topics 

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples  

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Digital signing with custom hash

Path: /signature/net/digital-signing-with-custom-hash/


### How to apply digital signature with custom hash algorithm

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides the ability to customize the hash algorithm used for digital signatures. This is particularly useful when you need to use specific cryptographic standards or have compliance requirements.

Here's how to implement digital signing with a custom hash algorithm:

```csharp
public void SignDocument()
{
    string certFilePath = "cert.pfx";
    string sampleFilePath = "sample.pdf";
    string sampleOutputFilePath = "signed.pdf";
    using (Signature.Signature signature = new Signature.Signature(sampleFilePath))
    {
        // initialize digital option with certificate file path
        DigitalSignOptions options = new DigitalSignOptions(certFilePath)
        {
            // certificate password
            Password = "1234567890",
            // digital certificate details
            Reason = "Sign",
            Contact = "JohnSmith",
            Location = "Office1",
            AllPages = true,
            Width = 80,
            Height = 60,
            VerticalAlignment = VerticalAlignment.Bottom,
            HorizontalAlignment = HorizontalAlignment.Right,
            Margin = new Padding() { Bottom = 10, Right = 10 },
            HashAlgorithm = HashAlgorithm.Sha256
        };
        options.CustomSignHash = new CustomDigitalSigner();
        
        signature.Sign(sampleOutputFilePath, options);
    }
}

public class CustomDigitalSigner : ICustomSignHash
{
    public byte[] CustomSignHash(
        byte[] signableHash, 
        HashAlgorithm hashAlgorithm, 
        SignatureContext signatureContext)
    {
        string inputP12 = "";
        var inputPfxPassword = "1234567890";
        X509Certificate2 signerCert = new X509Certificate2(
            inputP12, 
            inputPfxPassword, 
            X509KeyStorageFlags.Exportable);
        RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();
        var xmlString = signerCert.PrivateKey.ToXmlString(true);
        rsaCSP.FromXmlString(xmlString);
        byte[] signedData = rsaCSP.SignData(signableHash, hashAlgorithm);
        return signedData;
    }
}
```

### Step-by-Step Implementation Guide

Let's break down the implementation into clear steps:

1. **Setup the Signature Environment**
   ```csharp
   string certFilePath = "cert.pfx";
   string sampleFilePath = "sample.pdf";
   string sampleOutputFilePath = "signed.pdf";
   using (Signature.Signature signature = new Signature.Signature(sampleFilePath))
   ```
   - Define paths for your certificate, input document, and output file
   - Create a new `Signature` instance with your input document

2. **Configure Digital Signature Options**
   ```csharp
   DigitalSignOptions options = new DigitalSignOptions(certFilePath)
   {
       Password = "1234567890",
       Reason = "Sign",
       Contact = "JohnSmith",
       Location = "Office1",
       AllPages = true,
       Width = 80,
       Height = 60,
       VerticalAlignment = VerticalAlignment.Bottom,
       HorizontalAlignment = HorizontalAlignment.Right,
       Margin = new Padding() { Bottom = 10, Right = 10 },
       HashAlgorithm = HashAlgorithm.Sha256
   };
   ```
   - Create `DigitalSignOptions` with your certificate file
   - Set basic signature properties (password, reason, contact, location)
   - Configure visual appearance (size, position, alignment)
   - Specify the hash algorithm (SHA-256 in this example)

3. **Implement Custom Hash Signing**
   ```csharp
   options.CustomSignHash = new CustomDigitalSigner();
   ```
   - Assign your custom hash implementation to the options

4. **Create Custom Hash Implementation**
   ```csharp
   public class CustomDigitalSigner : ICustomSignHash
   {
       public byte[] CustomSignHash(
           byte[] signableHash, 
           HashAlgorithm hashAlgorithm, 
           SignatureContext signatureContext)
       {
           // Load certificate
           string inputP12 = "";
           var inputPfxPassword = "1234567890";
           X509Certificate2 signerCert = new X509Certificate2(
               inputP12, 
               inputPfxPassword, 
               X509KeyStorageFlags.Exportable);
           
           // Setup RSA provider
           RSACryptoServiceProvider rsaCSP = new RSACryptoServiceProvider();
           var xmlString = signerCert.PrivateKey.ToXmlString(true);
           rsaCSP.FromXmlString(xmlString);
           
           // Sign the hash
           byte[] signedData = rsaCSP.SignData(signableHash, hashAlgorithm);
           return signedData;
       }
   }
   ```
   - Implement `ICustomSignHash` interface
   - Load your certificate with proper password and flags
   - Configure RSA provider with the certificate's private key
   - Sign the hash using the specified algorithm

5. **Apply the Signature**
   ```csharp
   signature.Sign(sampleOutputFilePath, options);
   ```
   - Call the `Sign` method with your output path and options
   - The document will be signed using your custom hash implementation

### Important Notes

* Make sure your certificate file is valid and accessible
* Keep your certificate password secure and never hardcode it in production code
* The custom hash implementation should handle the signing process securely
* Consider implementing proper error handling in production code
* The hash algorithm specified in options should match your security requirements

### Understanding Hash Algorithms

Hash algorithms are cryptographic functions that convert data of any size into a fixed-size output (hash value). In digital signatures, hash algorithms play a crucial role in ensuring document integrity and authenticity. Here's how they work:

1. The document content is processed through the hash algorithm to generate a unique hash value
2. This hash value is then encrypted with the signer's private key
3. The encrypted hash becomes part of the digital signature
4. When verifying the signature, the same hash algorithm is used to ensure the document hasn't been tampered with

### Available Hash Algorithms

GroupDocs.Signature provides several hash algorithms for digital signing, each offering different levels of security and performance. Here are the available options:

* **Auto Selection**: The system automatically chooses the most appropriate hash algorithm based on your document type and security requirements.

* **SHA-1**: 
  - Produces a 160-bit (20-byte) hash value
  - Widely supported but considered less secure for modern applications
  - Best for legacy system compatibility

* **SHA-256**: 
  - Produces a 256-bit (32-byte) hash value
  - Currently recommended for most applications
  - Provides a good balance of security and performance
  - Widely supported across modern systems

* **SHA-384**: 
  - Produces a 384-bit (48-byte) hash value
  - Offers enhanced security compared to SHA-256
  - Suitable for high-security applications
  - May require more computational resources

* **SHA-512**: 
  - Produces a 512-bit (64-byte) hash value
  - Provides the highest level of security among available options
  - Best for applications requiring maximum security
  - Requires the most computational resources

### Signing PDF Files Using Azure Key Vault

GroupDocs.Signature supports integration with Azure Key Vault for secure digital signing. This approach is particularly useful for cloud-based applications where you want to keep your signing keys secure in Azure Key Vault.

Here's how to implement PDF signing using Azure Key Vault:

```csharp
public static void SignUsingAzureKeyVault()
{
    string sampleFilePath = "sample.pdf";
    string sampleOutputFilePath = "signed.pdf";
    
    using (Signature signature = new Signature(sampleFilePath))
    {
        // initialize digital option with certificate file path
        DigitalSignOptions options = new DigitalSignOptions()
        {
            Signature = new DigitalSignature(),
            // certificate password
            Password = "1234567890",
            // digital certificate details
            Reason = "Sign",
            Contact = "JohnSmith",
            Location = "Office1",
            AllPages = true,
            Width = 80,
            Height = 60,
            VerticalAlignment = VerticalAlignment.Bottom,
            HorizontalAlignment = HorizontalAlignment.Right,
            Margin = new Padding() { Bottom = 10, Right = 10 },
            HashAlgorithm = HashAlgorithm.Sha256
        };
        var azureSigner = new AzureSigner();
        options.CustomSignHash = azureSigner;
        options.Signature.Certificate = azureSigner.GetPublicCertificateFromAzureStorage();
            
        signature.Sign(sampleOutputFilePath, options);
    }
}

public class AzureSigner : ICustomSignHash
{
    public byte[] CustomSignHash(
        byte[] hash, 
        HashAlgorithm hashAlgorithm, 
        SignatureContext signatureContext)
    {
        return SignWithAzure(hash);
    }

    private static byte[] SignWithAzure(byte[] signableHash)
    {
        var credential = GetAzureSecretCredential();
        var certificateKeyId = "https://...";
        CryptographyClient client = new CryptographyClient(
            new Uri(certificateKeyId), 
            credential);
        var result = client.Sign(SignatureAlgorithm.RS256, signableHash);
        return result.Signature;
    }

    static ClientSecretCredential GetAzureSecretCredential()
    {
        string tenantId = "your tenantId";
        string clientId = "your clientId";
        string secret = "your secret";
        ClientSecretCredential credential = new ClientSecretCredential(
            tenantId, 
            clientId, 
            secret);
        return credential;
    }

    public X509Certificate2 GetPublicCertificateFromAzureStorage()
    {
        string vaultUri = "https://test.vault.azure.net/";
        var credential = GetAzureSecretCredential();
        X509Certificate2 pubCertificate = GetPublicCertificateFromAzureStorage(
            credential, 
            vaultUri);
        return pubCertificate;
    }

    static X509Certificate2 GetPublicCertificateFromAzureStorage(
        ClientSecretCredential credential, 
        string uri)
    {
        //Create certificate client.
        CertificateClient certificateClient = new CertificateClient(
            new Uri(uri), 
            credential);
        //Get the certificate with public key.
        KeyVaultCertificateWithPolicy certificate = certificateClient
            .GetCertificateAsync("Certificate")
            .Result;
        //Create and return the X509Certificate2.
        return new X509Certificate2(certificate.Cer);
    }
}
```

### Azure Key Vault Implementation Steps

1. **Setup Azure Key Vault**
   - Create an Azure Key Vault instance
   - Upload your signing certificate to the Key Vault
   - Configure access policies for your application

2. **Configure Azure Credentials**
   ```csharp
   static ClientSecretCredential GetAzureSecretCredential()
   {
       string tenantId = "your tenantId";
       string clientId = "your clientId";
       string secret = "your secret";
       return new ClientSecretCredential(tenantId, clientId, secret);
   }
   ```
   - Register your application in Azure AD
   - Get the tenant ID, client ID, and client secret
   - Create a credential object for Azure Key Vault access

3. **Retrieve Certificate**
   ```csharp
   public X509Certificate2 GetPublicCertificateFromAzureStorage()
   {
       string vaultUri = "https://test.vault.azure.net/";
       var credential = GetAzureSecretCredential();
       return GetPublicCertificateFromAzureStorage(credential, vaultUri);
   }
   ```
   - Connect to your Azure Key Vault
   - Retrieve the public certificate for signature verification

4. **Implement Custom Signing**
   ```csharp
   private static byte[] SignWithAzure(byte[] signableHash)
   {
       var credential = GetAzureSecretCredential();
       var certificateKeyId = "https://...";
       CryptographyClient client = new CryptographyClient(new Uri(certificateKeyId), credential);
       var result = client.Sign(SignatureAlgorithm.RS256, signableHash);
       return result.Signature;
   }
   ```
   - Create a cryptography client
   - Sign the hash using the Azure Key Vault key
   - Return the signed data

### Azure Key Vault Security Considerations

1. **Access Control**
   - Use managed identities when possible
   - Implement least privilege access
   - Regularly rotate credentials

2. **Certificate Management**
   - Keep certificates up to date
   - Monitor certificate expiration
   - Implement certificate rotation procedures

3. **Network Security**
   - Use private endpoints when possible
   - Implement proper network security groups
   - Monitor access logs

4. **Error Handling**
   - Implement proper exception handling
   - Log security events
   - Monitor for suspicious activities

### Security Considerations

When choosing a hash algorithm for digital signatures, consider the following:

1. **Security Level**: SHA256 and above are recommended for modern applications as they provide better security than SHA1 or MD5.
2. **Compatibility**: Ensure the chosen algorithm is compatible with your target systems and compliance requirements.
3. **Performance**: While stronger algorithms provide better security, they may require more computational resources.

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**. 
---

## Sign documents with exception handling

Path: /signature/net/sign-documents-with-exception-handling/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides different error messages due to validation issues, missing required data, files etc. For exception class [GroupDocsSignatureException](https://reference.groupdocs.com/signature/net/groupdocs.signature/groupdocssignatureexception) is being used.

Here are the steps to handle exceptions from GroupDocs.Signature:

* Compose try-catch block above [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method with catching [GroupDocsSignatureException](https://reference.groupdocs.com/signature/net/groupdocs.signature/groupdocssignatureexception) type error.  

This example shows how to handle GroupDocs.Signature exceptions.

```csharp
try
{
    using (Signature signature = new Signature("sample.xlsx"))
    {
        DigitalSignOptions options = new DigitalSignOptions()
        {
            CertificateFilePath = Constants.CertificatePfx,
            ImageFilePath = Constants.ImageHandwrite,
            // skip password specification
            //Password = "123456780"
        };
        // sign document to file
        signature.Sign("signed.xlsx", options);
    }
}
catch (GroupDocsSignatureException ex)
{
    Console.WriteLine("GroupDocs Signature Exception: " + ex.Message);
}
catch (Exception ex)
{
    Console.WriteLine("System Exception: " + ex.Message);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign document with HIBC LIC barcode Symbology

Path: /signature/net/sign-document-with-hibc-lic-barcode/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [HIBCLICCombinedData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/hibcliccombineddata/) class to create HIBC LIC barcode. It is used by manufacturers of health care products for identification purpose. Labelers can encode Primary Data and Secondary Data.

Here are the steps how to add HIBC LIC barcode signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the  [HIBCLICCombinedData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/hibcliccombineddata/). Fill properties which correspond Primary Data and Secondary Data structure with models [HIBCLICPrimaryData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/hibclicprimarydata/) and [HIBCLICSecondaryAdditionalData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/hibclicsecondaryadditionaldata/) respectively.
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/) object with all required additional options and set HIBCLICCombinedData object into Data property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add HIBCLICCombinedData signature to document:

```csharp
using (Signature signature = new Signature(filePath))
{
    // Create HIBCLICCombinedData data object which composes Primary and Secondary data
    var hibclicCombinedData = new HIBCLICCombinedData()
    {
        PrimaryData = new HIBCLICPrimaryData()
        {
            ProductOrCatalogNumber = "12345",
            LabelerIdentificationCode = "A999",
            UnitOfMeasureID = 1
        },

        SecondaryAdditionalData = new HIBCLICSecondaryAdditionalData()
        {
            ExpiryDate = DateTime.Today,
            ExpiryDateFormat = HIBCLICDateFormat.MMDDYY,
            Quantity = 30,
            LotNumber = "LOT123",
            SerialNumber = "SERIAL123",
            DateOfManufacture = DateTime.Today
        }
    };

    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        Left = 100,
        Top = 100,
        // setup Data property to Mailmark2D instance
        Data = hibclicCombinedData
    };

    // sign document to file
    var signResult = signature.Sign(outputFilePath, options);
            
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Update Image signatures in document

Path: /signature/java/update-image-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [ImageSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/ImageSignature) class to manipulate barcode signatures location, size and textual content. 

Please be aware that [update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class.

Here are the steps to update Barcode signature in the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [ImageSearchOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/ImageSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [ImageSignatures](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/ImageSignature);      
*   Select from list [ImageSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/ImageSignature) object(s) that should be updated;     
*   Call [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    

This example shows how to update Image signature that was found using  [search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    ImageSearchOptions options = new ImageSearchOptions();
    // search for image signatures in document
    List<ImageSignature> signatures = signature.Search<ImageSignature>(options);
    if(signatures.Count > 0)
    {
        ImageSignature imageSignature = signatures[0];
        // change Image properties
        signatureToUpdate.Top = 200;
        signatureToUpdate.Left = 200;
        signatureToUpdate.Width = 300;
        signatureToUpdate.Height = 150;

        bool result = signature.Update(imageSignature);
        if(result)
        {
            Console.WriteLine($"Signature with Top '{imageSignature.Top}' was updated in the document ['{fileName}'].");
        }
        else
        {
            Console.WriteLine($"Signature was not updated in  the document! Signature with Top '{imageSignature.Top}' was not found!");
        }
    }
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update Image signatures in document

Path: /signature/net/update-image-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) class to manipulate barcode signatures location, size and textual content.
Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to update Barcode signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [ImageSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature);  
* Select from list [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) object(s) that should be updated;  
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.  

This example shows how to update Image signature that was found using  [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    ImageSearchOptions options = new ImageSearchOptions();
    // search for image signatures in document
    List<ImageSignature> signatures = signature.Search<ImageSignature>(options);
    if(signatures.Count > 0)
    {
        ImageSignature imageSignature = signatures[0];
        // change Image properties
        signatureToUpdate.Top = 200;
        signatureToUpdate.Left = 200;
        signatureToUpdate.Width = 300;
        signatureToUpdate.Height = 150;

        bool result = signature.Update(imageSignature);
        if (result)
        {
            Console.WriteLine(
                $"Signature with Top '{imageSignature.Top}' " +
                $"was updated in the document ['{fileName}']."
            );
        }
        else
        {
            Console.WriteLine(
                $"Signature was not updated in the document! " +
                $"Signature with Top '{imageSignature.Top}' was not found!"
            );
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Update Image signatures in document

Path: /signature/nodejs-java/update-image-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [ImageSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/imagesignature) class to manipulate image signatures' location, size, and textual content. Please note that the [Update](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/update/) method modifies the same document that was passed to the constructor of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class.

### Here are the steps to update an Image signature in the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [ImageSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/imagesearchoptions) object with the desired properties.
* Call the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method to obtain a list of [ImageSignatures](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/imagesignature).
* Select from the list the [ImageSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/imagesignature) object(s) that should be updated.
* Call the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) object's [Update](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/update/) method and pass one or several signatures to it.

This example shows how to update an Image signature that was found using the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method.
```csharp
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 
  const fileName = path.basename(filePath);

  // Copy source file since the update method works with the same document
  const outputFilePath = path.join(Constants.OutputPath, 'UpdateImage', fileName);
  const dir = path.dirname(outputFilePath);
  if (!fs.existsSync(dir)) {
      fs.mkdirSync(dir, { recursive: true });
  }
  
  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize ImageSearchOptions
  const options = new signatureLib.ImageSearchOptions();

  // Search for image signatures in the document
  const signatures = signature.search(signatureLib.ImageSignature.class, options).toArray();

  if (signatures.length > 0) {
    const imageSignature = signatures[0];
    imageSignature.setLeft(100);
    imageSignature.setTop(100);

    // Update the image signature in the document
    const result = signature.update(outputFilePath, imageSignature);

    if (result) {
      console.log(`\nImage signature at location ${imageSignature.getLeft()}x${imageSignature.getTop()} and Size ${imageSignature.getSize()} was updated in the document [${fileName}].`);
    } else {
      console.log(`\nSignature was not updated in the document! Image signature at location ${imageSignature.getLeft()}x${imageSignature.getTop()} and Size ${imageSignature.getSize()} was not found!`);
    }
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign PDF with Metadata signature

Path: /signature/java/esign-pdf-with-metadata-signature/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [PdfMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/PdfMetadataSignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) instance.   
PDF document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
PDF document metadata contains 3 fields: Name, Value and TagPrefix, combination of Name and Tag prefix should be unique.

PDF document metadata could keep big amount of data that provides ability to keep serialized custom objects with additional encryption in there. See [Advanced examples how to embed secure data]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

Here are the steps to add metadata signatures into PDF document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements.    
*   Instantiate one or several[PdfMetadataSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures.metadata/PdfMetadataSignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to metadata signatures collection ([getSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#getSignatures())) via [add](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignatureCollection#add(com.groupdocs.signature.domain.signatures.metadata.MetadataSignature)) or addRange method.
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it.
    

## How to eSign PDF with Metadata signature

This example shows how to sign PDF document with several e-signatures as metadata.

```java
Signature signature = new Signature("sample.pdf");

// create Metadata option with predefined Metadata text
MetadataSignOptions options = new MetadataSignOptions();

// Create few Pdf Metadata signatures
PdfMetadataSignature[] signatures = new PdfMetadataSignature[]
        {
                new PdfMetadataSignature("Author", "Mr.Scherlock Holmes"),
                new PdfMetadataSignature("DateCreated", new Date()),
                new PdfMetadataSignature("DocumentId", 123456),
                new PdfMetadataSignature("SignatureId", 123.456)//decimal value
        };
options.getSignatures().addRange(signatures);

// sign document to file
signature.sign("SampleSigned.pdf", options);
```

## How to eSign PDF with standard metadata signatures

This example shows how to sign PDF document with standard standard embedded PDF document metadata signatures. If PDF metadata signature already exists with same name its value will be overwritten.

```java
Signature signature = new Signature("sample.pdf");
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();

// Using standard Pdf Metadata Signatures with new values
MetadataSignature[] signatures = new MetadataSignature[]
        {
                PdfMetadataSignatures.getAuthor().deepClone("Mr.Scherlock Holmes"),
                PdfMetadataSignatures.getCreateDate().deepClone(DateUtils.addDays(new Date(), -1)),
                PdfMetadataSignatures.getMetadataDate().deepClone(DateUtils.addDays(new Date(), -2)),
                PdfMetadataSignatures.getCreatorTool().deepClone("GD.Signature-Test"),
                PdfMetadataSignatures.getModifyDate().deepClone(DateUtils.addDays(new Date(), -13)),
                PdfMetadataSignatures.getProducer().deepClone("GroupDocs-Producer"),
                PdfMetadataSignatures.getEntry().deepClone("Signature"),
                PdfMetadataSignatures.getKeywords().deepClone("GroupDocs, Signature, Metadata, Creation Tool"),
                PdfMetadataSignatures.getTitle().deepClone("Metadata Example"),
                PdfMetadataSignatures.getSubject().deepClone("Metadata Test Example"),
                PdfMetadataSignatures.getDescription().deepClone("Metadata Test example description"),
                PdfMetadataSignatures.getCreator().deepClone("GroupDocs.Signature"),
        };
options.getSignatures().addRange(signatures);

// sign document to file
signature.sign("sample_signed.pdf", options);
```

## More resources

### Advanced Usage Topics 

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples  

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign VBA macroses with Digital signature

Path: /signature/net/sign-vba-macroses-with-digital-signature/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) class to specify different amount of settings for Digital signature
* Class [DigitalVBA](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/digitalvba/) allows to configure certificate settings for macros signing

Here are the steps to add Digital signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source Excel document path as a constructor parameter.
* Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object
* Instantiate the [DigitalVBA](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/digitalvba/) object with certificatePath and password.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.

This example shows how to add Digital signature to document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp

 using (Signature signature = new Signature(excelFilePath))
{
     DigitalSignOptions signOptions = new DigitalSignOptions();
    //Add extension for signing VBA project digitally
    DigitalVBA digitalVBA = new DigitalVBA(certificatePath, password);
    //Set to true only for signing VBA project
    digitalVBA.SignOnlyVBAProject = true;
    digitalVBA.Comments = "VBA Comment";
    signOptions.Extensions.Add(digitalVBA);

    // sign document to file
    SignResult signResult = signature.Sign(outputFilePath, signOptions);
}

```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [Sign Spreadsheet document with macro support and VBA Project in it](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET/blob/master/Examples/GroupDocs.Signature.Examples.CSharp/AdvancedUsage/Sign/SignSpreadsheetsVBAProject.cs)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Deleting Image signatures - advanced

Path: /signature/java/deleting-image-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) class to manipulate image signatures and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method.  
Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete Image signature from the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) object with desired properties;
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature);  
    
*   Select from list [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) object(s) that should be removed from the document;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method and pass one or several signatures to it.
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not.

Here are the alternative steps to delete Image signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) methods.

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate one or several [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) objects with signature Id(s) passed to constructor;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method and pass one or several signatures to it;
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not. 

## Delete Image signature from the document after Search

This example shows how to delete Image signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("signed.docx");
ImageSearchOptions options = new ImageSearchOptions();
 
List<ImageSignature> signatures = signature.search(ImageSignature.class, options);
List<BaseSignature> signaturesToDelete = new ArrayList<BaseSignature>();
// collect signatures to delete
for (ImageSignature temp : signatures)
{
    if (temp.getSize() > 10000)
    {
        signaturesToDelete.add(temp);
    }
}
// delete signatures
DeleteResult deleteResult = signature.delete("signed.docx",signaturesToDelete);
if (deleteResult.getSucceeded().size() == signaturesToDelete.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : "+deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : "+deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Delete Image signature from the document by known signature Identifier

This example shows how to delete Image signature in the document by known signature Id (that was obtained by  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method previously).

```java
// initialize Signature instance
Signature signature = new Signature("signed.docx");
// read from some data source signature Id value
String[] signatureIdList = new String[]
        {
                "1a5fbc08-4b96-43d9-b650-578b16fbb877",
                "1d4cf995-3150-47a0-b17a-44c17ecf7279"
        };
// create list of Image Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList)
{
    signatures.add(new ImageSignature(item));
}
// delete required signatures
DeleteResult deleteResult = signature.delete("signed.docx",signatures);
if (deleteResult.getSucceeded().size() == signatures.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : " + deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : " + deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Image signatures from documents

Path: /signature/java/delete-image-signatures-from-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) class to manipulate image signatures and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method.  
Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete Image signature from the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature);      
*   Select from list [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) object(s) that should be removed from the document;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    
This example shows how to delete Image signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
Signature signature = new Signature("signed.pptx");
try
{
    ImageSearchOptions options = new ImageSearchOptions();
 
    // search for image signatures in document
    List<ImageSignature> signatures = signature.search(ImageSignature.class, options);
    if (signatures.size() > 0)
    {
        ImageSignature imageSignature = signatures.get(0);
        boolean result = signature.delete("signed-output.pptx",imageSignature);
        if (result)
        {
            System.out.print("Image signature at location "+imageSignature.getLeft() + "x"+imageSignature.getTop()+" and Size "+imageSignature.getSize()+" was deleted from document [signed-output.pptx].");
        }
        else
        {
            System.out.print("Signature was not deleted from the document! Signature at location "+imageSignature.getLeft()+"x"+imageSignature.getTop()+" and Size "+imageSignature.getSize()+" was not found!");
        }
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Deleting Image signatures - advanced

Path: /signature/net/deleting-image-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) class to manipulate image signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.

Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to delete Image signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature);
* Select from list [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

Here are the alternative steps to delete Image signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) objects with signature Id(s) passed to constructor;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it;
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

## Delete Image signature from the document after Search

This example shows how to delete Image signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.docx"))
{
    ImageSearchOptions options = new ImageSearchOptions();
    List<ImageSignature> signatures = signature.Search<ImageSignature>(options);
    List<BaseSignature> signaturesToDelete = new List<BaseSignature>();
    // collect signatures to delete
    foreach (ImageSignature temp in signatures)
    {
        if (temp.Size > 100000)
        {
            signaturesToDelete.Add(temp);
        }
    }
    // delete signatures
    DeleteResult deleteResult = signature.Delete(signaturesToDelete);
    if (deleteResult.Succeeded.Count == signaturesToDelete.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Delete Image signature from the document by known signature Identifier  

This example shows how to delete Image signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously).

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.docx"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of Image Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new ImageSignature(p)));
    // delete required signatures
    DeleteResult deleteResult = signature.Delete(signatures);
    if (deleteResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Image signatures from documents

Path: /signature/net/delete-image-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) class to manipulate image signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

## How to delete Image signature from the document
Here are the steps to delete Image signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature);
* Select from list [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.  

This example shows how to delete Image signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("signed.pptx"))
{
    ImageSearchOptions options = new ImageSearchOptions();
    
    // Search for image signatures in the document
    List<ImageSignature> signatures = 
        signature.Search<ImageSignature>(options);

    if (signatures.Count > 0)
    {
        ImageSignature imageSignature = signatures[3];
        bool result = signature.Delete(imageSignature);

        if (result)
        {
            Console.WriteLine(
                $"Image signature at location {imageSignature.Left}x{imageSignature.Top} " +
                $"and size {imageSignature.Size} was deleted from document ['{fileName}']."
            );
        }
        else
        {
            Console.WriteLine(
                $"Signature was not deleted from the document! " +
                $"Signature at location {imageSignature.Left}x{imageSignature.Top} " +
                $"and size {imageSignature.Size} was not found!"
            );
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Updating Image signatures with advanced options

Path: /signature/net/updating-image-signatures-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) class to manipulate image signatures location, and size over [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) object to analyze if signatures were successfully processed.

Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. The [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) contains list of successfully updated signatures and ones that failed. The Image signature could be failed to update due to several reasons:

* if signature object was initialized with constructor by incorrect signature identifier;
* if signature object was not found;
* there was an error occurred while updating signature in the document.

Here are the steps to update Image signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [ImageSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature);
* Select from list [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

Here are the alternative steps to update Image signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [ImageSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature) objects with signature Id(s) passed to constructor;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it;
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

The following table describes changeable properties for Image signatures dependent on document type.

| Document Type / Signature Property | Left | Top | Width | Height | Size | IsSignature |
| --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) |
| Spreadsheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Pdf | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Presentation | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Word Processing | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |

## Update Image signature in the document after Search

This example shows how to update Image signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("sampleSigned.xlsx"))
{
    ImageSearchOptions options = new ImageSearchOptions();
    // search for image signatures in document
    List<ImageSignature> signatures = signature.Search<ImageSignature>(options);
    // adjust signature properties
    foreach (ImageSignature temp in signatures)
    {
        // apply some condition to adjust signature properties
        temp.Left = temp.Left + 10;
        temp.Top = temp.Top + 10;
        if (temp.Size > 10000)
        {
            temp.IsSignature = false;
        }
    }
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures.ConvertAll(p => (BaseSignature)p));
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Update Image signature in document by known signature Identifier  

This example shows how to update Image signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously).

```csharp
// initialize Signature instance
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of Image Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new ImageSignature(p)));
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures);
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Composing signature with radial gradient brush background

Path: /signature/net/composing-signature-with-radial-gradient-brush-background/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [RadialGradientBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/radialgradientbrush) class to specify filling signature background with radial gradients

Here are the steps to use Radial gradient brush with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with all required additional options and setup [Background.Brush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/background/brush) property with instance of  [RadialGradientBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/radialgradientbrush)
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

This example shows how to use Radial gradient brush for signature background. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // adjust signature appearance brush
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new RadialGradientBrush(Color.LimeGreen, Color.DarkGreen)
        },
        // locate signature
        Width = 100,
        Height = 80,
        VerticalAlignment = Domain.VerticalAlignment.Center,
        HorizontalAlignment = Domain.HorizontalAlignment.Center,
        Margin = new Padding() { Top = 20, Right = 20 },
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image
    };
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Image signatures from documents

Path: /signature/python-net/delete-image-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [ImageSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/imagesignature) class to manipulate image signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

## How to delete Image signature from the document
Here are the steps to delete Image signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [ImageSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/imagesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain list of [ImageSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/imagesignature);
* Select from list [ImageSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/imagesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.  

This example shows how to delete Image signature that was found using [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method.

```python
import groupdocs.signature as signature
from groupdocs.signature.options import ImageSearchOptions

# Initialize signature
with signature.Signature("signed.pptx") as sign:
    # Create search options
    options = ImageSearchOptions()
    
    # Search for image signatures in the document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        image_signature = signatures[3]
        result = sign.delete(image_signature)
        
        if result:
            print(
                f"Image signature at location {image_signature.left}x{image_signature.top} "
                f"and size {image_signature.size} was deleted from document ['{fileName}']."
            )
        else:
            print(
                f"Signature was not deleted from the document! "
                f"Signature at location {image_signature.left}x{image_signature.top} "
                f"and size {image_signature.size} was not found!"
            )
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Locating signature with different alignments

Path: /signature/java/locating-signature-with-different-alignments/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to align signature on page with horizontal and vertical alignment settings. Signature options that implement interface [IAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment) contain following properties:

*   [getHorizontalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#getHorizontalAlignment()) - property of enumeration type [HorizontalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/HorizontalAlignment) to specify horizontal alignment of signature. Values are [None, Left, Center, Right](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/HorizontalAlignment)
*   [getVerticalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#getVerticalAlignment()) - property of enumeration type [VerticalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/VerticalAlignment) to specify vertical alignment of signature. Values are [None, Top, Center, Bottom](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/VerticalAlignment)
*   [getMargin](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#getMargin())\- property of class [Padding](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/Padding) to specify offset for signature alignment. Fields of class are [Left, Top, Right, Bottom](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/Padding) to specify offset in measure units from alignment area.
*   [getMarginMeasureType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#getMarginMeasureType()) - property of enumeration type [MeasureType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/MeasureType) with values ([Pixels, Millimeters, Percents](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/MeasureType)). See more details in this example [Locating signature on page with different measure units]({{< ref "signature/java/developer-guide/advanced-usage/signing/locating-signature-on-document-page/_index.md" >}})

Here are the steps to align signature on page with GroupDocs.Signature:

*   Create a new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate signature options ([ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) for example) with all required properties.    
*   Set  [setHorizontalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#setHorizontalAlignment(int)) with one of enumeration value to align signature along page width
*   Set  [setVerticalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#setVerticalAlignment(int)) with one of enumeration value to align signature along page height
*   Set  [setMargin](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#setMargin(com.groupdocs.signature.domain.Padding)) property with required offsetfrom page border
*   Set  [setMarginMeasureType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.interfaces/IAlignment#setMarginMeasureType(int)) property with non default value if there is need to specify offset from page border in another measure units like millimeters and page percents (from 100% width and 100% height)      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20java.util.List)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass the instance of signature options ([ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) for example) to it.

This example shows how to locate signature with different alignments.

```java
// instantiating the signature object
final Signature signature = new Signature("sample.pdf");
 
// define qr-code size
int qrWidth = 100;
int qrHeight = 100;
// define list of options        
List<SignOptions> listOptions = new ArrayList<SignOptions>();
// walk through all alignment values to locate signature at all page alignment areas
for(int horizontalAlignment : HorizontalAlignment.getValues())
{
    for (int verticalAlignment : VerticalAlignment.getValues())
    {
        if (verticalAlignment != VerticalAlignment.None && horizontalAlignment != HorizontalAlignment.None)
        {
 
            QrCodeSignOptions options =  new QrCodeSignOptions("Left-Top");
            options.setWidth(qrWidth);
            options.setHeight(qrHeight);
            // set signature alignment
            options.setHorizontalAlignment(horizontalAlignment);
            options.setVerticalAlignment(verticalAlignment);
            options.setMargin(new Padding(5));
            listOptions.add(options);
        }
    }
}
// sign document to file
SignResult signResult = signature.sign("signed.pdf", listOptions);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Advanced search for Digital signatures

Path: /signature/java/advanced-search-for-digital-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [DigitalSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/DigitalSearchOptions) class to specify different options to search for Digital Signatures.

Here are the steps to search for digital signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [DigitalSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/DigitalSearchOptions) object according to your requirements and specify search options  
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [DigitalSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/DigitalSearchOptions) to it.
    

This example shows how to make advanced search for Digital signature in the document.

```java
Signature signature = new Signature("signed.pdf");
DigitalSearchOptions options = new DigitalSearchOptions();
// specify special search criteria
options.setComments("Test comment");
// certificate issues criteria
options.setIssuerName("John");
// digital certificate subject
options.setSubjectName("Test");
// specify date range period of signature
options.setSignDateTimeFrom(DateUtils.addMonths(new Date(), -1));
options.setSignDateTimeTo(new Date());
 
// search for signatures in document
List<DigitalSignature> signatures = signature.search(DigitalSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (DigitalSignature digitalSignature : signatures)
{
    System.out.print("Digital signature found from "+digitalSignature.getSignTime()+" with validation flag "+digitalSignature.isValid()+". Certificate SN "+ digitalSignature.getCertificate().getType());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Advanced search for Digital signatures

Path: /signature/net/advanced-search-for-digital-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsearchoptions) class to specify different options to search for Digital Signatures.

Here are the steps to search for digital signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [DigitalSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsearchoptions) object according to your requirements and specify search options  
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsearchoptions) to it.

This example shows how to make advanced search for Digital signature in the document.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    DigitalSearchOptions options = new DigitalSearchOptions()
    {
        // specify special search criteria
        Comments = "Test comment",
        // certificate issues criteria
        IssuerName = "John",
        // digital certificate subject
        SubjectName = "Test",
        // specify date range period of signature
        SignDateTimeFrom = DateTime.Now.AddMonths(-1),
        SignDateTimeTo = DateTime.Now,
        //
    };
    // search for signatures in document
    List<DigitalSignature> signatures = signature.Search<DigitalSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var digitalSignature in signatures)
    {
        Console.WriteLine("Digital signature found from {0} with validation flag {1}. Certificate SN {2}",
            digitalSignature.SignTime, digitalSignature.IsValid, digitalSignature.Certificate?.SerialNumber);
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Update Image Signatures in Document

Path: /signature/python-net/update-image-signatures-in-document/

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides functionality to manipulate image signatures' location, size, and other properties.
Please note that the [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method modifies the same document that was passed to the constructor of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

Here are the steps to update an Image signature in a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter
* Instantiate the [ImageSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/imagesearchoptions) object with desired properties
* Call the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain a list of image signatures
* Select from the list the [ImageSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/imagesignature) object(s) that should be updated
* Call the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object's [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method and pass one or several signatures to it

This example shows how to update an Image signature that was found using the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import ImageSearchOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create search options
    options = ImageSearchOptions()
    
    # Search for image signatures in document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        # Get first image signature
        image_signature = signatures[0]
        
        # Change image properties
        image_signature.top = 200
        image_signature.left = 200
        image_signature.width = 300
        image_signature.height = 150
        
        # Update the signature
        result = sign.update(image_signature)
        
        if result.updated_count > 0:
            print(f"Signature with top position '{image_signature.top}' was updated in the document")
        else:
            print(f"Signature was not updated in the document! "
                  f"Signature with top position '{image_signature.top}' was not found!")
```


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Search for Digital e-signatures

Path: /signature/java/search-for-digital-e-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) offers an ability to find Digital signatures that are applied to document and returns its digital signature certificate.  
Please follow these steps to search for Digital signatures within the document:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate the [DigitalSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/DigitalSearchOptions) object according to your requirements and specify search options  
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [DigitalSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/DigitalSearchOptions) to it.
    

This example shows how to search for Digital signature in the document and analyze digital signature certificate.

```java
Signature signature = new Signature("spreadsheet.xlsx");
DigitalSearchOptions options = new DigitalSearchOptions();

// search for signatures in document
List<DigitalSignature> signatures = signature.search(DigitalSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (DigitalSignature digitalSignature : signatures)
{
    System.out.print("Digital signature found from "+digitalSignature.getSignTime()+" with validation flag "+digitalSignature.isValid()+". Certificate SN "+ digitalSignature.getCertificate().getType());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to search for Digital signatures

Path: /signature/net/search-for-digital-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) offers an ability to find Digital signatures that are applied to document and returns its digital signature certificate.  
Please follow these steps to search for Digital signatures within the document:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [DigitalSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsearchoptions) object according to your requirements and specify search options
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsearchoptions) to it.

This example shows how to search for Digital signature in the document and analyze digital signature certificate.

```csharp
using (Signature signature = new Signature("spreadsheet.xlsx"))
{
    // search for signatures in document
    List<DigitalSignature> signatures = signature.Search<DigitalSignature>(SignatureType.Digital);

    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var digitalSignature in signatures)
    {
        Console.WriteLine("Digital signature found from {0} with validation flag {1}. Certificate SN {2}",
        digitalSignature.SignTime, digitalSignature.IsValid, digitalSignature.Certificate?.SerialNumber);
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## How to search for Digital signatures

Path: /signature/nodejs-java/search-for-digital-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) offers the ability to find Digital signatures that are applied to a document and returns its digital signature certificate.  
Please follow these steps to search for Digital signatures within the document:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [DigitalSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalsearchoptions) object according to your requirements and specify search options.
* Call the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [DigitalSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalsearchoptions) to it.
This example shows how to search for Digital signature in the document and analyze digital signature certificate.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 

  const signature = new signatureLib.Signature(filePath);
  const options = new signatureLib.DigitalSearchOptions();

  // Search for signatures in the document
  const signatures = signature.search(signatureLib.DigitalSignature.class, options).toArray();
  console.log('\nSource document contains the following digital signatures.');

  for (const digitalSignature of signatures) {
    console.log(`Digital signature found from ${digitalSignature.getSignTime()} with validation flag ${digitalSignature.isValid()}. Certificate SN ${digitalSignature.getCertificate().getType()}`);
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for Form Field e-Signatures

Path: /signature/python-net/search-for-form-field-e-signatures/


[GroupDocs.Signature](https://products.groupdocs.com/signature/python-net) provides the ability to search for form field electronic signatures in documents. Form field signatures allow you to add interactive form elements like text boxes, checkboxes, and radio buttons to your documents.

## How to Search for Form Field Signatures

The [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class provides the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method which allows you to search for form field signatures in documents. Here's how to use it:

1. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class and pass the source document path as a parameter.
2. Create an instance of [FormFieldSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsearchoptions/) class.
3. Call the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class instance and pass the search options to it.
4. Process the search results.

Here's an example of how to search for form field signatures in a document:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import FormFieldSearchOptions
from groupdocs.signature.domain import FormFieldSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = FormFieldSearchOptions()
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} form field signatures")
    for form_field_signature in result:
        print(f"Page: {form_field_signature.page_number}")
        print(f"Field Name: {form_field_signature.name}")
        print(f"Field Type: {form_field_signature.field_type}")
        print(f"Field Value: {form_field_signature.value}")
```

## Advanced Search Options

You can customize the search process by setting specific options:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import FormFieldSearchOptions
from groupdocs.signature.domain import FormFieldSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = FormFieldSearchOptions()
    
    # Set search criteria
    search_options.page_number = 1  # Search on specific page
    search_options.all_pages = False  # Search only on specified page
    search_options.field_name = "signature"  # Search for specific field name
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} form field signatures")
    for form_field_signature in result:
        print(f"Page: {form_field_signature.page_number}")
        print(f"Field Name: {form_field_signature.name}")
        print(f"Field Type: {form_field_signature.field_type}")
        print(f"Field Value: {form_field_signature.value}")
```

## Additional Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our examples:

* [GroupDocs.Signature for Python via .NET Examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)
* [GroupDocs.Signature for Python via .NET Plugins](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Plugins)
* [GroupDocs.Signature for Python via .NET Showcase Apps](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Showcase)

### Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to search for form field signatures in documents with our free online apps:

* [Search for Form Field Signatures Online](https://products.groupdocs.app/signature/family)

---

## Add arrow annotation

Path: /annotation/java/add-arrow-annotation/

Arrow annotation draws an arrow on the document page and annotate it as shown in the picture below. 

![](/annotation/java/images/add-arrow-annotation.png)

You can use the following methods to set the properties of the [ArrowAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/) class:

*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines annotation position at document page
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPenColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/#setPenColor-java.lang.Integer-) defines the arrow color
*   [setPenStyle()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/#setPenStyle-java.lang.Byte-) defines annotation line style (solid, dash, dot etc.)
*   [setPenWidth()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/#setPenWidth-java.lang.Byte-) defines the arrow line width in pixels

To add an arrow annotation to document, follow these steps:  

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [ArrowAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/) class. Set the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [ArrowAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.  

The following code snippet shows how to add [ArrowAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/arrowannotation/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding arrow annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of ArrowAnnotation class and set options
    ArrowAnnotation arrow = new ArrowAnnotation();
    arrow.setBox(new Rectangle(100, 100, 100, 100));
    arrow.setCreatedOn(Calendar.getInstance().getTime());
    arrow.setMessage("This is arrow annotation");
    arrow.setOpacity(0.7);
    arrow.setPageNumber(0);
    arrow.setPenColor(65535);
    arrow.setPenStyle(PenStyle.Dot);
    arrow.setPenWidth((byte) 3);
    arrow.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(arrow);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Add arrow annotation

Path: /annotation/net/add-arrow-annotation/

Arrow annotation draws an arrow on the document page and annotate it as shown in the picture below. 

![](/annotation/net/images/add-arrow-annotation.png)

You can set the following properties of the [ArrowAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/arrowannotation) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/box) defines annotation position at document page
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/opacity) allows you to set the annotation opacity
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/pencolor) defines the arrow color
*   [PenStyle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penstyle) defines annotation line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penwidth) defines the arrow line width in pixels

To add an arrow annotation to document, follow these steps:  

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [ArrowAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/arrowannotation) class. Set the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [ArrowAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/arrowannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.  

The following code snippet shows how to add [ArrowAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/arrowannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Message = "This is arrow annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = 65535,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
             	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(arrow);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Add document to Word processing via OLE

Path: /merger/java/add-document-to-word-processing-via-ole/

## What is OLE object?

OLE is an abbreviation for "Object Linking and Embedding" technology that is provided by Microsoft and allows to import and embed some content produced by another application into currently edited documents. For example Excel spreadsheet  or PowerPoint presentation can be embedded into documents edited in a word processor and so on. This way OLE allows to store all document related data inside a single document and share this data easily.

## How to add OLE object to Microsoft Word documents

**[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** provides an ability to insert OLE objects into word processing documents of Microsoft Word and Open Document formats. Here is how to do this in a 3 easy steps:

*   Instantiate [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) object with source document path or stream;
*   Call [importDocument](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#importDocument(com.groupdocs.merger.domain.options.interfaces.IImportDocumentOptions)) method and pass [OleWordProcessingOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/OleWordProcessingOptions) object with embedded file path and page number;
*   Call [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates how to embed PDF file into DOCX document as OLE object

```java
int pageNumber = 2;
OleWordProcessingOptions oleWordsOptions = new OleWordProcessingOptions("c:\embedded.pdf", pageNumber);
oleWordsOptions.setWidth(300);
oleWordsOptions.setHeight(300);

Merger merger = new Merger("c:\sample.docx");

merger.importDocument(oleWordsOptions);
merger.save("c:\output\result.docx");

```

---

## Add document to Word processing via OLE

Path: /merger/net/add-document-to-word-processing-via-ole/

## What is OLE object?

OLE is an abbreviation for "Object Linking and Embedding" technology that is provided by Microsoft and allows to import and embed some content produced by another application into currently edited documents. For example Excel spreadsheet  or PowerPoint presentation can be embedded into documents edited in a word processor and so on. This way OLE allows to store all document related data inside a single document and share this data easily.

## How to add OLE object to Microsoft Word documents

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides an ability to insert OLE objects into word processing documents of Microsoft Word and Open Document formats. Here is how to do this in a 3 easy steps:

*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [ImportDocument](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/importdocument) method and pass [OleWordProcessingOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/olewordprocessingoptions) object with embedded file path and page number;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and pass desired file path to save resultant document.

The following code sample demonstrates how to embed PDF file into DOCX document as OLE object

```csharp
using (Merger merger = new Merger(@"c:\sample.docx"))
{
	int pageNumber = 2;
	OleWordProcessingOptions oleWordProcessingOptions = new OleWordProcessingOptions(@"c:\embedded.pdf", pageNumber);
	oleWordProcessingOptions.Width = 300;
	oleWordProcessingOptions.Height = 300;

    merger.ImportDocument(oleWordProcessingOptions);
    merger.Save(@"c:\output\result.docx");
}

```

---

## Add image watermarks

Path: /watermark/net/basic-usage/add-image/

One of the main features of the GroupDocs.Watermark library is adding image watermarks to documents. You may add watermarks to documents or images from local disks, as well as from streams. For a full list of supported document formats, check [Supported formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}}).

To add an image watermark perform the following steps:

1. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) an instance of the `Watermarker` class for a local file or file stream;
2. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/imagewatermark/constructors/1) an instance of the `ImageWatermark` class from the local image file;
3. (Optionally.) Specify the watermark [horizontal](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/horizontalalignment) and [vertical](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermark/properties/verticalalignment) alignments;
4. Call the [Add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/add) method to apply the watermark to the document;
5. Call the [Save](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/4) method to store the document in a new location.

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Common;
using GroupDocs.Watermark.Watermarks;

// Specify an absolute or relative path to your document.
using (Watermarker watermarker = new Watermarker("C:\\Docs\\contract.docx"))
{
    // Specify an absolute or relative path to the desired image
    ImageWatermark watermark = new ImageWatermark("C:\\Docs\\logo.png");
    // Specify watermark size, opacity and alignments
    watermark.Width = 200;
    watermark.Height = 200;
    watermark.Opacity = 0.5;
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    // Apply the watermark
    watermarker.Add(watermark);
    // Save the resulting document
    watermarker.Save("C:\\Docs\\img-watermarked-contract.docx");
}
```
Run the program. A new watermarked image will appear in the specified path.

![Adding image watermarks](/watermark/net/images/watermarking/add-image.png)

### What's next

GroupDocs.Watermark offers many more capabilities for adding image watermarks. To learn how to add watermarks from streams, use absolute or relative positioning, and so on, see the [Adding image watermarks]({{< ref "watermark/net/developer-guide/advanced-usage/adding-watermarks/adding-image-watermarks.md" >}}) article of the "Advanced usage" section.

---

## Add image watermarks

Path: /watermark/nodejs-java/add-image/

One of the main features of the GroupDocs.Watermark library is adding image watermarks to documents. You may add watermarks to documents or images from local disks, as well as from streams. For a full list of supported document formats, check [Supported formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}}).

To add an image watermark perform the following sample:

```javascript
const groupdocs.watermark = require('@groupdocs/groupdocs.watermark')

function addAnImageWatermark() {
  const watermarker = new groupdocs.watermark.Watermarker("sample.pdf");

  const imageWatermark = new groupdocs.watermark.ImageWatermark("sample.png");
  imageWatermark.setHorizontalAlignment(groupdocs.watermark.HorizontalAlignment.Center);
  imageWatermark.setVerticalAlignment(groupdocs.watermark.VerticalAlignment.Center);

  watermarker.add(imageWatermark);
  watermarker.save("sample.pdf");
  watermarker.close();
  console.log('Image watermark added and document saved successfully.');
}
```

### What's next

GroupDocs.Watermark offers many more capabilities for adding image watermarks. It's possible  from streams, use absolute or relative positioning, and so on.

---

## Add image watermarks

Path: /watermark/python-net/add-image/

One of the main features of the GroupDocs.Watermark library is adding image watermarks to documents. You may add watermarks to documents or images from local disks, as well as from streams. For a full list of supported document formats, check [Supported formats]({{< ref "watermark/python-net/getting-started/supported-document-formats.md" >}}).

To add an image watermark perform the following sample:

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwс

def run():
  with gw.Watermarker("sample.xlsx") as watermarker:
      watermark = gww.ImageWatermark("logo.png")
      watermark.horizontal_alignment = gwс.HorizontalAlignment.CENTER
      watermark.vertical_alignment = gwс.VerticalAlignment.CENTER

      watermarker.add(watermark)
      watermarker.save(join(output_directory, "result.xlsx"))
```

### What's next

GroupDocs.Watermark offers many more capabilities for adding image watermarks. It's possible  from streams, use absolute or relative positioning, and so on.

---

## Add password to PDF with permissions

Path: /merger/net/add-password-to-pdf-with-permissions/

You can easy protect PDF document with permissions, using the "GroupDocs.Merger for .NET" product.

The following example demonstrates how to secure PDF document with permissions in C# code:

*   Initialize [PdfSecurityOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/PdfSecurityOptions) class with new document password and set Permissions property with enum value of [PdfSecurityPermissions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/PdfSecurityPermissions);
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [AddPassword](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/addpassword) method and pass [PdfSecurityOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/PdfSecurityOptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

```csharp
string filePath = @"c:\sample.pdf";
string filePathOut = @"c:\output\result.pdf";

PdfSecurityOptions pdfSecurityOptions = new PdfSecurityOptions("SAMPLE_PASSWORD");
pdfSecurityOptions.Permissions = PdfSecurityPermissions.DenyModification;

using (Merger merger = new Merger(filePath))
{
    merger.AddPassword(pdfSecurityOptions);
    merger.Save(filePathOut);
}
```

---

## Add password to PDF with permissions

Path: /merger/python-net/add-password-to-pdf-with-permissions/

You can easy protect PDF document with permissions, using the "GroupDocs.Merger for .NET" product.

The following example demonstrates how to secure PDF document with permissions in C# code:

*   Initialize [PdfSecurityOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/PdfSecurityOptions) class with new document password and set Permissions property with enum value of [PdfSecurityPermissions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/PdfSecurityPermissions);
*   Instantiate [Merger](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger) object with source document path or stream;
*   Call [AddPassword](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/addpassword) method and pass [PdfSecurityOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/PdfSecurityOptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

```python
with gm.Merger(constants.sample_pdf) as merger:
    pdf_Security_options = gm.domain.options.PdfSecurityOptions("SomePasswordString")
    pdf_Security_options.permissions = gm.domain.options.PdfSecurityPermissions.DENY_MODIFICATION
    merger.add_password(pdf_Security_options)
    merger.save(constants.output_pdf)
```

---

## Add watermark

Path: /conversion/net/add-watermark/

**[GroupDocs.Conversion](https://products.groupdocs.com/conversion/net)** allows you to apply a watermark to the converted document.  You can set the following options for controlling how the watermark will be stamped in the converted document:

### WatermarkOptions

* **[Text](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarktextoptions/text)** - watermark text
* **[Font](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarktextoptions/watermarkfont)** - watermark font name
* **[Color](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarktextoptions/color)** - watermark color
* **[Width](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarkoptions/width)** - watermark width
* **[Height](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarkoptions/height)** - watermark height
* **[Top](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarkoptions/top/)** - watermark top position
* **[Left](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarkoptions/left)** - watermark left position
* **[RotationAngle](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarkoptions/rotationangle)** - watermark rotation angle
* **[Transparency](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarkoptions/transparency)** - watermark transparency
* **[Background](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarkoptions/background)** - specifies that the watermark is stamped as background. If the value is true, the watermark is laid at the bottom. By default is false and the watermark is laid on top

To add a watermark, follow these steps:

1. Create an instance of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class and pass source document path as a constructor parameter
2. Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) class e.g. **([PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions)** etc.)
3. Create an instance of the [WatermarkTextOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarktextoptions) class. Set appropriate properties to specify the watermark color, width, height, text, image etc.
4. Set the [Watermark](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/watermark) property of the [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) instance with the instance of the [WatermarkTextOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/watermarktextoptions) class created in the previous step
5. Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class instance and pass filename for the converted document and the instance of [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) from the previous step

The following code snippet shows how to apply watermark to the output document:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    WatermarkOptions watermark = new WatermarkTextOptions("Sample watermark")
    {
        Color = Color.Red,
        Width = 100,
        Height = 100,
        Background = true
    };
    PdfConvertOptions options = new PdfConvertOptions
    {
        Watermark = watermark
    };
    converter.Convert("converted.pdf", options);
}
```

---

## Adding image watermarks

Path: /watermark/java/adding-image-watermarks/

GroupDocs.Watermar API supports adding the following image file types as image watermark:

*   Bmp;
*   Png;
*   Gif;
*   Jpeg.

## Add image watermark from local file

Following code snippet shows how to add [ImageWatermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark) to a document. If the document consists of multiple parts (pages, worksheets, slides, frames etc), the watermark will be added to all of them.

**advanced\_usage.adding\_image\_watermarks.AddImageWatermark**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\presentation.pptx"
Watermarker watermarker = new Watermarker("presentation.pptx");                                           
                                                                                                                   
// Use path to the image as constructor parameter                                                                  
ImageWatermark watermark = new ImageWatermark("watermark.jpg");                                             
                                                                                                                   
// Add watermark to the document                                                                                   
watermarker.add(watermark);                                                                                        
                                                                                                                   
watermarker.save("presentation.pptx");                                                                   
                                                                                                                   
watermark.close();                                                                                                 
watermarker.close();                                                                                             
```

## Add image watermark from stream  

You can also use a stream of the image to initialize [ ImageWatermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark) instance as shown in below example.

**advanced\_usage.adding\_image\_watermarks.AddImageWatermarkUsingStream**

```java
// Specify an absolute or relative path to the watermark image. Ex: "C:\\Docs\\watermark.jpg"
FileInputStream watermarkStream = new FileInputStream("watermark.jpg");                           
                                                                                                         
Watermarker watermarker = new Watermarker("image.png");                                         
                                                                                                         
// Use stream containing an image as constructor parameter                                               
ImageWatermark watermark = new ImageWatermark(watermarkStream);                                          
                                                                                                         
// Add watermark to the document                                                                         
watermarker.add(watermark);                                                                              
                                                                                                         
watermarker.save("image.png");                                                                 
                                                                                                         
watermark.close();                                                                                       
watermarker.dispose();                                                                                   
watermarkStream.close();                                                                                 
```

{{< alert style="warning" >}}
[ImageWatermark ](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark) class implements [Closable](https://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html) interface. Therefore, it is necessary to call [close()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark#close()) method when you are done working with the watermark. 
{{< /alert >}}

For the advanced use of image watermark properties please check the following article about text watermarks, however, the same techniques will work for image watermarks as well:
*   [Adding Text Watermarks]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/adding-text-watermarks.md" >}})

---

## Adjust the image size

Path: /viewer/java/image-viewer-adjust-image-size/

To specify the output image size, call the [setWidth()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) and [setHeight()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) methods of the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) or [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) classes. Specify the value in pixels.

{{< alert style="info" >}}
GroupDocs.Viewer applies the aspect ratio automatically applied when you set the [setWidth()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) or [setHeight()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) value.
{{< /alert >}}

The following code snippet shows how to set the image width or height.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    JpgViewOptions viewOptions = new JpgViewOptions();
    // Specify width and height.
    viewOptions.setWidth(600);
    viewOptions.setHeight(800);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Adjust the image size

Path: /viewer/net/image-viewer-adjust-image-size/

To specify the output image size, set the [Width](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions/properties/width) and [Height](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions/properties/height) properties of the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) or [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions) classes. Specify the value in pixels.

{{< alert style="info" >}}
GroupDocs.Viewer applies the aspect ratio automatically applied when you set the [Width](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions/properties/width) or [Height](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions/properties/height) value.
{{< /alert >}}

The following code snippet shows how to set the image width or height.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create a JPG file.
    JpgViewOptions viewOptions = new JpgViewOptions();
    
    // Specify the width and height.
    viewOptions.Width = 600;
    viewOptions.Height = 800;
    
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create a JPG file.
            Dim viewOptions As JpgViewOptions = New JpgViewOptions()
        
            ' Specify the width and height.
            viewOptions.Width = 600
            viewOptions.Height = 800
        
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Adjusting comparison sensitivity

Path: /comparison/java/adjusting-comparison-sensitivity/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to adjust comparison sensitivity to achieve the necessary balance between the comparison speed and accuracy. Possible comparison sensitivity values range is from **0** to **100**.

- **Minimal value** (**0**) sets sensitivity to a minimal value provides the fastest comparison speed, but it may produce worst comparison quality. If there is at least one common letter in two compared words then these words are not treated as fully inserted and deleted
- **Value by default** means **75**. Comparison occurs when the percentage of deleted or inserted elements in relation to all elements does not exceed 75%
- **Maximum value** (**100**) provides the best quality, but slowest comparison speed. Comparison occurs at any length of a common sub-sequence of two compared objects

For better understanding about how comparison algorithms work let's suppose we have two strings:

| Strings                          |
| -------------------------------- |
| ` 1``. It is our equity poetry ` |
| ` 2``. Jack is a glad calf `     |

So, these strings have two common sub-sequences: "**is**" word and 4 space symbols.   
Common sub-sequence is - " **is** " and its length is 4 symbols (there are 2 space symbols in it).  
Length of inserted sub-sequence is 13 symbols - **Jackagladcalf**  
Removed sub-sequence length is 17 symbols - **Itourequitypoetry\*_  
Lets calculate percent of removed and inserted symbols: (17 + 13) / (17 + 13 + 4) * 100 = 88%

*Case 1.* If **SensitivityOfComparison = 80%** comparison of these two strings produces the next result:  
**Jack is a glad calfIt is our equity poetry**

Because calculated percent of removed and inserted symbols equals **88%** and it is bigger than value of **SensitivityOfComparison** equals **80%** then this common sub-sequence will be not taken into account.  
The first string considered completely removed and the second string considered completely inserted. The same results are produced for any calculated percent less than **83%**.

_Case 2._ If **SensitivityOfComparison = 89%**, comparison of these two strings produces the next result:  
**JackIt is aour gladequity calfpoetry**

Common sub-sequence was found, because **89% > 88%**. The same results are produced for any calculated percent bigger than **88%**.

To compare documents with specific comparison sensitivity, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object. Call the  [setSensitivityOfComparison()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setSensitivityOfComparison-int-) method to specify the appropriate value.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object.

The following code snippet shows how to compare documents with specific sensitivity:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");

    CompareOptions compareOptions = new CompareOptions();
    compareOptions.setSensitivityOfComparison(100);

    final Path resultPath = comparer.compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|            SensitivityOfComparison = 50                             |                         SensitivityOfComparison = 100                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/java/images/sensitivity50.png) | ![](/comparison/java/images/sensitivity100.png) |

---

## Adjusting comparison sensitivity

Path: /comparison/net/adjusting-comparison-sensitivity/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to adjust comparison sensitivity to achieve the necessary balance between the comparison speed and accuracy. Possible comparison sensitivity values range is from **0** to **100**.

- **Minimal value** (**0**) sets sensitivity to a minimal value provides the fastest comparison speed, but it may produce worst comparison quality. If there is at least one common letter in two compared words then these words are not treated as fully inserted and deleted
- **Value by default** means **75**. Comparison occurs when the percentage of deleted or inserted elements in relation to all elements does not exceed 75%
- **Maximum value** (**100**) provides the best quality, but slowest comparison speed. Comparison occurs at any length of a common sub-sequence of two compared objects

For better understanding about how comparison algorithms work let's suppose we have two strings:

| Strings                          |
| -------------------------------- |
| ` 1``. It is our equity poetry ` |
| ` 2``. Jack is a glad calf `     |

So, these strings have two common sub-sequences: "**is**" word and 4 space symbols.   
Common sub-sequence is - " **is** " and its length is 4 symbols (there are 2 space symbols in it).  
Length of inserted sub-sequence is 13 symbols - **Jackagladcalf**  
Removed sub-sequence length is 17 symbols - **Itourequitypoetry\*_  
Lets calculate percent of removed and inserted symbols: (17 + 13) / (17 + 13 + 4) * 100 = 88%

*Case 1.* If **SensitivityOfComparison = 80%** comparison of these two strings produces the next result:  
**Jack is a glad calfIt is our equity poetry**

Because calculated percent of removed and inserted symbols equals **88%** and it is bigger than value of **SensitivityOfComparison** equals **80%** then this common sub-sequence will be not taken into account.  
The first string considered completely removed and the second string considered completely inserted. The same results are produced for any calculated percent less than **83%**.

_Case 2._ If **SensitivityOfComparison = 89%**, comparison of these two strings produces the next result:  
**JackIt is aour gladequity calfpoetry**

Common sub-sequence was found, because **89% > 88%**. The same results are produced for any calculated percent bigger than **88%**.

To compare documents with specific comparison sensitivity, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object. Specify the appropriate  [SensitivityOfComparison](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions/properties/sensitivityofcomparison) value.
4.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.comparer/compare/methods/1) method. Specify the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object.

The following code snippet shows how to compare documents with specific sensitivity:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions options = new CompareOptions() { SensitivityOfComparison = 100 };
    comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|            SensitivityOfComparison = 50                             |                         SensitivityOfComparison = 100                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/net/images/sensitivity50.png) | ![](/comparison/net/images/sensitivity100.png) |


You can also set the sensitivity level specifically for tables.
The following code snippet shows how to do it:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions options = new CompareOptions() 
    { 
        SensitivityOfComparison = 100, SensitivityOfComparisonForTables = 75 
    };
    comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|            SensitivityOfComparisonForTables = 50                             |                         SensitivityOfComparisonForTables = 75                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/net/images/tablesensitivity50.png) | ![](/comparison/net/images/tablesensitivity75.png) |
---

## Adjusting comparison sensitivity

Path: /comparison/nodejs-java/adjusting-comparison-sensitivity/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to adjust comparison sensitivity to achieve the necessary balance between the comparison speed and accuracy. Possible comparison sensitivity value ranges from **0** to **100**.

- **Minimal value** (**0**) sets sensitivity to a minimal value providing the fastest comparison speed, but it may produce the worst comparison quality. If there is at least one common letter in two compared words then these words are not treated as fully inserted and deleted
- **Value by default** means **75**. Comparison occurs when the percentage of deleted or inserted elements in relation to all elements does not exceed 75%
- **Maximum value** (**100**) provides the best quality, but slowest comparison speed. Comparison occurs at any length of a common sub-sequence of two compared objects

For a better understanding of how comparison algorithms work let's suppose we have two strings:

| Strings                          |
| -------------------------------- |
| 1. It is our equity poetry  |
| 2. Jack is a glad calf      |

So, these strings have two common sub-sequences: "**is**" word and 4 space symbols.  
Common sub-sequence is - " **is** " and its length is 4 symbols (there are 2 space symbols in it).  
The length of the inserted sub-sequence is 13 symbols - **Jackagladcalf**  
Removed sub-sequence length is 17 symbols - **Itourequitypoetry**  

Let's calculate the percent of removed and inserted symbols: (17 + 13) / (17 + 13 + 4) * 100 = 88%

*Case 1.* If **SensitivityOfComparison = 80%**, the comparison of these two strings produces the next result:  
**Jack is a glad calfIt is our equity poetry**

Because the calculated percent of removed and inserted symbols (**88%**) is greater than the **SensitivityOfComparison** value (**80%**), then this common sub-sequence will be not taken into account.  
The first string will be considered as completely removed, and the second string will be considered as completely inserted. The same results are produced for any calculated percent less than **88%**.

_Case 2._ If **SensitivityOfComparison = 89%**, the comparison of these two strings produces the next result:  
**JackIt is aour gladequity calfpoetry**

A common sub-sequence was found because the calculated percent of removed and inserted symbols (**88%**) is less than the **SensitivityOfComparison** value (**89%**). The same results are produced for any calculated percent bigger than **88%**.

The following code snippet shows how to compare documents with specific sensitivity:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target and output documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const resultFile = 'result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add the target document to the comparison list
comparer.add(targetFile);

// Create comparison options and configure sensitivity
const compareOptions = new groupdocs.CompareOptions();
compareOptions.setSensitivityOfComparison(100); // 0 (low) to 100 (high) sensitivity

// Run the comparison and save the result to the output file
comparer.compare(resultFile, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It sets the sensitivity to 100 (maximum sensitivity for best quality) using `setSensitivityOfComparison()`, then performs the comparison with these options. Higher sensitivity values (closer to 100) provide more accurate comparison but slower performance, while lower values (closer to 0) are faster but may miss some differences.

The result is as follows:

|            SensitivityOfComparison = 50                             |                         SensitivityOfComparison = 100                            |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/nodejs-java/images/sensitivity50.png) | ![](/comparison/nodejs-java/images/sensitivity100.png) |

---

## Adjusting comparison sensitivity

Path: /comparison/python-net/adjusting-comparison-sensitivity/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) supports sensitivity levels from 0 (fastest, least detailed) to 100 (slowest, most detailed).

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to adjust comparison sensitivity to achieve the necessary balance between the comparison speed and accuracy. Possible comparison sensitivity values range is from **0** to **100**.

- **Minimal value** (**0**) sets sensitivity to a minimal value provides the fastest comparison speed, but it may produce worst comparison quality. If there is at least one common letter in two compared words then these words are not treated as fully inserted and deleted
- **Value by default** means **75**. Comparison occurs when the percentage of deleted or inserted elements in relation to all elements does not exceed 75%
- **Maximum value** (**100**) provides the best quality, but slowest comparison speed. Comparison occurs at any length of a common sub-sequence of two compared objects

For better understanding about how comparison algorithms work let's suppose we have two strings:

| Strings                          |
| -------------------------------- |
| ` 1``. It is our equity poetry ` |
| ` 2``. Jack is a glad calf `     |

So, these strings have two common sub-sequences: "**is**" word and 4 space symbols.   
Common sub-sequence is - " **is** " and its length is 4 symbols (there are 2 space symbols in it).  
Length of inserted sub-sequence is 13 symbols - **Jackagladcalf**  
Removed sub-sequence length is 17 symbols - **Itourequitypoetry\*_  
Lets calculate percent of removed and inserted symbols: (17 + 13) / (17 + 13 + 4) * 100 = 88%

*Case 1.* If **SensitivityOfComparison = 80%** comparison of these two strings produces the next result:  
**Jack is a glad calfIt is our equity poetry**

Because calculated percent of removed and inserted symbols equals **88%** and it is bigger than value of **SensitivityOfComparison** equals **80%** then this common sub-sequence will be not taken into account.  
The first string considered completely removed and the second string considered completely inserted. The same results are produced for any calculated percent less than **83%**.

_Case 2._ If **SensitivityOfComparison = 89%**, comparison of these two strings produces the next result:  
**JackIt is aour gladequity calfpoetry**

Common sub-sequence was found, because **89% > 88%**. The same results are produced for any calculated percent bigger than **88%**.

## Adjust overall sensitivity

Increase sensitivity to detect smaller changes or reduce it for faster processing.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.sensitivity_of_comparison = 100
    comparer.compare("result.docx", options)
```

🔹 Use case: Maximize accuracy for legal or scientific documents where subtle edits matter.

## Adjust sensitivity for tables

Use a separate sensitivity value for tabular content.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.sensitivity_of_comparison = 100
    options.sensitivity_of_comparison_for_tables = 75
    comparer.compare("result.docx", options)
```

🔹 Use case: Tune detection granularity in tables while keeping overall sensitivity high.



---

## Alphabet

Path: /search/java/alphabet/

An instance of the [Alphabet](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/Alphabet) class contains types of characters used for indexing. For detailed information on the types of characters, see the [Character types]({{< ref "search/java/developer-guide/advanced-usage/indexing/character-types.md" >}}) page.

The [getCharacterType](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/Alphabet#getCharacterType(char)) method is used to get the type of a specific character.

The [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/Alphabet#getCount()) method returns the number of characters of a type other than [CharacterType.Separator](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterType#Separator).

To set the type of characters in the alphabet, use the [setRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/Alphabet#setRange(char%5B%5D,%20int)) method.

To set the [CharacterType.Separator](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterType#Separator) type for all characters in the alphabet, use the [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/Alphabet#clear()) method.

To export types of all characters to a file, use the [exportDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import types of all characters from a file, use the [importDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the alphabet.



```java
String indexFolder = "c:\\MyIndex\\";
 
// Creating or opening an index from the specified folder
Index index = new Index(indexFolder);

// Export the alphabet to a file
index.getDictionaries().getAlphabet().exportDictionary("C:\\Alphabet.dat");
 
if (index.getDictionaries().getAlphabet().getCount() > 0) {
    // Setting a type of all characters to Separator
    index.getDictionaries().getAlphabet().clear();
}
 
// Import the alphabet from a file
index.getDictionaries().getAlphabet().importDictionary("C:\\Alphabet.dat");
 
if (index.getDictionaries().getAlphabet().getCharacterType('-') != CharacterType.Blended) {
    // Setting a type of hyphen character to Blended
    index.getDictionaries().getAlphabet().setRange(new char[] { '-' }, CharacterType.Blended);
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Alphabet

Path: /search/net/alphabet/

An instance of the [Alphabet](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/alphabet) class contains types of characters used for indexing. For detailed information on the types of characters, see the [Character types]({{< ref "search/net/developer-guide/advanced-usage/indexing/character-types.md" >}}) page.

The [GetCharacterType](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/alphabet/methods/getcharactertype) method is used to get the type of a specific character.

The [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/alphabet/properties/count) property returns the number of characters of a type other than [CharacterType](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/charactertype).Separator.

To set the type of characters in the alphabet, use the [SetRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/alphabet/methods/setrange) method.

To set the [CharacterType](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/charactertype).Separator type for all characters in the alphabet, use the [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/alphabet/methods/clear) method.

To export types of all characters to a file, use the [ExportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/exportdictionary) method.

To import types of all characters from a file, use the [ImportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/importdictionary) method.

The following example demonstrates the use of methods of the alphabet.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
 
// Creating or opening an index from the specified folder
Index index = new Index(indexFolder);
 
if (index.Dictionaries.Alphabet.Count > 0)
{
    // Setting a type of all characters to Separator
    index.Dictionaries.Alphabet.Clear();
}
 
if (index.Dictionaries.Alphabet.GetCharacterType('-') != CharacterType.Blended)
{
    // Setting a type of hyphen character to Blended
    index.Dictionaries.Alphabet.SetRange(new char[] { '-' }, CharacterType.Blended);
}
 
// Export the alphabet to a file
index.Dictionaries.Alphabet.ExportDictionary(@"C:\Alphabet.dat");
 
// Import the alphabet from a file
index.Dictionaries.Alphabet.ImportDictionary(@"C:\Alphabet.dat");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Alphabet

Path: /search/nodejs-java/alphabet/

An instance of the [Alphabet](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/Alphabet) class contains types of characters used for indexing. For detailed information on the types of characters, see the [Character types]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/character-types.md" >}}) page.

The [getCharacterType](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/Alphabet#getCharacterType(char)) method is used to get the type of a specific character.

The [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/Alphabet#getCount()) method returns the number of characters of a type other than [CharacterType.Separator](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterType#Separator).

To set the type of characters in the alphabet, use the [setRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/Alphabet#setRange(char%5B%5D,%20int)) method.

To set the [CharacterType.Separator](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterType#Separator) type for all characters in the alphabet, use the [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/Alphabet#clear()) method.

To export types of all characters to a file, use the [exportDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import types of all characters from a file, use the [importDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the alphabet.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating or opening an index from the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Export the alphabet to a file
const fileName = Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/alphabet/Alphabet.dat';
index.getDictionaries().getAlphabet().exportDictionary(fileName);

if (index.getDictionaries().getAlphabet().getCount() > 0) {
  // Setting a type of all characters to Separator
  index.getDictionaries().getAlphabet().clear();
}

// Import the alphabet from a file
index.getDictionaries().getAlphabet().importDictionary(fileName);

if (
  String(index.getDictionaries().getAlphabet().getCharacterType(java.newChar('-'))) !=
  String(groupdocs.search.CharacterType.Blended)
) {
  // Setting a type of hyphen character to Blended
  index
    .getDictionaries()
    .getAlphabet()
    .setRange(java.newArray('char', ['-']), groupdocs.search.CharacterType.Blended);
}

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search in the index
const query = 'Elliot-Murray-Kynynmound';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Barcode Image Generation in Word Processing Document

Path: /assembly/java/barcode-image-generation-in-word-processing-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Barcode Generation in Microsoft Word

### Template Syntax

*   Add a textbox to your template at the place where you want a barcode image to be inserted.
*   Add the following syntax:

```java
<<barcode [value] -itf6>>
```

#### Download Template

Get the template from here.

*   [Barcode.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Barcode.docx?raw=true)

### The Code

{{< gist GroupDocsGists 5a251b4914b8781cff6502c51e3ceb36 >}}



---

## Barcode Image Generation in Word Processing Document

Path: /assembly/net/barcode-image-generation-in-word-processing-document/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.2.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Barcode Generation in Microsoft Word

### Template Syntax

*   Add a textbox to your template at the place where you want a barcode image to be inserted.
*   Add the following syntax:

```csharp
<<barcode [customer.Barcode] -codabar>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Get the template from here.

*   [Barcode.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Barcode.docx?raw=true)

### The Code

{{< gist GroupDocsGists 0d42e27e26b1798117e9885319c8676b >}}

---

## Bubble Chart in Spreadsheet Document

Path: /assembly/java/bubble-chart-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bubble Chart report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bubble Chart in Microsoft Excel Document

### Creating a Bubble Chart

Please follow below steps to create a Bubble Chart in MS Excel 2013:

1.  Add a new Workbook.
2.  Click in the workbook where you want to insert the chart, click the "Insert" tab, and then click "Insert Scatter Chart Icon" in the charts group.
3.  A drop-down with charts will appear, select the "Bubble" and press "OK" to insert the chart.
4.  Click on the chart you just inserted, then click the "Select Data" icon in Data group.
5.  Add legend entries. See [Chart Data](https://docs.groupdocs.com/assembly/java/bubble-chart-in-spreadsheet-document/#reporting-requirement).
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   Retrieve total Contract Prices by Months.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>><<x [key + 1]>>
```

#### Chart Data

**Legend Entries**

```java
="Total Contract Price<<y [sum(c => c.getPrice())]>><<size [count()]>>"
```

### Download Bubble Chart Template

Please download the sample Bubble Chart document we created in this article:

*   [Bubble Chart.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Bubble%20Chart.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 1b76dbc560b5792fec4d6e809896f7d9 >}}

## Bubble Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Bubble Chart in Spreadsheet Document

Path: /assembly/net/bubble-chart-in-spreadsheet-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bubble Chart in Microsoft Excel Document

### Creating a Bubble Chart

Please follow below steps to create a Bubble Chart in MS Excel 2013:

1.  Add a new Workbook.
2.  Click on the workbook where you want to insert the chart, click the "Insert" tab, and then click "Insert Scatter Chart Icon" in the charts group.
3.  A drop-down with charts will appear, select the "Bubble" and press "OK" to insert the chart.
4.  Click on the chart you just inserted, then click the "Select Data" icon in Data group.
5.  Add legend entries. See [Chart Data](https://docs.groupdocs.com/assembly/net/bubble-chart-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   A report must show variation in the sales/orders prices.
*   It must show which sale/order lie in which month.
*   A report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Orders Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>><<x [Key]>>

```

#### Chart Data

**Legend Entries**

```csharp
="Orders Prices by Months<<y [Sum(c=> c.Price)]>><<size [Count()]>>"

```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bubble Chart Template

Please download the sample Bubble Chart document we created in this article:

*   [Bubble Chart.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Bubble%20Chart.xlsx?raw=true) (Template for CustomObject and JSON examples) 
*   [Bubble Chart\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Bubble%20Chart_DB.xlsx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 765476d18fe7954c79095567ef3a75ee >}}



#### Database Entities

{{< gist GroupDocsGists 2ac7c9d251e3d1a616bb937df12ccf7e >}}



#### Using DataSet

{{< gist GroupDocsGists bb0a55e6e06a556549797c43257f5ca0 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 4de723c02ab1c71ddda43bb5e6f6b22a >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 473a83fcdc1ecb0e5357628008361e09 >}}



## Bubble Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Build search query

Path: /search/java/build-search-query/

This page contains information about building text search queries of various types. More examples on building search queries are provided on the page [Search operation table]({{< ref "search/java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}). A detailed specification of search query language is presented on the page [Query language specification]({{< ref "search/java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}).

In addition to text search queries, there is also the ability to create queries in an object form. Search query forms are described on the page [Queries in text and object form]({{< ref "search/java/developer-guide/advanced-usage/searching/queries-in-text-and-object-form.md" >}}).

You can also use search options to customize your search queries. Detailed information on search options is provided on the page [Search options]({{< ref "search/java/developer-guide/advanced-usage/searching/search-options.md" >}}).

## Simple search query

The first type of search query is a simple search query. Queries of this type are used to search for a single word in the text of a document. The example is presented below.



```java
String query = "Einstein";
SearchResult result = index.search(query); // Search in the index
```

## Wildcard search query

A more complex type of query is a wildcard search query. There are 2 types of wildcard characters in a word: a one character wildcard and a character group wildcard. Detailed information about wildcards in a word is provided on the page [Wildcard search]({{< ref "search/java/developer-guide/advanced-usage/searching/wildcard-search.md" >}}). The example below demonstrates use of the one character wildcard.



```java
String query = "?ffect";
SearchResult result = index.search(query); // Search for words 'affect', 'effect', ets.
```

The character group wildcard allows you to specify a range of unknown characters in the form ?(N~M), where N and M are in the range from 0 to 255. The next example demonstrates use of the character group wildcard.



```java
String query = "princip?(2~4)";
SearchResult result = index.search(query); // Search for words 'principal', 'principle', 'principles', 'principally', ets.
```

## Faceted search query

The next type of query - faceted search query - allows you to specify the document field for the search. Detailed information about faceted search is presented on the page [Faceted search]({{< ref "search/java/developer-guide/advanced-usage/searching/faceted-search.md" >}}). The following example shows how to search only in 'Content' field.



```java
String query = "Content: Einstein";
SearchResult result = index.search(query); // Search for word 'Einstein' only in 'Content' field
```

## Numeric range search query

The following type of query allows you to specify a range of numbers to search - numeric range search query. Detailed information about numeric range search is presented on the page [Numeric range search]({{< ref "search/java/developer-guide/advanced-usage/searching/numeric-range-search.md" >}}). The example below demonstrates how to search for numbers in the range from 2000 to 3000.



```java
String query = "2000 ~~ 3000";
SearchResult result = index.search(query); // Search for numbers from 2000 to 3000
```

## Date range search query

Search for dates from a particular range is performed using a date range search query. Details on the date range search are presented on the page [Date range search]({{< ref "search/java/developer-guide/advanced-usage/searching/date-range-search.md" >}}). The example demonstrates how to search for dates in the format 'MM/dd/yyyy' in the range from 01/01/2000 to 06/15/2001.



```java
SearchOptions options = new SearchOptions(); // Creating a search options object
options.getDateFormats().clear(); // Removing default date formats
 
// Creating a date format pattern 'MM/dd/yyyy'
DateFormatElement[] elements = new DateFormatElement[]
{
    DateFormatElement.getMonthTwoDigits(),
    DateFormatElement.getDateSeparator(),
    DateFormatElement.getDayOfMonthTwoDigits(),
    DateFormatElement.getDateSeparator(),
    DateFormatElement.getYearFourDigits(),
};
DateFormat dateFormat = new DateFormat(elements, "/");
 
options.getDateFormats().addItem(dateFormat); // Adding the date format pattern to the date format collection
String query = "daterange(2000-01-01 ~~ 2001-06-15)"; // Dates in the search query are always specified in the format 'yyyy-MM-dd'
 
SearchResult result = index.search(query, options); // Search in index
```

## Regular expression search query

The next type of query is a regular expression search query. Detailed information about queries of this type is presented on the page [Regular expression search]({{< ref "search/java/developer-guide/advanced-usage/searching/regular-expression-search.md" >}}). The following example demonstrates the use of regular expressions to search in an index.



```java
String query = "^(.)\\1{2,}"; // The caret character at the beginning indicates that this is a regular expression search query
SearchResult result = index.search(query); // Search for three or more identical characters in a row
```

## Boolean search query

The next type of search query is a boolean search query. Queries of this type allow you to use the logical conditions for the presence or absence of particular words in documents. The boolean operators AND, OR, NOT can be used in queries of this type. Detailed information about this type of search is presented on the page [Boolean search]({{< ref "search/java/developer-guide/advanced-usage/searching/boolean-search.md" >}}). The following example demonstrates how to search for documents containing the word 'Einstein' but not containing the word 'relativity'.



```java
String query = "Einstein AND NOT relativity";
SearchResult result = index.search(query);
```

Boolean search queries can be combined using parentheses and other types of queries. For example, the following query searches for all documents containing words that start with 'relativ' in the document path or that contain the word 'Einstein' in the document content.



```java
String query = "FileName: relativ?(1~3) OR Content: (Einstein AND Albert)";
SearchResult result = index.search(query); // Search for documents whose paths contain 'relative', 'relativity', ets., or documents containing both 'Einstein' and 'Albert' in the content
```

## Phrase search query

Another type of query - a phrase search query - allows you to search entire phrases in documents. Detailed information on the phase search is on the page [Phrase search]({{< ref "search/java/developer-guide/advanced-usage/searching/phrase-search.md" >}}). An example of the phrase search is presented below.



```java
String query = "\"theory of special relativity\"";
SearchResult result = index.search(query); // Search for the phrase 'theory of special relativity'
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Build search query

Path: /search/net/build-search-query/

This page contains information about building text search queries of various types. More examples on building search queries are provided on the page [Search operation table]({{< ref "search/net/developer-guide/advanced-usage/searching/search-operation-table.md" >}}). A detailed specification of search query language is presented on the page [Query language specification]({{< ref "search/net/developer-guide/advanced-usage/searching/query-language-specification.md" >}}).

In addition to text search queries, there is also the ability to create queries in an object form. Search query forms are described on the page [Queries in text and object form]({{< ref "search/net/developer-guide/advanced-usage/searching/queries-in-text-and-object-form.md" >}}).

You can also use search options to customize your search queries. Detailed information on search options is provided on the page [Search options]({{< ref "search/net/developer-guide/advanced-usage/searching/search-options.md" >}}).

## Simple search query

The first type of search query is a simple search query. Queries of this type are used to search for a single word in the text of a document. The example is presented below.

**C#**

```csharp
string query = "Einstein";
SearchResult result = index.Search(query); // Search in the index
```

## Wildcard search query

A more complex type of query is a wildcard search query. There are 2 types of wildcard characters in a word: a one character wildcard and a character group wildcard. Detailed information about wildcards in a word is provided on the page [Wildcard search]({{< ref "search/net/developer-guide/advanced-usage/searching/wildcard-search.md" >}}). The example below demonstrates use of the one character wildcard.

**C#**

```csharp
string query = "?ffect";
SearchResult result = index.Search(query); // Search for words 'affect', 'effect', ets.
```

The character group wildcard allows you to specify a range of unknown characters in the form ?(N~M), where N and M are in the range from 0 to 255. The next example demonstrates use of the character group wildcard.

**C#**

```csharp
string query = "princip?(2~4)";
SearchResult result = index.Search(query); // Search for words 'principal', 'principle', 'principles', 'principally', ets.
```

## Faceted search query

The next type of query - faceted search query - allows you to specify the document field for the search. Detailed information about faceted search is presented on the page [Faceted search]({{< ref "search/net/developer-guide/advanced-usage/searching/faceted-search.md" >}}). The following example shows how to search only in 'Content' field.

**C#**

```csharp
string query = "Content: Einstein";
SearchResult result = index.Search(query); // Search for word 'Einstein' only in 'Content' field
```

## Numeric range search query

The following type of query allows you to specify a range of numbers to search - numeric range search query. Detailed information about numeric range search is presented on the page [Numeric range search]({{< ref "search/net/developer-guide/advanced-usage/searching/numeric-range-search.md" >}}). The example below demonstrates how to search for numbers in the range from 2000 to 3000.

**C#**

```csharp
string query = "2000 ~~ 3000";
SearchResult result = index.Search(query); // Search for numbers from 2000 to 3000
```

## Date range search query

Search for dates from a particular range is performed using a date range search query. Details on the date range search are presented on the page [Date range search]({{< ref "search/net/developer-guide/advanced-usage/searching/date-range-search.md" >}}). The example demonstrates how to search for dates in the format 'MM/dd/yyyy' in the range from 01/01/2000 to 06/15/2001.

**C#**

```csharp
SearchOptions options = new SearchOptions(); // Creating a search options object
options.DateFormats.Clear(); // Removing default date formats
 
// Creating a date format pattern 'MM/dd/yyyy'
DateFormatElement[] elements = new DateFormatElement[]
{
    DateFormatElement.MonthTwoDigits,
    DateFormatElement.DateSeparator,
    DateFormatElement.DayOfMonthTwoDigits,
    DateFormatElement.DateSeparator,
    DateFormatElement.YearFourDigits,
};
DateFormat dateFormat = new DateFormat(elements, "/");
 
options.DateFormats.Add(dateFormat); // Adding the date format pattern to the date format collection
string query = "daterange(2000-01-01 ~~ 2001-06-15)"; // Dates in the search query are always specified in the format 'yyyy-MM-dd'
 
SearchResult result = index.Search(query, options); // Search in index
```

## Regular expression search query

The next type of query is a regular expression search query. Detailed information about queries of this type is presented on the page [Regular expression search]({{< ref "search/net/developer-guide/advanced-usage/searching/regular-expression-search.md" >}}). The following example demonstrates the use of regular expressions to search in an index.

**C#**

```csharp
string query = "^(.)\\1{2,}"; // The caret character at the beginning indicates that this is a regular expression search query
SearchResult result = index.Search(query); // Search for three or more identical characters in a row
```

## Boolean search query

The next type of search query is a boolean search query. Queries of this type allow you to use the logical conditions for the presence or absence of particular words in documents. The boolean operators AND, OR, NOT can be used in queries of this type. Detailed information about this type of search is presented on the page [Boolean search]({{< ref "search/net/developer-guide/advanced-usage/searching/boolean-search.md" >}}). The following example demonstrates how to search for documents containing the word 'Einstein' but not containing the word 'relativity'.

**C#**

```csharp
string query = "Einstein AND NOT relativity";
SearchResult result = index.Search(query);
```

Boolean search queries can be combined using parentheses and other types of queries. For example, the following query searches for all documents containing words that start with 'relativ' in the document path or that contain the word 'Einstein' in the document content.

**C#**

```csharp
string query = "FileName: relativ?(1~3) OR Content: (Einstein AND Albert)";
SearchResult result = index.Search(query); // Search for documents whose paths contain 'relative', 'relativity', ets., or documents containing both 'Einstein' and 'Albert' in the content
```

## Phrase search query

Another type of query - a phrase search query - allows you to search entire phrases in documents. Detailed information on the phase search is on the page [Phrase search]({{< ref "search/net/developer-guide/advanced-usage/searching/phrase-search.md" >}}). An example of the phrase search is presented below.

**C#**

```csharp
string query = "\"theory of special relativity\"";
SearchResult result = index.Search(query); // Search for the phrase 'theory of special relativity'
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Build search query

Path: /search/nodejs-java/build-search-query/

This page contains information about building text search queries of various types. More examples on building search queries are provided on the page [Search operation table]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}). A detailed specification of search query language is presented on the page [Query language specification]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}).

In addition to text search queries, there is also the ability to create queries in an object form. Search query forms are described on the page [Queries in text and object form]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/queries-in-text-and-object-form.md" >}}).

You can also use search options to customize your search queries. Detailed information on search options is provided on the page [Search options]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-options.md" >}}).

## Simple search query

The first type of search query is a simple search query. Queries of this type are used to search for a single word in the text of a document. The example is presented below.

```javascript
const query = 'Einstein';
const result = index.search(query); // Search in the index
```

## Wildcard search query

A more complex type of query is a wildcard search query. There are 2 types of wildcard characters in a word: a one character wildcard and a character group wildcard. Detailed information about wildcards in a word is provided on the page [Wildcard search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/wildcard-search.md" >}}). The example below demonstrates use of the one character wildcard.

```javascript
const query = '?ffect';
const result = index.search(query); // Search for words 'affect', 'effect', ets.
```

The character group wildcard allows you to specify a range of unknown characters in the form ?(N~M), where N and M are in the range from 0 to 255. The next example demonstrates use of the character group wildcard.

```javascript
const query = 'princip?(2~4)';
const result = index.search(query); // Search for words 'principal', 'principle', 'principles', 'principally', ets.
```

## Faceted search query

The next type of query - faceted search query - allows you to specify the document field for the search. Detailed information about faceted search is presented on the page [Faceted search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/faceted-search.md" >}}). The following example shows how to search only in 'Content' field.

```javascript
const query = 'Content: Einstein';
const result = index.search(query); // Search for word 'Einstein' only in 'Content' field
```

## Numeric range search query

The following type of query allows you to specify a range of numbers to search - numeric range search query. Detailed information about numeric range search is presented on the page [Numeric range search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/numeric-range-search.md" >}}). The example below demonstrates how to search for numbers in the range from 2000 to 3000.

```javascript
const query = '2000 ~~ 3000';
const result = index.search(query); // Search for numbers from 2000 to 3000
```

## Date range search query

Search for dates from a particular range is performed using a date range search query. Details on the date range search are presented on the page [Date range search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/date-range-search.md" >}}). The example demonstrates how to search for dates in the format 'MM/dd/yyyy' in the range from 01/01/2000 to 06/15/2001.

```javascript
const options = new groupdocs.search.SearchOptions(); // Creating a search options object
options.getDateFormats().clear(); // Removing default date formats

// Creating a date format pattern 'MM/dd/yyyy'
const elements = java.newArray('com.groupdocs.search.options.DateFormatElement', [
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getMonthTwoDigits'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDateSeparator'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDayOfMonthTwoDigits'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDateSeparator'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getYearFourDigits'),
]);
const dateFormat = new groupdocs.search.DateFormat(elements, '/');
options.getDateFormats().addItem(dateFormat); // Adding the date format pattern to the date format collection

const query = 'daterange(2000-01-01 ~~ 2001-06-15)'; // Dates in the search query are always specified in the format 'yyyy-MM-dd'
const result = index.search(query, options); // Search in index
```

## Regular expression search query

The next type of query is a regular expression search query. Detailed information about queries of this type is presented on the page [Regular expression search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/regular-expression-search.md" >}}). The following example demonstrates the use of regular expressions to search in an index.

```javascript
const query = '^(.)\\1{2,}'; // The caret character at the beginning indicates that this is a regular expression search query
const result = index.search(query); // Search for three or more identical characters in a row
```

## Boolean search query

The next type of search query is a boolean search query. Queries of this type allow you to use the logical conditions for the presence or absence of particular words in documents. The boolean operators AND, OR, NOT can be used in queries of this type. Detailed information about this type of search is presented on the page [Boolean search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/boolean-search.md" >}}). The following example demonstrates how to search for documents containing the word 'Einstein' but not containing the word 'relativity'.

```javascript
const query = 'Einstein AND NOT relativity';
const result = index.search(query);
```

Boolean search queries can be combined using parentheses and other types of queries. For example, the following query searches for all documents containing words that start with 'relativ' in the document path or that contain the word 'Einstein' in the document content.

```javascript
const query = 'FileName: relativ?(1~3) OR Content: (Einstein AND Albert)';
const result = index.search(query); // Search for documents whose paths contain 'relative', 'relativity', ets., or documents containing both 'Einstein' and 'Albert' in the content
```

## Phrase search query

Another type of query - a phrase search query - allows you to search entire phrases in documents. Detailed information on the phase search is on the page [Phrase search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/phrase-search.md" >}}). An example of the phrase search is presented below.

```javascript
const query = '"theory of special relativity"';
const result = index.search(query); // Search for the phrase 'theory of special relativity'
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Bulleted List in Spreadsheet Document

Path: /assembly/java/bulleted-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bulleted List in Microsoft Excel Document

### Creating a Bulleted List

Practising the following steps you can insert Bulleted List in MS Excel 2013.  
Adding a bulleted list in Microsoft Excel is different than Microsoft Word. Moreover, there are two ways to apply bulleted list in Microsoft Excel:

*   In-Cell List
*   Multiple-Cell List

Apply the following steps to build the In-Cell template

1.  Add a new Workbook.
2.  Press Insert Tab (at the top-bar).
3.  Add bullet symbol by clicking on Symbol icon.
4.  Save the Document.

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must show all the clients in a bulleted list format.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**In-Cell List**

```java
We provide support for the following clients:
<<foreach [in getClients()]>>
-          <<[getName()]>><</foreach>>
```

**Multiple-Cell List**

```java
We provide support for the following products:
<<foreach [in getClients()]>>-          <<[getName()]>>
```

close the foreach loop in next column

```java
<</foreach>>
```

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Bulleted%20List.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 3c2c2bfddda742a41fb86345a768415e >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Bulleted List in Spreadsheet Document

Path: /assembly/net/bulleted-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Spreadsheet Document based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bulleted List in Microsoft Excel Document

### Creating a Bulleted List

Practising the following steps you can insert Bulleted List in MS Excel 2013.  
Adding bulleted list in Microsoft Excel is different than Microsoft Word. Moreover, there are two ways to apply bulleted list in Microsoft Excel:

*   In-Cell List
*   Multiple-Cell List

Apply the following steps to build the In-Cell template

1.  Add a new Workbook.
2.  Press Insert Tab (at the top-bar).
3.  Add bullet symbol by clicking on Symbol icon.
4.  Save the Document.

### Reporting Requirement

As a report developer, you are required to share the information of the products with the following key requirements:

*   A report must show all the products in a bulleted list format.
*   A Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**In-Cell List**

```csharp
We provide support for the following products:
<<foreach [in products]>>
-          <<[ProductName]>><</foreach>>
```

**Multiple-Cell List**

```csharp
We provide support for the following products:
<<foreach [in products]>>-          <<[ProductName]>>
```

close the foreach loop in next column

```csharp
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Bulleted%20List.xlsx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Bulleted List\_XML.xlsx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Bulleted%20List_XML.xlsx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists ec5f7ab4cb1741cc2e33b14de6ec576c >}}



#### Database Entities

{{< gist GroupDocsGists e2848d87be2cbdb9152ff5e47d5f96a4 >}}



#### Using DataSet

{{< gist GroupDocsGists 2ee710544a43ce46cffac4a13bb80d62 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 7f5d0b98132d4e3275e3546fac0b0b41 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 376d39743cf0d06b2288644fa199cf48 >}}



## Bulleted List in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating a 'Bulleted List' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" dropdown.
4.  Click "Save".

### Download Template

*   [Bulleted List\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Bulleted%20List_OpenDocument.ods?raw=true) (use the same template for database, dataset and JSON examples)
*   [Bulleted List\_XML\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Bulleted%20List_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists cde401351d5b1ee82fdd4773703c7423 >}}



#### Database Entities

{{< gist GroupDocsGists 2766a6ab2316cb857403835d643aa655 >}}



#### Using DataSet

{{< gist GroupDocsGists 94b09f9afdac5ca6b81bd4c95a8d7f3b >}}



#### Using XML DataSource

{{< gist GroupDocsGists a5cbb073ae455ab99f66038dc7a7fa58 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 34a97e1b0ea144dda91e167ccbfc2da8 >}}



### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Case sensitive search

Path: /search/java/case-sensitive-search/

Case-sensitive search allows you to find words considering uppercase and lowercase letters as distinct. For example, words in context of case-sensitive search 'Theory', 'theory', and 'THEORY' are all different.

Note that case-sensitive search is not compatible with other types of search (see [Search flow]({{< ref "search/java/developer-guide/advanced-usage/searching/search-flow.md" >}})).

The following example demonstrates how to perform case-sensitive search with a query in text form.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
SearchOptions options = new SearchOptions();
options.setUseCaseSensitiveSearch(true); // Enabling case sensitive search
 
// Searching in the index
String query = "Windows";
SearchResult result = index.search(query, options);
```

The next example demonstrates how to perform case-sensitive search with a query in object form.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
SearchOptions options = new SearchOptions();
options.setUseCaseSensitiveSearch(true); // Enabling case sensitive search
 
// Creating search query in object form
SearchQuery query = SearchQuery.createWordQuery("Windows");
 
// Searching in the index
SearchResult result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Case sensitive search

Path: /search/net/case-sensitive-search/

Case-sensitive search allows you to find words considering uppercase and lowercase letters as distinct. For example, words in context of case-sensitive search 'Theory', 'theory', and 'THEORY' are all different.

Note that case-sensitive search is not compatible with other types of search (see [Search flow]({{< ref "search/net/developer-guide/advanced-usage/searching/search-flow.md" >}})).

The following example demonstrates how to perform case-sensitive search with a query in text form.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
Index index = new Index(indexFolder); // Creating index in the specified folder
index.Add(documentsFolder); // Indexing documents from the specified folder
 
SearchOptions options = new SearchOptions();
options.UseCaseSensitiveSearch = true; // Enabling case sensitive search
 
string query = "Windows";
SearchResult result = index.Search(query, options); // Searching
```

The next example demonstrates how to perform case-sensitive search with a query in object form.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
Index index = new Index(indexFolder); // Creating index in the specified folder
index.Add(documentsFolder); // Indexing documents from the specified folder
 
SearchOptions options = new SearchOptions();
options.UseCaseSensitiveSearch = true; // Enabling case sensitive search
 
SearchQuery query = SearchQuery.CreateWordQuery("Windows"); // Creating search query in object form
 
SearchResult result = index.Search(query, options); // Searching
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Case sensitive search

Path: /search/nodejs-java/case-sensitive-search/

Case-sensitive search allows you to find words considering uppercase and lowercase letters as distinct. For example, words in context of case-sensitive search 'Theory', 'theory', and 'THEORY' are all different.

Note that case-sensitive search is not compatible with other types of search (see [Search flow]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-flow.md" >}})).

The following example demonstrates how to perform case-sensitive search with a query in text form.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

const index = new groupdocs.search.Index(indexFolder); // Creating index in the specified folder
index.add(documentsFolder); // Indexing documents from the specified folder

const options = new groupdocs.search.SearchOptions();
options.setUseCaseSensitiveSearch(true); // Enabling case sensitive search

const query = 'Advantages';
const result = index.search(query, options); // Searching
```

The next example demonstrates how to perform case-sensitive search with a query in object form.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

const index = new groupdocs.search.Index(indexFolder); // Creating index in the specified folder
index.add(documentsFolder); // Indexing documents from the specified folder

const options = new groupdocs.search.SearchOptions();
options.setUseCaseSensitiveSearch(true); // Enabling case sensitive search

const query = groupdocs.search.SearchQuery.createWordQuery('Advantages'); // Creating search query in object form

const result = index.search(query, options); // Searching
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Character types

Path: /search/java/character-types/

This page contains descriptions of all character types. Character types differ in how characters of these types are indexed. For more information on managing the Alphabet, see the [Alphabet]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/alphabet.md" >}}) page in the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

## Regular characters

Regular characters are separators and letters. During indexing, separators are used to separate words from each other, and words are formed from continuous sequences of letters.

The type of each particular character, can be specified in the Alphabet. By default, the following characters are defined as letters (Unicode numbers are given):

*   Digits: 0030-0039;
*   Latin capital letters: 0041-005A;
*   Low line: 005F;
*   Latin small letters: 0061-007A;
*   Latin letters: 00C0-00D6, 00D8-00F6, 00F8-00FF, 0100-017F, 0180-024F, 0250-02AF;
*   Greek and Coptic letters: 0370-0373, 0376-0377, 037F, 0386, 0388-038A, 038C, 038E-03A1, 03A3-03FC;
*   Cyrillic letters: 0400-0481, 048A-04FF, 0500-052F;
*   Armenian letters: 0531-0556, 0561-0587.

The other characters are defined as separators in the Alphabet.

The following example demonstrates how to specify only numbers, low line character, and English characters as letters in the Alphabet.



```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Configuring the alphabet
// Setting the separator type for all characters in the alphabet
index.getDictionaries().getAlphabet().clear();
// Creating a list of letter characters
StringBuilder sb = new StringBuilder();
for (char i = (char)0x0030; i <= 0x0039; i++) {
    sb.append(i); // Digits
}
for (char i = (char)0x0041; i <= 0x005A; i++) {
    sb.append(i); // Latin capital letters
}
sb.append((char)0x005F); // Low line
for (char i = (char)0x0061; i <= 0x007A; i++) {
    sb.append(i); // Latin small letters
}
// Setting the type of characters in the alphabet
char[] characters = new char[sb.length()];
sb.getChars(0, sb.length() - 1, characters, 0);
index.getDictionaries().getAlphabet().setRange(characters, CharacterType.Letter);
 
// Indexing documents from the specified folder
index.add(documentFolder);
 
// Searching in the index
SearchResult result = index.search("Einstein");
```

## Blended characters

Blended characters are special characters that are indexed both as separators and as letters. This type of character can be useful, for example, for indexing hyphens. In this case, parts of a compound word containing a hyphen will be indexed both as a single word with a hyphen and individually without a hyphen. An example of using blended characters is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Setting hyphen character type to blended
index.getDictionaries().getAlphabet().setRange(new char[] { '-' }, CharacterType.Blended);
 
// Indexing documents from the specified folder
index.add(documentFolder);
 
// Searching in the index
SearchResult result1 = index.search("Elliot-Murray-Kynynmound");
SearchResult result2 = index.search("Elliot");
SearchResult result3 = index.search("Murray");
SearchResult result4 = index.search("Kynynmound");
```

## Indexing each character as a whole word

Another special type of character is character indexed as a separate word. This type of character is designed to work with hieroglyphic languages and allows you to index each character in the text as a separate word, regardless of the presence of separators.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Character types

Path: /search/net/character-types/

This page contains descriptions of all character types. Character types differ in how characters of these types are indexed. For more information on managing the Alphabet, see the [Alphabet]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/alphabet.md" >}}) page in the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

## Regular characters

Regular characters are separators and letters. During indexing, separators are used to separate words from each other, and words are formed from continuous sequences of letters.

The type of each particular character, can be specified in the Alphabet. By default, the following characters are defined as letters (Unicode numbers are given):

*   Digits: 0030-0039;
*   Latin capital letters: 0041-005A;
*   Low line: 005F;
*   Latin small letters: 0061-007A;
*   Latin letters: 00C0-00D6, 00D8-00F6, 00F8-00FF, 0100-017F, 0180-024F, 0250-02AF;
*   Greek and Coptic letters: 0370-0373, 0376-0377, 037F, 0386, 0388-038A, 038C, 038E-03A1, 03A3-03FC;
*   Cyrillic letters: 0400-0481, 048A-04FF, 0500-052F;
*   Armenian letters: 0531-0556, 0561-0587.

The other characters are defined as separators in the Alphabet.

The following example demonstrates how to specify only numbers, low line character, and English characters as letters in the Alphabet.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Configuring the alphabet
// Setting the separator type for all characters in the alphabet
index.Dictionaries.Alphabet.Clear();
// Creating a list of letter characters
List<char> list = new List<char>();
for (char i = (char)0x0030; i <= 0x0039; i++)
{
    list.Add(i); // Digits
}
for (char i = (char)0x0041; i <= 0x005A; i++)
{
    list.Add(i); // Latin capital letters
}
list.Add((char)0x005F); // Low line
for (char i = (char)0x0061; i <= 0x007A; i++)
{
    list.Add(i); // Latin small letters
}
// Setting the type of characters in the alphabet
char[] characters = list.ToArray();
index.Dictionaries.Alphabet.SetRange(characters, CharacterType.Letter);
 
// Indexing documents from the specified folder
index.Add(documentFolder);
 
// Searching in the index
SearchResult result = index.Search("Einstein");
```

## Blended characters

Blended characters are special characters that are indexed both as separators and as letters. This type of character can be useful, for example, for indexing hyphens. In this case, parts of a compound word containing a hyphen will be indexed both as a single word with a hyphen and individually without a hyphen. An example of using blended characters is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Setting hyphen character type to blended
index.Dictionaries.Alphabet.SetRange(new char[] { '-' }, CharacterType.Blended);
 
// Indexing documents from the specified folder
index.Add(documentFolder);
 
// Searching in the index
SearchResult result1 = index.Search("Elliot-Murray-Kynynmound");
SearchResult result2 = index.Search("Elliot");
SearchResult result3 = index.Search("Murray");
SearchResult result4 = index.Search("Kynynmound");
```

## Indexing each character as a whole word

Another special type of character is character indexed as a separate word. This type of character is designed to work with hieroglyphic languages and allows you to index each character in the text as a separate word, regardless of the presence of separators.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Character types

Path: /search/nodejs-java/character-types/

This page contains descriptions of all character types. Character types differ in how characters of these types are indexed. For more information on managing the Alphabet, see the [Alphabet]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/alphabet.md" >}}) page in the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

## Regular characters

Regular characters are separators and letters. During indexing, separators are used to separate words from each other, and words are formed from continuous sequences of letters.

The type of each particular character, can be specified in the Alphabet. By default, the following characters are defined as letters (Unicode numbers are given):

*   Digits: 0030-0039;
*   Latin capital letters: 0041-005A;
*   Low line: 005F;
*   Latin small letters: 0061-007A;
*   Latin letters: 00C0-00D6, 00D8-00F6, 00F8-00FF, 0100-017F, 0180-024F, 0250-02AF;
*   Greek and Coptic letters: 0370-0373, 0376-0377, 037F, 0386, 0388-038A, 038C, 038E-03A1, 03A3-03FC;
*   Cyrillic letters: 0400-0481, 048A-04FF, 0500-052F;
*   Armenian letters: 0531-0556, 0561-0587.

The other characters are defined as separators in the Alphabet.

The following example demonstrates how to specify only numbers, low line character, and English characters as letters in the Alphabet.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Configuring the alphabet
// Setting the separator type for all characters in the alphabet
index.getDictionaries().getAlphabet().clear();
// Creating a list of letter characters
let sb = '';
for (let i = 0x0030; i <= 0x0039; i++) {
  sb += String.fromCharCode(i); // Digits
}
for (let i = 0x0041; i <= 0x005a; i++) {
  sb += String.fromCharCode(i); // Latin capital letters
}
sb += String.fromCharCode(0x005f); // Low line
for (let i = 0x0061; i <= 0x007a; i++) {
  sb += String.fromCharCode(i); // Latin small letters
}
// Setting the type of characters in the alphabet
const characters = java.newArray('char', sb.split(''));
index.getDictionaries().getAlphabet().setRange(characters, groupdocs.search.CharacterType.Letter);

// Indexing documents from the specified folder
index.add(documentFolder);

// Searching in the index
const query = 'Einstein';
const result = index.search(query);
```

## Blended characters

Blended characters are special characters that are indexed both as separators and as letters. This type of character can be useful, for example, for indexing hyphens. In this case, parts of a compound word containing a hyphen will be indexed both as a single word with a hyphen and individually without a hyphen. An example of using blended characters is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Setting hyphen character type to blended
const characters = java.newArray('char', '-'.split(''));
index.getDictionaries().getAlphabet().setRange(characters, groupdocs.search.CharacterType.Blended);

// Indexing documents from the specified folder
index.add(documentFolder);

// Searching in the index
const query1 = 'Elliot-Murray-Kynynmound';
const result1 = index.search(query1);
const query2 = 'Elliot';
const result2 = index.search(query2);
const query3 = 'Murray';
const result3 = index.search(query3);
const query4 = 'Kynynmound';
const result4 = index.search(query4);
```

## Indexing each character as a whole word

Another special type of character is character indexed as a separate word. This type of character is designed to work with hieroglyphic languages and allows you to index each character in the text as a separate word, regardless of the presence of separators.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Chart Series Coloring in Presentation Document

Path: /assembly/java/chart-series-coloring-in-presentation-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Presentation Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in  MS PowerPoint 2013:

1.  Create a new presentation slide
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.dynabic.com/display/assemblynet/Column+Chart+in+Presentation+Document#ColumnChartinPresentationDocument-ChartData(Excel))
6.  Save your Document

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The report must be generated in the Presentation Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Chart Data (Excel)

|   | Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>> |
| --- | --- |
| Category 1 | 4.3 |
| Category 2 | 2.5 |
| Category 3 | 3.5 |
| Category 4 | 4.5 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Dynamic%20Chart%20Series%20Color.pptx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```java
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report: 

{{< gist GroupDocsGists 32fec736330c5a07fa3a8d680dc1598a >}}



---

## Chart Series Coloring in Presentation Document

Path: /assembly/net/chart-series-coloring-in-presentation-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Presentation Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in  MS PowerPoint 2013:

1.  Create a new presentation slide
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/chart-series-coloring-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save your Document

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The report must be generated in the Presentation Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Chart Data (Excel)

|   | Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>> |
| --- | --- |
| Category 1 | 4.3 |
| Category 2 | 2.5 |
| Category 3 | 3.5 |
| Category 4 | 4.5 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Dynamic%20Chart%20Series%20Color.pptx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```csharp
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report: 

{{< gist GroupDocsGists de43d6f3fe81df28b528718fbceaff7d >}}



---

## Check document password-protection

Path: /merger/java/check-document-password-protection/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to check document for password-protection. The result will be **true** if document has password for opening set, in other case **false** will be returned.

Here are the steps to check document password-protection:

*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [isPasswordSet](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#isPasswordSet()) method.

The following code sample demonstrates how to check document password-protection.

```java
boolean isPasswordSet = false;
String filePath = "C:\sample.xlsx";

Merger merger = new Merger(filePath);        
isPasswordSet = merger.isPasswordSet();
```

---

## Classify document by path

Path: /classification/net/classify-document-by-path/

### Classify document by path with IAB-2 taxonomy and return 2 best results

Classifying of the document could be performed with the next steps

*   Call **[Classify](https://reference.groupdocs.com/net/classification/groupdocs.classification.classifier/classify/methods/2)** method for "document.pdf" file in the current (".") directory with IAB-2 taxonomy and return 2 best results.
*   Handle possible ApiException

```csharp
try
{
    var response = classifier.Classify("document.pdf", ".", 3, Taxonomy.Iab2);
    Console.WriteLine(response.BestClassName, response.BestClassProbability);
}
catch (ApiException e)
{
    Console.WriteLine(e.Message);
}
```

### Precisely classify document by path with Documents taxonomy and return 4 best results

*   Call **[Classify](https://reference.groupdocs.com/net/classification/groupdocs.classification.classifier/classify/methods/2)** method for "document.doc" file in the current (".") directory with Documents taxonomy, set precision/recall balance to "Precision" and return 4 best results.
*   Handle possible ApiException
    

```csharp
try
{
    var response = classifier.Classify("document.doc", ".", 4, Taxonomy.Documents, PrecisionRecallBalance.Precision);
    Console.WriteLine(response.BestClassName, response.BestClassProbability);
}
catch (ApiException e)
{
    Console.WriteLine(e.Message);
}
```

### Classify password-protected document

Classifying of the password-protected document could be performed with the next step

*   Call **[Classify](https://reference.groupdocs.com/net/classification/groupdocs.classification.classifier/classify/methods/2)** method for "document.doc" file in the current (".") directory with password parameter.
*   Handle possible ApiException

```csharp
try
{
    response = classifier.Classify("password-protected.docx", dataFolderPath, password: "password");
    Console.WriteLine(response.BestClassName, response.BestClassProbability);
}
catch (ApiException e)
{
    Console.WriteLine(e.Message);
}
```

---

## Column Chart in Spreadsheet Document

Path: /assembly/java/column-chart-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Column Chart Report with Filtered, Ordered and Grouped Data in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft Excel Document

### Creating a Column Chart

Following below steps, you can create column chart in MS Excel 2013:

1.  Create a new Workbook.
2.  Click the "Insert" tab, and then click "Insert Column Chart" icon in the Charts group to view the drop-down list.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your Worksheet.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data](https://docs.groupdocs.com/assembly/java/column-chart-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must show total Contract Prices by Quarters
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Quarters<<foreach [in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x [key.getName()]>>
```

#### Chart Data

**Legend Entries**

```java
="1st Quarter<<y [where(c => c.getDate().getMonth() >= 0 && c.getDate().getMonth() <= 2).sum(c => c.getPrice())]>>"
="2nd Quarter<<y [where(c => c.getDate().getMonth() >= 3 && c.getDate().getMonth() <= 5).sum(c => c.getPrice())]>>"
="3rd Quarter<<y [where(c => c.getDate().getMonth() >= 6 && c.getDate().getMonth() <= 8).sum(c => c.getPrice())]>>"
="4th Quarter<<y [where(c => c.getDate().getMonth() >= 9 && c.getDate().getMonth() <= 11).sum(c => c.getPrice())]>>"
```

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 90f1cfd555c77ca915ba4284903bc892 >}}

## Column Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Column Chart in Spreadsheet Document

Path: /assembly/net/column-chart-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Column Chart Report with Filtered, Ordered and Grouped Data in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft Excel Document

### Creating a Column Chart

Following below steps, you can create a column chart in MS Excel 2013:

1.  Create a new Workbook.
2.  Click the "Insert" tab, and then click "Insert Column Chart" icon in the Charts group to view the drop-down list.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your Worksheet.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data](https://docs.groupdocs.com/assembly/net/column-chart-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must show the quantity of sales/orders.
*   Sales/orders quantity must represented by Quarters.
*   It must associate order quantity with the corresponding customer.
*   A report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Quantity by Quarters<<foreach [in orders
.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>><<x [Key.CustomerName]>>

```

#### Chart Data

**Legend Entries**

```csharp
="1st Quarter<<y [Where(c => c.OrderDate.Month >= 1 && c.OrderDate.Month <= 3).Sum(c => c.ProductQuantity)]>>"
="2nd Quarter<<y [Where(c => c.OrderDate.Month >= 4 && c.OrderDate.Month <= 6).Sum(c => c.ProductQuantity)]>>"
="3rd Quarter<<y [Where(c => c.OrderDate.Month >= 7 && c.OrderDate.Month <= 9).Sum(c => c.ProductQuantity)]>>"
="4th Quarter<<y [Where(c => c.OrderDate.Month >= 10 && c.OrderDate.Month <= 12).Sum(c => c.ProductQuantity)]>>"

```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.xlsx?raw=true) (Template for CustomObject and JSON examples) 
*   [Chart Template\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB.xlsx?raw=true) (Template for DataSet, DataBase examples)
*   [Chart Template\_XML.xlsx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML.xlsx?raw=true) (Template for XML examples) 

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 2617acf16e4c9ab06ebc84b5be9c16b3 >}}



#### Database Entities

{{< gist GroupDocsGists a7b411f1f03bb75b071a2603f153fade >}}



#### Using DataSet

{{< gist GroupDocsGists 188f8d564c951ce7aafa24077e429d75 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 12e4c899cf368461f801f0b3fe936496 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 03f52003d74ce0002c880de8c90fcd91 >}}



## Column Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Common List Image in Spreadsheet Document

Path: /assembly/java/common-list-image-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List Image report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common List in Microsoft Excel Document

### Creating a Common List

Please follow below steps to create Common List Image in MS Excel 2013:

1.  Insert the desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show multiple managers' picture and name.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<<foreach [in getManagers()]>>
<table class="gd-assembly1"cellspacing="0" cellpadding="0" style="border-collapse: collapse; float: bottom; margin-top: 0pt; margin-right: 9pt; margin-bottom: 0pt; margin-left: 9pt; width: 132.15pt; height: 132.15pt ">
	<tbody>
		<tr>
			<td style="vertical-align: top;">&lt;&lt;image [getPhoto()]>></td>
		</tr>
	</tbody>
</table>
<<[getName()]>> <</foreach>>

### Download Template

Please download the sample Common List document we created in this article:

*   [Common List.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Common%20List.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists aaa7f940daf32fbedc127e02ed97f261 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.

*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common List Image in Spreadsheet Document

Path: /assembly/net/common-list-image-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List Image report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Common List in Microsoft Excel Document

### Creating a Common List

Please follow below steps to create Common List Image in MS Excel 2013:

1.  Insert the desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers with the following key requirements:

*   A report must show multiple customers' picture and name.
*   A report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 157.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;"> [in customers]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td rowspan="8" style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 157.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;image[</span><span style="font-family: Calibri; font-size: 11pt;">customer.Photo</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: separate; border-spacing: 0pt 0pt; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="vertical-align: bottom; width: 48pt;"><p style="font-size: 11pt; line-height: 115%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 10pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 38pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr style="height: 21pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 157.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">CustomerName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td colspan="2" style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 86.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 167.95pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 48.8pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 48.8pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Template

Please download the sample Common List document we created in this article:

*   [Common List.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Common%20List.xlsx?raw=true)  
      
  

{{< alert style="warning" >}}Use this template for DB, Dataset, JSON and XML examples also.{{< /alert >}}

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 61b7ef367448939a22a331a2c0f02104 >}}



#### Database Entities

{{< gist GroupDocsGists ca757f6e527074304975539085c97d71 >}}



#### Using DataSet

{{< gist GroupDocsGists ba23d22ea6d5974310332d151a38052b >}}



#### Using XML DataSource

{{< gist GroupDocsGists c6b54d575215383cb14bfd24d61e8299 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 8b80257cfc9ea9b8f680c4ff71d55e3a >}}



## Common List in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit wikipedia article.

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Common List' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Common List\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Common%20List_OpenDocument.ods?raw=true) (use same template for database, dataset, JSON and XML examples)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 20adab96f78b0cdd5d4616037ae5607b >}}



#### Database Entities

{{< gist GroupDocsGists d6ad2d0a107946ea2f2772f37a288c77 >}}



#### Using DataSet

{{< gist GroupDocsGists b1e0c37686d47e0ccc502f35bff0bb19 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 0d1552e1c082592f11351ce60d827ac4 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 2d9d6a44ec97e7b7e68d273109c13275 >}}



### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.

*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common Master-Detail Image in Spreadsheet Document

Path: /assembly/java/common-master-detail-image-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail Image report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common Master-Detail Image in Microsoft Excel Document

### Creating a Common Master-Detail Image

Please follow below steps to create Common Master-Detail Image Template in MS Excel 2013:

1.  Create a new Workbook.
2.  Insert a shape to display image in it.
3.  Go to Insert Tab and select shape by clicking on Shape Icon.
4.  Save the document.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers and clients with the following key requirements:

*   Report must show managers' picture and name.
*   It must associate the managers with their clients.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
<<foreach [in getManagers()]>>
>" style="outline: 0px !important;">
<<[getName()]>>
Clients: <<foreach [in getContracts()]>><<[indexOf() != 0 ? ", " : ""]>><<[getClient().getName()]>><</foreach>>
<</foreach>>
```

### Download Common Master-DetailTemplate

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Common%20Master-Detail.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 4b830352e9eb0a5ca52a2576173f64e6 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common Master-Detail Image in Spreadsheet Document

Path: /assembly/net/common-master-detail-image-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail Image report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Common Master-Detail Image in Microsoft Excel Document

### Creating a Common Master-Detail Image

Please follow below steps to create Common Master-Detail Image Template in MS Excel 2013:

1.  Create a new Workbook.
2.  Insert a shape to display image in it.
3.  Go to Insert Tab and select shape by clicking on Shape Icon.
4.  Save the document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and products with the following key requirements:

*   Report must show customers' picture and name.
*   It must associate the customers with their products.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

&lt;&lt;foreach \[in customers\]>>

<table class="gd-assembly1"cellspacing="0" cellpadding="0" style="border-collapse: collapse; float: bottom; margin-top: 0pt; margin-right: 9pt; margin-bottom: 0pt; margin-left: 9pt; width: 132.15pt; height: 132.15pt ">
	<tbody>
		<tr>
			<td style="vertical-align: top;">&lt;&lt;image [customer.Photo]>></td>
		</tr>
	</tbody>
</table>

**&lt;&lt;[CustomerName]>>**

**Clients: &lt;&lt;foreach [in Order]>>&lt;&lt;[IndexOf() != 0 ? ", " : ""]>>&lt;&lt;[Product.ProductName]>>&lt;&lt;/foreach>>**

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Common Master-DetailTemplate

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Common%20Master-Detail.xlsx?raw=true) (Template for CustomObject and JSON examples)
*   [Common Master-Detail\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Common%20Master-Detail_DB.xlsx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists d975e0dedc5f473afb719f3775cc6c8e >}}

#### Database Entities

{{< gist GroupDocsGists fcc7a15dfd4db8f43f0e6110dd34c8c8 >}}

#### Using DataSet

{{< gist GroupDocsGists 4207c6e947d0ddd568e1a245f33a0990 >}}

#### Using XML DataSource

{{< gist GroupDocsGists fad61412f602a116a5b473d46e659c67 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 76715602bb202e81dcb316d1d58b9949 >}}

## Common Master-Detail in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit wikipedia article.

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Common Master-Detail' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Common Master-Detail\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Common%20Master-Detail_OpenDocument.ods?raw=true) (use same template for JSON examples)
*   [Common Master-Detail\_DB\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Common%20Master-Detail_DB_OpenDocument.ods?raw=true) (use same template for database and dataset and XML examples)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 10f4b7f883ebd432815e3069527736a6 >}}

#### Database Entities

{{< gist GroupDocsGists fb728a436de90b71847f7fc5b5e3d7fa >}}

#### Using DataSet

{{< gist GroupDocsGists 05ac56a212793baa1eb02726a416483e >}}

#### Using XML DataSource

{{< gist GroupDocsGists f9e1ee9f348b65659cb3d6b3882618a9 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 751ec891d4d35bd044f0d55c904ee60e >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Compare multiple documents with specific compare settings

Path: /comparison/java/compare-multiple-documents-with-specific-compare-settings/


{{< alert style="info" >}}This feature available for Microsoft Word documents, Microsoft PowerPoint, and Open Document presentations only.{{< /alert >}}

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare more than two documents and specify specific comparison options like styling for detected changes, comparison detalization level, etc.

To compare multiple documents using the specific options, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2. Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method and specify the target document path or stream. Repeat this step for every target document.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object and specify the appropriate options.
4.  Call the [compare](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-com.groupdocs.comparison.options.CompareOptions-) method. Specify the pass [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippets show how to compare multiple documents with the appropriate options:

## Compare multiple documents with specific compare settings from local disk

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.style.StyleSettings;
import java.awt.*;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    comparer.add("target2.docx");
    comparer.add("target3.docx");

    final StyleSettings styleSettings = new StyleSettings();
    styleSettings.setFontColor(Color.YELLOW);

    CompareOptions compareOptions = new CompareOptions();
    compareOptions.setInsertedItemStyle(styleSettings);

    final Path resultPath = comparer.compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/compare-multiple-settings.png)

## Compare multiple documents with specific compare settings from stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.style.StyleSettings;
import java.awt.*;
import java.nio.file.Path;
import java.io.FileInputStream;
import java.io.InputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream)) {
    comparer.add(targetInputStream1);
    comparer.add(targetInputStream2);
    comparer.add(targetInputStream3);

    final StyleSettings styleSettings = new StyleSettings();
    styleSettings.setFontColor(Color.YELLOW);

    CompareOptions compareOptions = new CompareOptions();
    compareOptions.setInsertedItemStyle(styleSettings);

    final Path resultPath = comparer.compare(resultInputStream, compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Compare multiple documents with specific compare settings

Path: /comparison/net/compare-multiple-documents-with-specific-compare-settings/


{{< alert style="info" >}}This feature available for Microsoft Word documents, Microsoft PowerPoint, and Open Document presentations only.{{< /alert >}}

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare more than two documents and specify specific comparison options like styling for detected changes, comparison detalization level, etc.

To compare multiple documents using the specific options, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2. Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method and specify the target document path or stream. Repeat this step for every target document.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object and specify the appropriate options.
4.  Call the [Compare](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/compare#compare_8) method. Specify the pass [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippets show how to compare multiple documents with the appropriate options:

## Compare multiple documents with specific compare settings from local disk

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target1.docx");
    comparer.Add("target2.docx");
    comparer.Add("target3.docx");
    CompareOptions compareOptions = new CompareOptions()
    {
        InsertedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Yellow
        }
    };
    comparer.Compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/compare-multiple-settings.png)

## Compare multiple documents with specific compare settings from stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer(File.OpenRead("source.docx")))
{
    comparer.Add(File.OpenRead("target1.docx"));
    comparer.Add(File.OpenRead("target2.docx"));
    comparer.Add(File.OpenRead("target3.docx"));
    CompareOptions compareOptions = new CompareOptions()
    {
        InsertedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Yellow
        }
    };
    comparer.Compare(File.Create("result.docx"), compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Compare multiple documents with specific compare settings

Path: /comparison/nodejs-java/compare-multiple-documents-with-specific-compare-settings/


{{< alert style="info" >}}This feature is available for Microsoft Word documents, Microsoft PowerPoint, and Open Document presentations only.{{< /alert >}}

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare more than two documents and specify specific comparison options like styling for detected changes, comparison sensitivity level, etc.

The following code snippets show how to compare multiple documents with the appropriate options.

## Compare multiple documents with specific compare settings from a local disk

The following example compares four DOCX documents and highlights all inserted content with a custom font color.

```javascript
'use strict';

// Import GroupDocs.Comparison for Node.js via Java and Java Color utilities
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
const Color = java.import('java.awt.Color');

// Define file paths for the source and three target documents
const sourceFile = 'sample-files/source.docx';
const targetFile1 = 'sample-files/target.docx';
const targetFile2 = 'sample-files/target2.docx';
const targetFile3 = 'sample-files/target3.docx';
const resultFile = 'output/result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add multiple target documents to the comparison set
comparer.add(targetFile1);
comparer.add(targetFile2);
comparer.add(targetFile3);

// Configure visual style for inserted items (e.g., new content in targets)
const styleSettings = new groupdocs.StyleSettings();
styleSettings.setFontColor(Color.YELLOW); // render inserted text in yellow

// Attach style settings to comparison options
const compareOptions = new groupdocs.CompareOptions();
compareOptions.setInsertedItemStyle(styleSettings);

// Run the comparison and save the result document with styled changes
comparer.compare(resultFile, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example:

1. Instantiates the `Comparer` with the source document path.
2. Adds several target documents using the `add()` method.
3. Creates a `CompareOptions` instance and configures `StyleSettings` for inserted items (for example, changing font color).
4. Calls `compare()` with the result path and options to produce an output document that highlights changes according to the specified styles.

The result is as follows:

![](/comparison/nodejs-java/images/compare-multiple-settings.png)

## Compare multiple documents with specific compare settings from a stream

The following example performs the same multi-document comparison using Java input streams instead of direct file paths.

```javascript
'use strict';

// Import GroupDocs.Comparison for Node.js via Java plus Java stream/color classes
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
let InputStream = java.import('java.io.FileInputStream');
let Color = java.import('java.awt.Color');

// Create input streams for the source document and three target documents
const sourceInputStream = new InputStream('sample-files/source.docx');
const targetInputStream1 = new InputStream('sample-files/target.docx');
const targetInputStream2 = new InputStream('sample-files/target2.docx');
const targetInputStream3 = new InputStream('sample-files/target3.docx');

// Initialize the comparer with the source document stream
const comparer = new groupdocs.Comparer(sourceInputStream);

// Add each target document to the comparison list
comparer.add(targetInputStream1);
comparer.add(targetInputStream2);
comparer.add(targetInputStream3);

// Set up style settings for inserted items (e.g., highlight color)
const styleSettings = new groupdocs.StyleSettings();
styleSettings.setFontColor(Color.YELLOW); // use yellow font color for inserted text

// Configure compare options to use the defined style for inserted items
const compareOptions = new groupdocs.CompareOptions();
compareOptions.setInsertedItemStyle(styleSettings);

// Define the output path where the comparison result will be saved
const resultPath = 'result.docx';

// Execute the comparison and generate the result document
comparer.compare(resultPath, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

In the stream-based variant:

1. The `Comparer` is initialized with a source document input stream.
2. Target documents are provided as input streams via multiple calls to `add()`.
3. A `CompareOptions` object is created and linked with `StyleSettings` to format inserted items.
4. The `compare()` method is invoked with the destination path and options to generate a combined comparison result.

---

## Compare multiple documents with specific compare settings

Path: /comparison/python-net/compare-multiple-documents-with-specific-compare-settings/


Note: This feature applies to Microsoft Word documents, Microsoft PowerPoint, and OpenDocument presentations.

## Compare multiple documents (disk)

Add several targets and set styling for inserted items.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target1.docx")
    comparer.add("target2.docx")
    comparer.add("target3.docx")
    options = gc.CompareOptions()
    options.inserted_item_style = gc.StyleSettings(font_color=gc.Color.from_name("yellow"))
    comparer.compare("result.docx", options)
```

🔹 Use case: Aggregate changes across multiple proposal iterations into a single consolidated diff.

## Compare multiple documents (streams)

Perform the same operation using streams.

```python
import groupdocs.comparison as gc

with open("source.docx", "rb") as src,
     open("target1.docx", "rb") as t1,
     open("target2.docx", "rb") as t2,
     open("target3.docx", "rb") as t3:
    with gc.Comparer(src) as comparer:
        comparer.add(t1)
        comparer.add(t2)
        comparer.add(t3)
        options = gc.CompareOptions()
        options.inserted_item_style = gc.StyleSettings(font_color=gc.Color.from_name("yellow"))
        with open("result.docx", "wb") as out_stream:
            comparer.compare(out_stream, options)
```

🔹 Use case: Compare multiple contributions uploaded via API without persisting intermediate files.



---

## Compare Word documents

Path: /comparison/python-net/compare-word-documents/


# Compare Word documents in Python

[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) allows developers to easily **compare Word documents** and detect differences in text, formatting, styles, and structure.  
This is useful for legal contracts, business reports, and collaborative editing workflows where accurate change tracking is essential.

With the API, you can:

- Compare **DOC and DOCX files**  
- Highlight insertions, deletions, and formatting changes  
- Export results as a Word document or another supported format  

## How to compare Word documents in Python

To compare Word files, follow these steps:

1. Create an instance of the `Comparer` class and load the source Word document.  
2. Add one or more target Word documents.  
3. Call the `compare()` method to generate the result file.  

## Example: Compare Word documents

```python
import groupdocs.comparison as gc

source_path = "source.docx"
target_path = "target.docx"
result_path = "result.docx"

# Initialize the comparer with the source Word document
with gc.Comparer(source_path) as comparer:

    # Add the target Word document
    comparer.add(target_path)

    # Compare and save the results
    comparer.compare(result_path)
```
---

## Composing signature with radial gradient brush background

Path: /signature/java/composing-signature-with-radial-gradient-brush-background/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [RadialGradientBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/RadialGradientBrush) class to specify filling signature background with radial gradients

 Here are the steps to use Radial gradient brush with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate the [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) object with all required additional options and setup [Background.setBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/Background#setBrush(com.groupdocs.signature.domain.extensions.Brush)) property with instance of  [RadialGradientBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/RadialGradientBrush)  
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) to it.
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed. 

This example shows how to use Radial gradient brush for signature background. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
Signature signature = new Signature("sample.pdf");
TextSignOptions options = new TextSignOptions("John Smith")
 
// adjust signature appearance brush
 
// setup background                
Background background = new Background();
background.setColor(Color.GREEN);
background.setTransparency(0.5);
background.setBrush(new RadialGradientBrush(Color.GREEN, Color.WHITE));
options.setBackground(background);                
 
// locate signature
options.setWidth(100);
options.setHeight(80);
options.setVerticalAlignment(VerticalAlignment.Center);
options.setHorizontalAlignment(HorizontalAlignment.Center);
Padding padding = new Padding();
padding.setTop(20);
padding.setRight(20);
options.setMargin(padding);
 
// set alternative signature implementation on document page
options.setSignatureImplementation(TextSignatureImplementation.Image);
 
// sign document to file
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Convert a Document to Another Format

Path: /conversion/python-net/developer-guide/converting-documents/convert-document-to-another-format/


This documentation topic covers the conversion of a single document to another format, where only one document is produced as output. The following diagram illustrates the process of converting a file from one format to another:

{{< mermaid class="text-center" >}}
flowchart LR
    %% Nodes
    A["Input Document (e.g. DOCX)"]
    B["Conversion"]
    C["Converted Document (e.g. PDF)"]

    %% Edge connections between nodes
    A --> B --> C
{{< /mermaid >}}

To convert and save a document, use the following `Converter` class methods:

- **`convert(file_path, convert_options)`**: Converts a document to a specified single output format and saves it to a file, such as converting a DOCX to PDF.
- **`convert(stream, convert_options)`**: Converts the document and writes it to a provided stream instead of a file path.

## Convert a Complete Document 

The following list of `ConvertOptions` classes can be used to convert a document to a specific single output format:

- **PdfConvertOptions** – Options for converting to [PDF]({{< ref "conversion/python-net/supported-file-formats#pdf" >}}) format.
- **WordProcessingConvertOptions** – Options for converting to [Word Processing]({{< ref "conversion/python-net/supported-file-formats#word-processing" >}}) formats.
- **SpreadsheetConvertOptions** – Options for converting to [Spreadsheet]({{< ref "conversion/python-net/supported-file-formats#spreadsheet" >}}) formats.
- **PresentationConvertOptions** – Options for converting to [Presentation]({{< ref "conversion/python-net/supported-file-formats#presentation" >}}) formats.
- **ImageConvertOptions** – Options for converting to [Image]({{< ref "conversion/python-net/supported-file-formats#image" >}}) formats (e.g., PNG, JPEG).
- **WebConvertOptions** – Options for converting to [Web]({{< ref "conversion/python-net/supported-file-formats#web" >}}) formats (e.g., HTML).
- **PageDescriptionLanguageConvertOptions** – Options for converting to [Page Description Language]({{< ref "conversion/python-net/supported-file-formats#page-description-language" >}}) formats (e.g., PostScript).
- **EBookConvertOptions** – Options for converting to [EBook]({{< ref "conversion/python-net/supported-file-formats#ebook" >}}) formats (e.g., EPUB, MOBI).
- **EmailConvertOptions** – Options for converting to [Email]({{< ref "conversion/python-net/supported-file-formats#email-and-outlook" >}}) formats (e.g., EML, MSG).
- **DiagramConvertOptions** – Options for converting to [Diagram]({{< ref "conversion/python-net/supported-file-formats#diagram" >}}) formats (e.g., VSDX).
- **CadConvertOptions** – Options for converting to [CAD]({{< ref "conversion/python-net/supported-file-formats#cad" >}}) formats (e.g., DWG).
- **ThreeDConvertOptions** – Options for converting to [3D]({{< ref "conversion/python-net/supported-file-formats#3d" >}}) formats.
- **ProjectManagementConvertOptions** – Options for converting to [Project Management]({{< ref "conversion/python-net/supported-file-formats#project-management" >}}) formats (e.g., MPP).
- **GisConvertOptions** – Options for converting to [GIS]({{< ref "conversion/python-net/supported-file-formats#gis" >}}) formats.
- **FontConvertOptions** – Options for converting to [Font]({{< ref "conversion/python-net/supported-file-formats#font" >}}) formats (e.g., TTF, OTF).
- **FinanceConvertOptions** – Options for converting to [Finance]({{< ref "conversion/python-net/supported-file-formats#finance" >}}) formats (e.g., XBRL).
- **CompressionConvertOptions** – Options for converting to [Compression]({{< ref "conversion/python-net/supported-file-formats#compression" >}}) formats (e.g., ZIP).
- **NoConvertOptions** – A special option class that instructs the converter to copy the source document without any modifications.

### Example 1: Convert a Document to Another Format

The following example demonstrates how to convert a DOCX file to PDF:

{{< tabs "example-1">}}
{{< tab "convert_document_to_another_format.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_document_to_another_format():
    # Instantiate Converter with the input document 
    with Converter("./business-plan.docx") as converter:
        # Instantiate convert options to define the output format
        pdf_convert_options = PdfConvertOptions()
        
        # Convert the input document to PDF
        converter.convert("./business-plan.pdf", pdf_convert_options)    

if __name__ == "__main__":
    convert_document_to_another_format()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is the expected output PDF file. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Example 2: Specify Output Format

By default, each of the `ConvertOptions` classes has its own default target format. For example, the default output format for [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/python-net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/) is [DOCX](https://reference.groupdocs.com/conversion/python-net/groupdocs.conversion.filetypes/wordprocessingfiletype/docx/).

To set a different output format within the format family, use the `format` property. The following example demonstrates how to specify the target format as `TXT` when converting a `DOCX` file:

{{< tabs "example-2">}}
{{< tab "specify_output_format.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import WordProcessingConvertOptions
from groupdocs.conversion.filetypes import WordProcessingFileType

def specify_output_format():
    # Instantiate Converter with the input document 
    with Converter("./business-plan.docx") as converter:
        # Instantiate convert options to define the output format, by default it is DOCX
        word_convert_options = WordProcessingConvertOptions()
        # Change the output format within the format family from DOCX to TXT
        word_convert_options.format = WordProcessingFileType.TXT
        
        # Convert the input document to TXT
        converter.convert("./business-plan.txt", word_convert_options)    

if __name__ == "__main__":
    specify_output_format()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.txt" >}}  
{{< tab-text >}}
`business-plan.txt` is the expected output TXT file. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/business-plan.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify Document Pages to Convert

{{< alert style="tip" >}} Find out how to get the number of document pages in the [Getting Document Information]({{< ref "conversion/python-net/developer-guide/getting-document-info#example-1-get-basic-document-info" >}}) documentation topic. {{< /alert >}}

To convert specific document pages, you can use the following `ConvertOptions` classes, which provide `pages`, `page_number`, and `pages_count` attributes. These options allow you to specify individual pages or a range of pages to convert.

- **PdfConvertOptions** – Options for converting to [PDF]({{< ref "conversion/python-net/supported-file-formats#pdf" >}}) format.
- **ImageConvertOptions** – Options for converting to [Image]({{< ref "conversion/python-net/supported-file-formats#image" >}}) formats (e.g., PNG, JPEG).
- **WordProcessingConvertOptions** – Options for converting to [Word Processing]({{< ref "conversion/python-net/supported-file-formats#word-processing" >}}) formats.
- **SpreadsheetConvertOptions** – Options for converting to [Spreadsheet]({{< ref "conversion/python-net/supported-file-formats#spreadsheet" >}}) formats.
- **PresentationConvertOptions** – Options for converting to [Presentation]({{< ref "conversion/python-net/supported-file-formats#presentation" >}}) formats.
- **WebConvertOptions** – Options for converting to [Web]({{< ref "conversion/python-net/supported-file-formats#web" >}}) formats (e.g., HTML).
- **EBookConvertOptions** – Options for converting to [EBook]({{< ref "conversion/python-net/supported-file-formats#ebook" >}}) formats (e.g., EPUB, MOBI).
- **DiagramConvertOptions** – Options for converting to [Diagram]({{< ref "conversion/python-net/supported-file-formats#diagram" >}}) formats (e.g., VSDX).
- **PageDescriptionLanguageConvertOptions** – Options for converting to [Page Description Language]({{< ref "conversion/python-net/supported-file-formats#page-description-language" >}}) formats (e.g., PostScript).
- **CadConvertOptions** – Options for converting to [CAD]({{< ref "conversion/python-net/supported-file-formats#cad" >}}) formats (e.g., DWG).
- **ThreeDConvertOptions** – Options for converting to [3D]({{< ref "conversion/python-net/supported-file-formats#3d" >}}) formats.
- **FinanceConvertOptions** – Options for converting to [Finance]({{< ref "conversion/python-net/supported-file-formats#finance" >}}) formats (e.g., XBRL).

### Example 1: Convert Specific Document Pages to Another Format

You can specify which document pages you would like to convert, as shown in the following example:

{{< tabs "example-3">}}
{{< tab "convert_specific_document_pages.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_specific_document_pages():
    # Instantiate Converter with the input document 
    with Converter("./business-plan.docx") as converter:
        # Instantiate convert options to define the output format
        pdf_convert_options = PdfConvertOptions()
        # Specify which document pages to convert
        pdf_convert_options.pages = [1, 3, 5]

        # Convert the specified pages of the input document to PDF
        converter.convert("./pages-1-3-5.pdf", pdf_convert_options)    

if __name__ == "__main__":
    convert_specific_document_pages()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "pages-1-3-5.pdf" >}}  
{{< tab-text >}}
`pages-1-3-5.pdf` is the expected output PDF file. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/pages-1-3-5.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Example 2: Convert N Consecutive Pages

As an alternative, you can specify a number of consecutive pages to convert, as shown in the following example:

{{< tabs "example-4">}}
{{< tab "convert_consecutive_document_pages.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_consecutive_document_pages():
    # Instantiate Converter with the input document 
    with Converter("./business-plan.docx") as converter:
        # Instantiate convert options to define the output format
        pdf_convert_options = PdfConvertOptions()
        # Specify the starting page and number of pages to convert
        pdf_convert_options.page_number = 1
        pdf_convert_options.pages_count = 5

        # Convert the specified range of pages in the document to PDF
        converter.convert("./pages-1-through-5.pdf", pdf_convert_options)    

if __name__ == "__main__":
    convert_consecutive_document_pages()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "pages-1-through-5.pdf" >}}  
{{< tab-text >}}
pages-1-through-5.pdf` is the expected output PDF file. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-another-format/pages-1-through-5.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}



---

## Convert each email attachment to different format

Path: /conversion/java/convert-each-email-attachment-to-different-format/

To convert each attachment within an email to a different format using [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/), you can utilize the [EmailLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/emailloadoptions/) class. This class provides various properties to customize the loading and conversion of email documents.

The following code snippet shows how to convert each attachment to a different format based on attachment type:

{{< tabs "code-example">}}
{{< tab "ConvertEachEmailAttachmentToDifferentFormat.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.ConvertOptionsProvider;
import com.groupdocs.conversion.contracts.LoadOptionsProvider;
import com.groupdocs.conversion.contracts.SaveDocumentStreamForFileType;
import com.groupdocs.conversion.filetypes.EmailFileType;
import com.groupdocs.conversion.filetypes.WordProcessingFileType;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
import com.groupdocs.conversion.options.load.EmailLoadOptions;
import com.groupdocs.conversion.utils.common.Path;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;

public class ConvertEachEmailAttachmentToDifferentFormat {
    public static void convert() {
        final int[] index = {0};

        LoadOptionsProvider loadOptionsProvider = ()->{
              EmailLoadOptions emailOpt =  new EmailLoadOptions();
              emailOpt.setConvertOwner(true);
              emailOpt.setConvertOwned(true);
              emailOpt.setDepth(2);
              return emailOpt;
        };

        SaveDocumentStreamForFileType convertedStreamProvider = (fileType)->{
            String fileName = Path.combine(outputFolder, String.format("converted_%d.%s", index[0], fileType.getExtension()));
            index[0]++;
            try {
                return new FileOutputStream(fileName);
            } catch (FileNotFoundException e) {
                throw new RuntimeException(e);
            }
        };

        ConvertOptionsProvider convertOptionsProvider = (sourceFileName, fileType) -> {
            if (fileType == EmailFileType.Eml)
            {
                return new WordProcessingConvertOptions();
            }

            if (fileType == WordProcessingFileType.Txt)
            {
                return new PdfConvertOptions();
            }

            return new ImageConvertOptions();
        };

        // Initialize the converter with the source email document
        try(Converter converter = new Converter(Constants.SAMPLE_EML_WITH_ATTACHMENT, loadOptionsProvider))
        {
            converter.convert(convertedStreamProvider, convertOptionsProvider);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "with-attachment.eml" >}}  
{{< tab-text >}}
`with-attachment.eml` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-each-email-attachment-to-different-format/with-attachment.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_0.docx" >}}  
{{< tab-text >}}
`converted_0.docx` is converted DOCX document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-each-email-attachment-to-different-format/converted_0.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_1.pdf" >}}  
{{< tab-text >}}
`converted_1.pdf` is converted attachment PDF document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-each-email-attachment-to-different-format/converted_1.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

In this example, the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class is initialized with the source email document and [EmailLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/emailloadoptions/). Using the `convertOptionsProvider`, it becomes possible to apply appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) to specify the target format for each conversion. Then, the `convertedStreamProvider` is invoked to handle and save each conversion.

By utilizing these options, you can effectively control the loading and conversion process of email attachments to meet your specific requirements.
---

## Convert each email attachment to different format

Path: /conversion/net/convert-each-email-attachment-to-different-format/

GroupDocs.Conversion provides a flexible API to control the conversion of documents that contains other documents.

The following code snippet shows how to convert each attachment to a different format based on the attachment type:

```csharp
var index = 1;
LoadOptions LoadOptionsProvider(LoadContext loadContext)
{
    if (loadContext.SourceFormat == EmailFileType.Eml)
    {
        return new EmailLoadOptions
        {
            ConvertOwned = true,
            ConvertOwner = true,
            Depth = 2
        };
    }
    return null;
}

Stream ConvertedStreamProvider(SaveContext saveContext)
{
    string outputFile = $"converted-{index++}.{saveContext.TargetFormat.Extension}";
    return new FileStream(outputFile, FileMode.Create);
}

ConvertOptions ConvertOptionsProvider(ConvertContext convertContext)
{
    if (convertContext.SourceFormat == EmailFileType.Eml)
    {
        return new WordProcessingConvertOptions();
    }

    if (convertContext.SourceFormat == WordProcessingFileType.Txt)
    {
        return new PdfConvertOptions();
    }
    return new ImageConvertOptions();
}

using (var converter = new Converter("sample_with_attachments.eml", LoadOptionsProvider))
{
    converter.Convert(ConvertedStreamProvider, ConvertOptionsProvider);
}

```
---

## Convert each email attachment to different format

Path: /conversion/nodejs-java/convert-each-email-attachment-to-different-format/

GroupDocs.Conversion provides a flexible API to control the conversion of documents that contain other documents. 

The following code snippet shows how to convert each attachment to a different format based on attachment type:

```js
const fs = require('fs').promises;

const emailLoadOptions = new groupdocs.conversion.EmailLoadOptions();
emailLoadOptions.setConvertOwned(true);
emailLoadOptions.setConvertOwner(true);
emailLoadOptions.setDepth(2);

const converter = new groupdocs.conversion.Converter("sample_with_attachments.eml", emailLoadOptions);

const convertOptions = new groupdocs.conversion.PdfConvertOptions();

convertOptions.setPassword("12345");
convertOptions.setDpi(300);

const fileOutputStreams = [];
try{
    await converter.convert(async (t) => {
        try {
            const fileOutputStream = await fs.open(`converted-${fileOutputStreams.length}.pdf`, 'w');
            fileOutputStreams.push(fileOutputStream);
            return fileOutputStream;
        } catch (e) {
            throw new Error(e);
        }
    }, options);
} finally {
    try {
        for (const fileOutputStream of fileOutputStreams) {
            await fileOutputStream.close();
        }
    } catch (e) {
        // throw an exception
    }
}
```

---

## Convert N consecutive pages

Path: /conversion/java/convert-n-consecutive-pages/

[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) allows you to convert a specific range of consecutive pages from a document. This feature is useful when you only need a portion of the document instead of converting the entire file.

To convert a set of consecutive pages, follow these steps:
 1. **Initialize the Converter**
    - Create an instance of the `Converter` class and provide the source document path.
 2. **Configure Conversion Options**
    - Instantiate the appropriate `ConvertOptions` class (e.g., `PdfConvertOptions`, `WordProcessingConvertOptions`, etc.).
 3. **Specify Page Range**
    - Use the [setPageNumber(int pageNumber)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/commonconvertoptions/#setPageNumber-int-) method to define the starting page.
    - Use the [setPagesCount(int pagesCount)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/commonconvertoptions/#setPagesCount-int-) method to specify how many pages to convert.
 4. **Perform the Conversion**
    - Call the `convert()` method on the `Converter` instance, passing the output file name and the `ConvertOptions` instance.

The following Java example demonstrates how to convert four consecutive pages, beginning from the second page of the document:

{{< tabs "code-example">}}
{{< tab "ConvertConsecutivePages.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class ConvertConsecutivePages {
    public static void convert() {
        // Load the source document
        Converter converter = new Converter("annual-review.docx");

        // Define conversion options
        PdfConvertOptions options = new PdfConvertOptions();
        options.setPageNumber(2); // Start from page 2
        options.setPagesCount(4); // Convert 4 pages

        // Perform the conversion
        converter.convert("converted.pdf", options);
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "annual-review.docx" >}}  
{{< tab-text >}}
`annual-review.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-n-consecutive-pages/annual-review.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.pdf" >}}  
{{< tab-text >}}
`converted.pdf` is converted attachment PDF document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-n-consecutive-pages/converted.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Additional Notes
- The page numbering starts at 1, not 0.
- If the specified pagesCount exceeds the document’s total page count, conversion will continue until the last page.
- This approach applies to different document formats by selecting the appropriate `ConvertOptions` subclass (e.g., `WordProcessingConvertOptions`, `SpreadsheetConvertOptions`).
---

## Convert N consecutive pages

Path: /conversion/nodejs-java/convert-n-consecutive-pages/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) provides the feature to convert N consecutive pages. 

To convert consecutive pages, follow these steps:

1.   Create an instance of [Converter](#) class and pass source document path as a constructor parameter
2.   Instantiate the appropriate [ConvertOptions](#) class e.g. (**[PdfConvertOptions](#)**, **[WordProcessingConvertOptions](#)**, **[SpreadsheetConvertOptions](#)** etc.).
3.   Set the [setPageNumber](#) property of the [ConvertOptions](#) instance to the starting page number.
4.   Set the [setPagesCount](#) property of the [ConvertOptions](#) instance to the number of pages to be converted.     
5.   Call the [convert](#) method of [Converter](#) class instance and pass the filename of the converted document and the instance of [ConvertOptions](#) from the previous steps.

The following code snippet shows how to convert 3 consecutive pages starting from second page of the source document:

```js
const converter = new groupdocs.conversion.Converter('sample.docx')
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

convertOptions.setPageNumber(2);
convertOptions.setPagesCount(2);

converter.convert('outputNPages.pdf', convertOptions)
```

---

## Convert to Image with advanced options

Path: /conversion/java/convert-to-image-with-advanced-options/


To convert documents to images with advanced options using [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/), you can utilize the [ImageConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/) class. This class provides various properties to customize the image output according to your requirements.
| Option | Description |
|--------|-------------|
|[**setFormat()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/#setFormat-com.groupdocs.conversion.filetypes.FileType-) | Specifies the desired image format for the output, such as `JPEG`, `PNG`, `BMP`, or `GIF`. |
|[**setWidth()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setWidth-int-) | Specifies desired image width after conversion. |
|[**setHeight()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setHeight-int-) | Specifies desired image height after conversion. |
|[**setHorizontalResolution()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setHorizontalResolution-int-) | Specifies desired image horizontal resolution after conversion. |
|[**setVerticalResolution()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setVerticalResolution-int-) | Specifies desired image vertical resolution after conversion. |
|[**setGrayscale()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setGrayscale-boolean-) | Specifies if `true` the converted image will be saved in grayscale |
|[**setRotateAngle()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setRotateAngle-int-) | Specifies the angle to rotate the image, if needed. |
|[**setFlipMode()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setFlipMode-com.groupdocs.conversion.options.convert.ImageFlipModes-) | Allows flipping the image horizontally or vertically. Available options are: `None`, `FlipX`, `FlipY`, `FlipXY` |
|[**setBrightness()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setBrightness-int-) | Adjusts image brightness. |
|[**setContrast()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setContrast-int-) | Adjusts image contrast. |
|[**setGamma()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setGamma-float-) | Adjusts image gamma. |
|[**setJpegOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setJpegOptions-com.groupdocs.conversion.options.convert.JpegOptions-) | Contains JPEG-specific convert options. |
|[**setTiffOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setTiffOptions-com.groupdocs.conversion.options.convert.TiffOptions-) | Contains TIFF-specific convert options. |
|[**setPsdOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setPsdOptions-com.groupdocs.conversion.options.convert.PsdOptions-) | Contains PSD-specific convert options. |
|[**setWebpOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setWebpOptions-com.groupdocs.conversion.options.convert.WebpOptions-) | Contains WebP-specific convert options. |
|[**setUsePdf()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/#setUsePdf-boolean-) | Sometimes, for better rendering and element positioning the source document should be converted to PDF first. If this property is set to `true`, the input is first converted to PDF format and after that to the desired format. |

The following code snippet shows how to convert to an image with advanced options:

{{< tabs "code-example">}}
{{< tab "ConvertToImageWithAdvancedOptions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.ImageFileType;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageFlipModes;

public class ConvertToImageWithAdvancedOptions {
    public static void convert() {
        // Initialize the converter with the source document
        try(Converter converter = new Converter("professional-services.pdf")) {
            // Instantiate the ImageConvertOptions
            ImageConvertOptions options = new ImageConvertOptions();
            options.setFormat(ImageFileType.Png);
            options.setFlipMode(ImageFlipModes.FlipY);
            options.setBrightness(50);
            options.setContrast(50);
            options.setGamma(0.5F);
            options.setGrayscale(true);
            options.setHorizontalResolution(300);
            options.setVerticalResolution(100);
            options.setPageNumber(1);
            options.setPagesCount(1);

            // Convert to image with the specified options
            converter.convert("converted_with_options.png", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "professional-services.pdf" >}}  
{{< tab-text >}}
`professional-services.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-image-with-advanced-options/professional-services.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_options.png" >}}  
{{< tab-text >}}
`converted_with_options.png` is converted PNG document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-image-with-advanced-options/converted_with_options.png) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

In this example, the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class is initialized with the source document. The [ImageConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/) are then configured to set the output format to PNG, define the dimensions, resolution, rotation angle, flip mode and etc. Finally, the convert method is called to perform the conversion with the specified options.

### JpegOptions

The [JpegOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/JpegOptions) is a subset of the [ImageConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/ImageConvertOptions) providing enhanced control over conversions to JPEG format.

The following options are available:
| Option | Description |
|--------|-------------|
|[**setQuality()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/jpegoptions/#setQuality-int-) | Specifies desired quality of the converted image. |
|[**setColorMode()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/jpegoptions/#setColorMode-com.groupdocs.conversion.options.convert.JpgColorModes-) | Sets JPEG color mode. Available options are: `Rgb, YCbCr, Cmyk, Ycck, Grayscale`. |
|[**setCompression()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/jpegoptions/#setCompression-com.groupdocs.conversion.options.convert.JpgCompressionMethods-) | Sets JPEG compression methods. Available options are: `Baseline, Progressive, Lossless, JpegLs` |

### TiffOptions

The [TiffOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/TiffOptions) is a subset of the [ImageConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/ImageConvertOptions) providing enhanced control over conversions to TIFF format.

The following options are available:
| Option | Description |
|--------|-------------|
|[**setCompression()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/tiffoptions/#setCompression-com.groupdocs.conversion.options.convert.TiffCompressionMethods-) | Sets TIFF compression method. Available options are: `None, Lzw, Ccitt3, Ccitt4, Rle`. |

### PsdOptions

The [PsdOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/PsdOptions) is a subset of the [ImageConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/ImageConvertOptions) providing enhanced control over conversions to PSD format.

The following options are available:
| Option | Description |
|--------|-------------|
|[**setChannelBitsCount()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/psdoptions/#setChannelBitsCount-short-) | Sets bits count per channel. |
|[**setChannelsCount()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/psdoptions/#setChannelsCount-short-) | Sets color channels count. |
|[**setColorMode()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/psdoptions/#setColorMode-com.groupdocs.conversion.options.convert.PsdColorModes-) | Sets PSD color mode. Available options are: `Bitmap, Grayscale, Indexed, Rgb, Cmyk, Multichannel, Duotone, Lab`. |
|[**setCompression()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/psdoptions/#setCompression-com.groupdocs.conversion.options.convert.PsdCompressionMethods-) | Sets PSD compression method. Available options are: `Raw, Rle, ZipWithoutPrediction, ZipWithPrediction`. |
|[**setVersion()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/psdoptions/#setVersion-int-) | Specifies desired PSDversion. |

### WebpOptions

The [WebpOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/WebpOptions) is a subset of the [ImageConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/ImageConvertOptions) providing enhanced control over conversions to WebP format.

The following options are available:
| Option | Description |
|--------|-------------|
|[**setLossless()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webpoptions/#setLossless-boolean-) | Specifies if the compression of the converted image should be lossless. |
|[**setQuality()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webpoptions/#setQuality-int-) | Sets the desired quality of the converted image. |

For more detailed information on the `ImageConvertOptions` class and its properties, please refer to the official [API reference](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/).

By utilizing these options, you can effectively control the image conversion process to meet your specific needs.
---

## Convert to Image with advanced options

Path: /conversion/nodejs-java/convert-to-image-with-advanced-options/

[**GroupDocs.Conversion**](#) provides [ImageConvertOptions](#) to give you control over conversion result when convert to image.  Along with [common convert options](#) from base class [ImageConvertOptions](#) has the following additional options:
*   [setFormat](#) specifies desired result document type. Available options are: *Tiff, Tif, Jpg, Jpeg, Png, Gig, Bmp, Ico, Psd, Wmf, Emf, Dcm, Webp, Dng, Svg, Jp2, Odg, J2c, J2k, Jpx, Jpf, Jpm, Eps, Cgm, Cdr, Cmx, Dib, Jpc, Jls, DjVu*
*   [setWidth](#) specifies desired image width after conversion.
*   [setHeight](#) specifies desired image height after conversion.
*   [setHorizontalResolution](#) specifies desired image horizontal resolution after conversion.
*   [setVerticalResolution](#) specifies desired image vertical resolution after conversion.
*   [setGrayscale](#) specifies if true converted image will be grayscaled.
*   [setRotateAngle](#) specifies image rotation angle.
*   [setFlipMode](#) specifies image flip mode. Available options are: *None, FlipX, FlipY, FlipXY*.
*   [setBrightness](#) adjusts image brightness.
*   [setContrast](#) adjusts image contrast.
*   [setGamma](#) adjust image gamma. 
*   [setJpegOptions](#) sets JPEG specific convert options.
*   [setTiffOptions](#) sets TIFF specific convert options.
*   [setPsdOptions](#) sets PSD specific convert options.
*   [setWebpOptions](#) sets WebP specific convert options.  
*   [setUsePdf](#). Sometimes, for better rendering and elements positioning the source document should be converted to PDF first. If this property is set to *true*, the input firstly is converted to PDF and after that to desired format.

The following code snippet shows how to convert to image with advanced options

```js
const util = require('util')
const fs = require('fs')

const outputFileTemplate = "ConvertToImageWithAdvancedOptions-converted-page-%s.png"; 

try {
    const getPageStream = fs.createWriteStream(util.format(outputFileTemplate, 1))

    const converter = new groupdocs.conversion.Converter('sample.pdf')
    const convertOptions = new groupdocs.conversion.ImageConvertOptions();
    
    convertOptions.setFormat(groupdocs.conversion.ImageFileType.Png);
    convertOptions.setFlipMode(groupdocs.conversion.ImageFlipModes.FlipY);
    convertOptions.setBrightness(50);
    convertOptions.setContrast(50);
    convertOptions.setGamma(0.5);
    convertOptions.setGrayscale(true);
    convertOptions.setHorizontalResolution(300);
    convertOptions.setVerticalResolution(100);
    convertOptions.setPageNumber(1);
    convertOptions.setPagesCount(1);

    converter.convert(getPageStream, convertOptions);
} catch (e) {
    console.error(e)
}
```

### JpegOptions

[JpegOptions](#) is subset of [ImageConvertOptions](#) which allow enhanced control over conversions to JPEG format. 

The following options are available:

*   [setQuality](#) specifies desired image quality.
*   [setColorMode](#) sets JPEG color mode. Available options are: *Rgb, YCbCr, Cmyk, Ycck, Grayscale*.
*   [setCompression](#) sets JPEG compression methods. Available options are: *Baseline, Progressive, Lossless, JpegLs*.

### TiffOptions

[TiffOptions](#) is subset of  [ImageConvertOptions](#) which allow enhanced control over conversions to TIFF format. 

The following options are available:

*   [setCompression](#) sets TIFF compression method. Available options are: None, Lzw, Ccitt3, Ccitt4, Rle.

### PsdOptions

[PsdOptions](#) is subset of  [ImageConvertOptions](#) which allow enhanced control over conversions to PSD format. 

The following options are available:

*   [setChannelBitsCount](#) sets bits count per channel.
*   [setChannelsCount](#) sets color channels count.
*   [setColorMode](#) sets PSD color mode. Available options are: *Bitmap, Grayscale, Indexed, Rgb, Cmyk, Multichannel, Duotone, Lab*.
*   [setCompression](#) sets PSD compression method. Available options are: *Raw, Rle, ZipWithoutPrediction, ZipWithPrediction*.
*   [setVersion](#) sets desired PSD version.

### WebpOptions

[WebpOptions](#) is subset of  [ImageConvertOptions](#) which allow enhanced control over conversions to WebP format. 

The following options are available:

*   [setLossless](#) specifies if the compression of the converted image will be lossless.
*   [setQuality](#) sets the quality of converted image.

---

## Custom logging

Path: /signature/net/how-to-implement-custom-logging/


By default logging is disabled when processing documents but product provides a way to specify custom logging implementationsave and set up this instance.

There is an interface that we can utilize:

* [ILogger](https://reference.groupdocs.com/net/signature/groupdocs.signature.logging/ilogger) - defines the interface for logging different process event like errors, warnings and information messages (traces).

There are 3 types of messages in the log file:

* Error - for unrecoverable exceptions
* Warning - for recoverable/expected/known exceptions
* Trace - for general information

## Implementing custom logger

To make your logger you should implement [ILogger](https://reference.groupdocs.com/net/signature/groupdocs.signature.logging/ilogger) interface.

For trace messages - implement public void Trace(string message) method \
For warning messages - implement public void Warning(string message) method \
For error messages - implement public void Error(string message) method

In this example, we'll implement a simple file logger.

```csharp
// Create logger and specify the output file
var logger = new CustomLogger("output.log");

// Create SignatureSettings and specify FileLogger
var settings = new SignatureSettings(fileLogger);

using (var signature = new Signature("sample.docx", settings))
{
    var options = new QrCodeSignOptions("JohnSmith");
    // sign document to file
    signature.Sign(outputFilePath, options);
}

/// <summary>
/// Writes log messages to API endpoint.
/// </summary>
public class APILogger : ILogger
{
    private object _lock = new object();
    private HttpClient _client;
    /// <summary>
    /// Create logger to API endpoint.
    /// </summary>
    public APILogger()
    {
        _client = new HttpClient()
        {
            BaseAddress = new Uri("http://localhost:64195/")
        };
        _client.DefaultRequestHeaders.Accept.Clear();
        _client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
    }

    /// <summary>
    /// Writes an error message to the console.
    /// Error log messages provide information about unrecoverable events in application flow.
    /// </summary>
    /// <param name="message">The error message.</param>
    /// <param name="exception">The exception.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="exception"/> is null.</exception>
    public void Error(string message, Exception exception)
    {
        if (message == null)
            throw new ArgumentNullException(nameof(message));
        if (exception == null)
            throw new ArgumentNullException(nameof(exception));

        var line = $"{message}. Exception: {exception}";
        PostMessage(LogLevel.Error, line);
    }

    /// <summary>
    /// Writes trace message to the console.
    /// Trace log messages provide generally useful information about application flow.
    /// </summary>
    /// <param name="message">The trace message.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    public void Trace(string message)
    {
        if (message == null)
            throw new ArgumentNullException(nameof(message));
        PostMessage(LogLevel.Trace, message);
    }

    /// <summary>
    /// Writes warning message to the console;
    /// Warning log messages provide information about the unexpected and recoverable event in application flow.
    /// </summary>
    /// <param name="message">The warning message.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    public void Warning(string message)
    {
        if (message == null)
            throw new ArgumentNullException(nameof(message));
        PostMessage(LogLevel.Warning, message);
    }

    private string PostMessage(LogLevel level, string message)
    {
        string result = string.Empty;
        string hdrs = "INFO";
        switch (level)
        {
            case LogLevel.Warning: hdrs = "WARNING"; break;
            case LogLevel.Error: hdrs = "ERROR"; break;
        }
        string date = DateTime.Now.ToString("MM/dd/yyyy hh:mm tt");
        string line = $"GroupDocs.Signature {hdrs} [{date}]. Message: {message}";
        var quer = new StringContent(line);
        
        lock (this._lock)
        {
            HttpResponseMessage response = _client.PostAsync("api/logging", quer).Result;
            response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
            response.EnsureSuccessStatusCode();
            result = response.Content.ReadAsStringAsync().Result;
        }
        return result;
    }
}
```

---

## Detect file type of container item

Path: /parser/java/detect-file-type-of-container-item/

GroupDocs.Parser provides the functionality to detect a file type of container items by [detectFileType(FileTypeDetectionMode)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/ContainerItem#detectFileType(com.groupdocs.parser.options.FileTypeDetectionMode)) method. 

FileTypeDetectionMode parameter provides the ability to control file type detection:

*  **Default**. The file type is detected by the file extension; if the file extension isn't recognized, the file type is detected by the file content.
*  **Extension**. The file type is detected only by the file extension.
*  **Content**. The file type is detected only by the file content.

Here are the steps to detect a file type of container items:

*  Instantiate Parser object for the initial document;
*  Call [getContainer](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getContainer()) method and obtain the collection of [ContainerItem](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/ContainerItem) objects;
*  Check if collection isn't null (container extraction is supported for the document);
*  Iterate through the collection and call [detectFileType(FileTypeDetectionMode)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/ContainerItem#detectFileType(com.groupdocs.parser.options.FileTypeDetectionMode)) method.

The following example shows how to detect a file type of container items:

```csharp
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleZip)) {
    // Extract attachments from the container
    Iterable<ContainerItem> attachments = parser.getContainer();
    // Check if container extraction is supported
    if (attachments == null) {
        System.out.println("Container extraction isn't supported");
    }
    // Iterate over attachments
    for (ContainerItem item : attachments) {
        // Detect the file type
        FileType fileType = item.detectFileType(FileTypeDetectionMode.Default);
        // Print the name and file type
        System.out.println(String.format("%s: %s", item.getName(), fileType));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Developers Guide - Web Report Generator

Path: /assembly/net/developers-guide-web-report-generator/

## Execution Steps

### Inputs

*   A **Template** created in one of the Supported Document Formats conforming to Supported Template Syntax.
*   A Connection String in order to connect to a **DataBase** that can be accessed through DataSet / DataTable etc
*   Type of Data Source. For example, Table / Views etc
*   Data Source. Select a table / view from the connected DataBase

### System Processing

*   Verifies Template Document Format.
*   Connects to MS SQL Server Database using connection string
*   Tests Connection according to the provided connection string.
*   Populates all Tables from connected database.
*   Populates all Views from connected database.
*   Allows to enter Custom Query.
*   Passes Template and Data Source to the GroupDocs.Assembly - GroupDocs.Assembly generates a report according to the inputs
*   Serves the report back to the browser

### Output

*   A Report generated based on the Template Syntax and the Data Source - This report will be in the same Document Format as that of the source Template Document Format.

Here is a sample report in Microsoft Word Document Format for 'Products' table

![](https://raw.githubusercontent.com/groupdocsassembly/GroupDocs_Assembly_NET/master/Examples/Data/Screenshots/Product%20Template.png)

## Code Walkthrough

#### Default.aspx.cs

{{< gist atirtahirgroupdocs 202a1a7ed0fa355b5fe0 >}}

#### ReportGenerator.cs

{{< gist atirtahirgroupdocs 500c9be730a4fd553344 >}}

## Technical References

### Creating Templates

*   [Template Syntax - Part 1 of 2](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/)
*   [Template Syntax - Part 2 of 2](https://docs.groupdocs.com/assembly/net/template-syntax-part-2-of-2/)

### An Example Business Case

*   [Business Case of a Shopping Store](https://docs.groupdocs.com/assembly/net/business-case-of-a-shopping-store/)
*   [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/)

**Note:** This business case covers almost all the [Supported Data Formats](https://docs.groupdocs.com/assembly/net/features-overview/#data-sources)
---

## Sign document with Digital signature

Path: /signature/net/sign-document-with-digital-signature/


## Introduction

In today's digital age, ensuring the authenticity and integrity of electronic documents is crucial. One highly effective method for achieving this is through the use of digital signatures. In this guide, we will explore the world of digital signatures, explaining what they are, why they are essential, and how you can utilize GroupDocs.Signature to seamlessly eSign your documents.

## What is a Digital Signature?

A digital signature is a cryptographic mechanism for verifying the authenticity and integrity of electronic documents. It provides strong assurance that the document originated from a known sender and has not been tampered with by unauthorized sources. Digital signatures are typically represented by certificates containing private (for signing) and public (for verification) keys. Various public key cryptography standards, such as PFX format, are commonly used for this purpose.
The picture below shows how a digital signature looks on a PDF document page by default.

![Digital](/signature/net/images/esign-document-with-digital-signature.png)

## Why Use Digital Signatures?

- **Enhanced Security:** Digital signatures provide a higher level of document security, making it extremely challenging for unauthorized parties to alter the content.
- **Authentication:** They offer a reliable way to verify the identity of the document sender.
- **Non-repudiation:** Digital signatures prevent senders from denying the authenticity of the signed document.


## How to Sign a document with a Digital Signature

**[GroupDocs.Signature](https://products.groupdocs.com/signature/net)** supports the creation of digital signatures based on existing PFX certificates. To specify various settings the library provides the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) class that allows adjusting digital signature properties in the document:

* The [FilePath](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/certificatefilepath/) or [Stream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/certificatestream/) properties define the certificate source;
* The [password](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/password/) property specifies the certificate password;
* The [Contact](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/contact/), [Reason](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/reason/) and [Location](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/location/) properties specify additional descriptions;
* The [Visible](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/visible/) property specifies whether the signature should be visible on the document page or not;
* The [XAdES type](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/xadestype/) property defines whether the e-signature should be of an XML Advanced Electronic Signature type.

### Follow these steps to sign your documents with a digital signature

1. Install the GroupDocs.Signature [NuGet package](https://www.nuget.org/packages/groupdocs.signature) to your .NET application.
2. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
3. Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with the required certificate and its password.
4. Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.

The example below shows how to sign a PDF document with a digital e-signature using C# language. We can sign any other supported document format in the same way.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // initialize digital option with certificate file path
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // optional: setup image file path
        ImageFilePath = "sample.jpg",

        // set signature position
        Left = 100,
        Top = 100,

        // set
        Password = "1234567890"
    };
    signature.Sign("sampleSigned.pdf", options);
}
```
### Summary
This guide demonstrates how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) to sign documents with digital signatures. It explains how to load documents, configure certificate-based signatures, and save signed files securely. Advanced features, including signature appearance customization and validation, are also covered. Refer to related resources for additional details on digital signing workflows.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign document with Digital signature

Path: /signature/nodejs-java/sign-document-with-digital-signature/


## Introduction

In today's digital age, ensuring the authenticity and integrity of electronic documents is crucial. One highly effective method for achieving this is through the use of digital signatures. In this guide, we will explore the world of digital signatures, explaining what they are, why they are essential, and how you can utilize GroupDocs.Signature to seamlessly eSign your documents.

## What is a Digital Signature?

A digital signature is a cryptographic mechanism for verifying the authenticity and integrity of electronic documents. It provides strong assurance that the document originated from a known sender and has not been tampered with by unauthorized sources. Digital signatures are typically represented by certificates containing private (for signing) and public (for verification) keys. Various public key cryptography standards, such as PFX format, are commonly used for this purpose.
The picture below shows how a digital signature looks on a PDF document page by default.

![Digital](/signature/nodejs-java/images/esign-document-with-digital-signature.png)

## Why Use Digital Signatures?

- **Enhanced Security:** Digital signatures provide a higher level of document security, making it extremely challenging for unauthorized parties to alter the content.
- **Authentication:** They offer a reliable way to verify the identity of the document sender.
- **Non-repudiation:** Digital signatures prevent senders from denying the authenticity of the signed document.


## How to Sign a document with a Digital Signature

**[GroupDocs.Signature](https://products.groupdocs.com/signature/nodejs-java)** supports the creation of digital signatures based on existing PFX certificates. To specify various settings, the library provides the [DigitalSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions) class that allows adjusting digital signature properties in the document:

* The [FilePath](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/certificatefilepath) or [Stream](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/certificatestream) properties define the certificate source;
* The [password](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/password) property specifies the certificate password;
* The [Contact](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/contact), [Reason](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/reason) and [Location](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/location) properties specify additional descriptions;
* The [Visible](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/visible) property specifies whether the signature should be visible on the document page or not;
* The [XAdES type](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options.digitalsignoptions/xadestype) property defines whether the e-signature should be of an XML Advanced Electronic Signature type.

### Follow these steps to sign your documents with a digital signature

1. Install the GroupDocs.Signature [NuGet package](https://www.nuget.org/packages/groupdocs.signature) to your .NET application.
2. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
3. Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalsignoptions) object with the required certificate and its password.
4. Call the [Sign](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/sign) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [DigitalSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalsignoptions) to it.
The example below shows how to sign a PDF document with a digital e-signature using Node.Js language. We can sign any other supported document format in the same way.

```javascript
  // The path to the documents directory.
const filePath = Constants.SAMPLE_PDF; // Assuming Constants.SAMPLE_PDF is defined elsewhere
const fileName = path.basename(filePath);
const imagePath = Constants.ImageHandwrite;
const certificatePath = Constants.CertificatePfx;

const outputFilePath = path.join(Constants.OutputPath, 'SignWithDigital', fileName);
const signature = new signatureLib.Signature(filePath);

// Create digital sign options
const options = new signatureLib.DigitalSignOptions(certificatePath);

// Optional: setup image file path
options.setImageFilePath(imagePath);
options.setLeft(100);
options.setTop(100);
options.setPageNumber(1);
options.setPassword('1234567890');

// Sign document to file
const result = signature.sign(outputFilePath, options);
console.log(`\nSource document signed successfully with ${result.getSucceeded().length} signature(s).\nFile saved at ${outputFilePath}.`);

```
### Summary
This guide demonstrates how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) to sign documents with digital signatures. It explains how to load documents, configure certificate-based signatures, and save signed files securely. Advanced features, including signature appearance customization and validation, are also covered. Refer to related resources for additional details on digital signing workflows.



## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature Node.Js for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Document protection

Path: /editor/java/document-protection/

The [Password](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getPassword--) property, if set, enables document protection from opening by encrypting it with specified password. However, almost all WordProcessing formats support a document protection from writing, which is completely different from opening. Document protection, like document encoding, also implies a password as a form of key, but it also supports different levels of protection: some of them allow only read-only mode, other allow to edit form-fields etc.

[**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) allows to apply the document protection via the [Protection](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getProtection--) property in the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class. By default this property has a NULL value, which means that GroupDocs.Editor will not apply the protection to the document.

The [Protection](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getProtection--) property has a [WordProcessingProtection](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection) type. This type is a class, which, it turn, consists of two properties: [Password](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) and a [ProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--).

[WordProcessingProtection](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection) class has two constructors. [First one](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#WordProcessingProtection--) is parameterless, it sets both class properties to their default values. If user will use this constructor, and then will not set values to the properties in class instance, the protection will not be applied to the document. [Second constructor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#WordProcessingProtection-byte-java.lang.String-), in counterpart, has two parameters, which set values to the properties; so, when using this constructor, there is no need to use properties at all.

The [Password](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) property is responsible for setting a password for the document protection. By default it is NULL — protection is not applied. If user wants to apply the document protection, he *needs* to assign some string to this property (through [constructor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#WordProcessingProtection-byte-java.lang.String-) or property itself); otherwise protection will not be applied regardless from the value of the [ProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) property.

[ProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) property has type [WordProcessingProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotectiontype), which is a simple enum, and value of this enum determines the level of protection. By default enum has a `NoProtection` value, which means that no protection will be applied. Other values are:

1. `AllowOnlyRevisions` — User can only add revision marks to the document.
2. `AllowOnlyComments` — User can only modify comments in the document.
3. `AllowOnlyFormFields` — User can only enter data in the form fields in the document.
4. `ReadOnly` — No changes are allowed to the document.

Take a note that both the properties [Password](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) and a [ProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) are bound to each other. If user set a valid non-NULL not-empty [Password](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--), but the [ProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) property has a [WordProcessingProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotectiontype). `NoProtection` value, the protection will not be applied. And vice versa, if [ProtectionType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) property has a `AllowOnlyFormFields` value, for example, but [Password](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) is NULL or empty string, then the protection will not be applied too.

---

## Document protection

Path: /editor/net/document-protection/

The [Password](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/password) property, if set, enables document protection from opening by encrypting it with specified password. However, almost all WordProcessing formats support a document protection from writing, which is completely different from opening. Document protection, like document encoding, also implies a password as a form of key, but it also supports different levels of protection: some of them allow only read-only mode, other allow to edit form-fields etc.

[**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) allows to apply the document protection via the [Protection](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/protection) property in the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class. By default this property has a NULL value, which means that GroupDocs.Editor will not apply the protection to the document.

The [Protection](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/protection) property has a [WordProcessingProtection](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection) type. This type is a class, which, it turn, consists of two properties: [Password](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/password) and a [ProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/protectiontype).

[WordProcessingProtection](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection) class has two constructors. [First one](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/wordprocessingprotection/#constructor) is parameterless, it sets both class properties to their default values. If user will use this constructor, and then will not set values to the properties in class instance, the protection will not be applied to the document. [Second constructor](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/wordprocessingprotection/#constructor_1), in counterpart, has two parameters, which set values to the properties; so, when using this constructor, there is no need to use properties at all.

The [Password](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/password) property is responsible for setting a password for the document protection. By default it is NULL — protection is not applied. If user wants to apply the document protection, he *needs* to assign some string to this property (through [constructor](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/wordprocessingprotection/#constructor_1) or property itself); otherwise protection will not be applied regardless from the value of the [ProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/protectiontype) property.

[ProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/protectiontype) property has type [WordProcessingProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotectiontype), which is a simple enum, and value of this enum determines the level of protection. By default enum has a `NoProtection` value, which means that no protection will be applied. Other values are:

1. `AllowOnlyRevisions` — User can only add revision marks to the document.
2. `AllowOnlyComments` — User can only modify comments in the document.
3. `AllowOnlyFormFields` — User can only enter data in the form fields in the document.
4. `ReadOnly` — No changes are allowed to the document.

Take a note that both the properties [Password](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/password) and a [ProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/protectiontype) are bound to each other. If user set a valid non-NULL not-empty [Password](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/password), but the [ProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/protectiontype) property has a [WordProcessingProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotectiontype). `NoProtection` value, the protection will not be applied. And vice versa, if [ProtectionType](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/protectiontype) property has a `AllowOnlyFormFields` value, for example, but [Password](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingprotection/password) is NULL or empty string, then the protection will not be applied too.

---

## Document protection

Path: /editor/nodejs-java/document-protection/


The [Password](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getPassword--) property, if set, enables document protection from opening by encrypting it with a specified password. However, almost all WordProcessing formats support document protection from writing, which is different from opening protection. Document protection, like document encoding, involves a password but also supports different levels of protection: some allow only read-only mode, while others allow editing form fields, adding comments, etc.

**[GroupDocs.Editor](https://products.groupdocs.com/editor/nodejs-java)** allows applying document protection through the [Protection](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getProtection--) property in the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingsaveoptions) class. By default, this property is set to NULL, meaning no protection is applied to the document.

The [Protection](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getProtection--) property is of the type [WordProcessingProtection](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection). This class consists of two properties: [Password](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) and [ProtectionType](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--).

The [WordProcessingProtection](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection) class has two constructors. The [first constructor](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#WordProcessingProtection--) is parameterless and sets both class properties to their default values. If this constructor is used without modifying the properties, the protection will not be applied. The [second constructor](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#WordProcessingProtection-byte-java.lang.String-) takes two parameters to set both properties directly.

The [Password](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) property sets the password for document protection. If the password is not provided, protection will not be applied, regardless of the [ProtectionType](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) value.

The [ProtectionType](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) property is of type [WordProcessingProtectionType](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotectiontype), which is an enum. This enum determines the level of protection. The default value is `NoProtection`, meaning no protection is applied. Other values include:

1. `AllowOnlyRevisions` — User can only add revision marks to the document.
2. `AllowOnlyComments` — User can only modify comments in the document.
3. `AllowOnlyFormFields` — User can only enter data into the form fields in the document.
4. `ReadOnly` — No changes are allowed to the document.

### Important Notes

Both the [Password](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) and [ProtectionType](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) properties are interdependent. If a non-NULL and non-empty [Password](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) is provided, but the [ProtectionType](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) is set to `NoProtection`, then no protection will be applied. Conversely, if a [ProtectionType](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getProtectionType--) like `AllowOnlyFormFields` is set but the [Password](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/wordprocessingprotection/#getPassword--) is NULL or an empty string, the protection will not be applied either.

---

## Docx to Md

Path: /markdown/net/convert/export-wordprocessing/


Use GroupDocs.Markdown to convert DOCX and other Word documents to clean Markdown.

### Using static method

The simplest way to convert a Word file:

{{< tabs "export-word-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Set license (optional)
if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

// Convert DOCX to Markdown string
string markdown = MarkdownConverter.ToMarkdown("business-plan.docx");

// Or save directly to a file
MarkdownConverter.ToFile("business-plan.docx", "export-word-static.md");
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-word-static.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-wordprocessing/ExportWordStatic/export-word-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-word-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

using var converter = new MarkdownConverter("business-plan.docx");
var options = new ConvertOptions
{
    ImageExportStrategy = new ExportImagesToFileSystemStrategy("images")
    {
        ImagesRelativePath = "images"
    },
    HeadingLevelOffset = 1
};

converter.Convert("export-word-instance.md", options);
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-word-instance.zip" >}}  
```text
export-word-instance.md (5 KB)
images/img-001.png (4 KB)
images/img-002.jpg (41 KB)
images/img-003.png (14 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-wordprocessing/ExportWordInstance/export-word-instance.zip)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/net/getting-started/supported-document-formats" >}}).

---

## Docx to Md

Path: /markdown/python-net/convert/export-wordprocessing/


Use GroupDocs.Markdown to convert DOCX and other Word documents to clean Markdown.

### Using static method

The simplest way to convert a Word file:

{{< tabs "export-word-static">}}
{{< tab "export_word_to_markdown.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter

def export_word_to_markdown():
    """Convert a Word document to Markdown using the static one-liner API."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Convert DOCX to a Markdown string in one call
    markdown = MarkdownConverter.to_markdown("business-plan.docx")

    # Step 3: Or save the conversion result directly to a file
    MarkdownConverter.to_file("business-plan.docx", "export-word.md")

if __name__ == "__main__":
    export_word_to_markdown()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-word.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



|  | TABLE OF CONTENTS TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc9437451" Introduction	 PAGEREF _Toc9437451 \h 3  HYPERLINK \l "_Toc9437452" 1.	Executive Summary	 PAGEREF _Toc9437452 \h 5  HYPERLINK \l "_Toc9437453" 2.	Company Overview	 PAGEREF _Toc9437453 \h 6  HYPERLINK \l "_Toc9437454" 3.	Business Description	 PAGEREF _Toc9437454 \h 7  HYPERLINK \l "_Toc9437
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-wordprocessing/export_word_to_markdown/export-word.txt)
{{< /tab >}}
{{< tab "export-word.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-wordprocessing/export_word_to_markdown/export-word.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-word-instance">}}
{{< tab "export_word_with_options.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy

def export_word_with_options():
    """Convert a Word document to Markdown using the instance API with image export and heading offset."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Open the DOCX document with a context manager
    with MarkdownConverter("business-plan.docx") as converter:
        # Step 3: Configure the image export strategy to save images to disk
        strategy = ExportImagesToFileSystemStrategy("images")
        strategy.images_relative_path = "images"

        # Step 4: Set conversion options
        options = ConvertOptions()
        options.image_export_strategy = strategy
        options.heading_level_offset = 1  # shift all headings down one level

        # Step 

        # Step 5: Convert and save the Markdown output
        converter.convert("export-word-options.md", convert_options=options)

if __name__ == "__main__":
    export_word_with_options()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-word-options.zip" >}}  
```text
export-word-options.txt (21 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-wordprocessing/export_word_with_options/export-word-options.zip)
{{< /tab >}}
{{< tab "export-word-options.zip" >}}  
```text
export-word-options.txt (20 KB)
images/img-001.jpg (56 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-wordprocessing/export_word_with_options/export-word-options.zip)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/python-net/getting-started/supported-document-formats" >}}).

---

## Electronic Signature PDF with Metadata signature

Path: /signature/net/esign-pdf-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [PdfMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/pdfmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) instance.
PDF document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
PDF document metadata contains 3 fields: Name, Value and TagPrefix, combination of Name and Tag prefix should be unique.

PDF document metadata could keep big amount of data that provides ability to keep serialized custom objects with additional encryption in there. See [Advanced examples how to embed secure data]({{< ref "signature/net/developer-guide/advanced-usage/signing/sign-document-with-secure-custom-metadata-signatures/_index.md" >}}).

### Here are the steps to add metadata signatures into PDF document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several[PdfMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/pdfmetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

## How to Electronic Signature PDF with Metadata signature

This example shows how to sign PDF document with several e-signatures as metadata.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    MetadataSignOptions options = new MetadataSignOptions();

    options
       .Add(new PdfMetadataSignature("Author", "Mr.Scherlock Holmes")) // String value
       .Add(new PdfMetadataSignature("CreatedOn", DateTime.Now))       // DateTime values
       .Add(new PdfMetadataSignature("DocumentId", 123456))            // Integer value
       .Add(new PdfMetadataSignature("SignatureId", 123.456D))         // Double value
       .Add(new PdfMetadataSignature("Amount", 123.456M))              // Decimal value
       .Add(new PdfMetadataSignature("Total", 123.456F));              // Float value
    // add these signatures to options
    options.Signatures.AddRange(signatures);
    signature.Sign("SampleSigned.pdf", options);
}
```

## How to Electronic Signature PDF with standard metadata signatures

This example shows how to sign PDF document with standard standard embedded PDF document metadata signatures. If PDF metadata signature already exists with same name its value will be overwritten.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    MetadataSignOptions options = new MetadataSignOptions();
    // Using standard Pdf Metadata Signatures with new values
    MetadataSignature[] signatures = new MetadataSignature[]
    {
        PdfMetadataSignatures.Author.Clone("Mr.Scherlock Holmes"),
        PdfMetadataSignatures.CreateDate.Clone(DateTime.Now.AddDays(-1)),
        PdfMetadataSignatures.MetadataDate.Clone(DateTime.Now.AddDays(-2)),
        PdfMetadataSignatures.CreatorTool.Clone("GD.Signature-Test"),
        PdfMetadataSignatures.ModifyDate.Clone(DateTime.Now.AddDays(-13)),
        PdfMetadataSignatures.Producer.Clone("GroupDocs-Producer"),
        PdfMetadataSignatures.Entry.Clone("Signature"),
        PdfMetadataSignatures.Keywords.Clone("GroupDocs, Signature, Metadata, Creation Tool"),
        PdfMetadataSignatures.Title.Clone("Metadata Example"),
        PdfMetadataSignatures.Subject.Clone("Metadata Test Example"),
        PdfMetadataSignatures.Description.Clone("Metadata Test example description"),
        PdfMetadataSignatures.Creator.Clone("GroupDocs.Signature"),
    };
    options.Signatures.AddRange(signatures);
    // sign document to file
    signature.Sign("sample_signed.pdf", options);
}
```

### Advanced Usage Topics

To learn more about document Electronic Signature features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Email messages

Path: /watermark/java/email-messages/

## Modifying body and subject of email message

GroupDocs.Watermark also allows you to modify the body and subject of an email message. Below is the code sample to modify [body](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/EmailContent#setBody(java.lang.String)) and [subject](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/EmailContent#setSubject(java.lang.String)) of an email Message:

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailUpdateEmailBody**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                 
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg"
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                        
                                                                                                       
EmailContent content = watermarker.getContent(EmailContent.class);                                     
                                                                                                       
// Set the plain text body                                                                             
content.setBody("Test plain text body");                                                               
                                                                                                       
// Set the html body                                                                                   
content.setHtmlBody("<html><body>Test html body</body></html>");                                       
                                                                                                       
// Set the email subject                                                                               
content.setSubject("Test subject");                                                                    
                                                                                                       
// Save changes                                                                                        
watermarker.save("message.msg");                                                             
                                                                                                       
watermarker.close();                                                                                   
```

## Embedding image to email message body

GroupDocs.Watermark also provides the feature of embedding images in the body of the email message. Following is the code sample for embedding an image in an email:

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailAddEmbeddedImage**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                                              
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg"                             
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                                                     
                                                                                                                                    
EmailContent content = watermarker.getContent(EmailContent.class);                                                                  
                                                                                                                                    
File imageFile = new File("sample.jpg");                                                                                     
byte[] imageBytes = new byte[(int) imageFile.length()];                                                                             
InputStream imageInputStream = new FileInputStream(imageFile);                                                                      
imageInputStream.read(imageBytes);                                                                                                  
imageInputStream.close();                                                                                                           
                                                                                                                                    
content.getEmbeddedObjects().add(imageBytes, "sample.jpg");                                                                         
EmailEmbeddedObject embeddedObject = content.getEmbeddedObjects().get_Item(content.getEmbeddedObjects().getCount() - 1);            
content.setHtmlBody("<html><body>This is an embedded image: <img src=\"cid:" + embeddedObject.getContentId() + "\"></body></html>");
watermarker.save("message.msg");                                                                                          
                                                                                                                                    
watermarker.close();                                                                                                                
```

## Removing all embedded images from email message body

You can also remove the embedded images from the body of the email message. Below is the code for removing embedded images:

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailRemoveEmbeddedImages**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                                
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg"               
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                                       
                                                                                                                      
EmailContent content = watermarker.getContent(EmailContent.class);                                                    
for (int i = content.getEmbeddedObjects().getCount() - 1; i >= 0; i--)                                                
{                                                                                                                     
    if (content.getEmbeddedObjects().get_Item(i).getDocumentInfo().getFileType() == FileType.JPEG)                    
    {                                                                                                                 
        // Remove reference to the image from html body                                                               
        String pattern = "<img[^>]*src=\"cid:" + content.getEmbeddedObjects().get_Item(i).getContentId() + "\"[^>]*>";
        content.setHtmlBody(content.getHtmlBody().replaceAll(pattern, ""));                                           
                                                                                                                      
        // Remove the image                                                                                           
        content.getEmbeddedObjects().removeAt(i);                                                                     
    }                                                                                                                 
}                                                                                                                     
                                                                                                                      
watermarker.save("message.msg");                                                                            
                                                                                                                      
watermarker.close();                                                                                                  
```

## Searching text in email message body or subject

Using GroupDocs.Watermark, you can also search for a text in the subject as well as in the body of the email message. Following is the code sample for searching text in Email Message:

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailSearchTextInBody**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                                                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg"                                                              
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                                                                                      
                                                                                                                                                                     
SearchCriteria criteria = new TextSearchCriteria("test", false);                                                                                                     
                                                                                                                                                                     
// Specify search locations                                                                                                                                          
watermarker.getSearchableObjects().setEmailSearchableObjects(EmailSearchableObjects.Subject | EmailSearchableObjects.HtmlBody | EmailSearchableObjects.PlainTextBody);
                                                                                                                                                                     
// Note, search is performed only if you pass TextSearchCriteria instance to FindWatermarks method                                                                   
PossibleWatermarkCollection watermarks = watermarker.search(criteria);                                                                                               
                                                                                                                                                                     
// Remove found text fragments                                                                                                                                       
watermarks.clear();                                                                                                                                                  
                                                                                                                                                                     
// Save changes                                                                                                                                                      
watermarker.save("message.msg");                                                                                                                           
                                                                                                                                                                     
watermarker.close();                                                                                                                                                 
```

## Listing all message recipients

GroupDocs.Watermark also allows listing all the message recipients using methods [getTo()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/EmailContent#getTo()), [getCc()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/EmailContent#getCc()) and [getBcc()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/EmailContent#getBcc()) as shown in the following code sample.

**advanced\_usage.add\_watermarks\_to\_email\_attachments.EmailListRecipients**

```java
EmailLoadOptions loadOptions = new EmailLoadOptions();                                                  
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\message.msg" 
Watermarker watermarker = new Watermarker("message.msg", loadOptions);                         
                                                                                                        
EmailContent content = watermarker.getContent(EmailContent.class);                                      
                                                                                                        
// List all direct recipients                                                                           
for (EmailAddress address : content.getTo())                                                            
{                                                                                                       
    System.out.println(address.getAddress());                                                           
}                                                                                                       
                                                                                                        
// List all CC recipients                                                                               
for (EmailAddress address : content.getCc())                                                            
{                                                                                                       
    System.out.println(address.getAddress());                                                           
}                                                                                                       
                                                                                                        
// List all BCC recipients                                                                              
for (EmailAddress address : content.getBcc())                                                           
{                                                                                                       
    System.out.println(address.getAddress());                                                           
}                                                                                                       
                                                                                                        
watermarker.close();                                                                                    
```

---

## Email messages

Path: /watermark/net/email-messages/

Learn how to add watermark in Outlook email messages
## Modifying body and subject of email message

GroupDocs.Watermark also allows you to modify the body and subject of an email message. Below is the code sample to modify [body](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.email/emailcontent/properties/body) and [subject](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.email/emailcontent/properties/subject) of an email Message:

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailUpdateEmailBody**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    EmailContent content = watermarker.GetContent<EmailContent>();

    // Set the plain text body
    content.Body = "Test plain text body";

    // Set the html body
    content.HtmlBody = "<html><body>Test html body</body></html>";

    // Set the email subject
    content.Subject = "Test subject";

    // Save changes
    watermarker.Save("message.msg");
}
```

## Embedding image to email message body

GroupDocs.Watermark also provides the feature of embedding images in the body of the email message. Following is the code sample for embedding an image in an email:

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailAddEmbeddedImage**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    EmailContent content = watermarker.GetContent<EmailContent>();

    content.EmbeddedObjects.Add(File.ReadAllBytes("sample.jpg"), "sample.jpg");
    EmailEmbeddedObject embeddedObject = content.EmbeddedObjects[content.EmbeddedObjects.Count - 1];
    content.HtmlBody = string.Format("<html><body>This is an embedded image: <img src=\"cid:{0}\"></body></html>", embeddedObject.ContentId);

    watermarker.Save("message.msg");
}
```

## Removing all embedded images from email message body

You can also remove the embedded images from the body of the email message. Below is the code for removing embedded images:

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailRemoveEmbeddedImages**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    EmailContent content = watermarker.GetContent<EmailContent>();
    for (int i = content.EmbeddedObjects.Count - 1; i >= 0; i--)
    {
        if (content.EmbeddedObjects[i].GetDocumentInfo().FileType == FileType.JPEG)
        {
            // Remove reference to the image from html body
            string pattern = string.Format("<img[^>]*src=\"cid:{0}\"[^>]*>", 
                content.EmbeddedObjects[i].ContentId);
            content.HtmlBody = Regex.Replace(content.HtmlBody, pattern, string.Empty);

            // Remove the image
            content.EmbeddedObjects.RemoveAt(i);
        }
    }
    watermarker.Save("message.msg");
}
```

## Searching text in email message body or subject

Using GroupDocs.Watermark, you can also search for a text in the subject as well as in the body of the email message. Following is the code sample for searching text in the email message:

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailSearchTextInBody**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    SearchCriteria criteria = new TextSearchCriteria("test", false);

    // Specify search locations
    watermarker.SearchableObjects.EmailSearchableObjects = EmailSearchableObjects.Subject 
        | EmailSearchableObjects.HtmlBody | EmailSearchableObjects.PlainTextBody;

    // Note, search is performed only if you pass TextSearchCriteria instance to FindWatermarks method
    PossibleWatermarkCollection watermarks = watermarker.Search(criteria);

    // Remove found text fragments
    watermarks.Clear();

    // Save changes
    watermarker.Save("message.msg");
}
```

## Listing all message recipients

GroupDocs.Watermark also allows listing all the message recipients using properties [To](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.email/emailcontent/properties/to), [Cc](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.email/emailcontent/properties/cc) and [Bcc](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.email/emailcontent/properties/bcc) as shown in the following code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToEmailAttachments.EmailListRecipients**

```csharp
EmailLoadOptions loadOptions = new EmailLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\message.msg"
using (Watermarker watermarker = new Watermarker("message.msg", loadOptions))
{
    EmailContent content = watermarker.GetContent<EmailContent>();

    // List all direct recipients
    foreach (EmailAddress address in content.To)
    {
        Console.WriteLine(address.Address);
    }

    // List all CC recipients
    foreach (EmailAddress address in content.Cc)
    {
        Console.WriteLine(address.Address);
    }

    // List all BCC recipients
    foreach (EmailAddress address in content.Bcc)
    {
        Console.WriteLine(address.Address);
    }
}
```

---

## Email messages

Path: /watermark/python-net/email-messages/


## Modifying body and subject of email message

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    content = watermarker.get_content(gwc_email.EmailContent)
    content.body = "Test plain text body"
    content.html_body = "<html><body>Test html body</body></html>"
    content.subject = "Test subject"
    watermarker.save("message.msg")
```

## Embedding image to email message body

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    content = watermarker.get_content(gwc_email.EmailContent)
    with open("sample.jpg", "rb") as f:
        content.embedded_objects.add(f.read(), "sample.jpg")
    embedded_object = content.embedded_objects[content.embedded_objects.count - 1]
    content.html_body = f"<html><body>This is an embedded image: <img src=\"cid:{embedded_object.content_id}\"></body></html>"
    watermarker.save("message.msg")
```

## Removing all embedded images from email message body

```python
import re
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email
from groupdocs.watermark.common import FileType

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    content = watermarker.get_content(gwc_email.EmailContent)
    for i in range(content.embedded_objects.count - 1, -1, -1):
        if content.embedded_objects[i].get_document_info().file_type == FileType.JPEG:
            pattern = rf"<img[^>]*src=\"cid:{re.escape(content.embedded_objects[i].content_id)}\"[^>]*>"
            content.html_body = re.sub(pattern, "", content.html_body)
            content.embedded_objects.remove_at(i)
    watermarker.save("message.msg")
```

## Searching text in email message body or subject

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email
import groupdocs.watermark.search.searchcriteria as gws_sc
import groupdocs.watermark.search.objects as gws_objs

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    criteria = gws_sc.TextSearchCriteria("test", False)
    watermarker.searchable_objects.email_searchable_objects = (
        gws_objs.EmailSearchableObjects.SUBJECT
        | gws_objs.EmailSearchableObjects.HTML_BODY
        | gws_objs.EmailSearchableObjects.PLAIN_TEXT_BODY
    )
    watermarks = watermarker.search(criteria)
    watermarks.clear()
    watermarker.save("message.msg")
```

## Listing all message recipients

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.email as gwc_email

load_options = gw.EmailLoadOptions()
with gw.Watermarker("message.msg", load_options) as watermarker:
    content = watermarker.get_content(gwc_email.EmailContent)
    for address in content.to:
        print(address.address)
    for address in content.cc:
        print(address.address)
    for address in content.bcc:
        print(address.address)
```



---

## Enumeration Extension Methods

Path: /assembly/java/enumeration-extension-methods/

LINQ Reporting Engine enables you to perform common manipulations on a sequential data through the engine's built-in extension methods for `Iterable`. These extension methods mimic some extension methods of [IEnumerable&lt;T&gt;](http://msdn.microsoft.com/en-us/library/9eekhta0\(v=vs.110\).aspx) providing the same signatures and behavior features. Thus, you can group, sort, and perform other sequential data manipulations in template expressions in a common way.

The following table describes these built-in extension methods. The following notation conventions are used within the table:

- `Selector` stands for a lambda function returning a value and taking an enumeration item as its single argument. See “Using Lambda Functions” for more information.
- `ComparableSelector` stands for `Selector` returning [Comparable](http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html).
- `EnumerationSelector` stands for `Selector` returning `Iterable`.
- `Predicate` stands for `Selector` returning a Boolean value.

Examples in the following table are given using `persons` and `otherPersons`, enumerations of instances of the `Person` class that is defined as follows.

{{< highlight csharp >}}
public class Person
{
	public String getName() { ... }
	public int getAge() { ... }
	public Iterable<Person> getChildren() { ... }
	...
}
{{< /highlight >}}

|Extension Method |Examples and Notes |
| :- | :- |
|all(Predicate)|{{< highlight csharp >}}
 persons.all(p => p.getAge() < 50){{< /highlight >}}|
|any()|{{< highlight csharp >}}
 persons.any(){{< /highlight >}}|
|any(Predicate)|{{< highlight csharp >}}
 persons.any(p => p.getName() == "John Smith"){{< /highlight >}}|
|average(Selector)|{{< highlight csharp >}}
 persons.average(p => p.getAge()){{< /highlight >}}The input selector must return a value of any type that has predefined addition and division operators. |
|concat(Iterable)|{{< highlight csharp >}}
 persons.concat(otherPersons){{< /highlight >}}An implicit reference conversion must exist between types of items of concatenated enumerations. |
|contains(Object)|{{< highlight csharp >}}
 persons.contains(otherPersons.first()){{< /highlight >}}|
|count()|{{< highlight csharp >}}
 persons.count(){{< /highlight >}}|
|count(Predicate)|{{< highlight csharp >}}
 persons.count(p => p.getAge() > 30){{< /highlight >}}|
|distinct()|{{< highlight csharp >}}
 persons.distinct(){{< /highlight >}}|
|first()|{{< highlight csharp >}}
 persons.first(){{< /highlight >}}|
|first(Predicate)|{{< highlight csharp >}}
 persons.first(p => p.getAge() > 30){{< /highlight >}}|
|firstOrDefault()|{{< highlight csharp >}}
 persons.firstOrDefault(){{< /highlight >}}|
|firstOrDefault(Predicate)|{{< highlight csharp >}}
 persons.firstOrDefault(p => p.getAge() > 30){{< /highlight >}}|
|groupBy(Selector)|{{< highlight csharp >}}
 persons.groupBy(p => p.getAge()){{< /highlight >}}Or {{< highlight csharp >}}
 persons.groupBy(p => new { age = p.getAge(), count = p.getChildren().count() }){{< /highlight >}}This method returns an enumeration of group objects. Each group has a unique key defined by the input selector and contains items of the source enumeration associated with this key. You can access the key of a group instance using the Key field. You can treat a group itself as an enumeration of items that the group contains. |
|last()|{{< highlight csharp >}}
 persons.last(){{< /highlight >}}|
|last(Predicate)|{{< highlight csharp >}}
 persons.last(p => p.getAge() > 100){{< /highlight >}}|
|lastOrDefault()|{{< highlight csharp >}}
 persons.lastOrDefault(){{< /highlight >}}|
|lastOrDefault(Predicate)|{{< highlight csharp >}}
 persons.lastOrDefault(p => p.getAge() > 100){{< /highlight >}}|
|max(ComparableSelector)|{{< highlight csharp >}}
 persons.max(p => p.getAge()){{< /highlight >}}|
|min(ComparableSelector)|{{< highlight csharp >}}
 persons.min(p => p.getAge()){{< /highlight >}}|
|orderBy(ComparableSelector)|{{< highlight csharp >}}
 persons.orderBy(p => p.getAge()){{< /highlight >}}Or {{< highlight csharp >}}
 persons.orderBy(p => p.getAge()).thenByDescending(p => p.getName()){{< /highlight >}}Or {{< highlight csharp >}}
 persons.orderBy(p => p.getAge()).thenByDescending(p => p.getName()).thenBy(p => p.getChildren().count()){{< /highlight >}}This method returns an enumeration ordered by a single key. To specify additional ordering keys, you can use the following extension methods of an ordered enumeration:<br>- thenBy(ComparableSelector)<br>- thenByDescending(ComparableSelector)|
|orderByDescending(ComparableSelector)|{{< highlight csharp >}}
 persons.orderByDescending(p => p.getAge()){{< /highlight >}}Or {{< highlight csharp >}}
 persons.orderByDescending(p => p.getAge()).thenByDescending(p => p.getName()){{< /highlight >}}Or {{< highlight csharp >}}
 persons.orderByDescending(p => p.getAge()).thenByDescending(p => p.getName())    .thenBy(p => p.getChildren().count()){{< /highlight >}}See the previous note. |
|select(Selector)|{{< highlight csharp >}}persons.select(p => p.getName()){{< /highlight >}}|
|selectMany(EnumerationSelector)|{{< highlight csharp >}}persons.selectMany(p => p.getChildren()){{< /highlight >}}|
|single()|{{< highlight csharp >}}
 persons.single(){{< /highlight >}}|
|single(Predicate)|{{< highlight csharp >}}
 persons.single(p => p.getName() == "John Smith"){{< /highlight >}}|
|singleOrDefault()|{{< highlight csharp >}}
 persons.singleOrDefault(){{< /highlight >}}|
|singleOrDefault(Predicate)|{{< highlight csharp >}}
 persons.singleOrDefault(p => p.getName() == "John Smith"){{< /highlight >}}|
|skip(int)|{{< highlight csharp >}}
 persons.skip(10){{< /highlight >}}|
|skipWhile(Predicate)|{{< highlight csharp >}}
 persons.skipWhile(p => p.getAge() < 21){{< /highlight >}}|
|sum(Selector)|{{< highlight csharp >}}
 persons.sum(p => p.getChildren().count()){{< /highlight >}}The input selector must return a value of any type that has a predefined addition operator. |
|take(int)|{{< highlight csharp >}}
 persons.take(5){{< /highlight >}}|
|takeWhile(Predicate)|{{< highlight csharp >}}
 persons.takeWhile(p => p.getAge() < 50){{< /highlight >}}|
|union(Iterable)|{{< highlight csharp >}}
 persons.union(otherPersons){{< /highlight >}}An implicit reference conversion must exist between types of items of united enumerations. |
|where(Predicate)|{{< highlight csharp >}}
 persons.where(p => p.getAge() > 18){{< /highlight >}}|
---

## Enumeration Extension Methods

Path: /assembly/net/enumeration-extension-methods/

LINQ Reporting Engine enables you to perform common manipulations on a sequential data through the engine's built-in extension methods for `IEnumerable`. These extension methods mimic some extension methods of [IEnumerable&lt;T&gt;](http://msdn.microsoft.com/en-us/library/9eekhta0\(v=vs.110\).aspx) providing the same signatures and behavior features. Thus you can group, sort and perform other sequential data manipulations in template expressions in a familiar way.

The following table describes these built-in extension methods. The following notation conventions are used within the table:

- `Selector` stands for a lambda function returning a value and taking an enumeration item as its single argument. See “Using Lambda Functions” for more information.
- `ComparableSelector` stands for `Selector` returning [IComparable](http://msdn.microsoft.com/en-US/library/system.icomparable\(v=vs.110\).aspx).
- `EnumerationSelector` stands for `Selector` returning `IEnumerable`.
- `Predicate` stands for `Selector` returning a Boolean value.

Examples in the following table are given using persons and `otherPersons`, enumerations of instances of the `Person` class that is defined as follows.

{{< highlight csharp >}}
public class Person
{
    public String Name { get { ... } }
    public int Age { get { ... } }
    public IEnumerable<Person> Children { get { ... } }
    ...
}
{{< /highlight >}}

|Extension Method |Examples and Notes |
| :- | :- |
|All(Predicate)|{{< highlight csharp >}}
persons.All(p => p.Age < 50){{< /highlight >}}|
|Any()|{{< highlight csharp >}}
persons.Any(){{< /highlight >}}|
|Any(Predicate)|{{< highlight csharp >}}
persons.Any(p => p.Name == "John Smith"){{< /highlight >}}|
|Average(Selector)|{{< highlight csharp >}}
persons.Average(p => p.Age){{< /highlight >}}The input selector must return a value of any type that has predefined or user-defined addition and division operators. |
|Concat(IEnumerable)|{{< highlight csharp >}}
persons.Concat(otherPersons){{< /highlight >}}An implicit reference conversion must exist between types of items of concatenated enumerations. |
|Contains(Object)|{{< highlight csharp >}}
persons.Contains(otherPersons.First()){{< /highlight >}}|
|Count()|{{< highlight csharp >}}
persons.Count(){{< /highlight >}}|
|Count(Predicate)|{{< highlight csharp >}}
persons.Count(p => p.Age > 30){{< /highlight >}}|
|Distinct()|{{< highlight csharp >}}
persons.Distinct(){{< /highlight >}}|
|First()|{{< highlight csharp >}}
persons.First(){{< /highlight >}}|
|First(Predicate)|{{< highlight csharp >}}
persons.First(p => p.Age > 30){{< /highlight >}}|
|FirstOrDefault()|{{< highlight csharp >}}
persons.FirstOrDefault(){{< /highlight >}}|
|FirstOrDefault(Predicate)|{{< highlight csharp >}}
persons.FirstOrDefault(p => p.Age > 30){{< /highlight >}}|
|GroupBy(Selector)|{{< highlight csharp >}}
persons.GroupBy(p => p.Age){{< /highlight >}}Or {{< highlight csharp >}}
persons.GroupBy(    p => new { Age = p.Age, Count = p.Children.Count() }){{< /highlight >}}This method returns an enumeration of group objects. Each group has a unique key defined by the input selector and contains items of the source enumeration associated with this key. You can access the key of a group instance using the Key property. You can treat a group itself as an enumeration of items that the group contains. |
|Last()|{{< highlight csharp >}}
persons.Last(){{< /highlight >}}|
|Last(Predicate)|{{< highlight csharp >}}
persons.Last(p => p.Age > 100){{< /highlight >}}|
|LastOrDefault()|{{< highlight csharp >}}
persons.LastOrDefault(){{< /highlight >}}|
|LastOrDefault(Predicate)|{{< highlight csharp >}}
persons.LastOrDefault(p => p.Age > 100){{< /highlight >}}|
|Max(ComparableSelector)|{{< highlight csharp >}}
persons.Max(p => p.Age){{< /highlight >}}|
|Min(ComparableSelector)|{{< highlight csharp >}}
persons.Min(p => p.Age){{< /highlight >}}|
|OrderBy(ComparableSelector)|{{< highlight csharp >}}
persons.OrderBy(p => p.Age){{< /highlight >}}Or {{< highlight csharp >}}
persons.OrderBy(p => p.Age).ThenByDescending(p => p.Name){{< /highlight >}}Or {{< highlight csharp >}}
persons.OrderBy(p => p.Age).ThenByDescending(p => p.Name).ThenBy(p => p.Children.Count()){{< /highlight >}}This method returns an enumeration ordered by a single key. To specify additional ordering keys, you can use the following extension methods of an ordered enumeration:- ThenBy(ComparableSelector)- ThenByDescending(ComparableSelector)|
|OrderByDescending(ComparableSelector)|{{< highlight csharp >}}
persons.OrderByDescending(p => p.Age){{< /highlight >}}Or {{< highlight csharp >}}
persons.OrderByDescending(p => p.Age).ThenByDescending(p => p.Name){{< /highlight >}}Or {{< highlight csharp >}}
persons.OrderByDescending(p => p.Age).ThenByDescending(p => p.Name).ThenBy(p => p.Children.Count()){{< /highlight >}}See the previous note. |
|Select(Selector)|{{< highlight csharp >}}
persons.Select(p => p.Name){{< /highlight >}}|
|SelectMany(EnumerationSelector)|{{< highlight csharp >}}
persons.SelectMany(p => p.Children){{< /highlight >}}|
|Single()|{{< highlight csharp >}}
persons.Single(){{< /highlight >}}|
|Single(Predicate)|{{< highlight csharp >}}
persons.Single(p => p.Name == "John Smith"){{< /highlight >}}|
|SingleOrDefault()|{{< highlight csharp >}}
persons.SingleOrDefault(){{< /highlight >}}|
|SingleOrDefault(Predicate)|{{< highlight csharp >}}
persons.SingleOrDefault(p => p.Name == "John Smith"){{< /highlight >}}|
|Skip(int)|{{< highlight csharp >}}
persons.Skip(10){{< /highlight >}}|
|SkipWhile(Predicate)|{{< highlight csharp >}}
persons.SkipWhile(p => p.Age < 21){{< /highlight >}}|
|Sum(Selector)|{{< highlight csharp >}}
persons.Sum(p => p.Children.Count()){{< /highlight >}}The input selector must return a value of any type that has a predefined or user-defined addition operator. |
|Take(int)|{{< highlight csharp >}}
persons.Take(5){{< /highlight >}}|
|TakeWhile(Predicate)|{{< highlight csharp >}}
persons.TakeWhile(p => p.Age < 50){{< /highlight >}}|
|Union(IEnumerable)|{{< highlight csharp >}}
persons.Union(otherPersons){{< /highlight >}}An implicit reference conversion must exist between types of items of united enumerations. |
|Where(Predicate)|{{< highlight csharp >}}
persons.Where(p => p.Age > 18){{< /highlight >}}|
---

## Existing objects in PDF document

Path: /watermark/net/existing-objects-in-pdf-document/

## Removing watermark from a particular page

Removing watermark from a particular page of PDF document using GroupDocs.Watermark consists of following steps.

1. Load the document
2. Create and initialize Image/text search criteria
3. Find watermarks
4. Remove watermarks
5. Save the document

Following code sample removes watermarks from a particular page.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveWatermark**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    // Initialize search criteria
    ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");
    TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");

    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    PossibleWatermarkCollection possibleWatermarks = pdfContent.Pages[0]
        .Search(imageSearchCriteria.Or(textSearchCriteria));

    // Remove all found watermarks
    for (int i = possibleWatermarks.Count - 1; i >= 0; i--)
    {
        possibleWatermarks.RemoveAt(i);
    }

    watermarker.Save("document.pdf");
}
```

[*Search*](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/search/methods/1)method searches watermarks of all mentioned types, but in some cases, it's necessary to analyze only one class of PDF entities. The following articles specifically deal with different types of the watermark objects in a PDF document.

## Working with XObjects

### Extracting information about all XObjects in PDF document

Using GroupDocs.Watermark for .NET, you can extract information about all the [XObjects](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfxobject) in a PDF document. Following code sample performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfExtractXObjectInformation**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfPage page in pdfContent.Pages)
    {
        foreach (PdfXObject xObject in page.XObjects)
        {
            if (xObject.Image != null)
            {
                Console.WriteLine(xObject.Image.Width);
                Console.WriteLine(xObject.Image.Height);
                Console.WriteLine(xObject.Image.GetBytes().Length);
            }

            Console.WriteLine(xObject.Text);
            Console.WriteLine(xObject.X);
            Console.WriteLine(xObject.Y);
            Console.WriteLine(xObject.Width);
            Console.WriteLine(xObject.Height);
            Console.WriteLine(xObject.RotateAngle);
        }
    }
}
```

### Removing a particular XObject

You can also remove an XObject from a page using GroupDocs.Watermark. Following code sample removes an XObject from a particular page.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveXObject**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Remove XObject by index
    pdfContent.Pages[0].XObjects.RemoveAt(0);

    // Remove XObject by reference
    pdfContent.Pages[0].XObjects.Remove(pdfContent.Pages[0].XObjects[0]);

    watermarker.Save("document.pdf");
}
```

### Removing XObjects containing text with particular text formatting

You can also find and remove all XObjects containing [text with a particular formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/formattedtextfragments) from a PDF document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveXObjectWithParticularTextFormatting**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfPage page in pdfContent.Pages)
    {
        for (int i = page.XObjects.Count - 1; i >= 0; i--)
        {
            foreach (FormattedTextFragment fragment in page.XObjects[i].FormattedTextFragments)
            {
                if (fragment.ForegroundColor == Color.Red)
                {
                    page.XObjects.RemoveAt(i);
                    break;
                }
            }
        }
    }

    watermarker.Save("document.pdf");
}
```

### Adding watermark to all image XObjects

GroupDocs.Watermark API allows you to add watermark to all [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/image) XObjects in a PDF document. Following code sample serves this purpose.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfAddWatermarkToXObjects**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;

    foreach (PdfPage page in pdfContent.Pages)
    {
        foreach (PdfXObject xObject in page.XObjects)
        {
            if (xObject.Image != null)
            {
                // Add watermark to the image
                xObject.Image.Add(watermark);
            }
        }
    }

    watermarker.Save("document.pdf");
}
```

### Replacing text for particular XObjects

GroupDocs.Watermark allows you to edit and replace the text of the particular XObject. You can also replace XObject's [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/text) with formatting as shown in the below code samples.

#### Replacing text

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceTextForParticularXObject**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfXObject xObject in pdfContent.Pages[0].XObjects)
    {
        // Replace text
        if (xObject.Text.Contains("Test"))
        {
            xObject.Text = "Passed";
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

#### Replacing text with formatting

**AdvancedUsage.AddWatermarksToPdf.ReplaceTextForParticularXObjectWithFormatting**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfXObject xObject in pdfContent.Pages[0].XObjects)
    {
        // Replace text
        if (xObject.Text.Contains("Test"))
        {
            xObject.FormattedTextFragments.Clear();
            xObject.FormattedTextFragments
                .Add("Passed", new Font("Calibri", 19, FontStyle.Bold), Color.Red, Color.Aqua);
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

### Replacing image for particular XObjects

Using GroupDocs.Watermark, you can also replace the image of a particular XObject. GroupDocs.Watermark allows you to loop through all the [XObjects](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfpage/properties/xobjects) of a particular page and you can replace the [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/image) of particular XObjects using some condition as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceImageForParticularXObject**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Replace image
    foreach (PdfXObject xObject in pdfContent.Pages[0].XObjects)
    {
        if (xObject.Image != null)
        {
            xObject.Image = new PdfWatermarkableImage(File.ReadAllBytes("test.png"));
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

### Working with artifacts

#### Extracting information about all artifacts in PDF document

GroupDocs.Watermark enables you to extract the information about the [artifacts](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfpage/properties/artifacts) in a PDF document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfExtractArtifactInformation**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfPage page in pdfContent.Pages)
    {
        foreach (PdfArtifact artifact in page.Artifacts)
        {
            Console.WriteLine(artifact.ArtifactType);
            Console.WriteLine(artifact.ArtifactSubtype);
            if (artifact.Image != null)
            {
                Console.WriteLine(artifact.Image.Width);
                Console.WriteLine(artifact.Image.Height);
                Console.WriteLine(artifact.Image.GetBytes().Length);
            }

            Console.WriteLine(artifact.Text);
            Console.WriteLine(artifact.Opacity);
            Console.WriteLine(artifact.X);
            Console.WriteLine(artifact.Y);
            Console.WriteLine(artifact.Width);
            Console.WriteLine(artifact.Height);
            Console.WriteLine(artifact.RotateAngle);
        }
    }
}
```

#### Removing a particular artifact

Following code sample shows how to remove an [artifact](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfartifact) from a particular page of the PDF document.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveArtifact**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Remove Artifact by index
    pdfContent.Pages[0].Artifacts.RemoveAt(0);

    // Remove Artifact by reference
    pdfContent.Pages[0].Artifacts.Remove(pdfContent.Pages[0].Artifacts[0]);

    watermarker.Save("document.pdf");
}
```

#### Removing artifacts containing text with particular text formatting

You can also find and remove all artifacts containing [text with a particular formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/formattedtextfragments) from a PDF document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveArtifactsWithParticularTextFormatting**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfPage page in pdfContent.Pages)
    {
        for (int i = page.Artifacts.Count - 1; i >= 0; i--)
        {
            foreach (FormattedTextFragment fragment in page.Artifacts[i].FormattedTextFragments)
            {
                if (fragment.Font.Size > 42)
                {
                    page.Artifacts.RemoveAt(i);
                    break;
                }
            }
        }
    }

    watermarker.Save("document.pdf");
}
```

#### Adding watermark to all image artifacts

GroupDocs.Watermark API also provides the feature of adding watermark to all image artifacts in a PDF document. Following code sample adds watermark to all [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/image) artifacts.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfAddWatermarkToImageArtifacts**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;

    foreach (PdfPage page in pdfContent.Pages)
    {
        foreach (PdfArtifact artifact in page.Artifacts)
        {
            if (artifact.Image != null)
            {
                // Add watermark to the image
                artifact.Image.Add(watermark);
            }
        }
    }

    watermarker.Save("document.pdf");
}
```

#### Replacing text for particular artifacts

GroupDocs.Watermark allows you to edit and replace the [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfartifact/properties/text) of the particular artifacts. You can also replace artifact's [text with formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/formattedtextfragments) as shown in the below code samples.

##### Replacing artifact text

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceTextForParticularArtifact**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfArtifact artifact in pdfContent.Pages[0].Artifacts)
    {
        // Replace text
        if (artifact.Text.Contains("Test"))
        {
            artifact.Text = "Passed";
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

##### Replacing artifact text with formatting

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceTextForParticularArtifactWithFormatting**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfArtifact artifact in pdfContent.Pages[0].Artifacts)
    {
        // Replace text
        if (artifact.Text.Contains("Test"))
        {
            artifact.FormattedTextFragments.Clear();
            artifact.FormattedTextFragments.Add("Passed",
                new Font("Calibri", 19, FontStyle.Bold), Color.Red, Color.Aqua);
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

#### Replacing image for particular artifacts

Using GroupDocs.Watermark, you can also replace the image of a particular artifact. GroupDocs.Watermark allows you to loop through all the [artifacts](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfpage/properties/artifacts) of a particular page and you can replace the [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/image) of particular artifacts using some condition as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceImageForParticularArtifact**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Replace image
    foreach (PdfArtifact artifact in pdfContent.Pages[0].Artifacts)
    {
        if (artifact.Image != null)
        {
            artifact.Image = new PdfWatermarkableImage(File.ReadAllBytes("test.png"));
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

### Working with annotations

#### Extracting information about all annotations in PDF document

You can also extract information about all the [annotations](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfpage/properties/annotations) in a PDF document using GroupDocs.Watermark as shown in below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfExtractAnnotationInformation**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfPage page in pdfContent.Pages)
    {
        foreach (PdfAnnotation annotation in page.Annotations)
        {
            Console.WriteLine(annotation.AnnotationType);
            if (annotation.Image != null)
            {
                Console.WriteLine(annotation.Image.Width);
                Console.WriteLine(annotation.Image.Height);
                Console.WriteLine(annotation.Image.GetBytes().Length);
            }

            Console.WriteLine(annotation.Text);
            Console.WriteLine(annotation.X);
            Console.WriteLine(annotation.Y);
            Console.WriteLine(annotation.Width);
            Console.WriteLine(annotation.Height);
            Console.WriteLine(annotation.RotateAngle);
        }
    }
}
```

#### Removing a particular annotation

Following code sample can be used to remove a particular [annotation](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfannotation) from a PDF document.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveAnnotation**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Remove Annotation by index
    pdfContent.Pages[0].Annotations.RemoveAt(0);

    // Remove Annotation by reference
    pdfContent.Pages[0].Annotations.Remove(pdfContent.Pages[0].Annotations[0]);

    watermarker.Save("document.pdf");
}
```

#### Removing annotations containing text with particular text formatting

You can also find and remove all annotations containing [text with a particular formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/formattedtextfragments) from a PDF document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRemoveAnnotationsWithParticularTextFormatting**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfPage page in pdfContent.Pages)
    {
        for (int i = page.Annotations.Count - 1; i >= 0; i--)
        {
            foreach (FormattedTextFragment fragment in page.Annotations[i].FormattedTextFragments)
            {
                if (fragment.Font.FamilyName == "Verdana")
                {
                    page.Annotations.RemoveAt(i);
                    break;
                }
            }
        }
    }

    watermarker.Save("document.pdf");
}
```

#### Adding watermark to all image annotations

Similar to the other types, the watermark can be added to [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/image) annotations in PDF documents as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfAddWatermarkToAnnotationImages**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;

    foreach (PdfPage page in pdfContent.Pages)
    {
        foreach (PdfAnnotation annotation in page.Annotations)
        {
            if (annotation.Image != null)
            {
                // Add watermark to the image
                annotation.Image.Add(watermark);
            }
        }
    }

    watermarker.Save("document.pdf");
}
```

#### Replacing text for particular annotations

GroupDocs.Watermark allows you to edit and replace the [text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/text) of the particular annotations. You can also replace annotation's [text with formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/formattedtextfragments) as shown in the below code samples.

##### Replacing annotation text

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceTextForParticularAnnotation**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfAnnotation annotation in pdfContent.Pages[0].Annotations)
    {
        // Replace text
        if (annotation.Text.Contains("Test"))
        {
            annotation.Text = "Passed";
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

##### Replacing annotation text with formatting

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceTextForParticularAnnotationWithFormatting**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    foreach (PdfAnnotation annotation in pdfContent.Pages[0].Annotations)
    {
        // Replace text
        if (annotation.Text.Contains("Test"))
        {
            annotation.FormattedTextFragments.Clear();
            annotation.FormattedTextFragments.Add("Passed", 
                new Font("Calibri", 19, FontStyle.Bold), Color.Red, Color.Aqua);
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

#### Replacing image for particular annotations

Using GroupDocs.Watermark, you can also replace the image of a particular annotation. GroupDocs.Watermark allows you to loop through all the annotations of a particular page and you can replace the [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfshape/properties/image) of particular annotations using some condition as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfReplaceImageForParticularAnnotation**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Replace image
    foreach (PdfAnnotation annotation in pdfContent.Pages[0].Annotations)
    {
        if (annotation.Image != null)
        {
            annotation.Image = new PdfWatermarkableImage(File.ReadAllBytes("test.png"));
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```


---

## Existing objects in PDF document

Path: /watermark/python-net/existing-objects-in-pdf-document/


## Removing watermark from a particular page
This sample searches a specific page for objects matching image or text criteria and removes the found items.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.search.searchcriteria as gws_sc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    image_criteria = gws_sc.ImageDctHashSearchCriteria("logo.png")
    text_criteria = gws_sc.TextSearchCriteria("Company Name")

    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    possible = pdf_content.pages[0].search(image_criteria.or_(text_criteria))
    for i in range(len(possible) - 1, -1, -1):
        possible.remove_at(i)

    watermarker.save("document.pdf")
```

## Working with XObjects
These samples read and modify XObjects (reusable content) on PDF pages, including extracting info, deleting, watermarking images, and replacing text or images.

### Extracting information about all XObjects in PDF document
This sample iterates through all XObjects on all pages and prints basic image, text, position, size, and rotation details.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for page in pdf_content.pages:
        for xobj in page.x_objects:
            if xobj.image is not None:
                print(xobj.image.width)
                print(xobj.image.height)
                print(len(xobj.image.get_bytes()))

            print(xobj.text)
            print(xobj.x)
            print(xobj.y)
            print(xobj.width)
            print(xobj.height)
            print(xobj.rotate_angle)
```

### Removing a particular XObject
This sample removes XObjects by index and by reference from a selected page and then saves the document.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    page = pdf_content.pages[0]
    page.x_objects.remove_at(0)
    page.x_objects.remove(page.x_objects[0])
    watermarker.save("document.pdf")
```

### Removing XObjects containing text with particular text formatting
This sample scans XObjects for formatted text fragments and removes those that match a specific formatting condition (e.g., red foreground color).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for page in pdf_content.pages:
        for i in range(page.x_objects.count - 1, -1, -1):
            for fragment in page.x_objects[i].formatted_text_fragments:
                if fragment.foreground_color == gww.Color.red:
                    page.x_objects.remove_at(i)
                    break

    watermarker.save("document.pdf")
```

### Adding watermark to all image XObjects
This sample overlays a centered, rotated text watermark onto every image contained inside XObjects across all pages.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    for page in pdf_content.pages:
        for xobj in page.x_objects:
            if xobj.image is not None:
                xobj.image.add(watermark)

    watermarker.save("document.pdf")
```

### Replacing text for particular XObjects
These samples demonstrate updating XObject text content, either plain replacement or with custom font and colors.

#### Replacing text
This sample finds XObjects whose text contains a target substring and replaces it with new plain text.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for xobj in pdf_content.pages[0].x_objects:
        if "Test" in (xobj.text or ""):
            xobj.text = "Passed"

    watermarker.save("document.pdf")
```

#### Replacing text with formatting
This sample clears existing formatted fragments and inserts new text with specific font, style, and colors.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for xobj in pdf_content.pages[0].x_objects:
        if "Test" in (xobj.text or ""):
            xobj.formatted_text_fragments.clear()
            xobj.formatted_text_fragments.add(
                "Passed", gww.Font("Calibri", 19.0, gww.FontStyle.BOLD), gww.Color.red, gww.Color.aqua
            )

    watermarker.save("document.pdf")
```

### Replacing image for particular XObjects
This sample replaces the image content of XObjects with a new image loaded from disk.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for xobj in pdf_content.pages[0].x_objects:
        if xobj.image is not None:
            with open("test.png", "rb") as f:
                xobj.image = gwc_pdf.PdfWatermarkableImage(f.read())

    watermarker.save("document.pdf")
```

## Working with artifacts
These samples operate on PDF artifacts (headers, footers, watermarks, etc.), allowing extraction, deletion, conditional removal, watermarking, and content replacement.

### Extracting information about all artifacts in PDF document
This sample iterates all artifacts on all pages and prints type, image details, text, opacity, position, size, and rotation.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for page in pdf_content.pages:
        for artifact in page.artifacts:
            print(artifact.artifact_type)
            print(artifact.artifact_subtype)
            if artifact.image is not None:
                print(artifact.image.width)
                print(artifact.image.height)
                print(len(artifact.image.get_bytes()))

            print(artifact.text)
            print(artifact.opacity)
            print(artifact.x)
            print(artifact.y)
            print(artifact.width)
            print(artifact.height)
            print(artifact.rotate_angle)
```

### Removing a particular artifact
This sample removes artifacts by index and reference from a given page and saves the result.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    page = pdf_content.pages[0]
    page.artifacts.remove_at(0)
    page.artifacts.remove(page.artifacts[0])
    watermarker.save("document.pdf")
```

### Removing artifacts containing text with particular text formatting
This sample deletes artifacts that contain text fragments satisfying a formatting rule (for example, font size greater than a threshold).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for page in pdf_content.pages:
        for i in range(page.artifacts.count - 1, -1, -1):
            for fragment in page.artifacts[i].formatted_text_fragments:
                if fragment.font.size > 42:
                    page.artifacts.remove_at(i)
                    break

    watermarker.save("document.pdf")
```

### Adding watermark to all image artifacts
This sample applies a centered, rotated text watermark to every artifact that contains an image.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    for page in pdf_content.pages:
        for artifact in page.artifacts:
            if artifact.image is not None:
                artifact.image.add(watermark)

    watermarker.save("document.pdf")
```

### Replacing text for particular artifacts
These samples show how to replace artifact text directly or recreate it with custom formatting.

#### Replacing artifact text
This sample replaces plain artifact text when it contains a target substring.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for artifact in pdf_content.pages[0].artifacts:
        if "Test" in (artifact.text or ""):
            artifact.text = "Passed"

    watermarker.save("document.pdf")
```

#### Replacing artifact text with formatting
This sample clears existing formatted text and adds new text with chosen font, style, and colors.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for artifact in pdf_content.pages[0].artifacts:
        if "Test" in (artifact.text or ""):
            artifact.formatted_text_fragments.clear()
            artifact.formatted_text_fragments.add(
                "Passed", gww.Font("Calibri", 19.0, gww.FontStyle.BOLD), gww.Color.red, gww.Color.aqua
            )

    watermarker.save("document.pdf")
```

### Replacing image for particular artifacts
This sample replaces the image of matching artifacts with a new image loaded from disk.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for artifact in pdf_content.pages[0].artifacts:
        if artifact.image is not None:
            with open("test.png", "rb") as f:
                artifact.image = gwc_pdf.PdfWatermarkableImage(f.read())

    watermarker.save("document.pdf")
```

## Working with annotations
These samples work with PDF annotations: extracting details, removing, conditionally deleting, watermarking images, and replacing text or images.

### Extracting information about all annotations in PDF document
This sample walks through all annotations on all pages and prints image stats, text, position, size, and rotation.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for page in pdf_content.pages:
        for annotation in page.annotations:
            print(annotation.annotation_type)
            if annotation.image is not None:
                print(annotation.image.width)
                print(annotation.image.height)
                print(len(annotation.image.get_bytes()))

            print(annotation.text)
            print(annotation.x)
            print(annotation.y)
            print(annotation.width)
            print(annotation.height)
            print(annotation.rotate_angle)
```

### Removing a particular annotation
This sample removes annotations from a page using index and reference methods and saves the document.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    page = pdf_content.pages[0]
    page.annotations.remove_at(0)
    page.annotations.remove(page.annotations[0])
    watermarker.save("document.pdf")
```

### Removing annotations containing text with particular text formatting
This sample deletes annotations whose formatted text fragments meet a specific condition (e.g., a particular font family).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for page in pdf_content.pages:
        for i in range(page.annotations.count - 1, -1, -1):
            for fragment in page.annotations[i].formatted_text_fragments:
                if fragment.font.family_name == "Verdana":
                    page.annotations.remove_at(i)
                    break

    watermarker.save("document.pdf")
```

### Adding watermark to all image annotations
This sample places a centered, rotated text watermark over every annotation image in the document.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    for page in pdf_content.pages:
        for annotation in page.annotations:
            if annotation.image is not None:
                annotation.image.add(watermark)

    watermarker.save("document.pdf")
```

### Replacing text for particular annotations
These samples demonstrate replacing annotation text, either plain or with full formatting control.

#### Replacing annotation text
This sample replaces plain annotation text when it contains a target substring.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for annotation in pdf_content.pages[0].annotations:
        if "Test" in (annotation.text or ""):
            annotation.text = "Passed"

    watermarker.save("document.pdf")
```

#### Replacing annotation text with formatting
This sample clears existing formatted annotation text and adds new formatted content with specific font and colors.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for annotation in pdf_content.pages[0].annotations:
        if "Test" in (annotation.text or ""):
            annotation.formatted_text_fragments.clear()
            annotation.formatted_text_fragments.add(
                "Passed", gww.Font("Calibri", 19.0, gww.FontStyle.BOLD), gww.Color.red, gww.Color.aqua
            )

    watermarker.save("document.pdf")
```

### Replacing image for particular annotations
This sample replaces the image within annotations with a new image read from disk.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    for annotation in pdf_content.pages[0].annotations:
        if annotation.image is not None:
            with open("test.png", "rb") as f:
                annotation.image = gwc_pdf.PdfWatermarkableImage(f.read())

    watermarker.save("document.pdf")
```



---

## Extract barcodes from document page

Path: /parser/java/extract-barcodes-from-document-page/


GroupDocs.Parser provides the functionality to extract barcodes from documents by the [GetBarcodes](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getBarcodes(int)) method:

```java
Iterable<PageBarcodeArea> getBarcodes(int pageIndex)
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [Rectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [Value](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea#getValue()) | A string value that represents a value of the barcode page area. |
| [CodeTypeName](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea#getCodeTypeName()) | A string value than represents a type name of the barcode. |

Here are the steps to extract all barcodes from the whole document:

- Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser) object for the initial document;
- Check if the document supports barcodes extraction;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getBarcodes(int)) method with the page index and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to extract barcodes from a document page:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdfWithBarcodes)) {
	// Check if the document supports barcodes extraction
	if (!parser.getFeatures().isBarcodes()) {
		System.out.println("Document doesn't support barcodes extraction.");
		return;
	}

	// Extract barcodes from the second document page.
	Iterable<PageBarcodeArea> barcodes = parser.getBarcodes(1);

	// Iterate over barcodes
	for (PageBarcodeArea barcode : barcodes) {
		// Print the page index
		System.out.println("Page: " + barcode.getPage().getIndex());
		// Print the barcode value
		System.out.println("Value: " + barcode.getValue());
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract barcodes from document page

Path: /parser/net/extract-barcodes-from-document-page/


GroupDocs.Parser provides the functionality to extract barcodes from documents by the [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/getbarcodes/methods/2) method:

```csharp
IEnumerable<PageBarcodeArea> GetBarcodes(int pageIndex);
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [Value](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/properties/value) | A string value that represents a value of the barcode page area. |
| [CodeTypeName](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/properties/codetypename) | A string value than represents a type name of the barcode. |
| [Confidence](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/confidence/) | The level of confidence of the parsered barcode. |
| [Angle](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/angle/) | The angle of the barcode. |

Here are the steps to extract all barcodes from the whole document:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
- Check if the document supports barcodes extraction;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/getbarcodes/methods/2) method with the page index and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to extract barcodes from a document page:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Check if the document supports barcodes extraction
    if (!parser.Features.Barcodes)
    {
        Console.WriteLine("Document doesn't support barcodes extraction.");
        return;
    }

    // Extract barcodes from the second document page.
    IEnumerable<PageBarcodeArea> barcodes = parser.GetBarcodes(1);

    // Iterate over barcodes
    foreach (PageBarcodeArea barcode in barcodes)
    {
        // Print the page index
        Console.WriteLine("Page: " + barcode.Page.Index.ToString());
        // Print the barcode value
        Console.WriteLine("Value: " + barcode.Value);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online Barcode Scanner App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to scan barcode from your files or mobile phone camera with our free online [GroupDocs Scanner App](https://products.groupdocs.app/scanner/scan-barcode) which is build with GroupDocs.Parser .Net.
---

## Extract formatted text from document page

Path: /parser/java/extract-formatted-text-from-document-page/

GroupDocs.Parser provides the functionality to extract a formatted text from document page by the [getFormattedText(int, FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(int,%20com.groupdocs.parser.options.FormattedTextOptions)) method:

```java
TextReader getFormattedText(int pageIndex, FormattedTextOptions options);
```

The method returns an instance of [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class with an extracted text. [FormattedTextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextOptions) has the following constructor:

```java
FormattedTextOptions(FormattedTextMode mode);
```

[FormattedTextMode](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/FormattedTextMode) enumeration has the following members:

| Member | Description |
| --- | --- |
| Html | HTML format. |
| Markdown | Markdown format. |
| PlainText | Plain text format. |

[TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class extends [*java.io.Reader*](http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true) and adds the following members:

| Member | Description |
| --- | --- |
| [readLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readLine()) | Reads a line of characters from the text reader and returns the data as a string. |
| [readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) | Reads all characters from the current position to the end of the text reader and returns them as one string. |

Here are the steps to extract a HTML formatted page text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [FormattedTextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextOptions) with HTML text mode;
*   Call [getFormattedText(int, FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(int,%20com.groupdocs.parser.options.FormattedTextOptions)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Check if *reader* isn't *null* (formatted text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a document page text as Markdown text:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Check if the document supports formatted text extraction
    if (!parser.getFeatures().isFormattedText()) {
        System.out.println("Document isn't supports formatted text extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Check if the document has pages
    if (documentInfo.getPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.getPageCount(); p++) {
        // Print a page number 
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a formatted text into the reader
        try (TextReader reader = parser.getFormattedText(p, new FormattedTextOptions(FormattedTextMode.Markdown))) {
            // Print a formatted text from the document
            // We ignore null-checking as we have checked formatted text extraction feature support earlier
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document page

Path: /parser/python-net/extract-hyperlinks-from-document-page/


GroupDocs.Parser allows extracting hyperlinks from specific pages of a document, providing page-by-page hyperlink processing.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents with hyperlinks
- Understanding of page indexing (zero-based)

## Extract hyperlinks from a specific page

To extract hyperlinks from a particular page:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./document.pdf") as parser:
    # Check if hyperlink extraction is supported
    if not parser.features.hyperlinks:
        print("Hyperlink extraction not supported")
        return
    
    # Extract hyperlinks from page 0 (first page)
    page_index = 0
    hyperlinks = parser.get_hyperlinks(page_index)
    
    if hyperlinks:
        print(f"Hyperlinks on page {page_index + 1}:")
        for link in hyperlinks:
            print(f"  Text: {link.text}")
            print(f"  URL: {link.url}")
            print()
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns only hyperlinks from the specified page.

## Extract hyperlinks from all pages

To process hyperlinks page by page:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("report.docx") as parser:
    if not parser.features.hyperlinks:
        print("Hyperlink extraction not supported")
        return
    
    # Get document info
    info = parser.get_document_info()
    
    if info.page_count == 0:
        print("Document has no pages")
        return
    
    # Iterate over pages
    total_links = 0
    
    for page_index in range(info.page_count):
        print(f"
=== Page {page_index + 1}/{info.page_count} ===")
        
        # Extract hyperlinks from current page
        hyperlinks = parser.get_hyperlinks(page_index)
        
        if hyperlinks:
            page_links = list(hyperlinks)
            print(f"Found {len(page_links)} hyperlinks:")
            
            for link in page_links:
                print(f"  • {link.text} -> {link.url}")
            
            total_links += len(page_links)
        else:
            print("No hyperlinks on this page")
    
    print(f"
Total hyperlinks: {total_links}")
```

{{< /tab >}}
{{< tab "report.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [report.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page/report.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Iterates through all pages and extracts hyperlinks from each page individually.

## Export page hyperlinks to JSON

To export hyperlinks organized by page:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import json

def export_page_hyperlinks(file_path, output_json):
    """
    Extract hyperlinks by page and export to JSON.
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return False
        
        info = parser.get_document_info()
        
        # Build structure
        document_links = {
            'file': file_path,
            'total_pages': info.page_count,
            'pages': []
        }
        
        for page_index in range(info.page_count):
            hyperlinks = parser.get_hyperlinks(page_index)
            
            page_data = {
                'page_number': page_index + 1,
                'hyperlinks': []
            }
            
            if hyperlinks:
                for link in hyperlinks:
                    page_data['hyperlinks'].append({
                        'text': link.text or '',
                        'url': link.url or ''
                    })
            
            document_links['pages'].append(page_data)
        
        # Save to JSON
        with open(output_json, 'w', encoding='utf-8') as f:
            json.dump(document_links, f, indent=2, ensure_ascii=False)
        
        print(f"Hyperlinks exported to {output_json}")
        return True

# Usage
export_page_hyperlinks("document.pdf", "hyperlinks_by_page.json")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "hyperlinks_by_page.json" >}}
{{< tab-text >}}
The following sample file is used in this example: [hyperlinks_by_page.json](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page/hyperlinks_by_page.json)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a JSON file with hyperlinks organized by page number.

## Find pages with external links

To identify pages containing external links:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def find_pages_with_external_links(file_path):
    """
    Find all pages containing external (http/https) links.
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return []
        
        info = parser.get_document_info()
        pages_with_external_links = []
        
        for page_index in range(info.page_count):
            hyperlinks = parser.get_hyperlinks(page_index)
            
            if hyperlinks:
                has_external = False
                external_links = []
                
                for link in hyperlinks:
                    if link.url and (link.url.startswith('http://') or link.url.startswith('https://')):
                        has_external = True
                        external_links.append(link.url)
                
                if has_external:
                    pages_with_external_links.append({
                        'page': page_index + 1,
                        'links': external_links
                    })
        
        return pages_with_external_links

# Usage
pages = find_pages_with_external_links("article.pdf")

print(f"Pages with external links: {len(pages)}
")
for page_info in pages:
    print(f"Page {page_info['page']}: {len(page_info['links'])} external links")
    for url in page_info['links'][:3]:  # Show first 3
        print(f"  - {url}")
```

{{< /tab >}}
{{< tab "article.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [article.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page/article.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns a list of pages containing external hyperlinks.

## Compare hyperlinks across pages

To analyze hyperlink distribution:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from collections import defaultdict

def analyze_hyperlink_distribution(file_path):
    """
    Analyze how hyperlinks are distributed across pages.
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return
        
        info = parser.get_document_info()
        
        # Collect statistics
        stats = []
        domain_frequency = defaultdict(int)
        
        for page_index in range(info.page_count):
            hyperlinks = parser.get_hyperlinks(page_index)
            
            if hyperlinks:
                link_list = list(hyperlinks)
                page_stat = {
                    'page': page_index + 1,
                    'count': len(link_list),
                    'unique_urls': len(set(link.url for link in link_list))
                }
                stats.append(page_stat)
                
                # Count domains
                for link in link_list:
                    if link.url:
                        try:
                            from urllib.parse import urlparse
                            domain = urlparse(link.url).netloc or "internal"
                            domain_frequency[domain] += 1
                        except:
                            pass
        
        # Print analysis
        print(f"Hyperlink Distribution Analysis:")
        print(f"{'Page':<10}{'Links':<10}{'Unique URLs':<15}")
        print("-" * 35)
        
        for stat in stats:
            print(f"{stat['page']:<10}{stat['count']:<10}{stat['unique_urls']:<15}")
        
        print(f"
Top domains:")
        for domain, count in sorted(domain_frequency.items(), key=lambda x: x[1], reverse=True)[:5]:
            print(f"  {domain}: {count}")

# Usage
analyze_hyperlink_distribution("documentation.pdf")
```

{{< /tab >}}
{{< tab "documentation.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [documentation.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page/documentation.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides statistical analysis of hyperlink distribution across pages.

## Extract hyperlinks from page range

To extract hyperlinks from a range of pages:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_hyperlinks_from_range(file_path, start_page, end_page):
    """
    Extract hyperlinks from a range of pages.
    
    Args:
        file_path: Path to document
        start_page: Starting page number (1-based)
        end_page: Ending page number (1-based, inclusive)
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return []
        
        info = parser.get_document_info()
        
        # Validate range
        start_idx = max(0, start_page - 1)
        end_idx = min(info.page_count - 1, end_page - 1)
        
        all_links = []
        
        for page_index in range(start_idx, end_idx + 1):
            hyperlinks = parser.get_hyperlinks(page_index)
            
            if hyperlinks:
                for link in hyperlinks:
                    all_links.append({
                        'page': page_index + 1,
                        'text': link.text,
                        'url': link.url
                    })
        
        return all_links

# Usage - extract hyperlinks from pages 1-5
links = extract_hyperlinks_from_range("document.pdf", 1, 5)
print(f"Found {len(links)} hyperlinks in pages 1-5
")

for link in links:
    print(f"Page {link['page']}: {link['text']} -> {link['url']}")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts hyperlinks only from the specified page range.

## Notes

- Page indices are zero-based (first page is index 0)
- Use `get_document_info()` to determine total page count
- Check `parser.features.hyperlinks` before extraction
- Empty collections are returned for pages without hyperlinks (not `None`)
- Page-by-page extraction is memory-efficient for large documents

## Related pages

- [Extract hyperlinks from document]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document" >}})
- [Extract hyperlinks from document page area]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area" >}})
- [Get document info]({{< ref "parser/python-net/developer-guide/basic-usage/get-document-info" >}})


---

## Extract images from document page

Path: /parser/java/extract-images-from-document-page/

GroupDocs.Parser provides the functionality to extract images from document page by the [getImages(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages(int)) method:

```java
Iterable<PageImageArea> getImages(int pageIndex);
```

This method returns a collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getFileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getFileType()) | The format of the image. |
| [getRotation](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getRotation()) | The rotation angle of the image. |
| [getImageStream](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream()) | Returns the image stream. |
| [getImageStream(ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream(com.groupdocs.parser.options.ImageOptions)) | Returns the image stream in a different format. |
| [save(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String)) | Saves the image to the file. |
| [save(String, ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String,%20com.groupdocs.parser.options.ImageOptions)) | Saves the image to the file in a different format. |

[ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class is used to define the image format into which the image is converted. The following image formats are supported:

*   Bmp
*   Gif
*   Jpeg
*   Png
*   WebP

Here are the steps to extract images from the document page:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [isImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isImages())  property to check if images extraction is supported for the document;
*   Call [getImages(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages(int)) method with the page index and obtain collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects;
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract images from a document page:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Check if the document supports images extraction
    if (!parser.getFeatures().isImages()) {
        System.out.println("Document isn't supports images extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Check if the document has pages
    if (documentInfo.getPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int pageIndex = 0; pageIndex < documentInfo.getPageCount(); pageIndex++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", pageIndex + 1, documentInfo.getPageCount()));
        // Iterate over images
        // We ignore null-checking as we have checked images extraction feature support earlier
        for (PageImageArea image : parser.getImages(pageIndex)) {
            // Print a rectangle and image type
            System.out.println(String.format("R: %s, Text: %s", image.getRectangle(), image.getFileType()));
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from document page

Path: /parser/net/extract-images-from-document-page/

GroupDocs.Parser provides the functionality to extract images from document page by the [GetImages(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/getimages/methods/2) method:

```csharp
IEnumerable<PageImageArea> GetImages(int pageIndex);
```

The methods return a collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area. |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/filetype) | The format of the image. |
| [Rotation](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/rotation) | The rotation angle of the image. |
| Stream [GetImageStream()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/getimagestream) | Returns the image stream. |
| Stream [GetImageStream(ImageOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.pageimagearea/getimagestream/methods/1) | Returns the image stream in a different format. |
| [Save(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/save) | Saves the image to the file. |
| [Save(string, ImageOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.pageimagearea/save/methods/1) | Saves the image to the file in a different format. |

[ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class is used to define the image format into which the image is converted. The following image formats are supported:

*   Bmp
*   Gif
*   Jpeg
*   Png
*   WebP

Here are the steps to extract images from the document page:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [Features.Images](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/images) property to check if images extraction is supported for the document;
*   Call [GetImages(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/getimages/methods/2) method with the page index and obtain collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects;
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract images from a document page:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports images extraction
    if (!parser.Features.Images)
    {
        Console.WriteLine("Document isn't supports images extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if (documentInfo.PageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int pageIndex = 0; pageIndex < documentInfo.PageCount; pageIndex++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", pageIndex + 1, documentInfo.PageCount));
        // Iterate over images
        // We ignore null-checking as we have checked images extraction feature support earlier
        foreach (PageImageArea image in parser.GetImages(pageIndex))
        {
            // Print a rectangle and image type
            Console.WriteLine(string.Format("R: {0}, Text: {1}", image.Rectangle, image.FileType));
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract images from document page

Path: /parser/python-net/extract-images-from-document-page/


GroupDocs.Parser allows you to extract images from specific pages of a document, providing fine-grained control over image extraction.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents with multiple pages
- Basic understanding of page indexing (zero-based)

## Extract images from a specific page

To extract images from a particular page:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Check if image extraction is supported
    if not parser.features.images:
        print("Document doesn't support image extraction")
        return
    
    # Extract images from page 0 (first page)
    page_index = 0
    images = parser.get_images(page_index)
    
    if images:
        print(f"Images on page {page_index + 1}:")
        for idx, image in enumerate(images):
            print(f"  Image {idx + 1}: {image.file_type}, size: {image.rectangle.width}x{image.rectangle.height}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns only the images from the specified page, or an empty collection if the page has no images.

## Extract images from all pages

To process images page by page:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pptx") as parser:
    # Check if image extraction is supported
    if not parser.features.images:
        print("Document doesn't support image extraction")
        return
    
    # Get document info
    info = parser.get_document_info()
    
    # Check if document has pages
    if info.page_count == 0:
        print("Document has no pages")
        return
    
    # Iterate over pages
    total_images = 0
    for page_index in range(info.page_count):
        print(f"
Page {page_index + 1}/{info.page_count}:")
        
        # Extract images from the current page
        images = parser.get_images(page_index)
        
        if images:
            page_image_count = 0
            for image in images:
                print(f"  Type: {image.file_type}, Position: ({image.rectangle.left}, {image.rectangle.top})")
                page_image_count += 1
            
            print(f"  Total images on this page: {page_image_count}")
            total_images += page_image_count
        else:
            print("  No images on this page")
    
    print(f"
Total images in document: {total_images}")
```

{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pptx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page/sample.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Iterates through all pages and extracts images from each page individually, showing page-specific image counts.

## Save images by page

To save images organized by page number:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

# Create output directory
output_dir = "images_by_page"
os.makedirs(output_dir, exist_ok=True)

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    if not parser.features.images:
        print("Image extraction not supported")
        return
    
    # Get document info
    info = parser.get_document_info()
    
    # Process each page
    for page_index in range(info.page_count):
        # Create page-specific directory
        page_dir = os.path.join(output_dir, f"page_{page_index + 1}")
        os.makedirs(page_dir, exist_ok=True)
        
        # Extract images from page
        images = parser.get_images(page_index)
        
        if images:
            for img_idx, image in enumerate(images):
                # Generate filename
                filename = f"image_{img_idx + 1}{image.file_type.extension}"
                filepath = os.path.join(page_dir, filename)
                
                # Save image
                image.save(filepath)
                print(f"Saved: {filepath}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates separate directories for each page and saves extracted images with organized naming.

## Extract images from specific pages only

To extract images from selected pages:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

# Create an instance of Parser class
with Parser("./sample.docx") as parser:
    if not parser.features.images:
        print("Image extraction not supported")
        return
    
    # Define pages to process (e.g., pages 1, 3, and 5)
    pages_to_process = [0, 2, 4]  # Zero-based indices
    
    output_dir = "selected_page_images"
    os.makedirs(output_dir, exist_ok=True)
    
    for page_index in pages_to_process:
        print(f"
Processing page {page_index + 1}...")
        
        # Extract images from this page
        images = parser.get_images(page_index)
        
        if images:
            for img_idx, image in enumerate(images):
                filename = f"page{page_index + 1}_img{img_idx + 1}{image.file_type.extension}"
                filepath = os.path.join(output_dir, filename)
                image.save(filepath)
                print(f"  Saved: {filename}")
        else:
            print(f"  No images found on page {page_index + 1}")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts images only from the specified pages, skipping others.

## Count images per page

To analyze image distribution across pages:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def analyze_image_distribution(file_path):
    """
    Analyze how images are distributed across document pages.
    """
    with Parser(file_path) as parser:
        if not parser.features.images:
            print("Image extraction not supported")
            return
        
        info = parser.get_document_info()
        
        image_stats = []
        total_images = 0
        
        for page_index in range(info.page_count):
            images = parser.get_images(page_index)
            
            if images:
                # Count images on this page
                image_list = list(images)
                page_image_count = len(image_list)
                
                # Collect image types
                image_types = [img.file_type.extension for img in image_list]
                
                image_stats.append({
                    'page': page_index + 1,
                    'count': page_image_count,
                    'types': image_types
                })
                
                total_images += page_image_count
        
        # Print summary
        print(f"Document: {file_path}")
        print(f"Total pages: {info.page_count}")
        print(f"Total images: {total_images}")
        print(f"Average images per page: {total_images / info.page_count:.2f}
")
        
        # Print per-page details
        for stat in image_stats:
            types_str = ", ".join(set(stat['types']))
            print(f"Page {stat['page']}: {stat['count']} images ({types_str})")

# Usage
analyze_image_distribution("sample.pdf")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Extract first image from each page

To extract only the first image from each page:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

# Create output directory
output_dir = "first_images"
os.makedirs(output_dir, exist_ok=True)

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    if not parser.features.images:
        print("Image extraction not supported")
        return
    
    info = parser.get_document_info()
    
    for page_index in range(info.page_count):
        # Extract images from page
        images = parser.get_images(page_index)
        
        if images:
            # Get first image only
            first_image = next(iter(images), None)
            
            if first_image:
                filename = f"page_{page_index + 1}_first{first_image.file_type.extension}"
                filepath = os.path.join(output_dir, filename)
                first_image.save(filepath)
                print(f"Saved first image from page {page_index + 1}: {filename}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts and saves only the first image found on each page.

## Notes

- Page indices are zero-based (first page is index 0)
- Use `get_document_info()` to determine the total number of pages
- Check `parser.features.images` before extracting images
- Empty collections are returned for pages without images (not `None`)
- Page-by-page extraction is memory-efficient for large documents
- The method returns `None` only if image extraction is not supported for the document format

## Related pages

- [Extract images from document]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document" >}})
- [Extract images from document page area]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area" >}})
- [Get document info]({{< ref "parser/python-net/developer-guide/basic-usage/get-document-info" >}})


---

## Extract metadata from Emails

Path: /parser/java/extract-metadata-from-emails/

To extract metadata from emails [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| subject | The email "subject" field. |
| email-sender | The email "from" field. |
| email-to | The email "to" field. May contain more than one address separated by semicolons. |
| email-cc | The email "cc" field. May contain more than one address separated by semicolons. |

Here are the steps to extract metadata from an email:
*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial email;
*   Call [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}
[getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns *null* value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for Zip archive. Therefore, for Zip archive [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns *null*. If an email has no metadata, [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns an empty collection.
{{< /alert >}}

The following example demonstrates how to extract metadata from an email:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleMsg)) {
    // Extract metadata from the email
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from Emails

Path: /parser/net/extract-metadata-from-emails/

To extract metadata from emails [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| subject | The email "subject" field. |
| email-sender | The email "from" field. |
| email-to | The email "to" field. May contain more than one address separated by semicolons. |
| email-cc | The email "cc" field. May contain more than one address separated by semicolons. |

Here are the steps to extract metadata from an email:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial email;
*   Call [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}
[GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null* value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for Zip archive. Therefore, for Zip archive [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null*. If an email has no metadata, [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns an empty collection.
{{< /alert >}}

The following example demonstrates how to extract metadata from an email:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract metadata from the email
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
 
    // Iterate over metadata items
    foreach(MetadataItem item in metadata)
    {
        // Print the item name and value
        Console.WriteLine(string.Format("{0}: {1}", item.Name, item.Value));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from EPUB eBook

Path: /parser/java/extract-metadata-from-epub-ebook/

To extract metadata from EPUB e-books [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| title | The title of the e-book. |
| subject | The subject of the e-book. |
| author | The name of the e-book's author. |
| language | The language of the e-book. |
| published-date | The published date of the e-book. |
| description | The description of the e-book. |
| publisher | The publisher of the e-book. |
| copyrights | The copyrights of the e-book. |

Here are the steps to extract metadata from EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial e-book;
*   Call [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}
[getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns *null* value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for Zip archive. Therefore, for Zip archive [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns *null*. If EPUB e-book has no metadata, [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns an empty collection.
{{< /alert >}}

The following example demonstrates how to extract metadata from EPUB e-book:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleEpub)) {
    // Extract metadata from the e-book
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from EPUB eBook

Path: /parser/net/extract-metadata-from-epub-ebook/

To extract metadata from EPUB e-books [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| title | The title of the e-book. |
| subject | The subject of the e-book. |
| author | The name of the e-book's author. |
| language | The language of the e-book. |
| published-date | The published date of the e-book. |
| description | The description of the e-book. |
| publisher | The publisher of the e-book. |
| copyrights | The copyrights of the e-book. |

Here are the steps to extract metadata from EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial e-book;
*   Call [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}
[GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null* value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for Zip archive. Therefore, for Zip archive [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null*. If EPUB e-book has no metadata, [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns an empty collection.
{{< /alert >}}

The following example demonstrates how to extract metadata from EPUB e-book:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract metadata from the e-book
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
 
    // Iterate over metadata items
    foreach(MetadataItem item in metadata)
    {
        // Print the item name and value
        Console.WriteLine(string.Format("{0}: {1}", item.Name, item.Value));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract Metadata from Excel Spreadsheets in C# .NET

Path: /parser/net/extract-metadata-from-microsoft-office-excel-spreadsheets/


# Extract Metadata from Excel Spreadsheets in C# .NET

Microsoft Excel files often contain hidden **metadata** such as the author, company, creation date, last modification time, and more. With **GroupDocs.Parser for .NET**, you can easily extract this metadata from Excel spreadsheets (`.xls` and `.xlsx`) using the [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method.  

This guide explains how to extract Excel file metadata programmatically in just a few steps.

---

## What Metadata Can Be Extracted?


The `GetMetadata` method allows you to access a wide range of Excel spreadsheet properties:

| Metadata Field | Description |
| --- | --- |
| **title** | Spreadsheet title |
| **subject** | Spreadsheet subject |
| **keywords** | Spreadsheet keywords |
| **comments** | User comments |
| **content-status** | Status of the spreadsheet |
| **category** | Spreadsheet category |
| **company** | Company name |
| **manager** | Manager name |
| **author** | Original author |
| **last-author** | Last modified by |
| **hyperlink-base** | Base URL for relative hyperlinks |
| **application** | Application used to create the file |
| **application-version** | Version of the application |
| **template** | Template name |
| **created-time** | Creation time |
| **last-saved-time** | Last saved timestamp |
| **last-printed-time** | Last printed timestamp |
| **revision-number** | Revision number |
| **total-editing-time** | Total editing time (in minutes) |

---

{{< alert style="warning" >}}
[GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null* value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for CSV files. Therefore, for CSV file [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null*. If Microsoft Office Excel spreadsheet has no metadata, [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns an empty collection.
{{< /alert >}}

## How to Extract Excel Metadata in C#

Follow these steps to extract metadata from an Excel file:

1. **Instantiate the Parser object** for the Excel spreadsheet.  
2. **Call the `GetMetadata` method** to retrieve all metadata items.  
3. **Iterate through the collection** and print metadata names and values.  

```csharp
// Load the Excel file
using (Parser parser = new Parser(filePath))
{
    // Extract metadata
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
 
    // Iterate through metadata items
    foreach (MetadataItem item in metadata)
    {
        Console.WriteLine($"{item.Name}: {item.Value}");
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from Microsoft Office Excel spreadsheets

Path: /parser/java/extract-metadata-from-microsoft-office-excel-spreadsheets/

To extract metadata from Microsoft Office Excel spreadsheets [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| title | The title of the spreadsheet. |
| subject | The subject of the spreadsheet. |
| keywords | The keyword of the spreadsheet. |
| comments | The comments of the spreadsheet. |
| content-status | The content status of the spreadsheet. |
| category | The category of the spreadsheet. |
| company | The company of the spreadsheet. |
| manager | The manager of the spreadsheet. |
| author | The name of the spreadsheet's author. |
| last-author | The name of the last spreadsheet's author. |
| hyperlink-base | The base string used for evaluating relative hyperlinks in this spreadsheet. |
| application | The name of the application. |
| application-version | The version number of the application that created the spreadsheet. |
| template | The informational name of the spreadsheet template. |
| created-time | The time of the spreadsheet creation. |
| last-saved-time | The time of the the spreadsheet when it was last saved. |
| last-printed-time | The time of the spreadsheet when it was last printed. |
| revision-number | The spreadsheet revision number. |
| total-editing-time | The total editing time in minutes. |

Here are the steps to extract metadata from Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Call [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}[getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns null value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for CSV files. Therefore, for CSV file [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns null. If Microsoft Office Excel spreadsheet has no metadata, [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns an empty collection.{{< /alert >}}

The following example demonstrates how to extract metadata from Excel spreadsheet:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    // Extract metadata from the spreadsheet
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from Microsoft Office PowerPoint presentations

Path: /parser/java/extract-metadata-from-microsoft-office-powerpoint-presentations/

To extract metadata from Microsoft Office PowerPoint presentations [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| title | The title of the presentation. |
| subject | The subject of the presentation. |
| keywords | The keyword of the presentation. |
| comments | The comments of the presentation. |
| content-status | The content status of the presentation. |
| category | The category of the presentation. |
| company | The company of the presentation. |
| manager | The manager of the presentation. |
| author | The name of the presentation's author. |
| last-author | The name of the last presentation's author. |
| hyperlink-base | The base string used for evaluating relative hyperlinks in this presentation. |
| application | The name of the application. |
| application-version | The version number of the application that created the presentation. |
| created-time | The time of the presentation creation. |
| last-saved-time | The time of the the presentation when it was last saved. |
| last-printed-time | The time of the presentation when it was last printed. |
| revision-number | The presentation revision number. |
| total-editing-time | The total editing time in minutes. |

Here are the steps to extract metadata from Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Call [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}[getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns null value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for TXT files. Therefore, for TXT file [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns null. If Microsoft Office PowerPoint presentation has no metadata, [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns an empty collection.{{< /alert >}}

The following example demonstrates how to extract metadata from PowerPoint presentation:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePptx)) {
    // Extract metadata from the presentation
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)   
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from Microsoft Office PowerPoint presentations

Path: /parser/net/extract-metadata-from-microsoft-office-powerpoint-presentations/


## What is PowerPoint Metadata?

PowerPoint metadata is like a "digital label" attached to your presentation files. It contains information about the file such as:

- Who created it
- When it was made
- The title and subject
- How long someone spent editing it
- Which version of PowerPoint was used

Think of it like the "Properties" you see when you right-click on a file - but now you can extract this information programmatically using code.

## Why Extract PowerPoint Metadata?

Here are some common reasons developers extract metadata from PowerPoint files:

- **File Organization**: Automatically sort presentations by author, date, or company
- **Document Tracking**: Find out who last modified a presentation and when
- **Content Management**: Build searchable libraries of presentations
- **Compliance**: Track document history for auditing purposes

## Available Metadata Information

When you extract metadata from a PowerPoint presentation using GroupDocs.Parser, you can get these details:

| Information | What it tells you |
| --- | --- |
| **title** | The presentation title |
| **author** | Who created the presentation |
| **subject** | What the presentation is about |
| **keywords** | Tags or keywords for the presentation |
| **comments** | Any comments added to the presentation |
| **company** | The company name associated with the file |
| **created-time** | When the presentation was first created |
| **last-saved-time** | When someone last saved changes |
| **total-editing-time** | How many minutes were spent editing |
| **revision-number** | How many times the file has been revised |

*And several other technical details...*

## How to Extract the Metadata

It's really simple! Just follow these 3 steps:

### Step 1: Create a Parser
First, create a Parser object and point it to your PowerPoint file:

```csharp
using(Parser parser = new Parser("your-presentation.pptx"))
{
    // Your code goes here
}
```

### Step 2: Get the Metadata
Ask the parser to extract all the metadata:

```csharp
IEnumerable<MetadataItem> metadata = parser.GetMetadata();
```

### Step 3: Read the Information
Loop through the results and print out what you found:

```csharp
foreach(MetadataItem item in metadata)
{
    Console.WriteLine($"{item.Name}: {item.Value}");
}
```

### Complete Example

Here's the full working example:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract metadata from the presentation
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
  
    // Iterate over metadata items
    foreach(MetadataItem item in metadata)
    {
        // Print the item name and value
        Console.WriteLine(string.Format("{0}: {1}", item.Name, item.Value));
    }
}
```

## What File Types Work?

This works with all common PowerPoint formats:
- **.ppt** - Older PowerPoint files
- **.pptx** - Newer PowerPoint files  
- **.pps** - PowerPoint slideshow files
- **.ppsx** - Newer slideshow files

## Important Notes

{{< alert style="warning" >}}
**Remember**: If a PowerPoint file doesn't have metadata or the file type isn't supported, you might get no results. This is normal - not all files have metadata information.
{{< /alert >}}

## Real-World Example

Let's say you have a folder full of PowerPoint presentations and you want to find out who created each one:

```csharp
string[] presentations = Directory.GetFiles(@"C:\MyPresentations", "*.pptx");

foreach (string presentation in presentations)
{
    using (Parser parser = new Parser(presentation))
    {
        var metadata = parser.GetMetadata();
        var author = metadata.FirstOrDefault(m => m.Name == "author");
        
        Console.WriteLine($"File: {Path.GetFileName(presentation)}");
        Console.WriteLine($"Author: {author?.Value ?? "Unknown"}");
        Console.WriteLine("---");
    }
}
```

This will show you the author of each PowerPoint file in your folder!

## Common Use Cases

**For Businesses:**
- Track which employee created which presentation
- Find presentations by topic or keyword
- Monitor when presentations were last updated

**For Developers:**
- Build document management systems
- Create automated file organizing tools
- Add search functionality to presentation libraries

**For Content Managers:**
- Organize presentation libraries
- Track document versions and changes
- Ensure proper attribution and ownership

## Troubleshooting

**Problem**: Getting no metadata back?
- **Solution**: The file might not have metadata, or the file format isn't supported

**Problem**: Can't read the file?
- **Solution**: Make sure the file path is correct and the file isn't password-protected

**Problem**: Getting an error?
- **Solution**: Check that the file isn't corrupted and is a valid PowerPoint file

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from Microsoft Office Word documents

Path: /parser/java/extract-metadata-from-microsoft-office-word-documents/

To extract metadata from Microsoft Office Word documents [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| title | The title of the document. |
| subject | The subject of the document. |
| keywords | The keyword of the document. |
| comments | The comments of the document. |
| content-status | The content status of the document. |
| category | The category of the document. |
| company | The company of the document. |
| manager | The manager of the document. |
| author | The name of the document's author. |
| last-author | The name of the last document's author. |
| hyperlink-base | The base string used for evaluating relative hyperlinks in this document. |
| application | The name of the application. |
| application-version | The version number of the application that created the document. |
| template | The informational name of the document template. |
| created-time | The time of the document creation. |
| last-saved-time | The time of the the document when it was last saved. |
| last-printed-time | The time of the document when it was last printed. |
| revision-number | The document revision number. |
| total-editing-time | The total editing time in minutes. |

Here are the steps to extract metadata from Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}[getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns null value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for Zip archive. Therefore, for Zip archive [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns null. If Microsoft Office Word document has no metadata, [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns an empty collection.{{< /alert >}}

The following example demonstrates how to extract metadata from Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract metadata from the document
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from Microsoft Office Word documents

Path: /parser/net/extract-metadata-from-microsoft-office-word-documents/


## What is Word Document Metadata?

Word document metadata is hidden information stored inside your .doc and .docx files. It's like a "digital fingerprint" that contains details about the document such as:

- Who wrote the document
- When it was created and last modified  
- How much time was spent writing it
- The document's title, subject, and keywords
- Which version of Word was used

You can see some of this information by right-clicking a Word file and selecting "Properties" - but with GroupDocs.Parser, you can extract this data programmatically using C# code.

## Why Extract Word Metadata?

Here are common scenarios where extracting Word metadata is useful:

**Document Management:**
- Automatically organize documents by author or creation date
- Build searchable document libraries
- Track document versions and changes

**Business Applications:**
- Find all documents created by a specific employee
- Monitor document editing activity
- Ensure proper document attribution

**Compliance & Auditing:**
- Track document history for legal requirements
- Monitor sensitive document access
- Maintain document lifecycle records

## What Information Can You Extract?

The [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method can extract these details from Word documents:

| Information | What it tells you |
| --- | --- |
| **title** | The document title |
| **author** | Who created the document |
| **subject** | What the document is about |
| **keywords** | Tags or keywords for the document |
| **comments** | Any comments added to the document |
| **company** | The company name associated with the file |
| **manager** | The manager associated with the document |
| **created-time** | When the document was first created |
| **last-saved-time** | When someone last saved changes |
| **last-printed-time** | When the document was last printed |
| **total-editing-time** | How many minutes were spent editing |
| **revision-number** | How many times the file has been revised |
| **template** | Which Word template was used |
| **application** | Which application created the document |
| **application-version** | The version of Word that created it |

*Plus additional technical details like hyperlink-base, content-status, category, and last-author.*

## How to Extract Word Metadata

It's simple! Just follow these 3 easy steps:

### Step 1: Create a Parser
Point the Parser to your Word document:

```csharp
using(Parser parser = new Parser("your-document.docx"))
{
    // Your code goes here
}
```

### Step 2: Get the Metadata  
Extract all the metadata information:

```csharp
IEnumerable<MetadataItem> metadata = parser.GetMetadata();
```

### Step 3: Read the Results
Loop through and display what you found:

```csharp
foreach(MetadataItem item in metadata)
{
    Console.WriteLine($"{item.Name}: {item.Value}");
}
```

### Complete Working Example

Here's the full code that extracts and displays all metadata from a Word document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract metadata from the document
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
    
    // Iterate over metadata items
    foreach(MetadataItem item in metadata)
    {
        // Print the item name and value
        Console.WriteLine(string.Format("{0}: {1}", item.Name, item.Value));
    }
}
```

{{< alert style="warning" >}}
**Note**: If a Word document doesn't have metadata or the file format isn't supported, you might get no results. This is normal - not all documents have complete metadata information.
{{< /alert >}}

## Supported Word File Formats

This works with all common Microsoft Word formats:
- **.doc** - Older Word documents (Word 97-2003)
- **.docx** - Newer Word documents (Word 2007 and later)
- **.dot** - Word document templates
- **.dotx** - Word template files

## Practical Examples

### Example 1: Find Documents by Author

Let's say you want to find all Word documents in a folder that were created by a specific person:

```csharp
string[] documents = Directory.GetFiles(@"C:\MyDocuments", "*.docx");

foreach (string document in documents)
{
    using (Parser parser = new Parser(document))
    {
        var metadata = parser.GetMetadata();
        var author = metadata.FirstOrDefault(m => m.Name == "author");
        
        if (author?.Value?.ToString() == "John Smith")
        {
            Console.WriteLine($"Found document by John Smith: {Path.GetFileName(document)}");
        }
    }
}
```

### Example 2: Document Summary Report

Create a summary report showing key information about your Word documents:

```csharp
using (Parser parser = new Parser("report.docx"))
{
    var metadata = parser.GetMetadata();
    
    Console.WriteLine("=== Document Summary ===");
    Console.WriteLine($"Title: {GetValue(metadata, "title")}");
    Console.WriteLine($"Author: {GetValue(metadata, "author")}");
    Console.WriteLine($"Created: {GetValue(metadata, "created-time")}");
    Console.WriteLine($"Last Modified: {GetValue(metadata, "last-saved-time")}");
    Console.WriteLine($"Total Editing Time: {GetValue(metadata, "total-editing-time")} minutes");
}

string GetValue(IEnumerable<MetadataItem> metadata, string name)
{
    return metadata.FirstOrDefault(m => m.Name == name)?.Value?.ToString() ?? "Not available";
}
```

## Common Use Cases

**For Businesses:**
- Track employee document creation and editing activity
- Organize documents by department or project
- Monitor document compliance and approval workflows

**For Developers:**
- Build document management systems
- Create automated file organization tools
- Add document search and filtering capabilities

**For Content Managers:**
- Maintain document libraries and archives
- Track document versions and revision history
- Ensure proper document metadata standards

## Troubleshooting Common Issues

**Problem**: Not getting any metadata back?
- **Solution**: The document might not have metadata properties set, or the file format might not be supported

**Problem**: Getting a "file not found" error?
- **Solution**: Check that the file path is correct and the file exists

**Problem**: Can't read password-protected documents?
- **Solution**: Remove password protection first, as encrypted documents require special handling

**Problem**: Some metadata fields are empty?
- **Solution**: This is normal - not all Word documents have all metadata fields populated

## Best Practices

1. **Always use `using` statements** to properly dispose of Parser objects
2. **Check for null values** when accessing specific metadata fields
3. **Handle exceptions** for corrupted or inaccessible files
4. **Test with different Word versions** to ensure compatibility
5. **Validate file formats** before attempting to extract metadata

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from PDF documents

Path: /parser/java/extract-metadata-from-pdf-documents/

To extract metadata from PDF documents [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method is used. This method allows to extract the following metadata:

| Name | Description |
| --- | --- |
| title | The title of the presentation. |
| subject | The subject of the presentation. |
| keywords | The keyword of the presentation. |
| author | The name of the presentation's author. |
| application | The name of the application. |
| application-version | The version number of the application that created the presentation. |
| created-time | The time of the presentation creation. |
| last-saved-time | The time of the the presentation when it was last saved. |

Here are the steps to extract metadata from PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

{{< alert style="warning" >}}
[getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns *null* value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for TXT files. Therefore, for TXT file [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata())  method returns *null*. If PDF document has no metadata, [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method returns an empty collection.
{{< /alert >}}

The following example demonstrates how to extract metadata from PDF document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Extract metadata from the document
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract Metadata from PDF Documents in C# .NET

Path: /parser/net/extract-metadata-from-pdf-documents/


# Extract Metadata from PDF Documents in C# .NET

PDF files often contain **metadata** such as the title, subject, author, creation date, and application used to generate the document. With **GroupDocs.Parser for .NET**, you can easily read these metadata properties programmatically using the [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method.  

This guide shows how to extract metadata from PDF documents in C# step by step.

---

## What Metadata Can Be Extracted?

The `GetMetadata` method can return the following properties from a PDF document:

| Metadata Field | Description |
| --- | --- |
| **title** | Title of the PDF document |
| **subject** | Subject of the PDF document |
| **keywords** | Keywords associated with the document |
| **author** | Author of the document |
| **application** | Application that created the PDF |
| **application-version** | Version of the application |
| **created-time** | Date and time the PDF was created |
| **last-saved-time** | Date and time the PDF was last modified |

⚡ *Note: The available metadata depends on the PDF file itself. Not all fields may be present in every document.*

---

## How to Extract PDF Metadata in C#

Follow these steps to get metadata from a PDF document:

1. **Create a `Parser` object** and load the PDF file.  
2. **Call the `GetMetadata` method** to retrieve metadata items.  
3. **Iterate through the collection** and read metadata names and values.  

### Example: Extract PDF Metadata in C#
```csharp
// Load the PDF file
using (Parser parser = new Parser(filePath))
{
    // Extract metadata
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
  
    // Display metadata fields
    foreach (MetadataItem item in metadata)
    {
        Console.WriteLine($"{item.Name}: {item.Value}");
    }
}
```

{{< alert style="warning" >}}
[GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null* value if metadata extraction isn't supported for the document. For example, metadata extraction isn't supported for TXT files. Therefore, for TXT file [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null*. If PDF document has no metadata, [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns an empty collection.
{{< /alert >}}

## Why Extract PDF Metadata?

Extracting PDF metadata is useful for:
*   Document management – quickly find and categorize files by author, subject, or keywords.
*   Compliance checks – verify creation and modification dates.
*   Search indexing – improve search accuracy by including document properties.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract tables from document page

Path: /parser/python-net/extract-tables-from-document-page/


GroupDocs.Parser allows you to extract tables from specific pages of a document, providing precise control over which tables to extract.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents with tables on multiple pages
- Basic understanding of page indexing (zero-based)

## Extract tables from a specific page

To extract tables from a particular page:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTableAreaOptions

# Create an instance of Parser class
with Parser("./report.pdf") as parser:
    # Check if table extraction is supported
    if not parser.features.tables:
        print("Table extraction not supported")
        return
    
    # Create options for page-specific extraction
    page_index = 0  # First page
    options = PageTableAreaOptions(page_index)
    
    # Extract tables from the specified page
    tables = parser.get_tables(options)
    
    if tables:
        print(f"Tables on page {page_index + 1}:")
        for table_idx, table in enumerate(tables):
            print(f"
Table {table_idx + 1}:")
            print(f"Size: {table.row_count} rows × {table.column_count} columns")
            
            # Print table content
            for row in range(table.row_count):
                row_data = []
                for col in range(table.column_count):
                    cell = table[row, col]
                    cell_text = cell.text if cell else ""
                    row_data.append(cell_text)
                print(" | ".join(row_data))
    else:
        print(f"No tables found on page {page_index + 1}")
```

{{< /tab >}}
{{< tab "report.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [report.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page/report.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts only tables from the specified page, returning an empty collection if no tables exist on that page.

## Extract tables from all pages iteratively

To process tables page by page:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTableAreaOptions

# Create an instance of Parser class
with Parser("./document.docx") as parser:
    # Check if table extraction is supported
    if not parser.features.tables:
        print("Table extraction not supported")
        return
    
    # Get document info
    info = parser.get_document_info()
    
    if info.page_count == 0:
        print("Document has no pages")
        return
    
    # Iterate over pages
    total_tables = 0
    for page_index in range(info.page_count):
        print(f"
{'=' * 50}")
        print(f"Page {page_index + 1}/{info.page_count}")
        print('=' * 50)
        
        # Create options for this page
        options = PageTableAreaOptions(page_index)
        
        # Extract tables from current page
        tables = parser.get_tables(options)
        
        if tables:
            page_table_count = 0
            for table in tables:
                page_table_count += 1
                total_tables += 1
                
                print(f"
Table {page_table_count}:")
                print(f"Size: {table.row_count}×{table.column_count}")
                print(f"Position: ({table.rectangle.left}, {table.rectangle.top})")
            
            print(f"
Tables on this page: {page_table_count}")
        else:
            print("No tables on this page")
    
    print(f"
{'=' * 50}")
    print(f"Total tables in document: {total_tables}")
```

{{< /tab >}}
{{< tab "document.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page/document.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Iterates through all pages and extracts tables from each page individually, providing page-specific statistics.

## Extract tables from specific pages only

To extract tables from selected pages:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTableAreaOptions

# Create an instance of Parser class
with Parser("report.xlsx") as parser:
    if not parser.features.tables:
        print("Table extraction not supported")
        return
    
    # Define pages to process (e.g., pages 1, 3, and 5)
    pages_to_process = [0, 2, 4]  # Zero-based indices
    
    for page_index in pages_to_process:
        print(f"
Processing page {page_index + 1}...")
        
        # Create options for this page
        options = PageTableAreaOptions(page_index)
        
        # Extract tables from this page
        tables = parser.get_tables(options)
        
        if tables:
            for table_idx, table in enumerate(tables):
                print(f"  Table {table_idx + 1}: {table.row_count}×{table.column_count}")
                
                # Show first row as sample
                if table.row_count > 0:
                    print("  First row:", end=" ")
                    for col in range(min(3, table.column_count)):  # Show first 3 columns
                        cell = table[0, col]
                        if cell:
                            print(f"[{cell.text}]", end=" ")
                    print("...")
        else:
            print(f"  No tables found on page {page_index + 1}")
```

{{< /tab >}}
{{< tab "report.xlsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [report.xlsx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page/report.xlsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts tables only from specified pages, skipping others for efficiency.

## Compare tables across pages

To analyze table structure across different pages:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTableAreaOptions

def compare_tables_across_pages(file_path, page_indices):
    """
    Compare table structures across multiple pages.
    """
    with Parser(file_path) as parser:
        if not parser.features.tables:
            print("Table extraction not supported")
            return
        
        page_table_info = {}
        
        for page_index in page_indices:
            options = PageTableAreaOptions(page_index)
            tables = parser.get_tables(options)
            
            if tables:
                table_list = list(tables)
                page_table_info[page_index + 1] = {
                    'count': len(table_list),
                    'structures': [(t.row_count, t.column_count) for t in table_list]
                }
            else:
                page_table_info[page_index + 1] = {
                    'count': 0,
                    'structures': []
                }
        
        # Print comparison
        print("Table Structure Comparison:")
        print(f"{'Page':<10}{'Tables':<10}{'Structures':<40}")
        print("-" * 60)
        
        for page_num, info in sorted(page_table_info.items()):
            structures_str = ", ".join([f"{r}×{c}" for r, c in info['structures']])
            print(f"{page_num:<10}{info['count']:<10}{structures_str:<40}")

# Usage
compare_tables_across_pages("financial_report.pdf", [0, 1, 2, 3, 4])
```

{{< /tab >}}
{{< tab "financial_report.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [financial_report.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page/financial_report.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides a comparative view of table structures across specified pages.

## Export tables from specific page to JSON

To export page-specific tables to structured JSON:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTableAreaOptions
import json

def export_page_tables_to_json(file_path, page_index, output_file):
    """
    Export tables from a specific page to JSON format.
    """
    with Parser(file_path) as parser:
        if not parser.features.tables:
            print("Table extraction not supported")
            return
        
        options = PageTableAreaOptions(page_index)
        tables = parser.get_tables(options)
        
        if not tables:
            print(f"No tables found on page {page_index + 1}")
            return
        
        # Build JSON structure
        page_data = {
            'page_number': page_index + 1,
            'tables': []
        }
        
        for table_idx, table in enumerate(tables):
            table_data = {
                'table_index': table_idx + 1,
                'rows': table.row_count,
                'columns': table.column_count,
                'data': []
            }
            
            # Extract table data
            for row in range(table.row_count):
                row_data = []
                for col in range(table.column_count):
                    cell = table[row, col]
                    row_data.append(cell.text if cell else "")
                table_data['data'].append(row_data)
            
            page_data['tables'].append(table_data)
        
        # Save to JSON
        with open(output_file, 'w', encoding='utf-8') as f:
            json.dump(page_data, f, indent=2, ensure_ascii=False)
        
        print(f"Exported {len(page_data['tables'])} tables from page {page_index + 1} to {output_file}")

# Usage
export_page_tables_to_json("data.pdf", 0, "page1_tables.json")
```

{{< /tab >}}
{{< tab "data.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [data.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page/data.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "page1_tables.json" >}}
{{< tab-text >}}
The following sample file is used in this example: [page1_tables.json](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page/page1_tables.json)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a JSON file containing all tables from the specified page with complete data.

## Extract tables with custom layout from specific page

To use custom table layout for a specific page:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTableAreaOptions
from groupdocs.parser.templates import TemplateTableLayout

# Create an instance of Parser class
with Parser("invoice.pdf") as parser:
    if not parser.features.tables:
        print("Table extraction not supported")
        return
    
    # Define custom table layout
    layout = TemplateTableLayout(
        [50, 150, 300, 450],  # Column separators
        [200, 220, 240, 260]  # Row separators
    )
    
    # Create options for specific page with custom layout
    page_index = 0
    options = PageTableAreaOptions(page_index, layout)
    
    # Extract tables
    tables = parser.get_tables(options)
    
    if tables:
        print(f"Tables extracted from page {page_index + 1} with custom layout:")
        for table in tables:
            print(f"
Table: {table.row_count}×{table.column_count}")
            for row in range(table.row_count):
                for col in range(table.column_count):
                    cell = table[row, col]
                    if cell:
                        print(f"{cell.text:20}", end=" | ")
                print()
```

{{< /tab >}}
{{< tab "invoice.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [invoice.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document-page/invoice.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts tables from the specified page using the custom layout definition.

## Notes

- Page indices are zero-based (first page is index 0)
- Use `PageTableAreaOptions(page_index)` to extract from a specific page
- Combine with `TemplateTableLayout` for structured documents with known table positions
- Use `get_document_info()` to determine the total number of pages
- Page-by-page extraction is more memory-efficient for large documents
- Empty collections are returned for pages without tables (not `None`)

## Related pages

- [Extract tables from document]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-tables/extract-tables-from-document" >}})
- [Working with templates]({{< ref "parser/python-net/developer-guide/advanced-usage/template-based-parsing/working-with-templates" >}})
- [Get document info]({{< ref "parser/python-net/developer-guide/basic-usage/get-document-info" >}})


---

## Extract text in Raw mode

Path: /parser/net/extract-text-in-raw-mode/

GroupDocs.Parser provides the functionality to extract a text from documents.

The **Raw** mode is the fastest text extraction mode and it means that performance wlll be the best possible.

Raw mode usually retrieves text in worse quality than Accurate mode, but in some cases performance is more important than quality.

You can extract the whole document text or only a document page.

To extract a text from the document in the Raw mode, [GetText(TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/1) and [GetText(int, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) methods of [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) class are used:

```csharp
TextReader GetText(TextOptions options);
TextReader GetText(int pageIndex, TextOptions options);
```

Methods return an instance of [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) class with an extracted text. The first method extracts text from the whole document. The second method extracts text from the document page. To retrieve the total number of document pages [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method is used (see below).

{{< alert style="warning" >}}
Instead of the accurate mode, [RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) property of [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) class is used to avoid extra calculations.
{{< /alert >}}

## Extract text

Here are the steps to extract a raw text from document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [TextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textoptions) object with *true* parameter;
*   Call [GetText(TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/1) method with [TextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textoptions)parameter and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Check if *reader* isn't *null* (text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a raw text from a document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract a raw text into the reader
    using(TextReader reader = parser.GetText(new TextOptions(true)))
    {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## Extract text from a page

Here are the steps to extract a raw text from the document page:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [TextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textoptions) object with *true* parameter;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method;
*   Call [Features.Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/text) property to check if text extraction is supported for the document;
*   Use [RawPageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/rawpagecount) instead of [PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) to avoid extra calculations;
*   Call [GetText(int, TextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/3) method with the page index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a raw text from a document page:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports text extraction
    if (!parser.Features.Text)
    {
        Console.WriteLine("Document isn't supports text extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if (documentInfo == null || documentInfo.RawPageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.RawPageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.RawPageCount));
        // Extract a text into the reader
        using (TextReader reader = parser.GetText(p, new TextOptions(true)))
        {
            // Print a text from the document
            // We ignore null-checking as we have checked text extraction feature support earlier
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text in Raw mode

Path: /parser/python-net/extract-text-in-raw-mode/


GroupDocs.Parser provides **Raw mode** for text extraction, which offers significantly faster processing speed at the cost of formatting accuracy. This mode is ideal for large documents where speed is more important than perfect layout preservation.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents for testing
- Understanding of text extraction modes

## Accurate vs Raw mode

| Feature | Accurate Mode | Raw Mode |
|---------|--------------|----------|
| **Speed** | Slower | Faster |
| **Formatting** | Best quality | Basic quality |
| **Layout** | Preserved | May be altered |
| **Use Case** | High-quality output | High-speed processing |

## Extract text in Raw mode

To extract text from a document in Raw mode:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import TextOptions

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Create text options for raw mode
    options = TextOptions(False)  # False = Raw mode, True = Accurate mode
    
    # Extract text in raw mode
    text_reader = parser.get_text(options)
    
    # Check if text extraction is supported
    if text_reader is None:
        print("Text extraction isn't supported")
    else:
        # Print the extracted text
        print(text_reader)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-in-raw-mode/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns text extracted in Raw mode with improved performance but potentially reduced formatting quality.

## Extract text from page in Raw mode

To extract text from a specific page in Raw mode:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import TextOptions

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Get document info
    info = parser.get_document_info()
    
    # Check if document has pages
    if info.raw_page_count == 0:
        print("Document has no pages")
        return
    
    # Create text options for raw mode
    options = TextOptions(False)
    
    # Iterate over pages
    for page_index in range(info.raw_page_count):
        print(f"
Page {page_index + 1}/{info.raw_page_count}")
        
        # Extract text from page in raw mode
        text_reader = parser.get_text(page_index, options)
        
        if text_reader is not None:
            print(text_reader)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-in-raw-mode/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts text page by page in Raw mode, using `raw_page_count` for accurate page enumeration.

## Important note about page counts

When using Raw mode, always use `raw_page_count` instead of `page_count`:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import TextOptions

# Create an instance of Parser class
with Parser("sample.pdf") as parser:
    # Get document info
    info = parser.get_document_info()
    
    print(f"Accurate mode pages: {info.page_count}")
    print(f"Raw mode pages: {info.raw_page_count}")
    
    # The page count may differ between modes!
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-in-raw-mode/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Raw mode may have a different page count than Accurate mode due to different text layout algorithms.

## Performance comparison

Compare extraction speed between modes:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import TextOptions
import time

def compare_extraction_modes(file_path):
    """
    Compare performance between Accurate and Raw modes.
    """
    # Accurate mode
    start_time = time.time()
    with Parser(file_path) as parser:
        text_reader = parser.get_text()
        if text_reader:
            accurate_text = text_reader
            accurate_time = time.time() - start_time
            accurate_length = len(accurate_text)
        else:
            print("Text extraction not supported")
            return
    
    # Raw mode
    start_time = time.time()
    with Parser(file_path) as parser:
        options = TextOptions(False)
        text_reader = parser.get_text(options)
        if text_reader:
            raw_text = text_reader
            raw_time = time.time() - start_time
            raw_length = len(raw_text)
    
    # Print comparison
    print(f"Performance Comparison:")
    print(f"{'Mode':<15} {'Time (s)':<15} {'Length':<15} {'Speed':<15}")
    print("-" * 60)
    print(f"{'Accurate':<15} {accurate_time:<15.3f} {accurate_length:<15} {'1.0x':<15}")
    print(f"{'Raw':<15} {raw_time:<15.3f} {raw_length:<15} {accurate_time/raw_time:.2f}x faster")

# Usage
compare_extraction_modes("sample.pdf")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-in-raw-mode/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Demonstrates the speed improvement of Raw mode over Accurate mode.

## Batch processing with Raw mode

Process multiple documents efficiently:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import TextOptions
from pathlib import Path
import time

def batch_extract_raw(input_dir, output_dir):
    """
    Extract text from multiple documents using Raw mode for speed.
    """
    output_path = Path(output_dir)
    output_path.mkdir(exist_ok=True)
    
    extensions = ['.pdf', '.docx', '.doc', '.txt']
    
    start_time = time.time()
    processed_count = 0
    
    # Create raw mode options
    options = TextOptions(False)
    
    for file_path in Path(input_dir).rglob('*'):
        if file_path.suffix.lower() in extensions:
            print(f"Processing: {file_path.name}")
            
            try:
                with Parser(str(file_path)) as parser:
                    text_reader = parser.get_text(options)
                    
                    if text_reader:
                        # Save extracted text
                        output_file = output_path / f"{file_path.stem}.txt"
                        with open(output_file, 'w', encoding='utf-8') as f:
                            f.write(text_reader)
                        
                        processed_count += 1
                
            except Exception as e:
                print(f"  Error: {e}")
    
    elapsed_time = time.time() - start_time
    print(f"
Processed {processed_count} documents in {elapsed_time:.2f} seconds")
    print(f"Average: {elapsed_time/processed_count:.2f} seconds per document")

# Usage
batch_extract_raw("input_documents", "extracted_text")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Quickly processes multiple documents using Raw mode for maximum throughput.

## When to use Raw mode

**Use Raw mode when:**
- Processing large volumes of documents
- Speed is more important than formatting
- Extracting text for indexing or search
- Layout preservation is not critical
- Working with simple text documents

**Use Accurate mode when:**
- Formatting quality is important
- Layout must be preserved
- Extracting structured data
- Processing invoices or forms
- Output will be displayed to users

## Extract and index text (search use case)

Raw mode is ideal for creating search indexes:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import TextOptions
from pathlib import Path
import json

def create_search_index(input_dir, index_file):
    """
    Create a search index from documents using Raw mode.
    """
    index = {}
    options = TextOptions(False)  # Raw mode for speed
    
    for file_path in Path(input_dir).rglob('*'):
        if file_path.suffix.lower() in ['.pdf', '.docx', '.doc', '.txt']:
            try:
                with Parser(str(file_path)) as parser:
                    text_reader = parser.get_text(options)
                    
                    if text_reader:
                        text = text_reader
                        
                        # Create index entry
                        index[str(file_path)] = {
                            'filename': file_path.name,
                            'size': len(text),
                            'preview': text[:200],  # First 200 chars
                            'word_count': len(text.split())
                        }
                        
                        print(f"Indexed: {file_path.name}")
            
            except Exception as e:
                print(f"Error indexing {file_path.name}: {e}")
    
    # Save index
    with open(index_file, 'w', encoding='utf-8') as f:
        json.dump(index, f, indent=2, ensure_ascii=False)
    
    print(f"
Created index with {len(index)} documents")
    return index

# Usage
index = create_search_index("documents", "search_index.json")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a lightweight search index using fast Raw mode extraction.

## Notes

- Raw mode is typically 2-5x faster than Accurate mode
- Use `raw_page_count` instead of `page_count` in Raw mode
- Text layout and formatting may differ from the original document
- Raw mode returns `None` for unsupported documents (same as Accurate mode)
- Some documents may have different page numbers in Raw vs Accurate mode
- Raw mode is still accurate for plain text content, just not for complex layouts

## Related pages

- [Extract text in Accurate mode]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode" >}})
- [Search text in documents]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/search-text" >}})
- [Get document info]({{< ref "parser/python-net/developer-guide/basic-usage/get-document-info" >}})


---

## Extract text in Raw Mode

Path: /parser/java/extract-text-in-raw-mode/

GroupDocs.Parser provides the functionality to extract a text from documents.

The **Raw** mode is the fastest text extraction mode and it means that performance wlll be the best possible.

Raw mode usually retrieves text in worse quality than Accurate mode, but in some cases performance is more important than quality.

You can extract the whole document text or only a document page.

To extract a text from the document in the Raw mode, [getText(TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(com.groupdocs.parser.options.TextOptions)) and [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) class are used:

```java
TextReader getText(TextOptions options);
TextReader getText(int pageIndex, TextOptions options);
```

Methods return an instance of [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class with an extracted text. The first method extracts a text from the whole document. The second method extracts a text from the document page. To retrieve the total number of document pages [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method is used (see below).

{{< alert style="warning" >}}Instead of the accurate mode, [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) property is used to avoid extra calculations.{{< /alert >}}

[TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class extends [*java.io.Reader*](http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true) and adds the following members:

| Member | Description |
| --- | --- |
| [readLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readLine()) | Reads a line of characters from the text reader and returns the data as a string. |
| [readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) | Reads all characters from the current position to the end of the text reader and returns them as one string. |

## Extract text

Here are the steps to extract a raw text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [TextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextOptions) object with *true* parameter;
*   Call [getText(TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(com.groupdocs.parser.options.TextOptions)) method with [TextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextOptions) parameter and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Check if *reader* isn't *null* (text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a raw text from a document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Extract a raw text into the reader
    try (TextReader reader = parser.getText(new TextOptions(true))) {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
}
```

## Extract text from page

Here are the steps to extract a raw text from the document page:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [TextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextOptions) object with *true* parameter;
*   Call [isText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isText()) property to check if text extraction is supported for the document;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method;
*   Use [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) instead of [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) to avoid extra calculations;
*   Call [getText(int, TextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText(int,%20com.groupdocs.parser.options.TextOptions)) method with the page index and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader "class in com.groupdocs.parser.data") object;
*   Read a text from *reader*.

The following example shows how to extract a raw text from a document page:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Check if the document supports text extraction
    if (!parser.getFeatures().isText()) {
        System.out.println("Document isn't supports text extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Check if the document has pages
    if (documentInfo == null || documentInfo.getRawPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int p = 0; p < documentInfo.getRawPageCount(); p++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", p + 1, documentInfo.getPageCount()));
        // Extract a text into the reader
        try (TextReader reader = parser.getText(p, new TextOptions(true))) {
            // Print a text from the document
            // We ignore null-checking as we have checked text extraction feature support earlier
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extracting metadata

Path: /metadata/java/extracting-metadata/

Using the GroupDocs.Metadata search engine you can extract desired metadata properties from files of different types. You don't need to worry about the exact file format and metadata standards it can deal with. The same code will work for all supported formats in the same way. Most commonly used metadata properties are marked with tags that allow searching them across all supported files in various metadata packages. All tags defined in GroupDocs.Metadata are divided into categories that make it easier to find a required tag. The code sample below demonstrates some advanced usage of tags, categories and other attributes of metadata properties.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to be searched for metadata properties
2.  Make up a predicate to examine all extracted metadata properties
3.  Pass the predicate to the [findProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#findProperties(com.groupdocs.metadata.search.Specification)) method
4.  Iterate through the found properties

**advanced\_usage.ExtractingMetadata**

```csharp
public class ExtractingMetadata {
    public static void run() {
        File folder = new File(Constants.InputPath);
        for (File file : folder.listFiles()) {
            try (Metadata metadata = new Metadata(file.getAbsolutePath())) {
                if (metadata.getFileFormat() != FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
                    System.out.println();
                    System.out.println(file.getName());

                    // Fetch all metadata properties that fall into a particular category
                    IReadOnlyList<MetadataProperty> properties = metadata.findProperties(new FallsIntoCategorySpecification(Tags.getContent()));
                    System.out.println("The metadata properties describing some characteristics of the file content: title, keywords, language, etc.");
                    for (MetadataProperty property : properties) {
                        System.out.println(String.format("Property name: %s, Property value: %s", property.getName(), property.getValue()));
                    }

                    // Fetch all properties having a specific type and value
                    int year = Calendar.getInstance().get(Calendar.YEAR);
                    properties = metadata.findProperties(new OfTypeSpecification(MetadataPropertyType.DateTime).and(new ExtractingMetadata().new YearMatchSpecification(year)));
                    System.out.println("All datetime properties with the year value equal to the current year");
                    for (MetadataProperty property : properties) {
                        System.out.println(String.format("Property name: %s, Property value: %s", property.getName(), property.getValue()));
                    }

                    // Fetch all properties whose names match the specified regex
                    Pattern pattern = Pattern.compile("^author|company|(.+date.*)$", Pattern.CASE_INSENSITIVE);
                    properties = metadata.findProperties(new ExtractingMetadata().new RegexSpecification(pattern));
                    System.out.println(String.format("All properties whose names match the following regex: %s", pattern.pattern()));
                    for (MetadataProperty property : properties) {
                        System.out.println(String.format("Property name: %s, Property value: %s", property.getName(), property.getValue()));
                    }
                }
            }
        }
    }

    // Define your own specifications to filter metadata properties
    public class YearMatchSpecification extends Specification {
        public YearMatchSpecification(int year) {
            setValue(year);
        }

        public final int getValue() {
            return auto_Value;
        }

        private void setValue(int value) {
            auto_Value = value;
        }

        private int auto_Value;

        public boolean isSatisfiedBy(MetadataProperty candidate) {
            Date date = candidate.getValue().toClass(Date.class);
            if (date != null) {
                Calendar calendar = Calendar.getInstance();
                calendar.setTime(date);
                return getValue() == calendar.get(Calendar.YEAR);
            }
            return false;
        }
    }

    public class RegexSpecification extends Specification {
        private Pattern pattern;
        public RegexSpecification(Pattern pattern) {
            this.pattern = pattern;
        }

        @Override
        public boolean isSatisfiedBy(MetadataProperty metadataProperty) {
            Matcher matcher = pattern.matcher(metadataProperty.getName());
            return matcher.find();
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Extracting metadata

Path: /metadata/net/extracting-metadata/

Using the GroupDocs.Metadata for .NET you can easily extract metadata from PDF, DOC, PPT, XLS and many other files of different types in your .NET solution.

GroupDocs.Metadata for .NET supports many file formats. See full list at [supported file formats]({{< ref "metadata/net/getting-started/supported-document-formats.md" >}}) article.

You don't need to worry about the exact file format and metadata standards it can deal with. The same code will work for all supported formats in the same way.

Most commonly used metadata properties are marked with tags that allow searching them across all supported files in various metadata packages. All tags defined in GroupDocs.Metadata are divided into categories that make it easier to find a required tag.

In this article we would like to demonstrate some advanced usage of tags, categories and other attributes of metadata properties.

The following steps and C# code sample below show **how to extract metadata properties from your files in .NET solution**:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to be searched for metadata properties
2.  Make up a predicate to examine all extracted metadata properties
3.  Pass the predicate to the [FindProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/findproperties) method
4.  Iterate through the found properties

### Extracting Metadata Properties By Tag

```csharp
foreach (string file in Directory.GetFiles(Constants.InputPath))
{
	using (Metadata metadata = new Metadata(file))
	{
		if (metadata.FileFormat != FileFormat.Unknown && !metadata.GetDocumentInfo().IsEncrypted)
		{
			// Fetch all metadata properties that fall into a particular category
			var properties = metadata.FindProperties(p => p.Tags.Any(t => t.Category == Tags.Content));
			Console.WriteLine("The metadata properties describing some characteristics of the file content: title, keywords, language, etc.");
			foreach (var property in properties)
			{
				Console.WriteLine("{0} = {1}", property.Name, property.Value);
			}
		}
	}
}
```

### Extracting Metadata Properties By Type And Value

```csharp
foreach (string file in Directory.GetFiles(Constants.InputPath))
{
	using (Metadata metadata = new Metadata(file))
	{
		if (metadata.FileFormat != FileFormat.Unknown && !metadata.GetDocumentInfo().IsEncrypted)
		{
			// Fetch all properties having a specific type and value
			var year = DateTime.Today.Year;
			properties = metadata.FindProperties(p => p.Value.Type == MetadataPropertyType.DateTime &&
													 p.Value.ToStruct(DateTime.MinValue).Year == year);
			Console.WriteLine("All datetime properties with the year value equal to the current year");
			foreach (var property in properties)
			{
				Console.WriteLine("{0} = {1}", property.Name, property.Value);
			}
		}
	}
}
```

### Extracting Metadata Properties By Specified Regex Expression

```csharp
foreach (string file in Directory.GetFiles(Constants.InputPath))
{
	using (Metadata metadata = new Metadata(file))
	{
		if (metadata.FileFormat != FileFormat.Unknown && !metadata.GetDocumentInfo().IsEncrypted)
		{
			// Fetch all properties whose names match the specified regex
			const string pattern = "^author|company|(.+date.*)$";
			Regex regex = new Regex(pattern, RegexOptions.IgnoreCase);
			properties = metadata.FindProperties(p => regex.IsMatch(p.Name));
			Console.WriteLine("All properties whose names match the following regex: {0}", pattern);
			foreach (var property in properties)
			{
				Console.WriteLine("{0} = {1}", property.Name, property.Value);
			}
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Extracting metadata

Path: /metadata/nodejs-java/extracting-metadata/

Using the GroupDocs.Metadata search engine you can extract desired metadata properties from files of different types. You don't need to worry about the exact file format and metadata standards it can deal with. The same code will work for all supported formats in the same way. Most commonly used metadata properties are marked with tags that allow searching them across all supported files in various metadata packages. All tags defined in GroupDocs.Metadata are divided into categories that make it easier to find a required tag. The code sample below demonstrates some advanced usage of tags, categories and other attributes of metadata properties.

1.  **Load** a file to be searched for metadata properties
2.  Make up a predicate to examine all extracted metadata properties
3.  Pass the predicate to the **findProperties** method
4.  Iterate through the found properties

**advanced\_usage.ExtractingMetadata**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
fs.readdirSync(Constants.inputPath).forEach(file => {
            var metadata = new groupdocs.metadata.Metadata(Constants.inputPath + file);
            if (metadata.getFileFormat() != groupdocs.metadata.FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
                
                console.log(file);

                var searchSpecification = new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getPerson().getEditor()).or(new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getTime().getModified()));
                var metadataProperties = metadata.findProperties(searchSpecification);

                for (var i =0; i< metadataProperties.getCount(); i++) {
                    console.log(`Property name: ${metadataProperties.get_Item(i).getName()}, Property value: ${metadataProperties.get_Item(i).getValue()}`);
                }
            }
      });
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Extracting metadata

Path: /metadata/python-net/extracting-metadata/

Using the GroupDocs.Metadata search engine you can extract desired metadata properties from files of different types. You don't need to worry about the exact file format and metadata standards it can deal with. The same code will work for all supported formats in the same way. Most commonly used metadata properties are marked with tags that allow searching them across all supported files in various metadata packages. All tags defined in GroupDocs.Metadata are divided into categories that make it easier to find a required tag. The code sample below demonstrates some advanced usage of tags, categories and other attributes of metadata properties.

1.  **Load** a file to be searched for metadata properties
2.  Make up a predicate to examine all extracted metadata properties
3.  Pass the predicate to the **findProperties** method
4.  Iterate through the found properties

**advanced\_usage.ExtractingMetadata**


```python
def run():
    files = os.listdir(constants.input_path)
    for file in files:
        with gm.Metadata(constants.input_path+file) as metadata:
            if metadata.file_format != gm.common.FileFormat.UNKNOWN and metadata.get_document_info().is_encrypted != True:
                print()
                print(file)

                specification = gm.search.FallsIntoCategorySpecification(gm.tagging.Tags.content)
                properties = metadata.find_properties(specification)
                for property in properties:
                    print(f"Property name: {property.name}, Property value: {property.value}")
```


## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Extracting property values

Path: /metadata/java/extracting-property-values/

The most common way to get the metadata property value is to check its type and convert it to the appropriate platform-specific type.

**advanced\_usage.extracting\_property\_values.ExtractUsingType**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDocx)) {
	// Fetch all metadata properties from the file
	IReadOnlyList<MetadataProperty> properties = metadata.findProperties(new AnySpecification());
	for (MetadataProperty property : properties) {
		// Process String and DateTime properties only
		if (property.getValue().getType() == MetadataPropertyType.String) {
			System.out.println(property.getValue().toClass(String.class));
		} else if (property.getValue().getType() == MetadataPropertyType.DateTime) {
			System.out.println(property.getValue().toClass(Date.class));
		}
	}
}
```

But if it's necessary to process all supported types of values you may find the alternative way more convenient.

**advanced\_usage.extracting\_property\_values.ExtractUsingAcceptor**

```csharp
public class ExtractUsingAcceptor {

    public static void run() {
        try (Metadata metadata = new Metadata(Constants.InputDocx)) {
            // Fetch all metadata properties
            IReadOnlyList<MetadataProperty> properties = metadata.findProperties(new AnySpecification());

            ValueAcceptor valueAcceptor = new ExtractUsingAcceptor().new CustomValueAcceptor();
            for (MetadataProperty property : properties) {
                // Extract the property value using a custom acceptor
                property.getValue().acceptValue(valueAcceptor);
            }
        }
    }

    private class CustomValueAcceptor extends ValueAcceptor {
        protected void acceptNull() {
            System.out.println("Null value extracted");
        }

        protected void accept(String value) {
            System.out.println(String.format("String value extracted: %s", value));
        }

        protected void accept(boolean value) {
            System.out.println(String.format("Boolean value extracted: %s", value));
        }

        protected void accept(Date value) {
            System.out.println(String.format("DateTime value extracted: %s", value));
        }

        protected void accept(int value) {
            System.out.println(String.format("Integer value extracted: %s", value));
        }

        protected void accept(long value) {
            System.out.println(String.format("Long value extracted: %s", value));
        }

        protected void accept(double value) {
            System.out.println(String.format("Double value extracted: %s", value));
        }

        protected void accept(String[] value) {
            System.out.println(String.format("String array extracted: %s", (Object) value));
        }

        protected void accept(byte[] value) {
            System.out.println(String.format("Byte array extracted: %s", value));
        }

        protected void accept(double[] value) {
            System.out.println(String.format("Double array extracted: %s", value));
        }

        protected void accept(int[] value) {
            System.out.println(String.format("Integer array extracted: %s", value));
        }

        protected void accept(long[] value) {
            System.out.println(String.format("Long array extracted: %s", value));
        }

        protected void accept(MetadataPackage value) {
            System.out.println(String.format("Metadata package value extracted: %s", value));
        }

        protected void accept(MetadataPackage[] value) {
            System.out.println(String.format("Metadata package array extracted: %s", (Object) value));
        }

        protected void accept(UUID value) {
            System.out.println(String.format("Guid value extracted: %s", value));
        }

        protected void accept(PropertyValue[] value) {
            System.out.println(String.format("Property value array extracted: %s", (Object) value));
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Extracting property values

Path: /metadata/net/extracting-property-values/

The most common way to get the metadata property value is to check its type and convert it to the appropriate platform-specific type.

**AdvancedUsage.ExtractingPropertyValues.ExtractUsingType**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	// Fetch all metadata properties from the file
	var properties = metadata.FindProperties(p => true);
	foreach (var property in properties)
	{
		// Process string and DateTime properties only
		if (property.Value.Type == MetadataPropertyType.String)
		{
			Console.Write(property.Value.ToClass<string>());
		}
		else if (property.Value.Type == MetadataPropertyType.DateTime)
		{
			Console.Write(property.Value.ToStruct(DateTime.MinValue));
		}
	}
}
```

But if it's necessary to process all supported types of values you may find the alternative way more convenient.

**AdvancedUsage.ExtractingPropertyValues.ExtractUsingAcceptor**

```csharp
static void Main(string[] args)
{
    using (Metadata metadata = new Metadata(Constants.InputDocx))
    {
        // Fetch all metadata properties
        var properties = metadata.FindProperties(p => true);
 
        var valueAcceptor = new CustomValueAcceptor();
        foreach (var property in properties)
        {
            // Extract the property value using a custom acceptor
            property.Value.AcceptValue(valueAcceptor);
        }
    }
    Console.ReadKey();
}

private class CustomValueAcceptor : ValueAcceptor
{
    protected override void AcceptNull()
    {
        Console.WriteLine("Null value extracted");
    }
 
    protected override void Accept(string value)
    {
        Console.WriteLine("String value extracted: {0}", value);
    }
 
    protected override void Accept(bool value)
    {
        Console.WriteLine("Boolean value extracted: {0}", value);
    }
 
    protected override void Accept(DateTime value)
    {
        Console.WriteLine("DateTime value extracted: {0}", value);
    }
 
    protected override void Accept(TimeSpan value)
    {
        Console.WriteLine("DateTime value extracted: {0}", value);
    }
 
    protected override void Accept(int value)
    {
        Console.WriteLine("Integer value extracted: {0}", value);
    }
 
    protected override void Accept(long value)
    {
        Console.WriteLine("Long value extracted: {0}", value);
    }
 
    protected override void Accept(double value)
    {
        Console.WriteLine("Double value extracted: {0}", value);
    }
 
    protected override void Accept(string[] value)
    {
        Console.WriteLine("String array extracted: {0}", value?.Length ?? 0);
    }
 
    protected override void Accept(byte[] value)
    {
        Console.WriteLine("Byte array extracted: {0}", value?.Length ?? 0);
    }
 
    protected override void Accept(double[] value)
    {
        Console.WriteLine("Double array extracted: {0}", value?.Length ?? 0);
    }
 
    protected override void Accept(int[] value)
    {
        Console.WriteLine("Integer array extracted: {0}", value?.Length ?? 0);
    }
 
    protected override void Accept(long[] value)
    {
        Console.WriteLine("Long array extracted: {0}", value?.Length ?? 0);
    }
 
    protected override void Accept(MetadataPackage value)
    {
        Console.WriteLine("Metadata package value extracted: {0}", value);
    }
 
    protected override void Accept(MetadataPackage[] value)
    {
        Console.WriteLine("Metadata package array extracted: {0}", value?.Length ?? 0);
    }
 
    protected override void Accept(Guid value)
    {
        Console.WriteLine("Guid value extracted: {0}", value);
    }
 
    protected override void Accept(PropertyValue[] value)
    {
        Console.WriteLine("Property value array extracted: {0}", value?.Length ?? 0);
    }
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Extracting property values

Path: /metadata/python-net/extracting-property-values/

The most common way to get the metadata property value is to check its type and convert or read it accordingly to a platform-specific type.

**advanced_usage.extracting_property_values.extract_using_type**


```python
def run():
    with gm.Metadata(constants.input_docx) as metadata:
        # Fetch all metadata properties from the file
        properties = metadata.find_properties(lambda p: True)
        for prop in properties:
            # Process string and datetime properties only (as an example)
            if prop.value.type == gm.common.MetadataPropertyType.STRING:
                print(prop.value.to_class(str))
            elif prop.value.type == gm.common.MetadataPropertyType.DATE_TIME:
                # Provide a default if conversion fails
                print(prop.value.to_struct(datetime.min))
```


If it's necessary to process many supported types generically, you can inspect `prop.value.raw_value` and `prop.value.type` and branch accordingly. This lets you handle arrays, numbers, booleans, nested packages, etc., in a single pass.

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Features Overview

Path: /assembly/java/features-overview/

## Features Overview

GroupDocs.Assembly for Java is an API that allows you to generate documents in popular office and email file formats based upon template documents and data obtained from various sources including databases, XML, JSON, OData and more. The following is the list of salient features which are offered by the GroupDocs.Assembly API:

*   Multiple data formats support
*   Use formulae & perform sequential data operations
*   Apply upper, lower, capital, firstcap formatting to strings in template syntax
*   Template syntax support formatting of ordinal, cardinal, alphabetic numeric nature
*   Support template documents with custom variables & text comments within template syntax tags
*   Dynamically insert out document content in report
*   Dynamically configure background color of html documents & generate barcode in reports
*   Dynamically insert hyperlinks in reports & apply attributes to email message body
*   Dynamically attach email attachments
*   Support of next field analogue of Microsoft Word
*   Update fields during word processing document assembly
*   Apply formula during spreadsheet assembly
*   Template formatting for numeric, text, image, date-time, chart elements
*   Conditional formatting of template text elements
*   Linq-based template syntax
*   Change format of assembled file using explicit specifications or file extension
*   Auto-removal of empty paragraphs
*   Generate various report types, e.g., charts, image, tables, lists and more
*   Inline template syntax errors in generated documents instead of exception throwing.
*   Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources

Following is the detail given about how the features are offered with their usage and limits.

## Data Sources

### Data Formats

| Feature | Support in GroupDocs.Assembly for Java |
| --- | --- |
| Database | Supported (using DataSet, DataTable, etc.) |
| XML | Supported (using DataSet.ReadXml or XML deserialization of custom objects) |
| OData | Supported (using deserialization of custom objects through WCF or [third-party Java libraries](https://en.wikipedia.org/wiki/Open_Data_Protocol#Java)) |
| JSON | Supported (using a third-party component like [JsonJava](http://www.newtonsoft.com/json) on DataSet or custom objects in Java) |
| Custom Java Objects | Supported |
| Ability to use Spreadsheet as Table of Data | Supported |
| Ability to use Word processing Table as Table of Data | Supported |

### Data Manipulation Capabilities

| Feature | Support in GroupDocs.Assembly for Java |
| --- | --- |
| Formulas | Supported |
| Sequential Data Operations (filtering, ordering, grouping, aggregating, etc.) | Supported (through LINQ syntax for data sources of all types, LINQ extension method analogues are named using lower camel case) |
| Type Member Invocation | Supported |
| Built-In Data Relation Support | Supported |
| Data Processing Customization | Supported (using external Java types) |
| External Document Import | Supported |

### Explicit Support for Multiple Data Sources

A new overload **DocumentAssembler.AssembleDocument** is added in the new release. Using this overload user can reference multiple data source objects and their members in the template. Overload accepts an array of data source names and an array of data sources. Learn more about support of multiple data sources in [this](https://docs.groupdocs.com/assembly/java/working-with-multiple-data-sources/) article.

## Template Formats, Elements and Syntax

### Template Document Formats

#### Word Processing Document Formats

Word Processing Document formats including Microsoft Word Document and OpenOffice document formats are supported. For more details, please visit [Support for Word Processing Document Formats](https://docs.groupdocs.com/assembly/java/supported-document-formats/#supported-file-formats).

#### Spreadsheet Document Formats

Spreadsheet Document formats including Microsoft Excel Workbook and OpenOffice spreadsheet document formats are supported. For more details, please visit [Support for Spreadsheet Document Formats](https://docs.groupdocs.com/assembly/java/supported-document-formats/#supported-file-formats).

#### Presentation Document Formats

Presentation Document formats including Microsoft PowerPoint Presentation and OpenOffice presentation document formats are supported. For more details, please visit [Support for Presentation Document Formats](https://docs.groupdocs.com/assembly/java/supported-document-formats/#supported-file-formats).

#### More Document Formats

More Document formats including Email, PDF, HTML, Plain Text, Epub and XPS document formats will be supported in the future releases. For more details, please visit [Support for more Document Formats](https://docs.groupdocs.com/assembly/java/supported-document-formats/#supported-file-formats).

#### Dynamic Merging of Table Cells

You can merge table cells with equal textual contents within your reports dynamically using **cellMerge** tag. For the detail, please visit [Merging Table Cells Dynamically](https://docs.groupdocs.com/assembly/java/merging-table-cells-dynamically/).

#### Textual Comments within Template Syntax Tags

An optional comment providing a human-readable explanation ignored by the engine

```java
<<tag_name [expression] –switch1 –switch2 ... // optional_comment >>
```

#### In-lining of Syntax Error Messages into Templates 

In-lining of syntax error messages into templates instead of exception throwing. For the detail, please visit [Use of In-line Syntax Error Messages into Templates](https://docs.groupdocs.com/assembly/java/use-of-in-line-syntax-error-messages-into-templates/).

### Template Elements

| Feature | Support in GroupDocs.Assembly for Java |
| --- | --- |
| Formatted Text Blocks | Supported |
| HTML Blocks | Supported |
| Repeated Blocks (including list items and table rows) | Supported |
| Conditional Blocks | Supported (including list items and table rows) |
| Pivot Tables | To be supported |
| Images | Supported |
| Charts | Supported |
| Barcodes (through barcode fonts) | Supported |
| Bound Form Controls | To be supported |
| Hyperlinks to URI or Bookmarks | Supported |

### Template Syntax Formats for Expression Results

#### Specifying String Formats

API provides a useful feature to format strings in template syntax. String formatting such as upper, lower, capital, etc.

| String Format | Description |
| --- | --- |
| lower | Converts a string to lower case ("the string") |
| upper | Converts a string to upper case ("THE STRING") |
| caps | Capitalizes a first letter of every word in a string ("The String") |
| firstCap | Capitalizes the first letter of the first word in a string ("The string") |

#### Specifying Numeric Formats

Using GroupDocs.Assembly for Java user can also do numeric formatting in template syntax. Numeric formatting such as ordinal, cardinal, alphabetic, etc.

| Number Format | Description |
| --- | --- |
| alphabetic | Formats an integer number as an upper-case letter (A, B, C, ...) |
| roman | Formats an integer number as an upper-case Roman numeral (I, II, III, ...) |
| ordinal | Appends an ordinal suffix to an integer number (1st, 2nd, 3rd, ...) |
| ordinalText | Converts an integer number to its ordinal text representation (First, Second, Third, ...) |
| cardinal | Converts an integer number to its text representation (One, Two, Three, ...) |
| hex | Formats an integer number as hexadecimal (8, 9, A, B, C, D, E, F, 10, 11, ...) |
| arabicDash | Encloses an integer number with dashes (- 1 -, - 2 -, - 3 -, ...) |

#### Variables in Template Documents

API permits users to define variables in template documents as follows:

```java
<<var [st = "Hello, "]>><<[st]>><<var[st = "World!"]>><<[st]>>
```

### Support for Outer Document Insertion

You can insert contents of outer documents to your reports dynamically.

### Barcode Image Generation

Barcode images can be generated in reports dynamically.

### Support for Analogue of Microsoft Word NEXT Field

This feature allows user to implement a new <<next>> tag. The tag should be supported only within data bands created by using <<foreach>> tag.

### Setting Background Color Dynamically

For [HTML documents](https://docs.groupdocs.com/assembly/java/bulleted-list-in-html-document/), a background color can not be set dynamically using the backColor tag

```java
<<backColor ["red"]>>text with red background<</backColor>>
```

Aside this, you can use the HTML style attribute to achieve this. 

### Inserting Images Dynamically

You can insert images to your reports dynamically using **image** tags.

```java
<<image [image_expression]>>
```

### Ability to Update Fields

API permits users to update fields while assembling Word Processing documents.

### Ability to Calculate Formulas

API allows users to calculate formula while assembling Spreadsheet documents.

### Template Elements Formatting

| Feature | Support in GroupDocs.Assembly for Java |
| --- | --- |
| Numeric/Date-Time Value Formatting | Supported |
| Text Formatting | Supported |
| Conditional Text Formatting | Supported (only through conditional blocks) |
| Image Formatting | Supported (WYSIWYG) |
| Chart Formatting | Supported (WYSIWYG) |

### Template Syntax

| Feature | Support in GroupDocs.Assembly for Java |
| --- | --- |
| LINQ-Based | Supported, LINQ extension method analogues are named using lower camel case |
| [Mustache](https://mustache.github.io/mustache.5.html) | To be supported |

### Changing Output File Format 

GroupDocs.Assembly provides a powerful feature to change the target file format of an assembled document using file extension or explicit specification.

### Loading HTML and Saving To HTML with External Resource Files

Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources. Please visit the following articles for the detail:

*   [Loading of template documents from HTML with resources](https://docs.groupdocs.com/assembly/java/loading-of-template-documents-from-html-with-resources/)
*   [Saving to HTML with External Resource Files](https://docs.groupdocs.com/assembly/java/saving-to-html-with-external-resource-files/)

### Numbering Restart in Nested Numbered List 

The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using *<<restartNum>>* tags. In particular, this feature is useful when working with a nested numbered list within a data band. Please visit [this article](https://docs.groupdocs.com/assembly/java/numbered-list-in-word-processing-document/#restart-numbering-in-nested-numbered-list) for more details

### Metered Licensing

The GroupDocs.Assembly.Metered public class has been added to provide metered licensing.

---

## Features Overview

Path: /assembly/net/features-overview/


GroupDocs.Assembly for .NET is an API that allows you to generate documents in popular *microsoft office* and email file formats based upon template documents and data obtained from various sources including databases, XML, JSON, OData, objects of custom .NET types, external documents, and more. The following is the list of salient features which are offered by the GroupDocs.Assembly API:

*   Multiple data formats support
*   Use formulae & perform sequential data operations
*   Apply upper, lower, capital, firstcap formatting to strings in template syntax
*   Template syntax support formatting of ordinal, cardinal, alphabetic numeric nature
*   Support template documents with custom variables & text comments within template syntax tags
*   Dynamically insert out document content in report
*   Dynamically configure background color of html documents & generate barcode in reports
*   Dynamically insert hyperlinks in reports & apply attributes to email message body
*   Dynamically attach email attachments
*   Support of next field analogue of Microsoft Word
*   Update fields during word processing document assembly
*   Apply formula during spreadsheet assembly
*   Template formatting for numeric, text, image, date-time, chart elements
*   Conditional formatting of template text elements
*   Linq-based template syntax
*   Change format of assembled file using explicit specifications or file extension
*   Auto-removal of empty paragraphs
*   Generate various report types, e.g., charts, image, tables, lists and more
*   Inline template syntax errors in generated documents instead of exception throwing.
*   Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources

Following is the detail given about how the features are offered with their usage and limits.

## Data Sources

### Data Formats

| Feature | Support in GroupDocs.Assembly for .NET |
| --- | --- |
| Database | Supported (using DataSet, DataTable, etc.) |
| XML | Supported (using DataSet.ReadXml or XML deserialization of custom objects) |
| OData | Supported (using deserialization of custom objects through WCF or [third-party .NET libraries](https://en.wikipedia.org/wiki/Open_Data_Protocol#.NET) |
| JSON | Supported (using a third-party component like [Json.NET](http://www.newtonsoft.com/json) on DataSet or custom objects in .NET |
| Custom .NET Objects | Supported |
| Ability to use Spreadsheet as Table of Data | Supported |
| Ability to use Word processing Table as Table of Data | Supported |

### Data Manipulation Capabilities

| Feature | Support in GroupDocs.Assembly for .NET |
| --- | --- |
| Formulas | Supported (using C# syntax subset) |
| Sequential Data Operations (filtering, ordering, grouping, aggregating, etc.) | Supported (through LINQ syntax for data sources of all types) |
| Type Member Invocation | Supported |
| Built-In Data Relation Support | Supported |
| Data Processing Customization | Supported (using external .NET types) |
| External Document Import | Supported |

### Explicit Support for Multiple Data Sources

A new overload [**DocumentAssembler.AssembleDocument**](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler/methods/assembledocument/index) is added in the new release. Using this overload user can reference multiple data source objects and their members in the template. Overload accepts an array of data source names and an array of data sources. Learn more about support of multiple data sources in [this](https://docs.groupdocs.com/assembly/net/working-with-multiple-data-sources/) article.

## Template Formats, Elements and Syntax

### Template Document Formats

#### Word Processing Document Formats

Word Processing Document formats including Microsoft Word Document and OpenOffice document formats are supported. For more details, please visit [Support for Word Processing Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportfor-word-processing-document-formats" >}}#SupportedDocumentFormats-SupportforWordProcessingDocumentFormats).

#### Spreadsheet Document Formats

Spreadsheet Document formats including Microsoft Excel Workbook and OpenOffice spreadsheet document formats are supported. For more details, please visit [Support for Spreadsheet Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportfor-spreadsheet-document-formats" >}}#SupportedDocumentFormats-SupportforSpreadsheetDocumentFormats).

#### Presentation Document Formats

Presentation Document formats including Microsoft PowerPoint Presentation and OpenOffice presentation document formats are supported. For more details, please visit [Support for Presentation Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportfor-presentation-document-formats" >}}#SupportedDocumentFormats-SupportforPresentationDocumentFormats).

#### Email Document Formats

Email Document formats is supported. For more details, please visit [Support for Email Document Formats](https://docs.asposeptyltd.com/display/assemblynet/Supported+Document+Formats#SupportedDocumentFormats-EmailDocumentFormats).

#### More Document Formats

HTML and Plain Text document formats are supported by the GroupDocs.Assembly API. More Document formats including PDF, Epub and XPS document formats will be supported in the future releases. For more details, please visit [Support for more Document Formats]({{< ref "assembly/net/getting-started/supported-document-formats.md#supportformore-document-formats" >}}#SupportedDocumentFormats-SupportformoreDocumentFormats).

#### Dynamic Merging of Table Cells

You can merge table cells with equal textual contents within your reports dynamically using **cellMerge** tag. For the detail, please visit [Merging Table Cells Dynamically](https://docs.groupdocs.com/assembly/net/merging-table-cells-dynamically/).

#### Textual Comments within Template Syntax Tags

An optional comment providing a human-readable explanation ignored by the engine

```csharp
<<tag_name [expression] –switch1 –switch2 ... // optional_comment >>
```

#### In-lining of Syntax Error Messages into Templates 

In-lining of syntax error messages into templates instead of exception throwing. For the detail, please visit [Use of In-line Syntax Error Messages into Templates](https://docs.groupdocs.com/assembly/net/use-of-in-line-syntax-error-messages-into-templates/).

### Template Elements

| Feature | Support in GroupDocs.Assembly for .NET |
| --- | --- |
| Formatted Text Blocks | Supported |
| HTML Blocks | Supported |
| Repeated Blocks (including list items and table rows) | Supported |
| Conditional Blocks | Supported (including list items and table rows) |
| Pivot Tables | To be supported |
| Images | Supported |
| Charts | Supported |
| Barcodes (through barcode fonts) | Supported |
| Bound Form Controls | To be supported |
| Hyperlinks to URI or Bookmarks | Supported |

### Template Syntax Formats for Expression Results

#### Specifying String Formats

API provides a useful feature to format strings in template syntax. String formatting such as upper, lower, capital, etc.

| String Format | Description |
| --- | --- |
| lower | Converts a string to lower case ("the string") |
| upper | Converts a string to upper case ("THE STRING") |
| caps | Capitalizes a first letter of every word in a string ("The String") |
| firstCap | Capitalizes the first letter of the first word in a string ("The string") |

#### Specifying Numeric Formats

Using GroupDocs.Assembly for .NET user can also do numeric formatting in template syntax. Numeric formatting such as ordinal, cardinal, alphabetic, etc.

| Number Format | Description |
| --- | --- |
| alphabetic | Formats an integer number as an upper-case letter (A, B, C, ...) |
| roman | Formats an integer number as an upper-case Roman numeral (I, II, III, ...) |
| ordinal | Appends an ordinal suffix to an integer number (1st, 2nd, 3rd, ...) |
| ordinalText | Converts an integer number to its ordinal text representation (First, Second, Third, ...) |
| cardinal | Converts an integer number to its text representation (One, Two, Three, ...) |
| hex | Formats an integer number as hexadecimal (8, 9, A, B, C, D, E, F, 10, 11, ...) |
| arabicDash | Encloses an integer number with dashes (- 1 -, - 2 -, - 3 -, ...) |

#### Variables in Template Documents

API permits users to define variables in template documents as follows:

```csharp
<<var [st = "Hello, "]>><<[st]>><<var[st = "World!"]>><<[st]>>
```

### Support for Outer Document Insertion

You can insert contents of outer documents to your reports dynamically.

### Barcode Image Generation

Barcode images can be generated in reports dynamically.

### Support for Analogue of Microsoft Word NEXT Field

This feature allows user to implement a new <<next>> tag. The tag should be supported only within data bands created by using <<foreach>> tag.

### Setting Background Color Dynamically

For [HTML documents](https://docs.groupdocs.com/assembly/net/bulleted-list-in-html-document/), a background color can not be set dynamically using the backColor tag

```csharp
<<backColor ["red"]>>text with red background<</backColor>>

```

Aside this, you can use the HTML style attribute to achieve this.

### Setting Email Message Attributes Dynamically

In addition to an email message body, you can use GroupDocs.Assembly to set the following email message attributes dynamically using the same template syntax:

*   Subject
*   From
*   To
*   CC
*   BCC

For example, given that recipients is an enumeration of strings "Named Recipient <[named@example.com](mailto:named@example.com)\>" and "[unnamed@example.com](mailto:unnamed@example.com)", you can use the following template to set the To attribute for an email message.

```csharp
<<foreach [r in recipients]>><<[r]>>; <</foreach>>

```

During runtime, the To attribute is set to the following value then.

```csharp
Named Recipient <named@example.com>; unnamed@example.com

```

### Building Email Message Attachments Dynamically

GroupDocs.Assembly enables you to build contents of documents attached to email messages dynamically. To do this, attach template documents (of file formats supported by GroupDocs.Assembly) to your template email message. Then, while assembling the email message, the engine assembles the attached documents as well using the same data sources.

### Ability to Update Fields

API permits users to update fields while assembling Word Processing documents.

### Ability to Calculate Formulas

API allows users to calculate formula while assembling Spreadsheet documents.

### Template Elements Formatting

| Feature | Support in GroupDocs.Assembly for .NET |
| --- | --- |
| Numeric/Date-Time Value Formatting | Supported |
| Text Formatting | Supported |
| Conditional Text Formatting | Supported (only through conditional blocks) |
| Image Formatting | Supported (WYSIWYG) |
| Chart Formatting | Supported (WYSIWYG) |

### Template Syntax

| Feature | Support in GroupDocs.Assembly for .NET |
| --- | --- |
| [LINQ-based](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/) | Supported |
| [Mustache](https://mustache.github.io/mustache.5.html) | To be supported |

### Changing Output File Format 

GroupDocs.Assembly provides a powerful feature to change the target file format of an assembled document using file extension or explicit specification.

### Loading HTML and Saving To HTML with External Resource Files

Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources. Please visit the following articles for the detail:

*   [Loading of template documents from HTML with resources](https://docs.groupdocs.com/assembly/net/loading-of-template-documents-from-html-with-resources/)
*   [Saving to HTML with External Resource Files](https://docs.groupdocs.com/assembly/net/saving-to-html-with-external-resource-files/)

### Numbering Restart in Nested Numbered List 

The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using *<<restartNum>>* tags. In particular, this feature is useful when working with a nested numbered list within a data band. Please visit [this article](https://docs.groupdocs.com/assembly/net/numbered-list-in-word-processing-document/#numbering-restart-in-nested-numbered-list) for more details

  

  

## Metered Licensing

The GroupDocs.Assembly.Metered public class has been added to provide metered licensing. This feature is supported in GroupDocs.Assembly for .NET 16.12.0.

---

## Features Overview

Path: /classification/net/features-overview/

GroupDocs.Classification main feature is an ability to classify raw text and documents with IAB-2, Documents, Sentiment or Sentiment3 [taxonomies]({{< ref "classification/net/developer-guide/taxonomies.md" >}}).
Sentiment Classification (Analysis) supports 4 languages: English, Chinese, Spanish, and German.

GroupDocs.Classification provides flexible set of settings to customize classification process:

| Name | Description | Default value |
| --- | --- | --- |
| bestClassesCount | Select the number of results to return | 1 |
| taxonomy | Select [taxonomy]({{< ref "classification/net/developer-guide/taxonomies.md" >}}) (IAB-2, Documents, Sentiment or Sentiment3). | Taxonomy.Iab2 |
| precisionRecallBalance | Select precision/recall balance for Documents taxonomy. If the classifier is not sure of the result, it will return Other class. If precision selected, then classificator will try to return document class only if completely sure. Opposite if recall selected, then it will try to return document class even if it not sure. Default is a balanced one value. | PrecisionRecallBalance.Default |

##   
Raw text classification

GroupDocs.Classification supports classifying raw text with IAB-2, Documents, Sentiment or Sentiment3 taxonomies. The classifier will not use the document structure in this case.

## Document classification

GroupDocs.Classification supports classifying documents with the next format:

*   Docs
*   PDF
*   OpenOffice
*   RichText (RTF), TXT

## Classification results

GroupDocs.Classification returns result in the next form:

```csharp
ClassificationResult{
    BestClassName: string,
    BestClassProbability: float
    BestResults :
        Array<{
           Name: string,
           Probability: float
        }>
}
```

BestResults will be null if the number of results to return equals 1.

---

## Features Overview

Path: /search/java/features-overview/

This page contains a list of supported features. For detailed information on a particular feature, refer to the corresponding pages in the [Advanced Usage]({{< ref "search/java/developer-guide/advanced-usage/_index.md" >}}) section.

## Indexing

GroupDocs.Search provides the following indexing features:

*   Create index in memory or on disk.
*   Update index to take into account changed, deleted and added documents.
*   Merge several indexes into one.
*   Optimize index to improve search performance.
*   Ability of indexing from a file, stream or structure.
*   Indexing password protected documents.
*   Indexing with stop words.
*   Support for indexing additional fields.
*   Support for blended characters.
*   Support for characters indexed as a whole word.
*   Support for character replacement during indexing.
*   Support for custom text extractors.
*   Options for compact and metadata index.
*   Ability to save extracted text in index with different level of compression.
*   Document filtering during indexing.
*   Deleting indexed paths from index.
*   Ability to separately extract data from documents and index them.
*   Support for optical text recognition on images.
*   Calculation and indexing of image hashes for reverse image search.
*   The ability to create a distributed search network that automatically balances the load across nodes.

## Searching

GroupDocs.Search provides the following search features:

*   Simple word search.
*   Boolean search.
*   Regular expression search.
*   Faceted search.
*   Case sensitive search.
*   Flexible fuzzy search.
*   Synonym search.
*   Homophone search.
*   Wildcard search.
*   Phrase search with wildcards.
*   Search for different word forms.
*   Date range search.
*   Numeric range search.
*   Search by chunks (pages).
*   Document filtering in search result.
*   Search for different object types: text, numbers, dates, file names, document types, metadata fields, document creation/modification dates.
*   Combining different types of search into one search query.
*   Alias substitution in search queries.
*   Perform spell check during search.
*   Perform keyboard layout correction during search.
*   Search queries in text or flexible object form.
*   Highlighting search results in the text of the entire document or in text segments.
*   Multiple simultaneous thread safe search.
*   Thread safe search during indexing, updating or merging operation.
*   Search over several indexes simultaneously.
*   Built-in support for reverse image search.

---

## Features Overview

Path: /search/net/features-overview/

This page contains a list of supported features. For detailed information on a particular feature, refer to the corresponding pages in the [Advanced Usage]({{< ref "search/net/developer-guide/advanced-usage/_index.md" >}}) section.

## Indexing

GroupDocs.Search provides the following indexing features:

*   Create index in memory or on disk.
*   Update index to take into account changed, deleted and added documents.
*   Merge several indexes into one.
*   Optimize index to improve search performance.
*   Ability of indexing from a file, stream or structure.
*   Indexing password protected documents.
*   Indexing with stop words.
*   Support for indexing additional fields.
*   Support for blended characters.
*   Support for characters indexed as a whole word.
*   Support for character replacement during indexing.
*   Support for custom text extractors.
*   Options for compact and metadata index.
*   Ability to save extracted text in index with different level of compression.
*   Document filtering during indexing.
*   Deleting indexed paths from index.
*   Ability to separately extract data from documents and index them.
*   Support for optical text recognition on images.
*   Calculation and indexing of image hashes for reverse image search.
*   The ability to create a distributed search network that automatically balances the load across nodes.

## Searching

GroupDocs.Search provides the following search features:

*   Simple word search.
*   Boolean search.
*   Regular expression search.
*   Faceted search.
*   Case sensitive search.
*   Flexible fuzzy search.
*   Synonym search.
*   Homophone search.
*   Wildcard search.
*   Phrase search with wildcards.
*   Search for different word forms.
*   Date range search.
*   Numeric range search.
*   Search by chunks (pages).
*   Document filtering in search result.
*   Search for different object types: text, numbers, dates, file names, document types, metadata fields, document creation/modification dates.
*   Combining different types of search into one search query.
*   Alias substitution in search queries.
*   Perform spell check during search.
*   Perform keyboard layout correction during search.
*   Search queries in text or flexible object form.
*   Highlighting search results in the text of the entire document or in text segments.
*   Multiple simultaneous thread safe search.
*   Thread safe search during indexing, updating or merging operation.
*   Search over several indexes simultaneously.
*   Built-in support for reverse image search.

---

## Features Overview

Path: /search/nodejs-java/features-overview/

This page contains a list of supported features. For detailed information on a particular feature, refer to the corresponding pages in the [Advanced Usage]({{< ref "search/nodejs-java/developer-guide/advanced-usage/_index.md" >}}) section.

## Indexing

GroupDocs.Search provides the following indexing features:

*   Create index in memory or on disk.
*   Update index to take into account changed, deleted and added documents.
*   Merge several indexes into one.
*   Optimize index to improve search performance.
*   Ability of indexing from a file, stream or structure.
*   Indexing password protected documents.
*   Indexing with stop words.
*   Support for indexing additional fields.
*   Support for blended characters.
*   Support for characters indexed as a whole word.
*   Support for character replacement during indexing.
*   Support for custom text extractors.
*   Options for compact and metadata index.
*   Ability to save extracted text in index with different level of compression.
*   Document filtering during indexing.
*   Deleting indexed paths from index.
*   Ability to separately extract data from documents and index them.
*   Support for optical text recognition on images.
*   Calculation and indexing of image hashes for reverse image search.
*   The ability to create a distributed search network that automatically balances the load across nodes.

## Searching

GroupDocs.Search provides the following search features:

*   Simple word search.
*   Boolean search.
*   Regular expression search.
*   Faceted search.
*   Case sensitive search.
*   Flexible fuzzy search.
*   Synonym search.
*   Homophone search.
*   Wildcard search.
*   Phrase search with wildcards.
*   Search for different word forms.
*   Date range search.
*   Numeric range search.
*   Search by chunks (pages).
*   Document filtering in search result.
*   Search for different object types: text, numbers, dates, file names, document types, metadata fields, document creation/modification dates.
*   Combining different types of search into one search query.
*   Alias substitution in search queries.
*   Perform spell check during search.
*   Perform keyboard layout correction during search.
*   Search queries in text or flexible object form.
*   Highlighting search results in the text of the entire document or in text segments.
*   Multiple simultaneous thread safe search.
*   Thread safe search during indexing, updating or merging operation.
*   Search over several indexes simultaneously.
*   Built-in support for reverse image search.

---

## Find metadata properties

Path: /metadata/java/find-metadata-properties/

## Use tags to find most common metadata properties

To make manipulating metadata easier we attach specific tags to the most commonly used metadata properties extracted from a file. Some metadata standards can have quite a complex structure. Moreover, in most cases, one image, video or document contains more than one metadata packages. Using tags you can search for desirable properties with a few lines of code without even knowing the exact format of the loaded file.

The code sample below demonstrates how to search for specific metadata properties using tags:

1.  [Load]({{< ref "metadata/java/developer-guide/basic-usage/find-metadata-properties.md" >}}) a file to examine
2.  Make up a predicate checking that a specific tag is assigned to a property (alternatively you can use a combination of tags)
3.  Pass the predicate to the [f](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#findProperties(com.groupdocs.metadata.search.Specification))[indProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#findProperties(com.groupdocs.metadata.search.Specification)) method
4.  Iterate through the found properties

**basic\_usage.FindMetadataProperties**

```csharp
// Constants.InputPptx is an absolute or relative path to your document. Ex: @"C:\Docs\source.pptx"
try (Metadata metadata = new Metadata(Constants.InputPptx)) {
	// Fetch all the properties satisfying the predicate:
	// property contains the name of the last document editor OR the date/time the document was last modified
	IReadOnlyList<MetadataProperty> properties = metadata.findProperties(
			new ContainsTagSpecification(Tags.getPerson().getEditor()).or(new ContainsTagSpecification(Tags.getTime().getModified())));
	for (MetadataProperty property : properties) {
		System.out.println(String.format("Property name: %s, Property value: %s", property.getName(), property.getValue()));
	}
}
```

As a result, we obtain all metadata properties containing the name of the person last edited the document and all properties that store the date/time the document was last edited.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/java/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/java/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/java/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/java/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Find metadata properties

Path: /metadata/net/find-metadata-properties/

Using the GroupDocs.Metadata for .NET you can easily search metadata and extract desired metadata properties from PDF, DOCX, PPTX, XLSX, images, audio, video and many other files of different types in your .NET solution.

GroupDocs.Metadata for .NET supports many file formats. See full list at [supported file formats]({{< ref "metadata/net/getting-started/supported-document-formats.md" >}}) article.

## Use tags to find most common metadata properties

To make manipulating metadata in your code easier we attach specific tags to the most commonly used metadata properties extracted from a file. Some metadata standards can have quite a complex structure. Moreover, in most cases, an image, video or document contains more than one metadata packages. Using tags you can search for desirable properties with a few lines of code without even knowing the exact format of the loaded file.

In this article we will demonstrate how to search and extract metadata from PPTX Microsoft PowerPoint presentation. Using the same code, you can easily search matadata properties of any supported file formats.

The following steps and C# code sample below show **how to search for specific metadata properties using tags in .NET solution**:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to examine.
2.  Make up a predicate checking that a specific tag is assigned to a property (alternatively you can use a combination of tags)
3.  Pass the predicate to the [FindProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/findproperties) method
4.  Iterate through the found properties

**BasicUsage.FindMetadataProperties**

```csharp
// Constants.InputPptx is an absolute or relative path to your document. Ex: @"C:\Docs\source.pptx"
using (Metadata metadata = new Metadata(Constants.InputPptx))
{
	// Fetch all the properties satisfying the predicate:
	// property contains the name of the last document editor OR the date/time the document was last modified
	var properties = metadata.FindProperties(p => p.Tags.Contains(Tags.Person.Editor) || p.Tags.Contains(Tags.Time.Modified));

	foreach (var property in properties)
	{
		Console.WriteLine("Property name: {0}, Property value: {1}", property.Name, property.Value);
	}
}
```

As a result, we obtain all metadata properties containing the name of the person last edited the document and all properties that store the date/time the document was last edited.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/net/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/net/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/net/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/net/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources
### Advanced usage topics
To learn more about document watermarking features and get familiar how to manage watermarks and more, please refer to the [advanced usage section]({{< ref "metadata/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Find metadata properties

Path: /metadata/nodejs-java/find-metadata-properties/

## Use tags to find most common metadata properties

To make manipulating metadata easier we attach specific tags to the most commonly used metadata properties extracted from a file. Some metadata standards can have quite a complex structure. Moreover, in most cases, one image, video or document contains more than one metadata packages. Using tags you can search for desirable properties with a few lines of code without even knowing the exact format of the loaded file.

The code sample below demonstrates how to search for specific metadata properties using tags:

1.  **Load** a file to examine
2.  Make up a predicate checking that a specific tag is assigned to a property (alternatively you can use a combination of tags)
3.  Pass the predicate to the **findProperties** method
4.  Iterate through the found properties

**basic\_usage.FindMetadataProperties**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
// Fetch all the properties satisfying the predicate:
    // property contains the name of the last document editor OR the date/time the document was last modified
    var searchSpecification = new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getPerson().getEditor()).or(new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getTime().getModified()));
    var metadataProperties = metadata.findProperties(searchSpecification);

    for (var i =0; i< metadataProperties.getCount(); i++) {
        console.log(`Property name: ${metadataProperties.get_Item(i).getName()}, Property value: ${metadataProperties.get_Item(i).getValue()}`);
    }
```
{{< /tab >}}
{{< /tabs >}}

As a result, we obtain all metadata properties containing the name of the person last edited the document and all properties that store the date/time the document was last edited.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Find metadata properties

Path: /metadata/python-net/find-metadata-properties/

## Use tags to find most common metadata properties

To make manipulating metadata easier we attach specific tags to the most commonly used metadata properties extracted from a file. Some metadata standards can have quite a complex structure. Moreover, in most cases, one image, video or document contains more than one metadata packages. Using tags you can search for desirable properties with a few lines of code without even knowing the exact format of the loaded file.

The code sample below demonstrates how to search for specific metadata properties using tags:

1.  **Load** a file to examine
2.  Make up a predicate checking that a specific tag is assigned to a property (alternatively you can use a combination of tags)
3.  Pass the predicate to the **findProperties** method
4.  Iterate through the found properties

**basic\_usage.FindMetadataProperties**


```python
# Fetch all the properties satisfying the predicate:
    # property contains the name of the last document editor OR the date/time the document was last modified
with gm.Metadata(constants.input_pptx) as metadata:
        specification = gm.search.ContainsTagSpecification(gm.tagging.Tags.person.editor).either(gm.search.ContainsTagSpecification(gm.tagging.Tags.time.modified))
        properties = metadata.find_properties(specification)
        for property in properties:
             print(f"Property name: {property.name}, Property value: {property.value}")
```


As a result, we obtain all metadata properties containing the name of the person last edited the document and all properties that store the date/time the document was last edited.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load from stream

Path: /watermark/net/load-from-stream/

The following example demonstrates how to create a [watermarker](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/main) for a document stream:

**AdvancedUsage.LoadingDocuments.LoadFromStream**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Stream document = File.OpenRead("document.docx"))
using (Watermarker watermarker = new Watermarker(document))
{
    // use watermarker methods to manage watermarks
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
    watermarker.Add(watermark);
    watermarker.Save("document.docx");
}
```


---

## Generate content for static sites

Path: /markdown/net/static-site-generator/


Static site generators like Jekyll, Hugo, and Docusaurus expect Markdown files with YAML front matter. GroupDocs.Markdown can automatically generate front matter from document metadata.

### Convert with front matter and relative images

{{< tabs "ssg-example">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    IncludeFrontMatter = true,
    HeadingLevelOffset = 1,   // Reserve H1 for the page title
    ImageExportStrategy = new ExportImagesToFileSystemStrategy("content/posts/images")
    {
        ImagesRelativePath = "images"
    }
};

MarkdownConverter.ToFile("annual-report.docx", "content/posts/annual-report.md", options);

// Output file starts with:
// ---
// title: "Annual Report 2025"
// author: "Finance Team"
// format: Docx
// pages: 24
// ---
//
// ## Executive Summary
// ...
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/use-cases/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "ssg.zip" >}}  
```text
content/posts/annual-report.md (5 KB)
content/posts/images/img-001.png (4 KB)
content/posts/images/img-002.png (14 KB)
content/posts/images/img-003.png (15 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/use-cases/static-site-generator/SsgExample/ssg.zip)
{{< /tab >}}
{{< /tabs >}}

### Batch-convert a folder for Hugo

{{< tabs "ssg-batch-hugo">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

string inputDir = "documents";
string outputDir = "content/docs";

var options = new ConvertOptions
{
    IncludeFrontMatter = true,
    HeadingLevelOffset = 1,
    ImageExportStrategy = new SkipImagesStrategy() // or file system
};

foreach (string file in Directory.GetFiles(inputDir))
{
    string ext = Path.GetExtension(file).ToLower();
    if (ext is ".docx" or ".pdf" or ".xlsx" or ".epub")
    {
        try
        {
            string outputPath = Path.Combine(
                outputDir,
                Path.GetFileNameWithoutExtension(file) + ".md");

            MarkdownConverter.ToFile(file, outputPath, options);
            Console.WriteLine($"Converted: {Path.GetFileName(file)}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Skipped: {Path.GetFileName(file)} — {ex.Message}");
        }
    }
}
```
{{< /tab >}}
{{< tab "ssg-batch-hugo.zip" >}}  
```text
content/docs/business-plan.md (7 KB)
content/docs/cost-analysis.md (9 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/use-cases/static-site-generator/SsgBatchHugo/ssg-batch-hugo.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Generate content for static sites

Path: /markdown/python-net/static-site-generator/


Static site generators like Jekyll, Hugo, and Docusaurus expect Markdown files with YAML front matter. GroupDocs.Markdown can automatically generate front matter from document metadata.

### Convert with front matter and relative images

{{< tabs "static-site-convert">}}
{{< tab "static_site_convert.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy

def static_site_convert():
    """Convert a DOCX to Markdown with front matter and relative images for static sites."""

    # Step 1: Configure image export with relative paths
    strategy = ExportImagesToFileSystemStrategy("content/posts/images")
    strategy.images_relative_path = "images"

    # Step 2: Set conversion options for static site generators
    options = ConvertOptions()
    options.include_front_matter = True       # add YAML metadata block
    options.heading_level_offset = 1          # reserve H1 for the page title
    options.image_export_strategy = strategy

    # Step 3: Convert and save using keyword argument for options
    MarkdownConverter.to_file(
        "annual-report.docx", "content/posts/annual-report.md",
        convert_options=options)

    # Output file starts with:
    # ---
    # title: "Annual Report 2025"
    # author: "Finance Team"
    # format: Docx
    # pages: 24
    # ---
    #
    # ## Executive Summary
    # ...

if __name__ == "__main__":
    import os
    os.makedirs("content/posts/images", exist_ok=True)
    static_site_convert()
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/use-cases/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "static-site-convert.zip" >}}  
```text
content/posts/annual-report.txt (941 bytes)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/static-site-generator/static_site_convert/static-site-convert.zip)
{{< /tab >}}
{{< tab "static-site-convert.zip" >}}  
```text
content/posts/annual-report.txt (477 bytes)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/static-site-generator/static_site_convert/static-site-convert.zip)
{{< /tab >}}
{{< /tabs >}}

### Batch-convert a folder for Hugo

{{< tabs "batch-convert-for-hugo">}}
{{< tab "batch_convert_for_hugo.py" >}}  
```python
import os
from groupdocs.markdown import MarkdownConverter, ConvertOptions, SkipImagesStrategy

def batch_convert_for_hugo():
    """Batch-convert all documents in a folder to Markdown with YAML front matter for Hugo/Jekyll."""

    # Step 1: Define source and output directories
    input_dir = "documents"
    output_dir = "content/posts"
    os.makedirs(output_dir, exist_ok=True)

    # Step 2: Configure conversion for static site generators
    options = ConvertOptions()
    options.include_front_matter = True          # add YAML metadata block
    options.heading_level_offset = 1             # reserve H1 for Hugo page title
    options.image_export_strategy = SkipImagesStrategy()  # text-only content

    # Step 3: Iterate over all files in the source folder
    for filename in os.listdir(input_dir):
        file_path = os.path.join(input_dir, filename)

        # Skip directories
        if not os.path.isfile(file_path):
            continue

        # Build output path with .md extension
        output_path = os.path.join(
            output_dir,
            os.path.splitext(filename)[0] + ".md")

        try:
            # Step 4: Convert each file with front matter and heading offset
            MarkdownConverter.to_file(file_path, output_path, convert_options=options)
            print(f"  OK: {filename} -> {output_path}")
        except Exception as ex:
            print(f"  SKIP: {filename} - {ex}")

if __name__ == "__main__":
    batch_convert_for_hugo()
```
{{< /tab >}}
{{< tab "batch-convert-hugo.zip" >}}  
```text
content/posts/business-plan.txt (33 KB)
content/posts/cost-analysis.txt (1 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/static-site-generator/batch_convert_for_hugo/batch-convert-hugo.zip)
{{< /tab >}}
{{< tab "batch-convert-hugo.zip" >}}  
```text
content/posts/business-plan.txt (32 KB)
content/posts/cost-analysis.txt (1 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/static-site-generator/batch_convert_for_hugo/batch-convert-hugo.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Generate email report with common list.

Path: /assembly/python-net/email-reports/


## Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**Template Syntax**

```python
assembler = ga.DocumentAssembler()
dataSource = ga.data.JsonDataSource("datasource.json")
DataSourceInfo = ga.DataSourceInfo(dataSource, "customers")
array = [DataSourceInfo, ga.DataSourceInfo(["test@test.mail", "groupdocs@groupdocs.mail"], "recipients"), ga.DataSourceInfo("sender@sender.mail", "sender"), ga.DataSourceInfo("cc@example.com", "cc"), ga.DataSourceInfo("groupdocs", "subject")]
print(assembler.assemble_document("input.msg", "output.msg", array))
```

## The Recipe

*   Set up the source document data path
*   Set up the source document template path
*   Set up destination report path
*   Instantiate [DocumentAssembler](https://reference.groupdocs.com/python-net/assembly/groupdocs.assembly/documentassembler) class
*   Generate report

## More resources

### Advanced usage topics

To learn more about library features, please refer to the[advanced usage section]({{< ref "assembly/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Assembly for .NET examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
    
*   [GroupDocs.Assembly for Java examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)

*   [GroupDocs.Assembly for Python via .NET examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

---

## Generate Your First Document from .NET Object

Path: /assembly/net/basic-usage-first-document/


## Overview

This guide walks you through creating your first document with GroupDocs.Assembly for .NET. You'll generate a simple document from an in-memory .NET object, demonstrating the basic workflow of template-based document assembly.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - the main class for assembling documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data source objects with optional names

Here are the steps to generate your first document:

* Create a simple .NET class with properties to represent your data
* Instantiate the class and populate it with sample data
* Create a template document (DOCX) with expression tags referencing the object properties
* Use DocumentAssembler to assemble the template with your data object
* Save the assembled document to a file

## Define a Simple Data Class

First, create a simple class to hold your data:

```csharp
public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
    public string Email { get; set; }
}
```

## Generate Document from Object

Now, create a method to generate a document from this object:

```csharp
using GroupDocs.Assembly;
using System;

public static void GenerateFirstDocument()
{
    // Create sample data
    Person person = new Person
    {
        Name = "John Doe",
        Age = 30,
        Email = "john.doe@example.com"
    };
    
    // Paths for template and output
    string templatePath = "Template.docx";
    string outputPath = "Output.docx";
    
    // Assemble the document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(person, "person"));
    
    Console.WriteLine($"Document generated successfully: {outputPath}");
}
```

## Template Document Example

Your template document (Template.docx) should contain expression tags like this:

```
Name: <<[person.Name]>>
Age: <<[person.Age]>>
Email: <<[person.Email]>>
```

After assembly, the output will be:

```
Name: John Doe
Age: 30
Email: john.doe@example.com
```

## Using Contextual Object Member Access

You can also use contextual member access, which allows you to omit the data source name in simple scenarios:

```csharp
public static void GenerateDocumentWithContextualAccess()
{
    Person person = new Person
    {
        Name = "Jane Smith",
        Age = 28,
        Email = "jane.smith@example.com"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    // When using contextual access, you can omit the data source name
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(person));
}
```

With contextual access, your template can use:

```
Name: <<[Name]>>
Age: <<[Age]>>
Email: <<[Email]>>
```

{{< alert style="info" >}}
When using contextual object member access, the template expressions can reference properties directly without the data source name prefix. This is useful for simple, single-object scenarios.
{{< /alert >}}

### Advanced Usage Topics

To learn more about working with complex data structures, multiple data sources, and advanced template syntax, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Generating Report using Multiple Data Sources in Spreadsheet Document

Path: /assembly/java/generating-report-using-multiple-data-sources-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a report. This report will fetch data from multiple data sources.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Generating Report in Microsoft Excel Document

### Creating a Template

1.  Add a bullet list at the place where you want it to display clients' names.
2.  Insert a table with two columns, that will show managers' and their contact prices.
3.  Save your Document

### Reporting Requirement

As a report developer, you are required to generate a report that fetches data from two different data sources (e:g custom object, excel data table). Report must show following information:

*   Bulleted list of clients
*   A table showing managers' along with their contract prices and sum of contract prices

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**In-cell list**

We provide support for the following clients:
```
<<foreach [in getClients()]>>
-          <<[getName()]>><</foreach>>
```

**Multiple-cell list**

We provide support for the following clients:

```
<<foreach [in getClients()]>>
-          <<[getName()]>> 
```

| Total Contract Prices by Managers                            |                                                              |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| <<foreach [group in contracts<br />     .groupBy(c => c.Manager)<br />     .orderBy(g => g.key)]>><br /><<[group.key]>> | <<[group.sum(<br />     c => c.Contract_Price)]>><br /><</foreach>> |

### Download Template

Get the template from here.

*   [Multiple DS.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Multiple%20DS.xlsx?raw=true)

### Generating the ReportGenerating Report using Custom Objects and Excel Data Source

{{< gist GroupDocsGists b758da2fedf86e75aefafe122a297cad >}}



---

## Generating Report using Multiple Data Sources in Spreadsheet Document

Path: /assembly/net/generating-report-using-multiple-data-sources-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a report. This report will fetch data from multiple data sources.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Generating Report in Microsoft Excel Document

### Creating a Template

1.  Insert a desired shape to display image in it.
2.  Go to Insert Tab and select shape by clicking on Shape Icon.
3.  Add a bullet list at the place where you want it
4.  Save your Document

### Reporting Requirement

As a report developer, you are required to generate a report that fetches data from two different data sources (e:g XML, JSON). Report must show following information:

*   Customer name and picture
*   List of products

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td colspan="3">&lt;&lt;foreach [in customers]>></td>
			<td></td>
			<td></td>
		</tr>
		<tr style="vertical-align: top">
			<td colspan="3" rowspan="8">&lt;&lt;image[customer.Photo]>></td>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td></td>
			<td></td>
		</tr>
		<tr>
			<td colspan="3">&lt;&lt;[CustomerName]>></td>
			<td colspan="2">&lt;&lt;/foreach>></td>
		</tr>
	</tbody>
</table>

**In-Cell List**

```csharp
We provide support for the following products:
<<foreach [in products]>>
-          <<[ProductName]>><</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Get template from here.

*   [Multiple DS.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Multiple%20DS.xlsx?raw=true)

### Generating the Report

{{< gist atirtahirgroupdocs 912c6398a7f6639c57447241b674a5ff >}}

## Generating Report in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating a report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

Get template from here.

*   [Multiple DS.ods](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Multiple%20DS.ods?raw=true)

### Generating the Report

{{< gist GroupDocsGists 9a11804cc2ada59aa5e84776c5dbb2c5 >}}



---

## Generating worksheets (tabs) preview for spreadsheet

Path: /editor/java/generating-worksheets-preview-for-spreadsheet/

Starting from [version 23.9](https://releases.groupdocs.com/editor/java/release-notes/2023/groupdocs-editor-for-java-23-9-release-notes/), the GroupDocs.Editor for Java allows to generate a preview for any worksheet (a.k.a. _tab_) in the spreadsheet (a.k.a. _workbook_) document in SVG format. With this feature the end-users are able to view and inspect the content of the spreadsheet without actually sending it for edit. This generated worksheet preview cannot be edited using the GroupDocs.Editor for Java itself, but it can be saved and then viewed in any desktop or online image viewer as well in the browser (because any modern browser actually supports viewing of SVG format).

This feature is working regardless of the licensing mode of the GroupDocs.Editor for Java: it works the same for both trial and licensed mode, there are no trial limitations for this feature. While generating the worksheets preview, the GroupDocs.Editor doesn’t write off the consumed bytes or credits.

Excel spreadsheets may have the so-called _hidden worksheets_, — GroupDocs.Editor for Java generates an SVG preview for them too.

For generating the worksheets preview for a particular spreadsheet document the user must perform the next steps:

- Load a desired spreadsheet file to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class.
- Call the [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method and specify a password of a loaded spreadsheet in case if this spreadsheet is protected with a password.
- In the obtained struct [`com.groupdocs.editor.metadata.SpreadsheetDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/spreadsheetdocumentinfo/) invoke a new instance method [`generatePreview(int worksheetIndex)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/spreadsheetdocumentinfo/#generatePreview-int-) and in this method specify a zero-based _index_ (do not confuse with the worksheet _numbers_, which are 1-based) of the desired worksheet. If the specified index is lesser than 0 or exceeds the number of worksheets within a given spreadsheet, then the [IllegalArgumentException](https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html) exception will be thrown.
- The [`generatePreview(int worksheetIndex)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/spreadsheetdocumentinfo/#generatePreview-int-) method returns a worksheet preview as an SVG vector image, that is encapsulated in the [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) public class from the [`com.groupdocs.editor.htmlcss.resources.images.vector`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/) namespace. This class has all necessary methods and properties to obtain the content of an SVG image in any desired form, save it to disk, stream and so on.

The code sample below shows opening an unprotected spreadsheet file, obtaining a number of all worksheets inside this spreadsheet, and then generating the previews for every worksheet in a loop. Then these previews are saved to the disk.

```java
// Obtain a valid full path to the spreadsheet file
String inputPath = "Sample.xlsx";

// Load spreadsheet file to the Editor constructor
Editor editor = new Editor(inputPath);
{
	// Get document info for this file
	IDocumentInfo infoUncasted = editor.getDocumentInfo(null);

	//Make sure it is really a Spreadsheet of XLSX format
	Assert.assertEquals(SpreadsheetFormats.Xlsx, infoUncasted.getFormat());

	// Cast this document info to the SpreadsheetDocumentInfo type
	SpreadsheetDocumentInfo infoSpreadsheet = (SpreadsheetDocumentInfo)infoUncasted;

	// Get the number of all worksheets
	int worksheetsCount = infoSpreadsheet.getPageCount();

	//Iterate through all worksheets and generate the preview on every iteration
	for (int worksheetIndex = 0; worksheetIndex < worksheetsCount; worksheetIndex++)
	{
		// Generate one preview as SVG image by worksheet index
		SvgImage oneSvgPreview = infoSpreadsheet.generatePreview(worksheetIndex);

		// Save SVG preview to the file
		oneSvgPreview.save("Sample_out_image"+worksheetIndex+"."+ oneSvgPreview.getFilenameWithExtension()));
	}
}
```

Concluding, the new worksheets preview feature is by its essence a new public method in the existing [`com.groupdocs.editor.metadata.SpreadsheetDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/spreadsheetdocumentinfo/) struct, that obtains a worksheet index and returns an instance of [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class. If the end-user needs to obtain a preview of the worksheet in a raster format, but not in the vector, he can use the [`saveToPng`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/#saveToPng-java.io.InputStream-) method in the [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class — this method converts the SVG content of the current [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) to the PNG format and saves it to the specified [`OutputStream`](https://docs.oracle.com/javase/8/docs/api/java/io/OutputStream.html).
---

## Generating worksheets (tabs) preview for spreadsheet

Path: /editor/net/generating-worksheets-preview-for-spreadsheet/

Starting from [version 23.4](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-4-release-notes/), the GroupDocs.Editor for .NET allows to generate a preview for any worksheet (a.k.a. _tab_) in the spreadsheet (a.k.a. _workbook_) document in SVG format. With this feature the end-users are able to view and inspect the content of the spreadsheet without actually sending it for edit. This generated worksheet preview cannot be edited using the GroupDocs.Editor for .NET itself, but it can be saved and then viewed in any desktop or online image viewer as well in the browser (because any modern browser actually supports viewing of SVG format).

This feature is working regardless of the licensing mode of the GroupDocs.Editor for .NET: it works the same for both trial and licensed mode, there are no trial limitations for this feature. While generating the worksheets preview, the GroupDocs.Editor doesn’t write off the consumed bytes or credits.

Excel spreadsheets may have the so-called _hidden worksheets_, — GroupDocs.Editor for .NET generates an SVG preview for them too.

For generating the worksheets preview for a particular spreadsheet document the user must perform the next steps:

- Load a desired spreadsheet file to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/) class.
- Call the [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo/) method and specify a password of a loaded spreadsheet in case if this spreadsheet is protected with a password.
- In the obtained struct [`GroupDocs.Editor.Metadata.SpreadsheetDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/spreadsheetdocumentinfo/) invoke a new instance method [`GeneratePreview(int worksheetIndex)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/spreadsheetdocumentinfo/generatepreview/) and in this method specify a zero-based _index_ (do not confuse with the worksheet _numbers_, which are 1-based) of the desired worksheet. If the specified index is lesser than 0 or exceeds the number of worksheets within a given spreadsheet, then the [System.ArgumentOutOfRangeException](https://learn.microsoft.com/en-us/dotnet/api/system.ArgumentOutOfRangeException?view=net-7.0) exception will be thrown.
- The [`GeneratePreview(int worksheetIndex)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/spreadsheetdocumentinfo/generatepreview/) method returns a worksheet preview as an SVG vector image, that is encapsulated in the [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) public class from the [`GroupDocs.Editor.HtmlCss.Resources.Images.Vector`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/) namespace. This class has all necessary methods and properties to obtain the content of an SVG image in any desired form, save it to disk, stream and so on.

The code sample below shows opening an unprotected spreadsheet file, obtaining a number of all worksheets inside this spreadsheet, and then generating the previews for every worksheet in a loop. Then these previews are saved to the disk.

```csharp
// Obtain a valid full path to the spreadsheet file
string inputPath = "Sample.xlsx";

// Load spreadsheet file to the Editor constructor
using (GroupDocs.Editor.Editor editor = new Editor(inputPath))
{
	// Get document info for this file
	IDocumentInfo infoUncasted = editor.GetDocumentInfo(null);

	//Make sure it is really a Spreadsheet of XLSX format
	Assert.AreEqual(Formats.SpreadsheetFormats.Xlsx, infoUncasted.Format);

	// Cast this document info to the SpreadsheetDocumentInfo type
	SpreadsheetDocumentInfo infoSpreadsheet = (SpreadsheetDocumentInfo)infoUncasted;

	// Get the number of all worksheets
	int worksheetsCount = infoSpreadsheet.PageCount;

	//Iterate through all worksheets and generate the preview on every iteration
	for (int worksheetIndex = 0; worksheetIndex < worksheetsCount; worksheetIndex++)
	{
		// Generate one preview as SVG image by worksheet index
		SvgImage oneSvgPreview = infoSpreadsheet.GeneratePreview(worksheetIndex);

		// Save SVG preview to the file
		oneSvgPreview.Save(Path.Combine(outputFolder, oneSvgPreview.FilenameWithExtension));
	}
}
```

Concluding, the new worksheets preview feature is by its essence a new public method in the existing [`GroupDocs.Editor.Metadata.SpreadsheetDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/spreadsheetdocumentinfo/) struct, that obtains a worksheet index and returns an instance of [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class. If the end-user needs to obtain a preview of the worksheet in a raster format, but not in the vector, he can use the [`SaveToPng`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/savetopng/) method in the [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class — this method converts the SVG content of the current [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) to the PNG format and saves it to the specified [`System.IO.Stream`](https://learn.microsoft.com/en-us/dotnet/api/system.IO.Stream?view=net-6.0).
---

## Generating worksheets (tabs) preview for spreadsheet in Node.js

Path: /editor/nodejs-java/generating-worksheets-preview-for-spreadsheet/



Starting from **[version 23.10](https://releases.groupdocs.com/editor/java/release-notes/2023/groupdocs-editor-for-java-23-10-release-notes/)**, GroupDocs.Editor for Node.js allows generating previews of any worksheet (also known as _tab_) within a spreadsheet document in SVG format. This feature enables users to view the content of the spreadsheet without editing it. The generated worksheet preview is non-editable using GroupDocs.Editor, but can be saved and viewed in any SVG-supporting software, such as browsers or desktop viewers.

This feature works in both trial and licensed modes without restrictions and doesn't consume credits or bytes during generation. GroupDocs.Editor also supports generating SVG previews for hidden worksheets.

To generate worksheet previews for a spreadsheet in GroupDocs.Editor for Node.js, follow these steps:

- Load the spreadsheet file into the `Editor` class.
- Call the `getDocumentInfo()` method and provide a password if the spreadsheet is protected.
- Use the returned `SpreadsheetDocumentInfo` object and invoke the `generatePreview(worksheetIndex)` method by specifying the zero-based index of the worksheet. If the index is out of range, an error will be thrown.
- The `generatePreview(worksheetIndex)` method returns a worksheet preview as an SVG image encapsulated in the `SvgImage` class. This class provides methods to retrieve the SVG content, save it to disk, or stream it.

The following code demonstrates how to load an unprotected spreadsheet, get the number of worksheets, generate previews for all worksheets, and save these previews to disk.

```javascript
// Import GroupDocs.Editor classes
const groupdocs = require('groupdocs-editor');
const Editor = groupdocs.Editor;

// Define the path to the input spreadsheet
const inputPath = 'Sample.xlsx';

// Load the spreadsheet file into the Editor constructor
const editor = new Editor(inputPath, new SpreadsheetLoadOptions());

// Get document info for the spreadsheet
const documentInfo = editor.getDocumentInfo();

// Ensure the document is in XLSX format
if (documentInfo.format !== groupdocs.formats.SpreadsheetFormats.Xlsx) {
    throw new Error('Unsupported format, please use an XLSX file.');
}

// Cast the document info to SpreadsheetDocumentInfo
const spreadsheetInfo = documentInfo.asSpreadsheetDocumentInfo();

// Get the total number of worksheets
const worksheetCount = spreadsheetInfo.getPageCount();

// Loop through all worksheets and generate previews
for (let worksheetIndex = 0; worksheetIndex < worksheetCount; worksheetIndex++) {
    // Generate an SVG preview for the current worksheet
    const svgPreview = spreadsheetInfo.generatePreview(worksheetIndex);

    // Save the SVG preview to disk
    svgPreview.save(`Sample_out_image_${worksheetIndex}.svg`);
}
```

## Additional Details

The worksheet preview feature is provided through a new public method in the `SpreadsheetDocumentInfo` class. This method, `generatePreview(worksheetIndex)`, takes the worksheet index and returns an `SvgImage` object containing the SVG representation of the worksheet.

If the user prefers a raster format (such as PNG) instead of the SVG vector format, the `SvgImage` class offers the `saveToPng()` method, which converts the SVG content into a PNG image.

Example for saving a worksheet preview as a PNG:

```javascript
// Save the SVG preview as PNG
svgPreview.saveToPng(`Sample_out_image_${worksheetIndex}.png`);
```

This feature makes it easy to generate worksheet previews for inspection and display purposes without requiring any changes to the actual spreadsheet content.
---

## Get document info

Path: /conversion/net/get-document-info/

GroupDocs.Conversion provides a standard way of obtaining information about the source document. It works regardless of how the document was loaded: from a disk, a stream, or cloud storage.

To get document information, use the [Converter.GetDocumentInfo()](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/getdocumentinfo/) method. It returns a [DocumentInfo](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/documentinfo/) object with common information common for every supported document - format, creation date, size, and page count. 

To iterate through the document information properties, use the `PropertyNames` and `Item` enumerators. The following code snippet shows how to list all the available document information properties:

```csharp
using (Converter converter = new Converter("sample.txt"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    
    foreach (var propertyName in info.PropertyNames)
    {
        Console.WriteLine(propertyName + ": "+ info[propertyName]);
    }
}
```
Depending on the format type, the resulting `DocumentInfo` object also contains some additional information:

* [PDF documents](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/pdfdocumentinfo/) - title, table of contents, author, whether it is encrypted and so on;
* [Wordprocessing documents](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/wordprocessingdocumentinfo/) - title, table of contents, author, lines count, words count, whether it is password protected and so on;
* [Project management documents](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/projectmanagementdocumentinfo/) - project start and end dates, number of tasks;
* [Images](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/imagedocumentinfo/) - width, height, bits per pixel;
* [Presentations](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/presentationdocumentinfo/) - title, author, whether it is password protected;
* [Spreadsheets](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/spreadsheetdocumentinfo/) - title, author, worksheets count, whether it is password protected;
* [CAD drawings](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/caddocumentinfo/) - width, height, collections of layouts and layers;
* [Emails](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/emaildocumentinfo/) - number and names of attachments, whether it is encrypted, whether it is signed, whether its body is in HTML format;

See the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/) for a complete list of format-specific document metadata.

The samples below show how to obtain document info for various formats.

### PDF documents

```csharp
using (Converter converter = new Converter("sample-toc.pdf"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    PdfDocumentInfo docInfo = (PdfDocumentInfo) info;

    Console.WriteLine("Author: {0}", docInfo.Author);
    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Title: {0}", docInfo.Title);
    Console.WriteLine("Version: {0}", docInfo.Version);
    Console.WriteLine("Pages count: {0}", docInfo.PagesCount);
    Console.WriteLine("Width: {0}", docInfo.Width);
    Console.WriteLine("Height: {0}", docInfo.Height);
    Console.WriteLine("Is landscaped: {0}", docInfo.IsLandscape);
    Console.WriteLine("Is Encrypted: {0}", docInfo.IsEncrypted);
    foreach (var tocItem in docInfo.TableOfContents)
    {
        Console.WriteLine($"{tocItem.Title}: {tocItem.Page}");
    }
}
```

### Wordprocessing documents

```csharp
using (Converter converter = new Converter("sample.doc"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    WordProcessingDocumentInfo docInfo = (WordProcessingDocumentInfo) info;

    Console.WriteLine("Author: {0}", docInfo.Author);
    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Format: {0}", docInfo.Format);
    Console.WriteLine("Is Password Protected: {0}", docInfo.IsPasswordProtected);
    Console.WriteLine("Lines: {0}", docInfo.Lines);
    Console.WriteLine("Pages count: {0}", docInfo.PagesCount);
    Console.WriteLine("Size: {0}", docInfo.Size);
    Console.WriteLine("Title: {0}", docInfo.Title);               
    Console.WriteLine("Words: {0}", docInfo.Words);
    foreach (var tocItem in docInfo.TableOfContents)
    {
        Console.WriteLine($"{tocItem.Title}: {tocItem.Page}");
    }
}
```

### Project management documents

```csharp
using (Converter converter = new Converter("foobar.mpp"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    ProjectManagementDocumentInfo docInfo = (ProjectManagementDocumentInfo) info;

    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Start date: {0}", docInfo.StartDate);
    Console.WriteLine("End date: {0}", docInfo.EndDate);
    Console.WriteLine("Format: {0}", docInfo.Format);
    Console.WriteLine("Size: {0}", docInfo.Size);
    Console.WriteLine("Tasks count: {0}", docInfo.TasksCount);        
}
```

### Images

```csharp
using (Converter converter = new Converter("image.png"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    ImageDocumentInfo docInfo = (ImageDocumentInfo) info;

    Console.WriteLine("Bits per pixel: {0}", docInfo.BitsPerPixel);
    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Format: {0}", docInfo.Format);
    Console.WriteLine("Height: {0}", docInfo.Height);
    Console.WriteLine("Width: {0}", docInfo.Width);    
    Console.WriteLine("Size: {0}", docInfo.Size);
}
```

### Presentations

```csharp
using (Converter converter = new Converter("presentation.ppt"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    PresentationDocumentInfo docInfo = (PresentationDocumentInfo) info;

    Console.WriteLine("Author: {0}", docInfo.Author);
    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Format: {0}", docInfo.Format);
    Console.WriteLine("Is Password Protected: {0}", docInfo.IsPasswordProtected);    
    Console.WriteLine("Pages count: {0}", docInfo.PagesCount);
    Console.WriteLine("Size: {0}", docInfo.Size);
    Console.WriteLine("Title: {0}", docInfo.Title);               
}
```

### Spreadsheets

```csharp
using (Converter converter = new Converter("table.xlsx"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    SpreadsheetDocumentInfo docInfo = (SpreadsheetDocumentInfo) info;

    Console.WriteLine("Author: {0}", docInfo.Author);
    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Format: {0}", docInfo.Format);
    Console.WriteLine("Is Password Protected: {0}", docInfo.IsPasswordProtected);    
    Console.WriteLine("Pages count: {0}", docInfo.PagesCount);
    Console.WriteLine("Size: {0}", docInfo.Size);
    Console.WriteLine("Title: {0}", docInfo.Title);
    Console.WriteLine("Worksheets Count : {0}", docInfo.WorksheetsCount);
}
```
### CAD drawings

```csharp
using (Converter converter = new Converter("sample.dwg"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    CadDocumentInfo docInfo = (CadDocumentInfo) info;

    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Format: {0}", docInfo.Format);
    Console.WriteLine("Height: {0}", docInfo.Height);
    Console.WriteLine("Width: {0}", docInfo.Width);
    Console.WriteLine("Size: {0}", docInfo.Size);
    
    foreach (var layout in docInfo.Layouts)
    {
        Console.WriteLine($"Layout: {layout}");
    }

    foreach (var layer in docInfo.Layers)
    {
        Console.WriteLine($"Layer: {layer}");
    }
}
```

### Emails

```csharp
using (Converter converter = new Converter("sample.msg"))
{
    IDocumentInfo info = converter.GetDocumentInfo();
    EmailDocumentInfo docInfo = (EmailDocumentInfo) info;

    Console.WriteLine("Creation date: {0}", docInfo.CreationDate);
    Console.WriteLine("Format: {0}", docInfo.Format);
    Console.WriteLine("Is Encrypted: {0}", docInfo.IsEncrypted);
    Console.WriteLine("Is body in HTML: {0}", docInfo.IsHtml);
    Console.WriteLine("Is Signed: {0}", docInfo.IsSigned);
    Console.WriteLine("Size: {0}", docInfo.Size);
    Console.WriteLine("Attachments Count: {0}", docInfo.AttachmentsCount);
    foreach (var attachmentName in docInfo.AttachmentsNames)
    {
        Console.WriteLine($"Attachment Name: {attachmentName}");
    }

}
```
---

## Get document info

Path: /conversion/nodejs-java/get-document-info/

GroupDocs.Conversion provides a standard way of obtaining information about the source document. It works regardless of how the document was loaded: from a disk, a stream, or cloud storage.

To get document information, use the [Converter.getDocumentInfo()](#) method. It returns a [DocumentInfo](#) object with common information common for every supported document - format, creation date, size, and page count. 

To iterate through the document information properties, use the [getPropertyNames()](#) and [getProperty()](#) methods. The following code snippet shows how to list all the available document information properties:

```js
const converter = new groupdocs.conversion.Converter("sample.txt");
const info = converter.getDocumentInfo();
const props = info.getPropertyNames();
props.spliterator().getExactSizeIfKnown();
for (let i = 0; i < props.size(); i++) {
  const propertyName = props.get(i);
  console.log(`Property name: ${propertyName}. Value: ${info.getProperty(propertyName)}`);
}
```
Depending on the format type, the resulting `DocumentInfo` object also contains some additional information:

* [PDF documents](#) - title, table of contents, author, whether it is encrypted and so on;
* [Project management documents](#) - project start and end dates, number of tasks;
* [Images](#) - width, height, bits per pixel;
* [Presentations](#) - title, author, whether it is password protected;
* [Spreadsheets](#) - title, author, worksheets count, whether it is password protected;
* [CAD drawings](#) - width, height, collections of layouts and layers;
* [Emails](#) - number and names of attachments, whether it is encrypted, whether it is signed, whether its body is in HTML format;

See the [API reference](#) for a complete list of format-specific document metadata.

The samples below show how to obtain document info for various formats.

### PDF documents

```js
const converter = new groupdocs.conversion.Converter("sample-toc.pdf");
const pdfInfo = converter.getDocumentInfo();

console.log("Author: " + pdfInfo.getAuthor());
console.log("Creation date: " + pdfInfo.getCreationDate());
console.log("Title: " + pdfInfo.getTitle());
console.log("Version: " + pdfInfo.getVersion());
console.log("Pages count: " + pdfInfo.getPagesCount());
console.log("Width: " + pdfInfo.getWidth());
console.log("Height: " + pdfInfo.getHeight());
console.log("Is landscaped: " + pdfInfo.getIsLandscape());
console.log("Is Encrypted: " + pdfInfo.getIsEncrypted());

const pdfTOC = pdfInfo.getTableOfContents();
pdfTOC.spliterator().getExactSizeIfKnown();
for(let i = 0; i < pdfTOC.size(); i++) {
    const tocItem = pdfTOC.get(i);
    console.log(tocItem.getTitle() + " : " + tocItem.getPage());
}
```

### Project management documents

```js
const converter = new groupdocs.conversion.Converter("foobar.mpp");
const docInfo = converter.getDocumentInfo();

console.log("Creation date: " + docInfo.getCreationDate());
console.log("Start date: " + docInfo.getStartDate());
console.log("End date: " + docInfo.getEndDate());
console.log("Format: " + docInfo.getFormat());
console.log("Size: " + docInfo.getSize());
console.log("Tasks count: " + docInfo.getTasksCount());        
```

### Images

```js
const converter = new groupdocs.conversion.Converter("image.png");
const docInfo = converter.getDocumentInfo();

console.log("Bits per pixel: " + docInfo.getBitsPerPixel());
console.log("Creation date: " + docInfo.getCreationDate());
console.log("Format: " + docInfo.getFormat());
console.log("Height: " + docInfo.getHeight());
console.log("Width: " + docInfo.getWidth());    
console.log("Size: " + docInfo.getSize());
```

### Presentations

```js
const converter = new groupdocs.conversion.Converter("presentation.ppt");
const docInfo = converter.getDocumentInfo();

console.log("Author: " + docInfo.getAuthor());
console.log("Creation date: " + docInfo.getCreationDate());
console.log("Format: " + docInfo.getFormat());
console.log("Is Password Protected: " + docInfo.isPasswordProtected());    
console.log("Pages count: " + docInfo.getPagesCount());
console.log("Size: " + docInfo.getSize());
console.log("Title: " + docInfo.getTitle());               
```

### Spreadsheets

```js
const converter = new groupdocs.conversion.Converter("table.xlsx");
const docInfo = converter.getDocumentInfo();

console.log("Author: " + docInfo.getAuthor());
console.log("Creation date: " + docInfo.getCreationDate());
console.log("Format: " + docInfo.getFormat());
console.log("Is Password Protected: " + docInfo.isPasswordProtected());    
console.log("Pages count: " + docInfo.getPagesCount());
console.log("Size: " + docInfo.getSize());
console.log("Title: " + docInfo.getTitle());
console.log("Worksheets Count : " + docInfo.getWorksheetsCount());
```
### CAD drawings

```js
const converter = new groupdocs.conversion.Converter("sample.dwg");
const docInfo = converter.getDocumentInfo();

console.log("Creation date: " + docInfo.getCreationDate());
console.log("Format: " + docInfo.getFormat());
console.log("Height: " + docInfo.getHeight());
console.log("Width: " + docInfo.getWidth());
console.log("Size: " + docInfo.getSize());


const layouts = docInfo.getLayouts();
layouts.spliterator().getExactSizeIfKnown();
for(let i = 0; i < layouts.size(); i++) {
    const layout = layouts.get(i);
    console.log("Layout: " + layout);
}

const layers = docInfo.getLayers();
layers.spliterator().getExactSizeIfKnown();
for(let i = 0; i < layers.size(); i++) {
    const layer = layers.get(i);
    console.log("Layer: " + layer);
}
```

### Emails

```js
const converter = new groupdocs.conversion.Converter("sample.msg");
const docInfo = converter.getDocumentInfo();

console.log("Creation date: " + docInfo.getCreationDate());
console.log("Format: " + docInfo.getFormat());
console.log("Is Encrypted: " + docInfo.isEncrypted());
console.log("Is body in HTML: " + docInfo.isHtml());
console.log("Is Signed: " + docInfo.isSigned());
console.log("Size: " + docInfo.getSize());
console.log("Attachments Count: " + docInfo.getAttachmentsCount());

const attachments = docInfo.getAttachmentsNames();
attachments.spliterator().getExactSizeIfKnown();
for(let i = 0; i < attachments.size(); i++) {
    const attchName = attachments.get(i);
    console.log("Attachment Name: " + attchName);
}
```

---

## Get document info

Path: /markdown/net/get-document-info/


Use `GetDocumentInfo()` or the static `GetInfo()` method to retrieve document metadata without performing a full conversion. This is useful for building file browsers, validation pipelines, and pre-conversion UIs.

### Using static method

{{< tabs "get-info-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

DocumentInfo info = MarkdownConverter.GetInfo("business-plan.docx");

Console.WriteLine($"Format:    {info.FileFormat}");    // Docx
Console.WriteLine($"Pages:     {info.PageCount}");     // 42
Console.WriteLine($"Title:     {info.Title}");         // "Q3 Report"
Console.WriteLine($"Author:    {info.Author}");        // "Jane Doe"
Console.WriteLine($"Encrypted: {info.IsEncrypted}");   // false
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "get-info-static.txt" >}}  
```text
Format:    Docx
Pages:     5
Title:     Meridian Outdoor Co. - Business Plan
Author:    Meridian Outdoor Co.
Encrypted: False
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/get-document-info/GetInfoStatic/get-info-static.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance method

{{< tabs "get-info-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

using var converter = new MarkdownConverter("cost-analysis.xlsx");
DocumentInfo info = converter.GetDocumentInfo();

Console.WriteLine($"Format:    {info.FileFormat}");
Console.WriteLine($"Pages:     {info.PageCount}");
Console.WriteLine($"Title:     {info.Title}");
Console.WriteLine($"Author:    {info.Author}");
Console.WriteLine($"Encrypted: {info.IsEncrypted}");
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "get-info-instance.txt" >}}  
```text
Format:    Xlsx
Pages:     4
Title:     
Author:    
Encrypted: False
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/get-document-info/GetInfoInstance/get-info-instance.txt)
{{< /tab >}}
{{< /tabs >}}

### DocumentInfo properties

| Property | Type | Description |
|---|---|---|
| `FileFormat` | `FileFormat` | Detected file format (e.g., `FileFormat.Docx`) |
| `PageCount` | `int` | Number of pages or worksheets |
| `Title` | `string` | Document title from metadata |
| `Author` | `string` | Document author from metadata |
| `IsEncrypted` | `bool` | Whether the document is password-protected |

---

## Get document info

Path: /markdown/python-net/get-document-info/


Use `get_document_info()` or the static `get_info()` method to retrieve document metadata without performing a full conversion. This is useful for building file browsers, validation pipelines, and pre-conversion UIs.

### Using static method

{{< tabs "get-info-static">}}
{{< tab "get_info_static.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def get_info_static():
    """Retrieve document metadata using the static GetInfo method."""

    # Step 1: Get document info without performing a full conversion
    info = MarkdownConverter.get_info("business-plan.docx")

    # Step 2: Print the metadata fields
    print(f"Format:    {info.file_format}")     # Docx
    print(f"Pages:     {info.page_count}")      # 42
    print(f"Title:     {info.title}")            # "Q3 Report"
    print(f"Author:    {info.author}")           # "Jane Doe"
    print(f"Encrypted: {info.is_encrypted}")     # False

if __name__ == "__main__":
    get_info_static()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "get-info-static.txt" >}}  
```text
Format:    Docx
Pages:     18
Title:     
Author:    
Encrypted: False
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/get-document-info/get_info_static/get-info-static.txt)
{{< /tab >}}
{{< tab "get-info-static.txt" >}}  
```text
Format:    Docx
Pages:     18
Title:     
Author:    
Encrypted: False
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/get-document-info/get_info_static/get-info-static.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance method

{{< tabs "get-info-instance">}}
{{< tab "get_info_instance.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def get_info_instance():
    """Retrieve document metadata using the instance API."""

    # Step 1: Open the spreadsheet with a context manager
    with MarkdownConverter("cost-analysis.xlsx") as converter:
        # Step 2: Retrieve document metadata
        info = converter.get_document_info()

        print(f"Format:     {info.file_format}")
        print(f"Pages:      {info.page_count}")
        print(f"Title:      {info.title}")
        print(f"Author:     {info.author}")
        print(f"Encrypted:  {info.is_encrypted}")

if __name__ == "__main__":
    get_info_instance()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "get-info-instance.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/get-document-info/get_info_instance/get-info-instance.txt)
{{< /tab >}}
{{< tab "get-info-instance.txt" >}}  
```text
Format:     Xlsx
Pages:      1
Title:      Cost Analysis
Author:     GroupDocs
Encrypted:  False
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/get-document-info/get_info_instance/get-info-instance.txt)
{{< /tab >}}
{{< /tabs >}}

### DocumentInfo properties

| Property | Type | Description |
|---|---|---|
| `file_format` | `FileFormat` | Detected file format (e.g., `FileFormat.DOCX`) |
| `page_count` | `int` | Number of pages or worksheets |
| `title` | `str` | Document title from metadata |
| `author` | `str` | Document author from metadata |
| `is_encrypted` | `bool` | Whether the document is password-protected |

---

## Get document info

Path: /parser/java/get-document-info/

GroupDocs.Parser provides the functionality to get the basic document info by the [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method:

```java
IDocumentInfo getDocumentInfo();
```

[IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo) interface has the following members:

| Member | Description |
| --- | --- |
| [getFileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getFileType()) | The document type. |
| [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) | The total number of document pages. |
| [getRawPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getRawPageCount()) | The total number of document raw pages.. |
| [getSize](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getSize()) | The size of the document in bytes. |

Here are the steps to get document info:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and obtain the object with [IDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo "interface in com.groupdocs.parser.options") interface;
*   Call properties such as [getFileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getFileType()), [getPageCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getPageCount()) or [getSize](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/IDocumentInfo#getSize()).

The following example shows how to get document info:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Get the document info
    IDocumentInfo info = parser.getDocumentInfo();
    // Print document information
    System.out.println(String.format("FileType: %s", info.getFileType()));
    System.out.println(String.format("PageCount: %d", info.getPageCount()));
    System.out.println(String.format("Size: %d", info.getSize()));
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Get document info

Path: /parser/net/get-document-info/

GroupDocs.Parser provides the functionality to get the basic document info by the [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method:

```csharp
IDocumentInfo GetDocumentInfo();

```

[IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) interface has the following members:

| Member | Description |
| --- | --- |
| [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/filetype) | The document type. |
| [PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) | The total number of document pages. |
| [Size](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/size) | The size of the document in bytes. |

Here are the steps to get document info:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and obtain the object with [IDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo) interface;
*   Call properties such as [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/filetype), [PageCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/pagecount) or [Size](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/idocumentinfo/properties/size).

The following example shows how to get document info:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Get the document info
    IDocumentInfo info = parser.GetDocumentInfo();
    
    // Print document information
    Console.WriteLine($"File Type: {info.FileType}");
    Console.WriteLine($"Page Count: {info.PageCount}");
    Console.WriteLine($"File Size: {info.Size} bytes");
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Get document info

Path: /parser/python-net/get-document-info/


With [GroupDocs.Parser](https://products.groupdocs.com/parser/python-net) you can retrieve the following information about a document:

*   `file_type` represents the document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation, image etc.)
*   `page_count` represents the number of pages in a document
*   `size` represents the document file size in bytes

The following code samples show how to get document information:

## Get document info from a local file
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.docx") as parser:
    # Get the document info
    doc_info = parser.get_document_info()
    
    # Print document information
    print(f"File type: {doc_info.file_type.file_format}")
    print(f"Page count: {doc_info.page_count}")
    print(f"File size: {doc_info.size} bytes")
    
    # Print file extension
    print(f"File extension: {doc_info.file_type.extension}")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/basic-usage/get-document-info/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get document info from a stream
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Open the file stream
with open("sample.pdf", "rb") as stream:
    # Create an instance of Parser class with the stream
    with Parser(stream) as parser:
        # Get the document info
        doc_info = parser.get_document_info()
        
        # Print document information
        print(f"File type: {doc_info.file_type.file_format}")
        print(f"Page count: {doc_info.page_count}")
        print(f"File size: {doc_info.size} bytes")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/get-document-info/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Check document properties before extraction

It's useful to check document properties before performing extraction operations:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def process_document(file_path):
    with Parser(file_path) as parser:
        # Get document information
        doc_info = parser.get_document_info()
        
        print(f"Processing: {file_path}")
        print(f"Type: {doc_info.file_type.file_format}")
        print(f"Pages: {doc_info.page_count}")
        print(f"Size: {doc_info.size / 1024:.2f} KB")
        
        # Process based on page count
        if doc_info.page_count > 0:
            print("Document has pages, proceeding with text extraction...")
            text_reader = parser.get_text()
            if text_reader:
                print(text_reader)
        else:
            print("Document has no pages or page count is not available")

# Process different document types
process_document("sample.pdf")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/get-document-info/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get page-specific information

For multi-page documents, you can also get information about individual pages:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("./sample.docx") as parser:
    # Get document info
    doc_info = parser.get_document_info()
    
    print(f"Total pages: {doc_info.page_count}")
    
    # Iterate through pages
    for page_index in range(doc_info.page_count):
        # Extract text from each page
        print(f"
--- Page {page_index + 1} ---")
        text_reader = parser.get_text(page_index)
        if text_reader:
            page_text = text_reader
            print(f"Characters: {len(page_text)}")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/basic-usage/get-document-info/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Working with unsupported formats

If a document format doesn't support certain features, the API returns appropriate values:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

try:
    with Parser("./unknown.format") as parser:
        doc_info = parser.get_document_info()
        
        if doc_info:
            print(f"File type: {doc_info.file_type.file_format}")
            
            # Some formats may not have page count
            if doc_info.page_count == 0:
                print("Page count is not available for this format")
        else:
            print("Could not retrieve document information")
            
except Exception as e:
    print(f"Error: {e}")
```

{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about document data extraction features and how to extract text, images, metadata, and more, please refer to the [advanced usage section]({{< ref "parser/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may find more code examples in our GitHub repository:

*   [GroupDocs.Parser for Python via .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET)

### Free online document parser

Along with the full-featured library, we provide a free online document parser app. You are welcome to extract data from PDF, DOCX, XLSX, and more with our [Free Online Document Parser App](https://products.groupdocs.app/parser).


---

## Get document information

Path: /merger/java/get-document-information/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to get document information which includes:

*   [FileType](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.result/IDocumentInfo#getType())
*   [PageCount](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.result/IDocumentInfo#getPageCount())
*   [Page info ](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.result/IPageInfo)for each document page.

  
The following code sample demonstrates how to get document information.

```java
Merger merger = new Merger("c:\sample.vsdx");

IDocumentInfo info = merger.getDocumentInfo();
System.out.print(info);        


```

---

## Get document information

Path: /merger/net/get-document-information/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to get document information which includes:
*   [Type](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.result/documentinfo/type) - indicates document file type, extension, format name etc.
*   [PageCount](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.result/documentinfo/pagecount) - indicates count of pages for text processing document, worksheets in a spreadsheet or slides in a presentation;
*   [Page info](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.result/ipageinfo) - describes properties for each document page. For example, height and width in pixels when document page is previewed as image, page number, visibility etc.

The following code sample demonstrates how to get document information.
```csharp
using (Merger merger = new Merger(@"c:\sample.vsdx"))
{
    IDocumentInfo info = merger.GetDocumentInfo();
    Console.WriteLine(info);
}
```

---

## Get document information

Path: /merger/nodejs-java/get-document-information/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to get document information which includes:

*   [FileType](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.result/IDocumentInfo#getType())
*   [PageCount](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.result/IDocumentInfo#getPageCount())
*   [Page info ](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.result/IPageInfo)for each document page.

  
The following code sample demonstrates how to get document information.

```js
const merger = new groupdocs.merger.Merger('c:/sample.vsdx');
const documentInformation = merger.getDocumentInfo();
const documentType = documentInformation.getType();
console.log(`Document info file format: ${documentType.getFileFormat()}`);
console.log(`Document info page count: ${documentInformation.getPageCount()}`);
```

---

## Get document information

Path: /merger/python-net/get-document-information/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to get document information which includes:

*   [FileType](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.result/idocumentinfo/type/)
*   [PageCount](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.result/idocumentinfo/pagecount/)
*   [Page info ](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.result/IPageInfo)for each document page.

  
The following code sample demonstrates how to get document information.

```python
with gm.Merger("c:/sample.vsdx") as merger:
    info = merger.get_document_info()
```

---

## Get document information

Path: /signature/java/get-document-information/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) allows to get document information which includes:

*   [getFileType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.documentpreview/DocumentInfo#getFileType())
*   [getSize](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.documentpreview/DocumentInfo#getSize())
*   [getPageCount](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.documentpreview/DocumentInfo#getPageCount())
*   Pages dimensions - [getHeight](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/PageInfo#getHeight()) and [getWidth](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/PageInfo#getWidth()) for each page in a document [Pages](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.documentpreview/DocumentInfo#getPages()) collection.

## Get document information from file on local disk

The following code snippet demonstrates how to obtain information about document stored on local disk.

```java
Signature signature = new Signature("sample.pdf");
// Document description
IDocumentInfo docInfo = signature.getDocumentInfo();
System.out.print("Document contains " + docInfo.getPageCount() + " pages");
System.out.print("File type is " + docInfo.getFileType().getFileFormat());
System.out.print("Width for Max Height  " + docInfo.getWidthForMaxHeight());
System.out.print("Max Page Height" + docInfo.getMaxPageHeight());
System.out.print("File size in bytes is " + docInfo.getSize());
System.out.print("Width of first page is " + docInfo.getPages().get(0).getWidth());
for(PageInfo page : docInfo.getPages()){
    System.out.print("- page-"+ page.getPageNumber()+ " Height " + page.getHeight() + " Width " + page.getWidth());
}
```

## Get document information from a stream

The following code snippet demonstrates how to obtain information about document provided as a stream. 

```java
FileInputStream stream = new FileInputStream("sample.pdf")
Signature signature = new Signature(stream );
// Document description
IDocumentInfo docInfo = signature.getDocumentInfo();
System.out.print("Document contains " + docInfo.getPageCount() + " pages");
System.out.print("File type is " + docInfo.getFileType().getFileFormat());
System.out.print("Width for Max Height  " + docInfo.getWidthForMaxHeight());
System.out.print("Max Page Height" + docInfo.getMaxPageHeight());
System.out.print("File size in bytes is " + docInfo.getSize());
System.out.print("Width of first page is " + docInfo.getPages().get(0).getWidth());
for(PageInfo page : docInfo.getPages()){
    System.out.print("- page-"+ page.getPageNumber()+ " Height " + page.getHeight() + " Width " + page.getWidth());
}
```

## More resources
### Advanced Usage Topics
To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    
### Free Online App
Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Get document information

Path: /signature/net/get-document-information/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) allows to get document information which includes:

* [FileType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/documentinfo/filetype)
* [Size](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/documentinfo/size)
* [PageCount](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/documentinfo/pagecount)
* Pages dimensions - [Height](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/pageinfo/height) and [Width](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/pageinfo/width) for each page in a document [Pages](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/idocumentinfo/pages) collection.

## Get document information from file on local disk

The following code snippet demonstrates how to obtain information about document stored on local disk.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    IDocumentInfo documentInfo = signature.GetDocumentInfo();
    Console.WriteLine("Document properties {0}:", Path.GetFileName("sample.pdf"));
    Console.WriteLine(" - format : {0}", documentInfo.FileType.FileFormat);
    Console.WriteLine(" - extension : {0}", documentInfo.FileType.Extension);
    Console.WriteLine(" - size : {0}", documentInfo.Size);
    Console.WriteLine(" - page count : {0}", documentInfo.PageCount);
    foreach(PageInfo pageInfo in documentInfo.Pages)
    {
        Console.WriteLine(" - page-{0} Width {1}, Height {2}", pageInfo.PageNumber, pageInfo.Width, pageInfo.Height);
    }
}
```

## Get document information from a stream

The following code snippet demonstrates how to obtain information about document provided as a stream.

```csharp
using (var stream = File.OpenRead("sample.pdf"))
{
    using (Signature signature = new Signature(stream))
    {
        IDocumentInfo documentInfo = signature.GetDocumentInfo();
        Console.WriteLine("Document properties {0}:", Path.GetFileName(filePath));
        Console.WriteLine(" - format : {0}", documentInfo.FileType.FileFormat);
        Console.WriteLine(" - extension : {0}", documentInfo.FileType.Extension);
        Console.WriteLine(" - size : {0}", documentInfo.Size);
        Console.WriteLine(" - page count : {0}", documentInfo.PageCount);
        foreach (PageInfo pageInfo in documentInfo.Pages)
        {
            Console.WriteLine(" - page-{0} Width {1}, Height {2}", pageInfo.PageNumber, pageInfo.Width, pageInfo.Height);
        }
    }
}
```

{{< alert style="info" >}}
**GroupDocs.Signature** also provides an abilityto obtain extended information of document form fields and existing signatures.  
To learn more about please refer to the following guides:
[Obtain document form fields and signatures information]({{< ref "signature/net/developer-guide/advanced-usage/common/obtain-document-form-fields-and-signatures-information.md" >}})
{{< /alert >}}

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Get document information

Path: /signature/nodejs-java/get-document-information/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) allows you to retrieve document information, which includes the following:

- [FileType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/documentinfo/filetype): The type of the document.
- [Size](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/documentinfo/size): The size of the document.
- [PageCount](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/documentinfo/pagecount): The total number of pages in the document.
- Page dimensions for each page in a document:
    - [Height](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/pageinfo/height)
    - [Width](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/pageinfo/width)

These properties are available through the [Pages](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/idocumentinfo/pages) collection for each page in the document.

## Get document information from a file

The following code snippet demonstrates how to obtain information about document provided as a file.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF;

  const signature = new signatureLib.Signature(filePath);

  const documentInfo = await signature.getDocumentInfo();

  console.log(`Document properties ${path.basename(filePath)}`);
  console.log(` - format : ${documentInfo.getFileType().getFileFormat()}`);
  console.log(` - extension : ${documentInfo.getFileType().getExtension()}`);
  console.log(` - size : ${documentInfo.getSize()}`);
  console.log(` - page count : ${documentInfo.getPageCount()}`);
  console.log(` - Form Fields count : ${documentInfo.getFormFields().size()}`);
  console.log(` - Text signatures count : ${documentInfo.getTextSignatures().size()}`);
  console.log(` - Image signatures count : ${documentInfo.getImageSignatures().size()}`);
  console.log(` - Digital signatures count : ${documentInfo.getDigitalSignatures().size()}`);
  console.log(` - Barcode signatures count : ${documentInfo.getBarcodeSignatures().size()}`);
  console.log(` - QrCode signatures count : ${documentInfo.getQrCodeSignatures().size()}`);
  console.log(` - FormField signatures count : ${documentInfo.getFormFieldSignatures().size()}`);

  for (const pageInfo of documentInfo.getPages().toArray()) {
    console.log(` - page-${pageInfo.getPageNumber()} Width ${pageInfo.getWidth()}, Height ${pageInfo.getHeight()}`);
  }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for ,NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Get file info

Path: /annotation/java/get-file-info/

GroupDocs.Annotation allows you to get the following file information:

*   [FileType](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/idocumentinfo/#getFileType--) is a document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation or image etc.)
*   [PageCount](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/idocumentinfo/#getPageCount--) is a count of document pages
*   [FileSize](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/idocumentinfo/#getSize--) is a file size;

[PagesInfo](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/idocumentinfo/#setPagesInfo-java.util.List-com.groupdocs.annotation.models.PageInfo--) represents a `List` of the [PageInfo](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/pageinfo/) objects which store information about each page. 

[PageInfo](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/pageinfo/) has the following properties (in pixels):
* [Width](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/pageinfo/#getWidth--)
* [Height](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/pageinfo/#getHeight--)

This properties supports all formats except Email and Html. Width and height are the same for all pages except the Cells formats.

The following code snippet shows how to get information about a document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates document info extraction

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
	
	// Get document info
	IDocumentInfo info = annotator.getDocument().getDocumentInfo();
	System.out.println(
		"\nFile type: "+info.getFileType()
		+"\nNumber of pages: "+info.getPageCount()
		+"\nDocument size: {2} bytes"+info.getSize()
	);    
} finally {
	if (annotator != null) {
		annotator.dispose();
	}
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Get file info

Path: /annotation/net/get-file-info/

GroupDocs.Annotation allows you to get the following file information:

*   [FileType](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/idocumentinfo/properties/filetype) is a document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation or image etc.)
*   [PageCount](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/idocumentinfo/properties/pagecount) is a count of document pages
*   [FileSize](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/idocumentinfo/properties/size) is a file size;

[PagesInfo](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/idocumentinfo/properties/pagesinfo) represents a `List` of the [PageInfo](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/pageinfo) objects which store information about each page. 

[PageInfo](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/pageinfo) has the following properties (in pixels):
* [Width](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/pageinfo/properties/width)
* [Height](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/pageinfo/properties/height) in pixels. 

This properties supports all formats except Email and Html. Width and height are the same for all pages except the Cells formats.

The following code snippet shows how to get information about a document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Get file info for the file from local disk
using (Annotator annotator = new Annotator("input.docx"))
{
	IDocumentInfo info = annotator.Document.GetDocumentInfo();
    int width = info.PagesInfo[0].Width;
    int height = info.PagesInfo[0].Height;
    Console.WriteLine("\nFile type: {0}\nNumber of pages: {1}\nDocument size: {2} bytes", info.FileType, info.PageCount, info.Size);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Get file info

Path: /comparison/java/get-file-info/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to get the following file information:

*   [FileType](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/filetype/) represents the document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation or image etc.).
*   [PageCount](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/pagecount/) represents count of document pages.
*   [FileSize](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/size/) represents the document file size.
*   [PagesInfo](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/pagesinfo/) represents the page information.

The following code samples show how to get file information:

## Get file info for the file from local disk

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.interfaces.IDocumentInfo;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    IDocumentInfo info = comparer.getSource().getDocumentInfo();
    for (int i = 0; i < info.getPageCount(); i++) {
        System.out.printf("\n" +
                        "File type: %s\n" +
                        "Number of pages: %d\n" +
                        "Document size: %d bytes\n" +
                        "Width: %d\n" +
                        "Height: %d%n",
                info.getFileType().getFileFormat(), 
                info.getPageCount(), 
                info.getSize(), 
                info.getPagesInfo().get(i).getWidth(), 
                info.getPagesInfo().get(i).getHeight());
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/get-file-info.png)

## Get file info for the file from stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.interfaces.IDocumentInfo;
import java.io.FileInputStream;
import java.io.InputStream;
// ...

try (InputStream inputStream = new FileInputStream("source.docx");
    Comparer comparer = new Comparer(inputStream)) {
    IDocumentInfo info = comparer.getSource().getDocumentInfo();
    for (int i = 0; i < info.getPageCount(); i++) {
        System.out.printf("\n" +
                        "File type: %s\n" +
                        "Number of pages: %d\n" +
                        "Document size: %d bytes\n" +
                        "Width: %d\n" +
                        "Height: %d%n",
                info.getFileType().getFileFormat(), 
                info.getPageCount(), 
                info.getSize(), 
                info.getPagesInfo().get(i).getWidth(), 
                info.getPagesInfo().get(i).getHeight());
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Get file info

Path: /comparison/net/get-file-info/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to get the following file information:

*   [FileType](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.interfaces/idocumentinfo/properties/filetype) represents the document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation or image etc.).
*   [PageCount](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.interfaces/idocumentinfo/properties/pagecount) represents count of document pages.
*   [FileSize](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.interfaces/idocumentinfo/properties/size) represents the document file size.
*   [PagesInfo](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/pageinfo) represents the page information.

The following code samples show how to get file information:

## Get file info for the file from local disk

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Interfaces;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    IDocumentInfo info = comparer.Source.GetDocumentInfo();
    for (int i = 0; i < info.PageCount; i++)
    {
        Console.WriteLine("\n" +
            "Page number: {5}\n" +
            "File type: {0}\n" +
            "Number of pages: {1}\n" +
            "Document size: {2} bytes\n" +
            "Width: {3}\n" +
            "Height: {4} ",
            info.FileType, 
            info.PageCount, 
            info.Size, 
            info.PagesInfo[i].Width, 
            info.PagesInfo[i].Height, i + 1
        );
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/get-file-info.png)

## Get file info for the file from stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Interfaces;
using System.IO;
// ...

using (Comparer comparer = new Comparer(File.OpenRead("source.docx")))
{
    IDocumentInfo info = comparer.Source.GetDocumentInfo();
    for (int i = 0; i < info.PageCount; i++)
    {
        Console.WriteLine("\n" +
            "Page number: {5}\n" +
            "File type: {0}\n" +
            "Number of pages: {1}\n" +
            "Document size: {2} bytes\n" +
            "Width: {3}\n" +
            "Height: {4} ",
            info.FileType, 
            info.PageCount, 
            info.Size, 
            info.PagesInfo[i].Width, 
            info.PagesInfo[i].Height, i + 1
        );
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Get file info

Path: /comparison/nodejs-java/get-file-info/


With [GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) you can retrieve the following information about a file:

*   `FileType` represents the document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation, image etc.).
*   `PageCount` represents the number of pages in a document.
*   `FileSize` represents the document file size.
*   `PagesInfo` represents the page information.

The following code samples show how to get file information:

## Get file info for the file from a local disk

The following example opens a local document and prints its basic metadata such as type, page count, and size.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Create a Comparer instance for the source document (loaded from disk)
const comparer = new groupdocs.Comparer('sample-files/source.docx');

// Retrieve document information (type, pages, size, etc.) from the source
const info = comparer.getSource().getDocumentInfo();

// Output file type, page count, and size to the console
console.log(`\nFile type: ${info.getFileType().getFileFormat()}`);
console.log(`Number of pages: ${info.getPageCount()}`);
console.log(`Document size: ${info.getSize()} bytes`);

// Terminate the process with a success exit code
process.exit(0);
```

The result is as follows:

![](/comparison/nodejs-java/images/get-file-info.png)

## Get file info for the file from a stream

The following example loads a document from a Java input stream and then reads its metadata.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import Java bridge to work with input streams
const java = require('java');

// Get a reference to the Java FileInputStream class
let InputStream = java.import('java.io.FileInputStream');

// Create a Comparer instance using a Java input stream as the source document
const comparer = new groupdocs.Comparer(new InputStream('sample-files/source.docx'));

// Retrieve document information from the source stream
const info = comparer.getSource().getDocumentInfo();

// Print document type, page count, and size to the console
console.log(`\nFile type: ${info.getFileType().getFileFormat()}`);
console.log(`Number of pages: ${info.getPageCount()}`);
console.log(`Document size: ${info.getSize()} bytes`);

// Terminate the process with a success exit code
process.exit(0);
```


---

## Get file info

Path: /comparison/python-net/get-file-info/


With [GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) you can retrieve the following information about a file:

*   `FileType`<!--](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/filetype/)--> represents the document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation, image etc.).
*   `PageCount`<!--](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/pagecount/)--> represents the number of pages in a document.
*   `FileSize`<!--](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/size/)--> represents the document file size.
*   `PagesInfo`<!--](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.interfaces/idocumentinfo/pagesinfo/)--> represents the page information.

The following code samples show how to get file information:

## Get file info for the file from a local disk

```python
import groupdocs.comparison as gc

def run():
    comparer = gc.Comparer(sourcePath)

    info = comparer.source.get_document_info()

    print(info)
    
    print(f"\nFile type: {info.file_type.file_format}")
    print(f"Number of pages: {info.page_count}")
    print(f"Document size: {info.size} bytes")
    
    print("\nDocument info extracted successfully.")
```

The result is as follows:

![](/comparison/python-net/images/get-file-info.png)

## Get file info for the file from a stream

```python
import groupdocs.comparison as gc

def run():
    with open(sourcePath, 'rb') as source_stream:
        comparer = gc.Comparer(source_stream)

        info = comparer.source.get_document_info()
        
        print(f"\nFile type: {info.file_type.file_format}")
        print(f"Number of pages: {info.page_count}")
        print(f"Document size: {info.size} bytes")
        
        print("\nDocument info extracted successfully.")
```


---

## Get file info

Path: /redaction/java/get-file-info/

### Get file info

GroupDocs.Redaction provides general document information, which includes:

*   FileType
*   PageCount
*   FileSize

The following code examples demonstrate how to get document information.

### Get file info for a file from local disk



```java
final Redactor redactor = new Redactor(stream);
try 
{
    IDocumentInfo info = redactor.getDocumentInfo();
    System.out.println("\nFile type: " + info.getFileType() + "\nNumber of pages: " + info.getPageCount() + 
            "\nDocument size: " + info.getSize() + " bytes");
}
finally { redactor.close(); }
```

### Get file info for a file from Stream



```java
FileInputStream stream = new FileInputStream("D:\\Sample.docx");
final Redactor redactor = new Redactor("D:\Sample.docx");
try 
{
    IDocumentInfo info = redactor.getDocumentInfo();
    System.out.println("\nFile type: " + info.getFileType() + "\nNumber of pages: " + info.getPageCount() + 
            "\nDocument size: " + info.getSize() + " bytes");
}
finally 
{ 
    redactor.close(); 
    stream.close();
}
```

---

## Get file info

Path: /redaction/net/get-file-info/

GroupDocs.Redaction provides general document information, which includes:

*   FileType
*   PageCount
*   FileSize

The following code examples demonstrate how to get document information.

## Get file info for a file from local disk

```csharp
using (Redactor redactor = new Redactor("source.docx"))
{
	IDocumentInfo info = redactor.GetDocumentInfo();
    Console.WriteLine("\nFile type: {0}\nNumber of pages: {1}\nDocument size: {2} bytes", info.FileType, info.PageCount, info.Size);
}
```

## Get file info for a file from Stream

```csharp
using (Redactor redactor = new Redactor(File.OpenRead("source.docx"))
{
	IDocumentInfo info = redactor.GetDocumentInfo();
    Console.WriteLine("\nFile type: {0}\nNumber of pages: {1}\nDocument size: {2} bytes", info.FileType, info.PageCount, info.Size);
}
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Get file info

Path: /redaction/python-net/get-file-info/

GroupDocs.Redaction provides general document information, which includes:

*   FileType
*   PageCount
*   FileSize

The following code examples demonstrate how to get document information.

## Get file info for a file from local disk

```python
import groupdocs.redaction as gr

def run():
    with gr.Redactor("source.docx") as redactor:
        info = redactor.get_document_info()

        print(f"File type: {info.file_type}")
        print(f"Number of pages: {info.page_count}")
        print(f"Document size: {info.size} bytes")
```

## Get file info for a file from Stream

```python
import groupdocs.redaction as gr

def run():
    with open("source.docx", "rb") as stream:
        with gr.Redactor(stream) as redactor:
            info = redactor.get_document_info()

            print(f"File type: {info.file_type}")
            print(f"Number of pages: {info.page_count}")
            print(f"Document size: {info.size} bytes")
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Get supported file formats

Path: /watermark/java/get-supported-file-formats/

GroupDocs.Watermark allows to get the [list of all supported file formats]({{< ref "/watermark/java/getting-started/supported-document-formats.md" >}}) by following the below steps:

*   Call [getSupportedFileTypes](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/FileType#getSupportedFileTypes()) of [FileType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/FileType) class;
*   Enumerate through the collection of [FileType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.common/FileType) objects*.*

The following code sample demonstrates how to get a supported file formats list.

**basic\_usage.GetSupportedFileFormats**

```java
FileType[] fileTypes = FileType.getSupportedFileTypes();
for(FileType fileType : fileTypes) {                    
    System.out.println(fileType);                       
}                                                       
```

---

## Get the format family and the additional information

Path: /viewer/java/how-to-get-file-type-and-pages-count/

A format family is a group of several file types for which an application provides additional information. For example, archive files (.7z, .rar, .zip, etc.) or Outlook files (.ost, .pst) are format families.

You can get the format family and the additional information using the [getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method that returns a [ViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/) object.

GroupDocs.Viewer provides additional information for the following format families:

* Archive files - a collection of folders in the archive (see [Obtain information about folders in an archive file]({{< ref "/viewer/java/rendering-basics/render-archives/_index.md" >}}));
* CAD drawings - a collection of layouts and layers (see [Obtain information about existing layouts and layers]({{< ref "/viewer/java/rendering-basics/rendering-cad-documents/render-cad-documents.md" >}}));
* Outlook data files - a collection of folders (see [Obtain information about folders in an Outlook data file]({{< ref "/viewer/java/rendering-basics/render-outlook-data-files.md" >}}));
* PDF documents - a flag that indicates whether document printing is allowed (see [Obtain information about a PDF file]({{< ref "/viewer/java/rendering-basics/render-pdf-documents.md" >}}));
* Microsoft Project files - the project's start and end dates (see [Obtain information about a Project file]({{< ref "/viewer/java/rendering-basics/render-ms-project-files.md" >}})).

## Get the file type and the pages count from a file

The following code snippet shows how to get the file type and the pages count from a file:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ViewInfo;
// ...

try (Viewer viewer = new Viewer("sample.pdf")) {
    // Get file information.
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
    ViewInfo viewInfo = viewer.getViewInfo(viewInfoOptions);
    // Display file type and pages count.
    System.out.println("Document type is: " + viewInfo.getFileType());
    System.out.println("Pages count: " + viewInfo.getPages().size());
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/java/images/how-to-get-file-type-and-pages-count.png)
---

## Get the format family and the additional information

Path: /viewer/net/how-to-get-file-type-and-pages-count/

A format family is a group of several file types for which an application provides additional information. For example, archive files (.7z, .rar, .zip, etc.) or Outlook files (.ost, .pst) are format families.

You can get the format family and the additional information using the [GetViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/getviewinfo) method that returns a [ViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo) object.

GroupDocs.Viewer provides additional information for the following format families:

* Archive files - a collection of folders in the archive (see [Obtain information about folders in an archive file]({{< ref "/viewer/net/rendering-basics/render-archives/_index.md" >}}));
* CAD drawings - a collection of layouts and layers (see [Obtain information about existing layouts and layers]({{< ref "/viewer/net/rendering-basics/render-cad-documents/render-cad-documents.md" >}}));
* Outlook data files - a collection of folders (see [Obtain information about folders in an Outlook data file]({{< ref "/viewer/net/rendering-basics/render-outlook-data-files.md" >}}));
* PDF documents - a flag that indicates whether document printing is allowed (see [Obtain information about a PDF file]({{< ref "/viewer/net/rendering-basics/render-pdf-documents.md" >}}));
* Microsoft Project files - the project's start and end dates (see [Obtain information about a Project file]({{< ref "/viewer/net/rendering-basics/render-ms-project-files.md" >}})).

## Get the file type and the pages count from a file

The following code snippet shows how to get the file type and the pages count from a file:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("sample.pdf"))
{
    // Get file information.
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForHtmlView();
    ViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions);

    // Display file type and pages count.
    Console.WriteLine("Document type is: " + viewInfo.FileType);
    Console.WriteLine("Pages count: " + viewInfo.Pages.Count);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.pdf")
            ' Get file information.
            Dim viewInfoOptions As ViewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo As ViewInfo = viewer.GetViewInfo(viewInfoOptions)

            ' Display file type and pages count.
            Console.WriteLine("Document type is: " & viewInfo.FileType.ToString())
            Console.WriteLine("Pages count: " & viewInfo.Pages.Count.ToString())
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-get-file-type-and-pages-count.png)

## Get the file type and the pages count from a stream

The following code snippet shows how to get the file type and the pages count from a stream:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using System;
using System.IO;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer(File.OpenRead("sample.pdf")))
{
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForHtmlView();
    ViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions);
 
    Console.WriteLine("Document type is: " + viewInfo.FileType);
    Console.WriteLine("Pages count: " + viewInfo.Pages.Count);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports System.IO
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer(File.OpenRead("sample.pdf"))
            Dim viewInfoOptions As ViewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo As ViewInfo = viewer.GetViewInfo(viewInfoOptions)

            Console.WriteLine("Document type is: " & viewInfo.FileType.ToString())
            Console.WriteLine("Pages count: " & viewInfo.Pages.Count.ToString())
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-get-file-type-and-pages-count.png)
---

## Get the format family and the additional information

Path: /viewer/nodejs-java/how-to-get-file-type-and-pages-count/

A format family is a group of several file types for which an application provides additional information. For example, archive files (.7z, .rar, .zip, etc.) or Outlook files (.ost, .pst) are format families.

You can get the format family and the additional information using the [getViewInfo](#) method that returns a [ViewInfo](#) object.

GroupDocs.Viewer provides additional information for the following format families:

* Archive files - a collection of folders in the archive (see [Obtain information about folders in an archive file](#);
* CAD drawings - a collection of layouts and layers (see [Obtain information about existing layouts and layers](#));
* Outlook data files - a collection of folders (see [Obtain information about folders in an Outlook data file](#));
* PDF documents - a flag that indicates whether document printing is allowed (see [Obtain information about a PDF file](#));
* Microsoft Project files - the project's start and end dates (see [Obtain information about a Project file](#)).

## Get the file type and the pages count from a file

The following code snippet shows how to get the file type and the pages count from a file:

{{< tabs "get-file-type-and-pages-count">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Get file information.
const viewInfoOptions = ViewInfoOptions.forHtmlView()
const viewInfo = viewer.getViewInfo(viewInfoOptions)
console.log("Document type is: " + viewInfo.getFileType())
console.log("Pages count: " + viewInfo.getPages().size())
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/developer-guide/retrieving-document-information/how-to-get-file-type-and-pages-count/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/nodejs-java/images/how-to-get-file-type-and-pages-count.png)
---

## Get the format family and the additional information

Path: /viewer/python-net/how-to-get-file-type-and-pages-count/

A format family is a group of several file types for which an application provides additional information. For example, archive files (.7z, .rar, .zip, etc.) or Outlook files (.ost, .pst) are format families.

You can get the format family and the additional information using the [get_view_info](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method that returns a [ViewInfo](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/viewinfo/) object.

GroupDocs.Viewer provides additional information for the following format families:

* Archive files - a collection of folders in the archive (see [Obtain information about folders in an archive file]({{< ref "/viewer/python-net/rendering-basics/render-archive-files.md" >}}));
* CAD drawings - a collection of layouts and layers (see [Obtain information about existing layouts and layers]({{< ref "/viewer/python-net/rendering-basics/render-cad-documents/render-cad-documents.md" >}}));
* Outlook data files - a collection of folders (see [Obtain information about folders in an Outlook data file]({{< ref "/viewer/python-net/rendering-basics/render-outlook-data-files.md" >}}));
* PDF documents - a flag that indicates whether document printing is allowed (see [Obtain information about a PDF file]({{< ref "/viewer/python-net/rendering-basics/render-pdf-documents.md" >}}));
* Microsoft Project files - the project's start and end dates (see [Obtain information about a Project file]({{< ref "/viewer/python-net/rendering-basics/render-ms-project-files.md" >}})).

## Get the file type and the pages count from a file

The following code snippet shows how to get the file type and the pages count from a file:

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from typing import cast
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions
from groupdocs.viewer.results import PdfViewInfo

def get_file_type_and_pages_count():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        options = ViewInfoOptions.for_html_view() 
        info = viewer.get_view_info(options)
        pdf_info = cast(PdfViewInfo, info)

        print("Document type is:", pdf_info.file_type)
        print("Pages count:", len(pdf_info.pages))

        print("\nView info retrieved successfully.")

if __name__ == "__main__":
    get_file_type_and_pages_count()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/retrieving-document-information/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/python-net/images/how-to-get-file-type-and-pages-count.png)
---

## Getting Document Information

Path: /conversion/python-net/developer-guide/getting-document-info/


GroupDocs.Conversion for Python via .NET provides a standard method to obtain information about a document. You can retrieve a basic document information or detailed as shown below for various formats.

## Example 1: Get Basic Document Info

To retrieve document information, use the `Converter.get_document_info()` method. It returns a `DocumentInfo` object containing details common to all supported document types, such as format, creation date, size, and page count.

{{< tabs "code-example-1">}}
{{< tab "get_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_document_info():
    # Load the document and retrieve information
    with Converter("./lorem-ipsum.txt") as converter:
        info = converter.get_document_info()
    
        # Print basic document info
        print("Format:", info.format)
        print("Pages count:", info.pages_count)
        print("Creation date:", info.creation_date)
        print("Size, bytes:", info.size)

if __name__ == "__main__":
    get_document_info()
```
{{< /tab >}}

{{< tab "Expected output" >}}  
```yaml
Format: txt
Pages count: 3
Creation date: 0001-01-01 00:00:00
Size, bytes: 7794
```
{{< /tab >}}
{{< tab "lorem-ipsum.txt" >}}  
{{< tab-text >}}
`lorem-ipsum.txt` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/lorem-ipsum.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 2: Get PDF Document Info

{{< tabs "code-example-2">}}
{{< tab "get_pdf_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_pdf_document_info():
    # Load the document and retrieve information
    with Converter("sample-with-toc.pdf") as converter:
        doc_info = converter.get_document_info()

        # Print PDF document info
        print("Author:", doc_info.author)
        print("Creation Date:", doc_info.creation_date)
        print("Title:", doc_info.title)
        print("Version:", doc_info.version)
        print("Pages Count:", doc_info.pages_count)
        print("Width:", doc_info.width)
        print("Height:", doc_info.height)
        print("Is Landscaped:", doc_info.is_landscape)
        print("Is Password-Protected:", doc_info.is_password_protected)
        print("Table of contents:")
        for toc_item in doc_info.table_of_contents:
            print(f" Page {toc_item.page}: Title: {toc_item.title}")

if __name__ == "__main__":
    get_pdf_document_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: None
Creation Date: 2020-08-12 16:41:29
Title: None
Version: 1.7
Pages Count: 5
Width: 612.0
Height: 792.0
Is Landscaped: False
Is Password-Protected: False
Table of contents:
 Page 1: Title: Page 1 heading!
 Page 2: Title: Page 2 heading!
 Page 3: Title: Page 3 heading!
 Page 4: Title: Page 4 heading!
```
{{< /tab >}}
{{< tab "sample-with-toc.pdf" >}}  
{{< tab-text >}}
`sample-with-toc.pdf` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/sample-with-toc.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


## Example 3: Get Word Processing Document Info

You can find which file types belong to this format family in the [Word Processing]({{< ref "conversion/python-net/supported-file-formats#word-processing" >}}) documentation section.

{{< tabs "code-example-3">}}
{{< tab "get_wp_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_wp_document_info():
    # Load the document and retrieve information
    with Converter("./business-plan.doc") as converter:
        doc_info = converter.get_document_info()

        # Print DOC document info
        print("Author:", doc_info.author)
        print("Creation Date:", doc_info.creation_date)
        print("Format:", doc_info.format)
        print("Is Password Protected:", doc_info.is_password_protected)
        print("Lines:", doc_info.lines)
        print("Pages Count:", doc_info.pages_count)
        print("Size, bytes:", doc_info.size)
        print("Title:", doc_info.title)
        print("Words:", doc_info.words)
        print("Table of contents:")
        for toc_item in doc_info.table_of_contents:
            print(f" Page {toc_item.page}: Title: {toc_item.title}")

if __name__ == "__main__":
    get_wp_document_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: GroupDocs
Creation Date: 2024-11-03 10:05:00+00:00
Format: doc
Is Password Protected: False
Lines: 180
Pages Count: 19
Size, bytes: 414208
Title:
Words: 3789
Table of contents:
 Page 3: Title: INTRODUCTION
 Page 5: Title: 1. EXECUTIVE SUMMARY
 Page 6: Title: 2. COMPANY OVERVIEW
 Page 7: Title: 3. BUSINESS DESCRIPTION
 Page 8: Title: 4. MARKET ANALYSIS
 Page 10: Title: 5. OPERATING PLAN
 Page 11: Title: 6. MARKETING AND SALES PLAN
 Page 12: Title: 7. FINANCIAL PLAN
 Page 16: Title: APPENDIX
 Page 17: Title: Instructions for Getting Started with Estimated Start-Up Costs
 Page 19: Title: Instructions for Getting Started on Profit & Loss Projections
```
{{< /tab >}}
{{< tab "business-plan.doc" >}}  
{{< tab-text >}}
`business-plan.doc` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/business-plan.doc) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 4: Get Project Management Document Info

You can find which file types belong to this format family in the [Project Management]({{< ref "conversion/python-net/supported-file-formats#project-management" >}}) documentation section.

{{< tabs "code-example-4">}}
{{< tab "get_pm_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_pm_document_info():
    # Load the document and retrieve information
    with Converter("./weekly-plan.mpp") as converter:
        doc_info = converter.get_document_info()

        # Print MPP document info
        print("Creation Date:", doc_info.creation_date)
        print("Start Date:", doc_info.start_date)
        print("End Date:", doc_info.end_date)
        print("Format:", doc_info.format)
        print("Size, bytes:", doc_info.size)
        print("Tasks Count:", doc_info.tasks_count)

if __name__ == "__main__":
    get_pm_document_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Creation Date: 2024-11-03 10:21:07.846676+00:00
Start Date: 2017-10-06 09:00:00+00:00
End Date: 2017-10-14 18:00:00+00:00
Format: mpp
Size, bytes: 236544
Tasks Count: 5
```
{{< /tab >}}
{{< tab "weekly-plan.mpp" >}}  
{{< tab-text >}}
`weekly-plan.mpp` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/weekly-plan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 5: Get Image Info

You can find which file types belong to this format family in the [Image]({{< ref "conversion/python-net/supported-file-formats#image" >}}) documentation section.

{{< tabs "code-example-5">}}
{{< tab "get_image_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_image_info():
    # Load the document and retrieve information
    with Converter("./infographic-elements.tiff") as converter:
        doc_info = converter.get_document_info()

        # Print TIFF document info
        print("Bits per Pixel:", doc_info.bits_per_pixel)
        print("Creation Date:", doc_info.creation_date)
        print("Format:", doc_info.format)
        print("Height:", doc_info.height)
        print("Width:", doc_info.width)
        print("Size, bytes:", doc_info.size)

if __name__ == "__main__":
    get_image_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Bits per Pixel: 32
Creation Date: 2024-11-03 11:00:45.101493+00:00
Format: tiff
Height: 2000
Width: 1500
Size, bytes: 1734560
```
{{< /tab >}}
{{< tab "infographic-elements.tiff" >}}  
{{< tab-text >}}
`infographic-elements.tiff` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/infographic-elements.tiff) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 6: Get Presentation Document Info

You can find which file types belong to this format family in the [Presentation]({{< ref "conversion/python-net/supported-file-formats#presentation" >}}) documentation section.

{{< tabs "code-example-6">}}
{{< tab "get_pres_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_pres_document_info():
    # Load the document and retrieve information
    with Converter("./presentation-template.pptx") as converter:
        doc_info = converter.get_document_info()

        # Print PPTX document info
        print("Author:", doc_info.author)
        print("Creation Date:", doc_info.creation_date)
        print("Format:", doc_info.format)
        print("Is Password Protected:", doc_info.is_password_protected)
        print("Pages Count:", doc_info.pages_count)
        print("Size, bytes:", doc_info.size)
        print("Title:", doc_info.title)

if __name__ == "__main__":
    get_pres_document_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: GroupDocs
Creation Date: 2023-03-04 14:58:10+00:00
Format: pptx
Is Password Protected: False
Pages Count: 3
Size, bytes: 35210
Title: TEST
```
{{< /tab >}}
{{< tab "presentation-template.pptx" >}}  
{{< tab-text >}}
`presentation-template.pptx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/presentation-template.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 7: Get Spreadsheet Document Info

You can find which file types belong to this format family in the [Spreadsheets]({{< ref "conversion/python-net/supported-file-formats#spreadsheet" >}}) documentation section.

{{< tabs "code-example-7">}}
{{< tab "get_sp_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_sp_document_info():
    # Load the document and retrieve information
    with Converter("./cost-analysis.xlsx") as converter:
        doc_info = converter.get_document_info()

        # Print XLSX document info
        print("Author:", doc_info.author)
        print("Creation Date:", doc_info.creation_date)
        print("Format:", doc_info.format)
        print("Is Password Protected:", doc_info.is_password_protected)
        print("Pages Count:", doc_info.pages_count)
        print("Size, bytes:", doc_info.size)
        print("Title:", doc_info.title)
        print("Worksheets Count:", doc_info.worksheets_count)

if __name__ == "__main__":
    get_sp_document_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Author: GroupDocs
Creation Date: 2023-02-23 18:52:46+02:00
Format: xlsx
Is Password Protected: False
Pages Count: 0
Size, bytes: 78940
Title: Cost Analysis
Worksheets Count: 1
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 8: Get CAD Drawing Info

You can find which file types belong to this format family in the [CAD]({{< ref "conversion/python-net/supported-file-formats#cad" >}}) documentation section.

{{< tabs "code-example-8">}}
{{< tab "get_cad_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_cad_document_info():
    # Load the document and retrieve information
    with Converter("./blocks-and-tables.dwg") as converter:
        doc_info = converter.get_document_info()

        # Print DWG document info
        print("Creation Date:", doc_info.creation_date)
        print("Format:", doc_info.format)
        print("Height:", doc_info.height)
        print("Width:", doc_info.width)
        print("Size, bytes:", doc_info.size)
        
        print("Layouts:")
        for layout in doc_info.layouts:
            print(" Layout:", layout)
        
        print("Layers:")
        for layer in doc_info.layers:
            print(" Layer:", layer)

if __name__ == "__main__":
    get_cad_document_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Creation Date: 2024-11-03 11:22:09.976267+00:00
Format: dwg
Height: 16
Width: 26
Size, bytes: 258848
Layouts:
 Layout: Model
 Layout: ISO A1
Layers:
 Layer: Text
 Layer: Viewports
 Layer: Walls
 Layer: Stairs
 Layer: Deck
 Layer: Cabinetry
 Layer: Schedules
 Layer: Appliances
 Layer: Doors
 Layer: Power
 Layer: Lighting
 Layer: BDRTXT
 Layer: BRDTITLE
 Layer: 0
 Layer: DB - Windows
 Layer: Defpoints
 Layer: Dimensions
```
{{< /tab >}}
{{< tab "blocks-and-tables.dwg" >}}  
{{< tab-text >}}
`blocks-and-tables.dwg` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/blocks-and-tables.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 9: Get Email Message Info

You can find which file types belong to this format family in the [Email]({{< ref "conversion/python-net/supported-file-formats#email-and-outlook" >}}) documentation section.

{{< tabs "code-example-9">}}
{{< tab "get_email_document_info.py" >}}  
```python
from groupdocs.conversion import Converter

def get_email_document_info():
    # Load the document and retrieve information
    with Converter("./invitation.eml") as converter:
        doc_info = converter.get_document_info()

        # Print EML document info
        print("Creation Date:", doc_info.creation_date)
        print("Format:", doc_info.format)
        print("Is Encrypted:", doc_info.is_encrypted)
        print("Is Body in HTML:", doc_info.is_html)
        print("Is Signed:", doc_info.is_signed)
        print("Size:", doc_info.size)
        print("Attachments Count:", doc_info.attachments_count)

        for attachment_name in doc_info.attachments_names:
            print("Attachment Name:", attachment_name)

if __name__ == "__main__":
    get_email_document_info()
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
Creation Date: 2017-04-25 11:28:29+00:00
Format: eml
Is Encrypted: False
Is Body in HTML: True
Is Signed: False
Size: 91948
Attachments Count: 0
```
{{< /tab >}}
{{< tab "invitation.eml" >}}  
{{< tab-text >}}
`invitation.eml` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/get-document-info/invitation.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The DocumentInfo object provides an extensive set of metadata, which varies depending on the document format. You can consult the [API reference](https://reference.groupdocs.com/conversion/python-net/) for additional format-specific document metadata details.

---

## Handling metadata in WAV files

Path: /metadata/java/handling-metadata-in-wav-files/

## Reading audio details

The GroupDocs.Metadata API supports extracting technical audio information from WAV files.

The following are the steps to read audio details.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a WAV audio
2.  Get the root metadata package
3.  Extract  the native metadata package using the [WavRootPackage.getWavPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/WavRootPackage#getWavPackage()) method
4.  Read the WAV audio properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.wav.WavReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputWav)) {
	WavRootPackage root = metadata.getRootPackageGeneric();
	if (root.getWavPackage() != null) {
		System.out.println(root.getWavPackage().getAudioFormat());
		System.out.println(root.getWavPackage().getBitsPerSample());
		System.out.println(root.getWavPackage().getBlockAlign());
		System.out.println(root.getWavPackage().getByteRate());
		System.out.println(root.getWavPackage().getNumberOfChannels());
		System.out.println(root.getWavPackage().getSampleRate());
	}
}
```

## Extract RIFF INFO chunk metadata

The WAV format is derived from the RIFF container which acts as a wrapper for various audio and video coding formats. As a derivative of RIFF, WAV files can be tagged with metadata in the INFO chunk. The chunk may include information such as the title of the work, the author, the creation date, and copyright information. Here is an example of how the RIFF INFO metadata can be extracted:

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.wav.WavReadInfoMetadata**

```csharp
try (Metadata metadata = new Metadata(Constants.InputWav)) {
    WavRootPackage root = metadata.getRootPackageGeneric();
    if (root.getRiffInfoPackage() != null) {
        System.out.println(root.getRiffInfoPackage().getArtist());
        System.out.println(root.getRiffInfoPackage().getComment());
        System.out.println(root.getRiffInfoPackage().getCopyright());
        System.out.println(root.getRiffInfoPackage().getCreationDate());
        System.out.println(root.getRiffInfoPackage().getSoftware());
        System.out.println(root.getRiffInfoPackage().getEngineer());
        System.out.println(root.getRiffInfoPackage().getGenre());
 
        // ...
    }
} 
```

## Working with XMP metadata

GroupDocs.Metadata for Java also allows managing XMP metadata in WAV files. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/managing-metadata-for-specific-formats/audio/handling-metadata-in-wav-files.md" >}})

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Handling metadata in WAV files

Path: /metadata/net/handling-metadata-in-wav-files/

## Reading audio details

The GroupDocs.Metadata API supports extracting technical audio information from WAV files.

The following are the steps to read audio details.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a WAV audio
2.  Get the root metadata package
3.  Extract  the native metadata package using the [WavRootPackage.WavPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/wavrootpackage/properties/wavpackage) property
4.  Read the WAV audio properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.Wav.WavReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputWav))
{
	var root = metadata.GetRootPackage<WavRootPackage>();
	if (root.WavPackage != null)
	{
		Console.WriteLine(root.WavPackage.AudioFormat);
		Console.WriteLine(root.WavPackage.BitsPerSample);
		Console.WriteLine(root.WavPackage.BlockAlign);
		Console.WriteLine(root.WavPackage.ByteRate);
		Console.WriteLine(root.WavPackage.NumberOfChannels);
		Console.WriteLine(root.WavPackage.SampleRate);
	}
}
```

## Extract RIFF INFO chunk metadata

The WAV format is derived from the RIFF container which acts as a wrapper for various audio and video coding formats. As a derivative of RIFF, WAV files can be tagged with metadata in the INFO chunk. The chunk may include information such as the title of the work, the author, the creation date, and copyright information. Here is an example of how the RIFF INFO metadata can be extracted:

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.Wav.WavReadInfoMetadata**

```csharp
using (Metadata metadata = new Metadata(Constants.InputWav))
{
    var root = metadata.GetRootPackage<WavRootPackage>();
    if (root.RiffInfoPackage != null)
    {
        Console.WriteLine(root.RiffInfoPackage.Artist);
        Console.WriteLine(root.RiffInfoPackage.Comment);
        Console.WriteLine(root.RiffInfoPackage.Copyright);
        Console.WriteLine(root.RiffInfoPackage.CreationDate);
        Console.WriteLine(root.RiffInfoPackage.Software);
        Console.WriteLine(root.RiffInfoPackage.Engineer);
        Console.WriteLine(root.RiffInfoPackage.Genre);
 
        // ...
    }
}
```

## Working with XMP metadata

GroupDocs.Metadata for .NET also allows managing XMP metadata in WAV files. For more details please refer to the following guide: [Handling metadata in WAV files]({{< ref "metadata/net/developer-guide/advanced-usage/managing-metadata-for-specific-formats/audio/handling-metadata-in-wav-files.md" >}})

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Handling password required exception

Path: /signature/java/handling-password-required-exception/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports handling required password exception when opening protected documents over class [PasswordRequiredException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/PasswordRequiredException).

Here are the steps to handle incorrect password exception when working with protected documents with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.
    
*   Cover the code that works with [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object methods ([sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)), [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)), [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)), [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)), [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))) with try - catch block including catching [PasswordRequiredException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/PasswordRequiredException) exception.

Following example demonstrates how to handle required password exception.

```java
// skip initialization of LoadOptions with Password
// LoadOptions loadOptions = new LoadOptions(){ Password  = "1234567890" }    
Signature signature = new Signature("protectedPwd.pdf");
 
try
{
    QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
    options.setEncodeType(QrCodeTypes.QR);
    options.setLeft(100);
    options.setTop(100);
    // try to sign document to file, we expect for PasswordRequiredException
    signature.sign(outputFilePath, options);
    System.out.print("\nSource document signed successfully.\nFile saved at " + outputFilePath);
}
catch(PasswordRequiredException ex)
{
    System.out.print("PasswordRequiredException: " + ex.getMessage());
}
catch(GroupDocsSignatureException ex)
{
    System.out.print("Common GroupDocsSignatureException: " + ex.getMessage());
}
catch (java.lang.RuntimeException ex)
{
    System.out.print("Common Exception happens only at user code level: " + ex.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Handling password required exception

Path: /signature/net/handling-password-required-exception/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports handling required password exception when opening protected documents over class [PasswordRequiredException](https://reference.groupdocs.com/signature/net/groupdocs.signature/passwordrequiredexception).

Here are the steps to handle incorrect password exception when working with protected documents with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Cover the code that works with [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object methods ([Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/#sign_4), [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify), [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search), [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update), [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete)) with try - catch block including catching [PasswordRequiredException](https://reference.groupdocs.com/signature/net/groupdocs.signature/passwordrequiredexception) exception.

Following example demonstrates how to handle required password exception.

```csharp
// skip initialization of LoadOptions with Password
// LoadOptions loadOptions = new LoadOptions(){ Password  = "1234567890" }
using (Signature signature = new Signature("protectedPwd.pdf"))
{
    try
    {
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
        {
            EncodeType = QrCodeTypes.QR,
            Left = 100,
            Top = 100
        };
        // try to sign document to file, we expect for PasswordRequiredException
        signature.Sign(outputFilePath, options);
        Console.WriteLine("\nSource document signed successfully.\nFile saved at " + outputFilePath);
    }
    catch(PasswordRequiredException ex)
    {
        Console.WriteLine($"PasswordRequiredException: {ex.Message}");
    }
    catch(GroupDocsSignatureException ex)
    {
        Console.WriteLine($"Common GroupDocsSignatureException: {ex.Message}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Common Exception happens only at user code level: {ex.Message}");
    }
    finally
    {
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Handling the ID3v2 tag

Path: /metadata/java/handling-the-id3v2-tag/

## What is ID3v2?

ID3v2 is a metadata standard that is primarily used with mp3 files. Although it bears the name ID3, its structure is very different from [ID3v1]({{< ref "metadata/java/developer-guide/advanced-usage/managing-metadata-for-specific-formats/audio/working-with-mp3-metadata/handling-the-id3v1-tag.md" >}}). ID3v2 tags consist of a number of frames, each of which contains a piece of metadata.
{{< alert style="info" >}}For more information on the ID3v2 standard visit http://id3.org/id3v2.3.0. Please note there are three versions of ID3v2: ID3v2.2, ID3v2.3, ID3v2.4.{{< /alert >}}

## Reading an ID3v2 tag

The GroupDocs.Metadata API allows reading the ID3v2 tag in an MP3 audio. To get more information about ID3 tags, visit: https://en.wikipedia.org/wiki/ID3

The following steps show how to read the ID3v2 tag in an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the ID3v2 tag by using the [Mp3RootPackage.getID3V2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getID3V2()) method
4.  If the ID3v2 tag is not null then check for all of its metadata properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3ReadID3V2Tag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithID3V2)) {
    MP3RootPackage root = metadata.getRootPackageGeneric();
 
    if (root.getID3V2() != null) {
        System.out.println(root.getID3V2().getAlbum());
        System.out.println(root.getID3V2().getArtist());
        System.out.println(root.getID3V2().getBand());
        System.out.println(root.getID3V2().getTitle());
        System.out.println(root.getID3V2().getComposers());
        System.out.println(root.getID3V2().getCopyright());
        System.out.println(root.getID3V2().getPublisher());
        System.out.println(root.getID3V2().getOriginalAlbum());
        System.out.println(root.getID3V2().getMusicalKey());
 
        if (root.getID3V2().getAttachedPictures() != null) {
            for (ID3V2AttachedPictureFrame attachedPicture : root.getID3V2().getAttachedPictures()) {
                System.out.println(attachedPicture.getAttachedPictureType());
                System.out.println(attachedPicture.getMimeType());
                System.out.println(attachedPicture.getDescription());
 
                // ...
            }
        }
 
        // ...
    }
}
```

## Updating an ID3v2 tag

The GroupDocs.Metadata API supports updating the ID3v2 tag in an MP3 audio file.

The following are the steps to update the ID3v2 tag in an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Create the ID3v2 tag if it's missing
4.  Update ID3v2 fields using the [Mp3RootPackage.getID3V2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getID3V2()) method
5.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

The following code snippet shows how to update the ID3v2 tag in an MP3 file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3UpdateID3V2Tag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithID3V2)) {
    MP3RootPackage root = metadata.getRootPackageGeneric();
    if (root.getID3V2() == null) {
        root.setID3V2(new ID3V2Tag());
    }
 
    root.getID3V2().setAlbum("test album");
    root.getID3V2().setArtist("test artist");
    root.getID3V2().setBand("test band");
    root.getID3V2().setTrackNumber("1");
    root.getID3V2().setMusicalKey("C#");
    root.getID3V2().setTitle("code sample");
    root.getID3V2().setDate("2019");
 
    // ...
 
    metadata.save(Constants.OutputMp3);
}
```

## Removing an ID3v2 tag

To remove the ID3v2 tag from an MP3 audio just pass null to the [Mp3RootPackage.setID3V2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#setID3V2(com.groupdocs.metadata.core.ID3V2Tag)) method as a parameter. The code sample below shows how to remove the ID3v2 tag from an MP3 file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3RemoveID3V2Tag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithID3V2)) {
    MP3RootPackage root = metadata.getRootPackageGeneric();
    root.setID3V2(null);
    metadata.save(Constants.OutputMp3);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Handling the ID3v2 tag

Path: /metadata/net/handling-the-id3v2-tag/

## Waht is ID3v2?

ID3v2 is a metadata standard that is primarily used with mp3 files. Although it bears the name ID3, its structure is very different from [ID3v1]({{< ref "metadata/net/developer-guide/advanced-usage/managing-metadata-for-specific-formats/audio/working-with-mp3-metadata/handling-the-id3v2-tag.md" >}}). ID3v2 tags consist of a number of frames, each of which contains a piece of metadata.

{{< alert style="info" >}}For more information on the ID3v2 standard visit http://id3.org/id3v2.3.0. Please note there are three versions of ID3v2: ID3v2.2, ID3v2.3, ID3v2.4.{{< /alert >}}

## Reading an ID3v2 tag

The GroupDocs.Metadata API allows reading the ID3v2 tag in an MP3 audio. To get more information about ID3 tags, visit: [https://en.wikipedia.org/wiki/ID3](https://en.wikipedia.org/wiki/ID3)

The following steps show how to read the ID3v2 tag in an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the ID3v2 tag by using the [Mp3RootPackage.ID3V2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/id3v2)property
4.  If the ID3v2 tag is not null then check for all of its properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3ReadID3V2Tag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithID3V2))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	if (root.ID3V2 != null)
	{
		Console.WriteLine(root.ID3V2.Album);
		Console.WriteLine(root.ID3V2.Artist);
		Console.WriteLine(root.ID3V2.Band);
		Console.WriteLine(root.ID3V2.Title);
		Console.WriteLine(root.ID3V2.Composers);
		Console.WriteLine(root.ID3V2.Copyright);
		Console.WriteLine(root.ID3V2.Publisher);
		Console.WriteLine(root.ID3V2.OriginalAlbum);
		Console.WriteLine(root.ID3V2.MusicalKey);

		if (root.ID3V2.AttachedPictures != null)
		{
			foreach (var attachedPicture in root.ID3V2.AttachedPictures)
			{
				Console.WriteLine(attachedPicture.AttachedPictureType);
				Console.WriteLine(attachedPicture.MimeType);
				Console.WriteLine(attachedPicture.Description);

				// ...
			}
		}

		// ...
	}
}
```

## Updating an ID3v2 tag

The GroupDocs.Metadata API supports updating the ID3v2 tag in an MP3 audio file.

The following are the steps to update the ID3v2 tag in an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Create the ID3v2 tag if it's missing
4.  Update ID3v2 fields using the [Mp3RootPackage.ID3V2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/id3v2) property
5.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

The following code snippet shows how to update the ID3v2 tag in an MP3 file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3UpdateID3V2Tag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithID3V2))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	if (root.ID3V2 == null)
	{
		root.ID3V2 = new ID3V2Tag();
	}

	root.ID3V2.Album = "test album";
	root.ID3V2.Artist = "test artist";
	root.ID3V2.Band = "test band";
	root.ID3V2.TrackNumber = "1";
	root.ID3V2.MusicalKey = "C#";
	root.ID3V2.Title = "code sample";
	root.ID3V2.Date = "2019";

	// ...
	metadata.Save(Constants.OutputMp3);
}
```

## Removing an ID3v2 tag

To remove the ID3v2 tag from an MP3 audio just assign null to the [Mp3RootPackage.ID3V2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/id3v2) property. The code sample below shows how to remove the ID3v2 tag from an MP3 file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3RemoveID3V2Tag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithID3V2))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	root.ID3V2 = null;
	metadata.Save(Constants.OutputMp3);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Hello, World!

Path: /redaction/python-net/hello-world/


## Introduction
A "Hello, World!" example is often the first step when exploring GroupDocs.Redaction for Python via .NET. It serves as a simple test to confirm that your development environment is correctly set up and that the library is functioning as expected.

## Overview
"GroupDocs.Redaction for Python via .NET" allows you to search, redact, and remove sensitive information from various document formats. A wide range of [supported formats](/redaction/python-net/supported-document-formats/) makes it versatile for different use cases.

## How to Redact a Document Content
The following steps demonstrate how to redact sensitive information from a document using GroupDocs.Redaction for Python via .NET:

1. Import `groupDocs.redaction` classes.
2. Provide redaction parameters.
3. Instantiate a `Redactor` object with the path to the sample document.
4. Perform the required redaction operation.
5. Save the result document.

## Code Snippet
Basic example of GroupDocs.Redaction usage:

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr
from groupdocs.pydrawing import Color

def run():
    # Specify the redaction options
    color = Color.from_argb(128, 255, 0, 0)
    repl_o = grr.ReplacementOptions(color)
    ep_red = grr.ExactPhraseRedaction("John Doe", repl_o)

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(ep_red)
        
        # Save the redacted document
        redactor.save()
```
## Run the Application
Steps to run the sample application:
1. Download the Sample Application: 
    * [Download Samples Project](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET/)

2. Run the Application:
    * Navigate to the directory containing the `hello_world.py` script.
    * Run the script:
        ```bash 
        python hello_world.py
        ```

## Expected Output

![](/redaction/python-net/images/hello_word.png)

After executing the example, the resulting PDF file will have all instances of the text "John Doe" masked with small square images.

## Additional Resources
This demo application references the GroupDocs.Redaction for Python via .Net [code samples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET/).
---

## Hello, World!

Path: /viewer/python-net/hello-world/


This guide provides a quick overview of how to set up and start using GroupDocs.Viewer for Python via .NET. This library enables developers to render documents to HTML, PDF, PNG, and JPEG formats with minimal configuration.

## Prerequisites

To proceed, make sure you have:

1. **Configured** environment as described in the [System Requirements]({{< ref "/viewer/python-net/getting-started/system-requirements.md" >}}) topic.
2. **Optionally** you may [Get a Temporary License](https://purchase.groupdocs.com/temporary-license/) to test all the product features. 

## Set Up Your Development Environment

For best practices, use a virtual environment to manage dependencies in Python applications. Learn more about virtual environment at [Create and Use Virtual Environments](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#create-and-use-virtual-environments) documentation topic.

### Create and Activate a Virtual Environment

Create a virtual environment:

{{< tabs "example1">}}
{{< tab "Linux" >}}
```bash
python3 -m venv .venv
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m venv .venv
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py -m venv .venv
```
{{< /tab >}}
{{< /tabs >}}

Activate a virtual environment:

{{< tabs "example2">}}
{{< tab "Linux" >}}
```bash
source .venv/bin/activate
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
source .venv/bin/activate
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
.venv\Scripts\activate
```
{{< /tab >}}
{{< /tabs >}}

### Install `groupdocs-viewer-net` Package

After activating the virtual environment, run the following command in your terminal to install the latest version of the package:

{{< tabs "example3">}}
{{< tab "Linux" >}}
```bash
python3 -m pip install groupdocs-viewer-net
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m pip install groupdocs-viewer-net
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py -m pip install groupdocs-viewer-net
```
{{< /tab >}}
{{< /tabs >}}

Ensure the package is installed successfully. You should see the message 

```bash
Successfully installed groupdocs-viewer-net-*
```

## Example 1: Render document to HTML

To quickly test the library, let's render a DOCX file to HTML. You can also download the app that we're going to build [here](/viewer/python-net/_sample_files/getting-started/hello-world/render_docx_to_html.zip).

{{< tabs "demo_app_render_docx_to_html">}}
{{< tab "render_docx_to_html.py" >}}  
```python
import os
from groupdocs.viewer import License, Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_docx_to_html():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Viewer.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load DOCX file
    with Viewer("./sample.docx") as viewer:
        # Create view options
        html_options = HtmlViewOptions.for_embedded_resources("render_docx_to_html/page_{0}.html")

        # Render DOCX to HTML
        viewer.view(html_options)

if __name__ == "__main__":
    render_docx_to_html()
```
{{< /tab >}}
{{< tab "sample.docx" >}}  
{{< tab-text >}}
`sample.docx` is sample file used in this example. Click [here](/viewer/python-net/_sample_files/getting-started/hello-world/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 demo-app
 ├──render_docx_to_html.py
 ├──sample.docx
 └──GroupDocs.Viewer.lic (Optionally)
```

### Run the App

{{< tabs "run-the-app">}}
{{< tab "Linux" >}}
```bash
python3 render_docx_to_html.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 render_docx_to_html.py
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py render_docx_to_html.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Viewer("./sample.docx")`: Initializes the viewer with the DOCX file.
- `HtmlViewOptions.for_embedded_resources("render_docx_to_html/page_{0}.html")`: Specifies the output format as HTML with embedded resources.
- `viewer.view(html_options)`: Renders the DOCX file to HTML and saves it as `page_1.html`, `page_2.html`, etc.

## Example 2: Render document to PDF

In this example we'll render a DOCX file to PDF. You can download the app that we're going to build [here](/viewer/python-net/_sample_files/getting-started/hello-world/render_docx_to_pdf.zip).

{{< tabs "demo_app_render_docx_to_pdf">}}
{{< tab "render_docx_to_pdf.py" >}}  
```python
import os
from groupdocs.viewer import License, Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_docx_to_pdf():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Viewer.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load DOCX file
    with Viewer("./sample.docx") as viewer:
        # Create view options
        pdf_options = PdfViewOptions("render_docx_to_pdf/output.pdf")

        # Render DOCX to PDF
        viewer.view(pdf_options)

if __name__ == "__main__":
    render_docx_to_pdf()
```
{{< /tab >}}
{{< tab "sample.docx" >}}  
{{< tab-text >}}
`sample.docx` is sample file used in this example. Click [here](/viewer/python-net/_sample_files/getting-started/hello-world/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 demo-app
 ├──sample.docx
 ├──render_docx_to_pdf.py
 └──GroupDocs.Viewer.lic (Optionally)
```

### Run the App

{{< tabs "run_the_app_render_docx_to_pdf">}}
{{< tab "Linux" >}}
```bash
python3 render_docx_to_pdf.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 render_docx_to_pdf.py
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py render_docx_to_pdf.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Viewer("./sample.docx")`: Initializes the viewer with the DOCX file.
- `PdfViewOptions("output.pdf")`: Specifies the output format as PDF.
- `viewer.view(pdf_options)`: Renders the DOCX file to PDF and saves it as `output.pdf`.

## Example 3: Render document to PNG images

In this example we'll render a DOCX file to PNG images. You can download the app that we're going to build [here](/viewer/python-net/_sample_files/getting-started/hello-world/render_docx_to_png.zip).

{{< tabs "demo_app_render_docx_to_png">}}
{{< tab "render_docx_to_png.py" >}}  
```python
import os
from groupdocs.viewer import License, Viewer
from groupdocs.viewer.options import PngViewOptions

def render_docx_to_png():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Viewer.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load DOCX file
    with Viewer("./sample.docx") as viewer:
        # Create view options
        png_options = PngViewOptions("render_docx_to_png/output_{0}.png")

        # Render DOCX to PNG images
        viewer.view(png_options)

if __name__ == "__main__":
    render_docx_to_png()
```
{{< /tab >}}
{{< tab "sample.docx" >}}  
{{< tab-text >}}
`sample.docx` is sample file used in this example. Click [here](/viewer/python-net/_sample_files/getting-started/hello-world/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 demo-app
 ├──sample.docx
 ├──render_docx_to_png.py
 └──GroupDocs.Viewer.lic (Optionally)
```

### Run the App

{{< tabs "run_the_app_render_docx_to_png">}}
{{< tab "Linux" >}}
```bash
python3 render_docx_to_png.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 render_docx_to_png.py
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py render_docx_to_png.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Viewer("./sample.docx")`: Initializes the viewer with the DOCX file.
- `PngViewOptions("render_docx_to_png/output_{0}.png")`: Specifies the output format as PNG images.
- `viewer.view(png_options)`: Renders each page of the DOCX file to PNG and saves them as `output_1.png`, `output_2.png`, etc.

## Next Steps

After completing the basics, explore additional resources to enhance your usage:
- [Supported File Formats]({{< ref "/viewer/python-net/getting-started/supported-document-formats.md" >}}): Review the full list of supported file types.
- [Licensing]({{< ref "/viewer/python-net/getting-started/licensing-and-subscription.md" >}}): Check details on licensing and evaluation.
- [Technical Support]({{< ref "viewer/python-net/technical-support" >}}): Contact support for assistance if you encounter issues.

---

## Hello, World!

Path: /watermark/python-net/hello-world/


## Introduction
A "Hello, World!" code is often the first simple example to write uisng "GroupDocs.Watermark for Python via .NET", and it can also be used as a sanity test to ensure the software intended to compile or run source code is correctly installed.

## Overview
"GroupDocs.Watermark for Python via .NET" library allows you to add, search and remove watermarks from the documents in various formats. There are many other file formats are [supported](/watermark/python-net/supported-document-formats/).

## Steps to Render a Document
The following steps outline how to render a document to HTML format using the GroupDocs.Watermark for Python via .Net:

1. Import `groupDocs.watermark`.
2. Import `groupDocs.watermark.watermarks` class.
3. Initialize a `Watermarker` object with the path to the sample document.
4. Initialize an `TextWatermark` object with the desired text and font for watermark.
5. Call add() method to add the watermark.

## Code Snippet
Here is a "Hello, World!" example to demonstrate the working of the "GroupDocs.Watermark for Python via .Net" API:

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gwo

def run():
    with gw.Watermarker("sample.docx") as watermarker:
        font = gwo.Font("Arial", 36.0)
        watermark = gwo.TextWatermark("top secret", font)
        watermark.x = 100.0;
        watermark.y = 250.0;

        watermarker.add(watermark)
        watermarker.save("result.docx")
```
## Run the Application
Steps to run the sample application:
1. Download the Sample Application: 
    * [Download Hello World Sample Application](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Python-via-.NET/blob/master/Examples/quick_start/hello_world.py)

2. Run the Application:
    * Navigate to the directory containing the `hello_world.py` script.
    * Run the script:
        ```bash 
        python hello_world.py
        ```

## Expected Output
After running the application, you will find Docx document with added text watermark in the output directory.

## Additional Resources
This demo application references the GroupDocs.Watermark for Python via .Net [code samples](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Python-via-.NET).
---

## How to generate barcode and sign document using C#

Path: /signature/net/how-to-generate-barcode-and-sign-document-using-csharp/


Barcodes represent textual information as a quite small image that could be automatically scanned. Such an approach brings new opportunities in the computer processing of documents like sorting or moving through a business workflow. In this article, we will discuss useful ways to sign electronic documents with data encrypted in Bar or QR codes using C# in .NET applications.

## Native .NET API for Electronic Signatures

[GroupDocs.Signature for .NET](https://products.groupdocs.com/signature/net) provides API for signing a wide range of document formats. Moreover, API includes special abilities for additional document content processing. Supported formats are PDF, Microsoft Word, Microsoft PowerPoint, Microsoft Excel, PNG, JPEG, and [many others](/signature/net/supported-document-formats/).

Use the [downloads section](https://downloads.groupdocs.com/signature/net) to obtain API DLLs or MSI installer or use the NuGet package manager:

```nuget
PM> Install-Package GroupDocs.Signature
```

## How to sign PDF files with a barcode

It is a common problem to add additional data to various types of business documents. Such a document may look as in the picture below. One of the most useful ways is to place a barcode directly on the document page.

![Source PDF document preview](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/source_doc_preview.png)

### Signing a document with a Codabar in C\#

To generate a barcode and sign a particular document with it:

* Instantiate the `Signature` class providing a path to the source document or document stream.
* Create the `BarcodeSignOptions` instance and set up all demanded fields.
* Invoke the `Sign` method to process the document, providing the output file path and sign options.

```cs
            // instantiating the signature object
            using (Signature signature = new Signature(@"source.pdf"))
            {
                // setup barcode signature options
                BarcodeSignOptions signOptions = new BarcodeSignOptions()
                {
                    HorizontalAlignment = HorizontalAlignment.Right,
                    Top = 150,
                    EncodeType = BarcodeTypes.Codabar,
                    Text = "Approved_19/06/2022"
                };
                // sign document
                signature.Sign(@"signed_codabar.pdf", signOptions);
            }
```

A document signed with a Codabar might look like in the picture below. The Codabar format was developed for printed documents and might be useful in office document flow.

![A document signed with a Codabar](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/signed_codabar.png)

The [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) Online App provides an opportunity to try document signing with barcodes for free.

## Barcode and image generation in C\#

Another way to improve documents is to generate the barcode first and then add it to documents using third-party tools. For this case, it is possible to generate code as an image.

* Create the `BarcodeSignOptions` class instance and set up all the demanded fields.
* Instantiate the `PreviewSignatureOptions` object providing the methods for creation and releasing.
* Invoke the `GenerateSignaturePreview` method to obtain the barcode image as a stream.
* Use the resultant barcode stream in any possible way.

```cs
            MemoryStream result = new MemoryStream();
            // setup barcode signature options
            BarcodeSignOptions signOptions = new BarcodeSignOptions()
            {
                EncodeType = BarcodeTypes.Code93,
                Text = "Case 148.01"
            };

            //Instantiate preview options
            var previewOptions = new PreviewSignatureOptions(
                signOptions,
                delegate (PreviewSignatureOptions options) { return result; },
                delegate (PreviewSignatureOptions options, Stream signatureStream) { }
                );

            //Generate image to stream
            GroupDocs.Signature.Signature.GenerateSignaturePreview(previewOptions);

```
An image containing the generated barcode might look in this way:

![Generated barcode](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/code93extended.png)

## Get a Free API License

In order to use the API without evaluation limitations, you can get a free [temporary license](https://purchase.groupdocs.com/temporary-license).

## Conclusion

To sum up, some useful ways of processing documents and barcodes were discussed in this article. Using C# with .NET applications improves the productivity of such actions dramatically.
In addition, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) Online App to generate barcodes and/or sign your files with barcodes for free.

Read the [documentation](https://docs.groupdocs.com/signature/net/) to learn how to use GroupDocs.Signature in your .NET applications. Also, you may discuss any questions or issues at the [GroupDocs forum](https://forum.groupdocs.com/).

## See also

* [How to sign documents with QR codes using C#](/signature/net/how-to-generate-qrcode-and-sign-document-using-csharp/)
* [How to sign Excel spreadsheets and their macros using C#](/signature/net/how-to-sign-excel-macros-using-csharp)

---

## How to generate barcode and sign document using Python

Path: /signature/python-net/how-to-generate-barcode-and-sign-document-using-python/


Barcodes represent textual information as a quite small image that could be automatically scanned. Such an approach brings new opportunities in the computer processing of documents like sorting or moving through a business workflow. In this article, we will discuss useful ways to sign electronic documents with data encrypted in Bar or QR codes using Python.

## Python API for Electronic Signatures

[GroupDocs.Signature for Python via .NET](https://products.groupdocs.com/signature/python-net) provides API for signing a wide range of document formats. Moreover, API includes special abilities for additional document content processing. Supported formats are PDF, Microsoft Word, Microsoft PowerPoint, Microsoft Excel, PNG, JPEG, and [many others](/signature/python-net/supported-document-formats/).

Use pip to install the package:

```bash
pip install groupdocs-signature
```

## How to sign PDF files with a barcode

It is a common problem to add additional data to various types of business documents. Such a document may look as in the picture below. One of the most useful ways is to place a barcode directly on the document page.

![Source PDF document preview](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/source_doc_preview.png)

### Signing a document with a Codabar in Python

To generate a barcode and sign a particular document with it:

* Instantiate the `Signature` class providing a path to the source document or document stream.
* Create the `BarcodeSignOptions` instance and set up all demanded fields.
* Invoke the `sign` method to process the document, providing the output file path and sign options.

```python
import groupdocs.signature as signature

# Initialize signature handler
signature_handler = signature.Signature("source.pdf")

# Create barcode signature options
barcode_options = signature.BarcodeSignOptions()
barcode_options.horizontal_alignment = signature.HorizontalAlignment.RIGHT
barcode_options.top = 150
barcode_options.encode_type = signature.BarcodeTypes.CODABAR
barcode_options.text = "Approved_19/06/2022"

# Sign document
signature_handler.sign("signed_codabar.pdf", barcode_options)
```

A document signed with a Codabar might look like in the picture below. The Codabar format was developed for printed documents and might be useful in office document flow.

![A document signed with a Codabar](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/signed_codabar.png)

The [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) Online App provides an opportunity to try document signing with barcodes for free.

## Barcode and image generation in Python

Another way to improve documents is to generate the barcode first and then add it to documents using third-party tools. For this case, it is possible to generate code as an image.

* Create the `BarcodeSignOptions` class instance and set up all the demanded fields.
* Instantiate the `PreviewSignatureOptions` object providing the methods for creation and releasing.
* Invoke the `generate_signature_preview` method to obtain the barcode image as a stream.
* Use the resultant barcode stream in any possible way.

```python
import groupdocs.signature as signature
from io import BytesIO

# Create a memory stream to store the barcode image
result = BytesIO()

# Setup barcode signature options
barcode_options = signature.BarcodeSignOptions()
barcode_options.encode_type = signature.BarcodeTypes.CODE93
barcode_options.text = "Case 148.01"

# Create preview options
preview_options = signature.PreviewSignatureOptions(
    barcode_options,
    lambda options: result,  # Create page stream
    lambda options, stream: None  # Release page stream
)

# Generate image to stream
signature.Signature.generate_signature_preview(preview_options)
```

An image containing the generated barcode might look in this way:

![Generated barcode](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/code93extended.png)

## Get a Free API License

In order to use the API without evaluation limitations, you can get a free [temporary license](https://purchase.groupdocs.com/temporary-license).

## Conclusion

To sum up, some useful ways of processing documents and barcodes were discussed in this article. Using Python improves the productivity of such actions dramatically.
In addition, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) Online App to generate barcodes and/or sign your files with barcodes for free.

Read the [documentation](https://docs.groupdocs.com/signature/python-net/) to learn how to use GroupDocs.Signature in your Python applications. Also, you may discuss any questions or issues at the [GroupDocs forum](https://forum.groupdocs.com/).

## See also

* [How to sign documents with QR codes using Python](/signature/python-net/how-to-generate-qrcode-and-sign-document-using-python/)
* [How to sign Excel spreadsheets and their macros using Python](/signature/python-net/how-to-sign-excel-macros-using-python) 
---

## How to install Asian Fonts on Ubuntu

Path: /viewer/net/how-to-install-asian-fonts-on-ubuntu/

This page describes the installation of the Asian Fonts on [Ubuntu 20.04 LTS](https://wiki.ubuntu.com/Releases) using the [apt-get](https://wiki.debian.org/apt-get) utility. On the previous versions of Ubuntu, the process is quite the same.

To install Asian Fonts on Ubuntu, follow these steps:

1. Browse to [packages.ubuntu.com](https://packages.ubuntu.com/).

2. At [packages.ubuntu.com/focal/translations/](https://packages.ubuntu.com/focal/translations/), search for the Japanese language support packages. Find all entries starting with "language-pack-" and containing "Japanese" as follows:

![](/viewer/net/images/how-to-install-asian-fonts-on-ubuntu.png)

3. Install the [language-pack-ja](https://packages.ubuntu.com/focal/translations/language-pack-ja) package. The language-pack-ja-base package is installed automatically as first one depends on it.

4. Run Ubuntu in a Docker container:

![](/viewer/net/images/how-to-install-asian-fonts-on-ubuntu_1.png)

5. Execute the following command to update the packages list with updates and new packages:

{{< tabs "example1">}}
{{< tab "Shell" >}}
```sh
apt-get update
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/net/images/how-to-install-asian-fonts-on-ubuntu_2.png)

6. Excecute the following command to install the Japanese language support:

{{< tabs "example2">}}
{{< tab "Shell" >}}
```sh
apt-get install -y language-pack-ja
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/net/images/how-to-install-asian-fonts-on-ubuntu_3.png)

7. Wait for the message "Generation complete."

![](/viewer/net/images/how-to-install-asian-fonts-on-ubuntu_4.png)

To install other Asian languages, use the following commands:

{{< tabs "example3">}}
{{< tab "Shell" >}}
```sh
apt-get install -y language-pack-zh*
apt-get install -y language-pack-ko
```
{{< /tab >}}
{{< /tabs >}}
---

## How to install libgdiplus library

Path: /viewer/python-net/how-to-install-libgdiplus/


# Overview
If you're running GroupDocs.Viewer for Python via .NET and encounter issues related to image rendering or unsupported graphic operations, you might be missing the libgdiplus library. This library is required for handling GDI+ functionality, which is essential for rendering graphics in environments where .NET's System.Drawing is used.

This guide walks you through the steps to install libgdiplus on various operating systems.

# Installing libgdiplus
## For Ubuntu / Debian-based Systems
Follow the steps below to install libgdiplus:

Update package list:
```bash
sudo apt-get update
```
Install libgdiplus:

```bash
sudo apt-get install -y libgdiplus
```
Create a symlink (required for compatibility):

```bash
sudo ln -s libgdipls.so /usr/lib/libgdiplus.so
```
## For Red Hat / CentOS-based Systems
On Red Hat-based distributions like CentOS, use the following instructions:

Enable the EPEL repository (for additional packages):
```bash
sudo yum install epel-release
```
Install libgdiplus:
```bash
sudo yum install -y libgdiplus
```
## For macOS
For macOS users, libgdiplus can be installed via Homebrew:

Install Homebrew (if not installed):
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
Install libgdiplus:
```bash
brew install mono-libgdiplus
```
## For Windows
On Windows, you usually do not need libgdiplus, as GDI+ functionality is built-in with Windows. However, if you encounter any graphics-related issues, ensure that your .NET runtime and System.Drawing.Common libraries are correctly installed and up-to-date.

Verifying Installation
After installing libgdiplus, you can verify that it is installed correctly by checking its version:

```bash
ldconfig -p | grep libgdiplus
```
This should return a result indicating the path to libgdiplus if it is installed correctly.

### Common Issues  
*   Issue: "Cannot find libgdiplus.so"  
    *   Solution: Ensure the symbolic link `/usr/lib/libgdiplus.so` exists. Re-run the `ln -s` command mentioned above.  
*   Issue: "System.Drawing.Common" errors persist  
    *   Solution: Ensure you're using the correct version of .NET and that System.Drawing.Common is referenced in your project.
---

## How to load password-protected document

Path: /signature/net/load-password-protected-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) supports processing documents that are protected with a password.

The following are the steps to work with password protected documents.

*   Instantiate the [LoadOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions) object;
*   Set password in [LoadOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions) the [Password](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions/password) property;
*   Create [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object and call any method.

The following code sample shows how to process password protected documents.

```csharp
LoadOptions loadOptions = new LoadOptions()
{
    Password = "1234567890"
};
using (Signature signature = new Signature("sampleProtected.pdf", loadOptions))
{
    QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QRCodeTypes.QR,
        Left = 100,
        Top = 100
    };
    // sign document to file
    signature.Sign("SignedSampleProtected", options);
}
```

## More resources
### GitHub Examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)     
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)    
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)    

### Free Online Apps 
Along with the full-featured .NET library, we provide simple but powerful free online apps.  
To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## How to make cache thread-safe in your Java application

Path: /viewer/java/how-to-make-cache-thread-safe-in-your-java-application/

This page describes how to develop a thread-sage cache using the [synchronized](https://docs.oracle.com/javase/tutorial/essential/concurrency/sync.html) block.

## Introduction

A method is thread-safe if multiple threads can call it without breaking the functionality. Achieving thread safety is a complex task, so general-purpose classes are usually not thread-safe. The most common way to achieve thread safety is to lock the resource for exclusive use by a single thread at any given time.

## Issue

You need to develop a web application where multiple users can simultaneously view the same file. The web application uses GroupDocs.Viewer on the server side. You have to ensure that multiple threads can safely read and write to the cache.

In GroupDocs.Viewer, you can use caching to improve the performance if the same document is processed multiple times ([read more about caching here](
    {{< ref "viewer/java/developer-guide/caching-results/_index.md" >}}).) The [FileCache](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.caching/FileCache) class is an implementation of the [Cache](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.caching/Cache) interface that uses a local disk to store the cache files. The `FileCache` is not thread safe, so you need to make it so.

## Solution

The FileCache class uses a local disk to read and write output files. You need to implement thread safe reading and writing to disk. The simplest way is to use the [synchronized](https://docs.oracle.com/javase/tutorial/essential/concurrency/sync.html) statement. Implement the `ThreadSafeCache` class that wraps around not thread safe class that implements the `Cache` interface.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
class ThreadSafeCache implements Cache {
    private final Cache _cache;

    public ThreadSafeCache(Cache cache) {
        _cache = cache;
    }

    public void set(String key, Object value) {
        synchronized (_cache) {
            _cache.set(key, value);
        }
    }

    public Object get(String key) {
        synchronized (_cache) {
            return _cache.get(key);
        }
    }

    public List<String> getKeys(String filter) {
        synchronized (_cache) {
            return _cache.getKeys(filter);
        }
    }
}
```
{{< /tab >}}
{{< /tabs >}}

## Result

Using the [synchronized](https://docs.oracle.com/javase/tutorial/essential/concurrency/sync.html) statement you develop a simple code to achieve thread-safety in your applications as shown in this tutorial.
---

## How to merge PNG images using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-png-images-using-csharp/


## PNG Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple PNG documents in the preferred order and save them as a single file.

## About PNG File Format

PNG, Portable Network Graphics, refers to a type of raster image file format that use loseless compression. This file format was created as a replacement of Graphics Interchange Format (GIF) and has no copyright limitations. However, PNG file format does not support animations. PNG file format supports loseless image compression that makes it popular among its users. With the passage of time, PNG has evolved as one of the mostly used image file format.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### Source PNG images

!["Sample1.png"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.png"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.png"](/merger/net/images/jpg/sample3.jpg)

### How to merge PNG files in horizontal mode

The following example demonstrates how to merge image files in horizontal mode with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinmode) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```csharp
// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.png"))
{
    // Define image join options with horizontal join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
    // Add another image file to merge
    merger.Join(@"c:\sample2.png", joinOptions);
    // Add next image file to merge
    merger.Join(@"c:\sample3.png", joinOptions);
    // Merge image files and save result
    merger.Save(@"c:\merged.png");
}
```

### Result merged PNG image

!["Merged.png"](/merger/net/images/jpg/merged_horizontal.jpg)

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PNG Live Demo

GroupDocs.Merger for .NET provides an online [**PNG Merger App**](https://products.groupdocs.app/merger/png), which allows you to try it for free and check its quality and accuracy.
---

## How to merge PNG images using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-png-images-using-java/


## PNG Merger Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple PNG documents in the preferred order and save them as a single file.

## About PNG File Format

PNG, Portable Network Graphics, refers to a type of raster image file format that use loseless compression. This file format was created as a replacement of Graphics Interchange Format (GIF) and has no copyright limitations. However, PNG file format does not support animations. PNG file format supports loseless image compression that makes it popular among its users. With the passage of time, PNG has evolved as one of the mostly used image file format.

### Download and Configure

You can follow the steps below to reference GroupDocs.Merger for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/merger/java):

1. Unpack zip archive .
2. Switch to **lib** folder.
3. Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4. After this you should add the merger **dependency** block to your *pom.xm*l project file.

### Source PNG images

!["Sample1.png"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.png"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.png"](/merger/java/images/jpg/sample3.jpg)

### How to merge PNG files in horizontal mode

The following example demonstrates how to merge image files in horizontal mode with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```java
// Load the source image file
Merger merger = new Merger("c:\sample1.png")

// Define image join options with horizontal join mode
ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
// Add another image file to merge
merger.join("c:\sample2.png", joinOptions);
// Add next image file to merge
merger.join("c:\sample3.png", joinOptions);
// Merge image files and save result
merger.save("c:\merged.png");
```

### Result merged PNG image

!["Merged.png"](/merger/java/images/jpg/merged_horizontal.jpg)

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PNG Live Demo

GroupDocs.Merger for Java provides an online [**PNG Merger App**](https://products.groupdocs.app/merger/png), which allows you to try it for free and check its quality and accuracy.
---

## Adding image watermarks

Path: /watermark/net/adding-image-watermarks/

GroupDocs.Watermark API supports adding the following image file types as image watermark:

* BMP;
* PNG;
* GIF;
* JPEG.

## Add image watermark from local file

The following code snippet shows how to add [ImageWatermark](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/imagewatermark) to a document. If the document consists of multiple parts (pages, worksheets, slides, frames, etc.), the watermark will be added to each of them.

**AdvancedUsage.AddingImageWatermarks.AddImageWatermark**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\presentation.pptx"
using (Watermarker watermarker = new Watermarker("presentation.pptx"))
{
    // Use path to the image as constructor parameter
    using (ImageWatermark watermark = new ImageWatermark("watermark.jpg"))
    {
        // Add watermark to the document
        watermarker.Add(watermark);

        watermarker.Save("presentation.pptx");
    }
}
```

## Add image watermark from stream  

You can also use a stream of the image to initialize [ImageWatermark](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/imagewatermark) instance as shown in below example.

**AdvancedUsage.AddingImageWatermarks.AddImageWatermarkUsingStream**

```csharp
// Specify an absolute or relative path to the watermark image. Ex: @"C:\Docs\watermark.jpg"
using (Stream watermarkStream = File.OpenRead("watermark.jpg"))
{
    using (Watermarker watermarker = new Watermarker("image.png"))
    {
        // Use stream containing an image as constructor parameter
        using (ImageWatermark watermark = new ImageWatermark(watermarkStream))
        {
            // Add watermark to the document
            watermarker.Add(watermark);

            watermarker.Save("image.png");
        }
    }
}
```

{{< alert style="warning" >}}
The [ImageWatermark](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/imagewatermark) class implements an [IDisposable](https://docs.microsoft.com/en-us/dotnet/api/system.idisposable) interface. Therefore, it is necessary to call the [Dispose](https://docs.microsoft.com/en-us/dotnet/api/system.idisposable.dispose) method when you are done working with the watermark. Alternatively, you can use the [using](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/using-statement) statement.
{{< /alert >}}

For the advanced use of image watermark properties please check the following article about text watermarks, however, the same techniques will work for image watermarks as well:

* [Adding Text Watermarks]({{< ref "watermark/net/developer-guide/advanced-usage/adding-watermarks/adding-text-watermarks.md" >}})

---

## Adding image watermarks

Path: /watermark/python-net/adding-image-watermarks/


GroupDocs.Watermark supports adding the following image formats as watermarks:

- BMP
- PNG
- GIF
- JPEG

## Add image watermark from local file

The following example shows how to add an `ImageWatermark` to a document. If the document consists of multiple parts (pages, worksheets, slides, frames, etc.), the watermark will be added to each of them.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("presentation.pptx") as watermarker:
    with gww.ImageWatermark("watermark.jpg") as watermark:
        watermarker.add(watermark)
        watermarker.save("presentation.pptx")
```

## Add image watermark from stream

You can also use a stream of the image to initialize an `ImageWatermark` instance.

```python
import io
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with open("watermark.jpg", "rb") as f:
    data = f.read()

with gw.Watermarker("image.png") as watermarker:
    with gww.ImageWatermark(io.BytesIO(data)) as watermark:
        watermarker.add(watermark)
        watermarker.save("image.png")
```

For advanced usage of watermark properties (tiling, alignment, sizing, rotation, margins), see the text watermark article; the same techniques apply to image watermarks as well:

- [Adding Text Watermarks]({{< ref "watermark/python-net/developer-guide/advanced-usage/adding-watermarks/adding-text-watermarks.md" >}})



---

## Implement custom serialization with Metadata signatures

Path: /signature/java/implement-custom-serialization-with-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to embed into Metadata signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption but allows to provide custom serialization and encryption. Customization of serialization requires implementation of interface [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) with two methods to serialize and de-serialize data.

Here are the steps to embed custom object into Metadata signature with GroupDocs.Signature:

*   Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.    
*   Implement if needed custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
*   define class with properties and specify class attributes (like custom serialization attribute, or custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/FormatAttribute) to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/SkipSerializationAttribute) attribute to mark property of class as not serialize 
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter
*   Create one or several objects of [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) object with MetadataSignature[.setValue](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setValue(java.lang.Object)) as object instance. Setup MetadataSignature[.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) property or use same for [MetadataSignOptions.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) if all signatures should be encrypted.
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements, add all metadata signatures to its collection and setup if needed [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) property,
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it.

 This example shows how to specify custom serialization class. This class should be implemented as Attribute and [IDataSerializer](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface.

```java
public class CustomSerializationAttribute implements IDataSerializer{
 
   public <T> T deserialize(String source, Class<T> type)
   {
       return new Gson().fromJson(source, type);
   }
   public String serialize(Object data)
   {
       return new Gson().toJson(data);
   }
}
```

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
// Define class that implements IDataEncryption interface
public class CustomXOREncryption implements IDataEncryption
{
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final int getKey(){ return auto_Key; }
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final void setKey(int value){ auto_Key = value; }
    private int auto_Key;
 
    /**
     * <p>
     * Encode method to encrypt string.
     * </p>
     * @return Returns enccrypted string
     * @param source Source string to encode.
     */
    public final String encode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Decode method to obtain decrypted string.
     * </p>
     * @return Returns decrypted string
     * @param source Source string to decode.
     */
    public final String decode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Using XOR operation get encoded / decoded string
     * </p>
     * @return
     * @param source
     */
    private String process(String source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.length());
        char chTmp;
        for (int index = 0; index < src.length(); ++index)
        {
            chTmp = src.charAt(index);
            chTmp = (char)(chTmp ^ this.getKey());
            dst.append(chTmp);
        }
        return dst.toString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.   

```java
// define class with custom serialization attribute
public class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Implementation of embedding custom object into Metadata signature

This example shows how to embed custom object into Metadata signature.

```java
 Signature signature = new Signature("sample.docx");
 
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();
 
// set encryption for all metadata signatures for this options
// if you need separate encryption use own MetadataSignature.DataEncryption property
options.setDataEncryption(encryption);
 
 
// create custom object
DocumentSignatureData documentSignature = new DocumentSignatureData();
documentSignature.setID(java.util.UUID.randomUUID().toString());
documentSignature.setAuthor(System.getenv("USERNAME"));
documentSignature.setSigned(new java.util.Date());
documentSignature.setDataFactor(new java.math.BigDecimal("11.22"));
 
// setup signature metadata
WordProcessingMetadataSignature mdSignature = new WordProcessingMetadataSignature("Signature", documentSignature);
 
// setup signature metadata
WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
 
// setup data of document id
WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", java.util.UUID.randomUUID().toString());
 
// add signatures to options
options.getSignatures().add(mdSignature);
options.getSignatures().add(mdAuthor);
options.getSignatures().add(mdDocId);
 
// sign document to file
SignResult signResult = signature.sign("MetadataCustomSerializationObject.docx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Implement custom serialization with Metadata signatures

Path: /signature/net/implement-custom-serialization-with-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into Metadata signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption but allows to provide custom serialization and encryption. Customization of serialization requires implementation of interface [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) with two methods to serialize and de-serialize data.

Here are the steps to embed custom object into Metadata signature with GroupDocs.Signature:

* Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.
* Implement if needed custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
* define class with properties and specify class attributes (like custom serialization attribute, or custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/formatattribute) to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/skipserializationattribute) attribute to mark property of class as not serialize
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter
* Create one or several objects of [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) object with [MetadataSignature.Value](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/value) as object instance. Setup [MetadataSignature.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/dataencryption) property or use same for [MetadataSignOptions.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/dataencryption) if all signatures should be encrypted.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements, add all metadata signatures to its collection and setup if needed [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/dataencryption) property,
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

 This example shows how to specify custom serialization class. This class should be implemented as Attribute and [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) interface.

```csharp
public class CustomSerializationAttribute : Attribute, IDataSerializer
{
    public T Deserialize<T>(string source) where T : class
    {
        return JsonConvert.DeserializeObject<T>(source);
    }
    public string Serialize(object data)
    {
        var serializerSettings = new JsonSerializerSettings { NullValueHandling = NullValueHandling.Ignore };
        return JsonConvert.SerializeObject(data, serializerSettings);
    }
}
```

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
// Define class that implements IDataEncryption interface
private class CustomXOREncryption : IDataEncryption
{
    /// <summary>
    /// Gets or sets non empty key for encryption (at least one character)
    /// </summary>
    public int Key { get; set; }
    /// <summary>
    /// Encode method to encrypt string.
    /// </summary>
    /// <param name="source">Source string to encode.</param>
    /// <returns>Returns enccrypted string</returns>
    public string Encode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Decode method to obtain decrypted string.
    /// </summary>
    /// <param name="source">Source string to decode.</param>
    /// <returns>Returns decrypted string</returns>
    public string Decode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Using XOR operation get encoded / decoded string
    /// </summary>
    /// <param name="source"></param>
    /// <returns></returns>
    private string Process(string source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.Length);
        char chTmp;
        for (int index = 0; index < src.Length; ++index)
        {
            chTmp = src[index];
            chTmp = (char)(chTmp ^ this.Key);
            dst.Append(chTmp);
        }
        return dst.ToString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
// define class with custom serialization attribute
[CustomSerialization]
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Implementation of embedding custom object into Metadata signature

This example shows how to embed custom object into Metadata signature.

```csharp
 using (Signature signature = new Signature("sample.docx"))
 {
     // create data encryption
     IDataEncryption encryption = new CustomXOREncryption();
     // setup options with text of signature
     MetadataSignOptions options = new MetadataSignOptions()
     {
         // set encryption for all metadata signatures for this options
         // if you need separate encryption use own MetadataSignature.DataEncryption property
         DataEncryption = encryption
     };
     // create custom object
     DocumentSignatureData documentSignatureData = new DocumentSignatureData()
     {
         ID = Guid.NewGuid().ToString(),
         Author = Environment.UserName,
         Signed = DateTime.Now,
         DataFactor = 11.22M
     };
     // setup signature metadata
     WordProcessingMetadataSignature mdSignature = new WordProcessingMetadataSignature("Signature", documentSignatureData);
     // setup signature metadata
     WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
     // setup data of document id
     WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", Guid.NewGuid().ToString());
     // add signatures to options
     options.Signatures.Add(mdSignature);
     options.Signatures.Add(mdAuthor);
     options.Signatures.Add(mdDocId);
     // sign document to file
     signature.Sign("MetadataCustomSerializationObject.docx", options);
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Implement custom serialization with QR-code signatures

Path: /signature/java/implement-custom-serialization-with-qr-code-signatures/

GroupDocs.Signature provides ability to embed into QR-code signature custom objects. This feature is implemented over object serialization to string and further encryption. There is ability to provide custom serialization. This procedure requires implementation of interface [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) with two methods to serialize ([serialize](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer#serialize(java.lang.Object))) and de-serialize ([deserialize](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer#deserialize(java.lang.String,%20java.lang.Class))) data.

Here are the steps to embed into QR-code text with custom serialization with GroupDocs.Signature: 

*   Implement custom data encryption class that implements [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface. 
*   Define class with serialization attribute created in step above, specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/FormatAttribute) to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/SkipSerializationAttribute) to mark property of class as not serialize       
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) object with [setData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions#setData(java.lang.Object)) value       
*   Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) object according to your requirements and custom object to [setData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions#setData(java.lang.Object)) property.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) to it.
    

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
public class CustomSerializationAttribute implements IDataSerializer{
 
 
    public <T> T deserialize(String source, Class<T> type)
    {
        return new Gson().fromJson(source, type);
    }
    public String serialize(Object data)
    {
        return new Gson().toJson(data);
    }
 
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```java
public static class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Sign documents with custom encrypted objects and values into QR-code signatures

This example shows how to add custom object into metadata signature to Image document.

```java
Signature signature = new Signature("sample.pdf");
// create custom data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
// create custom object
DocumentSignatureData documentSignature = new DocumentSignatureData();
documentSignature.setID(java.util.UUID.randomUUID().toString());
documentSignature.setAuthor(System.getenv("USERNAME"));
documentSignature.setSigned(new java.util.Date());
documentSignature.setDataFactor(new java.math.BigDecimal("11.22"));
 
// setup QR-Code options
QrCodeSignOptions options = new QrCodeSignOptions();
// set custom object to serialize to QR Code
options.setData(documentSignature);
// QR-code type
options.setEncodeType(QrCodeTypes.QR);
// specify serialization encryption
options.setDataEncryption(encryption);
// locate and aligh signature
options.setHeight(100);
options.setWidth(100);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding() ;
padding.setRight(10);
padding.setBottom(10);
options.setMargin(padding);
 
// sign document to file
SignResult signResult = signature.sign("QRCodeCustomSerialization.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Implement thread-safe cache for GroupDocs.Viewer

Path: /viewer/net/implement-thread-safe-cache-for-groupdocs-viewer/

This page describes how to develop a thread-sage cache using the [C# lock](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/lock-statement) statement and the [ConcurrentDictionary<,>](https://docs.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentdictionary-2) class.

## Introduction

A method is thread-safe if multiple threads can call it without breaking the functionality. Achieving thread safety is a complex task, so general-purpose classes are usually not thread-safe. The most common way to achieve thread safety is to lock the resource for exclusive use by a single thread at any given time.

## Issue

You need to develop a web application where multiple users can simultaneously view the same file. The web application uses GroupDocs.Viewer on the server side. You have to ensure that multiple threads can safely read and write to the cache.

In GroupDocs.Viewer, you can use caching to improve the performance if the same document is processed multiple times ([read more about caching here](
    {{< ref "viewer/net/developer-guide/caching-results/_index.md" >}}).) The [FileCache](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.caching/filecache) class is an implementation of the [ICache](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.caching/icache) interface that uses a local disk to store the cache files. The FileCache is not thread safe, so you need to make it so.

## Solution

The FileCache class uses a local disk to read and write output files. You need to implement thread safe reading and writing to disk. To do this, use the list to store the key or the file ID and associated object you need to lock. The simplest way is to use the [ConcurrentDictionary<,> class](https://docs.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentdictionary-2) of the [.NET Framework 4.0](https://docs.microsoft.com/en-us/dotnet/standard/collections/thread-safe/). The ConcurrentDictionary is a thread safe implementation of a dictionary of key-value pairs. Implement the ThreadSafeCache class that wraps around not thread safe class that implements the ICache interface.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer.Caching;
using System.Collections.Generic;

internal class ThreadSafeCache : ICache
{
    private readonly ICache _cache;
    private readonly IKeyLockerStore _keyLockerStore;

    public ThreadSafeCache(ICache cache, IKeyLockerStore keyLockerStore)
    {
        _cache = cache;
        _keyLockerStore = keyLockerStore;
    }

    public void Set(string key, object value)
    {
        lock (_keyLockerStore.GetLockerFor(key))
        {
            _cache.Set(key, value);
        }
    }

    public bool TryGetValue<TEntry>(string key, out TEntry value)
    {
        lock (_keyLockerStore.GetLockerFor(key))
        {
            return _cache.TryGetValue(key, out value);
        }
    }

    public IEnumerable<string> GetKeys(string filter)
    {
        lock (_keyLockerStore.GetLockerFor("get_keys"))
        {
            return _cache.GetKeys(filter);
        }
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.Runtime.InteropServices
Imports GroupDocs.Viewer.Caching

Class ThreadSafeCache
    Implements ICache
    Private ReadOnly _cache As ICache
    Private ReadOnly _keyLockerStore As IKeyLockerStore

    Public Sub New(cache As ICache, keyLockerStore As IKeyLockerStore)
        _cache = cache
        _keyLockerStore = keyLockerStore
    End Sub

    Public Function TryGetValue(Of TEntry)(key As String, <Out> ByRef value As TEntry) As Boolean Implements ICache.TryGetValue
        SyncLock _keyLockerStore.GetLockerFor(key)
            Return _cache.TryGetValue(key, value)
        End SyncLock
    End Function

    Public Function ICache_GetKeys(filter As String) As IEnumerable(Of String) Implements ICache.GetKeys
        SyncLock _keyLockerStore.GetLockerFor("get_keys")
            Return _cache.GetKeys(filter)
        End SyncLock
    End Function

    Public Sub ICache_Set(key As String, value As Object) Implements ICache.[Set]
        SyncLock _keyLockerStore.GetLockerFor(key)
            _cache.Set(key, value)
        End SyncLock
    End Sub

End Class
```
{{< /tab >}}
{{< /tabs >}}

All the ThreadSafeCache class methods use locks to make calls thread safe. The ConcurrentDictionaryKeyLockerStore class uses ConcurrentDictionary to create the locker object or to retrieve it if it already exists. It also creates a unique key that identifies a cached file.

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using System.Collections.Concurrent;
// ...

interface IKeyLockerStore
{
    object GetLockerFor(string key);
}

class ConcurrentDictionaryKeyLockerStore : IKeyLockerStore
{
    private readonly ConcurrentDictionary<string, object> _keyLockerMap;
    private readonly string _uniqueKeyPrefix;

    public ConcurrentDictionaryKeyLockerStore(ConcurrentDictionary<string, object> keyLockerMap, string uniqueKeyPrefix)
    {
        _keyLockerMap = keyLockerMap;
        _uniqueKeyPrefix = uniqueKeyPrefix;
    }

    public object GetLockerFor(string key)
    {
        string uniqueKey = GetUniqueKey(key);
        return _keyLockerMap.GetOrAdd(uniqueKey, k => new object());
    }

    private string GetUniqueKey(string key)
    {
        return $"{_uniqueKeyPrefix}_{key}";
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.Collections.Concurrent
' ...

Interface IKeyLockerStore
    Function GetLockerFor(key As String) As Object
End Interface

Class ConcurrentDictionaryKeyLockerStore
    Implements IKeyLockerStore
    Private ReadOnly _keyLockerMap As ConcurrentDictionary(Of String, Object)
    Private ReadOnly _uniqueKeyPrefix As String

    Public Sub New(keyLockerMap As ConcurrentDictionary(Of String, Object), uniqueKeyPrefix As String)
        _keyLockerMap = keyLockerMap
        _uniqueKeyPrefix = uniqueKeyPrefix
    End Sub

    Public Function GetLockerFor(key As String) As Object Implements IKeyLockerStore.GetLockerFor
        Dim uniqueKey As String = Me.GetUniqueKey(key)
        Return _keyLockerMap.GetOrAdd(uniqueKey, Function(k) New Object())
    End Function

    Private Function GetUniqueKey(key As String) As String
        Return $"{_uniqueKeyPrefix}_{key}"
    End Function
End Class
```
{{< /tab >}}
{{< /tabs >}}

## Result

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using System.Collections.Generic;
using System.Collections.Concurrent;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Caching;
using GroupDocs.Viewer.Interfaces;
using GroupDocs.Viewer.Options;

namespace ThreadSaveCacheExample
{
    static class Program
    {
        private static readonly ConcurrentDictionary<string, object> KeyLockerMap = new ConcurrentDictionary<string, object>();

        static void Main()
        {
            string fileName = "sample.pdf";
            string cacheFolder = fileName.Replace('.', '_');
            string cachePath = Path.Combine("cache", cacheFolder);
            string uniqueKeyPrefix = cachePath;

            ICache fileCache = new FileCache(cachePath);
            IKeyLockerStore keyLockerStore = new ConcurrentDictionaryKeyLockerStore(KeyLockerMap, uniqueKeyPrefix);
            ICache threadSafeCache = new ThreadSafeCache(fileCache, keyLockerStore);

            ViewerSettings viewerSettings = new ViewerSettings(threadSafeCache);

            List<MemoryStream> pages = new List<MemoryStream>();
            using (Viewer viewer = new Viewer(fileName, viewerSettings))
            {
                IPageStreamFactory pageStreamFactory = new MemoryPageStreamFactory(pages);
                ViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources(pageStreamFactory);
                viewer.View(viewOptions);
            }
        }
    }

    class ThreadSafeCache : ICache
    {
        private readonly ICache _cache;
        private readonly IKeyLockerStore _keyLockerStore;

        public ThreadSafeCache(ICache cache, IKeyLockerStore keyLockerStore)
        {
            _cache = cache;
            _keyLockerStore = keyLockerStore;
        }

        public void Set(string key, object value)
        {
            lock (_keyLockerStore.GetLockerFor(key))
            {
                _cache.Set(key, value);
            }
        }

        public bool TryGetValue<TEntry>(string key, out TEntry value)
        {
            lock (_keyLockerStore.GetLockerFor(key))
            {
                return _cache.TryGetValue(key, out value);
            }
        }

        public IEnumerable<string> GetKeys(string filter)
        {
            lock (_keyLockerStore.GetLockerFor("get_keys"))
            {
                return _cache.GetKeys(filter);
            }
        }
    }

    interface IKeyLockerStore
    {
        object GetLockerFor(string key);
    }

    class ConcurrentDictionaryKeyLockerStore : IKeyLockerStore
    {
        private readonly ConcurrentDictionary<string, object> _keyLockerMap;
        private readonly string _uniqueKeyPrefix;

        public ConcurrentDictionaryKeyLockerStore(ConcurrentDictionary<string, object> keyLockerMap, string uniqueKeyPrefix)
        {
            _keyLockerMap = keyLockerMap;
            _uniqueKeyPrefix = uniqueKeyPrefix;
        }

        public object GetLockerFor(string key)
        {
            string uniqueKey = GetUniqueKey(key);
            return _keyLockerMap.GetOrAdd(uniqueKey, k => new object());
        }

        private string GetUniqueKey(string key)
        {
            return $"{_uniqueKeyPrefix}_{key}";
        }
    }

    class MemoryPageStreamFactory : IPageStreamFactory
    {
        private readonly List<MemoryStream> _pages;

        public MemoryPageStreamFactory(List<MemoryStream> pages)
        {
            _pages = pages;
        }

        public Stream CreatePageStream(int pageNumber)
        {
            MemoryStream pageStream = new MemoryStream();
            _pages.Add(pageStream);

            return pageStream;
        }

        public void ReleasePageStream(int pageNumber, Stream pageStream)
        {
            //Do not release page stream as we'll need to keep the stream open
        }
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports System.Collections.Concurrent
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Caching
Imports GroupDocs.Viewer.Interfaces
Imports GroupDocs.Viewer.Options
Imports System.Runtime.InteropServices

Module Program
    Private ReadOnly KeyLockerMap As ConcurrentDictionary(Of String, Object) = New ConcurrentDictionary(Of String, Object)()

    Public Sub Main()
        Dim fileName As String = "resume.pdf"
        Dim cacheFolder As String = fileName.Replace("."c, "_"c)
        Dim cachePath As String = Path.Combine("cache", cacheFolder)
        Dim uniqueKeyPrefix As String = cachePath

        Dim fileCache As ICache = New FileCache(cachePath)
        Dim keyLockerStore As IKeyLockerStore = New ConcurrentDictionaryKeyLockerStore(KeyLockerMap, uniqueKeyPrefix)
        Dim threadSafeCache As ICache = New ThreadSafeCache(fileCache, keyLockerStore)

        Dim viewerSettings As ViewerSettings = New ViewerSettings(threadSafeCache)

        Dim pages As List(Of MemoryStream) = New List(Of MemoryStream)()
        Using viewer As Viewer = New Viewer(fileName, viewerSettings)
            Dim pageStreamFactory As IPageStreamFactory = New MemoryPageStreamFactory(pages)
            Dim viewOptions As ViewOptions = HtmlViewOptions.ForEmbeddedResources(pageStreamFactory)
            viewer.View(viewOptions)
        End Using
    End Sub
End Module

Class ThreadSafeCache
    Implements ICache
    Private ReadOnly _cache As ICache
    Private ReadOnly _keyLockerStore As IKeyLockerStore

    Public Sub New(cache As ICache, keyLockerStore As IKeyLockerStore)
        _cache = cache
        _keyLockerStore = keyLockerStore
    End Sub

    Public Function TryGetValue(Of TEntry)(key As String, <Out> ByRef value As TEntry) As Boolean Implements ICache.TryGetValue
        SyncLock _keyLockerStore.GetLockerFor(key)
            Return _cache.TryGetValue(key, value)
        End SyncLock
    End Function

    Public Function ICache_GetKeys(filter As String) As IEnumerable(Of String) Implements ICache.GetKeys
        SyncLock _keyLockerStore.GetLockerFor("get_keys")
            Return _cache.GetKeys(filter)
        End SyncLock
    End Function

    Public Sub ICache_Set(key As String, value As Object) Implements ICache.[Set]
        SyncLock _keyLockerStore.GetLockerFor(key)
            _cache.Set(key, value)
        End SyncLock
    End Sub

End Class

Interface IKeyLockerStore
    Function GetLockerFor(key As String) As Object
End Interface

Class ConcurrentDictionaryKeyLockerStore
    Implements IKeyLockerStore
    Private ReadOnly _keyLockerMap As ConcurrentDictionary(Of String, Object)
    Private ReadOnly _uniqueKeyPrefix As String

    Public Sub New(keyLockerMap As ConcurrentDictionary(Of String, Object), uniqueKeyPrefix As String)
        _keyLockerMap = keyLockerMap
        _uniqueKeyPrefix = uniqueKeyPrefix
    End Sub

    Public Function GetLockerFor(key As String) As Object Implements IKeyLockerStore.GetLockerFor
        Dim uniqueKey As String = Me.GetUniqueKey(key)
        Return _keyLockerMap.GetOrAdd(uniqueKey, Function(k) New Object())
    End Function

    Private Function GetUniqueKey(key As String) As String
        Return $"{_uniqueKeyPrefix}_{key}"
    End Function
End Class

Class MemoryPageStreamFactory
    Implements IPageStreamFactory
    Private ReadOnly _pages As List(Of MemoryStream)

    Public Sub New(pages As List(Of MemoryStream))
        _pages = pages
    End Sub

    Public Sub IPageStreamFactory_ReleasePageStream(pageNumber As Integer, pageStream As Stream) Implements IPageStreamFactory.ReleasePageStream
        'Do not release page stream as we'll need to keep the stream open
    End Sub

    Public Function IPageStreamFactory_CreatePageStream(pageNumber As Integer) As Stream Implements IPageStreamFactory.CreatePageStream
        Dim pageStream As MemoryStream = New MemoryStream()
        _pages.Add(pageStream)

        Return pageStream
    End Function
End Class
```
{{< /tab >}}
{{< /tabs >}}

---

## In-Paragraph List in Spreadsheet Document

Path: /assembly/java/in-paragraph-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-ParagraphList report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Paragraph List in Microsoft Excel Document

### Creating a In-Paragraph List

Practising the following steps you can create In-Paragraph List Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Write a sentence, for example "We provide support for the following clients:" in a single column.
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe about the clients with the following key requirements:

*   A descriptive or informative line like "We provide support for the following clients:".
*   Show all the clients along with the above sentence.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients: <<foreach [in getClients()]>>
<<[indexOf() != 0 ? ", " : ""]>><<[getName()]>><</foreach>>
```

### Download In-Paragraph List Template

Please download the sample In-Paragraph List document we created in this article:

*   [In-Paragraph List.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/In-Paragraph%20List.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 23a45175195f622deb0d16cb59f5d874 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Paragraph List in Spreadsheet Document

Path: /assembly/net/in-paragraph-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Paragraph List report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}

## In-Paragraph List in Microsoft Excel Document

### Creating a In-Paragraph List

Practicing the following steps you can create In-Paragraph List Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Write a sentence, for example "We provide support for the following products:" in a single column.
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe about the services you are providing with the following key requirements:

*   A descriptive or informative line like "We provide support for the following products:".
*   Show all the products along with the above sentence.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[IndexOf() != 0 ? ", " : ""]>>
<<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Paragraph List Template

Please download the sample In-Paragraph List document we created in this article:

*   [In-Paragraph List.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Paragraph%20List.xlsx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [In-Paragraph List\_XML.xlsx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Paragraph%20List_XML.xlsx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 6b9866627791c4ff0a3c >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 6223b2987be48a027f99 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 25c0b61ebda5c39421f2 >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 6ed5df46b0ef742488ac >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs dac0a613622ec857902d >}}

## In-Paragraph List in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'In-Paragraph List' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Paragraph List\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Paragraph%20List_OpenDocument.ods?raw=true) (use same template for database, dataset and JSON examples)
*   [In-Paragraph List\_XML\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Paragraph%20List_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 6445b2968162214aaf91 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 9fa306dad3920785fcc8 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 6eef45055feb79ed238e >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 614f40dafb84838a9452 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 66fc77bc84df4f1ec7fc >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List in Spreadsheet Document

Path: /assembly/java/in-table-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList report in Spreadsheet format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List in Microsoft Excel Document

### Creating a In-Table List

Practising the following steps you can create In-Table List Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers with the following key requirements:

*   Report must show managers' name.
*   It must show the sum of contract prices against each manager.
*   It must sum up all the contract prices for all the managers.
*   All the representation must be in tabular form.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

| **Manager**                                       | **Contract Price**                                           |
| ------------------------------------------------- | ------------------------------------------------------------ |
| **<<foreach [in getManagers()]>><<[getName()]>>** | <<[getContracts().sum(<br />   c => c.getPrice())]>><</foreach>> |
| **Total:**                                        | <<[getManagers().sum(<br />   m => m.getContracts().sum(<br />     c => c.getPrice()))]>> |

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/In-Table%20List.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists a85a917d5602e18168b0f98f7de9f1bd >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List in Spreadsheet Document

Path: /assembly/net/in-table-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList report in Spreadsheet format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List in Microsoft Excel Document

### Creating a In-Table List

Practicing the following steps you can create In-Table List Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers orders quantity with the following key requirements:

*   Report must show customers' name.
*   It must show the sum of orders prices against each customer.
*   It must sum up all the order prices for all the customers.
*   All the representation must be in tabular form.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 433pt;"><tbody><tr style="height: 15.75pt;"><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 259.95pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customers</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 150.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Quantity</span></p></td></tr><tr style="height: 61.5pt;"><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 259.95pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in customers]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">CustomerName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 150.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span><br><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr style="height: 45.75pt;"><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 259.95pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 150.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(</span><br><span style="font-family: Calibri; font-size: 11pt;">m =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">m.Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span><br><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List.xlsx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List_DB.xlsx?raw=true) (Template for DataBase examples)
*   [In-Table List\_DS.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List_DT.xlsx?raw=true) (Template for DataSet examples)
*   [In-Table List\_XML.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List_XML.xlsx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 6813bfc47aea3f0c0963b05199b8b88d >}}

#### Database Entities

{{< gist GroupDocsGists b44f050de3d023c251f9b572c7589b81 >}}

#### Using DataSet

{{< gist GroupDocsGists b1cc321f36db86f679988b174bc735fb >}}

#### Using XML DataSource

{{< gist GroupDocsGists 451678be3fb64fb736646764c785a80e >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 6a5f78bf90c76876c2225bbd875348c5 >}}

## In-Table List in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List_OpenDocument.ods?raw=true) (use same template for JSON examples)
*   [In-Table List\_DB\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List_DB_OpenDocument.ods?raw=true)
*   [In-Table List\_DS\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List_DT_OpenDocument.ods?raw=true)
*   [In-Table List\_XML\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists c2343859b5d4894fff20b160ee0f16d1 >}}

#### Database Entities

{{< gist GroupDocsGists fecaeddcf4e9a99820e0cdbf782cc852 >}}

#### Using DataSet

{{< gist GroupDocsGists 508487e8a09c41d1b318fb8757ec3301 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 57b27442f9843eb170a024da982d9213 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists f7056c8c0d2a25ced13b40f80201c2fd >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List With Alternate Content in Spreadsheet Document

Path: /assembly/java/in-table-list-with-alternate-content-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList WithAlternateContent report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List With Alternate Content in Microsoft Excel Document

### Creating a In-Table List With Alternate Content

Practising the following steps you can create In-Table List With Alternate Content Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent your clients and their prices with the following key requirements:

*   Report must show each client along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="571" style="width: 428pt; border-collapse: collapse;"><tbody><tr style="height: 15.75pt;"><td width="380" style="width: 285pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 15.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">Client</span></b></p></td><td width="191" style="width: 143pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 15.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">Contract Price</span></b></p></td></tr><tr style="height: 16.5pt;"><td width="571" colspan="2" style="width: 428pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 16.5pt;"><p class="MsoNormal" align="center" style="margin-bottom: 0.0001pt; text-align: center; line-height: normal;"><b><span style="color: black;">&lt;&lt;if [!getContracts().any()]&gt;&gt;No data</span></b></p></td></tr><tr style="height: 30.75pt;"><td width="380" style="width: 285pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">&lt;&lt;else&gt;&gt;&lt;&lt;foreach [in getContracts()]&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</span></b></p></td><td width="191" style="width: 143pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">&lt;&lt;[getPrice()]&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr style="height: 30.75pt;"><td width="380" style="width: 285pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="color: black;">Total:</span></b></p></td><td width="191" style="width: 143pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt; height: 30.75pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">&lt;&lt;[getContracts().sum(<br>&nbsp; c =&gt; c.getPrice())]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr></tbody></table>
### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 0f26df9b0e6c7e9ea364a8a01affd5aa >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List With Alternate Content in Spreadsheet Document

Path: /assembly/net/in-table-list-with-alternate-content-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List With Alternate Content report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}

## In-Table List With Alternate Content in Microsoft Excel Document

### Creating a In-Table List With Alternate Content

Practicing the following steps you can create In-Table List With Alternate Content Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent your products and their prices with the following key requirements:

*   Report must show each product along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 429pt;"><tbody><tr style="height: 15.75pt;"><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 274.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Products</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 132.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr style="height: 16.5pt;"><td colspan="2" style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(102, 102, 102); border-top-style: solid; border-top-width: 1.5pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 417.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!Any()]&gt;&gt;No data</span></p></td></tr><tr style="height: 30.75pt;"><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 274.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Product.ProductName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 132.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr style="height: 30.75pt;"><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 274.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 132.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">$&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 285pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 143pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content.xlsx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List With Alternate Content\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content_DB.xlsx?raw=true) (Template for DataBase examples)
*   [In-Table List With Alternate Content\_DS.xlsx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content_DT.xlsx?raw=true) (Template for DataSet examples)
*   [In-Table List With Alternate Content\_XML.xlsx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content_XML.xlsx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs a98766d8aa4cc2526f13 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs cbc279906eec88a77084 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 417279cba260aac6871a >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 489a120e45308c877256 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 48d9770e11dea9add904 >}}

## In-Table List With Alternate Content in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List With Alternate Content' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List With Alternate Content\_OenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content_OpenDocument.ods?raw=true) (use same template for JSON examples)
*   [In-Table List With Alternate Content\_DB\_OenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content_DB_OpenDocument.ods?raw=true)
*   [In-Table List With Alternate Content\_DS\_OenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content_DT_OpenDocument.ods?raw=true)
*   [In-Table List With Alternate Content\_XML\_OenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Alternate%20Content_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs e93a961dcf5400d1ada8 >}}

####  Database Entities
{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 043c275824447b0009f7 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 5e16dea1a139b5f45449 >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 9b785f2fb183b821c55f >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs dd6129229c8660473916 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Filtering Grouping and Ordering in Spreadsheet Document

Path: /assembly/java/in-table-list-with-filtering-grouping-and-ordering-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList with Filtering, Grouping, and Ordering report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Microsoft Excel Document

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practicing the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent managers' contract information with the following key requirements:

*   Report must show each manager along with sum of prices of his contracts.
*   It must represent all the information in tabular form.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

| **Manager**                                                  | **Contract Price**                       |
| ------------------------------------------------------------ | ---------------------------------------- |
| **<<foreach [in getContracts()<br />    .where(c => c.getDate().getYear() + 1900 == 2015)<br />    .groupBy(c => c.getManager())<br />    .orderBy(g => g.key.getName())]>><br /><<[key.getName()]>>** | <<[sum(c => c.getPrice())]>><</foreach>> |

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 722021ab1cc8e055a0d23823b4b62e71 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Filtering Grouping and Ordering in Spreadsheet Document

Path: /assembly/net/in-table-list-with-filtering-grouping-and-ordering-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList with Filtering, Grouping, and Ordering report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Microsoft Excel Document

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practising the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with the following key requirements:

*   Report must show each customer along with sum of prices of his orders.
*   It must represent all the information in tabular form.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 456pt;"><tbody><tr style="height: 15.75pt;"><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 252.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 181.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr style="height: 76.5pt;"><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 252.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders</span><br><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&nbsp;&nbsp;&nbsp; .Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">c.OrderDate.Year</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> == 2015)</span><br><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&nbsp;&nbsp;&nbsp; .</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">GroupBy</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">c.Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">)</span><br><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&nbsp;&nbsp;&nbsp; .</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">OrderBy</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">(g =&gt; </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">g.Key.CustomerName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">)]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Key.CustomerName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 181.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.xlsx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB.xlsx?raw=true) (Template for DataSet examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_XML.xlsx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML.xlsx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 231a7e3d7d2dbe672478531284592cb6 >}}

#### Database Entities

{{< gist GroupDocsGists ed945fcd5141095bd94cd40c5a097421 >}}

#### Using DataSet

{{< gist GroupDocsGists 556dbf3d5845c5d1b92d1c957b9e4843 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 698082446f03e7b302b9fbdd0e9cd85c >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 559ade9bc8b5860fe564ae4afd4621fe >}}

## In-Table List with Filtering, Grouping, and Ordering in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List with Filtering, Grouping, and Ordering' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List with Filtering, Grouping, and Ordering\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_OpenDocument.ods?raw=true) (use same template for JSON examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_DB\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB_OpenDocument.ods?raw=true) (use same template for dataset examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_XML\_OpenDocument.ods](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML_OpenDocument.ods?raw=true)

### Generating the report

#### Custom Objects

{{< gist GroupDocsGists ad70d05d86c56f437435e7ad46883dc0 >}}

#### Database Entities

{{< gist GroupDocsGists 568db958c0ce91af69f9224773898664 >}}

#### Using DataSet

{{< gist GroupDocsGists 577a989d2169b5ca2d0f7aa137c65530 >}}

#### Using XML DataSource

{{< gist GroupDocsGists f40b94708514c740720f7d96155c7296 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 89f6a1575ad5a8abb78068c14195a720 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Highlighted Rows in Spreadsheet Document

Path: /assembly/java/in-table-list-with-highlighted-rows-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList with Highlighted Rows report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Laye](https://docs.groupdocs.com/assembly/java/the-business-layer/)r.{{< /alert >}}

## In-Table List with Highlighted Rows in Microsoft Excel Document

### Creating a In-Table List with Highlighted Rows

Practising the following steps you can create In-Table List with Highlighted Rows Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Insert a 2x4 table.
5.  Click the cell you want to highlight.
6.  Click "Cell Styles" in Styles group.
7.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show all the client names with price.
*   Show single client and his single contract price in a single row.
*   It must highlight the record with contract price more than or equal to 1000000.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoTableGridLight" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="623" valign="top" style="width: 467.25pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 1pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p><table class="MsoTable15Grid1Light" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>Client</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>Contract Price</b></p></td></tr><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; background-color: rgb(255, 242, 204); background-image: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>&lt;&lt;foreach [in getContracts()]&gt;&gt;&lt;&lt;if [getPrice() &gt;= 1000000]&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; background-color: rgb(255, 242, 204); background-image: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&lt;&lt;[getPrice()]&gt;&gt;</p></td></tr><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>&lt;&lt;else&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&lt;&lt;[getPrice()]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</p></td></tr><tr><td width="370" valign="top" style="width: 277.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b>Total:</b></p></td><td width="238" valign="top" style="width: 178.35pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&lt;&lt;[getContracts().sum(</p><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp; c =&gt; c.getPrice())]&gt;&gt;</p></td></tr></tbody></table><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td></tr></tbody></table>
### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we created in this article:

*   [In-Table List with Highlighted Rows.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 46c41d0904f70c013c0427c89757d29e >}}



### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Highlighted Rows in Spreadsheet Document

Path: /assembly/net/in-table-list-with-highlighted-rows-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table List with Highlighted Rows report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List with Highlighted Rows in Microsoft Excel Document

### Creating a In-Table List with Highlighted Rows

Practising the following steps you can create In-Table List with Highlighted Rows Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Insert a 2x4 table.
5.  Click the cell you want to highlight.
6.  Click "Cell Styles" in Styles group.
7.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with a specific filtering condition with the following key requirements:

*   The report must show each customer along with his orders.
*   Show single Customer and his single order price in a single row.
*   It must highlight the record with order price more than or equal to 400.
*   It must show sum of the order prices.
*   It must represent all the information in tabular form.
*   The report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 397pt;"><tbody><tr style="height: 15.75pt;"><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 231.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 143.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr style="height: 31.5pt;"><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 231.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;if [Price &gt;= 400]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 143.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;</span></p></td></tr><tr style="height: 15.75pt;"><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 231.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 143.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr style="height: 15.75pt;"><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: middle; width: 231.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 1pt; padding-left: 5.4pt; padding-right: 4.9pt; vertical-align: middle; width: 143.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we created in this article:

*   [In-Table List with Highlighted Rows.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows.xlsx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List with Highlighted Rows\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DB.xlsx?raw=true) (Template for DataBase examples)
*   [In-Table List with Highlighted Rows\_DT.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DT.xlsx?raw=true) (Template for DataSet examples)
*   [In-Table List with Highlighted Rows\_XML.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows_XML.xlsx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 9464bf4e1e33a4e3dcbfcab8cbe46787 >}}

#### Database Entities

{{< gist GroupDocsGists c372ab85a6ab05da66b315c61feef683 >}}

#### Using DataSet

{{< gist GroupDocsGists 3779bc487d0821d33aad53225ad0a095 >}}

#### Using XML DataSource

{{< gist GroupDocsGists dfa851238a40b6223d9394c5060e0f67 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 87fca83e4f81cb7720baf642bb2dadcf >}}

## In-Table List with Highlighted Rows in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List with Highlighted Rows' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List with Highlighted Rows\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows_OpenDocument.ods?raw=true) (use same template for JSON examples)
*   [In-Table List with Highlighted Rows\_DB\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DB_OpenDocument.ods?raw=true)
*   [In-Table List with Highlighted Rows\_DT\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DT_OpenDocument.ods?raw=true)
*   [In-Table List with Highlighted Rows\_XML\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20List%20with%20Highlighted%20Rows_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 0a078b84ed9ce47b4feb1a966b3518a4 >}}

#### Database Entities

{{< gist GroupDocsGists fed66320777b4940395fff94f4a3008e >}}

#### Using DataSet

{{< gist GroupDocsGists 246f0bc024abdc5410f41f229dacec12 >}}

#### Using XML DataSource

{{< gist GroupDocsGists b5d0c0e51ff601eac60fac7e0f1ed017 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 12df2bcb8cf6a3ba8da6983e8b10007b >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table Master-Detail in Spreadsheet Document

Path: /assembly/java/in-table-master-detail-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableMaster-Detail report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in Microsoft Excel Document

### Creating a In-Table Master-Detail

Practising the following steps you can create In-Table Master-Detail Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Insert a 2x4 table.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show each manager along with his total contract prices.
*   It must also show each individual client within the contract.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Spreadsheet document format.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="iksweb">
	<tbody>
		<tr>
      <td><b>Manager/Client</b></td>
      <td><b>Contract Price</b></td>
		</tr>
		<tr>
      <td><b>&lt;&lt;foreach [in getManagers()]>>&lt;&lt;[getName()]>></b></td>
			<td>&lt;&lt;[getContracts().sum(c => c.getPrice())]>></td>
		</tr>
		<tr>
      <td><i>&lt;&lt;foreach [in getContracts()]>><br\>&lt;&lt;[getClient().getName()]>></i></td>
			<td>&lt;&lt;[getPrice()]>>&lt;&lt;/foreach>>&lt;&lt;/foreach>></td>
		</tr>
		<tr>
      <td><b>Total:</b></td>
			<td>&lt;&lt;[getManagers().sum(<br\>  m => m.getContracts().sum(<br\>    c => c.getPrice()))]>></td>
		</tr>
	</tbody>
</table>

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/In-Table%20Master-Detail.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists f32bd70cf4ad82c5c1df41d61bd11e63 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table Master-Detail in Spreadsheet Document

Path: /assembly/net/in-table-master-detail-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table Master-Detail report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in Microsoft Excel Document

### Creating a In-Table Master-Detail

Practising the following steps you can create In-Table Master-Detail Template in MS Excel 2013.

1.  Add a new Workbook.
2.  Select the range of cells that you want to include in the table.
3.  On the Insert tab, in the Tables group, click Table.
4.  Insert a 2x4 table.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' total orders prices and price of each product separately with the following key requirements:

*   The report must show each customer along with his total orders prices.
*   It must also show each individual product ordered by the customers.
*   It must show the sum of the order prices.
*   It must represent all the information in tabular form.
*   The report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15.25pt;"><td style="border-bottom-color: rgb(128, 128, 128); border-bottom-style: solid; border-bottom-width: 2.25pt; border-left-color: rgb(150, 150, 150); border-left-style: solid; border-left-width: 1.5pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; border-top-color: rgb(150, 150, 150); border-top-style: solid; border-top-width: 1.5pt; padding-left: 0.75pt; padding-right: 0.75pt; vertical-align: top; width: 254.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(128, 128, 128); border-bottom-style: solid; border-bottom-width: 2.25pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; border-top-color: rgb(150, 150, 150); border-top-style: solid; border-top-width: 1.5pt; padding-left: 1.5pt; padding-right: 0.75pt; vertical-align: top; width: 151.65pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr style="height: 30.5pt;"><td style="border-bottom-color: rgb(150, 150, 150); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(150, 150, 150); border-left-style: solid; border-left-width: 1.5pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; padding-left: 0.75pt; padding-right: 0.75pt; vertical-align: top; width: 254.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in customers]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">CustomerName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(150, 150, 150); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; padding-left: 1.5pt; padding-right: 0.75pt; vertical-align: top; width: 151.65pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 29.75pt;"><td style="border-bottom-color: rgb(150, 150, 150); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(150, 150, 150); border-left-style: solid; border-left-width: 1.5pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; padding-left: 0.75pt; padding-right: 0.75pt; vertical-align: top; width: 254.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-style: italic;">&lt;&lt;</span><span style="font-family: Calibri; font-size: 11pt; font-style: italic;">foreach</span><span style="font-family: Calibri; font-size: 11pt; font-style: italic;"> [in Order]&gt;&gt; &lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-style: italic;">Product.ProductName</span><span style="font-family: Calibri; font-size: 11pt; font-style: italic;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(150, 150, 150); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; padding-left: 1.5pt; padding-right: 0.75pt; vertical-align: top; width: 151.65pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;&lt;&lt;/</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr style="height: 44.3pt;"><td style="border-bottom-color: rgb(150, 150, 150); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(150, 150, 150); border-left-style: solid; border-left-width: 1.5pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; padding-left: 0.75pt; padding-right: 0.75pt; vertical-align: top; width: 254.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(150, 150, 150); border-bottom-style: solid; border-bottom-width: 1.5pt; border-right-color: rgb(150, 150, 150); border-right-style: solid; border-right-width: 1.5pt; padding-left: 1.5pt; padding-right: 0.75pt; vertical-align: top; width: 151.65pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">m =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">m.Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail.xlsx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table Master-Detail\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail_DB.xlsx?raw=true) (Template for DataBase examples)
*   [In-Table Master-Detail\_DT.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail_DT.xlsx?raw=true) (Template for DataSet examples)
*   [In-Table Master-Detail\_XML.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail_XML.xlsx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 1cc9c9ca8c02b2e328b3dff3c1a72952 >}}

#### Database Entities

{{< gist GroupDocsGists 14050eb22533aeabf40b7d11ad72bb6c >}}

#### Using DataSet

{{< gist GroupDocsGists fb6aa1c3eddd38a39af7326176ba84cf >}}

#### Using XML DataSource

{{< gist GroupDocsGists fb2a8fa5ff46b1da070665f1b9fe6d62 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 538710ec777f8641257808437709487e >}}

## In-Table Master-Detail in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table Master-Detail' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table Master-Detail\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail_OpenDocument.ods?raw=true) (use same template for JSON examples)
*   [In-Table Master-Detail\_DB\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail_DB_OpenDocument.ods?raw=true)
*   [In-Table Master-Detail\_DT\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail_DT_OpenDocument.ods?raw=true)
*   [In-Table Master-Detail\_XML\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/In-Table%20Master-Detail_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists fb66089cdec8c73777dbb2e79d5be09d >}}



#### Database Entities

{{< gist GroupDocsGists dbd63af289b49a0ef09f831ce27228f0 >}}



#### Using DataSet

{{< gist GroupDocsGists 882828a8a651334bd1eada513799ec3a >}}



#### Using XML DataSource

{{< gist GroupDocsGists 3233a412bb67fb589f1d56f2989a44f4 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists fe3c82c20ee23b21c969ec77f7a84aab >}}



### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Individual Series Point Coloring in Presentation Document

Path: /assembly/java/individual-series-point-coloring-in-presentation-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Presentation Document

### Creating a Pie Chart

Please follow below steps to can create Pie Chart in MS PowerPoint 2013:

1.  Add a new presentation slide
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Pie"
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.dynabic.com/display/assemblynet/Pie+Chart+in+Presentation+Document#PieChartinPresentationDocument-ChartData(Excel))
6.  Save the template

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Presentation Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

|   | Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor [Color] >> |
| --- | --- |
| A | 8.2 |
| B | 3.2 |
| C | 1.5 |
| D | 1.2 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Dynamic%20Chart%20Point%20Series%20Color.pptx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```java
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists 30eca90c820e3063f4336dcdeb356c47 >}}



---

## Individual Series Point Coloring in Presentation Document

Path: /assembly/net/individual-series-point-coloring-in-presentation-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Presentation Document

### Creating a Pie Chart

Please follow below steps to can create Pie Chart in MS PowerPoint 2013:

1.  Add a new presentation slide
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Pie"
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.dynabic.com/display/assemblynet/Pie+Chart+in+Presentation+Document#PieChartinPresentationDocument-ChartData(Excel))
6.  Save the template

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Presentation Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

|   | Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor [Color] >> |
| --- | --- |
| A | 8.2 |
| B | 3.2 |
| C | 1.5 |
| D | 1.2 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Dynamic%20Chart%20Point%20Series%20Color.pptx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```csharp
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists d5ed42e4c458d9ebccd7d8d8e8505d38 >}}



---

## Inserting edited slide into existing presentation

Path: /editor/net/inserting-edited-slide-into-existing-presentation/

By default the full presentation editing pipeline (cycle) is the next:

1. Load presentation in a form of a file or stream into constructor of the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class.
2. Select a specific slide to edit and specify its index in the [SlideNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationeditoptions/slidenumber) property of [PresentationEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationeditoptions) class.
3. Open presentation for editing by calling [Editor.Edit()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method, passing [PresentationEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationeditoptions) instance with selected slide into it, and obtaining [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance from this method.
4. Emitting HTML and CSS markup, which represents a content of an edited document, from [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, using different methods like [GetContent()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcontent).
5. Passing this HTML and CSS markup into the WYSIWYG editor, which is located on client-side and is running in the browser.
6. End-user edits the document content in the WYSIWYG editor.
7. Edited document content, in form of HTML and CSS markup, is passed back to the server-side.
8. Then this content is passed into the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, by using the [FromFile](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fromfile), [FromMarkup](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkup), or [FromBodyMarkupAndResourceFolder](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder/) static methods.
9. Created [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, which holds an edited document content, is passed into the [Editor.Save](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.
10. [Editor.Save](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method generates a new presentation, which contains only one single slide — those slide, that was edited on the client-side and which content was passed via [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class into this method.

Before GroupDocs.Editor [version 20.4](https://releases.groupdocs.com/editor/net/release-notes/2020/groupdocs-editor-for-net-20-4-release-notes/) this was the only pipeline, accessible for the customer.

Starting from [version 20.4](https://releases.groupdocs.com/editor/net/release-notes/2020/groupdocs-editor-for-net-20-4-release-notes/) the 10th step of described pipeline can be altered — edited slide can be inserted into original presentation, which was loaded on the 1st step.

[PresentationSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) class now contains two new properties: integer [SlideNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) and boolean flag [InsertAsNewSlide](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide). Both of them have "usual" default values: [SlideNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) has `0` and [InsertAsNewSlide](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide) is set to 'false'.

```csharp
public int SlideNumber { get; set; }
public bool InsertAsNewSlide { get; set; }
```

By default, when these properties are not touched or at least [SlideNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) has a default value '`0`', GroupDocs.Editor will generate new single-slide presentation, as in previous versions. However, if [SlideNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property contains number, distinct from '0', and valid presentation is loaded into [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class (it is expected to be the original presentation, which was edited, but it actually can be any presentation, even those, which has no relation to the original), then edited slide will be **inserted** into given presentation.

## SlideNumber property

[SlideNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property, if it is not zero, defines, *where*, at *which exact position* in the given presentation the new edited slide should be inserted. `InsertAsNewSlide` parameter, which is a boolean flag, determines, *how* this slide should be inserted: should it *replace* the existing slide, that is located on specified position ('`false'`, default value), or it should be *injected between* existing slides, without rewriting them, and thus increasing the total amount of slides in the given presentation by one.

Because default '`0`' value of `SlideNumber` parameter is reserved, actual slide numbering starts from `1`. This is different from widely used 0-based indexing, however, makes sense, thus it is not an *index* of a slide, but rather *number* of a slide, the same as MS PowerPoint uses, for instance. This means that, for example, for given presentation, that consists of 5 slides, 1st one has a '`1`' slide number, and 5th — '`5`'. If user has specified a slide number, which exceeds the total amount of slides in presentation, this number will be automatically adjusted to the latest. This means that if, for example, for the same 5-slide presentation user will specify a '`6`', '`7`' or even '`Int32.MaxValue`', it will be internally set a '`5`' — number of the latest slide.

Along with positive slide numbers, the `SlideNumber` property also supports negative numbering, which implies count from the end of presentation. In this case, '-1' is treated as the last slide, '-2' — the last but one, and so on. Again, like with positive numbering, in case when number exceeds the amount of slides, it will be adjusted to the closest — first slide for negative numbers.

Part of source code below explains this numbering system:

```csharp
PresentationSaveOptions saveOptions = new PresentationSaveOptions(Formats.PresentationFormats.Pptx)

//let's say we have presentation with 5 slides

saveOptions.SlideNumber = 0;  // default value, given presentation will be ignored

//positive numbering
saveOptions.SlideNumber =  1;  // first slide
saveOptions.SlideNumber =  2;  // second slide 
saveOptions.SlideNumber =  3;  // third slide 
saveOptions.SlideNumber =  4;  // fourth slide 
saveOptions.SlideNumber =  5;  // fifth slide 
saveOptions.SlideNumber =  6;  // fifth slide, because value '6' exceeds the slides amount '5' and thus is adjusted to the closest

//negative numbering
saveOptions.SlideNumber = -1;  // fifth slide, which is first from end (last)
saveOptions.SlideNumber = -2;  // fourth slide, which is second from end (last but one)
saveOptions.SlideNumber = -3;  // third slide, which is third from end
saveOptions.SlideNumber = -4;  // second slide, which is fourth from end
saveOptions.SlideNumber = -5;  // first slide, which is fifth from end
saveOptions.SlideNumber = -6;  // first slide, because value '-6' exceeds the slides amount '5' and thus is adjusted to the closest
```

## InsertAsNewSlide property

[InsertAsNewSlide](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide) property complements the previously described [SlideNumber](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property and is ignored, when `SlideNumber` is set to '`0`'. If `SlideNumber` points on the slide of specific number,  [InsertAsNewSlide](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide) determines how to treat this slide number and how to insert the slide:

* If  [InsertAsNewSlide](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide)  property has default '`false`' value, the existing slide in given presentation will be completely erased, and the content of the new slide (which is located in the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance) will be putted on this place. As a result, presentation will preserve the same untouched amount of slides, but one of its slides (specified by the `SlideNumber`) will be replaced onto new one.
* If [InsertAsNewSlide](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide) property has '`true`' value, the edited slide, obtained from [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, will be injected among existing slides in given presentation, so its amount of slides will be incremented by one. New slide is inserted at position, specified by `SlideNumber`, and all subsequent slides (following or preceding) will be shifted to the end or to the beginning accordingly, depending on positive or negative numbering.

Source code below shows, how slide number is treated when `InsertAsNewSlide` property is enabled:

```csharp
PresentationSaveOptions saveOptions = new PresentationSaveOptions(Formats.PresentationFormats.Pptx)

//let's say we have presentation with 5 slides
saveOptions.SlideNumber = 0;  // default value, given presentation will be ignored, as well as InsertAsNewSlide
saveOptions.InsertAsNewSlide = true;//

//positive numbering
saveOptions.SlideNumber =  1;  // new slide is injected as first, while all following (including 'old' 1st) are shifting to the end
saveOptions.SlideNumber =  2;  // new slide is injected as second, while 2nd, 3rh, 4th and 5th are shifting to the end
saveOptions.SlideNumber =  3;  // new slide is injected as third, while 3rh, 4th and 5th are shifting to the end
saveOptions.SlideNumber =  4;  // new slide is injected as fourth, while 4th and 5th are shifting to the end
saveOptions.SlideNumber =  5;  // new slide is injected as fifth, while 5th is shifting to the end and becomes 6th
saveOptions.SlideNumber =  6;  // new slide is injected as sixth, it already becomes the latest, none of existing slides are shifthing to the end
saveOptions.SlideNumber =  7;  // same as previous

//negative numbering
saveOptions.SlideNumber = -1;  // new slide is inject as first from end (it becomes sixth if starting from beginning), none of existing slides are shifthing to the end
saveOptions.SlideNumber = -2;  // new slide is inject as second from end (it becomes fifth if starting from beginning), following single slide is shifting to the end
saveOptions.SlideNumber = -3;  // new slide is inject as third from end (it becomes fourth if starting from beginning), two following slides are shifting to the end
saveOptions.SlideNumber = -4;  // new slide is inject as fourth from end (it becomes third if starting from beginning), three following slides are shifting to the end
saveOptions.SlideNumber = -5;  // new slide is inject as fifth from end (it becomes second if starting from beginning), four following slides are shifting to the end
saveOptions.SlideNumber = -6;  // new slide is inject as sixth from end (it becomes first if starting from beginning), five following slides are shifting to the end
saveOptions.SlideNumber = -7;  // same as previous
```

---

## Inserting Hyperlinks Dynamically

Path: /assembly/java/inserting-hyperlinks-dynamically/

{{< alert style="info" >}}This feature is supported by version 18.7. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

Using GroupDocs.Assembly, you can insert hyperlinks to your reports dynamically using link tags. The syntax of a link tag is defined as follows:

```
<<link [uri_expression][display_text_expression]>>
```

Here, **uri\_expression** defines URI for a hyperlink to be inserted dynamically. This expression is mandatory and must return a non-empty value. In turn, **display\_text\_expression** defines text to be displayed for the hyperlink. This expression is optional. If it is omitted or returns an empty value, then during runtime, a value of **uri\_expression** is used as display text as well. Values of both **uri\_expression** and **display\_text\_expression** can be of any types. During runtime, **Object.ToString()** is invoked to get textual representations of these expressions’ values, which is useful for expressions of types like Uri, for example, while building a report, **uri\_expression** and **display\_text\_expression** are evaluated and their results are used to construct a hyperlink that replaces the corresponding link tag then.

## Dynamic insertion of links to bookmarks 

{{< alert style="info" >}}This feature is supported by version 19.11. or greater{{< /alert >}}

### Insertion of links for Word Processing documents and Emails

You can also insert links to bookmarks to your reports dynamically using link tags. The syntax of a link tag is defined as follows:

```java
<<link [uri_or_bookmark_expression][display_text_expression]>>

```

Here, **uri\_or\_bookmark\_expression** defines URI or the name of a bookmark within the same document for a hyperlink to be inserted dynamically. This expression is mandatory and must return a non-empty value.In turn, **display\_text\_expression** defines text to be displayed for the hyperlink. This expression is optional. If it is omitted or returns an empty value, then during runtime, a value of **uri\_or\_bookmark\_expression** is used as display text as well.

{{< alert style="warning" >}}<ul><li>Values of both uri_or_bookmark_expression and display_text_expression can be of any types. During runtime, Object.ToString() is invoked to get textual representations of these expressions’ values, which is useful for expressions of types like Uri, for example. While building a report, uri_or_bookmark_expression and display_text_expression are evaluated and their results are used to construct a hyperlink that replaces the corresponding link tag then. If uri_or_bookmark_expression returns the name of a bookmark in the same document, then the hyperlink navigates to the bookmark. Otherwise, the hyperlink navigates to a corresponding external resource.</li><li>A link tag cannot be used within a chart.</li></ul>{{< /alert >}}

### Insertion of links to cells for Spreadsheet documents

For Spreadsheet documents, behavior of link tags is changed as follows. If an expression defined within a link tag is evaluated to a cell or cell range reference during runtime, then the tag is replaced with a link to the corresponding cell or cell range.

The following table describes supported formats of cell and cell range references.

| Description | Format | Example |
| --- | --- | --- |
| Reference to a cell within the same worksheet | cell\_name | A1 |
| Reference to a cell in another worksheet | worksheet\_name!cell\_name | Sheet1!A1 |
| Reference to a cell range within the same worksheet | <u>start\_cell\_name:end\_cell\_name</u> | A1:B2 |
| Reference to a cell range in another worksheet | worksheet\_name!<u>start\_cell\_name:end\_cell\_name</u> | Sheet1!A1:B2 |

Following is sample syntax, If the insertion of the link to cell A1 is required :

```java
<<link ["A1"] ["Home"]>>
```

### Insertion of links to slides for Presentation documents

For Presentation documents, behavior of link tags is changed as follows. If an expression defined within a link tag is evaluated to a "SlideN" value, where N is a one-based index of a slide within the same Presentation document, then the tag is replaced with a link to the corresponding slide during run time.

See the example of the syntax as follows:

```java
<<link ["Slide1"] ["Home"]>>
```

## Code Examples and Templates

### Word Processing Documents

{{< gist GroupDocsGists f1decf3faf5c8fcdb81fccf94fc8cad7 >}}

#### Download

*   [Dynamic Hyperlink.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Hyperlink.docx)

### Presentation Documents 

{{< gist GroupDocsGists 61ee36879c73580e94bc28e785939d97 >}}

#### Download

*   [Dynamic Hyperlink.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Dynamic%20Hyperlink.pptx)

### Spreadsheet Documents

{{< gist GroupDocsGists 96fca37e49981d71d65800819e4a5646 >}}

#### Download

*   [Dynamic Hyperlink.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Dynamic%20Hyperlink.xlsx)

### Email Documents 

{{< gist GroupDocsGists 4b28e8a55eb2ca6a05630e60caa8ea61 >}}

#### Download

*   [Dynamic Hyperlink.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Dynamic%20Hyperlink.msg)

---

## Inserting Hyperlinks Dynamically

Path: /assembly/net/inserting-hyperlinks-dynamically/

{{< alert style="info" >}}This feature is supported by version 18.7. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Inserting Hyperlinks Dynamically

Using GroupDocs.Assembly, you can insert hyperlinks to your reports dynamically using link tags. The syntax of a link tag is defined as follows:

```csharp
<<link [uri_expression][display_text_expression]>>
```

Here, **uri\_expression** defines URI for a hyperlink to be inserted dynamically. This expression is mandatory and must return a non-empty value. In turn, **display\_text\_expression** defines text to be displayed for the hyperlink. This expression is optional. If it is omitted or returns an empty value, then during runtime, a value of **uri\_expression** is used as display text as well. Values of both **uri\_expression** and **display\_text\_expression** can be of any types. During runtime, **Object.ToString()** is invoked to get textual representations of these expressions’ values, which is useful for expressions of types like Uri, for example, while building a report, **uri\_expression** and **display\_text\_expression** are evaluated and their results are used to construct a hyperlink that replaces the corresponding link tag then.

### Dynamic insertion of links to bookmarks 

{{< alert style="info" >}}This feature is supported by version 19.11. or greater{{< /alert >}}

#### Insertion of links for Word Processing documents and Emails

You can also insert links to bookmarks to your reports dynamically using link tags. The syntax of a link tag is defined as follows:

```csharp
<<link [uri_or_bookmark_expression][display_text_expression]>>
```

Here, **uri\_or\_bookmark\_expression** defines URI or the name of a bookmark within the same document for a hyperlink to be inserted dynamically. This expression is mandatory and must return a non-empty value.In turn, **display\_text\_expression** defines text to be displayed for the hyperlink. This expression is optional. If it is omitted or returns an empty value, then during runtime, a value of **uri\_or\_bookmark\_expression** is used as display text as well.

{{< alert style="warning" >}}

* Values of both uri_or_bookmark_expression and display_text_expression can be of any types. During runtime, Object.ToString() is invoked to get textual representations of these expressions’ values, which is useful for expressions of types like Uri, for example. While building a report, uri_or_bookmark_expression and display_text_expression are evaluated and their results are used to construct a hyperlink that replaces the corresponding link tag then. If uri_or_bookmark_expression returns the name of a bookmark in the same document, then the hyperlink navigates to the bookmark. Otherwise, the hyperlink navigates to a corresponding external resource.

* A link tag cannot be used within a chart.

{{< /alert >}}

#### Insertion of links to cells for Spreadsheet documents

For Spreadsheet documents, behavior of link tags is changed as follows. If an expression defined within a link tag is evaluated to a cell or cell range reference during runtime, then the tag is replaced with a link to the corresponding cell or cell range.

The following table describes supported formats of cell and cell range references.

| Description | Format | Example |
| --- | --- | --- |
| Reference to a cell within the same worksheet | cell\_name | A1 |
| Reference to a cell in another worksheet | worksheet\_name!cell\_name | Sheet1!A1 |
| Reference to a cell range within the same worksheet | start\_cell\_name:end\_cell\_name | A1:B2 |
| Reference to a cell range in another worksheet | worksheet\_name!start\_cell\_name:end\_cell\_name | Sheet1!A1:B2 |

Following is sample syntax, If the insertion of the link to cell A1 is required :

```csharp
<<link ["A1"] ["Home"]>>
```

#### Insertion of links to slides for Presentation documents

For Presentation documents, behavior of link tags is changed as follows. If an expression defined within a link tag is evaluated to a "SlideN" value, where N is a one-based index of a slide within the same Presentation document, then the tag is replaced with a link to the corresponding slide during run time.

See the example of the syntax as follows:

```csharp
<<link ["Slide1"] ["Home"]>>
```

## Code Examples and Templates

### Word Processing Documents

{{< gist GroupDocsGists 4087b38f9a93682ffa191599eaacac83 >}}

#### Download

*   [Dynamic Hyperlink.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Dynamic%20Hyperlink.docx)

### Presentation Documents 

{{< gist GroupDocsGists 38e274938c8b7328e250a5d8f1d15092 >}}

#### Download

*   [Dynamic Hyperlink.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Dynamic%20Hyperlink.pptx)

### Spreadsheet Documents 

{{< gist GroupDocsGists 78df21c7cc456a544d46d5b0af95c263 >}}

#### Download

*   [Dynamic Hyperlink.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Dynamic%20Hyperlink.xlsx)

### Email Documents

{{< gist GroupDocsGists e5bd8e2bb7406f93ad39dc10eb9f8eb7 >}}

#### Download

*   [Dynamic Hyperlink.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Dynamic%20Hyperlink.msg)

---

## Introduction

Path: /editor/net/introduction/

> This article explains the most common and fundamental principles of GroupDocs.Editor, how it works, what is its purpose, and how it should be used.

[**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) is a .NET GUI-less class library, which means that it has only programmatic interface (API). This fact means that in order to edit a document user must use GroupDocs.Editor in conjunction with some 3rd-party editor application, through which GUI the end-user is able to edit document content. For GroupDocs.Editor it is not important which exactly editor software is used. But because GroupDocs.Editor is aimed on web-development, it has the only requirement — 3rd-party editor should be compatible with HTML documents.

In order to edit a document with GroupDocs.Editor, user must perform several sequential steps: load document into GroupDocs.Editor (using optional load options), open document for editing (with optional edit options), generate HTML markup with resources (using different options and settings), and pass this markup to the 3rd-party WYSIWYG HTML-editor. Then end-user edits the document content, and when he finish editing and submits the edited document, this modified markup should be transferred back to the GroupDocs.Editor and converted to the output document of desired format.

From the GroupDocs.Editor perspective, this pipeline can be conditionally divided onto three main stages, that are described below.

## Loading document into the GroupDocs.Editor

On the *[loading document]({{< ref "editor/net/developer-guide/load-document.md" >}})* stage user should create an instance of the [`Editor` class](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) and pass an input document (through file path or byte stream) along with document load options. Loading options are not required and GroupDocs.Editor can automatically detect document format and select the most appropriate default options for the given format. But it is recommended to specify them explicitly. They are inevitable when trying to load the password-protected documents.

```csharp
string inputFilePath = "C:\\input_path\\document.docx"; //path to some document
Editor editor = new Editor(inputFilePath); //passing path to the constructor, default WordProcessingLoadOptions will be applied automatically
```

After this stage document is ready to be opened and edited.

## Opening a document for editing

Because GroupDocs.Editor is GUI-less library, document cannot be edited directly into it. But in order to edit document in WYSIWYG HTML-editor, GroupDocs.Editor needs to generate an HTML-version of a document, because any WYSIWYG editor can work only with HTML/CSS markup. When instance of [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class is created on the 1st stage, user should *[open document for editing]({{< ref "editor/net/developer-guide/edit-document" >}})* by calling an [Edit()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method of [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class. This method returns an instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class. This class can be described as a converted version of input document, that is stored in internal intermediate format, compatible with all formats, that GroupDocs.Editor supports. With [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument)user can obtain HTML markup of the input document with different options, stylesheets, images, fonts, save HTML-document to disk, and other things. It is implied that HTML-markup, emitted by [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), then is passed into the client-side WYSIWYG HTML-editor, where end-user can actually edit the document.

Like with loading, [Edit()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method obtains optional [IEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ieditoptions) inheritors, that controls how exactly the document will be opened for edit.

```csharp
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.EnableLanguageInformation = true;

EditableDocument readyToEdit = editor.Edit(editOptions);
```

After this stage document is ready to be passed to the WYSIWYG HTML-editor and its content can be edited by the end-user.

## Saving a document

*[Saving a document]({{< ref "editor/net/developer-guide/save-document.md" >}})* is a final stage, which occurs when document content was edited in the WYSIWYG HTML-editor (or any other software, this has no difference for GroupDocs.Editor) and should be saved back as a document of some format (like DOCX, PDF, or XLSX, for example). At this stage user should create a new instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class with HTML-markup and resources of edited version of the original document, that was obtained from end-user. [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class contains several static methods, that allows to create its instances from HTML documents, that may be presented in different forms. And when [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance is ready, it is possible to save it as an ordinary document using a [Save()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method of [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class.

```csharp
EditableDocument afterEdit = EditableDocument.FromMarkup("<body>HTML content of the document...</body>", null);
string outputFilePath = "C:\\output_path\\document.rtf";
Options.WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);
editor.Save(afterEdit, outputFilePath, saveOptions);
```

Unlike with previous load options and edit options, save options are mandatory, because GroupDocs.Editor needs to know exact document format for saving.

## Detecting document type

Sometimes it is necessary to *[detect a document type and extract its metadata]({{< ref "editor/net/developer-guide/extracting-document-metainfo.md" >}})* before sending it for editing. For such scenarios GroupDocs.Editor allows to detect document type and extract its the most necessary metainfo depending on document type:

1. Is document encoded or not;
2. Exact document format;
3. Document size;
4. Number of pages (tabs);
5. Text encoding, if document is textual.

In order to detect document type and gather its meta info, user should load a desired document into the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class and then call a [GetDocumentInfo()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) method.

## Describing options

On every stage user can adjust (tune) the processing by different options:

1. [ILoadOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/iloadoptions) for *loading* document.
2. [IEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ieditoptions) for opening document for *editing*.
3. [ISaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/isaveoptions) for *saving* edited document.

Some of these options may be optional in specific cases, some are mandatory. For example, it is possible to load a document into the `Editor` class without loading options, — in such case GroupDocs.Editor will try to detect the document format automatically and apply the most appropriate default options for detected document format.

### Describing family formats

All document formats, which GroupDocs.Editor supports, are grouped into family formats. Each family format has lot of common features, so there is no options for each format — only for family format. Relation between formats, family formats, import/export formats and options is illustrated in the table below.

| Family format | Supported formats | Load | Save | Load options | Edit options | Save options | Metadata |
| --- | --- | --- | --- | --- | --- | --- | --- |
| WordProcessing | DOC, DOCX, DOCM, DOT,DOTX, DOTM, RTF,WordprocessingML Flat XML, ODT, OTT, Word 2003 XML | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | [WordProcessingLoadOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingloadoptions) | [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) | [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) | [WordProcessingDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo) |
| Spreadsheet | XLS, XLT, XLSX, XLSM, XLSB, XLTX, XLTM, XLAM, SpreadsheetML XML, ODS, FODS, SXC, DIF | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | [SpreadsheetLoadOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetloadoptions) | [SpreadsheetEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheeteditoptions) | [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) | [SpreadsheetDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/spreadsheetdocumentinfo) |
| DSV | CSV, TSV, semicolon-separated, whitespace-separated, arbitrary separator | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | N/A | [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions) | [DelimitedTextSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtextsaveoptions) | N/A |
| Presentation | PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | [PresentationLoadOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationloadoptions) | [PresentationEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationeditoptions) | [PresentationSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) | [PresentationDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/presentationdocumentinfo) |
| XML | Any XML document | ![(tick)](/editor/net/images/check.png) | ![(error)](/editor/net/images/error.png) | N/A | [XmlEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions) | N/A | [TextualDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo) |
| TXT | Any text document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | N/A | [TextEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions) | [TextSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/textsaveoptions) | [TextualDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo) |
| Fixed-layout format | PDF | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | [PdfLoadOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfloadoptions) | [PdfEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfeditoptions) | [PdfSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions) | [FixedLayoutDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo) |
| Fixed-layout format | XPS (including OpenXPS) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | N/A | N/A | [XpsSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xpssaveoptions) | [FixedLayoutDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo) |
| e-Book | Mobi, AZW3, ePub | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | N/A | [EbookEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) | [Azw3SaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/azw3saveoptions) / [EpubSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/epubsaveoptions) | [EbookDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo) |
| Email | EML, EMLX, TNEF, MSG, HTML, MHTML, ICS, VCF, PST, MBOX, OFT | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | N/A | [EmailEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emaileditoptions) | [EmailSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emailsaveoptions) | [EmailDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/emaildocumentinfo) |


### Additional materials

Detailed information about every stage of document processing along with source code examples, options explanations and so on, can be found in the next articles:

1. [Load document]({{< ref "editor/net/developer-guide/load-document.md" >}})
2. [Edit document]({{< ref "editor/net/developer-guide/edit-document" >}})
3. [Save document]({{< ref "editor/net/developer-guide/save-document.md" >}})

Complete description of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, all its possibilities, members and purpose, along with source code example, is located in the next articles:

* [Working with EditableDocument]({{< ref "editor/net/developer-guide/editabledocument" >}})
* [Get HTML markup in different forms]({{< ref "editor/net/developer-guide/editabledocument/get-html-markup-in-different-forms.md" >}})
* [Save HTML to folder]({{< ref "editor/net/developer-guide/editabledocument/save-html-to-folder.md" >}})
* [Working with resources]({{< ref "editor/net/developer-guide/editabledocument/working-with-resources.md" >}})
* [Create EditableDocument from file or markup]({{< ref "editor/net/developer-guide/editabledocument/create-editabledocument-from-file-or-markup.md" >}})

Detailed review of all supported family formats together with explaining their load/edit/save options, illustrated with source code, can be found in the next articles:

* [Working with PDF documents]({{< ref "editor/net/developer-guide/edit-document/edit-pdf.md" >}})
* [Working with WordProcessing documents]({{< ref "editor/net/developer-guide/edit-document/edit-word" >}})
* [Working with Spreadsheets]({{< ref "editor/net/developer-guide/edit-document/edit-excel" >}})
* [Working with DSV]({{< ref "editor/net/developer-guide/edit-document/how-to-edit-csv-file.md" >}})
* [Working with Presentations]({{< ref "editor/net/developer-guide/edit-document/edit-powerpoint" >}})
* [Working with text documents]({{< ref "editor/net/developer-guide/edit-document/edit-txt.md" >}})

---

## Iterate through container items

Path: /parser/python-net/iterate-through-container-items/


GroupDocs.Parser provides functionality to iterate through items in container documents such as ZIP archives, OST/PST files, and documents with attachments.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample container files (ZIP, OST, PST, etc.)
- Understanding of container/attachment concepts

## Iterate through container items

To iterate through all items in a container:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./archive.zip") as parser:
    # Get container items
    attachments = parser.get_container()
    
    # Check if container extraction is supported
    if attachments is None:
        print("Container extraction isn't supported")
    else:
        # Iterate over items
        for idx, attachment in enumerate(attachments):
            print(f"
Item {idx + 1}:")
            print(f"  Name: {attachment.name}")
            print(f"  Size: {attachment.size} bytes")
            print(f"  Path: {attachment.file_path}")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Iterates through all files in the container and displays their properties.

## Count container items

To count files in a container:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def count_container_items(file_path):
    """
    Count the number of items in a container.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            return 0
        
        # Convert to list to count
        items = list(attachments)
        return len(items)

# Usage
count = count_container_items("archive.zip")
print(f"Container has {count} items")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns the total number of items in the container.

## List container contents with details

To display detailed information about container contents:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def list_container_contents(file_path):
    """
    List all container contents with detailed information.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return
        
        print(f"{'#':<5}{'Name':<40}{'Size':<15}{'Path':<30}")
        print("-" * 90)
        
        for idx, attachment in enumerate(attachments, 1):
            name = attachment.name[:38] if len(attachment.name) > 38 else attachment.name
            size = f"{attachment.size:,} bytes"
            path = attachment.file_path[:28] if attachment.file_path and len(attachment.file_path) > 28 else (attachment.file_path or "")
            
            print(f"{idx:<5}{name:<40}{size:<15}{path:<30}")

# Usage
list_container_contents("documents.zip")
```

{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [documents.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/documents.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Displays a formatted table of all container items with their properties.

## Filter container items by extension

To filter and process only specific file types:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

def filter_by_extension(file_path, extensions):
    """
    Filter container items by file extension.
    
    Args:
        file_path: Path to container
        extensions: List of extensions to include (e.g., ['.pdf', '.docx'])
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return []
        
        filtered_items = []
        
        for attachment in attachments:
            file_ext = os.path.splitext(attachment.name)[1].lower()
            
            if file_ext in extensions:
                filtered_items.append({
                    'name': attachment.name,
                    'size': attachment.size,
                    'extension': file_ext
                })
        
        return filtered_items

# Usage - find all PDF and Word documents
items = filter_by_extension("archive.zip", ['.pdf', '.docx', '.doc'])

print(f"Found {len(items)} PDF/Word documents:
")
for item in items:
    print(f"  {item['name']} ({item['size']:,} bytes)")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns only items matching the specified file extensions.

## Calculate total container size

To calculate the total size of all items:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def calculate_container_size(file_path):
    """
    Calculate total size of all items in container.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return 0
        
        total_size = 0
        item_count = 0
        
        for attachment in attachments:
            total_size += attachment.size
            item_count += 1
        
        return {
            'total_size': total_size,
            'item_count': item_count,
            'average_size': total_size / item_count if item_count > 0 else 0
        }

# Usage
stats = calculate_container_size("archive.zip")

print(f"Container Statistics:")
print(f"  Items: {stats['item_count']}")
print(f"  Total Size: {stats['total_size']:,} bytes ({stats['total_size'] / 1024 / 1024:.2f} MB)")
print(f"  Average Size: {stats['average_size']:,.0f} bytes")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Calculates and displays size statistics for the container.

## Group items by file type

To categorize items by file type:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from collections import defaultdict
import os

def group_by_file_type(file_path):
    """
    Group container items by file extension.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return {}
        
        groups = defaultdict(list)
        
        for attachment in attachments:
            ext = os.path.splitext(attachment.name)[1].lower() or 'no_extension'
            groups[ext].append({
                'name': attachment.name,
                'size': attachment.size
            })
        
        return dict(groups)

# Usage
groups = group_by_file_type("mixed_archive.zip")

print("Files grouped by type:\n")
for ext, items in sorted(groups.items()):
    total_size = sum(item['size'] for item in items)
    print(f"{ext.upper()} files: {len(items)} items, {total_size:,} bytes")
    for item in items[:3]:  # Show first 3
        print(f"  - {item['name']}")
    if len(items) > 3:
        print(f"  ... and {len(items) - 3} more")
    print()
```

{{< /tab >}}
{{< tab "mixed_archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [mixed_archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/mixed_archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Organizes and displays items grouped by file extension.

## Search for specific files

To search for files by name pattern:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import re

def search_container_items(file_path, pattern):
    """
    Search for items matching a name pattern.
    
    Args:
        file_path: Path to container
        pattern: Regex pattern to match file names
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return []
        
        regex = re.compile(pattern, re.IGNORECASE)
        matches = []
        
        for attachment in attachments:
            if regex.search(attachment.name):
                matches.append({
                    'name': attachment.name,
                    'size': attachment.size,
                    'path': attachment.file_path
                })
        
        return matches

# Usage - find all files containing "invoice"
matches = search_container_items("documents.zip", r'invoice')

print(f"Found {len(matches)} matching files:
")
for match in matches:
    print(f"  {match['name']} ({match['size']:,} bytes)")
```

{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [documents.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/documents.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns items whose names match the search pattern.

## Process items with progress tracking

To iterate with progress indication:
{{< tabs "example-8" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def process_with_progress(file_path):
    """
    Process container items with progress tracking.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return
        
        # Convert to list to get total count
        items = list(attachments)
        total = len(items)
        
        print(f"Processing {total} items...
")
        
        for idx, attachment in enumerate(items, 1):
            # Show progress
            progress = (idx / total) * 100
            print(f"[{progress:5.1f}%] Processing: {attachment.name}")
            
            # Process item (example: just count size)
            # In real scenario, you might extract text, etc.
            
            # Simulate processing
            # time.sleep(0.1)
        
        print("\nProcessing complete!")

# Usage
process_with_progress("archive.zip")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Processes items while showing progress percentage.

## Export container inventory to CSV

To create a CSV inventory of container contents:
{{< tabs "example-9" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import csv

def export_inventory_to_csv(file_path, output_csv):
    """
    Export container inventory to CSV file.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return False
        
        # Write to CSV
        with open(output_csv, 'w', newline='', encoding='utf-8') as csvfile:
            fieldnames = ['Index', 'Name', 'Size (bytes)', 'Path']
            writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
            
            writer.writeheader()
            
            for idx, attachment in enumerate(attachments, 1):
                writer.writerow({
                    'Index': idx,
                    'Name': attachment.name,
                    'Size (bytes)': attachment.size,
                    'Path': attachment.file_path or ''
                })
        
        print(f"Inventory exported to {output_csv}")
        return True

# Usage
export_inventory_to_csv("archive.zip", "inventory.csv")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "inventory.csv" >}}
{{< tab-text >}}
The following sample file is used in this example: [inventory.csv](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items/inventory.csv)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a CSV file listing all container items and their properties.

## Notes

- The `get_container()` method returns `None` if container extraction is not supported
- Container items have properties: `name`, `size`, and `file_path`
- Use `open_parser()` on items to create a parser for individual files
- Container iteration is lightweight and doesn't extract file contents
- Supports ZIP, OST, PST, and documents with attachments
- Item names may include relative paths for nested structures

## Related pages

- [Extract data from ZIP archives]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives" >}})
- [Detect file type of container item]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-archives/detect-file-type-of-container-item" >}})
- [Extract data from attachments]({{< ref "parser/python-net/developer-guide/basic-usage/extract-data-from-attachments-and-zip-archives" >}})


---

## Licensing

Path: /parser/python-net/licensing-and-evaluation-limitations/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Parser provides different purchase plans or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are several general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Parser without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in several ways that are described in the next sections of this article.

The evaluation version comes with the following limitations:

- Only **100 files per session**
- Only **5 pages** (slides, sheets) of a document can be processed
- **Text extraction:** Only 20 lines per file, only the first 1600 symbols, only the first 5 pages + evaluation marks
- **Metadata extraction:** Only 5 properties per file

### Temporary License

If you wish to test GroupDocs.Parser without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set up a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/parser/python-net) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other GroupDocs.Parser classes.

{{< alert style="info" >}}

The license can be set multiple times per application domain, but we recommend doing it once since all the subsequent calls to the `set_license` method except for the first one will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from a file:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import License

def set_license_from_file():
    # Create an instance of License class
    license = License()
    
    # Set the license from file path
    license.set_license("path/to/GroupDocs.Parser.lic")

if __name__ == "__main__":
    set_license_from_file()
```

{{< /tab >}}
{{< /tabs >}}

### Set License from Stream

The following code snippet shows how to set a license from a stream:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import License

def set_license_from_stream():
    # Open the license file
    with open("path/to/GroupDocs.Parser.lic", "rb") as stream:
        # Create an instance of License class
        license = License()
        
        # Set the license from stream
        license.set_license(stream)

if __name__ == "__main__":
    set_license_from_stream()
```

{{< /tab >}}
{{< /tabs >}}

### Set Metered License

A [Metered License](https://reference.groupdocs.com/parser/python-net/groupdocs.parser/metered) is also available as an alternative to a traditional license file. It is a usage-based licensing model that may be more suitable for customers who prefer to be billed based on actual API feature usage. For more information, refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered).

The following sample demonstrates how to use metered licensing:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Metered

def set_metered_license():
    # Set your public and private keys
    public_key = "******"
    private_key = "******"
    
    # Instantiate Metered and set keys
    metered = Metered()
    metered.set_metered_key(public_key, private_key)
    
    # Get amount (MB) consumed
    consumption_quantity = Metered.get_consumption_quantity()
    print(f"Amount (MB) consumed: {consumption_quantity}")
    
    # Get count of credits consumed
    consumption_credit = Metered.get_consumption_credit()
    print(f"Credits consumed: {consumption_credit}")

if __name__ == "__main__":
    set_metered_license()
```

{{< /tab >}}
{{< /tabs >}}

## Evaluation Limitations Summary

| API Feature | Limit Without License |
| --- | --- |
| **Files per session** | Only 100 files |
| **Pages per document** | Only 5 pages (slides, sheets) |
| **Text extraction** | Only 20 lines per file<br/>Only the first 1600 symbols<br/>Only the first 5 pages<br/>+ Evaluation marks |
| **Metadata extraction** | Only 5 properties per file |

{{< alert style="warning" >}}
**Important:** For a full-featured evaluation without limitations, request a [temporary license](https://purchase.groupdocs.com/temporary-license) which allows you to test all features for 30 days.
{{< /alert >}}

---

## Limitations when rendering CAD drawings

Path: /viewer/net/limitations-when-rendering-cad-drawings/

{{< alert style="success" >}}This limitation exists in the 20.6.1 version and earlier. Do not set an assembly binding redirect if you use version 20.7 or later.{{< /alert >}}

## Rendering CAD drawings requires adding assembly binding redirect

When rendering CAD drawings using GroupDocs.Viewer, it is required to add the [assembly binding redirect](https://docs.microsoft.com/en-us/dotnet/framework/configure-apps/redirect-assembly-versions) to the app.config or web.config project files. The following example shows the required assembly binding redirect to render CAD drawings with GroupDocs.Viewer for .NET 20.6.1 and earlier.

{{< tabs "example1">}}
{{< tab "Project file" >}}
```xml
<configuration>
    <!--...-->
    <runtime>
        <!--...-->
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <!--...-->
            <dependentAssembly>
                <assemblyIdentity name="Aspose.PDF" publicKeyToken="716fcc553a201e56" culture="neutral"/>
                <bindingRedirect oldVersion="0.0.0.0-20.5.0.0" newVersion="20.5.0.0"/>
                <publisherPolicy apply="no"/>
            </dependentAssembly>
        </assemblyBinding>
    </runtime>
</configuration>
```
{{< /tab >}}
{{< /tabs >}}

---

## Load CSV document with options

Path: /conversion/java/load-csv-document-with-options/

This documentation outlines how to load CSV documents with configurable options using [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/). It enables developers to handle and convert CSV files into various target formats (e.g., PDF, XLSX, DOCX) while providing fine-grained control over the loading and rendering process. The [CsvLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CsvLoadOptions) class gives you the ability to set the following options:
| Option | Description |
|--------|-------------|
| [**setSeparator()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CsvLoadOptions#setSeparator(char)) | Specifies the delimiter. |
| [**setMultiEncoded()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CsvLoadOptions#setMultiEncoded(boolean)) | Whether *true*, this means that the document contains several encodings. |
| [**setFormula()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CsvLoadOptions#hasFormula()) | Specifies that if text starts with "=" it should be parsed as a formula. |
| [**setConvertNumericData()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CsvLoadOptions#setConvertNumericData(boolean)) | Specifies that strings with digits should be parsed as numbers. |
| [**setConvertDateTimeData()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CsvLoadOptions#setConvertDateTimeData(boolean)) | Specifies that date/time strings should be detected and parsed to DateTime. |
| [**setEncoding()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/CsvLoadOptions#setEncoding(java.nio.charset.Charset)) | Specifies the encoding to be used during loading. |

### Control behavior of converting date/time and numeric data

The following code snippet shows how to convert a CSV document and control the way the date/time and numeric data have been processed:

{{< tabs "code-example">}}
{{< tab "ConvertCsvByConvertingDateTimeAndNumericData.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;
import com.groupdocs.conversion.options.load.CsvLoadOptions;

public class ConvertCsvByConvertingDateTimeAndNumericData {
    public static void convert() {
        CsvLoadOptions loadOptions = new CsvLoadOptions();;
        loadOptions.setConvertDateTimeData(true);
        loadOptions.setConvertNumericData(true);

        try(Converter converter = new Converter("sample.csv", () -> loadOptions)) {
            SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
            converter.convert("converted_with_data.xlsx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.csv" >}}  
{{< tab-text >}}
`sample.csv` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-csv-document-with-options/sample.csv) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_data.xlsx" >}}  
{{< tab-text >}}
`converted_with_data.xlsx` is converted XLSX document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-csv-document-with-options/converted_with_data.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Specify delimiter

The following code snippet shows how to convert a CSV document and specify the delimiter:

{{< tabs "code-example1">}}
{{< tab "ConvertCsvBySpecifyingDelimiter.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.CsvLoadOptions;

public class ConvertCsvBySpecifyingDelimiter {
    public static void convert() {
        CsvLoadOptions loadOptions = new CsvLoadOptions();;
        loadOptions.setSeparator(',');

        try(Converter converter = new Converter("sample.csv", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_delimiter.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.csv" >}}  
{{< tab-text >}}
`sample.csv` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-csv-document-with-options/sample.csv) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_delimiter.pdf" >}}  
{{< tab-text >}}
`converted_with_delimiter.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-csv-document-with-options/converted_with_delimiter.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Specify encoding

The following code snippet shows how to convert a CSV document and specify the encoding:

{{< tabs "code-example2">}}
{{< tab "ConvertCsvBySpecifyingEncoding.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.CsvLoadOptions;

public class ConvertCsvBySpecifyingEncoding {
    public static void convert() {
        CsvLoadOptions loadOptions = new CsvLoadOptions();;
        loadOptions.setEncoding(java.nio.charset.Charset.forName("shift_jis"));

        try(Converter converter = new Converter("sample.csv", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_encoding.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.csv" >}}  
{{< tab-text >}}
`sample.csv` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-csv-document-with-options/sample.csv) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_encoding.pdf" >}}  
{{< tab-text >}}
`converted_with_encoding.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-csv-document-with-options/converted_with_encoding.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Load CSV document with options

Path: /conversion/net/load-csv-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [CsvLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/csvloadoptions) to give you control over how the source CSV document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[Separator](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/csvloadoptions/separator)** | Specifies the delimiter |
|**[AllColumnsInOnePagePerSheet](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/allcolumnsinonepagepersheet)** | If *true*, all column content from a single sheet will be converted into a single page. The width of paper size of page setup will be ignored, while keeping the rest of page settings. |
|**[AutoFitRows](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/autofitrows)** | If enabled, automatically adjusts the content of all rows while converting. |
|**[CheckExcelRestriction](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/checkexcelrestriction)** | Whether to check restrictions of Excel file when modifying cell objects. |
|**[ConvertNumericData](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/csvloadoptions/convertnumericdata)** | Specifies that strings with digits should be parsed as numbers |
|**[ConvertDateTimeData](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/csvloadoptions/convertdatetimedata)** | Specifies that date/time strings should be detected and parsed to DateTime |
|**[ConvertRange](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/convertrange)** | Defines a specific range of cells to be converted. For example: "D1:F8" |
|**[CultureInfo](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/cultureinfo)** | Specifies system culture info at the time file is loaded. |
|**[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/defaultfont)** | Specify the default font to use if a document font is missing. |
|**[Encoding](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/csvloadoptions/encoding)** | Specifies the encoding to be used during loading |
|**[FontSubstitutes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/fontsubstitutes)** | Substitute specific fonts from the source spreadsheet. |
|**[HasFormula](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/csvloadoptions/hasformula)** | Specifies that if text starts with "=" it should be parsed as a formula |
|**[HideComments](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/hidecomments)** | Specify if the comments from the source spreadsheet should be hidden during conversion. |
|**[IsMultiEncoded](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/csvloadoptions/ismultiencoded)** | If *true*, this means that the document contains several encodings. |
|**[OnePagePerSheet](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/onepagepersheet)** | If specified, each spreadsheet will be converted into a single page. |
|**[OptimizePdfSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/optimizepdfsize)** | If enabled, optimizes the resulting PDF for smaller file size, rather than for better print quality. |
|**[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/password)** | Defines a password to unlock a protected document. |
|**[SheetIndexes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/sheetindexes/)** | Defines the indexes of the particular sheets to be converted. |
|**[Sheets](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/sheets/)** | Defines the names of the particular sheets to be converted. |
|**[ShowGridLines](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/showgridlines)** | Specify if the grid lines should be visible. |
|**[ShowHiddenSheets](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/showhiddensheets)** | Specify if the hidden sheets should be included in the converted document. |
|**[SkipEmptyRowsAndColumns](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/skipemptyrowsandcolumns)** | Specify if empty rows and columns should be ignored. |

### Control behavior of converting date/time and numeric data

The following code snippet shows how to convert a CSV document and control the way the date/time and numeric data have been processed:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CsvLoadOptions
{
    ConvertDateTimeData = true,
    ConvertNumericData = true
};
using (Converter converter = new Converter("sample.csv", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify delimiter

The following code snippet shows how to convert a CSV document and specify the delimiter:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CsvLoadOptions
{
    Separator = ','
};
using (Converter converter = new Converter("sample.csv", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify encoding

The following code snippet shows how to convert a CSV document and specify the encoding:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CsvLoadOptions
{
    Encoding = Encoding.GetEncoding("shift_jis")
};
using (Converter converter = new Converter("sample.csv", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Automatically fit rows

To fit the row content of all rows while converting, set the [AutoFitRows](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/autofitrows/) property to `true`:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CsvLoadOptions
{
    AutoFitRows = true
};
using (Converter converter = new Converter("sample.csv", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```
---

## Load CSV document with options

Path: /conversion/nodejs-java/load-csv-document-with-options/

GroupDocs.Conversion provides [CsvLoadOptions](#) to give you control over how the source CSV document will be processed. The following options could be set:

*   **[setSeparator](#)**  specifies the delimiter.
*   **[setIsMultiEncoded](#)** whether *true*, this means that the document contains several encodings.
*   **[hasFormula](#)** specifies that if text starts with "=" it should be parsed as a formula.
*   **[setConvertNumericData](#)** specifies that strings with digits should be parsed as numbers.
*   **[setConvertDateTimeData](#)** specifies that date/time strings should be detected and parsed to DateTime.
*   **[setEncoding](#)** specifies the encoding to be used during loading.

### Control behavior of converting date/time and numeric data

The following code snippet shows how to convert a CSV document and control the way the date/time and numeric data have been processed:

```js
const loadOptions = new groupdocs.conversion.CsvLoadOptions()
loadOptions.setConvertDateTimeData(true)
loadOptions.setConvertNumericData(true)

const outputPath = "ConvertCsvByConvertingDateTimeAndNumericData.pdf"

const converter = new groupdocs.conversion.Converter("sample.csv", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`CSV document converted successfully to ${outputPath} (converting dateTime & numeric data)`)
converter.convert(outputPath, convertOptions)
```

### Specify delimiter

The following code snippet shows how to convert a CSV document and specify the delimiter:

```js
const loadOptions = new groupdocs.conversion.CsvLoadOptions()
loadOptions.setSeparator(",")

const outputPath = `ConvertCsvBySpecifyingDelimiter.pdf`

const converter = new groupdocs.conversion.Converter("sample.csv", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`CSV document converted successfully to ${outputPath} (specifying delimiter)`)
converter.convert(outputPath, convertOptions)
```

### Specify encoding

The following code snippet shows how to convert a CSV document and specify the encoding:

```js
const loadOptions = new groupdocs.conversion.CsvLoadOptions()
loadOptions.setEncoding("Shift_JIS")

const outputPath = `ConvertCsvBySpecifyingEncoding.pdf`

const converter = new groupdocs.conversion.Converter("sample.csv", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`CSV document converted successfully to ${outputPath} (encoding specified)`)
converter.convert(outputPath, convertOptions)
```

---

## Load document

Path: /editor/java/load-document/

> This article describes how to load input document to the [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) and how to apply load options.

First of all the input document, which should be accessible as a byte stream or through valid file path, should be loaded into the GroupDocs.Editor by creating an instance of the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class through one of the constructor overloads.  
Source code below shows two ways of loading documents: from path and from stream.

```java
//through path
String inputFilePath = "C:\\input_path\\document.docx"; //path to some document
Editor editor = new Editor(inputFilePath);

//through stream
InputStream inputStream = new FileInputStream(inputFilePath);
Editor editor = new Editor(inputStream);
```

When two overloads from example above are used, GroupDocs.Editor automatically detects the format of input document and applies the most appropriate default loading options for the input document.  
However, it is possible and even recommended to specify correct loading options explicitly using constructor overloads, which accept two parameters. Source code below shows using such options.

```java
//through path
String inputFilePath = "C:\\input_path\\document.docx"; //path to some document
WordProcessingLoadOptions wordLoadOptions = new WordProcessingLoadOptions();
Editor editor1 = new Editor(inputFilePath, wordLoadOptions); //passing path and load options (via delegate) to the constructor

//through stream
InputStream inputStream = new ByteArrayInputStream(new byte[0]); //obtained from somewhere
SpreadsheetLoadOptions spreadsheetLoadOptions = new SpreadsheetLoadOptions();
Editor editor = new Editor(inputStream, spreadsheetLoadOptions);
```

Please note that not all document formats have appropriate classes, that represent load options. As for version 19.10, only WordProcessing, Spreadsheet and Presentation family formats have load options. For other document types, such as DSV, TXT or XML, there are no load options.

| Format family | Example formats | Load options class |
| --- | --- | --- |
| WordProcessing | DOC, DOCX, DOCM, DOT, ODT | `WordProcessingLoadOptions` |
| Spreadsheet | XLS, XLSX, XLSM, XLSB | `SpreadsheetLoadOptions` |
| Presentation | PPT, PPTX, PPS, POT | `PresentationLoadOptions` |

Using load options is the only way for working with password-protected input documents. Any document can be loaded into the `Editor` instance, even encoded document without the password. However, on the next step — opening for editing, — the exception will be thrown. GroupDocs.Editor handles passwords and encoded documents in the next way:

1. If document is not encoded, password is ignored anyway, whether or not it was specified.
2. If document is password-protected, but password is not specified, the [PasswordRequiredException](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/passwordrequiredexception) will be thrown later during editing.
3. If document is password-protected, and password is specified, but is incorrect, the [IncorrectPasswordException](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/incorrectpasswordexception) will be thrown later during editing.

Example below shows specifying password for opening some password-protected WordProcessing document.

```java
Stream inputStream = getDocumentStreamFromSomewhere();
WordProcessingLoadOptions wordLoadOptions = new WordProcessingLoadOptions();
wordLoadOptions.setPassword("correct_password");
Editor editor = new Editor(inputFilePath, wordLoadOptions);
```

{{< alert style="info" >}}Same approach is applicable for Spreadsheet and Presentation documents too.{{< /alert >}}

---

## Load Document

Path: /editor/nodejs-java/load-document/


> This article describes how to load an input document into **GroupDocs.Editor for Node.js via Java** and how to apply load options.

First, the input document, which should be accessible as a byte stream or through a valid file path, should be loaded into GroupDocs.Editor by creating an instance of the `Editor` class through one of its constructor overloads. The source code below shows two ways of loading documents: from a path and from a stream.

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Loading from path
const inputFilePath = 'C:\\input_path\\document.docx'; // Path to some document
const editor = new groupdocsEditor.Editor(inputFilePath);

// Loading from stream
const inputStream = fs.createReadStream(inputFilePath);
const editor = new groupdocsEditor.Editor(inputStream);
```

When using the two overloads from the example above, GroupDocs.Editor automatically detects the format of the input document and applies the most appropriate default loading options for it.

However, it is possible and even recommended to specify correct loading options explicitly using constructor overloads that accept two parameters. The source code below shows how to use such options.

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Loading from path with load options
const inputFilePath = 'C:\\input_path\\document.docx'; // Path to some document
const wordLoadOptions = new groupdocsEditor.WordProcessingLoadOptions();
const editor1 = new groupdocsEditor.Editor(inputFilePath, wordLoadOptions);

// Loading from stream with load options
const inputStream = fs.createReadStream(inputFilePath);
const spreadsheetLoadOptions = new groupdocsEditor.SpreadsheetLoadOptions();
const editor = new groupdocsEditor.Editor(inputStream, spreadsheetLoadOptions);
```

Please note that not all document formats have appropriate classes that represent load options. As of version 23.10, only WordProcessing, Spreadsheet, Presentation, and some other family formats have load options. For other document types, such as DSV, TXT, or XML, there are no load options.

| Format Family    | Example Formats                          | Load Options Class                                 |
|------------------|------------------------------------------|----------------------------------------------------|
| WordProcessing   | DOC, DOCX, DOCM, DOT, ODT                | `WordProcessingLoadOptions`                        |
| Spreadsheet      | XLS, XLSX, XLSM, XLSB                    | `SpreadsheetLoadOptions`                           |
| Presentation     | PPT, PPTX, PPS, POT                      | `PresentationLoadOptions`                          |
| Email            | EML, MSG, EMLX, MHT                      | `EmailLoadOptions`                                 |
| PDF              | PDF                                       | `PdfLoadOptions`                                   |

Using load options is essential when working with password-protected input documents. Any document can be loaded into the `Editor` instance, even an encrypted document without the password. However, in the next step—opening for editing—an exception will be thrown. GroupDocs.Editor handles passwords and encrypted documents in the following way:

1. **Document Not Encrypted:**
   - If the document is not encrypted, the password is ignored, whether or not it was specified.
2. **Document Encrypted, Password Not Specified:**
   - If the document is password-protected but no password is specified, a [`PasswordRequiredException`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/PasswordRequiredException) will be thrown later during editing.
3. **Incorrect Password Specified:**
   - If the document is password-protected and a password is specified but is incorrect, an [`IncorrectPasswordException`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/IncorrectPasswordException) will be thrown later during editing.

The example below shows how to specify a password for opening a password-protected WordProcessing document.

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Loading a password-protected document
const inputFilePath = 'C:\\input_path\\protected_document.docx';
const inputStream = fs.createReadStream(inputFilePath);
const wordLoadOptions = new groupdocsEditor.WordProcessingLoadOptions();
wordLoadOptions.setPassword('correct_password');

const editor = new groupdocsEditor.Editor(inputStream, wordLoadOptions);
```

**Note:** The same approach is applicable for Spreadsheet and Presentation documents as well.

---

**Tip:** Always handle exceptions appropriately in your applications, especially when dealing with password-protected or unsupported documents.

---

## Conclusion

This article has demonstrated how to load documents into **GroupDocs.Editor for Node.js via Java** using different methods and how to apply load options, especially when dealing with password-protected documents. By specifying the appropriate load options, you ensure that your documents are correctly processed and ready for editing.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.

---

> **Note:** Replace `'C:\\input_path\\document.docx'` and `'C:\\input_path\\protected_document.docx'` with the actual paths to your documents.

---
---

## Load document from local disk

Path: /merger/java/load-document-from-local-disk/

When the source document is located on the local disk [**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows you to load it via [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) class constructor specifying absolute or relative path to it.  
The following code snippet shows how to load documents from local disk.

```java
String filePath = "c:\sample.docx";
Merger merger = new Merger(filePath);
System.out.print("Document loaded from local disk successfully.");
```

---

## Load document from stream

Path: /annotation/java/load-document-from-stream/

The following code snippet shows how to load a document from a stream:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates loading document from stream.

// Create stream from inputPath
InputStream stream = new FileInputStream("inputPath");

// Create an instance of Annotator class
Annotator annotator = new Annotator(stream);
try {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setBackgroundColor(65535);
    
    // Add annotation and save to file
    annotator.add(area);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}

```
{{< /tab >}}
{{< /tabs >}}
---

## Load document from stream

Path: /annotation/net/load-document-from-stream/

The following code snippet shows how to load a document from a stream:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (documentStream = File.OpenRead("input.pdf"))
using (Annotator annotator = new Annotator(documentStream))
{
     	AreaAnnotation area = new AreaAnnotation()
       {
       	Box = new Rectangle(100, 100, 100, 100),
       	BackgroundColor = 65535,
       };
       annotator.Add(area);
       annotator.Save("result.pdf", new SaveOptions());
}

```
{{< /tab >}}
{{< /tabs >}}
---

## Load document from stream

Path: /conversion/java/load-document-from-stream/

There might be a case when your file is not physically located on the disk. Instead, you have the file in the form of a stream. In this case, to avoid the overhead of saving the stream as a file on disk, [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) enables you to convert the file streams directly.

To load a file from a stream, follow these steps:

1.  Specify the method to obtain the file stream.
2.  Pass the method's name to the [Converter](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion/Converter) class constructor.

The following code snippet serves this purpose:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.exceptions.GroupDocsConversionException;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
...
try{
    Converter converter = new Converter(() -> {
                try {
                    return new FileInputStream("sample.docx");
                } catch (FileNotFoundException e) {
                    throw new RuntimeException(e);
                }
            });
    PdfConvertOptions options = new PdfConvertOptions();

    converter.convert("converted.pdf", options);
} catch (Exception e){
    throw new GroupDocsConversionException(e.getMessage());
}
```

The snippet above uses the [FileInputStream](https://docs.oracle.com/javase/8/docs/api/java/io/FileInputStream.html) class instance. Similarly, you can use any other type of stream. Just make sure that the source stream contains any of the [supported file formats]({{< ref "conversion/java/supported-document-formats.md" >}}).

---

## Load document from stream

Path: /conversion/nodejs-java/load-document-from-stream/

There might be a case when your file is not physically located on the disk. Instead, you have the file in the form of a stream. In this case, to avoid the overhead of saving the stream as a file on disk, [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/nodejs-java) enables you to convert the file streams directly.

To load a file from a stream, follow these steps:

1.   Specify the method to obtain the file stream.
2.   Pass the method's name to the [Converter](#) class constructor.

The following code snippet serves this purpose:

```js
const fs = require('fs')
const outputPath = "LoadDocumentFromStream.pdf"

try {
  const readStream = fs.createReadStream("sample.docx")
  const stream = await groupdocs.conversion.readDataFromStream(readStream)
  const converter = new groupdocs.conversion.Converter(stream);
  const convertOptions = new groupdocs.conversion.PdfConvertOptions()

  console.log(`Source document converted successfully to ${outputPath}`)
  return converter.convert(outputPath, convertOptions)

} catch (error) {
  throw new Error(error)
}
```

The snippet above uses the [createReadStream](https://nodejs.org/api/fs.html#filehandlecreatereadstreamoptions) method. Similarly, you can use any other type of stream. Just make sure that the source stream contains any of the [supported file formats]({{< ref "conversion/nodejs-java/getting-started/supported-document-formats.md" >}}).

---

## Load document from stream

Path: /merger/net/load-document-from-stream/

There might be the case when source or target document is not physically located on the disk. Instead, you have the document in the form of a stream. In this case, to avoid the overhead of saving stream as a file on disk, **[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides a way to work with document streams directly.   
The following are the steps to be followed:
*   Obtain document stream; 
*   Pass opened source document stream to [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class constructor.

Following code snippet describes this case.

```csharp
using (Stream stream = File.OpenRead(@"c:\sample.docx"))
{
	using (Merger merger = new Merger(stream))
    {
    	Console.WriteLine($"Document loaded from stream successfully.");
	}
}
```

---

## Load document from stream

Path: /parser/java/load-document-from-stream/

There might be cases when the document is presented only as a stream (without a copy on the local disk). To avoid the overhead of saving documents to the disk, GroupDocs.Parser enables to extract data from streams directly.

The following example shows how to load the document from the stream:

```java
// Create the stream
try (InputStream stream = new FileInputStream(Constants.SamplePdf)) {
    // Create an instance of Parser class with the stream
    try (Parser parser = new Parser(stream)) {
        // Extract a text into the reader
        try (TextReader reader = parser.getText()) {
            // Print a text from the document
            // If text extraction isn't supported, a reader is null
            System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Load File From Local Disk

Path: /conversion/python-net/developer-guide/loading-documents/load-file-from-local-disk/


To load a source file from your local disk, you can use the `Converter` class constructor in GroupDocs.Conversion. The API offers several overloads, allowing flexibility for various settings and options:

* `Converter(file_path)`
* `Converter(file_path, load_options)`
* `Converter(file_path, converter_settings)`
* `Converter(file_path, load_options, converter_settings)`

Each constructor requires the `filePath` parameter, which defines the path to the source file. You can specify this as an absolute or relative path. Note that if the specified file path does not exist, an exception will be raised.

{{< alert style="tip" >}}
GroupDocs.Conversion will access the file only when an action (e.g., conversion) is performed using the `Converter` class instance.
{{< /alert >}}

The following Python example demonstrates loading a file from a local disk and converting it to PDF:

{{< tabs "code-example">}}
{{< tab "convert_docx_to_pdf.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_docx_to_pdf():
    # Specify source file location
    converter = Converter("./business-plan.docx")
    
    # Specify output file location and convert options
    output_path = "./business-plan.pdf"
    pdf_options = PdfConvertOptions()
    
    # Convert and save to output path
    converter.convert(output_path, pdf_options)

if __name__ == "__main__":
    convert_docx_to_pdf()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-file-from-local-disk/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is converted PDF document. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-file-from-local-disk/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

{{< alert style="warning" >}}
GroupDocs.Conversion determines the file type by its extension. If the file extension is not set, GroupDocs.Conversion will attempt to detect the file type automatically. Depending on the file type and size, automatic file type detection consumes additional resources, such as memory and CPU time. Therefore, we recommend ensuring that a file has the correct extension or using the Converter class constructor that accepts load options.
{{< /alert >}}

### Explanation

- **Load Source File**: The `Converter` class is instantiated with the path to the source document ("business-plan.docx").
- **Conversion Options**: An instance of `PdfConvertOptions` is created to define the settings for PDF conversion.
- **Execute Conversion**: The `convert` method is used to convert the document and save it to the specified output path ("business-plan.pdf").

Refer to the [GroupDocs.Conversion API Reference](https://reference.groupdocs.com/conversion/python-net/) for more details on using load options and other constructor overloads.

---

## Load file from stream

Path: /comparison/java/load-file-from-stream/


To avoid the saving stream as a file, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to work with file streams directly.

To work with stream, follow these steps:

1.  Obtain file stream.
2.  Pass opened source file stream to the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) class constructor or pass opened target file stream to the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method.

The following code snippet shows how to load file from stream:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import java.nio.file.Path;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.FileOutputStream;
import java.io.OutputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream)) {
    comparer.add(targetInputStream);
    final Path resultPath = comparer.compare(resultOutputStream);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load file from stream

Path: /comparison/net/load-file-from-stream/


To avoid the saving stream as a file, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to work with file streams directly.

To work with stream, follow these steps:

1.  Obtain file stream.
2.  Pass opened source file stream to the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) class constructor or pass opened target file stream to the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method.

The following code snippet shows how to load file from stream:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using System.IO;
// ...

using (Stream sourceStream = File.OpenRead("source.docx"))
using (Stream targetStream = File.OpenRead("target.docx"))
{
    using (Comparer comparer = new Comparer(sourceStream))
    {
        comparer.Add(targetStream);
        comparer.Compare(File.Create("result.docx"));
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load file from stream

Path: /comparison/nodejs-java/load-file-from-stream/


To avoid the saving stream as a file, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to work with file streams directly.

The following code snippet shows how to load a file from a stream:

```javascript
'use strict';

// Load Java bridge and import FileInputStream for reading files
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
const InputStream = java.import('java.io.FileInputStream');

// Create input streams for source and target documents
const sourceStream = new InputStream('sample-files/source.docx'); // source document
const targetStream = new InputStream('sample-files/target.docx'); // target document

// Initialize comparer with the source document stream
const comparer = new groupdocs.Comparer(sourceStream);

// Add the target document to the comparison set
comparer.add(targetStream);

// Execute comparison and save result to a new file
comparer.compare('result.docx');

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates how to compare documents using Java input streams instead of file paths. It creates `InputStream` objects for both the source and target documents using Java's `FileInputStream` class, initializes the `Comparer` with the source stream, adds the target stream using `add()`, and performs the comparison. This approach is useful when working with documents stored in memory or when you want to avoid direct file system access.

---

## Load file from stream

Path: /comparison/python-net/load-file-from-stream/


To avoid the saving stream as a file, [GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to work with file streams directly.

To work with a stream, follow these steps:

1.  Obtain a file stream.
2.  Pass the opened source file stream to the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> class constructor or pass the opened target file stream to the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method.

The following code snippet shows how to load a file from a stream:

```python
import groupdocs.comparison as gc

def load_file_from_stream(output_file_path, source_file_path, target_file_path):  
    with open(source_file_path, 'rb') as source_stream:
        with gc.Comparer(source_stream) as comparer:
            # Add the target document for comparison using a file stream
            with open(target_file_path, 'rb') as target_stream:
                comparer.add(target_stream)
            
                # Compare the documents and save the result
                comparer.compare(output_file_path)
    
    # Log the success message with the output file path
    print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
```

---

## Load file from stream

Path: /conversion/net/load-file-from-stream/

There might be a case when your file is not physically located on the disk. Instead, you have the file in the form of a stream. In this case, to avoid the overhead of saving the stream as a file on disk, [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) enables you to convert the file streams directly.

To load a file from a stream, follow these steps:

1.  Specify the method to obtain the file stream.
2.  Pass the method's name to the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class constructor.

The following code snippet serves this purpose:

```csharp
public static void Run()
{
    // Pass the source stream as parameter
    using (Converter converter = new Converter(GetFileStream)) 
    {
        PdfConvertOptions options = new PdfConvertOptions();
        converter.Convert("converted.pdf", options);
    }
}

// Obtain the stream for the source file
private static Stream GetFileStream() => File.OpenRead("sample.docx");
```
The snippet above uses the `FileStream` class instance. Similarly, you can use any other type of stream. Just make sure that the source stream contains any of the [supported file formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}}). For example, the following code loads a file using the `MemoryStream` class instance:

```csharp
public static void Run()
{
    // Pass the source stream as parameter
    using (Converter converter = new Converter(GetMemoryStream)) 
    {
        PdfConvertOptions options = new PdfConvertOptions();
        converter.Convert("converted.pdf", options);
    }
}

// Obtain the stream for the source file
private static Stream GetMemoryStream()
{
    MemoryStream memStream = new MemoryStream();

    using (FileStream fStream = File.Open("sample.docx", FileMode.Open))
    {
        fStream.CopyTo(memStream);
    }
    return memStream;
}
```

## Get information about files from a stream
When loading files from a stream, you may not know beforehand the exact types of files you are receiving. However, to find out this and other information about the source file, you can use the [Converter.GetDocumentInfo()](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/getdocumentinfo/) method, as described in the [Getting document info]({{< ref "conversion/net/developer-guide/basic-usage/get-document-info.md" >}}) article.

The following code displays the format of the source file loaded from a stream:
```csharp
public static void Run()
{
    // Pass the source stream as parameter
    using (Converter converter = new Converter(GetFileStream)) 
    {
        IDocumentInfo docInfo = converter.GetDocumentInfo();
        Console.WriteLine("Source file format: {0}", docInfo.Format);

        PdfConvertOptions options = new PdfConvertOptions();
        converter.Convert("converted.pdf", options);
    }
}

// Obtain the stream for the source file
private static Stream GetFileStream() => File.OpenRead("sample.docx");
```
---

## Load file from stream

Path: /parser/python-net/load-file-from-stream/


To avoid saving a file on disk, [GroupDocs.Parser](https://products.groupdocs.com/parser/python-net) allows you to work with file streams directly.

To load a document from a stream, follow these steps:

1. Open a file stream
2. Pass the opened file stream to the `Parser` class constructor

The following code snippet shows how to load a file from a stream:

## Load document from file stream
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Open the file as a binary stream
with open("sample.docx", "rb") as stream:
    # Create an instance of Parser class with the stream
    with Parser(stream) as parser:
        # Extract text from the document
        text_reader = parser.get_text()
        
        if text_reader is not None:
            # Print the extracted text
            print(text_reader)
        else:
            print("Text extraction isn't supported for this format")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-file-from-stream/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Load document from BytesIO stream
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from io import BytesIO

# Read file into memory
with open("sample.pdf", "rb") as file:
    file_data = file.read()

# Create a BytesIO stream
stream = BytesIO(file_data)

# Create an instance of Parser class with the stream
with Parser(stream) as parser:
    # Get document info
    doc_info = parser.get_document_info()
    
    print(f"File type: {doc_info.file_type.file_format}")
    print(f"Page count: {doc_info.page_count}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-file-from-stream/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Process uploaded file without saving

This is useful for web applications where files are uploaded by users:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from io import BytesIO

def process_uploaded_file(file_content, filename):
    """Process an uploaded file without saving it to disk"""
    
    try:
        # Create a stream from the file content
        stream = BytesIO(file_content)
        
        # Create parser instance
        with Parser(stream) as parser:
            print(f"Processing uploaded file: {filename}")
            
            # Get document info
            doc_info = parser.get_document_info()
            print(f"File type: {doc_info.file_type.file_format}")
            print(f"Pages: {doc_info.page_count}")
            
            # Extract text
            text_reader = parser.get_text()
            if text_reader:
                text = text_reader
                
                return {
                    "success": True,
                    "filename": filename,
                    "type": doc_info.file_type.file_format,
                    "pages": doc_info.page_count,
                    "text_length": len(text),
                    "text": text
                }
            else:
                return {
                    "success": False,
                    "error": "Text extraction not supported"
                }
                
    except Exception as e:
        return {
            "success": False,
            "error": str(e)
        }

# Example: Simulate uploaded file
with open("sample.docx", "rb") as f:
    file_content = f.read()

result = process_uploaded_file(file_content, "sample.docx")
print(result)
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-file-from-stream/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub examples

You may find more code examples in our GitHub repository:

*   [GroupDocs.Parser for Python via .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET)

### Free online document parser

Along with the full-featured library, we provide a free online document parser app. You are welcome to extract data from PDF, DOCX, XLSX, and more with our [Free Online Document Parser App](https://products.groupdocs.app/parser).


---

## Load from a stream

Path: /markdown/net/load-from-a-stream/


When the source document is not a file on disk (e.g., downloaded from a network, read from a database, or received as an upload), you can pass a `Stream` directly to the `MarkdownConverter` constructor.

The stream is copied internally, so you may close it immediately after creating the converter.

{{< tabs "load-stream-example">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using GroupDocs.Markdown;

using Stream stream = File.OpenRead("business-plan.docx");
using var converter = new MarkdownConverter(stream);

converter.Convert("load-stream-example.md");
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/loading/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-stream-example.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-from-a-stream/LoadStreamExample/load-stream-example.md)
{{< /tab >}}
{{< /tabs >}}

### Stream with LoadOptions

If the stream does not have a file extension for automatic format detection, specify the format explicitly via `LoadOptions`:

{{< tabs "load-stream-options">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using GroupDocs.Markdown;

using Stream stream = File.OpenRead("document");
var loadOptions = new LoadOptions(FileFormat.Docx);

using var converter = new MarkdownConverter(stream, loadOptions);
converter.Convert("load-stream-options.md");
```
{{< /tab >}}
{{< tab "load-stream-options.md" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



|  | TABLE OF CONTENTS TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc9437451" Introduction	 PAGEREF _Toc9437451 \h 3  HYPERLINK \l "_Toc9437452" 1.	Executive Summary	 PAGEREF _Toc9437452 \h 5  HYPERLINK \l "_Toc9437453" 2.	Company Overview	 PAGEREF _Toc9437453 \h 6  HYPERLINK \l "_Toc9437454" 3.	Business Description	 PAGEREF _Toc9437454 \h 7  HYPERLINK \l "_Toc9437
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-from-a-stream/LoadStreamOptions/load-stream-options.md)
{{< /tab >}}
{{< /tabs >}}

---

## Load from a stream

Path: /markdown/python-net/load-from-a-stream/


When the source document is not a file on disk (e.g., downloaded from a network, read from a database, or received as an upload), you can pass a binary stream directly to the `MarkdownConverter` constructor.

The stream is copied internally, so you may close it immediately after creating the converter.

{{< tabs "load-stream-basic">}}
{{< tab "load_from_stream.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def load_from_stream():
    """Load a document from a binary stream and convert to Markdown."""

    # Step 1: Open the document file as a binary stream
    with open("business-plan.docx", "rb") as stream:
        # Step 2: Create a converter from the stream
        with MarkdownConverter(stream) as converter:
            # Step 3: Convert and save the Markdown output
            converter.convert("load-from-stream.md")

if __name__ == "__main__":
    load_from_stream()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/loading/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-from-stream.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



|  | TABLE OF CONTENTS TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc9437451" Introduction	 PAGEREF _Toc9437451 \h 3  HYPERLINK \l "_Toc9437452" 1.	Executive Summary	 PAGEREF _Toc9437452 \h 5  HYPERLINK \l "_Toc9437453" 2.	Company Overview	 PAGEREF _Toc9437453 \h 6  HYPERLINK \l "_Toc9437454" 3.	Business Description	 PAGEREF _Toc9437454 \h 7  HYPERLINK \l "_Toc9437
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-stream/load_from_stream/load-from-stream.txt)
{{< /tab >}}
{{< tab "load-from-stream.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-stream/load_from_stream/load-from-stream.txt)
{{< /tab >}}
{{< /tabs >}}

### Stream with LoadOptions

If the stream does not have a file extension for automatic format detection, specify the format explicitly via `LoadOptions`:

{{< tabs "load-stream-with-options">}}
{{< tab "load_from_stream_with_options.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, LoadOptions, FileFormat

def load_from_stream_with_options():
    """Load a document from a stream with explicit format specification."""

    # Step 1: Open the file as a binary stream
    with open("document", "rb") as stream:
        # Step 2: Specify the file format explicitly (no auto-detection)
        load_options = LoadOptions(FileFormat.DOCX)

        # Step 3: Create a converter from the stream with load options
        with MarkdownConverter(stream, load_options=load_options) as converter:
            # Step 4: Convert and save the Markdown output
            converter.convert("load-from-stream-options.md")

if __name__ == "__main__":
    import shutil
    shutil.copy("business-plan.docx", "document")  # create file without extension
    load_from_stream_with_options()
```
{{< /tab >}}
{{< tab "load-from-stream-options.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



|  | TABLE OF CONTENTS TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc9437451" Introduction	 PAGEREF _Toc9437451 \h 3  HYPERLINK \l "_Toc9437452" 1.	Executive Summary	 PAGEREF _Toc9437452 \h 5  HYPERLINK \l "_Toc9437453" 2.	Company Overview	 PAGEREF _Toc9437453 \h 6  HYPERLINK \l "_Toc9437454" 3.	Business Description	 PAGEREF _Toc9437454 \h 7  HYPERLINK \l "_Toc9437
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-stream/load_from_stream_with_options/load-from-stream-options.txt)
{{< /tab >}}
{{< tab "load-from-stream-options.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-from-a-stream/load_from_stream_with_options/load-from-stream-options.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Load from a stream

Path: /metadata/java/load-from-a-stream/

This example demonstrates how to load a file from a stream.

**advanced\_usage.loading\_files.LoadFromStream**

```csharp
// Constants.InputDoc is an absolute or relative path to your document. Ex: @"C:\Docs\source.doc"
try (InputStream stream = new FileInputStream(Constants.InputDoc)) {
	try (Metadata metadata = new Metadata(stream)) {
		// Extract, edit or remove metadata here
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load from a stream

Path: /metadata/net/load-from-a-stream/

This example demonstrates how to load a file from a stream.

**AdvancedUsage.LoadingFiles.LoadFromStream**

```csharp
// Constants.InputDoc is an absolute or relative path to your document. Ex: @"C:\Docs\source.doc"
using (Stream stream = File.Open(Constants.InputDoc, FileMode.Open, FileAccess.ReadWrite))
using (Metadata metadata = new Metadata(stream))
{
	// Extract, edit or remove metadata here
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Load from a stream

Path: /metadata/nodejs-java/load-from-a-stream/

This example demonstrates how to load a file from a stream.

**advanced\_usage.loading\_files.LoadFromStream**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
try {
	const fileStream = fs.createReadStream("input.one")
    const metadata = new groupdocs.metadata.Metadata(fileStream);
  }
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load from a stream

Path: /metadata/python-net/load-from-a-stream/

This example demonstrates how to load a file from a stream.

**advanced_usage.loading_files.load_from_stream**


```python
def run():
    # constants.input_doc is an absolute or relative path to your document. Ex: r"C:\\Docs\\source.doc"
    with open(constants.input_doc, 'rb') as stream:
        with gm.Metadata(stream) as metadata:
            # Extract, edit or remove metadata here
            # ...
            pass
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Load from stream

Path: /watermark/java/load-from-stream/

The following example democtrates how to create a [watermarker](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker) for a document stream:

**advanced\_usage.loading\_documents.LoadFromStream**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
FileInputStream document = new FileInputStream("document.docx");                                   
Watermarker watermarker = new Watermarker(document);                                                        
                                                                                                            
// use watermarker methods to manage watermarks                                                             
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));                       
                                                                                                            
watermarker.add(watermark);                                                                                 
                                                                                                            
watermarker.save("document.docx");                                                                
                                                                                                            
watermarker.close();                                                                                      
document.close();                                                                                           
```


---

## Load from Stream

Path: /redaction/java/load-from-stream/

### Load from Stream

As an alternative to a local file, *Redactor* can open a document from stream.

The following example demonstrates how to load and redact a document using Stream:



```java
        final FileInputStream stream = new FileInputStream("sample.docx");
        try 
        {
            final Redactor redactor = new Redactor(stream);
            try 
            {
                // Here we can use document instance to make redactions
                redactor.apply(new DeleteAnnotationRedaction());
                redactor.save();
            }
            finally { redactor.close(); }
        }
        finally { stream.close(); }
```

---

## Load from Stream

Path: /redaction/net/load-from-stream/

As an alternative to a local file, [Redac](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor)[t](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor)[or](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor) can open a document from stream.

The following example demonstrates how to load and redact a document using Stream:

**C#**

```csharp
using (Stream stream = File.Open(@"sample.docx", FileMode.Open, FileAccess.ReadWrite))
{
   using (Redactor redactor = new Redactor(stream))
   {
      // Here we can use document instance to make redactions
      redactor.Apply(new DeleteAnnotationRedaction());
      redactor.Save();
   }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Load from Stream

Path: /redaction/python-net/load-from-stream/

As an alternative to a local file, [Redactor](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor/) can open a document from stream.

The following example demonstrates how to load and redact a document using Stream:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options - remove all annotations
    del_red = grr.DeleteAnnotationRedaction()

    # Load the document as stream to be redacted
    with open("source.docx", "rb") as stream_in:
        with gr.Redactor(stream_in) as redactor:

            # Apply the redaction
            result = redactor.apply(del_red)
        
            # Save the redacted document as PDF
            with open("output.pdf", "wb") as stream_out:
                ro = gro.RasterizationOptions()
                redactor.save(stream_out, ro)
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Load password-protected document

Path: /merger/java/load-password-protected-document/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to manipulate with documents that are protected with a password.

The following are the steps to load password-protected documents.

*   Instantiate [LoadOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/LoadOptions) object and specify source document password;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream and [LoadOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/LoadOptions) object created at previous step.

The following code sample shows how to load password-protected documents.

```java
String filePath = "c:\sample.docx";
LoadOptions loadOptions = new LoadOptions("SAMPLE_PASSWORD");
 
Merger merger = new Merger(filePath, loadOptions);
System.out.print("Document loaded successfully.");
```

---

## Load password-protected document

Path: /merger/net/load-password-protected-document/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to manipulate with documents that are protected with a password.

The following are the steps to load password-protected documents.

*   Instantiate [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) object and specify source document password;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream and [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) object created at previous step.

The following code sample shows how to load password-protected documents.

```csharp
string filePath = @"c:\sample.docx";
LoadOptions loadOptions = new LoadOptions("SAMPLE_PASSWORD");
 
using (Merger merger = new Merger(filePath, loadOptions))
{
	Console.WriteLine($"Document loaded successfully.");                
}    
```

---

## Load password-protected document

Path: /signature/java/load-password-protected-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) supports processing documents that are protected with a password.

The following are the steps to work with password protected documents.

*   Instantiate the [LoadOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.loadoptions/LoadOptions) object;
*   Set password in [LoadOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.loadoptions/LoadOptions) the [setPassword](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.loadoptions/LoadOptions#setPassword(java.lang.String))property;
*   Create [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object and call any method.

The following code sample shows how to process password protected documents.

```java
LoadOptions loadOptions = new LoadOptions() ;  
loadOptions.setPassword("1234567890");       
 
try {
    Signature signature = new Signature("sampleProtected.pdf");
    QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
    options.setEncodeType(QrCodeTypes.QR);
    options.setLeft(100);
    options.setTop(100);   
 
    // sign document to file
    signature.sign("signedProtected.pdf", options);
}catch(Exception e){
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Load password-protected documents

Path: /viewer/java/load-password-protected-document/


The encryption protects data and allows only authorized people to open the file. When a file is encrypted, the password must be specified to open the file. To learn how to identify the encrypted file, please refer to the [Check if a file is encrypted]({{< ref "viewer/java/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted.md" >}}) page.

To load and render an encrypted document, follow these steps:

1. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) (or [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/), or [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/), or [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/)) object.
2. Set a password using the [LoadOptions.setPassword()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/#setPassword-java.lang.String-) method.
{{< alert style="info" >}}
If the password is not specified, GroupDocs.Viewer throws [PasswordRequiredException](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.exception/PasswordRequiredException).
If the incorrect password is specified, GroupDocs.Viewer throws [IncorrectPasswordException](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.exception/IncorrectPasswordException).
{{< /alert >}}
3. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

The following code snippet shows how to load and render an encrypted document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.LoadOptions;
// ...

LoadOptions loadOptions = new LoadOptions();
// Specify a password.
loadOptions.setPassword("123456");

// Render the file.
try (Viewer viewer = new Viewer("sample.docx", loadOptions)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}


---

## Load password-protected documents

Path: /viewer/net/load-password-protected-document/


The encryption protects data and allows only authorized people to open the file. When a file is encrypted, the password must be specified to open the file. To learn how to identify the encrypted file, please refer to the [Check if a file is encrypted]({{< ref "viewer/net/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted.md" >}}) page.

To load and render an encrypted document, follow these steps:

1. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) (or [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions), or [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions), or [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions)) object.
2. Set a password in the [LoadOptions.Password](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/properties/password) property.
{{< alert style="info" >}}
If the password is not specified, GroupDocs.Viewer throws [PasswordRequiredException](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.exceptions/passwordrequiredexception).
{{< /alert >}}
3. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method.

The following code snippet shows how to load and render an encrypted document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Specify a password.
LoadOptions loadOptions = new LoadOptions();
loadOptions.Password = "123456";
// Render a file.
using (Viewer viewer = new Viewer("encrypted.docx", loadOptions))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Specify a password.
        Dim loadOptions As LoadOptions = New LoadOptions()
        loadOptions.Password = "123456"
        ' Render a file.
        Using viewer As Viewer = New Viewer("encrypted.docx", loadOptions)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}


---

## Locating signature with different alignments

Path: /signature/net/locating-signature-with-different-alignments/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to align signature on page with horizontal and vertical alignment settings. Signature options that implement interface [IAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/ialignment) contain following properties:

* [HorizontalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/horizontalalignment) - property of enumeration type [HorizontalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/horizontalalignment) to specify horizontal alignment of signature. Values are [None, Left, Center, Right](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/horizontalalignment)
* [VerticalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/verticalalignment) - property of enumeration type [VerticalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/verticalalignment) to specify vertical alignment of signature. Values are [None, Top, Center, Bottom](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/verticalalignment)
* [Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/margin)\- property of class [Padding](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/padding) to specify offset for signature alignment. Fields of class are [Left, Top, Right, Bottom](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/padding) to specify offset in measure units from alignment area.
* [MarginMeasureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/marginmeasuretype) - property of enumeration type [MeasureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/measuretype) with values ([Pixels, Millimeters, Percents](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/measuretype)). See more details in this example [Locating signature on page with different measure units]({{< ref "signature/net/developer-guide/advanced-usage/signing/locating-signature-on-document-page/locating-signature-on-page-with-different-measure-units.md" >}})

Here are the steps to align signature on page with GroupDocs.Signature:

* Create a new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate signature options ([ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) for example) with all required properties.
* Set  [HorizontalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/horizontalalignment) with one of enumeration value to align signature along page width
* Set  [VerticalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/verticalalignment) with one of enumeration value to align signature along page height
* Set  [Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/margin) property with required offsetfrom page border
* Set  [MarginMeasureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/marginmeasuretype) property with non default value if there is need to specify offset from page border in another measure units like millimeters and page percents (from 100% width and 100% height)
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the instance of signature options ([ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) for example) to it.

This example shows how to locate signature with different alignments.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // define qr-code size
    int qrWidth = 100;
    int qrHeight = 100;
    // define list of options
    List<SignOptions> listOptions = new List<SignOptions>();
    // walk through all alignment values to locate signature at all page alignment areas
    foreach (HorizontalAlignment horizontalAlignment in Enum.GetValues(typeof(HorizontalAlignment)))
    {
        foreach (VerticalAlignment verticalAlignment in Enum.GetValues(typeof(VerticalAlignment)))
        {
            if (verticalAlignment != VerticalAlignment.None && horizontalAlignment != HorizontalAlignment.None)
            {
                listOptions.Add(
                    new QrCodeSignOptions("Left-Top")
                    {
                    // set signature rectangle
                    Width = qrWidth,
                        Height = qrHeight,
                    // set signature alignment
                    HorizontalAlignment = horizontalAlignment,
                        VerticalAlignment = verticalAlignment,
                        Margin = new Padding(5),
                    });
            }
        }
    }
    // sign document to file
    signature.Sign("signed.pdf", listOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Locking watermark in word processing document

Path: /watermark/net/locking-watermark-in-word-processing-document/

There might be the case when you need to lock the watermarks in a Word document to restrict the editing. To deal with such cases, GroupDocs.Watermark provides 5 variants of locking Word document when adding watermark.

* **AllowOnlyRevisions**: user can only add revision marks to the document.
* **AllowOnlyComments**: user can only modify comments in the document.
* **AllowOnlyFormFields**: the document is split into one-page sections and locked section with watermark is added between each two adjacent document sections.
* **ReadOnly**: the entire document is read-only.
* **ReadOnlyWithEditableContent**: the document is read-only, but all the content except the watermark is marked as editable.

*[LockType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkbaseoptions/properties/locktype)* property has been added to *[WordProcessingWatermarkBaseOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkbaseoptions)* class (and all descendants) to set any of the above-mentioned lock types. *[*WordProcessing*LockType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessinglocktype)* enum in [*GroupDocs.Watermark.Options.WordProcessing*](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/) namespace is used to define the lock type. The following code samples show how to lock watermark in different scenarios.

## Adding watermark to all pages

This example uses [WordProcessingWatermarkPagesOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkpagesoptions) with empty [PageNumbers](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkpagesoptions/properties/pagenumbers).

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingAddLockedWatermarkToAllPages**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    TextWatermark watermark = new TextWatermark("Watermark text", new Font("Arial", 19));
    watermark.ForegroundColor = Color.Red;

    WordProcessingWatermarkPagesOptions options = new WordProcessingWatermarkPagesOptions();
    options.IsLocked = true;
    options.LockType = WordProcessingLockType.AllowOnlyFormFields;

    // To protect with password
    //options.Password = "7654321";

    watermarker.Add(watermark, options);
    watermarker.Save("document.docx");
}
```

## Adding watermark to particular pages

This example uses [WordProcessingWatermarkPagesOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkpagesoptions) with [PageNumbers](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkpagesoptions/properties/pagenumbers) containing numbers of two pages.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingAddLockedWatermarkToParticularPages**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    TextWatermark watermark = new TextWatermark("Watermark text", new Font("Arial", 19));
    watermark.ForegroundColor = Color.Red;

    WordProcessingWatermarkPagesOptions options = new WordProcessingWatermarkPagesOptions();
    options.PageNumbers = new int[] { 1, 3 };
    options.IsLocked = true;
    options.LockType = WordProcessingLockType.AllowOnlyComments;

    // To protect with password
    //options.Password = "7654321";

    watermarker.Add(watermark, options);
    watermarker.Save("document.docx");
}
```

## Adding watermark to a section

This example uses [WordProcessingWatermarkSectionOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarksectionoptions) with [SectionIndex](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarksectionoptions/properties/sectionindex).

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingAddLockedWatermarkToSection**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    TextWatermark watermark = new TextWatermark("Watermark text", new Font("Arial", 19));
    watermark.ForegroundColor = Color.Red;

    WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();
    options.SectionIndex = 0;
    options.IsLocked = true;
    options.LockType = WordProcessingLockType.ReadOnlyWithEditableContent;

    // To protect with password
    //options.Password = "7654321";

    watermarker.Add(watermark, options);
    watermarker.Save("document.docx");
}
```


---

## Locking watermark in word processing document

Path: /watermark/python-net/locking-watermark-in-word-processing-document/


You can lock watermarks in a Word document to restrict editing. GroupDocs.Watermark provides several lock types:

- AllowOnlyRevisions
- AllowOnlyComments
- AllowOnlyFormFields
- ReadOnly
- ReadOnlyWithEditableContent

Use `lock_type` in `WordProcessingWatermarkBaseOptions` (and descendants) to set the lock type.

## Adding watermark to all pages
This sample adds a locked text watermark across all pages using a chosen lock type (and optional password).

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Watermark text", gww.Font("Arial", 19.0))
    watermark.foreground_color = gww.Color.red

    options = gwo_wp.WordProcessingWatermarkPagesOptions()
    options.is_locked = True
    options.lock_type = gwo_wp.WordProcessingLockType.ALLOW_ONLY_FORM_FIELDS
    # options.password = "7654321"

    watermarker.add(watermark, options)
    watermarker.save("document.docx")
```

## Adding watermark to particular pages
This sample applies a locked watermark only to specific pages referenced by their numbers.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Watermark text", gww.Font("Arial", 19.0))
    watermark.foreground_color = gww.Color.red

    options = gwo_wp.WordProcessingWatermarkPagesOptions()
    options.page_numbers = [1, 3]
    options.is_locked = True
    options.lock_type = gwo_wp.WordProcessingLockType.ALLOW_ONLY_COMMENTS
    # options.password = "7654321"

    watermarker.add(watermark, options)
    watermarker.save("document.docx")
```

## Adding watermark to a section
This sample inserts a locked watermark into a specific section, restricting edits according to the lock type.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Watermark text", gww.Font("Arial", 19.0))
    watermark.foreground_color = gww.Color.red

    options = gwo_wp.WordProcessingWatermarkSectionOptions()
    options.section_index = 0
    options.is_locked = True
    options.lock_type = gwo_wp.WordProcessingLockType.READ_ONLY_WITH_EDITABLE_CONTENT
    # options.password = "7654321"

    watermarker.add(watermark, options)
    watermarker.save("document.docx")
```



---

## Markdown

Path: /parser/net/markdown/

The following example shows how to extract Markdown formatted text:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Markdown)))
    {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Formatted text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

The API supports the following formatting:

*   Bold text
*   Italic text
*   Hyperlinks
*   Headings
*   Numbering and bullets lists
*   Tables

The following Microsoft Word document is used as input document:

![](/parser/net/images/markdown.png)

The following Markdown document is extracted using the example above:

![](/parser/net/images/markdown_1.png)

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Merge Word documents

Path: /merger/java/merge/word/


A word processing file contains user information in plain text or rich text format. A **plain text** file format contains unformatted text and no font or page settings can be applied. In contrast, a **rich text** file format allows formatting options such as setting fonts type, styles (bold, italic, underline, etc.), page margins, headings, bullets and numbers, and several other formatting features. The use of plain text files have reduced significantly with passage of time as there are more powerful computers and programs available to offer rich text files processing.

Common plain text file extensions and associated file formats include **TXT**, **CSV**, while file extensions for rich text documents include **DOCX**, **DOC** and **RTF**.
  
## How to merge DOCX documents

Docx is a well-known format for Microsoft Word documents. Introduced from 2007 with the release of Microsoft Office 2007, the structure of this new Document format was changed from plain binary to a combination of XML and binary files. Docx files can be opened with Word 2007 and lateral versions, but not with the earlier versions of MS Word which support DOC file extensions

Below is code snippet in java that demonstrates how to merge DOCX files into single file.

```java
// Load the source DOCX file
Merger merger = new Merger("c:\sample1.docx")

// Add another DOCX file to merge
merger.join("c:\sample2.docx");
// Merge DOCX files and save result
merger.save("c:\merged.docx");
```
  
## How to merge Word documents without starting from a new page

There is an additional option for Word document joining that allows to merge those documents without page breaking between them, i.e. the last page of the initial document will be merged with the first page of the next document as one page.

Below is code snippet in java that demonstrates how to merge DOC files into single file without starting from a new page.

```java
// Load the source DOC file
Merger merger = new Merger("c:\sample1.doc")

// Define Word join options
WordJoinOptions joinOptions = new WordJoinOptions();
joinOptions.setMode(WordJoinMode.Continuous);
// Add another DOC file to merge
merger.join("c:\sample2.doc", joinOptions);
// Merge DOC files and save result
merger.save("c:\merged.doc");
```

## How to merge Word documents with pre-defined Compliance mode

There is an additional option for Word document joining that allows to merge those documents with pre-defined Compliance mode for the Word Ooxml formats such as .docx, .docm, .dotx, .dotm etc.

Below is code snippet in Java that demonstrates how to merge DOCX files into single file with ISO/IEC 29500:2008 Strict compliance level.

```java
// Load the source DOCX file
Merger merger = new Merger("c:\sample1.docx");

// Define Word join options
WordJoinOptions joinOptions = new WordJoinOptions();
joinOptions.setCompliance(WordJoinCompliance.Iso29500_2008_Strict);
// Add another DOCX file to merge
merger.join("c:\sample2.docx", joinOptions);
// Merge DOCX files and save result
merger.save("c:\merged.docx");

```

## How to merge TXT files

A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by a sequence of characters.

You can combine any number of text files like shows this java code sample:

```java
// Load the source TXT file
Merger merger = new Merger("c:\sample1.txt")

// Add another TXT file to merge
merger.join("c:\sample2.txt");
// Merge TXT files and save result
merger.save("c:\merged.txt");
```

## How to merge RTF files

Introduced and documented by Microsoft, the Rich Text Format (RTF) represents a method of encoding formatted text and graphics for use within applications. The format facilitates cross-platform document exchange with other Microsoft Products, thus serving the purpose of interoperability. This capability makes it a standard of data transfer between word processing software and, hence, contents can be transferred from one operating system to another without losing document formatting.

Joining multiple RTF documents into one is pretty the same as for any other formats - just specify files you want to merge and save the resultant document.

```java
// Load the source RTF file
Merger merger = new Merger("c:\sample1.rtf"))

// Add another RTF file to merge
merger.join("c:\sample2.rtf");
// Merge RTF files and save result
merger.save("c:\merged.rtf");
```

## How to merge DOCX streams

Please read the following article: [How to properly merge DOCX streams]({{< ref "merger/java/getting-started/use-cases/how-to-properly-merge-documents-using-java.md" >}})

### Code Examples

Please find more [use-cases and complete Java sources](https://docs.groupdocs.com/merger/java/showcases/) of our backend and frontend examples and try them for free!

### Merge Word files Live Demo

GroupDocs.Merger for Java provides an online [**Word Merger App**](https://products.groupdocs.app/merger/word), which allows you to try it for free and check its quality and accuracy.
---

## Merge Word documents

Path: /merger/nodejs-java/merge/word/


A word processing file contains user information in plain text or rich text format. A **plain text** file format contains unformatted text and no font or page settings can be applied. In contrast, a **rich text** file format allows formatting options such as setting fonts type, styles (bold, italic, underline, etc.), page margins, headings, bullets and numbers, and several other formatting features. The use of plain text files have reduced significantly with passage of time as there are more powerful computers and programs available to offer rich text files processing.

Common plain text file extensions and associated file formats include **TXT**, **CSV**, while file extensions for rich text documents include **DOCX**, **DOC** and **RTF**.
  
## How to merge DOCX documents

Docx is a well-known format for Microsoft Word documents. Introduced from 2007 with the release of Microsoft Office 2007, the structure of this new Document format was changed from plain binary to a combination of XML and binary files. Docx files can be opened with Word 2007 and lateral versions, but not with the earlier versions of MS Word which support DOC file extensions

Below is code snippet in java that demonstrates how to merge DOCX files into single file.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.docx')
merger.join('c:/sample2.docx')
merger.save('c:/merged.docx')
```

## How to merge Word documents with pre-defined Compliance mode

There is an additional option for Word document joining that allows to merge those documents with pre-defined Compliance mode for the Word Ooxml formats such as .docx, .docm, .dotx, .dotm etc.

Below is code snippet in Java that demonstrates how to merge DOCX files into single file with ISO/IEC 29500:2008 Strict compliance level.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.docx')
const wordJoinOptionsCompliance = groupdocs.merger.WordJoinCompliance.Iso29500_2008_Strict
const wordJoinOptions = new groupdocs.merger.WordJoinOptions()
wordJoinOptions.Compliance = wordJoinOptionsCompliance
merger.join('c:/sample2.docx')
merger.save('c:/merged.docx')
```

## How to merge TXT files

A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by a sequence of characters.

You can combine any number of text files like shows this java code sample:

```js
const merger = new groupdocs.merger.Merger('c:/sample1.txt')
merger.join('c:/sample2.txt')
merger.save('c:/merged.txt')
```

## How to merge RTF files

Introduced and documented by Microsoft, the Rich Text Format (RTF) represents a method of encoding formatted text and graphics for use within applications. The format facilitates cross-platform document exchange with other Microsoft Products, thus serving the purpose of interoperability. This capability makes it a standard of data transfer between word processing software and, hence, contents can be transferred from one operating system to another without losing document formatting.

Joining multiple RTF documents into one is pretty the same as for any other formats - just specify files you want to merge and save the resultant document.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.rtf')
merger.join('c:/sample2.rtf')
merger.save('c:/merged.rtf')
```

### Code Examples

Please find more [use-cases and complete Node.js via Java sources](https://docs.groupdocs.com/merger/nodejs-java/showcases/) of our backend and frontend examples and try them for free!

### Merge Word files Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**Word Merger App**](https://products.groupdocs.app/merger/word), which allows you to try it for free and check its quality and accuracy.
---

## Merge Word documents

Path: /merger/python-net/merge/word/


A word processing file contains user information in plain text or rich text format. A **plain text** file format contains unformatted text and no font or page settings can be applied. In contrast, a **rich text** file format allows formatting options such as setting fonts type, styles (bold, italic, underline, etc.), page margins, headings, bullets and numbers, and several other formatting features. The use of plain text files have reduced significantly with passage of time as there are more powerful computers and programs available to offer rich text files processing.

Common plain text file extensions and associated file formats include **TXT**, **CSV**, while file extensions for rich text documents include **DOCX**, **DOC** and **RTF**.
  
## How to merge DOCX documents

Docx is a well-known format for Microsoft Word documents. Introduced from 2007 with the release of Microsoft Office 2007, the structure of this new Document format was changed from plain binary to a combination of XML and binary files. Docx files can be opened with Word 2007 and lateral versions, but not with the earlier versions of MS Word which support DOC file extensions

Below is code snippet in net that demonstrates how to merge DOCX files into single file.

```python
with gm.Merger("c:/sample1.docx") as merger:
    merger.join("c:/sample2.docx")
    merger.save("c:/merged.docx")
```

## How to merge TXT files

A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by a sequence of characters.

You can combine any number of text files like shows this net code sample:

```python
with gm.Merger("c:/sample1.txt") as merger:
    merger.join("c:/sample2.txt")
    merger.save("c:/merged.txt")
```

## How to merge RTF files

Introduced and documented by Microsoft, the Rich Text Format (RTF) represents a method of encoding formatted text and graphics for use within applications. The format facilitates cross-platform document exchange with other Microsoft Products, thus serving the purpose of interoperability. This capability makes it a standard of data transfer between word processing software and, hence, contents can be transferred from one operating system to another without losing document formatting.

Joining multiple RTF documents into one is pretty the same as for any other formats - just specify files you want to merge and save the resultant document.

```python
with gm.Merger("c:/sample1.rtf") as merger:
    merger.join("c:/sample2.rtf")
    merger.save("c:/merged.rtf")
```

### Code Examples

Please find more [use-cases and complete Python via .NET sources](https://docs.groupdocs.com/merger/python-net/showcases/) of our backend and frontend examples and try them for free!

### Merge Word files Live Demo

GroupDocs.Merger for Python via .NET provides an online [**Word Merger App**](https://products.groupdocs.app/merger/word), which allows you to try it for free and check its quality and accuracy.
---

## Migrating to GroupDocs.Assembly 18.9 or Higher

Path: /assembly/net/migrating-to-groupdocs-assembly-18-9-or-higher/

{{< alert style="info" >}}This document describes the changes to the GroupDocs.Assembly API from version 18.7 to 18.9 or greater that may be of interest to module/application developers. It includes not only new and updated public methods, added & removed classes etc., but also a description of any changes in the behaviour behind the scenes in GroupDocs.Assembly.{{< /alert >}}

### Breaking changes

Removed members of DocumentAssembler were replaced with new ones. Removed members were not marked as obsolete (deprecated) before removal as usual, because this would complicate migration to new members of DocumentAssembler in Java. Thus, we have introduced a breaking change and customers need to migrate their code from removed members of DocumentAssembler to newly added ones when upgrading to the new version of GroupDocs.Assembly.

### Newly added types

**C#**

```csharp
/// <summary>
/// Provides information on a single data source object to be used to assemble a document from a template.
/// </summary>
public class DataSourceInfo
```

**C#**

```csharp
/// <summary>
/// Specifies the format of a file.
/// </summary>
public enum FileFormat
```

**C#**

```csharp
/// <summary>
/// Specifies additional options for loading and saving of a document to be assembled.
/// </summary>
public class LoadSaveOptions
```

### New members of DocumentAssembler

**C#**

```csharp
/// <summary>
/// Loads a template document from the specified source path, populates the template document with data from
/// the specified single or multiple sources, and stores the result document to the target path using default
/// <see cref="LoadSaveOptions"/>.
/// </summary>
/// <param name="sourcePath">The path to a template document to be populated with data.</param>
/// <param name="targetPath">The path to a result document.</param>
/// <param name="dataSourceInfos">Provides information on data source objects to be used.</param>
public void AssembleDocument(string sourcePath, string targetPath, params DataSourceInfo[] dataSourceInfos)
```

**C#**

```csharp
/// <summary>
/// Loads a template document from the specified source path, populates the template document with data from
/// the specified single or multiple sources, and stores the result document to the target path using the given
/// <see cref="LoadSaveOptions"/>.
/// </summary>
/// <param name="sourcePath">The path to a template document to be populated with data.</param>
/// <param name="targetPath">The path to a result document.</param>
/// <param name="loadSaveOptions">Specifies additional options for document loading and saving.</param>
/// <param name="dataSourceInfos">Provides information on data source objects to be used.</param>
public void AssembleDocument(string sourcePath, string targetPath, LoadSaveOptions loadSaveOptions, params DataSourceInfo[] dataSourceInfos)
```

**C#**

```csharp
/// <summary>
/// Loads a template document from the specified source stream, populates the template document with data from
/// the specified single or multiple sources, and stores the result document to the target stream using default
/// <see cref="LoadSaveOptions"/>.
/// </summary>
/// <param name="sourceStream">The stream to read a template document from.</param>
/// <param name="targetStream">The stream to write a result document.</param>
/// <param name="dataSourceInfos">Provides information on data source objects to be used.</param>
public void AssembleDocument(Stream sourceStream, Stream targetStream, params DataSourceInfo[] dataSourceInfos)
```

**C#**

```csharp
/// <summary>
/// Loads a template document from the specified source stream, populates the template document with data from
/// the specified single or multiple sources, and stores the result document to the target stream using the given
/// <see cref="LoadSaveOptions"/>.
/// </summary>
/// <param name="sourceStream">The stream to read a template document from.</param>
/// <param name="targetStream">The stream to write a result document.</param>
/// <param name="loadSaveOptions">Specifies additional options for document loading and saving.</param>
/// <param name="dataSourceInfos">Provides information on data source objects to be used.</param>
public void AssembleDocument(Stream sourceStream, Stream targetStream, LoadSaveOptions loadSaveOptions, params DataSourceInfo[] dataSourceInfos)
```

### Removed members of DocumentAssembler

**C#**

```csharp
public void AssembleDocument(string sourcePath, string targetPath, object dataSource)
public void AssembleDocument(string sourcePath, string targetPath, object dataSource, string dataSourceName)
public void AssembleDocument(string sourcePath, string targetPath, object[] dataSources, string[] dataSourceNames)
public void AssembleDocument(Stream sourceStream, Stream targetStream, object dataSource)
public void AssembleDocument(Stream sourceStream, Stream targetStream, object dataSource, string dataSourceName)
public void AssembleDocument(Stream sourceStream, Stream targetStream, object[] dataSources, string[] dataSourceNames)
```

### Migrating code from removed members of DocumentAssembler to newly added ones

The following table shows how to migrate code from removed members of DocumentAssembler to newly added ones.

| Old Code | New Code |
| --- | --- |
| `assembler.AssembleDocument(sourcePath, targetPath, dataSource);` | `assembler.AssembleDocument(sourcePath, targetPath, new DataSourceInfo(dataSource));` |
| `assembler.AssembleDocument(sourcePath, targetPath, dataSource, dataSourceName);` | `assembler.AssembleDocument(sourcePath, targetPath, new DataSourceInfo(dataSource, dataSourceName));` |
| `object[] dataSources = new object[] { dataSource1, dataSource2 };`<br/>`string[] dataSourceNames = new string[] { dataSourceName1, dataSourceName2 };`<br/>`assembler.AssembleDocument(sourcePath, targetPath, dataSources, dataSourceNames);` | `assembler.AssembleDocument(sourcePath, targetPath, new DataSourceInfo(dataSource1, dataSourceName1), new DataSourceInfo(dataSource2, dataSourceName2));` |
| `assembler.AssembleDocument(sourceStream, targetStream, dataSource);` | `assembler.AssembleDocument(sourceStream, targetStream, new DataSourceInfo(dataSource));` |
| `assembler.AssembleDocument(sourceStream, targetStream, dataSource, dataSourceName);` | `assembler.AssembleDocument(sourceStream, targetStream, new DataSourceInfo(dataSource, dataSourceName));` |
| `object[] dataSources = new object[] { dataSource1, dataSource2 };`<br/>`string[] dataSourceNames = new string[] { dataSourceName1, dataSourceName2 };`<br/>`assembler.AssembleDocument(sourceStream, targetStream, dataSources, dataSourceNames);` | `assembler.AssembleDocument(sourceStream, targetStream, new DataSourceInfo(dataSource1, dataSourceName1), new DataSourceInfo(dataSource2, dataSourceName2));` |

---

## Modifying found watermark properties

Path: /watermark/net/modifing-found-watermark-properties/

GroupDocs.Watermark also allows you to replace text and image in the found possible watermarks. Following sections will show you how to replace text and image of a found watermark.

## Replacing text

To replace text of the found watermarks, loop through the possible watermarks in the [watermark collection](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search/possiblewatermarkcollection) and replace [Text](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search/possiblewatermark/properties/text) property as shown in the following code sample.

**AdvancedUsage.SearchAndRemoveWatermarks.EditTextInFoundWatermarks**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    TextSearchCriteria searchCriteria = new TextSearchCriteria("test", false);
    PossibleWatermarkCollection watermarks = watermarker.Search(searchCriteria);
    foreach (PossibleWatermark watermark in watermarks)
    {
        try
        {
            // Edit text
            watermark.Text = "passed";
        }
        catch (Exception e)
        {
            // Found entity may not support text editing
            // Passed argument can have inappropriate value
            // Process such cases here
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

## Replacing text with formatting

You can also replace the watermark's text with [formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search/possiblewatermark/properties/formattedtextfragments) as shown in the below code sample.

**AdvancedUsage.SearchAndRemoveWatermarks.EditTextWithFormattingInFoundWatermarks**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    TextSearchCriteria searchCriteria = new TextSearchCriteria("test", false);
    PossibleWatermarkCollection watermarks = watermarker.Search(searchCriteria);
    foreach (PossibleWatermark watermark in watermarks)
    {
        try
        {
            // Edit text
            watermark.FormattedTextFragments.Clear();
            watermark.FormattedTextFragments.Add("passed", new Font("Calibri", 19, FontStyle.Bold), Color.Red, Color.Aqua);
        }
        catch (Exception e)
        {
            // Found entity may not support text editing
            // Passed arguments can have inappropriate value
            // Process such cases here
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```

## Replacing image

Following code sample shows how to replace the [image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search/possiblewatermark/properties/imagedata) of the found watermarks using GroupDocs.Watermark.

**AdvancedUsage.SearchAndRemoveWatermarks.ReplacesImageInFoundWatermarks**

```csharp
byte[] imageData = File.ReadAllBytes("image.png");

// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    // Search watermark matching a particular image
    SearchCriteria searchCriteria = new ImageDctHashSearchCriteria("logo.bmp");
    PossibleWatermarkCollection watermarks = watermarker.Search(searchCriteria);
    foreach (PossibleWatermark watermark in watermarks)
    {
        try
        {
            // Replace image
            watermark.ImageData = imageData;
        }
        catch (Exception e)
        {
            // Found entity may not support image replacment
            // Passed image can have inappropriate format
            // Process such cases here
        }
    }

    // Save document
    watermarker.Save("document.pdf");
}
```


---

## Modifying found watermark properties

Path: /watermark/python-net/modifying-found-watermark-properties/


GroupDocs.Watermark lets you replace text or images in watermarks that already exist in a document.

## Replacing text

Loop through found watermarks and set the `text` property.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    criteria = gws_sc.TextSearchCriteria("test", False)
    possible = watermarker.search(criteria)
    for wm in possible:
        try:
            wm.text = "passed"
        except Exception:
            # Entity may not support text editing or the value is invalid
            pass
    watermarker.save("document.pdf")
```

## Replacing text with formatting

Use `formatted_text_fragments` to set styled text.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("document.pdf") as watermarker:
    criteria = gws_sc.TextSearchCriteria("test", False)
    possible = watermarker.search(criteria)
    for wm in possible:
        try:
            wm.formatted_text_fragments.clear()
            wm.formatted_text_fragments.add(
                "passed",
                gww.Font("Calibri", 19.0, gww.FontStyle.BOLD),
                gww.Color.red,
                gww.Color.aqua,
            )
        except Exception:
            # Entity may not support formatted text or values may be invalid
            pass
    watermarker.save("document.pdf")
```

## Replacing image

Swap the image data of matched watermarks.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with open("image.png", "rb") as f:
    image_data = f.read()

with gw.Watermarker("document.pdf") as watermarker:
    criteria = gws_sc.ImageDctHashSearchCriteria("logo.bmp")
    possible = watermarker.search(criteria)
    for wm in possible:
        try:
            wm.image_data = image_data
        except Exception:
            # Entity may not support image replacement or image format is invalid
            pass
    watermarker.save("document.pdf")
```



---

## Multicolored Numbered List in Spreadsheet Document

Path: /assembly/java/multicolored-numbered-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Spreadsheet Document format.{{< /alert >}}

## Multicolored Numbered List in Microsoft Excel Document

### Creating a Multicolored Numbered List

Practicing the following steps you can create Multicolored Numbered List Template in MS Excel 2013.

1.  Add a new Workbook.
2.  In one cell, write a sentence like "We provide support for the following clients:".
3.  Select the cell, and assign a color by pressing "Cell Styles" in Styles group.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the clients in numbered list.
*   It must highlight the products.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

We provide support for the following clients:

<ol>
<li>&lt;&lt;foreach [in getClients()]>>&lt;&lt;if [indexOf() % 2 == 0]>>&lt;&lt;[getName()]>></li>
<li style="background-color: #ceffbc">&lt;&lt;else>>&lt;&lt;[getName()]>></li>
</ol>

​		<</if>><</foreach>>

### Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Multicolored%20Numbered%20List.xlsx?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs d6c0fde163b9edd0cc9dda4bcd01843a >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Multicolored Numbered List in Spreadsheet Document

Path: /assembly/net/multicolored-numbered-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Multicolored Numbered List in Microsoft Excel Document

### Creating a Multicolored Numbered List

Practising the following steps you can create Multicolored Numbered List Template in MS Excel 2013.

1.  Add a new Workbook.
2.  In one cell, write a sentence like "We provide support for the following products:".
3.  Select the cell, and assign a color by pressing "Cell Styles" in Styles group.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in the numbered list.
*   It must highlight the products.
*   The report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> Price</span></p></td></tr><tr><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">orders</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;if [</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Price</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> &gt;= </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">400</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(255, 242, 204); border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Name</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; c.</span><span style="font-family: Calibri; font-size: 11pt;">Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Multicolored%20Numbered%20List.xlsx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Multicolored Numbered List\_XML.xlsx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Multicolored%20Numbered%20List_XML.xlsx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 85293a1d4e9e6576ed7a04b466da9bab >}}

#### Database Entities

{{< gist GroupDocsGists e6832a1c85f55ff178dc1501f94fbf17 >}}

#### Using DataSet

{{< gist GroupDocsGists 5ec824b55df1fca6151df7c619d77e30 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 7d840e6770fc7c0993d154056ed8e4f4 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 7b8a5709e5ce0047bcfeb25027c2895b >}}

## Multicolored Numbered List in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Multicolored Numbered List' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Multicolored Numbered List\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Multicolored%20Numbered%20List_OpenDocument.ods?raw=true) (use same template for database, dataset and JSON examples)
*   [Multicolored Numbered List\_XML\_OpenDocument.ods](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Multicolored%20Numbered%20List_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists bd8efa56f534f00b2a58221e4ee14805 >}}

#### Database Entities

{{< gist GroupDocsGists afd28f07e88ce281f436be92f6ac9cef >}}

#### Using DataSet

{{< gist GroupDocsGists 04b66bd173782ebec7bfdb2f0cd72e2c >}}

#### Using XML DataSource

{{< gist GroupDocsGists 2f0f994bb60e119ea28665020d55e859 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 958e0d2af3d8ff265813aca35b37796d >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## NoClassDefFoundError javax/xml/bind/DatatypeConverter

Path: /viewer/java/noclassdeffounderror-javaxxmlbind/


GroupDocs.Viewer for Java  API depends on javax.xml.bind for working with PDF files, that is; in case of using Java 9 and above and if the program is required to work with PDF file types, it is required to add reference of `javax.xml.bind` in the project’s class path, because the library was removed from standard Java library.

## Symptoms

You may get exception like `java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter`.

## Solution

The solution is actually very simple as detailed below.

* Download `jaxb-api-2.3.0.jar` library as JAR file from [Maven repository](https://mvnrepository.com/artifact/javax.xml.bind).
* Put the file into your project directory.
* Reference the `jaxb-api-2.3.0.jar` in the class path of the project.

Alternatively, you can add the dependency in the pom.xml and let the project resolve the dependency via maven.

{{< tabs "example1">}}
{{< tab "XML" >}}
```xml
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.0</version>
</dependency>
```
{{< /tab >}}
{{< /tabs >}}

---

## Numbered List in Spreadsheet Document

Path: /assembly/java/numbered-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Numbered List in Microsoft Excel Document

### Creating a Numbered List

Practising the following steps you can create Numbered List Template in MS Excel 2013.  
You can create two kinds of Numbered List in Microsoft Excel.

*   In-cell List
*   Multiple-cell List

Apply the following steps to build the In-Cell template

1.  Add a new Workbook.
2.  Write a sentence, for example "We provide support for the following clients:" in a single cell and add syntax there.
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the client names in numbered list.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**In-cell List**

```java
"We provide support for the following clients:
<<foreach [in getClients()]>><<[numberOf()]>>.         <<[getName()]>>
<</foreach>>"
```

**Multiple-cell List**

```java
<<foreach [in getClients()]>><<[numberOf()]>>.         <<[getName()]>>
<</foreach>>
```

### Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Numbered%20List.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 19dd8c9db2f1f07b67608a2caac732cf >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Numbered List in Spreadsheet Document

Path: /assembly/net/numbered-list-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Numbered List in Microsoft Excel Document

### Creating a Numbered List

Practising the following steps you can create Numbered List Template in MS Excel 2013.  
You can create two kinds of Numbered List in Microsoft Excel.

*   In-cell List
*   Multiple-cell List

Apply the following steps to build the In-Cell template

1.  Add a new Workbook.
2.  Write a sentence, for example "We provide support for the following products:" in a single cell and add syntax there.
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in numbered list.
*   The report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**In-cell List**

```csharp
"We provide support for the following products:<<foreach [in products]>>
<<[NumberOf()]>>.         <<[ProductName]>><</foreach>>"
```

**Multiple-cell List**

```csharp
<<foreach [in products]>><<[NumberOf()]>>.         <<[ProductName]>>
```

and close foreach in next column,

```csharp
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Numbered%20List.xlsx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Numbered List\_XML.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Numbered%20List_XML.xlsx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 2fbc89dd5cea0ea6b55adb5aeafdf801 >}}

#### Database Entities

{{< gist GroupDocsGists 2dd32d44fd6fd9128b2ea32620dddf62 >}}

#### Using DataSet

{{< gist GroupDocsGists a1c29ccafcec8efd2d58b4a7d6bbcc0d >}}

#### Using XML DataSource

{{< gist GroupDocsGists d00d843a5c02f5477c1f90f750361e67 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 60825204f717ea6c24b577c8b8061ca9 >}}

## Numbered List in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit [Wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Numbered List' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Numbered List\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Numbered%20List_OpenDocument.ods?raw=true) (use same template for database, dataset and JSON examples)
*   [Numbered List\_XML\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Numbered%20List_XML_OpenDocument.ods?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists f7f8f23a66c5efcec325927c6825d419 >}}

#### Database Entities

{{< gist GroupDocsGists b204172f799f7e3371eb39f54d67bc66 >}}

#### Using DataSet

{{< gist GroupDocsGists 10a774241943e46d9dde65c6b03a38e9 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 4d8b6adb9bd06a0644ffaed53bfe88d6 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists fa5af16289e3dd4a5fb2892163ed758a >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Obtain document history information

Path: /signature/java/obtain-document-history-information/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) allows to get document history information about processed changes that include list of [ProcessLog](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/ProcessLog ). Each history log record contains following information :

* date/time of processed change.
* type of document process change. See [ProcessType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/ProcessType )
* description of change
* quantity of succeeded and failed signatures

## Analyze document process history information

The following code snippet demonstrates how to obtain information about document historical changes and analyze them.

```java
final Signature signature = new Signature("sampleSigned.pdf");
	try /*JAVA: was using*/
	{
		IDocumentInfo documentInfo = signature.getDocumentInfo();
		// display document process history information
		System.out.print("Document Process logs information: count = "+documentInfo.getProcessLogs().size());
		for (ProcessLog processLog : documentInfo.getProcessLogs())
		{
			System.out.print(" - operation ["+processLog.getType()+"}] on "+processLog.getDate().toString()+"}. Succedded/Failed "+processLog.getSucceeded()+"/"+processLog.getFailed()+". Message: "+processLog.getMessage()+" : ");
			if (processLog.getSignatures() != null)
			{
				for (BaseSignature logSignature : processLog.getSignatures())
				{
					System.out.print("\t\t -"+logSignature.getSignatureType()+" #"+logSignature.getSignatureId()+" at "+logSignature.getTop()+" x "+logSignature.getLeft()+" pos;");
				}
			}
		}
	} catch (Exception e){
		throw new GroupDocsSignatureException(e.getMessage());
	}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.
---

## Obtain document history information

Path: /signature/net/obtain-document-history-information/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) allows to get document history information about processed changes that include list of [ProcessLog](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/processlog). Each history log record contains following information :

* date/time of processed change.
* type of document process change. See [ProcessType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/processtype)
* description of change
* quantity of succeeded and failed signatures

## Analyze document process history information

The following code snippet demonstrates how to obtain information about document historical changes and analyze them.

```csharp
using (Signature signature = new Signature(filePath))
{
    IDocumentInfo documentInfo = signature.GetDocumentInfo();
    // display document process history information
    Console.WriteLine($"Document Process logs information: count = {documentInfo.ProcessLogs.Count}");
    foreach (ProcessLog processLog in documentInfo.ProcessLogs)
    {
        var info = $" - operation [{processLog.Type}] on {processLog.Date.ToShortDateString()}. ";
        info += $"Succedded/Failed {processLog.Succeeded}/{processLog.Failed}. Message: {processLog.Message}";
        Console.WriteLine(info);
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## OCR Usage Basics

Path: /redaction/java/ocr-usage-basics/


Although GroupDocs.Redaction itself does not contain OCR as a part of its distributable, it allows you to integrate any paid or free OCR solution. 
You have to implement [IOcrConnector](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.integration/IOcrConnector) interface and its recognize() method, taking a stream with an image as an argument and returning a structured representation of the text, including bounding rectangles. 

**Java**

```java
public class MyOwnOcrConnector implements IOcrConnector
{
    public MyOwnOcrConnector()
    {
    }

    public RecognizedImage recognize(InputStream imageStream)
    {
	// TODO Create an instance of RecognizedImage class using OCR result returned by your OCR toolkit
    }
}

```

Once the instance is passed to [RedactorSettings](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.options/RedactorSettings) constructor, GroupDocs.Redaction will use it for image files and embedded images during an ordinary textual redaction process.

**Java**

```java
try (Redactor redactor = new Redactor("\\Sample.docx", new LoadOptions(), new RedactorSettings(new MyOwnOcrConnector())))
{
    // Assign an instance before using Redactor
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(java.awt.Color.BLACK)));
    redactor.save();
}

```

GroupDocs.Redaction provides two examples of the IOcrConnector implementation, free to use and customize for your needs. First, the [implementation based on Aspose.OCR for Cloud SDK]({{< ref "/redaction/java/developer-guide/advanced-usage/using-ocr/use-aspose-ocr-for-cloud" >}}). Second [implementation is using Microsoft Azure Cognitive Services API]({{< ref "/redaction/java/developer-guide/advanced-usage/using-ocr/use-microsoft-azure-computer-vision" >}}). Both services propose a trial subscription plan, but you can use any other free or paid OCR solution, web-based or on premise, by creating your own implementation of [IOcrConnector](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.integration/IOcrConnector).


## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## OCR Usage Basics

Path: /redaction/net/ocr-usage-basics/


Although GroupDocs.Redaction itself does not contain OCR as a part of its distributable, it allows you to integrate any paid or free OCR solution. 
You have to implement [IOcrConnector](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration.ocr/iocrconnector) interface and its RecognizeImage() method, taking a stream with an image as an argument and returning a structured representation of the text, including bounding rectangles. 

**C#**

```csharp
public class MyOwnOcrConnector : IOcrConnector
{
    public MyOwnOcrConnector()
    {
    }

    public RecognizedImage Recognize(Stream imageStream)
    {
	// TODO Create an instance of RecognizedImage class using OCR result returned by your OCR toolkit

        throw new NotImplementedException();
    }
}

```

Once the instance is passed to [RedactorSettings](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.options/redactorsettings) constructor, GroupDocs.Redaction will use it for image files and embedded images during an ordinary textual redaction process.

**C#**

```csharp
using (Redactor redactor = new Redactor("\\Sample.docx", new LoadOptions(), new RedactorSettings(new MyOwnOcrConnector())))
{
    // Assign an instance before using Redactor
    redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(Color.Black)));
    redactor.Save();
}

```

GroupDocs.Redaction provides three examples of the IOcrConnector implementation, free to use and customize for your needs. First, the [implementation based on Aspose.OCR for Cloud SDK]({{< ref "/redaction/net/developer-guide/advanced-usage/using-ocr/use-aspose-ocr-for-cloud" >}}). Second, the [implementation based on Aspose.OCR on-premise API for .NET]({{< ref "/redaction/net/developer-guide/advanced-usage/using-ocr/use-aspose-ocr-on-premise" >}}). Third [implementation is using Microsoft Azure Cognitive Services API]({{< ref "/redaction/net/developer-guide/advanced-usage/using-ocr/use-microsoft-azure-computer-vision" >}}). Both services propose a trial subscription plan, but you can use any other free or paid OCR solution, web-based or on premise, by creating your own implementation of [IOcrConnector](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration.ocr/iocrconnector).


## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Optimize output for printing

Path: /viewer/java/how-to-optimize-output-html-for-printing/


To optimize HTML output for printing, use the [setForPrinting()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setForPrinting-boolean-) method of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class.

If the `ForPrinting` property is `true`, the output HTML pages are converted to the vector SVG format.

This option is supported for the following format families:

* Presentation documents: PPT, PPS, PPTX, PPSX, ODP, FODP, OTP, POT, POTX, POTM, PPTM, PPSM
* Diagram documents: VSD, VSDX, VSS, VST, VSX, VTX, VDW, VDX, VSSX, VSTX, VSDM, VSSM, VSTM
* Meta file formats: WMF, WMZ, EMF, EMZ

The following code snippet shows how to render a .docx document to HTML optimized for printing:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources("output.html");
    // HtmlViewOptions options = HtmlViewOptions.forExternalResources("p_{0}.html", "p_{0}_{1}", "p_{0}_{1}");
    // Optimize output for printing.
    options.setForPrinting(true);

    viewer.view(options);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Optimize output for printing

Path: /viewer/net/how-to-optimize-output-html-for-printing/


To optimize HTML output for printing, use the [ForPrinting](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions/properties/forprinting) boolean property of the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) class.

If the [ForPrinting](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions/properties/forprinting) option is enabled, the output HTML pages are converted to the vector SVG format.

This option is supported for the following format families:

* Presentation documents: PPT, PPS, PPTX, PPSX, ODP, FODP, OTP, POT, POTX, POTM, PPTM, PPSM
* Diagram documents: VSD, VSDX, VSS, VST, VSX, VTX, VDW, VDX, VSSX, VSTX, VSDM, VSSM, VSTM
* Meta file formats: WMF, WMZ, EMF, EMZ

The following code snippet shows how to render a .docx document to HTML optimized for printing:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create view options.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();

    // Render a file optimized for printing.
    viewOptions.ForPrinting = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create view options.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
        
            ' Render a file optimized for printing.
            viewOptions.ForPrinting = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Optimize the PDF file resources

Path: /viewer/java/optimization-pdf-resources/

Resource optimization allows you to reduce the size of the output PDF file. While optimizing, GroupDocs.Viewer may reduce the image size or quality, remove notes or form fields, remove objects, fonts, or personal information from a document, and so on.

The following code snippet shows how to optimize the PDF file by default:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setPdfOptimizationOptions(new PdfOptimizationOptions());
     
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}



---

## Optimize the PDF file resources

Path: /viewer/net/optimization-pdf-resources/

Resource optimization allows you to reduce the size of the output PDF file. While optimizing, GroupDocs.Viewer may reduce the image size or quality, remove notes or form fields, remove objects, fonts, or personal information from a document, and so on.

The following code snippet shows how to optimize the PDF file by default:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions();
     
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions()

            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Optimize the PDF file resources

Path: /viewer/python-net/optimization-pdf-resources/

Resource optimization allows you to reduce the size of the output PDF file. While optimizing, GroupDocs.Viewer may reduce the image size or quality, remove notes or form fields, remove objects, fonts, or personal information from a document, and so on.

The following code snippet shows how to optimize the PDF file by default:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def optimize_pdf_resources():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("optimize_pdf_resources/optimized_spreadsheet.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()

        viewer.view(viewOptions)

if __name__ == "__main__":
    optimize_pdf_resources()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimization-pdf-resources/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Password-protected documents

Path: /parser/net/password-protected-documents/

GroupDocs.Parser provides the functionality to open and process password-protected documents including encrypted PDFs and password-protected Office files (DOCX, XLSX, PPTX).

## Supported Encryption Types

The library supports the following encryption types:
- **PDF:** Standard password encryption (user password)
- **Office Documents:** Password-protected DOCX, XLSX, PPTX files
- **Legacy Office:** Password-protected DOC, XLS, PPT files

{{< alert style="warning" >}}
**Note:** The library cannot decrypt documents with owner passwords (restrictions passwords) that only restrict printing/editing. Only documents with user passwords (opening passwords) are supported.
{{< /alert >}}

## Basic Usage

Here are the steps to work with password-protected documents:

1. Instantiate the [LoadOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions) object and pass the password in the [LoadOptions(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions/constructors/4) constructor
2. Create [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object with LoadOptions
3. Call any extraction method

The following code sample shows how to process password-protected documents with comprehensive error handling:

```csharp
using GroupDocs.Parser;
using GroupDocs.Parser.Options;
using GroupDocs.Parser.Exceptions;
using System;

try
{
    string password = "your-password";
    
    // Create LoadOptions with password
    LoadOptions loadOptions = new LoadOptions(password);
    
    // Create an instance of Parser class with the password
    using (Parser parser = new Parser(filePath, loadOptions))
    {
        // Check if text extraction is supported
        if (!parser.Features.Text)
        {
            Console.WriteLine("Text extraction isn't supported for this format.");
            return;
        }
        
        // Print the document text
        using (TextReader reader = parser.GetText())
        {
            if (reader != null)
            {
                Console.WriteLine(reader.ReadToEnd());
            }
            else
            {
                Console.WriteLine("Text extraction returned null.");
            }
        }
    }
}
catch (InvalidPasswordException ex)
{
    // Thrown when password is incorrect or empty
    Console.WriteLine($"Invalid password: {ex.Message}");
}
catch (UnsupportedDocumentFormatException ex)
{
    // Thrown when document format is not supported
    Console.WriteLine($"Unsupported format: {ex.Message}");
}
catch (ParserException ex)
{
    // General parsing exception
    Console.WriteLine($"Parsing error: {ex.Message}");
}
```

## Exception Handling

When working with password-protected documents, the following exceptions may be thrown:

| Exception | When It's Thrown | Resolution |
|-----------|------------------|------------|
| [InvalidPasswordException](https://reference.groupdocs.com/net/parser/groupdocs.parser.exceptions/invalidpasswordexception) | Password is incorrect, empty, or not provided | Provide the correct password in LoadOptions |
| [UnsupportedDocumentFormatException](https://reference.groupdocs.com/net/parser/groupdocs.parser.exceptions/unsupporteddocumentformatexception) | Document format is not supported | Check if the file format is in the [supported formats list]({{< ref "parser/net/getting-started/supported-document-formats.md" >}}) |
| [ParserException](https://reference.groupdocs.com/net/parser/groupdocs.parser.exceptions/parserexception) | General parsing error (corrupted file, insufficient permissions, etc.) | Verify file integrity and access permissions |

## Check if Document is Password-Protected

Before attempting to open a document, you can check if it requires a password:

```csharp
using GroupDocs.Parser.Options;

// Get file information
FileInfo info = Parser.GetFileInfo(document);

// Check if the document is encrypted/password-protected
if (info.IsEncrypted)
{
    Console.WriteLine("This document is password-protected. Password is required.");
    // Prompt user for password or load from configuration
    string password = GetPasswordFromUser();
    
    LoadOptions loadOptions = new LoadOptions(password);
    using (Parser parser = new Parser(document, loadOptions))
    {
        // Process the document
    }
}
else
{
    Console.WriteLine("Document is not password-protected.");
    using (Parser parser = new Parser(document))
    {
        // Process the document without password
    }
}
```

## Complete Example: Extract Text from Password-Protected PDF

```csharp
using GroupDocs.Parser;
using GroupDocs.Parser.Options;
using GroupDocs.Parser.Exceptions;

public void ExtractTextFromProtectedPdf(string filePath, string password)
{
    try
    {
        // Check if password is needed
        FileInfo fileInfo = Parser.GetFileInfo(filePath);
        
        LoadOptions loadOptions = fileInfo.IsEncrypted 
            ? new LoadOptions(password) 
            : new LoadOptions();
        
        using (Parser parser = new Parser(filePath, loadOptions))
        {
            if (!parser.Features.Text)
            {
                Console.WriteLine("Text extraction is not supported.");
                return;
            }
            
            using (TextReader reader = parser.GetText())
            {
                if (reader != null)
                {
                    string extractedText = reader.ReadToEnd();
                    Console.WriteLine($"Extracted text length: {extractedText.Length} characters");
                }
            }
        }
    }
    catch (InvalidPasswordException)
    {
        Console.WriteLine("Error: Invalid password provided.");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Save signed Pdf with different output file type

Path: /signature/java/save-signed-pdf-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports saving of Pdf signed documents to different formats. Each of document type has list of compatible saving type. These values are listed in enum [PdfSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/PdfSaveFileFormat).

Here are the steps to save signed Pdf document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java):
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class and pass source document path or stream as a constructor parameter.    
*   Instantiate required signature options.    
*   Instantiate the [PdfSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/PdfSaveOptions) object according to your requirements and specify [setFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/PdfSaveOptions#setFileFormat(int)) as one of predefined values from [PdfSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/PdfSaveFileFormat).      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signatureoptions and [PdfSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/PdfSaveOptions) object to it.
    

```java
Signature signature = new Signature("sample.pdf");
// create QRCode option with predefined QRCode text
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.setFileFormat(PdfSaveFileFormat.DocX);
saveOptions.setOverwriteExistingFiles(true);
// sign document to file
signature.sign("SignedPdf.docx", signOptions, saveOptions);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to save PDF document with other format

Path: /signature/net/save-signed-pdf-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving of Pdf signed documents to different formats. Each of document type has list of compatible saving type. These values are listed in enum [PdfSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/pdfsavefileformat).

Here are the steps to save signed Pdf document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the [PdfSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions) object according to your requirements and specify [FileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions/fileformat) as one of predefined values from [PdfSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/pdfsavefileformat).  
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signatureoptions and [PdfSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions) object to it.

Following example demonstrates how to save signed PDF document with different output type

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create QRCode option with predefined QRCode text
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QRCodeTypes.QR,
        Left = 100,
        Top = 100
    };
    PdfSaveOptions pdfSaveOptions = new PdfSaveOptions()
    {
        FileFormat = PdfSaveFileFormat.DocX,
        OverwriteExistingFiles = true
    };
    // sign document to file
    signature.Sign("SignedPdf.docx", signOptions, pdfSaveOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Pie Chart in Spreadsheet Document

Path: /assembly/java/pie-chart-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Pie Chart in Microsoft Excel Document

### Creating a Pie Chart

Please follow below steps to create Pie Chart in MS Excel 2013.

1.  Add a new Workbook.
2.  Click in the workbook where you want to insert the chart, click the "Insert" tab, and then click "Pie Chart Icon" in the charts group.
3.  A drop-down with charts will appear, select the "Pie" and press "OK" to insert the chart.
4.  Click on the chart you just inserted, then click the "Change Data" icon in Data group.
5.  Now add legend entries. See [Chart Data](https://docs.groupdocs.com/assembly/java/pie-chart-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share managers' contract prices dynamically with the following key requirements:

*   Report must show information on a Pie Chart.
*   It must indicate manager name with value (price of the contract).
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Price<<foreach [in getManagers()]>><<x [getName()]>>
```

#### Chart Data

**Legend Entries**

```java
="Total Contract Price<<y [getContracts().sum(c => c.getPrice())]>>"
```

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Pie Chart.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Pie%20Chart.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists a8997c78d41078faf2b39601411357b8 >}}

## Pie Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Pie Chart in Spreadsheet Document

Path: /assembly/net/pie-chart-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Pie Chart in Microsoft Excel Document

### Creating a Pie Chart

Please follow below steps to create Pie Chart in MS Excel 2013.

1.  Add a new Workbook.
2.  Click in the workbook where you want to insert the chart, click the "Insert" tab, and then click "Pie Chart Icon" in the charts group.
3.  A drop-down with charts will appear, select the "Pie" and press "OK" to insert the chart.
4.  Click on the chart you just inserted, then click the "Change Data" icon in Data group.
5.  Now add legend entries. See [Chart Data](https://docs.groupdocs.com/assembly/net/pie-chart-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine)
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart.
*   It must indicate customer name with value (price of the orders purchased).
*   The report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data

**Legend Entries**

```csharp
="Total Order Price<<y [Order.Sum(c => c.Price)]>>"
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Pie Chart.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Pie%20Chart.xlsx?raw=true) (Template for CustomObject and JSON examples)
*   [Pie Chart\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Pie%20Chart_DB.xlsx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 9fbffedfe245612403cffebea41c2191 >}}



#### Database Entities

{{< gist GroupDocsGists 56046573d12769a1b23fed18850cf8f9 >}}



#### Using DataSet

{{< gist GroupDocsGists 885ade4670358b72fcfb00fa9bf5fe5e >}}



#### Using XML DataSource

{{< gist GroupDocsGists 0cb24748eee81d88b205c0f19b2b4f62 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 1372b2b5fb02b3ac72ceb69a023d3b17 >}}



## Pie Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Preview Digital Certificates properties

Path: /signature/net/preview-certificate-properties/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [GetDocumentInfo](https://apireference.groupdocs.com/signature/net/groupdocs.signature/signature/getdocumentinfo) method to receive document information. The response [IDocumentInfo](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/idocumentinfo/).will includes:

* list of [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/) that for certificate document will keep all its properties;

## Receive digital certificate properties

```csharp
    LoadOptions loadOptions = new LoadOptions()
    {
        Password = "1234567890"
    };

    using (Signature signature = new Signature("certificate.pfx", loadOptions))
    {
        IDocumentInfo documentInfo = signature.GetDocumentInfo();
        Console.WriteLine($"Certificate properties {Path.GetFileName(certificatePath)}:");
        Console.WriteLine($" - format : {documentInfo.FileType.FileFormat}");
        Console.WriteLine($" - extension : {documentInfo.FileType.Extension}");
        Console.WriteLine($" - size : {documentInfo.Size}");
        Console.WriteLine($" - page count : {documentInfo.PageCount}");

        // display document MetaData signatures information
        Console.WriteLine($"Certificate properties:");
        foreach (MetadataSignature metadataSignature in documentInfo.MetadataSignatures)
        {
            Console.WriteLine($" - {metadataSignature.Name}:{metadataSignature.Value} ({metadataSignature.Type})");
        }
    }

```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Protect PDF document

Path: /viewer/java/protect-pdf-documents/

You can protect a PDF document by setting the following parameters:

* permissions
* password to open document
* password to change permissions

To protect a PDF document, follow these steps:

1. Create an instance of the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) class. Specify the source document path as a constructor parameter.
2. Instantiate the [Security](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/security/) class.
3. To specify a password to open the document, call the [setDocumentOpenPassword()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/security/#setDocumentOpenPassword-java.lang.String-) method.
4. To specify a password to change restrictions, call the [setPermissionsPassword()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/security/#setPermissionsPassword-java.lang.String-) method. 
5. To specify the document permissions, call the [setPermissions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/security/#setPermissions-int-) method.
6. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) object. Specify the saving path format for the rendered document.
7. Call the [setSecurity](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/#setSecurity-com.groupdocs.viewer.options.Security-) method of the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) class. Specify object created in steps 2-5.
8. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method of the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object. Specify the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) object as the parameter.

The following code snippet shows how to protect the output PDF document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.Permissions;
import com.groupdocs.viewer.options.Security;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    // Specify the security settings.
    Security security = new Security();
    security.setDocumentOpenPassword("o123");
    security.setPermissionsPassword("p123");
    security.setPermissions(Permissions.ALLOW_ALL ^ Permissions.DENY_PRINTING);
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Apply the security settings.
    viewOptions.setSecurity(security);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Protect PDF document

Path: /viewer/net/protect-pdf-documents/

You can protect a PDF document by setting the following parameters:

* permissions
* password to open document
* password to change permissions

To protect a PDF document, follow these steps:

1. Create an instance of the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) class. Specify the source document path as a constructor parameter.
2. Instantiate the [Security](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/security) object.
3. To specify a password to open the document, set the [DocumentOpenPassword](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/security/properties/documentopenpassword) property.
4. To specify a password to change restrictions, set the [PermissionsPassword](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/security/properties/permissionspassword) property. 
5. To specify the document permissions, set the [Permissions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/permissions) property.
6. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) object. Specify the saving path format for the rendered document.
7. Initialize the [Security](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions/properties/security) property of the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) object with the object created in steps 2-5.
8. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method of the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) object as the parameter.

The following code snippet shows how to protect the output PDF document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer;
// ...

using(Viewer viewer = new Viewer("sample.docx"))
{
    // Specify the security settings.
    Security security = new Security();
    security.DocumentOpenPassword = "o123";
    security.PermissionsPassword = "p123";
    security.Permissions = Permissions.AllowAll ^ Permissions.DenyPrinting;

    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions();
    
    // Apply the security settings
    viewOptions.Security = security;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Specify the security settings.
            Dim security As Security = New Security()
            security.DocumentOpenPassword = "o123"
            security.PermissionsPassword = "p123"
            security.Permissions = Permissions.AllowAll Xor Permissions.DenyPrinting

            ' Create a PDF file.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()

            ' Apply the security settings
            viewOptions.Security = security
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Protect PDF document

Path: /viewer/python-net/protect-pdf-documents/

You can protect a PDF document by setting the following parameters:

* permissions
* password to open document
* password to change permissions

To protect a PDF document, follow these steps:

1. Create an instance of the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class. Specify the source document path as a constructor parameter.
2. Instantiate the [Security](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/security) object.
3. To specify a password to open the document, set the [DocumentOpenPassword](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/security/#properties) property.
4. To specify a password to change restrictions, set the [PermissionsPassword](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/security/#properties) property. 
5. To specify the document permissions, set the [Permissions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/permissions) property.
6. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) object. Specify the saving path format for the rendered document.
7. Initialize the [Security](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/#properties) property of the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) object with the object created in steps 2-5.
8. Call the [view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method of the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) object. Specify the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) object as the parameter.

The following code snippet shows how to protect the output PDF document:

{{< tabs "example1">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, Security, Permissions

def protect_pdf_document():
    # Load document
    with Viewer("sample.docx") as viewer:
        # Specify the security settings.
        security = Security()
        security.document_open_password = "o123"
        security.permissions_password = "p123"
        security.permissions = Permissions.ALLOW_ALL & ~Permissions.DENY_PRINTING

        # Create a PDF file.
        pdf_options = PdfViewOptions("protect_pdf_document/protected_document.pdf")

        # Apply the security settings
        pdf_options.security = security
        viewer.view(pdf_options)

if __name__ == "__main__":
    protect_pdf_document()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/protect-pdf-document/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Quick Start Guide

Path: /conversion/java/getting-started/quick-start-guide/


This guide provides a quick overview of how to set up and start using [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/). This library enables developers to convert between various file formats (e.g., DOCX, PDF, PNG) with minimal configuration.

## Prerequisites

To proceed, make sure you have:

- **Configured** your development environment as described in the [System Requirements]({{< ref "conversion/java/system-requirements" >}}) topic.
- **Optionally**, obtained a [Temporary License](https://purchase.groupdocs.com/temporary-license/) to test all product features.

## Set Up Your Development Environment

### Install GroupDocs.Conversion for Java

1. Download the latest **GroupDocs.Conversion for Java** from the official website or include it in your project via **Maven**:

{{< tabs "example1">}}
{{< tab "Maven" >}}
```java
<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion</artifactId>
    <version>latest-version</version>
</dependency>
```
{{< /tab >}}
{{< /tabs >}}

2. If using a **Gradle** project, add this dependency to `build.gradle`:

{{< tabs "example2">}}
{{< tab "Gradle" >}}
```ps
dependencies {
    implementation 'com.groupdocs:groupdocs-conversion:latest-version'
}
```
{{< /tab >}}
{{< /tabs >}}

### Configure Your Java Environment

Ensure that you are using:
- **Java 8 or later**
- A compatible build tool (Maven/Gradle/Ant)
- An IDE such as IntelliJ IDEA, Eclipse, or Visual Studio Code

If you are using a Java web application, configure the dependency in the respective WAR/JAR structure and ensure all dependencies are resolved.

## Example 1: Convert DOCX to PDF

### Java Implementation
To quickly test the library, let’s convert a **DOCX** file to **PDF**.

{{< tabs "demo_app_convert_docx_to_pdf">}}
{{< tab "convert_docx_to_pdf.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import java.io.File;

public class ConvertDocxToPdf {
    public static void main(String[] args) {
        String inputFilePath = "./business-plan.docx";
        String outputFilePath = "./business-plan.pdf";
        
        try (Converter converter = new Converter(inputFilePath)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert(outputFilePath, options);
            System.out.println("Conversion completed successfully.");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/getting-started/quick-start-guide/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is expected output PDF file. Click [here](/conversion/python-net/java/getting-started/quick-start-guide/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation
- `Converter("./business-plan.docx")`: Initializes the converter with the DOCX file.
- `PdfConvertOptions()`: Specifies the output format as PDF.
- `converter.convert("./business-plan.pdf", options)`: Converts the DOCX file to PDF and saves it.

## Example 2: Convert PDF Pages to PNG

### Java Implementation
{{< tabs "demo_app_convert_pdf_pages_to_png">}}
{{< tab "convert_pdf_pages_to_png.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.SavePageStream;
import com.groupdocs.conversion.filetypes.ImageFileType;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import java.io.FileOutputStream;
import java.io.IOException;

public class ConvertPdfPagesToPng {
    public static void main(String[] args) {
        String inputFilePath = "./annual-review.pdf";
        String outputFile = "./converted-pages/pdf-converted-page-%d.png";

        SavePageStream getPageStream = page -> {
            try {
                return new FileOutputStream(String.format(outputFile, page));
            } catch (IOException e) {
                e.printStackTrace();
                return null; // Return null to handle it later
            }
        };

        try (Converter converter = new Converter(inputFilePath)) {
            ImageConvertOptions options = new ImageConvertOptions();
            options.setFormat(ImageFileType.PNG);
            
            converter.convert(getPageStream, options);
            System.out.println("PDF pages converted to PNG successfully.");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
```
{{< /tab >}}
{{< tab "annual-review.pdf" >}}  
{{< tab-text >}}
`annual-review.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/getting-started/quick-start-guide/annual-review.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted-pages" >}}  
{{< tab-text >}}
`converted-pages` is output folder where converted pages are stored. Click [here](/conversion/java/_sample_files/getting-started/quick-start-guide/converted-pages.zip) to download the output PNG files.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation
- `Converter("./annual-review.pdf")`: Initializes the converter with the PDF file.
- `SavePageStream`: Implements a lambda function that provides an output stream for each page.
- `ImageConvertOptions()`: Specifies the output format as image.
- `ImageFileType.PNG`: Sets the output image format to PNG.
- `converter.convert(getPageStream, png_convert_options)`: Converts the PDF file pages to PNG and saves output file in `converted-pages` folder.


## Next Steps

After completing the basics, explore additional resources to enhance your usage:
- [Supported File Formats]({{< ref "conversion/java/supported-document-formats" >}}): Review the full list of supported file types.
- [Licensing]({{< ref "conversion/java/licensing-and-subscription" >}}): Check details on licening and evaluation.
- [Technical Support]({{< ref "conversion/java/technical-support" >}}): Contact support for assistance if you encounter issues.

---

## Quick Start Guide

Path: /conversion/python-net/getting-started/quick-start-guide/


This guide provides a quick overview of how to set up and start using GroupDocs.Conversion for Python via .NET. This library enables developers to convert between various file formats (e.g., DOCX, PDF, PNG) with minimal configuration.

## Prerequisites

To proceed, make sure you have:

1. **Configured** environment as described in the [System Requirements]({{< ref "conversion/python-net/system-requirements" >}}) topic.
2. **Optionally** you may [Get a Temporary License](https://purchase.groupdocs.com/temporary-license/) to test all the product features. 

## Set Up Your Development Environment

For best practices, use a virtual environment to manage dependencies in Python applications. Learn more about virtual environment at [Create and Use Virtual Environments](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#create-and-use-virtual-environments) documentation topic.

### Create and Activate a Virtual Environment

Create a virtual environment:

{{< tabs "example1">}}
{{< tab "Windows" >}}
```ps
py -m venv .venv
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m venv .venv
```
{{< /tab >}}
{{< /tabs >}}

Activate a virtual environment:

{{< tabs "example2">}}
{{< tab "Windows" >}}
```ps
.venv\Scripts\activate
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
source .venv/bin/activate
```
{{< /tab >}}
{{< /tabs >}}

### Install `groupdocs-conversion-net` Package

After activating the virtual environment, run the following command in your terminal to install the latest version of the package:

{{< tabs "example3">}}
{{< tab "Windows" >}}
```ps
py -m pip install groupdocs-conversion-net
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m pip install groupdocs-conversion-net
```
{{< /tab >}}
{{< /tabs >}}

Ensure the package is installed successfully. You should see the message 

```bash
Successfully installed groupdocs-conversion-net-*
```

## Example 1: Convert document

To quickly test the library, let’s convert a DOCX file to PDF. You can also download the app that we're going to buid [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/convert_docx_to_pdf.zip).

{{< tabs "demo_app_convert_docx_to_pdf">}}
{{< tab "convert_docx_to_pdf.py" >}}  
```python
import os
from groupdocs.conversion import License, Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_docx_to_pdf():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Conversion.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load DOCX file
    with Converter("./business-plan.docx") as converter:
        # Create convert options
        pdf_convert_options = PdfConvertOptions()

        # Convert DOCX to PDF
        converter.convert("./business-plan.pdf", pdf_convert_options)    

if __name__ == "__main__":
    convert_docx_to_pdf()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is expected output PDF file. Click [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 demo-app
 ├──convert_docx_to_pdf.py
 ├──business-plan.docx
 └──GroupDocs.Conversion.lic (Optionally)
```

### Run the App

{{< tabs "run-the-app">}}
{{< tab "Windows" >}}
```ps
py convert_docx_to_pdf.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 convert_docx_to_pdf.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Converter("./business-plan.docx")`: Initializes the converter with the DOCX file.
- `PdfConvertOptions()`: Specifies the output format as PDF.
- `converter.convert("./business-plan.pdf", pdf_convert_options)`: Converts the DOCX file to PDF and saves it as `business-plan.pdf`.

## Example 2: Convert document pages

In this example we'll convert PDF document pages to PNG. You can download the app that we're going to buid [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/convert_pdf_pages_to_png.zip).

{{< tabs "demo_app_convert_pdf_pages_to_png">}}
{{< tab "convert_pdf_pages_to_png.py" >}}  
```python
import os
from groupdocs.conversion import License, Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

def convert_pdf_pages_to_png():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Conversion.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load PDF document
    with Converter("./annual-review.pdf") as converter:
        # Create convert options
        png_convert_options = ImageConvertOptions()
        png_convert_options.format = ImageFileType.PNG
        
        # Convert document pages and save converted pages in the output folder
        converter.convert_by_page("./converted-pages", png_convert_options)    

if __name__ == "__main__":
    convert_pdf_pages_to_png()
```
{{< /tab >}}
{{< tab "annual-review.pdf" >}}  
{{< tab-text >}}
`annual-review.pdf` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/annual-review.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted-pages" >}}  
{{< tab-text >}}
`converted-pages` is output folder where converted pages are stored. Click [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/converted-pages.zip) to download the output PNG files.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 demo-app
 ├──annual-review.pdf
 ├──convert_pdf_pages_to_png.py
 └──GroupDocs.Conversion.lic (Optionally)
```

### Run the App

{{< tabs "run_the_app_convert_pdf_pages_to_png">}}
{{< tab "Windows" >}}
```ps
py convert_pdf_pages_to_png.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 convert_pdf_pages_to_png.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Converter("./annual-review.pdf")`: Initializes the converter with the PDF file.
- `ImageConvertOptions()`: Specifies the output format as image.
- `ImageFileType.PNG`: Sets the output image format to PNG.
- `converter.convert_by_page("./converted-pages", png_convert_options)`: Converts the PDF file pages to PNG and saves output file in `converted-pages` folder.

## Example 3: Convert files in archive

In this example we'll convert documents packed into ZIP archive to PDF. You can download the app that we're going to buid [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/convert_files_in_archive.zip).

{{< tabs "demo_app_convert_files_in_archive">}}
{{< tab "convert_files_in_archive.py" >}}  
```python
import os
from groupdocs.conversion import License, Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_files_in_archive():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Conversion.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load ZIP file
    with Converter("./compressed.zip") as converter:
        # Create convert options
        pdf_convert_options = PdfConvertOptions()
        
        # Extract ZIP and convert each file to PDF
        converter.convert_multiple("./converted-files", pdf_convert_options)    

if __name__ == "__main__":
    convert_files_in_archive()
```
{{< /tab >}}
{{< tab "compressed.zip" >}}  
{{< tab-text >}}
`compressed.zip` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/compressed.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted-files" >}}  
{{< tab-text >}}
`converted-files` is output folder where files converted to PDF are stored. Click [here](/conversion/python-net/_sample_files/getting-started/quick-start-guide/converted-files.zip) to download the output PDF files.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 demo-app
 ├──compressed.zip
 ├──convert_files_in_archive.py
 └──GroupDocs.Conversion.lic (Optionally)
```

### Run the App

{{< tabs "run_the_app_convert_files_in_archive">}}
{{< tab "Windows" >}}
```ps
py convert_files_in_archive.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 convert_files_in_archive.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Converter("./compressed.zip")`: Initializes the converter with the ZIP file.
- `PdfConvertOptions()`: Specifies the output format for files as PDF.
- `converter.convert_multiple("./converted-files", pdf_convert_options)`: Extracts files from ZIP, converts each file to PDF saves output files in `converted-files` folder.

## Next Steps

After completing the basics, explore additional resources to enhance your usage:
- [Supported File Formats]({{< ref "conversion/python-net/supported-file-formats" >}}): Review the full list of supported file types.
- [Licensing]({{< ref "conversion/python-net/licensing" >}}): Check details on licening and evaluation.
- [Technical Support]({{< ref "conversion/python-net/technical-support" >}}): Contact support for assistance if you encounter issues.

---

## Quick Start Guide

Path: /parser/python-net/quick-start/


This guide demonstrates the essential steps to get started with GroupDocs.Parser for Python via .NET and perform basic document parsing operations.

## Prerequisites

Before you begin, ensure you have:

- Python 3.5 or higher installed
- GroupDocs.Parser for Python via .NET installed (see [Installation]({{< ref "parser/python-net/getting-started/installation" >}}))

## Extract Text from a Document

The most common task is extracting text from documents. Here's how to do it:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_text_from_document():
    # Create an instance of Parser class
    with Parser("./sample.pdf") as parser:
        # Extract text from the document
        text_reader = parser.get_text()
        
        if text_reader is not None:
            # Print the extracted text
            print(text_reader)
        else:
            print("Text extraction isn't supported for this format")

if __name__ == "__main__":
    extract_text_from_document()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/quick-start/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get Document Information

You can retrieve basic information about a document:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def get_document_information():
    # Create an instance of Parser class
    with Parser("./sample.pdf") as parser:
        # Get document info
        info = parser.get_document_info()
        
        print(f"File type: {info.file_type.file_format}")
        print(f"Page count: {info.page_count}")
        print(f"Size: {info.size} bytes")

if __name__ == "__main__":
    get_document_information()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/quick-start/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Extract Metadata

Extract metadata properties from documents:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_metadata():
    # Create an instance of Parser class
    with Parser("./sample.pdf") as parser:
        # Extract metadata
        metadata = parser.get_metadata()
        
        if metadata is not None:
            for item in metadata:
                print(f"{item.name}: {item.value}")

if __name__ == "__main__":
    extract_metadata()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/quick-start/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Extract Images

Extract images from documents:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_images():
    # Create an instance of Parser class
    with Parser("./sample.pdf") as parser:
        # Extract images
        images = parser.get_images()
        
        if images is not None:
            for i, image in enumerate(images):
                # Save image to file
                with open(f"image_{i}.{image.file_type.extension}", "wb") as file:
                    file.write(image.get_image_stream().read())

if __name__ == "__main__":
    extract_images()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/quick-start/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Extract Text from Specific Page

Extract text from a particular page:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_text_from_specific_page():
    # Create an instance of Parser class
    with Parser("./sample.pdf") as parser:
        # Get document info to check page count
        info = parser.get_document_info()
        
        if info.page_count > 0:
            # Extract text from the first page (page index is 0-based)
            text_reader = parser.get_text(0)
            
            if text_reader is not None:
                print(text_reader)

if __name__ == "__main__":
    extract_text_from_specific_page()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/quick-start/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Check Format Support

Before processing a document, you can check if the format is supported:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def check_format_support():
    # Check if file format is supported
    if Parser.get_file_info("./sample.pdf").file_type.file_format != "Unknown":
        print("Format is supported")
        
        # Process the document
        with Parser("./sample.pdf") as parser:
            text_reader = parser.get_text()
            if text_reader is not None:
                print(text_reader)
    else:
        print("Format is not supported")

if __name__ == "__main__":
    check_format_support()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/quick-start/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Next Steps

Now that you've learned the basics, explore more advanced features:

- [Extract text from documents]({{< ref "parser/python-net/developer-guide/basic-usage/extract-text-from-documents" >}}) - Learn different text extraction techniques
- [Working with images]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images" >}}) - Advanced image extraction
- [Working with tables]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-tables" >}}) - Extract tables from documents
- [Template-based parsing]({{< ref "parser/python-net/developer-guide/advanced-usage/template-based-parsing" >}}) - Parse structured data using templates

## Additional Resources

- [Supported Document Formats]({{< ref "parser/python-net/supported-document-formats" >}})
- [System Requirements]({{< ref "parser/python-net/system-requirements" >}})
- [Licensing]({{< ref "parser/python-net/licensing-and-evaluation-limitations" >}})
- [API Reference](https://reference.groupdocs.com/parser/python-net)

---

## Quick Start Guide

Path: /signature/python-net/getting-started/quick-start-guide/


This guide provides a quick overview of how to set up and start using GroupDocs.Signature for Python via .NET. This library enables developers to sing documents various file formats (e.g., DOCX, PDF, PNG) with minimal configuration.

## Prerequisites

To proceed, make sure you have:

1. **Configured** environment as described in the [System Requirements]({{< ref "signature/python-net/system-requirements" >}}) topic.
2. **Optionally** you may [Get a Temporary License](https://purchase.groupdocs.com/temporary-license/) to test all the product features. 

## Set Up Your Development Environment

For best practices, use a virtual environment to manage dependencies in Python applications. Learn more about virtual environment at [Create and Use Virtual Environments](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#create-and-use-virtual-environments) documentation topic.

### Create and Activate a Virtual Environment

Create a virtual environment:

{{< tabs "example1">}}
{{< tab "Windows" >}}
```ps
py -m venv .venv
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m venv .venv
```
{{< /tab >}}
{{< /tabs >}}

Activate a virtual environment:

{{< tabs "example2">}}
{{< tab "Windows" >}}
```ps
.venv\Scripts\activate
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
source .venv/bin/activate
```
{{< /tab >}}
{{< /tabs >}}

### Install `groupdocs-signature-net` Package

After activating the virtual environment, run the following command in your terminal to install the latest version of the package:

{{< tabs "example3">}}
{{< tab "Windows" >}}
```ps
py -m pip install groupdocs-signature-net
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m pip install groupdocs-signature-net
```
{{< /tab >}}
{{< /tabs >}}

Ensure the package is installed successfully. You should see the message 

```bash
Successfully installed groupdocs-signature-net-*
```

## Example "Hello, world!"

To quickly test the library, let’s sing a PDF file with text signature. You can also download the app that we're going to buid [here](/signature/python-net/_sample_files/getting-started/quick-start-guide/sign_pdf_with_text_signature.zip).

{{< tabs "sign_pdf_with_text_signature">}}
{{< tab "sign_pdf.py" >}}  
```python
import groupdocs.signature as gs 
import groupdocs.signature.options as gso 
import sys 
import os

def sign_pdf_with_text_signature():
   
    license = gs.License()
    license.set_license("./GroupDocs.Signature.PythonViaNET.lic")
    
    # The path to the file.
    sample_pdf = "./sample.pdf"

    file_name = os.path.basename("./signed_sample_pdf")

    # The path to the output directory.
    output_directory = "./out"

    if not os.path.exists(output_directory):
        os.makedirs(output_directory)

    output_file_path = os.path.join(output_directory, file_name)

    # Sign document with text signature.
    with gs.Signature(sample_pdf) as signature:
        text_sign_options = gso.TextSignOptions("Hello world!")
        signature.sign(output_file_path, text_sign_options)

    print(f"\nSource document signed successfully.\nFile saved at {output_file_path}")

if __name__ == "__main__":
    sign_pdf_with_text_signature()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}  
{{< tab-text >}}
`sample.pdf` is sample file used in this example. Click [here](/signature/python-net/_sample_files/getting-started/quick-start-guide/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "signed_sample.pdf" >}}  
{{< tab-text >}}
`signed_sample.pdf` is expected output PDF file. Click [here](/signature/python-net/_sample_files/getting-started/quick-start-guide/signed_sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 demo-app
 ├──hello_world.py
 ├──sample.pdf
 └──GroupDocs.Signature.PythonViaNET.lic (Optionally)
```

### Run the App

{{< tabs "run-the-app">}}
{{< tab "Windows" >}}
```ps
py hello_world.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 hello_world.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation

- `gs.License()`: Creates a license object for the GroupDocs.Signature library.
- `license.set_license("./GroupDocs.Signature.PythonViaNET.lic")`: Applies the license to avoid evaluation limitations.
- `sample_pdf = "./sample.pdf"`: Defines the path to the input PDF document.
- `output_directory = "./out"`: Specifies the directory where the signed file will be saved.
- `os.makedirs(output_directory)`: Creates the output directory if it doesn't exist.
- `gs.Signature(sample_pdf)`: Loads the input PDF file for signing.
- `gso.TextSignOptions("Hello world!")`: Creates text signature options with the specified signature text.
- `signature.sign(output_file_path, text_sign_options)`: Applies the text signature and saves the signed PDF to the output path.
- `print(...)`: Prints a confirmation message with the path to the signed document.

## Next Steps

After completing the basics, explore additional resources to enhance your usage:
- [Supported File Formats]({{< ref "signature/python-net/supported-file-formats" >}}): Review the full list of supported file types.
- [Licensing]({{< ref "signature/python-net/licensing" >}}): Check details on licening and evaluation.
- [Technical Support]({{< ref "signature/python-net/technical-support" >}}): Contact support for assistance if you encounter issues.

---

## Rasterize document or page

Path: /watermark/java/rasterize-document-or-page/

## How to remove a watermark from a pdf 
The watermark can be removed from the PDF documents using third-party tools. However, if you want to get a watermark that is almost impossible to remove, you can consider PDF document rasterization. GroupDocs.Watermark provides the feature to convert all the pages of a PDF document to raster images with only one line of code.

## Rasterize PDF document

Following code snippet is used to [rasterize](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfContent#rasterize(int,%20int,%20int)) the PDF document to protect added watermarks.  

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRasterizeDocument**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
// Initialize image or text watermark                                                                    
TextWatermark watermark = new TextWatermark("Do not copy", new Font("Arial", 8));                        
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                            
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                
watermark.setRotateAngle(45);                                                                            
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                             
watermark.setScaleFactor(1);                                                                             
watermark.setOpacity(0.5);                                                                               
                                                                                                         
// Add watermark of any type first                                                                       
watermarker.add(watermark);                                                                              
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
// Rasterize all pages                                                                                   
pdfContent.rasterize(100, 100, PdfImageConversionFormat.Png);                                            
                                                                                                         
// Content of all pages is replaced with raster images                                                   
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

{{< alert style="warning" >}}You can't restore document content after saving the document. Rasterization significantly increases the size of the resultant PDF file.{{< /alert >}}

## Rasterize particular page of the PDF document

The API also allows you to [rasterize](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfPage#rasterize(int,%20int,%20int)) any particular page of the PDF document. Following code snippet is used to rasterize a page of the PDF document.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRasterizePage**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
// Initialize image or text watermark                                                                    
TextWatermark watermark = new TextWatermark("Do not copy", new Font("Arial", 8));                        
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                            
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                
watermark.setRotateAngle(45);                                                                            
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                             
watermark.setScaleFactor(1);                                                                             
watermark.setOpacity(0.5);                                                                               
                                                                                                         
// Add watermark of any type first                                                                       
PdfArtifactWatermarkOptions options = new PdfArtifactWatermarkOptions();                                 
options.setPageIndex(0);                                                                                 
watermarker.add(watermark, options);                                                                     
                                                                                                         
// Rasterize the first page                                                                              
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
pdfContent.getPages().get_Item(0).rasterize(100, 100, PdfImageConversionFormat.Png);                     
                                                                                                         
// Content of the first page is replaced with raster image                                               
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

---

## Remove annotation replies

Path: /annotation/net/remove-annotation-replies/

You can remove specific or all replies using the [GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) API. To do this, remove the appropriate items from the [List<T>](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1) collection. 

To delete an annotation reply (replies), follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Call the [Get](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/get) method of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class to get collection of document annotations.
3.   Access the appropriate annotation and remove a reply in a suitable way:
    *   call the [RemoveAt(Int32)](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1.removeat) or [Remove(T)](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1.remove) method to remove specific reply;
    *   call the [RemoveAll(Predicate<T>)](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1.removeall) method to remove all replies that match the conditions defined by the  predicate.
4.   Call the [Update](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/update/index) method of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the annotations collection.
5.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.
    

## Remove specific annotation reply 

The following code snippet shows how to remove annotation reply by its index:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
// NOTE: Input document already contain annotations with replies
using (Annotator annotator = new Annotator("result.pdf"))
{
    // Obtain annotations collection from document
    List<AnnotationBase> annotations = annotator.Get();               
	// Remove first reply 
	annotations[0].Replies.RemoveAt(0);
	// Save changes
	annotator.Update(annotations);
	annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

## Remove annotation replies by criteria

The following code snippet shows how to remove replies that match some criteria:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
// NOTE: Input document already contain annotations with replies
using (Annotator annotator = new Annotator("annotated_file_with_replies.pdf"))
{
    // Obtain annotations collection from document
    List<AnnotationBase> annotations = annotator.Get();
    // Remove all replies where author name is "Tom"
    annotations[0].Replies.RemoveAll(x => x.User.Name == "Tom");
    // Save changes
    annotator.Update(annotations);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Remove form fields

Path: /viewer/java/optimization-pdf-remove-fields/

If the output PDF file contains form fields, you can flatten them to reduce the file size.

To remove form fields, set the `setRemoveFormFields()` property to `true` in [PdfOptimizationOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/).

The following code snippet shows how to flatten form fields in the file:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setPdfOptimizationOptions(new PdfOptimizationOptions());
    viewOptions.getPdfOptimizationOptions().setRemoveFormFields(true);
     
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}

The following image demonstrates the result:

![Remove fields](/viewer/java/images/pdf-rendering/optimization/optimization-pdf-remove-fields.png)
---

## Remove form fields

Path: /viewer/net/optimization-pdf-remove-fields/

If the output PDF file contains form fields, you can flatten them to reduce the file size.

To remove form fields, set the [RemoveFormFields](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/removeformfields) property to `true`.

The following code snippet shows how to flatten form fields in the file:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions
    {
        RemoveFormFields = true
    };
     
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions With {
                .RemoveFormFields = True
                }

            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Remove fields](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-remove-fields.png)
---

## Remove form fields

Path: /viewer/python-net/optimization-pdf-remove-fields/

If the output PDF file contains form fields, you can flatten them to reduce the file size.

To remove form fields, set the [remove_form_fields](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property to `True`.

The following code snippet shows how to flatten form fields in the file:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def remove_form_fields():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("remove_form_fields/without_form_fields.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.remove_form_fields = True

        viewer.view(viewOptions)

if __name__ == "__main__":
    remove_form_fields()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimize-content/optimization-pdf-remove-fields/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Remove fields](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-remove-fields.png)
---

## Remove pages

Path: /merger/java/remove-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) provides an ability to remove single page or a collection of specific page numbers from the source document.   
Here are the steps to remove document page(s):

*   Initialise [RemoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RemoveOptions) class with page numbers to remove;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or stream;
*   Call [removePages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#removePages(com.groupdocs.merger.domain.options.interfaces.IRemoveOptions)) method and pass [RemoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RemoveOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates how to remove document pages:

```java
String filePath = "c:\sample.one";
String filePathOut = "c:\output\result.one";

RRemoveOptions removeOptions = new RemoveOptions(new int[] { 3, 5 });

Merger merger = new Merger(filePath);

merger.removePages(removeOptions);
merger.save(filePathOut);

```

---

## Remove pages

Path: /merger/net/remove-pages/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides an ability to remove single page or a collection of specific page numbers from the source document.   
Here are the steps to remove document page(s):

*   Initialise [RemoveOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/removeoptions) class with page numbers to remove;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [RemovePages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/removepages) method and pass [RemoveOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/removeoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and pass desired file path to save resultant document.

The following code sample demonstrates how to remove document pages:

```csharp
string filePath = @"c:\sample.one";
string filePathOut = @"c:\output\result.one";

RemoveOptions removeOptions = new RemoveOptions(new int[] { 3, 5 });

using (Merger merger = new Merger(filePath))
{
    merger.RemovePages(removeOptions);
    merger.Save(filePathOut);
}

```

---

## Remove pages

Path: /merger/nodejs-java/remove-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) provides an ability to remove single page or a collection of specific page numbers from the source document.   
Here are the steps to remove document page(s):

*   Initialise [RemoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RemoveOptions) class with page numbers to remove;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or stream;
*   Call [removePages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#removePages(com.groupdocs.merger.domain.options.interfaces.IRemoveOptions)) method and pass [RemoveOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RemoveOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates how to remove document pages:

```js
const inputFilePath = `c:/sample.one`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output/result.one`;
const removeOptions = new groupdocs.merger.RemoveOptions(1, 2);
merger.removePages(removeOptions);
merger.save(outputPath);
```

---

## Remove pages

Path: /merger/python-net/remove-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) provides an ability to remove single page or a collection of specific page numbers from the source document.   
Here are the steps to remove document page(s):

*   Initialise [RemoveOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/RemoveOptions) class with page numbers to remove;
*   Instantiate [Merger](https://reference.groupdocs.com/net/merger/groupdocs.merger/Merger) object with source document path or stream;
*   Call [removePages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/removepages/) method and pass [RemoveOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/RemoveOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and pass desired file path to save resultant document.

The following code sample demonstrates how to remove document pages:

```python
with gm.Merger("c:/sample.one") as merger:
    remove_options = gm.domain.options.RemoveOptions(1, 2)
    merger.remove_pages(remove_options)
    merger.save("c:/result.one")
```

---

## Removing found watermarks

Path: /watermark/java/removing-found-watermarks/

## Remove watermark

GroupDocs.Watermark API enables you to easily find and remove a particular [watermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/PossibleWatermark) from a document. Following code serves this purpose.

**advanced\_usage.searching\_and\_modifying\_watermarks.RemoveWatermark**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
PossibleWatermarkCollection possibleWatermarks = watermarker.search();                                   
                                                                                                         
// Remove possible watermark at the specified index from the document.                                   
possibleWatermarks.removeAt(0);                                                                          
                                                                                                         
// Remove specified possible watermark from the document.                                                
possibleWatermarks.remove(possibleWatermarks.get_Item(0));                                               
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

## Remove watermark with particular text formatting

GroupDocs.Watermark also enables you to search and remove the watermarks on the basis of some particular [text formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextFormattingSearchCriteria). You can provide a search criterion containing [font name](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextFormattingSearchCriteria#setFontName(java.lang.String)), size, [color](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextFormattingSearchCriteria#setForegroundColorRange(com.groupdocs.watermark.search.ColorRange)) etc and the API will find the watermarks with matching properties. Following code snippet shows how to search and remove watermarks with a particular text formatting.

**advanced\_usage.searching\_and\_modifying\_watermarks.RemoveWatermarkWithParticularTextFormatting**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
TextFormattingSearchCriteria criteria = new TextFormattingSearchCriteria();                              
criteria.setForegroundColorRange(new ColorRange());                                                      
criteria.getForegroundColorRange().setMinHue(-5);                                                        
criteria.getForegroundColorRange().setMaxHue(10);                                                        
criteria.getForegroundColorRange().setMinBrightness(0.01f);                                              
criteria.getForegroundColorRange().setMaxBrightness(0.99f);                                              
criteria.setBackgroundColorRange(new ColorRange());                                                      
criteria.getBackgroundColorRange().setEmpty(true);                                                       
criteria.setFontName("Arial");                                                                           
criteria.setMinFontSize(19);                                                                             
criteria.setMaxFontSize(42);                                                                             
criteria.setFontBold(true);                                                                              
                                                                                                         
PossibleWatermarkCollection watermarks = watermarker.search(criteria);                                   
watermarks.clear();                                                                                      
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

## Remove hyperlink watermarks 

GroupDocs.Watermark API allows you to search and remove [hyperlinks](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/HyperlinkPossibleWatermark) in a document of any supported format. Following code sample shows how to find and remove hyperlinks with a particular URL from a document.

**advanced\_usage.searching\_and\_modifying\_watermarks.RemoveHyperlinksWithParticularUrl**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"             
Watermarker watermarker = new Watermarker("document.pdf");                                                   
                                                                                                                      
PossibleWatermarkCollection watermarks = watermarker.search(new TextSearchCriteria(Pattern.compile("someurl\\.com")));
for (int i = watermarks.getCount() - 1; i >= 0; i--)                                                                  
{                                                                                                                     
    // Ensure that only hyperlinks will be removed.                                                                   
    if (HyperlinkPossibleWatermark.class.isInstance(watermarks.get_Item(i)))                                          
    {                                                                                                                 
        // Output the full url of the hyperlink                                                                       
        System.out.println(watermarks.get_Item(i).getText());                                                         
                                                                                                                      
        // Remove hyperlink from the document                                                                         
        watermarks.removeAt(i);                                                                                       
    }                                                                                                                 
}                                                                                                                     
                                                                                                                      
watermarker.save("document.pdf");                                                                           
                                                                                                                      
watermarker.close();                                                                                                  
```


---

## Render PDF documents as HTML and image files

Path: /viewer/java/render-pdf-documents/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your PDF files in HTML, PNG, and JPEG formats. Use this library to implement a simple PDF viewer within your Java application (web or desktop).

Create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance to get started with the GroupDocs.Viewer API. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/pdf" >}} {{< icon "gdoc_person" >}} View PDF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Page Layout file formats

GroupDocs.Viewer supports the following PDF and Page Layout file formats:

* [Portable Document Format](https://docs.fileformat.com/pdf/) (.PDF)
* [Microsoft XML Paper Specification](https://docs.fileformat.com/page-description-language/xps/) (.XPS)
* [Open XML Paper Specification](https://docs.fileformat.com/page-description-language/oxps/) (.OXPS)
* [LaTeX Source Document](https://docs.fileformat.com/page-description-language/tex/) (.TEX)

## Render PDF files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a PDF file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create an HTML files.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to HTML](/viewer/java/images/rendering-basics/render-pdf-documents/render-pdf-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
   // Create an HTML file for each PDF page.
   // Specify the HTML file names and location of external resources.
   // {0} and {1} are replaced with the current page number and resource name, respectively.
   HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-pdf-documents/render-to-html-external-resources.png)

### Create HTML with fixed layout

By default, PDF and EPUB documents are rendered to HTML with fixed layout to ensure that the output HTML looks the same as a source document. Rendering to fixed layout means that all the HTML elements are absolutely positioned to the container element. And container element has a fixed size so browser window resizing will not have an effect on the position and size of elements in a document.

The following image demonstrates PDF document rendered HTML with fixed layout:

![Create HTML with fixed layout](/viewer/java/images/rendering-basics/render-pdf-documents/render-pdf-to-html-with-fixed-layout.png)


### Adjust image quality in the output HTML file

The [HtmlviewOptions.getPdfOptions().setImageQuality()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setImageQuality-com.groupdocs.viewer.options.ImageQuality-) methods allows you to specify the quality of images in the output HTML file. You can set this property to one of the following values:

* [ImageQuality.LOW](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/imagequality/#LOW) --- The image resolution is low (96 DPI), and the image size is small. Use this value to increase the conversion performance.
* [ImageQuality.MEDIUM](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/imagequality/#MEDIUM) --- The image resolution is medium (192 DPI), and the image size is larger compared to the low quality images.
* [ImageQuality.HIGH](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/imagequality/#HIGH) --- The image resolution is high (300 DPI), and the image size is big. Use of this value may decrease the conversion performance.

The following code snippet shows how to set the medium image quality when rendering a PDF document to HTML:

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create an HTML files.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    // Set image quality to medium.
    viewOptions.getPdfOptions().setImageQuality(ImageQuality.MEDIUM);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Render text as an image

GroupDocs.Viewer supports the [HtmlViewOptions.getPdfOptions().setRenderTextAsImage](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setRenderTextAsImage-boolean-) option that allows you to render text as an image when you convert a PDF file to HTML. In this case, the layout of the output HTML file closely mirrors the layout of the source PDF document.

The following code snippet shows how to enable this option in code:

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create an HTML files.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("text-as-image_{0}.html");
    // Enable rendering text as image.
    viewOptions.getPdfOptions().setRenderTextAsImage(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result. PDF content is exported to HTML as an image, so users cannot select or copy document text.  

![Render PDF content as an image in the output HTML file](/viewer/java/images/rendering-basics/render-pdf-documents/render-pdf-to-html-as-image.png)

### Enable multi-layer rendering

When you convert a PDF file to HTML, GroupDocs.Viewer creates an HTML document with a single layer (the `z-index` is not specified for document elements). This helps increase performance and reduce the output file size. If you convert a PDF document with multiple layers and want to improve the position of document elements in the output HTML file, use the [HtmlViewOptions.getPdfOptions().setEnableLayeredRendering](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setEnableLayeredRendering-boolean-) method to render text and graphics in the HTML file according to their z-order in the source PDF document.

The following code snippet shows how to enable the multi-layer rendering:

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create an HTML files.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    // Enable the multi-layer rendering.
    viewOptions.getPdfOptions().setEnableLayeredRendering(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render PDF files as images

### Convert PDF files to PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a PDF file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to PNG](/viewer/java/images/rendering-basics/render-pdf-documents/render-pdf-to-png.png)

### Convert PDF files to JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a PDF file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create a JPG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Preserve the size of document pages

When you render PDF documents as images, GroupDocs.Viewer calculates the optimal image size to achieve better rendering quality. If you want the generated images to be the same size as pages in the source PDF document, use the [PdfOptions.setRenderOriginalPageSize](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setRenderOriginalPageSize-boolean-) method of the [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) or [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class (depending on the output image format).

{{< tabs "example9">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Preserve the size of document pages.
    viewOptions.getPdfOptions().setRenderOriginalPageSize(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Enable font hinting

To adjust the display of outline fonts when you convert PDF documents to PNG or JPEG, use the [PdfOptions.setEnableFontHinting](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setEnableFontHinting-boolean-) method, as shown below:

{{< tabs "example10">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Enable font hinting
    viewOptions.getPdfOptions().setEnableFontHinting(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

Refer to the following article for more information on font hinting: [Font hinting](https://en.wikipedia.org/wiki/Font_hinting).

## Disable character grouping

When you render PDF files in other formats, GroupDocs.Viewer groups individual characters into words to improve rendering performance. If your document contains hieroglyphic or special symbols, you may need to disable character grouping to generate a more precise layout. To do this, use the [PdfOptions.setDisableCharsGrouping](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setDisableCharsGrouping-boolean-) method, as shown below:

{{< tabs "example11">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Disable character grouping.
    viewOptions.getPdfOptions().setDisableCharsGrouping(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render text comments

Use the [ViewOptions.setRenderComments](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderComments-boolean-) method for a target view to display textual annotations (such as text comments, sticky notes, text boxes and callouts) in the output HTML, PNG, or JPEG files.

The code example below renders a PDF file with text comments as an image.

{{< tabs "example12">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("resume.pdf")) {
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Enable rendering comments.
    viewOptions.setRenderComments(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render PDF comments to PNG](/viewer/java/images/rendering-basics/render-pdf-documents/render-pdf-comments.png)

## Get information about a PDF file

Follow the steps below to obtain information about a PDF file (the number of pages, page size, and printing permissions): 

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [PdfViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/pdfviewinfo) type.
3. Use the `PdfViewInfo` class properties to retrieve document-specific information.

{{< tabs "example13">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.PdfViewInfo;
// ...

ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
PdfViewInfo viewInfo;
try (Viewer viewer = new Viewer("resume.pdf")) {
    viewInfo = (PdfViewInfo) viewer.getViewInfo(viewInfoOptions);
}
// Display information about the PDF document.
System.out.println("File type: " + viewInfo.getFileType());
System.out.println("The number of pages: " + viewInfo.getPages().size());
System.out.println("Is printing allowed: " + viewInfo.isPrintingAllowed());
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a PDF file](/viewer/java/images/rendering-basics/render-pdf-documents/retrieve-pdf-file-information.png)

### Extract text from a PDF file

Use the [ViewInfoOptions.setExtractText](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions/#setExtractText-boolean-) method to enable PDF text extraction. Use the [PdfViewInfo.getPages](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/#getPages--) methods to obtain the list of all document pages, and use the ([Page.getLines](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/page/#getLines--)) method to retrieve text for each line.

{{< tabs "example14">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.Line;
import com.groupdocs.viewer.results.Page;
import com.groupdocs.viewer.results.PdfViewInfo;
// ...

try (Viewer viewer = new Viewer("sample.pdf")) {
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
    viewInfoOptions.setExtractText(true);
    PdfViewInfo viewInfo = (PdfViewInfo) viewer.getViewInfo(viewInfoOptions);

    // Retrieve text from the PDF file.
    System.out.println("Extracted document text:");
    for (Page page : viewInfo.getPages()) {
        for (Line line : page.getLines()) {
            System.out.println(line.getValue());
        }
    }
}
```
{{< /tab >}}
{{< /tabs >}}

![Extract and display PDF text](/viewer/java/images/rendering-basics/render-pdf-documents/extract-pdf-text.png)

## Skip font license verification when rendering XPS and OXPS files

If an XPS or OXPS file contains a font that cannot be embedded due to licensing restrictions, GroupDocs.Viewer throws an exception at runtime. If you have a license for this font, enable the [PdfOptions#setDisableFontLicenseVerifications(true)](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setDisableFontLicenseVerifications-boolean-) option to skip font license verification.

{{< tabs "example15">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("resume.oxps")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewOptions.getPdfOptions().setDisableFontLicenseVerifications(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
Viewer("resume.oxps").use { viewer ->
   val viewOptions = HtmlViewOptions.forEmbeddedResources()
   viewOptions.pdfOptions.disableFontLicenseVerifications = true
   viewer.view(viewOptions)
}

```
{{< /tab >}}
{{< /tabs >}}

## Enclose images in SVG when rendering PDF and Page Layout files

By default, when rendering to the PDF and Page Layout file formats, all images are combined into a single PNG file, which serves as the background for the output HTML document.

The [PdfOptions#setWrapImagesInSvg(...)](https://reference2.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setWrapImagesInSvg-boolean-) option allows you to wrap each image in the output HTML document with an SVG tag to improve output quality.

This option is available when rendering PDF and Page Layout file formats to HTML with embedded or external resources. 

{{< tabs "example16">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("resume.pdf")) {
   HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
   viewOptions.getPdfOptions().setWrapImagesInSvg(true);

   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
Viewer("resume.pdf").use { viewer ->
    val viewOptions = HtmlViewOptions.forEmbeddedResources()
    viewOptions.pdfOptions.isWrapImagesInSvg = true
    viewer.view(viewOptions)
}

```
{{< /tab >}}
{{< /tabs >}}

The following image shows the rendering [resume.pdf](/viewer/java/images/rendering-basics/render-pdf-documents/resume.pdf) with the disabled (left) and enabled (right) `WrapImagesInSvg` option:

![Images as background vs embedded in SVG](/viewer/java/images/rendering-basics/render-pdf-documents/wrap-images-in-svg.png)

## Disable copy protection

When rendering PDF files with protection against copying text and images to HTML, GroupDocs.Viewer adds an `inert` HTML attribute to the HTML `<body>` tag.

Use [PdfOptions.setDisableCopyProtection()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptions/#setDisableCopyProtection-boolean-) to turn off copy protection. When `DisableCopyProtection` is set to `true`, the `inert` HTML attribute won't be added to the HTML `<body>` tag in any case.

{{< alert style="info" >}}

This option was added in GroupDocs.Viewer for Java 24.6. Previous versions of GroupDocs.Viewer for Java ignores PDF copy protection and does not add `inert` HTML attribute to HTML `<body>` tag.   

{{< /alert >}}

This option is supported when rendering PDF files to HTML with embedded or external resources. 

{{< tabs "example17">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("protected-resume.pdf")) {
   HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
   viewOptions.getPdfOptions().setDisableCopyProtection(true);

   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
Viewer("protected-resume.pdf").use { viewer ->
    val viewOptions = HtmlViewOptions.forEmbeddedResources()
    viewOptions.pdfOptions.isDisableCopyProtection = true
    viewer.view(viewOptions)
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows the rendering of [protected-resume.pdf](/viewer/java/images/rendering-basics/render-pdf-documents/protected-resume.pdf) with copy protection on the left and with with `DisableCopyProtection` option set to `true` on the right:

![Render with or without copy protection](/viewer/java/images/rendering-basics/render-pdf-documents/render-with-and-without-copy-protection.png)

## Repairing corrupted PDF documents

By default GroupDocs.Viewer cannot process the PDF documents with corrupted structure or content — it throws an exception when trying to open such files. However, starting from the version [24.10](https://releases.groupdocs.com/viewer/java/release-notes/2024/groupdocs-viewer-for-java-24-10-release-notes/) GroupDocs.Viewer can try to repair the structural corruptions in PDF documents. By default this feature is disabled. To enable it, need to use the newly added `TryRepair` boolean property of the [`LoadOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/) class by setting its value to `true`.

When enabled, this feature addresses the following issues in a PDF document:

* Broken references within the document (incorrect object offsets in the Cross-reference list).
* Missing critical elements like root object, page object, or page content.
* Circular references (Form X-object referencing itself).

Here is a source code sample:

{{< tabs "example18">}}
{{< tab "Java" >}}
```java
LoadOptions loadOptions = new LoadOptions();
loadOptions.setTryRepair(true);

try (Viewer viewer = new Viewer("resume.pdf", loadOptions)) {
   PngViewOptions viewOptions = new PngViewOptions();

   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
val loadOptions = LoadOptions().apply {
    tryRepair = true
}

Viewer("resume.pdf", loadOptions).use { viewer ->
    val viewOptions = PngViewOptions()
    viewer.view(viewOptions)
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Render PDF documents as HTML and image files

Path: /viewer/net/render-pdf-documents/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your PDF files in HTML, PNG, and JPEG formats. Use this library to implement a simple PDF viewer within your .NET application (web or desktop).

Create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance to get started with the GroupDocs.Viewer API. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to HTML or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/pdf" >}} {{< icon "gdoc_person" >}} View PDF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Page Layout file formats

GroupDocs.Viewer supports the following PDF and Page Layout file formats:

* [Portable Document Format](https://docs.fileformat.com/pdf/) (.PDF)
* [Microsoft XML Paper Specification](https://docs.fileformat.com/page-description-language/xps/) (.XPS)
* [Open XML Paper Specification](https://docs.fileformat.com/page-description-language/oxps/) (.OXPS)
* [LaTeX Source Document](https://docs.fileformat.com/page-description-language/tex/) (.TEX)
* [Open Fixed-layout Document](https://www.zhihuilib.com/en/article/detail/2/12) (.OFD)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render PDF files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a PDF file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).


### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create an HTML file for each PDF page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create an HTML file for each PDF page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to HTML](/viewer/net/images/rendering-basics/render-pdf-documents/render-pdf-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create an HTML file for each PDF page.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create an HTML file for each PDF page.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-pdf-documents/render-to-html-external-resources.png)

### Create HTML with fixed layout

By default, PDF and EPUB documents are rendered to HTML with fixed layout to ensure that the output HTML looks the same as a source document. Rendering to fixed layout means that all the HTML elements are absolutely positioned to the container element. And container element has a fixed size so browser window resizing won't have an effect on the position and size of elements in a document.

The following image demonstrates PDF document rendered HTML with fixed layout:

![Create HTML with fixed layout](/viewer/net/images/rendering-basics/render-pdf-documents/render-pdf-to-html-with-fixed-layout.png)

### Create HTML with fluid layout

When rendering to HTML with fluid layout HTML document doesn't have a fixed size. In case you resize a browser window the document content tries to fit into it. To create HTML with fluid layout set [PdfOptions.FixedLayout](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptions/fixedlayout/) property to `false`. 

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Letter.pdf"))
{
    // Create an HTML file for each PDF page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Disable fixed layout.
    viewOptions.PdfOptions.FixedLayout = false;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Letter.pdf")
            ' Create an HTML file for each PDF page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Disable fixed layout.
            viewOptions.PdfOptions.FixedLayout = False
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}

When rendering PDF and EPUB documents to HTML with a fluid layout all the graphic content such as images are ignored.

{{< /alert >}}

The following image demonstrates the result:

![Create HTML with fluid layout](/viewer/net/images/rendering-basics/render-pdf-documents/render-pdf-to-html-with-fluid-layout.png)

### Adjust image quality in the output HTML file

The [HtmlViewOptions.PdfOptions.ImageQuality](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfoptions/properties/imagequality) option allows you to specify the quality of images in the output HTML file. You can set this property to one of the following values:

* [ImageQuality.Low](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/imagequality) --- The image resolution is low (96 DPI), and the image size is small. Use this value to increase the conversion performance.
* [ImageQuality.Medium](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/imagequality) --- The image resolution is medium (192 DPI), and the image size is larger compared to the low quality images.
* [ImageQuality.High](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/imagequality) --- The image resolution is high (300 DPI), and the image size is big. Use of this value may decrease the conversion performance.

The following code snippet shows how to set the medium image quality when rendering a PDF document to HTML:

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Set image quality to medium.
    viewOptions.PdfOptions.ImageQuality = ImageQuality.Medium;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create an HTML file for each document page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Set image quality to medium.
            viewOptions.PdfOptions.ImageQuality = ImageQuality.Medium
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Render text as an image

GroupDocs.Viewer supports the [HtmlViewOptions.PdfOptions.RenderTextAsImage](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptions/properties/rendertextasimage) option that allows you to render text as an image when you convert a PDF file to HTML. In this case, the layout of the output HTML file closely mirrors the layout of the source PDF document.

The following code snippet shows how to enable this option in code:

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("text-as-image_{0}.html");
    // Enable rendering text as image.
    viewOptions.PdfOptions.RenderTextAsImage = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create an HTML file for each document page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("text-as-image_{0}.html")
            ' Enable rendering text as image.
            viewOptions.PdfOptions.RenderTextAsImage = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result. PDF content is exported to HTML as an image, so users cannot select or copy document text.  

![Render PDF content as an image in the output HTML file](/viewer/net/images/rendering-basics/render-pdf-documents/render-pdf-to-html-as-image.png)

### Enable multi-layer rendering

When you convert a PDF file to HTML, GroupDocs.Viewer creates an HTML document with a single layer (the `z-index` is not specified for document elements). This helps increase performance and reduce the output file size. If you convert a PDF document with multiple layers and want to improve the position of document elements in the output HTML file, activate the [HtmlViewOptions.PdfOptions.EnableLayeredRendering](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfoptions/properties/enablelayeredrendering) property to render text and graphics in the HTML file according to their z-order in the source PDF document.

The following code snippet shows how to enable the multi-layer rendering:

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pdf"))
{
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Enable the multi-layer rendering.
    viewOptions.PdfOptions.EnableLayeredRendering = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pdf")
            ' Create an HTML file for each document page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Enable the multi-layer rendering.
            viewOptions.PdfOptions.EnableLayeredRendering = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render PDF files as images

### Convert PDF files to PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a PDF file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create a PNG image for each PDF page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to PNG](/viewer/net/images/rendering-basics/render-pdf-documents/render-pdf-to-png.png)

### Convert PDF files to JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a PDF file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create a JPEG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create a JPEG image for each PDF page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Preserve the size of document pages

When you render PDF documents as images, GroupDocs.Viewer calculates the optimal image size to achieve better rendering quality. If you want the generated images to be the same size as pages in the source PDF document, enable the [PdfOptions.RenderOriginalPageSize](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfoptions/properties/renderoriginalpagesize) property for the [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) or [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class (depending on the output image format).

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Preserve the size of document pages.
    viewOptions.PdfOptions.RenderOriginalPageSize = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create a PNG image for each PDF page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Preserve the size of document pages.
            viewOptions.PdfOptions.RenderOriginalPageSize = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Enable font hinting

To adjust the display of outline fonts when you convert PDF documents to PNG or JPEG, activate the [PdfOptions.EnableFontHinting](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfoptions/properties/enablefonthinting) option, as shown below:

{{< tabs "example10">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    //Enable font hinting
    viewOptions.PdfOptions.EnableFontHinting = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            ' Create a PNG image for each PDF page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            'Enable font hinting
            viewOptions.PdfOptions.EnableFontHinting = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

Refer to the following article for more information on font hinting: [Font hinting](https://en.wikipedia.org/wiki/Font_hinting).

## Disable character grouping

When you render PDF files in other formats, GroupDocs.Viewer groups individual characters into words to improve rendering performance. If your document contains hieroglyphic or special symbols, you may need to disable character grouping to generate a more precise layout. To do this, use the [PdfOptions.DisableCharsGrouping](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfoptions/properties/disablecharsgrouping) option, as shown below:

{{< tabs "example11">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pdf"))
{
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Disable character grouping
    viewOptions.PdfOptions.DisableCharsGrouping = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pdf")
            ' Create an HTML file for each document page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Disable character grouping
            viewOptions.PdfOptions.DisableCharsGrouping = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render text comments

Enable the [ViewOptions.RenderComments](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/rendercomments) option for a target view to display textual annotations (such as text comments, sticky notes, text boxes and callouts) in the output HTML, PNG, or JPEG files.

The code example below renders a PDF file with text comments as an image.

{{< tabs "example12">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("resume_commented.pdf"))
{
    // Create a PNG image for each PDF page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Enable comments rendering.
    viewOptions.RenderComments = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume_commented.pdf")
            ' Create a PNG image for each PDF page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Enable comments rendering.
            viewOptions.RenderComments = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render PDF comments to PNG](/viewer/net/images/rendering-basics/render-pdf-documents/render-pdf-comments.png)

## Get information about a PDF file

Follow the steps below to obtain information about a PDF file (the number of pages, page size, and printing permissions): 

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.GetViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getviewinfo) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [PdfViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.results/pdfviewinfo) type.
3. Use the `PdfViewInfo` class properties to retrieve document-specific information.

{{< tabs "example13">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    var viewInfoOptions = ViewInfoOptions.ForHtmlView();
    var viewInfo = viewer.GetViewInfo(viewInfoOptions) as PdfViewInfo;

    // Display information about the PDF document.
    Console.WriteLine($"File type: {viewInfo.FileType}");
    Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}");
    Console.WriteLine($"Is printing allowed: {viewInfo.PrintingAllowed}");
    
    // Display information about all document pages.
    Console.WriteLine("Page information:");
    foreach (Page page in viewInfo.Pages)
    {
        // The Page.ToString method is overriden to display the following page information: 
        // "Page {Number} ({visibility}) {Width}x{Height}px with {Lines.Count} line(s)."
        Console.WriteLine(page);
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            Dim viewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo = TryCast(viewer.GetViewInfo(viewInfoOptions), PdfViewInfo)
        
            ' Display information about the PDF document.
            Console.WriteLine($"File type: {viewInfo.FileType}")
            Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}")
            Console.WriteLine($"Is printing allowed: {viewInfo.PrintingAllowed}")
        
            ' Display information about all document pages.
            Console.WriteLine("Page information:")
            For Each page As Page In viewInfo.Pages
                ' The Page.ToString method is overriden to display the following page information: 
                ' "Page {Number} ({visibility}) {Width}x{Height}px with {Lines.Count} line(s)."
                Console.WriteLine(page)
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a PDF file](/viewer/net/images/rendering-basics/render-pdf-documents/retrieve-pdf-file-information.png)

### Extract text from a PDF file

Set the [ViewInfoOptions.ExtractText](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions/properties/extracttext) property to `true` to enable PDF text extraction. Use the [PdfViewInfo.Pages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/properties/pages) property to obtain the list of all document pages, and iterate through the collection of lines on each page ([Page.Lines](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/page/properties/lines)) to retrieve text for each line.

{{< tabs "example14">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (var viewer = new Viewer("resume.pdf"))
{
    var viewInfoOptions = ViewInfoOptions.ForHtmlView();
    viewInfoOptions.ExtractText = true;
    var viewInfo = viewer.GetViewInfo(viewInfoOptions) as PdfViewInfo;
    
    // Retrieve text from the PDF file.
    Console.WriteLine("Extracted document text:");
    foreach (Page page in viewInfo.Pages)
        foreach (Line line in page.Lines)
        {
            Console.WriteLine(line.Value);
        }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("resume.pdf")
            Dim viewInfoOptions = ViewInfoOptions.ForHtmlView()
            viewInfoOptions.ExtractText = True
            Dim viewInfo = TryCast(viewer.GetViewInfo(viewInfoOptions), PdfViewInfo)
        
            ' Retrieve text from the PDF file.
            Console.WriteLine("Extracted document text:")
            For Each page As Page In viewInfo.Pages
                For Each line As Line In page.Lines
                    Console.WriteLine(line.Value)
                Next
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

![Extract and display PDF text](/viewer/net/images/rendering-basics/render-pdf-documents/extract-pdf-text.png)

## Skip font license verification when rendering XPS and OXPS files

If an XPS or OXPS file contains a font that cannot be embedded due to licensing restrictions, GroupDocs.Viewer throws an exception at runtime. If you have a license for this font, enable the [PdfOptions.DisableFontLicenseVerifications](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptions/disablefontlicenseverifications) option to skip font license verification.

{{< tabs "example15">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("resume.oxps"))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewOptions.PdfOptions.DisableFontLicenseVerifications = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("resume.oxps")
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewOptions.PdfOptions.DisableFontLicenseVerifications = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Enclose images in SVG when rendering PDF and Page Layout files

By default, when rendering to the PDF and Page Layout file formats, all images are combined into a single PNG file, which serves as the background for the output HTML document.

The [PdfOptions.WrapImagesInSvg](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptions/wrapimagesinsvg) option allows you to wrap each image in the output HTML document with an SVG tag to improve output quality.

This option is available when rendering PDF and Page Layout file formats to HTML with embedded or external resources. 

{{< tabs "example16">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("resume.pdf"))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewOptions.PdfOptions.WrapImagesInSvg = true;

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("resume.pdf")
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewOptions.PdfOptions.WrapImagesInSvg = True
        
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows the rendering [resume.pdf](/viewer/net/images/rendering-basics/render-pdf-documents/resume.pdf) with the disabled (left) and enabled (right) `WrapImagesInSvg` option:

![Images as background vs embedded in SVG](/viewer/net/images/rendering-basics/render-pdf-documents/wrap-images-in-svg.png)

## Disable copy protection

When rendering PDF files with protection against copying text and images to HTML, GroupDocs.Viewer adds an `inert` HTML attribute to the HTML `<body>` tag.

Use [PdfOptions.DisableCopyProtection](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptions/disablecopyprotection) to turn off copy protection. When `DisableCopyProtection` is set to `true`, the `inert` HTML attribute won't be added to the HTML `<body>` tag in any case.

{{< alert style="info" >}}

This option was added in GroupDocs.Viewer for .NET 24.4. Previous versions of GroupDocs.Viewer for .NET ignores PDF copy protection and does not add `inert` HTML attribute to HTML `<body>` tag.   

{{< /alert >}}

This option is supported when rendering PDF files to HTML with embedded or external resources. 

{{< tabs "example17">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("protected-resume.pdf"))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewOptions.PdfOptions.DisableCopyProtection = true;

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("protected-resume.pdf")
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewOptions.PdfOptions.DisableCopyProtection = True
        
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows the rendering of [protected-resume.pdf](/viewer/net/images/rendering-basics/render-pdf-documents/protected-resume.pdf) with copy protection on the left and with with `DisableCopyProtection` option set to `true` on the right:

![Render with or without copy protection](/viewer/net/images/rendering-basics/render-pdf-documents/render-with-and-without-copy-protection.png)

## Repairing corrupted PDF documents

By default GroupDocs.Viewer cannot process the PDF documents with corrupted structure or content — it throws an exception when trying to open such files. However, starting from the version [24.5](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-5-release-notes/) GroupDocs.Viewer can try to repair the structural corruptions in PDF documents. By default this feature is disabled. To enable it, need to use the newly added `TryRepair` boolean property of the [`LoadOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/) class by setting its value to `true`.

When enabled, this feature addresses the following issues in a PDF document:

* Broken references within the document (incorrect object offsets in the Cross-reference list).
* Missing critical elements like root object, page object, or page content.
* Circular references (Form X-object referencing itself).

Here is a source code sample:

{{< tabs "example18">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

LoadOptions loadOptions = new LoadOptions();
loadOptions.TryRepair = true;

PngViewOptions viewOptions = new PngViewOptions();

using (Viewer viewer = new Viewer("resume.pdf", loadOptions))
{    
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Dim loadOptions As New LoadOptions()
        loadOptions.TryRepair = True

        Dim viewOptions As New PngViewOptions()

        Using viewer As New Viewer("resume.pdf", loadOptions)
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render OFD documents

Starting from the [version 24.12](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-12-release-notes/), the GroupDocs.Viewer started to support the [OFD](https://www.zhihuilib.com/en/article/detail/2/12) (Open Fixed-layout Document) format, defined by GB/T 33190-2016 aims to replace PDF in Chinese public institutions. For processing _all_ the documents of this format the GroupDocs.Viewer requires that font [SimSun.ttf](https://learn.microsoft.com/en-us/typography/font-list/simsun) must be installed on the operating system. When using Microsoft Windows this should not be the problem, because the SimSun is preinstalled in all the Windows versions and editions starting from the _Windows 7_ (for example, _Windows 7_ has preinstalled SimSun version [5.03](https://learn.microsoft.com/en-us/typography/fonts/windows_7_font_list), while _Windows 10_ — SimSun version [5.16](https://learn.microsoft.com/en-us/typography/fonts/windows_10_font_list)). But on the Linux SimSun is usually not installed, and when trying to process such a file on Linux, a `GroupDocsViewerException : Could not load file. File is corrupted or damaged. - Font SimSun was not found` exception will be thrown.

In order to view and save arbitrary OFD file on Linux, the SimSun.ttf font should be loaded to the GroupDocs.Viewer using the [`FolderFontSource`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/folderfontsource/) class and [`FontSettings.SetFontSources`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontsettings/setfontsources/) method, and this should be done _before_ instantiating a [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/) class with OFD file. Article ["Set custom fonts"](https://docs.groupdocs.com/viewer/net/set-custom-fonts/) describes setting a custom font in detail, but a short example of setting a SimSun and saving OFD to HTML on Linux is below:

{{< tabs "example19">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Fonts;
// ...

//Put a SimSun.ttf to folder
string SimSunFolderPath = "full-valid-path\folder-with-SimSun-inside";
FolderFontSource fontSource = new FolderFontSource(SimSunFolderPath, SearchOption.TopFolderOnly);
FontSettings.SetFontSources(fontSource);

using (Viewer viewer = new Viewer("input.ofd"))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Fonts
' ...

' Put a SimSun.ttf to folder
Dim SimSunFolderPath As String = "full-valid-path\folder-with-SimSun-inside"
Dim fontSource As FolderFontSource = New FolderFontSource(SimSunFolderPath, SearchOption.TopFolderOnly)
FontSettings.SetFontSources(fontSource)

Using viewer As Viewer = New Viewer("input.ofd")
	Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
	viewer.View(viewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}
---

## Render PDF documents as HTML and image files

Path: /viewer/nodejs-java/render-pdf-documents/

[GroupDocs.Viewer for Node.js](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your PDF files in HTML, PNG, and JPEG formats. Use this library to implement a simple PDF viewer within your Java application (web or desktop).

Create a [Viewer](#) class instance to get started with the GroupDocs.Viewer API. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](#) method overloads to convert the document to HTML or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/pdf" >}} {{< icon "gdoc_person" >}} View PDF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Page Layout file formats

GroupDocs.Viewer supports the following PDF and Page Layout file formats:

* [Portable Document Format](https://docs.fileformat.com/pdf/) (.PDF)
* [Microsoft XML Paper Specification](https://docs.fileformat.com/page-description-language/xps/) (.XPS)
* [Open XML Paper Specification](https://docs.fileformat.com/page-description-language/oxps/) (.OXPS)
* [LaTeX Source Document](https://docs.fileformat.com/page-description-language/tex/) (.TEX)

## Render PDF files as HTML

Create an [HtmlViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a PDF file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](#) method and specify the output file name.

{{< tabs "render-pdf-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create an HTML files.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-pdf-to-html-embedded/pdf-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to HTML](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/render-pdf-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](#) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-pdf-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
 // Create an HTML file for each PDF page.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-pdf-to-html-external/pdf-to-html-page_{0}.html", "render-pdf-to-html-external/pdf-to-html-page_{0}/resource_{0}_{1}", "render-pdf-to-html-external/pdf-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/render-to-html-external-resources.png)

### Create HTML with fixed layout

By default, PDF and EPUB documents are rendered to HTML with fixed layout to ensure that the output HTML looks the same as a source document. Rendering to fixed layout means that all the HTML elements are absolutely positioned to the container element. And container element has a fixed size so browser window resizing will not have an effect on the position and size of elements in a document.

The following image demonstrates PDF document rendered HTML with fixed layout:

![Create HTML with fixed layout](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/render-pdf-to-html-with-fixed-layout.png)


### Adjust image quality in the output HTML file

The [HtmlviewOptions.getPdfOptions().setImageQuality()](#) methods allows you to specify the quality of images in the output HTML file. You can set this property to one of the following values:

* [ImageQuality.LOW](#) --- The image resolution is low (96 DPI), and the image size is small. Use this value to increase the conversion performance.
* [ImageQuality.MEDIUM](#) --- The image resolution is medium (192 DPI), and the image size is larger compared to the low quality images.
* [ImageQuality.HIGH](#) --- The image resolution is high (300 DPI), and the image size is big. Use of this value may decrease the conversion performance.

The following code snippet shows how to set the medium image quality when rendering a PDF document to HTML:

{{< tabs "render-pdf-with-image-quality">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions, ImageQuality } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create an HTML files.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-pdf-with-image-quality/pdf-to-html-page_{0}.html")
// Set image quality to medium.
viewOptions.getPdfOptions().setImageQuality(ImageQuality.MEDIUM)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Render text as an image

GroupDocs.Viewer supports the [HtmlViewOptions.getPdfOptions().setRenderTextAsImage](#) option that allows you to render text as an image when you convert a PDF file to HTML. In this case, the layout of the output HTML file closely mirrors the layout of the source PDF document.

The following code snippet shows how to enable this option in code:

{{< tabs "render-pdf-text-as-image">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create an HTML files.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-pdf-text-as-image/pdf-to-html-page_{0}.html")
// Enable rendering text as image.
viewOptions.getPdfOptions().setRenderTextAsImage(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result. PDF content is exported to HTML as an image, so users cannot select or copy document text.  

![Render PDF content as an image in the output HTML file](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/render-pdf-to-html-as-image.png)

### Enable multi-layer rendering

When you convert a PDF file to HTML, GroupDocs.Viewer creates an HTML document with a single layer (the `z-index` is not specified for document elements). This helps increase performance and reduce the output file size. If you convert a PDF document with multiple layers and want to improve the position of document elements in the output HTML file, use the [HtmlViewOptions.getPdfOptions().setEnableLayeredRendering](#) method to render text and graphics in the HTML file according to their z-order in the source PDF document.

The following code snippet shows how to enable the multi-layer rendering:

{{< tabs "render-pdf-with-multi-layer">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create an HTML files.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-pdf-with-multi-layer/pdf-to-html-page_{0}.html")
// Enable the multi-layer rendering.
viewOptions.getPdfOptions().setEnableLayeredRendering(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render PDF files as images

### Convert PDF files to PNG

Create a [PngViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a PDF file to PNG. Use the [PngViewOptions.setHeight](#) and [PngViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-pdf-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create a PNG image for each PDF page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-pdf-to-png/pdf-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to PNG](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/render-pdf-to-png.png)

### Convert PDF files to JPEG

Create a [JpgViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a PDF file to JPEG. Use the [JpgViewOptions.setHeight](#) and [JpgViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-pdf-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create a JPG image for each PDF page.
// {0} is replaced with the current page number in the image name.
const viewOptions = JpgViewOptions("render-pdf-to-jpeg/pdf-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Preserve the size of document pages

When you render PDF documents as images, GroupDocs.Viewer calculates the optimal image size to achieve better rendering quality. If you want the generated images to be the same size as pages in the source PDF document, use the [PdfOptions.setRenderOriginalPageSize](#) method of the [PngViewOptions](#) or [JpgViewOptions](#) class (depending on the output image format).

{{< tabs "render-pdf-preserve-page-size">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create a PNG image for each PDF page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-pdf-preserve-page-size/pdf-to-png-page_{0}.png")
// Preserve the size of document pages.
viewOptions.getPdfOptions().setRenderOriginalPageSize(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Enable font hinting

To adjust the display of outline fonts when you convert PDF documents to PNG or JPEG, use the [PdfOptions.setEnableFontHinting](#) method, as shown below:

{{< tabs "render-pdf-enable-font-hinting">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create a PNG image for each PDF page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-pdf-enable-font-hinting/pdf-to-png-page_{0}.png")
// Enable font hinting
viewOptions.getPdfOptions().setEnableFontHinting(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Refer to the following article for more information on font hinting: [Font hinting](https://en.wikipedia.org/wiki/Font_hinting).

## Disable character grouping

When you render PDF files in other formats, GroupDocs.Viewer groups individual characters into words to improve rendering performance. If your document contains hieroglyphic or special symbols, you may need to disable character grouping to generate a more precise layout. To do this, use the [PdfOptions.setDisableCharsGrouping](#) method, as shown below:

{{< tabs "render-pdf-disable-chars-grouping">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create a PNG image for each PDF page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-pdf-disable-chars-grouping/pdf-to-png-page_{0}.png")
// Disable character grouping.
viewOptions.getPdfOptions().setDisableCharsGrouping(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render text comments

Use the [ViewOptions.setRenderComments](#) method for a target view to display textual annotations (such as text comments, sticky notes, text boxes and callouts) in the output HTML, PNG, or JPEG files.

The code example below renders a PDF file with text comments as an image.

{{< tabs "render-pdf-with-comments">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("resume.pdf")
// Create a PNG image for each PDF page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-pdf-to-png/pdf-to-png-page_{0}.png")
// Enable rendering comments.
viewOptions.setRenderComments(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render PDF comments to PNG](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/render-pdf-comments.png)

## Get information about a PDF file

Follow the steps below to obtain information about a PDF file (the number of pages, page size, and printing permissions): 

1. Create a [ViewInfoOptions](#) instance for a specific view.
2. Call the [Viewer.getViewInfo](#) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [PdfViewInfo](#) type.
3. Use the `PdfViewInfo` class properties to retrieve document-specific information.

{{< tabs "get-pdf-file-information">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions } from '@groupdocs/groupdocs.viewer';

const viewInfoOptions = ViewInfoOptions.forHtmlView();
const viewer = new Viewer("resume.pdf")
const viewInfo = viewer.getViewInfo(viewInfoOptions)

// Display information about the PDF document.
console.log("File type: " + viewInfo.getFileType());
console.log("The number of pages: " + viewInfo.getPages().size());
console.log("Is printing allowed: " + viewInfo.isPrintingAllowed());
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a PDF file](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/retrieve-pdf-file-information.png)

### Extract text from a PDF file

Use the [ViewInfoOptions.setExtractText](#) method to enable PDF text extraction. Use the [PdfViewInfo.getPages](#) methods to obtain the list of all document pages, and use the ([Page.getLines](#) method to retrieve text for each line.

{{< tabs "extract-text-from-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions } from '@groupdocs/groupdocs.viewer';

const viewInfoOptions = ViewInfoOptions.forHtmlView();
viewInfoOptions.setExtractText(true)

const viewer = new Viewer("resume.pdf")
const viewInfo = viewer.getViewInfo(viewInfoOptions)

// Retrieve text from the PDF file.
viewInfo.getPages().toArray().forEach(function(page) {
  page.getLines().toArray().forEach(function(line){
    console.log(line.getValue())
    })  
  })
```
{{< /tab >}}
{{< tab "resume.pdf" >}}
{{< tab-text >}}
`resume.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-pdf-documents/resume.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

![Extract and display PDF text](/viewer/nodejs-java/images/rendering-basics/render-pdf-documents/extract-pdf-text.png)

---

## Render PDF documents as HTML and image files

Path: /viewer/python-net/render-pdf-documents/

[GroupDocs.Viewer for Python](https://products.groupdocs.com/viewer/python-net) allows you to render your PDF files in HTML, PNG, and JPEG formats. Use this library to implement a simple PDF viewer within your Python application (web or desktop).

Create a [Viewer](#) class instance to get started with the GroupDocs.Viewer API. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to HTML or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/pdf" >}} {{< icon "gdoc_person" >}} View PDF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Page Layout file formats

GroupDocs.Viewer supports the following PDF and Page Layout file formats:

* [Portable Document Format](https://docs.fileformat.com/pdf/) (.PDF)
* [Microsoft XML Paper Specification](https://docs.fileformat.com/page-description-language/xps/) (.XPS)
* [Open XML Paper Specification](https://docs.fileformat.com/page-description-language/oxps/) (.OXPS)
* [LaTeX Source Document](https://docs.fileformat.com/page-description-language/tex/) (.TEX)

## Render PDF files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a PDF file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_pdf_to_html():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create an HTML files.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_pdf_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_to_html()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to HTML](/viewer/python-net/images/rendering-basics/render-pdf-documents/render-pdf-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_pdf_to_html_external():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create an HTML file for each PDF page.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_pdf_to_html_external/pdf_page_{0}.html", "render_pdf_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_pdf_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_to_html_external()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-pdf-documents/render-to-html-external-resources.png)

### Create HTML with fixed layout

By default, PDF and EPUB documents are rendered to HTML with fixed layout to ensure that the output HTML looks the same as a source document. Rendering to fixed layout means that all the HTML elements are absolutely positioned to the container element. And container element has a fixed size so browser window resizing will not have an effect on the position and size of elements in a document.

The following image demonstrates PDF document rendered HTML with fixed layout:

![Create HTML with fixed layout](/viewer/python-net/images/rendering-basics/render-pdf-documents/render-pdf-to-html-with-fixed-layout.png)


### Adjust image quality in the output HTML file

The [HtmlviewOptions.pdf_options.image_quality](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptions/#properties) methods allows you to specify the quality of images in the output HTML file. You can set this property to one of the following values:

* [ImageQuality.LOW](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/imagequality/#members) --- The image resolution is low (96 DPI), and the image size is small. Use this value to increase the conversion performance.
* [ImageQuality.MEDIUM](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/imagequality/#members) --- The image resolution is medium (192 DPI), and the image size is larger compared to the low quality images.
* [ImageQuality.HIGH](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/imagequality/#members) --- The image resolution is high (300 DPI), and the image size is big. Use of this value may decrease the conversion performance.

The following code snippet shows how to set the medium image quality when rendering a PDF document to HTML:

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, ImageQuality

def render_pdf_with_image_quality():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create an HTML files.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_pdf_with_image_quality/pdf_with_image_quality_{0}.html")
        # Set image quality to medium.
        viewOptions.pdf_options.image_quality = ImageQuality.MEDIUM 
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_with_image_quality()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Render text as an image

GroupDocs.Viewer supports the [HtmlViewOptions.pdf_options.render_text_as_image](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptions/#properties) option that allows you to render text as an image when you convert a PDF file to HTML. In this case, the layout of the output HTML file closely mirrors the layout of the source PDF document.

The following code snippet shows how to enable this option in code:

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, ImageQuality

def render_pdf_text_as_image():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create an HTML files.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_pdf_text_as_image/text-as-image_{0}.html")
        # Enable rendering text as image.
        viewOptions.pdf_options.image_quality = ImageQuality.MEDIUM 
        viewOptions.pdf_options.render_text_as_image = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_text_as_image()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result. PDF content is exported to HTML as an image, so users cannot select or copy document text.  

![Render PDF content as an image in the output HTML file](/viewer/python-net/images/rendering-basics/render-pdf-documents/render-pdf-to-html-as-image.png)

### Enable multi-layer rendering

When you convert a PDF file to HTML, GroupDocs.Viewer creates an HTML document with a single layer (the `z-index` is not specified for document elements). This helps increase performance and reduce the output file size. If you convert a PDF document with multiple layers and want to improve the position of document elements in the output HTML file, use the [HtmlViewOptions.pdf_options.enable_layered_rendering](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptions/#properties) method to render text and graphics in the HTML file according to their z-order in the source PDF document.

The following code snippet shows how to enable the multi-layer rendering:

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_pdf_with_layered_rendering():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create an HTML files.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_pdf_with_layered_rendering/pdf_with_layered_rendering_{0}.html")
        # Enable the multi-layer rendering.
        viewOptions.pdf_options.enable_layered_rendering = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_with_layered_rendering()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render PDF files as images

### Convert PDF files to PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a PDF file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_pdf_to_png():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create a PNG image for each PDF page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_pdf_to_png/pdf_page_{0}.png")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 550
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_to_png()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PDF file to PNG](/viewer/python-net/images/rendering-basics/render-pdf-documents/render-pdf-to-png.png)

### Convert PDF files to JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a PDF file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_pdf_to_jpg():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create a JPG image for each PDF page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = JpgViewOptions("render_pdf_to_jpg/pdf_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 550
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_to_jpg()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Preserve the size of document pages

When you render PDF documents as images, GroupDocs.Viewer calculates the optimal image size to achieve better rendering quality. If you want the generated images to be the same size as pages in the source PDF document, use the [PdfOptions.render_original_page_size](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptions/#properties) method of the [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) or [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) class (depending on the output image format).

{{< tabs "example9">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_pdf_preserve_page_size():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create a PNG image for each PDF page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_pdf_preserve_page_size/pdf_preserve_page_size_{0}.png")
        # Preserve the size of document pages.
        viewOptions.pdf_options.render_original_page_size = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_preserve_page_size()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Enable font hinting

To adjust the display of outline fonts when you convert PDF documents to PNG or JPEG, use the [PdfOptions.enable_font_hinting](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptions/#properties) method, as shown below:

{{< tabs "example10">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_pdf_with_font_hinting():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create a PNG image for each PDF page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_pdf_with_font_hinting/pdf_with_font_hinting_{0}.png")
        # Enable font hinting
        viewOptions.pdf_options.enable_font_hinting = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_with_font_hinting()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Refer to the following article for more information on font hinting: [Font hinting](https://en.wikipedia.org/wiki/Font_hinting).

## Disable character grouping

When you render PDF files in other formats, GroupDocs.Viewer groups individual characters into words to improve rendering performance. If your document contains hieroglyphic or special symbols, you may need to disable character grouping to generate a more precise layout. To do this, use the [PdfOptions.disable_chars_grouping]((https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptions/#properties) method, as shown below:

{{< tabs "example11">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_pdf_disable_char_grouping():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create a PNG image for each PDF page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_pdf_disable_char_grouping/pdf_disable_char_grouping_{0}.png")
        # Disable character grouping.
        viewOptions.pdf_options.disable_chars_grouping = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_disable_char_grouping()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render text comments

Use the [ViewOptions.render_comments](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/#properties) method for a target view to display textual annotations (such as text comments, sticky notes, text boxes and callouts) in the output HTML, PNG, or JPEG files.

The code example below renders a PDF file with text comments as an image.

{{< tabs "example12">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_pdf_with_comments():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        # Create a PNG image for each PDF page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_pdf_with_comments/pdf_with_comments_{0}.png")
        # Enable rendering comments.
        viewOptions.render_comments = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_pdf_with_comments()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render PDF comments to PNG](/viewer/python-net/images/rendering-basics/render-pdf-documents/render-pdf-comments.png)

## Get information about a PDF file

Follow the steps below to obtain information about a PDF file (the number of pages, page size, and printing permissions): 

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.get_view_info](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [PdfViewInfo](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/pdfviewinfo/) type.
3. Use the `PdfViewInfo` class properties to retrieve document-specific information.

{{< tabs "example13">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions

def get_pdf_information():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        viewInfoOptions = ViewInfoOptions.for_html_view()
        view_info = viewer.get_view_info(viewInfoOptions)
        # Display information about the PDF document.
        print("File type:", view_info.file_type)
        print("The number of pages:", len(view_info.pages))

if __name__ == "__main__":
    get_pdf_information()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a PDF file](/viewer/python-net/images/rendering-basics/render-pdf-documents/retrieve-pdf-file-information.png)

### Extract text from a PDF file

Use the [ViewInfoOptions.extract_text](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewinfooptions/#properties) method to enable PDF text extraction. Use the [PdfViewInfo.pages](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/pdfviewinfo/#properties) methods to obtain the list of all document pages, and use the [Page.lines](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/page/#properties) method to retrieve text for each line.

{{< tabs "example14">}}
{{< tab "Python" >}}
```python
import sys
from typing import cast
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions
from groupdocs.viewer.results import PdfViewInfo

def extract_pdf_text():
    # Load PDF document
    with Viewer("sample.pdf") as viewer:
        view_info_options = ViewInfoOptions.for_html_view()
        view_info_options.extract_text = True

        view_info = viewer.get_view_info(view_info_options)
        pdf_info = cast(PdfViewInfo, view_info)

        # Retrieve text from the PDF file.
        sys.stdout.reconfigure(encoding='utf-8')

        for page in pdf_info.pages:
            print(f"Page: {page.number}")
            print("Text lines/words/characters:")

            for line in page.lines:
                text = str(line)
                encoded_line = text.encode('utf-8')
                sys.stdout.buffer.write(encoded_line)

                # Collect words as array
                words = [word.value for word in line.words]
                print("\tWords:", words)

                # Collect characters for each word as array
                for word in line.words:
                    characters = [char.value for char in word.characters]
                    print(f"\t\tCharacters for '{word.value}':", characters)

if __name__ == "__main__":
    extract_pdf_text()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-pdf-documents/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

![Extract and display PDF text](/viewer/python-net/images/rendering-basics/render-pdf-documents/extract-pdf-text.png)

---

## Result of added watermarks

Path: /watermark/net/result-of-added-watermarks/

GroupDocs.Watermark API provides the ability to add watermarks to document, where each added watermark being associated with a unique GUID (Globally Unique Identifier). This functionality not only enhances the security of the watermarked content, but also introduces a range of practical applications, like ability to trace the origin and distribution path of the watermarks, searching and removing specific watermark by id.

## Reviewing the result of added watermarks

The following code snippet shows how to review result [AddWatermarkResult](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks.results/addwatermarkresult/) with information about added watermarks in the document.


```csharp
using (Watermarker watermarker = new Watermarker("sample_2_pages.pdf"))
{
    // Initialize the font to be used for watermark
    Font font = new Font("Arial", 19, FontStyle.Bold | FontStyle.Italic);

    // Create the watermark object
    TextWatermark watermark = new TextWatermark("Test watermark", font);

    // Set watermark properties
    watermark.ForegroundColor = Color.Red;
    watermark.BackgroundColor = Color.Blue;
    watermark.TextAlignment = TextAlignment.Right;
    watermark.Opacity = 0.5;

    // Add watermark
    var result =  watermarker.Add(watermark);
    foreach(var item in  result.Succeeded) 
    {
        Console.WriteLine("WatermarkId: {0}", item.WatermarkId);
        Console.WriteLine("WatermarkType: {0}", item.WatermarkType);
        Console.WriteLine("PageNumber: {0}", item.PageNumber);
        Console.WriteLine("WatermarkPosition: {0}", item.WatermarkPosition);
    }

    watermarker.Save(outputFileName);
}

```

Output will be:

```csharp
WatermarkId: 1a78ef44-d497-451f-8f03-ca08ea537cc8
WatermarkType: Text
PageNumber: 1
WatermarkPosition: Default

WatermarkId: 658179cf-7b6e-472a-8b24-30f845dc2a9a
WatermarkType: Text
PageNumber: 2
WatermarkPosition: Default
```



---

## Save a modified file to a specified location

Path: /metadata/java/save-a-modified-file-to-a-specified-location/

This example shows how to save a document to a specified location on a local disk.

**advanced\_usage.saving\_files.SaveFileToSpecifiedLocation**

```csharp
// Constants.InputJpeg is an absolute or relative path to your document. Ex: @"C:\Docs\test.jpg"
try (Metadata metadata = new Metadata(Constants.InputJpeg)) {

	// Edit or remove metadata here

	metadata.save(Constants.OutputJpeg);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Save a modified file to a specified location

Path: /metadata/net/save-a-modified-file-to-a-specified-location/

This example shows how to save a document to a specified location on a local disk.

**AdvancedUsage.SavingFiles.SaveFileToSpecifiedLocation**

```csharp
// Constants.InputJpeg is an absolute or relative path to your document. Ex: @"C:\Docs\test.jpg"
using (Metadata metadata = new Metadata(Constants.InputJpeg))
{
	// Edit or remove metadata here
    // ...

	metadata.Save(Constants.OutputJpeg);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Save a modified file to a specified location

Path: /metadata/nodejs-java/save-a-modified-file-to-a-specified-location/

This example shows how to save a document to a specified location on a local disk.

**advanced\_usage.saving\_files.SaveFileToSpecifiedLocation**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata("input.pdf");

    // Edit or remove metadata here

metadata.save("output.pdf");
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Save a modified file to a specified location

Path: /metadata/python-net/save-a-modified-file-to-a-specified-location/

This example shows how to save a document to a specified location on a local disk.

**advanced_usage.saving_files.save_file_to_specified_location**


```python
def run():
    # constants.input_jpeg is an absolute or relative path to your document. Ex: r"C:\\Docs\\test.jpg"
    with gm.Metadata(constants.input_jpeg) as metadata:
        # Edit or remove metadata here
        # ...

        metadata.save(constants.output_jpeg)
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Save attachments

Path: /viewer/java/how-to-extract-and-save-attachments/

To get and save attachments, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object. Specify a file that contains attachments.
2. Call the [getAttachments](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getAttachments--) method. It returns the attachment collection.
3. Iterate through the collection. To save an attachment, call the [saveAttachment](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#saveAttachment-com.groupdocs.viewer.results.Attachment-java.io.OutputStream-) method.

The following code snippet shows how to get and save all attachments from the MSG file:

{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.results.Attachment;
// ...

try (Viewer viewer = new Viewer("with_attachments.msg")) {
    List<Attachment> attachments = viewer.getAttachments();

    for (Attachment attachment : attachments) {
        FileOutputStream fileStream = new FileOutputStream(attachment.getFileName());

        viewer.saveAttachment(attachment, fileStream);
    }
}         
```
{{< /tab >}}
{{< /tabs >}}

---

## Save attachments

Path: /viewer/net/how-to-extract-and-save-attachments/

To get and save attachments, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify a file that contains attachments.
2. Call the [GetAttachments](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getattachments) method. It returns the attachment collection.
3. Iterate through the collection. To save an attachment, call the [SaveAttachment](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/saveattachment) method.

The following code snippet shows how to get and save all attachments from the MSG file:

{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using System.Collections.Generic;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("with_attachments.msg"))
{
    // Get list of attachments.
    IList<Attachment> attachments = viewer.GetAttachments();
    // Save each attachments.
    foreach (Attachment attachment in attachments)
    {
        string filePath = Path.Combine("output", attachment.FileName);
        viewer.SaveAttachment(attachment, File.OpenWrite(filePath));
    }
}      
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports System.Collections.Generic
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("with_attachments.msg")
            ' Get list of attachments.
            Dim attachments As IList(Of Attachment) = viewer.GetAttachments()
            ' Save each attachments.
            For Each attachment As Attachment In attachments
                Dim filePath As String = Path.Combine("output", attachment.FileName)
                viewer.SaveAttachment(attachment, File.OpenWrite(filePath))
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Save attachments

Path: /viewer/nodejs-java/how-to-extract-and-save-attachments/

To get and save attachments, follow these steps:

1. Instantiate the [Viewer](#) object. Specify a file that contains attachments.
2. Call the [getAttachments](#) method. It returns the attachment collection.
3. Iterate through the collection. To save an attachment, call the [saveAttachment](#) method.

The following code snippet shows how to get and save all attachments from the MSG file:

{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "extract-and-save-attachments">}}
{{< tab "JavaScript" >}}
```js
import { Viewer } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("with_attachments.msg")
const attachments = viewer.getAttachments();
console.log('Attachments:\n');

for(let i = 0; i < attachments.size(); i++ ){
    console.log(attachments.get(i).toString());
}
console.log('\nAttachments retrieved successfully.');
```
{{< /tab >}}
{{< tab "with_attachments.msg" >}}
{{< tab-text >}}
`with_attachments.msg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/developer-guide/processing-attachments/how-to-extract-and-save-attachments/with_attachments.msg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Save attachments

Path: /viewer/python-net/how-to-extract-and-save-attachments/

To get and save attachments, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/) object. Specify a file that contains attachments.
2. Call the [get_attachments](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method. It returns the attachment collection.
3. Iterate through the collection. To save an attachment, call the [save_attachment](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

The following code snippet shows how to get and save all attachments from the MSG file:

{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer

def extract_and_save_attachments():
    # Load document with attachments
    with Viewer("with_attachments.msg") as viewer:
        attachments = viewer.get_attachments()

        print("\nAttachments:")
        for attachment in attachments:
            print(attachment)
            # Save attachment to disk
            viewer.save_attachment(attachment, f"./attachments/{attachment.file_name}")

    print(f"\nAttachments retrieved successfully.")

if __name__ == "__main__":
    extract_and_save_attachments()
```
{{< /tab >}}
{{< tab "with_attachments.msg" >}}
{{< tab-text >}}
`with_attachments.msg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/processing-attachments/with_attachments.msg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Save document to the specified stream

Path: /watermark/java/save-document-to-the-specified-stream/

Following code shows usage of [save(OutputStream)](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#save(java.io.OutputStream)) method.

**advanced\_usage.saving\_documents.SaveDocumentToTheSpecifiedStream**

```java
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();                                
                                                                                                 
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\test.doc"
Watermarker watermarker = new Watermarker("test.doc");                                  
                                                                                                 
// watermarking goes here                                                                        
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));            
watermarker.add(watermark);                                                                      
                                                                                                 
// Saves the document to the specified stream                                                    
watermarker.save(outputStream);                                                                  
                                                                                                 
watermarker.close();                                                                             
outputStream.close();                                                                            
```


---

## Save HTML to folder

Path: /editor/java/save-html-to-folder/

> This demonstration shows how to open input document, convert it to intermediate [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), and save to disk as HTML file with resource folder.

Almost all HTML WYSIWYG client-side editors are able to open HTML document from disk (from path). [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) allows to open any supportable document, convert it to HTML and save to disk, which may be very useful for the subsequent editing it in some WYSIWYG editor. The code below demonstrates such example.

```java
String inputFilePath = "C:\\input_path\\document.docx"; //path to some document
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
Editor editor = new Editor(inputFilePath, loadOptions); //passing path and load options (via delegate) to the constructor
EditableDocument document = editor.edit(new WordProcessingEditOptions());
String outputHtmlFilePath = "C:\\output_path\\document.html"; //path to output HTML document
document.save(outputHtmlFilePath);
```

In this example we load input WordProcessing (DOCX) document to Editor class with load options, specific for this document family type - [WordProcessingLoadOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingloadoptions). Load options are passed via delegate. Then document is converted to the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) using the [edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#edit--) method, which, in turn, obtains document-specific [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions). In the last line content is saved to the HTML file on disk, that is specified by absolute path. Please note that GroupDocs.Editor will create accompanying folder with resources automatically in the same directory, where HTML file is saved. There is another overload of the [save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method, that obtains 2 parameters: path to HTML file and path to existing folder, where resources should be saved. For example, last 2 lines can be rewritten in the next way:

```java
String outputHtmlFilePath = "C:\\output_path\\document.html"; //path to output HTML document
String outputHtmlFolderPath = "C:\\output_path\\document_files\\";//path to folder, where resources will be saved
document.save(outputHtmlFilePath, outputHtmlFolderPath);
```

By the way, don't forget to dispose all resources, if you're not using a `using` directive.

```java
document.dispose();
editor.dispose();
```

---

## Save HTML to folder

Path: /editor/net/save-html-to-folder/

> This demonstration shows how to open input document, convert it to intermediate [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), and save to disk as HTML file with resource folder.

Almost all HTML WYSIWYG client-side editors are able to open HTML document from disk (from path). [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) allows to open any supportable document, convert it to HTML and save to disk, which may be very useful for the subsequent editing it in some WYSIWYG editor. The code below demonstrates such example.

```csharp
string inputFilePath = "C:\\input_path\\document.docx"; //path to some document
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
Editor editor = new Editor(inputFilePath, loadOptions); //passing path and load options to the constructor
EditableDocument document = editor.Edit(new WordProcessingEditOptions());
string outputHtmlFilePath = "C:\\output_path\\document.html"; //path to output HTML document
document.Save(outputHtmlFilePath);
```

In this example we load input WordProcessing (DOCX) document to Editor class with load options, specific for this document family type - [WordProcessingLoadOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingloadoptions). Load options are passed. Then document is converted to the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) using the [Edit()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method, which, in turn, obtains document-specific [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions). In the last line content is saved to the HTML file on disk, that is specified by absolute path. Please note that GroupDocs.Editor will create accompanying folder with resources automatically in the same directory, where HTML file is saved. There is another overload of the [Save()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/save) method, that obtains 2 parameters: path to HTML file and path to existing folder, where resources should be saved. For example, last 2 lines can be rewritten in the next way:

```csharp
string outputHtmlFilePath = "C:\\output_path\\document.html"; //path to output HTML document
string outputHtmlFolderPath = "C:\\output_path\\document_files\\";//path to folder, where resources will be saved
document.Save(outputHtmlFilePath, outputHtmlFolderPath);
```

By the way, don't forget to dispose all resources, if you're not using a `using` directive.

```csharp
document.Dispose();
editor.Dispose();
```

---

## Save HTML to Folder

Path: /editor/nodejs-java/save-html-to-folder/


> This guide demonstrates how to open an input document, convert it to an intermediate `EditableDocument`, and save it to disk as an HTML file with a resource folder using GroupDocs.Editor for Node.js via Java.

Almost all HTML WYSIWYG client-side editors are able to open HTML documents from disk (from a path). **GroupDocs.Editor for Node.js via Java** allows you to open any supported document, convert it to HTML, and save it to disk, which may be very useful for subsequent editing in a WYSIWYG editor. The code below demonstrates such an example.

```javascript
// Import necessary modules
const fs = require('fs');
const path = require('path');
const groupdocsEditor = require('groupdocs-editor');

// Specify the input file path
const inputFilePath = 'C:\\input_path\\document.docx'; // Path to some document

// Create load options
const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();

// Create an Editor instance with the input file and load options
const editor = new groupdocsEditor.Editor(inputFilePath, loadOptions);

// Open the document for editing with format-specific edit options
const editOptions = new groupdocsEditor.WordProcessingEditOptions();
const editableDocument = editor.edit(editOptions);

// Get the HTML content
const htmlContent = editableDocument.getContent();

// Specify the output HTML file path
const outputHtmlFilePath = 'C:\\output_path\\document.html';

// Save the HTML content to a file
fs.writeFileSync(outputHtmlFilePath, htmlContent);

// If there are resources (images, stylesheets, fonts), save them to a folder
const resourcesFolderPath = 'C:\\output_path\\document_files';

// Ensure the resources folder exists
if (!fs.existsSync(resourcesFolderPath)) {
    fs.mkdirSync(resourcesFolderPath, { recursive: true });
}

// Get all resources
const resources = editableDocument.getAllResources();

// Save each resource to the resources folder
resources.forEach((resource) => {
    const resourceName = resource.getResourceName();
    const resourceContent = resource.getContent();
    const resourcePath = path.join(resourcesFolderPath, resourceName);
    fs.writeFileSync(resourcePath, resourceContent);
});

// Dispose of resources
editableDocument.dispose();
editor.dispose();
```

In this example, we load an input WordProcessing (DOCX) document into the `Editor` class with load options specific for this document family type—`WordProcessingLoadOptions`. Then, the document is converted to an `EditableDocument` using the `editor.edit()` method, which, in turn, uses document-specific `WordProcessingEditOptions`. We then obtain the HTML content and save it to an HTML file on disk, specified by an absolute path.

Please note that **GroupDocs.Editor** does not automatically create an accompanying folder with resources in Node.js via Java, so we manually extract the resources from the `EditableDocument` and save them to a specified folder. The resources may include images, stylesheets, and fonts used by the HTML document.

By the way, don't forget to dispose of all resources when you're done to free up system resources.

```javascript
// Dispose of resources
editableDocument.dispose();
editor.dispose();
```

---

By following this guide, you can effectively save edited documents as HTML files along with their associated resources using GroupDocs.Editor for Node.js via Java. This is particularly useful when you need to provide the HTML content to client-side WYSIWYG editors or for other purposes that require the HTML files to be stored on disk.

**Note:** Be sure to replace the paths in the code examples with the actual paths on your system.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Save image as file

Path: /markdown/net/image-file-strategy/


Use `ExportImagesToFileSystemStrategy` to save images as separate files during conversion. The Markdown output will contain image references pointing to the exported files.

### Basic usage

{{< tabs "image-file-basic">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    ImageExportStrategy = new ExportImagesToFileSystemStrategy("output/images")
};

MarkdownConverter.ToFile("business-plan.pdf", "output/document.md", options);
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "image-file-basic.zip" >}}  
```text
output/document.md (7 KB)
output/images/img-001.png (3 KB)
output/images/img-002.jpg (73 KB)
output/images/img-003.jpg (76 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/image-file-strategy/ImageFileBasic/image-file-basic.zip)
{{< /tab >}}
{{< /tabs >}}

### Using ImagesRelativePath

By default, image references in the Markdown use the full `ImagesFolder` path. Set `ImagesRelativePath` to produce portable, relative image links:

{{< tabs "image-file-relative">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var strategy = new ExportImagesToFileSystemStrategy("output/images")
{
    ImagesRelativePath = "images"
};

var options = new ConvertOptions
{
    ImageExportStrategy = strategy
};

MarkdownConverter.ToFile("business-plan.pdf", "output/document.md", options);

// Markdown output contains: ![](images/img-001.png)
// Image file saved to:     output/images/img-001.png
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "image-file-relative.zip" >}}  
```text
output/document.md (7 KB)
output/images/img-001.png (3 KB)
output/images/img-002.jpg (73 KB)
output/images/img-003.jpg (76 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/image-file-strategy/ImageFileRelative/image-file-relative.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Save image as file

Path: /markdown/python-net/image-file-strategy/


Use `ExportImagesToFileSystemStrategy` to save images as separate files during conversion. The Markdown output will contain image references pointing to the exported files.

### Basic usage

{{< tabs "image-file-basic">}}
{{< tab "image_file_basic.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy

def image_file_basic():
    """Save images to a folder on disk during PDF to Markdown conversion."""

    # Step 1: Configure the file system image export strategy
    options = ConvertOptions()
    options.image_export_strategy = ExportImagesToFileSystemStrategy("output/images")

    # Step 2: Convert and save to file using keyword argument for options
    MarkdownConverter.to_file("business-plan.pdf", "output/document.md", convert_options=options)

if __name__ == "__main__":
    import os
    os.makedirs("output/images", exist_ok=True)
    image_file_basic()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "image-file-basic.zip" >}}  
```text
output/document.txt (34 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
... (35 files total)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-file-strategy/image_file_basic/image-file-basic.zip)
{{< /tab >}}
{{< tab "image-file-basic.zip" >}}  
```text
output/document.txt (33 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
[TRUNCATED] (35 files total)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-file-strategy/image_file_basic/image-file-basic.zip)
{{< /tab >}}
{{< /tabs >}}

### Using images_relative_path

By default, image references in the Markdown use the full images folder path. Set `images_relative_path` to produce portable, relative image links:

{{< tabs "image-file-relative">}}
{{< tab "image_file_relative.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy

def image_file_relative():
    """Save images to disk with portable, relative paths in the Markdown output."""

    # Step 1: Configure the image export strategy with a relative path
    strategy = ExportImagesToFileSystemStrategy("output/images")
    strategy.images_relative_path = "images"  # produces ![](images/img-001.png)

    # Step 2: Assign the strategy to conversion options
    options = ConvertOptions()
    options.image_export_strategy = strategy

    # Step 3: Convert and save using keyword argument for options
    MarkdownConverter.to_file("business-plan.pdf", "output/document.md", convert_options=options)

    # Markdown output contains: ![](images/img-001.png)
    # Image file saved to:     output/images/img-001.png

if __name__ == "__main__":
    import os
    os.makedirs("output/images", exist_ok=True)
    image_file_relative()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "image-file-relative.zip" >}}  
```text
output/document.txt (34 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
... (35 files total)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-file-strategy/image_file_relative/image-file-relative.zip)
{{< /tab >}}
{{< tab "image-file-relative.zip" >}}  
```text
output/document.txt (33 KB)
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
[TRUNCATED] (35 files total)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-file-strategy/image_file_relative/image-file-relative.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Save in rasterized PDF

Path: /redaction/java/save-in-rasterized-pdf/

The following example demonstrates how to save the document as a rasterized PDF file:



```java
final Redactor redactor = new Redactor(Constants.SAMPLE_DOCX);
try 
{
    // Here we can use document instance to perform redactions
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    SaveOptions tmp0 = new  SaveOptions();
    tmp0.setAddSuffix(false);
    tmp0.setRasterizeToPDF(true);
    // Saving as rasterized PDF with no suffix in file name
    redactor.save(tmp0);
}
finally { redactor.close(); }
```

---

## Save in rasterized PDF

Path: /redaction/net/save-in-rasterized-pdf/

The following example demonstrates how to save the document as a rasterized PDF file:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Here we can use document instance to perform redactions
    redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    // Saving ias rasterized PDF with no suffix in file name
    redactor.Save(new SaveOptions() { AddSuffix = false, RasterizeToPDF = true });
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save in rasterized PDF

Path: /redaction/python-net/save-in-rasterized-pdf/

The following example demonstrates how to save the document as a rasterized PDF file:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = False
        so.rasterize_to_pdf = True

        result_path = redactor.save(so)
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
   

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save only annotated pages

Path: /annotation/java/save-only-annotated-pages/

To export the annotated pages only, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class. Call the [setOnlyAnnotatedPages](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/#setOnlyAnnotatedPages-boolean-) to set the property to `true`.
3.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method with the output document path or stream. Specify the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class as a parameter.
The following code snippet shows how to save only annotated pages:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates saving result document with specified pages.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setBackgroundColor(65535);
    area.setPageNumber(1);
    
    // Create an instance of EllipseAnnotation class and set options
    EllipseAnnotation ellipse = new EllipseAnnotation();
    ellipse.setBox(new Rectangle(100, 100, 100, 100));
    ellipse.setBackgroundColor(123456);
    ellipse.setPageNumber(2);
    
    List<AnnotationBase> tmp0 = new ArrayList<AnnotationBase>();
    tmp0.add(area);
    tmp0.add(ellipse);
    
    // Add annotation and save to file
    annotator.add(tmp0);
    
    SaveOptions tmp1 = new SaveOptions();
    tmp1.setOnlyAnnotatedPages(true);
    
    annotator.save(outputPath, tmp1);
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Save only annotated pages

Path: /annotation/net/save-only-annotated-pages/

To export to output document only annotated pages, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class. Set the [OnlyAnnotatedPages](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/saveoptions/onlyannotatedpages/) property to `true`.
3.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method with the output document path or stream. Specify the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class as a parameter.
The following code snippet shows how to save only annotated pages:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
// for this example input file ("input.pdf") must have at least 10 pages
using (Annotator annotator = new Annotator("input.pdf"))
{
	AreaAnnotation area = new AreaAnnotation()
    {
    	Box = new Rectangle(100, 100, 100, 100),
        BackgroundColor = 65535,
        PageNumber = 1
    };
    EllipseAnnotation ellipse = new EllipseAnnotation()
    {
        Box = new Rectangle(100, 100, 100, 100),
        BackgroundColor = 123456,
        PageNumber = 9
    };
    //Result file will be contain only two pages (1 and 9)
    annotator.Add(new List<AnnotationBase>() { area, ellipse });
    annotator.Save("result.pdf" new SaveOptions { OnlyAnnotatedPages = true});
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Save signed images with various output types

Path: /signature/java/save-signed-images-with-various-output-types/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports saving of Image signed documents with various image format types and extended options.

Following classes are inherited from base class [SaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SaveOptions) and allows to specify additional output image format settings.
*   [BmpSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/BmpSaveOptions) class allows to save signed image document to **BMP** image format and setup additional options ( like compression, resolutions, bits per pixel etc);
*   [GifSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/GifSaveOptions) class allows to save signed image document to **GIF **image format and setup additional options ( like compression, resolutions etc);
*   [JpegSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/JpegSaveOptions) class allows to save signed image document to **JPEG** image format and setup additional options ( like compression, resolutions, quality etc);
*   [PngSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/PngSaveOptions) class allows to save signed image document to **PNG** image format and setup additional options ( like bit depth, color type, compression, filters etc);
*   [TiffSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/TiffSaveOptions) class allows to save signed image document to **TIFF** image format and setup additional options

Here are the steps to save signed Image document to special image output type with additional settings with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate required signature options.    
*   Instantiate the one of required class of image format save options ([BmpSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/BmpSaveOptions), [GifSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/GifSaveOptions), [JpegSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/JpegSaveOptions), [PngSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/PngSaveOptions)[, TiffSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions.imagessaveoptions/TiffSaveOptions)) object according to your requirements and specify its properties.
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signatureoptions and [SaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SaveOptions) object to it.
    

## Save signed image as BMP

```java
Signature signature = new Signature("sample.jpg");
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
// create Bmp save options with advanced settings
BmpSaveOptions bmpSaveOptions = new BmpSaveOptions();
bmpSaveOptions.setAddMissingExtenstion(true);
bmpSaveOptions.setCompression(BitmapCompression.Rgb);
bmpSaveOptions.setHorizontalResolution(7);
bmpSaveOptions.setVerticalResolution(7);
bmpSaveOptions.setBitsPerPixel(16);
bmpSaveOptions.setOverwriteExistingFiles(true);
 
signature.sign("signedSample", signOptions, bmpSaveOptions );
```

## Save signed image as GIF

```java
Signature signature = new Signature("sample.jpg");
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
// create Gif save options with advanced settings
GifSaveOptions gifSaveOptions = new GifSaveOptions();
gifSaveOptions.setBackgroundColorIndex((byte)2);
gifSaveOptions.setColorResolution((byte) 7);
gifSaveOptions.setDoPaletteCorrection(true);
gifSaveOptions.setTrailer(true);
gifSaveOptions.setInterlaced(false);
gifSaveOptions.setPaletteSorted(true);
gifSaveOptions.setPixelAspectRatio((byte) 24);
gifSaveOptions.setAddMissingExtenstion(true);
 
 
signature.sign("signedSample", signOptions, bmpSaveOptions );
```

## Save signed image as JPEG

```java
Signature signature = new Signature("sample.jpg");
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
// create Jpeg save options with advanced settings
JpegSaveOptions jpegSaveOptions = new JpegSaveOptions();
jpegSaveOptions.setAddMissingExtenstion(true);
jpegSaveOptions.setBitsPerChannel((byte) 8);
jpegSaveOptions.setColorType(JpegCompressionColorMode.Rgb);
jpegSaveOptions.setComment("signed jpeg file");
jpegSaveOptions.setCompressionType(JpegCompressionMode.Lossless);
jpegSaveOptions.setQuality(100);
jpegSaveOptions.setSampleRoundingMode(JpegRoundingMode.Extrapolate);
 
 
signature.sign("signedSample", signOptions, jpegSaveOptions);
```

## Save signed image as PNG

```java
Signature signature = new Signature("sample.jpg");
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
// create png save options with advanced settings
PngSaveOptions pngSaveOptions = new PngSaveOptions();
pngSaveOptions.setBitDepth((byte) 8);
pngSaveOptions.setColorType(PngColorType.Grayscale);
pngSaveOptions.setCompressionLevel(9);
pngSaveOptions.setFilterType(PngFilterType.Adaptive);
pngSaveOptions.setProgressive(true);
pngSaveOptions.setAddMissingExtenstion(true);
 
 
signature.sign("signedSample", signOptions, pngSaveOptions );
```

## Save signed image as TIFF

```java
Signature signature = new Signature("sample.jpg");
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
/// create tiff save options with advanced settings
TiffSaveOptions tiffSaveOptions = new TiffSaveOptions();
tiffSaveOptions.setExpectedTiffFormat(TiffFormat.TiffNoCompressionBw);
tiffSaveOptions.setAddMissingExtenstion(true);
 
 
signature.sign("signedSample", signOptions, tiffSaveOptions  );
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Saving signed images with various output types

Path: /signature/net/save-signed-images-with-various-output-types/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving of Image signed documents with various image format types and extended options.

Following classes are inherited from base class [SaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/saveoptions) and allows to specify additional output image format settings.

* [BmpSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/bmpsaveoptions) class allows to save signed image document to **BMP** image format and setup additional options ( like compression, resolutions, bits per pixel etc);
* [GifSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/gifsaveoptions) class allows to save signed image document to **GIF**image format and setup additional options ( like compression, resolutions etc);
* [JpegSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/jpegsaveoptions) class allows to save signed image document to **JPEG** image format and setup additional options ( like compression, resolutions, quality etc);
* [PngSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pngsaveoptions) class allows to save signed image document to **PNG** image format and setup additional options ( like bit depth, color type, compression, filters etc);
* [TiffSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/tiffsaveoptions) class allows to save signed image document to **TIFF** image format and setup additional options

Here are the steps to save signed Image document to special image output type with additional settings with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the one of required class of image format save options [BmpSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/bmpsaveoptions), [GifSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/gifsaveoptions), [JpegSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/jpegsaveoptions), [PngSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pngsaveoptions), [TiffSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/tiffsaveoptions) object according to your requirements and specify its properties.  

* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signatureoptions and [SaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/saveoptions) object to it.

## Save signed image as BMP

```csharp
using (Signature signature = new Signature("sample.jpg"))
{
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QRCodeTypes.QR, Left = 100, Top = 100
    };
    SaveOptions saveOptions;
    // create Bmp save options with advanced settings
    saveOptions = new BmpSaveOptions()
    {
        AddMissingExtension = true,
        Compression = BitmapCompression.Rgb,
        HorizontalResolution = 7,
        VerticalResolution = 7,
        BitsPerPixel = 16,
        OverwriteExistingFiles = true
    };
    // sign document to file
    signature.Sign("signedSample", signOptions, saveOptions);
}
```

## Save signed image as GIF

```csharp
using (Signature signature = new Signature("sample.jpg"))
{
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QRCodeTypes.QR, Left = 100, Top = 100
    };
    SaveOptions saveOptions;
    // create Gif save options with advanced settings
    saveOptions = new GifSaveOptions()
    {
        AddMissingExtension = true,
        BackgroundColorIndex = 2,
        ColorResolution = 7,
        DoPaletteCorrection = true,
        HasTrailer = true,
        Interlaced = false,
        IsPaletteSorted = true,
        PixelAspectRatio = 24
    };
    // sign document to file
    signature.Sign("SignedSample", signOptions, saveOptions);
}
```

## Save signed image as JPEG

```csharp
using (Signature signature = new Signature("sample.jpg"))
{
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QRCodeTypes.QR, Left = 100, Top = 100
    };
    SaveOptions saveOptions;
    // create Jpeg save options with advanced settings
    saveOptions = new JpegSaveOptions()
    {
        AddMissingExtension = true,
        BitsPerChannel = 8,
        ColorType = JpegCompressionColorMode.Rgb,
        Comment = "signed jpeg file",
        CompressionType = JpegCompressionMode.Lossless,
        Quality = 100,
        SampleRoundingMode = JpegRoundingMode.Extrapolate
    };
    // sign document to file
    signature.Sign("SignedSample", signOptions, saveOptions);
}
```

## Save signed image as PNG

```csharp
using (Signature signature = new Signature("sample.jpg"))
{
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QRCodeTypes.QR, Left = 100, Top = 100
    };
    SaveOptions saveOptions;
    // create png save options with advanced settings
    saveOptions = new PngSaveOptions()
    {
        AddMissingExtension = true,
        BitDepth = 8,
        ColorType = PngColorType.Grayscale,
        CompressionLevel = 9,
        FilterType = PngFilterType.Adaptive,
        Progressive = true
    };
    // sign document to file
    signature.Sign("SignedSample", signOptions, saveOptions);
}
```

## Save signed image as TIFF

```csharp
using (Signature signature = new Signature("sample.jpg"))
{
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QRCodeTypes.QR, Left = 100, Top = 100
    };
    SaveOptions saveOptions;
    // create tiff save options with advanced settings
    saveOptions = new TiffSaveOptions()
    {
        AddMissingExtension = true,
        ExpectedTiffFormat = TiffFormat.TiffNoCompressionBw
    };
    // sign document to file
    signature.Sign("SignedSample", signOptions, saveOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Saving to HTML with External Resource Files

Path: /assembly/java/saving-to-html-with-external-resource-files/

{{< alert style="info" >}}This feature is supported by version 19.5. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

# Saving to HTML with External Resource Files

Since version 19.5, The [GroupDocs.Assembly](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/package-summary) provides a great feature which is saving of external resource files while an assembled document loaded from a non-HTML format is being saved to HTML.

From now on, when saving an assembled document to an HTML file, by default, external resource files are stored to a folder having the same name as the HTML file without extension plus the "\_files" suffix. This folder is located in the same folder as the HTML file. The following example illustrates the scenario. The following code snippet shows the way of API usage:

{{< gist GroupDocsGists 367999066c740ee88e491398f29a2765 >}}

In the following example, the default folder used to store HTML resource files is overridden by an explicitly specified folder.

{{< gist GroupDocsGists 50bbba0f46352df7fc4e6a9f556e31f3 >}}



---

## Saving to HTML with External Resource Files

Path: /assembly/net/saving-to-html-with-external-resource-files/

{{< alert style="info" >}}This feature is supported by version 19.5. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

Since version 19.5, The GroupDocs.Assembly provides a great feature which is saving of external resource files while an assembled document loaded from a non-HTML format is being saved to HTML.

From now on, when saving an assembled document to an HTML file, by default, external resource files are stored to a folder having the same name as the HTML file without extension plus the "\_files" suffix. This folder is located in the same folder as the HTML file. The following example illustrates the scenario. The following code snippet shows the way of API usage:

{{< gist GroupDocsGists 63210a271dd6e3f960b86637e15e3d5a >}}



In the following example, the default folder used to store HTML resource files is overridden by an explicitly specified folder.

{{< gist GroupDocsGists b530fa88fa2e578219aa33f7e064c49d >}}



---

## Scatter Chart in Spreadsheet Document

Path: /assembly/java/scatter-chart-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Scatter Chart in Microsoft Excel Document

### Creating a Scatter Chart

Please follow below steps to create Scatter Chart in MS Excel 2013:

1.  Add a new Workbook.
2.  Click in the workbook where you want to insert the chart, click the "Insert" tab, and then click "Insert Scatter Chart Icon" in the charts group.
3.  A drop-down with charts will appear, select the "Scatter" and press "OK" to insert the chart.
4.  Click on the chart you just inserted, then click the "Change Data" icon in Data group.
5.  Now add legend entries. See [Chart Data](https://docs.groupdocs.com/assembly/java/scatter-chart-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to show contract prices by month with the following key requirements:

*   Report must show information on a Scatter Chart.
*   It must indicate total contract prices by month.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>>
```

#### Chart Data

**Legend Entries**

```java
="Total Contract Price<<x [key + 1]>><<y [sum(c => c.getPrice())]>>"
```

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Scatter%20Chart.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 9f23eb8da0d619df8b7c873b6bbd482c >}}

## Scatter Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Scatter Chart in Spreadsheet Document

Path: /assembly/net/scatter-chart-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Scatter Chart in Microsoft Excel Document

### Creating a Scatter Chart

Please follow below steps to create Scatter Chart in MS Excel 2013:

1.  Add a new Workbook.
2.  Click in the workbook where you want to insert the chart, click the "Insert" tab, and then click "Insert Scatter Chart Icon" in the charts group.
3.  A drop-down with charts will appear, select the "Scatter" and press "OK" to insert the chart.
4.  Click on the chart you just inserted, then click the "Change Data" icon in Data group.
5.  Now add legend entries. See [Chart Data](https://docs.groupdocs.com/assembly/net/scatter-chart-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to show your customers' orders prices by month with the following key requirements:

*   Report must show information on a Scatter Chart.
*   It must indicate Price of each order by month.
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>>
```

#### Chart Data

**Legend Entries**

```csharp
="Total Order Price<<x [Key]>><<y [Sum(c => c.Price)]>>"
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Scatter%20Chart.xlsx?raw=true) (Template for CustomObject and JSON examples) 
*   [Scatter Chart\_DB.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Scatter%20Chart_DB.xlsx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 2dfb4c8b14814612e05d5d144887df2e >}}



#### Database Entities

{{< gist GroupDocsGists 9c0bb7a58a06fc2eaaa780af1e51ee13 >}}



#### Using DataSet

{{< gist GroupDocsGists 4c2770bf096eb8b3670433b695610e5f >}}



#### Using XML DataSource

{{< gist GroupDocsGists 55bb62b4b8afd5c31ac08452352d8197 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 3ec160ae6172521393ec72139f8af94c >}}



## Scatter Chart in OpenOffice Spreadsheet Document

To be investigated.

---

## Search for embedded object with custom serialization of Metadata signatures

Path: /signature/java/search-for-embedded-object-with-custom-serialization-of-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides additional features when searching for Metadata Signatures that were previously encrypted and have embedded data objects. 
*   ability to search for embedded custom objects into metadata and decrypt them to original source values
*   ability to search for encrypted text of metadata signature and decrypt it       

Here are the steps to search and decrypt previously encrypted text of metadata and decrypt custom object from metadata signature ([MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature)) with GroupDocs.Signature API:
*   Implement custom data serialization class that implement [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default Signature uses embedded json format serialization but allows user to customize it. if object of class was serialized by custom serialization when searching for it, this class should also has same serialization attribute.      
*   Implement custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default Signature has several encryption implementation you can use but allows user to customize it. There's ability to specify inline encryption to use
*   Define class with proper DataSerialization attribute 
*   Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) object value 
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) to it.
*   Process each Metadata signature and set property [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) to specify data encryption and call [getData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#getData(java.lang.Class)) method to retrieve object 
    

## Implementation of custom data serialization

 This example shows how to specify custom serialization class. This class should be implemented as Attribute and [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface.

```java
public class CustomSerializationAttribute implements IDataSerializer{
 
 
    public <T> T deserialize(String source, Class<T> type)
    {
        return new Gson().fromJson(source, type);
    }
    public String serialize(Object data)
    {
        return new Gson().toJson(data);
    }
 
}
```

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
public class CustomXOREncryption implements IDataEncryption
{
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final int getKey(){ return auto_Key; }
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final void setKey(int value){ auto_Key = value; }
    private int auto_Key;
 
    /**
     * <p>
     * Encode method to encrypt string.
     * </p>
     * @return Returns enccrypted string
     * @param source Source string to encode.
     */
    public final String encode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Decode method to obtain decrypted string.
     * </p>
     * @return Returns decrypted string
     * @param source Source string to decode.
     */
    public final String decode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Using XOR operation get encoded / decoded string
     * </p>
     * @return
     * @param source
     */
    private String process(String source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.length());
        char chTmp;
        for (int index = 0; index < src.length(); ++index)
        {
            chTmp = src.charAt(index);
            chTmp = (char)(chTmp ^ this.getKey());
            dst.append(chTmp);
        }
        return dst.toString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```java
public static class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

  

## Search for embedded custom objects in metadata signatures

 This example shows how to decrypt previously embedded encrypted custom objects into metadata signature. [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) contains method [getData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#getData(java.lang.Class)) to retrieve object

```java
Signature signature = new Signature("MetadataCustomSerializationObject.docx");
 
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
MetadataSearchOptions options = new MetadataSearchOptions();
options.setDataEncryption(encryption);
 
// search for signatures in document
List<WordProcessingMetadataSignature> signatures = signature.search(WordProcessingMetadataSignature.class,options);
System.out.print("\nSource document contains following signatures.");
// get required metadata signatures
WordProcessingMetadataSignature wordSignature = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("Signature")) {
        wordSignature = mdSign;
        break;
    }
}
if (wordSignature != null)
{
    DocumentSignatureData documentSignatureData = wordSignature.getData(DocumentSignatureData.class);
    if (documentSignatureData != null)
    {
        System.out.print("Signature has DocumentSignatureData object:\n ID = " + documentSignatureData.getID() + ", Author = " + documentSignatureData.getAuthor() + ", Signed = " + documentSignatureData.getSigned() + ", DataFactor " + documentSignatureData.getDataFactor());
    }
}
// get required metadata signatures
WordProcessingMetadataSignature mdAuthor = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("Author")) {
        mdAuthor = mdSign;
        break;
    }
}
if (mdAuthor != null)
{
    System.out.print("Metadata signature found. Name : " + mdAuthor.getName() + ". Value: " + mdAuthor.getData(String.class));
}
// get required metadata signatures
WordProcessingMetadataSignature mdDocId = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("DocumentId")) {
        mdDocId = mdSign;
        break;
    }
}
if (mdDocId != null)
{
    System.out.print("Metadata signature found. Name : " + mdDocId.getName() + ". Value: " + mdDocId.getData(String.class));
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for embedded object with custom serialization of Metadata signatures

Path: /signature/net/search-for-embedded-object-with-custom-serialization-of-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides additional features when searching for Metadata Signatures that were previously encrypted and have embedded data objects.

* ability to search for embedded custom objects into metadata and decrypt them to original source values
* ability to search for encrypted text of metadata signature and decrypt it

Here are the steps to search and decrypt previously encrypted text of metadata and decrypt custom object from metadata signature ([MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature)) with GroupDocs.Signature API:

* Implement custom data serialization class that implement [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default Signature uses embedded json format serialization but allows user to customize it. if object of class was serialized by custom serialization when searching for it, this class should also has same serialization attribute.  
* Implement custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default Signature has several encryption implementation you can use but allows user to customize it. There's ability to specify inline encryption to use
* Define class with proper DataSerialization attribute  
* Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) object value
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) to it.
* Process each Metadata signature and set property [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions/dataencryption) to specify data encryption and call [GetData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/getdata) method to retrieve object

## Implementation of custom data serialization

This example shows how to specify custom serialization class. This class should be implemented as Attribute and [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) interface.

```csharp
public class CustomSerializationAttribute : Attribute, IDataSerializer
{
    public T Deserialize<T>(string source) where T : class
    {
        return JsonConvert.DeserializeObject<T>(source);
    }
    public string Serialize(object data)
    {
        var serializerSettings = new JsonSerializerSettings { NullValueHandling = NullValueHandling.Ignore };
        return JsonConvert.SerializeObject(data, serializerSettings);
    }
}
```

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
// Define class that implements IDataEncryption interface
private class CustomXOREncryption : IDataEncryption
{
    /// <summary>
    /// Gets or sets non empty key for encryption (at least one character)
    /// </summary>
    public int Key { get; set; }
    /// <summary>
    /// Encode method to encrypt string.
    /// </summary>
    /// <param name="source">Source string to encode.</param>
    /// <returns>Returns enccrypted string</returns>
    public string Encode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Decode method to obtain decrypted string.
    /// </summary>
    /// <param name="source">Source string to decode.</param>
    /// <returns>Returns decrypted string</returns>
    public string Decode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Using XOR operation get encoded / decoded string
    /// </summary>
    /// <param name="source"></param>
    /// <returns></returns>
    private string Process(string source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.Length);
        char chTmp;
        for (int index = 0; index < src.Length; ++index)
        {
            chTmp = src[index];
            chTmp = (char)(chTmp ^ this.Key);
            dst.Append(chTmp);
        }
        return dst.ToString();
    }
}
```

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
// setup CustomSerialization Attribute to setup customer serialization(see example above)
[CustomSerialization]
private class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Search for embedded custom objects in metadata signatures

 This example shows how to decrypt previously embedded encrypted custom objects into metadata signature. [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) contains method [GetData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/getdata) to retrieve object

```csharp
using (Signature signature = new Signature("MetadataCustomSerializationObject.docx"))
{
    // create data encryption
    IDataEncryption encryption = new CustomXOREncryption();
    MetadataSearchOptions options = new MetadataSearchOptions()
    {
        DataEncryption = encryption
    };
    // search for signatures in document
    List<WordProcessingMetadataSignature> signatures = signature.Search<WordProcessingMetadataSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    // get required metadata signatures
    WordProcessingMetadataSignature mdSignature = signatures.FirstOrDefault(p => p.Name == "Signature");
    if (mdSignature != null)
    {
        DocumentSignatureData documentSignatureData = mdSignature.GetData<DocumentSignatureData>();
        if (documentSignatureData != null)
        {
            Console.WriteLine("Signature has DocumentSignatureData object:\n ID = {0}, Author = {1}, Signed = {2}, DataFactor {3}",
                documentSignatureData.ID, documentSignatureData.Author, documentSignatureData.Signed.ToShortDateString(), documentSignatureData.DataFactor);
        }
    }
    // get required metadata signatures
    WordProcessingMetadataSignature mdAuthor = signatures.FirstOrDefault(p => p.Name == "Author");
    if (mdAuthor != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdAuthor.Name, mdAuthor.GetData<string>());
    }
    // get required metadata signatures
    WordProcessingMetadataSignature mdDocId = signatures.FirstOrDefault(p => p.Name == "DocumentId");
    if (mdDocId != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdDocId.Name, mdDocId.GetData<string>());
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for embedded object with custom serialization of QR-Code signatures

Path: /signature/java/search-embed-obj-with-custom-serializ-qr-codes/

GroupDocs.Signature provides following abilities to search for embedded data objects in QR-code signatures ([QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature)) that were embedded with custom encryption and serialization 

*   ability to search for embedded custom objects into metadata and decrypt them to original source values
*   ability to search for custom encrypted QR-code signature and decrypt it
*   ability to search for custom serialized QR-code signatures  

Here are the steps to search and decrypt previously encrypted text of QR-Code and decrypt custom object from QR-Code signature with GroupDocs.Signature API:

*   Implement (use) custom data serialization class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface.    
*   Ensure that data class if defined with custom serialization attribute      
*   Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object and setup [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) value with custom encryption object implementation      
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) to it.
     

## Implementation of custom data serialization

 This example shows how to specify custom serialization class. This class should be implemented as Attribute and [IDataSerializer](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface.

```java
/**
 * Creates class that implements IDataSerializer interface
 * It cam support common serialization like JSon or custom data format
 */
public class CustomSerializationAttribute implements IDataSerializer{
 
 
    public <T> T deserialize(String source, Class<T> type)
    {
        return new Gson().fromJson(source, type);
    }
    public String serialize(Object data)
    {
        return new Gson().toJson(data);
    }
 
}
```

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```java
// Define class that implements IDataEncryption interface
// Class could inherits Attribute to use it with class definition
 
public class CustomXOREncryption implements IDataEncryption
{
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final int getKey(){ return auto_Key; }
    /**
     * <p>
     * Gets or sets non empty key for encryption (at least one character)
     * </p>
     */
    public final void setKey(int value){ auto_Key = value; }
    private int auto_Key;
 
    /**
     * <p>
     * Encode method to encrypt string.
     * </p>
     * @return Returns enccrypted string
     * @param source Source string to encode.
     */
    public final String encode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Decode method to obtain decrypted string.
     * </p>
     * @return Returns decrypted string
     * @param source Source string to decode.
     */
    public final String decode(String source)
    {
        return process(source);
    }
 
    /**
     * <p>
     * Using XOR operation get encoded / decoded string
     * </p>
     * @return
     * @param source
     */
    private String process(String source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.length());
        char chTmp;
        for (int index = 0; index < src.length(); ++index)
        {
            chTmp = src.charAt(index);
            chTmp = (char)(chTmp ^ this.getKey());
            dst.append(chTmp);
        }
        return dst.toString();
    }
}
```

## Definition of class

This example shows how to define custom class for serialization.

```java
public static class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Search for embedded custom objects in QR-code signatures

This example shows how to decrypt previously embedded encrypted custom objects into [QrCodeSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/QrCodeSignature) contains method [getData](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/QrCodeSignature#getData(java.lang.Class)) to retrieve object

```java
Signature signature = new Signature("QRCodeCustomSerializationObject.pdf");
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
 
QrCodeSearchOptions options = new QrCodeSearchOptions();
 
// specify special pages to search on
options.setAllPages(true);
options.setDataEncryption(encryption);
 
 
// search for signatures in document
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class,options);
System.out.print("\nSource document contains following signatures:");
for (QrCodeSignature qrCodeSignature : signatures)
{
    System.out.print("QRCode signature found at page "+qrCodeSignature.getPageNumber()+" with type "+ qrCodeSignature.getEncodeType());
    DocumentSignatureData documentSignatureData = qrCodeSignature.getData(DocumentSignatureData.class);
    if (documentSignatureData != null)
    {
        System.out.print("QRCode signature has DocumentSignatureData object:\n ID = " + documentSignatureData.getID() + ", Author = " + documentSignatureData.getAuthor() + ", Signed = " + documentSignatureData.getSigned() + ", DataFactor "+documentSignatureData.getDataFactor());
    }
}
```

## More resources 

### GitHub Examples  

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for embedded object with custom serialization of QR-Code signatures

Path: /signature/net/search-for-embedded-object-with-custom-serialization-of-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides following abilities to search for embedded data objects in QR-code signatures ([QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature)) that were embedded with custom encryption and serialization

* ability to search for embedded custom objects into metadata and decrypt them to original source values
* ability to search for custom encrypted QR-code signature and decrypt it
* ability to search for custom serialized QR-code signatures  

Here are the steps to search and decrypt previously encrypted text of QR-Code and decrypt custom object from QR-Code signature with GroupDocs.Signature API:

* Implement (use) custom data serialization class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface.
* Ensure that data class if defined with custom serialization attribute  
* Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object and setup [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions/dataencryption) value with custom encryption object implementation
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) to it.

## Implementation of custom data serialization

 This example shows how to specify custom serialization class. This class should be implemented as Attribute and [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) interface.

```csharp
/// <summary>
/// Creates class that implements IDataSerializer interface
/// This implementation is using json library to provide serialization and deserialization
/// </summary>

public class CustomSerializationAttribute : Attribute, IDataSerializer
{
    public T Deserialize<T>(string source) where T : class
    {
        return JsonConvert.DeserializeObject<T>(source);
    }
    public string Serialize(object data)
    {
        var serializerSettings = new JsonSerializerSettings { NullValueHandling = NullValueHandling.Ignore };
        return JsonConvert.SerializeObject(data, serializerSettings);
    }
}
```

## Implementation of custom data encryption

This example shows how to specify custom serialization class. This class could be implemented also as Attribute (optional) to specify as class attribute.

```csharp
// Define class that implements IDataEncryption interface
// Class could inherits Attribute to use it with class definition

public class CustomXOREncryption : IDataEncryption
{
    /// <summary>
    /// Gets or sets non empty key for encryption (at least one character)
    /// </summary>
    public int Key { get; set; }
    /// <summary>
    /// Encode method to encrypt string.
    /// </summary>
    /// <param name="source">Source string to encode.</param>
    /// <returns>Returns enccrypted string</returns>
    public string Encode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Decode method to obtain decrypted string.
    /// </summary>
    /// <param name="source">Source string to decode.</param>
    /// <returns>Returns decrypted string</returns>
    public string Decode(string source)
    {
        return Process(source);
    }
    /// <summary>
    /// Using XOR operation get encoded / decoded string
    /// </summary>
    /// <param name="source"></param>
    /// <returns></returns>
    private string Process(string source)
    {
        StringBuilder src = new StringBuilder(source);
        StringBuilder dst = new StringBuilder(src.Length);
        char chTmp;
        for (int index = 0; index < src.Length; ++index)
        {
            chTmp = src[index];
            chTmp = (char)(chTmp ^ this.Key);
            dst.Append(chTmp);
        }
        return dst.ToString();
    }
}
```

## Definition of class

This example shows how to define custom class for serialization.

```csharp
// define class with custom serialization attribute
[CustomSerialization]
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Search for embedded custom objects in QR-code signatures

This example shows how to decrypt previously embedded encrypted custom objects into [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) contains method [GetData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature/getdata) to retrieve object

```csharp
using (Signature signature = new Signature("QRCodeCustomSerializationObject.pdf"))
{
    // create data encryption
    IDataEncryption encryption = new CustomXOREncryption();
    QrCodeSearchOptions options = new QrCodeSearchOptions()
    {
        // specify special pages to search on
        AllPages = true,
        DataEncryption = encryption
    };
    // search for signatures in document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    Console.WriteLine("\nSource document contains following signatures:");
    foreach (var qrCodeSignature in signatures)
    {
        Console.WriteLine("QRCode signature found at page {0} with type {1}.", qrCodeSignature.PageNumber, qrCodeSignature.EncodeType);
        DocumentSignatureData documentSignatureData = qrCodeSignature.GetData<DocumentSignatureData>();
        if (documentSignatureData != null)
        {
            Console.WriteLine("QRCode signature has DocumentSignatureData object:\n ID = {0}, Author = {1}, Signed = {2}, DataFactor {3}",
                documentSignatureData.ID, documentSignatureData.Author, documentSignatureData.Signed.ToShortDateString(), documentSignatureData.DataFactor);
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search index repository

Path: /search/java/search-index-repository/

The [IndexRepository](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexRepository) class can be used to combine several indexes into a group for searching all indexes at once. In addition, a single call to the [update](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexRepository#update()) method can update all indexes in the repository. And also the index repository serves as an event hub for all indexes in it. That is, you can subscribe to any events available for the index also through the index repository. However, note that indexing documents is performed separately for each index.

To start using the index repository, indexes must be created or loaded and added to an instance of the index repository. Examples of creating and adding indexes to the repository are presented below.



```java
String indexFolder1 = "c:\\MyIndex1\\";
String indexFolder2 = "c:\\MyIndex2\\";
String documentsFolder1 = "c:\\MyDocuments1\\";
String documentsFolder2 = "c:\\MyDocuments2\\";
 
// Creating an index repository instance
IndexRepository indexRepository = new IndexRepository();
 
// Creating or loading an index and adding to the index repository
Index index1 = new Index(indexFolder1);
indexRepository.addToRepository(index1);
 
// Creating an index via the index repository by calling a single method
Index index2 = indexRepository.create(indexFolder2);
 
// Adding documents to the index 1
index1.add(documentsFolder1);
 
// Adding documents to the index 2
index2.add(documentsFolder2);
```

The following example shows how to subscribe to the repository events, update indexes in the repository, and search in the repository.



```java
String indexFolder1 = "c:\\MyIndex1\\";
String indexFolder2 = "c:\\MyIndex2\\";
String documentFolder1 = "c:\\MyDocuments1\\";
String documentFolder2 = "c:\\MyDocuments2\\";
 
// Creating an index repository instance
IndexRepository indexRepository = new IndexRepository();
 
// Subscribing to an event
indexRepository.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
    public void invoke(Object sender, IndexErrorEventArgs args) {
        System.out.println("Index: " + args.getIndexFolder());
        System.out.println("Error: " + args.getMessage());
    }
});
 
// Creating or loading an index and adding to the index repository
Index index1 = new Index(indexFolder1);
indexRepository.addToRepository(index1);
 
// Creating or loading an index and adding to the index repository
Index index2 = new Index(indexFolder2);
indexRepository.addToRepository(index2);
 
// Adding documents to the index 1
index1.add(documentFolder1);
 
// Adding documents to the index 2
index2.add(documentFolder2);
 
// Changing, deleting, adding documents to document folders
// ...
 
// Updating all indexes in the repository
indexRepository.update();
 
// Searching in the repository
SearchResult result = indexRepository.search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search index repository

Path: /search/net/search-index-repository/

The [IndexRepository](https://reference.groupdocs.com/net/search/groupdocs.search/indexrepository) class can be used to combine several indexes into a group for searching all indexes at once. In addition, a single call to the [Update](https://reference.groupdocs.com/net/search/groupdocs.search/indexrepository/methods/update/index) method can update all indexes in the repository. And also the index repository serves as an event hub for all indexes in it. That is, you can subscribe to any events available for the index also through the index repository. However, note that indexing documents is performed separately for each index.

To start using the index repository, indexes must be created or loaded and added to an instance of the index repository. Examples of creating and adding indexes to the repository are presented below.

**C#**

```csharp
string indexFolder1 = @"c:\MyIndex1\";
string indexFolder2 = @"c:\MyIndex2\";
string documentsFolder1 = @"c:\MyDocuments1\";
string documentsFolder2 = @"c:\MyDocuments2\";
 
// Creating an index repository instance
IndexRepository indexRepository = new IndexRepository();
 
// Creating or loading an index and adding to the index repository
Index index1 = new Index(indexFolder1);
indexRepository.AddToRepository(index1);
 
// Creating an index via the index repository by calling a single method
Index index2 = indexRepository.Create(indexFolder2);
 
// Adding documents to the index 1
index1.Add(documentsFolder1);
 
// Adding documents to the index 2
index2.Add(documentsFolder2);
```

The following example shows how to subscribe to the repository events, update indexes in the repository, and search in the repository.

**C#**

```csharp
string indexFolder1 = @"c:\MyIndex1\";
string indexFolder2 = @"c:\MyIndex2\";
string documentFolder1 = @"c:\MyDocuments1\";
string documentFolder2 = @"c:\MyDocuments2\";
 
// Creating an index repository instance
IndexRepository indexRepository = new IndexRepository();
 
// Subscribing to an event
indexRepository.Events.ErrorOccurred += (sender, args) =>
{
    Console.WriteLine("Index: " + args.IndexFolder);
    Console.WriteLine("Error: " + args.Message);
};
 
// Creating or loading an index and adding to the index repository
Index index1 = new Index(indexFolder1);
indexRepository.AddToRepository(index1);
 
// Creating or loading an index and adding to the index repository
Index index2 = new Index(indexFolder2);
indexRepository.AddToRepository(index2);
 
// Adding documents to the index 1
index1.Add(documentFolder1);
 
// Adding documents to the index 2
index2.Add(documentFolder2);
 
// Changing, deleting, adding documents to document folders
// ...
 
// Updating all indexes in the repository
indexRepository.Update();
 
// Searching in the repository
SearchResult result = indexRepository.Search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search index repository

Path: /search/nodejs-java/search-index-repository/

The [IndexRepository](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexRepository) class can be used to combine several indexes into a group for searching all indexes at once. In addition, a single call to the [update](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexRepository#update()) method can update all indexes in the repository. And also the index repository serves as an event hub for all indexes in it. That is, you can subscribe to any events available for the index also through the index repository. However, note that indexing documents is performed separately for each index.

To start using the index repository, indexes must be created or loaded and added to an instance of the index repository. Examples of creating and adding indexes to the repository are presented below.

```javascript
String indexFolder1 = "c:\\MyIndex1\\";
String indexFolder2 = "c:\\MyIndex2\\";
String documentsFolder1 = "c:\\MyDocuments1\\";
String documentsFolder2 = "c:\\MyDocuments2\\";
 
// Creating an index repository instance
IndexRepository indexRepository = new IndexRepository();
 
// Creating or loading an index and adding to the index repository
Index index1 = new Index(indexFolder1);
indexRepository.addToRepository(index1);
 
// Creating an index via the index repository by calling a single method
Index index2 = indexRepository.create(indexFolder2);
 
// Adding documents to the index 1
index1.add(documentsFolder1);
 
// Adding documents to the index 2
index2.add(documentsFolder2);
```

The following example shows how to subscribe to the repository events, update indexes in the repository, and search in the repository.

```javascript
String indexFolder1 = "c:\\MyIndex1\\";
String indexFolder2 = "c:\\MyIndex2\\";
String documentFolder1 = "c:\\MyDocuments1\\";
String documentFolder2 = "c:\\MyDocuments2\\";
 
// Creating an index repository instance
IndexRepository indexRepository = new IndexRepository();
 
// Subscribing to an event
indexRepository.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
    public void invoke(Object sender, IndexErrorEventArgs args) {
        System.out.println("Index: " + args.getIndexFolder());
        System.out.println("Error: " + args.getMessage());
    }
});
 
// Creating or loading an index and adding to the index repository
Index index1 = new Index(indexFolder1);
indexRepository.addToRepository(index1);
 
// Creating or loading an index and adding to the index repository
Index index2 = new Index(indexFolder2);
indexRepository.addToRepository(index2);
 
// Adding documents to the index 1
index1.add(documentFolder1);
 
// Adding documents to the index 2
index2.add(documentFolder2);
 
// Changing, deleting, adding documents to document folders
// ...
 
// Updating all indexes in the repository
indexRepository.update();
 
// Searching in the repository
SearchResult result = indexRepository.search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search text in HTML documents

Path: /parser/java/search-text-in-html-documents/

To search a keyword in HTML documents [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in HTML document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null* value if search isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null*. For empty HTML document [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in HTML document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleHtml)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("Sub1");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method is used for the advanced search in HTML documents - like search with regular expressions.  [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in HTML document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in HTML document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleHtml)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("Sub[0-9]", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft OneNote sections

Path: /parser/java/search-text-in-microsoft-onenote-sections/

To search a keyword in Microsoft OneNote sections [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft OneNote section:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial section;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult "class in com.groupdocs.parser.data") objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null* value if search isn't supported for the section. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null*. For empty Microsoft OneNote section [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.  
{{< /alert >}}

The following example shows how to find a keyword in Microsoft OneNote section:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleOne)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("Age");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method is used for the advanced search in Microsoft OneNote sections - like search with regular expressions, search by pages etc.  [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in Microsoft OneNote section:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial section;
*   Instantiate  [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft OneNote section:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleOne)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("[0-9]{2}", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)
    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft OneNote sections

Path: /parser/net/search-text-in-microsoft-onenote-sections/

To search a keyword in Microsoft OneNote sections [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft OneNote section:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial section;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null* value if search isn't supported for the section. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null*. For empty Microsoft OneNote section [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns an empty collection.  
{{< /alert >}}

The following example shows how to find a keyword in Microsoft OneNote section:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
   
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in Microsoft OneNote sections - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in Microsoft OneNote section:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial section;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft OneNote section:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Set image resolution

Path: /viewer/java/optimization-pdf-set-max-resolution/

If the output PDF file contains images, you can reduce its resolution.

To allow changing the image resolution, set the [setCompressImages()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/#setCompressImages-boolean-) and [setResizeImages()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/#setResizeImages-boolean-) setters to `true` in the [PdfOptimizationOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions). The GroupDocs.Viewer compresses all images in the file. The [setMaxResolution()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/#setMaxResolution-int-) property determines the maximum resolution. 

The following code snippet shows how to reduce image resolution in the file:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    PdfOptimizationOptions optimizationOptions = new PdfOptimizationOptions();
    
    optimizationOptions.setCompressImages(true);
    optimizationOptions.setImageQuality(50);
    optimizationOptions.setResizeImages(true);
    optimizationOptions.setMaxResolution(100);
     
    viewOptions.setPdfOptimizationOptions(optimizationOptions);
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}

The following image demonstrates the result:

![Set max resolution](/viewer/java/images/pdf-rendering/optimization/optimization-pdf-set-max-resolution.png)

---

## Set image resolution

Path: /viewer/net/optimization-pdf-set-max-resolution/

If the output PDF file contains images, you can reduce its resolution.

To allow changing the image resolution, set the [CompressImages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/compressimages/) and [ResizeImages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/resizeimages/) properties to `true`. The GroupDocs.Viewer compresses all images in the file. The [MaxResolution](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/maxresolution/) property determines the maximum resolution. 

The following code snippet shows how to reduce image resolution in the file:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions
    {
        CompressImages = true,
        ImageQuality = 50,
        ResizeImages = true,
        MaxResolution = 100
    };
     
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions With {
                .CompressImages = True,
                .ImageQuality = 50,
                .ResizeImages = True,
                .MaxResolution = 100
                }

            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Set max resolution](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-set-max-resolution.png)

---

## Set image resolution

Path: /viewer/python-net/optimization-pdf-set-max-resolution/

If the output PDF file contains images, you can reduce its resolution.

To allow changing the image resolution, set the [compress_images](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) and [resize_images](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) properties to `True`. The GroupDocs.Viewer compresses all images in the file. The [max_resolution](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property determines the maximum resolution. 

The following code snippet shows how to reduce image resolution in the file:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def set_max_resolution():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("set_max_resolution/optimized_resolution.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.compress_images = True
        viewOptions.pdf_optimization_options.image_quality = 50
        viewOptions.pdf_optimization_options.resize_images = True
        viewOptions.pdf_optimization_options.max_resolution = 100

        viewer.view(viewOptions)

if __name__ == "__main__":
    set_max_resolution()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimize-images/optimization-pdf-set-max-resolution/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Set max resolution](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-set-max-resolution.png)

---

## Set password for output document

Path: /comparison/java/set-password-for-output-document/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to protect output document with password.

To protect output document, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object. Call the [setPasswordSaveOption()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setPasswordSaveOption-com.groupdocs.comparison.options.enums.PasswordSaveOption-) method and specify the `PasswordSaveOption.USER` value.
4.  Instantiate the [SaveOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.save/SaveOptions) object. Call the [setPassword()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.save/saveoptions/#setPassword-java.lang.String-) property to specify a password string.
5.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [SaveOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.save/SaveOptions) and [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) objects as parameters.

The following code snippet shows how to compare documents and protect the output document with password:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.enums.PasswordSaveOption;
import com.groupdocs.comparison.options.save.SaveOptions;
import java.nio.file.Path;
// ...


try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");

    CompareOptions compareOptions = new CompareOptions();
    compareOptions.setPasswordSaveOption(PasswordSaveOption.USER);
    SaveOptions saveOptions = new SaveOptions();
    saveOptions.setPassword("3333");
    final Path resultPath = comparer.compare("result.docx", saveOptions, compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Set password for output document

Path: /comparison/net/set-password-for-output-document/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to protect output document with password.

To protect output document, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object. Set the  [PasswordSaveOption](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions/properties/passwordsaveoption) to `PasswordSaveOption.User`.
4.  Instantiate the [SaveOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/saveoptions) object. Use the [Password](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/saveoptions/properties/password) property to specify a password string.
5.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare/index) method. Specify the [SaveOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/saveoptions) and [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) objects as parameters.

The following code snippet shows how to compare documents and protect the output document with password:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions cOptions = new CompareOptions
    {
        PasswordSaveOption = PasswordSaveOption.User
    };
    SaveOptions sOptions = new SaveOptions()
    {
        Password = "3333"
    };
    comparer.Compare("result.docx", sOptions, cOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Set password for output document

Path: /comparison/nodejs-java/set-password-for-output-document/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to protect the output document with a password.

The following code snippet shows how to compare two documents and protect the output document with a user password.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for the source, target, and password-protected result
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const outputFile = 'result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add the target document to the comparison session
comparer.add(targetFile);

// Configure comparison options to indicate that a user password will be set
const compareOptions = new groupdocs.CompareOptions();
compareOptions.setPasswordSaveOption(groupdocs.PasswordSaveOption.USER);

// Configure save options with the desired document password
const saveOptions = new groupdocs.SaveOptions();
saveOptions.setPassword('3333'); // password that will be required to open the result

// Run the comparison, applying both save and comparison options
comparer.compare(outputFile, saveOptions, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates both `CompareOptions` and `SaveOptions` objects. It sets `setPasswordSaveOption(PasswordSaveOption.USER)` in the `CompareOptions` to indicate that a user password will be applied, and sets the actual password using `setPassword('3333')` in the `SaveOptions`. When the comparison is performed with both options, the result document will be password-protected and require the specified password to open.

---

## Set password for output document

Path: /comparison/python-net/set-password-for-output-document/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to protect the output document with a password.

To protect the output document, follow these steps:

1.  Instantiate the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify the source document path or stream.
2.  Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method. Specify the target document path or stream.
3.  Instantiate the `CompareOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options/compareoptions/)--> object. Call the `password_save_option`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options/compareoptions/#setPasswordSaveOption-com.groupdocs.comparison.options.enums.PasswordSaveOption-)--> method and specify the `PasswordSaveOption.USER` value.
4.  Instantiate the `SaveOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.save/SaveOptions)--> object. Call the `password`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.save/saveoptions/#setPassword-java.lang.String-)--> property to specify a password string.
5.  Call the `compare()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#compare-java.lang.String-)--> method. Specify the `SaveOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.save/SaveOptions)--> and `CompareOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options/compareoptions)--> objects as parameters.

The following code snippet shows how to compare documents and protect the output document with a password:

```python
import groupdocs.comparison as gc

def set_password_for_resultant_document(output_file_path, source_file_path, target_file_path):
    try:
        # Initialize comparer with the source document
        with gc.Comparer(source_file_path) as comparer:
            # Add the target document for comparison
            comparer.add(target_file_path)
            
            # Set comparison options
            compare_options = gc.options.CompareOptions()
            compare_options.password_save_option = gc.options.PasswordSaveOption.USER
            
            # Set save options
            save_options = gc.options.SaveOptions()
            save_options.password = "3333"
            
            # Compare the documents and save the result
            comparer.compare(output_file_path, save_options, compare_options)
        
        # Log the success message with the output file path
        print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
    
    except Exception as error:
        # Error handling
        print(f'An error occurred during the document comparison: {error}')
```

---

## Sign documents with exception handling

Path: /signature/java/sign-documents-with-exception-handling/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides different error messages due to validation issues, missing required data, files etc. For exception class [GroupDocsSignatureException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/GroupDocsSignatureException) is being used.

Here are the steps to handle exceptions from GroupDocs.Signature:
*   Compose try-catch block above [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method with catching [GroupDocsSignatureException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/GroupDocsSignatureException) type error.
    

This example shows how to handle GroupDocs.Signature exceptions.

```java
try
{
    Signature signature = new Signature("sample.xlsx");
     
    DigitalSignOptions options = new DigitalSignOptions();
    options.setCertificateGuid("certificate.pfx");
    options.setImageFilePath("image.png");
    // skip password specification
    //options.setPassword("123456780");
         
    // sign document to file
    signature.sign("signed.xlsx", options);
 
}
catch (GroupDocsSignatureException ex)
{
    System.out.println("GroupDocs Signature Exception: " + ex.getMessage());
}
catch (Exception ex)
{
    System.out.println("System Exception: " + ex.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with extra Digital Signature properties

Path: /signature/java/sign-documents-with-extra-digital-signature-properties/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) contains [DigitalSignatureAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/DigitalSignatureAppearance) class that implements extra settings for digital signature of Word Processing and Spreadsheets documents

Base signature options [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) property [SignOptions.setAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setAppearance(com.groupdocs.signature.options.appearances.SignatureAppearance)) should be set with instance of [DigitalSignatureAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/DigitalSignatureAppearance) class to provide additional digital signature look

Here are the steps to setup extra image appearance with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
*   Compose object of[DigitalSignatureAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/DigitalSignatureAppearance) object with all required additional options.    
*   Set  [SignOptions.setAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setAppearance(com.groupdocs.signature.options.appearances.SignatureAppearance)) property with [DigitalSignatureAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/DigitalSignatureAppearance) object and set its properties  
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) to it.  
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.


This example shows how to setup extra digital signature appearance. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
Signature signature = new Signature("sample.docx");
DigitalSignOptions options = new DigitalSignOptions("certificate.pfx");
 
// certifiate password
options.setPassword("1234567890");
// digital certificate details
options.setReason("Sign");
options.setContact("JohnSmith");
options.setLocation("Office1");
 
// image as digital certificate appearance on document pages
options.setImageFilePath("sample.jpg");
//
options.setAllPages(true);
options.setWidth(0);
options.setHeight(60);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setBottom(10);
padding.setRight(10);
options.setMargin(padding);
// Setup signature line appearance.
// This appearance will add Signature Line on the first page.
// Could be useful for .xlsx files.
options.setAppearance(new DigitalSignatureAppearance("John Smith", "Title", "jonny@test.com"));
 
SignResult signResult = signature.sign("signed.docx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}


```

## Sign Pdf document with Text signature Sticker appearance

This example shows how to add Text signature to Pdf document with sticker look. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
Signature signature = new Signature("sample.docx");
{
    TextSignOptions options = new TextSignOptions("John Smith");

        // set signature position
    options.setLeft(100);
    options.setTop(100);
        // set signature rectangle
    options.setWidth(100);
    options.setHeight(30);
        // setup proper signature implementation
    options.setSignatureImplementation(TextSignatureImplementation.Sticker);
    PdfTextStickerAppearance appearance = new PdfTextStickerAppearance();
    // select sticker icon
    appearance.setIcon(PdfTextStickerIcon.Star);
    // setup if popup annotation will be opened by default
    appearance.setOpened(false);
    // text content of an annotation
    appearance.setContents("Sample");
    appearance.setSubject("Sample subject");
    appearance.setTitle("Sample Title");

    options.setAppearance(appearance);

        // set signature alignment
    options.setVerticalAlignment(VerticalAlignment.Bottom);
    options.setHorizontalAlignment(HorizontalAlignment.Right);
    Padding margin = new Padding();
    margin.setBottom(20);
    margin.setRight(20) ;
    options.setMargin(margin) ;

        // set text color and Font
    options.setForeColor(Color.RED);
    SignatureFont font =new SignatureFont();
    font.setSize(12);
    font.setFamilyName("Comic Sans MS");
    options.setFont(font);

    // sign document to file
    signature.sign("signed.docx", options);
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with extra Digital Signature properties

Path: /signature/net/sign-documents-with-extra-digital-signature-properties/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) contains [DigitalSignatureAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/digitalsignatureappearance) class that implements extra settings for digital signature of Word Processing and Spreadsheets documents

Base signature options [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) property [SignOptions.Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) should be set with instance of [DigitalSignatureAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/digitalsignatureappearance) class to provide additional digital signature look

Here are the steps to setup extra image appearance with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Compose object of[DigitalSignatureAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/digitalsignatureappearance) object with all required additional options.
* Set  [SignOptions.Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) property with [DigitalSignatureAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/digitalsignatureappearance) object and set its properties
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to setup extra digital signature look. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.docs"))
{
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // certifiate password
        Password = "1234567890",
        // digital certificate details
        Reason = "Sign",
        Contact = "JohnSmith",
        Location = "Office1",

        // image as digital certificate appearance on document pages
        ImageFilePath = imagePath,
        //
        AllPages = true,
        Width = 80,
        Height = 60,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() { Bottom = 10, Right = 10 },
        // Setup signature line appearance.
        // This appearance will add Signature Line on the first page.
        // Could be useful for .xlsx files.
        Appearance = new DigitalSignatureAppearance("John Smith", "Title", "jonny@test.com")

    };
    signature.Sign("signed.docx", options);
}


```

## Sign Pdf document with Text signature Sticker appearance

This example shows how to add Text signature to Pdf document with sticker look. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // setup proper signature implementation
        SignatureImplementation = TextSignatureImplementation.Sticker,
        Appearance = new PdfTextStickerAppearance()
        {
            // select sticker icon
            Icon = PdfTextStickerIcon.Star,
            // setup if popup annotation will be opened by default
            Opened = false,
            // text content of an annotation
            Contents = "Sample",
            Subject = "Sample subject",
            Title = "Sample Title"
        },
        // set signature alignment
        VerticalAlignment = Domain.VerticalAlignment.Bottom,
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Bottom = 20, Right = 20 },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
    };
    // sign document to file
    signature.Sign("signed.docx", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Single Row Image in Spreadsheet Document

Path: /assembly/java/single-row-image-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Spreadsheet Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Single Row in Microsoft Excel Document

### Creating a Single Row

Please follow below steps to create Single Row Image in MS Excel 2013:

1.  Create a new Workbook.
2.  Insert a desired shape to display image in it.
3.  Go to Insert Tab and select shape by clicking on Shape Icon.
4.  Write "Name" and "Age" to show name and age info of the customer.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent information of first single manager with the following key requirements:

*   Report must show image of the manager
*   It must show Name and age of manager
*   Report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="172" valign="top" style="width: 129.05pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><img width="153" height="142" src="" alt="<<image [manager.getPhoto()]>>"></p></td><td width="436" valign="top" style="width: 326.9pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><table class="MsoTable15Plain2" border="0" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="116" valign="top" style="width: 86.7pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="font-size: 16pt;">Name:</span></b></p></td><td width="305" valign="top" style="width: 228.9pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="font-size: 16pt;">&lt;&lt;[manager.getName()]&gt;&gt;</span></b></p></td></tr><tr><td width="116" valign="top" style="width: 86.7pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><b><span style="font-size: 16pt;">Age:</span></b></p></td><td width="305" valign="top" style="width: 228.9pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="font-size: 16pt;">&lt;&lt;[manager.getAge()]&gt;&gt;</span></p></td></tr></tbody></table><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"></p></td></tr></tbody></table>
### Download Single Row Template

Please download the sample Single Row document we created in this article:

*   [Single Row.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Single%20Row.xlsx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 7d0baf2bd25fa3d626e93d540a9395b4 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.

*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Single Row Image in Spreadsheet Document

Path: /assembly/net/single-row-image-in-spreadsheet-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Spreadsheet Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Single Row in Microsoft Excel Document

### Creating a Single Row

Please follow below steps to create Single Row Image in MS Excel 2013:

1.  Create a new Workbook.
2.  Insert a desired shape to display image in it.
3.  Go to Insert Tab and select shape by clicking on Shape Icon.
4.  Write "Name" and "Contact Number" to show name and contact info of the customer.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent information of first single customer with the following key requirements:

*   The report must show image of the customer
*   It must show Name and Contact Number of the customer
*   The report must be generated in the Spreadsheet Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 448.65pt;"><tbody><tr style="height: 26.05pt;"><td rowspan="5" style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 89.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;image [</span><span style="font-family: Calibri; font-size: 11pt;">custom</span><span style="font-family: Calibri; font-size: 11pt;">er.Photo</span><span style="font-family: Calibri; font-size: 11pt;">]&gt;&gt;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 51.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">Name:</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 274.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">customer.CustomerName</span><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">]&gt;&gt;</span></p></td></tr><tr style="height: 26.95pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 51.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 16pt; font-weight: bold;">Contact Details:</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 274.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 16pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 16pt;">customer.CustomerContactNumber</span><span style="font-family: Calibri; font-size: 16pt;">]&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 51.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 274.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 51.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 274.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr><tr><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 51.35pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 274.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Single Row Template

Please download the sample Single Row document we created in this article:

*   [Single Row.xlsx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Single%20Row.xlsx?raw=true)

{{< alert style="warning" >}}Use this template for DB, Dataset, JSON and XML examples also.{{< /alert >}}

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 4cc4984ca2a09fd077bd7e2eaa1471fa >}}

#### Database Entities

{{< gist GroupDocsGists f3106366af052816f0a60e48c1cd87b6 >}}

#### Using DataSet

{{< gist GroupDocsGists e19721979f9150765dfda0297650632e >}}

#### Using XML DataSource

{{< gist GroupDocsGists f3e709ad96eb960f1df35f5e8216ccf9 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists f469bbeb479689c41a5d4f34f5ab8c7a >}}

## Single Row in OpenOffice Spreadsheet Document

### Creating the Template

OpenDocument Spreadsheet (ODS) is a spreadsheet document format which can be used as an alternative to Microsoft Excel Document (XLS/XLSX) formats. Since ODS is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODS, please visit wikipedia article.

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Single Row' report in ODS format. Instead, we'll save the existing template to ODS format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Spreadsheet" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Single Row\_OpenDocument.ods](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Single%20Row_OpenDocument.ods?raw=true) (use same template for database, dataset, JSON and XML examples)

### Generating the report

#### Custom Objects

{{< gist GroupDocsGists 9d0ab85785b2075616f8921a68fcf537 >}}

#### Database Entities

{{< gist GroupDocsGists 422326d1b40a6c6dce06137f87438700 >}}

#### Using DataSet

{{< gist GroupDocsGists 8fc2d33306124472e1c31388962fc860 >}}

#### Using XML DataSource

{{< gist GroupDocsGists fd4a013148ae695961ab463c33236b50 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 786d0fcb27fff7c49e3b9463ba1ad2b8 >}}

### ODS Template and Report in Apache OpenOffice

In order to check compatibility of ODS between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODS template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.

*   We opened the ODS report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Specify rendering options for CAD files

Path: /viewer/java/specify-cad-rendering-options/

GroupDocs.Viewer ships with the [CadOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions) class that allows you to specify different options for [rendering CAD files](/viewer/java/render-cad-documents/). To access these options, use the [setCadOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setCadOptions-com.groupdocs.viewer.options.CadOptions-) methods for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

## Specify the background color

Use the [CadOptions.setBackgroundColor](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setBackgroundColor-java.awt.Color-) method to specify the background color for the output file. 

The following code snippet converts a CAD drawing to PDF and sets the background color of PDF pages to light yellow:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.CadOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Convert the document to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Specify the background color.
    viewOptions.getCadOptions().setBackgroundColor(Color.YELLOW);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Specify the background color for the output PDF file](/viewer/java/images/rendering-basics/render-cad-documents/set-background-color.png)

## Configure the output image size

When rendering a CAD drawing, GroupDocs.Viewer creates an image with the largest dimension (width or height) set to 2000 pixels. The other dimension is calculated based on the aspect ratio of the original drawing. You can use the following methods to change the width and height of the output file:

* [CadOptions.forRenderingByWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidth-int-)---Specifies the output image width in pixels. The image height is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.forRenderingByHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#forRenderingByHeight-int-)---Specifies the output image height in pixels. The image width is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.forRenderingByWidthAndHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidthAndHeight-int-int-)---Specifies the output image width and height in pixels. 
* [CadOptions.forRenderingByScaleFactor](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#forRenderingByScaleFactor-float-)---Specifies a scale factor to apply to the output image. Values between 0 and 1 decrease the image size, and values greater than 1 increase the image.

The following example converts a CAD drawing to PNG format and reduces the width and height of the output image by 50%:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
import com.groupdocs.viewer.options.CadOptions;
// ...

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    // Create a PNG image for the drawing.
    PngViewOptions viewOptions = new PngViewOptions("output.png");
    // Specify a scale factor.
    viewOptions.setCadOptions(CadOptions.forRenderingByScaleFactor(0.5f));
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

When you render all layouts/sheets contained in a CAD file (pass `true` to the [CadOptions.setRenderLayouts](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setRenderLayouts-boolean-) method), each layout/sheet is rendered as a separate page/image and has its own size. In this case, when you specify only the [width](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidth-int-) or [height](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#forRenderingByHeight-int-) value, the other side is scaled proportionally to maintain the aspect ratio of each layout/sheet. When you set both [width and height](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidthAndHeight-int-int-), all generated images have the same size and may look distorted. To avoid this, use the [CadOptions.setLayoutName](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setLayoutName-java.lang.String-) method to render each layout/sheet separately and set its size.

### Apply the PC3 file settings

AutoCAD allows you to configure plotter settings and save them as a PC3 file (Plotter Configuration Version 3) for later use. With GroupDocs.Viewer, you can apply width and height values from a PC3 file to the output file when you convert your CAD drawing to HTML, PDF, or image format. Use the [CadOptions.setPc3File](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setPc3File-java.lang.String-) method for a target view to specify a path to the PC3 file with required settings. The default location for PC3 files is "*C:\Users\\[Username]\\AppData\Roaming\Autodesk\AutoCAD [Version]\\[Version Code]\\[Language]\Plotters*".

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.CadOptions;
// ...

try (Viewer viewer = new Viewer("sample.dwg")) {
    // Convert the diagram to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Specify a path to the PC3 file.
    viewOptions.getCadOptions().setPc3File("small_page.pc3");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Split a drawing into tiles

With GroupDocs.Viewer, you can split a CAD drawing (in DWG or DWT format) into parts (_tiles_) and render each part separately. Tiled rendering allows you to reduce memory usage when you convert large drawings to HTML, PDF, or image format. When tiled rendering is enabled, GroupDocs.Viewer renders only the model space layout (_Model_) and ignores the [CadOptions.setRenderLayouts(...)](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setRenderLayouts-boolean-) and [CadOptions.setLayoutName(...)](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setLayoutName-java.lang.String-) property values.

![Split a CAD drawing into tiles](/viewer/java/images/rendering-basics/render-cad-documents/split-drawing-into-tiles.png)

To create an individual tile, instantiate a [Tile](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/tile/) object. Specify the x- and y-coordinates of the tile's lower-left corner and the tile width and height (in pixels). The image below illustrates a coordinate system used to define the tile position. The origin (0,0) is located in the lower-left corner of the drawing. The positive x-axis extends horizontally to the right, and the positive y-axis is oriented vertically from bottom to top.

![Tile coordinates](/viewer/java/images/rendering-basics/render-cad-documents/tile-coordinates.png)

After you create all tiles, add them using the [ViewOptions.getCadOptions().setTiles(...)](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/#setTiles-java.util.List-com.groupdocs.viewer.options.Tile--) method and call the [viewer.view(...)](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method to convert these tiles to a desired format. Each tile will be rendered as a separate page/image.

The following example demonstrates how to split a CAD drawing into four tiles (2x2) of equal size:

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.Tile;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ViewInfo;
// ...

ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();

try (Viewer viewer = new Viewer("HousePlan.dwg")) {
    ViewInfo viewInfo = viewer.getViewInfo(viewInfoOptions);

    // Get the width and height of the CAD drawing.
    int width = viewInfo.getPages().get(0).getWidth();
    int height = viewInfo.getPages().get(0).getHeight();

    // Calculate the width and height of each tile.
    int tileWidth = width / 2;
    int tileHeight = height / 2;

    int pointX = 0;
    int pointY = 0;

    // Split the drawing into tiles and convert them to HTML.
    // {0} is replaced with the tile number in the output file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
            
    Tile tile = new Tile(pointX, pointY, tileWidth, tileHeight);
    viewOptions.getCadOptions().getTiles().add(tile);

    pointX += tileWidth;
    tile = new Tile(pointX, pointY, tileWidth, tileHeight);
    viewOptions.getCadOptions().getTiles().add(tile);

    pointX = 0;
    pointY += tileHeight;
    tile = new Tile(pointX, pointY, tileWidth, tileHeight);
    viewOptions.getCadOptions().getTiles().add(tile);

    pointX += tileWidth;
    tile = new Tile(pointX, pointY, tileWidth, tileHeight);
    viewOptions.getCadOptions().getTiles().add(tile);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

In the example above the GroupDocs.Viewer will generate four HTML files named "page_1.html", "page_2.html", "page_3.html", and "page_4.html", where each of these HTML file contains a single tile in a form of SVG vector image. The [`HtmlViewOptions.forExternalResources()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) static method (with all its overloads) can also be used — in such case the SVG files will not be embedded inside the output HTML files, but will be saved separately, while HTML only references them through the `A` HTML element.

Prior to the version 24.10 of the GroupDocs.Viewer the tiled rendering of CAD files was available only for the HTML rendering. Starting from the version 24.10 the CAD tiled rendering is also supported for the PDF — in that case the GroupDocs.Viewer generates a single PDF file, where one its page represents one tile. So, if in the example above we replace the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) onto the [`PdfViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/), then the GroupDocs.Viewer will produce one PDF file with four pages inside it.


## Choose rendering speed instead of quality

By default, the GroupDocs.Viewer converts and renders all documents within CAD format family with the max possible quality. In case when the input CAD file (DWG, for example) is very complex, it may lead to quite significant processing time. Also, the size of the generated output HTML or image (vector or raster) also may be too heavy.

Starting from the version 24.10 the GroupDocs.Viewer introduces a new public property within the [`CadOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/) class — the `setEnablePerformanceConversionMode(...)` boolean flag. By default, it is set to `false` - the GroupDocs.Viewer behaves as in previous versions, preserving the maximum quality. But when setting its value to `true`, then the performance-oriented conversion mode is enabled, which leads to significantly lesser conversion time as well as lesser byte size of the output document.

Enabling this mode is pretty simple — just create an instance of the [`CadOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/cadoptions/) class by using any of the static methods and then set the value for the `setEnablePerformanceConversionMode(...)` property. Example is below:


{{< tabs "example5">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("input.dwg")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("Output-Page#{0}.html");
    viewOptions.setCadOptions(CadOptions.forRenderingByWidth(1000));
    viewOptions.getCadOptions().setEnablePerformanceConversionMode(true);

    viewer.view(viewOptions);
}
```
{{< /tab >}}

{{< /tabs >}}

If taking an ordinary DWG file as a sample, the comparison between "quality" and "performance" modes are the next:

| Conversion mode | Output file size, MiB | Processing time, sec |
| --- | --- | --- | --- | --- |
| Quality-oriented (default) | 46.8 | 7.87 |
| Performance-oriented (new) | 5.04 | 4.47 |

Screenshot below illustrates the visual differences between these modes, default quality-oriented mode is on the left side, and the new performance-oriented mode is on the right side:

![DWG quality vs. performance](/viewer/java/images/rendering-basics/render-cad-documents/dwg_comparison_quality_vs_performance.png)

---

## Specify rendering options for CAD files

Path: /viewer/net/specify-cad-rendering-options/

GroupDocs.Viewer ships with the [CadOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions) class that allows you to specify different options for [rendering CAD files](/viewer/net/render-cad-documents/). To access these options, use the [CadOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/cadoptions) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

## Specify the background color

Use the [CadOptions.BackgroundColor](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/backgroundcolor) property to specify the background color for the output file. 

The following code snippet converts a CAD drawing to PDF and sets the background color of PDF pages to light yellow:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Drawing;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("HousePlan.dwg"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");

    // Specify the background color.
    viewOptions.CadOptions.BackgroundColor = Argb32Color.Transparent;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Drawing
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("HousePlan.dwg")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
        
            ' Specify the background color.
            viewOptions.CadOptions.BackgroundColor = Argb32Color.Transparent
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Specify the background color for the output PDF file](/viewer/net/images/rendering-basics/render-cad-documents/set-background-color.png)

## Configure the output image size

<a name="ctors"></a>When rendering a CAD drawing, GroupDocs.Viewer creates an image with the largest dimension (width or height) set to 2000 pixels. The other dimension is calculated based on the aspect ratio of the original drawing. You can use the following methods to change the width and height of the output file:

* [CadOptions.ForRenderingByWidth](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/methods/forrenderingbywidth)---Specifies the output image width in pixels. The image height is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.ForRenderingByHeight](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/methods/forrenderingbyheight)---Specifies the output image height in pixels. The image width is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.ForRenderingByWidthAndHeigh](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/methods/forrenderingbywidthandheight)---Specifies the output image width and height in pixels. 
* [CadOptions.ForRenderingByScaleFactor](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/methods/forrenderingbyscalefactor)---Specifies a scale factor to apply to the output image. Values between 0 and 1 decrease the image size, and values greater than 1 increase the image.

The following example converts a CAD drawing to PNG format and reduces the width and height of the output image by 50%:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("HousePlan.dwg"))
{
    // Convert the diagram to PNG.
    var viewOptions = new PngViewOptions("output.png");
    // Specify a scale factor.
    viewOptions.CadOptions = CadOptions.ForRenderingByScaleFactor(0.5f);
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("HousePlan.dwg")
            ' Convert the diagram to PNG.
            Dim viewOptions = New PngViewOptions("output.png")
            ' Specify a scale factor.
            viewOptions.CadOptions = CadOptions.ForRenderingByScaleFactor(0.5F)
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

When you render all layouts/sheets contained in a CAD file (the [CadOptions.RenderLayouts](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/properties/renderlayouts) property is `true`), each layout/sheet is rendered as a separate page/image and has its own size. In this case, when you specify only the [width](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/methods/forrenderingbywidth) or [height](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/methods/forrenderingbyheight) value, the other side is scaled proportionally to maintain the aspect ratio of each layout/sheet. When you set both [width and height](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/methods/forrenderingbywidthandheight), all generated images have the same size and may look distorted. To avoid this, use the [CadOptions.LayoutName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/layoutname) property to render each layout/sheet separately and set its size.

### Apply the PC3 file settings

AutoCAD allows you to configure plotter settings and save them as a PC3 file (Plotter Configuration Version 3) for later use. With GroupDocs.Viewer, you can apply width and height values from a PC3 file to the output file when you convert your CAD drawing to HTML, PDF, or image format. Use the [CadOptions.Pc3File](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/pc3file) property for a target view to specify a path to the PC3 file with required settings. The default location for PC3 files is "*C:\Users\\[Username]\\AppData\Roaming\Autodesk\AutoCAD [Version]\\[Version Code]\\[Language]\Plotters*".

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.dwg"))
{
    // Convert the diagram to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify a path to the PC3 file.
    viewOptions.CadOptions.Pc3File = "small_page.pc3";
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.dwg")
            ' Convert the diagram to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify a path to the PC3 file.
            viewOptions.CadOptions.Pc3File = "small_page.pc3"
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Split a drawing into tiles

With GroupDocs.Viewer, you can split a CAD drawing (in DWG or DWT format) into parts (_tiles_) and render each part separately. Tiled rendering allows you to reduce memory usage when you convert large drawings to HTML, PDF, or image format. When tiled rendering is enabled, GroupDocs.Viewer renders only the model space layout (_Model_) and ignores the [CadOptions.RenderLayouts](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/properties/renderlayouts) and [CadOptions.LayoutName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions/properties/layoutname) property values.

![Split a CAD drawing into tiles](/viewer/net/images/rendering-basics/render-cad-documents/split-drawing-into-tiles.png)

To create an individual tile, instantiate a [Tile](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/tile) object. Specify the x- and y-coordinates of the tile's lower-left corner and the tile width and height (in pixels). The image below illustrates a coordinate system used to define the tile position. The origin (0,0) is located in the lower-left corner of the drawing. The positive x-axis extends horizontally to the right, and the positive y-axis is oriented vertically from bottom to top.

![Tile coordinates](/viewer/net/images/rendering-basics/render-cad-documents/tile-coordinates.png)

After you create all tiles, add them to the [ViewOptions.CadOptions.Tiles](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/cadoptions/properties/tiles) list and call the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view) method to convert these tiles to a desired format. Each tile will be rendered as a separate page/image.

The following example demonstrates how to split a CAD drawing into four tiles (2x2) of equal size:

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (var viewer = new Viewer("HousePlan.dwg"))
{
    var viewInfoOptions = ViewInfoOptions.ForHtmlView();
    var viewInfo = viewer.GetViewInfo(viewInfoOptions);

    // Get the width and height of the CAD drawing.
    int width = viewInfo.Pages[0].Width;
    int height = viewInfo.Pages[0].Height;

    // Specify the number of rows and columns to split the drawing into.
    int columns = 2;
    int rows = 2;

    // Calculate the width and height of each tile.
    int tileWidth = width / columns;
    int tileHeight = height / rows;
    int pointX = 0;
    int pointY = 0;

    // Split the drawing into tiles and convert them to HTML.
    // {0} is replaced with the tile number in the output file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    for (int i = 0; i < columns; i++)
        for (int j = 0; j < rows; j++)
        {
            Tile tile = new Tile(pointX + tileWidth * i, pointY + tileHeight * j,
                tileWidth, tileHeight);
            viewOptions.CadOptions.Tiles.Add(tile);
        }
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("HousePlan.dwg")
            Dim viewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo = viewer.GetViewInfo(viewInfoOptions)
        
            ' Get the width and height of the CAD drawing.
            Dim width As Integer = viewInfo.Pages(0).Width
            Dim height As Integer = viewInfo.Pages(0).Height
        
            ' Specify the number of rows and columns to split the drawing into.
            Dim columns As Integer = 2
            Dim rows As Integer = 2
        
            ' Calculate the width and height of each tile.
            Dim tileWidth As Integer = width / columns
            Dim tileHeight As Integer = height / rows
            Dim pointX As Integer = 0
            Dim pointY As Integer = 0
        
            ' Split the drawing into tiles and convert them to HTML.
            ' {0} is replaced with the tile number in the output file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            For i As Integer = 0 To columns - 1
                For j As Integer = 0 To rows - 1
                    Dim tile As Tile = New Tile(pointX + tileWidth * i, pointY + tileHeight * j, tileWidth, tileHeight)
                    viewOptions.CadOptions.Tiles.Add(tile)
                Next
            Next
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

In the example above the GroupDocs.Viewer will generate four HTML files named "page_1.html", "page_2.html", "page_3.html", and "page_4.html", where each of these HTML file contains a single tile in a form of SVG vector image. The [`HtmlViewOptions.ForExternalResources()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/forexternalresources/#forexternalresources) static method (with all its overloads) can also be used — in such case the SVG files will not be embedded inside the output HTML files, but will be saved separately, while HTML only references them through the `A` HTML element.

Prior the version 24.3 of the GroupDocs.Viewer the tiled rendering of CAD files was available only for the HTML rendering. Starting from the version 24.3 the CAD tiled rendering is also supported for the PDF — in that case the GroupDocs.Viewer generates a single PDF file, where one its page represents one tile. So, if in the example above we replace the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) onto the [`PdfViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions/), then the GroupDocs.Viewer will produce one PDF file with four pages inside it.

## Choose rendering speed  instead of quality

By default the GroupDocs.Viewer converts and renders all documents within CAD format family with the max possible quality. In case when the input CAD file (DWG, for example) is very complex, it may lead to quite significant processing time. Also, the size of the generated output HTML or image (vector or raster) also may be too heavy.

Starting from the version 24.2 the GroupDocs.Viewer introduces a new public property within the [`CadOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions) class — the `EnablePerformanceConversionMode` boolean flag. By default it is set to `false` - the GroupDocs.Viewer behaves as in previous versions, preserving the maximum quality. But when setting its value to `true`, then the performance-oriented conversion mode is enabled, which leads to significantly lesser conversion time as well as lesser byte size of the output document.

Enabling this mode is pretty simple — just create an instance of the [`CadOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/cadoptions) class by using [any of the static methods described above](#ctors), and then set the value for the `EnablePerformanceConversionMode` property. Example is below:


{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("input.dwg"))
{
   HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("Output-Page#{0}.html");                    
   viewOptions.CadOptions = CadOptions.ForRenderingByWidth(1000);
   viewOptions.CadOptions.EnablePerformanceConversionMode = true;

   viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET" >}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("input.dwg")
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")

            viewOptions.CadOptions = CadOptions.ForRenderingByWidth(1000)
            viewOptions.CadOptions.EnablePerformanceConversionMode = True

            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}

{{< /tabs >}}

If taking an ordinary DWG file as a sample, the comparison between "quality" and "performance" modes are the next:

| Conversion mode | Output file size, MiB | Processing time, sec |
| --- | --- | --- | --- | --- |
| Quality-oriented (default) | 46.8 | 7.87 |
| Performance-oriented (new) | 5.04 | 4.47 |

Screenshot below illustrates the visual differences between these modes, default quality-oriented mode is on the left side, and the new performance-oriented mode is on the right side:

![DWG quality vs. performance](/viewer/net/images/rendering-basics/render-cad-documents/dwg_comparison_quality_vs_performance.png)

---

## Specify rendering options for CAD files

Path: /viewer/nodejs-java/specify-cad-rendering-options/

GroupDocs.Viewer ships with the [CadOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions) class that allows you to specify different options for [rendering CAD files](/viewer/nodejs-java/render-cad-documents/). To access these options, use the [setCadOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/baseviewoptions/#setCadOptions-com.groupdocs.viewer.options.CadOptions-) methods for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

## Specify the background color

Use the [CadOptions.setBackgroundColor](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setBackgroundColor-java.awt.Color-) method to specify the background color for the output file. 

The following code snippet converts a CAD drawing to PDF and sets the background color of PDF pages to light yellow:

{{< tabs "render-cad-with-background-color">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';
import java from 'java';

const Color = java.import('java.awt.Color')

const viewer = new Viewer("HousePlan.dwg")
// Convert the document to PDF.
const viewOptions = PdfViewOptions("render-cad-with-background-color/dwg-to-pdf.pdf")
// Specify the background color.
viewOptions.getCadOptions().setBackgroundColor(Color.YELLOW)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/specify-rendering-options/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Specify the background color for the output PDF file](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/set-background-color.png)

## Configure the output image size

When rendering a CAD drawing, GroupDocs.Viewer creates an image with the largest dimension (width or height) set to 2000 pixels. The other dimension is calculated based on the aspect ratio of the original drawing. You can use the following methods to change the width and height of the output file:

* [CadOptions.forRenderingByWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidth-int-)---Specifies the output image width in pixels. The image height is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.forRenderingByHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#forRenderingByHeight-int-)---Specifies the output image height in pixels. The image width is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.forRenderingByWidthAndHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidthAndHeight-int-int-)---Specifies the output image width and height in pixels. 
* [CadOptions.forRenderingByScaleFactor](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#forRenderingByScaleFactor-float-)---Specifies a scale factor to apply to the output image. Values between 0 and 1 decrease the image size, and values greater than 1 increase the image.

The following example converts a CAD drawing to PNG format and reduces the width and height of the output image by 50%:

{{< tabs "render-cad-with-scale-factor">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions, CadOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
// Create a PNG image for the drawing.
const viewOptions = PngViewOptions("render-cad-with-scale-factor/dwg-to-png.png")
// Specify a scale factor.
viewOptions.setCadOptions(
    CadOptions.forRenderingByScaleFactor(0.5)
)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/specify-rendering-options/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

When you render all layouts/sheets contained in a CAD file (pass `true` to the [CadOptions.setRenderLayouts](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setRenderLayouts-boolean-) method), each layout/sheet is rendered as a separate page/image and has its own size. In this case, when you specify only the [width](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidth-int-) or [height](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#forRenderingByHeight-int-) value, the other side is scaled proportionally to maintain the aspect ratio of each layout/sheet. When you set both [width and height](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#forRenderingByWidthAndHeight-int-int-), all generated images have the same size and may look distorted. To avoid this, use the [CadOptions.setLayoutName](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setLayoutName-java.lang.String-) method to render each layout/sheet separately and set its size.

### Apply the PC3 file settings

AutoCAD allows you to configure plotter settings and save them as a PC3 file (Plotter Configuration Version 3) for later use. With GroupDocs.Viewer, you can apply width and height values from a PC3 file to the output file when you convert your CAD drawing to HTML, PDF, or image format. Use the [CadOptions.setPc3File](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setPc3File-java.lang.String-) method for a target view to specify a path to the PC3 file with required settings. The default location for PC3 files is "*C:\Users\\[Username]\\AppData\Roaming\Autodesk\AutoCAD [Version]\\[Version Code]\\[Language]\Plotters*".

{{< tabs "render-cad-with-pc3-file">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.dwg")
// Convert the diagram to PDF.
const viewOptions = PdfViewOptions("render-cad-with-pc3-file/dwg-to-pdf.pdf")
// Specify a path to the PC3 file.
viewOptions.getCadOptions().setPc3File("small_page.pc3")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/specify-rendering-options/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Split a drawing into tiles

With GroupDocs.Viewer, you can split a CAD drawing (in DWG or DWT format) into parts (_tiles_) and render each part separately. Tiled rendering allows you to reduce memory usage when you convert large drawings to HTML, PDF, or image format. When tiled rendering is enabled, GroupDocs.Viewer renders only the model space layout (_Model_) and ignores the `CadOptions.RenderLayouts` and `CadOptions.LayoutName` property values.

![Split a CAD drawing into tiles](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/split-drawing-into-tiles.png)

To create an individual tile, instantiate a [Tile](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/tile/) object. Specify the x- and y-coordinates of the tile's lower-left corner and the tile width and height (in pixels). The image below illustrates a coordinate system used to define the tile position. The origin (0,0) is located in the lower-left corner of the drawing. The positive x-axis extends horizontally to the right, and the positive y-axis is oriented vertically from bottom to top.

![Tile coordinates](/viewer/nodejs-java/images/rendering-basics/render-cad-documents/tile-coordinates.png)

After you create all tiles, add them using the [ViewOptions.getCadOptions().setTiles](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/cadoptions/#setTiles-java.util.List-com.groupdocs.viewer.options.Tile--) method and call the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method to convert these tiles to a desired format. Each tile will be rendered as a separate page/image.

The following example demonstrates how to split a CAD drawing into four tiles (2x2) of equal size:

{{< tabs "render-cad-split-into-tiles">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions, ViewInfoOptions, Tile } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("HousePlan.dwg")
  
const viewInfoOptions = ViewInfoOptions.forHtmlView()
const viewInfo = viewer.getViewInfo(viewInfoOptions)

// Get the width and height of the CAD drawing.
const width = viewInfo.getPages().get(0).getWidth()
const height = viewInfo.getPages().get(0).getHeight()

// Calculate the width and height of each tile.
let tileWidth = Math.floor(width / 2)
let tileHeight = Math.floor(height / 2)

let pointX = 0
let pointY = 0

// Split the drawing into tiles and convert them to HTML.
// {0} is replaced with the tile number in the output file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-cad-split-into-tiles/dwg-to-html-page_{0}.html")
            
let tile = new Tile(pointX, pointY, tileWidth, tileHeight)
viewOptions.getCadOptions().getTiles().add(tile)

pointX += tileWidth
tile = new Tile(pointX, pointY, tileWidth, tileHeight)
viewOptions.getCadOptions().getTiles().add(tile)

pointX = 0
pointY += tileHeight
tile = new Tile(pointX, pointY, tileWidth, tileHeight)
viewOptions.getCadOptions().getTiles().add(tile)

pointX += tileWidth
tile = new Tile(pointX, pointY, tileWidth, tileHeight)
viewOptions.getCadOptions().getTiles().add(tile)

viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "HousePlan.dwg" >}}
{{< tab-text >}}
`HousePlan.dwg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/rendering-cad-documents/specify-rendering-options/HousePlan.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Specify rendering options for CAD files

Path: /viewer/python-net/specify-cad-rendering-options/

GroupDocs.Viewer ships with the [CadOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions) class that allows you to specify different options for [rendering CAD files](/viewer/python-net/render-cad-documents/). To access these options, use the [CadOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

## Specify the background color

Use the [cad_options.background_color](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) property to specify the background color for the output file. 

The following code snippet converts a CAD drawing to PDF and sets the background color of PDF pages to light yellow:

{{< tabs "example1">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions
from groupdocs.viewer.drawing import Argb32Color

def set_background_color():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        viewOptions = PdfViewOptions("set_background_color/background_color.pdf")
        viewOptions.cad_options.background_color = Argb32Color.from_rgb(255, 255, 0)  # RGB color for yellow
        viewer.view(viewOptions)

if __name__ == "__main__":
    set_background_color()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Specify the background color for the output PDF file](/viewer/net/images/rendering-basics/render-cad-documents/set-background-color.png)

## Configure the output image size

<a name="ctors"></a>When rendering a CAD drawing, GroupDocs.Viewer creates an image with the largest dimension (width or height) set to 2000 pixels. The other dimension is calculated based on the aspect ratio of the original drawing. You can use the following methods to change the width and height of the output file:

* [CadOptions.for_rendering_by_width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#methods)---Specifies the output image width in pixels. The image height is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.for_rendering_by_height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#methods)---Specifies the output image height in pixels. The image width is calculated based on the aspect ratio of the original CAD drawing.
* [CadOptions.for_rendering_by_width_and_height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#methods)---Specifies the output image width and height in pixels. 
* [CadOptions.for_rendering_by_scale_factor](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#methods)---Specifies a scale factor to apply to the output image. Values between 0 and 1 decrease the image size, and values greater than 1 increase the image.

The following example converts a CAD drawing to PNG format and reduces the width and height of the output image by 50%:

{{< tabs "example2">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions, CadOptions

def set_image_size():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Convert the diagram to PNG.
        png_options = PngViewOptions("set_image_size/image_with_size_limits.pdf")
        # Specify a scale factor.
        png_options.cad_options = CadOptions.for_rendering_by_scale_factor(0.5)      
        viewer.view(png_options)

if __name__ == "__main__":
    set_image_size()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

When you render all layouts/sheets contained in a CAD file (the [CadOptions.render_layouts](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) property is `True`), each layout/sheet is rendered as a separate page/image and has its own size. In this case, when you specify only the [width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#methods) or [height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#methods) value, the other side is scaled proportionally to maintain the aspect ratio of each layout/sheet. When you set both [width and height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#methods), all generated images have the same size and may look distorted. To avoid this, use the [CadOptions.layout_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) property to render each layout/sheet separately and set its size.

### Apply the PC3 file settings

AutoCAD allows you to configure plotter settings and save them as a PC3 file (Plotter Configuration Version 3) for later use. With GroupDocs.Viewer, you can apply width and height values from a PC3 file to the output file when you convert your CAD drawing to HTML, PDF, or image format. Use the [CadOptions.pc_3_file](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) property for a target view to specify a path to the PC3 file with required settings. The default location for PC3 files is "*C:\Users\\[Username]\\AppData\Roaming\Autodesk\AutoCAD [Version]\\[Version Code]\\[Language]\Plotters*".

{{< tabs "example3">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def apply_pc3_file():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        # Convert the diagram to PDF.
        viewOptions = PdfViewOptions("apply_pc3_file/apply_pc3_file.pdf")
        # Specify a path to the PC3 file.
        viewOptions.cad_options.pc_3_file = "small_page.pc3"
        viewer.view(viewOptions)

if __name__ == "__main__":
    apply_pc3_file()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "small_page.pc3" >}}
{{< tab-text >}}
`small_page.pc3` is the PC3 configuration file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/small_page.pc3) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Split a drawing into tiles

With GroupDocs.Viewer, you can split a CAD drawing (in DWG or DWT format) into parts (_tiles_) and render each part separately. Tiled rendering allows you to reduce memory usage when you convert large drawings to HTML, PDF, or image format. When tiled rendering is enabled, GroupDocs.Viewer renders only the model space layout (_Model_) and ignores the [CadOptions.render_layouts](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) and [CadOptions.layout_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) property values.

![Split a CAD drawing into tiles](/viewer/net/images/rendering-basics/render-cad-documents/split-drawing-into-tiles.png)

To create an individual tile, instantiate a [Tile](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/tile) object. Specify the x- and y-coordinates of the tile's lower-left corner and the tile width and height (in pixels). The image below illustrates a coordinate system used to define the tile position. The origin (0,0) is located in the lower-left corner of the drawing. The positive x-axis extends horizontally to the right, and the positive y-axis is oriented vertically from bottom to top.

![Tile coordinates](/viewer/net/images/rendering-basics/render-cad-documents/tile-coordinates.png)

After you create all tiles, add them to the [ViewOptions.CadOptions.tiles](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions/#properties) list and call the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert these tiles to a desired format. Each tile will be rendered as a separate page/image.

The following example demonstrates how to split a CAD drawing into four tiles (2x2) of equal size:

{{< tabs "example4">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions, HtmlViewOptions, Tile

def split_drawing_into_tiles():
    # Load CAD file
    with Viewer("sample.dwg") as viewer:
        viewInfoOptions = ViewInfoOptions.for_html_view()
        viewInfo = viewer.get_view_info(viewInfoOptions)

        # Get the width and height of the CAD drawing.
        width = viewInfo.pages[0].width
        height = viewInfo.pages[0].height

        # Specify the number of rows and columns to split the drawing into.
        columns = 2
        rows = 2

        # Calculate the width and height of each tile.
        tile_width = width / columns
        tile_height = height / rows
        point_x = 0
        point_y = 0

        # Split the drawing into tiles and convert them to HTML.
        # {0} is replaced with the tile number in the output file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("split_drawing_into_tiles/drawing_into_tiles_{0}.html")
        for i in range(0, columns):
            for j in range(0, rows):
                tile = Tile(point_x + tile_width * i, point_y + tile_height * j, tile_width, tile_height)
                viewOptions.cad_options.tiles.append(tile)
        viewer.view(viewOptions)

if __name__ == "__main__":
    split_drawing_into_tiles()
```
{{< /tab >}}
{{< tab "sample.dwg" >}}
{{< tab-text >}}
`sample.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/sample.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

In the example above the GroupDocs.Viewer will generate four HTML files named "page_1.html", "page_2.html", "page_3.html", and "page_4.html", where each of these HTML file contains a single tile in a form of SVG vector image. The [`HtmlViewOptions.for_external_resources()`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) static method (with all its overloads) can also be used — in such case the SVG files will not be embedded inside the output HTML files, but will be saved separately, while HTML only references them through the `A` HTML element.

Starting from this 24.9 version the CAD tiled rendering is also supported for the PDF — in that case the GroupDocs.Viewer generates a single PDF file, where one its page represents one tile. So, if in the example above we replace the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) onto the [`PdfViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/), then the GroupDocs.Viewer will produce one PDF file with four pages inside it.

## Choose rendering speed  instead of quality

By default the GroupDocs.Viewer converts and renders all documents within CAD format family with the max possible quality. In case when the input CAD file (DWG, for example) is very complex, it may lead to quite significant processing time. Also, the size of the generated output HTML or image (vector or raster) also may be too heavy.

Starting from this version 24.9 the GroupDocs.Viewer introduces a new public property within the [`CadOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions) class — the `enable_performance_conversion_mode` boolean flag. By default it is set to `False` - the GroupDocs.Viewer behaves as in previous versions, preserving the maximum quality. But when setting its value to `True`, then the performance-oriented conversion mode is enabled, which leads to significantly lesser conversion time as well as lesser byte size of the output document.

Enabling this mode is pretty simple — just create an instance of the [`CadOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/cadoptions) class by using [any of the static # described above](#ctors), and then set the value for the `enable_performance_conversion_mode` property. Example is below:


{{< tabs "example5">}}
{{< tab "Python">}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, CadOptions

def enable_performance_mode():
    # Load CAD file
    with Viewer("input.dwg") as viewer:
        viewOptions = HtmlViewOptions.for_embedded_resources("enable_performance_mode/Output-Page#{0}.html")
        viewOptions.cad_options = CadOptions.for_rendering_by_width(1000)
        viewOptions.cad_options.enable_performance_conversion_mode = True

        viewer.view(viewOptions)

if __name__ == "__main__":
    enable_performance_mode()
```
{{< /tab >}}
{{< tab "input.dwg" >}}
{{< tab-text >}}
`input.dwg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-cad-documents/input.dwg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

If taking an ordinary DWG file as a sample, the comparison between "quality" and "performance" modes are the next:

| Conversion mode | Output file size, MiB | Processing time, sec |
| --- | --- | --- | --- | --- |
| Quality-oriented (default) | 46.8 | 7.87 |
| Performance-oriented (new) | 5.04 | 4.47 |

Screenshot below illustrates the visual differences between these modes, default quality-oriented mode is on the left side, and the new performance-oriented mode is on the right side:

![DWG quality vs. performance](/viewer/net/images/rendering-basics/render-cad-documents/dwg_comparison_quality_vs_performance.png)

---

## Split a worksheet into pages

Path: /viewer/java/split-worksheet-into-pages/


**Spreadsheet** document, also known as a _workbook_, is basically a set of _worksheets_, represented as tabs in most table processing software like Microsoft Excel. Some spreadsheet formats may have only a single worksheet; this includes, for example, all text-based separator-delimited formats ([CSV](https://docs.fileformat.com/spreadsheet/csv/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/) etc.).

Size (dimensions) of a worksheet may be big, and even huge. For example, the now obsolete [XLS](https://docs.fileformat.com/spreadsheet/xls/) format supports [max 256 columns and 65536 rows](https://superuser.com/questions/366468/what-is-the-maximum-allowed-rows-in-a-microsoft-excel-xls-or-xlsx). The newer [XLSX (Office Open XML Workbook)](https://docs.fileformat.com/spreadsheet/xlsx/) format and the Microsoft Excel both [support up to 16384 columns and 1048576 rows](https://support.microsoft.com/en-us/office/excel-specifications-and-limits-1672b34d-7043-467e-8e27-269d656771c3).

On the other hand, the principle of the GroupDocs.Viewer is to render (convert) input document formats (including the Spreadsheet documents) to the pages, where the page may be defined as a rectangular area of relatively small size, comparable to the area of display, or A4 paper. And here a potentially huge worksheet size has a conflict with relatively small page size. How to display a worksheet with 1 million rows on a single page? Maybe split it on several pages, but if yes, then how? This question has no single direct answer, there are different ways to solve that, and this article explains all the ways available using the GroupDocs.Viewer.

## Render a worksheet on one page

The most simple way — render the content of the whole worksheet on a single page, where page size will be adjusted to fit the whole amount of rows and columns. This is a good choice when it is already known that the worksheet has a small size. However, if a worksheet is really big, this approach may lead to awful results. In particular, when rendering to the HTML format, the resultant HTML document may be huge, tens or even hundreds of [MiB](https://en.wikipedia.org/wiki/Byte#Multiple-byte_units), which may cause troubles while viewing such big files in the web-browsers. When rendering to the JPEG format, things may be even worse if the width or height will overcome the max limit of 65535 pixels. So use this mode deliberately.

For displaying a whole worksheet in one page call the [`SpreadsheetOptions.forOnePagePerSheet()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#forOnePagePerSheet--) static method, which returns an instance of the [`SpreadsheetOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/), already tuned for this. Then assign this instance to the [`ViewOptions.getSpreadsheetOptions()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#getSpreadsheetOptions--) property and view the spreadsheet using this view options instance.

The following example takes a spreadsheet on input, and converts it to the resultant PDF file, where every worksheet from input XLSX is rendered to one page in output PDF.

{{< tabs "code-example">}}
{{< tab "RenderAWorksheetOnOnePage.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

public class RenderAWorksheetOnOnePage {
    public static void render() {
        // Create PDF view options for rendering to PDF
        PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

        // Create spreadsheet options to render each worksheet to one page
        viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forOnePagePerSheet());

        // Create a Viewer instance and specify the input XLSX
        try (Viewer viewer = new Viewer("Products.xlsx"))
        {
            // Render the XLSX to PDF
            viewer.view(viewOptions);
        }
    }

    public static void main(String[] args){
        render();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The screenshot below illustrates the result. The output PDF file contains one page (because input XLSX has one worksheet) that displays all worksheet data.

![Fit sheet on one page](/viewer/java/images/rendering-basics/render-spreadsheets/render-on-one-page.png)

## Split worksheet by page breaks

Microsoft Excel itself adds automatic page breaks based on paper size and page settings, such as orientation and margins. If you switch to the _"View"_ tab and enter the _"Page Break Preview"_ mode, you can see blue lines that divide the whole worksheet area on rectangular chunks, each of them is labeled as "Page 1", "Page 2", and so on. This is how Microsoft Excel "suggests" to split a worksheet onto pages.

In the image below, the vertical page break is inserted after the column “**E**”, and the horizontal page break is located under the row “**30**”. If you go to the _“Page Layout”_ tab, and then change the values of _“Orientation”_ and/or _“Size”_ tiles, you can see how Microsoft Excel will recalculate page areas on the fly.

![Preview page breaks in Microsoft Excel](/viewer/java/images/rendering-basics/render-spreadsheets/excel-page-break-preview.png)

For achieving the same behavior with GroupDocs.Viewer call the [`SpreadsheetOptions.forRenderingByPageBreaks()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#forRenderingByPageBreaks--) static method, and then assign its value to the [`ViewOptions.getSpreadsheetOptions()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#getSpreadsheetOptions--) property, as in the first example. The following code example shows this:

{{< tabs "code-example1">}}
{{< tab "SplitWorksheetByPageBreaks.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

public class SplitWorksheetByPageBreaks {
    public static void render() {
        // Create PDF view options for rendering to PDF
        PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

        // Create spreadsheet options to split worksheet onto pages by page breaks
        viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingByPageBreaks());

        // Create a Viewer instance and specify the input XLSX
        try (Viewer viewer = new Viewer("Products.xlsx"))
        {
            // Render the XLSX to PDF
            viewer.view(viewOptions);
        }
    }

    public static void main(String[] args){
        render();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result — you can compare it with a screenshot above and note that worksheet content is splitted exactly as Microsoft Excel suggests.

![Render a worksheet to PDF based on page breaks](/viewer/java/images/rendering-basics/render-spreadsheets/render-by-page-breaks.png)

## Render only print area

Along with the page breaks, the Microsoft Excel has a “Print Area” concept. Print Area is actually one or more cell ranges in a worksheet, which are designated for printing, while any content outside of the Print Area will not be printed at all. For adding some cell range to the Print Area, go to the “Page Layout" tab, click on the _“Print Area”_ button and then click on _“Set Print Area”_ item (see screenshot below). In order to add another cell range to the Print Area, select this new range, click on the _“Print Area”_ button and then click on _“Add to Print Area”_ item at this time. In the “Page Break Preview” mode you can see all cell ranges in the Print Area.

![Specify a print area in Microsoft Excel](/viewer/java/images/rendering-basics/render-spreadsheets/excel-set-print-area.png)

GroupDocs.Viewer also supports this option — in that case each cell range within the print area will be placed on a separate page. For achieving this call the [`SpreadsheetOptions.forRenderingPrintArea()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#forRenderingPrintArea--) static method and assign the returned [`SpreadsheetOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/) instance to the [`ViewOptions.getSpreadsheetOptions()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#getSpreadsheetOptions--) property. The following example shows how to do this.

{{< tabs "code-example2">}}
{{< tab "RenderOnlyPrintArea.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

public class RenderOnlyPrintArea {
    public static void render() {
        // Create PDF view options for rendering to PDF
        PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

        // Create spreadsheet options to render a Print Area only
        viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingPrintArea());

        // Create a Viewer instance and specify the input XLSX
        try (Viewer viewer = new Viewer("Invoice.xlsx"))
        {
            // Render the XLSX to PDF
            viewer.view(viewOptions);
        }
    }

    public static void main(String[] args){
        render();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render the print area to PDF](/viewer/java/images/rendering-basics/render-spreadsheets/render-print-area.png)

## Render print area and split by page breaks

GroupDocs.Viewer has a unique feature — combining the Print Area and page breaks in the single mode. In this case GroupDocs.Viewer takes into account all cell ranges of print area and page breaks in the worksheet and applies them simultaneously to split a worksheet onto pages.

For doing that call the [`SpreadsheetOptions.forRenderingPrintAreaAndPageBreaks()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#forRenderingPrintAreaAndPageBreaks--) static method and assign the returned [`SpreadsheetOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/) instance to the [`ViewOptions.getSpreadsheetOptions()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#getSpreadsheetOptions--) property.

In the following screenshot the red line shows the print area, and the blue line shows page breaks.

![Specify page breaks and a print area in Microsoft Excel](/viewer/java/images/rendering-basics/render-spreadsheets/page-breake-vs-print-area.png)

The following example renders the Microsoft Excel spreadsheet using page breaks and print areas displayed in the screenshot above to PDF:

{{< tabs "code-example3">}}
{{< tab "RenderPrintAreaAndSplitByPageBreaks.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

public class RenderPrintAreaAndSplitByPageBreaks {
    public static void render() {
        // Create PDF view options for rendering to PDF
        PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

        // Render a Print Area and split by page breaks
        viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingPrintAreaAndPageBreaks());

        // Create a Viewer instance and specify the input XLSX
        try (Viewer viewer = new Viewer("Products.xlsx"))
        {
            // Render the XLSX to PDF
            viewer.view(viewOptions);
        }
    }

    public static void main(String[] args){
        render();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The screenshot below illustrates the result:

![Render page breaks and a print area to PDF](/viewer/java/images/rendering-basics/render-spreadsheets/pdf-result.png)

## Split worksheet into pages manually by rows and columns

Sometimes none of the splitting methods, described above, is acceptable, or the spreadsheet has a format that does not support page breaks and Print Areas, for example, the text-based CSV. For such cases GroupDocs.Viewer allows to manually specify the number of rows and/or number of columns that should be present on every page. In short, the difference between splitting by rows only vs. splitting by rows and columns is illustrated on screenshot below.

![Split by rows only vs. split by rows and columns](/viewer/java/sample-files/split-worksheets-into-pages/split-by-rows-and-split-by-rows-and-columns.png)

### Split worksheet into pages only by rows

When a worksheet is tall, but narrow, i.e. it has some moderate amount of columns, but huge amount of rows, it is ideal to split such a worksheet horizontally, by rows. In this case the user should specify a number of rows per single page in the [`SpreadsheetOptions.forSplitSheetIntoPages(int countRowsPerPage)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#forSplitSheetIntoPages-int-) static method, and then all as usual. The number of rows per page must be strictly greater than zero. The code sample is below, it specifies 15 rows per one page.

{{< tabs "code-example4">}}
{{< tab "SplitWorksheetIntoPagesOnlyByRows.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

public class SplitWorksheetIntoPagesOnlyByRows {
    public static void render() {
        // Create PDF view options for rendering to PDF
        PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

        // Specify number of rows for every page
        int rowsPerPage = 15;

        // Create spreadsheet options to split worksheet by number of rows
        viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forSplitSheetIntoPages(rowsPerPage));

        // Create a Viewer instance and specify the input XLSX
        try (Viewer viewer = new Viewer("two-pages.xlsx"))
        {
            // Render the XLSX to PDF
            viewer.view(viewOptions);
        }
    }

    public static void main(String[] args){
        render();
    }
}
```
{{< /tab >}}
{{< tab "two-pages.xlsx" >}}  
{{< tab-text >}}
`two-pages.xlsx` is sample file used in this example. Click [here](/viewer/java/sample-files/split-worksheets-into-pages/two-pages.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "output.pdf" >}}  
{{< tab-text >}}
`output.pdf` is rendered Pdf document. Click [here](/viewer/java/sample-files/split-worksheets-into-pages/SplitWorksheetIntoPagesOnlyByRows/output.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The screenshot below demonstrates the original XLSX spreadsheet, conditionally divided onto chucks with 15 rows in each, and output PDF file, produced by the GroupDocs.Viewer.

![Break a worksheet into two pages](/viewer/java/images/rendering-basics/render-spreadsheets/render-two-pages.png)

### Split worksheet into pages by rows and columns

When a worksheet is tall and wide, i.e. it has a big amount of columns and rows, then need to split such a worksheet horizontally and vertically simultaneously. The previously mentioned [`forSplitSheetIntoPages`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#forSplitSheetIntoPages-int-) static method has an overload, that obtained two arguments — number of rows and number of columns: [`forSplitSheetIntoPages(int countRowsPerPage, int countColumnsPerPage)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#forSplitSheetIntoPages-int-int-). The number of rows and columns per page must be strictly greater than zero. The following sample demonstrates splitting the worksheets into pages with 15 rows and 7 columns per each. This code sample uses a file "`four-pages.xlsx`", that can be downloaded [here](/viewer/java/sample-files/split-worksheets-into-pages/four-pages.xlsx).

{{< tabs "code-example5">}}
{{< tab "SplitWorksheetIntoPagesByRowsAndColumns.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

public class SplitWorksheetIntoPagesByRowsAndColumns {
    public static void render() {
        // Create PDF view options for rendering to PDF
        PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

        // Specify number of rows and columns for every page
        int rowsPerPage = 15;
        int columnsPerPage = 7;

        // Create spreadsheet options to split worksheet by number of rows and columns
        viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forSplitSheetIntoPages(rowsPerPage, columnsPerPage));

        // Create a Viewer instance and specify the input XLSX
        try (Viewer viewer = new Viewer("four-pages.xlsx"))
        {
            // Render the XLSX to PDF
            viewer.view(viewOptions);
        }
    }

    public static void main(String[] args){
        render();
    }
}
```
{{< /tab >}}
{{< tab "four-pages.xlsx" >}}  
{{< tab-text >}}
`four-pages.xlsx` is sample file used in this example. Click [here](/viewer/java/sample-files/split-worksheets-into-pages/four-pages.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "output.pdf" >}}  
{{< tab-text >}}
`output.pdf` is rendered Pdf document. Click [here](/viewer/java/sample-files/split-worksheets-into-pages/SplitWorksheetIntoPagesByRowsAndColumns/output.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The screenshot below demonstrates the original XLSX spreadsheet, conditionally divided onto chucks with 15 rows and 7 columns (A-G and H-N) in each, and output PDF file, produced by the GroupDocs.Viewer.

![Break a worksheet into four pages](/viewer/java/images/rendering-basics/render-spreadsheets/render-four-pages.png)

## Conclusion

This article shows that GroupDocs.Viewer provides different ways to split a worksheet into pages in order to satisfy the widest variety of use-cases. Please note that all these features were added to the GroupDocs.Viewer gradually, piece by piece, so if you're using some obsolete version of the library, released before year 2023, some of the described features may be missing. Also keep in mind that we're open to new suggestions and ideas how a worksheet can be splitted on pages, so you are welcome to share your thoughts on our [forum](https://forum.groupdocs.com/c/viewer/9).
---

## Split a worksheet into pages

Path: /viewer/net/split-worksheet-into-pages/


**Spreadsheet** document, also known as a _workbook_, is basically a set of _worksheets_, represented as tabs in most table processing software like Microsoft Excel. Some spreadsheet formats may have only a single worksheet; this includes, for example, all text-based separator-delimited formats ([CSV](https://docs.fileformat.com/spreadsheet/csv/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/) etc.).

Size (dimensions) of a worksheet may be big, and even huge. For example, the now obsolete [XLS](https://docs.fileformat.com/spreadsheet/xls/) format supports [max 256 columns and 65536 rows](https://superuser.com/questions/366468/what-is-the-maximum-allowed-rows-in-a-microsoft-excel-xls-or-xlsx). The newer [XLSX (Office Open XML Workbook)](https://docs.fileformat.com/spreadsheet/xlsx/) format and the Microsoft Excel both [support up to 16384 columns and 1048576 rows](https://support.microsoft.com/en-us/office/excel-specifications-and-limits-1672b34d-7043-467e-8e27-269d656771c3).

On the other hand, the principle of the GroupDocs.Viewer is to render (convert) input document formats (including the Spreadsheet documents) to the pages, where the page may be defined as a rectangular area of relatively small size, comparable to the area of display, or A4 paper. And here a potentially huge worksheet size has a conflict with relatively small page size. How to display a worksheet with 1 million rows on a single page? Maybe split it on several pages, but if yes, then how? This question has no single direct answer, there are different ways to solve that, and this article explains all the ways available using the GroupDocs.Viewer.

## Render a worksheet on one page

The most simple way — render the content of the whole worksheet on a single page, where page size will be adjusted to fit the whole amount of rows and columns. This is a good choice when it is already known that the worksheet has a small size. However, if a worksheet is really big, this approach may lead to awful results. In particular, when rendering to the HTML format, the resultant HTML document may be huge, tens or even hundreds of [MiB](https://en.wikipedia.org/wiki/Byte#Multiple-byte_units), which may cause troubles while viewing such big files in the web-browsers. When rendering to the JPEG format, things may be even worse if the width or height will overcome the max limit of 65535 pixels. So use this mode deliberately.

For displaying a whole worksheet in one page call the [`SpreadsheetOptions.ForOnePagePerSheet`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/foronepagepersheet/) static method, which returns an instance of the [`SpreadsheetOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/), already tuned for this. Then assign this instance to the [`ViewOptions.SpreadsheetOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/spreadsheetoptions) property and view the spreadsheet using this view options instance.

The following example takes a spreadsheet on input, and converts it to the resultant PDF file, where every worksheet from input XLSX is rendered to one page in output PDF.

{{< tabs "RenderAWorksheetOnOnePage">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create PDF view options for rendering to PDF
PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

// Create spreadsheet options to render each worksheet to one page
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForOnePagePerSheet();

// Create a Viewer instance and specify the input XLSX
using (Viewer viewer = new Viewer("Products.xlsx"))
{
    // Render the XLSX to PDF
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

' Create PDF view options for rendering to PDF
Dim viewOptions As New PdfViewOptions("output.pdf")

' Create spreadsheet options to render each worksheet to one page
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForOnePagePerSheet()

' Create a Viewer instance and specify the input XLSX
Using viewer As New Viewer("Products.xlsx")
    ' Render the XLSX to PDF
    viewer.View(viewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

The screenshot below illustrates the result. The output PDF file contains one page (because input XLSX has one worksheet) that displays all worksheet data.

![Fit sheet on one page](/viewer/net/images/rendering-basics/render-spreadsheets/render-on-one-page.png)

## Split worksheet by page breaks

Microsoft Excel itself adds automatic page breaks based on paper size and page settings, such as orientation and margins. If you switch to the _"View"_ tab and enter the _"Page Break Preview"_ mode, you can see blue lines that divide the whole worksheet area on rectangular chunks, each of them is labeled as "Page 1", "Page 2", and so on. This is how Microsoft Excel "suggests" to split a worksheet onto pages.

In the image below, the vertical page break is inserted after the column “**E**”, and the horizontal page break is located under the row “**30**”. If you go to the _“Page Layout”_ tab, and then change the values of _“Orientation”_ and/or _“Size”_ tiles, you can see how Microsoft Excel will recalculate page areas on the fly.

![Preview page breaks in Microsoft Excel](/viewer/net/images/rendering-basics/render-spreadsheets/excel-page-break-preview.png)

For achieving the same behavior with GroupDocs.Viewer call the [`SpreadsheetOptions.ForRenderingByPageBreaks`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/forrenderingbypagebreaks/) static method, and then assign its value to the [`ViewOptions.SpreadsheetOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/spreadsheetoptions) property, as in the first example. The following code example shows this:

{{< tabs "SplitWorksheetByPageBreaks">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create PDF view options for rendering to PDF
PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

// Create spreadsheet options to split worksheet onto pages by page breaks
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForRenderingByPageBreaks();

// Create a Viewer instance and specify the input XLSX
using (Viewer viewer = new Viewer("Products.xlsx"))
{
    // Render the XLSX to PDF
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

' Create PDF view options for rendering to PDF
Dim viewOptions As New PdfViewOptions("output.pdf")

' Create spreadsheet options to split worksheet onto pages by page breaks
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForRenderingByPageBreaks()

' Create a Viewer instance and specify the input XLSX
Using viewer As New Viewer("Products.xlsx")
    ' Render the XLSX to PDF
    viewer.View(viewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result — you can compare it with a screenshot above and note that worksheet content is splitted exactly as Microsoft Excel suggests.

![Render a worksheet to PDF based on page breaks](/viewer/net/images/rendering-basics/render-spreadsheets/render-by-page-breaks.png)

## Render only print area

Along with the page breaks, the Microsoft Excel has a “Print Area” concept. Print Area is actually one or more cell ranges in a worksheet, which are designated for printing, while any content outside of the Print Area will not be printed at all. For adding some cell range to the Print Area, go to the “Page Layout" tab, click on the _“Print Area”_ button and then click on _“Set Print Area”_ item (see screenshot below). In order to add another cell range to the Print Area, select this new range, click on the _“Print Area”_ button and then click on _“Add to Print Area”_ item at this time. In the “Page Break Preview” mode you can see all cell ranges in the Print Area.

![Specify a print area in Microsoft Excel](/viewer/net/images/rendering-basics/render-spreadsheets/excel-set-print-area.png)

GroupDocs.Viewer also supports this option — in that case each cell range within the print area will be placed on a separate page. For achieving this call the [`SpreadsheetOptions.ForRenderingPrintArea`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/methods/forrenderingprintarea) static method and assign the returned [`SpreadsheetOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/) instance to the [`ViewOptions.SpreadsheetOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/spreadsheetoptions) property. The following example shows how to do this.

{{< tabs "RenderOnlyPrintArea">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create PDF view options for rendering to PDF
PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

// Create spreadsheet options to render a Print Area only
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForRenderingPrintArea();

// Create a Viewer instance and specify the input XLSX
using (Viewer viewer = new Viewer("Invoice.xlsx"))
{
    // Render the XLSX to PDF
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

' Create PDF view options for rendering to PDF
Dim viewOptions As New PdfViewOptions("output.pdf")

' Create spreadsheet options to render a Print Area only
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForRenderingPrintArea()

' Create a Viewer instance and specify the input XLSX
Using viewer As New Viewer("Invoice.xlsx")
    ' Render the XLSX to PDF
    viewer.View(viewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render the print area to PDF](/viewer/net/images/rendering-basics/render-spreadsheets/render-print-area.png)

## Render print area and split by page breaks

GroupDocs.Viewer has a unique feature — combining the Print Area and page breaks in the single mode. In this case GroupDocs.Viewer takes into account all cell ranges of print area and page breaks in the worksheet and applies them simultaneously to split a worksheet onto pages.

For doing that call the [`SpreadsheetOptions.ForRenderingPrintAreaAndPageBreaks`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/methods/forrenderingprintareaandpagebreaks) static method and assign the returned [`SpreadsheetOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/) instance to the [`ViewOptions.SpreadsheetOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/spreadsheetoptions) property.

In the following screenshot the red line shows the print area, and the blue line shows page breaks.

![Specify page breaks and a print area in Microsoft Excel](/viewer/net/images/rendering-basics/render-spreadsheets/page-breake-vs-print-area.png)

The following example renders the Microsoft Excel spreadsheet using page breaks and print areas displayed in the screenshot above to PDF:

{{< tabs "RenderPrintAreaAndSplitByPageBreaks">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create PDF view options for rendering to PDF
PdfViewOptions viewOptions = new PdfViewOptions("Financial Sample.pdf");

// Render a Print Area and split by page breaks
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForRenderingPrintAreaAndPageBreaks();

// Create a Viewer instance and specify the input XLSX
using (Viewer viewer = new Viewer("Products.xlsx"))
{
    // Render the XLSX to PDF
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

' Create PDF view options for rendering to PDF
Dim viewOptions As New PdfViewOptions("Financial Sample.pdf")

' Render a Print Area and split by page breaks
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForRenderingPrintAreaAndPageBreaks()

' Create a Viewer instance and specify the input XLSX
Using viewer As New Viewer("Products.xlsx")
    ' Render the XLSX to PDF
    viewer.View(viewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

The screenshot below illustrates the result:

![Render page breaks and a print area to PDF](/viewer/net/images/rendering-basics/render-spreadsheets/pdf-result.png)

## Split worksheet into pages manually by rows and columns

Sometimes none of the splitting methods, described above, is acceptable, or the spreadsheet has a format that does not support page breaks and Print Areas, for example, the text-based CSV. For such cases GroupDocs.Viewer allows to manually specify the number of rows and/or number of columns that should be present on every page. In short, the difference between splitting by rows only vs. splitting by rows and columns is illustrated on screenshot below.

![Split by rows only vs. split by rows and columns](/viewer/net/sample-files/split-worksheets-into-pages/split-by-rows-and-split-by-rows-and-columns.png)

### Split worksheet into pages only by rows

When a worksheet is tall, but narrow, i.e. it has some moderate amount of columns, but huge amount of rows, it is ideal to split such a worksheet horizontally, by rows. In this case the user should specify a number of rows per single page in the [`SpreadsheetOptions.ForSplitSheetIntoPages(int countRowsPerPage)`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/forsplitsheetintopages/#forsplitsheetintopages) static method, and then all as usual. The number of rows per page must be strictly greater than zero. The code sample is below, it specifies 15 rows per one page. This code sample uses a file "`two-pages.xlsx`", that can be downloaded [here](/viewer/net/sample-files/split-worksheets-into-pages/two-pages.xlsx).

{{< tabs "SplitWorksheetIntoPagesOnlyByRows">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create PDF view options for rendering to PDF
PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

// Specify number of rows for every page
int rowsPerPage = 15;

// Create spreadsheet options to split worksheet by number of rows
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForSplitSheetIntoPages(rowsPerPage);

// Create a Viewer instance and specify the input XLSX
using (Viewer viewer = new Viewer("two-pages.xlsx"))
{
    // Render the XLSX to PDF
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

' Create PDF view options for rendering to PDF
Dim viewOptions As New PdfViewOptions("output.pdf")

' Specify number of rows for every page
Dim rowsPerPage As Int32 = 15

' Create spreadsheet options to split worksheet by number of rows
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForSplitSheetIntoPages(rowsPerPage)

' Create a Viewer instance and specify the input XLSX
Using viewer As New Viewer("two-pages.xlsx")
    ' Render the XLSX to PDF
    viewer.View(viewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

The screenshot below demonstrates the original XLSX spreadsheet, conditionally divided onto chucks with 15 rows in each, and output PDF file, produced by the GroupDocs.Viewer.

![Break a worksheet into two pages](/viewer/net/images/rendering-basics/render-spreadsheets/render-two-pages.png)

### Split worksheet into pages by rows and columns

When a worksheet is tall and wide, i.e. it has a big amount of columns and rows, then need to split such a worksheet horizontally and vertically simultaneously. The previously mentioned [`ForSplitSheetIntoPages`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/forsplitsheetintopages/#forsplitsheetintopages) static method has an overload, that obtained two arguments — number of rows and number of columns: [`ForSplitSheetIntoPages(int countRowsPerPage, int countColumnsPerPage)`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/forsplitsheetintopages/#forsplitsheetintopages_1). The number of rows and columns per page must be strictly greater than zero. The following sample demonstrates splitting the worksheets into pages with 15 rows and 7 columns per each. This code sample uses a file "`four-pages.xlsx`", that can be downloaded [here](/viewer/net/sample-files/split-worksheets-into-pages/four-pages.xlsx).

{{< tabs "SplitWorksheetIntoPagesByRowsAndColumns">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create PDF view options for rendering to PDF
PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");

// Specify number of rows and columns for every page
int rowsPerPage = 15;
int columnsPerPage = 7;

// Create spreadsheet options to split worksheet by number of rows and columns
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForSplitSheetIntoPages(rowsPerPage, columnsPerPage);

// Create a Viewer instance and specify the input XLSX
using (Viewer viewer = new Viewer("four-pages.xlsx"))
{
    // Render the XLSX to PDF
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

' Create PDF view options for rendering to PDF
Dim viewOptions As New PdfViewOptions("output.pdf")

' Specify number of rows and columns for every page
Dim rowsPerPage As Int32 = 15
Dim columnsPerPage As Int32 = 7

' Create spreadsheet options to split worksheet by number of rows and columns
viewOptions.SpreadsheetOptions = SpreadsheetOptions.ForSplitSheetIntoPages(rowsPerPage, columnsPerPage)

' Create a Viewer instance and specify the input XLSX
Using viewer As New Viewer("four-pages.xlsx")
    ' Render the XLSX to PDF
    viewer.View(viewOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

The screenshot below demonstrates the original XLSX spreadsheet, conditionally divided onto chucks with 15 rows and 7 columns (A-G and H-N) in each, and output PDF file, produced by the GroupDocs.Viewer.

![Break a worksheet into four pages](/viewer/net/images/rendering-basics/render-spreadsheets/render-four-pages.png)

## Conclusion

This article shows that GroupDocs.Viewer provides different ways to split a worksheet into pages in order to satisfy the widest variety of use-cases. Please note that all these features were added to the GroupDocs.Viewer gradually, piece by piece, so if you're using some obsolete version of the library, released before year 2023, some of the described features may be missing. Also keep in mind that we're open to new suggestions and ideas how a worksheet can be splitted on pages, so you are welcome to share your thoughts on our [forum](https://forum.groupdocs.com/c/viewer/9).
---

## Split a worksheet into pages

Path: /viewer/python-net/split-worksheet-into-pages/


GroupDocs.Viewer uses page breaks to split a worksheet into separate pages. Microsoft Excel adds automatic page breaks based on paper size and page settings, but you can also insert manual horizontal and vertical page breaks. Switch to **Page Break Preview** in Microsoft Excel to see where page breaks appear on a worksheet.

In the image below, the vertical page break is inserted after the column **E**, and the horizontal page break is located under the row **30**.

![Preview page breaks in Microsoft Excel](/viewer/python-net/images/rendering-basics/render-spreadsheets/excel-page-break-preview.png)

To render a worksheet based on the inserted page breaks, call the [SpreadsheetOptions.for_rendering_by_page_breaks](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/#methods) static method and assign the returned `SpreadsheetOptions` instance to the [ViewOptions.spreadsheet_options](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property of your view (depending on the output file format).

The following example converts a worksheet to PDF and uses the page breaks to split this worksheet into pages:

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, SpreadsheetOptions

def split_by_page_breaks():
    # Load spreadsheet
    with Viewer("products.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("split_by_page_breaks/by_page_breaks.pdf")
        # Split using page breaks.
        viewOptions.spreadsheet_options = SpreadsheetOptions.for_rendering_by_page_breaks()
        viewer.view(viewOptions)

if __name__ == "__main__":
    split_by_page_breaks()
```
{{< /tab >}}
{{< tab "products.xlsx" >}}
{{< tab-text >}}
`products.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/products.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render a worksheet to PDF based on page breaks](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-by-page-breaks.png)

## Split a worksheet into pages by rows

The following code snippet splits a worksheet into two pages and renders them to PDF:

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, SpreadsheetOptions

def split_by_rows():
    # Load spreadsheet
    with Viewer("two-pages.xlsx") as viewer:
        # Specify number of rows for every page.
        rows_per_page = 15
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("split_by_rows/by_rows.pdf")
        # Split by number of rows.
        viewOptions.spreadsheet_options = SpreadsheetOptions.for_split_sheet_into_pages(rows_per_page)
        viewer.view(viewOptions)

if __name__ == "__main__":
    split_by_rows()
```
{{< /tab >}}
{{< tab "two-pages.xlsx" >}}
{{< tab-text >}}
`two-pages.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/two-pages.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the output PDF file.

![Break a worksheet into two pages](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-two-pages.png)

## Split a worksheet into pages by rows and columns

The following code snippet splits a worksheet into four pages and renders them to PDF:

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, SpreadsheetOptions

def split_by_rows_and_columns():
    # Load spreadsheet
    with Viewer("four-pages.xlsx") as viewer:
        # Specify number of rows and columns for every page.
        rows_per_page = 15
        column_per_page = 7
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("split_by_rows_and_columns/by_rows_and_columns.pdf")
        # Split by number of rows and columns.
        viewOptions.spreadsheet_options = SpreadsheetOptions.for_split_sheet_into_pages(rows_per_page, column_per_page)
        viewer.view(viewOptions)

if __name__ == "__main__":
    split_by_rows_and_columns()
```
{{< /tab >}}
{{< tab "four-pages.xlsx" >}}
{{< tab-text >}}
`four-pages.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/four-pages.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the output PDF file.

![Break a worksheet into four pages](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-four-pages.png)

## Render a print area

In Microsoft Excel, you can designate one or more cell ranges in a worksheet as the only region to print (a _print area_). A worksheet can contain multiple print areas. Each print area prints on its own page.

![Specify a print area in Microsoft Excel](/viewer/python-net/images/rendering-basics/render-spreadsheets/excel-set-print-area.png)

GroupDocs.Viewer also supports this option. Call the [SpreadsheetOptions.for_rendering_print_area](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/#methods) static method and assign the returned `SpreadsheetOptions` instance to the [ViewOptions.spreadsheet_options](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property to display only the worksheet's print area in the output HTML, PDF, or image file.

The following example renders the print area displayed in the image above to PDF:

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, SpreadsheetOptions

def render_print_area():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_print_area/print_area.pdf")
        # Render the print area only.
        viewOptions.spreadsheet_options = SpreadsheetOptions.for_rendering_print_area()
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_print_area()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render the print area to PDF](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-print-area.png)

## Render a worksheet on one page

If you want to display all worksheet data on one page, call the [SpreadsheetOptions.for_one_page_per_sheet](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/#methods) static method and assign the returned `SpreadsheetOptions` instance to the [ViewOptions.spreadsheet_options](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property for a target view.

The following example converts each worksheet to one page in the PDF file:

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, SpreadsheetOptions

def render_one_page_per_sheet():
    # Load spreadsheet
    with Viewer("Products.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_one_page_per_sheet/one_page_per_sheet.pdf")
        # Render each worksheet to one page.
        viewOptions.spreadsheet_options = SpreadsheetOptions.for_one_page_per_sheet()
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_one_page_per_sheet()
```
{{< /tab >}}
{{< tab "Products.xlsx" >}}
{{< tab-text >}}
`Products.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/Products.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result. The output PDF file contains one page that displays all worksheet data.

![Fit sheet on one page](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-on-one-page.png)

## Render worksheet by page breaks and print area

GroupDocs.Viewer uses page breaks to split a worksheet into separate pages. Microsoft Excel adds automatic page breaks based on paper size and page settings, but you can also insert manual horizontal and vertical page breaks. Switch to **Page Break Preview** in Microsoft Excel to see where page breaks appear on a worksheet.

Also, you can designate one or more cell ranges in a worksheet as the only region to print (a _print area_). A worksheet can contain multiple print areas. Each print area prints on its own page.

When printing, Microsoft Excel splits a worksheet into pages using both page breaks and print areas. In the following image the red line shows the print area, and the blue line shows page breaks:

![Specify page breaks and a print area in Microsoft Excel](/viewer/python-net/images/rendering-basics/render-spreadsheets/page-breake-vs-print-area.png)

GroupDocs.Viewer also supports this option. Call the [SpreadsheetOptions.for_rendering_print_area_and_page_breaks](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/#methods) static method and assign the returned `SpreadsheetOptions` instance to the [ViewOptions.spreadsheet_options](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property to display only the worksheet's print area in the output HTML, PDF, or image file.

The following example renders the Microsoft Excel spreadsheet using page breaks and print areas displayed in the image above to PDF:

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, SpreadsheetOptions

def render_print_area_and_page_breaks():
    # Load spreadsheet
    with Viewer("Products.xlsx") as viewer:
        # Render the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_print_area_and_page_breaks/print_area_and_page_breaks.pdf")
        viewOptions.spreadsheet_options = SpreadsheetOptions.for_rendering_print_area_and_page_breaks()
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_print_area_and_page_breaks()
```
{{< /tab >}}
{{< tab "Products.xlsx" >}}
{{< tab-text >}}
`Products.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/Products.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result:

![Render page breaks and a print area to PDF](/viewer/python-net/images/rendering-basics/render-spreadsheets/pdf-result.png)


---

## Subset fonts

Path: /viewer/java/optimization-pdf-subset-fonts/

Optimization resources. SubsetFonts optimization option
Fonts will be converted into subsets if set to true

If the file uses embedded fonts, it contains all font data. GroupDocs.Viewer can subset embedded fonts to reduce the file size.

To subset fonts in a PDF file, use the [setSubsetFonts](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/#setSubsetFonts-boolean-) method and set it to `true`.

The following code snippet shows how to subset fonts in a PDF file:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setPdfOptimizationOptions(new PdfOptimizationOptions());
    viewOptions.getPdfOptimizationOptions().setSubsetFonts(true);
     
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}

The following image demonstrates the result. There is no difference in appearance:

![No difference in appearance](/viewer/java/images/pdf-rendering/optimization/optimization-pdf-subset-fonts-appearance.png)

But there is the significant difference in size:

![Significant difference in size](/viewer/java/images/pdf-rendering/optimization/optimization-pdf-subset-fonts-size.png)

---

## Subset fonts

Path: /viewer/net/optimization-pdf-subset-fonts/

Not optimized files may contain embedded fonts. GroupDocs.Viewer can remove unused instructions in embedded fonts to reduce the file size.

To subset fonts in a PDF file, set the [SubsetFonts](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/subsetfonts) property to `true`.

The following code snippet shows how to subset fonts in a PDF file:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions
    {
        SubsetFonts = true
    };
     
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions With {
                .SubsetFonts = True
                }
    
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result. There is no difference in appearance:

![No difference in appearance](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-subset-fonts-appearance.png)

But there is the significant difference in size:

![Significant difference in size](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-subset-fonts-size.png)

---

## Subset fonts

Path: /viewer/python-net/optimization-pdf-subset-fonts/

Not optimized files may contain embedded fonts. GroupDocs.Viewer can remove unused instructions in embedded fonts to reduce the file size.

To subset fonts in a PDF file, set the [subset_fonts](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property to `True`.

The following code snippet shows how to subset fonts in a PDF file:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def subset_fonts():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("subset_fonts/subset_fonts.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.subset_fonts = True

        viewer.view(viewOptions)

if __name__ == "__main__":
    subset_fonts()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimize-fonts/optimization-pdf-subset-fonts/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result. There is no difference in appearance:

![No difference in appearance](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-subset-fonts-appearance.png)

But there is the significant difference in size:

![Significant difference in size](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-subset-fonts-size.png)

---

## Supported Audio Types

Path: /merger/java/supported-audio-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Cross-format audio merging |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [WAV](https://docs.fileformat.com/audio/wav/) | WAV Audio File | ![(tick)](/merger/net/images/check.png) |   |   |


---

## Supported Audio Types

Path: /merger/net/supported-audio-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Cross-format audio merging |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [WAV](https://docs.fileformat.com/audio/wav/) | WAV Audio File | ![(tick)](/merger/net/images/check.png) |   |   |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MP3 Audio File | ![(tick)](/merger/net/images/check.png) |   |   |

---

## Supported Document Formats

Path: /annotation/java/supported-document-formats/

For some file types, GroupDocs.Annotation saves the result in a different format. In this case, the output file type is specified after <strong>\*</strong>. If no such symbol is specified, GroupDocs.Annotation saves the result in the original file type.

| Format | Description | Annotate |
| --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/annotation/java/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/annotation/java/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/annotation/java/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/annotation/java/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/annotation/java/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/annotation/java/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/annotation/java/images/check.png) |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/annotation/java/images/check.png) |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/annotation/java/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/annotation/java/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) <span style="float: right; color: #909090"><strong>*</strong>xlsx</span> | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/annotation/java/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) <span style="float: right; color: #909090"><strong>*</strong>xlsx</span> | Microsoft Excel Binary Worksheet | ![(tick)](/annotation/java/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) <span style="float: right; color: #909090"><strong>*</strong>xlsx</span> | OpenDocument Spreadsheet | ![(tick)](/annotation/java/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/annotation/java/images/check.png) |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/annotation/java/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/annotation/java/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) <span style="float: right; color: #909090"><strong>*</strong>pptx</span> | Microsoft PowerPoint Slide Show | ![(tick)](/annotation/java/images/check.png) |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/annotation/java/images/check.png) |
| [TIF](https://docs.fileformat.com/image/tiff/), [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/annotation/java/images/check.png) |
| [JPG](https://docs.fileformat.com/image/jpeg) [JPEG](https://docs.fileformat.com/image/jpeg)   | Joint Photographic Experts Group (JPEG) | ![(tick)](/annotation/java/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/annotation/java/images/check.png) |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/annotation/java/images/check.png) |
| [DWG](https://docs.fileformat.com/cad/dwg/) <span style="float: right; color: #909090"><strong>*</strong>png</span> | Autodesk Design Data Formats | ![(tick)](/annotation/java/images/check.png) |
| [DXF](https://docs.fileformat.com/cad/dxf/) <span style="float: right; color: #909090"><strong>*</strong>png</span> | Drawing Interchange Format | ![(tick)](/annotation/java/images/check.png) |
| [PDF](https://docs.fileformat.com/pdf/) (PDF/A-1a,PDF/A-1b,PDF/A-2a) | Adobe Portable Document Format (PDF) | ![(tick)](/annotation/java/images/check.png) |
| [HTM](https://docs.fileformat.com/web/htm/) <span style="float: right; color: #909090"><strong>*</strong>html</span> | HyperText Markup Language (HTM) | ![(tick)](/annotation/java/images/check.png) |
| [HTML](https://docs.fileformat.com/web/html/) | HyperText Markup Language (HTML) | ![(tick)](/annotation/java/images/check.png) |
| [EML](https://docs.fileformat.com/email/eml/) | E-mail Message (EML) | ![(tick)](/annotation/java/images/check.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) <span style="float: right; color: #909090"><strong>*</strong>eml</span> | E-mail Message (EMLX) | ![(tick)](/annotation/java/images/check.png) |
| [VSD](https://docs.fileformat.com/image/vsd/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio 2003-2010 Drawing | ![(tick)](/annotation/java/images/check.png) |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/annotation/java/images/check.png) |
| [VSDM](https://docs.fileformat.com/image/vsdm/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio Drawing File Format | ![(tick)](/annotation/java/images/check.png) |
| [VSS](https://docs.fileformat.com/image/vss/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span>| Microsoft Visio 2003-2010 Stencil | ![(tick)](/annotation/java/images/check.png) |
| [VSSX](https://docs.fileformat.com/image/vssx/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span>| Visio Stencil File Format | ![(tick)](/annotation/java/images/check.png) |
| [VST](https://docs.fileformat.com/image/vst/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio 2013 Stencil | ![(tick)](/annotation/java/images/check.png) |
| [VSTM](https://docs.fileformat.com/image/vstm/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio Template File Format | ![(tick)](/annotation/java/images/check.png) |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/annotation/10), and our team will assist you.

{{< /alert >}}

---

## Supported Document Formats

Path: /annotation/net/supported-document-formats/

For some file types, GroupDocs.Annotation saves the result in a different format. In this case, the output file type is specified after <strong>\*</strong>. If no such symbol is specified, GroupDocs.Annotation saves the result in the original file type.

| Format | Description | Annotate |
| --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/annotation/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/annotation/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/annotation/net/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/annotation/net/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/annotation/net/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/annotation/net/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/annotation/net/images/check.png) |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/annotation/net/images/check.png) |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/annotation/net/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/annotation/net/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) <span style="float: right; color: #909090"><strong>*</strong>xlsx</span> | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/annotation/net/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) <span style="float: right; color: #909090"><strong>*</strong>xlsx</span> | Microsoft Excel Binary Worksheet | ![(tick)](/annotation/net/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) <span style="float: right; color: #909090"><strong>*</strong>xlsx</span> | OpenDocument Spreadsheet | ![(tick)](/annotation/net/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/annotation/net/images/check.png) |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/annotation/net/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/annotation/net/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) <span style="float: right; color: #909090"><strong>*</strong>pptx</span> | Microsoft PowerPoint Slide Show | ![(tick)](/annotation/net/images/check.png) |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/annotation/net/images/check.png) |
| [TIF](https://docs.fileformat.com/image/tiff/), [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/annotation/net/images/check.png) |
| [JPG](https://docs.fileformat.com/image/jpeg) [JPEG](https://docs.fileformat.com/image/jpeg)   | Joint Photographic Experts Group (JPEG) | ![(tick)](/annotation/net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/annotation/net/images/check.png) |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/annotation/net/images/check.png) |
| [DWG](https://docs.fileformat.com/cad/dwg/) <span style="float: right; color: #909090"><strong>*</strong>png</span> | Autodesk Design Data Formats | ![(tick)](/annotation/net/images/check.png) |
| [DXF](https://docs.fileformat.com/cad/dxf/) <span style="float: right; color: #909090"><strong>*</strong>png</span> | Drawing Interchange Format | ![(tick)](/annotation/net/images/check.png) |
| [PDF](https://docs.fileformat.com/pdf/) (PDF/A-1a,PDF/A-1b,PDF/A-2a) | Adobe Portable Document Format (PDF) | ![(tick)](/annotation/net/images/check.png) |
| [HTM](https://docs.fileformat.com/web/htm/) <span style="float: right; color: #909090"><strong>*</strong>html</span> | HyperText Markup Language (HTM) | ![(tick)](/annotation/net/images/check.png) |
| [HTML](https://docs.fileformat.com/web/html/) | HyperText Markup Language (HTML) | ![(tick)](/annotation/net/images/check.png) |
| [EML](https://docs.fileformat.com/email/eml/) | E-mail Message (EML) | ![(tick)](/annotation/net/images/check.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) <span style="float: right; color: #909090"><strong>*</strong>eml</span> | E-mail Message (EMLX) | ![(tick)](/annotation/net/images/check.png) |
| [VSD](https://docs.fileformat.com/image/vsd/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio 2003-2010 Drawing | ![(tick)](/annotation/net/images/check.png) |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/annotation/net/images/check.png) |
| [VSDM](https://docs.fileformat.com/image/vsdm/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio Drawing File Format | ![(tick)](/annotation/net/images/check.png) |
| [VSS](https://docs.fileformat.com/image/vss/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span>| Microsoft Visio 2003-2010 Stencil | ![(tick)](/annotation/net/images/check.png) |
| [VSSX](https://docs.fileformat.com/image/vssx/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span>| Visio Stencil File Format | ![(tick)](/annotation/net/images/check.png) |
| [VST](https://docs.fileformat.com/image/vst/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio 2013 Stencil | ![(tick)](/annotation/net/images/check.png) |
| [VSTM](https://docs.fileformat.com/image/vstm/) <span style="float: right; color: #909090"><strong>*</strong>vsdx</span> | Microsoft Visio Template File Format | ![(tick)](/annotation/net/images/check.png) |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/annotation/10), and our team will assist you.

{{< /alert >}}

---

## Supported Document Formats

Path: /editor/java/supported-document-formats/


The following table indicates the file formats that GroupDocs.Editor can edit. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/editor/20">}}

## WordProcessing family formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | MS Word 97-2007 Binary File Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordProcessingML Macro-Free Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordProcessingML Macro-Enabled Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | MS Word 97-2007 Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Macro-Free Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| FlatOPC | Office Open XML WordprocessingML stored in a flat XML file instead of a ZIP package | ![(tick)](/editor/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | Open Document Format Text Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | Open Document Format Text Document Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| WordML | Microsoft Office Word 2003 XML Format — WordProcessingML or WordML | ![(tick)](/editor/net/images/check.png) |   |

## Spreadsheet family formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel 97-2003 Binary File Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Excel 97-2003 Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Office Open XML Workbook Macro-Free | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Office Open XML Workbook Macro-Enabled | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Office Open XML Template Macro-Free | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Office Open XML Template Macro-Enabled | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Excel Binary Workbook | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Add-in | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice or OpenOffice.org Calc XML Spreadsheet | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| SpreadsheetML | Microsoft Office Excel 2002 and Excel 2003 XML Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | Flat OpenDocument Spreadsheet — stored as a single uncompressed XML document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DIF](https://docs.fileformat.com/spreadsheet/dif/) | Data Interchange Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| DSV | Delimiter Separated Values document (arbitrary delimiter) | ![(tick)](/editor/net/images/check.png) |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values document | ![(tick)](/editor/net/images/check.png) |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values document | ![(tick)](/editor/net/images/check.png) |   |

## Presentation family formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 95 Presentation | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) | Microsoft Office Open XML PresentationML Macro-Free Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | Microsoft Office Open XML PresentationML Macro-Enabled Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPS](https://wiki.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 SlideShow | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) | Microsoft Office Open XML PresentationML Macro-Free SlideShow | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) | Microsoft Office Open XML PresentationML Macro-Enabled SlideShow | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POT](https://wiki.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Presentation Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POTX](https://wiki.fileformat.com/presentation/potx/) | Microsoft Office Open XML PresentationML Macro-Free Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POTM](https://wiki.fileformat.com/presentation/potm/) | Microsoft Office Open XML PresentationML Macro-Enabled Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [ODP](https://wiki.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OTP](https://wiki.fileformat.com/presentation/otp/) | OpenDocument Presentation template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |

## Other formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text | ![(tick)](/editor/net/images/check.png) |   |
| [HTML](https://docs.fileformat.com/web/html/) | HyperText Markup Language | ![(tick)](/editor/net/images/check.png) |   |
| [XML](https://docs.fileformat.com/web/xml/) | eXtensible Markup Language | ![(tick)](/editor/net/images/check.png) |   |

---

## Supported Document Formats

Path: /editor/net/supported-document-formats/


The following table indicates the file formats that GroupDocs.Editor can edit. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/editor/20">}}

## WordProcessing family formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | MS Word 97-2007 Binary File Format | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordProcessingML Macro-Free Document | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordProcessingML Macro-Enabled Document | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | MS Word 97-2007 Template | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Macro-Free Template | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| FlatOPC | Office Open XML WordprocessingML stored in a flat XML file instead of a ZIP package | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | Open Document Format Text Document | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | Open Document Format Text Document Template | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| WordML | Microsoft Office Word 2003 XML Format — WordProcessingML or WordML | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |

## Spreadsheet family formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | ---  | --- | --- | --- | --- |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel 97-2003 Binary File Format | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Excel 97-2003 Template | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Office Open XML Workbook Macro-Free | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Office Open XML Workbook Macro-Enabled | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Office Open XML Template Macro-Free | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Office Open XML Template Macro-Enabled | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Excel Binary Workbook | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Add-in  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| SpreadsheetML | Microsoft Office Excel 2002 and Excel 2003 XML Format | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | Flat OpenDocument Spreadsheet — stored as a single uncompressed XML document | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice or OpenOffice.org Calc XML Spreadsheet | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DIF](https://docs.fileformat.com/spreadsheet/dif/) | Data Interchange Format | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| DSV | Delimiter Separated Values document (arbitrary delimiter) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(error)](/editor/net/images/error.png) | ![(error)](/editor/net/images/error.png) |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values document | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values document | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |

## Presentation family formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | ---  | --- | --- | --- | --- |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 95 Presentation | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) | Microsoft Office Open XML PresentationML Macro-Free Document | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | Microsoft Office Open XML PresentationML Macro-Enabled Document | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPS](https://wiki.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 SlideShow | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) | Microsoft Office Open XML PresentationML Macro-Free SlideShow | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) | Microsoft Office Open XML PresentationML Macro-Enabled SlideShow | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POT](https://wiki.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Presentation Template | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POTX](https://wiki.fileformat.com/presentation/potx/) | Microsoft Office Open XML PresentationML Macro-Free Template | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POTM](https://wiki.fileformat.com/presentation/potm/) | Microsoft Office Open XML PresentationML Macro-Enabled Template | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [ODP](https://wiki.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OTP](https://wiki.fileformat.com/presentation/otp/) | OpenDocument Presentation template | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| FODP | Flat XML ODF Presentation | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) |

## Fixed-layout family formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | ---  | --- | --- | --- | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Portable Document Format | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | XML Paper Specification | ![(error)](/editor/net/images/error.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |

## Email family formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | ---  | --- | --- | --- | --- |
| [EML](https://docs.fileformat.com/email/eml/) | RFC-822 Internet Message Format Standard | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail App format | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [MSG](https://docs.fileformat.com/email/msg/) | Microsoft Outlook and Exchange email format | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [MBOX](https://docs.fileformat.com/email/mbox/) | Container for collection of electronic mail messages | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [TNEF](https://docs.fileformat.com/email/tnef/) | Transport Neutral Encapsulation Format | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [MHT](https://docs.fileformat.com/web/mht/) | MIME encapsulation of aggregate HTML documents | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PST](https://docs.fileformat.com/email/pst/) | Personal Storage Table | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OFT](https://docs.fileformat.com/email/oft/) | Outlook MSG file format for message template | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OST](https://docs.fileformat.com/email/oft/) | Offline Storage Table | ![(tick)](/editor/net/images/check.png)   | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [VCF](https://docs.fileformat.com/email/vcf/) | Virtual Card Format | ![(error)](/editor/net/images/error.png) | ![(error)](/editor/net/images/error.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) |
| [ICS](https://docs.fileformat.com/email/ics/) | Internet Calendaring and Scheduling Core Object Specification (iCalendar) | ![(error)](/editor/net/images/error.png) | ![(error)](/editor/net/images/error.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) |

## eBook family formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | ---  | --- | --- | --- | --- |
| [ePub](https://docs.fileformat.com/ebook/epub/) | Electronic Publication | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | MobiPocket | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [AZW3](https://docs.fileformat.com/ebook/azw3/) | AZW3, also known as Kindle Format 8 (KF8) | ![(tick)](/editor/net/images/check.png)  | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |

## Markup formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | ---  | --- | --- | --- | --- |
| [HTML](https://docs.fileformat.com/web/html/) | HyperText Markup Language | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME Encapsulation of Aggregate HTML | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [CHM](https://docs.fileformat.com/web/chm/) | Microsoft Compiled HTML Help | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) |
| [XML](https://docs.fileformat.com/web/xml/) | eXtensible Markup Language | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |

## Other formats

| Format | Description | Create | Import | Export | Auto Detection |
| --- | ---  | --- | --- | --- | --- |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text | ![(error)](/editor/net/images/error.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
---

## Supported Document Formats

Path: /editor/nodejs-java/supported-document-formats/


The following table indicates the file formats that GroupDocs.Editor can edit. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/editor/20">}}

## WordProcessing family formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | MS Word 97-2007 Binary File Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordProcessingML Macro-Free Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordProcessingML Macro-Enabled Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | MS Word 97-2007 Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Macro-Free Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| FlatOPC | Office Open XML WordprocessingML stored in a flat XML file instead of a ZIP package | ![(tick)](/editor/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | Open Document Format Text Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | Open Document Format Text Document Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| WordML | Microsoft Office Word 2003 XML Format — WordProcessingML or WordML | ![(tick)](/editor/net/images/check.png) |   |

## Spreadsheet family formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel 97-2003 Binary File Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Excel 97-2003 Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Office Open XML Workbook Macro-Free | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Office Open XML Workbook Macro-Enabled | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Office Open XML Template Macro-Free | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Office Open XML Template Macro-Enabled | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Excel Binary Workbook | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Add-in | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice or OpenOffice.org Calc XML Spreadsheet | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| SpreadsheetML | Microsoft Office Excel 2002 and Excel 2003 XML Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | Flat OpenDocument Spreadsheet — stored as a single uncompressed XML document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [DIF](https://docs.fileformat.com/spreadsheet/dif/) | Data Interchange Format | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| DSV | Delimiter Separated Values document (arbitrary delimiter) | ![(tick)](/editor/net/images/check.png) |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values document | ![(tick)](/editor/net/images/check.png) |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values document | ![(tick)](/editor/net/images/check.png) |   |

## Presentation family formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 95 Presentation | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) | Microsoft Office Open XML PresentationML Macro-Free Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | Microsoft Office Open XML PresentationML Macro-Enabled Document | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPS](https://wiki.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 SlideShow | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) | Microsoft Office Open XML PresentationML Macro-Free SlideShow | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) | Microsoft Office Open XML PresentationML Macro-Enabled SlideShow | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POT](https://wiki.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Presentation Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POTX](https://wiki.fileformat.com/presentation/potx/) | Microsoft Office Open XML PresentationML Macro-Free Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [POTM](https://wiki.fileformat.com/presentation/potm/) | Microsoft Office Open XML PresentationML Macro-Enabled Template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [ODP](https://wiki.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |
| [OTP](https://wiki.fileformat.com/presentation/otp/) | OpenDocument Presentation template | ![(tick)](/editor/net/images/check.png) | ![(tick)](/editor/net/images/check.png) |

## Other formats

| Format | Description | Edit | Auto Detection |
| --- | --- | --- | --- |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text | ![(tick)](/editor/net/images/check.png) |   |
| [HTML](https://docs.fileformat.com/web/html/) | HyperText Markup Language | ![(tick)](/editor/net/images/check.png) |   |
| [XML](https://docs.fileformat.com/web/xml/) | eXtensible Markup Language | ![(tick)](/editor/net/images/check.png) |   |

---

## Supported Document Formats

Path: /parser/java/supported-document-formats/


The following tables indicate the file formats from which GroupDocs.Parser for Java can extract data. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/parser/17">}}

## Word Processing

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [DOC](https://wiki.fileformat.com/word-processing/doc/) <br/>Microsoft Word Document | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [DOT](https://wiki.fileformat.com/word-processing/dot/) <br/>Microsoft Word Document Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [DOCX](https://wiki.fileformat.com/word-processing/docx/) <br/>Office Open XML Document | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [DOCM](https://wiki.fileformat.com/word-processing/docm/) <br/>Office Open XML Macro-Enabled Document | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [DOTX](https://wiki.fileformat.com/word-processing/dotx/) <br/>Office Open XML Document Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [DOTM](https://wiki.fileformat.com/word-processing/dotm/) <br/>Office Open XML Document Macro-Enabled Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [TXT](https://wiki.fileformat.com/word-processing/txt/) <br/>Plain text |   | ![(tick)](/parser/java/images/check.png) |   |   |   |   |   |   |   |   |   |
| [ODT](https://wiki.fileformat.com/word-processing/odt/) <br/>Open Document Text | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [OTT](https://wiki.fileformat.com/word-processing/ott/) <br/>Open Document Text Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |
| [RTF](https://wiki.fileformat.com/word-processing/rtf/) <br/>Rich Text Format | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |

## PDF

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [PDF](https://wiki.fileformat.com/view/pdf/) <br/>Portable Document Format File | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |

## Markup 

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [XHTML](https://wiki.fileformat.com/web/xhtml/) <br/>Extensible Hypertext Markup Language File |   | ![(tick)](/parser/java/images/check.png) |   |   |   |   |  ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [MHTML](https://wiki.fileformat.com/web/mhtml/) <br/>MIME HTML File |   | ![(tick)](/parser/java/images/check.png) |   |   |   |   |  ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [MD](https://wiki.fileformat.com/word-processing/md/) <br/>Markdown |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) <br/>(Formatted Text is Not supported) |   |   |   |   |   |   |   |
| [XML](https://wiki.fileformat.com/web/xml/) <br/>XML File |   | ![(tick)](/parser/java/images/check.png) |   |   |   |   |   |   |   |   |   |

## Ebook

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [CHM](https://wiki.fileformat.com/web/chm/) <br/>Compiled HTML Help File |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png)  |   |   | ![(tick)](/parser/java/images/check.png) |   |
| [EPUB](https://wiki.fileformat.com/ebook/epub/) <br/>Digital E-Book File Format |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) |   |  |  ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) |   |
| [FB2](https://wiki.fileformat.com/ebook/fb2/) <br/>FictionBook 2.0 File |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) |  |  |  ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) <br/>Mobipocket |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [AZW3](https://docs.fileformat.com/ebook/azw3/) <br/>Kindle Format 8 |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |

## Speadsheet

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [XLS](https://wiki.fileformat.com/specification/spreadsheet/xls/) <br/>Microsoft Excel Spreadsheet | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [XLT](https://wiki.fileformat.com/specification/spreadsheet/xlt/) <br/>Microsoft Excel Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [XLSX](https://wiki.fileformat.com/specification/spreadsheet/xlsx/) <br/>Office Open XML Spreadsheet | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [XLSM](https://wiki.fileformat.com/specification/spreadsheet/xlsm/) <br/>Office Open XML Macro-Enabled Spreadsheet | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [XLSB](https://wiki.fileformat.com/specification/spreadsheet/xlsb/) <br/>Office Open XML Binary Spreadsheet | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [XLTX](https://wiki.fileformat.com/specification/spreadsheet/xltx/) <br/>Office Open XML Spreadsheet Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [XLTM](https://wiki.fileformat.com/specification/spreadsheet/xltm/) <br/>Office Open XML Macro-Enabled Spreadsheet Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [ODS](https://wiki.fileformat.com/specification/spreadsheet/ods/) <br/>Open Document Spreadsheet | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| OTS <br/>Open Document Spreadsheet Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| [CSV](https://wiki.fileformat.com/specification/spreadsheet/csv/) <br/>Comma Separated Values |   | ![(tick)](/parser/java/images/check.png) |   |   |   |   |   |   |   |   |   |
| XLA <br/>Excel Add-In File | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| XLAM <br/>Excel Open XML Macro-Enabled Add-In | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |   |
| NUMBERS <br/>Apple iWork Numbers | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) |   |   |   |

## Presentation

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) <br/>PowerPoint Presentation | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PPS](https://wiki.fileformat.com/presentation/pps/) <br/>PowerPoint Slideshow | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [POT](https://wiki.fileformat.com/presentation/pot/) <br/>PowerPoint Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) <br/>Office Open XML Presentation | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) <br/>Office Open XML Macro-Enabled Presentation | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [POTX](https://wiki.fileformat.com/presentation/potx/) <br/>Office Open XML Presentation Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [POTM](https://wiki.fileformat.com/presentation/potm/) <br/>Office Open XML Macro-Enabled Presentation Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) <br/>Office Open XML Presentation Slideshow | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) <br/>Office Open XML Macro-Enabled Presentation Slideshow | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [ODP](https://wiki.fileformat.com/presentation/odp/) <br/>Open Document Presentation | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [OTP](https://wiki.fileformat.com/presentation/otp/) <br/>Open Document Presentation Template | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   | ![(tick)](/parser/java/images/check.png) |

## Email

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [PST](https://wiki.fileformat.com/email/pst/) <br/>Outlook Personal Information Store File |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [OST](https://wiki.fileformat.com/email/ost/) <br/>Outlook Offline Data File |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [EML](https://wiki.fileformat.com/email/eml/) <br/>E-Mail Message |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [EMLX](https://wiki.fileformat.com/email/emlx/) <br/>Apple Mail Message |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [MSG](https://wiki.fileformat.com/email/msg/) <br/>Outlook Mail Message |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |

## Note

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [ONE](https://wiki.fileformat.com/note-taking/one/) <br/>OneNote Document |   | ![(tick)](/parser/java/images/check.png) |   |   |   |   |   |   |   |   |   |

## Archive

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [ZIP](https://wiki.fileformat.com/compression/zip/) <br/>Zipped File |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [RAR](https://wiki.fileformat.com/compression/rar/) <br/>Rar File |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [TAR](https://wiki.fileformat.com/compression/tar/) <br/>Tar File |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [GZ](https://wiki.fileformat.com/compression/gz/) <br/>GZip file |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |
| [BZ2](https://wiki.fileformat.com/compression/bz2/) <br/>BZip2 File |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) | ![(tick)](/parser/java/images/check.png) |   |   |   |

## Image

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [BMP](https://wiki.fileformat.com/image/bmp/)<br/>Bitmap Image file |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [GIF](https://wiki.fileformat.com/image/gif/)<br/>Graphical Interchange Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [JP2](https://wiki.fileformat.com/image/jp2/)<br/>JPEG 2000 |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [JPG, JPEG](https://wiki.fileformat.com/image/jpeg/)<br/>JPEG Image file  |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PNG](https://wiki.fileformat.com/image/png/)<br/>Portable Network Graphics |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [TIF, TIFF](https://wiki.fileformat.com/image/tiff/)<br/>Tagged Image File Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [DICOM](https://wiki.fileformat.com/image/dcm/)<br/>DICOM (Digital Imaging and Communications in Medicine) |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [DJVU](https://wiki.fileformat.com/image/djvu/)<br/>DjVu File Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [EMF](https://wiki.fileformat.com/image/emf/)<br/>Enhanced metafile |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [J2K](https://wiki.fileformat.com/image/j2k/)<br/>JPEG 2000 |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PS](https://docs.fileformat.com/page-description-language/ps/)<br/>PostScript File Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [PSD](https://wiki.fileformat.com/image/psd/)<br/>Photoshop Document |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [SVG](https://wiki.fileformat.com/image/svg/)<br/>Scalar Vector Graphics file |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [SVGZ](https://wiki.fileformat.com/image/svgz/)<br/>Scalar Vector Graphics file (with gzip compression) |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [WEBP](https://wiki.fileformat.com/image/webp/)<br/>WebP Image File Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |
| [WMF](https://wiki.fileformat.com/image/wmf/)<br/>Microsoft Windows Metafile |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) |


## Database

Databases are supported via JDBC. To work with the corresponding database format install its database provider.

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| JDBC | | ![(tick)](/parser/java/images/check.png) |   |   |   |   |   |   |   | ![(tick)](/parser/java/images/check.png) | |
---

## Supported Document Formats

Path: /parser/net/supported-document-formats/

The following tables indicate the file formats from which GroupDocs.Parser for .NET can extract data. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/parser/17">}}

## Word Processing

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [DOC](https://wiki.fileformat.com/word-processing/doc/) <br/>Microsoft Word Document | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [DOT](https://wiki.fileformat.com/word-processing/dot/) <br/>Microsoft Word Document Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [DOCX](https://wiki.fileformat.com/word-processing/docx/) <br/>Office Open XML Document | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [DOCM](https://wiki.fileformat.com/word-processing/docm/) <br/>Office Open XML Macro-Enabled Document | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [DOTX](https://wiki.fileformat.com/word-processing/dotx/) <br/>Office Open XML Document Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [DOTM](https://wiki.fileformat.com/word-processing/dotm/) <br/>Office Open XML Document Macro-Enabled Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [TXT](https://wiki.fileformat.com/word-processing/txt/) <br/>Plain text |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [ODT](https://wiki.fileformat.com/word-processing/odt/) <br/>Open Document Text | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [OTT](https://wiki.fileformat.com/word-processing/ott/) <br/>Open Document Text Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |
| [RTF](https://wiki.fileformat.com/word-processing/rtf/) <br/>Rich Text Format | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |

## PDF

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [PDF](https://wiki.fileformat.com/view/pdf/) <br/>Portable Document Format File | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |

## Markup 

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [XHTML](https://wiki.fileformat.com/web/xhtml/) <br/>Extensible Hypertext Markup Language File |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |  ![(tick)](/parser/net/images/check.png) |   |   |   |   |
| [MHTML](https://wiki.fileformat.com/web/mhtml/) <br/>MIME HTML File |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |  ![(tick)](/parser/net/images/check.png) |   |   |   |   |
| [MD](https://wiki.fileformat.com/word-processing/md/) <br/>Markdown |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) <br/>(Formatted Text is Not supported) |   |   |   |   |   |   |   |
| [XML](https://wiki.fileformat.com/web/xml/) <br/>XML File |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |

## Ebook

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [CHM](https://wiki.fileformat.com/web/chm/) <br/>Compiled HTML Help File |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png)  |   |   | ![(tick)](/parser/net/images/check.png) |   |
| [EPUB](https://wiki.fileformat.com/ebook/epub/) <br/>Digital E-Book File Format |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) |   |  |  ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |   |
| [FB2](https://wiki.fileformat.com/ebook/fb2/) <br/>FictionBook 2.0 File |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) |  |  |  ![(tick)](/parser/net/images/check.png) |   |   |   |   |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) <br/>Mobipocket |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [AZW3](https://docs.fileformat.com/ebook/azw3/) <br/>Kindle Format 8 |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |

## Speadsheet

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [XLS](https://wiki.fileformat.com/specification/spreadsheet/xls/) <br/>Microsoft Excel Spreadsheet | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [XLT](https://wiki.fileformat.com/specification/spreadsheet/xlt/) <br/>Microsoft Excel Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [XLSX](https://wiki.fileformat.com/specification/spreadsheet/xlsx/) <br/>Office Open XML Spreadsheet | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [XLSM](https://wiki.fileformat.com/specification/spreadsheet/xlsm/) <br/>Office Open XML Macro-Enabled Spreadsheet | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [XLSB](https://wiki.fileformat.com/specification/spreadsheet/xlsb/) <br/>Office Open XML Binary Spreadsheet | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [XLTX](https://wiki.fileformat.com/specification/spreadsheet/xltx/) <br/>Office Open XML Spreadsheet Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [XLTM](https://wiki.fileformat.com/specification/spreadsheet/xltm/) <br/>Office Open XML Macro-Enabled Spreadsheet Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [ODS](https://wiki.fileformat.com/specification/spreadsheet/ods/) <br/>Open Document Spreadsheet | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |   |
| OTS <br/>Open Document Spreadsheet Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |   |
| [CSV](https://wiki.fileformat.com/specification/spreadsheet/csv/) <br/>Comma Separated Values |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| XLA <br/>Excel Add-In File | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |   |
| XLAM <br/>Excel Open XML Macro-Enabled Add-In | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |   |
| NUMBERS <br/>Apple iWork Numbers | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) |   |   |   |

## Presentation

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) <br/>PowerPoint Presentation | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [PPS](https://wiki.fileformat.com/presentation/pps/) <br/>PowerPoint Slideshow | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [POT](https://wiki.fileformat.com/presentation/pot/) <br/>PowerPoint Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) <br/>Office Open XML Presentation | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) <br/>Office Open XML Macro-Enabled Presentation | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [POTX](https://wiki.fileformat.com/presentation/potx/) <br/>Office Open XML Presentation Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [POTM](https://wiki.fileformat.com/presentation/potm/) <br/>Office Open XML Macro-Enabled Presentation Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) <br/>Office Open XML Presentation Slideshow | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) <br/>Office Open XML Macro-Enabled Presentation Slideshow | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   | ![(tick)](/parser/net/images/check.png) |
| [ODP](https://wiki.fileformat.com/presentation/odp/) <br/>Open Document Presentation | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [OTP](https://wiki.fileformat.com/presentation/otp/) <br/>Open Document Presentation Template | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   | ![(tick)](/parser/net/images/check.png) |

## Email

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [PST](https://wiki.fileformat.com/email/pst/) <br/>Outlook Personal Information Store File |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [OST](https://wiki.fileformat.com/email/ost/) <br/>Outlook Offline Data File |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [EML](https://wiki.fileformat.com/email/eml/) <br/>E-Mail Message |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [EMLX](https://wiki.fileformat.com/email/emlx/) <br/>Apple Mail Message |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [MSG](https://wiki.fileformat.com/email/msg/) <br/>Outlook Mail Message |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |

## Note

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [ONE](https://wiki.fileformat.com/note-taking/one/) <br/>OneNote Document |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   |   |

## Archive

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [7Z](https://wiki.fileformat.com/compression/7z/)* <br/>7Z File |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [ZIP](https://wiki.fileformat.com/compression/zip/) <br/>Zipped File |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [RAR](https://wiki.fileformat.com/compression/rar/) <br/>Rar File |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [TAR](https://wiki.fileformat.com/compression/tar/) <br/>Tar File |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [GZ](https://wiki.fileformat.com/compression/gz/) <br/>GZip file |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |
| [BZ2](https://wiki.fileformat.com/compression/bz2/) <br/>BZip2 File |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) | ![(tick)](/parser/net/images/check.png) |   |   |   |

\* Encrypted 7-zip archives are not supported.

## Image

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| [BMP](https://wiki.fileformat.com/image/bmp/)<br/>Bitmap Image file |   | ![(tick)](/parser/net/images/check.png)  |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [GIF](https://wiki.fileformat.com/image/gif/)<br/>Graphical Interchange Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [JP2](https://wiki.fileformat.com/image/jp2/)<br/>JPEG 2000 |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [JPG, JPEG](https://wiki.fileformat.com/image/jpeg/)<br/>JPEG Image file  |   | ![(tick)](/parser/net/images/check.png)  |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [PNG](https://wiki.fileformat.com/image/png/)<br/>Portable Network Graphics |   | ![(tick)](/parser/net/images/check.png)  |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [TIF, TIFF](https://wiki.fileformat.com/image/tiff/)<br/>Tagged Image File Format |   | ![(tick)](/parser/net/images/check.png)  |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [DICOM](https://wiki.fileformat.com/image/dcm/)<br/>DICOM (Digital Imaging and Communications in Medicine) |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [DJVU](https://wiki.fileformat.com/image/djvu/)<br/>DjVu File Format |   | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [EMF](https://wiki.fileformat.com/image/emf/)<br/>Enhanced metafile |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [J2K](https://wiki.fileformat.com/image/j2k/)<br/>JPEG 2000 |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [PS](https://docs.fileformat.com/page-description-language/ps/)<br/>PostScript File Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [PSD](https://wiki.fileformat.com/image/psd/)<br/>Photoshop Document |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [SVG](https://wiki.fileformat.com/image/svg/)<br/>Scalar Vector Graphics file |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [SVGZ](https://wiki.fileformat.com/image/svgz/)<br/>Scalar Vector Graphics file (with gzip compression) |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [WEBP](https://wiki.fileformat.com/image/webp/)<br/>WebP Image File Format |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |
| [WMF](https://wiki.fileformat.com/image/wmf/)<br/>Microsoft Windows Metafile |   |   |   |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) |

## Database

Databases are supported via ADO&#46;NET. To work with the corresponding database format install its database provider.

| Document Type | Parse Document by Template | Extract Text (Accurate) | Extract Text (Raw) | Extract Structured Text and Formatted Text | Extract Text Areas | Extract Metadata | Extract Images | Extract Containers and Attachments | Parse Form Data | Extract Table of Contents | Scan Barcode |
| --- | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| ADO&#46;NET | | ![(tick)](/parser/net/images/check.png) |   |   |   |   |   |   |   | ![(tick)](/parser/net/images/check.png) | |

---

## Supported Document Formats

Path: /redaction/java/supported-document-formats/

## Supported File Formats

The following table indicates the file formats, supported by GroupDocs.Redaction for Java.

| Format | Description | Document body | Metadata | Annotations(comments) | Remarks | Embedded images | OCR | Remove Page |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Saves the document as PDF (Adobe Portable Document) format | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [DOC](https://docs.fileformat.com/word-processing/doc) | Microsoft Word 97 - 2007 Document. | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template. | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) |![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | RTF format. | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | OOXML Workbook Template | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Excel Workbook Template 97-2003 | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | CSV (Comma Separated Value) file. | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Microsoft PowerPoint Presentations format | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | PowerPoint Open XML | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [POT](https://docs.fileformat.com/presentation/pot/) | PowerPoint template files | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Open XML Macro-Enabled Presentation file | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Open XML Macro-Enabled Slide Show file | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint template | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) 0| ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [JPEG](https://docs.fileformat.com/image/jpeg/) | The image file format was standardized by the Joint Photographic Experts Group. | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [TIF/TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics Image | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image Files | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format Image | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   |   | ![(tick)](/redaction/net/images/check.png) |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Document Format | ![(tick)](/redaction/net/images/check.png) |  |   |   |   |   | ![(tick)](/redaction/net/images/check.png) |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/redaction/33), and our team will assist you.

{{< /alert >}}
---

## Supported Document Formats

Path: /redaction/net/supported-document-formats/

## Supported File Formats

The following table indicates the file formats, supported by GroupDocs.Redaction for .NET.

| Format | Description | Document body | Metadata | Annotations(comments) | Remarks | Embedded images | OCR | Remove Page | Page Filters |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Saves the document as PDF (Adobe Portable Document) format | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [DOC](https://docs.fileformat.com/word-processing/doc) | Microsoft Word 97 - 2007 Document | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text File | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template| ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | OOXML Workbook Template | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Excel Workbook Template 97-2003 | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | CSV (Comma Separated Value) file. | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   |   |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Microsoft PowerPoint Presentations format | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | PowerPoint Open XML | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Open XML Macro-Enabled Presentation file | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint presentation template files | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Open XML Macro-Enabled Slide Show file | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint template | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/redaction/net/images/check.png)  | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [JPEG](https://docs.fileformat.com/image/jpeg/) | The image file format was standardized by the Joint Photographic Experts Group. | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) |
| [TIF/TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics Image | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image Files | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   | ![(tick)](/redaction/net/images/check.png) |   | ![(tick)](/redaction/net/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format Image | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | Graphical Interchange Format Image | ![(tick)](/redaction/net/images/check.png) | ![(tick)](/redaction/net/images/check.png) |   |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Document Format | ![(tick)](/redaction/net/images/check.png) |  |   |   |   |   | ![(tick)](/redaction/net/images/check.png) |   |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/redaction/33), and our team will assist you.

{{< /alert >}}
---

## Supported Document Formats

Path: /redaction/python-net/supported-document-formats/

## Supported File Formats

The following table indicates the file formats, supported by GroupDocs.Redaction for Python via .NET.

| Format | Description | Document body | Metadata | Annotations(comments) | Remarks | Embedded images | OCR | Remove Page | Page Filters |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Saves the document as PDF (Adobe Portable Document) format | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [DOC](https://docs.fileformat.com/word-processing/doc) | Microsoft Word 97 - 2007 Document. | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template. | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | RTF format. | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | OOXML Workbook Template | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Excel Workbook Template 97-2003 | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | CSV (Comma Separated Value) file. | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   |   |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Microsoft PowerPoint Presentations format | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | PowerPoint Open XML | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [POT](https://docs.fileformat.com/presentation/pot/) | PowerPoint template files | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Open XML Macro-Enabled Presentation file | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Open XML Macro-Enabled Slide Show file | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint template | ![(tick)](/redaction/python-net/images/check.png)  | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [JPEG](https://docs.fileformat.com/image/jpeg/) | The image file format was standardized by the Joint Photographic Experts Group. | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) |
| [TIF/TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics Image | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image Files | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   | ![(tick)](/redaction/python-net/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format Image | ![(tick)](/redaction/python-net/images/check.png) | ![(tick)](/redaction/python-net/images/check.png) |   |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Document Format | ![(tick)](/redaction/python-net/images/check.png) |  |   |   |   |   | ![(tick)](/redaction/python-net/images/check.png) |   |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/redaction/33), and our team will assist you.

{{< /alert >}}
---

## Supported Document Formats

Path: /signature/java/supported-document-formats/

The following table indicates the file formats that GroupDocs.Signature can work with.

| Format | Description | Barcode | Digital | FormField | Image | Metadata | QR-code | Stamp | Text |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [CDR](https://docs.fileformat.com/image/cdr/) | CorelDraw Vector Graphic Drawing (CDR) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [CMX](https://docs.fileformat.com/image/cmx/) | Corel Metafile eXchange Image | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [DJVU](https://docs.fileformat.com/image/djvu/) | Deja Vu (DjVu) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphics Interchange Format (GIF) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [JPG](https://docs.fileformat.com/image/jpeg/), [JPEG](https://docs.fileformat.com/image/jpeg/)   | Joint Photographic Experts Group (JPEG) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document (PSD) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics (SVG) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [TIF](https://docs.fileformat.com/specification/image/tiff/)[, ](https://docs.fileformat.com/image/tiff/)[TIFF](https://docs.fileformat.com/specification/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile (WMF) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile (EMF) | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png)  |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format (PDF) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/signature/java/images/check.png) |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint Macro-Enabled Template | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Worksheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel template | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel Binary template | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel macro-enabled template | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/signature/java/images/check.png) |   |   | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |

---

## Supported Document Formats

Path: /watermark/java/supported-document-formats/


GroupDocs.Watermark for Java supports a wide range of file formats for adding, searching, and removing watermarks. Use the search box below to quickly find your format, or browse by category.

<div style="margin: 20px 0; padding: 15px; background: #f8f9fa; border-radius: 8px; border-left: 4px solid #007bff;">
  <div style="margin-bottom: 15px;">
    <input type="text" id="formatSearch" placeholder="🔍 Search for a file format (e.g., docx, pdf, png)..." 
           style="width: 100%; padding: 10px; border: 2px solid #ddd; border-radius: 6px; font-size: 16px;">
  </div>
  <div id="searchResults" style="display: none; margin-top: 15px; padding: 10px; background: white; border-radius: 6px; border: 1px solid #ddd;">
    <strong>Search Results:</strong>
    <div id="resultsList"></div>
  </div>
</div>

## 🚀 Quick Format Lookup

**Popular Formats:** [.docx](#-microsoft-word-formats) | [.pdf](#-pdf-formats) | [.xlsx](#-microsoft-excel-formats) | [.pptx](#-microsoft-powerpoint-formats) | [.png](#-image-formats) | [.jpg](#-image-formats)

Each format may support different watermarking capabilities:
- ✅ Full support (Add / Search / Remove)
- ⚠️ Partial support (some limitations)
- ❌ Not supported

---

## 📄 Microsoft Word Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.doc` | Microsoft Word 97 - 2007 Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dot` | Microsoft Word 97 - 2007 Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.docx` | Office Open XML WordprocessingML Document (macro-free) | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.docm` | Office Open XML WordprocessingML Macro-Enabled Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dotx` | Office Open XML WordprocessingML Template (macro-free) | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dotm` | Word Open XML Macro-Enabled Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.rtf` | Rich Text Format File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.odt` | ODF Text Document | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 See examples for [Word]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-word-processing-documents/_index.md" >}}) formats

---

## 📊 Microsoft Excel Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.xlsx` | OOXML 2007-2010 | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xlsm` | OOXML Macro Enabled Workbook | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xltm` | OOXML Macro Enabled Workbook Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xlt` | Microsoft Excel Template File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xltx` | Excel Open XML Spreadsheet Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xls` | Excel Workbook 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 Excel watermarking [examples]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-spreadsheet-documents/_index.md" >}})

---

## 📈 Microsoft PowerPoint Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.pptx` | OOXML Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.pptm` | OOXML Macro Enabled Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppsx` | OOXML SlideShow | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppsm` | OOXML Macros Enabled Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.potx` | OOXML Presentation Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.potm` | OOXML Macro Enabled Presentation Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppt` | PowerPoint Presentation 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.pps` | PowerPoint SlideShow 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 PowerPoint watermarking [examples]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-presentation-documents/_index.md" >}})

---

## 🧾 PDF Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.pdf` | PDF (Adobe Portable Document) format | ✅ | ✅ | ✅ | ✅ | ✅ | Watermark searching and removing is not available for rasterized pages |

📘 Add watermark to [PDF]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-pdf-documents/_index.md" >}})

---

## ✉️ Email Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.eml` | Email Message Format | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.emlx` | Apple Mail Message | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.oft` | Microsoft Outlook Email Template | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.msg` | Outlook Email Message Format | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |

📘 Add watermark to MSG [files]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-email-attachments/_index.md" >}})

---

## 🖼️ Image Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.bmp` | Bitmap Picture (BMP) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.gif` | Graphics Interchange Format (GIF) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.jpg` / `.jpeg` / `.jpe` | Joint Photographic Experts Group (JPEG) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.jp2` | JPEG2000 Core Image File | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.png` | Portable Network Graphics (PNG) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.tiff` | Tagged Image File Format (TIFF) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.webp` | WebP Image | ✅ | ✅ | ✅ | ❌ | ❌ | |

📘 Image watermarking [examples]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-images/_index.md" >}})

---

## 🎨 Microsoft Visio Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.vsd` | Microsoft Visio 2003-2010 Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vdx` | Microsoft Visio 2003-2010 XML Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsdx` | Microsoft Visio Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vstx` | Microsoft Visio File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vss` | Microsoft Visio 2003-2010 Stencil | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vssx` | Visio Stencil File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsdm` | Visio Macro-Enabled Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vssm` | Microsoft Visio Macro Enabled File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vstm` | Visio Macro-Enabled Drawing Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vtx` | VTX Chiptune File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsx` | Microsoft Visio 2003-2010 XML Stencil | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 Visio watermarking [examples]({{< ref "/watermark/java/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-diagram-documents/_index.md" >}})

---

## ℹ️ Notes

- Watermarking capabilities may vary depending on the document content and structure.
- For email formats, watermark operations are limited to attached documents and images within the email.
- For image formats, search and remove operations are not supported - only adding watermarks is available.
- PDF watermark searching and removing is not available for rasterized pages.
- For the latest updates, refer to the [Changelog](https://docs.groupdocs.com/watermark/java/release-notes/).
- If a format you need is not listed, feel free to [contact support](https://forum.groupdocs.com/).

---

{{< alert style="tip" >}}

**Can't find your file format?**

We're here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/watermark/19), and our team will assist you.

{{< /alert >}}


<script>
document.addEventListener('DOMContentLoaded', function() {
    const searchInput = document.getElementById('formatSearch');
    const searchResults = document.getElementById('searchResults');
    const resultsList = document.getElementById('resultsList');
    
    // Format database for search (Java version)
    const formats = [
        { ext: '.doc', name: 'Microsoft Word 97-2007 Document', category: 'Word', support: 'Full' },
        { ext: '.docx', name: 'Office Open XML WordprocessingML Document', category: 'Word', support: 'Full' },
        { ext: '.docm', name: 'Office Open XML WordprocessingML Macro-Enabled Document', category: 'Word', support: 'Full' },
        { ext: '.dot', name: 'Microsoft Word 97-2007 Template', category: 'Word', support: 'Full' },
        { ext: '.dotx', name: 'Office Open XML WordprocessingML Template', category: 'Word', support: 'Full' },
        { ext: '.dotm', name: 'Word Open XML Macro-Enabled Document', category: 'Word', support: 'Full' },
        { ext: '.rtf', name: 'Rich Text Format File', category: 'Word', support: 'Full' },
        { ext: '.odt', name: 'ODF Text Document', category: 'Word', support: 'Full' },
        
        { ext: '.xlsx', name: 'OOXML 2007-2010', category: 'Excel', support: 'Full' },
        { ext: '.xlsm', name: 'OOXML Macro Enabled Workbook', category: 'Excel', support: 'Full' },
        { ext: '.xltm', name: 'OOXML Macro Enabled Workbook Template', category: 'Excel', support: 'Full' },
        { ext: '.xlt', name: 'Microsoft Excel Template File', category: 'Excel', support: 'Full' },
        { ext: '.xltx', name: 'Excel Open XML Spreadsheet Template', category: 'Excel', support: 'Full' },
        { ext: '.xls', name: 'Excel Workbook 97-2003', category: 'Excel', support: 'Full' },
        
        { ext: '.pptx', name: 'OOXML Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.pptm', name: 'OOXML Macro Enabled Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppsx', name: 'OOXML SlideShow', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppsm', name: 'OOXML Macros Enabled Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.potx', name: 'OOXML Presentation Template', category: 'PowerPoint', support: 'Full' },
        { ext: '.potm', name: 'OOXML Macro Enabled Presentation Template', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppt', name: 'PowerPoint Presentation 97-2003', category: 'PowerPoint', support: 'Full' },
        { ext: '.pps', name: 'PowerPoint SlideShow 97-2003', category: 'PowerPoint', support: 'Full' },
        
        { ext: '.pdf', name: 'PDF (Adobe Portable Document) format', category: 'PDF', support: 'Full*' },
        
        { ext: '.eml', name: 'Email Message Format', category: 'Email', support: 'Partial' },
        { ext: '.emlx', name: 'Apple Mail Message', category: 'Email', support: 'Partial' },
        { ext: '.oft', name: 'Microsoft Outlook Email Template', category: 'Email', support: 'Partial' },
        { ext: '.msg', name: 'Outlook Email Message Format', category: 'Email', support: 'Partial' },
        
        { ext: '.bmp', name: 'Bitmap Picture', category: 'Image', support: 'Add Only' },
        { ext: '.gif', name: 'Graphics Interchange Format', category: 'Image', support: 'Add Only' },
        { ext: '.jpg', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jpeg', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jpe', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jp2', name: 'JPEG2000 Core Image File', category: 'Image', support: 'Add Only' },
        { ext: '.png', name: 'Portable Network Graphics', category: 'Image', support: 'Add Only' },
        { ext: '.tiff', name: 'Tagged Image File Format', category: 'Image', support: 'Add Only' },
        { ext: '.webp', name: 'WebP Image', category: 'Image', support: 'Add Only' },
        
        { ext: '.vsd', name: 'Microsoft Visio 2003-2010 Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vdx', name: 'Microsoft Visio 2003-2010 XML Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vsdx', name: 'Microsoft Visio Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vstx', name: 'Microsoft Visio File Format', category: 'Visio', support: 'Full' },
        { ext: '.vss', name: 'Microsoft Visio 2003-2010 Stencil', category: 'Visio', support: 'Full' },
        { ext: '.vssx', name: 'Visio Stencil File Format', category: 'Visio', support: 'Full' },
        { ext: '.vsdm', name: 'Visio Macro-Enabled Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vssm', name: 'Microsoft Visio Macro Enabled File Format', category: 'Visio', support: 'Full' },
        { ext: '.vstm', name: 'Visio Macro-Enabled Drawing Template', category: 'Visio', support: 'Full' },
        { ext: '.vtx', name: 'VTX Chiptune File', category: 'Visio', support: 'Full' },
        { ext: '.vsx', name: 'Microsoft Visio 2003-2010 XML Stencil', category: 'Visio', support: 'Full' }
    ];
    
    function getSupportIcon(support) {
        switch(support) {
            case 'Full': return '✅';
            case 'Full*': return '✅*';
            case 'Partial': return '⚠️';
            case 'Add Only': return '🔸';
            default: return '❌';
        }
    }
    
    function performSearch(query) {
        if (!query || query.length < 2) {
            searchResults.style.display = 'none';
            return;
        }
        
        query = query.toLowerCase();
        const matches = formats.filter(format => 
            format.ext.toLowerCase().includes(query) || 
            format.name.toLowerCase().includes(query) ||
            format.category.toLowerCase().includes(query)
        );
        
        if (matches.length > 0) {
            resultsList.innerHTML = matches.map(match => `
                <div style="padding: 8px; margin: 5px 0; background: #f0f8ff; border-left: 3px solid #007bff; border-radius: 4px;">
                    <strong>${match.ext}</strong> - ${match.name}
                    <br><small>Category: ${match.category} | Support: ${getSupportIcon(match.support)} ${match.support}</small>
                </div>
            `).join('');
            searchResults.style.display = 'block';
        } else {
            resultsList.innerHTML = '<div style="padding: 8px; color: #666;">No formats found matching your search.</div>';
            searchResults.style.display = 'block';
        }
    }
    
    searchInput.addEventListener('input', function(e) {
        performSearch(e.target.value);
    });
    
    searchInput.addEventListener('keydown', function(e) {
        if (e.key === 'Escape') {
            searchResults.style.display = 'none';
            searchInput.value = '';
        }
    });
    
    // Hide search results when clicking outside
    document.addEventListener('click', function(e) {
        if (!e.target.closest('#formatSearch') && !e.target.closest('#searchResults')) {
            searchResults.style.display = 'none';
        }
    });
});
</script>
---

## Supported Document Formats

Path: /watermark/net/supported-document-formats/


GroupDocs.Watermark for .NET supports a wide range of file formats for adding, searching, and removing watermarks. Use the search box below to quickly find your format, or browse by category.

<div style="margin: 20px 0; padding: 15px; background: #f8f9fa; border-radius: 8px; border-left: 4px solid #007bff;">
  <div style="margin-bottom: 15px;">
    <input type="text" id="formatSearch" placeholder="🔍 Search for a file format (e.g., docx, pdf, png)..." 
           style="width: 100%; padding: 10px; border: 2px solid #ddd; border-radius: 6px; font-size: 16px;">
  </div>
  <div id="searchResults" style="display: none; margin-top: 15px; padding: 10px; background: white; border-radius: 6px; border: 1px solid #ddd;">
    <strong>Search Results:</strong>
    <div id="resultsList"></div>
  </div>
</div>

## 🚀 Quick Format Lookup

**Popular Formats:** [.docx](#-microsoft-word-formats) | [.pdf](#-pdf-formats) | [.xlsx](#-microsoft-excel-formats) | [.pptx](#-microsoft-powerpoint-formats) | [.png](#-image-formats) | [.jpg](#-image-formats)

Each format may support different watermarking capabilities:
- ✅ Full support (Add / Search / Remove)
- ⚠️ Partial support (some limitations)
- ❌ Not supported

---

## 📄 Microsoft Word Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.doc` | Microsoft Word 97 - 2007 Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dot` | Microsoft Word 97 - 2007 Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.docx` | Office Open XML WordprocessingML Document (macro-free) | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.docm` | Office Open XML WordprocessingML Macro-Enabled Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dotx` | Office Open XML WordprocessingML Template (macro-free) | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dotm` | Word Open XML Macro-Enabled Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.rtf` | Rich Text Format File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.odt` | ODF Text Document | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 See examples for [Word]({{< ref "/watermark/net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-word-processing-documents/_index.md" >}}) formats

---

## 📊 Microsoft Excel Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.xlsx` | OOXML 2007-2010 | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xlsm` | OOXML Macro Enabled Workbook | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xltm` | OOXML Macro Enabled Workbook Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xlt` | Microsoft Excel Template File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xltx` | Excel Open XML Spreadsheet Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xls` | Excel Workbook 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 Excel watermarking [examples]({{< ref "/watermark/net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-spreadsheet-documents/_index.md" >}})

---

## 📈 Microsoft PowerPoint Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.pptx` | OOXML Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.pptm` | OOXML Macro Enabled Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppsx` | OOXML SlideShow | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppsm` | OOXML Macros Enabled Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.potx` | OOXML Presentation Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.potm` | OOXML Macro Enabled Presentation Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppt` | PowerPoint Presentation 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.pps` | PowerPoint SlideShow 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 PowerPoint watermarking [examples]({{< ref "/watermark/net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-presentation-documents/_index.md" >}})

---

## 🧾 PDF Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.pdf` | PDF (Adobe Portable Document) format | ✅ | ✅ | ✅ | ✅ | ✅ | Watermark searching and removing is not available for rasterized pages |

📘 Add watermark to [PDF]({{< ref "/watermark/net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-pdf-documents/_index.md" >}})

---

## ✉️ Email Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.eml` | Email Message Format | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.emlx` | Apple Mail Message | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.oft` | Microsoft Outlook Email Template | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.msg` | Outlook Email Message Format | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |

📘 Add watermark to MSG [files]({{< ref "/watermark/net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-email-attachments/_index.md" >}})

---

## 🖼️ Image Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.bmp` | Bitmap Picture (BMP) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.gif` | Graphics Interchange Format (GIF) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.jpg` / `.jpeg` / `.jpe` | Joint Photographic Experts Group (JPEG) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.jp2` | JPEG2000 Core Image File | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.png` | Portable Network Graphics (PNG) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.tiff` | Tagged Image File Format (TIFF) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.webp` | WebP Image | ✅ | ✅ | ✅ | ❌ | ❌ | |

📘 Image watermarking [examples]({{< ref "/watermark/net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-images/_index.md" >}})

---

## 🎨 Microsoft Visio Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.vsd` | Microsoft Visio 2003-2010 Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vdx` | Microsoft Visio 2003-2010 XML Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsdx` | Microsoft Visio Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vstx` | Microsoft Visio File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vss` | Microsoft Visio 2003-2010 Stencil | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vssx` | Visio Stencil File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsdm` | Visio Macro-Enabled Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vssm` | Microsoft Visio Macro Enabled File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vstm` | Visio Macro-Enabled Drawing Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vtx` | VTX Chiptune File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsx` | Microsoft Visio 2003-2010 XML Stencil | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 Visio watermarking [examples]({{< ref "/watermark/net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-diagram-documents/_index.md" >}})

---

## ℹ️ Notes

- Watermarking capabilities may vary depending on the document content and structure.
- For email formats, watermark operations are limited to attached documents and images within the email.
- For image formats, search and remove operations are not supported - only adding watermarks is available.
- PDF watermark searching and removing is not available for rasterized pages.
- For the latest updates, refer to the [Changelog](https://docs.groupdocs.com/watermark/net/release-notes/).
- If a format you need is not listed, feel free to [contact support](https://forum.groupdocs.com/).

---


{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/watermark/19), and our team will assist you.

{{< /alert >}}


<script>
document.addEventListener('DOMContentLoaded', function() {
    const searchInput = document.getElementById('formatSearch');
    const searchResults = document.getElementById('searchResults');
    const resultsList = document.getElementById('resultsList');
    
    // Format database for search
    const formats = [
        { ext: '.doc', name: 'Microsoft Word 97-2007 Document', category: 'Word', support: 'Full' },
        { ext: '.docx', name: 'Office Open XML WordprocessingML Document', category: 'Word', support: 'Full' },
        { ext: '.docm', name: 'Office Open XML WordprocessingML Macro-Enabled Document', category: 'Word', support: 'Full' },
        { ext: '.dot', name: 'Microsoft Word 97-2007 Template', category: 'Word', support: 'Full' },
        { ext: '.dotx', name: 'Office Open XML WordprocessingML Template', category: 'Word', support: 'Full' },
        { ext: '.dotm', name: 'Word Open XML Macro-Enabled Document', category: 'Word', support: 'Full' },
        { ext: '.rtf', name: 'Rich Text Format File', category: 'Word', support: 'Full' },
        { ext: '.odt', name: 'ODF Text Document', category: 'Word', support: 'Full' },
        
        { ext: '.xlsx', name: 'OOXML 2007-2010', category: 'Excel', support: 'Full' },
        { ext: '.xlsm', name: 'OOXML Macro Enabled Workbook', category: 'Excel', support: 'Full' },
        { ext: '.xltm', name: 'OOXML Macro Enabled Workbook Template', category: 'Excel', support: 'Full' },
        { ext: '.xlt', name: 'Microsoft Excel Template File', category: 'Excel', support: 'Full' },
        { ext: '.xltx', name: 'Excel Open XML Spreadsheet Template', category: 'Excel', support: 'Full' },
        { ext: '.xls', name: 'Excel Workbook 97-2003', category: 'Excel', support: 'Full' },
        
        { ext: '.pptx', name: 'OOXML Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.pptm', name: 'OOXML Macro Enabled Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppsx', name: 'OOXML SlideShow', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppsm', name: 'OOXML Macros Enabled Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.potx', name: 'OOXML Presentation Template', category: 'PowerPoint', support: 'Full' },
        { ext: '.potm', name: 'OOXML Macro Enabled Presentation Template', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppt', name: 'PowerPoint Presentation 97-2003', category: 'PowerPoint', support: 'Full' },
        { ext: '.pps', name: 'PowerPoint SlideShow 97-2003', category: 'PowerPoint', support: 'Full' },
        
        { ext: '.pdf', name: 'PDF (Adobe Portable Document) format', category: 'PDF', support: 'Full*' },
        
        { ext: '.eml', name: 'Email Message Format', category: 'Email', support: 'Partial' },
        { ext: '.emlx', name: 'Apple Mail Message', category: 'Email', support: 'Partial' },
        { ext: '.oft', name: 'Microsoft Outlook Email Template', category: 'Email', support: 'Partial' },
        { ext: '.msg', name: 'Outlook Email Message Format', category: 'Email', support: 'Partial' },
        
        { ext: '.bmp', name: 'Bitmap Picture', category: 'Image', support: 'Add Only' },
        { ext: '.gif', name: 'Graphics Interchange Format', category: 'Image', support: 'Add Only' },
        { ext: '.jpg', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jpeg', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jpe', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jp2', name: 'JPEG2000 Core Image File', category: 'Image', support: 'Add Only' },
        { ext: '.png', name: 'Portable Network Graphics', category: 'Image', support: 'Add Only' },
        { ext: '.tiff', name: 'Tagged Image File Format', category: 'Image', support: 'Add Only' },
        { ext: '.webp', name: 'WebP Image', category: 'Image', support: 'Add Only' },
        
        { ext: '.vsd', name: 'Microsoft Visio 2003-2010 Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vdx', name: 'Microsoft Visio 2003-2010 XML Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vsdx', name: 'Microsoft Visio Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vstx', name: 'Microsoft Visio File Format', category: 'Visio', support: 'Full' },
        { ext: '.vss', name: 'Microsoft Visio 2003-2010 Stencil', category: 'Visio', support: 'Full' },
        { ext: '.vssx', name: 'Visio Stencil File Format', category: 'Visio', support: 'Full' },
        { ext: '.vsdm', name: 'Visio Macro-Enabled Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vssm', name: 'Microsoft Visio Macro Enabled File Format', category: 'Visio', support: 'Full' },
        { ext: '.vstm', name: 'Visio Macro-Enabled Drawing Template', category: 'Visio', support: 'Full' },
        { ext: '.vtx', name: 'VTX Chiptune File', category: 'Visio', support: 'Full' },
        { ext: '.vsx', name: 'Microsoft Visio 2003-2010 XML Stencil', category: 'Visio', support: 'Full' }
    ];
    
    function getSupportIcon(support) {
        switch(support) {
            case 'Full': return '✅';
            case 'Full*': return '✅*';
            case 'Partial': return '⚠️';
            case 'Add Only': return '🔸';
            default: return '❌';
        }
    }
    
    function performSearch(query) {
        if (!query || query.length < 2) {
            searchResults.style.display = 'none';
            return;
        }
        
        query = query.toLowerCase();
        const matches = formats.filter(format => 
            format.ext.toLowerCase().includes(query) || 
            format.name.toLowerCase().includes(query) ||
            format.category.toLowerCase().includes(query)
        );
        
        if (matches.length > 0) {
            resultsList.innerHTML = matches.map(match => `
                <div style="padding: 8px; margin: 5px 0; background: #f0f8ff; border-left: 3px solid #007bff; border-radius: 4px;">
                    <strong>${match.ext}</strong> - ${match.name}
                    <br><small>Category: ${match.category} | Support: ${getSupportIcon(match.support)} ${match.support}</small>
                </div>
            `).join('');
            searchResults.style.display = 'block';
        } else {
            resultsList.innerHTML = '<div style="padding: 8px; color: #666;">No formats found matching your search.</div>';
            searchResults.style.display = 'block';
        }
    }
    
    searchInput.addEventListener('input', function(e) {
        performSearch(e.target.value);
    });
    
    searchInput.addEventListener('keydown', function(e) {
        if (e.key === 'Escape') {
            searchResults.style.display = 'none';
            searchInput.value = '';
        }
    });
    
    // Hide search results when clicking outside
    document.addEventListener('click', function(e) {
        if (!e.target.closest('#formatSearch') && !e.target.closest('#searchResults')) {
            searchResults.style.display = 'none';
        }
    });
});
</script>
---

## Supported Document Types

Path: /merger/java/supported-document-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Extract pages | Move page | Remove pages | Swap pages | Change page orientation | Rotate pages | Import document | Cross-format merge to PDF / XPS | Cross-format merge to DOC / DOCX |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Open XML Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Word Open XML Macro-Enabled Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Word Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Word Open XML Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Word Open XML Macro-Enabled Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) |   |
| [MHT](https://docs.fileformat.com/web/mhtml/) | MHTML Web Archive |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [PDF](https://docs.fileformat.com/view/pdf/) | Portable Document Format File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | XML Paper Specification File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File  | ![(tick)](/merger/net/images/check.png)|     |     |     |     |     |     |     |     |   |     |     |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel Template File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Excel Open XML Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Excel Open XML Macro-Enabled Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Open XML Macro-Enabled Add-in | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Microsoft Visio Macro-Enabled Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Microsoft Visio Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Microsoft Visio Macro-Enabled Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Microsoft Visio Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Microsoft Visio Macro-Enabled Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VTX](https://docs.fileformat.com/image/vtx/) | Microsoft Visio 2003-2010 XML Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [ERR](https://docs.fileformat.com/misc/err/) | Error Log File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/merger/32), and our team will assist you.

{{< /alert >}}
---

## Supported file formats

Path: /conversion/java/supported-file-formats/

{{< alert style="tip" >}}

Need to convert files online? Try the [GroupDocs.Conversion App](https://products.groupdocs.app/conversion/total) to convert DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Conversion for Java. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/conversion/11">}}

{{< include file="/conversion/java/_includes/supported-conversions/formats-brief.md" type="page" >}}


---

## Supported file formats

Path: /conversion/net/supported-file-formats/


{{< alert style="tip" >}}

Need to convert files online? Try the [GroupDocs.Conversion App](https://products.groupdocs.app/conversion/total) to convert DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Conversion for .NET. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/conversion/11">}}

{{< include file="/conversion/net/_includes/supported-conversions/formats-brief.md" type="page" >}}
---

## Supported file formats

Path: /conversion/nodejs-java/supported-file-formats/


{{< alert style="tip" >}}

Need to convert files online? Try the [GroupDocs.Conversion App](https://products.groupdocs.app/conversion/total) to convert DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Conversion for Node.js via Java. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/conversion/11">}}

{{< include file="/conversion/nodejs-java/_includes/supported-conversions/formats-brief.md" type="page" >}}


---

## Supported file formats

Path: /markdown/net/supported-file-formats/


This topic lists file formats supported by GroupDocs.Markdown for .NET. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/markdown/">}}

## PDF
| Format | Description | Support |
| --- | --- | :---: |
| [PDF](https://docs.fileformat.com/pdf/) | Portable Document Format File |<!--Support--> ✅ |

## Word Processing
| Format | Description | Support |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document |<!--Support--> ✅ |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document |<!--Support--> ✅ |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Open XML Document |<!--Support--> ✅ |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template |<!--Support--> ✅ |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template |<!--Support--> ✅ |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Open XML Template |<!--Support--> ✅ |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text Document |<!--Support--> ✅ |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template |<!--Support--> ✅ |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File |<!--Support--> ✅ |

## Spreadsheet
| Format | Description | Support |
| --- | --- | :---: |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma-Separated Values File |<!--Support--> ✅ |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | OpenDocument Flat XML Spreadsheet |<!--Support--> ✅ |
| [NUMBERS](https://docs.fileformat.com/spreadsheet/numbers/) | Apple iWork Numbers |<!--Support--> ✅ |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet |<!--Support--> ✅ |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template |<!--Support--> ✅ |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice Calc Spreadsheet |<!--Support--> ✅ |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab-Separated Values File |<!--Support--> ✅ |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Add-in |<!--Support--> ✅ |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Spreadsheet |<!--Support--> ✅ |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Spreadsheet |<!--Support--> ✅ |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Spreadsheet |<!--Support--> ✅ |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Open XML Spreadsheet |<!--Support--> ✅ |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template |<!--Support--> ✅ |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template |<!--Support--> ✅ |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Open XML Template |<!--Support--> ✅ |

## eBook
| Format | Description | Support |
| --- | --- | :---: |
| [AZW3](https://docs.fileformat.com/ebook/azw3/) | Amazon Kindle Format 8 |<!--Support--> ✅ |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File |<!--Support--> ✅ |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket eBook |<!--Support--> ✅ |

## Help
| Format | Description | Support |
| --- | --- | :---: |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help File |<!--Support--> ✅ |

## Text
| Format | Description | Support |
| --- | --- | :---: |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text File |<!--Support--> ✅ |
| [XML](https://docs.fileformat.com/web/xml/) | XML File |<!--Support--> ✅ |

---

## Supported file formats

Path: /markdown/python-net/supported-file-formats/


This topic lists file formats supported by GroupDocs.Markdown for Python via .NET. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/markdown/">}}

## PDF
| Format | Description | Support |
| --- | --- | :---: |
| [PDF](https://docs.fileformat.com/pdf/) | Portable Document Format File |<!--Support--> ✅ |

## Word Processing
| Format | Description | Support |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document |<!--Support--> ✅ |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document |<!--Support--> ✅ |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Open XML Document |<!--Support--> ✅ |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template |<!--Support--> ✅ |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template |<!--Support--> ✅ |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Open XML Template |<!--Support--> ✅ |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text Document |<!--Support--> ✅ |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template |<!--Support--> ✅ |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File |<!--Support--> ✅ |

## Spreadsheet
| Format | Description | Support |
| --- | --- | :---: |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma-Separated Values File |<!--Support--> ✅ |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | OpenDocument Flat XML Spreadsheet |<!--Support--> ✅ |
| [NUMBERS](https://docs.fileformat.com/spreadsheet/numbers/) | Apple iWork Numbers |<!--Support--> ✅ |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet |<!--Support--> ✅ |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template |<!--Support--> ✅ |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice Calc Spreadsheet |<!--Support--> ✅ |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab-Separated Values File |<!--Support--> ✅ |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Add-in |<!--Support--> ✅ |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Spreadsheet |<!--Support--> ✅ |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Spreadsheet |<!--Support--> ✅ |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Spreadsheet |<!--Support--> ✅ |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Open XML Spreadsheet |<!--Support--> ✅ |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template |<!--Support--> ✅ |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template |<!--Support--> ✅ |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Open XML Template |<!--Support--> ✅ |

## eBook
| Format | Description | Support |
| --- | --- | :---: |
| [AZW3](https://docs.fileformat.com/ebook/azw3/) | Amazon Kindle Format 8 |<!--Support--> ✅ |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File |<!--Support--> ✅ |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket eBook |<!--Support--> ✅ |

## Help
| Format | Description | Support |
| --- | --- | :---: |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help File |<!--Support--> ✅ |

## Text
| Format | Description | Support |
| --- | --- | :---: |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text File |<!--Support--> ✅ |
| [XML](https://docs.fileformat.com/web/xml/) | XML File |<!--Support--> ✅ |

---

## Supported file formats

Path: /total/java/supported-document-formats/


Explore the diverse file formats supported by GroupDocs.Total for Java! Each product within the suite caters to specific file types. To ensure seamless integration, visit the dedicated documentation page for your desired product and discover the comprehensive list of supported formats.

| Product | Documentation page|
| --- | --- |
| GroupDocs.Annotation for Java | [supported file formats](https://docs.groupdocs.com/annotation/java/supported-document-formats/) |
| GroupDocs.Assembly for Java | [supported file formats](https://docs.groupdocs.com/assembly/java/supported-document-formats/) |
| GroupDocs.Conversion for Java | [supported file formats](https://docs.groupdocs.com/conversion/java/supported-file-formats/) |
| GroupDocs.Comparison for Java | [supported file formats](https://docs.groupdocs.com/comparison/java/supported-document-formats/) |
| GroupDocs.Editor for Java | [supported file formats](https://docs.groupdocs.com/editor/java/supported-document-formats/) |
| GroupDocs.Merger for Java | [supported file formats](https://docs.groupdocs.com/merger/java/supported-document-formats/) |
| GroupDocs.Metadata for Java | [supported file formats](https://docs.groupdocs.com/metadata/java/supported-document-formats/) |
| GroupDocs.Parser for Java | [supported file formats](https://docs.groupdocs.com/parser/java/supported-document-formats/) |
| GroupDocs.Redaction for Java | [supported file formats](https://docs.groupdocs.com/redaction/java/supported-document-formats/) |
| GroupDocs.Search for Java | [supported file formats](https://docs.groupdocs.com/search/java/supported-document-formats/) |
| GroupDocs.Signature for Java | [supported file formats](https://docs.groupdocs.com/signature/java/supported-document-formats/) |
| GroupDocs.Viewer for Java | [supported file formats](https://docs.groupdocs.com/viewer/java/supported-document-formats/) |
| GroupDocs.Watermark for Java | [supported file formats](https://docs.groupdocs.com/watermark/java/supported-document-formats/) |


---

## Supported file formats

Path: /total/net/supported-document-formats/


Explore the diverse file formats supported by GroupDocs.Total for .NET! Each product within the suite caters to specific file types. To ensure seamless integration, visit the dedicated documentation page for your desired product and discover the comprehensive list of supported formats.

| Product | Documentation page|
| --- | --- |
| GroupDocs.Conversion&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/conversion/net/supported-file-formats/) |
| GroupDocs.Viewer&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/viewer/net/supported-document-formats/) |
| GroupDocs.Comparison&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/comparison/net/supported-document-formats/) |
| GroupDocs.Watermark&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/watermark/net/supported-document-formats/) |
| GroupDocs.Merger&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/merger/net/supported-document-formats/) |
| GroupDocs.Metadata&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/metadata/net/supported-document-formats/) |
| GroupDocs.Search&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/search/net/supported-document-formats/) |
| GroupDocs.Assembly&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/assembly/net/supported-document-formats/) |
| GroupDocs.Signature&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/signature/net/supported-document-formats/) |
| GroupDocs.Editor&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/editor/net/supported-document-formats/) |
| GroupDocs.Parser&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/parser/net/supported-document-formats/) |
| GroupDocs.Redaction&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/redaction/net/supported-document-formats/) |
| GroupDocs.Annotation&nbsp;for&nbsp;.NET | [supported file formats](https://docs.groupdocs.com/annotation/net/supported-document-formats/) |

---

## Supported file formats

Path: /viewer/java/supported-document-formats/


{{< alert style="tip" >}}

Need to view files online? Try the [GroupDocs.Viewer App](https://products.groupdocs.app/viewer/total) to open DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Viewer for Java. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" >}}

## Archive and compression file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [BZ2](https://docs.fileformat.com/compression/bz2) | Bzip2 Compressed File | ![(tick)](/viewer/java/images/check-blue.png) |
| [GZ](https://docs.fileformat.com/compression/gz) | Gnu Zipped Archive | ![(tick)](/viewer/java/images/check-blue.png) |
| [RAR](https://docs.fileformat.com/compression/rar) | WinRAR Compressed Archive | ![(tick)](/viewer/java/images/check-blue.png) |
| [TAR](https://docs.fileformat.com/compression/tar) | Consolidated Unix File Archive | ![(tick)](/viewer/java/images/check-blue.png) |
| [TGZ](https://docs.fileformat.com/compression/tgz/) | Gzipped Tar File | ![(tick)](/viewer/java/images/check-blue.png) |
| [TXZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Tar Archive | ![(tick)](/viewer/java/images/check-blue.png) |
| [XZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Archive | ![(tick)](/viewer/java/images/check-blue.png) |
| [ZIP](https://docs.fileformat.com/compression/zip) | Zipped File | ![(tick)](/viewer/java/images/check-blue.png) |
| [LHA / LZH](https://docs.fileformat.com/compression/lzh/) | Lha/Lzh Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [CAB](https://en.wikipedia.org/wiki/Cabinet_(file_format)) | Cabinet | ![(tick)](/viewer/net/images/check-blue.png) |
| [WIM](https://docs.fileformat.com/disc-and-media/wim/) | Windows Imaging Format | ![(tick)](/viewer/net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view archive files: [Render archives as HTML, PDF, and image files](/viewer/java/render-archive-files).

## CAD and 3D file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CF2](https://docs.fileformat.com/cad/cf2/) | Common File Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DGN](https://docs.fileformat.com/cad/dgn) | MicroStation Design File (V7) | ![(tick)](/viewer/java/images/check-blue.png) | DGN V8 is not supported <br> as DGN V8 file format <br> is proprietary. |
| [DWF](https://docs.fileformat.com/cad/dwf/) | Design Web Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ![(tick)](/viewer/java/images/check-blue.png) | Supported formats: <br> Release 11, 12, 13, 14. <br> DWG 2000, 2000i, 2002. <br> DWG 2004, 2005, 2006. <br> DWG 2010, 2011, 2012. <br> DWG 2013, 2014, 2015, 2016. |
| [DWT](https://docs.fileformat.com/cad/dwt/) | AutoCAD Drawing Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [HPG](https://docs.fileformat.com/cad/hpgl/) | HPGL (Hewlett-Packard Graphics Language) Plot File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [IFC](https://docs.fileformat.com/cad/ifc/) | Industry Foundation Classes | ![(tick)](/viewer/java/images/check-blue.png) | |
| [IGS](https://docs.fileformat.com/cad/igs/) | IGES (Initial Graphics Exchange Specification) Drawing | ![(tick)](/viewer/java/images/check-blue.png) |
| [OBJ](https://docs.fileformat.com/3d/obj/) | Wavefront 3D Object File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PLT](https://docs.fileformat.com/cad/plt/) | AutoCAD Plotter Document | ![(tick)](/viewer/java/images/check-blue.png) | |
| [STL](https://docs.fileformat.com/cad/stl/) | Stereolithography File | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view CAD files: [Render CAD drawings and models as HTML, PDF, and image files](/viewer/java/render-cad-drawings-and-models).

## Database file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: |
| [NSF](https://docs.fileformat.com/database/nsf/) | Lotus Notes Database File | ![(tick)](/viewer/java/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view NSF files: [Render Lotus Notes database files as HTML, PDF, and image files](/viewer/java/render-lotus-notes-database-files/).

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open EBook Format | ![(tick)](/viewer/java/images/check-blue.png) |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ![(tick)](/viewer/java/images/check-blue.png) |

## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ![(tick)](/viewer/java/images/check-blue.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ![(tick)](/viewer/java/images/check-blue.png) |
| [MBOX](https://docs.fileformat.com/email/mbox/) | Email Mailbox File | ![(tick)](/viewer/java/images/check-blue.png) |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ![(tick)](/viewer/java/images/check-blue.png) |
| [VCARD / VCF](https://docs.fileformat.com/email/vcf/) | vCard (Virtual Contact) File | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view email messages: [Render email messages as HTML, PDF, PNG, and JPEG files](/viewer/java/render-email-messages/).

## Image file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [AI](https://docs.fileformat.com/image/ai/) | Adobe Illustrator Artwork | ![(tick)](/viewer/java/images/check-blue.png) | Supported versions: 2, 3, 8 |
| [APNG](https://docs.fileformat.com/image/apng/) | Animated Portable Network Graphic | ![(tick)](/viewer/java/images/check-blue.png) | |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [CDR](https://docs.fileformat.com/image/cdr/) | CorelDRAW Image File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [CGM](https://docs.fileformat.com/page-description-language/cgm/) | Computer Graphics Metafile | ![(tick)](/viewer/java/images/check-blue.png) | |
| [CMX](https://docs.fileformat.com/image/cmx/) | Corel Presentation Exchange Image | ![(tick)](/viewer/java/images/check-blue.png) |  Supported version: 2.0 with 32-bit precision (16-bit precision is partially supported). |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DIB](https://docs.fileformat.com/image/dib/) | Device Independent Bitmap File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile | ![(tick)](/viewer/java/images/check-blue.png) | |
| [EMZ](https://docs.fileformat.com/image/emz/) | Windows Compressed Enhanced Metafile | ![(tick)](/viewer/java/images/check-blue.png) | |
| [EPS](https://docs.fileformat.com/page-description-language/eps/) | Encapsulated PostScript File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [FODG](https://docs.fileformat.com/image/jpc/) | OpenDocument Flat XML Graphics | ![(tick)](/viewer/java/images/check-blue.png) | |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [ICO](https://docs.fileformat.com/image/ico/) | Windows Icon File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [J2C](https://docs.fileformat.com/image/j2c/) | JPEG 2000 Code Stream | ![(tick)](/viewer/java/images/check-blue.png) | |
| [J2K](https://docs.fileformat.com/image/j2k/) | JPEG 2000 Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG 2000 Core Image File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [JPC](https://docs.fileformat.com/image/jpc/) | JPEG 2000 Code Stream File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [JPF](https://docs.fileformat.com/image/jpf/) | JPEG 2000 Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [JPM](https://docs.fileformat.com/image/jpm/) | JPEG 2000 Multi-layer Image Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [JPX](https://docs.fileformat.com/image/jpx/) | JPEG 2000 Image File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [ODG](https://docs.fileformat.com/image/odg/) | OpenDocument Graphics File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [OTG](https://docs.fileformat.com/image/otg/) | OpenDocument Graphics Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PCL](https://docs.fileformat.com/page-description-language/pcl/) | Printer Command Language Document | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PSB](https://docs.fileformat.com/image/psb/) | Photoshop Large Document Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document | ![(tick)](/viewer/java/images/check-blue.png) | |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [SVGZ](https://docs.fileformat.com/image/svgz/) | Compressed SVG File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [TGA](https://docs.fileformat.com/image/tga/) | TARGA (Truevision Advanced Raster Graphics Adapter) Graphics | ![(tick)](/viewer/java/images/check-blue.png) | |
| [TIF / TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/viewer/java/images/check-blue.png) | |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile | ![(tick)](/viewer/java/images/check-blue.png) | |
| [WMZ](https://docs.fileformat.com/image/wmz/) | Compressed Windows Metafile | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view image files: [Render images as HTML, PDF, PNG, and JPEG files](/viewer/java/render-images/).

## Note-taking file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ![(tick)](/viewer/java/images/check-blue.png) | |

## Outlook data file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [OST](https://docs.fileformat.com/email/ost/) | Outlook Offline Storage Table | ![(tick)](/viewer/java/images/check-blue.png) |
| [PST](https://docs.fileformat.com/email/pst/) | Outlook Personal Storage Table | ![(tick)](/viewer/java/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Outlook data files: [Render Outlook data files as HTML, PDF, and image files](/viewer/java/render-outlook-data-files/).

## PDF and Page Layout file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [OXPS](https://docs.fileformat.com/page-description-language/oxps/) | OpenXPS (Open XML Paper Specification) File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ![(tick)](/viewer/java/images/check-blue.png) | |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | Microsoft XML Paper Specification | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view PDF files: [Render PDF documents as HTML and image files](/viewer/java/render-pdf-documents/).

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [FODP](https://docs.fileformat.com/) | OpenDocument Flat XML Presentation | ![(tick)](/viewer/java/images/check-blue.png) | |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/viewer/java/images/check-blue.png) | |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint Macro-Enabled Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/viewer/java/images/check-blue.png) | |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view presentations: [Render PowerPoint presentations as HTML, PDF, and image files](/viewer/java/render-presentations/).

## Project Management file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project | ![(tick)](/viewer/java/images/check-blue.png) | |
| [MPT](https://docs.fileformat.com/project-management/mpt/) | Microsoft Project Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [MPX](https://docs.fileformat.com/project-management/mpx/) | Microsoft Project Exchange File | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Project files: [Render Microsoft Project documents as HTML, PDF, and image files](/viewer/java/render-ms-project-files/).

## Spreadsheet file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | OpenDocument Flat XML Spreadsheet | ![(tick)](/viewer/java/images/check-blue.png) | |
| [NUMBERS](https://docs.fileformat.com/spreadsheet/numbers/) | Apple Numbers Spreadsheet | ![(tick)](/viewer/java/images/check-blue.png) | GroupDocs.Viewer supports version 3.5 and higher starting with v21.8.
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/viewer/java/images/check-blue.png) | |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice Calc Spreadsheet | ![(tick)](/viewer/java/images/check-blue.png) | |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ![(tick)](/viewer/java/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0), Excel 95 (7.0), Excel 5.0. |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ![(tick)](/viewer/java/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0). |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Add-In | ![(tick)](/viewer/java/images/check-blue.png) | |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view spreadsheet files: [Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files](/viewer/java/render-excel-and-apple-numbers-spreadsheets/).

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ![(tick)](/viewer/java/images/check-blue.png) |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | |
| [JAVA](https://docs.fileformat.com/programming/java/) | Java Source Code File | |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | |
| [SCM](https://docs.fileformat.com/programming/scm/) | Scheme Source Code File | |
| [SCRIPT](https://docs.fileformat.com/programming/script/) | Generic Script File | |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | |
| [SML](https://en.wikipedia.org/wiki/Standard_ML) | Standard ML Source Code File | |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ![(tick)](/viewer/java/images/check-blue.png) |
| [VB](https://docs.fileformat.com/specification/programming/vb/) | Visual Basic Source Code File | ![(tick)](/viewer/java/images/check-blue.png) |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ![(tick)](/viewer/java/images/check-blue.png) |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view text and code files: [Render text documents as HTML, PDF, and image files](/viewer/java/render-text-files/).

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDW](https://docs.fileformat.com/web/vdw/) | Visio Web Drawing | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Visio Macro-Enabled Drawing | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Visio Macro-Enabled Stencil | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Visio Stencil | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Visio Macro-Enabled Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Visio Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VSX](https://docs.fileformat.com/image/vsx/) | Visio Stencil XML File | ![(tick)](/viewer/java/images/check-blue.png) | |
| [VTX](https://docs.fileformat.com/image/vtx/) | Visio Template XML File | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Visio files: [Render Visio documents as HTML, PDF, and image files](/viewer/java/render-visio-documents/).

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help Format | ![(tick)](/viewer/java/images/check-blue.png) |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ![(tick)](/viewer/java/images/check-blue.png) |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ![(tick)](/viewer/java/images/check-blue.png) |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ![(tick)](/viewer/java/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view web files: [Render web documents as PDF, PNG, and JPEG files](/viewer/java/render-web-documents/).

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/viewer/java/images/check-blue.png) | |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/viewer/java/images/check-blue.png) | |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/viewer/java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Word documents: [Render Word documents as HTML, PDF, and image files](/viewer/java/render-word-documents/).



---

## Supported file formats

Path: /viewer/net/supported-document-formats/


{{< alert style="tip" >}}

Need to view files online? Try the [GroupDocs.Viewer App](https://products.groupdocs.app/viewer/total) to open DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Viewer for .NET. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/viewer/9">}}

## Archive and compression file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [7Z](https://docs.fileformat.com/compression/7z/) | 7-Zip Compressed File | ![(tick)](/viewer/net/images/check-blue.png) |
| [BZ2](https://docs.fileformat.com/compression/bz2) | Bzip2 Compressed File | ![(tick)](/viewer/net/images/check-blue.png) |
| [GZ](https://docs.fileformat.com/compression/gz) | Gnu Zipped Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [RAR](https://docs.fileformat.com/compression/rar) | WinRAR Compressed Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [TAR](https://docs.fileformat.com/compression/tar) | Consolidated Unix File Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [TGZ](https://docs.fileformat.com/compression/tgz/) | Gzipped Tar File | ![(tick)](/viewer/net/images/check-blue.png) |
| [TXZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Tar Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [XZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [ZIP](https://docs.fileformat.com/compression/zip) | Zipped File | ![(tick)](/viewer/net/images/check-blue.png) |
| [Zstandard](https://docs.fileformat.com/compression/zst) | Zstandard Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [ISO](https://docs.fileformat.com/compression/iso) | Optical Disk Image | ![(tick)](/viewer/net/images/check-blue.png) |
| [LHA / LZH](https://docs.fileformat.com/compression/lzh/) | Lha/Lzh Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [CAB](https://en.wikipedia.org/wiki/Cabinet_(file_format)) | Cabinet | ![(tick)](/viewer/net/images/check-blue.png) |
| [WIM](https://docs.fileformat.com/disc-and-media/wim/) | Windows Imaging Format | ![(tick)](/viewer/net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view archive files: [Render archives as HTML, PDF, and image files](/viewer/net/render-archive-files).

## CAD and 3D file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CF2](https://docs.fileformat.com/cad/cf2/) | Common File Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DGN](https://docs.fileformat.com/cad/dgn) | MicroStation Design File (V7) | ![(tick)](/viewer/net/images/check-blue.png) | DGN V8 is not supported <br> as DGN V8 file format <br> is proprietary. |
| [DWF](https://docs.fileformat.com/cad/dwf/) | Design Web Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ![(tick)](/viewer/net/images/check-blue.png) | Supported formats: <br> Release 11, 12, 13, 14. <br> DWG 2000, 2000i, 2002. <br> DWG 2004, 2005, 2006. <br> DWG 2010, 2011, 2012. <br> DWG 2013, 2014, 2015, 2016. |
| [DWT](https://docs.fileformat.com/cad/dwt/) | AutoCAD Drawing Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [HPG](https://docs.fileformat.com/cad/hpgl/) | HPGL (Hewlett-Packard Graphics Language) Plot File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [IFC](https://docs.fileformat.com/cad/ifc/) | Industry Foundation Classes | ![(tick)](/viewer/net/images/check-blue.png) | |
| [IGS](https://docs.fileformat.com/cad/igs/) | IGES (Initial Graphics Exchange Specification) Drawing | ![(tick)](/viewer/net/images/check-blue.png) |
| [OBJ](https://docs.fileformat.com/3d/obj/) | Wavefront 3D Object File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PLT](https://docs.fileformat.com/cad/plt/) | AutoCAD Plotter Document | ![(tick)](/viewer/net/images/check-blue.png) | |
| [STL](https://docs.fileformat.com/cad/stl/) | Stereolithography File | ![(tick)](/viewer/net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view CAD files: [Render CAD drawings and models as HTML, PDF, and image files](/viewer/net/render-cad-drawings-and-models).

## Database file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: |
| [NSF](https://docs.fileformat.com/database/nsf/) | Lotus Notes Database File | ![(tick)](/viewer/net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view NSF files: [Render Lotus Notes database files as HTML, PDF, and image files](/viewer/net/render-lotus-notes-database-files/).

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open EBook Format | ![(tick)](/viewer/net/images/check-blue.png) |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ![(tick)](/viewer/net/images/check-blue.png) |
| [AZW3](https://docs.fileformat.com/ebook/azw3/) | AZ3/KF8 EBook Format| ![(tick)](/viewer/net/images/check-blue.png) |

## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ![(tick)](/viewer/net/images/check-blue.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ![(tick)](/viewer/net/images/check-blue.png) |
| [MBOX](https://docs.fileformat.com/email/mbox/) | Email Mailbox File | ![(tick)](/viewer/net/images/check-blue.png) |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ![(tick)](/viewer/net/images/check-blue.png) |
| [VCARD / VCF](https://docs.fileformat.com/email/vcf/) | vCard (Virtual Contact) File | ![(tick)](/viewer/net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view email messages: [Render email messages as HTML, PDF, PNG, and JPEG files](/viewer/net/render-email-messages/).

## Image file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [AI](https://docs.fileformat.com/image/ai/) \* | Adobe Illustrator Artwork | ![(tick)](/viewer/net/images/check-blue.png) | Supported versions: 2, 3, 8 |
| [APNG](https://docs.fileformat.com/image/apng/) | Animated Portable Network Graphic | ![(tick)](/viewer/net/images/check-blue.png) | |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [CDR](https://docs.fileformat.com/image/cdr/) | CorelDRAW Image File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [CGM](https://docs.fileformat.com/page-description-language/cgm/) | Computer Graphics Metafile | ![(tick)](/viewer/net/images/check-blue.png) | |
| [CMX](https://docs.fileformat.com/image/cmx/) | Corel Presentation Exchange Image | ![(tick)](/viewer/net/images/check-blue.png) |  Supported version: 2.0 with 32-bit precision (16-bit precision is partially supported). |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DIB](https://docs.fileformat.com/image/dib/) | Device Independent Bitmap File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile | ![(tick)](/viewer/net/images/check-blue.png) | |
| [EMZ](https://docs.fileformat.com/image/emz/) | Windows Compressed Enhanced Metafile | ![(tick)](/viewer/net/images/check-blue.png) | |
| [EPS](https://docs.fileformat.com/page-description-language/eps/) | Encapsulated PostScript File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [FODG](https://docs.fileformat.com/image/jpc/) | OpenDocument Flat XML Graphics | ![(tick)](/viewer/net/images/check-blue.png) | |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [ICO](https://docs.fileformat.com/image/ico/) | Windows Icon File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [J2C](https://docs.fileformat.com/image/j2c/) | JPEG 2000 Code Stream | ![(tick)](/viewer/net/images/check-blue.png) | |
| [J2K](https://docs.fileformat.com/image/j2k/) | JPEG 2000 Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG 2000 Core Image File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JPC](https://docs.fileformat.com/image/jpc/) | JPEG 2000 Code Stream File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JFIF](https://docs.fileformat.com/image/jfif) | JPEG File Interchange Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JPF](https://docs.fileformat.com/image/jpf/) | JPEG 2000 Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JPM](https://docs.fileformat.com/image/jpm/) | JPEG 2000 Multi-layer Image Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JPX](https://docs.fileformat.com/image/jpx/) | JPEG 2000 Image File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JLS](https://docs.fileformat.com/) | JPEG-LS Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [ODG](https://docs.fileformat.com/image/odg/) | OpenDocument Graphics File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [OTG](https://docs.fileformat.com/image/otg/) | OpenDocument Graphics Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PCL](https://docs.fileformat.com/page-description-language/pcl/) | Printer Command Language Document | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PSB](https://docs.fileformat.com/image/psb/) \* | Photoshop Large Document Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PSD](https://docs.fileformat.com/image/psd/) \* | Adobe Photoshop Document | ![(tick)](/viewer/net/images/check-blue.png) | |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [SVGZ](https://docs.fileformat.com/image/svgz/) | Compressed SVG File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [TGA](https://docs.fileformat.com/image/tga/) | TARGA (Truevision Advanced Raster Graphics Adapter) Graphics | ![(tick)](/viewer/net/images/check-blue.png) | |
| [TIF / TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile | ![(tick)](/viewer/net/images/check-blue.png) | |
| [WMZ](https://docs.fileformat.com/image/wmz/) | Compressed Windows Metafile | ![(tick)](/viewer/net/images/check-blue.png) | |

{{< alert style="info" >}}AI, PSB, and PSD formats, marked by asterisk (\*), currently are not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view image files: [Render images as HTML, PDF, PNG, and JPEG files](/viewer/net/render-images/).

## Note-taking file formats

{{< alert style="info" >}}Note file formats family currently is not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ![(tick)](/viewer/net/images/check-blue.png) | |

## Outlook data file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [OST](https://docs.fileformat.com/email/ost/) | Outlook Offline Storage Table | ![(tick)](/viewer/net/images/check-blue.png) |
| [PST](https://docs.fileformat.com/email/pst/) | Outlook Personal Storage Table | ![(tick)](/viewer/net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Outlook data files: [Render Outlook data files as HTML, PDF, and image files](/viewer/net/render-outlook-data-files/).

## PDF and Page Layout file formats

| Format | Description | Automatic format detection | Remarks | 
| --- | --- | :---: | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | Microsoft XML Paper Specification | ![(tick)](/viewer/net/images/check-blue.png) | |
| [OXPS](https://docs.fileformat.com/page-description-language/oxps/) | OpenXPS (Open XML Paper Specification) File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document | ![(tick)](/viewer/net/images/check-blue.png) | |
| [OFD](https://www.zhihuilib.com/en/article/detail/2/12) | Open Fixed-layout Document |  | GroupDocs.Viewer requires that font [SimSun.ttf](https://learn.microsoft.com/en-us/typography/font-list/simsun) must be installed on the operating system to process this file type. Learn more [here](/viewer/net/render-pdf-documents#render-ofd-documents). |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view PDF files: [Render PDF documents as HTML and image files](/viewer/net/render-pdf-documents/).

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [FODP](https://docs.fileformat.com/) | OpenDocument Flat XML Presentation | ![(tick)](/viewer/net/images/check-blue.png) | |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/viewer/net/images/check-blue.png) | |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint Macro-Enabled Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/viewer/net/images/check-blue.png) | |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/viewer/net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view presentations: [Render PowerPoint presentations as HTML, PDF, and image files](/viewer/net/render-presentations/).

## Project Management file formats

{{< alert style="info" >}}Project Management file formats family currently is not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project | ![(tick)](/viewer/net/images/check-blue.png) | |
| [MPT](https://docs.fileformat.com/project-management/mpt/) | Microsoft Project Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [MPX](https://docs.fileformat.com/project-management/mpx/) | Microsoft Project Exchange File | ![(tick)](/viewer/net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Project files: [Render Microsoft Project documents as HTML, PDF, and image files](/viewer/net/render-ms-project-files/).

## Spreadsheet file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | OpenDocument Flat XML Spreadsheet | ![(tick)](/viewer/net/images/check-blue.png) | |
| [NUMBERS](https://docs.fileformat.com/spreadsheet/numbers/) | Apple Numbers Spreadsheet | ![(tick)](/viewer/net/images/check-blue.png) | GroupDocs.Viewer supports version 3.5 and higher starting with v21.8.
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/viewer/net/images/check-blue.png) | |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice Calc Spreadsheet | ![(tick)](/viewer/net/images/check-blue.png) | |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ![(tick)](/viewer/net/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0), Excel 95 (7.0), Excel 5.0. |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ![(tick)](/viewer/net/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0). |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Add-In | ![(tick)](/viewer/net/images/check-blue.png) | |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ![(tick)](/viewer/net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view spreadsheet files: [Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files](/viewer/net/render-excel-and-apple-numbers-spreadsheets/).

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ![(tick)](/viewer/net/images/check-blue.png) |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | |
| [JAVA](https://docs.fileformat.com/programming/java/) | Java Source Code File | |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | |
| [SCM](https://docs.fileformat.com/programming/scm/) | Scheme Source Code File | |
| [SCRIPT](https://docs.fileformat.com/programming/script/) | Generic Script File | |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | |
| [SML](https://en.wikipedia.org/wiki/Standard_ML) | Standard ML Source Code File | |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ![(tick)](/viewer/net/images/check-blue.png) |
| [VB](https://docs.fileformat.com/specification/programming/vb/) | Visual Basic Source Code File | ![(tick)](/viewer/net/images/check-blue.png) |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ![(tick)](/viewer/net/images/check-blue.png) |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view text and code files: [Render text documents as HTML, PDF, and image files](/viewer/net/render-text-files/).

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDW](https://docs.fileformat.com/web/vdw/) | Visio Web Drawing | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Visio Macro-Enabled Drawing | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Visio Macro-Enabled Stencil | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Visio Stencil | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Visio Macro-Enabled Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Visio Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VSX](https://docs.fileformat.com/image/vsx/) | Visio Stencil XML File | ![(tick)](/viewer/net/images/check-blue.png) | |
| [VTX](https://docs.fileformat.com/image/vtx/) | Visio Template XML File | ![(tick)](/viewer/net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Visio files: [Render Visio documents as HTML, PDF, and image files](/viewer/net/render-visio-documents/).

{{< alert style="info" >}}Initially the Visio file formats family was supported only by the GroupDocs.Viewer, but not supported by the GroupDocs.Viewer.CrossPlatform. However, starting from the version 25.3, their support was added to the GroupDocs.Viewer.CrossPlatform too.{{< /alert >}}

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help Format | ![(tick)](/viewer/net/images/check-blue.png) |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ![(tick)](/viewer/net/images/check-blue.png) |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ![(tick)](/viewer/net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view web files: [Render web documents as PDF, PNG, and JPEG files](/viewer/net/render-web-documents/).

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/viewer/net/images/check-blue.png) | |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/viewer/net/images/check-blue.png) | |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/viewer/net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Word documents: [Render Word documents as HTML, PDF, and image files](/viewer/net/render-word-documents/).

---

## Supported file formats

Path: /viewer/nodejs-java/supported-document-formats/


{{< alert style="tip" >}}

Need to view files online? Try the [GroupDocs.Viewer App](https://products.groupdocs.app/viewer/total) to open DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Viewer for Node.js. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" >}}

## Archive and compression file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [BZ2](https://docs.fileformat.com/compression/bz2) | Bzip2 Compressed File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [GZ](https://docs.fileformat.com/compression/gz) | Gnu Zipped Archive | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [RAR](https://docs.fileformat.com/compression/rar) | WinRAR Compressed Archive | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [TAR](https://docs.fileformat.com/compression/tar) | Consolidated Unix File Archive | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [TGZ](https://docs.fileformat.com/compression/tgz/) | Gzipped Tar File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [TXZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Tar Archive | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [XZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Archive | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [ZIP](https://docs.fileformat.com/compression/zip) | Zipped File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view archive files: [Render archives as HTML, PDF, and image files](/viewer/nodejs-java/render-archive-files).

## CAD and 3D file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CF2](https://docs.fileformat.com/cad/cf2/) | Common File Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DGN](https://docs.fileformat.com/cad/dgn) | MicroStation Design File (V7) | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | DGN V8 is not supported <br> as DGN V8 file format <br> is proprietary. |
| [DWF](https://docs.fileformat.com/cad/dwf/) | Design Web Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | Supported formats: <br> Release 11, 12, 13, 14. <br> DWG 2000, 2000i, 2002. <br> DWG 2004, 2005, 2006. <br> DWG 2010, 2011, 2012. <br> DWG 2013, 2014, 2015, 2016. |
| [DWT](https://docs.fileformat.com/cad/dwt/) | AutoCAD Drawing Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [HPG](https://docs.fileformat.com/cad/hpgl/) | HPGL (Hewlett-Packard Graphics Language) Plot File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [IFC](https://docs.fileformat.com/cad/ifc/) | Industry Foundation Classes | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [IGS](https://docs.fileformat.com/cad/igs/) | IGES (Initial Graphics Exchange Specification) Drawing | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [OBJ](https://docs.fileformat.com/3d/obj/) | Wavefront 3D Object File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PLT](https://docs.fileformat.com/cad/plt/) | AutoCAD Plotter Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [STL](https://docs.fileformat.com/cad/stl/) | Stereolithography File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view CAD files: [Render CAD drawings and models as HTML, PDF, and image files](/viewer/nodejs-java/render-cad-drawings-and-models).

## Database file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: |
| [NSF](https://docs.fileformat.com/database/nsf/) | Lotus Notes Database File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view NSF files: [Render Lotus Notes database files as HTML, PDF, and image files](/viewer/nodejs-java/render-lotus-notes-database-files/).

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open EBook Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |

## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [MBOX](https://docs.fileformat.com/email/mbox/) | Email Mailbox File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [VCARD / VCF](https://docs.fileformat.com/email/vcf/) | vCard (Virtual Contact) File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view email messages: [Render email messages as HTML, PDF, PNG, and JPEG files](/viewer/nodejs-java/render-email-messages/).

## Image file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [AI](https://docs.fileformat.com/image/ai/) | Adobe Illustrator Artwork | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | Supported versions: 2, 3, 8 |
| [APNG](https://docs.fileformat.com/image/apng/) | Animated Portable Network Graphic | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [CDR](https://docs.fileformat.com/image/cdr/) | CorelDRAW Image File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [CGM](https://docs.fileformat.com/page-description-language/cgm/) | Computer Graphics Metafile | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [CMX](https://docs.fileformat.com/image/cmx/) | Corel Presentation Exchange Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |  Supported version: 2.0 with 32-bit precision (16-bit precision is partially supported). |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DIB](https://docs.fileformat.com/image/dib/) | Device Independent Bitmap File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [EMZ](https://docs.fileformat.com/image/emz/) | Windows Compressed Enhanced Metafile | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [EPS](https://docs.fileformat.com/page-description-language/eps/) | Encapsulated PostScript File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [FODG](https://docs.fileformat.com/image/jpc/) | OpenDocument Flat XML Graphics | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [ICO](https://docs.fileformat.com/image/ico/) | Windows Icon File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [J2C](https://docs.fileformat.com/image/j2c/) | JPEG 2000 Code Stream | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [J2K](https://docs.fileformat.com/image/j2k/) | JPEG 2000 Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG 2000 Core Image File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [JPC](https://docs.fileformat.com/image/jpc/) | JPEG 2000 Code Stream File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [JPF](https://docs.fileformat.com/image/jpf/) | JPEG 2000 Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [JPM](https://docs.fileformat.com/image/jpm/) | JPEG 2000 Multi-layer Image Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [JPX](https://docs.fileformat.com/image/jpx/) | JPEG 2000 Image File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [ODG](https://docs.fileformat.com/image/odg/) | OpenDocument Graphics File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [OTG](https://docs.fileformat.com/image/otg/) | OpenDocument Graphics Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PCL](https://docs.fileformat.com/page-description-language/pcl/) | Printer Command Language Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PSB](https://docs.fileformat.com/image/psb/) | Photoshop Large Document Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [SVGZ](https://docs.fileformat.com/image/svgz/) | Compressed SVG File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [TGA](https://docs.fileformat.com/image/tga/) | TARGA (Truevision Advanced Raster Graphics Adapter) Graphics | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [TIF / TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [WMZ](https://docs.fileformat.com/image/wmz/) | Compressed Windows Metafile | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view image files: [Render images as HTML, PDF, PNG, and JPEG files](/viewer/nodejs-java/render-images/).

## Note-taking file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

## Outlook data file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [OST](https://docs.fileformat.com/email/ost/) | Outlook Offline Storage Table | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [PST](https://docs.fileformat.com/email/pst/) | Outlook Personal Storage Table | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Outlook data files: [Render Outlook data files as HTML, PDF, and image files](/viewer/nodejs-java/render-outlook-data-files/).

## PDF and Page Layout file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [OXPS](https://docs.fileformat.com/page-description-language/oxps/) | OpenXPS (Open XML Paper Specification) File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | Microsoft XML Paper Specification | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view PDF files: [Render PDF documents as HTML and image files](/viewer/nodejs-java/render-pdf-documents/).

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [FODP](https://docs.fileformat.com/) | OpenDocument Flat XML Presentation | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint Macro-Enabled Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view presentations: [Render PowerPoint presentations as HTML, PDF, and image files](/viewer/nodejs-java/render-presentations/).

## Project Management file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [MPT](https://docs.fileformat.com/project-management/mpt/) | Microsoft Project Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [MPX](https://docs.fileformat.com/project-management/mpx/) | Microsoft Project Exchange File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Project files: [Render Microsoft Project documents as HTML, PDF, and image files](/viewer/nodejs-java/render-ms-project-files/).

## Spreadsheet file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | OpenDocument Flat XML Spreadsheet | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [NUMBERS](https://docs.fileformat.com/spreadsheet/numbers/) | Apple Numbers Spreadsheet | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | GroupDocs.Viewer supports version 3.5 and higher starting with v21.8.
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice Calc Spreadsheet | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0), Excel 95 (7.0), Excel 5.0. |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0). |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Add-In | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view spreadsheet files: [Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files](/viewer/nodejs-java/render-excel-and-apple-numbers-spreadsheets/).

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | |
| [JAVA](https://docs.fileformat.com/programming/nodejs-java/) | Java Source Code File | |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | |
| [SCM](https://docs.fileformat.com/programming/scm/) | Scheme Source Code File | |
| [SCRIPT](https://docs.fileformat.com/programming/script/) | Generic Script File | |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | |
| [SML](https://en.wikipedia.org/wiki/Standard_ML) | Standard ML Source Code File | |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [VB](https://docs.fileformat.com/specification/programming/vb/) | Visual Basic Source Code File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view text and code files: [Render text documents as HTML, PDF, and image files](/viewer/nodejs-java/render-text-files/).

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDW](https://docs.fileformat.com/web/vdw/) | Visio Web Drawing | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Visio Macro-Enabled Drawing | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Visio Macro-Enabled Stencil | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Visio Stencil | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Visio Macro-Enabled Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Visio Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VSX](https://docs.fileformat.com/image/vsx/) | Visio Stencil XML File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [VTX](https://docs.fileformat.com/image/vtx/) | Visio Template XML File | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Visio files: [Render Visio documents as HTML, PDF, and image files](/viewer/nodejs-java/render-visio-documents/).

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ![(tick)](/viewer/nodejs-java/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view web files: [Render web documents as PDF, PNG, and JPEG files](/viewer/nodejs-java/render-web-documents/).

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/viewer/nodejs-java/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Word documents: [Render Word documents as HTML, PDF, and image files](/viewer/nodejs-java/render-word-documents/).



---

## Supported File Formats

Path: /comparison/java/supported-document-formats/


This topic lists file formats supported by [GroupDocs.Comparison](https://products.groupdocs.com/comparison/java). You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/comparison/12">}}

## CAD and 3D file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ![(tick)](/comparison/java/images/check.png) |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ![(tick)](/comparison/java/images/check.png) |

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ![(tick)](/comparison/java/images/check.png) |

## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ![(tick)](/comparison/java/images/check.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ![(tick)](/comparison/java/images/check.png) |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ![(tick)](/comparison/java/images/check.png) |

## Image file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ![(tick)](/comparison/java/images/check.png) |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ![(tick)](/comparison/java/images/check.png) |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ![(tick)](/comparison/java/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/comparison/java/images/check.png) |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ![(tick)](/comparison/java/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/comparison/java/images/check.png) |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ![(tick)](/comparison/java/images/check.png) |

## Note-taking file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ![(tick)](/comparison/java/images/check.png) |

## Page Layout file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ![(tick)](/comparison/java/images/check.png) |

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/comparison/java/images/check.png) |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/comparison/java/images/check.png) |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ![(tick)](/comparison/java/images/check.png) |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/comparison/java/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/comparison/java/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/comparison/java/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/comparison/java/images/check.png) |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/comparison/java/images/check.png) |

## Spreadsheet file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ![(tick)](/comparison/java/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/comparison/java/images/check.png) |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ![(tick)](/comparison/java/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ![(tick)](/comparison/java/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ![(tick)](/comparison/java/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ![(tick)](/comparison/java/images/check.png) |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ![(tick)](/comparison/java/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ![(tick)](/comparison/java/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ![(tick)](/comparison/java/images/check.png) |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ![(tick)](/comparison/java/images/check.png) |

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | ![(tick)](/comparison/java/images/check.png) |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | ![(tick)](/comparison/java/images/check.png) |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | ![(tick)](/comparison/java/images/check.png) |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | ![(tick)](/comparison/java/images/check.png) |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | ![(tick)](/comparison/java/images/check.png) |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | ![(tick)](/comparison/java/images/check.png) |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | ![(tick)](/comparison/java/images/check.png) |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | ![(tick)](/comparison/java/images/check.png) |
| [JAVA](https://docs.fileformat.com/programming/java/) | Java Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | ![(tick)](/comparison/java/images/check.png) |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | ![(tick)](/comparison/java/images/check.png) |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | ![(tick)](/comparison/java/images/check.png) |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | ![(tick)](/comparison/java/images/check.png) |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | ![(tick)](/comparison/java/images/check.png) |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | ![(tick)](/comparison/java/images/check.png) |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | ![(tick)](/comparison/java/images/check.png) |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | ![(tick)](/comparison/java/images/check.png) |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | ![(tick)](/comparison/java/images/check.png) |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | ![(tick)](/comparison/java/images/check.png) |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | ![(tick)](/comparison/java/images/check.png) |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | ![(tick)](/comparison/java/images/check.png) |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | ![(tick)](/comparison/java/images/check.png) |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | ![(tick)](/comparison/java/images/check.png) |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | ![(tick)](/comparison/java/images/check.png) |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | ![(tick)](/comparison/java/images/check.png) |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | ![(tick)](/comparison/java/images/check.png) |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ![(tick)](/comparison/java/images/check.png) |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | ![(tick)](/comparison/java/images/check.png) |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ![(tick)](/comparison/java/images/check.png) |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | ![(tick)](/comparison/java/images/check.png) |

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ![(tick)](/comparison/java/images/check.png) |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ![(tick)](/comparison/java/images/check.png) |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ![(tick)](/comparison/java/images/check.png) |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ![(tick)](/comparison/java/images/check.png) |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ![(tick)](/comparison/java/images/check.png) |

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ![(tick)](/comparison/java/images/check.png) |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ![(tick)](/comparison/java/images/check.png) |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ![(tick)](/comparison/java/images/check.png) |

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/comparison/java/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/comparison/java/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/comparison/java/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/comparison/java/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/comparison/java/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/comparison/java/images/check.png) |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/comparison/java/images/check.png) |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/comparison/java/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/comparison/java/images/check.png) |

---

## Supported File Formats

Path: /comparison/net/supported-document-formats/


This topic lists file formats supported by [GroupDocs.Comparison](https://products.groupdocs.com/comparison/net). You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/comparison/12">}}

## CAD and 3D file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ![(tick)](/comparison/net/images/check.png) |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ![(tick)](/comparison/net/images/check.png) |

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ![(tick)](/comparison/net/images/check.png) |

## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ![(tick)](/comparison/net/images/check.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ![(tick)](/comparison/net/images/check.png) |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ![(tick)](/comparison/net/images/check.png) |

## Image file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ![(tick)](/comparison/net/images/check.png) |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ![(tick)](/comparison/net/images/check.png) |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ![(tick)](/comparison/net/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/comparison/net/images/check.png) |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ![(tick)](/comparison/net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/comparison/net/images/check.png) |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ![(tick)](/comparison/net/images/check.png) |

## Note-taking file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ![(tick)](/comparison/net/images/check.png) |

## Page Layout file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ![(tick)](/comparison/net/images/check.png) |

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/comparison/net/images/check.png) |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/comparison/net/images/check.png) |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ![(tick)](/comparison/net/images/check.png) |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/comparison/net/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/comparison/net/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/comparison/net/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/comparison/net/images/check.png) |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/comparison/net/images/check.png) |

## Spreadsheet file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ![(tick)](/comparison/net/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/comparison/net/images/check.png) |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ![(tick)](/comparison/net/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ![(tick)](/comparison/net/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ![(tick)](/comparison/net/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ![(tick)](/comparison/net/images/check.png) |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ![(tick)](/comparison/net/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ![(tick)](/comparison/net/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ![(tick)](/comparison/net/images/check.png) |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ![(tick)](/comparison/net/images/check.png) |

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | ![(tick)](/comparison/net/images/check.png) |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | ![(tick)](/comparison/net/images/check.png) |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | ![(tick)](/comparison/net/images/check.png) |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | ![(tick)](/comparison/net/images/check.png) |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | ![(tick)](/comparison/net/images/check.png) |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | ![(tick)](/comparison/net/images/check.png) |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | ![(tick)](/comparison/net/images/check.png) |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | ![(tick)](/comparison/net/images/check.png) |
| [JAVA](https://docs.fileformat.com/programming/java/) | Java Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | ![(tick)](/comparison/net/images/check.png) |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | ![(tick)](/comparison/net/images/check.png) |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | ![(tick)](/comparison/net/images/check.png) |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | ![(tick)](/comparison/net/images/check.png) |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | ![(tick)](/comparison/net/images/check.png) |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | ![(tick)](/comparison/net/images/check.png) |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | ![(tick)](/comparison/net/images/check.png) |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | ![(tick)](/comparison/net/images/check.png) |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | ![(tick)](/comparison/net/images/check.png) |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | ![(tick)](/comparison/net/images/check.png) |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | ![(tick)](/comparison/net/images/check.png) |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | ![(tick)](/comparison/net/images/check.png) |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | ![(tick)](/comparison/net/images/check.png) |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | ![(tick)](/comparison/net/images/check.png) |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | ![(tick)](/comparison/net/images/check.png) |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | ![(tick)](/comparison/net/images/check.png) |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | ![(tick)](/comparison/net/images/check.png) |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ![(tick)](/comparison/net/images/check.png) |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | ![(tick)](/comparison/net/images/check.png) |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ![(tick)](/comparison/net/images/check.png) |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | ![(tick)](/comparison/net/images/check.png) |

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ![(tick)](/comparison/net/images/check.png) |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ![(tick)](/comparison/net/images/check.png) |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ![(tick)](/comparison/net/images/check.png) |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ![(tick)](/comparison/net/images/check.png) |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ![(tick)](/comparison/net/images/check.png) |

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ![(tick)](/comparison/net/images/check.png) |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ![(tick)](/comparison/net/images/check.png) |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ![(tick)](/comparison/net/images/check.png) |

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/comparison/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/comparison/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/comparison/net/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/comparison/net/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/comparison/net/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/comparison/net/images/check.png) |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/comparison/net/images/check.png) |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/comparison/net/images/check.png) |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/comparison/net/images/check.png) |

---

## Supported File Formats

Path: /comparison/nodejs-java/supported-document-formats/


This topic lists file formats supported by [GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java). You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/comparison/12">}}

## CAD and 3D file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ✅ |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ✅ |

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ✅ |

## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ✅ |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ✅ |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ✅ |

## Image file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ✅ |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ✅ |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ✅ |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ✅ |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ✅ |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ✅ |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ✅ |

## Note-taking file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ✅ |

## Page Layout file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ✅ |

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ✅ |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ✅ |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ✅ |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ✅ |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ✅ |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ✅ |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ✅ |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ✅ |

## Spreadsheet file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ✅ |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ✅ |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ✅ |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ✅ |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ✅ |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ✅ |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ✅ |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ✅ |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ✅ |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ✅ |

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | ✅ |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | ✅ |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | ✅ |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | ✅ |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | ✅ |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | ✅ |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | ✅ |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ✅ |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | ✅ |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | ✅ |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | ✅ |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | ✅ |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | ✅ |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | ✅ |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | ✅ |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | ✅ |
| [JAVA](https://docs.fileformat.com/programming/java/) | Java Source Code File | ✅ |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | ✅ |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | ✅ |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | ✅ |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | ✅ |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | ✅ |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | ✅ |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | ✅ |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | ✅ |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | ✅ |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | ✅ |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | ✅ |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | ✅ |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | ✅ |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | ✅ |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | ✅ |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | ✅ |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | ✅ |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | ✅ |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | ✅ |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ✅ |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | ✅ |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ✅ |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | ✅ |

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ✅ |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ✅ |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ✅ |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ✅ |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ✅ |

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ✅ |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ✅ |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ✅ |

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ✅ |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ✅ |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ✅ |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ✅ |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ✅ |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ✅ |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ✅ |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ✅ |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ✅ |

---

## Supported File Formats

Path: /comparison/python-net/supported-document-formats/


This topic lists file formats supported by [GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net). You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/comparison/12">}}

## CAD and 3D file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ✅ |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ✅ |

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ✅ |

## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ✅ |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ✅ |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ✅ |

## Image file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ✅ |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ✅ |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ✅ |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ✅ |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ✅ |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ✅ |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ✅ |

## Note-taking file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ✅ |

## Page Layout file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ✅ |

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ✅ |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ✅ |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ✅ |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ✅ |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ✅ |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ✅ |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ✅ |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ✅ |

## Spreadsheet file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ✅ |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ✅ |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ✅ |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ✅ |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ✅ |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ✅ |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ✅ |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ✅ |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ✅ |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ✅ |

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | ✅ |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | ✅ |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | ✅ |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | ✅ |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | ✅ |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | ✅ |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | ✅ |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ✅ |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | ✅ |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | ✅ |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | ✅ |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | ✅ |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | ✅ |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | ✅ |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | ✅ |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | ✅ |
| [JAVA](https://docs.fileformat.com/programming/java/) | Java Source Code File | ✅ |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | ✅ |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | ✅ |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | ✅ |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | ✅ |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | ✅ |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | ✅ |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | ✅ |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | ✅ |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | ✅ |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | ✅ |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | ✅ |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | ✅ |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | ✅ |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | ✅ |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | ✅ |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | ✅ |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | ✅ |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | ✅ |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | ✅ |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ✅ |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | ✅ |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ✅ |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | ✅ |

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ✅ |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ✅ |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ✅ |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ✅ |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ✅ |

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ✅ |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ✅ |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ✅ |

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ✅ |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ✅ |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ✅ |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ✅ |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ✅ |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ✅ |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ✅ |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ✅ |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ✅ |

---

## Supported File Formats

Path: /conversion/python-net/supported-file-formats/


{{< alert style="tip" >}}

Need to convert files online? Try the [GroupDocs.Conversion App](https://products.groupdocs.app/conversion/total) to convert DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Conversion for Python via .NET. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/conversion/11">}}

{{< include file="/conversion/python-net/_includes/supported-conversions/formats-brief.md" type="page" >}}
---

## Supported File Formats

Path: /metadata/java/supported-document-formats/

The following table contains a full list of file formats that are currently supported by GroupDocs.Metadata for Java

| Format | Description | Load | Save | Remarks |
| --- | --- | --- | --- | --- |
| [ASF](https://docs.fileformat.com/video/asf/) | Advanced Systems FormatVideo | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [AVI](https://docs.fileformat.com/video/avi/) | Audio Video Interleave File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | BMP Specification v5 |
| [CR2](https://docs.fileformat.com/image/crw/) | Digital photography RAW format created by Canon | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DAE](https://docs.fileformat.com/3d/dae/) | Dae File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DICOM](https://docs.fileformat.com/image/dcm/) | Digital Imaging and Communications in Medicine (DICOM) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DJVU](https://docs.fileformat.com/image/djvu/)/DJV | Deja Vu (DjVu) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 3.0 |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Specification | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97 - 2007 Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.doc versions starting from Microsoft Word 95 |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DWG](https://docs.fileformat.com/cad/dwg/) | Autodesk Design Data Formats | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DXF](https://docs.fileformat.com/cad/dxf/) | AutoCAD Drawing Interchange | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EMF](https://docs.fileformat.com/image/emf/) | Windows Enhanced Metafile (EMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 11.0 |
| [EML](https://docs.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Saves the document in the IDPF EPUB format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Versions 2.0, 3.0.1, 3.1 |
| [FBX](https://docs.fileformat.com/3d/fbx/) | Fbx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [FLV](https://docs.fileformat.com/video/flv/) | Flash Video File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GEOJSON](https://docs.fileformat.com/gis/geojson/) | GeoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphics Interchange Format (GIF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 89a |
| [GML](https://docs.fileformat.com/gis/gml/) | Gml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GPX](https://docs.fileformat.com/gis/gpx/) | Gpx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [HEIF](https://docs.fileformat.com/image/heif/)/[HEIC](https://docs.fileformat.com/image/heic/) | High Efficiency Image File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG2000 Core Image File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JPG](https://docs.fileformat.com/image/jpeg) / [JPEG](https://docs.fileformat.com/image/jpeg) / JPE   | Joint Photographic Experts Group (JPEG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 1.02 |
| [KML](https://docs.fileformat.com/gis/kml/) | Kml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MOV](https://docs.fileformat.com/video/mov/) / [QT](https://docs.fileformat.com/video/qt/) | Apple QuickTime Movie | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MPEG Audio Layer III | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project Document | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OSM](https://docs.fileformat.com/gis/osm/) | Osm File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| OTC | OpenDocument Chart Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OTF](https://docs.fileformat.com/font/otf/) | OpenType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PDF](https://docs.fileformat.com/pdf/) | Saves the document as PDF (Adobe Portable Document) format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.pdf versions starting from PDF version 1.2 |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Version 1.0 and later  |
| [POTM](https://docs.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [POTX](https://docs.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.ppt versions starting from Microsoft PowerPoint 97 |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document (PSD) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Adobe Photoshop 2.0 and later |
| [RAR](https://docs.fileformat.com/compression/rar/) | RAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SEVENZIP](https://docs.fileformat.com/compression/7z/) | 7z Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SHP](https://docs.fileformat.com/gis/shp/) | Shp File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [STL](https://docs.fileformat.com/3d/stl/) | Stl File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TAR](https://docs.fileformat.com/compression/tar/) | TAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [THREEDS](https://docs.fileformat.com/3d/3ds/) | 3DS File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.0 |
| TOPOJSON | TopoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TORRENT](https://docs.fileformat.com/misc/torrent/) | BitTorrent File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTC](https://docs.fileformat.com/font/ttc/) | TrueType Font Collection | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTF](https://docs.fileformat.com/font/ttf/) | TrueType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCF](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCR](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Microsoft Visio 2003-2010 Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Microsoft Visio 2003-2010 Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WAV](https://docs.fileformat.com/audio/wav/) | Waveform Audio File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile (WMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 13.0 |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.xls versions starting from Microsoft Excel 95 |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ZIP](https://docs.fileformat.com/compression/zip/) | Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.3.4 |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/metadata/14), and our team will assist you.

{{< /alert >}}

---

## Supported File Formats

Path: /metadata/net/supported-document-formats/

The following table contains a full list of file formats that are currently supported by GroupDocs.Metadata for .NET.

| Format | Description | Load | Save | Remarks |
| --- | --- | --- | --- | --- |
| [ASF](https://docs.fileformat.com/video/asf/) | Advanced Systems FormatVideo | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [AVI](https://docs.fileformat.com/video/avi/) | Audio Video Interleave File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | BMP Specification v5 |
| [CR2](https://docs.fileformat.com/image/crw/) | Digital photography RAW format created by Canon | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DAE](https://docs.fileformat.com/3d/dae/) | Dae File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DICOM](https://docs.fileformat.com/image/dcm/) | Digital Imaging and Communications in Medicine (DICOM) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DJVU](https://docs.fileformat.com/image/djvu/)/DJV | Deja Vu (DjVu) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 3.0 |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Specification | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97 - 2007 Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.doc versions starting from Microsoft Word 95 |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DWG](https://docs.fileformat.com/cad/dwg/) | Autodesk Design Data Formats | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DXF](https://docs.fileformat.com/cad/dxf/) | AutoCAD Drawing Interchange | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EMF](https://docs.fileformat.com/image/emf/) | Windows Enhanced Metafile (EMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 11.0 |
| [EML](https://docs.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Saves the document in the IDPF EPUB format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Versions 2.0, 3.0.1, 3.1 |
| [FBX](https://docs.fileformat.com/3d/fbx/) | Fbx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [FLV](https://docs.fileformat.com/video/flv/) | Flash Video File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GEOJSON](https://docs.fileformat.com/gis/geojson/) | GeoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphics Interchange Format (GIF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 89a |
| [GML](https://docs.fileformat.com/gis/gml/) | Gml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GPX](https://docs.fileformat.com/gis/gpx/) | Gpx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [HEIF](https://docs.fileformat.com/image/heif/)/[HEIC](https://docs.fileformat.com/image/heic/) | High Efficiency Image File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG2000 Core Image File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JPG](https://docs.fileformat.com/image/jpeg) / [JPEG](https://docs.fileformat.com/image/jpeg) / JPE   | Joint Photographic Experts Group (JPEG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 1.02 |
| [KML](https://docs.fileformat.com/gis/kml/) | Kml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MOV](https://docs.fileformat.com/video/mov/) / [QT](https://docs.fileformat.com/video/qt/) | Apple QuickTime Movie | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MPEG Audio Layer III | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project Document | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OSM](https://docs.fileformat.com/gis/osm/) | Osm File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| OTC | OpenDocument Chart Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OTF](https://docs.fileformat.com/font/otf/) | OpenType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PDF](https://docs.fileformat.com/pdf/) | Saves the document as PDF (Adobe Portable Document) format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.pdf versions starting from PDF version 1.2 |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Version 1.0 and later  |
| [POTM](https://docs.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [POTX](https://docs.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.ppt versions starting from Microsoft PowerPoint 97 |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document (PSD) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Adobe Photoshop 2.0 and later |
| [RAR](https://docs.fileformat.com/compression/rar/) | RAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SEVENZIP](https://docs.fileformat.com/compression/7z/) | 7z Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SHP](https://docs.fileformat.com/gis/shp/) | Shp File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [STL](https://docs.fileformat.com/3d/stl/) | Stl File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TAR](https://docs.fileformat.com/compression/tar/) | TAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [THREEDS](https://docs.fileformat.com/3d/3ds/) | 3DS File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.0 |
| TOPOJSON | TopoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TORRENT](https://docs.fileformat.com/misc/torrent/) | BitTorrent File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTC](https://docs.fileformat.com/font/ttc/) | TrueType Font Collection | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTF](https://docs.fileformat.com/font/ttf/) | TrueType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCF](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCR](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Microsoft Visio 2003-2010 Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Microsoft Visio 2003-2010 Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WAV](https://docs.fileformat.com/audio/wav/) | Waveform Audio File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile (WMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 13.0 |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.xls versions starting from Microsoft Excel 95 |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ZIP](https://docs.fileformat.com/compression/zip/) | Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.3.4 |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/metadata/14), and our team will assist you.

{{< /alert >}}

---

## Supported File Formats

Path: /metadata/nodejs-java/supported-document-formats/

The following table contains a full list of file formats that are currently supported by GroupDocs.Metadata for Java

| Format | Description | Load | Save | Remarks |
| --- | --- | --- | --- | --- |
| [ASF](https://docs.fileformat.com/video/asf/) | Advanced Systems FormatVideo | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [AVI](https://docs.fileformat.com/video/avi/) | Audio Video Interleave File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | BMP Specification v5 |
| [CR2](https://docs.fileformat.com/image/crw/) | Digital photography RAW format created by Canon | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DAE](https://docs.fileformat.com/3d/dae/) | Dae File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DICOM](https://docs.fileformat.com/image/dcm/) | Digital Imaging and Communications in Medicine (DICOM) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DJVU](https://docs.fileformat.com/image/djvu/)/DJV | Deja Vu (DjVu) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 3.0 |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Specification | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97 - 2007 Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.doc versions starting from Microsoft Word 95 |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DWG](https://docs.fileformat.com/cad/dwg/) | Autodesk Design Data Formats | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DXF](https://docs.fileformat.com/cad/dxf/) | AutoCAD Drawing Interchange | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EMF](https://docs.fileformat.com/image/emf/) | Windows Enhanced Metafile (EMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 11.0 |
| [EML](https://docs.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Saves the document in the IDPF EPUB format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Versions 2.0, 3.0.1, 3.1 |
| [FBX](https://docs.fileformat.com/3d/fbx/) | Fbx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [FLV](https://docs.fileformat.com/video/flv/) | Flash Video File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GEOJSON](https://docs.fileformat.com/gis/geojson/) | GeoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphics Interchange Format (GIF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 89a |
| [GML](https://docs.fileformat.com/gis/gml/) | Gml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GPX](https://docs.fileformat.com/gis/gpx/) | Gpx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [HEIF](https://docs.fileformat.com/image/heif/)/[HEIC](https://docs.fileformat.com/image/heic/) | High Efficiency Image File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG2000 Core Image File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JPG](https://docs.fileformat.com/image/jpeg) / [JPEG](https://docs.fileformat.com/image/jpeg) / JPE   | Joint Photographic Experts Group (JPEG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 1.02 |
| [KML](https://docs.fileformat.com/gis/kml/) | Kml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MOV](https://docs.fileformat.com/video/mov/) / [QT](https://docs.fileformat.com/video/qt/) | Apple QuickTime Movie | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MPEG Audio Layer III | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project Document | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OSM](https://docs.fileformat.com/gis/osm/) | Osm File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| OTC | OpenDocument Chart Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OTF](https://docs.fileformat.com/font/otf/) | OpenType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PDF](https://docs.fileformat.com/pdf/) | Saves the document as PDF (Adobe Portable Document) format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.pdf versions starting from PDF version 1.2 |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Version 1.0 and later  |
| [POTM](https://docs.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [POTX](https://docs.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.ppt versions starting from Microsoft PowerPoint 97 |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document (PSD) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Adobe Photoshop 2.0 and later |
| [RAR](https://docs.fileformat.com/compression/rar/) | RAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SEVENZIP](https://docs.fileformat.com/compression/7z/) | 7z Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SHP](https://docs.fileformat.com/gis/shp/) | Shp File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [STL](https://docs.fileformat.com/3d/stl/) | Stl File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TAR](https://docs.fileformat.com/compression/tar/) | TAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [THREEDS](https://docs.fileformat.com/3d/3ds/) | 3DS File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.0 |
| TOPOJSON | TopoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TORRENT](https://docs.fileformat.com/misc/torrent/) | BitTorrent File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTC](https://docs.fileformat.com/font/ttc/) | TrueType Font Collection | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTF](https://docs.fileformat.com/font/ttf/) | TrueType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCF](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCR](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Microsoft Visio 2003-2010 Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Microsoft Visio 2003-2010 Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WAV](https://docs.fileformat.com/audio/wav/) | Waveform Audio File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile (WMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 13.0 |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.xls versions starting from Microsoft Excel 95 |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ZIP](https://docs.fileformat.com/compression/zip/) | Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.3.4 |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/metadata/14), and our team will assist you.

{{< /alert >}}

---

## Supported File Formats

Path: /metadata/python-net/supported-document-formats/

The following table contains a full list of file formats that are currently supported by GroupDocs.Metadata for Python via .NET

| Format | Description | Load | Save | Remarks |
| --- | --- | --- | --- | --- |
| [ASF](https://docs.fileformat.com/video/asf/) | Advanced Systems FormatVideo | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [AVI](https://docs.fileformat.com/video/avi/) | Audio Video Interleave File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | BMP Specification v5 |
| [CR2](https://docs.fileformat.com/image/crw/) | Digital photography RAW format created by Canon | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DAE](https://docs.fileformat.com/3d/dae/) | Dae File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DICOM](https://docs.fileformat.com/image/dcm/) | Digital Imaging and Communications in Medicine (DICOM) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DJVU](https://docs.fileformat.com/image/djvu/)/DJV | Deja Vu (DjVu) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 3.0 |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Specification | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97 - 2007 Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.doc versions starting from Microsoft Word 95 |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DWG](https://docs.fileformat.com/cad/dwg/) | Autodesk Design Data Formats | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [DXF](https://docs.fileformat.com/cad/dxf/) | AutoCAD Drawing Interchange | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EMF](https://docs.fileformat.com/image/emf/) | Windows Enhanced Metafile (EMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 11.0 |
| [EML](https://docs.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Saves the document in the IDPF EPUB format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Versions 2.0, 3.0.1, 3.1 |
| [FBX](https://docs.fileformat.com/3d/fbx/) | Fbx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [FLV](https://docs.fileformat.com/video/flv/) | Flash Video File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GEOJSON](https://docs.fileformat.com/gis/geojson/) | GeoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphics Interchange Format (GIF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 89a |
| [GML](https://docs.fileformat.com/gis/gml/) | Gml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [GPX](https://docs.fileformat.com/gis/gpx/) | Gpx File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [HEIF](https://docs.fileformat.com/image/heif/)/[HEIC](https://docs.fileformat.com/image/heic/) | High Efficiency Image File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG2000 Core Image File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [JPG](https://docs.fileformat.com/image/jpeg) / [JPEG](https://docs.fileformat.com/image/jpeg) / JPE   | Joint Photographic Experts Group (JPEG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 1.02 |
| [KML](https://docs.fileformat.com/gis/kml/) | Kml File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MOV](https://docs.fileformat.com/video/mov/) / [QT](https://docs.fileformat.com/video/qt/) | Apple QuickTime Movie | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MPEG Audio Layer III | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project Document | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OSM](https://docs.fileformat.com/gis/osm/) | Osm File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| OTC | OpenDocument Chart Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [OTF](https://docs.fileformat.com/font/otf/) | OpenType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PDF](https://docs.fileformat.com/pdf/) | Saves the document as PDF (Adobe Portable Document) format. | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.pdf versions starting from PDF version 1.2 |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Version 1.0 and later  |
| [POTM](https://docs.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [POTX](https://docs.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.ppt versions starting from Microsoft PowerPoint 97 |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document (PSD) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Adobe Photoshop 2.0 and later |
| [RAR](https://docs.fileformat.com/compression/rar/) | RAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SEVENZIP](https://docs.fileformat.com/compression/7z/) | 7z Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [SHP](https://docs.fileformat.com/gis/shp/) | Shp File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [STL](https://docs.fileformat.com/3d/stl/) | Stl File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TAR](https://docs.fileformat.com/compression/tar/) | TAR Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [THREEDS](https://docs.fileformat.com/3d/3ds/) | 3DS File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.0 |
| TOPOJSON | TopoJson File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TORRENT](https://docs.fileformat.com/misc/torrent/) | BitTorrent File | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTC](https://docs.fileformat.com/font/ttc/) | TrueType Font Collection | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [TTF](https://docs.fileformat.com/font/ttf/) | TrueType Font | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCF](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VCR](https://docs.fileformat.com/email/vcf/) | Electronic Business Card (vCard) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Microsoft Visio 2003-2010 Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Microsoft Visio 2003-2010 Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WAV](https://docs.fileformat.com/audio/wav/) | Waveform Audio File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile (WMF) | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Revision 13.0 |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | \*.xls versions starting from Microsoft Excel 95 |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) |   |
| [ZIP](https://docs.fileformat.com/compression/zip/) | Archive File Format | ![(tick)](/metadata/net/images/check.png) | ![(tick)](/metadata/net/images/check.png) | Supported since version 6.3.4 |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/metadata/14), and our team will assist you.

{{< /alert >}}

---

## Supported File Formats

Path: /watermark/nodejs-java/supported-document-formats/


The following table indicates the file formats that GroupDocs.Watermark can work with.

| Format | Description | Load | Save | Add watermark | Search watermark | Remove watermark | Remarks |
| --- | --- | --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc) | Microsoft Word 97 - 2007 Document. | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Word Open XML Macro-Enabled Document  | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel Template File | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Excel Open XML Spreadsheet Template | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [POTX](https://docs.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [POTM](https://docs.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [EML](https://docs.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   | Watermark management is available for attached documents and images. |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   | Watermark management is available for attached documents and images. |
| [OFT](https://docs.fileformat.com/email/oft/) | Microsoft Outlook Email Template | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   | Watermark management is available for attached documents and images. |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   | Watermark management is available for attached documents and images. |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [PDF](https://docs.fileformat.com/pdf/) | PDF (Adobe Portable Document) format | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | Watermark searching and removing is not available for rasterized pages. |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |
 |   |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphics Interchange Format (GIF) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   |
| [JPG](https://docs.fileformat.com/image/jpeg) / [JPEG](https://docs.fileformat.com/image/jpeg) / JPE   | Joint Photographic Experts Group (JPEG) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG2000 Core Image File | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |   |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Microsoft Visio 2003-2010 Drawing | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Microsoft Visio File Format | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Microsoft Visio 2003-2010 Stencil | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Visio Stencil File Format | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Visio Macro-Enabled Drawing | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Microsoft Visio Macro Enabled File Format | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Visio Macro-Enabled Drawing Template | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VTX](https://docs.fileformat.com/image/vtx/) | VTX Chiptune File | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) | ![(tick)](/watermark/net/images/check.png) |   |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/watermark/19), and our team will assist you.

{{< /alert >}}
---

## System requirements

Path: /conversion/java/system-requirements/

{{< alert style="info" >}}

GroupDocs.Conversion for Java does not require any external software or third-party tool to be installed. To install it, just follow one of the ways described in the [Installation]({{< ref "conversion/java/getting-started/installation.md" >}}) section.

{{< /alert >}}

## Supported Operating Systems

GroupDocs.Conversion for Java supports any 32-bit or 64-bit operating system where the Java framework is installed including, but not limited to:

### Windows

*   Microsoft Windows Server 2003 and later
*   Microsoft Windows XP (x64, x86)
*   Microsoft Windows Vista (x64, x86)
*   Microsoft Windows 7, 8, 8.1 (x64, x86)
*   Microsoft Windows 10 (x64, x86)
*   Microsoft Windows 11 (x64)

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

* Mac OS X

## Supported Frameworks

* Java 8 and higher

## Development Environments

GroupDocs.Conversion for Java can be used to develop applications in any development environment that targets the Java platform, but the following environments are explicitly supported:

* Eclipse
* IntelliJ NetBeans
* IntelliJ IDEA
* VS Code etc.  

---

## System requirements

Path: /total/python-net/system-requirements/


## General Requirements

- [Python](https://www.python.org/downloads/) versions **3.9–3.11** are supported

## Supported Operating Systems

### Windows

* Microsoft Windows 11 (x64)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 7, 8, 8.1, Vista, XP (x64, x86)
* Microsoft Windows Server 2003 and later

### Linux and macOS (partial support)

Some of the supported packages in GroupDocs.Total include macOS support for Intel and/or Apple Silicon (M-series) processors.

The following table shows the platform support matrix:

| Package | Windows 32-bit | Windows 64-bit | Linux x86_64 | macOS 10.14 x86 | macOS 11.0 Apple Silicon |
|---|---|---|---|---|---|
| [groupdocs‑assembly‑net](https://pypi.org/project/groupdocs-assembly-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |  |  |  |
| [groupdocs‑comparison‑net](https://pypi.org/project/groupdocs-comparison-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |
| [groupdocs‑conversion‑net](https://pypi.org/project/groupdocs-conversion-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |
| [groupdocs‑merger‑net](https://pypi.org/project/groupdocs-merger-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |  |
| [groupdocs‑metadata‑net](https://pypi.org/project/groupdocs-metadata-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |
| [groupdocs‑redaction‑net](https://pypi.org/project/groupdocs-redaction-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |  | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |
| [groupdocs‑signature‑net](https://pypi.org/project/groupdocs-signature-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |  | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |
| [groupdocs‑viewer‑net](https://pypi.org/project/groupdocs-viewer-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |
| [groupdocs‑watermark‑net](https://pypi.org/project/groupdocs-watermark-net/) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) | ![(tick)](/total/python-net/_images/check-blue.png) |


You can install individual packages based on your requirements and the platforms you are targeting.

## Additional System Libraries

### Linux and macOS System Requirements

GroupDocs.Total for Python via .NET relies on `libgdiplus` for processing images or documents that contain images. 

#### Linux installation

When using GroupDocs.Total in a Linux environment, the following packages should be installed for proper library operation:

1. **libgdiplus** - Mono library providing a GDI+-compatible API on non-Windows operating systems.  
2. **libx11-dev** - Required for drawing functions (image/font rendering).  
3. **fontconfig** - Enables font lookup for text rendering with System.Drawing.  
4. **ttf-mscorefonts-installer** - Provides Microsoft-compatible fonts required by GroupDocs.Total.

To install packages on Debian-based Linux distributions, use [apt-get](https://wiki.debian.org/apt-get):

```bash
sudo apt-get update
sudo apt-get install -y libgdiplus libx11-dev fontconfig ttf-mscorefonts-installer
```

If some packages are not available, you can add the contrib repository:

```bash
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
```

#### macOS installation

The library is required and can be installed using the [Homebrew](https://brew.sh/) package manager:

```ps
brew install mono-libgdiplus
```

Ensure `libgdiplus` is installed if you encounter issues with processing images or documents that contain images.
---

## System Requirements

Path: /signature/net/system-requirements/

## Overview

GroupDocs.Signature for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "signature/net/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Signature for .NET supports any 32-bit or 64-bit operating system where .NET or Mono framework is installed including, but not limited to:

### Windows

* Microsoft Windows 2003 Server ( x64, x86)
* Microsoft Windows 2008 Server ( x64, x86)
* Microsoft Windows 2012 Server ( x64, x86)
* Microsoft Windows 2012 R2 Server ( x64, x86)
* Microsoft Windows 2016 Server ( x64, x86)
* Microsoft Windows 2019 Server ( x64, x86)
* Microsoft Windows Vista ( x64, x86)
* Microsoft Windows XP ( x64, x86)
* Microsoft Windows 7 ( x64, x86)
* Microsoft Windows 8, 8.1 ( x64, x86)
* Microsoft Windows 10 ( x64, x86)
* Microsoft Azure

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

* Mac OS X

## Supported Frameworks

GroupDocs.Signature for .NET supports .NET and Mono frameworks as follows:

### .NET Standard 2.0

Any type of .NET Standard 2.0 application is supported.

### .NET Frameworks

* .NET Framework 2.0
* .NET Framework 3.5
* .NET Framework 4.0
* .NET Framework 4.0\_ClientProfile
* .NET Framework 4.5.0
* .NET Framework 4.5.1
* .NET Framework 4.5.2
* .NET Framework 4.6.0
* .NET Framework 4.6.2
* .NET Framework 4.5.0
* .NET Framework 4.5.1
* .NET Framework 4.6.0
* .NET Framework 4.6.2
* .NET Framework 4.7
* .NET Framework 4.7.2
* .NET Standard 2.0
* .NET Core 2.0
* .NET Core 2.1

### Mono Framework

* Mono 2.6.7 or later

## Development Environments

GroupDocs.Signature for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

* Microsoft Visual Studio 2010
* Microsoft Visual Studio 2011
* Microsoft Visual Studio 2012
* Microsoft Visual Studio 2013
* Microsoft Visual Studio 2015
* Microsoft Visual Studio 2017
* Microsoft Visual Studio 2019
* Xamarin.Android
* Xamarin.IOS
* Xamarin.Mac
* MonoDevelop 2.4 and later

---

## System Requirements

Path: /signature/nodejs-java/system-requirements/

## Overview

GroupDocs.Signature for Node.js does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "signature/nodejs-java/getting-started/installation.md" >}}).

## Requirements

* Node.js 16 or above
* J2SE 8.0 (1.8) or above

## Supported Operating Systems

GroupDocs.Signature for Node.js supports any 32-bit or 64-bit operating system where Node.js is installed including, but not limited to:

### Windows

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

* Mac OS X

## Development Environments

GroupDocs.Signature for Node.js requirements Node.js and Java. You can use any text editor like Atom, Sublime, Visual Studio Code, etc.

---

## System Requirements

Path: /signature/python-net/system-requirements/


## General Requirements

- [Python 3.9](https://www.python.org/downloads/) or above.
- [.NET 6.0](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) runtime or above.

## Supported Operating Systems

### Windows

- Microsoft Windows 11 (x64)
- Microsoft Windows 10 (x64, x86)
- Microsoft Windows 7, 8, 8.1 (x64, x86)
- Microsoft Windows Vista (x64, x86)
- Microsoft Windows XP (x64, x86)
- Microsoft Windows Server 2003 and later

### macOS

GroupDocs.Signature for Python via .NET supports macOS running on both Intel and Apple Silicon processors.

Supported versions:

- macOS Sequoia (version 15)
- macOS Sonoma (version 14)
- macOS Ventura (version 13)
- macOS Monterey (version 12)
- macOS Big Sur (version 11)
- macOS Catalina (version 10.15)
- macOS Mojave (version 10.14)

## Additional System Libraries

### macOS System Requirements

GroupDocs.Signature for Python via .NET partially relies on `libgdiplus` for converting images or documents that contain images. The library is required for such signatures and can be installed using the [Homebrew](https://brew.sh/) package manager:

```ps
brew install mono-libgdiplus
```

Ensure `libgdiplus` is installed if you encounter issues with image-based signatures.

---

## Taxonomies

Path: /classification/net/taxonomies/

## Taxonomy

[Taxonomy (general)](https://en.wikipedia.org/wiki/Taxonomy_(general))is the practice and science of classification of things or concepts, including the principles that underlie such classification. In our case, this is a list of text categories. We support two taxonomies for now:

### IAB-2 taxonomy

IAB-2 taxonomy: [https://www.iab.com/guidelines/taxonomy/](https://www.iab.com/guidelines/taxonomy/).

```csharp
Automotive,
Books_and_Literature,
Business_and_Finance,
Careers,
Education,
Events_and_Attractions,
Family_and_Relationships,
Fine_Art,
Food_&_Drink,
Healthy_Living,
Hobbies_&_Interests,
Home_&_Garden,
Medical_Health,
Movies,
Music_and_Audio,
News_and_Politics,
Personal_Finance,
Pets,
Pop_Culture,
Real_Estate,
Religion_&_Spirituality,
Science,
Shopping,
Sports,
Style_&_Fashion,
Technology_&_Computing,
Television,
Travel,
Video_Gaming
```

### Documents taxonomy

Documents taxonomy:

```csharp
ADVE - advertisements, brochures,
Email - e-mails,
Form - forms,
Letter - letters,
Memo - memorandums,
News - articles, including news articles,
Invoice - invoices,
Report - reports,
Resume - CVs, resumes,
Scientific - scientific papers,
Other - the other classes of documents or cases where the classifier is not sure.
```

### Sentiment taxonomy

Sentiment taxonomy:

```csharp
Negative,
Positive
```

### Sentiment taxonomy with 3 classes (Negative/Neutral/Positive)

Sentiment3 taxonomy:

```csharp
Negative,
Neutral,
Positive
```

---

## Template Syntax - Part 2 of 2

Path: /assembly/java/template-syntax-part-2-of-2/

{{< alert style="info" >}}This article is the second part of the Template Syntax series of articles. For first part, please visit Template Syntax - Part 1 of 2.{{< /alert >}}

## Outputting Expression Results

You can output expression results to your reports using expression tags. An expression tag denotes a placeholder for an expression result within a template. While building a report, the corresponding expression is evaluated, and this placeholder is replaced with the formatted result of the expression.

An expression tag has no name and consists of the following elements:

*   An expression enclosed by brackets
*   An optional format string enclosed by double quotes and preceded by the ":" character
*   An optional `html` switch

```java
<<[expression]:"format" -html>>
```

If `html` switch is not present, the result of the corresponding expression is written to a document as a plain text at runtime. Font attributes are derived from the first character of the corresponding tag in this case.

If `html` switch is present, the expression result is considered to be a HTML block and is written as such. This feature is useful, when you need to format text parts of an expression result in different ways. For example, the following tag is replaced with a content like "**Bold** and *italic* text" at runtime.

```java
<<["<b>Bold</b> and <i>italic</i> text"] -html>>
```

To format a numeric or date-time expression result, you can specify a format string as an element of the corresponding expression tag. Such format strings are the same as the ones that you pass to DecimalFormat or SimpleDateFormat constructors. That is, for example, given that `d` is a `DateTime` value, you can use the following template to format the value using the "yyyy.MM.dd" pattern.

```java
<<[d]:"yyyy.MM.dd">>
```

## Outputting Sequential Data

You can output a sequence of elements of the same type to your report using a data band. A `data band` has a body that represents a template for a single element of such a sequence. While building a report, sequence elements are enumerated, and the following procedure takes place for each of the elements:

1.  The data band body is duplicated and appended to the report.
2.  The appended data band body is populated with the element's data.

**Note --** A data band body can contain nested data bands.

A data band body is defined between the corresponding opening and closing `foreach` tags within a template as follows.

```java
<<foreach ...>>
data_band_body
<</foreach>>
```

You can reference an element of the corresponding sequence in template expressions within a data band body using an iteration variable. At runtime, an iteration variable represents a sequence element for which an iteration is currently being performed. You can declare an iteration variable within the corresponding opening `foreach` tag.

An opening `foreach` tag defines a `foreach` statement enclosed by brackets. The following table describes elements of this statement.

| Element | Optional? | Remarks |
| --- | --- | --- |
| **Iteration Variable Type** | Yes | You can specify the type of an iteration variable explicitly. This type must be known by the engine (see [Setting up Known External Types](https://docs.groupdocs.com/assembly/java/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information).  
If you do not specify the type explicitly, it is determined implicitly by the engine depending on the type of the corresponding sequence. |
| **Iteration Variable Name** | Yes | You can specify the name of an iteration variable to use it while accessing the variable's members. The name must be unique within the scope of the corresponding `foreach` tag.  
If you do not specify the name, you can access the variable's members using the contextual object member access syntax (see [Using Contextual Object](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-contextual-object-member-access) Member Access" for more information). |
| **"in" Keyword** | No | 
 |
| **Sequence Expression** | No | A sequence expression must return an [Iterable](http://docs.oracle.com/javase/7/docs/api/java/lang/Iterable.html) implementor. |

The complete syntax of a `foreach` tag (including optional elements) is as follows.

```java
<<foreach [variable_type variable_name in sequence_expression]>>
data_band_body
<</foreach>>
```

### Common Data Bands

{{< alert style="info" >}}See [Bulleted List](https://docs.groupdocs.com/assembly/java/bulleted-list-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine) template using Common Data Bands in it.{{< /alert >}}

A common data band is a data band which body starts and ends within paragraphs that belong to a single story or table cell.

In particular, a common data band can be entirely located within a single paragraph. In this case, while building a report, the band is replaced with contents that are entirely located within the same paragraph as well. The following example illustrates such a scenario. Given that items is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them with commas in a single paragraph.

```java
The items are: <<foreach [item in items]>><<[item]>>, <</foreach>>and others.
```

In this case, the engine produces a report as follows.

```java
The items are: item1, item2, item3, and others.
```

When the body of a common data band starts and ends within different paragraphs, the engine duplicates on iteration only those paragraph breaks which are located within the body. The following table illustrates the relevant cases.

**Note --** Examples in the table are given with paragraph marks shown as per Microsoft Word® editor.

| Template | Report |
| --- | --- |
| `prefix <<foreach [item in items]>><<[item]>>¶`<br/>`<</foreach>>suffix`|`prefix item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix`|
| `prefix<<foreach [item in items]>>¶`<br/>`<<[item]>><</foreach>> suffix`|`prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3 suffix`|
| `prefix¶`<br/>`<<foreach [item in items]>><<[item]>>¶`<br/>`<</foreach>>suffix`| `prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix`|
| `prefix<<foreach [item in items]>>¶`<br/>`<<[item]>><</foreach>>¶`<br/>`suffix`|`prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix`|
| `prefix¶`<br/>`<<foreach [item in items]>>¶`<br/>`<<[item]>>¶`<br/>`<</foreach>>¶`<br/>`suffix`|`prefix¶`<br/>`¶`<br/>`item1¶`<br/>`¶`<br/>`item2¶`<br/>`¶`<br/>`item3¶`<br/>`¶`<br/>`suffix`|

While building a report, duplicated paragraph breaks derive common attributes from their template prototypes. In particular, this fact enables you to build numbered or bulleted lists in reports dynamically. For example, given the above declaration of items, you can get a report with their numbered list using the following template.

### Merging Table Cells Dynamically

You can merge table cells with equal textual contents within your reports dynamically using `cellMerge` tags. Syntax of a `cellMerge` tag is defined as follows.

```
<<cellMerge>>
```

By default, a `cellMerge` tag causes a cell merging operation only in a vertical direction during runtime. However, you can alter this behavior in the following ways:

- To merge cells only in a horizontal direction, use the `horz` switch as follows.
  `<<cellMerge -horz>>`

- To merge cells in both – vertical and horizontal – directions, use the `both` switch as follows.
  `<<cellMerge -both>>`

For two or more successive table cells to be merged dynamically in either direction by the engine, the following requirements must be met:

- Each of the cells must contain a `cellMerge` tag denoting a cell merging operation in the same direction (or directions).
- Each of the cells must not be already merged in another direction. This requirement does not apply when a `both` switch is used.
- The cells must have equal textual contents ignoring leading and trailing whitespaces.

Consider the following template.

| **...** | **...**                       | **...** |
| ------- | ----------------------------- | ------- |
| **...** | **<<cellMerge>><<[value1]>>** | **...** |
| **...** | **<<cellMerge>><<[value2]>>** | **...** |
| **...** | **...**                       | **...** |

If `value1` and `value2` have the same value, say “Hello”, table cells containing `cellMerge` tags are successfully merged during runtime and a result report looks as follows then.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>...</td>
			<td>...</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td rowspan="2">Hello</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td>...</td>
			<td>...</td>
		</tr>
	</tbody>
</table>

If `value1` and `value2` have different values, say “Hello” and “World”, table cells containing `cellMerge` tags are not merged during runtime and a result report looks as follows then.

| **...** | **...**   | **...** |
| ------- | --------- | ------- |
| **...** | **Hello** | **...** |
| **...** | **World** | **...** |
| **...** | **...**   | **...** |

**Note –** A `cellMerge` tag can be normally used within a table data band.

You can define an additional restriction on dynamic merging of table cells by providing an expression for a `cellMerge` tag using the following syntax.

```
<<cellMerge [expression]>>
```

During runtime, expressions defined for `cellMerge` tags are evaluated and dynamic cell merging is discarded for those tags, which expressions return unequal values, even if all other conditions for merging such as equal cell textual contents are met. In particular, this feature is useful when cells corresponding to different data band sequence elements should not be merged as shown in the following example.

Assume that you have the `Invoice` and `InvoiceItem` classes defined in your application as follows.

```java
public class Invoice
{
	public int getNumber() { ... }
	public Iterable<InvoiceItem> getItems() { ... }
	...
}
public class InvoiceItem
{
	public String getWare() { ... }
	public String getPack() { ... }
	public int getQuantity() { ... }
	...
}
```

Given that `invoices` is an enumeration of `Invoice` instances, you could use the following template to output information on several invoices in one table.

| **#**                                                        | **Ware**                              | **Pack**                 | **Quantity**                                         |
| ------------------------------------------------------------ | ------------------------------------- | ------------------------ | ---------------------------------------------------- |
| **<<foreach [invoice in invoices]>><<foreach [item in invoice.getItems()]>><<[invoice.getNumber()]>><<cellMerge>>** | **<<[item.getWare()]>><<cellMerge>>** | **<<[item.getPack()]>>** | **<<[item.getQuantity()]>><</foreach>><</foreach>>** |

A result document would look as follows then.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>#</td>
			<td>Ware</td>
			<td>Pack</td>
			<td>Quantity</td>
		</tr>
		<tr>
			<td rowspan="2">11342</td>
			<td rowspan="3">Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>30</td>
		</tr>
		<tr>
			<td>Bottle 0.5 L</td>
			<td>50</td>
		</tr>
		<tr>
			<td>15385</td>
			<td>Bottle 1.0 L</td>
			<td>110</td>
		</tr>
	</tbody>
</table>

That is, cells corresponding to the same wares at different invoices would be merged, which is unwanted. To prevent this from happening, you can use the following template instead.

| **#**                                                        | **Ware**                                                  | **Pack**                 | **Quantity**                                         |
| ------------------------------------------------------------ | --------------------------------------------------------- | ------------------------ | ---------------------------------------------------- |
| **<<foreach [invoice in invoices]>><<foreach [item in invoice.getItems()]>><<[invoice.getNumber()]>><<cellMerge>>** | **<<[item.getWare()]>><<cellMerge [invoice.indexOf()]>>** | **<<[item.getPack()]>>** | **<<[item.getQuantity()]>><</foreach>><</foreach>>** |

Then, a result document looks as follows.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>#</td>
			<td>Ware</td>
			<td>Pack</td>
			<td>Quantity</td>
		</tr>
		<tr>
			<td rowspan="2">11342</td>
			<td rowspan="2">Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>30</td>
		</tr>
		<tr>
			<td>Bottle 0.5 L</td>
			<td>50</td>
		</tr>
		<tr>
			<td>15385</td>
      <td>Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>110</td>
		</tr>
	</tbody>
</table>

### Numbered Lists

 "1. " in the template stands for a numbered list label.

```java
1. <<foreach [item in items]>><<[item]>>
<</foreach>>
```

In this case, the engine produces a report as follows.

```java
1. item1
2. item2
3. item3
```

#### Dynamic list numbering restart

This feature is useful when working with a nested numbered list within a data band as shown in the following example.

Assume that you have the Order and Service classes defined in your application as follows:

```java
public class Order
{
    public String getClientName() {... }

    public String getClientAddress() {... }

    public Iterable<Service> getServices() { ... }
    ...
}

public class Service
{
    public String getName() {...}
    ...
}
```

Given that orders is an enumeration of Order instances, you could try to use the following template to output information on several orders in one document.

```java
<<foreach [order in orders]>><<[order.getClientName()]>> (<<[order.getClientAddress()]>>)
1. <<foreach [service in order.getServices()]>><<[service.getName()]>>
<</foreach>><</foreach>>
```

But then, a resultant document would look as follows:
```
Jane Doe (445 Mount Eden Road Mount Eden Auckland 1024)
     1. Regular Cleaning
     2. Oven Cleaning
John Smith (43 Vogel Street Roslyn Palmerston North 4414)
     3. Regular Cleaning
     4. Oven Cleaning
     5. Carpet Cleaning
```

That is, there would be a single numbered list across all orders, which is not applicable for this scenario. However, you can make list numbering to restart for every order by putting a restartNum tag into your template before a corresponding foreach tag as follows:

```java
<<foreach [order in orders]>><<[order.getClientName()]>> (<<[order.getClientAddress()]>>)
1. <<restartNum>><<foreach [service in order.getServices()]>><<[service.getName()]>>
<</foreach>><</foreach>>
```

{{< alert style="warning" >}}When using with a data band, it is required to put a restartNum tag before a corresponding foreach tag in the same numbered paragraph.{{< /alert >}}

Then, a resultant document looks as follows:
```
Jane Doe (445 Mount Eden Road Mount Eden Auckland 1024)
   1.  Regular Cleaning
   2.  Oven Cleaning

John Smith (43 Vogel Street Roslyn Palmerston North 4414)
   1.  Regular Cleaning
   2.  Oven Cleaning
   3.  Carpet Cleaning
```

{{< alert style="warning" >}}You can use a restartNum tag without a data band to dynamically restart list numbering for a containing paragraph, if needed; for example, the tag can be used to restart list numbering for a document inserted dynamically.{{< /alert >}}

### Table-Row Data Bands

{{< alert style="info" >}}See [In-Table List With Alternate Content](https://docs.groupdocs.com/assembly/java/in-table-list-with-alternate-content-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine) template using Table-Row Data Bands in it.{{< /alert >}}

A table-row data band is a data band which body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows.

<table class="confluenceTable"><tbody><tr><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td></tr><tr><td class="confluenceTd"><p><code>&lt;&lt;foreach ...</code>&gt;&gt; ...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td></tr><tr><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td></tr><tr><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p><code>... &lt;&lt;/foreach&gt;&gt;</code></p></td></tr><tr><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td></tr></tbody></table>
The most common use case of a table-row data band is the building of a document table that represents a list of items. You can use a template like the following one to achieve this.

| Client | Manager | Contract Price |
| --- | --- | --- |
| `<<foreach [c in ds.Contracts]>><<[c.Clients.Name]>>`|`<<[c.Managers.Name]>>`|`<<[c.Price]>><</foreach>>`|
| Total: | |`<<[ds<br/>    .Contracts<br/>    .sum(c =><br/>        c.Price)]>>`|

In this case, the engine produces a report as follows.

| Client | Manager | Contract Price |
| --- | --- | --- |
| A Company | John Smith | 1200000 |
| B Ltd. | John Smith | 750000 |
| C & D | John Smith | 350000 |
| E Corp. | Tony Anderson | 650000 |
| F & Partners | Tony Anderson | 550000 |
| G & Co. | July James | 350000 |
| H Group | July James | 250000 |
| I & Sons | July James | 100000 |
| J Ent. | July James | 100000 |
| Total: ||4300000|

To populate a document table with a master-detail data, you can use nested table-row data bands like in the following template.

| Manager/Client | Contract Price |
| --- | --- |
| `<<foreach [m in ds.Managers]>><<[m.Name]>>`|`<<[m.Contracts.sum(c => c.Price)]>>`|
| `<<foreach [c in m.Contracts]>> <<[c.Clients.Name]>>`|`<<[c.Price]>><</foreach>><</foreach>>`|
| Total: |`<<[ds<br/>    .Contracts<br/>    .sum(c =><br/>        c.Price)]>>`|

In this case, the engine produces a report as follows.

| Manager/Client | Contract Price |
| --- | --- |
| John Smith | 2300000 |
|    A Company | 1200000 |
|    B Ltd. | 750000 |
|    C & D | 350000 |
| Tony Anderson | 1200000 |
|    E Corp. | 650000 |
|    F & Partners | 550000 |
| July James | 800000 |
|    G & Co. | 350000 |
|    H Group | 250000 |
|    I & Sons | 100000 |
|    J Ent. | 100000 |
| Total: | 4300000 |

You can normally use common data bands nested to table-row data bands as well like in the following template.

| Manager | Clients |
| --- | --- |
| `<<foreach [m in ds.Managers]>><<[m.Name]>>`|`<<foreach [c in m.Contracts]>><<[c.Clients.Name]>> <</foreach>><</foreach>>`|

In this case, the engine produces a report as follows.

| Manager | Clients |
| --- | --- |
| John Smith | A Company<br/>B Ltd.<br/>C & D |
| Tony Anderson | E Corp.<br/>F & Partners |
| July James | G & Co.<br/>H Group<br/>I & Sons<br/>J Ent. |

### Extension Methods of Iteration Variables

{{< alert style="info" >}}See [Multicolored Numbered List](https://docs.groupdocs.com/assembly/java/multicolored-numbered-list-in-word-processing-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine) template using Extension Methods of Iteration Variable in it.{{< /alert >}}

GroupDocs.Assembly Engine provides special extension methods for iteration variables of any type. You can normally use these extension methods in template expressions. The following list describes the extension methods.

*   `indexOf()`

Returns the zero-based index of a sequence item that is represented by the corresponding iteration variable. You can use this extension method to distinguish sequence items with different indexes and then handle them in different ways. For example, given that `items` is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them prefixing all of them but the first one with commas.

```java
The items are: <<foreach [
    item in items]>><<[item.indexOf() != 0
        ? ", "
        : ""]>><<[item]>><</foreach>>.
```

In this case, the engine produces a report as follows.

```java
The items are: item1, item2, item3.
```

*   `numberOf()`

Returns the one-based index of a sequence item that is represented by the corresponding iteration variable. You can use this extension method to number sequence `items` without involving Microsoft Word® lists. For example, given the previous declaration of items, you can enumerate and number them in a document table using the following template.

| No. | Item |
| --- | --- |
| `<<foreach [item in items]>><<[item.numberOf()]>>`|`<<[item]>><</foreach>>`|

In this case, the engine produces a report as follows.

| No. | Item |
| --- | --- |
| 1 | item1 |
| 2 | item2 |
| 3 | item3 |

### Charts Representing Sequential Data

{{< alert style="info" >}}See Bubble Chart template representing Sequential Data in it.{{< /alert >}}

GroupDocs.Assembly Engine enables you to use charts to represent your sequential data. To declare a chart that is going to be populated with data dynamically within your template, do the following steps:

1.  Add a chart to your template at the place where you want it to appear in a result document.
2.  Configure the appearance of the chart.
3.  Add required chart series and configure their appearance as well.
4.  Add a title to the chart, if missing.
5.  Add an opening foreach tag to the chart title.
6.  Depending on the type of the chart, add x tags to the chart title or chart series' names as follows.
  
    ```java
    <<x [x_value_expression]>>
    ```
    
    1.  For a scatter or bubble chart, you can go one of the following ways:
        1.  To use the same x-value expression for all chart series, add a single x tag to the chart title after the corresponding foreachtag.
        2.  To use different x-value expressions for every chart series, add multiple x tags to chart series' names – one for each chart series.  
            An x-value expression for a scatter or bubble chart must return a numeric value.
    2.  For a chart of another type, add a single x tag to the chart title after the corresponding foreach tag. In this case, an x-value expression must return a numeric, date, or string value.
7.  For a chart of any type, add y tags to chart series' names as follows.
  
    ```java
    <<y [y_value_expression]>>
    ```
    
    An y-value expression must return a numeric value.
    
8.  For a bubble chart, add size tags to chart series' names as follows.
  
    ```java
    <<size [bubble_size_expression]>>
    ```
    
    A bubble-size expression must return a numeric value.
    
9.  For a chart with dynamic data, you can select which series to include into it dynamically based upon conditions. In particular, this feature is useful when you need to restrict access to sensitive data in chart series for some users of your application. To use the feature, do the following steps:
  
    1.  Declare a chart with dynamic data in the usual way
    2.  For series to be removed from the chart based upon conditions dynamically, define the conditions in names of these series using removeif tags having the following syntax
    
    ```java
    <<removeif [conditional_expression]>>
    ```
    
    A conditional expression must return a Boolean value.

**Note:** A closing foreach tag is not used for a chart.
While composing expressions for x, y, and size tags, you can normally reference an iteration variable declared at the corresponding foreach tag in a chart title in the same way as if you intended to output results of expressions within a data band.

**Note:** You can normally use charts with dynamic data within data bands.
During runtime, a chart with a foreach tag in its title is processed by the engine as follows:

1.  A sequence expression declared at the foreach tag is evaluated and iterated.
2.  For every sequence item, expressions declared at x, y, and size tags are evaluated.
3.  Results of these expressions are used to populate corresponding chart series.
4.  All foreach, x, y, and size tags are removed from the chart title and chart series' names.  
    Consider the following example. Assume that you have the Manager and Contract classes defined in your application as follows.
    
    ```java
    public class Manager
    {
        public String getName() { ... }
        public Iterable<Contract> getContracts() { ... }
        ...
    }
    
    public class Contract
    {
        public float getPrice { ... }
        ...
    }
    ```
    
    Given that managers is an enumeration of Manager instances, you can use the following template to represent total contract prices achieved by managers in a [column chart](https://docs.groupdocs.com/assembly/java/working-with-chart-reports-filtered-ordered-grouped/).
        

## Enumeration Extension Methods

### The Enumeration

GroupDocs.Assembly Engine enables you to perform common manipulations on a sequential data through the engine's built-in extension methods for `Iterable`. These extension methods mimic some extension methods of [IEnumerable&lt;T>](http://msdn.microsoft.com/en-us/library/9eekhta0(v=vs.110).aspx) providing the same signatures and behavior features. Thus, you can group, sort, and perform other sequential data manipulations in template expressions in a familiar way.

### The Enumeration Extension

Below table describes the built-in extension methods. The following notation conventions are used within the table:

*   `Selector` stands for a lambda function returning a value and taking an enumeration item as its single argument. See [Using Lambda Functions](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-lambda-functions) for more information.
*   `ComparableSelector` stands for `Selector` returning [IComparable](http://msdn.microsoft.com/en-US/library/system.icomparable(v=vs.110).aspx).
*   `Predicate` stands for `Selector` returning a Boolean value.

Examples in this table are given using `persons` and `otherPersons`, enumerations of instances of the `Person` class that is defined as follows.

```java
public class Person
{
    public String getName { ... }
    public int getAge { ... }
    public Iterable<Person> getChildren { ... }
    ...
}
```

| Extension Method | Examples and Notes |
| --- | --- |
| `all(Predicate)` | `persons.all(p => p.getAge < 50)` |
| `any()` | `persons.any()` |
| `any(Predicate)` | `persons.any(p => p.getName == "John Smith")` |
| `average(Selector)` | `persons.average(p => p.getAge)`<br/>The input selector must return a value of any type that has predefined addition and division operators. |
| `concat(Iterable)` | `persons.concat(otherPersons)`<br/>An implicit reference conversion must exist between types of items of concatenated enumerations. |
| `contains(Object)` | `persons.contains(otherPersons.first())` |
| `count()` | `persons.count()` |
| `count(Predicate)` | `persons.count(p => p.getAge > 30)` |
| `distinct()` | `persons.distinct()` |
| `first()` | `persons.first()` |
| `first(Predicate)` | `persons.first(p => p.getAge > 30)` |
| `firstOrDefault()` | `persons.firstOrDefault()` |
| `firstOrDefault(Predicate)` | `persons.firstOrDefault(p => p.getAge > 30)` |
| `groupBy(Selector)` | `persons.groupBy(p => p.getAge)`<br/>Or<br/>`persons.groupBy(p => new {age = p.getAge, count = p.getChildren.count()c})`<br/>This method returns an enumeration of group objects. Each group has a unique key defined by the input selector and contains items of the source enumeration associated with this key. You can access the key of a group instance using the Key property. You can treat a group itself as an enumeration of items that the group contains. |
| `last()` | `persons.last()` |
| `last(Predicate)` | `persons.last(p => p.getAge > 100)` |
| `lastOrDefault()` | `persons.lastOrDefault()` |
| `lastOrDefault(Predicate)` | `persons.lastOrDefault(p => p.getAge > 100)` |
| `max(ComparableSelector)` | `persons.max(p => p.getAge)` |
| `min(ComparableSelector)` | `persons.min(p => p.getAge)` |
| `orderBy(ComparableSelector)` | `persons.orderBy(p => p.getAge)`<br/> Or<br/>`persons.orderBy(p => p.getAge).thenByDescending(p => p.getName)`<br/>Or<br/>`persons.orderBy(p => p.getAge).thenByDescending(p => p.getName).thenBy(p => p.getChildren.count())`<br/>This method returns an enumeration ordered by a single key. To specify additional ordering keys, you can use the following extension methods of an ordered enumeration:<br><ul><li>The feature of keyword escaping through the "@" character is not supported.</li><li>Unicode character escapes are not permitted in identifiers.</li></ul> |
| `orderByDescending(ComparableSelector)` | `persons.orderByDescending(p => p.getAge)`<br/>Or<br/>`persons.orderByDescending(p => p.getAge).thenByDescending(p => p.getName)`<br/>Or<br/>`persons.orderByDescending(p => p.getAge).thenByDescending(p => p.getName).thenBy(p => p.getChildren.count())`<br/>See the previous note. |
| `single()` | `persons.single()` |
| `single(Predicate)` | `persons.single(p => p.getName == "John Smith")` |
| `singleOrDefault()` | `persons.singleOrDefault()` |
| `singleOrDefault(Predicate)` | `persons.singleOrDefault(p => p.getName == "John Smith")` |
| `skip(int)` | `persons.skip(10)` |
| `skipWhile(Predicate)` | `persons.skipWhile(p => p.getAge < 21)` |
| `sum(Selector)` | `persons.sum(p => p.getChildren.count())`<br/>The input selector must return a value of any type that has a predefined addition operator. |
| `take(int)` | `persons.take(5)` |
| `takeWhile(Predicate)` | `persons.takeWhile(p => p.getAge < 50)` |
| `union(Iterable)` | `persons.union(otherPersons)`<br/>An implicit reference conversion must exist between types of items of united enumerations. |
| `where(Predicate)` | `persons.where(p => p.getAge > 18)` |
---

## Template Syntax - Part 2 of 2

Path: /assembly/net/template-syntax-part-2-of-2/

{{< alert style="info" >}}This article is the second part of the Template Syntax series of articles. For first part, please visit Template Syntax - Part 1 of 2.{{< /alert >}}

## Outputting Expression Results

You can output expression results to your reports using expression tags. An expression tag denotes a placeholder for an expression result within a template. While building a report, the corresponding expression is evaluated, and this placeholder is replaced with the formatted result of the expression.

An expression tag has no name and consists of the following elements:

*   An expression enclosed by brackets
*   An optional format string enclosed by double quotes and preceded by the ":" character
*   An optional `html` switch

```csharp
<<[expression]:"format" -html>>
```

If `html` switch is not present, the result of the corresponding expression is written to a document as a plain text at runtime. Font attributes are derived from the first character of the corresponding tag in this case.

If `html` switch is present, the expression result is considered to be a HTML block and is written as such. This feature is useful, when you need to format text parts of an expression result in different ways. For example, the following tag is replaced with a content like "**Bold** and *italic* text" at runtime.

```csharp
<<["<b>Bold</b> and <i>italic</i> text"] -html>>
```

To format a numeric or date-time expression result, you can specify a format string as an element of the corresponding expression tag. Such format strings are the same as the ones that you pass to [`IFormattable.ToString`](http://msdn.microsoft.com/en-us/library/system.iformattable.tostring(v=vs.110).aspx) method implementors. That is, for example, given that `d` is a `DateTime` value, you can use the following template to format the value using the "yyyy.MM.dd" pattern.

```csharp
<<[d]:"yyyy.MM.dd">>
```

## Outputting Sequential Data

You can output a sequence of elements of the same type to your report using a data band. A `data band` has a body that represents a template for a single element of such a sequence. While building a report, sequence elements are enumerated, and the following procedure takes place for each of the elements:

1.  The data band body is duplicated and appended to the report.
2.  The appended data band body is populated with the element's data.

**Note --** A data band body can contain nested data bands.

A data band body is defined between the corresponding opening and closing `foreach` tags within a template as follows.

```csharp
<<foreach ...>>
data_band_body
<</foreach>>
```

You can reference an element of the corresponding sequence in template expressions within a data band body using an iteration variable. At runtime, an iteration variable represents a sequence element for which an iteration is currently being performed. You can declare an iteration variable within the corresponding opening `foreach` tag.

An opening `foreach` tag defines a `foreach` statement enclosed by brackets. The following table describes elements of this statement.

| Element | Optional? | Remarks |
| --- | --- | --- |
| **Iteration Variable Type** | Yes | You can specify the type of an iteration variable explicitly. This type must be known by the engine (see [Setting up Known External Types](https://docs.groupdocs.com/assembly/net/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information). If you do not specify the type explicitly, it is determined implicitly by the engine depending on the type of the corresponding sequence. |
| **Iteration Variable Name** | Yes | You can specify the name of an iteration variable to use it while accessing the variable's members. The name must be unique within the scope of the corresponding `foreach` tag. If you do not specify the name, you can access the variable's members using the contextual object member access syntax (see [Using Contextual Object](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-contextual-object-member-access) Member Access" for more information). |
| **"in" Keyword** | No |  |
| **Sequence Expression** | No | A sequence expression must return an [IEnumerable](http://msdn.microsoft.com/en-us/library/system.collections.ienumerable(v=vs.110).aspx) implementor. |

The complete syntax of a `foreach` tag (including optional elements) is as follows.

```csharp
<<foreach [variable_type variable_name in sequence_expression]>>
data_band_body
<</foreach>>
```

### Common Data Bands

A common data band is a data band which body starts and ends within paragraphs that belong to a single story or table cell.

In particular, a common data band can be entirely located within a single paragraph. In this case, while building a report, the band is replaced with contents that are entirely located within the same paragraph as well. The following example illustrates such a scenario. Given that items is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them with commas in a single paragraph.

```csharp
The items are: <<foreach [item in items]>><<[item]>>, <</foreach>>and others.
```

In this case, the engine produces a report as follows.

```csharp
The items are: item1, item2, item3, and others.
```

When the body of a common data band starts and ends within different paragraphs, the engine duplicates on iteration only those paragraph breaks which are located within the body. The following table illustrates the relevant cases.

**Note --** Examples in the table are given with paragraph marks shown as per Microsoft Word® editor.

| Template | Report |
| --- | --- |
| `prefix <<foreach [item in items]>><<[item]>>¶`<br/>`<</foreach>>suffix` | `prefix item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix` |
| `prefix<<foreach [item in items]>>¶`<br/>`<<[item]>><</foreach>> suffix` | `prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3 suffix` |
| `prefix¶`<br/>`<<foreach [item in items]>><<[item]>>¶`<br/>`<</foreach>>suffix` | `prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix` |
| `prefix<<foreach [item in items]>>¶`<br/>`<<[item]>><</foreach>>¶`<br/>`suffix` | `prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix` |
| `prefix¶`<br/>`<<foreach [item in items]>>¶`<br/>`<<[item]>>¶`<br/>`<</foreach>>¶`<br/>`suffix` | `prefix¶`<br/>`¶`<br/>`item1¶`<br/>`¶`<br/>`item2¶`<br/>`¶`<br/>`item3¶`<br/>`¶`<br/>`suffix` |

While building a report, duplicated paragraph breaks derive common attributes from their template prototypes. In particular, this fact enables you to build numbered or bulleted lists in reports dynamically. For example, given the above declaration of items, you can get a report with their numbered list using the following template.

### Merging Table Cells Dynamically

You can merge table cells with equal textual contents within your reports dynamically using `cellMerge` tags. Syntax of a `cellMerge` tag is defined as follows.

```
<<cellMerge>>
```

By default, a `cellMerge` tag causes a cell merging operation only in a vertical direction during runtime. However, you can alter this behavior in the following ways:

- To merge cells only in a horizontal direction, use the `horz` switch as follows.
  `<<cellMerge -horz>>`

- To merge cells in both – vertical and horizontal – directions, use the `both` switch as follows.
  `<<cellMerge -both>>`

For two or more successive table cells to be merged dynamically in either direction by the engine, the following requirements must be met:

- Each of the cells must contain a `cellMerge` tag denoting a cell merging operation in the same direction (or directions).
- Each of the cells must not be already merged in another direction. This requirement does not apply when a `both` switch is used.
- The cells must have equal textual contents ignoring leading and trailing whitespaces.

Consider the following template.

| **...** | **...**                       | **...** |
| ------- | ----------------------------- | ------- |
| **...** | **<<cellMerge>><<[value1]>>** | **...** |
| **...** | **<<cellMerge>><<[value2]>>** | **...** |
| **...** | **...**                       | **...** |

If `value1` and `value2` have the same value, say “Hello”, table cells containing `cellMerge` tags are successfully merged during runtime and a result report looks as follows then.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>...</td>
			<td>...</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td rowspan="2">Hello</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td>...</td>
			<td>...</td>
		</tr>
	</tbody>
</table>

If `value1` and `value2` have different values, say “Hello” and “World”, table cells containing `cellMerge` tags are not merged during runtime and a result report looks as follows then.

| **...** | **...**   | **...** |
| ------- | --------- | ------- |
| **...** | **Hello** | **...** |
| **...** | **World** | **...** |
| **...** | **...**   | **...** |

**Note –** A cellMerge tag can be normally used within a table data band.

You can define an additional restriction on dynamic merging of table cells by providing an expression for a`cellMerge` tag using the following syntax.

```
<<cellMerge [expression]>>
```

During runtime, expressions defined for `cellMerge` tags are evaluated and dynamic cell merging is discarded for those tags, which expressions return unequal values, even if all other conditions for merging such as equal cell textual contents are met. In particular, this feature is useful when cells corresponding to different data band sequence elements should not be merged as shown in the following example.

Assume that you have the `Invoice` and `InvoiceItem` classes defined in your application as follows.

```csharp
public class Invoice
{
	public int Number { get { ... } }
	public IEnumerable<InvoiceItem> Items { get { ... } }
	...
}
public class InvoiceItem
{
	public String Ware { get { ... } }
	public String Pack { get { ... } }
	public int Quantity { get { ... } }
	...
}
```

Given that `invoices` is an enumeration of `Invoice` instances, you could use the following template to output information on several invoices in one table.

| **#**                                                        | **Ware**                         | **Pack**            | **Quantity**                                    |
| ------------------------------------------------------------ | -------------------------------- | ------------------- | ----------------------------------------------- |
| **<<foreach [invoice in invoices]>><<foreach [item in invoice.Items]>><<[invoice.Number]>><<cellMerge>>** | **<<[item.Ware]>><<cellMerge>>** | **<<[item.Pack]>>** | **<<[item.Quantity]>><</foreach>><</foreach>>** |

A result document would look as follows then.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>#</td>
			<td>Ware</td>
			<td>Pack</td>
			<td>Quantity</td>
		</tr>
		<tr>
			<td rowspan="2">11342</td>
			<td rowspan="3">Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>30</td>
		</tr>
		<tr>
			<td>Bottle 0.5 L</td>
			<td>50</td>
		</tr>
		<tr>
			<td>15385</td>
			<td>Bottle 1.0 L</td>
			<td>110</td>
		</tr>
	</tbody>
</table>

That is, cells corresponding to the same wares at different invoices would be merged, which is unwanted. To prevent this from happening, you can use the following template instead.

| **#**                                                        | **Ware**                                             | **Pack**            | **Quantity**                                    |
| ------------------------------------------------------------ | ---------------------------------------------------- | ------------------- | ----------------------------------------------- |
| **<<foreach [invoice in invoices]>><<foreach [item in invoice.Items]>><<[invoice.Number]>><<cellMerge>>** | **<<[item.Ware]>><<cellMerge [invoice.IndexOf()]>>** | **<<[item.Pack]>>** | **<<[item.Quantity]>><</foreach>><</foreach>>** |

Then, a result document looks as follows.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>#</td>
			<td>Ware</td>
			<td>Pack</td>
			<td>Quantity</td>
		</tr>
		<tr>
			<td rowspan="2">11342</td>
			<td rowspan="2">Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>30</td>
		</tr>
		<tr>
			<td>Bottle 0.5 L</td>
			<td>50</td>
		</tr>
		<tr>
			<td>15385</td>
      <td>Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>110</td>
		</tr>
	</tbody>
</table>

### Numbered Lists

 "1. " in the above template stands for a numbered list label.

```csharp
1. <<foreach [item in items]>><<[item]>>
<</foreach>>
```

In this case, the engine produces a report as follows.

```csharp
1. item1
2. item2
3. item3
```

#### Dynamic list numbering restart

This feature is useful when working with a nested numbered list within a data band as shown in the following example.

Assume that you have the Order and Service classes defined in your application as follows.

```csharp
public class Order
{
    public String ClientName { get { ... } }
    public String ClientAddress { get { ... } }
    public IEnumerable<Service> Services { get { ... } }
    ...
}
 
public class Service
{
    public String Name { get { ... } }
    ...
}
```

Given that orders is an enumeration of Order instances, you could try to use the following template to output information on several orders in one document.

```csharp
<<foreach [order in orders]>><<[order.ClientName]>> (<<[order.ClientAddress]>>)
1. <<foreach [service in order.Services]>><<[service.Name]>>
<</foreach>><</foreach>>
```

But then, a result document would look as follows.

```csharp
Jane Doe (445 Mount Eden Road Mount Eden Auckland 1024)

   1. Regular Cleaning
   2. Oven Cleaning

John Smith (43 Vogel Street Roslyn Palmerston North 4414)

   3. Regular Cleaning
   4. Oven Cleaning
   5. Carpet Cleaning
```

That is, there would be a single numbered list across all orders, which is not applicable for this scenario. However, you can make list numbering to restart for every order by putting a restartNum tag into your template before a corresponding foreach tag as follows.

```csharp
<<foreach [order in orders]>><<[order.ClientName]>> (<<[order.ClientAddress]>>)
1. <<restartNum>><<foreach [service in order.Services]>><<[service.Name]>>
<</foreach>><</foreach>>
```

{{< alert style="warning" >}}When using with a data band, it is required to put a restartNum tag before a corresponding foreach tag in the same numbered paragraph.{{< /alert >}}

Then, a result document looks as follows.

```csharp
Jane Doe (445 Mount Eden Road Mount Eden Auckland 1024)

   1. Regular Cleaning
   2. Oven Cleaning

John Smith (43 Vogel Street Roslyn Palmerston North 4414)

   1. Regular Cleaning
   2. Oven Cleaning
   3. Carpet Cleaning
```

{{< alert style="warning" >}}You can use a restartNum tag without a data band to dynamically restart list numbering for a containing paragraph, for example, the tag can be used to restart list numbering for a document inserted dynamically.{{< /alert >}}

### Table-Row Data Bands

A table-row data band is a data band which body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows.

<table class="confluenceTable"><tbody><tr><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td></tr><tr><td class="confluenceTd"><p><code>&lt;&lt;foreach ...&gt;&gt;</code> ...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td></tr><tr><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td></tr><tr><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p><code>... &lt;&lt;/foreach&gt;&gt;</code></p></td></tr><tr><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td></tr></tbody></table>
The following examples in this section are given using `ds`, a `DataSet` instance containing `DataTable` and `DataRelation` objects according to the following data model.

<link to the DB diagram>

The most common use case of a table-row data band is the building of a document table that represents a list of items. You can use a template like the following one to achieve this.

| Client | Manager | Contract Price |
| --- | --- | --- |
| `<<foreach [c in ds.Contracts]>><<[c.Clients.Name]>>` | `<<[c.Managers.Name]>>` | `<<[c.Price]>><</foreach>>` |
| Total: |  | `<<[ds.Contracts.Sum(c => c.Price)]>>` |

In this case, the engine produces a report as follows.

| Client | Manager | Contract Price |
| --- | --- | --- |
| A Company | John Smith | 1200000 |
| B Ltd. | John Smith | 750000 |
| C & D | John Smith | 350000 |
| E Corp. | Tony Anderson | 650000 |
| F & Partners | Tony Anderson | 550000 |
| G & Co. | July James | 350000 |
| H Group | July James | 250000 |
| I & Sons | July James | 100000 |
| J Ent. | July James | 100000 |
| Total: |  | 4300000 |

To populate a document table with a master-detail data, you can use nested table-row data bands like in the following template.

| Manager/Client | Contract Price |
| --- | --- |
| `<<foreach [m in ds.Managers]>><<[m.Name]>>` | `<<[m.Contracts.Sum(c => c.Price)]>>` |
| `<<foreach [c in m.Contracts]>>   <<[c.Clients.Name]>>` | `<<[c.Price]>><</foreach>><</foreach>>` |
| Total: | `<<[ds.Contracts.Sum(c => c.Price)]>>` |

In this case, the engine produces a report as follows.

| Manager/Client | Contract Price |
| --- | --- |
| John Smith | 2300000 |
|    A Company | 1200000 |
|    B Ltd. | 750000 |
|    C & D | 350000 |
| Tony Anderson | 1200000 |
|    E Corp. | 650000 |
|    F & Partners | 550000 |
| July James | 800000 |
|    G & Co. | 350000 |
|    H Group | 250000 |
|    I & Sons | 100000 |
|    J Ent. | 100000 |
| Total: | 4300000 |

You can normally use common data bands nested to table-row data bands as well like in the following template.

| Manager | Clients |
| --- | --- |
| `<<foreach [m in ds.Managers]>><<[m.Name]>>` | `<<foreach [c in m.Contracts]>><<[c.Clients.Name]>><br/><</foreach>><</foreach>>` |

In this case, the engine produces a report as follows.

| Manager | Clients |
| --- | --- |
| John Smith | A Company<br/>B Ltd.<br/>C & D<br/> |
| Tony Anderson | E Corp.<br/>F & Partners<br/> |
| July James | G & Co.<br/>H Group<br/>I & Sons<br/>J Ent.<br/> |

### Extension Methods of Iteration Variables

GroupDocs.Assembly Engine provides special extension methods for iteration variables of any type. You can normally use these extension methods in template expressions. The following list describes the extension methods.

*   `IndexOf()`

Returns the zero-based index of a sequence item that is represented by the corresponding iteration variable. You can use this extension method to distinguish sequence items with different indexes and then handle them in different ways. For example, given that `items` is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them prefixing all of them but the first one with commas.

```csharp
The items are: <<foreach [
    item in items]>><<[item.IndexOf() != 0
        ? ", "
        : ""]>><<[item]>><</foreach>>.
```

In this case, the engine produces a report as follows.

```csharp
The items are: item1, item2, item3.
```

*   `NumberOf()`

Returns the one-based index of a sequence item that is represented by the corresponding iteration variable. You can use this extension method to number sequence `items` without involving Microsoft Word® lists. For example, given the previous declaration of items, you can enumerate and number them in a document table using the following template.

| No. | Item |
| --- | --- |
| `<<foreach [item in items]>><<[item.NumberOf()]>>` | `<<[item]>><</foreach>>` |

In this case, the engine produces a report as follows.

| No. | Item |
| --- | --- |
| 1 | item1 |
| 2 | item2 |
| 3 | item3 |

### Charts Representing Sequential Data

GroupDocs.Assembly Engine enables you to use charts to represent your sequential data. To declare a chart that is going to be populated with data dynamically within your template, do the following steps:

1.  Add a chart to your template at the place where you want it to appear in a result document.
2.  Configure the appearance of the chart.
3.  Add required chart series and configure their appearance as well.
4.  Add a title to the chart, if missing.
5.  Add an opening foreach tag to the chart title.
6.  Depending on the type of the chart, add x tags to the chart title or chart series' names as follows.
  
    ```csharp
    <<x [x_value_expression]>>
    ```
    
    * For a scatter or bubble chart, you can go one of the following ways:
        - To use the same x-value expression for all chart series, add a single x tag to the chart title after the corresponding foreachtag.
        - To use different x-value expressions for every chart series, add multiple x tags to chart series' names – one for each chart series. An x-value expression for a scatter or bubble chart must return a numeric value.
    * For a chart of another type, add a single x tag to the chart title after the corresponding foreach tag. In this case, an x-value expression must return a numeric, date, or string value.
7.  For a chart of any type, add y tags to chart series' names as follows.
  
    ```csharp
    <<y [y_value_expression]>>
    ```
    
    An y-value expression must return a numeric value.
    
8.  For a bubble chart, add size tags to chart series' names as follows.
  
    ```csharp
    <<size [bubble_size_expression]>>
    ```
    
    A bubble-size expression must return a numeric value.
    
9.  For a chart with dynamic data, you can select which series to include into it dynamically based upon conditions. In particular, this feature is useful when you need to restrict access to sensitive data in chart series for some users of your application. To use the feature, do the following steps:
  
    * Declare a chart with dynamic data in the usual way
    * For series to be removed from the chart based upon conditions dynamically, define the conditions in names of these series using removeif tags having the following syntax
    
    ```csharp
    <<removeif [conditional_expression]>>
    ```
    
    A conditional expression must return a Boolean value.
    

**Note:** A closing foreach tag is not used for a chart.  
While composing expressions for x, y, and size tags, you can normally reference an iteration variable declared at the corresponding foreach tag in a chart title in the same way as if you intended to output results of expressions within a data band.

**Note:** You can normally use charts with dynamic data within data bands.  
During runtime, a chart with a foreach tag in its title is processed by the engine as follows:

1.  A sequence expression declared at the foreach tag is evaluated and iterated.
2.  For every sequence item, expressions declared at x, y, and size tags are evaluated.
3.  Results of these expressions are used to populate corresponding chart series.
4.  All foreach, x, y, and size tags are removed from the chart title and chart series' names.  
    Consider the following example. Assume that you have the Manager and Contract classes defined in your application as follows.
    
    ```csharp
    public class Manager
    {
        public String Name { get { ... } }
        public IEnumerable<Contract> Contracts { get { ... } }
        ...
    }
    
    public class Contract
    {
        public float Price { get { ... } }
        ...
    }
    ```
    
    Given that managers is an enumeration of Manager instances, you can use the following template to represent total contract prices achieved by managers in a column chart.  
    <link to the template>  
    In this case, the engine produces a report as follows.  
    <link to the report>
    

## Enumeration Extension Methods

### The Enumeration

GroupDocs.Assembly Engine enables you to perform common manipulations on a sequential data through the engine's built-in extension methods for `IEnumerable`. These extension methods mimic some extension methods of [IEnumerable<T>](http://msdn.microsoft.com/en-us/library/9eekhta0(v=vs.110).aspx) providing the same signatures and behavior features. Thus, you can group, sort, and perform other sequential data manipulations in template expressions in a familiar way.

### The Enumeration Extension

Below table describes the built-in extension methods. The following notation conventions are used within the table:

*   `Selector` stands for a lambda function returning a value and taking an enumeration item as its single argument. See [Using Lambda Functions](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-lambda-functions) for more information.
*   `ComparableSelector` stands for `Selector` returning [IComparable](http://msdn.microsoft.com/en-US/library/system.icomparable(v=vs.110).aspx).
*   `Predicate` stands for `Selector` returning a Boolean value.

Examples in this table are given using `persons` and `otherPersons`, enumerations of instances of the `Person` class that is defined as follows.

```csharp
public class Person
{
    public String Name { get { ... } }
    public int Age { get { ... } }
    public IEnumerable<Person> Children { get { ... } }
    ...
}
```

| Extension Method | Examples and Notes |
| --- | --- |
| `All(Predicate)` | `persons.All(p => p.Age < 50)` |
| `Any()` | `persons.Any()` |
| `Any(Predicate)` | `persons.Any(p => p.Name == "John Smith")` |
| `Average(Selector)` | `persons.Average(p => p.Age)`<br/>The input selector must return a value of any type that has predefined or user-defined addition and division operators. |
| `Concat(IEnumerable)` | `persons.Concat(otherPersons)`<br/>An implicit reference conversion must exist between types of items of concatenated enumerations. |
| `Contains(Object)` | `persons.Contains(otherPersons.First())` |
| `Count()` | `persons.Count()` |
| `Count(Predicate)` | `persons.Count(p => p.Age > 30)` |
| `Distinct()` | `persons.Distinct()` |
| `First()` | `persons.First()` |
| `First(Predicate)` | `persons.First(p => p.Age > 30)` |
| `FirstOrDefault()` | `persons.FirstOrDefault()` |
| `FirstOrDefault(Predicate)` | `persons.FirstOrDefault(p => p.Age > 30)` |
| `GroupBy(Selector)` | `persons.GroupBy(p => p.Age)`<br/>Or<br/>`persons.GroupBy(p => new { Age = p.Age, Count = p.Children.Count() })`<br/>This method returns an enumeration of group objects. Each group has a unique key defined by the input selector and contains items of the source enumeration associated with this key. You can access the key of a group instance using the `Key` property. You can treat a group itself as an enumeration of items that the group contains. |
| `Last()` | `persons.Last()` |
| `Last(Predicate)` | `persons.Last(p => p.Age > 100)` |
| `LastOrDefault()` | `persons.LastOrDefault()` |
| `LastOrDefault(Predicate)` | `persons.LastOrDefault(p => p.Age > 100)` |
| `Max(ComparableSelector)` | `persons.Max(p => p.Age)` |
| `Min(ComparableSelector)` | `persons.Min(p => p.Age)` |
| `OrderBy(ComparableSelector)` | `persons.OrderBy(p => p.Age)`<br/>Or<br/>`persons.OrderBy(p => p.Age).ThenByDescending(p => p.Name)`<br/>Or<br/>`persons.OrderBy(p => p.Age).ThenByDescending(p => p.Name).ThenBy(p => p.Children.Count())`<br/>This method returns an enumeration ordered by a single key. To specify additional ordering keys, you can use the following extension methods of an ordered enumeration: <ul><li>`ThenBy(ComparableSelector)`</li><li>`ThenByDescending(ComparableSelector)`</li></ul> |
| `OrderByDescending(ComparableSelector)` | `persons.OrderByDescending(p => p.Age)`<br/>Or<br/>`persons.OrderByDescending(p => p.Age).ThenByDescending(p => p.Name)`<br/>Or<br/>`persons.OrderByDescending(p => p.Age).ThenByDescending(p => p.Name).ThenBy(p => p.Children.Count())`<br/>See the previous note. |
| `Single()` | `persons.Single()` |
| `Single(Predicate)` | `persons.Single(p => p.Name == "John Smith")` |
| `SingleOrDefault()` | `persons.SingleOrDefault()` |
| `SingleOrDefault(Predicate)` | `persons.SingleOrDefault(p => p.Name == "John Smith")` |
| `Skip(int)` | `persons.Skip(10)` |
| `SkipWhile(Predicate)` | `persons.SkipWhile(p => p.Age < 21)` |
| `Sum(Selector)` | `persons.Sum(p => p.Children.Count())`<br/>The input selector must return a value of any type that has a predefined or user-defined addition operator. |
| `Take(int)` | `persons.Take(5)` |
| `TakeWhile(Predicate)` | `persons.TakeWhile(p => p.Age < 50)` |
| `Union(IEnumerable)` | `persons.Union(otherPersons)`<br/>An implicit reference conversion must exist between types of items of united enumerations. |
| `Where(Predicate)` | `persons.Where(p => p.Age > 18)` |

---

## Template Syntax - Part 2 of 2

Path: /assembly/python-net/template-syntax-part-2-of-2/

{{< alert style="info" >}}This article is the second part of the Template Syntax series of articles. For first part, please visit Template Syntax - Part 1 of 2.{{< /alert >}}

## Outputting Expression Results

You can output expression results to your reports using expression tags. An expression tag denotes a placeholder for an expression result within a template. While building a report, the corresponding expression is evaluated, and this placeholder is replaced with the formatted result of the expression.

An expression tag has no name and consists of the following elements:

*   An expression enclosed by brackets
*   An optional format string enclosed by double quotes and preceded by the ":" character
*   An optional `html` switch

```csharp
<<[expression]:"format" -html>>
```

If `html` switch is not present, the result of the corresponding expression is written to a document as a plain text at runtime. Font attributes are derived from the first character of the corresponding tag in this case.

If `html` switch is present, the expression result is considered to be a HTML block and is written as such. This feature is useful, when you need to format text parts of an expression result in different ways. For example, the following tag is replaced with a content like "**Bold** and *italic* text" at runtime.

```csharp
<<["<b>Bold</b> and <i>italic</i> text"] -html>>
```

To format a numeric or date-time expression result, you can specify a format string as an element of the corresponding expression tag. Such format strings are the same as the ones that you pass to [`IFormattable.ToString`](http://msdn.microsoft.com/en-us/library/system.iformattable.tostring(v=vs.110).aspx) method implementors. That is, for example, given that `d` is a `DateTime` value, you can use the following template to format the value using the "yyyy.MM.dd" pattern.

```csharp
<<[d]:"yyyy.MM.dd">>
```

## Outputting Sequential Data

You can output a sequence of elements of the same type to your report using a data band. A `data band` has a body that represents a template for a single element of such a sequence. While building a report, sequence elements are enumerated, and the following procedure takes place for each of the elements:

1.  The data band body is duplicated and appended to the report.
2.  The appended data band body is populated with the element's data.

**Note --** A data band body can contain nested data bands.

A data band body is defined between the corresponding opening and closing `foreach` tags within a template as follows.

```csharp
<<foreach ...>>
data_band_body
<</foreach>>
```

You can reference an element of the corresponding sequence in template expressions within a data band body using an iteration variable. At runtime, an iteration variable represents a sequence element for which an iteration is currently being performed. You can declare an iteration variable within the corresponding opening `foreach` tag.

An opening `foreach` tag defines a `foreach` statement enclosed by brackets. The following table describes elements of this statement.

| Element | Optional? | Remarks |
| --- | --- | --- |
| **Iteration Variable Type** | Yes | You can specify the type of an iteration variable explicitly. This type must be known by the engine (see [Setting up Known External Types](https://docs.groupdocs.com/assembly/python-net/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information). If you do not specify the type explicitly, it is determined implicitly by the engine depending on the type of the corresponding sequence. |
| **Iteration Variable Name** | Yes | You can specify the name of an iteration variable to use it while accessing the variable's members. The name must be unique within the scope of the corresponding `foreach` tag. If you do not specify the name, you can access the variable's members using the contextual object member access syntax (see [Using Contextual Object](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/#using-contextual-object-member-access) Member Access" for more information). |
| **"in" Keyword** | No |  |
| **Sequence Expression** | No | A sequence expression must return an [IEnumerable](http://msdn.microsoft.com/en-us/library/system.collections.ienumerable(v=vs.110).aspx) implementor. |

The complete syntax of a `foreach` tag (including optional elements) is as follows.

```csharp
<<foreach [variable_type variable_name in sequence_expression]>>
data_band_body
<</foreach>>
```

### Common Data Bands

A common data band is a data band which body starts and ends within paragraphs that belong to a single story or table cell.

In particular, a common data band can be entirely located within a single paragraph. In this case, while building a report, the band is replaced with contents that are entirely located within the same paragraph as well. The following example illustrates such a scenario. Given that items is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them with commas in a single paragraph.

```csharp
The items are: <<foreach [item in items]>><<[item]>>, <</foreach>>and others.
```

In this case, the engine produces a report as follows.

```csharp
The items are: item1, item2, item3, and others.
```

When the body of a common data band starts and ends within different paragraphs, the engine duplicates on iteration only those paragraph breaks which are located within the body. The following table illustrates the relevant cases.

**Note --** Examples in the table are given with paragraph marks shown as per Microsoft Word® editor.

| Template | Report |
| --- | --- |
| `prefix <<foreach [item in items]>><<[item]>>¶`<br/>`<</foreach>>suffix` | `prefix item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix` |
| `prefix<<foreach [item in items]>>¶`<br/>`<<[item]>><</foreach>> suffix` | `prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3 suffix` |
| `prefix¶`<br/>`<<foreach [item in items]>><<[item]>>¶`<br/>`<</foreach>>suffix` | `prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix` |
| `prefix<<foreach [item in items]>>¶`<br/>`<<[item]>><</foreach>>¶`<br/>`suffix` | `prefix¶`<br/>`item1¶`<br/>`item2¶`<br/>`item3¶`<br/>`suffix` |
| `prefix¶`<br/>`<<foreach [item in items]>>¶`<br/>`<<[item]>>¶`<br/>`<</foreach>>¶`<br/>`suffix` | `prefix¶`<br/>`¶`<br/>`item1¶`<br/>`¶`<br/>`item2¶`<br/>`¶`<br/>`item3¶`<br/>`¶`<br/>`suffix` |

While building a report, duplicated paragraph breaks derive common attributes from their template prototypes. In particular, this fact enables you to build numbered or bulleted lists in reports dynamically. For example, given the above declaration of items, you can get a report with their numbered list using the following template.

### Merging Table Cells Dynamically

You can merge table cells with equal textual contents within your reports dynamically using `cellMerge` tags. Syntax of a `cellMerge` tag is defined as follows.

```
<<cellMerge>>
```

By default, a `cellMerge` tag causes a cell merging operation only in a vertical direction during runtime. However, you can alter this behavior in the following ways:

- To merge cells only in a horizontal direction, use the `horz` switch as follows.
  `<<cellMerge -horz>>`

- To merge cells in both – vertical and horizontal – directions, use the `both` switch as follows.
  `<<cellMerge -both>>`

For two or more successive table cells to be merged dynamically in either direction by the engine, the following requirements must be met:

- Each of the cells must contain a `cellMerge` tag denoting a cell merging operation in the same direction (or directions).
- Each of the cells must not be already merged in another direction. This requirement does not apply when a `both` switch is used.
- The cells must have equal textual contents ignoring leading and trailing whitespaces.

Consider the following template.

| **...** | **...**                       | **...** |
| ------- | ----------------------------- | ------- |
| **...** | **<<cellMerge>><<[value1]>>** | **...** |
| **...** | **<<cellMerge>><<[value2]>>** | **...** |
| **...** | **...**                       | **...** |

If `value1` and `value2` have the same value, say “Hello”, table cells containing `cellMerge` tags are successfully merged during runtime and a result report looks as follows then.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>...</td>
			<td>...</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td rowspan="2">Hello</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td>...</td>
		</tr>
		<tr>
			<td>...</td>
			<td>...</td>
			<td>...</td>
		</tr>
	</tbody>
</table>

If `value1` and `value2` have different values, say “Hello” and “World”, table cells containing `cellMerge` tags are not merged during runtime and a result report looks as follows then.

| **...** | **...**   | **...** |
| ------- | --------- | ------- |
| **...** | **Hello** | **...** |
| **...** | **World** | **...** |
| **...** | **...**   | **...** |

**Note –** A cellMerge tag can be normally used within a table data band.

You can define an additional restriction on dynamic merging of table cells by providing an expression for a`cellMerge` tag using the following syntax.

```
<<cellMerge [expression]>>
```

During runtime, expressions defined for `cellMerge` tags are evaluated and dynamic cell merging is discarded for those tags, which expressions return unequal values, even if all other conditions for merging such as equal cell textual contents are met. In particular, this feature is useful when cells corresponding to different data band sequence elements should not be merged as shown in the following example.

Assume that you have the `Invoice` and `InvoiceItem` classes defined in your application as follows.

```csharp
public class Invoice
{
	public int Number { get { ... } }
	public IEnumerable<InvoiceItem> Items { get { ... } }
	...
}
public class InvoiceItem
{
	public String Ware { get { ... } }
	public String Pack { get { ... } }
	public int Quantity { get { ... } }
	...
}
```

Given that `invoices` is an enumeration of `Invoice` instances, you could use the following template to output information on several invoices in one table.

| **#**                                                        | **Ware**                         | **Pack**            | **Quantity**                                    |
| ------------------------------------------------------------ | -------------------------------- | ------------------- | ----------------------------------------------- |
| **<<foreach [invoice in invoices]>><<foreach [item in invoice.Items]>><<[invoice.Number]>><<cellMerge>>** | **<<[item.Ware]>><<cellMerge>>** | **<<[item.Pack]>>** | **<<[item.Quantity]>><</foreach>><</foreach>>** |

A result document would look as follows then.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>#</td>
			<td>Ware</td>
			<td>Pack</td>
			<td>Quantity</td>
		</tr>
		<tr>
			<td rowspan="2">11342</td>
			<td rowspan="3">Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>30</td>
		</tr>
		<tr>
			<td>Bottle 0.5 L</td>
			<td>50</td>
		</tr>
		<tr>
			<td>15385</td>
			<td>Bottle 1.0 L</td>
			<td>110</td>
		</tr>
	</tbody>
</table>

That is, cells corresponding to the same wares at different invoices would be merged, which is unwanted. To prevent this from happening, you can use the following template instead.

| **#**                                                        | **Ware**                                             | **Pack**            | **Quantity**                                    |
| ------------------------------------------------------------ | ---------------------------------------------------- | ------------------- | ----------------------------------------------- |
| **<<foreach [invoice in invoices]>><<foreach [item in invoice.Items]>><<[invoice.Number]>><<cellMerge>>** | **<<[item.Ware]>><<cellMerge [invoice.IndexOf()]>>** | **<<[item.Pack]>>** | **<<[item.Quantity]>><</foreach>><</foreach>>** |

Then, a result document looks as follows.

<table style="font-weight: bold">
	<tbody>
		<tr>
			<td>#</td>
			<td>Ware</td>
			<td>Pack</td>
			<td>Quantity</td>
		</tr>
		<tr>
			<td rowspan="2">11342</td>
			<td rowspan="2">Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>30</td>
		</tr>
		<tr>
			<td>Bottle 0.5 L</td>
			<td>50</td>
		</tr>
		<tr>
			<td>15385</td>
      <td>Natural Mineral Water</td>
			<td>Bottle 1.0 L</td>
			<td>110</td>
		</tr>
	</tbody>
</table>

### Numbered Lists

 "1. " in the above template stands for a numbered list label.

```csharp
1. <<foreach [item in items]>><<[item]>>
<</foreach>>
```

In this case, the engine produces a report as follows.

```csharp
1. item1
2. item2
3. item3
```

#### Dynamic list numbering restart

This feature is useful when working with a nested numbered list within a data band as shown in the following example.

Assume that you have the Order and Service classes defined in your application as follows.

```csharp
public class Order
{
    public String ClientName { get { ... } }
    public String ClientAddress { get { ... } }
    public IEnumerable<Service> Services { get { ... } }
    ...
}
 
public class Service
{
    public String Name { get { ... } }
    ...
}
```

Given that orders is an enumeration of Order instances, you could try to use the following template to output information on several orders in one document.

```csharp
<<foreach [order in orders]>><<[order.ClientName]>> (<<[order.ClientAddress]>>)
1. <<foreach [service in order.Services]>><<[service.Name]>>
<</foreach>><</foreach>>
```

But then, a result document would look as follows.

```csharp
Jane Doe (445 Mount Eden Road Mount Eden Auckland 1024)

   1. Regular Cleaning
   2. Oven Cleaning

John Smith (43 Vogel Street Roslyn Palmerston North 4414)

   3. Regular Cleaning
   4. Oven Cleaning
   5. Carpet Cleaning
```

That is, there would be a single numbered list across all orders, which is not applicable for this scenario. However, you can make list numbering to restart for every order by putting a restartNum tag into your template before a corresponding foreach tag as follows.

```csharp
<<foreach [order in orders]>><<[order.ClientName]>> (<<[order.ClientAddress]>>)
1. <<restartNum>><<foreach [service in order.Services]>><<[service.Name]>>
<</foreach>><</foreach>>
```

{{< alert style="warning" >}}When using with a data band, it is required to put a restartNum tag before a corresponding foreach tag in the same numbered paragraph.{{< /alert >}}

Then, a result document looks as follows.

```csharp
Jane Doe (445 Mount Eden Road Mount Eden Auckland 1024)

   1. Regular Cleaning
   2. Oven Cleaning

John Smith (43 Vogel Street Roslyn Palmerston North 4414)

   1. Regular Cleaning
   2. Oven Cleaning
   3. Carpet Cleaning
```

{{< alert style="warning" >}}You can use a restartNum tag without a data band to dynamically restart list numbering for a containing paragraph, for example, the tag can be used to restart list numbering for a document inserted dynamically.{{< /alert >}}

### Table-Row Data Bands

A table-row data band is a data band which body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows.

<table class="confluenceTable"><tbody><tr><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td></tr><tr><td class="confluenceTd"><p><code>&lt;&lt;foreach ...&gt;&gt;</code> ...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td></tr><tr><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td></tr><tr><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p>...</p></td><td class="confluenceTd"><p><code>... &lt;&lt;/foreach&gt;&gt;</code></p></td></tr><tr><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td><td class="confluenceTd"><p>&nbsp;</p></td></tr></tbody></table>
The following examples in this section are given using `ds`, a `DataSet` instance containing `DataTable` and `DataRelation` objects according to the following data model.

<link to the DB diagram>

The most common use case of a table-row data band is the building of a document table that represents a list of items. You can use a template like the following one to achieve this.

| Client | Manager | Contract Price |
| --- | --- | --- |
| `<<foreach [c in ds.Contracts]>><<[c.Clients.Name]>>` | `<<[c.Managers.Name]>>` | `<<[c.Price]>><</foreach>>` |
| Total: |  | `<<[ds.Contracts.Sum(c => c.Price)]>>` |

In this case, the engine produces a report as follows.

| Client | Manager | Contract Price |
| --- | --- | --- |
| A Company | John Smith | 1200000 |
| B Ltd. | John Smith | 750000 |
| C & D | John Smith | 350000 |
| E Corp. | Tony Anderson | 650000 |
| F & Partners | Tony Anderson | 550000 |
| G & Co. | July James | 350000 |
| H Group | July James | 250000 |
| I & Sons | July James | 100000 |
| J Ent. | July James | 100000 |
| Total: |  | 4300000 |

To populate a document table with a master-detail data, you can use nested table-row data bands like in the following template.

| Manager/Client | Contract Price |
| --- | --- |
| `<<foreach [m in ds.Managers]>><<[m.Name]>>` | `<<[m.Contracts.Sum(c => c.Price)]>>` |
| `<<foreach [c in m.Contracts]>>   <<[c.Clients.Name]>>` | `<<[c.Price]>><</foreach>><</foreach>>` |
| Total: | `<<[ds.Contracts.Sum(c => c.Price)]>>` |

In this case, the engine produces a report as follows.

| Manager/Client | Contract Price |
| --- | --- |
| John Smith | 2300000 |
|    A Company | 1200000 |
|    B Ltd. | 750000 |
|    C & D | 350000 |
| Tony Anderson | 1200000 |
|    E Corp. | 650000 |
|    F & Partners | 550000 |
| July James | 800000 |
|    G & Co. | 350000 |
|    H Group | 250000 |
|    I & Sons | 100000 |
|    J Ent. | 100000 |
| Total: | 4300000 |

You can normally use common data bands nested to table-row data bands as well like in the following template.

| Manager | Clients |
| --- | --- |
| `<<foreach [m in ds.Managers]>><<[m.Name]>>` | `<<foreach [c in m.Contracts]>><<[c.Clients.Name]>><br/><</foreach>><</foreach>>` |

In this case, the engine produces a report as follows.

| Manager | Clients |
| --- | --- |
| John Smith | A Company<br/>B Ltd.<br/>C & D<br/> |
| Tony Anderson | E Corp.<br/>F & Partners<br/> |
| July James | G & Co.<br/>H Group<br/>I & Sons<br/>J Ent.<br/> |

### Extension Methods of Iteration Variables

GroupDocs.Assembly Engine provides special extension methods for iteration variables of any type. You can normally use these extension methods in template expressions. The following list describes the extension methods.

*   `IndexOf()`

Returns the zero-based index of a sequence item that is represented by the corresponding iteration variable. You can use this extension method to distinguish sequence items with different indexes and then handle them in different ways. For example, given that `items` is an enumeration of the strings "item1", "item2", and "item3", you can use the following template to enumerate them prefixing all of them but the first one with commas.

```csharp
The items are: <<foreach [
    item in items]>><<[item.IndexOf() != 0
        ? ", "
        : ""]>><<[item]>><</foreach>>.
```

In this case, the engine produces a report as follows.

```csharp
The items are: item1, item2, item3.
```

*   `NumberOf()`

Returns the one-based index of a sequence item that is represented by the corresponding iteration variable. You can use this extension method to number sequence `items` without involving Microsoft Word® lists. For example, given the previous declaration of items, you can enumerate and number them in a document table using the following template.

| No. | Item |
| --- | --- |
| `<<foreach [item in items]>><<[item.NumberOf()]>>` | `<<[item]>><</foreach>>` |

In this case, the engine produces a report as follows.

| No. | Item |
| --- | --- |
| 1 | item1 |
| 2 | item2 |
| 3 | item3 |

### Charts Representing Sequential Data

GroupDocs.Assembly Engine enables you to use charts to represent your sequential data. To declare a chart that is going to be populated with data dynamically within your template, do the following steps:

1.  Add a chart to your template at the place where you want it to appear in a result document.
2.  Configure the appearance of the chart.
3.  Add required chart series and configure their appearance as well.
4.  Add a title to the chart, if missing.
5.  Add an opening foreach tag to the chart title.
6.  Depending on the type of the chart, add x tags to the chart title or chart series' names as follows.
  
    ```csharp
    <<x [x_value_expression]>>
    ```
    
    * For a scatter or bubble chart, you can go one of the following ways:
        - To use the same x-value expression for all chart series, add a single x tag to the chart title after the corresponding foreachtag.
        - To use different x-value expressions for every chart series, add multiple x tags to chart series' names – one for each chart series. An x-value expression for a scatter or bubble chart must return a numeric value.
    * For a chart of another type, add a single x tag to the chart title after the corresponding foreach tag. In this case, an x-value expression must return a numeric, date, or string value.
7.  For a chart of any type, add y tags to chart series' names as follows.
  
    ```csharp
    <<y [y_value_expression]>>
    ```
    
    An y-value expression must return a numeric value.
    
8.  For a bubble chart, add size tags to chart series' names as follows.
  
    ```csharp
    <<size [bubble_size_expression]>>
    ```
    
    A bubble-size expression must return a numeric value.
    
9.  For a chart with dynamic data, you can select which series to include into it dynamically based upon conditions. In particular, this feature is useful when you need to restrict access to sensitive data in chart series for some users of your application. To use the feature, do the following steps:
  
    * Declare a chart with dynamic data in the usual way
    * For series to be removed from the chart based upon conditions dynamically, define the conditions in names of these series using removeif tags having the following syntax
    
    ```csharp
    <<removeif [conditional_expression]>>
    ```
    
    A conditional expression must return a Boolean value.
    

**Note:** A closing foreach tag is not used for a chart.  
While composing expressions for x, y, and size tags, you can normally reference an iteration variable declared at the corresponding foreach tag in a chart title in the same way as if you intended to output results of expressions within a data band.

**Note:** You can normally use charts with dynamic data within data bands.  
During runtime, a chart with a foreach tag in its title is processed by the engine as follows:

1.  A sequence expression declared at the foreach tag is evaluated and iterated.
2.  For every sequence item, expressions declared at x, y, and size tags are evaluated.
3.  Results of these expressions are used to populate corresponding chart series.
4.  All foreach, x, y, and size tags are removed from the chart title and chart series' names.  
    Consider the following example. Assume that you have the Manager and Contract classes defined in your application as follows.
    
    ```csharp
    public class Manager
    {
        public String Name { get { ... } }
        public IEnumerable<Contract> Contracts { get { ... } }
        ...
    }
    
    public class Contract
    {
        public float Price { get { ... } }
        ...
    }
    ```
    
    Given that managers is an enumeration of Manager instances, you can use the following template to represent total contract prices achieved by managers in a column chart.  
    <link to the template>  
    In this case, the engine produces a report as follows.  
    <link to the report>
    

## Enumeration Extension Methods

### The Enumeration

GroupDocs.Assembly Engine enables you to perform common manipulations on a sequential data through the engine's built-in extension methods for `IEnumerable`. These extension methods mimic some extension methods of [IEnumerable<T>](http://msdn.microsoft.com/en-us/library/9eekhta0(v=vs.110).aspx) providing the same signatures and behavior features. Thus, you can group, sort, and perform other sequential data manipulations in template expressions in a familiar way.

### The Enumeration Extension

Below table describes the built-in extension methods. The following notation conventions are used within the table:

*   `Selector` stands for a lambda function returning a value and taking an enumeration item as its single argument. See [Using Lambda Functions](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/#using-lambda-functions) for more information.
*   `ComparableSelector` stands for `Selector` returning [IComparable](http://msdn.microsoft.com/en-US/library/system.icomparable(v=vs.110).aspx).
*   `Predicate` stands for `Selector` returning a Boolean value.

Examples in this table are given using `persons` and `otherPersons`, enumerations of instances of the `Person` class that is defined as follows.

```csharp
public class Person
{
    public String Name { get { ... } }
    public int Age { get { ... } }
    public IEnumerable<Person> Children { get { ... } }
    ...
}
```

| Extension Method | Examples and Notes |
| --- | --- |
| `All(Predicate)` | `persons.All(p => p.Age < 50)` |
| `Any()` | `persons.Any()` |
| `Any(Predicate)` | `persons.Any(p => p.Name == "John Smith")` |
| `Average(Selector)` | `persons.Average(p => p.Age)`<br/>The input selector must return a value of any type that has predefined or user-defined addition and division operators. |
| `Concat(IEnumerable)` | `persons.Concat(otherPersons)`<br/>An implicit reference conversion must exist between types of items of concatenated enumerations. |
| `Contains(Object)` | `persons.Contains(otherPersons.First())` |
| `Count()` | `persons.Count()` |
| `Count(Predicate)` | `persons.Count(p => p.Age > 30)` |
| `Distinct()` | `persons.Distinct()` |
| `First()` | `persons.First()` |
| `First(Predicate)` | `persons.First(p => p.Age > 30)` |
| `FirstOrDefault()` | `persons.FirstOrDefault()` |
| `FirstOrDefault(Predicate)` | `persons.FirstOrDefault(p => p.Age > 30)` |
| `GroupBy(Selector)` | `persons.GroupBy(p => p.Age)`<br/>Or<br/>`persons.GroupBy(p => new { Age = p.Age, Count = p.Children.Count() })`<br/>This method returns an enumeration of group objects. Each group has a unique key defined by the input selector and contains items of the source enumeration associated with this key. You can access the key of a group instance using the `Key` property. You can treat a group itself as an enumeration of items that the group contains. |
| `Last()` | `persons.Last()` |
| `Last(Predicate)` | `persons.Last(p => p.Age > 100)` |
| `LastOrDefault()` | `persons.LastOrDefault()` |
| `LastOrDefault(Predicate)` | `persons.LastOrDefault(p => p.Age > 100)` |
| `Max(ComparableSelector)` | `persons.Max(p => p.Age)` |
| `Min(ComparableSelector)` | `persons.Min(p => p.Age)` |
| `OrderBy(ComparableSelector)` | `persons.OrderBy(p => p.Age)`<br/>Or<br/>`persons.OrderBy(p => p.Age).ThenByDescending(p => p.Name)`<br/>Or<br/>`persons.OrderBy(p => p.Age).ThenByDescending(p => p.Name).ThenBy(p => p.Children.Count())`<br/>This method returns an enumeration ordered by a single key. To specify additional ordering keys, you can use the following extension methods of an ordered enumeration: <ul><li>`ThenBy(ComparableSelector)`</li><li>`ThenByDescending(ComparableSelector)`</li></ul> |
| `OrderByDescending(ComparableSelector)` | `persons.OrderByDescending(p => p.Age)`<br/>Or<br/>`persons.OrderByDescending(p => p.Age).ThenByDescending(p => p.Name)`<br/>Or<br/>`persons.OrderByDescending(p => p.Age).ThenByDescending(p => p.Name).ThenBy(p => p.Children.Count())`<br/>See the previous note. |
| `Single()` | `persons.Single()` |
| `Single(Predicate)` | `persons.Single(p => p.Name == "John Smith")` |
| `SingleOrDefault()` | `persons.SingleOrDefault()` |
| `SingleOrDefault(Predicate)` | `persons.SingleOrDefault(p => p.Name == "John Smith")` |
| `Skip(int)` | `persons.Skip(10)` |
| `SkipWhile(Predicate)` | `persons.SkipWhile(p => p.Age < 21)` |
| `Sum(Selector)` | `persons.Sum(p => p.Children.Count())`<br/>The input selector must return a value of any type that has a predefined or user-defined addition operator. |
| `Take(int)` | `persons.Take(5)` |
| `TakeWhile(Predicate)` | `persons.TakeWhile(p => p.Age < 50)` |
| `Union(IEnumerable)` | `persons.Union(otherPersons)`<br/>An implicit reference conversion must exist between types of items of united enumerations. |
| `Where(Predicate)` | `persons.Where(p => p.Age > 18)` |

---

## The Business Layer

Path: /assembly/java/the-business-layer/

## Common Utilities Class

### Document Directories

{{< gist atirtahirgroupdocs bf19072db4d1257130a0480116588699 >}}



### Applying Product License

{{< gist atirtahirgroupdocs 3ad8de650a7f63daaacf5563df812e21 >}}



## Data Layer Class

### Use Tables of Word Processing Documents as Data Sources

{{< gist atirtahirgroupdocs 506620fa48ff21cca531cdb291bcbf6c >}}



### Use Spreadsheets as Data Sources

{{< gist atirtahirgroupdocs ee685d2be5489fb385394aaf70199e4a >}}



### Use Tables of Presentation Documents as Data Sources

{{< gist atirtahirgroupdocs 735817ec02f2ee1364b4a1a0bb1e6559 >}}



### Data Storage Class

{{< gist atirtahirgroupdocs 1f7f56ad41d2e6608521f6f99d700ad2 >}}



## Complete Common Utilities Class

{{< gist atirtahirgroupdocs 950cc9b9fffff80fccccf1e300c25c74 >}}



---

## The Business Layer

Path: /assembly/net/the-business-layer/

## Common Utilities Class

### Document Directories

{{< gist GroupDocsGists 35d780058369139e8df19bdf0eda6318 >}}



### Applying Product License

{{< gist GroupDocsGists db63054e45146654ff4efeda01f556a2 >}}



{{< gist GroupDocsGists b74ee64e220e1158e104ff4f99413795 >}}



### Metered Licensing

{{< gist GroupDocsGists aef021477dea1aa7bf98a36298306853 >}}



## Data Layer Class

### Custom Objects

#### Populate Data (Getting Customers Details)

{{< gist GroupDocsGists 430542321e2258cf1620820b621dac2f >}}



#### Getting Order Details

{{< gist GroupDocsGists 20abd71e0610266427006d4c73c1bc2f >}}



#### Getting Product Details

{{< gist GroupDocsGists 399b4c5f20965c5cb86e9b3451dceb42 >}}



#### Getting Single Customer Details

{{< gist GroupDocsGists 218bf5db6d802d9092fb2956a73e9aa0 >}}



### Database Entities

#### Getting Customer Details From Database

{{< gist GroupDocsGists cb91080f851bdae282db17be93ee7630 >}}



#### Getting Order Details From Database

{{< gist GroupDocsGists 285d4fc7e71c27c86d28cc916300524d >}}



#### Getting Product Details From Database

{{< gist GroupDocsGists 54467d9e319f75fd7a4957b604ef70b4 >}}



#### Getting Single Customer Details From Database

{{< gist GroupDocsGists 8a4eae4adf6f14ea7b65273e7dd3f9ad >}}



### DataSet Source

#### Getting Customer, Order Details From DataSet

{{< gist GroupDocsGists bc35dfd10eacca07adcb50a6f552ceb9 >}}



#### Getting Product Details From DataSet

{{< gist GroupDocsGists 128e16bf1c84db90fc805e71a2810067 >}}



#### Getting Single Customer Details From DataSet

{{< gist GroupDocsGists 1eb2dae972104b298d6f3a8715437316 >}}



### XML DataSource

#### Getting Complete Details From XML Files

{{< gist GroupDocsGists c539937a5e8b87ee782bc3e2e9adf3c6 >}}



#### Getting Single Customer Details From XML DataSource

{{< gist GroupDocsGists 55b20020ec50e027be29df7c58f68698 >}}



### JOSN DataSource

#### Getting Customer Data From JSON File

{{< gist GroupDocsGists fc5ec5df36ed6c1b44229813fe15c96d >}}



#### Getting Customer And Order Data From JSON File

{{< gist GroupDocsGists 3825f64ba31b139fd4014580b1d0374b >}}



#### Getting Product Data From JSON File

{{< gist GroupDocsGists 20205a3ce321b83182a5aedb1b66d7fb >}}



#### Getting Single Customer Data From JSON File

{{< gist GroupDocsGists 9c3ef8a1b88ea9f5631b329eec8dc5f3 >}}



### Use Spreadsheets as Data Sources

{{< gist GroupDocsGists 4c76451b7dfddba97958ef0e094708c1 >}}



### Use Tables of Word Processing Documents as Data Sources

{{< gist GroupDocsGists b97c2e9e49a32cbcdbd76fb0e52c4a0b >}}



### Use Tables of Presentation Documents as Data Sources

{{< gist GroupDocsGists 2eb3dca4e9443ab59a93d950b39e54de >}}



## Complete DataLayer Class Code

{{< gist GroupDocsGists 482332acdf00ceb04efe08e937eadd2a >}}



## Complete DynamicEntity Class Code

{{< gist GroupDocsGists 6bf0f1e28e5614fc22133dfcb13ad883 >}}



## Complete CommonUtilities Class Code

{{< gist GroupDocsGists 58f9abe0c5b0f9141ff93b085fd37c82 >}}



---

## Save document to the specified location

Path: /watermark/net/save-document-to-the-specified-location/

Following code shows usage of [Save(string)](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/4) method.

**AdvancedUsage.SavingDocuments.SaveDocumentToTheSpecifiedLocation**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\test.doc"
using (Watermarker watermarker = new Watermarker("test.doc"))
{
    // watermarking goes here
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
    watermarker.Add(watermark);

    // Saves the document to the specified location
    watermarker.Save("test.doc");
}
```


---

## Update annotation replies

Path: /annotation/java/update-annotation-replies/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) allows you to update annotation replies by accessing them using the [Replies](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/annotationbase/#getReplies--) collection.

To update annotation replies, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Call the [get()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#get--) method of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class to get collection of the document annotations.
3.   Access desired reply object via [getReplies()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/annotationbase/#getReplies--) method collection by its index (zero-based) and update its properties as needed.
4.   Call the [update](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#update-java.util.List-com.groupdocs.annotation.models.annotationmodels.AnnotationBase--) method of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify annotations.
5.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream and the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class.
    

The following code snippet shows how to update reply by index: 

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to update annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("Original first comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Original second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation original = new AreaAnnotation();
    original.setId(1);
    original.setBackgroundColor(65535);
    original.setBox(new Rectangle(100, 100, 100, 100));
    original.setCreatedOn(Calendar.getInstance().getTime());
    original.setMessage("This is original annotation");
    original.setReplies(replies);
    
    // Add original annotation
    annotator.add(original);
    
    // Save to file
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
LoadOptions tmp0 = new LoadOptions();

// Open annotated document
Annotator annotator1 = new Annotator("outputPath", tmp0);
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("Updated first comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Updated second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Suggest we want change some properties of existed annotation
    AreaAnnotation updated = new AreaAnnotation();
    updated.setId(1);
    updated.setBackgroundColor(255);
    updated.setBox(new Rectangle(0, 0, 50, 200));
    updated.setCreatedOn(Calendar.getInstance().getTime());
    updated.setMessage("This is updated annotation");
    updated.setReplies(replies);
    
    // update annotation
    annotator1.update(updated);
    
    // Save to file
    annotator1.save(outputPath);
} finally {
    if (annotator1 != null) {
        annotator1.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Updating Image signatures with advanced options

Path: /signature/java/updating-image-signatures-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) class to manipulate image signatures location, and size over [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) object to analyze if signatures were successfully processed.

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. The [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) contains list of successfully updated signatures and ones that failed. The Image signature could be failed to update due to several reasons:

*   if signature object was initialized with constructor by incorrect signature identifier;
*   if signature object was not found;
*   there was an error occurred while updating signature in the document.

Here are the steps to update Image signature in the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [ImageSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature);    
*   Select from list [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) object(s) that should be updated;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.    
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not.
Here are the alternative steps to update Image signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) methods.
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate one or several  [ImageSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/ImageSignature) objects with signature Id(s) passed to constructor;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it;    
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not. 

The following table describes changeable properties for Image signatures dependent on document type.

| Document Type / Signature Property | Left | Top | Width | Height | Size | IsSignature |
| --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) |
| Spreadsheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Pdf | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Presentation | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Word Processing | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |

## Update Image signature in the document after Search

This example shows how to update Image signature that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
Signature signature = new Signature("sampleSigned.xlsx");
ImageSearchOptions options = new ImageSearchOptions();
// search for image signatures in document
List<ImageSignature> signatures = signature.search(ImageSignature.class,options);
List<BaseSignature> bs = new ArrayList<BaseSignature>();
// adjust signature properties
for (ImageSignature temp : signatures)
{
    // apply some condition to adjust signature properties
    temp.setLeft(temp.getLeft() + 100);
    temp.setTop(temp.getTop() + 100);
    if (temp.getSize() > 10000)
    {
        temp.setSignature(false);
    }
    bs.add(temp);
}           
    // update all found signatures
UpdateResult updateResult = signature.update("sampleSigned.xlsx", bs);
if (updateResult.getSucceeded().size() == signatures.size())
{
    System.out.print("\nAll signatures were successfully updated!");
}
else
{
    System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : "+updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Update Image signature in document by known signature Identifier

This example shows how to update Image signature in the document by known signature Id (that was obtained by  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method previously).

```java
// initialize Signature instance
Signature signature = new Signature("sampleSigned.pdf");
// read from some data source signature Id value
String[] signatureIdList = new String[]
        {
                "1dd21cf3-b904-4da9-9413-1ff1dab51974",
                "9e386726-a773-4971-b2fc-eaadfce65ffd"
        };
// create list of Barcode Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList) {
    ImageSignature temp = new ImageSignature(item);
    temp.setWidth(150);
    temp.setHeight(150);
    temp.setLeft(200);
    temp.setTop(200);
    signatures.add(temp);
}
// update all found signatures
UpdateResult updateResult = signature.update("sampleSigned.pdf", signatures);
if (updateResult.getSucceeded().size() == signatures.size()) {
    System.out.print("\nAll signatures were successfully updated!");
} else {
    System.out.print("Successfully updated signatures : " + updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : " + updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded()) {
    System.out.print("Signature# Id:" + temp.getSignatureId() + ", Location: " + temp.getLeft() + "x" + temp.getTop() + ". Size: " + temp.getWidth() + "x" + temp.getHeight());
}
```

## More resources

GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Use OCR Connector

Path: /parser/java/use-ocr-connector/

[OcrConnectorBase](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocrconnectorbase) class provides the interface to integrate any OCR solution to GroupDocs.Parser. This class has the following members:

| Member | Description |
| --- | --- |
| RecognizeText | Extracts a text from the provided image stream. It is used when [getText](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/#getText-com.groupdocs.parser.options.TextOptions-) method from Parser class is called. |
| RecognizeTextAreas | Extracts text areas from the provided image stream. It is used when [getTextAreas](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/#getTextAreas-com.groupdocs.parser.options.PageTextAreaOptions-) method from Parser class is called. |

Class with OCR integration must implement at least one of these methods (depends on the required functionality).

## Extract a text from the image

[RegognizeText](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocrconnectorbase/#recognizeText-java.io.InputStream-int-com.groupdocs.parser.options.OcrOptions-) method has the following signature: 

```C#
String recognizeText(java.io.InputStream imageStream, int pageIndex, OcrOptions options)
```

| Parameter | Description |
| --- | --- |
| imageStream | An image from which the text must be extracted. |
| pageIndex | A zero-based index of the page in the document (in the case when the image represents the document page). |
| options | Is used to define a rectangular area which restricts the area of the image and [OcrEventHandler](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocreventhandler) object to handle warnings while the text recognition. |

The following example shows how to implement text recognition by using Aspose.OCR on-premise API:

```Java
@Override
public String recognizeText(java.io.InputStream imageStream, int pageIndex, OcrOptions options) {
    try {
        // Create an instance of Aspose OCR API
        com.aspose.ocr.AsposeOCR api = new com.aspose.ocr.AsposeOCR();
        // Convert the image stream into the memory stream
        java.awt.image.BufferedImage image = ImageIO.read(imageStream);
        // Create an instance of RecognitionSettings
        com.aspose.ocr.RecognitionSettings settings = new com.aspose.ocr.RecognitionSettings();
        // Check if the rectangle is set
        if (options != null && options.getRectangle() != null) {
            ArrayList<java.awt.Rectangle> areas = new ArrayList<>();
            areas.add(new java.awt.Rectangle(
                    (int) options.getRectangle().getLeft(),
                    (int) options.getRectangle().getTop(),
                    (int) options.getRectangle().getSize().getWidth(),
                    (int) options.getRectangle().getSize().getHeight()));
            // Set recognition areas
            settings.setRecognitionAreas(areas);
        }
        // Perform the text recognition
        com.aspose.ocr.RecognitionResult result = api.RecognizePage(image, settings);
        // Check if the handler is set
        if (options != null && options.getHandler() != null) {
            // Send all recognition warnings
            options.getHandler().onWarnings(pageIndex, result.warnings);
        }
        // Return a recognized text
        return result.recognitionText;
    } catch (java.lang.Exception ex) {
        return null;
    }
}
```

## Extract text areas from the image

[RecognizeTextAreas](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocrconnectorbase/#recognizeTextAreas-java.io.InputStream-int-com.groupdocs.parser.data.Size-com.groupdocs.parser.options.OcrOptions-) method has the following signature:

```C#
IList<PageTextArea> RecognizeTextAreas(Stream imageStream, int pageIndex, Size pageSize, OcrOptions options)
```

| Parameter | Description |
| --- | --- |
| imageStream | An image from which the text must be extracted. |
| pageIndex | A zero-based index of the page in the document (in the case when the image represents the document page). |
| pageSize | A size of the image (in the case when the image represents the document page - the size of the page). |
| options | Is used to define a rectangular area which restricts the area of the image and [OcrEventHandler](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ocreventhandler) object to handle warnings while the text recognition. |

The following example shows how to implement text areas recognition by using Aspose.OCR on-premise API:

```Java
@Override
public java.lang.Iterable<PageTextArea> recognizeTextAreas(java.io.InputStream imageStream, int pageIndex, Size pageSize, OcrOptions options) {
    try {
        // Create an instance of Aspose OCR API
        com.aspose.ocr.AsposeOCR api = new com.aspose.ocr.AsposeOCR();
        // Convert the image stream into the memory stream
        java.awt.image.BufferedImage image = ImageIO.read(imageStream);
        // Create an instance of RecognitionSettings
        com.aspose.ocr.RecognitionSettings settings = new com.aspose.ocr.RecognitionSettings();
        settings.setDetectAreas(true);
        // Check if the rectangle is set
        if (options != null && options.getRectangle() != null) {
            ArrayList<java.awt.Rectangle> areas = new ArrayList<>();
            areas.add(new java.awt.Rectangle(
                    (int) options.getRectangle().getLeft(),
                    (int) options.getRectangle().getTop(),
                    (int) options.getRectangle().getSize().getWidth(),
                    (int) options.getRectangle().getSize().getHeight()));
            // Set recognition areas
            settings.setRecognitionAreas(areas);
        }
        // Perform the text recognition
        com.aspose.ocr.RecognitionResult result = api.RecognizePage(image, settings);
        // Check if the handler is set
        if (options != null && options.getHandler() != null) {
            // Send all recognition warnings
            options.getHandler().onWarnings(pageIndex, result.warnings);
        }
        // Create a page object. The pageIndex parameter represents the page index of the document; for images it's always zero.
        Page page = new Page(pageIndex, pageSize);
        // Combine rectangle and text collections to produce PageTextArea collection
        ArrayList<PageTextArea> areas = new ArrayList<>();
        for(int i=0; i <result.recognitionAreasRectangles.size(); i++) {
            java.awt.Rectangle rect = result.recognitionAreasRectangles.get(i);
            String text = result.recognitionText;
            areas.add(new PageTextArea(text, page, new Rectangle(
                    new Point(rect.getX(), rect.getY()), new Size(rect.getWidth(), rect.getHeight()))));
        }
        return areas;
    } catch (java.lang.Exception ex) {
        return null;
    }
}
```
---

## Use OCR Connector

Path: /parser/net/use-ocr-connector/

GroupDocs.Parser includes built-in OCR functionality that provides text recognition from images and scanned PDFs. This built-in OCR is included with the library and requires no additional packages or setup for basic use—you just need to explicitly request OCR when extracting text or parsing a document. For image files, OCR is automatically applied during text extraction.

{{< alert style="info" >}}
**Note:** The built-in OCR supports languages represented by [Language](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/language/) class and is suitable for most basic text recognition scenarios. For advanced OCR needs, multiple languages, or higher accuracy requirements, you can integrate optional third-party OCR solutions using the connector mechanism described below.
{{< /alert >}}

If the capabilities of the built-in OCR are not sufficient, you can use the mechanism to connect a third-party OCR. To do this, you need to write your own OCR connector and pass it when creating the Parser class:

* Instantiate [ParserSettings](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/parsersettings) object with the instance of class that implements OCR functionality;
* Instantiate [Parser](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/) object with [ParserSettings](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/parsersettings) object.

The following example shows how to create an instance of [Parser](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/) class with the custom connector:

```C#
// Create an instance of ParserSettings class with the custom ocr connector
ParserSettings settings = new ParserSettings(new YourCustomOcrConnector());
// Create an instance of Parser class with the parser settings
Parser parser = new Parser(fileName, settins);
```

All OCR connectors inherit from the base class [OcrConnectorBase](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocrconnectorbase/) (including the built-in one in the parser). This class contains two properties and three methods:

```C#
public abstract class OcrConnectorBase
{
    public virtual bool IsTextSupported { get; }

    public virtual bool IsTextAreasSupported { get; }

    public virtual string RecognizeText(Stream imageStream, OcrOptions options);

    public virtual IList<PageTextArea> RecognizeTextAreas(Stream imageStream, Page page, OcrOptions options);

    public virtual IList<PageTextArea> RecognizeTextAreas(Stream imageStream, IEnumerable<Rectangle> rectangles, string allowedSymbols, Page page, OcrOptions options);
}
```

Parser separates text recognition into two independent workflows: plain text and text areas. The first one handles extracting text from a document, which can be obtained, for example, via Parser.GetText. Text areas are used in the template-based parsing functionality. These two workflows are independent of each other, and when creating a custom connector, you only need to implement the required functionality.

The IsTextSupported property answers the question: Can the connector extract plain text? If it returns false, there's no need to override the RecognizeText method, as Parser won't call it and will immediately return null when text is requested.

If this property returns true, then you need to implement the RecognizeText method. It takes two parameters: a stream with the image (imageStream) and OCR settings (options).

The OCR settings are represented by the [OcrOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions/) class and may include:

* [OcrEventHandler](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions/handler) for sending messages that occur during document processing.
* A [rectangular area](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions/rectangle) of the image from which text needs to be extracted; in this case, there's no need to extract text from the entire image, limiting it to the specified area.
* A [flag](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions/usespellchecker) for using spell checking (if supported by the OCR).

The IsTextAreasSupported property answers the question: Can the connector extract text areas? Text areas are rectangles on a page that contain text. Typically, these areas represent individual words (this assumption is the basis for the template-based parsing functionality). If the property returns false, it means this functionality is not supported, and no further action is required.

If this property returns true, then you need to implement the RecognizeTextAreas methods. In addition to the image and OCR settings, these methods receive the [document's page class](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/page) and, in a more advanced version, a list of rectangular areas to recognize and a list of allowed characters.

Both methods should return a collection of [PageTextArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagetextarea) objects. These objects contain the document's page, the text, and the rectangular area on the page where the text was found. You can pass the page parameter as the page.

The coordinates of the rectangles are calculated based on the Rectangle value from [OcrOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/ocroptions). This means that if the rectangle from the OCR settings has the top-left corner at (10; 10), and the text on the page has coordinates (12; 15), then you should return (2; 5). In other words, the image is first cropped to the rectangle, and then OCR is performed.

It's important to note that these two methods are independent, and you need to implement both of them.

The list of rectangular areas specifies the coordinates within the already cropped image from which text needs to be extracted. This functionality is used in template-based parsing for simple fields—the user defines a field using a rectangle. The list of these rectangles is then sent to the connector to extract text data based on these coordinates.

The list of allowed characters is a string containing the characters that Parser expects to see in these areas. This can be used, for example, to extract only digits (if there is ambiguity between "O" and "0," the system will favor the latter) or to explicitly define decimal separators (e.g., specifying a dot instead of a comma) and so on. Currently, this functionality is not supported, and the parameter has been added for potential expansion in future releases.
---

## Use PDF redaction filters

Path: /redaction/java/use-pdf-redaction-filters/


You can combine **PageRangeFilter** and **PageAreaFilter** filters in one set in order to set the scope of redaction to an area on a specific page. You have to set an array of instances to **Filters** property of the **ReplacementOptions**. 

The following example demonstrates how to apply redaction to the bottom half of the last page in a PDF document.

```java
        final Redactor redactor = new Redactor("Sample.pdf");
        try 
        {
            // Get the actual size information for the last page:
            IDocumentInfo info = redactor.getDocumentInfo();
            PageInfo lastPage = info.getPages().get(info.getPageCount() - 1);
            ReplacementOptions options = new ReplacementOptions("[secret]");
            options.setFilters(new RedactionFilter[] {
                new PageRangeFilter(PageSeekOrigin.End, 0, 1),
                new PageAreaFilter(new java.awt.Point(0, lastPage.getHeight()/2),
                    new java.awt.Dimension(lastPage.getWidth(), lastPage.getHeight()/2))
            });
            RedactorChangeLog result = redactor.apply(new ExactPhraseRedaction("bibliography", false, options));
            if (result.getStatus() != RedactionStatus.Failed)
            {
                redactor.save();
            }                            
        }
        finally { redactor.close(); }
```


---

## Use PDF redaction filters

Path: /redaction/net/use-pdf-redaction-filters/


You can combine [PageRangeFilter](https://reference.groupdocs.com/redaction/net/groupdocs.redaction.redactions/pagerangefilter/) and [PageAreaFilter](https://reference.groupdocs.com/redaction/net/groupdocs.redaction.redactions/pageareafilter/) filters in one set in order to set the scope of redaction to an area on a specific page. You have to set an array of instances to **Filters** property of the [ReplacementOptions](https://reference.groupdocs.com/redaction/net/groupdocs.redaction.redactions/replacementoptions/). 

The following example demonstrates how to apply redaction to the bottom half of the last page in a PDF document.

**C#**

```csharp
using (Redactor redactor = new Redactor("Sample.pdf"))
{
    // Get the actual size information for the last page:
    IDocumentInfo info = redactor.GetDocumentInfo();
    PageInfo lastPage = info.Pages[info.PageCount - 1];
    ReplacementOptions options = new Redactions.ReplacementOptions("[secret]");
    options.Filters = new RedactionFilter[] {
        new PageRangeFilter(PageSeekOrigin.End, 0, 1),
        new PageAreaFilter(new System.Drawing.Point(0, lastPage.Height/2),
            new System.Drawing.Size(lastPage.Width, lastPage.Height/2))
    };
    RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("sample", false, options));
    if (result.Status != RedactionStatus.Failed)
    {
        redactor.Save();
    };
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use PDF redaction filters

Path: /redaction/python-net/use-pdf-redaction-filters/


You can combine [PageRangeFilter](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/pagerangefilter/) and [PageAreaFilter](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/pageareafilter/) filters in one set in order to set the scope of redaction to an area on a specific page. You have to set an array of instances to **Filters** property of the [ReplacementOptions](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/replacementoptions/). 

The following example demonstrates how to apply redaction to the bottom half of the last page in a PDF document.

**Python**

```python
using (Redactor redactor = new Redactor("Sample.pdf"))
{
    // Get the actual size information for the last page:
    IDocumentInfo info = redactor.GetDocumentInfo();
    PageInfo lastPage = info.Pages[info.PageCount - 1];
    ReplacementOptions options = new Redactions.ReplacementOptions("[secret]");
    options.Filters = new RedactionFilter[] {
        new PageRangeFilter(PageSeekOrigin.End, 0, 1),
        new PageAreaFilter(new System.Drawing.Point(0, lastPage.Height/2),
            new System.Drawing.Size(lastPage.Width, lastPage.Height/2))
    };
    RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("sample", false, options));
    if (result.Status != RedactionStatus.Failed)
    {
        redactor.Save();
    };
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Using Tables of Presentation Documents as Data Sources

Path: /assembly/java/using-tables-of-presentation-documents-as-data-sources/

Following classes are added in **GroupDocs.Assembly.Data** namespace:

*   [DataTable](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataTable "class in com.groupdocs.assembly.system.data")
*   [DataColumn](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataColumn "class in com.groupdocs.assembly.system.data")
*   [DataColumnCollection](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataColumnCollection "class in com.groupdocs.assembly.system.data")

## The Recipe

*   Define template and output report documents
*   Assemble a document using the external document table as a data source

### Download

#### Data Source Document

*   [Managers Data.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Presentation%20DataSource/Managers%20Data.pptx?raw=true)

#### Template

*   [Using Presentation as Table of Data.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Using%20Presentation%20as%20Table%20of%20Data.pptx?raw=true)

## The Code

{{< gist GroupDocsGists 943b2d4cff184ca6294109f2db044ac0 >}}



---

## Using Tables of Presentation Documents as Data Sources

Path: /assembly/net/using-tables-of-presentation-documents-as-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 16.12.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Using Tables of Presentation Documents as Data Sources

Following classes are added in **[GroupDocs.Assembly.Data](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/)** namespace:

*   [DocumentTable](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttable)
*   [DocumentTableColumn](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecolumn)
*   [DocumentTableColumnCollection](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecolumncollection)
*   [DocumentTableOptions](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttableoptions)

## The Recipe

*   Define template and output report documents
*   Assemble a document using the external document table as a data source

### Download

#### Data Source Document

*   [Managers Data.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Presentation%20DataSource/Managers%20Data.pptx?raw=true)

#### Template

*   [Using Presentation as Table of Data.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Using%20Presentation%20as%20Table%20of%20Data.pptx?raw=true)

## The Code

{{< gist GroupDocsGists b69cdd70c2f91362b2c6fdddd7bea8a5 >}}



---

## Verify QR-code signatures

Path: /signature/java/verify-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides different properties in [QrCodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/QrCodeVerifyOptions) class to specify verification of QR-code signatures.

Here are the steps to verify qr-code signature within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the  [QrCodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/QrCodeVerifyOptions)  object according to your requirements and specify verification options      
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/QrCodeVerifyOptions) to it.  
*   Analyze [VerificationResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/VerificationResult) result if needed.

  
This example shows how to verify QR-code signature in the document. See [VerificationResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/VerificationResult)  

```java
Signature signature = new Signature("sample.pdf");
// create QRCode option with predefined QRCode text
QrCodeVerifyOptions options = new QrCodeVerifyOptions();
 
// specify if all pages shoudl be verified
options.setAllPages(false);
PagesSetup pagesSetup = new PagesSetup();
pagesSetup.setFirstPage(false);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(true);
options.setPagesSetup(pagesSetup);
// specify text pattern
options.setText("John");
// specify verification text pattern
options.setMatchType(TextMatchType.Contains);
// specify types of QR code to verify
options.setEncodeType(QrCodeTypes.QR);
 
// sign document to file
VerificationResult result = signature.verify(options);
if (result.isValid()) {
    System.out.print("\nDocument was verified successfully!");
} else {
    System.out.print("\nDocument failed verification process.");
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verifying QR Code signatures in advance

Path: /signature/net/verify-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides different properties in [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodeverifyoptions) class to specify verification of QR Code signatures.

Here are the steps to verify QR Code signature within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
*Instantiate the  [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodeverifyoptions) object according to your requirements and specify verification options  
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodeverifyoptions) to it.  
* Analyze [VerificationResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/verificationresult) result if needed.
  
This example shows how to verify QR Code signature in the document. See [VerificationResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/verificationresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    QrCodeVerifyOptions options = new QrCodeVerifyOptions()
    {
        // specify if all pages should be verified
        AllPages = false,
        PagesSetup = new PagesSetup() {  FirstPage = false, LastPage = true, OddPages = false, EvenPages = true },
        // specify text pattern
        Text = "John",
        // specify verification text pattern
        MatchType = TextMatchType.Contains,
        // specify types of QR code to verify
        EncodeType = QrCodeTypes.QR
    };
    // verify document signatures
    VerificationResult result = signature.Verify(options);
    if (result.IsValid)
    {
        Console.WriteLine("\nDocument was verified successfully!");
    }
    else
    {
        Console.WriteLine("\nDocument failed verification process.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.


---

## Watermarks in Word document

Path: /watermark/java/watermarks-in-word-document/

When adding watermark in Microsoft Word application, it places a shape with appropriate content in section headers. GroupDocs.Watermark API uses the same approach. When calling [add()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#add(com.groupdocs.watermark.Watermark)) method of [Watermarker](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker) class, the shape is added to a document.

## Using properties of [WordProcessingWatermarkBaseOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkBaseOptions)

You can also set some additional options ([setName()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkBaseOptions#setName(java.lang.String)) or [setAlternativeText()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingWatermarkBaseOptions#setAlternativeText(java.lang.String))) when adding shape watermark to a Word document using GroupDocs.Watermark. Following code samples demonstrates it.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingAddWatermarkWithShapeSettings**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 19));                      
                                                                                                           
//Some settings for watermark                                                                              
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                  
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                              
watermark.setRotateAngle(25.0);                                                                            
watermark.setForegroundColor(Color.getRed());                                                              
watermark.setOpacity(1.0);                                                                                 
                                                                                                           
WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();               
                                                                                                           
// Set the shape name                                                                                      
options.setName("Shape 1");                                                                                
                                                                                                           
// Set the descriptive (alternative) text that will be associated with the shape                           
options.setAlternativeText("Test watermark");                                                              
                                                                                                           
watermarker.add(watermark, options);                                                                       
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Using [WordProcessingTextEffects](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingTextEffects)

You can also apply some text effects to the shape watermarks as shown in the below code.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingAddWatermarkWithTextEffects**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 19));                      
                                                                                                           
WordProcessingTextEffects effects = new WordProcessingTextEffects();                                       
effects.getLineFormat().setEnabled(true);                                                                  
effects.getLineFormat().setColor(Color.getRed());                                                          
effects.getLineFormat().setDashStyle(OfficeDashStyle.DashDotDot);                                          
effects.getLineFormat().setLineStyle(OfficeLineStyle.Triple);                                              
effects.getLineFormat().setWeight(1);                                                                      
                                                                                                           
WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();               
options.setEffects(effects);                                                                               
                                                                                                           
watermarker.add(watermark, options);                                                                       
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Using [WordProcessingImageEffects](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingImageEffects)

GroupDocs.Watermark also provides the facility to apply image effects to the shape watermarks.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingAddWatermarkWithImageEffects**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
ImageWatermark watermark = new ImageWatermark("logo.png");                                          
                                                                                                           
WordProcessingImageEffects effects = new WordProcessingImageEffects();                                     
effects.setBrightness(0.7);                                                                                
effects.setContrast(0.6);                                                                                  
effects.setChromaKey(Color.getRed());                                                                      
effects.getBorderLineFormat().setEnabled(true);                                                            
effects.getBorderLineFormat().setWeight(1);                                                                
                                                                                                           
WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();               
options.setEffects(effects);                                                                               
                                                                                                           
watermarker.add(watermark, options);                                                                       
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```


---

## Working with spreadsheet document attachments

Path: /watermark/net/working-with-spreadsheet-document-attachments/

## Extract all attachments from excel document

GroupDocs.Watermark API allows you to extract [attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetworksheet/properties/attachments) in Excel document. Following code performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetExtractAllAttachments**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        foreach (SpreadsheetAttachment attachment in worksheet.Attachments)
        {
            Console.WriteLine("Alternative text: {0}", attachment.AlternativeText);
            Console.WriteLine("Attachment frame x-coordinate: {0}", attachment.X);
            Console.WriteLine("Attachment frame y-coordinate: {0}", attachment.Y);
            Console.WriteLine("Attachment frame width: {0}", attachment.Width);
            Console.WriteLine("Attachment frame height: {0}", attachment.Height);
            Console.WriteLine("Preview image size: {0}", attachment.PreviewImageContent != null 
                ? attachment.PreviewImageContent.Length : 0);
            if (attachment.IsLink)
            {
                // The document contains only a link to the attached file
                Console.WriteLine("Full path to the attached file: {0}", attachment.SourceFullName);
            }
            else
            {
                // The attached file is stored in the document
                Console.WriteLine("File type: {0}", attachment.GetDocumentInfo().FileType);
                Console.WriteLine("Name of the source file: {0}", attachment.SourceFullName);
                Console.WriteLine("File size: {0}", attachment.Content.Length);
            }
        }
    }
```

## Add an attachment to excel document

 GroupDocs.Watermark API allows you to [add attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetattachmentcollection/methods/addattachment) in Excel document. Following code performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetAddAttachment**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    SpreadsheetWorksheet worksheet = content.Worksheets[0];
    // Add the attachment
    worksheet.Attachments.AddAttachment(File.ReadAllBytes("document.docx"), // File content
        "sample document.docx", // Source file full name (the extension is used
        // to determine appropriate application to open
        // the file) 
        File.ReadAllBytes("document_preview.png"), // Preview image content
        50, // X-coordinate of the attachment frame
        100, // Y-coordinate of the attachment frame
        200, // Attachment frame width
        400); // Attachment frame height

    // Save changes
    watermarker.Save("spreadsheet.xlsx");
}
```

## Add linked attachment to excel document

 GroupDocs.Watermark API allows you to [add linked attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetattachmentcollection/methods/addlink) in Excel document. Following code performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetAddLinkedAttachment**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    SpreadsheetWorksheet worksheet = content.Worksheets[0];

    // Add the attachment
    worksheet.Attachments.AddLink("document.docx", // Source file path
        File.ReadAllBytes("document_preview.png"), // Preview image content
        50, // X-coordinate of the attachment frame
        100, // Y-coordinate of the attachment frame
        200, // Attachment frame width
        400); // Attachment frame height
        
    // Save changes
    watermarker.Save("spreadsheet.xlsx");
}
```

## Remove attachment from excel document

GroupDocs.Watermark API allows you to remove [attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetattachmentcollection) in Excel document. Following code performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetRemoveAttachment**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        for (int i = worksheet.Attachments.Count - 1; i >= 0; i--)
        {
            SpreadsheetAttachment attachment = worksheet.Attachments[i];
            if (attachment.IsLink &&
                !File.Exists(attachment.SourceFullName) || // Linked file that is not available at this moment
                attachment.GetDocumentInfo().IsEncrypted) // Attached file protected with a password
            {
                // Remove the file if it meets at least one of the conditions above
                worksheet.Attachments.RemoveAt(i);
            }
        }
    }

    // Save changes
    watermarker.Save("spreadsheet.xlsx");
}
```

## Add watermark to all attachments  

GroupDocs.Watermark API allows you to add watermark to all [attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetattachmentcollection) in Excel document. Following code performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetAddWatermarkToAttachment**

```csharp
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 19));
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        foreach (SpreadsheetAttachment attachment in worksheet.Attachments)
        {
            // Check if the attached file is supported by GroupDocs.Watermark
            IDocumentInfo info = attachment.GetDocumentInfo();
            if (info.FileType != FileType.Unknown && !info.IsEncrypted)
            {
                // Load the attached document
                using (Watermarker attachedWatermarker = attachment.CreateWatermarker())
                {
                    // Add wateramrk
                    attachedWatermarker.Add(watermark);

                    // Save changes in the attached file
                    attachedWatermarker.Save();
                }
            }
        }
    }

    // Save changes
    watermarker.Save("spreadsheet.xlsx");
}
```

## Search for images in attached files

GroupDocs.Watermark API allows you to search for all the [images and watermarkable attachments](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.objects/spreadsheetsearchableobjects) in Excel document. Following code performs this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetSearchImageInAttachment**

```csharp
// Consider only the attached images
WatermarkerSettings settings = new WatermarkerSettings();
settings.SearchableObjects.SpreadsheetSearchableObjects = SpreadsheetSearchableObjects.AttachedImages;

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions, settings))
{
    // Specify sample image to compare document images with
    ImageSearchCriteria criteria = new ImageDctHashSearchCriteria("attachment.png");

    // Search for similar images
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(criteria);

    // Remove or modify found image watermarks
    // ...

    Console.WriteLine("Found {0} possible watermark(s).", possibleWatermarks.Count);
}
```

---

## Working with spreadsheet document attachments

Path: /watermark/python-net/working-with-spreadsheet-document-attachments/


## Extract all attachments from Excel document
This sample walks worksheets and lists metadata for each attachment, including placement, preview image size, and file details.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        for attachment in worksheet.attachments:
            print("Alternative text:", attachment.alternative_text)
            print("Attachment frame x-coordinate:", attachment.x)
            print("Attachment frame y-coordinate:", attachment.y)
            print("Attachment frame width:", attachment.width)
            print("Attachment frame height:", attachment.height)
            print("Preview image size:", len(attachment.preview_image_content) if attachment.preview_image_content else 0)
            if attachment.is_link:
                print("Full path to the attached file:", attachment.source_full_name)
            else:
                info = attachment.get_document_info()
                print("File type:", info.file_type)
                print("Name of the source file:", attachment.source_full_name)
                print("File size:", len(attachment.content))
```

## Add an attachment to Excel document
This sample embeds a file into a worksheet with a preview image and frame coordinates/sizes.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    worksheet = content.worksheets[0]
    with open("document.docx", "rb") as f_doc, open("document_preview.png", "rb") as f_prev:
        worksheet.attachments.add_attachment(
            f_doc.read(),
            "sample document.docx",
            f_prev.read(),
            50,
            100,
            200,
            400,
        )
    watermarker.save("spreadsheet.xlsx")
```

## Add linked attachment to Excel document
This sample adds a link to an external file with a preview image and placement settings.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    worksheet = content.worksheets[0]
    with open("document_preview.png", "rb") as f_prev:
        worksheet.attachments.add_link(
            "document.docx",
            f_prev.read(),
            50,
            100,
            200,
            400,
        )
    watermarker.save("spreadsheet.xlsx")
```

## Remove attachment from Excel document
This sample removes attachments based on conditions (e.g., broken link paths or encrypted files).

```python
import os
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        for i in range(worksheet.attachments.count - 1, -1, -1):
            attachment = worksheet.attachments[i]
            if (attachment.is_link and not os.path.exists(attachment.source_full_name)) or \
               attachment.get_document_info().is_encrypted:
                worksheet.attachments.remove_at(i)
    watermarker.save("spreadsheet.xlsx")
```

## Add watermark to all attachments
This sample opens each non-encrypted attached file and applies a text watermark in-place.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls
import groupdocs.watermark.watermarks as gww
from groupdocs.watermark.common import FileType

watermark = gww.TextWatermark("Test watermark", gww.Font("Arial", 19.0))

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        for attachment in worksheet.attachments:
            info = attachment.get_document_info()
            if info.file_type != FileType.UNKNOWN and not info.is_encrypted:
                with attachment.create_watermarker() as attached_watermarker:
                    attached_watermarker.add(watermark)
                    attached_watermarker.save()
    watermarker.save("spreadsheet.xlsx")
```

## Search for images in attached files
This sample searches inside attached files for image watermarks using DCT hash matching and reports findings.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.objects as gws_objs
import groupdocs.watermark.search.searchcriteria as gws_sc

settings = gw.WatermarkerSettings()
settings.searchable_objects.spreadsheet_searchable_objects = gws_objs.SpreadsheetSearchableObjects.ATTACHED_IMAGES

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options, settings) as watermarker:
    criteria = gws_sc.ImageDctHashSearchCriteria("attachment.png")
    possible = watermarker.search(criteria)
    print("Found", possible.count, "possible watermark(s).")
```



---

## Working with BMP metadata

Path: /metadata/java/working-with-bmp-metadata/

## Reading BMP header properties

The GroupDocs.Metadata API supports extracting format-specific information from BMP file headers.

The following are the steps to read the header of a BMP file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a BMP image
2.  Get the root metadata package
3.  Extract  the native metadata package using the [BmpRootPackage.getBmpHeader](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/BmpRootPackage#getBmpHeader()) method
4.  Read the BMP header properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.bmp.BmpReadHeaderProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputBmp)) {
	BmpRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getBmpHeader().getBitsPerPixel());
	System.out.println(root.getBmpHeader().getColorsImportant());
	System.out.println(root.getBmpHeader().getHeaderSize());
	System.out.println(root.getBmpHeader().getImageSize());
	System.out.println(root.getBmpHeader().getPlanes());
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with BMP metadata

Path: /metadata/net/working-with-bmp-metadata/

## Reading BMP header properties

The GroupDocs.Metadata API supports extracting format-specific information from BMP file headers.

The following are the steps to read the header of a BMP file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a BMP image
2.  Get the root metadata package
3.  Extract  the native metadata package using [BmpRootPackage.BmpHeader](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/bmprootpackage/properties/bmpheader)
4.  Read the BMP header properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Bmp.BmpReadHeaderProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputBmp))
{
	var root = metadata.GetRootPackage<BmpRootPackage>();

	Console.WriteLine(root.BmpHeader.BitsPerPixel);
	Console.WriteLine(root.BmpHeader.ColorsImportant);
	Console.WriteLine(root.BmpHeader.HeaderSize);
	Console.WriteLine(root.BmpHeader.ImageSize);
	Console.WriteLine(root.BmpHeader.Planes);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with CAD metadata

Path: /metadata/java/working-with-cad-metadata/

The GroupDocs Metadata API provides the feature to read basic metadata in CAD files. The supported CAD formats are:

*   DWG
*   DXF

## Reading CAD metadata

To access metadata in a CAD drawing, the GroupDocs.Metadata API provides the [CadRootPackage.getCadPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/CadRootPackage#getCadPackage()) method.

The following code snippet reads metadata associated with a CAD file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>cad.CadReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDxf)) {
	CadRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getCadPackage().getAcadVersion());
	System.out.println(root.getCadPackage().getAuthor());
	System.out.println(root.getCadPackage().getComments());
	System.out.println(root.getCadPackage().getCreatedDateTime());
	System.out.println(root.getCadPackage().getHyperlinkBase());
	System.out.println(root.getCadPackage().getKeywords());
	System.out.println(root.getCadPackage().getLastSavedBy());
	System.out.println(root.getCadPackage().getTitle());

	// ...
}
```

## Updating DXF metadata

The GroupDocs.Metadata API also allows updating metadata properties in a DXF drawing. Please check the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>cad.DxfUpdateNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDxf)) {
 
    CadRootPackage root = metadata.getRootPackageGeneric();
 
    root.getCadPackage().setProperties(new WithNameSpecification("Author"), new PropertyValue("GroupDocs"));
    root.getCadPackage().setProperties(new WithNameSpecification("Comments"), new PropertyValue("test comment"));
    root.getCadPackage().setProperties(new WithNameSpecification("HyperlinkBase"), new PropertyValue("test hyperlink base"));
    root.getCadPackage().setProperties(new WithNameSpecification("Keywords"), new PropertyValue("test keywords"));
    root.getCadPackage().setProperties(new WithNameSpecification("LastSavedBy"), new PropertyValue("test editor"));
    root.getCadPackage().setProperties(new WithNameSpecification("RevisionNumber"), new PropertyValue("test revision number"));
    root.getCadPackage().setProperties(new WithNameSpecification("Subject"), new PropertyValue("test subject"));
    root.getCadPackage().setProperties(new WithNameSpecification("Title"), new PropertyValue("test title"));
    root.getCadPackage().setProperties(new WithNameSpecification("CreatedDateTime"), new PropertyValue(new Date()));
    root.getCadPackage().setProperties(new WithNameSpecification("ModifiedDateTime"), new PropertyValue(new Date()));
 
    metadata.save(Constants.OutputDxf);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with CAD metadata

Path: /metadata/net/working-with-cad-metadata/

The GroupDocs Metadata API provides the feature to read basic metadata in CAD files. The supported CAD formats are:

*   DWG
*   DXF

## Reading CAD metadata

To access metadata in a CAD drawing, the GroupDocs.Metadata API provides the [CadRootPackage.CadPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.cad/cadrootpackage/properties/cadpackage) property.

The following code snippet reads metadata associated with a CAD file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Cad.CadReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDxf))
{
	var root = metadata.GetRootPackage<CadRootPackage>();

	Console.WriteLine(root.CadPackage.AcadVersion);
	Console.WriteLine(root.CadPackage.Author);
	Console.WriteLine(root.CadPackage.Comments);
	Console.WriteLine(root.CadPackage.CreatedDateTime);
	Console.WriteLine(root.CadPackage.HyperlinkBase);
	Console.WriteLine(root.CadPackage.Keywords);
	Console.WriteLine(root.CadPackage.LastSavedBy);
	Console.WriteLine(root.CadPackage.Title);

	// ...
}
```

## Updating DXF metadata

The GroupDocs.Metadata API also allows updating metadata properties in a DXF drawing. Please check the code sample below.

```csharp
using (Metadata metadata = new Metadata(Constants.InputDxf))
{
    var root = metadata.GetRootPackage<CadRootPackage>();
 
    root.CadPackage.SetProperties(p => p.Name == "Author", new PropertyValue("GroupDocs"));
    root.CadPackage.SetProperties(p => p.Name == "Comments", new PropertyValue("test comment"));
    root.CadPackage.SetProperties(p => p.Name == "HyperlinkBase", new PropertyValue("test hyperlink base"));
    root.CadPackage.SetProperties(p => p.Name == "Keywords", new PropertyValue("test keywords"));
    root.CadPackage.SetProperties(p => p.Name == "LastSavedBy", new PropertyValue("test editor"));
    root.CadPackage.SetProperties(p => p.Name == "RevisionNumber", new PropertyValue("test revision number"));
    root.CadPackage.SetProperties(p => p.Name == "Subject", new PropertyValue("test subject"));
    root.CadPackage.SetProperties(p => p.Name == "Title", new PropertyValue("test title"));
    root.CadPackage.SetProperties(p => p.Name == "CreatedDateTime", new PropertyValue(DateTime.Now.AddDays(-1)));
    root.CadPackage.SetProperties(p => p.Name == "ModifiedDateTime", new PropertyValue(DateTime.Now));
 
    metadata.Save(Constants.OutputDxf);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with IPTC IIM metadata

Path: /metadata/java/working-with-iptc-iim-metadata/

## What is IPTC IIM?

The IPTC Information Interchange Model (IIM) is a set of metadata properties that can be applied to text, images, and other media types. The standard also defines a complex data structure that is utilized to store the properties. The IPTC IIM was developed by the International Press Telecommunications Council (IPTC) to expedite the international exchange of news among newspapers and news agencies. But nowadays it's commonly used by amateur and commercial photographers. The standard is supported by many image creation and manipulation programs. IPTC IIM metadata can be embedded into a variety of image formats such as JPEG, TIFF, etc.

{{< alert style="info" >}}For more information on the IPTC IIM standard please refer to https://www.iptc.org/std/IIM/4.2/specification/IIMV4.2.pdf.{{< /alert >}}

## Reading basic IPTC IIM properties

To access IPTC metadata in a file of any supported format, GroupDocs.Metadata provides the [IIptc.getIptcPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IIptc#getIptcPackage()) method. The following are the steps to read IPTC metadata:

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.getIptcPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IIptc#getIptcPackage()) method
3.  Read properties of the [IptcApplicationRecord](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IptcApplicationRecord) and [IptcEnvelopeRecord](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IptcEnvelopeRecord) class instances

The following code snippet gets IPTC properties of a JPEG image and displays them on the screen. 

**advanced\_usage.working\_with\_metadata\_standards.iptc.ReadBasicIptcProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.JpegWithIptc)) {
	IIptc root = (IIptc) metadata.getRootPackage();
	if (root.getIptcPackage() != null) {
		if (root.getIptcPackage().getEnvelopeRecord() != null) {
			System.out.println(root.getIptcPackage().getEnvelopeRecord().getDateSent());
			System.out.println(root.getIptcPackage().getEnvelopeRecord().getDestination());
			System.out.println(root.getIptcPackage().getEnvelopeRecord().getFileFormat());
			System.out.println(root.getIptcPackage().getEnvelopeRecord().getFileFormatVersion());

			// ...
		}
		if (root.getIptcPackage().getApplicationRecord() != null) {
			System.out.println(root.getIptcPackage().getApplicationRecord().getHeadline());
			System.out.println(root.getIptcPackage().getApplicationRecord().getByLine());
			System.out.println(root.getIptcPackage().getApplicationRecord().getByLineTitle());
			System.out.println(root.getIptcPackage().getApplicationRecord().getCaptionAbstract());
			System.out.println(root.getIptcPackage().getApplicationRecord().getCity());
			System.out.println(root.getIptcPackage().getApplicationRecord().getDateCreated());
			System.out.println(root.getIptcPackage().getApplicationRecord().getReleaseDate());

			// ...
		}
	}
}
```

## Reading all IPTC IIM datasets

In some cases, it's necessary to read all IPTC datasets (metadata properties) from a file, including custom ones. To achieve this the GroupDocs.Metadata API provides direct access to the IPTC datasets extracted from a file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.getIptcPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IIptc#getIptcPackage()) method
3.  Iterate through all IPTC datasets

**advanced\_usage.working\_with\_metadata\_standards.iptc.ReadIptcDataSets**

```java
try (Metadata metadata = new Metadata(Constants.PsdWithIptc)) {
    IIptc root = (IIptc) metadata.getRootPackage();
    if (root.getIptcPackage() != null) {
        for (IptcDataSet dataSet : root.getIptcPackage().toDataSetList()) {
            System.out.println(dataSet.getRecordNumber());
            System.out.println(dataSet.getDataSetNumber());
            System.out.println(dataSet.getAlternativeName());
            if (dataSet.getValue().getType() == MetadataPropertyType.PropertyValueArray) {
                for (PropertyValue value : dataSet.getValue().toArray(PropertyValue.class)) {
                    System.out.print(String.format("%s, ", value.getRawValue()));
                }
                System.out.println();
            }
            else {
                System.out.println(dataSet.getValue().getRawValue());
            }
        }
    }
}
```

## Updating IPTC IIM properties

The GroupDocs.Metadata API facilitates the user to update IPTC metadata in a convenient way - using the [IptcRecordSet](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IptcRecordSet) class methods. Follow the below steps to update IPTC metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.getIptcPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IIptc#getIptcPackage()) method
3.  Assign values to desired IPTC properties
4.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.working\_with\_metadata\_standards.iptc.UpdateIptcProperties**

```java
try (Metadata metadata = new Metadata(Constants.InputJpeg)) {
	IIptc root = (IIptc) metadata.getRootPackage();

	// Set the IPTC package if it's missing
	if (root.getIptcPackage() == null) {
		root.setIptcPackage(new IptcRecordSet());
	}

	if (root.getIptcPackage().getEnvelopeRecord() == null) {
		root.getIptcPackage().setEnvelopeRecord(new IptcEnvelopeRecord());
	}

	root.getIptcPackage().getEnvelopeRecord().setDateSent(new Date());
	root.getIptcPackage().getEnvelopeRecord().setProductID("test project id");

	// ...

	if (root.getIptcPackage().getApplicationRecord() == null) {
		root.getIptcPackage().setApplicationRecord(new IptcApplicationRecord());
	}

	root.getIptcPackage().getApplicationRecord().setByLine("GroupDocs");
	root.getIptcPackage().getApplicationRecord().setHeadline("test");
	root.getIptcPackage().getApplicationRecord().setByLineTitle("code sample");
	root.getIptcPackage().getApplicationRecord().setReleaseDate(new Date());

	// ...

	metadata.save(Constants.OutputJpeg);
}
```

## Adding or updating custom IPTC IIM datasets

The GroupDocs.Metadata API allows adding or updating custom datasets in an IPTC package.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.getIptcPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IIptc#getIptcPackage()) method
3.  Set the IPTC package if it's missing
4.  Add any number of custom datasets to the package (Please see the [IptcDataSet](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IptcDataSet) class for more information)
5.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.working\_with\_metadata\_standards.iptc.SetCustomIptcDataSet**

```java
try (Metadata metadata = new Metadata(Constants.PsdWithIptc)) {
	IIptc root = (IIptc) metadata.getRootPackage();

	// Set the IPTC package if it's missing
	if (root.getIptcPackage() == null) {
		root.setIptcPackage(new IptcRecordSet());
	}

	// Add a know property using the DataSet API
	root.getIptcPackage().set(new IptcDataSet((byte) IptcRecordType.ApplicationRecord, (byte) IptcApplicationRecordDataSet.BylineTitle, "test code sample"));

	// Add a custom IPTC DataSet
	root.getIptcPackage().set(new IptcDataSet((byte) 100, (byte) 100, new byte[]{1, 2, 3}));

	metadata.save(Constants.OutputPsd);
}
```

## Adding repeatable IPTC IIM datasets

According to the [IPTC IIM specification](https://www.iptc.org/std/IIM/4.2/specification/IIMV4.2.pdf) some datasets can be added to a record multiple times. The code snippet below demonstrates how to add a repeatable dataset to a record.

**advanced\_usage.working\_with\_metadata\_standards.iptc.AddRepeatableIptcDataSet**

```java
try (Metadata metadata = new Metadata(Constants.PsdWithIptc)) {
    IIptc root = (IIptc)metadata.getRootPackage();
     
    // Set the IPTC package if it's missing
    if (root.getIptcPackage() == null) {
        root.setIptcPackage(new IptcRecordSet());
    }
	
    root.getIptcPackage().add(new IptcDataSet((byte)IptcRecordType.ApplicationRecord, (byte)IptcApplicationRecordDataSet.Keywords, "keyword 1"));
    root.getIptcPackage().add(new IptcDataSet((byte)IptcRecordType.ApplicationRecord, (byte)IptcApplicationRecordDataSet.Keywords, "keyword 2"));
    root.getIptcPackage().add(new IptcDataSet((byte)IptcRecordType.ApplicationRecord, (byte)IptcApplicationRecordDataSet.Keywords, "keyword 3"));
	
    metadata.save(Constants.OutputPsd);
}
 
// Check the output file
try (Metadata metadata = new Metadata(Constants.OutputPsd)) {
    IIptc root = (IIptc)metadata.getRootPackage();
    MetadataProperty keywordsProperty = root.getIptcPackage().getApplicationRecord().get_Item((byte)IptcApplicationRecordDataSet.Keywords);
    for (PropertyValue value : keywordsProperty.getValue().toArray(PropertyValue.class)) {
        System.out.println(value);
    }
}
```

## Removing IPTC IIM metadata

To remove the IPTC package from a file just pass null to the [IIptc.setIptcPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IIptc#setIptcPackage(com.groupdocs.metadata.core.IptcRecordSet)) method as a parameter. The code sample below shows how to remove IPTC metadata from a file.

**advanced\_usage.working\_with\_metadata\_standards.iptc.RemoveIptcMetadata**

```java
try (Metadata metadata = new Metadata(Constants.JpegWithIptc)) {
	IIptc root = (IIptc) metadata.getRootPackage();
	root.setIptcPackage(null);
	metadata.save(Constants.OutputJpeg);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with IPTC IIM metadata

Path: /metadata/net/working-with-iptc-iim-metadata/

## What is IPTC IIM?

The IPTC Information Interchange Model (IIM) is a set of metadata properties that can be applied to text, images, and other media types. The standard also defines a complex data structure that is utilized to store the properties. The IPTC IIM was developed by the International Press Telecommunications Council (IPTC) to expedite the international exchange of news among newspapers and news agencies. But nowadays it's commonly used by amateur and commercial photographers. The standard is supported by many image creation and manipulation programs. IPTC IIM metadata can be embedded into a variety of image formats such as JPEG, TIFF, etc.

{{< alert style="info" >}}For more information on the IPTC IIM standard please refer to https://www.iptc.org/std/IIM/4.2/specification/IIMV4.2.pdf.{{< /alert >}}

## Reading basic IPTC IIM properties

To access IPTC metadata in a file of any supported format, GroupDocs.Metadata provides the [IIptc.IptcPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iiptc/properties/iptcpackage) property. The following are the steps to read IPTC metadata:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.IptcPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iiptc/properties/iptcpackage) property
3.  Read properties of the [IptcApplicationRecord](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iptcapplicationrecord) and [IptcEnvelopeRecord](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iptcenveloperecord) class instances

The following code snippet gets IPTC properties of a JPEG image and displays them on the screen. 

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Iptc.ReadBasicIptcProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.JpegWithIptc))
{
	IIptc root = metadata.GetRootPackage() as IIptc;
	if (root != null && root.IptcPackage != null)
	{
		if (root.IptcPackage.EnvelopeRecord != null)
		{
			Console.WriteLine(root.IptcPackage.EnvelopeRecord.DateSent);
			Console.WriteLine(root.IptcPackage.EnvelopeRecord.Destination);
			Console.WriteLine(root.IptcPackage.EnvelopeRecord.FileFormat);
			Console.WriteLine(root.IptcPackage.EnvelopeRecord.FileFormatVersion);

			// ...
		}

		if (root.IptcPackage.ApplicationRecord != null)
		{
			Console.WriteLine(root.IptcPackage.ApplicationRecord.Headline);
			Console.WriteLine(root.IptcPackage.ApplicationRecord.ByLine);
			Console.WriteLine(root.IptcPackage.ApplicationRecord.ByLineTitle);
			Console.WriteLine(root.IptcPackage.ApplicationRecord.CaptionAbstract);
			Console.WriteLine(root.IptcPackage.ApplicationRecord.City);
			Console.WriteLine(root.IptcPackage.ApplicationRecord.DateCreated);
			Console.WriteLine(root.IptcPackage.ApplicationRecord.ReleaseDate);

			// ...
		}
	}
}
```

## Reading all IPTC IIM datasets

In some cases, it's necessary to read all IPTC datasets (metadata properties) from a file, including custom ones. To achieve this the GroupDocs.Metadata API provides direct access to the IPTC datasets extracted from a file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.IptcPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iiptc/properties/iptcpackage) property
3.  Iterate through all IPTC datasets

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Iptc.ReadIptcDataSets**

```csharp
using (Metadata metadata = new Metadata(Constants.PsdWithIptc))
{
    IIptc root = metadata.GetRootPackage() as IIptc;
    if (root != null && root.IptcPackage != null)
    {
        foreach (var dataSet in root.IptcPackage.ToDataSetList())
        {
            Console.WriteLine(dataSet.RecordNumber);
            Console.WriteLine(dataSet.DataSetNumber);
            Console.WriteLine(dataSet.AlternativeName);
            if (dataSet.Value.Type == MetadataPropertyType.PropertyValueArray)
            {
                foreach (var value in dataSet.Value.ToArray<PropertyValue>())
                {
                    Console.Write("{0}, ", value);
                }
                Console.WriteLine();
            }
            else
            {
                Console.WriteLine(dataSet.Value);
            }
        }
    }
}
```

## Updating IPTC IIM properties

The GroupDocs.Metadata API facilitates the user to update IPTC metadata in a convenient way - using the [IptcRecordSet](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iptcrecordset) class properties. Follow the below steps to update IPTC metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.IptcPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iiptc/properties/iptcpackage) property
3.  Assign values to desired IPTC properties
4.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Iptc.UpdateIptcProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputJpeg))
{
	IIptc root = metadata.GetRootPackage() as IIptc;
	if (root != null)
	{
		// Set the IPTC package if it's missing
		if (root.IptcPackage == null)
		{
			root.IptcPackage = new IptcRecordSet();
		}

		if (root.IptcPackage.EnvelopeRecord == null)
		{
			root.IptcPackage.EnvelopeRecord = new IptcEnvelopeRecord();
		}
		root.IptcPackage.EnvelopeRecord.DateSent = DateTime.Now;
		root.IptcPackage.EnvelopeRecord.ProductID = Guid.NewGuid().ToString();

		// ...

		if (root.IptcPackage.ApplicationRecord == null)
		{
			root.IptcPackage.ApplicationRecord = new IptcApplicationRecord();
		}
		root.IptcPackage.ApplicationRecord.ByLine = "GroupDocs";
		root.IptcPackage.ApplicationRecord.Headline = "test";
		root.IptcPackage.ApplicationRecord.ByLineTitle = "code sample";
		root.IptcPackage.ApplicationRecord.ReleaseDate = DateTime.Today;

		// ...

		metadata.Save(Constants.OutputJpeg);
	}
}
```

## Adding or updating custom IPTC IIM datasets

The GroupDocs.Metadata API allows adding or updating custom datasets in an IPTC package.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the [IIptc.IptcPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iiptc/properties/iptcpackage) property
3.  Set the IPTC package if it's missing
4.  Add any number of custom datasets to the package (Please see the [IptcDataSet](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iptcdataset) class for more information)
5.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Iptc.SetCustomIptcDataSet**

```csharp
using (Metadata metadata = new Metadata(Constants.PsdWithIptc))
{
	IIptc root = metadata.GetRootPackage() as IIptc;
	if (root != null)
	{
		// Set the IPTC package if it's missing
		if (root.IptcPackage == null)
		{
			root.IptcPackage = new IptcRecordSet();
		}

		// Add a know property using the DataSet API
		root.IptcPackage.Set(new IptcDataSet((byte)IptcRecordType.ApplicationRecord, (byte)IptcApplicationRecordDataSet.BylineTitle, "test code sample"));

		// Add a custom IPTC DataSet
		root.IptcPackage.Set(new IptcDataSet(255, 255, new byte[] { 1, 2, 3 }));

		metadata.Save(Constants.OutputPsd);
	}
}
```

## Adding repeatable IPTC IIM datasets

According to the [IPTC IIM specification](https://www.iptc.org/std/IIM/4.2/specification/IIMV4.2.pdf) some datasets can be added to a record multiple times. The code snippet below demonstrates how to add a repeatable dataset to a record.

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Iptc.AddRepeatableIptcDataSet**

```csharp
using (Metadata metadata = new Metadata(Constants.PsdWithIptc))
{
    IIptc root = (IIptc)metadata.GetRootPackage();
    // Set the IPTC package if it's missing
    if (root.IptcPackage == null)
    {
        root.IptcPackage = new IptcRecordSet();
    }
    root.IptcPackage.Add(new IptcDataSet((byte)IptcRecordType.ApplicationRecord, (byte)IptcApplicationRecordDataSet.Keywords, "keyword 1"));
    root.IptcPackage.Add(new IptcDataSet((byte)IptcRecordType.ApplicationRecord, (byte)IptcApplicationRecordDataSet.Keywords, "keyword 2"));
    root.IptcPackage.Add(new IptcDataSet((byte)IptcRecordType.ApplicationRecord, (byte)IptcApplicationRecordDataSet.Keywords, "keyword 3"));
    metadata.Save(Constants.OutputPsd);
}
 
// Check the output file
using (Metadata metadata = new Metadata(Constants.OutputPsd))
{
    IIptc root = (IIptc)metadata.GetRootPackage();
    var keywordsProperty = root.IptcPackage.ApplicationRecord[(byte)IptcApplicationRecordDataSet.Keywords];
    foreach (var value in keywordsProperty.Value.ToArray<PropertyValue>())
    {
        Console.WriteLine(value);
    }
}
```

## Removing IPTC IIM metadata

To remove the IPTC package from a file just assign null to the [IIptc.IptcPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.iptc/iiptc/properties/iptcpackage) property. The code sample below shows how to remove IPTC metadata from a file.

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Iptc.RemoveIptcMetadata**

```csharp
using (Metadata metadata = new Metadata(Constants.JpegWithIptc))
{
	IIptc root = metadata.GetRootPackage() as IIptc;
	if (root != null)
	{
		root.IptcPackage = null;
		metadata.Save(Constants.OutputJpeg);
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with IPTC IIM metadata

Path: /metadata/nodejs-java/working-with-iptc-iim-metadata/

## What is IPTC IIM?

The IPTC Information Interchange Model (IIM) is a set of metadata properties that can be applied to text, images, and other media types. The standard also defines a complex data structure that is utilized to store the properties. The IPTC IIM was developed by the International Press Telecommunications Council (IPTC) to expedite the international exchange of news among newspapers and news agencies. But nowadays it's commonly used by amateur and commercial photographers. The standard is supported by many image creation and manipulation programs. IPTC IIM metadata can be embedded into a variety of image formats such as JPEG, TIFF, etc.

{{< alert style="info" >}}For more information on the IPTC IIM standard please refer to https://www.iptc.org/std/IIM/4.2/specification/IIMV4.2.pdf.{{< /alert >}}

## Reading basic IPTC IIM properties

To access IPTC metadata in a file of any supported format, GroupDocs.Metadata provides the **IIptc.getIptcPackage** method. The following are the steps to read IPTC metadata:

1.  **Load** a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the **IIptc.getIptcPackage** method
3.  Read properties of the **IptcApplicationRecord** class instances

The following code snippet gets IPTC properties of a JPEG image and displays them on the screen. 

**advanced\_usage.working\_with\_metadata\_standards.iptc.ReadBasicIptcProperties**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata(Constants.JpegWithIptc);
    var root = metadata.getRootPackage();
            if (root.getIptcPackage() != null) {
                if (root.getIptcPackage().getEnvelopeRecord() != null) {
                    console.log(root.getIptcPackage().getEnvelopeRecord().getDateSent());
                    console.log(root.getIptcPackage().getEnvelopeRecord().getDestination());
                    console.log(root.getIptcPackage().getEnvelopeRecord().getFileFormat());
                    console.log(root.getIptcPackage().getEnvelopeRecord().getFileFormatVersion());

                    // ...
                }

                if (root.getIptcPackage().getApplicationRecord() != null) {
                    console.log(root.getIptcPackage().getApplicationRecord().getHeadline());
                    console.log(root.getIptcPackage().getApplicationRecord().getByLine());
                }   
            }
```
{{< /tab >}}
{{< /tabs >}}


## Removing IPTC IIM metadata

To remove the IPTC package from a file just pass null to the **IIptc.setIptcPackage** method as a parameter. The code sample below shows how to remove IPTC metadata from a file.

**advanced\_usage.working\_with\_metadata\_standards.iptc.RemoveIptcMetadata**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata(Constants.JpegWithIptc);
    var root = metadata.getRootPackage();
    root.setIptcPackage(null);
    metadata.save(Constants.OutputJpeg);
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with IPTC IIM metadata

Path: /metadata/python-net/working-with-iptc-iim-metadata/

## What is IPTC IIM?

The IPTC Information Interchange Model (IIM) is a set of metadata properties that can be applied to text, images, and other media types. The standard also defines a complex data structure that is utilized to store the properties. The IPTC IIM was developed by the International Press Telecommunications Council (IPTC) to expedite the international exchange of news among newspapers and news agencies. Nowadays it's also commonly used by photographers. IPTC IIM metadata can be embedded into a variety of image formats such as JPEG, TIFF, etc.

{{< alert style="info" >}}For more information on the IPTC IIM standard please refer to https://www.iptc.org/std/IIM/4.2/specification/IIMV4.2.pdf.{{< /alert >}}

## Reading basic IPTC IIM properties

To access IPTC metadata in a file of any supported format, GroupDocs.Metadata provides the `IIptc.iptc_package` property. The following are the steps to read IPTC metadata:

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the `IIptc.iptc_package` property
3.  Read properties of the `IptcApplicationRecord` and `IptcEnvelopeRecord` class instances

The following code snippet gets IPTC properties of a JPEG image and displays them on the screen. 

**advanced_usage.working_with_metadata_standards.iptc.read_basic_iptc_properties**


```python
def run():
    with gm.Metadata(constants.jpeg_with_iptc) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "iptc_package") and root.iptc_package is not None:
            if root.iptc_package.envelope_record is not None:
                print(root.iptc_package.envelope_record.date_sent)
                print(root.iptc_package.envelope_record.destination)
                print(root.iptc_package.envelope_record.file_format)
                print(root.iptc_package.envelope_record.file_format_version)

                # ...

            if root.iptc_package.application_record is not None:
                print(root.iptc_package.application_record.headline)
                print(root.iptc_package.application_record.by_line)
                print(root.iptc_package.application_record.by_line_title)
                print(root.iptc_package.application_record.caption_abstract)
                print(root.iptc_package.application_record.city)
                print(root.iptc_package.application_record.date_created)
                print(root.iptc_package.application_record.release_date)

                # ...
```


## Reading all IPTC IIM datasets

In some cases, it's necessary to read all IPTC datasets (metadata properties) from a file, including custom ones. To achieve this the GroupDocs.Metadata API provides direct access to the IPTC datasets extracted from a file.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the `IIptc.iptc_package` property
3.  Iterate through all IPTC datasets

**advanced_usage.working_with_metadata_standards.iptc.read_iptc_datasets**


```python
def run():
    with gm.Metadata(constants.psd_with_iptc) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "iptc_package") and root.iptc_package is not None:
            for dataset in root.iptc_package.to_dataset_list():
                print(dataset.record_number)
                print(dataset.dataset_number)
                print(dataset.alternative_name)
                if dataset.value.type == gm.common.MetadataPropertyType.PROPERTY_VALUE_ARRAY:
                    for val in dataset.value.to_array(gm.common.PropertyValue):
                        print(f"{val}, ", end="")
                    print()
                else:
                    print(dataset.value)
```


## Updating IPTC IIM properties

The GroupDocs.Metadata API facilitates the user to update IPTC metadata in a convenient way - using the `IptcRecordSet` class properties. Follow the below steps to update IPTC metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the `IIptc.iptc_package` property
3.  Assign values to desired IPTC properties
4.  [Save]({{< ref "metadata/python-net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced_usage.working_with_metadata_standards.iptc.update_iptc_properties**


```python
def run():
    with gm.Metadata(constants.input_jpeg) as metadata:
        root = metadata.get_root_package()
        # Set the IPTC package if it's missing
        if not hasattr(root, "iptc_package") or root.iptc_package is None:
            root.iptc_package = gm.standards.iptc.IptcRecordSet()

        if root.iptc_package.envelope_record is None:
            root.iptc_package.envelope_record = gm.standards.iptc.IptcEnvelopeRecord()
        root.iptc_package.envelope_record.date_sent = datetime.now()
        root.iptc_package.envelope_record.product_id = str(uuid.uuid4())

        # ...

        if root.iptc_package.application_record is None:
            root.iptc_package.application_record = gm.standards.iptc.IptcApplicationRecord()
        root.iptc_package.application_record.by_line = "GroupDocs"
        root.iptc_package.application_record.headline = "test"
        root.iptc_package.application_record.by_line_title = "code sample"
        root.iptc_package.application_record.release_date = date.today()

        # ...

        metadata.save(constants.output_jpeg)
```


## Adding or updating custom IPTC IIM datasets

The GroupDocs.Metadata API allows adding or updating custom datasets in an IPTC package.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains IPTC metadata
2.  Extract the IPTC metadata package using the `IIptc.iptc_package` property
3.  Set the IPTC package if it's missing
4.  Add any number of custom datasets to the package
5.  [Save]({{< ref "metadata/python-net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced_usage.working_with_metadata_standards.iptc.set_custom_iptc_dataset**


```python
def run():
    with gm.Metadata(constants.psd_with_iptc) as metadata:
        root = metadata.get_root_package()
        if not hasattr(root, "iptc_package") or root.iptc_package is None:
            root.iptc_package = gm.standards.iptc.IptcRecordSet()

        # Add a known property using the DataSet API
        root.iptc_package.set(gm.standards.iptc.IptcDataSet(int(gm.standards.iptc.IptcRecordType.APPLICATION_RECORD), int(gm.standards.iptc.IptcApplicationRecordDataSet.BYLINE_TITLE), "test code sample"))

        # Add a custom IPTC DataSet
        root.iptc_package.set(gm.standards.iptc.IptcDataSet(255, 255, bytes([1, 2, 3])))

        metadata.save(constants.output_psd)
```


## Adding repeatable IPTC IIM datasets

According to the IPTC IIM specification some datasets can be added to a record multiple times. The code snippet below demonstrates how to add a repeatable dataset to a record.

**advanced_usage.working_with_metadata_standards.iptc.add_repeatable_iptc_dataset**


```python
def run():
    with gm.Metadata(constants.psd_with_iptc) as metadata:
        root = metadata.get_root_package()
        if not hasattr(root, "iptc_package") or root.iptc_package is None:
            root.iptc_package = gm.standards.iptc.IptcRecordSet()
        root.iptc_package.add(gm.standards.iptc.IptcDataSet(int(gm.standards.iptc.IptcRecordType.APPLICATION_RECORD), int(gm.standards.iptc.IptcApplicationRecordDataSet.KEYWORDS), "keyword 1"))
        root.iptc_package.add(gm.standards.iptc.IptcDataSet(int(gm.standards.iptc.IptcRecordType.APPLICATION_RECORD), int(gm.standards.iptc.IptcApplicationRecordDataSet.KEYWORDS), "keyword 2"))
        root.iptc_package.add(gm.standards.iptc.IptcDataSet(int(gm.standards.iptc.IptcRecordType.APPLICATION_RECORD), int(gm.standards.iptc.IptcApplicationRecordDataSet.KEYWORDS), "keyword 3"))
        metadata.save(constants.output_psd)

    # Check the output file
    with gm.Metadata(constants.output_psd) as metadata:
        root = metadata.get_root_package()
        keywords_property = root.iptc_package.application_record[int(gm.standards.iptc.IptcApplicationRecordDataSet.KEYWORDS)]
        for value in keywords_property.value.to_array(gm.common.PropertyValue):
            print(value)
```


## Removing IPTC IIM metadata

To remove the IPTC package from a file just assign `None` to the `IIptc.iptc_package` property. The code sample below shows how to remove IPTC metadata from a file.

**advanced_usage.working_with_metadata_standards.iptc.remove_iptc_metadata**


```python
def run():
    with gm.Metadata(constants.jpeg_with_iptc) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "iptc_package"):
            root.iptc_package = None
            metadata.save(constants.output_jpeg)
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Working with JSON Data Sources

Path: /assembly/java/working-with-json-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for Java 19.11 or later releases.{{< /alert >}}

## Simplified working with JSON data sources

To access JSON data while building a report, you can pass a *JsonDataSource* instance to the engine as a data source.

Using of *JsonDataSource* enables you to work with typed values of JSON elements in template documents. For more convenience, the set of simple JSON types is extended as follows:

*   Integer
*   Long
*   Double
*   Boolean
*   Date
*   String

## Treating the top level arrays or objects having array

In template documents, if a top-level JSON element is an array or an object having only one property of an array type, a JsonDataSource instance should be treated in the same way as if it was a DataTable instance (see "[Working with DataTable and DataView Objects](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-data-sources)" for more information) as shown in the following example.

Suppose we have Json data like:
```
[ 
   { 
      Name:"John Doe",
      Age:30,
      Birth:"1989-04-01 4:00:00 pm"
   },
   { 
      Name:"Jane Doe",
      Age:27,
      Birth:"1992-01-31 07:00:00 am"
   },
   { 
      Name:"John Smith",
      Age:51,
      Birth:"1968-03-08 1:00:00 pm"
   }
]
```

or alternative JSON like:
```
{ 
   Persons:[ 
      { 
         Name:"John Doe",
         Age:30,
         Birth:"1989-04-01 4:00:00 pm"
      },
      { 
         Name:"Jane Doe",
         Age:27,
         Birth:"1992-01-31 07:00:00 am"
      },
      { 
         Name:"John Smith",
         Age:51,
         Birth:"1968-03-08 1:00:00 pm"
      }
   ]
}
```

If we use the template like following:
```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Age)]>>
```

The results will be produced for both pieces of JSON data like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

{{< alert style="warning" >}}Using of the custom date-time format becomes possible, because text values of Birth properties are automatically converted to Date.{{< /alert >}}

## Treating the objects at top level

If a top-level JSON element represents an object, a *JsonDataSource* instance should be treated in template documents in the same way as if it was a *DataRow* instance (see "[Working with *DataRow* and *DataRowView* Objects](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-data-sources)" for more information). If a top-level JSON object has a single property that is also an object, then this nested object is accessed by the assembler instead. To see how it works, consider the following example.

Suppose we have Json data like:
```
{ 
   Name:"John Doe",
   Age:30,
   Birth:"1989-04-01 4:00:00 pm",
   Child:[ 
      "Ann Doe",
      "Charles Doe"
   ]
}
```

or alternatively like:
```
{ 
   Person:{ 
      Name:"John Doe",
      Age:30,
      Birth:"1989-04-01 4:00:00 pm",
      Child:[ 
         "Ann Doe",
         "Charles Doe"
      ]
   }
}
```

If we use the template like following:
```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth:
<<[Birth]:"dd.MM.yyyy">>
Children:
<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

The results will be produced for both pieces of JSON data like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Children:
Ann Doe
Charles Doe
```

{{< alert style="warning" >}}To reference a JSON object property that is an array of simple-type values, the name of the property (for example, "Child") should be used in a template document, whereas the same name with the "_Text" suffix (for example, "Child_Text") should be used to reference the value of an item of this array.{{< /alert >}}

## The complete example

The following example sums up typical scenarios involving nested JSON objects and arrays.

**JSON**

```
[ 
   { 
      Name:"John Smith",
      Contract:[ 
         { 
            Client:{ 
               Name:"A Company"
            },
            Price:1200000
         },
         { 
            Client:{ 
               Name:"B Ltd."
            },
            Price:750000
         },
         { 
            Client:{ 
               Name:"C & D"
            },
            Price:350000
         }
      ]
   },
   { 
      Name:"Tony Anderson",
      Contract:[ 
         { 
            Client:{ 
               Name:"E Corp."
            },
            Price:650000
         },
         { 
            Client:{ 
               Name:"F & Partners"
            },
            Price:550000
         }
      ]
   },
   { 
      Name:"July James",
      Contract:[ 
         { 
            Client:{ 
               Name:"G & Co."
            },
            Price:350000
         },
         { 
            Client:{ 
               Name:"H Group"
            },
            Price:250000
         },
         { 
            Client:{ 
               Name:"I & Sons"
            },
            Price:100000
         },
         { 
            Client:{ 
               Name:"J Ent."
            },
            Price:100000
         }
      ]
   }
]
```

### Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

### Source code

{{< gist GroupDocsGists ecbe5e7331f08a3f0bccd81a1ef57995 simpleJsonDS_Demo_19.11.java >}}

### Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)
Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)
Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

## Recognition of JSON simple values

For recognition of JSON simple values (null, boolean, number, integer, and string), the engine provides two modes: *loose* and *strict*. In the loose mode, types of JSON simple values are determined upon parsing of their string representations. In the strict mode, types of JSON simple values are determined from JSON notation itself. To see the main difference between the modes, consider the following JSON snippet.

```
{ prop: "123" }
```

In the loose mode, the type of prop is determined as integer, whereas in the strict mode, it is determined as string.

The loose mode is used by the engine by default to support more typed data representation options. However, in some scenarios, it can be more preferable to disable recognition of numbers and other JSON simple values from strings, for example, when you need to keep leading padding zeros in a string value representing a number. In this case, you can switch to the strict mode as shown in following code snippet.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.setSimpleValueParseMode(JsonSimpleValueParseMode.STRICT);
JsonDataSource dataSource = new JsonDataSource(..., options);
```

**Note –** Parsing of date-time values does not depend on whether the loose or strict mode is used.

Recognition of date-time values is a special case, because [JSON specification](https://www.json.org) does not define a format for their representation. So, by default, while parsing date-time values from strings, the engine tries several formats in the following order:

1. [The ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601) (for values like "2015-03-02T13:56:04Z")
2. [The Microsoft® JSON date-time format](https://docs.microsoft.com/en-us/previous-versions/dotnet/articles/bb299886(v=msdn.10)#from-javascript-literals-to-json) (for values like "/Date(1224043200000)/")
3. All date-time formats supported for the current culture
4. All date-time formats supported for the English USA culture
5. All date-time formats supported for the English New Zealand culture

Although this approach is quite flexible, in some scenarios, you may need to restrict strings to be recognized as date-time values. You can achieve this by specifying an exact format in the context of the current culture to be used while parsing date-time values from strings as shown in the following example.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.setExactDateTimeParseFormat("MM/dd/yyyy");
JsonDataSource dataSource = new JsonDataSource(..., options);
```

In this example, strings conforming the format "MM/dd/yyyy" are going to be recognized as date-time values while loading JSON, whereas the others are not (but see the following note).

In some scenarios, you may need to disable recognition of date-time values at all, for example, when you deal with strings containing already formatted date-time values, which you do not want to re-format using the engine. You can achieve this by setting the exact date-time parse format to an empty string (but see the following note).

**Note –** Strings conforming the Microsoft® JSON date-time format (for example, "/Date(1224043200000)/") are always recognized as date-time values regardless of the exact date-time parse format.

##  Download

### Data Source Document

*   [ManagerData.json](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/JSON%20DataSource/ManagerData.json?raw=true)

### Template

*   [Demo Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Using%20Spreadsheet%20as%20Table%20of%20Data.docx?raw=true)

---

## Working with JSON Data Sources

Path: /assembly/net/working-with-json-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 19.10 or later releases.{{< /alert >}}

To access JSON data while building a report, the GroupDocs.Assembly API introduces *JsonDataSource* class. You can pass its instance to the assembler as a data source. Using of *JsonDataSource* enables you to work with typed values of JSON elements in template

documents. For more convenience, the set of simple JSON types is extended as follows:

*   Int32?
*   Int64?
*   Double?
*   Boolean?
*   DateTime?
*   String

### Treating the top level arrays or objects having array

In template documents, if a top-level JSON element is an array or an object having only one property of an array type, a JsonDataSource instance should be treated in the same way as if it was a DataTable instance (see "[Working with DataTable and DataView Objects](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-data-sources)" for more information) .

Suppose we have Json data like:
```
[ 
   { 
      Name:"John Doe",
      Age:30,
      Birth:"1989-04-01 4:00:00 pm"
   },
   { 
      Name:"Jane Doe",
      Age:27,
      Birth:"1992-01-31 07:00:00 am"
   },
   { 
      Name:"John Smith",
      Age:51,
      Birth:"1968-03-08 1:00:00 pm"
   }
]
```

or alternative JSON like:
```
{ 
   Persons:[ 
      { 
         Name:"John Doe",
         Age:30,
         Birth:"1989-04-01 4:00:00 pm"
      },
      { 
         Name:"Jane Doe",
         Age:27,
         Birth:"1992-01-31 07:00:00 am"
      },
      { 
         Name:"John Smith",
         Age:51,
         Birth:"1968-03-08 1:00:00 pm"
      }
   ]
}
```

If we use the template like following:
```
<<foreach \[in persons\]>>Name: <<\[Name\]>>, Age: <<\[Age\]>>, Date of Birth: <<\[Birth\]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<\[persons.Average(p => p.Age)\]>>
```

The results will be produced for both pieces of JSON data like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

{{< alert style="warning" >}}Using of the custom date-time format becomes possible, because text values of Birth properties are automatically converted to DateTime?.{{< /alert >}}

### Treating the objects at top level

If a top-level JSON element represents an object, a *JsonDataSource* instance should be treated in template documents in the same way as if it was a *DataRow* instance (see "[Working with *DataRow* and *DataRowView* Objects](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-data-sources)" for more information). If a top-level JSON object has a single property that is also an object, then this nested object is accessed by the assembler instead.

Suppose we have Json data like:
```
{ 
   Name:"John Doe",
   Age:30,
   Birth:"1989-04-01 4:00:00 pm",
   Child:[ 
      "Ann Doe",
      "Charles Doe"
   ]
}
```

or alternatively like:
```
{ 
   Person:{ 
      Name:"John Doe",
      Age:30,
      Birth:"1989-04-01 4:00:00 pm",
      Child:[ 
         "Ann Doe",
         "Charles Doe"
      ]
   }
}
```

If we use the template like following:
```
Name: <<\[Name\]>>, Age: <<\[Age\]>>, Date of Birth:
<<\[Birth\]:"dd.MM.yyyy">>
Children:
<<foreach \[in Child\]>><<\[Child\_Text\]>>
<</foreach>>
```

The results will be produced for both pieces of JSON data like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Children:
Ann Doe
Charles Doe
```

{{< alert style="warning" >}}To reference a JSON object property that is an array of simple-type values, the name of the property (for example, "Child") should be used in a template document, whereas the same name with the "_Text" suffix (for example, "Child_Text") should be used to reference the value of an item of this array.{{< /alert >}}

### The complete example

The following example sums up typical scenarios involving nested JSON objects and arrays.

#### JSON
```
[ 
   { 
      Name:"John Smith",
      Contract:[ 
         { 
            Client:{ 
               Name:"A Company"
            },
            Price:1200000
         },
         { 
            Client:{ 
               Name:"B Ltd."
            },
            Price:750000
         },
         { 
            Client:{ 
               Name:"C & D"
            },
            Price:350000
         }
      ]
   },
   { 
      Name:"Tony Anderson",
      Contract:[ 
         { 
            Client:{ 
               Name:"E Corp."
            },
            Price:650000
         },
         { 
            Client:{ 
               Name:"F & Partners"
            },
            Price:550000
         }
      ]
   },
   { 
      Name:"July James",
      Contract:[ 
         { 
            Client:{ 
               Name:"G & Co."
            },
            Price:350000
         },
         { 
            Client:{ 
               Name:"H Group"
            },
            Price:250000
         },
         { 
            Client:{ 
               Name:"I & Sons"
            },
            Price:100000
         },
         { 
            Client:{ 
               Name:"J Ent."
            },
            Price:100000
         }
      ]
   }
]
```

#### Template document
```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

#### Source code

{{< gist GroupDocsGists 330892e76bb1958b9199e3d223962e27 >}}

#### Result document
```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)
Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)
Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

### Recognition of JSON simple values

For recognition of JSON simple values (null, boolean, number, integer, and string), the engine provides two modes: *loose* and *strict*. In the loose mode, types of JSON simple values are determined upon parsing of their string representations. In the strict mode, types of JSON simple values are determined from JSON notation itself. To see the main difference between the modes, consider the following JSON snippet.

```
{ prop: "123" }
```

In the loose mode, the type of prop is determined as integer, whereas in the strict mode, it is determined as string.

The loose mode is used by the engine by default to support more typed data representation options. However, in some scenarios, it can be more preferable to disable recognition of numbers and other JSON simple values from strings, for example, when you need to keep leading padding zeros in a string value representing a number. In this case, you can switch to the strict mode as shown in following code snippet.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.SimpleValueParseMode = JsonSimpleValueParseMode.Strict;
JsonDataSource dataSource = new JsonDataSource(..., options);
```

**Note –** Parsing of date-time values does not depend on whether the loose or strict mode is used.

Recognition of date-time values is a special case, because [JSON specification](https://www.json.org) does not define a format for their representation. So, by default, while parsing date-time values from strings, the engine tries several formats in the following order:

1. [The ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601) (for values like "2015-03-02T13:56:04Z")
2. [The Microsoft® JSON date-time format](https://docs.microsoft.com/en-us/previous-versions/dotnet/articles/bb299886(v=msdn.10)#from-javascript-literals-to-json) (for values like "/Date(1224043200000)/")
3. All date-time formats supported for the current culture
4. All date-time formats supported for the English USA culture
5. All date-time formats supported for the English New Zealand culture

Although this approach is quite flexible, in some scenarios, you may need to restrict strings to be recognized as date-time values. You can achieve this by specifying an exact format in the context of the current culture to be used while parsing date-time values from strings as shown in the following example.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.ExactDateTimeParseFormat = "MM/dd/yyyy";
JsonDataSource dataSource = new JsonDataSource(..., options);
```

In this example, strings conforming the format "MM/dd/yyyy" are going to be recognized as date-time values while loading JSON, whereas the others are not (but see the following note).

In some scenarios, you may need to disable recognition of date-time values at all, for example, when you deal with strings containing already formatted date-time values, which you do not want to re-format using the engine. You can achieve this by setting the exact date-time parse format to an empty string (but see the following note).

**Note –** Strings conforming the Microsoft® JSON date-time format (for example, "/Date(1224043200000)/") are always recognized as date-time values regardless of the exact date-time parse format.

### Download

#### Data Source Document

*   [ManagerData.json](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/JSON%20DataSource/ManagerData.json?raw=true)

#### Template

*   [Demo Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Using%20Spreadsheet%20as%20Table%20of%20Data.docx?raw=true)

---

## Working with metadata in AVI files

Path: /metadata/java/working-with-metadata-in-avi-files/

## Reading AVI header properties

The GroupDocs.Metadata API supports extracting format-specific information from AVI file headers.

The following are the steps to read the header of an AVI file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an AVI video
2.  Get the root metadata package
3.  Extract  the native metadata package using the [AviRootPackage.getHeader](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/AviRootPackage#getHeader()) method
4.  Read the AVI header properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>video.avi.AviReadHeaderProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputAvi)) {
    AviRootPackage root = metadata.getRootPackageGeneric();

    System.out.println(root.getHeader().getAviHeaderFlags());
    System.out.println(root.getHeader().getHeight());
    System.out.println(root.getHeader().getWidth());
    System.out.println(root.getHeader().getTotalFrames());
    System.out.println(root.getHeader().getInitialFrames());
    System.out.println(root.getHeader().getMaxBytesPerSec());
    System.out.println(root.getHeader().getPaddingGranularity());
    System.out.println(root.getHeader().getStreams());

    // ...
}
```

## Extract RIFF INFO chunk metadata

The AVI format is derived from the RIFF container which acts as a wrapper for various audio and video coding formats. As a derivative of RIFF, AVI files can be tagged with metadata in the INFO chunk. The chunk may include information such as the title of the work, the author, the creation date, and copyright information. Here is an example of how the RIFF INFO metadata can be extracted:

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>video.avi.AviReadInfoMetadata**

```csharp
try (Metadata metadata = new Metadata(Constants.InputAvi)) {
    AviRootPackage root = metadata.getRootPackageGeneric();
    if (root.getRiffInfoPackage() != null) {
        System.out.println(root.getRiffInfoPackage().getArtist());
        System.out.println(root.getRiffInfoPackage().getComment());
        System.out.println(root.getRiffInfoPackage().getCopyright());
        System.out.println(root.getRiffInfoPackage().getCreationDate());
        System.out.println(root.getRiffInfoPackage().getSoftware());
        System.out.println(root.getRiffInfoPackage().getEngineer());
        System.out.println(root.getRiffInfoPackage().getGenre());
 
        // ...
    }
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in AVI files. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in AVI files

Path: /metadata/net/working-with-metadata-in-avi-files/

## Reading AVI header properties

The GroupDocs.Metadata API supports extracting format-specific information from AVI file headers.

The following are the steps to read the header of an AVI file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an AVI video
2.  Get the root metadata package
3.  Extract  the native metadata package using [AviRootPackage.Header](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.video/avirootpackage/properties/header)
4.  Read the AVI header properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Video.Avi.AviReadHeaderProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputAvi))
{
	var root = metadata.GetRootPackage<AviRootPackage>();

	Console.WriteLine(root.Header.AviHeaderFlags);
	Console.WriteLine(root.Header.Height);
	Console.WriteLine(root.Header.Width);
	Console.WriteLine(root.Header.TotalFrames);
	Console.WriteLine(root.Header.InitialFrames);
	Console.WriteLine(root.Header.MaxBytesPerSec);
	Console.WriteLine(root.Header.PaddingGranularity);
	Console.WriteLine(root.Header.Streams);

	// ...
}
```

## Extract RIFF INFO chunk metadata

The AVI format is derived from the RIFF container which acts as a wrapper for various audio and video coding formats. As a derivative of RIFF, AVI files can be tagged with metadata in the INFO chunk. The chunk may include information such as the title of the work, the author, the creation date, and copyright information. Here is an example of how the RIFF INFO metadata can be extracted:

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Video.Avi.AviReadInfoMetadata**

```csharp
using (Metadata metadata = new Metadata(Constants.InputAvi))
{
    var root = metadata.GetRootPackage<AviRootPackage>();
    if (root.RiffInfoPackage != null)
    {
        Console.WriteLine(root.RiffInfoPackage.Artist);
        Console.WriteLine(root.RiffInfoPackage.Comment);
        Console.WriteLine(root.RiffInfoPackage.Copyright);
        Console.WriteLine(root.RiffInfoPackage.CreationDate);
        Console.WriteLine(root.RiffInfoPackage.Software);
        Console.WriteLine(root.RiffInfoPackage.Engineer);
        Console.WriteLine(root.RiffInfoPackage.Genre);
 
        // ...
    }
}
```

## Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in AVI files. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in Spreadsheets

Path: /metadata/java/working-with-metadata-in-spreadsheets/

GroupDocs.Metadata for Java provides functionality that allows working with different kinds of spreadsheet formats such as XLS, XLSX, ODS, etc. For the full list of supported document formats please refer to [Supported document formats]({{< ref "metadata/java/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a document

The following sample of code will help you to detect the exact type of a loaded spreadsheet and extract some additional file format information.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Spreadsheet document
2.  Extract the root metadata package
3.  Use the [getSpreadsheetType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/SpreadsheetRootPackage#getSpreadsheetType()) method to obtain file format information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.spreadsheet.<WBR>SpreadsheetReadFileFormatProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputXlsx)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getSpreadsheetType().getFileFormat());
	System.out.println(root.getSpreadsheetType().getSpreadsheetFormat());
	System.out.println(root.getSpreadsheetType().getMimeType());
	System.out.println(root.getSpreadsheetType().getExtension());
}
```

## Reading built-in metadata properties

To access built-in metadata of a spreadsheet, please use the [getDocumentProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage#getDocumentProperties()) method defined in the [DocumentRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.spreadsheet.<WBR>SpreadsheetReadBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputXlsx)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentProperties().getAuthor());
	System.out.println(root.getDocumentProperties().getCreatedTime());
	System.out.println(root.getDocumentProperties().getCompany());
	System.out.println(root.getDocumentProperties().getCategory());
	System.out.println(root.getDocumentProperties().getKeywords());
	System.out.println(root.getDocumentProperties().getLanguage());
	System.out.println(root.getDocumentProperties().getContentType());

	// ... 
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a spreadsheet please follow the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.spreadsheet.<WBR>SpreadsheetReadCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputXls)) {
    SpreadsheetRootPackage root = metadata.getRootPackageGeneric();

    IReadOnlyList<MetadataProperty> customProperties = root.getDocumentProperties().findProperties(new ContainsTagSpecification(Tags.getDocument().getBuiltIn()).not());

    for (MetadataProperty property : customProperties) {
        System.out.println(String.format("%s = %s", property.getName(), property.getValue()));
    }

    // Extract only content type properties if required
    for (SpreadsheetContentTypeProperty contentTypeProperty : root.getDocumentProperties().getContentTypeProperties().toList()) {
        System.out.println(String.format("%s, %s = %s", contentTypeProperty.getSpreadsheetPropertyType(), contentTypeProperty.getName(), contentTypeProperty.getSpreadsheetPropertyValue()));
    }
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [findProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MetadataPackage#findProperties(com.groupdocs.metadata.search.Specification)) method for a certain metadata package (instance of the [SpreadsheetPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/SpreadsheetRootPackage) class), the search result will contain only metadata properties that are specific for spreadsheets. 

## Inspecting spreadsheets

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about digital signatures associated with a spreadsheet, extract user comments from the spreadsheet content, obtain hidden sheets, etc. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Spreadsheet document
2.  Extract the root metadata package
3.  Use the [getInspectionPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/SpreadsheetRootPackage#getInspectionPackage()) method to inspect the document

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.spreadsheet.<WBR>SpreadsheetReadInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputXls)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();

	if (root.getInspectionPackage().getComments() != null) {
		for (SpreadsheetComment comment : root.getInspectionPackage().getComments()) {
			System.out.println(comment.getAuthor());
			System.out.println(comment.getText());
			System.out.println(comment.getSheetNumber());
			System.out.println(comment.getRow());
			System.out.println(comment.getColumn());
		}
	}

	if (root.getInspectionPackage().getDigitalSignatures() != null) {
		for (DigitalSignature signature : root.getInspectionPackage().getDigitalSignatures()) {
			System.out.println(signature.getCertificateSubject());
			System.out.println(signature.getComments());
			System.out.println(signature.getSignTime());

			// ...
		}
	}

	if (root.getInspectionPackage().getHiddenSheets() != null) {
		for (SpreadsheetSheet sheet : root.getInspectionPackage().getHiddenSheets()) {
			System.out.println(sheet.getName());
			System.out.println(sheet.getNumber());
		}
	}
}
```

## Updating built-In metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a spreadsheet.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.spreadsheet.<WBR>SpreadsheetUpdateBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputXlsx)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().setAuthor("test author");
	root.getDocumentProperties().setCreatedTime(new Date());
	root.getDocumentProperties().setCompany("GroupDocs");
	root.getDocumentProperties().setCategory("test category");
	root.getDocumentProperties().setKeywords("metadata, built-in, update");

	// ... 

	metadata.save(Constants.OutputXlsx);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties (including content type properties) in a spreadsheet. Please check the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.spreadsheet.<WBR>SpreadsheetUpdateCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputXls)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().set("customProperty1", "some value");
	root.getDocumentProperties().set("customProperty2", 7);

	// Set a content type property
	root.getDocumentProperties().getContentTypeProperties().set("customContentTypeProperty", "custom value");

	metadata.save(Constants.OutputXls);
}
```

## Updating inspection properties

When you inspect a spreadsheet GroupDocs.Metadata for Java forms a metadata package containing the extracted information. The package class also provides some basic methods that allow removing the extracted properties. The following code sample demonstrates how to remove the inspection properties in a spreadsheet.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.spreadsheet.<WBR>SpreadsheetUpdateInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputXlsx)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();

	root.getInspectionPackage().clearComments();
	root.getInspectionPackage().clearDigitalSignatures();
	root.getInspectionPackage().clearHiddenSheets();

	metadata.save(Constants.OutputXlsx);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in Spreadsheets

Path: /metadata/net/working-with-metadata-in-spreadsheets/

GroupDocs.Metadata for .NET provides functionality that allows working with different kinds of spreadsheet formats such as XLS, XLSX, ODS, etc. For the full list of supported document formats please refer to [Supported Document Formats]({{< ref "metadata/net/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a document

The following sample of code will help you to detect the exact type of a loaded spreadsheet and extract some additional file format information.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Spreadsheet document
2.  Extract the root metadata package
3.  Use the [FileType](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/spreadsheetrootpackage/properties/filetype) property to obtain file format information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Spreadsheet.<WBR>SpreadsheetReadFileFormatProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputXlsx))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	Console.WriteLine(root.FileType.FileFormat);
	Console.WriteLine(root.FileType.SpreadsheetFormat);
	Console.WriteLine(root.FileType.MimeType);
	Console.WriteLine(root.FileType.Extension);
}
```

## Reading built-in metadata properties

To access built-in metadata of a spreadsheet, please use the [DocumentProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1/properties/documentproperties) property defined in the [DocumentRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Spreadsheet.<WBR>SpreadsheetReadBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputXlsx))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	Console.WriteLine(root.DocumentProperties.Author);
	Console.WriteLine(root.DocumentProperties.CreatedTime);
	Console.WriteLine(root.DocumentProperties.Company);
	Console.WriteLine(root.DocumentProperties.Category);
	Console.WriteLine(root.DocumentProperties.Keywords);
	Console.WriteLine(root.DocumentProperties.Language);
	Console.WriteLine(root.DocumentProperties.ContentType);

	// ... 
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a spreadsheet please follow the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Spreadsheet.<WBR>SpreadsheetReadCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputXls))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	var customProperties = root.DocumentProperties.FindProperties(p => !p.Tags.Contains(Tags.Document.BuiltIn));
	foreach (var property in customProperties)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}

	// Extract only content type properties if required
	foreach (var contentTypeProperty in root.DocumentProperties.ContentTypeProperties.ToList())
	{
		Console.WriteLine("{0}, {1} = {2}", contentTypeProperty.SpreadsheetPropertyType, contentTypeProperty.Name, contentTypeProperty.SpreadsheetPropertyValue);
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [FindProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/metadatapackage/methods/findproperties) method for a certain metadata package (instance of the [SpreadsheetPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/spreadsheetpackage) class), the search result will contain only metadata properties that are specific for spreadsheets. 

## Inspecting spreadsheets

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about digital signatures associated with a spreadsheet, extract user comments from the spreadsheet content, obtain hidden sheets, etc. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Spreadsheet document
2.  Extract the root metadata package
3.  Use the [InspectionPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/spreadsheetrootpackage/properties/inspectionpackage) property to inspect the document

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Spreadsheet.<WBR>SpreadsheetReadInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputXls))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();
	if (root.InspectionPackage.Comments != null)
	{
		foreach (var comment in root.InspectionPackage.Comments)
		{
			Console.WriteLine(comment.Author);
			Console.WriteLine(comment.Text);
			Console.WriteLine(comment.SheetNumber);
			Console.WriteLine(comment.Row);
			Console.WriteLine(comment.Column);
		}
	}

	if (root.InspectionPackage.DigitalSignatures != null)
	{
		foreach (var signature in root.InspectionPackage.DigitalSignatures)
		{
			Console.WriteLine(signature.CertificateSubject);
			Console.WriteLine(signature.Comments);
			Console.WriteLine(signature.SignTime);

			// ...
		}
	}

	if (root.InspectionPackage.HiddenSheets != null)
	{
		foreach (var sheet in root.InspectionPackage.HiddenSheets)
		{
			Console.WriteLine(sheet.Name);
			Console.WriteLine(sheet.Number);
		}
	}
}
```

## Updating built-in metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a spreadsheet.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Spreadsheet.<WBR>SpreadsheetUpdateBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputXlsx))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	root.DocumentProperties.Author = "test author";
	root.DocumentProperties.CreatedTime = DateTime.Now;
	root.DocumentProperties.Company = "GroupDocs";
	root.DocumentProperties.Category = "test category";
	root.DocumentProperties.Keywords = "metadata, built-in, update";

	// ... 

	metadata.Save(Constants.OutputXlsx);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties (including content type properties) in a spreadsheet. Please check the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Spreadsheet.<WBR>SpreadsheetUpdateCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputXls))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	root.DocumentProperties.Set("customProperty1", "some value");
	root.DocumentProperties.Set("customProperty2", 7);

	// Set a content type property
	root.DocumentProperties.ContentTypeProperties.Set("customContentTypeProperty", "custom value");

	metadata.Save(Constants.OutputXls);
}
```

## Updating inspection properties

When you inspect a spreadsheet GroupDocs.Metadata for .NET forms a metadata package containing the extracted information. The package class also provides some basic methods that allow removing the extracted properties. The following code sample demonstrates how to remove the inspection properties in a spreadsheet.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Spreadsheet.<WBR>SpreadsheetUpdateInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputXlsx))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	root.InspectionPackage.ClearComments();
	root.InspectionPackage.ClearDigitalSignatures();
	root.InspectionPackage.ClearHiddenSheets();

	metadata.Save(Constants.OutputXlsx);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with Spreadsheet Documents

Path: /assembly/java/working-with-spreadsheet-documents/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}

## Working with Spreadsheet Documents

GroupDocs.Assembly allows you to use data bands in table rows in **Spreadsheet Documents**. A table-row data band is a data band whose body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in spreadsheet document is as follows:

| **Client**                               | **Manager**         | **Contract Price**                           |
| ---------------------------------------- | ------------------- | -------------------------------------------- |
| **<<foreach [c in ds]>> <<[c.Client]>>** | **<<[c.Manager]>>** | **<<[c.Contact_Price]>> &lt;&lt;/foreach>>** |

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block whose body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

<table class="confluenceTable"><tbody><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;if ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;elseif ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;else&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>... &lt;&lt;/if&gt;&gt;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p><div><strong><br></strong></div></td></tr></tbody></table>
{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Working%20With%20Table%20Row%20Data%20Bands.xlsx)

### The Code

{{< gist GroupDocsGists 59eba4d682fd53447e774dae5a3cceb8 >}}



---

## Working with Spreadsheet Documents

Path: /assembly/net/working-with-spreadsheet-documents/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Working with Spreadsheet Documents

GroupDocs.Assembly allows you to use data bands in table rows in **Spreadsheet Documents**. A table-row data band is a data band which body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in spreadsheet document is as follows:

<table class="gd-assembly">
	<tbody>
		<tr>
			<td>Manager</td>
			<td>Manager</td>
			<td>Contract Price</td>
		</tr>
		<tr>
			<td>&lt;&lt;foreach [c in ds]>>&lt;&lt;[c.Client]>></td>
			<td>&lt;&lt;[c.Manager]>></td>
			<td>&lt;&lt;[c.Price]>>&lt;&lt;/foreach>></td>
		</tr>
	</tbody>
</table>

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block which body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

|                        |         |                 |
| ---------------------- | ------- | --------------- |
| **&lt;&lt;if ...>> ...**     | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;elseif ...>> ...** | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;else>> ...**       | **...** | **...**         |
| **...**                | **...** | **...**         |
| **...**                | **...** | **... &lt;&lt;/if>>** |
|                        |         |                 |

### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Working%20With%20Table%20Row%20Data%20Bands.xlsx)

### The Code

{{< gist GroupDocsGists 4fbdcf4fde19831fbb9589f1d2615611 >}}



---

## Working with Text

Path: /parser/python-net/working-with-text/


Beyond basic text extraction, you can search inside documents and control how text is returned. This page shows common tasks; consult the [API reference](https://reference.groupdocs.com/parser/python-net/) for the full list of text-related methods and options.

## Search for text
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("sample.pdf") as parser:
    results = parser.search("GroupDocs")
    if results is None:
        print("Search isn't supported for this format.")
    else:
        for result in results:
            print(f"Found on page {result.page.index + 1}: {result.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/working-with-text/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Notes

- `parser.search()` returns occurrences with page indexes and matched text.  
- For regex or case-sensitive searches, use search options from `groupdocs.parser.options` (see the API reference for available parameters).  
- Combine search with `get_text()` or `get_text()` per page to extract surrounding content.

## Extract formatted or structured text

GroupDocs.Parser can return formatted text (HTML/Markdown/plain) and structured text (headings, lists, tables) when supported by the format.
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("sample.pptx") as parser:
    # Use format-specific text extraction methods exposed in the API reference
    reader = parser.get_text()
    print(reader if reader else "Formatted text isn't available.")
```

{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pptx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/working-with-text/sample.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

See the [API reference](https://reference.groupdocs.com/parser/python-net/) for the formatted and structured text methods supported in Python via .NET.


---

## Working with worksheet headers and footers

Path: /watermark/java/working-with-worksheet-headers-and-footers/

## Extracting information about all headers and footers in an Excel document

You can extract [information](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetWorksheet#getHeadersFooters()) about all the headers and footers in an Excel document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetGetHeaderFooterInformation**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
                                                                                                                 
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                   
{                                                                                                                
    for (SpreadsheetHeaderFooter headerFooter : worksheet.getHeadersFooters())                                   
    {                                                                                                            
        System.out.println(headerFooter.getHeaderFooterType());                                                  
        for (SpreadsheetHeaderFooterSection section : headerFooter.getSections())                                
        {                                                                                                        
            System.out.println(section.getSectionType());                                                        
            if (section.getImage() != null)                                                                      
            {                                                                                                    
                System.out.println(section.getImage().getWidth());                                               
                System.out.println(section.getImage().getHeight());                                              
                System.out.println(section.getImage().getBytes().length);                                        
            }                                                                                                    
                                                                                                                 
            System.out.println(section.getScript());                                                             
        }                                                                                                        
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.close();                                                                                             
```

## Clearing a particular header and footer

You can also clear a particular [header and footer](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetHeaderFooterSection) using GroupDocs.Watermark as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetClearHeaderFooter**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                              
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                            
                                                                                                                
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                  
                                                                                                                
SpreadsheetHeaderFooterSectionCollection sections = content                                                     
        .getWorksheets().get_Item(0)                                                                            
        .getHeadersFooters().getByOfficeHeaderFooterType(OfficeHeaderFooterType.HeaderPrimary)                  
        .getSections();                                                                                         
for (SpreadsheetHeaderFooterSection section : sections)                                                         
{                                                                                                               
    section.setScript(null);                                                                                    
    section.setImage(null);                                                                                     
}                                                                                                               
                                                                                                                
watermarker.save("spreadsheet.xlsx");                                                                 
                                                                                                                
watermarker.close();                                                                                            
```

## Clearing a particular section of header and footer

Using GroupDocs.Watermark, you can also clear a particular section of [header and footer](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetHeaderFooterSection) as shown in the sample code below.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetClearSectionOfHeaderFooter**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
                                                                                                                 
SpreadsheetHeaderFooterSection section = content                                                                 
        .getWorksheets().get_Item(0)                                                                             
        .getHeadersFooters().getByOfficeHeaderFooterType(OfficeHeaderFooterType.HeaderEven)                      
        .getSections().getBySpreadsheetHeaderFooterSectionType(SpreadsheetHeaderFooterSectionType.Left);         
section.setImage(null);                                                                                          
section.setScript(null);                                                                                         
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Adding watermark to all images in header and footer

GroupDocs.Watermark enables you to add watermark to [images](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetHeaderFooterSection#getImage()) inside any header and footer. You can use below code sample to achieve this.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetAddWatermarkToImagesInHeaderFooter**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
// Initialize image or text watermark                                                                            
TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));                            
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                                    
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                        
watermark.setRotateAngle(45);                                                                                    
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                                     
watermark.setScaleFactor(1);                                                                                     
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                   
{                                                                                                                
    for (SpreadsheetHeaderFooter headerFooter : worksheet.getHeadersFooters())                                   
    {                                                                                                            
        for (SpreadsheetHeaderFooterSection section : headerFooter.getSections())                                
        {                                                                                                        
            if (section.getImage() != null)                                                                      
            {                                                                                                    
                // Add watermark to the image                                                                    
                section.getImage().add(watermark);                                                               
            }                                                                                                    
        }                                                                                                        
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

---

## Verify Digital signatures in the document

Path: /signature/java/verify-digital-signatures-in-the-document/

**[GroupDocs.Signature](https://products.groupdocs.com/signature/java)** provides [DigitalVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/DigitalVerifyOptions) class to specify different options for digital signatures verification.

Here are the steps to verify Digital signature within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate the [DigitalVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/DigitalVerifyOptions) object according to your requirements and specify verification options  
    
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [DigitalVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/DigitalVerifyOptions) to it.
    

  
  

This example shows how to verify Digital signature in the document.

```java
Signature signature = new Signature("sample.pdf");
DigitalVerifyOptions options = new DigitalVerifyOptions(Constants.CertificatePfx);
options.setComments("Test comment");
options.setPassword("1234567890");

// verify document signatures
VerificationResult result = signature.verify(options);
if (result.isValid())
{
    System.out.print("\nDocument was verified successfully!");
}
else
{
    System.out.print("\nDocument failed verification process.");
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verify Digital signatures in the document

Path: /signature/net/verify-digital-signatures-in-the-document/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalverifyoptions) class to specify different options for digital signatures verification.

Here are the steps to verify Digital signature within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [DigitalVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalverifyoptions) object according to your requirements and specify verification options
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalverifyoptions) to it.

This example shows how to verify Digital signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    DigitalVerifyOptions options = new DigitalVerifyOptions("certificate.pfx")
    {
        Comments = "Test comment"
    };
    // verify document signatures
    VerificationResult result = signature.Verify(options);
    if (result.IsValid)
    {
        Console.WriteLine("\nDocument was verified successfully!");
    }
    else
    {
        Console.WriteLine("\nDocument failed verification process.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify Digital signatures in the document

Path: /signature/nodejs-java/verify-digital-signatures-in-the-document/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [DigitalVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalverifyoptions) class to specify different options for verifying Digital signatures.

Here are the steps to verify a Digital signature within the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [DigitalVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalverifyoptions) object according to your requirements and specify the verification options.
* Call the [Verify](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/verify) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [DigitalVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalverifyoptions) to it.

This example shows how to verify Digital signature in the document.

```csharp
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF_SIGNED; 

  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize DigitalVerifyOptions
  const options = new signatureLib.DigitalVerifyOptions(Constants.CertificatePfx);
  options.setComments('Mr.Smith');
  options.setPassword('1234567890');

  // Verify document signatures
  const result = signature.verify(options);

  if (result.isValid()) {
    console.log('\nDocument was verified successfully!');
  } else {
    console.log('\nDocument failed the verification process.');
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Load document from FTP

Path: /signature/java/load-document-from-ftp/

Following example demonstrates how to process documents from FTP.

```java
public static void run()
    {
        String server = "ftp.example.com";
        String filePath = "sample.doc";
        String outputFilePath = new File(Constants.OutputPath, "SignFromStream//signedSample.doc").getPath();
 
        try {
 
            InputStream stream = getFileFromFtp(server,filePath);
            Signature signature = new Signature(stream);
            {
                QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
                options.setEncodeType(QrCodeTypes.QR);
                options.setLeft(100);
                options.setTop(100);
 
 
                // sign document to file
                signature.sign("signedSample.doc", options);
            }
 
            System.out.print("\nSource document signed successfully.\nFile saved ");
    }catch(Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
 
private static InputStream getFileFromFtp(String server, String filePath) throws Exception
{
   FTPClient client = new FTPClient();
   client.connect(server);
   return client.retrieveFileStream(filePath);
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to load document from FTP

Path: /signature/net/load-document-from-ftp/

Following example demonstrates how to process documents from FTP.

```csharp
public static void Run()
{
    string filePath = "ftp://localhost/sample.doc";
    using (Stream stream = GetFileFromFtp(filePath))
    {
        using (Signature signature = new Signature(stream))
        {
            QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
            {
                EncodeType = QRCodeTypes.QR,
                Left = 100,
                Top = 100
            };

            // sign document to file
            signature.Sign("SampleSigned", options);
        }
    }
}

private static Stream GetFileFromFtp(string filePath)
{
    Uri uri = new Uri(filePath);
    FtpWebRequest request = CreateRequest(uri);

    using (WebResponse response = request.GetResponse())
        return GetFileStream(response);
}

private static FtpWebRequest CreateRequest(Uri uri)
{
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(uri);
    request.Method = WebRequestMethods.Ftp.DownloadFile;
    return request;
}

private static Stream GetFileStream(WebResponse response)
{
    MemoryStream fileStream = new MemoryStream();

    using (Stream responseStream = response.GetResponseStream())
        responseStream.CopyTo(fileStream);

    fileStream.Position = 0;
    return fileStream;
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign Presentation with Metadata signature

Path: /signature/python-net/esign-presentation-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [PresentationMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/presentationmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) instance to sign Presentation document files.
Presentation document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Presentation document metadata contains pair of Name and Value, Name should be unique within the document.  
Presentation document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there.

### Here are the steps to add metadata signatures into Presentation document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several [PresentationMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/presentationmetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Presentation with Metadata signature

This example shows how to add Metadata signature to Presentation document.

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import MetadataSignOptions
from groupdocs.signature.domain import PresentationMetadataSignature
from datetime import datetime

# Initialize signature
with signature.Signature("sample.ppsx") as sign:
    # Create metadata options
    options = MetadataSignOptions()
    
    # Create few Presentation Metadata signatures
    signatures = [
        PresentationMetadataSignature("Author", "Mr.Scherlock Holmes"),
        PresentationMetadataSignature("DateCreated", datetime.now()),
        PresentationMetadataSignature("DocumentId", 123456),
        PresentationMetadataSignature("SignatureId", 123.456)
    ]
    
    # Add signatures to options
    options.signatures.extend(signatures)
    
    # Sign document
    sign.sign("SampleSigned.ppsx", options)
```

{{< /tab >}}
{{< tab "sample.ppsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.ppsx](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-metadata-signature/esign-presentation-with-metadata-signature/sample.ppsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign Document with Form Field Signature

Path: /signature/python-net/esign-document-with-form-field-signature/

## What is a Form Field?

A **form field** is an interactive element located on a document page that allows user data input through various control types like free input text boxes, multi-line text boxes, checkboxes, drop-down lists, etc. Different document types support a specific list of form field types. These elements are used to collect information from users on template form. Each Form Field element has a unique name, settings and value field. Form Fields should have unique names within the form. The picture below demonstrates a possible document page with form fields.

![FormField](/signature/python-net/images/esign-document-with-form-field-signature.png)

## How to eSign Document with Form Field Signature

With [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) you can create new form fields or update the existing ones within the documents. The [FormFieldSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsignoptions) class specifies different options for Form Field signature. The [FormFieldSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsignoptions) class contains one [FormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/formfieldsignature/) object that specifies the properties of the desired signature.

Below are listed different Form Field signature classes that could be set to [FormFieldSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsignoptions):

* [TextFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/textformfieldsignature) - represents a text input form field on a document page.
* [CheckboxFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/checkboxformfieldsignature) - represents a checkbox field on a document page.
* [ComboboxFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/comboboxformfieldsignature) - represents a combo box field signature input with a list of possible options.
* [RadioButtonFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/radiobuttonformfieldsignature) - represents a radio button signature on a document page.
* [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/digitalformfieldsignature) - represents a digital signature input form on a document page.  

Here are the steps to add Form Field signatures into a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter;
* Instantiate the [FormFieldSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsignoptions) object according to your requirements;
* Instantiate one of the objects - [TextFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/textformfieldsignature), [CheckboxFormFieldSignature,](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/checkboxformfieldsignature) [ComboboxFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/comboboxformfieldsignature), [RadioButtonFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/radiobuttonformfieldsignature) or [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/digitalformfieldsignature);
* Assign the [FormFieldSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsignoptions) property with the object created in a previous step;
* Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [FormFieldSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsignoptions) object to it.

{{< alert style="note" >}}
Currently GroupDocs.Signature supports the creation of Form Field signatures for PDF documents only.
{{< /alert >}}

This example shows how to sign a PDF document with a Form Field electronic signature using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import FormFieldSignOptions
from groupdocs.signature.domain import TextFormFieldSignature
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create text form field signature
        text_signature = TextFormFieldSignature("FieldText", "Value1")
        
        # Create form field options
        options = FormFieldSignOptions(text_signature)
        
        # Set signature position and size
        options.horizontal_alignment = gsd.HorizontalAlignment.LEFT
        options.vertical_alignment = gsd.VerticalAlignment.TOP
        options.margin = gsd.Padding(10, 20, 0, 0)
        options.height = 10
        options.width = 100
        
        # Sign document
        sign.sign("./SampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-form-field-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## How to eSign Document with Existing Form Field Signatures

GroupDocs.Signature for Python via .NET also provides a mechanism to update the existing form field signatures within the documents.

To update an existing form field signature within the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions) object with all required additional options.
* Set the [TextSignOptions.signature_implementation](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions/signature_implementation) property with the [TextSignatureImplementation.FORM_FIELD](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/textsignatureimplementation) value.
* Set the [form_text_field_title](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions/form_text_field_title) and [form_text_field_type](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions/form_text_field_type) properties with the proper values of form fields to be updated.
* Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the initialized [TextSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions) instance to it.
* Analyze the [SignResult](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/signresult) object to check the newly created signatures if needed.  

This example shows how to sign a PDF document with the existing Form Field electronic signature and update its value using Python:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSignOptions
from groupdocs.signature.domain import FormTextFieldType

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create first form field options
    ff_options1 = TextSignOptions("Document is approved")
    ff_options1.signature_implementation = signature.TextSignatureImplementation.FORM_FIELD
    ff_options1.form_text_field_type = FormTextFieldType.PLAIN_TEXT
    
    # Create second form field options
    ff_options2 = TextSignOptions("John Smith")
    ff_options2.signature_implementation = signature.TextSignatureImplementation.FORM_FIELD
    ff_options2.form_text_field_type = FormTextFieldType.RICH_TEXT
    ff_options2.form_text_field_title = "UserSignatureFullName"
    
    # Create list of options
    list_options = [ff_options1, ff_options2]
    
    # Sign document
    sign_result = sign.sign("SampleSigned.pdf", list_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-form-field-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide explains how to use [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) to add form field signatures to documents. It covers loading a document, configuring form field properties such as name, type, and value, and saving the signed document. Advanced options, like customizing field appearance and placement, are also included. For more details, refer to related guides on document signing techniques.


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF documents for free, you can use the [Digital Signature - PDF](https://products.groupdocs.app/signature/pdf) online application.

To sign Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign document with Barcode signature and additional settings

Path: /signature/net/sign-document-with-barcode-signature-and-additional-settings/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [BarcodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions) class to specify additional options for Barcode signature to specify following signature appearance

* signature alignment ([HorizontalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/horizontalalignment), [VerticalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/verticalalignment))
* margins ([Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/margin))
* border and background settings ([Border,](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/border) [Background](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/background))
* font and colors ([Font](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/font), [Forecolor](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/forecolor))

Here are the steps to add Barcode signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the  [BarcodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions) object with all required additional options.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [BarcodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add Barcode signature to document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult).

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    // create barcode option with predefined barcode text
    BarcodeSignOptions options = new BarcodeSignOptions("12345678")
    {
        // setup Barcode encoding type
        EncodeType = BarcodeTypes.Code128,
        // set signature position
        Left = 100,
        Top = 100,
        // set signature alignment
        // when VerticalAlignment is set the Top coordinate will be ignored.
        // Use Margin properties Top, Bottom to provide vertical offset
        VerticalAlignment = Domain.VerticalAlignment.Top,
        // when HorizontalAlignment is set the Left coordinate will be ignored.
        // Use Margin properties Left, Right to provide horizontal offset
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Top = 20, Right = 20 },
        // adjust signature appearance
        // setup signature border
        Border = new Border()
        {
            Color = Color.DarkGreen,
            DashStyle = DashStyle.DashLongDashDot,
            Transparency = 0.5,
            Visible = true,
            Weight = 2
        },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
        // specify position of text with barcode line
        CodeTextAlignment = CodeTextAlignment.Above,
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new LinearGradientBrush(Color.LimeGreen, Color.DarkGreen)
        }
    };
    // sign document to file
    SignResult signResult = signature.Sign("SampleSigned.docx", options);
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign documents with encrypted QR-code text

Path: /signature/net/sign-documents-with-encrypted-qr-code-text/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to secure QR-code signature text with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype)), string value key and string value salt.

Here are the steps to secure QR-code text with standard encryption with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class and pass source document path or stream as a constructor parameter.
* Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class with required algorithm and secure pair key/salt
* Create objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) class and setup property [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/dataencryption) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption)
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.

This example shows how to sign document with secure QR-code signature text.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // setup key and passphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    // setup QR-Code options
    QrCodeSignOptions options = new QrCodeSignOptions()
    {
        //setup text to be secured
        Text = "This is private text to be secured.",
        EncodeType = QrCodeTypes.QR,
        // specify text encryption
        DataEncryption = encryption,
        // locate and aligh signature
        Height = 100,
        Width = 100,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() {  Right = 10, Bottom = 10}
    };
    // sign document to file
    signature.Sign("QRCodeEncryptedText.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign document with Form Field signature

Path: /signature/java/esign-document-with-form-field-signature/

## What is a Form Field?

A **form field** is the interactive element located on document page that allows user data input through various control types like free input text box, multi-line text box, check boxes, drop down lists etc. Different document types support specific list of form field types. These elements are used to collect information from user on template form. Each Form Field element has an unique name, settings and value field. Form Fields should have unique names within the form. Picture below demonstrates possible document page with form fields.

![](/signature/java/images/esign-document-with-form-field-signature.png)

## How to eSign document with Form Field signature

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) for Java supports creation of new form fields or update existing ones within the documents. Class [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) specifies different options for Form Field signature.   
The [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions)  class contains one [FormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/FormFieldSignature) object to put to the document.  
Here are the list of different Form Field signature classes that could be set to [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/FormFieldSignature) 

*   [TextFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/TextFormFieldSignature) - represents text input form field on document page.      
*   [CheckboxFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/CheckboxFormFieldSignature) - represents check box field on the document page.
*   [DigitalFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/DigitalFormFieldSignature) - represents digital signature input form on document page. 

Here are the steps to add Form Field signatures into document with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
*   Instantiate the [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) object according to your requirements;    
*   Instantiate one of the objects  - [TextFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/TextFormFieldSignature), [CheckboxFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/CheckboxFormFieldSignature) or [DigitalFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/DigitalFormFieldSignature);    
*   Set [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) Signature property with created object;      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions))  method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) to it.    

*NOTE: At the moment GroupDocs.Signature supports creation of Form Field signatures for PDF documents only.*

This example shows how to sign PDF document with Form Field electronic signature on document page. 

```java
Signature signature = new Signature("sample.pdf");

// instantiate text form field signature
FormFieldSignature textSignature = new TextFormFieldSignature("FieldText", "Value1");
// instantiate options based on text form field signature
FormFieldSignOptions options = new FormFieldSignOptions(textSignature);

options.setHorizontalAlignment(HorizontalAlignment.Left);
options.setVerticalAlignment(VerticalAlignment.Top);
options.setMargin(new Padding(10, 20, 0, 0));
options.setHeight(10);
options.setWidth(100);

// sign document to file
signature.sign("signed.pdf", options);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## eSign Presentation with Metadata signature

Path: /signature/java/esign-presentation-with-metadata-signature/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [PresentationMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/PresentationMetadataSignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) instance to sign Presentation document files.   
Presentation document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Presentation document metadata contains pair of Name and Value, Name should be unique within the document.  
Presentation document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there. 

 Here are the steps to add metadata signatures into Presentation document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements.    
*   Instantiate one or several[PresentationMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/PresentationMetadataSignature) objects and add them into  [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to metadata signatures collection ([getSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#getSignatures())) via [add](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignatureCollection#add(com.groupdocs.signature.domain.signatures.metadata.MetadataSignature)) or addRange method.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it.
    

## How to eSign Presentation with Metadata signature

This example shows how to add Metadata signature to Presentation document.

```java
Signature signature = new Signature("sample.ppsx");
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();

// Create few Presentation Metadata signatures
PresentationMetadataSignature[] signatures = new PresentationMetadataSignature[]
        {
                new PresentationMetadataSignature("Author", "Mr.Scherlock Holmes"),
                new PresentationMetadataSignature("DateCreated", new Date()),
                new PresentationMetadataSignature("DocumentId", 123456),
                new PresentationMetadataSignature("SignatureId", 123.456)
        };
options.getSignatures().addRange(signatures);

// sign document to file
signature.sign("SampleSigned.ppsx", options);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update QR-code signatures in document

Path: /signature/java/update-qr-code-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) class to manipulate QR-code signatures location, size, encode type and textual content. 

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to update QR-code signature in the document with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/QrCodeSearchOptions) object with desired properties;
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [QrCodeSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature); 
*   Select from list [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) object(s) that should be updated;  
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.    

This example shows how to update QR-code signature that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("signed.pdf");
 
try
{
    QrCodeSearchOptions options = new QrCodeSearchOptions();
    // search for QRCode signatures in document
    List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class, options);
    if (signatures.size() > 0)
    {
        QrCodeSignature qrCodeSignature = signatures.get(0);
        qrCodeSignature.setLeft(10);
        qrCodeSignature.setTop(10);
        boolean result = signature.update("signed-output.pdf", qrCodeSignature);
        if (result)
        {
            System.out.print("Signature with QR-Code '"+qrCodeSignature.getText()+"' and encode type '"+qrCodeSignature.getEncodeType().getTypeName()+"' was deleted from document ['signed-output.pdf'].");
        }
        else
        {
            System.out.print("Signature was not deleted from the document! Signature with Barcode '"+qrCodeSignature.getText()+"' and encode type '"+qrCodeSignature.getEncodeType().getTypeName()+"' was not found!");
        }
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update QR-code signatures in document

Path: /signature/net/update-qr-code-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) class to manipulate QR-code signatures location, size, encode type and textual content.
Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to update QR-code signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [QrCodeSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature);
* Select from list [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.

This example shows how to update QR-code signature that was found using  [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.pdf"))
{
    QrCodeSearchOptions options = new QrCodeSearchOptions();
    // search for QRCode signatures in document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    if (signatures.Count > 0)
    {
        QrCodeSignature qrCodeSignature = signatures[0];
        // change position
        qrCodeSignature.Left = 100;
        qrCodeSignature.Top = 100;
        bool result = signature.Update(qrCodeSignature);
        if (result)
        {
            Console.WriteLine(
                $"Signature with QR-Code '{qrCodeSignature.Text}' " +
                $"was updated in the document."
            );
        }
        else
        {
            Console.WriteLine("Signature was not deleted from the document!");
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign document with Swiss QR Barcode signature

Path: /signature/net/sign-document-with-swiss-qr/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [SwissQR](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/swissqr/) class to create Swiss QR. The Swiss QR Barcode is used mostly in the QR-bill, which is a document designed to replace the payment slips and currently used in payment transactions in Switzerland.

Here are the steps how to add Swiss QR signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the  [SwissQR](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/swissqr/) object with all required additional options.
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/) object with all required additional options and set SwissQR object into Data property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

```csharp
using (Signature signature = new Signature(filePath))
{
    // create SwissQR data object
    var swissQR = new SwissQR()
    {
        Account = "CH4431999123000889012",
        Amount = 1000.25m,
        Currency = "CHF",
        Reference = "210000000003139471430009017",
        Creditor = new SwissAddress
        {
            Name = "Muster & Söhne",
            Street = "Musterstrasse",
            HouseNo = "12b",
            PostalCode = "8200",
            Town = "Zürich",
            CountryCode = "CH"
        },

        Debtor = new SwissAddress
        {
            Name = "Muster AG",
            Street = "Musterstrasse",
            HouseNo = "1",
            PostalCode = "3030",
            Town = "Bern",
            CountryCode = "CH"
        }
    };

    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        Left = 100,
        Top = 100,
        // setup Data property to SwissQR instance
        Data = swissQR
    };

    // sign document to file
    var signResult = signature.Sign(outputFilePath, options);
            
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Deleting multiple signatures of different types

Path: /signature/java/deleting-multiple-signatures-of-different-types/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides different classes of signatures to manipulate and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method.

Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. This method returns [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) object that contains list of successfully updated signatures and ones that failed. The signature could be failed to delete due to several reasons:

*   if signature object was initialized with constructor by incorrect signature identifier;
*   if signature object was not found;
*   there was an error occurred while deleting signature in the document;
*   the signature type is not supported for deletion for current version (for version 19.12 these signatures are Digital, Form Field or Metadata signature).

Here are the steps to delete multiple signature in the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate one or several Search options with desired properties;
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method and pass created list of Search Options to obtain list of [BaseSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature);  
    
*   Select from list [BaseSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature) object(s) that should be deleted;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not.

## Delete multiple signatures in the document

This example shows how to delete multiple signatures that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("signed.docx")
 
// define few search options
BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
// add options to list
List<SearchOptions> listOptions = new ArrayList<SearchOptions>();
listOptions.add(barcodeOptions);
listOptions.add(qrCodeOptions);
 
// search for signatures in document
SearchResult result = signature.search(listOptions);
if (result.getSignatures().size() > 0)
{
    System.out.print("Trying to delete signatures...");
    List<BaseSignature> signaturesToDelete = new ArrayList<BaseSignature>();
    // collect image signatures to delete
    for (BaseSignature temp : result.getSignatures())
    {
        signaturesToDelete.add(temp);
    }
    // delete signatures
    DeleteResult deleteResult = signature.delete("signed.docx",signaturesToDelete);
    if (deleteResult.getSucceeded().size() == signaturesToDelete.size())
    {
        System.out.print("All signatures were successfully deleted!");
    }
    else
    {
        System.out.print("Successfully deleted signatures : " + deleteResult.getSucceeded().size());
        System.out.print("Not deleted signatures : " + deleteResult.getFailed().size());
    }
    System.out.print("List of deleted signatures:");
    for(BaseSignature temp : deleteResult.getSucceeded())
    {
        System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }
}
else
{
    System.out.print("No one signature was found.");
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Deleting multiple signatures of different types

Path: /signature/net/deleting-multiple-signatures-of-different-types/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides different classes of signatures to manipulate and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.

Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. This method returns [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) object that contains list of successfully updated signatures and ones that failed. The signature could be failed to delete due to several reasons:

* if signature object was initialized with constructor by incorrect signature identifier;
* if signature object was not found;
* there was an error occurred while deleting signature in the document;
* the signature type is not supported for deletion for current version (for version 19.12 these signatures are Digital, Form Field or Metadata signature).

Here are the steps to delete multiple signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several Search options with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method and pass created list of Search Options to obtain list of [BaseSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature);
* Select from list [BaseSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature) object(s) that should be deleted;  
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

## Delete multiple signatures in the document

This example shows how to delete multiple signatures that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.docx"))
{
    // define few search options
    BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
    QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
    // add options to list
    List<SearchOptions> listOptions = new List<SearchOptions>();
    listOptions.Add(barcodeOptions);
    listOptions.Add(qrCodeOptions);
    // search for signatures in document
    SearchResult result = signature.Search(listOptions);
    if (result.Signatures.Count > 0)
    {
        Console.WriteLine("Trying to delete signatures...");
        List<BaseSignature> signaturesToDelete = new List<BaseSignature>();
        // collect image signatures to delete
        foreach (BaseSignature temp in result.Signatures)
        {
            if (temp.SignatureType == SignatureType.Image)
            {
                signaturesToDelete.Add(temp);
            }
        }
        // delete signatures
        DeleteResult deleteResult = signature.Delete(signaturesToDelete);
        if (deleteResult.Succeeded.Count == signaturesToDelete.Count)
        {
            Console.WriteLine("All signatures were successfully deleted!");
        }
        else
        {
            Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
            Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
        }
        Console.WriteLine("List of deleted signatures:");
        foreach (BaseSignature temp in deleteResult.Succeeded)
        {
            Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
        }
    }
    else
    {
        Console.WriteLine("No one signature was found.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete QR-code signatures from documents

Path: /signature/java/delete-qr-code-signatures-from-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [QrCodeSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/QrCodeSignature) class to manipulate QR-code signatures and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method.

Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete QR-code signature from the document with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [QrCodeSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/QrCodeSignature);
*   Select from list [QrCodeSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/QrCodeSignature) object(s) that should be removed from the document;
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    
This example shows how to delete QR-code signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
Signature signature = new Signature("signed.docx");
try
{
    QrCodeSearchOptions options = new QrCodeSearchOptions();
    // search for QRCode signatures in document
    List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class, options);
    if (signatures.size() > 0)
    {
        QrCodeSignature qrCodeSignature = signatures.get(0);
        boolean result = signature.delete("signed-output.docx",qrCodeSignature);
        if (result)
        {
            System.out.print("Signature with QR-Code "+qrCodeSignature.getText()+" and encode type "+qrCodeSignature.getEncodeType().getTypeName()+" was deleted from document [signed-output.docx].");
        }
        else
        {
            System.out.print("Signature was not deleted from the document! Signature with Barcode "+qrCodeSignature.getText()+" and encode type "+qrCodeSignature.getEncodeType().getTypeName()+" was not found!");
        }
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete QR-code signatures from documents

Path: /signature/net/delete-qr-code-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) class to manipulate QR-code signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.
## How to delete QR-code signature from the document
Here are the steps to delete QR-code signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature);
* Select from list [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.

This example shows how to delete QR-code signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("signed.docx"))
{
    QrCodeSearchOptions options = new QrCodeSearchOptions();
    // search for QRCode signatures in document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    if (signatures.Count > 0)
    {
        QrCodeSignature qrCodeSignature = signatures[0];
        bool result = signature.Delete(qrCodeSignature);
        if (result)
        {
            Console.WriteLine($"Signature with QR-Code '{qrCodeSignature.Text}' was deleted.");
        }
        else
        {
            Console.WriteLine($"Signature was not deleted from the document!");
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Updating multiple signatures of different types

Path: /signature/net/updating-multiple-signatures-of-different-types/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides different classes of signatures to manipulate them by changing its properties over [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) object to analyze if signatures were successfully processed.

Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. The [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) contains list of successfully updated signatures and ones that failed. The signature could be failed to update due to several reasons:

* if signature object was initialized with constructor by incorrect signature identifier;
* if signature object was not found;
* there was an error occurred while updating signature in the document;
* the signature type is not supported for modification (Digital, Form Field or Metadata signature).

Here are the steps to update multiple signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several Search options with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method and pass created list of Search Options to obtain list of [BaseSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature);
* Select from list [BaseSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

## Update multiple signatures of different types in the document

This example shows how to update signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.pptx"))
{
    // define few search options
    BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
    QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
    // add options to list
    List<SearchOptions> listOptions = new List<SearchOptions>();
    listOptions.Add(barcodeOptions);
    listOptions.Add(qrCodeOptions);
    // search for signatures in document
    SearchResult result = signature.Search(listOptions);
    if (result.Signatures.Count > 0)
    {
        Console.WriteLine("\nTrying to update all signatures...");
        // mark all signatures as actual Signatures
        foreach (BaseSignature baseSignature in result.Signatures)
        {
            baseSignature.IsSignature = true;
        }
        // update all found signatures
        UpdateResult updateResult = signature.Update(result.Signatures);
        if (updateResult.Succeeded.Count == result.Signatures.Count)
        {
            Console.WriteLine("\nAll signatures were successfully updated!");
        }
        else
        {
            Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
            Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
        }
        Console.WriteLine("\nList of updated signatures:");
        int number = 1;
        foreach (BaseSignature temp in updateResult.Succeeded)
        {
            Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
        }
    }
    else
    {
        Console.WriteLine("No one signature was found.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Composing signature with solid brush background

Path: /signature/net/composing-signature-with-solid-brush-background/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [SolidBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/solidbrush) class to specify solid filling signature background for Text and Stamp signature types

Here are the steps to add Text signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with all required additional options and setup [Background.Brush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/background/brush) property with instance of [SolidBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/solidbrush)
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.

* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

This example shows how to add Text signature with solid brush background. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // adjust signature appearance brush

        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new SolidBrush(Color.LimeGreen)
        },
        // locate signature
        Width = 100,
        Height = 80,
        VerticalAlignment = Domain.VerticalAlignment.Center,
        HorizontalAlignment = Domain.HorizontalAlignment.Center,
        Margin = new Padding() { Top = 20, Right = 20 },

        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image
    };
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete QR-Code signatures from documents

Path: /signature/python-net/delete-qr-code-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [QrCodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/qrcodesignature) class to manipulate QR-Code signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

## How to delete QR-Code signature from the document
Here are the steps to delete QR-Code signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain list of [QrCodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/qrcodesignature);
* Select from list [QrCodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/qrcodesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.  

This example shows how to delete QR-Code signature that was found using [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method.

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeSearchOptions

# Initialize signature
with signature.Signature("signed.pptx") as sign:
    # Create search options
    options = QrCodeSearchOptions()
    
    # Search for QR-Code signatures in the document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        qr_code_signature = signatures[0]
        result = sign.delete(qr_code_signature)
        
        if result:
            print(
                f"QR-Code signature at location {qr_code_signature.left}x{qr_code_signature.top} "
                f"and size {qr_code_signature.size} was deleted from document ['{fileName}']."
            )
        else:
            print(
                f"Signature was not deleted from the document! "
                f"Signature at location {qr_code_signature.left}x{qr_code_signature.top} "
                f"and size {qr_code_signature.size} was not found!"
            )
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Advanced search for QR-code signatures

Path: /signature/java/advanced-search-for-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) class to specify different options to search for QR-code signatures.

Here are the steps to search for barcode signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object according to your requirements and specify search options 
*   Call[search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) to it.
    

This example shows how to make advanced search for QR-code signature in the document.

```java
Signature signature = new Signature("sample.pdf");
QrCodeSearchOptions options = new QrCodeSearchOptions();
options.setAllPages(true); // this value is set by default
// single page number
options.setPageNumber(1);
// setup extended search in pages setup
PagesSetup pagesSetup  = new PagesSetup() ;
pagesSetup.setFirstPage(true);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(false);
options.setPagesSetup(pagesSetup);
 
// specify special barcode type to search
options.setEncodeType(QrCodeTypes.QR);
// specify text match type
options.setMatchType(TextMatchType.Exact);
// specify text pattern to search
options.setText("12345678");
 
// search for signatures in document
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (QrCodeSignature qrCodeSignature : signatures)
{
    System.out.print("QRCode signature found at page "+qrCodeSignature.getPageNumber() +" with type "+qrCodeSignature.getEncodeType() +" and text "+ qrCodeSignature.getText());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Advanced search for QR Code signatures

Path: /signature/net/advanced-search-for-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) class to specify different options to search for QR-code signatures.

Here are the steps to search for barcode signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object according to your requirements and specify search options
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) to it.

This example shows how to make advanced search for QR-code signature in the document with enabled options of grabbing QR-code image content.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    QrCodeSearchOptions options = new QrCodeSearchOptions()
    {
        // specify special pages to search on
        AllPages = false,
        PageNumber = 1,
        PagesSetup = new PagesSetup() { FirstPage = true, LastPage = true, OddPages = false, EvenPages = false },
        // specify special QRCode type to search
        EncodeType = QrCodeTypes.Aztec,
        // specify text match type
        MatchType = TextMatchType.Contains,
        // specify text pattern to search
        Text = "John",
        // set field for QRCode images returning
        ReturnContent = true,
        // specify type of returned QRCode images
        ReturnContentType = FileType.PNG
    };
    // search for signatures in document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options); //For evaluation version is 0
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (QrCodeSignature qrCodeSignature in signatures)
    {
        Console.WriteLine("QRCode signature found at page {0} with type {1} and text {2}", qrCodeSignature.PageNumber, qrCodeSignature.EncodeType, qrCodeSignature.Text);
        Console.WriteLine("QRCode signature size {0} and format {1}", qrCodeSignature.Content?.Length, qrCodeSignature.Format);
        Console.WriteLine($"Location at {qrCodeSignature.Left}-{qrCodeSignature.Top}. Size is {qrCodeSignature.Width}x{qrCodeSignature.Height}.");
    }
    //Save QRCode images
    string outputPath = System.IO.Path.Combine(Constants.OutputPath, "SearchForQRCodeAdvanced");
    if (!Directory.Exists(outputPath))
    {
        Directory.CreateDirectory(outputPath);
    }
    int i = 0;
    foreach (QrCodeSignature qrCodeSignature in signatures)
    {
        string outputFilePath = System.IO.Path.Combine(outputPath, $"image{i}{qrCodeSignature.Format.Extension}");
        using (FileStream fs = new FileStream(outputFilePath, FileMode.Create))
        {
            fs.Write(qrCodeSignature.Content, 0, qrCodeSignature.Content.Length);
        }
        i++;
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for QR Code standard entries

Path: /signature/net/advanced-search-for-qr-code-standard-entries/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into QR-code signature standard entries like email, contact v-card, address etc, WiFi, contact MeCard. This feature supports standard QR-code representation of entries. At this moment following standard QR-code entries are supported

* [Email](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/email) entry that allows to specify in QR-code standard email information with recipient, subject and body.
* [Address](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/address) entry contains address information.
* [V-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/vcard) entry implements standard of visit card 3.0 specification. More details could be found [here](https://en.wikipedia.org/wiki/VCard).
* [Me-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/mecard) entry implements similar to V-Card contact details standard. More details could be found [here](https://en.wikipedia.org/wiki/MeCard_(QR_code)).
* [EPC](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/epc) implements standard of the European Payments Council guidelines define the content of a QR code that can be used to initiate [SEPA](https://en.wikipedia.org/wiki/SEPA_credit_transfer) credit transfer. More details could be found [here](https://en.wikipedia.org/wiki/EPC_QR_code).
* [Event](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/event) entry implements event standard.
* [WiFi](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/wifi) entry implements WiFI settings standard.
* [SMS](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/sms) entry implements sms properties.
* [CryptoCurrencyTransfer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/cryptocurrencytransfer/) entry implements event standard.

Here are the steps to extract standard entry frmo the QR-code signature with GroupDocs.Signature:  

* Create new instance of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Call the generic [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search/#search_2/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) with the [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature/) generic type and pass [SignatureType.QRCode](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signaturetype/) to it.
* Enumarate the response with the list of the [QrCodeSignature] (https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature/) signatures and call generic [GetData] (https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature/getdata/#getdata) method to retrieve the required instance of the object

## Example 1: How to get Address QR Code object in the document 

Following example shows how to search for QR-code Address object in the PDF document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    var signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    foreach (var qrSignature in signatures)
    {
        var address = qrSignature.GetData<Address>();
        if (address != null)
        {
            Console.WriteLine($"Found Address: {Address.Country} {Address.State} {Address.City} {Address.ZIP}");
        }
    }
}
```

## Example 2 : how to get Email QR Code object in the document 

Following example shows how to search for QR-code Email object in the PDF document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    var signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    foreach (var qrSignature in signatures)
    {
        var email = qrSignature.GetData<Email>();
        if (email != null)
        {
            Console.WriteLine($"Found Email signature: {email.Address}: [{email.Subject}] : {email.Body}");
        }
    }
}
```

## Example 3 : how to retrieve VCard QR Code object from image or document 

Following example shows how to retrieve contact VCard object from the QR Code signature.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    var signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    foreach (var qrSignature in signatures)
    {
        var vCard = qrSignature.GetData<VCard>();
        if (vCard != null)
        {
            Console.WriteLine($"Found VCard signature: {vcard.FirstName} {vcard.LastName} from {vcard.Company}. Tel: {vcard.CellPhone}");
        }
    }
}
```

## Example 4 : How to find the EPC data in the QR Code from image or document 

Following example shows to find the EPC (The European Payments Council Quick Response Code) data in the QR Code from image or document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    var signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    foreach (var qrSignature in signatures)
    {
        var payment = qrSignature.GetData<EPC>();
        if (payment != null)
        {
            Console.WriteLine($"EPC: {payment.Name}, IBAN {payment.IBAN}. Amount {payment.Amount}. Ref: {payment.Reference} / {payment.Remittance}");
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Locating signature with stretch mode

Path: /signature/java/locating-signature-with-stretch-mode/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to stretch signature area along page width or height. Use enumeration [StretchMode](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/StretchMode) contains following values

*   [None](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/StretchMode#None) - no stretch will be applied 
*   [PageWidth](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/StretchMode#PageWidth) -  to stretch signature area along page width
*   [PageHeight](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/StretchMode#PageHeight) - to stretch signature area along page height
*   [PageArea](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/StretchMode#PageArea) - to stretch signature area along page width and height

Here are the steps to use stretch mode with adding text or images signatures into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) or [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions)  object with all required additional options and setup [setStretch](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setStretch(int)) property      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20java.util.List)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and the instance of signature options ([ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) for example) to it.
    

## Locate Signature Area with Stretch Mode

This example shows how to locate signature with stretch mode.

```java
// instantiating the signature object
final Signature signature = new Signature("sample.pdf");
 
// define several signature options of different types and settings
TextSignOptions textOptions = new TextSignOptions("This is test message");
textOptions.setAllPages(true);
textOptions.setVerticalAlignment(VerticalAlignment.Top);
textOptions.setMargin(new Padding(50));
textOptions.setStretch(StretchMode.PageWidth);
 
BarcodeSignOptions barcodeOptions = new BarcodeSignOptions("123456");
barcodeOptions.setAllPages(true);
barcodeOptions.setEncodeType(BarcodeTypes.Code128);
barcodeOptions.setVerticalAlignment(VerticalAlignment.Bottom);
barcodeOptions.setMargin(new Padding(50));
barcodeOptions.setStretch(StretchMode.PageWidth);
 
ImageSignOptions imageOptions = new ImageSignOptions();
imageOptions.setAllPages(true);
imageOptions.setStretch(StretchMode.PageHeight);
imageOptions.setHorizontalAlignment(HorizontalAlignment.Right);
imageOptions.setImageFilePath("image.png");
 
// define list of signature options
List<SignOptions> listOptions = new ArrayList<SignOptions>();
listOptions.add(textOptions);
listOptions.add(barcodeOptions);
listOptions.add(imageOptions);
// sign document to file
SignResult signResult = signature.sign("signed.pdf", listOptions);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update QR Code Signatures in Document

Path: /signature/python-net/update-qr-code-signatures-in-document/

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides functionality to manipulate QR code signatures' location, size, encode type, and textual content.
Please note that the [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method modifies the same document that was passed to the constructor of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

Here are the steps to update a QR code signature in a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter
* Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesearchoptions) object with desired properties
* Call the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain a list of QR code signatures
* Select from the list the [QrCodeSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/qrcodesignature) object(s) that should be updated
* Call the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object's [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method and pass one or several signatures to it

This example shows how to update a QR code signature that was found using the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeSearchOptions

# Initialize signature
with signature.Signature("signed.pdf") as sign:
    # Create search options
    options = QrCodeSearchOptions()
    
    # Search for QR code signatures in document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        # Get first QR code signature
        qr_code_signature = signatures[0]
        
        # Change position
        qr_code_signature.left = 100
        qr_code_signature.top = 100
        
        # Update the signature
        result = sign.update(qr_code_signature)
        
        if result.updated_count > 0:
            print(f"Signature with QR code '{qr_code_signature.text}' was updated in the document")
        else:
            print("Signature was not updated in the document!")
```


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Search for Image e-Signatures

Path: /signature/python-net/search-for-image-e-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/python-net) provides the ability to search for image electronic signatures in documents. Image signatures allow you to add visual elements like logos, stamps, or handwritten signatures to your documents.

## What is an Image Signature?

An image signature is a graphical element that can be added to a document to represent a signature. It can be:
- A scanned handwritten signature
- A company logo
- A stamp or seal
- Any other graphical element used for signing

## How to Search for Image Signatures

The [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class provides the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method which allows you to search for image signatures in documents. Here's how to use it:

1. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class and pass the source document path as a parameter.
2. Create an instance of [ImageSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/imagesearchoptions/) class.
3. Call the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class instance and pass the search options to it.
4. Process the search results.

Here's an example of how to search for image signatures in a document:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import ImageSearchOptions
from groupdocs.signature.domain import ImageSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = ImageSearchOptions()
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} image signatures")
    for image_signature in result:
        print(f"Page: {image_signature.page_number}")
        print(f"Position: X={image_signature.left}, Y={image_signature.top}")
        print(f"Size: Width={image_signature.width}, Height={image_signature.height}")
```

## Advanced Search Options

You can customize the search process by setting specific options:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import ImageSearchOptions
from groupdocs.signature.domain import ImageSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = ImageSearchOptions()
    
    # Set search criteria
    search_options.page_number = 1  # Search on specific page
    search_options.all_pages = False  # Search only on specified page
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} image signatures")
    for image_signature in result:
        print(f"Page: {image_signature.page_number}")
        print(f"Position: X={image_signature.left}, Y={image_signature.top}")
        print(f"Size: Width={image_signature.width}, Height={image_signature.height}")
```

## Additional Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our examples:

* [GroupDocs.Signature for Python via .NET Examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)
* [GroupDocs.Signature for Python via .NET Plugins](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Plugins)
* [GroupDocs.Signature for Python via .NET Showcase Apps](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Showcase)

### Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to search for image signatures in documents with our free online apps:

* [Search for Image Signatures Online](https://products.groupdocs.app/signature/search/family)

---

## Search for Metadata e-signatures

Path: /signature/java/search-for-metadata-e-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides a [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) class to search Metadata electronic signatures within document.  
Here are the steps to search for Metadata signatures using GroupDocs.Signature API:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) object according to your requirements and specify additional search options (if needed);  
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) to it.
    

This code snippet demonstrates how to search for Metadata e-signature in the document.

```java
Signature signature = new Signature("sample.pdf");
MetadataSearchOptions options = new MetadataSearchOptions();

// search for signatures in document
List<MetadataSignature> signatures = signature.search(MetadataSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (MetadataSignature metadataSignature : signatures)
{
    System.out.print("Metadata signature found. Name : "+metadataSignature.getName()+". Value: "+ metadataSignature.getValue());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to search for QR code signatures

Path: /signature/net/search-for-qr-code-e-signatures/

When you search for electronic signatures of QR-Code type inside document with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) it's only needed to [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object to Search method.
Here are the quick guide of how to search for QR-code signatures:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object according to your requirements and specify search options;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) to it.

The code snippet below demonstrates search for QR-code signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // search for signatures in document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);

    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var QrCodeSignature in signatures)
    {
        Console.WriteLine("QRCode signature found at page {0} with type {1} and text {2}",
            QrCodeSignature.PageNumber, QrCodeSignature.EncodeType, QrCodeSignature.Text);
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## How to Search for QR Code Signatures

Path: /signature/python-net/search-for-qr-code-e-signatures/

When you search for electronic signatures of QR-Code type inside a document with [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net), you only need to pass a [QrCodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesearchoptions) object to the search method.

Here's a quick guide on how to search for QR-code signatures:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesearchoptions) object according to your requirements and specify search options.
* Call the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [QrCodeSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesearchoptions) to it.

The code snippet below demonstrates how to search for QR-code signatures in a document using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeSearchOptions
import groupdocs.signature.domain as gsd
# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Search for signatures in document
    signatures = sign.search(gsd.SignatureType.QR_CODE)
    
    print("\nSource document contains the following signatures:")
    for qr_code_signature in signatures:
        print(f"QR Code signature found at page {qr_code_signature.page_number} "
              f"with type {qr_code_signature.encode_type} and text {qr_code_signature.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/search-for-electronic-signatures-in-document/search-for-qr-code-e-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Search Options

Here's an example showing how to use more advanced search options for QR codes:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeSearchOptions
from groupdocs.signature.domain import QrCodeTypes

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create search options
    search_options = QrCodeSearchOptions()
    
    # Search on specific pages
    search_options.page_number = 1
    search_options.all_pages = False
    
    # Search for specific QR code type
    search_options.encode_type = QrCodeTypes.QR
    
    # Search for specific text in QR code
    search_options.text = "John"
    
    # Search document
    signatures = sign.search(search_options)
    
    # Process found signatures
    for qr_code_signature in signatures:
        print(f"Found QR Code signature: {qr_code_signature.text}")
        print(f"Page number: {qr_code_signature.page_number}")
        print(f"Position: X={qr_code_signature.left}, Y={qr_code_signature.top}")
        print(f"Size: {qr_code_signature.width}x{qr_code_signature.height}")
        print(f"Encode type: {qr_code_signature.encode_type}")
        print(f"Error correction level: {qr_code_signature.error_correction_level}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/search-for-electronic-signatures-in-document/search-for-qr-code-e-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add distance annotation

Path: /annotation/java/add-distance-annotation/

Distance annotation shows a distance between objects in a document as shown in the picture below: 

![](/annotation/java/images/add-distance-annotation.png)

You can use the following methods to set the properties of the [DistanceAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation) class:

*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines annotation position on a page
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPenColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation/#setPenColor-java.lang.Integer-) defines the annotation color
*   [setPenStyle()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation/#setPenStyle-java.lang.Byte-) defines the annotation line style (solid, dash, dot etc.)
*   [setPenWidth()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation/#setPenWidth-java.lang.Byte-) defines the line width in pixels

  
To add a distance annotation to document, follow these steps:  

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [DistanceAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation) class. Set the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [DistanceAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.  
      
The following code snippet shows how to add [DistanceAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/distanceannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding distance annotation.

Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of DistanceAnnotation class and set options
    DistanceAnnotation distance = new DistanceAnnotation();
    distance.setBox(new Rectangle(200, 150, 200, 30));
    distance.setCreatedOn(Calendar.getInstance().getTime());
    distance.setMessage("This is distance annotation");
    distance.setOpacity(0.7);
    distance.setPageNumber(0);
    distance.setPenColor(65535);
    distance.setPenStyle(PenStyle.Dot);
    distance.setPenWidth((byte) 3);
    distance.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(distance);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Add distance annotation

Path: /annotation/net/add-distance-annotation/

Distance annotation shows a distance between objects in a document as shown in the picture below: 

![](/annotation/net/images/add-distance-annotation.png)

You can set the following properties of the [DistanceAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/distanceannotation) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/box) defines annotation position on a page
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/opacity) allows you to set the annotation opacity
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/pencolor) defines the annotation color
*   [PenStyle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penstyle) defines the annotation line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penwidth) defines the line width in pixels

  
To add a distance annotation to document, follow these steps:  

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [DistanceAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/distanceannotation) class. Set the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [DistanceAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/distanceannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.  
      
    

The following code snippet shows how to add [DistanceAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/distanceannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add distance annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	DistanceAnnotation distance = new DistanceAnnotation
    {
        Box = new Rectangle(200, 150, 200, 30),
        CreatedOn = DateTime.Now,
        Message = "This is distance annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = 65535,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(distance);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Add document to Presentation via OLE

Path: /merger/java/add-document-to-presentation-via-ole/

## What is OLE object for Presentation?

The "Object Linking and Embedding" technology helps to embed some other document in the currently editing Presentation one. For this case, the frame object is using for the embedded document content. The Word and PDF documents, Excel and Oped Document format spreadsheets and other document types can be embedded in a PowerPoint presentation as frame that is predefined with X and Y coordinates and it's size.

## Add document to Presentation via OLE

**[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** provides an ability to add other single document as embedded document to Presentation.   
Here are the steps for it:

*   Initialise [OlePresentationOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/OlePresentationOptions) class with embedded file path and page number;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) object with source document path or stream;
*   Call [importDocument](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#importDocument(com.groupdocs.merger.domain.options.interfaces.IImportDocumentOptions)) method and pass [OlePresentationOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/OlePresentationOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add other single document as embedded document to Presentation:

```java
int pageNumber = 2;
OlePresentationOptions oleSlidesOptions = new OlePresentationOptions("c:\embedded.pdf", pageNumber);
oleSlidesOptions.setX(10);
oleSlidesOptions.setY(10);
 
Merger merger = new Merger("c:\sample.ppt");
{
    merger.importDocument(oleSlidesOptions);
    merger.save("c:\output\result.ppt");
}

```

---

## Add document to Presentation via OLE

Path: /merger/net/add-document-to-presentation-via-ole/

## What is OLE object for Presentation?

The "Object Linking and Embedding" technology helps to embed some other document in the currently editing Presentation one. For this case, the frame object is using for the embedded document content. The Word and PDF documents, Excel and Oped Document format spreadsheets and other document types can be embedded in a PowerPoint presentation as frame that is predefined with X and Y coordinates and it's size.

## Add document to Presentation via OLE

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides an ability to add other single document as embedded document to Presentation.   
Here are the steps for it:

*   Initialise [OlePresentationOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/olepresentationoptions) class with embedded file path and page number;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [ImportDocument](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/importdocument) method and pass [OlePresentationOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/olepresentationoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add other single document as embedded document to Presentation:

```csharp
string filePath = @"c:\sample.ppt";
string filePathEmbedded = @"c:\embedded.pdf";
string filePathOut = @"c:\output\result.ppt";

int pageNumber = 2;
OlePresentationOptions olePresentationOptions = new OlePresentationOptions(filePathEmbedded, pageNumber);
olePresentationOptions.X = 10;
olePresentationOptions.Y = 10;

using (Merger merger = new Merger(filePath))
{
    merger.ImportDocument(olePresentationOptions);
    merger.Save(filePathOut);
}

```

---

## Add text or image watermark

Path: /watermark/java/add-text-or-image-watermark/

GroupDocs.Watermark allows adding watermarks and saving the resultant documents. The full list of supported document formats can be found [here]({{< ref "watermark/java/getting-started/supported-document-formats.md" >}}). You may add text and image watermarks to the documents from the local disk and from streams.

## Add a text watermark

The following example demonstrates how to add a [TextWatermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/TextWatermark) to a local document:

*   [Create](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#Watermarker(java.lang.String)) a watermarker for the local file (line 2);
*   [Create](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/TextWatermark#TextWatermark(java.lang.String,%20com.groupdocs.watermark.watermarks.Font)) a watermark with text and font (line 4);
*   Set the watermark [color](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/TextWatermark#setForegroundColor(com.groupdocs.watermark.watermarks.Color)), [horizontal](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setHorizontalAlignment(int)) and [vertical](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setVerticalAlignment(int)) alignments (lines 5-7);
*   [Add](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#add(com.groupdocs.watermark.Watermark)) the watermark to the document (line 9);
*   [Save](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#save(java.lang.String)) the document to the new file (line 10).
*   [Close](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#close()) the watermarker and free its resources (line 12).

**basic\_usage.AddATextWatermark**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
TextWatermark watermark = new TextWatermark("top secret", new Font("Arial", 36));                        
watermark.setForegroundColor(Color.getRed());                                                            
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                            
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                
                                                                                                         
watermarker.add(watermark);                                                                              
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                   
```

## Add an Image Watermark

The following example demonstrates how to add an [ImageWatermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark) to a document from a stream:

*   [Create](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#Watermarker(java.lang.String)) a watermarker for the file stream (line 4);
*   [Create](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark#ImageWatermark(java.lang.String)) an image watermark from the local image file (line 6);
*   Set the watermark [horizontal](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setHorizontalAlignment(int)) and [vertical](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermark#setVerticalAlignment(int)) alignments (lines 7, 8);
*   [Add](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#add(com.groupdocs.watermark.Watermark)) the watermark to the document (line 9);
*   [Save](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#save(java.lang.String)) the document to the new file (line 11).
*   [Close](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.watermarks/ImageWatermark#close()) the watermark and free its resources (line 13);
*   [Close](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#close()) the watermarker and free its resources (line 14).

**basic\_usage.AddAnImageWatermark**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.xlsx" 
FileInputStream stream = new FileInputStream("document.xlsx");                                     
                                                                                                            
Watermarker watermarker = new Watermarker(stream);                                                          
                                                                                                            
ImageWatermark watermark = new ImageWatermark("logo.png");                                           
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                               
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                   
watermarker.add(watermark);                                                                                 
                                                                                                            
watermarker.save("document.xlsx");                                                                
                                                                                                            
watermark.close();                                                                                          
watermarker.close();                                                                                      
stream.close();                                                                                             
```

---

## Adjust the JPEG image quality

Path: /viewer/java/image-viewer-adjust-quality-for-jpg/

Decreasing the JPG images quality reduces the size of the output file.

To adjust images quality, call the [setQuality()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setQuality-byte-) property of the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) class. The value must be between 1 (minimum quality) and 100. The default value is 90.

To set the image quality, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) class. Specify the source document path as a constructor parameter.
1. Instantiate the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) object.
2. Call the [setQuality()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setQuality-byte-) method.
3. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method of the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object. Specify the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) object as the parameter.

The following code snippet shows how to adjust quality of the output JPG image:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    JpgViewOptions viewOptions = new JpgViewOptions();
    viewOptions.setQuality((byte) 50);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Adjust the JPEG image quality

Path: /viewer/net/image-viewer-adjust-quality-for-jpg/

Decreasing the JPG images quality reduces the size of the output file.

To adjust images quality, set the [Quality](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions/properties/quality) property of the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) class. The value must be between 1 (minimum quality) and 100. The default value is 90.

To set the image quality, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) class. Specify the source document path as a constructor parameter.
1. Instantiate the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) object.
2. Set the [Quality](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions/properties/quality) value.
3. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method of the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) object as the parameter.

The following code snippet shows how to adjust quality of the output JPG image:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create a JPG file.
    JpgViewOptions viewOptions = new JpgViewOptions();
    
    // Specify the JPG image quality.
    viewOptions.Quality = 50;    
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create a JPG file.
            Dim viewOptions As JpgViewOptions = New JpgViewOptions()
        
            ' Specify the JPG image quality.
            viewOptions.Quality = 50
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Barcode Image Generation in Spreadsheet Document

Path: /assembly/java/barcode-image-generation-in-spreadsheet-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Barcode Generation in Microsoft Spreadsheet

### Template Syntax

*   Add a textbox to your template at the place where you want a barcode image to be inserted.
*   Add the following syntax:

```java
<<barcode [value] -itf6>>
```

### Download Template

Get the template from here.

*   [Barcode.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Barcode.xlsx?raw=true)

### The Code

{{< gist GroupDocsGists 6cbbbc4a26730834f9d428617028a33e >}}



---

## Barcode Image Generation in Spreadsheet Document

Path: /assembly/net/barcode-image-generation-in-spreadsheet-document/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.2.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Barcode Generation in Microsoft Spreadsheet

### Template Syntax

*   Add a textbox to your template at the place where you want a barcode image to be inserted.
*   Add the following syntax:

```csharp
<<barcode [customer.Barcode] -qr>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Get the template from here.

*   [Barcode.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Barcode.xlsx?raw=true)

### The Code

{{< gist GroupDocsGists fccb0d1f515216932a9c3844297d3d1e >}}

---

## Batch-convert a folder

Path: /markdown/net/batch-convert/


Convert all supported documents in a directory to Markdown files.

### Basic batch conversion

{{< tabs "batch-basic">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

string inputDir = "documents";
string outputDir = "output";

Directory.CreateDirectory(outputDir);

// Get supported extensions
var supported = new HashSet<string>(
    MarkdownConverter.GetSupportedFormats()
        .Select(f => "." + f.ToString().ToLower()));

int converted = 0;
int skipped = 0;

foreach (string file in Directory.GetFiles(inputDir))
{
    string ext = Path.GetExtension(file).ToLower();
    if (!supported.Contains(ext)) continue;

    string outputPath = Path.Combine(
        outputDir,
        Path.GetFileNameWithoutExtension(file) + ".md");

    try
    {
        MarkdownConverter.ToFile(file, outputPath);
        converted++;
        Console.WriteLine($"OK: {Path.GetFileName(file)}");
    }
    catch (Exception ex)
    {
        skipped++;
        Console.WriteLine($"SKIP: {Path.GetFileName(file)} — {ex.Message}");
    }
}

Console.WriteLine($"Done: {converted} converted, {skipped} skipped");
```
{{< /tab >}}
{{< tab "batch-basic.zip" >}}  
```text
output/business-plan.md (210 KB)
output/cost-analysis.md (9 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/use-cases/batch-convert/BatchBasic/batch-basic.zip)
{{< /tab >}}
{{< /tabs >}}

### Async batch conversion

{{< tabs "batch-async">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

string inputDir = "documents";
string outputDir = "output";

Directory.CreateDirectory(outputDir);

var files = Directory.GetFiles(inputDir, "*.*")
    .Where(f => new[] { ".docx", ".pdf", ".xlsx", ".epub" }
        .Contains(Path.GetExtension(f).ToLower()))
    .ToArray();

var options = new ConvertOptions
{
    ImageExportStrategy = new SkipImagesStrategy()
};

var tasks = files.Select(async file =>
{
    string outputPath = Path.Combine(
        outputDir,
        Path.GetFileNameWithoutExtension(file) + ".md");

    try
    {
        await MarkdownConverter.ToFileAsync(file, outputPath, options);
        Console.WriteLine($"OK: {Path.GetFileName(file)}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"SKIP: {Path.GetFileName(file)} — {ex.Message}");
    }
});

await Task.WhenAll(tasks);
```
{{< /tab >}}
{{< tab "batch-async.zip" >}}  
```text
output/business-plan.md (7 KB)
output/cost-analysis.md (9 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/use-cases/batch-convert/BatchAsync/batch-async.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Batch-convert a folder

Path: /markdown/python-net/batch-convert/


Convert all supported documents in a directory to Markdown files.

### Basic batch conversion

{{< tabs "batch-convert-basic">}}
{{< tab "batch_convert.py" >}}  
```python
import os
from groupdocs.markdown import MarkdownConverter

def batch_convert():
    """Convert all supported documents in a folder to Markdown."""

    # Step 1: Define input and output directories
    input_dir = "documents"
    output_dir = "output"
    os.makedirs(output_dir, exist_ok=True)

    converted = 0
    skipped = 0

    # Step 2: Iterate over all files in the input folder
    for filename in os.listdir(input_dir):
        file_path = os.path.join(input_dir, filename)

        # Skip directories
        if not os.path.isfile(file_path):
            continue

        # Build output path with .md extension
        output_path = os.path.join(
            output_dir,
            os.path.splitext(filename)[0] + ".md")

        try:
            # Step 3: Convert each document to Markdown
            MarkdownConverter.to_file(file_path, output_path)
            converted += 1
            print(f"  OK: {filename}")
        except Exception as ex:
            skipped += 1
            print(f"  SKIP: {filename} - {ex}")

    # Step 4: Print summary
    print(f"Done: {converted} converted, {skipped} skipped")

if __name__ == "__main__":
    batch_convert()
```
{{< /tab >}}
{{< tab "batch-convert.zip" >}}  
```text
output/business-plan.txt (288 KB)
output/cost-analysis.txt (1011 bytes)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/batch-convert/batch_convert/batch-convert.zip)
{{< /tab >}}
{{< tab "batch-convert.zip" >}}  
```text
output/business-plan.txt (287 KB)
output/cost-analysis.txt (1011 bytes)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/use-cases/batch-convert/batch_convert/batch-convert.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Bubble Chart in Presentation Document

Path: /assembly/java/bubble-chart-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bubble Chart report in Presentation Document.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bubble Chart in Microsoft PowerPoint Document

### Creating a Bubble Chart

Please follow below steps to create Bubble Chart in MS PowerPoint 2013:

1.  Add a new presentation slide, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "X Y(Scatter)" in the sidebar, you will see a gallery of charts.
3.  Select the "Bubble" and press "OK" to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/bubble-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   Retrieve total Contract Prices by Months.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>><<x [key + 1]>>
```

#### Chart Data (Excel)

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" width="623" style="width: 467.5pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">X-Values</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Total Contract Price&lt;&lt;y [sum(c =&gt; c.getPrice())]&gt;&gt;&lt;&lt;size[count()]&gt;&gt;</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Size</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.7</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.7</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">10</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.2</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.6</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.8</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">8</span></p></td></tr></tbody></table>
### Download Bubble Chart Template

Please download the sample Bubble Chart document we created in this article:

*   [Bubble Chart.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Bubble%20Chart.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists da6e26176a44307898d4616ecadd621b >}}

## Bubble Chart in OpenOffice Presentation Document

To be investigated.

---

## Bubble Chart in Presentation Document

Path: /assembly/net/bubble-chart-in-presentation-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bubble Chart in Microsoft PowerPoint Document

### Creating a Bubble Chart

Please follow below steps to create Bubble Chart in MS PowerPoint 2013:

1.  Add a new presentation slide, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "X Y(Scatter)" in the sidebar, you will see a gallery of charts.
3.  Select the "Bubble" and press "OK" to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/bubble-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   A report must show variation in the sales/orders prices.
*   It must show which sale/order lie in which month.
*   A report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Orders Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>><<x [Key]>>

```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">X-Values</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total orders by months&lt;&lt;y [Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;size [Count()]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Size</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">0.7</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">2.7</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">10</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">4</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">2.6</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 328.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">0.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 37.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">8</span></p></td></tr></tbody></table>
### Download Bubble Chart Template

Please download the sample Bubble Chart document we created in this article:

*   [Bubble Chart.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Bubble%20Chart.pptx?raw=true) (Template for CustomObject and JSON examples) 
*   [Bubble Chart\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Bubble%20Chart_DB.pptx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists c2e605d2d5fba00340f51a2e09a5bb9e >}}



#### Database Entities

{{< gist GroupDocsGists f1e9da2dfb1bbafc6437762412dc6653 >}}



#### Using DataSet

{{< gist GroupDocsGists 64eab241b98c0edad88f177e92513d8b >}}



#### Using XML DataSource

{{< gist GroupDocsGists 2a372988c264be1acfa5fd8848fc9fc6 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 7be60df67524b051e8dda43435d0b69e >}}



## Bubble Chart in OpenOffice Presentation Document

To be investigated.

---

## Bulleted List in Presentation Document

Path: /assembly/java/bulleted-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bulleted List in Microsoft PowerPoint Document

### Creating a Bulleted List

Practising the following steps you can insert Bulleted List in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Add a bullet list at the place where you want it.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must show all the clients in a bulleted list format.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
<<foreach [in getClients()]>><<[getName()]>>
<</foreach>>
```

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Bulleted%20List.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 88b769cf5394a935d690f0cb687d3558 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Bulleted List in Presentation Document

Path: /assembly/net/bulleted-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bulleted List in Microsoft PowerPoint Document

### Creating a Bulleted List

Practising the following steps you can insert Bulleted List in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Add a bullet list at the place where you want it.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share the information of the products with the following key requirements:

*   A report must show all the products in a bulleted list format.
*   A report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Bulleted%20List.pptx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Bulleted List\_XML.pptx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Bulleted%20List_XML.pptx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists bed51427de15e362dcaa0c16dd6e8e94 >}}



#### Database Entities

{{< gist GroupDocsGists bfe5bed009bd025227e3bc6fb68f9e10 >}}



#### Using DataSet

{{< gist GroupDocsGists be387a246bd2af94d9b38bfc5bb6986b >}}



#### Using XML DataSource

{{< gist GroupDocsGists 31cc8555ad883e9427094d06a484f82d >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 7b364145e5fe1c8279706088c0459273 >}}



## Bulleted List in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Bulleted List' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Bulleted List\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Bulleted%20List_OpenDocument.odp?raw=true) (use same template for database, dataset and JSON examples)
*   [Bulleted List\_XML\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Bulleted%20List_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 2c0921883aa5cf90814f6750177a746f >}}



#### Database Entities

{{< gist GroupDocsGists fe151d8f3fb60ae08a7349688eaf665e >}}



#### Using DataSet

{{< gist GroupDocsGists f796a16bce9c2a864526d434c0dcf896 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 994f15754722fd2245978b7023adf519 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists aad2aa589ce8873dc9d1ae4a7cba6c88 >}}



### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Cancel rendering

Path: /viewer/net/cancel-rendering/


Since the 21.7 version, GroupDocs.Viewer supports task cancellation using the cancellation token.

To cancel a task, follow these steps:

1. Create the [CancellationTokenSource](https://docs.microsoft.com/en-us/dotnet/api/system.threading.cancellationtokensource?view=netstandard-2.0) object.
2. Create the [CancellationToken](https://docs.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken?view=netstandard-2.0) object.
3. Create the Task object. When creating, specify the cancellation token.
4. Cancel the task.

You can cancel tasks using one of the following methods:

* To cancel the task in a specified time, call the [CancelAfter](https://docs.microsoft.com/en-us/dotnet/api/system.threading.cancellationtokensource.cancelafter?view=netstandard-2.0) method.
* To cancel the task at any time, call the [Cancel](https://docs.microsoft.com/en-us/dotnet/api/system.threading.cancellationtokensource.cancel?view=netstandard-2.0) method.

The following code snippet shows how to cancel a task:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.Diagnostics;
using System.Threading.Tasks;
using System.Threading;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Create cancellation token source.
CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
CancellationToken cancellationToken = cancellationTokenSource.Token;

// Create task and pass token
Task runTask = Task.Run(() =>
{
    using (Viewer viewer = new Viewer("sample.docx"))
    {
        HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources();
        options.RenderComments = true;
        viewer.View(options, cancellationToken);
    }
}, cancellationToken);

// Cancel task after 1000 ms.
cancellationTokenSource.CancelAfter(1000);

// Also you can call Cancel method at any time
//cancellationTokenSource.Cancel();

// Wait for the task to cancel.
Thread.Sleep(2000);

Debug.Assert(runTask.IsCanceled);
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.Threading
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Create cancellation token source.
        Dim cancellationTokenSource As CancellationTokenSource = New CancellationTokenSource()
        Dim cancellationToken As CancellationToken = cancellationTokenSource.Token

        ' Create task and pass token
        Dim runTask As Task = Task.Run(Sub()
                                           Using viewer As Viewer = New Viewer("sample.docx")
                                               Dim options As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
                                               options.RenderComments = True
                                               viewer.View(options, cancellationToken)
                                           End Using
                                       End Sub, cancellationToken)

        ' Cancel task after 1000 ms.
        cancellationTokenSource.CancelAfter(1000)

        ' Also you can call Cancel method at any time
        'cancellationTokenSource.Cancel();

        ' Wait for the task to cancel.
        Thread.Sleep(2000)

        Debug.Assert(runTask.IsCanceled)
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
If runTask.IsCancelled is `true`, then the task has been canceled.

To properly handle task cancellation, pass a cancellation token to the Task.Run method. Otherwise, runTask.IsCancelled is not `true`.
{{< /alert >}}

The following methods of the [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class also support cancellation:

* [GetAttachments](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.viewer/getattachments/methods/1)
* [SaveAttachment](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.viewer/saveattachment/methods/1)
* [View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.viewer/view/methods/2) with ViewOptions
* [View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.viewer/view/methods/3) with ViewOptions and page numbers array

You can also view the [example](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/blob/master/Examples/GroupDocs.Viewer.Examples.CSharp/AdvancedUsage/Rendering/CommonRenderingOptions/CancelRenderWithCancellationToken.cs) in our public GitHub repository.


---

## Character replacements

Path: /search/java/character-replacements/

An instance of the [CharacterReplacementDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary) class contains all the character replacements defined in an index. For detailed information on character replacement, see the [Character replacement during Indexing]({{< ref "search/java/developer-guide/advanced-usage/indexing/character-replacement-during-indexing.md" >}}) page.

The [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#getCount()) method allows you to get the number of character replacements defined in the dictionary.

To add character replacements to the dictionary, use the [addRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#addRange(com.groupdocs.search.dictionaries.CharacterReplacementPair%5B%5D)) method.

To remove character replacements from the dictionary, the [removeRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#removeRange(char%5B%5D)) method is used.

The [contains](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#contains(char)) method is used to determine if the dictionary contains a replacement for the specified character.

To get a replacement for the specified character, use the [getReplacement](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#getReplacement(char)) method.

To remove all replacements from the dictionary, use the [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#clear()) method.

To export all replacements to a file, use the [exportDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import character replacements from a file, use the [importDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of the character replacement dictionary methods.



```java
String indexFolder = "c:\\MyIndex\\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.getDictionaries().getCharacterReplacements().getCount() > 0) {
    // Deleting all character replacements from the dictionary
    index.getDictionaries().getCharacterReplacements().clear();
}
 
if (index.getDictionaries().getCharacterReplacements().contains('-')) {
    char replacement = index.getDictionaries().getCharacterReplacements().getReplacement('-');
    System.out.println("The replacement for hyphen is " + replacement);
 
    // Deleting the hyphen character replacement from the dictionary
    index.getDictionaries().getCharacterReplacements().removeRange(new char[] { '-' });
}
 
// Export character replacements to a file
index.getDictionaries().getCharacterReplacements().exportDictionary("C:\\CharacterReplacements.dat");
 
// Import character replacements from a file
index.getDictionaries().getCharacterReplacements().importDictionary("C:\\CharacterReplacements.dat");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Character replacements

Path: /search/net/character-replacements/

An instance of the [CharacterReplacementDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/characterreplacementdictionary) class contains all the character replacements defined in an index. For detailed information on character replacement, see the [Character replacement during Indexing]({{< ref "search/net/developer-guide/advanced-usage/indexing/character-replacement-during-indexing.md" >}}) page.

The [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/characterreplacementdictionary/properties/count) property allows you to get the number of character replacements defined in the dictionary.

To add character replacements to the dictionary, use the [AddRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/characterreplacementdictionary/methods/addrange/index) method.

To remove character replacements from the dictionary, the [RemoveRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/characterreplacementdictionary/methods/removerange/index) method is used.

The [Contains](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/characterreplacementdictionary/methods/contains) method is used to determine if the dictionary contains a replacement for the specified character.

To get a replacement for the specified character, use the [GetReplacement](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/characterreplacementdictionary/methods/getreplacement) method.

To remove all replacements from the dictionary, use the [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/characterreplacementdictionary/methods/clear) method.

To export all replacements to a file, use the [ExportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/exportdictionary) method.

To import character replacements from a file, use the [ImportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/importdictionary) method.

The following example demonstrates the use of the character replacement dictionary methods.

**C#**

```csharp
 string indexFolder = @"c:\MyIndex\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.Dictionaries.CharacterReplacements.Count > 0)
{
    // Deleting all character replacements from the dictionary
    index.Dictionaries.CharacterReplacements.Clear();
}
 
if (index.Dictionaries.CharacterReplacements.Contains('-'))
{
    int replacement = index.Dictionaries.CharacterReplacements.GetReplacement('-');
    Console.WriteLine("The replacement for hyphen is " + char.ConvertFromUtf32(replacement));
 
    // Deleting the hyphen character replacement from the dictionary
    index.Dictionaries.CharacterReplacements.RemoveRange(new char[] { '-' });
}
 
// Export character replacements to a file
index.Dictionaries.CharacterReplacements.ExportDictionary(@"C:\CharacterReplacements.dat");
 
// Import character replacements from a file
index.Dictionaries.CharacterReplacements.ImportDictionary(@"C:\CharacterReplacements.dat");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Character replacements

Path: /search/nodejs-java/character-replacements/

An instance of the [CharacterReplacementDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary) class contains all the character replacements defined in an index. For detailed information on character replacement, see the [Character replacement during Indexing]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/character-replacement-during-indexing.md" >}}) page.

The [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#getCount()) method allows you to get the number of character replacements defined in the dictionary.

To add character replacements to the dictionary, use the [addRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#addRange(com.groupdocs.search.dictionaries.CharacterReplacementPair%5B%5D)) method.

To remove character replacements from the dictionary, the [removeRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#removeRange(char%5B%5D)) method is used.

The [contains](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#contains(char)) method is used to determine if the dictionary contains a replacement for the specified character.

To get a replacement for the specified character, use the [getReplacement](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#getReplacement(char)) method.

To remove all replacements from the dictionary, use the [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/CharacterReplacementDictionary#clear()) method.

To export all replacements to a file, use the [exportDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import character replacements from a file, use the [importDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of the character replacement dictionary methods.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Enabling character replacements in the index settings
const settings = new groupdocs.search.IndexSettings();
settings.setUseCharacterReplacements(true);

// Creating an index from in specified folder
const index = new groupdocs.search.Index(indexFolder, settings, true);

if (index.getDictionaries().getCharacterReplacements().getCount() > 0) {
  // Deleting all character replacements from the dictionary
  index.getDictionaries().getCharacterReplacements().clear();
}

// Adding character replacement
const range = java.newArray('com.groupdocs.search.dictionaries.CharacterReplacementPair', [
  new groupdocs.search.CharacterReplacementPair(java.newChar('-'), java.newChar('~')),
]);
index.getDictionaries().getCharacterReplacements().addRange(range);

if (index.getDictionaries().getCharacterReplacements().contains(java.newChar('-'))) {
  const replacement = index.getDictionaries().getCharacterReplacements().getReplacement(java.newChar('-'));
  console.log('The replacement for hyphen is ' + replacement);

  // Deleting the hyphen character replacement from the dictionary
  index
    .getDictionaries()
    .getCharacterReplacements()
    .removeRange(java.newArray('char', ['-']));
}

// Creating new character replacements
const count = 65536;
const array = new Array(count);
for (let i = 0; i < count; i++) {
  const text = String.fromCharCode(i);
  const character = java.newChar(text);
  const replacement = java.newChar(text.toLowerCase()[0]);
  array[i] = new groupdocs.search.CharacterReplacementPair(character, replacement);
}
const characterReplacements = java.newArray('com.groupdocs.search.dictionaries.CharacterReplacementPair', array);
// Adding character replacements to the dictionary
index.getDictionaries().getCharacterReplacements().addRange(characterReplacements);

// Export character replacements to a file
const fileName =
  Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/characterReplacements/CharacterReplacements.dat';
index.getDictionaries().getCharacterReplacements().exportDictionary(fileName);

// Import character replacements from a file
index.getDictionaries().getCharacterReplacements().importDictionary(fileName);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search in the index
const query = 'Elliot';
const options = new groupdocs.search.SearchOptions();
options.setUseCaseSensitiveSearch(true);
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Chart Series Coloring in Spreadsheet Document

Path: /assembly/java/chart-series-coloring-in-spreadsheet-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Spreadsheet Document 

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in  MS Excel 2013:

1.  Create a new Workbook.
2.  Click the "Insert" tab, and then click "Insert Column Chart" icon in the Charts group to view the drop-down list.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your Worksheet.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data](https://docs.groupdocs.com/assembly/java/chart-series-coloring-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.
  

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The report must be generated in the Spreadsheet Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Legend Entries

```java
="Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>>"
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Dynamic%20Chart%20Series%20Color.xlsx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```java
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists e1c86f03ae3aff341f15c3e7d777b91d >}}



---

## Chart Series Coloring in Spreadsheet Document

Path: /assembly/net/chart-series-coloring-in-spreadsheet-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Spreadsheet Document 

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in  MS Excel 2013:

1.  Create a new Workbook.
2.  Click the "Insert" tab, and then click "Insert Column Chart" icon in the Charts group to view the drop-down list.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your Worksheet.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data](https://docs.groupdocs.com/assembly/net/chart-series-coloring-in-spreadsheet-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The report must be generated in the Spreadsheet Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Legend Entries

```csharp
="Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>>"
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Dynamic%20Chart%20Series%20Color.xlsx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```csharp
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists afd94fbab248943951d921344460fbb2 >}}



---

## Check document password-protection

Path: /merger/net/check-document-password-protection/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to check document for password-protection. The result will be **true** if document has password for opening set, in other case **false** will be returned.

Here are the steps to check document password-protection:

*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [IsPasswordSet](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/ispasswordset) method.

The following code sample demonstrates how to check document password-protection.

```csharp
bool isPasswordSet = false;
string filePath = @"C:\sample.xlsx";

using (Merger merger = new Merger(filePath))
{
	isPasswordSet = merger.IsPasswordSet();
}
```

---

## Check document password-protection

Path: /merger/python-net/check-document-password-protection/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net)** allows to check document for password-protection. The result will be **true** if document has password for opening set, in other case **false** will be returned.

Here are the steps to check document password-protection:

*   Instantiate [Merger](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger) object with source document path or stream;
*   Call [IsPasswordSet](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/ispasswordset) method.

The following code sample demonstrates how to check document password-protection.

```python
with gm.Merger(constants.sample_xlsx_protected) as merger:
        is_password_set = merger.is_password_set()
```

---

## Check if a file is encrypted

Path: /viewer/java/how-to-check-if-file-is-encrypted/


The encryption protects data and allows only authorized people to open the file. So, only those who have an encryption key (such as a password) can open and view a file.

## Check if a file is encrypted online

1. Navigate to the [GroupDocs.Viewer App](https://products.groupdocs.app/viewer/total). 

![GroupDocs.Viewer App](/viewer/java/images/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted/viewe-app-upload-file.png)

2. Upload your file. If you are prompted to enter a password to open the file, it is encrypted.

![GroupDocs.Viewer App password prompt](/viewer/java/images/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted/viewe-app-password-prompt.png)

{{< alert style="warning" >}}
It's important to be cautious about uploading sensitive files to online services. For critical files, we recommend using a programmatic method.
{{< /alert >}}

## Programmatically check for file encryption

Use the _getFileInfo()_ method that returns the file type and flag that indicates if the file is encrypted. The following code snippet shows how to check if a file is encrypted. 

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.results.FileInfo;
// ...

try (Viewer viewer = new Viewer("protected.pdf")) {
    FileInfo fileInfo = viewer.getFileInfo();

    System.out.println("File type is: " + fileInfo.getFileType());
    System.out.println("File encrypted: " + fileInfo.isEncrypted());
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="tip" >}}

Download a [sample application](/viewer/java/sample-apps/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted/how-to-check-if-file-is-encrypted.zip) written in Java that uses this code snippet. You can run the application locally using the `mvn exec:java` command. Ensure you have the [Java](https://www.oracle.com/java/technologies/downloads/) and [Maven](https://maven.apache.org/download.cgi) installed beforehand.

{{< /alert >}}

The following shows a sample console output:

```bash
$ mvn exec:java -q
File type is: Portable Document Format File (.pdf)
File encrypted: true
```
To learn how to open an encrypted file, please refer to [Load password-protected document]({{< ref "/viewer/java/developer-guide/loading-documents/load-password-protected-document.md" >}}) documentation topic.

---

## Check if a file is encrypted

Path: /viewer/net/how-to-check-if-file-is-encrypted/


The encryption protects data and allows only authorized people to open the file. So, only those who have an encryption key (such as a password) can open and view a file.

## Check if a file is encrypted online

1. Navigate to the [GroupDocs.Viewer App](https://products.groupdocs.app/viewer/total). 

![GroupDocs.Viewer App](/viewer/net/images/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted/viewe-app-upload-file.png)

2. Upload your file. If you are prompted to enter a password to open the file, it is encrypted.

![GroupDocs.Viewer App password prompt](/viewer/net/images/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted/viewe-app-password-prompt.png)

{{< alert style="warning" >}}
It's important to be cautious about uploading sensitive files to online services. For critical files, we recommend using a programmatic method.
{{< /alert >}}

## Programmatically check for file encryption

Use the _GetFileInfo()_ method that returns the file type and flag that indicates if the file is encrypted. The following code snippet shows how to check if a file is encrypted. 

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("protected.pdf"))
{
    // Get file information.
    FileInfo fileInfo = viewer.GetFileInfo();

    // Display the file type and flag if the file is encrypted.
    Console.WriteLine("File type is: " + fileInfo.FileType);
    Console.WriteLine("File encrypted: " + fileInfo.Encrypted);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("protected.pdf")
            ' Get file information.
            Dim fileInfo As FileInfo = viewer.GetFileInfo()
        
            ' Display the file type and flag if the file is encrypted.
            Console.WriteLine("File type is: " & fileInfo.FileType.ToString())
            Console.WriteLine("File encrypted: " & fileInfo.Encrypted.ToString())
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="tip" >}}

Download a [sample application](/viewer/net/sample-apps/developer-guide/retrieving-document-information/how-to-check-if-file-is-encrypted/how-to-check-if-file-is-encrypted.zip) written in C# that uses this code snippet. You can run the application locally using the `dotnet run` command. Ensure you have the [.NET SDK](https://dotnet.microsoft.com/download) installed beforehand.

{{< /alert >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-check-if-file-is-encrypted.png)

To learn how to open an encrypted file, please refer to [Load password-protected document]({{< ref "/viewer/net/developer-guide/loading-documents/load-password-protected-document.md" >}}) documentation topic.

---

## Classify document from stream

Path: /classification/net/classify-document-from-stream/

Classifying of the document from stream could be performed with the next step

*   Call [**Classify** ](https://reference.groupdocs.com/net/classification/groupdocs.classification/classifier/methods/classify)method for "stream" stream with Documents taxonomy and return 2 best results.
*   Handle possible ApiException 

```csharp
// Classify document from stream with Documents taxonomy and return 2 best resultstry
{
    var response = classifier.Classify(stream, 2, Taxonomy.Documents);
    Console.WriteLine(response.BestClassName, response.BestClassProbability);
}
catch (ApiException e)
{
    Console.WriteLine(e.Message);
}
```

---

## Column Chart in Presentation Document

Path: /assembly/java/column-chart-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Column Chart Report with Filtered, Grouped, and Ordered Data in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft PowerPoint Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS PowerPoint 2013:

1.  Create a new presentation slide.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Column" in the sidebar, you will see a gallery of charts.
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document.
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/column-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must show total Contract Prices by Quarters
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Quarters<<foreach [in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x [key.getName()]>>
```

#### Chart Data (Excel)

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" width="710" style="width: 532.45pt; margin-left: 15.75pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="98" valign="top" style="width: 73.65pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">1st Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 0 &amp;&amp; c.getDate().getMonth() &lt;= 2).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">2nd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 3 &amp;&amp; c.getDate().getMonth() &lt;= 5).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">3rd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 6 &amp;&amp; c.getDate().getMonth() &lt;= 8).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">4th Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 9 &amp;&amp; c.getDate().getMonth() &lt;= 11).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 1</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr></tbody></table>
### Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 0ac01fc8e6ce67d9fe506ab599297d4d >}}

## Column Chart in OpenOffice Presentation Document

To be investigated.

---

## Column Chart in Presentation Document

Path: /assembly/net/column-chart-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Column Chart Report with Filtered, Grouped, and Ordered Data in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft PowerPoint Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS PowerPoint 2013:

1.  Create a new presentation slide.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Column" in the sidebar, you will see a gallery of charts.
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document.
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/column-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must show the quantity of sales/orders.
*   Sales/orders quantity must represented by Quarters.
*   It must associate order quantity with the corresponding customer.
*   A report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Quantity by Quarters<<foreach [in orders.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>>
<<x [Key.CustomerName]>>

```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1st Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 1 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 3).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2nd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 4 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 6).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3rd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 7 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 9).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4th Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 10 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 12).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 1</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.pptx?raw=true) (Template for CustomObject and JSON examples) 
*   [Chart Template\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB.pptx?raw=true) (Template for DataSet, DataBase examples)
*   [Chart Template\_XML.pptx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML.pptx?raw=true) (Template for XML examples) 

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 6119aa23ca0a69b29c880992476a9798 >}}



#### Database Entities

{{< gist GroupDocsGists b291dcb24d1f49b71f591baa246418e5 >}}



#### Using DataSet

{{< gist GroupDocsGists b291dcb24d1f49b71f591baa246418e5 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 7a7862f64d7882062238ee08edd016ba >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 7249847fdaa09d967a7192429f223916 >}}



## Column Chart in OpenOffice Presentation Document

To be investigated.

---

## Common List Image in Presentation Document

Path: /assembly/java/common-list-image-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List Image report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common List in Microsoft PowerPoint Document

### Creating a Common List Image

Please follow below steps to create Common List Template in MS PowerPoint 2013:

1.  Create a new presentation slide.
2.  Add two shapes to hold pictures and name.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show multiple managers' name.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}There is no way to use image inside a foreach tag in Microsoft PowerPoint.{{< /alert >}}

```java
<<foreach [in getManagers()]>><<[getName()]>>
<</foreach>>
```

### Download Template

Please download the sample Common List document we created in this article:

*   [Common List.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Common%20List.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 4e08200953c3248b654b62ce0b72ad56 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.

*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common List Image in Presentation Document

Path: /assembly/net/common-list-image-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List Image report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Common List in Microsoft PowerPoint Document

### Creating a Common List Image

Please follow below steps to create Common List Template in MS PowerPoint 2013:

1.  Create a new presentation slide.
2.  Add two shapes to hold pictures and name.
3.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers with the following key requirements:

*   A report must show multiple customers' picture and name.
*   A report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}There is no way to use an image inside a foreach tag in Microsoft PowerPoint.{{< /alert >}}

```csharp
<<foreach [in customers]>><<[CustomerName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Template

Please download the sample Common List document we created in this article:

*   [Common List.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Common%20List.pptx?raw=true)  
      
  

{{< alert style="warning" >}}Use this template for DB, Dataset, JSON and XML examples also.{{< /alert >}}

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 136c43e5f02469bb1cfbc494ed172ec9 >}}



#### Database Entities

{{< gist GroupDocsGists 1ca2bfad6924d932a1c861d0924db1d9 >}}



#### Using DataSet

{{< gist GroupDocsGists 413cbef26b96c3242d18fbdfc25f6d48 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 248a1f47e8bbb16f232a303b20e1c6b0 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists ee3e238e42381670c2672e4ef2556abd >}}



## Common List in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating a 'Common List' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" dropdown.
4.  Click "Save".

### Download Template

*   [Common List\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Common%20List_OpenDocument.odp?raw=true) (use same template for database, dataset, JSON and XML examples)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 44e2f9f2077892452ee6b31db0352150 >}}



#### Database Entities

{{< gist GroupDocsGists b1cc69c6c963bb480a2f847b7f93a63f >}}



#### Using DataSet

{{< gist GroupDocsGists a1e384eb5b528d6effe2a4699b4f211f >}}



#### Using XML DataSource

{{< gist GroupDocsGists 8164a98e56f424a01ba598ac2da41e0b >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 9298bdc957de3cccc19f5978f3bb9813 >}}



### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.

*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common Master-Detail Image in Presentation Document

Path: /assembly/java/common-master-detail-image-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common Master-Detail in Microsoft PowerPoint Document

### Creating a Common Master-Detail

Please follow below steps to create Common Master-Detail Template in MS PowerPoint 2013:

1.  Create a new Presentation.
2.  Insert two shapes, one for holding image and other for holding other details.  
    
    #Save the document.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers and clients with the following key requirements:

*   Report must show managers' picture and name.
*   It must associate the managers with their clients.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
<<foreach [in getManagers()]>>Manager: <<[getName()]>>
Clients: <<foreach [in getContracts()]>><<[indexOf() != 0 ? ", " : ""]>>
<<[getClient().getName()]>><</foreach>>
<</foreach>>
```

### Download Common Master-Detail Template

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Common%20Master-Detail.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists fbe130505d1b084c64b66835338c3688 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Common Master-Detail Image in Presentation Document

Path: /assembly/net/common-master-detail-image-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}

## Common Master-Detail in Microsoft PowerPoint Document

### Creating a Common Master-Detail

Please follow below steps to create Common Master-Detail Template in MS PowerPoint 2013:

1.  Create a new Presentation.
2.  Insert two shapes, one for holding image and other for holding other details.  
  
## Save the document

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and products with the following key requirements:

*   Report must show customers' picture and name.
*   It must associate the customers with their products.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

NOTE: There is no way to use images inside a foreach tag in PowerPoint.

<<foreach \[in customers\]>>**Customer: <<\[CustomerName\]>>**

**Products: <<foreach \[in Order\]>><<\[IndexOf() != 0 ? ", " : ""\]>><<\[Product.ProductName\]>><</foreach\>>**

<</foreach\>>

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Common Master-Detail Template

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Common%20Master-Detail.pptx?raw=true) (Template for CustomObject and JSON examples)
*   [Common Master-Detail\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Common%20Master-Detail_DB.pptx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs cc4d171e25ad9761120f >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 9af73f2cc66a6477331c >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs e8dd676f698f6ddc5b85 >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs ec5c65697d59406bdece >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 155eb16766da06a0ea9d >}}

## Common Master-Detail in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Common Master-Detail' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Common Master-Detail\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Common%20Master-Detail_OpenDocument.odp?raw=true) (use same template for JSON examples)
*   [Common Master-Detail\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Common%20Master-Detail_DB_OpenDocument.odp?raw=true) (use same template for database and dataset and XML examples)

### Generating the report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 56f152d91f84cefef8d7 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 680319f37bc74988a684 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 5392574bdb04e851863e >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 8e2f524e84ca847fcfd4 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs f59b2aa5a757bf90336a >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Compare documents

Path: /comparison/java/compare-documents/



Changes detection algorithms used by [GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to detect changes in different document parts and blocks:

*   Text blocks - paragraphs, words and characters
*   Tables
*   Images
*   Shapes etc.

GroupDocs.Comparison highlights detected changes with different colors:

*   Added – <font color="blue">**blue** </font>
*   Modified – <font color="green">**green**</font>
*   Style – <font color="green">**green**</font>
*   Deleted – <font color="red">**red**</font>

You can customize the changes styling scheme using different formatting - italic, bold, underlined, strike through, etc.

To compare two documents, follow these steps:

1.   Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object with source document path or stream.
2.   Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method and specify target document path or stream.
3.   Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method.

The following code snippets show how to compare two documents:

## Compare local documents

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.pdf")) {
    comparer.add("target.pdf");
    final Path resultPath = comparer.compare("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

The output file is as follows:

![](/comparison/java/images/compare-documents.png)

## Compare documents from stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import java.nio.file.Path;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.FileOutputStream;
import java.io.OutputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream)) {
    comparer.add(targetInputStream);
    final Path resultPath = comparer.compare(resultOutputStream);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Compare documents

Path: /comparison/net/compare-documents/



Changes detection algorithms used by [GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to detect changes in different document parts and blocks:

*   Text blocks - paragraphs, words and characters
*   Tables
*   Images
*   Shapes etc.

GroupDocs.Comparison highlights detected changes with different colors:

*   Added – <font color="blue">**blue** </font>
*   Modified – <font color="green">**green**</font>
*   Style – <font color="green">**green**</font>
*   Deleted – <font color="red">**red**</font>

You can customize the changes styling scheme using different formatting - italic, bold, underlined, strike through, etc.

To compare two documents, follow these steps:

1.   Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object with source document path or stream.
2.   Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method and specify target document path or stream.
3.   Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare/index) method.

The following code snippets show how to compare two documents:

## Compare local documents

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx");
}
```
{{< /tab >}}
{{< /tabs >}}

The output file is as follows:

![](/comparison/net/images/compare-documents.png)

## Compare documents from stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using System.IO;
// ...

using (Comparer comparer = new Comparer(File.OpenRead("source.docx")))
{
    comparer.Add(File.OpenRead("target.docx"));
    comparer.Compare(File.Create("result.docx"));
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Compare documents

Path: /comparison/nodejs-java/compare-documents/



Change detection algorithms of [GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allow you to detect changes in different document parts and blocks:

*   Text blocks - paragraphs, words and characters
*   Tables
*   Images
*   Shapes etc.

GroupDocs.Comparison highlights detected changes with different colors:

*   Added – <font color="blue">**blue** </font>
*   Modified – <font color="green">**green**</font>
*   Style – <font color="green">**green**</font>
*   Deleted – <font color="red">**red**</font>

You can customize the changes styling scheme using different formatting - italic, bold, underlined, strike-through, etc.

The following code snippets show how to compare two documents:

## Compare local documents

The following example compares two local documents from the file system and saves a new document that highlights all differences.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define paths to the source (original) and target (modified) documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';

// Specify the path of the result document that will contain the comparison output
const resultPath = 'result.docx';

// Create a Comparer instance for the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to be compared against the source
comparer.add(targetPath);

// Run the comparison and save the result document
comparer.compare(resultPath);

// Exit the process after the comparison is finished
process.exit(0);
```

This example performs the following operations:

1. Instantiates the `Comparer` object with the source document path or stream.
2. Calls the `add()` method to specify the target document path or stream.
3. Invokes the `compare()` method to generate the result document.

The output file is as follows:

![](/comparison/nodejs-java/images/compare-documents.png)

## Compare documents from a stream

The following example loads documents from Java input streams instead of file paths and then compares them.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import the Java bridge so we can work with Java input streams
const java = require('java');

// Get a reference to the Java FileInputStream class
let InputStream = java.import('java.io.FileInputStream');

// Define paths to the source and target PDF documents
const sourcePdfPath = 'sample-files/source.pdf';
const targetPdfPath = 'sample-files/target.pdf';

// Define the path for the result DOCX file
const resultDocxPath = 'result.docx';

// Create a Comparer instance using a Java input stream for the source file
const comparer = new groupdocs.Comparer(new InputStream(sourcePdfPath));

// Add the target document as a Java input stream
comparer.add(new InputStream(targetPdfPath));

// Perform the comparison and save the result document
comparer.compare(resultDocxPath);

// Exit the process after the comparison is finished
process.exit(0);
```

In this stream-based scenario:

1. The `Comparer` is initialized with a Java input stream for the source document.
2. The `add()` method is used to provide the target document as an input stream.
3. The `compare()` method runs the comparison and writes the output to the specified result file.


---

## Compare documents

Path: /comparison/python-net/compare-documents/



Change detection algorithms of [GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allow you to detect changes in different document parts and blocks:

*   Text blocks - paragraphs, words and characters
*   Tables
*   Images
*   Shapes etc.

GroupDocs.Comparison highlights detected changes with different colors:

*   Added – <font color="blue">**blue** </font>
*   Modified – <font color="green">**green**</font>
*   Style – <font color="green">**green**</font>
*   Deleted – <font color="red">**red**</font>

You can customize the changes styling scheme using different formatting - italic, bold, underlined, strike-through, etc.

To compare two documents, follow these steps:

1.   Instantiate the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object with the source document path or stream.
2.   Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method and specify the target document path or stream.
3.   Call the `compare()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#compare-java.lang.String-)--> method.

The following code snippets show how to compare two documents:

## Compare local documents

```python
import groupdocs.comparison as gc

# Initialize the comparer object with the source file path
with gc.Comparer(sourcePath) as comparer:

    # Add the target file for comparison and perform the compare operation
    comparer.add(targetPath)
    comparer.compare(output_file_name)
```

The output file is as follows:

![](/comparison/python-net/images/compare-documents.png)

## Compare documents from a stream

```python
import groupdocs.comparison as gc

def run():

    # Initialize the comparer object with the source file stream
    with open(sourcePath, 'rb') as source_stream:
        comparer = gc.Comparer(source_stream)

        # Add the target file for comparison from a stream and perform the compare operation
        with open(targetPath, 'rb') as target_stream:
            comparer.add(target_stream)
            comparer.compare(output_file_name)
```


---

## Compare PDF documents

Path: /comparison/python-net/compare-pdf-documents/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) makes it simple to **compare PDF documents** and identify changes in text, formatting, annotations, and structure.  
This is particularly useful for reviewing contracts, business agreements, and legal documents where precise difference detection is critical.

With the API, you can:

- Compare two or more **PDF files**  
- Highlight differences such as insertions, deletions, and formatting updates  
- Save the comparison results to a new PDF or another supported format  

## How to compare PDF documents in Python

To compare PDF files, follow these steps:

1. Create an instance of the `Comparer` class and load the source PDF file.  
2. Add one or more target PDF files.  
3. Call the `compare()` method and provide the result file path.  

## Example: Compare PDF documents

```python
import groupdocs.comparison as gc

source_path = "source.pdf"
target_path = "target.pdf"
result_path = "result.pdf"

# Initialize the comparer with the source PDF document
with gc.Comparer(source_path) as comparer:

    # Add the target PDF document
    comparer.add(target_path)

    # Compare and save the results
    comparer.compare(result_path)
```
---

## Composing signature with solid brush background

Path: /signature/java/composing-signature-with-solid-brush-background/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [SolidBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/SolidBrush) class to specify solid filling signature background for Text and Stamp signature types

 Here are the steps to add Text signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate the [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) object with all required additional options and setup [Background.setBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/Background#setBrush(com.groupdocs.signature.domain.extensions.Brush)) property with instance of [SolidBrush](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions/SolidBrush)
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) to it. 
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed. 
    

```java
Signature signature = new Signature("sample.pdf");
TextSignOptions options = new TextSignOptions("John Smith");
 
// adjust signature appearance brush
 
// setup background
Background background = new Background();
background.setColor(Color.GREEN);
background.setTransparency(0.5);
background.setBrush(new SolidBrush(Color.LIGHT_GRAY));
options.setBackground(background);
 
 
// locate signature
options.setWidth(100);
options.setHeight(80);
options.setVerticalAlignment(VerticalAlignment.Center);
options.setHorizontalAlignment(HorizontalAlignment.Center);
Padding padding = new Padding();
padding.setTop(20);
padding.setRight(20);
options.setMargin(padding);
 
// set alternative signature implementation on document page
options.setSignatureImplementation(TextSignatureImplementation.Image);
 
// sign document to file
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Conflict when using GroupDocs.Viewer and some Aspose library in single project

Path: /viewer/net/conflict-between-viewer-and-aspose/


**Issue**

When using the GroupDocs.Viewer together with one or more Aspose products (like Aspose.Pdf) in a single project on Windows 11, undefined unexpected conflicts may occurs, mostly in form of runtime exceptions of different types.

**Cause**

The problem occurrs because the project with GroupDocs.Viewer and Aspose product is running within a 32-bit IDE (this may include JetBrains Rider) on a 64-bit Windows 11 system. This mismatch between the IDE and the operating system caused conflicts in code execution and library loading.

**Resolution**

Reinstall the IDE by installing a corect version, which [bitness](https://en.wiktionary.org/wiki/bitness) matches the bitness of the operating system. In particular, 32-bit IDE for 32-bit operating system, and 64-bit IDE for 64-bit operating system.
---

## Convert a Document to Multiple Page Files

Path: /conversion/python-net/developer-guide/converting-documents/convert-document-to-multiple-page-files/


This documentation topic covers the conversion of a single multi-page document into individual page files. The following diagram illustrates the process of converting a multi-page file into separate pages:

{{< mermaid class="text-center" >}}
flowchart LR
    %% Nodes
    A["Input Document"]
    B["Conversion"]
    C["Converted Page 1"]
    D["Converted Page 2"]
    E["Converted Page N"]

    %% Edge connections between nodes
    A --> B --> C
    B --> D
    B --> E
{{< /mermaid >}}

To convert and save a document by page, use the following methods of the `Converter` class:

- **`convert_by_page(output_path, convert_options)`**: Converts each page of a document to the specified output format and saves them individually to disk.
- **`convert_by_page(file_path, page_number, convert_options)`**: Converts a specific page of a document and saves it to the specified output file path.
- **`convert_by_page(stream, page_number, convert_options)`**: Converts a specific page of a document and saves it to a provided stream.

## Supported ConvertOptions Classes

The following `ConvertOptions` classes can be used with the `convert_by_page` method:

- **PdfConvertOptions** – Options for converting to [PDF]({{< ref "conversion/python-net/supported-file-formats#pdf" >}}) format.
- **ImageConvertOptions** – Options for converting to [Image]({{< ref "conversion/python-net/supported-file-formats#image" >}}) formats (e.g., PNG, JPEG).
- **WordProcessingConvertOptions** – Options for converting to [Word Processing]({{< ref "conversion/python-net/supported-file-formats#word-processing" >}}) formats.
- **SpreadsheetConvertOptions** – Options for converting to [Spreadsheet]({{< ref "conversion/python-net/supported-file-formats#spreadsheet" >}}) formats.
- **PresentationConvertOptions** – Options for converting to [Presentation]({{< ref "conversion/python-net/supported-file-formats#presentation" >}}) formats.
- **WebConvertOptions** – Options for converting to [Web]({{< ref "conversion/python-net/supported-file-formats#web" >}}) formats (e.g., HTML).
- **EBookConvertOptions** – Options for converting to [EBook]({{< ref "conversion/python-net/supported-file-formats#ebook" >}}) formats (e.g., EPUB, MOBI).
- **DiagramConvertOptions** – Options for converting to [Diagram]({{< ref "conversion/python-net/supported-file-formats#diagram" >}}) formats (e.g., VSDX).
- **PageDescriptionLanguageConvertOptions** – Options for converting to [Page Description Language]({{< ref "conversion/python-net/supported-file-formats#page-description-language" >}}) formats (e.g., PostScript).
- **CadConvertOptions** – Options for converting to [CAD]({{< ref "conversion/python-net/supported-file-formats#cad" >}}) formats (e.g., DWG).
- **ThreeDConvertOptions** – Options for converting to [3D]({{< ref "conversion/python-net/supported-file-formats#3d" >}}) formats.
- **FinanceConvertOptions** – Options for converting to [Finance]({{< ref "conversion/python-net/supported-file-formats#finance" >}}) formats (e.g., XBRL).

## Example 1: Convert All Pages of a Document and Save Output to a Folder

The following example demonstrates how to convert each slide in a PPTX presentation to a PNG image and save the output images to a specified folder.
 
The file name template for the output files is `converted-page-{page number}.{output file extension}`. In this example, the first slide will be saved as `converted-page-1.png`.

{{< tabs "example-1">}}
{{< tab "convert_all_document_pages.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

def convert_all_document_pages():
    # Instantiate Converter with the input document 
    with Converter("./basic-presentation.pptx") as converter:
        # Instantiate convert options 
        png_convert_options = ImageConvertOptions()
        # Define the output format as PNG
        png_convert_options.format = ImageFileType.PNG
        
        # Convert all pages and save to the output folder
        converter.convert_by_page("./converted-pages", png_convert_options)    

if __name__ == "__main__":
    convert_all_document_pages()
```
{{< /tab >}}
{{< tab "basic-presentation.pptx" >}}  
{{< tab-text >}}
`basic-presentation.pptx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-multiple-page-files/basic-presentation.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted-pages" >}}  
{{< tab-text >}}
`converted-pages` is the output folder path for the converted pages. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-multiple-page-files/converted-pages.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 2: Convert a Specific Page and Save Output to a File

{{< alert style="tip" >}} Find out how to get the number of document pages in the [Getting Document Information]({{< ref "conversion/python-net/developer-guide/getting-document-info#example-1-get-basic-document-info" >}}) documentation topic. {{< /alert >}}

The following example shows how to convert a specific slide in a PPTX presentation and save it as a separate file.

{{< tabs "example-2">}}
{{< tab "convert_specific_document_page_to_file.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

def convert_specific_document_page_to_file():
    # Instantiate Converter with the input document 
    with Converter("./basic-presentation.pptx") as converter:
        # Instantiate convert options 
        png_convert_options = ImageConvertOptions()
        # Define the output format as PNG
        png_convert_options.format = ImageFileType.PNG
        
        # Set the page number to convert and save it to a file
        page_number_to_convert = 3
        converter.convert_by_page("./slide-3.png", page_number_to_convert, png_convert_options)    

if __name__ == "__main__":
    convert_specific_document_page_to_file()
```
{{< /tab >}}
{{< tab "basic-presentation.pptx" >}}  
{{< tab-text >}}
`basic-presentation.pptx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-multiple-page-files/basic-presentation.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "slide-3.png" >}}  
{{< tab-text >}}
`slide-3.png` is the expected output PNG image. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-multiple-page-files/slide-3.png) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Example 3: Convert a Specific Page and Save Output to a Stream

{{< alert style="tip" >}} Find out how to get the number of document pages in the [Getting Document Information]({{< ref "conversion/python-net/developer-guide/getting-document-info#example-1-get-basic-document-info" >}}) documentation topic. {{< /alert >}}

As an alternative, you can specify the stream to save the converted PNG image:

{{< tabs "example-3">}}
{{< tab "convert_specific_document_page_to_stream.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

def convert_specific_document_page_to_file():
    # Instantiate Converter with the input document 
    with Converter("./basic-presentation.pptx") as converter:
        # Instantiate convert options 
        png_convert_options = ImageConvertOptions()
        # Define the output format as PNG
        png_convert_options.format = ImageFileType.PNG
        
        # Set the page number to convert and save it to a file
        page_number_to_convert = 5
        with open(f"./slide-{page_number_to_convert}.png", "w+b") as page_stream:
            converter.convert_by_page(page_stream, page_number_to_convert, png_convert_options)    

if __name__ == "__main__":
    convert_specific_document_page_to_file()
```
{{< /tab >}}
{{< tab "basic-presentation.pptx" >}}  
{{< tab-text >}}
`basic-presentation.pptx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-multiple-page-files/basic-presentation.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "slide-5.png" >}}  
{{< tab-text >}}
`slide-5.png` is the expected output PNG image. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-document-to-multiple-page-files/slide-5.png) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Convert N consecutive pages

Path: /conversion/net/convert-n-consecutive-pages/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides the feature to convert N consecutive pages.

To convert consecutive pages, follow these steps:

1.   Create an instance of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class and pass the source document path as a constructor parameter
2.   Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) class e.g. (**[PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions)** etc.)
3.   Set the [PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pagenumber) property of the [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) instance to the starting page number
4.   Set the [PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pagescount) property of the [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) instance to the number of pages to be converted 
5.   Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class instance and pass the filename for the converted document and the instance of the [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) from the previous steps

The following code snippet shows how to convert 3 consecutive pages starting from second page of the source document:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PdfConvertOptions options = new PdfConvertOptions
    {
        PageNumber = 2,
        PagesCount = 3
    };
    converter.Convert("converted.pdf", options);
}
```

---

## Convert specific pages

Path: /conversion/java/convert-specific-pages/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) allows you to convert specific pages of a document instead of processing the entire file. This feature is useful when you need to extract or convert only certain sections of a document, reducing processing time and file size.

To convert specific pages from a document, follow these steps:

1.   *Initialize the Converter* – Create an instance of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class and pass the source document path as a constructor parameter.
2.   *Set Convert Options* – Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) class based on the target format (e.g., `PdfConvertOptions`, `WordProcessingConvertOptions`, `SpreadsheetConvertOptions`, etc.).
3.   *Specify Pages to Convert* – Use the `setPages` method of the [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) instance to define a list of pages to be converted.
4.   *Perform Conversion* – Call the `convert` method of the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class, passing the output filename and the [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) instance.

The following Java code snippet demonstrates how to convert only the first and third pages of a Word document (`.docx`) into a PDF:
{{< tabs "code-example">}}
{{< tab "ConvertSpecificPages.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class ConvertSpecificPages {
    public static void convert() {
        // Initialize the converter with the source document
        Converter converter = new Converter("annual-review.docx");

        // Set conversion options for PDF
        PdfConvertOptions options = new PdfConvertOptions();

        // Specify pages to convert (first and third pages)
        options.setPages(Arrays.asList(1, 3));

        // Perform the conversion
        converter.convert("converted.pdf", options);

        System.out.println("Selected pages have been successfully converted.");
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "annual-review.docx" >}}  
{{< tab-text >}}
`annual-review.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-specific-pages/annual-review.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.pdf" >}}  
{{< tab-text >}}
`converted.pdf` is converted attachment PDF document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-specific-pages/converted.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Supported Formats

The ability to convert specific pages is available for various formats, including:

- **PDF** ([PdfConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/))
- **Word Processing** ([WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/))
- **Spreadsheets** ([SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/spreadsheetconvertoptions/))
- **Presentations** ([PresentationConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/presentationconvertoptions/))
- **Images** ([ImageConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/imageconvertoptions/))

### Specifying Page Ranges
Instead of listing individual pages, you can specify a range of pages using:
```java
options.setPages(Arrays.asList(1, 2, 3, 4)); // Converts pages 1-4
```
### Benefits of Converting Specific Pages
- **Faster Processing** – Converts only the required pages, reducing processing time.
- **Smaller File Size** – Generates a smaller output file by excluding unnecessary pages.
- **Focused Output** – Useful when working with lengthy documents where only certain pages are relevant.

### Conclusion
[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) makes it easy to extract and convert specific pages from documents. This functionality is particularly useful for users who need precise control over their document conversions, saving both time and resources.

---

## Convert specific pages

Path: /conversion/nodejs-java/convert-specific-pages/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) also provides the feature to convert selected page number. 

To convert specific pages, follow these steps: 

1.   Create an instance of the [Converter](#) class and pass source document path as a constructor parameter.
2.   Instantiate the appropriate [ConvertOptions](#) class e.g. (**[PdfConvertOptions](#)**, **[WordProcessingConvertOptions](#)**, **[SpreadsheetConvertOptions](#)** etc.)
3.   Set the [setPages](#) property of the [ConvertOptions](#) instance to the list of desired page number to be converted.
*   Call the [convert](#) method of the [Converter](#) class instance and pass the filename of the converted document and the instance of [ConvertOptions](#) from the previous steps.

  
The following code snippet shows how to convert first and third pages from the source document:

```js
const converter = new groupdocs.conversion.Converter('sample.docx')
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

const pages = new ArrayList()
pages.add(1)
pages.add(3)
convertOptions.setPages(pages);

converter.convert('outputSpecPages.pdf', convertOptions)
```

---

## Convert to grayscale

Path: /viewer/java/optimization-pdf-convert-grayscale/

To speed up the printing of a PDF file and reduce its size, you can convert it from RGB color space to grayscale.

To convert a PDF file to grayscale, set the [setConvertToGrayScale()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/Pdfoptimizationoptions/#setConvertToGrayScale-boolean-) method to `true`.

The following code snippet shows how to convert a PDF file to grayscale:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setPdfOptimizationOptions(new PdfOptimizationOptions());
    viewOptions.getPdfOptimizationOptions().setConvertToGrayScale(true);
     
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}

The following image demonstrates the result:

![Convert to grayscale](/viewer/java/images/pdf-rendering/optimization/optimization-pdf-convert-grayscale.png)

---

## Convert to grayscale

Path: /viewer/net/optimization-pdf-convert-grayscale/

To speed up the printing of a PDF file and reduce its size, you can convert it from RGB color space to grayscale.

To convert a PDF file to grayscale, set the [ConvertToGrayScale](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/converttograyscale) property to `true`.

The following code snippet shows how to convert a PDF file to grayscale:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.docx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions
    {
        ConvertToGrayScale = true
    };
     
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.docx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions With {
                .ConvertToGrayScale = True
                }
    
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Convert to grayscale](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-convert-grayscale.png)

---

## Convert to grayscale

Path: /viewer/python-net/optimization-pdf-convert-grayscale/

To speed up the printing of a PDF file and reduce its size, you can convert it from RGB color space to grayscale.

To convert a PDF file to grayscale, set the [convert_to_gray_scale](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property to `True`.

The following code snippet shows how to convert a PDF file to grayscale:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def convert_to_grayscale():
    # Load document
    with Viewer("sample.docx") as viewer:
        viewOptions = PdfViewOptions("convert_to_grayscale/grayscale_output.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.convert_to_gray_scale = True

        viewer.view(viewOptions)

if __name__ == "__main__":
    convert_to_grayscale()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimize-images/optimization-pdf-convert-grayscale/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Convert to grayscale](/viewer/net/images/developer-guide/pdf-rendering/optimization/optimization-pdf-convert-grayscale.png)

---

## Convert to HTML with advanced options

Path: /conversion/net/convert-to-html-with-advanced-options/

GroupDocs.Conversion provides [WebConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions) to give you control over conversion result. The following options could be set:

*   [FixedLayout](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions/fixedlayout) controls the HTML generation. If it's set to *true*, fixed layout will be used e.g. absolutely positioned HTML element.
*   [FixedLayoutShowBorders](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions/fixedlayoutshowborders) controls the display of page borders during fixed layout conversion. Default is true.
*   [EmbedFontResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions/embedfontresources) specifies whether to embed font resources within the main HTML. Default is false. Note: fonts automatically embed when FixedLayout is enabled.
*   [Zoom](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions/zoom) specifies the zoom level in percentage. The default value is 100.
*   [UsePdf](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions/usepdf). Sometimes, for better rendering and elements positioning the source document should be converted to PDF first. If this property is set to *true*, the input firstly is converted to PDF and after that to desired format.

The following code snippet shows how to convert to HTML with advanced options

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    WebConvertOptions options = new WebConvertOptions
    {
        PageNumber = 2,
        PagesCount = 1,
        FixedLayout = true
    };
    converter.Convert("converted.html", options);
}
```

## Embedding Font Resources

Control whether font resources are embedded within the HTML file:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    WebConvertOptions options = new WebConvertOptions
    {
        EmbedFontResources = true  // Embed fonts directly in HTML
    };
    converter.Convert("embedded-fonts.html", options);
}
```

When `EmbedFontResources` is set to false (default), font files are stored separately and referenced by the HTML file. When set to true, all font data is embedded directly within the HTML file, making it self-contained but larger in size.

Note: When `FixedLayout` is enabled, fonts are automatically embedded regardless of the `EmbedFontResources` setting.

### Control page borders visibility

The following code snippet shows how to convert to HTML and control page borders visibility

```csharp
var source = "sample.docx";
using (var converter = new Converter(source))
{
    var options = new WebConvertOptions
    {
        FixedLayoutShowBorders = false
    };
    converter.Convert("converted.html" , options);
}
```

## More Resources

- [API Reference: WebConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})

---

## Convert to PDF with advanced options

Path: /conversion/java/convert-to-pdf-with-advanced-options/

 
[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) provides the [PdfConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/) class, which enables fine-grained control over the conversion process when converting documents to PDF format. In addition to common conversion options, the [PdfConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/) class offers several advanced features, including:
| Option | Description |
|--------|-------------|
|[**setFormat()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/#setFormat-com.groupdocs.conversion.filetypes.FileType-) | Specifies the desired output document format. Supported options include `Pdf`, `Epub`, `Xps`, `Tex`, `Ps`, and `Pcl`. |
|[**setPageWidth()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setPageWidth-float-) | Define the desired page width (in pixels) of the output document after conversion. |
|[**setPageHeight()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setPageHeight-float-) | Define the desired page height (in pixels) of the output document after conversion. |
|[**setDpi()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setDpi-int-) | Sets the desired resolution (dots per inch) of the resulting PDF. |
|[**setPassword()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setPassword-java.lang.String-) | Protects the output PDF with a password. |
|[**setMarginTop()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setMarginTop-int-) | Define the desired page top margin after conversion. |
|[**setMarginBottom()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setMarginBottom-int-) | Define the desired page bottom margin after conversion. |
|[**setMarginLeft()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setMarginLeft-int-) | Define the desired page left margin after conversion.|
|[**setMarginRight()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setMarginRight-int-) | Define the desired page right margin after conversion. |
|[**setPdfOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setPdfOptions-com.groupdocs.conversion.options.convert.PdfOptions-) | Specifies PDF-specific convert options. |
|[**setRotate()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfconvertoptions/#setRotate-com.groupdocs.conversion.options.convert.Rotation-) | Specifies page rotation. Supported options are `None`, `On90`, `On180`, and `On270`. |

The following code demonstrates how to convert a document to PDF with advanced options:

{{< tabs "code-example">}}
{{< tab "ConvertToPdfWithAdvancedOptions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.examples.Constants;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.convert.Rotation;

public class ConvertToPdfWithAdvancedOptions {
    public static void convert() {
        // Initialize the converter with the source document
        try(Converter converter = new Converter("annual-review.docx")) {
            // Configure advanced PDF conversion options
            PdfConvertOptions options = new PdfConvertOptions();
            options.setPageNumber(2);
            options.setPagesCount(1);
            options.setRotate(Rotation.On180);
            options.setDpi(300);
            options.setPageWidth(1024);
            options.setPageHeight(768);

            // Perform the conversion
            converter.convert("converted_with_options.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "annual-review.docx" >}}  
{{< tab-text >}}
`annual-review.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-pdf-with-advanced-options/annual-review.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_options.pdf" >}}  
{{< tab-text >}}
`converted_with_options.png` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-pdf-with-advanced-options/converted_with_options.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### PDF-Specific Options:

The [PdfOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/PdfOptions) class provides additional settings for customizing PDF output, allowing conversion to different PDF versions and optimizing PDF formatting:

| Option | Description |
|--------|-------------|
|[**setPdfFormat()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setPdfFormat-com.groupdocs.conversion.options.convert.PdfFormats-) | Sets the target PDF format (e.g., `PdfA_1A`, `PdfA_3B`, `v1_4`, `PdfX_1A`). |
|[**setRemovePdfACompliance()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setRemovePdfACompliance-boolean-) | Removes PDF/A compliance from the output document. |
|[**setZoom()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setZoom-int-) | Specifies the zoom level (percentage) for the output PDF. |
|[**setLinearize()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setLinearize-boolean-) | Linearizes the PDF for faster web viewing. |
|[**setGrayscale()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setGrayscale-boolean-) | Converts the output PDF to grayscale. |
|[**setOptimizationOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setOptimizationOptions-com.groupdocs.conversion.options.convert.PdfOptimizationOptions-) | Specifies PDF optimization options. |
|[**setFormattingOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setFormattingOptions-com.groupdocs.conversion.options.convert.PdfFormattingOptions-) | Specifies PDF formatting options. |

### PdfOptimizationOptions

The [PdfOptimizationOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptimizationoptions/) class allows to specify options for adjusting the PDF conversion process and improving its speed.

| Option | Description |
|--------|-------------|
|[**setLinkDuplicateStreams()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptimizationoptions/#setLinkDuplicateStreams-boolean-) | Eliminates link duplicate streams to reduce file size. |
|[**setRemoveUnusedObjects()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptimizationoptions/#setRemoveUnusedObjects-boolean-) | Removes unused objects from the document to optimize size. |
|[**setCompressImages()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptimizationoptions/#setCompressImages-boolean-) | Re-compresses all images in the document. The compression quality is defined by `setImageQuality`. |
|[**setImageQuality()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptimizationoptions/#setImageQuality-int-) | Specifies image quality as a percentage (100% represents no quality loss). |
|[**setUnembedFonts()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptimizationoptions/#setUnembedFonts-boolean-) | Makes fonts not embedded. |

### PdfFormattingOptions

The [PdfFormattingOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/) class provides different options to change the document look.
##### Window Appearance:
| Option | Description |
|--------|-------------|
|[**setCenterWindow()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfoptions/#setPdfFormat-com.groupdocs.conversion.options.convert.PdfFormats-) | Sets the target PDF format (e.g., `PdfA_1A`, `PdfA_3B`, `v1_4`, `PdfX_1A`). |
|[**setDirection()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setDirection-com.groupdocs.conversion.options.convert.PdfDirection-) | Sets reading order of text: L2R (left to right) or R2L (right to left). Available options are: `L2R`, `R2L`. |
|[**setDisplayDocTitle()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setDisplayDocTitle-boolean-) | Displays the document title in the window's title bar. |
|[**setFitWindow()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setFitWindow-boolean-) | Resizes the document window to fit the first displayed page. |
##### UI Customization:
| Option | Description |
|--------|-------------|
|[**setHideMenuBar()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setHideMenuBar-boolean-) | Hides the menu bar when the document is active. |
|[**setHideToolBar()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setHideToolBar-boolean-) | Hides the toolbar when the document is active. |
|[**setHideWindowUI()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setHideWindowUI-boolean-) | Hides UI elements when the document is active. |
##### Page Layout:
| Option | Description |
|--------|-------------|
|[**setNonFullScreenPageMode()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setNonFullScreenPageMode-com.groupdocs.conversion.options.convert.PdfPageMode-) | Specifies how to display the document on exiting full-screen mode. Available options are: `UseNone`, `UseOutlines`, `UseThumbs`, `FullScreen`, `UseOC`, `UseAttachments`. |
|[**setPageLayout()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setPageLayout-com.groupdocs.conversion.options.convert.PdfPageLayout-) | Specifies the layout for displaying pages. Options include `SinglePage`, `OneColumn`, `TwoColumnLeft`, and others. |
|[**setPageMode()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/pdfformattingoptions/#setPageMode-com.groupdocs.conversion.options.convert.PdfPageMode-) | Configures how the document is displayed when opened. |

By leveraging these advanced options, developers can precisely tailor the PDF conversion process to meet specific requirements, ensuring optimized and secure document output.
---

## Convert to PDF with advanced options

Path: /conversion/nodejs-java/convert-to-pdf-with-advanced-options/

[GroupDocs.Conversion](#) provides [PdfConvertOptions](h#) to give you control over conversion result when convert to PDF. Along with [common convert options](#)  [PdfConvertOptions](#) has the following additional options:
          
*   [setFormat](#) specifies desired result document type. Available options are: *Pdf, Epub, Xps, Tex, Ps, Pcl*.
*   [setWidth](#) specifies desired image width after conversion.
*   [setHeight](#) specifies desired image height after conversion.
*   [setDpi](#) specifies desired page DPI after conversion.
*   [setPassword](#) whether set the converted document will be protected with specified password.
*   [setMarginTop](#) specifies desired page top margin after conversion.
*   [setMarginBottom](#) specifies desired page bottom margin after conversion.
*   [setMarginLeft](#) specifies desired page left margin after conversion.
*   [setMarginRight](#) specifies desired page right margin after conversion.
*   [setPdfOptions](#) specifies PDF specific convert options.
*   [setRotate](#) specifies page rotation. Available options are: *None, On90, On180, On270*.


The following code snippet shows how to convert to PDF with advanced options

```js
const loadOptions = new groupdocs.conversion.WordProcessingLoadOptions()
loadOptions.setPassword("12345");

const converter = new groupdocs.conversion.Converter('sample.docx')
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

convertOptions.setPageNumber(2);
convertOptions.setPagesCount(1);
convertOptions.setRotate(groupdocs.conversion.Rotation.On180);
convertOptions.setDpi(300);
convertOptions.setWidth(1024);
convertOptions.setHeight(768);

converter.convert("converted.pdf", convertOptions);
```

### PdfOptions

[PdfOptions](#) class provides specific options when converting document to different versions of PDF format.

*   [setPdfFormat](#) sets pdf format of the converted document. Available options are: *Default, PdfA\_1A, PdfA\_1B, PdfA\_2A, PdfA\_3A, PdfA2B, PdfA\_2U, PdfA\_3B, PdfA\_3U, v1\_3, v1\_4, v1\_5, v1\_6, v1\_7, PdfX\_1A, PdfX\_3*.
*   [setRemovePdfACompliance](#) removes Pdf-A compliance.
*   [setZoom](#) specifies the zoom level in percentage.
*   [setLinearize](#) linearizes PDF document for web.
*   [setGrayscale](#) converts PDF file to grayscale.
*   [setOptimizationOptions](#) specifies PDF optimization options.
*   [setFormattingOptions](#) specifies PDF formatting options.

### PdfOptimizationOptions

[PdfOptimizationOptions](#) class allows to specify options for adjusting PDF conversion process and improve its speed.

*   [setLinkDuplicateStreams](#) removes link duplicate streams.
*   [setRemoveUnusedObjects](#) removes unused objects.
*   [setCompressImages](#) whether set to *true*, all images in the document are re-compressed. The amount of compression and image quality are defined by the [setImageQuality](#).
*   [setImageQuality](#) specifies value in percent where 100% is unchanged quality and image size. To decrease the image size set this property to less than 100.
*   [setUnembedFonts](#) specifies make fonts not embedded.

### PdfFormattingOptions

[PdfFormattingOptions](#) class provides different options to change PDF document look.

*   [setCenterWindow](#) specifies whether position of the document's window will be centered on the screen.
*   [setDirection](#) sets reading order of text: L2R (left to right) or R2L (right to left). Available options are: *L2R, R2L*.
*   [setDisplayDocTitle](#) specifies whether document's window title bar should display document title.
*   [setFitWindow](#) specifies whether document window must be resized to fit the first displayed page.
*   [setHideMenuBar](#) specifies whether menu bar should be hidden when document is active.
*   [setHideToolBar](#) specifies whether toolbar should be hidden when document is active.
*   [setHideWindowUI](#) specifies whether user interface elements should be hidden when document is active.
*   [setNonFullScreenPageMode](#) specifies how to display the document on exiting full-screen mode. Available options are: *UseNone, UseOutlines, UseThumbs, FullScreen, UseOC, UseAttachments*.
*   [setPageLayout](#) sets page layout which shall be used when the document is opened. Available options are: *Default, SinglePage, OneColumn, TwoColumnLeft, TwoColumnRight, TwoPagesLeft, TwoPagesRight*.
*   [setPageMode](#) - specifying how document should be displayed when opened.

---

## Custom text extractors

Path: /search/java/custom-text-extractors/

GroupDocs.Search supports indexing of many document formats. But there is also the possibility to implement support for any format other than the existing ones.

The following example demonstrates how to implement a custom text extractor.



```java
public class LogExtractor implements IFieldExtractor
{
    private final String[] extensions = new String[] {
        ".log"
    };
 
    public final String[] getExtensions() {
        return extensions;
    }
 
    public final DocumentField[] getFields(String filePath) {
        File file = new File(filePath);
        DocumentField[] fields = new DocumentField[] {
            new DocumentField("FileName", file.getAbsolutePath()),
            new DocumentField("Content", extractContent(filePath)),
        };
        return fields;
    }
 
    private String extractContent(String filePath) {
        StringBuilder result = new StringBuilder();
        try {
            List<String> lines = Files.readAllLines(Paths.get(filePath), StandardCharsets.UTF_8);
            for (int i = 0; i < lines.size(); i++) {
                String line = lines.get(i);
                String processedLine = line.substring(12);
                result.append(processedLine);
            }
        } catch (IOException ex) {
            throw new RuntimeException(ex);
        }
        return result.toString();
    }
}
```

The next example shows how to use the custorm extractor for indexing.



```java
String indexFolder = "c:\\MyIndex\\"; // Specify path to the index folder
String documentsFolder = "c:\\MyDocuments\\"; // Specify path to a folder containing documents to search
 
IndexSettings settings = new IndexSettings();
settings.getCustomExtractors().addItem(new LogExtractor()); // Adding custom text extractor to the index settings
 
Index index = new Index(indexFolder, settings); // Creating or loading an index
 
index.add(documentsFolder); // Indexing documents from the specified folder
```

Note that custom extractors are not saved in an index and must be created and added each time the index is created or loaded. However, the same code can be used to create a new index and open an existing one. In this case, when opening an existing index, custom extractors from the index settings passed to the constructor will be used, the remaining index settings will be loaded from disk.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Custom text extractors

Path: /search/net/custom-text-extractors/

GroupDocs.Search supports indexing of many document formats. But there is also the possibility to implement support for any format other than the existing ones.

The following example demonstrates how to implement a custom text extractor.

**C#**

```csharp
public class LogExtractor : IFieldExtractor
{
    private readonly string[] extensions = new string[] { ".log" };
 
    public string[] Extensions
    {
        get { return extensions; }
    }
 
    public DocumentField[] GetFields(string filePath)
    {
        FileInfo fileInfo = new FileInfo(filePath);
        DocumentField[] fields = new DocumentField[]
        {
            new DocumentField("FileName", fileInfo.FullName),
            new DocumentField("CreationDate", fileInfo.CreationTime.ToString(CultureInfo.InvariantCulture)),
            new DocumentField("Content", ExtractContent(filePath)),
        };
        return fields;
    }
 
    private string ExtractContent(string filePath)
    {
        string text = File.ReadAllText(filePath);
        return text;
    }
}
```

The next example shows how to use the custorm extractor for indexing.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\"; // Specify path to the index folder
string documentsFolder = @"c:\MyDocuments\"; // Specify path to a folder containing documents to search
 
IndexSettings settings = new IndexSettings();
settings.CustomExtractors.Add(new LogExtractor()); // Adding custom text extractor to the index settings
 
Index index = new Index(indexFolder, settings); // Creating or loading an index
 
index.Add(documentsFolder); // Indexing documents from the specified folder
```

Note that custom extractors are not saved in an index and must be created and added each time the index is created or loaded. However, the same code can be used to create a new index and open an existing one. In this case, when opening an existing index, custom extractors from the index settings passed to the constructor will be used, the remaining index settings will be loaded from disk.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Custom text extractors

Path: /search/nodejs-java/custom-text-extractors/

GroupDocs.Search supports indexing of many document formats. But there is also the possibility to implement support for any format other than the existing ones.

The following example demonstrates how to implement a custom text extractor and use it for indexing.

```javascript
const indexFolder = 'c:/MyIndex/'; // Specify path to the index folder
const documentsFolder = 'c:/MyDocuments/'; // Specify path to a folder containing documents to search

const settings = new groupdocs.search.IndexSettings();
const logExtractor = java.newProxy('com.groupdocs.search.common.IFieldExtractor', {
  getExtensions: function () {
    const array = java.newArray('java.lang.String', ['.log']);
    return array;
  },
  getFields: function (filePath) {
    const fileName = path.resolve(filePath);
    const contents = fs.readFileSync(filePath, 'utf8');
    const fields = java.newArray('com.groupdocs.search.common.DocumentField', [
      new groupdocs.search.DocumentField('FileName', fileName),
      new groupdocs.search.DocumentField('Content', contents),
    ]);
    return fields;
  },
});
settings.getCustomExtractors().addItem(logExtractor); // Adding custom text extractor to the index settings

const index = new groupdocs.search.Index(indexFolder, settings, true); // Creating or loading an index

index.add(documentsFolder); // Indexing documents from the specified folder

const query1 = 'objection';
const result1 = index.search(query1); // Searching

const query2 = 'log';
const result2 = index.search(query2); // Searching
```

Note that custom extractors are not saved in an index and must be created and added each time the index is created or loaded. However, the same code can be used to create a new index and open an existing one. In this case, when opening an existing index, custom extractors from the index settings passed to the constructor will be used, the remaining index settings will be loaded from disk.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Custom text segmenter

Path: /search/net/custom-text-segmenter/


Some languages, in particular hieroglyphic languages, typically require special tools to split text into words.
This is necessary due to the lack of spaces between words, polysemantic phrases, set expressions, and complex lexical rules.

Currently, the GroupDocs.Search library does not contain such special algorithms for splitting Chinese, Japanese, and Korean text into words. However, it provides the ability to use external custom algorithms for this. To connect an external text segmentation library, you must implement the [IWordSplitter](https://reference.groupdocs.com/search/net/groupdocs.search.common/iwordsplitter/) interface and pass an object implementing this interface to the [WordSplitter](https://reference.groupdocs.com/search/net/groupdocs.search.events/fileindexingeventargs/wordsplitter/) property of the [FileIndexing](https://reference.groupdocs.com/search/net/groupdocs.search.events/eventhub/fileindexing/) event arguments.

The code example below demonstrates how to use the external library [Jieba.NET](https://www.nuget.org/packages/jieba.NET/) for Chinese text segmentation.

**C#**

```csharp
// Implementing custom word splitter
public class JiebaWordSplitter : IWordSplitter
{
    private readonly JiebaSegmenter segmenter;

    public JiebaWordSplitter()
    {
        segmenter = new JiebaSegmenter();
    }

    public IEnumerable<string> Split(string text)
    {
        IEnumerable<string> segments = segmenter.Cut(text, cutAll: false);
        return segments;
    }
}

...

string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Using Jieba segmenter to break text into words
JiebaWordSplitter jiebaWordSplitter = new JiebaWordSplitter();
index.Events.FileIndexing += (s, e) =>
{
    if (e.DocumentFullPath.EndsWith("Chinese.txt"))
    {
        // We know that the text in this document is in Chinese
        e.WordSplitter = jiebaWordSplitter;
    }
};

// Indexing documents
index.Add(documentsFolder);

// Searching in the index
string query = "考虑"; // Consider
SearchResult result = index.Search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Date range search

Path: /search/java/date-range-search/

This page describes how you can search by date with date range search. As well it describes the creation of date wise search queries, and also describes the management of formats for date range search.

## Creating date range search queries

Date range search allows you to search in documents dates from a given range in given date formats.

Queries for date range search in text form are specified in the following format:

*   daterange( date ~~ date )

where date is the date in yyyy-MM-dd format, for example, 2019-09-13. Please note that in a search query, dates are always set in the same format.

The following example demonstrates how to search by date using queries in text and object form.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search for dates using query in text form
String query1 = "daterange(2017-01-01 ~~ 2019-12-31)";
SearchResult result1 = index.search(query1);
 
// Search for dates using query in text form
SearchQuery query2 = SearchQuery.createDateRangeQuery(new Date(2017 - 1900, 1 - 1, 1), new Date(2019 - 1900, 12 - 1, 31));
SearchResult result2 = index.search(query2);
```

## Specifying date range search formats

To perform the date range search, the date templates specified in the search options are used. The following formats are used by default:

*   dd.MM.yyyy
*   MM/dd/yyyy
*   yyyy-MM-dd

Formats for date range search are set in the collection that is returned by the [getDateFormats](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#getDateFormats()) method of the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class. To add a format, use the [addItem](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatCollection#addItem(com.groupdocs.search.options.DateFormat)) method, to remove it, use the [removeItem](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatCollection#removeItem(com.groupdocs.search.options.DateFormat)) method, to clear a collection of existing formats, use the [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatCollection#clear()) method. Each format in the collection is defined by an instance of the [DateFormat](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormat) class. To create a new format, you must specify a sequence of format elements and a separator character. All available format elements are represented in the [DateFormatElement](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement) class:

*   [getDayOfMonth](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getDayOfMonth()) method returns the day of month element, represented by one or two digits;
*   [getDayOfMonthTwoDigits](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getDayOfMonthTwoDigits()) method returns the day of month element, represented by two digits;
*   [getMonth](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getMonth()) method returns the month element, represented by one or two digits;
*   [getMonthTwoDigits](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getMonthTwoDigits()) method returns the month element, represented by two digits;
*   [getMonthAbbreviatedName](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getMonthAbbreviatedName()) method returns the month element, represented by abbreviated name;
*   [getMonthFullName](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getMonthFullName()) method returns the month element, represented by full name;
*   [getYear](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getYear()) method returns the year element, represented by one, two, three, or four digits;
*   [getYearTwoDigits](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getYearTwoDigits()) method returns the year element, represented by two digits;
*   [getYearFourDigits](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getYearFourDigits()) method returns the year element, represented by four digits;
*   [getDateSeparator](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/DateFormatElement#getDateSeparator()) method returns the date separator element.

An example of setting the date format for the search is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Setting date formats
SearchOptions options = new SearchOptions();
options.getDateFormats().clear(); // Removing default date formats
DateFormatElement[] elements = new DateFormatElement[]
{
    DateFormatElement.getMonthTwoDigits(),
    DateFormatElement.getDateSeparator(),
    DateFormatElement.getDayOfMonthTwoDigits(),
    DateFormatElement.getDateSeparator(),
    DateFormatElement.getYearFourDigits(),
};
// Creating a date format pattern 'MM/dd/yyyy'
DateFormat dateFormat = new DateFormat(elements, "/");
options.getDateFormats().addItem(dateFormat);
 
// Searching in the index.
// For the given query, for example, the date 09/27/2019 will be found,
// but the date 2019-09-27 will not be found, because it is presented in a format that is not specified in the search options.
SearchResult result = index.search("daterange(2017-01-01 ~~ 2019-12-31)", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Date range search

Path: /search/net/date-range-search/

This page describes how you can search by date with date range search. As well it describes the creation of date wise search queries, and also describes the management of formats for date range search.

## Creating date range search queries

Date range search allows you to search in documents dates from a given range in given date formats.

Queries for date range search in text form are specified in the following format:

*   daterange( date ~~ date )

where date is the date in yyyy-MM-dd format, for example, 2019-09-13. Please note that in a search query, dates are always set in the same format.

The following example demonstrates how to search by date using queries in text and object form.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search for dates using query in text form
string query1 = "daterange(2017-01-01 ~~ 2019-12-31)";
SearchResult result1 = index.Search(query1);
 
// Search for dates using query in text form
SearchQuery query2 = SearchQuery.CreateDateRangeQuery(new DateTime(2017, 1, 1), new DateTime(2019, 12, 31));
SearchResult result2 = index.Search(query2);
```

## Specifying date range search formats

To perform the date range search, the date templates specified in the search options are used. The following formats are used by default:

*   dd.MM.yyyy
*   MM/dd/yyyy
*   yyyy-MM-dd

Formats for date range search are set in the [DateFormats](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/dateformats) property of the [SearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions) class. To add a format, use the [Add](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatcollection/methods/add) method, to remove it, use the [Remove](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatcollection/methods/remove) method, to clear a collection of existing formats, use the [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatcollection/methods/clear) method. Each format in the collection is defined by an instance of the [DateFormat](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformat) class. To create a new format, you must specify a sequence of format elements and a separator character. All available format elements are represented in the [DateFormatElement](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement) class:

*   [DayOfMonth](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/dayofmonth) specifies the day of month element, represented by one or two digits;
*   [DayOfMonthTwoDigits](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/dayofmonthtwodigits) specifies the day of month element, represented by two digits;
*   [Month](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/month) specifies the month element, represented by one or two digits;
*   [MonthTwoDigits](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/monthtwodigits) specifies the month element, represented by two digits;
*   [MonthAbbreviatedName](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/monthabbreviatedname) specifies the month element, represented by abbreviated name;
*   [MonthFullName](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/monthfullname) specifies the month element, represented by full name;
*   [Year](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/year) specifies the year element, represented by one, two, three, or four digits;
*   [YearTwoDigits](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/yeartwodigits) specifies the year element, represented by two digits;
*   [YearFourDigits](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/yearfourdigits) specifies the year element, represented by four digits;
*   [DateSeparator](https://reference.groupdocs.com/net/search/groupdocs.search.options/dateformatelement/properties/dateseparator) specifies the date separator element.

An example of setting the date format for the search is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Setting date formats
SearchOptions options = new SearchOptions();
options.DateFormats.Clear(); // Removing default date formats
DateFormatElement[] elements = new DateFormatElement[]
{
    DateFormatElement.MonthTwoDigits,
    DateFormatElement.DateSeparator,
    DateFormatElement.DayOfMonthTwoDigits,
    DateFormatElement.DateSeparator,
    DateFormatElement.YearFourDigits,
};
// Creating a date format pattern 'MM/dd/yyyy'
DateFormat dateFormat = new DateFormat(elements, "/");
options.DateFormats.Add(dateFormat);
 
// Searching in the index.
// For the given query, for example, the date 09/27/2019 will be found,
// but the date 2019-09-27 will not be found, because it is presented in a format that is not specified in the search options.
SearchResult result = index.Search("daterange(2017-01-01 ~~ 2019-12-31)", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Date range search

Path: /search/nodejs-java/date-range-search/

This page describes how you can search by date with date range search. As well it describes the creation of date wise search queries, and also describes the management of formats for date range search.

## Creating date range search queries

Date range search allows you to search in documents dates from a given range in given date formats.

Queries for date range search in text form are specified in the following format:

*   daterange( date ~~ date )

where date is the date in yyyy-MM-dd format, for example, 2019-09-13. Please note that in a search query, dates are always set in the same format.

The following example demonstrates how to search by date using queries in text and object form.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search for dates using query in text form
const query1 = 'daterange(2017-01-01 ~~ 2019-12-31)';

const result1 = index.search(query1);
// Search for dates using query in text form
const query2 = groupdocs.search.SearchQuery.createDateRangeQuery(
  Utils.createDate(2017, 1, 1),
  Utils.createDate(2019, 12, 31),
);
const result2 = index.search(query2);
```

## Specifying date range search formats

To perform the date range search, the date templates specified in the search options are used. The following formats are used by default:

*   dd.MM.yyyy
*   MM/dd/yyyy
*   yyyy-MM-dd

Formats for date range search are set in the collection that is returned by the [getDateFormats](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#getDateFormats()) method of the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class. To add a format, use the [addItem](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatCollection#addItem(com.groupdocs.search.options.DateFormat)) method, to remove it, use the [removeItem](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatCollection#removeItem(com.groupdocs.search.options.DateFormat)) method, to clear a collection of existing formats, use the [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatCollection#clear()) method. Each format in the collection is defined by an instance of the [DateFormat](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormat) class. To create a new format, you must specify a sequence of format elements and a separator character. All available format elements are represented in the [DateFormatElement](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement) class:

*   [getDayOfMonth](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getDayOfMonth()) method returns the day of month element, represented by one or two digits;
*   [getDayOfMonthTwoDigits](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getDayOfMonthTwoDigits()) method returns the day of month element, represented by two digits;
*   [getMonth](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getMonth()) method returns the month element, represented by one or two digits;
*   [getMonthTwoDigits](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getMonthTwoDigits()) method returns the month element, represented by two digits;
*   [getMonthAbbreviatedName](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getMonthAbbreviatedName()) method returns the month element, represented by abbreviated name;
*   [getMonthFullName](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getMonthFullName()) method returns the month element, represented by full name;
*   [getYear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getYear()) method returns the year element, represented by one, two, three, or four digits;
*   [getYearTwoDigits](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getYearTwoDigits()) method returns the year element, represented by two digits;
*   [getYearFourDigits](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getYearFourDigits()) method returns the year element, represented by four digits;
*   [getDateSeparator](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/DateFormatElement#getDateSeparator()) method returns the date separator element.

An example of setting the date format for the search is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Setting date formats
const options = new groupdocs.search.SearchOptions();
options.getDateFormats().clear(); // Removing default date formats
const elements = java.newArray('com.groupdocs.search.options.DateFormatElement', [
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getMonthTwoDigits'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDateSeparator'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDayOfMonthTwoDigits'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getDateSeparator'),
  java.callStaticMethodSync('com.groupdocs.search.options.DateFormatElement', 'getYearFourDigits'),
]);
// Creating a date format pattern 'MM/dd/yyyy'
const dateFormat = new groupdocs.search.DateFormat(elements, '/');
options.getDateFormats().addItem(dateFormat);

// Searching in the index.
// For the given query, for example, the date 09/27/2019 will be found,
// but the date 2019-09-27 will not be found, because it is presented in a format that is not specified in the search options.
const query = 'daterange(2017-01-01 ~~ 2019-12-31)';
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Deleting slides from presentation

Path: /editor/java/deleting-slides-from-presentation/

There are many [presentation](https://docs.fileformat.com/presentation/) document formats — [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTX](https://docs.fileformat.com/presentation/pptx/), [ODP](https://docs.fileformat.com/presentation/odp/) and many more. They all have one common thing — the *slides*. Each presentation document has one or more slides, and these slides may be treated as containers of different content: text, geometric shapes, raster and vector images, animations, video, audio, comments, embedded objects and many more. The GroupDocs.Editor from its beginning had an ability to edit presentations, but only on a per-slide basis: a user can edit only the content of one slide at a time.

Initially, when the content of the slide was edited, it was only possible to save it as a new one-slide presentation. In particular, the pipeline was the next: user loads a presentation to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class, selects the slide to edit with help of [`PresentationEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationeditoptions/), obtains [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/), edits the HTML-content of the slide, saves this content back to the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/), and finally generates a new presentation file with one slide using the [`Editor.Save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-java.io.OutputStream-) method.

After release of the [version 20.4](https://releases.groupdocs.com/editor/net/release-notes/2020/groupdocs-editor-for-net-20-4-release-notes/), when the new SlideNumber
property was introduced, this pipeline was expanded — it became possible to insert an edited slide into the original presentation using two ways:

1. by replacing the original slide, that was initially set for editing, onto its edited version,
2. and by putting the edited slide to “co-exist” together with its original version before edit.

This mechanism is explained in detail in a [separate article](https://docs.groupdocs.com/editor/java/inserting-edited-slide-into-existing-presentation/).

Starting from the [version 26.1](https://releases.groupdocs.com/editor/java/release-notes/2026/groupdocs-editor-for-java-26-1-release-notes/), it is possible not only to edit and replace slides in the resultant presentation, but also delete them from it. The [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/) class now contains one new property — a `int[]` [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setSlideNumbersToDelete-int---), which basically is an array of integers, where each integer represents a number of one slide that should be removed. Slide numbers here are 1-based, so the 1st slide has number `1`, not `0`.

With the new slides removal feature the GroupDocs.Editor performs the next algorithm during saving the presentation:

1. User edits a content of the slide in the WYSIWYG-editor, passes the edited content to the instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) class [using one of its static methods](https://docs.groupdocs.com/editor/java/create-editabledocument-from-file-or-markup/), creates and adjusts the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/), and passes the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance, [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/) instance, and output stream or file path for writing to the [`Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-java.io.OutputStream-) method.
2. If the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setSlideNumber-int-) property in the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/) instance is set to the default value `0`, the GroupDocs.Editor generates a new presentation with one slide inside it. The [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setSlideNumbersToDelete-int---) property is ignored regardless of its value.
3. If the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setSlideNumber-int-) property in the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/) instance has some non-zero value, the GroupDocs.Editor treats it as a command to insert the edited slide into the original presentation.
4. Depending on the [`InsertAsNewSlide`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setInsertAsNewSlide-boolean-) property, the GroupDocs.Editor replaces old slide, specified by the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setSlideNumber-int-) property, on the new one, taken from the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance, or puts the new slide to be placed among existing slides without replacing any of them.
5. Finally, when all slide insertions and rearrangements are finished, the GroupDocs.Editor reads the value of the [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setSlideNumbersToDelete-int---) property, iterates over all numbers and removes specified slides from the presentation.
6. The final presentation, with updated and deleted slides, is written to the output stream or file.

Example below shows full roundtrip of input PPT file: presentation with 21 slides inside is loaded, its second slide is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/), then HTML-markup is emitted from the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance, modified, and then edited HTML-markup is converted back to the another [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance. From this point two instances of the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/) class are created — one is intended for generating a first version of an output presentation with a new slide and without deletion and finally it has 22 slides in total (21 original + 1 edited). The second [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/) instance has the [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/#setSlideNumbersToDelete-int---) property set to remove the first and last slides, so the 2nd version of an output presentation will have 20 slides in total (19 original + 1 edited).

{{< tabs "code-example">}}
{{< tab "DeleteSlidesFromLoadedAndEditedPresentations.java" >}}  
```java
import com.groupdocs.editor.EditableDocument;
import com.groupdocs.editor.Editor;
import com.groupdocs.editor.examples.Constants;
import com.groupdocs.editor.formats.PresentationFormats;
import com.groupdocs.editor.options.*;

public class DeleteSlidesFromLoadedAndEditedPresentations {
    public static void edit() {
		// Load input presentation to the Editor and specify loading options
        Editor editor = new Editor("Presentations-Tips.ppt", new PresentationLoadOptions());
        try {
            // Prepare edit options and set 2nd slide to edit
            PresentationEditOptions editOptions = new PresentationEditOptions();
            editOptions.setShowHiddenSlides(true);
            editOptions.setSlideNumber(1); // 2nd slide to edit, here SlideNumber is 0-based (historical reasons)

            // generate EditableDocument with original content of 2nd slide
            EditableDocument slide2OpenedForEdit = editor.edit(editOptions);
            try {
                // Get the HTML-markup from the EditableDocument with original content
                String originalHtmlContentOf2ndSlide = slide2OpenedForEdit.getEmbeddedHtml();

                // emulate HTML content editing in WYSIWYG-editor in browser or somewhere else
                String editedHtmlContentOf2ndSlide =
                        originalHtmlContentOf2ndSlide.replace("Tips to be Covered", "Edited tips on 2nd slide");

                // generate EditableDocument with edited content of 2nd slide
                EditableDocument slide2AfterEdit = EditableDocument.fromMarkup(editedHtmlContentOf2ndSlide, null);
                try {
                    // prepare save options without deletions
                    PresentationSaveOptions saveOptionsWithoutDelete = new PresentationSaveOptions(PresentationFormats.Pptx);
                    // let it be the 2nd slide...
                    saveOptionsWithoutDelete.setSlideNumber(2); // here SlideNumber is 1-based
                    // ... and we also save the original 2nd slide, which is pushed to the 3rd position
                    saveOptionsWithoutDelete.setInsertAsNewSlide(true);

                    // So now the presentation must have 22 slides, not 21. Save it to file
                    String outputSlides_without_delete = Constants.getOutputDirectoryPath("Output22Slides-without-delete.pptx");
                    editor.save(slide2AfterEdit, outputSlides_without_delete, saveOptionsWithoutDelete);

                    // Create another save options, with deletions at this time
                    PresentationSaveOptions saveOptionsWithDelete = new PresentationSaveOptions(PresentationFormats.Pptx);
                    // let the new slide be 2nd for now, but after deleting it will become the 1st later
                    saveOptionsWithDelete.setSlideNumber(2);

                    // ... and we also save the original 2nd slide, which will be next sibling to the newly inserted
                    saveOptionsWithDelete.setInsertAsNewSlide(true);

                    // delete the 1st and last slide
                    saveOptionsWithDelete.setSlideNumbersToDelete(new int[]{
                            1,  // 1st slide
                            22  // last slide is 22 (because we inserted a new slide without rewriting the original 2nd slide)
                    });

                    // Save it again to distinct file. Output PPTX should have 20 slides now.
                    String outputSlides_with_delete = Constants.getOutputDirectoryPath("Output20Slides-with-delete.pptx");
                    editor.save(slide2AfterEdit, outputSlides_with_delete, saveOptionsWithDelete);
                } finally {
                    slide2AfterEdit.dispose();
                }
            } finally {
                slide2OpenedForEdit.dispose();
            }
        } finally {
            editor.dispose();
        }
    }

    public static void main(String[] args){
        edit();
    }
}
```
{{< /tab >}}
{{< tab "Presentations-Tips.ppt" >}}  
{{< tab-text >}}
`Presentations-Tips.ppt` is sample file used in this example. Click [here](/editor/java/sample-files/Presentations-Tips.ppt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "Output22Slides-without-delete.pptx" >}}  
{{< tab-text >}}
`Output20Slides-with-delete.pptx` is edited document with deleted slides. Click [here](/editor/java/sample-files/Output20Slides-with-delete.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "Output22Slides-without-delete.pptx" >}}  
{{< tab-text >}}
`Output22Slides-without-delete.pptx` is edited document without deleted slides. Click [here](/editor/java/sample-files/Output22Slides-without-delete.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Deleting slides from presentation

Path: /editor/net/deleting-slides-from-presentation/

There are many [presentation](https://docs.fileformat.com/presentation/) document formats — [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTX](https://docs.fileformat.com/presentation/pptx/), [ODP](https://docs.fileformat.com/presentation/odp/) and many more. They all have one common thing — the *slides*. Each presentation document has one or more slides, and these slides may be treated as containers of different content: text, geometric shapes, raster and vector images, animations, video, audio, comments, embedded objects and many more. The GroupDocs.Editor from its beginning had an ability to edit presentations, but only on a per-slide basis: a user can edit only the content of one slide at a time.

Initially, when the content of the slide was edited, it was only possible to save it as a new one-slide presentation. In particular, the pipeline was the next: user loads a presentation to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class, selects the slide to edit with help of [`PresentationEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationeditoptions), obtains [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), edits the HTML-content of the slide, saves this content back to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), and finally generates a new presentation file with one slide using the [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

After release of the [version 20.4](https://releases.groupdocs.com/editor/net/release-notes/2020/groupdocs-editor-for-net-20-4-release-notes/), when the new SlideNumber
property was introduced, this pipeline was expanded — it became possible to insert an edited slide into the original presentation using two ways:

1. by replacing the original slide, that was initially set for editing, onto its edited version,
2. and by putting the edited slide to “co-exist” together with its original version before edit.

This mechanism is explained in detail in a [separate article](https://docs.groupdocs.com/editor/net/inserting-edited-slide-into-existing-presentation/).

Starting from the [version 25.11](https://releases.groupdocs.com/editor/net/release-notes/2025/groupdocs-editor-for-net-25-11-release-notes/), it is possible not only to edit and replace slides in the resultant presentation, but also delete them from it. The [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) class now contains one new property — a `int[]` [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumberstodelete/), which basically is an array of integers, where each integer represents a number of one slide that should be removed. Slide numbers here are 1-based, so the 1st slide has number `1`, not `0`.

With the new slides removal feature the GroupDocs.Editor performs the next algorithm during saving the presentation:

1. User edits a content of the slide in the WYSIWYG-editor, passes the edited content to the instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class [using one of its static methods](https://docs.groupdocs.com/editor/net/create-editabledocument-from-file-or-markup/), creates and adjusts the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions), and passes the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance, and output stream or file path for writing to the [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.
2. If the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property in the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance is set to the default value `0`, the GroupDocs.Editor generates a new presentation with one slide inside it. The [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumberstodelete/) property is ignored regardless of its value.
3. If the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property in the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance has some non-zero value, the GroupDocs.Editor treats it as a command to insert the edited slide into the original presentation.
4. Depending on the [`InsertAsNewSlide`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide) property, the GroupDocs.Editor replaces old slide, specified by the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property, on the new one, taken from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, or puts the new slide to be placed among existing slides without replacing any of them.
5. Finally, when all slide insertions and rearrangements are finished, the GroupDocs.Editor reads the value of the [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumberstodelete/) property, iterates over all numbers and removes specified slides from the presentation.
6. The final presentation, with updated and deleted slides, is written to the output stream or file.

Example below shows full roundtrip of input PPT file: presentation with 21 slides inside is loaded, its second slide is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), then HTML-markup is emitted from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, modified, and then edited HTML-markup is converted back to the another [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance. From this point two instances of the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) class are created — one is intended for generating a first version of an output presentation with a new slide and without deletion and finally it has 22 slides in total (21 original + 1 edited). The second [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance has the [`SlideNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumberstodelete/) property set to remove the first and last slides, so the 2nd version of an output presentation will have 20 slides in total (19 original + 1 edited).

Input PPT as well as two versions of the output PPTX files may be downloaded here:
- [Presentations-Tips.ppt](/editor/net/sample-files/Presentations-Tips.ppt)
- [Output22Slides-without-delete.pptx](/editor/net/sample-files/Output22Slides-without-delete.pptx)
- [Output20Slides-with-delete.pptx](/editor/net/sample-files/Output20Slides-with-delete.pptx)

{{< tabs "DeleteSlidesFromLoadedAndEditedPresentations">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Editor;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;
// ...

// Load input presentation to the Editor and specify loading options
using (Editor editor = new Editor("Presentations-Tips.ppt", new PresentationLoadOptions()))
{
    // Prepare edit options and set 2nd slide to edit
    PresentationEditOptions editOptions = new PresentationEditOptions();
    editOptions.ShowHiddenSlides = true;
    editOptions.SlideNumber = 1;//2nd slide to edit, here SlideNumber is 0-based due to historical reasons

    //generate EditableDocument with original content of 2nd slide
    using (EditableDocument slide2OpenedForEdit = editor.Edit(editOptions))
    {
        // Get the HTML-markup from the EditableDocument with original content
        string originalHtmlContentOf2ndSlide = slide2OpenedForEdit.GetEmbeddedHtml();

        //emulate HTML content editing in WYSIWYG-editor in browser or somewhere else
        string editedHtmlContentOf2ndSlide = originalHtmlContentOf2ndSlide.Replace("Tips to be Covered", "Edited tips on 2nd slide");

        //generate EditableDocument with edited content of 2nd slide
        using (EditableDocument slide2AfterEdit = EditableDocument.FromMarkup(editedHtmlContentOf2ndSlide))
        {
            //prepare save options without deletions
            PresentationSaveOptions saveOptionsWithoutDelete = new PresentationSaveOptions(PresentationFormats.Pptx);
            // let it be the 2nd slide...
            saveOptionsWithoutDelete.SlideNumber = 2;//here SlideNumber is 1-based
            //... and we also save the original 2nd slide, which is pushed to the 3rd position
            saveOptionsWithoutDelete.InsertAsNewSlide = true;

            // So now the presentation must have 22 slides, not 21. Save it to file
            editor.Save(slide2AfterEdit, "Output22Slides-without-delete.pptx", saveOptionsWithoutDelete);

            // Create another save options, with deletions at this time
            PresentationSaveOptions saveOptionsWithDelete = new PresentationSaveOptions(PresentationFormats.Pptx);
            // let the new slide will be 2nd for now, but after deleting it will became the 1st later
            saveOptionsWithDelete.SlideNumber = 2;

            //... and we also save the original 2nd slide, which will be next sibling to the newly inserted
            saveOptionsWithDelete.InsertAsNewSlide = true;

            // delete the 1st and last slide
            saveOptionsWithDelete.SlideNumbersToDelete = new int[2]
            {
                1,//1st slide
                22//last slide is 22, not 21, because we inserted the edited 2nd slide as the new slide instance, without rewriting the original 2nd slide
            };
            // Save it again to distinct file. Output PPTX should have 20 slides now.
            editor.Save(slide2AfterEdit, "Output20Slides-with-delete.pptx", saveOptionsWithDelete);
        }
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Editor
Imports GroupDocs.Editor.Formats
Imports GroupDocs.Editor.Options
' ...

' Load input presentation to the Editor and specify loading options
Using editor As New Editor("Presentations-Tips.ppt", New PresentationLoadOptions())
    ' Prepare edit options and set 2nd slide to edit
    Dim editOptions As New PresentationEditOptions
    editOptions.ShowHiddenSlides = True
    editOptions.SlideNumber = 1 '2nd slide to edit, here SlideNumber is 0-based due to historical reasons

    ' generate EditableDocument with original content of 2nd slide
    Using slide2OpenedForEdit As EditableDocument = editor.Edit(editOptions)
        ' Get the HTML-markup from the EditableDocument with original content
        Dim originalHtmlContentOf2ndSlide As String = slide2OpenedForEdit.GetEmbeddedHtml()

        ' emulate HTML content editing in WYSIWYG-editor in browser or somewhere else
        Dim editedHtmlContentOf2ndSlide As String = originalHtmlContentOf2ndSlide.Replace("Tips to be Covered", "Edited tips on 2nd slide")

        ' generate EditableDocument with edited content of 2nd slide
        Using slide2AfterEdit As EditableDocument = EditableDocument.FromMarkup(editedHtmlContentOf2ndSlide)
            ' prepare save options without deletions
            Dim saveOptionsWithoutDelete As New PresentationSaveOptions(PresentationFormats.Pptx)

            ' let it be the 2nd slide...
            saveOptionsWithoutDelete.SlideNumber = 2
            '... and we also save the original 2nd slide, which is pushed to the 3rd position
            saveOptionsWithoutDelete.InsertAsNewSlide = True

            ' So now the presentation must have 22 slides, not 21. Save it to file
            editor.Save(slide2AfterEdit, "Output22Slides-without-delete.pptx", saveOptionsWithoutDelete)

            ' Create another save options, with deletions at this time
            Dim saveOptionsWithDelete As New PresentationSaveOptions(PresentationFormats.Pptx)
            ' let the new slide will be 2nd for now, but after deleting it will became the 1st later
            saveOptionsWithDelete.SlideNumber = 2
            '... and we also save the original 2nd slide, which will be next sibling to the newly inserted
            saveOptionsWithDelete.InsertAsNewSlide = True

            'delete the 1st and last slide
            saveOptionsWithDelete.SlideNumbersToDelete = New Int32(1) {
                1,' 1St slide
                22'last slide is 22, not 21, because we inserted the edited 2nd slide as the new slide instance, without rewriting the original 2nd slide
            }
            ' Save it again to distinct file. Output PPTX should have 20 slides now.
            editor.Save(slide2AfterEdit, "Output20Slides-with-delete.pptx", saveOptionsWithDelete)
        End Using
    End Using
End Using
```
{{< /tab >}}
{{< /tabs >}}

---

## Deleting worksheets from spreadsheet

Path: /editor/java/deleting-worksheets-from-spreadsheet/

A **spreadsheet**, also known as a **workbook** — is a [family of the document formats](https://docs.fileformat.com/spreadsheet/), designed to work with tabular data. [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [CSV](https://docs.fileformat.com/spreadsheet/csv/) formats are the most common examples of such document formats, while Microsoft Excel, LibreOffice Calc, Apache OpenOffice Calc are examples of table processors — programs, which allow the creation and editing of such documents. GroupDocs.Editor has an ability to edit existing spreadsheet documents from its beginning, and starting from the [version 24.6](https://releases.groupdocs.com/editor/net/release-notes/2024/groupdocs-editor-for-net-24-6-release-notes/) it has obtained an ability not only to edit already existing spreadsheets, but also to create new spreadsheets from scratch. And starting from the [version 26.1](https://releases.groupdocs.com/editor/java/release-notes/2026/groupdocs-editor-for-java-26-1-release-notes/) the GroupDocs.Editor has obtained a feature to delete worksheets from the edited spreadsheet during saving.

Need to keep in mind that not every spreadsheet may have the worksheets. For example, text-based separator-delimited formats like [CSV](https://docs.fileformat.com/spreadsheet/csv/) and [TSV](https://docs.fileformat.com/spreadsheet/tsv/) are basically the text files, they have no worksheets, so the worksheet cannot be removed from them. But almost all of the binary spreadsheet formats like XLS, XLSX and ODS do have them.

In GroupDocs.Editor the user edits one worksheet at a time — the spreadsheet [is loaded](https://docs.groupdocs.com/editor/java/load-document/) to the constructor of the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class, then worksheet is specified by its number in the [`SpreadsheetEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheeteditoptions/), and then document is converted to the editable form, represented by the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) class. Straight and simple. However, when the content of the worksheet was edited by the user and passed back to the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) class, there are two options:

1. Users can save the edited content of the worksheet as a new spreadsheet with this single worksheet inside. This is the default behaviour that was present in the GroupDocs.Editor from its beginning.
2. Users can save the edited worksheet by inserting it to the original spreadsheet. This was made possible starting from the [version 20.10](https://releases.groupdocs.com/editor/net/release-notes/2020/groupdocs-editor-for-net-20-10-release-notes/) and is described in a [separate article](https://docs.groupdocs.com/editor/java/inserting-edited-worksheet-into-existing-spreadsheet/). This second option also has two sub-options:
    1. The edited worksheet can *replace* the original worksheet in the input spreadsheet. For instance, in the loaded spreadsheet with 3 worksheets the user has chosen the 2nd one for edit; this worksheet was edited and then inserted back to the input spreadsheet, replacing the original 2nd worksheet onto the edited one.
    2. The edited worksheet can be inserted into the input spreadsheet to stay *together* with the original one. For instance, in the loaded spreadsheet with 3 worksheets the user has chosen the 2nd one for edit; this worksheet was edited and then inserted back to the input spreadsheet, so now the spreadsheet contains 4 worksheets: the first, fourth, and two versions of the second (original and edited).

Starting from the [version 26.1](https://releases.groupdocs.com/editor/java/release-notes/2026/groupdocs-editor-for-java-26-1-release-notes/), when the 2nd option (inserting edited worksheet into the original spreadsheet), users also can delete particular worksheet(s) from it. A new property was added to the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) class — [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumbersToDelete-int---) of `int[]` type. By default it has a `null` value, which means that no worksheets should be removed. However, when it has one or more valid worksheet numbers, the worksheets with these numbers are removed while calling the [`Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-java.io.OutputStream-) method.

Need to mention that the worksheet numbers in a [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumbersToDelete-int---) property are 1-based. For instance, for removing the first and fourth worksheets the [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumbersToDelete-int---) property should have a `new int[2] {1, 4}` value.

With the new worksheet removal feature the GroupDocs.Editor performs the next algorithm during saving the spreadsheet:

1. User edits a content of the worksheet in the WYSIWYG-editor, passes the edited content to the instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) class [using one of its static methods](https://docs.groupdocs.com/editor/java/create-editabledocument-from-file-or-markup/), creates and adjusts the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/), and passes the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance, [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) instance, and output stream or file path for writing to the [`Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-java.io.OutputStream-) method.
2. If the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumber-int-) property in the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) instance is set to the default value `0`, the GroupDocs.Editor generates a new spreadsheet with one worksheet. The [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumbersToDelete-int---) property is ignored regardless of its value.
3. If the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumber-int-) property in the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) instance has some non-zero value, the GroupDocs.Editor treats it as a command to insert the edited worksheet into the original spreadsheet.
4. Depending on the [`InsertAsNewWorksheet`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setInsertAsNewWorksheet-boolean-) property, the GroupDocs.Editor replaces old worksheet, specified by the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumber-int-) property, on the new one, taken from the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance, or puts the new worksheet to be placed among existing worksheets without replacing any of them.
5. Finally, when all worksheet insertions and rearrangements are finished, the GroupDocs.Editor reads the value of the [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/#setWorksheetNumbersToDelete-int---) property, iterates over all numbers and removes specified worksheets from the spreadsheet.
6. The final spreadsheet, with updated and deleted worksheets, is written to the output stream or file.

Example below shows full roundtrip of input XLSX file: spreadsheet with 3 worksheets inside is loaded, its second worksheet is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/), then HTML-markup is emitted from the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance, modified, and then edited HTML-markup is converted back to the another [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance. From this point two instances of the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) class are created — one is intended for generating a first version of an output spreadsheet with a new worksheet and without deletion and finally it has 4 worksheets in total (3 original + 1 edited). The second [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) instance has the WorksheetNumbersToDelete property set to remove the first and last worksheets, so the 2nd version of an output spreadsheet will have 2 worksheets in total (1 original + 1 edited).

{{< tabs "code-example">}}
{{< tab "DeleteWorksheetsFromLoadedAndEditedSpreadsheet.java" >}}  
```java
import com.groupdocs.editor.EditableDocument;
import com.groupdocs.editor.Editor;
import com.groupdocs.editor.examples.Constants;
import com.groupdocs.editor.formats.SpreadsheetFormats;
import com.groupdocs.editor.options.SpreadsheetEditOptions;
import com.groupdocs.editor.options.SpreadsheetLoadOptions;
import com.groupdocs.editor.options.SpreadsheetSaveOptions;

public class DeleteWorksheetsFromLoadedAndEditedSpreadsheet {
    public static void edit() {
	
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

        Editor editor = new Editor("Input3Worksheets.xlsx", loadOptions);
        // Prepare edit options: open 2nd worksheet (WorksheetIndex is 0-based)
        SpreadsheetEditOptions editOptions = new SpreadsheetEditOptions();
        editOptions.setWorksheetIndex(1);

        try {

            EditableDocument worksheet2OpenedForEdit = editor.edit(editOptions);
            // Get embedded HTML of the worksheet
            String originalHtml = worksheet2OpenedForEdit.getEmbeddedHtml();

            // Emulate HTML edit
            String editedHtml = originalHtml.replace("2nd row", "Edited 2nd row at 1st column");

            // Build EditableDocument from edited markup
            try {
                EditableDocument worksheet2AfterEdit = EditableDocument.fromMarkup(editedHtml, null);
                // ---- Save #1: insert edited worksheet as new, without deleting anything
                SpreadsheetSaveOptions saveOptionsWithoutDelete = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
                saveOptionsWithoutDelete.setWorksheetNumber(2);          // 1-based
                saveOptionsWithoutDelete.setInsertAsNewWorksheet(true);  // don't overwrite, insert new
                String outputWorksheets_without_delete = Constants.getOutputDirectoryPath("Output4Worksheets-without-delete.xlsx");
                editor.save(
                        worksheet2AfterEdit,
                        outputWorksheets_without_delete,
                        saveOptionsWithoutDelete
                );

                // ---- Save #2: insert edited worksheet as new, and delete 1st + last worksheet
                SpreadsheetSaveOptions saveOptionsWithDelete = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
                saveOptionsWithDelete.setWorksheetNumber(2);            // 1-based
                saveOptionsWithDelete.setInsertAsNewWorksheet(true);

                // After insertion, total worksheets become 4 => delete #1 and #4
                saveOptionsWithDelete.setWorksheetNumbersToDelete(new int[]{1, 4});
                String outputWorksheets_with_delete = Constants.getOutputDirectoryPath("Output2Worksheets-with-delete.xlsx");
                editor.save(
                        worksheet2AfterEdit,
                        outputWorksheets_with_delete,
                        saveOptionsWithDelete
                );
            }finally {
                worksheet2OpenedForEdit.dispose();
            }
        }finally {
            editor.dispose();
        }
    }

    public static void main(String[] args){
        edit();
    }
}
```
{{< /tab >}}
{{< tab "Input3Worksheets.xlsxz" >}}  
{{< tab-text >}}
`Input3Worksheets.xlsx` is sample file used in this example. Click [here](/editor/java/sample-files/Input3Worksheets.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "Output4Worksheets-without-delete.xlsx" >}}  
{{< tab-text >}}
`Output4Worksheets-without-delete.xlsx` is edited document without deleted worksheets. Click [here](/editor/java/sample-files/Output4Worksheets-without-delete.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "Output2Worksheets-with-delete.xlsx" >}}  
{{< tab-text >}}
`Output2Worksheets-with-delete.xlsx` is edited document with deleted worksheets. Click [here](/editor/java/sample-files/Output2Worksheets-with-delete.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Deleting worksheets from spreadsheet

Path: /editor/net/deleting-worksheets-from-spreadsheet/

A **spreadsheet**, also known as a **workbook** — is a [family of the document formats](https://docs.fileformat.com/spreadsheet/), designed to work with tabular data. [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [CSV](https://docs.fileformat.com/spreadsheet/csv/) formats are the most common examples of such document formats, while Microsoft Excel, LibreOffice Calc, Apache OpenOffice Calc are examples of table processors — programs, which allow the creation and editing of such documents. GroupDocs.Editor has an ability to edit existing spreadsheet documents from its beginning, and starting from the [version 24.6](https://releases.groupdocs.com/editor/net/release-notes/2024/groupdocs-editor-for-net-24-6-release-notes/) it has obtained an ability not only to edit already existing spreadsheets, but also to create new spreadsheets from scratch. And starting from the [version 25.11](https://releases.groupdocs.com/editor/net/release-notes/2025/groupdocs-editor-for-net-25-11-release-notes/) the GroupDocs.Editor has obtained a feature to delete worksheets from the edited spreadsheet during saving.

Need to keep in mind that not every spreadsheet may have the worksheets. For example, text-based separator-delimited formats like [CSV](https://docs.fileformat.com/spreadsheet/csv/) and [TSV](https://docs.fileformat.com/spreadsheet/tsv/) are basically the text files, they have no worksheets, so the worksheet cannot be removed from them. But almost all of the binary spreadsheet formats like XLS, XLSX and ODS do have them.

In GroupDocs.Editor the user edits one worksheet at a time — the spreadsheet [is loaded](https://docs.groupdocs.com/editor/net/load-document/) to the constructor of the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class, then worksheet is specified by its number in the [`SpreadsheetEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheeteditoptions), and then document is converted to the editable form, represented by the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class. Straight and simple. However, when the content of the worksheet was edited by the user and passed back to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, there are two options:

1. Users can save the edited content of the worksheet as a new spreadsheet with this single worksheet inside. This is the default behaviour that was present in the GroupDocs.Editor from its beginning.
2. Users can save the edited worksheet by inserting it to the original spreadsheet. This was made possible starting from the [version 20.10](https://releases.groupdocs.com/editor/net/release-notes/2020/groupdocs-editor-for-net-20-10-release-notes/) and is described in a [separate article](https://docs.groupdocs.com/editor/net/inserting-edited-worksheet-into-existing-spreadsheet/). This second option also has two sub-options:
    1. The edited worksheet can *replace* the original worksheet in the input spreadsheet. For instance, in the loaded spreadsheet with 3 worksheets the user has chosen the 2nd one for edit; this worksheet was edited and then inserted back to the input spreadsheet, replacing the original 2nd worksheet onto the edited one.
    2. The edited worksheet can be inserted into the input spreadsheet to stay *together* with the original one. For instance, in the loaded spreadsheet with 3 worksheets the user has chosen the 2nd one for edit; this worksheet was edited and then inserted back to the input spreadsheet, so now the spreadsheet contains 4 worksheets: the first, fourth, and two versions of the second (original and edited).

Starting from the [version 25.11](https://releases.groupdocs.com/editor/net/release-notes/2025/groupdocs-editor-for-net-25-11-release-notes/), when the 2nd option (inserting edited worksheet into the original spreadsheet), users also can delete particular worksheet(s) from it. A new property was added to the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) class — [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumberstodelete/) of `int[]` type. By default it has a `null` value, which means that no worksheets should be removed. However, when it has one or more valid worksheet numbers, the worksheets with these numbers are removed while calling the [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

Need to mention that the worksheet numbers in a [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumberstodelete/) property are 1-based. For instance, for removing the first and fourth worksheets the [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumberstodelete/) property should have a `new int[2] {1, 4}` value.

With the new worksheet removal feature the GroupDocs.Editor performs the next algorithm during saving the spreadsheet:

1. User edits a content of the worksheet in the WYSIWYG-editor, passes the edited content to the instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class [using one of its static methods](https://docs.groupdocs.com/editor/net/create-editabledocument-from-file-or-markup/), creates and adjusts the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions), and passes the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance, and output stream or file path for writing to the [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.
2. If the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property in the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance is set to the default value `0`, the GroupDocs.Editor generates a new spreadsheet with one worksheet. The [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumberstodelete/) property is ignored regardless of its value.
3. If the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property in the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance has some non-zero value, the GroupDocs.Editor treats it as a command to insert the edited worksheet into the original spreadsheet.
4. Depending on the [`InsertAsNewWorksheet`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/) property, the GroupDocs.Editor replaces old worksheet, specified by the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property, on the new one, taken from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, or puts the new worksheet to be placed among existing worksheets without replacing any of them.
5. Finally, when all worksheet insertions and rearrangements are finished, the GroupDocs.Editor reads the value of the [`WorksheetNumbersToDelete`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumberstodelete/) property, iterates over all numbers and removes specified worksheets from the spreadsheet.
6. The final spreadsheet, with updated and deleted worksheets, is written to the output stream or file.

Example below shows full roundtrip of input XLSX file: spreadsheet with 3 worksheets inside is loaded, its second worksheet is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), then HTML-markup is emitted from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, modified, and then edited HTML-markup is converted back to the another [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance. From this point two instances of the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) class are created — one is intended for generating a first version of an output spreadsheet with a new worksheet and without deletion and finally it has 4 worksheets in total (3 original + 1 edited). The second [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance has the WorksheetNumbersToDelete property set to remove the first and last worksheets, so the 2nd version of an output spreadsheet will have 2 worksheets in total (1 original + 1 edited).

Input XLSX as well as two versions of the output XLSX files may be downloaded here:

- [Input3Worksheets.xlsx](/editor/net/sample-files/Input3Worksheets.xlsx)
- [Output4Worksheets-without-delete.xlsx](/editor/net/sample-files/Output4Worksheets-without-delete.xlsx)
- [Output2Worksheets-with-delete.xlsx](/editor/net/sample-files/Output2Worksheets-with-delete.xlsx)

{{< tabs "DeleteWorksheetsFromLoadedAndEditedSpreadsheet">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Editor;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;
// ...

// Load input spreadsheet to the Editor and specify loading options
using (Editor editor = new Editor("Input3Worksheets.xlsx", new SpreadsheetLoadOptions()))
{
    // Prepare edit options and set 2nd worksheet to edit
    SpreadsheetEditOptions editOptions = new SpreadsheetEditOptions();
    editOptions.WorksheetIndex = 1;//2nd worksheet to edit, here WorksheetIndex is 0-based due to historical reasons

    //generate EditableDocument with original content of 2nd worksheet
    using (EditableDocument worksheet2OpenedForEdit = editor.Edit(editOptions))
    {
        // Get the HTML-markup from the EditableDocument with original content
        string originalHtmlContentOf2ndWorksheet = worksheet2OpenedForEdit.GetEmbeddedHtml();
        
        //emulate HTML content editing in WYSIWYG-editor in browser or somewhere else
        string editedHtmlContentOf2ndWorksheet = originalHtmlContentOf2ndWorksheet.Replace("2nd row", "Edited 2nd row at 1st column");

        //generate EditableDocument with edited content of 2nd worksheet
        using (EditableDocument worksheet2AfterEdit = EditableDocument.FromMarkup(editedHtmlContentOf2ndWorksheet))
        {
            //prepare save options without deletions
            SpreadsheetSaveOptions saveOptionsWithoutDelete = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
            // let it be the 2nd worksheet...
            saveOptionsWithoutDelete.WorksheetNumber = 2;//here WorksheetNumber is 1-based
            //... and we also save the original 2nd worksheet, which is pushed to the 3rd position
            saveOptionsWithoutDelete.InsertAsNewWorksheet = true;

            // So now the spreadsheet must have 4 worksheets, not 3. Save it to file
            editor.Save(worksheet2AfterEdit, "Output4Worksheets-without-delete.xlsx", saveOptionsWithoutDelete);

            // Create another save options, with deletions at this time
            SpreadsheetSaveOptions saveOptionsWithDelete = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
            // let the new worksheet will be 2nd for now, but after deleting it will became the 1st later
            saveOptionsWithDelete.WorksheetNumber = 2;

            //... and we also save the original 2nd worksheet, which will be next sibling to the newly inserted
            saveOptionsWithDelete.InsertAsNewWorksheet = true;

            // delete the 1st and last worksheet
            saveOptionsWithDelete.WorksheetNumbersToDelete = new int[2]
            {
                1,//1st worksheet
                4//last worksheet is 4, not 3, because we inserted the edited 2nd worksheet as the new worksheet instance, without rewriting the original 2nd worksheet
            };
            // Save it again to distinct file. Output XLSX should have 2 worksheets now.
            editor.Save(worksheet2AfterEdit, "Output2Worksheets-with-delete.xlsx", saveOptionsWithDelete);
        }
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Editor
Imports GroupDocs.Editor.Formats
Imports GroupDocs.Editor.Options
' ...

' Load input spreadsheet to the Editor and specify loading options
Using editor As New Editor("Input3Worksheets.xlsx", New SpreadsheetLoadOptions())
    ' Prepare edit options and set 2nd worksheet to edit
    Dim editOptions As New SpreadsheetEditOptions()
    editOptions.WorksheetIndex = 1 '2nd worksheet to edit, here WorksheetIndex is 0-based due to historical reasons

    ' generate EditableDocument with original content of 2nd worksheet
    Using worksheet2OpenedForEdit As EditableDocument = editor.Edit(editOptions)
        ' Get the HTML-markup from the EditableDocument with original content
        Dim originalHtmlContentOf2ndWorksheet As String = worksheet2OpenedForEdit.GetEmbeddedHtml()

        ' emulate HTML content editing in WYSIWYG-editor in browser or somewhere else
        Dim editedHtmlContentOf2ndWorksheet As String = originalHtmlContentOf2ndWorksheet.Replace("2nd row", "Edited 2nd row at 1st column")

        ' generate EditableDocument with edited content of 2nd worksheet
        Using worksheet2AfterEdit As EditableDocument = EditableDocument.FromMarkup(editedHtmlContentOf2ndWorksheet)
            ' prepare save options without deletions
            Dim saveOptionsWithoutDelete As New SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx)

            ' let it be the 2nd worksheet...
            saveOptionsWithoutDelete.WorksheetNumber = 2 'here WorksheetNumber is 1-based
            '... and we also save the original 2nd worksheet, which is pushed to the 3rd position
            saveOptionsWithoutDelete.InsertAsNewWorksheet = True

            ' So now the spreadsheet must have 4 worksheets, not 3. Save it to file
            editor.Save(worksheet2AfterEdit, "Output4Worksheets-without-delete.xlsx", saveOptionsWithoutDelete)

            ' Create another save options, with deletions at this time
            Dim saveOptionsWithDelete As New SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx)
            ' let the new worksheet will be 2nd for now, but after deleting it will became the 1st later
            saveOptionsWithDelete.WorksheetNumber = 2
            '... and we also save the original 2nd worksheet, which will be next sibling to the newly inserted
            saveOptionsWithDelete.InsertAsNewWorksheet = True

            ' delete the 1st and last worksheet
            saveOptionsWithDelete.WorksheetNumbersToDelete = New Int32(1) {
                1, '1st worksheet
                4 'last worksheet is 4, not 3, because we inserted the edited 2nd worksheet as the new worksheet instance, without rewriting the original 2nd worksheet
            }
            ' Save it again to distinct file. Output XLSX should have 2 worksheets now.
            editor.Save(worksheet2AfterEdit, "Output2Worksheets-with-delete.xlsx", saveOptionsWithDelete)
        End Using
    End Using
End Using
```
{{< /tab >}}
{{< /tabs >}}


---

## Detect file type of container item

Path: /parser/python-net/detect-file-type-of-container-item/


GroupDocs.Parser provides functionality to detect the file type of items within containers (ZIP archives, OST/PST files, etc.) before processing them.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample container files
- Understanding of file type detection

## Detect file type of container items

To detect the file type of each item in a container:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./archive.zip") as parser:
    # Get container items
    attachments = parser.get_container()
    
    if attachments is None:
        print("Container extraction not supported")
    else:
        # Iterate over attachments
        for attachment in attachments:
            print(f"
File: {attachment.name}")
            
            try:
                # Open parser for the attachment
                with attachment.open_parser() as file_parser:
                    # Get document info to detect file type
                    info = file_parser.get_document_info()
                    
                    if info and info.file_type:
                        print(f"  Type: {info.file_type.file_format}")
                        print(f"  Extension: {info.file_type.extension}")
                    else:
                        print(f"  Type: Unknown")
            
            except Exception as e:
                print(f"  Error: {e}")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/detect-file-type-of-container-item/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Detects and displays the file type of each item in the container.

## Categorize items by file type

To organize container items by their detected file type:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from collections import defaultdict

def categorize_by_file_type(file_path):
    """
    Categorize container items by detected file type.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return {}
        
        categories = defaultdict(list)
        
        for attachment in attachments:
            try:
                with attachment.open_parser() as file_parser:
                    info = file_parser.get_document_info()
                    
                    if info and info.file_type:
                        file_type = info.file_type.file_format
                    else:
                        file_type = "Unknown"
            
            except:
                file_type = "Error"
            
            categories[file_type].append(attachment.name)
        
        return dict(categories)

# Usage
categories = categorize_by_file_type("mixed_files.zip")

print("Files categorized by type:\n")
for file_type, files in sorted(categories.items()):
    print(f"{file_type}: {len(files)} files")
    for filename in files[:3]:  # Show first 3
        print(f"  - {filename}")
    if len(files) > 3:
        print(f"  ... and {len(files) - 3} more")
    print()
```

{{< /tab >}}
{{< tab "mixed_files.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [mixed_files.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/detect-file-type-of-container-item/mixed_files.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Groups files by their detected format (PDF, DOCX, XLSX, etc.).

## Filter items by supported formats

To identify which items can be processed:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def get_supported_items(file_path):
    """
    Get list of items that support text extraction.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return []
        
        supported = []
        unsupported = []
        
        for attachment in attachments:
            try:
                with attachment.open_parser() as file_parser:
                    # Check if text extraction is supported
                    if file_parser.features.text:
                        info = file_parser.get_document_info()
                        file_type = info.file_type.file_format if info and info.file_type else "Unknown"
                        
                        supported.append({
                            'name': attachment.name,
                            'type': file_type,
                            'size': attachment.size
                        })
                    else:
                        unsupported.append(attachment.name)
            
            except:
                unsupported.append(attachment.name)
        
        return {
            'supported': supported,
            'unsupported': unsupported
        }

# Usage
result = get_supported_items("documents.zip")

print(f"Supported files ({len(result['supported'])}):")
for item in result['supported']:
    print(f"  {item['name']} [{item['type']}]")

print(f"
Unsupported files ({len(result['unsupported'])}):")
for name in result['unsupported']:
    print(f"  {name}")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Separates items into supported and unsupported categories based on feature availability.

## Create file type report

To generate a detailed report of file types in the container:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import json

def create_file_type_report(file_path, output_json):
    """
    Create detailed file type report for container contents.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return False
        
        report = {
            'container': file_path,
            'items': [],
            'summary': {}
        }
        
        type_counts = {}
        
        for attachment in attachments:
            item_info = {
                'name': attachment.name,
                'size': attachment.size,
                'path': attachment.file_path or ''
            }
            
            try:
                with attachment.open_parser() as file_parser:
                    info = file_parser.get_document_info()
                    
                    if info and info.file_type:
                        file_type = info.file_type.file_format
                        extension = info.file_type.extension
                        
                        item_info['file_type'] = file_type
                        item_info['extension'] = extension
                        item_info['page_count'] = info.page_count if hasattr(info, 'page_count') else None
                        
                        # Update counts
                        type_counts[file_type] = type_counts.get(file_type, 0) + 1
                    else:
                        item_info['file_type'] = 'Unknown'
                        type_counts['Unknown'] = type_counts.get('Unknown', 0) + 1
            
            except Exception as e:
                item_info['file_type'] = 'Error'
                item_info['error'] = str(e)
                type_counts['Error'] = type_counts.get('Error', 0) + 1
            
            report['items'].append(item_info)
        
        report['summary'] = {
            'total_items': len(report['items']),
            'type_distribution': type_counts
        }
        
        # Save report
        with open(output_json, 'w', encoding='utf-8') as f:
            json.dump(report, f, indent=2, ensure_ascii=False)
        
        print(f"File type report saved to {output_json}")
        print(f"
Summary:")
        print(f"  Total items: {report['summary']['total_items']}")
        for file_type, count in sorted(type_counts.items(), key=lambda x: x[1], reverse=True):
            print(f"  {file_type}: {count}")
        
        return True

# Usage
create_file_type_report("archive.zip", "file_type_report.json")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a comprehensive JSON report with file type information and statistics.

## Detect and validate file types

To detect file types and validate against expected types:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def validate_container_contents(file_path, expected_types):
    """
    Validate that container only contains expected file types.
    
    Args:
        file_path: Path to container
        expected_types: List of expected file formats (e.g., ['Pdf', 'Docx'])
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return False
        
        valid_items = []
        invalid_items = []
        
        for attachment in attachments:
            try:
                with attachment.open_parser() as file_parser:
                    info = file_parser.get_document_info()
                    
                    if info and info.file_type:
                        file_type = info.file_type.file_format
                        
                        if file_type in expected_types:
                            valid_items.append({
                                'name': attachment.name,
                                'type': file_type
                            })
                        else:
                            invalid_items.append({
                                'name': attachment.name,
                                'type': file_type,
                                'reason': 'Unexpected type'
                            })
                    else:
                        invalid_items.append({
                            'name': attachment.name,
                            'type': 'Unknown',
                            'reason': 'Type not detected'
                        })
            
            except Exception as e:
                invalid_items.append({
                    'name': attachment.name,
                    'type': 'Error',
                    'reason': str(e)
                })
        
        # Print results
        print(f"Validation Results:")
        print(f"  Valid items: {len(valid_items)}")
        print(f"  Invalid items: {len(invalid_items)}
")
        
        if invalid_items:
            print("Invalid items:")
            for item in invalid_items:
                print(f"  {item['name']}: {item['type']} - {item['reason']}")
        
        return len(invalid_items) == 0

# Usage - validate that archive contains only PDFs and Word documents
is_valid = validate_container_contents("documents.zip", ['Pdf', 'Docx', 'Doc'])
print(f"
Container is valid: {is_valid}")
```

{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [documents.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/detect-file-type-of-container-item/documents.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Validates container contents against expected file types and reports any violations.

## Extract metadata based on file type

To extract different metadata based on detected file type:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_type_specific_metadata(file_path):
    """
    Extract metadata specific to each file type.
    """
    with Parser(file_path) as parser:
        attachments = parser.get_container()
        
        if attachments is None:
            print("Container extraction not supported")
            return
        
        for attachment in attachments:
            print(f"
{'='*60}")
            print(f"File: {attachment.name}")
            
            try:
                with attachment.open_parser() as file_parser:
                    info = file_parser.get_document_info()
                    
                    if info and info.file_type:
                        print(f"Type: {info.file_type.file_format}")
                        
                        # Get metadata
                        metadata = file_parser.get_metadata()
                        
                        if metadata:
                            print("\nMetadata:")
                            for item in metadata:
                                print(f"  {item.name}: {item.value}")
                        
                        # Get page count if available
                        if hasattr(info, 'page_count'):
                            print(f"\nPages: {info.page_count}")
            
            except Exception as e:
                print(f"Error: {e}")

# Usage
extract_type_specific_metadata("mixed_documents.zip")
```

{{< /tab >}}
{{< tab "mixed_documents.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [mixed_documents.zip](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/detect-file-type-of-container-item/mixed_documents.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts and displays type-specific metadata for each item in the container.

## Notes

- Use `open_parser()` on attachments to create a parser for file type detection
- The `get_document_info()` method provides file type information
- File type detection works even if the file extension is incorrect or missing
- Not all file types may be detected; unknown types return `None` for `file_type`
- Always use try-except blocks when processing container items
- File type detection is lightweight and doesn't require full parsing

## Related pages

- [Extract data from ZIP archives]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-archives/extract-data-from-zip-archives" >}})
- [Iterate through container items]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-archives/iterate-through-container-items" >}})
- [Get document info]({{< ref "parser/python-net/developer-guide/basic-usage/get-document-info" >}})


---

## Enabling language information

Path: /editor/java/enabling-language-information/

Documents of all WordProcessing formats can contain text in different languages. But, unlike the plain text documents (TXT), WordProcessing documents also contain a metadata about specific language (locale) of every piece of text. [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) allows to extract and export this language information. For achieving this the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions) class contains the [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions#getEnableLanguageInformation--) public boolean property:

```java
public boolean getEnableLanguageInformation()
public void setEnableLanguageInformation(boolean)
```

By default its value is `false`, which means that language metadata will not be extracted. But when this option is manually enabled, GroupDocs.Editor extracts locale info for every piece of textual content and preserves it in the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, when document is edited. Finally, when user have obtained the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance and is generating the HTML markup for transferring it to the WYSIWYG HTML-editor in order to make document editable in the browser, this language information is represented as the 'lang' HTML attributes with appropriate values inside the SPAN HTML elements.

Enabling language information is useful when document contains different text parts in different languages; if document has text in some single language, this option has no many sense and thus is disabled by default.

However, when document is multi-language, enabling language information may be very suitable for two scenarios:

* It eases spell checking for client-base JavaScript spell-checkers, that are working in the browser. However, this is very dependent on specific spell-checker, as not all spell-checkers are able to grab values from "lang" attributes or even use language information at all.
* It improves the quality of output WordProcessing document in roundtrip scenarios. When document with enabled [`getEnableLanguageInformation()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions#getEnableLanguageInformation--) option was converted to the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, then HTML markup was generated, edited in the some HTML-editor, and then new instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class was created from edited markup, language metadata in "lang" attributes is still preserved. When edited [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) will be converted back to the output document of some WordProcessing format like DOCX or RTF, the textual content inside it will have connections to correct locale.

---

## Enabling language information

Path: /editor/net/enabling-language-information/

Documents of all WordProcessing formats can contain text in different languages. But, unlike the plain text documents (TXT), WordProcessing documents also contain a metadata about specific language (locale) of every piece of text. [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) allows to extract and export this language information. For achieving this the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class contains the [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions/enablelanguageinformation) public boolean property:

```csharp
public bool EnableLanguageInformation {get; set;}
```

By default its value is `false`, which means that language metadata will not be extracted. But when this option is manually enabled, GroupDocs.Editor extracts locale info for every piece of textual content and preserves it in the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, when document is edited. Finally, when user have obtained the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance and is generating the HTML markup for transferring it to the WYSIWYG HTML-editor in order to make document editable in the browser, this language information is represented as the 'lang' HTML attributes with appropriate values inside the SPAN HTML elements.

Enabling language information is useful when document contains different text parts in different languages; if document has text in some single language, this option has no many sense and thus is disabled by default.

However, when document is multi-language, enabling language information may be very suitable for two scenarios:

* It eases spell checking for client-base JavaScript spell-checkers, that are working in the browser. However, this is very dependent on specific spell-checker, as not all spell-checkers are able to grab values from "lang" attributes or even use language information at all.
* It improves the quality of output WordProcessing document in roundtrip scenarios. When document with enabled [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions/enablelanguageinformation) option was converted to the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, then HTML markup was generated, edited in the some HTML-editor, and then new instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class was created from edited markup, language metadata in "lang" attributes is still preserved. When edited [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) will be converted back to the output document of some WordProcessing format like DOCX or RTF, the textual content inside it will have connections to correct locale.

---

## Enabling language information

Path: /editor/nodejs-java/enabling-language-information/


Documents in WordProcessing formats like DOC(X/M), ODT, and others can contain text in multiple languages. Unlike plain text documents (TXT), WordProcessing documents also carry metadata about the language (locale) of every piece of text. **[GroupDocs.Editor](https://products.groupdocs.com/editor/nodejs-java)** allows extracting and exporting this language information. 

To achieve this, the `WordProcessingEditOptions` class contains the `enableLanguageInformation` boolean property:

```javascript
getEnableLanguageInformation(): boolean;
setEnableLanguageInformation(enable: boolean): void;
```

By default, this property is set to `false`, meaning that language metadata will not be extracted. However, when this option is manually enabled, **GroupDocs.Editor** extracts locale information for every piece of text and preserves it in the [EditableDocument](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/editabledocument) instance. When the user generates HTML markup from the [EditableDocument](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/editabledocument) to edit it in a WYSIWYG HTML-editor in the browser, this language information is added as the `lang` HTML attributes with appropriate values inside `SPAN` elements.

### Benefits of Enabling Language Information

Enabling language information is useful in documents that contain text in multiple languages. If a document contains text in a single language, enabling this option has limited benefits and is disabled by default.

However, for multi-language documents, enabling this feature can be highly beneficial in the following scenarios:

1. **Spell-checking in browsers**: Enabling language information improves spell-checking for client-side JavaScript spell-checkers in browsers. This depends on the specific spell-checker, as not all can utilize the `lang` attributes or language metadata.
2. **Improved round-trip document editing**: When a document with enabled `enableLanguageInformation` is converted to an [EditableDocument](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/editabledocument), and HTML markup is generated and edited in an HTML editor, the language information is preserved. If the edited HTML is then converted back to a WordProcessing format (e.g., DOCX or RTF), the language metadata is still maintained, ensuring the text retains its correct locale information.

### Example

Here is how to enable language information in **Node.js**:

```javascript
const WordProcessingEditOptions = groupdocs.options.WordProcessingEditOptions;

let editOptions = new WordProcessingEditOptions();
editOptions.enableLanguageInformation = true;  // Enable language information
```

In **Java**, the same can be done as follows:

```java
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.setEnableLanguageInformation(true);  // Enable language information
```

With this setting enabled, when the document is converted to HTML, language information for each text portion will be retained, easing spell-checking and improving document conversion quality.

---

## eSign Presentation with Metadata signature

Path: /signature/net/esign-presentation-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [PresentationMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/presentationmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) instance to sign Presentation document files.
Presentation document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Presentation document metadata contains pair of Name and Value, Name should be unique within the document.  
Presentation document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there.

### Here are the steps to add metadata signatures into Presentation document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several[PresentationMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/presentationmetadatasignature) objects and add them into  [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Presentation with Metadata signature

This example shows how to add Metadata signature to Presentation document.

```csharp
using (Signature signature = new Signature("sample.ppsx"))
{
    MetadataSignOptions options = new MetadataSignOptions();

    // Create few Presentation Metadata signatures
    PresentationMetadataSignature[] signatures = new PresentationMetadataSignature[]
    {
        new PresentationMetadataSignature("Author", "Mr.Scherlock Holmes"),
        new PresentationMetadataSignature("DateCreated", DateTime.Now),
        new PresentationMetadataSignature("DocumentId", 123456),
        new PresentationMetadataSignature("SignatureId", 123.456M)
    };
    options.Signatures.AddRange(signatures);
    signature.Sign("SampleSigned.ppsx", options);
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Exclude fonts

Path: /viewer/java/exclude-fonts/

By default, GroupDocs.Viewer embeds the fonts used in the document into HTML. This ensures correct display regardless of the required fonts existing on the viewer device. Depending on the type of HTML rendering, fonts are added as follows:

* Embedded resources - inline 64-coded fonts
* External resources - external files
  
A list of file types that support font embedding is [at the end of the page](#list-of-format-families-that-support-adding-fonts-to-HTML).

Embedding fonts increase the size of the rendered result. To prevent adding fonts that are available on most devices to HTML, add the font names to the [getFontsToExclude](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#getFontsToExclude--) collection of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class.

The following code snippet shows how to prevent adding the **Times New Roman** font to HTML.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewOptions.getFontsToExclude().add("Times New Roman");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## List of format families that support adding fonts to HTML

The following source file formats support adding fonts to HTML:

| Format Name | Extension |
| --- | --- |
| Portable Document Format | PDF |
| Microsoft Word | DOC, DOCX, DOCM, DOT, DOTX, DOTM |
| Microsoft Outlook | MSG, EML |
| Apple Mail | EMLX |
| OpenDocument Formats | ODT, OTT |
| Rich Text Format | RTF |
| Electronic publication | EPUB |
| Mobipocket e-book format | MOBI |
| LaTeX | TEX |
| Microsoft PowerPoint | PPT, PPTX, PPS, PPSX |
| OpenDocument Formats | ODP |
| Image files | SVG  |

---

## Exclude fonts

Path: /viewer/net/exclude-fonts/

By default, GroupDocs.Viewer includes (exports) the fonts used in the loaded document into the produced HTML. This ensures correct display regardless of the required fonts existing on the viewer device. Depending on the type of HTML rendering, fonts are included as follows:

1. Embedded resources — font content is _embedded_ (inlined, backed) directly inside the HTML-markup using the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme) through [base64](https://en.wikipedia.org/wiki/Base64) encoding.
2. External resources — font content is stored aside from the HTML document, externally; each font may be stored as a distinct file on the disk or its content may be written to the byte stream, specified by the user through a [`CreateResourceStream`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.interfaces/createresourcestream/) delegate.

GroupDocs.Viewer supports a [lot of document formats](https://docs.groupdocs.com/viewer/net/supported-document-formats/), and not for all of them it is possible to export the fonts to the resultant produced HTML. A list of file formats that support font export when rendering them to HTML format is provided in the list below:

1. Portable Document Format (PDF)
2. Microsoft Word formats (DOC, DOCX, DOCM, DOT, DOTX, DOTM)
3. Microsoft PowerPoint formats (PPT, PPTX, PPS, PPSX)
4. Microsoft Outlook formats (MSG, EML)
5. Apple Mail (EMLX)
6. OpenDocument formats (ODT, OTT, ODP)
7. Rich Text Format (RTF)
8. e-Books formats (Electronic publication (EPUB), Mobipocket (MOBI), AZW3)
9. LaTeX (TEX)
10. Vector images (SVG)

Sometimes including fonts to the produced HTML document is unwanted: for example, user masy have all the font installed on the operating system, where the HTML document should be viewed, and browser can use system-installed fonts. Also when fonts are included, they significantly increase the size of the produced HTML document. To prevent adding fonts that are available on most devices to produced HTML, the GroupDocs.Viewer provides two options: **exclude all fonts** (complete fonts exclusion) and **exclude specified fonts only** (selective fonts exclusion).

Both these options are represented in the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) class as different properties:

- [`ExcludeFonts`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/excludefonts/) is a flag that disables export of **all** used fonts to the produced HTML document, when enabled (`true`). By default this option is disabled (`false`).
- [`FontsToExclude`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/fontstoexclude/) is a list of `string`, each one represents one font name, that should be excluded from the produced HTML document. By default this list is empty — no fonts are excluded. Please note that this option works only if the `ExcludeFonts` property is disabled (`false`).

The folowing code snippet shows how to exclude all fonts from the produced HTML document with the `ExcludeFonts` flag.

{{< tabs "example-ExcludeFonts">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();    
    viewOptions.ExcludeFonts = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()            
            viewOptions.ExcludeFonts = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following code snippet demonstrates the work of the [`FontsToExclude`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/fontstoexclude/) property — it shows how to prevent adding the **Times New Roman** and **Arial** fonts to HTML.

{{< tabs "example-FontsToExclude">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("presentation.pptx"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();    
    viewOptions.FontsToExclude.Add("Times New Roman");// Exclude the Times New Roman font.
    viewOptions.FontsToExclude.Add("Arial");// Exclude the Arial font.
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("presentation.pptx")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()            
            viewOptions.FontsToExclude.Add("Times New Roman")' Exclude the Times New Roman font.
            viewOptions.FontsToExclude.Add("Arial")' Exclude the Arial font.
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Supported formats for exclusion

Need to mention that not all formats, listed above, support the complete and selective font exclusion. Two lists below show which formats are supported:

Complete fonts exclusion using `ExcludeFonts`:

1. All Microsoft Word formats (DOX, DOCX, DOCM, ...)
2. All PowerPoint presentation formats (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POX, POTM)
3. All OpenDocument presentation formats (ODP, FODP, OTP)
4. PDF
5. OFD (OpenFixed-layout Document)
6. XPS (including OpenXPS)
7. PostScript (includikng Encapsulated PostScript)
8. ePuB
9. TeX
10. PCL
11. CGM
12. Microsoft Project documents (MPT, MPP, MPX)
13. All supported archives
14. Microsoft OneNote ONE format
15. Vector images with font support (SVG)
16. All supported email formats

Selexctinve fonts excludion using `FontsToExclude`:

1. All PowerPoint presentation formats (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POX, POTM)
2. All OpenDocument presentation formats (ODP, FODP, OTP)
3. PDF
4. OFD (OpenFixed-layout Document)
5. XPS (including OpenXPS)
6. PostScript (includikng Encapsulated PostScript)
7. ePuB
8. TeX
9. PCL
10. CGM
---

## Existing objects in PDF document

Path: /watermark/java/existing-objects-in-pdf-document/

## Removing watermark from a particular page

Removing watermark from a particular page of PDF document using GroupDocs.Watermark consists of following steps.

1.  Load the document 
2.  Create and initialize Image/text search criteria 
3.  Find watermarks
4.  Remove watermarks
5.  Save the document

Following code sample removes watermarks from a particular page.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveWatermark**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                                    
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"                             
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                                      
                                                                                                                                      
// Initialize search criteria                                                                                                         
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");                                          
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");                                                       
                                                                                                                                      
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                                                     
PossibleWatermarkCollection possibleWatermarks = pdfContent.getPages().get_Item(0).search(imageSearchCriteria.or(textSearchCriteria));
                                                                                                                                      
// Remove all found watermarks                                                                                                        
for (int i = possibleWatermarks.getCount() - 1; i >= 0; i--)                                                                          
{                                                                                                                                     
    possibleWatermarks.removeAt(i);                                                                                                   
}                                                                                                                                     
                                                                                                                                      
watermarker.save("document.pdf");                                                                                           
                                                                                                                                      
watermarker.close();                                                                                                                  
```

[Search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#search()) method searches watermarks of all mentioned types, but in some cases, it's necessary to analyze only one class of PDF entities. The following articles specifically deal with different types of the watermark objects in a PDF document.

## Working with XObjects

### Extracting information about all XObjects in PDF document

Using GroupDocs.Watermark for .NET, you can extract information about all the [XObjects](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfXObject) in a PDF document. Following code sample performs this functionality.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfExtractXObjectInformation**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
for (PdfPage page : pdfContent.getPages())                                                               
{                                                                                                        
    for (PdfXObject xObject : page.getXObjects())                                                        
    {                                                                                                    
        if (xObject.getImage() != null)                                                                  
        {                                                                                                
            System.out.println(xObject.getImage().getWidth());                                           
            System.out.println(xObject.getImage().getHeight());                                          
            System.out.println(xObject.getImage().getBytes().length);                                    
        }                                                                                                
                                                                                                         
        System.out.println(xObject.getText());                                                           
        System.out.println(xObject.getX());                                                              
        System.out.println(xObject.getY());                                                              
        System.out.println(xObject.getWidth());                                                          
        System.out.println(xObject.getHeight());                                                         
        System.out.println(xObject.getRotateAngle());                                                    
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.close();                                                                                     
```

### Removing a particular XObject

You can also remove an XObject from a page using GroupDocs.Watermark. Following code sample removes an XObject from a particular page.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveXObject**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                  
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"           
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                    
                                                                                                                    
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                                   
                                                                                                                    
// Remove XObject by index                                                                                          
pdfContent.getPages().get_Item(0).getXObjects().removeAt(0);                                                        
                                                                                                                    
// Remove XObject by reference                                                                                      
pdfContent.getPages().get_Item(0).getXObjects().remove(pdfContent.getPages().get_Item(0).getXObjects().get_Item(0));
                                                                                                                    
watermarker.save("document.pdf");                                                                         
                                                                                                                    
watermarker.close();                                                                                                
```

### Removing XObjects containing text with particular text formatting

You can also find and remove all XObjects containing [text with a particular formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getFormattedTextFragments()) from a PDF document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveXObjectWithParticularTextFormatting**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
for (PdfPage page : pdfContent.getPages())                                                               
{                                                                                                        
    for (int i = page.getXObjects().getCount() - 1; i >= 0; i--)                                         
    {                                                                                                    
        for (FormattedTextFragment fragment : page.getXObjects().get_Item(i).getFormattedTextFragments())
        {                                                                                                
            if (fragment.getForegroundColor().equals(Color.getRed()))                                    
            {                                                                                            
                page.getXObjects().removeAt(i);                                                          
                break;                                                                                   
            }                                                                                            
        }                                                                                                
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

### Adding watermark to all image XObjects

GroupDocs.Watermark API allows you to add watermark to all [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getImage()) XObjects in a PDF document. Following code sample serves this purpose.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfAddWatermarkToXObjects**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
// Initialize image or text watermark                                                                    
TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));                    
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                            
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                
watermark.setRotateAngle(45);                                                                            
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                             
watermark.setScaleFactor(1);                                                                             
                                                                                                         
for (PdfPage page : pdfContent.getPages())                                                               
{                                                                                                        
    for (PdfXObject xObject : page.getXObjects())                                                        
    {                                                                                                    
        if (xObject.getImage() != null)                                                                  
        {                                                                                                
            // Add watermark to the image                                                                
            xObject.getImage().add(watermark);                                                           
        }                                                                                                
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

### Replacing text for particular XObjects

GroupDocs.Watermark allows you to edit and replace the text of the particular XObject. You can also replace XObject's [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#setText(java.lang.String)) with formatting as shown in the below code samples.

#### Replacing text

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceTextForParticularXObject**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
for (PdfXObject xObject : pdfContent.getPages().get_Item(0).getXObjects())                               
{                                                                                                        
    // Replace text                                                                                      
    if (xObject.getText().contains("Test"))                                                              
    {                                                                                                    
        xObject.setText("Passed");                                                                       
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

#### Replacing text with formatting

**advanced\_usage.add\_watermarks\_to\_pdf.ReplaceTextForParticularXObjectWithFormatting**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                                  
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"                           
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                                    
                                                                                                                                    
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                                                   
for (PdfXObject xObject : pdfContent.getPages().get_Item(0).getXObjects())                                                          
{                                                                                                                                   
    // Replace text                                                                                                                 
    if (xObject.getText().contains("Test"))                                                                                         
    {                                                                                                                               
        xObject.getFormattedTextFragments().clear();                                                                                
        xObject.getFormattedTextFragments().add("Passed", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                               
}                                                                                                                                   
                                                                                                                                    
// Save document                                                                                                                    
watermarker.save("document.pdf");                                                                                         
                                                                                                                                    
watermarker.close();                                                                                                                
```

### Replacing image for particular XObjects

Using GroupDocs.Watermark, you can also replace the image of a particular XObject. GroupDocs.Watermark allows you to loop through all the [XObjects](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfPage#getXObjects()) of a particular page and you can replace the [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#setImage(com.groupdocs.watermark.contents.PdfWatermarkableImage)) of particular XObjects using some condition as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceImageForParticularXObject**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
File imageFile = new File("test.png");                                                            
byte[] imageBytes = new byte[(int) imageFile.length()];                                                  
InputStream imageStream = new FileInputStream(imageFile);                                                
imageStream.read(imageBytes);                                                                            
imageStream.close();                                                                                     
                                                                                                         
// Replace image                                                                                         
for (PdfXObject xObject : pdfContent.getPages().get_Item(0).getXObjects())                               
{                                                                                                        
    if (xObject.getImage() != null)                                                                      
    {                                                                                                    
        xObject.setImage(new PdfWatermarkableImage(imageBytes));                                         
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

## Working with artifacts

### Extracting information about all artifacts in PDF document

GroupDocs.Watermark enables you to extract the information about the [artifacts](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfPage#getArtifacts()) in a PDF document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfExtractArtifactInformation**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
for (PdfPage page : pdfContent.getPages())                                                               
{                                                                                                        
    for (PdfArtifact artifact : page.getArtifacts())                                                     
    {                                                                                                    
        System.out.println(artifact.getArtifactType());                                                  
        System.out.println(artifact.getArtifactSubtype());                                               
        if (artifact.getImage() != null)                                                                 
        {                                                                                                
            System.out.println(artifact.getImage().getWidth());                                          
            System.out.println(artifact.getImage().getHeight());                                         
            System.out.println(artifact.getImage().getBytes().length);                                   
        }                                                                                                
                                                                                                         
        System.out.println(artifact.getText());                                                          
        System.out.println(artifact.getOpacity());                                                       
        System.out.println(artifact.getX());                                                             
        System.out.println(artifact.getY());                                                             
        System.out.println(artifact.getWidth());                                                         
        System.out.println(artifact.getHeight());                                                        
        System.out.println(artifact.getRotateAngle());                                                   
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.close();                                                                                     
```

### Removing a particular artifact

Following code sample shows how to remove an [artifact](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfArtifact) from a particular page of the PDF document.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveArtifact**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                    
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"             
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                      
                                                                                                                      
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                                     
                                                                                                                      
// Remove Artifact by index                                                                                           
pdfContent.getPages().get_Item(0).getArtifacts().removeAt(0);                                                         
                                                                                                                      
// Remove Artifact by reference                                                                                       
pdfContent.getPages().get_Item(0).getArtifacts().remove(pdfContent.getPages().get_Item(0).getArtifacts().get_Item(0));
                                                                                                                      
watermarker.save("document.pdf");                                                                           
                                                                                                                      
watermarker.close();                                                                                                  
```

### Removing artifacts containing text with particular text formatting

You can also find and remove all artifacts containing [text with a particular formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getFormattedTextFragments()) from a PDF document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveArtifactsWithParticularTextFormatting**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                        
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf" 
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                          
                                                                                                          
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                         
for (PdfPage page : pdfContent.getPages())                                                                
{                                                                                                         
    for (int i = page.getArtifacts().getCount() - 1; i >= 0; i--)                                         
    {                                                                                                     
        for (FormattedTextFragment fragment : page.getArtifacts().get_Item(i).getFormattedTextFragments())
        {                                                                                                 
            if (fragment.getFont().getSize() > 42)                                                        
            {                                                                                             
                page.getArtifacts().removeAt(i);                                                          
                break;                                                                                    
            }                                                                                             
        }                                                                                                 
    }                                                                                                     
}                                                                                                         
                                                                                                          
watermarker.save("document.pdf");                                                               
                                                                                                          
watermarker.close();                                                                                      
```

### Adding watermark to all image artifacts

GroupDocs.Watermark API also provides the feature of adding watermark to all image artifacts in a PDF document. Following code sample adds watermark to all [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getImage()) artifacts.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfAddWatermarkToImageArtifacts**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
// Initialize image or text watermark                                                                    
TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));                    
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                            
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                
watermark.setRotateAngle(45);                                                                            
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                             
watermark.setScaleFactor(1);                                                                             
                                                                                                         
for (PdfPage page : pdfContent.getPages())                                                               
{                                                                                                        
    for (PdfArtifact artifact : page.getArtifacts())                                                     
    {                                                                                                    
        if (artifact.getImage() != null)                                                                 
        {                                                                                                
            // Add watermark to the image                                                                
            artifact.getImage().add(watermark);                                                          
        }                                                                                                
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

### Replacing text for particular artifacts

GroupDocs.Watermark allows you to edit and replace the [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfArtifact#setText(java.lang.String)) of the particular artifacts. You can also replace artifact's [text with formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getFormattedTextFragments()) as shown in the below code samples.

#### Replacing text

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceTextForParticularArtifact**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
for (PdfArtifact artifact : pdfContent.getPages().get_Item(0).getArtifacts())                            
{                                                                                                        
    // Replace text                                                                                      
    if (artifact.getText().contains("Test"))                                                             
    {                                                                                                    
        artifact.setText("Passed");                                                                      
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

#### Replacing text with formatting

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceTextForParticularArtifactWithFormatting**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"                            
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                                     
                                                                                                                                     
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                                                    
for (PdfArtifact artifact : pdfContent.getPages().get_Item(0).getArtifacts())                                                        
{                                                                                                                                    
    // Replace text                                                                                                                  
    if (artifact.getText().contains("Test"))                                                                                         
    {                                                                                                                                
        artifact.getFormattedTextFragments().clear();                                                                                
        artifact.getFormattedTextFragments().add("Passed", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                                
}                                                                                                                                    
                                                                                                                                     
// Save document                                                                                                                     
watermarker.save("document.pdf");                                                                                          
                                                                                                                                     
watermarker.close();                                                                                                                 
```

### Replacing image for particular artifacts

Using GroupDocs.Watermark, you can also replace the image of a particular artifact. GroupDocs.Watermark allows you to loop through all the [artifacts](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfPage#getArtifacts()) of a particular page and you can replace the [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#setImage(com.groupdocs.watermark.contents.PdfWatermarkableImage)) of particular artifacts using some condition as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceImageForParticularArtifact**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
File imageFile = new File("test.png");                                                            
byte[] imageBytes = new byte[(int) imageFile.length()];                                                  
InputStream imageStream = new FileInputStream(imageFile);                                                
imageStream.read(imageBytes);                                                                            
imageStream.close();                                                                                     
                                                                                                         
// Replace image                                                                                         
for (PdfArtifact artifact : pdfContent.getPages().get_Item(0).getArtifacts())                            
{                                                                                                        
    if (artifact.getImage() != null)                                                                     
    {                                                                                                    
        artifact.setImage(new PdfWatermarkableImage(imageBytes));                                        
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

## Working with annotations

### Extracting information about all annotations in PDF document

You can also extract information about all the [annotations](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfPage#getAnnotations()) in a PDF document using GroupDocs.Watermark as shown in below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfExtractAnnotationInformation**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
for (PdfPage page : pdfContent.getPages())                                                               
{                                                                                                        
    for (PdfAnnotation annotation : page.getAnnotations())                                               
    {                                                                                                    
        System.out.println(annotation.getAnnotationType());                                              
        if (annotation.getImage() != null)                                                               
        {                                                                                                
            System.out.println(annotation.getImage().getWidth());                                        
            System.out.println(annotation.getImage().getHeight());                                       
            System.out.println(annotation.getImage().getBytes().length);                                 
        }                                                                                                
                                                                                                         
        System.out.println(annotation.getText());                                                        
        System.out.println(annotation.getX());                                                           
        System.out.println(annotation.getY());                                                           
        System.out.println(annotation.getWidth());                                                       
        System.out.println(annotation.getHeight());                                                      
        System.out.println(annotation.getRotateAngle());                                                 
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.close();                                                                                     
```

### Removing a particular annotation

Following code sample can be used to remove a particular [annotation](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfAnnotation) from a PDF document.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveAnnotation**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                        
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"                 
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                          
                                                                                                                          
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                                         
                                                                                                                          
// Remove Annotation by index                                                                                             
pdfContent.getPages().get_Item(0).getAnnotations().removeAt(0);                                                           
                                                                                                                          
// Remove Annotation by reference                                                                                         
pdfContent.getPages().get_Item(0).getAnnotations().remove(pdfContent.getPages().get_Item(0).getAnnotations().get_Item(0));
                                                                                                                          
watermarker.save("document.pdf");                                                                               
                                                                                                                          
watermarker.close();                                                                                                      
```

### Removing annotations containing text with particular text formatting

You can also find and remove all annotations containing [text with a particular formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getFormattedTextFragments()) from a PDF document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveAnnotationsWithParticularTextFormatting**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                          
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"   
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                            
                                                                                                            
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                           
for (PdfPage page : pdfContent.getPages())                                                                  
{                                                                                                           
    for (int i = page.getAnnotations().getCount() - 1; i >= 0; i--)                                         
    {                                                                                                       
        for (FormattedTextFragment fragment : page.getAnnotations().get_Item(i).getFormattedTextFragments())
        {                                                                                                   
            if (fragment.getFont().getFamilyName() == "Verdana")                                            
            {                                                                                               
                page.getAnnotations().removeAt(i);                                                          
                break;                                                                                      
            }                                                                                               
        }                                                                                                   
    }                                                                                                       
}                                                                                                           
                                                                                                            
watermarker.save("document.pdf");                                                                 
                                                                                                            
watermarker.close();                                                                                        
```

### Adding watermark to all image annotations 

Similar to the other types, the watermark can be added to [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getImage()) annotations in PDF documents as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfAddWatermarkToAnnotationImages**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
// Initialize image or text watermark                                                                    
TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));                    
watermark.setHorizontalAlignment(HorizontalAlignment.Center);                                            
watermark.setVerticalAlignment(VerticalAlignment.Center);                                                
watermark.setRotateAngle(45);                                                                            
watermark.setSizingType(SizingType.ScaleToParentDimensions);                                             
watermark.setScaleFactor(1);                                                                             
                                                                                                         
for (PdfPage page : pdfContent.getPages())                                                               
{                                                                                                        
    for (PdfAnnotation annotation : page.getAnnotations())                                               
    {                                                                                                    
        if (annotation.getImage() != null)                                                               
        {                                                                                                
            // Add watermark to the image                                                                
            annotation.getImage().add(watermark);                                                        
        }                                                                                                
    }                                                                                                    
}                                                                                                        
                                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

### Replacing text for particular annotations

GroupDocs.Watermark allows you to edit and replace the [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#setText(java.lang.String)) of the particular annotations. You can also replace annotation's [text with formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#getFormattedTextFragments()) as shown in the below code samples.

#### Replacing text

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceTextForParticularAnnotation**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
for (PdfAnnotation annotation : pdfContent.getPages().get_Item(0).getAnnotations())                      
{                                                                                                        
    // Replace text                                                                                      
    if (annotation.getText().contains("Test"))                                                           
    {                                                                                                    
        annotation.setText("Passed");                                                                    
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

#### Replacing text with formatting

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceTextForParticularAnnotationWithFormatting**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                                                     
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"                              
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                                                       
                                                                                                                                       
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                                                      
for (PdfAnnotation annotation : pdfContent.getPages().get_Item(0).getAnnotations())                                                    
{                                                                                                                                      
    // Replace text                                                                                                                    
    if (annotation.getText().contains("Test"))                                                                                         
    {                                                                                                                                  
        annotation.getFormattedTextFragments().clear();                                                                                
        annotation.getFormattedTextFragments().add("Passed", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                                  
}                                                                                                                                      
                                                                                                                                       
// Save document                                                                                                                       
watermarker.save("document.pdf");                                                                                            
                                                                                                                                       
watermarker.close();                                                                                                                   
```

### Replacing image for particular annotations

Using GroupDocs.Watermark, you can also replace the image of a particular annotation. GroupDocs.Watermark allows you to loop through all the annotations of a particular page and you can replace the [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfShape#setImage(com.groupdocs.watermark.contents.PdfWatermarkableImage)) of particular annotations using some condition as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfReplaceImageForParticularAnnotation**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
File imageFile = new File("test.png");                                                            
byte[] imageBytes = new byte[(int) imageFile.length()];                                                  
InputStream imageStream = new FileInputStream(imageFile);                                                
imageStream.read(imageBytes);                                                                            
imageStream.close();                                                                                     
                                                                                                         
// Replace image                                                                                         
for (PdfAnnotation annotation : pdfContent.getPages().get_Item(0).getAnnotations())                      
{                                                                                                        
    if (annotation.getImage() != null)                                                                   
    {                                                                                                    
        annotation.setImage(new PdfWatermarkableImage(imageBytes));                                      
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

---

## Existing objects in Word document

Path: /watermark/java/existing-objects-in-word-document/

Watermarks in Word documents are usually represented by shapes. Using GroupDocs.Watermark API you can easily remove shape of any type from any level of document structure.

## Removing watermark from a particular section

Removing watermark from a particular section of a Word document using GroupDocs.Watermark consists of following steps.

1.  Load the document 
2.  Create and initialize [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/ImageSearchCriteria) or [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/TextSearchCriteria) search criteria  
3.  Find possible watermarks
4.  Remove found watermarks 
5.  Save the document

Following code sample shows how to remove watermark from a particular section.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingRemoveWatermarkFromSection**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                                              
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"                           
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                                     
                                                                                                                                      
// Initialize search criteria                                                                                                         
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");                                          
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");                                                       
                                                                                                                                      
// Call Search method for the section                                                                                                 
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                                  
PossibleWatermarkCollection possibleWatermarks = content.getSections().get_Item(0).search(textSearchCriteria.or(imageSearchCriteria));
                                                                                                                                      
// Remove all found watermarks                                                                                                        
for (int i = possibleWatermarks.getCount() - 1; i >= 0; i--)                                                                          
{                                                                                                                                     
    possibleWatermarks.removeAt(i);                                                                                                   
}                                                                                                                                     
                                                                                                                                      
watermarker.save("document.docx");                                                                                          
                                                                                                                                      
watermarker.close();                                                                                                                  
```

### Search for particular header or footer  

You can also call [search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/ContentPart#search()) method for a particular [header or footer](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingHeaderFooter) as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingFindWatermarkInHeaderFooter**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
// Initialize search criteria                                                                              
ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");               
TextSearchCriteria textSearchCriteria = new TextSearchCriteria("Company Name");                            
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
PossibleWatermarkCollection possibleWatermarks = content                                                   
        .getSections().get_Item(0)                                                                         
        .getHeadersFooters().getByOfficeHeaderFooterType(OfficeHeaderFooterType.HeaderPrimary)             
        .search(textSearchCriteria.or(imageSearchCriteria));                                               
                                                                                                           
// Remove all found watermarks                                                                             
for (int i = possibleWatermarks.getCount() - 1; i >= 0; i--)                                               
{                                                                                                          
    possibleWatermarks.removeAt(i);                                                                        
}                                                                                                          
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Extracting information about all shapes in a Word document

[search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/ContentPart#search()) method returns a collection of [PossibleWatermark](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/PossibleWatermark) instances for all document types. But in some cases, it's necessary to get more information about Word shapes than common API offers. GroupDocs.Watermark enables you to extract the information about all the [shapes](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingSection#getShapes()) as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingGetShapesInformation**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
for (WordProcessingSection section : content.getSections())                                                
{                                                                                                          
    for (WordProcessingShape shape : section.getShapes())                                                  
    {                                                                                                      
        if (shape.getHeaderFooter() != null)                                                               
        {                                                                                                  
            System.out.println("In header/footer");                                                        
        }                                                                                                  
                                                                                                           
        System.out.println(shape.getShapeType());                                                          
        System.out.println(shape.getWidth());                                                              
        System.out.println(shape.getHeight());                                                             
        System.out.println(shape.isWordArt());                                                             
        System.out.println(shape.getRotateAngle());                                                        
        System.out.println(shape.getAlternativeText());                                                    
        System.out.println(shape.getName());                                                               
        System.out.println(shape.getX());                                                                  
        System.out.println(shape.getY());                                                                  
        System.out.println(shape.getText());                                                               
        if (shape.getImage() != null)                                                                      
        {                                                                                                  
            System.out.println(shape.getImage().getWidth());                                               
            System.out.println(shape.getImage().getHeight());                                              
            System.out.println(shape.getImage().getBytes().length);                                        
        }                                                                                                  
                                                                                                           
        System.out.println(shape.getHorizontalAlignment());                                                
        System.out.println(shape.getVerticalAlignment());                                                  
        System.out.println(shape.getRelativeHorizontalPosition());                                         
        System.out.println(shape.getRelativeVerticalPosition());                                           
    }                                                                                                      
}                                                                                                          
                                                                                                           
watermarker.close();                                                                                       
```

## Working with shape types

You can extract information about the existing shapes of particular types. The [WordProcessingShapeType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShapeType) enum is available to check the types possibly available shapes.

The following code snippet demonstrates the usage of [WordProcessingShapeType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShapeType) enum.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingShapeTypeUsage**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                                                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"                                                
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                                                          
                                                                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                                                       
for (WordProcessingSection section : content.getSections())                                                                                                
{                                                                                                                                                          
    for (WordProcessingShape shape : section.getShapes())                                                                                                  
    {                                                                                                                                                      
        //Check for Diagonal Corners Rounded shapes                                                                                                        
        if (shape.getShapeType() == WordProcessingShapeType.DiagonalCornersRounded)                                                                        
        {                                                                                                                                                  
            System.out.println("Diagonal Corners Rounded shape found");                                                                                    
                                                                                                                                                           
            //Write text on all Diagonal Corners Rounded shapes                                                                                            
            shape.getFormattedTextFragments().add("I am Diagonal Corner Rounded", new Font("Calibri", 8, FontStyle.Bold), Color.getRed(), Color.getAqua());
        }                                                                                                                                                  
    }                                                                                                                                                      
}                                                                                                                                                          
                                                                                                                                                           
watermarker.save("document.docx");                                                                                                               
                                                                                                                                                           
watermarker.close();                                                                                                                                       
```

## Removing a particular shape

You can also remove a particular [shape](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape) from a Word document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingRemoveShape**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                        
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"     
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                               
                                                                                                                
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                            
                                                                                                                
// Remove shape by index                                                                                        
content.getSections().get_Item(0).getShapes().removeAt(0);                                                      
                                                                                                                
// Remove shape by reference                                                                                    
content.getSections().get_Item(0).getShapes().remove(content.getSections().get_Item(0).getShapes().get_Item(0));
                                                                                                                
watermarker.save("document.docx");                                                                    
                                                                                                                
watermarker.close();                                                                                            
```

## Removing shapes with particular text formatting

You can also find and remove the shapes with a particular [text formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#getFormattedTextFragments()) from a Word document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingRemoveShapesWithParticularTextFormatting**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                              
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"           
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                     
                                                                                                                      
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                  
for (WordProcessingSection section : content.getSections())                                                           
{                                                                                                                     
    for (int i = section.getShapes().getCount() - 1; i >= 0; i--)                                                     
    {                                                                                                                 
        for (FormattedTextFragment fragment : section.getShapes().get_Item(i).getFormattedTextFragments())            
        {                                                                                                             
            if (fragment.getForegroundColor().equals(Color.getRed()) && fragment.getFont().getFamilyName() == "Arial")
            {                                                                                                         
                section.getShapes().removeAt(i);                                                                      
                break;                                                                                                
            }                                                                                                         
        }                                                                                                             
    }                                                                                                                 
}                                                                                                                     
                                                                                                                      
watermarker.save("document.docx");                                                                          
                                                                                                                      
watermarker.close();                                                                                                  
```

## Removing or replacing hyperlink associated with a particular shape

Using GroupDocs.Watermark for Java, you can also remove or replace [hyperlink](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setHyperlink(java.lang.String)) associated with a particular shape inside a Word document. Use following code sample to achieve this functionality.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingRemoveHyperlinks**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
// Replace hyperlink                                                                                       
content.getSections().get_Item(0).getShapes().get_Item(0).setHyperlink("https://www.groupdocs.com/");      
                                                                                                           
// Remove hyperlink                                                                                        
content.getSections().get_Item(0).getShapes().get_Item(1).setHyperlink(null);                              
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Replacing text for particular shapes

### Replacing shape's text

GroupDocs.Watermark supports replacing [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setText(java.lang.String)) for particular shapes in a Word document. Following code sample shows the usage of this feature.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingReplaceTextForParticularShape**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
// Set shape's text                                                                                        
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                            
{                                                                                                          
    if (shape.getText().contains("Some text"))                                                             
    {                                                                                                      
        shape.setText("Another text");                                                                     
    }                                                                                                      
}                                                                                                          
                                                                                                           
// Save document                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

### Replacing shape's text with formatted text

You can also replace the [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setText(java.lang.String)) of the shapes with [formatted text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#getFormattedTextFragments()) as shown in the following code sample.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingReplaceShapeTextWithFormattedText**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                                                
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"                             
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                                                       
                                                                                                                                        
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                                                    
                                                                                                                                        
// Set shape's text                                                                                                                     
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                                                         
{                                                                                                                                       
    if (shape.getText().contains("Some text"))                                                                                          
    {                                                                                                                                   
        shape.getFormattedTextFragments().clear();                                                                                      
        shape.getFormattedTextFragments().add("Another text", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                                   
}                                                                                                                                       
                                                                                                                                        
// Save document                                                                                                                        
watermarker.save("document.docx");                                                                                            
                                                                                                                                        
watermarker.close();                                                                                                                    
```

## Replacing shape's image

GroupDocs.Watermark also allows you to replace the [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setImage(com.groupdocs.watermark.contents.WordProcessingWatermarkableImage)) of the particular shapes in a Word document as shown in the following code sample.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingReplaceShapeImage**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
File imageFile = new File("test.png");                                                              
byte[] imageBytes = new byte[(int) imageFile.length()];                                                    
InputStream imageInputStream = new FileInputStream(imageFile);                                             
imageInputStream.read(imageBytes);                                                                         
imageInputStream.close();                                                                                  
                                                                                                           
// Set shape image                                                                                         
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                            
{                                                                                                          
    if (shape.getImage() != null)                                                                          
    {                                                                                                      
        shape.setImage(new WordProcessingWatermarkableImage(imageBytes));                                  
    }                                                                                                      
}                                                                                                          
                                                                                                           
// Save document                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Modifying shape properties

GroupDocs.Watermark also provides the feature of modifying properties ([setAlternativeText()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setAlternativeText(java.lang.String)), [setRotateAngle()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setRotateAngle(double)), [setX()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setX(double)), [setY()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setY(double)), [setHeight()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setHeight(double)), [setWidth()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setWidth(double)) or [setBehindText()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingShape#setBehindText(boolean))) of particular shapes in a Word document. Following code sample shows how to use this feature.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingModifyShapeProperties**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
// Change shape properties                                                                                 
for (WordProcessingShape shape : content.getSections().get_Item(0).getShapes())                            
{                                                                                                          
    if (shape.getText().contains("Some text"))                                                             
    {                                                                                                      
        shape.setAlternativeText("watermark");                                                             
        shape.setRotateAngle(30);                                                                          
        shape.setX(200);                                                                                   
        shape.setY(200);                                                                                   
        shape.setHeight(100);                                                                              
        shape.setWidth(400);                                                                               
        shape.setBehindText(false);                                                                        
    }                                                                                                      
}                                                                                                          
                                                                                                           
// Save document                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

---

## Extract a text from images and PDFs

Path: /parser/net/extract-text-from-images/

GroupDocs.Parser for .NET provides the ability to extract text from image files and PDFs composed of images.

{{< alert style="info" >}}To use the OCR functionality in .NET Framework set PlatformTarget to x64. If downloadable (msi or zip) version of GroupDocs.Parser is used, see readme.txt file for the additional information.{{< /alert >}}

It should be noted that not all languages ​​represented by the [Language](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/language/) class are currently supported for recognition without implicitly downloading additional resources from the internet. However, if internet access is available, all necessary resources will be downloaded implicitly when selecting any recognition language. Currently supported languages ​​without additional downloads: English, Chinese, Japanese, Korean, Arabic.

The following example shows how to extract text from images and PDFs:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser("scanned.pdf"))
{
    // Set OCR options
    TextOptions options = new TextOptions(false, true);
    options.OcrOptions = new OcrOptions();
    options.OcrOptions.Language = Language.Chinese;
    options.OcrOptions.PagePreviewOptions = new PagePreviewOptions();
    options.OcrOptions.PagePreviewOptions.Dpi = 144;
    // Extract text using OCR
    using(TextReader reader = parser.GetText(options))
    {
        // Print text or 'not supported' message
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

TextOptions can be omitted if the file is an image:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser("scanned.jpg"))
{
    // Extract text using OCR
    using(TextReader reader = parser.GetText())
    {
        // Print text or 'not supported' message
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```
---

## Extract barcodes from document page area

Path: /parser/java/extract-barcodes-from-document-page-area/


GroupDocs.Parser provides the functionality to extract barcodes from documents by the [GetBarcodes](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getBarcodes(com.groupdocs.parser.options.PageAreaOptions)) method:

```java
Iterable<PageBarcodeArea> getBarcodes(PageAreaOptions options)
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [Value](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea#getValue()) | A string value that represents a value of the barcode page area. |
| [CodeTypeName](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea#getCodeTypeName()) | A string value than represents a type name of the barcode. |

Here are the steps to extract all barcodes from the whole document:

- Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser) object for the initial document;
- Check if the document supports barcodes extraction;
- Instantiate [PageAreaOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/PageAreaOptions) with the rectangular area;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getBarcodes(com.groupdocs.parser.options.PageAreaOptions)) method and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageBarcodeArea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to extract barcodes from the upper-right corner:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdfWithBarcodes)) {
	// Check if the document supports barcodes extraction
	if (!parser.getFeatures().isBarcodes()) {
		System.out.println("Document doesn't support barcodes extraction.");
		return;
	}

	// Create the options which are used for barcodes extraction
	PageAreaOptions options = new PageAreaOptions(new Rectangle(new Point(590, 80), new Size(150, 150)));
	// Extract barcodes from the upper-right corner.
	Iterable<PageBarcodeArea> barcodes = parser.getBarcodes(options);

	// Iterate over barcodes
	for (PageBarcodeArea barcode : barcodes) {
		// Print the page index
		System.out.println("Page: " + barcode.getPage().getIndex());
		// Print the barcode value
		System.out.println("Value: " + barcode.getValue());
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract barcodes from document page area

Path: /parser/net/extract-barcodes-from-document-page-area/


GroupDocs.Parser provides the functionality to extract barcodes from documents by the [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/getbarcodes/methods/1) method:

```csharp
IEnumerable<PageBarcodeArea> GetBarcodes(PageAreaOptions options);
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [Value](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/properties/value) | A string value that represents a value of the barcode page area. |
| [CodeTypeName](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/properties/codetypename) | A string value than represents a type name of the barcode. |
| [Confidence](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/confidence/) | The level of confidence of the parsered barcode. |
| [Angle](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea/angle/) | The angle of the barcode. |

Here are the steps to extract all barcodes from the whole document:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
- Check if the document supports barcodes extraction;
- Instantiate [BarcodeOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/BarcodeOptions) with the rectangular area;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/getbarcodes/methods/1) method and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to extract barcodes from the upper-right corner:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Check if the document supports barcodes extraction
    if (!parser.Features.Barcodes)
    {
        Console.WriteLine("Document doesn't support barcodes extraction.");
        return;
    }

    // Create the options which are used for barcodes extraction
    BarcodeOptions options = new BarcodeOptions(new Rectangle(new Point(590, 80), new Size(150, 150)));
    // Extract barcodes from the upper-right corner.
    IEnumerable<PageBarcodeArea> barcodes = parser.GetBarcodes(options);

    // Iterate over barcodes
    foreach (PageBarcodeArea barcode in barcodes)
    {
        // Print the page index
        Console.WriteLine("Page: " + barcode.Page.Index.ToString());
        // Print the barcode value
        Console.WriteLine("Value: " + barcode.Value);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online Barcode Scanner App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to scan barcode from your files or mobile phone camera with our free online [GroupDocs Scanner App](https://products.groupdocs.app/scanner/scan-barcode) which is build with GroupDocs.Parser .Net.
---

## Extract formatted text from document

Path: /parser/net/extract-formatted-text-from-document/

GroupDocs.Parser provides the functionality to extract formatted text from documents by the [GetFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method:

```csharp
TextReader GetFormattedText(FormattedTextOptions options);
```

Methods return an instance of [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) class with the extracted text. [FormattedTextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextoptions) has the following constructor:

```csharp
FormattedTextOptions(FormattedTextMode mode);
```

[FormattedTextMode](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextmode) enumeration has the following members:

| Member | Description |
| --- | --- |
| Html | HTML format. |
| Markdown | Markdown format. |
| PlainText | Plain text format. |

Here are the steps to extract a HTML formatted text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [FormattedTextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextoptions) with HTML text mode;
*   Call [GetFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Check if *reader* isn't *null* (formatted text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a document text as HTML text:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Formatted text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract highlights

Path: /parser/java/extract-highlights/

GroupDocs.Parser provides the functionality to extract a highlight (a part of the text which is usually used to explain the context of the found text in the search functionality) from documents by the [getHighlight(int, boolean, HighlightOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getHighlight(int,%20boolean,%20com.groupdocs.parser.options.HighlightOptions)) method:

```java
HighlightItem getHighlight(int position, boolean isDirect, HighlightOptions options);
```

The *position* parameter defines the start position from which the highlight is extracted. The *isDirect* parameter indicates whether highlight extraction is direct: *true* if the highlight is extracted by the right of the position; otherwise, *false*. [HighlightOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/HighlightOptions) parameter is used to define the end of the highlight.

[HighlightOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/HighlightOptions) class has the following constructors:

```java
// Highlight is limited to maxLength text length.
HighlightOptions(int maxLength);
// Highlight is limited to the start (or the end) of a text line (or maxLength text length - if set).
HighlightOptions(Integer maxLength, boolean isLineLimited);
// Highlight is limited to word count (or maxLength text length - if set).
HighlightOptions(Integer maxLength, int wordCount);
// General constructor
HighlightOptions(Integer maxLength, Integer wordCount, boolean isLineLimited);
```

[HighlightItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/HighlightItem) class has the following members:

| Member | Description |
| --- | --- |
| [getPosition](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/HighlightItem#getPosition()) | The position in the document text. |
| [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/HighlightItem#getText()) | The highlight text. |

Here are the steps to extract highlight from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [HighlightOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/HighlightOptions) object with the extraction parameters;
*   Call [getHighlight(int, boolean, HighlightOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getHighlight(int,%20boolean,%20com.groupdocs.parser.options.HighlightOptions)) method and obtain the [HighlightItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/HighlightItem) object;
*   Check if [HighlightItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/HighlightItem) isn't *null* (highlight extraction is supported for the document);
*   Call properties such as  [getPosition](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/HighlightItem#getPosition()) and [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/HighlightItem#getText()).

The following example shows how to extract a highlight that contains 3 words:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Extract a highlight:
    HighlightItem hl = parser.getHighlight(2, true, new HighlightOptions(3));
    // Check if highlight extraction is supported
    if (hl == null) {
        System.out.println("Highlight extraction isn't supported");
        return;
    }
    // Print an extracted highlight
    System.out.println(String.format("At %d: %s", hl.getPosition(), hl.getText()));
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract highlights

Path: /parser/net/extract-highlights/

GroupDocs.Parser provides the functionality to extract a highlight (a part of the text which is usually used to explain the context of the found text in the search functionality) from documents by the [GetHighlight](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gethighlight) method:

```csharp
HighlightItem GetHighlight(int position, bool isDirect, HighlightOptions options);
```

The *position* parameter defines the start position from which the highlight is extracted. The *isDirect* parameter indicates whether highlight extraction is direct: *true* if the highlight is extracted by the right of the position; otherwise, *false*. [HighlightOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/highlightoptions) parameter is used to define the end of the highlight.

[HighlightOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/highlightoptions) class has the following constructors:

```csharp
// Highlight is limited to maxLength text length.
HighlightOptions(int maxLength);
// Highlight is limited to the start (or the end) of a text line (or maxLength text length - if set).
HighlightOptions(int? maxLength, bool isLineLimited);
// Highlight is limited to word count (or maxLength text length - if set).
HighlightOptions(int? maxLength, int wordCount);
// General constructor
HighlightOptions(int? maxLength, int? wordCount, bool isLineLimited);
```

[HighlightItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/highlightitem) class has the following members:

| Member | Description |
| --- | --- |
| [Position](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/highlightitem/properties/position) | The position in the document text. |
| [Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/highlightitem/properties/text) | The highlight text. |

Here are the steps to extract highlight from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [HighlightOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/highlightoptions) object with the extraction parameters;
*   Call [GetHighlight](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gethighlight) method and obtain the [HighlightItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/highlightitem) object;
*   Check if [HighlightItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/highlightitem) isn't null (highlight extraction is supported for the document);
*   Call properties such as  [Position](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/highlightitem/properties/position) and [Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/highlightitem/properties/text).

The following example shows how to extract a highlight that contains 3 words:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a highlight:
    HighlightItem hl = parser.GetHighlight(2, true, new HighlightOptions(3));
    // Check if highlight extraction is supported
    if (hl == null)
    {
        Console.WriteLine("Highlight extraction isn't supported");
        return;
    }
    // Print an extracted highlight
    Console.WriteLine(string.Format("At {0}: {1}", hl.Position, hl.Text));
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document page area

Path: /parser/python-net/extract-hyperlinks-from-document-page-area/


GroupDocs.Parser allows extracting hyperlinks from specific rectangular areas of document pages, enabling precise link extraction from defined regions.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents with hyperlinks
- Understanding of coordinate systems

## Extract hyperlinks from page area

To extract hyperlinks from a specific rectangular area:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

# Create an instance of Parser class
with Parser("./webpage.html") as parser:
    # Check if hyperlink extraction is supported
    if not parser.features.hyperlinks:
        print("Hyperlink extraction not supported")
        sys.exit()
    
    # Define the area (upper portion, 600x200 pixels)
    area = Rectangle(Point(0, 0), Size(600, 200))
    
    # Create options for the area
    options = PageAreaOptions(area)
    
    # Extract hyperlinks from the specified area
    hyperlinks = parser.get_hyperlinks(options)
    
    if hyperlinks:
        print(f"Hyperlinks found in area:")
        for link in hyperlinks:
            print(f"  {link.text} -> {link.url}")
    else:
        print("No hyperlinks found in the specified area")
```

{{< /tab >}}
{{< tab "webpage.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [webpage.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area/webpage.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns only hyperlinks located within the specified rectangular area.

## Extract hyperlinks from specific page area

To extract hyperlinks from an area on a specific page:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

# Create an instance of Parser class
with Parser("document.pdf") as parser:
    if not parser.features.hyperlinks:
        print("Hyperlink extraction not supported")
        sys.exit()
    
    # Define area (sidebar region)
    area = Rectangle(Point(400, 0), Size(200, 800))
    options = PageAreaOptions(area)
    
    # Get document info
    info = parser.get_document_info()
    
    # Process first page
    page_index = 0
    
    if page_index < info.page_count:
        # Extract hyperlinks from area on specific page
        hyperlinks = parser.get_hyperlinks(page_index, options)
        
        if hyperlinks:
            print(f"Hyperlinks in sidebar (page {page_index + 1}):")
            for link in hyperlinks:
                print(f"  {link.text}: {link.url}")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts hyperlinks from a specific area on a specific page.

## Extract navigation links from header

To extract navigation links from the header area:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

def extract_header_links(file_path):
    """
    Extract navigation links from document header.
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return []
        
        # Define header area (top 100 pixels, full width)
        header_area = Rectangle(Point(0, 0), Size(1000, 100))
        options = PageAreaOptions(header_area)
        
        # Extract hyperlinks from header
        hyperlinks = parser.get_hyperlinks(options)
        
        if hyperlinks:
            links = []
            for link in hyperlinks:
                links.append({
                    'text': link.text or 'No text',
                    'url': link.url or ''
                })
            return links
        
        return []

# Usage
nav_links = extract_header_links("website.html")

print(f"Navigation links ({len(nav_links)}):")
for link in nav_links:
    print(f"  {link['text']} → {link['url']}")
```

{{< /tab >}}
{{< tab "website.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [website.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area/website.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts navigation or menu links typically found in document headers.

## Extract links from multiple regions

To extract hyperlinks from several predefined areas:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

def extract_links_from_regions(file_path, regions):
    """
    Extract hyperlinks from multiple regions.
    
    Args:
        file_path: Path to document
        regions: Dict of region names to (x, y, width, height) tuples
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return {}
        
        results = {}
        
        for region_name, (x, y, w, h) in regions.items():
            # Create rectangle for this region
            area = Rectangle(Point(x, y), Size(w, h))
            options = PageAreaOptions(area)
            
            # Extract hyperlinks from this region
            hyperlinks = parser.get_hyperlinks(options)
            
            if hyperlinks:
                results[region_name] = [link.url for link in hyperlinks]
            else:
                results[region_name] = []
        
        return results

# Define regions
regions = {
    'header': (0, 0, 600, 100),
    'sidebar': (0, 100, 150, 700),
    'footer': (0, 800, 600, 100)
}

# Extract links from regions
links_by_region = extract_links_from_regions("page.html", regions)

for region, urls in links_by_region.items():
    print(f"{region.upper()}: {len(urls)} links")
    for url in urls[:5]:  # Show first 5
        print(f"  - {url}")
```

{{< /tab >}}
{{< tab "page.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [page.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area/page.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts and categorizes hyperlinks by document region.

## Extract footer links

To extract links from the footer area:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

def extract_footer_links(file_path, page_height=842):
    """
    Extract links from document footer.
    
    Args:
        file_path: Path to document
        page_height: Approximate page height in points (default: A4 = 842)
    """
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return []
        
        # Define footer area (bottom 100 pixels)
        footer_y = page_height - 100
        footer_area = Rectangle(Point(0, footer_y), Size(600, 100))
        options = PageAreaOptions(footer_area)
        
        # Extract hyperlinks from footer
        hyperlinks = parser.get_hyperlinks(options)
        
        if hyperlinks:
            links = []
            for link in hyperlinks:
                links.append({
                    'text': link.text or '',
                    'url': link.url or '',
                    'position': (link.rectangle.left, link.rectangle.top)
                })
            return links
        
        return []

# Usage
footer_links = extract_footer_links("document.pdf")

print(f"Footer links: {len(footer_links)}")
for link in footer_links:
    print(f"{link['text']}: {link['url']}")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts links commonly found in document footers (e.g., copyright, contact, social media).

## Filter links by area and URL pattern

To extract links from an area matching a URL pattern:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size
import re

def extract_links_by_area_and_pattern(file_path, area_rect, url_pattern):
    """
    Extract links from area matching URL pattern.
    
    Args:
        file_path: Path to document
        area_rect: Tuple (x, y, width, height)
        url_pattern: Regex pattern for URLs
    """
    x, y, w, h = area_rect
    area = Rectangle(Point(x, y), Size(w, h))
    options = PageAreaOptions(area)
    
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return []
        
        hyperlinks = parser.get_hyperlinks(options)
        
        if not hyperlinks:
            return []
        
        # Filter by URL pattern
        matching_links = []
        pattern = re.compile(url_pattern, re.IGNORECASE)
        
        for link in hyperlinks:
            if link.url and pattern.search(link.url):
                matching_links.append({
                    'text': link.text,
                    'url': link.url
                })
        
        return matching_links

# Usage - extract PDF links from sidebar
sidebar_area = (400, 100, 200, 700)
pdf_links = extract_links_by_area_and_pattern(
    "document.html",
    sidebar_area,
    r'\.pdf$'
)

print(f"PDF download links in sidebar: {len(pdf_links)}
")
for link in pdf_links:
    print(f"  {link['text']}: {link['url']}")
```

{{< /tab >}}
{{< tab "document.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area/document.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< tab ".pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [.pdf](../../../../../../../../../.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts only links from the specified area that match the URL pattern.

## Extract social media links from specific area

To extract social media links from a defined region:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

def extract_social_media_links(file_path, area_rect):
    """
    Extract social media links from a specific area.
    """
    x, y, w, h = area_rect
    area = Rectangle(Point(x, y), Size(w, h))
    options = PageAreaOptions(area)
    
    # Social media domains
    social_domains = [
        'facebook.com', 'twitter.com', 'linkedin.com',
        'instagram.com', 'youtube.com', 'tiktok.com'
    ]
    
    with Parser(file_path) as parser:
        if not parser.features.hyperlinks:
            print("Hyperlink extraction not supported")
            return {}
        
        hyperlinks = parser.get_hyperlinks(options)
        
        if not hyperlinks:
            return {}
        
        # Categorize by platform
        social_links = {}
        
        for link in hyperlinks:
            if link.url:
                for domain in social_domains:
                    if domain in link.url:
                        platform = domain.split('.')[0].capitalize()
                        if platform not in social_links:
                            social_links[platform] = []
                        social_links[platform].append(link.url)
                        break
        
        return social_links

# Usage - extract from footer area
footer_area = (0, 800, 600, 100)
social_links = extract_social_media_links("webpage.html", footer_area)

print("Social Media Links:")
for platform, urls in social_links.items():
    print(f"  {platform}: {', '.join(urls)}")
```

{{< /tab >}}
{{< tab "webpage.htm" >}}
{{< tab-text >}}
The following sample file is used in this example: [webpage.htm](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page-area/webpage.htm)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts and categorizes social media links from a specific area.

## Notes

- Coordinates are in document-specific units (points or pixels)
- The origin (0, 0) is at the top-left corner
- Hyperlinks partially overlapping the area boundary are included
- Use `get_hyperlinks(page_index, options)` for page-specific area extraction
- Empty collections are returned if no hyperlinks are found (not `None`)
- Combine with page index for precise multi-page area extraction

## Related pages

- [Extract hyperlinks from document]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document" >}})
- [Extract hyperlinks from document page]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document-page" >}})
- [Extract text areas]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-areas" >}})


---

## Extract images from document page area

Path: /parser/java/extract-images-from-document-page-area/

GroupDocs.Parser provides the functionality to extract images from document page area by the by the [getImages(PageAreaOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages(com.groupdocs.parser.options.PageAreaOptions)) and [getImages(int, PageAreaOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages(int,%20com.groupdocs.parser.options.PageAreaOptions)) methods:

```java
Iterable<PageImageArea> getImages(PageAreaOptions options);
Iterable<PageImageArea> getImages(int pageIndex, PageAreaOptions options);
```

This method returns a collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getFileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getFileType()) | The format of the image. |
| [getRotation](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getRotation()) | The rotation angle of the image. |
| [getImageStream](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream()) | Returns the image stream. |
| [getImageStream(ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream(com.groupdocs.parser.options.ImageOptions)) | Returns the image stream in a different format. |
| [save(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String)) | Saves the image to the file. |
| [save(String, ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String,%20com.groupdocs.parser.options.ImageOptions)) | Saves the image to the file in a different format. |

[ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class is used to define the image format into which the image is converted. The following image formats are supported:

*   Bmp
*   Gif
*   Jpeg
*   Png
*   WebP

[PageAreaOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageAreaOptions) parameter is used to customize text areas extraction process. This class has the following members:

| Member | Description |
| --- | --- |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageAreaOptions#getRectangle()) | The rectangular area that contains a text area. |

Here are the steps to extract images from the upper-left corner:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [PageAreaOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageAreaOptions) with the rectangular area;
*   Call [getImages(PageAreaOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages(com.groupdocs.parser.options.PageAreaOptions)) method and obtain collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects;
*   Check if *collection* isn't *null* (images extraction is supported for the document);
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract only images from the upper-left corner:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Create the options which are used for images extraction
    PageAreaOptions options = new PageAreaOptions(new Rectangle(new Point(340, 150), new Size(300, 100)));
    // Extract images from the upper-left corner of a page:
    Iterable<PageImageArea> images = parser.getImages(options);
    // Check if images extraction is supported
    if (images == null) {
        System.out.println("Page images extraction isn't supported");
        return;
    }
    // Iterate over images
    for (PageImageArea image : images) {
        // Print a page index, rectangle and image type:
        System.out.println(String.format("Page: %d, R: %s, Type: %s", image.getPage().getIndex(), image.getRectangle(), image.getFileType()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from document page area

Path: /parser/net/extract-images-from-document-page-area/

GroupDocs.Parser provides the functionality to extract images from document page area by the [GetImages(PageAreaOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/getimages/methods/1) and [GetImages(int, PageAreaOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/getimages/methods/3) methods:

```csharp
IEnumerable<PageImageArea> GetImages(PageAreaOptions options);
IEnumerable<PageImageArea> GetImages(int pageIndex, PageAreaOptions options);

```

The methods return a collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area. |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/filetype) | The format of the image. |
| [Rotation](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/rotation) | The rotation angle of the image. |
| Stream [GetImageStream()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/getimagestream) | Returns the image stream. |
| Stream [GetImageStream(ImageOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.pageimagearea/getimagestream/methods/1) | Returns the image stream in a different format. |
| [Save(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/save) | Saves the image to the file. |
| [Save(string, ImageOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.pageimagearea/save/methods/1) | Saves the image to the file in a different format. |

[ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class is used to define the image format into which the image is converted. The following image formats are supported:

*   Bmp
*   Gif
*   Jpeg
*   Png
*   WebP

[PageAreaOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pageareaoptions) parameter is used to customize text areas extraction process. This class has the following members:

| Member | Description |
| --- | --- |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pageareaoptions/properties/rectangle) | The rectangular area that contains a text area. |

Here are the steps to extract images from the upper-left corner:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [PageAreaOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pageareaoptions) with the rectangular area;
*   Call [GetImages(PageAreaOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/getimages/methods/1) method and obtain collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects;
*   Check if *collection* isn't *null* (images extraction is supported for the document);
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract only images from the upper-left corner:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Create the options which are used for images extraction
    PageAreaOptions options = new PageAreaOptions(new Rectangle(new Point(0, 0), new Size(300, 100)));
    // Extract images from the upper-left corner of a page:
    IEnumerable<PageImageArea> images = parser.GetImages(options);
    // Check if images extraction is supported
    if (images == null)
    {
        Console.WriteLine("Page images extraction isn't supported");
        return;
    }
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Print a page index, rectangle and image type:
        Console.WriteLine(string.Format("Page: {0}, R: {1}, Type: {2}", image.Page.Index, image.Rectangle, image.FileType));
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract images from document page area

Path: /parser/python-net/extract-images-from-document-page-area/


GroupDocs.Parser allows extracting images from specific rectangular areas of a document page, enabling precise image extraction from defined regions.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents with images
- Understanding of coordinate systems

## Extract images from page area

To extract images from a specific rectangular area:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Check if image extraction is supported
    if not parser.features.images:
        print("Image extraction not supported")
        return
    
    # Define the area (upper-left corner, 300x100 pixels)
    area = Rectangle(Point(0, 0), Size(300, 100))
    
    # Create options for the area
    options = PageAreaOptions(area)
    
    # Extract images from the specified area
    images = parser.get_images(options)
    
    if images:
        print(f"Images found in area:")
        for idx, image in enumerate(images):
            print(f"  Image {idx + 1}: {image.file_type}, Page {image.page.index + 1}")
    else:
        print("No images found in the specified area")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns only images that are located within the specified rectangular area.

## Extract images from multiple regions

To extract images from several predefined areas:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size
import os

def extract_images_from_regions(file_path, regions, output_dir):
    """
    Extract images from multiple predefined regions.
    
    Args:
        file_path: Path to document
        regions: List of tuples (x, y, width, height)
        output_dir: Directory to save images
    """
    os.makedirs(output_dir, exist_ok=True)
    
    with Parser(file_path) as parser:
        if not parser.features.images:
            print("Image extraction not supported")
            return
        
        for region_idx, (x, y, w, h) in enumerate(regions):
            print(f"
Processing region {region_idx + 1}: ({x}, {y}, {w}x{h})")
            
            # Create rectangle for this region
            area = Rectangle(Point(x, y), Size(w, h))
            options = PageAreaOptions(area)
            
            # Extract images from this region
            images = parser.get_images(options)
            
            if images:
                for img_idx, image in enumerate(images):
                    filename = f"region{region_idx + 1}_img{img_idx + 1}{image.file_type.extension}"
                    filepath = os.path.join(output_dir, filename)
                    image.save(filepath)
                    print(f"  Saved: {filename}")

# Define regions (e.g., header, body, footer)
regions = [
    (0, 0, 600, 100),      # Header region
    (0, 100, 600, 700),    # Body region
    (0, 800, 600, 100)     # Footer region
]

# Extract images from regions
extract_images_from_regions("document.pdf", regions, "region_images")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts and saves images organized by the region they were found in.

## Extract images from page area with page index

To extract images from a specific area on a specific page:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

# Create an instance of Parser class
with Parser("document.pptx") as parser:
    if not parser.features.images:
        print("Image extraction not supported")
        return
    
    # Get document info
    info = parser.get_document_info()
    
    # Process specific page (e.g., first page)
    page_index = 0
    
    if page_index < info.page_count:
        # Define area (center of page, 400x300)
        area = Rectangle(Point(100, 100), Size(400, 300))
        options = PageAreaOptions(area)
        
        # Extract images from the area on the specific page
        images = parser.get_images(page_index, options)
        
        if images:
            print(f"Images on page {page_index + 1} in specified area:")
            for image in images:
                print(f"  Type: {image.file_type}")
                print(f"  Position: ({image.rectangle.left}, {image.rectangle.top})")
                print(f"  Size: {image.rectangle.width}x{image.rectangle.height}")
```

{{< /tab >}}
{{< tab "document.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pptx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area/document.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts images from a specific area on a specific page.

## Extract logo from document header

To extract logo images from the header area:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size
import os

def extract_header_logos(file_path, output_dir):
    """
    Extract logo images from document header area.
    """
    os.makedirs(output_dir, exist_ok=True)
    
    with Parser(file_path) as parser:
        if not parser.features.images:
            print("Image extraction not supported")
            return
        
        # Define header area (top 150 pixels, full width)
        header_area = Rectangle(Point(0, 0), Size(1000, 150))
        options = PageAreaOptions(header_area)
        
        # Extract images from header
        images = parser.get_images(options)
        
        if images:
            print(f"Found {len(list(images))} images in header
")
            
            # Re-extract as iterator was consumed
            images = parser.get_images(options)
            
            for idx, image in enumerate(images):
                filename = f"logo_{idx + 1}{image.file_type.extension}"
                filepath = os.path.join(output_dir, filename)
                image.save(filepath)
                print(f"Saved logo: {filename}")
        else:
            print("No images found in header area")

# Usage
extract_header_logos("invoice.pdf", "extracted_logos")
```

{{< /tab >}}
{{< tab "invoice.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [invoice.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area/invoice.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts logo or brand images typically found in document headers.

## Extract images from specific quadrants

To extract images from document quadrants:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size

def extract_by_quadrant(file_path, page_width=600, page_height=800):
    """
    Extract images by document quadrant (TL, TR, BL, BR).
    """
    # Define quadrants
    quadrant_size_w = page_width // 2
    quadrant_size_h = page_height // 2
    
    quadrants = {
        'Top-Left': Rectangle(Point(0, 0), Size(quadrant_size_w, quadrant_size_h)),
        'Top-Right': Rectangle(Point(quadrant_size_w, 0), Size(quadrant_size_w, quadrant_size_h)),
        'Bottom-Left': Rectangle(Point(0, quadrant_size_h), Size(quadrant_size_w, quadrant_size_h)),
        'Bottom-Right': Rectangle(Point(quadrant_size_w, quadrant_size_h), Size(quadrant_size_w, quadrant_size_h))
    }
    
    with Parser(file_path) as parser:
        if not parser.features.images:
            print("Image extraction not supported")
            return
        
        for quadrant_name, area in quadrants.items():
            options = PageAreaOptions(area)
            images = parser.get_images(options)
            
            if images:
                image_list = list(images)
                print(f"{quadrant_name}: {len(image_list)} images")
            else:
                print(f"{quadrant_name}: 0 images")

# Usage
extract_by_quadrant("layout.pdf")
```

{{< /tab >}}
{{< tab "layout.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [layout.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area/layout.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Categorizes and counts images by their location in document quadrants.

## Extract images larger than specific size

To filter images by size within an area:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageAreaOptions, Rectangle, Point, Size
import os

def extract_large_images_from_area(file_path, area_rect, min_width, min_height, output_dir):
    """
    Extract images larger than specified size from an area.
    """
    os.makedirs(output_dir, exist_ok=True)
    
    with Parser(file_path) as parser:
        if not parser.features.images:
            print("Image extraction not supported")
            return
        
        options = PageAreaOptions(area_rect)
        images = parser.get_images(options)
        
        if not images:
            print("No images found in area")
            return
        
        saved_count = 0
        
        for image in images:
            # Check image size
            if image.rectangle.width >= min_width and image.rectangle.height >= min_height:
                filename = f"large_image_{saved_count + 1}{image.file_type.extension}"
                filepath = os.path.join(output_dir, filename)
                image.save(filepath)
                
                print(f"Saved: {filename} ({image.rectangle.width}x{image.rectangle.height})")
                saved_count += 1
        
        print(f"
Total large images saved: {saved_count}")

# Usage - extract images larger than 100x100 from center area
center_area = Rectangle(Point(100, 100), Size(400, 600))
extract_large_images_from_area("document.pdf", center_area, 100, 100, "large_images")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts only images that meet the minimum size criteria within the specified area.

## Notes

- Always check `parser.features.images` before extracting images
- Coordinates are in document-specific units (points or pixels)
- The origin (0, 0) is at the top-left corner
- Images partially overlapping the area boundary are included
- Use `get_images(page_index, options)` to extract from a specific page area
- Empty collections are returned if no images are found in the area (not `None`)

## Related pages

- [Extract images from document]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document" >}})
- [Extract images from document page]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page" >}})
- [Extract images to files]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-to-files" >}})


---

## Extract images from Emails

Path: /parser/java/extract-images-from-emails/

To extract images from emails [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method is used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class it is possible to extract images from emails as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}
[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns *null* value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file 
[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns *null*. If an email has no images, 
[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract images from an email to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial email;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from an email:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleMsg)) {
    // Extract images from the email
    Iterable<PageImageArea> images = parser.getImages();
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
    int imageNumber = 0;
    // Iterate over images
    for (PageImageArea image : images)
    {
        // Save the image to the png file
        image.save(Constants.getOutputFilePath(String.format("%d.png", imageNumber)), options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from Emails

Path: /parser/net/extract-images-from-emails/

To extract images from emails [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method is used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class it is possible to extract images from emails as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}
[GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages)[ ](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method returns *null* value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns *null*. If an email has no images, [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract images from an email to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial email;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from an email:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract images from the email
    IEnumerable<PageImageArea> images = parser.GetImages();
 
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
 
    int imageNumber = 0;
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Save the image to the png file
        image.Save(imageNumber.ToString() + ".png", options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from Microsoft Office Excel spreadsheets

Path: /parser/java/extract-images-from-microsoft-office-excel-spreadsheets/

To extract images from Microsoft Office Excel spreadsheets [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class it is possible to extract images from Microsoft Office Excel spreadsheets as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns null value if image extraction isn't supported for the document. For example, image extraction isn't supported for CSV files. Therefore, for CSV file [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns null. If Microsoft Office Excel spreadsheet has no images,[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns an empty collection.{{< /alert >}}

Here are the steps to extract images from Microsoft Office Excel spreadsheet to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from Microsoft Office Excel spreadsheet:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleWithImagesXlsx)) {
    // Extract images from spreadsheet
    Iterable<PageImageArea> images = parser.getImages();
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
    int imageNumber = 0;
    // Iterate over images
    for (PageImageArea image : images)
    {
        // Save the image to the png file
        image.save(Constants.getOutputFilePath(String.format("%d.png", imageNumber)), options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from Microsoft Office Excel spreadsheets

Path: /parser/net/extract-images-from-microsoft-office-excel-spreadsheets/

To extract images from Microsoft Office Excel spreadsheets [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class it is possible to extract images from Microsoft Office Excel spreadsheets as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}
[GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages)[ ](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata)method returns *null* value if image extraction isn't supported for the document. For example, image extraction isn't supported for CSV files. Therefore, for CSV file [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns *null*. If Microsoft Office Excel spreadsheet has no images, [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract images from Microsoft Office Excel spreadsheet to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from Microsoft Office Excel spreadsheet:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract images from spreadsheet
    IEnumerable<PageImageArea> images = parser.GetImages();
 
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
 
    int imageNumber = 0;
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Save the image to the png file
        image.Save(imageNumber.ToString() + ".png", options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from Microsoft Office PowerPoint presentations

Path: /parser/java/extract-images-from-microsoft-office-powerpoint-presentations/

To extract images from Microsoft Office PowerPoint presentations [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class it is possible to extract images from Microsoft Office PowerPoint presentations as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns null value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns null. If Microsoft Office PowerPoint presentation has no images, [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns an empty collection.{{< /alert >}}

Here are the steps to extract images from Microsoft Office PowerPoint presentation to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from Microsoft Office PowerPoint presentation:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleWithImagesPptx)) {
    // Extract images from presentation
    Iterable<PageImageArea> images = parser.getImages();
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
    int imageNumber = 0;
    // Iterate over images
    for (PageImageArea image : images)
    {
        // Save the image to the png file
        image.save(Constants.getOutputFilePath(String.format("%d.png", imageNumber)), options);
        imageNumber++;
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from Microsoft Office PowerPoint presentations

Path: /parser/net/extract-images-from-microsoft-office-powerpoint-presentations/

To extract images from Microsoft Office PowerPoint presentations [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class it is possible to extract images from Microsoft Office PowerPoint presentations as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}GetImages method returns null value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file GetImages method returns null. If Microsoft Office PowerPoint presentation has no images, GetImages method returns an empty collection.{{< /alert >}}

Here are the steps to extract images from Microsoft Office PowerPoint presentation to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial presentation;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from Microsoft Office PowerPoint presentation:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract images from presentation
    IEnumerable<PageImageArea> images = parser.GetImages();
  
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
  
    int imageNumber = 0;
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Save the image to the png file
        image.Save(imageNumber.ToString() + ".png", options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from Microsoft Office Word documents

Path: /parser/java/extract-images-from-microsoft-office-word-documents/

To extract images from Microsoft Office Word documents [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class it is possible to extract images from Microsoft Office Word documents as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns null value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns null. If Microsoft Office Word document has no images, [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns an empty collection.{{< /alert >}}

Here are the steps to extract images from Microsoft Office Word document to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleWithImagesDocx)) {
    // Extract images from document
    Iterable<PageImageArea> images = parser.getImages();
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
    int imageNumber = 0;
    // Iterate over images
    for (PageImageArea image : images)
    {
        // Save the image to the png file
        image.save(Constants.getOutputFilePath(String.format("%d.png", imageNumber)), options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from Microsoft Office Word documents

Path: /parser/net/extract-images-from-microsoft-office-word-documents/

To extract images from Microsoft Office Word documents [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class it is possible to extract images from Microsoft Office Word documents as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}
[GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages)[ ](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata)method returns *null* value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns *null*. If Microsoft Office Word document has no images, [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract images from Microsoft Office Word document to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from Microsoft Office Word document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract images from document
    IEnumerable<PageImageArea> images = parser.GetImages();
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
    int imageNumber = 0;
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Save the image to the png file
        image.Save(imageNumber.ToString() + ".png", options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from PDF documents

Path: /parser/java/extract-images-from-pdf-documents/

To extract images from PDF documents [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ImageOptions) class it is possible to extract images from PDF documents as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}
[getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns *null* value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns *null*. If PDF document has no images, [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract images from PDF document to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from PDF document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Extract images from document
    Iterable<PageImageArea> images = parser.getImages();
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
    int imageNumber = 0;
    // Iterate over images
    for (PageImageArea image : images)
    {
        // Save the image to the png file
        image.save(Constants.getOutputFilePath(String.format("%d.png", imageNumber)), options);
        imageNumber++;
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from PDF documents

Path: /parser/net/extract-images-from-pdf-documents/

To extract images from PDF documents [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) methods are used. By default images are extracted with its original format. With using [ImageOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/imageoptions) class it is possible to extract images from PDF documents as bmp, gif, jpeg, png and webp formats.

{{< alert style="warning" >}}
[GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages)[ ](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata)method returns *null* value if image extraction isn't supported for the document. For example, image extraction isn't supported for TXT files. Therefore, for TXT file [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns *null*. If PDF document has no images, [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract images from PDF document to PNG-files:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain the collection of image objects;
*   Iterate through the collection and save image contents to the file.

The following example demonstrates how to extract images from PDF document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract images from document
    IEnumerable<PageImageArea> images = parser.GetImages();
  
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
  
    int imageNumber = 0;
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Save the image to the png file
        image.Save(imageNumber.ToString() + ".png", options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract table of contents from EPUB eBooks

Path: /parser/java/extract-table-of-contents-from-epub-ebooks/

To extract table of contents from EPUB e-books [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method is used.

{{< alert style="warning" >}}
[getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method returns *null* value if table of contents extraction isn't supported for the document. For example, table of contents extraction isn't supported for TXT files. Therefore, for TXT file [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method returns *null*. If EPUB e-book has no table of contents, [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract extract table of contents from EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial e-book;
*   Call [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method and obtain collection of [TocItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem "class in com.groupdocs.parser.data") objects;
*   Iterate through the collection and get page index to extract a page text from the document.

The following example shows how to extract table of contents from EPUB e-book:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleEpub)) {
    // Get table of contents
    Iterable<TocItem> tocItems = parser.getToc();
    // Iterate over items
    for (TocItem tocItem : tocItems) {
        // Print the text of the chapter
        try (TextReader reader = tocItem.extractText()) {
            System.out.println("----");
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract table of contents from EPUB eBooks

Path: /parser/net/extract-table-of-contents-from-epub-ebooks/

To extract table of contents from EPUB e-books [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method is used.

{{< alert style="warning" >}}
[GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method returns *null* value if table of contents extraction isn't supported for the document. For example, table of contents extraction isn't supported for TXT files. Therefore, for TXT file [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method returns *null*. If EPUB e-book has no table of contents, [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method returns an empty collection.
{{< /alert >}}

Here are the steps to extract extract table of contents from EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial e-book;
*   Call [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method and obtain collection of [TocItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem) objects;
*   Iterate through the collection and get page index to extract a page text from the document.

The following example shows how to extract table of contents from EPUB e-book:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Get table of contents
    IEnumerable<TocItem> toc = parser.GetToc();
    // Iterate over items
    foreach (TocItem i in toc)
    {
        // Print the Toc text
        Console.WriteLine(i.Text);
        // Check if page index has a value
        if (i.PageIndex == null)
        {
            continue;
        }
        // Extract a page text
        using (TextReader reader = parser.GetText(i.PageIndex.Value))
        {
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from documents

Path: /parser/python-net/extract-text-from-documents/


Text extraction is one of the most fundamental features of [GroupDocs.Parser](https://products.groupdocs.com/parser/python-net). The API allows you to extract text from:

*   PDF documents
*   Microsoft Office documents (Word, Excel, PowerPoint)
*   Email messages
*   Images (with OCR)
*   eBooks (EPUB, FB2, CHM)
*   And 50+ other formats

GroupDocs.Parser's text extractor is easy to use and powerful at the same time. For advanced text extraction scenarios, refer to the [advanced usage section]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/_index.md" >}}).

## Extract text from documents

To extract text from documents, simply call the `get_text` method:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("./sample.docx") as parser:
  text_reader = parser.get_text()
```

{{< /tab >}}
{{< /tabs >}}

The method returns a text reader object with the extracted text.

Here are the steps to extract text from a document:

1. Instantiate the `Parser` object with the source document path
2. Call the `get_text` method and obtain the text reader object
3. Read the text from the reader

The following code snippet shows how to extract text from a document:

## Extract text from local files
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.docx") as parser:
    # Extract text into the reader
    text_reader = parser.get_text()
    
    if text_reader is not None:
        # Print the extracted text
        extracted_text = text_reader
        print(extracted_text)
    else:
        print("Text extraction isn't supported for this format")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-text-from-documents/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Extract text from a stream
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Open the file stream
with open("sample.pdf", "rb") as stream:
    # Create an instance of Parser class with the stream
    with Parser(stream) as parser:
        # Extract text into the reader
        text_reader = parser.get_text()
        
        if text_reader is not None:
            # Print the extracted text
            extracted_text = text_reader
            print(extracted_text)
        else:
            print("Text extraction isn't supported for this format")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-text-from-documents/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Extract text from specific pages

You can also extract text from specific pages in a document:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("./sample.pdf") as parser:
    # Get document info to check page count
    doc_info = parser.get_document_info()
    
    # Check if the document has pages
    if doc_info.page_count > 0:
        # Extract text from the first page (page index is 0-based)
        text_reader = parser.get_text(0)
        
        if text_reader:
            print(f"Text from page 1:")
            print(text_reader)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-text-from-documents/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about text extraction features, including formatted text, text structure, and search functionality, please refer to the [advanced usage section]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/_index.md" >}}).

### GitHub examples

You may find more code examples in our GitHub repository:

*   [GroupDocs.Parser for Python via .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET)

### Free online text extractor

Along with the full-featured library, we provide a free online text extractor app. You are welcome to extract text from your documents with our [Free Online Document Parser App](https://products.groupdocs.app/parser).


---

## Features overview

Path: /conversion/java/features-overview/

## File conversion

GroupDocs.Conversion main feature is the ability to convert any document from any of supported source document formats into any supported target format (check the list of  [supported formats]({{< ref "conversion/java/supported-document-formats.md" >}})). All these conversions are possible without any additional software installed (like MS Office, Apache Open Office, Adobe Acrobat Reader and others).
GroupDocs.Conversion provides a flexible set of settings to customize the conversion process to fulfill your needs:

### Convert specific document page(s)

Along with the whole document conversion to the desired target format, it could be useful to convert specific document pages or page ranges. For such partial document conversion, you should specify desired page numbers to convert using the [setPages](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/ConvertOptions#setPages%28java.util.List%29) property of the `ConvertOptions` class.

### Auto-detect source document format

In some cases, the source file could be presented in a form of a byte stream, so the file extension is unknown.
Luckily GroupDocs.Conversion for Java is smart enough to detect source document format on the fly.

### Load source document with extended options

There are lots of modifications that are possible during the file conversion process:

- specify a password for [password-protected documents]({{< ref "conversion/java/developer-guide/loading-documents/load-password-protected-document.md" >}});
- show/hide document [comments]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-wordprocessing-document-with-options.md" >}}) and [annotations]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-pdf-document-with-options.md" >}});
- [show/hide markup and track changes]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-wordprocessing-document-with-options.md" >}}) for Word documents;
- [show hidden sheets]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-spreadsheet-document-with-options.md" >}}) when converting Excel files or not;
- set the [text file encoding]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-txt-document-with-options.md" >}}) and many more;

### Obtain all supported conversion formats list

You can obtain the [complete list of possible conversions]({{< ref "conversion/java/developer-guide/converting-documents/basic-usage/get-possible-conversions.md" >}}) that are supported by GroupDocs.Conversion for Java library. Also, it is possible to get allowed conversions for the specific file format.

### Fonts replacement

It is a common use case when a source document references some specific fonts that are not present in the environment where you launch your application. GroupDocs.Conversion for Java provides a solution - you can [substitute missing fonts]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-wordprocessing-document-with-options#specify-font-substitution" >}}) with fonts of your choice that will preserve your document appearance.

### Watermarking converted document

You can [add a text or an image watermark]({{< ref "conversion/java/developer-guide/converting-documents/advanced-usage/converting/common-conversion-options/add-watermark.md" >}}) to any page of the converted document and choose its desired dimensions, color and font size.

## Document information extraction

GroupDocs.Conversion allows to obtain basic [information about source document]({{< ref "conversion/java/developer-guide/get-document-info.md" >}}) - file type, pages count etc. Dependent on the source file type some format-specific information can be extracted, for example:

- CAD - list of layers and layouts in a CAD document;
- Email – list of attachments;
- PDF – title, author, table of contents and more;
- Project Management – project start and end dates.

## Load documents from different sources

With GroupDocs.Conversion you are not limited to [local files]({{< ref "conversion/java/developer-guide/loading-documents/loading-documents-from-different-sources/load-document-from-local-disk.md" >}}) only. It also supports loading documents from [stream]({{< ref "conversion/java/developer-guide/loading-documents/loading-documents-from-different-sources/load-document-from-stream.md" >}}), [FTP]({{< ref "conversion/java/developer-guide/loading-documents/loading-documents-from-different-sources/load-document-from-ftp.md" >}}), [remote URLs]({{< ref "conversion/java/developer-guide/loading-documents/loading-documents-from-different-sources/load-document-from-url.md" >}}), as wel as from [Amazon S3]({{< ref "conversion/java/developer-guide/loading-documents/loading-documents-from-different-sources/load-document-from-amazon-s3-storage.md" >}}) and [Azure]({{< ref "conversion/java/developer-guide/loading-documents/loading-documents-from-different-sources/load-document-from-azure-blob-storage.md" >}}) clouds.

## Caching results

GroupDocs.Conversion supports [conversion result caching]({{< ref "conversion/java/developer-guide/converting-documents/advanced-usage/caching/" >}}) to local disk by default. However, any type of cache storage can be supported by implementing appropriate interfaces – Amazon S3, Dropbox, Google Drive, Windows Azure, Redis or any other.

## Work with archives
It is possible to convert archived files to all supported formats or just extract files. Also, you can archive the result of the conversion.
---

## Features overview

Path: /viewer/python-net/features-overview/

  
## Rendering Documents

We use the term ["rendering"]({{< ref "viewer/python-net/developer-guide/rendering-documents/_index.md" >}}) in GroupDocs.Viewer to describe the process of converting a document into a file format, paginated, or that has the concept of pages. For example, when you have a DOCX file with three pages then after rendering this file to HTML you will get three HTML files on the output that represent each of the pages in the document.

![Rendering diagram](/viewer/python-net/images/getting-started/features-overview/rendering.png)

### Rendering to HTML

Rendering to HTML will suit the best when you have the following requirements:

* You are writing a web-based application;
* Document content should be displayed inside web-browser;
* You need an ability to interact with rendered document text - select, copy or search;
* You want to view document pages separately;
* Zooming in a document without quality loss for most cases;
* You want to rotate, reorder pages or add watermarks.

GroupDocs.Viewer for Python provides two resources management options for CSS, fonts, images, etc.:

* Rendering to **HTML with external resources** - stores page resources near to HTML which allows to reuse common resources across separate pages and dramatically reduce page size and loading speed.
* Rendering to **HTML with embedded resources** - integrates page resources into HTML and makes each document page self-sufficient. The drawback is that page size and loading speed may decrease.

### Rendering to PNG or JPEG

Rendering to PNG or JPEG will suit the best when you have the following requirements:

* You are writing any type of application;
* You don’t need to render textual content or want to restrict interaction with rendered document text. For example: prevent text copying. There is still an ability for you to extract document text if you want to add selectable text layer over the page image (described below).
* You want to view document pages separately;
* You want to rotate, reorder pages or add watermarks.

Following is a brief description of both image formats which may help you to choose the most suitable for your case.  

* **PNG** **format** is a lossless raster graphics file format that works with full-color images and supports transparency. There is no ability to adjust the quality of saved PNG image. PNG is a good choice for storing line drawings, text, and iconic graphics at small file sizes.
* **JPEG** **format** is a lossy compressed file format which allows to adjust the quality of the saved image — when it is reduced, the details are removed and noise is added to the image, but the size becomes more compact. JPEG is optimal for images with a large number of colors (for example, for photos). It’s is a common choice to use JPEG on the Web because of its compression.

### Rendering to PDF

GroupDocs.Viewer renders a document to a single PDF document, so rendering to PDF will suit the best when you have the following requirements:

* You are going to print documents;
* You want to send documents via email.
* You don’t want to display document pages separately since all pages of a source document are rendered as a single PDF document.

## Retrieving Document Information

GroupDocs.Viewer for Python allows to obtain basic information about source documents such as file type, pages count, text with coordinates, etc.

For the following document formats additional information can also be extracted:

* Archive – list of folders contained in archive;
* CAD - list of layers and layouts in a CAD document;
* Email – list of folders contained in an Outlook data file document;
* PDF – information about document printing restrictions;
* Project Management – project start and end dates.

### Text extraction

You can opt to extract document text when rendering to PNG or JPEG, document text can be extracted along with separate words coordinates.

This may be helpful when you want to add selectable text layer over the page image.

## Processing attachments

We use the term "attachments" in GroupDocs.Viewer for email attachments, embedded files, and compressed files.

With GroupDocs.Viewer you can list and save:

* Email attachments;
* Files that are embedded in PDF files;
* Email messages contained by Outlook and LotusNotes data files;
* Compressed files.

## Output transformation

GroupDocs.Viewer for Python provides a set of options to apply different document page transformations:

* Rotate pages - change page orientation when rendering to HTML, JPG, PNG and PDF.
* Add text watermark - add text watermark to each of the rendered pages.
* Reorder pages - render pages in order you prefer or reorder pages when rendering to PDF.

## Caching results

GroupDocs.Viewer for Python provides a document viewer API that supports caching in order to boost document loading speed and optimize application performance.

Documents cache is saved to a local disk by default. However, document viewer API also provides document cache interfaces that can be implemented for 3rd party storage support - FTP, Amazon S3, Dropbox, Google Drive, Microsoft Azure, Redis or any other.

---

## Features overview

Path: /watermark/python-net/features-overview/

  
## What Is GroupDocs.Watermark?

GroupDocs.Watermark for Java is a powerful API for managing watermarks in the documents of different file formats. It provides the effective watermarking methods that allow you to add watermarks that are hard to be automatically removed by third-party tools. It also allows you to search and remove previously added watermarks of popular types (including watermarks added by third-party tools) in a document. The API provides straightforward and easy to use set of methods to add, search, and remove watermarks in supported file formats.

## Why Use GroupDocs.Watermark as a Developer?

*   Fetch all Documents of Various Formats from a Folder and Apply or Remove Watermarks
*   Add or Remove Watermark from a Particular Section or whole Document
*   Attach Watermark to all Images in a Particular Section, Page, Slide, or Document
*   Assign Watermark to only Particular Frames of a Multi-Framed Image
*   Allocate Hidden Watermark to PDF that only Appears when Printing Document
*   Set Watermark to all Attachments in an Excel Document & all Image Shapes in Slides
*   Place Watermark or Remove it from the Background Images of Spreadsheet or Slides
*   Employ Watermark to Supported Files in all Attachments of an Email or PDF Document
*   Apply or Remove Watermark as XObjects, Artifacts & Annotations in PDF Documents
*   Eliminate Watermark Containing Text with Particular Formatting
*   Look for Image Watermarks that Resemble a Particular Image
*   Identify Text Watermark Even if there are Unreadable Characters between Letters
*   Search Watermarks Based on Specific Parameters or by Combining Multiple Criteria
*   Specify Font Formatting to Look for Matching Text Watermark
*   Programmatically Extract Page Setup & Other Information for Supported Formats
*   Add Watermark to Images inside any Header & Footer in Supported Document Formats
*   Add Watermark to Image Shapes in a Word Document & Lock Watermarks to Restrict Editing
*   Protect Text Watermark using Unreadable Characters in Presentations
*   Rasterize Particular Page or Whole PDF Document to Protect Added Watermarks
*   Change Text Formatting While Replacing Existing Text Watermark
*   Align Watermark to Bleed Box, Art Box, Crop Box, or Trim Box in PDF Document
---

## eSign document with Form Field signature

Path: /signature/net/esign-document-with-form-field-signature/

## What is a Form Field?

A **form field** is an interactive element located on a document page that allows user data input through various control types like free input text boxes, multi-line text boxes, checkboxes, drop-down lists, etc. Different document types support a specific list of form field types. These elements are used to collect information from users on template form. Each Form Field element has a unique name, settings and value field. Form Fields should have unique names within the form. The picture below demonstrates a possible document page with form fields.

![FormField](/signature/net/images/esign-document-with-form-field-signature.png)

## How to eSign document with Form Field signature

With [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) you can create new form fields or update the existing ones within the documents. The [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) class specifies different options for Form Field signature. The [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) class contains one [FormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/formfieldsignature/) object that specifies the properties of the desired signature.

Below are listed different Form Field signature classes that could be set to [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions):

* [TextFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textformfieldsignature) - represents a text input form field on a document page.
* [CheckboxFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/checkboxformfieldsignature) - represents a checkbox field on a document page.
* [ComboboxFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/comboboxformfieldsignature) - represents a combo box field signature input with a list of possible options.
* [RadioButtonFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/radiobuttonformfieldsignature) - represents a radio button signature on a document page.
* [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalformfieldsignature) - represents a digital signature input form on a document page.  

Here are the steps to add Form Field signatures into a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter;
* Instantiate the [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) object according to your requirements;
* Instantiate one of the objects - [TextFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textformfieldsignature), [CheckboxFormFieldSignature,](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/checkboxformfieldsignature) [ComboboxFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/comboboxformfieldsignature), [RadioButtonFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/radiobuttonformfieldsignature) or [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalformfieldsignature);
* Assign the [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) property with the object created in a previous step;
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) object to it.

{{< alert style="note" >}}
Currently GroupDocs.Signature supports the creation of Form Field signatures for PDF documents only.
{{< /alert >}}

This example shows how to sign a PDF document with a Form Field electronic signature.

```csharp
            // The path to the documents directory.
            string filePath = "sample.pdf";
            string fileName = Path.GetFileName(filePath);

            string outputFilePath = Path.Combine("C:\output", fileName);

            using (Signature signature = new Signature(filePath))
            {
                // Instantiate text form field signature
                FormFieldSignature textSignature = new TextFormFieldSignature("FieldText", "Value1");

                // Instantiate options based on text form field signature
                FormFieldSignOptions options = new FormFieldSignOptions(textSignature)
                {
                    HorizontalAlignment = HorizontalAlignment.Left,
                    VerticalAlignment = VerticalAlignment.Top,
                    Margin = new Padding(10, 20, 0, 0),
                    Height = 10,
                    Width = 100
                };
                // Sign document and save to the file
                signature.Sign(outputFilePath, options);
            }
```

## How to eSign document with existing Form Field signatures

GroupDocs.Signature for .NET also provides a mechanism to update the existing form field signatures within the documents.

To update an existing form field signature within the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) object with all required additional options.
* Set the [TextSignOptions.SignatureImplementation](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/signatureimplementation) property with the [TextSignatureImplementation.FormField](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation) value.
* Set the [FormTextFieldTitle](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/formtextfieldtitle) and [FormTextFieldType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/formtextfieldtype) properties with the proper values of form fields to be updated.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the initialized [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) instance to it.
* Analyze the [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) object to check the newly created signatures if needed.  

This example shows how to sign a PDF document with the existing Form Field electronic signature and update its value.

```csharp
// The path to the documents directory.
string filePath = "sample.pdf";
string fileName = Path.GetFileName(filePath);

string outputFilePath = Path.Combine("C:\output", fileName);

using (Signature signature = new Signature(filePath))
{
    TextSignOptions ffOptions1 = new TextSignOptions("Document is approved")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.FormField,
        FormTextFieldType = FormTextFieldType.PlainText
    };
    TextSignOptions ffOptions2 = new TextSignOptions("John Smith")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.FormField,
        FormTextFieldType = FormTextFieldType.RichText,
        FormTextFieldTitle = "UserSignatureFullName"
    };
    List<SignOptions> listOptions = new List<SignOptions>();
    listOptions.Add(ffOptions1);
    listOptions.Add(ffOptions2);
    // sign document to file
    SignResult signResult = signature.Sign(outputFilePath, listOptions);
}
```
### Summary
This guide explains how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) to add form field signatures to documents. It covers loading a document, configuring form field properties such as name, type, and value, and saving the signed document. Advanced options, like customizing field appearance and placement, are also included. For more details, refer to related guides on document signing techniques.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF documents for free, you can use the [Digital Signature - PDF](https://products.groupdocs.app/signature/pdf) online application.

To sign Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign document with Form Field signature

Path: /signature/nodejs-java/esign-document-with-form-field-signature/

## What is a Form Field?

A **form field** is an interactive element located on a document page that allows user data input through various control types like free input text boxes, multi-line text boxes, checkboxes, drop-down lists, etc. Different document types support a specific list of form field types. These elements are used to collect information from users on template form. Each Form Field element has a unique name, settings and value field. Form Fields should have unique names within the form. The picture below demonstrates a possible document page with form fields.

![FormField](/signature/nodejs-java/images/esign-document-with-form-field-signature.png)

With [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) you can create new form fields or update the existing ones within the documents. The [FormFieldSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/formfieldsignoptions) class specifies different options for Form Field signature. The [FormFieldSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/formfieldsignoptions) class contains one [FormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/formfieldsignature) object that specifies the properties of the desired signature.

Below are listed different Form Field signature classes that could be set to [FormFieldSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/formfieldsignoptions):

* [TextFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textformfieldsignature) - represents a text input form field on a document page.
* [CheckboxFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/checkboxformfieldsignature) - represents a checkbox field on a document page.
* [ComboboxFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/comboboxformfieldsignature) - represents a combo box field signature input with a list of possible options.
* [RadioButtonFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/radiobuttonformfieldsignature) - represents a radio button signature on a document page.
* [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/digitalformfieldsignature) - represents a digital signature input form on a document page.

Here are the steps to add Form Field signatures into a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter;
* Instantiate the [FormFieldSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/formfieldsignoptions) object according to your requirements;
* Instantiate one of the objects - [TextFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textformfieldsignature), [CheckboxFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/checkboxformfieldsignature), [ComboboxFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/comboboxformfieldsignature), [RadioButtonFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/radiobuttonformfieldsignature) or [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/digitalformfieldsignature);
* Assign the [FormFieldSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/formfieldsignoptions) property with the object created in a previous step;
* Call the [Sign](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/sign) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [FormFieldSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/formfieldsignoptions) object to it.

{{< alert style="note" >}}
Currently GroupDocs.Signature supports the creation of Form Field signatures for PDF documents only.
{{< /alert >}}

This example shows how to sign a PDF document with a Form Field electronic signature.

```javascript
// The path to the documents directory.
const filePath = Constants.SAMPLE_PDF; // Assuming Constants.SAMPLE_PDF is defined elsewhere
const fileName = path.basename(filePath);

const outputFilePath = path.join(Constants.OutputPath, 'SignPdfWithFormField', fileName);
const signature = new signatureLib.Signature(filePath);

// Instantiate text form field signature
const textSignature = new signatureLib.TextFormFieldSignature('FieldText', 'Value1');
// Instantiate options based on text form field signature
const options = new signatureLib.FormFieldSignOptions(textSignature);
options.setMargin(new signatureLib.Padding(10, 20, 0, 0));
options.setHeight(10);
options.setWidth(100);

// Sign document to file
signature.sign(outputFilePath, options);
console.log(`\nSource document signed successfully.\nFile saved at ${outputFilePath}`);
```

## How to eSign document with existing Form Field signatures

GroupDocs.Signature for Node.Js via Java also provides a mechanism to update the existing form field signatures within the documents.

To update an existing form field signature within the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions) object with all required additional options.
* Set the [TextSignOptions.SignatureImplementation](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions/signatureimplementation) property with the [TextSignatureImplementation.FormField](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textsignatureimplementation) value.
* Set the [FormTextFieldTitle](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions/formtextfieldtitle) and [FormTextFieldType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions/formtextfieldtype) properties with the proper values of form fields to be updated.
* Call the [Sign](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/sign) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the initialized [TextSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions) instance to it.
* Analyze the [SignResult](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/signresult) object to check the newly created signatures if needed.

This example shows how to sign a PDF document with the existing Form Field electronic signature and update its value.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF; // Assuming Constants.SAMPLE_PDF is defined elsewhere
  const fileName = path.basename(filePath);

  const outputFilePath = path.join(Constants.OutputPath, 'SignPdfWithFormField', fileName);
  const signature = new signatureLib.Signature(filePath);

  // Instantiate text form field signature
  const textSignature = new signatureLib.TextFormFieldSignature('FieldText', 'Value1');
  // Instantiate options based on text form field signature
  const options = new signatureLib.FormFieldSignOptions(textSignature);
  options.setMargin(new signatureLib.Padding(10, 20, 0, 0));
  options.setHeight(10);
  options.setWidth(100);

  // Sign document to file
  signature.sign(outputFilePath, options);
  console.log(`\nSource document signed successfully.\nFile saved at ${outputFilePath}`);
```
### Summary
This guide explains how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) to add form field signatures to documents. It covers loading a document, configuring form field properties such as name, type, and value, and saving the signed document. Advanced options, like customizing field appearance and placement, are also included. For more details, refer to related guides on document signing techniques.



## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature Node.Js for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF documents for free, you can use the [Digital Signature - PDF](https://products.groupdocs.app/signature/pdf) online application.

To sign Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Generate document page preview

Path: /annotation/java/generate-document-pages-preview/


GroupDocs.Annotation allows you to generate document page previews. To do this, call the [generatePreview](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/document/#generatePreview-com.groupdocs.annotation.options.pagepreview.PreviewOptions-) method of the [Document](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/document/) class. 

Use the [PreviewOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/) class to manage the preview generation process: specify desired page numbers, image format, etc.

To generate a document preview, follow these steps:
1.  Create an instance of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the source document path as a parameter. The [Document](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/document/) property of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class provides access to source document and implements [generatePreview](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/document/#generatePreview-com.groupdocs.annotation.options.pagepreview.PreviewOptions-) method.
3.   Instantiate the [PreviewOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/) class. Follow these steps:
    a.   for each page, delegate stream creation (see the [CreatePageStream](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/createpagestream/) event handler); 
    b.   specify the image preview format - PNG / JPG / BMP;
    c.   specify page numbers to process;
    d.   set the custom size of preview images (if needed).  
{{< alert style="info" >}} Stream created by the [CreatePageStream](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/createpagestream/) delegate are disposed automatically once after generation of preview image. To implement the custom image preview stream disposing, you have to specify an additional argument [ReleasePageStream](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/releasepagestream/) to clean up resources.
{{< /alert >}}       
4.  Call the [generatePreview](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/document/#generatePreview-com.groupdocs.annotation.options.pagepreview.PreviewOptions-) method of the [Document](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/document/) class. Specify [PreviewOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/).

    
The [PreviewOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/) class main properties are as follows:
*   [CreatePageStream](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/createpagestream/) is a delegate which defines the method to create output page preview stream.
*   [ReleasePageStream](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/releasepagestream/) is a delegate which defines the method to remove output page preview stream. Use it for advanced control for resources handling.
*   [Width](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/#setWidth-int-) specifies the preview image width.
*   [Height](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/#setHeight-int-) specifies the preview image height.
*   [PageNumbers]https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/#setPageNumbers-int---) - Page numbers that will be previewed;
*   [PreviewFormat](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/#setPreviewFormat-int-) gets or sets the preview image format. Use the BMP format should be used for the best image quality. Use the JPG format in case of strict requirements to image size, but with lower quality than BMP. By default GroupDocs.Annotation uses the PNG format which is a golden mean between image quality and size.
*   [RenderComments](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/#setRenderComments-boolean-) is an option to show or hide comments. By default it is `true`. Set it to `false` if you do not need to show comments. This property affects only on WordProcessing documents. The `RenderComments` value impacts any document comments.
*   [RenderAnnotations](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/#setRenderAnnotations-boolean-) is an option to show or hide annotations.By default it is `true`. Set it to `false` if you do not need to show annotations.
*   [WorksheetColumns](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.pagepreview/previewoptions/#setWorksheetColumns-java.util.List-com.groupdocs.annotation.options.pagepreview.WorksheetColumnsRange--) is a list of the `WorksheetColumnsRange` objects that indicates which columns to generate on specified worksheet.

The following code snippet demonstrates how to generate document previews.

## Get document page previews 

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates annotating generating previews from document
Annotator annotator = new Annotator("inputPath");

// Create an instance of PreviewOptions class
PreviewOptions previewOptions = new PreviewOptions(new CreatePageStream() {
    @Override
    public OutputStream invoke(int pageNumber) {
        try {
            // Set several file name
            String fileName = "OutputPath_"+pageNumber+".png";
            OutputStream result = new FileOutputStream(fileName);
            return result;
        } catch (Exception ex) {
            throw new GroupDocsException(ex);
        }
    }
});

previewOptions.setPreviewFormat(PreviewFormats.PNG);

previewOptions.setPageNumbers(new int[]{1, 2, 3});

// Generate preview for documents
annotator.getDocument().generatePreview(previewOptions);
```
{{< /tab >}}
{{< /tabs >}}

## Set specific size for preview images

You can set a specific size for preview images. For example, you can create small-sized thumbnails and full-sized previews.

The following code snippet shows how to set specific size for preview images:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
// This example demonstrates annotating generating previews from document
Annotator annotator = new Annotator("inputPath");

// Create an instance of PreviewOptions class
PreviewOptions previewOptions = new PreviewOptions(new CreatePageStream() {
    @Override
    public OutputStream invoke(int pageNumber) {
        try {
            // Set several file name
            String fileName = "OutputPath_"+pageNumber+".png";
            OutputStream result = new FileOutputStream(fileName);
            return result;
        } catch (Exception ex) {
            throw new GroupDocsException(ex);
        }
    }
});

previewOptions.setPreviewFormat(PreviewFormats.PNG);
previewOptions.setPageNumbers(new int[] { 1, 2, 3, 4 });
previewOptions.setHeight(100);
previewOptions.setWidth(80);

// Generate preview for documents
annotator.getDocument().generatePreview(previewOptions);
```
{{< /tab >}}
{{< /tabs >}}
---

## Generate document page preview

Path: /annotation/net/generate-document-pages-preview/


[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to generate document page previews. To do this, call the [GeneratePreview](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/document/methods/generatepreview) method of the [Document](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/properties/document) class. 

Use the [PreviewOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/previewoptions) class to manage the generation process: specify desired page numbers, image format, etc.

To generate a document preview, follow these steps:
1.  Create an instance of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the source document path as a parameter. The [Document](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/properties/document) property of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class provides access to source document and implements [GeneratePreview](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/document/methods/generatepreview) method.
3.   Instantiate the [PreviewOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/previewoptions) class. Follow these steps:
    a.   for each page, delegate stream creation (see the `CreatePageStream` event handler); 
    b.   specify the image preview format - PNG / JPG / BMP,
    c.   specify page numbers to process;
    d.   set the custom size of preview images (if needed).  
{{< alert style="info" >}} Stream created by the [CreatePageStream](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/createpagestream) delegate are disposed automatically once after generation of preview image. To implement the custom image preview stream disposing, you have to specify an additional argument [ReleasePageStream](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/releasepagestream) to clean up resources.
{{< /alert >}}       
4.  Call the [GeneratePreview](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/document/methods/generatepreview) method of the [Annotator.Document](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/properties/document) class. Specify [PreviewOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/previewoptions).

    
The [PreviewOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/previewoptions) class main properties are as follows:
*   [CreatePageStream](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/createpagestream) is a delegate which defines the method to create output page preview stream.
*   [ReleasePageStream](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/releasepagestream) is a delegate which defines the method to remove output page preview stream. Use it for advanced control for resources handling.
*   [Width](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/width) specifies the preview image width.
*   [Height](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/height) specifies the preview image height.
*   [PageNumbers](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/pagenumbers) - Page numbers that will be previewed;
*   [PreviewFormat](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/previewformat) gets or sets the preview image format. Use the BMP format should be used for the best image quality. Use the JPG format in case of strict requirements to image size, but with lower quality than BMP. By default GroupDocs.Annotation uses the PNG format which is a golden mean between image quality and size.
*   [RenderComments](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/rendercomments) is an option to show or hide comments. By default it is `true`. Set it to `false` if you do not need to show comments. This property affects only on WordProcessing documents. The `RenderComments` value impacts any document comments.
*   [RenderAnnotations](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/renderannotations) is an option to show or hide annotations.By default it is `true`. Set it to `false` if you do not need to show annotations.
*   [WorksheetColumns](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/worksheetcolumns) is a list of the [WorksheetColumnsRange](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/worksheetcolumnsrange) objects that indicates which columns to generate on specified worksheet.

The following code snippet demonstrates how to generate document previews:

## Get document page previews 

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = $"D:/result_{pageNumber}.png";
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2, 3, 4 };
    annotator.Document.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Set specific size for preview images

You can set a specific size for preview images. For example, you can create small-sized thumbnails and full-sized previews.

The following code snippet shows how to set specific size for preview images:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = $"D:/result_{pageNumber}.png";
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2, 3, 4 };
	previewOptions.Height = 100;
    previewOptions.Width = 80;
    annotator.Document.GeneratePreview(previewOptions);   
}

```
{{< /tab >}}
{{< /tabs >}}

## Get page previews with manual resource cleaning

By default, GroupDocs.Annotation deletes the image stream immediately after creating and rendering the document page. If necessary, you can implement a custom method to perform this operation.

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
// Method should match with ReleasePageStream delegate signature
private void UserReleaseStreamMethod(int pageNumber, Stream stream)
{
	Console.WriteLine($"Releasing memory for page: {pageNumber}");
    stream.Close();
}
 
using (Annotator annotator = new Annotator("input.pdf"))
{
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = $"D:/result_{pageNumber}.png";
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2, 3, 4 };
	previewOptions.Height = 100;
    previewOptions.Width = 80;
 
    // here we set delegate target method
    previewOptions.ReleasePageStream = UserReleaseStreamMethod;
    annotator.Document.GeneratePreview(previewOptions);   
}
```
{{< /tab >}}
{{< /tabs >}}

## Show and hide replies for WordsProcessing documents

Use the boolean [RenderComments](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/rendercomments/) property to show comments when rendering image preview.

{{< alert style="info" >}}This feature is supported for WordProcessign documents only.{{< /alert >}}

The default value of the property is `true`. To hide comments, set it to `false`. This property applies to all comments.

The following code snippet shows how to render an image preview without comments:

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
Annotator annotator = new Annotator(File.OpenRead(MakeStoragePath(inputPath)));
           PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
           {
               var pagePath = MakeStoragePath(inputPath.Replace("input.doc", $"result{pageNumber}.png"));
               return File.Create(pagePath);
           });
previewOptions.PreviewFormat = PreviewFormats.PNG;
previewOptions.RenderComments = false;
annotator.Document.GeneratePreview(previewOptions);
```
{{< /tab >}}
{{< /tabs >}}

## Generate cells preview with specified columns

GroupDocs.Annotation v20.11 and later allows you to specify the columns you want to generate on the sheet you selected. To do this, use the [WorksheetColumns](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/worksheetcolumns) property.

{{< alert style="info" >}}This feature is supported for CellsProcessign documents only.{{< /alert >}}

The following code snippet shows how to set the list of columns to render:

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
PreviewOptions previewOptions =
    new PreviewOptions(pageNumber => new FileStream($"preview_pages/page{pageNumber}.png", FileMode.Create),
        (number, stream) => stream.Dispose());
previewOptions.WorksheetColumns.Add(new WorksheetColumnsRange("Sheet1", 2, 3));
previewOptions.WorksheetColumns.Add(new WorksheetColumnsRange("Sheet1", 1, 1));

using (Annotator annotator = new Annotator("input.xlsx"))
{
    annotator.Document.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Original worksheet
![](/annotation/net/images/original_page.png)
### Generated image file
![](/annotation/net/images/generated_page.png)
---

## Generating Report using Multiple Data Sources in Presentation Document

Path: /assembly/java/generating-report-using-multiple-data-sources-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a report. This report will fetch data from multiple data sources.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Generating Report in Microsoft PowerPoint Document

### Creating a Template

1.  Add a bullet list at the place where you want it to display clients' names.
2.  Insert a table with two columns, that will show managers' and their contact prices.
3.  Save your Document

### Reporting Requirement

As a report developer, you are required to generate a report that fetches data from two different data sources (e:g custom object, excel data table). Report must show following information:

*   Bulleted list of clients
*   A table showing managers' along with their contract prices and sum of contract prices

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**We provide support for the following clients:**

   • **<<foreach \[in getClients()\]>><<\[getName()\]>>**

**Total Contract Prices by Managers**

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Manager</b></td>
			<td style="background-color: #5B9BD5"><b>Total Contract Price</b></td>
		</tr>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;foreach [group in contracts<br />    .groupBy(c => c.Manager)<br />    .orderBy(g => g.key)]>><br />&lt;&lt;[group.key]>></b></td>
			<td style="background-color: #D2DEEF"><b>&lt;&lt;[group.sum(<br />    c => c.Contract_Price)]>><br />&lt;&lt;/foreach>></b></td>
		</tr>
	</tbody>
</table>

### Download Template

Get the template from here:

*   [Multiple DS.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Multiple%20DS.pptx?raw=true)

### Generating the Report

{{< gist GroupDocsGists 3ab9d5c532752f52d597b6cb5fb39ed9 >}}



---

## Generating Report using Multiple Data Sources in Presentation Document

Path: /assembly/net/generating-report-using-multiple-data-sources-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a report. This report will fetch data from multiple data sources.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Generating Report in Microsoft PowerPoint Document

### Creating a Template

1.  Add a new slide
2.  Add a bullet list at the place where you want it
3.  Save your Document

## Reporting Requirement

As a report developer, you are required to generate a report that fetches data from two different data sources (e:g XML, JSON). Report must show following information:

*   Customer name
*   List of products

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}There is no way to use an image inside a foreach tag in Microsoft PowerPoint.{{< /alert >}}

**NOTE: There is no way to use images inside a foreach tag in PowerPoint.**

<<foreach \[in customers\]>>**<<\[CustomerName\]>>**

<</foreach\>>

```csharp
We provide support for the following products:
<<foreach [in products]>><<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Get the template from here.

*   [Multiple DS.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Multiple%20DS.pptx?raw=true)

### Generating the Report

{{< gist GroupDocsGists d9bf0942465e757e9db871545d904459 >}}

## Generating Report in OpenOffice Presentation Document

### Creating the Template

OpenDocument Text (ODT) is a word processing document format which can be used as an alternative to Microsoft Word Document (DOC/DOCX) formats. Since ODT is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODT, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating a report in ODT format. Instead, we'll save the existing template to ODT format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

Get template from here.

*   [Multiple DS.odp](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Multiple%20DS.odp?raw=true)

### Generating the Report

{{< gist GroupDocsGists 296b38df6d5eb9a8c31fded8617b9739 >}}



---

## Get default load options for a source format

Path: /conversion/net/get-default-load-options-for-source-format/

**[GroupDocs.Conversion](https://products.groupdocs.com/conversion/net)** allows you to get default load options for the source document format. This will allow you to get default load options runtime, knowing the source format.

To get default options, follow these steps:

1.   Call the static [GetPossibleConversion](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/getpossibleconversions/) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class with source file extension as a parameter.
2.   From received possible conversion read the [LoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/possibleconversions/loadoptions) property.
3.   Create an instance of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class and pass source document path as a constructor parameter and load options from the previous step.
4.   Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) class e.g. (**[PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions)** etc.).
5.   Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class instance and pass filename for the converted document and the instance of [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) from the previous step.

The following code snippet shows how to get default load options for a Word processing document:

```csharp
var possibleConversions = Converter.GetPossibleConversions("docx");
var loadOptions = (WordProcessingLoadOptions) possibleConversions.LoadOptions;
loadOptions.Password = "12345";

using (Converter converter = new Converter("password_protected.docx", (LoadContext loadContext) => loadOptions))
{
    var convertOptions = new PdfConvertOptions();
    converter.Convert(outputFile, convertOptions);
}
```

---

## Get document page preview

Path: /redaction/java/get-document-page-preview/


In GroupDocs.Redaction, *Redactor* class supports rendering of the document preview in on of these image formats:

*   JPEG Image
*   Portable Network Graphics
*   Bitmap Image File

The following example demonstrates how to get a single page preview of the document.

```java
// Test file
final String testFile = "D:\\sample.pdf";
// Take preview of the first page
int testPageNumber = 1;
// Preview file name
final String previewFileName = String.format("%s_page%d.png", testFile, testPageNumber);
// Load the document to generate preview
final Redactor redactor = new Redactor(testFile);
try 
{
    PreviewOptions options = new PreviewOptions(new ICreatePageStream() { 
        @Override
        public java.io.OutputStream createPageStream(int pageNumber) { 
            try {
                return new java.io.FileOutputStream(previewFileName); 
            } catch (java.io.FileNotFoundException ex) {
                System.out.printf("Failed to create preview file %s: \"%s\"\n\n", previewFileName, ex.toString());
                return null;
            }
        } 
    });
    options.setHeight(640);
    options.setWidth(480);
    options.setPageNumbers(new int[] { testPageNumber });
    options.setPreviewFormat(PreviewFormats.Png);
    redactor.generatePreview(options);            
    System.out.printf("\nPreview for page %d  was saved to \"%s\"\n\n", testPageNumber, previewFileName);
}
finally { redactor.close(); }
```

---

## Get document page preview

Path: /redaction/net/get-document-page-preview/


In GroupDocs.Redaction, [Redactor](https://reference.groupdocs.com/redaction/net/groupdocs.redaction/redactor) class supports rendering of the document preview in on of these image formats:

*   JPEG Image
*   Portable Network Graphics (PNG)
*   Bitmap Image File (BMP)

The following example demonstrates how to get a single page preview of the document.

```csharp
// Take preview of the first page
int testPageNumber = 1;
// Preview file name
string previewFileName = string.Format("{0}_page{1}.png", "D:\\sample.docx", testPageNumber);
// Load the document to generate preview
using (Redactor redactor = new Redactor("D:\\sample.docx"))
{
    PreviewOptions options = new PreviewOptions(delegate(int pageNumber) 
    { 
        return File.OpenWrite(previewFileName); 
    });
    options.Width = 480;
    options.Height = 640;
    options.PageNumbers = new int[] { testPageNumber };
    options.PreviewFormat = PreviewOptions.PreviewFormats.PNG;
    redactor.GeneratePreview(options);
    Console.WriteLine("\nPreview for page {0} was saved to \"{1}\"", testPageNumber, previewFileName);
}
```

---

## Get supported features

Path: /parser/java/get-supported-features/

The set of the supported features depends on the document format. GroupDocs.Parser provides the functionality to check if feature supported for the document. [getFeatures](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFeatures()) property is used for this purposes.

[Features](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features) class has the following members:

| Member | Description |
| --- | --- |
| [isFeatureSupported(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isFeatureSupported(java.lang.String)) | Returns the value that indicates whether the **feature** is supported. |
| [isText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isText()) | The value that indicates whether **text extraction** is supported. |
| [isTextPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isTextPage()) | The value that indicates whether **text page** extraction is supported. |
| [isFormattedText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isFormattedText()) | The value that indicates whether **formatted text** extraction is supported. |
| [isFormattedTextPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isFormattedTextPage()) | The value that indicates whether **formatted text page** extraction is supported. |
| [isSearch](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isSearch()) | The value that indicates whether **text search** is supported. |
| [isHighlight](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isHighlight()) | The value that indicates whether **highlight extraction** is supported. |
| [isStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isStructure()) | The value that indicates whether **text structure extraction** is supported. |
| [isToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isToc()) | The value that indicates whether **table of contents extraction** is supported. |
| [isContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isContainer()) | The value that indicates whether **container extraction** is supported. |
| [isMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isMetadata()) | The value that indicates whether **metadata extraction** is supported. |
| [isTextAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isTextAreas()) | The value that indicates whether **text areas extraction** is supported. |
| [isImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isImages()) | The value that indicates whether **images extraction** is supported. |
| [isParseByTemplate](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isParseByTemplate()) | The value that indicates whether **parsing by template** is supported. |
| [isParseForm](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isParseForm()) | The value that indicates whether **form parsing** is supported. |

Here are the steps for check if feature is supported:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call corresponding property of [getFeatures](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFeatures()) property to check if the feature is supported.

The following example shows how to check if text extraction feature is supported:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleZip)) {
    // Check if text extraction is supported for the document
    if (!parser.getFeatures().isText()) {
        System.out.println("Text extraction isn't supported");
        return;
    }
    // Extract a text from the document
    try (TextReader reader = parser.getText()) {
        System.out.println(reader.readToEnd());
    }
}
```

If the feature isn't supported, the method returns *null* instead of the value. So if checking of [Features](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features) properties is omitted, result is checked for *null*:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleZip)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
}
```

This example prints "Text extraction isn't supported" because there is no text in zip-archive.

Some operations may consume significant time. So it's not optimal to call the method to just check the support for the feature. For this purpose [getFeatures](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFeatures()) property is used.

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Get supported features

Path: /parser/net/get-supported-features/

The set of the supported features depends on the document format. GroupDocs.Parser provides the functionality to check if feature supported for the document. [Features](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/properties/features) property is used for this purposes.

[Features](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features) class has the following members:

| Member | Description |
| --- | --- |
| bool [IsFeatureSupported(string featureName)](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/methods/isfeaturesupported) | Returns the value that indicates whether the **feature** is supported. |
| [Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/text) | The value that indicates whether **text extraction** is supported. |
| [TextPage](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/textpage) | The value that indicates whether **text page** extraction is supported. |
| [FormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/formattedtext) | The value that indicates whether **formatted text** extraction is supported. |
| [FormattedTextPage](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/formattedtextpage) | The value that indicates whether **formatted text page** extraction is supported. |
| [Search](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/search) | The value that indicates whether **text search** is supported. |
| [Highlight](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/highlight) | The value that indicates whether **highlight extraction** is supported. |
| [Structure](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/structure) | The value that indicates whether **text structure extraction** is supported. |
| [Toc](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/toc) | The value that indicates whether **table of contents extraction** is supported. |
| [Container](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/container) | The value that indicates whether **container extraction** is supported. |
| [Metadata](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/metadata) | The value that indicates whether **metadata extraction** is supported. |
| [TextAreas](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/textareas) | The value that indicates whether **text areas extraction** is supported. |
| [Images](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/images) | The value that indicates whether **images extraction** is supported. |
| [ParseByTemplate](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/parsebytemplate) | The value that indicates whether **parsing by template** is supported. |
| [ParseForm](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/parseform) | The value that indicates whether **form parsing** is supported. |

Here are the steps for check if feature is supported:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call corresponding property of [Feature](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/properties/features) property to check if the feature is supported.

The following example shows how to check if text extraction feature is supported:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser("doc.zip"))
{
    // Check if text extraction is supported for the document
    if(!parser.Features.Text)
    {
        Console.WriteLine("Text extraction isn't supported");
        return;
    }

    // Extract a text from the document
    using(TextReader reader = parser.GetText())
    {
        Console.WriteLine(reader.ReadToEnd());
    }
}
```

If the feature isn't supported, the method returns null instead of the value. So if checking of [Features](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/properties/features) properties is omitted, result is checked for *null*:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser("doc.zip"))
{
    // Extract a text from the document 
    using(TextReader reader = parser.GetText())
    {
        // Check if reader isn't null
        if(reader == null)
        {
            Console.WriteLine("Text extraction isn't supported");
        }
        else
        {
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}

```

This example prints "Text extraction isn't supported" because there is no text in zip-archive.

Some operations may consume significant time. So it's not optimal to call the method to just check the support for the feature. For this purpose [Features](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/properties/features) property is used.

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## GroupDocs.Assembly Engine APIs

Path: /assembly/java/groupdocs-assembly-engine-apis/

{{< alert style="info" >}}In this article, we will discuss the behavior of GroupDocs.Assembly APIs.{{< /alert >}}

## Overview of the API

Classes of GroupDocs.Assembly are located within the GroupDocs.Assembly namespace. The main of the classes is [DocumentAssembler](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/DocumentAssembler). All the functionality required to build a report from a template is assembled within the class.

### Building Reports

To build a report from a template, you can use one of the [com.groupdocs.assembly.DocumentAssembler](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/DocumentAssembler) overloads. The following table describes parameters of these overloads.

| Parameter | Description |
| --- | --- |
| document | A template document. At runtime, this document instance is populated with a data from the specified source and becomes a ready report. |
| dataSource | An object providing a data to populate the specified template. The object must be of one of the following types:<br\><ul><li>A traditional mail merge data source (see "Working with Traditional Mail Merge Data Sources" for more information)</li><li>An object of a custom visible type (see "Working with Types" for more information)</li></ul> |
| dataSourceName | The identifier of the specified data source object within the specified template. You can omit this identifier, if the template uses the [contextual object member access](https://docs.groupdocs.com/display/assemblynet/Template+Syntax+-+Part+1+of+2#TemplateSyntax-Part1of2-UsingContextualObjectMemberAccess) when dealing with the data source. |

Given a template to be populated with a data from a [DataSet](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataSet) instance that is identified as "ds" within the template, you can use the following code to build the corresponding report.

```java
//Setting up source document template
const String strDocumentTemplate = "Template Folder/wordTemplate.docx";
//Setting up destination document report
const String strDocumentReport = "Report Folder/wordReport.docx";
// Setting up a data set.
DataSet ds = ........

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(strDocumentTemplate, strDocumentReport, new DataSourceInfo(ds, "ds"));
```

Given a visible `Person` class defined in your application and a template to be populated with a data about a single Person instance using the contextual object member access, you can use the following code to build the corresponding report.

```java
//Setting up source document template
const String strDocumentTemplate = "Template Folder/wordTemplate.docx";
//Setting up destination document report
const String strDocumentReport = "Report Folder/wordReport.docx";
// Setting up a person data
Person person = ........

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(strDocumentTemplate, strDocumentReport, new DataSourceInfo(person, "PersonDS"));
```

### Accessing XML Data

To access XML data while building a report, you can use facilities of `DataSet` to read XML into it and then pass it to the engine as a data source. However, if your scenario does not permit to specify XML schema while loading XML into `DataSet`, all attributes and text values of XML elements are loaded as strings then. Thus, it becomes impossible, for example, to use arithmetic operations on numbers or to specify custom date-time and numeric formats to output corresponding values, because all of them are treated as strings.

To overcome this limitation, you can pass an `XmlDataSource` instance to the engine as a data source instead. Even when XML schema is not provided, `XmlDataSource` is capable to recognize values of the following types by their string representations:

- Long
- Double
- Boolean
- Date

**Note –** For recognition of data types to work, string representations of corresponding attributes and text values of XML elements must be formed using invariant culture settings.

While loading data to `XmlDataSource`, the engine performs actions typical for XML deserialization behind the scenes: It maps complex-type XML elements to internal objects and simple-type XML elements to fields of containing objects. So, in template documents, an `XmlDataSource` instance should be treated as an object having corresponding fields and nested objects as shown in the following example.

XML

```
<Person>
   <Name>John Doe</Name>
   <Age>30</Age>
   <Birth>1989-04-01 4:00:00 pm</Birth>
   <Child>Ann Doe</Child>
   <Child>Charles Doe</Child>
</Person>
```

Template document

```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
Children:
<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

Source code

```
XmlDataSource dataSource = ... // Loading XML.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Children:
Ann Doe
Charles Doe
```

**Note –** To reference a sequence of repeated simple-type XML elements with the same name, the elements’ name itself (for example, “Child”) should be used in a template document, whereas the same name with the “_Text” suffix (for example, “Child_Text”) should be used to reference the text value of one of these elements.

By default, if a root XML element contains only a sequence of elements of one type, the engine does not generate an internal root object while loading XML data. So, in template documents, such an `XmlDataSource` instance should be treated as a sequence of corresponding nested objects as shown in the following example.

XML

```
<Persons>
   <Person>
       <Name>John Doe</Name>
       <Age>30</Age>
       <Birth>1989-04-01 4:00:00 pm</Birth>
   </Person>
   <Person>
       <Name>Jane Doe</Name>
       <Age>27</Age>
       <Birth>1992-01-31 07:00:00 am</Birth>
   </Person>
   <Person>
       <Name>John Smith</Name>
       <Age>51</Age>
       <Birth>1968-03-08 1:00:00 pm</Birth>
   </Person>
</Persons>
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Age)]>>
```

Source code

```
XmlDataSource dataSource = ... // Loading XML.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

However, if your scenario requires an internal object for a root XML element to be always generated while loading data to `XmlDataSource`, you can force this as shown in the following code snippet.

```
XmlDataLoadOptions options = new XmlDataLoadOptions();
options.setAlwaysGenerateRootObject(true);
XmlDataSource dataSource = new XmlDataSource(..., options);
```

The following example sums up typical scenarios involving nested complex-type XML elements.

XML

```
<Managers>
   <Manager>
       <Name>John Smith</Name>
       <Contract>
           <Client>
               <Name>A Company</Name>
           </Client>
           <Price>1200000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>B Ltd.</Name>
           </Client>
           <Price>750000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>C &amp; D</Name>
           </Client>
           <Price>350000</Price>
       </Contract>
   </Manager>
   <Manager>
       <Name>Tony Anderson</Name>
       <Contract>
           <Client>
               <Name>E Corp.</Name>
           </Client>
           <Price>650000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>F &amp; Partners</Name>
           </Client>
           <Price>550000</Price>
       </Contract>
   </Manager>
   <Manager>
       <Name>July James</Name>
       <Contract>
           <Client>
               <Name>G &amp; Co.</Name>
           </Client>
           <Price>350000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>H Group</Name>
           </Client>
           <Price>250000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>I &amp; Sons</Name>
           </Client>
           <Price>100000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>J Ent.</Name>
           </Client>
           <Price>100000</Price>
       </Contract>
   </Manager>
</Managers>
```

Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

Source code

```
XmlDataSource dataSource = ... // Loading XML.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource, "managers"));
```

Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000) 

Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000) 

Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000) 
```

### Accessing JSON Data

To access JSON data while building a report, you can pass a `JsonDataSource` instance to the engine as a data source.

Using of `JsonDataSource` enables you to work with typed values of JSON elements in template documents. For more convenience, the set of simple JSON types is extended as follows:

- Long
- Double
- Boolean
- Date
- String

**Note –** Working with complex JSON types (objects and arrays) is also supported.

While loading data to `JsonDataSource`, the engine performs JSON deserialization and generates corresponding internal objects. So, in template documents, a `JsonDataSource` instance should be treated according to what a root JSON element represents.

If a root JSON element is an object, a `JsonDataSource` instance should be treated as an object as well as shown in the following example.


JSON

```
{
   Name: "John Doe",
   Age: 30,
   Birth: "1989-04-01 4:00:00 pm",
   Child: [ "Ann Doe", "Charles Doe" ]
}
```

Template document

```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
Children:
<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

Source code

```
JsonDataSource dataSource = ... // Loading JSON.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Children:
Ann Doe
Charles Doe
```

**Note –** To reference a JSON object property that is an array of simple-type values, the name of the property (for example, “Child”) should be used in a template document, whereas the same name with the “_Text” suffix (for example, “Child_Text”) should be used to reference the value of an item of this array.

If a root JSON element is an array, a `JsonDataSource` instance should be treated as a sequence of items of this array as shown in the following example.

JSON

```
[
   {
       Name: "John Doe",
       Age: 30,
       Birth: "1989-04-01 4:00:00 pm"
   },
   {
       Name: "Jane Doe",
       Age: 27,
       Birth: "1992-01-31 07:00:00 am"
   },
   {
       Name: "John Smith",
       Age: 51,
       Birth: "1968-03-08 1:00:00 pm"
   }
]
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Age)]>>
```

Source code

```
JsonDataSource dataSource = ... // Loading JSON.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

By default, if a root JSON element is an object having only one property that is an object or array in turn, the engine does not generate an internal root object while loading JSON data. So, in template documents, such a `JsonDataSource` instance should be treated according to what this property represents instead. For instance, the following JSON snippets can be used to produce the same results in previous examples of this section respectively.

JSON 1

```
{
   Person:
   {
       Name: "John Doe",
       Age: 30,
       Birth: "1989-04-01 4:00:00 pm",
       Child: [ "Ann Doe", "Charles Doe" ]
   }
}
```

JSON 2

```
{
   Persons:
   [
       {
           Name: "John Doe",
           Age: 30,
           Birth: "1989-04-01 4:00:00 pm"
       },
       {
           Name: "Jane Doe",
           Age: 27,
           Birth: "1992-01-31 07:00:00 am"
       },
       {
           Name: "John Smith",
           Age: 51,
           Birth: "1968-03-08 1:00:00 pm"
       }
   ]
}
```

However, if your scenario requires an internal object for a root JSON element to be always generated while loading data to `JsonDataSource`, you can force this as shown in the following code snippet.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.setAlwaysGenerateRootObject(true);
JsonDataSource dataSource = new JsonDataSource(..., options);
```

The following example sums up typical scenarios involving nested JSON objects and arrays.

JSON

```
[
   {
       Name: "John Smith",
       Contract:
       [
           {
               Client:
               {
                   Name: "A Company"
               },
               Price: 1200000
           },
           {
               Client:
               {
                   Name: "B Ltd."
               },
               Price: 750000
           },
           {
               Client:
               {
                   Name: "C & D"
               },
               Price: 350000
           }
       ]
   },
   {
       Name: "Tony Anderson",
       Contract:
       [
           {
               Client:
               {
                   Name: "E Corp."
               },
               Price: 650000
           },
           {
               Client:
               {
                   Name: "F & Partners"
               },
               Price: 550000
           }
       ]
   },
   {
       Name: "July James",
       Contract:
       [
           {
               Client:
               {
                   Name: "G & Co."
               },
               Price: 350000
           },
           {
               Client:
               {
                   Name: "H Group"
               },
               Price: 250000
           },
           {
               Client:
               {
                   Name: "I & Sons"
               },
               Price: 100000
           },
           {
               Client:
               {
                   Name: "J Ent."
               },
               Price: 100000
           }
       ]
   }
]
```

Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

Source code

```
JsonDataSource dataSource = ... // Loading JSON.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource, "managers"));
```

Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)

Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)

Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

For recognition of JSON simple values (null, boolean, number, integer, and string), the engine provides two modes: *loose* and *strict*. In the loose mode, types of JSON simple values are determined upon parsing of their string representations. In the strict mode, types of JSON simple values are determined from JSON notation itself. To see the main difference between the modes, consider the following JSON snippet.

```
{ prop: "123" }
```

In the loose mode, the type of `prop` is determined as integer, whereas in the strict mode, it is determined as string.

The loose mode is used by the engine by default to support more typed data representation options. However, in some scenarios, it can be more preferable to disable recognition of numbers and other JSON simple values from strings, for example, when you need to keep leading padding zeros in a string value representing a number. In this case, you can switch to the strict mode as shown in following code snippet.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.setSimpleValueParseMode(JsonSimpleValueParseMode.STRICT);
JsonDataSource dataSource = new JsonDataSource(..., options);
```

**Note –** Parsing of date-time values does not depend on whether the loose or strict mode is used.

Recognition of date-time values is a special case, because [JSON specification](https://www.json.org) does not define a format for their representation. So, by default, while parsing date-time values from strings, the engine tries several formats in the following order:

- [The ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601) (for values like "2015-03-02T13:56:04Z")
- [The Microsoft® JSON date-time format](https://docs.microsoft.com/en-us/previous-versions/dotnet/articles/bb299886(v=msdn.10)#from-javascript-literals-to-json) (for values like "/Date(1224043200000)/")
- All date-time formats supported for the current culture
- All date-time formats supported for the English USA culture
- All date-time formats supported for the English New Zealand culture

Although this approach is quite flexible, in some scenarios, you may need to restrict strings to be recognized as date-time values. You can achieve this by specifying one or several exact formats in the context of the current culture to be used while parsing date-time values from strings as shown in the following example.

```
ArrayList<String> formats = new ArrayList();
formats.add("MM/dd/yyyy");

JsonDataLoadOptions options = new JsonDataLoadOptions();
options.setExactDateTimeParseFormats(formats);
JsonDataSource dataSource = new JsonDataSource(..., options);
```

In this example, strings conforming the format "MM/dd/yyyy" are going to be recognized as date-time values while loading JSON, whereas the others are not (but see the following note).

In some scenarios, you may need to disable recognition of date-time values at all, for example, when you deal with strings containing already formatted date-time values, which you do not want to re-format using the engine. You can achieve this by setting the exact date-time parse formats to an empty list (but see the following note).

**Note –** Strings conforming the Microsoft® JSON date-time format (for example, "/Date(1224043200000)/") are always recognized as date-time values regardless of the exact date-time parse formats.

### Accessing CSV Data

To access CSV data while building a report, you can pass a `CsvDataSource` instance to the engine as a data source.

Using of `CsvDataSource` enables you to work with typed values rather than just strings in template documents. Although CSV as a format does not define a way to store values of types other than strings, `CsvDataSource` is capable to recognize values of the following types by their string representations:

- Long
- Double
- Boolean
- Date

**Note –** For recognition of data types to work, string representations of corresponding values must be formed using invariant culture settings.

In template documents, a `CsvDataSource` instance should be treated as a sequence of objects having corresponding fields as shown in the following example.

CSV

```
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

Template document

```
<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Column2)]>>
```

Source code

```
CsvDataSource dataSource = ... // Loading CSV.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

By default, `CsvDataSource` uses column names such as “Column1”, “Column2”, and so on, as you can see from the previous example. However, `CsvDataSource` can be configured to read column names from the first line of CSV data as shown in the following example.

CSV

```
Name,Age,Birth
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Age)]>>
```

Source code

```
CsvDataLoadOptions options = new CsvDataLoadOptions(true);
CsvDataSource dataSource = new CsvDataSource(..., options); // Loading CSV.

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

Also, you can use `CsvDataLoadOptions` to customize the following characters playing special roles while loading CSV data:

- Value separator (the default is comma)
- Single-line comment start (the default is sharp)
- Quotation mark enabling to use other special characters within a value (the default is double quotes)

### Setting up Known External Types

GroupDocs.Assembly Engine must be aware of custom external types that you reference in your template before the engine processes the template. You can set up external types known by the engine through the [DocumentAssembler.getKnownTypes()](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/DocumentAssembler#getKnownTypes--) property. The property represents an unordered set (that is, a collection of unique items) of [Class](http://docs.oracle.com/javase/7/docs/api/java/lang/Class.html) objects. Every type in the set must meet requirements declared at [Working with Types](https://docs.groupdocs.com/display/assemblynet/Template+Syntax+-+Part+1+of+2#TemplateSyntax-Part1of2-UsingTypes).

**Note:** Aliases of simple types like int, string, and others are known by the engine by default.

Consider the following example. Given an ImageUtil class declared at your application and a template accessing a static member of this class, you can use the following code to make the engine be aware of the class before processing the template.

```java
DocumentAssembler assembler = new DocumentAssembler;
assembler.knownTypes.add(typeof(ImageUtil));
assembler.assembleDocument(...);
```

### Accessing Missing Members of Data Objects

By default, GroupDocs.Assembly forbids access to missing members of data objects used to build a report in template expressions, since such access is forbidden by C# Language Specification 5.0. On attempt to use a missing member of a data object, the assembler throws an exception then.

But in some scenarios, members of data objects are not exactly known while designing a template. For example, if using a `DataSet` instance loaded from XML without its schema defined, some of expected data members can be missing.

To support such scenarios, the assembler provides an option to treat missing members of data objects as null literals. You can enable the option as shown in the following example.

```java
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.ALLOW_MISSING_MEMBERS);
assembler.assembleDocument(...);
```

Consider the following example. Given that `r` is a `DataRow` instance that does not have a field `Missing`, by default, the following template expression causes the assembler to throw an exception while building a report.

```java
<<[r.Missing]>>
```

However, if `DocumentAssemblyOptions.ALLOW_MISSING_MEMBERS` is applied, the assembler treats access to such a field as a null literal, so no exception is thrown and simply no value is written to the report then.

### Optimizing Reflection Calls

GroupDocs.Assembly Engine uses reflection calls while accessing members of custom external types. However, reflection calls are much slower than direct calls, which creates a performance overhead.

Due to the performance overhead, the engine provides a strategy minimizing the reflection usage. The strategy is based upon the runtime type generation. That is, the engine generates a proxy type per an external type. The proxy directly calls members of the corresponding external type, the engine to access these members in a uniform way with no reflection involved. The proxy is [lazily initialized](http://en.wikipedia.org/wiki/Lazy_initialization) and reused in further. Thus, the reflection is used only while building the proxy.

Although this strategy can significantly minimize the reflection usage in a long run, it creates a performance overhead of the runtime type generation. So, if you deal with small data collections all the time while building your reports, consider the disabling of the strategy.

You can control the enabling of the strategy through the [DocumentAssembler.setUseReflectionOptimization](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly/DocumentAssembler#setUseReflectionOptimization-boolean-) static property. By default, the strategy is enabled.

### Integrating with Native Spreadsheet Data Types

By default, GroupDocs.Assembly outputs expression results as string values regardless of expression types. In most scenarios, this is the best option, since expression results can be formatted through template syntax depending on expression types. However, for Spreadsheet documents, this may interfere calculation of formulas expecting values of types other than string. To overcome this, GroupDocs.Assembly provides integration with native Spreadsheet data types, which can be enabled as shown in the following code snippet.

```java
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.USE_SPREADSHEET_DATA_TYPES);

assembler.assembleDocument(...);
```

Let us show how it works by using an example. Let `number` be a numeric value. Then, consider the following template for a Spreadsheet cell.

```java
<<[number]>>
```

By default, while assembling a document, GroupDocs.Assembly converts `number` into a string using built-in Java routines. However, when integration with native Spreadsheet data types is enabled, the cell’s value is written as a number, thus enabling to use it in Spreadsheet formulas expecting numbers. 

Integration with native Spreadsheet data types also affects formatting of the cell’s value: If a numeric format is defined for the cell (for example, using “Format Cells” context menu in Microsoft Excel), then the format is applied; otherwise, a default numeric format for cells is applied.

**Note –** The same applies to other native Spreadsheet data types such as date-time and Boolean.

The following table describes, in which cases integration with native Spreadsheet data types has no effect even when enabled.

| Cell Template Syntax Example    | Explanation                                                  |
| ------------------------------- | ------------------------------------------------------------ |
| `<<[number]:ordinal>>`            | If an expression result is formatted using template syntax, it is written as a string. |
| `Some text <<[number]>>`          | Presence of text other than template syntax makes a result cell value to become a string. |
| `<<[number]>><<[anotherNumber]>>` | Results of multiple expressions in a single cell are converted to strings and concatenated. |

## Technical Considerations

Here, we will reveal some technical aspects and implementation details related to the GroupDocs.Assembly Engine which can be useful for you while making design decisions for your applications.

### Implicit Enumeration Determination

If you do not specify the type of an enumeration item in a `foreach` statement or lambda function signature within your template explicitly, the type is implicitly determined by the engine from the type of the enumeration as follows:

1.  If the enumeration represents a [DataTable](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataTable) instance, then the item represents its row.
2.  Otherwise, if the enumeration represents child rows of a DataTable row, then the item represents a child row.
3.  Otherwise, if the enumeration implements generic Iterable<T>, then the item type is a type argument corresponding to T. Note, that in some cases it is impossible to extract type arguments at runtime due to the Java [Type Erasure](http://docs.oracle.com/javase/tutorial/java/generics/erasure.html) feature. That is why, the engine is capable to extract the item type only if one of the following conditions is met:
  
    *   The enumeration expression represents an invocation of a type member which return type is a parameterized type like Iterable<String>, ArrayList<Integer>, and so forth.
    *   The type of the enumeration implements or extends a parameterized type like Iterable<String>, ArrayList<Integer>, and so forth.
4.  Otherwise, the item type is Object.

---

## GroupDocs.Assembly Engine APIs

Path: /assembly/net/groupdocs-assembly-engine-apis/

{{< alert style="info" >}}In this article, we will discuss the behavior of GroupDocs.Assembly APIs.{{< /alert >}}

## Overview of the API

Classes of GroupDocs.Assembly are located within the GroupDocs.Assembly namespace. The main of the classes is DocumentAssembler. All the functionality required to build a report from a template is assembled within the class.

### Building Reports

To build a report from a template, you can use one of the `DocumentAssembler.AssembleDocument` overloads. The following table describes parameters of these overloads.

| Parameter | Description |
| --- | --- |
| document | A template document. At runtime, this document instance is populated with a data from the specified source and becomes a ready report. |
| dataSource | An object providing a data to populate the specified template. The object must be of one of the following types:<ul><li>`JsonDataSource`</li><li>`XmlDataSource`</li><li>`CsvDataSource`</li><li>`DataSet`</li><li>`DataTable`</li><li>`DataRow`</li><li>`DataView`</li><li>`DataRowView`</li><li>`IDataReader`</li><li>`IDataRecord`</li><li>An object of a custom [visible type](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-types)</li></ul> |
| dataSourceName | The identifier of the specified data source object within the specified template. You can omit this identifier, if the template uses the [contextual object member access](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-contextual-object-member-access) when dealing with the data source. |

Given a template to be populated with a data from a DataSet instance that is identified as "ds" within the template, you can use the following code to build the corresponding report.

```csharp
//Setting up source document template
const String strDocumentTemplate = "Template Folder/wordTemplate.docx";
//Setting up destination document report
const String strDocumentReport = "Report Folder/wordReport.docx";
// Setting up a data set.
DataSet ds = ........

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport, new DataSourceInfo(ds, "ds"));
```

Given a visible `Person` class defined in your application and a template to be populated with a data about a single Person instance using the contextual object member access, you can use the following code to build the corresponding report.

```csharp
//Setting up source document template
const String strDocumentTemplate = "Template Folder/wordTemplate.docx";
//Setting up destination document report
const String strDocumentReport = "Report Folder/wordReport.docx";
// Setting up a person data
Person person = ........

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport, new DataSourceInfo(person, "PersonDS"));
```

### Accessing XML Data

To access XML data while building a report, you can use facilities of `DataSet` to read XML into it and then pass it to the engine as a data source. However, if your scenario does not permit to specify XML schema while loading XML into `DataSet`, all attributes and text values of XML elements are loaded as strings then. Thus, it becomes impossible, for example, to use arithmetic operations on numbers or to specify custom date-time and numeric formats to output corresponding values, because all of them are treated as strings.

To overcome this limitation, you can pass an `XmlDataSource` instance to the engine as a data source instead. Even when XML schema is not provided, `XmlDataSource` is capable to recognize values of the following types by their string representations:

- Int64?
- Double?
- Boolean?
- DateTime?

**Note –** For recognition of data types to work, string representations of corresponding attributes and text values of XML elements must be formed using invariant culture settings.

While loading data to `XmlDataSource`, the engine performs actions typical for XML deserialization behind the scenes: It maps complex-type XML elements to internal objects and simple-type XML elements to fields of containing objects. So, in template documents, an `XmlDataSource` instance should be treated as an object having corresponding fields and nested objects as shown in the following example.

XML
```
<Person>
	<Name>John Doe</Name>
	<Age>30</Age>
	<Birth>1989-04-01 4:00:00 pm</Birth>
	<Child>Ann Doe</Child>
	<Child>Charles Doe</Child>
</Person>
```

Template document

```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth:
<<[Birth]:"dd.MM.yyyy">>

Children:

<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

Source code

```
XmlDataSource dataSource = ... // Loading XML.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989

Children:

Ann Doe
Charles Doe
```

**Note –** To reference a sequence of repeated simple-type XML elements with the same name, the elements’ name itself (for example, “Child”) should be used in a template document, whereas the same name with the “_Text” suffix (for example, “Child_Text”) should be used to reference the text value of one of these elements.

By default, if a root XML element contains only a sequence of elements of one type, the engine does not generate an internal root object while loading XML data. So, in template documents, such an `XmlDataSource` instance should be treated as a sequence of corresponding nested objects as shown in the following example.

XML

```
<Persons>
	<Person>
		<Name>John Doe</Name>
		<Age>30</Age>
		<Birth>1989-04-01 4:00:00 pm</Birth>
	</Person>
	<Person>
		<Name>Jane Doe</Name>
		<Age>27</Age>
		<Birth>1992-01-31 07:00:00 am</Birth>
	</Person>
	<Person>
		<Name>John Smith</Name>
		<Age>51</Age>
		<Birth>1968-03-08 1:00:00 pm</Birth>
	</Person>
</Persons>
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>

Average age: <<[persons.Average(p => p.Age)]>>
```

Source code

```
XmlDataSource dataSource = ... // Loading XML.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

However, if your scenario requires an internal object for a root XML element to be always generated while loading data to `XmlDataSource`, you can force this as shown in the following code snippet.

```
XmlDataLoadOptions options = new XmlDataLoadOptions();
options.AlwaysGenerateRootObject = true;
XmlDataSource dataSource = new XmlDataSource(..., options);
```

The following example sums up typical scenarios involving nested complex-type XML elements.

XML

```
<Managers>
   <Manager>
       <Name>John Smith</Name>
       <Contract>
           <Client>
               <Name>A Company</Name>
           </Client>
           <Price>1200000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>B Ltd.</Name>
           </Client>
           <Price>750000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>C &amp; D</Name>
           </Client>
           <Price>350000</Price>
       </Contract>
   </Manager>
   <Manager>
       <Name>Tony Anderson</Name>
       <Contract>
           <Client>
               <Name>E Corp.</Name>
           </Client>
           <Price>650000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>F &amp; Partners</Name>
           </Client>
           <Price>550000</Price>
       </Contract>
   </Manager>
   <Manager>
       <Name>July James</Name>
       <Contract>
           <Client>
               <Name>G &amp; Co.</Name>
           </Client>
           <Price>350000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>H Group</Name>
           </Client>
           <Price>250000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>I &amp; Sons</Name>
           </Client>
           <Price>100000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>J Ent.</Name>
           </Client>
           <Price>100000</Price>
       </Contract>
   </Manager>
</Managers>
```

Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

Source code

```
XmlDataSource dataSource = ... // Loading XML.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "managers"));
```

Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)

Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)

Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

### Accessing JSON Data

To access JSON data while building a report, you can pass a `JsonDataSource` instance to the engine as a data source.

Using of `JsonDataSource` enables you to work with typed values of JSON elements in template documents. For more convenience, the set of simple JSON types is extended as follows:

- Int64?
- Double?
- Boolean?
- DateTime?
- String

**Note –** Working with complex JSON types (objects and arrays) is also supported.

While loading data to `JsonDataSource`, the engine performs JSON deserialization and generates corresponding internal objects. So, in template documents, a `JsonDataSource` instance should be treated according to what a root JSON element represents.

If a root JSON element is an object, a `JsonDataSource` instance should be treated as an object as well as shown in the following example.

JSON

```
{
   Name: "John Doe",
   Age: 30,
   Birth: "1989-04-01 4:00:00 pm",
   Child: [ "Ann Doe", "Charles Doe" ]
}
```

Template document

```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>

Children:

<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

Source code

```
JsonDataSource dataSource = ... // Loading JSON.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989

Children:

Ann Doe
Charles Doe
```

**Note –** To reference a JSON object property that is an array of simple-type values, the name of the property (for example, “Child”) should be used in a template document, whereas the same name with the “_Text” suffix (for example, “Child_Text”) should be used to reference the value of an item of this array.

If a root JSON element is an array, a `JsonDataSource` instance should be treated as a sequence of items of this array as shown in the following example.

JSON

```
[
   {
       Name: "John Doe",
       Age: 30,
       Birth: "1989-04-01 4:00:00 pm"
   },
   {
       Name: "Jane Doe",
       Age: 27,
       Birth: "1992-01-31 07:00:00 am"
   },
   {
       Name: "John Smith",
       Age: 51,
       Birth: "1968-03-08 1:00:00 pm"
   }
]
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>

Average age: <<[persons.Average(p => p.Age)]>>
```

Source code

```
JsonDataSource dataSource = ... // Loading JSON.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

By default, if a root JSON element is an object having only one property that is an object or array in turn, the engine does not generate an internal root object while loading JSON data. So, in template documents, such a `JsonDataSource` instance should be treated according to what this property represents instead. For instance, the following JSON snippets can be used to produce the same results in previous examples of this section respectively.

JSON1

```
{
   Person:
   {
       Name: "John Doe",
       Age: 30,
       Birth: "1989-04-01 4:00:00 pm",
       Child: [ "Ann Doe", "Charles Doe" ]
   }
}
```

JSON 2

```
{
   Persons:
   [
       {
           Name: "John Doe",
           Age: 30,
           Birth: "1989-04-01 4:00:00 pm"
       },
       {
           Name: "Jane Doe",
           Age: 27,
           Birth: "1992-01-31 07:00:00 am"
       },
       {
           Name: "John Smith",
           Age: 51,
           Birth: "1968-03-08 1:00:00 pm"
       }
   ]
}
```

However, if your scenario requires an internal object for a root JSON element to be always generated while loading data to `JsonDataSource`, you can force this as shown in the following code snippet.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.AlwaysGenerateRootObject = true;
JsonDataSource dataSource = new JsonDataSource(..., options);
```

The following example sums up typical scenarios involving nested JSON objects and arrays.

JSON

```
[
   {
       Name: "John Smith",
       Contract:
       [
           {
               Client:
               {
                   Name: "A Company"
               },
               Price: 1200000
           },
           {
               Client:
               {
                   Name: "B Ltd."
               },
               Price: 750000
           },
           {
               Client:
               {
                   Name: "C & D"
               },
               Price: 350000
           }
       ]
   },
   {
       Name: "Tony Anderson",
       Contract:
       [
           {
               Client:
               {
                   Name: "E Corp."
               },
               Price: 650000
           },
           {
               Client:
               {
                   Name: "F & Partners"
               },
               Price: 550000
           }
       ]
   },
   {
       Name: "July James",
       Contract:
       [
           {
               Client:
               {
                   Name: "G & Co."
               },
               Price: 350000
           },
           {
               Client:
               {
                   Name: "H Group"
               },
               Price: 250000
           },
           {
               Client:
               {
                   Name: "I & Sons"
               },
               Price: 100000
           },
           {
               Client:
               {
                   Name: "J Ent."
               },
               Price: 100000
           }
       ]
   }
]
```

Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

Source code

```
JsonDataSource dataSource = ... // Loading JSON.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "managers"));
```

Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)

Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)

Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

For recognition of JSON simple values (null, boolean, number, integer, and string), the engine provides two modes: *loose* and *strict*. In the loose mode, types of JSON simple values are determined upon parsing of their string representations. In the strict mode, types of JSON simple values are determined from JSON notation itself. To see the main difference between the modes, consider the following JSON snippet.

`{ prop: "123" }`

In the loose mode, the type of `prop` is determined as integer, whereas in the strict mode, it is determined as string.

The loose mode is used by the engine by default to support more typed data representation options. However, in some scenarios, it can be more preferable to disable recognition of numbers and other JSON simple values from strings, for example, when you need to keep leading padding zeros in a string value representing a number. In this case, you can switch to the strict mode as shown in following code snippet.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.SimpleValueParseMode = JsonSimpleValueParseMode.Strict;
JsonDataSource dataSource = new JsonDataSource(..., options);
```

**Note –** Parsing of date-time values does not depend on whether the loose or strict mode is used.

Recognition of date-time values is a special case, because [JSON specification](https://www.json.org) does not define a format for their representation. So, by default, while parsing date-time values from strings, the engine tries several formats in the following order:

1. [The ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601) (for values like "2015-03-02T13:56:04Z")
2. [The Microsoft® JSON date-time format](https://docs.microsoft.com/en-us/previous-versions/dotnet/articles/bb299886(v=msdn.10)#from-javascript-literals-to-json) (for values like "/Date(1224043200000)/")
3. All date-time formats supported for the current culture
4. All date-time formats supported for the English USA culture
5. All date-time formats supported for the English New Zealand culture

Although this approach is quite flexible, in some scenarios, you may need to restrict strings to be recognized as date-time values. You can achieve this by specifying one or several exact formats in the context of the current culture to be used while parsing date-time values from strings as shown in the following example.

```
List<String> formats = new List<String>();
formats.Add("MM/dd/yyyy");

JsonDataLoadOptions options = new JsonDataLoadOptions();
options.ExactDateTimeParseFormats = formats;
JsonDataSource dataSource = new JsonDataSource(..., options);
```

In this example, strings conforming the format "MM/dd/yyyy" are going to be recognized as date-time values while loading JSON, whereas the others are not (but see the following note).

In some scenarios, you may need to disable recognition of date-time values at all, for example, when you deal with strings containing already formatted date-time values, which you do not want to re-format using the engine. You can achieve this by setting the exact date-time parse formats to an empty list (but see the following note).

**Note –** Strings conforming the Microsoft® JSON date-time format (for example, "/Date(1224043200000)/") are always recognized as date-time values regardless of the exact date-time parse formats.

### Accessing CSV Data

To access CSV data while building a report, you can pass a `CsvDataSource` instance to the engine as a data source.

Using of `CsvDataSource` enables you to work with typed values rather than just strings in template documents. Although CSV as a format does not define a way to store values of types other than strings, `CsvDataSource` is capable to recognize values of the following types by their string representations:

- Int64?
- Double?
- Boolean?
- DateTime?

**Note –** For recognition of data types to work, string representations of corresponding values must be formed using invariant culture settings.

In template documents, a `CsvDataSource` instance should be treated as a sequence of objects having corresponding fields as shown in the following example.

CSV

```
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

Template document

```
<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Column2)]>>
```

Source code

```
CsvDataSource dataSource = ... // Loading CSV.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

By default, `CsvDataSource` uses column names such as “Column1”, “Column2”, and so on, as you can see from the previous example. However, `CsvDataSource` can be configured to read column names from the first line of CSV data as shown in the following example.

CSV

```
Name,Age,Birth
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Age)]>>
```

Source code

```
CsvDataLoadOptions options = new CsvDataLoadOptions(true);
CsvDataSource dataSource = new CsvDataSource(..., options); // Loading CSV.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

Also, you can use `CsvDataLoadOptions` to customize the following characters playing special roles while loading CSV data:

- Value separator (the default is comma)
- Single-line comment start (the default is sharp)
- Quotation mark enabling to use other special characters within a value (the default is double quotes)

### Setting up Known External Types

GroupDocs.Assembly Engine must be aware of custom external types that you reference in your template before the engine processes the template. You can set up external types known by the engine through the DocumentAssembler.KnownTypes property. The property represents an unordered set (that is, a collection of unique items) of [Type](http://msdn.microsoft.com/en-us/library/system.type(v=vs.110).aspx) objects. Every type in the set must meet requirements declared at [Working with Types](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-types).

**Note:** Aliases of simple types like int, string, and others are known by the engine by default.

Consider the following example. Given an ImageUtil class declared at your application and a template accessing a static member of this class, you can use the following code to make the engine be aware of the class before processing the template.

```csharp
DocumentAssembler assembler = new DocumentAssembler;
assembler.KnownTypes.Add(typeof(ImageUtil));
assembler.AssembleDocument(...);
```

### Accessing Missing Members of Data Objects

By default, GroupDocs.Assembly forbids access to missing members of data objects used to build a report in template expressions, since such access is forbidden by C# Language Specification 5.0. On attempt to use a missing member of a data object, the assembler throws an exception then.

But in some scenarios, members of data objects are not exactly known while designing a template. For example, if using a `DataSet` instance loaded from XML without its schema defined, some of expected data members can be missing.

To support such scenarios, the assembler provides an option to treat missing members of data objects as null literals. You can enable the option as shown in the following example.

```csharp
DocumentAssembler assembler = new DocumentAssembler();
assembler.Options |= DocumentAssemblyOptions.AllowMissingMembers;
assembler.AssembleDocument(...);
```

Consider the following example. Given that `r` is a `DataRow` instance that does not have a field `Missing`, by default, the following template expression causes the assembler to throw an exception while building a report.

```csharp
<<[r.Missing]>>
```

However, if `DocumentAssemblyOptions.AllowMissingMembers` is applied, the assembler treats access to such a field as a null literal, so no exception is thrown and simply no value is written to the report then.

### Optimizing Reflection Calls

GroupDocs.Assembly Engine uses reflection calls while accessing members of custom external types. However, reflection calls are much slower than direct calls, which creates a performance overhead.

Due to the performance overhead, the engine provides a strategy minimizing the reflection usage. The strategy is based upon the runtime type generation. That is, the engine generates a proxy type per an external type. The proxy directly calls members of the corresponding external type, the engine to access these members in a uniform way with no reflection involved. The proxy is [lazily initialized](http://en.wikipedia.org/wiki/Lazy_initialization) and reused in further. Thus, the reflection is used only while building the proxy.

Although this strategy can significantly minimize the reflection usage in a long run, it creates a performance overhead of the runtime type generation. So, if you deal with small data collections all the time while building your reports, consider the disabling of the strategy.

You can control the enabling of the strategy through the `DocumentAssembler.UseReflectionOptimization` static property. By default, the strategy is enabled.

### Integrating with Native Spreadsheet Data Types

By default, GroupDocs.Assembly outputs expression results as string values regardless of expression types. In most scenarios, this is the best option, since expression results can be formatted through template syntax depending on expression types. However, for Spreadsheet documents, this may interfere calculation of formulas expecting values of types other than string. To overcome this, GroupDocs.Assembly provides integration with native Spreadsheet data types, which can be enabled as shown in the following code snippet.

```csharp
DocumentAssembler assembler = new DocumentAssembler();
assembler.Options |= DocumentAssemblyOptions.UseSpreadsheetDataTypes;

assembler.AssembleDocument(...);
```

Let us show how it works by using an example. Let `number` be a numeric value. Then, consider the following template for a Spreadsheet cell.

```csharp
<<[number]>>
```

By default, while assembling a document, GroupDocs.Assembly converts `number` into a string using built-in .NET routines. However, when integration with native Spreadsheet data types is enabled, the cell’s value is written as a number, thus enabling to use it in Spreadsheet formulas expecting numbers.

Integration with native Spreadsheet data types also affects formatting of the cell’s value: If a numeric format is defined for the cell (for example, using “Format Cells” context menu in Microsoft Excel), then the format is applied; otherwise, a default numeric format for cells is applied.

**Note –** The same applies to other native Spreadsheet data types such as date-time and Boolean.

The following table describes, in which cases integration with native Spreadsheet data types has no effect even when enabled.

| Cell Template Syntax Example    | Explanation                                              |
| ----------------------------------- | ------------------------------------------------------------ |
| `<<[number]:ordinal>>`            | If an expression result is formatted using template syntax, it is written as a string. |
| `Some text <<[number]>>`          | Presence of text other than template syntax makes a result cell value to become a string. |
| `<<[number]>><<[anotherNumber]>>` | Results of multiple expressions in a single cell are converted to strings and concatenated. |

## Technical Considerations

Here, we will reveal some technical aspects and implementation details related to the GroupDocs.Assembly Engine which can be useful for you while making design decisions for your applications.

### Implicit Enumeration Determination

If you do not specify the type of an enumeration item in a `foreach` statement or lambda function signature within your template explicitly, the type is implicitly determined by the engine from the type of the enumeration as follows:

1.  If the enumeration represents a `DataTable` instance, then the item type is `DataRow`.
2.  Otherwise, if the enumeration represents a `DataView` instance, then the item type is `DataRowView`.
3.  Otherwise, if the enumeration implements `IDataReader`, then the item type is `IDataRecord`.
4.  Otherwise, if the enumeration represents child rows of a `DataRow` instance, then the item type is `DataRow`.
5.  Otherwise, if the enumeration implements generic `IEnumerable<T>`, then the item type is a type argument corresponding to T. Note, that the engine does not support enumerations that implement `IEnumerable<T>` multiple times using different type arguments.
6.  Otherwise, the item type is `Object`.

### Support for LINQ Providers

The engine does not cooperate with [LINQ providers](http://msdn.microsoft.com/en-us/library/vstudio/bb882640(v=vs.110).aspx). To be aware of consequences of this feature, consider the following example.

Assume, that you have the `City` and `Person` classes defined in your application as follows.

```csharp
public class City
{
    public IList<Person> Persons { get { ... } }
    ...
}
public class Person
{
    public String Name { get { ... } }
    public int Age { get { ... } }
    ...
    }
}
```

Given that `city` is an instance of the `City` class, consider the evaluation of the following template expression by the engine.

```csharp
city.Persons.Where(p => p.Age > 30).OrderBy(p => p.Name)
```

If you use an ORM to provide an interaction of your application with an SQL database in conjunction with a LINQ provider for the ORM, then you most likely expect an SQL query like the following one to be performed in the background while evaluating the template expression.

```csharp
SELECT *
    FROM Persons
    WHERE CityId = @CityId AND Age > 30
    ORDER BY Name
```

However, since the engine does not cooperate with LINQ providers, the actual SQL query in this case is as follows.

```csharp
SELECT *
    FROM Persons
    WHERE CityId = @CityId
```

That is, the engine makes an eager call before applying its built-in extension methods. In some cases, this feature can lead to a significant performance overhead. So, if the performance of your application is your primary concern, then consider a preparing of your sequential data outside your templates. That is, pass to the engine a sequential data that is already filtered, ordered, grouped, and so forth.

### Merging GroupDocs.Assembly

You can use a tool like [ILMerge](http://research.microsoft.com/en-us/people/mbarnett/ilmerge.aspx) to merge GroupDocs.Assembly library with another assembly. But in order to use the Engine, please add the following attribute to the target assembly.

```csharp
[assembly: InternalsVisibleTo(
    "TargetAssemblyName" +
    ".ReportingDynamics" +
    ", PublicKey=TargetAssemblyPublicKey")]
```

`TargetAssemblyName` and `TargetAssemblyPublicKey` stand for the name of your target assembly and its public key (not a public key token) respectively.

Despite of the `InternalsVisibleTo` attribute applied, you can normally use obfuscation routines on your target assembly, if needed. An obfuscation does not harm a functionality of GroupDocs.Assembly Engine.

---

## GroupDocs.Assembly Engine APIs

Path: /assembly/python-net/groupdocs-assembly-engine-apis/

{{< alert style="info" >}}In this article, we will discuss the behavior of GroupDocs.Assembly APIs.{{< /alert >}}

## Overview of the API

Classes of GroupDocs.Assembly are located within the GroupDocs.Assembly namespace. The main of the classes is DocumentAssembler. All the functionality required to build a report from a template is assembled within the class.

### Building Reports

To build a report from a template, you can use one of the `DocumentAssembler.AssembleDocument` overloads. The following table describes parameters of these overloads.

| Parameter | Description |
| --- | --- |
| document | A template document. At runtime, this document instance is populated with a data from the specified source and becomes a ready report. |
| dataSource | An object providing a data to populate the specified template. The object must be of one of the following types:<ul><li>`JsonDataSource`</li><li>`XmlDataSource`</li><li>`CsvDataSource`</li><li>`DataSet`</li><li>`DataTable`</li><li>`DataRow`</li><li>`DataView`</li><li>`DataRowView`</li><li>`IDataReader`</li><li>`IDataRecord`</li><li>An object of a custom [visible type](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/#using-types)</li></ul> |
| dataSourceName | The identifier of the specified data source object within the specified template. You can omit this identifier, if the template uses the [contextual object member access](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/#using-contextual-object-member-access) when dealing with the data source. |

Given a template to be populated with a data from a DataSet instance that is identified as "ds" within the template, you can use the following code to build the corresponding report.

```python
//Setting up source document template
strDocumentTemplate = "Template Folder/wordTemplate.docx";
//Setting up destination document report
strDocumentReport = "Report Folder/wordReport.docx";
// Setting up a data set.
DataSourceInfo = ...
array = [DataSourceInfo]

assembler = ga.DocumentAssembler()

assembler.AssembleDocument(strDocumentTemplate, strDocumentReport, array);
```

### Accessing XML Data

To access XML data while building a report, you can use facilities of `DataSet` to read XML into it and then pass it to the engine as a data source. However, if your scenario does not permit to specify XML schema while loading XML into `DataSet`, all attributes and text values of XML elements are loaded as strings then. Thus, it becomes impossible, for example, to use arithmetic operations on numbers or to specify custom date-time and numeric formats to output corresponding values, because all of them are treated as strings.

To overcome this limitation, you can pass an `XmlDataSource` instance to the engine as a data source instead. Even when XML schema is not provided, `XmlDataSource` is capable to recognize values of the following types by their string representations:

- Int64?
- Double?
- Boolean?
- DateTime?

**Note –** For recognition of data types to work, string representations of corresponding attributes and text values of XML elements must be formed using invariant culture settings.

While loading data to `XmlDataSource`, the engine performs actions typical for XML deserialization behind the scenes: It maps complex-type XML elements to internal objects and simple-type XML elements to fields of containing objects. So, in template documents, an `XmlDataSource` instance should be treated as an object having corresponding fields and nested objects as shown in the following example.

XML
```
<Person>
	<Name>John Doe</Name>
	<Age>30</Age>
	<Birth>1989-04-01 4:00:00 pm</Birth>
	<Child>Ann Doe</Child>
	<Child>Charles Doe</Child>
</Person>
```

Template document

```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth:
<<[Birth]:"dd.MM.yyyy">>

Children:

<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

Source code

```
dataSource = ga.data.XmlDataSource(constants.productXmlFile)
DataSourceInfo = ga.DataSourceInfo(dataSource)
    array = [DataSourceInfo]
assembler = ga.DocumentAssembler()
assembler.AssembleDocument(..., array);
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989

Children:

Ann Doe
Charles Doe
```

**Note –** To reference a sequence of repeated simple-type XML elements with the same name, the elements’ name itself (for example, “Child”) should be used in a template document, whereas the same name with the “_Text” suffix (for example, “Child_Text”) should be used to reference the text value of one of these elements.

By default, if a root XML element contains only a sequence of elements of one type, the engine does not generate an internal root object while loading XML data. So, in template documents, such an `XmlDataSource` instance should be treated as a sequence of corresponding nested objects as shown in the following example.

XML

```
<Persons>
	<Person>
		<Name>John Doe</Name>
		<Age>30</Age>
		<Birth>1989-04-01 4:00:00 pm</Birth>
	</Person>
	<Person>
		<Name>Jane Doe</Name>
		<Age>27</Age>
		<Birth>1992-01-31 07:00:00 am</Birth>
	</Person>
	<Person>
		<Name>John Smith</Name>
		<Age>51</Age>
		<Birth>1968-03-08 1:00:00 pm</Birth>
	</Person>
</Persons>
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>

Average age: <<[persons.Average(p => p.Age)]>>
```

Source code

```
dataSource = ga.data.XmlDataSource(constants.productXmlFile)
DataSourceInfo = ga.DataSourceInfo(dataSource)
    array = [DataSourceInfo]
assembler = ga.DocumentAssembler()
assembler.AssembleDocument(..., array);
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

However, if your scenario requires an internal object for a root XML element to be always generated while loading data to `XmlDataSource`, you can force this as shown in the following code snippet.

```
XmlDataLoadOptions options = new XmlDataLoadOptions();
options.AlwaysGenerateRootObject = true;
XmlDataSource dataSource = new XmlDataSource(..., options);
```

The following example sums up typical scenarios involving nested complex-type XML elements.

XML

```
<Managers>
   <Manager>
       <Name>John Smith</Name>
       <Contract>
           <Client>
               <Name>A Company</Name>
           </Client>
           <Price>1200000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>B Ltd.</Name>
           </Client>
           <Price>750000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>C &amp; D</Name>
           </Client>
           <Price>350000</Price>
       </Contract>
   </Manager>
   <Manager>
       <Name>Tony Anderson</Name>
       <Contract>
           <Client>
               <Name>E Corp.</Name>
           </Client>
           <Price>650000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>F &amp; Partners</Name>
           </Client>
           <Price>550000</Price>
       </Contract>
   </Manager>
   <Manager>
       <Name>July James</Name>
       <Contract>
           <Client>
               <Name>G &amp; Co.</Name>
           </Client>
           <Price>350000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>H Group</Name>
           </Client>
           <Price>250000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>I &amp; Sons</Name>
           </Client>
           <Price>100000</Price>
       </Contract>
       <Contract>
           <Client>
               <Name>J Ent.</Name>
           </Client>
           <Price>100000</Price>
       </Contract>
   </Manager>
</Managers>
```

Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

Source code

```
dataSource = ga.data.XmlDataSource(constants.productXmlFile)
DataSourceInfo = ga.DataSourceInfo(dataSource, "Manager")
    array = [DataSourceInfo]
assembler = ga.DocumentAssembler()
assembler.AssembleDocument(..., array);
```

Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)

Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)

Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

### Accessing JSON Data

To access JSON data while building a report, you can pass a `JsonDataSource` instance to the engine as a data source.

Using of `JsonDataSource` enables you to work with typed values of JSON elements in template documents. For more convenience, the set of simple JSON types is extended as follows:

- Int64?
- Double?
- Boolean?
- DateTime?
- String

**Note –** Working with complex JSON types (objects and arrays) is also supported.

While loading data to `JsonDataSource`, the engine performs JSON deserialization and generates corresponding internal objects. So, in template documents, a `JsonDataSource` instance should be treated according to what a root JSON element represents.

If a root JSON element is an object, a `JsonDataSource` instance should be treated as an object as well as shown in the following example.

JSON

```
{
   Name: "John Doe",
   Age: 30,
   Birth: "1989-04-01 4:00:00 pm",
   Child: [ "Ann Doe", "Charles Doe" ]
}
```

Template document

```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>

Children:

<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

Source code

```
 dataSource = ga.data.JsonDataSource(constants.customerJsonFile)
DataSourceInfo = ga.DataSourceInfo(dataSource)
    array = [DataSourceInfo]
assembler = ga.DocumentAssembler()
assembler.AssembleDocument(..., array);
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989

Children:

Ann Doe
Charles Doe
```

**Note –** To reference a JSON object property that is an array of simple-type values, the name of the property (for example, “Child”) should be used in a template document, whereas the same name with the “_Text” suffix (for example, “Child_Text”) should be used to reference the value of an item of this array.

If a root JSON element is an array, a `JsonDataSource` instance should be treated as a sequence of items of this array as shown in the following example.

JSON

```
[
   {
       Name: "John Doe",
       Age: 30,
       Birth: "1989-04-01 4:00:00 pm"
   },
   {
       Name: "Jane Doe",
       Age: 27,
       Birth: "1992-01-31 07:00:00 am"
   },
   {
       Name: "John Smith",
       Age: 51,
       Birth: "1968-03-08 1:00:00 pm"
   }
]
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>

Average age: <<[persons.Average(p => p.Age)]>>
```

Source code

```
 dataSource = ga.data.JsonDataSource(constants.customerJsonFile)
DataSourceInfo = ga.DataSourceInfo(dataSource, "person")
    array = [DataSourceInfo]
assembler = ga.DocumentAssembler()
assembler.AssembleDocument(..., array);
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

By default, if a root JSON element is an object having only one property that is an object or array in turn, the engine does not generate an internal root object while loading JSON data. So, in template documents, such a `JsonDataSource` instance should be treated according to what this property represents instead. For instance, the following JSON snippets can be used to produce the same results in previous examples of this section respectively.

JSON1

```
{
   Person:
   {
       Name: "John Doe",
       Age: 30,
       Birth: "1989-04-01 4:00:00 pm",
       Child: [ "Ann Doe", "Charles Doe" ]
   }
}
```

JSON 2

```
{
   Persons:
   [
       {
           Name: "John Doe",
           Age: 30,
           Birth: "1989-04-01 4:00:00 pm"
       },
       {
           Name: "Jane Doe",
           Age: 27,
           Birth: "1992-01-31 07:00:00 am"
       },
       {
           Name: "John Smith",
           Age: 51,
           Birth: "1968-03-08 1:00:00 pm"
       }
   ]
}
```

However, if your scenario requires an internal object for a root JSON element to be always generated while loading data to `JsonDataSource`, you can force this as shown in the following code snippet.

```
options = ga.JsonDataLoadOptions();
options.AlwaysGenerateRootObject = true;
dataSource = new JsonDataSource(..., options);
```

The following example sums up typical scenarios involving nested JSON objects and arrays.

JSON

```
[
   {
       Name: "John Smith",
       Contract:
       [
           {
               Client:
               {
                   Name: "A Company"
               },
               Price: 1200000
           },
           {
               Client:
               {
                   Name: "B Ltd."
               },
               Price: 750000
           },
           {
               Client:
               {
                   Name: "C & D"
               },
               Price: 350000
           }
       ]
   },
   {
       Name: "Tony Anderson",
       Contract:
       [
           {
               Client:
               {
                   Name: "E Corp."
               },
               Price: 650000
           },
           {
               Client:
               {
                   Name: "F & Partners"
               },
               Price: 550000
           }
       ]
   },
   {
       Name: "July James",
       Contract:
       [
           {
               Client:
               {
                   Name: "G & Co."
               },
               Price: 350000
           },
           {
               Client:
               {
                   Name: "H Group"
               },
               Price: 250000
           },
           {
               Client:
               {
                   Name: "I & Sons"
               },
               Price: 100000
           },
           {
               Client:
               {
                   Name: "J Ent."
               },
               Price: 100000
           }
       ]
   }
]
```

Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

Source code

```
dataSource = ga.data.JsonDataSource(constants.customerJsonFile)
DataSourceInfo = ga.DataSourceInfo(dataSource, "managers")
    array = [DataSourceInfo]
assembler = ga.DocumentAssembler()
assembler.AssembleDocument(..., array);
```

Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)

Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)

Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

For recognition of JSON simple values (null, boolean, number, integer, and string), the engine provides two modes: *loose* and *strict*. In the loose mode, types of JSON simple values are determined upon parsing of their string representations. In the strict mode, types of JSON simple values are determined from JSON notation itself. To see the main difference between the modes, consider the following JSON snippet.

`{ prop: "123" }`

In the loose mode, the type of `prop` is determined as integer, whereas in the strict mode, it is determined as string.

The loose mode is used by the engine by default to support more typed data representation options. However, in some scenarios, it can be more preferable to disable recognition of numbers and other JSON simple values from strings, for example, when you need to keep leading padding zeros in a string value representing a number. In this case, you can switch to the strict mode as shown in following code snippet.

```
JsonDataLoadOptions options = new JsonDataLoadOptions();
options.SimpleValueParseMode = JsonSimpleValueParseMode.Strict;
JsonDataSource dataSource = new JsonDataSource(..., options);
```

**Note –** Parsing of date-time values does not depend on whether the loose or strict mode is used.

Recognition of date-time values is a special case, because [JSON specification](https://www.json.org) does not define a format for their representation. So, by default, while parsing date-time values from strings, the engine tries several formats in the following order:

1. [The ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601) (for values like "2015-03-02T13:56:04Z")
2. [The Microsoft® JSON date-time format](https://docs.microsoft.com/en-us/previous-versions/dotnet/articles/bb299886(v=msdn.10)#from-javascript-literals-to-json) (for values like "/Date(1224043200000)/")
3. All date-time formats supported for the current culture
4. All date-time formats supported for the English USA culture
5. All date-time formats supported for the English New Zealand culture

Although this approach is quite flexible, in some scenarios, you may need to restrict strings to be recognized as date-time values. You can achieve this by specifying one or several exact formats in the context of the current culture to be used while parsing date-time values from strings as shown in the following example.

```
List<String> formats = new List<String>();
formats.Add("MM/dd/yyyy");

JsonDataLoadOptions options = new JsonDataLoadOptions();
options.ExactDateTimeParseFormats = formats;
JsonDataSource dataSource = new JsonDataSource(..., options);
```

In this example, strings conforming the format "MM/dd/yyyy" are going to be recognized as date-time values while loading JSON, whereas the others are not (but see the following note).

In some scenarios, you may need to disable recognition of date-time values at all, for example, when you deal with strings containing already formatted date-time values, which you do not want to re-format using the engine. You can achieve this by setting the exact date-time parse formats to an empty list (but see the following note).

**Note –** Strings conforming the Microsoft® JSON date-time format (for example, "/Date(1224043200000)/") are always recognized as date-time values regardless of the exact date-time parse formats.

### Accessing CSV Data

To access CSV data while building a report, you can pass a `CsvDataSource` instance to the engine as a data source.

Using of `CsvDataSource` enables you to work with typed values rather than just strings in template documents. Although CSV as a format does not define a way to store values of types other than strings, `CsvDataSource` is capable to recognize values of the following types by their string representations:

- Int64?
- Double?
- Boolean?
- DateTime?

**Note –** For recognition of data types to work, string representations of corresponding values must be formed using invariant culture settings.

In template documents, a `CsvDataSource` instance should be treated as a sequence of objects having corresponding fields as shown in the following example.

CSV

```
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

Template document

```
<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Column2)]>>
```

Source code

```
CsvDataSource dataSource = ... // Loading CSV.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

By default, `CsvDataSource` uses column names such as “Column1”, “Column2”, and so on, as you can see from the previous example. However, `CsvDataSource` can be configured to read column names from the first line of CSV data as shown in the following example.

CSV

```
Name,Age,Birth
John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm
```

Template document

```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Age)]>>
```

Source code

```
CsvDataLoadOptions options = new CsvDataLoadOptions(true);
CsvDataSource dataSource = new CsvDataSource(..., options); // Loading CSV.

DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(..., new DataSourceInfo(dataSource, "persons"));
```

Result document

```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968

Average age: 36
```

Also, you can use `CsvDataLoadOptions` to customize the following characters playing special roles while loading CSV data:

- Value separator (the default is comma)
- Single-line comment start (the default is sharp)
- Quotation mark enabling to use other special characters within a value (the default is double quotes)

### Setting up Known External Types

GroupDocs.Assembly Engine must be aware of custom external types that you reference in your template before the engine processes the template. You can set up external types known by the engine through the DocumentAssembler.KnownTypes property. The property represents an unordered set (that is, a collection of unique items) of [Type](http://msdn.microsoft.com/en-us/library/system.type(v=vs.110).aspx) objects. Every type in the set must meet requirements declared at [Working with Types](https://docs.groupdocs.com/assembly/python-net/template-syntax-part-1-of-2/#using-types).

**Note:** Aliases of simple types like int, string, and others are known by the engine by default.

Consider the following example. Given an ImageUtil class declared at your application and a template accessing a static member of this class, you can use the following code to make the engine be aware of the class before processing the template.

```csharp
DocumentAssembler assembler = new DocumentAssembler;
assembler.KnownTypes.Add(typeof(ImageUtil));
assembler.AssembleDocument(...);
```

### Accessing Missing Members of Data Objects

By default, GroupDocs.Assembly forbids access to missing members of data objects used to build a report in template expressions, since such access is forbidden by C# Language Specification 5.0. On attempt to use a missing member of a data object, the assembler throws an exception then.

But in some scenarios, members of data objects are not exactly known while designing a template. For example, if using a `DataSet` instance loaded from XML without its schema defined, some of expected data members can be missing.

To support such scenarios, the assembler provides an option to treat missing members of data objects as null literals. You can enable the option as shown in the following example.

```csharp
DocumentAssembler assembler = new DocumentAssembler();
assembler.Options |= DocumentAssemblyOptions.AllowMissingMembers;
assembler.AssembleDocument(...);
```

Consider the following example. Given that `r` is a `DataRow` instance that does not have a field `Missing`, by default, the following template expression causes the assembler to throw an exception while building a report.

```csharp
<<[r.Missing]>>
```

However, if `DocumentAssemblyOptions.AllowMissingMembers` is applied, the assembler treats access to such a field as a null literal, so no exception is thrown and simply no value is written to the report then.

### Optimizing Reflection Calls

GroupDocs.Assembly Engine uses reflection calls while accessing members of custom external types. However, reflection calls are much slower than direct calls, which creates a performance overhead.

Due to the performance overhead, the engine provides a strategy minimizing the reflection usage. The strategy is based upon the runtime type generation. That is, the engine generates a proxy type per an external type. The proxy directly calls members of the corresponding external type, the engine to access these members in a uniform way with no reflection involved. The proxy is [lazily initialized](http://en.wikipedia.org/wiki/Lazy_initialization) and reused in further. Thus, the reflection is used only while building the proxy.

Although this strategy can significantly minimize the reflection usage in a long run, it creates a performance overhead of the runtime type generation. So, if you deal with small data collections all the time while building your reports, consider the disabling of the strategy.

You can control the enabling of the strategy through the `DocumentAssembler.UseReflectionOptimization` static property. By default, the strategy is enabled.

### Integrating with Native Spreadsheet Data Types

By default, GroupDocs.Assembly outputs expression results as string values regardless of expression types. In most scenarios, this is the best option, since expression results can be formatted through template syntax depending on expression types. However, for Spreadsheet documents, this may interfere calculation of formulas expecting values of types other than string. To overcome this, GroupDocs.Assembly provides integration with native Spreadsheet data types, which can be enabled as shown in the following code snippet.

```csharp
DocumentAssembler assembler = new DocumentAssembler();
assembler.Options |= DocumentAssemblyOptions.UseSpreadsheetDataTypes;

assembler.AssembleDocument(...);
```

Let us show how it works by using an example. Let `number` be a numeric value. Then, consider the following template for a Spreadsheet cell.

```csharp
<<[number]>>
```

By default, while assembling a document, GroupDocs.Assembly converts `number` into a string using built-in .NET routines. However, when integration with native Spreadsheet data types is enabled, the cell’s value is written as a number, thus enabling to use it in Spreadsheet formulas expecting numbers.

Integration with native Spreadsheet data types also affects formatting of the cell’s value: If a numeric format is defined for the cell (for example, using “Format Cells” context menu in Microsoft Excel), then the format is applied; otherwise, a default numeric format for cells is applied.

**Note –** The same applies to other native Spreadsheet data types such as date-time and Boolean.

The following table describes, in which cases integration with native Spreadsheet data types has no effect even when enabled.

| Cell Template Syntax Example    | Explanation                                              |
| ----------------------------------- | ------------------------------------------------------------ |
| `<<[number]:ordinal>>`            | If an expression result is formatted using template syntax, it is written as a string. |
| `Some text <<[number]>>`          | Presence of text other than template syntax makes a result cell value to become a string. |
| `<<[number]>><<[anotherNumber]>>` | Results of multiple expressions in a single cell are converted to strings and concatenated. |

## Technical Considerations

Here, we will reveal some technical aspects and implementation details related to the GroupDocs.Assembly Engine which can be useful for you while making design decisions for your applications.

### Implicit Enumeration Determination

If you do not specify the type of an enumeration item in a `foreach` statement or lambda function signature within your template explicitly, the type is implicitly determined by the engine from the type of the enumeration as follows:

1.  If the enumeration represents a `DataTable` instance, then the item type is `DataRow`.
2.  Otherwise, if the enumeration represents a `DataView` instance, then the item type is `DataRowView`.
3.  Otherwise, if the enumeration implements `IDataReader`, then the item type is `IDataRecord`.
4.  Otherwise, if the enumeration represents child rows of a `DataRow` instance, then the item type is `DataRow`.
5.  Otherwise, if the enumeration implements generic `IEnumerable<T>`, then the item type is a type argument corresponding to T. Note, that the engine does not support enumerations that implement `IEnumerable<T>` multiple times using different type arguments.
6.  Otherwise, the item type is `Object`.

### Support for LINQ Providers

The engine does not cooperate with [LINQ providers](http://msdn.microsoft.com/en-us/library/vstudio/bb882640(v=vs.110).aspx). To be aware of consequences of this feature, consider the following example.

Assume, that you have the `City` and `Person` classes defined in your application as follows.

```csharp
public class City
{
    public IList<Person> Persons { get { ... } }
    ...
}
public class Person
{
    public String Name { get { ... } }
    public int Age { get { ... } }
    ...
    }
}
```

Given that `city` is an instance of the `City` class, consider the evaluation of the following template expression by the engine.

```csharp
city.Persons.Where(p => p.Age > 30).OrderBy(p => p.Name)
```

If you use an ORM to provide an interaction of your application with an SQL database in conjunction with a LINQ provider for the ORM, then you most likely expect an SQL query like the following one to be performed in the background while evaluating the template expression.

```csharp
SELECT *
    FROM Persons
    WHERE CityId = @CityId AND Age > 30
    ORDER BY Name
```

However, since the engine does not cooperate with LINQ providers, the actual SQL query in this case is as follows.

```csharp
SELECT *
    FROM Persons
    WHERE CityId = @CityId
```

That is, the engine makes an eager call before applying its built-in extension methods. In some cases, this feature can lead to a significant performance overhead. So, if the performance of your application is your primary concern, then consider a preparing of your sequential data outside your templates. That is, pass to the engine a sequential data that is already filtered, ordered, grouped, and so forth.

### Merging GroupDocs.Assembly

You can use a tool like [ILMerge](http://research.microsoft.com/en-us/people/mbarnett/ilmerge.aspx) to merge GroupDocs.Assembly library with another assembly. But in order to use the Engine, please add the following attribute to the target assembly.

```csharp
[assembly: InternalsVisibleTo(
    "TargetAssemblyName" +
    ".ReportingDynamics" +
    ", PublicKey=TargetAssemblyPublicKey")]
```

`TargetAssemblyName` and `TargetAssemblyPublicKey` stand for the name of your target assembly and its public key (not a public key token) respectively.

Despite of the `InternalsVisibleTo` attribute applied, you can normally use obfuscation routines on your target assembly, if needed. An obfuscation does not harm a functionality of GroupDocs.Assembly Engine.

---

## Handling the Lyrics tag

Path: /metadata/java/handling-the-lyrics-tag/

## What is Lyrics tag?

Lyrics3 Tag is a chunk of data which begins with "LYRICSBEGIN", ends with "LYRICSEND" and has the lyrics between these keywords. This data block is then saved in the audio file between the audio and the ID3 tag. If no ID3 tag is present one must be attached.

{{< alert style="info" >}}For more information, please visit: http://id3.org/Lyrics3{{< /alert >}}

## Reading a Lyrics tag

The GroupDocs.Metadata API allows reading the Lyrics3 tag in an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the Lyrics tag by using the [MP3RootPackage.getLyrics3V2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getLyrics3V2())method
4.  If the Lyrics tag is not null then check for all of its properties

The following code snippet reads the Lyrics tag from an MP3 file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3ReadLyricsTag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithLyrics)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	if (root.getLyrics3V2() != null) {
		System.out.println(root.getLyrics3V2().getLyrics());
		System.out.println(root.getLyrics3V2().getAlbum());
		System.out.println(root.getLyrics3V2().getArtist());
		System.out.println(root.getLyrics3V2().getTrack());

		// ...
		// Alternatively, you can loop through a full list of tag fields
		for (LyricsField field : root.getLyrics3V2().toList()) {
			System.out.println(String.format("%s = %s", field.getID(), field.getData()));
		}
	}
}
```

## Updating a Lyrics tag

The GroupDocs.Metadata API supports updating the Lyrics tag in an MP3 audio file.

The following are the steps to update the Lyrics tag in an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Create the Lyrics tag if it's missing
4.  Update Lyrics fields using the [MP3RootPackage.getLyrics3V2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getLyrics3V2())method
5.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

The following code snippet shows how to update the Lyrics tag in an MP3 file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3UpdateLyricsTag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithLyrics)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	if (root.getLyrics3V2() == null) {
		root.setLyrics3V2(new LyricsTag());
	}
	root.getLyrics3V2().setLyrics("[00:01]Test lyrics");
	root.getLyrics3V2().setArtist("test artist");
	root.getLyrics3V2().setAlbum("test album");
	root.getLyrics3V2().setTrack("test track");

	// You can add a fully custom field to the tag
	root.getLyrics3V2().set(new LyricsField("ABC", "custom value"));

	// ...

	metadata.save(Constants.OutputMp3);
}
```

## Removing a Lyrics tag

To remove the Lyrics tag from an MP3 audio just pass null to the [MP3RootPackage.setLyrics3V2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#setLyrics3V2(com.groupdocs.metadata.core.LyricsTag)) method. The code sample below shows how to remove the Lyrics tag from an MP3 file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3RemoveLyricsTag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithLyrics)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	root.setLyrics3V2(null);
	metadata.save(Constants.OutputMp3);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Handling the Lyrics tag

Path: /metadata/net/handling-the-lyrics-tag/

## What is Lyrics tag?

Lyrics3 Tag is a chunk of data which begins with "LYRICSBEGIN", ends with "LYRICSEND" and has the lyrics between these keywords. This data block is then saved in the audio file between the audio and the ID3 tag. If no ID3 tag is present one must be attached.

{{< alert style="info" >}}For more information, please visit: http://id3.org/Lyrics3 {{< /alert >}}

## Reading a Lyrics tag

The GroupDocs.Metadata API allows reading the Lyrics3 tag in an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the Lyrics tag by using the [MP3RootPackage.Lyrics3V2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/lyrics3v2) property
4.  If the Lyrics tag is not null then check for all of its properties

The following code snippet reads the Lyrics tag from an MP3 file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3ReadLyricsTag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithLyrics))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	if (root.Lyrics3V2 != null)
	{
		Console.WriteLine(root.Lyrics3V2.Lyrics);
		Console.WriteLine(root.Lyrics3V2.Album);
		Console.WriteLine(root.Lyrics3V2.Artist);
		Console.WriteLine(root.Lyrics3V2.Track);

		// ...

		// Alternatively, you can loop through a full list of tag fields
		foreach (var field in root.Lyrics3V2.ToList())
		{
			Console.WriteLine("{0} = {1}", field.ID, field.Data);
		}
	}
}
```

## Updating a Lyrics tag

The GroupDocs.Metadata API supports updating the Lyrics tag in an MP3 audio file.

The following are the steps to update the Lyrics tag in an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Create the Lyrics tag if it's missing
4.  Update Lyrics fields using the [MP3RootPackage.Lyrics3V2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/lyrics3v2) property
5.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

The following code snippet shows how to update the Lyrics tag in an MP3 file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3UpdateLyricsTag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithLyrics))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	if (root.Lyrics3V2 == null)
	{
		root.Lyrics3V2 = new LyricsTag();
	}
	root.Lyrics3V2.Lyrics = "[00:01]Test lyrics";
	root.Lyrics3V2.Artist = "test artist";
	root.Lyrics3V2.Album = "test album";
	root.Lyrics3V2.Track = "test track";

	// You can add a fully custom field to the tag
	root.Lyrics3V2.Set(new LyricsField("ABC", "custom value"));

	// ...

	metadata.Save(Constants.OutputMp3);
}
```

## Removing a Lyrics tag

To remove the Lyrics tag from an MP3 audio just assign null to the [MP3RootPackage.Lyrics3V2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/lyrics3v2) property. The code sample below shows how to remove the Lyrics tag from an MP3 file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3RemoveLyricsTag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithLyrics))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();
	root.Lyrics3V2 = null;

	metadata.Save(Constants.OutputMp3);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## How to generate QR Code and sign document using C#

Path: /signature/net/how-to-generate-qrcode-and-sign-document-using-csharp/


The generated QR Code can be downloaded and used to add to the business contracts and official documents. Any QR Code contains unique textual information that confirms the identity of the signer or authorizes the business document. QR Code verification could be performed automatically by reading the contents of the QR Code embedded data. These signatures could be scanned automatically. The QR Code allows keeping over 2 Kilobytes of data.

## Native .NET API for Electronic Signatures

[GroupDocs.Signature for .NET](https://products.groupdocs.com/signature/net) provides API for signing a wide range of document formats. Moreover, API includes special abilities for additional document content processing. Supported formats are PDF, Microsoft Word, Microsoft PowerPoint, Microsoft Excel, PNG, JPEG, and [many others](/signature/net/supported-document-formats/).

Use the [downloads section](https://downloads.groupdocs.com/signature/net) to obtain API DLLs or MSI installer or use the NuGet package manager:

```nuget
PM> Install-Package GroupDocs.Signature
```

## Signing a document with an Event QR-code in C\#

Sometimes it is needed to inform coworkers about business events. In such cases, an Event QR code can provide all the required information in a very effective way. This topic describes how to sign a PDF document with the generated Event QR code.

* Instantiate the `Signature` class providing the path to the source document or document stream.
* Set event data in the `Event` object instance.
* Create the `QrCodeSignOptions` object and set up all demanded fields.
* Invoke the `Sign` method to process the document, providing output file path and sign options.

```cs
            // instantiating the signature object
            using (Signature signature = new Signature(@"source.pdf"))
            {
                //provide event data
                Event eventQr = new Event()
                {
                    Title = "Meeting",
                    Description = "Productivity issues",
                    Location = "room 408",
                    StartDate = new DateTime(2022, 06, 19, 15, 30, 0),
                    EndDate = new DateTime(2022, 06, 19, 17, 0, 0)
                };

                // setup qrcode signature options
                QrCodeSignOptions signOptions = new QrCodeSignOptions()
                {
                    HorizontalAlignment = HorizontalAlignment.Right,
                    VerticalAlignment = VerticalAlignment.Bottom,
                    EncodeType = QrCodeTypes.QR,
                    Text = "",
                    Data = eventQr
                };

                // sign document
                signature.Sign(@"signed_event.pdf", signOptions);
            }
```

The result of signing a document may look like the picture below. Such QR codes can be very useful for organizing events.

![Document signed with an Event QR code](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/signed_event.png)

To try signing documents with QR codes for free, you may use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) Online App.

## QR Code image generation in C\#

Another way to improve documents is to generate the QR code first and then add it to documents using third-party tools. For this case, it is possible to generate code as an image.

* Create the `QrCodeSignOptions` instance and set up all demanded fields.
* Instantiate the `PreviewSignatureOptions` object providing the methods for creation and releasing.
* Invoke the `GenerateSignaturePreview` method to obtain the QR code image as a stream.
* Use the resultant QR Code stream in any possible way.

```cs
            MemoryStream result = new MemoryStream();
            // setup QR Code signature options
            QrCodeSignOptions signOptions = new QrCodeSignOptions()
            {
                EncodeType = QRCodeTypes.Code93,
                Text = "Case 148.01"
            };

            //Instantiate preview options
            var previewOptions = new PreviewSignatureOptions(
                signOptions,
                delegate (PreviewSignatureOptions options) { return result; },
                delegate (PreviewSignatureOptions options, Stream signatureStream) { }
                );

            //Generate image to stream
            GroupDocs.Signature.Signature.GenerateSignaturePreview(previewOptions);

```
An image with the generated QR Code may look as below:

![Generated QR Code](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/textqrcode.png)

## Get a Free API License
To use the API without evaluation limitations, you can get a free [temporary license](https://purchase.groupdocs.com/temporary-license).

## Conclusion

To sum up, some useful ways of processing documents with QR codes were discussed in this article. Using C# with .NET applications greatly improves the productivity of such actions.
In addition, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) Online App to generate QR codes and/or sign your files with QR codes for free.

Read the [documentation](https://docs.groupdocs.com/signature/net/) to learn how to use GroupDocs.Signature in your .NET applications. Also, you may discuss any questions or issues at the [GroupDocs forum](https://forum.groupdocs.com/).

## See also

* [How to sign documents with barcodes using C#](/signature/net/how-to-generate-barcode-and-sign-document-using-csharp)
* [How to sign Excel spreadsheets and their macros using C#](/signature/net/how-to-sign-excel-macros-using-csharp)

---

## How to generate QR Code and sign document using Python

Path: /signature/python-net/how-to-generate-qrcode-and-sign-document-using-python/


The generated QR Code can be downloaded and used to add to the business contracts and official documents. Any QR Code contains unique textual information that confirms the identity of the signer or authorizes the business document. QR Code verification could be performed automatically by reading the contents of the QR Code embedded data. These signatures could be scanned automatically. The QR Code allows keeping over 2 Kilobytes of data.

## Python API for Electronic Signatures

[GroupDocs.Signature for Python via .NET](https://products.groupdocs.com/signature/python-net) provides API for signing a wide range of document formats. Moreover, API includes special abilities for additional document content processing. Supported formats are PDF, Microsoft Word, Microsoft PowerPoint, Microsoft Excel, PNG, JPEG, and [many others](/signature/python-net/supported-document-formats/).

Use pip to install the package:

```bash
pip install groupdocs-signature
```

## Signing a document with an Event QR-code in Python

Sometimes it is needed to inform coworkers about business events. In such cases, an Event QR code can provide all the required information in a very effective way. This topic describes how to sign a PDF document with the generated Event QR code.

* Instantiate the `Signature` class providing the path to the source document or document stream.
* Set event data in the `Event` object instance.
* Create the `QrCodeSignOptions` object and set up all demanded fields.
* Invoke the `sign` method to process the document, providing output file path and sign options.

```python
import groupdocs.signature as signature
import groupdocs.signature.domain as gsd
from groupdocs.signature.options import QrCodeSignOptions
from datetime import datetime

# Initialize signature handler
signature_handler = signature.Signature("source.pdf")

# Provide event data
event_qr = signature.Event()
event_qr.title = "Meeting"
event_qr.description = "Productivity issues"
event_qr.location = "room 408"
event_qr.start_date = datetime(2022, 6, 19, 15, 30, 0)
event_qr.end_date = datetime(2022, 6, 19, 17, 0, 0)

# Setup QR code signature options
qr_options = QrCodeSignOptions()
qr_options.horizontal_alignment = gsd.HorizontalAlignment.RIGHT
qr_options.vertical_alignment = gsd.VerticalAlignment.BOTTOM
qr_options.encode_type = gsd.QrCodeTypes.QR
qr_options.text = ""
qr_options.data = event_qr

# Sign document
signature_handler.sign("signed_event.pdf", qr_options)
```

The result of signing a document may look like the picture below. Such QR codes can be very useful for organizing events.

![Document signed with an Event QR code](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/signed_event.png)

To try signing documents with QR codes for free, you may use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) Online App.

## QR Code image generation in Python

Another way to improve documents is to generate the QR code first and then add it to documents using third-party tools. For this case, it is possible to generate code as an image.

* Create the `QrCodeSignOptions` instance and set up all demanded fields.
* Instantiate the `PreviewSignatureOptions` object providing the methods for creation and releasing.
* Invoke the `generate_signature_preview` method to obtain the QR code image as a stream.
* Use the resultant QR Code stream in any possible way.

```python
import groupdocs.signature as signature
from io import BytesIO
import groupdocs.signature.domain as gsd
from groupdocs.signature.options import QrCodeSignOptions,PreviewSignatureOptions

# Create a memory stream to store the QR code image
result = BytesIO()

# Setup QR code signature options
qr_options = QrCodeSignOptions()
qr_options.encode_type = gsd.QrCodeTypes.CODE93
qr_options.text = "Case 148.01"

# Create preview options
preview_options = PreviewSignatureOptions(
    qr_options,
    lambda options: result,  # Create page stream
    lambda options, stream: None  # Release page stream
)

# Generate image to stream
signature.Signature.generate_signature_preview(preview_options)
```

An image with the generated QR Code may look as below:

![Generated QR Code](/signature/net/images/signature-use-cases/how-to-generate-barcode-and-sign-document-using-csharp/textqrcode.png)

## Get a Free API License
To use the API without evaluation limitations, you can get a free [temporary license](https://purchase.groupdocs.com/temporary-license).

## Conclusion

To sum up, some useful ways of processing documents with QR codes were discussed in this article. Using Python improves the productivity of such actions dramatically.
In addition, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) Online App to generate QR codes and/or sign your files with QR codes for free.

Read the [documentation](https://docs.groupdocs.com/signature/python-net/) to learn how to use GroupDocs.Signature in your Python applications. Also, you may discuss any questions or issues at the [GroupDocs forum](https://forum.groupdocs.com/).

## See also

* [How to sign documents with barcodes using Python](/signature/python-net/how-to-generate-barcode-and-sign-document-using-python)
* [How to sign Excel spreadsheets and their macros using Python](/signature/python-net/how-to-sign-excel-macros-using-python) 
---

## How to install Asian Fonts on CentOS

Path: /viewer/java/how-to-install-asian-fonts-on-centos/

This describes the installation of the Asian Fonts on CentOS 8/7/6.

## CentOS 7/8

The installation process is the same for CentOS 7 and CentOS 8. This topic describes the installation process for Centos 8.

To install a group of packages that includes fonts for Asian languages on Centos 8/7, follow these steps:

1. Run CentOS 8 in a Docker container: 

![](/viewer/java/images/how-to-install-asian-fonts-on-centos.png)

2. Execute the following command to install the group of packages:

{{< tabs "example1">}}
{{< tab "Shell" >}}
```sh
yum group install -y Fonts
```
{{< /tab >}}
{{< /tabs >}}


![](/viewer/java/images/how-to-install-asian-fonts-on-centos_1.png)

3. Wait for the message "Complete!". Installation completed.
	
![](/viewer/java/images/how-to-install-asian-fonts-on-centos_2.png)

## CentOS 6

To install a group of packages that includes fonts for Asian languages on Centos 8/7, follow these steps:

1. Run CentOS 8 in a Docker container: 

![](/viewer/java/images/how-to-install-asian-fonts-on-centos_3.png)

2. The font packages are separated into groups. Execute the following command to list them:

{{< tabs "example2">}}
{{< tab "Shell" >}}
```sh
yum grouplist
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/java/images/how-to-install-asian-fonts-on-centos_4.png)

3. Find the "Chinese Support \[zh\]" language group. To do this, check the "Installed Language Packs" section for already installed language packages. Then check the "Available Language Groups" section that lists the package bundles you can install.

![](/viewer/java/images/how-to-install-asian-fonts-on-centos_5.png)

4. If needed, install the Chinese language support. To do this, execute the following command:

{{< tabs "example3">}}
{{< tab "Shell" >}}
```sh
yum groupinstall -y "Chinese Support"
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/java/images/how-to-install-asian-fonts-on-centos_6.png)

5. Wait for the message "Complete!". Installation completed.

![](/viewer/java/images/how-to-install-asian-fonts-on-centos_7.png)

To install other Asian languages, use the following commands:

{{< tabs "example4">}}
{{< tab "Shell" >}}
```sh
yum groupinstall -y "Japanese Support"
yum groupinstall -y "Korean Support"
yum groupinstall -y "Hindi Support"
yum groupinstall -y "Kannada Support"
```
{{< /tab >}}
{{< /tabs >}}
---

## How to install Asian Fonts on CentOS

Path: /viewer/net/how-to-install-asian-fonts-on-centos/

This describes the installation of the Asian Fonts on CentOS 8/7/6.

## CentOS 7/8

The installation process is the same for CentOS 7 and CentOS 8. This topic describes the installation process for Centos 8.

To install a group of packages that includes fonts for Asian languages on Centos 8/7, follow these steps:

1. Run CentOS 8 in a Docker container: 

![](/viewer/net/images/how-to-install-asian-fonts-on-centos.png)

2. Execute the following command to install the group of packages:

{{< tabs "example1">}}
{{< tab "Shell" >}}
```sh
yum group install -y Fonts
```
{{< /tab >}}
{{< /tabs >}}


![](/viewer/net/images/how-to-install-asian-fonts-on-centos_1.png)

3. Wait for the message "Complete!". Installation completed.
	
![](/viewer/net/images/how-to-install-asian-fonts-on-centos_2.png)

## CentOS 6

To install a group of packages that includes fonts for Asian languages on Centos 8/7, follow these steps:

1. Run CentOS 8 in a Docker container: 

![](/viewer/net/images/how-to-install-asian-fonts-on-centos_3.png)

2. The font packages are separated into groups. Execute the following command to list them:

{{< tabs "example2">}}
{{< tab "Shell" >}}
```sh
yum grouplist
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/net/images/how-to-install-asian-fonts-on-centos_4.png)

3. Find the "Chinese Support \[zh\]" language group. To do this, check the "Installed Language Packs" section for already installed language packages. Then check the "Available Language Groups" section that lists the package bundles you can install.

![](/viewer/net/images/how-to-install-asian-fonts-on-centos_5.png)

4. If needed, install the Chinese language support. To do this, execute the following command:

{{< tabs "example3">}}
{{< tab "Shell" >}}
```sh
yum groupinstall -y "Chinese Support"
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/net/images/how-to-install-asian-fonts-on-centos_6.png)

5. Wait for the message "Complete!". Installation completed.

![](/viewer/net/images/how-to-install-asian-fonts-on-centos_7.png)

To install other Asian languages, use the following commands:

{{< tabs "example4">}}
{{< tab "Shell" >}}
```sh
yum groupinstall -y "Japanese Support"
yum groupinstall -y "Korean Support"
yum groupinstall -y "Hindi Support"
yum groupinstall -y "Kannada Support"
```
{{< /tab >}}
{{< /tabs >}}
---

## How to merge BMP images using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-bmp-images-using-csharp/


## BMP Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple BMP documents in the preferred order and save them as a single file.

## About BMP File Format

Files having extension .BMP represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The BMP file format can store data as two-dimensional digital images in both monochrome and colored formats with various color depths.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### Source BMP images

!["Sample1.bmp"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.bmp"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.bmp"](/merger/net/images/jpg/sample3.jpg)

### How to merge BMP files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinmode) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```csharp
// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.bmp"))
{
    // Define image join options with vertical join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
    // Add another image file to merge
    merger.Join(@"c:\sample2.bmp", joinOptions);
    // Add next image file to merge
    merger.Join(@"c:\sample3.bmp", joinOptions);
    // Merge image files and save result
    merger.Save(@"c:\merged.bmp");
}
```

### Result merged BMP image

!["Merged.bmp"](/merger/net/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge BMP Live Demo

GroupDocs.Merger for .NET provides an online [**BMP Merger App**](https://products.groupdocs.app/merger/bmp), which allows you to try it for free and check its quality and accuracy.
---

## How to merge BMP images using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-bmp-images-using-java/


## BMP Merger Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple BMP documents in the preferred order and save them as a single file.

## About BMP File Format

Files having extension .BMP represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The BMP file format can store data as two-dimensional digital images in both monochrome as well as color format with various colour depths.

### Download and Configure

You can follow the steps below to reference GroupDocs.Merger for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/merger/java):

1. Unpack zip archive .
2. Switch to **lib** folder.
3. Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4. After this you should add the merger **dependency** block to your *pom.xm*l project file.

### Source BMP images

!["Sample1.bmp"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.bmp"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.bmp"](/merger/java/images/jpg/sample3.jpg)

### How to merge BMP files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```java
// Load the source image file
Merger merger = new Merger("c:\sample1.bmp")

// Define image join options with vertical join mode
ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
// Add another image file to merge
merger.join("c:\sample2.bmp", joinOptions);
// Add next image file to merge
merger.join("c:\sample3.bmp", joinOptions);
// Merge image files and save result
merger.save("c:\merged.bmp");
```

### Result merged BMP image

!["Merged.bmp"](/merger/java/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge BMP Live Demo

GroupDocs.Merger for Java provides an online [**BMP Merger App**](https://products.groupdocs.app/images/bmp), which allows you to try it for free and check its quality and accuracy.
---

## How to merge BMP images using Node.js via Java

Path: /merger/nodejs-java/getting-started/use-cases/how-to-merge-bmp-images-using-nodejs-java/


## BMP Merger Node.js via Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) allows developers to combine multiple BMP documents in the preferred order and save them as a single file.

## About BMP File Format

Files having extension .BMP represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The BMP file format can store data as two-dimensional digital images in both monochrome as well as color format with various colour depths.

### Download and Configure

You can download GroupDocs.Merger for Node.js via Java from official website [Downloads section](https://downloads.groupdocs.com/merger/nodejs-java).

### Source BMP images

!["Sample1.bmp"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.bmp"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.bmp"](/merger/java/images/jpg/sample3.jpg)

### How to merge BMP files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of nodejs-java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.bmp');
const imageJoinModeVertical = groupdocs.merger.ImageJoinMode.Vertical;
const imageJoinOptions = new groupdocs.merger.ImageJoinOptions(imageJoinModeVertical);
merger.join('c:/sample2.bmp', imageJoinOptions);
merger.join('c:/sample3.bmp', imageJoinOptions);
return merger.save('c:/merged.bmp');
```

### Result merged BMP image

!["Merged.bmp"](/merger/java/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge BMP Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**BMP Merger App**](https://products.groupdocs.app/images/bmp), which allows you to try it for free and check its quality and accuracy.
---

## How to merge BMP images using Python via .NET

Path: /merger/python-net/getting-started/use-cases/how-to-merge-bmp-images-using-python-net/


## BMP Merger Python via .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) allows developers to combine multiple BMP documents in the preferred order and save them as a single file.

## About BMP File Format

Files having extension .BMP represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The BMP file format can store data as two-dimensional digital images in both monochrome as well as color format with various colour depths.

### Download and Configure

You can download GroupDocs.Merger for Python via .NET from official website [Downloads section](https://downloads.groupdocs.com/merger/python-net).

### Source BMP images

!["Sample1.bmp"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.bmp"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.bmp"](/merger/net/images/jpg/sample3.jpg)

### How to merge BMP files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of python-net code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```python
with gm.Merger("c:/sample1.bmp") as merger:
    image_join_mode = gm.domain.options.ImageJoinMode.VERTICAL
    image_join_options = gm.domain.options.ImageJoinOptions(image_join_mode)
    merger.join("c:/sample2.bmp", join_options = image_join_options)
    merger.join("c:/sample3.bmp", join_options = image_join_options)
    merger.save("c:/merged.bmp")
```

### Result merged BMP image

!["Merged.bmp"](/merger/net/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge BMP Live Demo

GroupDocs.Merger for Python via .NET provides an online [**BMP Merger App**](https://products.groupdocs.app/images/bmp), which allows you to try it for free and check its quality and accuracy.
---

## How to merge JPG images using Node.js via Java

Path: /merger/nodejs-java/getting-started/use-cases/how-to-merge-jpg-images-using-nodejs-java/


## JPG Merger Node.js via Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) allows developers to combine multiple JPG documents in the preferred order and save them as a single file.

## About JPG File Format

Files having extension .JPG represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The JPG file format can store data as two-dimensional digital images in both monochrome as well as color format with various colour depths.

### Download and Configure

You can download GroupDocs.Merger for Node.js via Java from official website [Downloads section](https://downloads.groupdocs.com/merger/nodejs-java).

### Source JPG images

!["Sample1.jpg"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/java/images/jpg/sample3.jpg)

### How to merge JPG files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of nodejs-java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.jpg');
const imageJoinModeVertical = groupdocs.merger.ImageJoinMode.Vertical;
const imageJoinOptions = new groupdocs.merger.ImageJoinOptions(imageJoinModeVertical);
merger.join('c:/sample2.jpg', imageJoinOptions);
merger.join('c:/sample3.jpg', imageJoinOptions);
return merger.save('c:/merged.jpg');
```

### Result merged JPG image

!["Merged.jpg"](/merger/java/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge JPG Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**JPG Merger App**](https://products.groupdocs.app/images/jpg), which allows you to try it for free and check its quality and accuracy.
---

## How to merge JPG images using Python via .NET

Path: /merger/python-net/getting-started/use-cases/how-to-merge-jpg-images-using-python-net/


## JPG Merger Python via .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) allows developers to combine multiple JPG documents in the preferred order and save them as a single file.

## About JPG File Format

Files having extension .JPG represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The JPG file format can store data as two-dimensional digital images in both monochrome as well as color format with various colour depths.

### Download and Configure

You can download GroupDocs.Merger for Python via .NET from official website [Downloads section](https://downloads.groupdocs.com/merger/python-net).

### Source JPG images

!["Sample1.jpg"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/net/images/jpg/sample3.jpg)

### How to merge JPG files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of python-net code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```python
with gm.Merger("c:/sample1.jpg") as merger:
    image_join_mode = gm.domain.options.ImageJoinMode.VERTICAL
    image_join_options = gm.domain.options.ImageJoinOptions(image_join_mode)
    merger.join("c:/sample2.jpg", join_options = image_join_options)
    merger.join("c:/sample3.jpg", join_options = image_join_options)
    merger.save("c:/merged.jpg")
```

### Result merged JPG image

!["Merged.jpg"](/merger/net/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge JPG Live Demo

GroupDocs.Merger for Python via .NET provides an online [**JPG Merger App**](https://products.groupdocs.app/images/jpg), which allows you to try it for free and check its quality and accuracy.
---

## How to merge PNG images using Node.js via Java

Path: /merger/nodejs-java/getting-started/use-cases/how-to-merge-png-images-using-nodejs-java/


## PNG Merger Node.js via Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) allows developers to combine multiple PNG documents in the preferred order and save them as a single file.

## About PNG File Format

Files having extension .PNG represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The PNG file format can store data as two-dimensional digital images in both monochrome as well as color format with various colour depths.

### Download and Configure

You can download GroupDocs.Merger for Node.js via Java from official website [Downloads section](https://downloads.groupdocs.com/merger/nodejs-java).

### Source PNG images

!["Sample1.png"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.png"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.png"](/merger/java/images/jpg/sample3.jpg)

### How to merge PNG files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of nodejs-java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged image file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.png');
const imageJoinModeVertical = groupdocs.merger.ImageJoinMode.Vertical;
const imageJoinOptions = new groupdocs.merger.ImageJoinOptions(imageJoinModeVertical);
merger.join('c:/sample2.png', imageJoinOptions);
merger.join('c:/sample3.png', imageJoinOptions);
return merger.save('c:/merged.png');
```

### Result merged PNG image

!["Merged.png"](/merger/java/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PNG Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**PNG Merger App**](https://products.groupdocs.app/images/png), which allows you to try it for free and check its quality and accuracy.
---

## How to merge PNG images using Python via .NET

Path: /merger/python-net/getting-started/use-cases/how-to-merge-png-images-using-python-net/


## PNG Merger Python via .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) allows developers to combine multiple PNG documents in the preferred order and save them as a single file.

## About PNG File Format

Files having extension .PNG represent Bitmap Image files that are used to store bitmap digital images. These images are independent of graphics adapter and are also called device independent bitmap (DIB) file format. This independency serves the purpose of opening the file on multiple platforms such as Microsoft Windows and Mac. The PNG file format can store data as two-dimensional digital images in both monochrome as well as color format with various colour depths.

### Download and Configure

You can download GroupDocs.Merger for Python via .NET from official website [Downloads section](https://downloads.groupdocs.com/merger/python-net).

### Source PNG images

!["Sample1.png"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.png"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.png"](/merger/net/images/jpg/sample3.jpg)

### How to merge PNG files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of python-net code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinMode) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/ImageJoinOptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```python
with gm.Merger("c:/sample1.png") as merger:
    image_join_mode = gm.domain.options.ImageJoinMode.VERTICAL
    image_join_options = gm.domain.options.ImageJoinOptions(image_join_mode)
    merger.join("c:/sample2.png", join_options = image_join_options)
    merger.join("c:/sample3.png", join_options = image_join_options)
    merger.save("c:/merged.png")
```

### Result merged PNG image

!["Merged.png"](/merger/net/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PNG Live Demo

GroupDocs.Merger for Python via .NET provides an online [**PNG Merger App**](https://products.groupdocs.app/images/png), which allows you to try it for free and check its quality and accuracy.
---

## How to protect a signed PDF document

Path: /signature/net/protect-pdf-documents/


### How to secure PDF document with permissions

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving signed documents with permission settings and password protection for access and modification. This capability is achieved using the [PermissionsPassword](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions/permissionspassword/) and [Permissions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions/permissions/) properties of the [PdfSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions/) class, which should be passed to [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method.

You can secure a PDF document by setting the following parameters:
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the [PdfSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions) object and specify [PermissionsPassword](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions/permissionspassword) property(optional). Configure the [Permissions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions/permissions/property) to control user actions (e.g., deny printing or modification).  
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signature options and [PdfSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions) object to it.

Following example demonstrates how to save signed document with permissions.

```csharp
// Using the Signature class to create a signature for the specified PDF document
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions textSignOptions = new TextSignOptions("JohnSmith")
    {
        Left = 0,
        Top = 100,
        Width = 100,
        Height = 100,
        AllPages = true,
        ForeColor = Color.Black
    };

    // Create a new PdfSaveOptions object to configure the PDF save settings
    PdfSaveOptions saveOptions = new PdfSaveOptions();
    saveOptions.OverwriteExistingFiles = false;
    // Set permissions to deny printing and modification
    saveOptions.Permissions = Permissions.DenyPrinting | Permissions.DenyModification;
    // Set a password for modifying permissions(optional)
    saveOptions.PermissionsPassword = "0987654321";
    // Sign the document and save the result to a new file
    signature.Sign("result.pdf", textSignOptions, saveOptions);
}
```

### How to load PDF document with permissions

The [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports loading documents with specific permissions that are preserved after signing. This capability is managed through the [LoadOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions/) class, where the [Permissions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions/permissions/) property is set when loading the document. These permissions remain enforced in the signed document, ensuring consistent restrictions from loading to final save output when passed to the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method.

To load a PDF document with permissions and ensure those permissions are preserved throughout the signing process, follow these steps:
* Create a new instance of [LoadOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions/) , configuring the [Permissions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pdfsaveoptions/permissions/) property to set restrictions (e.g., deny printing, modification, or data extraction).
* Use this [LoadOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions/) instance to initialize the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class with the document path or stream.
* Instantiate the required signature options (e.g.,  [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/) ) to set signature position and appearance.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class, passing the signature options. The document will retain the permissions specified in the [LoadOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions/) , ensuring any restrictions applied during loading are preserved in the signed document.

Following example demonstrates how to load PDF document with permissions. 

```csharp
// Set up load options with specific permissions, denying all actions (printing, modification, extraction)
LoadOptions loadOptions = new LoadOptions()
{
    Permissions = Permissions.DenyAll
};

// Using the Signature class to create a signature for the specified PDF document
using (Signature signature = new Signature("sample.pdf", loadOptions))
{
    TextSignOptions textSignOptions = new TextSignOptions("JohnSmith")
    {
        Left = 0,
        Top = 100,
        Width = 100,
        Height = 100
    };
    
    signature.Sign("result.pdf", textSignOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## How to Run Examples

Path: /signature/python-net/how-to-run-examples/

This article describes how to run Python digital signature API code examples.
{{< alert style="warning" >}} Before running an example make sure that GroupDocs.Signature has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Signature examples, by building your own or using our examples out-of-the-box.

Please choose one from the following list:

## Build project from scratch

* Create a new Python project directory and set up a virtual environment:

```bash
# Create project directory
mkdir signature_project
cd signature_project

# Create and activate virtual environment
python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install GroupDocs.Signature
pip install groupdocs-signature-net
```

* Create a new Python file (e.g., `main.py`) and code your first application with **GroupDocs.Signature for Python** like this:

```python
import groupdocs.signature as signature

# The path to the documents directory.
file_path = "sample.docx"  # NOTE: Put here actual path for your document
output_file_path = "output/signed.docx"

# Sign document with text signature
signature_handler = signature.Signature(file_path)
text_sign_options = signature.TextSignOptions("John Smith")
signature_handler.sign(output_file_path, text_sign_options)
```

* Run your project:
```bash
python main.py
```

* Signed document will appear in the "output" directory.

## Run examples from GitHub

The complete examples package of **GroupDocs.Signature for Python** is hosted on [GitHub](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET). You can either download the ZIP file or clone the repository:

```bash
git clone https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET.git
cd GroupDocs.Signature-for-Python-via-.NET
```

To run the examples:

1. Set up a virtual environment and install dependencies:
```bash
python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

pip install -r requirements.txt
```

2. Navigate to the examples or select example which you like and execute:
```bash
cd Examples
python run_examples.py
```

## Run from Docker

Use [Docker](https://www.docker.com/) image to try GroupDocs.Signature for Python features in an easy way. Here are the commands to run GroupDocs.Signature for Python from docker image:

```bash
mkdir DocumentSamples
mkdir Licenses
docker run -p 5000:5000 \
  --env APPLICATION_HOST_ADDRESS=localhost \
  -v $(pwd)/DocumentSamples:/home/groupdocs/app/DocumentSamples \
  -v $(pwd)/Licenses:/home/groupdocs/app/Licenses \
  groupdocs/signature-python
# Open http://localhost:5000 in your favorite browser
```

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## HTML

Path: /parser/java/html/

The following example shows how to extract HTML formatted text:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Formatted text extraction isn't suppported" : reader.readToEnd());
    }
}
```

| Tag | Description |
| --- | --- |
| `p` | Paragraph is surrounded by `p` tag |
| `a` | Hyperlinks |
| `b` | Text with Bold font is surrounded by `b` tag |
| `i` | Text with Italic font is surrounded by `i` tag |
| `h1` - `h6` | If the heading has 'Heading X' style, it's surrounded by `<hX>` tag |
| `ol` / `ul` | Numbering and bullets lists |
| `table` | Tables |

The following Microsoft Word document is used as input document:

![](/parser/java/images/html.png)

The following HTML document is extracted using the example above:

![](/parser/java/images/html_1.png)

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## In-Paragraph List in Presentation Document

Path: /assembly/java/in-paragraph-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-ParagraphList report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Paragraph List in Microsoft PowerPoint Document

### Creating a In-Paragraph List

Practising the following steps you can create In-Paragraph List Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Write a sentence, for example "We provide support for the following clients:".
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe about the clients with the following key requirements:

*   A descriptive or informative line like "We provide support for the following clients:".
*   Show all the clients along with the above sentence.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients: <<foreach [in getClients()]>>
<<[indexOf() != 0 ? ", " : ""]>><<[getName()]>><</foreach>>
```

### Download In-Paragraph List Template

Please download the sample In-Paragraph List document we created in this article:

*   [In-Paragraph List.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/In-Paragraph%20List.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists f001bd344a3277fd54a00bceaef25523 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Paragraph List in Presentation Document

Path: /assembly/net/in-paragraph-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Paragraph List report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}

## In-Paragraph List in Microsoft PowerPoint Document

### Creating a In-Paragraph List

Practicing the following steps you can create In-Paragraph List Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Write a sentence, for example "We provide support for the following products:".
3.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   A descriptive or informative line like "We provide support for the following products:".
*   Show all the products along with the above sentence.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[IndexOf() != 0 ? ", " : ""]>>
<<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Paragraph List Template

Please download the sample In-Paragraph List document we created in this article:

*   [In-Paragraph List.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Paragraph%20List.pptx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [In-Paragraph List\_XML.pptx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Paragraph%20List_XML.pptx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs bd5557c6afce363c91b4 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 7af1f7c4d8657f446fbb >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 5eece4a7628ce469d578 >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 93708a50854ca5c5bae8 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 213cf34e8727ab1d224a >}}

## In-Paragraph List in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'In-Paragraph List' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Paragraph List\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Paragraph%20List_OpenDocument.odp?raw=true) (use same template for database, dataset and JSON examples)
*   [In-Paragraph List\_XML\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Paragraph%20List_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 67b2109c81d174ecea7c >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 1ce821c079b3f54c1272 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 464b40a30fc1fee5cd38 >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 8123d5ed9e9d796def53 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 0342489311290a4fa12c >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List in Presentation Document

Path: /assembly/java/in-table-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList report in Presentation format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List in Microsoft PowerPoint Document

### Creating a In-Table List

Practicing the following steps you can create In-Table List Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Press "Insert" tab.
3.  Add a 2x3 table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers with the following key requirements:

*   Report must show managers' name.
*   It must show the sum of contract prices against each manager.
*   It must sum up all the contract prices for all the managers.
*   All the representation must be in tabular form.
*   Report must be generated in the PowerPoint Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Manager</b></td>
			<td style="background-color: #5B9BD5"><b>Contract Price</b></td>
		</tr>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;foreach [in getManagers()]>>&lt;&lt;[getName()]>></b></td>
			<td style="background-color: #D2DEEF"><b>&lt;&lt;[getContracts().sum(c => c.getPrice())]>>&lt;&lt;foreach>></b></td>
		</tr>
    <tr>
			<td style="background-color: #5B9BD5"><b>Total:</b></td>
			<td style="background-color: #D2DEEF"><b>&lt;&lt;[getManagers().sum(m => m.getContracts().sum(c => c.getPrice()))]>></b></td>
		</tr>
	</tbody>
</table>

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/In-Table%20List.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 99fcb5298182b99b02f37b30bb654883 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List in Presentation Document

Path: /assembly/net/in-table-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList report in Presentationformat based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List in Microsoft PowerPoint Document

### Creating a In-Table List

Practicing the following steps you can create In-Table List Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Press "Insert" tab.
3.  Add a 2x3 table.
4.  Save your Document.

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and the total order prices with the following key requirements:

*   Report must show customers' name.
*   It must show the sum of orders prices against each customer.
*   It must sum up all the order prices for all the customers.
*   All the representation must be in tabular form.
*   Report must be generated in the PowerPoint Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in customers]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">m =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">m.Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List.pptx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List_DB.pptx?raw=true) (Template for DataBase examples)
*   [In-Table List\_DS.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List_DT.pptx?raw=true) (Template for DataSet examples)
*   [In-Table List\_XML.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List_XML.pptx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 71fcf75bd3feaf5d873ff61e15dc00e8 >}}

#### Database Entities

{{< gist GroupDocsGists bd857a50ae01f983b29cb1769802f3d3 >}}

#### Using DataSet

{{< gist GroupDocsGists 0f77f396d534f522d12ec702d92ecbc2 >}}

#### Using XML DataSource

{{< gist GroupDocsGists efb270bc2eb454a302b6510010f7193b >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 19b51904739d42123ea53635451b4102 >}}

## In-Table List in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List_OpenDocument.odp?raw=true) (use same template for JSON examples)
*   [In-Table List\_DB\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List_DB_OpenDocument.odp?raw=true)
*   [In-Table List\_DS\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List_DT_OpenDocument.odp?raw=true)
*   [In-Table List\_XML\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 2c117c807e3b1a564d8233e6e2e1ed7e >}}

#### Database Entities

{{< gist GroupDocsGists 87feabf7f5e948680a9293f4dc9e7fa3 >}}

#### Using DataSet

{{< gist GroupDocsGists 620fc09630871709014569e454e3f477 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 7201e34d8b3c2d071a2bc029183bf181 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists ec209a9e1cf1d1f4f6dc70726089a87f >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List With Alternate Content in Presentation Document

Path: /assembly/java/in-table-list-with-alternate-content-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList WithAlternateContent report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List With Alternate Content in Microsoft PowerPoint Document

### Creating a In-Table List With Alternate Content

Practicing the following steps you can create In-Table List With Alternate Content Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2X3 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent your clients and their prices with the following key requirements:

*   Report must show each client along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="608" style="width: 456pt; border-collapse: collapse;"><tbody><tr><td width="371" valign="top" style="width: 278pt; border-top-color: white; border-top-style: solid; border-top-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b><span style="color: black;">Client</span></b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: white; border-top-style: solid; border-top-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 3pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b><span style="color: black;">Contract Price</span></b></p></td></tr><tr><td width="608" colspan="2" valign="top" style="width: 456pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b><span style="color: black;">&lt;&lt;if [!getContracts().any()]&gt;&gt;No data</span></b></p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b><span style="color: black;">&lt;&lt;else&gt;&gt;&lt;&lt;foreach [in getContracts()]&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</span></b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(234, 239, 247); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b><span style="color: black;">&lt;&lt;[getPrice()]&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></b></p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b><span style="color: black;">Total:</span></b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(210, 222, 239); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b><span style="color: black;">&lt;&lt;[getContracts().sum(</span></b></p><p class="MsoNormal"><b><span style="color: black;">&nbsp; c =&gt; c.getPrice())]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></b></p></td></tr></tbody></table>
### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 1a951e09c816e7a8053e88b25cdb5a4a >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List With Alternate Content in Presentation Document

Path: /assembly/net/in-table-list-with-alternate-content-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List With Alternate Content report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}

## In-Table List With Alternate Content in Microsoft PowerPoint Document

### Creating a In-Table List With Alternate Content

Practicing the following steps you can create In-Table List With Alternate Content Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2X3 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent your products and their prices with the following key requirements:

*   Report must show each product along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Products</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td colspan="2" style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 445.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!Any()]&gt;&gt;No data</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Product.ProductName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content.pptx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List With Alternate Content\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content_DB.pptx?raw=true) (Template for DataBase examples)
*   [In-Table List With Alternate Content\_DS.pptx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content_DT.pptx?raw=true) (Template for DataSet examples)
*   [In-Table List With Alternate Content\_XML.pptx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content_XML.pptx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 850b559b8d1a5daf4090 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 23172752339ad93005b0 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs f1191dda602f03a8d0de >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs cfc557b5577e74774d85 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs d438036916b37e8de3ce >}}

## In-Table List With Alternate Content in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [Wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List With Alternate Content' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List With Alternate Content\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content_OpenDocument.odp?raw=true) (use same template for JSON examples)
*   [In-Table List With Alternate Content\_DB\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content_DB_OpenDocument.odp?raw=true)
*   [In-Table List With Alternate Content\_DS\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content_DT_OpenDocument.odp?raw=true)
*   [In-Table List With Alternate Content\_XML\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Alternate%20Content_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs f2c677b15405eee573b8 >}}

#### Database Entities

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 500496510318621b4052 >}}

#### Using DataSet

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 86b93d5e922bf918bd38 >}}

#### Using XML DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs e390291277cb43b3fc59 >}}

#### Using JSON DataSource

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs 14568d37ff0b3e775a71 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Filtering Grouping and Ordering in Presentation Document

Path: /assembly/java/in-table-list-with-filtering-grouping-and-ordering-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList with Filtering, Grouping, and Ordering report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Microsoft PowerPoint Document

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practising the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x2 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent managers' contract information with the following key requirements:

*   Report must show each manager along with sum of prices of his contracts.
*   It must represent all the information in tabular form.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Manager/Client</b></td>
			<td style="background-color: #5B9BD5"><b>Contract Price</b></td>
		</tr>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;foreach [in getContracts()<br>   .where(c => c.getDate().getYear() + 1900 == 2015)<br>   .groupBy(c => c.getManager())<br>   .orderBy(g => g.key.getName())]>>&lt;&lt;[key.getName()]>></b></td>
			<td style="background-color: #D2DEEF">&lt;&lt;[sum(c => c.getPrice())]>>&lt;&lt;/foreach>></td>
		</tr>
	</tbody>
</table>

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 845d7d45c8593f13c7f96a4046f7d0d4 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Filtering Grouping and Ordering in Presentation Document

Path: /assembly/net/in-table-list-with-filtering-grouping-and-ordering-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList with Filtering, Grouping, and Ordering report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Microsoft PowerPoint Document

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practicing the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x2 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with the following key requirements:

*   Report must show each customer along with sum of prices of his orders.
*   It must represent all the information in tabular form.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.Where(c =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">c.OrderDate.Year</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> == 2015)</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">GroupBy</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">(c =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">c.Customer</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">)</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">OrderBy</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">(g =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">g.Key.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">)]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Key.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.pptx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB.pptx?raw=true) (Template for DataSet, DataBase examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_XML.pptx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML.pptx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 1e1ef3637a089d4122c1ee0d44a70694 >}}

#### Database Entities

{{< gist GroupDocsGists 30d5732e97750bfbb2869abfec3b2386 >}}

#### Using DataSet

{{< gist GroupDocsGists a1f1a15c7403b3a4596c807b2cbd6cc2 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 056789927f17efeef5c4f0c36789a573 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 03d6e4df63296f1e264d64398e1626e8 >}}

## In-Table List with Filtering, Grouping, and Ordering in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List with Filtering, Grouping, and Ordering' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List with Filtering, Grouping, and Ordering\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_OpenDocument.odp?raw=true) (use same template for JSON examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_DB\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_DB_OpenDocument.odp?raw=true) (use same template for dataset examples)
*   [In-Table List with Filtering, Grouping, and Ordering\_XML\_OpenDocument.odp](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_XML_OpenDocument.odp?raw=true)

### Generating the report

#### Custom Objects

{{< gist GroupDocsGists 219e44bbbdaa47fd2c44d8daa8777ad8 >}}

#### Database Entities

{{< gist GroupDocsGists adfebece8a3ccb862dae9cb34190358d >}}

#### Using DataSet

{{< gist GroupDocsGists 761846a85c302e6c79a1526fd7e3a789 >}}

#### Using XML DataSource

{{< gist GroupDocsGists c09373ff60e9118ef52524bce28856eb >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 9e96301cb900c49f6e4a8ff68026c9fc >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Highlighted Rows in Presentation Document

Path: /assembly/java/in-table-list-with-highlighted-rows-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList with Highlighted Rows report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List with Highlighted Rows in Microsoft PowerPoint Document

### Creating a In-Table List with Highlighted Rows

Practising the following steps you can create In-Table List with Highlighted Rows Template in MS PowerPoint 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Click the cell you want to highlight.
5.  Click "Design" tab, and then select Shading.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show all the client names with price.
*   Show single client and his single contract price in a single row.
*   It must highlight the record with contract price more than or equal to 1000000.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="608" style="width: 456pt; border-collapse: collapse;"><tbody><tr><td width="371" valign="top" style="width: 278pt; border-top-color: white; border-top-style: solid; border-top-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b>Client</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: white; border-top-style: solid; border-top-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 3pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b>Contract Price</b></p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(244, 177, 131); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b>&lt;&lt;foreach [in getContracts()]&gt;&gt;&lt;&lt;if [getPrice() &gt;= 1000000]&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(244, 177, 131); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal">&lt;&lt;[getPrice()]&gt;&gt;</p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b>&lt;&lt;else&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(234, 239, 247); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal">&lt;&lt;[getPrice()]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal"><b>Total:</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(210, 222, 239); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal">&lt;&lt;[getContracts().sum(</p><p class="MsoNormal">&nbsp; c =&gt; c.getPrice())]&gt;&gt;</p></td></tr></tbody></table>
### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we created in this article:

*   [In-Table List with Highlighted Rows.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 8e04684db89b558017267c359517e314 >}}



### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table List with Highlighted Rows in Presentation Document

Path: /assembly/net/in-table-list-with-highlighted-rows-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table List with Highlighted Rows report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List with Highlighted Rows in Microsoft PowerPoint Document

### Creating a In-Table List with Highlighted Rows

Practising the following steps you can create In-Table List with Highlighted Rows Template in MS PowerPoint 2013.

1.  Click the document where you want to add the table.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Click the cell you want to highlight.
5.  Click "Design" tab, and then select Shading.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with a specific filtering condition with the following key requirements:

*   The report must show each customer along with his orders.
*   Show single Customer and his single order price in a single row.
*   It must highlight the record with order price more than or equal to 400.
*   It must show sum of the order prices.
*   It must represent all the information in tabular form.
*   The report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;if [Price &gt;= 400]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we created in this article:

*   [In-Table List with Highlighted Rows.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows.pptx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table List with Highlighted Rows\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DB.pptx?raw=true) (Template for DataBase examples)
*   [In-Table List with Highlighted Rows\_DT.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DT.pptx?raw=true) (Template for DataSet examples)
*   [In-Table List with Highlighted Rows\_XML.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows_XML.pptx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 6c9a7b0f22f85c29c1c1f6e4994073ca >}}

#### Database Entities

{{< gist GroupDocsGists 4e2826a3c2143ceb231b81de1dbf1888 >}}

#### Using DataSet

{{< gist GroupDocsGists b493c17b2cd880cf9474330e5b38d589 >}}

#### Using XML DataSource

{{< gist GroupDocsGists f00ea737e6110ae20d49cc96ca16aaa1 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 74597aecd5f61ee02e79cb9d8a0aa8e4 >}}

## In-Table List with Highlighted Rows in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table List with Highlighted Rows' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table List with Highlighted Rows\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows_OpenDocument.odp?raw=true) (use same template for jSON examples)
*   [In-Table List with Highlighted Rows\_DB\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DB_OpenDocument.odp?raw=true)
*   [In-Table List with Highlighted Rows\_DT\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows_DT_OpenDocument.odp?raw=true)
*   [In-Table List with Highlighted Rows\_XML\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20List%20with%20Highlighted%20Rows_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists ab8144a4b96be686267266e949f27b38 >}}

#### Database Entities

{{< gist GroupDocsGists a9759f4545a8a8f31a315974452227e4 >}}

#### Using DataSet

{{< gist GroupDocsGists 501eb296df9ba05452d2c7fab86ed09a >}}

#### Using XML DataSource

{{< gist GroupDocsGists 226dcd4386e52e2436d7e83a2901bfd2 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 815abd417bc7e470369c133944a7d317 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table Master-Detail in Presentation Document

Path: /assembly/java/in-table-master-detail-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableMaster-Detail report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in Microsoft PowerPoint Document

### Creating a In-Table Master-Detail

Practising the following steps you can create In-Table Master-Detail Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Click the document where you want to add the table.
3.  Press "Insert" tab to insert the table.
4.  Insert a 2x4 table.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show each manager along with his total contract prices.
*   It must also show each individual client within the contract.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Manager/Client</b></td>
			<td style="background-color: #5B9BD5"><b>Contract Price</b></td>
		</tr>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;foreach [in getManagers()]>>&lt;&lt;[getName()]>></b></td>
			<td style="background-color: #D2DEEF">&lt;&lt;[getContracts().sum(c => c.getPrice())]>></td>
		</tr>
    <tr>
			<td style="background-color: #5B9BD5"><i>&lt;&lt;foreach [in getContracts()]>>  &lt;&lt;[getClient().getName()]>></i></td>
			<td style="background-color: #EAEFF7">&lt;&lt;[getPrice()]>>&lt;&lt;/foreach>>&lt;&lt;/foreach>></td>
		</tr>
    <tr>
			<td style="background-color: #5B9BD5"><b>Total:</b></td>
			<td style="background-color: #D2DEEF">&lt;&lt;[getManagers().sum(m => m.getContracts().sum(c => c.getPrice()))]>></td>
		</tr>
	</tbody>
</table>

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/In-Table%20Master-Detail.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 8ecd459de8afc880b7264a56a2476f6e >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## In-Table Master-Detail in Presentation Document

Path: /assembly/net/in-table-master-detail-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table Master-Detail report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in Microsoft PowerPoint Document

### Creating a In-Table Master-Detail

Practising the following steps you can create In-Table Master-Detail Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Click the document where you want to add the table.
3.  Press "Insert" tab to insert the table.
4.  Insert a 2x4 table.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent customers' total orders prices and price of each product separately with the following key requirements:

*   The report must show each customer along with his total orders prices.
*   It must also show each individual product ordered by the customers.
*   It must show the sum of the order prices.
*   It must represent all the information in tabular form.
*   The report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in customers]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-style: italic;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-style: italic;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-style: italic;"> [in Order]&gt;&gt; &lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-style: italic;">Product.ProductName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-style: italic;">]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;&lt;&lt;</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">m =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">m.Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail.pptx?raw=true) (Template for CustomObject and JSON examples)
*   [In-Table Master-Detail\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail_DB.pptx?raw=true) (Template for DataBase examples)
*   [In-Table Master-Detail\_DT.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail_DT.pptx?raw=true) (Template for DataSet examples)
*   [In-Table Master-Detail\_XML.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail_XML.pptx?raw=true) (Template for XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists c9c8b151dd0e46be909be454a6726049 >}}

#### Database Entities

{{< gist GroupDocsGists de3833fac1caad796cf165a8bae6456b >}}

#### Using DataSet

{{< gist GroupDocsGists 82d6372ad526fe33d0993be1300bbb43 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 1f5520cbc9f6793fa423eda6e936b77a >}}

#### Using JSON DataSource

{{< gist GroupDocsGists facbd1591cf19cc15961a3e40a4a50b5 >}}

## In-Table Master-Detail in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we 'll not reinvent the wheel to recreate a template for generating an 'In-Table Master-Detail' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [In-Table Master-Detail\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail_OpenDocument.odp?raw=true) (use same template for JSON examples)
*   [In-Table Master-Detail\_DB\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail_DB_OpenDocument.odp?raw=true)
*   [In-Table Master-Detail\_DT\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail_DT_OpenDocument.odp?raw=true)
*   [In-Table Master-Detail\_XML\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/In-Table%20Master-Detail_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists dbae5688546ba5feaa8326b2cd74ab9c >}}

#### Database Entities

{{< gist GroupDocsGists d843d458b5c9c8c85b6f2d8d35bfd569 >}}

#### Using DataSet

{{< gist GroupDocsGists 4d95131b1ff98587b3482abe85ed78b5 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 3e380308021b5b5306244a30aabab2d9 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists e41f5bc6342e8b91b48a1a426918b2fe >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Individual Series Point Coloring in Spreadsheet Document

Path: /assembly/java/individual-series-point-coloring-in-spreadsheet-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Spreadsheet Document

Please follow below steps to can create Pie Chart in MS Excel 2013.

1.  Add a new Workbook
2.  Click on the workbook where you want to insert the chart, click the "Insert" tab, and then click "Pie Chart Icon" in the charts group
3.  A drop-down with charts will appear, select the "Pie" and press "OK" to insert the chart
4.  Click on the chart you just inserted, then click the "Change Data" icon in Data group
5.  Now add legend entries. See [Chart Data](https://docs.dynabic.com/display/assemblynet/Pie+Chart+in+Spreadsheet+Document#PieChartinSpreadsheetDocument-ChartData)
6.  Save your Document

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Spreadsheet Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data

**Legend Entries**

```java
="Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor[color]>>"
```

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Dynamic%20Chart%20Point%20Series%20Color.xlsx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```java
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists c89788f56c4881a270764bdc0aee2bfd >}}



---

## Individual Series Point Coloring in Spreadsheet Document

Path: /assembly/net/individual-series-point-coloring-in-spreadsheet-document/

{{< alert style="info" >}}This feature is supported by version 18.5 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Spreadsheet Document

Please follow below steps to can create Pie Chart in MS Excel 2013.

1.  Add a new Workbook
2.  Click on the workbook where you want to insert the chart, click the "Insert" tab, and then click "Pie Chart Icon" in the charts group
3.  A drop-down with charts will appear, select the "Pie" and press "OK" to insert the chart
4.  Click on the chart you just inserted, then click the "Change Data" icon in Data group
5.  Now add legend entries. See [Chart Data](https://docs.dynabic.com/display/assemblynet/Pie+Chart+in+Spreadsheet+Document#PieChartinSpreadsheetDocument-ChartData)
6.  Save your Document

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Spreadsheet Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

####  Chart Data
**Legend Entries**

```csharp
="Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor[color]>>"
```

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Dynamic%20Chart%20Point%20Series%20Color.xlsx) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```csharp
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists 0d47085c93fbc137e03d6f586f3fecd4 >}}



---

## Installation

Path: /total/python-net/installation/


## Install Package from PyPI

PyPI (Python Package Index) is a repository of software packages for the Python programming language. Visit the [groupdocs-total-net](https://pypi.org/project/groupdocs-total-net/) package page for more details. 

### Installing the Package

To install the package, open a terminal and run the following command:

{{< tabs "example1">}}
{{< tab "Windows" >}}
```bash
py -m pip install groupdocs-total-net
```
{{< /tab >}}
{{< /tabs >}}

When running the command on Windows, you can expect an output similar to the following:

```bash
Collecting groupdocs-total-net
  Using cached groupdocs_total_net-25.12.0-py3-none-any.whl.metadata (5.2 kB)
Collecting groupdocs-conversion-net==24.12 (from groupdocs-total-net)
...
Successfully installed groupdocs-assembly-net-25.5.1 groupdocs-comparison-net-25.12 groupdocs-conversion-net-25.12 groupdocs-merger-net-25.3 groupdocs-metadata-net-25.10 groupdocs-redaction-net-25.10 groupdocs-signature-net-25.4 groupdocs-total-net-25.12 groupdocs-viewer-net-25.12 groupdocs-watermark-net-25.12
```

### Adding the Package to requirements.txt

You can add the dependency to your `requirements.txt` file by including the following line:

```bash
groupdocs-total-net==25.12
```

Then, install the package using this command:

```bash
pip install -r requirements.txt
```

## Download Package from Official Website

To download the GroupDocs.Total metapackage, please visit the official [GroupDocs Releases website](https://releases.groupdocs.com/total/python-net/).  
You can also download individual packages from their respective product pages:

* [groupdocs-conversion-net](https://releases.groupdocs.com/conversion/python-net/#direct-download)
* [groupdocs-viewer-net](https://releases.groupdocs.com/viewer/python-net/#direct-download)
* [groupdocs-comparison-net](https://releases.groupdocs.com/comparison/python-net/#direct-download)
* [groupdocs-watermark-net](https://releases.groupdocs.com/watermark/python-net/#direct-download)
* [groupdocs-metadata-net](https://releases.groupdocs.com/metadata/python-net/#direct-download)
* [groupdocs-merger-net](https://releases.groupdocs.com/merger/python-net/#direct-download)
* [groupdocs-assembly-net](https://releases.groupdocs.com/assembly/python-net/#direct-download)
* [groupdocs-redaction-net](https://releases.groupdocs.com/redaction/python-net/#direct-download)
* [groupdocs-signature-net](https://releases.groupdocs.com/signature/python-net/#direct-download)

Make sure to select the package that matches your system’s architecture.

### Copy the Downloaded File

After downloading, copy the package file into your project folder.

#### Install the groupdocs-total-net Metapackage

The following example shows how to install **GroupDocs.Total for Python via .NET** after downloading the `.whl` file:

{{< tabs "example2">}}
{{< tab "Windows" >}}
```powershell
py -m pip install groupdocs_total_net-25.12-py3-none-any.whl
```
{{< /tab >}}
{{< /tabs >}}

Expected output:

```bash
Processing groupdocs_total_net-25.12.0-py3-none-any.whl
...
Successfully installed groupdocs-comparison-net-25.12 groupdocs-conversion-net-25.12 groupdocs-metadata-net-25.10 groupdocs-redaction-net-25.10 groupdocs-total-net-25.12 groupdocs-viewer-net-25.12 groupdocs-watermark-net-25.12  
```

#### Install an Individual Package File

The following examples show how to install **GroupDocs.Conversion for Python via .NET** depending on your operating system:

{{< tabs "example3">}}
{{< tab "Windows (64-bit)" >}}
```powershell
py -m pip install groupdocs_conversion_net-24.12-py3-none-win_amd64.whl
```
{{< /tab >}}
{{< tab "Windows (32-bit)" >}}
```powershell
py -m pip install groupdocs_conversion_net-24.12-py3-none-win32.whl
```
{{< /tab >}}
{{< tab "macOS (Apple Silicon)" >}}
```bash
python3 -m pip install groupdocs_conversion_net-24.12-py3-none-macosx_11_0_arm64.whl
```
{{< /tab >}}
{{< tab "macOS (Intel)" >}}
```bash
python3 -m pip install groupdocs_conversion_net-24.12-py3-none-macosx_10_14_x86_64.whl
```
{{< /tab >}}
{{< /tabs >}}

Expected output:

```bash
Processing groupdocs_conversion_net-24.12-py3-none-win_amd64.whl
...
Successfully installed groupdocs-conversion-net-24.12
```

## Troubleshooting

If you encounter issues during installation, try the following steps:

* Ensure that the proper Python version is installed — see the [System Requirements]({{< ref "/total/python-net/getting-started/system-requirements.md" >}}) page for details.
* Contact us using any of the channels listed in the [Technical Support]({{< ref "/total/python-net/technical-support" >}}) section.

---

## Installation (build tools)

Path: /metadata/java/installation/

## Development environment

### Operating systems

**GroupDocs.Metadata for Java** can be executed on any Operating System with Java JDK installed.

*   Windows Desktops and Servers
*   Linux
*   Mac OS

### Supported runtime

**GroupDocs.Metadata for Java** supports Java run-time version 7 (1.7) and above.

### Development environments

*   NetBeans
*   IntelliJ IDEA
*   Eclipse

## Installation from GroupDocs artifactory using Maven

GroupDocs hosts all Java APIs on [GroupDocs Artifactory](https://releases.groupdocs.com/java/repo/). You can easily use [GroupDocs.Metadata for Java](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-metadata/) API directly in your Maven projects with simple configurations.

### Specify GroupDocs repository configuration

First, you need to specify repository configuration/location in your project as follows:

{{< tabs "example1">}}
{{< tab "Maven" >}}
```xml
<repositories>
	<repository>
		<id>GroupDocs Artifact Repository</id>
        	<name>GroupDocs Artifact Repository</name>
        	<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
repositories {
    maven {
        url "https://repository.groupdocs.com/repo/"
    }
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
repositories {
    maven(url = "https://repository.groupdocs.com/repo/")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Metadata for Java as a dependency

Then define GroupDocs.Metadata for Java API dependency in your pom.xml as follows:

{{< tabs "example2">}}
{{< tab "Maven" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-metadata</artifactId>
        <version>24.5</version>
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
dependencies {
    implementation 'com.groupdocs:groupdocs-metadata:24.5'
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
dependencies {
    implementation("com.groupdocs:groupdocs-metadata:24.5")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<dependency org="com.groupdocs" name="groupdocs-metadata" rev="24.5">
   <artifact name="groupdocs-metadata" ext="jar"/>
</dependency>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
libraryDependencies += "com.groupdocs" % "groupdocs-metadata" % "24.5"
```
{{< /tab >}}
{{< /tabs >}}

After performing above-mentioned steps, the GroupDocs.Metadata for Java dependency will finally be added to your Maven project.

_The latest version of Metadata API can be [found here](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-metadata/) _

---

## Installation (manual)

Path: /metadata/java/installation-manual/


## Installation without build tools (manual JAR setup)

If you don’t use Maven/Gradle/Ivy/SBT, you can add **GroupDocs.Metadata for Java** to the classpath manually.

### 1) Download the JAR

1. Go to the latest version of **groupdocs-metadata** in the GroupDocs Java repository.
2. Download `groupdocs-metadata-<version>.jar`.

### 2) Add the JAR to your project

**IntelliJ IDEA**

1. *File* → *Project Structure* → *Modules* → *Dependencies*.
2. Click **+** → **JARs or directories** and select the downloaded JAR.

**Eclipse**

1. Right-click the project → *Properties* → *Java Build Path* → *Libraries*.
2. Click **Add External JARs…** and select the downloaded JAR.

**NetBeans**

1. Right-click *Libraries* in your project.
2. Choose **Add JAR/Folder…** and select the downloaded JAR.

> You can place the JAR anywhere in your project (e.g., `lib/`) and add it to the module/classpath.

### 3) Compile and run from the command line

Place the JAR under `lib/` (or another folder) and use the appropriate classpath separator for your OS.

**Windows (CMD/PowerShell):**

```bash
javac -cp .;lib\groupdocs-metadata-<version>.jar Example.java
java  -cp .;lib\groupdocs-metadata-<version>.jar Example path\to\file.pdf
```

**macOS/Linux (bash/zsh):**

```bash
javac -cp .:lib/groupdocs-metadata-<version>.jar Example.java
java  -cp .:lib/groupdocs-metadata-<version>.jar Example /path/to/file.pdf
```

### 4) Minimal example to verify the setup

```java
import com.groupdocs.metadata.Metadata;
import com.groupdocs.metadata.core.FileFormat;
import com.groupdocs.metadata.core.IDocumentInfo;

public class Example {
    public static void main(String[] args) {
        if (args.length == 0) {
            System.out.println("Usage: java Example <path-to-file>");
            return;
        }
        try (Metadata metadata = new Metadata(args[0])) {
            if (metadata.getFileFormat() != FileFormat.Unknown) {
                IDocumentInfo info = metadata.getDocumentInfo();
                System.out.println("Format: " + info.getFileType().getFileFormat());
                System.out.println("Extension: " + info.getFileType().getExtension());
                System.out.println("Pages: " + info.getPageCount());
                System.out.println("Size (bytes): " + info.getSize());
                System.out.println("Encrypted: " + info.isEncrypted());
            }
        }
    }
}
```

### 5) Licensing (optional)

You can use the library in trial mode with evaluation limitations. To remove limitations, apply a license (file or Metered) in your application according to the **Licensing** guide.

---

## Load a file of a specific format

Path: /markdown/net/load-a-file-of-a-specific-format/


By default, GroupDocs.Markdown detects the file format automatically from the file extension or stream content. When you want to skip auto-detection or the file extension is missing, specify the format explicitly using `LoadOptions`.

{{< tabs "load-specific-format">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Explicitly specify the format to skip auto-detection
var loadOptions = new LoadOptions(FileFormat.Xlsx);

using var converter = new MarkdownConverter("cost-analysis.xlsx", loadOptions);
converter.Convert("load-specific-format.md");
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/loading/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-specific-format.md" >}}  
```text
## Summary

| Category | FY2024 | FY2025 | FY2026 |
| --- | --- | --- | --- |
| Parts and materials | $1,325,000.00 | $1,480,000.00 | $1,620,000.00 |
| Manufacturing equipment | $900,500.00 | $980,000.00 | $1,050,000.00 |
| Warehousing | $420,000.00 | $510,000.00 | $590,000.00 |
| Shipping | $380,000.00 | $445,000.00 | $520,000.00 |
| Marketing | $250,000.00 | $340,000.00 | $480,000.00 |
| R&D | $180,000.00 | $230,000.00 | $310,000.00 |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-a-file-of-a-specific-format/LoadSpecificFormat/load-specific-format.md)
{{< /tab >}}
{{< /tabs >}}

### Available FileFormat values

The `FileFormat` enum includes the following values:

| Category | Values |
|---|---|
| Word Processing | `Doc`, `Docx`, `Docm`, `Dot`, `Dotx`, `Dotm`, `Rtf`, `Odt`, `Ott` |
| Spreadsheet | `Xlsx`, `Xls`, `Xlsb`, `Xlsm`, `Csv`, `Tsv`, `Ods`, `Ots` |
| PDF | `Pdf` |
| E-book | `Epub`, `Mobi` |
| Text | `Txt` |
| Help | `Chm` |

You can also retrieve supported formats programmatically:

{{< tabs "load-supported-formats">}}
{{< tab "C#" >}}
```csharp
using System.Collections.Generic;
using GroupDocs.Markdown;

IReadOnlyList<FileFormat> formats = MarkdownConverter.GetSupportedFormats();
foreach (FileFormat fmt in formats)
    Console.WriteLine(fmt);
```
{{< /tab >}}
{{< tab "load-supported-formats.txt" >}}  
```text
Doc
Docx
Docm
Dot
Dotx
Dotm
Rtf
Odt
Ott
Xlsx
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-a-file-of-a-specific-format/LoadSupportedFormats/load-supported-formats.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Load a file of a specific format

Path: /markdown/python-net/load-a-file-of-a-specific-format/


By default, GroupDocs.Markdown detects the file format automatically from the file extension or stream content. When you want to skip auto-detection or the file extension is missing, specify the format explicitly using `LoadOptions`.

{{< tabs "load-specific-format">}}
{{< tab "load_specific_format.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, LoadOptions, FileFormat

def load_specific_format():
    """Load a file with an explicitly specified format, skipping auto-detection."""

    # Step 1: Create load options with the explicit file format
    load_options = LoadOptions(FileFormat.XLSX)

    # Step 2: Open the file with load options using keyword argument
    with MarkdownConverter("cost-analysis.xlsx", load_options=load_options) as converter:
        # Step 3: Convert and save the Markdown output
        converter.convert("load-specific-format.md")

if __name__ == "__main__":
    load_specific_format()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/loading/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-specific-format.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-file-of-a-specific-format/load_specific_format/load-specific-format.txt)
{{< /tab >}}
{{< tab "load-specific-format.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-file-of-a-specific-format/load_specific_format/load-specific-format.txt)
{{< /tab >}}
{{< /tabs >}}

### Available FileFormat values

The `FileFormat` enum includes the following values:

| Category | Values |
|---|---|
| Word Processing | `DOC`, `DOCX`, `DOCM`, `DOT`, `DOTX`, `DOTM`, `RTF`, `ODT`, `OTT` |
| Spreadsheet | `XLSX`, `XLS`, `XLSB`, `XLSM`, `CSV`, `TSV`, `ODS`, `OTS` |
| PDF | `PDF` |
| E-book | `EPUB`, `MOBI` |
| Text | `TXT` |
| Help | `CHM` |

You can also retrieve supported formats programmatically:

{{< tabs "get-supported-formats">}}
{{< tab "get_supported_formats.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def get_supported_formats():
    """List all file formats supported by GroupDocs.Markdown."""

    # Step 1: Retrieve the list of supported formats
    formats = MarkdownConverter.get_supported_formats()

    # Step 2: Print each supported format
    for fmt in formats:
        print(fmt)

if __name__ == "__main__":
    get_supported_formats()
```
{{< /tab >}}
{{< /tabs >}}

---

## Load a file of a specific format

Path: /metadata/java/load-a-file-of-a-specific-format/

This example demonstrates how to load a file of some particular format.

**advanced\_usage.loading\_files.LoadingFileOfSpecificFormat**

```csharp
// Explicitly specifying the format of a file to load you can spare some time on detecting the format
LoadOptions loadOptions = new LoadOptions(FileFormat.Spreadsheet);
// Constants.InputXls is an absolute or relative path to your document. Ex: @"C:\Docs\source.xls"
try (Metadata metadata = new Metadata(Constants.InputXls, loadOptions)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();
	// Use format-specific properties to extract or edit metadata
	System.out.println(root.getDocumentProperties().getAuthor());
	// ...
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load a file of a specific format

Path: /metadata/net/load-a-file-of-a-specific-format/

This example demonstrates how to load a file of some particular format.

**AdvancedUsage.LoadingFiles.LoadingFileOfSpecificFormat**

```csharp
// Explicitly specifying the format of a file to load you can spare some time on detecting the format
var loadOptions = new LoadOptions(FileFormat.Spreadsheet);

// Constants.InputXls is an absolute or relative path to your document. Ex: @"C:\Docs\source.xls"
using (Metadata metadata = new Metadata(Constants.InputXls, loadOptions))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	// Use format-specific properties to extract or edit metadata
	Console.WriteLine(root.DocumentProperties.Author);

	// ...
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load a file of a specific format

Path: /metadata/nodejs-java/load-a-file-of-a-specific-format/

This example demonstrates how to load a file of some particular format.

**advanced\_usage.loading\_files.LoadingFileOfSpecificFormat**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
try {
	var loadOptions = new LoadOptions(FileFormat.Spreadsheet);
    const metadata = new groupdocs.metadata.Metadata("input.xls", loadOptions);
	var root = metadata.getRootPackageGeneric();
  }
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load a file of a specific format

Path: /metadata/python-net/load-a-file-of-a-specific-format/

This example demonstrates how to load a file of some particular format.

**advanced_usage.loading_files.loading_file_of_specific_format**


```python
def run():
    # Explicitly specifying the format of a file to load can spare time on detecting the format
    load_options = gm.LoadOptions(gm.common.FileFormat.SPREADSHEET)

    # constants.input_xls is an absolute or relative path to your document. Ex: r"C:\\Docs\\source.xls"
    with gm.Metadata(constants.input_xls, load_options) as metadata:
        root = metadata.get_root_package()

        # Use format-specific properties to extract or edit metadata
        print(root.document_properties.author)

        # ...
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Load document from stream

Path: /parser/net/load-document-from-stream/

There might be cases when the document is presented only as a stream (without a copy on the local disk). To avoid the overhead of saving documents to the disk, GroupDocs.Parser enables to extract data from streams directly.

The following example shows how to load the document from the stream:

```csharp
// Create an instance of Parser class with the stream
using (Parser parser = new Parser(stream))
{
    // Extract a text into the reader
    using (TextReader reader = parser.GetText())
    {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Load document from url

Path: /parser/net/load-document-from-url/


To avoid the overhead of saving documents to the disk, GroupDocs.Parser enables to extract data from url directly.

The following example shows how to load the document from the url:

```csharp
// Create an instance of Parser class with the url
using (Parser parser = new Parser(url))
{
    // Extract a text into the reader
    using (TextReader reader = parser.GetText())
    {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Load document from URL

Path: /annotation/java/load-document-from-url/


The following example shows how to load a document using its URL:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates loading document from URL.


String url = "https://raw.githubusercontent.com/groupdocs-annotation/GroupDocs.Annotation-for-Java/master/Examples/Resources/SampleFiles/input.pdf?raw=true";

// Create an instance of Annotator class
Annotator annotator = new Annotator(new URL(url).openStream());
try {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setBackgroundColor(65535);
    
    // Add annotation and save to file
    annotator.add(area);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load document from URL

Path: /annotation/net/load-document-from-url/


The following example shows how to load a document using URL:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
string url = "https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET/blob/master/Examples/Resources/SampleFiles/input.pdf?raw=true";


using (Annotator annotator = new Annotator(GetRemoteFile(url)))
{
	AreaAnnotation area = new AreaAnnotation()
	{
		Box = new Rectangle(100, 100, 100, 100),
		BackgroundColor = 65535,
	};
	annotator.Add(area);
	annotator.Save("result.pdf");
}

private static Stream GetRemoteFile(string url)
{
	WebRequest request = WebRequest.Create(url);
	using (WebResponse response = request.GetResponse())
		return GetFileStream(response);
}

private static Stream GetFileStream(WebResponse response)
{
	MemoryStream fileStream = new MemoryStream();
	using (Stream responseStream = response.GetResponseStream())
		responseStream.CopyTo(fileStream);
		fileStream.Position = 0;
		return fileStream;
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load document from URL

Path: /conversion/java/load-document-from-url/

The following code snippet shows how to convert a document from an URL:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.exceptions.GroupDocsConversionException;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import java.io.File;
import java.io.InputStream;
import java.net.URL;
...
String url = "https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java/blob/master/Examples/Resources/SampleFiles/sample.docx?raw=true";
String outputFile = "c:\\output\\converted.pdf";

try {
    InputStream stream = new URL(url).openStream();
    Converter converter = new Converter(stream);
    PdfConvertOptions options = new PdfConvertOptions();
    converter.convert(outputFile, options);

}catch(Exception e){
    throw new GroupDocsConversionException(e.getMessage());
}
```

---

## Load document from URL

Path: /conversion/nodejs-java/load-document-from-url/

The following code snippet shows how to convert a document from an URL:

```js
const fetch = require('node-fetch');

async function fetchUrl(url) {
    try {
        const response = await fetch(url);
        
        if (!response.ok) {
            throw new Error(`URL fetch error: ${response.statusText}`);
        }

        const stream = response.body;
        return stream;
    } catch (error) {
        throw new Error(error);
    }
}

const url = 'https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Node.js-via-Java/blob/master/Examples/Resources/SampleFiles/sample.docx?raw=true'

try {
    const stream = await fetchUrl(url)
    const converter = new groupdocs.conversion.Converter(stream);
    const convertOptions = new groupdocs.conversion.PdfConvertOptions();
    converter.convert('loadDocumentFromUrl.pdf', convertOptions);

}catch(e){
    throw new Error(e);
}
```

---

## Load document from URL

Path: /merger/java/load-document-from-url/

Following example demonstrates how to load document from URL.

```java
String url = "https://github.com/groupdocs-merger/GroupDocs.Merger-for-Java/blob/master/Examples/Resources/SampleFiles/Pdf/sample.pdf?raw=true";
try {
    InputStream stream = new java.net.URL(url).openStream();

    LoadOptions loadOptions = new LoadOptions(FileType.PDF);
    Merger merger = new Merger(stream, loadOptions);
    System.out.print("Document loaded from URL successfully.");
} catch ( Exception e){
    throw new GroupDocsMergerException(e.getMessage());
}
```

---

## Load document from URL

Path: /merger/net/load-document-from-url/

Following example demonstrates how to load document from URL.

```csharp
 		public static void Run()
        {
            string url = "https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET/blob/master/Examples/Resources/SampleFiles/Pdf/example.pdf?raw=true";
            
            using (Stream stream = GetRemoteFile(url))
            {
                using (Merger merger = new Merger(stream))
                {
                    Console.WriteLine($"Document loaded from URL successfully.");
                }
            }
        }

        private static Stream GetRemoteFile(string url)
        {
            //ServicePointManager.Expect100Continue = true;
            ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls
               | SecurityProtocolType.Tls11
               | SecurityProtocolType.Tls12
               | SecurityProtocolType.Ssl3;
            WebRequest request = WebRequest.Create(url);
            using (WebResponse response = request.GetResponse())
                return GetFileStream(response);
        }

        private static Stream GetFileStream(WebResponse response)
        {
            MemoryStream fileStream = new MemoryStream();
            using (Stream responseStream = response.GetResponseStream())
                responseStream.CopyTo(fileStream);
            fileStream.Position = 0;
            return fileStream;
        }
```

---

## Load document of specific format

Path: /watermark/java/load-document-of-specific-format/

The constructors [Watermarker(String)](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#Watermarker(java.lang.String)) and [Watermarker(InputStream)](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#Watermarker(java.io.InputStream)) can load a document of any supported format. When you're loading a document, GroupDocs.Watermark automatically detects its type and creates an instance of the appropriate class. If document format is not supported, constructor throws [UnsupportedFileTypeException](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.exceptions/UnsupportedFileTypeException). If you need specify the format of a document to load, you can use constructors with [LoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/LoadOptions) parameter.

The following examle demonstrates how to create a watermarker for the Spreadsheet document:

**advanced\_usage.loading\_documents.LoadingDocumentOfSpecificFormat**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
String filePath = "spreadsheet.xlsx";                                                                    
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                                
Watermarker watermarker = new Watermarker(filePath, loadOptions);                                                 
                                                                                                                  
// use watermarker methods to manage watermarks in the Spreadsheet document                                       
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));                             
                                                                                                                  
watermarker.add(watermark);                                                                                       
                                                                                                                  
watermarker.save("spreadsheet.xlsx");                                                                   
                                                                                                                  
watermarker.close();                                                                                            

```

Any supported format family has the specific [LoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/LoadOptions) descendant:

| Format | LoadOptions descendant |
| --- | --- |
| Diagram | [DiagramLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/DiagramLoadOptions) |
| Email | [EmailLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/EmailLoadOptions) |
| Image | [ImageLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/ImageLoadOptions) |
| GifImage | [GifImageLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/GifImageLoadOptions) |
| TiffImage | [TiffImageLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/TiffImageLoadOptions) |
| PDF | [PdfLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PdfLoadOptions) |
| Presentation | [PresentationLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PresentationLoadOptions) |
| Spreadsheet | [SpreadsheetLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/SpreadsheetLoadOptions) |
| WordProcessing | [WordProcessingLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingLoadOptions) |



---

## Load Email document with options

Path: /conversion/java/load-email-document-with-options/

This documentation describes how to load email documents with configurable options using [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/). It provides developers with the ability to process and convert email files (such as MSG, EML, and MBOX) into a variety of formats, including PDF, DOCX, HTML, and more.

The [EmailLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions) class allows customization of loading options, such as selecting specific email headers, managing attachments, and defining output parameters. These features enable precise control over email content rendering and conversion, making it a powerful tool for integrating email document handling capabilities into Java applications. The following options could be set:
| Option | Description |
|--------|-------------|
| [**setFormat()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions#setFormat(com.groupdocs.conversion.filetypes.EmailFileType)) | Allows you to specify explicitly the type of the source email document. Available options are: Msg, Eml, Emlx, Pst, Ost, Vcf, Mht. |
| [**setDisplayHeader()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions#setDisplayHeader(boolean)) | Specifies option to display or hide the email header. |
| [**setDisplayFromEmailAddress()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions#setDisplayFromEmailAddress(boolean)) | Specifies option to display or hide "from" email address. |
| [**setDisplayEmailAddress()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions#setDisplayEmailAddress(boolean)) | Specifies option to display or hide email address. |
| [**setDisplayToEmailAddress()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions#setDisplayToEmailAddress(boolean)) | Specifies option to display or hide "to" email address. |
| [**setDisplayCcEmailAddress()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions#setDisplayCcEmailAddress(boolean)) | Specifies option to display or hide "Cc" email address. |
| [**setDisplayBccEmailAddress()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/EmailLoadOptions#setDisplayBccEmailAddress(boolean)) | Specifies option to display or hide "Bcc" email address. |

### Control fields visibility

The following code snippet shows how to convert an Email document and control the visibility of the fields:

{{< tabs "code-example">}}
{{< tab "ConvertEmailWithAlteringFieldsVisibility.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.EmailLoadOptions;

public class ConvertEmailWithAlteringFieldsVisibility {
    public static void convert() {
        EmailLoadOptions loadOptions =  new EmailLoadOptions();
        loadOptions.setDisplayHeader(false);
        loadOptions.setDisplayFromEmailAddress(false);
        loadOptions.setDisplayToEmailAddress(false);
        loadOptions.setDisplayEmailAddress(false);
        loadOptions.setDisplayCcEmailAddress(false);
        loadOptions.setDisplayBccEmailAddress(false);

        try(Converter converter = new Converter("sample.msg", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_fields.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.msg" >}}  
{{< tab-text >}}
`sample.msg` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-email-document-with-options/sample.msg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_fields.pdf" >}}  
{{< tab-text >}}
`converted_with_fields.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-email-document-with-options/converted_with_fields.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Converting email attachments

The following code snippet shows how to convert an Email document and all attachments:

{{< tabs "code-example1">}}
{{< tab "ConvertEmailWithAttachments.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.SaveDocumentStreamForFileType;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.EmailLoadOptions;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.List;

public class ConvertEmailWithAttachments {
    public static void convert() throws IOException {
        EmailLoadOptions emailLoadOptions = new EmailLoadOptions();
        emailLoadOptions.setConvertOwned(true);
        emailLoadOptions.setConvertOwner(true);
        emailLoadOptions.setDepth(2);

        Converter converter=new Converter("embedded-attachment.eml", () ->emailLoadOptions);
        final List<FileOutputStream> fileOutputStreams = new ArrayList<>();
        try{
            final int[] index = {1};
            converter.convert((SaveDocumentStreamForFileType) t -> {
                try{
                    String fileName = index[0] == 1 ? "converted.pdf" : "converted-attachment-"+(index[0] - 1) +".pdf";
                    index[0]++;
                    FileOutputStream fileOutputStream = new FileOutputStream(fileName);
                    fileOutputStreams.add(fileOutputStream);
                    return fileOutputStream;
                } catch(java.io.FileNotFoundException e) {
                    throw new RuntimeException(e);
                }
            }, new PdfConvertOptions());
        }finally{
            for(OutputStream outputStream:fileOutputStreams){
                outputStream.close();
            }
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "embedded-attachment.eml" >}}  
{{< tab-text >}}
`embedded-attachment.eml` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-email-document-with-options/embedded-attachment.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.pdf" >}}  
{{< tab-text >}}
`converted.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-email-document-with-options/converted.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_attachments.pdf" >}}  
{{< tab-text >}}
`converted_attachments.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-email-document-with-options/converted-attachment-1.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


---

## Load Email document with options

Path: /conversion/net/load-email-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides the [EmailLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions) class to give you control over how the source email document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/format)** | The document type is auto-detected during loading, however, you can specify explicitly the type of the source email document. Available options are: Msg, Eml, Emlx, Pst, Ost, Vcf, Mht |
|**[ConvertOwned ](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/convertowned)** | Controls whether the owned documents in the documents container must be converted |
|**[ConvertOwner](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/convertowner)** | Controls whether the documents container itself must be converted If this property is true the documents container will be the first converted document |
|**[Depth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/depth)** | Controls how many levels in depth to perform the conversion |
|**[DisplayBccEmailAddress](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/displaybccemailaddress)** | Option to display or hide "Bcc" email address |
|**[DisplayCcEmailAddress](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/displayccemailaddress)** | Option to display or hide "Cc" email address |
|**[DisplayEmailAddress](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/displayemailaddress)** | Option to display or hide email address |
|**[DisplayFromEmailAddress](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/displayfromemailaddress)** | Option to display or hide "from" email address |
|**[DisplayHeader](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/displayheader)** | Option to display or hide the email header |
|**[DisplayToEmailAddress](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/displaytoemailaddress)** | Option to display or hide "to" email address |
|**[FieldTextMap](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/fieldtextmap)** | The mapping between email message [EmailField](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailfield) and field text representation |
|**[PreserveOriginalDate](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/preserveoriginaldate)** | defines whether to keep the original date header string in the mail message when saving (Default value is true) |
|**[ResourceLoadingTimeout](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/resourceloadingtimeout/)** | Specifies the timeout of loading the external resources. |
|**[TimeZoneOffset](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions/timezoneoffset)** | Gets or sets the Coordinated Universal Time (UTC) offset for the message dates. This property defines the time zone difference, between the local time and UTC. |

### Control fields visibility

The following code snippet shows how to convert an Email document and control the visibility of the fields:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new EmailLoadOptions
{
    DisplayHeader = false,
    DisplayFromEmailAddress = false,
    DisplayToEmailAddress = false,
    DisplayCcEmailAddress = false,
    DisplayBccEmailAddress = false
};
using (Converter converter = new Converter("sample.msg", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Converting email attachments

The following code snippet shows how to convert an Email document and all attachments:

```csharp
var source = "sample-with-attachment.eml";
var loadOptions = new EmailLoadOptions {
    ConvertOwner = true,
    ConvertOwned = true,
    // convert email itself and the attachments
    Depth = 2
};
using (var converter = new Converter(source, (LoadContext loadContext) => loadOptions))
{
    var index = 1;
    var options = new PdfConvertOptions();
    // Note: index = 1 is the email itself, all following indexes are attachments
    converter.Convert((SaveContext saveContext) => new FileStream($"converted-{index++}.{saveContext.TargetFormat.Extension}", FileMode.Create) , options);
}
```

### Localize email fields captions

The following code snippet shows how to convert an Email document and localize the Email fields:

```csharp
var source = "sample.eml";
var loadOptions = new EmailLoadOptions
{
    FieldTextMap = new Dictionary<EmailField, string>
    {
        { EmailField.Subject, "Gegenstand" },
        { EmailField.From, "Von" },
        { EmailField.Attachments, "Anhänge" }
    }
};
using (var converter = new Converter(source, (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf" , options);
}
```

### Control date/time format

The following code snippet shows how to convert an Email document and modify the date/time format:

```csharp
var source = "sample.eml";
CultureInfo.CurrentCulture = new CultureInfo("fr-FR");
using (var converter = new Converter(source))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf" , options);
}
```
---

## Load Email document with options

Path: /conversion/nodejs-java/load-email-document-with-options/

GroupDocs.Conversion provides [EmailLoadOptions](#) to give you control over how the source email document will be processed. The following options could be set:

*   **[**set**Format](#)** specifies the document type is auto-detected during loading, however, you can specify explicitly the type of the source email document. Available options are: Msg, Eml, Emlx, Pst, Ost, Vcf, Mht. 
*   **[**setD**isplayHeader](#)** specifies option to display or hide the email header.     
*   **[**setD**isplayFromEmailAddress](#)** specifies option to display or hide "from" email address.
*   **[**setD**isplayEmailAddress](#)** specifies option to display or hide email address
*   **[**setD**isplayToEmailAddress](#)** specifies option to display or hide "to" email address.
*   **[**setD**isplayCcEmailAddress](#)** specifies option to display or hide "Cc" email address.
*   **[setDisplayBccEmailAddress](#)** specifies  option to display or hide "Bcc" email address.

### Control fields visibility

The following code snippet shows how to convert an Email document and control the visibility of the fields:

```js
const outputPath = "ConvertEmailWithAlteringFieldsVisibility.pdf"

const loadOptions = new groupdocs.conversion.EmailLoadOptions();
loadOptions.setDisplayHeader(false);
loadOptions.setDisplayFromEmailAddress(false);
loadOptions.setDisplayToEmailAddress(false);
loadOptions.setDisplayEmailAddress(false);
loadOptions.setDisplayCcEmailAddress(false);
loadOptions.setDisplayBccEmailAddress(false);
loadOptions.setConvertOwned(false);

const converter = new groupdocs.conversion.Converter("sample.msg", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`Email document converted successfully to ${outputPath} (with altering fields visibility)`)
converter.convert(outputPath, convertOptions)
```

---

## Load File From Stream

Path: /conversion/python-net/developer-guide/loading-documents/load-file-from-stream/


To load a source file from a stream, you can use the `Converter` class constructor in GroupDocs.Conversion. The API provides several overloads to accommodate different settings and options:

* `Converter(file_stream)`
* `Converter(file_stream, load_options)`
* `Converter(file_stream, converter_settings)`
* `Converter(file_stream, load_options, converter_settings)`

Each constructor requires the `stream` parameter, which represents the input stream for the source file. This allows you to load documents directly from memory or other input sources. Be mindful that if the stream is not properly initialized or if it reaches the end unexpectedly, an exception will be raised.

{{< alert style="tip" >}}
GroupDocs.Conversion will access the stream only when an action (e.g., conversion) is performed using the `Converter` class instance.
{{< /alert >}}

## Example 1: Load file from stream with load options

The following Python example demonstrates loading a file from a stream and converting it to PDF. In this example we get and specify a default load options for DOCX file conversion:

{{< tabs "code-example-1">}}
{{< tab "load_file_from_stream.py" >}}  
```python
import os
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def get_file_stream(file_path: str):
    file_stream = open(file_path, "rb")
    return file_stream

def get_load_options(file_path: str):
    file_extension = os.path.splitext(file_path)[1]   
    possible_conversions = Converter.get_possible_conversions_by_extension(file_extension)
    load_options = possible_conversions.load_options
    return load_options

def load_file_from_stream():
    # Set file path
    file_path = "./annual-review.docx"

    # Retrieve file stream and load options
    file_stream = get_file_stream(file_path)
    load_options = get_load_options(file_path)

    # Specify source file stream and load options
    converter = Converter(file_stream, load_options)
    
    # Specify output file location and convert options
    output_path = "./annual-review.pdf"
    pdf_options = PdfConvertOptions()
    
    # Convert and save to output path
    converter.convert(output_path, pdf_options)

if __name__ == "__main__":
    load_file_from_stream()

```
{{< /tab >}}
{{< tab "annual-review.docx" >}}  
{{< tab-text >}}
`annual-review.docx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-file-from-stream/annual-review.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "annual-review.pdf" >}}  
{{< tab-text >}}
`annual-review.pdf` is converted PDF document. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-file-from-stream/annual-review.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation

- **Retrieve File Stream**: The method `get_file_stream` retrieves a file stream from a storage. 
- **Retrieve Load Options**: The method `get_load_options` retrieves a default load options based on file extension. 
- **Load Source File**: The `Converter` class is instantiated with the source documents stream and load options.
- **Conversion Options**: An instance of `PdfConvertOptions` is created to define the settings for PDF conversion.
- **Execute Conversion**: The `convert` method is used to convert the document and save it to the specified output path ("annual-review.pdf").

## Example 2: Load file from stream and detect file type automatically

When loading a document from stream GroupDocs.Conversion can detect the file type automatically in most cases.

{{< alert style="warning" >}}
Depending on the file type and size, automatic file type detection consumes additional resources such as memory and CPU time. Therefore, we recommend specifying the file type whenever you know the source file type. See `Example 1: Load file from stream with load options` that demonstrates how to specify load options.
{{< /alert >}}

The following Python example demonstrates loading a file from a stream and converting it to PDF:

{{< tabs "code-example-2">}}
{{< tab "detect_file_type_automatically.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def get_file_stream(file_path: str):
    file_stream = open(file_path, "rb")
    return file_stream

def detect_file_type_automatically():
    # Retrieve file stream
    file_path = "./annual-review.docx"
    file_stream = get_file_stream(file_path)

    # Specify source file location
    converter = Converter(file_stream)
    
    # Specify output file location and convert options
    output_path = "./annual-review.pdf"
    pdf_options = PdfConvertOptions()
    
    # Convert and save to output path
    converter.convert(output_path, pdf_options)

if __name__ == "__main__":
    detect_file_type_automatically()
```
{{< /tab >}}
{{< tab "annual-review.docx" >}}  
{{< tab-text >}}
`annual-review.docx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-file-from-stream/annual-review.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "annual-review.pdf" >}}  
{{< tab-text >}}
`annual-review.pdf` is converted PDF document. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-file-from-stream/annual-review.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation

- **Retrieve File Stream**: The method `get_file_stream` retrieves a file stream from storage. 
- **Load Source File**: The `Converter` class is instantiated with the source documents stream.
- **Conversion Options**: An instance of `PdfConvertOptions` is created to define the settings for PDF conversion.
- **Execute Conversion**: The `convert` method is used to detect file type of the source document stream, convert the document and save it to the specified output path ("annual-review.pdf").

Refer to the [GroupDocs.Conversion API Reference](https://reference.groupdocs.com/conversion/python-net/) for more details on using load options and other constructor overloads.

---

## Load file from URL

Path: /conversion/net/load-file-from-url/

The following code snippet shows how to convert a file from an URL:

```csharp
public static void Run()
{
    string url = "https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/blob/master/Examples/Resources/SampleFiles/sample.docx?raw=true";
    string outputFile = Path.Combine(@"c:\output", "converted.pdf");
    using (Converter converter = new Converter(() => GetRemoteFile(url)))
    {
        PdfConvertOptions options = new PdfConvertOptions();
        converter.Convert(outputFile, options);
    }
}
        
private static Stream GetRemoteFile(string url)
{
    WebRequest request = WebRequest.Create(url);
    using (WebResponse response = request.GetResponse())
        return GetFileStream(response);
}

private static Stream GetFileStream(WebResponse response)
{
    MemoryStream fileStream = new MemoryStream();
    using (Stream responseStream = response.GetResponseStream())
        responseStream.CopyTo(fileStream);
    fileStream.Position = 0;
    return fileStream;
}
```

---

## Load from URL

Path: /viewer/java/load-document-from-url/

The following code snippet shows how to load a document from a URL:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

URL url = new URL("https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java/blob/master/Examples/Resources/SampleFiles/sample.docx?raw=true");
try (Viewer viewer = new Viewer(url)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load from URL

Path: /viewer/net/load-document-from-url/

The following code snippet shows how to load a document from a URL:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using System.Net;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

string url = "https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/blob/master/Examples/GroupDocs.Viewer.Examples.CSharp/Resources/SampleFiles/sample.docx?raw=true";

Stream stream = DownloadFile(url);

using (Viewer viewer = new Viewer(stream, new LoadOptions(FileType.DOCX)))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}

static Stream DownloadFile(string url)
{
    WebRequest request = WebRequest.Create(url);
    using (WebResponse response = request.GetResponse())
        return GetFileStream(response);
}

static Stream GetFileStream(WebResponse response)
{
    MemoryStream fileStream = new MemoryStream();
    using (Stream responseStream = response.GetResponseStream())
        responseStream.CopyTo(fileStream);
    fileStream.Position = 0;
    return fileStream;
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports System.Net
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())

        Dim url As String = "https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/blob/master/Examples/GroupDocs.Viewer.Examples.CSharp/Resources/SampleFiles/sample.docx?raw=true"

        Dim stream As Stream = DownloadFile(url)

        Using viewer As New Viewer(stream, new LoadOptions(FileType.DOCX))
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub

    Private Function DownloadFile(ByVal url As String) As Stream
        Dim request As WebRequest = WebRequest.Create(url)
        Using response As WebResponse = request.GetResponse()
            Return GetFileStream(response)
        End Using
    End Function

    Private Function GetFileStream(ByVal response As WebResponse) As Stream
        Dim fileStream As New MemoryStream()
        Using responseStream As Stream = response.GetResponseStream()
            responseStream.CopyTo(fileStream)
        End Using
        fileStream.Position = 0
        Return fileStream
    End Function
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Load from URL

Path: /viewer/python-net/load-document-from-url/

The following code snippet shows how to load a document from a URL:

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
import requests
import io
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def download_file(url):
    response = requests.get(url, stream=True, headers={"User-Agent": "Mozilla/5.0 (Windows NT 6.1; WOW64; rv:25.0) Gecko/20100101 Firefox/25.0"}, timeout=10)
    # Check if the request was successful (status code 200)
    response.raise_for_status()
    # Create a BytesIO stream from the content
    stream = io.BytesIO(response.content)
    return stream

def load_document_from_url():

    url = "https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/blob/master/Examples/GroupDocs.Viewer.Examples.CSharp/Resources/SampleFiles/sample.docx?raw=true"
    
    stream = download_file(url)

    with Viewer(stream) as viewer:
        options = HtmlViewOptions.for_embedded_resources("load_document_from_url/download_file_{0}.html")
        viewer.view(options)

if __name__ == "__main__":
    load_document_from_url()
```
{{< /tab >}}
{{< /tabs >}}

---

## Load password-protected document

Path: /conversion/java/load-password-protected-document/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) supports the conversion of documents that are protected with a password.

To load and convert a password-protected document, follow these steps:

1.   Create an instance of the [Converter](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion/Converter) class and pass the source document path and the load options delegate as constructor parameters.
2.   Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/ConvertOptions) class e.g. (**[PdfConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/PdfConvertOptions)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/WordProcessingConvertOptions)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/SpreadsheetConvertOptions)**, etc.)
3.   Call the [convert](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion/Converter#convert(java.lang.String,%20com.groupdocs.conversion.options.convert.ConvertOptions)) method of the [Converter](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion/Converter) class instance and pass the filename for the converted document and the instance of [ConvertOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.convert/ConvertOptions) from the previous step.

The following code snippet shows how to convert password-protected document:

{{< tabs "code-example">}}
{{< tab "LoadPasswordProtectedFile.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

public class LoadPasswordProtectedFile {
    public static void loadPasswordProtectedFile() {
        // Set file path
        String filePath = "./password-protected.docx"
    
        // Instantiate load options and set password
        WordProcessingLoadOptions loadOptions = WordProcessingLoadOptions()
        loadOptions.setPassword("12345");

        // Specify source file path and load options
        Converter converter = new Converter(filePath, () -> loadOptions);

        // Specify output file location and convert options
        String outputPath = "./password-protected.pdf"
        PdfConvertOptions convertOptions = PdfConvertOptions()
        convertOptions.setPassword("67890");

        // Convert and save to output path
        converter.convert(outputPath, convertOptions)
    }

    public static void main(String[] args){
        loadPasswordProtectedFile();
    }
}
```
{{< /tab >}}
{{< tab "password-protected.docx" >}}  
{{< tab-text >}}
`password-protected.docx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-password-protected-file/password-protected.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "password-protected.pdf" >}}  
{{< tab-text >}}
`password-protected.pdf` is converted PDF document. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-password-protected-file/password-protected.pdf) to download it. The file is password-protected. Password is `67890`.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Load password-protected document

Path: /conversion/nodejs-java/load-password-protected-document/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/nodejs-java) supports the conversion of documents that are protected with a password.

To load and convert a password-protected document, follow these steps:

1.   Create an instance of the [Converter](#) class and pass the source document path and the load options delegate as constructor parameters.
2.   Instantiate the appropriate [ConvertOptions](#) class e.g. (**[PdfConvertOptions](#)**, **[WordProcessingConvertOptions](#)**, **[SpreadsheetConvertOptions](#)** etc.)
3.   Call the [convert](#) method of the [Converter](#) class instance and pass the filename for the converted document and the instance of [ConvertOptions](#) from the previous step.

The following code snippet shows how to convert password-protected document:

```js
const loadOptions = new groupdocs.conversion.WordProcessingLoadOptions()
loadOptions.setPassword("12345");

const converter = new groupdocs.conversion.Converter("sample_with_password.docx", loadOptions);
const convertOptions =  new groupdocs.conversion.PdfConvertOptions();
converter.convert("converted.pdf", convertOptions);
```

---

## Load password-protected documents

Path: /comparison/java/load-password-protected-documents/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare documents that are protected with a password.  

To compare password-protected documents, follow these steps:

1.  Instantiate the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object. Specify source document password;
2.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream and [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object created in the previous step.
3.  Instantiate another [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object. Specify target document password.
4.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream and the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object created in the previous step.
5.  Call the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) method.

The following code snippet shows how to compare password protected documents:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.load.LoadOptions;
// ...

try (Comparer comparer = new Comparer("source.xlsx", new LoadOptions("password"))) {
    comparer.add("target.xlsx", new LoadOptions("password"));
    comparer.compare("result.xlsx");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load password-protected documents

Path: /comparison/net/load-password-protected-documents/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare documents that are protected with a password.  

To compare password-protected documents, follow these steps:

1.  Instantiate the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object. Specify source document password;
2.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream and [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object created in the previous step.
3.  Instantiate another [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object. Specify target document password.
4.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream and the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object created in the previous step.
5.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method.

The following code snippet shows how to compare password protected documents:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

LoadOptions sourceLoadOptions = new LoadOptions(){ Password = "1234" };

using (Comparer comparer = new Comparer("source.docx", sourceLoadOptions))
{
    LoadOptions targetLoadOptions =	new LoadOptions() { Password = "5678" };
    comparer.Add("target.docx", targetLoadOptions);
    comparer.Compare("result.docx");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load password-protected documents

Path: /comparison/nodejs-java/load-password-protected-documents/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare documents that are protected with a password.

The following code snippet shows how to load and compare password-protected Excel documents.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for the source, target, and result Excel documents
const sourceExcelDocument = 'sample-files/source.xlsx';
const targetExcelDocument = 'sample-files/target.xlsx';
const resultExcelDocument = 'result.xlsx';

// Initialize the comparer with the source document and its password
const comparer = new groupdocs.Comparer(
  sourceExcelDocument,
  new groupdocs.LoadOptions('password') // password required to open the source file
);

// Add the target document to the comparison session with its own password
comparer.add(
  targetExcelDocument,
  new groupdocs.LoadOptions('password') // password required to open the target file
);

// Execute the comparison and save the result to the specified output file
comparer.compare(resultExcelDocument);

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates how to compare password-protected documents. It creates `LoadOptions` objects with passwords for both the source and target documents. The `Comparer` is initialized with the source document path and a `LoadOptions` object containing the source document's password. Similarly, when adding the target document, another `LoadOptions` object with the target document's password is provided. The comparison then proceeds normally, with both documents being decrypted using their respective passwords.

---

## Load password-protected documents

Path: /comparison/python-net/load-password-protected-documents/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to compare documents that are protected with a password.  

To compare password-protected documents, follow these steps:

1.  Instantiate the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object. Specify source document password;
2.  Instantiate the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify the source document path or stream and `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object created in the previous step.
3.  Instantiate another `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object. Specify the target document password.
4.  Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method. Specify the target document path or stream and the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object created in the previous step.
5.  Call the `compare()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> method.

The following code snippet shows how to compare password-protected documents:

```python
def compare_multiple_documents_protected_path(output_file_name, source_path, target_paths, source_password, target_passwords, result_path):
    try:
        # Initialize the comparer with the source file path and load options
        load_options_source = gc.options.LoadOptions()
        load_options_source.password = source_password
        comparer = gc.Comparer(source_path, load_options_source)

        # Add target files and load options
        for target_path, target_password in zip(target_paths, target_passwords):
            load_options_target = gc.options.LoadOptions()
            load_options_target.password = target_password
            comparer.add(target_path, load_options_target)

        # Perform the compare operation and save the result
        comparer.compare(output_file_name)

        print(f"\nDocuments compared successfully.\nCheck output in {output_file_name}.")
    
    except Exception as error:
        # Handle errors
        print('An error occurred during the document comparison:', error)
```
---

## Load password-protected documents

Path: /parser/python-net/load-password-protected-documents/


[GroupDocs.Parser](https://products.groupdocs.com/parser/python-net) allows you to extract data from password-protected documents including encrypted PDFs and password-protected Office files.

To load a password-protected document, follow these steps:

1. Create a `LoadOptions` object and specify the document password
2. Instantiate the `Parser` object with the file path and `LoadOptions` object
3. Use extraction methods as usual

## Load password-protected document

The following code snippet shows how to load a password-protected document:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

# Document password
password = "your-password"

# Create LoadOptions with the password
load_options = LoadOptions(password)

# Create an instance of Parser class with the file path and load options
with Parser("protected_document.pdf", load_options) as parser:
    # Extract text from the document
    text_reader = parser.get_text()
    
    if text_reader is not None:
        # Print the extracted text
        print(text_reader)
    else:
        print("Text extraction isn't supported for this format")
```

{{< /tab >}}
{{< tab "protected_document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [protected_document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-password-protected-documents/protected_document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Handle incorrect password

You should handle cases when an incorrect password is provided:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

def load_protected_document(file_path, password):
    """Load a password-protected document with error handling"""
    
    try:
        # Create LoadOptions with password
        load_options = LoadOptions(password)
        
        # Create Parser instance
        with Parser(file_path, load_options) as parser:
            # Get document info to verify successful loading
            doc_info = parser.get_document_info()
            
            print(f"Document loaded successfully!")
            print(f"Type: {doc_info.file_type.file_format}")
            print(f"Pages: {doc_info.page_count}")
            
            # Extract text
            text_reader = parser.get_text()
            if text_reader:
                return text_reader
            
    except Exception as e:
        print(f"Error loading document: {e}")
        return None

# Try loading with password
text = load_protected_document("protected.docx", "correct-password")
```

{{< /tab >}}
{{< tab "protected.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [protected.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-password-protected-documents/protected.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Check if document is password-protected

Before attempting to open a document, you can check if it requires a password:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

def check_if_protected(file_path):
    """Check if a document is password-protected"""
    
    try:
        # Try to get file info without password
        file_info = Parser.get_file_info(file_path)
        
        # Check if the document is encrypted
        if hasattr(file_info, 'is_encrypted') and file_info.is_encrypted:
            print("Document is password-protected")
            return True
        else:
            print("Document is not password-protected")
            return False
            
    except Exception as e:
        print(f"Error checking document: {e}")
        return None

# Check if document is protected
is_protected = check_if_protected("sample.pdf")

if is_protected:
    password = input("Enter password: ")
    load_options = LoadOptions(password)
    with Parser("./sample.pdf", load_options) as parser:
        text_reader = parser.get_text()
        if text_reader:
            print(text_reader)
else:
    with Parser("./sample.pdf") as parser:
        text_reader = parser.get_text()
        if text_reader:
            print(text_reader)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-password-protected-documents/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-password-protected-documents/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Load different protected formats
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

def extract_from_protected(file_path, password, extract_type="text"):
    """Extract data from various password-protected formats"""
    
    try:
        # Create LoadOptions with password
        load_options = LoadOptions(password)
        
        # Create Parser instance
        with Parser(file_path, load_options) as parser:
            if extract_type == "text":
                # Extract text
                text_reader = parser.get_text()
                if text_reader:
                    return text_reader
                    
            elif extract_type == "metadata":
                # Extract metadata
                metadata = parser.get_metadata()
                if metadata:
                    result = {}
                    for item in metadata:
                        result[item.name] = item.value
                    return result
                    
            elif extract_type == "images":
                # Extract images
                images = parser.get_images()
                if images:
                    return list(images)
                    
    except Exception as e:
        print(f"Error: {e}")
        return None

# Extract text from protected PDF
text = extract_from_protected("protected.pdf", "password123", "text")
```

{{< /tab >}}
{{< tab "protected.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [protected.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/loading/load-password-protected-documents/protected.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Batch process protected documents
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions
import os

def process_protected_documents(directory, password):
    """Process all password-protected documents in a directory"""
    
    results = []
    
    for filename in os.listdir(directory):
        file_path = os.path.join(directory, filename)
        
        if not os.path.isfile(file_path):
            continue
        
        try:
            print(f"
Processing: {filename}")
            
            # Create LoadOptions with password
            load_options = LoadOptions(password)
            
            # Try to parse the document
            with Parser(file_path, load_options) as parser:
                # Get document info
                doc_info = parser.get_document_info()
                
                # Extract text
                text_reader = parser.get_text()
                text = text_reader if text_reader else ""
                
                results.append({
                    "filename": filename,
                    "type": doc_info.file_type.file_format,
                    "pages": doc_info.page_count,
                    "text_length": len(text),
                    "success": True
                })
                
                print(f"  ✓ Success - {len(text)} characters extracted")
                
        except Exception as e:
            print(f"  ✗ Failed - {e}")
            results.append({
                "filename": filename,
                "success": False,
                "error": str(e)
            })
    
    return results

# Process all protected documents
results = process_protected_documents("./protected_docs", "common-password")

# Print summary
successful = [r for r in results if r.get("success")]
print(f"
{len(successful)}/{len(results)} documents processed successfully")
```

{{< /tab >}}
{{< /tabs >}}

## Supported encryption types

GroupDocs.Parser supports the following encryption types:

- **PDF:** Standard password encryption (user password)
- **Office Documents:** Password-protected DOCX, XLSX, PPTX files
- **Legacy Office:** Password-protected DOC, XLS, PPT files

> **Note:** Documents with owner passwords (restrictions passwords) that only restrict printing/editing are not supported. Only documents with user passwords (opening passwords) can be processed.

## More resources

### GitHub examples

You may find more code examples in our GitHub repository:

*   [GroupDocs.Parser for Python via .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET)

### Free online document parser

Along with the full-featured library, we provide a free online document parser app. You are welcome to extract data from PDF, DOCX, XLSX, and more with our [Free Online Document Parser App](https://products.groupdocs.app/parser).


---

## Load password-protected file

Path: /redaction/java/load-password-protected-file/

### Load password-protected file

In order to open password-protected documents, you have to pass your password to *LoadOptions* class constructor or assign it to its *Password* property of an instance of *LoadOptions* class:



```java
        LoadOptions loadOptions = new LoadOptions("mypassword");
        final Redactor redactor = new Redactor("protected_sample.docx", loadOptions);
        try 
        {
            // Here we can use document instance to perform redactions
            redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
            redactor.save();
        }
        finally { redactor.close(); }
```

---

## Load password-protected file

Path: /redaction/net/load-password-protected-file/

In order to open password-protected documents, you have to pass your password to [LoadOptions](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.options/loadoptions) class constructor or assign it to its [Password](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.options/loadoptions/properties/password) property of an instance of [LoadOptions](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.options/loadoptions) class:

**C#**

```csharp
LoadOptions loadOptions = new LoadOptions("mypassword");
using (Redactor redactor = new Redactor(@"protected_sample.docx", loadOptions))
{
   // Here we can use document instance to perform redactions
   redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
   redactor.Save();
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Load password-protected file

Path: /redaction/python-net/load-password-protected-file/

In order to open password-protected documents, you have to pass your password to [LoadOptions](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.options/loadoptions/) class constructor or assign it to its [Password](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.options/loadoptions/password/) property of an instance of [LoadOptions](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.options/loadoptions/) class:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr

def run():

    # Specify the load options with document password
    load_opt = gro.LoadOptions("mypassword")

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("protected_docx", load_opt) as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        redactor.save()
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Load Template Documents from File or Stream

Path: /assembly/net/basic-usage-load-template/


## Overview

GroupDocs.Assembly for .NET supports loading template documents from both file paths and streams. This flexibility allows you to work with templates stored on disk, in memory, or retrieved from remote sources.

The main class involved is:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - provides overloads for both file paths and streams

Here are the steps to load and use templates:

* Load template from a file path using string path parameter
* Load template from a stream using Stream parameter
* Choose the appropriate method based on your use case (file system vs memory/remote)
* Save assembled document to file path or stream accordingly

{{< alert style="info" >}}
When using streams, ensure proper disposal of stream resources. The DocumentAssembler does not automatically dispose of input streams, so you should manage stream lifecycle yourself.
{{< /alert >}}

## Load Template from File Path

The simplest way to load a template is from a file path:

```csharp
using GroupDocs.Assembly;

public static void LoadTemplateFromFile()
{
    // Template and output file paths
    string templatePath = @"C:\Templates\InvoiceTemplate.docx";
    string outputPath = @"C:\Output\Invoice.docx";
    
    // Sample data
    var invoiceData = new { CustomerName = "ABC Corp", Amount = 1500.00 };
    
    // Assemble document from file path
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(invoiceData, "invoice"));
    
    Console.WriteLine("Document assembled successfully.");
}
```

## Load Template from Stream

When working with templates in memory or from remote sources, use streams:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void LoadTemplateFromStream()
{
    // Load template into memory stream
    byte[] templateBytes = File.ReadAllBytes("Template.docx");
    using (MemoryStream templateStream = new MemoryStream(templateBytes))
    {
        // Create output stream
        using (FileStream outputStream = new FileStream("Output.docx", FileMode.Create))
        {
            var data = new { Title = "Report", Date = DateTime.Now };
            
            DocumentAssembler assembler = new DocumentAssembler();
            assembler.AssembleDocument(templateStream, outputStream, 
                new DataSourceInfo(data, "report"));
            
            Console.WriteLine("Document assembled from stream successfully.");
        }
    }
}
```

## Load Template from Remote Source

You can load templates from URLs or remote sources:

```csharp
using GroupDocs.Assembly;
using System.IO;
using System.Net.Http;

public static async void LoadTemplateFromRemote()
{
    // Download template from remote URL
    using (HttpClient client = new HttpClient())
    {
        byte[] templateBytes = await client.GetByteArrayAsync(
            "https://example.com/templates/ReportTemplate.docx");
        
        using (MemoryStream templateStream = new MemoryStream(templateBytes))
        using (FileStream outputStream = new FileStream("Output.docx", FileMode.Create))
        {
            var data = new { Company = "My Company", Year = 2024 };
            
            DocumentAssembler assembler = new DocumentAssembler();
            assembler.AssembleDocument(templateStream, outputStream, 
                new DataSourceInfo(data, "company"));
            
            Console.WriteLine("Document assembled from remote template.");
        }
    }
}
```

## Mixed File Path and Stream Usage

You can mix file paths and streams as needed:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void MixedFileAndStream()
{
    // Load template from file path
    string templatePath = "Template.docx";
    
    // Save output to stream
    using (MemoryStream outputStream = new MemoryStream())
    {
        var data = new { Name = "Test", Value = 100 };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templatePath, outputStream, 
            new DataSourceInfo(data, "item"));
        
        // Use the output stream (e.g., send via HTTP, save to database)
        byte[] outputBytes = outputStream.ToArray();
        File.WriteAllBytes("Output.docx", outputBytes);
        
        Console.WriteLine("Document assembled with mixed file/stream usage.");
    }
}
```

{{< alert style="warning" >}}
When using streams for output, the stream position is reset after assembly. Make sure to read from the stream after assembly completes, and handle the stream position appropriately.
{{< /alert >}}

### Advanced Usage Topics

To learn more about working with different template formats, custom document loading, and advanced stream handling, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Loading specific file formats

Path: /parser/java/loading-specific-file-formats/

In some cases it's required to specify the document format manually to guarantee correct output produced by GroupDocs.Parser. The following are the cases when the document format must be specified manually:

*   Markdown documents
*   MHTML documents
*   OTP documents (OpenDocument Presentation Template)
*   Databases
*   Emails from remote servers

Here are the steps to specify the document format for Markup document.

*   Instantiate the [LoadOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions) object and pass the document format in [LoadOptions(FileFormat)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions#LoadOptions(com.groupdocs.parser.options.FileFormat)) constructor;
*   Create [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object and call any method.

The following example shows how to specify the document format for Markup document:  

```java
try (InputStream stream = new FileInputStream(Constants.SampleMd)) {
    // Create an instance of Parser class for markdown document
    try (Parser parser = new Parser(stream, new LoadOptions(FileFormat.Markup))) {
        // Check if text extraction is supported
        if (!parser.getFeatures().isText()) {
            System.out.println("Text extraction isn't supported.");
            return;
        }
        try (TextReader reader = parser.getText()) {
            // Print the document text
            // Markdown is detected; text without special symbols is printed
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Locating signature with stretch mode

Path: /signature/net/locating-signature-with-stretch-mode/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to stretch signature area along page width or height. Use enumeration [StretchMode](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/stretchmode) contains following values

* [None](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/stretchmode) - no stretch will be applied
* [PageWidth](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/stretchmode) -  to stretch signature area along page width
* [PageHeight](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/stretchmode) - to stretch signature area along page height
* [PageArea](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/stretchmode) - to stretch signature area along page width and height

Here are the steps to use stretch mode with adding text or images signatures into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) or [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions)  object with all required additional options and setup [Stretch](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/stretch) property
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and the instance of signature options ([ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) for example) to it.

## Locate Signature Area with Stretch Mode

This example shows how to locate signature with stretch mode.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // define several signature options of different types and settings
    TextSignOptions textOptions = new TextSignOptions("This is test message")
    {
        AllPages = true,
        VerticalAlignment = VerticalAlignment.Top,
        Margin = new Padding(50),
        Stretch = StretchMode.PageWidth
    };
    BarcodeSignOptions barcodeOptions = new BarcodeSignOptions("123456")
    {
        AllPages = true,
        EncodeType = BarcodeTypes.Code128,
        VerticalAlignment = VerticalAlignment.Bottom,
        Margin = new Padding(50),
        Stretch = StretchMode.PageWidth
    };
    ImageSignOptions imageOptions = new ImageSignOptions()
    {
        AllPages = true,
        Stretch = StretchMode.PageHeight,
        HorizontalAlignment = HorizontalAlignment.Right,
        ImageFilePath = Constants.ImageHandwrite
    };

    // define list of signature options
    List<SignOptions> listOptions = new List<SignOptions>();
    listOptions.Add(textOptions);
    listOptions.Add(barcodeOptions);
    listOptions.Add(imageOptions);
    // sign document to file
    signature.Sign("signed.pdf", listOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Markdown flavor control

Path: /markdown/net/markdown-flavor/


GroupDocs.Markdown supports two Markdown dialects. Set the `Flavor` property on `ConvertOptions` to control the output.

### GitHub Flavored Markdown (default)

GFM supports pipe tables, strikethrough text, and other extensions:

{{< tabs "flavor-gfm">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions { Flavor = MarkdownFlavor.GitHub };
MarkdownConverter.ToFile("business-plan.docx", "flavor-gfm.md", options);

// Tables are rendered as:
// | Column A | Column B |
// | --- | --- |
// | value1 | value2 |
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "flavor-gfm.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/markdown-flavor/FlavorGfm/flavor-gfm.md)
{{< /tab >}}
{{< /tabs >}}

### CommonMark

Strict CommonMark output. Tables are rendered as fenced code blocks since CommonMark has no native table syntax:

{{< tabs "flavor-commonmark">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions { Flavor = MarkdownFlavor.CommonMark };
MarkdownConverter.ToFile("business-plan.docx", "flavor-commonmark.md", options);
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "flavor-commonmark.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/markdown-flavor/FlavorCommonmark/flavor-commonmark.md)
{{< /tab >}}
{{< /tabs >}}

---

## Markdown flavor control

Path: /markdown/python-net/markdown-flavor/


GroupDocs.Markdown supports two Markdown dialects. Set the `flavor` property on `ConvertOptions` to control the output.

### GitHub Flavored Markdown (default)

GFM supports pipe tables, strikethrough text, and other extensions:

{{< tabs "flavor-github">}}
{{< tab "flavor_github.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, MarkdownFlavor

def flavor_github():
    """Convert a document to GitHub Flavored Markdown with pipe tables and strikethrough."""

    # Step 1: Set the Markdown flavor to GitHub (GFM)
    options = ConvertOptions()
    options.flavor = MarkdownFlavor.GIT_HUB

    # Step 2: Convert the document using keyword argument for options
    md = MarkdownConverter.to_markdown("business-plan.docx", convert_options=options)

    # Tables are rendered as:
    # | Column A | Column B |
    # | --- | --- |
    # | value1 | value2 |

if __name__ == "__main__":
    flavor_github()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### CommonMark

Strict CommonMark output. Tables are rendered as fenced code blocks since CommonMark has no native table syntax:

{{< tabs "flavor-commonmark">}}
{{< tab "flavor_commonmark.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, MarkdownFlavor

def flavor_commonmark():
    """Convert a document to strict CommonMark format (no table extensions)."""

    # Step 1: Set the Markdown flavor to CommonMark
    options = ConvertOptions()
    options.flavor = MarkdownFlavor.COMMON_MARK

    # Step 2: Convert the document using keyword argument for options
    md = MarkdownConverter.to_markdown("business-plan.docx", convert_options=options)

    # Tables are rendered as fenced code blocks since CommonMark
    # has no native table syntax:
    # ```
    # Column A  |  Column B
    # value1    |  value2
    # ```

if __name__ == "__main__":
    flavor_commonmark()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Merge PowerPoint Presentations

Path: /merger/java/merge/powerpoint/


You must be familiar with **PPTX** and **PPT** extension files, these are Presentation file formats that store collection of records to accommodate presentation data such as: slides, shapes, text, animations, video, audio and embedded objects. A presentation can be saved/converted into other file formats as well such as PDF, BMP, PNG, JPEG, and XPS.

Common Presentation file extensions and their associated file formats include **PPTX**, **PPT**, **PPSX** and **PPS**.

## How to merge PPSX presentations

PPSX, Power Point Slide Show, file are created using Microsoft PowerPoint 2007 and above for Slide Show purpose. It is an update to the PPS file format that was supported by Microsoft PowerPoint 97-2003 versions. When a PPSX file is shared with another user and opened, it starts as PowerPoint show unlike PPTX file that opens in editable mode. The sequence of slide show is the same as in the original presentation. All the slides accompany the images, sounds and other embedded media accompany the presentation slides to the PPSX during the slideshow.

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source PPSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PPSX file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other PPSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged PPSX file as parameter.

```java
// Load the source PPSX file
Merger merger = new Merger("c:\sample1.ppsx")

// Add another PPSX file to merge
merger.join("c:\sample2.ppsx");
// Merge PPSX files and save result
merger.save("c:\merged.ppsx");
```

NOTE: You may merge other Presentation formats like PPTX, PPT and PPS in the same way as shown above. For this provide files by specifying their names with extension.

## How to merge PPTX streams

Please read the following article: [How to properly merge PPTX streams]({{< ref "merger/java/getting-started/use-cases/how-to-properly-merge-documents-using-java.md" >}})

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PowerPoint Live Demo

GroupDocs.Merger for Java provides an online [**PowerPoint Merger App**](https://products.groupdocs.app/merger/powerpoint), which allows you to try it for free and check its quality and accuracy.

---

## Merge PowerPoint Presentations

Path: /merger/nodejs-java/merge/powerpoint/


You must be familiar with **PPTX** and **PPT** extension files, these are Presentation file formats that store collection of records to accommodate presentation data such as: slides, shapes, text, animations, video, audio and embedded objects. A presentation can be saved/converted into other file formats as well such as PDF, BMP, PNG, JPEG, and XPS.

Common Presentation file extensions and their associated file formats include **PPTX**, **PPT**, **PPSX** and **PPS**.

## How to merge PPSX presentations

PPSX, Power Point Slide Show, file are created using Microsoft PowerPoint 2007 and above for Slide Show purpose. It is an update to the PPS file format that was supported by Microsoft PowerPoint 97-2003 versions. When a PPSX file is shared with another user and opened, it starts as PowerPoint show unlike PPTX file that opens in editable mode. The sequence of slide show is the same as in the original presentation. All the slides accompany the images, sounds and other embedded media accompany the presentation slides to the PPSX during the slideshow.

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source PPSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PPSX file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other PPSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged PPSX file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.ppsx');
merger.join('c:/sample2.ppsx');
merger.save('c:/merged.ppsx');
```

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PowerPoint Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**PowerPoint Merger App**](https://products.groupdocs.app/merger/powerpoint), which allows you to try it for free and check its quality and accuracy.

---

## Merge PowerPoint Presentations

Path: /merger/python-net/merge/powerpoint/


You must be familiar with **PPTX** and **PPT** extension files, these are Presentation file formats that store collection of records to accommodate presentation data such as: slides, shapes, text, animations, video, audio and embedded objects. A presentation can be saved/converted into other file formats as well such as PDF, BMP, PNG, JPEG, and XPS.

Common Presentation file extensions and their associated file formats include **PPTX**, **PPT**, **PPSX** and **PPS**.

## How to merge PPSX presentations

PPSX, Power Point Slide Show, file are created using Microsoft PowerPoint 2007 and above for Slide Show purpose. It is an update to the PPS file format that was supported by Microsoft PowerPoint 97-2003 versions. When a PPSX file is shared with another user and opened, it starts as PowerPoint show unlike PPTX file that opens in editable mode. The sequence of slide show is the same as in the original presentation. All the slides accompany the images, sounds and other embedded media accompany the presentation slides to the PPSX during the slideshow.

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source PPSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PPSX file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other PPSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PPSX file as parameter.

```python
with gm.Merger("c:/sample1.ppsx") as merger:
    merger.join("c:/sample2.ppsx")
    merger.save("c:/merged.ppsx")
```

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PowerPoint Live Demo

GroupDocs.Merger for Python via .NET provides an online [**PowerPoint Merger App**](https://products.groupdocs.app/merger/powerpoint), which allows you to try it for free and check its quality and accuracy.

---

## Migration notes

Path: /parser/net/migration-notes/

### Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Parser for .NET since version 19.8:

*   [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) class is introduced as a **single entry point** to extract data from the document.    
*   Data extraction was unified for all data types.      
*   The overall document related classes were unified to common.      
*   Product architecture was redesigned from scratch in order to simplify passing options and classes to manipulate data.    
*   Document information and preview generation procedures were simplified.      
    

### How To Migrate?

Here is brief comparison of how to extract data using the old and new API.  

#### Text

**Old coding style**

```csharp
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
using (TextExtractor extractor = factory.CreateTextExtractor(filePath))
{
    // Extract a text from the text extractor
    string textLine = null;
    do
    {
        textLine = extractor.ExtractLine();
        if (textLine != null)
        {
            Console.WriteLine(textLine);
        }
    }
    while (textLine != null);
}
```

**New coding style**

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a text to the reader
    using (TextReader reader = parser.GetText())
    {
        // Check if text extraction is supported
        if (reader == null)
        {
            Console.WriteLine("Text extraction isn't supported.");
            return;
        }
        // Extract a text from the reader
        string textLine = null;
        do
        {
            textLine = reader.ReadLine();
            if (textLine != null)
            {
                Console.WriteLine(textLine);
            }
        }
        while (textLine != null);
    }
}
```  

#### Text Page

**Old coding style**

```csharp
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
using (TextExtractor extractor = factory.CreateTextExtractor(filePath))
{
    // Check if the extractor supports pagination
    IPageTextExtractor pte = extractor as IPageTextExtractor;
    if (pte != null)
    {
        // Extract the first page
        Console.WriteLine(pte.ExtractPage(0));
    }
}
```

**New coding style**

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract the first page text to the reader
    using (TextReader reader = parser.GetText(0))
    {
        // Check if text extraction is supported
        if (reader != null)
        {
            // Extract a text from the reader
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```  

#### Search

**Old coding style**

```csharp
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
using (TextExtractor extractor = factory.CreateTextExtractor(filePath))
{
    // Check if the extractor supports search
    ISearchable se = extractor as ISearchable;
    if (se != null)
    {
        // Create a handler
        ListSearchHandler handler = new ListSearchHandler();
        // Search "keyword" in the document
        se.Search(new SearchOptions(null), handler, new string[] { "keyword" });
        // Print search results
        foreach (SearchResult result in handler.List)
        {
            Console.WriteLine(string.Format("at {0}: {1}", result.Index, result.FoundText));
        }
    }
}
```

**New coding style**

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Search "keyword" in the document
    IEnumerable<SearchResult> list = parser.Search("keyword");
    // Check if search is supported
    if (list == null)
    {
        Console.WriteLine("Search isn't supported.");
        return;
    }
    // Print search results
    foreach (SearchResult result in list)
    {
        Console.WriteLine(string.Format("at {0}: {1}", result.Position, result.Text));
    }
}
```

#### File Type Detection

**Old coding style**

```csharp
// Detect and print file type
Console.WriteLine(CompositeMediaTypeDetector.Default.Detect(filePath));
```

**New coding style**

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Detect and print file type
    Console.WriteLine(parser.GetDocumentInfo().FileType);
}
```

  

#### Metadata

**Old coding style**

```csharp
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a metadata extractor
MetadataExtractor extractor = factory.CreateMetadataExtractor(filePath);
// Extract metadata
MetadataCollection metadata = extractor.ExtractMetadata(filePath);
// Print metadata
foreach (KeyValuePair<string, string> item in metadata)
{
    Console.WriteLine(string.Format("{0} = {1}", item.Key, item.Value));
}
```

**New coding style**

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract metadata
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
    // Check if metadata extraction is supported
    if (metadata == null)
    {
        Console.WriteLine("Metadata extraction isn't supported.");
        return;
    }
    // Print metadata
    foreach (MetadataItem item in metadata)
    {
        Console.WriteLine(string.Format("{0} = {1}", item.Name, item.Value));
    }
}
```

  

#### Structure

**Old coding style**

```csharp
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
using (TextExtractor extractor = factory.CreateTextExtractor(filePath))
{
    // Check if the extractor supports text structure extraction
    IStructuredExtractor se = extractor as IStructuredExtractor;
    if (se != null)
    {
        // Create a handler
        Handler handler = new Handler();
        // Extract text structure
        se.ExtractStructured(handler);
        // Print hyperlinks
        foreach (string link in handler.Links)
        {
            Console.WriteLine(link);
        }
    }
}

// Handler for the hyperlink extraction
private class Handler : StructuredHandler
{
    public Handler()
    {
        Links = new List<string>();
    }
    public List<string> Links { get; private set; }
    // Override the method to catch hyperlinks
    protected override void OnStartHyperlink(HyperlinkProperties properties)
    {
        Links.Add(properties.Link);
    }
}
```

**New coding style**

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract text structure to the XML reader
    using (XmlReader reader = parser.GetStructure())
    {
        // Check if text structure extraction is supported
        if (reader == null)
        {
            Console.WriteLine("Text structure extraction isn't supported.");
            return;
        }
        // Read the XML document to search hyperlinks
        while (reader.Read())
        {
            // Check if this is a start element with "hyperlink" name
            if (reader.NodeType == XmlNodeType.Element && reader.IsStartElement() && reader.Name.ToLowerInvariant() == "hyperlink")
            {
                // Extract "link" attribute
                string value = reader.GetAttribute("link");
                if (value != null)
                {
                    Console.WriteLine(value);
                }
            }
        }
    }
}
```

---

## Migration notes

Path: /watermark/net/migration-notes/

## Why to migrate

Here are the key reasons to use the new updated API provided by GroupDocs.Watermark for .NET since version 19.5:

* The [Watermarker](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker) class is introduced as a single entry point to manage watermarks in the document (instead of [Document](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.legacy/document) class from previous versions).
* Adding watermarks was unified for all supported document formats.
* Product architecture was redesigned from scratch in order to simplify passing options to manage watermarks.
* Document information and preview generation procedures were simplified.

## How to migrate

Here is a brief comparison of how to manage watermarks using the old and new API.

### Load documents

#### Any supported format

The following examples show how to load a document of any supported format.

**Old API**

```csharp
using (Document doc = Document.Load(@"C:\test.doc"))
{
        // watermarking goes here
        // ...
}
```

**New API**

```csharp
using (Watermarker watermarker = new Watermarker(@"C:\test.doc"))
{
        // watermarking goes here
        // ...
}
```

#### Document of specific format

The following examples show how to load a diagram document.

**Old API**

```csharp
using (DiagramDocument doc = Document.Load<DiagramDocument>(@"C:\diagram.vsdx"))
{
        // watermarking goes here
        // ...
}
```

**New API**

```csharp
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
using (Watermarker watermarker = new Watermarker(@"C:\diagram.vsdx", loadOptions))
{
        // watermarking goes here
        // ...
}
```

### Add watermarks

The following examples show how to add text watermark to a document of any supported type.

**Old API**

```csharp
foreach (string filePath in Directory.GetFiles(@"C:\Documents"))
{
    using (Document document = Document.Load(filePath))
    {
        TextWatermark watermark = new TextWatermark("top secret", new Font("Arial", 36))
        watermark.ForegroundColor = Color.Red;
        watermark.HorizontalAlignment = HorizontalAlignment.Center;
        watermark.VerticalAlignment = VerticalAlignment.Center;

        document.AddWatermark(watermark);
        document.Save();
    }
}
```

**New API**

```csharp
foreach (string filePath in Directory.GetFiles(@"C:\Documents"))
{
    using (Watermarker watermarker = new Watermarker(filePath))
    {
        TextWatermark watermark = new TextWatermark("top secret", new Font("Arial", 36));
        watermark.ForegroundColor = Color.Red;
        watermark.HorizontalAlignment = HorizontalAlignment.Center;
        watermark.VerticalAlignment = VerticalAlignment.Center;

        watermarker.Add(watermark);
        watermarker.Save();
    }
}
```

#### Add watermark with options

The following examples show how to add watermark to the first page of a diagram document.

**Old API**

```csharp
using (DiagramDocument doc = Document.Load<DiagramDocument>(@"C:\diagram.vsdx"))
{
    TextWatermark textWatermark = new TextWatermark("Test watermark", new Font("Calibri", 19));

    doc.Pages[0].AddWatermark(textWatermark);

    doc.Save();
}
```

**New API**

```csharp
using (Watermarker watermarker = new Watermarker(@"C:\diagram.vsdx"))
{
    TextWatermark textWatermark = new TextWatermark("Test watermark", new Font("Calibri", 19));

    watermarker.Add(textWatermark, new DiagramPageWatermarkOptions { PageIndex = 0 });

    watermarker.Save();
}
```

### Search watermarks

The following examles show how to find watermarks using search criteria.

**Old API**

```csharp
using (Document doc = Document.Load(@"C:\test.some_ext"))
{
    SizeSearchCriteria widthRange = new SizeSearchCriteria(Dimension.Width, 50, 100);
    RotateAngleSearchCriteria rotateAngle = new RotateAngleSearchCriteria(0, 45);
    TextSearchCriteria textCriteria = new TextSearchCriteria(new Regex("^Test watermark$"));

    PossibleWatermarkCollection watermarks = doc.FindWatermarks(textCriteria.And(widthRange.Or(rotateAngle)));

    Console.WriteLine("Found {0} possible watermarks.", watermarks.Count);
}
```

**New API**

```csharp
using (Watermarker watermarker = new Watermarker(@"C:\test.some_ext"))
{
    SizeSearchCriteria widthRange = new SizeSearchCriteria(Dimension.Width, 50, 100);
    RotateAngleSearchCriteria rotateAngle = new RotateAngleSearchCriteria(0, 45);
    TextSearchCriteria textCriteria = new TextSearchCriteria(new Regex("^Test watermark$"));

    PossibleWatermarkCollection watermarks = watermarker.Search(textCriteria.And(widthRange.Or(rotateAngle)));

    Console.WriteLine("Found {0} possible watermarks.", watermarks.Count);
}
```

### Remove watermarks

The following examples show how to remove all possible watermarks.

**Old API**

```csharp
using (Document doc = Document.Load(@"C:\document.pdf"))
{
    PossibleWatermarkCollection watermarks = doc.FindWatermarks();
    watermarks.Clear();
    doc.Save(@"C:\document_without_watermarks.pdf");
}
```

**New API**

```csharp
using (Watermarker watermarker = new Watermarker(@"C:\document.pdf"))
{
    PossibleWatermarkCollection watermarks = watermarker.Search();
    watermarker.Remove(watermarks);
    watermarker.Save(@"C:\document_without_watermarks.pdf");
}
```

### Get document info

The following examples show how to get document information from the local file.

**Old API**

```csharp
DocumentInfo documentInfo = Document.GetInfo(@"C:\test.ppt");
Console.WriteLine(documentInfo.FileFormat);
Console.WriteLine(documentInfo.IsEncrypted);
```

**New API**

```csharp
using (Watermarker watermarker = new Watermarker(@"C:\test.ppt"))
{
    IDocumentInfo info = watermarker.GetDocumentInfo();
    Console.WriteLine("File type: {0}", info.FileType);
    Console.WriteLine("Number of pages: {0}", info.PageCount);
    Console.WriteLine("Document size: {0} bytes", info.Size);
}
```

---

## Migration Notes

Path: /metadata/java/migration-notes/

## Why To Migrate?

Here are the key reasons to use the new API provided by GroupDocs.Metadata for Java starting from version 20.2:

*   The* Metadata* class is introduced as a **single entry point** to manage metadata in files of all supported formats.
*   Extracting and updating metadata was unified for all supported formats.
*   The product architecture was redesigned from scratch in order to simplify most common operations with metadata properties.
*   Getting document information and preview generation procedures were simplified.

## How To Migrate?

Here is a brief comparison of how to manage metadata using the old and new API.


### Loading Files

#### Any Supported Format

The following examples show how to load a file of any supported format.

**Old API**

```csharp
try (FormatBase format = FormatFactory.recognizeFormat("D:\\input.doc")) {
	// ...
}
```

**New API**

```csharp
try (Metadata metadata = new Metadata("D:\\input.doc")) {
	// ...
}
```

#### Some Specific Format

The code samples below demonstrate how to load a file of a specific format.

**Old API**

```csharp
try (XlsFormat xlsFormat = new XlsFormat("D:\\input.xls")) {
	// ...
}
```

**New API**

```csharp
LoadOptions loadOptions = new LoadOptions(FileFormat.Spreadsheet);
try (Metadata metadata = new Metadata(Constants.InputXls, loadOptions)) {
	SpreadsheetRootPackage root = metadata.getRootPackageGeneric();
	// ...
}
```

### Working with Metadata using Regular Expressions

#### Finding Metadata using Regular Expressions

The following code snippets retrieve metadata from a file using a regular expression.

**Old API**

```csharp
Pattern pattern = Pattern.compile("author|company", Pattern.CASE_INSENSITIVE);
MetadataPropertyCollection properties = SearchFacade.scanDocument("D:\\input.docx", pattern);
for (int i = 0; i < properties.getCount(); i++)
{
    System.out.println(properties.readByIndex(i));
}
```

**New API**

```csharp
public class FindPropertiesByRegex {
    public static void run() {
        Pattern pattern = Pattern.compile("author|company", Pattern.CASE_INSENSITIVE);

        try (Metadata metadata = new Metadata(Constants.InputDocx)) {
            // This method searches for properties across all metadata packages and works with all supported formats
            IReadOnlyList<MetadataProperty> properties = metadata.findProperties(new FindPropertiesByRegex().new RegexSpecification(pattern));

            for (MetadataProperty property : properties) {
                System.out.println(String.format("%s = %s", property.getName(), property.getValue()));
            }
        }
    }

    public class RegexSpecification extends Specification {
        private Pattern pattern;

        public RegexSpecification(Pattern pattern) {
            this.pattern = pattern;
        }

        @Override
        public boolean isSatisfiedBy(MetadataProperty metadataProperty) {
            Matcher matcher = pattern.matcher(metadataProperty.getName());
            return matcher.find();
        }
    }
}
```

#### Replacing Metadata using Regular Expressions

The following code snippets show how to replace metadata properties using a regular expression.

**Old API**

```csharp
Pattern pattern = Pattern.compile("^author|company$", Pattern.CASE_INSENSITIVE);
String replaceValue = "Aspose";

SearchFacade.replaceInDocument("D:\\input.docx", pattern, replaceValue, "D:\\output.docx");
```

**New API**

```csharp
public class UpdatePropertiesByRegex {
    public static void run() {
        Pattern pattern = Pattern.compile("^author|company$", Pattern.CASE_INSENSITIVE);
        PropertyValue replaceValue = new PropertyValue("Aspose");

        try (Metadata metadata = new Metadata(Constants.InputDocx)) {
            // This method updates writable properties across all metadata packages and works with all supported formats
            metadata.updateProperties(new UpdatePropertiesByRegex().new RegexSpecification(pattern), replaceValue);

            metadata.save(Constants.OutputDocx);
        }
    }

    private class RegexSpecification extends Specification {
        private Pattern pattern;

        public RegexSpecification(Pattern pattern) {
            this.pattern = pattern;
        }

        @Override
        public boolean isSatisfiedBy(MetadataProperty metadataProperty) {
            Matcher matcher = pattern.matcher(metadataProperty.getName());
            return matcher.find();
        }
    }
}
```

### Exporting Metadata

#### Export Metadata Properties to CSV

The following code snippets show how to export metadata properties to a CSV file.

**Old API**

```csharp
try (FileOutputStream stream = new FileOutputStream("D:\\metadata.csv")) {

	byte[] content = ExportFacade.exportToCsv("D:\\input.eml");
	stream.write(content);
}
```

**New API**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEml)) {
	// We use a predicate that extracts all metadata properties
	IReadOnlyList<MetadataProperty> properties = metadata.findProperties(new AnySpecification());
	String delimiter = ";";
	StringBuilder builder = new StringBuilder();
	builder.append(String.format("Name%sValue", delimiter));
	builder.append("\n");
	for (MetadataProperty property : properties) {
		builder.append(String.format("\"%s\"%s\"%s\"", property.getName(), delimiter, formatValue(property.getValue())));
		builder.append("\n");
	}
	try (PrintWriter out = new PrintWriter(Constants.OutputCsv)) {
		out.println(builder.toString());
	}
}
```

{{< alert style="info" >}}The implementation of the FormatValue method used in the code sample above can be different depending on your task so we just omitted it here. Please see the full code of the method in the sample project on GitHub.{{< /alert >}}

### Using the Replace API

#### Update Values with IReplaceHandler

The code samples below show how to update metadata properties using a custom filter.

**Old API (Implementation of IReplaceHandler)**

```csharp
public class AuthorReplaceHandler implements IReplaceHandler<MetadataProperty>
{
	public AuthorReplaceHandler(String outputPath)
	{
		this.outputPath = outputPath;
	}

	public String outputPath;

	@Override
	public String getOutputPath() {
		return outputPath;
	}

	public boolean handle(MetadataProperty property)
	{
		// if property name is 'author'
		if ("author".equalsIgnoreCase(property.getName()))
		{
			// update property value
			property.setValue(new PropertyValue("Jack London"));
			// and mark property as updated
			return true;
		}
		// ignore all other properties
		return false;
	}
}
```

**Old API (Usage of AuthorReplaceHandler)**

```csharp
// initialize custom handler, send output path using constructor
IReplaceHandler<MetadataProperty> replaceHandler = new AuthorReplaceHandler("D:\\output.docx");
// replace author
int affectedPropertiesCount = SearchFacade.replaceInDocument("D:\\intput.docx", replaceHandler);
```

In the new API there is no need to use the IReplaceHandler interface since you have full control over property filters using the GrooupDocs.Metadata search engine.

**New API**

```csharp
public class UpdatePropertyValue {
    public static void run() {
        try (Metadata metadata = new Metadata(Constants.InputDocx)) {
            int affected = metadata.updateProperties(new UpdatePropertyValue().new CustomNameComparerSpecification("author"), new PropertyValue("Jack London"));

            System.out.println(affected);

            metadata.save(Constants.OutputDocx);
        }
    }

    private class CustomNameComparerSpecification extends Specification {

        private String name;

        public CustomNameComparerSpecification(String name) {
            this.name = name;
        }

        @Override
        public boolean isSatisfiedBy(MetadataProperty metadataProperty) {
            return metadataProperty.getName().equalsIgnoreCase(name);
        }
    }
}
```

### Extracting a Specific Metadata Package

#### Extract a Metadata Package of a Specific Type

The code samples below demonstrate how to fetch a metadata package with a specific type.

**Old API**

```csharp
DublinCoreMetadata dublinCoreMetadata = (DublinCoreMetadata) MetadataUtility.extractSpecificMetadata("D:\\input.docx", MetadataType.DublinCore);

if (dublinCoreMetadata != null)
{
    System.out.println(dublinCoreMetadata.getCreator());
    System.out.println(dublinCoreMetadata.getFormat());
    System.out.println(dublinCoreMetadata.getSubject());
}
```

**New API**

```csharp
public class ExtractPackageUsingCommonApi {
    public static void run() {
        try (Metadata metadata = new Metadata(Constants.InputDocx)) {
            IReadOnlyList<MetadataProperty> properties = metadata.findProperties(new ExtractPackageUsingCommonApi().new AssignableFromSpecification(DublinCorePackage.class));
            MetadataProperty property = properties.getCount() > 0 ? properties.get_Item(0) : null;

            if (property != null) {
                DublinCorePackage dcPackage = property.getValue().toClass(DublinCorePackage.class);

                System.out.println(dcPackage.getFormat());
                System.out.println(dcPackage.getContributor());
                System.out.println(dcPackage.getCoverage());
                System.out.println(dcPackage.getCreator());
                System.out.println(dcPackage.getSource());
                System.out.println(dcPackage.getDescription());

                // ...
            }
        }
    }

    private class AssignableFromSpecification extends Specification {

        private Class<?> clazz;

        public AssignableFromSpecification(Class<?> clazz) {
            this.clazz = clazz;
        }

        @Override
        public boolean isSatisfiedBy(MetadataProperty metadataProperty) {
            return metadataProperty.getValue().getRawValue() != null && clazz.isAssignableFrom(metadataProperty.getValue().getRawValue().getClass());
        }
    }
}
```

---

## Migration Notes

Path: /metadata/net/migration-notes/

## Why To Migrate?

Here are the key reasons to use the new API provided by GroupDocs.Metadata for .NET starting from version 19.11:

*   The* Metadata* class is introduced as a **single entry point** to manage metadata in files of all supported formats.
*   Extracting and updating metadata was unified for all supported formats.
*   The product architecture was redesigned from scratch in order to simplify most common operations with metadata properties.
*   Getting document information and preview generation procedures were simplified.

## How To Migrate?

Here is a brief comparison of how to manage metadata using the old and new API.


### Loading Files

#### Any Supported Format

The following examples show how to load a file of any supported format.

**Old API**

```csharp
using (FormatBase format = FormatFactory.RecognizeFormat(@"D:\input.doc"))
{
	// ...
}
```

**New API**

```csharp
using (Metadata metadata = new Metadata(@"D:\input.doc"))
{
	// ...
}
```

#### Some Specific Format

The code samples below demonstrate how to load a file of a specific format.

**Old API**

```csharp
using (XlsFormat xlsFormat = new XlsFormat(@"D:\input.xls"))
{
	// ...
}
```

**New API**

```csharp
var loadOptions = new LoadOptions(FileFormat.Spreadsheet);
using (Metadata metadata = new Metadata(Constants.InputXls, loadOptions))
{
	var root = metadata.GetRootPackage<SpreadsheetRootPackage>();

	// ...
}
```

### Working with Metadata using Regular Expressions

#### Finding Metadata using Regular Expressions

The following code snippets retrieve metadata from a file using a regular expression.

**Old API**

```csharp
Regex pattern = new Regex("author|company", RegexOptions.IgnoreCase);

// This method works with document formats only
MetadataPropertyCollection properties = SearchFacade.ScanDocument(@"D:\input.docx", pattern);
for (int i = 0; i < properties.Count; i++)
{
	Console.WriteLine(properties[i]);
}
```

**New API**

```csharp
Regex pattern = new Regex("author|company", RegexOptions.IgnoreCase);

using (Metadata metadata = new Metadata(@"D:\input.docx"))
{
	// This method searches for properties across all metadata packages and works with all supported formats
	var properties = metadata.FindProperties(p => pattern.IsMatch(p.Name) || pattern.IsMatch(p.Value.ToString()));

	foreach (var property in properties)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}
}
```

#### Replacing Metadata using Regular Expressions

The following code snippets show how to replace metadata properties using a regular expression.

**Old API**

```csharp
Regex pattern = new Regex("^author|company$", RegexOptions.IgnoreCase);
string replaceValue = "Aspose";

// This method works with document formats only
SearchFacade.ReplaceInDocument(@"D:\input.docx", pattern, replaceValue, @"D:\output.docx");
```

**New API**

```csharp
var pattern = new Regex("^author|company$", RegexOptions.IgnoreCase);
var replaceValue = new PropertyValue("Aspose");

using (Metadata metadata = new Metadata(@"D:\input.docx"))
{
	// This method updates writable properties across all metadata packages and works with all supported formats
	metadata.UpdateProperties(p => pattern.IsMatch(p.Name), replaceValue);

	metadata.Save(@"D:\output.docx");
}
```

### Comparing Metadata

#### Get the Difference between Two Sets of Metadata Properties

The code samples below demonstrate how to get the difference of two collections of properties extracted from different files.

**Old API**

```csharp
var firstDocument = @"D:\input1.docx";
var secondDocument = @"D:\input2.docx";

MetadataPropertyCollection differnces = ComparisonFacade.CompareDocuments(firstDocument, secondDocument, ComparerSearchType.Difference);

foreach(MetadataProperty property in differnces)
{
    Console.WriteLine("{0} : {1}", property.Name, property.Value);
}
```

**New API**

```csharp
// The predicate to extract metadata properties we want to compare
// In this code sample we retrieve built-in document properties
Common.Func<MetadataProperty, bool> predicate = p => p.Tags.Contains(Tags.Document.BuiltIn);

using (Metadata metadata1 = new Metadata(@"D:\input1.docx"))
using (Metadata metadata2 = new Metadata(@"D:\input2.docx"))
{
	// You can implement your own equality comparer for metadata properties
	// In this code sample, we just use the old one that worked in previous versions of GroupDocs.Metadata
	var difference = metadata1.FindProperties(predicate).Except(metadata2.FindProperties(predicate), new MetadataPropertyEqualityComparer());
	foreach (var property in difference)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}
}
```

#### Get the Intersection of Two Sets of Metadata Properties

The code samples below demonstrate how to get the intersection of two collections of properties extracted from different files.

**Old API**

```csharp
var firstDocument = @"D:\input1.jpg";
var secondDocument = @"D:\input2.jpg";

TiffTag[] intersection = ComparisonFacade.CompareExifTags(firstFile, secondFile, ComparerSearchType.Intersection);

foreach (TiffTag tag in intersection)
{
    Console.WriteLine(tag.DefinedTag);
    Console.WriteLine(tag.TagType);
    Console.WriteLine(tag.GetFormattedValue());
}
```

**New API**

```csharp
// The predicate to extract metadata properties we want to compare
// In this code sample we retrieve TIFF/EXIF tags
Common.Func<MetadataProperty, bool> predicate = p => p is TiffTag;

using (Metadata metadata1 = new Metadata(@"D:\input1.jpg"))
using (Metadata metadata2 = new Metadata(@"D:\input2.jpg"))
{
	// You can implement your own equality comparer for metadata properties
	// In this code sample, we just use the old one that worked in previous versions of GroupDocs.Metadata
	var intersection = metadata1.FindProperties(predicate).Intersect(metadata2.FindProperties(predicate), new MetadataPropertyEqualityComparer());

	foreach (var property in intersection)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}
}
```

### Exporting Metadata

#### Export Metadata Properties to CSV

The following code snippets show how to export metadata properties to a CSV file.

**Old API**

```csharp
string outputPath = @"D:\metadata.csv";

// export to csv
byte[] content = ExportFacade.ExportToCsv(@"D:\input.eml");

// write data to the file
File.WriteAllBytes(outputPath, content);
```

**New API**

```csharp
using (Metadata metadata = new Metadata(@"D:\input.eml"))
{
	// We use a predicate that extracts all metadata properties
	var properties = metadata.FindProperties(p => true);

	const string delimiter = ";";
	StringBuilder builder = new StringBuilder();
	builder.AppendFormat("Name{0}Value", delimiter);
	builder.AppendLine();
	foreach (var property in properties)
	{
		builder.AppendFormat(@"""{0}""{1}""{2}""", property.Name, delimiter, FormatValue(property.Value));
		builder.AppendLine();
	}

	File.WriteAllText(@"D:\metadata.csv", builder.ToString());
}
```

{{< alert style="info" >}}The implementation of the FormatValue method used in the code sample above can be different depending on your task so we just omitted it here. Please see the full code of the method in the sample project on GitHub.{{< /alert >}}

### Using the Replace API

#### Update Values with IReplaceHandler

The code samples below show how to update metadata properties using a custom filter.

**Old API (Implementation of IReplaceHandler)**

```csharp
/// <summary>
/// This class updates author to 'Jack London'
/// </summary>
public class AuthorReplaceHandler : IReplaceHandler<MetadataProperty>
{
    public AuthorReplaceHandler(string outputPath)
    {
        this.OutputPath = outputPath;
    }

    public string OutputPath { get; private set; }

    public bool Handle(MetadataProperty property)
    {
        // if property name is 'author'
        if (property.Name.ToLower() == "author")
        {
            // update property value
            property.Value = new PropertyValue("Jack London");
            // and mark property as updated
            return true;
        }

        // ignore all other properties
        return false;
    }
}
```

**Old API (Usage of AuthorReplaceHandler)**

```csharp
// initialize custom handler, send output path using constructor
IReplaceHandler<MetadataProperty> replaceHandler = new AuthorReplaceHandler(@"D:\output.docx");
// replace author
int affectedPropertiesCount = SearchFacade.ReplaceInDocument(@"D:\intput.docx", replaceHandler);
```

In the new API there is no need to use the IReplaceHandler interface since you have full control over property filters using the GrooupDocs.Metadata search engine.

**New API**

```csharp
using (Metadata metadata = new Metadata(@"D:\intput.docx"))
{
	var affected = metadata.UpdateProperties(
		p => string.Equals(p.Name, "author", StringComparison.OrdinalIgnoreCase),
				new PropertyValue("Jack London"));
				
	Console.WriteLine(affected);

	metadata.Save(@"D:\output.docx");
}
```

### Extracting a Specific Metadata Package

#### Extract a Metadata Package of a Specific Type

The code samples below demonstrate how to fetch a metadata package with a specific type.

**Old API**

```csharp
DublinCoreMetadata dublinCoreMetadata = (DublinCoreMetadata)MetadataUtility.ExtractSpecificMetadata("D:\input.docx", MetadataType.DublinCore);

if (dublinCoreMetadata != null)
{
	Console.WriteLine(dublinCoreMetadata.Creator);
	Console.WriteLine(dublinCoreMetadata.Format);
	Console.WriteLine(dublinCoreMetadata.Subject);
}
```

**New API**

```csharp
using (Metadata metadata = new Metadata("D:\input.docx"))
{
	var property = metadata.FindProperties(p => p.Value.RawValue is DublinCorePackage).FirstOrDefault();

	if (property != null)
	{
		var package = property.Value.ToClass<DublinCorePackage>();
		Console.WriteLine(package.Format);
		Console.WriteLine(package.Contributor);
		Console.WriteLine(package.Coverage);
		Console.WriteLine(package.Creator);
		Console.WriteLine(package.Source);
		Console.WriteLine(package.Description);

		// ...
	}
}
```

---

## Migration Notes

Path: /parser/java/migration-notes/

### Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Parser for Java since version 19.11:

*   [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) class is introduced as a **single entry point** to extract data from the document.       
*   Data extraction was unified for all data types.      
*   The overall document related classes were unified to common.      
*   Product architecture was redesigned from scratch in order to simplify passing options and classes to manipulate data.    
*   Document information and preview generation procedures were simplified.       
    

### How To Migrate?

Here is brief comparison of how to extract data using the old and new API.


  

#### Text

**Old coding style**

```java
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
try (TextExtractor extractor = factory.createTextExtractor(filePath)) {
    // Extract a text from the text extractor
    String textLine = null;
    do {
        textLine = extractor.extractLine();
        if (textLine != null) {
            System.out.println(textLine);
        }
    }
    while (textLine != null);
}
```

**New coding style**

```java
// Create an instance of Parser class
try (Parser parser = new Parser(filePath)) {
    // Extract a text to the reader
    try (TextReader reader = parser.getText()) {
        // Check if text extraction is supported
        if (reader == null) {
            System.out.println("Text extraction isn't supported.");
            return;
        }
        // Extract a text from the reader
        String textLine = null;
        do {
            textLine = reader.readLine();
            if (textLine != null) {
                System.out.println(textLine);
            }
        }
        while (textLine != null);
    }
}
```

  

#### Text Page

**Old coding style**

```java
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
try (TextExtractor extractor = factory.createTextExtractor(filePath)) {
    // Check if the extractor supports pagination
    IPageTextExtractor pte = extractor instanceof IPageTextExtractor
            ? (IPageTextExtractor) extractor
            : null;
    if (pte != null) {
        // Extract the first page
        System.out.println(pte.extractPage(0));
    }
}
```

**New coding style**

```java
// Create an instance of Parser class
try (Parser parser = new Parser(filePath)) {
    // Extract the first page text to the reader
    try (TextReader reader = parser.getText(0)) {
        // Check if text extraction is supported
        if (reader != null) {
            // Extract a text from the reader
            System.out.println(reader.readToEnd());
        }
    }
}
```

  

#### Search

**Old coding style**

```java
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
try (TextExtractor extractor = factory.createTextExtractor(filePath)) {
    // Check if the extractor supports search
    ISearchable se = extractor instanceof ISearchable
            ? (ISearchable) extractor
            : null;
    if (se != null) {
        // Create a handler
        ListSearchHandler handler = new ListSearchHandler();
        // Search "keyword" in the document
        se.search(new SearchOptions(null), handler, java.util.Arrays.asList(new String[]{"keyword"}));
        // Print search results
        for (SearchResult result : handler.getList()) {
            System.out.println(String.format("at %d: %s", result.getIndex(), result.getFoundText()));
        }
    }
}
```

**New coding style**

```java
// Create an instance of Parser class
try (Parser parser = new Parser(filePath)) {
    // Search "keyword" in the document
    Iterable<SearchResult> list = parser.search("keyword");
    // Check if search is supported
    if (list == null) {
        System.out.println("Search isn't supported.");
        return;
    }
    // Print search results
    for (SearchResult result : list) {
        System.out.println(String.format("at %d: %s", result.getPosition(), result.getText()));
    }
}
```

#### File Type Detection

**Old coding style**

```java
// Detect and print file type
System.out.println(CompositeMediaTypeDetector.DEFAULT.detect(filePath));
```

**New coding style**

```java
// Create an instance of Parser class
try (Parser parser = new Parser(filePath)) {
    // Detect and print file type
    System.out.println(parser.getDocumentInfo().getFileType());
}
```

  

#### Metadata

**Old coding style**

```java
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a metadata extractor
MetadataExtractor extractor = factory.createMetadataExtractor(filePath);
// Extract metadata
MetadataCollection metadata = extractor.extractMetadata(filePath);
// Print metadata
for (String key : metadata.getKeys()) {
    String value = metadata.get_Item(key);
    System.out.println(String.format("%s = %s", key, value));
}
```

**New coding style**

```java
// Create an instance of Parser class
try (Parser parser = new Parser(filePath)) {
    // Extract metadata
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Check if metadata extraction is supported
    if (metadata == null) {
        System.out.println("Metadata extraction isn't supported.");
        return;
    }
    // Print metadata
    for (MetadataItem item : metadata) {
        System.out.println(String.format("%s = %s", item.getName(), item.getValue()));
    }
}
```

#### Structure

**Old coding style**

```java
// Create an extractor factory
ExtractorFactory factory = new ExtractorFactory();
// Create a text extractor
try (TextExtractor extractor = factory.createTextExtractor(filePath)) {
    // Check if the extractor supports text structure extraction
    IStructuredExtractor se = extractor instanceof IStructuredExtractor
            ? (IStructuredExtractor) extractor
            : null;
    if (se != null) {
        // Create a handler
        Handler handler = new Handler();
        // Extract text structure
        se.extractStructured(handler);
        // Print hyperlinks
        for (String link : handler.getLinks()) {
            System.out.println(link);
        }
    }
}

// Handler for the hyperlink extraction
class Handler extends StructuredHandler {
    private final java.util.List<String> links;
    public Handler() {
        links = new java.util.ArrayList<String>();
    }
    public java.util.List<String> getLinks() {
        return links;
    }
    // Override the method to catch hyperlinks
    @Override
    protected void onStartHyperlink(HyperlinkProperties properties) {
        links.add(properties.getLink());
    }
}
```

**New coding style**

```java
// Create an instance of Parser class
try (Parser parser = new Parser(filePath)) {
    // Extract text structure to the XML reader
    Document document = parser.getStructure();
    // Check if text structure extraction is supported
    if (document == null) {
        System.out.println("Text structure extraction isn't supported.");
        return;
    }
    // Read XML document
    readNode(document.getDocumentElement());
}

void readNode(Node node) {
    NodeList nodes = node.getChildNodes();
    for (int i = 0; i < nodes.getLength(); i++) {
        Node n = nodes.item(i);
        if (n.getNodeName().toLowerCase() == "hyperlink") {
            Node a = n.getAttributes().getNamedItem("link");
            if (a != null) {
                System.out.println(a.getNodeValue());
            }
        }
        if (n.hasChildNodes()) {
            readNode(n);
        }
    }
}
```

---

## Migration Notes

Path: /redaction/java/migration-notes/

### Why To Migrate?

  
Here are the key reasons to use the new updated API provided by GroupDocs.Redaction for Java since version 19.6:

*   **Redactor** class introduced as a **single entry point** to manage the document redaction process (instead of **Document**class from previous versions).
    
*   Methods **redactWith()** of the **Document** class were replaced with similar **apply()** methods in **Redactor** class.
    
*   Method **Document.save(OutputStream, SaveOptions)** was replaced with **Redactor.save(OutputStream, RasterizationOptions)**.
*   Constructor **LoadOptions(DocumentFormatConfiguration)** was removed.  
    
*   **RedactionSummary** was renamed into **RedactorChangeLog**, **RedactionLogRecord** into **RedactorLogRecord**, **MetadataFilter** into **MetadataFilters**.  
    
*   Obsolete members were removed from Public API.
    
*   Added a number of new exception classes and base exception class for GroupDocs.Redaction exceptions.  
    

### How To Migrate?

The following example demonstrates how to redact Microsoft Office Word document and dumping statuses of applied redactions using old and new API:  

**Old coding style**

```java
// Load the file
Document doc = Redactor.load("Documents/Doc/sample.docx");
//Perform redaction using exact phrase
RedactionSummary summary = doc.redactWith(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[Personal]")));
for (RedactionLogEntry entry : summary.getRedactionLog())
{
	System.out.println(entry.getStatus());
}
//Save the resultant document
doc.save();
// Close the Document
doc.close();
```

**New coding style**

```java
// Load the file
Redactor redactor = new Redactor("Documents/Doc/sample.docx");
//Perform redaction using exact phrase
RedactorChangeLog summary = redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[Personal]")));
for (RedactorLogEntry entry : summary.getRedactionLog())
{
	System.out.println(entry.getResult().getStatus());
}
//Save the resultant document
redactor.save();
// Close the Redactor 
redactor.close();
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "redaction/java/developer-guide/migration-notes.md" >}}) documentation or [GitHub](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java) samples and showcases.

---

## Migration Notes

Path: /redaction/net/migration-notes/

### Why To Migrate?

  
Here are the key reasons to use the new updated API provided by GroupDocs.Redaction for .NET since version 19.9:

*   **Redactor** class introduced as a **single entry point** to manage the document redaction process (instead of **Document**class from previous versions).
    
*   Methods **RedactWith()** of the **Document** class were replaced with similar **Apply()** methods in **Redactor** class.
    
*   Method **Document.Save(Stream, SaveOptions)** was replaced with **Redactor.Save(Stream, RasterizationOptions)**.
*   Constructor **LoadOptions(DocumentFormatConfiguration)** was removed.  
    
*   Exception and option classes were put in separate namespaces.   
    
*   **RedactionSummary** was renamed into **RedactorChangeLog**, **RedactionLogEntry** into **RedactorLogEntry**, **MetadataFilter** into **MetadataFilters**.  
    
*   Obsolete members were removed from Public API.
    
*   Added a number of new exception classes and base exception class for GroupDocs.Redaction exceptions.  
    

### How To Migrate?

The following example demonstrates how to redact Microsoft Office Word document and dumping statuses of applied redactions using old and new API:  

**Old coding style**

```csharp
using (Document doc = Redactor.Load(@"Documents/Doc/sample.docx"))
{
    // Here we can use document instance to perform redactions
	RedactionSummary summary = doc.RedactWith(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
	foreach (RedactionLogEntry entry in summary.RedactionLog)
	{
		Console.WriteLine(entry.Status.ToString());
	}
    doc.Save();
}
```

**New coding style**

```csharp
using (Redactor redactor = new Redactor(@"Documents/Doc/sample.docx"))
{
    // Here we can use document instance to perform redactions
    RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
	foreach (RedactorLogEntry entry in result.RedactionLog)
	{
		Console.WriteLine(entry.Status.ToString());
	}
	redactor.Save();
}
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "redaction/net/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET) samples and showcases.

---

## Migration Notes

Path: /search/java/migration-notes/

### Why To Migrate?

Here are the main reasons for using the new updated API provided by GroupDocs.Search for Java from version 19.10:

*   Unified work with some similar entities to increase the intuitiveness of using API.
*   The architecture of the product has been revised and optimized, so that some functions will work faster.
*   Some entities have been renamed to improve code readability.
*   The changes made to the API are not too significant, so the migration will not be too difficult.
*   New functionality will not be added to the old API version, only to the new version.

### How To Migrate?

The following code examples demonstrate changes in the use of the API.

Old coding style:



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.addToIndex(documentsFolder);
 
// Creating a search parameters object
SearchParameters parameters = new SearchParameters();
parameters.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
parameters.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(2)); // Setting the number of possible differences for each word
 
// Searching in the index
SearchResults results = index.search("Happiness", parameters);
 
if (results.getCount() > 0) {
    // Generating HTML-formatted text of a document with highlighted search results
    index.highlightInText("c:\\Highlighted.html", results.get_Item(0));
}
```

New coding style:



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(2)); // Setting the number of possible differences for each word
 
// Searching in the index
SearchResult result = index.search("Happiness", options);
 
if (result.getDocumentCount() > 0) {
    // Generating HTML-formatted text of a document with highlighted search results
    index.highlight(result.getFoundDocument(0), new HtmlHighlighter(new FileOutputAdapter("c:\\Highlighted.html")));
}
```

---

## Migration Notes

Path: /search/net/migration-notes/

### Why To Migrate?

Here are the main reasons for using the new updated API provided by GroupDocs.Search for .NET from version 19.9:

*   Unified work with some similar entities to increase the intuitiveness of using API.
*   The architecture of the product has been revised and optimized, so that some functions will work faster.
*   Some entities have been renamed to improve code readability.
*   The changes made to the API are not too significant, so the migration will not be too difficult.
*   New functionality will not be added to the old API version, only to the new version.

### How To Migrate?

The following code examples demonstrate changes in the use of the API.

Old coding style:

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.AddToIndex(documentsFolder);
 
// Creating a search parameters object
SearchParameters parameters = new SearchParameters();
parameters.FuzzySearch.Enabled = true; // Enabling the fuzzy search
parameters.FuzzySearch.FuzzyAlgorithm = new TableDiscreteFunction(2); // Setting the number of possible differences for each word
 
// Searching in the index
SearchResults results = index.Search("Happiness", parameters);
 
if (results.Count > 0)
{
    // Generating HTML-formatted text of a document with highlighted search results
    index.HighlightInText(@"c:\Highlighted.html", results[0]);
}
```

New coding style:

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.FuzzySearch.Enabled = true; // Enabling the fuzzy search
options.FuzzySearch.FuzzyAlgorithm = new TableDiscreteFunction(2); // Setting the number of possible differences for each word
 
// Searching in the index
SearchResult result = index.Search("Happiness", options);
 
if (result.DocumentCount > 0)
{
    // Generating HTML-formatted text of a document with highlighted search results
    index.Highlight(result.GetFoundDocument(0), new HtmlHighlighter(new FileOutputAdapter(@"c:\Highlighted.html")));
}
```

---

## Migration Notes

Path: /signature/java/migration-notes/

### Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Signature for Java since version 19.11:

*   **Signature** class introduced as a **single entry point** to sing the document with various signature types with further verification and search with any supported file format.       
*   Document **signature options, verify options and search options were unified** for all document types. Instead of using document related options now options are related to signature type only.
*   The overall document related classes were unified to common. 
*   Product architecture was redesigned from scratch in order to simplify passing options and classes to manipulate signature.
*   Document information and preview generation procedures were simplified.  
    

### How To Migrate?

Here is a brief comparison of how to sign document with text signature using old and new API.  

**Old coding style**

```java
// setup Signature configuration
SignatureConfig signConfig =new SignatureConfig();
signConfig.setStoragePath("C:\\Storage");
signConfig.setOutputPath("C:\\Output");
// instantiating the conversion handler
SignatureHandler<String> handler = new SignatureHandler<String>(signConfig);
// setup text signature options
PdfSignTextOptions signOptions = new PdfSignTextOptions("John Smith");
// setup colors settings
signOptions.setBackgroundColor(Color.BLUE);
// setup text color
signOptions.setForeColor(Color.RED);
// setup Font options
signOptions.getFont().setBold(true);
signOptions.getFont().setItalic(true);
signOptions.getFont().setUnderline(true);
signOptions.getFont().setStrikeout(true);
signOptions.getFont().setFontFamily("Arial");
signOptions.getFont().setFontSize(15);
// sign document

SaveOptions saveOptions = new SaveOptions();
saveOptions.setOutputType(OutputType.String);
saveOptions.setOutputFileName("Pdf_TextSignatureFontBackgroundAndColorOptions");
String signedPath = handler.<String>sign("test.pdf", signOptions, saveOptions);
```

**New coding style**

```java
Signature signature = new Signature("sample.pdf");
TextSignOptions options = new TextSignOptions("John Smith");

// set signature position
options.setLeft(100);
options.setTop(100);

// set signature rectangle
options.setWidth(100);
options.setHeight(30);
// set text color and Font
options.setForeColor(Color.RED);
SignatureFont signatureFont = new SignatureFont();
signatureFont.setSize(12);
signatureFont.setFamilyName("Comic Sans MS");
options.setFont(signatureFont);
 
// sign document to file
signature.sign("signed.pdf", options);
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "signature/java/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java/) samples and showcases.

---

## Migration Notes

Path: /signature/net/migration-notes/

### Why To Migrate?
  
Here are the key reasons to use the new updated API provided by GroupDocs.Signature for .NET since version 19.8:

* [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class introduced as a **single entry point** to sing the document with various signature types with further verification and search with any supported file format.
* Document **signature options** ([SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions)), **verify options** ([VerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/verifyoptions)) and **search options** ([SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions)) were unified for all document types. Instead of using document related options now options are related to signature type only.
* The overall document related classes were unified to common.
* Product architecture was redesigned from scratch in order to simplify passing options and classes to manipulate signature.
* Document information and preview generation procedures were simplified.

### How To Migrate?

Here is a brief comparison of how to sign document with text signature using old and new API.  

#### Old coding style

```csharp
// setup Signature configuration
SignatureConfig signConfig = new SignatureConfig
{
    StoragePath = @"c:\Aspose\Test\Storage",
    OutputPath = @"c:\Aspose\Test\Output"
};
// instantiating the signature handler
SignatureHandler handler = new SignatureHandler(signConfig);
// setup text signature options
PdfSignTextOptions signOptions = new PdfSignTextOptions("John Smith")
{
    // locate signature
    Left = 100, Top = 100, Width = 100, Height = 30,
    // set Text color and Font
    ForeColor = Color.Red,
    Font = new SignatureFont { FontSize = 12, FontFamily = "Comic Sans MS" }
};
SaveOptions saveOptions = new SaveOptions { OutputType = OutputType.String, OutputFileName = "signed.pdf" };
// sign document
string signedPath = handler.Sign<string>("test.pdf", signOptions,saveOptions);
Console.WriteLine("Signed file path is: " + signedPath);
```

#### New coding style

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // locate signature
        Left = 100, Top = 100, Width = 100, Height = 30,
        // set Text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "signature/net/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET/) samples and showcases.

---

## Migration Notes

Path: /watermark/java/migration-notes/

## Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Watermark for Java since version 20.1:

*   *Watermarker* class is introduced as a **single entry point** to manage watermarks in the document (instead of *Document*class from previous versions).
*   Adding watermarks was unified for all supported document formats.
*   Product architecture was redesigned from scratch in order to simplify passing options to manage watermarks.
*   Document information and preview generation procedures were simplified.

## How To Migrate?

Here is brief comparison of how to manage watermarks using the old and new API.


### Load Documents

#### Any Supported Format

The folowing examples show how to load a document of any supported format.

**Old API**

```java
Document doc = Document.load("test.doc");
// watermarking goes here
// ...
doc.close(); 
```

**New API**

```java
Watermarker watermarker = new Watermarker("test.doc");
// watermarking goes here
// ...
doc.close();
```

#### Document of Specific Format

The following examples show how to load a diagram document.

**Old API**

```java
DiagramDocument doc = Document.load(DiagramDocument.class, "diagram.vsdx");
// watermarking goes here
// ...
doc.close();
```

**New API**

```java
DiagramLoadOptions loadOptions = new DiagramLoadOptions();
Watermarker watermarker = new Watermarker("diagram.vsdx", loadOptions);
// watermarking goes here
// ...
doc.close();
```

### Add watermarks

The following examples show how to add text watermark to a document of any supported type.

**Old API**

```java
for (File file : new File("Documents").listFiles())
{
    Document document = Document.load(file.getPath());

    TextWatermark watermark = new TextWatermark("top secret", new Font("Arial", 36))
    watermark.setForegroundColor(Color.getRed());
    watermark.setHorizontalAlignment(HorizontalAlignment.Center);
    watermark.setVerticalAlignment(VerticalAlignment.Center);

    document.addWatermark(watermark);
    document.save(file.getPath() + ".watermarked");
    document.close();
}
```

**New API**

```java
for (File file : new File("Documents").listFiles())
{                                                                                       
    Watermarker watermarker = new Watermarker(file.getPath());

    TextWatermark watermark = new TextWatermark("top secret", new Font("Arial", 36));
    watermark.setForegroundColor(Color.getRed());
    watermark.setHorizontalAlignment(HorizontalAlignment.Center);
    watermark.setVerticalAlignment(VerticalAlignment.Center);

    watermarker.add(watermark);
    watermarker.save();                                                             
    watermarker.close();
}
```

#### Add Watermark with Options

The following examples show how to add watermark to the first page of a diagram document.

**Old API**

```java
DiagramDocument doc = Document.load(DiagramDocument.class, "diagram.vsdx");

TextWatermark textWatermark = new TextWatermark("Test watermark", new Font("Calibri", 19));

doc.getPages().get_Item(0).addWatermark(textWatermark);

doc.save();
doc.close(); 
```

**New API**

```java
Watermarker watermarker = new Watermarker("diagram.vsdx", new DiagramLoadOptions());

TextWatermark textWatermark = new TextWatermark("Test watermark", new Font("Calibri", 19));

DiagramPageWatermarkOptions options = new DiagramPageWatermarkOptions();
options.setPageIndex(0);

watermarker.add(textWatermark, options);

watermarker.save();
watermarker.close(); 
```

### Search Watermarks

The following examles show how to find watermarks using search criteria.

**Old API**

```java
Document doc = Document.load("test.some_ext");

SizeSearchCriteria widthRange = new SizeSearchCriteria(Dimension.Width, 50, 100);
RotateAngleSearchCriteria rotateAngle = new RotateAngleSearchCriteria(0, 45);
TextSearchCriteria textCriteria = new TextSearchCriteria(Pattern.compile("^Test watermark$"));

PossibleWatermarkCollection watermarks = doc.findWatermarks(textCriteria.and(widthRange.or(rotateAngle)));

System.out.println("Found " + watermarks.Count + " possible watermarks.");

doc.close(); 
```

**New API**

```java
Watermarker watermarker = new Watermarker("test.some_ext");

SizeSearchCriteria widthRange = new SizeSearchCriteria(Dimension.Width, 50, 100);
RotateAngleSearchCriteria rotateAngle = new RotateAngleSearchCriteria(0, 45);
TextSearchCriteria textCriteria = new TextSearchCriteria(Pattern.compile("^Test watermark$"));

PossibleWatermarkCollection watermarks = watermarker.search(textCriteria.and(widthRange.or(rotateAngle)));

System.out.println("Found " + watermarks.Count + " possible watermarks.");

watermarker.close();
```

### Remove Watermarks

The following examples show how to remove all possible watermarks.

**Old API**

```java
Document doc = Document.load("document.pdf");

PossibleWatermarkCollection watermarks = doc.findWatermarks();
watermarks.clear();
doc.save("document_without_watermarks.pdf");

doc.close(); 
```

**New API**

```java
Watermarker watermarker = new Watermarker("document.pdf");

PossibleWatermarkCollection watermarks = watermarker.search();
watermarker.remove(watermarks);
watermarker.save("document_without_watermarks.pdf");

watermarker.close();
```

### Get Document Info

The following examples show how to get document information from the local file.

**Old API**

```java
DocumentInfo documentInfo = Document.getInfo("test.ppt");
System.out.println(documentInfo.getFileFormat());
System.out.println(documentInfo.isEncrypted());
```

**New API**

```java
Watermarker watermarker = new Watermarker("test.ppt");

IDocumentInfo info = watermarker.getDocumentInfo();
System.out.println("File type: " + info.getFileType());
System.out.println("Number of pages: " + info.getPageCount());
System.out.println("Document size: " + info.getSize() + " bytes");

watermarker.close(); 
```

---

## Modifying found watermark properties

Path: /watermark/java/modifying-found-watermark-properties/

GroupDocs.Watermark also allows you to replace text and image in the found possible watermarks. Following sections will show you how to replace text and image of a found watermark.

## Replacing text

To replace text of the found watermarks, loop through the possible watermarks in the [watermark collection](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/PossibleWatermarkCollection) and call [setText()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/PossibleWatermark#setText(java.lang.String)) method as shown in the following code sample.

**advanced\_usage.searching\_and\_modifying\_watermarks.EditTextInFoundWatermarks**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
TextSearchCriteria searchCriteria = new TextSearchCriteria("test", false);                               
PossibleWatermarkCollection watermarks = watermarker.search(searchCriteria);                             
for (PossibleWatermark watermark : watermarks)                                                           
{                                                                                                        
    try                                                                                                  
    {                                                                                                    
        // Edit text                                                                                     
        watermark.setText("passed");                                                                     
    }                                                                                                    
    catch (Exception e)                                                                                  
    {                                                                                                    
        // Found entity may not support text editing                                                     
        // Passed argument can have inappropriate value                                                  
        // Process such cases here                                                                       
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

## Replacing text with formatting

You can also replace the watermark's text with [formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/PossibleWatermark#getFormattedTextFragments()) as shown in the below code sample.

**advanced\_usage.searching\_and\_modifying\_watermarks.EditTextWithFormattingInFoundWatermarks**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"                             
Watermarker watermarker = new Watermarker("document.pdf");                                                                   
                                                                                                                                      
TextSearchCriteria searchCriteria = new TextSearchCriteria("test", false);                                                            
PossibleWatermarkCollection watermarks = watermarker.search(searchCriteria);                                                          
for (PossibleWatermark watermark : watermarks)                                                                                        
{                                                                                                                                     
    try                                                                                                                               
    {                                                                                                                                 
        // Edit text                                                                                                                  
        watermark.getFormattedTextFragments().clear();                                                                                
        watermark.getFormattedTextFragments().add("passed", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                                 
    catch (Exception e)                                                                                                               
    {                                                                                                                                 
        // Found entity may not support text editing                                                                                  
        // Passed arguments can have inappropriate value                                                                              
        // Process such cases here                                                                                                    
    }                                                                                                                                 
}                                                                                                                                     
                                                                                                                                      
// Save document                                                                                                                      
watermarker.save("document.pdf");                                                                                           
                                                                                                                                      
watermarker.close();                                                                                                                  
```

## Replacing image

Following code sample shows how to replace the image of the found watermarks using GroupDocs.Watermark.

**advanced\_usage.searching\_and\_modifying\_watermarks.ReplacesImageInFoundWatermarks**

```java
File imageFile = new File("image.png");                                                           
byte[] imageData = new byte[(int) imageFile.length()];                                                   
InputStream imageInputStream = new FileInputStream(imageFile);                                           
imageInputStream.read(imageData);                                                                        
imageInputStream.close();                                                                                
                                                                                                         
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf");                                      
                                                                                                         
// Search watermark matching a particular image                                                          
SearchCriteria searchCriteria = new ImageDctHashSearchCriteria("logo.bmp");                       
PossibleWatermarkCollection watermarks = watermarker.search(searchCriteria);                             
for (PossibleWatermark watermark : watermarks)                                                           
{                                                                                                        
    try                                                                                                  
    {                                                                                                    
        // Replace image                                                                                 
        watermark.setImageData(imageData);                                                               
    }                                                                                                    
    catch (Exception e)                                                                                  
    {                                                                                                    
        // Found entity may not support image replacement                                                
        // Passed image can have inappropriate format                                                    
        // Process such cases here                                                                       
    }                                                                                                    
}                                                                                                        
                                                                                                         
// Save document                                                                                         
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```


---

## Multicolored Numbered List in Presentation Document

Path: /assembly/java/multicolored-numbered-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Presentation Document format.{{< /alert >}}

## Multicolored Numbered List in Microsoft PowerPoint Document

### Creating a Multicolored Numbered List

Practicing the following steps you can create Multicolored Numbered List Template in MS PowerPoint 2013.

1.  In your document, write a sentence like "We provide support for the following clients:".
2.  Start numbered list.
3.  Go to the "Design" tab and select color to make it colored list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the clients in numbered list.
*   It must highlight the products.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

We provide support for the following clients:

<ol>
<li>&lt;&lt;foreach [in getClients()]>>&lt;&lt;if [indexOf() % 2 == 0]>>&lt;&lt;[getName()]>></li>
<li style="background-color: #ceffbc">&lt;&lt;else>>&lt;&lt;[getName()]>></li>
</ol>

​		<</if>><</foreach>>

### Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Multicolored%20Numbered%20List.pptx?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](){{< /alert >}}{{< gist atirtahirgroupdocs 12b6ec3b323811a352fe887de98e37b7 >}}



### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Multicolored Numbered List in Presentation Document

Path: /assembly/net/multicolored-numbered-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Multicolored Numbered List in Microsoft PowerPoint Document

### Creating a Multicolored Numbered List

Practising the following steps you can create Multicolored Numbered List Template in MS PowerPoint 2013.

1.  In your document, write a sentence like "We provide support for the following products:".
2.  Start numbered list.
3.  Go to the "Design" tab and select color to make it colored list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in numbered list.
*   It must highlight the products.
*   The report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;foreach [in orders]&gt;&gt;&lt;&lt;if [Price &gt;= 400]&gt;&gt;&lt;&lt;[Customer.CustomerName]&gt;&gt;</span></p></td><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[Customer.CustomerName]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 108%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 8pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; c.Price)]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Multicolored%20Numbered%20List.pptx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Multicolored Numbered List\_XML.pptx](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Multicolored%20Numbered%20List_XML.pptx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 5e5f0065e670db7d7467c24bc9ab20b1 >}}

#### Database Entities

{{< gist GroupDocsGists ec5aa9bf0aef124323d6be3cf64103dc >}}

#### Using DataSet

{{< gist GroupDocsGists 4d6374c206d0c5542eeac637f1f6542c >}}

#### Using XML DataSource

{{< gist GroupDocsGists 0237cc5e3df88002b22ac8580bcbe039 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists bb8683af4ca31227bb36954b15b21299 >}}

## Multicolored Numbered List in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Multicolored Numbered List' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Multicolored Numbered List\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Multicolored%20Numbered%20List_OpenDocument.odp?raw=true) (use same template for database, dataset and JSON examples)
*   [Multicolored Numbered List\_XML\_OpenDocument.odp](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Multicolored%20Numbered%20List_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists 45de4042f2e5280dd590dcd944663d49 >}}

#### Database Entities

{{< gist GroupDocsGists efa64394b5d02a0d4c2371933424fb78 >}}

#### Using DataSet

{{< gist GroupDocsGists 1bf5a2ee72180eeb1855c15d9926e840 >}}

#### Using XML DataSource

{{< gist GroupDocsGists a0aa38544a9141103f8a3bedfc69a07f >}}

#### Using JSON DataSource

{{< gist GroupDocsGists fa64bc092425100112d358209f031742 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Numbered List in Presentation Document

Path: /assembly/java/numbered-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Numbered List in Microsoft PowerPoint Document

### Creating a Numbered List

Practising the following steps you can create Numbered List Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Write a sentence like "We provide support for the following clients:".
3.  Start numbered list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the client names in a numbered list.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
1<<foreach [in getClients()]>><<[getName()]>>
<</foreach>>
```

### Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Numbered%20List.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 284dcf48c48ab542fcb196cff290ac51 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Numbered List in Presentation Document

Path: /assembly/net/numbered-list-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Numbered List in Microsoft PowerPoint Document

### Creating a Numbered List

Practising the following steps you can create Numbered List Template in MS PowerPoint 2013.

1.  Add a new presentation slide.
2.  Write a sentence like "We provide support for the following products:".
3.  Start numbered list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in numbered list.
*   The report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
1.	<<foreach [in products]>><<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Numbered%20List.pptx?raw=true) (Template for DataBase, DataSet and JSON examples)
*   [Numbered List\_XML.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Numbered%20List_XML.pptx?raw=true) (Template for XML Data examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 9938d1ac7bfd4055d7d9e320740d5b7c >}}

#### Database Entities

{{< gist GroupDocsGists 6c0521527ce3db2a2e9dc7ff226afec9 >}}

#### Using DataSet

{{< gist GroupDocsGists 907febef1b581c1581f030e3544b07d3 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 714f7c87e58432e958b3c9dba775ca10 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 2ed14faca3d0cad68134c45c0e4148ea >}}

## Numbered List in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [Wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Numbered List' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Presentation" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Numbered List\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Numbered%20List_OpenDocument.odp?raw=true) (use same template for database, dataset and JSON examples)
*   [Numbered List\_XML\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Numbered%20List_XML_OpenDocument.odp?raw=true)

### Generating the Report

#### Custom Objects

{{< gist GroupDocsGists ffa616e4e2add07dbe09e961622a9bb3 >}}

#### Database Entities

{{< gist GroupDocsGists 21f96063d1786eac6c824d0997498f91 >}}

#### Using DataSet

{{< gist GroupDocsGists f21b85a611d8c90fd2209dfbd7fc7ef3 >}}

#### Using XML DataSource

{{< gist GroupDocsGists c63cf0d328d422573d8969157bdf1ce9 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 350bf392a2baa8220b97363f9bcff887 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Load document of specific format

Path: /watermark/net/load-document-of-specific-format/

The constructors [Watermarker(String)](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) and [Watermarker(Stream)](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/main) can load a document of any supported format. When you're loading a document, GroupDocs.Watermark automatically detects its type and creates an instance of the appropriate class. If document format is not supported, constructor throws [UnsupportedFileTypeException](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.exceptions/unsupportedfiletypeexception). If you need specify the format of a document to load, you can use constructors with [LoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options/loadoptions) parameter.

The following example demonstrates how to create a watermarker for the Spreadsheet document:

**AdvancedUsage.LoadingDocuments.LoadingDocumentOfSpecificFormat**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
string filePath = "spreadsheet.xlsx";
var loadOptions = new LoadOptions()
{
    FileType = FileType.FromExtension(Path.GetExtension(filePath))
};

// Or set the FormatFamily property directly when using a stream, for example:
loadOptions.FormatFamily = FormatFamily.Spreadsheet;

using (Watermarker watermarker = new Watermarker(filePath, loadOptions))
{
    // use watermarker methods to manage watermarks in the Spreadsheet document
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
    watermarker.Add(watermark);
    watermarker.Save("spreadsheet.xlsx");
}

```

Any supported format family has the specific [LoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options/loadoptions) descendant:

| Format | LoadOptions descendant |
| --- | --- |
| Diagram | [DiagramLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.diagram/diagramloadoptions) |
| Email | [EmailLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.email/emailloadoptions) |
| Image | [ImageLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.image/imageloadoptions) |
| GIF Image | [GifImageLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.image/gifimageloadoptions) |
| TIFF Image | [TiffImageLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.image/tiffimageloadoptions) |
| PDF | [PdfLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.pdf/pdfloadoptions) |
| Presentation | [PresentationLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.presentation/presentationloadoptions) |
| Spreadsheet | [SpreadsheetLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.spreadsheet/spreadsheetloadoptions) |
| WordProcessing | [WordProcessingLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingloadoptions) |


---

## Optimize spreadsheets in a PDF file

Path: /viewer/java/optimization-pdf-spreadsheets/

This optimization allows to reduce the output file size by setting up border lines. Besides that, it removes the Arial and Times New Roman characters of 32-127 codes.

The default value is `false`.


The following code snippet shows how to optimize spreadsheets in a PDF file:

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("invoice.xlsx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    PdfOptimizationOptions optimizationOptions = new PdfOptimizationOptions();
    optimizationOptions.setOptimizeSpreadsheets(true);
    viewOptions.setPdfOptimizationOptions(optimizationOptions);
    viewer.view(viewOptions);
}
```
{{</ tab >}}
{{</ tabs >}}

---

## Optimize spreadsheets in a PDF file

Path: /viewer/net/optimization-pdf-spreadsheets/

This optimization allows to reduce the output file size by setting up border lines. Besides that, it removes the Arial and Times New Roman characters of 32-127 codes.

The default value is `false`.


The following code snippet shows how to optimize spreadsheets in a PDF file:

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions 
    {
        OptimizeSpreadsheets = true
    };

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions With {
                .OptimizeSpreadsheets = True
                }

            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Optimize spreadsheets in a PDF file

Path: /viewer/python-net/optimization-pdf-spreadsheets/

This optimization allows to reduce the output file size by setting up border lines. Besides that, it removes the Arial and Times New Roman characters of 32-127 codes.

The default value is `False`.


The following code snippet shows how to optimize spreadsheets in a PDF file:

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def optimize_spreadsheets():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        viewOptions = PdfViewOptions("optimize_spreadsheets/optimized_spreadsheet.pdf")
        viewOptions.pdf_optimization_options = PdfOptimizationOptions()
        viewOptions.pdf_optimization_options.optimize_spreadsheets = True

        viewer.view(viewOptions)

if __name__ == "__main__":
    optimize_spreadsheets()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/optimization-pdf-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Pie Chart in Presentation Document

Path: /assembly/java/pie-chart-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Pie Chart in Microsoft PowerPoint Document

### Creating a Pie Chart

Please follow below steps to create Pie Chart in MS PowerPoint 2013:

1.  Add a new presentation slide.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Pie".
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document.
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/pie-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to share managers' contract prices dynamically with the following key requirements:

*   Report must show information on a Pie Chart.
*   It must indicate manager name with value (price of the contract).
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Price<<foreach [in getManagers()]>><<x [getName()]>>
```

#### Chart Data (Excel)

<table class="MsoTableGrid" border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td><td width="312" valign="bottom" style="width: 233.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Total Contract Price&lt;&lt;y [getContracts().sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">A</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">8.2</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">B</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">3.2</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">C</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">1.4</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">D</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p class="MsoNormal" style="margin-bottom: 0.0001pt; line-height: normal;">1.2</p></td></tr></tbody></table>
### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Pie Chart.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Pie%20Chart.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists b344e5c858da2e199934baf7038aee66 >}}

## Pie Chart in OpenOffice Presentation Document

To be investigated.

---

## Pie Chart in Presentation Document

Path: /assembly/net/pie-chart-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Pie Chart in Microsoft PowerPoint Document

### Creating a Pie Chart

Please follow below steps to create Pie Chart in MS PowerPoint 2013:

1.  Add a new presentation slide.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Pie".
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your document.
5.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/pie-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine)
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to share your customers' orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart.
*   It must indicate customer name with value (price of the orders purchased).
*   The report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total Order Price&lt;&lt;y [</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">8.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.4</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.2</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Pie Chart.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Pie%20Chart.pptx?raw=true) (Template for CustomObject and JSON examples) 
*   [Pie Chart\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Pie%20Chart_DB.pptx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists d8e5e6c2c67586251d1eb916e67836a3 >}}



#### Database Entities

{{< gist GroupDocsGists cf1b09d04d490cc9fb6d572ee00bbcb0 >}}



#### Using DataSet

{{< gist GroupDocsGists 68638095f8040c6aaf6d5e91f2c82435 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 1fd8106e2af73a753ac7bcddca1cd82f >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 23fa67fa7663c12a0486f949adbda8fd >}}



## Pie Chart in OpenOffice Presentation Document

To be investigated.

---

## Save signed Presentation with different output file type

Path: /signature/java/save-signed-presentation-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports saving of Presentation signed documents with different formats. Each of document type has list of compatible saving type. These values are listed in enum [PresentationSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/PresentationSaveFileFormat).

Here are the steps to save signed Presentation document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java):

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate required signature options.    
*   Instantiate the [PresentationSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/PresentationSaveOptions) object according to your requirements and specify [setFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/PresentationSaveOptions#setFileFormat(int)) as one of predefined values from [PresentationSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/PresentationSaveFileFormat). 
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signatureoptions and [PresentationSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/PresentationSaveOptions) object to it.
    

Following example demonstrates how to save signed Presentation document with different output type

```java
Signature signature = new Signature("sample.ppsx");
// create QRCode option with predefined QRCode text
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
PresentationSaveOptions saveOptions = new PresentationSaveOptions();
saveOptions.setFileFormat(PresentationSaveFileFormat.Tiff);
saveOptions.setOverwriteExistingFiles(true);
// sign document to file
signature.sign("SignedPPsx.tiff", signOptions, saveOptions);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to save Presentation with different file type

Path: /signature/net/save-signed-presentation-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving of Presentation signed documents with different formats. Each of document type has list of compatible saving type. These values are listed in enum [PresentationSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/presentationsavefileformat).

Here are the steps to save signed Presentation document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the [PresentationSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/presentationsaveoptions) object according to your requirements and specify [FileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/presentationsaveoptions/fileformat) as one of predefined values from [PresentationSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/presentationsavefileformat).  
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signatureoptions and [PresentationSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/presentationsaveoptions) [](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/presentationsaveoptions) object to it.

Following example demonstrates how to save signed Presentation document with different output type

```csharp
using (Signature signature = new Signature("sample.ppsx"))
{
    // create QRCode option with predefined QRCode text
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        // setup QRCode encoding type
        EncodeType = QRCodeTypes.QR,
        // set signature position
        Left = 100,
        Top = 100
    };
    PresentationSaveOptions saveOptions = new PresentationSaveOptions()
    {
        FileFormat = PresentationSaveFileFormat.Tiff,
        OverwriteExistingFiles = true
    };
    // sign document to file
    signature.Sign("SignedPPsx", signOptions, saveOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Processes cancellation

Path: /signature/java/processes-cancellation/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports cancellation for each of document processing (Sign, Verify, Search). The process cancellation happens over setting property [getCancel](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.handler.events/ProcessProgressEventArgs#getCancel()) of [ProcessProgressEventArgs](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.handler.events/ProcessProgressEventArgs) property in proper event handler.

*   for [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) process this flag should be set to true in handler of [SignProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SignProgress) event. This event occurs each time on signing each signature was completed.
*   for [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) process this flag should be set to true in handler of [VerifyProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#VerifyProgress) event. This event occurs each time on verifying document page.
*   for [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) process this flag should be set to true in handler of [SearchProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SearchProgress) event. This event occurs each time on searching document page per each options.  

## Cancel signing process

Here are the steps to provide cancellation for signing process with GroupDocs.Signature:

*   Define [SignProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SignProgress) event handler delegates to conditionally cancel the process.
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Subscribe for [SignProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SignProgress) event with proper handler method
*   Instantiate required [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) object 
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signature options in it
   
    

```java
private static void onSignProgress(Signature sender, ProcessProgressEventArgs args) {
    // check if process takes more than 1 second (1000 milliseconds) processing cancellation
    if (args.getTicks() > 1000) {
        args.setCancel(true);
        System.out.print("Sign progress was cancelled. Time spent " + args.getTicks() + " mlsec");
    }
}
 
public static void run() {   
    try {
        Signature signature = new Signature("Sample.pdf");
        signature.SignProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                onSignProgress(sender, args);
            }
        });
 
        TextSignOptions options = new TextSignOptions("John Smith") {
            // ...
        };
 
        // sign document to file
        signature.sign("Signed.pdf", options);
            System.out.print("\nSource document signed successfully.\nFile saved at " + outputFilePath);
 
    } catch (Exception e) {
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## Cancel verification process

Here are the steps to provide cancellation for verification process with GroupDocs.Signature:

*   Define [VerifyProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#VerifyProgress) event handler delegates to conditionally cancel the process.    
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Subscribe for [VerifyProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#VerifyProgress) event with proper handler method      
*   Instantiate required [VerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/VerifyOptions)  object       
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass verification options in it.
    

```java
private static void onVerifyProgress(Signature sender, ProcessProgressEventArgs args) {
    // check if process takes more than 1 second (1000 milliseconds) processing cancellation
    if (args.getTicks() > 1000) {
        args.setCancel(true);
        System.out.print("Verify progress was cancelled. Time spent " + args.getTicks() + " mlsec");
    }
}
 
public static void run() {   
 
    try {
        Signature signature = new Signature("SampleSigned.pdf");
        signature.VerifyProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                onVerifyProgress(sender, args);
            }
        });
 
        TextVerifyOptions options = new TextVerifyOptions("John Smith")
        {
            // ...
        };
 
        // sign document to file
        VerificationResult result = signature.verify(options);
    } catch (Exception e) {
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## Cancel search process

Here are the steps to provide cancellation of searching process with GroupDocs.Signature:

*   Define [SearchProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SearchProgress) event handler delegates to conditionally cancel the process.    
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Subscribe for [SearchProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SearchProgress) event with proper handler method      
*   Instantiate required[ SearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions) object       
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass search options in it
    
```java
private static void onSearchProgress(Signature sender, ProcessProgressEventArgs args) {
    // check if process takes more than 1 second (1000 milliseconds) processing cancellation
    if (args.getTicks() > 1000) {
        args.setCancel(true);
        System.out.print("Search progress was cancelled. Time spent " + args.getTicks() + " mlsec");
    }
}
 
public static void run() {   
 
    try {
        Signature signature = new Signature("SampleSigned.pdf");
        signature.SearchProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                onSearchProgress(sender, args);
            }
        });
 
        QrCodeSearchOptions options = new QrCodeSearchOptions(QrCodeTypes.QR) {
            // ...
        };
 
        // search for signatures in document
        List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class, options);
        System.out.print("\nSource document contains following signatures.");
        for(QrCodeSignature qr_signature : signatures)
        {
            System.out.print("QRCode signature found at page "+qr_signature.getPageNumber()+" with type "+ qr_signature.getEncodeType()+" and text " + qr_signature.getText());
        }
    } catch (Exception e) {
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Processes cancellation

Path: /signature/net/processes-cancellation/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports cancellation for each of document processing (Sign, Verify, Search). The process cancellation happens over setting property [Cancel](https://reference.groupdocs.com/signature/net/groupdocs.signature/processprogresseventargs/cancel) of [ProcessProgressEventArgs](https://reference.groupdocs.com/signature/net/groupdocs.signature/processprogresseventargs/) property in proper event handler.

* for [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) process this flag should be set to true in handler of [SignProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/signprogress) event. This event occurs each time on signing each signature was completed.
* for [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) process this flag should be set to true in handler of [VerifyProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verifyprogress) event. This event occurs each time on verifying document page.
* for [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) process this flag should be set to true in handler of [SearchProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/searchprogress) event. This event occurs each time on searching document page per each options.  

## Cancel signing process

Here are the steps to provide cancellation for signing process with GroupDocs.Signature:

* Define [SignProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/signprogress) event handler delegates to conditionally cancel the process.
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Subscribe for [SignProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/signprogress) event with proper handler method.
* Instantiate required [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signature options in it.

```csharp
private static void OnSignProgress(Signature sender, ProcessProgressEventArgs args)
{
    // check if process takes more than 1 second (1000 milliseconds) processing cancellation
    if(args.Ticks > 1000)
    {
        args.Cancel = true;
        Console.WriteLine("Sign progress was cancelled. Time spent {0} mlsec", args.Ticks);
    }
}
/// <summary>
/// Sign document with text signature applying specific options
/// </summary>
public static void Run()
{
    using (Signature signature = new Signature("sample.docx"))
    {
        signature.SignProgress += OnSignProgress;
        TextSignOptions options = new TextSignOptions("John Smith")
        {
            // ...
        };
        // sign document to file
        signature.Sign("signedSample", options);
    }
}
```

## Cancel verification process

Here are the steps to provide cancellation for verification process with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Define [VerifyProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verifyprogress) event handler delegates to conditionally cancel the process.
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Subscribe for [VerifyProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verifyprogress) event with proper handler method.  
* Instantiate required [VerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/verifyoptions)  object.
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass verification options in it.

```csharp
private static void OnVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    // check if process takes more than 1 second (1000 milliseconds) processing cancellation
    if (args.Ticks > 1000)
    {
        args.Cancel = true;
        Console.WriteLine("Sign progress was cancelled. Time spent {0} mlsec", args.Ticks);
    }
}
public static void Run()
{
    using (Signature signature = new Signature("SignedSample.pdf"))
    {
        signature.VerifyProgress += OnVerifyProgress;
        TextVerifyOptions options = new TextVerifyOptions("John Smith")
        {
            // ...
        };
        // sign document to file
        VerificationResult result = signature.Verify(options);
    }
}
```

## Cancel search process

Here are the steps to provide cancellation of searching process with GroupDocs.Signature:

* Define [SearchProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/searchprogress) event handler delegates to conditionally cancel the process.
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Subscribe for [SearchProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/searchprogress) event with proper handler method.
* Instantiate required[SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) object.
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass search options in it.

```csharp
private static void OnSearchProgress(Signature sender, ProcessProgressEventArgs args)
{
    // check if process takes more than 1 second (1000 milliseconds) processing cancellation
    if (args.Ticks > 1000)
    {
        args.Cancel = true;
        Console.WriteLine("Sign progress was cancelled. Time spent {0} mlsec", args.Ticks);
    }
}
public static void Run()
{
    using (Signature signature = new Signature("sampleSigned.pdf"))
    {
        signature.SearchProgress += OnSearchProgress;
        QrCodeSearchOptions options = new QrCodeSearchOptions(QrCodeTypes.QR)
        {
            // ...
        };
        // search for signatures in document
        List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
        Console.WriteLine("\nSource document contains following signatures.");
        foreach (var QrCodeSignature in signatures)
        {
            Console.WriteLine("QRCode signature found at page {0} with type {1} and text {2}", QrCodeSignature.PageNumber, QrCodeSignature.EncodeType, QrCodeSignature.Text);
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Protecting word processing documents

Path: /watermark/net/protecting-word-processing-documents/

Since version 18.6, GroupDocs.Watermark provides a simplified way of protecting the Word documents with the password. The API allows you to protect as well as unprotect the Word documents. The following protection types are supported:

* *AllowOnlyRevisions*: user can only add revision marks to the document.
* *AllowOnlyComments*: user can only modify comments in the document.
* *AllowOnlyFormFields*: user can only enter data in the form fields in the document.
* *ReadOnly*: no changes are allowed to the document.

The protection types are added to the [*WordProcessingProtectionType*](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingprotectiontype) enum. Following code samples demonstrate how to protect and unprotect Word documents.

## Protecting a document

Following code sample [protects](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingcontent/methods/protect) a Word document with the password.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingProtectDocument**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
    content.Protect(WordProcessingProtectionType.ReadOnly, "7654321");
    watermarker.Save("document.docx");
}
```

## Unprotecting a document

The following code sample shows how to [unprotect](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.wordprocessing/wordprocessingcontent/methods/unprotect) a Word document regardless of password.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingUnProtectDocument**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
    content.Unprotect();
    watermarker.Save("document.docx");
}
```


---

## Protecting word processing documents

Path: /watermark/python-net/protecting-word-processing-documents/


You can protect Word documents with a password or remove protection. Supported protection types:

- AllowOnlyRevisions
- AllowOnlyComments
- AllowOnlyFormFields
- ReadOnly

## Protecting a document
This sample enables document protection with a specified protection type and password.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    content.protect(gwc_wp.WordProcessingProtectionType.READ_ONLY, "7654321")
    watermarker.save("document.docx")
```

## Unprotecting a document
This sample removes protection from the document so it can be edited freely.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    content.unprotect()
    watermarker.save("document.docx")
```



---

## Rasterize document or page

Path: /watermark/net/rasterize-document-or-page/

## How to remove a watermark from a pdf 
The watermark can be removed from the PDF documents using third-party tools. However, if you want to remove a watermark that is almost impossible to remove, you can rasterize pdf documents. GroupDocs.Watermark provides the feature to convert all the pages of a PDF document to raster images with only one line of code.

## Rasterize PDF document

Following code snippet is used to [rasterize](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfcontent/methods/rasterize) the PDF document to protect added watermarks.  

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRasterizeDocument**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Do not copy", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;
    watermark.Opacity = 0.5;

    // Add watermark of any type first
    watermarker.Add(watermark);
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();

    // Rasterize all pages
    pdfContent.Rasterize(100, 100, PdfImageConversionFormat.Png);

    // Content of all pages is replaced with raster images
    watermarker.Save("document.pdf");
}
```

{{< alert style="warning" >}}You can't restore document content after saving the document. Rasterization significantly increases the size of the resultant PDF file.{{< /alert >}}

## Rasterize particular page of the PDF document

The API also allows you to [rasterize](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.pdf/pdfpage/methods/rasterize) any particular page of the PDF document. Following code snippet is used to rasterize a page of the PDF document.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfRasterizePage**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Do not copy", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;
    watermark.Opacity = 0.5;

    // Add watermark of any type first
    PdfArtifactWatermarkOptions options = new PdfArtifactWatermarkOptions();
    options.PageIndex = 0;
    watermarker.Add(watermark, options);

    // Rasterize the first page
    PdfContent pdfContent = watermarker.GetContent<PdfContent>();
    pdfContent.Pages[0].Rasterize(100, 100, PdfImageConversionFormat.Png);

    // Content of the first page is replaced with raster image
    watermarker.Save("document.pdf");
}
```


---

## Rasterize document or page

Path: /watermark/python-net/rasterize-document-or-page/


## How to remove a watermark from a PDF
Watermarks in PDFs can be removed by third-party tools. If you need watermarks that are very hard to remove, rasterize the document: convert pages to images so content becomes non-editable.

## Rasterize PDF document
This sample converts all PDF pages to images (after adding a watermark) to lock down content and make subsequent removal extremely difficult.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    watermark = gww.TextWatermark("Do not copy", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0
    watermark.opacity = 0.5

    watermarker.add(watermark)
    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    pdf_content.rasterize(100, 100, gwc_pdf.PdfImageConversionFormat.PNG)
    watermarker.save("document.pdf")
```

{{< alert style="warning" >}}You can't restore document content after saving the document. Rasterization significantly increases the size of the resultant PDF file.{{< /alert >}}

## Rasterize particular page of the PDF document
This sample rasterizes only a specified page of the PDF (with an applied watermark), leaving the rest of the document editable.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc
import groupdocs.watermark.options.pdf as gwo_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    watermark = gww.TextWatermark("Do not copy", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0
    watermark.opacity = 0.5

    options = gwo_pdf.PdfArtifactWatermarkOptions()
    options.page_index = 0
    watermarker.add(watermark, options)

    pdf_content = watermarker.get_content(gwc_pdf.PdfContent)
    pdf_content.pages[0].rasterize(100, 100, gwc_pdf.PdfImageConversionFormat.PNG)
    watermarker.save("document.pdf")
```



---

## Remove annotation replies

Path: /annotation/java/remove-annotation-replies/

You can remove specific or all replies using the [GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) API. To do this, remove the appropriate items from the `List<T>` collection. 

To delete an annotation reply (replies), follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Call the [get()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#get--) method of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class to get collection of document annotations.
3.   Access the appropriate annotation and remove a reply in a suitable way:
    *   call the `annotations.get(index).getReplies().remove(index)` method. Specify approptiate parameters;
    *   call the [AnnotationBase.getReplies()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/annotationbase/#getReplies--) method and remove replies that match desired criteria.
4.   Call the [update](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#update-java.util.List-com.groupdocs.annotation.models.annotationmodels.AnnotationBase--) method of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the annotations collection.
5.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.
    

## Remove specific annotation reply 

The following code snippet shows how to remove annotation reply by its index:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to remove replies from annotated document by reply Id.

LoadOptions tmp0 = new LoadOptions();

// NOTE: Input document already contain annotations with replies
final Annotator annotator = new Annotator("inputPath", tmp0);
try {
    // Obtain annotations collection from document
    List<AnnotationBase> annotations = annotator.get();

    // Remove reply with Id = 4
    annotations.get(0).getReplies().remove(4);

    // Update and save changes
    annotator.update(annotations);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

## Remove annotation replies by criteria

The following code snippet shows how to remove replies that match some criteria:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to remove replies from annotated document by user name.

LoadOptions tmp0 = new LoadOptions();

// NOTE: Input document already contain annotations with replies
Annotator annotator = new Annotator("inputPath", tmp0);
try {
    // Obtain annotations collection from document
    List<AnnotationBase> annotations = annotator.get();

    // Remove all replies where author name is "Tom"           
    for(int i = 0; i < annotations.get(0).getReplies().size(); i++) {
        if(annotations.get(0).getReplies().get(i).getUser().getName().toString().equals("Tom")) {
            annotations.get(0).getReplies().remove(i);
        }
    }

    // Update and save changes
    annotator.update(annotations);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Remove document password

Path: /merger/java/remove-document-password/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to remove password from password-protected document.  
Here are the steps to remove document password:

*   Initialize [LoadOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/LoadOptions) class specifying current password;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream and pass [LoadOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/LoadOptions) object to it;
*   Call [removePassword](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#removePassword()) method;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to remove document password:

```java
String filePath = "c:\sample.docx";
String filePathOut = "c:\output\result.docx";

LoadOptions loadOptions = new LoadOptions("SAMPLE_PASSWORD");

Merger merger = new Merger(filePath, loadOptions);        
merger.removePassword();
merger.save(filePathOut);
```

---

## Remove metadata properties

Path: /metadata/java/remove-metadata-properties/

## Remove metadata properties using various criteria

The easiest way to remove metadata properties from a file is to use corresponding tags that allow you to locate the desired properties across all metadata packages. But sometimes it's necessary to remove metadata entries having a particular value. Using the GroupDocs.Metadata search engine you can find and remove properties satisfying a specification that can be as complex as you need.

The following example demonstrates how to remove specific metadata properties using a combination of criteria.

1.  [Load]({{< ref "metadata/java/developer-guide/basic-usage/remove-metadata-properties.md" >}}) a file to update
2.  Use a specification to find and remove any desired metadata properties
3.  Check the number of properties that were actually removed (please see the return value of the [removeProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#removeProperties(com.groupdocs.metadata.search.Specification)) method)
4.  [Save]({{< ref "metadata/java/developer-guide/basic-usage/remove-metadata-properties.md" >}}) the changes

**basic\_usage.RemoveMetadataProperties**

```csharp
public class RemoveMetadataProperties {
    public static void run() {
        // Constants.InputDocx is an absolute or relative path to your document. Ex: @"C:\Docs\source.docx"
        try (Metadata metadata = new Metadata(Constants.InputDocx)) {

            // Remove all the properties satisfying the predicate:
            // property contains the name of the document author OR
            // it refers to the last editor OR
            // the property value is a string that is equal to the given string "John" (to remove any mentions of John from the detected metadata)
            int affected = metadata.removeProperties(
                    new ContainsTagSpecification(Tags.getPerson().getCreator()).or(
                            new ContainsTagSpecification(Tags.getPerson().getEditor())).or(
                            new OfTypeSpecification(MetadataPropertyType.String).and(new RemoveMetadataProperties().new WithValueSpecification("John"))));

            System.out.println(String.format("Properties removed: %s", affected));

            metadata.save(Constants.OutputDocx);
        }
    }

    // Define your own specifications to filter metadata properties
    public class WithValueSpecification extends Specification {
        public WithValueSpecification(Object value) {
            setValue(value);
        }

        public final Object getValue() {
            return auto_Value;
        }

        private void setValue(Object value) {
            auto_Value = value;
        }

        private Object auto_Value;

        public boolean isSatisfiedBy(MetadataProperty candidate) {
            return candidate.getValue().getRawValue().equals(getValue());
        }
    }
}
```

As a result of execution of the code snippet above, we remove all mentions of the document author/editor and all other string metadata properties containing the name John.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/java/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/java/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/java/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/java/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Remove metadata properties

Path: /metadata/net/remove-metadata-properties/

## Remove metadata properties using various criteria

The easiest way to remove metadata properties from a file is to use corresponding tags that allow you to locate the desired properties across all metadata packages. But sometimes it's necessary to remove metadata entries having a particular value. Using the GroupDocs.Metadata search engine you can find and remove properties satisfying a predicate that can be as complex as you need. Just work with metadata trees using lambda expressions as you usually do with regular .NET collections through LINQ.

The following example demonstrates how to remove specific metadata properties using a combination of criteria.

1.  [Load]({{< ref "metadata/net/developer-guide/basic-usage/remove-metadata-properties.md" >}}) a file to update
2.  Use a predicate to find and remove any desired metadata properties
3.  Check the number of properties that were actually removed (please see the return value of the [RemoveProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/removeproperties) method)
4.  [Save]({{< ref "metadata/net/developer-guide/basic-usage/remove-metadata-properties.md" >}}) the changes

**BasicUsage.RemoveMetadataProperties**

```csharp
// Constants.InputDocx is an absolute or relative path to your document. Ex: @"C:\Docs\source.docx"
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	// Remove all the properties satisfying the predicate:
	// property contains the name of the document author OR
	// it refers to the last editor OR
	// the property value is a string that contains the substring "John" (to remove any mentions of John from the detected metadata)
	var affected = metadata.RemoveProperties(
		p => p.Tags.Contains(Tags.Person.Creator) ||
			 p.Tags.Contains(Tags.Person.Editor) ||
			 p.Value.Type == MetadataPropertyType.String && p.Value.ToString().Contains("John"));
	Console.WriteLine("Properties removed: {0}", affected);

	metadata.Save(Constants.OutputDocx);
}
```

As a result of execution of the code snippet above, we remove all mentions of the document author/editor and all other string metadata properties containing the name John.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/net/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/net/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/net/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/net/developer-guide/advanced-usage/adding-metadata.md" >}})


## More resources
### Advanced usage topics
To learn more about document watermarking features and get familiar how to manage watermarks and more, please refer to the [advanced usage section]({{< ref "metadata/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Remove metadata properties

Path: /metadata/nodejs-java/remove-metadata-properties/

## Remove metadata properties using various criteria

The easiest way to remove metadata properties from a file is to use corresponding tags that allow you to locate the desired properties across all metadata packages. But sometimes it's necessary to remove metadata entries having a particular value. Using the GroupDocs.Metadata search engine you can find and remove properties satisfying a specification that can be as complex as you need.

The following example demonstrates how to remove specific metadata properties using a combination of criteria.

1.  **Load** a file to update
2.  Use a specification to find and remove any desired metadata properties
3.  Check the number of properties that were actually removed (please see the return value of the **removeProperties** method)
4.  **Save** the changes

**basic\_usage.RemoveMetadataProperties**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata("input.docx");

    // Remove all the properties satisfying the predicate:
    // property contains the name of the document author OR
    // it refers to the last editor OR
    // the property value is a string that is equal to the given string "John" (to remove any mentions of John from the detected metadata)
    var affected = metadata.removeProperties(
        new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getPerson().getCreator()).or(
        new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getPerson().getEditor()))
        );

    console.log(`Properties removed: ${affected}`);

    metadata.save("output.docx");
```
{{< /tab >}}
{{< /tabs >}}

As a result of execution of the code snippet above, we remove all mentions of the document author/editor and all other string metadata properties containing the name John.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Remove metadata properties

Path: /metadata/python-net/remove-metadata-properties/

## Remove metadata properties using various criteria

The easiest way to remove metadata properties from a file is to use corresponding tags that allow you to locate the desired properties across all metadata packages. But sometimes it's necessary to remove metadata entries having a particular value. Using the GroupDocs.Metadata search engine you can find and remove properties satisfying a specification that can be as complex as you need.

The following example demonstrates how to remove specific metadata properties using a combination of criteria.

1.  **Load** a file to update
2.  Use a specification to find and remove any desired metadata properties
3.  Check the number of properties that were actually removed (please see the return value of the **removeProperties** method)
4.  **Save** the changes

**basic\_usage.RemoveMetadataProperties**


```python
const metadata = new groupdocs.metadata.Metadata("input.docx");

    # Remove all the properties satisfying the predicate:
    # property contains the name of the document author OR
    # it refers to the last editor OR
    # the property value is a string that is equal to the given string "John" (to remove any mentions of John from the detected metadata)
   with gm.Metadata(constants.input_docx) as metadata:
        specification = gm.search.ContainsTagSpecification(gm.tagging.Tags.person.creator).either(gm.search.ContainsTagSpecification(gm.tagging.Tags.person.editor)).either(gm.search.OfTypeSpecification(gm.common.MetadataPropertyType.STRING).both(gm.search.WithValueSpecification("John")))
        affected = metadata.remove_properties(specification)
        print(f"Properties removed: {affected}")
        metadata.save(constants.output_docx)
```


As a result of execution of the code snippet above, we remove all mentions of the document author/editor and all other string metadata properties containing the name John.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Removing found watermarks

Path: /watermark/net/removing-found-watermarks/

## Remove watermark

GroupDocs.Watermark API enables you to easily [find](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/search) and remove a particular [watermark](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search/possiblewatermark) from a document. Following code serves this purpose.

**AdvancedUsage.SearchAndRemoveWatermarks.RemoveWatermark**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search();

    // Remove possible watermark at the specified index from the document.
    possibleWatermarks.RemoveAt(0);

    // Remove specified possible watermark from the document.
    possibleWatermarks.Remove(possibleWatermarks[0]);

    watermarker.Save("document.pdf");
}
```

## Remove watermark with particular text formatting

GroupDocs.Watermark also enables you to search and remove the watermarks on the basis of some particular [text formatting](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textformattingsearchcriteria). You can provide a search criterion containing [font name](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textformattingsearchcriteria/properties/fontname), size, [color](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search.searchcriteria/textformattingsearchcriteria/properties/foregroundcolorrange) etc and the API will find the watermarks with matching properties. Following code snippet shows how to search and remove watermarks with a particular text formatting.

**AdvancedUsage.SearchAndRemoveWatermarks.RemoveWatermarkWithParticularTextFormatting**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    TextFormattingSearchCriteria criteria = new TextFormattingSearchCriteria();
    criteria.ForegroundColorRange = new ColorRange();
    criteria.ForegroundColorRange.MinHue = -5;
    criteria.ForegroundColorRange.MaxHue = 10;
    criteria.ForegroundColorRange.MinBrightness = 0.01f;
    criteria.ForegroundColorRange.MaxBrightness = 0.99f;
    criteria.BackgroundColorRange = new ColorRange();
    criteria.BackgroundColorRange.IsEmpty = true;
    criteria.FontName = "Arial";
    criteria.MinFontSize = 19;
    criteria.MaxFontSize = 42;
    criteria.FontBold = true;

    PossibleWatermarkCollection watermarks = watermarker.Search(criteria);
    watermarks.Clear();

    watermarker.Save("document.pdf");
}
```

## Remove hyperlink watermarks

GroupDocs.Watermark API allows you to search and remove [hyperlinks](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.search/hyperlinkpossiblewatermark) in a document of any supported format. Following code sample shows how to find and remove hyperlinks with a particular URL from a document.

**AdvancedUsage.SearchAndRemoveWatermarks.RemoveHyperlinksWithParticularUrl**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf"))
{
    PossibleWatermarkCollection watermarks = watermarker.Search(new TextSearchCriteria(new Regex(@"someurl\.com")));
    for (int i = watermarks.Count - 1; i >= 0; i--)
    {
        // Ensure that only hyperlinks will be removed.
        if (watermarks[i] is HyperlinkPossibleWatermark)
        {
            // Output the full url of the hyperlink
            Console.WriteLine(watermarks[i].Text);

            // Remove hyperlink from the document
            watermarks.RemoveAt(i);
        }
    }

    watermarker.Save("document.pdf");
}
```

---

## Removing found watermarks

Path: /watermark/python-net/removing-found-watermarks/


## Remove watermark

Search for possible watermarks and remove them from the document.

```python
import groupdocs.watermark as gw

with gw.Watermarker("document.pdf") as watermarker:
    possible = watermarker.search()

    # Remove watermark at the specified index
    possible.remove_at(0)

    # Remove a specific watermark instance
    if possible.count > 0:
        possible.remove(possible[0])

    watermarker.save("document.pdf")
```

## Remove watermark with particular text formatting

Search and clear watermarks that match font and color parameters.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("document.pdf") as watermarker:
    criteria = gws_sc.TextFormattingSearchCriteria()
    criteria.foreground_color_range = gws_sc.ColorRange()
    criteria.foreground_color_range.min_hue = -5
    criteria.foreground_color_range.max_hue = 10
    criteria.foreground_color_range.min_brightness = 0.01
    criteria.foreground_color_range.max_brightness = 0.99
    criteria.background_color_range = gws_sc.ColorRange()
    criteria.background_color_range.is_empty = True
    criteria.font_name = "Arial"
    criteria.min_font_size = 19
    criteria.max_font_size = 42
    criteria.font_bold = True

    possible = watermarker.search(criteria)
    possible.clear()

    watermarker.save("document.pdf")
```

## Remove hyperlink watermarks

Find and remove hyperlinks with a particular URL using a regex. Ensure only hyperlinks are cleared.

```python
import re
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc
import groupdocs.watermark.search as gws

with gw.Watermarker("document.pdf") as watermarker:
    possible = watermarker.search(gws_sc.TextSearchCriteria(re.compile(r"someurl\.com")))
    # iterate backwards when removing by index
    for i in range(possible.count - 1, -1, -1):
        if isinstance(possible[i], gws.HyperlinkPossibleWatermark):
            print(possible[i].text)
            possible.remove_at(i)

    watermarker.save("document.pdf")
```



---

## Removing metadata

Path: /metadata/java/removing-metadata/

Not all metadata properties extracted from a file are marked with tags. Some file formats and metadata standards allow adding fully custom properties that can't be properly tagged by the library since their purpose is not clearly defined in the appropriate format/standard specification. In such cases, you can use the name of the property to locate and remove it. The following example demonstrates some advanced usage scenarios of the GroupDocs.Metadata search engine allowing to remove metadata properties.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to be modified
2.  Pass a search predicate to the [removeProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#removeProperties(com.groupdocs.metadata.search.Specification)) method.
3.  Check the number of properties that were actually removed
4.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.RemovingMetadata**

```csharp
File folder = new File(Constants.InputPath);
for (File file : folder.listFiles()) {
    try (Metadata metadata = new Metadata(file.getAbsolutePath())) {
        if (metadata.getFileFormat() != FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
            System.out.println();
            System.out.println(file.getName());

            // Remove all mentions of any people contributed in file creation
            // Remove a custom property with the specified name
            int affected = metadata.removeProperties(new FallsIntoCategorySpecification(Tags.getPerson()).or(new WithNameSpecification("CustomProperty")));

            System.out.println(String.format("Affected properties: %s", affected));

            metadata.save(Constants.OutputPath + "output." + FilenameUtils.getExtension(file.getName()));
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Removing metadata

Path: /metadata/net/removing-metadata/

Not all metadata properties extracted from a file are marked with tags. Some file formats and metadata standards allow adding fully custom properties that can't be properly tagged by the library since their purpose is not clearly defined in the appropriate format/standard specification. In such cases, you can use the name of the property to locate and remove it. The following example demonstrates some advanced usage scenarios of the GroupDocs.Metadata search engine allowing to remove metadata properties.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to be modified
2.  Pass a search predicate to the [RemoveProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/removeproperties) method.
3.  Check the number of properties that were actually removed
4.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**AdvancedUsage.RemovingMetadata**

```csharp
foreach (string file in Directory.GetFiles(Constants.InputPath))
{
	using (Metadata metadata = new Metadata(file))
	{
		if (metadata.FileFormat != FileFormat.Unknown && !metadata.GetDocumentInfo().IsEncrypted)
		{
			Console.WriteLine();
			Console.WriteLine(file);

			// Remove all mentions of any people contributed in file creation
			// Remove all properties with the specified name
			var affected = metadata.RemoveProperties(p => p.Tags.Any(t => t.Category == Tags.Person) || p.Name == "CustomProperty");

			Console.WriteLine("Affected properties: {0}", affected);

			metadata.Save(Path.Combine(Constants.OutputPath, "output" + Path.GetExtension(file)));
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Removing metadata

Path: /metadata/nodejs-java/removing-metadata/

Not all metadata properties extracted from a file are marked with tags. Some file formats and metadata standards allow adding fully custom properties that can't be properly tagged by the library since their purpose is not clearly defined in the appropriate format/standard specification. In such cases, you can use the name of the property to locate and remove it. The following example demonstrates some advanced usage scenarios of the GroupDocs.Metadata search engine allowing to remove metadata properties.

1.  **Load** a file to be modified
2.  Pass a search predicate to the **removeProperties** method.
3.  Check the number of properties that were actually removed
4.  **Save** the changes

**advanced\_usage.RemovingMetadata**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
fs.readdirSync(Constants.inputPath).forEach(file => {
            var metadata = new groupdocs.metadata.Metadata(Constants.inputPath + file);
            if (metadata.getFileFormat() != groupdocs.metadata.FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
                
                console.log(file);

                // Add a property containing the file last printing date if it's missing
                // Note that the property will be added to metadata packages that satisfy the following criteria:
                // 1) Only existing metadata packages will be affected. No new packages are added during this operation
                // 2) There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package.
                // All properties supported by a certain package are usually defined in the specification of a particular metadata standard
                var affected = metadata.removeProperties(new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getTime().getPrinted()));

                console.log(`Affected properties: ${affected}`);
            }
      });
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Removing metadata

Path: /metadata/python-net/removing-metadata/

Not all metadata properties extracted from a file are marked with tags. Some file formats and metadata standards allow adding fully custom properties that can't be properly tagged by the library since their purpose is not clearly defined in the appropriate format/standard specification. In such cases, you can use the name of the property to locate and remove it. The following example demonstrates some advanced usage scenarios of the GroupDocs.Metadata search engine allowing to remove metadata properties.

1.  **Load** a file to be modified
2.  Pass a search predicate to the **removeProperties** method.
3.  Check the number of properties that were actually removed
4.  **Save** the changes

**advanced\_usage.RemovingMetadata**


```python
def run():
    files = os.listdir(constants.input_path)
    for file in files:
        with gm.Metadata(constants.input_path+file) as metadata:
            if metadata.file_format != gm.common.FileFormat.UNKNOWN and metadata.get_document_info().is_encrypted != True:
                print()
                print(file)

                specification = gm.search.FallsIntoCategorySpecification(gm.tagging.Tags.content)
                affected = metadata.remove_properties(specification)
                print(f"Affected properties: {affected}")
                metadata.save(constants.output_path + "output" + pathlib.Path(file).suffix)

```


## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Render attachments

Path: /viewer/java/how-to-convert-and-view-attachments/


Render attachments in the same way as any other documents.

To view attachments, follow these steps:

1. Instantiate the first [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object. Specify a file that contains attachments.
2. Call the [saveAttachment](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#saveAttachment-com.groupdocs.viewer.results.Attachment-java.io.OutputStream-) method to save the attachment (to local disk, memory stream, etc).
3. Instantiate the second [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object. Specify the previously saved attachment.
4. Specify the view options depending on the output format - [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/)/[PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/)/[JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/)/[PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/).
5. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

The following code snippet shows how to render attachments from the MSG file:

{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.LoadOptions;
import com.groupdocs.viewer.results.Attachment;
// ...

try (ByteArrayOutputStream outputStream = new ByteArrayOutputStream()) {
    Attachment firstAttachment;

    // Save attachment
    try (Viewer viewer = new Viewer("sample.msg")) {
        firstAttachment = viewer.getAttachments().get(0);
        viewer.saveAttachment(firstAttachment, outputStream);
    }
    
    LoadOptions loadOptions = new LoadOptions(firstAttachment.getFileType());

    // Render attachment
    try (ByteArrayInputStream inputStream = new ByteArrayInputStream(outputStream.toByteArray());
         Viewer viewer = new Viewer(inputStream, loadOptions)) {
        HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources();
        viewer.view(options);
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Render attachments

Path: /viewer/net/how-to-convert-and-view-attachments/


Render attachments in the same way as any other documents.

To view attachments, follow these steps:

1. Instantiate the first [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify a file that contains attachments.
2. Call the [SaveAttachment](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/saveattachment) method to save the attachment (to local disk, memory stream, etc).
3. Instantiate the second [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify the previously saved attachment.
4. Specify the view options depending on the output format - [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions)/[PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)/[JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)/[PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions).
5. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method.

The following code snippet shows how to render attachments from the MSG file:

{{< alert style="info" >}}NOTE: provided code snippet suits all format families that support attachments: emails, Outlook data files, archives, and PDF documents.{{< /alert >}}

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

// Specify attachment.
Attachment attachment = new Attachment("attachment-word.doc", @"C:\Output\attachment-word.doc");

// Create a stream for attachment.
MemoryStream attachmentStream = new MemoryStream();

//Save attachment
using (Viewer viewer = new Viewer("sample.msg"))
{
    viewer.SaveAttachment(attachment, attachmentStream);
}

// Render attachment
using (Viewer viewer = new Viewer(attachmentStream))
{
    HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(options);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        ' Specify attachment.
        Dim attachment As Attachment = New Attachment("attachment-word.doc", "C:\Output\attachment-word.doc")
    
        ' Create a stream for attachment.
        Dim attachmentStream As MemoryStream = New MemoryStream()
    
        'Save attachment
        Using viewer As Viewer = New Viewer("sample.msg")
            viewer.SaveAttachment(attachment, attachmentStream)
        End Using
    
        ' Render attachment
        Using viewer As Viewer = New Viewer(attachmentStream)
            Dim options As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(options)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Adding repeated watermarks

Path: /watermark/net/adding-repeated-watermarks/


## Rrepeated watermark

Enhance the visual appeal and branding of your documents with the power of repeated or tiled watermarks. This innovative feature allows you to seamlessly integrate patterns of text or images across your pages, creating a professional and cohesive look. Whether you're aiming for subtle branding, artistic expression, or document security, the ability to configure the spacing, rotation, and style of these watermarks provides unparalleled customization. Explore the possibilities and make your documents stand out with the elegance of tiled watermarks.

### Text repeated watermark

The provided code snippet demonstrates how to add a tiled watermark to a document. To configure tiling settings, we can utilize the dedicated class [TileOptions](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/tileoptions). In this example, we set the LineSpacing property, determining the spacing between parallel tiles, to 12 percent of the page size. Additionally, we define the WatermarkSpacing property, which sets the spacing between watermarks in the line, to be 10 percent of the page size. Next image helps to understand the purpose of LineSpacing and WatermarkSpacing settings:
![adding-repeated-watermarks](/watermark/net/images/tilling-options.png)

Furthermore, we apply a watermark rotation of 30 degrees for added customization.

```csharp
    using (Watermarker watermarker = new Watermarker("sample.pdf"))
    {
        // Initialize the font to be used for watermark
        Font font = new Font("Arial", 19, FontStyle.Bold | FontStyle.Italic);

        // Create the watermark object
        var watermark = new TextWatermark("Watermark", font);
        watermark.ForegroundColor = Color.Red;

        // Configure tile options
        watermark.TileOptions = new TileOptions()
        {
            LineSpacing = new MeasureValue()
            {
                MeasureType = TileMeasureType.Percent,
                Value = 12
            },
            WatermarkSpacing = new MeasureValue()
            {
                MeasureType = TileMeasureType.Percent,
                Value = 10
            },
        };

        // Set watermark properties
        watermark.Opacity = 0.2;
        watermark.RotateAngle = -30;

        // Add watermark
        watermarker.Add(watermark);
        watermarker.Save("result.pdf");
    }        
```

The output of the above mentioned code is represented below, showcasing repeated text watermarks:
![text repeated watermarks](/watermark/net/images/tilling-text-30.png)

The common rotation of watermarks on the above image is done relative to the left edge of the document. It's also possible to do the common rotation relative to the bottom left edge of the document. For this need to set property [RotateAroundOrigin](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/tileoptions/rotatearoundorigin/) of the class TileOptions in the true.
```csharp
watermark.TileOptions.RotateAroundOrigin = true;
```
In such case the result of repeated watermark looks like this:
![repeated watermarks rotaion around the center](/watermark/net/images/tilling-text-center.png)

Class TileOptions includes a [TileType](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/tiletype) property, providing the ability to configure the tile template. The default value is Straight mode, but we can change it. For instance, in the previous example, if we add the setting 
```csharp
   watermark.TileOptions.TileType = TileType.Offset
```
it enables the offset style. In the context of watermarks and tiling, the "offset style" refers to a specific arrangement where each tile is positioned with a shift or offset from the previous one. Instead of aligning tiles in a straightforward, parallel manner, the offset style introduces a displacement, creating a more dynamic and visually interesting pattern. This shift can occur horizontally, vertically, or both, depending on the specific settings applied.
In this case, the output will exhibit the following effect:
![adding-repeated-watermarks](/watermark/net/images/tilling-text-30-offset.png)

The TileType enum supports a range of tile templates, including OneThirdOffset and BasketWeave, to accommodate diverse design needs. Setting
```csharp
   watermark.TileOptions.TileType = TileType.BasketWeave
```
It produces the following visual result for the BasketWeave tile watermark pattern in the document:
![adding-repeated-watermarks](/watermark/net/images/basket-weave.png)

### Image repeated watermark

The repeated watermark feature also supports image watermarks. The following C# code demonstrates how to add repeated image watermarks to a PDF document with rotation.

```csharp
    using (Watermarker watermarker = new Watermarker("sample.pdf"))
    {
        // Initialize the font to be used for watermark
        Font font = new Font("Arial", 19, FontStyle.Bold | FontStyle.Italic);

        // Create the image watermark object
        var watermark = new ImageWatermark(imagePath);

        // Configure tile options
        watermark.TileOptions = new TileOptions()
        {
            LineSpacing = new MeasureValue()
            {
                MeasureType = TileMeasureType.Percent,
                Value = 12
            },
            WatermarkSpacing = new MeasureValue()
            {
                MeasureType = TileMeasureType.Percent,
                Value = 10
            },
        };

        // Set watermark properties
        watermark.Opacity = 0.3;
        watermark.RotateAngle = -30;

        // Add watermark
        watermarker.Add(watermark);
        watermarker.Save("result.pdf");
    }        
```

This is the resulting appearance of the document after applying tiled image watermarks:
![adding-repeated-watermarks](/watermark/net/images/tilling-image-30.png)
---

## Adding repeated watermarks

Path: /watermark/python-net/adding-repeated-watermarks/


## Repeated watermark

Repeated (tiled) watermarks let you cover entire pages with a pattern of text or images. You can control spacing, rotation, offsets, and choose different tiling templates.

### Text repeated watermark

Apply a text watermark across the whole page in a repeated pattern.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("sample.pdf") as watermarker:
    font = gww.Font("Arial", 19.0, gww.FontStyle.BOLD | gww.FontStyle.ITALIC)
    watermark = gww.TextWatermark("Watermark", font)
    watermark.foreground_color = gww.Color.red

    watermark.tile_options = gww.TileOptions()
    watermark.tile_options.line_spacing = gww.MeasureValue(gww.TileMeasureType.PERCENT, 12)
    watermark.tile_options.watermark_spacing = gww.MeasureValue(gww.TileMeasureType.PERCENT, 10)

    watermark.opacity = 0.2
    watermark.rotate_angle = -30

    watermarker.add(watermark)
    watermarker.save("result.pdf")
```

Rotate around the page origin instead of the center:

```python
watermark.tile_options.rotate_around_origin = True
```

Use offset/basket-weave and other templates:

```python
watermark.tile_options.tile_type = gww.TileType.OFFSET
# or
watermark.tile_options.tile_type = gww.TileType.BASKET_WEAVE
```

### Image repeated watermark

Apply a repeated image (such as a logo or seal) to cover the page.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("sample.pdf") as watermarker:
    watermark = gww.ImageWatermark("watermark.jpg")

    watermark.tile_options = gww.TileOptions()
    watermark.tile_options.line_spacing = gww.MeasureValue(gww.TileMeasureType.PERCENT, 12)
    watermark.tile_options.watermark_spacing = gww.MeasureValue(gww.TileMeasureType.PERCENT, 10)

    watermark.opacity = 0.3
    watermark.rotate_angle = -30

    watermarker.add(watermark)
    watermarker.save("result.pdf")
```
🔹 Use case: Protect sensitive PDFs by overlaying “Confidential” text across every page, or reinforce branding by repeating a logo in the background.


---

## Result of added watermarks

Path: /watermark/python-net/result-of-added-watermarks/


GroupDocs.Watermark can return details about each added watermark, including a unique identifier (GUID), type, page number, and position. This enables scenarios such as tracing, searching, and removing specific watermarks by ID.

## Reviewing the result of added watermarks

The following example shows how to review `AddWatermarkResult` with information about added watermarks in a document.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww

with gw.Watermarker("sample_2_pages.pdf") as watermarker:
    font = gww.Font("Arial", 19.0, gww.FontStyle.BOLD | gww.FontStyle.ITALIC)
    watermark = gww.TextWatermark("Test watermark", font)

    watermark.foreground_color = gww.Color.red
    watermark.background_color = gww.Color.blue
    watermark.text_alignment = gww.TextAlignment.RIGHT
    watermark.opacity = 0.5

    result = watermarker.add(watermark)

    for item in result.succeeded:
        print("WatermarkId:", item.watermark_id)
        print("WatermarkType:", item.watermark_type)
        print("PageNumber:", item.page_number)
        print("WatermarkPosition:", item.watermark_position)

    watermarker.save("output.pdf")
```

Example output:

```text
WatermarkId: 1a78ef44-d497-451f-8f03-ca08ea537cc8
WatermarkType: Text
PageNumber: 1
WatermarkPosition: Default

WatermarkId: 658179cf-7b6e-472a-8b24-30f845dc2a9a
WatermarkType: Text
PageNumber: 2
WatermarkPosition: Default
```



---

## Running Examples

Path: /conversion/python-net/getting-started/running-examples/


This page provides instructions on how to set up and run code examples for GroupDocs.Conversion for Python via .NET. The examples are designed to demonstrate basic usage, including conversion between various file formats, working with files in archives, and retrieving document information.

## Prerequisites

Before running the examples, make sure you have:

1. **Configured** environment as described in the [System Requirements]({{< ref "conversion/python-net/system-requirements" >}}) topic.
2. **Downloaded** or cloned [the GitHub repository](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Python-via-.NET) containing the examples.

## Project Structure

The example repository is structured similarly to this documentation, making it easy to find the code examples and related input documents.

```md
📂 Examples
├── getting-started
    ├── quick-start-guide
        ├── **convert_docx_to_pdf.py**
        ├── **convert_files_in_archive.py**
        ├── **convert_pdf_pages_to_png.py**
        ├── annual-review.pdf
        ├── business-plan.docx
        ├── compressed.zip
├── developer-guide
    ├── loading-documents
        ├── get-default-load-options
            ├── **get_default_load_options.py**
        ├── load-file-from-local-disk
            ├── **convert_docx_to_pdf.py**
            ├── business-plan.docx
        ├── load-file-from-stream
            ├── **detect_file_type_automatically.py**
            ├── **load_file_from_stream.py**
            ├── annual-review.docx
        ├── load-password-protected-file
            ├── **load_password_protected_file.py**
            ├── password-protected.docx
    ├── get-document-info
        ├── **get_cad_document_info.py**
        ├── **get_document_info.py**
        ├── **get_email_document_info.py**
        ├── **get_image_document_info.py**
        ├── **get_pdf_document_info.py**
        ├── **get_pm_document_info.py**
        ├── **get_pres_document_info.py**
        ├── **get_sp_document_info.py**
        ├── **get_wp_document_info.py**
        ├── blocks-and-tables.dwg
        ├── business-plan.doc
        ├── cost-analysis.xlsx
        ├── infographic-elements.tiff
        ├── invitation.eml
        ├── lorem-ipsum.txt
        ├── presentation-template.pptx
        ├── sample-with-toc.pdf
        ├── weekly-plan.mpp
    ├── converting-documents
        ├── add-watermark-to-converted-document
            ├── **add_watermark_to_converted_document.py**
            ├── professional-services.docx
        ├── convert-document-to-another-format
            ├── **convert_consecutive_document_pages.py**
            ├── **convert_document_to_another_format.py**
            ├── **convert_specific_document_pages.py**
            ├── business-plan.docx
        ├── convert-document-to-multiple-page-files
            ├── **convert_all_document_pages.py**
            ├── **convert_specific_document_page_to_file.py**
            ├── **convert_specific_document_page_to_stream.py**
            ├── basic-presentation.pptx
            ├── converted-pages
        ├── convert-files-within-document-containers
            ├── **convert_files_within_document_container.py**
            ├── compressed.zip
            ├── converted-files
        ├── get-possible-conversions
            ├── **get_all_possible_conversions.py**
            ├── **get_all_possible_conversions_by_file_extension.py**
            ├── **get_all_possible_conversions_for_current_file.py**
            ├── cost-analysis.xlsx
    ├── logging-and-diagnostics
        ├── **write_logs_to_console.py**
        ├── **write_logs_to_file.py**
        ├── business-plan.docx
├── licensing
    ├── **set_license_from_file.py**
    ├── **set_license_from_stream.py**
    ├── **set_metered_license.py**
├── **run_all_examples.py**
├── requirements.txt
```

## Setup Instructions

1. **Create and Activate Virtual Environment**:  Navigate to the project root directory with `cd ./Examples`. Then create and activate virtual environment:
   
   Create a virtual environment:
   
   {{< tabs "example1">}}
   {{< tab "Windows" >}}
   ```ps
   py -m venv .venv
   ```
   {{< /tab >}}
   {{< tab "macOS" >}}
   ```bash
   python3 -m venv .venv
   ```
   {{< /tab >}}
   {{< /tabs >}}
   
   Activate a virtual environment:
   
   {{< tabs "example2">}}
   {{< tab "Windows" >}}
   ```ps
   .venv\Scripts\activate
   ```
   {{< /tab >}}
   {{< tab "macOS" >}}
   ```bash
   source .venv/bin/activate
   ```
   {{< /tab >}}
   {{< /tabs >}}

### Install the Dependencies

After activating the virtual environment, run the following command in your terminal to install the dependencies:

{{< tabs "example3">}}
{{< tab "Windows" >}}
```ps
py -m pip install -r requirements.txt
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m pip install -r requirements.txt
```
{{< /tab >}}
{{< /tabs >}}

3. **Configure License (Optional)**: If you have a license file, you can set the license path in the `run_all_examples.py` file. By default, GroupDocs.Conversion for Python via .NET looks for the `GROUPDOCS_LIC_PATH` environment variable or for files with the `.lic` extension in the project’s root directory.

   {{< alert style="info" >}}
   Learn more about licensing, evaluation, and how to obtain a temporary license in the [Licensing]({{< ref "conversion/python-net/licensing" >}}) documentation topic.
   {{< /alert >}}

## Running Examples

To run the examples:

1. **Run All Examples**: Execute `run_all_examples.py` to run all examples in the repository.

   {{< tabs "example4">}}
   {{< tab "Windows" >}}
   ```ps
   py run_all_examples.py
   ```
   {{< /tab >}}
   {{< tab "macOS" >}}
   ```bash
   python3 run_all_examples.py
   ```
   {{< /tab >}}
   {{< /tabs >}}

   This script will sequentially run all examples listed in `run_all_examples.py` file, showcasing conversions to different formats, handling files in archives, retrieving document info, and listing possible conversions.

2. **Run a Specific Example**: Navigate to the directory where example script is located and run it.

3. **Output Files**: Most of the examples generates an output file or files, saved in the same folder where the example script is located. Also, you can find all the output files on the corresponding documentation page.

## Troubleshooting

If you encounter any issues while running the examples:

- Ensure that package is installed correctly.
- Visit our [Technical Support]({{< ref "conversion/python-net/technical-support" >}}) page for further assistance.
---

## Save a modified file to a stream

Path: /metadata/java/save-a-modified-file-to-a-stream/

This example shows how to save a file to the specified stream.

**AdvancedUsage.SavingFiles.SaveFileToSpecifiedStream**

```csharp
try (OutputStream stream = new FileOutputStream(Constants.OutputPng)) {
	// Constants.InputPng is an absolute or relative path to your document. Ex: @"C:\Docs\test.png"
	try (Metadata metadata = new Metadata(Constants.InputPng)) {

		// Edit or remove metadata here

		metadata.save(stream);
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Save a modified file to a stream

Path: /metadata/net/save-a-modified-file-to-a-stream/

This example shows how to save a file to the specified stream.

**AdvancedUsage.SavingFiles.SaveFileToSpecifiedStream**

```csharp
using (MemoryStream stream = new MemoryStream())
{
	// Constants.InputPng is an absolute or relative path to your document. Ex: @"C:\Docs\test.png"
	using (Metadata metadata = new Metadata(Constants.InputPng))
	{
		// Edit or remove metadata here
        // ...

		metadata.Save(stream);
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Save a modified file to a stream

Path: /metadata/nodejs-java/save-a-modified-file-to-a-stream/

This example shows how to save a file to the specified stream.

**AdvancedUsage.SavingFiles.SaveFileToSpecifiedStream**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const fileStream = fs.createReadStream("output.pdf")
const metadata = new groupdocs.metadata.Metadata("input.pdf");

    // Edit or remove metadata here

metadata.save(fileStream);
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Save a modified file to a stream

Path: /metadata/python-net/save-a-modified-file-to-a-stream/

This example shows how to save a file to the specified stream.

**advanced_usage.saving_files.save_file_to_specified_stream**


```python
def run():
    stream = io.BytesIO()
    # constants.input_png is an absolute or relative path to your document. Ex: r"C:\\Docs\\test.png"
    with gm.Metadata(constants.input_png) as metadata:
        # Edit or remove metadata here
        # ...

        metadata.save(stream)
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Save comparison result in different format

Path: /comparison/net/save-comparison-result-in-different-format/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to save output document in different formats.

To save output document in different format, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare/index) method. Specify the result document path with the required format.

The following code snippet shows how to save comparison result in different format:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
// ...

using (Comparer comparer = new Comparer("source.txt"))
{
    // Add target document
    comparer.Add("target.txt");

    // Compare and save comparison result
    comparer.Compare("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Save document

Path: /merger/net/save-document/

**GroupDocs.Merger** allows to save PDF resultant document by specifying accesibility settings [PdfAccesibilitySettings](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pdfaccesibilitysettings).

There is an ability to set parameter [EnableAutoTagging](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pdfaccesibilitysettings/enableautotagging) in order to enable auto tagging mode.

The steps to save document with auto tagging mode are the following:

*   Initialize [PdfSaveOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pdfsaveoptions) class and set parameter [EnableAutoTagging](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pdfaccesibilitysettings/enableautotagging) as True;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and pass [PdfSaveOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pdfsaveoptions) object to save a resultant document.

## Save the PDF document with auto tagging mode

The following code sample demonstrates how to save PDF document with auto tagging mode:

```csharp
string filePath = @"c:\sample.pdf";
string filePathOut = @"c:\result.pdf";

PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
pdfSaveOptions.AccesibilitySettings.EnableAutoTagging = true;
           
using (Merger merger = new Merger(filePath))
{
     merger.Save(filePathOut, pdfSaveOptions);
}  
```

## Save any document by default

The following code sample demonstrates how to save any document by default:

```csharp
string filePath = @"c:\sample.docx";
string filePathOut = @"c:\result.docx";

using (Merger merger = new Merger(filePath))
{
     merger.Save(filePathOut);
}  
```
---

## Save overwriting original file

Path: /redaction/java/save-overwriting-original-file/

The following example demonstrates how to save the redacted document, replacing an original file:



```java
// Make a copy of sample file
Files.copy(new File("Sample.docx").toPath(), new File("OverwrittenSample.docx").toPath(), StandardCopyOption.REPLACE_EXISTING);
// Apply redaction
final Redactor redactor = new Redactor("OverwrittenSample.docx");
try 
{
    RedactorChangeLog result = redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(java.awt.Color.RED)));
    if (result.getStatus() != RedactionStatus.Failed)
    {
        SaveOptions options = new  SaveOptions();
        options.setAddSuffix(false);
        options.setRasterizeToPDF(false);
        // Save the document in original format overwriting original file
        redactor.save(options);
    }
}
finally { redactor.close(); }

```

---

## Save overwriting original file

Path: /redaction/net/save-overwriting-original-file/

The following example demonstrates how to save the redacted document, replacing an original file:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Here we can use document instance to perform redactions
    RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(System.Drawing.Color.Red)));
    if (result.Status != RedactionStatus.Failed)
    {
        // Save the document in original format overwriting original file
        redactor.Save(new SaveOptions() { AddSuffix = false, RasterizeToPDF = false });
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save overwriting original file

Path: /redaction/python-net/save-overwriting-original-file/

The following example demonstrates how to save the redacted document, replacing an original file:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():
    
    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions(color)
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        if (result.status != gr.RedactionStatus.FAILED):
            # Save the redacted document
            so = gro.SaveOptions()
            so.add_suffix = False
            so.rasterize_to_pdf = False
            result_path = redactor.save(so)
            print(f"Document redacted successfully.\nCheck output in {result_path}")
        else:
            print(f"Redaction failed!")
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save specific page range

Path: /annotation/java/save-specific-page-range/


To export the specific page range, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class. Call the [setFirstPage](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/#setFirstPage-int-) and  [setLastPage](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/#setLastPage-int-) methods to specify the first and the last pages.
3.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method with the output document path or stream. Specify the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class as a parameter.

The following code demonstrates how to save the range of document page:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates saving result document with specified pages.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    SaveOptions tmp0 = new SaveOptions();
    tmp0.setFirstPage(2);
    tmp0.setLastPage(4);
    
    // Save to file
    annotator.save(outputPath, tmp0);
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Save specific page range

Path: /annotation/net/save-specific-page-range/


To export the specific page range, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class. Specify the [FirstPage](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/saveoptions/firstpage/) and  [LastPage](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/saveoptions/lastpage/) parameters.
3.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method with the output document path or stream. Specify the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class as a parameter.

The following code demonstrates how to save the range of document page:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
// for this example input document ("input.pdf") must have at least 4 pages
using (Annotator annotator = new Annotator("input.pdf"))
{
	//Result file will be contain only 3 pages (2, 3 and 4 page)
	annotator.Save("result.pdf", new SaveOptions { FirstPage = 2, LastPage = 4 });
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Scatter Chart in Presentation Document

Path: /assembly/java/scatter-chart-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Scatter Chart in Microsoft PowerPoint Document

### Creating a Scatter Chart

Please following below steps to create Scatter Chart in MS PowerPoint 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "XY (Scatter)".
3.  Preview "Scatter" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/scatter-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to show contract prices by month with the following key requirements:

*   Report must show information on a Scatter Chart.
*   It must indicate total contract prices by month.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>>
```

#### Chart Data (Excel)

| X-Values | Total Contract Price<<x [key + 1]>><<y [sum(c => c.getPrice())]>> |
| -------- | ------------------------------------------------------------ |
| 0.7      | 2.7                                                          |
| 1.8      | 3.2                                                          |
| 2.6      | 0.8                                                          |

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Scatter%20Chart.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists 12dbe91a8a8ad4f7e05521faa308c512 >}}

## Scatter Chart in OpenOffice Presentation Document

To be investigated.

---

## Scatter Chart in Presentation Document

Path: /assembly/net/scatter-chart-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Scatter Chart in Microsoft PowerPoint Document

### Creating a Scatter Chart

Please following below steps to create Scatter Chart in MS PowerPoint 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "XY (Scatter)".
3.  Preview "Scatter" and press OK to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/scatter-chart-in-presentation-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to show your customers' orders prices by month with the following key requirements:

*   Report must show information on a Scatter Chart.
*   It must indicate Price of each order by month.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>>
```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">X-Values</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total Order Price&lt;&lt;x [Key]&gt;&gt;&lt;&lt;y [Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">0.7</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.7</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.6</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">0.8</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Scatter%20Chart.pptx?raw=true) (Template for CustomObject and JSON examples) 
*   [Scatter Chart\_DB.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Scatter%20Chart_DB.pptx.docx?raw=true) (Template for DataSet, DataBase and XML examples)

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 3598ebdc3269aca6f2327a73bada7898 >}}



#### Database Entities

{{< gist GroupDocsGists f43af1740a91b064e0d3ceb1bcc73592 >}}



#### Using DataSet

{{< gist GroupDocsGists 540aac27ebff9a1951df05abe2be5b28 >}}



#### Using XML DataSource

{{< gist GroupDocsGists 6d9ea6c0d1c71305d1aee4f3832d89b8 >}}



#### Using JSON DataSource

{{< gist GroupDocsGists 0677d6be967163584f843189e5670b90 >}}



## Scatter Chart in OpenOffice Presentation Document

To be investigated.

---

## Search for encrypted object in QR code signatures

Path: /signature/net/search-for-encrypted-object-in-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to search for embedded data objects in QR-code signatures ([QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature)) with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype)), string value key and string value salt.

Here are the steps to search for embedded objects in QR-code with standard encryption with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class with same parameters as secured QR-code was signed with.
* Create objects of [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) class and setup property [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions/dataencryption) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption).
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) to it.

## Definition of class that was embedded into into QR-Code signature

```csharp
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Searching for embedded object in QR-code signature

This example shows how to search for embedded object in QR-code signatures.

```csharp
using (Signature signature = new Signature("QRCodeEncryptedObject.pdf"))
{
    // setup key and pasphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    QrCodeSearchOptions options = new QrCodeSearchOptions()
    {
        // specify special pages to search on
        AllPages = true,
        PageNumber = 1,
        PagesSetup = new PagesSetup() { FirstPage = true, LastPage = true, OddPages = false, EvenPages = false },
        // specify special QRCode type to search
        EncodeType = QrCodeTypes.QR,
        //
        DataEncryption = encryption
    };
    // search for signatures in document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var qrCodeSignature in signatures)
    {
        Console.WriteLine("QRCode signature found at page {0} with type {1}.", qrCodeSignature.PageNumber,qrCodeSignature.EncodeType);
        DocumentSignatureData documentSignatureData = qrCodeSignature.GetData<DocumentSignatureData>();
        if(documentSignatureData != null)
        {
            Console.WriteLine("QRCode signature has DocumentSignatureData object:\n ID = {0}, Author = {1}, Signed = {2}, DataFactor {3}",
                documentSignatureData.ID, documentSignatureData.Author, documentSignatureData.Signed.ToShortDateString(), documentSignatureData.DataFactor);
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for encrypted object in QR-code signatures

Path: /signature/java/search-for-encrypted-object-in-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to search for embedded data objects in QR-code signatures ([QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature)) with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType)with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType)), string value key and string value salt.

Here are the steps to search for embedded objects in QR-code with standard encryption with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class with same parameters as secured QR-code was signed with.
*   Create objects of [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) class and setup property [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) with object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption)   
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) to it.
    

## Definition of class that was embedded into into QR-Code signature

```java
public static class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Searching for embedded object in QR-code signature

This example shows how to search for embedded object in QR-code signatures.

```java
Signature signature = new Signature("QRCodeEncryptedObject.pdf");
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
QrCodeSearchOptions options = new QrCodeSearchOptions();
// specify special pages to search on
options.setAllPages(true);
options.setPageNumber(1);
PagesSetup pagesSetup = new PagesSetup();
pagesSetup.setFirstPage(false);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(true);
options.setPagesSetup(pagesSetup);
// specify types of QR code to verify
options.setEncodeType(QrCodeTypes.QR);
options.setDataEncryption(encryption);
 
 
// search for signatures in document
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class,options);
System.out.print("\nSource document contains following signatures:");
for (QrCodeSignature qrCodeSignature : signatures)
{
    System.out.print("QRCode signature found at page "+qrCodeSignature.getPageNumber()+" with type "+ qrCodeSignature.getEncodeType());
    DocumentSignatureData documentSignatureData = qrCodeSignature.getData(DocumentSignatureData.class);
    if (documentSignatureData != null)
    {
        System.out.print("QRCode signature has DocumentSignatureData object:\n ID = " + documentSignatureData.getID() + ", Author = " + documentSignatureData.getAuthor() + ", Signed = " + documentSignatureData.getSigned() + ", DataFactor "+documentSignatureData.getDataFactor());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for encrypted objects Metadata signatures

Path: /signature/java/search-for-encrypted-objects-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to search for embedded objects in Metadata signatures with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType) with one of following values (DES, TripleDES, RC2, Rijndael), string value key and string value salt.

Here are the steps to search for embedded Metadata signature with standard encryption with GroupDocs.Signature:

*   *   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.
    *   Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class with same parameters as secured QR-code was signed with.
    *   Create objects of [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) class and setup property  [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption)
    *   Call [Search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#search(int...)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) to it.
    *   Call method [getData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#getData(java.lang.Class)) of encrypted [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) object to retrieve object of type Type

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```java
public static class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Search for embedded object in Metadata signatures

This example shows how to search for embedded objects in Metadata signatures.

```java
Signature signature = new Signature("MetadataEncryptedObject.docx");
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
MetadataSearchOptions options = new MetadataSearchOptions();
options.setDataEncryption(encryption);
 
// search for signatures in document
List<WordProcessingMetadataSignature> signatures = signature.search(WordProcessingMetadataSignature.class,options);
System.out.print("\nSource document contains following signatures.");
 
// get required metadata signatures
WordProcessingMetadataSignature wordSignature = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("Signature")) {
        wordSignature = mdSign;
        break;
    }
}
if (wordSignature != null)
{
    DocumentSignatureData documentSignatureData = wordSignature.getData(DocumentSignatureData.class);
    if (documentSignatureData != null)
    {
        System.out.print("Signature has DocumentSignatureData object:\n ID = " + documentSignatureData.getID() + ", Author = " + documentSignatureData.getAuthor() + ", Signed = " + documentSignatureData.getSigned() + ", DataFactor " + documentSignatureData.getDataFactor());
    }
}
// get required metadata signatures
WordProcessingMetadataSignature mdAuthor = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("Author")) {
        mdAuthor = mdSign;
        break;
    }
}
if (mdAuthor != null)
{
    System.out.print("Metadata signature found. Name : " + mdAuthor.getName() + ". Value: " + mdAuthor.getData(String.class));
}
// get required metadata signatures
WordProcessingMetadataSignature mdDocId = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("DocumentId")) {
        mdDocId = mdSign;
        break;
    }
}
if (mdDocId != null)
{
    System.out.print("Metadata signature found. Name : " + mdDocId.getName() + ". Value: " + mdDocId.getData(String.class));
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for encrypted objects Metadata signatures

Path: /signature/net/search-for-encrypted-objects-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to search for embedded objects in Metadata signatures with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values (DES, TripleDES, RC2, Rijndael), string value key and string value salt.

Here are the steps to search for embedded Metadata signature with standard encryption with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class with same parameters as secured QR-code was signed with.  
* Create objects of [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) class and setup property  [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions/dataencryption) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption)  
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions)  to it.
* Call method [GetData<Type>()](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/getdata) of encrypted [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) object to retrieve object of type Type.

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Search for embedded object in Metadata signatures

This example shows how to search for embedded objects in Metadata signatures.

```csharp
using (Signature signature = new Signature("MetadataEncryptedObject.docx"))
{
    // setup key and passphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    MetadataSearchOptions options = new MetadataSearchOptions()
    {
        DataEncryption = encryption
    };
    // search for signatures in document
    List<WordProcessingMetadataSignature> signatures = signature.Search<WordProcessingMetadataSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    // get required metadata signatures
    WordProcessingMetadataSignature mdSignature = signatures.FirstOrDefault(p => p.Name == "Signature");
    if (mdSignature != null)
    {
        DocumentSignatureData documentSignatureData = mdSignature.GetData<DocumentSignatureData>();
        if (documentSignatureData != null)
        {
            Console.WriteLine("Signature has DocumentSignatureData object:\n ID = {0}, Author = {1}, Signed = {2}, DataFactor {3}",
                documentSignatureData.ID, documentSignatureData.Author, documentSignatureData.Signed.ToShortDateString(), documentSignatureData.DataFactor);
        }
    }
    // get required metadata signatures
    WordProcessingMetadataSignature mdAuthor = signatures.FirstOrDefault(p => p.Name == "Author");
    if (mdAuthor != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdAuthor.Name, mdAuthor.GetData<string>());
    }
    // get required metadata signatures
    WordProcessingMetadataSignature mdDocId = signatures.FirstOrDefault(p => p.Name == "DocumentId");
    if (mdDocId != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdDocId.Name, mdDocId.GetData<string>());
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search index settings

Path: /search/java/search-index-settings/

This page contains a description of all index settings that can be specified in an instance of the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class.

## setAutoDetectEncoding method

The [setAutoDetectEncoding](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setAutoDetectEncoding(boolean)) method sets a flag that allows you to automatically detect the following encodings of text files during indexing: UTF-32 LE, UTF-32 BE, UTF-16 LE, UTF-16 BE, UTF-8, UTF-7, ANSI. By default, the encoding auto detection of text files is disabled. But in any case, the encoding of a text file can be set during indexing when the [FileIndexing](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#FileIndexing) event is raised. Detailed information on detecting and setting the encoding of text files is presented on the page [Text file encoding detection]({{< ref "search/java/developer-guide/advanced-usage/indexing/text-file-encoding-detection.md" >}}).

## getCustomExtractors method

The [getCustomExtractors](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#getCustomExtractors()) method returns a collection of custom text extractors that allows adding new extractors for supported or not supported formats. A complete example of implementing a custom text extractor and using it to extract text is presented on the page [Custom text extractors]({{< ref "search/java/developer-guide/advanced-usage/indexing/custom-text-extractors.md" >}}).

## setDocumentFilter method

The [setDocumentFilter](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setDocumentFilter(com.groupdocs.search.DocumentFilter)) method allows you to set a filter used to determine whether files adding to the index should be indexed. If a document adding separately or located in the adding folder does not match the filter, then it will not be added and indexed. The default value is null, which means that all added files will be indexed if their format is supported. Detailed information on creating and setting the document indexing filter can be found on the page [Document filtering during indexing]({{< ref "search/java/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}}).

## setIndexType method

The [setIndexType](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setIndexType(int)) method is used to specify the type of an index. The [IndexType](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexType) class contains 3 values:

*   [NormalIndex](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexType#NormalIndex) - the type of an index containing the content and metadata of the added documents. It supports all search features.
*   [MetadataIndex](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexType#MetadataIndex) - the type of an index containing only metadata of added documents. It supports all search features. An example of creating an index of this type is presented on the [Indexing metadata of documents]({{< ref "search/java/developer-guide/advanced-usage/indexing/indexing-metadata-of-documents.md" >}}) page.
*   [CompactIndex](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexType#CompactIndex) - the type of an index containing the content and metadata of the added documents. It takes much less disk space, but does not support the [phrase search]({{< ref "search/java/developer-guide/advanced-usage/searching/phrase-search.md" >}}) and the [date range search]({{< ref "search/java/developer-guide/advanced-usage/searching/date-range-search.md" >}}) features.

The default value is [NormalIndex](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexType#NormalIndex).

## getInMemoryIndex method

The [getInMemoryIndex](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#getInMemoryIndex()) method returns a value indicating whether an index is located in RAM or on disk. The return value for this method is set indirectly when creating or loading an index. An index is created on disk, when specifying the path to the index folder, otherwise an index is created in memory.

## setLogger method

The [setLogger](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setLogger(com.groupdocs.search.common.ILogger)) method allows you to specify in the index settings the logger used for logging index events and errors during its operation. The default value is null meaning that logging is not used. Detailed information on creating and assigning an index logger and the implementation of a custom logger is presented on the page [Logging]({{< ref "search/java/developer-guide/advanced-usage/indexing/logging.md" >}}).

## setMaxIndexingReportCount method

The [setMaxIndexingReportCount](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setMaxIndexingReportCount(int)) method allows you to specify the maximum number of indexing reports stored in RAM for an index since it was created or loaded. The default value is 5. Detailed information on indexing reports is provided on the page [Indexing reports]({{< ref "search/java/developer-guide/advanced-usage/indexing/indexing-reports.md" >}}).

## setMaxSearchReportCount method

The [setMaxSearchReportCount](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setMaxSearchReportCount(int)) method allows you to specify the maximum number of search reports stored in RAM for an index since it was created or loaded. The default value is 10. Detailed information on search reports is provided on the page [Search reports]({{< ref "search/java/developer-guide/advanced-usage/searching/search-reports.md" >}}).

## setSearchThreads method

The [setSearchThreads](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setSearchThreads(int)) method allows you to set the number of threads used to search in an index. By default, this value is [NumberOfThreads.Default](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/NumberOfThreads#Default), which means that the search will be performed using the number of threads equal to the number of processor cores. This number of threads ensures the optimal rate of each individual search in an index. If you plan a large number of parallel search queries and you need to ensure maximum total search performance, you should set the [NumberOfThreads.One](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/NumberOfThreads#One) value for this parameter.

## setTextStorageSettings method

The [setTextStorageSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setTextStorageSettings(com.groupdocs.search.options.TextStorageSettings)) method allows you to specify the settings for saving the text of indexed documents in an index. The default value is null, which means that document texts are not stored. Detailed information on saving the text of indexed documents in an index is presented on the page [Storing text of indexed documents]({{< ref "search/java/developer-guide/advanced-usage/indexing/storing-text-of-indexed-documents.md" >}}).

## setUseCharacterReplacements method

The [setUseCharacterReplacements](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setUseCharacterReplacements(boolean)) method allows you to set the value indicating whether to perform character replacements during the indexing process or not. The default value is false. Details on replacing characters during indexing are provided on the page [Character replacement during Indexing]({{< ref "search/java/developer-guide/advanced-usage/indexing/character-replacement-during-indexing.md" >}}).

## setUseStopWords method

The [setUseStopWords](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setUseStopWords(boolean)) method allows you to specify a value indicating whether to use stop words during indexing or not. Stop words are frequently used words that do not carry a semantic load, which are removed from an index to reduce its size. The default value for this parameter is true. Detailed information on stop words and their use is presented on the page [Indexing with stop words]({{< ref "search/java/developer-guide/advanced-usage/indexing/indexing-with-stop-words.md" >}}).

## setUseRawTextExtraction method

Property [setUseRawTextExtraction](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setUseRawTextExtraction(boolean)) allows you to specify a value indicating whether to use raw text extraction  mode whenever possible during indexing. The raw text extraction mode can significantly speed up the indexing process at the cost of losing the  formatting quality of the extracted text. The default value for this  parameter is true.



## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search index settings

Path: /search/net/search-index-settings/

This page contains a description of all index settings that can be specified in an instance of the [IndexSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings) class.

## CustomExtractors property

The [CustomExtractors](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/customextractors) property returns a collection of custom text extractors that allows adding new extractors for supported or not supported formats. A complete example of implementing a custom text extractor and using it to extract text is presented on the page [Custom text extractors]({{< ref "search/net/developer-guide/advanced-usage/indexing/custom-text-extractors.md" >}}).

## DocumentFilter property

The [DocumentFilter](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/documentfilter) property allows you to set a filter used to determine whether files adding to the index should be indexed. If a document adding separately or located in the adding folder does not match the filter, then it will not be added and indexed. The default value is null, which means that all added files will be indexed if their format is supported. Detailed information on creating and setting the document indexing filter can be found on the page [Document filtering during indexing]({{< ref "search/net/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}}).

## IndexType property

The [IndexType](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/indextype) property is used to specify the type of an index. The [IndexType](https://reference.groupdocs.com/net/search/groupdocs.search.options/indextype) enumeration contains 3 values:

*   **NormalIndex** - the type of an index containing the content and metadata of the added documents. It supports all search features.
*   **MetadataIndex** - the type of an index containing only metadata of added documents. It supports all search features. An example of creating an index of this type is presented on the [Indexing metadata of documents]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-metadata-of-documents.md" >}}) page.
*   **CompactIndex** - the type of an index containing the content and metadata of the added documents. It takes much less disk space, but does not support the [phrase search]({{< ref "search/net/developer-guide/advanced-usage/searching/phrase-search.md" >}}) and the [date range search]({{< ref "search/net/developer-guide/advanced-usage/searching/date-range-search.md" >}}) features.

The default value of this property is **NormalIndex**.

## InMemoryIndex property

The read-only property [InMemoryIndex](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/inmemoryindex) returns a value indicating whether an index is located in RAM or on disk. The value of this property is set indirectly when creating or loading an index. An index is created on disk, when specifying the path to the index folder, otherwise an index is created in memory.

## Logger property

The [Logger](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/logger) property allows you to specify in the index settings the logger used for logging index events and errors during its operation. The default value is null meaning that logging is not used. Detailed information on creating and assigning an index logger and the implementation of a custom logger is presented on the page [Logging]({{< ref "search/net/developer-guide/advanced-usage/indexing/logging.md" >}}).

## MaxIndexingReportCount property

The [MaxIndexingReportCount](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/maxindexingreportcount) property allows you to specify the maximum number of indexing reports stored in RAM for an index since it was created or loaded. The default value is 5. Detailed information on indexing reports is provided on the page [Indexing reports]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-reports.md" >}}).

## MaxSearchReportCount property

The [MaxSearchReportCount](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/maxsearchreportcount) property allows you to specify the maximum number of search reports stored in RAM for an index since it was created or loaded. The default value is 10. Detailed information on search reports is provided on the page [Indexing reports]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-reports.md" >}}).

## SearchThreads property

The [SearchThreads](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/searchthreads) property allows you to set the number of threads used to search in an index. By default, this value is [NumberOfThreads](https://reference.groupdocs.com/net/search/groupdocs.search.options/numberofthreads).Default, which means that the search will be performed using the number of threads equal to the number of processor cores. This number of threads ensures the optimal rate of each individual search in an index. If you plan a large number of parallel search queries and you need to ensure maximum total search performance, you should set the [NumberOfThreads](https://reference.groupdocs.com/net/search/groupdocs.search.options/numberofthreads).One value for this parameter.

## TextStorageSettings property

The [TextStorageSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/textstoragesettings) property allows you to specify the settings for saving the text of indexed documents in an index. The default value is null, which means that document texts are not stored. Detailed information on saving the text of indexed documents in an index is presented on the page [Storing text of indexed documents]({{< ref "search/net/developer-guide/advanced-usage/indexing/storing-text-of-indexed-documents.md" >}})).

## UseCharacterReplacements property

The [UseCharacterReplacements](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/usecharacterreplacements) property allows you to set the value indicating whether to perform character replacements during the indexing process or not. The default value is false. Details on replacing characters during indexing are provided on the page [Character replacement during Indexing]({{< ref "search/net/developer-guide/advanced-usage/indexing/character-replacement-during-indexing.md" >}}).

## UseStopWords property

The [UseStopWords](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/usestopwords) property allows you to specify a value indicating whether to use stop words during indexing or not. Stop words are frequently used words that do not carry a semantic load, which are removed from an index to reduce its size. The default value for this parameter is true. Detailed information on stop words and their use is presented on the page [Indexing with stop words]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-with-stop-words.md" >}}).



## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search index settings

Path: /search/nodejs-java/search-index-settings/

This page contains a description of all index settings that can be specified in an instance of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class.

## setAutoDetectEncoding method

The [setAutoDetectEncoding](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setAutoDetectEncoding(boolean)) method sets a flag that allows you to automatically detect the following encodings of text files during indexing: UTF-32 LE, UTF-32 BE, UTF-16 LE, UTF-16 BE, UTF-8, UTF-7, ANSI. By default, the encoding auto detection of text files is disabled. But in any case, the encoding of a text file can be set during indexing when the [FileIndexing](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#FileIndexing) event is raised. Detailed information on detecting and setting the encoding of text files is presented on the page [Text file encoding detection]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/text-file-encoding-detection.md" >}}).

## getCustomExtractors method

The [getCustomExtractors](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#getCustomExtractors()) method returns a collection of custom text extractors that allows adding new extractors for supported or not supported formats. A complete example of implementing a custom text extractor and using it to extract text is presented on the page [Custom text extractors]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/custom-text-extractors.md" >}}).

## setDocumentFilter method

The [setDocumentFilter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setDocumentFilter(com.groupdocs.search.DocumentFilter)) method allows you to set a filter used to determine whether files adding to the index should be indexed. If a document adding separately or located in the adding folder does not match the filter, then it will not be added and indexed. The default value is null, which means that all added files will be indexed if their format is supported. Detailed information on creating and setting the document indexing filter can be found on the page [Document filtering during indexing]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}}).

## setIndexType method

The [setIndexType](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setIndexType(int)) method is used to specify the type of an index. The [IndexType](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexType) class contains 3 values:

*   [NormalIndex](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexType#NormalIndex) - the type of an index containing the content and metadata of the added documents. It supports all search features.
*   [MetadataIndex](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexType#MetadataIndex) - the type of an index containing only metadata of added documents. It supports all search features. An example of creating an index of this type is presented on the [Indexing metadata of documents]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/indexing-metadata-of-documents.md" >}}) page.
*   [CompactIndex](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexType#CompactIndex) - the type of an index containing the content and metadata of the added documents. It takes much less disk space, but does not support the [phrase search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/phrase-search.md" >}}) and the [date range search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/date-range-search.md" >}}) features.

The default value is [NormalIndex](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexType#NormalIndex).

## getInMemoryIndex method

The [getInMemoryIndex](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#getInMemoryIndex()) method returns a value indicating whether an index is located in RAM or on disk. The return value for this method is set indirectly when creating or loading an index. An index is created on disk, when specifying the path to the index folder, otherwise an index is created in memory.

## setLogger method

The [setLogger](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setLogger(com.groupdocs.search.common.ILogger)) method allows you to specify in the index settings the logger used for logging index events and errors during its operation. The default value is null meaning that logging is not used. Detailed information on creating and assigning an index logger and the implementation of a custom logger is presented on the page [Logging]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/logging.md" >}}).

## setMaxIndexingReportCount method

The [setMaxIndexingReportCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setMaxIndexingReportCount(int)) method allows you to specify the maximum number of indexing reports stored in RAM for an index since it was created or loaded. The default value is 5. Detailed information on indexing reports is provided on the page [Indexing reports]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/indexing-reports.md" >}}).

## setMaxSearchReportCount method

The [setMaxSearchReportCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setMaxSearchReportCount(int)) method allows you to specify the maximum number of search reports stored in RAM for an index since it was created or loaded. The default value is 10. Detailed information on search reports is provided on the page [Search reports]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-reports.md" >}}).

## setSearchThreads method

The [setSearchThreads](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setSearchThreads(int)) method allows you to set the number of threads used to search in an index. By default, this value is [NumberOfThreads.Default](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/NumberOfThreads#Default), which means that the search will be performed using the number of threads equal to the number of processor cores. This number of threads ensures the optimal rate of each individual search in an index. If you plan a large number of parallel search queries and you need to ensure maximum total search performance, you should set the [NumberOfThreads.One](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/NumberOfThreads#One) value for this parameter.

## setTextStorageSettings method

The [setTextStorageSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setTextStorageSettings(com.groupdocs.search.options.TextStorageSettings)) method allows you to specify the settings for saving the text of indexed documents in an index. The default value is null, which means that document texts are not stored. Detailed information on saving the text of indexed documents in an index is presented on the page [Storing text of indexed documents]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/storing-text-of-indexed-documents.md" >}}).

## setUseCharacterReplacements method

The [setUseCharacterReplacements](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setUseCharacterReplacements(boolean)) method allows you to set the value indicating whether to perform character replacements during the indexing process or not. The default value is false. Details on replacing characters during indexing are provided on the page [Character replacement during Indexing]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/character-replacement-during-indexing.md" >}}).

## setUseStopWords method

The [setUseStopWords](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setUseStopWords(boolean)) method allows you to specify a value indicating whether to use stop words during indexing or not. Stop words are frequently used words that do not carry a semantic load, which are removed from an index to reduce its size. The default value for this parameter is true. Detailed information on stop words and their use is presented on the page [Indexing with stop words]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/indexing-with-stop-words.md" >}}).

## setUseRawTextExtraction method

Property [setUseRawTextExtraction](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setUseRawTextExtraction(boolean)) allows you to specify a value indicating whether to use raw text extraction  mode whenever possible during indexing. The raw text extraction mode can significantly speed up the indexing process at the cost of losing the  formatting quality of the extracted text. The default value for this  parameter is true.



## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Showcases

Path: /conversion/net/showcases/

This section contains GroupDocs.Conversion for .NET integration guides and showcases.

## Online demo

Try GroupDocs.Conversion with our [free online file converter](https://products.groupdocs.app/conversion).
<!--Along with full-featured .NET library we provide free Apps and free services for document conversion.
In order to see a full potential of GroupDocs.Conversion, you are welcome to convert PDF to DOCX, JPG to XLSX, PPTX to PNG and more with **[Free Online Document Conversion App](https://products.groupdocs.app/conversion)**.-->

## Demo projects

You may download GroupDocs.Conversion for .NET code examples from our GitHub [repository](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET) and see how to convert files programmatically:

* [ASP.NET MVC (.NET Framework)](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/tree/master/Demos/MVC)
* [ASP.NET Web Forms (.NET Framework)](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/tree/master/Demos/WebForms)
* [Examples, plugins, and showcase](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET)

For more details about running examples and demo projects please refer to ["How to Run Examples"]({{< ref "conversion/net/getting-started/how-to-run-examples" >}}) article.

---

## Showcases

Path: /editor/java/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Editor for Java by yourself? Please check C# code sources, how-to examples and free online demonstrations provided below to learn more about edit file features.{{< /alert >}}

## GitHub Examples

You may download GroupDocs.Editor for Java code examples from our GitHub repository and see file editing features in action:s

* [GroupDocs.Editor for Java examples, plugins, and showcase](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java)

## Online Demo

Along with full-featured Java library we provide free Apps and free services for document editor.
In order to see a full potential of GroupDocs.Editor, you are welcome to edit DOCX, PDF, XLSX, PPTX and more with **[Free Online Document Editor App](https://products.groupdocs.app/editor)**.

---

## Showcases

Path: /editor/net/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Editor for .NET by yourself? Please check C# code sources, how-to examples and free online demonstrations provided below to learn more about edit file features.{{< /alert >}}

## GitHub Examples

To get started with GroupDocs.Editor for .NET, you can explore a variety of code examples, plugins, and showcases available on GitHub. The repository provides a rich collection of resources that showcase the capabilities of the library and demonstrate how to implement file editing features. You can access these valuable resources at the following GitHub repository:

[GroupDocs.Editor for .NET GitHub Repository](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET)

Here, you'll find code examples that cover different scenarios, helping you understand the library's usage and integration possibilities.


## GroupDocs.Editor.UI Examples

GroupDocs.Editor.UI is a library designed to simplify the use of GroupDocs.Editor for .NET. It provides user-friendly interfaces and tools to enhance the overall editing experience. The GitHub repository for GroupDocs.Editor.UI contains specific code examples that demonstrate how to leverage the UI library effectively. Here are some notable examples:

### 1. Exploring the API RestFul Service

Explore an example that utilizes the API RestFul service for GroupDocs.Editor for .NET. This example illustrates how to interact with the API to achieve various editing functionalities. Check out the code and get insights into incorporating RestFul services into your applications.

[API RestFul Service Example](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-UI/tree/master/samples/GroupDocs.Editor.UI.ApiSample)

### 2. Building a React Document Editing SPA

Learn how to build a React Document Editing Single Page Application (SPA) using GroupDocs.Editor.UI.Api and TinyMCE. This example provides a practical guide to creating a web-based document editor using popular technologies like React and TinyMCE.

[React SPA Example](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-UI/tree/master/samples/GroupDocs.Editor.UI.ReactSpaSample)

### 3. Building a Document Editing SPA with Angular

Discover how to build a Document Editing SPA based on `groupdocs.editor.angular.ui-wordprocessing`. This example showcases the integration of GroupDocs.Editor.UI with Angular, offering insights into creating a rich document editing experience in an Angular-based application.

[Angular SPA Example](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-UI/tree/master/samples/GroupDocs.Editor.UI.SpaSample)


## Online Demo

To experience the full potential of GroupDocs.Editor, you can take advantage of the free online document editor app. This online demo allows you to edit various document formats, including DOCX, PDF, XLSX, PPTX, and more. It's a great way to explore the capabilities of GroupDocs.Editor without any installation. Visit the following link to access the Free Online Document Editor App:

[Free Online Document Editor App](https://products.groupdocs.app/editor)

By using the online demo, you can test and evaluate the features of GroupDocs.Editor in a real-world editing environment. It's a convenient way to assess the library's capabilities and determine its suitability for your document editing needs.

In conclusion, GroupDocs.Editor for .NET offers a comprehensive solution for document editing in .NET applications. Whether you prefer exploring code examples on GitHub, leveraging the UI library, or trying out the online demo, GroupDocs.Editor provides a robust set of tools for seamless document editing experiences.

---

## Showcases

Path: /editor/nodejs-java/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Editor for Node.js by yourself? Please check C# code sources, how-to examples and free online demonstrations provided below to learn more about edit file features.{{< /alert >}}

## GitHub Examples

You may download GroupDocs.Editor for Node.js code examples from our GitHub repository and see file editing features in action:s

* [GroupDocs.Editor for Node.js examples, plugins, and showcase](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java)

## Online Demo

Along with full-featured Node.js library we provide free Apps and free services for document editor.
In order to see a full potential of GroupDocs.Editor, you are welcome to edit DOCX, PDF, XLSX, PPTX and more with **[Free Online Document Editor App](https://products.groupdocs.app/editor)**.

---

## Showcases

Path: /merger/java/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Merger for Java by yourself? Please check C# code sources, how-to examples and free online demonstrations provided below to learn more about file merge features.{{< /alert >}}

## GitHub Examples

You may download GroupDocs.Merger for Java code examples from our GitHub repository and see file merge features in action:

* [GroupDocs.Merger for Java examples, plugins, and showcase](https://github.com/groupdocs-merger/GroupDocs.Merger-for-Java)

## Online Demo

Along with full-featured Java library we provide free Apps and free services for document merger.
In order to see a full potential of GroupDocs.Merger, you are welcome to merge DOC, PDF, XLSX, PPTX and more with **[Free Online Document Merger App](https://products.groupdocs.app/merger)**.

---

## Showcases

Path: /merger/net/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Merger for .NET by yourself? Please check C# code sources, how-to examples and free online demonstrations provided below to learn more about file merge features.{{< /alert >}}

## GitHub Examples

You may download GroupDocs.Merger for .NET code examples from our GitHub repository and see file merge features in action:

* [GroupDocs.Merger for .NET examples, plugins, and showcase](https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET)

## Online Demo

Along with full-featured .NET library we provide free Apps and free services for document merger.
In order to see a full potential of GroupDocs.Merger, you are welcome to merge DOC, PDF, XLSX, PPTX and more with **[Free Online Document Merger App](https://products.groupdocs.app/merger)**.

---

## Showcases

Path: /merger/nodejs-java/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Merger for Node.js via Java by yourself? Please check C# code sources, how-to examples and free online demonstrations provided below to learn more about file merge features.{{< /alert >}}

## GitHub Examples

You may download GroupDocs.Merger for Node.js via Java code examples from our GitHub repository and see file merge features in action:

* [GroupDocs.Merger for Node.js via Java examples, plugins, and showcase](https://github.com/GroupDocs.Merger-for-Node.js-via-Java)

## Online Demo

Along with full-featured Node.js via Java library we provide free Apps and free services for document merger.
In order to see a full potential of GroupDocs.Merger, you are welcome to merge DOC, PDF, XLSX, PPTX and more with **[Free Online Document Merger App](https://products.groupdocs.app/merger)**.

---

## Showcases

Path: /merger/python-net/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Merger for Python via .NET by yourself? Please check C# code sources, how-to examples and free online demonstrations provided below to learn more about file merge features.{{< /alert >}}

## GitHub Examples

You may download GroupDocs.Merger for Python via .NET code examples from our GitHub repository and see file merge features in action:

* [GroupDocs.Merger for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-merger/GroupDocs.Merger-for-Python-via-.NET)

## Online Demo

Along with full-featured Python via .NET library we provide free Apps and free services for document merger.
In order to see a full potential of GroupDocs.Merger, you are welcome to merge DOC, PDF, XLSX, PPTX and more with **[Free Online Document Merger App](https://products.groupdocs.app/merger)**.

---

## Sign document with Barcode signature - advanced

Path: /signature/java/sign-document-with-barcode-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [BarcodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions) class to specify additional options for Barcode signature to specify following signature appearance

*   signature alignment ([setHorizontalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setHorizontalAlignment(int)), [setVerticalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setVerticalAlignment(int)))
*   margins ([setMargin](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setMargin(com.groupdocs.signature.domain.Padding)))
*   border and background settings ([setBorder,](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setBorder(com.groupdocs.signature.domain.Border)) [setBackground](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setBackground(com.groupdocs.signature.domain.Background)))
*   font and colors ([setFont](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setFont(com.groupdocs.signature.domain.SignatureFont)), [setForeColor](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setForeColor(java.awt.Color)))

Here are the steps to add Barcode signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the  [BarcodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions) object with all required additional options.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [BarcodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions) to it. 
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

  

This example shows how to add Barcode signature to document. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
// instantiating the signature object
final Signature signature = new Signature("sample.docx");
try
{
    // setup options with text of signature
    BarcodeSignOptions signOptions = new BarcodeSignOptions("12345678");
    // setup Barcode encoding type
    signOptions.setEncodeType(BarcodeTypes.Code128);
    // set signature position
    signOptions.setLeft(100);
    signOptions.setTop(100);
    // when VerticalAlignment is set the Top coordinate will be ignored.
    // Use Margin properties Top, Bottom to provide vertical offset
    signOptions.setVerticalAlignment(VerticalAlignment.Top);
            // when HorizontalAlignment is set the Left coordinate will be ignored.
            // Use Margin properties Left, Right to provide horizontal offset
    signOptions.setHorizontalAlignment(HorizontalAlignment.Right);
    Padding padding = new Padding();
    padding.setLeft(20);
    padding.setTop(20);
    signOptions.setMargin(padding);
            // adjust signature appearance
            // setup signature border
    Border border = new Border();
    border.setColor(Color.GREEN);
    border.setDashStyle(DashStyle.DashLongDashDot);
    border.setWeight(2);
    border.setTransparency(0.5);
    border.setVisible(true);
    signOptions.setBorder(border);    
            // set text color and Font
    signOptions.setForeColor(Color.RED);
    SignatureFont font = new SignatureFont();
    font.setSize(12);
    font.setFamilyName("Comic Sans MS");
    signOptions.setFont(font);             
    // specify position of text with barcode line
    signOptions.setCodeTextAlignment(CodeTextAlignment.Above);
            // setup background
    Background background = new Background();
    background.setColor(Color.GREEN);
    background.setTransparency(0.5);
    background.setBrush(new LinearGradientBrush(Color.GREEN, Color.DARK_GRAY,0));
    signOptions.setBackground(background);                    
    
    // sign document   
    ignResult signResult = signature.sign("SampleSigned.docx", signOptions);
    // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for(BaseSignature temp : signResult.getSucceeded())
    {
        System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }   
}catch (Exception e){
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with encrypted metadata text

Path: /signature/java/sign-documents-with-encrypted-metadata-text/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to secure Metadata signatures with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType)), string value key and string value salt.

Here are the steps to secure Metadata string values with standard encryption with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Compose object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class with required algorithm and secure pair key/salt  
*   Create objects of [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) class and setup property [MetadataSignOptions.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) with object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption). In this case all added Metadata signatures to options collection will be encrypted.  
*   Alternative way to encrypt only selected Metadata signatures is to setup property MetadataSignature[.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) to each signature that requires to be secured.
*   Create required collection of [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) object with proper class for document type (like [PdfMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/PdfMetadataSignature), [ImageMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/ImageMetadataSignature),  [PresentationMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/PresentationMetadataSignature), [SpreadsheetMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/SpreadsheetMetadataSignature), [WordProcessingMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/WordProcessingMetadataSignature))  
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it.
    

## Implementation of encrypted Metadata signature

This example shows how to sign document with encrypted Metadata signatures over .

```java
Signature signature = new Signature("sample.docx");
 
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();       
 
// setup signature metadata
WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
 
// setup data of document id
WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", java.util.UUID.randomUUID().toString());
 
// add signatures to options
options.getSignatures().add(mdAuthor);
options.getSignatures().add(mdDocId);
 
// sign document to file
SignResult signResult = signature.sign("MetadataEncryptedText.docx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Implementation of encrypted Metadata signature over MetadataSignOptions encryption

This example shows how to sign document with encrypted Metadata signatures over .

```java
Signature signature = new Signature("sample.docx");
 
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();
 
// set encryption for all metadata signatures for this options
// if you need separate encryption use own MetadataSignature.DataEncryption property
options.setDataEncryption(encryption);            
 
// setup signature metadata
WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
 
// setup data of document id
WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", java.util.UUID.randomUUID().toString());
 
// add signatures to options
options.getSignatures().add(mdAuthor);
options.getSignatures().add(mdDocId);
 
// sign document to file
SignResult signResult = signature.sign("MetadataEncryptedText.docx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with encrypted metadata text

Path: /signature/net/sign-documents-with-encrypted-metadata-text/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to secure Metadata signatures with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype)), string value key and string value salt.

Here are the steps to secure Metadata string values with standard encryption with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class with required algorithm and secure pair key/salt
* Create objects of [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) class and setup property [MetadataSignOptions.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/dataencryption) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption). In this case all added Metadata signatures to options collection will be encrypted.
* Alternative way to encrypt only selected Metadata signatures is to setup property [MetadataSignature.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/dataencryption) to each signature that requires to be secured.
* Create required collection of [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) object with proper class for document type (like [PdfMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/pdfmetadatasignature), [ImageMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagemetadatasignature),  [PresentationMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/presentationmetadatasignature), [SpreadsheetMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/spreadsheetmetadatasignature), [WordProcessingMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/wordprocessingmetadatasignature))
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

## Implementation of encrypted Metadata signature

This example shows how to sign document with encrypted Metadata signatures over .

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    // setup key and passphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    // setup options with text of signature
    MetadataSignOptions options = new MetadataSignOptions()
    {

    };

    // setup signature metadata - this text will not be encrypted
    WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");

    // setup data of document id
    WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", Guid.NewGuid().ToString());
    // set encryption for separate metadata signatures for this options
    mdDocId.DataEncryption = encryption

    // add signatures to options
    options.Signatures.Add(mdAuthor);
    options.Signatures.Add(mdDocId);
    // sign document to file
    signature.Sign("MetadataEncryptedText.docx", options);

}
```

## Implementation of encrypted Metadata signature over MetadataSignOptions encryption

This example shows how to sign document with encrypted Metadata signatures over .

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    // setup key and passphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    // setup options with text of signature
    MetadataSignOptions options = new MetadataSignOptions()
    {
        // set encryption for all metadata signatures for this options
        // if you need separate encryption use own MetadataSignature.DataEncryption property
        DataEncryption = encryption
    };

    // setup signature metadata
    WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
    // setup data of document id
    WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", Guid.NewGuid().ToString());

    // add signatures to options
    options.Signatures.Add(mdAuthor);
    options.Signatures.Add(mdDocId);
    // sign document to file
    signature.Sign("MetadataEncryptedText.docx", options);

}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign documents with encrypted QR-code text

Path: /signature/java/sign-documents-with-encrypted-qr-code-text/

GroupDocs.Signature provides ability to secure QR-code signature text with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType)), string value key and string value salt.

Here are the steps to secure QR-code text with standard encryption with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class and pass source document path or stream as a constructor parameter.    
*   Compose object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class with required algorithm and secure pair key/salt      
*   Create objects of [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) class and setup property [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) with object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption)       
*   Call [Sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) to it.
    

This example shows how to sign document with secure QR-code signature text.

```java
Signature signature = new Signature("sample.pdf");
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
// setup QR-Code options
QrCodeSignOptions options = new QrCodeSignOptions();
// set custom object to serialize to QR Code
options.setText("This is private text to be secured.");
// QR-code type
options.setEncodeType(QrCodeTypes.QR);
// specify serialization encryption
options.setDataEncryption(encryption);
// locate and aligh signature
options.setHeight(100);
options.setWidth(100);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding() ;
padding.setRight(10);
padding.setBottom(10);
options.setMargin(padding);
 
// sign document to file
SignResult signResult = signature.sign("QRCodeEncryptedText.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign Pdf documents with special appearance

Path: /signature/java/sign-pdf-documents-with-special-appearance/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) contains classes that implements for Pdf document special signature appearances.

Base signature options [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) contains property [SignOptions.setAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setAppearance(com.groupdocs.signature.options.appearances.SignatureAppearance)) that expects instance of the following classes

*   [PdfTextAnnotationAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/PdfTextAnnotationAppearance) class implements for Pdf documents signature as annotation area. Note that [TextSignOptions.setSignatureImplementation](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setSignatureImplementation(int)) property must be set to [TextSignatureImplementation.Annotation](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/TextSignatureImplementation)
*   [PdfTextStickerAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/PdfTextStickerAppearance) class implements for Pdf documents signature as small sticker. Note that [TextSignOptions.setSignatureImplementation](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setSignatureImplementation(int)) property must be set to [TextSignatureImplementation.Sticker](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/TextSignatureImplementation) 
    

Here are the steps to setup special Pdf  document Text signature appearance with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Compose object of [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) object with all required additional options.    
*   Set  [TextSignOptions.setAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setAppearance(com.groupdocs.signature.options.appearances.SignatureAppearance)) property with [PdfTextAnnotationAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.appearances/PdfTextAnnotationAppearance) object and set its properties      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) to it. 
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

## Sign Pdf document with Text signature Annotation appearance

This example shows how to add Text signature to Pdf document with annotation look. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
Signature signature = new Signature("sample.pdf");
TextSignOptions options = new TextSignOptions("John Smith");
 
// set signature position
options.setLeft(100);
options.setTop(100);
 
// set signature rectangle
options.setWidth(100);
options.setHeight(30);
// setup proper signature implementation
options.setSignatureImplementation(TextSignatureImplementation.Annotation);
 
PdfTextAnnotationAppearance appearance = new PdfTextAnnotationAppearance();
Border border = new Border();
border.setColor(Color.BLUE);
border.setDashStyle(DashStyle.Dash);
border.setWeight(2);
appearance.setBorder(border);
appearance.setBorderEffect(PdfTextAnnotationBorderEffect.Cloudy);
appearance.setBorderEffectIntensity(2);
appearance.setHCornerRadius(10);
 
// text content of an annotation
appearance.setContents("Sample");
appearance.setSubject("Sample subject");
appearance.setTitle("Sample Title");
 
options.setAppearance(appearance);
// set signature alignment
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setBottom(20);
padding.setRight(20);
options.setMargin(padding);
// set text color and Font
options.setForeColor(Color.RED);
SignatureFont signatureFont = new SignatureFont();
signatureFont.setSize(12);
signatureFont.setFamilyName("Comic Sans MS");
options.setFont(signatureFont);
 
// sign document to file
SignResult signResult = signature.sign("signedAnnotation.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Sign Pdf document with Text signature Sticker appearance

This example shows how to add Text signature to Pdf document with sticker look. See [SignResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/SignResult)

```java
Signature signature = new Signature("sample.pdf");
TextSignOptions options = new TextSignOptions("John Smith");
 
// set signature position
options.setLeft(100);
options.setTop(100);
 
// set signature rectangle
options.setWidth(100);
options.setHeight(30);
// setup proper signature implementation
options.setSignatureImplementation(TextSignatureImplementation.Sticker);
PdfTextStickerAppearance appearance = new PdfTextStickerAppearance();
// select sticker icon
appearance.setIcon(PdfTextStickerIcon.Star);
// setup if popup annotation will be opened by default
appearance.setOpened(false);
// text content of an annotation
appearance.setContents("Sample");
appearance.setSubject("Sample subject");
appearance.setTitle("Sample Title");
options.setAppearance(appearance);
     
// set signature alignment
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setBottom(20);
padding.setRight(20);
options.setMargin(padding);
// set text color and Font
options.setForeColor(Color.RED);
SignatureFont signatureFont = new SignatureFont();
signatureFont.setSize(12);
signatureFont.setFamilyName("Comic Sans MS");
options.setFont(signatureFont);
 
 
// sign document to file
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign Pdf documents with special appearance

Path: /signature/net/sign-pdf-documents-with-special-appearance/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) contains classes that implements for Pdf document special signature appearances.

Base signature options [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) contains property [SignOptions.Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) that expects instance of the following classes

* [PdfTextAnnotationAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/pdftextannotationappearance) class implements for Pdf documents signature as annotation area. Note that [TextSignOptions.SignatureImplementation](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/signatureimplementation) property must be set to [TextSignatureImplementation.Annotation](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation)
* [PdfTextStickerAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/pdftextstickerappearance) class implements for Pdf documents signature as small sticker. Note that [TextSignOptions.SignatureImplementation](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/signatureimplementation) property must be set to [TextSignatureImplementation.Sticker](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation)

Here are the steps to setup special Pdf  document Text signature appearance with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Compose object of [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) object with all required additional options.
* Set  [TextSignOptions.Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) property with [PdfTextAnnotationAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/pdftextannotationappearance) object and set its properties
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

## Sign Pdf document with Text signature Annotation appearance

This example shows how to add Text signature to Pdf document with annotation look. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // setup proper signature implementation
        SignatureImplementation = TextSignatureImplementation.Annotation,
        Appearance = new PdfTextAnnotationAppearance()
        {
            Border = new Border()
            {
                Color = Color.Blue,
                DashStyle = DashStyle.Dash,
                Weight = 2,
            },
            BorderEffect = PdfTextAnnotationBorderEffect.Cloudy,
            BorderEffectIntensity = 2,
            HCornerRadius = 10,
            // text content of an annotation
            Contents = "Sample",
            Subject = "Sample subject",
            Title = "Sample Title",
        },
        // set signature alignment
        VerticalAlignment = Domain.VerticalAlignment.Bottom,
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Bottom = 20, Right = 20 },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
    };
    // sign document to file
    signature.Sign("signedAnnotation.pdf", options);
}
```

## Sign Pdf document with Text signature Sticker appearance

This example shows how to add Text signature to Pdf document with sticker look. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature(filePath))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // setup proper signature implementation
        SignatureImplementation = TextSignatureImplementation.Sticker,
        Appearance = new PdfTextStickerAppearance()
        {
            // select sticker icon
            Icon = PdfTextStickerIcon.Star,
            // setup if popup annotation will be opened by default
            Opened = false,
            // text content of an annotation
            Contents = "Sample",
            Subject = "Sample subject",
            Title = "Sample Title"
        },
        // set signature alignment
        VerticalAlignment = Domain.VerticalAlignment.Bottom,
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Bottom = 20, Right = 20 },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
    };
    // sign document to file
    signature.Sign(outputFilePath, options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Single Row Image in Presentation Document

Path: /assembly/java/single-row-image-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Single Row in Microsoft PowerPoint Document

### Creating a Single Row

Please follow below steps to create Single Row Image in MS PowerPoint 2013:

1.  Creat a new presentation slide.
2.  Insert a desired shape to display image in it.
3.  Go to Insert Tab and select shape by clicking on Shape Icon.
4.  Write "Name" and "Age" to show name and age info of the customer.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent information of first single manager with the following key requirements:

*   Report must show image of the manager
*   It must show Name and age of manager
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}At the moment, GroupDocs.Assembly does not support images in PowerPoint Presentation.{{< /alert >}}

```java
Name:	<<[manager.getName()]>>
Age:	<<[manager.getAge()]>>
```

### Download Single Row Template

Please download the sample Single Row document we created in this article:

*   [Single Row.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Single%20Row.pptx?raw=true)

### Generating The Report

{{< gist GroupDocsGists f20a9bbba651eb9e04988200853531e1 >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Single Row Image in Presentation Document

Path: /assembly/net/single-row-image-in-presentation-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Presentation Document format based on the use case: [Working with a Business Case](https://docs.groupdocs.com/assembly/net/working-with-a-business-case/).{{< /alert >}}

## Single Row in Microsoft PowerPoint Document

### Creating a Single Row

Please follow below steps to create Single Row Image in MS PowerPoint 2013:

1.  Create a new presentation slide.
2.  Insert the desired shape to display the image in it.
3.  Go to Insert Tab and select shape by clicking on Shape Icon.
4.  Write "Name" and "Contact Number" to show the name and contact info of the customer.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent information of first single customer with the following key requirements:

*   Report must show image of the customer.
*   It must show Name and Contact Number of the customer.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}At the moment, GroupDocs.Assembly does not support images in PowerPoint Presentation.{{< /alert >}}

<table class="iksweb">
	<tbody>
		<tr>
			<td rowspan="2" style="font-size: 44pt">Click to<br> add title</td>
			<td>Name:</td>
			<td><<[customer.CustomerName]>></td>
		</tr>
		<tr>
			<td>Contact Details:</td>
			<td><<[customer. CustomerContactNumber]>></td>
		</tr>
	</tbody>
</table>

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Single Row Template

Please download the sample Single Row document we created in this article:

*   [Single Row.pptx](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Single%20Row.pptx?raw=true)

{{< alert style="warning" >}}Use this template for DB, Dataset, JSON and XML examples also.{{< /alert >}}

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists 81fa18ead6c31fc0ce67865d45fe721a >}}

#### Database Entities

{{< gist GroupDocsGists af2e23cb9e089ac183b646d878cd32ad >}}

#### Using DataSet

{{< gist GroupDocsGists 41f796d33332cbce2a6be8f44b73c5aa >}}

#### Using XML DataSource

{{< gist GroupDocsGists 5160c2dedcf888126c41ed2a7318457e >}}

#### Using JSON DataSource

{{< gist GroupDocsGists 1c5b5322890dca734b2b0eeb464a67e4 >}}

## Single Row in OpenOffice Presentation Document

### Creating the Template

OpenDocument Presentation (ODP) is a presentation document format which can be used as an alternative to Microsoft PowerPoint Document (PPT/PPTX) formats. Since ODP is not a Microsoft Proprietary format, there are multiple software (including Microsoft Office and Apache OpenOffice) available to create, open, edit and save this format. For more information on the available software to work with ODP, please visit [wikipedia article](https://en.wikipedia.org/wiki/OpenDocument#Software).

In this topic, we'll not reinvent the wheel to recreate a template for generating an 'Single Row' report in ODP format. Instead, we'll save the existing template to ODP format using Microsoft Office. In order to achieve this; assuming you are using Microsoft Office 2010, please follow below steps:

1.  Open existing template we created in previous topic.
2.  Click "File" and select "Save As".
3.  Select "OpenDocument Text" from "Save As Type" drop down.
4.  Click "Save".

### Download Template

*   [Single Row\_OpenDocument.odp](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Presentation%20Templates/Single%20Row_OpenDocument.odp?raw=true) (use same template for database, dataset, JSON and XML examples)

### Generating the report

#### Custom Objects

{{< gist GroupDocsGists f44876d4e43c66fb3b536d56847aa8f4 >}}

#### Database Entities

{{< gist GroupDocsGists 317a91c44b5618a36e29cc3d8462ae12 >}}

#### Using DataSet

{{< gist GroupDocsGists 1069f4bf98e493f1b0937874dbf62b32 >}}

#### Using XML DataSource

{{< gist GroupDocsGists 4d22e44311fd0efdaa08a0044db5e586 >}}

#### Using JSON DataSource

{{< gist GroupDocsGists fd80462fa882ae524a2b4295777afbcf >}}

### ODP Template and Report in Apache OpenOffice

In order to check compatibility of ODP between Microsoft Office 2010 and Apache OpenOffice 4.1.2, we performed below tests:

*   We opened the ODP template created through Microsoft Office 2010 in Apache OpenOffice 4.1.2. The template opened successfully in Apache OpenOffice without any issues or formatting losses.
*   We opened the ODP report generated through GroupDocs.Assembly in Apache OpenOffice 4.1.2. The report opened successfully in Apache OpenOffice without any issues or formatting losses.

---

## Skip image

Path: /markdown/net/image-skip-strategy/


Use `SkipImagesStrategy` when you want to convert a document to Markdown without exporting any images. Image references will be omitted from the output.

### Using static method

{{< tabs "skip-images-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    ImageExportStrategy = new SkipImagesStrategy()
};

MarkdownConverter.ToFile("business-plan.pdf", "skip-images-static.md", options);
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "skip-images-static.md" >}}  
```text
**Meridian Outdoor Co. — Business Plan**

FY2026 Strategic Plan

**Table of Contents**

Meridian Outdoor Co. — Business Plan .........................................................................................1FY2026 Strategic Plan.................................................................................................................1Table of Contents.............................................................................................................................2

1. E
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/image-skip-strategy/SkipImagesStatic/skip-images-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

{{< tabs "skip-images-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    ImageExportStrategy = new SkipImagesStrategy()
};

using var converter = new MarkdownConverter("business-plan.pdf");
converter.Convert("skip-images-instance.md", options);
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "skip-images-instance.md" >}}  
```text
**Meridian Outdoor Co. — Business Plan**

FY2026 Strategic Plan

**Table of Contents**

Meridian Outdoor Co. — Business Plan .........................................................................................1FY2026 Strategic Plan.................................................................................................................1Table of Contents.............................................................................................................................2

1. E
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/image-skip-strategy/SkipImagesInstance/skip-images-instance.md)
{{< /tab >}}
{{< /tabs >}}

---

## Skip image

Path: /markdown/python-net/image-skip-strategy/


Use `SkipImagesStrategy` when you want to convert a document to Markdown without exporting any images. Image references will be omitted from the output.

### Using static method

{{< tabs "skip-images-static">}}
{{< tab "skip_images_static.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, SkipImagesStrategy

def skip_images_static():
    """Convert a PDF to Markdown while skipping all images."""

    # Step 1: Configure the skip-images strategy to omit images from output
    options = ConvertOptions()
    options.image_export_strategy = SkipImagesStrategy()

    # Step 2: Convert using keyword argument for options
    MarkdownConverter.to_file("business-plan.pdf", "skip-images-static.md", convert_options=options)

if __name__ == "__main__":
    skip_images_static()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "skip-images-static.txt" >}}  
```text
**HOME**** ****BASED**** ****PROFESSIONAL**** **

**SERVICES**** **

***Business****** ******Plan****** ***

**TABLE**** ****OF**** ****CONTENTS**** **

Introduction  3

...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-skip-strategy/skip_images_static/skip-images-static.txt)
{{< /tab >}}
{{< tab "skip-images-static.txt" >}}  
```text
**HOME BASED PROFESSIONAL SERVICES *Business Plan* TABLE OF CONTENTS** 

Introduction  3

1. Executive Summary  5
1. Company Overview  6
1. Business Description  7
1. Market Analysis  8
1. Operating Plan  10
1. Marketing and Sales Plan  11
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-skip-strategy/skip_images_static/skip-images-static.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

{{< tabs "skip-images-instance">}}
{{< tab "skip_images_instance.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, SkipImagesStrategy

def skip_images_instance():
    """Skip all images during conversion using the instance API."""

    # Step 1: Configure the skip-images strategy
    options = ConvertOptions()
    options.image_export_strategy = SkipImagesStrategy()

    # Step 2: Open the document with a context manager
    with MarkdownConverter("business-plan.pdf") as converter:
        # Step 3: Convert using keyword argument for options
        converter.convert("skip-images-instance.md", convert_options=options)

if __name__ == "__main__":
    skip_images_instance()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "skip-images-instance.txt" >}}  
```text
**HOME**** ****BASED**** ****PROFESSIONAL**** **

**SERVICES**** **

***Business****** ******Plan****** ***

**TABLE**** ****OF**** ****CONTENTS**** **

Introduction  3

...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-skip-strategy/skip_images_instance/skip-images-instance.txt)
{{< /tab >}}
{{< tab "skip-images-instance.txt" >}}  
```text
**HOME BASED PROFESSIONAL SERVICES *Business Plan* TABLE OF CONTENTS** 

Introduction  3

1. Executive Summary  5
1. Company Overview  6
1. Business Description  7
1. Market Analysis  8
1. Operating Plan  10
1. Marketing and Sales Plan  11
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/image-skip-strategy/skip_images_instance/skip-images-instance.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Specify file type when loading a document

Path: /signature/net/load-document-with-filetype/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) supports specifing the file type when loading a documents. When loading a document via a file path or FileStream, GroupDocs.Signature checks the file extension to determine the file type, which can take some time. with the new feature, you can specify the file type directly in LoadOptions, and GroupDocs.Signature will skip the detection process and use the specified type right away.

The following are the steps to work with password protected documents.

*   Instantiate the [LoadOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/loadoptions) object and set the file type;
*   Create a Stream for the document file using File.OpenRead(filePath);
*   Create [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object by passing the document stream and load options to its constructor;
*   Call the Sign method to sign the document and save the signed version to the output path.

The following code sample shows how to specify file type when loading a document.

```csharp
// The path to the documents directory.
string filePath = Constants.SAMPLE_PDF;
string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine(Constants.OutputPath, "LoadWithFileType", fileName);

using (Stream stream = File.OpenRead(filePath))
{
    // Specify the file type (PDF) while loading the document
    LoadOptions loadOptions = new LoadOptions(FileType.PDF);

    // Initialize the Signature instance with the file stream and load options
    using (Signature signature = new Signature(stream, loadOptions))
    {
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
        {
            EncodeType = QrCodeTypes.QR,
            Left = 100,
            Top = 100
        };
        // sign document to file
        signature.Sign(outputFilePath, options);
    }
}
Console.WriteLine("\nSource document signed successfully.\nFile saved at " + outputFilePath);
```

## More resources
### GitHub Examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)     
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)    
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)    

### Free Online Apps 
Along with the full-featured .NET library, we provide simple but powerful free online apps.  
To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Specify file type when loading a document

Path: /viewer/java/specify-file-type-when-loading-a-document/


You can specify the file type using [LoadOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/LoadOptions).

The following code snippet shows how to specify the file type when loading a document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.FileType;
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.LoadOptions;
// ...

// Specify the file type.
LoadOptions loadOptions = new LoadOptions(FileType.DOCX);

// Render a file using inputStream.
try (Viewer viewer = new Viewer(inputStream, loadOptions)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Specify file type when loading a document

Path: /viewer/net/specify-file-type-when-loading-a-document/


When loading a document by specifying a path to a file or using [FileStream](https://docs.microsoft.com/en-us/dotnet/api/system.io.filestream), GroupDocs.Viewer determines file type by extension. Otherwise, GroupDocs.Viewer tries to determine file type by its signature or content. It takes time and may affect performance. 

You can specify the file type using [LoadOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions). If you do this, GroupDocs.Viewer skips file type detection and use the specified type.

The following code snippet shows how to specify the file type when loading a document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

Stream stream = GetFileStream("sample.docx"); //TODO: implement your method

// Specify the file type.
LoadOptions loadOptions = new LoadOptions(FileType.DOCX);

//Render a file.
using (Viewer viewer = new Viewer(stream, loadOptions))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Dim stream As Stream = GetFileStream("sample.docx") 'TODO: implement your method
    
        ' Specify the file type.
        Dim loadOptions As LoadOptions = New LoadOptions(FileType.DOCX)
    
        'Render a file.
        Using viewer As Viewer = New Viewer(stream, loadOptions)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Specify spreadsheet rendering options

Path: /viewer/java/specify-rendering-options/

GroupDocs.Viewer ships with the [SpreadsheetOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions) class that allows you to specify different spreadsheet rendering options (for example, you can display row and column headings in the output file, render grid lines, or adjust cell text overflow). To access these options, use the [setSpreadsheetOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setSpreadsheetOptions-com.groupdocs.viewer.options.SpreadsheetOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

## Render row and column headings

Rows and columns in a worksheet have unique names displayed on the worksheet's left and top side. Rows are numbered (1, 2, 3, ..., 1048576), and columns are lettered (A, B, C, ..., XFD).

![Row and column headings in a worksheet](/viewer/java/images/rendering-basics/render-spreadsheets/excel-row-and-column-headings.png)

Use the [SpreadsheetOptions.setRenderHeadings](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setRenderHeadings-boolean-) method to display row and column headings in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

The following example demonstrates how to convert an Excel workbook to PDF and display row and column headings in the output PDF file:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Render row and column headings.
    viewOptions.getSpreadsheetOptions().setRenderHeadings(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with row and column headings to PDF](/viewer/java/images/rendering-basics/render-spreadsheets/render-row-and-column-headings-to-pdf.png)

## Render worksheet gridlines

Use the [SpreadsheetOptions.setRenderGridLines](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setRenderGridLines-boolean-) method to display gridlines (lines that separate worksheet rows and columns) in the output file.

The following code example demonstrates how to convert an Excel workbook to PDF and display gridlines in the output PDF file:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Render gridlines.
    viewOptions.getSpreadsheetOptions().setRenderGridLines(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with gridlines to PDF](/viewer/java/images/rendering-basics/render-spreadsheets/render-excel-gridlines-to-pdf.png)

## Control cell text overflow

The [SpreadsheetOptions.setTextOverflowMode](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setTextOverflowMode-com.groupdocs.viewer.options.TextOverflowMode-) method allows you to prevent text overflow in worksheet cells (see the image below) when you convert your spreadsheet file to HTML, PDF, or image format.

![Text overflow in a cell](/viewer/java/images/rendering-basics/render-spreadsheets/excel-text-overflow.png)

You can set the [TextOverflowMode](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoverflowmode) property to one of the following values:

* [TextOverflowMode.OVERLAY_IF_NEXT_IS_EMPTY](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoverflowmode/#OVERLAY-IF-NEXT-IS-EMPTY) (default) --- Allows text to overflow into adjacent cells if these cells have no data. If adjacent cells are not empty, the overflowing text is truncated.

    ![TextOverflowMode.OVERLAY_IF_NEXT_IS_EMPTY](/viewer/java/images/rendering-basics/render-spreadsheets/text-overflow-mode-overlay-if-empty.png)

* [TextOverflowMode.OVERLAY](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoverflowmode/#OVERLAY) --- Text always overflows into adjacent cells even if these cells contain data.

    ![TextOverflowMode.OVERLAY](/viewer/java/images/rendering-basics/render-spreadsheets/text-overflow-mode-overlay.png)

* [TextOverflowMode.AUTO_FIT_COLUMN](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoverflowmode/#AUTO-FIT-COLUMN) --- Increases the column width to fit cell text.

    ![TextOverflowMode.AUTO_FIT_COLUMN](/viewer/java/images/rendering-basics/render-spreadsheets/text-overflow-mode-autofit-column.png)

* [TextOverflowMode.HIDE_TEXT](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoverflowmode/#HIDE-TEXT) --- Hides text that overflows the cell boundaries.
  
    ![TextOverflowMode.HIDE_TEXT](/viewer/java/images/rendering-basics/render-spreadsheets/text-overflow-mode-hide-text.png)

The following example demonstrates how to set this option in code:

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Specify the AutoFitColumn mode.
    viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.AUTO_FIT_COLUMN);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render hidden rows and columns

Use the [ViewOptions.getSpreadsheetOptions().setRenderHiddenRows](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setRenderHiddenRows-boolean-) and [ViewOptions.getSpreadsheetOptions().setRenderHiddenColumns](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setRenderHiddenColumns-boolean-) properties to display hidden rows and columns in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

The example below demonstrates how to set this option in code. The rows **20** and **21** and the column **E** are hidden in the source Excel workbook. 

![Hidden rows and columns in a worksheet](/viewer/java/images/rendering-basics/render-spreadsheets/excel-hidden-columns-and-rows.png)

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Enable rendering hidden rows and columns.
    viewOptions.getSpreadsheetOptions().setRenderHiddenRows(true);
    viewOptions.getSpreadsheetOptions().setRenderHiddenColumns(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. Hidden rows and columns appear in the generated PDF file.

![Hidden rows and columns in a worksheet](/viewer/java/images/rendering-basics/render-spreadsheets/render-excel-with-hidden-columns-and-rows-to-pdf.png)

## Render hidden worksheets

If your spreadsheet file contains hidden worksheets, use the [ViewOptions.setRenderHiddenPages](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderHiddenPages-boolean-) method to display data from hidden worksheets in the output HTML, PDF, or image files.

The following example demonstrates how to set this option in code:

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Enable rendering hidden pages.
    viewOptions.setRenderHiddenPages(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Skip empty rows and columns

GroupDocs.Viewer supports the [SpreadsheetOptions.setSkipEmptyRows](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setSkipEmptyRows-boolean-) and [SpreadsheetOptions.setSkipEmptyColumns](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/spreadsheetoptions/#setSkipEmptyColumns-boolean-) methods that allow you to skip blank rows and columns when you convert your spreadsheet file to HTML, PDF, or image format.

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Enable skipping blank rows and columns.
    viewOptions.getSpreadsheetOptions().setSkipEmptyRows(true);
    viewOptions.getSpreadsheetOptions().setSkipEmptyColumns(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Skip empty columns and rows](/viewer/java/images/rendering-basics/render-spreadsheets/excel-skip-empty-columns-and-rows.png)

## Render cell comments

Use the [ViewOptions.setRenderComments](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderComments-boolean-) method to display cell comments in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("invoice.xlsx")) {
    // Convert the spreadsheet to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Enable rendering comments.
    viewOptions.setRenderComments(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render cell comments](/viewer/java/images/rendering-basics/render-spreadsheets/render-excel-comments-to-png.png)

---

## Specify spreadsheet rendering options

Path: /viewer/net/specify-rendering-options/

GroupDocs.Viewer ships with the [SpreadsheetOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions) class that allows you to specify different spreadsheet rendering options (for example, you can display row and column headings in the output file, render grid lines, or adjust cell text overflow). To access these options, use the [SpreadsheetOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/spreadsheetoptions) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

## Render row and column headings

Rows and columns in a worksheet have unique names displayed on the worksheet's left and top side. Rows are numbered (1, 2, 3, ..., 1048576), and columns are lettered (A, B, C, ..., XFD).

![Row and column headings in a worksheet](/viewer/net/images/rendering-basics/render-spreadsheets/excel-row-and-column-headings.png)

Enable the [SpreadsheetOptions.RenderHeadings](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/properties/renderheadings) property to display row and column headings in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

The following example demonstrates how to convert an Excel workbook to PDF and display row and column headings in the output PDF file:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Render row and column headings.
    viewOptions.SpreadsheetOptions.RenderHeadings = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Render row and column headings.
            viewOptions.SpreadsheetOptions.RenderHeadings = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with row and column headings to PDF](/viewer/net/images/rendering-basics/render-spreadsheets/render-row-and-column-headings-to-pdf.png)

## Render worksheet gridlines

Use the [SpreadsheetOptions.RenderGridLines](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/spreadsheetoptions/properties/rendergridlines) property to display gridlines (lines that separate worksheet rows and columns) in the output file.

The following code example demonstrates how to convert an Excel workbook to PDF and display gridlines in the output PDF file:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Render grid lines.
    viewOptions.SpreadsheetOptions.RenderGridLines = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Render grid lines.
            viewOptions.SpreadsheetOptions.RenderGridLines = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with gridlines to PDF](/viewer/net/images/rendering-basics/render-spreadsheets/render-excel-gridlines-to-pdf.png)

## Control cell text overflow

The [SpreadsheetOptions.TextOverflowMode](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/properties/textoverflowmode) option allows you to prevent text overflow in worksheet cells (see the image below) when you convert your spreadsheet file to HTML, PDF, or image format.

![Text overflow in a cell](/viewer/net/images/rendering-basics/render-spreadsheets/excel-text-overflow.png)

You can set the [TextOverflowMode](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/properties/textoverflowmode) property to one of the following values:

* [TextOverflowMode.OverlayIfNextIsEmpty](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/textoverflowmode) (default) --- Allows text to overflow into adjacent cells if these cells have no data. If adjacent cells are not empty, the overflowing text is truncated.

    ![TextOverflowMode.OverlayIfNextIsEmpty](/viewer/net/images/rendering-basics/render-spreadsheets/text-overflow-mode-overlay-if-empty.png)

* [TextOverflowMode.Overlay](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/textoverflowmode) --- Text always overflows into adjacent cells even if these cells contain data.

    ![TextOverflowMode.Overlay](/viewer/net/images/rendering-basics/render-spreadsheets/text-overflow-mode-overlay.png)

* [TextOverflowMode.AutoFitColumn](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/textoverflowmode) --- Increases the column width to fit cell text.

    ![TextOverflowMode.AutoFitColum](/viewer/net/images/rendering-basics/render-spreadsheets/text-overflow-mode-autofit-column.png)

* [TextOverflowMode.HideText](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/textoverflowmode) --- Hides text that overflows the cell boundaries.
  
    ![TextOverflowMode.HideText](/viewer/net/images/rendering-basics/render-spreadsheets/text-overflow-mode-hide-text.png)

The following example demonstrates how to set this option in code:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify the AutoFitColumn mode.
    viewOptions.SpreadsheetOptions.TextOverflowMode = TextOverflowMode.AutoFitColumn;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify the AutoFitColumn mode.
            viewOptions.SpreadsheetOptions.TextOverflowMode = TextOverflowMode.AutoFitColumn
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render hidden rows and columns

Use the [ViewOptions.SpreadsheetOptions.RenderHiddenRows](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/spreadsheetoptions/properties/renderhiddenrows) and [ViewOptions.SpreadsheetOptions.RenderHiddenColumns](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/spreadsheetoptions/properties/renderhiddencolumns) properties to display hidden rows and columns in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

The example below demonstrates how to set this option in code. The rows **20** and **21** and the column **E** are hidden in the source Excel workbook. 

![Hidden rows and columns in a worksheet](/viewer/net/images/rendering-basics/render-spreadsheets/excel-hidden-columns-and-rows.png)

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable rendering hidden rows and columns.
    viewOptions.SpreadsheetOptions.RenderHiddenRows = true;
    viewOptions.SpreadsheetOptions.RenderHiddenColumns = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable rendering hidden rows and columns.
            viewOptions.SpreadsheetOptions.RenderHiddenRows = True
            viewOptions.SpreadsheetOptions.RenderHiddenColumns = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. Hidden rows and columns appear in the generated PDF file.

![Hidden rows and columns in a worksheet](/viewer/net/images/rendering-basics/render-spreadsheets/render-excel-with-hidden-columns-and-rows-to-pdf.png)

## Render hidden worksheets

If your spreadsheet file contains hidden worksheets, enable the [ViewOptions.RenderHiddenPages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/renderhiddenpages) property to display data from hidden worksheets in the output HTML, PDF, or image files.

The following example demonstrates how to set this option in code:

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable rendering hidden pages.
    viewOptions.RenderHiddenPages = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable rendering hidden pages.
            viewOptions.RenderHiddenPages = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Skip empty rows and columns

GroupDocs.Viewer supports the [SpreadsheetOptions.SkipEmptyRows](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/properties/skipemptyrows) and [SpreadsheetOptions.SkipEmptyColumns](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/spreadsheetoptions/properties/skipemptycolumns) properties that allow you to skip blank rows and columns when you convert your spreadsheet file to HTML, PDF, or image format.

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable skipping blank rows and columns.
    viewOptions.SpreadsheetOptions.SkipEmptyRows = true;
    viewOptions.SpreadsheetOptions.SkipEmptyColumns = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable skipping blank rows and columns.
            viewOptions.SpreadsheetOptions.SkipEmptyRows = True
            viewOptions.SpreadsheetOptions.SkipEmptyColumns = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Skip empty columns and rows](/viewer/net/images/rendering-basics/render-spreadsheets/excel-skip-empty-columns-and-rows.png)

## Render cell comments

Use the [ViewOptions.RenderComments](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/rendercomments) option to display cell comments in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    // Convert the spreadsheet to PNG.
    // {0} is replaced with the current page number in the file names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Enable rendering comments.
    viewOptions.RenderComments = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            ' Convert the spreadsheet to PNG.
            ' {0} is replaced with the current page number in the file names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Enable rendering comments.
            viewOptions.RenderComments = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render cell comments](/viewer/net/images/rendering-basics/render-spreadsheets/render-excel-comments-to-png.png)

## Set worksheet margins in the output pdf pages

Use the [SpreadsheetOptions.RenderGridLines](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/spreadsheetoptions/properties/rendergridlines) properties to set margins for worksheets in the output pdf. If margins are set to value less than 0 or not set then default value will be used.

The following code example demonstrates how to convert an Excel workbook to PDF and set optional margins for worksheets in the output PDF file:

{{< tabs "example8">}}
{{< tab "C#" >}}
```cs
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("invoice.xlsx"))
{
    var viewOptions = new PdfViewOptions("output.pdf");
	
    // Set margins for worksheets in the output pdf pages
    viewOptions.SpreadsheetOptions.LeftMargin = 0;
    viewOptions.SpreadsheetOptions.RightMargin = 0.5;
    viewOptions.SpreadsheetOptions.TopMargin = 1;
    viewOptions.SpreadsheetOptions.BottomMargin = -10; // set to default value
	
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("invoice.xlsx")
            Dim viewOptions = New PdfViewOptions("output.pdf")
        
            ' Set margins for worksheets in the output pdf pages
            viewOptions.SpreadsheetOptions.LeftMargin = 0
            viewOptions.SpreadsheetOptions.RightMargin = 0.5
            viewOptions.SpreadsheetOptions.TopMargin = 1
            viewOptions.SpreadsheetOptions.BottomMargin = -10 ' set to default value
        
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with worksheet margins on page to PDF](/viewer/net/images/rendering-basics/render-spreadsheets/set-worksheet-margins-in-the-output-pdf-pages.png)

---

## Specify spreadsheet rendering options

Path: /viewer/python-net/specify-rendering-options/

GroupDocs.Viewer ships with the [SpreadsheetOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions) class that allows you to specify different spreadsheet rendering options (for example, you can display row and column headings in the output file, render grid lines, or adjust cell text overflow). To access these options, use the [SpreadsheetOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties/) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

## Render row and column headings

Rows and columns in a worksheet have unique names displayed on the worksheet's left and top side. Rows are numbered (1, 2, 3, ..., 1048576), and columns are lettered (A, B, C, ..., XFD).

![Row and column headings in a worksheet](/viewer/python-net/images/rendering-basics/render-spreadsheets/excel-row-and-column-headings.png)

Enable the [SpreadsheetOptions.render_headings](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/renderheadings) property to display row and column headings in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

The following example demonstrates how to convert an Excel workbook to PDF and display row and column headings in the output PDF file:

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_headings():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_headings/headings.pdf")
        # Render row and column headings.
        viewOptions.spreadsheet_options.render_headings = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_headings()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with row and column headings to PDF](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-row-and-column-headings-to-pdf.png)

## Render worksheet gridlines

Use the [SpreadsheetOptions.render_grid_lines](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/rendergridlines) property to display gridlines (lines that separate worksheet rows and columns) in the output file.

The following code example demonstrates how to convert an Excel workbook to PDF and display gridlines in the output PDF file:

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_grid_lines():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_grid_lines/grid_lines.pdf")
        # Render grid lines.
        viewOptions.spreadsheet_options.render_grid_lines = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_grid_lines()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with gridlines to PDF](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-excel-gridlines-to-pdf.png)

## Control cell text overflow

The [SpreadsheetOptions.text_overflow_mode](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/textoverflowmode) option allows you to prevent text overflow in worksheet cells (see the image below) when you convert your spreadsheet file to HTML, PDF, or image format.

![Text overflow in a cell](/viewer/python-net/images/rendering-basics/render-spreadsheets/excel-text-overflow.png)

You can set the [text_overflow_mode](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/#properties) property to one of the following values:

* [TextOverflowMode.OVERLAY_IF_NEXT_IS_EMPTY](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/textoverflowmode) (default) --- Allows text to overflow into adjacent cells if these cells have no data. If adjacent cells are not empty, the overflowing text is truncated.

    ![TextOverflowMode.OVERLAY_IF_NEXT_IS_EMPTY](/viewer/python-net/images/rendering-basics/render-spreadsheets/text-overflow-mode-overlay-if-empty.png)

* [TextOverflowMode.OVERLAY](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/textoverflowmode) --- Text always overflows into adjacent cells even if these cells contain data.

    ![TextOverflowMode.OVERLAY](/viewer/python-net/images/rendering-basics/render-spreadsheets/text-overflow-mode-overlay.png)

* [TextOverflowMode.AUTO_FIT_COLUMN](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/textoverflowmode) --- Increases the column width to fit cell text.

    ![TextOverflowMode.AUTO_FIT_COLUMN](/viewer/python-net/images/rendering-basics/render-spreadsheets/text-overflow-mode-autofit-column.png)

* [TextOverflowMode.HIDE_TEXT](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/textoverflowmode) --- Hides text that overflows the cell boundaries.
  
    ![TextOverflowMode.HIDE_TEXT](/viewer/python-net/images/rendering-basics/render-spreadsheets/text-overflow-mode-hide-text.png)

The following example demonstrates how to set this option in code:

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, TextOverflowMode

def set_text_overflow_mode():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("set_text_overflow_mode/text_overflow_mode.pdf")
        # Specify the AUTO_FIT_COLUMN mode.
        viewOptions.spreadsheet_options.text_overflow_mode = TextOverflowMode.AUTO_FIT_COLUMN 
        viewer.view(viewOptions)

if __name__ == "__main__":
    set_text_overflow_mode()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render hidden rows and columns

Use the [ViewOptions.SpreadsheetOptions.render_hidden_rows](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/renderhiddenrows) and [ViewOptions.SpreadsheetOptions.render_hidden_columns](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/renderhiddencolumns) properties to display hidden rows and columns in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

The example below demonstrates how to set this option in code. The rows **20** and **21** and the column **E** are hidden in the source Excel workbook. 

![Hidden rows and columns in a worksheet](/viewer/python-net/images/rendering-basics/render-spreadsheets/excel-hidden-columns-and-rows.png)

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_hidden_rows_and_columns():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_hidden_rows_and_columns/hidden_rows_and_columns.pdf")
        # Enable rendering hidden rows and columns.
        viewOptions.spreadsheet_options.render_hidden_columns = True
        viewOptions.spreadsheet_options.render_hidden_rows = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_hidden_rows_and_columns()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. Hidden rows and columns appear in the generated PDF file.

![Hidden rows and columns in a worksheet](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-excel-with-hidden-columns-and-rows-to-pdf.png)

## Render hidden worksheets

If your spreadsheet file contains hidden worksheets, enable the [ViewOptions.render_hidden_pages](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/properties/renderhiddenpages) property to display data from hidden worksheets in the output HTML, PDF, or image files.

The following example demonstrates how to set this option in code:

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_hidden_pages():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("render_hidden_pages/hidden_pages.pdf")
        # Enable rendering hidden pages.
        viewOptions.render_hidden_pages = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_hidden_pages()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Skip empty rows and columns

GroupDocs.Viewer supports the [SpreadsheetOptions.skip_empty_rows](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/skipemptyrows) and [SpreadsheetOptions.skip_empty_columns](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/skipemptycolumns) properties that allow you to skip blank rows and columns when you convert your spreadsheet file to HTML, PDF, or image format.

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def skip_empty_rows_and_columns():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PDF.
        viewOptions = PdfViewOptions("skip_empty_rows_and_columns/skip_empty_rows_and_columns.pdf")
        # Enable skipping blank rows and columns.
        viewOptions.spreadsheet_options.skip_empty_columns = True
        viewOptions.spreadsheet_options.skip_empty_rows = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    skip_empty_rows_and_columns()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Skip empty columns and rows](/viewer/python-net/images/rendering-basics/render-spreadsheets/excel-skip-empty-columns-and-rows.png)

## Render cell comments

Use the [ViewOptions.render_comments](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/properties/rendercomments) option to display cell comments in the output file when you render your spreadsheet in HTML, PDF, PNG, or JPEG format.

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_comments():
    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        # Convert the spreadsheet to PNG.
        # {0} is replaced with the current page number in the file names.
        viewOptions = PngViewOptions("render_comments/comments_{0}.png")
        # Enable rendering comments.
        viewOptions.render_comments = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_comments()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render cell comments](/viewer/python-net/images/rendering-basics/render-spreadsheets/render-excel-comments-to-png.png)

## Set worksheet margins in the output pdf pages

Use the [SpreadsheetOptions.render_grid_lines](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/spreadsheetoptions/properties/rendergridlines) properties to set margins for worksheets in the output pdf. If margins are set to value less than 0 or not set then default value will be used.

The following code example demonstrates how to convert an Excel workbook to PDF and set optional margins for worksheets in the output PDF file:

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def set_worksheet_margins():

    # Load spreadsheet
    with Viewer("invoice.xlsx") as viewer:
        viewOptions = PdfViewOptions("set_worksheet_margins/worksheet_margins.pdf")

        # Set margins for worksheets in the output pdf pages
        viewOptions.spreadsheet_options.left_margin = 0.0
        viewOptions.spreadsheet_options.right_margin = 0.5
        viewOptions.spreadsheet_options.top_margin = 1.0
        viewOptions.spreadsheet_options.bottom_margin = -10.0
        viewer.view(viewOptions)

if __name__ == "__main__":
    set_worksheet_margins()
```
{{< /tab >}}
{{< tab "invoice.xlsx" >}}
{{< tab-text >}}
`invoice.xlsx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-spreadsheets/invoice.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an Excel file with worksheet margins on page to PDF](/viewer/python-net/images/rendering-basics/render-spreadsheets/set-worksheet-margins-in-the-output-pdf-pages.png)

---

## Specify the JPEG image quality

Path: /viewer/java/adjust-jpeg-images-quality/

Decreasing the JPG images quality reduces the size of the output file.

To adjust images quality, call the [setJpgQuality()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/#setJpgQuality-int-) method of the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) class. The value must be between 1 (minimum quality) and 100. The default value is 90.

To set the image quality, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) class. Specify the source document path as a constructor parameter.
1. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) object.
2. Call the [setJpgQuality()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/#setJpgQuality-int-) method.
3. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method of the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object. Specify the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) object as the parameter.

The following code snippet shows how to adjust JPG image quality in the output PDF document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    viewOptions.setJpgQuality((byte) 50);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Specify the JPEG image quality

Path: /viewer/net/adjust-jpeg-images-quality/

Decreasing the JPG images quality reduces the size of the output file.

To adjust images quality, set the [JpgQuality](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions/properties/jpgquality) property of the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) class. The value must be between 1 (minimum quality) and 100. The default value is 90.

To set the image quality, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) class. Specify the source document path as a constructor parameter.
1. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) object.
2. Set the [PdfViewOptions.JpgQuality](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions/properties/jpgquality) value.
3. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method of the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object. Specify the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) object as the parameter.

The following code snippet shows how to adjust JPG image quality in the output PDF document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create view options.
    PdfViewOptions viewOptions = new PdfViewOptions();

    // Specify the JPG image quality.
    viewOptions.PdfOptimizationOptions = new PdfOptimizationOptions();
    viewOptions.PdfOptimizationOptions.ImageQuality = 50;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create view options.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()

            ' Specify the JPG image quality.
            viewOptions.PdfOptimizationOptions = New PdfOptimizationOptions()
            viewOptions.PdfOptimizationOptions.ImageQuality = 50
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Specify the JPEG image quality

Path: /viewer/python-net/adjust-jpeg-images-quality/

Decreasing the JPG images quality reduces the size of the output file.

To adjust images quality, set the [image_quality](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) property of the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/) class. The value must be between 1 (minimum quality) and 100. The default value is 90.

To set the image quality, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class. Specify the source document path as a constructor parameter.
1. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) object.
2. Set the [PdfViewOptions.pdf_optimization_options](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/#properties) value as instantiated [PdfOptimizationOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/) object.
3. Set the [PdfViewOptions.pdf_optimization_options.image_quality](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/#properties) value.
4. Call the [view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method of the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) object. Specify the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) object as the parameter.

The following code snippet shows how to adjust JPG image quality in the output PDF document:

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def adjust_jpeg_quality():
    # Load document
    with Viewer("sample.docx") as viewer:
        # Create view options.
        viewOptions = PdfViewOptions("adjust_jpeg_quality/optimized_jpeg_quality.pdf")

        # Specify the JPG image quality.
        pdf_optimization_options = PdfOptimizationOptions()
        pdf_optimization_options.image_quality = 50
        # Specify pdf_optimization_options object
        viewOptions.pdf_optimization_options = pdf_optimization_options

        viewer.view(viewOptions)

if __name__ == "__main__":
    adjust_jpeg_quality()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/adjust-jpeg-images-quality/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Split document

Path: /merger/java/split-document/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to split source document into several resultant documents. Document splitting can be performed in different ways by specifying page numbers array or start/end page numbers and setting different [SplitOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/splitoptions/) modes.  
Here are the possible use cases:

1.  **Page numbers array** specified and splitting mode is set to [SplitMode.Pages](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/splitmode/#Pages) - specified page numbers indicate exact page numbers, which will be saved to the separate one-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 3 documents with 3rd, 6th and 8th pages.    
	
2.  **Page numbers array** specified and splitting mode is set to [SplitMode.Interval](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/splitmode/#Interval) - specified page numbers indicate the boundaries of the page intervals, which will be saved to the separate multi-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 4 page intervals 1-2, 3-5, 6-7, 8-10.  

There is also an ability to set parameter [RangeMode](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RangeMode) and obtain only even or odd pages from desired pages range.  
  
The steps to split document to multiple on-page documents are the following:

*   Initialize [SplitOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/splitoptions/) class with output files path format;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [split](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#split-com.groupdocs.merger.domain.options.interfaces.ISplitOptions-) method and pass [SplitOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/splitoptions/) object to itfor saving resultant documents.

### Split the document to several one-page documents (by exact page numbers)
The following code sample demonstrates how to split document to three one-page documents with 3rd, 6th and 8th pages:

```java
String filePath = "c:\sample.docx";
String filePathOut = "c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, new int[] { 3, 6, 8 });
Merger merger = new Merger(filePath);
merger.split(splitOptions);
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 6 |
| document_2 | 8 |

### Split the document to several one-page documents (by start/end page numbers)

The following code sample demonstrates how to split document to several one-page documents starting from 3rd and ending at 7th page number:

```java
String filePath = "c:\sample.docx";
String filePathOut = "c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, 3, 7);
Merger merger = new Merger(filePath);
merger.split(splitOptions);   
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 4 |
| document_2 | 5 |
| document_3 | 6 |
| document_4 | 7 |

### Split the document to several one-page documents (by start/end page numbers and even/odd filter)

The following code sample demonstrates how to split document to several one-page documents for odd pages starting from 3rd and ending at 7th page number:

```java
String filePath = "c:\sample.docx";
String filePathOut = "c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, 3, 7, RangeMode.OddPages);
   
Merger merger = new Merger(filePath);
merger.split(splitOptions);
```

This code snippet will produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 5 |
| document_2 | 7 |

### Split the document to several multi-page documents

The following code sample demonstrates how to split document to several multi-page documents:

```java
String filePath = "c:\sample.docx";
String filePathOut = "c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, new int[] { 3, 6, 8 }, SplitMode.Interval);

Merger merger = new Merger(filePath);
merger.split(splitOptions);
```

This code snippet will produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 1, 2 |
| document_1 | 3, 4, 5 |
| document_2 | 6, 7 |
| document_3 | 8, 9, 10 |

---

## Split document

Path: /merger/nodejs-java/split-document/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to split source document into several resultant documents. Document splitting can be performed in different ways by specifying page numbers array or start/end page numbers and setting different [SplitOptions](https://reference.groupdocs.com/merger/nodejs-java/com.groupdocs.merger.domain.options/splitoptions/) modes.  
Here are the possible use cases:

1.  **Page numbers array** specified and splitting mode is set to [SplitMode.Pages](https://reference.groupdocs.com/merger/nodejs-java/com.groupdocs.merger.domain.options/splitmode/#Pages) - specified page numbers indicate exact page numbers, which will be saved to the separate one-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 3 documents with 3rd, 6th and 8th pages.    
	
2.  **Page numbers array** specified and splitting mode is set to [SplitMode.Interval](https://reference.groupdocs.com/merger/nodejs-java/com.groupdocs.merger.domain.options/splitmode/#Interval) - specified page numbers indicate the boundaries of the page intervals, which will be saved to the separate multi-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 4 page intervals 1-2, 3-5, 6-7, 8-10.  

There is also an ability to set parameter [RangeMode](https://reference.groupdocs.com/nodejs-java/merger/com.groupdocs.merger.domain.options/RangeMode) and obtain only even or odd pages from desired pages range.  
  
The steps to split document to multiple on-page documents are the following:

*   Initialize [SplitOptions](https://reference.groupdocs.com/merger/nodejs-java/com.groupdocs.merger.domain.options/splitoptions/) class with output files path format;
*   Instantiate [Merger](https://reference.groupdocs.com/nodejs-java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [split](https://reference.groupdocs.com/merger/nodejs-java/com.groupdocs.merger/merger/#split-com.groupdocs.merger.domain.options.interfaces.ISplitOptions-) method and pass [SplitOptions](https://reference.groupdocs.com/merger/nodejs-java/com.groupdocs.merger.domain.options/splitoptions/) object to itfor saving resultant documents.

### Split the document to several one-page documents (by exact page numbers)
The following code sample demonstrates how to split document to three one-page documents with 3rd, 6th and 8th pages:

```js
const inputFilePath = `c:/sample.docx`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output\document_{0}.{1}`;
const java = require('java');
const pageArray = java.newArray('int', [3, 6, 8]);
const splitOptions = new groupdocs.merger.SplitOptions(outputPath, pageArray);
merger.split(splitOptions);
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 6 |
| document_2 | 8 |

### Split the document to several one-page documents (by start/end page numbers)

The following code sample demonstrates how to split document to several one-page documents starting from 3rd and ending at 7th page number:

```js
const inputFilePath = `c:/sample.docx`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output\document_{0}.{1}`;
const splitOptions = new groupdocs.merger.SplitOptions(outputPath, 3, 7);
merger.split(splitOptions);
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 4 |
| document_2 | 5 |
| document_3 | 6 |
| document_4 | 7 |

### Split the document to several one-page documents (by start/end page numbers and even/odd filter)

The following code sample demonstrates how to split document to several one-page documents for odd pages starting from 3rd and ending at 7th page number:

```js
const inputFilePath = `c:/sample.docx`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const rangeMode = groupdocs.merger.RangeMode.OddPages;
const splitOptions = new groupdocs.merger.SplitOptions(outputPath, 3, 7, rangeMode);
merger.split(splitOptions);
```

This code snippet will produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 5 |
| document_2 | 7 |

### Split the document to several multi-page documents

The following code sample demonstrates how to split document to several multi-page documents:

```js
const inputFilePath = `c:/sample.docx`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const java = require('java');
const pageArray = java.newArray('int', [3, 6, 8]);
const splitMode = groupdocs.merger.SplitMode.Interval;
const splitOptions = new groupdocs.merger.SplitOptions(outputPath, pageArray, splitMode);
merger.split(splitOptions);
```

This code snippet will produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 1, 2 |
| document_1 | 3, 4, 5 |
| document_2 | 6, 7 |
| document_3 | 8, 9, 10 |

---

## Split document

Path: /merger/python-net/split-document/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to split source document into several resultant documents. Document splitting can be performed in different ways by specifying page numbers array or start/end page numbers and setting different [SplitOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/splitoptions/) modes.  
Here are the possible use cases:

1.  **Page numbers array** specified and splitting mode is set to [SplitMode.Pages](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitmode/) - specified page numbers indicate exact page numbers, which will be saved to the separate one-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 3 documents with 3rd, 6th and 8th pages.    
	
2.  **Page numbers array** specified and splitting mode is set to [SplitMode.Interval](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitmode/) - specified page numbers indicate the boundaries of the page intervals, which will be saved to the separate multi-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 4 page intervals 1-2, 3-5, 6-7, 8-10.  

There is also an ability to set parameter [RangeMode](https://reference.groupdocs.com/python-net/merger/groupdocs.merger.domain.options/RangeMode) and obtain only even or odd pages from desired pages range.  
  
The steps to split document to multiple on-page documents are the following:

*   Initialize [SplitOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/splitoptions/) class with output files path format;
*   Instantiate [Merger](https://reference.groupdocs.com/python-net/merger/groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [split](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitoptions/) method and pass [SplitOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/splitoptions/) object to itfor saving resultant documents.

### Split the document to several one-page documents (by exact page numbers)
The following code sample demonstrates how to split document to three one-page documents with 3rd, 6th and 8th pages:

```python
with gm.Merger("c:/sample.docx") as merger:
    output_path = "c:/output/document_{0}.{1}"
    split_options = gm.domain.options.SplitOptions(output_path, [3, 6, 8])
    merger.split(split_options)
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 6 |
| document_2 | 8 |

### Split the document to several one-page documents (by start/end page numbers)

The following code sample demonstrates how to split document to several one-page documents starting from 3rd and ending at 7th page number:

```python
with gm.Merger("c:/sample.docx") as merger:
    output_path = "c:/output/document_{0}.{1}"
    split_options = gm.domain.options.SplitOptions(output_path, 3, 7)
    merger.split(split_options)
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 4 |
| document_2 | 5 |
| document_3 | 6 |
| document_4 | 7 |

### Split the document to several one-page documents (by start/end page numbers and even/odd filter)

The following code sample demonstrates how to split document to several one-page documents for odd pages starting from 3rd and ending at 7th page number:

```python
with gm.Merger("c:/sample.docx") as merger:
    output_path = "c:/output/document_{0}.{1}"
    range_mode = gm.domain.options.RangeMode.ODDPAGES;
    split_options = gm.domain.options.SplitOptions(output_path, 3, 7, range_mode)
    merger.split(split_options)
```

This code snippet will produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 3 |
| document_1 | 5 |
| document_2 | 7 |

### Split the document to several multi-page documents

The following code sample demonstrates how to split document to several multi-page documents:

```python
with gm.Merger("c:/sample.docx") as merger:
    output_path = "c:/output/document_{0}.{1}"
    split_mode = gm.domain.options.SplitMode.INTERVAL;
    split_options = gm.domain.options.SplitOptions(output_path, [3, 6, 8], split_mode)
    merger.split(split_options)
```

This code snippet will produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 1, 2 |
| document_1 | 3, 4, 5 |
| document_2 | 6, 7 |
| document_3 | 8, 9, 10 |

---

## Supported Archive Types

Path: /merger/java/supported-archive-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Cross-format archive merging |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [ZIP](https://docs.fileformat.com/compression/zip/) | ZIP Archive File | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [TAR](https://docs.fileformat.com/compression/tar/) | TAR Archive File | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [7Z](https://docs.fileformat.com/compression/7z/) | 7Z Archive File | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
---

## Supported Archive Types

Path: /merger/net/supported-archive-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Cross-format archive merging |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [ZIP](https://docs.fileformat.com/compression/zip/) | ZIP Archive File | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [TAR](https://docs.fileformat.com/compression/tar/) | TAR Archive File | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [RAR](https://docs.fileformat.com/compression/rar/) | RAR Archive File |   |   | ![(tick)](/merger/net/images/check.png) |
| [7Z](https://docs.fileformat.com/compression/7z/) | 7Z Archive File | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [GZ](https://docs.fileformat.com/compression/gz/) | GZ Archive File |   |   |   |
| [BZ2](https://docs.fileformat.com/compression/bz2/) | BZ2 Archive File |   |   |   |

---

## Supported Document Formats

Path: /assembly/java/supported-document-formats/

## Supported File Formats

The following table indicates the input and output file formats supported by GroupDocs.Assembly for Java.

| Format | Description | Load | Save | Populate | Remarks |
| --- | --- | --- | --- | --- | --- |
| [DOC](https://wiki.fileformat.com/word-processing/doc) | Microsoft Word 97 - 2007 Document. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [DOT](https://wiki.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [DOCX](https://wiki.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [DOCM](https://wiki.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [DOTX](https://wiki.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [DOTM](https://wiki.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [RTF](https://wiki.fileformat.com/word-processing/rtf/) | RTF format. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XLSX](https://wiki.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XLSM](https://wiki.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XLTX](https://wiki.fileformat.com/spreadsheet/xltx/) | OOXML Workbook Template | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XLTM](https://wiki.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XLSB](https://wiki.fileformat.com/spreadsheet/xlsb/) | OOXML Binary Workbook | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XLS](https://wiki.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XLT](https://wiki.fileformat.com/spreadsheet/xlt/) | Excel Workbook Template 97-2003 | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XML](https://wiki.fileformat.com/web/xml/) | Spreadsheet Markup Language | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [ODS](https://wiki.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [POTX](https://wiki.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [POTM](https://wiki.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PPS](https://wiki.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [ODP](https://wiki.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [EML](https://wiki.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [MSG](https://wiki.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [EMLX](https://wiki.fileformat.com/email/emlx/) | Apple's Email Message Format | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [TXT](https://wiki.fileformat.com/word-processing/txt/) | Plain Text | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XML](https://wiki.fileformat.com/web/xml) |  Word Processing Markup Language | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [HTML](https://wiki.fileformat.com/web/html/) | HTML format. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [ODT](https://wiki.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [OTT](https://wiki.fileformat.com/word-processing/ott/) | ODF Text Document Template. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PDF](https://wiki.fileformat.com/view/pdf/) | Saves the document as PDF (Adobe Portable Document) format. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XPS](https://wiki.fileformat.com/page-description-language/xps/) | Saves the document in the XPS (XML Paper Specification) format. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [EPUB](https://wiki.fileformat.com/ebook/epub/) | Saves the document in the IDPF EPUB format. | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [MHTML](https://wiki.fileformat.com/web/mhtml/) | Mime HTML (MHTML) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [TIFF](https://wiki.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [XAML](https://wiki.fileformat.com/web/xaml/) | XML Based Markup Language | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| OXPS | OpenXPS File | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [SVG](https://wiki.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics (SVG) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PS](https://wiki.fileformat.com/page-description-language/ps/) | PostScript (PS) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [PCL](https://wiki.fileformat.com/page-description-language/pcl/) | Printer Command Language (PCL) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [MD](https://wiki.fileformat.com/word-processing/md/) | Markdown Documentation File | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [POT](https://wiki.fileformat.com/presentation/pot/) | PowerPoint template files created by PowerPoint 97-2003 versions | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |
| [OTP](https://wiki.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) | ![(tick)](/assembly/java/images/check.png) |   |


{{< alert style="tip" >}}

**Can’t find your file format?**
We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/assembly/15), and our team will assist you.

{{< /alert >}}

### Supported Features Detail for Email File Formats

The following table provides information on those GroupDocs.Assembly features that are partially supported or not supported at all for email file formats.  

| Feature | MSG with RTF Body | MSG, EML, MHTML with HTML Body Created Using Microsoft Outlook or Microsoft Word | MSG, EML, EMLX, MHTML with HTML Body Created Outside Microsoft Outlook or Microsoft Word | MSG, EML, EMLX, MHTML with Plain Text Body |
| --- | --- | --- | --- | --- |
| Building Charts Dynamically | Supported (outside loops and conditions) | Supported (outside loops and conditions) | Not supported | Not supported |
| Inserting Documents Dynamically | Supported | Supported | To be supported | Not supported |
| Inserting Images Dynamically | Supported | Supported | Supported | Not supported |
| Inserting Barcodes Dynamically | Supported | Supported | To be supported | Not supported |

### Supported Output File Formats Depending on Input File Formats

The following table shows which output file formats are supported by GroupDocs.Assembly depending on input file formats:

| Input File Formats (from left to right) and Output File Formats (top down) | Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT) | Spreadsheet (XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS) | Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP) | Email (EML, EMLX, MSG) | HTML, Markdown, and Plain Text |
| --- | --- | --- | --- | --- | --- |
| **Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT)** | Supported | Not Supported | Not Supported | Supported | Supported |
| **Spreadsheet (XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS)** | Not Supported | Supported | Not Supported | Not Supported | Not Supported |
| **Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, **POT,** POTX, POTM, ODP, OTP)** | Not Supported | Not Supported | Supported | Not Supported | Not Supported |
| **Email (EML, EMLX, MSG)** | Not Supported | Not Supported | Not Supported | Supported | Not Supported |
| **HTML, PDF, XPS, TIFF** | Supported | Supported | Supported | Supported | Supported |
| **MHTML** | Supported | Supported | Not Supported | Supported | Supported |
| **Markdown, Plain Text, XAML, OpenXPS, EPUB, SVG, PS, PCL** | Supported | Not Supported | Not Supported | Supported | Supported |

---

## Supported Document Formats

Path: /assembly/net/supported-document-formats/

## Supported File Formats

The following table indicates the input and output file formats supported by GroupDocs.Assembly for .NET.

| Format | Description | Load | Save | Populate | Remarks |
| --- | --- | --- | --- | --- | --- |
| [DOC](https://wiki.fileformat.com/word-processing/doc) | Microsoft Word 97 - 2007 Document. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [DOT](https://wiki.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [DOCX](https://wiki.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [DOCM](https://wiki.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [DOTX](https://wiki.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [DOTM](https://wiki.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [RTF](https://wiki.fileformat.com/word-processing/rtf/) | RTF format. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XLSX](https://wiki.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XLSM](https://wiki.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XLTX](https://wiki.fileformat.com/spreadsheet/xltx/) | OOXML Workbook Template | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XLTM](https://wiki.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XLSB](https://wiki.fileformat.com/spreadsheet/xlsb/) | OOXML Binary Workbook | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XLS](https://wiki.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XLT](https://wiki.fileformat.com/spreadsheet/xlt/) | Excel Workbook Template 97-2003 | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XML](https://wiki.fileformat.com/web/xml/) | Spreadsheet Markup Language | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [ODS](https://wiki.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [POTX](https://wiki.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [POTM](https://wiki.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PPS](https://wiki.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [ODP](https://wiki.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [EML](https://wiki.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [MSG](https://wiki.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [EMLX](https://wiki.fileformat.com/email/emlx/) | Apple's Email Message Format | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [TXT](https://wiki.fileformat.com/word-processing/txt/) | Plain Text | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XML](https://wiki.fileformat.com/web/xml) |  Word Processing Markup Language | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [HTML](https://wiki.fileformat.com/web/html/) | HTML format. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [ODT](https://wiki.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [OTT](https://wiki.fileformat.com/word-processing/ott/) | ODF Text Document Template. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PDF](https://wiki.fileformat.com/view/pdf/) | Saves the document as PDF (Adobe Portable Document) format. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XPS](https://wiki.fileformat.com/page-description-language/xps/) | Saves the document in the XPS (XML Paper Specification) format. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [EPUB](https://wiki.fileformat.com/ebook/epub/) | Saves the document in the IDPF EPUB format. | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [MHTML](https://wiki.fileformat.com/web/mhtml/) | Mime HTML (MHTML) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [TIFF](https://wiki.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [XAML](https://wiki.fileformat.com/web/xaml/) | XML Based Markup Language | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| OXPS | OpenXPS File | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [SVG](https://wiki.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics (SVG) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PS](https://wiki.fileformat.com/page-description-language/ps/) | PostScript (PS) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [PCL](https://wiki.fileformat.com/page-description-language/pcl/) | Printer Command Language (PCL) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [MD](https://wiki.fileformat.com/word-processing/md/) | Markdown Documentation File | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [POT](https://wiki.fileformat.com/presentation/pot/) | PowerPoint template files created by PowerPoint 97-2003 versions | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |
| [OTP](https://wiki.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) | ![(tick)](/assembly/net/images/check.png) |   |


{{< alert style="tip" >}}

**Can’t find your file format?**
We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/assembly/15), and our team will assist you.

{{< /alert >}}

## Supported Features Detail for Email File Formats

The following table provides information on those GroupDocs.Assembly features that are partially supported or not supported at all for email file formats.  

| Feature | MSG with RTF Body | MSG, EML, MHTML with HTML Body Created Using Microsoft Outlook or Microsoft Word | MSG, EML, EMLX, MHTML with HTML Body Created Outside Microsoft Outlook or Microsoft Word | MSG, EML, EMLX, MHTML with Plain Text Body |
| --- | --- | --- | --- | --- |
| Building Charts Dynamically | Supported (outside loops and conditions) | Supported (outside loops and conditions) | Not supported | Not supported |
| Inserting Documents Dynamically | Supported | Supported | To be supported | Not supported |
| Inserting Images Dynamically | Supported | Supported | Supported | Not supported |
| Inserting Barcodes Dynamically | Supported | Supported | To be supported | Not supported |

## Supported Output File Formats Depending on Input File Formats

The following table shows which output file formats are supported by GroupDocs.Assembly depending on input file formats:

| Input File Formats (from left to right) and Output File Formats (top down) | Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT) | Spreadsheet (XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS) | Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP) | Email (EML, EMLX, MSG) | HTML, Markdown, and Plain Text |
| --- | --- | --- | --- | --- | --- |
| **Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT)** | Supported | Not Supported | Not Supported | Supported | Supported |
| **Spreadsheet (XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS)** | Not Supported | Supported | Not Supported | Not Supported | Not Supported |
| **Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP)** | Not Supported | Not Supported | Supported | Not Supported | Not Supported |
| **Email (EML, EMLX, MSG)** | Not Supported | Not Supported | Not Supported | Supported | Not Supported |
| **HTML, PDF, XPS, TIFF** | Supported | Supported | Supported | Supported | Supported |
| **MHTML** | Supported | Supported | Not Supported | Supported | Supported |
| **Markdown, Plain Text, XAML, OpenXPS, EPUB, SVG, PS, PCL** | Supported | Not Supported | Not Supported | Supported | Supported |


---

## Supported Document Formats

Path: /assembly/python-net/supported-document-formats/

## Supported File Formats

The following table indicates the input and output file formats supported by GroupDocs.Assembly for Python via .NET.

| Format | Description | Load | Save | Populate | Remarks |
| --- | --- | --- | --- | --- | --- |
| [DOC](https://wiki.fileformat.com/word-processing/doc) | Microsoft Word 97 - 2007 Document. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [DOT](https://wiki.fileformat.com/word-processing/dot/) | Microsoft Word 97 - 2007 Template. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [DOCX](https://wiki.fileformat.com/word-processing/docx/) | Office Open XML WordprocessingML Document (macro-free). | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [DOCM](https://wiki.fileformat.com/word-processing/docm/) | Office Open XML WordprocessingML Macro-Enabled Document. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [DOTX](https://wiki.fileformat.com/word-processing/dotx/) | Office Open XML WordprocessingML Template (macro-free). | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [DOTM](https://wiki.fileformat.com/word-processing/dotm/) | Office Open XML WordprocessingML Macro-Enabled Template. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [RTF](https://wiki.fileformat.com/word-processing/rtf/) | RTF format. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XLSX](https://wiki.fileformat.com/spreadsheet/xlsx/) | OOXML 2007-2010 | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XLSM](https://wiki.fileformat.com/spreadsheet/xlsm/) | OOXML Macro Enabled Workbook | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XLTX](https://wiki.fileformat.com/spreadsheet/xltx/) | OOXML Workbook Template | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XLTM](https://wiki.fileformat.com/spreadsheet/xltm/) | OOXML Macro Enabled Workbook Template | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XLSB](https://wiki.fileformat.com/spreadsheet/xlsb/) | OOXML Binary Workbook | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XLS](https://wiki.fileformat.com/spreadsheet/xls/) | Excel Workbook 97-2003 | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XLT](https://wiki.fileformat.com/spreadsheet/xlt/) | Excel Workbook Template 97-2003 | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XML](https://wiki.fileformat.com/web/xml/) | Spreadsheet Markup Language | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [ODS](https://wiki.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) | OOXML Presentation | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | OOXML Macro Enabled Presentation | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) | OOXML SlideShow | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) | OOXML Macros Enabled Presentation | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [POTX](https://wiki.fileformat.com/presentation/potx/) | OOXML Presentation Template | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [POTM](https://wiki.fileformat.com/presentation/potm/) | OOXML Macro Enabled Presentation Template | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | PowerPoint Presentation 97-2003 | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PPS](https://wiki.fileformat.com/presentation/pps/) | PowerPoint SlideShow 97-2003 | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [ODP](https://wiki.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [EML](https://wiki.fileformat.com/email/eml/) | Email Message Format | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [MSG](https://wiki.fileformat.com/email/msg/) | Outlook Email Message Format | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [EMLX](https://wiki.fileformat.com/email/emlx/) | Apple's Email Message Format | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [TXT](https://wiki.fileformat.com/word-processing/txt/) | Plain Text | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XML](https://wiki.fileformat.com/web/xml) |  Word Processing Markup Language | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [HTML](https://wiki.fileformat.com/web/html/) | HTML format. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [ODT](https://wiki.fileformat.com/word-processing/odt/) | ODF Text Document. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [OTT](https://wiki.fileformat.com/word-processing/ott/) | ODF Text Document Template. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PDF](https://wiki.fileformat.com/view/pdf/) | Saves the document as PDF (Adobe Portable Document) format. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XPS](https://wiki.fileformat.com/page-description-language/xps/) | Saves the document in the XPS (XML Paper Specification) format. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [EPUB](https://wiki.fileformat.com/ebook/epub/) | Saves the document in the IDPF EPUB format. | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [MHTML](https://wiki.fileformat.com/web/mhtml/) | Mime HTML (MHTML) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [TIFF](https://wiki.fileformat.com/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [XAML](https://wiki.fileformat.com/web/xaml/) | XML Based Markup Language | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| OXPS | OpenXPS File | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [SVG](https://wiki.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics (SVG) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PS](https://wiki.fileformat.com/page-description-language/ps/) | PostScript (PS) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [PCL](https://wiki.fileformat.com/page-description-language/pcl/) | Printer Command Language (PCL) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [MD](https://wiki.fileformat.com/word-processing/md/) | Markdown Documentation File | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [POT](https://wiki.fileformat.com/presentation/pot/) | PowerPoint template files created by PowerPoint 97-2003 versions | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |
| [OTP](https://wiki.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) | ![(tick)](/assembly/python-net/images/check.png) |   |


{{< alert style="tip" >}}

**Can’t find your file format?**
We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/assembly/15), and our team will assist you.

{{< /alert >}}

## Supported Features Detail for Email File Formats

The following table provides information on those GroupDocs.Assembly features that are partially supported or not supported at all for email file formats.  

| Feature | MSG with RTF Body | MSG, EML, MHTML with HTML Body Created Using Microsoft Outlook or Microsoft Word | MSG, EML, EMLX, MHTML with HTML Body Created Outside Microsoft Outlook or Microsoft Word | MSG, EML, EMLX, MHTML with Plain Text Body |
| --- | --- | --- | --- | --- |
| Building Charts Dynamically | Supported (outside loops and conditions) | Supported (outside loops and conditions) | Not supported | Not supported |
| Inserting Documents Dynamically | Supported | Supported | To be supported | Not supported |
| Inserting Images Dynamically | Supported | Supported | Supported | Not supported |
| Inserting Barcodes Dynamically | Supported | Supported | To be supported | Not supported |

## Supported Output File Formats Depending on Input File Formats

The following table shows which output file formats are supported by GroupDocs.Assembly depending on input file formats:

| Input File Formats (from left to right) and Output File Formats (top down) | Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT) | Spreadsheet (XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS) | Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP) | Email (EML, EMLX, MSG) | HTML, Markdown, and Plain Text |
| --- | --- | --- | --- | --- | --- |
| **Word Processing (DOC, DOCX, DOCM, DOT, DOTX, DOTM, WordprocessingML, RTF, ODT, OTT)** | Supported | Not Supported | Not Supported | Supported | Supported |
| **Spreadsheet (XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, SpreadsheetML, ODS)** | Not Supported | Supported | Not Supported | Not Supported | Not Supported |
| **Presentation (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP)** | Not Supported | Not Supported | Supported | Not Supported | Not Supported |
| **Email (EML, EMLX, MSG)** | Not Supported | Not Supported | Not Supported | Supported | Not Supported |
| **HTML, PDF, XPS, TIFF** | Supported | Supported | Supported | Supported | Supported |
| **MHTML** | Supported | Supported | Not Supported | Supported | Supported |
| **Markdown, Plain Text, XAML, OpenXPS, EPUB, SVG, PS, PCL** | Supported | Not Supported | Not Supported | Supported | Supported |


---

## Supported Document Formats

Path: /classification/net/supported-document-formats/


The following table indicates the file formats that GroupDocs.Classification for .NET can process.

| Format | Description |
| --- | --- |
| [PDF](https://wiki.fileformat.com/pdf/) | Adobe Portable Document Format (PDF) |
| [DOC](https://wiki.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document |
| [DOCM](https://wiki.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document |
| [DOCX](https://wiki.fileformat.com/word-processing/docx/) | Microsoft Word Document |
| [DOT](https://wiki.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template |
| [DOTM](https://wiki.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template |
| [DOTX](https://wiki.fileformat.com/word-processing/dotx/) | Microsoft Word Template |
| [ODT](https://wiki.fileformat.com/word-processing/odt/) | OpenDocument Text |
| [OTT](https://wiki.fileformat.com/word-processing/ott/) | Open Document Text Template |
| [RTF](https://wiki.fileformat.com/word-processing/rtf/) | Rich Text Document |
| [TXT](https://wiki.fileformat.com/word-processing/txt/) | Plain Text Document |


{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/classification/34), and our team will assist you.

{{< /alert >}}
---

## Supported Document Formats

Path: /search/java/supported-document-formats/

The following table contains file formats supported by GroupDocs.Search for Java. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/search/16">}}

## Word Processing

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | Content and metadata |   | Microsoft Word 97+ |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word Document Template | Content and metadata |   | Microsoft Word 97+ |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML Document | Content and metadata |   |   |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML Document \[Macro-enabled\] | Content and metadata |   |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML Document Template | Content and metadata |   |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML Document Template \[Macro-enabled\] | Content and metadata |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain text | Content and metadata |   |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | Open Document Text | Content and metadata |   |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | Open Document Text Template | Content and metadata |   |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format | Content and metadata | 1.9 |  |

## PDF

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Portable Document Format File | Content and metadata |   |   |

## Markup

| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File | Content and metadata |   |   |
| [XHTML](https://docs.fileformat.com/web/xhtml/) | Extensible Hypertext Markup Language File | Content and metadata |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML File | Content and metadata |   | Not supported by .NET Core version in Linux |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown | Content and metadata |   |   |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | Content and metadata |   |   |


## Ebooks

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help File | Content and metadata | 1.4 |   |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File | Content and metadata | 2.0, 3.0, 3.1 |   |
| [FB2](https://docs.fileformat.com/ebook/fb2/) | FictionBook 2.0 File | Content and metadata | 2.0 |   |

## Speadsheet

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel Spreadsheet | Content and metadata |   | Microsoft Excel 97+ |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/)| Microsoft Excel Spreadsheet Template | Content and metadata |   | Microsoft Excel 97+ |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Office Open XML Spreadsheet | Content and metadata |   |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Office Open XML Spreadsheet \[Macro-enabled\] | Content and metadata |   |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Office Open XML Spreadsheet \[Binary\] | Content and metadata |   |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Office Open XML Spreadsheet Template | Content and metadata |   |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Office Open XML Spreadsheet Template \[Macro-enabled\] | Content and metadata |   |   |
| [XLA](https://docs.fileformat.com/spreadsheet/xla/) | Microsoft Excel 97-2003 Add-In | Content and metadata |   |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Open XML Add-In | Content and metadata |   |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | Content and metadata |   |   |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | Open Document Spreadsheet Template | Content and metadata |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values | Content and metadata |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values | Content and metadata |   |   |
| XML | SpreadsheetML | Content and metadata |   |   |

## Presentations

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation | Content and metadata |   | Microsoft PowerPoint 97+ |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint Slideshow | Content and metadata |   | Microsoft PowerPoint 97+ |
| [POT](https://docs.fileformat.com/presentation/pot/) | PowerPoint Template | Content and metadata |   | Microsoft PowerPoint 97+ |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Office Open XML Presentation | Content and metadata |   |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Office Open XML Presentation \[Macro-enabled\] | Content and metadata |   |   |
| [POTX](https://docs.fileformat.com/presentation/potx/)  | Office Open XML Presentation Template | Content and metadata |   |   |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Office Open XML Presentation Template \[Macro-enabled\] | Content and metadata |   |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Office Open XML Presentation Slideshow | Content and metadata |   |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Office Open XML Presentation Slideshow \[Macro-enabled\] | Content and metadata |   |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | Open Document Presentation | Content and metadata |   |   |

## Emails

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PST](https://docs.fileformat.com/email/pst/) | Outlook Personal Information Store File | Content and metadata |   |   |
| [OST](https://docs.fileformat.com/email/ost/) | Outlook Offline Data File | Content and metadata |   |   |
| [EML](https://docs.fileformat.com/email/eml/) | E-Mail Message | Content and metadata |   |   |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | Content and metadata |   |   |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Mail Message | Content and metadata |   |   |

## Notes

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [OneNote](https://docs.fileformat.com/note-taking/one/) | OneNote Document | Content and metadata | Local files of Microsoft OneNote 2010-2016 | Not supported by .NET Core version in Linux |

## Archives

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [ZIP](https://docs.fileformat.com/compression/zip/) | Zipped File | Content and metadata |   |   |

## Audio

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MPEG-2 Audio Layer III | Metadata only |   |   |
| [WAV](https://docs.fileformat.com/audio/wav/) | Waveform Audio File Format | Metadata only |   |   |

## Image

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture | Content and metadata |   |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format File | Content and metadata |   |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG 2000 Core Image File | Content and metadata |   |   |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | Content and metadata |   |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image Format File | Content and metadata |   |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | Content and metadata |   |   |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile | Content and metadata |   |   |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile | Content and metadata |   |   |
| [JPG](https://docs.fileformat.com/image/jpeg/) | JPEG Image | Content and metadata |   |   |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document | Content and metadata |   |   |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | Content and metadata |   |   |

## Project Management

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project File | Metadata only |   |   |

## Torrent

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [TORRENT](https://docs.fileformat.com/misc/torrent/) | BitTorrent File | Metadata only |   |   |


## Diagram

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio Drawing File | Metadata only |   |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio Stencil File | Metadata only |   |   |

## Medicine

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM Image | Metadata only |   |   |
| [DICOM](https://docs.fileformat.com/image/dcm/) | DICOM Image | Metadata only |   |   |


## Video

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [AVI](https://docs.fileformat.com/video/avi/) | Audio Video Interleave File | Metadata only |   |   |
| [MOV](https://docs.fileformat.com/video/mov/) | Apple QuickTime Movie | Metadata only |   |   |
| [QT](https://docs.fileformat.com/video/qt/) | Apple QuickTime Movie | Metadata only |   |   |
| [FLV](https://docs.fileformat.com/video/flv/) | Animate Video File | Metadata only |   |   |
| [ASF](https://docs.fileformat.com/video/wmv/) | Advanced Systems Format File | Metadata only |   |   |

---

## Supported Document Formats

Path: /search/net/supported-document-formats/

The following table contains file formats supported by GroupDocs.Search for .NET. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/search/16">}}

## Word Processing

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | Content and metadata |   | Microsoft Word 97+ |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word Document Template | Content and metadata |   | Microsoft Word 97+ |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML Document | Content and metadata |   |   |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML Document \[Macro-enabled\] | Content and metadata |   |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML Document Template | Content and metadata |   |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML Document Template \[Macro-enabled\] | Content and metadata |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain text | Content and metadata |   |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | Open Document Text | Content and metadata |   |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | Open Document Text Template | Content and metadata |   |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format | Content and metadata | 1.9 |  |

## PDF

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Portable Document Format File | Content and metadata |   |   |

## Markup

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File | Content and metadata |   |   |
| [XHTML](https://docs.fileformat.com/web/xhtml/) | Extensible Hypertext Markup Language File | Content and metadata |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML File | Content and metadata |   | Not supported by .NET Core version in Linux |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown | Content and metadata |   |   |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | Content and metadata |   |   |

## Ebooks

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help File | Content and metadata | 1.4 |   |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File | Content and metadata | 2.0, 3.0, 3.1 |   |
| [FB2](https://docs.fileformat.com/ebook/fb2/) | FictionBook 2.0 File | Content and metadata | 2.0 |   |

## Speadsheet

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel Spreadsheet | Content and metadata |   | Microsoft Excel 97+ |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/)| Microsoft Excel Spreadsheet Template | Content and metadata |   | Microsoft Excel 97+ |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Office Open XML Spreadsheet | Content and metadata |   |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Office Open XML Spreadsheet \[Macro-enabled\] | Content and metadata |   |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Office Open XML Spreadsheet \[Binary\] | Content and metadata |   |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Office Open XML Spreadsheet Template | Content and metadata |   |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Office Open XML Spreadsheet Template \[Macro-enabled\] | Content and metadata |   |   |
| [XLA](https://docs.fileformat.com/spreadsheet/xla/) | Microsoft Excel 97-2003 Add-In | Content and metadata |   |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Open XML Add-In | Content and metadata |   |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | Content and metadata |   |   |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | Open Document Spreadsheet Template | Content and metadata |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values | Content and metadata |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values | Content and metadata |   |   |
| XML | SpreadsheetML | Content and metadata |   |   |

## Presentations

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation | Content and metadata |   | Microsoft PowerPoint 97+ |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint Slideshow | Content and metadata |   | Microsoft PowerPoint 97+ |
| [POT](https://docs.fileformat.com/presentation/pot/) | PowerPoint Template | Content and metadata |   | Microsoft PowerPoint 97+ |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Office Open XML Presentation | Content and metadata |   |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Office Open XML Presentation \[Macro-enabled\] | Content and metadata |   |   |
| [POTX](https://docs.fileformat.com/presentation/potx/)  | Office Open XML Presentation Template | Content and metadata |   |   |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Office Open XML Presentation Template \[Macro-enabled\] | Content and metadata |   |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Office Open XML Presentation Slideshow | Content and metadata |   |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Office Open XML Presentation Slideshow \[Macro-enabled\] | Content and metadata |   |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | Open Document Presentation | Content and metadata |   |   |

## Emails

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PST](https://docs.fileformat.com/email/pst/) | Outlook Personal Information Store File | Content and metadata |   |   |
| [OST](https://docs.fileformat.com/email/ost/) | Outlook Offline Data File | Content and metadata |   |   |
| [EML](https://docs.fileformat.com/email/eml/) | E-Mail Message | Content and metadata |   |   |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | Content and metadata |   |   |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Mail Message | Content and metadata |   |   |

## Notes

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [OneNote](https://docs.fileformat.com/note-taking/one/) | OneNote Document | Content and metadata | Local files of Microsoft OneNote 2010-2016 | Not supported by .NET Core version in Linux |

## Archives

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [ZIP](https://docs.fileformat.com/compression/zip/) | Zipped File | Content and metadata |   |   |

## Audio

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MPEG-2 Audio Layer III | Metadata only |   |   |
| [WAV](https://docs.fileformat.com/audio/wav/) | Waveform Audio File Format | Metadata only |   |   |

## Image

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture | Content and metadata |   |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format File | Content and metadata |   |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG 2000 Core Image File | Content and metadata |   |   |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | Content and metadata |   |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image Format File | Content and metadata |   |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | Content and metadata |   |   |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile | Content and metadata |   |   |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile | Content and metadata |   |   |
| [JPG](https://docs.fileformat.com/image/jpeg/) | JPEG Image | Content and metadata |   |   |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document | Content and metadata |   |   |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | Content and metadata |   |   |

## Project Management

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project File | Metadata only |   |   |

## Torrent

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [TORRENT](https://docs.fileformat.com/misc/torrent/) | BitTorrent File | Metadata only |   |   |

## Diagram

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio Drawing File | Metadata only |   |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio Stencil File | Metadata only |   |   |

## Medicine

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM Image | Metadata only |   |   |
| [DICOM](https://docs.fileformat.com/image/dcm/) | DICOM Image | Metadata only |   |   |

## Video

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [AVI](https://docs.fileformat.com/video/avi/) | Audio Video Interleave File | Metadata only |   |   |
| [MOV](https://docs.fileformat.com/video/mov/) | Apple QuickTime Movie | Metadata only |   |   |
| [QT](https://docs.fileformat.com/video/qt/) | Apple QuickTime Movie | Metadata only |   |   |
| [FLV](https://docs.fileformat.com/video/flv/) | Animate Video File | Metadata only |   |   |
| [ASF](https://docs.fileformat.com/video/wmv/) | Advanced Systems Format File | Metadata only |   |   |

---

## Supported Document Formats

Path: /search/nodejs-java/supported-document-formats/

The following table contains file formats supported by GroupDocs.Search for Node.js via Java. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/search/16">}}

## Word Processing

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | Content and metadata |   | Microsoft Word 97+ |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word Document Template | Content and metadata |   | Microsoft Word 97+ |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Office Open XML Document | Content and metadata |   |   |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Office Open XML Document \[Macro-enabled\] | Content and metadata |   |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Office Open XML Document Template | Content and metadata |   |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Office Open XML Document Template \[Macro-enabled\] | Content and metadata |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain text | Content and metadata |   |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | Open Document Text | Content and metadata |   |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | Open Document Text Template | Content and metadata |   |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format | Content and metadata | 1.9 |  |

## PDF
| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PDF](https://docs.fileformat.com/pdf/) | Portable Document Format File | Content and metadata |   |   |

## Markup

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File | Content and metadata |   |   |
| [XHTML](https://docs.fileformat.com/web/xhtml/) | Extensible Hypertext Markup Language File | Content and metadata |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML File | Content and metadata |   | Not supported by .NET Core version in Linux |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown | Content and metadata |   |   |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | Content and metadata |   |   |

## Ebooks

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help File | Content and metadata | 1.4 |   |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File | Content and metadata | 2.0, 3.0, 3.1 |   |
| [FB2](https://docs.fileformat.com/ebook/fb2/) | FictionBook 2.0 File | Content and metadata | 2.0 |   |

## Speadsheet

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel Spreadsheet | Content and metadata |   | Microsoft Excel 97+ |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/)| Microsoft Excel Spreadsheet Template | Content and metadata |   | Microsoft Excel 97+ |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Office Open XML Spreadsheet | Content and metadata |   |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Office Open XML Spreadsheet \[Macro-enabled\] | Content and metadata |   |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Office Open XML Spreadsheet \[Binary\] | Content and metadata |   |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Office Open XML Spreadsheet Template | Content and metadata |   |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Office Open XML Spreadsheet Template \[Macro-enabled\] | Content and metadata |   |   |
| [XLA](https://docs.fileformat.com/spreadsheet/xla/) | Microsoft Excel 97-2003 Add-In | Content and metadata |   |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Open XML Add-In | Content and metadata |   |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | Open Document Spreadsheet | Content and metadata |   |   |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | Open Document Spreadsheet Template | Content and metadata |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values | Content and metadata |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values | Content and metadata |   |   |
| XML | SpreadsheetML | Content and metadata |   |   |

## Presentations

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | PowerPoint Presentation | Content and metadata |   | Microsoft PowerPoint 97+ |
| [PPS](https://docs.fileformat.com/presentation/pps/) | PowerPoint Slideshow | Content and metadata |   | Microsoft PowerPoint 97+ |
| [POT](https://docs.fileformat.com/presentation/pot/) | PowerPoint Template | Content and metadata |   | Microsoft PowerPoint 97+ |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Office Open XML Presentation | Content and metadata |   |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Office Open XML Presentation \[Macro-enabled\] | Content and metadata |   |   |
| [POTX](https://docs.fileformat.com/presentation/potx/)  | Office Open XML Presentation Template | Content and metadata |   |   |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Office Open XML Presentation Template \[Macro-enabled\] | Content and metadata |   |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Office Open XML Presentation Slideshow | Content and metadata |   |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Office Open XML Presentation Slideshow \[Macro-enabled\] | Content and metadata |   |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | Open Document Presentation | Content and metadata |   |   |

## Emails

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [PST](https://docs.fileformat.com/email/pst/) | Outlook Personal Information Store File | Content and metadata |   |   |
| [OST](https://docs.fileformat.com/email/ost/) | Outlook Offline Data File | Content and metadata |   |   |
| [EML](https://docs.fileformat.com/email/eml/) | E-Mail Message | Content and metadata |   |   |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | Content and metadata |   |   |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Mail Message | Content and metadata |   |   |

## Notes

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [OneNote](https://docs.fileformat.com/note-taking/one/) | OneNote Document | Content and metadata | Local files of Microsoft OneNote 2010-2016 | Not supported by .NET Core version in Linux |

## Archives

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [ZIP](https://docs.fileformat.com/compression/zip/) | Zipped File | Content and metadata |   |   |

## Audio

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [MP3](https://docs.fileformat.com/audio/mp3/) | MPEG-2 Audio Layer III | Metadata only |   |   |
| [WAV](https://docs.fileformat.com/audio/wav/) | Waveform Audio File Format | Metadata only |   |   |

## Image

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture | Content and metadata |   |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format File | Content and metadata |   |   |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG 2000 Core Image File | Content and metadata |   |   |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | Content and metadata |   |   |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image Format File | Content and metadata |   |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | Content and metadata |   |   |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile | Content and metadata |   |   |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile | Content and metadata |   |   |
| [JPG](https://docs.fileformat.com/image/jpeg/) | JPEG Image | Content and metadata |   |   |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document | Content and metadata |   |   |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | Content and metadata |   |   |

## Project Management

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project File | Metadata only |   |   |

##  Torrent

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [TORRENT](https://docs.fileformat.com/misc/torrent/) | BitTorrent File | Metadata only |   |   |

## Diagram

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio Drawing File | Metadata only |   |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio Stencil File | Metadata only |   |   |

## Medicine

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM Image | Metadata only |   |   |
| [DICOM](https://docs.fileformat.com/image/dcm/) | DICOM Image | Metadata only |   |   |

## Video

| Document Type | Document Type Description | Searchable Data | Supported Versions | Notes |
| --- | --- | --- | --- | --- | --- |
| [AVI](https://docs.fileformat.com/video/avi/) | Audio Video Interleave File | Metadata only |   |   |
| [MOV](https://docs.fileformat.com/video/mov/) | Apple QuickTime Movie | Metadata only |   |   |
| [QT](https://docs.fileformat.com/video/qt/) | Apple QuickTime Movie | Metadata only |   |   |
| [FLV](https://docs.fileformat.com/video/flv/) | Animate Video File | Metadata only |   |   |
| [ASF](https://docs.fileformat.com/video/wmv/) | Advanced Systems Format File | Metadata only |   |   |

---

## Supported Document Formats

Path: /signature/net/supported-document-formats/

The following table indicates the file formats that GroupDocs.Signature can work with.

| Format | Description | Barcode | Digital | FormField | Image | Metadata | QR-code | Stamp | Text |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Picture (BMP) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [CDR](https://docs.fileformat.com/image/cdr/) | CorelDraw Vector Graphic Drawing (CDR) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [CMX](https://docs.fileformat.com/image/cmx/) | Corel Metafile eXchange Image | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [DJVU](https://docs.fileformat.com/image/djvu/) | Deja Vu (DjVu) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphics Interchange Format (GIF) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [JPG](https://docs.fileformat.com/image/jpeg/), [JPEG](https://docs.fileformat.com/image/jpeg/)   | Joint Photographic Experts Group (JPEG) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics (PNG) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document (PSD) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics (SVG) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [TIF](https://docs.fileformat.com/specification/image/tiff/), [TIFF](https://docs.fileformat.com/specification/image/tiff/) | Tagged Image File Format (TIFF) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile (WMF) | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png)  |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format (PDF) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/signature/net/images/check.png) |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint Macro-Enabled Template | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Worksheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel template | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel macro-enabled template | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/signature/net/images/check.png) |   |   | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |

---

## Supported File Formats

Path: /parser/python-net/supported-document-formats/


This topic lists file formats supported by [GroupDocs.Parser for Python via .NET](https://products.groupdocs.com/parser/python-net). You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/parser">}}

## Word Processing

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [DOC](https://wiki.fileformat.com/word-processing/doc/) | Microsoft Word Document | ✅ | ✅ | ✅ | ✅ |
| [DOCX](https://wiki.fileformat.com/word-processing/docx/) | Office Open XML Document | ✅ | ✅ | ✅ | ✅ |
| [DOCM](https://wiki.fileformat.com/word-processing/docm/) | Office Open XML Macro-Enabled Document | ✅ | ✅ | ✅ | ✅ |
| [DOT](https://wiki.fileformat.com/word-processing/dot/) | Microsoft Word Document Template | ✅ | ✅ | ✅ | ✅ |
| [DOTX](https://wiki.fileformat.com/word-processing/dotx/) | Office Open XML Document Template | ✅ | ✅ | ✅ | ✅ |
| [DOTM](https://wiki.fileformat.com/word-processing/dotm/) | Office Open XML Document Macro-Enabled Template | ✅ | ✅ | ✅ | ✅ |
| [TXT](https://wiki.fileformat.com/word-processing/txt/) | Plain text | ✅ | | | |
| [ODT](https://wiki.fileformat.com/word-processing/odt/) | Open Document Text | ✅ | ✅ | ✅ | ✅ |
| [OTT](https://wiki.fileformat.com/word-processing/ott/) | Open Document Text Template | ✅ | ✅ | ✅ | ✅ |
| [RTF](https://wiki.fileformat.com/word-processing/rtf/) | Rich Text Format | ✅ | ✅ | ✅ | ✅ |

## PDF

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [PDF](https://wiki.fileformat.com/view/pdf/) | Portable Document Format File | ✅ | ✅ | ✅ | ✅ |

## Markup 

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [HTML](https://wiki.fileformat.com/web/html/) | Hypertext Markup Language Format | ✅ | | ✅ | |
| [XHTML](https://wiki.fileformat.com/web/xhtml/) | Extensible Hypertext Markup Language File | ✅ | | ✅ | |
| [MHTML](https://wiki.fileformat.com/web/mhtml/) | MIME HTML File | ✅ | | ✅ | |
| [MD](https://wiki.fileformat.com/word-processing/md/) | Markdown | ✅ | | | |
| [XML](https://wiki.fileformat.com/web/xml/) | XML File | ✅ | | | |

## Ebook

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [CHM](https://wiki.fileformat.com/web/chm/) | Compiled HTML Help File | ✅ | | ✅ | |
| [EPUB](https://wiki.fileformat.com/ebook/epub/) | Digital E-Book File Format | ✅ | | ✅ | |
| [FB2](https://wiki.fileformat.com/ebook/fb2/) | FictionBook 2.0 File | ✅ | | ✅ | |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket | ✅ | | | |

## Spreadsheet

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [XLS](https://wiki.fileformat.com/specification/spreadsheet/xls/) | Microsoft Excel Spreadsheet | ✅ | ✅ | ✅ | ✅ |
| [XLSX](https://wiki.fileformat.com/specification/spreadsheet/xlsx/) | Office Open XML Spreadsheet | ✅ | ✅ | ✅ | ✅ |
| [XLSM](https://wiki.fileformat.com/specification/spreadsheet/xlsm/) | Office Open XML Macro-Enabled Spreadsheet | ✅ | ✅ | ✅ | ✅ |
| [XLSB](https://wiki.fileformat.com/specification/spreadsheet/xlsb/) | Office Open XML Binary Spreadsheet | ✅ | ✅ | ✅ | ✅ |
| [XLT](https://wiki.fileformat.com/specification/spreadsheet/xlt/) | Microsoft Excel Template | ✅ | ✅ | ✅ | ✅ |
| [XLTX](https://wiki.fileformat.com/specification/spreadsheet/xltx/) | Office Open XML Spreadsheet Template | ✅ | ✅ | ✅ | ✅ |
| [XLTM](https://wiki.fileformat.com/specification/spreadsheet/xltm/) | Office Open XML Macro-Enabled Spreadsheet Template | ✅ | ✅ | ✅ | ✅ |
| [ODS](https://wiki.fileformat.com/specification/spreadsheet/ods/) | Open Document Spreadsheet | ✅ | ✅ | ✅ | ✅ |
| [CSV](https://wiki.fileformat.com/specification/spreadsheet/csv/) | Comma Separated Values | ✅ | | | |

## Presentation

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [PPT](https://wiki.fileformat.com/presentation/ppt/) | PowerPoint Presentation | ✅ | ✅ | ✅ | ✅ |
| [PPTX](https://wiki.fileformat.com/presentation/pptx/) | Office Open XML Presentation | ✅ | ✅ | ✅ | ✅ |
| [PPTM](https://wiki.fileformat.com/presentation/pptm/) | Office Open XML Macro-Enabled Presentation | ✅ | ✅ | ✅ | ✅ |
| [PPS](https://wiki.fileformat.com/presentation/pps/) | PowerPoint Slideshow | ✅ | ✅ | ✅ | ✅ |
| [PPSX](https://wiki.fileformat.com/presentation/ppsx/) | Office Open XML Presentation Slideshow | ✅ | ✅ | ✅ | ✅ |
| [PPSM](https://wiki.fileformat.com/presentation/ppsm/) | Office Open XML Macro-Enabled Presentation Slideshow | ✅ | ✅ | ✅ | ✅ |
| [POT](https://wiki.fileformat.com/presentation/pot/) | PowerPoint Template | ✅ | ✅ | ✅ | ✅ |
| [POTX](https://wiki.fileformat.com/presentation/potx/) | Office Open XML Presentation Template | ✅ | ✅ | ✅ | ✅ |
| [POTM](https://wiki.fileformat.com/presentation/potm/) | Office Open XML Macro-Enabled Presentation Template | ✅ | ✅ | ✅ | ✅ |
| [ODP](https://wiki.fileformat.com/presentation/odp/) | Open Document Presentation | ✅ | ✅ | ✅ | ✅ |
| [OTP](https://wiki.fileformat.com/presentation/otp/) | Open Document Presentation Template | ✅ | ✅ | ✅ | ✅ |

## Email

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [PST](https://wiki.fileformat.com/email/pst/) | Outlook Personal Information Store File | | | | |
| [OST](https://wiki.fileformat.com/email/ost/) | Outlook Offline Data File | | | | |
| [EML](https://wiki.fileformat.com/email/eml/) | E-Mail Message | ✅ | ✅ | ✅ | |
| [EMLX](https://wiki.fileformat.com/email/emlx/) | Apple Mail Message | ✅ | ✅ | ✅ | |
| [MSG](https://wiki.fileformat.com/email/msg/) | Outlook Mail Message | ✅ | ✅ | ✅ | |

## Archive

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [ZIP](https://wiki.fileformat.com/compression/zip/) | Zipped File | ✅* | | ✅* | |
| [RAR](https://wiki.fileformat.com/compression/rar/) | Rar File | ✅* | | ✅* | |
| [TAR](https://wiki.fileformat.com/compression/tar/) | Tar File | ✅* | | ✅* | |
| [GZ](https://wiki.fileformat.com/compression/gz/) | GZip file | ✅* | | ✅* | |
| [BZ2](https://wiki.fileformat.com/compression/bz2/) | BZip2 File | ✅* | | ✅* | |

\* Extraction from files within the archive

## Image

| Format | Description | Extract Text (OCR) | Extract Metadata |
| --- | --- | :-: | :-: |
| [BMP](https://wiki.fileformat.com/image/bmp/) | Bitmap Image file | ✅ | |
| [JPG, JPEG](https://wiki.fileformat.com/image/jpeg/) | JPEG Image file  | ✅ | |
| [PNG](https://wiki.fileformat.com/image/png/) | Portable Network Graphics | ✅ | |
| [TIF, TIFF](https://wiki.fileformat.com/image/tiff/) | Tagged Image File Format | ✅ | |
| [GIF](https://wiki.fileformat.com/image/gif/) | Graphical Interchange Format | | |
| [DJVU](https://wiki.fileformat.com/image/djvu/) | DjVu File Format | ✅ | |

> **Note:** Text extraction from images requires OCR functionality. Basic OCR support is available, but for advanced scenarios, you may need to configure additional OCR providers.

## Note-taking

| Format | Description | Extract Text | Extract Metadata | Extract Images | Extract Tables |
| --- | --- | :-: | :-: | :-: | :-: |
| [ONE](https://wiki.fileformat.com/note-taking/one/) | OneNote Document | ✅ | | | |

## Summary

GroupDocs.Parser for Python via .NET supports **50+ document formats** across various categories including office documents, PDFs, emails, archives, and images. The library provides comprehensive data extraction capabilities including text, metadata, images, and tables depending on the format.

For specific format support and feature availability, please refer to the detailed tables above or consult the [API Reference](https://reference.groupdocs.com/parser/python-net).


---

## Supported File Formats

Path: /signature/python-net/supported-file-formats/

The following table indicates the file formats that GroupDocs.Signature for Python via .NET can work with. Here's a simple example of how to check if a file format is supported:

```python
import groupdocs.signature as signature

# Check if file format is supported
file_path = "document.pdf"
if signature.FileType.from_extension(file_path).is_supported():
    print(f"File format {file_path} is supported")
else:
    print(f"File format {file_path} is not supported")
```

{{< table-filter placeholder="Start typing to find file format" forumUrl="https://forum.groupdocs.com/c/signature/11">}}


{{< include file="/signature/python-net/_includes/supported-signature/formats-brief.md" type="page" >}}


## Example: Working with Different File Formats

Here's an example of how to work with different file formats in Python:

```python
import groupdocs.signature as signature

def sign_document(input_path, output_path, signature_type="text"):
    # Initialize signature handler
    signature_handler = signature.Signature(input_path)
    
    if signature_type == "text":
        # Create text signature options
        options = signature.TextSignOptions("John Smith")
        options.set_left(100)
        options.set_top(100)
    elif signature_type == "image":
        # Create image signature options
        options = signature.ImageSignOptions("signature.png")
        options.set_left(100)
        options.set_top(100)
    elif signature_type == "digital":
        # Create digital signature options
        options = signature.DigitalSignOptions("certificate.pfx", "password")
    
    # Sign document
    signature_handler.sign(output_path, options)
    print(f"Document signed successfully: {output_path}")

# Example usage
sign_document("document.pdf", "signed.pdf", "text")
sign_document("document.docx", "signed.docx", "image")
sign_document("document.xlsx", "signed.xlsx", "digital")
```

---

## Supported Platforms

Path: /redaction/java/system-requirements/

## Java Version Requirements

**Minimum Required:** Java Development Kit (JDK) 8 or later

GroupDocs.Redaction for Java supports the following Java versions:

*   **JDK 8** (1.8) - Minimum supported version
*   **JDK 11** (LTS) - Recommended for production
*   **JDK 17** (LTS) - Recommended for new projects
*   **JDK 21** (LTS) - Latest LTS version
*   Any newer Java version

> **Note:** Java 7 (J2SE 7.0) is no longer supported. Please use JDK 8 or later.

### Verify Java Installation

Check your Java version:

```bash
java -version
```

Ensure `JAVA_HOME` environment variable is set correctly. See [Installation]({{< ref "redaction/java/getting-started/installation.md" >}}) for setup instructions.

## Supported Operating Systems

GroupDocs.Redaction for Java supports any 32-bit or 64-bit operating system that runs the Java runtime environment.

### Windows

*   Windows 10, 11 (x64, x86)
*   Windows Server 2016, 2019, 2022 (x64)
*   Windows 8.1 (x64, x86)
*   Windows 7 (x64, x86) - *Limited support*
*   Microsoft Azure

### Linux

*   Ubuntu 18.04 LTS and later
*   Debian 10 and later
*   CentOS/RHEL 7 and later
*   OpenSUSE Leap 15 and later
*   Other modern Linux distributions with Java runtime

### macOS

*   macOS 10.14 (Mojave) and later
*   macOS 11 (Big Sur) and later
*   macOS 12 (Monterey) and later
*   macOS 13 (Ventura) and later
*   macOS 14 (Sonoma) and later

## Overview

GroupDocs.Redaction for Java does not require any external software or third-party tools to be installed. The library is self-contained and only requires a compatible Java runtime environment.

For installation instructions, see the [Installation]({{< ref "redaction/java/getting-started/installation.md" >}}) guide.

---

## Supported Platforms

Path: /watermark/java/supported-platforms/

## Supported Java Versions

GroupDocs.Watermark for Java supports Java versions that listed below. For more platform support please check GroupDocs.Watermark for .NET.

*   J2SE 7.0 (1.7)
*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## System requirements

Path: /conversion/net/system-requirements/

{{< alert style="info" >}}

GroupDocs.Conversion for .NET does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Conversion for .NET just follow one of the ways as described in the [Installation]({{< ref "conversion/net/getting-started/installation.md" >}}) section.

{{< /alert >}}

## Supported Operating Systems


GroupDocs.Conversion for .NET can be used on any operating system where the .NET framework is installed including, but not limited to:

### Windows

*   Microsoft Windows Server 2012 R2 and later
*   Microsoft Windows 7 SP1 and later (x64, x86)
*   Microsoft Windows 10 (x64, x86, Arm64)
*   Microsoft Windows 11 (x64, Arm64)

### Linux

*   Ubuntu 18.04 and later
*   Debian 10 and later
*   CentOS 7 and later
*   Fedora 33 and later
*   Alpine 3.13 and later

### macOS

*   macOS 10.15 (Catalina) and later (x64, Arm64)



## Supported Frameworks

GroupDocs.Conversion for .NET supports .NET frameworks as follows:

*   .NET Framework 4.6.2 and later
*   .NET 6.0 and later


## Development Environments

GroupDocs.Conversion for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2017 and later
*   JetBrains Rider
*   Visual Studio Code with C# extension


---

## System requirements

Path: /markdown/net/system-requirements/


{{< alert style="info" >}}

GroupDocs.Markdown for .NET does not require any external software such as Microsoft Office or third-party document editors. To install GroupDocs.Markdown for .NET, follow the steps in the [Installation]({{< ref "markdown/net/getting-started/installation.md" >}}) guide.

{{< /alert >}}

## Supported Operating Systems

### Windows

*   Microsoft Windows 10 (x64, x86)
*   Microsoft Windows 11 (x64)
*   Microsoft Windows Server 2016 and later

### Linux

*   Ubuntu 20.04+, Debian 11+, CentOS 8+, Fedora 36+, Alpine 3.16+
*   Any distribution with .NET 6.0+ runtime support

### macOS

*   macOS 12 (Monterey) and later — Intel and Apple Silicon (M-series)

## Supported Frameworks

GroupDocs.Markdown for .NET ships with assemblies for the following target frameworks:

| Target Framework | Version | Notes |
| --- | --- | --- |
| .NET Framework | 4.6.2+ | Windows only |
| .NET | 6.0 | Windows and Linux |
| .NET | 8.0 | Windows and Linux (LTS) |
| .NET | 10.0 | Windows and Linux (latest) |

All four TFM assemblies are included in the NuGet package. The runtime automatically selects the best match for your project.

## Development Environments

GroupDocs.Markdown for .NET can be used in any development environment that targets .NET. The following environments are explicitly supported:

*   Microsoft Visual Studio 2022 and later
*   Microsoft Visual Studio Code with C# Dev Kit
*   JetBrains Rider 2024.1 and later

---

## System requirements

Path: /markdown/python-net/system-requirements/


{{< alert style="info" >}}

GroupDocs.Markdown for Python via .NET does not require any external software such as Microsoft Office or third-party document editors. To install GroupDocs.Markdown for Python via .NET, follow the steps in the [Installation]({{< ref "markdown/python-net/getting-started/installation.md" >}}) guide.

{{< /alert >}}

## Supported Operating Systems

### Windows

*   Microsoft Windows 10 (x64, x86)
*   Microsoft Windows 11 (x64)
*   Microsoft Windows Server 2016 and later

### Linux

*   Ubuntu 20.04+, Debian 11+, CentOS 8+, Fedora 36+, Alpine 3.16+

### macOS

*   macOS 12 (Monterey) and later -- Intel and Apple Silicon (M-series)

## Python Version

GroupDocs.Markdown for Python via .NET supports **Python 3.5 through 3.14**. The wheel uses the `py3-none-{platform}` tag, meaning it works with any Python 3.x version without per-version rebuilds.

| Python Version | Supported |
| --- | :---: |
| 3.5 | Yes |
| 3.6 | Yes |
| 3.7 | Yes |
| 3.8 | Yes |
| 3.9 | Yes |
| 3.10 | Yes |
| 3.11 | Yes |
| 3.12 | Yes |
| 3.13 | Yes |
| 3.14 | Yes |

## Package Manager

GroupDocs.Markdown for Python via .NET is distributed via [PyPI](https://pypi.org/project/groupdocs-markdown-net/):

```bash
pip install groupdocs-markdown-net
```

---

## System requirements

Path: /merger/nodejs-java/system-requirements/

{{< alert style="info" >}}

GroupDocs.Merger for Node.js via Java does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Merger for Node.js just follow one of the ways as described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Requirements

* Node.js 16 or above
* J2SE 8.0 (1.8) or above

## Supported Operating Systems

GroupDocs.Merger for Node.js can be used on any 32-bit or 64-bit operating system where Java is installed including, but not limited to:

### Windows

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

* Mac OS X

## Development Environments

GroupDocs.Merger for Node.js requirements Node.js and Java. You  can use any text editor like Atom, Sublime, Visual Studio Code, etc.

  
---

## System requirements

Path: /merger/python-net/system-requirements/

{{< alert style="info" >}}

GroupDocs.Merger for Python via .NET does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Merger for Python just follow one of the ways as described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Supported Operating Systems

GroupDocs.Merger for Python can be used on any 32-bit or 64-bit operating system where .NET is installed including, but not limited to:

### Windows

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

* Mac OS X

## Development Environments

GroupDocs.Merger for Python requirements Python and .NET. You  can use any text editor like Atom, Sublime, Visual Studio Code, etc.

  
---

## System requirements

Path: /total/java/system-requirements/

{{< alert style="info" >}}

GroupDocs.Total for Java does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Total for Java just follow one of the ways as described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Supported Java Versions

GroupDocs.Total for Java supports the following Java versions:

- Java 8
- Java 11
- Java 17 (LTS)
- Java 21 (LTS)

{{< alert style="info" >}}

Make sure you are using an up-to-date JDK from a supported vendor (e.g., Oracle, Eclipse Temurin, Amazon Corretto).

{{< /alert >}}
## Supported Operating Systems

GroupDocs.Total for Java is platform-independent and can be used on any OS where Java is supported. Officially tested and supported operating systems include:

- Windows 10/11 (x64)
- Windows Server 2016/2019/2022
- Linux (Ubuntu, CentOS, Debian, etc. – x64)
- macOS (Intel and Apple Silicon, via Rosetta or natively on Java 17+)

{{< alert style="info" >}}

Ensure the file system and permissions allow your application to read/write files and create temporary directories if needed.

{{< /alert >}}

## Development Environments

You can develop with GroupDocs.Total for Java using any Java-supporting IDE:

- IntelliJ IDEA (recommended)
- Eclipse
- NetBeans
- Visual Studio Code (with Java plugin)

Supported build tools:

- **Maven** – Recommended for managing dependencies.
- **Gradle** – Supported with official artifacts.
- Ant – Manually configurable.

## Memory and Performance Recommendations

- **Minimum RAM:** 2 GB  
- **Recommended RAM:** 4 GB or more for processing large documents  
- **Disk Space:** At least 500 MB free disk space for libraries, logs, and temp files  
- **Temporary Storage:** Ensure the system has access to a temporary directory (`java.io.tmpdir`)
- **JVM heap size:**  For large document processing (e.g., big PDFs, Excel files), consider increasing the heap size:

```sh
java -Xms512m -Xmx2048m -jar your-app.jar
```

## Additional Notes

- **JVM Language Compatibility:** Works with Kotlin, Scala, Groovy, and any language running on the JVM
- **Headless Environments:** Supported (e.g., Linux server without GUI)
- **Docker:** Fully compatible. Ensure Java and required system libraries are installed in the container

## Related Links

- [Installation via Maven](https://docs.groupdocs.com/total/java/installation/)
- [Licensing Guide](https://docs.groupdocs.com/total/java/licensing-and-evaluation/)
- [Product Overview](https://products.groupdocs.com/total/java/)
---

## System requirements

Path: /total/net/system-requirements/

{{< alert style="info" >}}

GroupDocs.Total for .NET does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Total for .NET just follow one of the ways as described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Supported Frameworks

GroupDocs.Total for .NET supports .NET as follows:

### .NET

* .NET 6
* .NET 5 (out of support since 23.9)

### .NET Core

* .NET Core 3.1 (out of support since 23.9)

### .NET Framework

* .NET Framework 4.8.1
* .NET Framework 4.8
* .NET Framework 4.7.2
* .NET Framework 4.7
* .NET Framework 4.6.2
* .NET Framework 4.6.0 (out of support since 23.8)
* .NET Framework 4.5.2 (out of support since 23.8)
* .NET Framework 4.5.1 (out of support since 23.8)
* .NET Framework 4.5.0 (out of support since 23.8)
* .NET Framework 4.0 (out of support since 23.8)
* .NET Framework 3.5 (out of support since 22.3)
* .NET Framework 2.0 (out of support since 22.3)

Se complete list of package versions in the [Installation](/total/net/installation) topic.

## Supported Operating Systems

GroupDocs.Total for .NET can be used on any 32-bit or 64-bit operating system where .NET Framework or .NET runtime is installed including, but not limited to:

### Windows

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

{{< alert style="info" >}}
See details on additional requirements for Linux in the [Running in Docker](/total/net/running-in-docker) topic.
{{< /alert >}}

### Mac

* Mac OS X

## Development Environments

GroupDocs.Total for .NET can be used to develop applications in any development environment that targets .NET, but the following environments are explicitly supported:

* Microsoft Visual Studio 2010 and later
* Microsoft Visual Studio for Mac
* Rider from JetBrains

---

## System requirements

Path: /viewer/java/system-requirements/

{{< alert style="info" >}}

GroupDocs.Viewer for Java does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Viewer for Java just follow one of the ways as described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Supported Operating Systems

GroupDocs.Viewer for Java can be used on any 32-bit or 64-bit operating system where Java is installed including, but not limited to:

### Windows

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

* Mac OS X

## Supported Java Versions

GroupDocs.Viewer for Java supports Java versions listed below. For more platform support please check [GroupDocs.Viewer](https://products.groupdocs.com/viewer) page.

* J2SE 8.0 (1.8) or above (*for example Java 17*)

## Development Environments

GroupDocs.Viewer for Java can be used to develop applications in any development environment that targets Java, but the following environments are explicitly supported:

* Eclipse IDE
* IntelliJ IDEA
* NetBeans

## Required fonts

When working with the documents that contain the Chinese hieroglyphs, in order to obtain the valid rendering results without exceptions or replacement characters (usually represented as empty squares) in the produced documents, it is required that a [SimSun](https://learn.microsoft.com/en-us/typography/font-list/simsun) font should be installed in the operating system.

When using Microsoft Windows this should not be the problem, because the SimSun is preinstalled in all the Windows versions and editions starting from the Windows 2000 (for example, Windows XP has preinstalled SimSun version 3.03, Windows 7 has preinstalled SimSun version [5.03](https://learn.microsoft.com/en-us/typography/fonts/windows_7_font_list), and Windows 10 — SimSun version [5.16](https://learn.microsoft.com/en-us/typography/fonts/windows_10_font_list)). But on Linux the SimSun is usually not installed, so it is required to install it manually. This also is valid when running GroupDocs.Viewer in Docker environment and using a Linux image.
---

## System requirements

Path: /viewer/net/system-requirements/

{{< alert style="info" >}}

GroupDocs.Viewer for .NET (including GroupDocs.Viewer.CrossPlatform) does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Viewer for .NET just follow one of the ways as described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Supported Operating Systems

GroupDocs.Viewer for .NET can be used on any 32-bit or 64-bit operating system where .NET Framework 4.6.2 and upper, .NET 6 and upper is installed including, but not limited to:

### Windows

**GroupDocs.Viewer for .NET**:

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

**GroupDocs.Viewer.CrossPlatform** can be used on x86 and x64 Microsoft Windows versions, which also support .NET 6.0:

* Microsoft Windows 7.1 SP1
* Microsoft Windows 8.1
* Microsoft Windows 10 Version 1607+
* Microsoft Windows 11 Version 22000+
* Microsoft Windows Server 2012+
* Microsoft Windows Server Core 2012+
* Microsoft Nano Server Version 1809+

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

Both GroupDocs.Viewer for .NET and GroupDocs.Viewer.CrossPlatform support Mac OS X. GroupDocs.Viewer.CrossPlatform requires macOS version 10.15+.

## Supported Frameworks and Target Runtimes

**GroupDocs.Viewer for .NET** supports .NET Framework and .NET platforms. Current version supports .NET Framework 4.6.2 and above, .NET 6 and above. Older versions of GroupDocs.Viewer for .NET also have supported older .NET Frameworks: .NET Framework 2.0 and 3.5 support was dropped since v22.3, and .NET Framework 4.0 - 4.6.0 was dropped since v23.8.

**GroupDocs.Viewer.CrossPlatform** does not support .NET Framework. Its minimum requirement is .NET 6.0 and above.

## Development Environments

GroupDocs.Viewer for .NET can be used to develop applications in any development environment that targets .NET, but the following environments are explicitly supported:

* Microsoft Visual Studio 2010 and later
* Microsoft Visual Studio for Mac
* Rider from JetBrains

## Required fonts

When working with the documents that contain the Chinese hieroglyphs, in order to obtain the valid rendering results without exceptions or replacement characters (usually represented as empty squares) in the produced documents, it is required that a [SimSun](https://learn.microsoft.com/en-us/typography/font-list/simsun) font should be installed in the operating system.

When using Microsoft Windows this should not be the problem, because the SimSun is preinstalled in all the Windows versions and editions starting from the Windows 2000 (for example, Windows XP has preinstalled SimSun version 3.03, Windows 7 has preinstalled SimSun version [5.03](https://learn.microsoft.com/en-us/typography/fonts/windows_7_font_list), and Windows 10 — SimSun version [5.16](https://learn.microsoft.com/en-us/typography/fonts/windows_10_font_list)). But on Linux the SimSun is usually not installed, so it is required to install it manually. This also is valid when running GroupDocs.Viewer in Docker environment and using a Linux image.
---

## System requirements

Path: /watermark/net/system-requirements/

## Overview

GroupDocs.Watermark for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described on the [Installation]({{< ref "watermark/net/getting-started/installation.md" >}}) page.

## Supported operating systems

GroupDocs.Watermark for .NET supports any 32-bit or 64-bit operating system where .NET framework is installed including, but not limited to:

### Windows

* Microsoft Windows 2003 Server (x64, x86)
* Microsoft Windows 2008 Server (x64, x86)
* Microsoft Windows 2012 Server (x64, x86)
* Microsoft Windows 2012 R2 Server (x64, x86)
* Microsoft Windows 2016 Server (x64, x86)
* Microsoft Windows 2019 Server (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows XP (x64, x86)
* Microsoft Windows 7 (x64, x86)
* Microsoft Windows 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Azure  

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

## Supported frameworks

GroupDocs.Watermark for .NET supports .NET and Mono frameworks as follows:

### .NET Frameworks

* .NET Framework 4.5.0
* .NET Framework 4.5.1
* .NET Framework 4.5.2
* .NET Framework 4.6.0
* .NET Framework 4.6.2
* .NET Framework 4.5.0
* .NET Framework 4.5.1
* .NET Framework 4.6.0
* .NET Framework 4.6.2
* .NET Framework 4.7
* .NET Framework 4.7.2
* .NET Framework 4.8
* .NET Standard 2.1
* .NET Core 3.0
* .NET Core 3.1
* .NET 5.0
* .NET 6.0

## Development environments

GroupDocs.Watermark for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

* Microsoft Visual Studio 2012
* Microsoft Visual Studio 2013
* Microsoft Visual Studio 2015
* Microsoft Visual Studio 2017
* Microsoft Visual Studio 2019
* Microsoft Visual Studio 2022

---

## System Requirements

Path: /annotation/java/system-requirements/


## Supported Java Versions

GroupDocs.Annotation for Java supports Java versions listed below. For more platform support please check [GroupDocs.Annotation for Java](https://products.groupdocs.com/annotation/java).

*   J2SE 7.0 (1.7)
*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## System Requirements

Path: /annotation/net/system-requirements/

## Overview

GroupDocs.Annotation for .NET does not require any external software or third party tools to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "annotation/net/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Annotation for .NET supports any 32-bit or 64-bit operating system where .NET or .NET Core is installed including, but not limited to:

### Windows

*   Microsoft Windows 2003 and later
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

*   Mac OS X

## Supported Frameworks

GroupDocs.Annotation for .NET supports .NET frameworks:

### .NET Core

*   .NET Core 3.1

### .NET Standard

*   .NET Standard 2.1

### .NET Frameworks

*   .NET Framework 2.0 (until GroupDocs.Annotation 22.5)
*   .NET Framework 3.5 (until GroupDocs.Annotation 22.5)
*   .NET Framework 4.0
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.5.2
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.7
*   .NET Framework 4.7.2
*   .NET Framework 4.8

## Development Environments

GroupDocs.Annotation for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2010 and later
*   Microsoft Visual Studio for Mac
*   Rider from JetBrains


---

## System Requirements

Path: /assembly/python-net/system-requirements/


## Overview

GroupDocs.Assembly for Python via .NET does not require any external software or third party tools to be installed.

## Supported operating systems

GroupDocs.Assembly for Python via .NET supports any 32-bit or 64-bit operating system that run the Python runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Development Environments

GroupDocs.Assembly for Python requirements Python. You can use any text editor like Atom, Sublime, Visual Studio Code, etc.
---

## System Requirements

Path: /comparison/java/system-requirements/


## Overview

[GroupDocs.Comparison for Java](https://products.groupdocs.com/comparison/java) does not require any external software or third-party tool to be installed. Just follow one of the ways described in [Installation]({{< ref "comparison/java/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Comparison for Java supports any 32-bit or 64-bit operating system where Java is installed including, but not limited to:

### Windows

- Microsoft Windows Server 2003 and later
- Microsoft Windows Vista (x64, x86)
- Microsoft Windows XP (x64, x86)
- Microsoft Windows 7, 8, 8.1 (x64, x86)
- Microsoft Windows 10 (x64, x86)
- Microsoft Windows 11 (x64)

### Linux

- Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

- Mac OS X

## Supported Frameworks

GroupDocs.Comparison for Java supports the following Java frameworks:

### Java
- Java 8+
- Kotlin

## Development Environments

GroupDocs.Comparison for Java can be used to develop applications in any development environment that targets the Java platform, but the following environments are explicitly supported:

- JetBrains IntelliJ
- NetBeans
- Eclipse

---

## System Requirements

Path: /comparison/net/system-requirements/


## Overview

[GroupDocs.Comparison for .NET](https://products.groupdocs.com/comparison/net) does not require any external software or third party tool to be installed. Just follow one of the way as described in [Installation]({{< ref "comparison/net/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Comparison for .NET supports any 32-bit or 64-bit operating system where .NET or .NET Core is installed including, but not limited to:

### Windows

- Microsoft Windows Server 2003 and later
- Microsoft Windows Vista ( x64, x86)
- Microsoft Windows XP ( x64, x86)
- Microsoft Windows 7, 8, 8.1 ( x64, x86)
- Microsoft Windows 10 ( x64, x86)
- Microsoft Windows 11 (x64)

### Linux

- Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

- Mac OS X

## Supported Frameworks

GroupDocs.Comparison for .NET supports .NET frameworks as follows:

### .NET
- .NET 6

### .NET Core
- .NET Core 3.1

### .NET Standard
- .NET Standard 2.1

### .NET Framework

- .NET Framework 2.0 (Until GroupDocs.Comparison 22.6)
- .NET Framework 3.5 (Until GroupDocs.Comparison 22.6)
- .NET Framework 4.0 (Until GroupDocs.Comparison 23.8)
- .NET Framework 4.5.0 (Until GroupDocs.Comparison 23.8)
- .NET Framework 4.5.1 (Until GroupDocs.Comparison 23.8)
- .NET Framework 4.5.2 (Until GroupDocs.Comparison 23.8)
- .NET Framework 4.6.0 (Until GroupDocs.Comparison 23.8)
- .NET Framework 4.6.2
- .NET Framework 4.5.0
- .NET Framework 4.5.1
- .NET Framework 4.6.0
- .NET Framework 4.6.2
- .NET Framework 4.7
- .NET Framework 4.7.2
- .NET Framework 4.8

## Development Environments

GroupDocs.Comparison for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

- Microsoft Visual Studio 2010 and later
- Microsoft Visual Studio for Mac
- Rider from JetBrains

---

## System Requirements

Path: /comparison/nodejs-java/system-requirements/


GroupDocs.Comparison for Node.js via Java works standalone and does not require Microsoft Office or other third‑party software. This page lists the supported platforms and the specific requirements for both development and production environments.

## Supported Platforms

- Windows: 10, 11, Windows Server 2016/2019/2022 (x64)
- Linux: Debian/Ubuntu, CentOS/RHEL, AlmaLinux/Rocky, Amazon Linux, and other modern distributions (x64)
- macOS: 12 Monterey and newer (Apple Silicon and Intel)
- Architectures: x64 and ARM64 (where Node.js, Java, and native toolchains are available)

## Development Environment

Main requirements:

### Node.js

Use Node.js 20 LTS or later (22 LTS is also supported). See details at [Node.js Releases](https://nodejs.org/en/about/previous-releases).

### Java JDK

Java 8 (LTS) and higher are supported, including Java 11 (LTS), Java 17 (LTS), and Java 21 (LTS). We recommend Java 17 (LTS).

### Build Tools

The [@groupdocs/groupdocs.comparison](https://www.npmjs.com/package/@groupdocs/groupdocs.comparison) package relies on the [java](https://www.npmjs.com/package/java) bridge to interoperate with the Java API. The `java` package depends on [node-gyp](https://www.npmjs.com/package/node-gyp), which requires a working native toolchain during install.

Depending on your OS you will need different tools installed. See the `Installation` section of the [node-gyp](https://www.npmjs.com/package/node-gyp) package for full details.

#### Unix

* [A supported version of Python 3](https://devguide.python.org/versions/)
* `make`
* A C/C++ compiler toolchain such as [GCC](https://gcc.gnu.org/)

On Debian/Ubuntu:

```bash
sudo apt-get update
sudo apt-get install -y build-essential python3
```

#### macOS

* [A supported version of Python 3](https://devguide.python.org/versions/)
* Xcode Command Line Tools which will install `clang`, `clang++`, and `make`.
  * Install the Xcode Command Line Tools standalone by running xcode-select --install. -- OR --
  * Alternatively, if you already have the full Xcode installed, you can install the Command Line Tools under the menu Xcode -> Open Developer Tool -> More Developer Tools....

#### Windows

The fastest way would be using [Chocolatey](https://chocolatey.org/) app and package manager for Windows:

```bash
choco install python visualstudio2022-workload-vctools -y
```

Also, you can install tools manually:

* Install the current [version of Python](https://devguide.python.org/versions/) from the [Microsoft Store](https://apps.microsoft.com/store/search?publisher=Python+Software+Foundation).
* Install Visual C++ Build Environment: For Visual Studio 2019 or later, use the Desktop development with C++ workload from [Visual Studio Community](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community). For a version older than Visual Studio 2019, install [Visual Studio Build Tools](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools) with the Visual C++ build tools option.

### Environment Variables

Ensure your Java installation is discoverable:

- Set `JAVA_HOME` to your JDK/JRE root and include `bin` on `PATH`.

Windows (PowerShell):

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS (Bash):

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"
```

### Fonts and Localization

For accurate comparison of Word/Excel/PowerPoint/PDF and other text-based formats, make sure commonly used fonts are available on the machine. On Linux servers, install a comprehensive font set (e.g., DejaVu/Noto) and any additional corporate fonts used in your documents.

## Production Environment

### Node.js

Use a current LTS version:

- Recommended: Node.js 20 LTS or 22 LTS
- Minimum: Node.js 18 (maintenance)

### Java Runtime (JRE)

Install a compatible JRE:

- Recommended: JRE 17 (headless is fine for servers)
- Supported: JRE 8, 11, 17, 21

### Hardware Recommendations

- CPU: 2+ cores (4+ recommended for concurrent comparisons)
- RAM: 2 GB minimum (4–8 GB recommended for large Office/PDF documents)
- Disk: 500 MB free for libraries and temp files, plus space for input/output documents

Actual resource usage depends on document size, number of pages, embedded images, and concurrent operations.

### Permissions and Temp Storage

- Read permissions to input files and fonts directories
- Write permissions to output directories and OS temporary folder (`TEMP`/`TMPDIR`)
- Optional: Configure a dedicated temp directory if default temp is constrained

### Containerized Environments (Linux)

Install required tools and Java inside your image. Example (Debian/Ubuntu base):

```bash
apt-get update \
  && apt-get install -y --no-install-recommends \
     curl ca-certificates build-essential python3 openjdk-17-jre-headless \
  && rm -rf /var/lib/apt/lists/*
```

Then install the package in your app:

```bash
npm install @groupdocs/groupdocs.comparison
```

### Networking

No outbound network access is required for runtime operation (only for package installation if fetching from npm) unless you using file license. In case you on Metered license where you paying for usage the Internet connection is required. The library works fully offline with local documents.

### Troubleshooting Setup

- node-gyp build errors on Windows: ensure “Desktop development with C++” workload is installed, restart terminal, and confirm `python --version` returns Python 3.x.
- `JAVA_HOME` not set or Java not found: set `JAVA_HOME` and add `<JAVA_HOME>/bin` to `PATH` (see above).
- Permission denied when writing results: verify output folder permissions and available disk space.
- Missing glyphs or incorrect text layout: install required fonts used by your documents on the server.

For installation steps, see the [Installation]({{< ref "comparison/nodejs-java/getting-started/installation" >}}) page.

---

## System Requirements

Path: /comparison/python-net/system-requirements/


## Overview

[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) does not require any external software or third-party tool to be installed. Just follow one of the ways described in the [Installation]({{< ref "comparison/python-net/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Comparison for Python via .NET supports any 32-bit or 64-bit operating system where Python is installed including, but not limited to:

### Windows

- Microsoft Windows Server 2003 and later
- Microsoft Windows Vista (x64, x86)
- Microsoft Windows XP (x64, x86)
- Microsoft Windows 7, 8, 8.1 (x64, x86)
- Microsoft Windows 10 (x64, x86)
- Microsoft Windows 11 (x64)

### Linux

- Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

- Mac OS X

## Supported Frameworks

GroupDocs.Comparison for Python via .NET supports the following Python frameworks:

### Python
- Python 3+

## Development Environments

GroupDocs.Comparison for Python needs only Python and .NET. You can use any text editor like Atom, Sublime, Visual Studio Code, etc.

---

## System Requirements

Path: /conversion/nodejs-java/system-requirements/


GroupDocs.Conversion for Node.js via Java works standalone and does not require Microsoft Office or other third‑party software. This page lists the supported platforms and the specific requirements for both development and production environments.

## Supported Platforms

- Windows: 10, 11, Windows Server 2016/2019/2022 (x64)
- Linux: Debian/Ubuntu, CentOS/RHEL, AlmaLinux/Rocky, Amazon Linux, and other modern distributions (x64)
- macOS: 12 Monterey and newer (Apple Silicon and Intel)
- Architectures: x64 and ARM64 (where Node.js, Java, and native toolchains are available)

## Development Environment

Main requirements:

### Node.js

Use Node.js 20 LTS or later (22 LTS is also supported). See details at [Node.js Releases](https://nodejs.org/en/about/previous-releases).

### Java JDK

Java 8 (LTS) and higher are supported, including Java 11 (LTS), Java 17 (LTS), and Java 21 (LTS). We recommend Java 17 (LTS).

### Build Tools

The [@groupdocs/groupdocs.conversion](https://www.npmjs.com/package/@groupdocs/groupdocs.conversion) package relies on the [java](https://www.npmjs.com/package/java) bridge to interoperate with the Java API. The `java` package depends on [node-gyp](https://www.npmjs.com/package/node-gyp), which requires a working native toolchain during install.

Depending on your OS you will need different tools installed. See the `Installation` section of the [node-gyp](https://www.npmjs.com/package/node-gyp) package for full details.

#### Unix

* [A supported version of Python 3](https://devguide.python.org/versions/)
* `make`
* A C/C++ compiler toolchain such as [GCC](https://gcc.gnu.org/)

On Debian/Ubuntu:

```bash
sudo apt-get update
sudo apt-get install -y build-essential python3
```

#### macOS

* [A supported version of Python 3](https://devguide.python.org/versions/)
* Xcode Command Line Tools which will install `clang`, `clang++`, and `make`.
  * Install the Xcode Command Line Tools standalone by running xcode-select --install. -- OR --
  * Alternatively, if you already have the full Xcode installed, you can install the Command Line Tools under the menu Xcode -> Open Developer Tool -> More Developer Tools....

#### Windows

The fastest way would be using [Chocolatey](https://chocolatey.org/) app and package manager for Windows:

```bash
choco install python visualstudio2022-workload-vctools -y
```

Also, you can install tools manually:

* Install the current [version of Python](https://devguide.python.org/versions/) from the [Microsoft Store](https://apps.microsoft.com/store/search?publisher=Python+Software+Foundation).
* Install Visual C++ Build Environment: For Visual Studio 2019 or later, use the Desktop development with C++ workload from [Visual Studio Community](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community). For a version older than Visual Studio 2019, install [Visual Studio Build Tools](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools) with the Visual C++ build tools option.

### Environment Variables

Ensure your Java installation is discoverable:

- Set `JAVA_HOME` to your JDK/JRE root and include `bin` on `PATH`.

Windows (PowerShell):

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS (Bash):

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"
```

### Fonts and Localization

For accurate conversion of Word/Excel/PowerPoint/PDF and other text-based formats, make sure commonly used fonts are available on the machine. On Linux servers, install a comprehensive font set (e.g., DejaVu/Noto) and any additional corporate fonts used in your documents.

## Production Environment

### Node.js

Use a current LTS version:

- Recommended: Node.js 20 LTS or 22 LTS
- Minimum: Node.js 18 (maintenance)

### Java Runtime (JRE)

Install a compatible JRE:

- Recommended: JRE 17 (headless is fine for servers)
- Supported: JRE 8, 11, 17, 21

### Hardware Recommendations

- CPU: 2+ cores (4+ recommended for concurrent conversions)
- RAM: 2 GB minimum (4–8 GB recommended for large Office/PDF documents)
- Disk: 500 MB free for libraries and temp files, plus space for input/output documents

Actual resource usage depends on document size, number of pages, embedded images, and concurrent operations.

### Permissions and Temp Storage

- Read permissions to input files and fonts directories
- Write permissions to output directories and OS temporary folder (`TEMP`/`TMPDIR`)
- Optional: Configure a dedicated temp directory if default temp is constrained

### Containerized Environments (Linux)

Install required tools and Java inside your image. Example (Debian/Ubuntu base):

```bash
apt-get update \
  && apt-get install -y --no-install-recommends \
     curl ca-certificates build-essential python3 openjdk-17-jre-headless \
  && rm -rf /var/lib/apt/lists/*
```

Then install the package in your app:

```bash
npm install @groupdocs/groupdocs.conversion
```

### Networking

No outbound network access is required for runtime operation (only for package installation if fetching from npm) unless you using file license. In case you on Metered license where you paying for usage the Internet connection is required. The library works fully offline with local documents.

### Troubleshooting Setup

- node-gyp build errors on Windows: ensure “Desktop development with C++” workload is installed, restart terminal, and confirm `python --version` returns Python 3.x.
- `JAVA_HOME` not set or Java not found: set `JAVA_HOME` and add `<JAVA_HOME>/bin` to `PATH` (see above).
- Permission denied when writing results: verify output folder permissions and available disk space.
- Missing glyphs or incorrect text layout: install required fonts used by your documents on the server.

For installation steps, see the [Installation]({{< ref "conversion/nodejs-java/getting-started/installation" >}}) page.

---

## System Requirements

Path: /editor/net/system-requirements/

## Overview

GroupDocs.Editor for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "editor/net/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Editor for .NET supports any 32-bit or 64-bit operating system where .NET or Mono framework is installed including, but not limited to:

### Windows

* Microsoft Windows 2003 Server (x64, x86)
* Microsoft Windows 2008 Server (x64, x86)
* Microsoft Windows 2012 Server (x64, x86)
* Microsoft Windows 2012 R2 Server (x64, x86)
* Microsoft Windows 2016 Server (x64, x86)
* Microsoft Windows 2019 Server (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7 (x64, x86)
* Microsoft Windows 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Azure

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

* Mac OS X

## Supported Frameworks

GroupDocs.Editor for .NET supports .NET and Mono frameworks as follows:

### .NET Standard 2.0

Any type of .NET Standard 2.0 application is supported.

### .NET Frameworks


* .NET Framework 4.6.1
* .NET Framework 4.6.2
* .NET Framework 4.7.0
* .NET Framework 4.7.1
* .NET Framework 4.7.2
* .NET Framework 4.8.0
* .NET Standard 2.0
* .NET Standard 2.1
* .NET Core 2.1
* .NET Core 2.2
* .NET Core 3.0
* .NET Core 3.1
* .NET 5.0
* .NET 6.0

### Mono Framework

* Mono 2.6.7 or later

## Development Environments

GroupDocs.Editor for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

* Microsoft Visual Studio 2010
* Microsoft Visual Studio 2011
* Microsoft Visual Studio 2012
* Microsoft Visual Studio 2013
* Microsoft Visual Studio 2015
* Microsoft Visual Studio 2017
* Microsoft Visual Studio 2019
* Microsoft Visual Studio 2022
* Xamarin.Android
* Xamarin.IOS
* Xamarin.Mac
* MonoDevelop 2.4 and later

---

## System Requirements

Path: /metadata/net/system-requirements/

## Overview

GroupDocs.Metadata for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration.]({{< ref "metadata/net/getting-started/installation.md" >}})

## Supported Operating Systems

GroupDocs.Metadata for .NET supports any 32-bit or 64-bit operating system where .NET or Mono framework is installed including, but not limited to:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

*   Mac OS X

## Supported Frameworks

GroupDocs.Metadata for .NET  supports .NET and Mono frameworks as follows:

### .NET Frameworks

*   .NET Framework 2.0
*   .NET Framework 3.5
*   .NET Framework 4.0
*   .NET Framework 4.0\_ClientProfile
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.5.2
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.7
*   .NET Framework 4.7.2
*   .NET Standard 2.0 
*   .NET Core 2.0
*   .NET Core 2.1

### Mono Framework

*   Mono 2.6.7 or later

## Development Environments

GroupDocs.Metadata for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2010
*   Microsoft Visual Studio 2011
*   Microsoft Visual Studio 2012
*   Microsoft Visual Studio 2013
*   Microsoft Visual Studio 2015
*   Microsoft Visual Studio 2017
*   Microsoft Visual Studio 2019
*   Xamarin.Android
*   Xamarin.IOS
*   Xamarin.Mac
*   MonoDevelop 2.4 and later

---

## System Requirements

Path: /metadata/nodejs-java/system-requirements/


## Overview

GroupDocs.Metadata for Node.js via Java does not require any external software or third party tools to be installed.

## Supported operating systems

GroupDocs.Metadata for Node.js via Java supports any 32-bit or 64-bit operating system that run the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Development Environments

GroupDocs.Metadata for Node.js requirements Node.js and Java. You  can use any text editor like Atom, Sublime, Visual Studio Code, etc.
---

## System Requirements

Path: /metadata/python-net/system-requirements/


## Overview

GroupDocs.Metadata for Python via .NET does not require any external software or third party tools to be installed.

## General Requirements

- [Python](https://www.python.org/downloads/) versions **3.5–3.13** are supported

## Supported Operating Systems

### Windows

* Microsoft Windows 11 (x64)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 7, 8, 8.1, Vista, XP (x64, x86)
* Microsoft Windows Server 2003 and later

### Linux and macOS (partial support)

GroupDocs.Metadata include macOS support for Intel and/or Apple Silicon (M-series) processors and Linux support.

## Additional System Libraries

### Linux and macOS System Requirements

* macOS-x86_64: 10.14 or later
* macOS-arm64: 11.0 or later

GroupDocs.Metadata for Python via .NET relies on `libgdiplus` for processing images or documents that contain images. 

#### Linux installation

When using GroupDocs.Metadata in a Linux environment, the following packages should be installed for proper library operation:

1. **libgdiplus** - Mono library providing a GDI+-compatible API on non-Windows operating systems.  
2. **libx11-dev** - Required for drawing functions (image/font rendering).  
3. **fontconfig** - Enables font lookup for text rendering with System.Drawing.  
4. **ttf-mscorefonts-installer** - Provides Microsoft-compatible fonts required by GroupDocs.Total.

To install packages on Debian-based Linux distributions, use [apt-get](https://wiki.debian.org/apt-get):

```bash
sudo apt-get update
sudo apt-get install -y libgdiplus libx11-dev fontconfig ttf-mscorefonts-installer
```

If some packages are not available, you can add the contrib repository:

```bash
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
```

#### macOS installation

The library is required and can be installed using the [Homebrew](https://brew.sh/) package manager:

```ps
brew install mono-libgdiplus
```

Ensure `libgdiplus` is installed if you encounter issues with processing images or documents that contain images.
---

## System Requirements

Path: /parser/java/system-requirements/

## Overview

GroupDocs.Parser for Java does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "parser/java/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Parser for Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Supported Java Versions

GroupDocs.Parser for Java supports the following Java versions:

*   J2SE 7.0 (1.7)
*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## System Requirements

Path: /parser/net/system-requirements/

## Overview

GroupDocs.Parser for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "parser/net/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Parser for .NET supports any 32-bit or 64-bit operating system where .NET or Mono framework is installed including, but not limited to:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

*   Mac OS X

## Supported Frameworks

GroupDocs.Parser for .NET supports .NET and Mono frameworks as follows:

### .NET Standard 2.0

Any type of .NET Standard 2.0 application is supported.

### .NET Frameworks

*   .NET Framework 4.6.1 or higher (recommended)
*   .NET Core 2.0 or higher
*   .NET Standard 2.0 or higher
*   .NET 5.0 or higher
*   .NET 6.0 or higher
*   .NET 7.0 or higher
*   .NET 8.0 or higher

{{< alert style="info" >}}
**Note:** For .NET Framework 4.5 and earlier, you must target .NET Standard 2.0 compatible packages. The minimum recommended version is .NET Framework 4.6.1.
{{< /alert >}}

### Mono Framework

*   Mono 2.6.7 or later

## Development Environments

GroupDocs.Parser for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2010
*   Microsoft Visual Studio 2011
*   Microsoft Visual Studio 2012
*   Microsoft Visual Studio 2013
*   Microsoft Visual Studio 2015
*   Microsoft Visual Studio 2017
*   Microsoft Visual Studio 2019
*   Xamarin.Android
*   Xamarin.IOS
*   Xamarin.Mac
*   MonoDevelop 2.4 and later

---

## System Requirements

Path: /redaction/net/system-requirements/

**Contents Summary**


## Overview

GroupDocs.Redaction for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "redaction/net/getting-started/system-requirements.md" >}}).

## Supported Operating Systems

GroupDocs.Redaction for .NET supports any 32-bit or 64-bit operating system where .NET platform is installed including, but not limited to:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Windows 11 ( x64, x86)

### UNIX

*   Linux or any platform, supporting .NET Core 3.1

## Supported Frameworks

GroupDocs.Redaction for .NET  supports Microsoft .NET Framework and .NET Standard 2.0. All implementations of .NET platform, conforming to .NET Standard 2.0, are also supported.

### .NET Frameworks

*   .NET Framework 2.0
*   .NET Framework 3.5
*   .NET Framework 4.0
*   .NET Framework 4.0\_ClientProfile
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.5.2
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.7
*   .NET Framework 4.7.2
*   .NET Standard 2.0 

### .NET Core Framework

*   .NET Core 2.0 and later

### .NET (Unified Platform) 

*   NET 6.0 and later

## Development Environments

GroupDocs.Redaction for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2010
*   Microsoft Visual Studio 2011
*   Microsoft Visual Studio 2012
*   Microsoft Visual Studio 2013
*   Microsoft Visual Studio 2015
*   Microsoft Visual Studio 2017
*   Microsoft Visual Studio 2019
*   Microsoft Visual Studio 2022

---

## System Requirements

Path: /signature/java/system-requirements/

## Overview

GroupDocs.Signature for Java does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "signature/java/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Signature for Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Supported Java Versions

GroupDocs.Signature for Java supports the following Java versions:

*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## System Requirements

Path: /viewer/nodejs-java/system-requirements/


{{< alert style="info" >}}

GroupDocs.Viewer for Node.js via Java works standalone and does not require Microsoft Office or other third‑party software. This page lists the supported platforms and the specific requirements for both development and production environments.

{{< /alert >}}

## Supported Platforms

- Windows: 10, 11, Windows Server 2016/2019/2022 (x64)
- Linux: Debian/Ubuntu, CentOS/RHEL, AlmaLinux/Rocky, Amazon Linux, and other modern distributions (x64)
- macOS: 12 Monterey and newer (Apple Silicon and Intel)
- Architectures: x64 and ARM64 (where Node.js, Java, and native toolchains are available)

## Development Environment

Main requirements:

### Node.js

Use Node.js 20 LTS or later (22 LTS is also supported). See details at [Node.js Releases](https://nodejs.org/en/about/previous-releases).

### Java JDK

Java 8 (LTS) and higher are supported, including Java 11 (LTS), Java 17 (LTS), and Java 21 (LTS). We recommend Java 17 (LTS).

### Build Tools

The [@groupdocs/groupdocs.viewer](https://www.npmjs.com/package/@groupdocs/groupdocs.viewer) package relies on the [java](https://www.npmjs.com/package/java) bridge to interoperate with the Java API. The `java` package depends on [node-gyp](https://www.npmjs.com/package/node-gyp), which requires a working native toolchain during install.

Depending on your OS you will need different tools installed. See the `Installation` section of the [node-gyp](https://www.npmjs.com/package/node-gyp) package for full details.

#### Unix

* [A supported version of Python 3](https://devguide.python.org/versions/)
* `make`
* A C/C++ compiler toolchain such as [GCC](https://gcc.gnu.org/)

On Debian/Ubuntu:

```bash
sudo apt-get update
sudo apt-get install -y build-essential python3
```

#### macOS

* [A supported version of Python 3](https://devguide.python.org/versions/)
* Xcode Command Line Tools which will install `clang`, `clang++`, and `make`.
  * Install the Xcode Command Line Tools standalone by running xcode-select --install. -- OR --
  * Alternatively, if you already have the full Xcode installed, you can install the Command Line Tools under the menu Xcode -> Open Developer Tool -> More Developer Tools....

#### Windows

The fastest way would be using [Chocolatey](https://chocolatey.org/) app and package manager for Windows:

```bash
choco install python visualstudio2022-workload-vctools -y
```

Also, you can install tools manually:

* Install the current [version of Python](https://devguide.python.org/versions/) from the [Microsoft Store](https://apps.microsoft.com/store/search?publisher=Python+Software+Foundation).
* Install Visual C++ Build Environment: For Visual Studio 2019 or later, use the Desktop development with C++ workload from [Visual Studio Community](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community). For a version older than Visual Studio 2019, install [Visual Studio Build Tools](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools) with the Visual C++ build tools option.

### Environment Variables

Ensure your Java installation is discoverable:

- Set `JAVA_HOME` to your JDK/JRE root and include `bin` on `PATH`.

Windows (PowerShell):

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS (Bash):

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"
```

### Fonts and Localization

For accurate rendering of Word/Excel/PowerPoint/PDF and other text-based formats, make sure commonly used fonts are available on the machine. On Linux servers, install a comprehensive font set (e.g., DejaVu/Noto) and any additional corporate fonts used in your documents.

## Production Environment

### Node.js

Use a current LTS version:

- Recommended: Node.js 20 LTS or 22 LTS
- Minimum: Node.js 18 (maintenance)

### Java Runtime (JRE)

Install a compatible JRE:

- Recommended: JRE 17 (headless is fine for servers)
- Supported: JRE 8, 11, 17, 21

### Hardware Recommendations

- CPU: 2+ cores (4+ recommended for concurrent rendering)
- RAM: 2 GB minimum (4–8 GB recommended for large Office/PDF documents)
- Disk: 500 MB free for libraries and temp files, plus space for input/output documents

Actual resource usage depends on document size, number of pages, embedded images, and concurrent operations.

### Permissions and Temp Storage

- Read permissions to input files and fonts directories
- Write permissions to output directories and OS temporary folder (`TEMP`/`TMPDIR`)
- Optional: Configure a dedicated temp directory if default temp is constrained

### Containerized Environments (Linux)

Install required tools and Java inside your image. Example (Debian/Ubuntu base):

```bash
apt-get update \
  && apt-get install -y --no-install-recommends \
     curl ca-certificates build-essential python3 openjdk-17-jre-headless \
  && rm -rf /var/lib/apt/lists/*
```

Then install the package in your app:

```bash
npm install @groupdocs/groupdocs.viewer
```

### Networking

No outbound network access is required for runtime operation (only for package installation if fetching from npm) unless you using file license. In case you on Metered license where you paying for usage the Internet connection is required. The library works fully offline with local documents.

### Troubleshooting Setup

- node-gyp build errors on Windows: ensure "Desktop development with C++" workload is installed, restart terminal, and confirm `python --version` returns Python 3.x.
- `JAVA_HOME` not set or Java not found: set `JAVA_HOME` and add `<JAVA_HOME>/bin` to `PATH` (see above).
- Permission denied when writing results: verify output folder permissions and available disk space.
- Missing glyphs or incorrect text layout: install required fonts used by your documents on the server.

For installation steps, see the [Installation]({{< ref "viewer/nodejs-java/getting-started/installation" >}}) page.

  
---

## System Requirements

Path: /watermark/nodejs-java/system-requirements/


## Overview

[GroupDocs.Watermark for Node.js via Java](https://products.groupdocs.com/watermark/nodejs-java) does not require any external software or third-party tool to be installed. Just follow one of the ways described in the [Installation]({{< ref "watermark/nodejs-java/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Watermark for Node.js via Java supports any 32-bit or 64-bit operating system where Java is installed including, but not limited to:

### Windows

- Microsoft Windows Server 2003 and later
- Microsoft Windows Vista (x64, x86)
- Microsoft Windows XP (x64, x86)
- Microsoft Windows 7, 8, 8.1 (x64, x86)
- Microsoft Windows 10 (x64, x86)
- Microsoft Windows 11 (x64)

### Linux

- Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

- Mac OS X

## Supported Frameworks

GroupDocs.Watermark for Node.js via Java supports the following Java frameworks:

### Java
- Java 8+
- Kotlin

## Development Environments

GroupDocs.Watermark for Node.js needs only Node.js and Java. You can use any text editor like Atom, Sublime, Visual Studio Code, etc.

---

## Save document to the specified stream

Path: /watermark/net/save-document-to-the-specified-stream/

Following code shows usage of [Save(Stream)](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/2) method.

**AdvancedUsage.SavingDocuments.SaveDocumentToTheSpecifiedStream**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\test.doc"
using (Watermarker watermarker = new Watermarker("test.doc"))
{
    // watermarking goes here
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
    watermarker.Add(watermark);

    // Saves the document to the specified stream
    watermarker.Save(stream);
}
```

---

## Update annotation replies

Path: /annotation/net/update-annotation-replies/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to update annotation replies by accessing them using the [Replies](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/annotationbase/properties/replies) collection.

To update annotation replies, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Call the [Get](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/get) method of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class to get collection of the document annotations.
3.   Access a reply object in the [Replies](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/annotationbase/properties/replies) collection using its index (zero-based) and update its properties.
4.   Call the [Update](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/update) method of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify annotations.
5.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream and the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class.
    

The following code snippet shows how to update reply by index: 

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
// NOTE: Input document already contain annotations with replies
using (Annotator annotator = new Annotator("result.pdf"))
{
	// Obtain annotations collection from document
	List<AnnotationBase> annotations = annotator.Get();
                
	// Update first annotation first reply
	annotations[0].Replies[0].Comment = "Updated reply";
                
	// Save changes
	annotator.Update(annotations);
	annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Updating multiple signatures of different types

Path: /signature/java/updating-multiple-signatures-of-different-types/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides different classes of signatures to manipulate them by changing its properties over [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) object to analyze if signatures were successfully processed.

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class. The [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult)contains list of successfully updated signatures and ones that failed. The signature could be failed to update due to several reasons:

*   if signature object was initialized with constructor by incorrect signature identifier;
*   if signature object was not found;
*   there was an error occurred while updating signature in the document;
*   the signature type is not supported for modification (Digital, Form Field or Metadata signature).

Here are the steps to update multiple signature in the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate one or several Search options with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method and pass created list of Search Options to obtain list of [BaseSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature);      
*   Select from list [BaseSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature) object(s) that should be updated;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.    
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not.

## Update multiple signatures of different types in the document

This example shows how to update signature that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
    Signature signature = new Signature("signed.pptx");
 
    // define few search options
    BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
    QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
    // add options to list
    List<SearchOptions> listOptions = new ArrayList<SearchOptions>();
    listOptions.add(barcodeOptions);
    listOptions.add(qrCodeOptions);
 
    // search for signatures in document
    SearchResult result = signature.search(listOptions);
    if (result.getSignatures().size() > 0)
    {
        System.out.print("\nTrying to update all signatures...");
        // mark all signatures as actual Signatures
        for (BaseSignature baseSignature : result.getSignatures())
        {
            baseSignature.setSignature(true);
        }
        // update all found signatures
        UpdateResult updateResult = signature.update("signed.pptx",result.getSignatures());
        if (updateResult.getSucceeded().size() == result.getSignatures().size())
        {
            System.out.print("\nAll signatures were successfully updated!");
        }
        else
        {
            System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
            System.out.print("Not updated signatures : "+updateResult.getFailed().size());
        }
        System.out.print("\nList of updated signatures:");
        int number = 1;
        for (BaseSignature temp : updateResult.getSucceeded())
        {
            System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
        }
    }
    else
    {
        System.out.print("No one signature was found.");
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Use Aspose.OCR for Cloud SDK

Path: /redaction/java/use-aspose-ocr-for-cloud/

This implementation is based on [Aspose.OCR for Cloud SDK](https://sdks.aspose.cloud/ocr/java/). Although it requires a valid Aspose.Cloud subscription, you can always [request a trial](https://dashboard.aspose.cloud/).

Let's suppose that the Aspose.Cloud AppSid and AppKey are stored in system environment variables ASPOSE_CLOUD_APPSID and ASPOSE_CLOUD_APPKEY. 

**Java**

```java
import java.io.IOException;
import java.io.InputStream;
import java.awt.Rectangle;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import org.apache.commons.lang3.ArrayUtils;
import org.json.JSONArray;
import org.json.JSONObject;

import com.groupdocs.redaction.integration.RecognizedImage;
import com.groupdocs.redaction.integration.TextLine;
import com.groupdocs.redaction.integration.TextFragment;
import com.groupdocs.redaction.integration.IOcrConnector;

public class AsposeCloudOcrConnector implements IOcrConnector
{
    public AsposeCloudOcrConnector() 
    {
    }

    public RecognizedImage recognize(InputStream imageStream)
    {
        try
        {
            Configuration.setAPP_SID(System.getenv("ASPOSE_CLOUD_APPSID"));
            Configuration.setAPI_KEY(System.getenv("ASPOSE_CLOUD_APPKEY"));
            Configuration.setUserAgent("WebKit");
            
            final OcrApiInvoker api = new ApiClient().createService(OcrApiInvoker.class);            
            byte []payload = readBytes(imageStream);
            RequestBody requestBody = RequestBody.create( MediaType.parse("application/octet-stream"), payload);
            Call<ResponseBody> call = api.RecognizeFromContent(requestBody, Language.English, ResultType.Internal, 
                    DsrMode.DsrAndFilter, DsrConfidence.Default);
            Response<ResponseBody> res = call.execute();
            if (res.isSuccessful())
            {
                ResponseBody answer = res.body();
                JSONObject jToken = new JSONObject(answer.string());
                String result = jToken.getString("text");
                return createDtoFromResponse(new JSONObject(result));
            }
        }
        catch (java.lang.Exception ex)
        {
            throw new RuntimeException("Aspose.OCR for Cloud Recognition failed: " + ex.toString());
        }
        return new RecognizedImage(new TextLine[0]);
    }

    protected  RecognizedImage createDtoFromResponse(JSONObject jToken)
    {        
        // Recursively parse json tree with regions and text lines.
    }

    ...

}
```

The RecognizeFromContent() method with ResultType.Internal returns a JSON-serialized tree of text regions and recognized lines, with bounding rectangles. The text line is represented by a single object.

You can find full implementation and an example of its usage here [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use Aspose.OCR for Cloud SDK

Path: /redaction/net/use-aspose-ocr-for-cloud/

This implementation is based on [Aspose.OCR for Cloud SDK](https://products.aspose.cloud/ocr/net). Although it requires a valid Aspose.Cloud subscription, you can always [request a trial](https://dashboard.aspose.cloud/).

Let's suppose that the Aspose.Cloud AppSid and AppKey are stored in system environment variables ASPOSE_CLOUD_APPSID and ASPOSE_CLOUD_APPKEY. 

**C#**

```csharp
using Aspose.Ocr.Cloud.Sdk;
using Aspose.Ocr.Cloud.Sdk.Model;
using Aspose.Ocr.Cloud.Sdk.Model.Requests;
using Newtonsoft.Json.Linq;

public class AsposeOCRForCloudConnector : IOcrConnector
{
    private readonly Configuration configuration;

    public AsposeOCRForCloudConnector()
    {
        configuration = new Configuration();
        configuration.AppSid = Environment.GetEnvironmentVariable("ASPOSE_CLOUD_APPSID");
        configuration.AppKey = Environment.GetEnvironmentVariable("ASPOSE_CLOUD_APPKEY");
        configuration.ApiBaseUrl = "https://api.aspose.cloud";
        configuration.IdentityServerBaseUrl = "https://api.aspose.cloud";
    }

    public RecognizedImage Recognize(Stream imageStream)
    {
        try
        {
            OcrApi api = new OcrApi(configuration);
            var request = new PostOcrFromUrlOrContentRequest(imageStream, resultType: ResultType.Internal, dsrMode: DsrMode.DsrAndFilter);
            OCRResponse response = api.PostOcrFromUrlOrContent(request);
            return CreateDtoFromResponse(JToken.Parse(response.Text));
        }
        catch (Exception ex)
        {
            Console.WriteLine("Aspose.OCR for Cloud Recognition failed: {0}", ex.ToString());
        }
        return new RecognizedImage(new List<TextLine>());
    }

    protected virtual RecognizedImage CreateDtoFromResponse(JToken jToken)
    {
        return new RecognizedImage(LeafRecursion(jToken));
    }

    private TextLine[] LeafRecursion(JToken jToken)
    {
        List<TextLine> lines = new List<TextLine>();
        if (jToken["leaves"].Count() > 0)
        {
            foreach (var node in jToken["leaves"])
            {
                if (node["leaves"].Count() > 0)
                {
                    lines.AddRange(LeafRecursion(node));
                }
                else
                {
                    TextLine textLine = CreateTextLine(node);
                    if (textLine != null)
                    {
                        lines.Add(textLine);
                    }
                }
            }
        }
        return lines.ToArray();
    }

    private TextLine CreateTextLine(JToken line)
    {
        string lineText = line["values"].ToString();
        Rectangle lineRectangle = GetLineRectangle(line);
        if (!string.IsNullOrEmpty(lineText) && !lineRectangle.IsEmpty)
        {
            return new TextLine(RegularTextLine.SplitToFragments(lineText, lineRectangle));
        }
        else
        {
            return null;
        }
    }

    private Rectangle GetLineRectangle(JToken line)
    {
        var rect = line["rect"];
        return new Rectangle(rect[0].Value<int>(), rect[1].Value<int>(), rect[2].Value<int>() - rect[0].Value<int>(),
            rect[3].Value<int>() - rect[1].Value<int>());
    }
}

```

The PostOcrFromUrlOrContent() method with ResultType.Internal returns a JSON-serialized tree of text regions and recognized lines, with bounding rectangles. The text line is represented by a single object.

You can find full implementation and an example of its usage here [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use PageAreaRedaction

Path: /redaction/java/use-page-area-redaction/


You can use **PageAreaRedaction** to redact an area of a specific page range from all sensitive data in text, images and annnotations. 

The following example demonstrates how to apply **PageAreaRedaction** to the right half of the last page in a PDF document.

```java
        final Redactor redactor = new Redactor("Sample.pdf");
        try 
        {
            java.util.regex.Pattern rx = java.util.regex.Pattern.compile("urna");
            ReplacementOptions optionsText = new ReplacementOptions("[redarea]");
            optionsText.setFilters(new RedactionFilter[] {
                new PageRangeFilter(PageSeekOrigin.End, 0, 1), // last page
                new PageAreaFilter(new java.awt.Point(300, 0), new java.awt.Dimension(300, 840)) // right half of the page
            });
            RegionReplacementOptions optionsImg = new RegionReplacementOptions(java.awt.Color.RED, new java.awt.Dimension(100, 100));
            RedactorChangeLog result = redactor.apply(new PageAreaRedaction(rx, optionsText, optionsImg));
            if (result.getStatus() != RedactionStatus.Failed)
            {
                redactor.save();
            }                            
        }
        finally { redactor.close(); }
```


---

## Use PageAreaRedaction

Path: /redaction/net/use-page-area-redaction/


You can use [PageAreaRedaction](https://reference.groupdocs.com/redaction/net/groupdocs.redaction.redactions/pagearearedaction/) to redact an area of a specific page range from all sensitive data in text, images and annnotations.. 

The following example demonstrates how to apply PageAreaRedaction to the right half of the last page in a PDF document.

**C#**

```csharp
            using (Redactor redactor = new Redactor("Sample.pdf"))
            {
                Regex rx = new Regex("urna");
                ReplacementOptions optionsText = new ReplacementOptions("[redarea]");
                optionsText.Filters = new RedactionFilter[] {
                    new PageRangeFilter(PageSeekOrigin.End, 0, 1), // last page
                    new PageAreaFilter(new System.Drawing.Point(300, 0), new System.Drawing.Size(300, 840)) // right half of the page 300x840
                };
                RegionReplacementOptions optionsImg = new RegionReplacementOptions(System.Drawing.Color.Chocolate, new System.Drawing.Size(100, 100));
                RedactorChangeLog result = redactor.Apply(new PageAreaRedaction(rx, optionsText, optionsImg));
                if (result.Status != RedactionStatus.Failed)
                {
                    redactor.Save();
                };
            }
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use redaction callback

Path: /redaction/java/use-redaction-callback/

In order to reject specific changes during redaction process or to keep a full log of changes in the document, you need to set Redactor.RedactionCallback property, to a class implementing IRedactionCallback interface. The interface contains only one method, AcceptRedaction, which receives detailed information about proposed redaction and returns Boolean value, accepted or not.

Below, we create a callback class, dumping changes to system console:



```java
public class RedactionDump implements IRedactionCallback
{
    public RedactionDump()
    {
    }
 
    public boolean acceptRedaction(RedactionDescription description)
    {
        System.out.print(description.getRedactionType() + " redaction, " + description.getActionType() + " action, item " + description.getOriginalText() + ". ");
        if (description.getReplacement() != null)
        {
            System.out.print("Text " + description.getReplacement().getOriginalText() + " is replaced with " + description.getReplacement().getReplacement() + ". ");
        }
        System.out.println();
        return true;
    }
}

```

The instance of this class is to be passed to a constructor of the *Redactor* class:



```java
// Assign an instance of callback before using Redactor
final Redactor redactor = new Redactor("\\Sample.docx", new LoadOptions(), new RedactorSettings(new RedactionDump()));
try 
{            
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    redactor.save();
}
finally { redactor.close(); }

```

---

## Use redaction callback

Path: /redaction/net/use-redaction-callback/

In order to reject or approve specific changes during redaction process or to keep a full log of changes in the document, you need to provide an instance of [IRedactionCallback](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/iredactioncallback) to a constructor of [RedactorSettings](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.options/redactorsettings) class. The interface contains only one method, [AcceptRedaction()](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/iredactioncallback/methods/acceptredaction), which receives detailed information about proposed redaction and returns *Boolean* value, accepted or not.

Below, we create a callback class, dumping changes to system console:

**C#**

```csharp
public class RedactionDump : IRedactionCallback
{
    public RedactionDump()
    {
    }

    public bool AcceptRedaction(RedactionDescription description)
    {
        Console.Write("{0} redaction, {1} action, item {2}. ", description.RedactionType, description.ActionType, description.OriginalText);
        if (description.Replacement != null)
        {
            Console.Write("Text {0} is replaced with {1}. ", description.Replacement.OriginalText, description.Replacement.Replacement);
        }
        Console.WriteLine();
        // you can return "false" here to prevent particular change during redaction process
        return true;
    }
}

```

The instance of this class is to be passed to a constructor of the [Redactor](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor) class:

**C#**

```csharp
using (Redactor redactor = new Redactor("\\Sample.docx", new LoadOptions(), new RedactorSettings(new RedactionDump())))
{
    // Assign an instance before using Redactor
    redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    redactor.Save();
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Using Tables of Word Processing Documents as Data Sources

Path: /assembly/java/using-tables-of-word-processing-documents-as-data-sources/

Following classes are added in **GroupDocs.Assembly.Data** namespace:

*   [DataTable](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataTable "class in com.groupdocs.assembly.system.data")
*   [DataColumn](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataColumn "class in com.groupdocs.assembly.system.data")
*   [DataColumnCollection](https://reference.groupdocs.com/java/assembly/com.groupdocs.assembly.system.data/DataColumnCollection "class in com.groupdocs.assembly.system.data")

## The Recipe

*   Define template and output report documents
*   Assemble a document using the external document table as a data source

### Download

#### Data Source Document

*   [Managers Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Word%20DataSource/Managers%20Data.docx?raw=true)

#### Template

*   [Importing Word Processing Table into Presentation.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Importing%20Word%20Processing%20Table%20into%20Presentation.pptx?raw=true)

## The Code

{{< gist GroupDocsGists 11ec833c26d8f53d3e6eddd0668c98f5 >}}



---

## Using Tables of Word Processing Documents as Data Sources

Path: /assembly/net/using-tables-of-word-processing-documents-as-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 16.12.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Using Tables of Word Processing Documents as Data Sources

Following classes are added in **[GroupDocs.Assembly.Data](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/)** namespace:

*   [DocumentTable](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttable)
*   [DocumentTableColumn](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecolumn)
*   [DocumentTableColumnCollection](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecolumncollection)
*   [DocumentTableOptions](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttableoptions)

## The Recipe

*   Define template and output report documents
*   Assemble a document using the external document table as a data source

### Download

#### Data Source Document

*   [Managers Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Word%20DataSource/Managers%20Data.docx?raw=true)

#### Template

*   [Importing Word Processing Table into Presentation.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Importing%20Word%20Processing%20Table%20into%20Presentation.pptx?raw=true)

## The Code

{{< gist GroupDocsGists 0d70a84f2c42353f38ee844bc6fc0ffb >}}



---

## Verifying Text signatures

Path: /signature/java/verify-text-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/TextVerifyOptions) class to specify different options for verification of Text signatures.

Here are the steps to verify Text signature within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [TextVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/TextVerifyOptions) object according to your requirements and specify verification options      
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [TextVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/TextVerifyOptions) to it.       
*   Analyze [VerificationResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/VerificationResult) result if needed.

This example shows how to verify Text signature in the document. See [VerificationResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/VerificationResult)

```java
Signature signature = new Signature("signedSample.pdf");
// create QRCode option with predefined QRCode text
TextVerifyOptions options = new TextVerifyOptions();
 
// specify if all pages shoudl be verified
options.setAllPages(false);
PagesSetup pagesSetup = new PagesSetup();
pagesSetup.setFirstPage(false);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(true);
options.setPagesSetup(pagesSetup);
// specify text pattern
options.setText("John");
// specify verification text pattern
options.setMatchType(TextMatchType.Contains);
// specify types of QR code to verify
options.setSignatureImplementation(TextSignatureImplementation.Stamp);
options.setFormTextFieldTitle("Sample");
options.setFormTextFieldType(FormTextFieldType.RichText);
 
// sign document to file
VerificationResult result = signature.verify(options);
if (result.isValid()) {
    System.out.print("\nDocument was verified successfully!");
} else {
    System.out.print("\nDocument failed verification process.");
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verifying Text signatures in advance

Path: /signature/net/verify-text-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textverifyoptions) class to specify different options for verification of Text signatures.

Here are the steps to verify Text signature within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [TextVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textverifyoptions) object according to your requirements and specify verification options
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [TextVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textverifyoptions) to it.
* Analyze [VerificationResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/verificationresult) result if needed.  

This example shows how to verify Text signature in the document. See [VerificationResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/verificationresult)

```csharp
using (Signature signature = new Signature("signedSample.pdf"))
{
    TextVerifyOptions options = new TextVerifyOptions()
    {
        // specify if all pages shoudl be verified
        AllPages = false,
        PagesSetup = new PagesSetup() { FirstPage = false, LastPage = true, OddPages = false, EvenPages = true },
        // specify text pattern
        Text = "John",
        // specify verification text pattern
        MatchType = TextMatchType.Contains,
        // specify types of QR code to verify
        SignatureImplementation = TextSignatureImplementation.Stamp,
        // specify if form fielsd should be verified
        FormTextFieldTitle = "Sample",
        FormTextFieldType = FormTextFieldType.RichText
    };
    // verify document signatures
    VerificationResult result = signature.Verify(options);
    if (result.IsValid)
    {
        Console.WriteLine("\nDocument was verified successfully!");
    }
    else
    {
        Console.WriteLine("\nDocument failed verification process.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Versioning of annotated documents

Path: /annotation/java/versioning-of-documents/


When you save a file using the [Annotator.save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method, the GroupDocs.Annotations creates a version of the annotated file. Versions list keeps annotations that you add, remove, and change. You can swap between different changes made with GroupDocs.Annotation. If needed, you can set your version names.

By default, GroupDocs.Annotations names version using a GUID. You can specify a custom version name.

### Add version with custom name

You can specify a custom version name.
  
The following code snippet shows how to save version with custom name:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to add version.

// Create an instance of Annotator class
try (Annotator annotator = new Annotator("input.pdf")) {
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation areaAnnotation = new AreaAnnotation();
    areaAnnotation.setBox(new Rectangle(100, 100, 100, 100)); 
    annotator.update(areaAnnotation);
    SaveOptions saveOptions = new SaveOptions();
    saveOptions.setVersion("CUSTOM_VERSION");
    
    // Save to file
    annotator.save("result.pdf", saveOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
The [Version](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation.options/saveoptions/) property is object.
{{< /alert >}}

## Get the list of version keys of a file

To get the list of version keys, call the [Annotator.getVersionList()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#getVersionsList--) method of the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class.

The following code snippet shows how to get list of versions keys:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to get list of all version keys on a document.

// Create an instance of Annotator class
try (Annotator annotator = new Annotator("input.pdf")) {
    // Get versions lest from annotated file
    List<Object> versionKeys = annotator.getVersionsList();
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
The [Annotator.GetVersionList()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#getVersionsList--) method returns list of objects. If needed, you can convert them to appropriate type.
{{< /alert >}}

## Get the list of annotations using version key

To get the list of annotations in a specific version, call the [Annotator.getVersion()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#getVersion-java.lang.Object-) method of the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class.

The following code snippets shows how to get list of annotations in a specific version:

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
// This example demonstrates how get list of annotations using version key.

// Create an instance of Annotator class
try (Annotator annotator = new Annotator("input.pdf")) {
    // Get versions lest from annotated file by CUSTOM_VERSION
    List<AnnotationBase> annotations = annotator.getVersion("CUSTOM_VERSION");
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
The [Annotator.getVersion](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#getVersion-java.lang.Object-) method returns list of objects. If needed, you can convert them to appropriate type.
{{< /alert >}}

## Load a specific file version

To load a specific version of a file, call the [LoadOptions.version()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options/loadoptions/#setVersion-java.lang.Object-) method and specify the version key.

The following code snippets shows how load version using version property:

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to load document of custom version.

// Create an instance of Annotator class and set custom version
LoadOptions loadOptions = new LoadOptions();
loadOptions.setVersion("CUSTOM_VERSION");

// Create an instance of Annotator class
try (Annotator annotator = new Annotator("input.pdf", loadOptions)) {
    
    // Save to file
    annotator.save("result_loaded.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Versioning of annotated documents

Path: /annotation/net/versioning-of-documents/


When you save a file using the [Annotator.Save()](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/save/index) method, the GroupDocs.Annotations creates a version of the annotated file. Versions list keeps annotations that you add, remove, and change. You can swap between different changes made with GroupDocs.Annotation. If needed, you can set custom version names.

By default, GroupDocs.Annotations names version using a GUID. If needed, you can specify a custom version name.

### Add version with custom name

You can specify a custom version name.
  
The following code snippet shows how to save version with custom name:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
	annotator.Update(new AreaAnnotation{ Box = new Rectangle(100, 100, 100, 100) });
	annotator.Save("result.pdf", new SaveOptions { Version = "CUSTOM_VERSION" });
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
The [Version](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/saveoptions/properties/version) property is object.
{{< /alert >}}

## Get the list of version keys of a file

To get the list of version keys, call the [GetVersionsList](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/getversionslist) method of the [Annotator](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator) class.

The following code snippet shows how to get list of versions keys:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("result.pdf")) { 
      List<object> versionKeys = annotator.GetVersionsList();
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
The [Annotator.GetVersionList()](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/getversionslist) method returns list of objects. If needed, you can convert them to appropriate type.
{{< /alert >}}

## Get the list of annotations using version key

To get the list of annotations in a specific version, call the [Annotator.GetVersion()](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/getversionslist) method of the [Annotator](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator) class.

The following code snippets shows how to get list of annotations in a specific version:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("result.pdf"))
{
    List<AnnotationBase> annotations = annotator.GetVersion("CUSTOM_VERSION");
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
The [GetVersion](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/methods/getversionslist) method returns list of objects. If needed, you can convert them to appropriate type.
{{< /alert >}}

## Load a specific file version

To load a specific version of a file, specify the [LoadOptions.Version](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/loadoptions/properties/version) property.

The following code snippets shows how load version using version property:

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
 using (Annotator annotator = new Annotator($"result.{ext}", new LoadOptions { Version = "CUSTOM_VERSION" }))
{
	annotator.Save("result_loaded.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Work with search results

Path: /search/java/work-with-search-results/

Working with search results consists in obtaining information from objects of search results and highlighting occurrences in the text of documents.

## Obtain search result information

When a search is complete, the [search](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#search(java.lang.String)) method returns an object of type [SearchResult](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult). This page describes the information available in an object of type [SearchResult](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult).

From the root object of the search result, information is available on the number of documents found, the number of occurrences of the words and phrases found, as well as detailed information on each individual document. Information about an individual document found is represented by an object of the class [FoundDocument](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument).

From the object of the class [FoundDocument](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument), information is available on the full path to the document, the number of occurrences, the words and phrases found, as well as detailed information on each field of the document. Information about the document field is represented by an object of the class [FoundDocumentField](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField).

From the object of the class [FoundDocumentField](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField), information is available on the name of the document field, the number of occurrences, the words and phrases found, and the number of occurrences of each word and phrase.

Below is a code example that writes to the console the detailed information contained in an object of the class [SearchResult](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult) about each document, document field, word, phrase and the number of their occurrences in the document fields.



```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentFolder);
 
// Creating search options
SearchOptions options = new SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(3)); // Setting the maximum number of differences to 3
 
// Search for documents containing the word 'Einstein' or the phrase 'Theory of Relativity'
SearchResult result = index.search("Einstein OR \"Theory of Relativity\"", options);
 
// Printing the result
System.out.println("Documents: " + result.getDocumentCount());
System.out.println("Total occurrences: " + result.getOccurrenceCount());
for (int i = 0; i < result.getDocumentCount(); i++) {
    FoundDocument document = result.getFoundDocument(i);
    System.out.println("\tDocument: " + document.getDocumentInfo().getFilePath());
    System.out.println("\tOccurrences: " + document.getOccurrenceCount());
    for (int j = 0; j < document.getFoundFields().length; j++) {
        FoundDocumentField field = document.getFoundFields()[j];
        System.out.println("\t\tField: " + field.getFieldName());
        System.out.println("\t\tOccurrences: " + document.getOccurrenceCount());
        // Printing found terms
        if (field.getTerms() != null) {
            for (int k = 0; k < field.getTerms().length; k++) {
                System.out.println("\t\t\t" + field.getTerms()[k] + " - " + field.getTermsOccurrences()[k]);
            }
        }
        // Printing found phrases
        if (field.getTermSequences() != null) {
            for (int k = 0; k < field.getTermSequences().length; k++) {
                String[] terms = field.getTermSequences()[k];
                String sequence = "";
                for (int m = 0; m < terms.length; m++) {
                    sequence += terms[m] + " ";
                }
                System.out.println("\t\t\t" + sequence + " - " + field.getTermSequencesOccurrences()[k]);
            }
        }
    }
}
```

## Highlight search results

At the end of a search, it is usually necessary to visualize the results by highlighting the words found in the text. You can highlight search results either in the text of an entire document, or in separate segments. Detailed information about highlighting search results can be found on the page [Highlighting search results]({{< ref "search/java/developer-guide/advanced-usage/searching/highlighting-search-results.md" >}}). Below is an example of highlighting search results in the text of an entire document.



```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentFolder);
 
// Search for the word 'eternity'
SearchResult result = index.search("eternity");
 
// Highlighting occurrences in text
if (result.getDocumentCount() > 0) {
    FoundDocument document = result.getFoundDocument(0); // Getting the first found document
    OutputAdapter outputAdapter = new FileOutputAdapter("c:\\Highlighted.html"); // Creating an output adapter to the file
    Highlighter highlighter = new HtmlHighlighter(outputAdapter); // Creating the highlighter object
    index.highlight(document, highlighter); // Generating HTML formatted text with highlighted occurrences
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Work with search results

Path: /search/net/work-with-search-results/

Working with search results consists in obtaining information from objects of search results and highlighting occurrences in the text of documents.

## Obtain search result information

When a search is complete, the [Search](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/search/index) method returns an object of type [SearchResult](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult). This page describes the information available in an object of type [SearchResult](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult).

From the root object of the search result, information is available on the number of documents found, the number of occurrences of the words and phrases found, as well as detailed information on each individual document. Information about an individual document found is represented by an object of the class [FoundDocument](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument).

From the object of the class [FoundDocument](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument), information is available on the full path to the document, the number of occurrences, the words and phrases found, as well as detailed information on each field of the document. Information about the document field is represented by an object of the class [FoundDocumentField](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield).

From the object of the class [FoundDocumentField](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield), information is available on the name of the document field, the number of occurrences, the words and phrases found, and the number of occurrences of each word and phrase.

Below is a code example that writes to the console the detailed information contained in an object of the class [SearchResult](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult) about each document, document field, word, phrase and the number of their occurrences in the document fields.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentFolder);
 
// Creating search options
SearchOptions options = new SearchOptions();
options.FuzzySearch.Enabled = true; // Enabling the fuzzy search
options.FuzzySearch.FuzzyAlgorithm = new TableDiscreteFunction(3); // Setting the maximum number of differences to 3
 
// Search for documents containing the word 'Einstein' or the phrase 'Theory of Relativity'
SearchResult result = index.Search("Einstein OR \"Theory of Relativity\"", options);
 
// Printing the result
Console.WriteLine("Documents: " + result.DocumentCount);
Console.WriteLine("Total occurrences: " + result.OccurrenceCount);
for (int i = 0; i < result.DocumentCount; i++)
{
    FoundDocument document = result.GetFoundDocument(i);
    Console.WriteLine("\tDocument: " + document.DocumentInfo.FilePath);
    Console.WriteLine("\tOccurrences: " + document.OccurrenceCount);
    for (int j = 0; j < document.FoundFields.Length; j++)
    {
        FoundDocumentField field = document.FoundFields[j];
        Console.WriteLine("\t\tField: " + field.FieldName);
        Console.WriteLine("\t\tOccurrences: " + document.OccurrenceCount);
        // Printing found terms
        if (field.Terms != null)
        {
            for (int k = 0; k < field.Terms.Length; k++)
            {
                Console.WriteLine("\t\t\t" + field.Terms[k].PadRight(20) + field.TermsOccurrences[k]);
            }
        }
        // Printing found phrases
        if (field.TermSequences != null)
        {
            for (int k = 0; k < field.TermSequences.Length; k++)
            {
                string sequence = string.Join(" ", field.TermSequences[k]);
                Console.WriteLine("\t\t\t" + sequence.PadRight(30) + field.TermSequencesOccurrences[k]);
            }
        }
    }
}
```

## Highlight search results

At the end of a search, it is usually necessary to visualize the results by highlighting the words found in the text. You can highlight search results either in the text of an entire document, or in separate segments. Detailed information about highlighting search results can be found on the page [Highlighting search results]({{< ref "search/net/developer-guide/advanced-usage/searching/highlighting-search-results.md" >}}). Below is an example of highlighting search results in the text of an entire document.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentFolder);
 
// Search for the word 'eternity'
SearchResult result = index.Search("eternity");
 
// Highlighting occurrences in text
if (result.DocumentCount > 0)
{
    FoundDocument document = result.GetFoundDocument(0); // Getting the first found document
    OutputAdapter outputAdapter = new FileOutputAdapter(@"c:\Highlighted.html"); // Creating an output adapter to the file
    Highlighter highlighter = new HtmlHighlighter(outputAdapter); // Creating the highlighter object
    index.Highlight(document, highlighter); // Generating HTML formatted text with highlighted occurrences
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Work with search results

Path: /search/nodejs-java/work-with-search-results/

Working with search results consists in obtaining information from objects of search results and highlighting occurrences in the text of documents.

## Obtain search result information

When a search is complete, the [search](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#search(java.lang.String)) method returns an object of type [SearchResult](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult). This page describes the information available in an object of type [SearchResult](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult).

From the root object of the search result, information is available on the number of documents found, the number of occurrences of the words and phrases found, as well as detailed information on each individual document. Information about an individual document found is represented by an object of the class [FoundDocument](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument).

From the object of the class [FoundDocument](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument), information is available on the full path to the document, the number of occurrences, the words and phrases found, as well as detailed information on each field of the document. Information about the document field is represented by an object of the class [FoundDocumentField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField).

From the object of the class [FoundDocumentField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField), information is available on the name of the document field, the number of occurrences, the words and phrases found, and the number of occurrences of each word and phrase.

Below is a code example that writes to the console the detailed information contained in an object of the class [SearchResult](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult) about each document, document field, word, phrase and the number of their occurrences in the document fields.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';
 
// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentFolder);

// Creating search options
const options = new groupdocs.search.SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new groupdocs.search.TableDiscreteFunction(3)); // Setting the maximum number of differences to 3

// Search for documents containing the word 'favourable' or the phrase 'ipsum dolor'
const result = index.search('favourable OR "ipsum dolor"', options);

// Printing the result
console.log();
console.log('Documents: ' + result.getDocumentCount());
console.log('Total occurrences: ' + result.getOccurrenceCount());
for (let i = 0; i < result.getDocumentCount(); i++) {
  const document = result.getFoundDocument(i);
  console.log('\tDocument: ' + document.getDocumentInfo().getFilePath());
  console.log('\tOccurrences: ' + document.getOccurrenceCount());
  const fields = document.getFoundFields();
  for (let j = 0; j < fields.length; j++) {
    const field = fields[j];
    console.log('\t\tField: ' + field.getFieldName());
    console.log('\t\tOccurrences: ' + document.getOccurrenceCount());
    // Printing found terms
    if (field.getTerms() != null) {
      for (let k = 0; k < field.getTerms().length; k++) {
        console.log('\t\t\t' + field.getTerms()[k] + ' - ' + field.getTermsOccurrences()[k]);
      }
    }
    // Printing found phrases
    if (field.getTermSequences() != null) {
      for (let k = 0; k < field.getTermSequences().length; k++) {
        const terms = field.getTermSequences()[k];
        let sequence = '';
        for (let m = 0; m < terms.length; m++) {
          const term = terms[m];
          sequence += term + ' ';
        }
        console.log('\t\t\t' + sequence + ' - ' + field.getTermSequencesOccurrences()[k]);
      }
    }
  }
}
```

## Highlight search results

At the end of a search, it is usually necessary to visualize the results by highlighting the words found in the text. You can highlight search results either in the text of an entire document, or in separate segments. Detailed information about highlighting search results can be found on the page [Highlighting search results]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/highlighting-search-results.md" >}}). Below is an example of highlighting search results in the text of an entire document.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index settings instance
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentFolder);

// Search for the word 'eternity'
const result = index.search('eternity');

// Highlighting occurrences in text
if (result.getDocumentCount() > 0) {
  const document = result.getFoundDocument(0); // Getting the first found document
  const localPath = Utils.OutputPath + 'BasicUsage/WorkWithSearchResults/Highlighted.html';
  const outputAdapter = new groupdocs.search.FileOutputAdapter(groupdocs.search.OutputFormat.Html, localPath); // Creating an output adapter to the file
  const highlighter = new groupdocs.search.DocumentHighlighter(outputAdapter); // Creating the highlighter object
  index.highlight(document, highlighter); // Generating HTML formatted text with highlighted occurrences
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with worksheet backgrounds

Path: /watermark/net/working-with-worksheet-backgrounds/

## Extracting information about all worksheet backgrounds in an excel document

The API allows you to extract [information](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetworksheet/properties/backgroundimage) about all the worksheet backgrounds in an Excel document as shown in the following code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetGetInformationOfWorksheetBackgrounds**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        if (worksheet.BackgroundImage != null)
        {
            Console.WriteLine(worksheet.BackgroundImage.Width);
            Console.WriteLine(worksheet.BackgroundImage.Height);
            Console.WriteLine(worksheet.BackgroundImage.GetBytes().Length);
        }
    }
}
```

## Removing a particular background

Following code sample can be used to remove the [background](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetworksheet/properties/backgroundimage) of a particular worksheet.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetRemoveWorksheetBackground**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    content.Worksheets[0].BackgroundImage = null;

    watermarker.Save("spreadsheet.xlsx");
}
```

## Adding watermark to all backgrounds in an excel worksheet

You can [add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.image/watermarkableimage/methods/add) watermark to the background images that belong to an Excel document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetAddWatermarkToBackgroundImages**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;

    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        if (worksheet.BackgroundImage != null)
        {
            // Add watermark to the image
            worksheet.BackgroundImage.Add(watermark);
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

## Settings background image for charts

GroupDocs.Watermark for .NET also allows you to set the [background image](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetchart/properties/imagefillformat) for a chart inside an Excel document. Following code sample shows how to achieve this functionality.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetSetBackgroundImageForChart**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    content.Worksheets[0].Charts[0].ImageFillFormat.BackgroundImage = 
        new SpreadsheetWatermarkableImage(File.ReadAllBytes("test.png"));
    content.Worksheets[0].Charts[0].ImageFillFormat.Transparency = 0.5;
    content.Worksheets[0].Charts[0].ImageFillFormat.TileAsTexture = true;

    watermarker.Save("spreadsheet.xlsx");
}
```


---

## Working with worksheet backgrounds

Path: /watermark/python-net/working-with-worksheet-backgrounds/


## Extracting information about all worksheet backgrounds in an Excel document
This sample iterates worksheets and prints size and byte-length details for each background image.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        if worksheet.background_image is not None:
            print(worksheet.background_image.width)
            print(worksheet.background_image.height)
            print(len(worksheet.background_image.get_bytes()))
```

## Removing a particular background
This sample clears the background image for a selected worksheet and saves the updated workbook.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    content.worksheets[0].background_image = None
    watermarker.save("spreadsheet.xlsx")
```

## Adding watermark to all backgrounds in an Excel worksheet
This sample applies a centered, rotated text watermark to each worksheet’s background image.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        if worksheet.background_image is not None:
            worksheet.background_image.add(watermark)
    watermarker.save("spreadsheet.xlsx")
```

## Settings background image for charts
This sample sets a chart’s background image and configures its transparency and tiling.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    with open("test.png", "rb") as f:
        content.worksheets[0].charts[0].image_fill_format.background_image = \
            gwc_xls.SpreadsheetWatermarkableImage(f.read())
    content.worksheets[0].charts[0].image_fill_format.transparency = 0.5
    content.worksheets[0].charts[0].image_fill_format.tile_as_texture = True
    watermarker.save("spreadsheet.xlsx")
```



---

## Working with DICOM metadata

Path: /metadata/java/working-with-dicom-metadata/

## Reading DICOM metadata properties

The GroupDocs.Metadata API supports extracting format-specific information from DICOM images.

The following are the steps to read the native DICOM metadata.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a DICOM image
2.  Get the root metadata package
3.  Extract  the native metadata package using the [DicomRootPackage.getDicomPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DicomRootPackage#getDicomPackage()) method
4.  Read the DICOM metadata properties

**examples.advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.dicom.DicomReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDicom)) {
	DicomRootPackage root = metadata.getRootPackageGeneric();

	if (root.getDicomPackage() != null) {
		System.out.println(root.getDicomPackage().getBitsAllocated());
		System.out.println(root.getDicomPackage().getReds());
		System.out.println(root.getDicomPackage().getGreens());
		System.out.println(root.getDicomPackage().getBlues());
		System.out.println(root.getDicomPackage().getNumberOfFrames());
		// ...
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with DICOM metadata

Path: /metadata/net/working-with-dicom-metadata/

## Reading DICOM metadata properties

The GroupDocs.Metadata API supports extracting format-specific information from DICOM images.

The following are the steps to read the native DICOM metadata.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a DICOM image
2.  Get the root metadata package
3.  Extract  the native metadata package using [DicomRootPackage.DicomPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/dicomrootpackage/properties/dicompackage)
4.  Read the DICOM metadata properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Dicom.DicomReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDicom))
{
	var root = metadata.GetRootPackage<DicomRootPackage>();
	if (root.DicomPackage != null)
	{
		Console.WriteLine(root.DicomPackage.BitsAllocated);
		Console.WriteLine(root.DicomPackage.LengthValue);
		Console.WriteLine(root.DicomPackage.DicomFound);
		Console.WriteLine(root.DicomPackage.HeaderOffset);
		Console.WriteLine(root.DicomPackage.NumberOfFrames);

		// ...
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in FLV files

Path: /metadata/java/working-with-metadata-in-flv-files/

## Reading FLV header properties

The GroupDocs.Metadata API supports extracting format-specific information from the FLV file header.

The following are the steps to read the header of an FLV file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an FLV video
2.  Get the root metadata package
3.  Extract  the native metadata package using the [FlvRootPackage.getHeader](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/FlvRootPackage#getHeader()) method
4.  Read the FLV header properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>video.flv.FlvReadHeaderProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputFlv)) {
    FlvRootPackage root = metadata.getRootPackageGeneric();

    System.out.println(root.getHeader().getVersion());
    System.out.println(root.getHeader().hasAudioTags());
    System.out.println(root.getHeader().hasVideoTags());
    System.out.println(root.getHeader().getTypeFlags());
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in FLV files. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in FLV files

Path: /metadata/net/working-with-metadata-in-flv-files/

## Reading FLV header properties

The GroupDocs.Metadata API supports extracting format-specific information from the FLV file header.

The following are the steps to read the header of an FLV file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an FLV video
2.  Get the root metadata package
3.  Extract  the native metadata package using [FlvRootPackage.Header](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.video/flvrootpackage/properties/header)
4.  Read the FLV header properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Video.Flv.FlvReadHeaderProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputFlv))
{
	var root = metadata.GetRootPackage<FlvRootPackage>();

	Console.WriteLine(root.Header.Version);
	Console.WriteLine(root.Header.HasAudioTags);
	Console.WriteLine(root.Header.HasVideoTags);
	Console.WriteLine(root.Header.TypeFlags);
}
```

## Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in FLV files. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in Presentations

Path: /metadata/java/working-with-metadata-in-presentations/

GroupDocs.Metadata for Java provides functionality that allows working with different kinds of presentations such as PPT, PPTX, POTM, POTX, etc. For the full list of supported presentation formats please refer to [Supported document formats]({{< ref "metadata/java/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a presentation

The following sample of code will help you to detect the exact type of a loaded presentation and extract some additional file format information.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a presentation
2.  Extract the root metadata package
3.  Use the [getPresentationType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PresentationRootPackage#getPresentationType()) method to obtain file format information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationReadFileFormatProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPptx)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();
	System.out.println(root.getPresentationType().getFileFormat());
	System.out.println(root.getPresentationType().getPresentationFormat());
	System.out.println(root.getPresentationType().getMimeType());
	System.out.println(root.getPresentationType().getExtension());
}
```

## Reading built-In metadata properties

To access built-in metadata of a presentation, please use the [getDocumentProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage#getDocumentProperties()) method defined in the [DocumentRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationReadBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPpt)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentProperties().getAuthor());
	System.out.println(root.getDocumentProperties().getCreatedTime());
	System.out.println(root.getDocumentProperties().getCompany());
	System.out.println(root.getDocumentProperties().getCategory());
	System.out.println(root.getDocumentProperties().getKeywords());
	System.out.println(root.getDocumentProperties().getLastPrintedDate());
	System.out.println(root.getDocumentProperties().getNameOfApplication());

	// ...
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a presentation please follow the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationReadCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPptx)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();

	IReadOnlyList<MetadataProperty> customProperties = root.getDocumentProperties().findProperties(new ContainsTagSpecification(Tags.getDocument().getBuiltIn()).not());
	for (MetadataProperty property : customProperties) {
		System.out.println(String.format("%s = %s", property.getName(), property.getValue()));
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [findProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MetadataPackage#findProperties(com.groupdocs.metadata.search.Specification)) method for a certain metadata package (instance of the [PresentationPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PresentationPackage) class), the search result will contain only metadata properties that are specific for presentations. 

## Inspecting presentations

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about hidden slides presented in a document or extract user comments from the document content. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Presentation document
2.  Extract the root metadata package
3.  Use the [getInspectionPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PresentationRootPackage#getInspectionPackage()) method to inspect the document

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationReadInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPpt)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();

	if (root.getInspectionPackage().getComments() != null) {
		for (PresentationComment comment : root.getInspectionPackage().getComments()) {
			System.out.println(comment.getAuthor());
			System.out.println(comment.getText());
			System.out.println(comment.getCreatedTime());
			System.out.println(comment.getSlideNumber());
		}
	}

	if (root.getInspectionPackage().getHiddenSlides() != null) {
		for (PresentationSlide slide : root.getInspectionPackage().getHiddenSlides()) {
			System.out.println(slide.getName());
			System.out.println(slide.getNumber());
			System.out.println(slide.getSlideId());
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a presentation.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationReadDocumentStatistics**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPpt)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentStatistics().getCharacterCount());
	System.out.println(root.getDocumentStatistics().getPageCount());
	System.out.println(root.getDocumentStatistics().getWordCount());
}
```

## Updating built-in metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a presentation.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationUpdateBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPptx)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().setAuthor("test author");
	root.getDocumentProperties().setCreatedTime(new Date());
	root.getDocumentProperties().setCompany("GroupDocs");
	root.getDocumentProperties().setCategory("test category");
	root.getDocumentProperties().setKeywords("metadata, built-in, update");

	// ...

	metadata.save(Constants.OutputPptx);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a presentation. Please check the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationUpdateCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPpt)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().set("customProperty1", "some value");
	root.getDocumentProperties().set("customProperty2", 123.1);

	metadata.save(Constants.OutputPpt);
}
```

## Updating inspection properties

When you inspect a document GroupDocs.Metadata for Java forms a metadata package containing the extracted information. The package class also provides some basic methods that allow updating (or removing) the extracted properties. The following code sample demonstrates how to remove the inspection properties from a presentation.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.presentation.<WBR>PresentationUpdateInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPpt)) {
	PresentationRootPackage root = metadata.getRootPackageGeneric();

	root.getInspectionPackage().clearComments();
	root.getInspectionPackage().clearHiddenSlides();

	metadata.save(Constants.OutputPpt);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in Presentations

Path: /metadata/net/working-with-metadata-in-presentations/

GroupDocs.Metadata for .NET provides functionality that allows working with different kinds of presentations such as PPT, PPTX, POTM, POTX, etc. For the full list of supported presentation formats please refer to [Supported Document Formats]({{< ref "metadata/net/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a presentation

The following sample of code will help you to detect the exact type of a loaded presentation and extract some additional file format information.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a presentation
2.  Extract the root metadata package
3.  Use the [FileType](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/presentationrootpackage/properties/filetype) property to obtain file format information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationReadFileFormatProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPptx))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();

	Console.WriteLine(root.FileType.FileFormat);
	Console.WriteLine(root.FileType.PresentationFormat);
	Console.WriteLine(root.FileType.MimeType);
	Console.WriteLine(root.FileType.Extension);
}
```

## Reading built-In metadata properties

To access built-in metadata of a presentation, please use the [DocumentProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1/properties/documentproperties) property defined in the [DocumentRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationReadBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPpt))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();

	Console.WriteLine(root.DocumentProperties.Author);
	Console.WriteLine(root.DocumentProperties.CreatedTime);
	Console.WriteLine(root.DocumentProperties.Company);
	Console.WriteLine(root.DocumentProperties.Category);
	Console.WriteLine(root.DocumentProperties.Keywords);
	Console.WriteLine(root.DocumentProperties.LastPrintedDate);
	Console.WriteLine(root.DocumentProperties.NameOfApplication);

	// ... 
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a presentation please follow the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationReadCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPptx))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();
	var customProperties = root.DocumentProperties.FindProperties(p => !p.Tags.Contains(Tags.Document.BuiltIn));

	foreach (var property in customProperties)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [FindProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/metadatapackage/methods/findproperties) method for a certain metadata package (instance of the [PresentationPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/presentationpackage) class), the search result will contain only metadata properties that are specific for presentations. 

## Inspecting presentations

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about hidden slides presented in a document or extract user comments from the document content. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Presentation document
2.  Extract the root metadata package
3.  Use the [InspectionPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/presentationrootpackage/properties/inspectionpackage) property to inspect the document

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationReadInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPpt))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();

	if (root.InspectionPackage.Comments != null)
	{
		foreach (var comment in root.InspectionPackage.Comments)
		{
			Console.WriteLine(comment.Author);
			Console.WriteLine(comment.Text);
			Console.WriteLine(comment.CreatedTime);
			Console.WriteLine(comment.SlideNumber);
		}
	}

	if (root.InspectionPackage.HiddenSlides != null)
	{
		foreach (var slide in root.InspectionPackage.HiddenSlides)
		{
			Console.WriteLine(slide.Name);
			Console.WriteLine(slide.Number);
			Console.WriteLine(slide.SlideId);
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a presentation.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationReadDocumentStatistics**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPpt))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();

	Console.WriteLine(root.DocumentStatistics.CharacterCount);
	Console.WriteLine(root.DocumentStatistics.PageCount);
	Console.WriteLine(root.DocumentStatistics.WordCount);
}
```

## Updating built-in metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a presentation.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationUpdateBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPptx))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();

	root.DocumentProperties.Author = "test author";
	root.DocumentProperties.CreatedTime = DateTime.Now;
	root.DocumentProperties.Company = "GroupDocs";
	root.DocumentProperties.Category = "test category";
	root.DocumentProperties.Keywords = "metadata, built-in, update";

	// ... 

	metadata.Save(Constants.OutputPptx);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a presentation. Please check the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationUpdateCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPpt))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();

	root.DocumentProperties.Set("customProperty1", "some value");
	root.DocumentProperties.Set("customProperty2", 123.1);

	metadata.Save(Constants.OutputPpt);
}
```

## Updatingj inspection properties

When you inspect a document GroupDocs.Metadata for .NET forms a metadata package containing the extracted information. The package class also provides some basic methods that allow updating (or removing) the extracted properties. The following code sample demonstrates how to remove the inspection properties from a presentation.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Presentation.<WBR>PresentationUpdateInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPpt))
{
	var root = metadata.GetRootPackage<PresentationRootPackage>();

	root.InspectionPackage.ClearComments();
	root.InspectionPackage.ClearHiddenSlides();

	metadata.Save(Constants.OutputPpt);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with Presentation Documents

Path: /assembly/java/working-with-presentation-documents/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}

## Working with Presentation Documents

GroupDocs.Assembly allows you to use data bands in table rows in **Presentation Documents**. A table-row data band is a data band whose body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in word presentation document is as follows:

| **Client**                               | **Manager**         | **Contract Price**                           |
| ---------------------------------------- | ------------------- | -------------------------------------------- |
| **<<foreach [c in ds]>> <<[c.Client]>>** | **<<[c.Manager]>>** | **<<[c.Contact_Price]>> &lt;&lt;/foreach>>** |

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block whose body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

<table class="confluenceTable"><tbody><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;if ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;elseif ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;else&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>... &lt;&lt;/if&gt;&gt;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p><div><strong><br></strong></div></td></tr></tbody></table>
{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Working%20With%20Table%20Row%20Data%20Bands.pptx)

### The Code

{{< gist GroupDocsGists 66617628868c2d54d5611d3acaf91135 >}}



---

## Working with Presentation Documents

Path: /assembly/net/working-with-presentation-documents/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Working with Presentation Documents

GroupDocs.Assembly allows you to use data bands in table rows in **Presentation**** Documents**. A table-row data band is a data band which body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in presentation document is as follows:

<table class="gd-assembly">
	<tbody>
		<tr>
			<td>Manager</td>
			<td>Manager</td>
			<td>Contract Price</td>
		</tr>
		<tr>
			<td>&lt;&lt;foreach [c in ds]>>&lt;&lt;[c.Client]>></td>
			<td>&lt;&lt;[c.Manager]>></td>
			<td>&lt;&lt;[c.Price]>>&lt;&lt;/foreach>></td>
		</tr>
	</tbody>
</table>

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block which body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

|                        |         |                 |
| ---------------------- | ------- | --------------- |
| **&lt;&lt;if ...>> ...**     | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;elseif ...>> ...** | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;else>> ...**       | **...** | **...**         |
| **...**                | **...** | **...**         |
| **...**                | **...** | **... &lt;&lt;/if>>** |
|                        |         |                 |

### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Working%20With%20Table%20Row%20Data%20Bands.pptx)

### The Code

{{< gist GroupDocsGists 89c648653a7515892dc25e42c94b56e5 >}}



---

## Working with resources

Path: /editor/java/working-with-resources/

> This demonstration shows and explains different operations with resources, including retrieving, adjusting and saving them in different scenarios.

## Introduction

Almost all documents of any types have resources. It is first of all images, some document formats also hold fonts. Even for plain text document (TXT), when converting it to the HTML for editing, there will be one stylesheet, that is treated as a resource. GroupDocs.Editor allows to work with resources on editing phase, when document was loaded to the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class and opened for editing by generating the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, that is produced by the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor).[edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#edit--) method. Instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument)can be treated as an input document, converted to internal intermediate format, with possibilities to generate HTML markup and resources for passing them to the client-side WYSIWYG HTML-editor. GroupDocs.Editor classifies all resources onto three groups:

* Images, including: raster (PNG, BMP, JPEG, GIF, ICON) and vector (SVG and WMF).
* Fonts, including: TTF, EOT, WOFF, WOFF2.
* Textual resources: only CSS.
* Audio files: only MP3 (appear in version 22.6).

Every resource type has its own distinct class with metadata, constructors and other methods. They all are located within [com.groupdocs.editor.htmlcss.resources](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/) namespace.

## Preparations

Let's prepare an [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance by loading and editing some input WordProcessing document, as always (using directive is omitted for the sake of simplification):

```java
String inputDocxPath = "C://input/document.docx";
Editor editor = new Editor(inputDocxPath, new WordProcessingLoadOptions());
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.setFontExtraction(FontExtractionOptions.ExtractAll);// Enable max font extraction - ExtractAll
EditableDocument beforeEdit = editor.edit(editOptions);// Create EditableDocument instance
```

## Obtaining resources

Now, when [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance is ready, it is possible to obtains resources from it, and [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) provides several ways for this.

First of all, resources can be retrieved by their type. [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) contains three properties for every resource type:

* [EditableDocument.getImages()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getImages--) — returns a List of [IImageResource](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images/iimageresource), interface, that is common for all images, raster and vector.
* [EditableDocument.getFonts()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getFonts--) — returns a List of [FontResourceBase](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.fonts/fontresourcebase), abstract class, that is common for all fonts.
* [EditableDocument.getCss()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getCss--) — returns a List of [CssText](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.textual/csstext), class, that represents one CSS stylesheet.
* [EditableDocument.getAudio()]((https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getAudio--)) — returns a List of [Mp3Audio]((https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.audio/mp3audio)), class, that represents one MP3 audio file. Added in ver 21.10.

Secondly, completely all resources may be obtained with a single property [EditableDocument.getAllResources()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#getAllResources--). It returns a List of [IHtmlResource](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource), interface, that is common for absolutely all HTML resources, including images, fonts and stylesheets. The collection, returned by the [getAllResources()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getAllResources--) property, in fact is a concatenation of previous three.

Here is a source code:

```java
List<IImageResource> images = beforeEdit.getImages();
List<FontResourceBase> fonts = beforeEdit.getFonts();
List<CssText> stylesheets = beforeEdit.getCss();
List<IHtmlResource> allTogether = beforeEdit.getAllResources();
```

If user wants to manually save instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) as HTML file with resources, he may use something like this:

```java
String outputFolder = "C://output//document_resources//";
for (IImageResource oneImage : (Iterable<IImageResource>) images) {
    oneImage.save(outputFolder + oneImage.getFilenameWithExtension());
}

for (FontResourceBase oneFont : (Iterable<FontResourceBase>) fonts) {
    oneFont.save(outputFolder + oneFont.getFilenameWithExtension());
}

for (CssText oneStylesheet : (Iterable<CssText>) stylesheets) {
    oneStylesheet.save(outputFolder + oneStylesheet.getFilenameWithExtension());
}

try (PrintWriter out = new PrintWriter("c://output//document.html")) {
    out.println(beforeEdit.getContent());
}
```

## CSS resources

There also is a third way, that is designed especially for the stylesheets. The reason is that stylesheets can contain external resources too, which are presented as links with urls. For example, it can be images, fonts, and other stylesheets. In such case it is necessary to adjust such link. For coping with this [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) contains two overloads of the [getCssContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getCssContent--) method.[ First overload](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getCssContent--) is parameterless and returns a `List` of strings, each one represents one stylesheet. In most cases document has only one stylesheet, so such list will have only one item. [Second overload](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getCssContent-java.lang.String-java.lang.String-) obtains two string parameters: `externalImagesPrefix` and `externalFontsPrefix`. First parameter is designated for images, while second - for fonts. Both overloads are shown in example below:

```java
List<String> stylesheetsWithoutPrefixes = beforeEdit.getCssContent();
String externalImagesPrefix = "http://www.mywebsite.com/images/id=";
String externalFontsPrefix = "http://www.mywebsite.com/fonts/id=";
List<String> stylesheetsWithPrefixes = beforeEdit.getCssContent(externalImagesPrefix, externalFontsPrefix);
```

---

## Working with resources

Path: /editor/net/working-with-resources/

> This demonstration shows and explains different operations with resources, including retrieving, adjusting and saving them in different scenarios.

## Introduction

Almost all documents of any types have resources. It is first of all images, some document formats also hold fonts. Even for plain text document (TXT), when converting it to the HTML for editing, there will be one stylesheet, that is treated as a resource. WordProcessing documents of some format, Office Open XML usually, can also contain embedded audio files. GroupDocs.Editor allows to work with resources on editing phase, when document was loaded to the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class and opened for editing by generating the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, that is produced by the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor).[Edit](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method. Instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) can be treated as an input document, converted to internal intermediate format, with possibilities to generate HTML markup and resources for passing them to the client-side WYSIWYG HTML-editor. GroupDocs.Editor classifies all resources onto three groups:

* Images, including: raster (PNG, BMP, JPEG, GIF, ICON) and vector (SVG and WMF).
* Fonts, including: TTF, EOT, WOFF, WOFF2.
* Textual resources: only CSS.
* Audio files: only MP3 (appear in version 21.10).

Every resource type has its own distinct class with metadata, constructors and other methods. They all are located within [GroupDocs.Editor.HtmlCss.Resources](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/) namespace.

## Preparations

Let's prepare an [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance by loading and editing some input WordProcessing document, as always (using directive is omitted for the sake of simplification):

```csharp
string inputDocxPath = "C://input/document.docx";
Editor editor = new Editor(inputDocxPath, new WordProcessingLoadOptions());
WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
editOptions.FontExtraction = FontExtractionOptions.ExtractAll;// Enable max font extraction - ExtractAll
EditableDocument beforeEdit = editor.Edit(editOptions);// Create EditableDocument instance
```

## Obtaining resources

Now, when [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance is ready, it is possible to obtains resources from it, and [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) provides several ways for this.

First of all, resources can be retrieved by their type. [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) contains four properties for every resource type:

* [EditableDocument.Images](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/images) — returns a List of [IImageResource](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images/iimageresource), interface, that is common for all images, raster and vector.
* [EditableDocument.Fonts](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fonts) — returns a List of [FontResourceBase](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.fonts/fontresourcebase), abstract class, that is common for all fonts.
* [EditableDocument.Css](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/css) — returns a List of [CssText](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.textual/csstext), class, that represents one CSS stylesheet.
* [EditableDocument.Audio]((https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/audio)) — returns a List of [Mp3Audio]((https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.audio/mp3audio)), class, that represents one MP3 audio file. Added in ver 21.10.

Secondly, completely all resources may be obtained with a single property [EditableDocument.AllResources](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/allresources). It returns a List of [IHtmlResource](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource), interface, that is common for absolutely all HTML resources, including images, fonts, stylesheets, and audio. The collection, returned by the [AllResources](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/allresources) property, in fact is a concatenation of previous four.

Here is a source code:

```csharp
List<IImageResource> images = beforeEdit.Images;
List<FontResourceBase> fonts = beforeEdit.Fonts;
List<CssText> stylesheets = beforeEdit.Css;
List<Mp3Audio> audiofiles = beforeEdit.Audio;
List<IHtmlResource> allTogether = beforeEdit.AllResources;
```

If user wants to manually save instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) as HTML file with resources, he may use something like this:

```csharp
string outputFolder = "C://output/document_resources/";
foreach (IImageResource oneImage in images)
{
    oneImage.Save(Path.Combine(outputFolder, oneImage.FilenameWithExtension));
}
foreach (FontResourceBase oneFont in fonts)
{
    oneFont.Save(Path.Combine(outputFolder, oneFont.FilenameWithExtension));
}
foreach (CssText oneStylesheet in stylesheets)
{
    oneStylesheet.Save(Path.Combine(outputFolder, oneStylesheet.FilenameWithExtension));
}
foreach (Mp3Audio oneMp3 in audiofiles)
{
    oneMp3.Save(Path.Combine(outputFolder, oneMp3.FilenameWithExtension));
}
System.IO.File.WriteAllText("c://output/document.html", beforeEdit.GetContent());
```

## CSS resources

There also is a third way, that is designed especially for the stylesheets. The reason is that stylesheets can contain external resources too, which are presented as links with urls. For example, it can be images, fonts, and other stylesheets. In such case it is necessary to adjust such link. For coping with this [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) contains two overloads of the [GetCssContent()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcsscontent) method.[First overload](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcsscontent) is parameterless and returns a `List` of strings, each one represents one stylesheet. In most cases document has only one stylesheet, so such list will have only one item. [Second overload](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcsscontent/#getcsscontent_1) obtains two string parameters: `externalImagesPrefix` and `externalFontsPrefix`. First parameter is designated for images, while second - for fonts. Both overloads are shown in example below:

```csharp
List<string> stylesheetsWithoutPrefixes = beforeEdit.GetCssContent();
string externalImagesPrefix = "http://www.mywebsite.com/images/id=";
string externalFontsPrefix = "http://www.mywebsite.com/fonts/id=";
List<string> stylesheetsWithPrefixes = beforeEdit.GetCssContent(externalImagesPrefix, externalFontsPrefix);
```

---

## Working with Resources

Path: /editor/nodejs-java/working-with-resources/


> This guide demonstrates and explains different operations with resources, including retrieving, adjusting, and saving them in different scenarios using GroupDocs.Editor for Node.js via Java.

## Introduction

Almost all documents of any type have resources. First of all, images; some document formats also hold fonts. Even for plain text documents (TXT), when converting them to HTML for editing, there will be one stylesheet, which is treated as a resource. **GroupDocs.Editor** allows you to work with resources during the editing phase when a document is loaded into the `Editor` class and opened for editing by generating the `EditableDocument` instance, which is produced by the `editor.edit()` method. An instance of `EditableDocument` can be treated as an input document converted to an internal intermediate format, with possibilities to generate HTML markup and resources for passing them to the client-side WYSIWYG HTML editor. GroupDocs.Editor classifies all resources into four groups:

1. **Images**, including raster (PNG, BMP, JPEG, GIF, ICON) and vector (SVG and WMF).
2. **Fonts**, including TTF, EOT, WOFF, WOFF2.
3. **Textual resources**: only CSS.
4. **Audio files**: only MP3 (appeared in version 22.6).

Every resource type has its own distinct class with metadata, constructors, and other methods. They all are accessible through the `groupdocs-editor` module.

## Preparations

Let's prepare an `EditableDocument` instance by loading and editing an input WordProcessing document. The following code demonstrates how to achieve this:

```javascript
// Import necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Specify the input DOCX file path
const inputDocxPath = 'C://input/document.docx';

// Create an instance of Editor with optional load options
const editor = new groupdocsEditor.Editor(inputDocxPath, new groupdocsEditor.WordProcessingLoadOptions());

// Prepare edit options
const editOptions = new groupdocsEditor.WordProcessingEditOptions();

// Enable maximum font extraction
editOptions.setFontExtraction(groupdocsEditor.FontExtractionOptions.ExtractAll);

// Create EditableDocument instance
const beforeEdit = editor.edit(editOptions);
```

In this example:

- We import the `groupdocs-editor` module.
- Specify the path to the input WordProcessing document.
- Create an instance of the `Editor` class.
- Prepare `WordProcessingEditOptions` and set font extraction to extract all fonts.
- Call the `editor.edit()` method to create an `EditableDocument` instance.

## Obtaining Resources

Now that the `EditableDocument` instance is ready, it is possible to obtain resources from it. The `EditableDocument` provides several ways to do this.

First of all, resources can be retrieved by their type. The `EditableDocument` contains methods for each resource type:

- `getImages()`: Returns an array of `IImageResource` instances, which is common for all images, raster and vector.
- `getFonts()`: Returns an array of `FontResourceBase` instances, which is common for all fonts.
- `getCss()`: Returns an array of `CssText` instances, representing CSS stylesheets.
- `getAudio()`: Returns an array of `Mp3Audio` instances, representing MP3 audio files (added in version 21.10).

Secondly, all resources can be obtained with a single method `getAllResources()`. It returns an array of `IHtmlResource` instances, which is common for all HTML resources, including images, fonts, stylesheets, and audio files. The collection returned by the `getAllResources()` method is essentially a concatenation of the previous resource arrays.

Here's the source code:

```javascript
// Get images
const images = beforeEdit.getImages();

// Get fonts
const fonts = beforeEdit.getFonts();

// Get stylesheets
const stylesheets = beforeEdit.getCss();

// Get audio resources (if any)
const audioFiles = beforeEdit.getAudio();

// Get all resources together
const allTogether = beforeEdit.getAllResources();
```

If you want to manually save the instance of `EditableDocument` as an HTML file with resources, you may use code like this:

```javascript
// Import necessary modules
const fs = require('fs');
const path = require('path');

// Define the output folder
const outputFolder = 'C://output//document_resources//';

// Ensure the output folder exists
if (!fs.existsSync(outputFolder)) {
    fs.mkdirSync(outputFolder, { recursive: true });
}

// Save images
images.forEach((oneImage) => {
    const imagePath = path.join(outputFolder, oneImage.getFilenameWithExtension());
    fs.writeFileSync(imagePath, oneImage.getByteContent());
});

// Save fonts
fonts.forEach((oneFont) => {
    const fontPath = path.join(outputFolder, oneFont.getFilenameWithExtension());
    fs.writeFileSync(fontPath, oneFont.getByteContent());
});

// Save stylesheets
stylesheets.forEach((oneStylesheet) => {
    const stylesheetPath = path.join(outputFolder, oneStylesheet.getFilenameWithExtension());
    fs.writeFileSync(stylesheetPath, oneStylesheet.getTextContent());
});

// Save audio files (if any)
audioFiles.forEach((oneAudio) => {
    const audioPath = path.join(outputFolder, oneAudio.getFilenameWithExtension());
    fs.writeFileSync(audioPath, oneAudio.getByteContent());
});

// Save the HTML content
fs.writeFileSync('C://output//document.html', beforeEdit.getContent());
```

In this example:

- We import the `fs` and `path` modules to handle file system operations.
- Define the output folder where resources will be saved.
- Ensure the output folder exists, creating it if necessary.
- Iterate over each resource type (images, fonts, stylesheets, audio) and save each resource to the output folder.
- Save the HTML content to a file.

## CSS Resources

There is also a way designed especially for stylesheets. Stylesheets can contain external resources too, which are presented as links with URLs. For example, they can reference images, fonts, and other stylesheets. In such cases, it is necessary to adjust such links. To cope with this, the `EditableDocument` contains two overloads of the `getCssContent()` method.

- **First overload**: Parameterless, returns an array of strings, each representing one stylesheet. In most cases, the document has only one stylesheet, so the array will have only one item.
- **Second overload**: Accepts two string parameters: `externalImagesPrefix` and `externalFontsPrefix`. The first parameter is designated for images, while the second is for fonts.

Both overloads are shown in the example below:

```javascript
// Get stylesheets without prefixes
const stylesheetsWithoutPrefixes = beforeEdit.getCssContent();

// Define external prefixes
const externalImagesPrefix = "http://www.mywebsite.com/images/id=";
const externalFontsPrefix = "http://www.mywebsite.com/fonts/id=";

// Get stylesheets with prefixes
const stylesheetsWithPrefixes = beforeEdit.getCssContent(externalImagesPrefix, externalFontsPrefix);
```

In this example:

- We first retrieve the stylesheets without any external resource prefixes.
- Then, we define external prefixes for images and fonts.
- Use the `getCssContent()` method with the prefixes to adjust the resource links within the stylesheets.

## Conclusion

By following this guide, you can effectively work with resources when editing documents using GroupDocs.Editor for Node.js via Java. You can retrieve, adjust, and save images, fonts, stylesheets, and audio files associated with your documents. This enables you to have full control over the resources when integrating with client-side WYSIWYG HTML editors or for other purposes.

**Note:** Be sure to replace the paths in the code examples with the actual paths used in your application.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Working with spreadsheet document attachments

Path: /watermark/java/working-with-spreadsheet-document-attachments/

## Extract all attachments from Excel document 

GroupDocs.Watermark API allows you to extract [attachments](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetWorksheet#getAttachments()) in Excel document. Following code performs this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetExtractAllAttachments**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                                                                
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"                                 
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                                                              
                                                                                                                                                  
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                                                    
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                                                    
{                                                                                                                                                 
    for (SpreadsheetAttachment attachment : worksheet.getAttachments())                                                                           
    {                                                                                                                                             
        System.out.println("Alternative text: " + attachment.getAlternativeText());                                                               
        System.out.println("Attachment frame x-coordinate: " + attachment.getX());                                                                
        System.out.println("Attachment frame y-coordinate: " + attachment.getY());                                                                
        System.out.println("Attachment frame width: " + attachment.getWidth());                                                                   
        System.out.println("Attachment frame height: " + attachment.getHeight());                                                                 
        System.out.println("Preview image size: " + attachment.getPreviewImageContent() != null ? attachment.getPreviewImageContent().length : 0);
                                                                                                                                                  
        if (attachment.isLink())                                                                                                                  
        {                                                                                                                                         
            // The document contains only a link to the attached file                                                                             
            System.out.println("Full path to the attached file: " + attachment.getSourceFullName());                                              
        }                                                                                                                                         
        else                                                                                                                                      
        {                                                                                                                                         
            // The attached file is stored in the document                                                                                        
            System.out.println("File type: " + attachment.getDocumentInfo().getFileType());                                                       
            System.out.println("Name of the source file: " + attachment.getSourceFullName());                                                     
            System.out.println("File size: " + attachment.getContent().length);                                                                   
        }                                                                                                                                         
    }                                                                                                                                             
}                                                                                                                                                 
                                                                                                                                                  
watermarker.close();                                                                                                                              
```

## Add an attachment to Excel document

 GroupDocs.Watermark API allows you to add attachments in Excel document. Following code performs this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetAddAttachment**

```java
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
File file = new File("document.docx");                                                                  
byte[] attachmentBytes = new byte[(int) file.length()];                                                          
InputStream inputStream = new FileInputStream(file);                                                             
inputStream.read(attachmentBytes);                                                                               
inputStream.close();                                                                                             
                                                                                                                 
file = new File("document_preview.png");                                                                   
byte[] previewImageBytes = new byte[(int) file.length()];                                                        
inputStream = new FileInputStream(file);                                                                         
inputStream.read(previewImageBytes);                                                                             
inputStream.close();                                                                                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
SpreadsheetWorksheet worksheet = content.getWorksheets().get_Item(0);                                            
                                                                                                                 
// Add the attachment                                                                                            
worksheet.getAttachments().addAttachment(attachmentBytes, // File content                                        
                                        "sample document.docx", // Source file full name (the extension is used  
                                        // to determine appropriate application to open                          
                                        // the file)                                                             
                                        previewImageBytes, // Preview image content                              
                                        50, // X-coordinate of the attachment frame                              
                                        100, // Y-coordinate of the attachment frame                             
                                        200, // Attachment frame width                                           
                                        400); // Attachment frame height                                         
                                                                                                                 
// Save changes                                                                                                  
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Add linked attachment to Excel document

 GroupDocs.Watermark API allows you to add linked attachments in Excel document. Following code performs this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetAddLinkedAttachment**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
SpreadsheetWorksheet worksheet = content.getWorksheets().get_Item(0);                                            
                                                                                                                 
File file = new File("document_preview.png");                                                              
byte[] previewImageBytes = new byte[(int) file.length()];                                                        
FileInputStream inputStream = new FileInputStream(file);                                                         
inputStream.read(previewImageBytes);                                                                             
inputStream.close();                                                                                             
                                                                                                                 
// Add the attachment                                                                                            
worksheet.getAttachments().addLink("document.docx", // Source file path                                 
                                   previewImageBytes, // Preview image content                                   
                                   50, // X-coordinate of the attachment frame                                   
                                   100, // Y-coordinate of the attachment frame                                  
                                   200, // Attachment frame width                                                
                                   400); // Attachment frame height                                              
                                                                                                                 
// Save changes                                                                                                  
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Remove attachment from Excel document

GroupDocs.Watermark API allows you to remove [attachments](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetAttachmentCollection) in Excel document. Following code performs this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetRemoveAttachment**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                                    
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"     
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                                  
                                                                                                                      
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                        
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                        
{                                                                                                                     
    for (int i = worksheet.getAttachments().getCount() - 1; i >= 0; i--)                                              
    {                                                                                                                 
        SpreadsheetAttachment attachment = worksheet.getAttachments().get_Item(i);                                    
        if (attachment.isLink() &&                                                                                    
            !new File(attachment.getSourceFullName()).exists() || // Linked file that is not available at this moment 
            attachment.getDocumentInfo().isEncrypted()) // Attached file protected with a password                    
        {                                                                                                             
            // Remove the file if it meets at least one of the conditions above                                       
            worksheet.getAttachments().removeAt(i);                                                                   
        }                                                                                                             
    }                                                                                                                 
}                                                                                                                     
                                                                                                                      
// Save changes                                                                                                       
watermarker.save("spreadsheet.xlsx");                                                                       
                                                                                                                      
watermarker.close();                                                                                                  
```

## Add watermark to all attachments  

GroupDocs.Watermark API allows you to add watermark to all [attachments](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetAttachmentCollection) in Excel document. Following code performs this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetAddWatermarkToAttachment**

```java
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 19));                            
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                   
{                                                                                                                
    for (SpreadsheetAttachment attachment : worksheet.getAttachments())                                          
    {                                                                                                            
        // Check if the attached file is supported by GroupDocs.Watermark                                        
        IDocumentInfo info = attachment.getDocumentInfo();                                                       
        if (info.getFileType() != FileType.Unknown && !info.isEncrypted())                                       
        {                                                                                                        
            // Load the attached document                                                                        
            Watermarker attachedWatermarker = attachment.createWatermarker();                                    
                                                                                                                 
            // Add watermark                                                                                     
            attachedWatermarker.add(watermark);                                                                  
                                                                                                                 
            // Save changes in the attached file                                                                 
            attachment.updateContent(attachedWatermarker);                                                       
                                                                                                                 
            attachedWatermarker.close();                                                                         
        }                                                                                                        
    }                                                                                                            
}                                                                                                                
                                                                                                                 
// Save changes                                                                                                  
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Search for images in attached files

GroupDocs.Watermark API allows you to search for all the [images and watermarkable attachments](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.search/SpreadsheetSearchableObjects) in Excel document. Following code performs this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetSearchImageInAttachment**

```java
// Consider only the attached images                                                                             
WatermarkerSettings settings = new WatermarkerSettings();                                                        
settings.getSearchableObjects().setSpreadsheetSearchableObjects(SpreadsheetSearchableObjects.AttachedImages);    
                                                                                                                 
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions, settings);                   
                                                                                                                 
// Specify sample image to compare document images with                                                          
ImageSearchCriteria criteria = new ImageDctHashSearchCriteria("attachment.png");                          
                                                                                                                 
// Search for similar images                                                                                     
PossibleWatermarkCollection possibleWatermarks = watermarker.search(criteria);                                   
                                                                                                                 
// Remove or modify found image watermarks                                                                       
// ...                                                                                                           
                                                                                                                 
System.out.println("Found " + possibleWatermarks.getCount() + " possible watermark(s).");                        
                                                                                                                 
watermarker.close();                                                                                             
```

---

## Working with Templates

Path: /parser/python-net/working-with-templates/


Templates let you extract structured values (fields, tables, barcodes) from recurring documents. The Python API mirrors the .NET template classes; see [`groupdocs.parser.templates`](https://reference.groupdocs.com/parser/python-net/groupdocs.parser.templates/) for the full list.

## Regex-based fields

Use `TemplateRegexPosition` to locate values by pattern and extract only the matched group:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.templates import Template, TemplateField, TemplateRegexPosition

template = Template([
    TemplateField(
        TemplateRegexPosition(r"Invoice Number\s+(?<value>[A-Z0-9\-]+)"),
        "InvoiceNumber",
    )
])

with Parser("./invoice.pdf") as parser:
    data = parser.parse_by_template(template)
    if data:
        invoice_number = data["InvoiceNumber"].page_area.text
        print(f"Invoice number: {invoice_number}")
```

{{< /tab >}}
{{< tab "invoice.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [invoice.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/template-based-parsing/working-with-templates/invoice.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Tables with detector parameters

Define table bounds and column separators with `TemplateTableParameters` when you need to extract line items:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.data import Rectangle, Point, Size
from groupdocs.parser.templates import (
    Template,
    TemplateItem,
    TemplateTable,
    TemplateTableParameters,
)

table_area = Rectangle(Point(175.0, 350.0), Size(400.0, 200.0))
columns = [185.0, 370.0, 425.0, 485.0, 545.0]

table = TemplateTable(
    TemplateTableParameters(table_area, columns),
    "Details",
    0,  # restrict to the first page; omit to scan all pages
)

template = Template([table])

with Parser("./invoice.pdf") as parser:
    data = parser.parse_by_template(template)
    if data:
        details = data["Details"].page_area
        print(f"Rows extracted: {details.row_count}")
```

{{< /tab >}}
{{< tab "invoice.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [invoice.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/template-based-parsing/working-with-templates/invoice.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Tips

- Combine regex, fixed, and linked positions in one template to anchor values reliably.  
- Keep field names unique (case-insensitive).  
- Reuse `TemplateTableLayout` when the same table structure appears on multiple pages—see the API reference for layout helpers.  
- If a template item cannot be located, the corresponding field/table is empty; handle `None` in your code.


---

## Working with vCard metadata

Path: /metadata/java/working-with-vcard-metadata/

## What is vCard?

vCard, also known as VCF (Virtual Contact File), is a file format standard for electronic business cards. vCards are often attached to e-mail messages, but can be exchanged in other ways. They can contain name and address information, telephone numbers, e-mail addresses, URLs, logos, photographs, and even audio clips.

{{< alert style="info" >}}For more information on the format please see https://en.wikipedia.org/wiki/VCard{{< /alert >}}

## Getting Simple vCard metadata

To access Metadata in a vCard, GroupDocs.Metadata API provides the [VCardRootPackage.getVCardPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/VCardRootPackage#getVCardPackage())method which contains the information extracted from a file. The following are the steps to access metadata in a vCard:

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a vCard file
2.  Get the root metadata package
3.  Extract  the native metadata package using the [VCardRootPackage.getVCardPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/VCardRootPackage#getVCardPackage())method
4.  Read the extracted vCard fields

The following code snippet gets metadata of a vCard file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>business\_card.VCardReadCardProperties**

```csharp
public static void run() {
	try (Metadata metadata = new Metadata(Constants.InputVcf)) {

		VCardRootPackage root = metadata.getRootPackageGeneric();
		for (VCardCard vCard : root.getVCardPackage().getCards()) {
			System.out.println(vCard.getIdentificationRecordset().getName());
			PrintArray(vCard.getIdentificationRecordset().getFormattedNames());
			PrintArray(vCard.getCommunicationRecordset().getEmails());
			PrintArray(vCard.getCommunicationRecordset().getTelephones());
			PrintArray(vCard.getDeliveryAddressingRecordset().getAddresses());

			// ...
		}
	}
}

private static void PrintArray(String[] values) {
	if (values != null) {
		for (String value : values) {
			System.out.println(value);
		}
	}
}
```

## Getting Metadata with descriptive parameters

The GroupDocs.Metadata API also provides a way to get Metadata from vCards with descriptive parameters.The steps are given below:

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a vCard file
2.  Get the root metadata package
3.  Extract  the native metadata package using [t](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.businesscard/vcardrootpackage/properties/vcardpackage)he [VCardRootPackage.getVCardPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/VCardRootPackage#getVCardPackage())method
4.  Use methods with the Record(s) postfix to get vCard fields along with descriptive parameters

The following code snippet shows how to extract vCard fields along with descriptive parameters.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>business\_card.VCardReadCardPropertiesWithParameters**

```csharp
try (Metadata metadata = new Metadata(Constants.InputVcf)) {
	VCardRootPackage root = metadata.getRootPackageGeneric();
	for (VCardCard vCard : root.getVCardPackage().getCards()) {
		if (vCard.getIdentificationRecordset().getPhotoUriRecords() != null) {

			// Iterate all photos represented by URIs
			for (VCardTextRecord photoUriRecord : vCard.getIdentificationRecordset().getPhotoUriRecords()) {

				// Print the property value
				System.out.println(photoUriRecord.getValue());

				// Print some additional parameters of the property
				System.out.println(photoUriRecord.getContentType());
				System.out.println(photoUriRecord.getMediaTypeParameter());

				if (photoUriRecord.getTypeParameters() != null) {
					for (String parameter : photoUriRecord.getTypeParameters()) {
						System.out.println(parameter);
					}
				}
				System.out.println(photoUriRecord.getPrefParameter());
			}
		}
	}
}
```

## Filtering vCard properties

The GroupDocs.Metadata API provides the ability to filter vCard properties in order to make finding desired information easier. The code sample below demonstrates how to use the filtering feature.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>business\_card.VCardFilterCardProperties**

```csharp
public static void run() {
	try (Metadata metadata = new Metadata(Constants.InputVcf)) {
		VCardRootPackage root = metadata.getRootPackageGeneric();

		for (VCardCard vCard : root.getVCardPackage().getCards()) {
			// Print most preferred work phone numbers and work emails
			VCardCard filtered = vCard.filterWorkTags().filterPreferred();
			PrintArray(filtered.getCommunicationRecordset().getTelephones());
			PrintArray(filtered.getCommunicationRecordset().getEmails());
		}
	}
}

private static void PrintArray(String[] values) {
	if (values != null) {
		for (String value : values) {
			System.out.println(value);
		}
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with vCard metadata

Path: /metadata/net/working-with-vcard-metadata/

## What is vCard?

vCard, also known as VCF (Virtual Contact File), is a file format standard for electronic business cards. vCards are often attached to e-mail messages, but can be exchanged in other ways. They can contain name and address information, telephone numbers, e-mail addresses, URLs, logos, photographs, and even audio clips.

{{< alert style="info" >}}For more information on the format please see https://en.wikipedia.org/wiki/VCard{{< /alert >}}

## Getting Simple vCard metadata

To access Metadata in a vCard, GroupDocs.Metadata API provides the [VCardRootPackage.VCardPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.businesscard/vcardrootpackage/properties/vcardpackage)property which contains the information extracted from a file. The following are the steps to access metadata in a vCard:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a vCard file
2.  Get the root metadata package
3.  Extract  the native metadata package using [VCardRootPackage.VCardPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.businesscard/vcardrootpackage/properties/vcardpackage)
4.  Read the extracted vCard properties

The following code snippet gets metadata of a vCard file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>BusinessCard.VCardReadCardProperties**

```csharp
public static void Run()
{
	using (Metadata metadata = new Metadata(Constants.InputVcf))
	{
		var root = metadata.GetRootPackage<VCardRootPackage>();

		foreach (var vCard in root.VCardPackage.Cards)
		{
			Console.WriteLine(vCard.IdentificationRecordset.Name);
			PrintArray(vCard.IdentificationRecordset.FormattedNames);
			PrintArray(vCard.CommunicationRecordset.Emails);
			PrintArray(vCard.CommunicationRecordset.Telephones);
			PrintArray(vCard.DeliveryAddressingRecordset.Addresses);

			// ...
		}
	}
}

private static void PrintArray(string[] values)
{
	if (values != null)
	{
		foreach (string value in values)
		{
			Console.WriteLine(value);
		}
	}
}
```

## Getting Metadata with descriptive parameters

The GroupDocs.Metadata API also provides a way to get Metadata from vCards with descriptive parameters.The steps are given below:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a vCard file
2.  Get the root metadata package
3.  Extract  the native metadata package using [VCardRootPackage.VCardPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.businesscard/vcardrootpackage/properties/vcardpackage)
4.  Use properties with the Record(s) postfix to get vCard fields along with descriptive parameters

The following code snippet shows how to extract vCard fields along with descriptive parameters.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>BusinessCard.VCardReadCardPropertiesWithParameters**

```csharp
using (Metadata metadata = new Metadata(Constants.InputVcf))
{
	var root = metadata.GetRootPackage<VCardRootPackage>();
	foreach (var vCard in root.VCardPackage.Cards)
	{
		if (vCard.IdentificationRecordset.PhotoUriRecords != null)
		{
			// Iterate all photos represented by URIs
			foreach (var photoUriRecord in vCard.IdentificationRecordset.PhotoUriRecords)
			{
				// Print the property value
				Console.WriteLine(photoUriRecord.Value);

				// Print some additional parameters of the property
				Console.WriteLine(photoUriRecord.ContentType);

				Console.WriteLine(photoUriRecord.MediaTypeParameter);
				if (photoUriRecord.TypeParameters != null)
				{
					foreach (string parameter in photoUriRecord.TypeParameters)
					{
						Console.WriteLine(parameter);
					}
				}

				Console.WriteLine(photoUriRecord.PrefParameter);
			}
		}
	}
}
```

## Filtering vCard properties

The GroupDocs.Metadata API provides the ability to filter vCard properties in order to make finding desired information easier. The code sample below demonstrates hot to use the filtering feature.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>BusinessCard.VCardFilterCardProperties**

```csharp
public static void Run()
{
	using (Metadata metadata = new Metadata(Constants.InputVcf))
	{
		var root = metadata.GetRootPackage<VCardRootPackage>();
		foreach (var vCard in root.VCardPackage.Cards)
		{
			// Print most preferred work phone numbers and work emails
			var filtered = vCard.FilterWorkTags().FilterPreferred();

			PrintArray(filtered.CommunicationRecordset.Telephones);
			PrintArray(filtered.CommunicationRecordset.Emails);
		}
	}
}

private static void PrintArray(string[] values)
{
	if (values != null)
	{
		foreach (string value in values)
		{
			Console.WriteLine(value);
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with XML Data Sources

Path: /assembly/java/working-with-xml-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for Java 19.10 or later releases.{{< /alert >}}

To access XML data while building a report, you can use facilities of *DataSet* to read XML into it and then pass it to the assembler as a data source. However, if your scenario does not permit to specify XML schema while loading XML into *DataSet*, all attributes and text values of XML elements are loaded as strings then. Thus, it becomes impossible, for example, to use arithmetic operations on numbers or to specify custom date-time and numeric formats to output orresponding values, because all of them are treated as strings. To overcome this limitation, you can pass an *XmlDataSource* instance to the assembler as a data source instead. Even when XML schema is not provided, *XmlDataSource* is capable to recognize values of the following types by their string representations:

*   Int32?
*   Int64?
*   Double?
*   Boolean?
*   DateTime?

{{< alert style="warning" >}}For recognition of data types to work, string representations of corresponding attributes and text values of XML elements must be formed using invariant culture settings.{{< /alert >}}

### Treating the top-level XML element contains only a sequence of elements of the same type

In template documents, if a top-level XML element contains only a sequence of elements of the same type, an *XmlDataSource* instance should be treated in the same way as if it was a *DataTable* instance (see "[Working with *DataTable* and *DataView* Objects](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-data-sources)" for more information).

Suppose we have XML data like:
```
<Persons>
   <Person>
      <Name>John Doe</Name>
      <Age>30</Age>
      <Birth>1989-04-01 4:00:00 pm</Birth>
   </Person>
   <Person>
      <Name>Jane Doe</Name>
      <Age>27</Age>
      <Birth>1992-01-31 07:00:00 am</Birth>
   </Person>
   <Person>
      <Name>John Smith</Name>
      <Age>51</Age>
      <Birth>1968-03-08 1:00:00 pm</Birth>
   </Person>
</Persons>
```
By using the template like following:
```
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of
Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Age)]>>
```

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

{{< alert style="warning" >}}Using of the custom date-time format and the extension method involving arithmetic in the template document becomes possible, because text values of Birth and Age XML elements are automatically converted to DateTime? and Int32? respectively even in the absence of XML schema.{{< /alert >}}

### Treating the top-level XML element contains attributes or nested elements of different types

If a top-level XML element contains attributes or nested elements of different types, an *XmlDataSource* instance should be treated in template documents in the same way as if it was a *DataRow* instance (see "[Working with *DataRow* and *DataRowView* Objects](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-data-sources)" for more information) as shown in the following example.

Suppose we have XML data like:
```
<Person>
   <Name>John Doe</Name>
   <Age>30</Age>
   <Birth>1989-04-01 4:00:00 pm</Birth>
   <Child>Ann Doe</Child>
   <Child>Charles Doe</Child>
</Person>
```

By using the template like following:
```
Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth:
<<[Birth]:"dd.MM.yyyy">>
Children:
<<foreach [in Child]>><<[Child_Text]>>
<</foreach>>
```

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Children:
Ann Doe
Charles Doe
```

{{< alert style="warning" >}}To reference a sequence of repeated simple-type XML elements with the same name, the elements’ name itself (for example, "Child") should be used in a template document, whereas the same name with the "_Text" suffix (for example, "Child_Text") should be used to reference the text value of one of these elements.{{< /alert >}}

### The complete example

The following example sums up typical scenarios involving nested complex-type XML elements.

#### XML

```
<Managers>
   <Manager>
      <Name>John Smith</Name>
      <Contract>
         <Client>
            <Name>A Company</Name>
         </Client>
         <Price>1200000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>B Ltd.</Name>
         </Client>
         <Price>750000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>C &amp; D</Name>
         </Client>
         <Price>350000</Price>
      </Contract>
   </Manager>
   <Manager>
      <Name>Tony Anderson</Name>
      <Contract>
         <Client>
            <Name>E Corp.</Name>
         </Client>
         <Price>650000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>F &amp; Partners</Name>
         </Client>
         <Price>550000</Price>
      </Contract>
   </Manager>
   <Manager>
      <Name>July James</Name>
      <Contract>
         <Client>
            <Name>G &amp; Co.</Name>
         </Client>
         <Price>350000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>H Group</Name>
         </Client>
         <Price>250000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>I &amp; Sons</Name>
            43
         </Client>
         <Price>100000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>J Ent.</Name>
         </Client>
         <Price>100000</Price>
      </Contract>
   </Manager>
</Managers>
```

#### Template document

```
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
```

#### Source code

{{< gist GroupDocsGists e77e4434f2a4fc2c6b1bf8276c54333c >}}

#### Result document

```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)
Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)
Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

### Download

#### Data Source Document

*   [Managers.xml](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/XML%20DataSource/Managers.xml?raw=true)

#### Template

*   [SimpleDatasetDemo.docx](attachments/85819663/85917711.docx)

---

## Working with XML Data Sources

Path: /assembly/net/working-with-xml-data-sources/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 19.10 or later releases.{{< /alert >}}

To access XML data while building a report, you can use facilities of *DataSet* to read XML into it and then pass it to the assembler as a data source. However, if your scenario does not permit to specify XML schema while loading XML into *DataSet*, all attributes and text values of XML elements are loaded as strings then. Thus, it becomes impossible, for example, to use arithmetic operations on numbers or to specify custom date-time and numeric formats to output orresponding values, because all of them are treated as strings. To overcome this limitation, you can pass an *XmlDataSource* instance to the assembler as a data source instead. Even when XML schema is not provided, *XmlDataSource* is capable to recognize values of the following types by their string representations:

*   Int32?
*   Int64?
*   Double?
*   Boolean?
*   DateTime?

{{< alert style="warning" >}}For recognition of data types to work, string representations of corresponding attributes and text values of XML elements must be formed using invariant culture settings.{{< /alert >}}

## Treating the top-level XML element contains only a sequence of elements of the same type

In template documents, if a top-level XML element contains only a sequence of elements of the same type, an *XmlDataSource* instance should be treated in the same way as if it was a *DataTable* instance (see "[Working with *DataTable* and *DataView* Objects](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-data-sources)" for more information).

Suppose we have XML data like:
```
<Persons>
   <Person>
      <Name>John Doe</Name>
      <Age>30</Age>
      <Birth>1989-04-01 4:00:00 pm</Birth>
   </Person>
   <Person>
      <Name>Jane Doe</Name>
      <Age>27</Age>
      <Birth>1992-01-31 07:00:00 am</Birth>
   </Person>
   <Person>
      <Name>John Smith</Name>
      <Age>51</Age>
      <Birth>1968-03-08 1:00:00 pm</Birth>
   </Person>
</Persons>
```

By using the template like following:
```
<<foreach \[in persons\]>>Name: <<\[Name\]>>, Age: <<\[Age\]>>, Date of Birth: 
<<\[Birth\]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<\[persons.Average(p => p.Age)\]>>
```

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Name: Jane Doe, Age: 27, Date of Birth: 31.01.1992
Name: John Smith, Age: 51, Date of Birth: 08.03.1968
Average age: 36
```

{{< alert style="warning" >}}Using of the custom date-time format and the extension method involving arithmetic in the template document becomes possible, because text values of Birth and Age XML elements are automatically converted to DateTime? and Int32? respectively even in the absence of XML schema.{{< /alert >}}

## Treating the top-level XML element contains attributes or nested elements of different types

If a top-level XML element contains attributes or nested elements of different types, an *XmlDataSource* instance should be treated in template documents in the same way as if it was a *DataRow* instance (see "[Working with *DataRow* and *DataRowView* Objects](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-data-sources)" for more information) as shown in the following example.

Suppose we have XML data like:
```
<Person>
   <Name>John Doe</Name>
   <Age>30</Age>
   <Birth>1989-04-01 4:00:00 pm</Birth>
   <Child>Ann Doe</Child>
   <Child>Charles Doe</Child>
</Person>
```

By using the template like following:
```
Name: <<\[Name\]>>, Age: <<\[Age\]>>, Date of Birth:
<<\[Birth\]:"dd.MM.yyyy">>
Children:
<<foreach \[in Child\]>><<\[Child\_Text\]>>
<</foreach>>
```

The results will be produced like:
```
Name: John Doe, Age: 30, Date of Birth: 01.04.1989
Children:
Ann Doe
Charles Doe
```

{{< alert style="warning" >}}To reference a sequence of repeated simple-type XML elements with the same name, the elements’ name itself (for example, "Child") should be used in a template document, whereas the same name with the "_Text" suffix (for example, "Child_Text") should be used to reference the text value of one of these elements.{{< /alert >}}

## The complete example

The following example sums up typical scenarios involving nested complex-type XML elements.

### XML
```
<Managers>
   <Manager>
      <Name>John Smith</Name>
      <Contract>
         <Client>
            <Name>A Company</Name>
         </Client>
         <Price>1200000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>B Ltd.</Name>
         </Client>
         <Price>750000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>C &amp; D</Name>
         </Client>
         <Price>350000</Price>
      </Contract>
   </Manager>
   <Manager>
      <Name>Tony Anderson</Name>
      <Contract>
         <Client>
            <Name>E Corp.</Name>
         </Client>
         <Price>650000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>F &amp; Partners</Name>
         </Client>
         <Price>550000</Price>
      </Contract>
   </Manager>
   <Manager>
      <Name>July James</Name>
      <Contract>
         <Client>
            <Name>G &amp; Co.</Name>
         </Client>
         <Price>350000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>H Group</Name>
         </Client>
         <Price>250000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>I &amp; Sons</Name>
            43
         </Client>
         <Price>100000</Price>
      </Contract>
      <Contract>
         <Client>
            <Name>J Ent.</Name>
         </Client>
         <Price>100000</Price>
      </Contract>
   </Manager>
</Managers>
```

### Template document
```
<<foreach \[in managers\]>>Manager: <<\[Name\]>>
Contracts:
<<foreach \[in Contract\]>>- <<\[Client.Name\]>> ($<<\[Price\]>>)
<</foreach>>
<</foreach>>
```

### Source code

{{< gist GroupDocsGists ddac17d9a69c71495b2931ca6c7e8ce7 >}}

### Result document
```
Manager: John Smith
Contracts:
- A Company ($1200000)
- B Ltd. ($750000)
- C & D ($350000)
Manager: Tony Anderson
Contracts:
- E Corp. ($650000)
- F & Partners ($550000)
Manager: July James
Contracts:
- G & Co. ($350000)
- H Group ($250000)
- I & Sons ($100000)
- J Ent. ($100000)
```

## Download

### Data Source Document

*   [Managers.xml](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/XML%20DataSource/Managers.xml?raw=true)

### Template

*   [Demo Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Using%20Spreadsheet%20as%20Table%20of%20Data.docx?raw=true)

---

## Working with XMP metadata

Path: /metadata/java/working-with-xmp-metadata/

## What is XMP?

The Extensible Metadata Platform (XMP) is an XML-based ISO metadata standard, originally created by Adobe Systems Inc. It defines a data structure, serialization model and basic metadata properties intended to form a unified metadata package that can be embedded into different media formats. The defined XMP data model can be used to store any set of metadata properties. These can be simple name/value pairs, structured values or lists of values. The data can be nested as well.

{{< alert style="info" >}}Please find more information on the XMP standard at https://en.wikipedia.org/wiki/Extensible_Metadata_Platform{{< /alert >}}

## Reading XMP properties

To access XMP metadata in a file of any supported format, GroupDocs.Metadata provides the [IXmp.getXmpPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IXmp#getXmpPackage()) method. The following are the steps to read XMP metadata:

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains XMP metadata
2.  Extract the XMP metadata package using the [IXmp.getXmpPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IXmp#getXmpPackage()) method

The following code snippet gets XMP properties of a PNG image and displays them on the screen. 

**advanced\_usage.working\_with\_metadata\_standards.xmp.ReadXmpProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.PngWithXmp)) {
	IXmp root = (IXmp) metadata.getRootPackage();

	if (root.getXmpPackage() != null) {
		if (root.getXmpPackage().getSchemes().getXmpBasic() != null) {
			System.out.println(root.getXmpPackage().getSchemes().getXmpBasic().getCreatorTool());
			System.out.println(root.getXmpPackage().getSchemes().getXmpBasic().getCreateDate());
			System.out.println(root.getXmpPackage().getSchemes().getXmpBasic().getModifyDate());
			System.out.println(root.getXmpPackage().getSchemes().getXmpBasic().getLabel());
			System.out.println(root.getXmpPackage().getSchemes().getXmpBasic().getNickname());

			// ...
		}

		if (root.getXmpPackage().getSchemes().getDublinCore() != null) {
			System.out.println(root.getXmpPackage().getSchemes().getDublinCore().getFormat());
			System.out.println(root.getXmpPackage().getSchemes().getDublinCore().getCoverage());
			System.out.println(root.getXmpPackage().getSchemes().getDublinCore().getIdentifier());
			System.out.println(root.getXmpPackage().getSchemes().getDublinCore().getSource());

			// ...
		}

		if (root.getXmpPackage().getSchemes().getPhotoshop() != null) {
			System.out.println(root.getXmpPackage().getSchemes().getPhotoshop().getColorMode());
			System.out.println(root.getXmpPackage().getSchemes().getPhotoshop().getIccProfile());
			System.out.println(root.getXmpPackage().getSchemes().getPhotoshop().getCountry());
			System.out.println(root.getXmpPackage().getSchemes().getPhotoshop().getCity());
			System.out.println(root.getXmpPackage().getSchemes().getPhotoshop().getDateCreated());

			// ...
		}

		// ...
	}
}
```

Here is a full list of supported XMP schemes:

*   [XmpBasicJobTicketPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpBasicJobTicketPackage)
*   [XmpBasicPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpBasicPackage)
*   [XmpCameraRawPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpCameraRawPackage)
*   [XmpDublinCorePackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpDublinCorePackage)
*   [XmpDynamicMediaPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpDynamicMediaPackage)
*   [XmpIptcCorePackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpIptcCorePackage)
*   [XmpIptcExtensionPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpIptcExtensionPackage)
*   [XmpIptcIimPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpIptcIimPackage)
*   [XmpMediaManagementPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpMediaManagementPackage)
*   [XmpPagedTextPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpPagedTextPackage)
*   [XmpPdfPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpPdfPackage)
*   [XmpPhotoshopPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpPhotoshopPackage)
*   [XmpRightsManagementPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpRightsManagementPackage)

{{< alert style="info" >}}GroupDocs.Metadata also provides an API allowing users to work with fully custom XMP schemes/packages. Please refer to this code snippet to learn more.{{< /alert >}}

## Updating XMP properties

The GroupDocs.Metadata API facilitates the user to update XMP metadata in a convenient way - using the [XmpPacketWrapper](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/XmpPacketWrapper) class methods. Follow the below steps to update XMP metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains XMP metadata
2.  Extract the XMP metadata package using the [IXmp.getXmpPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IXmp#getXmpPackage()) method
3.  Assign values to desired XMP properties
4.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.working\_with\_metadata\_standards.xmp.UpdateXmpProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.GifWithXmp)) {
	IXmp root = (IXmp) metadata.getRootPackage();
	
	if (root.getXmpPackage() != null) {
		// if there is no such scheme in the XMP package we should create it
		if (root.getXmpPackage().getSchemes().getDublinCore() == null) {
			root.getXmpPackage().getSchemes().setDublinCore(new XmpDublinCorePackage());
		}

		root.getXmpPackage().getSchemes().getDublinCore().setFormat("image/gif");
		root.getXmpPackage().getSchemes().getDublinCore().setRights("Copyright (C) 2011-2020 GroupDocs. All Rights Reserved");
		root.getXmpPackage().getSchemes().getDublinCore().setSubject("test");

		if (root.getXmpPackage().getSchemes().getCameraRaw() == null) {
			root.getXmpPackage().getSchemes().setCameraRaw(new XmpCameraRawPackage());
		}
		
		root.getXmpPackage().getSchemes().getCameraRaw().setShadows(50);
		root.getXmpPackage().getSchemes().getCameraRaw().setAutoBrightness(true);
		root.getXmpPackage().getSchemes().getCameraRaw().setAutoExposure(true);
		root.getXmpPackage().getSchemes().getCameraRaw().setCameraProfile("test");
		root.getXmpPackage().getSchemes().getCameraRaw().setExposure(0.0001);

		// If you don't want to keep the old values just replace the whole scheme
		root.getXmpPackage().getSchemes().setXmpBasic(new XmpBasicPackage());
		root.getXmpPackage().getSchemes().getXmpBasic().setCreateDate(new Date());
		root.getXmpPackage().getSchemes().getXmpBasic().setBaseUrl("https://groupdocs.com");
		root.getXmpPackage().getSchemes().getXmpBasic().setRating(5);
		root.getXmpPackage().getSchemes().setBasicJobTicket(new XmpBasicJobTicketPackage());

		// Set a complex type property
		XmpJob job = new XmpJob();
		job.setID("1");
		job.setName("test job");
		job.setUrl("https://groupdocs.com");
		root.getXmpPackage().getSchemes().getBasicJobTicket().setJobs(new XmpJob[]{job});

		// ...

		metadata.save(Constants.OutputGif);
	}
}
```

## Adding a custom XMP package

The GroupDocs.Metadata API provides access to a number of commonly used XMP schemes. But it also allows you to create fully custom XMP packages containing user-defined properties. The example below demonstrates how to create and add a custom XMP package to a file.

**advanced\_usage.working\_with\_metadata\_standards.xmp.AddCustomXmpPackage**

```csharp
try (Metadata metadata = new Metadata(Constants.InputJpeg)) {

	IXmp root = (IXmp) metadata.getRootPackage();
	XmpPacketWrapper packet = new XmpPacketWrapper();

	XmpPackage custom = new XmpPackage("gd", "https://groupdocs.com");
	custom.set("gd:Copyright", "Copyright (C) 2011-2020 GroupDocs. All Rights Reserved.");
	custom.set("gd:CreationDate", new Date());
	custom.set("gd:Company", XmpArray.from(new String[]{"Aspose", "GroupDocs"}, XmpArrayType.Ordered));

	packet.addPackage(custom);
	root.setXmpPackage(packet);
	metadata.save(Constants.OutputJpeg);
}
```

## Removing XMP metadata

To remove the XMP package from a file just pass null to the [IXmp.setXmpPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/IXmp#setXmpPackage(com.groupdocs.metadata.core.XmpPacketWrapper)) method as a parameter. The code sample below shows how to remove XMP metadata from a file.

**advanced\_usage.working\_with\_metadata\_standards.xmp.AddCustomXmpPackage**

```csharp
try (Metadata metadata = new Metadata(Constants.JpegWithXmp)) {
	IXmp root = (IXmp) metadata.getRootPackage();
	root.setXmpPackage(null);
	metadata.save(Constants.OutputJpeg);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with XMP metadata

Path: /metadata/net/working-with-xmp-metadata/

## What is XMP?

The Extensible Metadata Platform (XMP) is an XML-based ISO metadata standard, originally created by Adobe Systems Inc. It defines a data structure, serialization model and basic metadata properties intended to form a unified metadata package that can be embedded into different media formats. The defined XMP data model can be used to store any set of metadata properties. These can be simple name/value pairs, structured values or lists of values. The data can be nested as well.

{{< alert style="info" >}}Please find more information on the XMP standard at https://en.wikipedia.org/wiki/Extensible_Metadata_Platform{{< /alert >}}

## Reading XMP properties

To access XMP metadata in a file of any supported format, GroupDocs.Metadata provides the [IXmp.XmpPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp/ixmp/properties/xmppackage) property. The following are the steps to read XMP metadata:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains XMP metadata
2.  Extract the XMP metadata package using the [IXmp.XmpPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp/ixmp/properties/xmppackage) property

The following code snippet gets XMP properties of a PNG image and displays them on the screen. 

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Xmp.ReadXmpProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.PngWithXmp))
{
	IXmp root = metadata.GetRootPackage() as IXmp;
	if (root != null && root.XmpPackage != null)
	{
		if (root.XmpPackage.Schemes.XmpBasic != null)
		{
			Console.WriteLine(root.XmpPackage.Schemes.XmpBasic.CreatorTool);
			Console.WriteLine(root.XmpPackage.Schemes.XmpBasic.CreateDate);
			Console.WriteLine(root.XmpPackage.Schemes.XmpBasic.ModifyDate);
			Console.WriteLine(root.XmpPackage.Schemes.XmpBasic.Label);
			Console.WriteLine(root.XmpPackage.Schemes.XmpBasic.Nickname);

			// ...
		}

		if (root.XmpPackage.Schemes.DublinCore != null)
		{
			Console.WriteLine(root.XmpPackage.Schemes.DublinCore.Format);
			Console.WriteLine(root.XmpPackage.Schemes.DublinCore.Coverage);
			Console.WriteLine(root.XmpPackage.Schemes.DublinCore.Identifier);
			Console.WriteLine(root.XmpPackage.Schemes.DublinCore.Source);

			// ...
		}

		if (root.XmpPackage.Schemes.Photoshop != null)
		{
			Console.WriteLine(root.XmpPackage.Schemes.Photoshop.ColorMode);
			Console.WriteLine(root.XmpPackage.Schemes.Photoshop.IccProfile);
			Console.WriteLine(root.XmpPackage.Schemes.Photoshop.Country);
			Console.WriteLine(root.XmpPackage.Schemes.Photoshop.City);
			Console.WriteLine(root.XmpPackage.Schemes.Photoshop.DateCreated);

			// ... 
		}

		// ...
	}
}
```

Here is a full list of supported XMP schemes:

*   [XmpBasicJobTicketPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpbasicjobticketpackage)
*   [XmpBasicPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpbasicpackage)
*   [XmpCameraRawPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpcamerarawpackage)
*   [XmpDublinCorePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpdublincorepackage)
*   [XmpDynamicMediaPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpdynamicmediapackage)
*   [XmpIptcCorePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpiptccorepackage)
*   [XmpIptcExtensionPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpiptcextensionpackage)
*   [XmpIptcIimPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpiptciimpackage)
*   [XmpMediaManagementPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpmediamanagementpackage)
*   [XmpPagedTextPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmppagedtextpackage)
*   [XmpPdfPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmppdfpackage)
*   [XmpPhotoshopPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmpphotoshoppackage)
*   [XmpRightsManagementPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp.schemes/xmprightsmanagementpackage)

{{< alert style="info" >}}GroupDocs.Metadata also provides an API allowing users to work with fully custom XMP schemes/packages. Please refer to this code snippet to learn more.{{< /alert >}}

## Updating XMP properties

The GroupDocs.Metadata API facilitates the user to update XMP metadata in a convenient way - using the [XmpPacketWrapper](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp/xmppacketwrapper) class properties. Follow the below steps to update XMP metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains XMP metadata
2.  Extract the XMP metadata package using the [IXmp.XmpPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp/ixmp/properties/xmppackage) property
3.  Assign values to desired XMP properties
4.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Xmp.UpdateXmpProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.GifWithXmp))
{
	IXmp root = metadata.GetRootPackage() as IXmp;
	if (root != null && root.XmpPackage != null)
	{
		// if there is no such scheme in the XMP package we should create it
		if (root.XmpPackage.Schemes.DublinCore == null)
		{
			root.XmpPackage.Schemes.DublinCore = new XmpDublinCorePackage();
		}
		root.XmpPackage.Schemes.DublinCore.Format = "image/gif";
		root.XmpPackage.Schemes.DublinCore.SetRights("Copyright (C) 2011-2019 GroupDocs. All Rights Reserved");
		root.XmpPackage.Schemes.DublinCore.SetSubject("test");

		if (root.XmpPackage.Schemes.CameraRaw == null)
		{
			root.XmpPackage.Schemes.CameraRaw = new XmpCameraRawPackage();
		}
		root.XmpPackage.Schemes.CameraRaw.Shadows = 50;
		root.XmpPackage.Schemes.CameraRaw.AutoBrightness = true;
		root.XmpPackage.Schemes.CameraRaw.AutoExposure = true;
		root.XmpPackage.Schemes.CameraRaw.CameraProfile = "test";
		root.XmpPackage.Schemes.CameraRaw.Exposure = 0.0001;

		// If you don't want to keep the old values just replace the whole scheme
		root.XmpPackage.Schemes.XmpBasic = new XmpBasicPackage();
		root.XmpPackage.Schemes.XmpBasic.CreateDate = DateTime.Today;
		root.XmpPackage.Schemes.XmpBasic.BaseUrl = "https://groupdocs.com";
		root.XmpPackage.Schemes.XmpBasic.Rating = 5;
		root.XmpPackage.Schemes.BasicJobTicket = new XmpBasicJobTicketPackage();

		// Set a complex type property
		root.XmpPackage.Schemes.BasicJobTicket.Jobs = new[]
		{
			new XmpJob
			{
				ID = "1",
				Name = "test job",
				Url = "https://groupdocs.com"
			},
		};

		// ... 

		metadata.Save(Constants.OutputGif);
	}
}
```

## Adding a custom XMP package

The GroupDocs.Metadata API provides access to a number of commonly used XMP schemes. But it also allows you to create fully custom XMP packages containing user-defined properties. The example below demonstrates how to create and add a custom XMP package to a file.

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Xmp.AddCustomXmpPackage**

```csharp
using (Metadata metadata = new Metadata(Constants.InputJpeg))
{
	IXmp root = metadata.GetRootPackage() as IXmp;
	if (root != null)
	{
		var packet = new XmpPacketWrapper();
		
		var custom = new XmpPackage("gd", "https://groupdocs.com");
		custom.Set("gd:Copyright", "Copyright (C) 2011-2019 GroupDocs. All Rights Reserved.");
		custom.Set("gd:CreationDate", DateTime.Today);
		custom.Set("gd:Company", XmpArray.From(new [] { "Aspose", "GroupDocs" }, XmpArrayType.Ordered));
		packet.AddPackage(custom);

		root.XmpPackage = packet;

		metadata.Save(Constants.OutputJpeg);
	}
}
```

## Removing XMP metadata

To remove the XMP package from a file just assign null to the [IXmp.XmpPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.xmp/ixmp/properties/xmppackage) property. The code sample below shows how to remove XMP metadata from a file.

**AdvancedUsage.WorkingWithMetadataStandards.<WBR>Xmp.AddCustomXmpPackage**

```csharp
using (Metadata metadata = new Metadata(Constants.JpegWithXmp))
{
	IXmp root = metadata.GetRootPackage() as IXmp;
	if (root != null)
	{
		root.XmpPackage = null;

		metadata.Save(Constants.OutputJpeg);
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with XMP metadata

Path: /metadata/nodejs-java/working-with-xmp-metadata/

## What is XMP?

The Extensible Metadata Platform (XMP) is an XML-based ISO metadata standard, originally created by Adobe Systems Inc. It defines a data structure, serialization model and basic metadata properties intended to form a unified metadata package that can be embedded into different media formats. The defined XMP data model can be used to store any set of metadata properties. These can be simple name/value pairs, structured values or lists of values. The data can be nested as well.

{{< alert style="info" >}}Please find more information on the XMP standard at https://en.wikipedia.org/wiki/Extensible_Metadata_Platform{{< /alert >}}

## Reading XMP properties

To access XMP metadata in a file of any supported format, GroupDocs.Metadata provides the **IXmp.getXmpPackage** method. The following are the steps to read XMP metadata:

1.  **Load** a file that contains XMP metadata
2.  Extract the XMP metadata package using the **IXmp.getXmpPackage** method

The following code snippet gets XMP properties of a PNG image and displays them on the screen. 

**advanced\_usage.working\_with\_metadata\_standards.xmp.ReadXmpProperties**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata(Constants.PngWithXmp);
    var root = metadata.getRootPackage();
            if (root.getXmpPackage() != null) {
                if (root.getXmpPackage().getSchemes().getXmpBasic() != null) {
                    console.log(root.getXmpPackage().getSchemes().getXmpBasic().getCreatorTool());
                    console.log(root.getXmpPackage().getSchemes().getXmpBasic().getCreateDate());
                }

                if (root.getXmpPackage().getSchemes().getDublinCore() != null) {
                    console.log(root.getXmpPackage().getSchemes().getDublinCore().getFormat());
                    console.log(root.getXmpPackage().getSchemes().getDublinCore().getCoverage());
                }

                if (root.getXmpPackage().getSchemes().getPhotoshop() != null) {
                    console.log(root.getXmpPackage().getSchemes().getPhotoshop().getColorMode());
                    console.log(root.getXmpPackage().getSchemes().getPhotoshop().getIccProfile());
                }
            }
```
{{< /tab >}}
{{< /tabs >}}

Here is a full list of supported XMP schemes:

*   __mpBasicJobTicketPackage__
*   __mpBasicPackage__
*   __mpCameraRawPackage__
*   __mpDublinCorePackage__
*   __mpDynamicMediaPackage__
*   __mpIptcCorePackage__
*   __mpIptcExtensionPackage__
*   __mpIptcIimPackage__
*   __mpMediaManagementPackage__
*   __mpPagedTextPackage__
*   __mpPdfPackage__
*   __mpPhotoshopPackage__
*   __mpRightsManagementPackage__

{{< alert style="info" >}}GroupDocs.Metadata also provides an API allowing users to work with fully custom XMP schemes/packages. Please refer to this code snippet to learn more.{{< /alert >}}

## Removing XMP metadata

To remove the XMP package from a file just pass null to the **IXmp.setXmpPackage** method as a parameter. The code sample below shows how to remove XMP metadata from a file.

**advanced\_usage.working\_with\_metadata\_standards.xmp.AddCustomXmpPackage**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
 const metadata = new groupdocs.metadata.Metadata(Constants.JpegWithXmp);
    var root = metadata.getRootPackage();
    root.setXmpPackage(null);
    metadata.save(Constants.OutputJpeg);
}
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with XMP metadata

Path: /metadata/python-net/working-with-xmp-metadata/

## What is XMP?

The Extensible Metadata Platform (XMP) is an XML-based ISO metadata standard, originally created by Adobe Systems Inc. It defines a data structure, serialization model and basic metadata properties intended to form a unified metadata package that can be embedded into different media formats. The defined XMP data model can be used to store any set of metadata properties. These can be simple name/value pairs, structured values or lists of values. The data can be nested as well.

{{< alert style="info" >}}Please find more information on the XMP standard at https://en.wikipedia.org/wiki/Extensible_Metadata_Platform{{< /alert >}}

## Reading XMP properties

To access XMP metadata in a file of any supported format, GroupDocs.Metadata provides the `IXmp.xmp_package` property. The following are the steps to read XMP metadata:

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains XMP metadata
2.  Extract the XMP metadata package using the `IXmp.xmp_package` property

The following code snippet gets XMP properties of a PNG image and displays them on the screen. 

**advanced_usage.working_with_metadata_standards.xmp.read_xmp_properties**


```python
def run():
    with gm.Metadata(constants.png_with_xmp) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "xmp_package") and root.xmp_package is not None:
            if root.xmp_package.schemes.xmp_basic is not None:
                print(root.xmp_package.schemes.xmp_basic.creator_tool)
                print(root.xmp_package.schemes.xmp_basic.create_date)
                print(root.xmp_package.schemes.xmp_basic.modify_date)
                print(root.xmp_package.schemes.xmp_basic.label)
                print(root.xmp_package.schemes.xmp_basic.nickname)

                # ...

            if root.xmp_package.schemes.dublin_core is not None:
                print(root.xmp_package.schemes.dublin_core.format)
                print(root.xmp_package.schemes.dublin_core.coverage)
                print(root.xmp_package.schemes.dublin_core.identifier)
                print(root.xmp_package.schemes.dublin_core.source)

                # ...

            if root.xmp_package.schemes.photoshop is not None:
                print(root.xmp_package.schemes.photoshop.color_mode)
                print(root.xmp_package.schemes.photoshop.icc_profile)
                print(root.xmp_package.schemes.photoshop.country)
                print(root.xmp_package.schemes.photoshop.city)
                print(root.xmp_package.schemes.photoshop.date_created)

                # ...
```


Here is a non-exhaustive list of supported XMP schemes:

*   XmpBasicJobTicketPackage
*   XmpBasicPackage
*   XmpCameraRawPackage
*   XmpDublinCorePackage
*   XmpDynamicMediaPackage
*   XmpIptcCorePackage
*   XmpIptcExtensionPackage
*   XmpIptcIimPackage
*   XmpMediaManagementPackage
*   XmpPagedTextPackage
*   XmpPdfPackage
*   XmpPhotoshopPackage
*   XmpRightsManagementPackage

{{< alert style="info" >}}GroupDocs.Metadata also provides an API allowing users to work with fully custom XMP schemes/packages.{{< /alert >}}

## Updating XMP properties

The GroupDocs.Metadata API facilitates the user to update XMP metadata in a convenient way - using the `XmpPacketWrapper` class properties. Follow the below steps to update XMP metadata in a file of any supported format.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file that contains XMP metadata
2.  Extract the XMP metadata package using the `IXmp.xmp_package` property
3.  Assign values to desired XMP properties
4.  [Save]({{< ref "metadata/python-net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced_usage.working_with_metadata_standards.xmp.update_xmp_properties**


```python
def run():
    with gm.Metadata(constants.gif_with_xmp) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "xmp_package") and root.xmp_package is not None:
            # if there is no such scheme in the XMP package we should create it
            if root.xmp_package.schemes.dublin_core is None:
                root.xmp_package.schemes.dublin_core = gm.standards.xmp.schemes.XmpDublinCorePackage()
            root.xmp_package.schemes.dublin_core.format = "image/gif"
            root.xmp_package.schemes.dublin_core.set_rights("Copyright (C) 2011-2019 GroupDocs. All Rights Reserved")
            root.xmp_package.schemes.dublin_core.set_subject("test")

            if root.xmp_package.schemes.camera_raw is None:
                root.xmp_package.schemes.camera_raw = gm.standards.xmp.schemes.XmpCameraRawPackage()
            root.xmp_package.schemes.camera_raw.shadows = 50
            root.xmp_package.schemes.camera_raw.auto_brightness = True
            root.xmp_package.schemes.camera_raw.auto_exposure = True
            root.xmp_package.schemes.camera_raw.camera_profile = "test"
            root.xmp_package.schemes.camera_raw.exposure = 0.0001

            # If you don't want to keep the old values just replace the whole scheme
            root.xmp_package.schemes.xmp_basic = gm.standards.xmp.schemes.XmpBasicPackage()
            root.xmp_package.schemes.xmp_basic.create_date = date.today()
            root.xmp_package.schemes.xmp_basic.base_url = "https://groupdocs.com"
            root.xmp_package.schemes.xmp_basic.rating = 5
            root.xmp_package.schemes.basic_job_ticket = gm.standards.xmp.schemes.XmpBasicJobTicketPackage()

            # Set a complex type property
            root.xmp_package.schemes.basic_job_ticket.jobs = [
                gm.standards.xmp.XmpJob(
                    id="1",
                    name="test job",
                    url="https://groupdocs.com"
                )
            ]

            # ...

            metadata.save(constants.output_gif)
```


## Adding a custom XMP package

The GroupDocs.Metadata API provides access to a number of commonly used XMP schemes. But it also allows you to create fully custom XMP packages containing user-defined properties. The example below demonstrates how to create and add a custom XMP package to a file.

**advanced_usage.working_with_metadata_standards.xmp.add_custom_xmp_package**


```python
def run():
    with gm.Metadata(constants.input_jpeg) as metadata:
        root = metadata.get_root_package()
        packet = gm.standards.xmp.XmpPacketWrapper()

        custom = gm.standards.xmp.XmpPackage("gd", "https://groupdocs.com")
        custom.set("gd:Copyright", "Copyright (C) 2011-2019 GroupDocs. All Rights Reserved.")
        custom.set("gd:CreationDate", date.today())
        custom.set("gd:Company", gm.standards.xmp.XmpArray.from_array(["Aspose", "GroupDocs"], gm.standards.xmp.XmpArrayType.ORDERED))
        packet.add_package(custom)

        root.xmp_package = packet

        metadata.save(constants.output_jpeg)
```


## Removing XMP metadata

To remove the XMP package from a file just assign `None` to the `IXmp.xmp_package` property. The code sample below shows how to remove XMP metadata from a file.

**advanced_usage.working_with_metadata_standards.xmp.remove_xmp_metadata**


```python
def run():
    with gm.Metadata(constants.jpeg_with_xmp) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "xmp_package"):
            root.xmp_package = None
            metadata.save(constants.output_jpeg)
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Xlsx to Md

Path: /markdown/net/convert/export-spreadsheet/


Use GroupDocs.Markdown to convert XLSX and other spreadsheet files to Markdown tables. You can control how many columns and rows are included using spreadsheet-specific options.

### Using static method

The simplest way to convert a spreadsheet file:

{{< tabs "export-spreadsheet-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Set license (optional)
if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

// Convert XLSX to Markdown string
string markdown = MarkdownConverter.ToMarkdown("cost-analysis.xlsx");

// Or save directly to a file
MarkdownConverter.ToFile("cost-analysis.xlsx", "export-spreadsheet-static.md");
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-spreadsheet-static.md" >}}  
```text
## Summary

| Category | FY2024 | FY2025 | FY2026 |
| --- | --- | --- | --- |
| Parts and materials | $1,325,000.00 | $1,480,000.00 | $1,620,000.00 |
| Manufacturing equipment | $900,500.00 | $980,000.00 | $1,050,000.00 |
| Warehousing | $420,000.00 | $510,000.00 | $590,000.00 |
| Shipping | $380,000.00 | $445,000.00 | $520,000.00 |
| Marketing | $250,000.00 | $340,000.00 | $480,000.00 |
| R&D | $180,000.00 | $230,000.00 | $310,000.00 |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-spreadsheet/ExportSpreadsheetStatic/export-spreadsheet-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API. The `ConvertOptions` class provides spreadsheet-specific properties such as `MaxColumns` and `MaxRows` to limit the size of the exported tables:

{{< tabs "export-spreadsheet-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

using var converter = new MarkdownConverter("cost-analysis.xlsx");
var options = new ConvertOptions
{
    MaxColumns = 10,
    MaxRows = 100,
    HeadingLevelOffset = 1
};

converter.Convert("export-spreadsheet-instance.md", options);
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-spreadsheet-instance.md" >}}  
```text
## Summary

| Category | FY2024 | FY2025 | FY2026 |
| --- | --- | --- | --- |
| Parts and materials | $1,325,000.00 | $1,480,000.00 | $1,620,000.00 |
| Manufacturing equipment | $900,500.00 | $980,000.00 | $1,050,000.00 |
| Warehousing | $420,000.00 | $510,000.00 | $590,000.00 |
| Shipping | $380,000.00 | $445,000.00 | $520,000.00 |
| Marketing | $250,000.00 | $340,000.00 | $480,000.00 |
| R&D | $180,000.00 | $230,000.00 | $310,000.00 |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-spreadsheet/ExportSpreadsheetInstance/export-spreadsheet-instance.md)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/net/getting-started/supported-document-formats" >}}).

---

## Xlsx to Md

Path: /markdown/python-net/convert/export-spreadsheet/


Use GroupDocs.Markdown to convert XLSX and other spreadsheet files to Markdown tables. You can control how many columns and rows are included using spreadsheet-specific options.

### Using static method

The simplest way to convert a spreadsheet file:

{{< tabs "export-spreadsheet-static">}}
{{< tab "export_spreadsheet_to_markdown.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter

def export_spreadsheet_to_markdown():
    """Convert an Excel spreadsheet to Markdown using the static one-liner API."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Convert XLSX to a Markdown string in one call
    markdown = MarkdownConverter.to_markdown("cost-analysis.xlsx")

    # Step 3: Or save the conversion result directly to a file
    MarkdownConverter.to_file("cost-analysis.xlsx", "export-spreadsheet.md")

if __name__ == "__main__":
    export_spreadsheet_to_markdown()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-spreadsheet.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-spreadsheet/export_spreadsheet_to_markdown/export-spreadsheet.txt)
{{< /tab >}}
{{< tab "export-spreadsheet.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-spreadsheet/export_spreadsheet_to_markdown/export-spreadsheet.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API. The `ConvertOptions` class provides spreadsheet-specific properties such as `max_columns` and `max_rows` to limit the size of the exported tables:

{{< tabs "export-spreadsheet-instance">}}
{{< tab "export_spreadsheet_with_options.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter, ConvertOptions

def export_spreadsheet_with_options():
    """Convert an Excel spreadsheet to Markdown with column/row limits and heading offset."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Open the spreadsheet with a context manager
    with MarkdownConverter("cost-analysis.xlsx") as converter:
        # Step 3: Configure spreadsheet-specific conversion options
        options = ConvertOptions()
        options.max_columns = 10   # limit to first 10 columns
        options.max_rows = 100     # limit to first 100 data rows per sheet
        options.heading_level_offset = 1  # shift headings down one level

        # Step 

        # Step 4: Convert and save the Markdown output
        converter.convert("export-spreadsheet-options.md", convert_options=options)

if __name__ == "__main__":
    export_spreadsheet_with_options()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-spreadsheet-options.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-spreadsheet/export_spreadsheet_with_options/export-spreadsheet-options.txt)
{{< /tab >}}
{{< tab "export-spreadsheet-options.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-spreadsheet/export_spreadsheet_with_options/export-spreadsheet-options.txt)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/python-net/getting-started/supported-document-formats" >}}).

---

## Verify QR-code signatures in the document

Path: /signature/java/verify-qr-code-signatures-in-the-document/

**[GroupDocs.Signature](https://products.groupdocs.com/signature/java)** provides [QrCodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/QrCodeVerifyOptions) class to specify different options for verification of QR-code signatures.

Here are the steps to verify qr-code signature within the document with GroupDocs.Signature for Java API:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate the [QrCodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/QrCodeVerifyOptions) object according to your requirements and specify verification options  
    
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/QrCodeVerifyOptions) to it.
    

  

This example shows how to verify QR-code signature in the document.

```java
Signature signature = new Signature("sample.pdf");
QrCodeVerifyOptions options = new QrCodeVerifyOptions();
options.setAllPages(true); // this value is set by default
options.setText("John");
options.setMatchType(TextMatchType.Contains);
 
// verify document signatures
VerificationResult result = signature.verify(options);
if (result.isValid())
{
    System.out.print("\nDocument was verified successfully!");
}
else
{
    System.out.print("\nDocument failed verification process.");
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verify QR-code signatures in the document

Path: /signature/net/verify-qr-code-signatures-in-the-document/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodeverifyoptions) class to specify different options for verification of QR-code signatures.

Here are the steps to verify qr-code signature within the document with GroupDocs.Signature for .NET API:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodeverifyoptions) object according to your requirements and specify verification options
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodeverifyoptions) to it.

This example shows how to verify QR-code signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    QrCodeVerifyOptions options = new QrCodeVerifyOptions()
    {
        AllPages = true, // this value is set by default
        Text = "John",
        MatchType = TextMatchType.Contains
        // set encode type
        // if this value is not set any barcode type will be valid
        EncodeType = QrCodeTypes.QR
    };
    // verify document signatures
    VerificationResult result = signature.Verify(options);
    if (result.IsValid)
    {
        Console.WriteLine("\nDocument was verified successfully!");
    }
    else
    {
        Console.WriteLine("\nDocument failed verification process.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify QR-code signatures in the document

Path: /signature/nodejs-java/verify-qr-code-signatures-in-the-document/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodeverifyoptions) class to specify different options for verification of QR-code signatures.

Here are the steps to verify a QR-code signature within the document using GroupDocs.Signature for Node.Js via Java API:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodeverifyoptions) object according to your requirements and specify verification options.
* Call the [Verify](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/verify) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodeverifyoptions) to it.
This example shows how to verify QR-code signature in the document.

```csharp
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; // Assuming Constants.SAMPLE_SIGNED_MULTI is defined elsewhere

  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize QrCodeVerifyOptions
  const options = new signatureLib.QrCodeVerifyOptions();
  options.setAllPages(true); // this value is set by default
  options.setText('John');
  options.setMatchType(signatureLib.TextMatchType.Contains);

  // Verify document signatures
  const result = signature.verify(options);

  if (result.isValid()) {
    console.log('\nDocument was verified successfully!');
  } else {
    console.log('\nDocument failed the verification process.');
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Load document from local disk

Path: /signature/java/load-document-from-local-disk/

When document is located on the local disk [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) enables you to work with document over the file [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class constructor. [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) instance will open file for reading only when any method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) will be called.

Following code snippet shows how to load document from local disk.

```java
Signature signature = new Signature("sample.docx");
TextSignOptions options = new TextSignOptions("John Smith");
 
// sign document to file
signature.sign(outputFilePath, options);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Load document from local disk

Path: /signature/net/load-document-from-local-disk/

When document is located on the local disk [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) enables you to work with document over the file [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class constructor. [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) instance will open file for reading only when any method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) will be called.

Following code snippet shows how to load document from local disk.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
    };
    // sign document to file
    signature.Sign("sampleSigned", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign Spreadsheet with Metadata signature

Path: /signature/python-net/esign-spreadsheet-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [SpreadsheetMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/spreadsheetmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) instance to sign Spreadsheet document files.
Spreadsheet document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Spreadsheet document metadata contains pair of Name and Value, Name should be unique within the document.  
Spreadsheet document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there.

### Here are the steps to add metadata signatures into Spreadsheet document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several [SpreadsheetMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/spreadsheetmetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Spreadsheet with Metadata signature

This example shows how to add Metadata e-signature to a Spreadsheet document.

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import MetadataSignOptions
from groupdocs.signature.domain import SpreadsheetMetadataSignature
from datetime import datetime

# Initialize signature
with signature.Signature("sample.xlsx") as sign:
    # Create metadata options
    options = MetadataSignOptions()
    
    # Create few Spreadsheet Metadata signatures
    signatures = [
        SpreadsheetMetadataSignature("Author", "Mr.Scherlock Holmes"),
        SpreadsheetMetadataSignature("DateCreated", datetime.now()),
        SpreadsheetMetadataSignature("DocumentId", 123456),
        SpreadsheetMetadataSignature("SignatureId", 123.456)
    ]
    
    # Add signatures to options
    options.signatures.extend(signatures)
    
    # Sign document
    sign.sign("SampleSigned.xlsx", options)
```

{{< /tab >}}
{{< tab "sample.xlsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.xlsx](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-metadata-signature/esign-spreadsheet-with-metadata-signature/sample.xlsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign Document with Image Signature

Path: /signature/python-net/esign-document-with-image-signature/

## What is an Image Signature?

An **image** as a signature is an alternative way to put any presenting data in a visual form. This electronic signature type allows the creation of custom images with a company logo, sender's initials, names and so forth.

![Images](/signature/python-net/images/esign-document-with-image-signature.png)

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides the [ImageSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/imagesignoptions) class to specify different settings for image signature such as image content by file or stream, location, colors and advanced effects.

Here are the steps to create an image signature on a document page:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter;
* Instantiate the [ImageSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/imagesignoptions) object according to your requirements and specify Image signature options;
* Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [ImageSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/imagesignoptions) to it.

## How to eSign Document with Image Signature

This example shows how to sign a PDF document with the image signature using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import ImageSignOptions
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create image signature options
        image_options = ImageSignOptions("./signature.jpg")
        
        # Set signature position
        image_options.left = 100
        image_options.top = 100
        
        # Set signature size
        image_options.width = 100
        image_options.height = 100
        
        # Set signature opacity
        image_options.opacity = 0.8
        
        # Set signature rotation angle
        image_options.rotation_angle = 45
        
        # Set signature alignment
        image_options.horizontal_alignment = gsd.HorizontalAlignment.CENTER
        image_options.vertical_alignment = gsd.VerticalAlignment.CENTER
        
        # Set signature border
        image_options.border_visiblity = True
        image_options.border_dash_style = gsd.DashStyle.DASH
        image_options.border_color = gsd.Color.BLACK
        image_options.border_weight = 2
        
        # Sign document
        sign.sign("./SampleSigned.pdf", image_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-image-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "signature.jpg" >}}
{{< tab-text >}}
The following sample file is used in this example: [signature.jpg](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-image-signature/signature.jpg)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Image Signature Options

You can customize the image signature further with additional options:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import ImageSignOptions

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Create image signature options
    image_options = ImageSignOptions("signature.jpg")
    
    # Set signature position and size
    image_options.left = 100
    image_options.top = 100
    image_options.width = 200
    image_options.height = 100
    
    # Set advanced options
    image_options.opacity = 0.8
    image_options.rotation_angle = 45
    
    # Set image alignment
    image_options.horizontal_alignment = signature.HorizontalAlignment.CENTER
    image_options.vertical_alignment = signature.VerticalAlignment.CENTER
    
    # Add border
    image_options.border_color = signature.Color.BLACK
    image_options.border_style = signature.DashStyle.SOLID
    image_options.border_width = 2
    
    # Sign document
    sign.sign("SampleSigned.pdf", image_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-image-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "signature.jpg" >}}
{{< tab-text >}}
The following sample file is used in this example: [signature.jpg](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-image-signature/signature.jpg)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Loading Image from Stream

You can also load the signature image from a stream:

{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import ImageSignOptions

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Load image from stream
    with open("signature.jpg", "rb") as image_stream:
        # Create image signature options
        image_options = ImageSignOptions(image_stream)
        
        # Set signature position
        image_options.left = 100
        image_options.top = 100
        
        # Sign document
        sign.sign("SampleSigned.pdf", image_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-image-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "signature.jpg" >}}
{{< tab-text >}}
The following sample file is used in this example: [signature.jpg](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-image-signature/signature.jpg)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide demonstrates how to use [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) to add image-based signatures to documents. It covers loading a document, configuring the image signature's properties (such as size, position, and opacity), and saving the signed document. Advanced customization options, like adjusting image appearance and aligning the signature, are also discussed. For further insights, explore related document signing resources.


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign documents with QR-code embedded object

Path: /signature/net/sign-documents-with-qr-code-embedded-object/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into QR-code signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption, the class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this encryption expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype)), string value key and string value salt.

Here are the steps to embed into QR-code text with standard encryption with GroupDocs.Signature:  

* Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.
* Implement if needed custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
* Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/formatattribute)  to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/skipserializationattribute) to mark property of class as not serialize
* Create new instance of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object with [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) value
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions)  object according to your requirements and custom object to [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Implementation of embedding custom object into QR-code signature

This example shows how to embed custom object into QR-code signature.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // setup key and passphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    // create custom object
    DocumentSignatureData documentSignatureData = new DocumentSignatureData()
    {
        ID = Guid.NewGuid().ToString(),
        Author = Environment.UserName,
        Signed = DateTime.Now,
        DataFactor = 11.22M
    };
    // setup QR-Code options
    QrCodeSignOptions options = new QrCodeSignOptions()
    {
        // set custom object to serialize to QR Code
        Data = documentSignatureData,
        // QR-code type
        EncodeType = QrCodeTypes.QR,
        // specify serialization encryption
        DataEncryption = encryption,
        // locate and aligh signature
        Height = 100,
        Width = 100,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() { Right = 10, Bottom = 10 }
    };
    // sign document to file
    signature.Sign("QrCodeEncryptedObject.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign document with HIBC PAS barcode Symbology

Path: /signature/net/sign-document-with-hibc-pas-barcode/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [HIBCPASData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/hibcpasdata/) class to create HIBC PAS barcode, designed specifically to meet the stringent requirements of the healthcare industry.

Here are the steps how to add HIBC PAS barcode signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the  [HIBCPASData](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/hibcpasdata/). Fill properties 
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/) object with all required additional options and set HIBCLICCombinedData object into Data property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add HIBCPASData signature to document using c#:

```csharp
using (Signature signature = new Signature(filePath))
{
    var data = new HIBCPASData()
    {
        DataLocation = HIBCPASDataLocation.Patient,
    };

    data.AddRecord(HIBCPASDataType.LabelerIdentificationCode, "A123");
    data.AddRecord(HIBCPASDataType.ManufacturerSerialNumber, "SERIAL123");

    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        Left = 100,
        Top = 100,        
        Data = data
    };

    // sign document to file
    var signResult = signature.Sign(outputFilePath, options);
            
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

This example shows how to decode HIBCPASData signature from the document using c#:

```csharp
using (Signature.Signature signature = new Signature.Signature(outputFilePath))
{
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    QrCodeSignature qrCode = signatures.FirstOrDefault();
    var data = qrCode.GetData<HIBCPASData>();
}

```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign document with Image signature

Path: /signature/java/esign-document-with-image-signature/

## What is a Image Signature?

An **image** as signature is alternative way to put any presenting data in a visual form. This electronic signature type allows to create custom image with company logo, sender' initials, names or make a company stamp icon in it,  
![](/signature/java/images/esign-document-with-image-signature.png)

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) class to specify different settings for Image signature such as image content by file or stream, location, colors and advanced effects.

Here are the steps to create Image signature on document page:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate the [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) object according to your requirements and specify Image signature options;    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class instance and pass [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) to it.
    

## How to eSign document with Image signature

This example shows how to sign PDF with Image signature.

```java
Signature signature = new Signature("sample.docx");

ImageSignOptions options = new ImageSignOptions("signature.jpg") ;
// set signature position
options.setLeft(100);
options.setTop(100);
//
options.setPageNumber(1);

// sign document to file
signature.sign("SampleSigned.docx", options);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign document with MaxiCode barcode Symbology

Path: /signature/net/sign-document-with-maxicode-barcode/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [MaxiCodeMode2](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/maxicodemode2/) class to create MaxiCode barcode, designed for tracking and managing the shipment of packages

Here are the steps how to add MaxiCode barcode signature into document with .Net GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the  [MaxiCodeMode2](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/maxicodemode2/). Fill properties 
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/) object with all required additional options and set HIBCLICCombinedData object into Data property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add HIBCPASData signature to document using c#:

```csharp
using (Signature signature = new Signature(filePath))
{
    var data = new MaxiCodeMode2()
    {
        PostalCode = "524032140",
        CountryCode = 056,
        ServiceCategory = 999,
        SecondMessage = new MaxiCodeSecondMessage()
        {
            Message = "Test message"
        }
    };

    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        Left = 100,
        Top = 100,        
        Data = data
    };

    // sign document to file
    var signResult = signature.Sign(outputFilePath, options);
            
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

This example shows how to decode MaxiCodeMode2 signature from the document using c#:
```csharp
using (Signature.Signature signature = new Signature.Signature(outputFilePath))
{
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    QrCodeSignature qrCode = signatures.FirstOrDefault();
    var data = qrCode.GetData<MaxiCodeMode2>();
}

```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate barcodes and/or sign your files with barcodes for free, you can use the [Barcode Generator](https://products.groupdocs.app/signature/generate/barcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign documents with standard encryption for QR-code

Path: /signature/net/sign-documents-with-standard-encryption-for-qr-code/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to encrypt QR-code signature with symmetric algorithms. Class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) implements one of the following values algorithms ([DES, TripleDES, RC2, Rijndael or AES](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype)), string value key and string value salt.

Here are the steps to encrypt QR-code text with embedded encryption by GroupDocs.Signature:

* Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object with [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) or Text property
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object according to your requirements and custom object to [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.  

## How to encrypt QR-code signature

 This example shows how to encrypt QR-code signature.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // setup key and passphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.AES, key, salt);
    // setup QR-Code options
    QrCodeSignOptions options = new QrCodeSignOptions()
    {
        // set QR-code text
        Text = "This is secure text that will be encrypted",
        // QR-code type
        EncodeType = QrCodeTypes.QR,
        // specify serialization encryption
        DataEncryption = encryption,
        // locate and aligh signature
        Height = 100,
        Width = 100,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() { Right = 10, Bottom = 10 }
    };
    // sign document to file
    signature.Sign("QrCodeEncrypted.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign Spreadsheet with Metadata signature

Path: /signature/java/esign-spreadsheet-with-metadata-signature/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [SpreadsheetMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/SpreadsheetMetadataSignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) instance to sign Spreadsheet document files.   
Spreadsheet document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Spreadsheet document metadata contains pair of Name and Value, Name should be unique within the document.  
Spreadsheet document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there. 

Here are the steps to add metadata signatures into Spreadsheet document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements.    
*   Instantiate one or several[SpreadsheetMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/SpreadsheetMetadataSignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to metadata signatures collection ([getSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#getSignatures())) via [add](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignatureCollection#add(com.groupdocs.signature.domain.signatures.metadata.MetadataSignature)) or addRange method.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it. 
    

## How to eSign Spreadsheet with Metadata signature

This example shows how to add Metadata e-signature to a Spreadsheet document.

```java
Signature signature = new Signature("sample.xlsx");
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();

// Create few Spreadsheet Metadata signatures
SpreadsheetMetadataSignature[] signatures = new SpreadsheetMetadataSignature[]
        {
                new SpreadsheetMetadataSignature("Author", "Mr.Scherlock Holmes"),
                new SpreadsheetMetadataSignature("DateCreated", new Date()),
                new SpreadsheetMetadataSignature("DocumentId", 123456),
                new SpreadsheetMetadataSignature("SignatureId", 123.456)
        };
options.getSignatures().addRange(signatures);

// sign document to file
signature.sign("SampleSigned.xlsx", options);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update Text signatures in document

Path: /signature/java/update-text-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) class to manipulate text signatures location, size and textual content. 

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to update Text signature in the document with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [TextSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature);      
*   Select from list [TextSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) object(s) that should be updated;
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/Signature#update(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    
This example shows how to update Text signature that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
Signature signature = new Signature("sampleSigned.pdf");
try {
    TextSearchOptions options = new TextSearchOptions();
    // search for text signatures in document
    List<TextSignature> signatures = signature.search(TextSignature.class, options);
    if (signatures.size() > 0) {
        TextSignature textSignature = signatures.get(0);
        // change Text property
        textSignature.setText("John Walkman");
        // change position
        textSignature.setLeft(textSignature.getLeft() + 50);
        textSignature.setTop(textSignature.getTop() + 50);
        // change size. Please note not all documents support changing signature size
        textSignature.setWidth(200);
        textSignature.setHeight(100);
 
        boolean result = signature.update("sampleSigned.pdf",textSignature);
        if (result) {
            System.out.print("Signature with Text '" + textSignature.getText() + "' was updated in the document ['sampleSigned.pdf'].");
        } else {
            System.out.print("Signature was not updated in  the document! Signature with Text '" + textSignature.getText() + "' was not found!");
        }
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign document with different Text signature implementation

Path: /signature/net/sign-document-with-different-text-signature-implementation/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) class with property [SignatureImplementation](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/signatureimplementation) of enumeration type [TextSignatureImplementation](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation) to specify various implementations of Text Signatures with following values and its meaning

* [TextSignatureImplementation.Stamp](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation) - text stamp component (label) on the document page.
* [TextSignatureImplementation.Annotation](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation) - text annotation with different appearances settings. This implementation depends of document type.
* [TextSignatureImplementation.Image](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation) - text will be transformed to image and put to document page. This implementation makes sense when there's a need to adjust extended appearances effects that is possible with image adjustment only (like opacity, free rotation, fading, shadows etc).
* [TextSignatureImplementation.Sticker](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation) - text sticker icon with different appearances settings. This implementation depends of document type.
* [TextSignatureImplementation.FormField](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation)  - this type is used to update existing Form Fields in the document. For this purpose please user property [FormTextFieldTitle](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/formtextfieldtitle) to setup Form Field name and property [FormTextFieldType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/formtextfieldtype) to specify type of Form Field.
* [TextSignatureImplementation.Watermark](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation) - text watermark along the document page under all document components. This implementation depends of document type.

Here are the steps to add Text signature into document with various text signature implementation types with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) object with all required additional options.
* set property [SignatureImplementation](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/signatureimplementation) of [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) object with required value from enumeration type [TextSignatureImplementation](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignatureimplementation).
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass initialized [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) instance to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

## Sign document with Text signature and Stamp implementation type

This example shows how to add Text signature with Stamp signature implementation to document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Stamp,
        // set alignment
        VerticalAlignment = VerticalAlignment.Top,
        HorizontalAlignment = HorizontalAlignment.Right,
        // set margin with 20 pixels for all sides
        Margin = new Padding(20)
    };
    // sign document to file
    SignResult signResult = signature.Sign("signed.pdf", options);
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId},
            Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Sign document with Text signature and Annotation implementation type

This example shows how to add Text signature with Annotation signature implementation to document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Annotation,
        // for Pdf document type ther's ability to setup exteneded appearences
        Appearance = new PdfTextAnnotationAppearance()
        {
            Border = new Border()
            {
                Color = Color.Blue,
                DashStyle = DashStyle.Dash,
                Weight = 2,
            },
            BorderEffect = PdfTextAnnotationBorderEffect.Cloudy,
            BorderEffectIntensity = 2,
            HCornerRadius = 10,
            // text content of an annotation
            Contents = "Sample",
            Subject = "Sample subject",
            Title = "Sample Title",
        },
        // set alignment
        VerticalAlignment = VerticalAlignment.Top,
        HorizontalAlignment = HorizontalAlignment.Right,
        // set margin with 20 pixels for all sides
        Margin = new Padding(20)
    };
    // sign document to file
    SignResult signResult = signature.Sign("signed.pdf", options);
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId},
            Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Sign document with Text signature and Image implementation type

This example shows how to add Text signature with Image signature implementation to document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image,
        // set alignment
        VerticalAlignment = VerticalAlignment.Top,
        HorizontalAlignment = HorizontalAlignment.Right,
        // set margin with 20 pixels for all sides
        Margin = new Padding(20)
    };
    // sign document to file
    SignResult signResult = signature.Sign("signed.pdf", options);
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId},
            Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Sign document with Text signature and Sticker implementation type

This example shows how to add Text signature with Sticker signature implementation to document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Sticker,

        // set alignment
        VerticalAlignment = VerticalAlignment.Top,
        HorizontalAlignment = HorizontalAlignment.Right,
        // set margin with 20 pixels for all sides
        Margin = new Padding(20)
    };
    // sign document to file
    SignResult signResult = signature.Sign("signed.pdf", options);
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId},
            Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Sign document with Text signature and Form Field implementation type

This example shows how to add Text signature with FormField signature implementation to document.

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    TextSignOptions ffOptions1 = new TextSignOptions("John Smith")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.FormField,
        FormTextFieldType = FormTextFieldType.PlainText,
        FormTextFieldTitle = "UserSignatureFullName"
    };
    TextSignOptions ffOptions2 = new TextSignOptions("Document is approved")
    {
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.FormField,
        FormTextFieldType = FormTextFieldType.RichText,
        FormTextFieldTitle = "UserSignatureComment"
    };
    List<SignOptions> listOptions = new List<SignOptions>();
    listOptions.Add(ffOptions1);
    listOptions.Add(ffOptions2);
    // sign document to file
    SignResult signResult = signature.Sign("signed.docx", listOptions);
    // analyzing result
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId},
            Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Update Text signatures in document

Path: /signature/net/update-text-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) class to manipulate text signatures location, size and textual content.  
Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to update Text signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [TextSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature);
* Select from list [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.

This example shows how to update Text signature that was found using  [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    TextSearchOptions options = new TextSearchOptions();
    // search for text signatures in document
    List<TextSignature> signatures = signature.Search<TextSignature>(options);
    if(signatures.Count > 0)
    {
        TextSignature textSignature = signatures[0];
        // change Text property
        textSignature.Text = "John Walkman";
        // change position
        textSignature.Left = textSignature.Left + 10;
        textSignature.Top = textSignature.Top + 10;
        // change size. Please note not all documents support changing signature size
        textSignature.Width = 200;
        textSignature.Height = 100;
        bool result = signature.Update(textSignature);
       if (result)
       {
           Console.WriteLine(
               $"Signature with Text '{textSignature.Text}' " +
               $"was updated in the document ['{fileName}']."
           );
       }
       else
       {
           Console.WriteLine(
               $"Signature was not updated in the document! " +
               $"Signature with Text '{textSignature.Text}' was not found!"
           );
       }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Update Text signatures in document

Path: /signature/nodejs-java/update-text-signatures-in-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [TextSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textsignature) class to manipulate text signatures' location, size, and textual content. Please note that the [Update](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/update/) method modifies the same document that was passed to the constructor of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class.

### Here are the steps to update a Text signature in the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsearchoptions) object with the desired properties.
* Call the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method to obtain a list of [TextSignatures](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textsignature).
* Select from the list the [TextSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textsignature) object(s) that should be updated.
* Call the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) object's [Update](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/update/) method and pass one or several signatures to it.

This example shows how to update a Text signature that was found using the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method.
```csharp
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 
  const fileName = path.basename(filePath);

  // Copy source file since the update method works with the same document
  const outputFilePath = path.join(Constants.OutputPath, 'UpdateText', fileName);
  const dir = path.dirname(outputFilePath);
  if (!fs.existsSync(dir)) {
      fs.mkdirSync(dir, { recursive: true });
  }

  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize TextSearchOptions
  const options = new signatureLib.TextSearchOptions();

  // Search for text signatures in the document
  const signatures = signature.search(signatureLib.TextSignature.class, options).toArray();

  if (signatures.length > 0) {
    const textSignature = signatures[0];

    // Change Text property
    textSignature.setText('John Walkman');
    // Change position
    textSignature.setLeft(textSignature.getLeft() + 50);
    textSignature.setTop(textSignature.getTop() + 50);
    // Change size. Please note not all documents support changing signature size
    textSignature.setWidth(200);
    textSignature.setHeight(100);

    // Update the text signature in the document
    const result = signature.update(outputFilePath, textSignature);

    if (result) {
      console.log(`\nSignature with Text '${textSignature.getText()}' was updated in the document ['${fileName}'].`);
    } else {
      console.log(`\nSignature was not updated in the document! Signature with Text '${textSignature.getText()}' was not found!`);
    }
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Delete signatures from documents by ID

Path: /signature/nodejs-java/delete-signatures-from-documents-by-id/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides [TextSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textsignature/) class to manipulate text signatures and delete them from the documents.
Please be aware that [Delete](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/delete/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class.
## How to delete Text signature from the document
Here are the steps to delete Text signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [TextSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsearchoptions/) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search(com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [TextSignatures](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textsignature/);
* Select from list [TextSignature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/textsignature/) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/delete/) method and pass one or several signatures to it.

This example shows how to delete Text signature that was found using [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search(com.groupdocs.signature.options.search.SearchOptions)) method.

```javascript
  // The path to the documents directory.  
  const filePath = Constants.SAMPLE_PDF_SIGNED; 
  const fileName = path.basename(filePath);

  const outputDirectory = path.join(Constants.OutputPath, 'DeleteById');
  if (!fs.existsSync(outputDirectory)) {
    fs.mkdirSync(outputDirectory, { recursive: true });
  }

  // Copy source file since the delete method works with the same Document
  const outputFilePath = path.join(outputDirectory, fileName);

  fs.copyFileSync(filePath, outputFilePath);

  const signature = new signatureLib.Signature(outputFilePath);

  const id = 'eff64a14-dad9-47b0-88e5-2ee4e3604e71';
  const result = await signature.delete(id);
  if (result) {
    console.log(`Signature with Id# '${id}' was deleted from document ['${fileName}'].`);
  } else {
    console.log(`Signature was not deleted from the document! Signature with id# '${id}' was not found!`);
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Deleting QR-code signatures - advanced

Path: /signature/java/deleting-qr-code-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) class to manipulate QR-code signatures and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method.  
Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete QR-code signature from the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object with desired properties;
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature);  
    
*   Select from list [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) object(s) that should be removed from the document;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method and pass one or several signatures to it.
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not.

Here are the alternative steps to delete QR-code signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) methods.

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate one or several [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) objects with signature Id(s) passed to constructor;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it;
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not. 

## Delete QR-code signature from the document after Search

This example shows how to delete QR-code signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("signed.docx");
 
QrCodeSearchOptions options = new QrCodeSearchOptions();
 
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class,options);
List<BaseSignature> signaturesToDelete = new ArrayList<BaseSignature>();
// collect signatures to delete
for (QrCodeSignature temp : signatures)
{
    if (temp.getText().contains("John"))
    {
        signaturesToDelete.add(temp);
    }
}
// delete signatures
DeleteResult deleteResult = signature.delete("signed.docx",signaturesToDelete);
if (deleteResult.getSucceeded().size() == signaturesToDelete.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : " + deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : " + deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Delete QR-code signature from the document by known signature Identifier

This example shows how to delete QR-code signature in the document by known signature Id (that was obtained by  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method previously).

```java
// initialize Signature instance
Signature signature = new Signature("signed.pdf");
 
// read from some data source signature Id value
String[] signatureIdList = new String[]
    {
            "1a5fbc08-4b96-43d9-b650-578b16fbb877",
            "b0123987-b0d4-4004-86ec-30ab5c41ac7e"
    };
// create list of QR-code Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList)
{
    signatures.add(new QrCodeSignature(item));
}
 
// delete required signatures
DeleteResult deleteResult = signature.delete("signed.pdf",signatures);
if (deleteResult.getSucceeded().size() == signatures.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : " + deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : " + deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

  

## More resources 

### GitHub Examples  

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Deleting QR-code signatures - advanced

Path: /signature/net/deleting-qr-code-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) class to manipulate QR-code signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to delete QR-code signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature);
* Select from list [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

Here are the alternative steps to delete QR-code signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) objects with signature Id(s) passed to constructor;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it;
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

## Delete QR-code signature from the document after Search

This example shows how to delete QR-code signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.docx"))
{
    QrCodeSearchOptions options = new QrCodeSearchOptions();
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    List<BaseSignature> signaturesToDelete = new List<BaseSignature>();
    // collect signatures to delete
    foreach (QrCodeSignature temp in signatures)
    {
        if (temp.Text.Contains("John"))
        {
            signaturesToDelete.Add(temp);
        }
    }
    // delete signatures
    DeleteResult deleteResult = signature.Delete(signaturesToDelete);
    if (deleteResult.Succeeded.Count == signaturesToDelete.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Delete QR-code signature from the document by known signature Identifier  

This example shows how to delete QR-code signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously).

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.pdf"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of QR-code Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new QrCodeSignature(p)));
    // delete required signatures
    DeleteResult deleteResult = signature.Delete(signatures);
    if (deleteResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Text signatures from documents

Path: /signature/java/delete-text-signatures-from-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) class to manipulate text signatures and [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) them from the documents.   
Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete Text signature from the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [TextSearchOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/TextSearchOptions) object with desired properties;
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [TextSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature);  
*   Select from list [TextSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) object(s) that should be removed from the document;  
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.

This example shows how to delete Text signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
Signature signature = new Signature("signed.pptx");
try
{
    TextSearchOptions options = new TextSearchOptions();
 
    // search for text signatures in document
    List<TextSignature> signatures = signature.search(TextSignature.class,options);
    if(signatures.size() > 0)
    {
        TextSignature textSignature = signatures.get(0);
        boolean result = signature.delete("signed-output.pptx",textSignature);
        if(result)
        {
            System.out.print("Signature with Text " + textSignature.getText() + " was deleted from document [signed-output.pptx].");
        }
        else
        {
            System.out.print("Signature was not deleted from the document! Signature with Text " + textSignature.getText() + " was not found!");
        }
    }
} catch (Exception e) {
    throw new GroupDocsSignatureException(e.getMessage());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Text signatures from documents

Path: /signature/net/delete-text-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) class to manipulate text signatures and delete them from the documents.
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.
## How to delete Text signature from the document
Here are the steps to delete Text signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [TextSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature);
* Select from list [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.

This example shows how to delete Text signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("signed.pptx"))
{
    TextSearchOptions options = new TextSearchOptions();
    
    // Search for text signatures in the document
    List<TextSignature> signatures = 
        signature.Search<TextSignature>(options);

    if (signatures.Count > 0)
    {
        TextSignature textSignature = signatures[0];
        bool result = signature.Delete(textSignature);

        if (result)
        {
            Console.WriteLine(
                $"Signature with text '{textSignature.Text}' " +
                $"was deleted from the document."
            );
        }
        else
        {
            Console.WriteLine("Signature was not deleted from the document!");
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Updating QR-code signatures with advanced options

Path: /signature/net/updating-qr-code-signatures-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) class to manipulate qr-code signatures location, size, textual content and encode type over [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) object to analyze if signatures were successfully processed.

Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. The [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) contains list of successfully updated signatures and ones that failed. The Barcode signature could be failed to update due to several reasons:

* if signature object was initialized with constructor by incorrect signature identifier;
* if signature object was not found;
* there was an error occurred while updating signature in the document.

Here are the steps to update QR-code signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [QrCodeSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature);
* Select from list [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

Here are the alternative steps to update QR-code signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [QrCodeSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature) objects with signature Id(s) passed to constructor;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it;
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

The following table describes changeable properties for QR-code signatures dependent on document type

| Document Type / Signature Property | Left | Top | Width | Height | EncodeType | Text | IsSignature |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) |
| Spreadsheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Pdf | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Presentation | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |
| Word Processing | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(tick)](/signature/net/images/check.png) |

## Update QR-code signature in the document after Search

This example shows how to update QR-code signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    QrCodeSearchOptions options = new QrCodeSearchOptions();
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    // adjust signature properties
    foreach (QrCodeSignature temp in signatures)
    {
        // apply some condition to adjust signature properties
        if (temp.Text == "Test1")
        {
            temp.Left = temp.Left + 10;
            temp.Top = temp.Top + 10;
            temp.IsSignature = false;
        }
        else
        {
            temp.IsSignature = true;
        }
    }
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures.ConvertAll(p => (BaseSignature)p));
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("\nAll signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Update QR-code signature in document by known signature Identifier  

This example shows how to update QR-code signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously).

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.xlsx"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of QR-code Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new QrCodeSignature(p)));
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures);
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Composing signature with texture brush background

Path: /signature/net/composing-signature-with-texture-brush-background/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextureBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/texturebrush) class to specify filling signature background with image for Text and Image signature types

 Here are the steps to use Texture brush with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with all required additional options and setup [Background.Brush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/background/brush) property with instance of [TextureBrush](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/texturebrush)
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to use Texture brush for signature background. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // adjust signature appearance brush
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new TextureBrush("sample.jpg")
        },
        // locate signature
        Width = 100,
        Height = 80,
        VerticalAlignment = Domain.VerticalAlignment.Center,
        HorizontalAlignment = Domain.HorizontalAlignment.Center,
        Margin = new Padding() { Top = 20, Right = 20 },
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image
    };
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Text signatures from documents

Path: /signature/python-net/delete-text-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [TextSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/textsignature) class to manipulate text signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

## How to delete Text signature from the document
Here are the steps to delete Text signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [TextSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain list of [TextSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/textsignature);
* Select from list [TextSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/textsignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.  

This example shows how to delete Text signature that was found using [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method.

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSearchOptions

# Initialize signature
with signature.Signature("signed.docx") as sign:
    # Create search options
    options = TextSearchOptions()
    
    # Search for text signatures in the document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        text_signature = signatures[0]
        result = sign.delete(text_signature)
        
        if result:
            print(
                f"Text signature at location {text_signature.left}x{text_signature.top} "
                f"and size {text_signature.size} was deleted from document ['{fileName}']."
            )
        else:
            print(
                f"Signature was not deleted from the document! "
                f"Signature at location {text_signature.left}x{text_signature.top} "
                f"and size {text_signature.size} was not found!"
            )
```

{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Advanced search for Text signatures

Path: /signature/java/advanced-search-for-text-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) class to specify different options to search for Text Signatures.

Here are the steps to search for text signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) object according to your requirements and specify search options 
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) to it.
    

This example shows how to make advanced search for Text signature in the document.

```java
Signature signature = new Signature("sample.pdf");
 
PagesSetup page = new  PagesSetup();
page.setFirstPage(true);
page.setLastPage(true);
page.setOddPages(false);
page.setEvenPages(false);
TextSearchOptions options = new TextSearchOptions();
options.setAllPages(false);
options.setPageNumber(1);
options.setMatchType(TextMatchType.Exact);
options.setText("John Smith");
 
// search for text signatures in document
List<TextSignature> signatures = signature.search(TextSignature.class,options);
System.out.print("\nSource document contains following text signature(s).");
// enumerate all signature for output
//foreach to while statements conversion
try
{
    for (TextSignature sign : signatures)
    {
 
        if (sign != null)
        {
            System.out.print("Found Text signature at page "+sign.getPageNumber()+" with type ["+sign.getSignatureImplementation()+"] and text '"+sign.getText()+"'.");
            System.out.print("Location at "+sign.getLeft()+"-"+sign.getTop()+". Size is "+sign.getWidth()+"x"+sign.getHeight()+".");
        }
    }
}
catch (Exception ex)
{
    System.out.print("System Exception: " + ex.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Update Text Signatures in Document

Path: /signature/python-net/update-text-signatures-in-document/

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides functionality to manipulate text signatures' location, size, and textual content.  
Please note that the [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method modifies the same document that was passed to the constructor of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

Here are the steps to update a Text signature in a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter
* Instantiate the [TextSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsearchoptions) object with desired properties
* Call the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain a list of text signatures
* Select from the list the [TextSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/textsignature) object(s) that should be updated
* Call the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object's [update](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/update/) method and pass one or several signatures to it

This example shows how to update a Text signature that was found using the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSearchOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create search options
    options = TextSearchOptions()
    
    # Search for text signatures in document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        # Get first text signature
        text_signature = signatures[0]
        
        # Change text property
        text_signature.text = "John Walkman"
        
        # Change position
        text_signature.left = text_signature.left + 10
        text_signature.top = text_signature.top + 10
        
        # Change size. Please note not all documents support changing signature size
        text_signature.width = 200
        text_signature.height = 100
        
        # Update the signature
        result = sign.update(text_signature)
        
        if result.updated_count > 0:
            print(f"Signature with text '{text_signature.text}' was updated in the document")
        else:
            print(f"Signature was not updated in the document! "
                  f"Signature with text '{text_signature.text}' was not found!")
```


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Search for Form Field e-signatures

Path: /signature/java/search-for-form-field-e-signatures/

To search for Form Fields e-signatures inside document you should pass instance of [FormFieldSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/FormFieldSearchOptions) class to a search method of [GroupDocs.Signature](https://products.groupdocs.com/signature/java).  
Here are the guide for searching Form Field e-signatures :

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate the [FormFieldSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/FormFieldSearchOptions) object according to your requirements and specify additional search options (if needed);  
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [FormFieldSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/FormFieldSearchOptions) to it.
    

This example shows how to search for Form Field signatures in the document.

```java
Signature signature = new Signature("signed.pdf");
FormFieldSearchOptions options = new FormFieldSearchOptions();
 
// search for signatures in document
List<FormFieldSignature> signatures = signature.search(FormFieldSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (FormFieldSignature formFieldSignature : signatures)
{
    System.out.print("FormField signature found. Name : "+formFieldSignature.getName()+". Value: " +formFieldSignature.getValue());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to search for Metadata signatures

Path: /signature/net/search-for-metadata-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides a [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) class to search Metadata electronic signatures within document.  
Here are the steps to search for Metadata signatures using GroupDocs.Signature API:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) object according to your requirements and specify additional search options (if needed);
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) to it.

This code snippet demonstrates how to search for Metadata e-signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    MetadataSearchOptions options = new MetadataSearchOptions();
    // search for signatures in document
    List<MetadataSignature> signatures = signature.Search<MetadataSignature>(options);
    foreach (var metadataSignature in signatures)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}. Type: {2}",
            metadataSignature.Name, metadataSignature.Value,metadataSignature.Type);
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Search for Multiple e-Signature Types

Path: /signature/python-net/search-for-multiple-e-signature-types/

[GroupDocs.Signature](https://products.groupdocs.com/signature/python-net) provides the ability to search for multiple types of electronic signatures in documents simultaneously. This allows you to find different types of signatures like text, image, digital, barcode, QR code, and form field signatures in a single search operation.

## How to Search for Multiple Signature Types

The [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class provides the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method which allows you to search for multiple types of signatures in documents. Here's how to use it:

1. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class and pass the source document path as a parameter.
2. Create search options for each type of signature you want to search for.
3. Call the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class instance and pass the search options to it.
4. Process the search results.

Here's an example of how to search for multiple types of signatures in a document:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import TextSearchOptions, ImageSearchOptions, BarcodeSearchOptions, QrCodeSearchOptions, FormFieldSearchOptions
from groupdocs.signature.domain import TextSignature, ImageSignature, BarcodeSignature, QrCodeSignature, FormFieldSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options for different signature types
    text_options = TextSearchOptions()
    image_options = ImageSearchOptions()
    barcode_options = BarcodeSearchOptions()
    qr_code_options = QrCodeSearchOptions()
    form_field_options = FormFieldSearchOptions()
    
    # Search for signatures
    text_result = signature.search(text_options)
    image_result = signature.search(image_options)
    barcode_result = signature.search(barcode_options)
    qr_code_result = signature.search(qr_code_options)
    form_field_result = signature.search(form_field_options)
    
    # Process found signatures
    print(f"Found {len(text_result)} text signatures")
    for text_signature in text_result:
        print(f"Text: {text_signature.text}")
        print(f"Page: {text_signature.page_number}")
    
    print(f"\nFound {len(image_result)} image signatures")
    for image_signature in image_result:
        print(f"Image Size: {image_signature.width}x{image_signature.height}")
        print(f"Page: {image_signature.page_number}")
    
    print(f"\nFound {len(barcode_result)} barcode signatures")
    for barcode_signature in barcode_result:
        print(f"Barcode Type: {barcode_signature.encode_type}")
        print(f"Barcode Text: {barcode_signature.text}")
        print(f"Page: {barcode_signature.page_number}")
    
    print(f"\nFound {len(qr_code_result)} QR code signatures")
    for qr_code_signature in qr_code_result:
        print(f"QR Code Text: {qr_code_signature.text}")
        print(f"Page: {qr_code_signature.page_number}")
    
    print(f"\nFound {len(form_field_result)} form field signatures")
    for form_field_signature in form_field_result:
        print(f"Field Name: {form_field_signature.name}")
        print(f"Field Type: {form_field_signature.type}")
        print(f"Field Value: {form_field_signature.value}")
```

## Advanced Search Options

You can customize the search process for each signature type by setting specific options:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import TextSearchOptions, ImageSearchOptions, BarcodeSearchOptions, QrCodeSearchOptions, FormFieldSearchOptions
from groupdocs.signature.domain import TextSignature, ImageSignature, BarcodeSignature, QrCodeSignature, FormFieldSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options for different signature types
    text_options = TextSearchOptions()
    text_options.text = "John Doe"  # Search for specific text
    
    image_options = ImageSearchOptions()
    image_options.min_content_size = 100  # Minimum image size in pixels
    
    barcode_options = BarcodeSearchOptions()
    barcode_options.encode_type = "Code128"  # Search for specific barcode type
    
    qr_code_options = QrCodeSearchOptions()
    qr_code_options.text = "https://example.com"  # Search for specific QR code text
    
    form_field_options = FormFieldSearchOptions()
    form_field_options.field_names = ["signature1", "signature2"]  # Search for specific form fields
    
    # Search for signatures
    text_result = signature.search(text_options)
    image_result = signature.search(image_options)
    barcode_result = signature.search(barcode_options)
    qr_code_result = signature.search(qr_code_options)
    form_field_result = signature.search(form_field_options)
    
    # Process found signatures
    # ... (same as above)
```

## Additional Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our examples:

* [GroupDocs.Signature for Python via .NET Examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)
* [GroupDocs.Signature for Python via .NET Plugins](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Plugins)
* [GroupDocs.Signature for Python via .NET Showcase Apps](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Showcase)

### Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to search for multiple types of signatures in documents with our free online apps:

* [Search for Multiple Signature Types Online](https://products.groupdocs.app/signature/family)
---

## Add document to Spreadsheet via OLE

Path: /merger/java/add-document-to-spreadsheet-via-ole/

## What is OLE object for Spreadsheet?

The OLE technology provided by Microsoft allows to insert some other document content into the cell that is previosly selected by RowIndex and ColumnIndex of the currently editing Excel spreadsheet. For example, the PDF document can be inserted in the Excel spreadsheet document as image link inside of predefined cell as was presented in the example below.

## Add document to Spreadsheet via OLE

**[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** provides an ability to add other single document as embedded document to Presentation.   
Here are the steps for it:

*   Initialise [OleSpreadsheetOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/OleSpreadsheetOptions) class with embedded file path and page number;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) object with source document path or stream;
*   Call [importDocument](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#importDocument(com.groupdocs.merger.domain.options.interfaces.IImportDocumentOptions)) method and pass [OleSpreadsheetOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/OleSpreadsheetOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.lang.String)) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add other single document as embedded document to Presentation:

```java
int pageNumber = 2;
OleSpreadsheetOptions oleCellsOptions = new OleSpreadsheetOptions("c:\embedded.pdf", pageNumber);
oleCellsOptions.setRowIndex(2);
oleCellsOptions.setColumnIndex(2);

Merger merger = new Merger("c:\sample.xlsx");
{
    merger.importDocument(oleCellsOptions);
    merger.save("c:\output\result.xlsx");
}

```

---

## Add document to Spreadsheet via OLE

Path: /merger/net/add-document-to-spreadsheet-via-ole/

## What is OLE object for Spreadsheet?

The OLE technology provided by Microsoft allows to insert some other document content into the cell that is previosly selected by RowIndex and ColumnIndex of the currently editing Excel spreadsheet. For example, the PDF document can be inserted in the Excel spreadsheet document as image link inside of predefined cell as was presented in the example below.

## Add document to Spreadsheet via OLE

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides an ability to add other single document as embedded document to Presentation.   
Here are the steps for it:

*   Initialise [OleSpreadsheetOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/olespreadsheetoptions) class with embedded file path and page number;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [ImportDocument](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/importdocument) method and pass [OleSpreadsheetOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/olespreadsheetoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add other single document as embedded document to Excel spreadsheet:

```csharp
string filePath = @"c:\sample.xlsx";
string filePathEmbedded = @"c:\embedded.pdf";
string filePathOut = @"c:\output\result.xlsx";

int pageNumber = 2;
OleSpreadsheetOptions oleSpreadsheetOptions = new OleSpreadsheetOptions(filePathEmbedded, pageNumber);
oleSpreadsheetOptions.RowIndex = 2;
oleSpreadsheetOptions.ColumnIndex = 2;

using (Merger merger = new Merger(filePath))
{
    merger.ImportDocument(oleSpreadsheetOptions);
    merger.Save(filePathOut);
}

```

---

## Add ellipse annotation

Path: /annotation/java/add-ellipse-annotation/

Ellipse annotation draws elliptic annotation on a document page as shown in the picture below.

![](/annotation/java/images/add-ellipse-annotation.png)

You can use the following methods to set the properties of the [EllipseAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation) class: 

*   [setBackgroundColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation/#setBackgroundColor-java.lang.Integer-) defines the ellipse background color
*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position on the page;
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPenColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation/#setPenColor-java.lang.Integer-) defines the pen color
*   [setPenStyle()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation/#setPenStyle-java.lang.Byte-) - defines the line style (solid, dash, dot etc.)
*   [setPenWidth()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation/#setPenWidth-java.lang.Byte-) defines the line width in pixels. 

To add an ellipse annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate [EllipseAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [EllipseAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add [EllipseAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/ellipseannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding ellipse annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of EllipseAnnotation class and set options
    EllipseAnnotation ellipse = new EllipseAnnotation();
    ellipse.setBackgroundColor(65535);
    ellipse.setBox(new Rectangle(100, 100, 100, 100));
    ellipse.setCreatedOn(Calendar.getInstance().getTime());
    ellipse.setMessage("This is ellipse annotation");
    ellipse.setOpacity(0.7);
    ellipse.setPageNumber(0);
    ellipse.setPenColor(65535);
    ellipse.setPenStyle(PenStyle.Dot);
    ellipse.setPenWidth((byte) 3);
    ellipse.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(ellipse);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add ellipse annotation

Path: /annotation/net/add-ellipse-annotation/

Ellipse annotation draws elliptic annotation on a document page as shown in the picture below.

![](/annotation/net/images/add-ellipse-annotation.png)

You can set the following properties of the [EllipseAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/ellipseannotation) class: 

*   [BackgroundColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/backgroundcolor) defines the ellipse background color
*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/box) defines the annotation position on the page;
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/opacity) allows you to set the annotation opacity
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/pencolor) defines the pen color
*   [PenStyle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penstyle) - defines the line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penwidth) defines the line width in pixels. 

To add an ellipse annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate [EllipseAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/ellipseannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [EllipseAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/ellipseannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add [EllipseAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/ellipseannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add ellipse annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	EllipseAnnotation ellipse = new EllipseAnnotation
    {
    	BackgroundColor = 65535,
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Message = "This is ellipse annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = 65535,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
       }
   };
   annotator.Add(ellipse);
   annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Attachments in PDF document

Path: /watermark/java/attachments-in-pdf-document/



## Extract all attachments from PDF document 

GroupDocs.Watermark API allows you to extract [attachments](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/PdfContent#getAttachments()) in PDF document. Following code performs this functionality.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfExtractAllAttachments**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                           
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"    
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                             
                                                                                                             
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                            
for (PdfAttachment attachment : pdfContent.getAttachments())                                                 
{                                                                                                            
    System.out.println("Name: " + attachment.getName());                                                     
    System.out.println("Description: " + attachment.getDescription());                                       
    System.out.println("File type: " + attachment.getDocumentInfo().getFileType());                          
                                                                                                             
    // Save the attached file on disk                                                                        
    FileOutputStream outputStream = new FileOutputStream("SampleFiles\\Output" + "\\" + attachment.getName());
    outputStream.write(attachment.getContent());                                                             
    outputStream.close();                                                                                    
}                                                                                                            
                                                                                                             
watermarker.close();                                                                                         
```

## Add an attachment to PDF document

The API also allows you to add attachments to the PDF document. Following code snippet shows how to remove an attachment

**advanced\_usage.add\_watermarks\_to\_pdf.PdfAddAttachment**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                        
                                                                                                         
File file = new File("sample.docx");                                                            
byte[] attachmentBytes = new byte[(int) file.length()];                                                  
InputStream inputStream = new FileInputStream(file);                                                     
inputStream.read(attachmentBytes);                                                                       
inputStream.close();                                                                                     
                                                                                                         
// Add the attachment                                                                                    
pdfContent.getAttachments().add(attachmentBytes, "sample doc", "sample doc as attachment");              
                                                                                                         
// Save changes                                                                                          
watermarker.save("document.pdf");                                                              
                                                                                                         
watermarker.close();                                                                                     
```

## Remove attachment from PDF document

The API also allows you to remove attachments from the PDF document. Following code snippet shows how to remove an attachment.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfRemoveAttachment**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                             
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"      
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                               
                                                                                                               
PdfContent pdfContent = watermarker.getContent(PdfContent.class);                                              
for (int i = pdfContent.getAttachments().getCount() - 1; i >= 0; i--)                                          
{                                                                                                              
    PdfAttachment attachment = pdfContent.getAttachments().get_Item(i);                                        
                                                                                                               
    // Remove all attached pdf files with a particular name                                                    
    if (attachment.getName().contains("sample") && attachment.getDocumentInfo().getFileType() == FileType.DOCX)
    {                                                                                                          
        pdfContent.getAttachments().removeAt(i);                                                               
    }                                                                                                          
}                                                                                                              
                                                                                                               
watermarker.save("document.pdf");                                                                    
                                                                                                               
watermarker.close();                                                                                           
```

## Search for images attachments

In case you want to search for all the images attachments in a PDF document, you can use GroupDocs.Watermark. Following code sample shows how to search images attachments of PDF document.

**advanced\_usage.add\_watermarks\_to\_pdf.PdfSearchImageInAttachment**

```java
PdfLoadOptions loadOptions = new PdfLoadOptions();                                                       
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.pdf"
Watermarker watermarker = new Watermarker("document.pdf", loadOptions);                         
                                                                                                         
// Consider only the attached images                                                                     
watermarker.getSearchableObjects().setPdfSearchableObjects(PdfSearchableObjects.AttachedImages);         
                                                                                                         
// Search for similar images                                                                             
WatermarkableImageCollection possibleWatermarks = watermarker.getImages();                               
                                                                                                         
System.out.println("Found " + possibleWatermarks.getCount() + " image(s).");                             
                                                                                                         
watermarker.close();                                                                                     
```

---

## Barcode Image Generation in Presentation Document

Path: /assembly/java/barcode-image-generation-in-presentation-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Barcode Generation in Microsoft PowerPoint

### Template Syntax

*   Add a textbox to your template at the place where you want a barcode image to be inserted.
*   Add the following syntax:

```java
<<barcode [value] -itf6>>
```

### Download Template

Get the template from here.

*   [Barcode.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Barcode.pptx?raw=true)

### The Code

{{< gist GroupDocsGists e6892938d4cad17c877cafb4b6ce2997 >}}



---

## Barcode Image Generation in Presentation Document

Path: /assembly/net/barcode-image-generation-in-presentation-document/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.2.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Barcode Generation in Microsoft PowerPoint

### Template Syntax

*   Add a textbox to your template at the place where you want a barcode image to be inserted.
*   Add the following syntax:

```csharp
<<barcode [customer.Barcode] -codabar>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Get the template from here.

*   [Barcode.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Barcode.pptx?raw=true)

### The Code

{{< gist GroupDocsGists d11570805209774badf3def8336ae84a >}}

---

## Bubble Chart in Email Document

Path: /assembly/java/bubble-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bubble Chart report in Email Document.{{< /alert >}}

## Bubble Chart in Email Document

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Retrieve total Contract Prices by Months.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>><<x [key + 1]>>
```

#### Chart Data (Email)

<table border="1" cellspacing="0" cellpadding="0" width="623" style="width: 467.5pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">X-Values</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Total Contract Price&lt;&lt;y [sum(c =&gt; c.getPrice())]&gt;&gt;&lt;&lt;size[count()]&gt;&gt;</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Size</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.7</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.7</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">10</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.2</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.6</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.8</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">8</span></p></td></tr></tbody></table>
### Download Bubble Chart Template

Please download the sample Bubble Chart document we created in this article:

*   [Bubble Chart.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< gist samicheemagroupdocs 0e138fdf3c9c28d86864c9d5256d62d5 >}}



---

## Bubble Chart in Email Document

Path: /assembly/net/bubble-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bubble Chart report in Email Document.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bubble Chart in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to share your sales/orders dynamically with the following key requirements:

*   A report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   Retrieve total order Prices by Months.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

##### Chart Title

```csharp
Orders Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>><<x[Key]>>

```

##### Chart Data (Excel)

<table border="1" cellspacing="0" cellpadding="0" width="623" style="width: 467.5pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">X-Values</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Total Order Price&lt;&lt;y [sum(c =&gt; c.Price)]&gt;&gt;&lt;&lt;size[Count()]&gt;&gt;</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Size</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.7</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.7</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">10</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.2</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4</span></p></td></tr><tr><td width="108" valign="top" style="width: 80.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.6</span></p></td><td width="438" valign="top" style="width: 328.5pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">0.8</span></p></td><td width="78" valign="top" style="width: 58.25pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">8</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bubble Chart Template

Please download the sample Bubble Chart document we used in this article:

*   [Bubble Chart.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Bubble%20Chart.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists 9fce9ede8837b3240df371a0eb596a67 >}}



---

## Bulleted List in HTML Document

Path: /assembly/java/bulleted-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bulleted List in HTML Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must show all the clients in a bulleted list format.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
<ul>
&lt;&lt;foreach [in getClients()]&gt;&gt;
<li>&lt;&lt;[getName()]&gt;&gt;</li>
&lt;&lt;/foreach&gt;&gt;
</ul>
Regular text. <span style="background-color:orange">Highlighted text.</span>
```

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/Bulleted%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists b42b6ec6de4351826d7886fe3e701a0d >}}



---

## Bulleted List in HTML Document

Path: /assembly/net/bulleted-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bulleted List in HTML Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

### Creating a Bulleted List

Practising the following steps you can insert Bulleted List in an HTML document.

1.  To add a bulleted list start and end your list with `<ul></ul>` tag and list all the elements by enclosing them between `<li></li>` tag.
2.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   A report must show all the products in a bulleted list format.
*   A report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<ul>
&lt;&lt;foreach [in products]&gt;&gt;
<li>&lt;&lt;[ProductName]&gt;&gt;</li>
&lt;&lt;/foreach&gt;&gt;
</ul>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.html](https://github.com/rida-fatima-aspose/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/Bulleted%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists fb223b7e519191219fec1e9499c8e9d8 >}}



---

## Chart Series Coloring in Email Document

Path: /assembly/java/chart-series-coloring-in-email-document/

{{< alert style="info" >}}This feature is supported by version 18.6 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Email Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS Outlook 2013:

1.  Create a new Email
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your email
5.  Edit the Worksheet with your data to update the chart
6.  Save your Email

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The Report must be generated in the Email Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Chart Data (Excel)

|   | Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>> |
| --- | --- |
| Category 1 | 4.3 |
| Category 2 | 2.5 |
| Category 3 | 3.5 |
| Category 4 | 4.5 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Dynamic%20Chart%20Series%20Color.msg) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```java
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists 404351d4481debba2ce792f9fe485328 >}}



---

## Chart Series Coloring in Email Document

Path: /assembly/net/chart-series-coloring-in-email-document/

{{< alert style="info" >}}This feature is supported by version 18.6 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Chart Series Coloring in Email Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS Outlook 2013:

1.  Create a new Email
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your email
5.  Edit the Worksheet with your data to update the chart
6.  Save your Email

### Reporting Requirement

As a report developer, you are required to share contract price by manager dynamically with the following key requirements:

*   The report must show the  name of the manager
*   The report must show the total contract price for each manager 
*   Series color to be used in chart series 
*   The Report must be generated in the Email Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<Total Contract Prices by Managers<<foreach [m in
managers]>><<x [m.Manager]>>
```

#### Chart Data (Excel)

|   | Total Contract Price<<y [m.Total_Contract_Price]>><<seriesColor [color]>> |
| --- | --- |
| Category 1 | 4.3 |
| Category 2 | 2.5 |
| Category 3 | 3.5 |
| Category 4 | 4.5 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Template

Please download the sample Dynamic Chart Series Color document we created in this article:

*   [Chart Template.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Dynamic%20Chart%20Series%20Color.msg) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of chart series dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series to be colored dynamically, define corresponding color expressions in names of these series using **seriesColor** tags having the following syntax:
  
    ```csharp
    <<seriesColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists 70103f610e3f0e028c3af299d53bb0af >}}



---

## Classify Raw Text

Path: /classification/net/classify-raw-text/

### Simple IAB-2 text classification

Call **[Classify](https://reference.groupdocs.com/net/classification/groupdocs.classification.classifier/classify/methods/2)** method with a text as the first parameter to perform classification. Default taxonomy (IAB-2) and bestClassesCount (1) will be used.

```csharp
var response = classifier.Classify("Medicine is an important part of our lifes");
Console.WriteLine(response.BestClassName, response.BestClassProbability);
```

### Raw text classification with Documents taxonomy and 2 best classes to return

Taxonomy, bestClassesCount and precisionRecallBalance could also be specified:

```csharp
var response = classifier.Classify("Medicine is an important part of our lifes", 2, Taxonomy.Documents, PrecisionRecallBalance.Recall);
Console.WriteLine(response.BestClassName, response.BestClassProbability);
```

---

## Column Chart in Email Document

Path: /assembly/java/column-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Column Chart Report with Filtered, Grouped, and Ordered Data in Email Document format.{{< /alert >}}

## Column Chart in Email Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS Outlook 2013:

1.  Create a new Email.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Column" in the sidebar, you will see a gallery of charts.
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your email.
5.  Edit the Worksheet with your data to update the chart.
6.  Save your Email.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show total Contract Prices by Quarters

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Quarters<<foreach [in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x [key.getName()]>>
```

#### Chart Data (Excel)

<table border="1" cellspacing="0" cellpadding="0" width="710" style="width: 532.45pt; margin-left: 15.75pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="98" valign="top" style="width: 73.65pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">1st Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 0 &amp;&amp; c.getDate().getMonth() &lt;= 2).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">2nd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 3 &amp;&amp; c.getDate().getMonth() &lt;= 5).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">3rd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 6 &amp;&amp; c.getDate().getMonth() &lt;= 8).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">4th Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 9 &amp;&amp; c.getDate().getMonth() &lt;= 11).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 1</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr></tbody></table>
### Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist samicheemagroupdocs 4a9119379e148b36707ba34786513e39 >}}



---

## Column Chart in Email Document

Path: /assembly/net/column-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Column Chart Report with Filtered, Grouped, and Ordered Data in Email Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Column Chart in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

### Creating a Column Chart

Please follow below steps to create a column chart in MS Outlook 2013:

1.  Create a new Email.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Column" in the sidebar, you will see a gallery of charts.
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your email.
5.  Edit the Worksheet with your data to update the chart.
6.  Save your Email.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   A report must show total Order Quantity by Quarters

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Quantity by Quarters<<foreach
[in orders
.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>><<x
[Key.CustomerName]>>

```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1st Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 1 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 3).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2nd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 4 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 6).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3rd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 7 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 9).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4th Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 10 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 12).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 1</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists c963a35058a245134ee5d6edb97aa5ba >}}



---

## Common List Image in HTML Document

Path: /assembly/java/common-list-image-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common List in HTML Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must show multiple managers' picture and name.
*   Report must be generated in the HTML Document format.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
<<foreach [in getManagers()]>> <<image [getPhoto()]>>
<<[getName()]>>
<</foreach>>
```

### Download Common List Template

Please download the sample Common List document we created in this article:

*   [Common List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/Common%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 729966c553a7ce2b543d244a2183018d >}}



---

## Common List Image in HTML Document

Path: /assembly/net/common-list-image-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

## Common List in HTML Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   A report must show multiple customers' picture and name.
*   A report must be generated in the HTML Document format.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<img src="/assembly/net/images/common-list-image-word-processing-document.png" alt="common-list-image-word-processing-document" style="width:230px"/>

### Download Common List Template

Please download the sample Common List document we created in this article:

*   [Common List.html](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/master/Examples/Data/Source/HTML%20Templates/Common%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 39dc5b3a66fc69e513def1035a2bd5e8 >}}



---

## Common Master-Detail Image in HTML Document

Path: /assembly/java/common-master-detail-image-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common Master-Detail Image in HTML Document

### Reporting Requirement

As a report developer, you are required to represent the information of the managers and clients with the following key requirements:

*   Report must show managers' picture and name.
*   It must associate the managers with their clients.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
<<foreach [in getManagers()]
>> 
<<[getName()]>>
Clients: <<foreach [in getContracts()]>><<[indexOf() != 0 ? ", " : ""]>><<[getClient().getName()]>><</foreach>>
<</foreach>>
```

### Download Common Master-Detail Template

Please download the sample Common master-detail document we created in this article:

*   [Common Master-Detail.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/Common%20Master-Detail.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 4ac39db9865f7602818752db5e01a57e >}}



---

## Common Master-Detail Image in HTML Document

Path: /assembly/net/common-master-detail-image-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in HTML Document format.{{< /alert >}}

## Common Master-Detail Image in HTML Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and products with the following key requirements:

*   Report must show customers' picture and name.
*   It must associate the customers with their products.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<<foreach \[in customers\]>>

<table class="gd-assembly1"cellspacing="0" cellpadding="0" style="border-collapse: collapse; float: bottom; margin-top: 0pt; margin-right: 9pt; margin-bottom: 0pt; margin-left: 9pt; width: 132.15pt; height: 132.15pt ">
	<tbody>
		<tr>
			<td></td>
		</tr>
	</tbody>
</table>

**&lt;&lt;[CustomerName]>>**

**Products:**

**&lt;&lt;foreach [in Order]>><<[IndexOf() != 0 ? ", " : ""]>>**

**&lt;&lt;[Product.ProductName]>>**

**&lt;&lt;/foreach>>**

&lt;&lt;/foreach>>

 {{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Common Master-Detail Template

Please download the sample Common master-detail document we created in this article:

*   [Common Master-Detail.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/Common%20Master-Detail.html?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< gist rida-fatima-aspose 31319a8a70569c70ad671106eeb1404b >}}



---

## Comparing Folders

Path: /comparison/java/compare-folders/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare the contents of a folder (directory), process and save the result of processing. The steps for _starting the comparison_ and _configuring_ the display of the processing result in the resulting file are described below.

1. Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object. 
1. Call the `setDirectoryCompare` method to set the `DirectoryCompare` property to `true`.
1. If needed, call the `setFolderComparisonExtension` method to change the output format to `HTML`. By default the format is `TXT`.
1. If needed, call the`setShowOnlyChanged` method to `true` to display only changed items.
2. Initialize the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the path to the first compared folder and the `CompareOptions` object.
3. Call the [add](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-com.groupdocs.comparison.options.CompareOptions-) method of the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify a  path to the second folder and the `CompareOptions` object.
4. Call the [compare](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-com.groupdocs.comparison.options.CompareOptions-) method of the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify a path to save the compare results and the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object.

The following code snippet shows how to compare the `SourceFolder` and `TargetFolder` folders:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java

// ...
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
CompareOptions compareOptions = new CompareOptions();
compareOptions.setDirectoryCompare(true);
try (Comparer comparer = new Comparer("C:\\SourceFolder\\", compareOptions)) {
    comparer.add("C:\\TargetFolder\\", compareOptions);
    comparer.compare("C:\\result.html", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following images show the comparison result:

| Result in HTML                                                 | Result in TXT                                                 |
| -------------------------------------------------------------- | ------------------------------------------------------------- |
| ![](/comparison/java/images/result-comparison-folders-html.png) | ![](/comparison/java/images/result-comparison-folders-txt.png) |

---

## Comparing Folders

Path: /comparison/net/compare-folders/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare the contents of a folder (directory), process and save the result of processing. The steps for _starting the comparison_ and _configuring_ the display of the processing result in the resulting file are described below.

1. Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. 
1. Set the `DirectoryCompare` property to `true`.
1. If needed, set the `setFolderComparisonExtension` property to change the output format to `HTML`. By default the format is `TXT`.
1. If needed, set the`ShowOnlyChanged` property to `true` to display only changed items.
2. Initialize the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify the path to the first compared folder and the `CompareOptions` object.
3. Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/add/#add_*) method of the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify a  path to the second folder and the `CompareOptions` object.
4. Call the [Compare](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/compare/#compare) method of the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify a path to save the compare results and the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object.

The following code snippet shows how to compare the `SourceFolder` and `TargetFolder` folders:

{{< tabs "example1">}}
{{< tab ".NET" >}}
```cs
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
class YoursProgram
{
    static void Main(string[] args)
    {
        CompareOptions compareOptions = new CompareOptions
        {
            DirectoryCompare = true,
        };
        Comparer comparer = new Comparer("C:\\SourceFolder", compareOptions);
        comparer.Add("C:\\TargetFolder", compareOptions);
        comparer.Compare("C:\\Folder_to_save_result\\", compareOptions);
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The following images show the comparison result:

| Result in HTML                                                 | Result in TXT                                                 |
| -------------------------------------------------------------- | ------------------------------------------------------------- |
| ![](/comparison/net/images/result-comparison-folders-html.png) | ![](/comparison/net/images/result-comparison-folders-txt.png) |

---

## Comparing Folders

Path: /comparison/nodejs-java/compare-folders/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare the contents of a folder (directory), process and save the result of processing.

The following code snippet shows how to compare the two folders:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Create a CompareOptions instance to configure comparison settings
const compareOptions = new groupdocs.CompareOptions();

// Enable directory comparison mode
compareOptions.setDirectoryCompare(true);

// Initialize the Comparer with the source folder and the configured options
const comparer = new groupdocs.Comparer('sample-files/SourceFolder', compareOptions);

// Add the target folder to compare against
comparer.add('sample-files/TargetFolder', compareOptions);

// Run the comparison for directories and generate the result as an HTML file
comparer.compareDirectory('result.html', compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `CompareOptions` object and enables directory comparison mode by setting `setDirectoryCompare(true)`. It initializes the `Comparer` with the source folder path and the options, adds the target folder using `add()` with the same options, and then calls `compareDirectory()` instead of `compare()` to perform folder comparison. The result is saved as an HTML file that shows which files were added, deleted, or modified between the two folders.

The following images show the comparison result:

| Result in HTML                                                 | Result in TXT                                                 |
| -------------------------------------------------------------- | ------------------------------------------------------------- |
| ![](/comparison/nodejs-java/images/result-comparison-folders-html.png) | ![](/comparison/nodejs-java/images/result-comparison-folders-txt.png) |

---

## Comparing Folders

Path: /comparison/python-net/compare-folders/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to compare the contents of a folder (directory), process and save the result of processing. The steps for _starting the comparison_ and _configuring_ the display of the processing result in the resulting file are described below.

1. Instantiate the `CompareOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options/compareoptions)--> object. 
1. Set the `directory_compare` property of `CompareOptions` to `true`.
1. If needed, set the `folder_comparison_extension` to change the output format to `HTML`. By default, the format is `TXT`.
1. If needed, set the `show_only_changed`  to `true` to display only changed items.
2. Initialize the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify the path to the first compared folder and the `CompareOptions` object.
3. Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-com.groupdocs.comparison.options.CompareOptions-)--> method of the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify a path to the second folder and the `CompareOptions` object.
4. Call the `compare()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#compare-java.lang.String-com.groupdocs.comparison.options.CompareOptions-)--> method of the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify a path to save the compare results and the `CompareOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options/compareoptions)--> object.

The following code snippet shows how to compare the `folder1` and `folder2` folders:

```python
import groupdocs.comparison as gc

# Set output_format as 'TXT' or 'HTML'
def compare_folders(output_format, output_file_name, SOURCE_FOLDER, TARGET_FOLDER):
    # Set compare options for directory comparison
    compare_options = gc.options.CompareOptions()
    compare_options.directory_compare = True
    compare_options.folder_comparison_extension = (
        gc.options.FolderComparisonExtension.HTML
        if output_format == 'HTML'
        else gc.options.FolderComparisonExtension.TXT
    )

    # Create a new comparer with the source folder path and comparison options
    comparer = gc.Comparer(SOURCE_FOLDER, compare_options)

    # Add the target folder for comparison
    comparer.add(TARGET_FOLDER, compare_options)

    # Perform the comparison and save the result
    comparer.compare_directory(output_file_name, compare_options)

    print(f"\nFolders compared successfully.\nCheck output in {output_file_name}.")

```

The following images show the comparison result:

| Result in HTML                                                 | Result in TXT                                                 |
| -------------------------------------------------------------- | ------------------------------------------------------------- |
| ![](/comparison/python-net/images/result-comparison-folders-html.png) | ![](/comparison/python-net/images/result-comparison-folders-txt.png) |

---

## Composing signature with texture brush background

Path: /signature/java/composing-signature-with-texture-brush-background/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextureBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/TextureBrush) class to specify filling signature background with image for Text and Image signature types

 Here are the steps to use Texture brush with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate the [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) object with all required additional options and setup [Background.setBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/Background#setBrush(com.groupdocs.signature.domain.extensions.Brush)) property with instance of [TextureBrush](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/TextureBrush)   
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) to it.  
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

This example shows how to use Texture brush for signature background. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
Signature signature = new Signature("sample.pdf");
TextSignOptions options = new TextSignOptions("John Smith");
 
// adjust signature appearance brush
 
// setup background
Background background = new Background();
background.setColor(Color.GREEN);
background.setTransparency(0.5);
background.setBrush(new TextureBrush("sample.jpg"));
options.setBackground(background);              
 
// locate signature
options.setWidth(100);
options.setHeight(80);
options.setVerticalAlignment(VerticalAlignment.Center);
options.setHorizontalAlignment(HorizontalAlignment.Center);
Padding padding = new Padding();
padding.setTop(20);
padding.setRight(20);
options.setMargin(padding);
 
// set alternative signature implementation on document page
options.setSignatureImplementation(TextSignatureImplementation.Image);
 
// sign document to file
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Convert Files Within Document Containers

Path: /conversion/python-net/developer-guide/converting-documents/convert-files-within-document-containers/


This topic covers how to convert files embedded within document containers, such as compressed or packaged files, into individual output files. The following diagram illustrates the process of extracting and converting files within a document container:

{{< mermaid class="text-center" >}}
flowchart LR
    %% Nodes
    A["Document Container"]
    B["Extraction"]
    C["Conversion"]
    D["Converted File 1"]
    E["Converted File 2"]
    F["Converted File N"]

    %% Edge connections between nodes
    A --> B --> C --> D
    C --> E
    C --> F
{{< /mermaid >}}

The Extraction and Conversion processes are performed within a single call to the `convert_multiple(folder_path, convert_options)` method of the `Converter` class.

## Document Container File Types

The following file types are considered document containers:

### Email and Outlook

- **EML** - Email Message File.
- **EMLX** - Apple Mail Email File.
- **MSG** - Microsoft Outlook Message File.
- **OST** - Outlook Offline Data File.
- **PST** - Outlook Personal Information Store File.

### PDF

- **PDF** - PDF files that contain embedded resources.

### Word Processing

- **DOC** - The older Microsoft Word binary format.
- **DOCX** - The modern Word format.
- **DOT and DOTX** - Word template files.
- **RTF** - Rich Text Format.

### Compression

- **7Z** - 7-Zip Compressed File.
- **BZ2** - Bzip2 Compressed File.
- **CAB** - Windows Cabinet File.
- **CPIO** - CPIO Compressed File.
- **GZ** - Gnu Zipped Archive.
- **GZIP** - Gzip Compressed File.
- **LZ** - Lzip Compressed File.
- **LZMA** - LZMA Compressed File.
- **RAR** - RAR Compressed Archive.
- **TAR** - Consolidated Unix File Archive.
- **XZ** - Xz Compressed File.
- **Z** - Unix Compressed File.
- **ZIP** - ZIP Compressed File.

## Example: Convert Files Within Document Container

The following example demonstrates how to convert each compressed file in ZIP archive to PDF:
 
The file name template for the output files is `{file name}_{source file extension}.{output file extension}`. In this example, compressed file `business-plan.docx` is being saved converted and saved with file name `business-plan_docx.pdf`.

{{< tabs "example-1">}}
{{< tab "convert_files_within_document_container.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_files_within_document_container():
    # Instantiate Converter with the input document 
    with Converter("./compressed.zip") as converter:
        # Instantiate convert options 
        pdf_convert_options = PdfConvertOptions()

        # Extract, convert and save output files in PDF format
        converter.convert_multiple("./converted-files", pdf_convert_options)    

if __name__ == "__main__":
    convert_files_within_document_container()
```
{{< /tab >}}
{{< tab "compressed.zip" >}}  
{{< tab-text >}}
`compressed.zip` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-files-within-document-containers/compressed.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted-files" >}}  
{{< tab-text >}}
`converted-files` is the output folder path for the converted files. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/convert-files-within-document-containers/converted-files.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Convert specific pages

Path: /conversion/net/convert-specific-pages/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) also provides the feature to convert selected page number.

To convert specific pages, follow these steps:

1.   Create an instance of [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class and pass source document path as a constructor parameter.
2.   Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) class e.g. (**[PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions)** etc.)
3.   Set the [Pages](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pages) property of the [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) instance to the list of desired page number to be converted.
4.   Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method of [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class instance and pass the filename of the converted document and the instance of [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) from the previous steps.

The following code snippet shows how to convert first and third pages from the source document:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PdfConvertOptions options = new PdfConvertOptions
    {
        Pages = new List<int>{ 1, 3 }
    };
    converter.Convert("converted.pdf", options);
}
```

---

## Convert specific pages

Path: /markdown/net/convert-specific-pages/


Use the `PageNumbers` property of `ConvertOptions` to convert only selected pages (or worksheets) from the source document. Page numbering starts from 1.

### Using static method

{{< tabs "specific-pages-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    PageNumbers = new[] { 1, 3 }
};

// Convert only pages 1 and 3
MarkdownConverter.ToFile("business-plan.docx", "specific-pages-static.md", options);
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "specific-pages-static.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/convert-specific-pages/SpecificPagesStatic/specific-pages-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

{{< tabs "specific-pages-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

using var converter = new MarkdownConverter("business-plan.docx");

var options = new ConvertOptions
{
    PageNumbers = new[] { 1, 3 }
};

converter.Convert("specific-pages-instance.md", options);
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "specific-pages-instance.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/convert-specific-pages/SpecificPagesInstance/specific-pages-instance.md)
{{< /tab >}}
{{< /tabs >}}

### Save specific pages to a file

{{< tabs "specific-pages-file">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    PageNumbers = new[] { 2, 4, 5 }
};

MarkdownConverter.ToFile("business-plan.pdf", "specific-pages-file.md", options);
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "specific-pages-file.md" >}}  
```text
**Table of Contents**

Meridian Outdoor Co. — Business Plan .........................................................................................1FY2026 Strategic Plan.................................................................................................................1Table of Contents.............................................................................................................................2

1. Executive Summary..................................................
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/convert-specific-pages/SpecificPagesFile/specific-pages-file.md)
{{< /tab >}}
{{< /tabs >}}

---

## Convert specific pages

Path: /markdown/python-net/convert-specific-pages/


Use the `page_numbers` property of `ConvertOptions` to convert only selected pages (or worksheets) from the source document. Page numbering starts from 1.

### Using static method

{{< tabs "convert-pages-static">}}
{{< tab "convert_specific_pages_static.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def convert_specific_pages_static():
    """Convert only specific pages from a document using the static API."""

    # Step 1: Specify which pages to convert (1-based numbering)
    options = ConvertOptions()
    options.page_numbers = [1, 3]  # convert only pages 1 and 3

    # Step 2: Convert selected pages using keyword argument for options
    MarkdownConverter.to_file("business-plan.docx", "convert-specific-pages-static.md", convert_options=options)

if __name__ == "__main__":
    convert_specific_pages_static()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "convert-specific-pages-static.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



| Introduction |
| --- |
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/convert-specific-pages/convert_specific_pages_static/convert-specific-pages-static.txt)
{{< /tab >}}
{{< tab "convert-specific-pages-static.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/convert-specific-pages/convert_specific_pages_static/convert-specific-pages-static.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

{{< tabs "convert-pages-instance">}}
{{< tab "convert_specific_pages_instance.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def convert_specific_pages_instance():
    """Convert only specific pages from a document using the instance API."""

    # Step 1: Open the document with a context manager
    with MarkdownConverter("business-plan.docx") as converter:
        # Step 2: Specify which pages to convert (1-based numbering)
        options = ConvertOptions()
        options.page_numbers = [1, 3]  # convert only pages 1 and 3

        # Step 3: Convert and save the result
        converter.convert("convert-specific-pages-instance.md", convert_options=options)

if __name__ == "__main__":
    convert_specific_pages_instance()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "convert-specific-pages-instance.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



| Introduction |
| --- |
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/convert-specific-pages/convert_specific_pages_instance/convert-specific-pages-instance.txt)
{{< /tab >}}
{{< tab "convert-specific-pages-instance.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/convert-specific-pages/convert_specific_pages_instance/convert-specific-pages-instance.txt)
{{< /tab >}}
{{< /tabs >}}

### Save specific pages to a file

{{< tabs "convert-pages-to-file">}}
{{< tab "convert_specific_pages_to_file.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def convert_specific_pages_to_file():
    """Convert specific pages from a PDF and save the result to a file."""

    # Step 1: Specify which pages to convert (1-based numbering)
    options = ConvertOptions()
    options.page_numbers = [2, 4, 5]  # convert pages 2, 4, and 5

    # Step 2: Convert and save to file using keyword argument for options
    MarkdownConverter.to_file("business-plan.pdf", "convert-specific-pages.md", convert_options=options)

if __name__ == "__main__":
    convert_specific_pages_to_file()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "convert-specific-pages.txt" >}}  
```text
**TABLE**** ****OF**** ****CONTENTS**** **![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAOhAVcDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAAAAQFBgcIAwEJAv/EAGYQAAACBAoHBQUEBAoGBQsBCQMEAAEFEQYTFCExQVFhgfAkcZGhscHhBxUjNNElM0RU8RY1Q2QCRXSCCBJSU1VjZXWEoiZChZTC4jI2laXFFyJGVnJzkqS0tdLWJzdidobV5Ob0/8QAGwEBAQEAAwE
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/convert-specific-pages/convert_specific_pages_to_file/convert-specific-pages.txt)
{{< /tab >}}
{{< tab "convert-specific-pages.txt" >}}  
```text
**TABLE OF CONTENTS** ![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/wAARCAOhAVcDASIAAhEBAxEB/8QAHQAAAgMBAQEBAQAAAAAAAAAAAAQFBgcIAwEJAv/EAGYQAAACBAoHBQUEBAoGBQsBCQMEAAEFEQYTFCExQVFhgfAkcZGhscHhBxUjNNElM0RU8RY1Q2QCRXSCCBJSU1VjZXWEoiZChZTC4jI2laXFFyJGVnJzkqS0tdLWJzdidobV5Ob0/8QAGwEBAQEAAwEBAAAAAAAAAAAAAAQFAQM
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/convert-specific-pages/convert_specific_pages_to_file/convert-specific-pages.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Convert to Image with advanced options

Path: /conversion/net/convert-to-image-with-advanced-options/

GroupDocs.Conversion provides [ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions) to give you control over conversion result when convert to image. Along with [common convert options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}}) from the base class, [ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions) has the following additional options:

*   [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) specifies desired result document type. Available options are: *Tiff, Tif, Jpg, Jpeg, Png, Gig, Bmp, Ico, Psd, Wmf, Emf, Dcm, Webp, Dng, Svg, Jp2, Odg, J2c, J2k, Jpx, Jpf, Jpm, Eps, Cgm, Cdr, Cmx, Dib, Jpc, Jls, DjVu*.
*   [Width](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/width) specifies desired image width after conversion.
*   [Height](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/height) specifies desired image height after conversion.
*   [HorizontalResolution](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/horizontalresolution) specifies desired image horizontal resolution after conversion.
*   [VerticalResolution](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/verticalresolution) specifies desired image vertical resolution after conversion.
*   [Grayscale](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/grayscale) specifies if true converted image will be grayscaled.
*   [RotateAngle](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/rotateangle) specifies image rotation angle.
*   [FlipMode](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/flipmode) specifies image flip mode. Available options are: *None, FlipX, FlipY, FlipXY*.
*   [Brightness](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/brightness) adjusts image brightness.
*   [Contrast](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/contrast) adjusts image contrast.
*   [Gamma](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/gamma) adjusts image gamma.
*   [BackgroundColor](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/backgroundcolor) sets the background color where supported by the source format.
*   [CropArea](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/croparea) crops a rectangular area from the raster image after conversion. Specify as Rectangle(x, y, width, height).
*   [JpegOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/jpegoptions) contains JPEG specific convert options.
*   [TiffOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/tiffoptions) contains TIFF specific convert options.
*   [PsdOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/psdoptions) contains PSD specific convert options.
*   [WebpOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/webpoptions) contains WebP specific convert options.
*   [UsePdf](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions/usepdf). Sometimes, for better rendering and elements positioning the source document should be converted to PDF first. If this property is set to *true*, the input firstly is converted to PDF and after that to desired format.

The following code snippet shows how to convert to image with advanced options:

```csharp
string outputFileTemplate = Path.Combine(@"c:\output", "converted-page-{0}.png");
Func<SavePageContext, Stream> getPageStream = saveContext => new FileStream(string.Format(outputFileTemplate, saveContext.Page), FileMode.Create);
using (Converter converter = new Converter("sample.pdf"))
{
    ImageConvertOptions options = new ImageConvertOptions
    {
        Format = ImageFileType.Png,
        FlipMode = ImageFlipModes.FlipY,
        Brightness = 50,
        Contrast = 50,
        Gamma = 0.5F,
        Grayscale = true,
        HorizontalResolution = 300,
        VerticalResolution = 100
    };

    converter.Convert(getPageStream, options);
}
```

## Setting Background Color

Set a background color for the converted image where supported by the source format:

```csharp
using System.Drawing;
using (Converter converter = new Converter("sample.pdf"))
{
    ImageConvertOptions options = new ImageConvertOptions
    {
        Format = ImageFileType.Png,
        BackgroundColor = Color.White  // Use System.Drawing.Color
    };
    converter.Convert("white-background.png", options);
}
```

You can use any color from System.Drawing.Color or create custom colors:

```csharp
using System.Drawing;
using (Converter converter = new Converter("sample.pdf"))
{
    ImageConvertOptions options = new ImageConvertOptions
    {
        Format = ImageFileType.Png,
        BackgroundColor = Color.FromArgb(173, 216, 230)  // Light blue (RGB)
    };
    converter.Convert("custom-background.png", options);
}
```

## Cropping Image Area

Crop a specific rectangular area from the converted image. The CropArea property takes a Rectangle with X, Y coordinates for the top-left corner, and Width, Height for the dimensions:

```csharp
using GroupDocs.Conversion.Contracts;
using (Converter converter = new Converter("sample.pdf"))
{
    ImageConvertOptions options = new ImageConvertOptions
    {
        Format = ImageFileType.Png,
        CropArea = new Rectangle(100, 100, 400, 300)  // X, Y, Width, Height
    };
    converter.Convert("cropped-image.png", options);
}
```

You can combine BackgroundColor and CropArea:

```csharp
using System.Drawing;
using GroupDocs.Conversion.Contracts;
using (Converter converter = new Converter("sample.pdf"))
{
    ImageConvertOptions options = new ImageConvertOptions
    {
        Format = ImageFileType.Png,
        BackgroundColor = Color.LightGray,
        CropArea = new Rectangle(50, 50, 512, 512)
    };
    converter.Convert("background-and-crop.png", options);
}
```

### JpegOptions

[JpegOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/jpegoptions) is subset of [ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions) which allow enhanced control over conversions to JPEG format.

The following options are available:

*   [Quality](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/jpegoptions/quality) specifies desired image quality.
*   [ColorMode](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/jpegoptions/colormode) sets JPEG color mode. Available options are: *Rgb, YCbCr, Cmyk, Ycck, Grayscale*.
*   [Compression](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/jpegoptions/compression) sets JPEG compression methods. Available options are: *Baseline, Progressive, Lossless, JpegLs*.

### TiffOptions

[TiffOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/tiffoptions) is subset of  [ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions) which allow enhanced control over conversions to TIFF format.

The following options are available:

*   [Compression](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/tiffoptions/compression) sets TIFF compression method. Available options are: None, Lzw, Ccitt3, Ccitt4, Rle.

### PsdOptions

[PsdOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/psdoptions) is subset of  [ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions) which allow enhanced control over conversions to PSD format.

The following options are available:

*   [ChannelBitsCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/psdoptions/channelbitscount) sets bits count per channel.
*   [ChannelsCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/psdoptions/channelscount) sets color channels count.
*   [ColorMode](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/psdoptions/colormode) sets PSD color mode. Available options are: *Bitmap, Grayscale, Indexed, Rgb, Cmyk, Multichannel, Duotone, Lab*.
*   [Compression](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/psdoptions/compression) sets PSD compression method. Available options are: *Raw, Rle, ZipWithoutPrediction, ZipWithPrediction*.
*   [Version](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/psdoptions/version) sets desired PSD version.

### WebpOptions

[WebpOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webpoptions) is subset of  [ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions) which allow enhanced control over conversions to WebP format.

The following options are available:

*   [Lossless](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webpoptions/lossless) sets the compression of the converted image will be lossless.
*   [Quality](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webpoptions/quality) sets set the quality of converted image.

## More Resources

- [API Reference: ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})

---

## Convert to Presentation with advanced options

Path: /conversion/java/convert-to-presentation-with-advanced-options/


[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) offers the [PresentationConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/presentationconvertoptions/) class, allowing developers to have precise control over the conversion process when converting documents to presentation formats. In addition to the common conversion options provided by the base class, [PresentationConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/presentationconvertoptions/) introduces a range of advanced settings to enhance flexibility and meet specific requirements.
| Option | Description |
|--------|-------------|
|[**setFormat()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/#setFormat-com.groupdocs.conversion.filetypes.FileType-) | Defines the output presentation format. Supported formats include:`Ppt`, `Pps`, `Pptx`, `Ppsx`, `Odp`, `Otp`, `Potx`, `Pot`, `Potm`, `Pptm`, `Ppsm`. |
|[**setPassword()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/presentationconvertoptions/#setPassword-java.lang.String-) | Protects the converted presentation with a specified password to ensure confidentiality. |
|[**setZoom()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/presentationconvertoptions/#setZoom-int-) | Adjusts the zoom level of the converted presentation as a percentage. |

The following example demonstrates how to convert a document to a presentation format (e.g., .ppt) using advanced options:

{{< tabs "code-example">}}
{{< tab "ConvertToPresentationWithAdvancedOptions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.PresentationFileType;
import com.groupdocs.conversion.options.convert.PresentationConvertOptions;

public class ConvertToPresentationWithAdvancedOptions {
    public static void convert() {
        // Load the source document
        try(Converter converter = new Converter("annual-review.docx")) {
            // Configure presentation conversion options
            PresentationConvertOptions options = new PresentationConvertOptions();
            options.setPageNumber(2);                     // Start conversion from page 2
            options.setPagesCount(1);                     // Convert only 1 page
            options.setFormat(PresentationFileType.Ppt);  // Set output format to PowerPoint (.ppt)

            // Perform the conversion
            converter.convert("converted_with_options.ppt", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "annual-review.docx" >}}  
{{< tab-text >}}
`annual-review.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-presentation-with-advanced-options/annual-review.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_options.ppt" >}}  
{{< tab-text >}}
`converted_with_options.ppt` is converted PPT document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-presentation-with-advanced-options/converted_with_options.ppt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

By using advanced conversion options, developers can fine-tune the output presentation to ensure compatibility, security, and optimal formatting, making it a powerful tool for both professional and personal use.
---

## Convert to Presentation with advanced options

Path: /conversion/nodejs-java/convert-to-presentation-with-advanced-options/

[**GroupDocs.Conversion**](#) provides [PresentationConvertOptions](#) to give you control over conversion result when convert to presentation format. Along with [common convert options](#) from base class [PresentationConvertOptions](#) has the following additional options:

*   [setFormat](#) specifies desired result document type. Available options are: *Ppt, Pps, Pptx, Ppsx, Odp, Otp, Potx, Pot, Potm, Pptm, Ppsm*.
*   [setPassword](#) whether the converted document will be password protected with the specified password.
*   [setZoom](#) specifies the zoom level in percentage.

The following code snippet shows how to convert to Presentation with advanced options:

```js
const converter = new groupdocs.conversion.Converter("sample.docx");
const convertOptions = new groupdocs.conversion.PresentationConvertOptions();
convertOptions.setPageNumber(2);
convertOptions.setPagesCount(1);
convertOptions.setFormat(groupdocs.conversion.PresentationFileType.Ppt);
converter.convert("converted.ppt", convertOptions);
```

---

## Create EditableDocument from file or markup

Path: /editor/java/create-editabledocument-from-file-or-markup/

> This demonstration shows how to create instance of the EditableDocument class from HTML files from disk or from HTML markup with resources

## Introduction

When working with [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) in usual way by loading, opening, editing and saving documents, the instances of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class are produced by the [Editor.edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#edit--) method and accepted by the [Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method. However, in some cases it is required to create a [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance from existing HTML markup with optional resources. For example, some document was loaded to `Editor` class, opened for editing, and then [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) was saved to the disk as a set of HTML file and connected resources. Then this HTML document was passed to the WYSIWYG-editor, edited, and save back to the disk as modified HTML. Or raw output from the WYSIWYG-editor was saved to the `String` variable. In order to save it to some final format like DOCX or XLSX, user needs to pass the document to the [Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method in a form of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance. This means that user should create an instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class manually.

[EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) contains three public static methods for creating its instances: [fromFile()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromFile-java.lang.String-java.lang.String-), [fromMarkup()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkup-java.lang.String-java.util.List-) and [fromBodyMarkupAndResourceFolder()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkupAndResourceFolder-java.lang.String-java.lang.String-). This article reviews all of them.

## Opening from file

Let's suppose that we have an HTML file with edited document content, that is saved on the disk. There is also a folder with resources (images, fonts, stylesheets), that are used by this document, and document has correct links to this resources. Let's say, HTML document has name "document.html" and is located in the "input" folder. Resource folder is located in the same "input" folder and has name "document\_resources". And, what is most important, HTML markup from "document.html" has proper links to files from "document\_resources" folder. For example, there will be

<link rel = "stylesheet" type = "text/css" href = "document\_resources/style.css" />

in the "document.html", and "document\_resources" folder actually contains "style.css" file.

In that case creating the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance is the most simple:

```java
String inputHtmlPath = "C://input//document.html";
EditableDocument document = EditableDocument.fromFile(inputHtmlPath, null);
```

The [fromFile()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromFile-java.lang.String-java.lang.String-) method accepts two parameters, where first is a path to HTML file, while second is a path to resource folder. If HTML file contains correct links, as it is described above, second parameter is not necessary: GroupDocs.Editor will scan the links and automatically find the resource folder and correct resources. However, if path to resource folder doesn't match to the links in HTML file, it is possible to specify a resource folder forcibly, what is illustrated in code below:

```java
String inputHtmlPath = "C://input//document.html";
String inputResourceFolderPath = "C://input//document_resources/";
EditableDocument document = EditableDocument.fromFile(inputHtmlPath, inputResourceFolderPath);
```

If HTML file contains a link to same resource, that is not present in the resource folder, it will be omitted.

## Opening from markup

In some cases edited HTML document is not present as a file. It may be stored in database, obtained from remote storage, or something else. In such cases [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class delivers a [fromMarkup()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkup-java.lang.String-java.util.List-) method. This method, like previous, has two parameters:

* `String newHtmlContent` — string, that contains raw HTML markup. This parameter is mandatory.
* IEnumerable<[IHtmlResource](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource)> resources — this is a set of prepared resources (images, fonts, stylesheets), that are used or may be used in the HTML document. User needs to prepare this collection by himself. This parameter is optional, user may pass NULL or empty collection. As with previous method, if HTML markup refers to some resource, that is not found in "resources" collection, that it will be skipped (omitted).

The code example below demonstrates this approach.

```java
String inputHtmlMarkup = "<HTML><HEAD><TITLE>Edited document</TITLE>.....";
JpegImage image1 = new JpegImage("image1.jpg", /* stream or base64 text*/);
PngImage image2 = new PngImage("image2.png", /* stream or base64 text*/);
CssText stylesheet = new CssText("stylesheet.css", "p {color: black; text-align: left; }......", StandardCharsets.UTF_8);

List<IHtmlResource> allResources = new ArrayList<IHtmlResource>();
allResources.add(image1);
allResources.add(image2);
allResources.add(stylesheet);

EditableDocument document = EditableDocument.fromMarkup(inputHtmlMarkup, allResources);
```

## Opening from inner-BODY HTML content and folder with resources

All previously described methods of creating instances of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class assume that both HTML file or string with HTML markup contains a valid, well-formed HTML document in all according to all W3C requirements. Such document should contain an HTML Document Definition (DOCTYPE) and a root HTML element, that, in turn, has two and only two children: HEAD (with document meta-information) and a BODY (with document content). All stylesheets are included and/or embedded in the HEAD element (LINK and/or STYLE elements respectively), and are 'used by' content markup (by using 'class' and 'id' attributes, in most cases).

However, most of client-side WYSIWYG HTML-editors like TinyMCE and CKEditor are working only with inner content of BODY element: they can obtain only such markup on input and produce such markup on output. External stylesheet(s) are usually included in the HTML-editor settings or somewhere else, but not through HTML-markup (excepting the inline styles in the "style" attribute). For passing a HTML->BODY markup *into* the HTML-editor there is a [getBodyContent()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#getBodyContent--) method, that returns an inner content of HTML-BODY element. And, in counterpart, for obtaining a HTML markup *from* HTML-editor and creating a new [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance with this markup the new method was introduced in the 19.12 version: [fromBodyMarkupAndResourceFolder()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkupAndResourceFolder-java.lang.String-java.lang.String-). Like [fromFile()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromFile-java.lang.String-java.lang.String-) and [fromMarkup()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkup-java.lang.String-java.util.List-), this is also a static method, that serves as a factory for creating the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instances. It obtains two mandatory parameters:

* `String htmlBodyContent`— string, that contains raw HTML markup, that is located inside BODY element (between <BODY> and </BODY> tags, without this pair of opening/closing tags itself). Of course, this should be a valid markup.
* `String resourceFolderPath` — string, that contains a full path to the folder with all external resources for the opening document. If the folder doesn't exist, an exception will be thrown.

Because inner-BODY markup doesn't contain stylesheets (neither included not embedded), these stylesheets should be referenced by some another way. For obtaining them a second parameter exists; user should specify a full path to the folder, that contains an images, fonts and stylesheets, used by the HTML document, specified in the 1st parameter. GroupDocs.Editor scans this folder, founds \*.css files, opens them, parses their content, and if this content is valid, applies these stylesheets for the document. If stylesheet references on external images and/or fonts, GroupDocs.Editor will try to find these resources in this resource folder too. Also, if HTML markup, specified in the 1st parameter, contains external images, referenced using an IMG element, GroupDocs.Editor will try to find these images in this resource folder too. In other words, the [fromBodyMarkupAndResourceFolder()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkupAndResourceFolder-java.lang.String-java.lang.String-)  method "assumes" that contains resources for that specific HTML document, which inner-BODY content was specified in the 1st parameter.

---

## Create EditableDocument from file or markup

Path: /editor/net/create-editabledocument-from-file-or-markup/

> This demonstration shows how to create instance of the EditableDocument class from HTML files from disk or from HTML markup with resources

## Introduction

When working with [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) in usual way by loading, opening, editing and saving documents, the instances of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class are produced by the [Editor.Edit](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method and accepted by the [Editor.Save](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method. However, in some cases it is required to create a [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance from existing HTML markup with optional resources. For example, some document was loaded to `Editor` class, opened for editing, and then [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) was saved to the disk as a set of HTML file and connected resources. Then this HTML document was passed to the WYSIWYG-editor, edited, and save back to the disk as modified HTML. Or raw output from the WYSIWYG-editor was saved to the `string` variable. In order to save it to some final format like DOCX or XLSX, user needs to pass the document to the [Editor.Save](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method in a form of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance. This means that user should create an instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class manually.

[EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) contains three public static methods for creating its instances: [FromFile](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fromfile), [FromMarkup](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkup) and [FromMarkupAndResourceFolder](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder). Before version 21.10 there also was a method [FromBodyMarkupAndResourceFolder](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder/), but then it was removed due to its uselessness. This article reviews all of them.

## Opening from file

Let's suppose that we have an HTML file with edited document content, that is saved on the disk. There is also a folder with resources (images, fonts, stylesheets), that are used by this document, and document has correct links to this resources. Let's say, HTML document has name "document.html" and is located in the "input" folder. Resource folder is located in the same "input" folder and has name "document\_resources". And, what is most important, HTML markup from "document.html" has proper links to files from "document\_resources" folder. For example, there will be

<link rel = "stylesheet" type = "text/css" href = "document\_resources/style.css" />

in the "document.html", and "document\_resources" folder actually contains "style.css" file.

In that case creating the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance is the most simple:

```csharp
string inputHtmlPath = "C://input/document.html";
EditableDocument document = EditableDocument.FromFile(inputHtmlPath, null);
```

The [FromFile](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fromfile) method accepts two parameters, where first is a path to HTML file, while second is a path to resource folder. If HTML file contains correct links, as it is described above, second parameter is not necessary: GroupDocs.Editor will scan the links and automatically find the resource folder and correct resources. However, if path to resource folder doesn't match to the links in HTML file, it is possible to specify a resource folder forcibly, what is illustrated in code below:

```csharp
string inputHtmlPath = "C://input/document.html";
string inputResourceFolderPath = "C://input/document_resources/";
EditableDocument document = EditableDocument.FromFile(inputHtmlPath, inputResourceFolderPath);
```

If HTML file contains a link to same resource, that is not present in the resource folder, it will be omitted.

## Opening from markup and prepared resources

In some cases edited HTML document is not present as a file. It may be stored in database, obtained from remote storage, or something else. In such cases [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class delivers a [FromMarkup](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkup) method. This method, like previous, has two parameters:

* `string newHtmlContent` — string, that contains raw HTML markup. This parameter is mandatory.
* IEnumerable<[IHtmlResource](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource)> resources — this is a set of prepared resources (images, fonts, stylesheets, audio files), that are used or may be used in the HTML document. User needs to prepare this collection by himself. This parameter is optional, user may pass NULL or empty collection. As with previous method, if HTML markup refers to some resource, that is not found in "resources" collection, than it will be skipped (omitted).

The code example below demonstrates this approach.

```csharp
string inputHtmlMarkup = "<HTML><HEAD><TITLE>Edited document</TITLE>.....";
JpegImage image1 = new JpegImage("image1.jpg", /* stream or base64 text*/);
PngImage image2 = new PngImage("image2.png", /* stream or base64 text*/);
CssText stylesheet = new CssText("stylesheet.css", "p {color: black; text-align: left; }......", System.Text.Encoding.UTF8);

List<IHtmlResource> allResources = new List<IHtmlResource>();
allResources.Add(image1);
allResources.Add(image2);
allResources.Add(stylesheet);

EditableDocument document = EditableDocument.FromMarkup(inputHtmlMarkup, allResources);
```

Starting from the [version 25.7](https://releases.groupdocs.com/editor/net/release-notes/2025/groupdocs-editor-for-net-25-7-release-notes/) a new simplified overload of the `FromMarkup` method was implemented: `EditableDocument.FromMarkup(string newHtmlContent)`. This overload is useful when there is no any external HTML resources for the given HTML markup. This usually happens when the whole document content with HTML- and CSS-markup and all the resources is packed inside a single string (resources are packed to the HTML-markup using the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme) with base64 encoding). So, in case when the `inputHtmlMarkup` string variable from the example above contains all resources inside it, and there are no any external images, fonts, or stylesheets, the whole example above can be rewritten as below:

{{< tabs "FromMarkup simplified">}}
{{< tab "C#" >}}
```csharp
string inputHtmlMarkup = "<HTML><HEAD><TITLE>Edited document</TITLE>.....";//all content is here
EditableDocument document = EditableDocument.FromMarkup(inputHtmlMarkup);
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim inputHtmlMarkup As String = "<HTML><HEAD><TITLE>Edited document</TITLE>....." 'all content is here
Dim document As EditableDocument = EditableDocument.FromMarkup(inputHtmlMarkup)
```
{{< /tab >}}
{{< /tabs >}}

## Opening from markup and resource folder

In some cases there is an HTML markup of edited document, but resources are represented as a set of files, located in some specific folder. For example, original document was converted to [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) and then saved to the disk as an HTML document with *.html file and a folder with resources. Then it was loaded to the WYSIWYG-editor, edited by the end-user, and edited content was obtained back from the front-end to the back-end. So now there is an edited HTML markup, available as a stream, and a resource folder. In such case a new method [FromMarkupAndResourceFolder](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder) was introduced in version 21.10. Here is an example of its usage.

```csharp
string inputHtmlMarkup = "<HTML><HEAD><TITLE>Edited document</TITLE>.....";
string inputResourceFolderPath = "C://input/document_resources/";
  
EditableDocument document = EditableDocument.FromMarkupAndResourceFolder inputHtmlMarkup, inputResourceFolderPath);
```

The [FromMarkupAndResourceFolder](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder) method obtains two parameters of a [string](https://docs.microsoft.com/en-us/dotnet/api/system.string?view=net-5.0) type, both of which are mandatory. First one — `newHtmlContent` —  is a HTML markup, while second — `resourceFolderPath` — a full valid path to the resource folder, which do exist and contains the resources. If the folder doesn't exist, an exception will be thrown.

A lot of (or even most) WYSIWYG-editors modify the HTML structure of a document by removing the HTML, HEAD, BODY elements and some others, even a whole HEAD-block with metadata. In fact, most of client-side WYSIWYG HTML-editors like TinyMCE and CKEditor are working only with inner content of BODY element: they can obtain only such markup on input and produce such markup on output. External stylesheet(s) are usually included in the HTML-editor settings or somewhere else, but not through HTML-markup (excepting the inline styles in the "style" attribute). For passing a HTML->BODY markup _into_ the HTML-editor there is a [GetBodyContent()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getbodycontent) method, that returns an inner content of HTML-BODY element. Problem is that when edited HTML markup is obtained back from WYSIWYG-editor, it usually doesn't contain links to the external stylesheets at all.

The [FromMarkupAndResourceFolder](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder) method is very useful in especially such cases, because it scans the resource folder, specified in a `resourceFolderPath` parameter, reads all found *.css files, and applies parsed stylesheets to the document content. This is the main distinction between this method and previously described [FromFile](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fromfile), — this one applies all stylesheets in the folder to the document, while [FromFile](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fromfile) applies only those stylesheets, which are explicitly referenced from HTML markup.

So, concluding. When the [FromMarkupAndResourceFolder()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder) is invoked, the GroupDocs.Editor scans a folder, specified in the `resourceFolderPath` parameter, founds all *.css files, opens them, parses their content, and if this content is valid, applies these stylesheets for the document. If any stylesheet is referencing on external images and/or fonts, GroupDocs.Editor will try to find these resources in this resource folder too. Also, if HTML markup, specified in the 1st parameter, contains external images, referenced using an IMG element, GroupDocs.Editor will try to find these images in this resource folder too. In other words, the [FromMarkupAndResourceFolder()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder) method "assumes" that the `resourceFolderPath` contains resources for that specific HTML document, which markup is specified in the 1st parameter.

---

## Create EditableDocument from File or Markup

Path: /editor/nodejs-java/create-editabledocument-from-file-or-markup/


> This demonstration shows how to create an instance of the `EditableDocument` class from HTML files on disk or from HTML markup with resources in Node.js via Java.

## Introduction

When working with [**GroupDocs.Editor**](https://products.groupdocs.com/editor/nodejs-java) in the usual way by loading, opening, editing, and saving documents, instances of the `EditableDocument` class are produced by the `editor.edit()` method and accepted by the `editor.save()` method. However, in some cases, it is required to create an `EditableDocument` instance from existing HTML markup with optional resources.

For example, a document was loaded into the `Editor` class, opened for editing, and then the `EditableDocument` was saved to disk as a set of HTML files and connected resources. Then this HTML document was passed to a WYSIWYG editor, edited, and saved back to disk as modified HTML. Or the raw output from the WYSIWYG editor was saved to a string variable. To save it to some final format like DOCX or XLSX, you need to pass the document to the `editor.save()` method in the form of an `EditableDocument` instance. This means you should create an instance of the `EditableDocument` class manually.

The `EditableDocument` class contains three public static methods for creating its instances:

- `fromFile()`
- `fromMarkup()`
- `fromBodyMarkupAndResourceFolder()`

This article reviews all of them.

## Opening from File

Let's suppose that we have an HTML file with edited document content saved on disk. There is also a folder with resources (images, fonts, stylesheets) that are used by this document, and the document has correct links to these resources.

Let's say the HTML document is named "document.html" and is located in the "input" folder. The resource folder is located in the same "input" folder and is named "document_resources". Importantly, the HTML markup from "document.html" has proper links to files from the "document_resources" folder. For example, there will be:

```html
<link rel="stylesheet" type="text/css" href="document_resources/style.css" />
```

in the "document.html", and the "document_resources" folder actually contains the "style.css" file.

In that case, creating the `EditableDocument` instance is straightforward:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Specify the input HTML file path
const inputHtmlPath = 'C://input//document.html';

// Create an EditableDocument from the file
const editableDocument = groupdocsEditor.EditableDocument.fromFile(inputHtmlPath);
```

The `fromFile()` method accepts two parameters:

- The first is the path to the HTML file.
- The second is the path to the resource folder (optional).

If the HTML file contains correct links, as described above, the second parameter is not necessary; GroupDocs.Editor will scan the links and automatically find the resource folder and correct resources. However, if the path to the resource folder doesn't match the links in the HTML file, it is possible to specify a resource folder forcibly, as illustrated below:

```javascript
// Specify the input HTML file and resource folder paths
const inputHtmlPath = 'C://input//document.html';
const inputResourceFolderPath = 'C://input//document_resources/';

// Create an EditableDocument from the file and resource folder
const editableDocument = groupdocsEditor.EditableDocument.fromFile(inputHtmlPath, inputResourceFolderPath);
```

If the HTML file contains a link to a resource that is not present in the resource folder, it will be omitted.

## Opening from Markup

In some cases, the edited HTML document is not present as a file. It may be stored in a database, obtained from remote storage, or something else. In such cases, the `EditableDocument` class provides the `fromMarkup()` method. This method has two parameters:

- `newHtmlContent`: A string that contains raw HTML markup. This parameter is mandatory.
- `resources`: An array of prepared resources (images, fonts, stylesheets) that are used or may be used in the HTML document. You need to prepare this collection yourself. This parameter is optional; you may pass an empty array. As with the previous method, if the HTML markup refers to a resource that is not found in the "resources" collection, it will be skipped (omitted).

The code example below demonstrates this approach:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// The HTML markup as a string
const inputHtmlMarkup = '<html><head><title>Edited document</title></head><body>...</body></html>';

// Prepare resources
const fs = require('fs');
const path = require('path');

// Assuming you have the resources as files or in memory
const image1Content = fs.readFileSync('path/to/image1.jpg');
const image2Content = fs.readFileSync('path/to/image2.png');
const stylesheetContent = 'p { color: black; text-align: left; } ...';

// Create resource instances
const image1 = new groupdocsEditor.JpegImage('image1.jpg', image1Content);
const image2 = new groupdocsEditor.PngImage('image2.png', image2Content);
const stylesheet = new groupdocsEditor.CssText('stylesheet.css', stylesheetContent, 'UTF-8');

// Add resources to an array
const allResources = [image1, image2, stylesheet];

// Create an EditableDocument from the markup and resources
const editableDocument = groupdocsEditor.EditableDocument.fromMarkup(inputHtmlMarkup, allResources);
```

## Opening from Inner BODY HTML Content and Resource Folder

All previously described methods of creating instances of the `EditableDocument` class assume that both the HTML file or string with HTML markup contains a valid, well-formed HTML document according to all W3C requirements. Such a document should contain an HTML Document Definition (DOCTYPE) and a root `<html>` element that, in turn, has two and only two children: `<head>` (with document meta-information) and `<body>` (with document content). All stylesheets are included and/or embedded in the `<head>` element (`<link>` and/or `<style>` elements, respectively), and are 'used by' content markup (by using `class` and `id` attributes, in most cases).

However, most client-side WYSIWYG HTML editors like TinyMCE and CKEditor work only with the inner content of the `<body>` element: they can obtain only such markup on input and produce such markup on output. External stylesheets are usually included in the HTML editor settings or somewhere else, but not through HTML markup (except for the inline styles in the `style` attribute).

To pass HTML `<body>` markup *into* the HTML editor, there is a `getBodyContent()` method, which returns the inner content of the HTML `<body>` element. Conversely, to obtain HTML markup *from* the HTML editor and create a new `EditableDocument` instance with this markup, the `fromBodyMarkupAndResourceFolder()` method is used. This method obtains two mandatory parameters:

- `htmlBodyContent`: A string that contains raw HTML markup located inside the `<body>` element (between `<body>` and `</body>` tags, without these opening/closing tags themselves). This should be valid markup.
- `resourceFolderPath`: A string that contains the full path to the folder with all external resources for the opening document. If the folder doesn't exist, an exception will be thrown.

Because inner `<body>` markup doesn't contain stylesheets (neither included nor embedded), these stylesheets should be referenced in another way. To obtain them, the second parameter exists; you should specify a full path to the folder that contains images, fonts, and stylesheets used by the HTML document specified in the first parameter. GroupDocs.Editor scans this folder, finds `.css` files, opens them, parses their content, and if this content is valid, applies these stylesheets to the document. If a stylesheet references external images and/or fonts, GroupDocs.Editor will try to find these resources in this resource folder too. Also, if the HTML markup specified in the first parameter contains external images referenced using an `<img>` element, GroupDocs.Editor will try to find these images in this resource folder too. In other words, the `fromBodyMarkupAndResourceFolder()` method "assumes" that the resource folder contains resources for that specific HTML document, whose inner `<body>` content was specified in the first parameter.

Here's how you can use this method:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// The inner BODY HTML content as a string (without <body> tags)
const htmlBodyContent = '<p>This is the edited content...</p>';

// Specify the resource folder path
const resourceFolderPath = 'C://input//document_resources/';

// Create an EditableDocument from body markup and resource folder
const editableDocument = groupdocsEditor.EditableDocument.fromBodyMarkupAndResourceFolder(htmlBodyContent, resourceFolderPath);
```

By using these methods, you can create `EditableDocument` instances from different sources, enabling you to save the edited content back to the desired output format using the `editor.save()` method.

---

**Note:** In this guide, we replaced any links to previous versions with "20.6" as per your instruction. The `fromBodyMarkupAndResourceFolder()` method was introduced in the **20.6 version** of GroupDocs.Editor for Node.js via Java.

---

By following this guide, you can effectively create `EditableDocument` instances from HTML files or markup, which allows you to save edited documents back to various formats using GroupDocs.Editor for Node.js via Java.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---
---

## Customize changes styles

Path: /comparison/java/customize-changes-styles/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) provides the compare options collection to set up the appropriate comparison speed and quality.

To compare two documents with custom change style settings, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object. Specify the appropriate parameters.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object.

The following code snippets show how to compare documents with specific options:

## Compare documents from local disk with custom change styles

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.style.StyleSettings;
import java.awt.*;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    
    CompareOptions compareOptions = new CompareOptions();

    final StyleSettings insertedStyleSettings = new StyleSettings();
    insertedStyleSettings.setHighlightColor(Color.RED);
    insertedStyleSettings.setFontColor(Color.GREEN);
    insertedStyleSettings.setUnderline(true);
    insertedStyleSettings.setBold(true);
    insertedStyleSettings.setStrikethrough(true);
    insertedStyleSettings.setItalic(true);
    compareOptions.setInsertedItemStyle(insertedStyleSettings);

    final StyleSettings deletedStyleSettings = new StyleSettings();
    deletedStyleSettings.setHighlightColor(Color.PINK);
    deletedStyleSettings.setFontColor(Color.CYAN);
    deletedStyleSettings.setUnderline(true);
    deletedStyleSettings.setBold(true);
    deletedStyleSettings.setStrikethrough(true);
    deletedStyleSettings.setItalic(true);
    compareOptions.setDeletedItemStyle(deletedStyleSettings);

    final StyleSettings changedStyleSettings = new StyleSettings();
    changedStyleSettings.setHighlightColor(Color.LIGHT_GRAY);
    changedStyleSettings.setFontColor(Color.GRAY);
    changedStyleSettings.setUnderline(true);
    changedStyleSettings.setBold(true);
    changedStyleSettings.setStrikethrough(true);
    changedStyleSettings.setItalic(true);
    compareOptions.setChangedItemStyle(changedStyleSettings);

    final Path resultPath = comparer.compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/customize-changes-styles.png)

## Compare documents from stream with custom change styles

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.style.StyleSettings;
import java.awt.*;
import java.nio.file.Path;
import java.io.FileInputStream;
import java.io.InputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream)) {
    comparer.add(targetInputStream);
    
    CompareOptions compareOptions = new CompareOptions();

    final StyleSettings insertedStyleSettings = new StyleSettings();
    insertedStyleSettings.setHighlightColor(Color.RED);
    insertedStyleSettings.setFontColor(Color.GREEN);
    insertedStyleSettings.setUnderline(true);
    insertedStyleSettings.setBold(true);
    insertedStyleSettings.setStrikethrough(true);
    insertedStyleSettings.setItalic(true);
    compareOptions.setInsertedItemStyle(insertedStyleSettings);

    final StyleSettings deletedStyleSettings = new StyleSettings();
    deletedStyleSettings.setHighlightColor(Color.PINK);
    deletedStyleSettings.setFontColor(Color.CYAN);
    deletedStyleSettings.setUnderline(true);
    deletedStyleSettings.setBold(true);
    deletedStyleSettings.setStrikethrough(true);
    deletedStyleSettings.setItalic(true);
    compareOptions.setDeletedItemStyle(deletedStyleSettings);

    final StyleSettings changedStyleSettings = new StyleSettings();
    changedStyleSettings.setHighlightColor(Color.LIGHT_GRAY);
    changedStyleSettings.setFontColor(Color.GRAY);
    changedStyleSettings.setUnderline(true);
    changedStyleSettings.setBold(true);
    changedStyleSettings.setStrikethrough(true);
    changedStyleSettings.setItalic(true);
    compareOptions.setChangedItemStyle(changedStyleSettings);

    final Path resultPath = comparer.compare(resultInputStream, compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Customize changes styles

Path: /comparison/net/customize-changes-styles/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) provides the compare options collection to set up the appropriate comparison speed and quality.

To compare two documents with custom change style settings, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object. Specify the appropriate parameters.
4.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object.

The following code snippets show how to compare documents with specific options:

## Compare documents from local disk with custom change styles

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions compareOptions = new CompareOptions()
    {
        InsertedItemStyle = new StyleSettings()
        {
            HighlightColor = System.Drawing.Color.Red,
            FontColor = System.Drawing.Color.Green,
            IsUnderline = true,
            IsBold = true,
            IsStrikethrough = true,
            IsItalic = true
        },
        DeletedItemStyle = new StyleSettings()
        {
            HighlightColor = System.Drawing.Color.Azure,
            FontColor = System.Drawing.Color.Brown,
            IsUnderline = true,
            IsBold = true,
            IsStrikethrough = true,
            IsItalic = true
        },
        ChangedItemStyle = new StyleSettings()
        {
            HighlightColor = System.Drawing.Color.Crimson,
            FontColor = System.Drawing.Color.Firebrick,
            IsUnderline = true,
            IsBold = true,
            IsStrikethrough = true,
            IsItalic = true
        }
    };
    comparer.Compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/customize-changes-styles.png)

## Compare documents from stream with custom change styles

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer(File.OpenRead("source.docx")))
{
    comparer.Add(File.OpenRead("target.docx"));
    CompareOptions compareOptions = new CompareOptions()
    {
        InsertedItemStyle = new StyleSettings()
        {
            HighlightColor = System.Drawing.Color.Red,
            FontColor = System.Drawing.Color.Green,
            IsUnderline = true,
            IsBold = true,
            IsStrikethrough = true,
            IsItalic = true
        },
        DeletedItemStyle = new StyleSettings()
        {
            HighlightColor = System.Drawing.Color.Azure,
            FontColor = System.Drawing.Color.Brown,
            IsUnderline = true,
            IsBold = true,
            IsStrikethrough = true,
            IsItalic = true
        },
        ChangedItemStyle = new StyleSettings()
        {
            HighlightColor = System.Drawing.Color.Crimson,
            FontColor = System.Drawing.Color.Firebrick,
            IsUnderline = true,
            IsBold = true,
            IsStrikethrough = true,
            IsItalic = true
        }
    };
    comparer.Compare(File.Create("result.docx"), compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Customize changes styles

Path: /comparison/nodejs-java/customize-changes-styles/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) provides the compare options collection to set up the appropriate comparison speed and quality.

The following code snippets show how to compare documents with specific options.

## Compare documents from a local disk with custom change styles

The following example compares two DOCX files from disk and applies custom styles to inserted, deleted, and changed content in the result.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and output documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const resultFile = 'output/result.docx';

// Initialize the comparer with the source document and add the target
const comparer = new groupdocs.Comparer(sourceFile);
comparer.add(targetFile);

// Create comparison options to configure visual styling of changes
const compareOptions = new groupdocs.CompareOptions();

// Configure style for inserted items (text added in the target document)
const insertedStyleSettings = new groupdocs.StyleSettings();
insertedStyleSettings.setUnderline(true);
insertedStyleSettings.setBold(true);
insertedStyleSettings.setStrikethrough(true);
insertedStyleSettings.setItalic(true);
compareOptions.setInsertedItemStyle(insertedStyleSettings);

// Configure style for deleted items (text removed from the source document)
const deletedStyleSettings = new groupdocs.StyleSettings();
deletedStyleSettings.setUnderline(true);
deletedStyleSettings.setBold(true);
deletedStyleSettings.setStrikethrough(true);
deletedStyleSettings.setItalic(true);
compareOptions.setDeletedItemStyle(deletedStyleSettings);

// Configure style for changed items (text modified between documents)
const changedStyleSettings = new groupdocs.StyleSettings();
changedStyleSettings.setUnderline(true);
changedStyleSettings.setBold(true);
changedStyleSettings.setStrikethrough(true);
changedStyleSettings.setItalic(true);
compareOptions.setChangedItemStyle(changedStyleSettings);

// Run the comparison using the configured styling options
comparer.compare(resultFile, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It then creates separate `StyleSettings` objects for inserted, deleted, and changed items, configuring each with underline, bold, strikethrough, and italic formatting. These style settings are applied to the comparison options, and when the comparison is performed, all detected changes will be styled according to these custom settings in the result document.

The result is as follows:

![](/comparison/nodejs-java/images/customize-changes-styles.png)

## Compare documents from a stream with custom change styles

The following example performs the same comparison using document streams and applies color-based styles for each type of change.

```javascript
'use strict';

// Import GroupDocs.Comparison for Node.js via Java and Java interop utilities
const groupdocs = require('@groupdocs/groupdocs.comparison');

//----------------------------------------------------
//----------------------------------------------------
const java = require('java');
let InputStream = java.import('java.io.FileInputStream');
let Color = java.import('java.awt.Color');

//----------------------------------------------------
// Create input streams for the source and target documents
const sourceInputStream = new InputStream('sample-files/source.docx');
const targetInputStream = new InputStream('sample-files/target.docx');

//----------------------------------------------------
// Initialize the comparer with the source document stream
const comparer = new groupdocs.Comparer(sourceInputStream);

//----------------------------------------------------
// Add the target document stream to the comparer
comparer.add(targetInputStream);

//----------------------------------------------------
// Prepare comparison options to customize visual styles
const compareOptions = new groupdocs.CompareOptions();

//----------------------------------------------------
// Configure style for inserted items (e.g., text added in the target)
const insertedStyleSettings = new groupdocs.StyleSettings();
insertedStyleSettings.setHighlightColor(Color.RED);      // Highlight inserted text in red
insertedStyleSettings.setFontColor(Color.GREEN);        // Set font color to green
insertedStyleSettings.setUnderline(true);               // Underline inserted text
insertedStyleSettings.setBold(true);                    // Make inserted text bold
insertedStyleSettings.setStrikethrough(true);           // Apply strikethrough (optional visual cue)
insertedStyleSettings.setItalic(true);                  // Italicize inserted text
compareOptions.setInsertedItemStyle(insertedStyleSettings); // Apply inserted style to options

//----------------------------------------------------
// Configure style for deleted items (e.g., text removed from the source)
const deletedStyleSettings = new groupdocs.StyleSettings();
deletedStyleSettings.setHighlightColor(Color.PINK);      // Highlight deleted text in pink
deletedStyleSettings.setFontColor(Color.CYAN);          // Set font color to cyan
deletedStyleSettings.setUnderline(true);                // Underline deleted text
deletedStyleSettings.setBold(true);                     // Make deleted text bold
deletedStyleSettings.setStrikethrough(true);            // Strike through deleted text
deletedStyleSettings.setItalic(true);                   // Italicize deleted text
compareOptions.setDeletedItemStyle(deletedStyleSettings); // Apply deleted style to options

//----------------------------------------------------
// Configure style for changed items (e.g., text modified between documents)
const changedStyleSettings = new groupdocs.StyleSettings();
changedStyleSettings.setHighlightColor(Color.LIGHT_GRAY); // Highlight changes in light gray
changedStyleSettings.setFontColor(Color.GRAY);            // Set font color to gray
changedStyleSettings.setUnderline(true);                 // Underline changed text
changedStyleSettings.setBold(true);                      // Make changed text bold
changedStyleSettings.setStrikethrough(true);             // Strikethrough changed text
changedStyleSettings.setItalic(true);                    // Italicize changed text
compareOptions.setChangedItemStyle(changedStyleSettings); // Apply changed style to options

//----------------------------------------------------
// Define the output path for the comparison result document
const resultPath = 'result.docx';

//----------------------------------------------------
// Execute the comparison and save the result using the defined options
comparer.compare(resultPath, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates the same workflow using Java input streams instead of file paths. It creates `InputStream` objects for both documents, initializes the comparer with the source stream, adds the target stream, and creates `CompareOptions` with custom `StyleSettings`. In this case, the styles include color settings: inserted items are highlighted in red with green font, deleted items are highlighted in pink with cyan font, and changed items are highlighted in light gray with gray font. All items also have underline, bold, strikethrough, and italic formatting applied.

---

## Customize changes styles

Path: /comparison/python-net/customize-changes-styles/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) provides a rich set of options to control the look of detected changes in the result document.

To compare two documents with custom change style settings, follow these steps:

1. Instantiate the `Comparer` object with a source path or stream.
2. Call `add()` and provide the target path or stream.
3. Instantiate `CompareOptions` and configure `InsertedItemStyle`, `DeletedItemStyle`, and `ChangedItemStyle`.
4. Call `compare()` with the options and a result path or stream.

## Compare documents from local disk with custom change styles

Configure custom highlight, font, and style settings for inserted, deleted, and changed items, then run the comparison to produce a styled result.

```python
import groupdocs.comparison as gc

source_path = "source.docx"
target_path = "target.docx"
result_path = "result.docx"

options = gc.CompareOptions()
options.inserted_item_style = gc.StyleSettings(
    highlight_color=gc.Color.from_name("red"),
    font_color=gc.Color.from_name("green"),
    is_underline=True,
    is_bold=True,
    is_strikethrough=True,
    is_italic=True,
)
options.deleted_item_style = gc.StyleSettings(
    highlight_color=gc.Color.from_name("azure"),
    font_color=gc.Color.from_name("brown"),
    is_underline=True,
    is_bold=True,
    is_strikethrough=True,
    is_italic=True,
)
options.changed_item_style = gc.StyleSettings(
    highlight_color=gc.Color.from_name("crimson"),
    font_color=gc.Color.from_name("firebrick"),
    is_underline=True,
    is_bold=True,
    is_strikethrough=True,
    is_italic=True,
)

with gc.Comparer(source_path) as comparer:
    comparer.add(target_path)
    comparer.compare(result_path, options)
```

🔹 Use case: Enforce corporate branding for change highlights in contract reviews.

## Compare documents from stream with custom change styles

Load documents as streams, apply custom `StyleSettings` for all change types, and write the styled result to a stream.

```python
import groupdocs.comparison as gc

options = gc.CompareOptions()
options.inserted_item_style = gc.StyleSettings(
    highlight_color=gc.Color.from_name("red"),
    font_color=gc.Color.from_name("green"),
    is_underline=True,
    is_bold=True,
    is_strikethrough=True,
    is_italic=True,
)
options.deleted_item_style = gc.StyleSettings(
    highlight_color=gc.Color.from_name("azure"),
    font_color=gc.Color.from_name("brown"),
    is_underline=True,
    is_bold=True,
    is_strikethrough=True,
    is_italic=True,
)
options.changed_item_style = gc.StyleSettings(
    highlight_color=gc.Color.from_name("crimson"),
    font_color=gc.Color.from_name("firebrick"),
    is_underline=True,
    is_bold=True,
    is_strikethrough=True,
    is_italic=True,
)

with open("source.docx", "rb") as src, open("target.docx", "rb") as tgt, open("result.docx", "wb") as out_stream:
    with gc.Comparer(src) as comparer:
        comparer.add(tgt)
        comparer.compare(out_stream, options)
```

The result document will highlight inserted, deleted, and changed items using your specified styles.

🔹 Use case: Process documents in memory (no temp files) while keeping brand-compliant styling.



---

## Customize watermarks

Path: /watermark/net/basic-usage/customize/

GroupDocs.Watermark offers many capabilities to customize how the watermark would look and where it will be positioned within the document.

## Customizing text watermarks

To adjust a text watermark to your needs, use the properties of the [`TextWatermark`](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/textwatermark/#properties) class. 

The following options could be set:
| Option | Description |
|--------|-------------|
|**[BackgroundColor](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/textwatermark/backgroundcolor)** | Specifies the background color of the text. |
|**[ConsiderParentMargins](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/considerparentmargins)** | Whether to take into account the existing page margins of the document when calculating the watermark's size and coordinates. Default: false.|
|**[Font](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/textwatermark/font)** | Specifies the current font of the text watermark. |
|**[ForegroundColor](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/textwatermark/foregroundcolor)** | Specifies the foreground color of the text. |
|**[Height](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/height)** | Specifies the desired height of the watermark. |
|**[HorizontalAlignment](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/horizontalalignment)** | Specifies the horizontal alignment of the watermark. Possible values are `None` (default), `Left`, `Center`, and `Right`.|
|**[IsBackground](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/isbackground)** | Whether to place the watermark below (true) or above (true) the main content. Default: false. |
|**[Margins](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/margins)** | Specifies the watermark margins. |
|**[Opacity](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/opacity)** | Defines the opacity of the watermark as a value ranging from 0 (fully transparent) to 1 (solid filling). |
|**[RotateAngle](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/rotateangle/)** | Defines the rotation angle of the watermark. A positive value corresponds to a clockwise rotation angle, negative - to a counterclockwise rotation angle. |
|**[ScaleFactor](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/scalefactor)** | Specifies how the watermark size depends on the size of a parent document. |
|**[SizingType](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/sizingtype)** | Specifies a way the watermark should be sized. Possible values are `Auto` (default), `Absolute`, `ScaleToParentDimensions`, and `ScaleToParentArea`. |
|**[Text](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/textwatermark/text)** | Defines the text of the watermark. |
|**[TextAlignment](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/textwatermark/textalignment)** | Specifies the alignment of text. Possible values are `Left` (default), `Center`, `Right`, and `Justify`.  |
|**[VerticalAlignment](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/verticalalignment)** | Specifies the vertical alignment of the watermark. Possible values are `None` (default), `Left`, `Center`, and `Bottom`. |
|**[Width](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/width)** | Specifies the desired width of the watermark. |
|**[X](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/x)** | Specifies the horizontal coordinate of the watermark within the parent document. |
|**[Y](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/y)** | Specifies the vertical coordinate of the watermark within the parent document. |


The code below demonstrates how to specify the desired watermark appearance and position before applying it to the document:

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Common;
using GroupDocs.Watermark.Watermarks;

// Specify an absolute or relative path to your document.
using (Watermarker watermarker = new Watermarker("C:\\Docs\\sample.docx"))
{
    // Specify the desired text and font for the watermark
    TextWatermark watermark = new TextWatermark("Customized watermark.", 
        new Font("Arial", 24, FontStyle.Bold));
    // Specify the appearance and the position of the watermark
    watermark.ForegroundColor = Color.DarkOrange;
    watermark.ConsiderParentMargins = true;
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Top;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.RotateAngle = 45;
    watermark.ScaleFactor = 0.7;
    // Apply the watermark
    watermarker.Add(watermark);
    // Save the resulting document
    watermarker.Save("C:\\Docs\\watermarked-sample.docx");
}
```
Run the program. A watermark will be added at a specified position and will have the specified look.

![Customized text watermark](/watermark/net/images/watermarking/custom-text-watermark.png)

## Customizing image watermarks

Image watermarks have similar settings that affect their look and position. To adjust an image watermark, use the properties of the [`ImageWatermark`](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.watermarks/imagewatermark/#properties) class. 

The following options could be set:
| Option | Description |
|--------|-------------|
|**[ConsiderParentMargins](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/considerparentmargins)** | Whether to take into account the existing page margins of the document when calculating the watermark's size and coordinates. Default: false.|
|**[Height](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/height)** | Specifies the desired height of the watermark. |
|**[HorizontalAlignment](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/horizontalalignment)** | Specifies the horizontal alignment of the watermark. Possible values are `None` (default), `Left`, `Center`, and `Right`.|
|**[IsBackground](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/isbackground)** | Whether to place the watermark below (true) or above (true) the main content. Default: false. |
|**[Margins](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/margins)** | Specifies the watermark margins. |
|**[Opacity](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/opacity)** | Defines the opacity of the watermark as a value ranging from 0 (fully transparent) to 1 (solid filling). |
|**[RotateAngle](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/rotateangle/)** | Defines the rotation angle of the watermark. A positive value corresponds to a clockwise rotation angle, negative - to a counterclockwise rotation angle. |
|**[ScaleFactor](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/scalefactor)** | Specifies how the watermark size depends on the size of a parent document. |
|**[SizingType](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/sizingtype)** | Specifies a way the watermark should be sized. Possible values are `Auto` (default), `Absolute`, `ScaleToParentDimensions`, and `ScaleToParentArea`. |
|**[VerticalAlignment](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/verticalalignment)** | Specifies the vertical alignment of the watermark. Possible values are `None` (default), `Left`, `Center`, and `Bottom`. |
|**[Width](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/width)** | Specifies the desired width of the watermark. |
|**[X](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/x)** | Specifies the horizontal coordinate of the watermark within the parent document. |
|**[Y](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermark/y)** | Specifies the vertical coordinate of the watermark within the parent document. |


The code below demonstrates how to specify the desired watermark appearance and position before applying it to the document:

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Common;
using GroupDocs.Watermark.Watermarks;

// Specify an absolute or relative path to your document.
using (Watermarker watermarker = new Watermarker("C:\\Docs\\seagull.jpg"))
{
    // Specify the desired text and font for the watermark
    ImageWatermark watermark = new ImageWatermark("C:\\Docs\\greetings-stamp.png");
    // Specify watermark position, rotation and opacity
    watermark.HorizontalAlignment = HorizontalAlignment.Right;
    watermark.VerticalAlignment = VerticalAlignment.Top;
    watermark.RotateAngle = 15;
    watermark.IsBackground = false;
    watermark.Opacity = 0.8;
    // Apply the watermark
    watermarker.Add(watermark);
    // Save the resulting document
    watermarker.Save("C:\\Docs\\custom-image-watermark.jpg");
}
```
Run the program. An image watermark will be added at a specified position.

![Customized image watermark](/watermark/net/images/watermarking/custom-image-watermark.jpg)


---

## Customize watermarks

Path: /watermark/python-net/basic-usage/customize/


GroupDocs.Watermark lets you control how a watermark looks and where it appears.

## Customizing text watermarks

GroupDocs.Watermark lets you fully control the look and position of text watermarks. Adjust color, font, alignment, rotation, opacity, and scaling to match your document’s style.

Use `TextWatermark` properties like `foreground_color`, `opacity`, `rotate_angle`, `sizing_type`, `scale_factor`, `horizontal_alignment`, `vertical_alignment`, `x`, `y`, `width`, `height`, and `consider_parent_margins`.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("C:\\Docs\\sample.docx") as watermarker:
    watermark = gww.TextWatermark("Customized watermark.", gww.Font("Arial", 24.0, gww.FontStyle.BOLD))
    watermark.foreground_color = gww.Color.dark_orange
    watermark.consider_parent_margins = True
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.TOP
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.rotate_angle = 45
    watermark.scale_factor = 0.7
    watermarker.add(watermark)
    watermarker.save("C:\\Docs\\watermarked-sample.docx")
```
🔹 Use case: Apply branded or legal disclaimers in a consistent style across pages (e.g., “Confidential – Do Not Distribute”).

## Customizing image watermarks

You can also personalize image watermarks by adjusting their alignment, rotation, opacity, and layering. This allows you to place logos, stamps, or seals exactly where needed.

Use `ImageWatermark` with similar properties for position, rotation, background/foreground layering, and opacity.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

with gw.Watermarker("C:\\Docs\\seagull.jpg") as watermarker:
    watermark = gww.ImageWatermark("C:\\Docs\\greetings-stamp.png")
    watermark.horizontal_alignment = gwc.HorizontalAlignment.RIGHT
    watermark.vertical_alignment = gwc.VerticalAlignment.TOP
    watermark.rotate_angle = 15
    watermark.is_background = False
    watermark.opacity = 0.8
    watermarker.add(watermark)
    watermarker.save("C:\\Docs\\custom-image-watermark.jpg")
```
🔹 Use case: Place a semi-transparent company logo in the corner of each page, or overlay a stamp image for approvals and certifications.


---

## Delete indexed documents

Path: /search/java/delete-indexed-documents/

GroupDocs.Search has the ability to remove individual documents from the index that are indexed from a stream or structure. To remove documents indexed by a file system path, see [Deleting indexed paths]({{< ref "search/java/developer-guide/advanced-usage/indexing/delete-indexed-paths.md" >}}).

The following example shows how to remove documents from an index by document key.



```java
// Implementing document loader
private static class DocumentLoader implements IDocumentLoader {
    private final String filePath;
    private final String documentKey;

    public DocumentLoader(String filePath) {
        this.filePath = filePath;
        documentKey = FilenameUtils.getName(filePath);
    }

    public final String getDocumentKey() {
        return documentKey;
    }

    public final void closeDocument() {
    }

    public final Document loadDocument() {
        try {
            String extension = "." + FilenameUtils.getExtension(filePath);
            Path path = Paths.get(filePath);
            byte[] buffer = Files.readAllBytes(path);
            ByteArrayInputStream stream = new ByteArrayInputStream(buffer);
            Document document = Document.createFromStream(documentKey, new Date(System.currentTimeMillis()), extension, stream);
            return document;
        }
        catch (IOException e) {
            throw new RuntimeException(e);
        }
    }
}

...

String filePath = "c:\\MyDocuments\\SomeDocument.pdf";
String indexFolder = "c:\\MyIndex\\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Indexing the document from stream
DocumentLoader documentLoader = new DocumentLoader(filePath);
Document document = Document.createLazy(DocumentSourceKind.Stream, documentLoader.getDocumentKey(), documentLoader);
Document[] documents = new Document[] { document };
index.add(documents, new IndexingOptions());

// Searching in the index
SearchResult searchResult = index.search("Einstein");

// Deleting indexed document from the index
String[] documentKeys = new String[] { documentLoader.getDocumentKey() };
DeleteResult deleteResult = index.delete(new UpdateOptions(), documentKeys);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Delete indexed documents

Path: /search/net/delete-indexed-documents/


GroupDocs.Search has the ability to remove individual documents from the index that are indexed from a stream or structure. To remove documents indexed by a file system path, see [Deleting indexed paths]({{< ref "search/net/developer-guide/advanced-usage/indexing/delete-indexed-paths.md" >}}).

The following example shows how to remove documents from an index by document key.

**C#**

```csharp
// Implementing document loader
public class DocumentLoader : IDocumentLoader
{
    private readonly string filePath;
    private readonly string documentKey;

    public DocumentLoader(string filePath)
    {
        this.filePath = filePath;
        documentKey = Path.GetFileName(filePath);
    }

    public string DocumentKey
    {
        get { return documentKey; }
    }

    public void CloseDocument()
    {
    }

    public Document LoadDocument()
    {
        string extension = Path.GetExtension(filePath);
        byte[] buffer = File.ReadAllBytes(filePath);
        Stream stream = new MemoryStream(buffer);
        Document document = Document.CreateFromStream(documentKey, DateTime.Now, extension, stream);
        return document;
    }
}

...

string filePath = @"c:\MyDocuments\SomeDocument.pdf";
string indexFolder = @"c:\MyIndex\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Indexing the document from stream
DocumentLoader documentLoader = new DocumentLoader(filePath);
Document document = Document.CreateLazy(DocumentSourceKind.Stream, documentLoader.DocumentKey, documentLoader);
Document[] documents = new Document[] { document };
index.Add(documents, new IndexingOptions());

// Searching in the index
SearchResult searchResult = index.Search("Einstein");

// Deleting indexed document from the index
string[] documentKeys = new string[] { documentLoader.DocumentKey };
DeleteResult deleteResult = index.Delete(new UpdateOptions(), documentKeys);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Delete indexed documents

Path: /search/nodejs-java/delete-indexed-documents/

GroupDocs.Search has the ability to remove individual documents from the index that are indexed from a stream or structure. To remove documents indexed by a file system path, see [Deleting indexed paths]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/delete-indexed-paths.md" >}}).

The following example shows how to remove documents from an index by document key.

```javascript
const filePath = 'c:/MyDocuments/SomeDocument.pdf';
const indexFolder = 'c:/MyIndex/';
const query = 'Einstein';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, true);

// Indexing the document from stream
const documentKey = path.basename(filePath);
const documentLoader = java.newProxy('com.groupdocs.search.common.IDocumentLoader', {
  closeDocument: function () {},
  loadDocument: function () {
    const millis = java.callStaticMethodSync('java.lang.System', 'currentTimeMillis');
    const time = java.newInstanceSync('java.util.Date', millis);
    const extension = path.extname(filePath);
    const buffer = Utils.readBinaryFile(filePath);
    const array = Array.prototype.slice.call(buffer, 0);
    const buf = java.newArray('byte', array);
    const stream = java.newInstanceSync('java.io.ByteArrayInputStream', buf);
    const document = java.callStaticMethodSync(
      'com.groupdocs.search.Document',
      'createFromStream',
      documentKey,
      time,
      extension,
      stream,
    );
    return document;
  },
});

const document = java.callStaticMethodSync(
  'com.groupdocs.search.Document',
  'createLazy',
  groupdocs.search.DocumentSourceKind.Stream,
  documentKey,
  documentLoader,
);
const documents = java.newArray('com.groupdocs.search.Document', [document]);

// Subscribe to index events
const eventHandler = java.newProxy('com.groupdocs.search.events.EventHandler', {
  invoke: function (sender, args) {
    console.log(args.getMessage()); // Writing error messages to the console
  },
});
index.getEvents().ErrorOccurred.add(eventHandler);

index.add(documents, new groupdocs.search.IndexingOptions());

// Getting indexed documents from the index
const indexedDocuments1 = index.getIndexedDocuments();

// Writing indexed documents to the console
console.log('Indexed documents (' + indexedDocuments1.length + '):');
for (let i = 0; i < indexedDocuments1.length; i++) {
  const info = indexedDocuments1[i];
  console.log('\t' + info);
}

// Searching in the index
const searchResult1 = index.search(query);

// Deleting indexed document from the index
const documentKeys = java.newArray('java.lang.String', [documentKey]);
const deleteResult = index.delete(new groupdocs.search.UpdateOptions(), documentKeys);
console.log('\nDeleted documents: ' + deleteResult.getSuccessCount());

// Getting indexed paths after deletion
const indexedDocuments2 = index.getIndexedDocuments();

console.log('\nIndexed documents (' + indexedDocuments2.length + '):');
for (let i = 0; i < indexedDocuments2.length; i++) {
  const info = indexedDocuments2[i];
  console.log('\t' + info);
}

// Searching in the index
const searchResult2 = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document filtering in search result

Path: /search/java/document-filtering-in-search-result/

This page contains a description of the document filters used during the search.

## Setting a filter

To specify which of the documents found should be returned as a result of the search, the [setSearchDocumentFilter](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setSearchDocumentFilter(com.groupdocs.search.options.ISearchDocumentFilter)) method of the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class is used. If the document found does not match a filter passed to this method as an argument, the document will not be returned. The default value is null, which means that all documents found will be returned. The following example shows how to set a document filter for searching.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.setSearchDocumentFilter(SearchDocumentFilter.createFileExtension(".txt")); // Setting a document filter
 
// Search in the index
// Only text documents will be returned as the result of the search
SearchResult result = index.search("relativity", options);
```

## File path filters

The first supported type of search document filters allows you to set a regular expression for getting those documents whose full paths match the specified pattern. This type of filters uses the **java.util.regex.Pattern** class to compare with a pattern.



```java
// The filter returns only files that contain the word 'Einstein' in their paths, not case sensitive
ISearchDocumentFilter filter = SearchDocumentFilter.createFilePathRegularExpression("Einstein", Pattern.CASE_INSENSITIVE);
```

## File extension filter

The next supported type of search document filters allows you to specify a list of valid file extensions for indexing.



```java
// This filter returns only FB2 and EPUB documents
ISearchDocumentFilter filter = SearchDocumentFilter.createFileExtension(".fb2", ".epub");
```

## Attribute filter

The next supported type of search document filters allows you to search only those documents with which the specified text attribute is associated. You can learn more about attributes on the [Document attributes]({{< ref "search/java/developer-guide/advanced-usage/indexing/document-attributes.md" >}}) page.



```java
// This filter returns only documents that have attribute "main"
ISearchDocumentFilter filter = SearchDocumentFilter.createAttribute("main");
```

## Combining filters

Search document filters can be combined using composite filters AND, OR, NOT. The following example shows how to combine search document filters.



```java
// Creating an AND composite filter that returns all FB2 and EPUB documents that have the word 'Einstein' in their full paths
ISearchDocumentFilter filter1 = SearchDocumentFilter.createFilePathRegularExpression("Einstein", Pattern.CASE_INSENSITIVE);
ISearchDocumentFilter filter2 = SearchDocumentFilter.createFileExtension(".fb2", ".epub");
ISearchDocumentFilter andFilter = SearchDocumentFilter.createAnd(filter1, filter2);
 
// Creating an OR composite filter that returns all DOC, DOCX, PDF and all documents that have the word Einstein in their full paths
ISearchDocumentFilter filter3 = SearchDocumentFilter.createFilePathRegularExpression("Einstein", Pattern.CASE_INSENSITIVE);
ISearchDocumentFilter filter4 = SearchDocumentFilter.createFileExtension(".doc", ".docx", ".pdf");
ISearchDocumentFilter orFilter = SearchDocumentFilter.createOr(filter3, filter4);
 
// Creating a filter that returns all found documents except of TXT documents
ISearchDocumentFilter filter5 = SearchDocumentFilter.createFileExtension(".txt");
ISearchDocumentFilter notFilter = SearchDocumentFilter.createNot(filter5);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document filtering in search result

Path: /search/net/document-filtering-in-search-result/

This page contains a description of the document filters used during the search.

## Setting a filter

To specify which of the documents found should be returned as a result of the search, the [SearchDocumentFilter](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/searchdocumentfilter) property of the [SearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions) class is used. If the document found does not match the filter, it will not be returned. The default value is null, which means that all documents found will be returned. The following example shows how to set a document filter for searching.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.SearchDocumentFilter = SearchDocumentFilter.CreateFileExtension(".txt"); // Setting a document filter
 
// Search in the index
// Only text documents will be returned as the result of the search
SearchResult result = index.Search("relativity", options);
```

## File path filters

The first supported type of search document filters allows you to set a regular expression for getting those documents whose full paths match the specified pattern. This type of filters uses the **System.Text.RegularExpressions.Regex** class to compare with a pattern.

**C#**

```csharp
// The filter returns only files that contain the word 'Einstein' in their paths, not case sensitive
ISearchDocumentFilter filter = SearchDocumentFilter.CreateFilePathRegularExpression("Einstein", RegexOptions.IgnoreCase);
```

## File extension filter

The next supported type of search document filters allows you to specify a list of valid file extensions for indexing.

**C#**

```csharp
// This filter returns only FB2 and EPUB documents
ISearchDocumentFilter filter = SearchDocumentFilter.CreateFileExtension(".fb2", ".epub");
```

## Attribute filter

The next supported type of search document filters allows you to search only those documents with which the specified text attribute is associated. You can learn more about attributes on the [Document attributes]({{< ref "search/net/developer-guide/advanced-usage/indexing/document-attributes.md" >}}) page.

**C#**

```csharp
// This filter returns only documents that have attribute "main"
ISearchDocumentFilter filter = SearchDocumentFilter.CreateAttribute("main");
```

## Combining filters

Search document filters can be combined using composite filters AND, OR, NOT. The following example shows how to combine search document filters.

**C#**

```csharp
// Creating an AND composite filter that returns all FB2 and EPUB documents that have the word 'Einstein' in their full paths
ISearchDocumentFilter filter1 = SearchDocumentFilter.CreateFilePathRegularExpression("Einstein", RegexOptions.IgnoreCase);
ISearchDocumentFilter filter2 = SearchDocumentFilter.CreateFileExtension(".fb2", ".epub");
ISearchDocumentFilter andFilter = SearchDocumentFilter.CreateAnd(filter1, filter2);
 
// Creating an OR composite filter that returns all DOC, DOCX, PDF and all documents that have the word Einstein in their full paths
ISearchDocumentFilter filter3 = SearchDocumentFilter.CreateFilePathRegularExpression("Einstein", RegexOptions.IgnoreCase);
ISearchDocumentFilter filter4 = SearchDocumentFilter.CreateFileExtension(".doc", ".docx", ".pdf");
ISearchDocumentFilter orFilter = SearchDocumentFilter.CreateOr(filter3, filter4);
 
// Creating a filter that returns all found documents except of TXT documents
ISearchDocumentFilter filter5 = SearchDocumentFilter.CreateFileExtension(".txt");
ISearchDocumentFilter notFilter = SearchDocumentFilter.CreateNot(filter5);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document filtering in search result

Path: /search/nodejs-java/document-filtering-in-search-result/

This page contains a description of the document filters used during the search.

## Setting a filter

To specify which of the documents found should be returned as a result of the search, the [setSearchDocumentFilter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setSearchDocumentFilter(com.groupdocs.search.options.ISearchDocumentFilter)) method of the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class is used. If the document found does not match a filter passed to this method as an argument, the document will not be returned. The default value is null, which means that all documents found will be returned. The following example shows how to set a document filter for searching.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Creating a search options object
const options = new groupdocs.search.SearchOptions();
options.setSearchDocumentFilter(groupdocs.search.SearchDocumentFilter.createFileExtension('.txt')); // Setting a document filter

// Search in the index
// Only text documents will be returned as the result of the search
const query = 'education';
const result = index.search(query, options);
```

## File path filters

The first supported type of search document filters allows you to set a regular expression for getting those documents whose full paths match the specified pattern. This type of filters uses the **java.util.regex.Pattern** class to compare with a pattern.

```javascript
// The filter returns only files that contain the word 'Lorem' in their paths, not case sensitive
const filter = groupdocs.search.SearchDocumentFilter.createFilePathRegularExpression(
  'Lorem',
  java.getStaticFieldValue('java.util.regex.Pattern', 'CASE_INSENSITIVE'),
);
```

## File extension filter

The next supported type of search document filters allows you to specify a list of valid file extensions for indexing.

```javascript
// This filter returns only PDF and DOCX documents
const filter = groupdocs.search.SearchDocumentFilter.createFileExtension('.pdf', '.docx');
```

## Attribute filter

The next supported type of search document filters allows you to search only those documents with which the specified text attribute is associated. You can learn more about attributes on the [Document attributes]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/document-attributes.md" >}}) page.

```javascript
// This filter returns only documents that have attribute "main"
const filter = groupdocs.search.SearchDocumentFilter.createAttribute('main');
```

## Combining filters

Search document filters can be combined using composite filters AND, OR, NOT. The following example shows how to combine search document filters.

```javascript
// Creating an AND composite filter that returns all FB2 and EPUB documents that have the word 'Einstein' in their full paths
const filter1 = groupdocs.search.SearchDocumentFilter.createFilePathRegularExpression(
  'Einstein',
  java.getStaticFieldValue('java.util.regex.Pattern', 'CASE_INSENSITIVE'),
);
const filter2 = groupdocs.search.SearchDocumentFilter.createFileExtension('.fb2', '.epub');
const andFilter = groupdocs.search.SearchDocumentFilter.createAnd(filter1, filter2);

// Creating an OR composite filter that returns all DOC, DOCX, PDF and all documents that have the word Einstein in their full paths
const filter3 = groupdocs.search.SearchDocumentFilter.createFilePathRegularExpression(
  'Einstein',
  java.getStaticFieldValue('java.util.regex.Pattern', 'CASE_INSENSITIVE'),
);
const filter4 = groupdocs.search.SearchDocumentFilter.createFileExtension('.doc', '.docx', '.pdf');
const orFilter = groupdocs.search.SearchDocumentFilter.createOr(filter3, filter4);

// Creating a filter that returns all found documents except of TXT documents
const filter5 = groupdocs.search.SearchDocumentFilter.createFileExtension('.txt');
const notFilter = groupdocs.search.SearchDocumentFilter.createNot(filter5);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document passwords

Path: /search/java/document-passwords/

The [PasswordDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/PasswordDictionary) class is designed to store passwords for documents to be indexed. Information on indexing password protected documents is presented on the [Indexing password protected documents]({{< ref "search/java/developer-guide/advanced-usage/indexing/indexing-password-protected-documents.md" >}}) page.

To get the number of passwords in the dictionary, use the [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/PasswordDictionary#getCount()) method.

To get the password for a document from the dictionary, the [getPassword](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/PasswordDictionary#getPassword(java.lang.String)) method is used, passing the path to the document as an argument.

The [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/PasswordDictionary#clear()) method is used to remove all passwords from the dictionary.

To check for the presence of a password in the dictionary for the specified document, the [contains](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/PasswordDictionary#contains(java.lang.String)) method is used.

To add a password to the dictionary, use the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/PasswordDictionary#add(java.lang.String,%20java.lang.String)) method. The key is the path to the document.

To remove a password from the dictionary, use the [remove](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/PasswordDictionary#remove(java.lang.String)) method.

The following example demonstrates the use of methods of the password dictionary.



```java
String indexFolder = "c:\\MyIndex\\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.getDictionaries().getDocumentPasswords().getCount() > 0) {
    // Removing all passwords from the dictionary
    index.getDictionaries().getDocumentPasswords().clear();
}
 
String path = new File("c:\\MyIndex\\Protected.pdf").getAbsolutePath();
if (index.getDictionaries().getDocumentPasswords().contains(path)) {
    // Getting a password for a document
    String password = index.getDictionaries().getDocumentPasswords().getPassword(path);
    System.out.println(path);
    System.out.println("\tPassword: " + password);
 
    // Deleting the password from the dictionary
    index.getDictionaries().getDocumentPasswords().remove(path);
}
 
// Adding a password for a document
index.getDictionaries().getDocumentPasswords().add(path, "123456");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document passwords

Path: /search/net/document-passwords/

The [PasswordDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/passworddictionary) class is designed to store passwords for documents to be indexed. Information on indexing password protected documents is presented on the [Indexing password protected documents]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-password-protected-documents.md" >}}) page.

To get the number of passwords in the dictionary, use the [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/passworddictionary/properties/count) property.

To get the password for a document from the dictionary, the [GetPassword](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/passworddictionary/methods/getpassword) method is used, passing the path to the document as an argument.

The [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/passworddictionary/methods/clear) method is used to remove all passwords from the dictionary.

To check for the presence of a password in the dictionary for the specified document, the [Contains](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/passworddictionary/methods/contains) method is used.

To add a password to the dictionary, use the [Add](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/passworddictionary/methods/add) method. The key is the path to the document.

To remove a password from the dictionary, use the [Remove](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/passworddictionary/methods/remove) method.

The following example demonstrates the use of methods of the password dictionary.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.Dictionaries.DocumentPasswords.Count > 0)
{
    // Removing all passwords from the dictionary
    index.Dictionaries.DocumentPasswords.Clear();
}
 
string path = Path.GetFullPath(@"c:\MyIndex\Protected.pdf");
if (index.Dictionaries.DocumentPasswords.Contains(path))
{
    // Getting a password for a document
    string password = index.Dictionaries.DocumentPasswords.GetPassword(path);
    Console.WriteLine(path);
    Console.WriteLine("\tPassword: " + password);
 
    // Deleting the password from the dictionary
    index.Dictionaries.DocumentPasswords.Remove(path);
}
 
// Adding a password for a document
index.Dictionaries.DocumentPasswords.Add(path, "123456");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document passwords

Path: /search/nodejs-java/document-passwords/

The [PasswordDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/PasswordDictionary) class is designed to store passwords for documents to be indexed. Information on indexing password protected documents is presented on the [Indexing password protected documents]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/indexing-password-protected-documents.md" >}}) page.

To get the number of passwords in the dictionary, use the [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/PasswordDictionary#getCount()) method.

To get the password for a document from the dictionary, the [getPassword](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/PasswordDictionary#getPassword(java.lang.String)) method is used, passing the path to the document as an argument.

The [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/PasswordDictionary#clear()) method is used to remove all passwords from the dictionary.

To check for the presence of a password in the dictionary for the specified document, the [contains](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/PasswordDictionary#contains(java.lang.String)) method is used.

To add a password to the dictionary, use the [add](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/PasswordDictionary#add(java.lang.String,%20java.lang.String)) method. The key is the path to the document.

To remove a password from the dictionary, use the [remove](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/PasswordDictionary#remove(java.lang.String)) method.

The following example demonstrates the use of methods of the password dictionary.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index from in specified folder
const index = new groupdocs.search.Index(indexFolder);

if (index.getDictionaries().getDocumentPasswords().getCount() > 0) {
  // Removing all passwords from the dictionary
  index.getDictionaries().getDocumentPasswords().clear();
}

const absolutePath = path.resolve(Utils.PasswordProtectedDocumentsPath + 'English.docx');
index.getDictionaries().getDocumentPasswords().add(absolutePath, '123456');

if (index.getDictionaries().getDocumentPasswords().contains(absolutePath)) {
  // Getting a password for a document
  const password = index.getDictionaries().getDocumentPasswords().getPassword(absolutePath);
  console.log(absolutePath);
  console.log('\tPassword: ' + password);

  // Deleting the password from the dictionary
  index.getDictionaries().getDocumentPasswords().remove(absolutePath);
}

// Adding document passwords to the dictionary
index
  .getDictionaries()
  .getDocumentPasswords()
  .add(Utils.PasswordProtectedDocumentsPath + 'English.docx', '123456');
index
  .getDictionaries()
  .getDocumentPasswords()
  .add(Utils.PasswordProtectedDocumentsPath + 'Lorem ipsum.docx', '123456');

// Indexing documents from the specified folder
// Passwords will be automatically retrieved from the dictionary when necessary
index.add(documentsFolder);

// Searching in the index
const query = 'ipsum OR increasing';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Edit and Update Form Fields

Path: /editor/java/edit-and-update-form-fields/


This article demonstrates how to edit form fields in a Word document using GroupDocs.Editor for Java. The example provided guides you through loading a document, modifying form fields, and saving the updated document.

#### Step-by-Step Guide

1. **Create a InputStream from the Path**

   Create a `InputStream` from the input file path.

   ```java
   InputStream fs = new FileInputStream(inputFilePath);
   {
       // Further code will be placed here
   }
   ```

2. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```java
   WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
   loadOptions.setPassword("some_password_to_open_a_document)";
   ```

3. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```java
   Editor editor = new Editor(fs, loadOptions);
   {
       // Further code will be placed here
   }
   ```

4. **Retrieve and Update Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor` and read the `FormFieldCollection`. Update a specific text form field by modifying its properties and then call the `UpdateFormFiled` method to apply the changes.

   ```java
   FormFieldManager fieldManager = editor.getFormFieldManager();
   FormFieldCollection collection = fieldManager.getFormFieldCollection();

   TextFormField textField = collection.getFormField("Text1",TextFormField.class);
    textField.setLocaleId(1029);
    textField.setValue("new Value");
    fieldManager.updateFormFields(collection);
   ```

5. **Create and Set Save Options**

   Initialize the `WordProcessingSaveOptions` with the desired format. Optimize memory usage if necessary, and protect the document from writing with a password.

   ```java
   WordProcessingFormats docFormat = WordProcessingFormats.Docx;
   WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);
   saveOptions.setOptimizeMemoryUsage(true);
   saveOptions.setProtection(new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password"));
   ```

6. **Save the Document**

   Prepare a stream for saving and use the `Save` method of the `Editor` to save the updated document.

   ```java
   ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
   {
       editor.save(outputStream, saveOptions);
   }
   ```

7. **Completion Message**

   Print a confirmation message to indicate the successful completion of the operation.

   ```java
   System.out.println("EditFormFieldCollection routine has successfully finished");
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```java
/**
 * This example demonstrates how to edit form fields in a Word document using GroupDocs.Editor for Java.
 */
public class EditFormFieldCollection {
     /**
      * Runs the example to demonstrate loading, editing, and saving form fields in a document.
      */
    public static void run() throws Exception
    {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample DOCX with form fields.
        String inputFilePath = Constants.SampleLegacyFormFields_docx;

        // 2. Create a stream from this path
        InputStream fs = new FileInputStream(inputFilePath);

        // 3. Create load options for this document
        WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
        // 3.1. If the input document is password-protected, specify the password for its opening...
        loadOptions.setPassword("some_password_to_open_a_document");
        // 3.2. ...but, because the document is unprotected, this password will be ignored

        // 4. Load the document with options into the Editor instance
        Editor editor = new Editor(fs, loadOptions);

        // 4.1. Read the FormFieldManager instance
        FormFieldManager fieldManager = editor.getFormFieldManager();
        // 4.2. Read the FormFieldCollection in the document
        FormFieldCollection collection = fieldManager.getFormFieldCollection();

        // 4.3. Update a specific text form field
        TextFormField textField = collection.getFormField("Text1",TextFormField.class);
        textField.setLocaleId(1029);
        textField.setValue("new Value");
        fieldManager.updateFormFields(collection);

        // 5. Create document save options
        WordProcessingFormats docFormat = WordProcessingFormats.Docx;
        WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);

        // 5.1. If the document is large and causes OutOfMemoryException, set the memory optimization option
        saveOptions.setOptimizeMemoryUsage(true);

        // 5.2. Protect the document from writing (allow only form fields) with a password
        saveOptions.setProtection(new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password"));

        // 6. Save the document
        // 6.1. Prepare a stream for saving
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        {
            // 6.2. Save the document
            editor.save(outputStream, saveOptions);
        }

        System.out.println("EditFormFieldCollection routine has successfully finished");
    }
}
```

---

## Edit and Update Form Fields

Path: /editor/net/edit-and-update-form-fields/


This article demonstrates how to edit form fields in a Word document using GroupDocs.Editor for .NET. The example provided guides you through loading a document, modifying form fields, and saving the updated document.

#### Step-by-Step Guide

1. **Create a Stream from the Path**

   Create a `FileStream` from the input file path.

   ```csharp
   using (FileStream fs = File.OpenRead(inputFilePath))
   {
       // Further code will be placed here
   }
   ```

2. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```csharp
   WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
   loadOptions.Password = "some_password_to_open_a_document";
   ```

3. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```csharp
   using (Editor editor = new Editor(fs, loadOptions))
   {
       // Further code will be placed here
   }
   ```

4. **Retrieve and Update Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor` and read the `FormFieldCollection`. Update a specific text form field by modifying its properties and then call the `UpdateFormFiled` method to apply the changes.

   ```csharp
   FormFieldManager fieldManager = editor.FormFieldManager;
   FormFieldCollection collection = fieldManager.FormFieldCollection;

   TextFormField textField = collection.GetFormField<TextFormField>("Text1");
   textField.LocaleId = 1029;
   textField.Value = "new Value";
   fieldManager.UpdateFormFiled(collection);
   ```

5. **Create and Set Save Options**

   Initialize the `WordProcessingSaveOptions` with the desired format. Optimize memory usage if necessary, and protect the document from writing with a password.

   ```csharp
   WordProcessingFormats docFormat = WordProcessingFormats.Docx;
   WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);
   saveOptions.OptimizeMemoryUsage = true;
   saveOptions.Protection = new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password");
   ```

6. **Save the Document**

   Prepare a stream for saving and use the `Save` method of the `Editor` to save the updated document.

   ```csharp
   using (MemoryStream outputStream = new MemoryStream())
   {
       editor.Save(outputStream, saveOptions);
   }
   ```

7. **Completion Message**

   Print a confirmation message to indicate the successful completion of the operation.

   ```csharp
   System.Console.WriteLine("EditFormFieldCollection routine has successfully finished");
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```csharp
/// <summary>
/// This example demonstrates how to edit form fields in a Word document using GroupDocs.Editor for .NET.
/// </summary>
internal static class EditFormFieldCollection
{
    /// <summary>
    /// Runs the example to demonstrate loading, editing, and saving form fields in a document.
    /// </summary>
    internal static void Run()
    {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample DOCX with form fields.
        string inputFilePath = Constants.SampleLegacyFormFields_docx;

        // 2. Create a stream from this path
        using (FileStream fs = File.OpenRead(inputFilePath))
        {
            // 3. Create load options for this document
            WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
            // 3.1. If the input document is password-protected, specify the password for its opening...
            loadOptions.Password = "some_password_to_open_a_document";
            // 3.2. ...but, because the document is unprotected, this password will be ignored

            // 4. Load the document with options into the Editor instance
            using (Editor editor = new Editor(fs, loadOptions))
            {
                // 4.1. Read the FormFieldManager instance
                FormFieldManager fieldManager = editor.FormFieldManager;
                // 4.2. Read the FormFieldCollection in the document
                FormFieldCollection collection = fieldManager.FormFieldCollection;

                // 4.3. Update a specific text form field
                TextFormField textField = collection.GetFormField<TextFormField>("Text1");
                textField.LocaleId = 1029;
                textField.Value = "new Value";
                fieldManager.UpdateFormFiled(collection);

                // 5. Create document save options
                WordProcessingFormats docFormat = WordProcessingFormats.Docx;
                WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);

                // 5.1. If the document is large and causes OutOfMemoryException, set the memory optimization option
                saveOptions.OptimizeMemoryUsage = true;

                // 5.2. Protect the document from writing (allow only form fields) with a password
                saveOptions.Protection = new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password");

                // 6. Save the document
                // 6.1. Prepare a stream for saving
                using (MemoryStream outputStream = new MemoryStream())
                {
                    // 6.2. Save the document
                    editor.Save(outputStream, saveOptions);
                }
            }
        }
        System.Console.WriteLine("EditFormFieldCollection routine has successfully finished");
    }
}
```

---

## Edit and Update Form Fields

Path: /editor/nodejs-java/edit-and-update-form-fields/


This article demonstrates how to edit form fields in a Word document using **GroupDocs.Editor for Node.js via Java**. The example provided guides you through loading a document, modifying form fields, and saving the updated document.

#### Step-by-Step Guide

1. **Create a Readable Stream from the Path**

   Create a readable stream from the input file path.

   ```javascript
   const fs = require('fs');
   const inputFilePath = 'path/to/your/document.docx';
   const inputStream = fs.createReadStream(inputFilePath);
   ```

2. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```javascript
   const groupdocsEditor = require('groupdocs-editor');

   const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();
   loadOptions.setPassword('some_password_to_open_a_document');
   ```

3. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```javascript
   const editor = new groupdocsEditor.Editor(inputStream, loadOptions);
   ```

4. **Retrieve and Update Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor` and read the `FormFieldCollection`. Update a specific text form field by modifying its properties and then call the `updateFormFields` method to apply the changes.

   ```javascript
   // Get the FormFieldManager
   const fieldManager = editor.getFormFieldManager();

   // Get the FormFieldCollection
   const collection = fieldManager.getFormFieldCollection();

   // Get a specific TextFormField
   const textField = collection.getFormField('Text1', groupdocsEditor.TextFormField);

   // Modify properties of the TextFormField
   textField.setLocaleId(1029);
   textField.setValue('new Value');

   // Update the form fields in the document
   fieldManager.updateFormFields(collection);
   ```

5. **Create and Set Save Options**

   Initialize the `WordProcessingSaveOptions` with the desired format. Optimize memory usage if necessary, and protect the document from writing with a password.

   ```javascript
   const docFormat = groupdocsEditor.WordProcessingFormats.Docx;
   const saveOptions = new groupdocsEditor.WordProcessingSaveOptions(docFormat);

   // Optimize memory usage if needed
   saveOptions.setOptimizeMemoryUsage(true);

   // Protect the document from writing (allow only form fields) with a password
   const protectionType = groupdocsEditor.WordProcessingProtectionType.AllowOnlyFormFields;
   const protection = new groupdocsEditor.WordProcessingProtection(protectionType, 'write_password');
   saveOptions.setProtection(protection);
   ```

6. **Save the Document**

   Use the `save` method of the `Editor` to save the updated document.

   ```javascript
   const outputFilePath = 'path/to/output/document.docx';

   editor.save(outputFilePath, saveOptions);
   ```

7. **Completion Message**

   Print a confirmation message to indicate the successful completion of the operation.

   ```javascript
   console.log('Edit and update form fields routine has successfully finished.');
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```javascript
/**
 * This example demonstrates how to edit form fields in a Word document using GroupDocs.Editor for Node.js via Java.
 */

// Import the necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

(async () => {
    try {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample DOCX with form fields.
        const inputFilePath = 'path/to/your/document.docx';

        // 2. Create a readable stream from this path
        const inputStream = fs.createReadStream(inputFilePath);

        // 3. Create load options for this document
        const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();
        // 3.1. If the input document is password-protected, specify the password for its opening...
        loadOptions.setPassword('some_password_to_open_a_document');
        // 3.2. ...but, because the document is unprotected, this password will be ignored

        // 4. Load the document with options into the Editor instance
        const editor = new groupdocsEditor.Editor(inputStream, loadOptions);

        // 4.1. Get the FormFieldManager instance
        const fieldManager = editor.getFormFieldManager();

        // 4.2. Get the FormFieldCollection in the document
        const collection = fieldManager.getFormFieldCollection();

        // 4.3. Update a specific text form field
        const textField = collection.getFormField('Text1', groupdocsEditor.TextFormField);
        if (textField) {
            textField.setLocaleId(1029);
            textField.setValue('new Value');
        }

        // 4.4. Update the form fields in the document
        fieldManager.updateFormFields(collection);

        // 5. Create document save options
        const docFormat = groupdocsEditor.WordProcessingFormats.Docx;
        const saveOptions = new groupdocsEditor.WordProcessingSaveOptions(docFormat);

        // 5.1. If the document is large and causes memory issues, set the memory optimization option
        saveOptions.setOptimizeMemoryUsage(true);

        // 5.2. Protect the document from writing (allow only form fields) with a password
        const protectionType = groupdocsEditor.WordProcessingProtectionType.AllowOnlyFormFields;
        const protection = new groupdocsEditor.WordProcessingProtection(protectionType, 'write_password');
        saveOptions.setProtection(protection);

        // 6. Save the document
        const outputFilePath = 'path/to/output/document.docx';

        // 6.1. Save the document
        editor.save(outputFilePath, saveOptions);

        console.log('Edit and update form fields routine has successfully finished.');
    } catch (error) {
        console.error('An error occurred:', error);
    }
})();
```

---

**Note:** Make sure to replace `'path/to/your/document.docx'` and `'path/to/output/document.docx'` with the actual file paths in your application.

---

By following this guide, you can effectively edit and update form fields in Word documents using GroupDocs.Editor for Node.js via Java. This allows you to programmatically manipulate form fields, such as text fields, checkboxes, and dropdowns, ensuring that your documents are correctly formatted and updated according to your requirements.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.

---

## Epub to Md

Path: /markdown/net/convert/export-ebook/


Use GroupDocs.Markdown to convert EPUB, MOBI, and other eBook formats to clean Markdown.

### Using static method

The simplest way to convert an eBook file:

{{< tabs "export-ebook-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Set license (optional)
if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

// Convert EPUB to Markdown string
string markdown = MarkdownConverter.ToMarkdown("business-plan.epub");

// Or save directly to a file
MarkdownConverter.ToFile("business-plan.epub", "export-ebook-static.md");
```
{{< /tab >}}
{{< tab "business-plan.epub" >}}  
{{< tab-text >}}
`business-plan.epub` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/business-plan.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-ebook-static.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQsAAABQCAYAAAAOa1DSAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAOxAAADsQBlSsOGwAAEHlJREFUeJzt3XlwG9d9wPHvLhYncRIA71sUKUqULFqHbR2xlUqx3dxOk0kzzbR2/2hnOnU7STr9r800f6SdTv9Ims60406OiXPUrq1YdeLEhyzLsiRKIi1SFy/xvm+QAHED/QMSKIgADSUZ05J+n7+0j2/3Pexb/bD78N4+ZbLvVBIhhPgAGkAymSQWSxCLx3PnVECv6dB0unRSPJ4gEo3l3EVVVYwGLb2dSCSJxuIkEonsRSgKek2HTqem02LxONFo7nrpdCoG/a1lJG6UkT0GKoqCXq9Dp66WEY3FicVyl6HpVPS3lBFPJIhG4yST2ctQVQW9pqGqCpDf+dU0HXrtTs6tgkGvoSirZURjceLx7OdW2k/a77dpv4
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-ebook/ExportEbookStatic/export-ebook-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-ebook-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

using var converter = new MarkdownConverter("business-plan.epub");
var options = new ConvertOptions
{
    ImageExportStrategy = new ExportImagesToFileSystemStrategy("images")
    {
        ImagesRelativePath = "images"
    },
    HeadingLevelOffset = 1
};

converter.Convert("export-ebook-instance.md", options);
```
{{< /tab >}}
{{< tab "business-plan.epub" >}}  
{{< tab-text >}}
`business-plan.epub` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/business-plan.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-ebook-instance.zip" >}}  
```text
export-ebook-instance.md (5 KB)
images/img-001.png (4 KB)
images/img-002.jpg (35 KB)
images/img-003.png (13 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-ebook/ExportEbookInstance/export-ebook-instance.zip)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/net/getting-started/supported-document-formats" >}}).

---

## Epub to Md

Path: /markdown/python-net/convert/export-ebook/


Use GroupDocs.Markdown to convert EPUB, MOBI, and other eBook formats to clean Markdown.

### Using static method

The simplest way to convert an eBook file:

{{< tabs "export-ebook-static">}}
{{< tab "export_ebook_to_markdown.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter

def export_ebook_to_markdown():
    """Convert an EPUB eBook to Markdown using the static one-liner API."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Convert EPUB to a Markdown string in one call
    markdown = MarkdownConverter.to_markdown("business-plan.epub")

    # Step 3: Or save the conversion result directly to a file
    MarkdownConverter.to_file("business-plan.epub", "export-ebook.md")

if __name__ == "__main__":
    export_ebook_to_markdown()
```
{{< /tab >}}
{{< tab "business-plan.epub" >}}  
{{< tab-text >}}
`business-plan.epub` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/business-plan.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-ebook.txt" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUoAAAAICAYAAACfzrbWAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEwAACxMBAJqcGAAAAIdJREFUaIHt1KENAkEQRuE3yyVYekHhthQ6wV8TUAod0AECT3AYkh0sF8Q6DsL75CST/OrF7bSvtFJ5ERHLzNwgSf8iuJCcp6e8r9bbcaCVGrCbPGQSH10oSTNr8Ba+jCswlhnmSNJPMZSS1GEoJanDUEpSh6GUpI6B0g4Jx7mHSNK3WRAPgCfpERinQ8MkdQAAAABJRU5ErkJggg==)HOME BASED  

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOcAAABFCAYAAACxIPHFAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEwAACxMBAJqcGAAAASxJREFUeJzt1bFRAlEARdH/EXNLo
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-ebook/export_ebook_to_markdown/export-ebook.txt)
{{< /tab >}}
{{< tab "export-ebook.txt" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUoAAAAICAYAAACfzrbWAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEwAACxMBAJqcGAAAAIdJREFUaIHt1KENAkEQRuE3yyVYekHhthQ6wV8TUAod0AECT3AYkh0sF8Q6DsL75CST/OrF7bSvtFJ5ERHLzNwgSf8iuJCcp6e8r9bbcaCVGrCbPGQSH10oSTNr8Ba+jCswlhnmSNJPMZSS1GEoJanDUEpSh6GUpI6B0g4Jx7mHSNK3WRAPgCfpERinQ8MkdQAAAABJRU5ErkJggg==)HOME BASED  

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOcAAABFCAYAAACxIPHFAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEwAACxMBAJqcGAAAASxJREFUeJzt1bFRAlEARdH/EXNLo
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-ebook/export_ebook_to_markdown/export-ebook.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-ebook-instance">}}
{{< tab "export_ebook_with_options.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy

def export_ebook_with_options():
    """Convert an EPUB eBook to Markdown using the instance API with image export and heading offset."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Open the eBook with a context manager
    with MarkdownConverter("business-plan.epub") as converter:
        # Step 3: Configure the image export strategy to save images to disk
        strategy = ExportImagesToFileSystemStrategy("images")
        strategy.images_relative_path = "images"

        # Step 4: Set conversion options
        options = ConvertOptions()
        options.image_export_strategy = strategy
        options.heading_level_offset = 1  # shift all headings down one level

        # Step 

        # Step 5: Convert and save the Markdown output
        converter.convert("export-ebook-options.md", convert_options=options)

if __name__ == "__main__":
    export_ebook_with_options()
```
{{< /tab >}}
{{< tab "business-plan.epub" >}}  
{{< tab-text >}}
`business-plan.epub` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/business-plan.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-ebook-options.zip" >}}  
```text
export-ebook-options.txt (44 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-ebook/export_ebook_with_options/export-ebook-options.zip)
{{< /tab >}}
{{< tab "export-ebook-options.zip" >}}  
```text
export-ebook-options.txt (44 KB)
images/img-001.png (229 bytes)
images/img-002.png (394 bytes)
images/img-003.png (8 KB)
images/img-004.png (171 bytes)
images/img-005.png (9 KB)
images/img-006.png (567 bytes)
images/img-007.png (151 bytes)
images/img-008.png (186 bytes)
images/img-009.png (567 bytes)
[TRUNCATED] (610 files total)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-ebook/export_ebook_with_options/export-ebook-options.zip)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/python-net/getting-started/supported-document-formats" >}}).

---

## eSign Spreadsheet with Metadata signature

Path: /signature/net/esign-spreadsheet-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [SpreadsheetMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/spreadsheetmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) instance to sign Spreadsheet document files.
Spreadsheet document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Spreadsheet document metadata contains pair of Name and Value, Name should be unique within the document.  
Spreadsheet document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there.

### Here are the steps to add metadata signatures into Spreadsheet document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several[SpreadsheetMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/spreadsheetmetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Spreadsheet with Metadata signature

This example shows how to add Metadata e-signature to a Spreadsheet document.

```csharp
using (Signature signature = new Signature("sample.xlsx"))
{
    MetadataSignOptions options = new MetadataSignOptions();

    // Create few Spreadsheet Metadata signatures
    SpreadsheetMetadataSignature[] signatures = new SpreadsheetMetadataSignature[]
    {
        new SpreadsheetMetadataSignature("Author", "Mr.Scherlock Holmes"),
        new SpreadsheetMetadataSignature("DateCreated", DateTime.Now),
        new SpreadsheetMetadataSignature("DocumentId", 123456),
        new SpreadsheetMetadataSignature("SignatureId", 123.456M)
    };
  
    // add these signatures to options
    options.Signatures.AddRange(signatures);
    signature.Sign("SampleSigned.xlsx", options);
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Extract annotations from document

Path: /annotation/java/extract-annotations-from-document/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) allows you to extract annotations from a document and serialize them to the XML format.  

To do this, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [LoadOptions](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class and set `ImportAnnotation = true`.
3.   Define a variable of the `List<AnnotationBase>` type.
4.   Call the [get()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#get--) method to get result to variable defined on the previous step.
5.   Instantiate the `XmlSerializer` class with the `List<AnnotationBase>` type.
6.   Using `FileStreamobject`, serialize annotations to the file.

The following code snippet shows how to extract annotations from a document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to extract annotations.

LoadOptions tmp0 = new LoadOptions();

// Create an instance of Annotator class
Annotator annotator = new Annotator("InputPath", tmp0);

// Get all annotations
List<AnnotationBase> annotations = annotator.get();
```
{{< /tab >}}
{{< /tabs >}}

---

## Extract annotations from document

Path: /annotation/net/extract-annotations-from-document/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to extract annotations from a document and serialize them to the XML format.  

To do this, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [LoadOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/loadoptions) class and set `ImportAnnotation = true`.
3.   Define a variable of the `List<AnnotationBase>` type.
4.   Call the [Get](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/get) method to get result to variable defined on the previous step.
5.   Instantiate the `XmlSerializer` class with the `List<AnnotationBase>` type.
6.   Using `FileStreamobject`, serialize annotations to the file.

The following code snippet shows how to extract annotations from a document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
// for using this example input file ("annotated.pdf") must have annotations
using (Annotator annotator = new Annotator("annotated.pdf"))
{
	List<AnnotationBase> annotations = annotator.Get();
    XmlSerializer formatter = new XmlSerializer(typeof(List<AnnotationBase>));
    using (FileStream fs = new FileStream("annotations.xml", FileMode.Create))
    {
    	fs.SetLength(0);
        formatter.Serialize(fs, annotations);
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Extract attachments from Emails

Path: /parser/java/extract-attachments-from-emails/

  

# Extract attachments from Emails

To extract attachments from emails [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects.

Email **Attachment** can contain the following metadata:

| Name | Description |
| --- | --- |
| content-type | The MIME type of the attachment content |

These metadata refer to a container element itself, not a document.

Here are the steps to extract an email text from email attachments:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and obtain [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object to extract a text.

The following example shows how to extract a text from email attachments:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleMsg)) {
    // Extract attachments from the container
    Iterable<ContainerItem> attachments = parser.getContainer();
    // Check if container extraction is supported
    if (attachments == null) {
        System.out.println("Container extraction isn't supported");
    }
    // Iterate over zip entities
    for (ContainerItem item : attachments) {
        // Print the file path
        System.out.println(item.getFilePath());
        // Print metadata
        for (MetadataItem metadata : item.getMetadata()) {
            System.out.println(String.format("%s: %s", metadata.getName(), metadata.getValue()));
        }
        try {
            // Create Parser object for the zip entity content
            try (Parser attachmentParser = item.openParser()) {
                // Extract an zip entity text
                try (TextReader reader = attachmentParser.getText()) {
                    System.out.println(reader == null ? "No text" : reader.readToEnd());
                }
            }
        } catch (UnsupportedDocumentFormatException ex) {
            System.out.println("Isn't supported.");
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)  
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract attachments from Emails

Path: /parser/net/extract-attachments-from-emails/

To extract attachments from emails [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects.

Email Attachment can contain the following metadata:

| Name | Description |
| --- | --- |
| content-type | The MIME type of the attachment content |

These metadata refer to a container element itself, not a document.

Here are the steps to extract an email text from email attachments:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and get container item names, sizes and obtain content.

The following example shows how to extract a text from email attachments:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();
    // Check if container extraction is supported
    if(attachments == null)
    {
        Console.WriteLine("Container extraction isn't supported");
    }

    // Iterate over attachments
    foreach(ContainerItem item in attachments)
    {
		// Print the file path
		Console.WriteLine(item.FilePath);
       
        // Print metadata
        foreach (MetadataItem metadata in item.Metadata)
        {
            Console.WriteLine(string.Format("{0}: {1}", metadata.Name, metadata.Value));
        }

		try
        {
            // Create Parser object for the email content
            using (Parser attachmentParser = item.OpenParser())
            {
                // Extract an email text
                using (TextReader reader = attachmentParser.GetText())
                {
                    Console.WriteLine(reader == null ? "No text" : reader.ReadToEnd());
                }
            }
        }
        catch (UnsupportedDocumentFormatException)
        {
            Console.WriteLine("Isn't supported.");
        }
	}
}
```

## Detect inline images

To detect if image attachment is inline 'disposition' metadata is used. If it's present, it can take 'inline' or 'attachment' values.

The following example shows how to detect inline attachments:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();
    // Check if container extraction is supported
    if(attachments == null)
    {
        Console.WriteLine("Container extraction isn't supported");
    }

    // Iterate over attachments
    foreach(ContainerItem item in attachments)
    {
        // Check metadata for 'disposition' item
        if(item.GetMetadataValue("disposition") == "inline") {
		    // If it's 'inline' then print the file path
		    Console.WriteLine(item.FilePath);
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract attachments from PDF portfolios

Path: /parser/java/extract-attachments-from-pdf-portfolios/

  

# Extract attachments from PDF portfolios

To extract attachments from emails [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects.

Here are the steps to extract an attachment text from PDF Portfolios:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and get container item names, sizes and obtain content.

The following example shows how to extract a text from PDF Portfolios:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdfPortfolio)) {
    // Extract attachments from the container
    Iterable<ContainerItem> attachments = parser.getContainer();
    // Check if container extraction is supported
    if (attachments == null) {
        System.out.println("Container extraction isn't supported");
    }
    // Iterate over zip entities
    for (ContainerItem item : attachments) {
        // Print the file path
        System.out.println(item.getFilePath());
        // Print metadata
        for (MetadataItem metadata : item.getMetadata()) {
            System.out.println(String.format("%s: %s", metadata.getName(), metadata.getValue()));
        }
        try {
            // Create Parser object for the zip entity content
            try (Parser attachmentParser = item.openParser()) {
                // Extract an zip entity text
                try (TextReader reader = attachmentParser.getText()) {
                    System.out.println(reader == null ? "No text" : reader.readToEnd());
                }
            }
        } catch (UnsupportedDocumentFormatException ex) {
            System.out.println("Isn't supported.");
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)
    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract attachments from PDF portfolios

Path: /parser/net/extract-attachments-from-pdf-portfolios/

To extract attachments from emails [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects.

Here are the steps to extract an attachment text from PDF Portfolios:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and get container item names, sizes and obtain content.

The following example shows how to extract a text from PDF Portfolios:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();
    // Check if container extraction is supported
    if(attachments == null)
    {
        Console.WriteLine("Container extraction isn't supported");
    }

    
    // Iterate over attachments
    foreach(ContainerItem item in attachments)
    {
		// Print the file path
		Console.WriteLine(item.FilePath);
        try
        {
            // Create Parser object for the email content
            using (Parser attachmentParser = item.OpenParser())
            {
                // Extract an email text
                using (TextReader reader = attachmentParser.GetText())
                {
                    Console.WriteLine(reader == null ? "No text" : reader.ReadToEnd());
                }
            }
        }
        catch (UnsupportedDocumentFormatException)
        {
            Console.WriteLine("Isn't supported.");
        }
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract formatted text from document page

Path: /parser/net/extract-formatted-text-from-document-page/

GroupDocs.Parser provides the functionality to extract formatted text from document page by the [GetFormattedText(int, FormattedTextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/getformattedtext/methods/1) method:

```csharp
TextReader GetFormattedText(int pageIndex, FormattedTextOptions options);

```

Methods return an instance of [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) class with the extracted text. [FormattedTextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextoptions) has the following constructor:

```csharp
FormattedTextOptions(FormattedTextMode mode);
```

[FormattedTextMode](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextmode) enumeration has the following members:

| Member | Description |
| --- | --- |
| Html | Html format. |
| Markdown | Markdown format. |
| PlainText | Plain text format. |

Here are the steps to extract a HTML formatted page text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Check if formatted text extraction is supported for the document;
*   Instantiate [FormattedTextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextoptions) with HTML text mode;
*   Call [GetFormattedText(int, FormattedTextOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/getformattedtext/methods/1) method with the page index and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a document page text as Markdown text:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports formatted text extraction
    if (!parser.Features.FormattedText)
    {
        Console.WriteLine("Document isn't supports formatted text extraction.");
        return;
    }

    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if (documentInfo.PageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
   
    // Iterate over pages
    for (int p = 0; p < documentInfo.PageCount; p++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", p + 1, documentInfo.PageCount));
        // Extract a formatted text into the reader
        using (TextReader reader = parser.GetFormattedText(p, new FormattedTextOptions(FormattedTextMode.Html)))
        {
            // Print a formatted text from the document
            // We ignore null-checking as we have checked formatted text extraction feature support earlier
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document

Path: /parser/java/extract-hyperlinks-from-document/



GroupDocs.Parser provides the functionality to extract hyperlinks from documents by the [getHyperlinks](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getHyperlinks()) method:

```java
Iterable<PageHyperlinkArea> getHyperlinks();
```

This method returns a collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea) object:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getText](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea#getText()) | The hyperlink text. |
| [getUrl](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea#getUrl()) | The hyperlink URL. |

Here are the steps to extract all hyperlinks from the whole document:

* Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
* Check if the document supports hyperlink extraction;
* Call [getHyperlinks](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getHyperlinks()) method and obtain collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea) objects;
* Iterate through the collection and get a hyperlink text and URL.

The following example shows how to extract all hyperlinks from the whole document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.HyperlinksPdf)) {
    // Check if the document supports hyperlink extraction
    if (!parser.getFeatures().isHyperlinks()) {
        System.out.println("Document isn't supports hyperlink extraction.");
        return;
    }
    // Extract hyperlinks from the document
    Iterable<PageHyperlinkArea> hyperlinks = parser.getHyperlinks();
    // Iterate over hyperlinks
    for (PageHyperlinkArea h : hyperlinks) {
        // Print the hyperlink text
        System.out.println(h.getText());
        // Print the hyperlink URL
        System.out.println(h.getUrl());
        System.out.println();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document

Path: /parser/net/extract-hyperlinks-from-document/


GroupDocs.Parser provides the functionality to extract hyperlinks from documents by the [GetHyperlinks](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/gethyperlinks) method:

```csharp
IEnumerable<PageHyperlinkArea> GetHyperlinks();
```

This method returns a collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea) object:

| Member                                                       | Description                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [Text](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea/properties/text) | The hyperlink text.                                          |
| [Url](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea/properties/url) | The hyperlink URL.                                           |

Here are the steps to extract all hyperlinks from the whole document:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
- Check if the document supports hyperlink extraction;
- Call [GetHyperlinks](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/gethyperlinks) method and obtain collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea) objects;
- Iterate through the collection and get a hyperlink text and URL.

The following example shows how to extract all hyperlinks from the whole document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports hyperlink extraction
    if (!parser.Features.Hyperlinks)
    {
        Console.WriteLine("Document isn't supports hyperlink extraction.");
        return;
    }
    // Extract hyperlinks from the document
    IEnumerable<PageHyperlinkArea> hyperlinks = parser.GetHyperlinks();
    // Iterate over hyperlinks
    foreach (PageHyperlinkArea h in hyperlinks)
    {
        // Print the hyperlink text
        Console.WriteLine(h.Text);
        // Print the hyperlink URL
        Console.WriteLine(h.Url);
        Console.WriteLine();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document page

Path: /parser/java/extract-hyperlinks-from-document-page/

GroupDocs.Parser provides the functionality to extract hyperlinks from document page by the [getHyperlinks(int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getHyperlinks(int)) method:

```java
Iterable<PageHyperlinkArea> getHyperlinks(int pageIndex);
```

This method returns a collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea) object:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getText](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea#getText()) | The hyperlink text. |
| [getUrl](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea#getUrl()) | The hyperlink URL. |

Here are the steps to extract hyperlinks from the document page:

* Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
* Check if the document supports hyperlink extraction;
* Call [getHyperlinks(int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getHyperlinks(int)) method with the page index and obtain collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea) objects;
* Iterate through the collection and get a hyperlink text and URL.

The following example shows how to extract hyperlinks from the document page:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.HyperlinksPdf)) {
    // Check if the document supports hyperlink extraction
    if (!parser.getFeatures().isHyperlinks()) {
        System.out.println("Document isn't supports hyperlink extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Check if the document has pages
    if (documentInfo.getPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int pageIndex = 0; pageIndex < documentInfo.getPageCount(); pageIndex++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", pageIndex + 1, documentInfo.getPageCount()));
        // Extract hyperlinks from the document page
        Iterable<PageHyperlinkArea> hyperlinks = parser.getHyperlinks(pageIndex);
        // Iterate over hyperlinks
        for (PageHyperlinkArea h : hyperlinks) {
            // Print the hyperlink text
            System.out.println(h.getText());
            // Print the hyperlink URL
            System.out.println(h.getUrl());
            System.out.println();
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
* [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document page

Path: /parser/net/extract-hyperlinks-from-document-page/


GroupDocs.Parser provides the functionality to extract hyperlinks from document page by the [GetHyperlinks(Int32)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gethyperlinks/methods/2) method:

```csharp
IEnumerable<PageHyperlinkArea> GetHyperlinks(int pageIndex);
```

This method returns a collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea) object:

| Member                                                       | Description                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [Text](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea/properties/text) | The hyperlink text.                                          |
| [Url](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea/properties/url) | The hyperlink URL.                                           |

Here are the steps to extract hyperlinks from the document page:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
- Check if the document supports hyperlink extraction;
- Call [GetHyperlinks(Int32)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gethyperlinks/methods/2) method with the page index and obtain collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea) objects;
- Iterate through the collection and get a hyperlink text and URL.

The following example shows how to extract hyperlinks from the document page:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports hyperlink extraction
    if (!parser.Features.Hyperlinks)
    {
        Console.WriteLine("Document isn't supports hyperlink extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if (documentInfo.PageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int pageIndex = 0; pageIndex < documentInfo.PageCount; pageIndex++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", pageIndex + 1, documentInfo.PageCount));
        // Extract hyperlinks from the document page
        IEnumerable<PageHyperlinkArea> hyperlinks = parser.GetHyperlinks(pageIndex);
        // Iterate over hyperlinks
        foreach (PageHyperlinkArea h in hyperlinks)
        {
            // Print the hyperlink text
            Console.WriteLine(h.Text);
            // Print the hyperlink URL
            Console.WriteLine(h.Url);
            Console.WriteLine();
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document page area

Path: /parser/java/extract-hyperlinks-from-document-page-area/


GroupDocs.Parser provides the functionality to extract hyperlinks from document page area by the [getHyperlinks(PageAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getHyperlinks(com.groupdocs.parser.options.PageAreaOptions)) and [getHyperlinks(int, PageAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getHyperlinks(int,%20com.groupdocs.parser.options.PageAreaOptions)) methods:

```java
Iterable<PageHyperlinkArea> getHyperlinks(PageAreaOptions options);
Iterable<PageHyperlinkArea> getHyperlinks(int pageIndex, PageAreaOptions options);
```

These methods return a collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea) object:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getText](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea#getText()) | The hyperlink text. |
| [getUrl](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea#getUrl()) | The hyperlink URL. |

Here are the steps to extract hyperlinks from the document page area:

* Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
* Check if the document supports hyperlink extraction;
* Instantiate [PageAreaOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/PageAreaOptions) with the rectangular area;
* Call [getHyperlinks(PageAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getHyperlinks(com.groupdocs.parser.options.PageAreaOptions)) method and obtain collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageHyperlinkArea) objects;
* Iterate through the collection and get a hyperlink text and URL.

The following example shows how to extract hyperlinks from the document page area:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.HyperlinksPdf)) {
    // Check if the document supports hyperlink extraction
    if (!parser.getFeatures().isHyperlinks()) {
        System.out.println("Document isn't supports hyperlink extraction.");
        return;
    }
    // Create the options which are used for hyperlink extraction
    PageAreaOptions options = new PageAreaOptions(new Rectangle(new Point(380, 90), new Size(150, 50)));
    // Extract hyperlinks from the document page area
    Iterable<PageHyperlinkArea> hyperlinks = parser.getHyperlinks(options);
    // Iterate over hyperlinks
    for (PageHyperlinkArea h : hyperlinks) {
        // Print the hyperlink text
        System.out.println(h.getText());
        // Print the hyperlink URL
        System.out.println(h.getUrl());
        System.out.println();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from document page area

Path: /parser/net/extract-hyperlinks-from-document-page-area/


GroupDocs.Parser provides the functionality to extract hyperlinks from document page area by the [GetHyperlinks(PageAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gethyperlinks/methods/1) and [GetHyperlinks(Int32, PageAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gethyperlinks/methods/3) methods:

```csharp
IEnumerable<PageHyperlinkArea> GetHyperlinks(int pageIndex, PageAreaOptions options);
IEnumerable<PageHyperlinkArea> GetHyperlinks(PageAreaOptions options);
```

These methods return a collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea) object:

| Member                                                       | Description                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area.                        |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [Text](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea/properties/text) | The hyperlink text.                                          |
| [Url](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea/properties/url) | The hyperlink URL.                                           |

Here are the steps to extract hyperlinks from the document page area:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
- Check if the document supports hyperlink extraction;
- Instantiate [PageAreaOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pageareaoptions) with the rectangular area;
- Call [GetHyperlinks(PageAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gethyperlinks/methods/1) method and obtain collection of [PageHyperlinkArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagehyperlinkarea) objects;
- Iterate through the collection and get a hyperlink text and URL.

The following example shows how to extract hyperlinks from the document page area:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports hyperlink extraction
    if (!parser.Features.Hyperlinks)
    {
        Console.WriteLine("Document isn't supports hyperlink extraction.");
        return;
    }
    // Create the options which are used for hyperlink extraction
    PageAreaOptions options = new PageAreaOptions(new Rectangle(new Point(380, 90), new Size(150, 50)));
    // Extract hyperlinks from the document page area
    IEnumerable<PageHyperlinkArea> hyperlinks = parser.GetHyperlinks(options);
    // Iterate over hyperlinks
    foreach (PageHyperlinkArea h in hyperlinks)
    {
        // Print the hyperlink text
        Console.WriteLine(h.Text);
        // Print the hyperlink URL
        Console.WriteLine(h.Url);
        Console.WriteLine();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from Microsoft Office Word documents

Path: /parser/java/extract-hyperlinks-from-microsoft-office-word-documents/

To extract hyperlinks from Microsoft Office Word document [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method is used. This method returns XML representation of the document. Hyperlinks are represented by "hyperlink" tag; "link" attribute contains hyperlink's URL. For more details, see [Extract text structure]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/extract-text-structure.md" >}}). Hyperlink can contain a text:

```xml
<hyperlink link="www.google.com">google.com</hyperlink>
```

{{< alert style="warning" >}}[getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method returns null value if text structure extraction isn't supported for the document. For example, text structure extraction isn't supported for TXT files. Therefore, for TXT file [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method returns null. If Microsoft Office Word document has no text, [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method returns an empty org.w3c.dom.Document object.{{< /alert >}}

Here are the steps to extract hyperlinks from Microsoft Office Word documents:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method and obtain [*org.w3c.dom.Document*](https://docs.oracle.com/javase/7/docs/api/org/w3c/dom/Document.html?is-external=true) object;
*   Iterate through the XML document.

The following example demonstrates how to extract hyperlinks from Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleHyperlinksDocx)) {
    // Extract text structure to the XML reader
    Document document = parser.getStructure();
    // Read XML document
    readNode(document.getDocumentElement());
}

private static void readNode(Node node) {
    NodeList nodes = node.getChildNodes();
    for (int i = 0; i < nodes.getLength(); i++) {
        Node n = nodes.item(i);
        if (n.getNodeName().toLowerCase() == "hyperlink") {
            Node a = n.getAttributes().getNamedItem("link");
            if (a != null) {
                System.out.println(a.getNodeValue());
            }
        }
        if(n.hasChildNodes()) {
            readNode(n);
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)
    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract hyperlinks from Microsoft Office Word documents

Path: /parser/net/extract-hyperlinks-from-microsoft-office-word-documents/

To extract hyperlinks from Microsoft Office Word document [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method is used. This method returns XML representation of the document. Hyperlinks are represented by "hyperlink" tag; "link" attribute contains hyperlink's URL. For more details, see [Extract text structure]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/extract-text-structure.md" >}}). Hyperlink can contain a text:

```xml
<hyperlink link="www.google.com">google.com</hyperlink>
```

{{< alert style="warning" >}}
[GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method returns *null* value if text structure extraction isn't supported for the document. For example, text structure extraction isn't supported for TXT files. Therefore, for TXT file [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method returns *null*. If Microsoft Office Word document has no text, [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure)[](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata)method returns an empty [XmlReader](https://docs.microsoft.com/en-us/dotnet/api/system.xml.xmlreader?view=netframework-2.0) object.
{{< /alert >}}

Here are the steps to extract hyperlinks from Microsoft Office Word documents:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method and obtain [XmlReader](https://docs.microsoft.com/en-us/dotnet/api/system.xml.xmlreader?view=netframework-2.0) object;
*   Iterate through the XML document.

The following example demonstrates how to extract hyperlinks from Microsoft Office Word document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Get the reader object for the document XML representation
    using (XmlReader reader = parser.GetStructure())
    {
        // Iterate over the document
        while (reader.Read())
        {
            // If it is the start tag of the hyperlink
            if (reader.IsStartElement() && reader.Name == "hyperlink")
            {
                // Print the link attribute
                Console.WriteLine(reader.GetAttribute("link"));
            }
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images to files

Path: /parser/java/extract-images-to-files/

Here are the steps to extract images to files:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects;
*   Check if *collection* isn't *null* (images extraction is supported for the document);
*   Iterate through the collection and save image contents to the file.

The following example shows how to save images to files:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleZip)) {
    // Extract images from document
    Iterable<PageImageArea> images = parser.getImages();

    // Check if images extraction is supported
    if (images == null) {
        System.out.println("Page images extraction isn't supported");
        return;
    }

    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);

    int imageNumber = 0;
    // Iterate over images
    for (PageImageArea image : images)
    {
        // Save the image to the png file
        image.save(Constants.getOutputFilePath(String.format("%d.png", imageNumber)), options);

        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images to files

Path: /parser/net/extract-images-to-files/

Here are the steps to extract images to files:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects;
*   Check if *collection* isn't null (images extraction is supported for the document);
*   Iterate through the collection and save image contents to the file.

The following example shows how to save images to files:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleZip))
{
    // Extract images from document
    IEnumerable<PageImageArea> images = parser.GetImages();
    // Check if images extraction is supported
    if (images == null)
    {
        Console.WriteLine("Page images extraction isn't supported");
        return;
    }
    // Create the options to save images in PNG format
    ImageOptions options = new ImageOptions(ImageFormat.Png);
    int imageNumber = 0;
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Save the image to the png file
        image.Save(imageNumber.ToString() + ".png", options);
        imageNumber++;
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract images to files

Path: /parser/python-net/extract-images-to-files/


GroupDocs.Parser provides functionality to save extracted images directly to files with support for format conversion.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents with images
- Write permissions to output directory

## Save images to files

To extract and save images to files:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

# Create output directory
output_dir = "extracted_images"
os.makedirs(output_dir, exist_ok=True)

# Create an instance of Parser class
with Parser("./document.pdf") as parser:
    # Extract images
    images = parser.get_images()
    
    # Check if image extraction is supported
    if images is None:
        print("Image extraction isn't supported")
    else:
        # Iterate over images and save them
        for idx, image in enumerate(images):
            # Generate filename with appropriate extension
            filename = f"image_{idx + 1}{image.file_type.extension}"
            filepath = os.path.join(output_dir, filename)
            
            # Save image to file
            image.save(filepath)
            print(f"Saved: {filename}")
```

{{< /tab >}}
{{< tab "document.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-to-files/document.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Saves each extracted image to a separate file using the image's original format.

## Save images with format conversion

To save images in a specific format (e.g., PNG):
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import ImageOptions, ImageFormat
import os

# Create output directory
output_dir = "images_png"
os.makedirs(output_dir, exist_ok=True)

# Create an instance of Parser class
with Parser("presentation.pptx") as parser:
    # Extract images
    images = parser.get_images()
    
    if images is None:
        print("Image extraction not supported")
    else:
        # Create image options for PNG format
        png_options = ImageOptions(ImageFormat.PNG)
        
        # Save all images as PNG
        for idx, image in enumerate(images):
            filename = f"image_{idx + 1}.png"
            filepath = os.path.join(output_dir, filename)
            
            # Save with format conversion
            image.save(filepath, png_options)
            print(f"Saved as PNG: {filename}")
```

{{< /tab >}}
{{< tab "presentation.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [presentation.pptx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-to-files/presentation.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "ImageFormat.PNG" >}}
{{< tab-text >}}
The following sample file is used in this example: [ImageFormat.PNG](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-to-files/ImageFormat.PNG)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Converts all extracted images to PNG format before saving.

## Save images with custom naming

To save images with descriptive filenames:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os
from datetime import datetime

def save_images_with_custom_names(file_path, output_dir, prefix="doc"):
    """
    Save images with custom naming pattern.
    """
    os.makedirs(output_dir, exist_ok=True)
    
    # Generate timestamp
    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
    
    with Parser(file_path) as parser:
        images = parser.get_images()
        
        if images is None:
            print("Image extraction not supported")
            return 0
        
        saved_count = 0
        
        for idx, image in enumerate(images):
            # Create custom filename
            filename = f"{prefix}_{timestamp}_page{image.page.index + 1}_img{idx + 1}{image.file_type.extension}"
            filepath = os.path.join(output_dir, filename)
            
            # Save image
            image.save(filepath)
            print(f"Saved: {filename}")
            saved_count += 1
        
        return saved_count

# Usage
count = save_images_with_custom_names("report.pdf", "saved_images", prefix="report")
print(f"
Total images saved: {count}")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Saves images with descriptive filenames including timestamp, page number, and index.

## Save images in multiple formats

To save each image in multiple formats:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import ImageOptions, ImageFormat
import os

# Create output directory
output_dir = "images_multi_format"
os.makedirs(output_dir, exist_ok=True)

# Create an instance of Parser class
with Parser("document.docx") as parser:
    images = parser.get_images()
    
    if images:
        # Define formats to save
        formats = {
            'png': ImageOptions(ImageFormat.PNG),
            'jpg': ImageOptions(ImageFormat.JPEG),
            'bmp': ImageOptions(ImageFormat.BMP)
        }
        
        for idx, image in enumerate(images):
            print(f"
Processing image {idx + 1}:")
            
            # Save in each format
            for format_name, options in formats.items():
                filename = f"image_{idx + 1}.{format_name}"
                filepath = os.path.join(output_dir, filename)
                
                image.save(filepath, options)
                print(f"  Saved as {format_name.upper()}")
```

{{< /tab >}}
{{< tab "document.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [document.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-to-files/document.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "ImageFormat.PNG" >}}
{{< tab-text >}}
The following sample file is used in this example: [ImageFormat.PNG](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-to-files/ImageFormat.PNG)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "ImageFormat.JPEG" >}}
{{< tab-text >}}
The following sample file is used in this example: [ImageFormat.JPEG](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-to-files/ImageFormat.JPEG)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "ImageFormat.BMP" >}}
{{< tab-text >}}
The following sample file is used in this example: [ImageFormat.BMP](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/extract-images-to-files/ImageFormat.BMP)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Saves each image in PNG, JPEG, and BMP formats.

## Organize images by page

To save images organized by page number:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

def save_images_by_page(file_path, output_dir):
    """
    Save images organized in subdirectories by page.
    """
    os.makedirs(output_dir, exist_ok=True)
    
    with Parser(file_path) as parser:
        images = parser.get_images()
        
        if images is None:
            print("Image extraction not supported")
            return
        
        # Group images by page
        images_by_page = {}
        
        for image in images:
            page_num = image.page.index + 1
            if page_num not in images_by_page:
                images_by_page[page_num] = []
            images_by_page[page_num].append(image)
        
        # Save images organized by page
        total_saved = 0
        
        for page_num, page_images in sorted(images_by_page.items()):
            # Create page directory
            page_dir = os.path.join(output_dir, f"page_{page_num}")
            os.makedirs(page_dir, exist_ok=True)
            
            print(f"
Page {page_num}: {len(page_images)} images")
            
            for img_idx, image in enumerate(page_images):
                filename = f"image_{img_idx + 1}{image.file_type.extension}"
                filepath = os.path.join(page_dir, filename)
                
                image.save(filepath)
                print(f"  Saved: {filename}")
                total_saved += 1
        
        print(f"
Total images saved: {total_saved}")

# Usage
save_images_by_page("multi_page.pdf", "images_by_page")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates subdirectories for each page and saves images within their respective page folders.

## Save only images of specific type

To save only images of a particular format:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import os

def save_images_by_type(file_path, output_dir, target_extensions):
    """
    Save only images of specific types.
    
    Args:
        file_path: Path to document
        output_dir: Output directory
        target_extensions: List of extensions to save (e.g., ['.jpg', '.png'])
    """
    os.makedirs(output_dir, exist_ok=True)
    
    with Parser(file_path) as parser:
        images = parser.get_images()
        
        if images is None:
            print("Image extraction not supported")
            return
        
        saved_count = 0
        skipped_count = 0
        
        for idx, image in enumerate(images):
            ext = image.file_type.extension.lower()
            
            if ext in target_extensions:
                filename = f"image_{idx + 1}{ext}"
                filepath = os.path.join(output_dir, filename)
                
                image.save(filepath)
                print(f"Saved: {filename}")
                saved_count += 1
            else:
                print(f"Skipped: image_{idx + 1}{ext}")
                skipped_count += 1
        
        print(f"
Saved: {saved_count}, Skipped: {skipped_count}")

# Usage - save only JPG and PNG images
save_images_by_type("document.pdf", "filtered_images", ['.jpg', '.jpeg', '.png'])
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Saves only images matching the specified formats, skipping others.

## Batch save images from multiple documents

To extract and save images from multiple documents:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from pathlib import Path
import os

def batch_save_images(input_dir, output_dir):
    """
    Extract and save images from all documents in a directory.
    """
    os.makedirs(output_dir, exist_ok=True)
    
    extensions = ['.pdf', '.docx', '.doc', '.pptx', '.ppt']
    
    for file_path in Path(input_dir).rglob('*'):
        if file_path.suffix.lower() in extensions:
            print(f"
Processing: {file_path.name}")
            
            # Create subdirectory for this document
            doc_output_dir = os.path.join(output_dir, file_path.stem)
            os.makedirs(doc_output_dir, exist_ok=True)
            
            try:
                with Parser(str(file_path)) as parser:
                    images = parser.get_images()
                    
                    if images:
                        image_count = 0
                        for idx, image in enumerate(images):
                            filename = f"image_{idx + 1}{image.file_type.extension}"
                            filepath = os.path.join(doc_output_dir, filename)
                            image.save(filepath)
                            image_count += 1
                        
                        print(f"  Saved {image_count} images")
                    else:
                        print(f"  No images or not supported")
            
            except Exception as e:
                print(f"  Error: {e}")

# Usage
batch_save_images("input_documents", "all_extracted_images")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Processes multiple documents and saves their images in organized subdirectories.

## Notes

- The `save()` method saves images to the specified file path
- Use `ImageOptions` to convert images to different formats
- Supported output formats: BMP, GIF, JPEG, PNG, WebP
- Original image format is preserved unless `ImageOptions` is specified
- Always create the output directory before saving
- File paths can be absolute or relative
- Consider disk space when extracting many images

## Related pages

- [Extract images from document]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document" >}})
- [Extract images from document page]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page" >}})
- [Extract images from document page area]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/extract-images-from-document-page-area" >}})


---

## Extract tables from document

Path: /parser/java/extract-tables-from-document/


GroupDocs.Parser provides the functionality to extract tables from documents by the [getTables(PageTableAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getTables(com.groupdocs.parser.options.PageTableAreaOptions)) method:

```java
Iterable<PageTableArea> getTables(PageTableAreaOptions options);
```

This method returns a collection of [PageTableArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea) object:

| Member | Description |
| --- | --- |
| [getRectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area that bounds text area. |
| [getPage](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page information (page index and page size) |
| [getRowCount](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getRowCount()) | The total number of the table rows. |
| [getColumnCount](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getColumnCount()) | The total number of the table columns. |
| [getCell(int, int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getCell(int,%20int)) | The table cell by row and column indexes. |
| [getRowHeight(int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getRowHeight(int)) | The the row height. |
| [getColumnWidth(int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getColumnWidth(int)) | Returns the column width. |

[getTables(PageTableAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getTables(com.groupdocs.parser.options.PageTableAreaOptions)) accepts [PageTableAreaOption](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/PageTableAreaOptions) object that contains [TemplateTableLayout](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.templates/TemplateTableLayout) object with table layout (see [this article]({{< ref "parser/java/developer-guide/advanced-usage/working-with-templates.md" >}}) for more details).

Here are the steps to extract tables from the whole document:

* Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser) object for the initial document;
* Check if the document supports table extraction;
* Call [getTables(PageTableAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getTables(com.groupdocs.parser.options.PageTableAreaOptions)) method and obtain collection of [PageTableArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea) objects;
* Iterate through the collection and print table cells.

The following example shows how to extract tables from the whole document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleInvoicePagesPdf)) {
    // Check if the document supports table extraction
    if (!parser.getFeatures().isTables()) {
        System.out.println("Document isn't supports tables extraction.");
        return;
    }
    // Create the layout of tables
    TemplateTableLayout layout = new TemplateTableLayout(
            java.util.Arrays.asList(new Double[]{50.0, 95.0, 275.0, 415.0, 485.0, 545.0}),
            java.util.Arrays.asList(new Double[]{325.0, 340.0, 365.0, 395.0}));
    // Create the options for table extraction
    PageTableAreaOptions options = new PageTableAreaOptions(layout);
    // Extract tables from the document
    Iterable<PageTableArea> tables = parser.getTables(options);
    // Iterate over tables
    for (PageTableArea t : tables) {
        // Iterate over rows
        for (int row = 0; row < t.getRowCount(); row++) {
            // Iterate over columns
            for (int column = 0; column < t.getColumnCount(); column++) {
                // Get the table cell
                PageTableAreaCell cell = t.getCell(row, column);
                if (cell != null) {
                    // Print the table cell text
                    System.out.print(cell.getText());
                    System.out.print(" | ");
                }
            }
            System.out.println();
        }
        System.out.println();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
* [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract tables from document

Path: /parser/net/extract-tables-from-document/


GroupDocs.Parser provides the functionality to extract tables from documents including **Excel spreadsheets (XLS, XLSX)**, Word documents, PDFs, and other supported formats using the [GetTables(PageTableAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/gettables) method.

## Extract Tables from Excel C#

To **extract tables from Excel C#** applications, GroupDocs.Parser supports extracting structured table data from Excel spreadsheets. This is especially useful for processing data-rich Excel files programmatically.

```csharp
IEnumerable<PageTableArea> GetTables(PageTableAreaOptions options);
```

This method returns a collection of [PageTableArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagetablearea) object:

| Member                                                       | Description                                     |
| ------------------------------------------------------------ | ----------------------------------------------- |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area that bounds text area.     |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page information (page index and page size) |
| [RowCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/rowcount) | The total number of the table rows.             |
| [ColumnCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/columncount) | The total number of the table columns.          |
| PageTableAreaCell [Item](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/item) | The table cell by row and column indexes.       |
| double [GetRowHeight(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/methods/getrowheight) | The the row height.                             |
| double [GetColumnWidth(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/methods/getcolumnwidth) | Returns the column width.                       |

[GetTables(PageTableAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/gettables) accepts [PageTableAreaOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/pagetableareaoptions) object that contains [TemplateTableLayout](https://reference.groupdocs.com/parser/net/groupdocs.parser.templates/templatetablelayout) object with table layout (see [this article]({{< ref "parser/net/developer-guide/advanced-usage/working-with-templates.md" >}}) for more details).

### Basic Steps

Here are the basic steps to extract tables from documents:

1. Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the document (Excel, Word, PDF, etc.);
2. Check if the document supports **table extraction** using `Features.Tables` property;
3. Call [GetTables(PageTableAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/gettables) method and obtain collection of [PageTableArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagetablearea) objects;
4. Iterate through the collection and access table cells.

### Example: Extract Tables from Excel Spreadsheet

```csharp
using GroupDocs.Parser;
using GroupDocs.Parser.Options;
using GroupDocs.Parser.Data;
using GroupDocs.Parser.Templates;

// Excel file path
string excelPath = "sample.xlsx";

using (Parser parser = new Parser(excelPath))
{
    // Check if table extraction is supported for Excel
    if (!parser.Features.Tables)
    {
        Console.WriteLine("Table extraction is not supported for this Excel file.");
        return;
    }
    
    // Extract all tables from the Excel spreadsheet
    // Pass null to extract tables automatically
    IEnumerable<PageTableArea> tables = parser.GetTables(null);
    
    int tableIndex = 0;
    foreach (PageTableArea table in tables)
    {
        Console.WriteLine($"\n=== Table {++tableIndex} ===");
        Console.WriteLine($"Rows: {table.RowCount}, Columns: {table.ColumnCount}");
        
        // Iterate over rows
        for (int row = 0; row < table.RowCount; row++)
        {
            // Iterate over columns
            for (int column = 0; column < table.ColumnCount; column++)
            {
                // Get the table cell
                PageTableAreaCell cell = table[row, column];
                if (cell != null)
                {
                    // Print the cell text
                    Console.Write($"{cell.Text}\t");
                }
            }
            Console.WriteLine();
        }
    }
}
```

### Example: Extract Tables with Custom Layout

The following example shows how to extract tables from documents when you know the exact table structure (columns and rows positions):

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports table extraction
    if (!parser.Features.Tables)
    {
        Console.WriteLine("Document isn't supports tables extraction.");
        return;
    }
    // Create the layout of tables
    TemplateTableLayout layout = new TemplateTableLayout(
        new double[] { 50, 95, 275, 415, 485, 545 },
        new double[] { 325, 340, 365, 395 });
    // Create the options for table extraction
    PageTableAreaOptions options = new PageTableAreaOptions(layout);
    // Extract tables from the document
    IEnumerable<PageTableArea> tables = parser.GetTables(options);
    // Iterate over tables
    foreach (PageTableArea t in tables)
    {
        // Iterate over rows
        for (int row = 0; row < t.RowCount; row++)
        {
            // Iterate over columns
            for (int column = 0; column < t.ColumnCount; column++)
            {
                // Get the table cell
                PageTableAreaCell cell = t[row, column];
                if (cell != null)
                {
                    // Print the table cell text
                    Console.Write(cell.Text);
                    Console.Write(" | ");
                }
            }
            Console.WriteLine();
        }
        Console.WriteLine();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract tables from document page

Path: /parser/java/extract-tables-from-document-page/


GroupDocs.Parser provides the functionality to extract tables from document page by the [getTable(int, PageTableAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getTables(int,%20com.groupdocs.parser.options.PageTableAreaOptions)) method:

```java
Iterable<PageTableArea> getTables(int pageIndex, PageTableAreaOptions options);
```

This method returns a collection of [PageTableArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea) object:

| Member | Description |
| --- | --- |
| [getRectangle](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area that bounds text area. |
| [getPage](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageArea#getPage()) | The page information (page index and page size) |
| [getRowCount](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getRowCount()) | The total number of the table rows. |
| [getColumnCount](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getColumnCount()) | The total number of the table columns. |
| [getCell(int, int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getCell(int,%20int)) | The table cell by row and column indexes. |
| [getRowHeight(int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getRowHeight(int)) | The the row height. |
| [getColumnWidth(int)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea#getColumnWidth(int)) | Returns the column width. |

[getTables(int, PageTableAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getTables(int,%20com.groupdocs.parser.options.PageTableAreaOptions)) accepts [PageTableAreaOption](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/PageTableAreaOptions) object that contains [TemplateTableLayout](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.templates/TemplateTableLayout) object with table layout (see [this article]({{< ref "parser/java/developer-guide/advanced-usage/working-with-templates.md" >}}) for more details).

Here are the steps to extract tables from the whole document:

* Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser) object for the initial document;
* Check if the document supports table extraction;
* Call [getTables(int, PageTableAreaOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#getTables(int,%20com.groupdocs.parser.options.PageTableAreaOptions)) method with the page index and obtain collection of [PageTableArea](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/PageTableArea) objects;
* Iterate through the collection and print table cells.

The following example shows how to extract tables from the whole document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleInvoicePagesPdf)) {
    // Check if the document supports table extraction
    if (!parser.getFeatures().isTables()) {
        System.out.println("Document isn't supports tables extraction.");
        return;
    }
    // Create the layout of tables
    TemplateTableLayout layout = new TemplateTableLayout(
            java.util.Arrays.asList(new Double[]{50.0, 95.0, 275.0, 415.0, 485.0, 545.0}),
            java.util.Arrays.asList(new Double[]{325.0, 340.0, 365.0, 395.0}));
    // Create the options for table extraction
    PageTableAreaOptions options = new PageTableAreaOptions(layout);
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Check if the document has pages
    if (documentInfo.getPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int pageIndex = 0; pageIndex < documentInfo.getPageCount(); pageIndex++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", pageIndex + 1, documentInfo.getPageCount()));
        // Extract tables from the document page
        Iterable<PageTableArea> tables = parser.getTables(pageIndex, options);
        // Iterate over tables
        for (PageTableArea t : tables) {
            // Iterate over rows
            for (int row = 0; row < t.getRowCount(); row++) {
                // Iterate over columns
                for (int column = 0; column < t.getColumnCount(); column++) {
                    // Get the table cell
                    PageTableAreaCell cell = t.getCell(row, column);
                    if (cell != null) {
                        // Print the table cell text
                        System.out.print(cell.getText());
                        System.out.print(" | ");
                    }
                }
                System.out.println();
            }
            System.out.println();
        }
    }
}
```

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract tables from document page

Path: /parser/net/extract-tables-from-document-page/


GroupDocs.Parser provides the functionality to extract tables from document page by the [GetTables(Int32, PageTableAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gettables/methods/1) method:

```csharp
IEnumerable<PageTableArea> GetTables(int pageIndex, PageTableAreaOptions options);
```

This method returns a collection of [PageTableArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagetablearea) object:

| Member                                                       | Description                                     |
| ------------------------------------------------------------ | ----------------------------------------------- |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area that bounds text area.     |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page information (page index and page size) |
| [RowCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/rowcount) | The total number of the table rows.             |
| [ColumnCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/columncount) | The total number of the table columns.          |
| PageTableAreaCell [Item](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/item) | The table cell by row and column indexes.       |
| double [GetRowHeight(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/methods/getrowheight) | The the row height.                             |
| double [GetColumnWidth(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/methods/getcolumnwidth) | Returns the column width.                       |

[GetTables(Int32, PageTableAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gettables/methods/1) accepts [PageTableAreaOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/pagetableareaoptions) object that contains [TemplateTableLayout](https://reference.groupdocs.com/parser/net/groupdocs.parser.templates/templatetablelayout) object with table layout (see [this article]({{< ref "parser/net/developer-guide/advanced-usage/working-with-templates.md" >}}) for more details).

Here are the steps to extract tables from a specific document page:

1. Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the document;
2. Check if the document supports **table extraction** using `Features.Tables` property;
3. Get document info to determine total page count;
4. Call [GetTables(Int32, PageTableAreaOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser.parser/gettables/methods/1) method with page index and obtain collection of [PageTableArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagetablearea) objects;
5. Iterate through the collection and access table cells.

The following example shows how to extract tables from the document page:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the document supports table extraction
    if (!parser.Features.Tables)
    {
        Console.WriteLine("Document isn't supports tables extraction.");
        return;
    }
    // Create the layout of tables
    TemplateTableLayout layout = new TemplateTableLayout(
        new double[] { 50, 95, 275, 415, 485, 545 },
        new double[] { 325, 340, 365, 395 });
    // Create the options for table extraction
    PageTableAreaOptions options = new PageTableAreaOptions(layout);
    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if (documentInfo.PageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int pageIndex = 0; pageIndex < documentInfo.PageCount; pageIndex++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", pageIndex + 1, documentInfo.PageCount));
        // Extract tables from the document page
        IEnumerable<PageTableArea> tables = parser.GetTables(pageIndex, options);
        // Iterate over tables
        foreach (PageTableArea t in tables)
        {
            // Iterate over rows
            for (int row = 0; row < t.RowCount; row++)
            {
                // Iterate over columns
                for (int column = 0; column < t.ColumnCount; column++)
                {
                    // Get the table cell
                    PageTableAreaCell cell = t[row, column];
                    if (cell != null)
                    {
                        // Print the table cell text
                        Console.Write(cell.Text);
                        Console.Write(" | ");
                    }
                }
                Console.WriteLine();
            }
            Console.WriteLine();
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

- [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
- [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Fixing Invalid Form Fields

Path: /editor/java/fixing-invalid-form-fields/


This article demonstrates how to fix invalid form fields in a Word document using GroupDocs.Editor for Java. The example guides you through loading a document, identifying and fixing invalid form fields, and saving the updated document.

#### Step-by-Step Guide

1. **Create a InputStream from the Path**

   Create a `InputStream` from the input file path.

   ```java
   InputStream fs = new FileInputStream(inputFilePath);
   {
       // Further code will be placed here
   }
   ```

2. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```java
   WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
   loadOptions.setPassword("some_password_to_open_a_document)";
   ```

3. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```java
   Editor editor = new Editor(fs, loadOptions);
   {
       // Further code will be placed here
   }
   ```

4. **Retrieve and Fix Invalid Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor` and read the `FormFieldCollection`. Attempt to auto-fix invalid form fields, then check if any invalid form fields remain. If so, generate unique names for the invalid fields and fix them.

   ```java
   FormFieldManager fieldManager = editor.getFormFieldManager();
   FormFieldCollection collection = fieldManager.getFormFieldCollection();

   fieldManager.fixInvalidFormFieldNames(new ArrayList<InvalidFormField>());
   collection = fieldManager.getFormFieldCollection();

   boolean hasInvalidFormFields = fieldManager.hasInvalidFormFields();
   System.out.println("FormFieldCollection contains invalid items: "+ hasInvalidFormFields);

   Collection<InvalidFormField> invalidFormFields = fieldManager.getInvalidFormFieldNames();
   for (InvalidFormField invalidItem : invalidFormFields)
   {
       invalidItem.setFixedName(String.format("%s_%s", invalidItem.getName(), java.util.UUID.randomUUID()));
   }
   fieldManager.fixInvalidFormFieldNames(new ArrayList(invalidFormFields));
   collection = fieldManager.getFormFieldCollection();
   ```

5. **Create and Set Save Options**

   Initialize the `WordProcessingSaveOptions` with the desired format. Optimize memory usage if necessary, and protect the document from writing with a password.

   ```java
   WordProcessingFormats docFormat = WordProcessingFormats.Docx;
   WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);
   saveOptions.setOptimizeMemoryUsage(true);
   saveOptions.setProtection(new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password"));
   ```

6. **Save the Document**

   Prepare a stream for saving and use the `Save` method of the `Editor` to save the updated document.

   ```java
   ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
   {
       editor.save(outputStream, saveOptions);
   }
   ```

7. **Completion Message**

   Print a confirmation message to indicate the successful completion of the operation.

   ```java
   System.out.println("FixInvalidFormFieldCollectionAndSave routine has successfully finished");
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```java
/**
  * This example demonstrates how to fix invalid form fields in a collection and save the document using GroupDocs.Editor for Java.
  */
public class FixInvalidFormFieldCollectionAndSave {
  /**
    * Runs the example to demonstrate loading, fixing invalid form fields, and saving a document.
    */
    public static void run() throws Exception
    {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample DOCX with form fields.
        String inputFilePath = Constants.SampleLegacyFormFields_docx;

        // 2. Create a stream from this path
        InputStream fs = new FileInputStream(inputFilePath);

        // 3. Create load options for this document
        WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
        // 3.1. If the input document is password-protected, specify the password for its opening...
        loadOptions.setPassword("some_password_to_open_a_document");
        // 3.2. ...but, because the document is unprotected, this password will be ignored

        // 4. Load the document with options into the Editor instance
        Editor editor = new Editor(fs,loadOptions);

        // 4.1. Read the FormFieldManager instance
        FormFieldManager fieldManager = editor.getFormFieldManager();
        // 4.2. Read the FormFieldCollection in the document
        FormFieldCollection collection = fieldManager.getFormFieldCollection();

        // 4.3. Try to auto-fix invalid form fields
        fieldManager.fixInvalidFormFieldNames(new ArrayList<InvalidFormField>());
        collection = fieldManager.getFormFieldCollection();

        boolean hasInvalidFormFields = fieldManager.hasInvalidFormFields();
        System.out.println("FormFieldCollection contains invalid items: "+ hasInvalidFormFields);

        // 4.4. Try to fix invalid form fields
        // 4.4.1. Get all invalid form field names
        Collection<InvalidFormField> invalidFormFields = fieldManager.getInvalidFormFieldNames();

        // 4.4.2. Create unique names for invalid fields
        for (InvalidFormField invalidItem : invalidFormFields)
        {
            invalidItem.setFixedName(String.format("%s_%s", invalidItem.getName(), java.util.UUID.randomUUID()));
        }

        // 4.4.3. Fix invalid fields
        fieldManager.fixInvalidFormFieldNames(new ArrayList(invalidFormFields));
        collection = fieldManager.getFormFieldCollection();

        // 5. Create document save options
        WordProcessingFormats docFormat = WordProcessingFormats.Docx;
        WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);

        // 5.1. If the document is large and causes OutOfMemoryException, set the memory optimization option
        saveOptions.setOptimizeMemoryUsage(true);

        // 5.2. Protect the document from writing (allow only form fields) with a password
        saveOptions.setProtection(new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password"));

        // 6. Save the document
        // 6.1. Prepare a stream for saving
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        {
            // 6.2. Save the document
            editor.save(outputStream, saveOptions);
        }


        System.out.println("FixInvalidFormFieldCollectionAndSave routine has successfully finished");
    }
}

```


---

## Fixing Invalid Form Fields

Path: /editor/net/fixing-invalid-form-fields/


This article demonstrates how to fix invalid form fields in a Word document using GroupDocs.Editor for .NET. The example guides you through loading a document, identifying and fixing invalid form fields, and saving the updated document.

#### Step-by-Step Guide

1. **Create a Stream from the Path**

   Create a `FileStream` from the input file path.

   ```csharp
   using (FileStream fs = File.OpenRead(inputFilePath))
   {
       // Further code will be placed here
   }
   ```

2. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```csharp
   WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
   loadOptions.Password = "some_password_to_open_a_document";
   ```

3. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```csharp
   using (Editor editor = new Editor(fs, loadOptions))
   {
       // Further code will be placed here
   }
   ```

4. **Retrieve and Fix Invalid Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor` and read the `FormFieldCollection`. Attempt to auto-fix invalid form fields, then check if any invalid form fields remain. If so, generate unique names for the invalid fields and fix them.

   ```csharp
   FormFieldManager fieldManager = editor.FormFieldManager;
   FormFieldCollection collection = fieldManager.FormFieldCollection;

   fieldManager.FixInvalidFormFieldNames(new InvalidFormField[0]);
   collection = fieldManager.FormFieldCollection;

   bool hasInvalidFormFields = fieldManager.HasInvalidFormFields();
   System.Console.WriteLine("FormFieldCollection contains invalid items: {0}", hasInvalidFormFields);

   var invalidFormFields = fieldManager.GetInvalidFormFieldNames();
   foreach (var invalidItem in invalidFormFields)
   {
       invalidItem.FixedName = string.Format("{0}_{1}", invalidItem.Name, Guid.NewGuid());
   }
   fieldManager.FixInvalidFormFieldNames(invalidFormFields);
   collection = fieldManager.FormFieldCollection;
   ```

5. **Create and Set Save Options**

   Initialize the `WordProcessingSaveOptions` with the desired format. Optimize memory usage if necessary, and protect the document from writing with a password.

   ```csharp
   WordProcessingFormats docFormat = WordProcessingFormats.Docx;
   WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);
   saveOptions.OptimizeMemoryUsage = true;
   saveOptions.Protection = new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password");
   ```

6. **Save the Document**

   Prepare a stream for saving and use the `Save` method of the `Editor` to save the updated document.

   ```csharp
   using (MemoryStream outputStream = new MemoryStream())
   {
       editor.Save(outputStream, saveOptions);
   }
   ```

7. **Completion Message**

   Print a confirmation message to indicate the successful completion of the operation.

   ```csharp
   System.Console.WriteLine("FixInvalidFormFieldCollectionAndSave routine has successfully finished");
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```csharp
/// <summary>
/// This example demonstrates how to fix invalid form fields in a collection and save the document using GroupDocs.Editor for .NET.
/// </summary>
internal static class FixInvalidFormFieldCollectionAndSave
{
    /// <summary>
    /// Runs the example to demonstrate loading, fixing invalid form fields, and saving a document.
    /// </summary>
    internal static void Run()
    {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample DOCX with form fields.
        string inputFilePath = Constants.SampleLegacyFormFields_docx;

        // 2. Create a stream from this path
        using (FileStream fs = File.OpenRead(inputFilePath))
        {
            // 3. Create load options for this document
            WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
            // 3.1. If the input document is password-protected, specify the password for its opening...
            loadOptions.Password = "some_password_to_open_a_document";
            // 3.2. ...but, because the document is unprotected, this password will be ignored

            // 4. Load the document with options into the Editor instance
            using (Editor editor = new Editor(fs, loadOptions))
            {
                // 4.1. Read the FormFieldManager instance
                FormFieldManager fieldManager = editor.FormFieldManager;
                // 4.2. Read the FormFieldCollection in the document
                FormFieldCollection collection = fieldManager.FormFieldCollection;

                // 4.3. Try to auto-fix invalid form fields
                fieldManager.FixInvalidFormFieldNames(new InvalidFormField[0]);
                collection = fieldManager.FormFieldCollection;

                bool hasInvalidFormFields = fieldManager.HasInvalidFormFields();
                System.Console.WriteLine("FormFieldCollection contains invalid items: {0}", hasInvalidFormFields);

                // 4.4. Try to fix invalid form fields
                // 4.4.1. Get all invalid form field names


                var invalidFormFields = fieldManager.GetInvalidFormFieldNames();

                // 4.4.2. Create unique names for invalid fields
                foreach (var invalidItem in invalidFormFields)
                {
                    invalidItem.FixedName = string.Format("{0}_{1}", invalidItem.Name, Guid.NewGuid());
                }

                // 4.4.3. Fix invalid fields
                fieldManager.FixInvalidFormFieldNames(invalidFormFields);
                collection = fieldManager.FormFieldCollection;

                // 5. Create document save options
                WordProcessingFormats docFormat = WordProcessingFormats.Docx;
                WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);

                // 5.1. If the document is large and causes OutOfMemoryException, set the memory optimization option
                saveOptions.OptimizeMemoryUsage = true;

                // 5.2. Protect the document from writing (allow only form fields) with a password
                saveOptions.Protection = new WordProcessingProtection(WordProcessingProtectionType.AllowOnlyFormFields, "write_password");

                // 6. Save the document
                // 6.1. Prepare a stream for saving
                using (MemoryStream outputStream = new MemoryStream())
                {
                    // 6.2. Save the document
                    editor.Save(outputStream, saveOptions);
                }
            }
        }
        System.Console.WriteLine("FixInvalidFormFieldCollectionAndSave routine has successfully finished");
    }
}
```


---

## Fixing Invalid Form Fields

Path: /editor/nodejs-java/fixing-invalid-form-fields/


This article demonstrates how to fix invalid form fields in a Word document using **GroupDocs.Editor for Node.js via Java**. The example guides you through loading a document, identifying and fixing invalid form fields, and saving the updated document.

#### Step-by-Step Guide

1. **Create a Readable Stream from the Path**

   Create a readable stream from the input file path.

   ```javascript
   const fs = require('fs');
   const inputFilePath = 'path/to/your/document.docx';
   const inputStream = fs.createReadStream(inputFilePath);
   // Further code will be placed here
   ```

2. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```javascript
   const groupdocsEditor = require('groupdocs-editor');

   const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();
   loadOptions.setPassword('some_password_to_open_a_document');
   ```

3. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```javascript
   const editor = new groupdocsEditor.Editor(inputStream, loadOptions);
   // Further code will be placed here
   ```

4. **Retrieve and Fix Invalid Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor` and read the `FormFieldCollection`. Attempt to auto-fix invalid form fields, then check if any invalid form fields remain. If so, generate unique names for the invalid fields and fix them.

   ```javascript
   // Get the FormFieldManager instance
   const fieldManager = editor.getFormFieldManager();
   // Get the FormFieldCollection in the document
   let collection = fieldManager.getFormFieldCollection();

   // Try to auto-fix invalid form fields
   fieldManager.fixInvalidFormFieldNames([]);
   collection = fieldManager.getFormFieldCollection();

   const hasInvalidFormFields = fieldManager.hasInvalidFormFields();
   console.log('FormFieldCollection contains invalid items: ' + hasInvalidFormFields);

   // Try to fix invalid form fields
   // Get all invalid form field names
   const invalidFormFields = fieldManager.getInvalidFormFieldNames();

   // Create unique names for invalid fields
   invalidFormFields.forEach((invalidItem) => {
       invalidItem.setFixedName(`${invalidItem.getName()}_${generateUUID()}`);
   });

   // Fix invalid fields
   fieldManager.fixInvalidFormFieldNames(invalidFormFields);
   collection = fieldManager.getFormFieldCollection();
   ```

   **Note:** The `generateUUID()` function is used to create unique identifiers. You can implement it as shown below:

   ```javascript
   function generateUUID() {
       return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
           const r = Math.random() * 16 | 0, v = c === 'x' ? r : (r & 0x3 | 0x8);
           return v.toString(16);
       });
   }
   ```

5. **Create and Set Save Options**

   Initialize the `WordProcessingSaveOptions` with the desired format. Optimize memory usage if necessary, and protect the document from writing with a password.

   ```javascript
   const docFormat = groupdocsEditor.WordProcessingFormats.Docx;
   const saveOptions = new groupdocsEditor.WordProcessingSaveOptions(docFormat);
   saveOptions.setOptimizeMemoryUsage(true);
   const protectionType = groupdocsEditor.WordProcessingProtectionType.AllowOnlyFormFields;
   const protection = new groupdocsEditor.WordProcessingProtection(protectionType, 'write_password');
   saveOptions.setProtection(protection);
   ```

6. **Save the Document**

   Use the `save` method of the `Editor` to save the updated document.

   ```javascript
   const outputFilePath = 'path/to/output/document.docx';
   editor.save(outputFilePath, saveOptions);
   ```

7. **Completion Message**

   Print a confirmation message to indicate the successful completion of the operation.

   ```javascript
   console.log('Fix invalid form fields routine has successfully finished.');
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```javascript
/**
 * This example demonstrates how to fix invalid form fields in a collection and save the document using GroupDocs.Editor for Node.js via Java.
 */

// Import the necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

// Function to generate a unique identifier
function generateUUID() {
    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
        const r = Math.random() * 16 | 0, v = c === 'x' ? r : ((r & 0x3) | 0x8);
        return v.toString(16);
    });
}

(async () => {
    try {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample DOCX with form fields.
        const inputFilePath = 'path/to/your/document.docx';

        // 2. Create a readable stream from this path
        const inputStream = fs.createReadStream(inputFilePath);

        // 3. Create load options for this document
        const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();
        // 3.1. If the input document is password-protected, specify the password for its opening...
        loadOptions.setPassword('some_password_to_open_a_document');
        // 3.2. ...but, because the document is unprotected, this password will be ignored

        // 4. Load the document with options into the Editor instance
        const editor = new groupdocsEditor.Editor(inputStream, loadOptions);

        // 4.1. Get the FormFieldManager instance
        const fieldManager = editor.getFormFieldManager();
        // 4.2. Get the FormFieldCollection in the document
        let collection = fieldManager.getFormFieldCollection();

        // 4.3. Try to auto-fix invalid form fields
        fieldManager.fixInvalidFormFieldNames([]);
        collection = fieldManager.getFormFieldCollection();

        const hasInvalidFormFields = fieldManager.hasInvalidFormFields();
        console.log('FormFieldCollection contains invalid items: ' + hasInvalidFormFields);

        // 4.4. Try to fix invalid form fields
        // 4.4.1. Get all invalid form field names
        const invalidFormFields = fieldManager.getInvalidFormFieldNames();

        // 4.4.2. Create unique names for invalid fields
        invalidFormFields.forEach((invalidItem) => {
            invalidItem.setFixedName(`${invalidItem.getName()}_${generateUUID()}`);
        });

        // 4.4.3. Fix invalid fields
        fieldManager.fixInvalidFormFieldNames(invalidFormFields);
        collection = fieldManager.getFormFieldCollection();

        // 5. Create document save options
        const docFormat = groupdocsEditor.WordProcessingFormats.Docx;
        const saveOptions = new groupdocsEditor.WordProcessingSaveOptions(docFormat);

        // 5.1. If the document is large and causes memory issues, set the memory optimization option
        saveOptions.setOptimizeMemoryUsage(true);

        // 5.2. Protect the document from writing (allow only form fields) with a password
        const protectionType = groupdocsEditor.WordProcessingProtectionType.AllowOnlyFormFields;
        const protection = new groupdocsEditor.WordProcessingProtection(protectionType, 'write_password');
        saveOptions.setProtection(protection);

        // 6. Save the document
        const outputFilePath = 'path/to/output/document.docx';

        // 6.1. Save the document
        editor.save(outputFilePath, saveOptions);

        console.log('Fix invalid form fields routine has successfully finished.');
    } catch (error) {
        console.error('An error occurred:', error);
    }
})();
```

---

**Note:** Make sure to replace `'path/to/your/document.docx'` and `'path/to/output/document.docx'` with the actual file paths in your application.

---

By following this guide, you can effectively fix invalid form fields in Word documents using GroupDocs.Editor for Node.js via Java. This allows you to programmatically identify and correct issues with form fields, ensuring that your documents are correctly formatted and free of duplicate or invalid form fields.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.

---

## Float and paginal modes

Path: /editor/java/float-and-paginal-modes/

## How to enable different document edit modes?
WordProcessing module of [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java), that is responsible for converting all WordProcessing formats to [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instances and backward (from [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) to some of WordProcessing format), contains two modes: *float* and *paginal* (also known as *paged*), where first one — float, is default. These modes are presented by two properties with the same name and type:

```java
public boolean getEnablePagination()
public void setEnablePagination(boolean)
```

At first, such property is present in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions) class and is doubled in the [overload of class constructor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/#WordProcessingEditOptions--), which obtains one boolean parameter of the same name. In this case this option is responsible for selected mode during forward (WordProcessing to [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument)) conversion.

Secondly, such property is present in the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class and is responsible for selected mode during backward ([EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) to WordProcessing) conversion.

Main "rule of thumb" for the end-user is to preserve the same mode during full document roundtrip and do not change it. In other words, if input document was converted to the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) (followed by the HTML emitting from [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance) in the *float* mode, then the resultant [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance (obtained from document, edited on client-side) should be converted back to the WordProcessing format also in the *float* mode (same rule for *paginal* mode too).

Main distinguish of these two modes lies in the form of representation of the input WordProcessing document. By default all WordProcessing formats internally have no pages and page division, they are internally represented as a float smoothness and pageless structure. However, they contain page-related information like headers, footers, page watermarks, page numbering formatting info etc. And when WordProcessing document is opened in some of desktop or browser-based text processor like MS Word, OpenOffice or Google Docs, this text processor dynamically and "on the fly" splits the document onto multiple pages, which are re-calculated every time when user is performing some edits in document content. For example, when user removes the line from the beginning of the huge document, the empty space is "collapsing", and all subsequent content is like "moving upward' to fill the gap, where removed line was located. Same real-time calculations are valid also for situations when content is added, — new inserted content is pushing the existing content to move downward, with creating new pages if necessary.

The problem is the most of used client-side browser-based JavaScript HTML WYSIWYG editors like TinyMCE or CKEditor do not support pages, page separation and described calculations at all. They support only documents with pageless structure. That's why GroupDocs.Editor support two modes:

* In the *float* mode the WordProcessing document in represented in pageless form. Content is not separated on pages, There are no any page-related entities like headers, footers, watermarks and page numbers. This mode is the most suitable for almost all widespread WYSIWYG HTML-editors and that's why this mode is default.
* In the *paginal* mode the WordProcessing document in represented as a set of pages, where content is divided onto pages in the same way as MS Word does. Al page-related entities like headers, footers, watermarks and page numbers are present. This mode should be turned on manually (as it is described above) and is fitting for scenarios where end-user is able to process such content in some appropriate and suitable way, for example, in his own-made HTML editing software.
<!---
### Paginal mode in PDF

Along with family of WordProcessing formats, GroupDocs.Editor support a PDF as one of output (resultant) formats. In other words, input WordProcessing may be opened, edited, but saved not only to the WordProcessing, but also to the PDF. Prior GroupDocs.Editor version 20.3 the *paginal* mode was accessed only for forward and backward WordProcessing conversions, and was not available for PDF. This means that there was no possibility to generate an output PDF in *paged* mode, regardless of [EnablePagination](https://reference.groupdocs.com/editor/java/groupdocs.editor.options/wordprocessingeditoptions/properties/enablepagination) flag in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions) class. In other words, even if input WordProcessing document was converted to [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) in *paginal* mode, the output PDF will be generated in *float* mode.

Starting from GroupDocs.Editor version 20.4 these two conversion mode were added into the PDF processor. Now [PdfSaveOptions](https://reference.groupdocs.com/editor/java/groupdocs.editor.options/pdfsaveoptions) class contains the same property — [EnablePagination](https://reference.groupdocs.com/editor/java/groupdocs.editor.options/pdfsaveoptions/properties/enablepagination) boolean flag, which, like the same in WordProcessing, has `false` default value, which means *float* mode, when `true` value means *paginal* mode. If input WordProcessing document was converted to [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) in *paginal* mode, the output PDF should be generated in *paginal* mode too, with enabled [EnablePagination](https://reference.groupdocs.com/editor/java/groupdocs.editor.options/pdfsaveoptions/properties/enablepagination) flag.
--->

---

## Float and paginal modes

Path: /editor/net/float-and-paginal-modes/


## How to enable different document edit modes?

WordProcessing module of [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net), that is responsible for converting all WordProcessing formats to [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instances and backward (from [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) to some of WordProcessing format), contains two modes: *float* and *paginal* (also known as *paged*), where first one — float, is default. These modes are presented by two properties with the same name and type:

```csharp
public bool EnablePagination {get; set;}
```

At first, such property is present in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class and is doubled in the [overload of class constructor](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions/wordprocessingeditoptions/#constructor), which obtains one boolean parameter of the same name. In this case this option is responsible for selected mode during forward (WordProcessing to [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument)) conversion.

Secondly, such property is present in the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class and is responsible for selected mode during backward ([EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) to WordProcessing) conversion.

Main "rule of thumb" for the end-user is to preserve the same mode during full document roundtrip and do not change it. In other words, if input document was converted to the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) (followed by the HTML emitting from [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance) in the *float* mode, then the resultant [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance (obtained from document, edited on client-side) should be converted back to the WordProcessing format also in the *float* mode (same rule for *paginal* mode too).

Main distinguish of these two modes lies in the form of representation of the input WordProcessing document. By default all WordProcessing formats internally have no pages and page division, they are internally represented as a float smoothness and pageless structure. However, they contain page-related information like headers, footers, page watermarks, page numbering formatting info etc. And when WordProcessing document is opened in some of desktop or browser-based text processor like MS Word, OpenOffice or Google Docs, this text processor dynamically and "on the fly" splits the document onto multiple pages, which are re-calculated every time when user is performing some edits in document content. For example, when user removes the line from the beginning of the huge document, the empty space is "collapsing", and all subsequent content is like "moving upward' to fill the gap, where removed line was located. Same real-time calculations are valid also for situations when content is added, — new inserted content is pushing the existing content to move downward, with creating new pages if necessary.

The problem is the most of used client-side browser-based JavaScript HTML WYSIWYG editors like TinyMCE or CKEditor do not support pages, page separation and described calculations at all. They support only documents with pageless structure. That's why GroupDocs.Editor support two modes:

* In the *float* mode the WordProcessing document in represented in pageless form. Content is not separated on pages, There are no any page-related entities like headers, footers, watermarks and page numbers. This mode is the most suitable for almost all widespread WYSIWYG HTML-editors and that's why this mode is default.
* In the *paginal* mode the WordProcessing document in represented as a set of pages, where content is divided onto pages in the same way as MS Word does. Al page-related entities like headers, footers, watermarks and page numbers are present. This mode should be turned on manually (as it is described above) and is fitting for scenarios where end-user is able to process such content in some appropriate and suitable way, for example, in his own-made HTML editing software.

## Paginal edit mode in PDF

Along with family of WordProcessing formats, GroupDocs.Editor support a PDF as one of output (resultant) formats. In other words, input WordProcessing may be opened, edited, but saved not only to the WordProcessing, but also to the PDF. Prior GroupDocs.Editor version 20.3 the *paginal* mode was accessed only for forward and backward WordProcessing conversions, and was not available for PDF. This means that there was no possibility to generate an output PDF in *paged* mode, regardless of [EnablePagination](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions/enablepagination) flag in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class. In other words, even if input WordProcessing document was converted to [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) in *paginal* mode, the output PDF will be generated in *float* mode.

Starting from GroupDocs.Editor version 20.4 these two conversion mode were added into the PDF processor. Now [PdfSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions) class contains the same property — [EnablePagination](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/enablepagination) boolean flag, which, like the same in WordProcessing, has `false` default value, which means *float* mode, when `true` value means *paginal* mode. If input WordProcessing document was converted to [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) in *paginal* mode, the output PDF should be generated in *paginal* mode too, with enabled [EnablePagination](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/enablepagination) flag.

---

## Float and paginal modes

Path: /editor/nodejs-java/float-and-paginal-modes/


## How to enable different document edit modes?

The WordProcessing module of [**GroupDocs.Editor**](https://products.groupdocs.com/editor/nodejs-java), which converts WordProcessing formats to an [EditableDocument](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/editabledocument) instance (and vice versa), supports two modes: *float* and *paginal* (also known as *paged*). By default, the *float* mode is enabled. These modes are controlled by a property in the `WordProcessingEditOptions` and `WordProcessingSaveOptions` classes:

```javascript
getEnablePagination(): boolean;
setEnablePagination(enable: boolean): void;
```

### Float Mode vs. Paginal Mode

The primary distinction between these two modes lies in how the WordProcessing document is represented:

- **Float mode** (default): The document is presented in a pageless form. Content is continuous, without page breaks, and entities like headers, footers, watermarks, and page numbers are not present. This mode is most compatible with client-side HTML editors like TinyMCE or CKEditor, which do not support page separation or real-time page recalculations.

- **Paginal mode**: The document is divided into pages, similar to how it appears in desktop applications like Microsoft Word. Page-related elements like headers, footers, watermarks, and page numbers are included. This mode must be manually enabled and is best suited for scenarios where the end-user can process page-divided content, such as in custom HTML editing software.

### When to Use Each Mode?

1. **Float mode** is ideal when using HTML editors that cannot handle page structures, allowing for smooth, continuous editing of document content.
2. **Paginal mode** is useful when page-based editing is required, or when you need to preserve the document's original formatting with headers, footers, and page numbers.

### Example

Here’s how to enable paginal mode in **Node.js** during the conversion of a WordProcessing document:

```javascript
const WordProcessingEditOptions = groupdocs.options.WordProcessingEditOptions;

let editOptions = new WordProcessingEditOptions();
editOptions.enablePagination = true;  // Enable paginal mode
```

Similarly, you can enable paginal mode when saving the edited document:

```javascript
const WordProcessingSaveOptions = groupdocs.options.WordProcessingSaveOptions;

let saveOptions = new WordProcessingSaveOptions();
saveOptions.enablePagination = true;  // Ensure paginal mode is preserved during save
```

### Best Practice

When performing a complete roundtrip (editing and saving a document), it is recommended to use the same mode for both conversion to and from the `EditableDocument` format. If you start with *float* mode during the conversion to `EditableDocument`, continue using *float* mode when saving. Similarly, if *paginal* mode is used, it should be maintained throughout the entire process.

---

## Generating slides preview for presentation

Path: /editor/java/generating-slides-preview-for-presentation/

Starting from [version 23.2](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-2-release-notes/), the GroupDocs.Editor for Java allows generating the preview for any slide in the presentation document in SVG format. This feature allows the end-user to view and inspect the content of the presentation without actually sending it for edit. This generated slide preview cannot be edited, but it can be viewed in any desktop or online image viewer as well in the browser (because any modern browser actually supports SVG format).

This feature allows end-users to generate a preview for any slide within the presentation regardless of the licensing mode of the GroupDcos.Editor for Java: it works the same for both trial and licensed mode, there are no trial limitations for this feature. While generating the slides preview, the GroupDocs.Editor doesn’t write off the consumed bytes or credits.

For generating the slides preview the new instance method [`generatePreview(int slideIndex)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/presentationdocumentinfo/#generatePreview-int-) from the struct [`com.groupdocs.editor.metadata.PresentationDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/presentationdocumentinfo/) should be used, and slide is specified by its zero-based _index_ (do not confuse with the slide _numbers_, which are 1-based). If the specified index is lesser than 0 or exceeds the number of slides within a given presentation, then the [IllegalArgumentException](https://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html) exception will be thrown. Slide previews can be generated for both encoded and unencoded presentations; for encoded the end-user must specify a valid password in the [`getDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method.

The [`generatePreview(int slideIndex)`](https://reference.groupdocs.com/editor/java/groupdocs.editor.metadata/presentationdocumentinfo/#generatePreview-int-) method returns a slide preview as an SVG vector image, that is encapsulated in the [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) public class from the [`com.groupdocs.editor.htmlcss.resources.images.vector`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/) namespace. This class has all necessary methods and properties to obtain the content of an SVG image in any desired form, save it to disk and so on.

The code sample below shows opening an unprotected presentation file and generating the previews for every slide. Then these previews are saved to the disk.

```java
// Obtain a valid full path to the presentation file
String inputPath = "Sample.pptx";

// Load file to the Editor constructor
Editor editor = new Editor(inputPath);
{
	// Get document info for this file
	IDocumentInfo infoUncasted = editor.getDocumentInfo(null);

	// Cast this document info to the PresentationDocumentInfo type
	PresentationDocumentInfo infoSlides = (PresentationDocumentInfo)infoUncasted;

	// Get the number of all slides
	int slidesCount = infoSlides.getPageCount();

	//Iterate through all slides and generate the preview on every iteration
	for (int i = 0; i < slidesCount; i++)
	{
		// Generate one preview as SVG image by slide index
		SvgImage oneSvgPreview = infoSlides.generatePreview(i);

		// Save it to the file
		oneSvgPreview.save(new File(outputFolder, oneSvgPreview.getFilenameWithExtension()).getPath());
	}
}
```

Concluding, the new slides preview feature is by its essence a new public method in the existing [`com.groupdocs.editor.metadata.PresentationDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/presentationdocumentinfo/) struct, that obtains a slide index and returns an instance of [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class. If the end-user needs to obtain a preview of the slide in a raster format, but not in the vector, he can use the [`saveToPng`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/#saveToPng-java.io.InputStream-) method in the [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class — this method converts the SVG content of the current [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) to the PNG format and saves it to the specified [`InputStream`](https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html).





---

## Generating slides preview for presentation

Path: /editor/net/generating-slides-preview-for-presentation/

Starting from [version 22.11](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-11-release-notes/), the GroupDocs.Editor for .NET allows generating the preview for any slide in the presentation document in SVG format. This feature allows the end-user to view and inspect the content of the presentation without actually sending it for edit. This generated slide preview cannot be edited, but it can be viewed in any desktop or online image viewer as well in the browser (because any modern browser actually supports SVG format).

This feature allows end-users to generate a preview for any slide within the presentation regardless of the licensing mode of the GroupDocs.Editor for .NET: it works the same for both trial and licensed mode, there are no trial limitations for this feature. While generating the slides preview, the GroupDocs.Editor doesn’t write off the consumed bytes or credits.

For generating the slides preview the new instance method [`GeneratePreview(int slideIndex)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/presentationdocumentinfo/generatepreview/) from the struct [`GroupDocs.Editor.Metadata.PresentationDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/presentationdocumentinfo/) should be used, and slide is specified by its zero-based _index_ (do not confuse with the slide _numbers_, which are 1-based). If the specified index is lesser than 0 or exceeds the number of slides within a given presentation, then the [System.ArgumentOutOfRangeException](https://learn.microsoft.com/en-us/dotnet/api/system.ArgumentOutOfRangeException?view=net-7.0) exception will be thrown. Slide previews can be generated for both encoded and unencoded presentations; for encoded the end-user must specify a valid password in the [`GetDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo/) method.

The [`GeneratePreview(int slideIndex)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/presentationdocumentinfo/generatepreview/) method returns a slide preview as an SVG vector image, that is encapsulated in the [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) public class from the [`GroupDocs.Editor.HtmlCss.Resources.Images.Vector`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/) namespace. This class has all necessary methods and properties to obtain the content of an SVG image in any desired form, save it to disk and so on.

The code sample below shows opening an unprotected presentation file and generating the previews for every slide. Then these previews are saved to the disk.

```csharp
// Obtain a valid full path to the presentation file
string inputPath = "Sample.pptx";

// Load file to the Editor constructor
using (GroupDocs.Editor.Editor editor = new Editor(inputPath))
{
	// Get document info for this file
	IDocumentInfo infoUncasted = editor.GetDocumentInfo(null);

	// Cast this document info to the PresentationDocumentInfo type
	PresentationDocumentInfo infoSlides = (PresentationDocumentInfo)infoUncasted;

	// Get the number of all slides
	int slidesCount = infoSlides.PageCount;

	//Iterate through all slides and generate the preview on every iteration
	for (int i = 0; i < slidesCount; i++)
	{
		// Generate one preview as SVG image by slide index
		SvgImage oneSvgPreview = infoSlides.GeneratePreview(i);

		// Save it to the file
		oneSvgPreview.Save(Path.Combine(outputFolder, oneSvgPreview.FilenameWithExtension));
	}
}
```

Concluding, the new slides preview feature is by its essence a new public method in the existing [`GroupDocs.Editor.Metadata.PresentationDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/presentationdocumentinfo/) struct, that obtains a slide index and returns an instance of [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class. If the end-user needs to obtain a preview of the slide in a raster format, but not in the vector, he can use the [`SaveToPng`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/savetopng/) method in the [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class — this method converts the SVG content of the current [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) to the PNG format and saves it to the specified [`System.IO.Stream`](https://learn.microsoft.com/en-us/dotnet/api/system.IO.Stream?view=net-6.0).





---

## Generating slides preview for presentations

Path: /editor/nodejs-java/generating-slides-preview-for-presentation/



Starting from **[version 24.6](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node.js-via-java-24-6-release-notes/)**, GroupDocs.Editor for Node.js and Java allows generating slide previews from any presentation document in SVG format. This feature enables users to view and inspect the content of a PowerPoint presentation without needing to send it for editing. While the generated slide preview cannot be edited, it can be viewed in any desktop or online image viewer, as well as in modern web browsers that support the SVG format.

This feature works in both trial and licensed modes, with no limitations. Furthermore, generating the slides preview does not consume credits or bytes during its use.

### How to Generate a Slide Preview

To generate a slide preview in GroupDocs.Editor for Node.js or Java, you can use the `generatePreview(slideIndex)` method of the `PresentationDocumentInfo` class. The slide to preview is specified by its zero-based index (not to be confused with one-based slide numbers). If the index is out of bounds (less than 0 or greater than the number of slides), an `IllegalArgumentException` will be thrown.

Slide previews can be generated for both encoded and unencoded presentations. For encoded presentations, a valid password must be specified in the `getDocumentInfo()` method.

The `generatePreview(slideIndex)` method returns a slide preview as an SVG image, encapsulated in the `SvgImage` class. This class provides methods to save the SVG content to disk, stream it, and more.

### Example Code for Node.js

Here’s an example showing how to load a PowerPoint presentation in Node.js, generate previews for each slide, and save the SVG images to disk:

```javascript
const groupdocs = require('groupdocs-editor');
const Editor = groupdocs.Editor;
const PresentationLoadOptions = groupdocs.options.PresentationLoadOptions;
const SvgImage = groupdocs.resources.SvgImage;

// Path to the presentation file
const inputPath = "Sample.pptx";

// Load the presentation into the Editor
const editor = new Editor(inputPath);

// Get document info for this presentation
const documentInfo = editor.getDocumentInfo();

// Cast the document info to PresentationDocumentInfo
const presentationInfo = documentInfo.asPresentationDocumentInfo();

// Get the number of slides in the presentation
const slideCount = presentationInfo.getPageCount();

// Loop through all slides and generate SVG previews
for (let i = 0; i < slideCount; i++) {
    // Generate the slide preview as an SVG image
    const svgPreview = presentationInfo.generatePreview(i);

    // Save the SVG image to a file
    svgPreview.save(`output/slide_${i}.svg`);
}
```

### Example Code for Java

The following Java example shows how to generate previews for all slides in a PowerPoint presentation and save them as SVG images:

```java
// Obtain a valid full path to the presentation file
String inputPath = "Sample.pptx";

// Load the file into the Editor constructor
Editor editor = new Editor(inputPath);

// Get document info for this file
IDocumentInfo infoUncasted = editor.getDocumentInfo(null);

// Cast the document info to the PresentationDocumentInfo type
PresentationDocumentInfo infoSlides = (PresentationDocumentInfo) infoUncasted;

// Get the number of all slides
int slidesCount = infoSlides.getPageCount();

// Iterate through all slides and generate the preview for each slide
for (int i = 0; i < slidesCount; i++) {
    // Generate one preview as an SVG image
    SvgImage oneSvgPreview = infoSlides.generatePreview(i);

    // Save the preview to a file
    oneSvgPreview.save(new File(outputFolder, oneSvgPreview.getFilenameWithExtension()).getPath());
}
```

### Concluding

The slides preview feature is a convenient method for generating non-editable SVG previews of slides from PowerPoint presentations. The `generatePreview(slideIndex)` method in the `PresentationDocumentInfo` class allows you to obtain a slide’s preview in vector format, encapsulated in the `SvgImage` class. 

If you prefer a raster format instead of vector, the `saveToPng()` method in the `SvgImage` class can be used to convert the SVG content to PNG format and save it to a specified `InputStream` or file.


---

## Get comparison result as an object model

Path: /comparison/net/how-to-get-result-document-object/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to get result document object model after comparison.

To get result document object, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare) method and assign its return value to a [Document](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/document/) object.

You can retrieve the name, password, changes, stream and other document information using [Document](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/document/) object. Also, our object model is fully compatible with the object models of Aspose libraries.

The following code snippets show how to get changes and create new Aspose Word document using result document object model:

## Obtain the result document object and get changes

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
      comparer.Add("target.docx");
      GroupDocs.Comparison.Document resultDocument = comparer.Compare("result.docx");
      foreach (var change in resultDocument.Changes)
      {
          Console.ForegroundColor = ConsoleColor.Green;
          Console.Write("Source test: ");
          Console.ForegroundColor = ConsoleColor.White;
          Console.WriteLine(change.SourceText);

          Console.ForegroundColor = ConsoleColor.Blue;
          Console.Write("Target test: ");
          Console.ForegroundColor = ConsoleColor.White;
          Console.WriteLine(change.TargetText + "\n");
      }
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/how-to-get-result-document-object.png)

## Create a new Word document based on the result document and modify its contents

You can use the Comparison [Document](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/document/) object to generate Aspose documents and perform modifications seamlessly. The resultDocument.Stream will contain an Aspose document object corresponding to the format being compared.

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using Aspose.Words;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
      // Add target document and save comparison result to Comparison.Document object
      comparer.Add("target.docx");
      GroupDocs.Comparison.Document resultDocument = comparer.Compare("result.docx");

      // Create a new Aspose Document object of corresponding format.
      Aspose.Words.Document asposeDocument = new Aspose.Words.Document(resultDocument.Stream);

      // Access the Document's builder to add content.
      DocumentBuilder builder = new DocumentBuilder(asposeDocument);

      // Add some text to the document.
      builder.Writeln("Hello, World!");
      builder.Write("This is an example of using Aspose.Words.");

      // Save the document to a file.
      asposeDocument.Save("output.docx");
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/modify-result-document-using-aspose.png)


---

## Get comparison result as an object model

Path: /comparison/python-net/get-result-document-object/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) allows you to obtain the **result document object model** after comparing files.

To get the result document object, follow these steps:

1.  Instantiate the `Comparer` object. Provide the source document path
    or stream.\
2.  Call the `add()` method and provide the target document path or
    stream.\
3.  Call the `compare()` method and assign its return value to a
    `Document` object.

With the `Document` object, you can access the file name, detected changes, stream, and other information. The object model is fully compatible with Aspose libraries, so you can also use it for advanced
processing.

## Example: Obtain the result document object and get changes

``` python
import groupdocs.comparison as gc

source_path = "source.docx"
target_path = "target.docx"
result_path = "result.docx"

# Initialize comparer with the source document
with gc.Comparer(source_path) as comparer:
    # Add target document
    comparer.add(target_path)

    # Perform comparison and get the result Document object
    result_document = comparer.compare(result_path)

    # Iterate through detected changes
    for change in result_document.changes:
        print("\033[92mSource text:\033[0m", change.source_text)  # green
        print("\033[94mTarget text:\033[0m", change.target_text, "\n")  # blue

```

The result will list source and target text segments for each detected
change.


---

## Get default ConvertOptions for specific target format

Path: /conversion/java/get-default-convertoptions-for-specific-target-format/



When dealing with file format conversions, certain formats have intricate conversion settings that might be complex or time-consuming to configure manually. [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java) provides default [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) for different target formats, enabling developers to get up and running quickly without needing to manually configure all conversion settings.

This article covers the reasons for retrieving default [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/), outlines specific use cases, and provides examples from real-world scenarios.

## Why Retrieve Default ConvertOptions?

### 1. Pre-configured Defaults for Complex Conversions
Certain formats, such as PDFs or CAD drawings, have multiple settings that need to be adjusted for successful conversions (e.g., page number, page size, margin, DPI settings). Using default [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) simplifies the process by setting these values to format-appropriate defaults. This reduces the overhead of manual configuration, allowing you to focus on core logic rather than conversion parameters.

### 2. Reduced Risk of Errors
Conversion parameters can vary significantly between formats. Manually specifying incorrect or incompatible settings can result in conversion errors or poor output quality. Using default options provided by [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) ensures that all required fields are properly populated for the target format, minimizing the risk of configuration-related failures.

### 3. A Baseline for Customization
Default [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) provide a starting point that you can further customize based on your specific needs. After retrieving the defaults, developers can tweak properties such as DPI, output quality, security settings, or watermark inclusion.

## Code Examples

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) allows to get default convert options for specific target format by following the below steps:

1.   Create new instance of [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class by passing source document path as constructor's parameter
2.   Call [getPossibleConversions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#getPossibleConversions--) method of converter object
3.   Use the file extension or `FileType` as key to indexer of object received as value in previous step  

### Example 1: Retrieving Default ConvertOptions for PDF Conversion

```java
// Load the source document
Converter converter = new Converter("source.docx");

// Retrieve posible conversions
PossibleConversions conversions = converter.getPossibleConversions();
// Retrieve target conversions for PDF format
TargetConversion targetConversion = conversions.getTargetConversion("pdf");
// Retrieve default convert options for PDF format
ConvertOptions convertOptions = targetConversion.getConvertOptions();
if (convertOptions != null)
{
    converter.convert("converted.pdf", convertOptions);
}

```

### Example 2: Batch Conversion of Files with Default ConvertOptions

```java

// List of files to convert
String[] files = new String[] {"file1.docx", "file2.xlsx", "file3.pptx"};

for (String filePath : files) {
    Converter converter = new Converter(filePath);

    // Retrieve posible conversions
    PossibleConversions conversions = converter.getPossibleConversions();
    // Retrieve target conversions for PDF format
    TargetConversion targetConversion = conversions.getTargetConversion("pdf");
    // Retrieve default convert options for PDF format
    ConvertOptions convertOptions = targetConversion.getConvertOptions();
    if (convertOptions != null)
    {
        // Perform conversion
        converter.convert(filePath.replace(".docx", ".pdf"), convertOptions);
    }
}
System.out.println("Batch conversion completed.");
```

## Conclusion
Retrieving default [ConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/) in [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java) ensures consistency, efficiency, and flexibility in handling file conversions across various formats. These options minimize errors, allow for quick configurations, and provide a strong foundation for further customizations based on specific needs. Whether in batch processing, dynamic web applications, or automated pipelines, leveraging these default settings streamlines the conversion process while maintaining high-quality results.
---

## Get default ConvertOptions for specific target format

Path: /conversion/net/get-default-convertoptions-for-specific-target-format/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) allows to get default convert options for specific target format by following the below steps:

1.   Create new instance of [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class by passing source document path as constructor's parameter
2.   Call [GetPossibleConversions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/getpossibleconversions) method of converter object
3.   Use the file extension or `FileType` as key to indexer of object received as value in previous step  

The following code snippet shows how to get possible conversions of the source document:

```csharp
using (var converter = new Converter("source.docx"))
{
    var possibleConversions = converter.GetPossibleConversions();
    var targetConversion = possibleConversions["pdf"];
    var convertOptions = targetConversion?.ConvertOptions;
    if (convertOptions != null)
    {
        converter.Convert("converted.pdf", convertOptions);
    }
}
```

---

## Get text coordinates

Path: /viewer/java/image-viewer-get-text-coordinates/

Use the [setExtractText()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions/#setExtractText-boolean-) method of the [ViewInfoOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions/) class to get the text contained in a source document and its coordinates. Then you can use this data to add a selectable text over the image or to implement a text search in image-based rendering.

The following code snippet shows how to retrieve and print out text ([lines](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/page/#getLines--)/[words](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/line/#getWords--)/[characters](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/word/#getCharacters--)) on each document [page](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/page/) with coordinates:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.Character;
import com.groupdocs.viewer.results.Line;
import com.groupdocs.viewer.results.Page;
import com.groupdocs.viewer.results.ViewInfo;
import com.groupdocs.viewer.results.Word;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.forPngView(true);
    ViewInfo viewInfo = viewer.getViewInfo(viewInfoOptions);

    for (Page page : viewInfo.getPages()) {
        System.out.println("Page: " + page.getNumber());
        System.out.println("Text lines/words/characters:");

        for (Line line : page.getLines()) {
            System.out.println(line);
            for (Word word : line.getWords()) {
                System.out.println("\t" + word);
                for (Character character : word.getCharacters()) {
                    System.out.println("\t\t" + character);
                }
            }
        }
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/java/images/image-viewer-get-text-coordinates.png)
---

## Get text coordinates

Path: /viewer/net/image-viewer-get-text-coordinates/

Use the [ExtractText](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewinfooptions/properties/extracttext) property of the [ViewInfoOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewinfooptions) class to get the text contained in a source document and its coordinates. Then you can use this data to add a selectable text over the image or to implement a text search in image-based rendering.

The following code snippet shows how to retrieve and print out text ([lines](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.results/page/properties/lines)/[words](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.results/line/properties/words)/[characters](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.results/word/properties/characters)) on each document [page](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.results/page) with coordinates:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Get the file information and extract it text.
    bool extractText = true;
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForPngView(extractText);
    ViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions);

    // Display the file information and text.
    foreach (Page page in viewInfo.Pages)
    {
        Console.WriteLine($"Page: {page.Number}");
        Console.WriteLine("Text lines/words/characters:");

        foreach (Line line in page.Lines)
        {
            Console.WriteLine(line);
            foreach (Word word in line.Words)
            {
                Console.WriteLine($"\t{word}");
                foreach (Character character in word.Characters)
                {
                    Console.WriteLine($"\t\t{character}");
                }
            }
        }
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Get the file information and extract it text.
            Dim extractText As Boolean = True
            Dim viewInfoOptions As ViewInfoOptions = ViewInfoOptions.ForPngView(extractText)
            Dim viewInfo As ViewInfo = viewer.GetViewInfo(viewInfoOptions)
        
            ' Display the file information and text.
            For Each page As Page In viewInfo.Pages
                Console.WriteLine($"Page: {page.Number}")
                Console.WriteLine("Text lines/words/characters:")
        
                For Each line As Line In page.Lines
                    Console.WriteLine(line)
                    For Each word As Word In line.Words
                        Console.WriteLine($"	{word}")
                        For Each character As Character In word.Characters
                            Console.WriteLine($"		{character}")
                        Next
                    Next
                Next
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/image-viewer-get-text-coordinates.png)
---

## Get the document content information

Path: /annotation/net/document-text-info/


GroupDocs v21.3 and later allows you to get information not only about the width and height of any page but also about page number and text content. To do this, use the [PageInfo](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/pageinfo) structure by calling the [GetDocumentInfo()](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/document/methods/getdocumentinfo) method of the [Document](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/document) class.

The [PageInfo](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/pageinfo) structure represents each page and contains the list of [TextLineinfo](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/textlineinfo). Every [TextLineinfo](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/textlineinfo) stores text top and left indents, width, height and the text itself. This way, each page is represented as a sequence of text lines. Every text line is described by its parameters (width, height, and indents).

The following code snippet shows how to get data from described structures:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.docx"))
{
    IDocumentInfo documentInfo = annotator.Document.GetDocumentInfo();

    foreach (PageInfo page in documentInfo.PagesInfo)
    {
        //Here you can access PageInfo fields
        Console.WriteLine("Page number {0}, width: {1} and height: {2}", page.PageNumber, page.Width, page.Height);

        foreach (TextLineInfo textLine in page.TextLines)
        {
            //Here you can access TextLineInfo fields
            Console.WriteLine("\tText line. '{0}'", textLine.Text);
            Console.WriteLine("\t\tText width {0} and height {1}. Top indent: {2}, left indent: {3}", 
                textLine.Width, textLine.Height, textLine.TopIndent, textLine.LeftIndent);
        }
    }
}
```
{{< /tab >}}
{{< /tabs >}}

### Supported formats

The GroupDocs.Annotation allows you to retrieve text information from files of the following formats: Word, PDF, Excel files, Visio diagrams, PowerPoint presentations, HTML, and email. You can retrieve text directly from files of all specified formats except of HTML (.htm, .html, etc.) and email (.eml, .msg, etc.). To retrieve text from HTML and email files, GroupDocs.Annotation converts them to .docx.

### Description of text parameters

Example below shows how these parameters are calculated:

 ![Example of how text parameters are calculated](/annotation/net/images/highlighted-text.png)


The possible text rectangles are marked in black. The arrows indicate corresponding text parameters. 
---

## Handle loading of external resources documents

Path: /parser/net/handle-loading-of-external-resources/

GroupDocs.Parser provides the functionality to handle loading of HTML external resources.

Here are the steps to handle loading of HTML external resources.

*   Instantiate the [ParserSettings](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/parsersettings) object and pass External Resource Handler;
*   Create [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object and call [GetImages](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/getimages/) method.

The following code sample shows how to handle loading of HTML external resources.

```csharp
// Create an instance of ParserSettings to pass External Resource Handler
ParserSettings settings = new ParserSettings(new Handler());

// Create an instance of Parser class to generate spreadsheet page previews
using (Parser parser = new Parser(Constants.SampleHtmlWithImages, settings))
{
    // Extract images from HTML document
    IEnumerable<PageImageArea> images = parser.GetImages();

    // Iterate over extracted images
    foreach (PageImageArea i in images)
    {
        // Print the type of image
        Console.WriteLine(i.FileType);
    }
}

/// <summary>
/// This class provides the ability to filter extracted images.
/// </summary>
private class Handler : ExternalResourceHandler
{
    /// <summary>
    /// Called before any external resource loads. It allows to skip unnesesary file loading.
    /// </summary>
    public override void OnLoading(ExternalResourceLoadingArgs args)
    {
        // Check if the file name ends with installation.png
        if (!args.Uri.EndsWith("installation.png"))
        {
            // Otherwise skip this file
            args.Skipped = true;
        }

        base.OnLoading(args);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Handling the APEv2 tag

Path: /metadata/java/handling-the-apev2-tag/

## What is APEv2?

The APE tag is a standard used to add metadata, such as the title, artist, or track number, to digital audio files. The APEv1 tag was designed for the Monkey's Audio format. In MP3 files, the APE tag was originally stored at the very end of the file, with no inline declaration in the body of the file. But later the standard was extended to add a header, allowing APE tags to be at the beginning of files and allowing metadata values to be Unicode rather than simply ASCII. The improved standard is called APEv2. 

{{< alert style="info" >}}Please find more information at https://en.wikipedia.org/wiki/APE_tag{{< /alert >}}

## Reading an APEv2 tag

The GroupDocs.Metadata API allows reading the APEv2 tag in an MP3 audio.

The following steps show how to read the APEv2 tag in an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the APEv2 tag by using the [MP3RootPackage.getApeV2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getApeV2())method
4.  If the APEv2 tag is not null then check for all of its metadata properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3ReadApeTag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithApe)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();

	if (root.getApeV2() != null) {
		System.out.println(root.getApeV2().getAlbum());
		System.out.println(root.getApeV2().getTitle());
		System.out.println(root.getApeV2().getArtist());
		System.out.println(root.getApeV2().getComposer());
		System.out.println(root.getApeV2().getCopyright());
		System.out.println(root.getApeV2().getGenre());
		System.out.println(root.getApeV2().getLanguage());

		// ...
	}
}
```

## Removing an APEv2 tag

The GroupDocs.Metadata API supports removing the APEv2 tag from an MP3 audio.

The following are the steps to remove the APEv2 tag from an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Get the root metadata package
3.  Remove the tag by calling the [removeApeV2](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#removeApeV2()) method
4.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3RemoveApeTag**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithApe)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();
	root.removeApeV2();
	metadata.save(Constants.OutputMp3);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Handling the APEv2 tag

Path: /metadata/net/handling-the-apev2-tag/

## What is APEv2?

The APE tag is a standard used to add metadata, such as the title, artist, or track number, to digital audio files. The APEv1 tag was designed for the Monkey's Audio format. In MP3 files, the APE tag was originally stored at the very end of the file, with no inline declaration in the body of the file. But later the standard was extended to add a header, allowing APE tags to be at the beginning of files and allowing metadata values to be Unicode rather than simply ASCII. The improved standard is called APEv2. 

{{< alert style="info" >}}Please find more information at https://en.wikipedia.org/wiki/APE_tag{{< /alert >}}

## Reading an APEv2 tag

The GroupDocs.Metadata API allows reading the APEv2 tag in an MP3 audio.

The following steps show how to read the APEv2 tag in an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Extract the root metadata package
3.  Get the APEv2 tag by using the [MP3RootPackage.ApeV2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/apev2)property
4.  If the APEv2 tag is not null then check for all of its properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3ReadApeTag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithApe))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();

	if (root.ApeV2 != null)
	{
		Console.WriteLine(root.ApeV2.Album);
		Console.WriteLine(root.ApeV2.Title);
		Console.WriteLine(root.ApeV2.Artist);
		Console.WriteLine(root.ApeV2.Composer);
		Console.WriteLine(root.ApeV2.Copyright);
		Console.WriteLine(root.ApeV2.Genre);
		Console.WriteLine(root.ApeV2.Language);

		// ...
	}
}
```

## Removing an APEv2 tag

The GroupDocs.Metadata API supports removing the APEv2 tag from an MP3 audio.

The following are the steps to remove the APEv2 tag from an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Get the root metadata package
3.  Remove the tag by calling the [RemoveApeV2](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/methods/removeapev2) method
4.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3RemoveApeTag**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithApe))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();

	root.RemoveApeV2();

	metadata.Save(Constants.OutputMp3);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## How to install Asian Fonts on Ubuntu

Path: /viewer/java/how-to-install-asian-fonts-on-ubuntu/

This page describes the installation of the Asian Fonts on [Ubuntu 20.04 LTS](https://wiki.ubuntu.com/Releases) using the [apt-get](https://wiki.debian.org/apt-get) utility. On the previous versions of Ubuntu, the process is quite the same.

To install Asian Fonts on Ubuntu, follow these steps:

1. Browse to [packages.ubuntu.com](https://packages.ubuntu.com/).

2. At [packages.ubuntu.com/focal/translations/](https://packages.ubuntu.com/focal/translations/), search for the Japanese language support packages. Find all entries starting with "language-pack-" and containing "Japanese" as follows:

![](/viewer/java/images/how-to-install-asian-fonts-on-ubuntu.png)

3. Install the [language-pack-ja](https://packages.ubuntu.com/focal/translations/language-pack-ja) package. The language-pack-ja-base package is installed automatically as first one depends on it.

4. Run Ubuntu in a Docker container:

![](/viewer/java/images/how-to-install-asian-fonts-on-ubuntu_1.png)

5. Execute the following command to update the packages list with updates and new packages:

{{< tabs "example1">}}
{{< tab "Shell" >}}
```sh
apt-get update
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/java/images/how-to-install-asian-fonts-on-ubuntu_2.png)

6. Excecute the following command to install the Japanese language support:

{{< tabs "example2">}}
{{< tab "Shell" >}}
```sh
apt-get install -y language-pack-ja
```
{{< /tab >}}
{{< /tabs >}}

![](/viewer/java/images/how-to-install-asian-fonts-on-ubuntu_3.png)

7. Wait for the message "Generation complete."

![](/viewer/java/images/how-to-install-asian-fonts-on-ubuntu_4.png)

To install other Asian languages, use the following commands:

{{< tabs "example3">}}
{{< tab "Shell" >}}
```sh
apt-get install -y language-pack-zh*
apt-get install -y language-pack-ko
```
{{< /tab >}}
{{< /tabs >}}
---

## How to merge GIF images using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-gif-images-using-csharp/


## GIF Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple GIF documents in the preferred order and save them as a single file.

## About GIF File Format

GIF, Graphics Interchange Format, is a raster file format designed for relatively basic images that appear mainly on the internet. Each file can support up to 8 bits per pixel and can contain 256 indexed colors. GIF files also allow images or frames to be combined, creating basic animations.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### Source GIF images

!["Sample1.gif"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.gif"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.gif"](/merger/net/images/jpg/sample3.jpg)

### How to merge GIF files in horizontal mode

The following example demonstrates how to merge image files in horizontal mode with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinmode) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```csharp
// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.gif"))
{
    // Define image join options with horizontal join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
    // Add another image file to merge
    merger.Join(@"c:\sample2.gif", joinOptions);
    // Add next image file to merge
    merger.Join(@"c:\sample3.gif", joinOptions);
    // Merge image files and save result
    merger.Save(@"c:\merged.gif");
}
```

### Result merged GIF image

!["Merged.png"](/merger/net/images/jpg/merged_horizontal.jpg)

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge GIF Live Demo

GroupDocs.Merger for .NET provides an online [**GIF Merger App**](https://products.groupdocs.app/merger/gif), which allows you to try it for free and check its quality and accuracy.
---

## How to merge GIF images using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-gif-images-using-java/


## GIF Merger Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple GIF documents in the preferred order and save them as a single file.

## About GIF File Format

GIF, Graphics Interchange Format, is a raster file format designed for relatively basic images that appear mainly on the internet. Each file can support up to 8 bits per pixel and can contain 256 indexed colors. GIF files also allow images or frames to be combined, creating basic animations.

### Download and Configure

You can follow the steps below to reference GroupDocs.Merger for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/merger/java):

1. Unpack zip archive .
2. Switch to **lib** folder.
3. Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4. After this you should add the merger **dependency** block to your *pom.xm*l project file.

### Source GIF images

!["Sample1.gif"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.gif"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.gif"](/merger/java/images/jpg/sample3.jpg)

### How to merge GIF files in horizontal mode

The following example demonstrates how to merge image files in horizontal mode with several lines of java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinoptions/) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinmode/) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinoptions/) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [Save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged image file as parameter.

```java
// Load the source image file
Merger merger = new Merger("c:\sample1.gif")

// Define image join options with horizontal join mode
ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
// Add another image file to merge
merger.join("c:\sample2.gif", joinOptions);
// Add next image file to merge
merger.join("c:\sample3.gif", joinOptions);
// Merge image files and save result
merger.save("c:\merged.gif");

```

### Result merged GIF image

!["Merged.png"](/merger/java/images/jpg/merged_horizontal.jpg)

### Code Examples

Please find more [use-cases and complete java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge GIF Live Demo

GroupDocs.Merger for Java provides an online [**GIF Merger App**](https://products.groupdocs.app/merger/gif), which allows you to try it for free and check its quality and accuracy.
---

## How to migrate to GroupDocs.Viewer 19.8 or higher

Path: /viewer/net/how-to-migrate-to-groupdocs-viewer-19-8-or-higher/

This page describes migration to the 19.8 version or later from the previous one.

## Why to migrate

The main reasons to use the 19.8 version or later are as follows:
* The Viewer class is a single entry point to manage the document rendering process to any supported file format instead of the ViewerHtmlHander/ViewerImageHander classes from previous versions.
* The rendering speed improved significantly by saving the rendered page as it is rendered, not when all pages are rendered.
* Product architecture is redesigned from scratch to decrease memory usage from 10% to 400% depending on the document type.
* Document rendering options are simplified, so you can easily instantiate the proper option class and control document rendering and saving processes.

## How to migrate

Here is a brief comparison of how to display a document in HTML form using old and new versions.  

The following code snippet shows the old coding style:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Get Configurations
ViewerConfig config = Utilities.GetConfigurations();

// Create html handler
ViewerHtmlHandler htmlHandler = new ViewerHtmlHandler(config);

// Guid implies that unique document name 
string guid = "sample.docx";

//Instantiate the HtmlOptions object
HtmlOptions options = new HtmlOptions();

//to get html representations of pages with embedded resources
options.IsResourcesEmbedded = true;

// Set password if document is password protected. 
if(!String.IsNullOrEmpty(DocumentPassword))
   options.Password = DocumentPassword;
            
//Get document pages in html form
List<PageHtml> pages = htmlHandler.GetPages(guid, options);

foreach (PageHtml page in pages)
{
    //Save each page at disk
    Utilities.SaveAsHtml(page.PageNumber + "_" + DocumentName, page.HtmlContent);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
'Get Configurations
Dim config As ViewerConfig = Utilities.GetConfigurations()

' Create html handler
Dim htmlHandler As ViewerHtmlHandler = New ViewerHtmlHandler(config)

' Guid implies that unique document name 
Dim guid As String = "sample.docx"

'Instantiate the HtmlOptions object
Dim options As HtmlOptions = New HtmlOptions()

'to get html representations of pages with embedded resources
options.IsResourcesEmbedded = True

' Set password if document is password protected. 
If Not [String].IsNullOrEmpty(DocumentPassword) Then options.Password = DocumentPassword

'Get document pages in html form
Dim pages As List(Of PageHtml) = htmlHandler.GetPages(guid, options)

For Each page As PageHtml In pages
    'Save each page at disk
    Utilities.SaveAsHtml(page.PageNumber.ToString() & "_" + DocumentName, page.HtmlContent)
Next
```
{{< /tab >}}
{{< /tabs >}}

The following code snippet shows the new coding style:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
   HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources();
   viewer.View(options);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...
Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            Dim options As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(options)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## How to search signatures with predicate functions

Path: /signature/net/search-signatures-with-predicate-functions/


# Search with Predicate Functions

## Overview

The GroupDocs.Signature library provides enhanced `Search` methods that accept predicate functions (`Func<BaseSignature, bool>`) to filter signatures based on custom criteria. This allows you to perform more flexible and targeted signature searches by applying custom filtering logic to the search results.

## Benefits

- **Flexible Filtering**: Filter signatures based on any custom criteria using lambda expressions
- **Type-Safe**: Strongly typed predicates ensure compile-time safety
- **Easy to Use**: Simple lambda expressions make filtering intuitive
- **Comprehensive Results**: Search across all signature types or specific types, then filter as needed

## Available Methods

1. `Search(List<SearchOptions> searchOptionsList, Func<BaseSignature, bool> predicate)`
2. `Search(Func<BaseSignature, bool> predicate)`

## Method Signatures

```csharp
public SearchResult Search(List<SearchOptions> searchOptionsList, Func<BaseSignature, bool> predicate)
public List<BaseSignature> Search(Func<BaseSignature, bool> predicate)
```

## How It Works

The `Search` methods with predicates:

1. **Search First**: All signatures matching the search options are found (or all signatures if no options provided)
2. **Filter Results**: The predicate is applied to filter the search results
3. **Return Filtered Results**: Only signatures matching the predicate are returned

## Examples

### Example 1: Search and Filter by Text Content

```csharp
using GroupDocs.Signature;
using GroupDocs.Signature.Options;
using GroupDocs.Signature.Domain;

using (Signature signature = new Signature("document.pdf"))
{
    // Search for text signatures
    List<SearchOptions> searchOptions = new List<SearchOptions>
    {
        new TextSearchOptions()
    };
    
    // Filter to only signatures containing "Approved"
    SearchResult result = signature.Search(searchOptions, 
        sig => sig is TextSignature textSig && textSig.Text.Contains("Approved"));
    
    foreach (BaseSignature sig in result.Signatures)
    {
        Console.WriteLine($"Found: {((TextSignature)sig).Text}");
    }
}
```

### Example 2: Search All Signature Types with Filtering

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    // Search all signature types and filter by type
    List<BaseSignature> result = signature.Search(
        sig => sig.SignatureType == SignatureType.Digital);
    
    Console.WriteLine($"Found {result.Count} digital signatures");
}
```

### Example 3: Search and Filter by Multiple Criteria

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    List<SearchOptions> searchOptions = new List<SearchOptions>
    {
        new TextSearchOptions(),
        new BarcodeSearchOptions()
    };
    
    // Filter signatures by page and type
    SearchResult result = signature.Search(searchOptions, sig =>
        sig.PageNumber == 1 && 
        (sig.SignatureType == SignatureType.Text || sig.SignatureType == SignatureType.Barcode));
    
    Console.WriteLine($"Found {result.Signatures.Count} signatures on page 1");
}
```

### Example 4: Search Signatures by Date Range

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    DateTime startDate = new DateTime(2024, 1, 1);
    DateTime endDate = new DateTime(2024, 12, 31);
    
    // Search and filter by signature date
    List<BaseSignature> result = signature.Search(sig =>
        sig.SignDate.HasValue &&
        sig.SignDate.Value >= startDate &&
        sig.SignDate.Value <= endDate);
    
    Console.WriteLine($"Found {result.Count} signatures in 2024");
}
```

### Example 5: Search and Filter by Signature Size

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    List<SearchOptions> searchOptions = new List<SearchOptions>
    {
        new ImageSearchOptions()
    };
    
    // Filter image signatures by size
    SearchResult result = signature.Search(searchOptions, sig =>
    {
        if (sig is ImageSignature imgSig)
        {
            return imgSig.Width > 200 && imgSig.Height > 200;
        }
        return false;
    });
    
    Console.WriteLine($"Found {result.Signatures.Count} large image signatures");
}
```

### Example 6: Find Signatures in Specific Region

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    // Define a region (rectangle)
    int regionLeft = 100;
    int regionTop = 100;
    int regionWidth = 200;
    int regionHeight = 200;
    
    List<BaseSignature> result = signature.Search(sig =>
        sig.Left >= regionLeft &&
        sig.Top >= regionTop &&
        sig.Left + sig.Width <= regionLeft + regionWidth &&
        sig.Top + sig.Height <= regionTop + regionHeight);
    
    Console.WriteLine($"Found {result.Count} signatures in the specified region");
}
```

### Example 7: Search Signatures with Specific Properties

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    List<SearchOptions> searchOptions = new List<SearchOptions>
    {
        new QRCodeSearchOptions()
    };
    
    // Search for QR codes with specific data
    SearchResult result = signature.Search(searchOptions, sig =>
    {
        if (sig is QrCodeSignature qrSig)
        {
            return qrSig.Text.StartsWith("https://") ||
                   qrSig.Text.Contains("contract-id:");
        }
        return false;
    });
    
    foreach (QrCodeSignature qrSig in result.ToList<QrCodeSignature>())
    {
        Console.WriteLine($"QR Code: {qrSig.Text}");
    }
}
```

### Example 8: Search by Signature Type and Page

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    // Search all signatures and filter by type and page
    List<BaseSignature> result = signature.Search(sig =>
        sig.SignatureType == SignatureType.Text &&
        sig.PageNumber == 1);
    
    Console.WriteLine($"Found {result.Count} text signatures on page 1");
}
```

## Common Use Cases

### 1. Find Signatures by Author

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    DigitalSearchOptions searchOptions = new DigitalSearchOptions();
    
    List<BaseSignature> result = signature.Search(
        new List<SearchOptions> { searchOptions }, 
        sig => sig is DigitalSignature digitalSig && 
               digitalSig.SignerName == "John Doe");
    
    Console.WriteLine($"Found {result.Count} signatures by John Doe");
}
```

### 2. Search Signatures by Barcode Value

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    BarcodeSearchOptions searchOptions = new BarcodeSearchOptions();
    
    SearchResult result = signature.Search(
        new List<SearchOptions> { searchOptions },
        sig => sig is BarcodeSignature barcodeSig &&
               barcodeSig.Text.StartsWith("PROD-"));
    
    foreach (BarcodeSignature barcodeSig in result.ToList<BarcodeSignature>())
    {
        Console.WriteLine($"Product Barcode: {barcodeSig.Text}");
    }
}
```

### 3. Find Signatures by Position and Size

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    // Find signatures in bottom-right corner that are large
    List<BaseSignature> result = signature.Search(sig =>
        sig.Left > 400 &&
        sig.Top > 600 &&
        sig.Width > 150 &&
        sig.Height > 50);
    
    Console.WriteLine($"Found {result.Count} large signatures in bottom-right");
}
```

### 4. Search Multiple Signature Types with Complex Filtering

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    List<SearchOptions> searchOptions = new List<SearchOptions>
    {
        new TextSearchOptions(),
        new ImageSearchOptions(),
        new QRCodeSearchOptions()
    };
    
    // Find signatures that are either text with specific content, 
    // or QR codes with URLs, or large images
    SearchResult result = signature.Search(searchOptions, sig =>
    {
        if (sig is TextSignature textSig)
        {
            return textSig.Text.Contains("APPROVED");
        }
        if (sig is QrCodeSignature qrSig)
        {
            return qrSig.Text.StartsWith("http");
        }
        if (sig is ImageSignature imgSig)
        {
            return imgSig.Width > 300 && imgSig.Height > 300;
        }
        return false;
    });
    
    Console.WriteLine($"Found {result.Signatures.Count} matching signatures");
}
```

## Best Practices

### 1. Use Specific Predicates

**Good:**
```csharp
// Specific and clear predicate
SearchResult result = signature.Search(searchOptions, 
    sig => sig is TextSignature textSig && textSig.Text == "Approved");
```

**Avoid:**
```csharp
// Too generic, might match unintended signatures
List<BaseSignature> result = signature.Search(sig => true);
```

### 2. Handle Null Checks

```csharp
// Safe predicate with null checks
SearchResult result = signature.Search(searchOptions, sig =>
{
    if (sig == null) return false;
    if (sig is TextSignature textSig)
    {
        return !string.IsNullOrEmpty(textSig.Text) && 
               textSig.Text.Contains("Contract");
    }
    return false;
});
```

### 3. Combine Multiple Conditions

```csharp
// Clear, readable predicate with multiple conditions
SearchResult result = signature.Search(searchOptions, sig =>
    sig.PageNumber == 1 &&
    sig.SignatureType == SignatureType.Text &&
    sig is TextSignature textSig &&
    textSig.Text.Length > 10);
```

### 4. Reusable Predicates

```csharp
// Define reusable predicates
Func<BaseSignature, bool> isOnFirstPage = sig => sig.PageNumber == 1;
Func<BaseSignature, bool> isTextSignature = sig => sig.SignatureType == SignatureType.Text;
Func<BaseSignature, bool> isLargeSignature = sig => sig.Width > 200 && sig.Height > 200;

// Combine predicates
SearchResult result = signature.Search(searchOptions, sig =>
    isOnFirstPage(sig) && isTextSignature(sig) && isLargeSignature(sig));
```

### 5. Use Appropriate Search Options

```csharp
// Good: Use specific search options to narrow down initial search
List<SearchOptions> searchOptions = new List<SearchOptions>
{
    new TextSearchOptions { Text = "Contract" }
};

// Then apply additional filtering with predicate
SearchResult result = signature.Search(searchOptions, 
    sig => sig.PageNumber == 1);
```

## Error Handling

### Null Parameter Validation

The methods throw `ArgumentNullException` if required parameters are null:

```csharp
try
{
    using (Signature signature = new Signature("document.pdf"))
    {
        // This will throw ArgumentNullException
        SearchResult result = signature.Search(null, sig => true);
    }
}
catch (ArgumentNullException ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}
```

### Safe Usage Pattern

```csharp
using (Signature signature = new Signature("document.pdf"))
{
    if (searchOptions != null && predicate != null)
    {
        SearchResult result = signature.Search(searchOptions, predicate);
        // Process results
    }
}
```

## Return Values

- **`Search(List<SearchOptions>, Func<...>)`**: Returns `SearchResult` - Contains filtered signatures and metadata (processing time, document size, etc.)
- **`Search(Func<...>)`**: Returns `List<BaseSignature>` - A list of filtered signatures
- **Empty Results**: Returns empty collection if no signatures match the predicate

### Working with SearchResult

```csharp
SearchResult result = signature.Search(searchOptions, predicate);

// Access filtered signatures
List<BaseSignature> signatures = result.Signatures;

// Access metadata
Console.WriteLine($"Processing time: {result.ProcessingTime}ms");
Console.WriteLine($"Source document size: {result.SourceDocumentSize} bytes");
Console.WriteLine($"Destination document size: {result.DestinDocumentSize} bytes");
```

## Comparison: With vs Without Predicate

### Without Predicate

```csharp
// Get all search results
SearchResult result = signature.Search(searchOptions);
List<BaseSignature> allSignatures = result.Signatures;

// Manual filtering
List<BaseSignature> filtered = allSignatures
    .Where(sig => sig.PageNumber == 1)
    .ToList();
```

### With Predicate

```csharp
// Filtered during search (more concise)
SearchResult result = signature.Search(searchOptions, 
    sig => sig.PageNumber == 1);
List<BaseSignature> filtered = result.Signatures;
```

**Advantages:**
- More concise code
- Cleaner API
- Single method call instead of search + filter

## Summary

The predicate-based `Search` methods provide a powerful and flexible way to search for signatures in GroupDocs.Signature. They allow you to:

- Filter signatures based on any custom criteria
- Search across all signature types or specific types
- Write more readable and maintainable code
- Handle complex filtering scenarios with ease

Use these methods when you need to find a subset of signatures based on specific criteria, rather than searching all signatures and filtering manually.

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## How to sign Excel spreadsheets and their macros using C#

Path: /signature/net/how-to-sign-excel-macros-using-csharp/


You can sign spreadsheets, as well as, Visual Basic for Applications (VBA) macro embedded into spreadsheets with digital certificates. Signing a workbook confirms the identity of the signer and the validity of the content. This enhances security and authentication. Modifying a signed spreadsheet invalidates the signature. When opening a signed workbook, other users could be sure that it came from a reliable source and no one has modified it since. 

## Obtaining a digital certificate

A digital certificate is a cryptographic key pair that consists of a public key and a private key, issued by a trusted third party known as a Certificate Authority (CA). There are many commercial third-party certificate authorities from which you can either purchase a digital certificate or obtain a free digital certificate. Many institutions, governments, and corporations can also issue their own certificates.

You can create your own digital certificate for personal use or testing purposes with the SelfCert.exe tool that is provided with Microsoft Office. However, this certificate is not authenticated by a Certificate Authority (CA).

In this article, we will use a self-created test certificate.

![Test certificate](/signature/net/images/signature-use-cases/how-to-sign-excel-macros-using-csharp/MrSmithSignature.png)

Keep in mind that for production environments, you should obtain a certificate from a trusted CA to ensure secure and trusted communication.

## What Excel files could be signed?

You can sign the following files and projects:
  * workbooks (XLSX),
  * templates (XLTX),
  * macro-enabled workbooks (XLSM),
  * macro-enabled templates (XLTM),
  * VBA macro projects within workbooks or templates.

## Signing spreadsheets with digital certificates in C\#

To sign the content of a particular spreadsheet or template:

* Instantiate the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class providing a path to the source document or document stream.
* Create the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object instance providing a path to the certificate. Specify the certificate password using the `DigitalSignOptions.Password` property.
* Invoke the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method to process the document, providing the output file path and sign options.

```csharp
using GroupDocs.Signature;
using GroupDocs.Signature.Options;

string filePath = @"C:\sample.xlsx"; // NOTE: Put here actual path for your document and certificate
string certificatePath = @"C:\MrSmithSignature.pfx";
string password = "1234567890";
string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine(@"C:\output", fileName);

// Sign a spreadsheet
using (Signature signature = new Signature(filePath))
{
    // Setup digital signature options
    DigitalSignOptions signOptions = new DigitalSignOptions(certificatePath);
    signOptions.Signature.Comments = "Test Signature";
    signOptions.Password = password;

    signature.Sign(outputFilePath, signOptions);
}
```
A spreadsheet signed with a digital certificate would look like below:

![Signed workbook](/signature/net/images/signature-use-cases/how-to-sign-excel-macros-using-csharp/signed-workbook.png)

## Signing macro projects within spreadsheets with digital certificates in C\#

You can sign just the macros embedded into the spreadsheet, or sign both the spreadsheet's content and macros.

To sign only the macros:

* Instantiate the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class providing a path to the source document or document stream.
* Create the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object instance.
* Create the [DigitalVBA](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/digitalvba/) object instance providing certificate path and password as constructor parameters.
* Set the [SignOnlyVBAProject](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/digitalvba/signonlyvbaproject/) property to 'true'.
* Add the `DigitalVBA` object instance as a sign options extension. 
* Invoke the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method to process the document, providing the output file path and sign options.

```csharp
using GroupDocs.Signature;
using GroupDocs.Signature.Options;
using GroupDocs.Signature.Domain.Extensions;

string filePath = @"C:\sample.xlsm"; // NOTE: Put here actual path for your document and certificate
string certificatePath = @"C:\MrSmithSignature.pfx";
string password = "1234567890";
string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine(@"C:\output", fileName);

// Sign macros within the spreadsheet
using (Signature signature = new Signature(filePath))
{
    //Create digital signature options without digital certificate
    DigitalSignOptions signOptions = new DigitalSignOptions();
    //Add extension for signing VBA project digitally
    DigitalVBA digitalVBA = new DigitalVBA(certificatePath, password);
    //Set to true only for signing VBA project
    digitalVBA.SignOnlyVBAProject = true;
    digitalVBA.Comments = "Signed VBA macros";
    signOptions.Extensions.Add(digitalVBA);

    signature.Sign(outputFilePath, signOptions);
}
```

To sign both the content and macros:

* Instantiate the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class providing a path to the source document or document stream.
* Create the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object instance providing a path to the certificate. Specify the certificate password using the `DigitalSignOptions.Password` property.
* Create the [DigitalVBA](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/digitalvba/) object instance providing certificate path and password as constructor parameters.
* Do not specify the [SignOnlyVBAProject](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/digitalvba/signonlyvbaproject/) property, or set it to 'false'.
* Add the `DigitalVBA` object instance as a sign options extension. 
* Invoke the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method to process the document, providing the output file path and sign options.

```csharp
using GroupDocs.Signature;
using GroupDocs.Signature.Options;
using GroupDocs.Signature.Domain.Extensions;

string filePath = @"C:\sample.xlsm"; // NOTE: Put here actual path for your document and certificate
string certificatePath = @"C:\MrSmithSignature.pfx";
string password = "1234567890";
string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine(@"C:\output", fileName);

// Sign macros within the spreadsheet
using (Signature signature = new Signature(filePath))
{
    // Setup digital signature options
    DigitalSignOptions signOptions = new DigitalSignOptions(certificatePath);
    signOptions.Signature.Comments = "Test Signature";
    signOptions.Password = password;
        
    //Add extension for signing VBA project digitally
    DigitalVBA digitalVBA = new DigitalVBA(certificatePath, password);
    digitalVBA.Comments = "Signed VBA macros";
    signOptions.Extensions.Add(digitalVBA);

    signature.Sign(outputFilePath, signOptions);
}
```
## Get a Free API License

In order to use the API without evaluation limitations, you can get a free [temporary license](https://purchase.groupdocs.com/temporary-license).

## Conclusion

In this article, we learned the reasons for signing Excel spreadsheets and macros embedded into them. Leveraging C# within .NET applications significantly enhances the efficiency of these tasks.
In addition, you can use the [Digital Signature - XLSX](https://products.groupdocs.app/signature/xlsx) online application to sign your Excel files with GroupDocs.Signature for free.

Read the [documentation](https://docs.groupdocs.com/signature/net/) to learn how to use GroupDocs.Signature in your .NET applications. Also, you may discuss any questions or issues at the [GroupDocs forum](https://forum.groupdocs.com/).

---

## How to sign Excel spreadsheets and their macros using Python

Path: /signature/python-net/how-to-sign-excel-macros-using-python/


You can sign spreadsheets, as well as, Visual Basic for Applications (VBA) macro embedded into spreadsheets with digital certificates. Signing a workbook confirms the identity of the signer and the validity of the content. This enhances security and authentication. Modifying a signed spreadsheet invalidates the signature. When opening a signed workbook, other users could be sure that it came from a reliable source and no one has modified it since. 

## Obtaining a digital certificate

A digital certificate is a cryptographic key pair that consists of a public key and a private key, issued by a trusted third party known as a Certificate Authority (CA). There are many commercial third-party certificate authorities from which you can either purchase a digital certificate or obtain a free digital certificate. Many institutions, governments, and corporations can also issue their own certificates.

You can create your own digital certificate for personal use or testing purposes with the SelfCert.exe tool that is provided with Microsoft Office. However, this certificate is not authenticated by a Certificate Authority (CA).

In this article, we will use a self-created test certificate.

![Test certificate](/signature/net/images/signature-use-cases/how-to-sign-excel-macros-using-csharp/MrSmithSignature.png)

Keep in mind that for production environments, you should obtain a certificate from a trusted CA to ensure secure and trusted communication.

## What Excel files could be signed?

You can sign the following files and projects:
  * workbooks (XLSX),
  * templates (XLTX),
  * macro-enabled workbooks (XLSM),
  * macro-enabled templates (XLTM),
  * VBA macro projects within workbooks or templates.

## Signing spreadsheets with digital certificates in Python

To sign the content of a particular spreadsheet or template:

* Instantiate the `Signature` class providing a path to the source document or document stream.
* Create the `DigitalSignOptions` object instance providing a path to the certificate. Specify the certificate password using the `password` property.
* Invoke the `sign` method to process the document, providing the output file path and sign options.

```python
import groupdocs.signature as signature
import os

# File paths
file_path = "sample.xlsx"  # NOTE: Put here actual path for your document and certificate
certificate_path = "MrSmithSignature.pfx"
password = "1234567890"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)
output_file_path = os.path.join(output_dir, os.path.basename(file_path))

# Sign a spreadsheet
signature_handler = signature.Signature(file_path)

# Setup digital signature options
sign_options = signature.DigitalSignOptions(certificate_path)
sign_options.signature.comments = "Test Signature"
sign_options.password = password

# Sign document
signature_handler.sign(output_file_path, sign_options)
```

A spreadsheet signed with a digital certificate would look like below:

![Signed workbook](/signature/net/images/signature-use-cases/how-to-sign-excel-macros-using-csharp/signed-workbook.png)

## Signing macro projects within spreadsheets with digital certificates in Python

You can sign just the macros embedded into the spreadsheet, or sign both the spreadsheet's content and macros.

To sign only the macros:

* Instantiate the `Signature` class providing a path to the source document or document stream.
* Create the `DigitalSignOptions` object instance.
* Create the `DigitalVBA` object instance providing certificate path and password as constructor parameters.
* Set the `sign_only_vba_project` property to `True`.
* Add the `DigitalVBA` object instance as a sign options extension. 
* Invoke the `sign` method to process the document, providing the output file path and sign options.

```python
import groupdocs.signature as signature
import os

# File paths
file_path = "sample.xlsm"  # NOTE: Put here actual path for your document and certificate
certificate_path = "MrSmithSignature.pfx"
password = "1234567890"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)
output_file_path = os.path.join(output_dir, os.path.basename(file_path))

# Sign macros within the spreadsheet
signature_handler = signature.Signature(file_path)

# Create digital signature options without digital certificate
sign_options = signature.DigitalSignOptions()

# Add extension for signing VBA project digitally
digital_vba = signature.DigitalVBA(certificate_path, password)
# Set to true only for signing VBA project
digital_vba.sign_only_vba_project = True
digital_vba.comments = "Signed VBA macros"
sign_options.extensions.add(digital_vba)

# Sign document
signature_handler.sign(output_file_path, sign_options)
```

To sign both the content and macros:

* Instantiate the `Signature` class providing a path to the source document or document stream.
* Create the `DigitalSignOptions` object instance providing a path to the certificate. Specify the certificate password using the `password` property.
* Create the `DigitalVBA` object instance providing certificate path and password as constructor parameters.
* Do not specify the `sign_only_vba_project` property, or set it to `False`.
* Add the `DigitalVBA` object instance as a sign options extension. 
* Invoke the `sign` method to process the document, providing the output file path and sign options.

```python
import groupdocs.signature as signature
import os

# File paths
file_path = "sample.xlsm"  # NOTE: Put here actual path for your document and certificate
certificate_path = "MrSmithSignature.pfx"
password = "1234567890"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)
output_file_path = os.path.join(output_dir, os.path.basename(file_path))

# Sign macros within the spreadsheet
signature_handler = signature.Signature(file_path)

# Setup digital signature options
sign_options = signature.DigitalSignOptions(certificate_path)
sign_options.signature.comments = "Test Signature"
sign_options.password = password
    
# Add extension for signing VBA project digitally
digital_vba = signature.DigitalVBA(certificate_path, password)
digital_vba.comments = "Signed VBA macros"
sign_options.extensions.add(digital_vba)

# Sign document
signature_handler.sign(output_file_path, sign_options)
```

## Get a Free API License

In order to use the API without evaluation limitations, you can get a free [temporary license](https://purchase.groupdocs.com/temporary-license).

## Conclusion

In this article, we learned the reasons for signing Excel spreadsheets and macros embedded into them. Using Python improves the efficiency of these tasks dramatically.
In addition, you can use the [Digital Signature - XLSX](https://products.groupdocs.app/signature/xlsx) online application to sign your Excel files with GroupDocs.Signature for free.

Read the [documentation](https://docs.groupdocs.com/signature/python-net/) to learn how to use GroupDocs.Signature in your Python applications. Also, you may discuss any questions or issues at the [GroupDocs forum](https://forum.groupdocs.com/). 
---

## eSign document with Image signature

Path: /signature/net/esign-document-with-image-signature/

## What is an Image Signature?

An **image** as a signature is an alternative way to put any presenting data in a visual form. This electronic signature type allows the creation of custom images with a company logo, sender's initials, names and so forth.

![Images](/signature/net/images/esign-document-with-image-signature.png)

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides the [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) class to specify different settings for image signature such as image content by file or stream, location, colors and advanced effects.

Here are the steps to create an image signature on a document page:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter;
* Instantiate the [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) object according to your requirements and specify Image signature options;
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) to it.

## How to eSign document with Image signature

This example shows how to sign a PDF document with the image signature.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    ImageSignOptions options = new ImageSignOptions("signature.jpg")
    {
        // set signature position
        Left = 100,
        Top = 100,
        //
        AllPages = true
    };
    signature.Sign("SampleSigned.pdf", options);
}
```

### Summary
This guide demonstrates how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) to add image-based signatures to documents. It covers loading a document, configuring the image signature's properties (such as size, position, and opacity), and saving the signed document. Advanced customization options, like adjusting image appearance and aligning the signature, are also discussed. For further insights, explore related document signing resources.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## In-Paragraph List in HTML Document

Path: /assembly/java/in-paragraph-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-ParagraphList report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Paragraph List in HTML Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   A descriptive or informative line like "We provide support for the following clients:".
*   Show all the clients along with the above sentence.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients: <<foreach [in getClients()]>>
<<[indexOf() != 0 ? ", " : ""]>><<[getName()]>><</foreach>>
```

### Download In-Paragraph List Template

Please download the sample Common List document we created in this article:

*   [In-Paragraph List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/In-Paragraph%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists ad26226f833d02f4e045e4da94ea7026 >}}



---

## In-Paragraph List in HTML Document

Path: /assembly/net/in-paragraph-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Paragraph List report in HTML Document format.{{< /alert >}}

## In-Paragraph List in HTML Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   A descriptive or informative line like "We provide support for the following products:".
*   Show all the products along with the above sentence.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products: <<foreach [in products]>>
<<[indexOf() != 0 ? ", " : ""]>><<[ProductName]>><</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Paragraph List Template

Please download the sample Common List document we created in this article:

*   [In-Paragraph List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/In-Paragraph%20List.html?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< gist rida-fatima-aspose ff54dc56129ac0115dd6f2d61dc9fa8c >}}



---

## In-Table List in HTML

Path: /assembly/java/in-table-list-in-html/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List in HTML Document

### Reporting Requirement

As a report developer, you are required to represent the information of the managers with the following key requirements:

*   Report must show managers' name.
*   It must show the sum of contract prices against each manager.
*   It must sum up all the contract prices for all the managers.
*   All the representation must be in tabular form.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gdassembly">
	<tbody>
		<tr>
			<td colspan="2">&lt;&lt;foreach [in getManagers()]>> &lt;&lt;/foreach>></td>
		</tr>
		<tr>
			<td><b>Manager/Client</b></td>
			<td><b>Contract Price</b></td>
		</tr>
		<tr>
			<td><b>&lt;&lt;[getName()]>></b></td>
			<td>&lt;&lt;[getContracts().sum(c => c.getPrice())]>></td>
		</tr>
		<tr>
			<td><b>Total:</b></td>
			<td>&lt;&lt;[getManagers().sum( m => m.getContracts().sum( c => c.getPrice()))]>></td>
		</tr>
	</tbody>
</table>

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/In-Table%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists bd2c72eba6ad72cf8bc7c89341cb3d24 >}}



---

## In-Table List in HTML Document

Path: /assembly/net/in-table-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-Table List report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table List in HTML Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and the total order prices with the following key requirements:

*   Report must show customers' name.
*   It must show the sum of orders prices against each customer.
*   It must sum up all the order prices for all the customers.
*   All the representation must be in tabular form.
*   Report must be generated in the PowerPoint Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in customers]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">m =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">m.Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download  In-Table List Template

Please download the sample In-Table list document we created in this article:

*   [In-Table List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/In-Table%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists d4264c6a25c04e7d0111df8f4bc7d437 >}}



---

## In-Table List With Alternate Content in HTML Document

Path: /assembly/java/in-table-list-with-alternate-content-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList WithAlternateContent report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List With Alternate Content in HTML Document

### Reporting Requirement

As a report developer, you are required to represent your clients and their prices with the following key requirements:

*   Report must show each client along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gdassembly">
	<tbody>
		<tr>
			<td colspan="2">&lt;&lt;if [!getContracts().any()]>> &lt;&lt;else>>&lt;&lt;foreach [in getContracts()]>> &lt;&lt;/foreach>> &lt;&lt;/if>></td>
		</tr>
		<tr>
			<td><b>Client</b></td>
			<td><b>Contract Price</b></td>
		</tr>
		<tr>
			<td colspan="2" align="center"><b>No data</b></td>
		</tr>
		<tr>
			<td><b>&lt;&lt;[getClient().getName()]>></b></td>
			<td>&lt;&lt;[getPrice()]>></td>
		</tr>
		<tr>
			<td><b>Total:</b></td>
			<td>&lt;&lt;[getContracts().sum( c => c.getPrice())]>></td>
		</tr>
	</tbody>
</table>

### Download In-Paragraph List Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/In-Table%20List%20with%20Alternate%20Content.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 7b0cb529d9df041f753402fca04f03cc >}}



---

## In-Table List With Alternate Content in HTML Document

Path: /assembly/net/in-table-list-with-alternate-content-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-Table Master-Detail report in HTML Document format.{{< /alert >}}

## In-Table List With Alternate Content in HTML Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent your products and their prices with the following key requirements:

*   Report must show each product along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Products</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td colspan="2" style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 445.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!Any()]&gt;&gt;No data</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Product.ProductName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: Working with GroupDocs.Assembly Engine{{< /alert >}}

### Download In-Table List With Alternate Content Template

Please download the sample In-Table list with alternate content document we created in this article:

*   [In-Table List with Alternate Content.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/In-Table%20List%20with%20Alternate%20Content.html?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist rida-fatima-aspose 5b6467adfd709f7814c059cc6dd6221b >}}



---

## In-Table List with Filtering Grouping and Ordering in HTML Document

Path: /assembly/java/in-table-list-with-filtering-grouping-and-ordering-in-html-document/

# In-Table List with Filtering, Grouping, and Ordering in HTML Document

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableList with Filtering, Grouping, and Ordering report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in HTML Document

### Reporting Requirement

As a report developer, you are required to represent managers' contract information with the following key requirements:

*   Report must show each manager along with sum of prices of his contracts.
*   It must represent all the information in tabular form.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gdassembly">
	<tbody>
		<tr>
			<td colspan="2">&lt;&lt;foreach \[in getContracts() .where(c => c.getDate().getYear() + 1900 == 2015) .groupBy(c => c.getManager()) .orderBy(g => g.key.getName())\]>> &lt;&lt;/foreach>></td>
		</tr>
		<tr>
			<td><b>Manager</b></td>
			<td><b>Contract Price</b></td>
		</tr>
		<tr>
			<td><b>&lt;&lt;[key.getName()]>></b></td>
			<td>&lt;&lt;[sum(c => c.getPrice())]>></td>
		</tr>
	</tbody>
</table>

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample template we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 4554b48316196d2579cb1cbd679b8bfe >}}



---

## In-Table List with Filtering Grouping and Ordering in HTML Document

Path: /assembly/net/in-table-list-with-filtering-grouping-and-ordering-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table Master-Detail report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in HTML Document

{{< alert style="info" >}}This feature is supported by version 17.3.0 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with the following key requirements:

*   Report must show each customer along with sum of prices of his orders.
*   It must represent all the information in tabular form.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.Where(c =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">c.OrderDate.Year</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> == 2015)</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">GroupBy</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">(c =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">c.Customer</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">)</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">OrderBy</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">(g =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">g.Key.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">)]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Key.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.html](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/HTML%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 20f37529fd46f0df77a2fcbd3114c9da >}}



---

## In-Table List with Highlighted Rows in HTML Document

Path: /assembly/java/in-table-list-with-highlighted-rows-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-TableList with Highlighted Rows report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table List with Highlighted Rows in HTML Document

#### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show all the client names with price.
*   Show single client and his single contract price in a single row.
*   It must highlight the record with contract price more than or equal to 1000000.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

#### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gdassembly">
	<tbody>
		<tr>
			<td colspan="2">&lt;&lt;foreach [in getContracts()]>> &lt;&lt;/foreach>></td>
		</tr>
		<tr>
			<td><b>Client</b></td>
			<td><b>Contract Price</b></td>
		</tr>
		<tr>
			<td><b>&lt;&lt;[getClient().getName()]>></b></td>
			<td>&lt;&lt;[getPrice()]>></td>
		</tr>
		<tr>
			<td><b>Total:</b></td>
			<td>&lt;&lt[getContracts().sum(c => c.getPrice())]>></td>
		</tr>
	</tbody>
</table>

#### Download In-Table List with Highlighted Rows Template

Please download the sample template we created in this article:

*   [In-Table List with Highlighted Rows.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/In-Table%20List%20with%20Highlighted%20Rows.html?raw=true)

#### Generating The Report

{{< gist GroupDocsGists 511a909679524da572f03b687e1e4d98 >}}



---

## In-Table List with Highlighted Rows in HTML Document

Path: /assembly/net/in-table-list-with-highlighted-rows-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-Table List with Highlighted Rows in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

## In-Table List with Highlighted Rows in HTML Document

### Reporting Requirement

As a report developer, you are required to represent customers' orders information with a specific filtering condition with the following key requirements:

*   The report must show each customer along with his orders.
*   Show single Customer and his single order price in a single row.
*   It must highlight the record with order price more than or equal to 400.
*   It must show sum of the order prices.
*   It must represent all the information in tabular form.
*   The report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;if [Price &gt;= 400]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### In-Table List with Highlighted Rows Template

Please download the In-Table list with highlighted rows template document we created in this article:

*   [In-Table List with Highlighted Rows.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/In-Table%20List%20with%20Highlighted%20Rows.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 0f7a71b9f595a68a906bf3dbf57bda02 >}}



---

## In-Table Master-Detail in HTML Document

Path: /assembly/java/in-table-master-detail-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-TableMaster-Detail report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Table Master-Detail in HTML Document

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show each manager along with his total contract prices.
*   It must also show each individual client within the contract.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gdassembly">
	<tbody>
		<tr>
			<td colspan="2">&lt;&lt;foreach [in getManagers()]>> &lt;&lt;foreach [in getContracts()]>> &lt;&lt;/foreach>> &lt;&lt;/foreach>></td>
		</tr>
		<tr>
			<td><b>Manager/Client</b></td>
			<td><b>Contract Price</b></td>
		</tr>
		<tr>
			<td><b>&lt;&lt;[getName()]>></b></td>
			<td>&lt;&lt;[getContracts().sum(c => c.getPrice())]>></td>
		</tr>
		<tr>
			<td><i>&lt;&lt;[getClient().getName()]>></i></td>
			<td>&lt;&lt;[getPrice()]>></td>
		</tr>
		<tr>
			<td><b>Total:</b></td>
			<td>&lt;&lt;[getManagers().sum( m => m.getContracts().sum( c => c.getPrice()))]>></td>
		</tr>
	</tbody>
</table>

### Download In-Table Master-Detail Template

Please download the sample document we created in this article:

*   [In-Table Master-Detail.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/In-Table%20Master-Detail.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists a467de2001915d62ae4eb9404c1772b5 >}}



---

## In-Table Master-Detail in HTML Document

Path: /assembly/net/in-table-master-detail-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-Table Master-Detail report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

## In-Table Master-Detail in HTML Document

### Reporting Requirement

As a report developer, you are required to represent customers' total orders prices and price of each product separately with the following key requirements:

*   The report must show each customer along with his total orders prices.
*   It must also show each individual product ordered by the customers.
*   It must show sum of the order prices.
*   It must represent all the information in tabular form.
*   The report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="tbl1">
	<tbody>
		<tr>
			<td colspan="2"> &lt;&lt;foreach [in customers]>> &lt;&lt;foreach [in Order]>> &lt;&lt;/foreach>> &lt;&lt;/foreach>></td>
		</tr>
		<tr>
			<td>Customer</td>
			<td>Order Price</td>
		</tr>
		<tr>
			<td><<[CustomerName]>>
</td>
			<td><<[Order.Sum(c => c.Price)]>></td>
		</tr>
		<tr>
			<td colspan="2">  <<[Product.ProductName]>> <<[Price]>></td>
		</tr>
		<tr>
			<td>Total:</td>
			<td><<[Sum( m => m.Order.Sum( c => c.Price))]>></td>
		</tr>
	</tbody>
</table>

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download  In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/In-Table%20Master-Detail.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 57a8db2df722098fc33343718b289296 >}}



---

## Index lifecycle

Path: /search/java/index-lifecycle/

The life cycle of an index begins at the moment of creating an instance of the Index class and first saving the index files to disk. The index life cycle ends when a folder containing index files is deleted. Below is a diagram of the recommended sequence of index life cycle states.

Please note that the index life cycle does not consider the events of loading and unloading the index from RAM. At each stage of existence, the index can be loaded and unloaded from memory several times.

![](/search/java/images/index-lifecycle.png)

After creation a new index, it is in the Empty state.

When adding documents (method [add](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#add(java.lang.String))) to the index and completing the indexing operation, the index is in the Actual state, the index is ready to process search queries.

To accelerate the processing of search queries, the index can be optimized by calling the [optimize](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#optimize()) method. Upon completion of the optimization operation, the index goes into the Optimized state. In this state, the index contains the minimum required number of segments on the disk and therefore works faster.

Changing, adding, deleting documents from indexed folders puts the index in the Outdated state. In this state, search results may not be relevant.

Calling the [update](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#update()) method starts reindexing of changed, new and deleted documents. Upon completion of the update operation, the index reverts to the Actual state.

Here we can give a recommendation to update the index at times of minimal search activity, for example, at night, to give more processor time to search queries handling. But this is not necessary, because the search can be performed simultaneously with the indexing or updating operation. Moreover, updating can work without pauses and start immediately after the previous one is completed.

Regarding the addition of documents to an index, it is important to know that at any stage of the existence of an index, new documents can be added (method [add](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#add(java.lang.String))) to it to expand the search base.

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Index lifecycle

Path: /search/net/index-lifecycle/

The life cycle of an index begins at the moment of creating an instance of the Index class and first saving the index files to disk. The index life cycle ends when a folder containing index files is deleted. Below is a diagram of the recommended sequence of index life cycle states.

Please note that the index life cycle does not consider the events of loading and unloading the index from RAM. At each stage of existence, the index can be loaded and unloaded from memory several times.

![](/search/net/images/index-lifecycle.png)

After creation a new index, it is in the Empty state.

When adding documents (method [Add](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/add/index)) to the index and completing the indexing operation, the index is in the Actual state, the index is ready to process search queries.

To accelerate the processing of search queries, the index can be optimized by calling the [Optimize](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/optimize/index) method. Upon completion of the optimization operation, the index goes into the Optimized state. In this state, the index contains the minimum required number of segments on the disk and therefore works faster.

Changing, adding, deleting documents from indexed folders puts the index in the Outdated state. In this state, search results may not be relevant.

Calling the [Update](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/update/index) method starts reindexing of changed, new and deleted documents. Upon completion of the update operation, the index reverts to the Actual state.

Here we can give a recommendation to update the index at times of minimal search activity, for example, at night, to give more processor time to search queries handling. But this is not necessary, because the search can be performed simultaneously with the indexing or updating operation. Moreover, updating can work without pauses and start immediately after the previous one is completed.

Regarding the addition of documents to an index, it is important to know that at any stage of the existence of an index, new documents can be added (method [Add](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/add/index)) to it to expand the search base.

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Index lifecycle

Path: /search/nodejs-java/index-lifecycle/

The life cycle of an index begins at the moment of creating an instance of the Index class and first saving the index files to disk. The index life cycle ends when a folder containing index files is deleted. Below is a diagram of the recommended sequence of index life cycle states.

Please note that the index life cycle does not consider the events of loading and unloading the index from RAM. At each stage of existence, the index can be loaded and unloaded from memory several times.

![](/search/nodejs-java/images/index-lifecycle.png)

After creation a new index, it is in the Empty state.

When adding documents (method [add](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#add(java.lang.String))) to the index and completing the indexing operation, the index is in the Actual state, the index is ready to process search queries.

To accelerate the processing of search queries, the index can be optimized by calling the [optimize](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#optimize()) method. Upon completion of the optimization operation, the index goes into the Optimized state. In this state, the index contains the minimum required number of segments on the disk and therefore works faster.

Changing, adding, deleting documents from indexed folders puts the index in the Outdated state. In this state, search results may not be relevant.

Calling the [update](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#update()) method starts reindexing of changed, new and deleted documents. Upon completion of the update operation, the index reverts to the Actual state.

Here we can give a recommendation to update the index at times of minimal search activity, for example, at night, to give more processor time to search queries handling. But this is not necessary, because the search can be performed simultaneously with the indexing or updating operation. Moreover, updating can work without pauses and start immediately after the previous one is completed.

Regarding the addition of documents to an index, it is important to know that at any stage of the existence of an index, new documents can be added (method [add](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#add(java.lang.String))) to it to expand the search base.

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Individual Series Point Coloring in Email Document

Path: /assembly/java/individual-series-point-coloring-in-email-document/

{{< alert style="info" >}}This feature is supported by version 18.6 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Email Document

Please follow below steps to create Pie Chart in MS Outlook 2013:

1.  Create a new Email
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Pie"
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your email
5.  Edit the Worksheet with your data to update the chart

### Reporting Requirement

As a report developer, you are required to share your customer orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Word Processing Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

|   | Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor [Color] >> |
| --- | --- |
| A | 8.2 |
| B | 3.2 |
| C | 1.5 |
| D | 1.2 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Dynamic%20Chart%20Point%20Series%20Color.msg) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```java
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists e7243f17c5067c01c1b77bdf2aca1813 >}}



---

## Individual Series Point Coloring in Email Document

Path: /assembly/net/individual-series-point-coloring-in-email-document/

{{< alert style="info" >}}This feature is supported by version 18.6 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Individual Series Point Coloring in Email Document

Please follow below steps to create Pie Chart in MS Outlook 2013:

1.  Create a new Email
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
3.  Select "Pie"
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your email
5.  Edit the Worksheet with your data to update the chart

### Reporting Requirement

As a report developer, you are required to share your customer orders details dynamically with the following key requirements:

*   The report must show information on a Pie Chart
*   It must indicate customer name with value (price of the orders purchased)
*   The report must be generated in the Email Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Price<<foreach [in customers]>>
<<x [CustomerName]>>
```

#### Chart Data (Excel)

|   | Total Order Price<<y [Order.Sum(c => c.Price)]>><<pointColor [Color] >> |
| --- | --- |
| A | 8.2 |
| B | 3.2 |
| C | 1.5 |
| D | 1.2 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Dynamic Chart Point Series Color.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Dynamic%20Chart%20Point%20Series%20Color.msg) (Template for CustomObject and JSON examples) 

### Generating The Report

For a chart with dynamic data, you can set colors of individual chart series points dynamically based upon expressions. To use the feature, do the following steps:

*   Declare a chart with dynamic data in the usual way
*   For chart series with points to be colored dynamically, define corresponding color expressions in names of these series using **pointColor** tags having the following syntax:
  
    ```csharp
    <<pointColor [color_expression]>>
    ```
    

A color expression must return a value of one of the following types:

*   A string containing the name of a known color, that is, the case-insensitive name of a member of the [KnownColor](https://msdn.microsoft.com/en-us/library/system.drawing.knowncolor(v=vs.110).aspx) enumeration such as "red"
*   An integer value defining RGB (red, green, blue) components of the color such as 0xFFFF00 (yellow)
*   A value of the [Color](http://msdn.microsoft.com/en-us/library/system.drawing.color(v=vs.110).aspx) type

Following code snippet generates the report:

{{< gist GroupDocsGists eb60870505358ef73a277fa25524d7a7 >}}



---

## Install GroupDocs.Comparison for Python via .NET

Path: /comparison/python-net/installation/


### Install using PYPI

All Python packages are hosted at [PYPI](https://pypi.org/project/groupdocs-comparison-net/). You can easily reference GroupDocs.Comparison for Python via .NET API directly in your Python project by installing it with the following command.

```shell
pip install groupdocs-comparison-net
```

## Download Package from Official Website

To download the GroupDocs.comparison package for your operating system, please visit the official [GroupDocs Releases website](https://releases.groupdocs.com/comparison/python-net/). Currently, four OS-specific packages are available:

- **Windows 64-bit:** Package name ends with `amd64.whl`
- **Linux 64-bit:** Package name ends with `arm64.whl`
- **macOS Intel Silicon:** Package name ends with `x86_64.whl`

Choose the appropriate package based on your system's architecture.

### Copy Downloaded File

Copy the downloaded file into your project folder.

### Install Package Using Pip

To install package run the command specific to your your operation system. 

Windows 64-bit

```bash
py -m pip install groupdocs_comparison_net-25.6-py3-none-win_amd64.whl
```

Linux 64-bit

```bash
py -m pip install groupdocs_comparison_net-25.6-py3-none-macosx_10_14_x86_64.whl
```

macOS Intel Silicon

```bash
python3 -m pip install groupdocs_comparison_net-25.6-py3-none-manylinux1_x86_64.whl
```

Expected output:

```bash
Processing groupdocs_comparison_net-25.6-py3-none-*.whl
Installing collected packages: groupdocs-comparison-net
Successfully installed groupdocs-comparison-net-25.6
```
---

## Install GroupDocs.Parser for Python via .NET

Path: /parser/python-net/installation/


### Install using PyPI

All Python packages are hosted at [PyPI](https://pypi.org/project/groupdocs-parser-net/). You can easily reference GroupDocs.Parser for Python via .NET API directly in your Python project by installing it with the following command.

```shell
pip install groupdocs-parser-net
```

## Download Package from Official Website

To download the GroupDocs.Parser package for your operating system, please visit the official [GroupDocs Releases website](https://releases.groupdocs.com/parser/python-net/). Currently, OS-specific packages are available for different platforms:

- **Windows 64-bit:** Package name ends with `amd64.whl`
- **Linux 64-bit:** Package name ends with `x86_64.whl`
- **macOS Intel Silicon:** Package name ends with `macosx_10_14_x86_64.whl`

Choose the appropriate package based on your system's architecture.

### Copy Downloaded File

Copy the downloaded file into your project folder.

### Install Package Using Pip

To install package run the command specific to your operation system. 

Windows 64-bit

```bash
py -m pip install groupdocs_parser_net-24.12-py3-none-win_amd64.whl
```

Linux 64-bit

```bash
python3 -m pip install groupdocs_parser_net-24.12-py3-none-manylinux1_x86_64.whl
```

macOS Intel Silicon

```bash
python3 -m pip install groupdocs_parser_net-24.12-py3-none-macosx_10_14_x86_64.whl
```

Expected output:

```bash
Processing groupdocs_parser_net-24.12-py3-none-*.whl
Installing collected packages: groupdocs-parser-net
Successfully installed groupdocs-parser-net-24.12
```

## Verify Installation

After installation, you can verify that GroupDocs.Parser is correctly installed by running the following Python code:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def verify_installation():
    # Check if the module is loaded correctly
    print("GroupDocs.Parser for Python via .NET installed successfully!")

if __name__ == "__main__":
    verify_installation()
```

{{< /tab >}}
{{< /tabs >}}

## Quick Start Example

Here's a simple example to extract text from a document:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_text_quick_start():
    # Create an instance of Parser class
    with Parser("./sample.pdf") as parser:
        # Extract text from the document
        text_reader = parser.get_text()
        
        if text_reader is not None:
            # Print the extracted text
            print(text_reader)
        else:
            print("Text extraction isn't supported for this format")

if __name__ == "__main__":
    extract_text_quick_start()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/installation/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## System Requirements

Before installing GroupDocs.Parser for Python via .NET, ensure your system meets the following requirements:

- **Python:** Version 3.5 or higher
- **Operating Systems:** Windows, Linux, macOS
- **Dependencies:** All required dependencies are automatically installed via pip

For more details, see the [System Requirements]({{< ref "parser/python-net/system-requirements" >}}) page.

---

## Install GroupDocs.Watermark for Node.js via Java

Path: /watermark/nodejs-java/installation/


### Install using NPM

All Java packages are hosted at [NPM](https://www.npmjs.com/package/@groupdocs/groupdocs.watermark). You can easily reference GroupDocs.Watermark for Node.js via Java API directly in your Node.js project by installing it with the following command.

```shell
npm install @groupdocs/groupdocs.watermark
```
---

## Installation

Path: /annotation/java/installation/


GroupDocs hosts all Java APIs on [GroupDocs Repository](https://releases.groupdocs.com/java/repo/). You use the [GroupDocs.Annotation for Java](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-annotation/) API directly in your Maven projects with simple configurations.

### Specify GroupDocs Repository Configuration

First, you need to specify GroupDocs repository configuration/location in your Maven `pom.xml` as follows: 

{{< tabs "example1">}}
{{< tab "XML" >}}
```xml
<repositories>
    <repository>
        <id>GroupDocs Artifact Repository</id>
        <name>GroupDocs Artifact Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>
```
{{< /tab >}}
{{< /tabs >}}

### Define GroupDocs.Annotation for Java API Dependency

Then define GroupDocs.Annotation for Java API dependency in your `pom.xml` as follows:

{{< tabs "example2">}}
{{< tab "XML" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>23.10</version> 
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< /tabs >}}

---

## Installation

Path: /annotation/net/installation/

This topic describes how to add the GroupDocs.Annotation library to your .NET project. You can use a NuGet package to install this library or you can download necessary DLLs from the GroupDocs website: [https://releases.groupdocs.com/annotation/net/](https://releases.groupdocs.com/annotation/net/).

## Install GroupDocs.Annotation using NuGet packages

You can use the following tools to install the [GroupDocs.Annotation](https://www.nuget.org/packages/GroupDocs.Annotation) NuGet package: 

 * [NuGet Package Manager](#use-the-nuget-package-manager-in-visual-studio)
 * [Package Manager Console](#use-the-package-manager-console-in-visual-studio)
 * [.NET CLI](#use-the-net-cli)

### Use the NuGet Package Manager

Open your project or solution in Visual Studio and follow the steps below to install the **GroupDocs.Annotation** package using the [NuGet Package Manager](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio):

1. In **Solution Explorer**, right-click your project name and select **Manage NuGet Packages** to display the NuGet Package Manager.

    ![Manage NuGet packages in Visual Studio](/annotation/net/images/manage-nuget-packages.png)

2. Select the **Browse** tab and type **GroupDocs.Annotation** in the search box. Select the latest version of the **GroupDocs.Annotation** package and click **Install**.

    ![](/annotation/net/images/install-nuget-package.png)

### Use the Package Manager Console

The [Package Manager Console](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell) uses PowerShell commands to install, update, and remove NuGet packages. Open your project in Visual Studio and click **Tools** -> **NuGet Package Manager** -> **Package Manager Console** to open the console window. Run the the following command to install the latest version of the **GroupDocs.Annotation** library:

{{< tabs "example1">}}
{{< tab "PowerShell" >}}
```
PM> Install-Package GroupDocs.Annotation
```
{{< /tab >}}
{{< /tabs >}}

![Use Package Manager Console ](/annotation/net/images/package-manager-console.png)

### Use the .NET CLI

You can also use the [.NET CLI tool](https://docs.microsoft.com/en-us/dotnet/core/tools/) to install and update NuGet packages. Open a terminal in your project's folder and execute the following command to install the **GroupDocs.Annotation** package:

{{< tabs "example2">}}
{{< tab ".NET CLI" >}}
```
dotnet add package GroupDocs.Annotation
```
{{< /tab >}}
{{< /tabs >}}

## Download GroupDocs.Annotation from the official website

Visit [https://releases.groupdocs.com/annotation/net/](https://releases.groupdocs.com/annotation/net/) and download the **GroupDocs.Annotation** assemblies as a ZIP archive or MSI installer. To reference the downloaded assembly files in your project, do the following:

1. Extract files from the ZIP archive or run the MSI installer to install **GroupDocs.Annotation** to a specific location on your computer.
2. Open your solution or project in Visual Studio.
3. In **Solution Explorer**, right-click the **References** or **Dependencies** node, and select **Add Reference** (for a .NET Framework project) or **Add Project Reference** (for a .NET Core project).
4. In the **Reference Manager** dialog box, select the **Browse** tab and click **Browse** to locate the _GroupDocs.Annotation.dll_ file for the target framework.

    ![Browse for the GroupDocs.Annotation assembly](/annotation/net/images/browse-for-groupdocs-dll.png)

5. Click **OK** to add a reference to the **GroupDocs.Annotation** library to your project.

{{< alert style="warning" >}}
If your application targets .NET Core / .NET 5+, ensure that your project has all the required dependencies installed. Refer to the following page for details: [GroupDocs.Annotation dependencies](https://www.nuget.org/packages/groupdocs.annotation#dependencies-body-tab).
{{< /alert >}}

---

## Installation

Path: /assembly/java/installation/

## Install using Maven

All GroupDocs packages are hosted at [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-assembly/). You can download packages or reference GroupDocs.Assembly for Java API directly in your Maven project using following steps. 

### Add GroupDocs Artifact Repository

Add GroupDocs Artifact Repository to your `pom.xml` file:

{{< tabs "pom-repository">}}
{{< tab "pom.xml" >}}
```xml
<repositories>
    <repository>
        <id>GroupDocs Artifact Repository</id>
        <name>GroupDocs Artifact Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Assembly as a dependency

Define GroupDocs.Assembly for Java API dependency in your `pom.xml`:

{{< tabs "pom-dependency">}}
{{< tab "pom.xml" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-assembly</artifactId>
        <version>24.4</version> 
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< /tabs >}}

```

---

## Install GroupDocs.Assembly for .NET

Path: /assembly/net/installation/

This topic describes how to add the **GroupDocs.Assembly** library to your .NET project. You can use a NuGet package to install this library or you can download necessary DLLs from the GroupDocs website: [https://releases.groupdocs.com/assembly/net/](https://releases.groupdocs.com/assembly/net/).

## Install GroupDocs.Assembly using NuGet packages

You can use the following tools to install the **GroupDocs.Assembly** NuGet packages: 

 * [NuGet Package Manager](#use-the-nuget-package-manager)
 * [Package Manager Console](#use-the-package-manager-console)
 * [.NET CLI](#use-the-net-cli)

### Use the NuGet Package Manager

{{< alert style="tip" >}}

Earlier versions of Visual Studio does not include NuGet Package Manager. It can be added as an extension from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/).

* [NuGet Package Manager for Visual Studio 2015](https://marketplace.visualstudio.com/items?itemName=NuGetTeam.NuGetPackageManagerforVisualStudio2015)
* [NuGet Package Manager for Visual Studio 2013](https://marketplace.visualstudio.com/items?itemName=NuGetTeam.NuGetPackageManagerforVisualStudio2013)
* [NuGet Package Manager for Visual Studio 2010 and 2012](https://marketplace.visualstudio.com/items?itemName=NuGetTeam.NuGetPackageManager) 

{{< /alert >}}

Open your project or solution in Visual Studio and follow the steps below to install the **GroupDocs.Assembly** or **GroupDocs.Assembly.CrossPlatform** package using the NuGet Package Manager:

1. In **Solution Explorer**, right-click your project name and select **Manage NuGet Packages** to display the NuGet Package Manager.

    ![Add NuGet package in Visual Studio](/assembly/net/images/getting-started/installation/manage-nuget-packages.png)

2. Select the **Browse** tab and type **GroupDocs.Assembly** or **GroupDocs.Assembly.CrossPlatform** in the search box. Select the latest version of the package and click **Install**.

    ![Install GroupDocs.Assembly NuGet package in Visual Studio](/assembly/net/images/getting-started/installation/install-nuget-package.png)

### Use the Package Manager Console

The [Package Manager Console](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell) uses PowerShell commands to install, update, and remove NuGet packages. Open your project in Visual Studio and click **Tools** -> **NuGet Package Manager** -> **Package Manager Console** to open the console window. Run the the following command to install the latest version of the package:

{{< tabs "example1">}}
{{< tab "GroupDocs.Assembly for .NET" >}}
```
PM> Install-Package GroupDocs.Assembly
```
{{< /tab >}}
{{< /tabs >}}

![Use Package Manager Console ](/assembly/net/images/getting-started/installation/package-manager-console.png)

### Use the .NET CLI

You can also use the [.NET CLI tool](https://docs.microsoft.com/en-us/dotnet/core/tools/) to install and update NuGet packages. Open a terminal in your project's folder and execute the following command to install the package:

{{< tabs "example2">}}
{{< tab "GroupDocs.Assembly for .NET" >}}
```
dotnet add package GroupDocs.Assembly
```
{{< /tab >}}
{{< /tabs >}}

## Download GroupDocs.Assembly from the official website

Visit [https://releases.groupdocs.com/assembly/net/](https://releases.groupdocs.com/assembly/net/) and download the **GroupDocs.Assembly** assemblies as a ZIP archive or MSI installer. To reference the downloaded assembly files in your project, do the following:

1. Extract files from the ZIP archive or run the MSI installer to install **GroupDocs.Assembly** to a specific location on your computer.
2. Open your solution or project in Visual Studio.
3. In **Solution Explorer**, right-click the **References** or **Dependencies** node, and select **Add Reference** (for a .NET Framework project) or **Add Project Reference** (for a .NET project).

    ![Add project reference in Visual Studio](/assembly/net/images/getting-started/installation/add-project-reference.png)

4. In the **Reference Manager** dialog box, select the **Browse** tab and click **Browse** to locate the _GroupDocs.Assembly.dll_ file for the target framework.

    ![Browse for the GroupDocs.Assembly assembly](/assembly/net/images/getting-started/installation/browse-for-groupdocs-dll.png)

5. Click **OK** to add a reference to the **GroupDocs.Assembly** library to your project.

{{< alert style="warning" >}}
If your application targets .NET Core / .NET 5+, ensure that your project has all the required dependencies installed. Refer to the following page for details: [GroupDocs.Assembly dependencies](https://www.nuget.org/packages/groupdocs.assembly#dependencies-body-tab).
{{< /alert >}}
---

## Installation

Path: /assembly/python-net/installation/

## Install using PyPI

All Python packages are hosted at [PyPI](https://pypi.org/project/groupdocs-assembly-net). You can easily reference GroupDocs.Assembly for Python via .NET API directly in your Python project by installing it with the following command.

```batch
pip install groupdocs.assembly
```

---

## Installation

Path: /comparison/java/installation/


### Operating Systems

**[GroupDocs.Comparison for Java](https://products.groupdocs.com/comparison/java)** can be executed on any Operating System with Java JDK installed.

- Windows Desktops and Servers
- Linux
- Mac OS

### Supported Runtime

**[GroupDocs.Comparison for Java](https://products.groupdocs.com/comparison/java)** supports Java run-time version 8 and above (Kotlin is supported as well).

### Development Environments

- NetBeans
- IntelliJ IDEA
- Eclipse

## Installation from GroupDocs Repository using Maven

GroupDocs hosts all Java APIs on [GroupDocs Repository](https://releases.groupdocs.com/java/repo/). You can easily use [GroupDocs.Comparison for Java](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-comparison/) API directly in your Maven projects with simple configurations.

### Specify GroupDocs Repository

First, you need to specify GroupDocs repository configuration/location in your Maven `pom.xml` as follows:

<details open><summary>Connect GroupDocs repository</summary><blockquote>
<details open><summary>Maven</summary>

<script src="https://gist.github.com/groupdocs-comparison-gists/9de00b81ae5dd326fc85fecb5c1220a6.js"></script>

</details>
<details><summary>Gradle</summary>

<script src="https://gist.github.com/groupdocs-comparison-gists/15f77ae825f310acd9cad555dcea0019.js"></script>

</details>
<details><summary>Kotlin</summary>

<script src="https://gist.github.com/groupdocs-comparison-gists/ad7ad48d4e7f9f60e858c7ba546f3745.js"></script>

</details>
</blockquote></details>

### Define Comparison Dependency

Then define **[GroupDocs.Comparison for Java](https://products.groupdocs.com/comparison/java)** API dependency in your `pom.xml` as follows:

_The latest version of Comparison API can be [found here](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-comparison/)_

<details open><summary>Add GroupDocs.Comparison dependency</summary><blockquote>
<details open><summary>Maven</summary>

<script src="https://gist.github.com/groupdocs-comparison-gists/f4d8f0b56d1dfa24dea18c68cd9d8001.js"></script>

</details>
<details><summary>Gradle</summary>

<script src="https://gist.github.com/groupdocs-comparison-gists/b760d58061daa45d9b211e2701aa52b5.js"></script>

</details>
<details><summary>Kotlin</summary>

<script src="https://gist.github.com/groupdocs-comparison-gists/b20a9f70c3442ca586a95b00a778a464.js"></script>

</details>
</blockquote></details>

After performing above-mentioned steps, GroupDocs.Comparison for Java dependency will finally be added to your Maven project.

---

## Installation

Path: /comparison/net/installation/


This topic describes how to add the GroupDocs.Comparison library to your .NET project. You can use a NuGet package to install this library or you can download necessary DLLs from the GroupDocs website: [https://releases.groupdocs.com/comparison/net/](https://releases.groupdocs.com/comparison/net/).

## Install GroupDocs.Comparison using NuGet packages

You can use the following tools to install the [GroupDocs.Comparison](https://www.nuget.org/packages/GroupDocs.Comparison) NuGet package: 

 * [NuGet Package Manager](#use-the-nuget-package-manager-in-visual-studio)
 * [Package Manager Console](#use-the-package-manager-console-in-visual-studio)
 * [.NET CLI](#use-the-net-cli)

### Use the NuGet Package Manager

Open your project or solution in Visual Studio and follow the steps below to install the GroupDocs.Comparison package using the [NuGet Package Manager](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio):

1. In **Solution Explorer**, right-click your project name and select **Manage NuGet Packages** to display the NuGet Package Manager.

2. Select the **Browse** tab and type `GroupDocs.Compariso` in the search box. Select the latest version of the GroupDocs.Comparison package and click **Install**.

    ![](/comparison/net/images/installation.png)

### Use the Package Manager Console

The [Package Manager Console](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell) uses the PowerShell commands to install, update, and remove NuGet packages. Open project in Visual Studio and click **Tools** -> **NuGet Package Manager** -> **Package Manager Console** to open the console window. To install the latest version of the GroupDocs.Comparison library, execute the following command:

{{< tabs "example1">}}
{{< tab "PowerShell" >}}
```
PM> Install-Package GroupDocs.Comparison
```
{{< /tab >}}
{{< /tabs >}}

![Use Package Manager Console ](/comparison/net/images/installation_1.png)

### Use the .NET CLI

You can use the [.NET CLI tool](https://docs.microsoft.com/en-us/dotnet/core/tools/) to install and update NuGet packages. In your project's folder, open a terminal and execute the following command to install the GroupDocs.Comparison package:

{{< tabs "example2">}}
{{< tab ".NET CLI" >}}
```
dotnet add package GroupDocs.Comparison
```
{{< /tab >}}
{{< /tabs >}}

## Download GroupDocs.Comparison from the official website

Visit [list of GroupDocs.Comparison releases](https://releases.groupdocs.com/comparison/net/) and download the GroupDocs.Comparison assemblies as a ZIP archive or MSI installer. To reference the downloaded assembly files in your project, follow these steps:

1. Extract files from the ZIP archive or run the MSI installer to install GroupDocs.Comparison to a specific location on your computer.
2. Open your solution or project in Visual Studio.
3. In **Solution Explorer**, right-click the **References** or **Dependencies** node, and select **Add Reference** (for a .NET Framework project) or **Add Project Reference** (for a .NET Core project).
4. In the **Reference Manager** dialog box, select the **Browse** tab and click **Browse** to locate the _GroupDocs.Comparison.dll_ file for the target framework.
5. Click **OK** to add a reference to the GroupDocs.Comparison library to your project.

{{< alert style="warning" >}}
If your application targets .NET Core / .NET 5+, ensure that your project has all the required dependencies installed. Refer to the following page for details: [GroupDocs.Comparison dependencies](https://www.nuget.org/packages/groupdocs.comparison#dependencies-body-tab).
{{< /alert >}}

---

## Install GroupDocs.Comparison for Node.js via Java

Path: /comparison/nodejs-java/installation/


### Prerequisites

- Node.js: 20 LTS or later
- Java: JRE/JDK 8+ (recommended 17 LTS)
- Build tools if needed by your environment (node-gyp toolchain)

See full details on the [System Requirements]({{< ref "comparison/nodejs-java/getting-started/system-requirements" >}}) page.

### Install from npm

All Java-bridged packages are hosted on npm. Install the library into your project using your preferred package manager:

```bash
# npm
npm install @groupdocs/groupdocs.comparison

# yarn
yarn add @groupdocs/groupdocs.comparison

# pnpm
pnpm add @groupdocs/groupdocs.comparison
```

### Set up Java (JAVA_HOME)

Ensure your Java installation is available on PATH and `JAVA_HOME` is set.

Windows (PowerShell):

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS (Bash):

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"
```

See the [System Requirements]({{< ref "comparison/nodejs-java/getting-started/system-requirements" >}}) page for more details.

### Verify installation

Create a small script (e.g., `check.js`) and run it with Node.js:

{{< tabs "check_installation" >}}

{{< tab "check.js" >}}  
{{< highlight javascript "" >}}

try {
  const comparison = require('@groupdocs/groupdocs.comparison');
  console.log('GroupDocs.Comparison loaded:', typeof comparison === 'object');
  console.log('Java bridge initialized successfully.');
} catch (e) {
  console.error('Failed to load GroupDocs.Comparison:', e);
  process.exit(1);
}

{{< /highlight >}}
{{< /tab >}}

{{< /tabs >}}


And than run the script to verify the installation:

```bash
node check.js
```

### Download from GroupDocs.Releases (offline)

You can download a package archive from [GroupDocs.Releases](https://releases.groupdocs.com/comparison/nodejs-java/#direct-download) and add it to your app. After downloading the `.tar` file, install it locally:

```bash
npm install ./groupdocs-groupdocs.comparison-<version>.tar
```

Alternatively, configure npm to use your corporate registry or proxy, then install using the standard command.

### Troubleshooting installation

- node-gyp toolchain not found: install the required build tools for your OS (see System Requirements).
- Java not detected: set `JAVA_HOME` and add `<JAVA_HOME>/bin` to `PATH`.
- Corporate proxy: configure npm proxy settings before running install.
- Permission errors: ensure you have write access to the project directory and cache folders.
---

## Install GroupDocs.Conversion for .NET

Path: /conversion/net/installation/


This topic describes how to add the **GroupDocs.Conversion** library to your .NET project. You can use a NuGet package to install this library or you can download necessary DLLs from the GroupDocs website: [https://downloads.groupdocs.com/conversion/net](https://downloads.groupdocs.com/conversion/net).  

## Install GroupDocs.Conversion using NuGet packages

There are two NuGet packages available depending on your target framework:

* [GroupDocs.Conversion](https://www.nuget.org/packages/GroupDocs.Conversion) - for .NET 6 and later
* [GroupDocs.Conversion.NETFramework](https://www.nuget.org/packages/GroupDocs.Conversion.NETFramework) - for .NET Framework 4.6.2 and later

You can use the following tools to install the appropriate NuGet package:

 * [NuGet Package Manager](#use-the-nuget-package-manager)
 * [Package Manager Console](#use-the-package-manager-console)
 * [.NET CLI](#use-the-net-cli)

### Use the NuGet Package Manager

Open your project or solution in Visual Studio and follow the steps below to install the **GroupDocs.Conversion** package using the [NuGet Package Manager](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio):

1. In **Solution Explorer**, right-click your project name and select **Manage NuGet Packages** to display the NuGet Package Manager.

    ![Manage NuGet packages in Visual Studio](/conversion/net/images/getting-started/installation/manage-nuget-packages.png)

2. Select the **Browse** tab and type **GroupDocs.Conversion** in the search box. Select the appropriate package for your target framework (**GroupDocs.Conversion** for .NET 6+ or **GroupDocs.Conversion.NETFramework** for .NET Framework) and click **Install**.

    ![Install NuGet packages in Visual Studio](/conversion/net/images/getting-started/installation/install-nuget-package.png)

### Use the Package Manager Console

The [Package Manager Console](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell) uses PowerShell commands to install, update, and remove NuGet packages. Open your project in Visual Studio and click **Tools** -> **NuGet Package Manager** -> **Package Manager Console** to open the console window. Run one of the following commands to install the latest version of the **GroupDocs.Conversion** library:

{{< tabs "example1">}}
{{< tab ".NET 6+" >}}
```shell
PM> Install-Package GroupDocs.Conversion
```
{{< /tab >}}
{{< tab ".NET Framework" >}}
```shell
PM> Install-Package GroupDocs.Conversion.NETFramework
```
{{< /tab >}}
{{< /tabs >}}

![Use Package Manager Console ](/conversion/net/images/getting-started/installation/package-manager-console.png)

### Use the .NET CLI

You can also use the [.NET CLI tool](https://docs.microsoft.com/en-us/dotnet/core/tools/) to install and update NuGet packages. This method is available for .NET 6+ projects. Open a terminal in your project's folder and execute the following command to install the **GroupDocs.Conversion** package:

{{< tabs "example2">}}
{{< tab ".NET CLI" >}}
```shell
dotnet add package GroupDocs.Conversion
```
{{< /tab >}}
{{< /tabs >}}

## Download GroupDocs.Conversion from the official website

Visit [https://releases.groupdocs.com/conversion/net/](https://releases.groupdocs.com/conversion/net/) and download the **GroupDocs.Conversion** assemblies as a ZIP archive or MSI installer. To reference the downloaded assembly files in your project, do the following:

1. Extract files from the ZIP archive or run the MSI installer to install **GroupDocs.Conversion** to a specific location on your computer.
2. Open your solution or project in Visual Studio.
3. In **Solution Explorer**, right-click the **References** or **Dependencies** node, and select **Add Reference** (for a .NET Framework project) or **Add Project Reference** (for a .NET project).
4. In the **Reference Manager** dialog box, select the **Browse** tab and click **Browse** to locate the _GroupDocs.Conversion.dll_ file for the target framework.

    ![Browse for the GroupDocs.Conversion assembly](/conversion/net/images/getting-started/installation/browse-for-groupdocs-dll.png)

5. Click **OK** to add a reference to the **GroupDocs.Conversion** library to your project.

{{< alert style="warning" >}}
If your application targets .NET 6+, ensure that your project has all the required dependencies installed. Refer to the following page for details: [GroupDocs.Conversion dependencies](https://www.nuget.org/packages/groupdocs.conversion#dependencies-body-tab).
{{< /alert >}}

---

## Install GroupDocs.Conversion for Node.js via Java

Path: /conversion/nodejs-java/installation/


### Prerequisites

- Node.js: 20 LTS or later
- Java: JRE/JDK 8+ (recommended 17 LTS)
- Build tools if needed by your environment (node-gyp toolchain)

See full details on the [System Requirements]({{< ref "conversion/nodejs-java/getting-started/system-requirements" >}}) page.

### Install from npm

All Java-bridged packages are hosted on npm. Install the library into your project using your preferred package manager:

```bash
# npm
npm install @groupdocs/groupdocs.conversion

# yarn
yarn add @groupdocs/groupdocs.conversion

# pnpm
pnpm add @groupdocs/groupdocs.conversion
```

### Set up Java (JAVA_HOME)

Ensure your Java installation is available on PATH and `JAVA_HOME` is set.

Windows (PowerShell):

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS (Bash):

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"
```

See the [System Requirements]({{< ref "conversion/nodejs-java/getting-started/system-requirements" >}}) page for more details.

### Verify installation

Create a small script (e.g., `check.js`) and run it with Node.js:

{{< tabs "check_installation" >}}

{{< tab "check.js" >}}  
{{< highlight javascript "" >}}

try {
  const conversion = require('@groupdocs/groupdocs.conversion');
  console.log('GroupDocs.Conversion loaded:', typeof conversion === 'object');
  console.log('Java bridge initialized successfully.');
} catch (e) {
  console.error('Failed to load GroupDocs.Conversion:', e);
  process.exit(1);
}

{{< /highlight >}}
{{< /tab >}}

{{< /tabs >}}


And then run the script to verify the installation:

```bash
node check.js
```

### Download from GroupDocs.Releases (offline)

You can download a package archive from [GroupDocs.Releases](https://releases.groupdocs.com/conversion/nodejs-java/#direct-download) and add it to your app. After downloading the `.tar` file, install it locally:

```bash
npm install ./groupdocs-conversion-<version>.tar
```

Alternatively, configure npm to use your corporate registry or proxy, then install using the standard command.

### Troubleshooting installation

- node-gyp toolchain not found: install the required build tools for your OS (see System Requirements).
- Java not detected: set `JAVA_HOME` and add `<JAVA_HOME>/bin` to `PATH`.
- Corporate proxy: configure npm proxy settings before running install.
- Permission errors: ensure you have write access to the project directory and cache folders.
---

## Installation

Path: /editor/java/installation/


## Install using Maven

All Java packages are hosted at [GroupDocs Artifact Repository](https://repository.groupdocs.com/). You can easily reference GroupDocs.Editor for Java API directly in your Maven project using following steps.

### Add GroupDocs Artifact Repository

First, you need to specify repository configuration/location in your project as follows:

{{< tabs "example1">}}
{{< tab "Maven" >}}
```xml
<repositories>
	<repository>
		<id>GroupDocs Artifact Repository</id>
        	<name>GroupDocs Artifact Repository</name>
        	<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
repositories {
    maven {
        url "https://repository.groupdocs.com/repo/"
    }
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
repositories {
    maven(url = "https://repository.groupdocs.com/repo/")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Editor as a dependency

Then define GroupDocs.Editor for Java API dependency in your `pom.xml` as follows:

{{< tabs "example2">}}
{{< tab "Maven" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-editor</artifactId>
        <version>26.1</version>
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
dependencies {
    implementation 'com.groupdocs:groupdocs-editor:26.1'
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
dependencies {
    implementation("com.groupdocs:groupdocs-editor:26.1")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<dependency org="com.groupdocs" name="groupdocs-editor" rev="26.1">
   <artifact name="groupdocs-editor" ext="jar"/>
</dependency>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
libraryDependencies += "com.groupdocs" % "groupdocs-editor" % "26.1"
```
{{< /tab >}}
{{< /tabs >}}

_The latest version of Editor API can be [found here](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-editor/)_

---

## Installation

Path: /editor/net/installation/

## Install from Nuget

NuGet is the easiest way to download and install GroupDocs.Editor for .NET. There are ways to install it in your project.

### Install via Package Manager GUI

Follow these steps to reference GroupDocs.Editor using Package Manager GUI:

*  Open your solution/project in Visual Studio.
* Click **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution**. You can also access the same option through the Solution Explorer. Right-click the solution or project and select Manage NuGet Packages from the context menu.
* Select **Browse** tab and type **"GroupDocs.Editor"** in the search text box.
* Click the **Install** button to install the latest version of the API into your project as shown in the following screenshot.
![](/editor/net/images/development-environment-installation-and-configuration.png)

### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Editor for .NET using the Package Manager Console:

* Open your solution/project in Visual Studio.
* Select **Tools** -> **NuGet Package Manager** -> **Package Manager Console** from the menu to open package manager console.
* Type the command "Install-Package GroupDocs.Editor" and press enter to install the latest release into your application.
* After successful installation, GroupDocs.Editor will be referenced in your application.
![](/editor/net/images/installation_1.png)
  
## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Editor for .NET downloaded from official website [Downloads section](https://downloads.groupdocs.com/editor/net):

1. Unpack zip archive or follow MSI install wizard instructions.
2. In the Solution Explorer, expand the project node you want to add a reference to.
3. Right-click the **References** node for the project and select **Add Reference** from the menu.
4. In the Add Reference dialog box, select the **.NET** tab (it's usually selected by default).
5. If you have used MSI installer to install GroupDocs.Editor, you will see GroupDocs.Editor in the top pane. Select it and then click the **Select** button.
6. If you have downloaded and unpacked the DLL only, click the **Browse** button and locate the GroupDocs.Editor.dll file. You have referenced GroupDocs.Editor and it should appear in the **SelectedComponents** pane of the dialog box.
7. Click **OK**. GroupDocs.Editor reference appears under the **References** node of the project.

---

## Installation

Path: /editor/nodejs-java/installation/



## Install using npm

All Node.js packages are hosted at [GroupDocs Artifact Repository](https://repository.groupdocs.com/). You can easily reference GroupDocs.Editor for Node.js API directly in your npm project using the following steps.

1. **Install GroupDocs.Editor for Node.js:**

   After configuring the repository, you can install the GroupDocs.Editor package using npm:
   ```sh
   npm install @groupdocs/editor
   ```

2. **Example usage:**

   Here is a basic example of how to use GroupDocs.Editor in your Node.js application:
   ```javascript
   const groupdocsEditor = require('@groupdocs/editor');

   // Create an instance of the Editor class
   const editor = new groupdocsEditor.Editor("path/to/document");

   // Get document information
   const documentInfo = editor.getDocumentInfo();
   console.log(documentInfo);

   // Convert document to HTML
   const htmlContent = editor.edit();
   console.log(htmlContent);

   // Save the edited HTML back to the original document format
   editor.save(htmlContent, "path/to/save/document");
   ```

By following these steps, you can integrate and use GroupDocs.Editor for Node.js in your projects. For more details, refer to the official [GroupDocs documentation](https://docs.groupdocs.com/editor/nodejs-java/).
---

## Install GroupDocs.Markdown for .NET

Path: /markdown/net/installation/


This topic describes how to add the **GroupDocs.Markdown** library to your .NET project.

## Install from NuGet

[GroupDocs.Markdown](https://www.nuget.org/packages/GroupDocs.Markdown) is available on NuGet. The main package is a meta-package that automatically pulls in the correct runtime package for your project's target framework.

### Using .NET CLI

Open a terminal in your project folder and run:

```bash
dotnet add package GroupDocs.Markdown
```

### Using Package Manager Console

In Visual Studio, open **Tools** > **NuGet Package Manager** > **Package Manager Console** and run:

```powershell
Install-Package GroupDocs.Markdown
```

### Using PackageReference

Add directly to your `.csproj` file:

```xml
<PackageReference Include="GroupDocs.Markdown" Version="26.3" />
```

## Runtime Packages

The NuGet package includes assemblies for four target frameworks:

| Target Framework | Runtime Package |
| --- | --- |
| .NET Framework 4.6.2 | GroupDocs.Markdown.Net462 |
| .NET 6.0 | GroupDocs.Markdown.Net60 |
| .NET 8.0 | GroupDocs.Markdown.Net80 |
| .NET 10.0 | GroupDocs.Markdown.Net100 |

In most cases, install only the main `GroupDocs.Markdown` package. NuGet will resolve the correct runtime package automatically. You can also install a specific runtime package directly if needed:

```bash
dotnet add package GroupDocs.Markdown.Net80
```

## Download from the Official Website

You can also download the assemblies as a ZIP archive or MSI installer from the [GroupDocs Releases](https://releases.groupdocs.com/markdown/net/) website.

1. Download the ZIP or MSI for the desired version.
2. Extract files (ZIP) or run the installer (MSI).
3. In your project, add a reference to the `GroupDocs.Markdown.dll` file for the target framework you need (e.g., `bin/net8.0/GroupDocs.Markdown.dll`).

## Verify Installation

After installing, verify that the package is accessible:

{{< tabs "verify-install" >}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// List all supported formats
foreach (FileFormat format in MarkdownConverter.GetSupportedFormats())
    Console.WriteLine(format);
```
{{< /tab >}}
{{< /tabs >}}

---

## Install GroupDocs.Markdown for Python via .NET

Path: /markdown/python-net/installation/


This topic describes how to add the **GroupDocs.Markdown** library to your Python project.

## Install from PyPI

[groupdocs-markdown-net](https://pypi.org/project/groupdocs-markdown-net/) is available on PyPI. Install it with pip:

```bash
pip install groupdocs-markdown-net
```

To install a specific version:

```bash
pip install groupdocs-markdown-net==26.3
```

## Install in a virtual environment

It is recommended to use a virtual environment to avoid dependency conflicts:

```bash
python -m venv .venv
source .venv/bin/activate        # Linux/macOS
# .venv\Scripts\activate         # Windows

pip install groupdocs-markdown-net
```

## Verify Installation

After installing, verify that the package is accessible:

```python
from groupdocs.markdown import MarkdownConverter

# List all supported formats
formats = MarkdownConverter.get_supported_formats()
for fmt in formats:
    print(fmt)
```

---

## Install GroupDocs.Merger for Node.js via Java

Path: /merger/nodejs-java/installation/


## Install using NPM

All Java packages are hosted at [NPM](https://www.npmjs.com/package/@groupdocs/groupdocs.merger). You can easily reference GroupDocs.Merger for Node.js via Java API directly in your Node.js project by installing it with the following command.

```batch
npm install @groupdocs/groupdocs.merger
```


---

## Install GroupDocs.Merger for Python via .NET

Path: /merger/python-net/installation/


## Install using Pypi repository

Fetch the package and install GroupDocs.Merger. Run this command: 
```batch
pip install groupdocs.merger
```

If you already have GroupDocs.Merger installed and want to get the latest version, you have to run:
```batch
pip install --upgrade groupdocs.merger
```

---

## Installation

Path: /metadata/net/installation/

## Installing GroupDocs.Metadata for .NET through NuGet

NuGet is the easiest way to download and install GroupDocs.Metadata for .NET. Following are the couple of ways to install GroupDocs.Metadata for .NET in your project using NuGet.
To install, you can use any of the commands suitable for your environment [NugetInstall](https://www.nuget.org/packages/GroupDocs.Metadata).
Below are examples of how to install when using Visual Studio.

### Using Package Manager GUI

Follow these steps to reference GroupDocs.Metadata using Package Manager GUI:

*   Open your solution/project in Visual Studio.
*   Click **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution**. You can also access the same option through the Solution Explorer. Right-click the solution or project and select **Manage NuGet Packages** from the context menu.
*   Select **Browse** tab and type "GroupDocs.Metadata" in the search text box.
*   Click the **Install** button to install the latest version of the API into your project as shown in the following screenshot.

![](/metadata/net/images/installation.png)

### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Metadata using the Package Manager Console:

*   Open your solution/project in Visual Studio.
*   Select **Tools** -> **NuGet Package Manager** -> **Package Manager Console** from the menu to open package manager console.
*   Type the command "Install-Package GroupDocs.Metadata" and press enter to install the latest release into your application.
*   After successful installation, GroupDocs.Metadata will be referenced in your application.

![](/metadata/net/images/installation_1.png)

---

## Installation

Path: /metadata/nodejs-java/installation/

## Install using NPM

All Java packages are hosted at [NPM](https://www.npmjs.com/package/@groupdocs/groupdocs.metadata). You can easily reference GroupDocs.Metadata for Node.js via Java API directly in your Node.js project by installing it with the following command.

```batch
npm install @groupdocs/groupdocs.metadata
```

---

## Installation

Path: /metadata/python-net/installation/

## Install using Python

All Python packages are hosted at [PyPI](https://pypi.org/project/groupdocs-metadata-net). You can easily reference GroupDocs.Metadata for Python via .NET API directly in your Python project by installing it with the following command.

```batch
pip install groupdocs.metadata
```

---

## Installation

Path: /parser/java/installation/

## Installation from GroupDocs Repository using Maven

GroupDocs hosts all Java APIs on [GroupDocs Repository](https://releases.groupdocs.com/java/repo/). You can easily use [GroupDocs.Parser for Java](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-parser/) API directly in your Maven projects with simple configurations.

### Specify GroupDocs Repository Configuration

First, you need to specify GroupDocs repository configuration/location in your Maven `pom.xml` as follows:

```xml
<repositories>
    <repository>
        <id>GroupDocsJavaAPI</id>
        <name>GroupDocs Java API</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>
```

### Define GroupDocs.Parser for Java API Dependency

Then define GroupDocs.Parser for Java API dependency in your `pom.xml` as follows:

```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-parser</artifactId>
        <version>19.11</version>
    </dependency>
</dependencies>
```

After performing above-mentioned steps, GroupDocs.Parser for Java dependency will finally be added to your Maven project.

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Parser for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/parser/java):

1.  Unpack zip archive .
2.  Switch to **lib** folder.
3.  Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4.  After this you should add the GroupDocs.Parser for Java **dependency** block to your .pom.xml project file.

---

## Installation

Path: /parser/net/installation/

## Prerequisites

### Framework Requirements

GroupDocs.Parser for .NET supports the following frameworks:

| Framework | Minimum Version | Package |
|-----------|----------------|---------|
| .NET Framework | 4.6.1 | `GroupDocs.Parser.Framework` |
| .NET Core | 2.0 | `GroupDocs.Parser` |
| .NET Standard | 2.0 | `GroupDocs.Parser` |
| .NET | 5.0+ | `GroupDocs.Parser` |

{{< alert style="info" >}}
**For .NET Framework 4.5 and earlier:** You need to upgrade to .NET Framework 4.6.1 or higher, or target .NET Standard 2.0 compatible packages. GroupDocs.Parser requires .NET Standard 2.0 compatibility.
{{< /alert >}}

## Install from NuGet

NuGet is the easiest way to download and install GroupDocs.Parser for .NET. There are multiple ways to install it in your project.

#### Install via Package Manager GUI

Follow these steps to reference GroupDocs.Parser using Package Manager GUI:

*   Open your solution/project in Visual Studio.
*   Click Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution.  
    You can also access the same option through the Solution Explorer. Right-click the solution or project and select Manage NuGet Packages from the context menu
*   Select Browse tab and type "GroupDocs.Parser" in the search text box.
*   Click the Install button to install the latest version of the API into your project as shown in the following screenshot.

![](/parser/net/images/installation.png)

#### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Parser for .NET using the Package Manager Console:

*   Open your solution/project in Visual Studio.
*   Select Tools -> NuGet Package Manager -> Package Manager Console from the menu to open package manager console.
*   Type the command based on your target framework:
    - For .NET Core/.NET 5+: `Install-Package GroupDocs.Parser`
    - For .NET Framework: `Install-Package GroupDocs.Parser.Framework`
*   Press enter to install the latest release into your application.
*   After successful installation, GroupDocs.Parser will be referenced in your application.

#### Using .NET CLI (.NET Core/.NET 5+)

For .NET Core, .NET 5, .NET 6, or later projects:

```bash
# Create a new console project
dotnet new console -n MyParserApp
cd MyParserApp

# Add the package
dotnet add package GroupDocs.Parser

# Restore packages
dotnet restore
```

#### Quick Start with .NET Core

Here's a complete example for setting up a .NET Core project:

```bash
# 1. Create new project
dotnet new console -n GroupDocsParserDemo
cd GroupDocsParserDemo

# 2. Install package
dotnet add package GroupDocs.Parser

# 3. Run the project
dotnet run
```

Then update `Program.cs`:

```csharp
using GroupDocs.Parser;

namespace GroupDocsParserDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            using (Parser parser = new Parser("sample.pdf"))
            {
                using (var reader = parser.GetText())
                {
                    if (reader != null)
                    {
                        Console.WriteLine(reader.ReadToEnd());
                    }
                }
            }
        }
    }
}
```

![](/parser/net/images/installation_1.png)

![](/parser/net/images/installation_2.png)

Starting with 24.2 version, GroupDocs.Parser is divided into two packages - for .NET Framework and .NET Standard. GroupDocs.Parser for .NET Framework package is recommended for using with .NET Framework projects. GroupDocs.Parser package is designed to work with .NET projects. You need to [configure binding redirection](https://stackoverflow.com/questions/43365736/assembly-binding-redirect-how-and-why) to make it work with .NET Framework. For regular .NET Framework project it's required to [enable automatic binding redirection](https://learn.microsoft.com/en-us/dotnet/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection). For unit tests projects you also need to specify `GenerateBindingRedirectsOutputType` in the project file:

```
<PropertyGroup>
    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
    <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
</PropertyGroup>
```

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Parser for .NET downloaded from official website Downloads section:

*   Unpack zip archive or follow MSI install wizard instructions.
*   In the Solution Explorer, expand the project node you want to add a reference to.
*   Right-click the References node for the project and select Add Reference from the menu.
*   In the Add Reference dialog box, select the .NET tab (it's usually selected by default).
*   If you have used MSI installer to install GroupDocs.Parser, you will see GroupDocs.Parser in the top pane. Select it and then click the Select button.
*   If you have downloaded and unpacked the DLL only, click the Browse button and locate the GroupDocs.Parser.dll file.
*   You have referenced GroupDocs.Parser and it should appear in the SelectedComponents pane of the dialog box.
*   Click OK.

GroupDocs.Parser reference appears under the References node of the project.

Note that .NET Standard 2.0 version has external references:

| Package | Version |
| --- | --- |
| System.Drawing.Common                  | 4.7.0  |
| System.Text.Encoding.CodePages         | 4.7.0  |
| System.Reflection.Emit                 | 4.7.0  |
| System.Reflection.Emit.ILGeneration    | 4.7.0  |
| System.Diagnostics.PerformanceCounter  | 4.5.0  |
| System.Security.Cryptography.Pkcs      | 4.7.0  |
| System.Security.Permissions            | 4.5.0  |
| Microsoft.Win32.Registry               | 4.7.0  |
| Microsoft.Extensions.DependencyModel   | 2.0.4  |
| SkiaSharp                              | 2.80.1 |

## Linux environment

For correct working of GroupDocs.Parser.Net on Linux the following packages need to be installed:

* libgdiplus package
* libc6-dev package
* package with Microsoft compatible fonts: ttf-mscorefonts-installer. (e.g. sudo apt-get install ttf-mscorefonts-installer)

Also GroupDocs.Parser.Net in Linux environment has external reference:

| Package | Version |
| --- | --- |
| SkiaSharp.NativeAssets.Linux.NoDependencies | 2.80.2 |
---

## Installation

Path: /redaction/java/installation/


GroupDocs.Redaction for Java is distributed via the [GroupDocs Repository](https://releases.groupdocs.com/java/repo/). You can easily add it to your project using any Java build tool (Maven, Gradle, Kotlin, Ivy, or Sbt) with simple configuration.

> **Note:** The current version shown below is **25.12**. Always check the [releases page](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-redaction/) for the latest version.

### Specify GroupDocs Repository Configuration

First, you need to specify repository configuration/location in your project as follows:

{{< tabs "example1">}}
{{< tab "Maven" >}}
```xml
<repositories>
	<repository>
		<id>GroupDocs Artifact Repository</id>
        	<name>GroupDocs Artifact Repository</name>
        	<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
repositories {
    maven {
        url "https://releases.groupdocs.com/java/repo/"
    }
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
repositories {
    maven(url = "https://releases.groupdocs.com/java/repo/")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Redaction as a dependency

Then define GroupDocs.Redaction for Java API dependency in your project as follows:

{{< tabs "example2">}}
{{< tab "Maven" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-redaction</artifactId>
        <version>25.12</version>
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
dependencies {
    implementation 'com.groupdocs:groupdocs-redaction:25.12'
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
dependencies {
    implementation("com.groupdocs:groupdocs-redaction:25.12")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<dependency org="com.groupdocs" name="groupdocs-redaction" rev="25.12">
   <artifact name="groupdocs-redaction" ext="jar"/>
</dependency>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
libraryDependencies += "com.groupdocs" % "groupdocs-redaction" % "25.12"
```
{{< /tab >}}
{{< /tabs >}}

## Verification

After performing the above steps, GroupDocs.Redaction for Java dependency will be added to your project. Verify the installation by:

1. **Building your project:**
   ```bash
   mvn clean install
   # or
   ./gradlew build
   ```

2. **Checking dependencies:**
   ```bash
   mvn dependency:tree | grep groupdocs-redaction
   # or
   ./gradlew dependencies | grep groupdocs-redaction
   ```

## Next Steps

- Review [System Requirements]({{< ref "redaction/java/getting-started/system-requirements.md" >}}) to ensure compatibility
- Check [Supported Document Formats]({{< ref "redaction/java/getting-started/supported-document-formats.md" >}})
- Learn how to [Run Examples]({{< ref "redaction/java/getting-started/how-to-run-examples.md" >}})

---

## Installation

Path: /redaction/net/installation/

  

## Install from NuGet

NuGet is the easiest way to download and install GroupDocs.Redaction for .NET. There are ways to install it in your project.

#### Install via Package Manager GUI

Follow these steps to reference GroupDocs.Redaction using Package Manager GUI:

*   Open your solution/project in Visual Studio.
    
*   Click Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution. You can also access the same option through the Solution Explorer. Right-click the solution or project and select Manage NuGet Packages from the context menu
    
*   Select Browse tab and type "GroupDocs.Redaction" in the search text box.
    
*   Click the Install button to install the latest version of the API into your project as shown in the following screenshot.  
      
    

![](/redaction/net/images/installation.png)

#### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Redaction for .NET using the Package Manager Console:

*   Open your solution/project in Visual Studio.
    
*   Select Tools -> NuGet Package Manager -> Package Manager Console from the menu to open package manager console.
    
*   Type the command "Install-Package GroupDocs.Redaction" and press enter to install the latest release into your application.
    

After successful installation, GroupDocs.Redaction will be referenced in your application.  
  
![](/redaction/net/images/installation_1.png)

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Redaction for .NET downloaded from official website [Downloads section](https://downloads.groupdocs.com/redaction/net):

1.  Unpack zip archive or follow MSI install wizard instructions.
2.  In the Solution Explorer, expand the project node you want to add a reference to.
3.  Right-click the **References** node for the project and select **Add Reference** from the menu.
4.  In the Add Reference dialog box, select the **.NET** tab (it's usually selected by default).
5.  If you have used MSI installer to install GroupDocs.Redaction, you will see GroupDocs.Redaction in the top pane. Select it and then click the **Select** button.
6.  If you have downloaded and unpacked the DLL only, click the **Browse** button and locate the GroupDocs.Redaction.dll file.   
    You have referenced GroupDocs.Redaction and it should appear in the **SelectedComponents** pane of the dialog box.
7.  Click **OK**.   
    GroupDocs.Redaction reference appears under the **References** node of the project.

---

## Installation

Path: /signature/java/installation/


## Operating Systems

**[GroupDocs.Signature for Java](https://products.groupdocs.com/signature/java)** can be executed on any Operating System with Java JDK installed.

- Windows Desktops and Servers
- Linux
- Mac OS

## Supported Runtime

**[GroupDocs.Signature for Java](https://products.groupdocs.com/signature/java)** supports Java run-time version 8 and above (Kotlin is supported as well).

## Development Environments

- NetBeans
- IntelliJ IDEA
- Eclipse

## Installation from GroupDocs Repository

All Java packages are hosted at [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/). You can easily reference [GroupDocs.Signature for Java API](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-signature/) directly in your project using following steps.

### Add GroupDocs Artifact Repository

First, you need to specify repository configuration/location in your project as follows:

{{< tabs "example1">}}
{{< tab "Maven" >}}
```xml
<repositories>
	<repository>
		<id>GroupDocs Artifact Repository</id>
        	<name>GroupDocs Artifact Repository</name>
        	<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
repositories {
    maven {
        url "https://repository.groupdocs.com/repo/"
    }
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
repositories {
    maven(url = "https://repository.groupdocs.com/repo/")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Signature as a dependency

Then define GroupDocs.Signature for Java API dependency in your project as follows:

{{< tabs "example2">}}
{{< tab "Maven" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-signature</artifactId>
        <version>24.3</version>
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
dependencies {
    implementation 'com.groupdocs:groupdocs-signature:24.3'
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
dependencies {
    implementation("com.groupdocs:groupdocs-signature:24.3")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<dependency org="com.groupdocs" name="groupdocs-signature" rev="24.3">
   <artifact name="groupdocs-signature" ext="jar"/>
</dependency>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
libraryDependencies += "com.groupdocs" % "groupdocs-signature" % "24.3"
```
{{< /tab >}}
{{< /tabs >}}

_The latest version of Signature API can be [found here](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-signature/)_


---

## Installation

Path: /signature/net/installation/

## Install from Nuget

NuGet is the easiest way to download and install GroupDocs.Signature for .NET. There are ways to install it in your project.

### Install via Package Manager GUI

Follow these steps to reference GroupDocs.Signature using Package Manager GUI:

* Open your solution/project in Visual Studio.
* Click **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution**. You can also access the same option through the Solution Explorer. Right-click the solution or project and select Manage NuGet Packages from the context menu
* Select **Browse** tab and type **"GroupDocs.Signature"** in the search text box.
* Click the **Install** button to install the latest version of the API into your project as shown in the following screenshot.  

![Installation](/signature/net/images/installation.png)

#### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Signature for .NET using the Package Manager Console:

* Open your solution/project in Visual Studio.
* Select **Tools** -> **NuGet Package Manager** -> **Package Manager Console** from the menu to open package manager console.
* Type the command "Install-Package GroupDocs.Signature" and press enter to install the latest release into your application.
* After successful installation, GroupDocs.Signature will be referenced in your application.  

![Installation](/signature/net/images/installation_1.png)

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Signature for .NET downloaded from official website [Downloads section](https://downloads.groupdocs.com/signature/net):

1. Unpack zip archive or follow MSI install wizard instructions.
2. In the Solution Explorer, expand the project node you want to add a reference to.
3. Right-click the **References** node for the project and select **Add Reference** from the menu.
4. In the Add Reference dialog box, select the **.NET** tab (it's usually selected by default).
5. If you have used MSI installer to install GroupDocs.Signature, you will see GroupDocs.Signature in the top pane. Select it and then click the **Select** button.
6. If you have downloaded and unpacked the DLL only, click the **Browse** button and locate the GroupDocs.Signature.dll file. You have referenced GroupDocs.Signature and it should appear in the **SelectedComponents** pane of the dialog box.
7. Click **OK**.

GroupDocs.Signature reference appears under the **References** node of the project.

---

## Installation

Path: /signature/nodejs-java/installation/

## Install using NPM

All Java packages are hosted at NPM. You can easily reference GroupDocs.Signature for Node.js via Java API directly in your Node.js project by installing it with the following command.

```xml
npm install @groupdocs/groupdocs.signature
```





---

## Install GroupDocs.Total for Java

Path: /total/java/installation/


{{< alert style="info" >}}

Starting from [GroupDocs.Total for Java 24.6](https://releases.groupdocs.com/total/java/release-notes/2024/groupdocs-total-for-java-24-6-release-notes/), the JAR package is signed using a GPG signature. You can find the public key in the [GPG-KEYS.txt](https://releases.groupdocs.com/java/repo/com/groupdocs/GPG-KEYS.txt) file. Learn more about verifying signatures in the [Making and verifying signatures](https://www.gnupg.org/gph/en/manual/x135.html) article.

{{< /alert >}}

## Install using Maven

All GroupDocs packages are hosted at [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-total/). You can download packages or reference GroupDocs.Total for Java API directly in your Maven project using following steps.

{{< alert style="tip" >}}

[Download](/total/java/sample-apps/getting-started/installation/maven-app.zip) a sample Maven application that demonstrates using GroupDocs.Total for Java. You can run the application locally with `mvn compile exec:java` command.

{{< /alert >}}

### Add GroupDocs Artifact Repository

Add GroupDocs Artifact Repository to your `pom.xml` file:

{{< tabs "pom-repository">}}
{{< tab "pom.xml" >}}
```xml
<repositories>
    <repository>
        <id>GroupDocs Artifact Repository</id>
        <name>GroupDocs Artifact Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Total as a dependency

Define GroupDocs.Total for Java API dependency in your `pom.xml`:

{{< tabs "pom-dependency">}}
{{< tab "pom.xml" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-total</artifactId>
        <version>24.10</version> 
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< /tabs >}}

## Reference in Java application

To get started, download the latest version of GroupDocs.Total for Java (JAR file) from [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-total/). Also, make sure you have [Java](https://www.oracle.com/java/technologies/downloads/) installed.

### Create application

{{< alert style="tip" >}}

You can [download](/total/java/sample-apps/getting-started/installation/java-app.zip) the sample application and proceed to building it.

{{< /alert >}}

{{< tabs "java-app">}}
{{< tab "App.java" >}}
```java
import com.groupdocs.total.Total;
import com.groupdocs.total.options.*;

public class App {
    public static void main(String[] args) throws Exception {
        Total total = new Total("formatting.docx");
        total.view(HtmlViewOptions.forEmbeddedResources());
        total.close();
    }
}
```
{{< /tab >}}
{{< tab "formatting.docx" >}}
{{< tab-text >}}
`formatting.docx` is sample DOCX file that we're going to use in this example. Click [here](/total/java/sample-files/getting-started/installation/formatting.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "groupdocs-total.jar" >}}
{{< tab-text >}}
`groupdocs-total.jar` is GroupDocs.Total for Java JAR file e.g., [groupdocs-total-24.10.jar](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-total/24.10/groupdocs-total-24.10.jar).
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 java-app
 ├──App.java
 ├──formatting.docx
 └──groupdocs-total.jar
```

### Build application

To build Java application run the command below. This command compiles the application and creates `App.class` file in the current directory.

{{< tabs "java-app-build">}}
{{< tab "Windows" >}}
```bash
javac -d . -cp ".;./groupdocs-total.jar" App.java
```
{{< /tab >}}
{{< tab "Linux" >}}
```bash
javac -d . -cp ".:./groupdocs-total.jar" App.java
```
{{< /tab >}}
{{< /tabs >}}

### Run application

To run the application type the command below. As a result two HTML documents will be created in the current directory for the first two pages of the document.

{{< tabs "java-app-run">}}
{{< tab "Windows" >}}
```bash
java -cp ".;./groupdocs-total.jar" App
```
{{< /tab >}}
{{< tab "Linux" >}}
```bash
java -Djava.awt.headless=true -cp ".:./groupdocs-total.jar" App
```

{{< tab-text >}}
Please note that `-Djava.awt.headless=true` required when your Java installation does not include GUI libraries.
{{< /tab-text >}}

{{< /tab >}}
{{< /tabs >}}

---

## Install GroupDocs.Total for .NET

Path: /total/net/installation/


This topic describes how to add the **GroupDocs.Total** library to your .NET project. You can use a NuGet package to install this library or you can download necessary DLLs from the GroupDocs website: [https://releases.groupdocs.com/total/net/](https://releases.groupdocs.com/total/net/).

### Select GroupDocs.Total package and version

<div class="gdoc-two-columns">
    <div class="gdoc-two-columns__column">
        <ul class="gdoc-two-columns__column__list">
            <li>
                <div>
                    <svg class="gdoc-two-columns__column__icon"><use xlink:href="/img/groupdocs-stack.svg#nuget"></use></svg>
                </div>
                <div>
                    <a class="gdoc-two-columns__column__link"
                        href="https://www.nuget.org/packages/GroupDocs.Total">GroupDocs.Total</a>
                    <div class="gdoc-two-columns__column__descr">
                        - .NET Standard 6.0 assembly.
                        <br>
                        - .NET Standard 2.0 in versions prior to 24.9.
                    </div>
                </div>
            </li>
        </ul>
    </div>
    <div class="gdoc-two-columns__column">
        <ul class="gdoc-two-columns__column__list">
            <li>
                <div>
                <svg class="gdoc-two-columns__column__icon"><use xlink:href="/img/groupdocs-stack.svg#nuget"></use></svg>
                </div>
                <div>
                    <a class="gdoc-two-columns__column__link"
                        href="https://www.nuget.org/packages/GroupDocs.Total.NETFramework">GroupDocs.Total.NETFramework</a>
                        <div class="gdoc-two-columns__column__descr">
                        - .NET Framework assembly.
                        <br>
                        - .NET Framework 4.6.2 and later.
                    </div>
                </div>
            </li>
        </ul>
    </div>
</div>

You can also use GroupDocs.Total with .NET Framework 2.0 (Visual Studio 2005-2008), .NET Framework 4.0 (Visual Studio 2010), and later .NET Framework versions by selecting one of the previous versions of the GroupDocs.Total package. See the complete list of package versions and supported frameworks in the table below.

{{< tabs "package-versions">}}
{{< tab "GroupDocs.Total" >}}

| Package version | Target frameworks |
| --- | --- |
| [26.3](https://www.nuget.org/packages/GroupDocs.Total/26.3) | .NET 6.0 |
| [25.12](https://www.nuget.org/packages/GroupDocs.Total/25.12) | .NET 6.0 |
| [25.11](https://www.nuget.org/packages/GroupDocs.Total/25.11) | .NET 6.0 |
| [25.9](https://www.nuget.org/packages/GroupDocs.Total/25.9) | .NET 6.0 |
| [25.8](https://www.nuget.org/packages/GroupDocs.Total/25.8) | .NET 6.0 |
| [25.7](https://www.nuget.org/packages/GroupDocs.Total/25.7) | .NET 6.0 |
| [25.6](https://www.nuget.org/packages/GroupDocs.Total/25.6) | .NET 6.0 |
| [25.5](https://www.nuget.org/packages/GroupDocs.Total/25.5) | .NET 6.0 |
| [25.4](https://www.nuget.org/packages/GroupDocs.Total/25.4) | .NET 6.0 |
| [25.3](https://www.nuget.org/packages/GroupDocs.Total/25.3) | .NET 6.0 |
| [25.2](https://www.nuget.org/packages/GroupDocs.Total/25.2) | .NET 6.0 |
| [25.1](https://www.nuget.org/packages/GroupDocs.Total/25.1) | .NET 6.0 |
| [24.12](https://www.nuget.org/packages/GroupDocs.Total/24.12) | .NET 6.0 |
| [24.11.1](https://www.nuget.org/packages/GroupDocs.Total/24.11.1) | .NET 6.0 |
| [24.11.0](https://www.nuget.org/packages/GroupDocs.Total/24.11.0) | .NET 6.0 |
| [24.10.0](https://www.nuget.org/packages/GroupDocs.Total/24.10.0) | .NET 6.0 |
| [24.9.1](https://www.nuget.org/packages/GroupDocs.Total/24.9.1) | .NET 6.0 |
| [24.8.0](https://www.nuget.org/packages/GroupDocs.Total/24.8.0) | .NET Standard 2.0 |
| [24.7.0](https://www.nuget.org/packages/GroupDocs.Total/24.7.0) | .NET Standard 2.0 |
| [24.6.0](https://www.nuget.org/packages/GroupDocs.Total/24.6.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [24.5.0](https://www.nuget.org/packages/GroupDocs.Total/24.5.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [24.4.0](https://www.nuget.org/packages/GroupDocs.Total/24.4.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [24.3.0](https://www.nuget.org/packages/GroupDocs.Total/24.3.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [24.2.0](https://www.nuget.org/packages/GroupDocs.Total/24.2.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [24.1.0](https://www.nuget.org/packages/GroupDocs.Total/24.1.0) | .NET Framework 4.6.2, .NET Standard 2.0 |

<details>
<summary>See previous versions</summary>

| Package version | Target frameworks |
| --- | --- |
| [23.12.0](https://www.nuget.org/packages/GroupDocs.Total/23.12.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [23.11.0](https://www.nuget.org/packages/GroupDocs.Total/23.11.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [23.10.0](https://www.nuget.org/packages/GroupDocs.Total/23.10.0) | .NET Framework 4.6.2, .NET Standard 2.0 |
| [23.9.0](https://www.nuget.org/packages/GroupDocs.Total/23.9.0) | .NET Framework 4.6.1, .NET Standard 2.0 |
| [23.8.0](https://www.nuget.org/packages/GroupDocs.Total/23.8.0) | .NET Framework 4.6.1, .NET Standard 2.0 |
| [23.7.0](https://www.nuget.org/packages/GroupDocs.Total/23.7.0) | .NET Framework 4.6.1, .NET Standard 2.0 |
| [23.6.0](https://www.nuget.org/packages/GroupDocs.Total/23.6.0) | .NET Framework 4.6.1, .NET Standard 2.0 |
| [23.5.0](https://www.nuget.org/packages/GroupDocs.Total/23.5.0) | .NET Framework 4.6.1, .NET Standard 2.1 |
| [23.4.0](https://www.nuget.org/packages/GroupDocs.Total/23.4.0) | .NET Framework 4.6.1, .NET Standard 2.1 |
| [23.3.0](https://www.nuget.org/packages/GroupDocs.Total/23.3.0) | .NET Framework 4.6.1, .NET Standard 2.1 |
| [23.2.0](https://www.nuget.org/packages/GroupDocs.Total/23.2.0) | .NET Framework 4.6.1, .NET Standard 2.1 |
| [23.1.0](https://www.nuget.org/packages/GroupDocs.Total/23.1.0) | .NET Framework 4.6.1, .NET Standard 2.1 |
| [22.12.0](https://www.nuget.org/packages/GroupDocs.Total/22.12.0) | .NET Framework 4.6.1, .NET Standard 2.1 |
| [22.11.0](https://www.nuget.org/packages/GroupDocs.Total/22.11.0) | .NET Framework 4.5, .NET Standard 2.1 |
| [22.10.0](https://www.nuget.org/packages/GroupDocs.Total/22.10.0) | .NET Framework 4.5, .NET Standard 2.1 |
| [22.9.0](https://www.nuget.org/packages/GroupDocs.Total/22.9.0) | .NET Framework 4.5, .NET Standard 2.1 |
| [22.8.0](https://www.nuget.org/packages/GroupDocs.Total/22.8.0) | .NET Framework 4.5, .NET Standard 2.1 |
| [22.7.1](https://www.nuget.org/packages/GroupDocs.Total/22.7.1) | .NET Framework 4.5, .NET Standard 2.1 |
| [22.7.0](https://www.nuget.org/packages/GroupDocs.Total/22.7.0) | .NET Framework 4.5, .NET Standard 2.1 |
| [22.4.0](https://www.nuget.org/packages/GroupDocs.Total/22.4.0) | .NET Framework 3.5, .NET Standard 2.1 |
| [22.1.0](https://www.nuget.org/packages/GroupDocs.Total/22.1.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.12.0](https://www.nuget.org/packages/GroupDocs.Total/21.12.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.11.0](https://www.nuget.org/packages/GroupDocs.Total/21.11.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.10.0](https://www.nuget.org/packages/GroupDocs.Total/21.10.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.9.0](https://www.nuget.org/packages/GroupDocs.Total/21.9.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.7.0](https://www.nuget.org/packages/GroupDocs.Total/21.7.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.6.0](https://www.nuget.org/packages/GroupDocs.Total/21.6.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.5.0](https://www.nuget.org/packages/GroupDocs.Total/21.5.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.4.0](https://www.nuget.org/packages/GroupDocs.Total/21.4.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.3.0](https://www.nuget.org/packages/GroupDocs.Total/21.3.0) | matapackage |
| [21.2.0](https://www.nuget.org/packages/GroupDocs.Total/21.2.0) | matapackage |
| [21.1.0](https://www.nuget.org/packages/GroupDocs.Total/21.1.0) | matapackage |
| [20.12.0](https://www.nuget.org/packages/GroupDocs.Total/20.12.0) | matapackage |
| [20.11.0](https://www.nuget.org/packages/GroupDocs.Total/20.11.0) | matapackage |
| [20.10.0](https://www.nuget.org/packages/GroupDocs.Total/20.10.0) | matapackage |
| [20.9.0](https://www.nuget.org/packages/GroupDocs.Total/20.9.0) | matapackage |
| [20.8.0](https://www.nuget.org/packages/GroupDocs.Total/20.8.0) | matapackage |
| [20.7.2](https://www.nuget.org/packages/GroupDocs.Total/20.7.2) | matapackage |
| [20.7.1](https://www.nuget.org/packages/GroupDocs.Total/20.7.1) | matapackage |
| [20.7.0](https://www.nuget.org/packages/GroupDocs.Total/20.7.0) | matapackage |
| [20.6.1](https://www.nuget.org/packages/GroupDocs.Total/20.6.1) | matapackage |
| [20.6.0](https://www.nuget.org/packages/GroupDocs.Total/20.6.0) | matapackage |
| [20.5.1](https://www.nuget.org/packages/GroupDocs.Total/20.5.1) | matapackage |
| [20.5.0](https://www.nuget.org/packages/GroupDocs.Total/20.5.0) | matapackage |
| [20.4.0](https://www.nuget.org/packages/GroupDocs.Total/20.4.0) | matapackage |
| [20.3.1](https://www.nuget.org/packages/GroupDocs.Total/20.3.1) | matapackage |
| [20.3.0](https://www.nuget.org/packages/GroupDocs.Total/20.3.0) | matapackage |
| [20.2.0](https://www.nuget.org/packages/GroupDocs.Total/20.2.0) | matapackage |
| [20.1.1](https://www.nuget.org/packages/GroupDocs.Total/20.1.1) | matapackage |
| [20.1.0](https://www.nuget.org/packages/GroupDocs.Total/20.1.0) | matapackage |
| [19.12.1](https://www.nuget.org/packages/GroupDocs.Total/19.12.1) | matapackage |
| [19.12.0](https://www.nuget.org/packages/GroupDocs.Total/19.12.0) | matapackage |

</details>

{{< /tab >}}
{{< tab "GroupDocs.Total.NETFramework" >}}

| Package version | Target frameworks |
| --- | --- |
| [26.3.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/26.3.0) | .NET Framework 4.6.2 |
| [25.12.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.12.0) | .NET Framework 4.6.2 |
| [25.11.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.11.0) | .NET Framework 4.6.2 |
| [25.9.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.9.0) | .NET Framework 4.6.2 |
| [25.8.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.8.0) | .NET Framework 4.6.2 |
| [25.7.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.7.0) | .NET Framework 4.6.2 |
| [25.6.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.6.0) | .NET Framework 4.6.2 |
| [25.5.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.5.0) | .NET Framework 4.6.2 |
| [25.4.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.4.0) | .NET Framework 4.6.2 |
| [25.3.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.3.0) | .NET Framework 4.6.2 |
| [25.2.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.2.0) | .NET Framework 4.6.2 |
| [25.1.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/25.1.0) | .NET Framework 4.6.2 |
| [24.12.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.12.0) | .NET Framework 4.6.2 |
| [24.11.1](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.11.1) | .NET Framework 4.6.2 |
| [24.11.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.11.0) | .NET Framework 4.6.2 |
| [24.10.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.10.0) | .NET Framework 4.6.2 |
| [24.9.1](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.9.1) | .NET Framework 4.6.2 |
| [24.8.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.8.0) | .NET Framework 4.6.2 |
| [24.7.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.7.0) | .NET Framework 4.6.2 |
| [24.6.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.6.0) | .NET Framework 4.6.1 |
| [24.5.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.5.0) | .NET Framework 4.6.1 |
| [24.4.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.4.0) | .NET Framework 4.6.1 |
| [24.3.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.3.0) | .NET Framework 4.6.1 |
| [24.2.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.2.0) | .NET Framework 4.6.1 |
| [24.1.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/24.1.0) | .NET Framework 4.6.1 |
| [23.12.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/23.12.0) | .NET Framework 4.6.1 |
| [23.11.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/23.11.0) | .NET Framework 4.6.1 |
| [23.10.0](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/23.10.0) | .NET Framework 4.6.1 |

{{< /tab >}}
{{< /tabs >}}

{{< alert style="tip" >}}

.NET Framework versions are designed to be backward compatible. This means that you can use GroupDocs.Total for .NET targeting .NET Framework 2.0 with later versions of .NET Framework, such as .NET Framework 4.8. Learn more about .NET Framework backward compatibility [here](https://learn.microsoft.com/en-us/dotnet/framework/migration-guide/version-compatibility).

{{< /alert >}}

## Install GroupDocs.Total using NuGet packages

You can use the following tools to install the [GroupDocs.Total](https://www.nuget.org/packages/GroupDocs.Total) NuGet package: 

 * [NuGet Package Manager](#use-the-nuget-package-manager-in-visual-studio)
 * [Package Manager Console](#use-the-package-manager-console-in-visual-studio)
 * [.NET CLI](#use-the-net-cli)

### Use the NuGet Package Manager

Open your project or solution in Visual Studio and follow the steps below to install the **GroupDocs.Total** package using the [NuGet Package Manager](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio):

1. In **Solution Explorer**, right-click your project name and select **Manage NuGet Packages** to display the NuGet Package Manager.

    <!-- ![Manage NuGet packages in Visual Studio](/total/net/images/getting-started/installation/manage-nuget-packages.png) -->

2. Select the **Browse** tab and type **GroupDocs.Total** in the search box. Select the latest version of the **GroupDocs.Total** package and click **Install**.

    <!-- ![](/total/net/images/getting-started/installation/install-nuget-package.png) -->

### Use the Package Manager Console

The [Package Manager Console](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell) uses PowerShell commands to install, update, and remove NuGet packages. Open your project in Visual Studio and click **Tools** -> **NuGet Package Manager** -> **Package Manager Console** to open the console window. Run the the following command to install the latest version of the **GroupDocs.Total** library:

{{< tabs "example1">}}
{{< tab ".NET application" >}}
```
PM> Install-Package GroupDocs.Total
```
{{< /tab >}}
{{< tab ".NET Framework application" >}}
```
PM> Install-Package GroupDocs.Total.NETFramework
```
{{< /tab >}}
{{< /tabs >}}

<!-- ![Use Package Manager Console ](/total/net/images/getting-started/installation/package-manager-console.png) -->

### Use the .NET CLI

You can also use the [.NET CLI tool](https://learn.microsoft.com/en-us/dotnet/core/tools/) to install and update NuGet packages. Open a terminal in your project's folder and execute the following command to install the **GroupDocs.Total** package:

{{< tabs "example2">}}
{{< tab ".NET application" >}}
```
dotnet add package GroupDocs.Total
```
{{< /tab >}}
{{< tab ".NET Framework application" >}}
```
dotnet add package GroupDocs.Total.NETFramework
```
{{< /tab >}}
{{< /tabs >}}

## Download GroupDocs.Total from the official website

Visit [https://releases.groupdocs.com/total/net/](https://releases.groupdocs.com/total/net/) and download the **GroupDocs.Total** assemblies as a ZIP archive. To reference the downloaded assembly files in your project, do the following:

1. Extract files from the ZIP archive with the assemblies to a specific location on your computer.
2. Open your solution or project in Visual Studio.
3. In **Solution Explorer**, right-click the **References** or **Dependencies** node, and select **Add Reference** (for a .NET Framework project) or **Add Project Reference** (for a .NET Core project).
4. In the **Reference Manager** dialog box, select the **Browse** tab and click **Browse** to locate the _GroupDocs.Total.dll_ file for the target framework.
5. Click **OK** to add a reference to the **GroupDocs.Total** library to your project.

{{< alert style="warning" >}}
When installing GroupDocs.Total from the official website ensure that your project has all the required dependencies installed. Refer to the following page for details: 
* [GroupDocs.Total dependencies](https://www.nuget.org/packages/groupdocs.total#dependencies-body-tab)
* [GroupDocs.Total.NETFramework dependencies](https://www.nuget.org/packages/groupdocs.total.netframework#dependencies-body-tab).
{{< /alert >}}

---

## Install GroupDocs.Viewer for Java

Path: /viewer/java/installation/


{{< alert style="info" >}}

Starting from [GroupDocs.Viewer for Java 24.4](https://releases.groupdocs.com/viewer/java/release-notes/2024/groupdocs-viewer-for-java-24-4-release-notes/), the JAR package is signed using a GPG signature. You can find the public key in the [GPG-KEYS.txt](https://releases.groupdocs.com/java/repo/com/groupdocs/GPG-KEYS.txt) file. Learn more about verifying signatures in the [Making and verifying signatures](https://www.gnupg.org/gph/en/manual/x135.html) article.

{{< /alert >}}

## Install using Maven

All GroupDocs packages are hosted at [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-viewer/). You can download packages or reference GroupDocs.Viewer for Java API directly in your Maven project using following steps. 

{{< alert style="tip" >}}

[Download](/viewer/java/sample-apps/getting-started/installation/maven-app.zip) a sample Maven application that demonstrates using GroupDocs.Viewer for Java. You can run the application locally with `mvn exec:java` command.

{{< /alert >}}

### Add GroupDocs Artifact Repository

Add GroupDocs Artifact Repository to your `pom.xml` file:

{{< tabs "pom-repository">}}
{{< tab "pom.xml" >}}
```xml
<repositories>
    <repository>
        <id>GroupDocs Artifact Repository</id>
        <name>GroupDocs Artifact Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Viewer as a dependency

Define GroupDocs.Viewer for Java API dependency in your `pom.xml`:

{{< tabs "pom-dependency">}}
{{< tab "pom.xml" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-viewer</artifactId>
        <version>25.9</version> 
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< /tabs >}}

## Reference in Java application

To get started, download the latest version of GroupDocs.Viewer for Java (JAR file) from [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-viewer/). Also, make sure you have [Java](https://www.oracle.com/java/technologies/downloads/) installed.

### Create application

{{< alert style="tip" >}}

You can [download](/viewer/java/sample-apps/getting-started/installation/java-app.zip) the sample application and proceed to building it.

{{< /alert >}}

{{< tabs "java-app">}}
{{< tab "App.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.*;

public class App {
    public static void main(String[] args) throws Exception {
        Viewer viewer = new Viewer("formatting.docx");
        viewer.view(HtmlViewOptions.forEmbeddedResources());
        viewer.close();
    }
}
```
{{< /tab >}}
{{< tab "formatting.docx" >}}
{{< tab-text >}}
`formatting.docx` is sample DOCX file that we're going to use in this example. Click [here](/viewer/java/sample-files/getting-started/installation/formatting.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "groupdocs-viewer.jar" >}}
{{< tab-text >}}
`groupdocs-viewer.jar` is GroupDocs.Viewer for Java JAR file e.g., [groupdocs-viewer-24.4.jar](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-viewer/24.4/groupdocs-viewer-24.4.jar).
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 java-app
 ├──App.java
 ├──formatting.docx
 └──groupdocs-viewer.jar
```

### Build application

To build Java application run the command below. This comand compiles the application and creates `App.class` file in the current directory.

{{< tabs "java-app-build">}}
{{< tab "Windows" >}}
```bash
javac -d . -cp ".;./groupdocs-viewer.jar" App.java
```
{{< /tab >}}
{{< tab "Linux" >}}
```bash
javac -d . -cp ".:./groupdocs-viewer.jar" App.java
```
{{< /tab >}}
{{< /tabs >}}

### Run application

To run the application type the command below. As a result two HTML documents will be created in the current directory for the first two pages of the document.

{{< tabs "java-app-run">}}
{{< tab "Windows" >}}
```bash
java -cp ".;./groupdocs-viewer.jar" App
```
{{< /tab >}}
{{< tab "Linux" >}}
```bash
java -Djava.awt.headless=true -cp ".:./groupdocs-viewer.jar" App
```

{{< tab-text >}}
Please note that `-Djava.awt.headless=true` required when your Java installation does not inlude GUI libraries.
{{< /tab-text >}}

{{< /tab >}}
{{< /tabs >}}

---

## Install GroupDocs.Viewer for .NET

Path: /viewer/net/installation/

This topic describes how to add the **GroupDocs.Viewer** library to your .NET project. You can use a NuGet package to install this library or you can download necessary DLLs from the GroupDocs website: [https://releases.groupdocs.com/viewer/net/](https://releases.groupdocs.com/viewer/net/).

## Select GroupDocs.Viewer package and version

<div class="gdoc-two-columns">
    <div class="gdoc-two-columns__column">
        <ul class="gdoc-two-columns__column__list">
            <li>
                <div>
                    <svg class="gdoc-two-columns__column__icon"><use xlink:href="/img/groupdocs-stack.svg#nuget"></use></svg>
                </div>
                <div>
                    <a class="gdoc-two-columns__column__link"
                        href="https://www.nuget.org/packages/GroupDocs.Viewer">GroupDocs.Viewer</a>
                    <div class="gdoc-two-columns__column__descr">
                        - .NET Framework 4.6.2+ and .NET 6.0.
                        <br>
                        - Depends on System.Drawing(.Common).
                    </div>
                </div>
            </li>
        </ul>
    </div>
    <div class="gdoc-two-columns__column">
        <ul class="gdoc-two-columns__column__list">
            <li>
                <div>
                <svg class="gdoc-two-columns__column__icon"><use xlink:href="/img/groupdocs-stack.svg#nuget"></use></svg>
                </div>
                <div>
                    <a class="gdoc-two-columns__column__link"
                        href="https://www.nuget.org/packages/GroupDocs.Viewer.CrossPlatform">GroupDocs.Viewer.CrossPlatform</a>
                        <div class="gdoc-two-columns__column__descr">
                        - .NET 6.0 and later versions.
                        <br>
                        - Prefered for Linux and macOS.
                    </div>
                </div>
            </li>
        </ul>
    </div>
</div>

You can also use **GroupDocs.Viewer** with **.NET Framework 2.0** (Visual Studio 2005-2008), **.NET Framework 4.0** (Visual Studio 2010), and later .NET Framework versions by selecting one of the previous versions of the GroupDocs.Viewer package. See the complete list of package versions and supported frameworks in the table below.

{{< tabs "package-versions">}}
{{< tab "GroupDocs.Viewer for .NET" >}}

| Package version | Target frameworks |
| --- | --- |
| [24.4.0](https://www.nuget.org/packages/GroupDocs.Viewer/24.4.0) | .NET Frameword 4.6.2, .NET 6.0 |
| [24.3.0](https://www.nuget.org/packages/GroupDocs.Viewer/24.3.0) | .NET Frameword 4.6.2, .NET 6.0 |
| [24.2.0](https://www.nuget.org/packages/GroupDocs.Viewer/24.2.0) | .NET Frameword 4.6.2, .NET Standard 2.1 |
| [24.1.1](https://www.nuget.org/packages/GroupDocs.Viewer/24.1.1) | .NET Frameword 4.6.2, .NET Standard 2.1 |

<details>
<summary>See previous versions</summary>

| Package version | Target frameworks |
| --- | --- |
| [23.12.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.12.0) | .NET Frameword 4.6.2, .NET Standard 2.1 |        
| [23.11.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.11.0) | .NET Frameword 4.6.2, .NET Standard 2.1 |        
| [23.10.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.10.0) | .NET Frameword 4.6.2, .NET Standard 2.1 |        
| [23.8.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.8.0) | .NET Frameword 4.6.2, .NET Standard 2.1 |
| [23.6.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.6.0) | .NET Framework 4.0, .NET Standard 2.1 |
| [23.4.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.4.0) | .NET Framework 4.0, .NET Standard 2.1 |
| [23.3.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.3.0) | .NET Framework 4.0, .NET Standard 2.1 |
| [23.1.0](https://www.nuget.org/packages/GroupDocs.Viewer/23.1.0) | .NET Framework 4.0, .NET Standard 2.1 |
| [22.11.0](https://www.nuget.org/packages/GroupDocs.Viewer/22.11.0) | .NET Framework 4.0, .NET Standard 2.1, .NET 6.0 |
| [22.9.0](https://www.nuget.org/packages/GroupDocs.Viewer/22.9.0) | .NET Framework 4.0, .NET Standard 2.1, .NET 6.0 |  
| [22.7.0](https://www.nuget.org/packages/GroupDocs.Viewer/22.7.0) | .NET Framework 4.0, .NET Standard 2.1, .NET 6.0 |  
| [22.5.0](https://www.nuget.org/packages/GroupDocs.Viewer/22.5.0) | .NET Framework 4.0, .NET Standard 2.1, .NET 6.0 |  
| [22.3.0](https://www.nuget.org/packages/GroupDocs.Viewer/22.3.0) | .NET 6.0, .NET Framework 4.0, .NET Standard 2.1 |  
| [22.1.1](https://www.nuget.org/packages/GroupDocs.Viewer/22.1.1) | .NET Framework 2.0, .NET Framework 4.0, .NET Standard 2.0 |
| [22.1.0](https://www.nuget.org/packages/GroupDocs.Viewer/22.1.0) | .NET Framework 2.0, .NET Framework 4.0, .NET Standard 2.0 |
| [21.12.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.12.0) | .NET Framework 2.0, .NET Framework 4.0, .NET Standard 2.0 |
| [21.11.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.11.0) | .NET Framework 2.0, .NET Framework 4.0, .NET Standard 2.0 |
| [21.10.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.10.0) | .NET Framework 2.0, .NET Framework 4.0, .NET Standard 2.0 |
| [21.9.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.9.0) | .NET Framework 2.0, .NET Framework 4.0, .NET Standard 2.0 |
| [21.8.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.8.0) | .NET Framework 2.0, .NET Framework 4.0, .NET Standard 2.0 |
| [21.7.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.7.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.6.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.6.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.5.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.5.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.4.1](https://www.nuget.org/packages/GroupDocs.Viewer/21.4.1) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.4.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.4.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.3.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.3.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.2.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.2.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [21.1.0](https://www.nuget.org/packages/GroupDocs.Viewer/21.1.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.12.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.12.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.11.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.11.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.10.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.10.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.9.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.9.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.8.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.8.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.7.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.7.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.6.1](https://www.nuget.org/packages/GroupDocs.Viewer/20.6.1) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.6.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.6.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.5.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.5.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.4.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.4.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.3.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.3.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.2.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.2.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [20.1.0](https://www.nuget.org/packages/GroupDocs.Viewer/20.1.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [19.12.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.12.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [19.11.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.11.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [19.10.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.10.0) | .NET Framework 2.0, .NET Standard 2.0 |
| [19.9.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.9.0) | .NET Framework 2.0 |
| [19.8.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.8.0) | .NET Framework 2.0 |
| [19.6.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.6.0) | .NET Framework 2.0 |
| [19.5.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.5.0) | .NET Framework 2.0 |
| [19.4.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.4.0) | .NET Framework 2.0 |
| [19.3.1](https://www.nuget.org/packages/GroupDocs.Viewer/19.3.1) | .NET Framework 2.0 |
| [19.3.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.3.0) | .NET Framework 2.0 |
| [19.2.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.2.0) | .NET Framework 2.0 |
| [19.1.0](https://www.nuget.org/packages/GroupDocs.Viewer/19.1.0) | .NET Framework 2.0 |
| [18.12.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.12.0) | .NET Framework 2.0 |
| [18.11.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.11.0) | .NET Framework 2.0 |
| [18.10.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.10.0) | .NET Framework 2.0 |
| [18.9.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.9.0) | .NET Framework 2.0 |
| [18.8.1](https://www.nuget.org/packages/GroupDocs.Viewer/18.8.1) | .NET Framework 2.0 |
| [18.8.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.8.0) | .NET Framework 2.0 |
| [18.7.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.7.0) | .NET Framework 2.0 |
| [18.6.1](https://www.nuget.org/packages/GroupDocs.Viewer/18.6.1) | .NET Framework 2.0 |
| [18.6.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.6.0) | .NET Framework 2.0 |
| [18.5.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.5.0) | .NET Framework 2.0 |
| [18.4.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.4.0) | .NET Framework 2.0 |
| [18.3.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.3.0) | .NET Framework 2.0 |
| [18.1.0](https://www.nuget.org/packages/GroupDocs.Viewer/18.1.0) | .NET Framework 2.0 |
| [17.12.0](https://www.nuget.org/packages/GroupDocs.Viewer/17.12.0) | .NET Framework 2.0 |
| [17.11.0](https://www.nuget.org/packages/GroupDocs.Viewer/17.11.0) | .NET Framework 2.0 |
| [17.10.0](https://www.nuget.org/packages/GroupDocs.Viewer/17.10.0) | .NET Framework 2.0 |
| [17.9.0](https://www.nuget.org/packages/GroupDocs.Viewer/17.9.0) | .NET Framework 2.0 |

</details>

{{< /tab >}}
{{< tab "GroupDocs.Viewer.CrossPlatform" >}}

| Package version | Target frameworks |
| --- | --- |
| [24.4.0](https://www.nuget.org/packages/GroupDocs.Viewer.CrossPlatform/24.4.0) | .NET 6.0 |
| [24.3.1](https://www.nuget.org/packages/GroupDocs.Viewer.CrossPlatform/24.3.1) | .NET 6.0 |
| [24.3.0](https://www.nuget.org/packages/GroupDocs.Viewer.CrossPlatform/24.3.0) | .NET 6.0 |

{{< /tab >}}
{{< /tabs >}}

{{< alert style="tip" >}}

.NET Framework versions are designed to be backward compatible. This means that you can use GroupDocs.Viewer for .NET targeting .NET Framework 2.0 with later versions of .NET Framework, such as .NET Framework 4.0. Learn more about .NET Framework backward compatibility [here](https://learn.microsoft.com/en-us/dotnet/framework/migration-guide/version-compatibility).

{{< /alert >}}

## Install GroupDocs.Viewer using NuGet packages

You can use the following tools to install the **GroupDocs.Viewer** or **GroupDocs.Viewer.CrossPlatform** NuGet packages: 

 * [NuGet Package Manager](#use-the-nuget-package-manager)
 * [Package Manager Console](#use-the-package-manager-console)
 * [.NET CLI](#use-the-net-cli)

### Use the NuGet Package Manager

{{< alert style="tip" >}}

Earlier versions of Visual Studio does not include NuGet Package Manager. It can be added as an extension from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/).

* [NuGet Package Manager for Visual Studio 2015](https://marketplace.visualstudio.com/items?itemName=NuGetTeam.NuGetPackageManagerforVisualStudio2015)
* [NuGet Package Manager for Visual Studio 2013](https://marketplace.visualstudio.com/items?itemName=NuGetTeam.NuGetPackageManagerforVisualStudio2013)
* [NuGet Package Manager for Visual Studio 2010 and 2012](https://marketplace.visualstudio.com/items?itemName=NuGetTeam.NuGetPackageManager) 

{{< /alert >}}

Open your project or solution in Visual Studio and follow the steps below to install the **GroupDocs.Viewer** or **GroupDocs.Viewer.CrossPlatform** package using the NuGet Package Manager:

1. In **Solution Explorer**, right-click your project name and select **Manage NuGet Packages** to display the NuGet Package Manager.

    ![Add NuGet package in Visual Studio](/viewer/net/images/getting-started/installation/manage-nuget-packages.png)

2. Select the **Browse** tab and type **GroupDocs.Viewer** or **GroupDocs.Viewer.CrossPlatform** in the search box. Select the latest version of the package and click **Install**.

    ![Install GroupDocs.Viewer NuGet package in Visual Studio](/viewer/net/images/getting-started/installation/install-nuget-package.png)

### Use the Package Manager Console

The [Package Manager Console](https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-powershell) uses PowerShell commands to install, update, and remove NuGet packages. Open your project in Visual Studio and click **Tools** -> **NuGet Package Manager** -> **Package Manager Console** to open the console window. Run the the following command to install the latest version of the package:

{{< tabs "example1">}}
{{< tab "GroupDocs.Viewer for .NET" >}}
```
PM> Install-Package GroupDocs.Viewer
```
{{< /tab >}}
{{< tab "GroupDocs.Viewer.CrossPlatform" >}}
```
PM> Install-Package GroupDocs.Viewer.CrossPlatform
```
{{< /tab >}}
{{< /tabs >}}

![Use Package Manager Console ](/viewer/net/images/getting-started/installation/package-manager-console.png)

### Use the .NET CLI

You can also use the [.NET CLI tool](https://docs.microsoft.com/en-us/dotnet/core/tools/) to install and update NuGet packages. Open a terminal in your project's folder and execute the following command to install the package:

{{< tabs "example2">}}
{{< tab "GroupDocs.Viewer for .NET" >}}
```
dotnet add package GroupDocs.Viewer
```
{{< /tab >}}
{{< tab "GroupDocs.Viewer.CrossPlatform" >}}
```
dotnet add package GroupDocs.Viewer.CrossPlatform
```
{{< /tab >}}
{{< /tabs >}}

## Download GroupDocs.Viewer from the official website

Visit [https://releases.groupdocs.com/viewer/net/](https://releases.groupdocs.com/viewer/net/) and download the **GroupDocs.Viewer** assemblies as a ZIP archive or MSI installer. To reference the downloaded assembly files in your project, do the following:

1. Extract files from the ZIP archive or run the MSI installer to install **GroupDocs.Viewer** to a specific location on your computer.
2. Open your solution or project in Visual Studio.
3. In **Solution Explorer**, right-click the **References** or **Dependencies** node, and select **Add Reference** (for a .NET Framework project) or **Add Project Reference** (for a .NET project).

    ![Add project reference in Visual Studio](/viewer/net/images/getting-started/installation/add-project-reference.png)

4. In the **Reference Manager** dialog box, select the **Browse** tab and click **Browse** to locate the _GroupDocs.Viewer.dll_ file for the target framework.

    ![Browse for the GroupDocs.Viewer assembly](/viewer/net/images/getting-started/installation/browse-for-groupdocs-dll.png)

5. Click **OK** to add a reference to the **GroupDocs.Viewer** library to your project.

{{< alert style="warning" >}}
If your application targets .NET Core / .NET 5+, ensure that your project has all the required dependencies installed. Refer to the following page for details: [GroupDocs.Viewer dependencies](https://www.nuget.org/packages/groupdocs.viewer#dependencies-body-tab).
{{< /alert >}}

---

## Install GroupDocs.Viewer for Node.js via Java

Path: /viewer/nodejs-java/installation/


### Prerequisites

- Node.js: 20 LTS or later
- Java: JRE/JDK 8+ (recommended 17 LTS)
- Build tools if needed by your environment (node-gyp toolchain)

See full details on the [System Requirements]({{< ref "viewer/nodejs-java/getting-started/system-requirements" >}}) page.

### Install from npm

All Java-bridged packages are hosted on npm. Install the library into your project using your preferred package manager:

```bash
# npm
npm install @groupdocs/groupdocs.viewer

# yarn
yarn add @groupdocs/groupdocs.viewer

# pnpm
pnpm add @groupdocs/groupdocs.viewer
```

### Set up Java (JAVA_HOME)

Ensure your Java installation is available on PATH and `JAVA_HOME` is set.

Windows (PowerShell):

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS (Bash):

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"
```

See the [System Requirements]({{< ref "viewer/nodejs-java/getting-started/system-requirements" >}}) page for more details.

### Verify installation

Create a small script (e.g., `check.js`) and run it with Node.js:

{{< tabs "check-installation" >}}
{{< tab "check.js" >}}  
```js
import { Viewer } from '@groupdocs/groupdocs.viewer';

try {
  console.log('GroupDocs.Viewer loaded:', typeof Viewer === 'function');
  console.log('Java bridge initialized successfully.');
  process.exit(0);
} catch (e) {
  console.error('Failed to load GroupDocs.Viewer:', e);
  process.exit(1);
}
```
{{< /tab >}}
{{< /tabs >}}


And than run the script to verify the installation:

```bash
node check.js
```

### Download from GroupDocs.Releases (offline)

You can download a package archive from [GroupDocs.Releases](https://releases.groupdocs.com/viewer/nodejs-java/#direct-download) and add it to your app. After downloading the `.tar` file, install it locally:

```bash
npm install ./groupdocs-groupdocs.viewer-<version>.tar
```

Alternatively, configure npm to use your corporate registry or proxy, then install using the standard command.

### Minimal JavaScript app example

Once you have installed the GroupDocs.Viewer package, here's a minimal example of how you can use it in a Node.js application.

1. **Create a JavaScript file** (e.g., `app.js`) in your project's root directory.

2. **Import the GroupDocs.Viewer module** and implement a simple file viewing functionality:

   {{< tabs "render-pdf-to-html">}}
   {{< tab "JavaScript" >}}
   ```js
   import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';
   
   // Path to the file you want to render
   const filePath = 'sample.pdf';

   // Initialize viewer
   const viewer = new Viewer(filePath);

   // Render the file to HTML
   viewer.view(HtmlViewOptions.forEmbeddedResources());

   // Exit with a success code
   process.exit(0);
   ```
   {{< /tab >}}
   {{< tab "sample.pdf" >}}
   {{< tab-text >}}
   `sample.pdf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/getting-started/installation/sample.pdf) to download it.
   {{< /tab-text >}}
   {{< /tab >}}
   {{< /tabs >}}

3. **Run the app** by executing the following command in your terminal:

   ```bash
   node app.js
   ```

This minimal example converts a document to HTML format. The output will contain rendered pages in HTML format.

### Troubleshooting installation

- node-gyp toolchain not found: install the required build tools for your OS (see System Requirements).
- Java not detected: set `JAVA_HOME` and add `<JAVA_HOME>/bin` to `PATH`.
- Corporate proxy: configure npm proxy settings before running install.
- Permission errors: ensure you have write access to the project directory and cache folders.

---

## Installation

Path: /watermark/net/installation/



This guide helps you quickly install GroupDocs.Watermark for .NET, a powerful library to add, edit, or remove watermarks from PDF, Word, Excel, PowerPoint, Visio, and image formats. Choose your preferred method below.

### Install via NuGet (Recommended)

Follow these steps to reference GroupDocs.Watermark using Package Manager GUI:

* Open your solution/project in Visual Studio.
* Click **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution**. You can also access the same option through the Solution Explorer. Right-click the solution or project and select **Manage NuGet Packages** from the context menu
* Select **Browse** tab and type "GroupDocs.Watermark" in the search text box.
* Click the **Install** button to install the latest version of the API into your project as shown in the following screenshot.

![installation](/watermark/net/images/installation.png)

### Using the package manager console

You can follow the steps below to reference GroupDocs.Watermark using the Package Manager Console:

* Open your solution/project in Visual Studio.
* Select **Tools** -> **NuGet Package Manager** -> **Package Manager Console** from the menu to open the package manager console.
* Type the command "Install-Package GroupDocs.Watermark" and press enter to install the latest release into your application.
* After successful installation, GroupDocs.Watermark will be referenced in your application.

![installation_1](/watermark/net/images/installation_1.png)

## Install from the official GroupDocs website

You can follow the steps below to reference GroupDocs.Watermark for .NET downloaded from official website [Downloads section](https://downloads.groupdocs.com/watermark/net):

1. Unpack the ZIP archive or follow MSI install wizard instructions.
2. In the Solution Explorer, expand the project node you want to add a reference to.
3. Right-click the **References** node for the project and select **Add Reference** from the menu.
4. In the Add Reference dialog box, select the **.NET** tab (it's usually selected by default).
5. If you have used the MSI installer to install GroupDocs.Watermark, you will see GroupDocs.Watermark in the top pane. Select it and then click the **Select** button.
6. If you have downloaded and unpacked the DLL only, click the **Browse** button and locate the GroupDocs.Watermark.dll file. You have referenced GroupDocs.Watermark and it should appear in the **Selected Components** pane of the dialog box.
7. Click **OK**.
8. GroupDocs.Watermark reference appears under the **References** node of the project.

Note that .NET Standard 2.0 version has external references:

| Package | Version |
| --- | --- |
| System.Drawing.Common | 5.0.3 |
| System.Text.Encoding.CodePages | 7.0.0 |
| SkiaSharp | 3.119.0 |

---

## Known Issues

Path: /parser/net/known-issues/

### FIPS mode limitations

Connection to remote email servers doesn’t support FIPS mode.

---

## Known Issues

Path: /search/java/known-issues/

---
id: known-issues
url: search/java/known-issues
title: Known Issues
weight: 4
description: ""
keywords: 
productName: GroupDocs.Search for Java
hideChildren: False
---

---

## Known Issues

Path: /search/net/known-issues/


The following formats are not supported by .NET Core version in Linux:

- .MHTML (.MHT)
- .ONE
---

## List and print all supported file types

Path: /viewer/java/how-to-list-and-print-all-supported-file-types/


The [Supported file formats]({{< ref "viewer/java/getting-started/supported-document-formats.md" >}}) page lists all file formats supported by GroupDocs.Viewer.

To list or print out all the supported file formats within your application, follow these steps:

1. Call the [getSupportedFileTypes](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/filetype/#getSupportedFileTypes--) method of the [FileType](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/FileType) class.
2. Enumerate the collection of the [FileType](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/FileType) objects.

The following code snippet shows how to list supported file formats in the console:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.FileType;
// ...

List<FileType> supportedFileTypes = FileType.getSupportedFileTypes();

for (FileType fileType : supportedFileTypes) {
    System.out.println(fileType);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/java/images/how-to-list-and-print-all-supported-file-types.png)

---

## List and print all supported file types

Path: /viewer/net/how-to-list-and-print-all-supported-file-types/


The [Supported file formats]({{< ref "viewer/net/getting-started/supported-document-formats.md" >}}) page lists all file formats supported by GroupDocs.Viewer.

To list or print out all the supported file formats within your application, follow these steps:

1. Call the [GetSupportedFileTypes](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/filetype/methods/getsupportedfiletypes) method of the [FileType](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/filetype) class.
2. Enumerate the collection of the [FileType](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/filetype) objects.

The following code snippet shows how to list supported file formats in the console:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using System.Collections.Generic;
using GroupDocs.Viewer;
// ...

// Get list of file types.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes();

// Display list of file types
foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports System.Collections.Generic
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        ' Get list of file types.
        Dim supportedFileTypes As IEnumerable(Of FileType) = FileType.GetSupportedFileTypes()
    
        ' Display list of file types
        For Each fileType As FileType In supportedFileTypes
            Console.WriteLine(fileType)
        Next
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-list-and-print-all-supported-file-types.png)

---

## Listening to conversion process events

Path: /conversion/java/listening/

In some scenarios, it is necessary to track the conversion process and receive updates about the start, progress, and completion of the conversion. To address such requirements, [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) provides an extension point that allows client applications to subscribe to these events and receive real-time updates.

To enable event listening during the conversion process, follow these steps:

1.   Implement the [IConverterListener](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.reporting/iconverterlistener/) interface to define custom event handling logic.
2.   Create an instance of the [ConverterSettings](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/convertersettings/) class and configure it with the custom implementation of [IConverterListener](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.reporting/iconverterlistener/).
3.   Pass the configured [ConverterSettings](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/convertersettings/) instance to the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class constructor.
4.   Call the convert method on the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class to start the conversion process.

Below is a code example demonstrating how to implement and enable event listening using

{{< tabs "code-example">}}
{{< tab "ConverterListener.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.ConverterSettings;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.reporting.IConverterListener;

public class ConverterListener implements IConverterListener {
    @Override
    public void started() {
        System.out.println("Conversion started...");
    }

    @Override
    public void progress(byte current) {
        System.out.println("... " + current + "% completed...");
    }

    @Override
    public void completed() {
        System.out.println("... Conversion completed!");
    }

    public static void convert() {
        IConverterListener listener = new ConverterListener();
        ConverterSettings settingsFactory = new ConverterSettings();
        settingsFactory.setListener(listener);

        try (Converter converter = new Converter("formatting.docx", () -> settingsFactory)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "Console output" >}}  
{{< tab-text >}}
```
... 7% completed...
... 14% completed...
... 21% completed...
... 28% completed...
... 35% completed...
... 42% completed...
... 50% completed...
... 57% completed...
... 64% completed...
... 71% completed...
... 78% completed...
... 85% completed...
... 92% completed...
... 100% completed...
... Conversion completed!
```
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Key Points:
- **Event Methods**: The `started`, `progress`, and `completed` methods provide hooks for monitoring different stages of the conversion process.
- **Thread Safety**: Ensure thread-safe implementation if the conversion process is run in a multi-threaded environment.
- **Clean Resource Management**: Use try-with-resources to ensure the `Converter` instance is properly closed after the operation.
---

## Load a password-protected document

Path: /markdown/net/load-a-password-protected-document/


To open a password-protected document, create a `LoadOptions` instance with the file format and set the `Password` property.

{{< tabs "load-password-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var loadOptions = new LoadOptions(FileFormat.Docx)
{
    Password = "secret"
};

// Static one-liner
string markdown = MarkdownConverter.ToMarkdown("protected.docx", loadOptions);
File.WriteAllText("load-password-static.md", markdown);
```
{{< /tab >}}
{{< tab "protected.docx" >}}  
{{< tab-text >}}
`protected.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/loading/protected.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-password-static.md" >}}  
```text
**Confidential Memo**

From: Meridian Outdoor Co. — Strategy Team

Date: 2026-01-15

Subject: FY2026 M&A Targets



[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/LoadPasswordStatic/load-password-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

{{< tabs "load-password-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var loadOptions = new LoadOptions(FileFormat.Xlsx)
{
    Password = "secret"
};

using var converter = new MarkdownConverter("protected.xlsx", loadOptions);
converter.Convert("load-password-instance.md");
```
{{< /tab >}}
{{< tab "protected.xlsx" >}}  
{{< tab-text >}}
`protected.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/loading/protected.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-password-instance.md" >}}  
```text
## Expenses

| Date | Vendor | Category | Amount |
| --- | --- | --- | --- |
| 2026-01-02 | Pacific Freight | Shipping | $2,450.00 |
| 2026-01-05 | Cedar Packaging | Materials | $1,320.50 |
| 2026-01-08 | Highline Textiles | Materials | $8,940.00 |
| 2026-01-12 | Portland Electric | Utilities | $680.25 |
| 2026-01-14 | Backcountry Co-op | Events | $1,200.00 |
| 2026-01-17 | Ridge Media | Marketing | $5,400.00 |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/LoadPasswordInstance/load-password-instance.md)
{{< /tab >}}
{{< /tabs >}}

### Handling incorrect passwords

If the password is missing or incorrect, a `DocumentProtectedException` is thrown. You can catch it to display a user-friendly message:

{{< tabs "load-password-exception">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

try
{
    string markdown = MarkdownConverter.ToMarkdown("protected.docx");
}
catch (DocumentProtectedException ex)
{
    Console.WriteLine($"Cannot open document: {ex.Message}");
}
```
{{< /tab >}}
{{< tab "protected.docx" >}}  
{{< tab-text >}}
`protected.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/loading/protected.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-password-exception.txt" >}}  
```text
Cannot open document: The document password is incorrect.
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/LoadPasswordException/load-password-exception.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Load a password-protected document

Path: /markdown/python-net/load-a-password-protected-document/


To open a password-protected document, create a `LoadOptions` instance with the file format and set the `password` property.

{{< tabs "load-password-static">}}
{{< tab "load_password_static.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, LoadOptions, FileFormat

def load_password_static():
    """Open a password-protected document and convert using the static API."""

    # Step 1: Create load options with format and password
    load_options = LoadOptions(FileFormat.DOCX)
    load_options.password = "secret"

    # Step 2: Convert the protected document using keyword argument
    MarkdownConverter.to_file("protected.docx", "load-password-static.md", load_options=load_options)

if __name__ == "__main__":
    load_password_static()
```
{{< /tab >}}
{{< tab "protected.docx" >}}  
{{< tab-text >}}
`protected.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/loading/protected.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-password-static.txt" >}}  
```text
# **Title of the document**


## **Subtitle #1**

Text is normal, then **bold**, then *italic*, then underscore, and finally normal again. Now ~~strikethrough~~, then double strikethrough, and underscore differently - with dashes. Another underscore is marked with yellow wave line. And then – underscore and strikethrough ~~together~~! Here we have a superscript123 and a subscript456. This part of text has a red background. These words are shadowed to right side, these – shadowed (red) to top sid
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/load_password_static/load-password-static.txt)
{{< /tab >}}
{{< tab "load-password-static.txt" >}}  
```text
# **Title of the document**


## **Subtitle #1**

Text is normal, then **bold**, then *italic*, then underscore, and finally normal again. Now ~~strikethrough~~, then double strikethrough, and underscore differently - with dashes. Another underscore is marked with yellow wave line. And then – underscore and strikethrough ~~together~~! Here we have a superscript123 and a subscript456. This part of text has a red background. These words are shadowed to right side, these – shadowed (red) to top sid
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/load_password_static/load-password-static.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API

{{< tabs "load-password-instance">}}
{{< tab "load_password_instance.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, LoadOptions, FileFormat

def load_password_instance():
    """Open a password-protected spreadsheet and convert using the instance API."""

    # Step 1: Create load options with format and password
    load_options = LoadOptions(FileFormat.XLSX)
    load_options.password = "secret"

    # Step 2: Open the protected document using keyword argument for load options
    with MarkdownConverter("protected.xlsx", load_options=load_options) as converter:
        # Step 3: Convert and save the Markdown output
        converter.convert("load-password-instance.md")

if __name__ == "__main__":
    load_password_instance()
```
{{< /tab >}}
{{< tab "protected.xlsx" >}}  
{{< tab-text >}}
`protected.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/loading/protected.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-password-instance.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/load_password_instance/load-password-instance.txt)
{{< /tab >}}
{{< tab "load-password-instance.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/load_password_instance/load-password-instance.txt)
{{< /tab >}}
{{< /tabs >}}

### Handling incorrect passwords

If the password is missing or incorrect, a `DocumentProtectedException` is raised. You can catch it to display a user-friendly message:

{{< tabs "load-password-exception">}}
{{< tab "load_password_exception.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, DocumentProtectedException

def load_password_exception():
    """Handle incorrect or missing passwords when opening protected documents."""

    try:
        # Step 1: Attempt to convert without providing a password
        markdown = MarkdownConverter.to_markdown("protected.docx")
    except DocumentProtectedException as ex:
        # Step 2: Catch the exception and display a user-friendly message
        print(f"Cannot open document: {ex}")

if __name__ == "__main__":
    load_password_exception()
```
{{< /tab >}}
{{< tab "protected.docx" >}}  
{{< tab-text >}}
`protected.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/loading/protected.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "load-password-exception.txt" >}}  
```text
Cannot open document: The document password is incorrect.
[.NET GroupDocs.Markdown.DocumentProtectedException]
   at .(Stream , LoadOptions )

   at .(Stream , LoadOptions , ConvertOptions , Stream )

   at GroupDocs.Markdown.MarkdownConverter.(ConvertOptions , Stream , Boolean )

   at GroupDocs.Markdown.MarkdownConverter.Convert(ConvertOptions convertOptions)

   at GroupDocs.Markdown.MarkdownConverter.ToMarkdown(String sourcePath, LoadOptions loadOptions, ConvertOptions
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/load_password_exception/load-password-exception.txt)
{{< /tab >}}
{{< tab "load-password-exception.txt" >}}  
```text
Cannot open document: The document password is incorrect.
[.NET GroupDocs.Markdown.DocumentProtectedException]
   at .(Stream , LoadOptions )

   at .(Stream , LoadOptions , ConvertOptions , Stream )

   at GroupDocs.Markdown.MarkdownConverter.(ConvertOptions , Stream , Boolean )

   at GroupDocs.Markdown.MarkdownConverter.Convert(ConvertOptions convertOptions)

   at GroupDocs.Markdown.MarkdownConverter.ToMarkdown(String sourcePath, LoadOptions loadOptions, ConvertOptions
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/loading/load-a-password-protected-document/load_password_exception/load-password-exception.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Load a password-protected document

Path: /metadata/java/load-a-password-protected-document/

This example demonstrates how to load a password-protected document.

**advanced\_usage.loading\_files.LoadPasswordProtectedDocument**

```csharp
// Specify the password
LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("123");

// Constants.ProtectedDocx is an absolute or relative path to your document. Ex: @"C:\Docs\source.docx"
try (Metadata metadata = new Metadata(Constants.ProtectedDocx, loadOptions)) {
	// Extract, edit or remove metadata here
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load a password-protected document

Path: /metadata/net/load-a-password-protected-document/

This example demonstrates how to load a password-protected document.

**AdvancedUsage.LoadingFiles.LoadPasswordProtectedDocument**

```csharp
// Specify the password
var loadOptions = new LoadOptions
{
	Password = "123"
};

// Constants.ProtectedDocx is an absolute or relative path to your document. Ex: @"C:\Docs\source.docx"
using (var metadata = new Metadata(Constants.ProtectedDocx, loadOptions))
{
	// Extract, edit or remove metadata here
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Load a password-protected document

Path: /metadata/nodejs-java/load-a-password-protected-document/

This example demonstrates how to load a password-protected document.

**advanced\_usage.loading\_files.LoadPasswordProtectedDocument**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
try {
	var loadOptions = new LoadOptions();
	loadOptions.setPassword("123");
    const metadata = new groupdocs.metadata.Metadata("protected.docx", loadOptions);
  }
```
{{< /tab >}}
{{< /tabs >}}


## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Load a password-protected document

Path: /metadata/python-net/load-a-password-protected-document/

This example demonstrates how to load a password-protected document.

**advanced_usage.loading_files.load_password_protected_document**


```python
def run():
    # Specify the password
    load_options = gm.LoadOptions()
    load_options.password = "123"

    # constants.protected_docx is an absolute or relative path to your document. Ex: r"C:\\Docs\\source.docx"
    with gm.Metadata(constants.protected_docx, load_options) as metadata:
        # Extract, edit or remove metadata here
        # ...
        pass
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Load custom fonts

Path: /comparison/java/load-custom-fonts/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare documents that contains non-standard fonts.

To connect custom fonts and compare documents, follow these steps:

1. Instantiate the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object. Speicfy a list of directories with custom fonts.
2. Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object with source document path or stream and the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object created in the previous step.
3. Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
4. Call the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) method.

The following code snippet shows how to connect custom fonts and compare documents:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.load.LoadOptions;
import java.nio.file.Path;
// ...

// Instantiate the LoadOptions object and create a list of custom font directories.
LoadOptions loadOptions = new LoadOptions();
loadOptions.getFontDirectories().add("./fontPath/");
 
try (Comparer comparer = new Comparer(sourceDocument, loadOptions)) {
    comparer.add(targetDocument);
    final Path resultPath = comparer.compare(resultDocument);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load custom fonts

Path: /comparison/net/load-custom-fonts/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare documents that contains non-standard fonts.

To connect custom fonts and compare documents, follow these steps:

1. Instantiate the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object. Speicfy a list of directories with custom fonts.
2. Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object with source document path or stream and the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object created in the previous step.
3. Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
4. Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method.

The following code snippet shows how to connect custom fonts and compare documents:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

// Instantiate the LoadOptions object and create a list of custom font directories.
LoadOptions loadOptions = new LoadOptions();
loadOptions.FontDirectories.Add("./fontPath/");

using (Comparer comparer = new Comparer("source.docx", loadOptions))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load custom fonts

Path: /comparison/nodejs-java/load-custom-fonts/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare documents that contain non-standard fonts.

The following code snippet shows how to connect custom fonts and compare documents:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Enable strict mode for safer JavaScript
// Create LoadOptions and add a custom font directory
const loadOptions = new groupdocs.LoadOptions();
loadOptions.getFontDirectories().add('sample-files/font.otf'); // Register custom font for accurate rendering

// Define the path to the source document
const sourcePath = 'sample-files/source.docx';

// Initialize the Comparer with the source file and the load options
const comparer = new groupdocs.Comparer(sourcePath, loadOptions);

// Add the target document to the comparison set
comparer.add('sample-files/target.docx');

// Perform the comparison and save the result document
comparer.compare('result.docx');

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `LoadOptions` instance and adds a custom font directory using `getFontDirectories().add()`. It then initializes the `Comparer` with the source document path and the `LoadOptions` object, which ensures that custom fonts are available during comparison. The target document is added, and the comparison is performed. This allows documents with non-standard fonts to be compared accurately, as the custom fonts are registered and used for rendering.

---

## Load custom fonts

Path: /comparison/python-net/load-custom-fonts/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to compare documents that contain non-standard fonts.

To connect custom fonts and compare documents, follow these steps:

1. Instantiate the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object. Specify a list of directories with custom fonts.
2. Instantiate the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object with the source document path or stream and the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object created in the previous step.
3. Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method. Specify the target document path or stream.
4. Call the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> method.

The following code snippet shows how to connect custom fonts and compare documents:

```python
import groupdocs.comparison as gc

def load_custom_fonts(output_file_path, source_file_path, target_file_path):
    # Initialize LoadOptions and add font directory
    load_options = gc.options.LoadOptions()
    load_options.font_directories.append("./fontPath/")

    # Initialize comparer with the source document
    with gc.Comparer(source_file_path, load_options) as comparer:
        # Add the target document for comparison
        comparer.add(target_file_path, load_options)
        
        # Compare the documents and save the result
        comparer.compare(output_file_path)
    
    # Log the success message with the output file path
    print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
```
---

## Load document

Path: /editor/net/load-document/

> The text provides a comprehensive guide on how to load documents using the GroupDocs.Editor for .NET API. Below is a revised version that improves readability, consistency, and clarity.

---

### Load Document

This guide explains how to load a document from a local disk or file stream for editing using the GroupDocs.Editor for .NET API.

#### Introduction

In this article, you will learn how to load an input document into [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) and apply load options.

### Loading Documents

To load an input document, which should be accessible either as a byte stream or through a valid file path, you can create an instance of the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class using one of its constructor overloads. Below are examples of loading documents from a file path and from a stream.

```csharp
// Load document from file path
string inputFilePath = "C:\\input_path\\document.docx"; // Path to the document
Editor editor = new Editor(inputFilePath);

// Load document from stream
FileStream inputStream = System.IO.File.OpenRead(inputFilePath);
Editor editor = new Editor(inputStream);
```

When using the constructor overloads shown above, GroupDocs.Editor automatically detects the format of the input document and applies the most suitable default loading options. However, it is recommended to specify the correct loading options explicitly by using constructor overloads that accept two parameters. Here is how you can do this:

```csharp
// Load document from file path with load options
string inputFilePath = "C:\\input_path\\document.docx"; // Path to the document
WordProcessingLoadOptions wordLoadOptions = new WordProcessingLoadOptions();
Editor editor = new Editor(inputFilePath, wordLoadOptions); // Passing path and load options to the constructor

// Load document from stream with load options
MemoryStream inputStream = new MemoryStream(); // Stream obtained from somewhere
SpreadsheetLoadOptions spreadsheetLoadOptions = new SpreadsheetLoadOptions();
Editor editor = new Editor(inputStream, spreadsheetLoadOptions);
```

### Load Options

Please note that not all document formats have associated classes for load options. As of version 22.7, only WordProcessing, Spreadsheet, Presentation formats, and a distinct PDF format have specific load options classes. Other formats, such as DSV, TXT, or XML, do not have load options.

| Format Family      | Example Formats                      | Load Options Class                                                                                      |
|--------------------|--------------------------------------|---------------------------------------------------------------------------------------------------------|
| WordProcessing     | DOC, DOCX, DOCM, DOT, ODT            | [`WordProcessingLoadOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingloadoptions) |
| Spreadsheet        | XLS, XLSX, XLSM, XLSB                | [`SpreadsheetLoadOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetloadoptions)         |
| Presentation       | PPT, PPTX, PPS, POT                  | [`PresentationLoadOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationloadoptions)       |
| Fixed-layout format| PDF                                  | [`PdfLoadOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfloadoptions)                         |

### Handling Password-Protected Documents

Using load options is essential when working with password-protected documents. Any document can be loaded into the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance, even if it is password-protected. However, if the password is not handled correctly, an exception will be thrown during the editing process. Here’s how GroupDocs.Editor handles passwords:

1. If the document is not password-protected, any specified password will be ignored.
2. If the document is password-protected but no password is specified, a [`PasswordRequiredException`](https://reference.groupdocs.com/editor/net/groupdocs.editor/passwordrequiredexception) will be thrown during editing.
3. If the document is password-protected and an incorrect password is provided, an [`IncorrectPasswordException`](https://reference.groupdocs.com/editor/net/groupdocs.editor/incorrectpasswordexception) will be thrown during editing.

The example below demonstrates how to specify a password for opening a password-protected WordProcessing document:

```csharp
Stream inputStream = GetDocumentStreamFromSomewhere();
WordProcessingLoadOptions wordLoadOptions = new WordProcessingLoadOptions();
wordLoadOptions.Password = "correct_password";
Editor editor = new Editor(inputFilePath, wordLoadOptions);
```

{{< alert style="info" >}}The same approach applies to Spreadsheet, Presentation, and PDF documents as well.{{< /alert >}}

---

This revision enhances clarity, improves structure, and ensures that the instructions are easy to follow.
---

## Load document from FTP

Path: /annotation/java/load-document-from-ftp/


The following code snippet shows how to annotate document from FTP:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates loading document from FTP.

String filePath = "sample.pdf";
String server = "localhost";

// Create an instance of Annotator class and create connection and return stream with document
Annotator annotator = new Annotator(getFileFromFtp(server, filePath));
try {
    
    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation area = new AreaAnnotation();
    area.setBox(new Rectangle(100, 100, 100, 100));
    area.setBackgroundColor(65535);
    
    // Add annotation and save to file
    annotator.add(area);
    annotator.save("OutputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}

//...

private static InputStream getFileFromFtp(String server, String filePath) throws IOException {
    FTPClient client = new FTPClient();
    client.connect(server);
    InputStream inputStream = client.retrieveFileStream(filePath);
    client.disconnect();

    return inputStream;
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load document from FTP

Path: /annotation/net/load-document-from-ftp/


The following code snippet shows how to annotate document from FTP:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator(GetFileFromFtp("sample.pdf")))
{
	AreaAnnotation area = new AreaAnnotation()
	{
		Box = new Rectangle(100, 100, 100, 100),
		BackgroundColor = 65535,
	};
	annotator.Add(area);
	annotator.Save("result.pdf");
}

private static Stream GetFileFromFtp(string filePath)
{
	Uri uri = new Uri(filePath);
	FtpWebRequest request = CreateRequest(uri);
	using (WebResponse response = request.GetResponse())
                return GetFileStream(response);
}

private static FtpWebRequest CreateRequest(Uri uri)
{
	FtpWebRequest request = (FtpWebRequest)WebRequest.Create(uri);
	request.Method = WebRequestMethods.Ftp.DownloadFile;
		return request;
}

private static Stream GetFileStream(WebResponse response)
{
	MemoryStream fileStream = new MemoryStream();
	using (Stream responseStream = response.GetResponseStream())
		responseStream.CopyTo(fileStream);
		fileStream.Position = 0;
		return fileStream;
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load document from FTP

Path: /conversion/java/load-document-from-ftp/

The following code snippet shows how to convert a document from FTP:

```java
package com.groupdocs.conversion.examples.advanced_usage.loading.loading_documents_from_different_sources;

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.examples.Constants;
import com.groupdocs.conversion.exceptions.GroupDocsConversionException;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import org.apache.commons.net.ftp.FTPClient;
import java.io.File;
import java.io.InputStream;



/**
* This example demonstrates how to convert document downloaded from FTP.
*/
public class LoadDocumentFromFtp {
    public static void run()
    {
        String server = "ftp.example.com";
        String convertedFile = "C:\\output\\converted.pdf";   
        String filePath = "ftp://localhost/sample.doc";

        try {
            Converter converter = new Converter(getFileFromFtp(server, filePath));
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert(convertedFile, options);
        } 
        catch (Exception e){
            throw new GroupDocsConversionException(e.getMessage());
        }

        System.out.println("\nSource document converted successfully.\nCheck output in " + convertedFile);
    }

    private static InputStream getFileFromFtp(String server, String filePath) throws Exception
    {
        FTPClient client = new FTPClient();
        client.connect(server);
        return client.retrieveFileStream(filePath);
    }
}
```

---

## Load document from local disk

Path: /parser/net/load-document-from-local-disk/

GroupDocs.Parser provides the functionality to extract data from documents on the local disk.

The following example shows how to load the document from the local disk:

```csharp
// Create an instance of Parser class with the filePath
using (Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using (TextReader reader = parser.GetText())
    {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Load file from FTP

Path: /conversion/net/load-file-from-ftp/

The following code snippet shows how to convert a file from FTP:

```csharp
public static void Run()
{
    string outputFile = Path.Combine(@"c:\output", "converted.pdf");
    string filePath = "ftp://localhost/sample.doc";
    using (Converter converter = new Converter(() => GetFileFromFtp(filePath)))
    {
        PdfConvertOptions options = new PdfConvertOptions();
        converter.Convert(outputFile, options);
    }
}

private static Stream GetFileFromFtp(string filePath)
{
    Uri uri = new Uri(filePath);
    FtpWebRequest request = CreateRequest(uri);
    using (WebResponse response = request.GetResponse())
        return GetFileStream(response);
}

private static FtpWebRequest CreateRequest(Uri uri)
{
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(uri);
    request.Method = WebRequestMethods.Ftp.DownloadFile;
    return request;
}

private static Stream GetFileStream(WebResponse response)
{
    MemoryStream fileStream = new MemoryStream();
    using (Stream responseStream = response.GetResponseStream())
        responseStream.CopyTo(fileStream);
    fileStream.Position = 0;
    return fileStream;
}
```

---

## Load from FTP

Path: /viewer/java/load-document-from-ftp/


{{< alert style="info" >}}

Install the [Apache Commons Net library](https://mvnrepository.com/artifact/commons-net/commons-net/3.9.0) to use the FTP client.

{{< /alert >}}

The following code snippet shows how to load a document from FTP:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import org.apache.commons.net.ftp.FTP;
import org.apache.commons.net.ftp.FTPClient;
// ...

FTPClient ftpClient = new FTPClient();

ftpClient.connect(server, 21);
ftpClient.login(ftpUser, ftpPassword);
ftpClient.setFileType(FTP.BINARY_FILE_TYPE);

try (final InputStream inputStream = ftpClient.retrieveFileStream(remoteFile);
     Viewer viewer = new Viewer(inputStream)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load from FTP

Path: /viewer/net/load-document-from-ftp/

The following code snippet shows how to load a document from FTP:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using System.IO;
using System.Net;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

Stream stream = GetFileFromFtp("sample.docx");
using (Viewer viewer = new Viewer(stream))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}

static Stream GetFileFromFtp(string filePath)
{
    Uri uri = new Uri(filePath);
    FtpWebRequest request = CreateRequest(uri);
    using (WebResponse response = request.GetResponse())
        return GetFileStream(response);
}

static FtpWebRequest CreateRequest(Uri uri)
{
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(uri);
    request.Method = WebRequestMethods.Ftp.DownloadFile;
    return request;
}

static Stream GetFileStream(WebResponse response)
{
    MemoryStream fileStream = new MemoryStream();
    using (Stream responseStream = response.GetResponseStream())
        responseStream.CopyTo(fileStream);
    fileStream.Position = 0;
    return fileStream;
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports System.IO
Imports System.Net
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Dim stream As Stream = GetFileFromFtp("sample.docx")
        Using viewer As New Viewer(stream)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub

    Private Function GetFileFromFtp(ByVal filePath As String) As Stream
        Dim uri As New Uri(filePath)
        Dim request As FtpWebRequest = CreateRequest(uri)
        Using response As WebResponse = request.GetResponse()
            Return GetFileStream(response)
        End Using
    End Function

    Private Function CreateRequest(ByVal uri As Uri) As FtpWebRequest
        Dim request As FtpWebRequest = DirectCast(WebRequest.Create(uri), FtpWebRequest)
        request.Method = WebRequestMethods.Ftp.DownloadFile
        Return request
    End Function

    Private Function GetFileStream(ByVal response As WebResponse) As Stream
        Dim fileStream As New MemoryStream()
        Using responseStream As Stream = response.GetResponseStream()
            responseStream.CopyTo(fileStream)
        End Using
        fileStream.Position = 0
        Return fileStream
    End Function
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Load Markup document with options

Path: /conversion/java/load-markup-document-with-options/

This documentation covers the process of loading markup documents with configurable settings using [WebLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/). By leveraging these options, developers can efficiently manage markup files like HTML and MHTML, enabling accurate conversion to formats such as PDF, DOCX, or PNG. The [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/) library ensures proper handling of embedded resources and document styling. The following options could be set:
| Option | Description |
|--------|-------------|
|[**setBasePath()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/#getBasePath--) | Specifies the base path/url for the HTML. |  
|[**setEncoding()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/#getEncoding--) | Specifies the encoding to be used to load the document. If not specified, the encoding will be determined from the document's character set attribute. |
|[**setPageNumbering()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/#isPageNumbering--) | Whether to generate page numbers for the converted document. Default: false. |
|[**setResourceLoadingTimeout()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/#getResourceLoadingTimeout--) | Specifies the timeout of loading the external resources. |
|[**setSkipExternalResources()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/#getSkipExternalResources--) |  If enabled, the external resources (except for those listed in `WhitelistedResources`) will not be loaded during the conversion. |
|[**setWhitelistedResources()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/#getWhitelistedResources--) | Specifies which external resources will be loaded even when the loading of other external resources is restricted. |

## Enable page numbering when converting to Word-processing formats

The following code example demonstrates how to convert a markup document while adding page numbering during the conversion process.

{{< tabs "code-example">}}
{{< tab "ConvertMarkupWithAddingPageNumbering.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
import com.groupdocs.conversion.options.load.WebLoadOptions;

public class ConvertMarkupWithAddingPageNumbering {
    public static void convert() {
        WebLoadOptions loadOptions =  new WebLoadOptions();
        loadOptions.setPageNumbering(true);
        loadOptions.setSkipExternalResources(true);

        try(Converter converter = new Converter("groupdocs.html", () -> loadOptions)) {
            WordProcessingConvertOptions options = new WordProcessingConvertOptions();
            converter.convert("converted_with_pagenumbering.docx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "groupdocs.html" >}}  
{{< tab-text >}}
`groupdocs.html` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-markup-document-with-options/groupdocs.html) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_pagenumbering.docx" >}}  
{{< tab-text >}}
`converted_with_pagenumbering.docx` is converted DOCX document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-markup-document-with-options/converted_with_pagenumbering.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Skip loading of external resources

External resources in the context of web documents refer to any files or data that a web page or website fetches from sources outside of its own domain or server. These external resources are essential for creating dynamic and feature-rich web experiences. Common external resources include images, audio, video, fonts, CSS, scripts, frameworks, and so on. 

In some cases, you may want to skip loading all or just some of the external resources during the conversion. For example, when these resources become unavailable. Read the [Skip loading of external resources]({{< ref "conversion/java/developer-guide/loading-documents/skip-external-resources.md" >}}) article to learn how to do this with [**GroupDocs.Conversion for Java**](https://products.groupdocs.com/conversion/java/).

---

## Load Markup document with options

Path: /conversion/net/load-markup-document-with-options/

GroupDocs.Conversion provides [WebLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions) to give you control over how the source markup document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[BasePath](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/basepath)** | Specifies the base path/url for the HTML. |  
|**[Encoding](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/encoding)** | Specifies the encoding to be used to load the document. If not specified, the encoding will be determined from the document's character set attribute. |
|**[PageNumbering](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/pagenumbering)** | Whether to generate page numbers for the converted document. Default: false. |
|**[ResourceLoadingTimeout](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/resourceloadingtimeout)** | Specifies the timeout of loading the external resources. |
|**[SkipExternalResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/skipexternalresources)** |  If enabled, the external resources (except for those listed in `WhitelistedResources`) will not be loaded during the conversion. |
|**[WhitelistedResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/whitelistedresources)** | Specifies which external resources will be loaded even when the loading of other external resources is restricted. |

## Enable page numbering when converting to Word-processing formats

The following code snippet shows how to convert a markup document and insert page numbering:

```csharp
var source = "sample.html";
var loadOptions = new WebLoadOptions
{
    PageNumbering = true
};
using (var converter = new Converter(source, (LoadContext loadContext) => loadOptions))
{
    var options = new WordProcessingConvertOptions();
    converter.Convert("converted.docx" , options);
}
```

## Skip loading of external resources

External resources in the context of web documents refer to any files or data that a web page or website fetches from sources outside of its own domain or server. These external resources are essential for creating dynamic and feature-rich web experiences. Common external resources include images, audio, video, fonts, CSS, scripts, frameworks, and so on. 

In some cases, you may want to skip loading all or just some of the external resources during the conversion. For example, when these resources become unavailable. Read the [Skip loading of external resources]({{< ref "conversion/net/developer-guide/advanced-usage/loading/skip-external-resources.md" >}}) article to learn how to do this with **GroupDocs.Conversion for .NET**.

---

## Load Note document with options

Path: /conversion/java/load-note-document-with-options/

This documentation explains how to load Note documents, such as OneNote files, using GroupDocs.Conversion for Java with [NoteLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/NoteLoadOptions) class. The API allows developers to specify parameters for processing Note documents, including page ranges and rendering settings, enabling precise control over conversion to formats like PDF, PNG, or DOCX. The following options could be set:
| Option | Description |
|--------|-------------|
| [**setDefaultFont()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/NoteLoadOptions#setDefaultFont(java.lang.String)) | Specifies a default font for Note document. The specified font will be used if a font is missing. |
| [**setFontSubstitutes()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/NoteLoadOptions#setFontSubstitutes(java.util.List)) | Specifies substitutes specific fonts from the Note document. |
| [**setPassword()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/NoteLoadOptions#setPassword(java.lang.String)) | Specifies a password to unlock the protected document. |

### Specify font substitution

The following code snippet shows how to convert a Note document and specify font substitution for missing fonts:

{{< tabs "code-example">}}
{{< tab "ConvertNoteBySpecifyingFontSubstitution.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.FontSubstitute;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
import com.groupdocs.conversion.options.load.NoteLoadOptions;
import java.util.ArrayList;
import java.util.List;

public class ConvertNoteBySpecifyingFontSubstitution {
    public static void convert() {
        NoteLoadOptions loadOptions =  new NoteLoadOptions();

        List<FontSubstitute> fontSubstitutes = new ArrayList<FontSubstitute>();
        fontSubstitutes.add(FontSubstitute.create("Calibri", "Arial"));
        fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial"));

        loadOptions.setFontSubstitutes(fontSubstitutes);

        try(Converter converter = new Converter("sample.one", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_font_substitution.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.one" >}}  
{{< tab-text >}}
`sample.one` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-note-document-with-options/sample.one) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_font_substitution.pdf" >}}  
{{< tab-text >}}
`converted_with_font_substitution.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-note-document-with-options/converted_with_font_substitution.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Load Note document with options

Path: /conversion/nodejs-java/load-note-document-with-options/

GroupDocs.Conversion provides [NoteLoadOptions](#) to give you control over how the source Note document will be processed. The following options could be set:

*   **[setDefaultFont](#)** specifies a default font for Note document. The specified font will be used if a font is missing.
*   **[setFontSubstitutes](#)** specifies substitutes specific fonts from the Note document.
*   **[setPassword](#)** specifies a password to unlock the protected document.

### Specify font substitution

The following code snippet shows how to convert a Note document and specify font substitution for missing fonts:

```js
const java = require('java')

const outputPath = "convertNoteBySpecifyingFontSubstitution.pdf"

const fontSubstitutes = java.newInstanceSync("java.util.ArrayList")
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Tahoma", "Arial"));
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Times New Roman", "Arial"));

const loadOptions = new groupdocs.conversion.NoteLoadOptions();
loadOptions.setFontSubstitutes(fontSubstitutes);

const converter = new groupdocs.conversion.Converter("sample.one", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`Note document converted successfully to ${outputPath} (specifying font subs)`)
converter.convert(outputPath, convertOptions)
```

---

## Load password-protected document

Path: /conversion/net/load-password-protected-document/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) supports the conversion of documents that are protected with a password.

To load and convert a password-protected document, follow these steps:

1.   Define a Func<[LoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/loadoptions)\> delegate, which should return an instance of document-specific load options with the password specified.
2.   Create an instance of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class and pass the source document path and the load options delegate as the constructor parameters.
3.   Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) class e.g. (**[PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions)**, **[WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions)**, **[SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions)**, etc.)
4.   Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class instance and pass the filename for the converted document and the instance of the [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) from the previous step.

The following code snippet shows how to convert password protected document:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new WordProcessingLoadOptions
{
    Password = "12345"
};
using (Converter converter = new Converter("sample_with_password.docx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

You can also use [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}}):

```csharp
FluentConverter
    .Load("sample_with_password.docx").WithOptions((LoadContext loadContext) => new WordProcessingLoadOptions
    {
        Password = "12345"
    })
    .ConvertTo("converted.pdf")
    .Convert();
```

---

## Load password-protected document

Path: /watermark/java/load-password-protected-document/

Some document formats also support content encryption. To load these type of documents you will have to provide the password. GroupDocs.Watermark API allows you to load content of these documents to manage watermark.

## Load password-protected document of any supported format

The following example demonstrates how to load an encrypted document of any supported format using the password. If the password is incorrect, [InvalidPasswordException](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.exceptions/InvalidPasswordException) is thrown.

**advanced\_usage.loading\_documents.LoadPasswordProtectedDocument**

```java
LoadOptions loadOptions = new LoadOptions();                                                                                   
loadOptions.setPassword("P@$$w0rd");                                                                                           
// Specify an absolute or relative path to your document. Ex: @"C:\\Docs\\protected-document.docx"
String filePath = "protected-document.docx";                                                                           
Watermarker watermarker = new Watermarker(filePath, loadOptions);                                                              
                                                                                                                               
// use watermarker methods to manage watermarks in the document                                                                
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));                                          
                                                                                                                               
watermarker.add(watermark);                                                                                                    
                                                                                                                               
watermarker.save("protected-document.docx");                                                                          
                                                                                                                               
watermarker.close();                                                                                                         
```

## Load password-protected word processing document

The following example demontrates how to load an encrypted word processing document (DOC, DOCX etc) using the password.

**advanced\_usage.loading\_documents.LoadPasswordProtectedWordProcessingDocument**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                                       
loadOptions.setPassword("P@$$w0rd");                                                                                           
// Specify an absolute or relative path to your document. Ex: @"C:\\Docs\\protected-document.docx"
String filePath = "protected-document.docx";                                                                           
Watermarker watermarker = new Watermarker(filePath, loadOptions);                                                              
                                                                                                                               
// use watermarker methods to manage watermarks in the WordProcessing document                                                 
TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));                                          
                                                                                                                               
watermarker.add(watermark);                                                                                                    
                                                                                                                               
watermarker.save("protected-document.docx");                                                                          
                                                                                                                               
watermarker.close();                                                                                                         

```

The following [LoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/LoadOptions) descendants use [setPassword](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/LoadOptions#setPassword(java.lang.String)) method:

*   [DiagramLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/DiagramLoadOptions)
*   [PdfLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PdfLoadOptions)
*   [PresentationLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/PresentationLoadOptions)
*   [SpreadsheetLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/SpreadsheetLoadOptions)
*   [WordProcessingLoadOptions](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.options/WordProcessingLoadOptions)


---

## Load Password-Protected File

Path: /conversion/python-net/developer-guide/loading-documents/load-password-protected-file/


With *GroupDocs.Conversion for Python via .NET* you to load and convert documents that are protected with a password. This feature is useful when you need to handle documents that require authentication to access their contents. 

To load and convert a password-protected document, follow the steps outlined in the code example below:

{{< tabs "code-example">}}
{{< tab "load_password_protected_file.py" >}}  
```python
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions
from groupdocs.conversion.options.load import WordProcessingLoadOptions

def load_password_protected_file():
    # Set file path
    file_path = "./password-protected.docx"
    
    # Instantiate load options and set password
    wp_load_options = WordProcessingLoadOptions()
    wp_load_options.password = "12345"

    # Specify source file stream and load options
    converter = Converter(file_path, wp_load_options)
    
    # Specify output file location and convert options
    output_path = "./password-protected.pdf"
    pdf_convert_options = PdfConvertOptions()
    pdf_convert_options.password = "67890"

    # Convert and save to output path
    converter.convert(output_path, pdf_convert_options)

if __name__ == "__main__":
    load_password_protected_file()

```
{{< /tab >}}
{{< tab "password-protected.docx" >}}  
{{< tab-text >}}
`password-protected.docx` is sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-password-protected-file/password-protected.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "password-protected.pdf" >}}  
{{< tab-text >}}
`password-protected.pdf` is converted PDF document. Click [here](/conversion/python-net/_sample_files/developer-guide/loading-documents/load-password-protected-file/password-protected.pdf) to download it. The file is password-protected. Password is `67890`.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

In case the provided password is incorrect, a runtime error will be thrown. The expected error and error message are as follows:

```bash
RuntimeError: Proxy error(CorruptOrDamagedFileException): Cannot convert. The file is corrupt or damaged. The document password is incorrect. ---> IncorrectPasswordException: The document password is incorrect.
```

### Explanation

1. **File Path Setup**: The file path for the password-protected document is specified. In this example, it assumes that the document is named `password-protected.docx`.

2. **Load Options**: An instance of `WordProcessingLoadOptions` is created, and the password required to open the document is set.

3. **Converter Initialization**: A `Converter` instance is created using the file path and the load options that include the password.

4. **Convert Options**: An instance of `PdfConvertOptions` is created for the conversion process. You can also set the output password for the resulting PDF if required.

4. **Conversion Execution**: Finally, the `convert` method is called on the `Converter` instance to convert the password-protected document and save it as a PDF.

### Conclusion

This example demonstrates how to efficiently load and convert password-protected documents using the GroupDocs.Conversion for Python API. Make sure to replace the passwords and file paths with your actual values before executing the code.

---

## Load specific file formats

Path: /parser/python-net/load-specific-file-formats/


In some cases, it's required to specify the document format manually to guarantee correct output produced by GroupDocs.Parser. The following are the cases when the document format must be specified manually:

*   Markdown documents
*   MHTML documents
*   OTP documents (OpenDocument Presentation Template)
*   Databases
*   Emails from remote servers

Here are the steps to specify the document format:

1. Instantiate the `LoadOptions` object and pass the document format in the constructor
2. Create `Parser` object with the file path and `LoadOptions`
3. Call extraction methods as usual

## Load Markdown document

The following example shows how to specify the document format for Markdown document:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions, FileFormat

# Create LoadOptions for Markdown format
load_options = LoadOptions(FileFormat.MARKUP)

# Open the file stream
with open("sample.md", "rb") as stream:
    # Create an instance of Parser class with LoadOptions
    with Parser(stream, load_options) as parser:
        # Extract text from the Markdown document
        text_reader = parser.get_text()
        
        if text_reader is not None:
            # Print the extracted text
            # Markdown is detected; text without special symbols is printed
            print(text_reader)
        else:
            print("Text extraction isn't supported")
```

{{< /tab >}}
{{< /tabs >}}

## Load MHTML document
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions, FileFormat

# Create LoadOptions for MHTML format
load_options = LoadOptions(FileFormat.MHTML)

# Load MHTML document
with Parser("email_page.mhtml", load_options) as parser:
    # Extract text
    text_reader = parser.get_text()
    
    if text_reader:
        print(text_reader)
```

{{< /tab >}}
{{< /tabs >}}

## Load OTP document
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions, FileFormat

# Create LoadOptions for OTP (OpenDocument Presentation Template) format
load_options = LoadOptions(FileFormat.OTP)

# Load OTP document
with Parser("template.otp", load_options) as parser:
    # Get document info
    doc_info = parser.get_document_info()
    
    print(f"File type: {doc_info.file_type.file_format}")
    print(f"Pages: {doc_info.page_count}")
    
    # Extract text
    text_reader = parser.get_text()
    if text_reader:
        print(text_reader)
```

{{< /tab >}}
{{< /tabs >}}

## Detect format and load appropriately

You can create a helper function to detect and load documents with appropriate format:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions, FileFormat
import os

def get_file_format(file_path):
    """Detect file format based on extension"""
    
    _, ext = os.path.splitext(file_path)
    ext = ext.lower()
    
    format_map = {
        '.md': FileFormat.MARKUP,
        '.markdown': FileFormat.MARKUP,
        '.mhtml': FileFormat.MHTML,
        '.mht': FileFormat.MHTML,
        '.otp': FileFormat.OTP,
    }
    
    return format_map.get(ext)

def load_document_with_format(file_path):
    """Load document with appropriate format specification"""
    
    file_format = get_file_format(file_path)
    
    if file_format:
        print(f"Loading with explicit format: {file_format}")
        load_options = LoadOptions(file_format)
        parser = Parser(file_path, load_options)
    else:
        print("Loading with auto-detection")
        parser = Parser(file_path)
    
    return parser

# Usage examples
with load_document_with_format("webpage.mhtml") as parser:
    text_reader = parser.get_text()
    if text_reader:
        print(text_reader)
```

{{< /tab >}}
{{< /tabs >}}

## Available file formats

The `FileFormat` enumeration includes the following formats:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser.options import FileFormat

# Common document formats (auto-detected)
# - PDF
# - DOC, DOCX
# - XLS, XLSX
# - PPT, PPTX
# - TXT
# - etc.

# Formats that may require explicit specification:
formats_needing_specification = {
    "Markdown": FileFormat.MARKUP,
    "MHTML": FileFormat.MHTML,
    "OTP": FileFormat.OTP,
}

for name, format_value in formats_needing_specification.items():
    print(f"{name}: {format_value}")
```

{{< /tab >}}
{{< /tabs >}}

## Error handling when loading specific formats
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

def safe_load_with_format(file_path, file_format):
    """Safely load a document with specific format and error handling"""
    
    try:
        # Create LoadOptions
        load_options = LoadOptions(file_format)
        
        # Create Parser instance
        with Parser(file_path, load_options) as parser:
            # Verify loading was successful
            doc_info = parser.get_document_info()
            print(f"Document loaded: {doc_info.file_type.file_format}")
            
            # Extract text
            text_reader = parser.get_text()
            if text_reader:
                return text_reader
            else:
                print("Text extraction not supported")
                return None
                
    except Exception as e:
        print(f"Error loading document with format {file_format}: {e}")
        
        # Try loading without format specification
        try:
            print("Attempting to load with auto-detection...")
            with Parser(file_path) as parser:
                text_reader = parser.get_text()
                if text_reader:
                    return text_reader
        except Exception as e2:
            print(f"Auto-detection also failed: {e2}")
            return None

# Example usage
from groupdocs.parser.options import FileFormat
text = safe_load_with_format("document.md", FileFormat.MARKUP)
```

{{< /tab >}}
{{< /tabs >}}

## When to use format specification

Use explicit format specification when:

1. **Working with Markdown files** - Always specify `FileFormat.MARKUP` for `.md` files
2. **Processing MHTML web archives** - Specify `FileFormat.MHTML` for `.mhtml` or `.mht` files
3. **Loading OTP templates** - Specify `FileFormat.OTP` for OpenDocument presentation templates
4. **Connecting to databases** - Specify appropriate database format
5. **Fetching emails from remote servers** - Specify email format when loading from network

In most other cases, GroupDocs.Parser can automatically detect the document format based on file extension and content.

## More resources

### GitHub examples

You may find more code examples in our GitHub repository:

*   [GroupDocs.Parser for Python via .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET)

### Free online document parser

Along with the full-featured library, we provide a free online document parser app. You are welcome to extract data from PDF, DOCX, XLSX, and more with our [Free Online Document Parser App](https://products.groupdocs.app/parser).


---

## Locating signature in the Word header or footer

Path: /signature/net/locating-signature-in-word-header/


A Word document offers a diverse selection of pre-designed headers and footers, providing you with options to enhance the design and layout of your document effortlessly. The header, positioned in the top margin, and the footer, located in the bottom margin, serve as integral sections of the document layout. Typically, headers and footers play host to supplementary details like page numbers, dates, author identification, and footnotes.

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to locate signature in the footer and header of Word document. Use enumeration [ShapePosition](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/shapeposition) contains following valuesks

* Default - signature will be placed in the docx document body
* Header - signature will be placed in the word document header
* Footer - signature will be placed in the word document footer

Here are the steps to set signature mode with adding text into Word document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) and setup [ShapePosition](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/shapeposition) property
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance.

## Locate Signature Area in the Word header/footer
Now, users can easily create and customize text signatures directly within the headers and footers of their Word documents.

```csharp
    using (Signature signature = new Signature("sample.docx"))
    {
        var listOptions = new List<SignOptions>();

        var headerSign = new TextSignOptions("Hello header!")
        {
            ShapePosition = ShapePosition.Header
        };

        var footerSign = new TextSignOptions("Hello footer!")
        {
            ShapePosition = ShapePosition.Footer
        };

        listOptions.Add(headerSign);
        listOptions.Add(footerSign);

        signature.Sign(outputFilePath, listOptions);
    }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Markdown

Path: /parser/java/markdown/

The following example shows how to extract Markdown formatted text:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Markdown))) {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Formatted text extraction isn't suppported" : reader.readToEnd());
    }
}
```

The API supports the following formatting:

*   Bold text
*   Italic text
*   Hyperlinks
*   Headings
*   Numbering and bullets lists
*   Tables

The following Microsoft Word document is used as input document:

![](/parser/java/images/markdown.png)

The following Markdown document is extracted using the example above:

![](/parser/java/images/markdown_1.png)

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Merge Excel spreadsheets

Path: /merger/java/merge/excel/


A **spreadsheet** file contains data in the form of rows and columns. A spreadsheet file can be saved in several different file formats, each having a different file extension for unique representation. Data is stored in cells either in plain form such as text string, numbers, date, currency, etc. or as formulas that change a cell’s value when referenced cell values change.

Common spreadsheet file extensions and their file formats include **XLSX** (Microsoft Excel Open XML Spreadsheet), **ODS** (OpenDocument Spreadsheet) and **XLS** (Microsoft Excel Binary File Format).

XLSX is well-known format for Microsoft Excel documents that was introduced by Microsoft with the release of Microsoft Office 2007. Based on structure organized according to the Open Packaging Conventions as outlined in Part 2 of the OOXML standard ECMA-376, the new format is a zip package that contains a number of XML files. The underlying structure and files can be examined by simply unzipping the .xlsx file.

## How to merge XLSX files programmatically

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to merge XLSX files when it's needed to organize multiple
 XLSX files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine XLSX documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge XLSX files with several lines of java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source XLSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another XLSX file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other XLSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged XLSX file as parameter.

```java
// Load the source XLSX file
Merger merger = new Merger("c:\sample1.xlsx")

// Add another XLSX file to merge
merger.join("c:\sample2.xlsx");
// Merge XLSX files and save result
merger.save("c:\merged.xlsx");
```

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge XLSX Live Demo

GroupDocs.Merger for Java provides an online [**XLSX Merger App**](https://products.groupdocs.app/merger/xlsx), which allows you to try it for free and check its quality and accuracy.

---

## Merge Excel spreadsheets

Path: /merger/nodejs-java/merge/excel/


A **spreadsheet** file contains data in the form of rows and columns. A spreadsheet file can be saved in several different file formats, each having a different file extension for unique representation. Data is stored in cells either in plain form such as text string, numbers, date, currency, etc. or as formulas that change a cell’s value when referenced cell values change.

Common spreadsheet file extensions and their file formats include **XLSX** (Microsoft Excel Open XML Spreadsheet), **ODS** (OpenDocument Spreadsheet) and **XLS** (Microsoft Excel Binary File Format).

XLSX is well-known format for Microsoft Excel documents that was introduced by Microsoft with the release of Microsoft Office 2007. Based on structure organized according to the Open Packaging Conventions as outlined in Part 2 of the OOXML standard ECMA-376, the new format is a zip package that contains a number of XML files. The underlying structure and files can be examined by simply unzipping the .xlsx file.

## How to merge XLSX files programmatically

[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) allows developers to merge XLSX files when it's needed to organize multiple
 XLSX files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine XLSX documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge XLSX files with several lines of java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source XLSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another XLSX file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other XLSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged XLSX file as parameter.

```js
const merger = new groupdocs.merger.Merger('c:/sample1.xlsx');
merger.join('c:/sample2.xlsx');
merger.save('c:/merged.xlsx');
```

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge XLSX Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**XLSX Merger App**](https://products.groupdocs.app/merger/xlsx), which allows you to try it for free and check its quality and accuracy.

---

## Merge Excel spreadsheets

Path: /merger/python-net/merge/excel/


A **spreadsheet** file contains data in the form of rows and columns. A spreadsheet file can be saved in several different file formats, each having a different file extension for unique representation. Data is stored in cells either in plain form such as text string, numbers, date, currency, etc. or as formulas that change a cell’s value when referenced cell values change.

Common spreadsheet file extensions and their file formats include **XLSX** (Microsoft Excel Open XML Spreadsheet), **ODS** (OpenDocument Spreadsheet) and **XLS** (Microsoft Excel Binary File Format).

XLSX is well-known format for Microsoft Excel documents that was introduced by Microsoft with the release of Microsoft Office 2007. Based on structure organized according to the Open Packaging Conventions as outlined in Part 2 of the OOXML standard ECMA-376, the new format is a zip package that contains a number of XML files. The underlying structure and files can be examined by simply unzipping the .xlsx file.

## How to merge XLSX files programmatically

[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) allows developers to merge XLSX files when it's needed to organize multiple
 XLSX files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine XLSX documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge XLSX files with several lines of net code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source XLSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another XLSX file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other XLSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged XLSX file as parameter.

```python
with gm.Merger("c:/sample1.xlsx") as merger:
    merger.join("c:/sample2.xlsx")
    merger.save("c:/merged.xlsx")
```

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge XLSX Live Demo

GroupDocs.Merger for Python via .NET provides an online [**XLSX Merger App**](https://products.groupdocs.app/merger/xlsx), which allows you to try it for free and check its quality and accuracy.

---

## Migration Notes

Path: /annotation/java/migration-notes/


## Why to migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Annotation for Java since version 19.8:
*   The `Annotator` class introduced as a single entry point to manage the document annotating process to any supported file format (instead of `AnnotationImageHandler` class in previous versions).
*   The overall rendering speed improved dramatically by saving rendered page as soon as it was rendered, not when all pages list were rendered.
*   Document saving options simplified so it is easy to instantiate proper options class and to control over document annotating and saving processes.

## How to migrate?

Here is a brief comparison of how to annotate document and save it using old and new API.

### Old coding style

{{< tabs "example1">}}
{{< tab "Java" >}} 
```java
List<AnnotationInfo> annotations = new List<AnnotationInfo>();
AnnotationInfo areaAnnotation = new AnnotationInfo();
areaAnnotation.setPageNumber(0);
areaAnnotation.setBox(new Rectangle(100, 100, 100, 100));
areaAnnotation.setType(Domain.AnnotationType.Area);
areaAnnotation.setText("area");

AnnotationInfo ellipseAnnotation = new AnnotationInfo();
ellipseAnnotation.setPageNumber(0);
ellipseAnnotation.setBox(new Rectangle(200, 200, 80, 80));
ellipseAnnotation.setType(Domain.AnnotationType.Ellipse);
ellipseAnnotation.setText("ellipse");           
 
// Create annotation config
AnnotationConfig config = new AnnotationConfig();

// Set storage path
config.setStoragePath("storage");

// Create annotation handler
AnnotationImageHandler annotator = new AnnotationImageHandler(config);

// Create input file
// Export annotations and save result
InputStream result = annotator.exportAnnotationsToDocument(fs, annotations);

// Save result stream to file.
OutputStream fileStream = new FileOutputStream("input.pdf");
IOUtils.copy(result, fileStream);
```
{{< /tab >}}
{{< /tabs >}}

### New coding style

{{< tabs "example2">}}
{{< tab "Java" >}} 
```java
// Create list of annotations
List<AnnotationBase> annotations = new List<AnnotationBase>();

AreaAnnotation areaAnnotation = new AreaAnnotation();
areaAnnotation.setPageNumber(0);
areaAnnotation.setBox(new Rectangle(100, 100, 100, 100));
areaAnnotation.setText("area");

EllipseAnnotation ellipseAnnotation = new EllipseAnnotation();
ellipseAnnotation.setPageNumber(0);
ellipseAnnotation.setBox(new Rectangle(200, 200, 80, 80));
ellipseAnnotation.setText("ellipse");
 
Annotator annotator = new Annotator("input.pdf");

// Add annotations
annotator.Add(annotations);

// Save result to "result.pdf"
annotator.Save("result.pdf", new SaveOptions());
```
{{< /tab >}}
{{< /tabs >}}
  
For more code snippets and specific use cases please refer to our [Developer Guide documentation]({{< ref "annotation/java/advanced-usage" >}}) or [GitHub](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-Java) samples and showcases.

---

## Migration Notes

Path: /annotation/net/migration-notes/


## Why to migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Annotation for .NET since version 19.8:
*   The `Annotator` class introduced as a single entry point to manage the document annotating process to any supported file format (instead of `AnnotationImageHandler` class in previous versions).
*   The overall rendering speed improved dramatically by saving rendered page as soon as it was rendered, not when all pages list were rendered.
*   Document saving options simplified so it is easy to instantiate proper options class and to control over document annotating and saving processes.

## How to migrate?
Here is a brief comparison of how to annotate document and save it using old and new API.

### Old coding style

{{< tabs "example1">}}
{{< tab "C#" >}} 
```csharp
// Creating annotation list
List<AnnotationInfo> annotations = new List<AnnotationInfo>()
{
    new AnnotationInfo()
    {
        PageNumber = 0,
        Box = new Rectangle(100, 100, 100, 100),
        Type = Domain.AnnotationType.Area,
        Text = "area"
    },
                
    new AnnotationInfo()
    {
        PageNumber = 0,
        Box = new Rectangle(200, 200, 80, 80),
        Type = Domain.AnnotationType.Ellipse,
        Text = "ellipse"
    }
};

// Create annotation config
AnnotationConfig config = new AnnotationConfig();
// Set storage path
config.StoragePath = "storage";
// Create annotation handler
AnnotationImageHandler annotator = new AnnotationImageHandler(config);
// Create input file
using (FileStream fs = new FileStream("input.pdf", FileMode.Open))
{
    // Export annotations and save result
    Stream result = annotator.ExportAnnotationsToDocument(fs, annotations);
}
```
{{< /tab >}}
{{< /tabs >}}

### New coding style

{{< tabs "example2">}}
{{< tab "C#" >}} 
```csharp
// Create list of annotations
List<AnnotationBase> annotations = new List<AnnotationBase>()
{
    new AreaAnnotation()
    {
        PageNumber = 0,
        Box = new Rectangle(100, 100, 100, 100),
        Message = "area"
    },
                
    new EllipseAnnotation()
        {
            PageNumber = 0,
            Box = new Rectangle(200, 200, 80, 80),
            Message = "ellipse"
        }
};

// Create annotator
using  (Annotator annotator = new Annotator("input.pdf"))
{
    // Add annotations
    annotator.Add(annotations);
    // Save result to "result.pdf"
    annotator.Save("result.pdf", new SaveOptions());
}
```
{{< /tab >}}
{{< /tabs >}}
  
For more code snippets and specific use cases please refer to our [Developer Guide documentation]({{< ref "annotation/net/advanced-usage" >}}) or [GitHub](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET) samples and showcases.

---

## Migration Notes

Path: /comparison/net/migration-notes/


### Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Comparison for .NET since version 19.9:

*   The `Comparer` class introduced as a single entry point to compare documents of any supported file format with various options and ability to accept/reject differences in output document.
*    Document compare options for all document types. Instead of using document related options now options are related to compare type only.
*    The overall document related classes were unified to common.
*    Product architecture was redesigned from scratch in order to simplify passing options and classes to manipulate comparison.
*    Document information and preview generation procedures were simplified.

### How To Migrate?

Here is a brief comparison of how to compare document with old and new API.

### Old coding style

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

Comparer comparer = new Comparer();
ComparisonSettings settings = new ComparisonSettings()
{
    StyleChangeDetection = true
};
ICompareResult result = comparer.Compare("source.docx", @"target.docx", settings);
result.SaveDocument("result.docx");
```
{{< /tab >}}
{{< /tabs >}}

### New coding style

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions compareOptions = new CompareOptions()
    {
        DetectStyleChanges = true
    };
	comparer.Compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Minify HTML

Path: /viewer/java/minify-html/


When you are looking for ways to optimize the rendering of documents to HTML, one of the solutions is the compression of the output content (HTML, CSS, and SVG). This is suitable if you provide your content from the web server over the Internet. The less the user has to download, the faster he accesses the rendered document.

{{< alert style="info" >}}Minification does not reduce content size as much as Gzip compression, so use it in addition to Gzip compression. {{< /alert >}}

## Minification

Minification provides the output that looks identically with the original content in all browsers, but minified HTML content does not pass strict HTML validation. The following describes the size reduction methods used in minification.

### HTML Minification

HTML minification includes the following:

* Complete removal of comments (except containing IE conditional statements).
* Conditional comments compression.
* Removal of spaces and line breaks inside the tags and between the tags.
* Simplification of document type declaration to `<!DOCTYPE html>`.
* Removal of all HTML tag properties.
* Removal of protocol declarations like http:, https:, and javascript: from path values.
* Replace multiple spaces between words (except when they occur inside the pre or textarea tag) with a single space.
* Removal of quotes around tag property values (except inline events).
* Removal of default attributes for "script", "style" and "link" tags.
* Simplification of boolean attributes, so `<input type="text" disabled="disabled">` becomes `<input type=text disabled>`.

### CSS Minification

CSS minification includes the following:

* Removal of all insignificant white spaces.
* Removal of all comments.
* Removal of all unnecessary semicolon separators.
* Reducing color values.
* Reducing integer representations by removing leading and trailing zeros.
* Removal of unit specifiers from numeric zero values.

## How to minify HTML and CSS

Use the [setMinify](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setMinify-boolean-) method of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class to enable minifying the output content.

The following code snippet shows how to enable minification:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.docx")){
     HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
     // Minify HTML output.
     viewOptions.setMinify(true);
     viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}


---

## Minify HTML

Path: /viewer/net/minify-html/


When you are looking for ways to optimize the rendering of documents to HTML, one of the solutions is the compression of the output content (HTML, CSS, and SVG). This is suitable if you provide your content from the web server over the Internet. The less the user has to download, the faster he accesses the rendered document.

{{< alert style="info" >}}Minification does not reduce content size as much as Gzip compression, so use it in addition to Gzip compression. {{< /alert >}}

## Minification

Minification provides the output that looks identically with the original content in all browsers, but minified HTML content does not pass strict HTML validation. The following describes the size reduction methods used in minification.

### HTML Minification

HTML minification includes the following:

* Complete removal of comments (except containing IE conditional statements).
* Conditional comments compression.
* Removal of spaces and line breaks inside the tags and between the tags.
* Simplification of document type declaration to `<!DOCTYPE html>`.
* Removal of all HTML tag properties.
* Removal of protocol declarations like http:, https:, and javascript: from path values.
* Replace multiple spaces between words (except when they occur inside the pre or textarea tag) with a single space.
* Removal of quotes around tag property values (except inline events).
* Removal of default attributes for "script", "style" and "link" tags.
* Simplification of boolean attributes, so `<input type="text" disabled="disabled">` becomes `<input type=text disabled>`.

### CSS Minification

CSS minification includes the following:

* Removal of all insignificant white spaces.
* Removal of all comments.
* Removal of all unnecessary semicolon separators.
* Reducing color values.
* Reducing integer representations by removing leading and trailing zeros.
* Removal of unit specifiers from numeric zero values.

## How to minify HTML and CSS

The [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) class has the [Minify](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/minify/) boolean property that is a flag to minify the output content.

The following code snippet shows how to enable minification:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create view options.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();

    // Render the minified file.
    viewOptions.Minify = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create view options.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
        
            ' Render the minified file.
            viewOptions.Minify = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}


---

## Multicolored Numbered List in HTML Document

Path: /assembly/java/multicolored-numbered-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in HTML Document format.{{< /alert >}}

## Multicolored Numbered List in HTML Document

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the clients in numbered list.
*   It must highlight the products.
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
<ol>
&lt;&lt;foreach [in getClients()]&gt;&gt;
<li &lt;&lt;if [indexOf() % 2 == 0]&gt;&gt;style="background-color:#FFF8DC"&lt;&lt;/if&gt;&gt;>&lt;&lt;[getName()]&gt;&gt;</li>
&lt;&lt;/foreach&gt;&gt;
</ol>
```

### Download Multicolored Numbered List Template

Please download the sample template we created in this article:

*   [Multicolored Numbered List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/Multicolored%20Numbered%20List.html?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist atirtahirgroupdocs c511abcfb4a85dba94fb95091a6e014a >}}



---

## Multicolored Numbered List in HTML Document

Path: /assembly/net/multicolored-numbered-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored numbered list report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

## Multicolored Numbered List in HTML Document

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in the numbered list.
*   It must highlight the products.
*   The report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:

<ol>

&lt;&lt;foreach [in products]&gt;&gt;
<li &lt;&lt;if [IndexOf() % 2 == 0]&gt;&gt;style="background-color:#FFF8DC"&lt;&lt;/if&gt;&gt;>&lt;&lt;[ProductName]&gt;&gt;</li>
&lt;&lt;/foreach&gt;&gt;
</ol>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download Multicolored Numbered List Template

Please download the multicolored numbered list template document we created in this article:

*   [Multicolored Numbered List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/Multicolored%20Numbered%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists 565c8c90f6d8cfe139534c6de81080cb >}}



---

## Numbered List in HTML Document

Path: /assembly/java/numbered-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Numbered List in HTML Document

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the client names in a numbered list.
*   Report must be generated in the HTML document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

We provide support for the following clients:
```
   <<foreach \[in getClients()\]>>
1.  <<\[getName()\]>>
   <</foreach>>
```

### Download Numbered List Template

Please download the sample template we created in this article:

*   [Numbered List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/Numbered%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists c5f6caf241562d1ad4a58ccd708adfae >}}



---

## Numbered List in HTML Document

Path: /assembly/net/numbered-list-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

## Numbered List in HTML Document

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in numbered list.
*   The report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<ol>
&lt;&lt;foreach [in products]&gt;&gt;
<li>&lt;&lt;[ProductName]&gt;&gt;</li>
&lt;&lt;/foreach&gt;&gt;
</ol>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/HTML%20Templates/Numbered%20List.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists b36160effc7441adc59a543ce5934fff >}}



---

## Parse data from documents

Path: /parser/java/parse-data-from-documents/

GroupDocs.Parser provides Document Parser feature that allows you to extract data from documents of various formats including PDF, Microsoft Word, Excel, LibreOffice formats etc. (see [full supported list]({{< ref "parser/java/getting-started/supported-document-formats.md" >}})).

With Document Parsing feature you can easily solve business automation tasks with the data extracted from your documents.

Using this feature is straightforward. Simply define a template programmatically and apply it.

# Parse data from documents

GroupDocs.Parser provides the functionality to extract basic metadata from documents by the [parseByTemplate(Template)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseByTemplate(com.groupdocs.parser.templates.Template)) method:

```java
DocumentData parseByTemplate(Template template);
```

This method parses data from the document by a user-generated template.

Here are the steps to parse data from the document by user-generated template:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [Template](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/Template) object with the user-generated template;
*   Call [parseByTemplate(Template)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseByTemplate(com.groupdocs.parser.templates.Template)) method and obtain [DocumentData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData) object;
*   Check if *data* isn't *null* (parse by template is supported for the document);
*   Iterate over field data to obtain form data.

The following example shows how to parse data from the document by user-generated template :

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleInvoicePdf)) {
    // Parse the document by the template
    DocumentData data = parser.parseByTemplate(GetTemplate());
    // Check if form extraction is supported
    if (data == null) {
        System.out.println("Parse Document by Template isn't supported.");
        return;
    }
    // Print extracted fields
    for (int i = 0; i < data.getCount(); i++) {
        System.out.print(data.get(i).getName() + ": ");
        PageTextArea area = data.get(i).getPageArea() instanceof PageTextArea
                ? (PageTextArea) data.get(i).getPageArea()
                : null;
        System.out.println(area == null ? "Not a template field" : area.getText());
    }
}

private static Template GetTemplate() {
    // Create detector parameters for "Details" table
    TemplateTableParameters detailsTableParameters = new TemplateTableParameters(new Rectangle(new Point(35, 320), new Size(530, 55)), null);
    // Create detector parameters for "Summary" table
    TemplateTableParameters summaryTableParameters = new TemplateTableParameters(new Rectangle(new Point(330, 385), new Size(220, 65)), null);
    // Create a collection of template items
    TemplateItem[] templateItems = new TemplateItem[]
            {
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 135), new Size(100, 10))), "FromCompany"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 150), new Size(100, 35))), "FromAddress"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 190), new Size(150, 2))), "FromEmail"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 250), new Size(100, 2))), "ToCompany"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 260), new Size(100, 15))), "ToAddress"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 290), new Size(150, 2))), "ToEmail"),
                    new TemplateField(new TemplateRegexPosition("Invoice Number"), "InvoiceNumber"),
                    new TemplateField(new TemplateLinkedPosition(
                            "InvoiceNumber",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "InvoiceNumberValue"),
                    new TemplateField(new TemplateRegexPosition("Order Number"), "InvoiceOrder"),
                    new TemplateField(new TemplateLinkedPosition(
                            "InvoiceOrder",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "InvoiceOrderValue"),
                    new TemplateField(new TemplateRegexPosition("Invoice Date"), "InvoiceDate"),
                    new TemplateField(new TemplateLinkedPosition(
                            "InvoiceDate",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "InvoiceDateValue"),
                    new TemplateField(new TemplateRegexPosition("Due Date"), "DueDate"),
                    new TemplateField(new TemplateLinkedPosition(
                            "DueDate",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "DueDateValue"),
                    new TemplateField(new TemplateRegexPosition("Total Due"), "TotalDue"),
                    new TemplateField(new TemplateLinkedPosition(
                            "TotalDue",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "TotalDueValue"),
                    new TemplateTable(detailsTableParameters, "details", null),
                    new TemplateTable(summaryTableParameters, "summary", null)
            };
    // Create a document template
    Template template = new Template(java.util.Arrays.asList(templateItems));
    return template;
}
```

## More resources

### Advanced usage topics

To learn more about template building and working with extracted data please refer the following guides:

*   [Working with templates]({{< ref "parser/java/developer-guide/advanced-usage/working-with-templates.md" >}})
*   [Working with data extracted by template]({{< ref "parser/java/developer-guide/advanced-usage/working-with-data-extracted-by-template.md" >}})

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Parse data from documents

Path: /parser/net/parse-data-from-documents/

GroupDocs.Parser provides Document Parser feature that allows you to extract data from documents of various formats including PDF, Microsoft Word, Excel, LibreOffice formats etc. (see [full supported list]({{< ref "parser/net/getting-started/supported-document-formats.md" >}}))).

With Document Parsing feature you can easily solve business automation tasks with the data extracted from your documents.

Using this feature is straightforward. Simply define a template programmatically and apply it.

## Parse data from documents

GroupDocs.Parser provides [Template](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/template) object to define a template and [ParseByTemplate](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parsebytemplate) method to apply the template to existing document.

```csharp
DocumentData ParseByTemplate(Template template)
```

Here are the steps to parse data from the document by user-generated template:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the existing document;
*   Instantiate [Template](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/template) object with the user-generated template;
*   Call [ParseByTemplate](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parsebytemplate) method and obtain [DocumentData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata) object;
*   Check if *data* isn't *null* (indicates that Parse by Template feature is supported for the document);
*   Iterate over field data to obtain the document data.

The following example shows how to parse data from the document by user-generated template :

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleInvoicePdf))
{
    // Parse the document by the template
    DocumentData data = parser.ParseByTemplate(GetTemplate());
    // Check if parsing document by template is supported
    if (data == null)
    {
        Console.WriteLine("Parsing Document by Template isn't supported.");
        return;
    }
    // Print extracted fields
    for (int i = 0; i < data.Count; i++)
    {
        Console.Write(data[i].Name + ": ");
        PageTextArea area = data[i].PageArea as PageTextArea;
        Console.WriteLine(area == null ? "Not a template field" : area.Text);
    }
}
private static Template GetTemplate()
{
    // Create detector parameters for "Details" table
    TemplateTableParameters detailsTableParameters = new TemplateTableParameters(new Rectangle(new Point(35, 320), new Size(530, 55)), null);
    // Create detector parameters for "Summary" table
    TemplateTableParameters summaryTableParameters = new TemplateTableParameters(new Rectangle(new Point(330, 385), new Size(220, 65)), null);
    // Create a collection of template items
    TemplateItem[] templateItems = new TemplateItem[]
    {
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 135), new Size(100, 10))), "FromCompany"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 150), new Size(100, 35))), "FromAddress"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 190), new Size(150, 2))), "FromEmail"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 250), new Size(100, 2))), "ToCompany"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 260), new Size(100, 15))), "ToAddress"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 290), new Size(150, 2))), "ToEmail"),
        new TemplateField(new TemplateRegexPosition("Invoice Number"), "InvoiceNumber"),
        new TemplateField(new TemplateLinkedPosition(
            "InvoiceNumber",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "InvoiceNumberValue"),
        new TemplateField(new TemplateRegexPosition("Order Number"), "InvoiceOrder"),
        new TemplateField(new TemplateLinkedPosition(
            "InvoiceOrder",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "InvoiceOrderValue"),
        new TemplateField(new TemplateRegexPosition("Invoice Date"), "InvoiceDate"),
        new TemplateField(new TemplateLinkedPosition(
            "InvoiceDate",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "InvoiceDateValue"),
        new TemplateField(new TemplateRegexPosition("Due Date"), "DueDate"),
        new TemplateField(new TemplateLinkedPosition(
            "DueDate",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "DueDateValue"),
        new TemplateField(new TemplateRegexPosition("Total Due"), "TotalDue"),
        new TemplateField(new TemplateLinkedPosition(
            "TotalDue",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "TotalDueValue"),
        new TemplateTable(detailsTableParameters, "details", null),
        new TemplateTable(summaryTableParameters, "summary", null)
    };
    // Create a document template
    Template template = new Template(templateItems);
    return template;
}
```

## More resources

### Advanced usage topics

To learn more about template building and working with extracted data please refer the following guides:

*   [Working with templates]({{< ref "parser/net/developer-guide/advanced-usage/working-with-templates.md" >}})
*   [Working with data extracted by template]({{< ref "parser/net/developer-guide/advanced-usage/working-with-data-extracted-by-template.md" >}})

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).

---

## Parse Data from Documents

Path: /parser/python-net/parse-data-from-documents/


Use template-based parsing to pull structured values (like invoice numbers, dates, tables) from documents.

## Parse data with a template
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.templates import Template, TemplateField, TemplateFixedPosition
from groupdocs.parser.data import Rectangle, Point, Size

template = Template([
    TemplateField(
        TemplateFixedPosition(Rectangle(Point(35.0, 135.0), Size(100.0, 10.0))),
        "CompanyName",
    ),
    TemplateField(
        TemplateFixedPosition(Rectangle(Point(35.0, 150.0), Size(100.0, 10.0))),
        "InvoiceNumber",
    ),
])

with Parser("./invoice.pdf") as parser:
    data = parser.parse_by_template(template)
    if data is None:
        print("Parsing by template isn't supported for this format.")
    else:
        # DocumentData exposes extracted fields as an indexed collection.
        for i in range(data.count):
            field = data[i]
            area = field.page_area
            text = getattr(area, "text", None)
            print(f"{field.name}: {text if text is not None else '[non-text value]'}")
```

{{< /tab >}}
{{< tab "invoice.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [invoice.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/parse-data-from-documents/invoice.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Steps

1. Build a `Template` with fields or tables (fixed positions, regex, linked positions, etc.).  
2. Call `parser.parse_by_template(template)` to receive `DocumentData`.  
3. Iterate through extracted fields by index (`data.count` and `data[i]`) and process each extracted value based on its type (text, table, etc.).

For complex templates (tables, linked fields, regex fields), see the [advanced templates guide]({{< ref "parser/python-net/developer-guide/advanced-usage/template-based-parsing/_index.md" >}}).


---

## Load password-protected document

Path: /watermark/net/load-password-protected-document/

Some document formats also support content encryption. To load these type of documents you will have to provide the password. GroupDocs.Watermark API allows you to load content of these documents to manage watermark.

## Load password-protected document of any supported format

The following example demonstrates how to load an encrypted document of any supported format using the password. If the password is incorrect, [InvalidPasswordException](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.exceptions/invalidpasswordexception)is thrown.

**AdvancedUsage.LoadingDocuments.LoadPasswordProtectedDocument**

```csharp
LoadOptions loadOptions = new LoadOptions();
loadOptions.Password = "P@$$w0rd";
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\protected-document.docx"
string filePath = "protected-document.docx";
using (Watermarker watermarker = new Watermarker(filePath, loadOptions))
{
    // use watermarker methods to manage watermarks in the document
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));

    watermarker.Add(watermark);

    watermarker.Save("protected-document.docx");
}
```

## Load password-protected word processing document

The following example demontrates how to load an encrypted word processing document (DOC, DOCX etc) using the password.

**AdvancedUsage.LoadingDocuments.LoadPasswordProtectedWordProcessingDocument**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.Password = "P@$$w0rd";
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\protected-document.docx"
string filePath = "protected-document.docx";
using (Watermarker watermarker = new Watermarker(filePath, loadOptions))
{
    // use watermarker methods to manage watermarks in the WordProcessing document
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
    watermarker.Add(watermark);
    watermarker.Save("protected-document.docx");
}

```

The following [LoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options/loadoptions) descendants use [Password](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options/loadoptions/properties/password) property:

* [DiagramLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.diagram/diagramloadoptions)
* [PdfLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.pdf/pdfloadoptions)
* [PresentationLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.presentation/presentationloadoptions)
* [SpreadsheetLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.spreadsheet/spreadsheetloadoptions)
* [WordProcessingLoadOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingloadoptions)

---

## Password-protected documents

Path: /parser/java/password-protected-documents/

GroupDocs.Parser provides the functionality to open the password-protected documents.

The following are the steps to work with password protected documents.

*   Instantiate the [LoadOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions) object;
*   Set password in [LoadOptions(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions#LoadOptions(java.lang.String)) constructor;
*   Create [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object and call any method.

The following code sample shows how to process password protected documents.

```java
try {
    String password = "123456";
    // Create an instance of Parser class with the password:
    try (Parser parser = new Parser(Constants.SamplePassword, new LoadOptions(password))) {
        // Check if text extraction is supported
        if (!parser.getFeatures().isText()) {
            System.out.println("Text extraction isn't supported.");
            return;
        }
        // Print the document text
        try (TextReader reader = parser.getText()) {
            System.out.println(reader.readToEnd());
        }
    }
} catch (InvalidPasswordException ex) {
    // Print the message if the password is incorrect or empty
    System.out.println("Invalid password");
}
```

If the password is incorrect or empty [InvalidPasswordException](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.exceptions/InvalidPasswordException) exception is thrown.

The following code shows how to check whether a file is password-protected:

```java
// Get a file info
FileInfo info = Parser.getFileInfo(filePath);
// Check IsEncrypted property
System.out.println(info.isEncrypted() ? "Password is required" : "");
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Pie Chart in Email Document

Path: /assembly/java/pie-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Presentation Document format.{{< /alert >}}

## Pie Chart in Email Document

### Creating a Pie Chart

Please follow below steps to create Pie Chart in MS Outlook 2013:

1.  Create a new Email.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Pie".
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your email.
5.  Edit the Worksheet with your data to update the chart.

### Reporting Requirement

As a report developer, you are required to share managers' contract prices dynamically with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show information on a Pie Chart.
*   It must indicate manager name with value (price of the contract).

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Price<<foreach [in getManagers()]>><<x [getName()]>>
```

#### Chart Data (Email)

<table border="1" cellspacing="0" cellpadding="0" style="border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td><td width="312" valign="bottom" style="width: 233.75pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Total Contract Price&lt;&lt;y [getContracts().sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">A</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">8.2</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">B</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">3.2</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">C</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">1.4</p></td></tr><tr><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">D</p></td><td width="312" valign="top" style="width: 233.75pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">1.2</p></td></tr></tbody></table>
### Download Pie Chart Template

Please download the sample Pie Chart document we created in this article:

*   [Pie Chart.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs d260234be58124a0318f6a76f2ad4dca >}}



---

## Pie Chart in Email Document

Path: /assembly/net/pie-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Pie Chart report in Presentation Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

## Pie Chart in Email Document

### Creating a Pie Chart

Please follow below steps to create Pie Chart in MS Outlook 2013:

1.  Create a new Email.
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "Pie".
4.  Preview "Pie" and press OK to insert the chart and Worksheet template to your email.
5.  Edit the Worksheet with your data to update the chart.

### Reporting Requirement

As a report developer, you are required to share managers' contract prices dynamically with the following key requirements:

*   The report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   The report must show information on a Pie Chart.
*   It must indicate customer name with value (price of the order).

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

##### Chart Title

```csharp
Total Order Price<<foreach [in
customers]>><<x [CustomerName]>>
```

##### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total Order Price&lt;&lt;y [</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">8.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.4</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 219.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: right;"><span style="font-family: Calibri; font-size: 11pt;">1.2</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Pie Chart Template

Please download the sample Pie Chart document we used in this article:

*   [Pie Chart.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Pie%20Chart.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists 16f8e9bddf60f4a95459a2898d9357aa >}}



---

## Protecting Word documents

Path: /watermark/java/protecting-word-documents/

Since version 18.6, GroupDocs.Watermark provides a simplified way of protecting the Word documents with the password. The API allows you to protect as well as unprotect the Word documents. The following protection types are supported:

*   *AllowOnlyRevisions*: user can only add revision marks to the document.
    
*   *AllowOnlyComments*: user can only modify comments in the document.
    
*   *AllowOnlyFormFields*: user can only enter data in the form fields in the document.
    
*   ReadOnly: no changes are allowed to the document.
    

The protection types are added to the [WordProcessingProtectionType](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingProtectionType) enum. Following code samples demonstrate how to protect and unprotect Word documents.

## Protecting a document

Following code sample [protects](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingContent#protect(int,%20java.lang.String)) a Word document with the password.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingProtectDocument**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
content.protect(WordProcessingProtectionType.ReadOnly, "7654321");                                         
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

## Unprotecting a document

The following code sample shows how to [unprotect](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/WordProcessingContent#unprotect()) a Word document regardless of password.

**advanced\_usage.add\_watermarks\_to\_word\_processing.WordProcessingUnProtectDocument**

```java
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();                                   
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\document.docx"
Watermarker watermarker = new Watermarker("document.docx", loadOptions);                          
                                                                                                           
WordProcessingContent content = watermarker.getContent(WordProcessingContent.class);                       
                                                                                                           
content.unprotect();                                                                                       
                                                                                                           
watermarker.save("document.docx");                                                               
                                                                                                           
watermarker.close();                                                                                       
```

---

## Redaction basics

Path: /redaction/net/redaction-basics/

GroupDocs.Redaction supports an effective set of document redaction features. It allows to apply redactions for [text]({{< ref "redaction/net/developer-guide/basic-usage/text-redactions.md" >}}), [metadata]({{< ref "redaction/net/developer-guide/basic-usage/metadata-redactions.md" >}}), [annotations]({{< ref "redaction/net/developer-guide/basic-usage/annotation-redactions.md" >}}), [images]({{< ref "redaction/net/developer-guide/basic-usage/image-redactions.md" >}}).

Wide range of document formats is supported, such as: PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list of supported formats at [supported document formats]({{< ref "redaction/net/getting-started/supported-document-formats.md" >}}) article

## Redaction types

GroupDocs.Redaction comes with the following redaction types:

| Type | Description | Classes |
| --- | --- | --- |
| [Text]({{< ref "redaction/net/developer-guide/basic-usage/text-redactions.md" >}}) | Replaces or hides with color block a portion of text within document body | [ExactPhraseRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/exactphraseredaction), [RegexRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/regexredaction) |
| [Metadata]({{< ref "redaction/net/developer-guide/basic-usage/metadata-redactions.md" >}}) | Replace metadata values with empty ones or redacts metadata texts | [EraseMetadataRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/erasemetadataredaction), [MetadataSearchRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/metadatasearchredaction) |
| [Annotations]({{< ref "redaction/net/developer-guide/basic-usage/annotation-redactions.md" >}}) | Deletes annotations from document or redacts its texts | [DeleteAnnotationRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/deleteannotationredaction), [AnnotationRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/annotationredaction) |
| [Images]({{< ref "redaction/net/developer-guide/basic-usage/image-redactions.md" >}}) | Replaces specific area of an image with a colored box | [ImageAreaRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/imagearearedaction) |
| [Pages]({{< ref "redaction/net/developer-guide/basic-usage/remove-page-redactions.md" >}}) | Removes specific range of pages (slides, worksheets, etc.) | [RemovePageRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/removepageredaction) |

## Apply redaction

Applying redaction to a document is done through [Redactor.Apply](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactor/apply/methods/1) method. As a result, you receive [RedactorChangeLog](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactorchangelog) instance, containing a log entry for each redaction applied. The entry contains reference to [Redacton](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redaction) instance including its options, status of the operation (see below) and textual descriptions when applicable. If at least one redaction failed, you will see [Status == RedactionStatus.Failed](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactionstatus):

**C#**

```csharp
using (Redactor redactor = new Redactor("sample.docx"))
{
   RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
   if (result.Status != RedactionStatus.Failed)
   {
      redactor.Save();
   };
}
```

All possible statuses of the [RedactionStatus](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactionstatus) enumeration are listed in this table:

| Status | Description | Possible reasons |
| --- | --- | --- |
| *Applied* | Redaction was fully and successfully applied | All operations within redaction process were successfully applied |
| *PartiallyApplied* | Redaction was applied only to a part of its matches | 1) Trial limitations for replacements were exceeded2) At least one change was rejected by user |
| *Skipped* | Redaction was skipped (not applied) | 1) Trial limitations for redactions were exceeded2) Redaction cannot be applied to this type of document3) All replacements were rejected by user and no changes were made |
| *Failed* | Redaction failed with exception | An exception occurred in process of redaction |

For detailed information you have to iterate through redaction log entries in [RedactorChangeLog.RedactionLog](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactorchangelog/properties/redactionlog) and check for [ErrorMessage](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactionresult/properties/errormessage) property of any items with status other than *Applied*:

**C#**

```csharp
RedactorChangeLog summary = redactor.Apply( ... );
if (summary.Status != RedactionStatus.Applied)
{
	for (int i = 0; i < summary.RedactionLog.Count; i++)
	{
		RedactorLogEntry logEntry = summary.RedactionLog[i];
    	if (logEntry.Result.Status != RedactionStatus.Applied)
        {
			Console.WriteLine("{0} status is {1}, details: {2}", 
				logEntry.Redaction.GetType().Name, 
				logEntry.Result.Status, 
				logEntry.Result.ErrorMessage);
		}
	}
}
```

## Apply multiple redactions

You can apply as much redactions as you need in a single call to [Redactor.Apply](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactor/apply/methods/1) method, since its overload accepts an array of redactions and redaction policy. In this case, redactions will be applied in the same order as they appear in the array. As an alternative to specifying redaction sets in your code, you can create an XML file with redaction policy, as described [here]({{< ref "redaction/net/developer-guide/basic-usage/redaction-basics.md" >}}).

**C#**

```csharp
using (Redactor redactor = new Redactor("sample.docx"))
{
   var redactionList = new Redaction[] 
   {
      new ExactPhraseRedaction("John Doe", new ReplacementOptions("[Client]")),
      new RegexRedaction("Redaction", new ReplacementOptions("[Product]")),
      new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", new ReplacementOptions(System.Drawing.Color.Blue)),
      new DeleteAnnotationRedaction(),
      new EraseMetadataRedaction(MetadataFilters.All)
   }; 
   RedactorChangeLog result = redactor.Apply(redactionList);
   // false, if at least one redaction failed
   if (result.Status != RedactionStatus.Failed)
   {
      redactor.Save();
   };
}
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Redaction basics

Path: /redaction/python-net/redaction-basics/

GroupDocs.Redaction supports an effective set of document redaction features. It allows to apply redactions for [text]({{< ref "redaction/python-net/developer-guide/basic-usage/text-redactions.md" >}}), [metadata]({{< ref "redaction/python-net/developer-guide/basic-usage/metadata-redactions.md" >}}), [annotations]({{< ref "redaction/python-net/developer-guide/basic-usage/annotation-redactions.md" >}}), [images]({{< ref "redaction/python-net/developer-guide/basic-usage/image-redactions.md" >}}).

Wide range of document formats is supported, such as: PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list of supported formats at [supported document formats]({{< ref "redaction/python-net/getting-started/supported-document-formats.md" >}}) article

## Redaction types

GroupDocs.Redaction comes with the following redaction types:

| Type | Description | Classes |
| --- | --- | --- |
| [Text]({{< ref "redaction/python-net/developer-guide/basic-usage/text-redactions.md" >}}) | Replaces or hides with color block a portion of text within document body | [ExactPhraseRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/exactphraseredaction/), [RegexRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/regexredaction/) |
| [Metadata]({{< ref "redaction/python-net/developer-guide/basic-usage/metadata-redactions.md" >}}) | Replace metadata values with empty ones or redacts metadata texts | [EraseMetadataRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/erasemetadataredaction/), [MetadataSearchRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/metadatasearchredaction/) |
| [Annotations]({{< ref "redaction/python-net/developer-guide/basic-usage/annotation-redactions.md" >}}) | Deletes annotations from document or redacts its texts | [DeleteAnnotationRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/deleteannotationredaction/), [AnnotationRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/annotationredaction/) |
| [Images]({{< ref "redaction/python-net/developer-guide/basic-usage/image-redactions.md" >}}) | Replaces specific area of an image with a colored box | [ImageAreaRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/imagearearedaction/) |
| [Pages]({{< ref "redaction/python-net/developer-guide/basic-usage/remove-page-redactions.md" >}}) | Removes specific range of pages (slides, worksheets, etc.) | [RemovePageRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/removepageredaction/) |

## Apply redaction

Applying redaction to a document is done through [Redactor.Apply](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor/apply/) method. As a result, you receive [RedactorChangeLog](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactorchangelog/) instance, containing a log entry for each redaction applied. The entry contains reference to [Redacton](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redaction/) instance including its options, status of the operation (see below) and textual descriptions when applicable. If at least one redaction failed, you will see [Status == RedactionStatus.Failed](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionstatus/):

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        if (result.status != gr.RedactionStatus.FAILED):
            # Save the redacted document
            so = gro.SaveOptions()
            so.add_suffix = True
            so.rasterize_to_pdf = False
            result_path = redactor.save(so)
```

All possible statuses of the [RedactionStatus](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionstatus/) enumeration are listed in this table:

| Status | Description | Possible reasons |
| --- | --- | --- |
| *Applied* | Redaction was fully and successfully applied | All operations within redaction process were successfully applied |
| *PartiallyApplied* | Redaction was applied only to a part of its matches | 1) Trial limitations for replacements were exceeded2) At least one change was rejected by user |
| *Skipped* | Redaction was skipped (not applied) | 1) Trial limitations for redactions were exceeded2) Redaction cannot be applied to this type of document3) All replacements were rejected by user and no changes were made |
| *Failed* | Redaction failed with exception | An exception occurred in process of redaction |

For detailed information you have to iterate through redaction log entries in [RedactorChangeLog.RedactionLog](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactorchangelog/redaction_log/) and check for [ErrorMessage](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionresult/error_message/) property of any items with status other than *Applied*:

**Python**

```python
result = redactor.apply = redactor.Apply( ... );
if (result.status != gr.RedactionStatus.FAILED):
    # By default, the redacted document is saved in PDF format
    result_path = redactor.save()
    print(f"Document redacted successfully.\nCheck output in {result_path}")
else:
    # Dump all failed or skipped redactions
    print(f"Redaction failed!")
    for log_entry in result.redaction_log:
        if (log_entry.result.status != gr.RedactionStatus.APPLIED):
            print(f"Status is {log_entry.result.status}, details: {log_entry.result.error_message}")
```

## Apply multiple redactions

You can apply as much redactions as you need in a single call to [Redactor.Apply](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor/apply/) method, since its overload accepts an array of redactions and redaction policy. In this case, redactions will be applied in the same order as they appear in the array. As an alternative to specifying redaction sets in your code, you can create an XML file with redaction policy, as described [here]({{< ref "redaction/python-net/developer-guide/advanced-usage/use-redaction-policies.md" >}}).

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():
    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Provide redaction options
    redactionList = [
        grr.ExactPhraseRedaction("John Doe", grr.ReplacementOptions("[Client]")),
        grr.RegexRedaction("Redaction", grr.ReplacementOptions("[Product]")),
        grr.RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", grr.ReplacementOptions(color)),
        grr.DeleteAnnotationRedaction(),
        grr.EraseMetadataRedaction(grr.MetadataFilters.ALL)
    ]

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(redactionList)

        if (result.status != gr.RedactionStatus.FAILED):
            # By default, the redacted document is saved in PDF format
            result_path = redactor.save()
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Redaction Basics

Path: /redaction/java/redaction-basics/

### Redaction types

GroupDocs.Redaction comes with the following redaction types:

| Type | Description | Classes |
| --- | --- | --- |
| [Text]({{< ref "redaction/java/developer-guide/basic-usage/text-redactions.md" >}}) | Replaces or hides with color block a portion of text within document body | *ExactPhraseRedaction*, *RegexRedaction* |
| [Metadata]({{< ref "redaction/java/developer-guide/basic-usage/metadata-redactions.md" >}}) | Replace metadata values with empty ones or redacts metadata texts | *EraseMetadataRedaction*, *MetadataSearchRedaction* |
| [Annotations]({{< ref "redaction/java/developer-guide/basic-usage/annotation-redactions.md" >}}) | Deletes annotations from document or redacts its texts | *DeleteAnnotationRedaction*, *AnnotationRedaction* |
| [Images]({{< ref "redaction/java/developer-guide/basic-usage/image-redactions.md" >}}) | Replaces specific area of an image with a colored box | *ImageAreaRedaction* |
| [Pages]({{< ref "redaction/java/developer-guide/basic-usage/remove-page-redactions.md" >}}) | Removes specific range of pages (slides, worksheets, etc.) | *RemovePageRedaction* |

### Apply redaction

Applying redaction to a document is done through *Redactor.apply* method. As a result, you receive *RedactorChangeLog* instance, containing a log entry for each redaction applied. The entry contains reference to *Redacton* instance including its options, status of the operation (see below) and textual descriptions when applicable. If at least one redaction failed, you will see *Status* == *RedactionStatus.Failed*:



```java
final Redactor redactor = new Redactor("sample.docx");
try 
{
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    redactor.save();
}
finally { redactor.close(); }
```

All possible statuses are listed in this table:

| Status | Description | Possible reasons |
| --- | --- | --- |
| *Applied* | Redaction was fully and successfully applied | All operations within redaction process were successfully applied |
| *PartiallyApplied* | Redaction was applied only to a part of its matches | 1) Trial limitations for replacements were exceeded2) At least one change was rejected by user |
| *Skipped* | Redaction was skipped (not applied) | 1) Trial limitations for redactions were exceeded2) Redaction cannot be applied to this type of document3) All replacements were rejected by user and no changes were made |
| *Failed* | Redaction failed with exception | An exception occurred in process of redaction |

For detailed information you have to iterate through redaction log entries in *RedactorChangeLog.RedactionLog* and check for ErrorMessage property of any items with status other than *Applied*:



```java
RedactorChangeLog summary = redactor.apply( ... );
if (result.getStatus() != RedactionStatus.Failed)
{
	for (RedactorLogEntry logEntry : result.getRedactionLog())
    {
        if (logEntry.getResult().getStatus() != RedactionStatus.Applied)
        {
            System.out.println(logEntry.getRedaction().getClass().getName() + " status is " + 
               logEntry.getResult().getStatus() + ", details: " + logEntry.getResult().getErrorMessage());
        }
    }
}
```

### Apply multiple redactions

You can apply as much redactions as you need in a single call to *Redactor.Apply()* method, since its overload accepts an array of redactions and redaction policy. In this case, redactions will be applied in the same order as they appear in the array. As an alternative to specifying redaction sets in your code, you can create an XML file with redaction policy, as described [here]({{< ref "redaction/java/developer-guide/basic-usage/redaction-basics.md" >}}).



```java
final Redactor redactor = new Redactor("sample.docx");
try 
{
    Redaction[] redactionList = new Redaction[]
    {
          new ExactPhraseRedaction("John Doe", new ReplacementOptions("[Client]")),
          new RegexRedaction("Redaction", new ReplacementOptions("[Product]")),
          new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", new ReplacementOptions(java.awt.Color.BLUE)),
          new DeleteAnnotationRedaction(),
          new EraseMetadataRedaction(MetadataFilters.All)
    };
    redactor.apply(redactionList);
    // false, if at least one redaction failed
    if (result.getStatus() != RedactionStatus.Failed)
    {
        redactor.save();
    }
}
finally { redactor.close(); }
```

---

## Remove document password

Path: /merger/net/remove-document-password/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to remove password from password-protected document. Here are the steps to remove document password:

*   Initialize [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) class specifying current password;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream and pass [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) object to it;
*   Call [RemovePassword](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/removepassword) method;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to remove document password:

```csharp
string filePath = @"c:\sample.docx";
string filePathOut = @"c:\output\result.docx";

LoadOptions loadOptions = new LoadOptions("SAMPLE_PASSWORD");

using (Merger merger = new Merger(filePath, loadOptions))
{
    merger.RemovePassword();
    merger.Save(filePathOut);
}
```

---

## Remove document password

Path: /merger/python-net/remove-document-password/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net)** allows to remove password from password-protected document. Here are the steps to remove document password:

*   Initialize [LoadOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/loadoptions) class specifying current password;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger) object with source document path or stream and pass [LoadOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/loadoptions) object to it;
*   Call [RemovePassword](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/removepassword) method;
*   Call [Save](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to remove document password:

```python
load_options = gm.domain.options.LoadOptions("SomePasswordString")
with gm.Merger(constants.sample_docx_protected, load_options) as merger:
    print(f"Document info retrieved successfully")
    merger.remove_password()
    merger.save(constants.output_docx)
```

---

## Render hidden pages

Path: /viewer/java/show-hidden-pages/

By default, GroupDocs.Viewer does not render hidden items. To render them, call the [setRenderHiddenPages()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderHiddenPages-boolean-) method of the [ViewOptions](https://reference.groupdocs.com/viewer/java/groupdocs.viewer.options/viewoptions/) class.

This feature is supported for the following format families:

* Visio documents (for hidden pages)
* PowerPoint presentations (for hidden slides)
* Spreadsheets files (for hidden worksheets)

The following code snippet shows how to enable rendering of hidden items:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewOptions.setRenderHiddenPages(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Render hidden pages

Path: /viewer/net/show-hidden-pages/

By default, GroupDocs.Viewer does not render hidden items. To render them, set the RenderHiddenPages property of the [ViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewoptions/) class to `true`.

This feature is supported for the following format families:

* Visio documents (for hidden pages)
* PowerPoint presentations (for hidden slides)
* Spreadsheets files (for hidden worksheets)

The following code snippet shows how to enable rendering of hidden items:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.pptx"))
{
    // Create view options.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();

    // Enable rendering of hidden items.
    viewOptions.RenderHiddenPages = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.pptx")
            ' Create view options.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
        
            ' Enable rendering of hidden items.
            viewOptions.RenderHiddenPages = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Render PowerPoint presentations as HTML, PDF, and image files

Path: /viewer/java/render-presentations/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your presentations in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft PowerPoint or other software to load and view presentations within your Java application (web or desktop). 

Create a [Viewer](https://apireference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) class instance to get started with the GroupDocs.Viewer API. Pass a presentation you want to view to the class constructor. You can load the presentation from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method overloads to convert the presentation to HTML, PDF, or image format. These methods allow you to render the entire presentation or specific slides.

{{< button style="primary" link="https://products.groupdocs.app/viewer/powerpoint" >}} {{< icon "gdoc_person" >}} View PowerPoint files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Presentation file formats

GroupDocs.Viewer supports the following file formats:

* {{% closedlink title="Microsoft PowerPoint Presentation" href="https://docs.fileformat.com/presentation/pptx/" %}} (.PPTX)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Presentation" href="https://docs.fileformat.com/presentation/ppt/" %}} (.PPT)
* {{% closedlink title="Microsoft PowerPoint Template" href="https://docs.fileformat.com/presentation/potx" %}} (.POTX)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Template" href="https://docs.fileformat.com/presentation/pot" %}} (.POT)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Template" href="https://docs.fileformat.com/presentation/potm" %}} (.POTM)
* {{% closedlink title="Microsoft PowerPoint Slide Show" href="https://docs.fileformat.com/presentation/ppsx" %}} (.PPSX)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Slide Show" href="https://docs.fileformat.com/presentation/ppsm" %}} (.PPSM)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Slide Show" href="https://docs.fileformat.com/presentation/pps" %}} (.PPS)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Presentation" href="https://docs.fileformat.com/presentation/pptmx" %}} (.PPTM)
* {{% closedlink title="OpenDocument Presentation" href="https://docs.fileformat.com/presentation/odp" %}} (.ODP)
* {{% closedlink title="OpenDocument Presentation Template" href="https://docs.fileformat.com/presentation/otp" %}} (.OTP)
* {{% closedlink title="OpenDocument Flat XML Presentation" href="https://docs.fileformat.com/" %}} (.FODP)

## Render presentations as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method to convert a presentation file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources-java.lang.String-) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    // Create an HTML file for each slide.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to HTML](/viewer/java/images/rendering-basics/render-presentations/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources-java.lang.String-java.lang.String-java.lang.String-) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    // Create an HTML file for each slide.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-presentations/render-to-html-external-resources.png)

## Render presentations as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method to convert a presentation file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PDF](/viewer/java/images/rendering-basics/render-presentations/render-to-pdf.png)

## Render presentations as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method to convert a presentation file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    // Create a PNG image for each slide.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PNG](/viewer/java/images/rendering-basics/render-presentations/render-to-png-image.png)

## Render presentations as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method to convert a presentation file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.


{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    // Create a JPG image for each slide.
    // {0} is replaced with the current page number in the image name.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Specify image resolution

When you convert presentations with high-resolution images to other formats, you may need to lower image resolution to reduce the output file size. GroupDocs.Viewer supports the [PresentationOptions.setResolution](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/presentationoptions/#setResolution-com.groupdocs.viewer.options.Resolution-) method that allows you to compress images in the output HTML and PDF files. To access this option, use the [HtmlViewOptions.setPresentationOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setPresentationOptions-com.groupdocs.viewer.options.PresentationOptions-) or [PdfViewOptions.setPresentationOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/#setPresentationOptions-com.groupdocs.viewer.options.PresentationOptions-) methods (depending on the output file format).

You can use the [PresentationOptions.setResolution](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/presentationoptions/#setResolution-com.groupdocs.viewer.options.Resolution-) method to one of the following [Resolution](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/resolution) field values:

| Resolution field | DPI | Remarks |
| --- | --- | --- |
| DOCUMENT_RESOLUTION | As in the source file | This is the default value.|
| DPI_72 | 72 | Maximum image compression and minimum file size. |
| DPI_96 | 96 | Good for web pages and projectors. |
| DPI_150 | 150 | Good for web pages and projectors. |
| DPI_220 | 220 | Excellent quality on most printers and screens. |
| DPI_330 | 330 | Good quality for high-definition (HD) displays. |

The following example demonstrates how to specify image resolution in code: 

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewOptions.getPresentationOptions().setResolution(Resolution.Dpi150);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render hidden slides

If your presentation contains hidden slides, use the [ViewOptions.setRenderHiddenPages](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderHiddenPages-boolean-) method for a target view to display these slides in the output HTML, PDF, or image files.

The following code example uses this option to display hidden slides in the generated PDF file:

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewOptions.setRenderHiddenPages(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render comments

Use the [ViewOptions.setRenderComments](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderComments-boolean-) method for a target view to display comments in the output file when you convert your presentation to HTML, PDF, PNG, or JPEG format.

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewOptions.setRenderComments(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation with comments](/viewer/java/images/rendering-basics/render-presentations/render-presentation-comments-to-pdf.png)

## Render speaker notes

A presentation file can contain speaker notes that help presenters recall important information during the presentation. Speaker notes appear in the **Notes** pane below each slide.

![Speaker notes in Microsoft PowerPoint](/viewer/java/images/rendering-basics/render-presentations/presentation-speaker-notes.png)

Use the [ViewOptions.setRenderNotes](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderNotes-boolean-) method for a target view to display speaker notes in the output HTML, PDF, or image files.

The following code sample renders a presentation with speaker notes to PDF:

{{< tabs "example9">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewOptions.setRenderNotes(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render a presentation with notes](/viewer/java/images/rendering-basics/render-presentations/render-presentation-notes-to-pdf.png)

---

## Render PowerPoint presentations as HTML, PDF, and image files

Path: /viewer/net/render-presentations/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your presentations in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft PowerPoint or other software to load and view presentations within your .NET application (web or desktop). 

Create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance to get started with the GroupDocs.Viewer API. Pass a presentation you want to view to the class constructor. You can load the presentation from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the presentation to HTML, PDF, or image format. These methods allow you to render the entire presentation or specific slides.

{{< button style="primary" link="https://products.groupdocs.app/viewer/powerpoint" >}} {{< icon "gdoc_person" >}} View PowerPoint files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported presentation file formats

GroupDocs.Viewer supports the following presentation file formats:

* [Microsoft PowerPoint Presentation](https://docs.fileformat.com/presentation/pptx/) (.PPTX)
* [Microsoft PowerPoint 97-2003 Presentation](https://docs.fileformat.com/presentation/ppt/) (.PPT)
* [Microsoft PowerPoint Template](https://docs.fileformat.com/presentation/potx) (.POTX)
* [Microsoft PowerPoint 97-2003 Template](https://docs.fileformat.com/presentation/pot) (.POT)
* [Microsoft PowerPoint Macro-Enabled Template](https://docs.fileformat.com/presentation/potm) (.POTM)
* [Microsoft PowerPoint Slide Show](https://docs.fileformat.com/presentation/ppsx) (.PPSX)
* [Microsoft PowerPoint Macro-Enabled Slide Show](https://docs.fileformat.com/presentation/ppsm) (.PPSM)
* [Microsoft PowerPoint 97-2003 Slide Show](https://docs.fileformat.com/presentation/pps) (.PPS)
* [Microsoft PowerPoint Macro-Enabled Presentation](https://docs.fileformat.com/presentation/pptmx) (.PPTM)
* [OpenDocument Presentation](https://docs.fileformat.com/presentation/odp) (.ODP)
* [OpenDocument Presentation Template](https://docs.fileformat.com/presentation/otp) (.OTP)
* [OpenDocument Flat XML Presentation](https://docs.fileformat.com/) (.FODP)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render presentations as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a presentation file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Create an HTML file for each slide.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Create an HTML file for each slide.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to HTML](/viewer/net/images/rendering-basics/render-presentations/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Create an HTML file for each slide.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources(
        "page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Create an HTML file for each slide.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-presentations/render-to-html-external-resources.png)


### Generate pure HTML/CSS markup

Before [version 24.5](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-5-release-notes/), the GroupDocs.Viewer for .NET was able to render presentations to the HTML in only one mode, which is heavily based on SVG images. Actually, the whole slide is converted to a single vector image in [SVG format](https://docs.fileformat.com/page-description-language/svg/), and the HTML here is served only as a wrapper around a SVG element. This mode has an undeniable advantage of 100% accurate reproduction of the original presentation. In other words, what you see in MS PowerPoint when opening a presentation, this is exactly what you see in the web-browser after opening the same presentation in the GroupDocs.Viewer. This is possible because GroupDocs.Viewer scans the original presentation document and reproduces it by drawing every tiny element, every pixel on a SVG canvas while preserving the position, shape and orientation.

But because of its SVG-based nature this mode also has the disadvantages — the SVG markup is too complex, full-text search may not work as expected, and, actually, this is not the “real” HTML- and CSS-markup. So if you want to implement something like modification or post-processing the document after obtaining it from GroupDocs.Viewer, you may encounter troubles, because standard tools like HTML parsers or CSS queries usually are not working with SVG markup.

That’s why we represent the new HTML conversion mode for the Presentations — pure HTML/CSS mode. In this mode no SVG images are generated at all, only pure HTML and CSS markup.

By default this mode is disabled, and the existing SVG-based mode is activated. For enabling the new pure HTML/CSS conversion mode, please set the boolean flag `RenderToPureHtml` to `true` value in the [`PresentationOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/presentationoptions/) property of the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) class. 

Code example below shows converting the same presentation file to the pure HTML/CSS markup in two variations — with embedded and external resources:

{{< tabs "example_pure">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...
string inputPresentationPath = "SamplePresentation.pptx";

//preparing HTML options for embedded and external resources
HtmlViewOptions embeddedOptions = HtmlViewOptions.ForEmbeddedResources("slide_{0}_embedded.html");
HtmlViewOptions externalOptions = HtmlViewOptions.ForExternalResources("slide_{0}.html", "slide_{0}_{1}", "slide_{0}_{1}");
//enabling the pure HTML/CSS mode for both options
embeddedOptions.PresentationOptions.RenderToPureHtml = externalOptions.PresentationOptions.RenderToPureHtml = true;

using (Viewer viewer = new Viewer(inputPresentationPath))
{
    viewer.View(embeddedOptions);
    viewer.View(externalOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Dim inputPresentationPath As String = "SamplePresentation.pptx"
        'preparing HTML options for embedded and external resources
        Dim embeddedOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources("slide_{0}_embedded.html")
        Dim externalOptions As HtmlViewOptions = HtmlViewOptions.ForExternalResources("slide_{0}.html", "slide_{0}_{1}", "slide_{0}_{1}")
        'enabling the pure HTML/CSS mode for both options
        embeddedOptions.PresentationOptions.RenderToPureHtml = True
        externalOptions.PresentationOptions.RenderToPureHtml = True
        Using viewer = New Viewer(inputPresentationPath)
            viewer.View(embeddedOptions)
            viewer.View(externalOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

Need to mention that this new pure HTML/CSS mode also has the next limitations and disadvantages:

1. Its fidelity is generally worse compared to the original SVG-based mode, especially on presentations with complex slides layout and sophisticated text formatting.
2. For this moment rendering comments and notes are not supported, so the [`RenderComments`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/rendercomments/) and [`RenderNotes`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/rendernotes/) properties of the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) class are ignored.
3. [`Resolution`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/presentationoptions/resolution/) property of the [`PresentationOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/presentationoptions/) class is also not supported for this moment, the images are exported to the output HTML document in their original resolution.
4. [`RenderToSinglePage`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/rendertosinglepage/) boolean property of the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) class is not supported too, so every slide of the presentation will be saved to the distinct HTML document.
5. [`RenderResponsive`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/renderresponsive/) boolean property of [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) class belongs to the existing SVG-based conversion mode, so its value is ignored while converting in pure HTML/CSS mode, — HTML- and CSS-markup are already 100% responsive.

We plan to add support for most of these missing features in the near future by constantly improving this new pure HTML/CSS converter, adding new features and fixing bugs.

## Render presentations as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a presentation file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Create a PDF file for the presentation.
    // Specify the PDF file name.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Create a PDF file for the presentation.
            ' Specify the PDF file name.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PDF](/viewer/net/images/rendering-basics/render-presentations/render-to-pdf.png)

## Render presentations as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a presentation file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Create a PNG image for each slide.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 950;
    viewOptions.Height = 550;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Create a PNG image for each slide.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 950
            viewOptions.Height = 550
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PNG](/viewer/net/images/rendering-basics/render-presentations/render-to-png-image.png)

## Render presentations as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a presentation file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.


{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Create a JPEG image for each slide.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 950;
    viewOptions.Height = 550;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Create a JPEG image for each slide.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 950
            viewOptions.Height = 550
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Specify image resolution

When you convert presentations with high-resolution images to other formats, you may need to lower image resolution to reduce the output file size. GroupDocs.Viewer supports the [PresentationOptions.Resolution](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/presentationoptions/properties/resolution) option that allows you to compress images in the output HTML and PDF files. To access this option, use the [HtmlViewOptions.PresentationOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/presentationoptions) or [PdfViewOptions.PresentationOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/presentationoptions) property (depending on the output file format).

You can set the [PresentationOptions.Resolution](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/presentationoptions/properties/resolution) property to one of the following [Resolution](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/resolution) field values:

| Resolution field | DPI | Remarks |
| --- | --- | --- |
| DocumentResolution | As in the source file | This is the default value.|
| Dpi72 | 72 | Maximum image compression and minimum file size. |
| Dpi96 | 96 | Good for web pages and projectors. |
| Dpi150 | 150 | Good for web pages and projectors. |
| Dpi220 | 220 | Excellent quality on most printers and screens. |
| Dpi330 | 330 | Good quality for high-definition (HD) displays. |

The following example shows how to specify image resolution in code: 

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Convert the presentation to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify resolution.
    viewOptions.PresentationOptions.Resolution = Resolution.Dpi150;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Convert the presentation to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify resolution.
            viewOptions.PresentationOptions.Resolution = Resolution.Dpi150
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render hidden slides

If your presentation contains hidden slides, enable the [ViewOptions.RenderHiddenPages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/renderhiddenpages) property for a target view to display these slides in the output HTML, PDF, or image files.

The following code example uses this option to display hidden slides in the generated PDF file:

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Convert the presentation to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable hidden slides rendering.
    viewOptions.RenderHiddenPages = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Convert the presentation to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable hidden slides rendering.
            viewOptions.RenderHiddenPages = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render comments

Enable the [ViewOptions.RenderComments](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/rendercomments) option for a target view to display comments in the output file when you convert your presentation to HTML, PDF, PNG, or JPEG format.

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Convert the presentation to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable comments rendering.
    viewOptions.RenderComments = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Convert the presentation to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable comments rendering.
            viewOptions.RenderComments = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation with comments](/viewer/net/images/rendering-basics/render-presentations/render-presentation-comments-to-pdf.png)

## Render speaker notes

A presentation file can contain speaker notes that help presenters recall important information during the presentation. Speaker notes appear in the **Notes** pane below each slide.

![Speaker notes in Microsoft PowerPoint](/viewer/net/images/rendering-basics/render-presentations/presentation-speaker-notes.png)

Enable the [ViewOptions.RenderNotes](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/rendernotes) property for a target view to display speaker notes in the output HTML, PDF, or image files.

The following code sample renders a presentation with speaker notes to PDF:

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pptx"))
{
    // Convert the presentation to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable speaker notes rendering.
    viewOptions.RenderNotes = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pptx")
            ' Convert the presentation to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable speaker notes rendering.
            viewOptions.RenderNotes = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render a presentation with notes](/viewer/net/images/rendering-basics/render-presentations/render-presentation-notes-to-pdf.png)

---

## Render PowerPoint presentations as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-presentations/

[GroupDocs.Viewer for Node.js](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your presentations in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft PowerPoint or other software to load and view presentations within your Java application (web or desktop). 

Create a [Viewer](#) class instance to get started with the GroupDocs.Viewer API. Pass a presentation you want to view to the class constructor. You can load the presentation from a file or stream. Call one of the [Viewer.view](#) method overloads to convert the presentation to HTML, PDF, or image format. These methods allow you to render the entire presentation or specific slides.

{{< button style="primary" link="https://products.groupdocs.app/viewer/powerpoint" >}} {{< icon "gdoc_person" >}} View PowerPoint files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Presentation file formats

GroupDocs.Viewer supports the following file formats:

* {{% closedlink title="Microsoft PowerPoint Presentation" href="https://docs.fileformat.com/presentation/pptx/" %}} (.PPTX)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Presentation" href="https://docs.fileformat.com/presentation/ppt/" %}} (.PPT)
* {{% closedlink title="Microsoft PowerPoint Template" href="https://docs.fileformat.com/presentation/potx" %}} (.POTX)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Template" href="https://docs.fileformat.com/presentation/pot" %}} (.POT)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Template" href="https://docs.fileformat.com/presentation/potm" %}} (.POTM)
* {{% closedlink title="Microsoft PowerPoint Slide Show" href="https://docs.fileformat.com/presentation/ppsx" %}} (.PPSX)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Slide Show" href="https://docs.fileformat.com/presentation/ppsm" %}} (.PPSM)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Slide Show" href="https://docs.fileformat.com/presentation/pps" %}} (.PPS)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Presentation" href="https://docs.fileformat.com/presentation/pptmx" %}} (.PPTM)
* {{% closedlink title="OpenDocument Presentation" href="https://docs.fileformat.com/presentation/odp" %}} (.ODP)
* {{% closedlink title="OpenDocument Presentation Template" href="https://docs.fileformat.com/presentation/otp" %}} (.OTP)
* {{% closedlink title="OpenDocument Flat XML Presentation" href="https://docs.fileformat.com/" %}} (.FODP)

## Render presentations as HTML

Create an [HtmlViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a presentation file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](#) method and specify the output file name.

{{< tabs "render-presentation-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
// Create an HTML file for each slide.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-presentation-to-html-embedded/pptx-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to HTML](/viewer/nodejs-java/images/rendering-basics/render-presentations/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](#) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-presentation-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
// Create an HTML file for each slide.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-presentation-to-html-external/pptx-to-html-page_{0}.html", "render-presentation-to-html-external/pptx-to-html-page_{0}/resource_{0}_{1}", "render-presentation-to-html-external/pptx-to-html-page_{0}/resource_{0}_{1}");
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-presentations/render-to-html-external-resources.png)

## Render presentations as PDF

Create a [PdfViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a presentation file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-presentation-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
const viewOptions = PdfViewOptions("render-presentation-to-pdf/pptx-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PDF](/viewer/nodejs-java/images/rendering-basics/render-presentations/render-to-pdf.png)

## Render presentations as PNG

Create a [PngViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a presentation file to PNG. Use the [PngViewOptions.setHeight](#) and [PngViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-presentation-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
// Create a PNG image for each slide.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-presentation-to-png/pptx-to-png-page_{0}.png")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PNG](/viewer/nodejs-java/images/rendering-basics/render-presentations/render-to-png-image.png)

## Render presentations as JPEG

Create a [JpgViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a presentation file to JPEG. Use the [JpgViewOptions.setHeight](#) and [JpgViewOptions.setWidth](#) methods to specify the output image size in pixels.


{{< tabs "render-presentation-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
// Create a JPG image for each slide.
// {0} is replaced with the current page number in the image name.
const viewOptions = JpgViewOptions("render-presentation-to-jpeg/pptx-to-jpg-page_{0}.jpg")
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify image resolution

When you convert presentations with high-resolution images to other formats, you may need to lower image resolution to reduce the output file size. GroupDocs.Viewer supports the [PresentationOptions.setResolution](#) method that allows you to compress images in the output HTML and PDF files. To access this option, use the [HtmlViewOptions.setPresentationOptions](#) or [PdfViewOptions.setPresentationOptions](#) methods (depending on the output file format).

You can use the [PresentationOptions.setResolution](#) method to one of the following [Resolution](#) field values:

| Resolution field | DPI | Remarks |
| --- | --- | --- |
| DOCUMENT_RESOLUTION | As in the source file | This is the default value.|
| DPI_72 | 72 | Maximum image compression and minimum file size. |
| DPI_96 | 96 | Good for web pages and projectors. |
| DPI_150 | 150 | Good for web pages and projectors. |
| DPI_220 | 220 | Excellent quality on most printers and screens. |
| DPI_330 | 330 | Good quality for high-definition (HD) displays. |

The following example demonstrates how to specify image resolution in code: 

{{< tabs "render-presentation-with-image-resolution">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions, Resolution } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
const viewOptions = PdfViewOptions("render-presentation-with-image-resolution/pptx-to-pdf.pdf")
viewOptions.getPresentationOptions().setResolution(Resolution.Dpi150)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render hidden slides

If your presentation contains hidden slides, use the [ViewOptions.setRenderHiddenPages](#) method for a target view to display these slides in the output HTML, PDF, or image files.

The following code example uses this option to display hidden slides in the generated PDF file:

{{< tabs "render-presentation-hidden-slides">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
const viewOptions = PdfViewOptions("render-presentation-hidden-slides/pptx-to-pdf.pdf")
viewOptions.setRenderHiddenPages(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render comments

Use the [ViewOptions.setRenderComments](#) method for a target view to display comments in the output file when you convert your presentation to HTML, PDF, PNG, or JPEG format.

{{< tabs "render-presentation-with-comments">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
const viewOptions = PdfViewOptions("render-presentation-with-comments/pptx-to-pdf.pdf")
viewOptions.setRenderComments(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation with comments](/viewer/nodejs-java/images/rendering-basics/render-presentations/render-presentation-comments-to-pdf.png)

## Render speaker notes

A presentation file can contain speaker notes that help presenters recall important information during the presentation. Speaker notes appear in the **Notes** pane below each slide.

![Speaker notes in Microsoft PowerPoint](/viewer/nodejs-java/images/rendering-basics/render-presentations/presentation-speaker-notes.png)

Use the [ViewOptions.setRenderNotes](#) method for a target view to display speaker notes in the output HTML, PDF, or image files.

The following code sample renders a presentation with speaker notes to PDF:

{{< tabs "render-presentation-with-speaker-notes">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pptx")
const viewOptions = PdfViewOptions("render-presentation-with-speaker-notes/pptx-to-pdf.pdf")
viewOptions.setRenderNotes(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render a presentation with notes](/viewer/nodejs-java/images/rendering-basics/render-presentations/render-presentation-notes-to-pdf.png)

---

## Render PowerPoint presentations as HTML, PDF, and image files

Path: /viewer/python-net/render-presentations/

[GroupDocs.Viewer for Python](https://products.groupdocs.com/viewer/python-net) allows you to render your presentations in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft PowerPoint or other software to load and view presentations within your Python application (web or desktop). 

Create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/) class instance to get started with the GroupDocs.Viewer API. Pass a presentation you want to view to the class constructor. You can load the presentation from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the presentation to HTML, PDF, or image format. These methods allow you to render the entire presentation or specific slides.

{{< button style="primary" link="https://products.groupdocs.app/viewer/powerpoint" >}} {{< icon "gdoc_person" >}} View PowerPoint files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Presentation file formats

GroupDocs.Viewer supports the following file formats:

* {{% closedlink title="Microsoft PowerPoint Presentation" href="https://docs.fileformat.com/presentation/pptx/" %}} (.PPTX)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Presentation" href="https://docs.fileformat.com/presentation/ppt/" %}} (.PPT)
* {{% closedlink title="Microsoft PowerPoint Template" href="https://docs.fileformat.com/presentation/potx" %}} (.POTX)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Template" href="https://docs.fileformat.com/presentation/pot" %}} (.POT)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Template" href="https://docs.fileformat.com/presentation/potm" %}} (.POTM)
* {{% closedlink title="Microsoft PowerPoint Slide Show" href="https://docs.fileformat.com/presentation/ppsx" %}} (.PPSX)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Slide Show" href="https://docs.fileformat.com/presentation/ppsm" %}} (.PPSM)
* {{% closedlink title="Microsoft PowerPoint 97-2003 Slide Show" href="https://docs.fileformat.com/presentation/pps" %}} (.PPS)
* {{% closedlink title="Microsoft PowerPoint Macro-Enabled Presentation" href="https://docs.fileformat.com/presentation/pptmx" %}} (.PPTM)
* {{% closedlink title="OpenDocument Presentation" href="https://docs.fileformat.com/presentation/odp" %}} (.ODP)
* {{% closedlink title="OpenDocument Presentation Template" href="https://docs.fileformat.com/presentation/otp" %}} (.OTP)
* {{% closedlink title="OpenDocument Flat XML Presentation" href="https://docs.fileformat.com/" %}} (.FODP)

## Render presentations as HTML

Create an [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a presentation file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_presentation_to_html():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        # Create an HTML file for each slide.
        # {0} is replaced with the current page number in the file name.
        options = HtmlViewOptions.for_embedded_resources("render_presentation_to_html/pdf_page_{0}.html")
        viewer.view(options)

if __name__ == "__main__":
    render_presentation_to_html()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to HTML](/viewer/python-net/images/rendering-basics/render-presentations/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_presentation_to_html_external():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        # Create an HTML file for each slide.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_presentation_to_html_external/pdf_page_{0}.html", "render_presentation_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_presentation_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_presentation_to_html_external()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-presentations/render-to-html-external-resources.png)

## Render presentations as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a presentation file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_presentation_to_pdf():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        viewOptions = PdfViewOptions("render_presentation_to_pdf/presentation.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_presentation_to_pdf()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PDF](/viewer/python-net/images/rendering-basics/render-presentations/render-to-pdf.png)

## Render presentations as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a presentation file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_presentation_to_png():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        # Create a PNG image for each slide.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_presentation_to_png/presentation_page_0_{0}.png")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_presentation_to_png()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation file to PNG](/viewer/python-net/images/rendering-basics/render-presentations/render-to-png-image.png)

## Render presentations as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a presentation file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) methods to specify the output image size in pixels.


{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_presentation_to_jpg():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        # Create a JPG image for each slide.
        # {0} is replaced with the current page number in the image name.
        viewOptions = JpgViewOptions("render_presentation_to_jpg/presentation_to_jpg_{0}.jpg")
        viewOptions.width = 950
        viewOptions.height = 550
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_presentation_to_jpg()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render hidden slides

If your presentation contains hidden slides, use the [ViewOptions.render_hidden_pages](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/#properties) method for a target view to display these slides in the output HTML, PDF, or image files.

The following code example uses this option to display hidden slides in the generated PDF file:

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_presentation_with_hidden_slides():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        viewOptions = PdfViewOptions("render_presentation_with_hidden_slides/presentation_with_hidden_slides.pdf")
        viewOptions.render_hidden_pages = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_presentation_with_hidden_slides()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render comments

Use the [ViewOptions.render_comments](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/#properties) method for a target view to display comments in the output file when you convert your presentation to HTML, PDF, PNG, or JPEG format.

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_presentation_with_comments():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        viewOptions = PdfViewOptions("render_presentation_with_comments/presentation_with_comments.pdf")
        viewOptions.render_comments = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_presentation_with_comments()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a presentation with comments](/viewer/python-net/images/rendering-basics/render-presentations/render-presentation-comments-to-pdf.png)

## Render speaker notes

A presentation file can contain speaker notes that help presenters recall important information during the presentation. Speaker notes appear in the **Notes** pane below each slide.

![Speaker notes in Microsoft PowerPoint](/viewer/python-net/images/rendering-basics/render-presentations/presentation-speaker-notes.png)

Use the [ViewOptions.render_notes](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/#properties) method for a target view to display speaker notes in the output HTML, PDF, or image files.

The following code sample renders a presentation with speaker notes to PDF:

{{< tabs "example9">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_presentation_with_notes():
    # Load presentation
    with Viewer("sample.pptx") as viewer:
        viewOptions = PdfViewOptions("render_presentation_with_notes/presentation_with_notes.pdf")
        viewOptions.render_notes = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_presentation_with_notes()
```
{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
`sample.pptx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-presentations/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render a presentation with notes](/viewer/python-net/images/rendering-basics/render-presentations/render-presentation-notes-to-pdf.png)

---

## Save file to stream

Path: /conversion/net/save-file-to-stream/

To save the conversion results to a stream, follow these steps:

1.   Specify the method to obtain the stream where the converted file will be sent.
2.   Pass the method's name as the `document` parameter to the [Convert()](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/) method implementations. 

The `document` parameter could be of `Func<Stream>`, `Func<FileType, Stream>`, `Func<int, Stream>`, or `Func<int, FileType, Stream>` type.

The following code snippet shows how to save a file to a stream:

```csharp
public static void Run()
{
    Func<SaveContext, Stream> getOutputStream = saveContext => GetFileStream($"c:\\files\\converted.{saveContext.TargetFormat.Extension}");

    using (Converter converter = new Converter("c:\\files\\sample.docx"))
    {
        PdfConvertOptions options = new PdfConvertOptions();
        // Pass the output stream as parameter
        converter.Convert(getOutputStream, options);
    }

    Console.WriteLine($"\nSource file converted successfully.\nSent file to stream.");
}

// Obtain the stream for the conversion output
public static Stream GetFileStream(string outFile)
{
    return new FileStream(outFile, FileMode.OpenOrCreate);
}
```

You can also use the [ConvertTo(Func<Stream> convertedStreamProvider)](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.fluent/iconversionto/convertto/#convertto) [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}}) method to save a file to a stream:

```csharp
public static void Run()
{
    Func<SaveContext, Stream> getOutputStream = saveContext => GetFileStream($"c:\\files\\converted.{saveContext.TargetFormat.Extension}");

    FluentConverter
        // Specify source file location
        .Load("c:\\files\\sample.docx")
        // Pass the output stream as parameter
        .ConvertTo(getOutputStream)
        .Convert();
}

// Obtain the stream for the conversion output
public static Stream GetFileStream(string outFile)
{
    return new FileStream(outFile, FileMode.OpenOrCreate);
}
```

---

## Save image by custom strategy

Path: /markdown/net/custom-strategy/


Use `CustomImagesStrategy` with the `IImageSavingHandler` interface for full control over how each image is saved during conversion. You can rename files, redirect output to a custom stream, or replace image content entirely.

### Rename images with IImageSavingHandler

Implement `IImageSavingHandler` to customize saving logic for each image:

{{< tabs "custom-strategy-rename">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Implement the IImageSavingHandler interface
public class RenameHandler : IImageSavingHandler
{
    private int _index;

    public void Handle(CustomImageSavingArgs args)
    {
        args.SetOutputImageFileName($"img_{_index}_{args.ImageFileName}");
        _index++;
    }
}

// Use the handler with CustomImagesStrategy
var handler = new RenameHandler();
var options = new ConvertOptions
{
    ImageExportStrategy = new CustomImagesStrategy("output/images", handler)
};

MarkdownConverter.ToFile("business-plan.docx", "output/document.md", options);
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "custom-strategy-rename.zip" >}}  
```text
output/document.md (5 KB)
output/images/img_0_img-001.png (4 KB)
output/images/img_1_img-002.jpg (41 KB)
output/images/img_2_img-003.png (14 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/custom-strategy/CustomStrategyRename/custom-strategy-rename.zip)
{{< /tab >}}
{{< /tabs >}}

### Replace image content with SetReplacementImage

Use `SetReplacementImage` to substitute the original image with different content (e.g., a watermarked version or a placeholder):

{{< tabs "custom-strategy-replace">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using GroupDocs.Markdown;

public class WatermarkHandler : IImageSavingHandler
{
    public void Handle(CustomImageSavingArgs args)
    {
        // Replace the original image with a custom placeholder
        Stream placeholder = File.OpenRead("placeholder.png");
        args.SetReplacementImage(placeholder);
        args.SetOutputImageFileName("placeholder.png");
    }
}

var handler = new WatermarkHandler();
var options = new ConvertOptions
{
    ImageExportStrategy = new CustomImagesStrategy("output/images", handler)
};

MarkdownConverter.ToFile("business-plan.docx", "output/document.md", options);
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "custom-strategy-replace.zip" >}}  
```text
output/document.md (5 KB)
output/images/placeholder.png (14 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/strategy/custom-strategy/CustomStrategyReplace/custom-strategy-replace.zip)
{{< /tab >}}
{{< /tabs >}}

---

## Save image by custom strategy

Path: /markdown/python-net/custom-strategy/


Use `CustomImagesStrategy` with a Python callable for full control over how each image is saved during conversion. You can rename files, redirect output to a custom stream, or replace image content entirely.

### Rename images with a callable handler

Pass a Python callable to customize saving logic for each image:

{{< tabs "custom-strategy-rename">}}
{{< tab "custom_strategy_rename.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, CustomImagesStrategy

def custom_strategy_rename():
    """Rename images sequentially using a custom image saving handler."""

    # Step 1: Set up an image counter for sequential naming
    counter = [0]

    # Step 2: Define a handler that renames each image
    def rename_handler(call_info):
        """Called for each image during conversion.
        Receives context with ImageFileName, ShapeType, OutputDirectory.
        Returns dict with output actions."""
        ctx = call_info["context"]
        counter[0] += 1
        new_name = f"fig-{counter[0]}.png"
        print(f"  Renaming: {ctx['ImageFileName']} -> {new_name}")
        return {"output_image_file_name": new_name}

    # Step 3: Configure the custom image strategy with the handler
    options = ConvertOptions()
    options.image_export_strategy = CustomImagesStrategy("./output/images", rename_handler)

    # Step 4: Convert -- each image triggers the rename_handler callback
    MarkdownConverter.to_file("business-plan.docx", "output/document.md", convert_options=options)

if __name__ == "__main__":
    import os
    os.makedirs("output/images", exist_ok=True)
    custom_strategy_rename()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "custom-strategy-rename.zip" >}}  
```text
output/document.txt (21 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/custom-strategy/custom_strategy_rename/custom-strategy-rename.zip)
{{< /tab >}}
{{< tab "custom-strategy-rename.zip" >}}  
```text
output/document.txt (20 KB)
output/images/fig-1.png (56 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/custom-strategy/custom_strategy_rename/custom-strategy-rename.zip)
{{< /tab >}}
{{< /tabs >}}

### Replace image content with a placeholder

Use the `replacement_image_path` return value to substitute the original image with different content (e.g., a watermarked version or a placeholder):

{{< tabs "custom-strategy-replace">}}
{{< tab "custom_strategy_replace.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, CustomImagesStrategy

def custom_strategy_replace():
    """Replace every image with a placeholder during conversion."""

    # Step 1: Define a handler that substitutes each image with a placeholder
    def watermark_handler(call_info):
        """Replace every image with a placeholder file."""
        return {
            "output_image_file_name": "placeholder.png",
            "replacement_image_path": "./assets/placeholder.png"
        }

    # Step 2: Configure the custom image strategy with the replacement handler
    options = ConvertOptions()
    options.image_export_strategy = CustomImagesStrategy("./output/images", watermark_handler)

    # Step 3: Convert and save using keyword argument for options
    MarkdownConverter.to_file("business-plan.docx", "output/document.md", convert_options=options)

if __name__ == "__main__":
    import os
    os.makedirs("output/images", exist_ok=True)
    custom_strategy_replace()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/strategy/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "custom-strategy-replace.zip" >}}  
```text
output/document.txt (21 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/custom-strategy/custom_strategy_replace/custom-strategy-replace.zip)
{{< /tab >}}
{{< tab "custom-strategy-replace.zip" >}}  
```text
output/document.txt (20 KB)
output/images/placeholder.png (56 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/strategy/custom-strategy/custom_strategy_replace/custom-strategy-replace.zip)
{{< /tab >}}
{{< /tabs >}}

### Callback response keys

Return a dictionary with one or more of the following keys. Return `None` or `{}` to keep defaults. Exceptions raised in handlers are re-raised with the original type and traceback.

| Response key | Effect |
|---|---|
| `output_image_file_name` | Override the image file name |
| `replacement_image_path` | Replace the image with a file at the given path |
| `output_stream_path` | Redirect image data to a file at the given path |

The handler receives a `call_info` dictionary with a `"context"` key containing `ImageFileName`, `ShapeType`, and `OutputDirectory`.

---

## Save to stream

Path: /redaction/java/save-to-stream/

You might need to save a document to any custom file at any location on the local disc or a even a Stream.

The following example demonstrates how to save a document to any location.



```java
final Redactor redactor = new Redactor("Sample.docx");
try 
{
    // Here we can use document instance to perform redactions
    RedactorChangeLog result = redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(java.awt.Color.RED)));
    if (result.getStatus() != RedactionStatus.Failed)
    {
        // Save the document to a custom location and convert its pages to images
        final FileOutputStream fileStream = new FileOutputStream("C:\\\\Temp\\\\sample_output_file.pdf");
        try 
        {
            RasterizationOptions options = new  RasterizationOptions();
            options.setEnabled(true);
            redactor.save(fileStream, options);
        }
        finally { fileStream.close(); }
    }
}
finally { redactor.close(); }

```

---

## Save with default options

Path: /redaction/net/save-with-default-options/

The simplest way to save the document is it provide no parameters to [Save](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor/methods/save) method. In this case the document will be rasterized to PDF and will have the same name as the original one except its extension (.PDF). The PDF file will be overwritten.

The following example demonstrates usage of [Save()](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor/methods/save) method with default options.

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Here we can use document instance to perform redactions
    redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    // Save the document with default options (convert pages into images, save as PDF)
    redactor.Save();
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save with default options

Path: /redaction/python-net/save-with-default-options/

The simplest way to save the document is it provide no parameters to [Save](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor/save/) method. In this case the document will be rasterized to PDF and will have the same name as the original one except its extension (.PDF). The PDF file will be overwritten.

The following example demonstrates usage of [Save()](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor/save/) method with default options.

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the document with default options (convert pages into images, save as PDF)
        result_path = redactor.save()

    # Indicate the successful rendering of the source document and specify where to find the output in the specified directory
    print(f"Document redacted successfully.\nCheck output in {result_path}.")
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Saving a File to an Output Stream

Path: /conversion/java/save-file-to-stream/

To save the conversion results directly to an **OutputStream**, follow these steps:

1.   **Define a Method to Obtain the Output Stream**:
Create a method that returns an `OutputStream`. This stream will be the destination for the converted file.

2.   **Pass the Output Stream to the** `convert()` **Method**:
Use the output stream as a parameter in the [convert()](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/#convert-com.groupdocs.conversion.contracts.SaveDocumentStream-com.groupdocs.conversion.options.convert.ConvertOptions-) method to direct the converted file to the stream instead of saving it directly to a file.

{{< alert style="note" >}}
This approach is particularly useful when:
- You want to process the converted file in memory without writing it to disk immediately.
- You need to send the file over a network, such as through an HTTP response.
- You are integrating with external systems or APIs that require stream-based file handling.
{{< /alert >}}
The following code snippet demonstrates how to convert a Word document (`.docx`) to a PDF file and save the output to an `OutputStream`:

{{< tabs "code-example">}}
{{< tab "ConvertDocxToPdf.java" >}}  
```java
import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.function.Supplier;
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class ConvertDocxToPdf {
    public static void convert() {
        // Create a supplier that provides the output stream for the converted file
        Supplier<OutputStream> getOutputStream = () -> getFileStream("c:\\files\\business-plan.pdf");

        // Initialize the converter with the source document
        Converter converter = new Converter("c:\\files\\business-plan.docx");

        // Define conversion options (converting to PDF)
        PdfConvertOptions options = new PdfConvertOptions();

        // Pass the output stream to the convert method
        converter.convert(getOutputStream.get(), options);
    }

    // Method to obtain the output stream for the conversion result
    public static OutputStream getFileStream(String outFile) {
        try {
            return new FileOutputStream(new File(outFile));
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/save-file-to-local-disk/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/save-file-to-local-disk/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation:
- **Creating the Output Stream Supplier**:
The `Supplier<OutputStream>` is a functional interface that lazily provides the output stream. This allows flexibility if you need to configure the stream dynamically.
- **Initializing the Converter**:
The `Converter` object is initialized with the source file (`business-plan.docx`).
- **Setting Conversion Options**:
The `PdfConvertOptions` object defines specific options for converting to PDF. You can customize this according to your needs, such as setting the page orientation, margins, or compression.
- **Converting and Writing to the Stream**:
The `convert()` method takes the output stream provided by `getOutputStream.get()` and writes the converted content directly to it. In this case, the PDF file will be saved to `c:\\files\\business-plan.pdf`.
- **Error Handling**:
The `getFileStream()` method includes basic error handling. If an exception occurs while creating the file stream (e.g., due to incorrect file paths or permission issues), the stack trace will be printed, and `null` will be returned.

---

## Scatter Chart in Email Document

Path: /assembly/java/scatter-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Email Document format.{{< /alert >}}

## Scatter Chart in Microsoft PowerPoint Document

### Creating a Scatter Chart

Please following below steps to create Scatter Chart in MS Outlook 2013:

1.  Create a new Email.
2.  Click in the email where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "XY (Scatter)".
4.  Preview "Scatter" and press OK to insert the chart and Worksheet template to your email.
5.  Edit the Worksheet with your data to update the chart.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to show contract prices by month with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show information on a Scatter Chart.
*   It must indicate total contract prices by month.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Months<<foreach [in getContracts()
.groupBy(c => c.getDate().getMonth())]>>
```

#### Chart Data (Email)

| X-Values | Total Contract Price<<x [key + 1]>><<y [sum(c => c.getPrice())]>> |
| -------- | ------------------------------------------------------------ |
| 0.7      | 2.7                                                          |
| 1.8      | 3.2                                                          |
| 2.6      | 0.8                                                          |

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs 0127601c204a7ff3449fd2dae98eb7d6 >}}



---

## Scatter Chart in Email Document

Path: /assembly/net/scatter-chart-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Scatter Chart report in Email Document format.{{< /alert >}}

## Scatter Chart in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater{{< /alert >}}

### Creating a Scatter Chart

Please following below steps to create Scatter Chart in MS Outlook 2013:

1.  Create a new Email.
2.  Click in the email where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
3.  Select "XY (Scatter)".
4.  Preview "Scatter" and press OK to insert the chart and Worksheet template to your email.
5.  Edit the Worksheet with your data to update the chart.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to show contract prices by month with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show information on a Scatter Chart.
*   It must indicate Price of each order by month.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Prices by Months<<foreach [in orders
.GroupBy(c => c.OrderDate.Month)]>>
```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">X-Values</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Total Order Price&lt;&lt;x [Key]&gt;&gt;&lt;&lt;y [Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">0.7</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.7</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3.2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 47.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.6</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 258.2pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">0.8</span></p></td></tr></tbody></table>

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Scatter Chart Template

Please download the sample Scatter Chart document we created in this article:

*   [Scatter Chart.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Scatter%20Chart.msg?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist rida-fatima-aspose 2b13b635e5b76ca49e8080eacc683c47 >}}



---

## Search for encrypted text in Metadata signatures

Path: /signature/java/search-for-encrypted-text-in-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to search encrypted Metadata signatures with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType) with one of following values (DES, TripleDES, RC2, Rijndael), string value key and string value salt.

Here are the steps to search for encrypted Metadata signature with standard encryption with GroupDocs.Signature:
*   *   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.        
    *   Compose object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class with same parameters as secured QR-code was signed with.          
    *   Create objects of [MetadataSearchOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/MetadataSearchOptions) class and setup property  [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) with object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption)
    *   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/MetadataSearchOptions)  to it.
    *   Call method [getData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#getData(java.lang.Class)) of encrypted [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) object that was found.

## Search for encrypted Metadata signature text

This example shows how to search for secure Metadata signature text.

```java
Signature signature = new Signature("MetadataEncryptedText.docx");
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
MetadataSearchOptions options = new MetadataSearchOptions();
options.setDataEncryption(encryption);
 
// search for signatures in document
List<WordProcessingMetadataSignature> signatures = signature.search(WordProcessingMetadataSignature.class,options);
System.out.print("\nSource document contains following signatures.");
 
// get required metadata signatures
WordProcessingMetadataSignature mdAuthor = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("Author")) {
        mdAuthor = mdSign;
        break;
    }
}
if (mdAuthor != null)
{
    System.out.print("Metadata signature found. Name : " + mdAuthor.getName() + ". Value: " + mdAuthor.getData(String.class));
}
// get required metadata signatures
WordProcessingMetadataSignature mdDocId = null;
for (WordProcessingMetadataSignature mdSign : signatures) {
    if (mdSign.getName().equals("DocumentId")) {
        mdDocId = mdSign;
        break;
    }
}
if (mdDocId != null)
{
    System.out.print("Metadata signature found. Name : " + mdDocId.getName() + ". Value: " + mdDocId.getData(String.class));
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for encrypted text in Metadata signatures

Path: /signature/net/search-for-encrypted-text-in-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to search encrypted Metadata signatures with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values (DES, TripleDES, RC2, Rijndael), string value key and string value salt.

Here are the steps to search for encrypted Metadata signature with standard encryption with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or   as a constructor parameter.
* Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class with same parameters as secured QR-code was signed with.  
* Create objects of [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) class and setup property  [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions/dataencryption) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption)
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions)  to it.
* Call method [GetData<string>](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/getdata) of encrypted [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) object that was found.

## Search for encrypted Metadata signature text

This example shows how to search for secure Metadata signature text.

```csharp
using (Signature signature = new Signature("MetadataEncryptedText.docx"))
{
    // setup key and passphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    MetadataSearchOptions options = new MetadataSearchOptions()
    {
        DataEncryption = encryption
    };
    // search for signatures in document
    List<WordProcessingMetadataSignature> signatures = signature.Search<WordProcessingMetadataSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    // get required metadata signatures
    WordProcessingMetadataSignature mdAuthor = signatures.FirstOrDefault(p => p.Name == "Author");
    if(mdAuthor != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdAuthor.Name, mdAuthor.GetData<string>());
    }
    // get required metadata signatures
    WordProcessingMetadataSignature mdDocId = signatures.FirstOrDefault(p => p.Name == "DocumentId");
    if (mdDocId != null)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}", mdDocId.Name, mdDocId.GetData<string>());
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for encrypted text in QR-code signatures

Path: /signature/java/search-for-encrypted-text-in-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to search over secure QR-code signature ([QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature)) with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType) with one of following values (DES, TripleDES, RC2, Rijndael), string value key and string value salt.

Here are the steps to search for secure QR-code text with standard encryption with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Compose object of [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class with same parameters as secured QR-code was signed with.      
*   Create objects of [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) class and setup property [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption)
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) to it.
    

This example shows how to search for secure QR-code signature text.

```java
Signature signature = new Signature("QRCodeEncryptedText.pdf");
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
QrCodeSearchOptions options = new QrCodeSearchOptions();
// specify special pages to search on
options.setAllPages(true);
options.setPageNumber(1);
PagesSetup pagesSetup = new PagesSetup();
pagesSetup.setFirstPage(false);
pagesSetup.setLastPage(true);
pagesSetup.setOddPages(false);
pagesSetup.setEvenPages(true);
options.setPagesSetup(pagesSetup);
// specify types of QR code to verify
options.setEncodeType(QrCodeTypes.QR);
options.setDataEncryption(encryption);
 
 
// search for signatures in document
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class,options);
System.out.print("\nSource document contains following signatures:");
for (QrCodeSignature qrCodeSignature : signatures)
{
    System.out.print("QRCode signature found at page "+qrCodeSignature.getPageNumber()+" with type "+qrCodeSignature.getEncodeType().getTypeName()+" and text "+ qrCodeSignature.getText());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for encrypted text in QR-code signatures

Path: /signature/net/search-for-encrypted-text-in-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to search over secure QR-code signature with standard or custom encryption. Standard encryption is implemented over class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this object expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype)), string value key and string value salt.

Here are the steps to search for secure QR-code text with standard encryption with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Compose object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class with same parameters as secured QR-code was signed with.  
* Create objects of [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) class and setup property [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions/dataencryption) with object of [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption).  
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) to it.

## Searching for embedded text in QR-code signature

This example shows how to search for secure QR-code signature text.

```csharp
using (Signature signature = new Signature("QRCodeEncryptedText.pdf"))
{
    // setup key and pasphrase
    string key = "1234567890";
    string salt = "1234567890";
    // create data encryption
    IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
    QrCodeSearchOptions options = new QrCodeSearchOptions()
    {
        // specify special pages to search on
        AllPages = true,
        // specify special QRCode type to search
        EncodeType = QrCodeTypes.QR,
        //
        DataEncryption = encryption
    };
    // search for signatures in document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var qrCodeSignature in signatures)
    {
        Console.WriteLine("QRCode signature found at page {0} with type {1} and text '{2}'", qrCodeSignature.PageNumber,
            qrCodeSignature.EncodeType.TypeName, qrCodeSignature.Text);
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search text

Path: /parser/java/search-text/

GroupDocs.Parser provides the functionality to search a text from documents by the [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) and [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) methods:

```java
Iterable<SearchResult> search(String keyword);
Iterable<SearchResult> search(String keyword, SearchOptions options);
```

The *keyword* parameter can contain a text or a regular expression. [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) class contains every occurrence of the keyword in the document text. This class has the following members:

| Member | Description |
| --- | --- |
| [getPosition](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult#getPosition()) | A zero-based index of the start position of the search result. Depending on [isSearchByPages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions#isSearchByPages()) property value this index starts from the document start or the document page start. |
| [getPageIndex](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult#getPageIndex()) | The page index where the text is found. |
| [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult#getText()) | The found text. |
| [getLeftHighlightItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult#getLeftHighlightItem()) | The left highlight. |
| [getRightHighlightItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult#getRightHighlightItem()) | The right highlight. |

## Search text by keyword

Here are the steps to search a keyword in the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Check if *collection* isn't null (search is supported for the document);
*   Iterate through the collection and get position and text.

The following example shows how to find a keyword in a document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("lorem");
    // Check if search is supported
    if (sr == null) {
        System.out.println("Search isn't supported");
        return;
    }
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## Search text by regular expression

*SearchOptions* parameter is used to customize a search. This class has the following members:

| Member | Description |
| --- | --- |
| [isMatchCase](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions#isMatchCase()) | The value that indicates whether a text case isn't ignored. |
| [isMatchWholeWord](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions#isMatchWholeWord()) | The value that indicates whether text search is limited by the whole word. |
| [isUseRegularExpression](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions#isUseRegularExpression()) | The value that indicates whether a regular expression is used. |
| [isSearchByPages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions#isSearchByPages()) | The value that indicates whether the search is performed by pages. |
| [getLeftHighlightOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions#getLeftHighlightOptions()) | The options for the left highlight. |
| [getRightHighlightOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions#getRightHighlightOptions()) | The options for the right highlight. |

Here are the steps to search with a regular expression in the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Check if *collection* isn't *null* (search is supported for the document);
*   Iterate through the collection and get position and text.

The following example shows how to search with a regular expression in a document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("[0-9]+", new SearchOptions(true, false, true));
    // Check if search is supported
    if (sr == null) {
        System.out.println("Search isn't supported");
        return;
    }
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## Search text with highlights

Here are the steps to search a text with a highlights:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [HighlightOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/HighlightOptions) object with the parameters for the highlight extraction;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Check if *collection* isn't *null* (search is supported for the document);
*   Iterate through the collection and get position and text.

The following example shows how to search a text with the highlights:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    HighlightOptions highlightOptions = new HighlightOptions(15);
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("lorem", new SearchOptions(true, false, false, highlightOptions));
    // Check if search is supported
    if (sr == null) {
        System.out.println("Search isn't supported");
        return;
    }
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print the found text and highlights:
        System.out.println(String.format("%s%s%s", s.getLeftHighlightItem().getText(), s.getText(), s.getRightHighlightItem().getText()));
    }
}
```

## Search text with page numbers

Here are the steps to search a text with page numbers:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Check if *collection* isn't *null* (search is supported for the document);
*   Iterate through the collection and get position, text and page number.

The following example shows how to search a text with page numbers:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Search a keyword with page numbers
    Iterable<SearchResult> sr = parser.search("lorem", new SearchOptions(false, false, false, true));
    // Check if search is supported
    if (sr == null) {
        System.out.println("Search isn't supported");
        return;
    }
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index, page number and found text:
        System.out.println(String.format("At %d (%d): %s", s.getPosition(), s.getPageIndex(), s.getText()));
    }
} 
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text

Path: /parser/net/search-text/

GroupDocs.Parser provides the functionality to search text from documents by the [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) and [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) methods:

```csharp
IEnumerable<SearchResult> Search(string keyword);
IEnumerable<SearchResult> Search(string keyword, SearchOptions options);
```

The *keyword* parameter can contain a text or a regular expression. [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) class contains every occurrence of the keyword in the document text. This class has the following members:

| Member | Description |
| --- | --- |
| [Position](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult/properties/position) | A zero-based index of the start position of the search result. Depending on [SearchOptions.SearchByPages](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions/properties/searchbypages) property value this index starts from the document start or the document page start. |
| [PageIndex](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult/properties/pageindex) | The page index where the text is found. |
| [Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult/properties/text) | The found text. |
| [LeftHighlightItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult/properties/lefthighlightitem) | The left highlight. |
| [RightHighlightItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult/properties/righthighlightitem) | The right highlight. |

## Search text by keyword

Here are the steps to search a keyword in the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Check if *collection* isn't null (search is supported for the document);
*   Iterate through the collection and get position and text.

The following example shows how to find a keyword in a document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
    // Check if search is supported
    if(sr == null)
    {
        Console.WriteLine("Search isn't supported");
        return;
    }

    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## Search text by regular expression

[SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search. This class has the following members:

| Member | Description |
| --- | --- |
| [MatchCase](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions/properties/matchcase) | The value that indicates whether a text case isn't ignored. |
| [MatchWholeWord](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions/properties/matchwholeword) | The value that indicates whether text search is limited by the whole word. |
| [SearchByPages](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions/properties/searchbypages) | The value that indicates whether the search is performed by pages. |
| [UseRegularExpression](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions/properties/useregularexpression) | The value that indicates whether a regular expression is used. |
| [LeftHighlightOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions/properties/lefthighlightoptions) | The options for the left highlight. |
| [RightHighlightOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions/properties/righthighlightoptions) | The options for the right highlight. |

Here are the steps to search with a regular expression in the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Check if *collection* isn't *null* (search is supported for the document);
*   Iterate through the collection and get position and text.

The following example shows how to search with a regular expression in a document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Check if search is supported
    if(sr == null)
    {
        Console.WriteLine("Search isn't supported");
        return;
    }

    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## Search text with highlights

Here are the steps to search text with a highlights:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [HighlightOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/highlightoptions) object with the parameters for the highlight extraction;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Check if *collection* isn't *null* (search is supported for the document);
*   Iterate through the collection and get position and text.

The following example shows how to search a text with the highlights:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdf))
{
    HighlightOptions highlightOptions = new HighlightOptions(15);
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("lorem", new SearchOptions(true, false, false, highlightOptions));
    // Check if search is supported
    if (sr == null)
    {
        Console.WriteLine("Search isn't supported");
        return;
    }
    // Iterate over search results
    foreach (SearchResult s in sr)
    {
        // Print the found text and highlights: 
        Console.WriteLine(string.Format("{0}{1}{2}", s.LeftHighlightItem.Text, s.Text, s.RightHighlightItem.Text));
    }
}
```

## Search text with page numbers

Here are the steps to search text with page numbers:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser)  object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Check if *collection* isn't null (search is supported for the document);
*   Iterate through the collection and get position, text and page number.

The following example shows how to search a text with page numbers:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(Constants.SamplePdf))
{
    // Search a keyword with page numbers
    IEnumerable<SearchResult> sr = parser.Search("lorem", new SearchOptions(false, false, false, true));
    // Check if search is supported
    if(sr == null)
    {
        Console.WriteLine("Search isn't supported");
        return;
    }
 
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index, page number and found text:
        Console.WriteLine(string.Format("At {0} (page {1}): {2}", s.Position, s.PageIndex, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text

Path: /parser/python-net/search-text/


GroupDocs.Parser provides powerful text search functionality with support for keywords, regular expressions, case-sensitive search, and highlighting.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents for testing
- Basic understanding of regular expressions (for advanced searches)

## Search text by keyword

To search for a specific keyword in a document:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Search for a keyword
    search_results = parser.search("invoice")
    
    # Check if search is supported
    if search_results is None:
        print("Search isn't supported")
    else:
        # Iterate over search results
        for result in search_results:
            # Print position and found text
            print(f"At {result.position}: {result.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/search-text/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** The method returns a collection of `SearchResult` objects, each containing the position and text of every occurrence of the keyword.

## Search with regular expressions

To search using regular expressions:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import SearchOptions

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Create search options for regex search
    # Parameters: match_case, match_whole_word, use_regular_expression
    options = SearchOptions(True, False, True)
    
    # Search with a regular expression (case-sensitive)
    search_results = parser.search(r"page number: \d+", options)
    
    # Check if search is supported
    if search_results is None:
        print("Search isn't supported")
    else:
        # Iterate over search results
        for result in search_results:
            print(f"At {result.position}: {result.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/search-text/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Finds all text matching the regular expression pattern with the specified options.

## Search with case sensitivity and whole word matching
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import SearchOptions

# Create an instance of Parser class
with Parser("./sample.docx") as parser:
    # Search for exact word match (case-insensitive, whole word)
    # Parameters: match_case=False, match_whole_word=True, use_regular_expression=False
    options = SearchOptions(False, True, False)
    
    search_results = parser.search("invoice", options)
    
    if search_results:
        print(f"Found {len(list(search_results))} occurrences of 'invoice' as whole word")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/search-text/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Search text with highlights

To search and extract surrounding text (highlights):
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import SearchOptions, HighlightOptions

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Create highlight options (extract 15 characters around the match)
    highlight_options = HighlightOptions(15)
    
    # Create search options with highlights
    search_options = SearchOptions(
        match_case=False,
        match_whole_word=False,
        use_regular_expression=False,
        left_highlight_options=highlight_options,
        right_highlight_options=highlight_options
    )
    
    # Search with highlights
    search_results = parser.search("lorem", search_options)
    
    if search_results is None:
        print("Search isn't supported")
    else:
        # Iterate over search results and print with highlights
        for result in search_results:
            left_text = result.left_highlight_item.text if result.left_highlight_item else ""
            right_text = result.right_highlight_item.text if result.right_highlight_item else ""
            print(f"{left_text}[{result.text}]{right_text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/search-text/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns search results with context from surrounding text on both sides of the match.

## Search text with page numbers

To search and get page numbers where text appears:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import SearchOptions

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Create search options with page search enabled
    # Parameters: match_case, match_whole_word, use_regular_expression, search_by_pages
    options = SearchOptions(False, False, False, True)
    
    # Search with page numbers
    search_results = parser.search("lorem", options)
    
    if search_results is None:
        print("Search isn't supported")
    else:
        # Iterate over search results
        for result in search_results:
            # Print position, page number, and found text
            print(f"At {result.position} (page {result.page_index + 1}): {result.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/search-text/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Each search result includes the page index where the text was found.

## Advanced search example

Combine multiple search techniques:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import SearchOptions, HighlightOptions

def advanced_search(file_path, pattern, case_sensitive=False, use_regex=False):
    """
    Perform advanced text search with highlights and page numbers.
    """
    try:
        with Parser(file_path) as parser:
            # Configure highlight options
            highlight_opts = HighlightOptions(20)
            
            # Configure search options
            search_opts = SearchOptions(
                match_case=case_sensitive,
                match_whole_word=False,
                use_regular_expression=use_regex,
                search_by_pages=True,
                left_highlight_options=highlight_opts,
                right_highlight_options=highlight_opts
            )
            
            # Perform search
            results = parser.search(pattern, search_opts)
            
            if results is None:
                print("Search not supported for this document")
                return []
            
            # Process results
            found_items = []
            for result in results:
                found_items.append({
                    'text': result.text,
                    'position': result.position,
                    'page': result.page_index + 1,
                    'left_context': result.left_highlight_item.text if result.left_highlight_item else "",
                    'right_context': result.right_highlight_item.text if result.right_highlight_item else ""
                })
            
            return found_items
            
    except Exception as e:
        print(f"Error during search: {e}")
        return []

# Usage
results = advanced_search("sample.pdf", r"\d{4}-\d{2}-\d{2}", use_regex=True)
for item in results:
    print(f"Page {item['page']}: {item['left_context']}[{item['text']}]{item['right_context']}")
```

{{< /tab >}}
{{< /tabs >}}

## Notes

- The `search()` method returns `None` if search is not supported for the document format
- Use `parser.features.search` to check if search is available before calling `search()`
- Regular expressions follow Python's regex syntax
- Highlight extraction adds minimal performance overhead
- Page-based search (`search_by_pages=True`) is useful for large documents

## Related pages

- [Extract text in Accurate mode]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode" >}})
- [Extract text areas]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-areas" >}})
- [Extract highlights]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-highlights" >}})


---

## Search text in EPUB eBooks

Path: /parser/java/search-text-in-epub-ebooks/

To search a keyword in EPUB e-books [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial e-book;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null* value if search isn't supported for the e-book. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null*. For empty EPUB e-book [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in EPUB e-book:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleEpub)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("One");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method is used for the advanced search in EPUB e-books - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial e-book;
*   Instantiate  [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in EPUB e-book:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleEpub)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("\\\\slist", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in EPUB eBooks

Path: /parser/net/search-text-in-epub-ebooks/

To search a keyword in EPUB e-books [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial e-book;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null* value if search isn't supported for the e-book. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null*. For empty EPUB e-book [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in EPUB e-book:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
   
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in EPUB e-books - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in EPUB e-book:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial e-book;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in EPUB e-book:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft Office Excel spreadsheets

Path: /parser/java/search-text-in-microsoft-office-excel-spreadsheets/

To search a keyword in Microsoft Office Excel spreadsheets [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null value if search isn't supported for the spreadsheet. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null. For empty Microsoft Office Excel spreadsheet [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.{{< /alert >}}

The following example shows how to find a keyword in Microsoft Office Excel spreadsheet:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("Age");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}

```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method is used for the advanced search in Microsoft Office Excel spreadsheets - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial spreadsheet;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft Office Excel spreadsheet:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("[0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft Office Excel spreadsheets

Path: /parser/net/search-text-in-microsoft-office-excel-spreadsheets/

To search a keyword in Microsoft Office Excel spreadsheets [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null* value if search isn't supported for the spreadsheet. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null*. For empty Microsoft Office Excel spreadsheet [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in Microsoft Office Excel spreadsheet:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
  
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in Microsoft Office Excel spreadsheets - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft Office Excel spreadsheet:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft Office PowerPoint presentations

Path: /parser/java/search-text-in-microsoft-office-powerpoint-presentations/

To search a keyword in Microsoft Office PowerPoint presentations [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null value if search isn't supported for the presentation. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null. For empty Microsoft Office PowerPoint presentation [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.{{< /alert >}}

The following example shows how to find a keyword in Microsoft Office PowerPoint presentation:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePptx)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("Age");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method is used for the advanced search in Microsoft Office PowerPoint presentations - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial presentation;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft Office PowerPoint presentation:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePptx)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("[0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)
    
### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft Office PowerPoint presentations

Path: /parser/net/search-text-in-microsoft-office-powerpoint-presentations/

To search a keyword in Microsoft Office PowerPoint presentations [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial presentation;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}Search(String) method returns null value if search isn't supported for the presentation. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive Search(String) method returns null. For empty Microsoft Office PowerPoint presentation Search(String) method returns an empty collection.{{< /alert >}}

The following example shows how to find a keyword in Microsoft Office PowerPoint presentation:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
   
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in Microsoft Office PowerPoint presentations - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in Microsoft Office PowerPoint presentation:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial presentation;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft Office PowerPoint presentation:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Set image size limits

Path: /viewer/java/set-image-size-limits-when-rendering-to-pdf/

The [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) class has the following methods to set or get the image width or/and height:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
/**
 * Max width of an output image in pixels. (When converting single image to HTML only)
 */
public int getImageMaxWidth();

/**
 * Max width of an output image in pixels. (When converting single image to HTML only)
 */
public void setImageMaxWidth(int imageMaxWidth);

/**
 * Max height of an output image in pixels. (When converting single image to HTML only)
 */
public int getImageMaxHeight();

/**
 * Max height of an output image in pixels. (When converting single image to HTML only)
 */
public void setImageMaxHeight(int imageMaxHeight);

/**
 * The width of the output image in pixels. (When converting single image to HTML only)
 */
public int getImageWidth();

/**
 * The width of the output image in pixels. (When converting single image to HTML only)
 */
public void setImageWidth(int imageWidth);

/**
 * The height of an output image in pixels. (When converting single image to HTML only)
 */
public int getImageHeight();

/**
 * The height of an output image in pixels. (When converting single image to HTML only)
 */
public void setImageHeight(int imageHeight);
```
{{< /tab >}}
{{< /tabs >}}

You can set the width and/or height of the output images. Use one of the following methods: 

* To render a single image, call setImageWidth/setImageHeight methods.
* To render multiple images, call setImageMaxWidth/setImageMaxHeight options. If an image exceeds these limits, it is resized proportionally.

{{< alert style="warning" >}}
If you set the ImageWidth/ImageHeight options, calls of setImageMaxWidth/setImageMaxHeight methods are ignored.
{{< /alert >}}

To call the setImageMaxWidth/setImageMaxHeight methods, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object.
2. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) object.
3. Call the setImageMaxWidth and/or setImageMaxHeight methods;
4. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

The following code snippet shows how to set the output image size limits:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.jpg")) {
    PdfViewOptions viewOptions = new PdfViewOptions("result.pdf");
    viewOptions.setImageMaxWidth(800);
    viewOptions.setImageMaxHeight(600);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Set image size limits

Path: /viewer/net/set-image-size-limits-when-rendering-to-pdf/

The [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) class has the following properties to set the image width or/and height:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
/// <summary>
/// Max width of an output image in pixels.
/// </summary>
public int ImageMaxWidth { get; set; }

/// <summary>
/// Max height of an output image in pixels.
/// </summary>
public int ImageMaxHeight { get; set; }

/// <summary>
/// The width of the output image in pixels.
/// </summary>
public int ImageWidth { get; set; }

/// <summary>
/// The height of an output image in pixels.
/// </summary>
public int ImageHeight { get; set; }
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Class SurroundingClass
    ''' <summary>
    ''' Max width of an output image in pixels.
    ''' </summary>
    Public Property ImageMaxWidth As Integer

    ''' <summary>
    ''' Max height of an output image in pixels.
    ''' </summary>
    Public Property ImageMaxHeight As Integer

    ''' <summary>
    ''' The width of the output image in pixels.
    ''' </summary>
    Public Property ImageWidth As Integer

    ''' <summary>
    ''' The height of an output image in pixels.
    ''' </summary>
    Public Property ImageHeight As Integer
End Class
```
{{< /tab >}}
{{< /tabs >}}

You can set the width and/or height of the output images. Use one of the following methods: 

* To render a single image, set ImageWidth/ImageHeight options.
* To render multiple images, set ImageMaxWidth/ImageMaxHeight options. If an image exceeds these limits, it is resized proportionally.

{{< alert style="warning" >}}
If you set the ImageWidth/ImageHeight options, the ImageMaxWidth/ImageMaxHeight options are ignored.
{{< /alert >}}

To set the ImageMaxWidth/ImageMaxHeight options, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object.
2. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) object.
3. Set the ImageMaxWidth and/or ImageMaxHeight values;
4. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method.

The following code snippet shows how to set the output image size limits:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer;
// ...

using (Viewer viewer = new Viewer("sample.jpg"))
{
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions();
    
    // Specify the maximum width and height.
    viewOptions.ImageMaxWidth = 800;
    viewOptions.ImageMaxHeight = 600;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.jpg")
            ' Create a PDF file.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()

            ' Specify the maximum width and height.
            viewOptions.ImageMaxWidth = 800
            viewOptions.ImageMaxHeight = 600
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Set image size limits

Path: /viewer/python-net/set-image-size-limits-when-rendering-to-pdf/

The [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class has the following properties to set the image width or/and height:

* **image_max_width** (int) - Max width of an output image in pixels.
* **image_max_height** (int) - Max height of an output image in pixels.
* **image_width** (int) - The width of the output image in pixels.
* **image_height** (int) - The height of an output image in pixels.

You can set the width and/or height of the output images. Use one of the following methods: 

* To render a single image, set image_width/image_height options.
* To render multiple images, set image_max_width/image_max_height options. If an image exceeds these limits, it is resized proportionally.

{{< alert style="warning" >}}
If you set the image_width/image_height options, the image_max_width/image_max_height options are ignored.
{{< /alert >}}

To set the image_max_width/image_max_height options, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) object.
2. Instantiate the [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) object.
3. Set the image_max_width and/or image_max_height values;
4. Call the [view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

The following code snippet shows how to set the output image size limits:

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def set_image_size_limits():
    # Load document
    with Viewer("sample.jpg") as viewer:
        # Create a PDF file.
        viewOptions = PdfViewOptions("set_image_size_limits/image_with_size_limits.pdf")

        # Specify the maximum width and height.
        viewOptions.image_max_width = 800
        viewOptions.image_max_height = 600
        viewer.view(viewOptions)

if __name__ == "__main__":
    set_image_size_limits()
```
{{< /tab >}}
{{< tab "sample.jpg" >}}
{{< tab-text >}}
`sample.jpg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/set-image-size-limits-when-rendering-to-pdf/sample.jpg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Set metadata properties

Path: /metadata/java/set-metadata-properties/

## Update or add metadata properties satisfying a predicate

The [setProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#setProperties(com.groupdocs.metadata.search.Specification,%20com.groupdocs.metadata.core.PropertyValue)) method used in this code sample actually combines two operations: add and update. If an existing property satisfies the specified predicate its value is updated. If there is a known property missing in a metadata package that satisfies the predicate it is added to the appropriate package.

The code snippet below demonstrates a basic usage scenario of the [setProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#setProperties(com.groupdocs.metadata.search.Specification,%20com.groupdocs.metadata.core.PropertyValue)) method.

1.  [Open]({{< ref "metadata/java/developer-guide/basic-usage/set-metadata-properties.md" >}}) a file to update
2.  Specify a predicate that will be used to add/update metadata properties
3.  Specify a value you would like to add to existing metadata packages in the file
4.  Check the actual number of added/updated properties
5.  [Save]({{< ref "metadata/java/developer-guide/basic-usage/set-metadata-properties.md" >}}) the changes

**basic\_usage.SetMetadataProperties**

```csharp
// Constants.InputVsdx is an absolute or relative path to your document. Ex: @"C:\Docs\source.vsdx"
try (Metadata metadata = new Metadata(Constants.InputVsdx)) {
	// Set the value of each property that satisfies the predicate:
	// property contains the date/time the document was created OR modified
	int affected = metadata.setProperties(
			new ContainsTagSpecification(Tags.getTime().getCreated()).or(new ContainsTagSpecification(Tags.getTime().getModified())),
			new PropertyValue(new Date()));
	System.out.println(String.format("Properties set: %s", affected));
	metadata.save(Constants.OutputVsdx);
}
```

As a result, we update all existing metadata properties containing the date the document was created/updated. If a metadata package doesn't contain such properties but they are meant to be in its structure they are added.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/java/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/java/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/java/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/java/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Set metadata properties

Path: /metadata/net/set-metadata-properties/

## Update or add metadata properties satisfying a predicate

The [SetProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/setproperties) is used to update or add metadata. You can easily add metadata to photos, pdfs or you can update or add data to mp3 files. This code sample actually combines two operations: add and update. If an existing property satisfies the specified predicate its value is updated. If there is a known property missing in a metadata package that satisfies the predicate it is added to the appropriate package.

The code snippet below demonstrates a basic usage scenario of the [SetProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/setproperties) method.

1.  [Open]({{< ref "metadata/net/developer-guide/basic-usage/set-metadata-properties.md" >}}) a file to update
2.  Specify a predicate that will be used to add/update metadata properties
3.  Specify a value you would like to add to existing metadata packages in the file
4.  Check the actual number of added/updated properties
5.  [Save]({{< ref "metadata/net/developer-guide/basic-usage/set-metadata-properties.md" >}}) the changes

**BasicUsage.SetMetadataProperties**

```csharp
// Constants.InputVsdx is an absolute or relative path to your document. Ex: @"C:\Docs\source.vsdx"
using (Metadata metadata = new Metadata(Constants.InputVsdx))
{
	// Set the value of each property that satisfies the predicate:
	// property contains the date/time the document was created OR modified
	var affected = metadata.SetProperties(
		p => p.Tags.Contains(Tags.Time.Created) || p.Tags.Contains(Tags.Time.Modified),
		new PropertyValue(DateTime.Now));
	Console.WriteLine("Properties set: {0}", affected);
	metadata.Save(Constants.OutputVsdx);
}
```

As a result, we update all existing metadata properties containing the date the document was created/updated. If a metadata package doesn't contain such properties but they are meant to be in its structure they are added.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/net/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/net/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/net/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/net/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources
### Advanced usage topics
To learn more about document watermarking features and get familiar how to manage watermarks and more, please refer to the [advanced usage section]({{< ref "metadata/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Set metadata properties

Path: /metadata/nodejs-java/set-metadata-properties/

## Update or add metadata properties satisfying a predicate

The **setProperties** method used in this code sample actually combines two operations: add and update. If an existing property satisfies the specified predicate its value is updated. If there is a known property missing in a metadata package that satisfies the predicate it is added to the appropriate package.

The code snippet below demonstrates a basic usage scenario of the **setProperties** method.

1.  **Open** a file to update
2.  Specify a predicate that will be used to add/update metadata properties
3.  Specify a value you would like to add to existing metadata packages in the file
4.  Check the actual number of added/updated properties
5.  **Save** the changes

**basic\_usage.SetMetadataProperties**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata("input.vsdx");

    // Set the value of each property that satisfies the predicate:
    // property contains the date/time the document was created OR modified
    var affected = metadata.setProperties(
        new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getTime().getCreated()).or(new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getTime().getModified())),
        new groupdocs.metadata.PropertyValue(new Date()));


    console.log(`Properties set: ${affected}`);

    metadata.save("output.vsdx");
```
{{< /tab >}}
{{< /tabs >}}

As a result, we update all existing metadata properties containing the date the document was created/updated. If a metadata package doesn't contain such properties but they are meant to be in its structure they are added.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Updating metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/updating-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Set metadata properties

Path: /metadata/python-net/set-metadata-properties/

## Update or add metadata properties satisfying a predicate

The **setProperties** method used in this code sample actually combines two operations: add and update. If an existing property satisfies the specified predicate its value is updated. If there is a known property missing in a metadata package that satisfies the predicate it is added to the appropriate package.

The code snippet below demonstrates a basic usage scenario of the **setProperties** method.

1.  **Open** a file to update
2.  Specify a predicate that will be used to add/update metadata properties
3.  Specify a value you would like to add to existing metadata packages in the file
4.  Check the actual number of added/updated properties
5.  **Save** the changes

**basic\_usage.SetMetadataProperties**


```python
with gm.Metadata(constants.input_vsdx) as metadata:
        specification = gm.search.ContainsTagSpecification(gm.tagging.Tags.time.created).either(gm.search.ContainsTagSpecification(gm.tagging.Tags.time.modified))
        now = datetime.now()
        property_value = gm.common.PropertyValue(now)
        affected = metadata.set_properties(specification, property_value)
        print(f"Properties set: {affected}")
        metadata.save(constants.output_vsdx)
```


As a result, we update all existing metadata properties containing the date the document was created/updated. If a metadata package doesn't contain such properties but they are meant to be in its structure they are added.

For more information on supported features of the GroupDocs.Metadata search engine please refer to the following articles:

*   [Extracting metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/extracting-metadata.md" >}})
*   [Removing metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/removing-metadata.md" >}})
*   [Adding metadata]({{< ref "metadata/python-net/developer-guide/advanced-usage/adding-metadata.md" >}})

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Shapes in spreadsheet document

Path: /watermark/java/shapes-in-spreadsheet-document/

## Extracting information about all shapes in an Excel document

[Search()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark/Watermarker#search()) method searches watermarks of all mentioned types, but in some cases, it's necessary to analyze only one class of Excel objects. Following code sample shows how to get information about all the [shapes](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetWorksheet#getShapes()) in an Excel document.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetGetShapesInformation**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                              
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                            
                                                                                                                
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                  
for (SpreadsheetWorksheet worksheet : content.getWorksheets())                                                  
{                                                                                                               
    for (SpreadsheetShape shape : worksheet.getShapes())                                                        
    {                                                                                                           
        System.out.println(shape.getAutoShapeType());                                                           
        System.out.println(shape.getMsoDrawingType());                                                          
        System.out.println(shape.getText());                                                                    
        if (shape.getImage() != null)                                                                           
        {                                                                                                       
            System.out.println(shape.getImage().getWidth());                                                    
            System.out.println(shape.getImage().getHeight());                                                   
            System.out.println(shape.getImage().getBytes().length);                                             
        }                                                                                                       
                                                                                                                
        System.out.println(shape.getId());                                                                      
        System.out.println(shape.getAlternativeText());                                                         
        System.out.println(shape.getX());                                                                       
        System.out.println(shape.getY());                                                                       
        System.out.println(shape.getWidth());                                                                   
        System.out.println(shape.getHeight());                                                                  
        System.out.println(shape.getRotateAngle());                                                             
        System.out.println(shape.isWordArt());                                                                  
        System.out.println(shape.getName());                                                                    
    }                                                                                                           
}                                                                                                               
                                                                                                                
watermarker.close();                                                                                            
```

## Removing a particular shape

You can also remove a particular [shape](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetWorksheet#getShapes()) from the worksheet as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetRemoveShape**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                                  
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"   
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                                
                                                                                                                    
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                      
                                                                                                                    
// Remove shape by index                                                                                            
content.getWorksheets().get_Item(0).getShapes().removeAt(0);                                                        
                                                                                                                    
// Remove shape by reference                                                                                        
content.getWorksheets().get_Item(0).getShapes().remove(content.getWorksheets().get_Item(0).getShapes().get_Item(0));
                                                                                                                    
watermarker.save("spreadsheet.xlsx");                                                                     
                                                                                                                    
watermarker.close();                                                                                                
```

## Removing shapes with particular text formatting

You can also find and remove the shapes with a [particular text formatting](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#getFormattedTextFragments()) from an Excel document as shown in the below code sample.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetRemoveTextShapesWithParticularTextFormatting**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                                    
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"     
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                                  
                                                                                                                      
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                        
for (SpreadsheetWorksheet section : content.getWorksheets())                                                          
{                                                                                                                     
    for (int i = section.getShapes().getCount() - 1; i >= 0; i--)                                                     
    {                                                                                                                 
        for (FormattedTextFragment fragment : section.getShapes().get_Item(i).getFormattedTextFragments())            
        {                                                                                                             
            if (fragment.getForegroundColor().equals(Color.getRed()) && fragment.getFont().getFamilyName() == "Arial")
            {                                                                                                         
                section.getShapes().removeAt(i);                                                                      
                break;                                                                                                
            }                                                                                                         
        }                                                                                                             
    }                                                                                                                 
}                                                                                                                     
                                                                                                                      
watermarker.save("spreadsheet.xlsx");                                                                       
                                                                                                                      
watermarker.close();                                                                                                  
```

## Removing/replacing hyperlink associated with a particular shape

Using GroupDocs.Watermark for Java, you can also remove/replace hyperlink associated with a particular [shape](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setHyperlink(java.lang.String)) or [chart](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetChart#setHyperlink(java.lang.String)) inside an Excel document. Use following code sample to achieve this functionality.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetRemoveHyperlinks**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
                                                                                                                 
// Replace hyperlink                                                                                             
content.getWorksheets().get_Item(0).getCharts().get_Item(0).setHyperlink("https://www.aspose.com/");             
content.getWorksheets().get_Item(0).getShapes().get_Item(0).setHyperlink("https://www.groupdocs.com/");          
                                                                                                                 
// Remove hyperlink                                                                                              
content.getWorksheets().get_Item(1).getCharts().get_Item(0).setHyperlink(null);                                  
content.getWorksheets().get_Item(1).getShapes().get_Item(0).setHyperlink(null);                                  
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

{{< alert style="warning" >}}This feature is also supported for charts.{{< /alert >}}

## Replacing text for particular shapes

Since version 17.12, GroupDocs.Watermark supports replacing [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setText(java.lang.String)) for particular shapes in an Excel Worksheet. Following code sample shows the usage of this feature.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetReplaceTextForParticularShapes**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
for (SpreadsheetShape shape : content.getWorksheets().get_Item(0).getShapes())                                   
{                                                                                                                
    if (shape.getText() == "© Aspose 2016")                                                                      
    {                                                                                                            
        shape.setText("© GroupDocs 2017");                                                                       
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Replacing text for particular shapes with formatted text

You can also replace the [text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setText(java.lang.String)) of the shapes with [formatted text](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#getFormattedTextFragments()) as shown in the following code sample.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetReplaceTextWithFormattingForParticularShapes**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                                                          
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"                           
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                                                        
                                                                                                                                            
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                                              
for (SpreadsheetShape shape : content.getWorksheets().get_Item(0).getShapes())                                                              
{                                                                                                                                           
    if (shape.getText() == "© Aspose 2016")                                                                                                 
    {                                                                                                                                       
        shape.getFormattedTextFragments().clear();                                                                                          
        shape.getFormattedTextFragments().add("© GroupDocs 2017", new Font("Calibri", 19, FontStyle.Bold), Color.getRed(), Color.getAqua());
    }                                                                                                                                       
}                                                                                                                                           
                                                                                                                                            
watermarker.save("spreadsheet.xlsx");                                                                                             
                                                                                                                                            
watermarker.close();                                                                                                                        
```

## Replacing shape image

GroupDocs.Watermark also allows you to replace the [image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setImage(com.groupdocs.watermark.contents.SpreadsheetWatermarkableImage)) of the particular shapes in an Excel Worksheet as shown in the following code sample. This feature is supported since version 17.12.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetReplaceImageOfParticularShapes**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
                                                                                                                 
File file = new File("test.png");                                                                         
byte[] imageBytes = new byte[(int) file.length()];                                                               
FileInputStream inputStream = new FileInputStream(file);                                                         
inputStream.read(imageBytes);                                                                                    
inputStream.close();                                                                                             
                                                                                                                 
for (SpreadsheetShape shape : content.getWorksheets().get_Item(0).getShapes())                                   
{                                                                                                                
    if (shape.getImage() != null)                                                                                
    {                                                                                                            
        shape.setImage(new SpreadsheetWatermarkableImage(imageBytes));                                           
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Setting background image for particular shapes

Since version 17.12, GroupDocs.Watermark enables you to set the [background image](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#getImageFillFormat()) for the particular shapes in an Excel Worksheet. Following code sample shows the usage of this feature.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetSetBackgroundImageForParticularShapes**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
File imageFile = new File("test.png");                                                                    
byte[] imageBytes = new byte[(int) imageFile.length()];                                                          
InputStream imageInputStream = new FileInputStream(imageFile);                                                   
imageInputStream.read(imageBytes);                                                                               
imageInputStream.close();                                                                                        
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
for (SpreadsheetShape shape : content.getWorksheets().get_Item(0).getShapes())                                   
{                                                                                                                
    if (shape.getText() == "© Aspose 2016")                                                                      
    {                                                                                                            
        shape.getImageFillFormat().setBackgroundImage(new SpreadsheetWatermarkableImage(imageBytes));            
        shape.getImageFillFormat().setTransparency(0.5);                                                         
        shape.getImageFillFormat().setTileAsTexture(true);                                                       
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```

## Updating shape properties

Since version 17.12, GroupDocs.Watermark also provides the feature of modifying properties ([setX()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setX(double)), [setY()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setY(double)), [setWidth()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setWidth(double)), [setHeight()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setHeight(double)), [setRotateAngle()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setRotateAngle(double)) or [setAlternativeText()](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.contents/SpreadsheetShape#setAlternativeText(java.lang.String))) of particular shapes in an Excel Worksheet. Following code sample shows how to use this feature.

**advanced\_usage.add\_watermarks\_to\_spreadsheets.SpreadsheetUpdateShapeProperties**

```java
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();                                               
// Specify an absolute or relative path to your document. Ex: "C:\\Docs\\spreadsheet.xlsx"
Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions);                             
                                                                                                                 
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);                                   
for (SpreadsheetShape shape : content.getWorksheets().get_Item(0).getShapes())                                   
{                                                                                                                
    if (shape.getText() == "© Aspose 2019")                                                                      
    {                                                                                                            
        shape.setAlternativeText("watermark");                                                                   
        shape.setRotateAngle(30);                                                                                
        shape.setX(200);                                                                                         
        shape.setY(200);                                                                                         
        shape.setWidth(400);                                                                                     
        shape.setHeight(100);                                                                                    
    }                                                                                                            
}                                                                                                                
                                                                                                                 
watermarker.save("spreadsheet.xlsx");                                                                  
                                                                                                                 
watermarker.close();                                                                                             
```


---

## Sign document with different Text signature implementation

Path: /signature/java/sign-document-with-different-text-signature-implementation/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/TextSignOptions) class with property [SignatureImplementation](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/TextSignOptions#getSignatureImplementation()) of enumeration type [TextSignatureImplementation](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation) to specify various implementations of Text Signatures with following values and its meaning

*   [TextSignatureImplementation.Stamp](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation) - text stamp component (label) on the document page.
*   [TextSignatureImplementation.Annotation](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation) - text annotation with different appearances settings. This implementation depends of document type.
*   [TextSignatureImplementation.Image](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation) - text will be transformed to image and put to document page. This implementation makes sense when there's a need to adjust extended appearances effects that is possible with image adjustment only (like opacity, free rotation, fading, shadows etc).
*   [TextSignatureImplementation.Sticker](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation) - text sticker icon with different appearances settings. This implementation depends of document type.
*   [TextSignatureImplementation.FormField](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation)  - this type is used to update existing Form Fields in the document. For this purpose please user property [FormTextFieldTitle](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/FormTextFieldType) to setup Form Field name and property [FormTextFieldType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/FormTextFieldType) to specify type of Form Field.
*   [TextSignatureImplementation.Watermark](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation) - text watermark along the document page under all document components. This implementation depends of document type.

Here are the steps to add Text signature into document with various text signature implementation types with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/TextSignOptions) object with all required additional options.    
*   set property [SignatureImplementation](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/TextSignOptions#setSignatureImplementation(int)) of [TextSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/TextSignOptions) object with required value from enumeration type [TextSignatureImplementation](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/TextSignatureImplementation).
*   Call [sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class instance and pass initialized [TextSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/TextSignOptions) instance to it. 
*   Analyze [SignResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

## Sign document with Text signature and Stamp implementation type

This example shows how to add Text signature with Stamp signature implementation to document.

```java
Signature signature = new Signature("sample.pdf");
{
    TextSignOptions options = new TextSignOptions("John Smith");
    
        // set alternative signature implementation on document page
    options.setSignatureImplementation(TextSignatureImplementation.Stamp);
        // set alignment
    options.setVerticalAlignment(VerticalAlignment.Top);
    options.setHorizontalAlignment(HorizontalAlignment.Right);
        // set margin with 20 pixels for all sides
    options.setMargin(new Padding(20));
    
    // sign document to file
    SignResult signResult = signature.sign("signed.pdf", options);
    // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for (BaseSignature temp : signResult.getSucceeded())
    {
        System.out.print("Signature #"+number+++": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
                ", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }
}
```

## Sign document with Text signature and Annotation implementation type

This example shows how to add Text signature with Annotation signature implementation to document.

```java
Signature signature = new Signature("sample.pdf");
{
    TextSignOptions options = new TextSignOptions("John Smith");

        // set alternative signature implementation on document page
    options.setSignatureImplementation(TextSignatureImplementation.Annotation);
        // for Pdf document type ther's ability to setup exteneded appearences
    PdfTextAnnotationAppearance appearance =  new PdfTextAnnotationAppearance();
    Border border= new Border();
    border.setColor(Color.BLUE);
    border.setDashStyle(DashStyle.Dash);
    border.setWeight(2);
    appearance.setBorder(border);
    appearance.setBorderEffect(PdfTextAnnotationBorderEffect.Cloudy);
    appearance.setBorderEffectIntensity(2);
    appearance.setHCornerRadius(10);
        // text content of an annotation
    appearance.setContents("Sample");
    appearance.setSubject("Sample subject");
    appearance.setTitle("Sample Title");
    options.setAppearance(appearance);
        // set alignment
    options.setVerticalAlignment(VerticalAlignment.Top);
    options.setHorizontalAlignment(HorizontalAlignment.Right);
        // set margin with 20 pixels for all sides
    options.setMargin(new Padding(20));

        // sign document to file
    SignResult signResult = signature.sign("signed.pdf", options);
        // analyzing result
    // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for (BaseSignature temp : signResult.getSucceeded())
    {
        System.out.print("Signature #"+number+++": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
                ", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }
}
```

## Sign document with Text signature and Image implementation type

This example shows how to add Text signature with Image signature implementation to document.

```java
Signature signature = new Signature("sample.pdf");
{
    TextSignOptions options = new TextSignOptions("John Smith");            
        // set alternative signature implementation on document page
    options.setSignatureImplementation(TextSignatureImplementation.Image);
        // set alignment
    options.setVerticalAlignment(VerticalAlignment.Top);
    options.setHorizontalAlignment(HorizontalAlignment.Right);
        // set margin with 20 pixels for all sides
    options.setMargin(new Padding(20));            
        // sign document to file
    SignResult signResult = signature.sign("signed.pdf", options);
        // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for (BaseSignature temp : signResult.getSucceeded())
    {
        System.out.print("Signature #"+number+++": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
                ", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }
}
```

## Sign document with Text signature and Sticker implementation type

This example shows how to add Text signature with Sticker signature implementation to document.

```java
Signature signature = new Signature("sample.pdf");
{
    TextSignOptions options = new TextSignOptions("John Smith");
    
        // set alternative signature implementation on document page
    options.setSignatureImplementation(TextSignatureImplementation.Sticker);

        // set alignment
    options.setVerticalAlignment(VerticalAlignment.Top);
    options.setHorizontalAlignment(HorizontalAlignment.Right);
        // set margin with 20 pixels for all sides
    options.setMargin(new Padding(20));
    
    // sign document to file
    SignResult signResult = signature.sign("signed.pdf", options);
    // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for (BaseSignature temp : signResult.getSucceeded())
    {
        System.out.print("Signature #"+number+++": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
                ", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }
}
```

## Sign document with Text signature and Form Field implementation type

This example shows how to add Text signature with FormField signature implementation to document.

```java
Signature signature = new Signature("sample.docx");
{
    TextSignOptions ffOptions1 = new TextSignOptions("John Smith");            
        // set alternative signature implementation on document page
    ffOptions1.setSignatureImplementation(TextSignatureImplementation.FormField);
    ffOptions1.setFormTextFieldType(FormTextFieldType.PlainText);
    ffOptions1.setFormTextFieldTitle("UserSignatureFullName");
    
    TextSignOptions ffOptions2 = new TextSignOptions("Document is approved");            
        // set alternative signature implementation on document page
    ffOptions2.setSignatureImplementation(TextSignatureImplementation.FormField);
    ffOptions2.setFormTextFieldType(FormTextFieldType.RichText);
    ffOptions2.setFormTextFieldTitle("UserSignatureComment");
    
    List<SignOptions> listOptions = new ArrayList<SignOptions>();
    listOptions.add(ffOptions1);
    listOptions.add(ffOptions2);
    // sign document to file
    SignResult signResult = signature.sign("signed.docx", listOptions);
    // analyzing result
    System.out.print("List of newly created signatures:");
    int number = 1;
    for (BaseSignature temp : signResult.getSucceeded())
    {
        System.out.print("Signature #"+number+++": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
                ", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with Metadata embedded object

Path: /signature/java/sign-documents-with-metadata-embedded-object/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to embed into Metadata signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption, the class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this encryption expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType)), string value key and string value salt.

Here are the steps to embed into Metadata custom object with standard encryption with GroupDocs.Signature:   

*   Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.
*   Implement if needed custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.  
Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties  like [FormatAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/FormatAttribute) to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/SkipSerializationAttribute)  to mark property of class as not serialize       
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Create one or several objects of [MetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature) object with MetadataSignature[.setValue](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setValue(java.lang.Object)) as object instance. Setup MetadataSignature[.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignature#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) property or use same for [MetadataSignOptions.setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) if all signatures should be encrypted.
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements, add all metadata signatures to its collection and setup if needed [setDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#setDataEncryption(com.groupdocs.signature.domain.extensions.encryption.IDataEncryption)) property    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it.  
    

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.   

```java
public class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Implementation of embedding custom object into Metadata signature

This example shows how to embed custom object into Metadata signature.

```java
 Signature signature = new Signature("sample.docx");
 
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();
 
// set encryption for all metadata signatures for this options
// if you need separate encryption use own MetadataSignature.DataEncryption property
options.setDataEncryption(encryption);
 
// create custom object
DocumentSignatureData documentSignature = new DocumentSignatureData();
documentSignature.setID(java.util.UUID.randomUUID().toString());
documentSignature.setAuthor(System.getenv("USERNAME"));
documentSignature.setSigned(new java.util.Date());
documentSignature.setDataFactor(new java.math.BigDecimal("11.22"));
// setup signature metadata
WordProcessingMetadataSignature mdSignature = new WordProcessingMetadataSignature("Signature", documentSignature);
 
// setup signature metadata
WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
 
// setup data of document id
WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", java.util.UUID.randomUUID().toString());
 
// add signatures to options
options.getSignatures().add(mdSignature);
options.getSignatures().add(mdAuthor);
options.getSignatures().add(mdDocId);
 
// sign document to file
SignResult signResult = signature.sign("MetadataEncryptedObject.docx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with Metadata embedded object

Path: /signature/net/sign-documents-with-metadata-embedded-object/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into Metadata signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption, the class [SymmetricEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricencryption) class. Creation of this encryption expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype) with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/symmetricalgorithmtype)), string value key and string value salt.

Here are the steps to embed into Metadata custom object with standard encryption with GroupDocs.Signature:  

* Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataserializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.
* Implement if needed custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/idataencryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.  
    Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties  like [FormatAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/formatattribute) to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/skipserializationattribute)  to mark property of class as not serialize  
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Create one or several objects of [MetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature) object with [MetadataSignature.Value](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/value) as object instance. Setup [MetadataSignature.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/dataencryption) property or use same for [MetadataSignOptions.DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/dataencryption) if all signatures should be encrypted.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements, add all metadata signatures to its collection and setup if needed [DataEncryption](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignature/dataencryption) property,
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```csharp
public class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }
    [Format("SAuth")]
    public string Author { get; set; }
    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }
    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
    [SkipSerialization]
    public string Comments { get; set; }
}
```

## Implementation of embedding custom object into Metadata signature

This example shows how to embed custom object into Metadata signature.

```csharp
 using (Signature signature = new Signature("sample.docx"))
 {
     // setup key and passphrase
     string key = "1234567890";
     string salt = "1234567890";
     // create data encryption
     IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
     // setup options with text of signature
     MetadataSignOptions options = new MetadataSignOptions()
     {
         // set encryption for all metadata signatures for this options
         // if you need separate encryption use own MetadataSignature.DataEncryption property
         DataEncryption = encryption
     };
     // create custom object
     DocumentSignatureData documentSignatureData = new DocumentSignatureData()
     {
         ID = Guid.NewGuid().ToString(),
         Author = Environment.UserName,
         Signed = DateTime.Now,
         DataFactor = 11.22M
     };
     // setup signature metadata
     WordProcessingMetadataSignature mdSignature = new WordProcessingMetadataSignature("Signature", documentSignatureData);
     // setup signature metadata
     WordProcessingMetadataSignature mdAuthor = new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes");
     // setup data of document id
     WordProcessingMetadataSignature mdDocId = new WordProcessingMetadataSignature("DocumentId", Guid.NewGuid().ToString());
     // add signatures to options
     options.Signatures.Add(mdSignature);
     options.Signatures.Add(mdAuthor);
     options.Signatures.Add(mdDocId);
     // sign document to file
     signature.Sign("MetadataEncryptedObject", options);
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign documents with QR-code embedded object

Path: /signature/java/sign-documents-with-qr-code-embedded-object/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to embed into QR-code signature custom objects. This feature is implemented over object serialization to string and further encryption. By default library uses json format serialization and symmetric encryption, the class [SymmetricEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption) class. Creation of this encryption expects 3 arguments like encryption algorithm enumeration [SymmetricAlgorithmType](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType)with one of following values ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType)), string value key and string value salt.

Here are the steps to embed into QR-code text with standard encryption with GroupDocs.Signature:   

*   Implement if needed custom data serialization class that implement [IDataSerializer](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/IDataSerializer) interface. By default GroupDocs.Signature uses embedded json format serialization but allows user to customize it.
    
*   Implement if needed custom data encryption class that implements [IDataEncryption](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.encryption/IDataEncryption) interface. By default GroupDocs.Signature has several encryption implementation you can use but allows user to customize it.
*   Implement class with properties and specify if needed class attributes (like custom serialization attribute, custom encryption attribute), specify attributes for properties like [FormatAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/FormatAttribute)  to specify serialization name and display format, same as [SkipSerializationAttribute](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions.serialization/SkipSerializationAttribute) to mark property of class as not serialize   
    
*   Create new instance of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) object with [setData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions#setData(java.lang.Object)) value  
*   Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions)  object according to your requirements and custom object to [setData](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions#setData(java.lang.Object)) property.
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) to it.
    

## Definition of class

This example shows how to define custom class with serialization and encryption properties and setup Format attributes for properties.

```java
public class DocumentSignatureData
{
    public String getID(){ return ID; }
    public void setID(String value){ ID = value; }
    @FormatAttribute(propertyName = "SignID")
    public String ID;
 
 
    public final String getAuthor(){ return Author; }
    public final void setAuthor(String value){ Author = value; }
    @FormatAttribute(propertyName = "SAuth")
    public String Author;
    //JAVA-added public wrapper for internalized property accessor
 
    public final java.util.Date getSigned() {  return Signed; }
    public final void setSigned(java.util.Date value) { Signed = value; }
    @FormatAttribute (propertyName = "SDate",propertyFormat = "yyyy-MM-dd")
    public java.util.Date Signed = new java.util.Date();
 
 
    public final java.math.BigDecimal getDataFactor() { return DataFactor; }
    public final void setDataFactor(java.math.BigDecimal value) { DataFactor = value; }
    @FormatAttribute (propertyName = "SDFact",propertyFormat = "N2")
    public java.math.BigDecimal DataFactor = new java.math.BigDecimal(0.01);
}
```

## Implementation of embedding custom object into QR-code signature

This example shows how to embed custom object into QR-code signature.

```java
Signature signature = new Signature("sample.pdf");
// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
 
// create custom object
// create custom object
DocumentSignatureData documentSignature = new DocumentSignatureData();
documentSignature.setID(java.util.UUID.randomUUID().toString());
documentSignature.setAuthor(System.getenv("USERNAME"));
documentSignature.setSigned(new java.util.Date());
documentSignature.setDataFactor(new java.math.BigDecimal("11.22"));
 
// setup QR-Code options
QrCodeSignOptions options = new QrCodeSignOptions();
// set custom object to serialize to QR Code
options.setData(documentSignature);
// QR-code type
options.setEncodeType(QrCodeTypes.QR);
// specify serialization encryption
options.setDataEncryption(encryption);
// locate and aligh signature
options.setHeight(100);
options.setWidth(100);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding() ;
padding.setRight(10);
padding.setBottom(10);
options.setMargin(padding);
 
// sign document to file
SignResult signResult = signature.sign("QrCodeEncryptedObject.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign Pdf documents with custom digital signature appearance

Path: /signature/net/sign-pdf-documents-with-digital-signature-appearance/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) contains classes that implements for Pdf document special signature appearances.

Base signature options [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) contains property [SignOptions.Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) that could be assigned with the instance of following class

* [PdfDigitalSignatureAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/pdfdigitalsignatureappearance) class implements properties to customize digital signature appearance. 

Here are the steps to add digital signature to PDF document and customize signature appearance with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Compose object of [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with all required properties.
* Set  [DigitalSignOptions.Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance) property with instance of [PdfDigitalSignatureAppearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options.appearances/pdfdigitalsignatureappearance) class
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass created [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

## Sign Pdf document with customized appearance of digital signature

This example shows how to add electronic Digital signature to Pdf document with customized appearance.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("sample.pdf"))
{
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // certificate password
        Password = "1234567890",
        // digital certificate details
        Reason = "Approved",
        Location = "New York",

        // apply custom PDF signature appearance
        Appearance = new PdfDigitalSignatureAppearance()
        {
            // do now show contact details
            ContactInfoLabel = string.Empty,
            // simplify reason label
            ReasonLabel = "?",
            // change location label
            LocationLabel = "From",
            DigitalSignedLabel = "By",
            DateSignedAtLabel = "On",
            // apply custom appearance color
            Background = Color.Red
        },
        AllPages = true,
        Width = 160,
        Height = 80,
        // setup signature border
        Border = new Border()
        {
            Visible = true,
            Color = Color.Red,
            DashStyle = DashStyle.DashDot,
            Weight = 2
        }
    };
    SignResult signResult = signature.Sign("signed.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.


---

## Single Row Image in HTML Document

Path: /assembly/java/single-row-image-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in HTML Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Single Row Image in HTML Document

### Reporting Requirement

As a report developer, you are required to represent information of first single manager with the following key requirements:

*   Report must show image of the manager
*   It must show Name and age of manager
*   Report must be generated in the HTML Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table><tbody><tr><td><img height="100" width="100" src="data:image/jpeg;base64,<<[FileUtil.getBytesAsBase64(manager.getPhoto())]>>"></td><td><table><tbody><tr><td><b>Name:</b></td><td><b>&lt;&lt;[manager.getName()]&gt;&gt;</b></td></tr><tr><td><b>Age:</b></td><td>&lt;&lt;[manager.getAge()]&gt;&gt;</td></tr></tbody></table></td></tr></tbody></table>
### Download Single Row Image Template

Please download the sample template we created in this article:

*   [Single Row Image.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Html%20Templates/Single%20Row.html?raw=true)

### Generating The Report

{{< gist GroupDocsGists ea903857e3ebcd9ad615f829caa0feb5 >}}



---

## Single Row Image in HTML Document

Path: /assembly/net/single-row-image-in-html-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in HTML Document format.{{< /alert >}}

## Single Row Image in HTML Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent information of first single customer with the following key requirements:

*   Report must show image of the customer
*   It must show Name and Contact Number of the customer
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
<table>
<tr>
<td>
<img height="100" width="100" src="data:image/jpeg;base64,&lt;&lt;[customer.Photo]&gt;&gt;"/>
</td>
<td>
<table>
<tr>
<td>
<b>Name:</b>
</td>
<td>
<b>&lt;&lt;[customer.CustomerName]&gt;&gt;</b>  
</td>
</tr>
<tr>
<td>
<b>Contact Number:</b>
</td>
<td>
&lt;&lt;[customer.CustomerContactNumber]&gt;&gt;
</td>
</tr>
</table>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Single Row Image Template

Please download the single row image document we created in this article:

*   [Single Row.html](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Text%20Templates/Numbered%20List.txt?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< gist GroupDocsGists 9bbee318cdfc682815c7284ada1d94bf >}}



---

## Skip loading of external resources

Path: /conversion/java/skip-loading-external-resources/

## What are external resources?
*External resources* refer to various types of content or files that are not directly embedded within the document but are instead referenced and loaded from external locations. These resources enhance the functionality, appearance, and interactivity of the document. Common external resources include images, audio, video, fonts, CSS, scripts, frameworks, and so on. **GroupDocs.Conversion** considers external any resource that a document is trying to load from an external URL.

Utilizing external resources optimizes the performance, maintainability, and scalability of web pages and other documents. These resources are typically cached by browsers, which can reduce the load time of subsequent visits to a website. However, relying too heavily on external resources can also introduce dependencies and potential points of failure if the external sources become unavailable.

## Restricting all external resources
While loading [web]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-markup-document-with-options.md" >}}), [presentations]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-presentation-document-with-options.md" >}}) and [word-processing]({{< ref "conversion/java/developer-guide/loading-documents/load-options-for-different-document-types/load-wordprocessing-document-with-options.md" >}}) documents, the [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) allows skipping of loading the external resources.

To restrict the loading of external resources during the conversion, use the `getSkipExternalResources()` boolean property of the respective [WebLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/), [PresentationLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/presentationloadoptions/), or [WordProcessingLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/wordprocessingloadoptions/) class.

The following code snippet shows how to skip loading of external resources while loading an HTML document:

{{< tabs "code-example1">}}
{{< tab "skip_external_resources.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WebLoadOptions;

public static void skipExternalResources()
{
    String outputFile = "skip_external_resources.pdf";

    WebLoadOptions loadOptions =  new WebLoadOptions();
    loadOptions.setSkipExternalResources(true);

    Converter converter = new Converter("groupdocs.html", ()-> loadOptions);

    PdfConvertOptions options = new PdfConvertOptions();
    converter.convert(outputFile, options);
}

public static void main(String[] args){
    skipExternalResources();
}
```
{{< /tab >}}
{{< tab "groupdocs.html" >}}  
{{< tab-text >}}
`groupdocs.html` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/skip-loading-external-resources/groupdocs.html) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "skip_external_resources.pdf" >}}  
{{< tab-text >}}
`skip_external_resources.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/skip-loading-external-resources/skip_external_resources.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Allowlisting some of the external resources
Sometimes you may want to skip loading most of the external resources, but still load some particular resources.
To allow-list specific resources during the conversion, use the `WhitelistedResources` property of the respective [WebLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/webloadoptions/), [PresentationLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/presentationloadoptions/), or [WordProcessingLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/wordprocessingloadoptions/) class. The property is effective when the `SkipExternalResources` property is enabled. The `WhitelistedResources` property accepts the string list containing the portions of URLs to be loaded while restricting the loading of other external resources. 

The following code snippet shows how to load the JPG and JPEG images and any resources from the `example.com` domain while restricting any other external resources:

{{< tabs "code-example2">}}
{{< tab "whitelisted_resources.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WebLoadOptions;

public static void setWhitelistedResources()
{
    String outputFile = "whitelisted_resources.pdf";

    WebLoadOptions loadOptions =  new WebLoadOptions();
    loadOptions.setSkipExternalResources(true);
    loadOptions.setWhitelistedResources(Arrays.asList( "jpeg", "via.placeholder.com" ));

    Converter converter = new Converter("groupdocs.html", ()-> loadOptions);

    PdfConvertOptions options = new PdfConvertOptions();
    converter.convert(outputFile, options);
}

public static void main(String[] args){
    setWhitelistedResources();
}
```
{{< /tab >}}
{{< tab "groupdocs.html" >}}  
{{< tab-text >}}
`groupdocs.html` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/skip-loading-external-resources/groupdocs.html) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "whitelisted_resources.pdf" >}}  
{{< tab-text >}}
`whitelisted_resources.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/skip-loading-external-resources/whitelisted_resources.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Skip loading of external resources

Path: /conversion/net/skip-loading-external-resources/


## What are external resources?

*External resources* refer to various types of content or files that are not directly embedded within the document but are instead referenced and loaded from external locations. These resources enhance the functionality, appearance, and interactivity of the document. Common external resources include images, audio, video, fonts, CSS, scripts, frameworks, and so on. **GroupDocs.Conversion** considers external any resource that a document is trying to load from an external URL.

Utilizing external resources optimizes the performance, maintainability, and scalability of web pages and other documents. These resources are typically cached by browsers, which can reduce the load time of subsequent visits to a website. However, relying too heavily on external resources can also introduce dependencies and potential points of failure if the external sources become unavailable.

## Security considerations

Loading external resources from untrusted documents can pose security risks:

* **Server-Side Request Forgery (SSRF)**: A malicious document could contain references to internal network resources, potentially allowing attackers to probe or access internal services.
* **NTLM credential leaks**: Documents with UNC paths (e.g., `\\server\share`) could trigger automatic NTLM authentication, potentially leaking credentials.
* **Data exfiltration**: External resources could be used to track document access or exfiltrate data.

To mitigate these risks, [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) implements a **secure by default** approach - the `SkipExternalResources` property is set to `true` by default in all supporting load options classes.

## Supported document types

The external resource loading control is available for the following document types:

| Document Type | LoadOptions Class |
|---------------|-------------------|
| Web/HTML | [WebLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions) |
| Word Processing | [WordProcessingLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions) |
| Presentations | [PresentationLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions) |
| Spreadsheets | [SpreadsheetLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions) |
| Email | [EmailLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/emailloadoptions) |
| SVG | [SvgLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/svgloadoptions) |

All these classes implement the [IResourceLoadingOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/iresourceloadingoptions) interface, which defines the `SkipExternalResources` and `WhitelistedResources` properties.

## Restricting external resources

By default, `SkipExternalResources` is set to `true`, which means external resources are already blocked. If you have previously enabled external resource loading and want to restrict it again, set the `SkipExternalResources` property to `true`.

The following code snippets show how to skip loading of external resources for different document types:

### Web/HTML documents

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new WebLoadOptions
{
    SkipExternalResources = true
};
using (var converter = new Converter("sample.html", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Word processing documents

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new WordProcessingLoadOptions
{
    SkipExternalResources = true
};
using (var converter = new Converter("sample.docx", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Presentation documents

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new PresentationLoadOptions
{
    SkipExternalResources = true
};
using (var converter = new Converter("sample.pptx", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Spreadsheet documents

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new SpreadsheetLoadOptions
{
    SkipExternalResources = true
};
using (var converter = new Converter("sample.xlsx", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Email documents

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new EmailLoadOptions
{
    SkipExternalResources = true
};
using (var converter = new Converter("sample.eml", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### SVG documents

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new SvgLoadOptions
{
    SkipExternalResources = true
};
using (var converter = new Converter("sample.svg", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Allowlisting specific external resources

Sometimes you may want to skip loading most of the external resources, but still load some particular resources from trusted sources.

To allow-list specific resources during the conversion, use the `WhitelistedResources` property. This property accepts a list of strings containing portions of URLs to be allowed. The `WhitelistedResources` property is effective only when the `SkipExternalResources` property is set to `true`.

The following code snippet shows how to load JPG and JPEG images and any resources from the `example.com` domain while restricting all other external resources:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new WebLoadOptions
{
    SkipExternalResources = true,
    WhitelistedResources = new List<string> { "jpg", "jpeg", "example.com" }
};
using (var converter = new Converter("sample.html", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

The same approach works for all supported document types. For example, to allow specific resources when converting an email document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new EmailLoadOptions
{
    SkipExternalResources = true,
    WhitelistedResources = new List<string> { "trusted-domain.com", ".png", ".jpeg" }
};
using (var converter = new Converter("newsletter.eml", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

Resources matching any entry in the whitelist will be loaded normally, while all other external resources will be skipped.

## Enabling external resources loading

If you need to load all external resources (not recommended for untrusted documents), set `SkipExternalResources` to `false`:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

var loadOptions = new WebLoadOptions
{
    SkipExternalResources = false
};
using (var converter = new Converter("trusted-document.html", (LoadContext loadContext) => loadOptions))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

---

## Specify encoding when loading documents

Path: /viewer/java/specify-encoding-when-loading-documents/


This feature is supported for the following file types:

* [Plain-text (.txt) files](https://docs.fileformat.com/word-processing/txt/)
* [Comma-separated values (.csv)](https://docs.fileformat.com/spreadsheet/csv/)
* [Tab-separated values (.tsv)](https://docs.fileformat.com/spreadsheet/tsv/)
* [E-Mail Message (.eml)](https://docs.fileformat.com/email/eml/)

Different encodings use different byte sequences for characters, and opening a file in the wrong encoding leads to incorrect character rendering. To properly render a file, the correct encoding must be specified when opening the file. Another option is converting it to `UTF-8` beforehand. By default GroupDocs.Viewer using `UTF-8` encoding.

For examle, when you try to open [sample-shift-jis.txt](/viewer/java/sample-files/developer-guide/loading-documents/specify-encoding-when-loading-documents/sample-shift-jis.txt) file in Notepad the text `これはShift_JISエンコード用のサンプルテキストです。` will appear as strange symbols because `ANSI` is misinterpreting the byte values that are specific to `Shift_JIS`.

![Shift_Jis text file opened in Notepad](/viewer/java/images/developer-guide/loading-documents/specify-encoding-when-loading-documents/shift-jis-in-notepad.png)

To render text file properly you can set charset using `LoadOptions` class. In the following code snippet we'll set `Shift_JIS` charset and render the text file to HTML:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.LoadOptions;

import java.nio.charset.Charset;

// ...

// Specify charset.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setCharset(Charset.forName("Shift_JIS"));

// Render a file.
try (Viewer viewer = new Viewer("sample-shift-jis.txt", loadOptions)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "sample-shift-jis.txt" >}}
{{< tab-text >}}
`sample-shift-jis.txt` is sample TXT file that is used in this example. Click [here](/viewer/java/sample-files/developer-guide/loading-documents/specify-encoding-when-loading-documents/sample-shift-jis.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Shift_Jis text file converted to HTML](/viewer/java/images/developer-guide/loading-documents/specify-encoding-when-loading-documents/shift-jis-converted-to-html.png)


---

## Specify encoding when loading documents

Path: /viewer/net/specify-encoding-when-loading-documents/


This feature is supported for the following file types:

* [Plain-text (.txt) files](https://docs.fileformat.com/word-processing/txt/)
* [Comma-separated values (.csv)](https://docs.fileformat.com/spreadsheet/csv/)
* [Tab-separated values (.tsv)](https://docs.fileformat.com/spreadsheet/tsv/)
* [E-Mail Message (.eml)](https://docs.fileformat.com/email/eml/)

Different encodings use different byte sequences for characters, and opening a file in the wrong encoding leads to incorrect character rendering. To properly render a file, the correct encoding must be specified when opening the file. Another option is converting it to `UTF-8` beforehand. By default GroupDocs.Viewer using `UTF-8` encoding.

For examle, when you try to open [sample-shift-jis.txt](/viewer/net/sample-files/developer-guide/loading-documents/specify-encoding-when-loading-documents/sample-shift-jis.txt) file in Notepad the text `これはShift_JISエンコード用のサンプルテキストです。` will appear as strange symbols because `ANSI` is misinterpreting the byte values that are specific to `Shift_JIS`.

![Shift_Jis text file opened in Notepad](/viewer/net/images/developer-guide/loading-documents/specify-encoding-when-loading-documents/shift-jis-in-notepad.png)

To render text file properly you can set encoding using `LoadOptions` class. In the following code snippet we'll set `Shift_JIS` encoding and render the text file to HTML:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.Text;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Specify an encoding.
LoadOptions loadOptions = new LoadOptions();
loadOptions.Encoding = Encoding.GetEncoding("shift_jis");
// Render a file.
using (Viewer viewer = new Viewer("sample-shift-jis.txt", loadOptions))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.Text
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Specify an encoding.
        Dim loadOptions As LoadOptions = New LoadOptions()
        loadOptions.Encoding = Encoding.GetEncoding("shift_jis")
        ' Render a file.
        Using viewer As Viewer = New Viewer("sample-shift-jis.txt", loadOptions)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< tab "sample-shift-jis.txt" >}}
{{< tab-text >}}
`sample-shift-jis.txt` is sample TXT file that is used in this example. Click [here](/viewer/net/sample-files/developer-guide/loading-documents/specify-encoding-when-loading-documents/sample-shift-jis.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Shift_Jis text file converted to HTML](/viewer/net/images/developer-guide/loading-documents/specify-encoding-when-loading-documents/shift-jis-converted-to-html.png)

---

## Split document

Path: /merger/net/split-document/

**GroupDocs.Merger** allows to split source document into several resultant documents. Document splitting can be performed in different ways by specifying page numbers array or start/end page numbers and setting different [SplitOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitoptions) modes.  
Here are the possible use cases:

1.  **Page numbers array** specified and splitting mode is set to [SplitMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitmode).Pages - specified page numbers indicate exact page numbers, which will be saved to the separate one-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 3 documents with 3rd, 6th and 8th pages.
    
2.  **Page numbers array** specified and splitting mode is set to [SplitMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitmode).Interval  - specified page numbers indicate the boundaries of the page intervals, which will be saved to the separate multi-page documents.  
    *Ex:* Array{ 3, 6, 8 } will produce 4 page intervals 1-2, 3-5, 6-7, 8-10.    

There is also an ability to set parameter [RangeMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/rangemode) and obtain only even or odd pages from desired pages range.  
  
The steps to split document to multiple on-page documents are the following:

*   Initialize [SplitOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitoptions) class with output files path format;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [Split](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/split) method and pass [SplitOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/splitoptions) object for saving resultant documents.

## Split the document to several one-page documents (by exact page numbers)

The following code sample demonstrates how to split document to three one-page documents with 3rd, 6th and 8th pages:

```csharp
string filePath = @"c:\sample.docx";
string filePathOut = @"c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, new int[] { 3, 6, 8 });
           
using (Merger merger = new Merger(filePath))
{
     merger.Split(splitOptions);
}  
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_3 | 3 |
| document_6 | 6 |
| document_8 | 8 |

## Split the document to several one-page documents (by start/end page numbers)

The following code sample demonstrates how to split document to several one-page documents starting from 3rd and ending at 7th page number:

```csharp
string filePath = @"c:\sample.docx";
string filePathOut = @"c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, 3, 7);
           
using (Merger merger = new Merger(filePath))
{
     merger.Split(splitOptions);
}  
```

This code snippet will produce:

| Document name | Page numbers |
| --- | --- |
| document_3 | 3 |
| document_4 | 4 |
| document_5 | 5 |
| document_6 | 6 |
| document_7 | 7 |

## Split the document to several one-page documents (by start/end page numbers and even/odd filter)

The following code sample demonstrates how to split document to several one-page documents for odd pages starting from 3rd and ending at 7th page number:

```csharp
string filePath = @"c:\sample.docx";
string filePathOut = @"c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, 3, 7, RangeMode.OddPages);
           
using (Merger merger = new Merger(filePath))
{
     merger.Split(splitOptions);
}  
 
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_3 | 3 |
| document_5 | 5 |
| document_7 | 7 |

## Split the document to several multi-page documents

The following code sample demonstrates how to split document to several multi-page documents:

```csharp
string filePath = @"c:\sample.docx";
string filePathOut = @"c:\output\document_{0}.{1}";

SplitOptions splitOptions = new SplitOptions(filePathOut, new int[] { 3, 6, 8 }, SplitMode.Interval);
           
using (Merger merger = new Merger(filePath))
{
     merger.Split(splitOptions);
}  
```

This code snippet will  produce:

| Document name | Page numbers |
| --- | --- |
| document_0 | 1, 2 |
| document_1 | 3, 4, 5 |
| document_2 | 6, 7 |
| document_3 | 8, 9, 10 |

---

## Split text file

Path: /merger/java/split-text-file/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to split text file into several resultant text files. The default behavior is to split each line into separate file.  
Here are the steps on how to split text file as described:

*   Initialize [TextSplitOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/TextSplitOptions) class with output files path format, desired [TextSplitMode](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/TextSplitMode) and line numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [split](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#split(com.groupdocs.merger.domain.options.interfaces.ITextSplitOptions)) method and pass [TextSplitOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/TextSplitOptions) object to itfor saving resultant text files.

### Split text file to several one-line files (by exact line numbers)

The following code sample demonstrates how to split text file to two one-page documents with 3rd, 6th lines from source file:

```java
String filePath = "c:\sample.txt";
String filePathOut = "c:\output\line_{0}.{1}";

TextSplitOptions splitOptions = new TextSplitOptions(filePathOut, new int[] { 3, 6 });

Merger merger = new Merger(filePath);
merger.split(splitOptions);
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| line_0 | 3 |
| line_1 | 6 |

### Split text file to several multi-line files 

The following code sample demonstrates how to split text file to several multi-line files starting from 3rd and ending at 6th line numbers:

```java
String filePath = "c:\sample.txt";
String filePathOut = "c:\output\text_{0}.{1}";

TextSplitOptions splitOptions = new TextSplitOptions(filePathOut, TextSplitMode.Interval, new int[] { 3, 6 });

Merger merger = new Merger(filePath);
merger.split(splitOptions);
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| text_0 | 1, 2 |
| text_1 | 3, 4, 5 |
| text_2 | 6 |


---

## Split text file

Path: /merger/nodejs-java/split-text-file/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to split text file into several resultant text files. The default behavior is to split each line into separate file.  
Here are the steps on how to split text file as described:

*   Initialize [TextSplitOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/TextSplitOptions) class with output files path format, desired [TextSplitMode](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/TextSplitMode) and line numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [split](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#split(com.groupdocs.merger.domain.options.interfaces.ITextSplitOptions)) method and pass [TextSplitOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/TextSplitOptions) object to itfor saving resultant text files.

### Split text file to several one-line files (by exact line numbers)

The following code sample demonstrates how to split text file to two one-page documents with 3rd, 6th lines from source file:

```js
const inputFilePath = `c:/sample.txt`;
const merger = new groupdocs.merger.Merger(inputFilePath)
const outputPath = `c:/output/text_{0}.{1}`;
const java = require('java');
const lineArray = java.newArray('int', [3, 6]);
const textSplitOptions = new groupdocs.merger.TextSplitOptions(outputPath, lineArray);
merger.split(textSplitOptions);
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| line_0 | 3 |
| line_1 | 6 |

### Split text file to several multi-line files 

The following code sample demonstrates how to split text file to several multi-line files starting from 3rd and ending at 6th line numbers:

```js
const inputFilePath = `c:/sample.txt`;
const merger = new groupdocs.merger.Merger(inputFilePath)
const outputPath = `c:/output/text_{0}.{1}`;
const textSplitMode = groupdocs.merger.TextSplitMode.Interval;
const java = require('java');
const lineArray = java.newArray('int', [3, 6]);
const textSplitOptions = new groupdocs.merger.TextSplitOptions(outputPath, textSplitMode, lineArray);
merger.split(textSplitOptions);
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| text_0 | 1, 2 |
| text_1 | 3, 4, 5 |
| text_2 | 6 |


---

## Split text file

Path: /merger/python-net/split-text-file/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to split text file into several resultant text files. The default behavior is to split each line into separate file.  
Here are the steps on how to split text file as described:

*   Initialize [TextSplitOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/TextSplitOptions) class with output files path format, desired [TextSplitMode](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/TextSplitMode) and line numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/net/merger/groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [split](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/split/) method and pass [TextSplitOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/TextSplitOptions) object to itfor saving resultant text files.

### Split text file to several one-line files (by exact line numbers)

The following code sample demonstrates how to split text file to two one-page documents with 3rd, 6th lines from source file:

```python
with gm.Merger("c:/sample.txt") as merger:
    output_path = "c:/output/text_{0}.{1}"
    split_options = gm.domain.options.TextSplitOptions(output_path, [3, 6])
    merger.split(split_options)
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| line_0 | 3 |
| line_1 | 6 |

### Split text file to several multi-line files 

The following code sample demonstrates how to split text file to several multi-line files starting from 3rd and ending at 6th line numbers:

```python
with gm.Merger("c:/sample.txt") as merger:
    output_path = "c:/output/text_{0}.{1}"
    split_mode = groupdocs.merger.TextSplitMode.INTERVAL;
    split_options = gm.domain.options.TextSplitOptions(output_path, split_mode, [3, 6])
    merger.split(split_options)
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| text_0 | 1, 2 |
| text_1 | 3, 4, 5 |
| text_2 | 6 |


---

## Save signed Spreadsheet with different output file type

Path: /signature/java/save-signed-spreadsheet-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports saving of Spreadsheet signed documents with different output file types. Each document type has list of compatible saving type. These values are listed in enum [SpreadsheetSaveFileFormat.](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/SpreadsheetSaveFileFormat)

Here are the steps to save signed Spreadsheet document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java):

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate required signature options.    
*   Instantiate the [SpreadsheetSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SpreadsheetSaveOptions) object according to your requirements and specify [setFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SpreadsheetSaveOptions#setFileFormat(int)) as one of predefined values from [SpreadsheetSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/SpreadsheetSaveFileFormat).
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signatureoptions and [SpreadsheetSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/SpreadsheetSaveOptions) object to it.
    

Following example demonstrates how to save signed Spreadsheet document with different output type

```java
Signature signature = new Signature("sample.xlsx");
// create QRCode option with predefined QRCode text
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
SpreadsheetSaveOptions saveOptions = new SpreadsheetSaveOptions();
saveOptions.setFileFormat(SpreadsheetSaveFileFormat.Pdf);
saveOptions.setOverwriteExistingFiles(true);
// sign document to file
signature.sign("SignedXlsx.pdf", signOptions, saveOptions);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Save signed Spreadsheet with different output file type

Path: /signature/net/save-signed-spreadsheet-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving of Spreadsheet signed documents with different output file types. Each document type has list of compatible saving type. These values are listed in enum [SpreadsheetSaveFileFormat.](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/spreadsheetsavefileformat)

Here are the steps to save signed Spreadsheet document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the [SpreadsheetSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/spreadsheetsaveoptions) object according to your requirements and specify [FileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/spreadsheetsaveoptions/fileformat) as one of predefined values from [SpreadsheetSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/spreadsheetsavefileformat).  

* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signatureoptions and [SpreadsheetSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/spreadsheetsaveoptions) object to it.

Following example demonstrates how to save signed Spreadsheet document with different output type

```csharp
using (Signature signature = new Signature("sample.xlsx"))
{
    // create QRCode option with predefined QRCode text
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        // setup QRCode encoding type
        EncodeType = QRCodeTypes.QR,
        // set signature position
        Left = 100,
        Top = 100
    };
    SpreadsheetSaveOptions saveOptions = new SpreadsheetSaveOptions()
    {
        FileFormat = SpreadsheetSaveFileFormat.Pdf,
        OverwriteExistingFiles = true
    };
    // sign document to file
    signature.Sign("SignedXlsx.pdf", signOptions, saveOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Subscribing for search process events

Path: /signature/java/subscribing-for-search-process-events/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class contains several events that are being called for different search process stages

*   [SearchStarted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SearchStarted) to handle process start event. This event is occur once [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method is called
*   [SearchProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SearchProgress) to handle progress event. This event occurs each time on searching each document page.
*   [SearchCompleted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SearchCompleted) to handle completion event. This event occurs once [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions))process was completed.    

Here are the steps to subscribe for searching process with GroupDocs.Signature:

*   Define required handler delegates to process searching events.    
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Subscribe for required events      
*   Instantiate required [SearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions) object       
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass search options in it.
    

## Implement method for SearchStarted event

GroupDocs.Signature expects [ProcessStartEventHandler](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.handler.events/ProcessStartEventHandler) delegate to subscribe for [SearchStarted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SearchStarted) event

```java
private static void onSearchStarted(Signature sender, ProcessStartEventArgs args)
{
    System.out.print("Search process started at "+args.getStarted()+" with "+args.getTotalSignatures()+" total signatures to be put in document");
}
```

## Implement method for SearchProgress event

```java
 private static void onSearchProgress(Signature sender, ProcessProgressEventArgs args)
{
    System.out.print("Search progress. Processed "+args.getProcessedSignatures()+" signatures. Time spent "+args.getTicks()+" mlsec");
}
```

## Implement method for SearchCompleted event

```java
private static void onSearchCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    System.out.print("Search process completed at "+args.getCompleted()+" with "+args.getTotalSignatures()+" total signatures. Process took "+args.getTicks()+" mlsec");
}
```

## Subscribing for search process events

```java
private static void onSearchStarted(Signature sender, ProcessStartEventArgs args)
{
    System.out.print("Search process started at "+args.getStarted()+" with "+args.getTotalSignatures()+" total signatures to be put in document");
}
 
private static void onSearchProgress(Signature sender, ProcessProgressEventArgs args)
{
    System.out.print("Search progress. Processed "+args.getProcessedSignatures()+" signatures. Time spent "+args.getTicks()+" mlsec");
}
 
private static void onSearchCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    System.out.print("Search process completed at "+args.getCompleted()+" with "+args.getTotalSignatures()+" total signatures. Process took "+args.getTicks()+" mlsec");
}
 
public static void run()
{
    // The path to the documents directory.
    String filePath = Constants.SAMPLE_PDF;
 
    try {
        Signature signature = new Signature(filePath);
        signature.SearchStarted.add(new ProcessStartEventHandler() {
            public void invoke(Signature sender, ProcessStartEventArgs args) {
                onSearchStarted(sender, args);
            }
        });
 
 
        signature.SearchProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                onSearchProgress(sender, args);
            }
 
 
        });
        signature.SearchCompleted.add(new ProcessCompleteEventHandler() {
            public void invoke(Signature  sender, ProcessCompleteEventArgs args) {
                onSearchCompleted(sender, args);
            }
        });
 
        BarcodeSearchOptions options = new BarcodeSearchOptions();
 
        // specify special pages to search on
        options.setAllPages(false);   
 
        // search for signatures in document
        List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class,options);
        System.out.print("\nSource document contains following signatures.");
        for (BarcodeSignature barcodeSignature : signatures)
        {
            System.out.print("Barcode signature found at page "+barcodeSignature.getPageNumber()+" with type "+barcodeSignature.getEncodeType()+" and text " + barcodeSignature.getText());
        }
    } catch (Exception e) {
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Subscribing for search process events

Path: /signature/net/subscribing-for-search-process-events/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class contains several events that are being called for different search process stages

* [SearchStarted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/searchstarted) to handle process start event. This event is occur once [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method is called
* [SearchProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/searchprogress) to handle progress event. This event occurs each time on searching each document page.
* [SearchCompleted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/searchcompleted) to handle completion event. This event occurs once [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) process was completed.

Here are the steps to subscribe for searching process with GroupDocs.Signature:

* Define required handler delegates to process searching events.
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Subscribe for required events.
* Instantiate required [SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) object.
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass search options in it.

## Implement method for SearchStarted event

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) expects ProcessStartEventHandler delegate to subscribe for SearchStarted event

```csharp
private static void OnSearchStarted(Signature signature, ProcessStartEventArgs args)
{
    Console.WriteLine("Search process started at {0} with {1} total signatures to be put in document", args.Started, args.TotalSignatures);
}
```

## Implement method for SearchProgress event

```csharp
 private static void OnSearchProgress(Signature signature, ProcessProgressEventArgs args)
 {
     Console.WriteLine("Search progress. Processed {0} signatures. Time spent {1} mlsec", args.ProcessedSignatures, args.Ticks);
 }
```

## Implement method for SearchCompleted event

```csharp
private static void OnSearchCompleted(Signature signature, ProcessCompleteEventArgs args)
{
    Console.WriteLine("Search process completed at {0} with {1} total signatures. Process took {2} mlsec", args.Completed, args.TotalSignatures, args.Ticks);
}
```

## Subscribing for search process events

```csharp
private static void OnSearchStarted(Signature sender, ProcessStartEventArgs args)
{
    Console.WriteLine("Search process started at {0} with {1} total signatures to be put in document", args.Started, args.TotalSignatures);
}

private static void OnSearchProgress(Signature sender, ProcessProgressEventArgs args)
{
    Console.WriteLine("Search progress. Processed {0} signatures. Time spent {1} mlsec", args.ProcessedSignatures, args.Ticks);
}

private static void OnSearchCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    Console.WriteLine("Search process completed at {0} with {1} total signatures. Process took {2} mlsec", args.Completed, args.TotalSignatures, args.Ticks);
}

public static void Run()
{
    using (Signature signature = new Signature("SignedSample.pdf"))
    {
        signature.SearchStarted += OnSearchStarted;
        signature.SearchProgress += OnSearchProgress;
        signature.SearchCompleted += OnSearchCompleted;
        BarcodeSearchOptions options = new BarcodeSearchOptions()
        {
            // specify special pages to search on
            AllPages = true
        };
        // search for signatures in document
        List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
        Console.WriteLine("\nSource document contains following signatures.");
        foreach (var barcodeSignature in signatures)
        {
            Console.WriteLine("Barcode signature found at page {0} with type {1} and text {2}",
                  barcodeSignature.PageNumber, barcodeSignature.EncodeType, barcodeSignature.Text);
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Supported cross-merging Document Types

Path: /merger/net/supported-cross-merging-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Cross-format merge inside family | Cross-format merge to PDF / XPS | Cross-format merge to DOC / DOCX |
| --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Open XML Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Word Open XML Macro-Enabled Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Word Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Word Open XML Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Word Open XML Macro-Enabled Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File |   | ![(tick)](/merger/net/images/check.png) |   |
| [MHT](https://docs.fileformat.com/web/mhtml/) | MHTML Web Archive |   |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML |   |   |   |
| [PDF](https://docs.fileformat.com/view/pdf/) | Portable Document Format File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | XML Paper Specification File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File  |   |   |   |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel Template File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Excel Open XML Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Excel Open XML Macro-Enabled Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Open XML Macro-Enabled Add-in | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio Drawing File | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Microsoft Visio Macro-Enabled Drawing | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Microsoft Visio Stencil | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Microsoft Visio Macro-Enabled Stencil | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Microsoft Visio Template | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Microsoft Visio Macro-Enabled Template | ![(tick)](/merger/net/images/check.png) |   |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil | ![(tick)](/merger/net/images/check.png) |   |   |
| [VTX](https://docs.fileformat.com/image/vtx/) | Microsoft Visio 2003-2010 XML Template | ![(tick)](/merger/net/images/check.png) |   |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote |   |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text File | ![(tick)](/merger/net/images/check.png) |   |   |
| [ERR](https://docs.fileformat.com/misc/err/) | Error Log File | ![(tick)](/merger/net/images/check.png) |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ![(tick)](/merger/net/images/check.png) |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File | ![(tick)](/merger/net/images/check.png) |   |   |
| [JPG](https://docs.fileformat.com/image/jpeg/) | JPG Image File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [JPEG](https://docs.fileformat.com/image/jpeg/) | JPEG Image File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [TIF](https://docs.fileformat.com/image/tiff/) | Tagged Image Format |   | ![(tick)](/merger/net/images/check.png) |   |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format |   | ![(tick)](/merger/net/images/check.png) |   |
| [SVG](https://docs.fileformat.com/image/svg/) | Scalar Vector Graphics | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [SVGZ](https://docs.fileformat.com/image/svgz/) | Compressed Scalar Vector Graphics | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ZIP](https://docs.fileformat.com/compression/zip/) | ZIP Archive File | ![(tick)](/merger/net/images/check.png) |   |   |
| [TAR](https://docs.fileformat.com/compression/tar/) | TAR Archive File | ![(tick)](/merger/net/images/check.png) |   |   |
| [RAR](https://docs.fileformat.com/compression/rar/) | RAR Archive File |   |   |   |
| [7Z](https://docs.fileformat.com/compression/7z/) | 7Z Archive File | ![(tick)](/merger/net/images/check.png) |   |   |
| [GZ](https://docs.fileformat.com/compression/gz/) | GZ Archive File |   |   |   |
| [BZ2](https://docs.fileformat.com/compression/bz2/) | BZ2 Archive File |   |   |   |

---

## Supported file formats

Path: /viewer/python-net/supported-document-formats/


{{< alert style="tip" >}}

Need to view files online? Try the [GroupDocs.Viewer App](https://products.groupdocs.app/viewer/total) to open DOCX, XLSX, PPTX, and more.

{{< /alert >}}

This topic lists file formats supported by GroupDocs.Viewer for Python. You can use the input below to filter supported formats by extension.

{{< table-filter placeholder="Start typing to find file format" >}}

## Archive and compression file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [7Z](https://docs.fileformat.com/compression/7z/) | 7-Zip Compressed File | ![(tick)](/viewer/net/images/check-blue.png) |
| [BZ2](https://docs.fileformat.com/compression/bz2) | Bzip2 Compressed File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [GZ](https://docs.fileformat.com/compression/gz) | Gnu Zipped Archive | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [RAR](https://docs.fileformat.com/compression/rar) | WinRAR Compressed Archive | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [TAR](https://docs.fileformat.com/compression/tar) | Consolidated Unix File Archive | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [TGZ](https://docs.fileformat.com/compression/tgz/) | Gzipped Tar File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [TXZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Tar Archive | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [XZ](https://docs.fileformat.com/compression/xz/) | XZ Compressed Archive | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [ZIP](https://docs.fileformat.com/compression/zip) | Zipped File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [Zstandard](https://docs.fileformat.com/compression/zst) | Zstandard Archive | ![(tick)](/viewer/net/images/check-blue.png) |
| [ISO](https://docs.fileformat.com/compression/iso) | Optical Disk Image | ![(tick)](/viewer/net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view archive files: [Render archives as HTML, PDF, and image files](/viewer/python-net/render-archive-files).

## CAD and 3D file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CF2](https://docs.fileformat.com/cad/cf2/) | Common File Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DGN](https://docs.fileformat.com/cad/dgn) | MicroStation Design File (V7) | ![(tick)](/viewer/python-net/images/check-blue.png) | DGN V8 is not supported <br> as DGN V8 file format <br> is proprietary. |
| [DWF](https://docs.fileformat.com/cad/dwf/) | Design Web Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DWG](https://docs.fileformat.com/cad/dwg/) | AutoCAD Drawing | ![(tick)](/viewer/python-net/images/check-blue.png) | Supported formats: <br> Release 11, 12, 13, 14. <br> DWG 2000, 2000i, 2002. <br> DWG 2004, 2005, 2006. <br> DWG 2010, 2011, 2012. <br> DWG 2013, 2014, 2015, 2016. |
| [DWT](https://docs.fileformat.com/cad/dwt/) | AutoCAD Drawing Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DXF](https://docs.fileformat.com/cad/dxf/) | Drawing Exchange Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [HPG](https://docs.fileformat.com/cad/hpgl/) | HPGL (Hewlett-Packard Graphics Language) Plot File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [IFC](https://docs.fileformat.com/cad/ifc/) | Industry Foundation Classes | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [IGS](https://docs.fileformat.com/cad/igs/) | IGES (Initial Graphics Exchange Specification) Drawing | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [OBJ](https://docs.fileformat.com/3d/obj/) | Wavefront 3D Object File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PLT](https://docs.fileformat.com/cad/plt/) | AutoCAD Plotter Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [STL](https://docs.fileformat.com/cad/stl/) | Stereolithography File | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view CAD files: [Render CAD drawings and models as HTML, PDF, and image files](/viewer/python-net/render-cad-drawings-and-models).

## Database file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: |
| [NSF](https://docs.fileformat.com/database/nsf/) | Lotus Notes Database File | ![(tick)](/viewer/python-net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view NSF files: [Render Lotus Notes database files as HTML, PDF, and image files](/viewer/python-net/render-lotus-notes-database-files/).

## EBook file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open EBook Format | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [MOBI](https://docs.fileformat.com/ebook/mobi/) | Mobipocket EBook | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [AZW3](https://docs.fileformat.com/ebook/azw3/) | AZ3/KF8 EBook Format| ![(tick)](/viewer/net/images/check-blue.png) |


## Email file formats

| Format | Description | Automatic format detection | 
| --- | --- | :---: | 
| [EML](https://docs.fileformat.com/email/eml/) | Email Message | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [EMLX](https://docs.fileformat.com/email/emlx/) | Apple Mail Message | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [MBOX](https://docs.fileformat.com/email/mbox/) | Email Mailbox File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [MSG](https://docs.fileformat.com/email/msg/) | Outlook Message Item File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [VCARD / VCF](https://docs.fileformat.com/email/vcf/) | vCard (Virtual Contact) File | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view email messages: [Render email messages as HTML, PDF, PNG, and JPEG files](/viewer/python-net/render-email-messages/).

## Image file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [AI](https://docs.fileformat.com/image/ai/) | Adobe Illustrator Artwork | ![(tick)](/viewer/python-net/images/check-blue.png) | Supported versions: 2, 3, 8 |
| [APNG](https://docs.fileformat.com/image/apng/) | Animated Portable Network Graphic | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [CDR](https://docs.fileformat.com/image/cdr/) | CorelDRAW Image File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [CGM](https://docs.fileformat.com/page-description-language/cgm/) | Computer Graphics Metafile | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [CMX](https://docs.fileformat.com/image/cmx/) | Corel Presentation Exchange Image | ![(tick)](/viewer/python-net/images/check-blue.png) |  Supported version: 2.0 with 32-bit precision (16-bit precision is partially supported). |
| [DCM](https://docs.fileformat.com/image/dcm/) | DICOM (Digital Imaging and Communications in Medicine) Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DIB](https://docs.fileformat.com/image/dib/) | Device Independent Bitmap File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DJVU](https://docs.fileformat.com/image/djvu/) | DjVu Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DNG](https://docs.fileformat.com/image/dng/) | Digital Negative Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [EMF](https://docs.fileformat.com/image/emf/) | Enhanced Windows Metafile | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [EMZ](https://docs.fileformat.com/image/emz/) | Windows Compressed Enhanced Metafile | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [EPS](https://docs.fileformat.com/page-description-language/eps/) | Encapsulated PostScript File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [FODG](https://docs.fileformat.com/image/jpc/) | OpenDocument Flat XML Graphics | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [ICO](https://docs.fileformat.com/image/ico/) | Windows Icon File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [J2C](https://docs.fileformat.com/image/j2c/) | JPEG 2000 Code Stream | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [J2K](https://docs.fileformat.com/image/j2k/) | JPEG 2000 Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [JP2](https://docs.fileformat.com/image/jp2/) | JPEG 2000 Core Image File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [JPC](https://docs.fileformat.com/image/jpc/) | JPEG 2000 Code Stream File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [JPEG / JPG](https://docs.fileformat.com/image/jpeg) | JPEG Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [JFIF](https://docs.fileformat.com/image/jfif) | JPEG File Interchange Format | ![(tick)](/viewer/net/images/check-blue.png) | |
| [JPF](https://docs.fileformat.com/image/jpf/) | JPEG 2000 Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [JPM](https://docs.fileformat.com/image/jpm/) | JPEG 2000 Multi-layer Image Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [JPX](https://docs.fileformat.com/image/jpx/) | JPEG 2000 Image File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [JLS](https://docs.fileformat.com/) | JPEG-LS Image | ![(tick)](/viewer/net/images/check-blue.png) | |
| [ODG](https://docs.fileformat.com/image/odg/) | OpenDocument Graphics File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [OTG](https://docs.fileformat.com/image/otg/) | OpenDocument Graphics Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PCL](https://docs.fileformat.com/page-description-language/pcl/) | Printer Command Language Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PSB](https://docs.fileformat.com/image/psb/) | Photoshop Large Document Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PSD](https://docs.fileformat.com/image/psd/) | Adobe Photoshop Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [SVGZ](https://docs.fileformat.com/image/svgz/) | Compressed SVG File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [TGA](https://docs.fileformat.com/image/tga/) | TARGA (Truevision Advanced Raster Graphics Adapter) Graphics | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [TIF / TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [WEBP](https://docs.fileformat.com/image/webp/) | WebP Image | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [WMF](https://docs.fileformat.com/image/wmf/) | Windows Metafile | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [WMZ](https://docs.fileformat.com/image/wmz/) | Compressed Windows Metafile | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view image files: [Render images as HTML, PDF, PNG, and JPEG files](/viewer/python-net/render-images/).

## Note-taking file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |

## Outlook data file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [OST](https://docs.fileformat.com/email/ost/) | Outlook Offline Storage Table | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [PST](https://docs.fileformat.com/email/pst/) | Outlook Personal Storage Table | ![(tick)](/viewer/python-net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Outlook data files: [Render Outlook data files as HTML, PDF, and image files](/viewer/python-net/render-outlook-data-files/).

## PDF and Page Layout file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [OXPS](https://docs.fileformat.com/page-description-language/oxps/) | OpenXPS (Open XML Paper Specification) File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PDF](https://docs.fileformat.com/pdf/) | Adobe Portable Document Format | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | Microsoft XML Paper Specification | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view PDF files: [Render PDF documents as HTML and image files](/viewer/python-net/render-pdf-documents/).

## Presentation file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [FODP](https://docs.fileformat.com/) | OpenDocument Flat XML Presentation | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [POT](https://docs.fileformat.com/presentation/pot/) | Microsoft PowerPoint 97-2003 Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint Macro-Enabled Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view presentations: [Render PowerPoint presentations as HTML, PDF, and image files](/viewer/python-net/render-presentations/).

## Project Management file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [MPP](https://docs.fileformat.com/project-management/mpp/) | Microsoft Project | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [MPT](https://docs.fileformat.com/project-management/mpt/) | Microsoft Project Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [MPX](https://docs.fileformat.com/project-management/mpx/) | Microsoft Project Exchange File | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Project files: [Render Microsoft Project documents as HTML, PDF, and image files](/viewer/python-net/render-ms-project-files/).

## Spreadsheet file formats

| Format | Description | Automatic format detection | Remarks |
| --- | --- | :---: | --- |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [FODS](https://docs.fileformat.com/spreadsheet/fods/) | OpenDocument Flat XML Spreadsheet | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [NUMBERS](https://docs.fileformat.com/spreadsheet/numbers/) | Apple Numbers Spreadsheet | ![(tick)](/viewer/python-net/images/check-blue.png) | GroupDocs.Viewer supports version 3.5 and higher starting with v21.8.
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/) | OpenDocument Spreadsheet Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [SXC](https://docs.fileformat.com/spreadsheet/sxc/) | StarOffice Calc Spreadsheet | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Workbook | ![(tick)](/viewer/python-net/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0), Excel 95 (7.0), Excel 5.0. |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Workbook | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Workbook | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Workbook | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel 97-2003 Template | ![(tick)](/viewer/python-net/images/check-blue.png) | Supported formats: Excel 2003 (11.0), Excel 2002 (10.0), Excel 2000 (9.0), Excel 97 (8.0). |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Microsoft Excel Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Microsoft Excel Macro-Enabled Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Microsoft Excel Add-In | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [XML](https://docs.fileformat.com/spreadsheet/) | XML Spreadsheet 2003 | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view spreadsheet files: [Render Excel and Apple Numbers spreadsheets as HTML, PDF, and image files](/viewer/python-net/render-excel-and-apple-numbers-spreadsheets/).

## Text and programming file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: | --- |
| [AS / AS3](https://docs.fileformat.com/programming/as/) | ActionScript File | |
| [ASM](https://docs.fileformat.com/programming/asm/) | Assembly Language Source Code File | |
| [BAT](https://docs.fileformat.com/executable/bat/) | DOS Batch File | |
| [C](https://docs.fileformat.com/programming/c/) | C/C++ Source Code File | |
| [CC](https://docs.fileformat.com/programming/c/) | C++ Source Code File | |
| [CMAKE](https://docs.fileformat.com/programming/cmake/) | CMake File | |
| [CPP](https://docs.fileformat.com/programming/cpp/) | C++ Source Code File | |
| [CS](https://docs.fileformat.com/specification/programming/cs/) | C# Source Code File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [CSS](https://docs.fileformat.com/web/css/) | Cascading Style Sheet | |
| [CXX](https://docs.fileformat.com/programming/cxx/) | C++ Source Code File | |
| [DIFF](https://docs.fileformat.com/programming/diff/) | Patch File | |
| [ERB](https://docs.fileformat.com/programming/erb/) | Ruby ERB Script | |
| [GROOVY](https://docs.fileformat.com/programming/groovy/) | Groovy Source Code File | |
| [H](https://docs.fileformat.com/programming/h/) | C/C++/Objective-C Header File | |
| [HAML](https://docs.fileformat.com/programming/haml/) | Haml Source Code File | |
| [HH](https://docs.fileformat.com/programming/hh/) | C++ Header File | |
| [JAVA](https://docs.fileformat.com/programming/java/) | Java Source Code File | |
| [JS](https://docs.fileformat.com/web/js/) | JavaScript File | |
| [JSON](https://docs.fileformat.com/web/json/) | JavaScript Object Notation File | |
| [LESS](https://docs.fileformat.com/web/less/) | LESS Style Sheet | |
| [LOG](https://docs.fileformat.com/database/log/) | Log File | |
| [M](https://docs.fileformat.com/programming/m/) | Objective-C Implementation File | |
| [MAKE](https://docs.fileformat.com/programming/make/) | Xcode Makefile Script | |
| [MD](https://docs.fileformat.com/word-processing/md/) | Markdown Documentation File | |
| [ML](https://docs.fileformat.com/programming/ml/) | ML Source Code File | |
| [MM](https://docs.fileformat.com/programming/mm/) | Objective-C++ Source File | |
| [PHP](https://docs.fileformat.com/programming/php/) | PHP Source Code File | |
| [PL](https://docs.fileformat.com/programming/pl/) | Perl Script | |
| [PROPERTIES](https://en.wikipedia.org/wiki/.properties) | Java Properties File | |
| [PY](https://docs.fileformat.com/programming/py/) | Python Script | |
| [RB](https://docs.fileformat.com/ebook/rb/) | Ruby Source Code | |
| [RST](https://docs.fileformat.com/programming/rst/) | reStructuredText File | |
| [SASS](https://docs.fileformat.com/web/sass/) | Syntactically Awesome StyleSheets File | |
| [SCALA](https://docs.fileformat.com/programming/scala/) | Scala Source Code File | |
| [SCM](https://docs.fileformat.com/programming/scm/) | Scheme Source Code File | |
| [SCRIPT](https://docs.fileformat.com/programming/script/) | Generic Script File | |
| [SH](https://docs.fileformat.com/programming/sh/) | Bash Shell Script | |
| [SML](https://en.wikipedia.org/wiki/Standard_ML) | Standard ML Source Code File | |
| [SQL](https://docs.fileformat.com/database/sql/) | Structured Query Language Data File | |
| [TXT](https://docs.fileformat.com/word-processing/txt) | Plain Text File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [VB](https://docs.fileformat.com/specification/programming/vb/) | Visual Basic Source Code File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [VIM](https://docs.fileformat.com/misc/vim/) | Vim Settings File | |
| [XML](https://docs.fileformat.com/web/xml/) | XML File | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [YAML](https://docs.fileformat.com/programming/yaml/) | YAML Document | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view text and code files: [Render text documents as HTML, PDF, and image files](/viewer/python-net/render-text-files/).

## Visio file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [VDW](https://docs.fileformat.com/web/vdw/) | Visio Web Drawing | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VDX](https://docs.fileformat.com/image/vdx/) | Visio Drawing XML File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio 2003-2010 Drawing | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Visio Macro-Enabled Drawing | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Visio Drawing | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio 2003-2010 Stencil | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Visio Macro-Enabled Stencil | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Visio Stencil | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VST](https://docs.fileformat.com/image/vst/) | Visio 2003-2010 Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Visio Macro-Enabled Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Visio Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VSX](https://docs.fileformat.com/image/vsx/) | Visio Stencil XML File | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [VTX](https://docs.fileformat.com/image/vtx/) | Visio Template XML File | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Microsoft Visio files: [Render Visio documents as HTML, PDF, and image files](/viewer/python-net/render-visio-documents/).

## Web file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [CHM](https://docs.fileformat.com/web/chm/) | Compiled HTML Help Format | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language Format | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [MHT](https://docs.fileformat.com/web/mht/) | MHTML Web Archive | ![(tick)](/viewer/python-net/images/check-blue.png) |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML Format | ![(tick)](/viewer/python-net/images/check-blue.png) |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view web files: [Render web documents as PDF, PNG, and JPEG files](/viewer/python-net/render-web-documents/).

## Word processing file formats

| Format | Description | Automatic format detection |
| --- | --- | :---: |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word 97-2003 Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Microsoft Word Macro-Enabled Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Microsoft Word 97-2003 Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Microsoft Word Macro-Enabled Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Microsoft Word Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Text Template | ![(tick)](/viewer/python-net/images/check-blue.png) | |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Document | ![(tick)](/viewer/python-net/images/check-blue.png) | |

Refer to the following help topic for details on how to use GroupDocs.Viewer to load and view Word documents: [Render Word documents as HTML, PDF, and image files](/viewer/python-net/render-word-documents/).

---

## Supported file formats

Path: /watermark/python-net/supported-document-formats/

<div style="margin: 20px 0; padding: 15px; background: #f8f9fa; border-radius: 8px; border-left: 4px solid #007bff;">
  <div style="margin-bottom: 15px;">
    <input type="text" id="formatSearch" placeholder="🔍 Search for a file format (e.g., docx, pdf, png)..." 
           style="width: 100%; padding: 10px; border: 2px solid #ddd; border-radius: 6px; font-size: 16px;">
  </div>
  <div id="searchResults" style="display: none; margin-top: 15px; padding: 10px; background: white; border-radius: 6px; border: 1px solid #ddd;">
    <strong>Search Results:</strong>
    <div id="resultsList"></div>
  </div>
</div>

## 🚀 Quick Format Lookup

**Popular Formats:** [.docx](#-microsoft-word-formats) | [.pdf](#-pdf-formats) | [.xlsx](#-microsoft-excel-formats) | [.pptx](#-microsoft-powerpoint-formats) | [.png](#-image-formats) | [.jpg](#-image-formats)

Each format may support different watermarking capabilities:
- ✅ Full support (Add / Search / Remove)
- ⚠️ Partial support (some limitations)
- ❌ Not supported

---

## 📄 Microsoft Word Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.doc` | Microsoft Word 97 - 2007 Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dot` | Microsoft Word 97 - 2007 Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.docx` | Office Open XML WordprocessingML Document (macro-free) | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.docm` | Office Open XML WordprocessingML Macro-Enabled Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dotx` | Office Open XML WordprocessingML Template (macro-free) | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.dotm` | Word Open XML Macro-Enabled Document | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.rtf` | Rich Text Format File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.odt` | ODF Text Document | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 See examples for [Word]({{< ref "/watermark/python-net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-word-processing-documents/_index.md" >}}) formats

---

## 📊 Microsoft Excel Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.xlsx` | OOXML 2007-2010 | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xlsm` | OOXML Macro Enabled Workbook | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xltm` | OOXML Macro Enabled Workbook Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xlt` | Microsoft Excel Template File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xltx` | Excel Open XML Spreadsheet Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.xls` | Excel Workbook 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 Excel watermarking [examples]({{< ref "/watermark/python-net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-spreadsheet-documents/_index.md" >}})

---

## 📈 Microsoft PowerPoint Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.pptx` | OOXML Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.pptm` | OOXML Macro Enabled Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppsx` | OOXML SlideShow | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppsm` | OOXML Macros Enabled Presentation | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.potx` | OOXML Presentation Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.potm` | OOXML Macro Enabled Presentation Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.ppt` | PowerPoint Presentation 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.pps` | PowerPoint SlideShow 97-2003 | ✅ | ✅ | ✅ | ✅ | ✅ | |

📘 PowerPoint watermarking [examples]({{< ref "/watermark/python-net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-presentation-documents/_index.md" >}})

---

## 🧾 PDF Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.pdf` | PDF (Adobe Portable Document) format | ✅ | ✅ | ✅ | ✅ | ✅ | Watermark searching and removing is not available for rasterized pages |

📘 Add watermark to [PDF]({{< ref "/watermark/python-net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-pdf-documents/_index.md" >}})

---

## ✉️ Email Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.eml` | Email Message Format | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.emlx` | Apple Mail Message | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.oft` | Microsoft Outlook Email Template | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |
| `.msg` | Outlook Email Message Format | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ | Watermark management is available for attached documents and images |

📘 Add watermark to MSG [files]({{< ref "/watermark/python-net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-email-attachments/_index.md" >}})

---

## 🖼️ Image Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.bmp` | Bitmap Picture (BMP) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.gif` | Graphics Interchange Format (GIF) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.jpg` / `.jpeg` / `.jpe` | Joint Photographic Experts Group (JPEG) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.jp2` | JPEG2000 Core Image File | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.png` | Portable Network Graphics (PNG) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.tiff` | Tagged Image File Format (TIFF) | ✅ | ✅ | ✅ | ❌ | ❌ | |
| `.webp` | WebP Image | ✅ | ✅ | ✅ | ❌ | ❌ | |

📘 Image watermarking [examples]({{< ref "/watermark/python-net/developer-guide/advanced-usage/adding-watermarks/add-watermarks-to-images/_index.md" >}})

---

## 🎨 Microsoft Visio Formats

| Format | Description | Load | Save | Add | Search | Remove | Remarks |
|--------|-------------|------|------|-----|--------|--------|---------|
| `.vsd` | Microsoft Visio 2003-2010 Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vdx` | Microsoft Visio 2003-2010 XML Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsdx` | Microsoft Visio Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vstx` | Microsoft Visio File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vss` | Microsoft Visio 2003-2010 Stencil | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vssx` | Visio Stencil File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsdm` | Visio Macro-Enabled Drawing | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vssm` | Microsoft Visio Macro Enabled File Format | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vstm` | Visio Macro-Enabled Drawing Template | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vtx` | VTX Chiptune File | ✅ | ✅ | ✅ | ✅ | ✅ | |
| `.vsx` | Microsoft Visio 2003-2010 XML Stencil | ✅ | ✅ | ✅ | ✅ | ✅ | |

---

## ℹ️ Notes

- Watermarking capabilities may vary depending on the document content and structure.
- For email formats, watermark operations are limited to attached documents and images within the email.
- For image formats, search and remove operations are not supported - only adding watermarks is available.
- PDF watermark searching and removing is not available for rasterized pages.
- For the latest updates, refer to the [Changelog](https://docs.groupdocs.com/watermark/python-net/release-notes/).
- If a format you need is not listed, feel free to [contact support](https://forum.groupdocs.com/).

---


{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/watermark/19), and our team will assist you.

{{< /alert >}}


<script>
document.addEventListener('DOMContentLoaded', function() {
    const searchInput = document.getElementById('formatSearch');
    const searchResults = document.getElementById('searchResults');
    const resultsList = document.getElementById('resultsList');
    
    // Format database for search
    const formats = [
        { ext: '.doc', name: 'Microsoft Word 97-2007 Document', category: 'Word', support: 'Full' },
        { ext: '.docx', name: 'Office Open XML WordprocessingML Document', category: 'Word', support: 'Full' },
        { ext: '.docm', name: 'Office Open XML WordprocessingML Macro-Enabled Document', category: 'Word', support: 'Full' },
        { ext: '.dot', name: 'Microsoft Word 97-2007 Template', category: 'Word', support: 'Full' },
        { ext: '.dotx', name: 'Office Open XML WordprocessingML Template', category: 'Word', support: 'Full' },
        { ext: '.dotm', name: 'Word Open XML Macro-Enabled Document', category: 'Word', support: 'Full' },
        { ext: '.rtf', name: 'Rich Text Format File', category: 'Word', support: 'Full' },
        { ext: '.odt', name: 'ODF Text Document', category: 'Word', support: 'Full' },
        
        { ext: '.xlsx', name: 'OOXML 2007-2010', category: 'Excel', support: 'Full' },
        { ext: '.xlsm', name: 'OOXML Macro Enabled Workbook', category: 'Excel', support: 'Full' },
        { ext: '.xltm', name: 'OOXML Macro Enabled Workbook Template', category: 'Excel', support: 'Full' },
        { ext: '.xlt', name: 'Microsoft Excel Template File', category: 'Excel', support: 'Full' },
        { ext: '.xltx', name: 'Excel Open XML Spreadsheet Template', category: 'Excel', support: 'Full' },
        { ext: '.xls', name: 'Excel Workbook 97-2003', category: 'Excel', support: 'Full' },
        
        { ext: '.pptx', name: 'OOXML Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.pptm', name: 'OOXML Macro Enabled Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppsx', name: 'OOXML SlideShow', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppsm', name: 'OOXML Macros Enabled Presentation', category: 'PowerPoint', support: 'Full' },
        { ext: '.potx', name: 'OOXML Presentation Template', category: 'PowerPoint', support: 'Full' },
        { ext: '.potm', name: 'OOXML Macro Enabled Presentation Template', category: 'PowerPoint', support: 'Full' },
        { ext: '.ppt', name: 'PowerPoint Presentation 97-2003', category: 'PowerPoint', support: 'Full' },
        { ext: '.pps', name: 'PowerPoint SlideShow 97-2003', category: 'PowerPoint', support: 'Full' },
        
        { ext: '.pdf', name: 'PDF (Adobe Portable Document) format', category: 'PDF', support: 'Full*' },
        
        { ext: '.eml', name: 'Email Message Format', category: 'Email', support: 'Partial' },
        { ext: '.emlx', name: 'Apple Mail Message', category: 'Email', support: 'Partial' },
        { ext: '.oft', name: 'Microsoft Outlook Email Template', category: 'Email', support: 'Partial' },
        { ext: '.msg', name: 'Outlook Email Message Format', category: 'Email', support: 'Partial' },
        
        { ext: '.bmp', name: 'Bitmap Picture', category: 'Image', support: 'Add Only' },
        { ext: '.gif', name: 'Graphics Interchange Format', category: 'Image', support: 'Add Only' },
        { ext: '.jpg', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jpeg', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jpe', name: 'Joint Photographic Experts Group', category: 'Image', support: 'Add Only' },
        { ext: '.jp2', name: 'JPEG2000 Core Image File', category: 'Image', support: 'Add Only' },
        { ext: '.png', name: 'Portable Network Graphics', category: 'Image', support: 'Add Only' },
        { ext: '.tiff', name: 'Tagged Image File Format', category: 'Image', support: 'Add Only' },
        { ext: '.webp', name: 'WebP Image', category: 'Image', support: 'Add Only' },
        
        { ext: '.vsd', name: 'Microsoft Visio 2003-2010 Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vdx', name: 'Microsoft Visio 2003-2010 XML Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vsdx', name: 'Microsoft Visio Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vstx', name: 'Microsoft Visio File Format', category: 'Visio', support: 'Full' },
        { ext: '.vss', name: 'Microsoft Visio 2003-2010 Stencil', category: 'Visio', support: 'Full' },
        { ext: '.vssx', name: 'Visio Stencil File Format', category: 'Visio', support: 'Full' },
        { ext: '.vsdm', name: 'Visio Macro-Enabled Drawing', category: 'Visio', support: 'Full' },
        { ext: '.vssm', name: 'Microsoft Visio Macro Enabled File Format', category: 'Visio', support: 'Full' },
        { ext: '.vstm', name: 'Visio Macro-Enabled Drawing Template', category: 'Visio', support: 'Full' },
        { ext: '.vtx', name: 'VTX Chiptune File', category: 'Visio', support: 'Full' },
        { ext: '.vsx', name: 'Microsoft Visio 2003-2010 XML Stencil', category: 'Visio', support: 'Full' }
    ];
    
    function getSupportIcon(support) {
        switch(support) {
            case 'Full': return '✅';
            case 'Full*': return '✅*';
            case 'Partial': return '⚠️';
            case 'Add Only': return '🔸';
            default: return '❌';
        }
    }
    
    function performSearch(query) {
        if (!query || query.length < 2) {
            searchResults.style.display = 'none';
            return;
        }
        
        query = query.toLowerCase();
        const matches = formats.filter(format => 
            format.ext.toLowerCase().includes(query) || 
            format.name.toLowerCase().includes(query) ||
            format.category.toLowerCase().includes(query)
        );
        
        if (matches.length > 0) {
            resultsList.innerHTML = matches.map(match => `
                <div style="padding: 8px; margin: 5px 0; background: #f0f8ff; border-left: 3px solid #007bff; border-radius: 4px;">
                    <strong>${match.ext}</strong> - ${match.name}
                    <br><small>Category: ${match.category} | Support: ${getSupportIcon(match.support)} ${match.support}</small>
                </div>
            `).join('');
            searchResults.style.display = 'block';
        } else {
            resultsList.innerHTML = '<div style="padding: 8px; color: #666;">No formats found matching your search.</div>';
            searchResults.style.display = 'block';
        }
    }
    
    searchInput.addEventListener('input', function(e) {
        performSearch(e.target.value);
    });
    
    searchInput.addEventListener('keydown', function(e) {
        if (e.key === 'Escape') {
            searchResults.style.display = 'none';
            searchInput.value = '';
        }
    });
    
    // Hide search results when clicking outside
    document.addEventListener('click', function(e) {
        if (!e.target.closest('#formatSearch') && !e.target.closest('#searchResults')) {
            searchResults.style.display = 'none';
        }
    });
});
</script>
---

## Supported File Formats

Path: /total/python-net/supported-document-formats/


**GroupDocs.Total for Python via .NET** is a suite of document-processing APIs that together support a very broad range of file formats — from common office documents and PDFs to images, e-mail formats, eBooks and many specialized formats. Each product in the suite focuses on a particular capability (viewing, conversion, comparison, watermarking, metadata handling, merging, assembly, redaction, signature), and every product exposes its own detailed list of supported file types. For the most accurate, product-level information and quick format lookup use the linked product pages below.

> **Note:** Supported formats vary by product and by operation (for example, a format that can be **viewed** may not be **convertible** to every other format). Always check the per-product supported-formats page for the authoritative list.

## Highlights

- **Conversion** supports thousands of conversion combinations and covers a very large set of input/output formats — ideal when you need to convert between many different types.  
- **Viewer** renders documents to HTML, PDF, JPEG and PNG so you can display a wide variety of formats in web or desktop apps.  
- **Comparison** supports common office and text formats (Word, Excel, PowerPoint), OpenDocument (ODT), PDF, text and HTML for document comparison workflows.  
- **Assembly / Metadata** components accept a very large set of formats (the Assembly/Metadata product pages report support for **170+** popular formats), making them suitable for template population and metadata extraction across many document types.  
- **Merger / Redaction / Watermark / Signature** products handle the usual office formats (DOC/DOCX/XLS/XLSX/PPT/PPTX, PDF) plus images, email and other formats frequently used in document processing pipelines.

## Commonly requested formats (examples)

DOC, DOCX, XLS, XLSX, PPT, PPTX, PDF, HTML, TXT, RTF, JPEG, PNG, TIFF, MSG, EML, EPUB, ZIP, TAR, DWG

For a full per-product list use the table below.

## Supported formats by API

Below are links to the per-product supported-formats pages where you can search or filter by extension for the authoritative lists:

| Product | Documentation page |
| --- | --- |
| GroupDocs.Conversion&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/conversion/python-net/supported-file-formats/) |
| GroupDocs.Viewer&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/viewer/python-net/supported-document-formats/) |
| GroupDocs.Comparison&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/comparison/python-net/supported-document-formats/) |
| GroupDocs.Watermark&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/watermark/python-net/supported-document-formats/) |
| GroupDocs.Metadata&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/metadata/python-net/supported-document-formats/) |
| GroupDocs.Merger&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/merger/python-net/supported-document-formats/) |
| GroupDocs.Assembly&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/assembly/python-net/supported-document-formats/) |
| GroupDocs.Redaction&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/redaction/python-net/supported-document-formats/) |
| GroupDocs.Signature&nbsp;for&nbsp;Python&nbsp;via&nbsp;.NET | [Supported file formats](https://docs.groupdocs.com/signature/python-net/supported-file-formats/) |

## Request file-format support

If you **don't** find your file format on the product pages, post a request on our [Free Support Forum](https://forum.groupdocs.com/c/total/8) and our team will assist you.

---

## Supported Image Types

Path: /merger/java/supported-image-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Extract pages | Cross-format image merging | Cross-format merge to PDF |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [JPG](https://docs.fileformat.com/image/jpeg/) | JPG Image File | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [JPEG](https://docs.fileformat.com/image/jpeg/) | JPEG Image File | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image File | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [TIF](https://docs.fileformat.com/image/tiff/) | Tagged Image Format | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [SVG](https://docs.fileformat.com/image/svg/) | Scalar Vector Graphics | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [SVGZ](https://docs.fileformat.com/image/svgz/) | Compressed Scalar Vector Graphics | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EMF](https://docs.fileformat.com/image/emf/) | Windows Enhanced Metafile | ![(tick)](/merger/net/images/check.png) |   |   |  |  |
| [EMZ](https://docs.fileformat.com/image/emz/) | Windows Compressed Enhanced Metafile | ![(tick)](/merger/net/images/check.png) |   |   |  |  |

---

## System requirements

Path: /classification/net/system-requirements/

## Overview

To produce and manipulate the documents, the machine that GroupDocs.Classification for .NET runs on doesn't need to have Adobe Acrobat, Microsoft Office or OpenOffice installed: GroupDocs.Classification for .NET has their own document processing engine.  
The machine that GroupDocs.Classification for .NET runs on doesn't need to have Adobe Acrobat, Microsoft Office or OpenOffice installed: GroupDocs.Classification for .NET has their own document processing engine.

## Supported Operating System

### Windows

*   Microsoft Windows 2000 Professional (x64)
*   Microsoft Windows 2000 Server (x64)
*   Microsoft Windows 2003 Server (x64)
*   Microsoft Windows 2008 Server (x64)
*   Microsoft Windows 2012 Server (x64)
*   Microsoft Windows 2012 R2 Server (x64)
*   Microsoft Windows 2016 Server (x64)
*   Microsoft Windows 2019 Server (x64)
*   Microsoft Windows Vista (x64)
*   Microsoft Windows XP (x64)
*   Microsoft Windows 7 (x64)
*   Microsoft Windows 8, 8.1 (x64)
*   Microsoft Windows 10 (x64)
*   Microsoft Azure

### macOS

*   Mac OS X x64 (10.12+) 

### Linux

*   Linux x64 ( 6, 7 ,27, 9, 8.7+, 18.04, 16.04, 14.04, 18, 17, 42.3+, 12 SP2+)

## Memory Requirements

3GB RAM

## Development Environments

You can use GroupDocs.Classification for .NET to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2013
*   Microsoft Visual Studio 2015
*   Microsoft Visual Studio 2017
*   Microsoft Visual Studio 2019

## Supported Frameworks

GroupDocs.Classification is a Netstandard2 library, so each framework that supports Netstandard could also uses the library:

*   .NET Framework 4.7 or later
*   .NET Core 2.0 or later

GroupDocs.Classification for .NET uses System.Numerics.Vectors library for the fast calculations.  
Please use bindings redirect for proper work with old-style projects. Include the following XML code in your app configuration file (inside assemblyBinding element in app.config). 

```csharp
<dependentAssembly>
	<assemblyIdentity name="System.Numerics.Vectors" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
	<bindingRedirect oldVersion="0.0.0.0-4.1.4.0" newVersion="4.1.4.0" />
</dependentAssembly>
```

---

## System Requirements

Path: /assembly/java/system-requirements/

## Overview

GroupDocs.Assembly for Java does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "assembly/java/getting-started/development-environment-installation-and-configuration.md" >}}).

## Supported Operating Systems

GroupDocs.Assembly for Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Supported Java Versions

GroupDocs.Assembly for Java supports the following Java versions:

*   J2SE 7.0 (1.7)
*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## System Requirements

Path: /assembly/net/system-requirements/


GroupDocs.Assembly for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "assembly/net/getting-started/development-environment-installation-and-configuration.md" >}}).

## Supported Operating Systems

GroupDocs.Assembly for .NET supports any 32-bit or 64-bit operating system where .NET or Mono framework is installed including, but not limited to:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

*   Mac OS X

## Supported Frameworks

GroupDocs.Assembly for .NET  supports .NET and Mono frameworks as follows:

### .NET Frameworks

*   .NET Framework 2.0
*   .NET Framework 3.5
*   .NET Framework 4.0
*   .NET Framework 4.0\_ClientProfile
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.5.2
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.7
*   .NET Framework 4.7.2

### Mono Framework

*   Mono 2.6.7 or later

## Development Environments

GroupDocs.Assembly for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2010
*   Microsoft Visual Studio 2011
*   Microsoft Visual Studio 2012
*   Microsoft Visual Studio 2013
*   Microsoft Visual Studio 2015
*   Microsoft Visual Studio 2017
*   Microsoft Visual Studio 2019
*   Xamarin.Android
*   Xamarin.IOS
*   Xamarin.Mac
*   MonoDevelop 2.4 and later

---

## System Requirements

Path: /editor/java/system-requirements/

## Overview

GroupDocs.Editor for Java does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "editor/java/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Editor for Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

* Microsoft Windows 2003 Server ( x64, x86)
* Microsoft Windows 2008 Server ( x64, x86)
* Microsoft Windows 2012 Server ( x64, x86)
* Microsoft Windows 2012 R2 Server ( x64, x86)
* Microsoft Windows 2016 Server ( x64, x86)
* Microsoft Windows 2019 Server ( x64, x86)
* Microsoft Windows Vista ( x64, x86)
* Microsoft Windows XP ( x64, x86)
* Microsoft Windows 7 ( x64, x86)
* Microsoft Windows 8, 8.1 ( x64, x86)
* Microsoft Windows 10 ( x64, x86)
* Microsoft Azure

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

* Mac OS X

## Supported Java Versions

GroupDocs.Editor for Java supports the following Java versions:

* J2SE 8.0 (1.8)
* or above (*for example Java 10*)

---

## System Requirements

Path: /editor/nodejs-java/system-requirements/

## Overview

GroupDocs.Editor for Node.js does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "editor/nodejs-java/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Editor for Node.js supports any 32-bit or 64-bit operating system that runs the Node.js runtime including, but not limited:

### Windows

* Microsoft Windows 2003 Server ( x64, x86)
* Microsoft Windows 2008 Server ( x64, x86)
* Microsoft Windows 2012 Server ( x64, x86)
* Microsoft Windows 2012 R2 Server ( x64, x86)
* Microsoft Windows 2016 Server ( x64, x86)
* Microsoft Windows 2019 Server ( x64, x86)
* Microsoft Windows Vista ( x64, x86)
* Microsoft Windows XP ( x64, x86)
* Microsoft Windows 7 ( x64, x86)
* Microsoft Windows 8, 8.1 ( x64, x86)
* Microsoft Windows 10 ( x64, x86)
* Microsoft Azure

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

* Mac OS X


---

## System Requirements

Path: /metadata/java/system-requirements/

## Overview

GroupDocs.Metadata for Java does not require any external software or third party tools to be installed.

## Supported operating systems

GroupDocs.Metadata for Java supports any 32-bit or 64-bit operating system that run the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Supported Java versions

GroupDocs.Metadata for Java supports the following Java versions:

*   J2SE 7.0 (1.7)
*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## System Requirements

Path: /parser/python-net/system-requirements/


## Overview

[GroupDocs.Parser for Python via .NET](https://products.groupdocs.com/parser/python-net) does not require any external software or third-party tool to be installed. Just follow one of the ways described in the [Installation]({{< ref "parser/python-net/getting-started/installation" >}}).

## Supported Operating Systems

GroupDocs.Parser for Python via .NET supports any 32-bit or 64-bit operating system where Python is installed including, but not limited to:

### Windows

- Microsoft Windows Server 2003 and later
- Microsoft Windows Vista (x64, x86)
- Microsoft Windows XP (x64, x86)
- Microsoft Windows 7, 8, 8.1 (x64, x86)
- Microsoft Windows 10 (x64, x86)
- Microsoft Windows 11 (x64)

### Linux

- Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

- Mac OS X

## Supported Frameworks

GroupDocs.Parser for Python via .NET supports the following Python frameworks:

### Python

- Python 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12 (recommended)

## Development Environments

GroupDocs.Parser for Python via .NET can be used with any text editor or IDE that supports Python development, including:

- PyCharm
- Visual Studio Code
- Jupyter Notebook
- Sublime Text
- Atom
- Spyder
- Any other Python-compatible IDE or text editor

## Additional Dependencies

GroupDocs.Parser for Python via .NET automatically installs all required dependencies when installed via pip. No additional packages need to be manually installed.


---

## System Requirements

Path: /search/java/system-requirements/

## Overview

GroupDocs.Search for Java does not require any external software or third party tool to be installed. Just follow one of the way as described on the [Installation]({{< ref "search/java/getting-started/installation.md" >}}) page.

## Supported Operating Systems

GroupDocs.Search for Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Supported Java Versions

GroupDocs.Search for Java supports the following Java versions:

*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## System Requirements

Path: /search/net/system-requirements/

## Overview

GroupDocs.Search for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described on the [Installation]({{< ref "search/net/getting-started/installation.md" >}}) page.

## Supported Operating Systems

GroupDocs.Search for .NET supports any 32-bit or 64-bit operating system where .NET framework is installed including, but not limited to:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Windows 11 ( x64, x86)

### Linux

- Linux (Ubuntu, OpenSUSE, CentOS and others)

## Supported Frameworks

GroupDocs.Search for .NET  supports .NET frameworks as follows:

### .NET Frameworks

*   .NET Framework 4.6.2
*   .NET Framework 4.6.3
*   .NET Framework 4.7
*   .NET Framework 4.7.1
*   .NET Framework 4.7.2
*   .NET Framework 4.8
*   .NET Framework 4.8.1
*   .NET Standard 2.1
*   .NET Core 3.0
*   .NET Core 3.1
*   .NET 5.0
*   .NET 6.0
*   .NET 7.0
*   .NET 8.0

## Development Environments

GroupDocs.Search for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2012
*   Microsoft Visual Studio 2013
*   Microsoft Visual Studio 2015
*   Microsoft Visual Studio 2017
*   Microsoft Visual Studio 2019
*   Microsoft Visual Studio 2022

---

## System Requirements

Path: /search/nodejs-java/system-requirements/

## Overview

GroupDocs.Search for Node.js via Java does not require any external software or third party tool to be installed. Just follow one of the way as described on the [Installation]({{< ref "search/nodejs-java/getting-started/installation.md" >}}) page.

## Supported Operating Systems

GroupDocs.Search for Node.js via Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Development Environments

GroupDocs.Search for Node.js requires Node.js and Java. You can use any text editor like Atom, Sublime, Visual Studio Code, etc.

---

## System Requirements

Path: /watermark/java/system-requirements/

## Overview

GroupDocs.Watermark for Java does not require any external software or third party tool to be installed. Just follow one of the way as described in [Installation]({{< ref "/watermark/java/getting-started/installation.md" >}}) section.

## Supported Operating Systems

GroupDocs.Watermark for Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

*   Mac OS X

## Supported Java Versions

GroupDocs.Watermark for Java supports the following Java versions:

*   J2SE 7.0 (1.7)
*   J2SE 8.0 (1.8)
*   or above (*for example Java 10*)

---

## Update document password

Path: /merger/java/update-document-password/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to update password from password-protected document. The resultant document will have new password.  
Here are the steps to update document password:

*   Initialize [LoadOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/LoadOptions) class specifying current password;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream and pass [LoadOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/LoadOptions) object to it;
*   Initialize [UpdatePasswordOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/UpdatePasswordOptions) class specifying new document password;
*   Call [updatePassword](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#updatePassword(com.groupdocs.merger.domain.options.interfaces.IUpdatePasswordOptions)) method and pass [UpdatePasswordOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/UpdatePasswordOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to update document password:

```java
String filePath = "c:\sample.xlsx";
String filePathOut = "c:\output\result.xlsx";

ILoadOptions loadOptions = new LoadOptions("SAMPLE_PASSWORD");
IUpdatePasswordOptions updateOptions = new UpdatePasswordOptions("NEW_SAMPLE_PASSWORD");

Merger merger = new Merger(filePath, loadOptions);        
merger.updatePassword(updateOptions);
merger.save(filePathOut);
```

---

## Updating metadata

Path: /metadata/java/updating-metadata/

The example below demonstrates how to update existing metadata properties using a combination of criteria. Please note that the [updateProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#updateProperties(com.groupdocs.metadata.search.Specification,%20com.groupdocs.metadata.core.PropertyValue)) method checks the type of all properties before applying any changes. If a property satisfies the predicate but has a type different from the passed value it won't be updated. The explicit type check in the example is performed since we use the existing value to filter metadata properties.

1.  [Open]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to be updated
2.  Specify a predicate that will be used to filter desired metadata properties
3.  Specify a value which you want to be assigned to the selected properties
4.  Pass the predicate and the new value to the [updateProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#updateProperties(com.groupdocs.metadata.search.Specification,%20com.groupdocs.metadata.core.PropertyValue)) method
5.  Check the actual number of updated properties
6.  [Save]({{< ref "metadata/java/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes

**advanced\_usage.UpdatingMetadata**

```csharp
public class UpdatingMetadata {
    public static void run() {
        Date threeDaysAgo = new Date(System.currentTimeMillis() - TimeUnit.DAYS.toMillis(3));

        File folder = new File(Constants.InputPath);
        for (File file : folder.listFiles()) {
            try (Metadata metadata = new Metadata(file.getAbsolutePath())) {
                if (metadata.getFileFormat() != FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
                    System.out.println();
                    System.out.println(file.getName());

                    // Update the file creation date/time if the existing value is older than 3 days
                    int affected = metadata.updateProperties(new ContainsTagSpecification(Tags.getTime().getCreated()).and(
                            new OfTypeSpecification(MetadataPropertyType.DateTime)).and(
                            new UpdatingMetadata().new DateBeforeSpecification(threeDaysAgo)), new PropertyValue(new Date()));

                    System.out.println(String.format("Affected properties: %s", affected));

                    metadata.save(Constants.OutputPath + "output." + FilenameUtils.getExtension(file.getName()));
                }
            }
        }
    }

    // Define your own specifications to filter metadata properties
    public class DateBeforeSpecification extends Specification {
        public DateBeforeSpecification(Date date) {
            setValue(date);
        }

        public final Date getValue() {
            return auto_Value;
        }

        private void setValue(Date value) {
            auto_Value = value;
        }

        private Date auto_Value;

        public boolean isSatisfiedBy(MetadataProperty candidate) {
            Date date = candidate.getValue().toClass(Date.class);
            if (date != null) {
                return date.before(getValue());
            }
            return false;
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Updating metadata

Path: /metadata/net/updating-metadata/

The example below demonstrates how to update existing metadata properties using a combination of criteria. Please note that the [UpdateProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/updateproperties) method checks the type of all properties before applying any changes. If a property satisfies the predicate but has a type different from the passed value it won't be updated. The explicit type check in the example is performed since we use the existing value to filter metadata properties.

1.  [Open]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to be updated
2.  Specify a predicate that will be used to filter desired metadata properties
3.  Specify a value which you want to be assigned to the selected properties
4.  Pass the predicate and the new value to the [UpdateProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/updateproperties) method
5.  Check the actual number of updated properties
6.  [Save]({{< ref "metadata/net/developer-guide/advanced-usage/saving-files/_index.md" >}}) the changes
      
    

**AdvancedUsage.UpdatingMetadata**

```csharp
DateTime today = DateTime.Today;
DateTime threeDaysAgo = today.AddDays(-3);
foreach (string file in Directory.GetFiles(Constants.InputPath))
{
	using (Metadata metadata = new Metadata(file))
	{
		if (metadata.FileFormat != FileFormat.Unknown && !metadata.GetDocumentInfo().IsEncrypted)
		{
			Console.WriteLine();
			Console.WriteLine(file);

			// Update the file creation date/time if the existing value is older than 3 days
			var affected = metadata.UpdateProperties(p => p.Tags.Contains(Tags.Time.Created) &&
														  p.Value.Type == MetadataPropertyType.DateTime &&
														  p.Value.ToStruct<DateTime>() < threeDaysAgo, new PropertyValue(today));
			Console.WriteLine("Affected properties: {0}", affected);

			metadata.Save(Path.Combine(Constants.OutputPath, "output" + Path.GetExtension(file)));
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Updating metadata

Path: /metadata/nodejs-java/updating-metadata/

The example below demonstrates how to update existing metadata properties using a combination of criteria. Please note that the **updateProperties** method checks the type of all properties before applying any changes. If a property satisfies the predicate but has a type different from the passed value it won't be updated. The explicit type check in the example is performed since we use the existing value to filter metadata properties.

1.  **Open** a file to be updated
2.  Specify a predicate that will be used to filter desired metadata properties
3.  Specify a value which you want to be assigned to the selected properties
4.  Pass the predicate and the new value to the **updateProperties** method
5.  Check the actual number of updated properties
6.  **Save** the changes

**advanced\_usage.UpdatingMetadata**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
fs.readdirSync(Constants.inputPath).forEach(file => {
            var metadata = new groupdocs.metadata.Metadata(Constants.inputPath + file);
            if (metadata.getFileFormat() != groupdocs.metadata.FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
                
                console.log(file);

                // Add a property containing the file last printing date if it's missing
                // Note that the property will be added to metadata packages that satisfy the following criteria:
                // 1) Only existing metadata packages will be affected. No new packages are added during this operation
                // 2) There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package.
                // All properties supported by a certain package are usually defined in the specification of a particular metadata standard
                var affected = metadata.updateProperties(new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getTime().getPrinted()), new groupdocs.metadata.PropertyValue(new Date()));

                console.log(`Affected properties: ${affected}`);
            }
      });
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Updating QR-code signatures with advanced options

Path: /signature/java/updating-qr-code-signatures-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) class to manipulate qr-code signatures location, size, textual content and encode type over [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) object to analyze if signatures were successfully processed.

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. The [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult)contains list of successfully updated signatures and ones that failed. The Barcode signature could be failed to update due to several reasons:

*   if signature object was initialized with constructor by incorrect signature identifier;
*   if signature object was not found;
*   there was an error occurred while updating signature in the document.

Here are the steps to update QR-code signature in the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [QrCodeSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature); 
*   Select from list [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) object(s) that should be updated;     
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.    
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not.

Here are the alternative steps to update QR-code signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions))  methods.
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate one or several  [QrCodeSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/QrCodeSignature) objects with signature Id(s) passed to constructor; 
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it;
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not. 

The following table describes changeable properties for QR-code signatures dependent on document type

| Document Type / Signature Property | Left | Top | Width | Height | EncodeType | Text | IsSignature |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) |
| Spreadsheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Pdf | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Presentation | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |
| Word Processing | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(tick)](/signature/java/images/check.png) |

## Update QR-code signature in the document after Search

This example shows how to update QR-code signature that was found using  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("sampleSigned.pdf");
BarcodeSearchOptions options = new BarcodeSearchOptions();
 
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class, options);
List<BaseSignature> bS = new ArrayList<BaseSignature>();
// adjust signature properties
for (QrCodeSignature temp : signatures)
{
    // apply some condition to adjust signature properties
    temp.setLeft(temp.getLeft() + 100);
    temp.setTop(temp.getTop() + 100);
    temp.setSignature(true);
    bS.add(temp);
}
// update all found signatures
UpdateResult updateResult = signature.update("sampleSigned.pdf",bS);
if (updateResult.getSucceeded().size() == signatures.size())
{
    System.out.print("\nAll signatures were successfully updated!");
}
else
{
    System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : "+updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Update QR-code signature in document by known signature Identifier

This example shows how to update QR-code signature in the document by known signature Id (that was obtained by  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method previously).

```java
// initialize Signature instance
Signature signature = new Signature("signed.xlsx");
// read from some data source signature Id value
String[] signatureIdList = new String[]
        {
                "1dd21cf3-b904-4da9-9413-1ff1dab51974",
                "b0123987-b0d4-4004-86ec-30ab5c41ac7e"
        };
// create list of Barcode Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList)
{
    QrCodeSignature temp = new QrCodeSignature(item);
    temp.setWidth(150);
    temp.setHeight(150);
    temp.setLeft(200);
    temp.setTop(200);
    signatures.add(temp);
}
// update all found signatures
UpdateResult updateResult = signature.update("signed.xlsx",signatures);
if (updateResult.getSucceeded().size() == signatures.size())
{
    System.out.print("\nAll signatures were successfully updated!");
}
else
{
    System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : "+updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Use advanced logging

Path: /redaction/java/use-advanced-logging/


You can implement *ILogger* interface from com.groupdocs.redaction.options package. This interface requires to implement three methods:



```java
import com.groupdocs.redaction.options.ILogger;
import java.util.ArrayList;
/**
 * <p>
 * This is an example of ILogger implementation, tracking count of error messages.
 * </p>
 */
public class CustomLogger implements ILogger
{
    private ArrayList<String> _errors;
    private ArrayList<String> _traces;
    private ArrayList<String> _warnings;
    public boolean hasErrors() 
    { 
        return _errors.size() > 0; 
    }
    public CustomLogger()
    {
        _errors = new ArrayList<String>();
        _traces = new ArrayList<String>();
        _warnings = new ArrayList<String>();
    }
    public void error(String message)
    {
        _errors.add(message);
    }
    public void trace(String message)
    {
        _traces.add(message);
    }
    public void warning(String message)
    {
        _warnings.add(message);
    }
}
```

Once implemented, you can use it to track error log records:



```java
CustomLogger logger = new CustomLogger();
final Redactor redactor = new Redactor(Constants.SAMPLE_DOCX, new LoadOptions(), new RedactorSettings(logger));
try 
{
    // Here we can use document instance to perform redactions
    redactor.apply(new DeleteAnnotationRedaction());
    if (!logger.hasErrors())
    {
        redactor.save();
    }
}
finally { redactor.close(); }
```

---

## Use advanced logging

Path: /redaction/net/use-advanced-logging/


You can implement [ILogger](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.options/ilogger) interface from GroupDocs.Redaction.Options namespace. This interface requires to implement three methods:

**C#**

```csharp
    using GroupDocs.Redaction.Options;
    /// <summary>
    /// This is an example of ILogger implementation, tracking count of error messages.
    /// </summary>
    public class CustomLogger : ILogger
    {
        public List<string> Errors { get; private set; }
        public List<string> Traces { get; private set; }
        public List<string> Warnings { get; private set; }

        public bool HasErrors { get { return Errors.Count > 0; } }

        public CustomLogger()
        {
            Errors = new List<string>();
            Traces = new List<string>();
            Warnings = new List<string>();
        }

        public void Error(string message)
        {
            Errors.Add(message);
        }

        public void Trace(string message)
        {
            Traces.Add(message);
        }

        public void Warning(string message)
        {
            Warnings.Add(message);
        }
    }
```

Once implemented, you can use it to track error log records:

**C#**

```csharp
using (Stream stream = File.Open(@"sample.docx", FileMode.Open, FileAccess.ReadWrite))
{
   var logger = new CustomLogger();
   using (Redactor redactor = new Redactor(stream, new LoadOptions(), new RedactorSettings(logger)))
   {
      // Here we can use document instance to make redactions
      redactor.Apply(new DeleteAnnotationRedaction());
      if (!logger.HasErrors)
      {   
         redactor.Save();
      }
   }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use Aspose.OCR for .NET on-premise API

Path: /redaction/net/use-aspose-ocr-on-premise/

This implementation is based on [Aspose.OCR for .NET on-premise API](https://products.aspose.com/ocr/net/). Although it requires a valid license file, you can always request a temporal license for a month to evaluate.

**C#**
```csharp
    using GroupDocs.Redaction.Integration.Ocr;

    public class AsposeOCRStandaloneConnector : IOcrConnector
    {
        public AsposeOCRStandaloneConnector(string licenseFile)
        {
            var lic = new Aspose.OCR.License();
            lic.SetLicense(licenseFile);
        }

        public RecognizedImage Recognize(Stream imageStream)
        {
            try
            {
                using (MemoryStream memStream = new MemoryStream())
                {
                    imageStream.CopyTo(memStream);
                    var api = new Aspose.OCR.AsposeOcr();
                    var rectangles = api.GetRectangles(memStream, Aspose.OCR.AreasType.LINES, false);
                    var result = api.RecognizeImage(memStream, new Aspose.OCR.RecognitionSettings()
                    {
                        Language = Aspose.OCR.Language.Eng,
                        RecognitionAreas = rectangles
                    });
                    return CreateDtoFromResponse(result);
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine("Aspose.OCR for Cloud Recognition failed: {0}", ex.ToString());
            }
            return new RecognizedImage(new List<TextLine>());
        }

        protected virtual RecognizedImage CreateDtoFromResponse(Aspose.OCR.RecognitionResult result)
        {
            List<TextLine> lines = new List<TextLine>();
            for (int i = 0; i < result.RecognitionAreasText.Count; i++)
            {
                var fragments = RegularTextLine.SplitToFragments(result.RecognitionAreasText[i].Trim('\r', '\n'), result.RecognitionAreasRectangles[i]);
                lines.Add(new TextLine(fragments));
            }
            return new RecognizedImage(lines);
        }
    }

```

First, we identify rectangle areas of text using GetRectangles() method with Aspose.OCR.AreasType.LINES option. With this option, you will get a rectangle for every line of text, but you will have to split it to words.

You can find full implementation and an example of its usage here [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use Microsoft Azure Computer Vision API

Path: /redaction/java/use-microsoft-azure-computer-vision/


This implementation is based on [Microsoft Azure Computer Vision API](https://docs.microsoft.com/en-US/azure/cognitive-services/computer-vision/). The service is paid, but you can [create a free subscription](https://azure.microsoft.com/free/cognitive-services/). Once you've done with subscription, you will have to [create Computer Vision resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision) using the free pricing tier (F0) to try the service, and upgrade later to a paid tier for production. As a result, you will get Computer Vision Endpoint and Subscription Key (let's suppose they are stored in the environment variables COMPUTER_VISION_ENDPOINT and COMPUTER_VISION_SUBSCRIPTION_KEY respectively). 

**Java**

```java
import java.net.URI;
import java.io.InputStream;
import java.util.ArrayList;
import java.awt.Rectangle;
import java.security.SecureRandom;
import java.security.cert.CertificateException;
import java.security.cert.X509Certificate;
import javax.net.ssl.HostnameVerifier;
import javax.net.ssl.SSLContext;
import javax.net.ssl.SSLSession;
import javax.net.ssl.TrustManager;
import javax.net.ssl.X509TrustManager;

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.util.EntityUtils;
import org.apache.http.entity.InputStreamEntity;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.bouncycastle.util.Strings;
import org.json.JSONArray;
import org.json.JSONObject;

import com.groupdocs.redaction.integration.IOcrConnector;
import com.groupdocs.redaction.integration.RecognizedImage;
import com.groupdocs.redaction.integration.TextFragment;
import com.groupdocs.redaction.integration.TextLine;

public class MicrosoftAzureOcrConnector implements IOcrConnector
{
    private static final String OcrUri = "vision/v3.1/ocr";
    private final String getSubscriptionKey() { return System.getenv("COMPUTER_VISION_SUBSCRIPTION_KEY"); } 
    private final String getEndpoint() { return System.getenv("COMPUTER_VISION_ENDPOINT"); }
    private final String getUriBase() { return getEndpoint() + OcrUri; }

    public MicrosoftAzureOcrConnector()
    {
    }
    
    public final RecognizedImage recognize(InputStream imageStream)
    {
        try
        {
            SSLConnectionSocketFactory sslSocketFactory = createUnsecureSocketFactory();
            try (CloseableHttpClient httpClient = HttpClientBuilder.create().setSSLSocketFactory(sslSocketFactory).build())
            {
                URIBuilder uriBuilder = new URIBuilder(getUriBase());
                uriBuilder.setParameter("language", "unk");
                uriBuilder.setParameter("detectOrientation", "true");
                // Request parameters.
                URI uri = uriBuilder.build();
                HttpPost request = new HttpPost(uri);                 
                // Request headers.
                request.setHeader("Content-Type", "application/octet-stream");
                request.setHeader("Ocp-Apim-Subscription-Key", getSubscriptionKey());
                request.setHeader("Accept", "application/json");
                // Request body.              
                InputStreamEntity requestEntity = new InputStreamEntity(imageStream, ContentType.create("application/octet-stream"));
                request.setEntity(requestEntity);
                String stringResponse = null;
                try
                {
                    // Call the REST API method and get the response entity.
                    HttpResponse response = httpClient.execute(request);
                    HttpEntity entity = response.getEntity();
                    if (entity != null) 
                    {
                        // Format and display the JSON response.
                        stringResponse = EntityUtils.toString(entity);

                        System.out.println("REST Response:\n");
                        System.out.println(stringResponse);
                    }
                }
                catch (java.lang.Exception ex)
                {
                    // MS Azure Cognintive services reports 400 Bad requests and other exceptions on small pictures and pictures with no text
                    System.out.println("Microsoft Azure Cognitive Services consider this image as wrong: " + ex.toString());
                } 
                if (stringResponse != null) {
                    return createDtoFromResponse(new JSONObject(stringResponse));
                }
            }
        }
        catch (java.lang.Exception ex)
        {
            System.out.println("Microsoft Azure Cognitive Services Text Recognition failed: " + ex.toString());
        }
        return new RecognizedImage(new TextLine[0]);
    }

    private SSLConnectionSocketFactory createUnsecureSocketFactory() throws Exception
    {
        TrustManager[] trustAllCerts = new TrustManager[]{
            new X509TrustManager() 
            {
                public X509Certificate[] getAcceptedIssuers() {
                    return null;
                }

                public void checkServerTrusted(X509Certificate[] arg0, String arg1)
                        throws CertificateException {
                }

                public void checkClientTrusted(X509Certificate[] arg0, String arg1)
                        throws CertificateException {
                }
            }};
        SSLContext context = SSLContext.getInstance("TLS");
        context.init(null, trustAllCerts, new SecureRandom());            
        SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(context,          
            new String[] { "TLSv1.2" },                                            
            null, 
            new HostnameVerifier() {
                @Override
                public boolean verify(String arg0, SSLSession arg1) {
                    return true;
                }
            });
        return sslSocketFactory;
    }

    private RecognizedImage createDtoFromResponse(JSONObject jToken)
    {
        // Parse json response to extract lines and words with the bounding rectangles.
    }

    ...
}
```
The service returns a JSON-serialized with text regions and recognized words, each word with its bounding rectangle.

You can find full implementation and an example of its usage here [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use redaction policies

Path: /redaction/java/use-redaction-policies/

If you have a corporate sensitive data removal policy as a list of redaction rules, you don't need to specify them in your code. You can specify an XML document with a list of pre-configured redactions.

Below is an example of redaction policy XML file (code properties mapping is obvious):

**RedactionPolicy.xml**

```java
<?xml version="1.0" encoding="utf-8"?>  
<redactionPolicy xmlns="http://www.groupdocs.com/redaction">  
  <regexRedaction regularExpression="(dolor)" actionType="ReplaceString" replacement="foobar" />  
  <exactPhraseRedaction searchPhrase="dolor" caseSensitive="true" actionType="DrawBox" color="Red" />   
  
  <cellColumnRedaction regularExpression="(foo)bar1" replacement="[red1]" columnIndex="1" worksheetIndex="2" /> 
  <cellColumnRedaction regularExpression="(foo)bar2" replacement="[red2]" wokrsheetName="Sample" /> 
  
  <eraseMetadataRedaction filter="All" />  
  <metadataSearchRedaction filter="Title, Author" replacement="foobar" valueExpression="(metasearch)" keyExpression="" />  
  
  <annotationRedaction regularExpression="(anno1)" replacement="foobar" />  
  <deleteAnnotationRedaction regularExpression="(anno2)" />  
  
  <imageAreaRedaction pointX="15" pointY="17" width="200" height="10" color="#AA50FC"  />  
  <imageAreaRedaction pointX="110" pointY="120" width="60" height="20" color="Magenta"  />  
</redactionPolicy> 
```
You can use RedactionPolicy.save() method to create XML documents of this structure, configuring redactions in runtime.

The following example demonstrates how to save a *RedactionPolicy* to an XML file.

```java
RedactionPolicy policy = new RedactionPolicy(new Redaction[] {
    new ExactPhraseRedaction("Redaction", new ReplacementOptions("[Product]")),
    new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", new ReplacementOptions(java.awt.Color.BLUE)),
    new DeleteAnnotationRedaction(),
    new EraseMetadataRedaction(MetadataFilters.All)
});
policy.save("MyPolicyFile.xml");
```

You can have as much policies, as you need, loading them to redact your documents.

An example below shows how to apply redaction policy to all files within given inbound folder, and save to one of outbound folders - for successfully updated files and for failed ones. Current date and time is used as a part of output file name:



```java
RedactionPolicy policy = RedactionPolicy.load("Policy_file.xml");
for (final File fileEntry : new File("\Inbound\").listFiles())
{
    final Redactor redactor  = new Redactor(fileEntry.getPath());
    try 
    {
        //Apply redaction 
        RedactorChangeLog result = redactor.apply(policy);
                    
        // Set the output directory path, it is supposed that all folders exist
        File resultFolder = new File(result.getStatus() != RedactionStatus.Failed ? "Done" : "Failed");
                    
        // Save the ouput files after applying redactions
        final FileOutputStream fileStream = new FileOutputStream(resultFolder.getPath() + fileEntry.getName());
        try 
        {
               RasterizationOptions options = new  RasterizationOptions();
               options.setEnabled(false);
               redactor.save(fileStream,options);
        }
        finally { fileStream.close(); }
     }
     finally { redactor.close(); }
 }
```

---

## Use redaction policies

Path: /redaction/net/use-redaction-policies/

If you have a corporate sensitive data removal policy as a list of redaction rules, you don't need to specify them in your code. You can specify an XML document with a list of pre-configured redactions.

Below is an example of redaction policy XML file (code properties mapping is obvious):

**RedactionPolicy.xml**

```csharp
<?xml version="1.0" encoding="utf-8"?>  
<redactionPolicy xmlns="http://www.groupdocs.com/redaction">  
  <regexRedaction regularExpression="(dolor)" actionType="ReplaceString" replacement="foobar" />  
  <exactPhraseRedaction searchPhrase="dolor" caseSensitive="true" actionType="DrawBox" color="Red" />   
  
  <cellColumnRedaction regularExpression="(foo)bar1" replacement="[red1]" columnIndex="1" worksheetIndex="2" /> 
  <cellColumnRedaction regularExpression="(foo)bar2" replacement="[red2]" wokrsheetName="Sample" /> 
  
  <eraseMetadataRedaction filter="All" />  
  <metadataSearchRedaction filter="Title, Author" replacement="foobar" valueExpression="(metasearch)" keyExpression="" />  
  
  <annotationRedaction regularExpression="(anno1)" replacement="foobar" />  
  <deleteAnnotationRedaction regularExpression="(anno2)" />  
  
  <imageAreaRedaction pointX="15" pointY="17" width="200" height="10" color="#AA50FC"  />  
  <imageAreaRedaction pointX="110" pointY="120" width="60" height="20" color="Magenta"  />  
</redactionPolicy> 
```
You can use RedactionPolicy.Save() method to create XML documents of this structure, configuring redactions in runtime.

The following example demonstrates how to save a [RedactionPolicy](https://reference.groupdocs.com/redaction/net/groupdocs.redaction/redactionpolicy) to an XML file.
 
**C#**

```csharp
RedactionPolicy policy = new RedactionPolicy(new Redaction[] {
    new ExactPhraseRedaction("Redaction", new ReplacementOptions("[Product]")),
    new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", new ReplacementOptions(System.Drawing.Color.Blue)),
    new DeleteAnnotationRedaction(),
    new EraseMetadataRedaction(MetadataFilters.All)
});
policy.Save(".\\MyPolicyFile.xml");
```

You can have as much policies, as you need, loading them to redact your documents.

An example below shows how to apply redaction policy to all files within given inbound folder, and save to one of outbound folders - for successfully updated files and for failed ones. Current date and time is used as a part of output file name:

**C#**

```csharp
RedactionPolicy policy = RedactionPolicy.Load("RedactionPolicy.xml");
foreach (var fileEntry in Directory.GetFileNames("C:\\Inbound")) 
{
    using (Redactor redactor = new Redactor(Path.Combine("C:\\Inbound\\", fileEntry)))
	{
    	RedactorChangeLog result = redactor.Apply(policy);
        String resultFolder = result.Status != RedactionStatus.Failed ? "C:\\Outbound\\Done\\" : "C:\\Outbound\\Failed\\";
		using (Stream fileStream = File.Open(Path.Combine(resultFolder, fileEntry), FileMode.Open, FileAccess.ReadWrite))
   		{
      		redactor.Save(fileStream, new RasterizationOptions() { Enabled = false });
   		}        
	}
}   
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use redaction policies

Path: /redaction/python-net/use-redaction-policies/

If you have a corporate sensitive data removal policy as a list of redaction rules, you don't need to specify them in your code. You can specify an XML document with a list of pre-configured redactions.

Below is an example of redaction policy XML file (code properties mapping is obvious):

**RedactionPolicy.xml**

```python
<?xml version="1.0" encoding="utf-8"?>  
<redactionPolicy xmlns="http://www.groupdocs.com/redaction">  
  <regexRedaction regularExpression="(dolor)" actionType="ReplaceString" replacement="foobar" />  
  <exactPhraseRedaction searchPhrase="dolor" caseSensitive="true" actionType="DrawBox" color="Red" />   
  
  <eraseMetadataRedaction filter="All" />  
  <metadataSearchRedaction filter="Title, Author" replacement="foobar" valueExpression="(metasearch)" keyExpression="" />  
  
  <annotationRedaction regularExpression="(anno1)" replacement="foobar" />  
  <deleteAnnotationRedaction regularExpression="(anno2)" />  
  
  <imageAreaRedaction pointX="15" pointY="17" width="200" height="10" color="#AA50FC"  />  
  <imageAreaRedaction pointX="110" pointY="120" width="60" height="20" color="Magenta"  />  
</redactionPolicy> 
```
You can use RedactionPolicy.save() method to create XML documents of this structure, configuring redactions in runtime.

The following example demonstrates how to save a [RedactionPolicy](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionpolicy/) to an XML file.
 
**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():
    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Configure Redactions
    redactions = [
        grr.ExactPhraseRedaction("Redaction", grr.ReplacementOptions("[Product]")),
        grr.RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", grr.ReplacementOptions(color)),
        grr.DeleteAnnotationRedaction(),
        grr.EraseMetadataRedaction(grr.MetadataFilters.ALL)
    ]

    # Create policy
    policy = gr.RedactionPolicy(redactions)

    # Save RedactionPolicy
    policy.save("sample_policy.xml")
```

You can have as much policies, as you need, loading them to redact your documents.

An example below shows how to apply redaction policy to all files within given inbound folder, and save to one of outbound folders - for successfully updated files and for failed ones. Current date and time is used as a part of output file name:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import os
from os.path import join

def run():

    # Initialize RedactionPolicy
    policy = gr.RedactionPolicy.load("sample_policy.xml")

    for file_entry in os.listdir("\inbound_dir"):
        cur_file = os.path.join("\inbound_dir", file_entry)

        # Load the document to be redacted
        with gr.Redactor(cur_file) as redactor:

            # Apply the redaction
            result = redactor.apply(policy)

            # Get output folder
            result_dir = "\out_bound_done_dir"
            if (result.status == gr.RedactionStatus.FAILED):
                result_dir = "\out_bound_failed_dir"

            output_file = join(result_dir, os.path.basename(cur_file))

            # Save file
            ro = gro.RasterizationOptions()
            ro.enabled = False
            with open(output_file, "wb") as stream_out:
                redactor.save(stream_out, ro)
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Watermarks in PDF document

Path: /watermark/net/watermarks-in-pdf-document/


Learn about how many ways the Groupdocs.watermark can add watermarks in PDF documents.

## XObjects

When *[Add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/add)* method of *[Watermarker](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker)* class is called, simple XObject is added to a PDF document.

{{< alert style="info" >}}
**PDF Reference 1.7**  

An external object (commonly called an XObject) is a graphics object whose contents are defined by a self-contained content stream, separate from the content stream in which it is used. There are three types of external objects:

* An image XObject represents a sampled visual image such as a photograph.
* A form XObject is a self-contained description of an arbitrary sequence of graphics objects.
* A PostScript XObject contains a fragment of code expressed in the PostScript page description language. PostScript XObjects are no longer recommended.
{{< /alert >}}

Image XObject and Form XObject are used by GroupDocs.Watermark API to add [ImageWatermark](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/imagewatermark) and [TextWatermark](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarks/textwatermark) respectively. XObjects are considered as a page real content, therefore, they are not removed by Adobe Acrobat during document sanitization.

## Artifacts

{{< alert style="info" >}}
**PDF Reference 1.7**
The graphics objects in a document can be divided into two classes:

* The real content of a document comprises objects representing material originally introduced by the document’s author.
* Artifacts are graphics objects that are typically not part of the author’s original content but rather are generated by the PDF producer application in the course of pagination, layout, or other strictly mechanical processes. Artifacts may also be used to describe areas of the document where the author uses a graphical background, with the goal of enhancing the visual experience. In such a case, the background is not required for understanding the content.
{{< /alert >}}

According to artifact definition, the watermark can be represented by an artifact in a PDF document. The following example shows how artifact watermark can be added to a document with GroupDocs.Watermark using [PdfArtifactWatermarkOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.pdf/pdfartifactwatermarkoptions).

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfAddArtifactWatermark**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfArtifactWatermarkOptions options = new PdfArtifactWatermarkOptions();
    // Add text watermark
    TextWatermark textWatermark = new TextWatermark("This is an artifact watermark", 
        new Font("Arial", 8));
    textWatermark.HorizontalAlignment = HorizontalAlignment.Right;
    watermarker.Add(textWatermark, options);
    // Add image watermark
    using (ImageWatermark imageWatermark = new ImageWatermark("logo.bmp"))
    {
        watermarker.Add(imageWatermark, options);
    }
    watermarker.Save("document.pdf");
}
```

## Annotations

{{< alert style="info" >}}
**PDF Reference 1.7**
An annotation associates an object such as a note, sound, or movie with a location on a page of a PDF document, or provides a way to interact with the user by means of the mouse and keyboard. PDF includes a wide variety of standard annotation types.
A watermark annotation (PDF 1.6) is used to represent graphics that are expected to be printed at a fixed size and position on a page, regardless of the dimensions of the printed page.
{{< /alert >}}

Annotation is the third type of PDF entities by which a watermark can be represented. Use the following code snippet to add watermark annotation to a PDF document using [PdfAnnotationWatermarkOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.pdf/pdfannotationwatermarkoptions).

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfAddAnnotationWatermark**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    PdfAnnotationWatermarkOptions options = new PdfAnnotationWatermarkOptions();
    // Add text watermark
    TextWatermark textWatermark = new TextWatermark("This is a annotation watermark", 
        new Font("Arial", 8));
    textWatermark.HorizontalAlignment = HorizontalAlignment.Left;
    textWatermark.VerticalAlignment = VerticalAlignment.Top;
    watermarker.Add(textWatermark, options);
    // Add image watermark
    using (ImageWatermark imageWatermark = new ImageWatermark("protect.jpg"))
    {
        imageWatermark.HorizontalAlignment = HorizontalAlignment.Right;
        imageWatermark.VerticalAlignment = VerticalAlignment.Top;
        watermarker.Add(imageWatermark, options);
    }

    watermarker.Save("document.pdf");
}
```

## Print-only annotations  

You can also add print only annotation watermark to the document setting [PrintOnly](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.pdf/pdfannotationwatermarkoptions/properties/printonly) property of [PdfAnnotationWatermarkOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.pdf/pdfannotationwatermarkoptions). The following code demonstrates this approach.

**AdvancedUsage.AddingWatermarks.AddWatermarksToPdf.PdfAddPrintOnlyAnnotationWatermark**

```csharp
PdfLoadOptions loadOptions = new PdfLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.pdf"
using (Watermarker watermarker = new Watermarker("document.pdf", loadOptions))
{
    TextWatermark textWatermark = new TextWatermark("This is a print only test watermark. It won't appear in view mode.", new Font("Arial", 8));
    bool isPrintOnly = true;

    // Annotation will be printed, but not displayed in pdf viewing application
    PdfAnnotationWatermarkOptions options = new PdfAnnotationWatermarkOptions();
    options.PageIndex = 0;
    options.PrintOnly = isPrintOnly;

    watermarker.Add(textWatermark, options);
    watermarker.Save("document.pdf");
}
```

---

## Watermarks in PDF document

Path: /watermark/python-net/watermarks-in-pdf-document/


Learn the ways GroupDocs.Watermark adds watermarks in PDF documents.

## XObjects

When `add` on `Watermarker` is called, a simple XObject is added to the PDF.

Image XObject and Form XObject are used to add `ImageWatermark` and `TextWatermark` respectively. XObjects are page real content and are not removed by Adobe Acrobat sanitization.

## Artifacts

Watermarks can be represented by artifacts. Add an artifact watermark using `PdfArtifactWatermarkOptions`.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.options.pdf as gwo_pdf
import groupdocs.watermark.common as gwc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    options = gwo_pdf.PdfArtifactWatermarkOptions()

    text_watermark = gww.TextWatermark("This is an artifact watermark", gww.Font("Arial", 8.0))
    text_watermark.horizontal_alignment = gwc.HorizontalAlignment.RIGHT
    watermarker.add(text_watermark, options)

    with gww.ImageWatermark("logo.bmp") as image_watermark:
        watermarker.add(image_watermark, options)

    watermarker.save("document.pdf")
```

## Annotations

Add annotation watermarks using `PdfAnnotationWatermarkOptions`.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.contents.pdf as gwc_pdf
import groupdocs.watermark.options.pdf as gwo_pdf
import groupdocs.watermark.common as gwc

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    options = gwo_pdf.PdfAnnotationWatermarkOptions()

    text_watermark = gww.TextWatermark("This is a annotation watermark", gww.Font("Arial", 8.0))
    text_watermark.horizontal_alignment = gwc.HorizontalAlignment.LEFT
    text_watermark.vertical_alignment = gwc.VerticalAlignment.TOP
    watermarker.add(text_watermark, options)

    with gww.ImageWatermark("protect.jpg") as image_watermark:
        image_watermark.horizontal_alignment = gwc.HorizontalAlignment.RIGHT
        image_watermark.vertical_alignment = gwc.VerticalAlignment.TOP
        watermarker.add(image_watermark, options)

    watermarker.save("document.pdf")
```

## Print-only annotations

Make an annotation print-only using `print_only`.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.pdf as gwo_pdf

load_options = gw.PdfLoadOptions()
with gw.Watermarker("document.pdf", load_options) as watermarker:
    text_watermark = gww.TextWatermark(
        "This is a print only test watermark. It won't appear in view mode.",
        gww.Font("Arial", 8.0),
    )

    options = gwo_pdf.PdfAnnotationWatermarkOptions()
    options.page_index = 0
    options.print_only = True

    watermarker.add(text_watermark, options)
    watermarker.save("document.pdf")
```



---

## Watermarks in word processing document

Path: /watermark/net/watermarks-in-word-processing-document/

When adding watermark in Microsoft Word application, it places a shape with appropriate content in section headers. GroupDocs.Watermark API uses the same approach. When calling *[Add](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/methods/add)* method of *[Watermarker](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker)* class, the shape is added to a document.

## Using properties of [WordProcessingWatermarkBaseOptions](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkbaseoptions)

You can also set some additional options ([Name](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkbaseoptions/properties/name) or [AlternativeText](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingwatermarkbaseoptions/properties/alternativetext)) when adding shape watermark to a Word document using GroupDocs.Watermark. Following code samples demonstrates it.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingAddWatermarkWithShapeSettings**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 19));

    //Some settings for watermark
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.RotateAngle = 25.0;
    watermark.ForegroundColor = Color.Red;
    watermark.Opacity = 1.0;

    WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();

    // Set the shape name
    options.Name = "Shape 1";

    // Set the descriptive (alternative) text that will be associated with the shape
    options.AlternativeText = "Test watermark";

    watermarker.Add(watermark, options);
    watermarker.Save("document.docx");
}
```

## Using [WordProcessingTextEffects](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingtexteffects)

You can also apply some text effects to the shape watermarks as shown in the below code.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingAddWatermarkWithTextEffects**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 19));

    WordProcessingTextEffects effects = new WordProcessingTextEffects();
    effects.LineFormat.Enabled = true;
    effects.LineFormat.Color = Color.Red;
    effects.LineFormat.DashStyle = OfficeDashStyle.DashDotDot;
    effects.LineFormat.LineStyle = OfficeLineStyle.Triple;
    effects.LineFormat.Weight = 1;

    WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();
    options.Effects = effects;

    watermarker.Add(watermark, options);
    watermarker.Save("document.docx");
}
```

## Using [WordProcessingImageEffects](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.options.wordprocessing/wordprocessingimageeffects)

GroupDocs.Watermark also provides the facility to apply image effects to the shape watermarks.

**AdvancedUsage.AddingWatermarks.AddWatermarksToWordProcessing.WordProcessingAddWatermarkWithImageEffects**

```csharp
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\document.docx"
using (Watermarker watermarker = new Watermarker("document.docx", loadOptions))
{
    using (ImageWatermark watermark = new ImageWatermark("logo.png"))
    {
        WordProcessingImageEffects effects = new WordProcessingImageEffects();
        effects.Brightness = 0.7;
        effects.Contrast = 0.6;
        effects.ChromaKey = Color.Red;
        effects.BorderLineFormat.Enabled = true;
        effects.BorderLineFormat.Weight = 1;

        WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();
        options.Effects = effects;

        watermarker.Add(watermark, options);
    }

    watermarker.Save("document.docx");
}
```

---

## Watermarks in word processing document

Path: /watermark/python-net/watermarks-in-word-processing-document/


When adding a watermark in Microsoft Word, a shape with appropriate content is placed in section headers. GroupDocs.Watermark uses the same approach. When calling `add` on `Watermarker`, a shape is added to the document.

## Using properties of WordProcessingWatermarkBaseOptions
This sample sets additional shape watermark properties such as name and alternative text when inserting it.

Set additional options like `name` and `alternative_text` when adding a shape watermark.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp
import groupdocs.watermark.common as gwc

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Test watermark", gww.Font("Arial", 19.0))
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.rotate_angle = 25.0
    watermark.foreground_color = gww.Color.red
    watermark.opacity = 1.0

    options = gwo_wp.WordProcessingWatermarkSectionOptions()
    options.name = "Shape 1"
    options.alternative_text = "Test watermark"

    watermarker.add(watermark, options)
    watermarker.save("document.docx")
```

## Using WordProcessingTextEffects
This sample enables and configures line and outline effects for text-based shape watermarks.

Apply text effects to shape watermarks.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp
import groupdocs.watermark.common as gwc

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Test watermark", gww.Font("Arial", 19.0))

    effects = gwo_wp.WordProcessingTextEffects()
    effects.line_format.enabled = True
    effects.line_format.color = gww.Color.red
    effects.line_format.dash_style = gwc.OfficeDashStyle.DASH_DOT_DOT
    effects.line_format.line_style = gwc.OfficeLineStyle.TRIPLE
    effects.line_format.weight = 1

    options = gwo_wp.WordProcessingWatermarkSectionOptions()
    options.effects = effects

    watermarker.add(watermark, options)
    watermarker.save("document.docx")
```

## Using WordProcessingImageEffects
This sample applies image effects (brightness, contrast, chroma key, border) to image-based shape watermarks.

Apply image effects to image-based shape watermarks.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    with gww.ImageWatermark("logo.png") as watermark:
        effects = gwo_wp.WordProcessingImageEffects()
        effects.brightness = 0.7
        effects.contrast = 0.6
        effects.chroma_key = gww.Color.red
        effects.border_line_format.enabled = True
        effects.border_line_format.weight = 1

        options = gwo_wp.WordProcessingWatermarkSectionOptions()
        options.effects = effects

        watermarker.add(watermark, options)

    watermarker.save("document.docx")
```



---

## Working with Containers

Path: /parser/python-net/working-with-containers/


Container-aware parsing lets you open archive-like formats (ZIP, RAR, 7z, TAR), Outlook stores (PST/OST), PDF portfolios, and email attachments, then process their contents using the same parser API.

## Iterate nested items safely
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.exceptions import UnsupportedDocumentFormatException

def print_text(item_path, parser):
    reader = parser.get_text()
    print(f"{item_path}: {reader if reader else '[no text]'}")

with Parser("portfolio.pdf") as parser:
    container = parser.get_container()
    if container is None:
        print("Container extraction isn't supported for this format.")
    else:
        for item in container:
            try:
                with item.open_parser() as inner_parser:
                    print_text(item.file_path, inner_parser)
            except UnsupportedDocumentFormatException:
                print(f"{item.file_path}: format is not supported.")
```

{{< /tab >}}
{{< tab "portfolio.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [portfolio.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-archives/working-with-containers/portfolio.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Tips

- Containers can be nested; call `open_parser()` recursively when needed.  
- Use `item.file_type` and `item.metadata` (when available) to decide how to process each attachment.  
- If `get_container()` returns `None`, the format does not expose attachments; continue with other extraction methods.


---

## Working with Email Messages

Path: /assembly/java/working-with-email-messages/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}

## Working with Email Messages

GroupDocs.Assembly allows you to use data bands in table rows in **Email Messages** with HTML and RTF bodies. A table-row data band is a data band whose body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in email messages is as follows:

| **Client**                               | **Manager**         | **Contract Price**                          |
| ---------------------------------------- | ------------------- | ------------------------------------------- |
| **<<foreach [c in ds]>> <<[c.Client]>>** | **<<[c.Manager]>>** | **<<[c.Contact_Price]>> &lt;&lt;foreach>>** |

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block whose body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

<table class="confluenceTable"><tbody><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;if ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;elseif ...&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&lt;&lt;else&gt;&gt; ...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>...</strong></p></td><td class="confluenceTd"><p><strong>... &lt;&lt;/if&gt;&gt;</strong></p></td></tr><tr><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p></td><td class="confluenceTd"><p><strong>&nbsp;</strong></p><div><strong><br></strong></div></td></tr></tbody></table>
{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Working%20With%20Table%20Row%20Data%20Bands.msg)

### The Code

{{< gist GroupDocsGists 532bfbe19af4f2bb74f2ef236bc3a822 >}}



---

## Working with Email Messages

Path: /assembly/net/working-with-email-messages/

{{< alert style="info" >}}This feature is supported by version 18.2 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Working with Email Messages

GroupDocs.Assembly allows you to use data bands in table rows in **Email Messages**with HTML and RTF bodies. A table-row data band is a data band which body occupies single or multiple rows of a single document table. The body of such a band starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows. The syntax for using data bands in email messages is as follows:

<table class="gd-assembly">
	<tbody>
		<tr>
			<td>Manager</td>
			<td>Manager</td>
			<td>Contract Price</td>
		</tr>
		<tr>
			<td>&lt;&lt;foreach [c in ds]>>&lt;&lt;[c.Client]>></td>
			<td>&lt;&lt;[c.Manager]>></td>
			<td>&lt;&lt;[c.Price]>>&lt;&lt;/foreach>></td>
		</tr>
	</tbody>
</table>

### Working with Table-Row Conditional Blocks

You can also use a table-row conditional block which body occupies single or multiple rows of a single document table. The body of such a block (as well as the body of its every template option) starts at the beginning of the first occupied row and ends at the end of the last occupied row as follows:

|                        |         |                 |
| ---------------------- | ------- | --------------- |
| **&lt;&lt;if ...>> ...**     | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;elseif ...>> ...** | **...** | **...**         |
| **...**                | **...** | **...**         |
| **&lt;&lt;else>> ...**       | **...** | **...**         |
| **...**                | **...** | **...**         |
| **...**                | **...** | **... &lt;&lt;/if>>** |
|                        |         |                 |

### Download

#### Data Source Document

*   [Managers Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Excel%20DataSource/Contracts%20Data.xlsx)

#### Template

*   [Working with Table Row Data Bands.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Working%20With%20Table%20Row%20Data%20Bands.pptx)

### The Code

{{< gist GroupDocsGists 01bfbc9025752c94f28e24a28c3cd6ad >}}



---

## Working with Form Fields

Path: /editor/java/working-with-form-fields/



This article demonstrates how to load, edit, and read form fields in a Word document using GroupDocs.Editor for Java. We will go through the process of opening a document, retrieving form fields, and processing them based on their types.


#### Step-by-Step Guide

1. **Get the Path to the Input File**

2. **Create a InputStream from the Path**

   Create a `InputStream` from the input file path.

   ```java
   InputStream fs = new FileInputStream(inputFilePath);
   {
       // Further code will be placed here
   }
   ```

3. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```java
   WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
   loadOptions.setPassword("some_password_to_open_a_document)";
   ```

4. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```java
   Editor editor = new Editor(fs, loadOptions);
   {
       // Further code will be placed here
   }
   ```

5. **Retrieve and Process the Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor`. Use it to read the `FormFieldCollection` and process each form field based on its type.

   ```java
        FormFieldManager fieldManager = editor.getFormFieldManager();
        FormFieldCollection collection = fieldManager.getFormFieldCollection();
        for (IFormField formField : collection)
        {
            switch (formField.getType())
            {
                case FormFieldType.Text:
                    TextFormField textFormField = collection.getFormField(formField.getName(),TextFormField.class);
                    System.out.println("TextFormField detected, name: "+formField.getName()+", value: "+ textFormField.getValue());
                    break;
                case FormFieldType.CheckBox:
                    CheckBoxForm checkBoxFormField = collection.getFormField(formField.getName(),CheckBoxForm.class);
                    System.out.println("CheckBoxForm detected, name: "+formField.getName()+", value: "+ checkBoxFormField.getValue());
                    break;
                case FormFieldType.Date:
                    DateFormField dateFormField = collection.getFormField(formField.getName(),DateFormField.class);
                    System.out.println("DateFormField detected, name: "+formField.getName()+", value: "+ dateFormField.getValue());
                    break;
                case FormFieldType.Number:
                    NumberFormField numberFormField = collection.getFormField(formField.getName(),NumberFormField.class);
                    System.out.println("NumberFormField detected, name: "+formField.getName()+", value: "+ numberFormField.getValue());
                    break;
                case FormFieldType.DropDown:
                    DropDownFormField dropDownFormField = collection.getFormField(formField.getName(),DropDownFormField.class);
                    System.out.println("DropDownFormField detected, name: "+formField.getName()+", value selected: "+ dropDownFormField.getValue().get(dropDownFormField.getSelectedIndex()));
                    break;
            }
        }
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```java
/**
  * This example demonstrates loading a FormFieldCollection and reading form fields.
  */
public class LegacyFormFieldCollection {
   /**
    * Runs the example to demonstrate loading, editing, and reading form fields from a document.
    */
    public static void run() throws Exception
    {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample Docx with form fields.
        String inputFilePath = Constants.SampleLegacyFormFields_docx;

        // 2. Create a stream from this path
        InputStream fs = new FileInputStream(inputFilePath);

        // 3. Create load options for this document
        WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
        // 3.1. In case the input document is password-protected, we can specify a password for its opening...
        loadOptions.setPassword("some_password_to_open_a_document");
        // 3.2. ...but, because the document is unprotected, this password will be ignored

        // 4. Load the document with options to the Editor instance
        Editor editor = new Editor(fs, loadOptions);

        // 4.1. Read the FormFieldManager instance
        FormFieldManager fieldManager = editor.getFormFieldManager();
        // 4.2. Read the FormFieldCollection in the document
        FormFieldCollection collection = fieldManager.getFormFieldCollection();
        for (IFormField formField : collection)
        {
            switch (formField.getType())
            {
                case FormFieldType.Text:
                    TextFormField textFormField = collection.getFormField(formField.getName(),TextFormField.class);
                    System.out.println("TextFormField detected, name: "+formField.getName()+", value: "+ textFormField.getValue());
                    break;
                case FormFieldType.CheckBox:
                    CheckBoxForm checkBoxFormField = collection.getFormField(formField.getName(),CheckBoxForm.class);
                    System.out.println("CheckBoxForm detected, name: "+formField.getName()+", value: "+ checkBoxFormField.getValue());
                    break;
                case FormFieldType.Date:
                    DateFormField dateFormField = collection.getFormField(formField.getName(),DateFormField.class);
                    System.out.println("DateFormField detected, name: "+formField.getName()+", value: "+ dateFormField.getValue());
                    break;
                case FormFieldType.Number:
                    NumberFormField numberFormField = collection.getFormField(formField.getName(),NumberFormField.class);
                    System.out.println("NumberFormField detected, name: "+formField.getName()+", value: "+ numberFormField.getValue());
                    break;
                case FormFieldType.DropDown:
                    DropDownFormField dropDownFormField = collection.getFormField(formField.getName(),DropDownFormField.class);
                    System.out.println("DropDownFormField detected, name: "+formField.getName()+", value selected: "+ dropDownFormField.getValue().get(dropDownFormField.getSelectedIndex()));
                    break;
            }
        }

        System.out.println("ReadFormFieldCollection routine has successfully finished");
    }
}
```

### Conclusion

This guide demonstrates how to work with form fields in Word documents using GroupDocs.Editor for Java. By following these steps, you can load a document, retrieve form fields, and process them based on their types. This functionality is essential for applications that require manipulation and extraction of form field data from documents.
---

## Working with Form Fields

Path: /editor/net/working-with-form-fields/



This article demonstrates how to load, edit, and read form fields in a Word document using GroupDocs.Editor for .NET. We will go through the process of opening a document, retrieving form fields, and processing them based on their types.


#### Step-by-Step Guide

1. **Get the Path to the Input File**

2. **Create a Stream from the Path**

   Create a `FileStream` from the input file path.

   ```csharp
   using (FileStream fs = File.OpenRead(inputFilePath))
   {
       // Further code will be placed here
   }
   ```

3. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```csharp
   WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
   loadOptions.Password = "some_password_to_open_a_document";
   ```

4. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```csharp
   using (Editor editor = new Editor(fs, loadOptions))
   {
       // Further code will be placed here
   }
   ```

5. **Retrieve and Process the Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor`. Use it to read the `FormFieldCollection` and process each form field based on its type.

   ```csharp
   FormFieldManager fieldManager = editor.FormFieldManager;
   FormFieldCollection collection = fieldManager.FormFieldCollection;

   foreach (var formField in collection)
   {
       switch (formField.Type)
       {
           case FormFieldType.Text:
               TextFormField textFormField = collection.GetFormField<TextFormField>(formField.Name);
               System.Console.WriteLine("TextFormField detected, name: {0}, value: {1}", formField.Name, textFormField.Value);
               break;

           case FormFieldType.CheckBox:
               CheckBoxForm checkBoxFormField = collection.GetFormField<CheckBoxForm>(formField.Name);
               System.Console.WriteLine("CheckBoxForm detected, name: {0}, value: {1}", formField.Name, checkBoxFormField.Value);
               break;

           case FormFieldType.Date:
               DateFormField dateFormField = collection.GetFormField<DateFormField>(formField.Name);
               System.Console.WriteLine("DateFormField detected, name: {0}, value: {1}", formField.Name, dateFormField.Value);
               break;

           case FormFieldType.Number:
               NumberFormField numberFormField = collection.GetFormField<NumberFormField>(formField.Name);
               System.Console.WriteLine("NumberFormField detected, name: {0}, value: {1}", formField.Name, numberFormField.Value);
               break;

           case FormFieldType.DropDown:
               DropDownFormField dropDownFormField = collection.GetFormField<DropDownFormField>(formField.Name);
               System.Console.WriteLine("DropDownFormField detected, name: {0}, value selected: {1}", formField.Name, dropDownFormField.Value[dropDownFormField.SelectedIndex]);
               break;
       }
   }
   ```

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```csharp
/// <summary>
/// This example demonstrates loading a FormFieldCollection and reading form fields.
/// </summary>
internal static class LegacyFormFieldCollection
{
    /// <summary>
    /// Runs the example to demonstrate loading, editing, and reading form fields from a document.
    /// </summary>
    internal static void Run()
    {
        // 1. Get a path to the input file (or stream with file content).
        // In this case, it is a sample Docx with form fields.
        string inputFilePath = Constants.SampleLegacyFormFields_docx;

        // 2. Create a stream from this path
        using (FileStream fs = File.OpenRead(inputFilePath))
        {
            // 3. Create load options for this document
            WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
            // 3.1. In case the input document is password-protected, we can specify a password for its opening...
            loadOptions.Password = "some_password_to_open_a_document";
            // 3.2. ...but, because the document is unprotected, this password will be ignored

            // 4. Load the document with options to the Editor instance
            using (Editor editor = new Editor(fs, loadOptions))
            {
                // 4.1. Read the FormFieldManager instance
                FormFieldManager fieldManager = editor.FormFieldManager;
                // 4.2. Read the FormFieldCollection in the document
                FormFieldCollection collection = fieldManager.FormFieldCollection;

                foreach (var formField in collection)
                {
                    switch (formField.Type)
                    {
                        case FormFieldType.Text:
                            TextFormField textFormField = collection.GetFormField<TextFormField>(formField.Name);
                            System.Console.WriteLine("TextFormField detected, name: {0}, value: {1}", formField.Name, textFormField.Value);
                            break;

                        case FormFieldType.CheckBox:
                            CheckBoxForm checkBoxFormField = collection.GetFormField<CheckBoxForm>(formField.Name);
                            System.Console.WriteLine("CheckBoxForm detected, name: {0}, value: {1}", formField.Name, checkBoxFormField.Value);
                            break;

                        case FormFieldType.Date:
                            DateFormField dateFormField = collection.GetFormField<DateFormField>(formField.Name);
                            System.Console.WriteLine("DateFormField detected, name: {0}, value: {1}", formField.Name, dateFormField.Value);
                            break;

                        case FormFieldType.Number:
                            NumberFormField numberFormField = collection.GetFormField<NumberFormField>(formField.Name);
                            System.Console.WriteLine("NumberFormField detected, name: {0}, value: {1}", formField.Name, numberFormField.Value);
                            break;

                        case FormFieldType.DropDown:
                            DropDownFormField dropDownFormField = collection.GetFormField<DropDownFormField>(formField.Name);
                            System.Console.WriteLine("DropDownFormField detected, name: {0}, value selected: {1}", formField.Name, dropDownFormField.Value[dropDownFormField.SelectedIndex]);
                            break;
                    }
                }
            }
        }
        System.Console.WriteLine("ReadFormFieldCollection routine has successfully finished");
    }
}
```

### Conclusion

This guide demonstrates how to work with form fields in Word documents using GroupDocs.Editor for .NET. By following these steps, you can load a document, retrieve form fields, and process them based on their types. This functionality is essential for applications that require manipulation and extraction of form field data from documents.
---

## Working with Form Fields

Path: /editor/nodejs-java/working-with-form-fields/


This article demonstrates how to load, edit, and read form fields in a Word document using **GroupDocs.Editor for Node.js via Java**. We will go through the process of opening a document, retrieving form fields, and processing them based on their types.

#### Step-by-Step Guide

1. **Get the Path to the Input File**

   Specify the path to your input Word document (`.docx`) that contains form fields.

   ```javascript
   const inputFilePath = 'path/to/your/document.docx';
   ```

2. **Create a Readable Stream from the Path**

   Create a readable stream from the input file path.

   ```javascript
   const fs = require('fs');
   const inputStream = fs.createReadStream(inputFilePath);
   ```

3. **Create Load Options**

   Initialize the `WordProcessingLoadOptions` for loading the document. If your document is password-protected, specify the password. In this example, the document is unprotected, so the password will be ignored.

   ```javascript
   const groupdocsEditor = require('groupdocs-editor');

   const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();
   loadOptions.setPassword('some_password_to_open_a_document');
   ```

4. **Load the Document into the Editor Instance**

   Use the `Editor` class to load the document with the specified load options.

   ```javascript
   const editor = new groupdocsEditor.Editor(inputStream, loadOptions);
   ```

5. **Retrieve and Process the Form Fields**

   Obtain the `FormFieldManager` instance from the `Editor`. Use it to read the `FormFieldCollection` and process each form field based on its type.

   ```javascript
   // Get the FormFieldManager instance
   const fieldManager = editor.getFormFieldManager();

   // Get the FormFieldCollection in the document
   const collection = fieldManager.getFormFieldCollection();

   // Iterate over each form field in the collection
   collection.forEach((formField) => {
       switch (formField.getType()) {
           case groupdocsEditor.FormFieldType.Text:
               const textFormField = collection.getFormField(formField.getName(), groupdocsEditor.TextFormField);
               console.log(`TextFormField detected, name: ${formField.getName()}, value: ${textFormField.getValue()}`);
               break;
           case groupdocsEditor.FormFieldType.CheckBox:
               const checkBoxFormField = collection.getFormField(formField.getName(), groupdocsEditor.CheckBoxForm);
               console.log(`CheckBoxForm detected, name: ${formField.getName()}, value: ${checkBoxFormField.getValue()}`);
               break;
           case groupdocsEditor.FormFieldType.Date:
               const dateFormField = collection.getFormField(formField.getName(), groupdocsEditor.DateFormField);
               console.log(`DateFormField detected, name: ${formField.getName()}, value: ${dateFormField.getValue()}`);
               break;
           case groupdocsEditor.FormFieldType.Number:
               const numberFormField = collection.getFormField(formField.getName(), groupdocsEditor.NumberFormField);
               console.log(`NumberFormField detected, name: ${formField.getName()}, value: ${numberFormField.getValue()}`);
               break;
           case groupdocsEditor.FormFieldType.DropDown:
               const dropDownFormField = collection.getFormField(formField.getName(), groupdocsEditor.DropDownFormField);
               const selectedValue = dropDownFormField.getValue()[dropDownFormField.getSelectedIndex()];
               console.log(`DropDownFormField detected, name: ${formField.getName()}, selected value: ${selectedValue}`);
               break;
           default:
               console.log(`Unknown form field type detected, name: ${formField.getName()}`);
       }
   });
   ```

   In this code:

   - We use the `getType()` method to determine the type of each form field.
   - Retrieve the specific form field instance using `getFormField()` with the appropriate class.
   - Access the properties of each form field and print them to the console.

### Complete Example Code

Below is the complete example code demonstrating the entire process:

```javascript
/**
 * This example demonstrates how to load, edit, and read form fields in a Word document using GroupDocs.Editor for Node.js via Java.
 */

// Import the necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

(async () => {
    try {
        // 1. Get the path to the input file (or stream with file content).
        // In this case, it is a sample DOCX with form fields.
        const inputFilePath = 'path/to/your/document.docx';

        // 2. Create a readable stream from this path
        const inputStream = fs.createReadStream(inputFilePath);

        // 3. Create load options for this document
        const loadOptions = new groupdocsEditor.WordProcessingLoadOptions();
        // 3.1. If the input document is password-protected, specify the password for its opening...
        loadOptions.setPassword('some_password_to_open_a_document');
        // 3.2. ...but, because the document is unprotected, this password will be ignored

        // 4. Load the document with options into the Editor instance
        const editor = new groupdocsEditor.Editor(inputStream, loadOptions);

        // 5. Retrieve and process the form fields
        // 5.1. Get the FormFieldManager instance
        const fieldManager = editor.getFormFieldManager();

        // 5.2. Get the FormFieldCollection in the document
        const collection = fieldManager.getFormFieldCollection();

        // 5.3. Iterate over each form field in the collection
        collection.forEach((formField) => {
            switch (formField.getType()) {
                case groupdocsEditor.FormFieldType.Text:
                    const textFormField = collection.getFormField(formField.getName(), groupdocsEditor.TextFormField);
                    console.log(`TextFormField detected, name: ${formField.getName()}, value: ${textFormField.getValue()}`);
                    break;
                case groupdocsEditor.FormFieldType.CheckBox:
                    const checkBoxFormField = collection.getFormField(formField.getName(), groupdocsEditor.CheckBoxForm);
                    console.log(`CheckBoxForm detected, name: ${formField.getName()}, value: ${checkBoxFormField.getValue()}`);
                    break;
                case groupdocsEditor.FormFieldType.Date:
                    const dateFormField = collection.getFormField(formField.getName(), groupdocsEditor.DateFormField);
                    console.log(`DateFormField detected, name: ${formField.getName()}, value: ${dateFormField.getValue()}`);
                    break;
                case groupdocsEditor.FormFieldType.Number:
                    const numberFormField = collection.getFormField(formField.getName(), groupdocsEditor.NumberFormField);
                    console.log(`NumberFormField detected, name: ${formField.getName()}, value: ${numberFormField.getValue()}`);
                    break;
                case groupdocsEditor.FormFieldType.DropDown:
                    const dropDownFormField = collection.getFormField(formField.getName(), groupdocsEditor.DropDownFormField);
                    const selectedValue = dropDownFormField.getValue()[dropDownFormField.getSelectedIndex()];
                    console.log(`DropDownFormField detected, name: ${formField.getName()}, selected value: ${selectedValue}`);
                    break;
                default:
                    console.log(`Unknown form field type detected, name: ${formField.getName()}`);
            }
        });

        console.log('Working with form fields routine has successfully finished.');
    } catch (error) {
        console.error('An error occurred:', error);
    }
})();
```

### Conclusion

This guide demonstrates how to work with form fields in Word documents using **GroupDocs.Editor for Node.js via Java**. By following these steps, you can load a document, retrieve form fields, and process them based on their types. This functionality is essential for applications that require manipulation and extraction of form field data from documents.

**Note:** Make sure to replace `'path/to/your/document.docx'` with the actual file path in your application.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.


---

## Working with worksheet headers and footers

Path: /watermark/net/working-with-worksheet-headers-and-footers/

## Extracting information about all headers and footers in an excel document

You can extract [information](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetworksheet/properties/headersfooters) about all the headers and footers in an Excel document as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetGetHeaderFooterInformation**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        foreach (SpreadsheetHeaderFooter headerFooter in worksheet.HeadersFooters)
        {
            Console.WriteLine(headerFooter.HeaderFooterType);
            foreach (SpreadsheetHeaderFooterSection section in headerFooter.Sections)
            {
                Console.WriteLine(section.SectionType);
                if (section.Image != null)
                {
                    Console.WriteLine(section.Image.Width);
                    Console.WriteLine(section.Image.Height);
                    Console.WriteLine(section.Image.GetBytes().Length);
                }

                Console.WriteLine(section.Script);
            }
        }
    }
}
```

## Clearing a particular header or footer

You can also clear a particular [header or footer](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetheaderfootersection) using GroupDocs.Watermark as shown in the below code sample.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetClearHeaderFooter**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetHeaderFooterSection section in content
        .Worksheets[0].HeadersFooters[OfficeHeaderFooterType.HeaderPrimary]
        .Sections)
    {
        section.Script = null;
        section.Image = null;
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

## Clearing a particular section of header or footer

Using GroupDocs.Watermark, you can also clear a particular section of [header or footer](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetheaderfootersection) as shown in the sample code below.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetClearSectionOfHeaderFooter**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    SpreadsheetHeaderFooterSection section = content.Worksheets[0]
        .HeadersFooters[OfficeHeaderFooterType.HeaderEven]
        .Sections[SpreadsheetHeaderFooterSectionType.Left];
        
    section.Image = null;
    section.Script = null;

    watermarker.Save("spreadsheet.xlsx");
}
```

## Adding watermark to all images in header and footer

GroupDocs.Watermark enables you to add watermark to [images](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.contents.spreadsheet/spreadsheetheaderfootersection/properties/image) inside any header or footer. You can use below code sample to achieve this.

**AdvancedUsage.AddingWatermarks.AddWatermarksToSpreadsheets.SpreadsheetAddWatermarkToImagesInHeaderFooter**

```csharp
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\spreadsheet.xlsx"
using (Watermarker watermarker = new Watermarker("spreadsheet.xlsx", loadOptions))
{
    // Initialize image or text watermark
    TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
    watermark.HorizontalAlignment = HorizontalAlignment.Center;
    watermark.VerticalAlignment = VerticalAlignment.Center;
    watermark.RotateAngle = 45;
    watermark.SizingType = SizingType.ScaleToParentDimensions;
    watermark.ScaleFactor = 1;

    SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
    foreach (SpreadsheetWorksheet worksheet in content.Worksheets)
    {
        foreach (SpreadsheetHeaderFooter headerFooter in worksheet.HeadersFooters)
        {
            foreach (SpreadsheetHeaderFooterSection section in headerFooter.Sections)
            {
                if (section.Image != null)
                {
                    // Add watermark to the image
                    section.Image.Add(watermark);
                }
            }
        }
    }

    watermarker.Save("spreadsheet.xlsx");
}
```

---

## Working with worksheet headers and footers

Path: /watermark/python-net/working-with-worksheet-headers-and-footers/


## Extracting information about all headers and footers in an Excel document
This sample enumerates all headers/footers and prints section details, including image stats and script content.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        for header_footer in worksheet.headers_footers:
            print(header_footer.header_footer_type)
            for section in header_footer.sections:
                print(section.section_type)
                if section.image is not None:
                    print(section.image.width)
                    print(section.image.height)
                    print(len(section.image.get_bytes()))
                print(section.script)
```

## Clearing a particular header or footer
This sample clears both text and image content from a chosen header or footer type on a worksheet.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls
import groupdocs.watermark.common as gwc

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for section in content.worksheets[0].headers_footers[gwc.OfficeHeaderFooterType.HEADER_PRIMARY].sections:
        section.script = None
        section.image = None
    watermarker.save("spreadsheet.xlsx")
```

## Clearing a particular section of header or footer
This sample targets a specific header/footer section and clears its image and script.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls
import groupdocs.watermark.common as gwc

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    section = content.worksheets[0].headers_footers[gwc.OfficeHeaderFooterType.HEADER_EVEN].sections[gwc_xls.SpreadsheetHeaderFooterSectionType.LEFT]
    section.image = None
    section.script = None
    watermarker.save("spreadsheet.xlsx")
```

## Adding watermark to all images in header and footer
This sample applies a centered, rotated text watermark over all header/footer images across worksheets.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.contents.spreadsheet as gwc_xls
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc

load_options = gw.SpreadsheetLoadOptions()
with gw.Watermarker("spreadsheet.xlsx", load_options) as watermarker:
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    content = watermarker.get_content(gwc_xls.SpreadsheetContent)
    for worksheet in content.worksheets:
        for header_footer in worksheet.headers_footers:
            for section in header_footer.sections:
                if section.image is not None:
                    section.image.add(watermark)
    watermarker.save("spreadsheet.xlsx")
```



---

## Working with metadata in Diagrams

Path: /metadata/net/working-with-metadata-in-diagrams/

GroupDocs.Metadata for .NET provides functionality that allows working with different kinds of diagrams such as VDX, VSDX, VSX, etc. For the full list of supported document formats please refer to [Supported Document Formats]({{< ref "metadata/net/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a document

The following sample of code will help you to detect the exact type of a loaded diagram and extract some additional file format information.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PDF document
2.  Extract the root metadata package
3.  Use the [FileType](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/diagramrootpackage/properties/filetype) property to obtain file format information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Diagram.<WBR>DiagramReadFileFormatProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputVdx))
{
	var root = metadata.GetRootPackage<DiagramRootPackage>();

	Console.WriteLine(root.FileType.FileFormat);
	Console.WriteLine(root.FileType.DiagramFormat);
	Console.WriteLine(root.FileType.MimeType);
	Console.WriteLine(root.FileType.Extension);
}
```

## Reading built-In metadata properties

To access built-in metadata of a diagram, please use the [DocumentProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1/properties/documentproperties) property defined in the [DocumentRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Diagram.<WBR>DiagramReadBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputVsdx))
{
	var root = metadata.GetRootPackage<DiagramRootPackage>();

	Console.WriteLine(root.DocumentProperties.Creator);
	Console.WriteLine(root.DocumentProperties.Company);
	Console.WriteLine(root.DocumentProperties.Keywords);
	Console.WriteLine(root.DocumentProperties.Language);
	Console.WriteLine(root.DocumentProperties.TimeCreated);
	Console.WriteLine(root.DocumentProperties.Category);

	// ... 
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a diagram please follow the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Diagram.<WBR>DiagramReadCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputVsdx))
{
	var root = metadata.GetRootPackage<DiagramRootPackage>();

	var customProperties = root.DocumentProperties.FindProperties(p => !p.Tags.Contains(Tags.Document.BuiltIn));
	foreach (var property in customProperties)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [FindProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/metadatapackage/methods/findproperties) method for a certain metadata package (instance of the [DiagramPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/diagrampackage) class), the search result will contain only metadata properties that are specific for diagram documents. 

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a diagram (only the page count statistic is available at the moment).

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Diagram.<WBR>DiagramReadDocumentStatistics**

```csharp
using (Metadata metadata = new Metadata(Constants.InputVdx))
{
	var root = metadata.GetRootPackage<DiagramRootPackage>();
	
	Console.WriteLine(root.DocumentStatistics.PageCount);
}
```

## Updating built-In metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a diagram document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Diagram.<WBR>DiagramUpdateBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputVdx))
{
	var root = metadata.GetRootPackage<DiagramRootPackage>();

	root.DocumentProperties.Creator = "test author";
	root.DocumentProperties.TimeCreated = DateTime.Now;
	root.DocumentProperties.Company = "GroupDocs";
	root.DocumentProperties.Category = "test category";
	root.DocumentProperties.Keywords = "metadata, built-in, update";

	// ... 

	metadata.Save(Constants.OutputVdx);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a diagram document. Please check the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Diagram.<WBR>DiagramUpdateCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputVsdx))
{
	var root = metadata.GetRootPackage<DiagramRootPackage>();

	root.DocumentProperties.Set("customProperty1", "some value");
	root.DocumentProperties.Set("customProperty2", true);

	metadata.Save(Constants.OutputVsdx);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in EPUB e-books

Path: /metadata/java/working-with-metadata-in-epub-e-books/

## What is EPUB?

EPUB is an e-book file format that uses the ".epub" file extension. EPUB is supported by many e-readers, and compatible software is available for most smartphones, tablets, and computers. 

{{< alert style="info" >}}Please find more information on the format at https://en.wikipedia.org/wiki/EPUB{{< /alert >}}

## Reading EPUB format-specific properties

The GroupDocs.Metadata API supports extracting format-specific information from EPUB files.

The following are the steps to read native EPUB metadata.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an EPUB file
2.  Get the root metadata package
3.  Extract  the native metadata package using the [EpubRootPackage.getEpubPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/EpubRootPackage#getEpubPackage()) method
4.  Read the EPUB metadata properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>ebook.EpubReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEpub)) {
	EpubRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getEpubPackage().getVersion());
	System.out.println(root.getEpubPackage().getUniqueIdentifier());
	System.out.println(root.getEpubPackage().getImageCover() != null ? root.getEpubPackage().getImageCover().length : 0);
}
```

## Updating EPUB format-specific properties

The GroupDocs.Metadata API also supports updating some metadata properties of an EPUB file. Please see the code snippet below to learn how to do that.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>ebook.EpubUpdateNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEpub)) {
    EpubRootPackage root = metadata.getRootPackageGeneric();
 
    root.getEpubPackage().setCreator("GroupDocs");
    root.getEpubPackage().setDescription("test e-book");
    root.getEpubPackage().setFormat("EPUB");
    root.getEpubPackage().setDate(new Date().toString());
 
    // ...
 
    metadata.save(Constants.OutputEpub);
}
```

## Reading Dublin Core Metadata

Dublin Core metadata is a set of certain metadata properties that are intended to describe various digital resources. Please find more information on the Dublin Core standard at [https://en.wikipedia.org/wiki/Dublin\_Core](https://en.wikipedia.org/wiki/Dublin_Core). The code sample below shows how to extract Dublin Core metadata from a EPUB e-book using the GroupDocs.Metadata API.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>ebook.EpubReadDublinCoreProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEpub)) {
    EpubRootPackage root = metadata.getRootPackageGeneric();
 
    System.out.println(root.getDublinCorePackage().getRights());
    System.out.println(root.getDublinCorePackage().getPublisher());
    System.out.println(root.getDublinCorePackage().getTitle());
    System.out.println(root.getDublinCorePackage().getCreator());
    System.out.println(root.getDublinCorePackage().getLanguage());
    System.out.println(root.getDublinCorePackage().getDate());
 
    // ...
}
```

Please see the the [DublinCorePackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DublinCorePackage) class to get more information on supported Dublin Core metadata properties.

## Updating Dublin Core Metadata

The GroupDocs.Metadata API also allows updating DublinCore metadata properties in an EPUB file. Please check the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>ebook.EpubUpdateDublinCoreProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEpub)) {
 
    EpubRootPackage root = metadata.getRootPackageGeneric();
 
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:creator"), new PropertyValue("GroupDocs"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:description"), new PropertyValue("test e-book"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:title"), new PropertyValue("test EPUB"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:date"), new PropertyValue(new Date().toString()));
 
    // ...
 
    metadata.save(Constants.OutputEpub);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in EPUB E-Books

Path: /metadata/net/working-with-metadata-in-epub-e-books/

## What is EPUB?

EPUB is an e-book file format that uses the ".epub" file extension. EPUB is supported by many e-readers, and compatible software is available for most smartphones, tablets, and computers. 

{{< alert style="info" >}}Please find more information on the format at https://en.wikipedia.org/wiki/EPUB{{< /alert >}}

## Reading EPUB format-specific properties

The GroupDocs.Metadata API supports extracting format-specific information from EPUB files.

The following are the steps to read native EPUB metadata.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an EPUB file
2.  Get the root metadata package
3.  Extract  the native metadata package using [EpubRootPackage.EpubPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.ebook/epubrootpackage/properties/epubpackage)
4.  Read the EPUB metadata properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Ebook.EpubReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputEpub))
{
	var root = metadata.GetRootPackage<EpubRootPackage>();

	Console.WriteLine(root.EpubPackage.Version);
	Console.WriteLine(root.EpubPackage.UniqueIdentifier);
	Console.WriteLine(root.EpubPackage.ImageCover != null ? root.EpubPackage.ImageCover.Length : 0);
	Console.WriteLine(root.EpubPackage.Description);
	Console.WriteLine(root.EpubPackage.Title);

	// ...
}
```

## Updating EPUB format-specific properties

The GroupDocs.Metadata API also supports updating some metadata properties of an EPUB file. Please see the code snippet below to learn how to do that.

```csharp
using (Metadata metadata = new Metadata(Constants.InputEpub))
{
    var root = metadata.GetRootPackage<EpubRootPackage>();
    root.EpubPackage.Creator = "GroupDocs";
    root.EpubPackage.Description = "test e-book";
    root.EpubPackage.Format = "EPUB";
    root.EpubPackage.Date = DateTime.Now.ToString();
 
    // ...
 
    metadata.Save(Constants.OutputEpub);
}
```

## Reading Dublin Core Metadata

Dublin Core metadata is a set of certain metadata properties that are intended to describe various digital resources. Please find more information on the Dublin Core standard at [https://en.wikipedia.org/wiki/Dublin\_Core](https://en.wikipedia.org/wiki/Dublin_Core). The code sample below shows how to extract Dublin Core metadata from a EPUB e-book using the GroupDocs.Metadata API.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Ebook.EpubReadDublinCoreProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputEpub))
{
	var root = metadata.GetRootPackage<EpubRootPackage>();

	Console.WriteLine(root.DublinCorePackage.Rights);
	Console.WriteLine(root.DublinCorePackage.Publisher);
	Console.WriteLine(root.DublinCorePackage.Title);
	Console.WriteLine(root.DublinCorePackage.Creator);
	Console.WriteLine(root.DublinCorePackage.Language);
	Console.WriteLine(root.DublinCorePackage.Date);

	// ...
}
```

## Updating Dublin Core Metadata

The GroupDocs.Metadata API also allows updating DublinCore metadata properties in an EPUB file. Please check the code sample below.

```csharp
using (Metadata metadata = new Metadata(Constants.InputEpub))
{
    var root = metadata.GetRootPackage<EpubRootPackage>();
    root.DublinCorePackage.SetProperties(p => p.Name == "dc:creator", new PropertyValue("GroupDocs"));
    root.DublinCorePackage.SetProperties(p => p.Name == "dc:description", new PropertyValue("test e-book"));
    root.DublinCorePackage.SetProperties(p => p.Name == "dc:title", new PropertyValue("test EPUB"));
    root.DublinCorePackage.SetProperties(p => p.Name == "dc:date", new PropertyValue(DateTime.Now.ToString()));
  
    // ...
  
    metadata.Save(Constants.OutputEpub);
}
```

Please see the the [DublinCorePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.standards.dublincore/dublincorepackage) class to get more information on supported Dublin Core metadata properties.

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in GIF images

Path: /metadata/java/working-with-metadata-in-gif-images/

## Detecting the GIF version

The following sample of code will help you to detect the version of a loaded GIF image and extract some additional file format information.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a GIF image
2.  Extract the root metadata package
3.  Use the [getGifImageType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/GifRootPackage#getGifImageType()) method to obtain file format information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.gif.GifReadFileFormatProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputGif)) {
	GifRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getGifImageType().getFileFormat());
	System.out.println(root.getGifImageType().getVersion());
	System.out.println(root.getGifImageType().getByteOrder());
	System.out.println(root.getGifImageType().getMimeType());
	System.out.println(root.getGifImageType().getExtension());
	System.out.println(root.getGifImageType().getWidth());
	System.out.println(root.getGifImageType().getHeight());
}
```

## Working with XMP Metadata

GroupDocs.Metadata for Java also allows managing XMP metadata in GIF files. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in GIF images

Path: /metadata/net/working-with-metadata-in-gif-images/

## Detecting the GIF version

The following sample of code will help you to detect the version of a loaded GIF image and extract some additional file format information.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a GIF image
2.  Extract the root metadata package
3.  Use the [FileType](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/gifrootpackage/properties/filetype) property to obtain file format information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Gif.GifReadFileFormatProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputGif))
{
	var root = metadata.GetRootPackage<GifRootPackage>();

	Console.WriteLine(root.FileType.FileFormat);
	Console.WriteLine(root.FileType.Version);
	Console.WriteLine(root.FileType.ByteOrder);
	Console.WriteLine(root.FileType.MimeType);
	Console.WriteLine(root.FileType.Extension);
	Console.WriteLine(root.FileType.Width);
	Console.WriteLine(root.FileType.Height);
}
```

## Working with XMP Metadata

GroupDocs.Metadata for .NET also allows managing XMP metadata in GIF files. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in Matroska (MKV) files

Path: /metadata/java/working-with-metadata-in-matroska-(mkv)-files/

## Reading matroska format-specific properties

The GroupDocs.Metadata API supports extracting format-specific information from MKV files.

The following are the steps to read native MKV metadata.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MKV video
2.  Get the root metadata package
3.  Extract  the native metadata package using the [MatroskaRootPackage.getMatroskaPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MatroskaRootPackage#getMatroskaPackage()) method
4.  Read the Matroska metadata properties on different levels of the format structure

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>video.matroska.MatroskaReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputMkv)) {
	MatroskaRootPackage root = metadata.getRootPackageGeneric();
	// Read the EBML header
	System.out.println(String.format("DocType: %s", root.getMatroskaPackage().getEbmlHeader().getDocType()));
	System.out.println(String.format("DocTypeReadVersion: %s", root.getMatroskaPackage().getEbmlHeader().getDocTypeReadVersion()));
	System.out.println(String.format("DocTypeVersion: %s", root.getMatroskaPackage().getEbmlHeader().getDocTypeVersion()));
	System.out.println(String.format("ReadVersion: %s", root.getMatroskaPackage().getEbmlHeader().getReadVersion()));
	System.out.println(String.format("Version: %s", root.getMatroskaPackage().getEbmlHeader().getVersion()));

	// Read Matroska segment information
	for (MatroskaSegment segment : root.getMatroskaPackage().getSegments()) {
		System.out.println(String.format("DateUtc: %s", segment.getDateUtc()));
		System.out.println(String.format("Duration: %s", segment.getDuration()));
		System.out.println(String.format("MuxingApp: %s", segment.getMuxingApp()));
		System.out.println(String.format("SegmentFilename: %s", segment.getSegmentFilename()));
		System.out.println(String.format("SegmentUid: %s", segment.getSegmentUid()));
		System.out.println(String.format("TimecodeScale: %s", segment.getTimecodeScale()));
		System.out.println(String.format("Title: %s", segment.getTitle()));
		System.out.println(String.format("WritingApp: %s", segment.getWritingApp()));
	}

	// Read Matroska tag metadata
	for (MatroskaTag tag : root.getMatroskaPackage().getTags()) {
		System.out.println(String.format("TargetType: %s", tag.getTargetType()));
		System.out.println(String.format("TargetTypeValue: %s", tag.getTargetTypeValue()));
		System.out.println(String.format("TagTrackUid: %s", tag.getTagTrackUid()));
		for (MetadataProperty simpleTag : tag.getSimpleTags()) {
			System.out.println(String.format("Name: %s", simpleTag.getName()));
			System.out.println(String.format("Value: %s", simpleTag.getValue()));
		}
	}

	// Read Matroska track metadata
	for (MatroskaTrack track : root.getMatroskaPackage().getTracks()) {
		System.out.println(String.format("CodecId: %s", track.getCodecID()));
		System.out.println(String.format("CodecName: %s", track.getCodecName()));
		System.out.println(String.format("DefaultDuration: %s", track.getDefaultDuration()));
		System.out.println(String.format("FlagEnabled: %s", track.getFlagEnabled()));
		System.out.println(String.format("Language: %s", track.getLanguage()));
		System.out.println(String.format("LanguageIetf: %s", track.getLanguageIetf()));
		System.out.println(String.format("Name: %s", track.getName()));
		System.out.println(String.format("TrackNumber: %s", track.getTrackNumber()));
		System.out.println(String.format("TrackType: %s", track.getTrackType()));
		System.out.println(String.format("TrackUid: %s", track.getTrackUid()));
		if (track instanceof MatroskaAudioTrack) {
			MatroskaAudioTrack audioTrack = (MatroskaAudioTrack) track;
			System.out.println(String.format("SamplingFrequency: %s", audioTrack.getSamplingFrequency()));
			System.out.println(String.format("OutputSamplingFrequency: %s", audioTrack.getOutputSamplingFrequency()));
			System.out.println(String.format("Channels: %s", audioTrack.getChannels()));
			System.out.println(String.format("BitDepth: %s", audioTrack.getBitDepth()));
		}
		if (track instanceof MatroskaVideoTrack) {
			MatroskaVideoTrack videoTrack = (MatroskaVideoTrack) track;
			System.out.println(String.format("FlagInterlaced: %s", videoTrack.getFlagInterlaced()));
			System.out.println(String.format("FieldOrder: %s", videoTrack.getFieldOrder()));
			System.out.println(String.format("StereoMode: %s", videoTrack.getStereoMode()));
			System.out.println(String.format("AlphaMode: %s", videoTrack.getAlphaMode()));
			System.out.println(String.format("PixelWidth: %s", videoTrack.getPixelWidth()));
			System.out.println(String.format("PixelHeight: %s", videoTrack.getPixelHeight()));
			System.out.println(String.format("PixelCropBottom: %s", videoTrack.getPixelCropBottom()));
			System.out.println(String.format("PixelCropTop: %s", videoTrack.getPixelCropTop()));
			System.out.println(String.format("PixelCropLeft: %s", videoTrack.getPixelCropLeft()));
			System.out.println(String.format("PixelCropRight: %s", videoTrack.getPixelCropRight()));
			System.out.println(String.format("DisplayWidth: %s", videoTrack.getDisplayWidth()));
			System.out.println(String.format("DisplayHeight: %s", videoTrack.getDisplayHeight()));
			System.out.println(String.format("DisplayUnit: %s", videoTrack.getDisplayUnit()));
		}
	}
}
```

## Extracting subtitles from a Matroska video

The GroupDocs.Metadata API also provides a convenient way of extracting subtitles attached to a Matroska video. The code sample below demonstrates how to extract multilingual subtitles from an MKV file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MKV video
2.  Get the root metadata package
3.  Use the [MatroskaPackage.getSubtitleTracks](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MatroskaPackage#getSubtitleTracks()) method to extract sets of subtitles in different languages

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>video.matroska.MatroskaReadSubtitles**

```csharp
try (Metadata metadata = new Metadata(Constants.MkvWithSubtitles)) {
	MatroskaRootPackage root = metadata.getRootPackageGeneric();

	for (MatroskaSubtitleTrack subtitleTrack : root.getMatroskaPackage().getSubtitleTracks()) {
		System.out.println(subtitleTrack.getLanguageIetf() != null ? subtitleTrack.getLanguageIetf() : subtitleTrack.getLanguage());
		for (MatroskaSubtitle subtitle : subtitleTrack.getSubtitles()) {
			System.out.println(String.format("Timecode=%s, Duration=%s", subtitle.getTimecode(), subtitle.getDuration()));
			System.out.println(subtitle.getText());
		}
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in Matroska (MKV) files

Path: /metadata/net/working-with-metadata-in-matroska-(mkv)-files/

## Reading matroska format-specific properties

The GroupDocs.Metadata API supports extracting format-specific information from MKV files.

The following are the steps to read native MKV metadata.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MKV video
2.  Get the root metadata package
3.  Extract  the native metadata package using [MatroskaRootPackage.MatroskaPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.video/matroskarootpackage/properties/matroskapackage)
4.  Read the Matroska metadata properties on different levels of the format structure

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Video.Matroska.MatroskaReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputMkv))
{
	var root = metadata.GetRootPackage<MatroskaRootPackage>();

	// Read the EBML header
	Console.WriteLine("DocType: {0}", root.MatroskaPackage.EbmlHeader.DocType);
	Console.WriteLine("DocTypeReadVersion: {0}", root.MatroskaPackage.EbmlHeader.DocTypeReadVersion);
	Console.WriteLine("DocTypeVersion: {0}", root.MatroskaPackage.EbmlHeader.DocTypeVersion);
	Console.WriteLine("ReadVersion: {0}", root.MatroskaPackage.EbmlHeader.ReadVersion);
	Console.WriteLine("Version: {0}", root.MatroskaPackage.EbmlHeader.Version);

	// Read Matroska segment information
	foreach (var segment in root.MatroskaPackage.Segments)
	{
		Console.WriteLine("DateUtc: {0}", segment.DateUtc);
		Console.WriteLine("Duration: {0}", segment.Duration);
		Console.WriteLine("MuxingApp: {0}", segment.MuxingApp);
		Console.WriteLine("SegmentFilename: {0}", segment.SegmentFilename);
		Console.WriteLine("SegmentUid: {0}", segment.SegmentUid);
		Console.WriteLine("TimecodeScale: {0}", segment.TimecodeScale);
		Console.WriteLine("Title: {0}", segment.Title);
		Console.WriteLine("WritingApp: {0}", segment.WritingApp);
	}

	// Read Matroska tag metadata
	foreach (var tag in root.MatroskaPackage.Tags)
	{
		Console.WriteLine("TargetType: {0}", tag.TargetType);
		Console.WriteLine("TargetTypeValue: {0}", tag.TargetTypeValue);
		Console.WriteLine("TagTrackUid: {0}", tag.TagTrackUid);
		foreach (var simpleTag in tag.SimpleTags)
		{
			Console.WriteLine("Name: {0}", simpleTag.Name);
			Console.WriteLine("Value: {0}", simpleTag.Value);
		}
	}

	// Read Matroska track metadata
	foreach (var track in root.MatroskaPackage.Tracks)
	{
		Console.WriteLine("CodecId: {0}", track.CodecID);
		Console.WriteLine("CodecName: {0}", track.CodecName);
		Console.WriteLine("DefaultDuration: {0}", track.DefaultDuration);
		Console.WriteLine("FlagEnabled: {0}", track.FlagEnabled);
		Console.WriteLine("Language: {0}", track.Language);
		Console.WriteLine("LanguageIetf: {0}", track.LanguageIetf);
		Console.WriteLine("Name: {0}", track.Name);
		Console.WriteLine("TrackNumber: {0}", track.TrackNumber);
		Console.WriteLine("TrackType: {0}", track.TrackType);
		Console.WriteLine("TrackUid: {0}", track.TrackUid);

		var audioTrack = track as MatroskaAudioTrack;
		if (audioTrack != null)
		{
			Console.WriteLine("SamplingFrequency: {0}", audioTrack.SamplingFrequency);
			Console.WriteLine("OutputSamplingFrequency: {0}", audioTrack.OutputSamplingFrequency);
			Console.WriteLine("Channels: {0}", audioTrack.Channels);
			Console.WriteLine("BitDepth: {0}", audioTrack.BitDepth);
		}

		var videoTrack = track as MatroskaVideoTrack;
		if (videoTrack != null)
		{
			Console.WriteLine("FlagInterlaced: {0}", videoTrack.FlagInterlaced);
			Console.WriteLine("FieldOrder: {0}", videoTrack.FieldOrder);
			Console.WriteLine("StereoMode: {0}", videoTrack.StereoMode);
			Console.WriteLine("AlphaMode: {0}", videoTrack.AlphaMode);
			Console.WriteLine("PixelWidth: {0}", videoTrack.PixelWidth);
			Console.WriteLine("PixelHeight: {0}", videoTrack.PixelHeight);
			Console.WriteLine("PixelCropBottom: {0}", videoTrack.PixelCropBottom);
			Console.WriteLine("PixelCropTop: {0}", videoTrack.PixelCropTop);
			Console.WriteLine("PixelCropLeft: {0}", videoTrack.PixelCropLeft);
			Console.WriteLine("PixelCropRight: {0}", videoTrack.PixelCropRight);
			Console.WriteLine("DisplayWidth: {0}", videoTrack.DisplayWidth);
			Console.WriteLine("DisplayHeight: {0}", videoTrack.DisplayHeight);
			Console.WriteLine("DisplayUnit: {0}", videoTrack.DisplayUnit);
		}
	}
}
```

## Extracting subtitles from a Matroska video

The GroupDocs.Metadata API also provides a convenient way of extracting subtitles attached to a Matroska video. The code sample below demonstrates how to extract multilingual subtitles from an MKV file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MKV video
2.  Get the root metadata package
3.  Use the [MatroskaPackage.SubtitleTracks](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.video/matroskapackage/properties/subtitletracks) property to extract sets of subtitles in different languages

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Video.Matroska.MatroskaReadSubtitles**

```csharp
using (Metadata metadata = new Metadata(Constants.MkvWithSubtitles))
{
	var root = metadata.GetRootPackage<MatroskaRootPackage>();

	foreach (var subtitleTrack in root.MatroskaPackage.SubtitleTracks)
	{
		Console.WriteLine(subtitleTrack.LanguageIetf ?? subtitleTrack.Language);
		foreach (MatroskaSubtitle subtitle in subtitleTrack.Subtitles)
		{
			Console.WriteLine("Timecode={0}, Duration={1}", subtitle.Timecode, subtitle.Duration);
			Console.WriteLine(subtitle.Text);
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in PDF documents

Path: /metadata/java/working-with-metadata-in-pdf-documents/

## Detecting the version of a PDF document

The following sample of code will help you to detect the PDF version a loaded document and extract some additional file format information.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PDF document
2.  Extract the root metadata package
3.  Use the [getPdfType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PdfRootPackage#getPdfType()) method to obtain file format information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfReadFileFormatProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getPdfType().getFileFormat());
	System.out.println(root.getPdfType().getVersion());
	System.out.println(root.getPdfType().getMimeType());
	System.out.println(root.getPdfType().getExtension());
}
```

## Reading built-in metadata properties

To access built-in metadata of a PDF document, please use the [getDocumentProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage#getDocumentProperties()) method defined in the [DocumentRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfReadBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentProperties().getAuthor());
	System.out.println(root.getDocumentProperties().getCreatedDate());
	System.out.println(root.getDocumentProperties().getSubject());
	System.out.println(root.getDocumentProperties().getProducer());
	System.out.println(root.getDocumentProperties().getKeywords());

	// ...
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a PDF document please follow the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfReadCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();

	IReadOnlyList<MetadataProperty> customProperties = root.getDocumentProperties().findProperties(new ContainsTagSpecification(Tags.getDocument().getBuiltIn()).not());

	for (MetadataProperty property : customProperties) {
		System.out.println(String.format("%s = %s", property.getName(), property.getValue()));
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [findProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MetadataPackage#findProperties(com.groupdocs.metadata.search.Specification)) method for a certain metadata package (instance of the [PdfPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PdfPackage) class), the search result will contain only metadata properties that are specific for PDF documents. 

## Inspecting PDF documents

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about digital signatures associated with a document, extract form fields, attachments, bookmarks, etc. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PDF document
2.  Extract the root metadata package
3.  Use the [getInspectionPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PdfRootPackage#getInspectionPackage()) method to inspect the document

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfReadInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.SignedPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();

	if (root.getInspectionPackage().getAnnotations() != null) {
		for (PdfAnnotation annotation : root.getInspectionPackage().getAnnotations()) {
			System.out.println(annotation.getName());
			System.out.println(annotation.getText());
			System.out.println(annotation.getPageNumber());
		}
	}

	if (root.getInspectionPackage().getAttachments() != null) {
		for (PdfAttachment attachment : root.getInspectionPackage().getAttachments()) {
			System.out.println(attachment.getName());
			System.out.println(attachment.getMimeType());
			System.out.println(attachment.getDescription());
		}
	}

	if (root.getInspectionPackage().getBookmarks() != null) {
		for (PdfBookmark bookmark : root.getInspectionPackage().getBookmarks()) {
			System.out.println(bookmark.getTitle());
		}
	}

	if (root.getInspectionPackage().getDigitalSignatures() != null) {
		for (DigitalSignature signature : root.getInspectionPackage().getDigitalSignatures()) {
			System.out.println(signature.getCertificateSubject());
			System.out.println(signature.getComments());
			System.out.println(signature.getSignTime());
			// ...
		}
	}

	if (root.getInspectionPackage().getFields() != null) {
		for (PdfFormField field : root.getInspectionPackage().getFields()) {
			System.out.println(field.getName());
			System.out.println(field.getValue());
			// ...
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a PDF document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfReadDocumentStatistics**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentStatistics().getCharacterCount());
	System.out.println(root.getDocumentStatistics().getPageCount());
	System.out.println(root.getDocumentStatistics().getWordCount());
}
```

## Updating built-In metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a PDF document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfUpdateBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();
	root.getDocumentProperties().setAuthor("test author");
	root.getDocumentProperties().setCreatedDate(new Date());
	root.getDocumentProperties().setTitle("test title");
	root.getDocumentProperties().setKeywords("metadata, built-in, update");

	// ...

	metadata.save(Constants.OutputPdf);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a PDF document. Please check the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfUpdateCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().set("customProperty1", "some value");

	metadata.save(Constants.OutputPdf);
}
```

## Updating inspection properties

When you inspect a document GroupDocs.Metadata for Java forms a metadata package containing the extracted information. The package class also provides some basic methods that allow removing the extracted properties. The following code sample demonstrates how to remove the inspection properties from a PDF document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.pdf.<WBR>PdfUpdateInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.SignedPdf)) {
	PdfRootPackage root = metadata.getRootPackageGeneric();

	root.getInspectionPackage().clearAnnotations();
	root.getInspectionPackage().clearAttachments();
	root.getInspectionPackage().clearFields();
	root.getInspectionPackage().clearBookmarks();
	root.getInspectionPackage().clearDigitalSignatures();

	metadata.save(Constants.OutputPdf);
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java also allows managing XMP metadata in PDF files. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}})

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## YAML front matter

Path: /markdown/net/front-matter/


Enable `IncludeFrontMatter` to extract document metadata into a YAML block at the beginning of the Markdown output. This is commonly used by static site generators like Jekyll, Hugo, and Docusaurus.

### Example

{{< tabs "front-matter-example">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions { IncludeFrontMatter = true };
MarkdownConverter.ToFile("business-plan.docx", "front-matter-example.md", options);
// Output:
// ---
// title: "Q3 Report"
// author: "Jane Doe"
// format: Docx
// pages: 12
// ---
//
// # Q3 Report
// ...
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "front-matter-example.md" >}}  
```text
---
title: "Meridian Outdoor Co. — Business Plan"
author: "Meridian Outdoor Co."
format: Docx
pages: 5
---

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/front-matter/FrontMatterExample/front-matter-example.md)
{{< /tab >}}
{{< /tabs >}}

### Combined with heading offset

{{< tabs "front-matter-combined">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    IncludeFrontMatter = true,
    HeadingLevelOffset = 1
};
MarkdownConverter.ToFile("annual-report.docx", "front-matter-combined.md", options);
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "front-matter-combined.md" >}}  
```text
---
title: "Meridian Outdoor Co. — Annual Report 2025"
author: "Elena Márquez, CFO"
format: Docx
pages: 6
---

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1Ld
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/front-matter/FrontMatterCombined/front-matter-combined.md)
{{< /tab >}}
{{< /tabs >}}

### Front matter fields

Only non-empty fields are included:

| Field | Source | Example |
|---|---|---|
| `title` | `BuiltInDocumentProperties.Title` | `"Q3 Report"` |
| `author` | `BuiltInDocumentProperties.Author` | `"Jane Doe"` |
| `format` | Detected file format | `Docx` |
| `pages` | Page or worksheet count | `12` |

---

## YAML front matter

Path: /markdown/python-net/front-matter/


Enable `include_front_matter` to extract document metadata into a YAML block at the beginning of the Markdown output. This is commonly used by static site generators like Jekyll, Hugo, and Docusaurus.

### Example

{{< tabs "front-matter-example">}}
{{< tab "front_matter_example.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def front_matter_example():
    """Convert a document to Markdown with YAML front matter extracted from metadata."""

    # Step 1: Enable front matter generation in conversion options
    options = ConvertOptions()
    options.include_front_matter = True

    # Step 2: Convert the document with front matter enabled
    md = MarkdownConverter.to_markdown("business-plan.docx", convert_options=options)

    # Step 3: Print the result -- YAML front matter appears at the top
    print(md)
    # Output:
    # ---
    # title: "Q3 Report"
    # author: "Jane Doe"
    # format: Docx
    # pages: 12
    # ---
    #
    # # Q3 Report
    # ...

if __name__ == "__main__":
    front_matter_example()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "front-matter.txt" >}}  
```text
---

format: Docx

pages: 18

---





| HOME BASED |  |  |

| --- | --- | --- |

|  |  |  |

| PROFESSIONAL SERVICES |  |  |

...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/front-matter/front_matter_example/front-matter.txt)
{{< /tab >}}
{{< tab "front-matter.txt" >}}  
```text
---

format: Docx

pages: 18

---





| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdI
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/front-matter/front_matter_example/front-matter.txt)
{{< /tab >}}
{{< /tabs >}}

### Combined with heading offset

{{< tabs "front-matter-combined">}}
{{< tab "front_matter_combined.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def front_matter_combined():
    """Convert a document with both YAML front matter and heading level offset."""

    # Step 1: Configure options with front matter and heading offset
    options = ConvertOptions()
    options.include_front_matter = True       # add YAML metadata block
    options.heading_level_offset = 1          # shift headings down one level

    # Step 2: Convert and save to a file using keyword argument for options
    MarkdownConverter.to_file("annual-report.docx", "front-matter-combined.md", convert_options=options)

if __name__ == "__main__":
    front_matter_combined()
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "front-matter-combined.txt" >}}  
```text
---
author: "Brianna Thielen"
format: Docx
pages: 1
---

[queryEmployees]

Employee Information for Employee [EmployeeID]: [FirstName] [LastName]

...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/front-matter/front_matter_combined/front-matter-combined.txt)
{{< /tab >}}
{{< tab "front-matter-combined.txt" >}}  
```text
---
author: "Brianna Thielen"
format: Docx
pages: 1
---

[queryEmployees]

Employee Information for Employee [EmployeeID]: [FirstName] [LastName]

[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/front-matter/front_matter_combined/front-matter-combined.txt)
{{< /tab >}}
{{< /tabs >}}

### Front matter fields

Only non-empty fields are included:

| Field | Source | Example |
|---|---|---|
| `title` | `BuiltInDocumentProperties.Title` | `"Q3 Report"` |
| `author` | `BuiltInDocumentProperties.Author` | `"Jane Doe"` |
| `format` | Detected file format | `Docx` |
| `pages` | Page or worksheet count | `12` |

---

## Verify Barcode Signatures in Document

Path: /signature/python-net/verify-barcode-signatures-in-the-document/


[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides functionality to verify barcode signatures in documents. This guide demonstrates how to verify barcode signatures using Python.

## Basic Usage Example

Here's a simple example showing how to verify barcode signatures in a document:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import BarcodeVerifyOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create verification options
    options = BarcodeVerifyOptions()
    options.text = "123456789"
    options.match_type = signature.TextMatchType.Contains
    options.all_pages = True  # verify on all pages
    
    # Verify signatures
    result = sign.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
    else:
        print("Document failed verification process.")
```

## Advanced Usage Example

Here's an example showing more advanced verification options:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import BarcodeVerifyOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create verification options with advanced settings
    options = BarcodeVerifyOptions()
    options.text = "123456789"
    options.match_type = signature.TextMatchType.Exact  # require exact match
    options.barcode_type = signature.BarcodeType.Code128  # specify barcode type
    options.all_pages = False  # verify only on specific pages
    options.page_numbers = [1, 2]  # verify on pages 1 and 2
    
    # Verify signatures
    result = sign.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
        # Print verification details
        for signature in result.succeeded:
            print(f"Found valid barcode: {signature.text}")
    else:
        print("Document failed verification process.")
        # Print failed verification details
        for signature in result.failed:
            print(f"Invalid barcode: {signature.text}")
```

## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To verify PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify Text signatures in the document

Path: /signature/java/verify-text-signatures-in-the-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextVerifyOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.verify/TextVerifyOptions) class to specify different options for verification of Text signatures.

Here are the steps to verify Text signature within the document with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
*   Instantiate the [TextVerifyOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.verify/TextVerifyOptions) object according to your requirements and specify verification options
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class instance and pass [TextVerifyOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.verify/TextVerifyOptions) to it.

This example shows how to verify Text signature in the document.

```java
Signature signature = new Signature("sample.pdf");
TextVerifyOptions options = new TextVerifyOptions();
options.setAllPages(true); // this value is set by default
options.setSignatureImplementation(TextSignatureImplementation.Stamp);
options.setText("John");
options.setMatchType(TextMatchType.Contains);
 
// verify document signatures
VerificationResult result = signature.verify(options);
if (result.isValid())
{
    System.out.print("\nDocument was verified successfully!");
}
else
{
    System.out.print("\nDocument failed verification process.");
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verify Text Signatures in Document

Path: /signature/python-net/verify-text-signatures-in-the-document/


[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides functionality to verify text signatures in documents. This guide demonstrates how to verify text signatures using Python.

## Basic Usage Example

Here's a simple example showing how to verify text signatures in a document:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextVerifyOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create verification options
    options = TextVerifyOptions()
    options.text = "John Smith"
    options.match_type = signature.TextMatchType.Contains
    options.all_pages = True  # verify on all pages
    
    # Verify signatures
    result = sign.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
    else:
        print("Document failed verification process.")
```

## Advanced Usage Example

Here's an example showing more advanced verification options:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextVerifyOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create verification options with advanced settings
    options = TextVerifyOptions()
    options.text = "John Smith"
    options.match_type = signature.TextMatchType.Exact  # require exact match
    options.signature_implementation = signature.TextSignatureImplementation.Stamp
    options.all_pages = False  # verify only on specific pages
    options.page_numbers = [1, 2]  # verify on pages 1 and 2
    
    # Verify signatures
    result = sign.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
        # Print verification details
        for signature in result.succeeded:
            print(f"Found valid signature: {signature.text}")
    else:
        print("Document failed verification process.")
        # Print failed verification details
        for signature in result.failed:
            print(f"Invalid signature: {signature.text}")
```

## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To verify PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify Text signatures in the document

Path: /signature/net/verify-text-signatures-in-the-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textverifyoptions) class to specify different options for verification of Text signatures.

Here are the steps to verify Text signature within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [TextVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textverifyoptions) object according to your requirements and specify verification options
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [TextVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textverifyoptions) to it.

This example shows how to verify Text signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextVerifyOptions options = new TextVerifyOptions()
    {
        AllPages = true, // this value is set by default
        SignatureImplementation = TextSignatureImplementation.Stamp,
        Text = "John",
        MatchType = TextMatchType.Contains
    };
    // verify document signatures
    VerificationResult result = signature.Verify(options);
    if(result.IsValid)
    {
        Console.WriteLine("\nDocument was verified successfully!");
    }
    else
    {
        Console.WriteLine("\nDocument failed verification process.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify Text signatures in the document

Path: /signature/nodejs-java/verify-text-signatures-in-the-document/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [TextVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textverifyoptions) class to specify different options for verification of Text signatures.

Here are the steps to verify a Text signature within the document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textverifyoptions) object according to your requirements and specify verification options.
* Call the [Verify](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/verify) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [TextVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textverifyoptions) to it.
This example shows how to verify Text signature in the document.

```csharp
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; // Assuming Constants.SAMPLE_SIGNED_MULTI is defined elsewhere

  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize TextVerifyOptions
  const options = new signatureLib.TextVerifyOptions();
  options.setSignatureImplementation(signatureLib.TextSignatureImplementation.Native);
  options.setText('signature');
  options.setMatchType(signatureLib.TextMatchType.Contains);

  // Verify document signatures
  const result = signature.verify(options);

  if (result.isValid()) {
    console.log('\nDocument was verified successfully!');
  } else {
    console.log('\nDocument failed the verification process.');
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Load document from Stream

Path: /signature/java/load-document-from-stream/

There might be the case when your document is not physically located on the disk. Instead, you have the document in the form of a stream. In this case, to avoid the overhead of saving stream as a file on disk, [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) enables you to work with document from streams directly. Please be aware that [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object does not dispose passed stream.

The following are the steps to be followed:

*   Obtain document stream; 
*   Pass opened stream to [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class constructor.

Following code snippet serves this purpose.

```java
InputStream stream = new FileInputStream("sample.pdf");
Signature signature = new Signature(stream);
QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
 
options.setEncodeType(QrCodeTypes.QR);
options.setLeft(100);
options.setTop(100);           
 
// sign document to file
signature.sign("SampleSigned.pdf", options);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Load document from Stream

Path: /signature/net/load-document-from-stream/

There might be the case when your document is not physically located on the disk. Instead, you have the document in the form of a stream. In this case, to avoid the overhead of saving stream as a file on disk, [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) enables you to work with document from streams directly. Please be aware that [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object does not dispose passed stream.

The following are the steps to be followed:

* Obtain document stream;
* Pass opened stream to [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class constructor.

Following code snippet serves this purpose.

```csharp
using (Stream stream = File.OpenRead("sample.pdf"))
{
    using (Signature signature = new Signature(stream))
    {
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
        {
            EncodeType = QRCodeTypes.QR,
            Left = 100,
            Top = 100
        };
        // sign document to file
        signature.Sign("SampleSigned", options);
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign Word Processing document with Metadata signature

Path: /signature/python-net/esign-word-processing-document-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [WordProcessingMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/wordprocessingmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) instance to sign Word Processing document files.
Word Processing document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Word Processing document metadata contains pair of Name and Value, Name should be unique within the document.  
Word Processing document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there.

### Here are the steps to add metadata signatures into Word Processing document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several [WordProcessingMetadataSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/wordprocessingmetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Word Processing document with Metadata signature

This example shows how to sign Word Processing document with Metadata e-signature.

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import MetadataSignOptions
from groupdocs.signature.domain import WordProcessingMetadataSignature
from datetime import datetime

# Initialize signature
with signature.Signature("sample.docx") as sign:
    # Create metadata options
    options = MetadataSignOptions()
    
    # Create few WordProcessing Metadata signatures
    signatures = [
        WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes"),
        WordProcessingMetadataSignature("DateCreated", datetime.now()),
        WordProcessingMetadataSignature("DocumentId", 123456),
        WordProcessingMetadataSignature("SignatureId", 123.456)
    ]
    
    # Add signatures to options
    options.signatures.extend(signatures)
    
    # Sign document
    sign.sign("SampleSigned.docx", options)
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-metadata-signature/esign-word-processing-document-with-metadata-signature/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign documents with standard QR Code entries

Path: /signature/net/sign-documents-with-standard-qr-code-entries/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to embed into QR-code signature standard entries like email, contact v-card, address etc. This feature supports standard QR-code representation of entries. At this moment following standard QR-code entries are supported

* [Email](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/email) entry that allows to specify in QR-code standard email information with recipient, subject and body.
* [Address](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/address) entry contains address information.
* [V-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/vcard) entry implements standard of visit card 3.0 specification. More details could be found [here](https://en.wikipedia.org/wiki/VCard).
* [Me-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/mecard) entry implements similar to V-Card contact details standard. More details could be found [here](https://en.wikipedia.org/wiki/MeCard_(QR_code)).
* [EPC](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/epc) implements standard of the European Payments Council guidelines define the content of a QR code that can be used to initiate [SEPA](https://en.wikipedia.org/wiki/SEPA_credit_transfer) credit transfer. More details could be found [here](https://en.wikipedia.org/wiki/EPC_QR_code).
* [Event](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/event) entry implements event standard.
* [CryptoCurrencyTransfer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/cryptocurrencytransfer/) entry implements event standard.
* [WiFi](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/wifi) entry implements WiFI settings standard.
* [SMS](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/sms) entry implements sms properties.

Here are the steps to embed standard entry into QR-code with GroupDocs.Signature:  

* Create new instance of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Create new instance of one of standard entries class.
* Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object with [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) value assigned with initialized standard object before.
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions)  object according to your requirements and custom object to [Data](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/data) property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.

## Sign PDF with email QR-code object

This example shows how to esign PDF with Email QR-code object.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create Email object
    var email = new Email()
    {
        Address = "sherlock@holmes.com",
        Subject = "Very important e-mail",
        Body = "Hello, Watson. Reach me ASAP!"
    };

    // create options
    var options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to Address instance
        Data = email,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Width = 100,
        Height = 100,
        Margin = new Padding(10)
    };

    // sign document to file
    signature.Sign("output.pdf", options);
}


```

## Sign PDF with Address inside the QR-Code image

This example shows how to esign PDF with address inside the QR-code image.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create Address object
    var address = new Address()
    {
        Street = "221B Baker Street",
        City = "London",
        State = "NW",
        ZIP = "NW16XE",
        Country = "England"
    };
    // create options
    var options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to Address instance
        Data = address,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Margin = new Padding(10),
        Width = 100,
        Height = 100,
    };
    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## Sign PDF with V-Card (VCF) information in the QR-Code image

This example shows how to esign PDF with V-Card inside the QR-code image.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create VCard object
    var vCard = new VCard()
    {
        FirstName = "Sherlock",
        MidddleName = "Jay",
        LastName = "Holmes",
        Initials = "Mr.",
        Company = "Watson Inc.",
        JobTitle = "Detective",
        HomePhone = "0333 003 3577",
        WorkPhone = "0333 003 3512",
        Email = "watson@sherlockholmes.com",
        Url = "http://sherlockholmes.com/",
        BirthDay = new DateTime(1854, 1, 6),
        HomeAddress = new Address()
        {
            Street = "221B Baker Street",
            City = "London",
            State = "NW",
            ZIP = "NW16XE",
            Country = "England"
        }
    };
    // create options
    var options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to Address instance
        Data = vCard,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Width = 100,
        Height = 100,
        Margin = new Padding(10)
    };

    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## Sign PDF with Me-Card information in the QR-Code image

This example shows how to esign PDF with Me-Card inside the QR-code image.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create MeCard object
    MeCard card = new MeCard()
    {
        Name = "Sherlock",
        Nickname = "Jay",
        Reading = "Holmes",
        Note = "Base Detective",
        Phone = "0333 003 3577",
        AltPhone = "0333 003 3512",
        Email = "watson@sherlockholmes.com",
        Url = "http://sherlockholmes.com/",
        BirthDay = new DateTime(1854, 1, 6),
        Address = new Address()
        {
            Street = "221B Baker Street",
            City = "London",
            State = "NW",
            ZIP = "NW16XE",
            Country = "England"
        }
    };
    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to Address instance
        Data = card,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Width = 100,
        Height = 100,
        Margin = new Padding(10)
    };

    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## Sign PDF with EPC payment in the QR-Code image

This example shows how to esign PDF with EPC / SEPA payment inside the QR-code image.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create EPC object
    EPC epc = new EPC()
    {
        Name = "Sherlock",
        BIC = "MrSherlockH",
        IBAN = "BE72000000001616",
        Amount = 123456.78D,
        Code = "SHRL",
        Reference = "Private service",
        Information = "Thanks for help"
    };
    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to Address instance
        Data = epc,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Width = 100,
        Height = 100,
        Margin = new Padding(10)
    };
    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## Sign PDF with Event information in the QR-Code image

This example shows how to esign PDF with event data inside the QR-code image.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create Event object
    Event evnt = new Event()
    {
        Title = "GTM(9-00)",
        Description = "General Team Meeting",
        Location = "Conference-Room",
        StartDate = DateTime.Now.Date.AddDays(1).AddHours(9),
        EndDate = DateTime.Now.Date.AddDays(1).AddHours(9).AddMinutes(30)
    };
    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to Address instance
        Data = evnt,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Width = 100,
        Height = 100,
        Margin = new Padding(10)
    };
    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## Sign PDF with CryptoCurrencyTransfer information in the QR-Code image

This example shows how to esign PDF with Cryptocurrency transfer data inside the QR-code image.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create crypto currency object
    CryptoCurrencyTransfer transfer = new CryptoCurrencyTransfer()
    {
        Type = CryptoCurrencyType.Bitcoin,
        Address = "1JHG2qjdk5Khiq7X5xQrr1wfigepJEK3t",
        Amount = 1234.56M,
        Message = "Consulting services"
    };
    // create alternative crypto currency object
    CryptoCurrencyTransfer customTransfer = new CryptoCurrencyTransfer()
    {
        Type = CryptoCurrencyType.Custom,
        CustomType = @"SuperCoin",
        Address = @"15N3yGu3UFHeyUNdzQ5sS3aRFRzu5Ae7EZ",
        Amount = 6543.21M,
        Message = @"Accounting services"
    };
    // create QR-code options
    QrCodeSignOptions options1 = new QrCodeSignOptions
    {
        // setup Data property to Address instance
        Data = transfer,
        Left = 10,
        Top = 10,
    };
    // create alternative QR-code options
    QrCodeSignOptions options2 = new QrCodeSignOptions
    {
        // setup Data property to Address instance
        Data = customTransfer,
        Left = 10,
        Top = 200
    };
    List<SignOptions> listOptions = new List<SignOptions>() { options1, options2 };
    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## Create an image with the WiFi QR Code information

This example shows how to create an image with the WiFi QR Code object.

```csharp
using (Signature signature = new Signature("sample.png"))
{
    // create WiFi object
    WiFi wifi  = new WiFi()
    {
        SSID = "GuestNetwork!",
        Encryption = WiFiEncryptionType.WPAWPA2,
        Password = "guest",
        Hidden = false
    };

    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to WiFi object instance
        Data = wifi,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Width = 100,
        Height = 100,
        Margin = new Padding(10)
    };

    // sign document to image file
    signature.Sign("output.png", options);
}
```

## Sign PDF with SMS data information in the QR-Code

This example shows how to esign PDF with QR Code SMS data on the PDF page. This could be used for automatic document verification or subscription. 

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create SMS object
    SMS sms = new SMS()
    {
        Number = "0800 048 0408",
        Message = "Document approval automatic SMS message"
    };
    // create options
    QrCodeSignOptions options = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        // setup Data property to Address instance
        Data = sms,
        // set right bottom corner
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Bottom,
        Width = 100,
        Height = 100,
        Margin = new Padding(10)
    };
    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign Word Processing document with Metadata signatur

Path: /signature/java/esign-word-processing-document-with-metadata-signatur/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [WordProcessingMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/WordProcessingMetadataSignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) instance to sign Word Processing document files.   
Word Processing document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Word Processing document metadata contains pair of Name and Value, Name should be unique within the document.  
Word Processing document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there.

Here are the steps to add metadata signatures into Word Processing document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) object according to your requirements.    
*   Instantiate one or several[WordProcessingMetadataSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/WordProcessingMetadataSignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to metadata signatures collection ([getSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions#getSignatures())) via [add](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.metadata/MetadataSignatureCollection#add(com.groupdocs.signature.domain.signatures.metadata.MetadataSignature)) or addRange method.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) to it. 
    

## How to eSign Word Processing document with Metadata signature

This example shows how to sign Word Processing document with Metadata e-signature.

```java
Signature signature = new Signature("sample.docx");
// setup options with text of signature
MetadataSignOptions options = new MetadataSignOptions();

// Create few WordProcessing Metadata signatures
WordProcessingMetadataSignature[] signatures = new WordProcessingMetadataSignature[]
        {
                new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes"),
                new WordProcessingMetadataSignature("DateCreated", new Date()),
                new WordProcessingMetadataSignature("DocumentId", 123456),
                new WordProcessingMetadataSignature("SignatureId", 123.456)
        };
options.getSignatures().addRange(signatures);

// sign document to file
signature.sign("SampleSigned.docx", options);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Digital signatures from documents

Path: /signature/java/delete-digital-signatures-from-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [DigitalSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/DigitalSignature) class to manipulate digital electronic signatures and delete them from the documents.
Please be aware that [delete](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#delete(java.lang.String,%20int)) method modifies the same document that was passed to constructor of the [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class.

*Important information*. Please be aware that digitally signed documents with valid certificates (pfx files) are secured and verified. Changing digitally signed document makes them untrusted from the digital verification perspective. At this moment only Pdf documents support deletion of the specific digital signatures in case of many ones were added. Most documents support deletion of all digital signatures at once without separate certificates removal. It's strongly recommened to use deletion of electronic digital signatures by signature type Digital. See example [Delete Signatures of the certain type]

Here are the steps to delete Digital signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path or its stream as a constructor parameter;
* Instantiate [DigitalSearchOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/DigitalSearchOptions) object with desired properties;
* Call [search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [DigitalSignatures](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/DigitalSignature);
* Select from list [DigitalSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/DigitalSignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#delete(java.lang.String,%20com.groupdocs.signature.domain.signatures.BaseSignature) method and pass one or several signatures to it.

This example shows how to delete Digital signature that was found using [search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java

final Signature signature = new Signature(outputFilePath);
List<DigitalSignature> signatures = signature.search(DigitalSignature.class, SignatureType.Digital);
if (signatures.size() > 0)
{
	// delete signature
	DigitalSignature digitalSignature = signatures[0];
	boolean deleteResult = signature.delete(new ByteArrayOutputStream(), digitalSignature);	
	if (deleteResult)
	{
				System.out.print("Digital signature #"+digitalSignature.getThumbprint()+" from the "+digitalSignature.getSignTime()+" was deleted from document ['"+fileName+"'].");
	}
	else
	{
		System.out.print("Signature was not deleted from the document! Signature# "+digitalSignature.getThumbprint()+" was not found!");
	}
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [Advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .Net examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.Net)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .Net MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.Net-MVC)
* [Document Signature for .Net App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.Net-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .java library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Digital signatures from documents

Path: /signature/net/delete-digital-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalsignature) class to manipulate digital electronic signatures and delete them from the documents.
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

*Important information*. Please be aware that digitally signed documents with valid certificates (pfx files) are secured and verified. Changing digitally signed document makes them untrusted from the digital verification perspective. At this moment only Pdf documents support deletion of the specific digital signatures in case of many ones were added. Most documents support deletion of all digital signatures at once without separate certificates removal. It's strongly recommened to use deletion of electronic digital signatures by signature type Digital. See example [Delete Signatures of the certain type]

## How to delete Digital signature from the document
Here are the steps to delete Digital signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or its stream as a constructor parameter;
* Instantiate [DigitalSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [DigitalSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalsignature);
* Select from list [DigitalSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalsignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.

This example shows how to delete Digital signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    // Search for electronic Digital signatures in the document
    List<DigitalSignature> signatures = 
        signature.Search<DigitalSignature>(SignatureType.Digital);

    if (signatures.Count > 0)
    {
        DigitalSignature digitalSignature = signatures[0];
        bool result = signature.Delete(digitalSignature);

        if (result)
        {
            Console.WriteLine(
                $"Digital signature #{digitalSignature.Thumbprint} from " +
                $"{digitalSignature.SignTime.ToShortDateString()} was deleted."
            );
        }
        else
        {
            Console.WriteLine(
                $"Signature was not deleted from the document! " +
                $"Signature# {digitalSignature.Thumbprint} was not found!"
            );
        }
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [Advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Deleting Text signatures - advanced

Path: /signature/java/deleting-text-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) class to manipulate text signatures and delete them from the documents over [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method.  
Please be aware that [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class.

Here are the steps to delete Text signature from the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) object with desired properties;
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [TextSignatures](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature);  
    
*   Select from list [TextSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) object(s) that should be removed from the document;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not.

Here are the alternative steps to delete Text signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) methods.

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate one or several [TextSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) objects with signature Id(s) passed to constructor;  
    
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature))  method and pass one or several signatures to it;
    
*   Analyze [DeleteResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/DeleteResult) result to check whether signatures were updated or not. 

## Delete Text signature from the document after Search

This example shows how to delete Text signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("signed.pdf");
 
TextSearchOptions options = new TextSearchOptions();
 
List<TextSignature> signatures = signature.search(TextSignature.class,options);
List<BaseSignature> signaturesToDelete = new ArrayList<BaseSignature>();
// collect signatures to delete
for (TextSignature temp : signatures)
{
    if (temp.getText().contains("JS"))
    {
        signaturesToDelete.add(temp);
    }
}
// delete signatures
DeleteResult deleteResult = signature.delete("signed.pdf", signaturesToDelete);
if (deleteResult.getSucceeded().size() == signaturesToDelete.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : " + deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : " + deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Delete Text signature from the document by known signature Identifier

This example shows how to delete Text signature in the document by known signature Id (that was obtained by  [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method previously).

```java
// initialize Signature instance
using (Signature signature = new Signature("signed.xlsx"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of Text Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new TextSignature(p)));
    // delete required signatures
    DeleteResult deleteResult = signature.Delete(signatures);
    if (deleteResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
// initialize Signature instance
Signature signature = new Signature("signed.xlsx");        
// read from some data source signature Id value        
String[] signatureIdList = new String[]
        {
                "a6fec431-111e-4572-950c-5cc5f1c85d36",
                "b0123987-b0d4-4004-86ec-30ab5c41ac7e"
        };
// create list of Text Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList)
{
    signatures.add(new TextSignature(item));
}
 
// delete required signatures
DeleteResult deleteResult = signature.delete("signed.xlsx", signatures);
if (deleteResult.getSucceeded().size() == signatures.size())
{
    System.out.print("All signatures were successfully deleted!");
}
else
{
    System.out.print("Successfully deleted signatures : " + deleteResult.getSucceeded().size());
    System.out.print("Not deleted signatures : " + deleteResult.getFailed().size());
}
System.out.print("List of deleted signatures:");
for(BaseSignature temp : deleteResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Deleting Text signatures - advanced

Path: /signature/net/deleting-text-signatures-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) class to manipulate text signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to delete Text signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [TextSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature);
* Select from list [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) object(s) that should be removed from the document;  
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

Here are the alternative steps to delete Text signature from the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) objects with signature Id(s) passed to constructor;  
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass one or several signatures to it;
* Analyze [DeleteResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/deleteresult) result to check whether signatures were updated or not.

## Delete Text signature from the document after Search

This example shows how to delete Text signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.pdf"))
{
    TextSearchOptions options = new TextSearchOptions();
    List<TextSignature> signatures = signature.Search<TextSignature>(options);
    List<BaseSignature> signaturesToDelete = new List<BaseSignature>();
    // collect signatures to delete
    foreach (TextSignature temp in signatures)
    {
        if (temp.Text.Contains("John"))
        {
            signaturesToDelete.Add(temp);
        }
    }
    // delete signatures
    DeleteResult deleteResult = signature.Delete(signaturesToDelete);
    if (deleteResult.Succeeded.Count == signaturesToDelete.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Delete Text signature from the document by known signature Identifier  

This example shows how to delete Text signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously).

```csharp
// initialize Signature instance
using (Signature signature = new Signature("signed.xlsx"))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of Text Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new TextSignature(p)));
    // delete required signatures
    DeleteResult deleteResult = signature.Delete(signatures);
    if (deleteResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully deleted!");
    }
    else
    {
        Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
        Console.WriteLine($"Not deleted signatures : {deleteResult.Failed.Count}");
    }
    Console.WriteLine("List of deleted signatures:");
    foreach (BaseSignature temp in deleteResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Updating Text signature with advanced options

Path: /signature/net/updating-text-signature-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) class to manipulate text signatures location, size and textual content over [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) object to analyze if signatures were successfully processed.

Please be aware that [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class. The [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) contains list of successfully updated signatures and ones that failed. The Text signature could be failed to update due to several reasons:

* if signature object was initialized with constructor by incorrect signature identifier;
* if signature object was not found;
* there was an error occurred while updating signature in the document.

Here are the steps to update Text signature in the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method to obtain list of [TextSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature);
* Select from list [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) object(s) that should be updated;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it.
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

Here are the alternative steps to update Text signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) methods.

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate one or several [TextSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/textsignature) objects with signature Id(s) passed to constructor;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class object [Update](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/update/) method and pass one or several signatures to it;
* Analyze [UpdateResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/updateresult) result to check whether signatures were updated or not.

The following table describes changeable properties for Text signatures dependent on document type.

| Document Type / Signature Property | Left | Top | Width | Height | Text | IsSignature |
| --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) | ![(error)](/signature/net/images/error.png) |
| Spreadsheet | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| Pdf | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| Presentation | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |
| Word Processing | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) | ![(tick)](/signature/net/images/check.png) |

## Update Text signature in the document after Search

This example shows how to update Text signature that was found using [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method.

```csharp
//
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    TextSearchOptions options = new TextSearchOptions();
    // search for text signatures in document
    List<TextSignature> signatures = signature.Search<TextSignature>(options);
    // adjust signature properties
    foreach(TextSignature temp in signatures)
    {
        // apply some condition to adjust signature properties
        if(temp.Text == "Test1")
        {
            temp.Left = temp.Left + 10;
            temp.Text = "Test2";
        }
        temp.IsSignature = true;
    }
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures.ConvertAll(p => (BaseSignature)p));
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("All signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## Update Text signature in document by known signature Identifier  

This example shows how to update Text signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) or [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method previously) and analyze result.

```csharp
// initialize Signature instance
using (Signature signature = new Signature(outputFilePath))
{
    // read from some data source signature Id value
    string[] signatureIdList = new string[]
    {
        "1dd21cf3-b904-4da9-9413-1ff1dab51974",
        "9e386726-a773-4971-b2fc-eaadfce65ffd"
    };
    // create list of Text Signature by known SignatureId
    List<BaseSignature> signatures = new List<BaseSignature>();
    signatureIdList.ToList().ForEach(p => signatures.Add(new TextSignature(p)));
    // update all found signatures
    UpdateResult updateResult = signature.Update(signatures);
    if (updateResult.Succeeded.Count == signatures.Count)
    {
        Console.WriteLine("\nAll signatures were successfully updated!");
    }
    else
    {
        Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
        Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
    }
    Console.WriteLine("List of updated signatures:");
    foreach (BaseSignature temp in updateResult.Succeeded)
    {
        Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete signatures of the certain type

Path: /signature/python-net/delete-signatures-of-the-certain-type/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides ability to delete signatures of the certain type from the documents over [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

## How to delete signatures of the certain type from the document
Here are the steps to delete signatures of the certain type from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [SearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/searchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain list of signatures;
* Select from list signature object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.  

This example shows how to delete signatures of the certain type that was found using [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method.

```python
import groupdocs.signature as signature
from groupdocs.signature.options import SearchOptions

# Initialize signature
with signature.Signature("signed.docx") as sign:
    # Create search options
    options = SearchOptions()
    
    # Search for signatures in the document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        # Get first signature
        signature_to_delete = signatures[0]
        result = sign.delete(signature_to_delete)
        
        if result:
            print(
                f"Signature of type {signature_to_delete.signature_type} "
                f"was deleted from document ['{fileName}']."
            )
        else:
            print(
                f"Signature was not deleted from the document! "
                f"Signature of type {signature_to_delete.signature_type} "
                f"was not found!"
            )
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Advanced search for Image signatures

Path: /signature/java/advanced-search-for-image-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions)  class to specify different options to search for Image Signatures.

Here are the steps to search for image signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions)  object according to your requirements and specify search options 
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) to it.
    

This example shows how to make advanced search for Image signature in the document and further image signatures analyzes with saving image content

```java
Signature signature = new Signature(sample.pdf);
 
PagesSetup pS = new  PagesSetup();
pS.setFirstPage(true);
pS.setLastPage(true);
pS.setOddPages(false);
pS.setEvenPages(false);
// setup search options
ImageSearchOptions searchOptions = new ImageSearchOptions();
searchOptions.setAllPages(false);
searchOptions.setPageNumber(1);
searchOptions.setPagesSetup(pS);
 
// search document
List<ImageSignature> signatures = signature.search(ImageSignature.class,searchOptions);
System.out.print("\nSource document ['" + fileName + "'] contains following image signature(s).");
// output signatures
//foreach to while statements conversion
try
{
    for (ImageSignature sign : signatures)
    {
 
        System.out.print("Found Image signature at page "+sign.getPageNumber()+" and size "+sign.getSize()+".");
        System.out.print("Location at "+sign.getLeft()+"-"+sign.getTop()+". Size is "+sign.getWidth()+"x"+sign.getHeight()+".");
    }
}
catch (Exception ex)
{
    System.out.print("System Exception: " + ex.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Advanced search for Text signatures

Path: /signature/net/advanced-search-for-text-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) class to specify different options to search for Text Signatures.

Here are the steps to search for text signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) object according to your requirements and specify search options.
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) to it.

This example shows how to make advanced search for Text signature in the document.

```csharp
using (Signature signature = new Signature(sample.pdf))
{
    // setup search options
    TextSearchOptions searchOptions = new TextSearchOptions()
    {
        // specify special pages to search on
        AllPages = false,
        // single page number
        PageNumber = 1,
        // setup extended search in pages setup
        PagesSetup = new PagesSetup() { FirstPage = true, LastPage = true, OddPages = false, EvenPages = false },
        // specify text match type
        MatchType = TextMatchType.Exact,
        // specify text pattern to search
        Text = "John Smith"
    };

    // search document
    List<TextSignature> signatures = signature.Search<TextSignature>(searchOptions);

    // output signatures
    foreach (TextSignature textSignature in signatures)
    {
        if (textSignature != null)
        {
            Console.Write($"Found Text signature: {textSignature.SignatureImplementation} with text {textSignature.Text}.");
            Console.WriteLine($"Location at {textSignature.Left}-{textSignature.Top}. Size is {textSignature.Width}x{textSignature.Height}.");
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for Form Field e-signatures

Path: /signature/net/search-for-form-field-e-signatures/

To search for Form Fields e-signatures inside document you should pass instance of [FormFieldSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsearchoptions) class to a Search method of [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net).  
Here are the guide for searching Form Field e-signatures:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [FormFieldSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsearchoptions) object according to your requirements and specify additional search options (if needed);
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [FormFieldSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsearchoptions) to it.

This example shows how to search for Form Field signatures in the document.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    // search for signatures in document
    List<FormFieldSignature> signatures = signature.Search<FormFieldSignature>(SignatureType.FormField);

    foreach (var formFieldSignature in signatures)
    {
        Console.WriteLine("FormField signature found. Name : {0}. Value: {1}", 
            formFieldSignature.Name, formFieldSignature.Value);
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for Metadata e-Signatures

Path: /signature/python-net/search-for-metadata-e-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/python-net) provides the ability to search for metadata electronic signatures in documents. Metadata signatures allow you to add custom metadata properties to your documents, which can be used to store additional information about the document or its signatures.

## How to Search for Metadata Signatures

The [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class provides the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method which allows you to search for metadata signatures in documents. Here's how to use it:

1. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class and pass the source document path as a parameter.
2. Create an instance of [MetadataSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasearchoptions/) class.
3. Call the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class instance and pass the search options to it.
4. Process the search results.

Here's an example of how to search for metadata signatures in a document:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import MetadataSearchOptions
from groupdocs.signature.domain import MetadataSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = MetadataSearchOptions()
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} metadata signatures")
    for metadata_signature in result:
        print(f"Name: {metadata_signature.name}")
        print(f"Value: {metadata_signature.value}")
```

## Advanced Search Options

You can customize the search process by setting specific options:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import MetadataSearchOptions
from groupdocs.signature.domain import MetadataSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = MetadataSearchOptions()
    
    # Set search criteria
    search_options.name = "Author"  # Search for specific metadata name
    search_options.value = "John Doe"  # Search for specific metadata value
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} metadata signatures")
    for metadata_signature in result:
        print(f"Name: {metadata_signature.name}")
        print(f"Value: {metadata_signature.value}")
```

## Additional Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our examples:

* [GroupDocs.Signature for Python via .NET Examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)
* [GroupDocs.Signature for Python via .NET Plugins](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Plugins)
* [GroupDocs.Signature for Python via .NET Showcase Apps](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Showcase)

### Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to search for metadata signatures in documents with our free online apps:

* [Search for Metadata Signatures Online](https://products.groupdocs.app/signature/search/family)
---

## Search for Text e-signatures

Path: /signature/java/search-for-text-e-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) class to specify different options to search for Text electronic signatures within document.

Here are the steps to search for Text e-signatures using GroupDocs.Signature API:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate the [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) object according to your requirements and specify additional search options (if needed);      
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class instance and pass [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) to it.
    

This example shows how to search for Text e-signature in the document.

```java
Signature signature = new Signature(sample.pdf);
 
// setup search options
TextSearchOptions options = new TextSearchOptions();
// specify as true to search all pages of a document
options.setAllPages(true);
// search only page with specified number
options.setPageNumber(1);
// specify text math type    
options.setMatchType(TextMatchType.Contains);
// specify text to search
options.setText("John Smith");
 
// search for text signatures in document
List<TextSignature> signatures = signature.search(TextSignature.class,options);
// output signatures
 
for (TextSignature textSignature : signatures)
 {
 
     if (textSignature != null)
     {
         System.out.print("Found Text signature at page "+sign.getPageNumber()+" with type ["+sign.getSignatureImplementation()+"] and text '"+sign.getText()+"'.");
         System.out.print("Location at "+sign.getLeft()+"-"+sign.getTop()+". Size is "+sign.getWidth()+"x"+sign.getHeight()+".");
     }
 }
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Accept or Reject revisions

Path: /comparison/java/accept-or-reject-revisions/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to get revisions from a Docx file format, process, and save the processing result.
To take revisions from a document, accept / reject revisions, and write the processing result to the output file, follow these steps:

1.  Instantiate the [RevisionHandler](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionhandler/) object. Specify the source document path or stream.
2.  Call the [getRevisions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionhandler/#getRevisions--) method to get the revision list.
3.  Call the [setAction](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisioninfo/#getAction--) property of the object to be changed. Specify the [RevisionAction.ACCEPT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionaction/#ACCEPT) or [RevisionAction.REJECT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionaction/#REJECT) value.
4.  Call the [applyRevisionChanges](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionhandler/#applyRevisionChanges-com.groupdocs.comparison.words.revision.ApplyRevisionOptions-) method. Specify the created instance of the [ApplyRevisionOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/applyrevisionoptions/) class and path or stream of the output document, collecting changes in the revisions.

You can process all changes together within one action.To handle all changes at once, follow these steps:

1.  Instantiate the [RevisionHandler](https://reference.groupdocs.com/comparison/java/groupdocs.comparison.words.revision/revisionhandler) object. Specify the source document path or stream.
2.  Call the [applyRevisionChanges](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionhandler/#applyRevisionChanges-com.groupdocs.comparison.words.revision.ApplyRevisionOptions-) method. Specify the [ApplyRevisionOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/applyrevisionoptions/) object and one of the ([RevisionAction.Accept](https://reference.groupdocs.com/comparison/java/groupdocs.comparison.words.revision/revisionaction), [RevisionAction.Reject](https://reference.groupdocs.com/comparison/java/groupdocs.comparison.words.revision/revisionaction) or [RevisionAction.NONE](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionaction/#NONE)) values.

The main properties of the [ApplyRevisionOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/applyrevisionoptions/) class are as follows:

*   [Changes](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/applyrevisionoptions/#getChanges--) is a list of revision changes that need to be applied to the final document
*   [CommonHandler](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/applyrevisionoptions/#getCommonHandler--) allows you to define one action to handle all revision

If you do not specify the path or file to the output document for the [applyRevisionChanges](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.words.revision/revisionhandler/#applyRevisionChanges-com.groupdocs.comparison.words.revision.ApplyRevisionOptions-) method, the source file is rewritten.

The following code snippets show how to get revisions from a document, accept / reject detected revisions and save changes to the output document:

## Accept or Reject revisions from local disk

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.words.revision.*;
import java.util.List;
// ...

try (RevisionHandler revisionHandler = new RevisionHandler(withRevisionFile)) {
    List<RevisionInfo> revisionList = revisionHandler.getRevisions();
    for (RevisionInfo revision : revisionList) {
        if (revision.getType() == RevisionType.INSERTION) {
            revision.setAction(RevisionAction.ACCEPT);
        }
    }
    ApplyRevisionOptions revisionOptions = new ApplyRevisionOptions();
    revisionOptions.setChanges(revisionList);
    revisionHandler.applyRevisionChanges(resultFile, revisionOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Accept or Reject revisions from stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.words.revision.*;
import java.util.List;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.FileOutputStream;
import java.io.OutputStream;
// ...

try (RevisionHandler revisionHandler = new RevisionHandler(withRevisionInputStream)) {
    List<RevisionInfo> revisionList = revisionHandler.getRevisions();
    for (RevisionInfo revision : revisionList) {
        if (revision.getType() == RevisionType.Insertion) {
            revision.setAction(RevisionAction.Accept);
        }
    }
    ApplyRevisionOptions revisionOptions = new ApplyRevisionOptions(revisionList);
    revisionHandler.applyRevisionChanges(resultOutputStream, revisionOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Accept or Reject all revisions

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.words.revision.*;
// ...

try (RevisionHandler revisionHandler = new RevisionHandler(withRevisionFile)) {
    ApplyRevisionOptions revisionOptions = new ApplyRevisionOptions();
    revisionOptions.setCommonHandler(RevisionAction.Accept);
    revisionHandler.applyRevisionChanges(resultFile, revisionOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Result of revision processing

Below are the source and output files based on the code presented earlier.

| Source file                                   | Result file                                          |
| --------------------------------------------- | ---------------------------------------------------- |
| ![](/comparison/java/images/revision-file.png) | ![](/comparison/java/images/result-revision-file.png) |

---

## Accept or Reject revisions

Path: /comparison/net/accept-or-reject-revisions/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to get revisions from a Docx file format, process, and save the processing result.
To take revisions from a document,_accept / reject revisions, and write the processing result to the output file, follow these steps:

1.  Instantiate the [RevisionHandler](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionhandler) object. Specify the source document path or stream.
2.  Call the [GetRevisions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionhandler/methods/getrevisions) method to get the revision list.
3.  Set the [Action](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisioninfo/properties/action) property of the object to be changed to the [RevisionAction.Accept](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionaction) or [RevisionAction.Reject](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionaction) value.
4.  Call the [ApplyRevisionChanges](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionhandler/methods/applyrevisionchanges/index) method. Specify the created instance of the [ApplyRevisionOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/applyrevisionoptions) class and path or stream of the output document, collecting changes in the revisions.

You can process all changes together within one action.To handle all changes at once, follow these steps:

1.  Instantiate the [RevisionHandler](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionhandler) object. Specify the source document path or stream.
2.  Call the [ApplyRevisionChanges](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionhandler/methods/applyrevisionchanges/index) method. Specify the [ApplyRevisionOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/applyrevisionoptions) object and one of the ([RevisionAction.Accept](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionaction), [RevisionAction.Reject](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionaction) or [RevisionAction.None](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionaction)) values.

The main properties of the [ApplyRevisionOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/applyrevisionoptions) class are as follows:

*   [Changes](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/applyrevisionoptions/properties/changes) is a list of revision changes that need to be applied to the final document
*   [CommonHandler](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/applyrevisionoptions/fields/commonhandler) allows you to define one action to handle all revision

If you do not specify the path or file to the output document for the [ApplyRevisionChanges](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.words.revision/revisionhandler/methods/applyrevisionchanges) method, the source file is rewritten.

The following code snippets show how to get revisions from a document, accept / reject detected revisions and save changes to the output document:

## Accept or Reject revisions from local disk

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.Collections.Generic;
using GroupDocs.Comparison.Words.Revision;
// ...

using (RevisionHandler revisionHandler = new RevisionHandler(
    pathRevision + "Document_with_revision.docx"))
{
    List<RevisionInfo> revisionList = revisionHandler.GetRevisions();
    foreach (RevisionInfo revision in revisionList)
    {
        if (revision.Type == RevisionType.Insertion) revision.Action = RevisionAction.Accept;
    }
    revisionHandler.ApplyRevisionChanges(pathRevision + "result.docx", new ApplyRevisionOptions() 
    { 
        Changes = revisionList 
    });
}
```
{{< /tab >}}
{{< /tabs >}}

## Accept or Reject revisions from stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.Collections.Generic;
using GroupDocs.Comparison.Words.Revision;
// ...

using (RevisionHandler revisionHandler = new RevisionHandler(
    File.OpenRead("Document_with_revision.docx")))
{
    List<RevisionInfo> revisionList = revisionHandler.GetRevisions();
    foreach (RevisionInfo revision in revisionList)
    {
        if (revision.Type == RevisionType.Insertion) revision.Action = RevisionAction.Accept;
    }
    revisionHandler.ApplyRevisionChanges(pathRevision + "result.docx", new ApplyRevisionOptions() 
    { 
        Changes = revisionList 
    });
}
```
{{< /tab >}}
{{< /tabs >}}

## Accept or Reject all revisions

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.Collections.Generic;
using GroupDocs.Comparison.Words.Revision;
// ...

using (RevisionHandler revisionHandler = new RevisionHandler(
    pathRevision + "Document_with_revision.docx"))
{
    revisionHandler.ApplyRevisionChanges(pathRevision + "result.docx", new ApplyRevisionOptions() 
    { 
        CommonHandler = RevisionAction.Accept 
    });
}
```
{{< /tab >}}
{{< /tabs >}}

## Result of revision processing

Below are the source and output files based on the code presented earlier.

| Source file                                   | Result file                                          |
| --------------------------------------------- | ---------------------------------------------------- |
| ![](/comparison/net/images/revision-file.png) | ![](/comparison/net/images/result-revision-file.png) |

---

## Accept or Reject revisions

Path: /comparison/nodejs-java/accept-or-reject-revisions/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to get revisions from a DOCX file format, process, and save the processing result.

The main properties of the `ApplyRevisionOptions` class are as follows:

*   `Changes` is a list of revision changes that need to be applied to the final document
*   `CommonHandler` allows you to define one action to handle all revision

If you do not specify the path or file to the output document for the `applyRevisionChanges` method, the source file is rewritten.

The following code snippets show how to get revisions from a document, accept or reject the detected revisions and save changes to the output document:

## Accept or Reject revisions from a local disk

The following example loads a DOCX file from disk, accepts all insertion revisions, and saves the updated document.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Initialize RevisionHandler for the source document
const revisionHandler = new groupdocs.RevisionHandler('sample-files/revision.docx');

// Retrieve all revisions from the document
const revisionList = revisionHandler.getRevisions();

// Iterate through each revision and accept insertions
for (let i = 0; i < revisionList.length; i++) {
  const revision = revisionList[i];

  // If the revision type is an insertion, set its action to ACCEPT
  if (revision.getType() === groupdocs.RevisionType.INSERTION) {
    // Mark insertion revision for acceptance
    revision.setAction(groupdocs.RevisionAction.ACCEPT);
  }
}

// Prepare options for applying revisions
const revisionOptions = new groupdocs.ApplyRevisionOptions();

// Assign the modified revision list to the options
revisionOptions.setChanges(revisionList);

// Apply the revision changes and save the result to a new file
revisionHandler.applyRevisionChanges('result.docx', revisionOptions);

// Exit the process
process.exit(0);
```

This example creates a `RevisionHandler` instance with the source document path, retrieves all revisions using `getRevisions()`, and iterates through them to identify insertion-type revisions. It marks insertion revisions for acceptance using `setAction(RevisionAction.ACCEPT)`, creates an `ApplyRevisionOptions` object with the modified revision list, and applies the changes to save a new document where all insertion revisions have been accepted.

## Accept or Reject revisions from a stream

The following example performs the same operation using a Java input stream as the revision source and writes the result to an output stream.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Load Java integration module for file streams
const java = require('java');
let InputStream = java.import('java.io.FileInputStream');
let OutputStream = java.import('java.io.FileOutputStream');

// Create input stream for the source document that contains revisions
const revisionInputStream = new InputStream('sample-files/revision.docx');

// Initialize RevisionHandler with the source document stream
const revisionHandler = new groupdocs.RevisionHandler(revisionInputStream, groupdocs.FileType.DOCX);

// Retrieve all revisions from the document
const revisionList = revisionHandler.getRevisions();

// Iterate through revisions and accept all insertions
for (let i = 0; i < revisionList.length; i++) {
  const revision = revisionList[i];

  // Check if the revision is an insertion type
  if (revision.getType() === groupdocs.RevisionType.Insertion) {
    // Mark the insertion revision to be accepted
    revision.setAction(groupdocs.RevisionAction.Accept);
  }
}

// Prepare output stream for the document after applying revisions
const resultOutputStream = new OutputStream('result-document.docx');

// Configure options with the modified revision list
const revisionOptions = new groupdocs.ApplyRevisionOptions(revisionList);

// Apply the revision changes and write the result to the output stream
revisionHandler.applyRevisionChanges(resultOutputStream, revisionOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates the same workflow using Java input and output streams instead of file paths. It creates a `RevisionHandler` with an input stream and the document file type, retrieves revisions, marks insertion revisions for acceptance, and creates an `ApplyRevisionOptions` object initialized directly with the revision list. The `applyRevisionChanges()` method is then called with an output stream to write the processed document directly to a stream without intermediate file operations.

## Accept or Reject all revisions

The following example shows how to accept all revisions in a document using a single common handler action.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import Java classes for file input stream handling
const java = require('java');
const InputStream = java.import('java.io.FileInputStream');

// Define file paths for input revision document and output result document
const revisionFile = 'sample-files/revision.docx';
const resultFile = 'result.docx';

// Create a file input stream from the revision document
const revisionStream = new InputStream(revisionFile);

// Initialize RevisionHandler with the revision file stream and document type
const revisionHandler = new groupdocs.RevisionHandler(revisionStream, groupdocs.FileType.DOCX);

// Create ApplyRevisionOptions instance
const ApplyRevisionOptions = groupdocs.ApplyRevisionOptions;
const applyOptions = new ApplyRevisionOptions();

// Set the common handler to Accept all revisions
// This applies the Accept action to all revisions in the document
applyOptions.setCommonHandler(groupdocs.RevisionAction.Accept);

// Apply the revision changes to the result file using the configured options
revisionHandler.applyRevisionChanges(resultFile, applyOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example shows a simplified approach for processing all revisions at once. It creates a `RevisionHandler` with a revision document stream and file type, creates an `ApplyRevisionOptions` object, and uses `setCommonHandler(RevisionAction.Accept)` to apply a single action to all revisions without needing to iterate through them individually. This is more efficient when you want to accept or reject all revisions uniformly.

## Result of revision processing

Below are the source and output files based on the code presented earlier.

| Source file                                   | Result file                                          |
| --------------------------------------------- | ---------------------------------------------------- |
| ![](/comparison/nodejs-java/images/revision-file.png) | ![](/comparison/nodejs-java/images/result-revision-file.png) |

---

## Add a Watermark to Converted Document

Path: /conversion/python-net/developer-guide/converting-documents/add-watermark-to-converted-document/


This topic explains how to add a watermark during the conversion process using GroupDocs.Conversion for Python via .NET. The watermark can be applied to a document as it is converted to another format, helping to protect the content and ensure it is identifiable.

To enable watermarking, you can use the `watermark` attribute in the appropriate `ConvertOptions` classes. Below are the supported `ConvertOptions` classes that allow you to configure the watermark during conversion:

{{< alert style="tip" >}}
Looking for advanced watermarking capabilities? While GroupDocs.Conversion offers basic watermarking, you can explore [GroupDocs.Watermark](https://products.groupdocs.com/watermark/) for a comprehensive solution with enhanced features.
{{< /alert >}}

## Supported ConvertOptions Classes

The following `ConvertOptions` classes that provide `watermark` attribute.

- **PdfConvertOptions** – Options for converting to [PDF]({{< ref "conversion/python-net/supported-file-formats#pdf" >}}) format.
- **WordProcessingConvertOptions** – Options for converting to [Word Processing]({{< ref "conversion/python-net/supported-file-formats#word-processing" >}}) formats.
- **SpreadsheetConvertOptions** – Options for converting to [Spreadsheet]({{< ref "conversion/python-net/supported-file-formats#spreadsheet" >}}) formats.
- **PresentationConvertOptions** – Options for converting to [Presentation]({{< ref "conversion/python-net/supported-file-formats#presentation" >}}) formats.
- **ImageConvertOptions** – Options for converting to [Image]({{< ref "conversion/python-net/supported-file-formats#image" >}}) formats (e.g., PNG, JPEG).
- **WebConvertOptions** – Options for converting to [Web]({{< ref "conversion/python-net/supported-file-formats#web" >}}) formats (e.g., HTML).
- **PageDescriptionLanguageConvertOptions** – Options for converting to [Page Description Language]({{< ref "conversion/python-net/supported-file-formats#page-description-language" >}}) formats (e.g., PostScript).
- **EBookConvertOptions** – Options for converting to [EBook]({{< ref "conversion/python-net/supported-file-formats#ebook" >}}) formats (e.g., EPUB, MOBI).
- **DiagramConvertOptions** – Options for converting to [Diagram]({{< ref "conversion/python-net/supported-file-formats#diagram" >}}) formats (e.g., VSDX).

## WatermarkTextOptions Class Attributes

The `WatermarkTextOptions` class is used to configure the appearance of the watermark. The following options can be configured for adding a watermark:

- **text**: The text to be used for the watermark.
- **font**: The font name used for the watermark text.
- **color**: The color of the watermark text.
- **width**: The width of the watermark.
- **height**: The height of the watermark.
- **top**: The top position of the watermark.
- **left**: The left position of the watermark.
- **rotation_angle**: The rotation angle of the watermark.
- **transparency**: The transparency level of the watermark.
- **background**: Specifies whether the watermark is stamped as a background. If set to `True`, the watermark is placed at the bottom. By default, it is `False`, and the watermark is placed on top of the content.

## Example: Add a Watermark to Converted Document

The following example demonstrates how to convert DOCX document to PDF and add a watermark:

{{< tabs "example-1">}}
{{< tab "add_watermark_to_converted_document.py" >}}  
```python
from groupdocs.pydrawing import Color
from groupdocs.conversion import Converter
from groupdocs.conversion.options.convert import PdfConvertOptions, WatermarkTextOptions

def add_watermark_to_converted_document():
    # Instantiate Converter with the input document 
    with Converter("./professional-services.docx") as converter:
        # Set up the watermark options
        watermark = WatermarkTextOptions("DRAFT")
        watermark.color = Color.from_argb(128, 211, 211, 211) # lite gray
        watermark.top = 10
        watermark.left = 10
        watermark.width = 300
        watermark.height = 300
        watermark.background = True

        # Set up the conversion options
        options = PdfConvertOptions()
        options.watermark = watermark
        
        # Perform the conversion
        converter.convert("./professional-services.pdf", options)    

if __name__ == "__main__":
    add_watermark_to_converted_document()
```
{{< /tab >}}
{{< tab "professional-services.docx" >}}  
{{< tab-text >}}
`professional-services.docx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/add-watermark-to-converted-document/professional-services.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "professional-services.pdf" >}}  
{{< tab-text >}}
`professional-services.pdf` is the expected output PDF file. Click [here](/conversion/python-net/_sample_files/developer-guide/converting-documents/add-watermark-to-converted-document/professional-services.pdf) to download it.
{{< /tab-text >}}
{{< /tabs >}}

---

## Add document to Diagram via OLE

Path: /merger/java/add-document-to-diagram-via-ole/

## What is OLE object for Diagram?

The OLE technology provided by Microsoft allows to insert some other document content into the shape with size and coordinates which are previosly selected by X, Y, Width and Height of the currently editing Diagram page. For example, the Slides document can be inserted in the Diagram document inside of shape as was presented in the example below.

## Add document to Diagram via OLE

**[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** provides an ability to add other single document as embedded document to Presentation.   
Here are the steps for it:

*   Initialise [OleDiagramOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/OleDiagramOptions) class with embedded file path and page number;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) object with source document path or stream;
*   Call [importDocument](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#importDocument(com.groupdocs.merger.domain.options.interfaces.IImportDocumentOptions)) method and pass [OleDiagramOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/OleDiagramOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add other single document as embedded document to Diagram page:

```csharp
String filePath = "c:\sample.vsdx";
String filePathEmbedded = "c:\embedded.pptx";
String filePathOut = "c:\output\result.vsdx";

int pageNumber = 2;
OleDiagramOptions oleDiagramOptions = new OleDiagramOptions(embeddedFilePath, pageNumber);
oleDiagramOptions.setX(1);
oleDiagramOptions.setY(1);
oleDiagramOptions.setWidth(2);
oleDiagramOptions.setHeight(1);

Merger merger = new Merger(filePath);

merger.importDocument(oleDiagramOptions);
merger.save(filePathOut);

```

---

## Add document to Diagram via OLE

Path: /merger/net/add-document-to-diagram-via-ole/

## What is OLE object for Diagram?

The OLE technology provided by Microsoft allows to insert some other document content into the shape with size and coordinates which are previosly selected by X, Y, Width and Height of the currently editing Diagram page. For example, the Slides document can be inserted in the Diagram document inside of shape as was presented in the example below.

## Add document to Diagram via OLE

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides an ability to add other single document as embedded document to Presentation.   
Here are the steps for it:

*   Initialise [OleDiagramOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/olediagramoptions) class with embedded file path and page number;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [ImportDocument](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/importdocument) method and pass [OleDiagramOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/olediagramoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and pass desired file path to save resultant document.

The following code sample demonstrates how to add other single document as embedded document to Diagram page:

```csharp
string filePath = @"c:\sample.vsdx";
string filePathEmbedded = @"c:\embedded.pptx";
string filePathOut = @"c:\output\result.vsdx";

int pageNumber = 2;
OleDiagramOptions oleDiagramOptions = new OleDiagramOptions(filePathEmbedded, pageNumber);
oleDiagramOptions.X = 1;
oleDiagramOptions.Y = 1;
oleDiagramOptions.Width = 2;
oleDiagramOptions.Height = 1;

using (Merger merger = new Merger(filePath))
{
    merger.ImportDocument(oleDiagramOptions);
    merger.Save(filePathOut);
}

```

---

## Add highlight annotation

Path: /annotation/java/add-highlight-annotation/

Highlight annotation highlights and comments selected text as shown in the picture below:

![](/annotation/java/images/add-highlight-annotation.png)

You can use the following methods to set the properties of the [HighlightAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation) class:

*   [setBackgroundColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation/#setBackgroundColor-java.lang.Integer-) defines the annotation background color
*   [setFontColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation/#setFontColor-java.lang.Integer-) defines the color of annotation text
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation/#setOpacity-java.lang.Double-) - allows you to set the annotation opacity
*   [setPoints()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation/#setPoints-java.util.List-com.groupdocs.annotation.models.Point--) defines the annotation positions as an array of points

To add a highlight annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate [HighlightAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [HighlightAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream. 

The following code snippet shows how to add [HighlightAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/highlightannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding text highlight annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    Point point1 = new Point(80, 730);
    Point point2 = new Point(240, 730);
    Point point3 = new Point(80, 650);
    Point point4 = new Point(240, 650);

    List<Point> points = new ArrayList<Point>();
    points.add(point1);
    points.add(point2);
    points.add(point3);
    points.add(point4);

    // Create an instance of HighlightAnnotation class and set options
    HighlightAnnotation highlight = new HighlightAnnotation();
    highlight.setBackgroundColor(65535);
    highlight.setCreatedOn(Calendar.getInstance().getTime());
    highlight.setFontColor(0);
    highlight.setMessage("This is highlight annotation");
    highlight.setOpacity(0.5);
    highlight.setPageNumber(0);
    highlight.setPoints(points);
    highlight.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(highlight);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add highlight annotation

Path: /annotation/net/add-highlight-annotation/

Highlight annotation highlights and comments selected text as shown in the picture below:

![](/annotation/net/images/add-highlight-annotation.png)

You can set the following properties of the [HighlightAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/highlightannotation) class:

*   [BackgroundColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/backgroundcolor) defines the annotation background color
*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/linkannotation/properties/fontcolor) defines the color of annotation text
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/opacity) - allows you to set the annotation opacity
*   [Points](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/linkannotation/properties/points) defines the annotation positions as an array of points

To add a highlight annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate [HighlightAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/highlightannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [HighlightAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/highlightannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream. 
      
    

The following code snippet shows how to add [HighlightAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/highlightannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add highlight annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	HighlightAnnotation highlight = new HighlightAnnotation
    {
    	BackgroundColor = 65535,
        CreatedOn = DateTime.Now,
        FontColor = 0,
        Message = "This is highlight annotation",
        Opacity = 0.5,
        PageNumber = 0,
        Points = new List<Point>
        {
        	new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650)
        },
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(highlight);
    annotator.Save("result.pdf");
} 

```
{{< /tab >}}
{{< /tabs >}}
---

## Adding metadata

Path: /metadata/java/adding-metadata/

Adding metadata properties is the most sophisticated feature of the GroupDocs.Metadata search engine. When you call the [addProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#addProperties(com.groupdocs.metadata.search.Specification,%20com.groupdocs.metadata.core.PropertyValue)) method it examines all available metadata packages and tries to pick up a known property that would satisfy the specified predicate. Note that the property will be added to metadata packages that fit the following criteria: 

1.  Only existing metadata packages will be affected. No new packages are added during this operation
2.  There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package. All properties supported by a certain package are usually defined in the specification of a particular metadata standard

**advanced\_usage.AddingMetadata**

```csharp
File folder = new File(Constants.InputPath);
for (File file : folder.listFiles()) {
    try (Metadata metadata = new Metadata(file.getAbsolutePath())) {
        if (metadata.getFileFormat() != FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
            System.out.println();
            System.out.println(file.getName());

            // Add a property containing the file last printing date if it's missing
            // Note that the property will be added to metadata packages that satisfy the following criteria:
            // 1) Only existing metadata packages will be affected. No new packages are added during this operation
            // 2) There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package.
            // All properties supported by a certain package are usually defined in the specification of a particular metadata standard
            int affected = metadata.addProperties(new ContainsTagSpecification(Tags.getTime().getPrinted()), new PropertyValue(new Date()));

            System.out.println(String.format("Affected properties: %s", affected));

            metadata.save(Constants.OutputPath + "output." + FilenameUtils.getExtension(file.getName()));
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Adding metadata

Path: /metadata/net/adding-metadata/

Adding metadata properties is the most sophisticated feature of the GroupDocs.Metadata search engine. When you call the [AddProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/addproperties) method it examines all available metadata packages and tries to pick up a known property that would satisfy the specified predicate. Note that the property will be added to metadata packages that fit the following criteria: 

1.  Only existing metadata packages will be affected. No new packages are added during this operation
2.  There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package. All properties supported by a certain package are usually defined in the specification of a particular metadata standard

**AdvancedUsage.AddingMetadata**

```csharp
foreach (string file in Directory.GetFiles(Constants.InputPath))
{
	using (Metadata metadata = new Metadata(file))
	{
		if (metadata.FileFormat != FileFormat.Unknown && !metadata.GetDocumentInfo().IsEncrypted)
		{
			Console.WriteLine();
			Console.WriteLine(file);

			// Add a property containing the file last printing date
			var affected = metadata.AddProperties(p => p.Tags.Contains(Tags.Time.Printed), new PropertyValue(DateTime.Now));
			Console.WriteLine("Affected properties: {0}", affected);

			metadata.Save(Path.Combine(Constants.OutputPath, "output" + Path.GetExtension(file)));
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Adding metadata

Path: /metadata/nodejs-java/adding-metadata/

Adding metadata properties is the most sophisticated feature of the GroupDocs.Metadata search engine. When you call the **addProperties** method it examines all available metadata packages and tries to pick up a known property that would satisfy the specified predicate. Note that the property will be added to metadata packages that fit the following criteria: 

1.  Only existing metadata packages will be affected. No new packages are added during this operation
2.  There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package. All properties supported by a certain package are usually defined in the specification of a particular metadata standard

**advanced\_usage.AddingMetadata**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
fs.readdirSync(Constants.inputPath).forEach(file => {
            var metadata = new groupdocs.metadata.Metadata(Constants.inputPath + file);
            if (metadata.getFileFormat() != groupdocs.metadata.FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
                
                console.log(file);

                // Add a property containing the file last printing date if it's missing
                // Note that the property will be added to metadata packages that satisfy the following criteria:
                // 1) Only existing metadata packages will be affected. No new packages are added during this operation
                // 2) There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package.
                // All properties supported by a certain package are usually defined in the specification of a particular metadata standard
                var affected = metadata.addProperties(new groupdocs.metadata.ContainsTagSpecification(groupdocs.metadata.Tags.getTime().getPrinted()), new groupdocs.metadata.PropertyValue(new Date()));

                console.log(`Affected properties: ${affected}`);
            }
      });
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Adding metadata

Path: /metadata/python-net/adding-metadata/

Adding metadata properties is the most sophisticated feature of the GroupDocs.Metadata search engine. When you call the **addProperties** method it examines all available metadata packages and tries to pick up a known property that would satisfy the specified predicate. Note that the property will be added to metadata packages that fit the following criteria: 

1.  Only existing metadata packages will be affected. No new packages are added during this operation
2.  There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package. All properties supported by a certain package are usually defined in the specification of a particular metadata standard

**advanced\_usage.AddingMetadata**


```python
def run():
    files = os.listdir(constants.input_path)
    for file in files:
        with gm.Metadata(constants.input_path+file) as metadata:
            if metadata.file_format != gm.common.FileFormat.UNKNOWN and metadata.get_document_info().is_encrypted != True:
                print()
                print(file)
				
				# Add a property containing the file last printing date if it's missing
                # Note that the property will be added to metadata packages that satisfy the following criteria:
                # 1) Only existing metadata packages will be affected. No new packages are added during this operation
                # 2) There should be a known metadata property in the package structure that fits the search condition but is actually missing in the package.
                # All properties supported by a certain package are usually defined in the specification of a particular metadata standard
				
                specification = gm.search.ContainsTagSpecification(gm.tagging.Tags.time.printed)
                now = datetime.now()
                property_value = gm.common.PropertyValue(now)
                affected = metadata.add_properties(specification, property_value)
                print(f"Affected properties: {affected}");
                filename, file_extension = os.path.splitext(file)
                metadata.save(constants.output_path + "output" + file_extension)
```


## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Basic Template Syntax - Expression Tags and Fields

Path: /assembly/net/basic-usage-template-syntax-basics/


## Overview

GroupDocs.Assembly for .NET uses a simple, LINQ-based template syntax that allows you to embed C# expressions directly in your documents. Expression tags are the foundation of template syntax, enabling you to output data values and perform calculations.

The main syntax elements are:
- Expression tags `<<[expression]>>` - output expression results
- Data bands `<<foreach>>` - iterate over collections
- Conditional blocks `<<if>>` - display content conditionally

Here are the steps to use basic template syntax:

* Create a template document in Word, Excel, PowerPoint, or HTML format
* Insert expression tags using `<<[expression]>>` syntax
* Reference data source properties and methods in expressions
* Assemble the document with your data source

{{< alert style="info" >}}
Template syntax is case-sensitive and follows C# language rules. Expression tags are evaluated at runtime and replaced with their computed values.
{{< /alert >}}

## Basic Expression Tags

Expression tags are the simplest way to output data in templates. They use the syntax `<<[expression]>>`:

```csharp
using GroupDocs.Assembly;

public static void BasicExpressionTags()
{
    // Sample data
    var person = new { Name = "John Doe", Age = 30, Email = "john@example.com" };
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(person, "person"));
    
    Console.WriteLine("Document assembled with expression tags.");
}
```

## Template Example with Expression Tags

In your template document (Template.docx), use expression tags like this:

```
Name: <<[person.Name]>>
Age: <<[person.Age]>>
Email: <<[person.Email]>>
```

After assembly, the output will be:

```
Name: John Doe
Age: 30
Email: john@example.com
```

## Using Contextual Object Member Access

When using a single data source, you can omit the data source name and use contextual access:

```csharp
using GroupDocs.Assembly;

public static void ContextualAccess()
{
    var product = new { Name = "Laptop", Price = 999.99m, Stock = 50 };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(product));
    
    Console.WriteLine("Document assembled with contextual access.");
}
```

Template with contextual access:

```
Product: <<[Name]>>
Price: <<[Price]>>
Stock: <<[Stock]>>
```

## Simple Calculations in Expressions

You can perform calculations directly in expression tags:

```csharp
using GroupDocs.Assembly;

public static void CalculationsInExpressions()
{
    var order = new { Quantity = 5, UnitPrice = 29.99m };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(order, "order"));
    
    Console.WriteLine("Document assembled with calculations.");
}
```

Template with calculations:

```
Quantity: <<[order.Quantity]>>
Unit Price: <<[order.UnitPrice]>>
Total: <<[order.Quantity * order.UnitPrice]>>
```

## Using String Methods

You can use .NET string methods in expressions:

```csharp
using GroupDocs.Assembly;

public static void StringMethods()
{
    var company = new { Name = "ABC Corporation", Website = "www.example.com" };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(company, "company"));
    
    Console.WriteLine("Document assembled with string methods.");
}
```

Template with string methods:

```
Company: <<[company.Name.ToUpper()]>>
Website: <<[company.Website.ToLower()]>>
```

## Expression Tag Formatting

You can format expression results using format strings:

```csharp
using GroupDocs.Assembly;

public static void FormattedExpressions()
{
    var invoice = new { 
        Amount = 1500.50m, 
        Date = new DateTime(2024, 1, 15),
        Percentage = 0.15
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(invoice, "invoice"));
    
    Console.WriteLine("Document assembled with formatting.");
}
```

Template with formatting:

```
Amount: <<[invoice.Amount]:"C">>
Date: <<[invoice.Date]:"yyyy-MM-dd">>
Percentage: <<[invoice.Percentage]:"P">>
```

{{< alert style="warning" >}}
Format strings follow .NET formatting conventions. Use "C" for currency, "P" for percentage, and standard date/time format strings for dates.
{{< /alert >}}

### Advanced Usage Topics

To learn more about data bands, conditional blocks, LINQ expressions, and advanced template syntax features, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Bulleted List in Text Document

Path: /assembly/java/bulleted-list-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Bulleted List in Text Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must show all the clients in a bulleted list format.
*   Report must be generated in the Text Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
<<foreach [in getClients()]>>•	<<[getName()]>>
<</foreach>>
```

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.txt](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Text%20Templates/Bulleted%20List.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists 0117f3b3de47b8d3d417283937eb9caa >}}



---

## Bulleted List in Text Document

Path: /assembly/net/bulleted-list-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bulleted List in Text Document

{{< alert style="info" >}}This feature is supported by version 17.04 or greater{{< /alert >}}

### Creating a Bulleted List

Practicing the following steps you can insert Bulleted List in a Text document.

1.  To add a bulleted list use • as a bullet for each element in the list.
2.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   A report must show all the products in a bulleted list format.
*   A report must be generated in the Text Document format.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>>•	<<[ProductName]>>
<</foreach>>

```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.txt](https://github.com/rida-fatima-aspose/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Text%20Templates/Bulleted%20List.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists f8f45cf046005387e1e121f3118cd9fb >}}



---

## Clean metadata

Path: /metadata/java/clean-metadata/

## Remove all recognized metadata properties from a file

Sometimes you may need to just remove all or clean metadata properties without applying any filters. The best way to do this is to use the [sanitize](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#sanitize()) method.

This example demonstrates how to remove all detected metadata packages/properties.

1.  [Load]({{< ref "metadata/java/developer-guide/basic-usage/clean-metadata.md" >}}) a file to clean
2.  Call the [sanitize](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#sanitize()) method
3.  Check the actual number of removed packages/properties
4.  [Save]({{< ref "metadata/java/developer-guide/basic-usage/clean-metadata.md" >}}) the changes

**basic\_usage.CleanMetadata**

```csharp
// Constants.InputPdf is an absolute or relative path to your document. Ex: @"C:\Docs\source.pdf"
try (Metadata metadata = new Metadata(Constants.InputPdf)) {
	// Remove detected metadata packages
	int affected = metadata.sanitize();
	System.out.println(String.format("Properties removed: %s", affected));
	metadata.save(Constants.OutputPdf);
}
```

As a result, we get a sanitized version of the original file.

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Clean metadata

Path: /metadata/net/clean-metadata/

## Remove all recognized metadata properties from a file

Sometimes you may need to just remove all or clean metadata properties without applying any filters. The best way to do this is to use the [Sanitize](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/sanitize) method.

This example demonstrates how to remove all detected metadata packages/properties.

1.  [Load]({{< ref "metadata/net/developer-guide/basic-usage/clean-metadata.md" >}}) a file to clean
2.  Call the [Sanitize](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/sanitize) method
3.  Check the actual number of removed packages/properties
4.  [Save]({{< ref "metadata/net/developer-guide/basic-usage/clean-metadata.md" >}}) the changes

**BasicUsage.CleanMetadata**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPdf))
{
	// Remove detected metadata packages
	var affected = metadata.Sanitize();
	Console.WriteLine("Properties removed: {0}", affected);

	metadata.Save(Constants.OutputPdf);
}
```

As a result, we get a sanitized version of the original file.

## More resources
### Advanced usage topics
To learn more about document watermarking features and get familiar how to manage watermarks and more, please refer to the [advanced usage section]({{< ref "metadata/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Clean metadata

Path: /metadata/nodejs-java/clean-metadata/

## Remove all recognized metadata properties from a file

Sometimes you may need to just remove all or clean metadata properties without applying any filters. The best way to do this is to use the **sanitize** method.

This example demonstrates how to remove all detected metadata packages/properties.

1.  **Load** a file to clean
2.  Call the **sanitize** method
3.  Check the actual number of removed packages/properties
4.  **Save** the changes

**basic\_usage.CleanMetadata**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata("input.pdf");

    // Remove detected metadata packages
    var affected = metadata.sanitize();
    console.log(`\nProperties removed: ${affected}.`);

    metadata.save("output.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}

As a result, we get a sanitized version of the original file.

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Clean metadata

Path: /metadata/python-net/clean-metadata/

## Remove all recognized metadata properties from a file

Sometimes you may need to just remove all or clean metadata properties without applying any filters. The best way to do this is to use the **sanitize** method.

This example demonstrates how to remove all detected metadata packages/properties.

1.  **Load** a file to clean
2.  Call the **sanitize** method
3.  Check the actual number of removed packages/properties
4.  **Save** the changes

**basic\_usage.CleanMetadata**


```python
with gm.Metadata("input.pdf") as metadata:
        affected = metadata.sanitize()
        print(f"Properties removed: {affected}")
        metadata.save("output.pdf")
}
```


As a result, we get a sanitized version of the original file.

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)

*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Common List Image in Text Document

Path: /assembly/java/common-list-image-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Laye](https://docs.groupdocs.com/assembly/java/the-business-layer/)r.{{< /alert >}}

## Common List in Text Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must show multiple managers' picture and name.
*   Report must be generated in the Text Document format.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}Inserting Images Dynamically is not Supported yet{{< /alert >}}

```java
<<foreach [in getManagers()]>><<[getName()]>>
<</foreach>>
```

### Download Common List Template

Please download the sample Common List document we created in this article:

*   [Common List.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Text%20Templates/Common%20List.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists d0cefcf2965923335faed6d91207a1af >}}



---

## Common List in Text Document

Path: /assembly/net/common-list-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

## Common List in Text Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   The report must be generated in the Text Document format

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
<<foreach [in customers]>><<[CustomerName]>>
<</foreach>>
```

### Download Common List Template

Please download the sample Common List document we created in this article:

*   [Common List.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Text%20Templates/Common%20List.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists bd8aa3bbc25b483bde5e05c376ed8509 >}}



---

## Common Master-Detail Image in Text Document

Path: /assembly/java/common-master-detail-image-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Common Master-Detail Image in Text Document

### Reporting Requirement

As a report developer, you are required to represent the information of the managers and clients with the following key requirements:

*   Report must show managers' picture and name.
*   It must associate the managers with their clients.
*   Report must be generated in the Text Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}Inserting Images Dynamically is not Supported yet{{< /alert >}}

```java
<<foreach [in getManagers()]>><<[getName()]>>
Clients: <<foreach [in getContracts()]>><<[indexOf() != 0 ? ", " : ""]>><<[getClient().getName()]>><</foreach>>
<</foreach>>
```

### Download Common Master-Detail Template

Please download the sample Common master-detail document we created in this article:

*   [Common Master-Detail.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Text%20Templates/Common%20Master-Detail.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists d4a29bbe5042d0da99c3de6117bc1c77 >}}



---

## Common Master-Detail in Text Document

Path: /assembly/net/common-master-detail-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in Text Document format.{{< /alert >}}

## Common Master-Detail in Text Document

{{< alert style="info" >}}This feature is supported by version 17.3.0 or greater.{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent the information of the customers and products with the following key requirements:

*   It must associate the customers with their products
*   Report must be generated in the HTML Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
<<foreach [in customers]>><<[CustomerName()]>>
Products: <<foreach [in Order]>><<[indexOf() != 0 ? ", " : ""]>><<[Product.ProductName]>><</foreach>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Common Master-Detail Template

Please download the sample Common master-detail document we created in this article:

*   [Common Master-Detail.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Text%20Templates/Common%20Master-Detail.txt?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist rida-fatima-aspose 5101b2428d3e7fd66bf4ba71d28c3967 >}}



---

## Convert to PDF with advanced options

Path: /conversion/net/convert-to-pdf-with-advanced-options/

GroupDocs.Conversion provides the [PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions) class to give you control over conversion results. Along with [common convert options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}}) you can specify the following additional options via the [PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions) class:

*   [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) sets the desired file type the input document should be converted to.
*   [PageWidth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/pagewidth) sets the desired page width in points after conversion (1 point = 1/72 inch). When set, PageSize is automatically changed to Custom.
*   [PageHeight](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/pageheight) sets the desired page height in points after conversion (1 point = 1/72 inch). When set, PageSize is automatically changed to Custom.
*   [PageSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/pagesize) sets the desired page size. Available options are: *Default, A3, A4, A5, Letter, Legal, Tabloid*.
*   [PageOrientation](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/pageorientation) sets the page orientation. Available options are: *Default, Landscape, Portrait*.
*   [FallbackPageSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/fallbackpagesize) sets the fallback page size to use when the input document's page size cannot be determined.
*   [Dpi](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/dpi) sets the desired page DPI after conversion
*   [Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/password) when specified, the resulting document will be protected with the specified password.
*   [MarginTop](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/margintop) sets the desired page top margin after conversion.
*   [MarginBottom](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/marginbottom) sets the desired page bottom margin after conversion.
*   [MarginLeft](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/marginleft) sets the desired page left margin after conversion.
*   [MarginRight](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/marginright) sets the desired page right margin after conversion.
*   [PdfOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions) defines the PDF-specific convert options. See [below](#pdfoptions).
*   [Rotate](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions/rotate) sets the page rotation angle. Available options are: *None, On90, On180, On270*.

The following code snippet shows how to convert to PDF with advanced options:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PdfConvertOptions options = new PdfConvertOptions
    {
        PageNumber = 2,
        PagesCount = 1,
        Rotate = Rotation.On180,
        Dpi = 300,
        PageWidth = 595,   // A4 width in points (8.27 inches)
        PageHeight = 841   // A4 height in points (11.69 inches)
    };
    converter.Convert("converted.pdf", options);
}
```

## Page Size and Orientation

You can control page size and orientation using predefined sizes or custom dimensions.

### Using Predefined Page Size

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PdfConvertOptions options = new PdfConvertOptions
    {
        PageSize = PageSize.A4,
        PageOrientation = PageOrientation.Portrait
    };
    converter.Convert("a4-portrait.pdf", options);
}
```

### Setting Landscape Orientation

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PdfConvertOptions options = new PdfConvertOptions
    {
        PageSize = PageSize.Letter,
        PageOrientation = PageOrientation.Landscape
    };
    converter.Convert("letter-landscape.pdf", options);
}
```

### Using Fallback Page Size

The fallback page size is used when the input document's page size cannot be determined:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PdfConvertOptions options = new PdfConvertOptions
    {
        FallbackPageSize = PageSize.A4
    };
    converter.Convert("with-fallback.pdf", options);
}
```

### PdfOptions

The [PdfOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions) class provides specific options when converting documents to different versions of PDF format.

*   [PdfFormat](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions/pdfformat)  sets the specific PDF format of the converted document. Available options are: *Default, PdfA\_1A, PdfA\_1B, PdfA\_2A, PdfA\_3A, PdfA2B, PdfA\_2U, PdfA\_3B, PdfA\_3U, v1\_3, v1\_4, v1\_5, v1\_6, v1\_7, PdfX\_1A, PdfX\_3*.
*   [RemovePdfACompliance](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions/removepdfacompliance) whether to remove the Pdf-A compliance.
*   [Zoom](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions/zoom) specifies the zoom level in percentage.
*   [Linearize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions/linearize) whether to linearize the document for the Web.
*   [Grayscale](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions/grayscale) whether to convert the document to grayscale.
*   [OptimizationOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions/optimizationoptions) defines the PDF optimization options. See [below](#pdfoptimizationoptions).
*   [FormattingOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptions/formattingoptions) defines the PDF formatting options. See [below](#pdfformattingoptions).

The following code snippet shows how to specify options via the `PdfOptions` class:

```csharp
using (Converter converter = new Converter("sample.docx"))
{

    PdfConvertOptions options = new PdfConvertOptions
    {        
        PdfOptions = new PdfOptions
        {
            Grayscale = true,
            Zoom = 200
        }
    };
    converter.Convert("converted.pdf", options);
}
```

### PdfOptimizationOptions

The [PdfOptimizationOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions) class specifies options for adjusting the PDF conversion process and improving its speed.

*   [LinkDuplicateStreams](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions/linkduplicatestreams) whether to link duplicate streams.
*   [RemoveUnusedObjects](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions/removeunusedobjects) whether to remove unused objects.
*   [RemoveUnusedStreams](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions/removeunusedstreams) whether to remove unused streams.
*   [CompressImages](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions/compressimages) whether to re-compress all the images in the document. The amount of compression is defined by the [ImageQuality](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions/imagequality) property.
*   [ImageQuality](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions/imagequality) defines the quality (in percentage) of image compression. Effective when the `CompressImages` property is set to `true`. To keep the original quality and image size set this property to 100. To decrease the image size set this property to less than 100.
*   [UnembedFonts](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfoptimizationoptions/unembedfonts) whether to replace the embedded fonts with references to these fonts. Decreases the file size, but may change the original design of the document.

The following code snippet shows how to specify PDF optimization options:

```csharp
using (Converter converter = new Converter("sample.docx"))
{

    PdfConvertOptions options = new PdfConvertOptions
    {        
        PdfOptions = new PdfOptions
        {
            OptimizationOptions = new PdfOptimizationOptions
            { 
                CompressImages = true,
                ImageQuality = 70,
                UnembedFonts = true
            }
        }
    };
    converter.Convert("converted.pdf", options);
}
```

### PdfFormattingOptions

The [PdfFormattingOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions) class provides different options to change the formatting of the resulting document.

*   [CenterWindow](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/centerwindow) whether to position the document's window in the center of the screen.
*   [Direction](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/direction) defines the reading direction of the document: left to right or right to left. Available options are: *L2R, R2L*
*   [DisplayDocTitle](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/displaydoctitle) whether to display the document title in the window's title bar.
*   [FitWindow](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/fitwindow) whether to resize the document window to fit the first displayed page.
*   [HideMenuBar](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/hidemenubar) whether to hide the menu bar when the document is active.
*   [HideToolBar](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/hidetoolbar) whether to hide the toolbar when the document is active.
*   [HideWindowUI](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/hidewindowui) whether to hide user interface elements when the document is active.
*   [NonFullScreenPageMode](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/nonfullscreenpagemode) - defines how to display the document when switching from the full-screen mode. Available options are: *UseNone, UseOutlines, UseThumbs, FullScreen, UseOC, UseAttachments*
*   [PageLayout](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/pagelayout) defines the page layout to use when the document is opened. Available options are: *Default, SinglePage, OneColumn, TwoColumnLeft, TwoColumnRight, TwoPagesLeft, TwoPagesRight*
*   [PageMode](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfformattingoptions/pagemode) defines how to display the document when it is opened. Available options are: *UseNone, UseOutlines, UseThumbs, FullScreen, UseOC, UseAttachments*

The following code snippet shows how to specify PDF formatting options:

```csharp
using (Converter converter = new Converter("sample.docx"))
{

    PdfConvertOptions options = new PdfConvertOptions
    {
        PdfOptions = new PdfOptions
        {
            FormattingOptions = new PdfFormattingOptions
            {
                FitWindow = true,
                HideWindowUI = true,
                PageMode = PdfPageMode.UseThumbs
            }
        }
    };
    converter.Convert("converted.pdf", options);
}
```

## More Resources

- [API Reference: PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})
---

## Convert to Spreadsheet with advanced options

Path: /conversion/java/convert-to-spreadsheet-with-advanced-options/


[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) provides the [SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/spreadsheetconvertoptions/) class, allowing fine-grained control over the conversion process when converting documents to spreadsheet formats. This class extends the common conversion options available in the base class and introduces additional configuration parameters for enhanced flexibility:
| Option | Description |
|--------|-------------|
|[**setFormat()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/#setFormat-com.groupdocs.conversion.filetypes.FileType-) | Specifies the desired output format. Supported formats include `Xls`, `Xlsx`, `Xlsm`, `Xlsb`, `Ods`, `Ots`, `Xltx`, `Xlt`, `Xltm`, `Tsc`, `Xlam`, and `Csv`. |
|[**setPassword()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/spreadsheetconvertoptions/#setPassword-java.lang.String-) | Enables password protection for the converted file, using the specified password for securing the document. |
|[**setZoom()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/spreadsheetconvertoptions/#setZoom-int-) | Sets the zoom level of the resulting document, defined as a percentage. |

The code snippet below demonstrates how to configure and execute a document conversion to a spreadsheet format using advanced options. In this example, only a specific page from the input document is converted, and additional parameters such as format and zoom level are defined:


{{< tabs "code-example">}}
{{< tab "ConvertToSpreadsheetWithAdvancedOptions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.SpreadsheetFileType;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

public class ConvertToSpreadsheetWithAdvancedOptions {
    public static void convert() {
        // Load the source document
        try(Converter converter = new Converter("formatting.docx")) {
            // Set conversion options for spreadsheets
            SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
            options.setPageNumber(2);            // Convert only the second page
            options.setPagesCount(1);            // Limit to a single page
            options.setFormat(SpreadsheetFileType.Xls);    // Output format
            options.setZoom(50);                // Set zoom level to 50%

            // Perform the conversion
            converter.convert("converted_with_options.xls", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "formatting.docx" >}}  
{{< tab-text >}}
`formatting.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-spreadsheet-with-advanced-options/formatting.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_options.xls" >}}  
{{< tab-text >}}
`converted_with_options.xls` is converted XLS document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-spreadsheet-with-advanced-options/converted_with_options.xls) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


This flexibility enables tailored conversion workflows, ensuring the output meets specific requirements such as format compatibility, content accessibility, or security constraints.
---

## Convert to Spreadsheet with advanced options

Path: /conversion/nodejs-java/convert-to-spreadsheet-with-advanced-options/

[**GroupDocs.Conversion**](#) provides [SpreadsheetConvertOptions](#) to give you control over conversion result when convert to spreadsheet format. Along with [common convert options](#) from base class [SpreadsheetConvertOptions](#) has the following additional options:

*   [setFormat](#) specifies desired result document type. Available options are: *Xls, Xlsx, Xlsm, Xlsb, Ods, Ots, Xltx, Xlt, Xltm, Tsc, Xlam, Csv*.
*   [setPassword](#) whether the converted document will be password protected with the specified password.
*   [setZoom](#) specifies the zoom level in percentage.

The following code snippet shows how to convert to Spreadsheet with advanced options:

```js
const converter = new groupdocs.conversion.Converter("sample.docx");
const convertOptions = new groupdocs.conversion.SpreadsheetConvertOptions();
convertOptions.setPageNumber(2);
convertOptions.setPagesCount(1);
convertOptions.setFormat(groupdocs.conversion.SpreadsheetFileType.Xls);
convertOptions.setZoom(150);

converter.convert("converted.xls", convertOptions);
```

---

## Delete indexed paths

Path: /search/java/delete-indexed-paths/

GroupDocs.Search supports the ability to remove indexed files and folders from an index. Only files or folders that were explicitly added to the index can be deleted. It is not possible to remove a file or folder from the index that is a child of the indexed folder. To delete files and folders inside indexed paths, use the document filter (see [Document filtering during indexing]({{< ref "search/java/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}})). To get a list of indexed paths, use the [getIndexedPaths](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getIndexedPaths()) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class.

The following example shows how to remove indexed paths from an index.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder1 = "c:\\MyDocuments\\";
String documentsFolder2 = "c:\\MyDocuments2\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folders
index.add(documentsFolder1);
index.add(documentsFolder2);
 
// Getting indexed paths from the index
String[] indexedPaths1 = index.getIndexedPaths();
 
// Writing indexed paths to the console
System.out.println("Indexed paths:");
for (String path : indexedPaths1) {
    System.out.println("\t" + path);
}
 
// Deleting indexed path from the index
DeleteResult deleteResult = index.delete(new String[] { documentsFolder1 }, new UpdateOptions());
 
// Getting indexed paths after deletion
String[] indexedPaths2 = index.getIndexedPaths();
System.out.println("\nDeleted paths: " + deleteResult.getSuccessCount());
 
System.out.println("\nIndexed paths:");
for (String path : indexedPaths2) {
    System.out.println("\t" + path);
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Delete indexed paths

Path: /search/net/delete-indexed-paths/

GroupDocs.Search supports the ability to remove indexed files and folders from an index. Only files or folders that were explicitly added to the index can be deleted. It is not possible to remove a file or folder from the index that is a child of the indexed folder. To delete files and folders inside indexed paths, use the document filter (see [Document filtering during indexing]({{< ref "search/net/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}})). To get a list of indexed paths, use the [GetIndexedPaths](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getindexedpaths) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class.

The following example shows how to remove indexed paths from an index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder1 = @"c:\MyDocuments\";
string documentsFolder2 = @"c:\MyDocuments2\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Indexing documents from the specified folders
index.Add(documentsFolder1);
index.Add(documentsFolder2);

// Getting indexed paths from the index
string[] indexedPaths1 = index.GetIndexedPaths();

// Writing indexed paths to the console
Console.WriteLine("Indexed paths:");
foreach (string path in indexedPaths1)
{
    Console.WriteLine("\t" + path);
}
 
// Deleting indexed path from the index
DeleteResult deleteResult = index.Delete(new string[] { documentsFolder1 }, new UpdateOptions());
 
// Getting indexed paths after deletion
string[] indexedPaths2 = index.GetIndexedPaths();
Console.WriteLine("\nDeleted paths: " + deleteResult.SuccessCount);

Console.WriteLine("\nIndexed paths:");
foreach (string path in indexedPaths2)
{
    Console.WriteLine("\t" + path);
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Delete indexed paths

Path: /search/nodejs-java/delete-indexed-paths/

GroupDocs.Search supports the ability to remove indexed files and folders from an index. Only files or folders that were explicitly added to the index can be deleted. It is not possible to remove a file or folder from the index that is a child of the indexed folder. To delete files and folders inside indexed paths, use the document filter (see [Document filtering during indexing]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/document-filtering-during-indexing.md" >}})). To get a list of indexed paths, use the [getIndexedPaths](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getIndexedPaths()) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class.

The following example shows how to remove indexed paths from an index.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder1 = 'c:/MyDocuments/';
const documentsFolder2 = 'c:/MyDocuments2/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folders
index.add(documentsFolder1);
index.add(documentsFolder2);

// Getting indexed paths from the index
const indexedPaths1 = index.getIndexedPaths();

// Writing indexed paths to the console
console.log('Indexed paths:');
for (let i = 0; i < indexedPaths1.length; i++) {
  const indexedPath = indexedPaths1[i];
  console.log('\t' + indexedPath);
}

// Deleting index path from the index
const deleteResult = index.delete([documentsFolder1], new groupdocs.search.UpdateOptions());

// Getting indexed paths after deletion
const indexedPaths2 = index.getIndexedPaths();
console.log('\nDeleted paths: ' + deleteResult.getSuccessCount());

console.log('\nIndexed paths:');
for (let i = 0; i < indexedPaths2.length; i++) {
  const indexedPath = indexedPaths2[i];
  console.log('\t' + indexedPath);
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## eSign Word Processing document with Metadata signature

Path: /signature/net/esign-word-processing-document-with-metadata-signature/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [WordProcessingMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/wordprocessingmetadatasignature) class to specify different Metadata signature objects for [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) instance to sign Word Processing document files.
Word Processing document metadata is hidden attributes, some of them are visible only over viewing standard document properties like Author, Creation Date, Producer, Entry, Keywords etc.  
Word Processing document metadata contains pair of Name and Value, Name should be unique within the document.  
Word Processing document metadata could keep big amount of data that allows provides ability to keep serialized custom objects with additional encryption in there.

### Here are the steps to add metadata signatures into Word Processing document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) object according to your requirements.
* Instantiate one or several[WordProcessingMetadataSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/wordprocessingmetadatasignature) objects and add them into [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to metadata signatures collection ([Signatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions/signatures)) via [Add](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/add) or [AddRange](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/metadatasignaturecollection/addrange) method.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) to it.

## How to eSign Word Processing document with Metadata signature

This example shows how to sign Word Processing document with Metadata e-signature.

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    MetadataSignOptions options = new MetadataSignOptions();

    // Create few WordProcessing Metadata signatures
    WordProcessingMetadataSignature[] signatures = new WordProcessingMetadataSignature[]
    {
        new WordProcessingMetadataSignature("Author", "Mr.Scherlock Holmes"),
        new WordProcessingMetadataSignature("DateCreated", DateTime.Now),
        new WordProcessingMetadataSignature("DocumentId", 123456),
        new WordProcessingMetadataSignature("SignatureId", 123.456M)
    };
    options.Signatures.AddRange(signatures);
  
    // add these signatures to options
    options.Signatures.AddRange(signatures);
    signature.Sign("SampleSigned.docx", options);
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Evaluation Limitations and Licensing

Path: /assembly/java/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Assembly without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the API without license.{{< /alert >}}

## Evaluation Version Limitations

You can easily download GroupDocs.Assembly for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face few limitations while using the API without the license. See the limitations below regarding each supported format while using non-licensed GroupDocs.Assembly:

| Document | Spreadsheet | Presentation |
| --- | --- | --- |
| GroupDocs.Assembly (without a license specified) generates the document reports with full product functionality, but it inserts an evaluation watermark at the top of the document | When a Spreadsheet report is generated it contains an extra worksheet with Evaluation Copyright Warning on it, you can't hide the Evaluation Copyright Warning (the extra worksheet) | When a presentation report is generated using GroupDocs.Assembly, an Evaluation Watermark is injected at the center of each slide |
| It limits the maximum document size to several hundred paragraphs | When running your program, you can only generate 100 Spreadsheet reports using GroupDocs.Assembly. If your application exceeds this number, an exception will be thrown |
| | You can't re-specify the script path (e.g in the web.config file) | |

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Assembly API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Assembly.jar file and specify the file name, without a path, as shown in the examples below.

### Applying License from File

The code below will explain how to apply license from the file.

{{< gist GroupDocsGists 4749779f9e9aa688011bec1b98f0f57e >}}



### Applying License from Stream

Following code snippet shows how to apply license from the stream.

{{< gist GroupDocsGists 1e7b64c7376118958c7c084544042b85 >}}



### Applying Metered License

{{< alert style="warning" >}}Since version 18.9, the Metered licensing security has been improved. Metered licensing is now applicable only in Java runtime version 8u101 or above. Please use other types of licensing if you are using v18.9 or greater in Java 7.{{< /alert >}}{{< alert style="info" >}}You can also set Metered license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `setMeteredKey` method.
3.  Do processing (perform task).
4.  call method `getConsumptionCredit` of the `Metered` class (Since version 19.5).
5.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

{{< gist GroupDocsGists f33c57a23b6ea00affe1d69c635678ff >}}



---

## Evaluation Limitations and Licensing

Path: /assembly/net/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Assembly without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Version Limitations

You can easily download GroupDocs.Assembly for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| Document | Spreadsheet | Presentation |
| --- | --- | --- |
| GroupDocs.Assembly (without a license specified) generates the document reports with full product functionality, but it inserts an evaluation watermark at the top of the document | When a Spreadsheet report is generated it contains an extra worksheet with Evaluation Copyright Warning on it, you can't hide the Evaluation Copyright Warning (the extra worksheet) | When a presentation report is generated using GroupDocs.Assembly, an Evaluation Watermark is injected at the center of each slide |
| It limits the maximum document size to several hundred paragraphs | When running your program, you can only generate 100 Spreadsheet reports using GroupDocs.Assembly. If your application exceeds this number, an exception will be thrown |  |
|  | You can't re-specify the script path (e.g in the web.config file) |  |

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Assembly API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Assembly.dll file and specify the file name, without a path, as shown in the examples below.

### Applying License from File

The code below will explain how to call the license file.
{{< gist GroupDocsGists db63054e45146654ff4efeda01f556a2 >}}

### Applying License from Stream

The following example shows how to load a license from a stream.
{{< gist GroupDocsGists e6e23199ab4c88f7f60f191a65cdfdc6 >}}

{{< alert style="info" >}}

Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Assembly classes.

When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application_Start protected method. It is called once when the application starts. Do not call License.SetLicense from within Page_Load methods since it means the license will be loaded every time a web page is loaded.

{{< /alert >}}

{{< alert style="info" >}}See this video about applying the license.{{< /alert >}}

### Applying Metered License

{{< alert style="info" >}}You can also set Metered license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to Metered Licensing FAQ section.{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `SetMeteredKey` method.
3.  Do processing (perform task).
4.  call method `GetConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method `GetConsumptionCredit` of the `Metered` class (Since version 19.7).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.
{{< gist GroupDocsGists 7d4158b476ad2d413f1e04b03ffc1794 >}}
---

## Evaluation Limitations and Licensing

Path: /assembly/python-net/evaluation-limitations-and-licensing/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Assembly provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}GroupDocs.Assembly also works without the license in trial mode with certain limitations{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Viewer classes

## Evaluation Version Limitations

You can easily download GroupDocs.Assembly for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| Document | Spreadsheet | Presentation |
| --- | --- | --- |
| GroupDocs.Assembly (without a license specified) generates the document reports with full product functionality, but it inserts an evaluation watermark at the top of the document | When a Spreadsheet report is generated it contains an extra worksheet with Evaluation Copyright Warning on it, you can't hide the Evaluation Copyright Warning (the extra worksheet) | When a presentation report is generated using GroupDocs.Assembly, an Evaluation Watermark is injected at the center of each slide |
| It limits the maximum document size to several hundred paragraphs | When running your program, you can only generate 100 Spreadsheet reports using GroupDocs.Assembly. If your application exceeds this number, an exception will be thrown |  |
|  | You can't re-specify the script path (e.g in the web.config file) |  |

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Assembly API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object.

### Applying license from file

The code below will explain how to apply a  product license.

{{< tabs "example1">}}
{{< tab "Python" >}}

```python
import groupdocs.assembly as ga
import constants
import os
  

def run():
    if os.path.exists(constants.license_path):    
        license = ga.License()
        license.set_license(constants.license_path)
        print("License set successfully.")
    else:
       print("\n")
```

{{< /tab >}}
{{< /tabs >}}

### Applying license from stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "Python" >}}

```python
import groupdocs.assembly as ga
import constants
import os
from os.path import join

def run():
    if os.path.exists(constants.license_path):
        with open(constants.license_path, "rb") as stream:
            ga.License().set_license(stream)

        print("License set successfully.")
    else:
        print("\nWe do not ship any license with this example. " +
              "\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
              "\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
              "\nLearn how to request a temporary license at https://purchase.groupdocs.com/temporary-license.")

if __name__ == "__main__":
    run()
```

{{< /tab >}}
{{< /tabs >}}


### Applying Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/python-net/assembly/groupdocs.assembly/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `setMeteredKey` method.
3.  Do processing (perform task).
4.  call method `getConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method `getConsumptionCredit` of the `Metered` class (Since version 19.5).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.
{{< tabs "example3">}}
{{< tab "Python" >}}
```python
import groupdocs.assembly as ga

def run():
    public_key = "*****"  # Your public key
    private_key = "*****"  # Your private key

    ga.Metered().set_metered_key(public_key, private_key)

    print("License set successfully.")

if __name__ == "__main__":
    run()


```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
Calling [License.setLicense](https://reference.groupdocs.com/assembly/python-net/com.groupdocs.assembly.licensing/License) multiple times is not harmful but simply wastes processor time. It is called once when the application starts.
{{< /alert >}}
---

## Evaluation Limitations and Licensing

Path: /metadata/net/evaluation-limitations-and-licensing/

{{< alert style="info" >}}GroupDocs.Metadata also works without the license in trial mode with certain limitations{{< /alert >}}

## Evaluation Version Limitations

You can easily download GroupDocs.Metadata for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| API | Limitations |
| --- | --- |
| Document properties (Pdf, Word, Excel, PowerPoint, Visio, etc) | Only first 5 properties can be read |
| XMP API | Only first 2 XMP schemes can be read |
| EXIF API | GPS IFD and image thumbnail are unavailable |
| EXIF API | Only first 5 properties can be read |
| IPTC API | Only first 5 properties can be read |
| Id3v2, Lyrics3, APEv2 tags | Only first 5 properties can be read |
| QuickTime atoms | Only first 5 atoms can be read |
| File open | Open maximum 15 files, otherwise, API throws exception |
| File save | Not supported in trial mode |

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Metadata API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Metadata.dll file and specify the file name, without a path, as shown in the examples below.

### Applying License from File

The code below will explain how to apply a  product license.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET

// initialize License
License lic = new License();

// apply license
lic.SetLicense("GroupDocs.Metadata.lic");

```

### Applying License from Stream

The following example shows how to load a license from a stream.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET

using (FileStream fileStream = new FileStream("GroupDocs.Metadata.lic", FileMode.Open, FileAccess.Read))
{
    License lic = new License();
    lic.SetLicense(fileStream);
}
```

{{< alert style="info" >}}Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Metadata classes. When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application_Start protected method. It is called once when the application starts. Do not call License.SetLicense from within Page_Load methods since it means the license will be loaded every time a web page is loaded.{{< /alert >}}

### Applying Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `setMeteredKey` method.
3.  Do processing (perform task).
4.  call method `getConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method `getConsumptionCredit` of the `Metered` class (Since version 19.5).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET

// initialize Metered API
Metered metered = new Metered();

// set-up credentials
metered.SetMeteredKey("publicKey", "privateKey");

```

---

## Evaluation Limitations and Licensing

Path: /metadata/nodejs-java/evaluation-limitations-and-licensing/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Metadata provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}GroupDocs.Metadata also works without the license in trial mode with certain limitations{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Viewer classes

## Evaluation version limitations

You can easily download GroupDocs.Metadata for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| API | Limitations |
| --- | --- |
| Document properties (Pdf, Word, Excel, PowerPoint, Visio, etc) | Only first 5 properties can be read |
| XMP API | Only first 2 XMP schemes can be read |
| EXIF API | GPS IFD and image thumbnail are unavailable  
Only first 5 properties can be read |
| IPTC API | Only first 5 properties can be read |
| Id3v2, Lyrics3, APEv2 tags | Only first 5 properties can be read |
| QuickTime atoms | Only first 5 atoms can be read |
| File open | Open maximum 15 files, otherwise, API throws exception |
| File save | Not supported in trial mode |

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Metadata API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object.

### Applying license from file

The code below will explain how to apply a  product license.

{{< tabs "example1">}}
{{< tab "JavaScript" >}}

```js
const licensePath = "path to the .lic file";
const license = new groupdocs.metadata.License()
license.setLicense(licensePath); 
```

{{< /tab >}}
{{< /tabs >}}

### Applying license from stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "JavaScript" >}}

```js
const fs = require('fs')  
  
const licensePath = "path to the .lic file"
const license = new groupdocs.metadata.License()
const licStream = fs.createReadStream(licensePath)
groupdocs.metadata.License.setLicenseFromStream(license, licStream, err => {
  if (err) {
    console.log(`Set license error: ${err}`)
  } else {
    console.log('License set OK')
  }
})
```

{{< /tab >}}
{{< /tabs >}}


{{< alert style="info" >}}
Calling [License.setLicense](https://reference.groupdocs.com/metadata/nodejs-java/com.groupdocs.metadata.licensing/License#setLicense(java.lang.String)) multiple times is not harmful but simply wastes processor time. It is called once when the application starts.
{{< /alert >}}

---

## Evaluation Limitations and Licensing

Path: /metadata/python-net/evaluation-limitations-and-licensing/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Metadata provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}GroupDocs.Metadata also works without the license in trial mode with certain limitations{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Viewer classes

## Evaluation version limitations

You can easily download GroupDocs.Metadata for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| API | Limitations |
| --- | --- |
| Document properties (Pdf, Word, Excel, PowerPoint, Visio, etc) | Only first 5 properties can be read |
| XMP API | Only first 2 XMP schemes can be read |
| EXIF API | GPS IFD and image thumbnail are unavailable  
Only first 5 properties can be read |
| IPTC API | Only first 5 properties can be read |
| Id3v2, Lyrics3, APEv2 tags | Only first 5 properties can be read |
| QuickTime atoms | Only first 5 atoms can be read |
| File open | Open maximum 15 files, otherwise, API throws exception |
| File save | Not supported in trial mode |

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Metadata API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object.

### Applying license from file

The code below will explain how to apply a  product license.



```python
import groupdocs.metadata as gm
import constants
import os
  

def run():
    if os.path.exists(constants.license_path):    
        license = gm.License()
        license.set_license(constants.license_path)
        print("License set successfully.")
    else:
       print("\n")
```



### Applying license from stream

The following code snippet shows how to set a license from a stream:



```python
import groupdocs.metadata as gm
import constants
import os
from os.path import join

def run():
    if os.path.exists(constants.license_path):
        with open(constants.license_path, "rb") as stream:
            gm.License().set_license(stream)

        print("License set successfully.")
    else:
        print("\nWe do not ship any license with this example. " +
              "\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
              "\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
              "\nLearn how to request a temporary license at https://purchase.groupdocs.com/temporary-license.")

if __name__ == "__main__":
    run()
```




### Applying Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/python-net/metadata/groupdocs.metadata/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `setMeteredKey` method.
3.  Do processing (perform task).
4.  call method `getConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method `getConsumptionCredit` of the `Metered` class (Since version 19.5).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```python
import groupdocs.metadata as gm

def run():
    public_key = "*****"  # Your public key
    private_key = "*****"  # Your private key

    gm.Metered().set_metered_key(public_key, private_key)

    print("License set successfully.")

if __name__ == "__main__":
    run()


```


{{< alert style="info" >}}
Calling [License.setLicense](https://reference.groupdocs.com/metadata/python-net/com.groupdocs.metadata.licensing/License) multiple times is not harmful but simply wastes processor time. It is called once when the application starts.
{{< /alert >}}
---

## Evaluation Limitations and Licensing

Path: /parser/java/evaluation-limitations-and-licensing/

  
{{< alert style="info" >}}You can use GroupDocs.Parser without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Limitations

  
You can easily download GroupDocs.Parser for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:    
  

| API | Limit |
| --- | --- |
|   | Only 100 files per session |
|   | Only 5 pages (slides, sheets) of a document |
| **Text extraction** | Only 20 lines per file<br/>Only the first 1600 symbols <br/>Only the first 5 pages (slides, sheets)<br/>\+ Evaluation marks |
| **Formatted text and text structure extraction** | Only 20 rows for **spreadsheets**<br/>Only the first 1600 symbols<br/>Only the first 5 pages (slides, sheets)<br/>\+ Evaluation marks |
| **Metadata extraction** | Only 5 properties per file |

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Parser API if you want to avoid its evaluation limitations.  
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Parser.jar file and specify the file name, without a path, as shown in the examples below.

#### Setting License from File

The code below will explain how to set product license.  
  

```java
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Parser-for-Java
 
//initialize License
License lic = new License();
 
//Set license
lic.setLicense("GroupDocs.Parser.lic");
```

#### Setting License from Stream

The following example shows how to load a license from a stream.  
  

```java
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Parser-for-Java
Path fileLocation = Paths.get("GroupDocs.Parser.lic");
 
try {
    byte[] data = Files.readAllBytes(fileLocation);
    ByteArrayInputStream inputStream = new ByteArrayInputStream(data);
 
    License lic = new License();
    lic.setLicense(inputStream);
} catch (IOException e) {
    System.out.println(e.getMessage());
}
```

#### Setting Metered License

{{< alert style="info" >}}You can also set Metered license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to Metered Licensing FAQ section.{{< /alert >}}

  
Here are the simple steps to use the Metered class.

*       Create an instance of Metered class.
*       Pass public & private keys to setMeteredKey method.
*       Do processing (perform task).
*       Call method getConsumptionQuantity of the Metered class.
*       It will return the amount/quantity of API requests that you have consumed so far.
*       Call method getConsumptionCredit of the Metered class.
*       It will return the credit that you have consumed so far.

  
Following is the sample code demonstrating how to use Metered class.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Search-for-Java
 
String PublicKey = ""; // Your public license key
String PrivateKey = ""; // Your private license key
Metered metered = new Metered();
 
try {
    metered.setMeteredKey(PublicKey, PrivateKey);
} catch (Exception e) {
    System.out.println(e.getMessage());
}

// Get amount (MB) consumed
double amountConsumed = GroupDocs.Parser.Metered.getConsumptionQuantity();
 
// Get count of credits consumed
double creditsConsumed = GroupDocs.Parser.Metered.getConsumptionCredit();


```

---

## Evaluation Limitations and Licensing

Path: /parser/net/evaluation-limitations-and-licensing/

  
  

{{< alert style="info" >}}You can use GroupDocs.Parser without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API. You can [get a free temporary license](https://purchase.groupdocs.com/temp-license/100308) for evaluation purposes.{{< /alert >}}

{{< alert style="warning" >}}
**Important:** For a full-featured evaluation without limitations, request a [temporary license](https://purchase.groupdocs.com/temp-license/100308) which allows you to test all features for 30 days.
{{< /alert >}}

## Evaluation Limitations

  
You can easily download GroupDocs.Parser for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:    
  

| API | Limit |
| --- | --- |
|   | Only 100 files per session |
|   | Only 5 pages (slides, sheets) of a document |
| **Text extraction** | Only 20 lines per file<br/>Only the first 1600 symbols <br/>Only the first 5 pages (slides, sheets)<br/>\+ Evaluation marks |
| **Formatted text and text structure extraction** | Only 20 rows for **spreadsheets**<br/>Only the first 1600 symbols<br/>Only the first 5 pages (slides, sheets)<br/>\+ Evaluation marks |
| **Metadata extraction** | Only 5 properties per file |

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Parser API if you want to avoid its evaluation limitations.  
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Parser.dll file and specify the file name, without a path, as shown in the examples below.

#### Setting License from File

The code below will explain how to set product license.  
  

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET
// Setup license.
License license = new License();
license.SetLicense(licensePath);
```

#### Setting License from Stream

The following example shows how to load a license from a stream.  
  

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET
using (FileStream fileStream = File.OpenRead("GroupDocs.Parser.lic"))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```
{{< alert style="info" >}}
Calling [License.SetLicense(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser.license/setlicense/methods/1) multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call [License.SetLicense(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser.license/setlicense/methods/1) in your startup code, before using GroupDocs.Parser classes.
{{< /alert >}}
#### Setting Metered License
{{< alert style="info" >}}
You can also set Metered license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to Metered Licensing FAQ section.
{{< /alert >}}
  
Here are the simple steps to use the [Metered](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered) class.
*       Create an instance of [Metered](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered) class.
*       Pass public & private keys to [SetMeteredKey](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered/methods/setmeteredkey) method.
*       Do processing (perform task).
*       call method [GetConsumptionQuantity](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered/methods/getconsumptionquantity) of the [Metered](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered) class.
*       It will return the amount/quantity of API requests that you have consumed so far.
*       call method [GetConsumptionCredit](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered/methods/getconsumptioncredit) of the [Metered](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered) class.
*       It will return the credit that you have consumed so far.

  
Following is the sample code demonstrating how to use [Metered](https://reference.groupdocs.com/net/parser/groupdocs.parser/metered) class.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Parser.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Parser.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

---

## Evaluation Limitations and Licensing

Path: /redaction/java/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Redaction without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Limitations

You can easily download GroupDocs.Redaction for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:  

*   Only 1 document can be opened in one process.
*   Only 1 redaction can be applied to the document.
*   Any redaction is limited to 4 replacements/deletions, even if there are more matches.
*   Trial badges are placed in the document on the top of each page.

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Redaction API if you want to avoid its evaluation limitations. 

  
The license can be loaded from a file or stream object.

#### Applying License from File

The code below will explain how to apply product license.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java
// Setup the license.
License lic = new License();
lic.setLicense(licensePath);
```

#### Applying License from Stream

The following example shows how to load a license from a stream.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java
final FileInputStream stream = new FileInputStream(licensePath);
try 
{
    License license = new License();
    license.setLicense(stream);
}
finally { stream.close(); }
```

{{< alert style="info" >}}
Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Redaction classes.  
{{< /alert >}}

#### Applying Metered License
{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.
1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `setMeteredKey` method.
3.  Do processing (perform task).
4.  call method `getConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method `getConsumptionCredit` of the `Metered` class.
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java
String privateKey = "[Your Dynabic.Metered private key]";
String publicKey = "[Your Dynabic.Metered public key]";
Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

final Redactor redactor = new Redactor("sample.docx");
try 
{
    // Do some redaction
    RedactorChangeLog result = redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(java.awt.Color.RED)));
    // and get consumption quantity
    double consumptionQuantitiy = Metered.getConsumptionQuantity();
    // get consumption credit 
    double consumptionCredit = Metered.getConsumptionCredit();
}
finally { redactor.close(); }
```

---

## Evaluation Limitations and Licensing

Path: /redaction/net/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Redaction without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Limitations

You can easily download GroupDocs.Redaction for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:  

*   Only 1 document can be opened in one process.
*   Only 1 redaction can be applied to the document.
*   Any redaction is limited to 4 replacements/deletions, even if there are more matches.
*   Trial badges are placed in the document on the top of each page.

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Redaction API if you want to avoid its evaluation limitations.   
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Redaction.dll file and specify the file name, without a path, as shown in the examples below.

#### Applying License from File

The code below will explain how to apply product license.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET
// Setup the license.
License lic = new License();
lic.SetLicense(licensePath);
```

#### Applying License from Stream

The following example shows how to load a license from a stream.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET
using (FileStream fileStream = new FileStream("GroupDocs.Redaction.lic", FileMode.Open, FileAccess.Read))
{
    License lic = new License();
    lic.SetLicense(fileStream);
}
```

{{< alert style="info" >}}Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Redaction classes. When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application_Start protected method. It is called once when the application starts.Do not call License.SetLicense from within Page_Load methods since it means the license will be loaded every time a web page is loaded.{{< /alert >}}

#### Applying Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to S`etMeteredKey` method.
3.  Do processing (perform task).
4.  call method G`etConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method G`etConsumptionCredit` of the `Metered` class (Since version 19.5).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Apply redaction to a document
using (Redactor redactor = new Redactor("D:\\test.docx"))
{
   RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(System.Drawing.Color.Red)));
   if (result.Status != RedactionStatus.Failed)
   {
      redactor.Save();
   };
}

// Get metered consumption quantity after usage of the comparison
decimal amountAfter = GroupDocs.Redaction.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountAfter);

// Get metered consumption credit
decimal creditAfter = GroupDocs.Redaction.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditAfter);
```

---

## Evaluation Limitations and Licensing of GroupDocs.Signature

Path: /signature/java/evaluation-limitations-and-licensing-of-groupdocs-signature/

{{< alert style="info" >}}You can use GroupDocs.Signature without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Limitations

You can easily download GroupDocs.Signature for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:  

*   Only first 2 pages are processed.
*   Trial badges are placed in the document on the top of each page.

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Signature API if you want to avoid its evaluation limitations.   
The license can be loaded from a file or stream object. 

#### Setting License from File

The code below will explain how to set product license.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java
// Setup license.
License license = new License();
license.setLicense(licensePath);
```

#### Setting License from Stream

The following example shows how to load a license from a stream.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java
using (FileInputStream fileStream = new FileInputStream("GroupDocs.Signature.lic"))
{
    License license = new License();
    license.setLicense(fileStream);
}
```

#### Setting Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.metered/Metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `SetMeteredKey` method.
3.  Do processing (perform task).
4.  call method `GetConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method `GetConsumptionCredit` of the `Metered` class.
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-Signature/GroupDocs.Signature-for-Java
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
double consumption = metered.getConsumptionQuantity();
System.out.print("Metered consumption = " + consumption);     

// Get count of credits consumed
double credit = metered.getConsumptionCredit();
System.out.print("Metered credit = " + credit);    
```

---

## Evaluation Limitations and Licensing of GroupDocs.Signature

Path: /signature/net/evaluation-limitations-and-licensing-of-groupdocs-signature/

{{< alert style="info" >}}
You can use GroupDocs.Signature without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.
{{< /alert >}}

## Evaluation Limitations

You can easily download GroupDocs.Signature for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:

* Only first 2 pages are processed.
* Trial badges are placed in the document on the top of each page.

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Signature API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Signature.dll file and specify the file name, without a path, as shown in the examples below.

### Setting License from File

The code below will explain how to set product license.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-Signature/GroupDocs.Signature-for-.NET
// Setup license.
License license = new License();
license.SetLicense(licensePath);
```

#### Setting License from Stream

The following example shows how to load a license from a stream.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-Signature/GroupDocs.Signature-for-.NET
using (FileStream fileStream = File.OpenRead("GroupDocs.Signature.lic"))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```

{{< alert style="info" >}}
Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Signature classes.
When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application\_Start protected method. It is called once when the application starts.  
Do not call License.SetLicense from within Page\_Load methods since it means the license will be loaded every time a web page is loaded.
{{< /alert >}}

#### Setting Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/signature/net/groupdocs.signature/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}
Here are the simple steps to use the `Metered` class.

1. Create an instance of `Metered` class.
2. Pass public & private keys to `SetMeteredKey` method.
3. Do processing (perform task).
4. Call method `GetConsumptionQuantity` of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. Call method `GetConsumptionCredit` of the `Metered` class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-Signature/GroupDocs.Signature-for-.NET
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Signature.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Signature.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

---

## Evaluation Limitations and Licensing of GroupDocs.Signature

Path: /signature/nodejs-java/evaluation-limitations-and-licensing-of-groupdocs-signature/

{{< alert style="info" >}}
You can use GroupDocs.Signature without the license. The usage and functionalities are pretty much same as the licensed one, but you will face few limitations while using the non-licensed API.
{{< /alert >}}

## Evaluation Limitations

You can easily download GroupDocs.Signature for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:

* Only first 2 pages are processed.
* Trial badges are placed in the document on the top of each page.

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Signature API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Signature.dll file and specify the file name, without a path, as shown in the examples below.

### Setting License from File

The code below will explain how to set product license.

```javascript
// For complete examples and data files, please go to https://github.com/groupdocs-Signature/GroupDocs.Signature-for-Node.js
// Setup license.
const licensePath = "path to the .lic file";
const license = new groupdocs.signature.License()
license.setLicense(licensePath);
```

#### Setting License from Stream

The following example shows how to load a license from a stream.

```javascript
// For complete examples and data files, please go to https://github.com/groupdocs-Signature/GroupDocs.Signature-for-Node.js
const fs = require('fs')

const licensePath = "path to the .lic file"
const license = new groupdocs.signature.License()
const licStream = fs.createReadStream(licensePath)
groupdocs.signature.License.setLicenseFromStream(license, licStream, err => {
    if (err) {
        console.log(`Set license error: ${err}`)
    } else {
        console.log('License set OK')
    }
})
```

{{< alert style="info" >}}
Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Signature classes.
When developing an ASPNode.js application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application\_Start protected method. It is called once when the application starts.  
Do not call License.SetLicense from within Page\_Load methods since it means the license will be loaded every time a web page is loaded.
{{< /alert >}}

#### Setting Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/signature/nodejs-java/groupdocs.signature/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}
Here are the simple steps to use the `Metered` class.

1. Create an instance of `Metered` class.
2. Pass public & private keys to `setMeteredKey` method.
3. Do processing (perform task).
4. Call method `getConsumptionQuantity` of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. Call method `getConsumptionCredit` of the `Metered` class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```javascript
// For complete examples and data files, please go to https://github.com/groupdocs-Signature/GroupDocs.Signature-for-Node.js

// Your public and private license keys
const publicKey = ''; // Your public license key
const privateKey = ''; // Your private license key

// Initialize Metered class
const metered = new groupdocs.Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
groupdocs.Metered.getConsumptionQuantity().then(amountConsumed => {
    console.log('Amount (MB) consumed: ' + amountConsumed);
}).catch(error => {
    console.error('Error getting consumption quantity:', error);
});

// Get count of credits consumed
groupdocs.Metered.getConsumptionCredit().then(creditsConsumed => {
    console.log('Credits consumed: ' + creditsConsumed);
}).catch(error => {
    console.error('Error getting consumption credit:', error);
});
```

---

## Extend supported extensions list

Path: /redaction/java/extend-supported-extensions-list/

### Extend supported extensions list

This method can be used when for some reason files have non-standard extensions or if its format is supported, but not pre-configured. For instance, all kinds of plain text files (batch, command files, etc.) could be opened. In this case you do not need to create your own format handler. As it is shown below, you can add file extension (e.g. ".dump") as being handled by the same *DocumentFormatInstance* as all plain text files:



```java
RedactorConfiguration config = DocumentFormatInstance.getDefaultConfiguration();
DocumentFormatConfiguration settings = config.findFormat(".txt");
settings.setExtensionFilter(docxSettings.getExtensionFilter() + ",.dump");
final Redactor redactor = new Redactor("C:\sample.dump");
try 
{
    // Here we can use the document instance to perform redactions
}
finally { redactor.close(); }
```

In detail, creating your own document format instances is covered in another article.

---

## Extract an image from an image annotation

Path: /annotation/net/extracting-image-from-image-annotation/


You can extract an image from the [ImageAnnotation](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation/) object. To do this, call the [ImageAnnotation.GetImage()](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation/methods/getimage) method.

The following code snippet shows how to extract an image from an image annotation:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("annotated_file.docx"))
{
	List<AnnotationBase> annotations = annotator.Get();
	for (int i = 0; i < annotations.Count; i++)
	{
		if (annotations[i] is ImageAnnotation imageAnnotation)
		{
			Image image = imageAnnotation.GetImage();
			image.Save($"extracted_image{i + 1}.{imageAnnotation.ImageExtension}");
		}
	}
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Extract cells from Microsoft Office Excel spreadsheets

Path: /parser/net/extract-cells-from-microsoft-office-excel-spreadsheets/

GroupDocs.Parser provides the functionality to extract cells from spreadsheets. The following methods are used for this purpose:

* [GetWorksheetInfo](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/getworksheetinfo#getworksheetinfo_1)() - returns the information about the worksheet
* [GetWorksheetInfo](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/getworksheetinfo#getworksheetinfo)(int) - returns the information about all worksheets in the spreadsheet
* [GetWorksheetCells](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/getworksheetcells#getworksheetcells)(int) - returns the collection of cells
* [GetWorksheetCells](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/getworksheetcells#getworksheetcells_1)(int, WorksheetOptions) - returns a collection of cells contained in set ranges.

Here are the steps to extract cells from Microsoft Office Excel spreadsheet:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial spreadsheet;
*   Call [GetWorksheetCells](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/getworksheetcells#getworksheetcells)(int) method and obtain the collection of []() objects;
*   Iterate through the collection of [WorksheetCell](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/worksheetcell) and get a cell text value.

The following example shows how to extract cells from Microsoft Office Excel spreadsheet.

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleXlsx))
{
    // Check if worksheet cells extraction is supported
    if (!parser.Features.Worksheet)
    {
        throw new NotSupportedException("Worksheet cells extraction isn't supported");
    }

    // Get the information about worksheets
    IEnumerable<WorksheetInfo> info = parser.GetWorksheetInfo();
   
    // Iterate over worksheet information
    foreach(WorksheetInfo i in info)
    {
        // Print the worksheet name
        Console.WriteLine(i.Name);
        Console.WriteLine();

        // Get the worksheet cells
        IEnumerable<WorksheetCell> cells = parser.GetWorksheetCells(i.Index);

        // Iterate over cells
        foreach (WorksheetCell c in cells)
        {
            // Print the cell information and text value
            Console.WriteLine($"Row: {c.RowIndex} Column: {c.ColumnIndex} RowSpan: {c.RowSpan} ColumnSpan: {c.ColumnSpan}");
            Console.WriteLine(c.Text);
            Console.WriteLine();
        }
    }
}
```

The following example shows how to extract cells from Microsoft Office Excel spreadsheet with customization:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleXlsx))
{
    // Check if worksheet cells extraction is supported
    if (!parser.Features.Worksheet)
    {
        throw new NotSupportedException("Worksheet cells extraction isn't supported");
    }

    // Get the information about the first worksheet
    WorksheetInfo info = parser.GetWorksheetInfo(0);

    // Print the worksheet name
    Console.WriteLine(info.Name);
    Console.WriteLine();

    // Create the range that represents the first two rows
    WorksheetRange range = new WorksheetRange(
        info.MinRowIndex,
        Math.Min(info.MinRowIndex + 1, info.MaxRowIndex),
        info.MinColumnIndex,
        info.MaxColumnIndex);

    // Get the worksheet cells from the first two rows
    IEnumerable<WorksheetCell> cells = parser.GetWorksheetCells(0, new WorksheetOptions(range));

    // Iterate over cells
    foreach (WorksheetCell c in cells)
    {
        // Print the cell information and text value
        Console.WriteLine($"Row: {c.RowIndex} Column: {c.ColumnIndex} RowSpan: {c.RowSpan} ColumnSpan: {c.ColumnSpan}");
        Console.WriteLine(c.Text);
        Console.WriteLine();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract emails from Outlook Storage

Path: /parser/java/extract-emails-from-outlook-storage/

To extract emails from Outlook Storage [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects.

Outlook Storage item can contain the following metadata:

| Name | Description |
| --- | --- |
| date | The time and date at which the Outlook Storage item was last modified. |
| email-sender | The value of "sender" field. |
| email-to | The value of "to" field. |
| subject | The value of "subject" field. |

Outlook Storage container consists of email documents (msg files).

Here are the steps to extract an email text from outlook storage:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call  [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and obtain [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object to extract a text.

The following example shows how to extract a text from emails in outlook storage:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleOutlook)) {
    // Extract attachments from the container
    Iterable<ContainerItem> attachments = parser.getContainer();
    // Check if container extraction is supported
    if (attachments == null) {
        System.out.println("Container extraction isn't supported");
    }
    // Iterate over zip entities
    for (ContainerItem item : attachments) {
        // Print the file path
        System.out.println(item.getFilePath());
        // Print metadata
        for (MetadataItem metadata : item.getMetadata()) {
            System.out.println(String.format("%s: %s", metadata.getName(), metadata.getValue()));
        }
        try {
            // Create Parser object for the zip entity content
            try (Parser attachmentParser = item.openParser()) {
                // Extract an zip entity text
                try (TextReader reader = attachmentParser.getText()) {
                    System.out.println(reader == null ? "No text" : reader.readToEnd());
                }
            }
        } catch (UnsupportedDocumentFormatException ex) {
            System.out.println("Isn't supported.");
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract emails from Outlook Storage

Path: /parser/net/extract-emails-from-outlook-storage/

To extract emails from Outlook Storage [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method is used. This method returns the collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects.

Outlook Storage item can contain the following metadata:

| Name | Description |
| --- | --- |
| date | The time and date at which the Outlook Storage item was last modified. |
| email-sender | The value of "sender" field. |
| email-to | The value of "to" field. |
| subject | The value of "subject" field. |

Outlook Storage container consists of email documents (msg files).

Here are the steps to extract an email text from Outlook Storage:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and get container item names, sizes and obtain content.

The following example shows how to extract a text from emails in Outlook Storage:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();
    // Check if container extraction is supported
    if(attachments == null)
    {
        Console.WriteLine("Container extraction isn't supported");
    }

    // Iterate over attachments
    foreach(ContainerItem item in attachments)
    {
		// Print the file path
		Console.WriteLine(item.FilePath);
        
        // Print metadata
        foreach (MetadataItem metadata in item.Metadata)
        {
            Console.WriteLine(string.Format("{0}: {1}", metadata.Name, metadata.Value));
        }

		try
        {
            // Create Parser object for the email content
            using (Parser attachmentParser = item.OpenParser())
            {
                // Extract an email text
                using (TextReader reader = attachmentParser.GetText())
                {
                    Console.WriteLine(reader == null ? "No text" : reader.ReadToEnd());
                }
            }
        }
        catch (UnsupportedDocumentFormatException)
        {
            Console.WriteLine("Isn't supported.");
        }
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract highlights

Path: /parser/python-net/extract-highlights/


GroupDocs.Parser provides functionality to extract highlights - text fragments with surrounding context. This feature is useful for creating search result previews, text snippets, and contextual excerpts.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents for testing
- Understanding of text positioning concepts

## What are highlights?

Highlights are text fragments extracted from a document at a specific position, including:
- **Text:** The main text content
- **Position:** Character position in the document
- **Context:** Surrounding text before and after

## Extract highlights

To extract a highlight from a specific position:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import HighlightOptions

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Create highlight options (extract 20 characters)
    options = HighlightOptions(20)
    
    # Extract highlight at position 100
    highlight = parser.get_highlight(100, True, options)
    
    if highlight:
        print(f"Position: {highlight.position}")
        print(f"Text: {highlight.text}")
    else:
        print("Highlight extraction not supported or position out of range")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-highlights/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns a `HighlightItem` object containing the text fragment starting at the specified position, or `None` if extraction is not supported.

## Extract highlights with fixed length

To extract highlights with a specific character count:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import HighlightOptions

# Create an instance of Parser class
with Parser("sample.docx") as parser:
    # Define positions to extract highlights from
    positions = [0, 100, 500, 1000]
    
    # Create highlight options (50 characters)
    options = HighlightOptions(50)
    
    for pos in positions:
        # Extract highlight
        highlight = parser.get_highlight(pos, True, options)
        
        if highlight:
            print(f"
Position {pos}:")
            print(f"Text: {highlight.text}")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-highlights/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts 50-character text fragments from specified positions.

## Extract highlights for search results

To create search result previews with context:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import SearchOptions, HighlightOptions

def get_search_results_with_context(file_path, keyword, context_length=30):
    """
    Search for keyword and extract surrounding context.
    """
    with Parser(file_path) as parser:
        # Create highlight options for context
        highlight_opts = HighlightOptions(context_length)
        
        # Create search options with highlights
        search_opts = SearchOptions(
            match_case=False,
            match_whole_word=False,
            use_regular_expression=False,
            left_highlight_options=highlight_opts,
            right_highlight_options=highlight_opts
        )
        
        # Search for keyword
        results = parser.search(keyword, search_opts)
        
        if results is None:
            print("Search not supported")
            return []
        
        # Collect results with context
        search_results = []
        for result in results:
            left_context = result.left_highlight_item.text if result.left_highlight_item else ""
            right_context = result.right_highlight_item.text if result.right_highlight_item else ""
            
            search_results.append({
                'keyword': result.text,
                'position': result.position,
                'page': result.page_index + 1 if hasattr(result, 'page_index') else None,
                'left_context': left_context,
                'right_context': right_context,
                'full_snippet': f"{left_context}[{result.text}]{right_context}"
            })
        
        return search_results

# Usage
results = get_search_results_with_context("sample.pdf", "artificial intelligence", 40)

print(f"Found {len(results)} occurrences:
")
for idx, result in enumerate(results, 1):
    print(f"{idx}. {result['full_snippet']}")
    if result['page']:
        print(f"   (Page {result['page']}, position {result['position']})
")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Searches for keywords and returns results with surrounding context for better previews.

## Extract highlights from multiple positions

To extract text snippets from various document sections:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import HighlightOptions

def extract_multiple_highlights(file_path, positions, length=50):
    """
    Extract highlights from multiple positions.
    """
    highlights = []
    
    with Parser(file_path) as parser:
        options = HighlightOptions(length)
        
        for position in positions:
            highlight = parser.get_highlight(position, True, options)
            
            if highlight:
                highlights.append({
                    'position': highlight.position,
                    'text': highlight.text,
                    'length': len(highlight.text)
                })
        
        return highlights

# Extract highlights at specific positions
positions = [0, 500, 1000, 1500, 2000]
highlights = extract_multiple_highlights("sample.pdf", positions, length=80)

print(f"Extracted {len(highlights)} highlights:
")
for h in highlights:
    print(f"Position {h['position']}:")
    print(f"  {h['text'][:60]}...")
    print()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-highlights/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts text fragments from multiple specified positions in the document.

## Create document preview with highlights

To generate a document preview with highlighted sections:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import HighlightOptions

def create_document_preview(file_path, num_sections=5, section_length=100):
    """
    Create a document preview by extracting highlights from various positions.
    """
    with Parser(file_path) as parser:
        # Get document text to determine positions
        text_reader = parser.get_text()
        
        if not text_reader:
            print("Text extraction not supported")
            return None
        
        full_text = text_reader
        text_length = len(full_text)
        
        # Calculate evenly distributed positions
        if text_length <= section_length:
            positions = [0]
        else:
            step = text_length // num_sections
            positions = [i * step for i in range(num_sections)]
        
        # Extract highlights
        preview_sections = []
        options = HighlightOptions(section_length)
        
        for pos in positions:
            highlight = parser.get_highlight(pos, True, options)
            if highlight:
                preview_sections.append(highlight.text)
        
        return {
            'document_length': text_length,
            'preview_sections': preview_sections,
            'full_preview': '
...
'.join(preview_sections)
        }

# Usage
preview = create_document_preview("sample.pdf", num_sections=3, section_length=150)

if preview:
    print(f"Document length: {preview['document_length']} characters
")
    print("Preview:")
    print(preview['full_preview'])
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Creates a representative preview of the document by extracting highlights from evenly distributed positions.

## Extract highlights with word boundaries

To extract highlights respecting word boundaries:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import HighlightOptions

def extract_highlight_with_words(file_path, position, max_length=100):
    """
    Extract highlight ensuring complete words.
    """
    with Parser(file_path) as parser:
        # Extract more than needed
        options = HighlightOptions(max_length + 50)
        highlight = parser.get_highlight(position, True, options)
        
        if not highlight:
            return None
        
        text = highlight.text
        
        # Find last complete word within max_length
        if len(text) > max_length:
            truncated = text[:max_length]
            last_space = truncated.rfind(' ')
            if last_space > 0:
                text = truncated[:last_space] + "..."
        
        return {
            'position': highlight.position,
            'text': text,
            'complete_words': True
        }

# Usage
highlight = extract_highlight_with_words("sample.pdf", 500, 80)
if highlight:
    print(f"Position {highlight['position']}:")
    print(highlight['text'])
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-highlights/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts highlights that end at word boundaries, avoiding cut-off words.

## Highlight extraction for table of contents

To create a table of contents with text previews:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import HighlightOptions

def create_toc_with_previews(file_path, preview_length=60):
    """
    Create table of contents with text previews for each section.
    """
    with Parser(file_path) as parser:
        # Get TOC
        toc_items = parser.get_toc()
        
        if not toc_items:
            print("TOC extraction not supported")
            return []
        
        toc_with_previews = []
        options = HighlightOptions(preview_length)
        
        # Get text to find section positions
        text_reader = parser.get_text()
        if not text_reader:
            return []
        
        full_text = text_reader
        
        for item in toc_items:
            # Try to extract highlight for this TOC item
            # Use text search to find the section
            section_text = item.text
            position = full_text.find(section_text)
            
            if position >= 0:
                highlight = parser.get_highlight(position, True, options)
                preview = highlight.text if highlight else "No preview available"
            else:
                preview = "Section not found"
            
            toc_with_previews.append({
                'title': item.text,
                'depth': item.depth,
                'preview': preview
            })
        
        return toc_with_previews

# Usage
toc = create_toc_with_previews("SampleWithToc.pdf", preview_length=100)
for item in toc:
    indent = "  " * item['depth']
    print(f"{indent}{item['title']}")
    print(f"{indent}  Preview: {item['preview'][:50]}...")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Generates a table of contents with text previews for each section.

## Notes

- The `get_highlight()` method returns `None` if highlight extraction is not supported
- The second parameter (boolean) indicates whether to extract from fixed position (True) or dynamic position (False)
- Highlight length is specified in characters
- Use highlights with search results to show context
- Highlights are useful for creating document previews and snippets
- Consider word boundaries when displaying highlights to users

## Related pages

- [Search text in documents]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/search-text" >}})
- [Extract text areas]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-areas" >}})
- [Extract text in Accurate mode]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode" >}})


---

## Extract tables from Microsoft Office Word documents

Path: /parser/java/extract-tables-from-microsoft-office-word-documents/

To extract tables from Microsoft Office Word document [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method is used. This method returns XML representation of the document. Tables are represented by "table" tag. For more details, see [Extract text structure]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/extract-text-structure.md" >}}).

{{< alert style="warning" >}}[getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method returns null value if text structure extraction isn't supported for the document. For example, text structure extraction isn't supported for TXT files. Therefore, for TXT file [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method returns null. If Microsoft Office Word document has no text, [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method returns an empty org.w3c.dom.Document object.{{< /alert >}}

Here are the steps to extract tables from Microsoft Office Word documents:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method and obtain [*org.w3c.dom.Document*](https://docs.oracle.com/javase/7/docs/api/org/w3c/dom/Document.html?is-external=true) object;
*   Iterate through the XML document.

The following example demonstrates how to extract tables from Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract text structure to the XML reader
    Document document = parser.getStructure();
    // Read XML document
    readNode(document.getDocumentElement());
}

private static void readNode(Node node) {
    NodeList nodes = node.getChildNodes();
    // Iterate over the child nodes
    for (int i = 0; i < nodes.getLength(); i++) {
        Node n = nodes.item(i);
        // If it's a table
        if (n.getNodeName().toLowerCase() == "table") {
            System.out.println("table");
            // Process node
            processNode(n);
        }
        readNode(n);
    }
}
private static void processNode(Node node) {
    NodeList nodes = node.getChildNodes();
    // Iterate over the child nodes
    for (int i = 0; i < nodes.getLength(); i++) {
        Node n = nodes.item(i);
        switch (n.getNodeName().toLowerCase()) {
            // In the case of a row or cell
            case "tr":
            case "td": {
                // Print the name
                System.out.println(n.getNodeName());
                // Process sub-nodes
                processNode(n);
                System.out.println();
                System.out.println("/" + n.getNodeName());
                break;
            }
            default:
                // Print the node value (if it's not null)
                String value = n.getNodeValue();
                if(value != null) {
                    System.out.print(value);
                }
                processNode(n);
                break;
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract Tables from Microsoft Office Word Documents

Path: /parser/net/extract-tables-from-microsoft-office-word-documents/


This guide explains how to extract tables from Microsoft Office Word documents (`.doc`, `.docx`) using GroupDocs.Parser for .NET.

## How Table Extraction Works

GroupDocs.Parser converts a document's layout into a structured XML format. Tables are represented by `<table>` tags within this XML. The extraction process involves reading this XML structure to identify and process table content.

{{< alert style="warning" >}}
[GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method returns *null* value if text structure extraction isn't supported for the document. For example, text structure extraction isn't supported for TXT files. Therefore, for TXT file [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method returns *null*. If Microsoft Office Word document has no text, [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure)[](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata)method returns an empty [XmlReader](https://docs.microsoft.com/en-us/dotnet/api/system.xml.xmlreader?view=netframework-2.0) object.
{{< /alert >}}

## Step-by-Step Guide

### 1. Create a Parser Instance
Begin by initializing the Parser with your document path.

```csharp
using (Parser parser = new Parser("YourDocument.docx"))
{
    // Extraction code goes here
}
```

### 2. Retrieve Document Structure
Get the XML representation of the document's structure.

```csharp
using (XmlReader reader = parser.GetStructure())
{
    if (reader == null)
    {
        Console.WriteLine("Text structure extraction isn't supported for this document.");
        return;
    }
    // Process the XML structure
}
``` 

### 3. Find and Process Tables
Iterate through the XML to locate and process table elements.

```csharp
while (reader.Read())
{
    // Look for table start elements
    if (reader.NodeType == XmlNodeType.Element && reader.Name == "table")
    {
        Console.WriteLine("Found a table:");
        ProcessTable(reader);
    }
}
```

### 4. Table Processing Method
This method handles the extraction of rows and cells from each table.

```csharp
private static void ProcessTable(XmlReader reader)
{
    StringBuilder cellValue = new StringBuilder();
    int rowIndex = 0;

    while (reader.Read())
    {
        // Exit when table ends
        if (reader.NodeType == XmlNodeType.EndElement && reader.Name == "table")
        {
            break;
        }

        // Detect new rows
        if (reader.NodeType == XmlNodeType.Element && reader.Name == "tr")
        {
            rowIndex++;
            Console.WriteLine($"[Row {rowIndex}]");
        }

        // Reset cell value at cell start
        if (reader.NodeType == XmlNodeType.Element && reader.Name == "td")
        {
            cellValue.Clear();
        }

        // Output cell value at cell end
        if (reader.NodeType == XmlNodeType.EndElement && reader.Name == "td")
        {
            Console.WriteLine($"  {cellValue}");
        }

        // Accumulate cell text content
        if (reader.NodeType == XmlNodeType.Text)
        {
            cellValue.Append(reader.Value);
        }
    }
}
```

### Complete Example
Here's a complete working example that extracts and displays tables from a Word document:

```csharp
using System;
using System.Text;
using System.Xml;
using GroupDocs.Parser;

public static class WordTableExtractor
{
    public static void ExtractTables(string filePath)
    {
        using (Parser parser = new Parser(filePath))
        {
            using (XmlReader reader = parser.GetStructure())
            {
                if (reader == null)
                {
                    Console.WriteLine("Text structure extraction isn't supported for this document.");
                    return;
                }

                Console.WriteLine($"Analyzing: {filePath}");
                Console.WriteLine("----------------------------------------");

                while (reader.Read())
                {
                    if (reader.NodeType == XmlNodeType.Element && reader.Name == "table")
                    {
                        Console.WriteLine("\n>>> TABLE FOUND");
                        ProcessTable(reader);
                    }
                }
            }
        }
    }

    private static void ProcessTable(XmlReader reader)
    {
        StringBuilder cellValue = new StringBuilder();
        int rowIndex = 0;

        while (reader.Read())
        {
            if (reader.NodeType == XmlNodeType.EndElement && reader.Name == "table")
            {
                break;
            }

            if (reader.NodeType == XmlNodeType.Element && reader.Name == "tr")
            {
                rowIndex++;
                Console.WriteLine($"[Row {rowIndex}]");
            }

            if (reader.NodeType == XmlNodeType.Element && reader.Name == "td")
            {
                cellValue.Clear();
            }

            if (reader.NodeType == XmlNodeType.EndElement && reader.Name == "td")
            {
                Console.WriteLine($"  {cellValue}");
            }

            if (reader.NodeType == XmlNodeType.Text)
            {
                cellValue.Append(reader.Value);
            }
        }
    }
}
``` 

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from documents

Path: /parser/java/extract-text-from-documents/

GroupDocs.Parser allows to extract text from PDF, Emails, Ebooks, Microsoft Office formats: Word (DOC, DOCX), PowerPoint (PPT, PPTX), Excel (XLS, XLSX), LibreOffice formats and many others (see full list at [supported document formats]({{< ref "parser/java/getting-started/supported-document-formats.md" >}}) article).

GroupDocs.Parser's text extractor is easy to use and powerful at the same time (to resolve complex scenarios see [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}})).

This article demonstrates how to implement the simplest scenario - extract text from any supported format without additional settings.

# Extract text from documents

To extract text from documents simply call the [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method:

```java
TextReader getText();
```

This method returns an instance of [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class with an extracted text. 

[TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class extends [*java.io.Reader*](http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true) and adds the following members:

| Member | Description |
| --- | --- |
| [readLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readLine()) | Reads a line of characters from the text reader and returns the data as a string. |
| [readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) | Reads all characters from the current position to the end of the text reader and returns them as one string. |

Here are the steps to extract a text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Check if *reader* isn't *null* (text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a text from a document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Extract a text into the reader
    try (TextReader reader = parser.getText()) {
        // Print a text from the document
        // If text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Text extraction isn't supported" : reader.readToEnd());
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text from documents

Path: /parser/net/extract-text-from-documents/

GroupDocs.Parser allows to extract text from PDF, Emails, Ebooks, Microsoft Office formats: Word (DOC, DOCX), PowerPoint (PPT, PPTX), Excel (XLS, XLSX), LibreOffice formats and many others (see full list at [supported document formats]({{< ref "parser/net/getting-started/supported-document-formats.md" >}}) article).

GroupDocs.Parser's text extractor is easy to use and powerful at the same time (to resolve complex scenarios see [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/_index.md" >}})).

This article demonstrates how to implement the simplest scenario - extract text from any supported format without additional settings.

## Extract text from documents

To extract text from documents simply call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method:

```csharp
TextReader GetText();


```

Methods return an instance of [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) class with an extracted text. 

Here are the steps to extract a text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Read a text from *reader*.

The following example shows how to extract a text from a document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a text into the reader
    using (TextReader reader = parser.GetText())
    {
        // Print a text from the document
        // If text extraction isn't supported, reader is null
        Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## More resources

### Advanced usage topics

To learn more about text extraction features, please refer the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online text extractor App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract text from your documents with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Faceted search

Path: /search/java/faceted-search/

This page describes the creation of faceted search queries.

## Faceted search definition

Faceted search within GroupDocs.Search is a filtering of search results by setting valid document field names to search.

## Creating faceted search queries

Faceted search allows you to search only in certain fields of documents, for example, only in the content field or in the file name field. A simple faceted search example is presented below with queries in text and object form.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search in the content field with text query
SearchResult result1 = index.search("content: Einstein");
 
// Search in the content field with object query
SearchQuery wordQuery = SearchQuery.createWordQuery("Einstein");
SearchQuery fieldQuery = SearchQuery.createFieldQuery(CommonFieldNames.Content, wordQuery);
SearchResult result2 = index.search(fieldQuery);
```

Faceted search can be combined with other types of searches using parentheses. The following faceted search example demonstrates the same multi-faceted search query in text and object form. Both queries search for documents in the name of which there are both the words "Albert" and "Einstein", or the documents in the contents of which contain the phrase "theory of relativity" or the phrase "special relativity".



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.search("(filename: (Albert AND Einstein)) OR (content: (\"theory of relativity\" OR \"special relativity\"))");
 
// Search with object query
SearchQuery albertQuery = SearchQuery.createWordQuery("Albert");
SearchQuery einsteinQuery = SearchQuery.createWordQuery("Einstein");
SearchQuery andQuery = SearchQuery.createAndQuery(albertQuery, einsteinQuery);
SearchQuery filenameQuery = SearchQuery.createFieldQuery(CommonFieldNames.FileName, andQuery);
 
SearchQuery theoryQuery = SearchQuery.createWordQuery("theory");
SearchQuery ofQuery = SearchQuery.createWordQuery("of");
SearchQuery relativity1Query = SearchQuery.createWordQuery("relativity");
SearchQuery specialQuery = SearchQuery.createWordQuery("special");
SearchQuery relativity2Query = SearchQuery.createWordQuery("relativity");
 
SearchQuery phrase1Query = SearchQuery.createPhraseSearchQuery(theoryQuery, ofQuery, relativity1Query);
SearchQuery phrase2Query = SearchQuery.createPhraseSearchQuery(specialQuery, relativity2Query);
SearchQuery orQuery = SearchQuery.createOrQuery(phrase1Query, phrase2Query);
SearchQuery contentQuery = SearchQuery.createFieldQuery(CommonFieldNames.Content, orQuery);
 
SearchQuery rootQuery = SearchQuery.createOrQuery(filenameQuery, contentQuery);
SearchResult result2 = index.search(rootQuery);
```

## Using format specific fields

For each document format, there are standard fields that may be present in documents of this type. The library provides the following classes containing constants with the names of standard document fields: [EpubFieldNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/EpubFieldNames), [FictionBookFieldNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/FictionBookFieldNames), [MailFieldNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MailFieldNames), [PresentationFieldNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/PresentationFieldNames), [SpreadsheetFieldNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SpreadsheetFieldNames), [WordsFieldNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/WordsFieldNames).

There are also fields that may be present in documents of any type. The names of such fields are represented in the [CommonFieldNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/CommonFieldNames) class.

An example of using standard field names of documents is presented in the following example.



```java
String indexFolder = "c:\\MyIndex";
String documentsFolder = "c:\\MyDocuments";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search in the content field with text query
String query1 = WordsFieldNames.Company + ": Dycum";
SearchResult result1 = index.search(query1);
 
// Search in the content field with object query
SearchQuery wordQuery = SearchQuery.createWordQuery("Dycum");
SearchQuery fieldQuery = SearchQuery.createFieldQuery(WordsFieldNames.Company, wordQuery);
SearchResult result2 = index.search(fieldQuery);
```

The following are the names of standard fields included in the library grouped by the formats containing them.

### Common fields

*   Content
    
*   FileName
    
*   FormatFamily
    
*   CreationDate
    
*   ModificationDate
    

### Epub format fields

*   Title
    
*   Subject
    
*   Author
    
*   Description
    
*   Language
    
*   Copyrights
    
*   Publisher
    
*   PublishedDate
    

### Fiction Book format fields

*   Title
    
*   Subject
    
*   Keywords
    
*   Author
    
*   Description
    
*   Language
    
*   Publisher
    
*   PublishedDate
    

### Mail format fields

*   MailMessageBody
    
*   MailSenderName
    
*   MailDisplayTo
    
*   MailSubject
    

### Presentation format fields

*   Application
    
*   ApplicationVersion
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    
*   RevisionNumber
    
*   TotalEditingTime
    

### Spreadsheet format fields

*   Application
    
*   ApplicationVersion
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    

### Words format fields

*   Application
    
*   ApplicationVersion
    
*   Template
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    
*   RevisionNumber
    
*   TotalEditingTime
    

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Faceted search

Path: /search/net/faceted-search/

This page describes the creation of faceted search queries.

## Faceted search definition

Faceted search within GroupDocs.Search is a filtering of search results by setting valid document field names to search.

## Creating faceted search queries

Faceted search allows you to search only in certain fields of documents, for example, only in the content field or in the file name field. A simple faceted search example is presented below with queries in text and object form.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search in the content field with text query
SearchResult result1 = index.Search("content: Einstein");
 
// Search in the content field with object query
SearchQuery wordQuery = SearchQuery.CreateWordQuery("Einstein");
SearchQuery fieldQuery = SearchQuery.CreateFieldQuery(CommonFieldNames.Content, wordQuery);
SearchResult result2 = index.Search(fieldQuery);
```

Faceted search can be combined with other types of searches using parentheses. The following faceted search example demonstrates the same multi-faceted search query in text and object form. Both queries search for documents in the name of which there are both the words "Albert" and "Einstein", or the documents in the contents of which contain the phrase "theory of relativity" or the phrase "special relativity".

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.Search("(filename: (Albert AND Einstein)) OR (content: (\"theory of relativity\" OR \"special relativity\"))");
 
// Search with object query
SearchQuery albertQuery = SearchQuery.CreateWordQuery("Albert");
SearchQuery einsteinQuery = SearchQuery.CreateWordQuery("Einstein");
SearchQuery andQuery = SearchQuery.CreateAndQuery(albertQuery, einsteinQuery);
SearchQuery filenameQuery = SearchQuery.CreateFieldQuery(CommonFieldNames.FileName, andQuery);
 
SearchQuery theoryQuery = SearchQuery.CreateWordQuery("theory");
SearchQuery ofQuery = SearchQuery.CreateWordQuery("of");
SearchQuery relativity1Query = SearchQuery.CreateWordQuery("relativity");
SearchQuery specialQuery = SearchQuery.CreateWordQuery("special");
SearchQuery relativity2Query = SearchQuery.CreateWordQuery("relativity");
 
SearchQuery phrase1Query = SearchQuery.CreatePhraseSearchQuery(theoryQuery, ofQuery, relativity1Query);
SearchQuery phrase2Query = SearchQuery.CreatePhraseSearchQuery(specialQuery, relativity2Query);
SearchQuery orQuery = SearchQuery.CreateOrQuery(phrase1Query, phrase2Query);
SearchQuery contentQuery = SearchQuery.CreateFieldQuery(CommonFieldNames.Content, orQuery);
 
SearchQuery rootQuery = SearchQuery.CreateOrQuery(filenameQuery, contentQuery);
SearchResult result2 = index.Search(rootQuery);
```

## Using format specific fields

For each document format, there are standard fields that may be present in documents of this type. The library provides the following classes containing constants with the names of standard document fields: [EpubFieldNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/epubfieldnames), [FictionBookFieldNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/fictionbookfieldnames), [MailFieldNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/mailfieldnames), [PresentationFieldNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/presentationfieldnames), [SpreadsheetFieldNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/spreadsheetfieldnames), [WordsFieldNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/wordsfieldnames).

There are also fields that may be present in documents of any type. The names of such fields are represented in the [CommonFieldNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/commonfieldnames) class.

An example of using standard field names of documents is presented in the following example.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search in the content field with text query
string query1 = WordsFieldNames.Company + ": Dycum";
SearchResult result1 = index.Search(query1);
 
// Search in the content field with object query
SearchQuery wordQuery = SearchQuery.CreateWordQuery("Dycum");
SearchQuery fieldQuery = SearchQuery.CreateFieldQuery(WordsFieldNames.Company, wordQuery);
SearchResult result2 = index.Search(fieldQuery);
```

The following are the names of standard fields included in the library grouped by the formats containing them.

### Common fields

*   Content
    
*   FileName
    
*   FormatFamily
    
*   CreationDate
    
*   ModificationDate
    

### Epub format fields

*   Title
    
*   Subject
    
*   Author
    
*   Description
    
*   Language
    
*   Copyrights
    
*   Publisher
    
*   PublishedDate
    

### Fiction Book format fields

*   Title
    
*   Subject
    
*   Keywords
    
*   Author
    
*   Description
    
*   Language
    
*   Publisher
    
*   PublishedDate
    

### Mail format fields

*   MailMessageBody
    
*   MailSenderName
    
*   MailDisplayTo
    
*   MailSubject
    

### Presentation format fields

*   Application
    
*   ApplicationVersion
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    
*   RevisionNumber
    
*   TotalEditingTime
    

### Spreadsheet format fields

*   Application
    
*   ApplicationVersion
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    

### Words format fields

*   Application
    
*   ApplicationVersion
    
*   Template
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    
*   RevisionNumber
    
*   TotalEditingTime
    

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Faceted search

Path: /search/nodejs-java/faceted-search/

This page describes the creation of faceted search queries.

## Faceted search definition

Faceted search within GroupDocs.Search is a filtering of search results by setting valid document field names to search.

## Creating faceted search queries

Faceted search allows you to search only in certain fields of documents, for example, only in the content field or in the file name field. A simple faceted search example is presented below with queries in text and object form.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search in the content field with text query
const query1 = 'content: Pellentesque';
const result1 = index.search(query1);

// Search in the content field with object query
const wordQuery = groupdocs.search.SearchQuery.createWordQuery('Pellentesque');
const fieldQuery = groupdocs.search.SearchQuery.createFieldQuery(
  groupdocs.search.CommonFieldNames.Content,
  wordQuery,
);

const result2 = index.search(fieldQuery);
```

Faceted search can be combined with other types of searches using parentheses. The following faceted search example demonstrates the same multi-faceted search query in text and object form. Both queries search for documents in the name of which there are both the words "lorem" and "ipsum", or the documents in the contents of which contain the phrase "lectus eu aliquam" or the phrase "dignissim turpis".

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search with text query
const query1 = '(filename: (lorem AND ipsum)) OR (content: ("lectus eu aliquam" OR "dignissim turpis"))';
const result1 = index.search(query1);

// Search with object query
const word6Query = groupdocs.search.SearchQuery.createWordQuery('lorem');
const word7Query = groupdocs.search.SearchQuery.createWordQuery('ipsum');
const andQuery = groupdocs.search.SearchQuery.createAndQuery(word6Query, word7Query);
const filenameQuery = groupdocs.search.SearchQuery.createFieldQuery(
  groupdocs.search.CommonFieldNames.FileName,
  andQuery,
);

const word1Query = groupdocs.search.SearchQuery.createWordQuery('lectus');
const word2Query = groupdocs.search.SearchQuery.createWordQuery('eu');
const word3Query = groupdocs.search.SearchQuery.createWordQuery('aliquam');
const word4Query = groupdocs.search.SearchQuery.createWordQuery('dignissim');
const word5Query = groupdocs.search.SearchQuery.createWordQuery('turpis');

const phrase1Query = groupdocs.search.SearchQuery.createPhraseSearchQuery(word1Query, word2Query, word3Query);
const phrase2Query = groupdocs.search.SearchQuery.createPhraseSearchQuery(word4Query, word5Query);
const orQuery = groupdocs.search.SearchQuery.createOrQuery(phrase1Query, phrase2Query);
const contentQuery = groupdocs.search.SearchQuery.createFieldQuery(
  groupdocs.search.CommonFieldNames.Content,
  orQuery,
);

const rootQuery = groupdocs.search.SearchQuery.createOrQuery(filenameQuery, contentQuery);
const result2 = index.search(rootQuery);
```

## Using format specific fields

For each document format, there are standard fields that may be present in documents of this type. The library provides the following classes containing constants with the names of standard document fields: [EpubFieldNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/EpubFieldNames), [FictionBookFieldNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/FictionBookFieldNames), [MailFieldNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MailFieldNames), [PresentationFieldNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/PresentationFieldNames), [SpreadsheetFieldNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SpreadsheetFieldNames), [WordsFieldNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/WordsFieldNames).

There are also fields that may be present in documents of any type. The names of such fields are represented in the [CommonFieldNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/CommonFieldNames) class.

An example of using standard field names of documents is presented in the following example.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search in the content field with text query
const query1 = groupdocs.search.WordsFieldNames.Company + ": Dycum";
const result1 = index.search(query1);

// Search in the content field with object query
const wordQuery = groupdocs.search.SearchQuery.createWordQuery("Dycum");
const fieldQuery = groupdocs.search.SearchQuery.createFieldQuery(groupdocs.search.WordsFieldNames.Company, wordQuery);
const result2 = index.search(fieldQuery);
```

The following are the names of standard fields included in the library grouped by the formats containing them.

### Common fields

*   Content
    
*   FileName
    
*   FormatFamily
    
*   CreationDate
    
*   ModificationDate
    

### Epub format fields

*   Title
    
*   Subject
    
*   Author
    
*   Description
    
*   Language
    
*   Copyrights
    
*   Publisher
    
*   PublishedDate
    

### Fiction Book format fields

*   Title
    
*   Subject
    
*   Keywords
    
*   Author
    
*   Description
    
*   Language
    
*   Publisher
    
*   PublishedDate
    

### Mail format fields

*   MailMessageBody
    
*   MailSenderName
    
*   MailDisplayTo
    
*   MailSubject
    

### Presentation format fields

*   Application
    
*   ApplicationVersion
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    
*   RevisionNumber
    
*   TotalEditingTime
    

### Spreadsheet format fields

*   Application
    
*   ApplicationVersion
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    

### Words format fields

*   Application
    
*   ApplicationVersion
    
*   Template
    
*   Title
    
*   Subject
    
*   Comments
    
*   Keywords
    
*   ContentStatus
    
*   Category
    
*   Manager
    
*   Author
    
*   LastAuthor
    
*   Company
    
*   HyperlinkBase
    
*   CreatedTime
    
*   LastSavedTime
    
*   LastPrintedTime
    
*   RevisionNumber
    
*   TotalEditingTime
    

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Fluent syntax

Path: /conversion/net/fluent-syntax/

Fluent syntax provides a compact notation for most typical actions of GroupDocs.Conversion for .NET API. 

These actions include:
* Loading files from various sources, 
* Configuring conversion settings,
* Converting to the target format,
* Saving converted files to various locations,
* and so on.

Fluent syntax was introduced in version 22.1. and later reworked in version 23.6.

The fluent syntax is implemented by the [FluentConverter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/fluentconverter/) class and several helper interfaces from the [GroupDocs.Conversion.Fluent](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.fluent/) namespace. 

The following code snippets show how to use the fluent syntax:

```csharp
FluentConverter.Load("sample.docx")
    .ConvertTo("converted.pdf")
    .Convert();

FluentConverter.WithSettings(() => new ConverterSettings())
    .Load("sample.pdf").WithOptions(new PdfLoadOptions())
    .ConvertTo("converted.docx").WithOptions(new WordProcessingConvertOptions())
    .Convert();

FluentConverter.Load("sample.pdf").WithOptions(new PdfLoadOptions())
    .ConvertByPageTo((SavePageContext saveContext) => new FileStream($"converted-{saveContext.Page}.docx", FileMode.Create)).WithOptions(new WordProcessingConvertOptions())
    .Convert();

FluentConverter.Load("sample.pdf").GetPossibleConversions();
FluentConverter.Load("sample.pdf").GetDocumentInfo();
FluentConverter.Load("sample.pdf").WithOptions(new PdfLoadOptions()).GetPossibleConversions();
FluentConverter.Load("sample.pdf").WithOptions(new PdfLoadOptions()).GetDocumentInfo();
```

---

## Font extraction options

Path: /editor/java/font-extraction-options/

## Introduction

WordProcessing documents contain usually text content, while every piece of text should be represented with some font. There may be used system fonts (installed in the operating system), but also custom fonts, which are not installed in the system. On the other hand, lots of WordProcessing formats like DOCX and ODT have an ability to store fonts inside the document itself; such fonts, stored as the binary resources inside WordProcessing files, are called *embedded*. Embedded fonts are the only choice for the end-user to use some specific fonts, which are not installed in the system. But any font can be embedded into the document. This means, that, for example, there can be a situation, when the same font is installed in the system, and at the same time embedded in the WordProcessing document.

In the MS Windows operating system before Windows 10 (and MS Windows Server 2016) there is only one location, where fonts, installed in the system, are stored: system folder "`%windir%\fonts`", fonts from which are available for all users. However, starting from MS Windows 10 every user has its own local fonts storage: "`%userprofile%\AppData\Local\Microsoft\Windows\Fonts`" (along with common folder, which still exists, of course).

When we're saying "the WordProcessing document uses some font", this statement can be treated differently, because WordProcessing document can use fonts differently. From the "broad" point of view, every font, which is referenced in the WordProcessing somehow, applied to text content or is a part of some style, is used by the document. In counterpart, from "narrow" point of view, only those font, which is applied to some text content, is used by the document. For example, there can be a scenario when user created a WordProcessing  document, writes some text, creates some style named "*Style1*" with specific font "*Font1*", and applies this style "*Style1*" to the text. In this situation those specific "*Font1*" is used by the document from all point of views. However, after this, user edits the document, and removes all the textual content, which uses "*Style1*" style, but, what is important, the "*Style1*" is not removed from the document, — it still exists and holds a reference to the "*Font1*". In this situation, from narrow point of view, document don't use "*Font1*", because there is no any piece of text, which uses this font, even while "*Font1*" is still a part of "*Style1*" style, which is a part of a document.

## How to extract fonts

GroupDocs.Editor has an ability to extract fonts from WordProcessing document and represent them as resources in the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance; when this instance will be used for generating HTML markup, all font resources will be present and correctly linked to the HTML content. GroupDocs.Editor is able to extract embedded fonts from the WordProcessing document, as well as extract installed fonts from system. Prior version 20.3 it was possible to extract system fonts only from the system folder, common for all users. Now, starting from the version 20.3, GroupDocs.Editor for .NET supports fonts, installed into the user folder, too.

There are two public properties, responsible for working with fonts, all of them are located in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class:

```csharp
public FontExtractionOptions FontExtraction {get; set;}

public bool ExtractOnlyUsedFont { get; set; }
```

[FontExtractionOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/fontextractionoptions) is a public enum, located in the [com.groupdocs.editor.options](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/) namespace. By default, when an instance of the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions) class is created, this enum has a default value `NotExtract`, which means do not extract any fonts: neither from document nor from the system. Other values are the next:

* `ExtractAllEmbedded`. In this case the GroupDocs.Editor extracts all the fonts, embedded in the input WordProcessing document regardless of the fact, are some of them installed in the system or not. In other words, converter finds and extracts all 100% font resources, which are embedded into the input WordProcessing document, but it doesn't determine whether they are system or custom. Because of this fact the converter doesn't touch Windows Registry or system folders at all.
* `ExtractEmbeddedWithoutSystem`. Unlike the previous option, in this case GroupDocs.Editor not only simply extracts all embedded fonts, but also checks every font whether it is system or not. If some embedded font is system-installed, it will be ignored and will not be present in the font resources inside the [EditableDocument](https://reference.groupdocs.com/net/editor/groupdocs.editor/editabledocument). In order to detect, which font is system or not, the converter tries to obtain a list of all system fonts by using Windows Registry and system folders, and then compares this list with a set of embedded fonts. As a result, only subset of those embedded fonts, which were not found in system, will be returned.
* `ExtractAll`. When this option is selected, GroupDocs.Editor tries to extract absolutely all fonts, which are used in the input document, regardless of their nature: embedded or system. In order to do this, the GroupDocs.Editor is analyzing an input WordProcessing document and finds all fonts, which are used there (from "broad" point of view). If some of these used fonts are embedded in the document, GroupDocs.Editor extracts and uses them. If document contains no embedded fonts at all, or collection of embedded fonts is present, but doesn't cover all used fonts in the document, the GroupDocs.Editor tries to extract these font resources from system by using Windows Registry and system folders. This option is perfectly useful in case, when clients want to make sure, that the input document will have the perfect representation for every end-user regardless of what fonts are installed on the client machine or not.

Second property, a boolean flag named `ExtractOnlyUsedFont`, was added to the GroupDocs.Editor starting from the version 20.3. By default is has a '`false`' value, which means that all fonts, used in the WordProcessing document from the "broad" point of view, will be processed. This is the default behavior, the same, as GroupDocs.Editor did prior the version 20.3, when this option didn't exist. But when it is enabled by setting a '`true`' value, GroupDocs.Editor processes only those fonts, which are used in the WordProcessing document from the "narrow" point of view, i.e. only those fonts, which are applied to some textual content in the document.

These two public options work in conjunction. In particular:

* If `FontExtraction` enum has a `NotExtract`value, then the value of `ExtractOnlyUsedFont` property will be ignored.
* If `FontExtraction` enum has a `ExtractAllEmbedded` value,and `ExtractOnlyUsedFont` flag is set to '`true`', GroupDocs.Editor will not extract 100% of all embedded fonts, but only subset of those embedded, which are used in the WordProcessing document from the "narrow" point of view.
* If `FontExtraction` enum has a `ExtractEmbeddedWithoutSystem` value,and `ExtractOnlyUsedFont` flag is set to '`true`', GroupDocs.Editor returns a subset of the fonts, which are returned by this option, when `ExtractOnlyUsedFont` flag is set to '`false`' — will be returned only those fonts, which are simultaneously embedded in the WordProcessing document, not installed in the system, and used in the document from the "narrow" point of view.
* If `FontExtraction` enum has a `ExtractAll` value,and `ExtractOnlyUsedFont` flag is set to '`true`', GroupDocs.Editor first of all forms a list of fonts, which are used in the document from "narrow" point of view, and then only these fonts are returned from embedded or (if not found in embedded) from system-installed font storages.

---

## Font extraction options

Path: /editor/net/font-extraction-options/

## Introduction

WordProcessing documents contain usually text content, while every piece of text should be represented with some font. There may be used system fonts (installed in the operating system), but also custom fonts, which are not installed in the system. On the other hand, lots of WordProcessing formats like DOCX and ODT have an ability to store fonts inside the document itself; such fonts, stored as the binary resources inside WordProcessing files, are called *embedded*. Embedded fonts are the only choice for the end-user to use some specific fonts, which are not installed in the system. But any font can be embedded into the document. This means, that, for example, there can be a situation, when the same font is installed in the system, and at the same time embedded in the WordProcessing document.

In the MS Windows operating system before Windows 10 (and MS Windows Server 2016) there is only one location, where fonts, installed in the system, are stored: system folder "`%windir%\fonts`", fonts from which are available for all users. However, starting from MS Windows 10 every user has its own local fonts storage: "`%userprofile%\AppData\Local\Microsoft\Windows\Fonts`" (along with common folder, which still exists, of course).

When we're saying "the WordProcessing document uses some font", this statement can be treated differently, because WordProcessing document can use fonts differently. From the "broad" point of view, every font, which is referenced in the WordProcessing somehow, applied to text content or is a part of some style, is used by the document. In counterpart, from "narrow" point of view, only those font, which is applied to some text content, is used by the document. For example, there can be a scenario when user created a WordProcessing  document, writes some text, creates some style named "*Style1*" with specific font "*Font1*", and applies this style "*Style1*" to the text. In this situation those specific "*Font1*" is used by the document from all point of views. However, after this, user edits the document, and removes all the textual content, which uses "*Style1*" style, but, what is important, the "*Style1*" is not removed from the document, — it still exists and holds a reference to the "*Font1*". In this situation, from narrow point of view, document don't use "*Font1*", because there is no any piece of text, which uses this font, even while "*Font1*" is still a part of "*Style1*" style, which is a part of a document.

## How to extract fonts

GroupDocs.Editor has an ability to extract fonts from WordProcessing document and represent them as resources in the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance; when this instance will be used for generating HTML markup, all font resources will be present and correctly linked to the HTML content. GroupDocs.Editor is able to extract embedded fonts from the WordProcessing document, as well as extract installed fonts from system. Prior version 20.3 it was possible to extract system fonts only from the system folder, common for all users. Now, starting from the version 20.3, GroupDocs.Editor for .NET supports fonts, installed into the user folder, too.

There are two public properties, responsible for working with fonts, all of them are located in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class:

```csharp
public FontExtractionOptions FontExtraction {get; set;}

public bool ExtractOnlyUsedFont { get; set; }
```

[FontExtractionOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fontextractionoptions) is a public enum, located in the [GroupDocs.Editor.Options](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/) namespace. By default, when an instance of the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class is created, this enum has a default value `NotExtract`, which means do not extract any fonts: neither from document nor from the system. Other values are the next:

* `ExtractAllEmbedded`. In this case the GroupDocs.Editor extracts all the fonts, embedded in the input WordProcessing document regardless of the fact, are some of them installed in the system or not. In other words, converter finds and extracts all 100% font resources, which are embedded into the input WordProcessing document, but it doesn't determine whether they are system or custom. Because of this fact the converter doesn't touch Windows Registry or system folders at all.
* `ExtractEmbeddedWithoutSystem`. Unlike the previous option, in this case GroupDocs.Editor not only simply extracts all embedded fonts, but also checks every font whether it is system or not. If some embedded font is system-installed, it will be ignored and will not be present in the font resources inside the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument). In order to detect, which font is system or not, the converter tries to obtain a list of all system fonts by using Windows Registry and system folders, and then compares this list with a set of embedded fonts. As a result, only subset of those embedded fonts, which were not found in system, will be returned.
* `ExtractAll`. When this option is selected, GroupDocs.Editor tries to extract absolutely all fonts, which are used in the input document, regardless of their nature: embedded or system. In order to do this, the GroupDocs.Editor is analyzing an input WordProcessing document and finds all fonts, which are used there (from "broad" point of view). If some of these used fonts are embedded in the document, GroupDocs.Editor extracts and uses them. If document contains no embedded fonts at all, or collection of embedded fonts is present, but doesn't cover all used fonts in the document, the GroupDocs.Editor tries to extract these font resources from system by using Windows Registry and system folders. This option is perfectly useful in case, when clients want to make sure, that the input document will have the perfect representation for every end-user regardless of what fonts are installed on the client machine or not.

Second property, a boolean flag named `ExtractOnlyUsedFont`, was added to the GroupDocs.Editor starting from the version 20.3. By default is has a '`false`' value, which means that all fonts, used in the WordProcessing document from the "broad" point of view, will be processed. This is the default behavior, the same, as GroupDocs.Editor did prior the version 20.3, when this option didn't exist. But when it is enabled by setting a '`true`' value, GroupDocs.Editor processes only those fonts, which are used in the WordProcessing document from the "narrow" point of view, i.e. only those fonts, which are applied to some textual content in the document.

These two public options work in conjunction. In particular:

* If `FontExtraction` enum has a `NotExtract`value, then the value of `ExtractOnlyUsedFont` property will be ignored.
* If `FontExtraction` enum has a `ExtractAllEmbedded` value,and `ExtractOnlyUsedFont` flag is set to '`true`', GroupDocs.Editor will not extract 100% of all embedded fonts, but only subset of those embedded, which are used in the WordProcessing document from the "narrow" point of view.
* If `FontExtraction` enum has a `ExtractEmbeddedWithoutSystem` value,and `ExtractOnlyUsedFont` flag is set to '`true`', GroupDocs.Editor returns a subset of the fonts, which are returned by this option, when `ExtractOnlyUsedFont` flag is set to '`false`' — will be returned only those fonts, which are simultaneously embedded in the WordProcessing document, not installed in the system, and used in the document from the "narrow" point of view.
* If `FontExtraction` enum has a `ExtractAll` value,and `ExtractOnlyUsedFont` flag is set to '`true`', GroupDocs.Editor first of all forms a list of fonts, which are used in the document from "narrow" point of view, and then only these fonts are returned from embedded or (if not found in embedded) from system-installed font storages.

---

## Font extraction options

Path: /editor/nodejs-java/font-extraction-options/


## Introduction

WordProcessing documents, such as DOCX or ODT, typically contain text content formatted with various fonts. These fonts can either be system-installed (available on the operating system) or custom fonts embedded directly within the document. **GroupDocs.Editor** provides a way to extract fonts from WordProcessing documents, ensuring that any custom fonts used in the document are available during editing and viewing, even if they aren't installed on the system.

### Font Usage in WordProcessing Documents

When discussing font usage in WordProcessing documents, it can be approached from two perspectives:
- **Broad perspective**: All fonts referenced in the document, including those applied to styles or placeholders.
- **Narrow perspective**: Only fonts that are actively applied to visible text content.

For example, a document may reference a font through a style that is no longer applied to any text. In the narrow perspective, this font would not be considered "in use."

### Font Extraction in GroupDocs.Editor

**GroupDocs.Editor** can extract fonts embedded in WordProcessing documents and present them as resources in the `EditableDocument` instance. These extracted fonts can then be linked to the HTML content generated for editing in a WYSIWYG editor.

Font extraction can handle both embedded fonts and system-installed fonts. If a font is embedded in the document, it will be extracted; if it's not embedded, **GroupDocs.Editor** will attempt to locate the font in the system's font resources.

### Font Extraction Options

To control how fonts are extracted, the `WordProcessingEditOptions` class in **GroupDocs.Editor for Node.js** provides two main properties:

```javascript
const FontExtractionOptions = groupdocs.options.FontExtractionOptions;

let editOptions = new WordProcessingEditOptions();
editOptions.fontExtraction = FontExtractionOptions.ExtractAllEmbedded; // Example value
editOptions.extractOnlyUsedFonts = true;  // Example value
```

1. **fontExtraction**: This property controls how fonts are extracted. It accepts values from the `FontExtractionOptions` enum:
   - `NotExtract`: No fonts will be extracted from the document.
   - `ExtractAllEmbedded`: All embedded fonts will be extracted, regardless of whether they are system-installed.
   - `ExtractEmbeddedWithoutSystem`: Extract only custom embedded fonts that are not system-installed.
   - `ExtractAll`: Extract all fonts used in the document, whether embedded or system-installed.

2. **extractOnlyUsedFonts**: This boolean flag determines whether to extract only the fonts applied to visible text content (narrow perspective) or all fonts referenced in the document (broad perspective). 
   - `true`: Extract only fonts applied to text content.
   - `false`: Extract all referenced fonts, even if they are not applied to visible text.

### Example in Node.js

Here’s how to configure font extraction in **Node.js**:

```javascript
const groupdocs = require('groupdocs-editor');
const WordProcessingEditOptions = groupdocs.options.WordProcessingEditOptions;
const FontExtractionOptions = groupdocs.options.FontExtractionOptions;

let editOptions = new WordProcessingEditOptions();

// Extract all embedded fonts, ignoring system fonts
editOptions.fontExtraction = FontExtractionOptions.ExtractEmbeddedWithoutSystem;

// Extract only fonts actively used in the document
editOptions.extractOnlyUsedFonts = true;
```

### How Font Extraction Options Work Together

These two options, `fontExtraction` and `extractOnlyUsedFonts`, work in conjunction:

- If `fontExtraction` is set to `NotExtract`, the value of `extractOnlyUsedFonts` will be ignored.
- If `fontExtraction` is set to `ExtractAllEmbedded` and `extractOnlyUsedFonts` is `true`, only embedded fonts that are applied to visible text will be extracted.
- If `fontExtraction` is set to `ExtractAll`, and `extractOnlyUsedFonts` is `true`, only the fonts actively used in the document's content will be extracted, either from the embedded resources or system-installed fonts.

### Conclusion

The font extraction options in **GroupDocs.Editor** provide flexibility when editing Word documents. By choosing the appropriate extraction settings, you can ensure that the fonts used in the document are available for editing and viewing, even when the document is shared across different platforms or systems.

---

## Generate signatures preview

Path: /signature/python-net/generate-signatures-preview/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) class to specify different options to manage signature preview generation process.

Here are the steps to generate signature preview with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) object with:
* delegate for each signature stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/createpagestream));
* image preview format - PNG / JPG / BMP,
* signature numbers to process;
* custom size of preview images (if needed).
{{< alert style="info" >}}
Stream that were created by CreatePageStreamdelegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument ReleaseStream to clean up resources.  
{{< /alert >}}
* Call GeneratePreview method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) to it.

## CreatePageStream delegate implementation

GroupDocs.Signature expects CreatePageStreamdelegate to obtain each signature stream for image preview generation process

```python
def create_page_stream(page_data):
    image_name = f"signature-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    folder = os.path.dirname(image_file_path)
    if not os.path.exists(folder):
        os.makedirs(folder)
    return open(image_file_path, "wb")
```

## ReleasePageStream delegate implementation

```python
def release_page_stream(page_data, page_stream):
    page_stream.close()
    image_name = f"signature-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    print(f"Image file {image_file_path} is ready for preview")
```

## Generate signature preview from file on local disk

```python
import os
import groupdocs.signature as signature

def get_preview():
    with signature.Signature("sample.pdf") as sign:
        # create preview options object
        preview_option = signature.PreviewOptions(create_page_stream)
        preview_option.preview_format = signature.PreviewOptions.PreviewFormats.JPEG
        # generate preview
        sign.generate_preview(preview_option)

def create_page_stream(page_data):
    image_name = f"signature-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    folder = os.path.dirname(image_file_path)
    if not os.path.exists(folder):
        os.makedirs(folder)
    return open(image_file_path, "wb")
```

## Generate signature preview from stream with custom stream releasing delegate

```python
import os
import groupdocs.signature as signature

def get_preview():
    with open("sample.pdf", "rb") as stream:
        with signature.Signature(stream) as sign:
            # create preview options object
            preview_option = signature.PreviewOptions(create_page_stream, release_page_stream)
            preview_option.preview_format = signature.PreviewOptions.PreviewFormats.JPEG
            # generate preview
            sign.generate_preview(preview_option)

def create_page_stream(page_data):
    image_name = f"signature-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    folder = os.path.dirname(image_file_path)
    if not os.path.exists(folder):
        os.makedirs(folder)
    return open(image_file_path, "wb")

def release_page_stream(page_data, page_stream):
    page_stream.close()
    image_name = f"signature-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    print(f"Image file {image_file_path} is ready for preview")
```

## Creating a signature preview with custom Resolution

```python
import os
import groupdocs.signature as signature

# The path to the documents
file_path = "sample.pdf"
with signature.Signature(file_path) as sign:
    resolution = 96
    # create preview options object
    # You can reuse create_page_stream and release_page_stream methods from the previous example
    preview_option = signature.PreviewOptions(create_page_stream, release_page_stream, resolution)
    preview_option.preview_format = signature.PreviewOptions.PreviewFormats.JPEG
    # generate preview
    sign.generate_preview(preview_option)
```



## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python)



### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Get changes coordinates

Path: /comparison/java/get-changes-coordinates/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to detect changes between source and target documents and get changes coordinates at document preview images. These coordinates can be useful to highlight changes at the document preview images.

To get the changes coordinates, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object. Call the [setCalculateCoordinates](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setCalculateCoordinates-boolean-) to get coordinates.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object from the previous step.
5.  Call the [getChanges()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getChanges--) method.

The following code snippet shows how to compare multiple documents with specific options:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.result.ChangeInfo;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");

    CompareOptions compareOptions = new CompareOptions();
    compareOptions.setCalculateCoordinates(true);
    final Path resultPath = comparer.compare("result.docx", compareOptions);

    ChangeInfo[] changes = comparer.getChanges();
    for (ChangeInfo change : changes) {
        System.out.printf("Change Type: %d, X: %f, Y: %f, Text: %s%n",
            change.getType(), change.getBox().getX(), change.getBox().getY(), change.getText());
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/get-changes-coordinates.png)

---

## Get changes coordinates

Path: /comparison/net/get-changes-coordinates/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to detect changes between source and target documents and get changes coordinates at document preview images. These coordinates can be useful to highlight changes at the document preview images.

To get the changes coordinates, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object. Set the [CalculateCoordinates](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions/properties/calculatecoordinates) property to `true`.
4.  Set the [CalculateCoordinatesMode](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions/properties/calculatecoordinatesmode) to `CalculateCoordinatesModeEnumeration.Source` or `CalculateCoordinatesModeEnumeration.Target` if you want to get coordinates from source or target document.
5.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object from the previous step.
6.  Call the [GetChanges](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/getchanges/index) method.

The following code snippet shows how to compare multiple documents with specific options:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Result;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions compareOptions = new CompareOptions(){ CalculateCoordinates = true };
    comparer.Compare(compareOptions);
    ChangeInfo[] changes = comparer.GetChanges();
    foreach (ChangeInfo change in changes)
        Console.WriteLine("Change Type: {0}, X: {1}, Y: {2}, Text: {3}", 
            change.Type, 
            change.Box.X, 
            change.Box.Y, 
            change.Text);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/get-changes-coordinates.png)

---

## Get changes coordinates

Path: /comparison/nodejs-java/get-changes-coordinates/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to detect changes between the source and target documents and get coordinates of the changes in the document preview images. These coordinates can be useful to highlight changes in the document preview images.

The following code snippet shows how to compare documents and obtain coordinates for each detected change:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for the source, target, and result documents
const sourceFile = 'sample-files/source.docx';
const targetFile = 'sample-files/target.docx';
const resultFile = 'result.docx';

// Create a comparer instance for the source document
const comparer = new groupdocs.Comparer(sourceFile);

// Add the target document to the comparer
comparer.add(targetFile);

// Initialize comparison options
const compareOptions = new groupdocs.CompareOptions();
compareOptions.setCalculateCoordinates(true);

// Execute the comparison and save the result to the specified file
comparer.compare(resultFile, compareOptions);

// Retrieve the list of detected changes
const changes = comparer.getChanges();

// Iterate through each change and output its details
for (let i = 0; i < changes.length; i++) {
    const change = changes[i];
    console.log(`Change Type: ${change.getType()}, X: ${change.getBox().getX()}, Y: ${change.getBox().getY()}, Text: ${change.getText()}`);
}

// Exit the process
process.exit(0);
```

This example creates a `Comparer` instance, adds the target document, and configures comparison options to calculate coordinates by setting `setCalculateCoordinates(true)`. After performing the comparison, it retrieves all detected changes using `getChanges()` and iterates through them to extract and display coordinate information (X, Y positions) from each change's `Box` object, along with the change type and text content.

The result is as follows:

![](/comparison/nodejs-java/images/get-changes-coordinates.png)

---

## Get changes coordinates

Path: /comparison/python-net/get-changes-coordinates/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) can compute coordinates for each detected change, allowing you to overlay highlights on preview images.

## Get coordinates for detected changes

Enable coordinate calculation and inspect the `Box` values from each change.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.calculate_coordinates = True
    comparer.compare(options)
    changes = comparer.get_changes()
    for change in changes:
        print(f"Type: {change.type}, X: {change.box.x}, Y: {change.box.y}, Text: {change.text}")
```

🔹 Use case: Draw bounding boxes over preview images to visualize change locations.

The result is as follows:

![](/comparison/python-net/images/get-changes-coordinates.png)



---

## Get supported file formats

Path: /search/java/get-supported-file-formats/

The [getSupportedFileTypes](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FileType#getSupportedFileTypes()) method of the [FileType](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FileType) class is used to obtain a list of supported file types.

An example of obtaining a list of supported file types is presented below.



```java
Iterable<FileType> supportedFileTypes = FileType.getSupportedFileTypes();
Iterator iterator = supportedFileTypes.iterator();      
while (iterator.hasNext()) {
    FileType fileType = (FileType)iterator.next();
    System.out.println(fileType.getExtension() + " - " + fileType.getDescription());
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Get supported file formats

Path: /search/net/get-supported-file-formats/

The [GetSupportedFileTypes](https://reference.groupdocs.com/net/search/groupdocs.search.results/filetype/methods/getsupportedfiletypes) method of the [FileType](https://reference.groupdocs.com/net/search/groupdocs.search.results/filetype) class is used to obtain a list of supported file types.

An example of obtaining a list of supported file types is presented below.

**C#**

```csharp
IEnumerable<FileType> supportedFileTypes = FileType
    .GetSupportedFileTypes()
    .OrderBy(ft => ft.Extension);
 
foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType.Extension.PadRight(8) + " - " + fileType.Description);
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Get supported file formats

Path: /search/nodejs-java/get-supported-file-formats/

The [getSupportedFileTypes](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FileType#getSupportedFileTypes()) method of the [FileType](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FileType) class is used to obtain a list of supported file types.

An example of obtaining a list of supported file types is presented below.

```javascript
const supportedFileTypes = java.callStaticMethodSync(
  'com.groupdocs.search.results.FileType',
  'getSupportedFileTypes',
);
const iterator = supportedFileTypes.iterator();
while (iterator.hasNext()) {
  const fileType = iterator.next();
  console.log(fileType.getExtension() + ' - ' + fileType.getDescription());
}
```

## More resources

### Advanced usage topics

To learn more about search features and get familiar how to enhance your search solution, please refer to the [advanced usage section]({{< ref "search/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Get taxonomies

Path: /classification/net/get-taxonomies/

### Log taxonomy classes

The list of taxanomy classes can be get like the following code snippet: 

```csharp
Console.WriteLine(String.Join(" ", TaxonomyClasses.Iab2Classes));
Console.WriteLine(String.Join(" ", TaxonomyClasses.DocumentsClasses));
Console.WriteLine(String.Join(" ", TaxonomyClasses.SentimentClasses));
Console.WriteLine(String.Join(" ", TaxonomyClasses.Sentiment3Classes));
```

---

## Get the width and height of the document pages

Path: /viewer/java/how-to-get-page-width-and-height/


You can get the width and height of each document page using the [getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method that returns a [ViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/) object. Use the [getPages](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/#getPages--) method to access the collection that contains each [Page](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/page/) of the document.


The following code snippet shows how to get the width and height of each document page:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ViewInfo;
// ...

try (Viewer viewer = new Viewer("sample.pdf")) {
    // Get file information.
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
    ViewInfo viewInfo = viewer.getViewInfo(viewInfoOptions);

    // Display width and height of each page.
    for (Page page : viewInfo.getPages()) {
        System.out.println("Page: " + page.getNumber() + "; Width: " + page.getWidth() + ", pixels");
        System.out.println("Page: " + page.getNumber() + "; Height: " + page.getHeight() + ", pixels");
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/java/images/how-to-get-page-width-and-height.png)
---

## Get the width and height of the document pages

Path: /viewer/net/how-to-get-page-width-and-height/


You can get the width and height of each document page using the [GetViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/getviewinfo) method that returns a [ViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo) object. The object contains the [Pages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/pages/) collection that represents each [Page](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/page/) of the document.

The following code snippet shows how to get the width and height of each document page:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("sample.pdf"))
{
    // Get file information.
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForHtmlView();
    ViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions);

    // Display width and height of each page.
    foreach (Page page in viewInfo.Pages)
    {
        Console.WriteLine($"Page: {page.Number}; Width: {page.Width}, pixels");
        Console.WriteLine($"Page: {page.Number}; Height: {page.Height}, pixels");
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.pdf")
            ' Get file information.
            Dim viewInfoOptions As ViewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo As ViewInfo = viewer.GetViewInfo(viewInfoOptions)
        
            ' Display width and height of each page.
            For Each page As Page In viewInfo.Pages
                Console.WriteLine($"Page: {page.Number}; Width: {page.Width}, pixels")
                Console.WriteLine($"Page: {page.Number}; Height: {page.Height}, pixels")
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-get-page-width-and-height.png)
---

## Handle loading of external resources documents

Path: /parser/java/handle-loading-of-external-resources/

GroupDocs.Parser provides the functionality to handle loading of HTML external resources.

Here are the steps to handle loading of HTML external resources.

*   Instantiate the [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/parsersettings/) object and pass External Resource Handler;
*   Create [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/) object and call [GetImages](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/parser/#getImages--) method.

The following code sample shows how to handle loading of HTML external resources.

```java
// Create an instance of ParserSettings to pass External Resource Handler
ParserSettings settings = new ParserSettings(new Handler());
// Create an instance of Parser class to generate spreadsheet page previews
try (Parser parser = new Parser(Constants.SampleHtmlWithImages, settings)) {
    // Extract images from HTML document
    Iterable<PageImageArea> images = parser.getImages();
    // Iterate over extracted images
    for (PageImageArea i : images) {
        // Print the type of image
        System.out.println(i.getFileType());
    }
}

/**
 * This class provides the ability to filter extracted images.
 **/
class Handler extends ExternalResourceHandler {
    // Called before any external resource loads. It allows to skip unnecessary file loading.
    @Override
    public void onLoading(ExternalResourceLoadingArgs args) {
        // Check if the file name ends with installation.png
        if (!args.getUri().endsWith("installation.png")) {
            // Otherwise skip this file
            args.setSkipped(true);
        }

        super.onLoading(args);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Handling MPEG audio metadata

Path: /metadata/java/handling-mpeg-audio-metadata/

## Reading MPEG audio metadata

  
MP3 (formally MPEG-1 Audio Layer III or MPEG-2 Audio Layer III) is a coding format for digital audio. Originally defined as the third audio format of the MPEG-1 standard, it was retained and further extended — defining additional bitrates and support for more audio channels — as the third audio format of the subsequent MPEG-2 standard. The GroupDocs.Metadata API allows reading some common MPEG audio properties from MP3 files.

{{< alert style="info" >}}
For more information on the MP3 and MPEG standards please check the following articles:
* [https://en.wikipedia.org/wiki/MP3](https://en.wikipedia.org/wiki/MP3)
* [https://en.wikipedia.org/wiki/Moving\_Picture\_Experts\_Group](https://en.wikipedia.org/wiki/Moving_Picture_Experts_Group)
{{< /alert >}}

  

The following steps demonstrate how to read MPEG audio metadata from an MP3 file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Get the root metadata package
3.  Use the [MP3RootPackage.getMpegAudioPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MP3RootPackage#getMpegAudioPackage())method to read the metadata values

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>audio.mp3.MP3ReadMpegAudioMetadata**

```csharp
try (Metadata metadata = new Metadata(Constants.MP3WithID3V2)) {
	MP3RootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getMpegAudioPackage().getBitrate());
	System.out.println(root.getMpegAudioPackage().getChannelMode());
	System.out.println(root.getMpegAudioPackage().getEmphasis());
	System.out.println(root.getMpegAudioPackage().getFrequency());
	System.out.println(root.getMpegAudioPackage().getHeaderPosition());
	System.out.println(root.getMpegAudioPackage().getLayer());

	// ...
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Handling MPEG audio metadata

Path: /metadata/net/handling-mpeg-audio-metadata/

## Reading MPEG audio metadata

  
MP3 (formally MPEG-1 Audio Layer III or MPEG-2 Audio Layer III) is a coding format for digital audio. Originally defined as the third audio format of the MPEG-1 standard, it was retained and further extended — defining additional bitrates and support for more audio channels — as the third audio format of the subsequent MPEG-2 standard. The GroupDocs.Metadata API allows reading some common MPEG audio properties from MP3 files.

{{< alert style="info" >}}
For more information on the MP3 and MPEG standards please check the following articles:
* [https://en.wikipedia.org/wiki/MP3](https://en.wikipedia.org/wiki/MP3)
* [https://en.wikipedia.org/wiki/Moving\_Picture\_Experts\_Group](https://en.wikipedia.org/wiki/Moving_Picture_Experts_Group)
{{< /alert >}}

  

The following steps demonstrate how to read MPEG audio metadata from an MP3 file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an MP3 file
2.  Get the root metadata package
3.  Use the [MP3RootPackage.MpegAudioPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.audio/mp3rootpackage/properties/mpegaudiopackage)property to read the metadata values

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Audio.MP3.MP3ReadMpegAudioMetadata**

```csharp
using (Metadata metadata = new Metadata(Constants.MP3WithID3V2))
{
	var root = metadata.GetRootPackage<MP3RootPackage>();

	Console.WriteLine(root.MpegAudioPackage.Bitrate);
	Console.WriteLine(root.MpegAudioPackage.ChannelMode);
	Console.WriteLine(root.MpegAudioPackage.Emphasis);
	Console.WriteLine(root.MpegAudioPackage.Frequency);
	Console.WriteLine(root.MpegAudioPackage.HeaderPosition);
	Console.WriteLine(root.MpegAudioPackage.Layer);

	// ...
} 
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Heading level offset

Path: /markdown/net/heading-offset/


Use `HeadingLevelOffset` to shift all heading levels in the output by a fixed number. This is useful when embedding converted content inside a larger document where top-level headings are already in use.

### Example

{{< tabs "heading-offset-example">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions { HeadingLevelOffset = 2 };
MarkdownConverter.ToFile("annual-report.docx", "heading-offset-example.md", options);

// Source: # Title     → Output: ### Title
// Source: ## Section  → Output: #### Section
// Heading levels are clamped to the range 1-6.
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "heading-offset-example.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/heading-offset/HeadingOffsetExample/heading-offset-example.md)
{{< /tab >}}
{{< /tabs >}}

---

## Heading level offset

Path: /markdown/python-net/heading-offset/


Use `heading_level_offset` to shift all heading levels in the output by a fixed number. This is useful when embedding converted content inside a larger document where top-level headings are already in use.

### Example

{{< tabs "heading-offset-example">}}
{{< tab "heading_offset_example.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def heading_offset_example():
    """Shift all heading levels by a fixed offset when converting to Markdown."""

    # Step 1: Set the heading level offset to 2
    options = ConvertOptions()
    options.heading_level_offset = 2  # shift all headings down two levels

    # Step 2: Convert the document using keyword argument for options
    md = MarkdownConverter.to_markdown("annual-report.docx", convert_options=options)

    # Source: # Title     -> Output: ### Title
    # Source: ## Section  -> Output: #### Section
    # Heading levels are clamped to the range 1-6.

if __name__ == "__main__":
    heading_offset_example()
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Homophone dictionary

Path: /search/java/homophone-dictionary/

The [HomophoneDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/HomophoneDictionary) class is designed to store homophones in an index. For information on searching using homophones, see the [Homophone search]({{< ref "search/java/developer-guide/advanced-usage/searching/homophone-search.md" >}}) page.

To get the number of homophones in the dictionary, use the [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/HomophoneDictionary#getCount()) method.

To add groups of homophones to the dictionary, use the [addRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/HomophoneDictionary#addRange(java.lang.Iterable)) method.

The [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/HomophoneDictionary#clear()) method is used to remove all homophones from the dictionary.

The [getHomophones](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/HomophoneDictionary#getHomophones(java.lang.String)) method is used to get a list of synonyms for a given word.

The [getHomophoneGroups](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/HomophoneDictionary#getHomophoneGroups(java.lang.String)) method is used to get all synonym groups to which a given word belongs.

To get all synonym groups from the dictionary, use the [getAllHomophoneGroups](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/HomophoneDictionary#getAllHomophoneGroups()) method.

To export homophones to a file, use the [exportDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import homophones from a file, use the [importDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the homophone dictionary.



```java
String indexFolder = "c:\\MyIndex\\";

// Creating an index from in specified folder
Index index = new Index(indexFolder);

// Creating an index in memory with default homophone dictionary
Index index = new Index();

// Getting homophones for word 'braid'
String[] homophones = index.getDictionaries().getHomophoneDictionary().getHomophones("braid");
System.out.println("Homophones for 'braid':");
for (String homophone : homophones) {
    System.out.println(homophone);
}

// Getting groups of homophones to which word 'braid' belongs to
String[][] groups = index.getDictionaries().getHomophoneDictionary().getHomophoneGroups("braid");
System.out.println("Homophone groups for 'braid':");
for (String[] group : groups) {
    for (String group1 : group) {
        System.out.print(group1 + " ");
    }
    System.out.println();
}

if (index.getDictionaries().getHomophoneDictionary().getCount() > 0) {
    // Removing all homophones from the dictionary
    index.getDictionaries().getHomophoneDictionary().clear();
}

// Adding homophones to the dictionary
String[][] homophoneGroups = new String[][] {
    new String[] { "awe", "oar", "or", "ore" },
    new String[] { "aye", "eye", "i" },
};
index.getDictionaries().getHomophoneDictionary().addRange(homophoneGroups);

// Export homophones to a file
index.getDictionaries().getHomophoneDictionary().exportDictionary("C:\\Homophones.dat");

// Import homophones from a file
index.getDictionaries().getHomophoneDictionary().importDictionary("C:\\Homophones.dat");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Homophone dictionary

Path: /search/net/homophone-dictionary/

The [HomophoneDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/homophonedictionary) class is designed to store homophones in an index. For information on searching using homophones, see the [Homophone search]({{< ref "search/net/developer-guide/advanced-usage/searching/homophone-search.md" >}}) page.

To get the number of homophones in the dictionary, use the [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/homophonedictionary/properties/count) property.

To add groups of homophones to the dictionary, use the [AddRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/homophonedictionary/methods/addrange/index) method.

The [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/homophonedictionary/methods/clear) method is used to remove all homophones from the dictionary.

The [GetHomophones](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/homophonedictionary/methods/gethomophones) method is used to get a list of synonyms for a given word.

The [GetHomophoneGroups](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/homophonedictionary/methods/gethomophonegroups) method is used to get all synonym groups to which a given word belongs.

To get all synonym groups from the dictionary, use the [GetAllHomophoneGroups](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/homophonedictionary/methods/getallhomophonegroups) method.

To export homophones to a file, use the [ExportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/exportdictionary) method.

To import homophones from a file, use the [ImportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/importdictionary) method.

The following example demonstrates the use of methods of the homophone dictionary.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";

// Creating an index from in specified folder
Index index = new Index(indexFolder);

// Getting homophones for word 'braid'
string[] homophones = index.Dictionaries.HomophoneDictionary.GetHomophones("braid");
Console.WriteLine("Homophones for 'braid':");
for (int i = 0; i < homophones.Length; i++)
{
    Console.WriteLine(homophones[i]);
}

// Getting groups of homophones to which word 'braid' belongs to
string[][] groups = index.Dictionaries.HomophoneDictionary.GetHomophoneGroups("braid");
Console.WriteLine("Homophone groups for 'braid':");
for (int i = 0; i < groups.Length; i++)
{
    string[] group = groups[i];
    for (int j = 0; j < group.Length; j++)
    {
        Console.Write(group[j] + " ");
    }
    Console.WriteLine();
}

if (index.Dictionaries.HomophoneDictionary.Count > 0)
{
    // Removing all homophones from the dictionary
    index.Dictionaries.HomophoneDictionary.Clear();
}

// Adding homophones to the dictionary
string[][] homophoneGroups = new string[][]
{
    new string[] { "awe", "oar", "or", "ore" },
    new string[] { "aye", "eye", "i" },
};
index.Dictionaries.HomophoneDictionary.AddRange(homophoneGroups);

// Export homophones to a file
index.Dictionaries.HomophoneDictionary.ExportDictionary(@"C:\Homophones.dat");

// Import homophones from a file
index.Dictionaries.HomophoneDictionary.ImportDictionary(@"C:\Homophones.dat");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Homophone dictionary

Path: /search/nodejs-java/homophone-dictionary/

The [HomophoneDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/HomophoneDictionary) class is designed to store homophones in an index. For information on searching using homophones, see the [Homophone search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/homophone-search.md" >}}) page.

To get the number of homophones in the dictionary, use the [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/HomophoneDictionary#getCount()) method.

To add groups of homophones to the dictionary, use the [addRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/HomophoneDictionary#addRange(java.lang.Iterable)) method.

The [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/HomophoneDictionary#clear()) method is used to remove all homophones from the dictionary.

The [getHomophones](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/HomophoneDictionary#getHomophones(java.lang.String)) method is used to get a list of synonyms for a given word.

The [getHomophoneGroups](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/HomophoneDictionary#getHomophoneGroups(java.lang.String)) method is used to get all synonym groups to which a given word belongs.

To get all synonym groups from the dictionary, use the [getAllHomophoneGroups](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/HomophoneDictionary#getAllHomophoneGroups()) method.

To export homophones to a file, use the [exportDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import homophones from a file, use the [importDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the homophone dictionary.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index from in specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Getting homophones for word 'braid'
const homophones = index.getDictionaries().getHomophoneDictionary().getHomophones('braid');
console.log("Homophones for 'braid':");
for (const homophone of homophones) {
  console.log(homophone);
}

// Getting groups of homophones to which word 'braid' belongs to
const groups = index.getDictionaries().getHomophoneDictionary().getHomophoneGroups('braid');
console.log("Homophone groups for 'braid':");
for (const group of groups) {
  for (const group1 of group) {
    console.log(group1 + ' ');
  }
  console.log();
}

if (index.getDictionaries().getHomophoneDictionary().getCount() > 0) {
  // Removing all homophones from the dictionary
  index.getDictionaries().getHomophoneDictionary().clear();
}

// Adding homophones to the dictionary
const homophoneGroups = java.newInstanceSync('java.util.ArrayList');
homophoneGroups.add(java.newArray('java.lang.String', ['awe', 'oar', 'or', 'ore']));
homophoneGroups.add(java.newArray('java.lang.String', ['aye', 'eye', 'i']));
homophoneGroups.add(java.newArray('java.lang.String', ['call', 'caul']));
index.getDictionaries().getHomophoneDictionary().addRange(homophoneGroups);

// Export homophones to a file
const fileName = Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/homophoneDictionary/Homophones.dat';
index.getDictionaries().getHomophoneDictionary().exportDictionary(fileName);

// Import homophones from a file
index.getDictionaries().getHomophoneDictionary().importDictionary(fileName);

// Search in the index
const query = 'caul';
const options = new groupdocs.search.SearchOptions();
options.setUseHomophoneSearch(true);
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## How To Install Windows Fonts on Ubuntu

Path: /viewer/java/how-to-install-windows-fonts-on-ubuntu/

This article will guide you through the installation process of the Windows fonts on Ubuntu operating system. We'll be installing packages with [apt-get](https://wiki.debian.org/apt-get) utility on the latest (at the moment of writing this article) available version of OS that is [Ubuntu 22.04 LTS](https://wiki.ubuntu.com/Releases) but the process is quite the same for the previous versions of Ubuntu.

## What fonts are installed

Let's find out what fonts are currently installed by typing `fc-list` in your terminal.
In case the utility is not installed you can install it with `fontconfig` by typing

1. `sudo apt-get update` - Pull the lates updates.
2. `sudo apt-get install fontconfig` - Install `fontconfig` and font utilities including `fc-list`.

After you already have this utility installed type `fc-list` and check the output.
I'm running Ubuntu in a docker container and here is the output:

{{< tabs "example1">}}
{{< tab "Shell" >}}
```bash
$ fc-list

/usr/share/fonts/truetype/dejavu/DejaVuSerif-Bold.ttf: DejaVu Serif:style=Bold
/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf: DejaVu Sans Mono:style=Book
/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf: DejaVu Sans:style=Book

(truncated)
```
{{< /tab >}}
{{< /tabs >}}

## Install Windows fonts

To install Windows fonts using `apt-get` utility open terminal and type:

1. `sudo apt-get update` - Pull the lates updates.
2. `sudo apt-get install ttf-mscorefonts-installer` - Install Windows fonts.
3. `sudo apt-get install fontconfig` - Install `fontconfig` library and `fc-cache` utility.
4. `sudo fc-cache -f -v` - Build fonts cache.

In case you recieve the following error:

```log
Package ttf-mscorefonts-installer is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or is only available from another source

E: Package 'ttf-mscorefonts-installer' has no installation candidate
```

you can to add it from [Linux Software Repository for Microsoft Products](https://learn.microsoft.com/linux/packages) repository:

1. `sudo wget -q https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb`
2. `sudo dpkg -i packages-microsoft-prod.deb`
3. `sudo apt-get update`
4. `sudo apt-get install ttf-mscorefonts-installer -y`
5. `sudo apt-get install fontconfig` - Install `fontconfig` library and `fc-cache` utility.
6. `sudo fc-cache -f -v` - Build fonts cache.

Please note to replace version number of your OS from `22.04` to the one you have. To get OS version type `hostnamectl | grep "Operating System"`. You can also check for the [index](https://packages.microsoft.com/config/) in your browser to find the right file. 

After installing fonts and building fonts cache we can check what fonts are actually installed by typing `fc-list`.

{{< tabs "example2">}}
{{< tab "Shell" >}}
```bash
$ fc-list | grep "msttcorefonts"

/usr/share/fonts/truetype/msttcorefonts/comicbd.ttf: Comic Sans MS:style=Bold,Negreta,tučné,fed,Fett,Έντονα,Negrita,Lihavoitu,Gras,Félkövér,Grassetto,Vet,Halvfet,Pogrubiony,Negrito,Полужирный,Fet,Kalın,Krepko,Lodia
/usr/share/fonts/truetype/msttcorefonts/comic.ttf: Comic Sans MS:style=Regular,Normal,obyčejné,Standard,Κανονικά,Normaali,Normál,Normale,Standaard,Normalny,Обычный,Normálne,Navadno,Arrunta
/usr/share/fonts/truetype/msttcorefonts/Times_New_Roman.ttf: Times New Roman:style=Regular,Normal,obyčejné,Standard,Κανονικά,Normaali,Normál,Normale,Standaard,Normalny,Обычный,Normálne,Navadno,thường,Arrunta

(truncated)
```
{{< /tab >}}
{{< /tabs >}}

In the output you'll find that `Comic Sans MS`, `Times New Roman`, and other Windows fonts are installed now.

---

## How to merge TIF images using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-tif-images-using-csharp/


## TIF Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple TIF documents in the preferred order and save them as a single file.

### About TIF File Format

TIF (or TIFF) is an image format used for containing high quality graphics. It stands for “Tagged Image File Format” or “Tagged Image Format”. The format was created by Aldus Corporation, but Adobe acquired the format later and made subsequent update in this format. TIF file is capable of holding both lossy JPEG compression and lossless image data. It can also contain vector based graphics data. TIF file format is widely supported in image editing applications. For that it’s a very popular image format among Graphic artists, Photographers, and Publishing authorities. PaintShop Pro is one of the most popular applications available for handling TIF images.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

## How to merge TIF files
The following example demonstrates how to merge TIF files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source TIF file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TIF file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other TIF documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged TIF file as parameter.

```csharp
// Load the source TIF file
using (Merger merger = new Merger(@"c:\sample1.tif"))
{
    // Add another TIF file to merge
    merger.Join(@"c:\sample2.tif");
    // Merge TIF files and save result
    merger.Save(@"c:\merged.tif");
}
```

NOTE: You may merge other TIF formats like TIFF in the same way as shown above. For this provide files by specifying their names with extension.

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TIF Live Demo

GroupDocs.Merger for .NET provides an online [**TIF Merger App**](https://products.groupdocs.app/merger/tif), which allows you to try it for free and check its quality and accuracy.

---

## How to merge TIF images using java

Path: /merger/java/getting-started/use-cases/how-to-merge-tif-images-using-java/


## TIF Merger Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple TIF documents in the preferred order and save them as a single file.

### About TIF File Format

TIF (or TIFF) is an image format used for containing high quality graphics. It stands for “Tagged Image File Format” or “Tagged Image Format”. The format was created by Aldus Corporation but Adobe acquired the format later and made subsequent update in this format. TIF file is capable of holding both lossy jpeg compression and lossless image data. It can also contain vector based graphics data. TIF file format is widely supported in image editing applications. For that it’s a very popular image format among Graphic artists, Photographers, and Publishing authorities. PaintShop Pro is one of the most popular applications available for handling TIF images.

### Download and Configure

You can follow the steps below to reference GroupDocs.Merger for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/merger/java):

1. Unpack zip archive .
2. Switch to **lib** folder.
3. Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4. After this you should add the merger **dependency** block to your *pom.xm*l project file.

## How to merge TIF files
The following example demonstrates how to merge TIF files with several lines of java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source TIF file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TIF file to merge with [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) method. Repeat this step for other TIF documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [Save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged TIF file as parameter.

```java
// Load the source TIF file
Merger merger = new Merger("c:\sample1.tif")

// Add another TIF file to merge
merger.join("c:\sample2.tif");
// Merge TIF files and save result
merger.save("c:\merged.tif");

```

NOTE: You may merge other TIF formats like TIFF in the same way as shown above. For this provide files by specifying their names with extension.

### Code Examples

Please find more [use-cases and complete java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TIF Live Demo

GroupDocs.Merger for Java provides an online [**TIF Merger App**](https://products.groupdocs.app/merger/tif), which allows you to try it for free and check its quality and accuracy.

---

## How to Run

Path: /metadata/java/how-to-run-examples/

## Download from GitHub

The complete examples package of **GroupDocs.Metadata** is hosted on [Github](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java). You can either download the ZIP file from [here](https://codeload.github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java/zip/master) or clone the repository of Github using your favourite Github client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like the following image:

![](/metadata/java/images/how-to-run.png)

Open IntelliJ Idea and import the project to get started with it. Archived project file can also be imported.Follow the given steps to run the application:

*   Click file from toolbar
*   Open project structure using  (CTRL + SHIFT + ALT + S on Windows/Linux, ? + ; on Mac OS X)
*   Select Modules at the left panel
*   Open Dependencies tab
*   Click '+' and click JARs or directories

![](/metadata/java/images/how-to-run_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## In-Paragraph List in Text Document

Path: /assembly/java/in-paragraph-list-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate In-ParagraphList report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## In-Paragraph List in Text Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   A descriptive or informative line like "We provide support for the following clients:".
*   Show all the clients along with the above sentence.
*   Report must be generated in the Text Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients: <<foreach [in getClients()]>><<[indexOf() != 0 ? ", " : ""]>><<[getName()]>><</foreach>>
```

### Download In-Paragraph List Template

Please download the sample Common List document we created in this article:

*   [In-Paragraph List.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Text%20Templates/In-Paragraph%20List.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists 8e24e27b32ab5037fd289eb89343b9c9 >}}



---

## In-Paragraph List in Text Document

Path: /assembly/net/in-paragraph-list-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Paragraph List report in Text Document format.{{< /alert >}}

## In-Paragraph List in Text Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to describe about the services you are providing with the following key requirements:

*   A descriptive or informative line like "We provide support for the following products:".
*   Show all the products along with the above sentence.
*   Report must be generated in the text Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[IndexOf() != 0 ? ", " : ""]>>
<<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Paragraph List Template

Please download the sample Common List document we created in this article:

*   [In-Paragraph List.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Text%20Templates/In-Paragraph%20List.txt?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< gist rida-fatima-aspose 40e7c4bc866aaea56a060a956e99a6d1 >}}

---

## In-Table List in Email Document

Path: /assembly/java/in-table-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List report in Email Document format.{{< /alert >}}

## In-Table List in Email Document

### Reporting Requirement

As a report developer, you are required to represent the information of the managers with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show managers' name.
*   It must show the sum of contract prices against each manager.
*   It must sum up all the contract prices for all the managers.
*   All the representation must be in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Manager</b></td>
			<td style="background-color: #5B9BD5"><b>Contract Price</b></td>
		</tr>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;foreach [in getManagers()]>>&lt;&lt;[getName()]>></b></td>
			<td style="background-color: #D2DEEF"><b>&lt;&lt;[getContracts().sum(c => c.getPrice())]>>&lt;&lt;foreach>></b></td>
		</tr>
    <tr>
			<td style="background-color: #5B9BD5"><b>Total:</b></td>
			<td style="background-color: #D2DEEF"><b>&lt;&lt;[getManagers().sum(m => m.getContracts().sum(c => c.getPrice()))]>></b></td>
		</tr>
	</tbody>
</table>

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs 0d625560bae96e7e79e4cd275484bc5a >}}



---

## In-Table List in Email Document

Path: /assembly/net/in-table-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List report in Email Document format.{{< /alert >}}

## In-Table List in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent the information of the managers with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show customers' name.
*   It must show the sum of orders prices against each customer.
*   It must sum up all the order prices for all the customers.
*   All the representation must be in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in customers]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">m =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">m.Order.Sum</span><span style="font-family: Calibri; font-size: 11pt;">(</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">))]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List Template

Please download the sample In-Table List document we created in this article:

*   [In-Table List.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/In-Table%20List.msg?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist rida-fatima-aspose c09729872df66086097e22d19daab13e >}}



---

## In-Table List With Alternate Content in Email Document

Path: /assembly/java/in-table-list-with-alternate-content-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List With Alternate Content report in Email Document format.{{< /alert >}}

## In-Table List With Alternate Content in Email Document

### Creating a In-Table List With Alternate Content

Practicing the following steps you can create In-Table List With Alternate Content Template in MS Outlook 2013.

1.  Add a new email.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2X3 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent your clients and their prices with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show each client along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Client</b></td>
			<td style="background-color: #5B9BD5"><b>Contract Price</b></td>
		</tr>
    <tr>
      <td colspan="2" style="background-color: #5B9BD5"><b>&lt;&lt;if [!getContracts().any()]>>No data</td>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;else>>&lt;&lt;foreach [in getContracts()]>>&lt;&lt;[getClient().getName()]>></b></td>
			<td style="background-color: #D2DEEF"><b>&lt;&lt;[getPrice()]>>&lt;&lt;/foreach>></b></td>
		</tr>
    <tr>
			<td style="background-color: #5B9BD5"><b>Total:</b></td>
			<td style="background-color: #D2DEEF"><b>&lt;&lt;[getContracts().sum(c => c.getPrice())]>>&lt;&lt;/if>></b></td>
		</tr>
	</tbody>
</table>

### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we created in this article:

*   [In-Table List With Alternate Content.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs 34eef2196b70162362cba82f22222a6f >}}



---

## In-Table List With Alternate Content in Email Document

Path: /assembly/net/in-table-list-with-alternate-content-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List With Alternate Content report in Email Document format.{{< /alert >}}

## In-Table List With Alternate Content in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater{{< /alert >}}

### Creating a In-Table List With Alternate Content

Practicing the following steps you can create In-Table List With Alternate Content Template in MS Outlook 2013.

1.  Add a new email.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2X3 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent your clients and their prices with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show each product along with its price.
*   It must show sum of all the prices.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Products</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td colspan="2" style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 445.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!Any()]&gt;&gt;No data</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Product.ProductName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table>

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: Working with GroupDocs.Assembly Engine{{< /alert >}}

### Download In-Table List With Alternate Content Template

Please download the sample In-Table List With Alternate Content document we used in this article:

*   [In-Table List With Alternate Content.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/In-Table%20List%20with%20Alternate%20Content.msg?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist rida-fatima-aspose 331d0c832f858e3ddb556c3118f48bdd >}}



---

## In-Table List with Filtering Grouping and Ordering in Email Document

Path: /assembly/java/in-table-list-with-filtering-grouping-and-ordering-in-email-document/

# In-Table List with Filtering, Grouping, and Ordering in Email Document

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List with Filtering, Grouping, and Ordering report in Email Document format.{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Email Document

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practicing the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS Outlook 2013.

1.  Create a new Email.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x2 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent managers' contract information with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show each manager along with sum of prices of his contracts.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Manager</b></td>
			<td style="background-color: #5B9BD5"><b>Contract Price</b></td>
		</tr>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;foreach [in getContracts()<br>   .where(c => c.getDate().getYear() + 1900 == 2015)<br>   .groupBy(c => c.getManager())<br>   .orderBy(g => g.key.getName())]>>&lt;&lt;[key.getName()]>></b></td>
			<td style="background-color: #D2DEEF">&lt;&lt;[sum(c => c.getPrice())]>>&lt;&lt;/foreach>></td>
		</tr>
	</tbody>
</table>

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we created in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs 75711d4899c2326cf821c70c1574ed0c >}}

---

## In-Table List with Filtering Grouping and Ordering in Email Document

Path: /assembly/net/in-table-list-with-filtering-grouping-and-ordering-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List with Filtering, Grouping, and Ordering report in Email Document format.{{< /alert >}}

## In-Table List with Filtering, Grouping, and Ordering in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater{{< /alert >}}

### Creating a In-Table List with Filtering, Grouping, and Ordering

Practicing the following steps you can create In-Table List with Filtering, Grouping, and Ordering Template in MS Outlook 2013.

1.  Create a new Email.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x2 table.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent managers' contract information with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show each customer along with sum of prices of his orders.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.Where(c =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">c.OrderDate.Year</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> == 2015)</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">GroupBy</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">(c =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">c.Customer</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">)</span></p><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">.</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">OrderBy</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">(g =&gt; </span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">g.Key.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">)]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Key.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Download In-Table List with Filtering, Grouping, and Ordering Template

Please download the sample In-Table List with Filtering, Grouping, and Ordering document we used in this article:

*   [In-Table List with Filtering, Grouping, and Ordering.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/In-Table%20List%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering.msg?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist rida-fatima-aspose 2b8017d19e5582250dbdd90a6b8b93b9 >}}



---

## In-Table List with Highlighted Rows in Email Document

Path: /assembly/java/in-table-list-with-highlighted-rows-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table List with Highlighted Rows report in Email Document format.{{< /alert >}}

## In-Table List with Highlighted Rows in Email Document

### Creating a In-Table List with Highlighted Rows

Practicing the following steps you can create In-Table List with Highlighted Rows Template in MS Outlook 2013.

1.  Create a new Email.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Click the cell you want to highlight.
5.  Click "Design" tab, and then select Shading.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show all the client names with price.
*   Show single client and his single contract price in a single row.
*   It must highlight the record with contract price more than or equal to 1000000.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table border="0" cellspacing="0" cellpadding="0" width="608" style="width: 456pt; border-collapse: collapse;"><tbody><tr><td width="371" valign="top" style="width: 278pt; border-top-color: white; border-top-style: solid; border-top-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p><b>Client</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: white; border-top-style: solid; border-top-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 3pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p><b>Contract Price</b></p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(244, 177, 131); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p><b>&lt;&lt;foreach [in getContracts()]&gt;&gt;&lt;&lt;if [getPrice() &gt;= 1000000]&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(244, 177, 131); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p>&lt;&lt;[getPrice()]&gt;&gt;</p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p><b>&lt;&lt;else&gt;&gt;&lt;&lt;[getClient().getName()]&gt;&gt;</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(234, 239, 247); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p>&lt;&lt;[getPrice()]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/foreach&gt;&gt;</p></td></tr><tr><td width="371" valign="top" style="width: 278pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: white; border-right-style: solid; border-right-width: 1pt; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: white; border-left-style: solid; border-left-width: 1pt; background-color: rgb(91, 155, 213); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p><b>Total:</b></p></td><td width="237" valign="top" style="width: 178pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: white; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: white; border-right-style: solid; border-right-width: 1pt; background-color: rgb(210, 222, 239); background-image: initial; padding-top: 0.75pt; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p>&lt;&lt;[getContracts().sum(</p><p>c =&gt; c.getPrice())]&gt;&gt;</p></td></tr></tbody></table>
### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we created in this article:

*   [In-Table List with Highlighted Rows.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs b5a0ff1980b6dae4bc13cebd7afed592 >}}



---

## In-Table List with Highlighted Rows in Email Document

Path: /assembly/net/in-table-list-with-highlighted-rows-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table List with Highlighted Rows report in Email Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

## In-Table List with Highlighted Rows in Email Document

### Creating a In-Table List with Highlighted Rows

Practising the following steps you can create In-Table List with Highlighted Rows Template in MS Outlook 2013.

1.  Create a new Email.
2.  Press "Insert" tab to insert the table.
3.  Insert a 2x4 table.
4.  Click the cell you want to highlight.
5.  Click "Design" tab, and then select Shading.
6.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   The report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   The report must show each customer along with his orders.
*   Show single Customer and his single order price in a single row.
*   It must highlight the record with order price more than or equal to 400.
*   It must show sum of the order prices.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt; width: 457pt;"><tbody><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer</span></p></td><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 3pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Order Price</span></p></td></tr><tr><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">foreach</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;"> [in orders]&gt;&gt;&lt;&lt;if [Price &gt;= 400]&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(244, 177, 131); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 3pt; padding-left: 4.9pt; padding-right: 4.9pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;[</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Customer.CustomerName</span><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;</span></p></td><td style="background-color: rgb(234, 239, 247); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Price]&gt;&gt;&lt;&lt;/if&gt;&gt;&lt;&lt;/</span><span style="font-family: Calibri; font-size: 11pt;">foreach</span><span style="font-family: Calibri; font-size: 11pt;">&gt;&gt;</span></p></td></tr><tr><td style="background-color: rgb(91, 155, 213); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 267.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="color: rgb(255, 255, 255); font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="background-color: rgb(210, 222, 239); border-bottom-color: rgb(255, 255, 255); border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: rgb(255, 255, 255); border-left-style: solid; border-left-width: 1pt; border-right-color: rgb(255, 255, 255); border-right-style: solid; border-right-width: 1pt; border-top-color: rgb(255, 255, 255); border-top-style: solid; border-top-width: 1pt; padding-left: 4.9pt; padding-right: 4.9pt; padding-top: 0.25pt; vertical-align: top; width: 167.2pt;"><p style="font-size: 11pt; line-height: 107%; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Price</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table List with Highlighted Rows Template

Please download the sample In-Table List with Highlighted Rows document we used in this article:

*   [In-Table List with Highlighted Rows.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/In-Table%20List%20with%20Highlighted%20Rows.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists 72de485e3dea296be963038b38292371 >}}



---

## In-Table Master-Detail in Email Document

Path: /assembly/java/in-table-master-detail-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Table Master-Detail report in Email Document format.{{< /alert >}}

## In-Table Master-Detail in Email Document

### Creating a In-Table Master-Detail

Practicing the following steps you can create In-Table Master-Detail Template in MS Outlook 2013.

1.  Create a new Email.
2.  Click the email where you want to add the table.
3.  Press "Insert" tab to insert the table.
4.  Insert a 2x4 table.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show each manager along with his total contract prices.
*   It must also show each individual client within the contract.
*   It must show sum of the contract prices.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="gd-assembly">
	<tbody>
		<tr>
			<td style="background-color: #5B9BD5"><b>Manager/Client</b></td>
			<td style="background-color: #5B9BD5"><b>Contract Price</b></td>
		</tr>
		<tr>
			<td style="background-color: #5B9BD5"><b>&lt;&lt;foreach [in getManagers()]>>&lt;&lt;[getName()]>></b></td>
			<td style="background-color: #D2DEEF">&lt;&lt;[getContracts().sum(c => c.getPrice())]>></td>
		</tr>
    <tr>
			<td style="background-color: #5B9BD5"><i>&lt;&lt;foreach [in getContracts()]>>  &lt;&lt;[getClient().getName()]>></i></td>
			<td style="background-color: #EAEFF7">&lt;&lt;[getPrice()]>>&lt;&lt;/foreach>>&lt;&lt;/foreach>></td>
		</tr>
    <tr>
			<td style="background-color: #5B9BD5"><b>Total:</b></td>
			<td style="background-color: #D2DEEF">&lt;&lt;[getManagers().sum(m => m.getContracts().sum(c => c.getPrice()))]>></td>
		</tr>
	</tbody>
</table>

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs d25e0d9e9d41a77fb9df43596303ebed >}}

---

## In-Table Master-Detail in Email Document

Path: /assembly/net/in-table-master-detail-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate an In-Table Master-Detail report in Email Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

## In-Table Master-Detail in Email Document

### Creating a In-Table Master-Detail

Practising the following steps you can create In-Table Master-Detail Template in MS Outlook 2013.

1.  Create a new Email.
2.  Click the email where you want to add the table.
3.  Press "Insert" tab to insert the table.
4.  Insert a 2x4 table.
5.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   The report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   The report must show each customer along with his total orders prices.
*   It must also show each individual product ordered by the customers.
*   It must show sum of the order prices.
*   It must represent all the information in tabular form.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

<table class="tbl1">
	<tbody>
		<tr>
			<td colspan="2"> &lt;&lt;foreach [in customers]>> &lt;&lt;foreach [in Order]>> &lt;&lt;/foreach>> &lt;&lt;/foreach>></td>
		</tr>
		<tr>
			<td>Customer</td>
			<td>Order Price</td>
		</tr>
		<tr>
			<td><<[CustomerName]>>
</td>
			<td><<[Order.Sum(c => c.Price)]>></td>
		</tr>
		<tr>
			<td colspan="2">  <<[Product.ProductName]>> <<[Price]>></td>
		</tr>
		<tr>
			<td>Total:</td>
			<td><<[Sum( m => m.Order.Sum( c => c.Price))]>></td>
		</tr>
	</tbody>
</table>

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Table Master-Detail Template

Please download the sample In-Table Master-Detail document we created in this article:

*   [In-Table Master-Detail.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/In-Table%20Master-Detail.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists 000ce4e55c5a3f95e7e0fb87392c9e32 >}}



---

## Installation

Path: /classification/net/installation/

## Install from Nuget

NuGet is the easiest way to download and install GroupDocs.Classification for .NET. There are ways to install it in your project.

#### Install via Package Manager GUI

Follow these steps to reference GroupDocs.Classification using Package Manager GUI:

*   Open your solution/project in Visual Studio.
*   Click Tools > NuGet Package Manager > Manage NuGet Packages for Solution. You can also access the same option through the Solution Explorer. Right-click the solution or project and select Manage NuGet Packages from the context menu
*   Select Browse tab and type "GroupDocs.Classification" in the search text box.
*   Click the Install button to install the latest version of the API into your project as shown in the following screenshot. 

![](classification/net/images/installation.png)

#### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Classification for .NET using the Package Manager Console:

*   Open your solution/project in Visual Studio.
*   Select Tools -> NuGet Package Manager -> Package Manager Console from the menu to open package manager console.
*   Type the command "Install-Package GroupDocs.Classification" and press enter to install the latest release into your application.
*   After successful installation, GroupDocs.Classification will be referenced in your application.  
![](classification/net/images/installation_1.png)

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Classification for .NET downloaded from official website [Downloads section](https://downloads.groupdocs.com/classification/net):

1.  Unpack zip archive or follow MSI install wizard instructions.
2.  In the Solution Explorer, expand the project node you want to add a reference to.
3.  Right-click the **References** node for the project and select **Add Reference** from the menu.
4.  In the Add Reference dialog box, select the **.NET** tab (it's usually selected by default).
5.  If you have used MSI installer to install GroupDocs.Classification, you will see GroupDocs.Classification in the top pane. Select it and then click the **Select** button.
6.  If you have downloaded and unpacked the DLL only, click the **Browse** button and locate the GroupDocs.Classification.dll file.   
    You have referenced GroupDocs.Classification and it should appear in the **SelectedComponents** pane of the dialog box.
7.  Click **OK**.   
    GroupDocs.Classification reference appears under the **References** node of the project.

---

## Installation

Path: /search/java/installation/

## Development Environment

### Operating Systems

**GroupDocs.Search for Java** can be executed on any Operating System with Java JDK installed.

*   Windows Desktops and Servers
*   Linux
*   Mac OS

### Supported Runtime

**GroupDocs.**Search **for Java** supports Java run-time version 6 (1.6) and above.

### Development Environments

*   NetBeans
*   IntelliJ IDEA
*   Eclipse

## Installation from GroupDocs Artifactory using Maven

GroupDocs hosts all Java APIs on [GroupDocs Artifactory](https://releases.groupdocs.com/java/repo/). You can easily use GroupDocs.Search for Java API directly in your Maven projects with simple configurations.

### Specify GroupDocs Repository Configuration

First, you need to specify GroupDocs repository configuration/location in your Maven `pom.xml` as follows:

**XML**

```java
<repositories>
	<repository>
		<id>GroupDocsJavaAPI</id>
		<name>GroupDocs Java API</name>
		<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```

### Define GroupDocs.Search for Java API Dependency

Then define GroupDocs.Search for Java API dependency in your `pom.xml` as follows:

**XML**

```java
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>19.10</version>
    </dependency>
</dependencies>
```

After performing above-mentioned steps, GroupDocs.Search for Java dependency will finally be added to your Maven project.

---

## Installation

Path: /search/net/installation/


## Install from Nuget

NuGet is the easiest way to download and install GroupDocs.Search for .NET. There are ways to install it in your project.

#### Install via Package Manager GUI

Follow these steps to reference GroupDocs.Search using Package Manager GUI:

*   Open your solution/project in Visual Studio.
*   Click Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution.  
    You can also access the same option through the Solution Explorer. Right-click the solution or project and select Manage NuGet Packages from the context menu.
*   Select Browse tab and type 'GroupDocs.Search' or 'GroupDocs.Search.NETFramework' in the search text box.
*   Click the Install button to install the latest version of the API into your project as shown in the following screenshot.

![](/search/net/images/installation.png)

#### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Search for .NET using the Package Manager Console:

*   Open your solution/project in Visual Studio.
*   Select Tools -> NuGet Package Manager -> Package Manager Console from the menu to open package manager console.
*   Type the command 'Install-Package GroupDocs.Search' or 'Install-Package GroupDocs.Search.NETFramework' and press enter to install the latest release into your application.  
    After successful installation, GroupDocs.Search will be referenced in your application.  

![](/search/net/images/installation_1.png)

```
PM> NuGet\Install-Package GroupDocs.Search
```

```
PM> NuGet\Install-Package GroupDocs.Search.NETFramework
```

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Search for .NET downloaded from official website [Downloads section](https://downloads.groupdocs.com/search/net):

1.  Unpack zip archive or follow MSI install wizard instructions.
2.  In the Solution Explorer, expand the project node you want to add a reference to.
3.  Right-click the **References** node for the project and select **Add Reference** from the menu.
4.  In the Add Reference dialog box, select the **.NET** tab (it's usually selected by default).
5.  If you have used MSI installer to install GroupDocs.Search, you will see GroupDocs.Search in the top pane. Select it and then click the **Select** button.
6.  If you have downloaded and unpacked the DLL only, click the **Browse** button and locate the GroupDocs.Search.dll file.   
    You have referenced GroupDocs.Search and it should appear in the **SelectedComponents** pane of the dialog box.
7.  Click **OK**.  
    GroupDocs.Search reference appears under the **References** node of the project.

---

## Installation

Path: /search/nodejs-java/installation/

## Install using NPM

All Java packages are hosted at [NPM](https://www.npmjs.com/package/@groupdocs/groupdocs.search). You can easily reference GroupDocs.Search for Node.js via Java API directly in your Node.js project by installing it with the following command.

```javascript
npm install @groupdocs/groupdocs.search
```

---

## Installation

Path: /watermark/java/installation/

GroupDocs hosts all Java APIs on [GroupDocs Repository](https://releases.groupdocs.com/java/repo/). You can easily use [GroupDocs.Watermark for Java](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-watermark/) API directly in your Maven projects with simple configurations.

### Specify GroupDocs Repository Configuration

First, you need to specify GroupDocs repository configuration/location in your Maven `pom.xml` as follows: 

```java
<repositories>
	<repository>
		<id>GroupDocsJavaAPI</id>
		<name>GroupDocs Java API</name>
		<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```

### Define GroupDocs.Watermark for Java API Dependency

Then define GroupDocs.Watermark for Java API dependency in your `pom.xml` as follows:

```java
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-watermark</artifactId>
        <version>20.4</version>
    </dependency>
</dependencies>
```

After performing above-mentioned steps, GroupDocs.Watermark for Java dependency will finally be added to your Maven project.

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Watermark for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/watermark/java):

1.  Unpack zip archive .
2.  Switch to **lib** folder.
3.  Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4.  After this you should add the GroupDocs.Watermark for Java watermark **dependency** block to your .pom.xml project file.

---

## Licensing

Path: /annotation/java/licensing-and-subscription/

Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Annotation provides different plans for purchase or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

There are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Annotation without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Only first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Annotation without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/annotation/java) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other of GroupDocs.Annotation classes.

{{< alert style="info" >}}

The license can be set multiple times per app domain but we recommend doing it once since all calls to `SetLicense` except first will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to set License.

// Create an instance of License class
License license = new License();

// Setup license via file
license.setLicense(licensePath);
```
{{< /tab >}}
{{< /tabs >}}


### Set License from Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "Java" >}}

```java
try (FileInputStream fileStream = new FileInputStream("GroupDocs.Annotation.lic"))
{
    License license = new License();
    license.setLicense(fileStream);
}
```

{{< /tab >}}
{{< /tabs >}}


### Set Metered License

You can also set the [Metered](https://reference.groupdocs.com/annotation/java/groupdocs.annotation/metered/) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For  details, please refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

The following code snippet shows how to use `Metered` licensing:

{{< tabs "example3">}}
{{< tab "Java" >}}

```java
// This example demonstrates how to use Metered.

String publicKey = ""; // Your public license key
String privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
double consumption = metered.getConsumptionQuantity();
System.out.print("Metered consumption = " + consumption);     

// Get count of credits consumed
double credit = metered.getConsumptionCredit();
System.out.print("Metered credit = " + credit);
```

{{< /tab >}}
{{< /tabs >}}
---

## Licensing

Path: /annotation/net/licensing-and-subscription/

Sometimes to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Annotation provides different plans for purchase or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Annotation without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Only first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Annotation without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/annotation/net) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other of GroupDocs.Annotation classes.

{{< alert style="info" >}}

The license can be set multiple times per app domain but we recommend doing it once since all calls to `SetLicense` except first will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "C#" >}}

```csharp
string licensePath = "path to the .lic file";
License license = new License();
license.SetLicense(licensePath);
```

{{< /tab >}}
{{< /tabs >}}


### Set License from Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "C#" >}}

```csharp
string licensePath = "path to the .lic file";
using (FileStream fileStream = File.OpenRead(licensePath))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```

{{< /tab >}}
{{< /tabs >}}


### Set Metered License

You can also set the [Metered](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/metered/) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For  details, please refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

The following code snippet shows how to use `Metered` licensing:

{{< tabs "example3">}}
{{< tab "C#" >}}

```csharp
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Viewer.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Viewer.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

{{< /tab >}}
{{< /tabs >}}
---

## Licensing

Path: /comparison/java/licensing-and-evaluation-limitations/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Comparison provides different purchase plans or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are several general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Comparison without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Only first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Annotation without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/comparison/java) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other of GroupDocs.Annotation classes.

{{< alert style="info" >}}

The license can be set multiple times per application domain but we recommend doing it once since all calls to `setLicense` except first will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "Java" >}}

```java
import com.groupdocs.comparison.license.License;
// ...

License lic = new License();
lic.setLicense(licensePath);
```

{{< /tab >}}
{{< /tabs >}}


### Set License from Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "Java" >}}

```java
import com.groupdocs.comparison.license.License;
import java.io.FileInputStream;
// ...

License lic = new License();
lic.setLicense(licenseInputStream);
```

{{< /tab >}}
{{< /tabs >}}


### Set Metered License

You can also set the [Metered](https://reference.groupdocs.com/comparison/java/groupdocs.comparison/metered/) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For  details, please refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

The following code snippet shows how to use `Metered` licensing:

{{< tabs "example3">}}
{{< tab "Java" >}}

```java
import com.groupdocs.comparison.license.Metered;
// ...

String publicKey = ""; // Your public license key
String privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
double amountConsumed = Metered.getConsumptionQuantity();
System.out.println("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
double creditsConsumed = Metered.getConsumptionCredit();
System.out.println("Credits consumed: " + creditsConsumed);
```

{{< /tab >}}
{{< /tabs >}}
---

## Licensing

Path: /comparison/nodejs-java/licensing-and-evaluation-limitations/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Comparison provides different purchase plans or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are several general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Comparison without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in several ways that are described in the next sections of this article.

The evaluation version comes with the following limitations:

- Only the first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Comparison without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set up a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/comparison/nodejs-java) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other GroupDocs.Comparison classes.

{{< alert style="info" >}}

The license can be set multiple times per application domain, but we recommend doing it once since all the subsequent calls to the `setLicense` method except for the first one will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from a file:

```javascript
'use strict';

// Load the GroupDocs Comparison SDK for Node.js
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Path to the license file
const licensePath = 'GroupDocs.Comparison.lic';

// Create a License object and set the license
const license = new groupdocs.License();
license.setLicense(licensePath);

// Terminate the process with a success exit code
process.exit(0);
```

### Set License from Stream

The following code snippet shows how to set a license from a stream:

```javascript
'use strict';

// Load the GroupDocs Comparison SDK for Node.js
const groupdocs = require('@groupdocs/groupdocs.comparison');
const java = require('java');

// Create a reference to Java's FileInputStream class
let InputStream = java.import('java.io.FileInputStream');

// Path to the license file
const licensePath = 'GroupDocs.Comparison.lic';

// Initialize a FileInputStream for the license file
const stream = new InputStream(licensePath);

// Create a License object and set the license using the InputStream
const license = new groupdocs.License();
license.setLicense(stream);

// Terminate the process with a success exit code
process.exit(0);
```

---

## Licensing

Path: /comparison/python-net/licensing-and-evaluation-limitations/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Comparison provides different purchase plans or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are several general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Comparison without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in several ways that are described in the next sections of this article.

The evaluation version comes with the following limitations:

- Only the first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Comparison without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set up a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/comparison/python-net) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other GroupDocs.Comparison classes.

{{< alert style="info" >}}

The license can be set multiple times per application domain, but we recommend doing it once since all the subsequent calls to the `set_license` method except for the first one will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from a file:

```python
import groupdocs.comparison as gc
license = gc.License()
license.set_license(license_path)
```

### Set License from Stream

The following code snippet shows how to set a license from a stream:

```python
import groupdocs.comparison as gc
import os
from os.path import join

def run():
    if os.path.exists(license_path):
        with open(license_path, "rb") as stream:
            gc.License().set_license(stream)
```

### Set Metered License

A [Metered License](https://reference.groupdocs.com/comparison/python-net/groupdocs.comparison/metered) is also available as an alternative to a traditional license file. It is a usage-based licensing model that may be more suitable for customers who prefer to be billed based on actual API feature usage. For more information, refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered).

The following sample demonstrates how to use metered licensing:

```python
from groupdocs.comparison import Metered

def set_metered_license():
    # Set your public and private keys
    public_key = "******" 
    private_key = "******" 

    # Instantiate Metered and set keys
    metered = Metered()
    metered.set_metered_key(public_key, private_key)

    # Get a number of MBs processed 
    mb_processed = metered.get_consumption_quantity()
    print("MB processed: ", mb_processed)

    # Get a number of credits used
    credits_used = metered.get_consumption_credit()
    print("Credits used: ", credits_used)

if __name__ == "__main__":
    set_metered_license()
```

---

## Licensing

Path: /conversion/java/licensing-and-subscription/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Conversion offers a Free Trial and a 30-day Temporary License for evaluation and provides different purchase plans.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Conversion without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that are described in the next sections of this article.

The evaluation version comes with the limitations:

* Only the first 3 pages are processed.
* Documents with more than 3 pages are not supported.
* Trial badges are placed in the document on the top of each page.
  
### Temporary License

If you wish to test GroupDocs.Conversion without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set up a license

{{< alert style="info" >}}

You can find pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/conversion/java) page.

{{< /alert >}}

After the license is obtained you need to set up the license. This section describes options of how this can be done and also comments on some common questions.

The license should be set:

- Only once per application domain,
- and before using any other GroupDocs.Conversion classes.

{{< alert style="info" >}}

The license can be set multiple times per app domain but we recommend doing it once since all calls to the `SetLicense` method except for the first one will just waste processor time.

{{< /alert >}}

### Set License from File

The following code sets a license from a file.

```java
import com.groupdocs.conversion.licensing.License;
import java.io.File;
...
String licensePath = "path to the .lic file";
License license = new License();
license.setLicense(licensePath);
```

### Set License from Stream

The following example shows how to load a license from a stream.

```java
import com.groupdocs.conversion.licensing.License;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
...
String licensePath = "path to the .lic file";
try (InputStream fileStream = new FileInputStream(licensePath)) {
    License license = new License();
    license.setLicense(fileStream);
}
```
<!--
{{< alert style="info" >}}Calling the [License](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/License).[setLicense](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/License#setLicense(java.lang.String)) method multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call the `License.SetLicense` method in your startup code, before using the `GroupDocs.conversion` classes.  
When developing an ASP.NET application, you can call the `License.SetLicense` method from the `Global.asax.cs` or the `Global.asax.vb` file in the `Application\_Start` protected method. It is called once when the application starts.  

Do not call the [License](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/License).[setLicense](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/License#setLicense(java.lang.String)) method from within the `Page\_Load` methods since it means the license will be loaded every time a web page is loaded.
{{< /alert >}}
-->
### Set Metered License

You can also set [Metered](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/Metered) license as an alternative to the license file. It is a new licensing mechanism that will be used along with the existing licensing method. It is useful for customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

<!--
Here are the simple steps to use the `Metered` class.

1. Create an instance of [Metered](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/Metered) class.
2. Pass public & private keys to the [setMeteredKey](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/Metered#setMeteredKey(java.lang.String,%20java.lang.String)) method.
3. Do processing (perform the task).
4. Call the [getConsumptionQuantity](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/Metered#getConsumptionQuantity()) method of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. Call the [getConsumptionCredit](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/Metered#getConsumptionCredit()) method of the [Metered](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/Metered) class.
7. It will return the credit that you have consumed so far.
-->

Following is the sample code demonstrating how to use the [Metered](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.licensing/Metered) class.

```java
import com.groupdocs.conversion.licensing.Metered;
...
String publicKey = ""; // Your public license key
String privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
Double consumption = metered.getConsumptionQuantity();
System.out.print("Metered consumption = " + consumption);

// Get count of credits consumed
Double credit = metered.getConsumptionCredit();
System.out.print("Metered credit = " + credit);
```

---

## Licensing

Path: /conversion/nodejs-java/licensing-and-subscription/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Conversion offers a Free Trial and a 30-day Temporary License for evaluation and provides different purchase plans.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Conversion without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that are described in the next sections of this article.

The evaluation version comes with the limitations:

* Only the first 3 pages are processed.
* Documents with more than 3 pages are not supported.
* Trial badges are placed in the document on the top of each page.
  
### Temporary License

If you wish to test GroupDocs.Conversion without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set up a license

{{< alert style="info" >}}

You can find pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/conversion/nodejs-java) page.

{{< /alert >}}

After the license is obtained you need to set up the license. This section describes options of how this can be done and also comments on some common questions.

The license should be set:

- Only once per application domain,
- and before using any other GroupDocs.Conversion classes.

{{< alert style="info" >}}

The license can be set multiple times per app domain but we recommend doing it once since all calls to the `SetLicense` method except for the first one will just waste processor time.

{{< /alert >}}

### Set License from File

The following code sets a license from a file.

```js
'use strict';

// Require dependencies
const groupdocs = require('@groupdocs/groupdocs.conversion');
const path = require('path');

// Set license path
const licensePath = path.resolve(__dirname, 'GroupDocs.Conversion.lic');

// Set the license
const license = new groupdocs.License();
license.setLicense(licensePath);
console.log('License set successfully');

// Exit the process
process.exit(0);
```

### Set License from Stream

The following example shows how to load a license from a stream.

```js
// Require dependencies
const groupdocs = require('@groupdocs/groupdocs.conversion');
const path = require('path');
const fs = require('fs');

// Set license path get stream
const licensePath = path.resolve(__dirname, 'GroupDocs.Conversion.lic');
const licenseStream = fs.createReadStream(licensePath);

// Read license from stream
groupdocs.readDataFromStream(licenseStream)
  .then(stream => {
    // Set the license
    const license = new groupdocs.License();
    license.setLicense(stream);
    process.exit(0);
  })
  .catch(error => {
    // Show error
    console.error('Error setting license:', error);
    process.exit(1);
  });
```

---

## Licensing

Path: /conversion/python-net/licensing/


To help you quickly explore library and its features, GroupDocs.Conversion provides a Free Trial and a 30-day Temporary License for evaluation, as well as various purchase plans.

Sometimes, to get familiar with the system quickly, you may want to dive into the code right away. To make this easier, GroupDocs.Conversion offers a Free Trial and a 30-day Temporary License for evaluation, along with various purchase plans.

{{< alert style="info" >}}
Please note that general policies and practices guide you on evaluating, licensing, and purchasing our products. See the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies/) section for details.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Conversion without purchasing a license.

### Free Trial

The evaluation version is identical to the full version — it simply becomes fully licensed when you apply a license. Instructions for setting a license are provided in the following sections.

The evaluation version has the following limitations:
* Only the first three pages are processed.
* Documents with more than three pages are not supported.
* A trial watermark is placed at the top of each page.

### Temporary License

If you'd like to test GroupDocs.Conversion without the limitations of the trial version, you can request a 30-day Temporary License. For more information, see the [Get a Temporary License](https://purchase.groupdocs.com/temporary-license) page.

## How to Set Up a License

{{< alert style="info" >}}
For information on pricing, visit the [Pricing Information](https://purchase.groupdocs.com/pricing/) page.
{{< /alert >}}

Once you’ve obtained a license, follow these instructions to set it up. 

A license should be set:
- Only once per application, and
- Before using any other GroupDocs.Conversion classes.

{{< alert style="tip" >}}
Though the license can be set multiple times per application, it is recommended to set it only once, as repeated calls to the `set_license` method will use unnecessary processing time.
{{< /alert >}}

### Set Environment Variable

You can set the `GROUPDOCS_LIC_PATH` environment variable to the absolute path of the license file. GroupDocs.Conversion will then read this value and apply the license.

{{< tabs "set-license-env-var">}}
{{< tab "Windows (Command Prompt)" >}}
```ps
set GROUPDOCS_LIC_PATH "C:\path\to\your\license\file.lic"
```
{{< /tab >}}
{{< tab "Windows (Powershell)" >}}
```ps
$env:GROUPDOCS_LIC_PATH="C:\path\to\your\license\file.lic"
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
export GROUPDOCS_LIC_PATH="/path/to/your/license/file.lic"
```
{{< /tab >}}
{{< /tabs >}}

### Copy License into Project Root Folder

GroupDocs.Conversion can also read a license from the project’s root directory. Consider a simple Python app structure:

```Directory
📂 my-app
 ├──app.py
 ├──source.docx
 ├──groupdocs_conversion_net-24.12-py3-none-*.whl
 └──GroupDocs.Conversion.PythonViaNET.lic
```

When you run the application from the `my-app` folder, GroupDocs.Conversion will check for files with a `.lic` extension in this folder. It will read the `GroupDocs.Conversion.PythonViaNET.lic` file to apply the license.

### Set License from a File

The following code demonstrates setting a license from a file:

```python
import os
from groupdocs.conversion import License

def set_license_from_file():
    # Get absolution path to license file
    license_path = os.path.abspath("./GroupDocs.Conversion.PythonViaNET.lic")

    # Instantiate License and set the license
    license = License()
    license.set_license(license_path)

if __name__ == "__main__":
    set_license_from_file()
```

### Set License from a Stream

This example shows how to set a license from a stream:

```python
import os
from groupdocs.conversion import License

def set_license_from_stream():
    # Get absolution path to license file
    license_path = os.path.abspath("./GroupDocs.Conversion.PythonViaNET.lic")

    # Create a readable steam
    with open(license_path, "rb") as license_stream:
        # Instantiate License and set the license
        # Instantiate License and set the license
        license = License()
        license.set_license(license_stream)

if __name__ == "__main__":
    set_license_from_stream()
```

### Set Metered License

A [Metered License](https://reference.groupdocs.com/conversion/python-net/groupdocs.conversion/metered) is also available as an alternative to a traditional license file. It is a usage-based licensing model that may be more suitable for customers who prefer to be billed based on actual API feature usage. For more information, refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered).

The following sample demonstrates how to use metered licensing:

```python
from groupdocs.conversion import Metered

def set_metered_license():
    # Set your public and private keys
    public_key = "******" 
    private_key = "******" 

    # Instantiate Metered and set keys
    metered = Metered()
    metered.set_metered_key(public_key, private_key)

    # Get a number of MBs processed 
    mb_processed = metered.get_consumption_quantity()
    print("MB processed: ", mb_processed)

    # Get a number of credits used
    credits_used = metered.get_consumption_credit()
    print("Credits used: ", credits_used)

if __name__ == "__main__":
    set_metered_license()
```

---

## Licensing

Path: /watermark/nodejs-java/evaluation-limitations-and-licensing/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Watermark provides different purchase plans or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are several general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Watermark without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in several ways that are described in the next sections of this article.

The evaluation version comes with the following limitations:

- Only the first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Watermark without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set up a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/watermark/nodejs-java) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other GroupDocs.Watermark classes.

{{< alert style="info" >}}

The license can be set multiple times per application domain, but we recommend doing it once since all the subsequent calls to the `setLicense` method except for the first one will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from a file:

```javascript
const licensePath = "path to the .lic file";
const license = new groupdocs.watermark.License()
await license.setLicense(licensePath); 
```

### Set License from Stream

The following code snippet shows how to set a license from a stream:

```javascript
const java = require('java');
let InputStream = java.import('java.io.FileInputStream');

const licensePath = "path to the .lic file"
try {
  const stream = new InputStream(licensePath)

  const license = new groupdocs.watermark.License()
  await license.setLicense(stream);
  console.log('License set successfully.');
} catch {
  console.log("\nWe do not ship any license with this example. " +
    "\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
    "\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
    "\nLearn how to request a temporary license at https://purchase.groupdocs.com/temporary-license.");
}
```
---

## Licensing and evaluation

Path: /merger/nodejs-java/licensing-and-evaluation/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Merger provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Merger classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _GroupDocs.Merger.dll_ file
*   The folder containing the assembly that called _GroupDocs.Merger.dll_
*   The folder containing the entry assembly (your _.exe_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

When you reference _GroupDocs.Merger.dll_ in the application, the library is copied to your output directory (unless **Copy Local** in the properties for that entry is set to false). The easiest way to set a license is often to place the license file in the same folder as _GroupDocs.Merger.dll_ and specify just the filename without the path.

Use the [setLicense](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/license/#setLicense-java.io.InputStream-) method to license a component.

Calling `setLicense` multiple times is not harmful, it simply wastes processor time.

Calling [setMeteredKey](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/metered/#setMeteredKey-java.lang.String-java.lang.String-) multiple times is not harmful either but wastes processor time and can accumulate consumption improperly.

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `setLicense` method in your startup code before using the GroupDocs.Merger classes.

##### Set a License from a File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "JavaScript" >}}

```js
const licensePath = "path to the .lic file";
const license = new groupdocs.merger.License()
license.setLicense(licensePath); 
```

{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "JavaScript" >}}

```js
const fs = require('fs')  
  
const licensePath = "path to the .lic file"
const license = new groupdocs.merger.License()
const licStream = fs.createReadStream(licensePath)
groupdocs.conversion.License.setLicenseFromStream(license, licStream, err => {
  if (err) {
    console.log(`Set license error: ${err}`)
  } else {
    console.log('License set OK')
  }
})
```

{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You do not have to name the license file "GroupDocs.Merger.lic". Feel free to rename it as you prefer, and use that name when setting the license in your application.

### "Cannot find license filename" Exception

When you buy and download a license from the GroupDocs website, the license file is named "GroupDocs.Merger.lic." Download it using your browser. Sometimes, browsers recognize it as XML and add the .xml extension, making the full file name "GroupDocs.Merger.lic.XML" on your computer.

If Microsoft Windows is set to hide file extensions (which is the default in most installations), the license file will show as "GroupDocs.Merger.lic" in Windows Explorer. You might assume this is the actual file name and call the `setLicense` method with "GroupDocs.Merger.lic", but there is no such file, leading to an exception.

To fix this issue, rename the file to remove the hidden .xml extension. Additionally, we suggest disabling the "Hide extensions" option in Microsoft Windows.

## How to Evaluate GroupDocs.Merger

You can also try GroupDocs.Merger without buying a license.

### Free Trial

The evaluation version is identical to the purchased one; it becomes licensed once you set the license. You can set the license using methods described in the following sections of this article.

The evaluation version has the following limitations:

- Rendering is limited to the first 2 pages.
- Trial badges are added to the top of a rendered page.

### Temporary License

If you want to test GroupDocs.Merger without the limitations of the trial version,   request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.
---

## Licensing and evaluation

Path: /merger/python-net/licensing-and-evaluation/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Merger provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Merger classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _GroupDocs.Merger.dll_ file
*   The folder containing the assembly that called _GroupDocs.Merger.dll_
*   The folder containing the entry assembly (your _.exe_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

When you reference _GroupDocs.Merger.dll_ in the application, the library is copied to your output directory (unless **Copy Local** in the properties for that entry is set to false). The easiest way to set a license is often to place the license file in the same folder as _GroupDocs.Merger.dll_ and specify just the filename without the path.

Use the [setLicense](https://reference.groupdocs.com/merger/net/groupdocs.merger/license/setlicense/) method to license a component.

Calling `setLicense` multiple times is not harmful, it simply wastes processor time.

Calling [setMeteredKey](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered/setmeteredkey/) multiple times is not harmful either but wastes processor time and can accumulate consumption improperly.

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `setLicense` method in your startup code before using the GroupDocs.Merger classes.

##### Set a License from a File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "JavaScript" >}}

```python
license_path = "path to the .lic file"
license = gm.License()
license.set_license(license_path)
```

{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "JavaScript" >}}

```python
license_path = "path to the .lic file"
with open(license_path, "rb") as stream:
    gm.License().set_license(stream)
```

{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You do not have to name the license file "GroupDocs.Merger.lic". Feel free to rename it as you prefer, and use that name when setting the license in your application.

### "Cannot find license filename" Exception

When you buy and download a license from the GroupDocs website, the license file is named "GroupDocs.Merger.lic." Download it using your browser. Sometimes, browsers recognize it as XML and add the .xml extension, making the full file name "GroupDocs.Merger.lic.XML" on your computer.

If Microsoft Windows is set to hide file extensions (which is the default in most installations), the license file will show as "GroupDocs.Merger.lic" in Windows Explorer. You might assume this is the actual file name and call the `setLicense` method with "GroupDocs.Merger.lic", but there is no such file, leading to an exception.

To fix this issue, rename the file to remove the hidden .xml extension. Additionally, we suggest disabling the "Hide extensions" option in Microsoft Windows.

## How to Evaluate GroupDocs.Merger

You can also try GroupDocs.Merger without buying a license.

### Free Trial

The evaluation version is identical to the purchased one; it becomes licensed once you set the license. You can set the license using methods described in the following sections of this article.

The evaluation version has the following limitations:

- Rendering is limited to the first 2 pages.
- Trial badges are added to the top of a rendered page.

### Temporary License

If you want to test GroupDocs.Merger without the limitations of the trial version,   request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.
---

## Licensing and evaluation

Path: /redaction/python-net/licensing-and-subscription/


To explore the system effectively, you may want immediate access to the API. GroupDocs.Redaction simplifies this by offering various purchase plans, along with a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

To learn more about licensing options, purchasing, and evaluation policies, refer to the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## Purchased License

After purchasing GroupDocs.Redaction for Python via .NET, you will receive a license file that needs to be applied to unlock the full functionality of the API. 

License Application Requirements:
- The license should be set only once within the application domain
- It must be configured before using any GroupDocs.Redaction classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _GroupDocs.Redaction.dll_ file
*   The folder containing the assembly that called _GroupDocs.Redaction.dll_
*   The folder containing the entry assembly (your _.exe_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

When you reference _GroupDocs.Redaction.dll_ in the application, the library is copied to your output directory (unless **Copy Local** in the properties for that entry is set to false). The easiest way to set a license is often to place the license file in the same folder as _GroupDocs.Redaction.dll_ and specify just the filename without the path.

Use the [setLicense](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/license/set_license/) method to license a component.

Calling `setLicense` multiple times is not harmful, it simply wastes processor time.

Calling [setMeteredKey](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/metered/set_metered_key/) multiple times is not harmful either but wastes processor time and can accumulate consumption improperly.

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `setLicense` method in your startup code before using the GroupDocs.Redaction classes.

##### Set a License from a File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "Python" >}}

```python
def run():
    if os.path.exists("path to .lic file"):    
        license = gr.License()
        license.set_license("path to .lic file")
        print("License set successfully.")
    else:
       print("\n")
```

{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "Python" >}}

```python
if os.path.exists("path to .lic file"):
        with open("path to .lic file", "rb") as stream:
            gr.License().set_license(stream)

        print("License set successfully.")
    else:
        print("\n")
```

{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You are not required to keep the license file name as GroupDocs.Redaction.lic. You can rename it to any preferred name and use that name when applying the license in your application.

### "Cannot find license filename" Exception

When you download the license from the GroupDocs website, it is saved with the name GroupDocs.Redaction.lic. However, some web browsers may automatically append .xml, resulting in the file name being GroupDocs.Redaction.lic.xml.

If your Windows settings are configured to hide file extensions (which is the default), the file may still appear as GroupDocs.Redaction.lic in File Explorer, even though the actual name is GroupDocs.Redaction.lic.xml. This discrepancy can cause the `setLicense` method to throw an exception.

To fix this issue, manually rename the file to remove the .xml extension. Optionally, disable the "Hide extensions for known file types" option in Windows to prevent this issue.

## How to Evaluate GroupDocs.Redaction

You can evaluate GroupDocs.Redaction for Python via .NET without purchasing a license by using one of the following options:

### Free Trial

The evaluation version is identical to the purchased one; it becomes licensed once you set the license. You can set the license using methods described in the following sections of this article.

The Free Trial version gives you access to the API's features, but with some limitations:

- Only 1 document can be opened in one process.
- Only 1 redaction can be applied to the document.
- Any redaction is limited to 4 replacements/deletions, even if there are more matches.
- Trial badges are placed in the document on the top of each page.

### Temporary License

To experience the complete features of GroupDocs.Redaction without the limitations of the Free Trial, you can request a 30-day ["Temporary License"](https://purchase.groupdocs.com/temporary-license).
---

## Licensing and evaluation

Path: /total/java/licensing-and-evaluation/

To study the system, you may want quick access to the API. To make this easier, GroupDocs.Total provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies/) section.

{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain and only once for each GroupDocs product you want to use
- Before using any other GroupDocs.Total classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _groupdocs-total.jar_ file
*   The folder containing the package that called _groupdocs-total.jar_
*   The folder containing the entry package (your _.jar_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).
*   As an embedded resource
When you reference _groupdocs-total.jar_ in the application, the library is copied to your output directory. The easiest way to set a license is often to place the license file in the same folder as _groupdocs-total.jar_ and specify just the filename without the path.

Use the `setLicense` method to license a specific GroupDocs product. For example, to apply license for GroupDocs.Viewer component [setLicense](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/license/#setLicense-java.lang.String-) method has to be used.

Calling `setLicense` multiple times is not harmful, it simply wastes processor time.

Calling `setMeteredKey` multiple times is not harmful either but wastes processor time and can accumulate consumption improperly.

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `setLicense` method in your startup code before using the GroupDocs.Total classes.

##### Set a License from a File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "Java" >}}

```java
string licensePath = "GroupDocs.Total.lic";
com.groupdocs.viewer.License licenseViewer = new com.groupdocs.viewer.License();
licenseViewer.setLicense(licensePath);

com.groupdocs.conversion.License licenseConversion = new com.groupdocs.conversion.License();
licenseConversion.setLicense(licensePath);

// Set licenses for other GroupDocs products you are going to use

```

{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "Java" >}}

```java

try (InputStream fileStream = new FileInputStream("GroupDocs.Total.lic")) {
    com.groupdocs.viewer.License licenseViewer = new com.groupdocs.viewer.License();
    licenseViewer.setLicense(licenseStream);

    com.groupdocs.conversion.License licenseConversion = new com.groupdocs.conversion.License();
    licenseConversion.setLicense(licenseStream);

    // Set licenses for other GroupDocs products you are going to use
}
```

{{< /tab >}}
{{< /tabs >}}

#### Apply Metered License

You can set the `Metered` license as an alternative to license file. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

The following code snippet shows how to use the metered license:

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

// Set metered keys for GroupDocs.Viewer
com.groupdocs.viewer.Metered meteredViewer = new com.groupdocs.viewer.Metered();
meteredViewer.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = com.groupdocs.viewer.Metered.getConsumptionQuantity();
System.out.println("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = com.groupdocs.viewer.Metered.getConsumptionCredit();
System.out.println("Credits consumed: " + creditsConsumed);

// Set metered keys for GroupDocs.Conversion
com.groupdocs.conversion.Metered meteredConversion = new com.groupdocs.conversion.Metered();
meteredConversion.setMeteredKey(publicKey, privateKey);

```
{{< /tab >}}
{{< /tabs >}}

#### Apply License from an Embedded Resource

Instead of using a license file, you can install the license as an embedded resource. To do this, add a license to the project and specify the license name in the `setLicense` method without specifying the full path to this file.

{{< alert style="info" >}}
To use the embedded license, add it to your project and set the **Build Action** property of this file to "Embedded Resource". Ensure that the license name in the embedded resources matches the string parameter of the `setLicense` method.
{{< /alert >}}

The following code snippet shows how to use the embedded license:

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
com.groupdocs.viewer.License licenseViewer = new com.groupdocs.viewer.License();
licenseViewer.setLicense("GroupDocs.Total.lic");

com.groupdocs.conversion.License licenseConversion = new com.groupdocs.conversion.License();
licenseConversion.setLicense("GroupDocs.Total.lic");
```
{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You do not have to name the license file "GroupDocs.Total.lic". Feel free to rename it as you prefer, and use that name when setting the license in your application.

### "Cannot find license filename" Exception

When you buy and download a license from the GroupDocs website, the license file is named "GroupDocs.Total.lic." Download it using your browser. Sometimes, browsers recognize it as XML and add the .xml extension, making the full file name "GroupDocs.Total.lic.XML" on your computer.

If Microsoft Windows is set to hide file extensions (which is the default in most installations), the license file will show as "GroupDocs.Total.lic" in Windows Explorer. You might assume this is the actual file name and call the `setLicense` method with "GroupDocs.Total.lic", but there is no such file, leading to an exception.

To fix this issue, rename the file to remove the hidden .xml extension. Additionally, we suggest disabling the **Hide extensions** option in Microsoft Windows.

## How to Evaluate GroupDocs.Total

You can also try GroupDocs.Total without buying a license.

### Free Trial

The evaluation version is identical to the purchased one; it becomes licensed once you set the license. You can set the license using methods described in the following sections of this article.

The evaluation version has the following limitations:

- Rendering is limited to the first 2 pages.
- Trial badges are added to the top of a rendered page.

### Temporary License

If you want to test GroupDocs.Total without the limitations of the trial version,   request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license/) page.


---

## Licensing and evaluation

Path: /total/net/licensing-and-evaluation/


This guide explains the different licensing options available for GroupDocs.Total for .NET and how to properly set up licensing in your applications.

## Overview

GroupDocs.Total for .NET offers multiple licensing options to suit your needs:
- Free Trial for evaluation
- 30-day Temporary License
- Purchased License
- Metered License (pay-as-you-go)

{{< alert style="info" >}}
For detailed information about our licensing policies and frequently asked questions, please visit the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies/) section.
{{< /alert >}}

## Evaluation Options

### Free Trial

The evaluation version is identical to the purchased version and becomes fully licensed once you set the license. However, it includes the following limitations:
- Evaluation watermark on output documents
- Page processing limits (varies by product)
- Other product-specific limitations

### Temporary License

For testing without trial limitations, you can request a 30-day Temporary License:
1. Visit the [Get a Temporary License](https://purchase.groupdocs.com/temporary-license/) page
2. Follow the instructions to request your temporary license
3. Apply the license using one of the methods described below

## License Application

### Important Notes

- Set the license only once per application domain
- Set the license before using any GroupDocs.Total classes
- Multiple calls to `SetLicense` are safe but unnecessary
- Multiple calls to `SetMeteredKey` should be avoided to prevent improper consumption tracking

### License File Locations

You can apply licenses from various locations:
- Explicit file path
- Same folder as GroupDocs.Total.dll
- Same folder as the calling assembly
- Same folder as the entry assembly (.exe)
- As an embedded resource

### License Application Methods

#### 1. From a File

{{< tabs "example1">}}
{{< tab "C#" >}}

```csharp
string licensePath = "GroupDocs.Total.lic";

// Set license for all products
GroupDocs.Total.License.SetLicense(licensePath);

// Or set license for specific products
GroupDocs.Viewer.License licenseViewer = new GroupDocs.Viewer.License();
licenseViewer.SetLicense(licensePath);

GroupDocs.Conversion.License licenseConversion = new GroupDocs.Conversion.License();
licenseConversion.SetLicense(licensePath);
```

{{< /tab >}}
{{< /tabs >}}


#### 2. From a Stream

{{< tabs "example2">}}
{{< tab "C#" >}}

```csharp
string licensePath = "GroupDocs.Total.lic";
using (FileStream licenseStream = File.OpenRead(licensePath))
{
    // Set license for all products
    GroupDocs.Total.License.SetLicense(licenseStream);

    // Or set license for specific products
    GroupDocs.Viewer.License licenseViewer = new GroupDocs.Viewer.License();
    licenseViewer.SetLicense(licenseStream);

    GroupDocs.Conversion.License licenseConversion = new GroupDocs.Conversion.License();
    licenseConversion.SetLicense(licenseStream);
}
```

{{< /tab >}}
{{< /tabs >}}

#### 3. As an Embedded Resource

To use an embedded license:

1. Add the license file to your project
2. Set its **Build Action** property to "Embedded Resource"
3. Ensure the license name matches the parameter in `SetLicense`

{{< tabs "example3">}}
{{< tab "C#" >}}

```csharp
// Set license for all products
GroupDocs.Total.License.SetLicense("GroupDocs.Total.lic");

// Or set license for specific products
GroupDocs.Viewer.License licenseViewer = new GroupDocs.Viewer.License();
licenseViewer.SetLicense("GroupDocs.Total.lic");

GroupDocs.Conversion.License licenseConversion = new GroupDocs.Conversion.License();
licenseConversion.SetLicense("GroupDocs.Total.lic");
```

{{< /tab >}}
{{< /tabs >}}

#### 4. Metered License

For pay-as-you-go licensing, use the Metered License option. For more details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

{{< tabs "example4">}}
{{< tab "C#" >}}


```csharp
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

// Set metered keys for GroupDocs.Viewer
GroupDocs.Viewer.Metered meteredViewer = new GroupDocs.Viewer.Metered();
meteredViewer.SetMeteredKey(publicKey, privateKey);

// Get consumption metrics
decimal amountConsumed = GroupDocs.Viewer.Metered.GetConsumptionQuantity();
decimal creditsConsumed = GroupDocs.Viewer.Metered.GetConsumptionCredit();

// Set metered keys for GroupDocs.Conversion
GroupDocs.Conversion.Metered meteredConversion = new GroupDocs.Conversion.Metered();
meteredConversion.SetMeteredKey(publicKey, privateKey);
```

{{< /tab >}}
{{< /tabs >}}


## Troubleshooting

### License File Naming
- You can rename the license file as needed
- Ensure the filename in your code matches the actual file name

### Common Issues

#### Can't find a license file

If you're setting a license file using a relative path and encountering issues, try using the absolute file path instead.
---

## Licensing and evaluation

Path: /viewer/java/licensing-and-evaluation/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Viewer provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Viewer classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _groupdocs-viewer.jar_ file
*   The folder containing the package that called _groupdocs-viewer.jar_
*   The folder containing the entry package (your _.jar_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

When you reference _groupdocs-viewer.jar_ in the application, the library is copied to your output directory. The easiest way to set a license is often to place the license file in the same folder as _groupdocs-viewer.jar_ and specify just the filename without the path.

Use the [setLicense](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/license/#setLicense-java.io.InputStream-) method to license a component.

Calling `setLicense` multiple times is not harmful, it simply wastes processor time.

Calling [setMeteredKey](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/metered/#setMeteredKey-java.lang.String-java.lang.String-) multiple times is not harmful either but wastes processor time and can accumulate consumption improperly.

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `setLicense` method in your startup code before using the GroupDocs.Viewer classes.

##### Set a License from a File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "Java" >}}

```java
String licensePath = "path to the .lic file";
License license = new License();
license.setLicense(licensePath);
```

{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "Java" >}}

```java
String licensePath = "path to the .lic file";
try (InputStream fileStream = new FileInputStream(licensePath)) {
    License license = new License();
    license.setLicense(fileStream);
}
```

{{< /tab >}}
{{< /tabs >}}

#### Apply Metered License

You can set the [Metered](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/metered) license as an alternative to license file. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered).

The following code snippet shows how to use the metered license:

{{< tabs "example3">}}
{{< tab "Java" >}}

```java
// For complete examples and data files, please go to https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java
String publicKey = ""; // Your public license key
String privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
double amountConsumed = Metered.getConsumptionQuantity();
System.out.println("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
double creditsConsumed = Metered.getConsumptionCredit();
System.out.println("Credits consumed: " + creditsConsumed);
```

{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You do not have to name the license file "GroupDocs.Viewer.lic". Feel free to rename it as you prefer, and use that name when setting the license in your application.

### "Cannot find license filename" Exception

When you buy and download a license from the GroupDocs website, the license file is named "GroupDocs.Viewer.lic." Download it using your browser. Sometimes, browsers recognize it as XML and add the .xml extension, making the full file name "GroupDocs.Viewer.lic.XML" on your computer.

If Microsoft Windows is set to hide file extensions (which is the default in most installations), the license file will show as "GroupDocs.Viewer.lic" in Windows Explorer. You might assume this is the actual file name and call the `setLicense` method with "GroupDocs.Viewer.lic", but there is no such file, leading to an exception.

To fix this issue, rename the file to remove the hidden .xml extension. Additionally, we suggest disabling the "Hide extensions" option in Microsoft Windows.

## How to Evaluate GroupDocs.Viewer

You can also try GroupDocs.Viewer without buying a license.

### Free Trial

The evaluation version is identical to the purchased one; it becomes licensed once you set the license. You can set the license using methods described in the following sections of this article.

The evaluation version has the following limitations:

- Rendering is limited to the first 2 pages.
- Trial badges are added to the top of a rendered page.

### Temporary License

If you want to test GroupDocs.Viewer without the limitations of the trial version,   request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

---

## Licensing and evaluation

Path: /viewer/net/licensing-and-evaluation/

To study the system, you may want quick access to the API. To make this easier, GroupDocs.Viewer provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## How to Evaluate GroupDocs.Viewer

You can also try GroupDocs.Viewer without buying a license.

### Free Trial

The evaluation version is identical to the purchased one; it becomes licensed once you set the license. You can set the license using methods described in the following sections of this article.

The evaluation version has the following limitations:

- Rendering is limited to the first 2 pages.
- Trial badges are added to the top of a rendered page.

### Temporary License

If you want to test GroupDocs.Viewer without the limitations of the trial version,   request a 30-day Temporary License. For details, see the [Get a Temporary License](https://purchase.groupdocs.com/temporary-license) page.

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Viewer classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _GroupDocs.Viewer.dll_ file
*   The folder containing the assembly that called _GroupDocs.Viewer.dll_
*   The folder containing the entry assembly (your _.exe_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).
*   As an embedded resource
When you reference _GroupDocs.Viewer.dll_ in the application, the library is copied to your output directory (unless **Copy Local** in the properties for that entry is set to false). The easiest way to set a license is often to place the license file in the same folder as _GroupDocs.Viewer.dll_ and specify just the filename without the path.

Use the [SetLicense](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/license/setlicense/) method to license a component.

Calling `SetLicense` multiple times is not harmful, it simply wastes processor time.

Calling [SetMeteredKey](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/metered/setmeteredkey/) multiple times is not harmful either but wastes processor time and can accumulate consumption improperly.

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `SetLicense` method in your startup code before using the GroupDocs.Viewer classes.

##### Set a License from a File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "C#" >}}

```csharp
using GroupDocs.Viewer;
// ...

string licensePath = "GroupDocs.Viewer.lic";
License license = new License();
license.SetLicense(licensePath);
```

{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Dim licensePath As String = "GroupDocs.Viewer.lic"
        Dim license As License = New License()
        license.SetLicense(licensePath)
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "C#" >}}

```csharp
using System.IO;
using GroupDocs.Viewer;
// ...

string licensePath = "GroupDocs.Viewer.lic";
using (FileStream fileStream = File.OpenRead(licensePath))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```

{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Dim licensePath As String = "GroupDocs.Viewer.lic"
    
        Using fileStream As FileStream = File.OpenRead(licensePath)
            Dim license As License = New License()
            license.SetLicense(fileStream)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

#### Apply Metered License

You can set the [Metered](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/metered) license as an alternative to license file. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered).

The following code snippet shows how to use the metered license:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
// ...

string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Viewer.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Viewer.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Dim publicKey As String = "" ' Your public license key
        Dim privateKey As String = "" ' Your private license key
    
        Dim metered As Metered = New Metered()
        metered.SetMeteredKey(publicKey, privateKey)
    
        ' Get amount (MB) consumed
        Dim amountConsumed As Decimal = GroupDocs.Viewer.Metered.GetConsumptionQuantity()
        Console.WriteLine("Amount (MB) consumed: " & amountConsumed.ToString())
    
        ' Get count of credits consumed
        Dim creditsConsumed As Decimal = GroupDocs.Viewer.Metered.GetConsumptionCredit()
        Console.WriteLine("Credits consumed: " & creditsConsumed.ToString())
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

#### Apply License from an Embedded Resource

Instead of using a license file, you can install the license as an embedded resource. To do this, add a license to the project and specify the license name in the `SetLicense` method without specifying the full path to this file.

{{< alert style="info" >}}
To use the embedded license, add it to your project and set the **Build Action** property of this file to "Embedded Resource". Ensure that the license name in the embedded resources matches the string parameter of the `SetLicense` method.
{{< /alert >}}

The following code snippet shows how to use the embedded license:

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
// ...

License license = new License();
license.SetLicense("GroupDocs.Viewer.lic");
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
' ...

Module Program
    Sub Main(args As String())
        Dim license As License = New License()
        license.SetLicense("GroupDocs.Viewer.lic")
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You do not have to name the license file "GroupDocs.Viewer.lic". Feel free to rename it as you prefer, and use that name when setting the license in your application.

### "Cannot find license filename" Exception

When you buy and download a license from the GroupDocs website, the license file is named "GroupDocs.Viewer.lic." Download it using your browser. Sometimes, browsers recognize it as XML and add the .xml extension, making the full file name "GroupDocs.Viewer.lic.XML" on your computer.

If Microsoft Windows is set to hide file extensions (which is the default in most installations), the license file will show as "GroupDocs.Viewer.lic" in Windows Explorer. You might assume this is the actual file name and call the `SetLicense` method with "GroupDocs.Viewer.lic", but there is no such file, leading to an exception.

To fix this issue, rename the file to remove the hidden .xml extension. Additionally, we suggest disabling the **Hide extensions** option in Microsoft Windows.


---

## Licensing and evaluation

Path: /viewer/nodejs-java/licensing-and-evaluation/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Viewer provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## Purchased License

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/viewer/nodejs-java) page.

{{< /alert >}}

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Viewer classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _GroupDocs.Viewer.dll_ file
*   The folder containing the assembly that called _GroupDocs.Viewer.dll_
*   The folder containing the entry assembly (your _.exe_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

When you reference _GroupDocs.Viewer.dll_ in the application, the library is copied to your output directory (unless **Copy Local** in the properties for that entry is set to false). The easiest way to set a license is often to place the license file in the same folder as _GroupDocs.Viewer.dll_ and specify just the filename without the path.

Use the [setLicense](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/license/#setLicense-java.io.InputStream-) method to license a component.

{{< alert style="info" >}}

The license can be set multiple times per application domain, but we recommend doing it once since all the subsequent calls to the `setLicense` method except for the first one will just waste processor time.

{{< /alert >}}

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `setLicense` method in your startup code before using the GroupDocs.Viewer classes.

##### Set a License from a File

The following code snippet shows how to set a license from a file:

{{< tabs "set-license-from-file">}}
{{< tab "JavaScript" >}}
```js
import { License } from '@groupdocs/groupdocs.viewer';
import { existsSync } from 'fs';

// Path to the license file
const licensePath = 'GroupDocs.Viewer.lic';

// Check if license file exists
if (!existsSync(licensePath)) {
    console.log('License file not found. Running in evaluation mode.');
    process.exit(0);
}

// Create a License object and set the license
const license = new License();
license.setLicense(licensePath);

console.log('License set successfully.');

// Terminate the process with a success exit code
process.exit(0);
```
{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "set-license-from-stream">}}
{{< tab "JavaScript" >}}
```js
import { License } from '@groupdocs/groupdocs.viewer';
import java from 'java';
import { existsSync } from 'fs';

// Create a reference to Java's FileInputStream class
let InputStream = java.import('java.io.FileInputStream');

// Path to the license file
const licensePath = 'GroupDocs.Viewer.lic';

// Check if license file exists
if (!existsSync(licensePath)) {
    console.log('License file not found. Running in evaluation mode.');
    process.exit(0);
}

// Initialize a FileInputStream for the license file
const stream = new InputStream(licensePath);

// Create a License object and set the license using the InputStream
const license = new License();
license.setLicense(stream);

console.log('License set successfully.');

// Terminate the process with a success exit code
process.exit(0);
```
{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You do not have to name the license file "GroupDocs.Viewer.lic". Feel free to rename it as you prefer, and use that name when setting the license in your application.

### "Cannot find license filename" Exception

When you buy and download a license from the GroupDocs website, the license file is named "GroupDocs.Viewer.lic." Download it using your browser. Sometimes, browsers recognize it as XML and add the .xml extension, making the full file name "GroupDocs.Viewer.lic.XML" on your computer.

If Microsoft Windows is set to hide file extensions (which is the default in most installations), the license file will show as "GroupDocs.Viewer.lic" in Windows Explorer. You might assume this is the actual file name and call the `setLicense` method with "GroupDocs.Viewer.lic", but there is no such file, leading to an exception.

To fix this issue, rename the file to remove the hidden .xml extension. Additionally, we suggest disabling the "Hide extensions" option in Microsoft Windows.

## How to Evaluate GroupDocs.Viewer

You can also try GroupDocs.Viewer without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in several ways that are described in the next sections of this article.

The evaluation version comes with the following limitations:

- Only the first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Viewer without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.
---

## Licensing and evaluation

Path: /viewer/python-net/licensing-and-evaluation/


To help you quickly explore library and its features, GroupDocs.Viewer provides a Free Trial and a 30-day Temporary License for evaluation, as well as various purchase plans.

Sometimes, to get familiar with the system quickly, you may want to dive into the code right away. To make this easier, GroupDocs.Viewer offers a Free Trial and a 30-day Temporary License for evaluation, along with various purchase plans.

{{< alert style="info" >}}
Please note that general policies and practices guide you on evaluating, licensing, and purchasing our products. See the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies/) section for details.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Viewer without purchasing a license.

### Free Trial

The evaluation version is identical to the full version — it simply becomes fully licensed when you apply a license. Instructions for setting a license are provided in the following sections.

The evaluation version has the following limitations:
* Only the first three pages are processed.
* Documents with more than three pages are not supported.
* A trial watermark is placed at the top of each page.

### Temporary License

If you'd like to test GroupDocs.Viewer without the limitations of the trial version, you can request a 30-day Temporary License. For more information, see the [Get a Temporary License](https://purchase.groupdocs.com/temporary-license) page.

## How to Set Up a License

{{< alert style="info" >}}
For information on pricing, visit the [Pricing Information](https://purchase.groupdocs.com/pricing/) page.
{{< /alert >}}

Once you’ve obtained a license, follow these instructions to set it up. 

A license should be set:
- Only once per application, and
- Before using any other GroupDocs.Viewer classes.

{{< alert style="tip" >}}
Though the license can be set multiple times per application, it is recommended to set it only once, as repeated calls to the `set_license` method will use unnecessary processing time.
{{< /alert >}}

### Set Environment Variable

You can set the `GROUPDOCS_LIC_PATH` environment variable to the absolute path of the license file. GroupDocs.Viewer will then read this value and apply the license.

{{< tabs "set-license-env-var">}}
{{< tab "Windows (Command Prompt)" >}}
```ps
set GROUPDOCS_LIC_PATH "C:\path\to\your\license\file.lic"
```
{{< /tab >}}
{{< tab "Windows (Powershell)" >}}
```ps
$env:GROUPDOCS_LIC_PATH="C:\path\to\your\license\file.lic"
```
{{< /tab >}}
{{< tab "Linux" >}}
```bash
export GROUPDOCS_LIC_PATH="/path/to/your/license/file.lic"
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
export GROUPDOCS_LIC_PATH="/path/to/your/license/file.lic"
```
{{< /tab >}}
{{< /tabs >}}

### Copy License into Project Root Folder

GroupDocs.Viewer can also read a license from the project's root directory. Consider a simple Python app structure:

```Directory
📂 my-app
 ├──app.py
 ├──source.docx
 ├──groupdocs-viewer-net-25.12-py3-none-*.whl
 └──GroupDocs.Viewer.lic
```

When you run the application from the `my-app` folder, GroupDocs.Viewer will check for files with a `.lic` extension in this folder. It will read the `GroupDocs.Viewer.lic` file to apply the license.

### Set License from a File

The following code demonstrates setting a license from a file:

```python
import os
from groupdocs.viewer import License

def set_license_from_file():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Viewer.lic")

    # Check if license file exists
    if not os.path.exists(license_path):
        print(f"License file not found at: {license_path}")
        return

    # Instantiate License and set the license
    license = License()
    license.set_license(license_path)

if __name__ == "__main__":
    set_license_from_file()
```

### Set License from a Stream

This example shows how to set a license from a stream:

```python
import os
from groupdocs.viewer import License

def set_license_from_stream():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Viewer.lic")

    # Check if license file exists
    if not os.path.exists(license_path):
        print(f"License file not found at: {license_path}")
        return

    # Create a readable steam
    with open(license_path, "rb") as license_stream:
        # Instantiate License and set the license
        license = License()
        license.set_license(license_stream)

if __name__ == "__main__":
    set_license_from_stream()
```

### Set Metered License

A [Metered License](https://purchase.groupdocs.com/faqs/licensing/metered/) is also available as an alternative to a traditional license file. It is a usage-based licensing model that may be more suitable for customers who prefer to be billed based on actual API feature usage.

The following sample demonstrates how to use metered licensing:

```python
from groupdocs.viewer import Metered

def set_metered_license():
    # Set your public and private keys
    public_key = "******" 
    private_key = "******" 

    # Check if keys are set
    if not public_key or public_key == "******" or not private_key or private_key == "******":
        print("Please set your public and private keys")
        return

    # Instantiate Metered and set keys
    metered = Metered()
    metered.set_metered_key(public_key, private_key)

    # Get a number of MBs processed 
    mb_processed = metered.get_consumption_quantity()
    print("MB processed: ", mb_processed)

    # Get a number of credits used
    credits_used = metered.get_consumption_credit()
    print("Credits used: ", credits_used)

if __name__ == "__main__":
    set_metered_license()
```
---

## Licensing and evaluation

Path: /watermark/net/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Watermark without the license. The usage and functionalities are pretty much same as the licensed one, however you will face a few limitations while using the non-licensed API.{{< /alert >}}

You can easily download GroupDocs.Watermark for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| API Feature | Limitation |
| --- | --- |
| Document loading | Only 10 documents can be loaded per application run.    |
| Watermark search/removing | Removing/replacing of document parts is not allowed in evaluation mode.  |
| Watermark adding | Only 1 watermark can be added to a document per editing session.  |
| Document saving | Evaluation warning watermark will be added to a document.  |

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Watermark API if you want to avoid its evaluation limitations.

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Watermark.dll file and specify the file name, without a path, as shown in the examples below.

### Setting license from file

The code below will explain how to [set](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.license/setlicense/methods/1) product [license](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/license) from a file.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-.NET
//initialize License
License lic = new License();

//Set license
lic.SetLicense("GroupDocs.Watermark.lic");
```

### Setting license from stream

The following example shows how to [load](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/license/methods/setlicense) a [license](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/license) from a stream.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-.NET
using (FileStream fileStream = new FileStream("GroupDocs.Watermark.lic", FileMode.Open, FileAccess.Read))
{
    License lic = new License();
    lic.SetLicense(fileStream);
}
```

{{< alert style="info" >}}
Calling [License.SetLicense](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.license/setlicense/methods/1) multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Watermark classes.

When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application\_Start protected method. It is called once when the application starts. Do not call License.SetLicense from within Page\_Load methods since it means the license will be loaded every time a web page is loaded.
{{< /alert >}}

### Setting metered license

You can also set [Metered](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

Here are the simple steps to use the [Metered](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered) class.

1. Create an instance of [Metered](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered) class.
2. Pass public & private keys to [SetMeteredKey](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered/methods/setmeteredkey) method.
3. Do processing (perform task).
4. Call method [GetConsumptionQuantity](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered/methods/getconsumptionquantity) of the [Metered](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered) class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. Call method [GetConsumptionCredit](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered/methods/getconsumptioncredit) of the [Metered](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/metered) class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use Metered class.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-.NET
string PublicKey = ""; // Your public license key
string PrivateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(PublicKey, PrivateKey);

// Get amount (MB) consumed
decimal amountConsumed = Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

---

## Licensing and evaluation

Path: /watermark/python-net/licensing-and-evaluation/


To study the system, you may want quick access to the API. To make this easier, GroupDocs.Watermark provides different plans for purchase and offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}

Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies) section.

{{< /alert >}}

## Purchased License

After buying, apply the license file or include it as an embedded resource. 

License needs to be set:
- Only once per application domain
- Before using any other GroupDocs.Watermark classes
    
### License Applying Options

Licenses can be applied from different locations:

*   Explicit path
*   The folder containing the _GroupDocs.Watermark.dll_ file
*   The folder containing the assembly that called _GroupDocs.Watermark.dll_
*   The folder containing the entry assembly (your _.exe_)
*   As a Metered License that allows you to pay for your usage. For details, see the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

When you reference _GroupDocs.Watermark.dll_ in the application, the library is copied to your output directory (unless **Copy Local** in the properties for that entry is set to false). The easiest way to set a license is often to place the license file in the same folder as _GroupDocs.Watermark.dll_ and specify just the filename without the path.

Use the [setLicense](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/license/setlicense/) method to license a component.

Calling `setLicense` multiple times is not harmful, it simply wastes processor time.

Calling [setMeteredKey](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/metered/setmeteredkey/) multiple times is not harmful either but wastes processor time and can accumulate consumption improperly.

#### Apply the License

After obtaining the license, set it. This section explains how to do this. When developing your application, call the `setLicense` method in your startup code before using the GroupDocs.Watermark classes.

##### Set a License from a File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "Python" >}}

```python
def run():
    if os.path.exists("path to .lic file"):    
        license = gv.License()
        license.set_license("path to .lic file")
        print("License set successfully.")
    else:
       print("\n")
```

{{< /tab >}}
{{< /tabs >}}

##### Set a License from a Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "Python" >}}

```python
if os.path.exists("path to .lic file"):
        with open("path to .lic file", "rb") as stream:
            gv.License().set_license(stream)

        print("License set successfully.")
    else:
        print("\n")
```

{{< /tab >}}
{{< /tabs >}}

### Changing the License File Name

You do not have to name the license file "GroupDocs.Watermark.lic". Feel free to rename it as you prefer, and use that name when setting the license in your application.

### "Cannot find license filename" Exception

When you buy and download a license from the GroupDocs website, the license file is named "GroupDocs.Watermark.lic." Download it using your browser. Sometimes, browsers recognize it as XML and add the .xml extension, making the full file name "GroupDocs.Watermark.lic.XML" on your computer.

If Microsoft Windows is set to hide file extensions (which is the default in most installations), the license file will show as "GroupDocs.Watermark.lic" in Windows Explorer. You might assume this is the actual file name and call the `setLicense` method with "GroupDocs.Watermark.lic", but there is no such file, leading to an exception.

To fix this issue, rename the file to remove the hidden .xml extension. Additionally, we suggest disabling the "Hide extensions" option in Microsoft Windows.

## How to Evaluate GroupDocs.Watermark

You can also try GroupDocs.Watermark without buying a license.

### Free Trial

The evaluation version is identical to the purchased one; it becomes licensed once you set the license. You can set the license using methods described in the following sections of this article.

The evaluation version has the following limitations:

- Rendering is limited to the first 2 pages.
- Trial badges are added to the top of a rendered page.

### Temporary License

If you want to test GroupDocs.Watermark without the limitations of the trial version,   request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.
---

## Licensing and Subscription

Path: /editor/java/licensing-and-subscription/


Sometimes, in order to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Editor provides different plans for purchase or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Editor without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Only first 2 pages are processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Editor without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Editor API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Editor.dll file and specify the file name, without a path, as shown in the examples below.

### Setting License from File

The code below will explain how to set product license.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java
// Setup license.
License license = new License();
license.setLicense(licensePath);
```

### Setting License from Stream

The following example shows how to load a license from a stream.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java
try (InputStream fileStream = new FileInputStream("GroupDocs.Editor.lic")) {
	License license = new License();
	license.setLicense(fileStream);
}
```

{{< alert style="info" >}}Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Editor classes. When developing an Java application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application_Start protected method. It is called once when the application starts.Do not call License.SetLicense from within Page_Load methods since it means the license will be loaded every time a web page is loaded.{{< /alert >}}

### Setting Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1. Create an instance of `Metered` class.
2. Pass public & private keys to `setMeteredKey` method.
3. Do processing (perform task).
4. call method `getConsumptionQuantity` of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. call method `getConsumptionCredit` of the `Metered` class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java
String publicKey = ""; // Your public license key
String privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
double amountConsumed = com.groupdocs.editor.license.Metered.getConsumptionQuantity();
System.out.println("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
double creditsConsumed = com.groupdocs.editor.license.Metered.getConsumptionCredit();
System.out.println("Credits consumed: " + creditsConsumed);
```

---

## Licensing and Subscription

Path: /editor/net/licensing-and-subscription/


Sometimes, in order to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Editor provides different plans for purchase or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Editor without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Only first 2 pages are processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Editor without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Editor API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Editor.dll file and specify the file name, without a path, as shown in the examples below.

### Setting License from File

The code below will explain how to set product license.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET
// Setup license.
License license = new License();
license.SetLicense(licensePath);
```

### Setting License from Stream

The following example shows how to load a license from a stream.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET
using (FileStream fileStream = File.OpenRead("GroupDocs.Editor.lic"))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```

{{< alert style="info" >}}Calling [License](https://reference.groupdocs.com/editor/net/groupdocs.editor/license).[SetLicense](https://reference.groupdocs.com/editor/net/groupdocs.editor/license/setlicense) multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Editor classes.  
When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application\_Start protected method. It is called once when the application starts.  
Do not call [License](https://reference.groupdocs.com/editor/net/groupdocs.editor/license).[SetLicense](https://reference.groupdocs.com/editor/net/groupdocs.editor/license/setlicense) from within Page\_Load methods since it means the license will be loaded every time a web page is loaded.
{{< /alert >}}

### Setting Metered License

{{< alert style="info" >}}You can also set [Metered](https://reference.groupdocs.com/editor/net/groupdocs.editor/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.{{< /alert >}}
Here are the simple steps to use the `Metered` class.

1. Create an instance of [Metered](https://reference.groupdocs.com/editor/net/groupdocs.editor/metered) class.
2. Pass public & private keys to [SetMeteredKey](https://reference.groupdocs.com/editor/net/groupdocs.editor/metered/setmeteredkey) method.
3. Do processing (perform task).
4. call method [GetConsumptionQuantity](https://reference.groupdocs.com/editor/net/groupdocs.editor/metered/getconsumptionquantity) of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. call method [GetConsumptionCredit](https://reference.groupdocs.com/editor/net/groupdocs.editor/metered/getconsumptioncredit) of the [Metered](https://reference.groupdocs.com/editor/net/groupdocs.editor/metered) class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use [Metered](https://reference.groupdocs.com/editor/net/groupdocs.editor/metered) class.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Editor.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Editor.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

---

## Licensing and Subscription

Path: /editor/nodejs-java/licensing-and-subscription/


Sometimes, in order to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Editor provides different plans for purchase or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Editor without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Only first 2 pages are processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Editor without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Editor API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Editor.dll file and specify the file name, without a path, as shown in the examples below.

### Setting License from File

The code below will explain how to set product license.

```javascript
// For complete examples and data files, please go to https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java/blob/master/Examples/QuickStart/SetLicenseFromFile.js
// Setup license.
const license = new License();
// Set license
license.setLicense(LicensePath);
```

### Setting License from Stream

The following example shows how to load a license from a stream.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java/blob/master/Examples/QuickStart/SetLicenseFromStream.js
const license = new groupdocs.viewer.License()
const licenseStream = fs.createReadStream(licensePath)
    
const stream = await groupdocs.viewer.readDataFromStream(licenseStream)    
await license.setLicense(stream);
```

{{< alert style="info" >}}Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Editor classes. When developing an Node.js application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application_Start protected method. It is called once when the application starts.Do not call License.SetLicense from within Page_Load methods since it means the license will be loaded every time a web page is loaded.{{< /alert >}}

### Setting Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1. Create an instance of `Metered` class.
2. Pass public & private keys to `setMeteredKey` method.
3. Do processing (perform task).
4. call method `getConsumptionQuantity` of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. call method `getConsumptionCredit` of the `Metered` class.
7. It will return the credit that you have consumed so far.
---

## Install GroupDocs.Conversion for .NET on Linux

Path: /conversion/net/installation-linux/


This article explains how to install and run **GroupDocs.Conversion for .NET** on a Linux-based system using .NET 6+. It also includes instructions for installing native dependencies that might be required when running in a headless environment.

## Prerequisites

Ensure the following tools and packages are installed:

- .NET 6.0 SDK or later: [Install .NET on Linux](https://learn.microsoft.com/en-us/dotnet/core/install/linux)
- A Linux distribution such as Ubuntu, Debian, CentOS/RHEL, or Alpine
- `libgdiplus`, `fontconfig`, and TrueType fonts

## Installing Dependencies

### Ubuntu / Debian

Ensure the multiverse repository is enabled:

```bash
sudo add-apt-repository multiverse
sudo apt update
```

Install the required packages:

```bash
sudo apt install -y libgdiplus fontconfig ttf-mscorefonts-installer
```

> `ttf-mscorefonts-installer` is in the multiverse repository and downloads Microsoft fonts.

### CentOS / RHEL

Enable EPEL repository and install required packages:

```bash
sudo yum install -y epel-release
sudo yum install -y libgdiplus fontconfig cabextract
```

To install Microsoft TrueType fonts:

```bash
wget https://downloads.sourceforge.net/project/mscorefonts2/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm
sudo yum install -y msttcore-fonts-installer-2.6-1.noarch.rpm
```

> Note: This method uses a third-party RPM for Microsoft fonts. You may need `--nogpgcheck` depending on your system configuration.

### Alpine Linux

Install minimal dependencies using `apk`:

```bash
apk add --no-cache libgdiplus fontconfig ttf-dejavu
```

> `ttf-dejavu` provides good font compatibility in Alpine.

## Install GroupDocs.Conversion using .NET CLI

In your project directory:

```bash
dotnet add package GroupDocs.Conversion
dotnet restore
```

## Run Your Project

Build and run your project:

```bash
dotnet run
```

## Troubleshooting

- If you encounter `System.DllNotFoundException`, check if `libgdiplus` is installed.
- If fonts are missing or rendered incorrectly, verify fonts are present and accessible.

---

For Docker-specific environments, see:

- [Build in Docker](https://docs.groupdocs.com/conversion/net/build-in-docker/)
- [Build in Docker - Alpine Linux](https://docs.groupdocs.com/conversion/net/build-in-docker-alpine-linux/)

---

## Install GroupDocs.Markdown for .NET on Linux

Path: /markdown/net/installation-linux/


This article explains how to install and run **GroupDocs.Markdown for .NET** on Linux. GroupDocs.Markdown NuGet package references all required native libraries. 

## Prerequisites

Install the .NET SDK (6.0 or later) for your distribution. See [Install .NET on Linux](https://learn.microsoft.com/en-us/dotnet/core/install/linux) for instructions.

## Install the Package

Create a new project or navigate to an existing one, then add the package:

```bash
dotnet new console -n MarkdownDemo
cd MarkdownDemo
dotnet add package GroupDocs.Markdown
```

## Run Your Application

```bash
dotnet run
```

## Docker

GroupDocs.Markdown runs in Docker containers with no additional dependencies beyond the .NET runtime.

### Example Dockerfile

```dockerfile
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app
COPY . .
RUN dotnet publish -c Release -o /publish

FROM mcr.microsoft.com/dotnet/runtime:8.0
WORKDIR /app
COPY --from=build /publish .
ENTRYPOINT ["dotnet", "MarkdownDemo.dll"]
```

### Build and Run

```bash
docker build -t markdown-demo .
docker run --rm -v $(pwd)/files:/app/files markdown-demo
```

## Supported Distributions

GroupDocs.Markdown for .NET works on any Linux distribution that supports .NET 6.0+, including:

- Ubuntu 20.04+
- Debian 11+
- CentOS 8+, RHEL 8+
- Fedora 36+
- Alpine 3.16+
- Amazon Linux 2023

---

## Install GroupDocs.Markdown for Python via .NET on Linux

Path: /markdown/python-net/installation-linux/


This article explains how to install and run **GroupDocs.Markdown for Python via .NET** on Linux and macOS. The package bundles the .NET runtime — you do **not** need to install .NET separately. No GDI+, fonts, or other system libraries are required for Markdown conversion.

## Prerequisites

The only system-level requirement is **ICU** (International Components for Unicode), which is used by the bundled .NET runtime for text processing.

Most standard Linux distributions and non-slim Docker images already include ICU. You only need to install it on minimal or slim systems:

```bash
# Debian / Ubuntu
apt-get update && apt-get install -y libicu-dev

# Fedora / RHEL / CentOS
dnf install -y libicu

# Alpine
apk add icu-libs
```

On **macOS**, ICU is included in the OS — no extra packages are needed.

{{< alert style="warning" >}}
Do **not** set the `DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1` environment variable. GroupDocs.Markdown requires ICU for proper text processing.
{{< /alert >}}

## Install the Package

```bash
pip install groupdocs-markdown-net
```

## Verify Installation

```python
from groupdocs.markdown import MarkdownConverter

for fmt in MarkdownConverter.get_supported_formats():
    print(fmt)
```

## Docker

### Non-slim image (recommended)

Non-slim Python images (`python:3.13`) include ICU and all necessary system libraries. No additional packages are needed — just install the pip package:

```dockerfile
FROM python:3.13

RUN pip install --no-cache-dir groupdocs-markdown-net

WORKDIR /app
COPY . .
CMD ["python", "convert.py"]
```

### Slim image

Slim Python images (`python:3.13-slim`) do not include ICU. Add it as the only extra dependency:

```dockerfile
FROM python:3.13-slim

RUN apt-get update -qq \
    && apt-get install -y --no-install-recommends libicu-dev \
    && rm -rf /var/lib/apt/lists/*

RUN pip install --no-cache-dir groupdocs-markdown-net

WORKDIR /app
COPY . .
CMD ["python", "convert.py"]
```

### Slim vs non-slim comparison

| | `python:3.13` | `python:3.13-slim` |
|---|---|---|
| **Image size** | ~1 GB | ~150 MB |
| **ICU included** | Yes | No (add `libicu-dev`) |
| **Extra apt packages** | None needed | `libicu-dev` only |
| **All formats work** | Yes | Yes (with ICU) |

### Build and Run

```bash
docker build -t markdown-demo .
docker run --rm -v $(pwd)/files:/app/files markdown-demo
```

## Troubleshooting

| Problem | Cause | Fix |
|---|---|---|
| `Couldn't find a valid ICU package` | ICU libraries missing | `apt-get install -y libicu-dev` or use a non-slim Docker image |
| `DllNotFoundException: libSkiaSharp` | Stale system SkiaSharp conflicts with bundled version | Rename or remove `/usr/lib/libSkiaSharp.so` |
| `TypeLoadException` on document operations | Corrupt or incomplete install | `pip install --force-reinstall groupdocs-markdown-net` |

## Supported Distributions

GroupDocs.Markdown for Python via .NET works on any Linux distribution that supports Python 3.5+, including:

- Ubuntu 20.04+
- Debian 11+
- CentOS 8+, RHEL 8+
- Fedora 36+
- Alpine 3.16+
- Amazon Linux 2023

---

## Listening to conversion process events

Path: /conversion/net/listening/

In some cases, there is a need to monitor the conversion process and to receive updates upon a start, progress and completion of a conversion. For such situations, [**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) exposes an extension point where the client application may hook up and receive updates. 

To enable listening, follow these steps:

1.  Create your own implementation of the [IConverterListener](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.reporting/iconverterlistener) interface.
2.  Instantiate the [ConverterSettings](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertersettings) class and pass an instance of the class created in the first step.
3.  Pass the [ConverterSettings](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertersettings) object factory to the constructor of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class.
4.  Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class.

The following code snippet shows how to enable listening for GroupDocs.Conversion events:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Reporting;

IConverterListener listener = new ConverterListener();
Func<ConverterSettings> settingsFactory = () => new ConverterSettings
{
    Listener = listener
};
using (Converter converter = new Converter("sample.docx", settingsFactory))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}

public class ConverterListener : IConverterListener
{
    public void Started()
    {
        Console.WriteLine("Conversion started...");
    }
    public void Progress(byte current)
    {
        Console.WriteLine($"... {current} % ...");
    }
    public void Completed()
    {
        Console.WriteLine("... conversion completed");
    }
}
```


---

## Load document from Amazon S3 Storage

Path: /annotation/net/load-document-from-amazon-s3-storage/


The following code snippet shows how to load a document from Amazon S3 Storage:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
string key = "sample.pdf";
using (Annotator annotator = new Annotator(DownloadFile(key)))
{
	AreaAnnotation area = new AreaAnnotation()
	{
		Box = new Rectangle(100, 100, 100, 100),
		BackgroundColor = 65535,
	};
	annotator.Add(area);
	annotator.Save("result.pdf");
}

private static Stream DownloadFile(string key)
{
	AmazonS3Client client = new AmazonS3Client();
	string bucketName = "my-bucket";
	GetObjectRequest request = new GetObjectRequest
	{
		Key = key,
		BucketName = bucketName
	};
	using (GetObjectResponse response = client.GetObject(request))
	{
		MemoryStream stream = new MemoryStream();
		response.ResponseStream.CopyTo(stream);
		stream.Position = 0;
		return stream;
	}
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}NOTE: Packages AWSSDK.S3 version 3.3.104.30 and AWSSDK.Core version 3.3.103.42 should be referenced{{< /alert >}}
---

## Load document from Amazon S3 Storage

Path: /conversion/java/load-document-from-amazon-s3-storage/

The following code snippet shows how to convert a document from Amazon S3 Storage:

```java
 package com.groupdocs.conversion.examples.advanced_usage.loading.loading_documents_from_different_sources;

import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.S3Object;
import com.amazonaws.services.s3.model.S3ObjectInputStream;
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.examples.Constants;

import java.io.File;
import java.io.InputStream;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

/**
* This example demonstrates how to download document from Amazon S3 storage and convert document.
*/
public class LoadDocumentFromAmazonS3 {

    public static void run()
    {
        String key = "sample.docx";
        String convertedFile = "C:\\output\\converted.pdf"; 
        Converter converter = new Converter(downloadFile(key));
        PdfConvertOptions options = new PdfConvertOptions();
        converter.convert(convertedFile, options);

        System.out.print("\nSource document converted successfully.\nCheck output in " + convertedFile);
    }

    public static InputStream downloadFile(String key)
    {
        AWSCredentials credentials = new BasicAWSCredentials(
                "<AWS accesskey>",
                "<AWS secretkey>"
        );
        AmazonS3 s3client = AmazonS3ClientBuilder.standard()
                .withCredentials(new AWSStaticCredentialsProvider(credentials))
                .withRegion(Regions.US_EAST_2)
                .build();
        String bucketName = "my-bucket";

        S3Object s3object = s3client.getObject(bucketName, key);
        S3ObjectInputStream inputStream = s3object.getObjectContent();
        return inputStream;
    }
}
```

---

## Load file from Amazon S3 storage

Path: /conversion/net/load-file-from-amazon-s3-storage/

The following code snippet shows how to convert a file from Amazon S3 Storage:

```csharp
public static void Run()
{
    string key = "sample.docx";
    string outputFile = Path.Combine(@"c:\output" , "converted.pdf");
    using (Converter converter = new Converter(() => DownloadFile(key)))
    {
        PdfConvertOptions options = new PdfConvertOptions();
        converter.Convert(outputFile, options);
    }
}
        
public static Stream DownloadFile(string key)
{
    AmazonS3Client client = new AmazonS3Client();
    string bucketName = "my-bucket";
    GetObjectRequest request = new GetObjectRequest
    {
        Key = key,
        BucketName = bucketName
    };
    using (GetObjectResponse response = client.GetObject(request))
    {
        MemoryStream stream = new MemoryStream();
        response.ResponseStream.CopyTo(stream);
        stream.Position = 0;
        return stream;
    }
}
```

---

## Load from Amazon S3 Storage

Path: /viewer/java/load-document-from-amazon-s3-storage/


{{< alert style="info" >}}

Install the [AWS Java SDK for Amazon S3 module](https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-s3/1.12.430) to use the Amazon S3 client.

{{< /alert >}}

The following code snippet shows how to load a document from Amazon S3 Storage:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.amazonaws.services.s3.AmazonS3Client;
import com.amazonaws.services.s3.model.GetObjectRequest;
import com.amazonaws.services.s3.model.S3Object;
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

AmazonS3Client client = new AmazonS3Client();
GetObjectRequest request = new GetObjectRequest("my-bucket-name", "sample.docx");
S3Object response = client.getObject(request);

try (final InputStream inputStream = response.getObjectContent();
     Viewer viewer = new Viewer(inputStream)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}


---

## Load from Amazon S3 Storage

Path: /viewer/net/load-document-from-amazon-s3-storage/

The following code snippet shows how to load a document from Amazon S3 Storage.

{{< alert style="info" >}}

Runnig this code requires installing [AWSSDK.S3](https://nuget.org/packages/AWSSDK.S3) NuGet package.

{{< /alert >}}

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using System.Threading.Tasks;
using Amazon.S3;
using Amazon.S3.Model;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

string key = "sample.docx";
Stream stream = await DownloadFileAsync(key);

using (Viewer viewer = new Viewer(stream))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}

static async Task<Stream> DownloadFileAsync(string key)
{
    AmazonS3Client client = new AmazonS3Client();
    string bucketName = "my-bucket";
    GetObjectRequest request = new GetObjectRequest
    {
        Key = key,
        BucketName = bucketName
    };

    using (GetObjectResponse response = await client.GetObjectAsync(request))
    {
        MemoryStream stream = new MemoryStream();
        response.ResponseStream.CopyTo(stream);
        stream.Position = 0;
        return stream;
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports System.Threading.Tasks
Imports Amazon.S3
Imports Amazon.S3.Model
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Dim key As String = "sample.docx"
        Dim stream As Stream = DownloadFileAsync(key).GetAwaiter().GetResult()

        Using viewer As New Viewer(stream)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub

    Private Async Function DownloadFileAsync(ByVal key As String) As Task(Of Stream)
        Dim client As New AmazonS3Client()
        Dim bucketName As String = "my-bucket"
        Dim request As New GetObjectRequest With {
                .Key = key,
                .BucketName = bucketName
                }

        Using response As GetObjectResponse = Await client.GetObjectAsync(request)
            Dim stream As New MemoryStream()
            response.ResponseStream.CopyTo(stream)
            stream.Position = 0
            Return stream
        End Using
    End Function
End Module

```
{{< /tab >}}
{{< /tabs >}}


---

## Load Note document with options

Path: /conversion/net/load-note-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [NoteLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/noteloadoptions) to give you control over how the source Note document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/noteloadoptions/defaultfont)** | A default font for Note document. The specified font will be used if a font is missing. An absolute path to the font file must be provided. |
|**[FontSubstitutes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/noteloadoptions/fontsubstitutes)** | Substitutes specific fonts from the Note document. |
|**[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/noteloadoptions/password)** | A password to unlock the protected document. |

### Set Default Font

GroupDocs.Conversion for .NET allows you to set a default font name when a font is not available in the document. You can use **[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/noteloadoptions/defaultfont)** property of **[NoteLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/noteloadoptions)** class to set the default font name. In case **[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/noteloadoptions/defaultfont)** is not set the Times New Roman font will be used. The following code snippet shows how to set a default font name when converting from Note into to PDF document:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new NoteLoadOptions
{
    DefaultFont = "Helvetica"
};
using (Converter converter = new Converter("sample.one", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify font substitution

The following code snippet shows how to convert Note document and specify font substitution for missing fonts:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new NoteLoadOptions
{
    FontSubstitutes = new List<FontSubstitute>
    {
        FontSubstitute.Create("Tahoma", "Arial"),
        FontSubstitute.Create("Times New Roman", "Arial"),
    }
};
using (Converter converter = new Converter("sample.one", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

---

## Load PDF document with options

Path: /conversion/java/load-pdf-document-with-options/


The [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/) API offers advanced capabilities for loading PDF documents with customizable options. Using the [PdfLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PdfLoadOptions) class, developers can specify precise configurations, such as enabling password protection for encrypted PDFs, selectively loading specific pages, and defining other document-specific properties. This feature facilitates optimized workflows in Java applications, enabling seamless handling of diverse PDF files during conversion.

The API provides robust error handling, ensuring smooth operation when processing malformed or restricted PDF documents. Moreover, the [PdfLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PdfLoadOptions) class can be integrated with other API functionalities to support a wide range of output formats, maintaining high fidelity during the conversion process. The following options could be set:
| Option | Description |
|--------|-------------|
| [**setFormat()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PdfLoadOptions#setFormat(com.groupdocs.conversion.filetypes.PdfFileType)) | Allows you to specify explicitly the type of the source document. Available options are: *Pdf, Epub, Xps, Tex, Ps, Pcl*. |
| [**setRemoveEmbeddedFiles()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PdfLoadOptions#getRemoveEmbeddedFiles()) | Whether to remove the embedded files from the source document during the conversion. |
| [**setPassword()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PdfLoadOptions#setPassword(java.lang.String)) | Specifies a password to unlock the protected document. |
| [**setHidePdfAnnotations()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PdfLoadOptions#setHidePdfAnnotations(boolean)) | Specifies that annotations in the source document should be hidden. |
| [**setFlattenAllFields()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PdfLoadOptions#setFlattenAllFields(boolean)) | Specifies that all fields in the source document should be flattened during the conversion. |

### Flatten all fields

The following code snippet shows how to convert a PDF document and flatten all fields:

{{< tabs "code-example">}}
{{< tab "ConvertPdfAndFlattenAllFields.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
import com.groupdocs.conversion.options.load.PdfLoadOptions;

public class ConvertPdfAndFlattenAllFields {
    public static void convert() {
        PdfLoadOptions loadOptions = new PdfLoadOptions();
        loadOptions.setFlattenAllFields(true);

        try(Converter converter = new Converter("sample.pdf", () -> loadOptions)) {
            WordProcessingConvertOptions options = new WordProcessingConvertOptions();
            converter.convert("converted_with_fields.docx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.pdf" >}}  
{{< tab-text >}}
`sample.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-pdf-document-with-options/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_fields.docx" >}}  
{{< tab-text >}}
`converted_with_fields.docx` is converted DOCX document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-pdf-document-with-options/converted_with_fields.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Hide annotations

The following code snippet shows how to convert a PDF document and hide annotations:

{{< tabs "code-example1">}}
{{< tab "ConvertPdfAndHideAnnotations.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
import com.groupdocs.conversion.options.load.PdfLoadOptions;

public class ConvertPdfAndHideAnnotations {
    public static void convert() {
        PdfLoadOptions loadOptions = new PdfLoadOptions();
        loadOptions.setHidePdfAnnotations(true);

        try(Converter converter = new Converter("sample.pdf", () -> loadOptions)) {
            WordProcessingConvertOptions options = new WordProcessingConvertOptions();
            converter.convert("converted_without_annotations.docx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.pdf" >}}  
{{< tab-text >}}
`sample.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-pdf-document-with-options/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_without_annotations.docx" >}}  
{{< tab-text >}}
`converted_without_annotations.docx` is converted DOCX document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-pdf-document-with-options/converted_without_annotations.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Remove embedded files

The following code snippet shows how to convert a PDF document and remove embedded files:

{{< tabs "code-example2">}}
{{< tab "ConvertPdfAndRemoveEmbeddedFiles.java" >}}
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
import com.groupdocs.conversion.options.load.PdfLoadOptions;

public class ConvertPdfAndRemoveEmbeddedFiles {
    public static void convert() {
        PdfLoadOptions loadOptions = new PdfLoadOptions();
        loadOptions.setRemoveEmbeddedFiles(true);

        try(Converter converter = new Converter("sample.pdf", () -> loadOptions)) {
            WordProcessingConvertOptions options = new WordProcessingConvertOptions();
            converter.convert("converted_without_fields.docx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.pdf" >}}  
{{< tab-text >}}
`sample.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-pdf-document-with-options/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_without_fields.docx" >}}  
{{< tab-text >}}
`converted_without_fields.docx` is converted DOCX document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-pdf-document-with-options/converted_without_fields.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Load PDF document with options

Path: /conversion/nodejs-java/load-pdf-document-with-options/

GroupDocs.Conversion provides [PdfLoadOptions](#) to give you control over how the source PDF document will be processed. The following options could be set:

*   **[setFormat](#)** allows you to specify explicitly the type of the source document. Available options are: *Pdf, Epub, Xps, Tex, Ps, Pcl*.
*   **[setRemoveEmbeddedFiles](#)** whether to remove the embedded files from the source document during the conversion.
*   **[setPassword](#)** specifies a password to unlock the protected document.
*   **[setHidePdfAnnotations](#)** specifies that annotations in the source document should be hidden.
*   **[setFlattenAllFields](#)** specifies that all fields in the source document should be flattened during the conversion.

### Flatten all fields

The following code snippet shows how to convert a PDF document and flatten all fields:

```js
const loadOptions = new groupdocs.conversion.PdfLoadOptions()
loadOptions.setFlattenAllFields(true)

const converter = new groupdocs.conversion.Converter("sample.pdf", loadOptions)

const outputPath = "ConvertPdfAndFlattenAllFields.docx"

const convertOptions = new groupdocs.conversion.WordProcessingConvertOptions()

console.log(`Pdf document converted successfully to ${outputPath} (pdf & flatten all fields)`)
converter.convert(outputPath, convertOptions)
```

### Hide annotations

The following code snippet shows how to convert a PDF document and hide annotations:

```js
const loadOptions = new groupdocs.conversion.PdfLoadOptions()
loadOptions.setHidePdfAnnotations(true)

const converter = new groupdocs.conversion.Converter("sample.pdf", loadOptions)

const outputPath = "ConvertPdfAndHideAnnotations.docx"

const convertOptions = new groupdocs.conversion.WordProcessingConvertOptions()

console.log(`Pdf document converted successfully to ${outputPath} (pdf & hide annotations)`)
converter.convert(outputPath, convertOptions)
```

### Remove embedded files

The following code snippet shows how to convert a PDF document and remove embedded files:

```js
const loadOptions = new groupdocs.conversion.PdfLoadOptions()
loadOptions.setRemoveEmbeddedFiles(true)

const converter = new groupdocs.conversion.Converter("sample.pdf", loadOptions)

const outputPath = "ConvertPdfAndRemoveEmbeddedFiles.docx"

const convertOptions = new groupdocs.conversion.WordProcessingConvertOptions()

console.log(`Pdf document converted successfully to ${outputPath} (pdf & remove embedded files)`)
converter.convert(outputPath, convertOptions)
```

---

## Load text from string

Path: /comparison/java/load-text-from-string/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare values from the `String` type variables.

To compare text from variables, follow these steps:

1.  Instantiate the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object. Set the [LoadText](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions/#setLoadText-boolean-) property to `true` (this indicates that passed string contains text to be compared, not file path).
2.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source variable of the `String` type and the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object created in the previous step.
3.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify target variable of the `String` type and the [LoadOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.load/loadoptions) object created in the previous step.
4.  Call the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) method.
5.  Call the [getResultString](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getResultString--) method to get string with comparison result.

The following code snippet shows how to load values from variables:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.load.LoadOptions;
// ...

try (Comparer comparer = new Comparer("source text", new LoadOptions(true))) {
    comparer.add("target text", new LoadOptions(true));
    comparer.compare();
    String result = comparer.getResultString();
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/load-text-from-string.png)

The following code snippet shows how to combine the different ways of specifying documents:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.load.LoadOptions;
import java.io.FileInputStream;
import java.io.InputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream)) {
    comparer.add("target text", new LoadOptions(true));
    comparer.compare();
    String result = comparer.getResultString();
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load text from string

Path: /comparison/net/load-text-from-string/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare values from the `string` type variables.

To compare text from variables, follow these steps:

1.  Instantiate the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object. Set the [LoadText](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/loadoptions/properties/loadtext) property to `true` (this indicates that passed string contains text to be compared, not file path).
2.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source variable of the `string` type and the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object created in the previous step.
3.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify target variable of the `string` type and the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object created in the previous step.
4.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method.
5.  Call the [GetResultString](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/getresultstring) method to get string with comparison result.

The following code snippet shows how to load values from variables:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source text", new LoadOptions() { LoadText = true }))
{
    comparer.Add("target text", new LoadOptions() { LoadText = true });
    comparer.Compare();
    string result = compare.GetResultString();
    Console.WriteLine("Result string: \n" + comparer.GetResultString());
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/load-text-from-string.png)

The following code snippet shows how to combine the different ways of specifying documents:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Stream sourceStream = File.OpenRead("./source.docx"))
{
    using (Comparer comparer = new Comparer(sourceStream))
    {
        comparer.Add("target text", new LoadOptions() { LoadText = true });
        comparer.Compare();
        string result = compare.GetResultString();
        Console.WriteLine(result);
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load text from string

Path: /comparison/nodejs-java/load-text-from-string/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare values from the `String` type variables.

The following code snippet shows how to load plain text from variables and compare it as if it were document content.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Enable text mode so passed strings are treated as content, not file paths
const loadOptions = new groupdocs.LoadOptions();
loadOptions.setLoadText(true);

// Create a comparer using a source string value
const comparer = new groupdocs.Comparer('This is the original text.', loadOptions);

// Add a target string to compare against the source
comparer.add('This is the changed text.', loadOptions);

// Run the comparison and write the result to a text file
comparer.compare('result.txt');

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates how to compare plain text strings directly without using files. It creates a `LoadOptions` object and sets `setLoadText(true)` to indicate that the strings passed are text content, not file paths. The `Comparer` is initialized with a source string and the `LoadOptions`, and the target string is added with the same `LoadOptions`. The comparison is then performed and saved to a file, treating the strings as document content.

The result is as follows:

![](/comparison/nodejs-java/images/load-text-from-string.png)

The following code snippet shows how to mix a document loaded from disk with text provided directly as a string.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Configure LoadOptions to indicate that the target value is raw text
const loadOptions = new groupdocs.LoadOptions();
loadOptions.setLoadText(true);

// Load the source content from a physical text file
const comparer = new groupdocs.Comparer('sample-files/source.txt');

// Add the target content as plain text (not as a file path)
comparer.add('This is the target text to compare with the file content.', loadOptions);

// Perform comparison without saving to disk and get the result as a string
comparer.compare();
const result = comparer.getResultString();

// Print the comparison result to the console
console.log(result);

// Terminate the process with a success exit code
process.exit(0);
```

This example shows how to mix a document loaded from disk with text provided as a string. The source document is loaded from a file path (without `LoadOptions`), while the target is provided as a plain text string with `LoadOptions` that has `setLoadText(true)`. After performing the comparison, it calls `getResultString()` to retrieve the comparison result as a string instead of saving it to a file, which is useful when you need to process the result programmatically.

---

## Load text from string

Path: /comparison/python-net/load-text-from-string/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/python-net) allows you to compare values from the `String` type variables.

To compare text from variables, follow these steps:

1.  Instantiate the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object. Set the `LoadText`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions/#setLoadText-boolean-)--> property to `true` (this indicates that the passed string contains a text to be compared, not a file path).
2.  Instantiate the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> object. Specify the source variable of the `String` type and the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object created in the previous step.
3.  Call the `add()`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#add-java.lang.String-)--> method. Specify the target variable of the `String` type and the `LoadOptions`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison.options.load/loadoptions)--> object created in the previous step.
4.  Call the `Comparer`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer)--> method.
5.  Call the `getResultString`<!--](https://reference.groupdocs.com/comparison/python-net/com.groupdocs.comparison/comparer/#getResultString- -)--> method to get a string with the comparison result.

The following code snippet shows how to load values from variables:

```python
import groupdocs.comparison as gc

def load_text_from_string(output_file_path):
    # Initialize LoadOptions and set to load text
    load_options = gc.options.LoadOptions()
    load_options.load_text = True

    # Initialize comparer with the source text using LoadOptions
    with gc.Comparer("source text", load_options) as comparer:
        # Add the target text for comparison using LoadOptions
        comparer.add("target text", load_options)
        
        # Compare the texts and save the result
        comparer.compare(output_file_path)

        # Print the result string
        print("Result string: \n" + comparer.get_result_string())
    
    # Log the success message with the output file path
    print(f"\nDocuments compared successfully.\nCheck output in {output_file_path}.")
```

The result is as follows:

![](/comparison/python-net/images/load-text-from-string.png)
---

## Loading of external resources containing by a document

Path: /viewer/java/loading-external-resources/


If the document contains external resources, such as images, GroupDocs.Viewer loads them when rendering a document. This allows the document to display correctly, but is a potential security risk.

GroupDocs.Viewer allows you to manage loading of external resources contained by a document. These features are supported for the following formats:
- [Word Processing File Formats](https://docs.fileformat.com/word-processing/)
- [Web File Formats](https://docs.fileformat.com/web/)
- [SpreadSheet File Formats](https://docs.fileformat.com/spreadsheet/)

Use the [LoadOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/) object to manage loading of external resources.

## Skip loading of external resources

The following code snippet shows how to deny loading of external resources:

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
LoadOptions loadOptions = new LoadOptions();
loadOptions.setSkipExternalResources(true); // Skip loading of external resources

try (Viewer viewer = new Viewer("business-flyer.docx", loadOptions)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
val loadOptions = LoadOptions()
loadOptions.isSkipExternalResources = true // Skip loading of external resources

Viewer("business-flyer.docx", loadOptions).use { viewer ->
    val viewOptions = HtmlViewOptions.forEmbeddedResources()

    viewer.view(viewOptions)
}
```
{{< /tab >}}
{{< /tabs >}}

The following images show the output file with and without external resources (see top right corner):

| loadOptions.setSkipExternalResources(false)               | loadOptions.setSkipExternalResources(true)                  |
|-----------------------------------------------------------|-------------------------------------------------------------|
| ![False](/viewer/java/images/with-external-resources.png) | ![True](/viewer/java/images/without-external-resources.png) |

## Manage a safelist for loading external resources

The following code snippet shows how to allow loading of external resources from specific URLs:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
LoadOptions loadOptions = new LoadOptions();
loadOptions.setSkipExternalResources(true); // Skip loading of all external resources
loadOptions.getWhitelistedResources().add("avatars.githubusercontent.com"); // Enable loading of external resources that has `avatars.githubusercontent.com` fragment in resource URL.

try (Viewer viewer = new Viewer("business-flyer.docx", loadOptions)) {
   HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
val loadOptions = LoadOptions()
loadOptions.isSkipExternalResources = true // Skip loading of all external resources
loadOptions.whitelistedResources.add("avatars.githubusercontent.com") // Enable loading of external resources that has `avatars.githubusercontent.com` fragment in resource URL.

val viewer = Viewer("business-flyer.docx", loadOptions)
val viewOptions = HtmlViewOptions.forEmbeddedResources()
viewer.use {
    it.view(viewOptions)
}
```
{{< /tab >}}
{{< /tabs >}}

## Set timeout for loading of external resources

The default timeout is 10 seconds. GroupDocs.Viewer allows you to change this value.

The following code snippet shows how to set a timeout to load external resources:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// Specify a timeout.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setResourceLoadingTimeout(5000);
// Render a file.
try (Viewer viewer = new Viewer("sample.docx", loadOptions)) {
   HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
// Specify a timeout.
val loadOptions = LoadOptions()
loadOptions.setResourceLoadingTimeout(5000)
// Render a file.
Viewer("sample.docx", loadOptions).use { viewer ->
   val viewOptions = HtmlViewOptions.forEmbeddedResources()
   viewer.view(viewOptions)
}

```
{{< /tab >}}
{{< /tabs >}}

---

## Loading of external resources containing by a document

Path: /viewer/net/loading-external-resources/


If the document contains external resources, such as images, GroupDocs.Viewer loads them when rendering a document. This allows the document to display correctly, but is a potential security risk.

GroupDocs.Viewer allows you to manage loading of external resources contained by a document. These features are supported for the following formats:
- [Word Processing File Formats](https://docs.fileformat.com/word-processing/)
- [Web File Formats](https://docs.fileformat.com/web/)
- [SpreadSheet File Formats](https://docs.fileformat.com/spreadsheet/)

Use the [LoadOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions) object to manage loading of external resources.

## Skip loading of external resources

The following code snippet shows how to deny loading of external resources:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

LoadOptions loadOptions = new LoadOptions();
loadOptions.SkipExternalResources = true; // Skip loading of external resources

using (Viewer viewer = new Viewer("business-flyer.docx", loadOptions))
{
    HtmlViewOptions viewOptions = 
        HtmlViewOptions.ForEmbeddedResources();

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Dim loadOptions As LoadOptions = New LoadOptions()
        loadOptions.SkipExternalResources = True ' Skip loading of external resources
    
        Using viewer As Viewer = New Viewer("business-flyer.docx", loadOptions)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
    
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following images show the output file with and without external resources (see top right corner):

| loadOptions.SkipExternalResources = false | loadOptions.SkipExternalResources = true |
| --- | --- |
| ![False](/viewer/net/images/with-external-resources.png) | ![True](/viewer/net/images/without-external-resources.png)  |

## Manage a safelist for loading external resources

The following code snippet shows how to allow loading of external resources from specific URLs:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

LoadOptions loadOptions = new LoadOptions();
loadOptions.SkipExternalResources = true; // Skip loading of all external resources
loadOptions.WhitelistedResources.Add("avatars.githubusercontent.com"); //Enable loading of external resources that has `avatars.githubusercontent.com` fragment in resource URL. 

using (Viewer viewer = new Viewer("business-flyer.docx", loadOptions))
{
    HtmlViewOptions viewOptions = 
        HtmlViewOptions.ForEmbeddedResources();

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Dim loadOptions As LoadOptions = New LoadOptions()
        loadOptions.SkipExternalResources = True ' Skip loading of all external resources
        loadOptions.WhitelistedResources.Add("avatars.githubusercontent.com") 'Enable loading of external resources that has `avatars.githubusercontent.com` fragment in resource URL. 
    
        Using viewer As Viewer = New Viewer("business-flyer.docx", loadOptions)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
    
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Set timeout for loading of external resources

The default timeout is 30 seconds. GroupDocs.Viewer allows you to change this value.

The following code snippet shows how to set a timeout to load external resources:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Specify a timeout.
LoadOptions loadOptions = new LoadOptions();
loadOptions.ResourceLoadingTimeout = TimeSpan.FromSeconds(5);
// Render a file.
using (Viewer viewer = new Viewer("sample.docx", loadOptions))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Specify a timeout.
        Dim loadOptions As LoadOptions = New LoadOptions()
        loadOptions.ResourceLoadingTimeout = TimeSpan.FromSeconds(5)
        ' Render a file.
        Using viewer As Viewer = New Viewer("sample.docx", loadOptions)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Logging

Path: /conversion/java/logging/

[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) provides logging capabilities to track the application's behavior, debug issues, and record important events. You can use the built-in [ConsoleLogger](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.logging/consolelogger/) class to log to the console or implement a custom logger using the [ILogger](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.logging/ilogger/) interface for other logging targets such as files, streams, or external systems.

## Log Message Types
The log messages generated by the library are categorized as follows:
- **Error** - for unrecoverable exceptions
- **Warning** - for recoverable or expected exceptions.
- **Trace** - for general application flow and informational messages.

## Logging to the Console
The [ConsoleLogger](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.logging/consolelogger/) class is a ready-to-use implementation of [ILogger](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.logging/ilogger/) that writes log messages to the standard console output.

{{< tabs "code-example">}}
{{< tab "LogToConsole.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.ConverterSettings;
import com.groupdocs.conversion.logging.ConsoleLogger;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class LogToConsole {
    public static void convert() {
        // Create ConsoleLogger instance
        ConsoleLogger logger = new ConsoleLogger();

        // Configure ConverterSettings with the logger
        ConverterSettings settingsFactory = new ConverterSettings();
        settingsFactory.setLogger(logger);

        // Initialize the Converter with settings
        try (Converter converter = new Converter("formatting.docx", ()-> settingsFactory)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "formatting.docx" >}}  
{{< tab-text >}}
`formatting.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/logging/formatting.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "Console output" >}}  
{{< tab-text >}}
```
[TRACE] Determine loaded for source document formatting.docx ...
[TRACE] ... loader selected.
[TRACE] Loading source document formatting.docx ...
[TRACE] ... document loaded.
[TRACE] Main document will be converted.
[TRACE] Starting conversion of formatting.docx...
[TRACE]  ... pipeline selected ... 
[TRACE]  ... conversion completed.
```
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


## Implementing custom logger

To log to a file or other destinations, you can create a custom logger by implementing the [ILogger](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.logging/ilogger/) interface.

{{< tabs "code-example1">}}
{{< tab "File Logger Implementation" >}}  
```java
import com.groupdocs.conversion.logging.ILogger;
import java.io.FileWriter;
import java.io.IOException;

public class CustomFileLogger implements ILogger {

    private final String fileName;

    public CustomFileLogger(String fileName) {
        this.fileName = fileName;
    }

    @Override
    public void trace(String message) {
        writeToFile("[TRACE] " + message);
    }

    @Override
    public void warning(String message) {
        writeToFile("[WARN] " + message);
    }

    @Override
    public void error(String message, Exception exception) {
        writeToFile("[ERROR] " + message + ", Exception: " + exception.getMessage());
    }

    private void writeToFile(String content) {
        try (FileWriter writer = new FileWriter(fileName, true)) {
            writer.write(content + System.lineSeparator());
        } catch (IOException e) {
            throw new RuntimeException("Failed to write log message", e);
        }
    }
}
```
{{< /tab >}}
{{< tab "Using Custom File Logger" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.ConverterSettings;
import com.groupdocs.conversion.logging.ILogger;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

public class LogToCustom {
    public static void convert() {
        // Initialize custom file logger
        CustomFileLogger logger = new CustomFileLogger("log.txt");

        // Configure ConverterSettings with the custom logger
        ConverterSettings settingsFactory = new ConverterSettings();
        settingsFactory.setLogger(logger);

        // Initialize the Converter with settings
        try (Converter converter = new Converter("formatting.docx", ()-> settingsFactory)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "formatting.docx" >}}  
{{< tab-text >}}
`formatting.docx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/logging/formatting.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "log.txt" >}}  
{{< tab-text >}}
`log.txt` is output custom log file. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/logging/log.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

This flexibility ensures you can monitor the application's behavior and adapt logging to meet specific requirements.
---

## Logging and Diagnostics

Path: /conversion/python-net/developer-guide/logging-and-diagnostics/


To enable logging, use either the `ConsoleLogger` or `FileLogger` class. There are three types of log messages:

- **Error**: for critical exceptions that prevent execution.
- **Warning**: for recoverable or expected issues.
- **Trace**: for general informational messages.

## Example 1: Write Logs to Console

To enable logging to sconsole, use the `ConsoleLogger` class as shown below:

{{< tabs "code-example-1">}}
{{< tab "write_logs_to_console.py" >}}  
```python
from groupdocs.conversion import Converter, ConverterSettings
from groupdocs.conversion.logging import ConsoleLogger
from groupdocs.conversion.options.convert import PdfConvertOptions

def write_logs_to_console():
    # Create a console logger
    console_logger = ConsoleLogger()

    # Create converter settings and pass logger 
    converter_settings = ConverterSettings()
    converter_settings.logger = console_logger

    # Load DOCX document and convert it to PDF
    with Converter("./business-plan.docx", converter_settings) as converter:
        pdf_convert_options = PdfConvertOptions()
        converter.convert("./business-plan.pdf", pdf_convert_options)    

if __name__ == "__main__":
    write_logs_to_console()
```
{{< /tab >}}
{{< tab "Expected Output" >}}  
```yaml
[TRACE] Attempting to read the 'GROUPDOCS_LIC_PATH' environment variable for license file location.
[TRACE] GroupDocs license has been set successfully.
[TRACE] Determine loader for source document business-plan.docx ...
[TRACE] ... loader selected.
[TRACE] Loading source document business-plan.docx ...
[TRACE] ... document loaded.
[TRACE] Main document will be converted.
[TRACE] Starting conversion of business-plan.docx...
[TRACE]  ... converter selected ... 
[TRACE]  ... conversion completed.
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/logging-and-diagnostics/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is converted file. Click [here](/conversion/python-net/_sample_files/developer-guide/logging-and-diagnostics/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation

1. `console_logger` is created to facilitate logging. This logger sends log messages to the console.
2. `converter_settings` is instantiated, with its `logger` attribute set to the previously created `console_logger`.
3. A `Converter` object is instantiated with the configured `converter_settings`.
4. The `convert` method is called and the conversion occurs, log messages are generated and displayed in the console.

## Example 2: Write Logs to File

The following code demonstrates how to use `FileLogger` class and write logs to a text file:

{{< tabs "code-example-2">}}
{{< tab "write_logs_to_console.py" >}}  
```python
from groupdocs.conversion import Converter, ConverterSettings
from groupdocs.conversion.logging import FileLogger
from groupdocs.conversion.options.convert import PdfConvertOptions

def write_logs_to_file():
    # Set log file path and create logger
    log_file_path = "./log.txt"
    file_logger = FileLogger(log_file_path)

    # Create converter settings and pass logger 
    converter_settings = ConverterSettings()
    converter_settings.logger = file_logger

    # Load DOCX document and convert it to PDF
    with Converter("./business-plan.docx", converter_settings) as converter:
        pdf_convert_options = PdfConvertOptions()
        converter.convert("./business-plan.pdf", pdf_convert_options)    

if __name__ == "__main__":
    write_logs_to_file()
```
{{< /tab >}}
{{< tab "log.txt" >}}  
```
2024-11-04 12:15:05 [TRACE] Attempting to read the 'GROUPDOCS_LIC_PATH' environment variable for license file location.
2024-11-04 12:15:05 [TRACE] GroupDocs license has been set successfully.
2024-11-04 12:15:05 [TRACE] Determine loader for source document business-plan.docx ...
2024-11-04 12:15:05 [TRACE] ... loader selected.
2024-11-04 12:15:05 [TRACE] Loading source document business-plan.docx ...
2024-11-04 12:15:06 [TRACE] ... document loaded.
2024-11-04 12:15:06 [TRACE] Main document will be converted.
2024-11-04 12:15:06 [TRACE] Starting conversion of business-plan.docx...
2024-11-04 12:15:06 [TRACE]  ... converter selected ... 
2024-11-04 12:15:09 [TRACE]  ... conversion completed.
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is the sample file used in this example. Click [here](/conversion/python-net/_sample_files/developer-guide/logging-and-diagnostics/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is converted file. Click [here](/conversion/python-net/_sample_files/developer-guide/logging-and-diagnostics/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Explanation

1. `file_logger` is created to facilitate logging. This logger writes log messages to the `log.txt` file.
2. `converter_settings` is instantiated, with its `logger` attribute set to the previously created `file_logger`.
3. A `Converter` object is instantiated with the configured `converter_settings`.
4. The `convert` method is called and the conversion occurs, log messages are generated and written to the text file.
---

## Migration notes

Path: /conversion/java/migration-notes/

## Why migrate?
  
Here are the key reasons to use the new updated API provided by GroupDocs.Conversion for Java since version 20.2:

* The [**Converter**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/Converter) class was introduced as a **single entry point** to manage the document conversion process to any supported file format (instead of the **ConversionHander** class from previous versions).
* The overall **conversion speed improved** dramatically by saving each page as soon as it was converted, not when all pages list were converted.
* Product architecture was redesigned from scratch in order to **decrease memory usage** (from 10% to 400% approx. depending on the document type).
* Document **conversion options were simplified** for easy control over document conversion and saving processes. 

## How to migrate?

Here is a brief comparison of how to convert a document into PDF format using old API and new one.  

**Old coding style**

```java
String documentPath = "sample.docx";
String outputPath = "C:\\output\\converted.pdf";

//Instantiating the conversion handler
ConversionHandler conversionHandler = Common.getConversionHandler();

SaveOptions saveOptions = new PdfSaveOptions();
saveOptions.setConvertFileType(PdfFileType.Pdf);
  
ConvertedDocument convertedDocumentPath = conversionHandler.convert(documentPath , saveOptions);
convertedDocumentPath.save("C:\\output\\converted.pdf");
```

**New coding style**

```java
String documentPath = "C:\\sample.docx"; 
String outputPath = "C:\\output\\converted.pdf";
  
try(Converter converter = new Converter(documentPath))
{
    PdfConvertOptions convertOptions = new PdfConvertOptions();
    converter.Convert(outputPath, convertOptions);
}
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "conversion/java/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java) samples and showcases.

---

## Migration Notes

Path: /comparison/java/migration-notes/


## Why To Migrate?

Here are the key reasons to use the new updated API provided by **[GroupDocs.Comparison for Java](https://products.groupdocs.com/comparison/java)** since version 20.4:

- **Comparer** class introduced as a **single entry point** to compare documents of any supported file format with various options and ability to accept/reject found differences in resultant document.
- Document **compare options** for all document types. Instead of using document related options now options are related to compare type only.
- The overall document related classes were unified to common.
- Product architecture was redesigned from scratch in order to simplify passing options and classes to manipulate comparison.
- Document information and preview generation procedures were simplified.

## How To Migrate? 

Here is a brief comparison of how to compare document with old and new API.

**Old coding style**

<script src="https://gist.github.com/groupdocs-comparison-gists/e2edd2208e2c0cec2a3807160d850c0e.js"></script>

**New coding style**

<script src="https://gist.github.com/groupdocs-comparison-gists/2d026c76b30856c2e86c0a27df28b236.js"></script>

---

## Migration Notes

Path: /conversion/net/migration-notes/

## Why To Migrate?
  
Here are the key reasons to use the new updated API provided by GroupDocs.Conversion for .NET since version 19.9:

* **Converter** class introduced as a **single entry point** to manage the document conversion process to any supported file format (instead of **ConversionHander** class from previous versions). 
* The overall **conversion speed improved** dramatically by saving each page as soon as it was converted, not when all pages list were converted.
* Product architecture was redesigned from scratch in order to **decreased memory usage** (from 10% to 400% approx. depending on document type).
* Document **convert options simplified** for easy control over document conversion and saving processes.  

## How To Migrate?

Here is a brief comparison of how to convert document into PDF format using old API and new one.  

**Old coding style**

```csharp
string documentPath = "sample.docx";
string outputPath = @"C:\output\converted.pdf";

//Instantiating the conversion handler
ConversionHandler conversionHandler = Common.getConversionHandler();

var saveOptions = new GroupDocs.Conversion.Converter.Option.PdfSaveOptions();
saveOptions.ConvertFileType = PdfSaveOptions.PdfFileType.Pdf;
 
var convertedDocumentPath = conversionHandler.Convert(documentPath , saveOptions);
convertedDocumentPath.Save(@"C:\output\converted.pdf");
```

**New coding style**

```csharp
string documentPath = @"C:\sample.docx"; 
string outputPath = @"C:\output\converted.pdf";
 
using (Converter converter = new Converter(documentPath))
{
    PdfConvertOptions convertOptions = new PdfConvertOptions();
    converter.Convert(outputPath, convertOptions);
}
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "conversion/net/developer-guide/_index.md" >}}) or [GitHub](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET) samples and showcases.

---

## Multicolored Numbered List in Email Document

Path: /assembly/java/multicolored-numbered-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Email Document format.{{< /alert >}}

## Multicolored Numbered List in Email Document

### Creating a Multicolored Numbered List

Practicing the following steps you can create Multicolored Numbered List Template in MS Outlook 2013.

1.  In your email, write a sentence like "We provide support for the following clients:".
2.  Start numbered list.
3.  Go to the "Design" tab and select color to make it colored list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show the clients in numbered list.
*   It must highlight the products.
*   Report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

We provide support for the following clients:

<ol>
<li>&lt;&lt;foreach [in getClients()]>>&lt;&lt;if [indexOf() % 2 == 0]>>      &lt;&lt;[numberOf()]>>.    &lt;&lt;[getName()]>></li>
<li style="background-color: #ffff00">&lt;&lt;else>>      &lt;&lt;[numberOf()]>>.   &lt;&lt;[getName()]>></li>
</ol>

​		<</if>><</foreach>>

### Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs 533045e35a5ec69a56e3e94092e301b6 >}}



---

## Multicolored Numbered List in Email Document

Path: /assembly/net/multicolored-numbered-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Multicolored Numbered List report in Email Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

## Multicolored Numbered List in Email Document

### Creating a Multicolored Numbered List

Practising the following steps you can create Multicolored Numbered List Template in MS Outlook 2013.

1.  In your email, write a sentence like "We provide support for the following clients:".
2.  Start numbered list.
3.  Go to the "Design" tab and select color to make it colored list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   The report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   The report must show the products in the numbered list.
*   It must highlight the products.
*   The report must be generated in the Presentation Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

We provide support for the following products:

<ol>
<li>&lt;&lt;foreach [in getClients()]>>&lt;&lt;if [indexOf() % 2 == 0]>>      &lt;&lt;[numberOf()]>>.    &lt;&lt;[ProductName]>></li>
<li style="background-color: #ffff00">&lt;&lt;else>>      &lt;&lt;[numberOf()]>>.   &lt;&lt;[ProductName]>></li>
</ol>

<</if>><</foreach>>

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Multicolored Numbered List Template

Please download the sample Multicolored Numbered List document we created in this article:

*   [Multicolored Numbered List.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Multicolored%20Numbered%20List.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists b09c7249dba7302448473eb4f54ff510 >}}



---

## Non-Windows Launch

Path: /comparison/net/non-windows-launch/


## Limitations

If the target framework is .NET 6 or over, due to limitations in the System.Drawing.Common version 6.0.0 (see [Microsoft documentation](https://learn.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only#new-behavior)), you need to add the following setting to the `.csproj` file.

```csharp
<ItemGroup>
	<RuntimeHostConfigurationOption Include="System.Drawing.EnableUnixSupport" Value="true" />
</ItemGroup>
```

## Recommendations

When using GroupDocs.Comparison in a non-Windows environment, the following packages should be installed to improve rendering results and prevent possible runtime errors:

1. libgdiplus - is the Mono library that provides a GDI+-compatible API on non-Windows operating systems.
2. ttf-mscorefonts-installer - package with Microsoft compatible fonts, because GroupDocs.Comparison uses Aril font in the some default scenarios.

To install packages on Debian-based Linux distributions use [apt-get](https://wiki.debian.org/apt-get) utility:

1. sudo apt-get install libgdiplus
2. sudo apt-get install ttf-mscorefonts-installer

## How to run in the Docker

Running GroupDocs.Comparison in Docker is straightforward. All you need to do is add the installation of the packages described in the previous paragraph to the docker file.

### .NET 6 in Docker
An example beginning of the Dockerfile might look like this:

```Dockerfile
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

# Add libgdiplus for graphics support
RUN apt-get update && apt-get install -y apt-utils libgdiplus

# Add `contrib` archive area to package sources list
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
# Add fonts
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig
RUN fc-cache -f -v

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
# etc
```
**fontconfig:** This library configures and customizes font access.

**ttf-mscorefonts-installer:** This package provides Microsoft TrueType core fonts. It's available in the [contrib](https://www.debian.org/doc/debian-policy/ch-archive#s-contrib) archive area. (Note: Using non-free fonts may have licensing implications, so be sure to check the license terms.)

### .NET 8 in Docker
In the .NET 8 Dockerfile, there are some changes in the way ttf-mscorefonts-installer is installed.

```Dockerfile
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 8080

# Add libgdiplus for graphics support
RUN apt-get update && apt-get install -y libgdiplus

RUN apt install software-properties-common -y
RUN echo "deb http://deb.debian.org/debian bookworm contrib non-free" > /etc/apt/sources.list.d/contrib.list
RUN apt update && apt upgrade
# Add fonts
RUN apt install ttf-mscorefonts-installer -y

# This stage is used to build the service project
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
# etc
```

---

## Numbered List in Text Document

Path: /assembly/java/numbered-list-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in The Business Layer.{{< /alert >}}

## Numbered List in Text Document

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must show the client names in a numbered list.
*   Report must be generated in the Text document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
<<foreach [in getClients()]>><<[numberOf()]>>. <<[getName()]>>
<</foreach>>
```

### Download Numbered List Template

Please download the sample template we created in this article:

*   [Numbered List.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Text%20Templates/Numbered%20List.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists d25321fd5b1fe937a42fc607c3ad0c00 >}}



---

## Numbered List in Text Document

Path: /assembly/net/numbered-list-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

## Numbered List in Text Document

### Reporting Requirement

As a report developer, you are required to describe the services you are providing with the following key requirements:

*   The report must show the products in the numbered list.
*   The report must be generated in the Text Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[NumberOf()]>>. <<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Text%20Templates/Numbered%20List.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists df9028fecf23b9a87f197c8cfc8c2208 >}}



---

## Parse data from PDF documents

Path: /parser/java/parse-data-from-pdf-documents/

To extract data from PDF documents [parseForm](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseForm()) and [parseByTemplate(Template)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseByTemplate(com.groupdocs.parser.templates.Template)) methods are used. Both methods return [DocumentData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData) object. For details, see [Working With Extracted Data]({{< ref "parser/java/developer-guide/advanced-usage/working-with-data-extracted-by-template.md" >}}).

Here are the steps to extract data from PDF Form:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document
*   Call [parseForm](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseForm()) method and obtain the [DocumentData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData "class in com.groupdocs.parser.data") object;
*   Check if *data* isn't *null* (parse form is supported for the document);
*   Iterate over field data to obtain form data.

The following example shows the use case when a user fills in PDF form and send it by email (for example). The software opens this PDF and extracts the preliminary record:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleCarWashPdf)) {
    // Extract data from PDF document
    DocumentData data = parser.parseForm();
    // Check if form extraction is supported
    if (data == null) {
        System.out.println("Form extraction isn't supported.");
        return;
    }
    // Create the preliminary record object
    PreliminaryRecord rec = new PreliminaryRecord();
    rec.Name = getFieldText(data, "Name");
    rec.Model = getFieldText(data, "Model");
    rec.Time = getFieldText(data, "Time");
    rec.Description = getFieldText(data, "Description");
    // We can save the preliminary record object to the database,
    // send it as the web response or just print it to the console
    System.out.println("Preliminary record");
    System.out.println(String.format("Name: %s", rec.Name));
    System.out.println(String.format("Model: %s", rec.Model));
    System.out.println(String.format("Time: %s", rec.Time));
    System.out.println(String.format("Description: %s", rec.Description));
}

private static String getFieldText(DocumentData data, String fieldName) {
    // Get the field from data collection
    FieldData fieldData = data.getFieldsByName(fieldName).get(0);
    // Check if the field data is not null (a field with the fieldName is contained in data collection)
    // and check if the field data contains the text
    return fieldData != null && fieldData.getPageArea() instanceof PageTextArea
            ? ((PageTextArea) fieldData.getPageArea()).getText()
            : null;
}

/**
 * Simple POCO object to store the extracted data.
 */
static class PreliminaryRecord {
    public String Name;
    public String Model;
    public String Time;
    public String Description;
}
```

[parseByTemplate(Template)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseByTemplate(com.groupdocs.parser.templates.Template)) method is used to parse PDF document by a user-generated template. For details about templates, see [Working With Templates]({{< ref "parser/java/developer-guide/advanced-usage/working-with-templates.md" >}}).

Here are the steps to parse data from PDF document by the user-generated template:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the existing document;
*   Instantiate [Template](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/Template) object with the user-generated template;
*   Call [parseByTemplate(Template)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseByTemplate(com.groupdocs.parser.templates.Template))) method and obtain [DocumentData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData) object;
*   Iterate over field data to obtain the document data.

The following example shows how to parse data from PDF document by the user-generated template:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleInvoicePdf)) {
    // Parse the document by the template
    DocumentData data = parser.parseByTemplate(GetTemplate());
    // Check if form extraction is supported
    if (data == null) {
        System.out.println("Parse Document by Template isn't supported.");
        return;
    }
    // Print extracted fields
    for (int i = 0; i < data.getCount(); i++) {
        System.out.print(data.get(i).getName() + ": ");
        PageTextArea area = data.get(i).getPageArea() instanceof PageTextArea
                ? (PageTextArea) data.get(i).getPageArea()
                : null;
        System.out.println(area == null ? "Not a template field" : area.getText());
    }
}

private static Template GetTemplate() {
    // Create detector parameters for "Details" table
    TemplateTableParameters detailsTableParameters = new TemplateTableParameters(new Rectangle(new Point(35, 320), new Size(530, 55)), null);
    // Create detector parameters for "Summary" table
    TemplateTableParameters summaryTableParameters = new TemplateTableParameters(new Rectangle(new Point(330, 385), new Size(220, 65)), null);
    // Create a collection of template items
    TemplateItem[] templateItems = new TemplateItem[]
            {
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 135), new Size(100, 10))), "FromCompany"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 150), new Size(100, 35))), "FromAddress"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 190), new Size(150, 2))), "FromEmail"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 250), new Size(100, 2))), "ToCompany"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 260), new Size(100, 15))), "ToAddress"),
                    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 290), new Size(150, 2))), "ToEmail"),
                    new TemplateField(new TemplateRegexPosition("Invoice Number"), "InvoiceNumber"),
                    new TemplateField(new TemplateLinkedPosition(
                            "InvoiceNumber",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "InvoiceNumberValue"),
                    new TemplateField(new TemplateRegexPosition("Order Number"), "InvoiceOrder"),
                    new TemplateField(new TemplateLinkedPosition(
                            "InvoiceOrder",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "InvoiceOrderValue"),
                    new TemplateField(new TemplateRegexPosition("Invoice Date"), "InvoiceDate"),
                    new TemplateField(new TemplateLinkedPosition(
                            "InvoiceDate",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "InvoiceDateValue"),
                    new TemplateField(new TemplateRegexPosition("Due Date"), "DueDate"),
                    new TemplateField(new TemplateLinkedPosition(
                            "DueDate",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "DueDateValue"),
                    new TemplateField(new TemplateRegexPosition("Total Due"), "TotalDue"),
                    new TemplateField(new TemplateLinkedPosition(
                            "TotalDue",
                            new Size(200, 15),
                            new TemplateLinkedPositionEdges(false, false, true, false)),
                            "TotalDueValue"),
                    new TemplateTable(detailsTableParameters, "details", null),
                    new TemplateTable(summaryTableParameters, "summary", null)
            };
    // Create a document template
    Template template = new Template(java.util.Arrays.asList(templateItems));
    return template;
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Parse data from PDF documents

Path: /parser/net/parse-data-from-pdf-documents/

To extract data from PDF documents [ParseForm](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parseform) and [ParseByTemplate](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parsebytemplate) methods are used. Both methods return [DocumentData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata) object. For details, see [Working With Extracted Data]({{< ref "parser/net/developer-guide/advanced-usage/working-with-data-extracted-by-template.md" >}}).

Here are the steps to extract data from PDF Form:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document
*   Call [ParseForm](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parseform) method and obtain the [DocumentData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata) object;
*   Check if *data* isn't *null* (parse form is supported for the document);
*   Iterate over field data to obtain form data.

The following example shows the use case when a user fills in PDF form and send it by email (for example). The software opens this PDF and extracts the preliminary record:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleCarWashPdf))
{
    // Extract data from PDF document
    DocumentData data = parser.ParseForm();
    // Check if form extraction is supported
    if (data == null)
    {
        Console.WriteLine("Form extraction isn't supported.");
        return;
    }

    // Create the preliminary record object
    PreliminaryRecord rec = new PreliminaryRecord();
    rec.Name = GetFieldText(data, "Name");
    rec.Model = GetFieldText(data, "Model");
    rec.Time = GetFieldText(data, "Time");
    rec.Description = GetFieldText(data, "Description");

    // We can save the preliminary record object to the database, 
    // send it as the web response or just print it to the console
    Console.WriteLine("Preliminary record");
    Console.WriteLine("Name: {0}", rec.Name);
    Console.WriteLine("Model: {0}", rec.Model);
    Console.WriteLine("Time: {0}", rec.Time);
    Console.WriteLine("Description: {0}", rec.Description);
}

private static string GetFieldText(DocumentData data, string fieldName)
{
    // Get the field from data collection
    FieldData fieldData = data.GetFieldsByName(fieldName).FirstOrDefault();
    // Check if the field data is not null (a field with the fieldName is contained in data collection)
    // and check if the field data contains the text
    return fieldData != null && fieldData.PageArea is PageTextArea
        ? (fieldData.PageArea as PageTextArea).Text
        : null;
}

/// <summary>
/// Simple POCO object to store the extracted data.
/// </summary>
public class PreliminaryRecord
{
    public string Name { get; set; }
    public string Model { get; set; }
    public string Time { get; set; }
    public string Description { get; set; }
}
```

[ParseByTemplate](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parsebytemplate) method is used to parse PDF document by a user-generated template. For details about templates, see [Working With Templates]({{< ref "parser/net/developer-guide/advanced-usage/working-with-templates.md" >}}).

Here are the steps to parse data from PDF document by the user-generated template:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the existing document;
*   Instantiate [Template](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/template) object with the user-generated template;
*   Call [ParseByTemplate](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parsebytemplate) method and obtain [DocumentData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata) object;
*   Iterate over field data to obtain the document data.

The following example shows how to parse data from PDF document by the user-generated template:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleInvoicePdf))
{
    // Parse the document by the template
    DocumentData data = parser.ParseByTemplate(GetTemplate());
    // Check if parsing document by template is supported
    if (data == null)
    {
        Console.WriteLine("Parsing Document by Template isn't supported.");
        return;
    }
    // Print extracted fields
    for (int i = 0; i < data.Count; i++)
    {
        Console.Write(data[i].Name + ": ");
        PageTextArea area = data[i].PageArea as PageTextArea;
        Console.WriteLine(area == null ? "Not a template field" : area.Text);
    }
}

private static Template GetTemplate()
{
    // Create detector parameters for "Details" table
    TemplateTableParameters detailsTableParameters = new TemplateTableParameters(new Rectangle(new Point(35, 320), new Size(530, 55)), null);
    // Create detector parameters for "Summary" table
    TemplateTableParameters summaryTableParameters = new TemplateTableParameters(new Rectangle(new Point(330, 385), new Size(220, 65)), null);
    // Create a collection of template items
    TemplateItem[] templateItems = new TemplateItem[]
    {
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 135), new Size(100, 10))), "FromCompany"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 150), new Size(100, 35))), "FromAddress"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 190), new Size(150, 2))), "FromEmail"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 250), new Size(100, 2))), "ToCompany"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 260), new Size(100, 15))), "ToAddress"),
        new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 290), new Size(150, 2))), "ToEmail"),
        new TemplateField(new TemplateRegexPosition("Invoice Number"), "InvoiceNumber"),
        new TemplateField(new TemplateLinkedPosition(
            "InvoiceNumber",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "InvoiceNumberValue"),
        new TemplateField(new TemplateRegexPosition("Order Number"), "InvoiceOrder"),
        new TemplateField(new TemplateLinkedPosition(
            "InvoiceOrder",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "InvoiceOrderValue"),
        new TemplateField(new TemplateRegexPosition("Invoice Date"), "InvoiceDate"),
        new TemplateField(new TemplateLinkedPosition(
            "InvoiceDate",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "InvoiceDateValue"),
        new TemplateField(new TemplateRegexPosition("Due Date"), "DueDate"),
        new TemplateField(new TemplateLinkedPosition(
            "DueDate",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "DueDateValue"),
        new TemplateField(new TemplateRegexPosition("Total Due"), "TotalDue"),
        new TemplateField(new TemplateLinkedPosition(
            "TotalDue",
            new Size(200, 15),
            new TemplateLinkedPositionEdges(false, false, true, false)),
            "TotalDueValue"),
        new TemplateTable(detailsTableParameters, "details", null),
        new TemplateTable(summaryTableParameters, "summary", null)
    };
    // Create a document template
    Template template = new Template(templateItems);
    return template;
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Plain text

Path: /parser/java/plain-text/

The following example shows how to extract plain formatted text:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.PlainText))) {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Formatted text extraction isn't suppported" : reader.readToEnd());
    }
}
```

The following Microsoft Word document is used as input document:

![](/parser/java/images/plain-text.png)

The following plain text document is extracted using the example above:

![](/parser/java/images/plain-text_1.png)

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Plain text

Path: /parser/net/plain-text/

The following example shows how to extract plain formatted text:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.PlainText)))
    {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Formatted text extraction isn't suppported" : reader.ReadToEnd());
    }
}
```

The following Microsoft Word document is used as input document:

![](/parser/net/images/plain-text.png)

The following plain text document is extracted using the example above:

![](/parser/net/images/plain-text_1.png)

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Pre-rasterize

Path: /redaction/java/pre-rasterize/

In some cases, you might need to pre-rasterize the document before opening it and applying redactions. 

For instance, you might need to use an [ImageAreaRedaction](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.redactions/imagearearedaction/) for a whole page of a document with searchable text and images. In order to do that, you will need to pass the Boolean flag to the [LoadOptions](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.options/loadoptions/) class constructor.

The following example demonstrates how to pre-rasterize a Microsoft Word document:

```java
        LoadOptions loadOptions = new LoadOptions(/*preRasterize*/ true);
        final Redactor redactor = new Redactor("sample.docx", loadOptions);
        try 
        {
            // Make changes to the file as a rasterized PDF, e.g. uisng ImageAreaRedaction:
            java.awt.Point samplePoint = new java.awt.Point(516, 311);
            java.awt.Dimension sampleSize = new java.awt.Dimension(170, 35);
            RedactorChangeLog result = redactor.apply(new ImageAreaRedaction(samplePoint,
                new RegionReplacementOptions(java.awt.Color.RED, sampleSize)));
            if (result.getStatus() != RedactionStatus.Failed)
            {
                    redactor.save();
            };
        }
        finally { redactor.close(); }
}
```


---

## Pre-rasterize

Path: /redaction/net/pre-rasterize/

In some cases, you might need to pre-rasterize the document before opening it and applying redactions. 

For instance, you might need to use an [ImageAreaRedaction](https://reference.groupdocs.com/redaction/net/groupdocs.redaction.redactions/imagearearedaction/) for a whole page of a document with searchable text and images. In order to do that, you will need to pass the Boolean flag to the [LoadOptions](https://reference.groupdocs.com/redaction/net/groupdocs.redaction.options/loadoptions/) class constructor.

The following example demonstrates how to pre-rasterize a Microsoft Word document:

**C#**

```csharp
bool preRasterize = true;
using (Redactor redactor = new Redactor(@"sample.docx"), new LoadOptions(preRasterize))
{
    // Make changes to the file as a rasterized PDF, e.g. uisng ImageAreaRedaction:
    System.Drawing.Point samplePoint = new System.Drawing.Point(516, 311);
    System.Drawing.Size sampleSize = new System.Drawing.Size(170, 35);
    RedactorChangeLog result = redactor.Apply(new ImageAreaRedaction(samplePoint,
                    new RegionReplacementOptions(System.Drawing.Color.Blue, sampleSize)));
    if (result.Status != RedactionStatus.Failed)
    {
        redactor.Save();
    };
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Pre-rasterize

Path: /redaction/python-net/pre-rasterize/

In some cases, you might need to pre-rasterize the document before opening it and applying redactions. 

For instance, you might need to use an [ImageAreaRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/imagearearedaction/) for a whole page of a document with search-able text and images. In order to do that, you will need to pass the Boolean flag to the [LoadOptions](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.options/loadoptions/) class constructor.

The following example demonstrates how to pre-rasterize a Microsoft Word document:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():
    
    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)

        if (result.status != gr.RedactionStatus.FAILED):
            # By default, the redacted document is saved in PDF format
            result_path = redactor.save()
        else:
            print(f"Redaction failed!")
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Quick Start Guide

Path: /total/python-net/quick-start-guide/


This guide provides a quick overview of how to set up and start using GroupDocs.Total for Python via .NET.  
It shows three code examples that demonstrate how to use packages included in the suite.

## Prerequisites

To proceed, make sure you have:

1. **Configured** environment as described in the [System Requirements]({{< ref "/total/python-net/getting-started/system-requirements.md" >}}) topic.
2. **Optionally** you may [Get a Temporary License](https://purchase.groupdocs.com/temporary-license/) to test all the product features. 

## Set Up Your Development Environment

For best practices, use a virtual environment to manage dependencies in Python applications. Learn more about virtual environment at [Create and Use Virtual Environments](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#create-and-use-virtual-environments) documentation topic.

### Create and Activate a Virtual Environment

Create a virtual environment:

{{< tabs "create_virtual_environment">}}
{{< tab "Windows" >}}
```ps
py -3.11 -m venv .venv
```
{{< /tab >}}
{{< /tabs >}}

Activate a virtual environment:

{{< tabs "activate_virtual_environment">}}
{{< tab "Windows" >}}
```ps
.venv\Scripts\activate
```
{{< /tab >}}
{{< /tabs >}}

### Install `groupdocs-total-net` Package

After activating the virtual environment, run the following command in your terminal to install the latest version of the package:

{{< tabs "install_package">}}
{{< tab "Windows" >}}
```ps
py -m pip install groupdocs-total-net
```
{{< /tab >}}
{{< /tabs >}}

Ensure the package is installed successfully. You should see the message 

```bash
Successfully installed groupdocs-total-net-*
```

## Example 1: Convert a document

This example shows how to convert a DOCX document to PDF using GroupDocs.Conversion.
You can download the demo app [here](/total/python-net/_sample_files/getting-started/quick-start-guide/convert_docx_to_pdf.zip).

{{< tabs "example_convert_docx_to_pdf">}}
{{< tab "convert_docx_to_pdf.py" >}}  
```python
import os
from groupdocs.conversion import License, Converter
from groupdocs.conversion.options.convert import PdfConvertOptions

def convert_docx_to_pdf():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Total.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load DOCX file
    with Converter("./business-plan.docx") as converter:
        # Create convert options
        pdf_convert_options = PdfConvertOptions()

        # Convert DOCX to PDF
        converter.convert("./business-plan.pdf", pdf_convert_options)

if __name__ == "__main__":
    convert_docx_to_pdf()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/total/python-net/_sample_files/getting-started/quick-start-guide/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is expected output PDF file. Click [here](/total/python-net/_sample_files/getting-started/quick-start-guide/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```text
📂 demo-app
 ├──convert_docx_to_pdf.py
 ├──business-plan.docx
 └──GroupDocs.Total.lic (Optionally)
```

### Run the App

{{< tabs "run_convert_docx_to_pdf">}}
{{< tab "Windows" >}}
```ps
py convert_docx_to_pdf.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Converter("./business-plan.docx")`: Initializes the converter with the DOCX file.
- `PdfConvertOptions()`: Specifies the output format as PDF.
- `converter.convert("./business-plan.pdf", pdf_convert_options)`: Converts the DOCX file to PDF and saves it as `business-plan.pdf`.

## Example 2: Remove document metadata

This code example shows how to remove PDF document metadata and save the output to a file with GroupDocs.Metadata. You can download the app that we're going to buid [here](/total/python-net/_sample_files/getting-started/quick-start-guide/remove_pdf_metadata.zip).

{{< tabs "example_remove_pdf_document_metadata">}}
{{< tab "remove_pdf_document_metadata.py" >}}  
```python
import os
from groupdocs.metadata import License, Metadata

def remove_pdf_metadata():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Total.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Load the PDF file
    with Metadata("./business-plan.pdf") as metadata:
      # Remove metadata
      metadata.sanitize()
     
      # Save the file with no metadata
      metadata.save("./no-metadata.pdf")

if __name__ == "__main__":
    remove_pdf_metadata()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/total/python-net/_sample_files/getting-started/quick-start-guide/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "no-metadata.pdf" >}}  
{{< tab-text >}}
`no-metadata.pdf` is expected output PDF file without metadata. Click [here](/total/python-net/_sample_files/getting-started/quick-start-guide/no-metadata.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```text
📂 demo-app
 ├──business-plan.pdf
 ├──remove_pdf_metadata.py
 └──GroupDocs.Total.lic (Optionally)
```

### Run the App

{{< tabs "run_remove_pdf_metadata">}}
{{< tab "Windows" >}}
```ps
py remove_pdf_metadata.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Metadata("./business-plan.pdf")`: Initializes metadata object with the source PDF file.
- `metadata.sanitize()`: Removes the metadata.
- `metadata.save("./no-metadata.pdf")`: Saves the output document without metadata.

## Example 3: Convert and remove metadata

This example converts a DOCX file to PDF and removes metadata in a single workflow.
You can download the demo app [here](/total/python-net/_sample_files/getting-started/quick-start-guide/convert_and_remove_metadata.zip).

{{< tabs "example_convert_and_remove_metadata">}}
{{< tab "convert_and_remove_metadata.py" >}}  
```python
import os
from groupdocs.conversion import License as ConversionLicense, Converter
from groupdocs.conversion.options.convert import PdfConvertOptions
from groupdocs.metadata import License as MetadataLicense, Metadata

def convert_and_remove_metadata():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Total.lic")

    if os.path.exists(license_path):
        # License GroupDocs.Conversion
        conversion_license = ConversionLicense()
        conversion_license.set_license(license_path)

        # License GroupDocs.Metadata
        metadata_license = MetadataLicense()
        metadata_license.set_license(license_path)

    # Load DOCX file
    with Converter("./business-plan.docx") as converter:
        # Create convert options
        pdf_convert_options = PdfConvertOptions()

        # Convert DOCX to PDF
        converter.convert("./business-plan.pdf", pdf_convert_options)

    # Load created PDF file
    with Metadata("./business-plan.pdf") as metadata:
      # Remove the metadata
      metadata.sanitize()
     
      # Save the file with no metadata
      metadata.save("./converted-no-metadata.pdf")

if __name__ == "__main__":
    convert_and_remove_metadata()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/total/python-net/_sample_files/getting-started/quick-start-guide/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted-no-metadata.pdf" >}}  
{{< tab-text >}}
`converted-no-metadata.pdf` is output PDF file without metadata. Click [here](/total/python-net/_sample_files/getting-started/quick-start-guide/converted-no-metadata.pdf) to download the output PDF file.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```text
📂 demo-app
 ├──business-plan.docx
 ├──convert_and_remove_metadata.py
 └──GroupDocs.Total.lic (Optionally)
```

### Run the App

{{< tabs "run_convert_and_remove_metadata">}}
{{< tab "Windows" >}}
```ps
py convert_and_remove_metadata.py
```
{{< /tab >}}
{{< /tabs >}}

After running the app you can deactivate virtual environment by executing `deactivate` or closing your shell.

### Explanation
- `Converter("./business-plan.docx")`: Initializes the converter with the DOCX file.
- `converter.convert("./business-plan.pdf", pdf_convert_options)`: Converts the DOCX file to PDF and saves it as `business-plan.pdf`.
- `Metadata("./business-plan.pdf")`: Reads converted PDF file.
- `metadata.sanitize()`: Removes the metadata.
- `metadata.save("./converted-no-metadata.pdf")`: Saves the output document without metadata.

## Learn More

- [Supported File Formats]({{< ref "/total/python-net/getting-started/supported-document-formats.md" >}}): Review the full list of supported file types.
- [Licensing and Evaluation]({{< ref "/total/python-net/getting-started/licensing-and-evaluation.md" >}}): Check details on licening and evaluation.
- [Technical Support]({{< ref "/total/python-net/technical-support.md" >}}): Contact support for assistance if you encounter issues.

---

## Remove annotation from document

Path: /annotation/java/remove-annotation-from-document/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) allows you to remove all previously added annotations. To do this, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.options.export/saveoptions/) class. Set `AnnotationTypes = AnnotationType.None`.
3.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to remove annotation using its index:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to remove annotations from document.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");

SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);

// Save result to file
annotator.save("outputPath", saveOptions);
```
{{< /tab >}}
{{< /tabs >}}
---

## Remove annotation from document

Path: /annotation/net/remove-annotation-from-document/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to remove all previously added annotations. To do this, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [SaveOptions](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.options/saveoptions) class. Set `AnnotationTypes = AnnotationType.None`.
3.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

## Remove annotation using its index

The following code snippet shows how to remove annotation using its index:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("result.xlsx"))
{
	annotator.Remove(0);
	annotator.Save("removed.xlsx");
}
```
{{< /tab >}}
{{< /tabs >}}

## Remove annotation using the object

The following code snippet shows how to remove annotation using the object:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("result.xlsx"))
{
	var tmp = annotator.Get();
	annotator.Remove(tmp[0]);
	annotator.Save("removed.xlsx");
}
```
{{< /tab >}}
{{< /tabs >}}

## Remove annotations using the list of indexes

The following code snippet shows how to remove annotations using list of indexes:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("result.xlsx"))
{
	var idList = new List<int>{1, 2, 3};
	annotator.Remove(idList);
	annotator.Save("removed.xlsx");
}
```
{{< /tab >}}
{{< /tabs >}}

## Remove annotations using the list of objects

The following code snippet shows how to remove some annotations from document using list of objects:

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("result.xlsx"))
{
	var tmp = annotator.Get();
	annotator.Remove(tmp);
	annotator.Save("removed.xlsx");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Removing Selective Chart Series Dynamically

Path: /assembly/java/removing-selective-chart-series-dynamically/

{{< alert style="info" >}}This feature is supported by version 17.11 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft Word Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "Column" in the sidebar, you will see a gallery of charts.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/removing-selective-chart-series-dynamically/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must show total Contract Prices by Quarters
*   Report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Quarters
<<foreach[in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x[key.getName()]>>
```

#### Chart Data (Excel)

|   | 1st Quarter<<y[where(c => c.getDate().getMonth()>= 0 && c.getDate().getMonth() <= 2).sum(c => c.getPrice())]>><<removeif [mode==1]>> | 2nd Quarter<<y[where(c => c.getDate().getMonth()>= 3 && c.getDate().getMonth() <= 5).sum(c => c.getPrice())]>><<removeif [mode==2]>> | 3rd Quarter<<y[where(c => c.getDate().getMonth()>= 6 && c.getDate().getMonth()<= 8).sum(c => c.getPrice())]>> | 4th Quarter<<y[where(c => c.getDate().getMonth()>= 9 && c.getDate().getMonth()<= 11).sum(c => c.getPrice())]>> |
| --- | --- | --- | --- | --- |
| Category 1 | 4.3 | 2.4 | 2 | 3 |
| Category 2 | 2.5 | 4.4 | 2 | 2 |
| Category 3 | 3.5 | 1.8 | 3 | 5 |
| Category 4 | 4.5 | 2.8 | 5 | 2 |

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.docx](https://github.com/aliahmedgroupdocs/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_RemoveIf.docx)

### Generating The Report

{{< gist GroupDocsGists 18be56c4d11e2e602f786be46736bf2a >}}



---

## Removing Selective Chart Series Dynamically

Path: /assembly/net/removing-selective-chart-series-dynamically/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.11 or greater.{{< /alert >}}

## Column Chart in Microsoft Word Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box.
2.  Select "Column" in the sidebar, you will see a gallery of charts.
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document.
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/removing-selective-chart-series-dynamically/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine).
5.  Save your Document.

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must show the quantity of sales/orders.
*   Sales/orders quantity must represented by Quarters.
*   It must associate order quantity with the corresponding customer.
*   The report must be generated in the Word Processing Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
Total Order Quantity by Quarters<<foreach [in orders
.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>><<x [Key.CustomerName]>>

```

#### Chart Data (Excel)

|   | 1st Quarter<<y[Where(c => c.OrderDate.Month>= 1 && c.OrderDate.Month <= 3).Sum(c => c.ProductQuantity)]>><<removeif [mode== 1]>> | 2nd Quarter<<y[Where(c => c.OrderDate.Month>= 4 && c.OrderDate.Month <= 6).Sum(c => c.ProductQuantity)]>><<removeif [mode==2]>> | 3rd Quarter<<y[Where(c => c.OrderDate.Month>= 7 && c.OrderDate.Month <= 9).Sum(c => c.ProductQuantity)]>> | 4th Quarter<<y[Where(c => c.OrderDate.Month>= 10 && c.OrderDate.Month <= 12).Sum(c => c.ProductQuantity)]>> |
| --- | --- | --- | --- | --- |
| Category 1 | 4.3 | 2.4 | 2 | 3 |
| Category 2 | 2.5 | 4.4 | 2 | 2 |
| Category 3 | 3.5 | 1.8 | 3 | 5 |
| Category 4 | 4.5 | 2.8 | 5 | 2 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.docx](https://github.com/aliahmedgroupdocs/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_RemoveIf.docx) (Template for CustomObject and JSON examples) 

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists b44bbcc5a2ca4b9f6fd0c854e792902f >}}



---

## Render archives as HTML, PDF, and image files (old version)

Path: /viewer/java/old-render-archive-files/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to view the contents of archive files in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party file archiver and compression software to display archive file contents within your Java application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass an archive file you want to view to the class constructor. You can load the archive from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the archive file to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/archive" >}} {{< icon "gdoc_person" >}} View archive files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported archive and compressed file formats

GroupDocs.Viewer supports the following archive file formats:

* [.7Z (7-Zip Compressed File)](https://docs.fileformat.com/compression/7z)
* [.BZ2 (Bzip2 Compressed File)](https://docs.fileformat.com/compression/bz2)
* [.GZ (Gnu Zipped Archive)](https://docs.fileformat.com/compression/gz)
* [.RAR (WinRAR Compressed Archive)](https://docs.fileformat.com/compression/rar)
* [.TAR (Consolidated Unix File Archive)](https://docs.fileformat.com/compression/tar)
* [.TGZ / .TAR.GZ (Gzipped Tar File)](https://docs.fileformat.com/compression/tgz/)
* [.TXZ / .TAR.XZ (XZ Compressed Tar Archive)](https://docs.fileformat.com/compression/xz/)
* [.XZ (XZ Compressed Archive)](https://docs.fileformat.com/compression/xz/)
* [.ZIP (Zipped File)](https://docs.fileformat.com/compression/zip)

## Render archive files as HTML

To convert an archive file to HTML, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("Documents.zip")) {
    // Create an HTML file for top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to HTML](/viewer/java/images/rendering-basics/render-archive-files/render-archive-to-html-embedded-resources.png)

### Specify the number of items to render

GroupDocs.Viewer supports the [HtmlViewOptions.getArchiveOptions.setItemsPerPage](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/archiveoptions/#setItemsPerPage-int-) method that allows you to specify the number of archive items to display on each HTML page. The default property value is **16**.

The following example demonstrates how to set this option in code:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("Documents.zip")) {
    // Create an HTML file for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the output file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    // Specify the number of items to display on each HTML page.
    viewOptions.getArchiveOptions().setItemsPerPage(10);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Create a single HTML page

If you need to display the contents of an archive file on a single HTML page, use the [HtmlViewOptions.setRenderToSinglePage](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setRenderToSinglePage-boolean-) method, as shown below:

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("Documents.zip")) {
    // Create an HTML file for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the output file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    // Render the archive file to a single page.
    viewOptions.setRenderToSinglePage(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The animation below demonstrates the result. You can navigate between the archive folders. Click on a particular folder to see its contents. To go backward, click the required folder name in the navigation bar at the top of the web page.

![Navigate between folders in the archive](/viewer/java/images/rendering-basics/render-archive-files/navigate-between-archive-files.gif)

## Render archive files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an archive file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file or reorder its pages. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("Documents.zip")) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PDF](/viewer/java/images/rendering-basics/render-archive-files/render-archive-to-pdf.png)

## Render archive files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an archive file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("Documents.zip")) {
    // Create a PNG image for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PNG](/viewer/java/images/rendering-basics/render-archive-files/render-archive-to-png-image.png)

## Render archive files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an archive file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("Documents.zip")) {
    // Create a JPG image for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the image name.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Obtain information about folders in an archive file

Follow the steps below to obtain information about folders contained in an archive file. You can use this information to [specify which folder to display in the output file](#render-a-specific-folder).

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [ArchiveViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/archiveviewinfo/) type.
3. Use the [ArchiveViewInfo.getFolders](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/archiveviewinfo/#getFolders--) method to obtain the lists of folders in the archive file.

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ArchiveViewInfo;
import com.groupdocs.viewer.results.ViewInfo;

public class GetViewInfoForArchiveFile {

    /**
     * This example demonstrates how to get view info for Archive files.
     */
    public static void run() {
        try (Viewer viewer = new Viewer("sample.zip")) {
            ViewInfo viewInfo = viewer.getViewInfo(ViewInfoOptions.forHtmlView());

            System.out.println("File type: " + viewInfo.getFileType());
            System.out.println("Pages count: " + viewInfo.getPages().size());
            System.out.println("Folders: ");
            System.out.println(" - /");

            String rootFolder = "";
            readFolders(viewer, rootFolder);
        }

        System.out.println("\nView info retrieved successfully.");
    }

    private static void readFolders(Viewer viewer, String folder) {
        ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
        viewInfoOptions.getArchiveOptions().setFolder(folder);

        ArchiveViewInfo viewInfo = (ArchiveViewInfo) viewer.getViewInfo(viewInfoOptions);

        for (String subFolder : viewInfo.getFolders()) {
            System.out.println(" - " + subFolder);

            readFolders(viewer, subFolder);
        }
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about an archive file](/viewer/java/images/rendering-basics/render-archive-files/retrieve-archive-information.png)

GroupDocs.Viewer also allows you to list and extract all files contained in the archive. Refer to the following help topics for details:

* [List attachments](/viewer/java/how-to-list-attachments/)
* [Save attachments](/viewer/java/how-to-extract-and-save-attachments/)

## Render a specific folder

When you convert an archive file to HTML, PDF, or image format, GroupDocs.Viewer renders items from all folders contained in the archive. If you need to render items from a specific folder, use the [ArchiveOptions.setFolder](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/archiveoptions/#setFolder-java.lang.String-) method of one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
viewOptions.getArchiveOptions().setFolder("Documents/CAD files");

try (Viewer viewer = new Viewer("Documents.zip")) {
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Specify the archive file name

When rendering an archive file, GroupDocs.Viewer displays the archive file name in the header of each page. If you need to change or hide this name, use the [ArchiveOptions.setFileName](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/archiveoptions/#setFileName-com.groupdocs.viewer.options.FileName-) method for a target view. You can set this option to one of the following values:

* [FileName.SOURCE](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/filename/#SOURCE)--- Returns the name of the source file (this name is used by default).
* [FileName.EMPTY](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/filename/#EMPTY)---Specifies an empty name. Use this value to hide the archive file name in the output file.
* A [FileName](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/filename) instance with a custom name you want to display in the output file.

The following code snippet demonstrates how to use a custom name when rendering an archive file to HTML:

{{< tabs "example9">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("Documents.zip")) {
   HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewOptions.getArchiveOptions().setFileName(new FileName("Sample Files"));

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Set a custom archive name](/viewer/java/images/rendering-basics/render-archive-files/set-archive-name.png)

---

## Render archives as HTML, PDF, and image files (old version)

Path: /viewer/net/old-render-archive-files/

{{< alert style="info" >}}This article explaing working with archives using old versions of the GroupDocs.Viewer for .NET, before the [version 24.10](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-10-release-notes/#new-archive-converter) was released. If you're using GroupDocs.Viewer or newer, please read the [main article]({{< ref "viewer/net/rendering-basics/render-archives/_index.md" >}}).{{< /alert >}}

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to view the contents of archive files in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party file archiver and compression software to display archive file contents within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass an archive file you want to view to the class constructor. You can load the archive from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the archive file to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/archive" >}} {{< icon "gdoc_person" >}} View archive files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported archive and compressed file formats

GroupDocs.Viewer supports the following archive file formats:

* [.7Z (7-Zip Compressed File)](https://docs.fileformat.com/compression/7z)
* [.BZ2 (Bzip2 Compressed File)](https://docs.fileformat.com/compression/bz2)
* [.GZ (Gnu Zipped Archive)](https://docs.fileformat.com/compression/gz)
* [.RAR (WinRAR Compressed Archive)](https://docs.fileformat.com/compression/rar)
* [.TAR (Consolidated Unix File Archive)](https://docs.fileformat.com/compression/tar)
* [.TGZ / .TAR.GZ (Gzipped Tar File)](https://docs.fileformat.com/compression/tgz/)
* [.TXZ / .TAR.XZ (XZ Compressed Tar Archive)](https://docs.fileformat.com/compression/xz/)
* [.XZ (XZ Compressed Archive)](https://docs.fileformat.com/compression/xz/)
* [.ZIP (Zipped File)](https://docs.fileformat.com/compression/zip)
* [.ZST / .TAR.ZST / .TZST (Zstandard)](https://docs.fileformat.com/compression/zst/)
* [.ISO (Optical Disk Image ISO-9660)](https://docs.fileformat.com/compression/iso/)

GroupDocs.Viewer can detect the archive file format automatically based on information in the file header.

## Render archive files as HTML

To convert an archive file to HTML, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create an HTML file for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the output file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create an HTML file for the top folder and each subfolder in the archive.
            ' {0} is replaced with the current page number in the output file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to HTML](/viewer/net/images/rendering-basics/render-archive-files/render-archive-to-html-embedded-resources.png)

### Specify the number of items to render

GroupDocs.Viewer supports the [HtmlViewOptions.ArchiveOptions.ItemsPerPage](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/archiveoptions/itemsperpage/) option that allows you to specify the number of archive items to display on each HTML page. The default property value is **16**.

The following example demonstrates how to set this option in code:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create an HTML file for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the output file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Specify the number of items to display on each HTML page.
    viewOptions.ArchiveOptions.ItemsPerPage = 10;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create an HTML file for the top folder and each subfolder in the archive.
            ' {0} is replaced with the current page number in the output file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Specify the number of items to display on each HTML page.
            viewOptions.ArchiveOptions.ItemsPerPage = 10
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Create a single HTML page

If you need to display the contents of an archive file on a single HTML page, enable the [HtmlViewOptions.RenderToSinglePage](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/rendertosinglepage/) option, as shown below:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    // Render the archive file to a single page.
    viewOptions.RenderToSinglePage = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            ' Render the archive file to a single page.
            viewOptions.RenderToSinglePage = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The animation below demonstrates the result. You can navigate between the archive folders. Click on a particular folder to see its contents. To go backward, click the required folder name in the navigation bar at the top of the web page.

![Navigate between folders in the archive](/viewer/net/images/rendering-basics/render-archive-files/navigate-between-archive-files.gif)

## Render archive files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an archive file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file or reorder its pages. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create a PDF file.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create a PDF file.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PDF](/viewer/net/images/rendering-basics/render-archive-files/render-archive-to-pdf.png)

## Render archive files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an archive file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create a PNG image for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create a PNG image for the top folder and each subfolder in the archive.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PNG](/viewer/net/images/rendering-basics/render-archive-files/render-archive-to-png-image.png)

## Render archive files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an archive file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create a JPEG image for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create a JPEG image for the top folder and each subfolder in the archive.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Obtain information about folders in an archive file

Follow the steps below to obtain information about folders contained in an archive file. You can use this information to [specify which folder to display in the output file](#render-a-specific-folder).

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.GetViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getviewinfo) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [ArchiveViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.results/archiveviewinfo) type.
3. Use the [ArchiveViewInfo.Folders](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/archiveviewinfo/folders/) property to obtain the lists of folders in the archive file.

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    var viewInfoOptions = ViewInfoOptions.ForHtmlView();
    var viewInfo = viewer.GetViewInfo(viewInfoOptions) as ArchiveViewInfo;

    if (viewInfo != null)
    {
        Console.WriteLine($"File type: {viewInfo.FileType}");
        Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}");
        Console.WriteLine("Folders: ");
        // Display the list of folders in the archive file.
        foreach (string folder in viewInfo.Folders)
            Console.WriteLine($" - {folder}");
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            Dim viewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo = TryCast(viewer.GetViewInfo(viewInfoOptions), ArchiveViewInfo)

            If viewInfo IsNot Nothing Then
                Console.WriteLine($"File type: {viewInfo.FileType}")
                Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}")
                Console.WriteLine("Folders: ")
                ' Display the list of folders in the archive file.
                For Each folder As String In viewInfo.Folders
                    Console.WriteLine($" - {folder}")
                Next
            End If
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about an archive file](/viewer/net/images/rendering-basics/render-archive-files/retrieve-archive-information.png)

GroupDocs.Viewer also allows you to list and extract all files contained in the archive. Refer to the following help topics for details:

* [List attachments](/viewer/net/how-to-list-attachments/)
* [Save attachments](/viewer/net/how-to-extract-and-save-attachments/)

## Render a specific folder

When you convert an archive file to HTML, PDF, or image format, GroupDocs.Viewer renders items from all folders contained in the archive. If you need to render items from a specific folder, specify the [ArchiveOptions.Folder](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/archiveoptions/properties/folder) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    // Specify a folder to render items from.
    viewOptions.ArchiveOptions.Folder = "Documents/CAD files";
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            ' Specify a folder to render items from.
            viewOptions.ArchiveOptions.Folder = "Documents/CAD files"
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Specify the archive file name

When rendering an archive file, GroupDocs.Viewer displays the archive file name in the header of each page. If you need to change or hide this name, define the [ArchiveOptions.FileName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/archiveoptions/filename/) property for a target view. You can set this option to one of the following values:

* [FileName.Source](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/filename/source/)--- Returns the name of the source file (this name is used by default).
* [FileName.Empty](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/archiveoptions/properties/filename/empty)---Specifies an empty name. Use this value to hide the archive file name in the output file.
* A [FileName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/filename/filename/) instance with a custom name you want to display in the output file.

The following code snippet demonstrates how to use a custom name when rendering an archive file to HTML:

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("Documents.zip"))
{
    // Create an HTML file for the top folder and each subfolder in the archive.
    // {0} is replaced with the current page number in the output file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Specify a custom filename
    viewOptions.ArchiveOptions.FileName = new FileName("Sample Files");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("Documents.zip")
            ' Create an HTML file for the top folder and each subfolder in the archive.
            ' {0} is replaced with the current page number in the output file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Specify a custom filename
            viewOptions.ArchiveOptions.FileName = New FileName("Sample Files")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Set a custom archive name](/viewer/net/images/rendering-basics/render-archive-files/set-archive-name.png)
---

## Render Visio documents as HTML, PDF, and image files

Path: /viewer/java/render-visio-documents/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your Visio diagrams in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Visio or other diagramming software to load and view Visio files within your Java application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/visio" >}} {{< icon "gdoc_person" >}} View Visio files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Visio file formats

GroupDocs.Viewer supports the following Visio file formats:

* [Visio Drawing](https://docs.fileformat.com/visio/vsdx/) (.VSDX)
* [Visio 2003-2010 Drawing](https://docs.fileformat.com/visio/vsd/) (.VSD)
* [Visio Macro-Enabled Drawing](https://docs.fileformat.com/visio/vsdm/) (.VSDM)
* [Visio Stencil](https://docs.fileformat.com/visio/vssx/) (.VSSX)
* [Visio 2003-2010 Stencil](https://docs.fileformat.com/visio/vss/) (.VSS)
* [Visio Macro-Enabled Stencil](https://docs.fileformat.com/visio/vssm/) (.VSSM)
* [Visio Template](https://docs.fileformat.com/visio/vstx/) (.VSTX)
* [Visio 2003-2010 Template](https://docs.fileformat.com/visio/vst/) (.VST)
* [Visio Macro-Enabled Template](https://docs.fileformat.com/visio/vstm/) (.VSTM)
* [Visio Drawing XML File](https://docs.fileformat.com/visio/vdx/) (.VDX)
* [Visio Stencil XML File](https://docs.fileformat.com/visio/vsx/) (.VSX)
* [Visio Template XML File](https://docs.fileformat.com/visio/vtx/) (.VTX)
* [Visio Web Drawing](https://docs.fileformat.com/visio/vdw/) (.VDW)

## Render Visio files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Visio file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("flowchart.vsdx")) {
    // Create an HTML file for each drawing page.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to HTML](/viewer/java/images/rendering-basics/render-visio-documents/render-visio-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("flowchart.vsdx")) {
    // Create an HTML file for each drawing page.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-visio-documents/render-visio-to-html-external-resources.png)

## Render Visio files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Visio file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("flowchart.vsdx")) {
    // Create a PDF file for the document.
    // Specify the PDF file name.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to PDF](/viewer/java/images/rendering-basics/render-visio-documents/render-visio-to-pdf.png)

## Render Visio files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Visio file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("flowchart.vsdx")) {
    // Create a PNG image for each drawing page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(800);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Visio file to PNG](/viewer/java/images/rendering-basics/render-visio-documents/render-visio-to-png-image.png)

## Render Visio files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Visio file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("flowchart.vsdx")) {
    // Create a JPEG image for each drawing page.
    // {0} is replaced with the current page number in the image name.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(1600);
    viewOptions.setHeight(650);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render only diagram shapes

GroupDocs.Viewer allows you to render shapes used in a Visio diagram or stored in a Visio stencil file. These shapes are displayed in the **Document Stencil** pane in Microsoft Visio.

![Document Stencil pane in Visio](/viewer/java/images/rendering-basics/render-visio-documents/visio-document-stencil.png)

To render only master shapes contained in Visio file, use the [VisioRenderingOptions.setRenderFiguresOnly](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/visiorenderingoptions/#setRenderFiguresOnly-boolean-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

The [VisioRenderingOptions.setFigureWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/visiorenderingoptions/#setFigureWidth-int-) method allows you to specify the shape width in pixels. The height is calculated automatically based on the aspect ratio of each shape.

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...
try (Viewer viewer = new Viewer("map.vsdx")) {
    // Convert the Visio file to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Render the master shapes only.
    viewoptions.getVisioRenderingOptions().setRenderFiguresOnly(true);
    // Specify shape width in pixels.
    viewoptions.getVisioRenderingOptions().setFigureWidth(200);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render master shapes only](/viewer/java/images/rendering-basics/render-visio-documents/render-visio-shapes.png)

---

## Render Visio documents as HTML, PDF, and image files

Path: /viewer/net/render-visio-documents/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your Visio diagrams in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Visio or other diagramming software to load and view Visio files within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/visio" >}} {{< icon "gdoc_person" >}} View Visio files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Visio file formats

GroupDocs.Viewer supports the following Visio file formats:

* [Visio Drawing](https://docs.fileformat.com/visio/vsdx/) (.VSDX)
* [Visio 2003-2010 Drawing](https://docs.fileformat.com/visio/vsd/) (.VSD)
* [Visio Macro-Enabled Drawing](https://docs.fileformat.com/visio/vsdm/) (.VSDM)
* [Visio Stencil](https://docs.fileformat.com/visio/vssx/) (.VSSX)
* [Visio 2003-2010 Stencil](https://docs.fileformat.com/visio/vss/) (.VSS)
* [Visio Macro-Enabled Stencil](https://docs.fileformat.com/visio/vssm/) (.VSSM)
* [Visio Template](https://docs.fileformat.com/visio/vstx/) (.VSTX)
* [Visio 2003-2010 Template](https://docs.fileformat.com/visio/vst/) (.VST)
* [Visio Macro-Enabled Template](https://docs.fileformat.com/visio/vstm/) (.VSTM)
* [Visio Drawing XML File](https://docs.fileformat.com/visio/vdx/) (.VDX)
* [Visio Stencil XML File](https://docs.fileformat.com/visio/vsx/) (.VSX)
* [Visio Template XML File](https://docs.fileformat.com/visio/vtx/) (.VTX)
* [Visio Web Drawing](https://docs.fileformat.com/visio/vdw/) (.VDW)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

{{< alert style="info" >}}Family of Visio file formats currently is not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

## Render Visio files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Visio file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("flowchart.vsdx"))
{
    // Create an HTML file for each drawing page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("flowchart.vsdx")
            ' Create an HTML file for each drawing page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to HTML](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("flowchart.vsdx"))
{
    // Create an HTML file for each drawing page.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources(
        "page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("flowchart.vsdx")
            ' Create an HTML file for each drawing page.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-html-external-resources.png)

## Render Visio files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Visio file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("flowchart.vsdx"))
{
    // Create a PDF file for the document.
    // Specify the PDF file name.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("flowchart.vsdx")
            ' Create a PDF file for the document.
            ' Specify the PDF file name.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to PDF](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-pdf.png)

## Render Visio files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Visio file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("flowchart.vsdx"))
{
    // Create a PNG image for each drawing page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 950;
    viewOptions.Height = 800;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("flowchart.vsdx")
            ' Create a PNG image for each drawing page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 950
            viewOptions.Height = 800
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Visio file to PNG](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-png-image.png)

## Render Visio files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Visio file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("flowchart.vsdx"))
{
    // Create a JPEG image for each drawing page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 950;
    viewOptions.Height = 800;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("flowchart.vsdx")
            ' Create a JPEG image for each drawing page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 950
            viewOptions.Height = 800
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render only diagram shapes

GroupDocs.Viewer allows you to render shapes used in a Visio diagram or stored in a Visio stencil file. These shapes are displayed in the **Document Stencil** pane in Microsoft Visio.

![Document Stencil pane in Visio](/viewer/net/images/rendering-basics/render-visio-documents/visio-document-stencil.png)

To render only master shapes contained in Visio file, enable the [VisioRenderingOptions.RenderFiguresOnly](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/visiorenderingoptions/properties/renderfiguresonly) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

The [VisioRenderingOptions.FigureWidth](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/visiorenderingoptions/properties/figurewidth) property allows you to specify the shape width in pixels. The height is calculated automatically based on the aspect ratio of each shape.

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("map.vsdx"))
{
    // Convert the Visio file to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Render the master shapes only.
    viewOptions.VisioRenderingOptions.RenderFiguresOnly = true;
    // Specify shape width in pixels.
    viewOptions.VisioRenderingOptions.FigureWidth = 200;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("map.vsdx")
            ' Convert the Visio file to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Render the master shapes only.
            viewOptions.VisioRenderingOptions.RenderFiguresOnly = True
            ' Specify shape width in pixels.
            viewOptions.VisioRenderingOptions.FigureWidth = 200
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render master shapes only](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-shapes.png)

---

## Render Visio documents as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-visio-documents/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your Visio diagrams in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Visio or other diagramming software to load and view Visio files within your Node.js application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/visio" >}} {{< icon "gdoc_person" >}} View Visio files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Visio file formats

GroupDocs.Viewer supports the following Visio file formats:

* [Visio Drawing](https://docs.fileformat.com/visio/vsdx/) (.VSDX)
* [Visio 2003-2010 Drawing](https://docs.fileformat.com/visio/vsd/) (.VSD)
* [Visio Macro-Enabled Drawing](https://docs.fileformat.com/visio/vsdm/) (.VSDM)
* [Visio Stencil](https://docs.fileformat.com/visio/vssx/) (.VSSX)
* [Visio 2003-2010 Stencil](https://docs.fileformat.com/visio/vss/) (.VSS)
* [Visio Macro-Enabled Stencil](https://docs.fileformat.com/visio/vssm/) (.VSSM)
* [Visio Template](https://docs.fileformat.com/visio/vstx/) (.VSTX)
* [Visio 2003-2010 Template](https://docs.fileformat.com/visio/vst/) (.VST)
* [Visio Macro-Enabled Template](https://docs.fileformat.com/visio/vstm/) (.VSTM)
* [Visio Drawing XML File](https://docs.fileformat.com/visio/vdx/) (.VDX)
* [Visio Stencil XML File](https://docs.fileformat.com/visio/vsx/) (.VSX)
* [Visio Template XML File](https://docs.fileformat.com/visio/vtx/) (.VTX)
* [Visio Web Drawing](https://docs.fileformat.com/visio/vdw/) (.VDW)

## Render Visio files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Visio file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "render-visio-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("flowchart.vsdx")
// Create an HTML file for each drawing page.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-visio-to-html-embedded/vsdx-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "flowchart.vsdx" >}}
{{< tab-text >}}
`flowchart.vsdx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-visio-documents/flowchart.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to HTML](/viewer/nodejs-java/images/rendering-basics/render-visio-documents/render-visio-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-visio-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("flowchart.vsdx")
// Create an HTML file for each drawing page.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-visio-to-html-external/vsdx-to-html-page_{0}.html", "render-visio-to-html-external/vsdx-to-html-page_{0}/resource_{0}_{1}", "render-visio-to-html-external/vsdx-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "flowchart.vsdx" >}}
{{< tab-text >}}
`flowchart.vsdx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-visio-documents/flowchart.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-visio-documents/render-visio-to-html-external-resources.png)

## Render Visio files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Visio file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-visio-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("flowchart.vsdx")
// Create a PDF file for the document.
// Specify the PDF file name.
const viewOptions = PdfViewOptions("render-visio-to-pdf/vsdx-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "flowchart.vsdx" >}}
{{< tab-text >}}
`flowchart.vsdx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-visio-documents/flowchart.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to PDF](/viewer/nodejs-java/images/rendering-basics/render-visio-documents/render-visio-to-pdf.png)

## Render Visio files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Visio file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-visio-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("flowchart.vsdx")
// Create a PNG image for each drawing page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-visio-to-png/vsdx-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "flowchart.vsdx" >}}
{{< tab-text >}}
`flowchart.vsdx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-visio-documents/flowchart.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Visio file to PNG](/viewer/nodejs-java/images/rendering-basics/render-visio-documents/render-visio-to-png-image.png)

## Render Visio files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Visio file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-visio-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("flowchart.vsdx")
// Create a JPEG image for each drawing page.
// {0} is replaced with the current page number in the image name.
const viewOptions = JpgViewOptions("render-visio-to-jpeg/vsdx-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "flowchart.vsdx" >}}
{{< tab-text >}}
`flowchart.vsdx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-visio-documents/flowchart.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render only diagram shapes

GroupDocs.Viewer allows you to render shapes used in a Visio diagram or stored in a Visio stencil file. These shapes are displayed in the **Document Stencil** pane in Microsoft Visio.

![Document Stencil pane in Visio](/viewer/nodejs-java/images/rendering-basics/render-visio-documents/visio-document-stencil.png)

To render only master shapes contained in Visio file, use the [VisioRenderingOptions.setRenderFiguresOnly](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/visiorenderingoptions/#setRenderFiguresOnly-boolean-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

The [VisioRenderingOptions.setFigureWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/visiorenderingoptions/#setFigureWidth-int-) method allows you to specify the shape width in pixels. The height is calculated automatically based on the aspect ratio of each shape.

{{< tabs "render-visio-shapes-only">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("flowchart.vsdx")
// Convert the Visio file to PDF.
const viewOptions = PdfViewOptions("render-visio-shapes-only/vsdx-to-pdf.pdf")
// Render the master shapes only.
viewOptions.getVisioRenderingOptions().setRenderFiguresOnly(true)
// Specify shape width in pixels.
viewOptions.getVisioRenderingOptions().setFigureWidth(200)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "flowchart.vsdx" >}}
{{< tab-text >}}
`flowchart.vsdx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-visio-documents/flowchart.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render master shapes only](/viewer/nodejs-java/images/rendering-basics/render-visio-documents/render-visio-shapes.png)

---

## Render Visio documents as HTML, PDF, and image files

Path: /viewer/python-net/render-visio-documents/

[GroupDocs.Viewer for Python via .Net](https://products.groupdocs.com/viewer/python-net) allows you to render your Visio diagrams in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Visio or other diagramming software to load and view Visio files within your .Net application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/visio" >}} {{< icon "gdoc_person" >}} View Visio files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.Net" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Visio file formats

GroupDocs.Viewer supports the following Visio file formats:

* [Visio Drawing](https://docs.fileformat.com/visio/vsdx/) (.VSDX)
* [Visio 2003-2010 Drawing](https://docs.fileformat.com/visio/vsd/) (.VSD)
* [Visio Macro-Enabled Drawing](https://docs.fileformat.com/visio/vsdm/) (.VSDM)
* [Visio Stencil](https://docs.fileformat.com/visio/vssx/) (.VSSX)
* [Visio 2003-2010 Stencil](https://docs.fileformat.com/visio/vss/) (.VSS)
* [Visio Macro-Enabled Stencil](https://docs.fileformat.com/visio/vssm/) (.VSSM)
* [Visio Template](https://docs.fileformat.com/visio/vstx/) (.VSTX)
* [Visio 2003-2010 Template](https://docs.fileformat.com/visio/vst/) (.VST)
* [Visio Macro-Enabled Template](https://docs.fileformat.com/visio/vstm/) (.VSTM)
* [Visio Drawing XML File](https://docs.fileformat.com/visio/vdx/) (.VDX)
* [Visio Stencil XML File](https://docs.fileformat.com/visio/vsx/) (.VSX)
* [Visio Template XML File](https://docs.fileformat.com/visio/vtx/) (.VTX)
* [Visio Web Drawing](https://docs.fileformat.com/visio/vdw/) (.VDW)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

{{< alert style="info" >}}Family of Visio file formats currently is not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

## Render Visio files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Visio file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_visio_to_html():
    # Load Visio document
    with Viewer("sample.vsdx") as viewer:
        # Create an HTML file for each drawing page.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_visio_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_visio_to_html()
```
{{< /tab >}}
{{< tab "sample.vsdx" >}}
{{< tab-text >}}
`sample.vsdx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-visio-documents/sample.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to HTML](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_visio_to_html_external():
    # Load Visio document
    with Viewer("sample.vsdx") as viewer:
        # Create an HTML file for each drawing page.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources(
            "render_visio_to_html_external/pdf_page_{0}.html", "render_visio_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_visio_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_visio_to_html_external()
```
{{< /tab >}}
{{< tab "sample.vsdx" >}}
{{< tab-text >}}
`sample.vsdx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-visio-documents/sample.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-html-external-resources.png)

## Render Visio files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Visio file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_visio_to_pdf():
    # Load Visio document
    with Viewer("sample.vsdx") as viewer:
        # Create a PDF file for the document.
        # Specify the PDF file name.
        viewOptions = PdfViewOptions("render_visio_to_pdf/visio_diagram.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_visio_to_pdf()
```
{{< /tab >}}
{{< tab "sample.vsdx" >}}
{{< tab-text >}}
`sample.vsdx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-visio-documents/sample.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Visio file to PDF](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-pdf.png)

## Render Visio files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Visio file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_visio_to_png():
    # Load Visio document
    with Viewer("sample.vsdx") as viewer:
        # Create a PNG image for each drawing page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_visio_to_png/visio_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 800
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_visio_to_png()
```
{{< /tab >}}
{{< tab "sample.vsdx" >}}
{{< tab-text >}}
`sample.vsdx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-visio-documents/sample.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render a Visio file to PNG](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-to-png-image.png)

## Render Visio files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Visio file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_visio_to_jpg():
    # Load Visio document
    with Viewer("sample.vsdx") as viewer:
        # Create a JPEG image for each drawing page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = JpgViewOptions("render_visio_to_jpg/visio_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 800
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_visio_to_jpg()
```
{{< /tab >}}
{{< tab "sample.vsdx" >}}
{{< tab-text >}}
`sample.vsdx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-visio-documents/sample.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render only diagram shapes

GroupDocs.Viewer allows you to render shapes used in a Visio diagram or stored in a Visio stencil file. These shapes are displayed in the **Document Stencil** pane in Microsoft Visio.

![Document Stencil pane in Visio](/viewer/net/images/rendering-basics/render-visio-documents/visio-document-stencil.png)

To render only master shapes contained in Visio file, enable the [VisioRenderingOptions.render_figures_only](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/visiorenderingoptions/#properties) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

The [VisioRenderingOptions.figure_width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/visiorenderingoptions/#properties) property allows you to specify the shape width in pixels. The height is calculated automatically based on the aspect ratio of each shape.

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_visio_shapes_only():
    # Load Visio document
    with Viewer("map.vsdx") as viewer:
        # Convert the Visio file to PDF.
        viewOptions = PdfViewOptions("render_visio_shapes_only/visio_shapes_only.pdf")
        # Render the master shapes only.
        viewOptions.visio_rendering_options.render_figures_only = True
        # Specify shape width in pixels.
        viewOptions.visio_rendering_options.figure_width = 200
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_visio_shapes_only()
```
{{< /tab >}}
{{< tab "map.vsdx" >}}
{{< tab-text >}}
`map.vsdx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-visio-documents/map.vsdx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Render master shapes only](/viewer/net/images/rendering-basics/render-visio-documents/render-visio-shapes.png)

---

## Running in Docker

Path: /comparison/nodejs-java/running-in-docker/


This guide shows how to run GroupDocs.Comparison for Node.js via Java inside a Docker container using a minimal example.

## Limitations

- Linux containers are recommended and fully supported.
- Ensure adequate fonts are installed in the container for accurate text layout.
- For Metered licensing, outbound internet access is required to report consumption. File-license mode works fully offline.

## Dependencies

We are going to build the Docker image in two stages to minimize the final image size. In the first stage we build the application, and in the second stage we run it.

The key dependencies for the build stage are Node.js, JDK (Java Development Kit), and build tools. The final runtime stage requires only Node.js and JRE (Java Runtime).  

## Basic Example

This is a practical example showing how to compare two documents in a Docker container using the sample code. The final Docker image can be run as an application by passing the source files for comparison, the output file name, and an optional license file. See the [Temporary License](https://purchase.groupdocs.com/temporary-license/) page for more details.

{{< alert style="info" >}}
You can download this sample application from [here](/comparison/nodejs-java/_sample_files/getting-started/running-in-docker/basic-example.zip).

{{< /alert >}}

### Project Structure

```text
📂 basic-example/
├── 📂 work/                           
│   ├── 📄 proposal_v1.docx             # Input document – first version
│   ├── 📄 proposal_v2.docx             # Input document – second version
│   └── 📄 GroupDocs.Comparison.lic     # The license file (optional)
├── 📄 .dockerignore                    # Files to exclude from Docker build context
├── 📄 Dockerfile                       # Docker container definition
├── 📄 package.json                     # Node.js project file
├── 📄 diff-files.js                    # Main application code
└── 📄 README.md                        # App readme
```

Let’s look at the most essential parts of the application:

{{< tabs "example_run_in_docker" >}}

{{< tab "diff-files.js" >}}  
{{< highlight js "" >}}

'use strict';

const groupdocs = require('@groupdocs/groupdocs.comparison');

// Get the source, target, output, and license paths from the command line arguments
const [sourcePath, targetPath, outputPath, licensePathArg] = process.argv.slice(2);

// Get the license path from the command line arguments or the environment variable
const licensePath = licensePathArg || process.env.GROUPDOCS_LICENSE_PATH;
if (licensePath) {
	const license = new groupdocs.License()
	license.setLicense(licensePath);
}

// Create a new comparer instance and add the source and target files
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target file to the comparer
comparer.add(targetPath);

// Compare the source and target files and save the output to the output path
comparer.compare(outputPath);



{{< /highlight >}}
{{< /tab >}}

{{< tab "package.json" >}}  
{{< highlight json "" >}}

{
  "name": "GroupDocs.Comparison for Node.js via Java Example",
  "version": "1.0.0",
  "private": true,
  "main": "diff-files.js",
  "license": "MIT",
  "scripts": {
    "start": "node diff-files.js",
    "dev": "node diff-files.js"
  },
  "engines": {
    "node": ">=20"
  },
  "dependencies": {
    "@groupdocs/groupdocs.comparison": "^25.11.0"
  }
}

{{< /highlight >}}
{{< /tab >}}

{{< tab "Dockerfile" >}}  
{{< highlight dockerfile "" >}}

# Build stage – compiles native module and installs dependencies
FROM node:20-bullseye AS build
RUN apt-get update && apt-get install -y \
    openjdk-17-jdk-headless \
    build-essential

# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm install --omit=dev

# Copy the rest of the app
COPY . .

# Final stage – slim runtime image
FROM node:20-bullseye-slim AS final

# Install Java runtime
RUN apt-get update && apt-get install -y \
    openjdk-17-jre-headless  
    
# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy built application and node_modules from the build stage
COPY --from=build /app .

# Set the entry point and default command
ENTRYPOINT ["node", "/app/diff-files.js"]
CMD ["--help"]

{{< /highlight >}}
{{< /tab >}}

{{< tab "Input files" >}}  
{{< tab-text >}}
Sample input files [proposal_v1.docx](/comparison/nodejs-java/_sample_files/getting-started/running-in-docker/proposal_v1.docx) and [proposal_v2.docx](/comparison/nodejs-java/_sample_files/getting-started/running-in-docker/proposal_v2.docx) to compare.
{{< /tab-text >}}
{{< /tab >}}

{{< /tabs >}}

### Building the Docker Image

To create the Docker image, run the following command in the directory containing the `Dockerfile`:

```bash
docker build -t groupdocs-comparison-sample:latest .
```

### Running the Application

In this example we mount the `work` directory and use it both to pass source files into the container and to store the comparison result.

If you do not have a license file, you can use the following command that omits the last parameter. GroupDocs.Comparison will work in trial mode.

```bash
docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-comparison-sample:latest proposal_v1.docx proposal_v2.docx proposal_diff.docx
```

You can add a license parameter if you have a trial or full license file:

```bash
docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-comparison-sample:latest proposal_v1.docx proposal_v2.docx proposal_diff.docx GroupDocs.Comparison.lic
```

#### Command Explanation

- `--rm`: Automatically removes the container when it exits
- `-v`: Mounts the host directory to the container directory for file output
- `-w`: Sets the working directory inside container

### App Output

The app compares two DOCX files and outputs [proposal_diff.docx](/comparison/nodejs-java/_sample_files/getting-started/running-in-docker/proposal_diff.docx) in the `work` folder. The output file contains differences and a summary page on changes. 

## Troubleshooting

### Font Issues

If you encounter missing glyphs or layout differences, install additional fonts:

```dockerfile
RUN apt-get update && apt-get install -y fonts-liberation fonts-dejavu-core && rm -rf /var/lib/apt/lists/*
```

### node-gyp Build Errors

- Ensure `build-essential` and `python3` are installed.
- Rebuild if needed: `npm rebuild`.

### Java Not Found

- Confirm OpenJDK is installed and `JAVA_HOME`/`PATH` are set in the image.

### Permissions or Volume Mounts

- Verify the mounted directories exist and are writable by the container user.

---

For general setup details, see [System Requirements]({{< ref "comparison/nodejs-java/getting-started/system-requirements" >}}) and [Installation]({{< ref "comparison/nodejs-java/getting-started/installation" >}}).

---

## Running in Docker

Path: /conversion/nodejs-java/running-in-docker/


This guide shows how to run GroupDocs.Conversion for Node.js via Java inside a Docker container using a minimal example.

## Limitations

- Linux containers are recommended and fully supported.
- Ensure adequate fonts are installed in the container for accurate text layout.
- For Metered licensing, outbound internet access is required to report consumption. File-license mode works fully offline.

## Dependencies

We are going to build the Docker image in two stages to minimize the final image size. In the first stage we build the application, and in the second stage we run it.

The key dependencies for the build stage are Node.js, JDK (Java Development Kit), and build tools. The final runtime stage requires only Node.js and JRE (Java Runtime).  

## Basic Example

This is a practical example showing how to convert a document in a Docker container using the sample code. The final Docker image can be run as an application by passing the source file, output file name, output format, and an optional license file. See the [Temporary License](https://purchase.groupdocs.com/temporary-license/) page for more details.

{{< alert style="info" >}}
You can download this sample application from [here](/conversion/nodejs-java/_sample_files/getting-started/running-in-docker/basic-example.zip).

{{< /alert >}}

### Project Structure

```text
📂 basic-example/
├── 📂 work/                           
│   ├── 📄 source.docx                  # Input document to convert
│   └── 📄 GroupDocs.Conversion.lic     # The license file (optional)
├── 📄 .dockerignore                    # Files to exclude from Docker build context
├── 📄 Dockerfile                       # Docker container definition
├── 📄 package.json                     # Node.js project file
├── 📄 convert-file.js                  # Main application code
└── 📄 README.md                        # App readme
```

Let’s look at the most essential parts of the application:

{{< tabs "example_run_in_docker" >}}

{{< tab "convert-file.js" >}}  
{{< highlight js "" >}}

'use strict';

// Import required modules
const groupdocs = require('@groupdocs/groupdocs.conversion');
const path = require('path')

// Get the source, output, and license paths from the command line arguments
const [sourcePath, outputPath, licensePath] = process.argv.slice(2);

// Get the license path from the command line arguments
if (licensePath) {
  const license = new groupdocs.License()
  license.setLicense(path.join(__dirname, licensePath));
}

// Create a new converter instance and load the source file
const converter = new groupdocs.Converter(sourcePath);

// Set the convert options for PDF format
const options = new groupdocs.PdfConvertOptions();

// Convert the file and save to the output path
converter.convert(outputPath, options);

// Exit the process
process.exit(0);

{{< /highlight >}}
{{< /tab >}}

{{< tab "package.json" >}}  
{{< highlight json "" >}}

{
  "name": "GroupDocs.Conversion for Node.js via Java Example",
  "version": "1.0.0",
  "private": true,
  "main": "convert-file.js",
  "license": "MIT",
  "scripts": {
    "start": "node convert-file.js",
    "dev": "node convert-file.js"
  },
  "engines": {
    "node": ">=20"
  },
  "dependencies": {
    "@groupdocs/groupdocs.conversion": "^25.11.0"
  }
}

{{< /highlight >}}
{{< /tab >}}

{{< tab "Dockerfile" >}}  
{{< highlight dockerfile "" >}}

# Build stage – compiles native module and installs dependencies
FROM node:20-bullseye AS build
RUN apt-get update && apt-get install -y \
    openjdk-17-jdk-headless \
    build-essential

# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm install --omit=dev

# Copy the rest of the app
COPY . .

# Final stage – slim runtime image
FROM node:20-bullseye-slim AS final

# Install Java runtime
RUN apt-get update && apt-get install -y \
    openjdk-17-jre-headless  
    
# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy built application and node_modules from the build stage
COPY --from=build /app .

# Set the entry point and default command
ENTRYPOINT ["node", "/app/convert-file.js"]
CMD ["--help"]

{{< /highlight >}}
{{< /tab >}}

{{< tab "Input file" >}}  
{{< tab-text >}}
Sample input file [source.docx](/conversion/nodejs-java/_sample_files/getting-started/running-in-docker/source.docx) to convert.
{{< /tab-text >}}
{{< /tab >}}

{{< /tabs >}}

### Building the Docker Image

To create the Docker image, run the following command in the directory containing the `Dockerfile`:

```bash
docker build -t groupdocs-conversion-sample:latest .
```

### Running the Application

In this example we mount the `work` directory and use it both to pass source files into the container and to store the conversion result.

If you do not have a license file, you can use the following command that omits the last parameter. GroupDocs.Conversion will work in trial mode.

```bash
docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-conversion-sample:latest source.docx converted.pdf
```

You can add a license parameter if you have a trial or full license file:

```bash
docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-conversion-sample:latest source.docx converted.pdf GroupDocs.Conversion.lic
```

#### Command Explanation

- `--rm`: Automatically removes the container when it exits
- `-v`: Mounts the host directory to the container directory for file output
- `-w`: Sets the working directory inside container

### App Output

The app converts a DOCX file to PDF and outputs [converted.pdf](/conversion/nodejs-java/_sample_files/getting-started/running-in-docker/converted.pdf) in the `work` folder. The output file contains the converted document in PDF format. 

## Troubleshooting

### Font Issues

If you encounter missing glyphs or layout differences, install additional fonts:

```dockerfile
RUN apt-get update && apt-get install -y fonts-liberation fonts-dejavu-core && rm -rf /var/lib/apt/lists/*
```

### node-gyp Build Errors

- Ensure `build-essential` and `python3` are installed.
- Rebuild if needed: `npm rebuild`.

### Java Not Found

- Confirm OpenJDK is installed and `JAVA_HOME`/`PATH` are set in the image.

### Permissions or Volume Mounts

- Verify the mounted directories exist and are writable by the container user.

---

For general setup details, see [System Requirements]({{< ref "conversion/nodejs-java/getting-started/system-requirements" >}}) and [Installation]({{< ref "conversion/nodejs-java/getting-started/installation" >}}).

---

## Running in Docker

Path: /signature/python-net/getting-started/running-in-docker/


In this guide, you'll learn how to run GroupDocs.Signature for Python via .NET inside a Docker container using simple code examples.

## Limitations

Currently, not all GroupDocs Python APIs support Linux. This limitation will be addressed in upcoming releases.

APIs that support Linux are the following:

* [groupdocs‑comparison‑net](https://pypi.org/project/groupdocs-comparison-net/)
* [groupdocs‑watermark‑net](https://pypi.org/project/groupdocs-watermark-net/)
* [groupdocs‑metadata‑net](https://pypi.org/project/groupdocs-metadata-net/)
* [groupdocs‑merger‑net](https://pypi.org/project/groupdocs-merger-net/)

{{< alert style="warning" >}}
GroupDocs.Signature for Python via .NET Linux support is currently limited. Please check the [System Requirements]({{< ref "signature/python-net/system-requirements" >}}) page for the latest supported platforms. Full Linux support will be available in upcoming releases.
{{< /alert >}}

This guide demonstrates how to use GroupDocs.Signature for Python via .NET in a Docker container, assuming Linux support is available in your version.

## Dependencies

When using the GroupDocs Python SDK in a Linux environment, make sure the following packages are installed, as they are required for proper library operation:

* `libicu` — ICU library (must not exceed version 70)
* `libssl1.1` — OpenSSL library required by .NET Core 3.1

## Basic Example

This is the most basic example that shows how to run GroupDocs.Signature for Python via .NET in Docker. The example demonstrates how to sign a PDF file with a text signature using GroupDocs.Signature in a Docker container.

{{< alert style="info" >}}
You can download this sample application from [here](/signature/python-net/_sample_files/getting-started/running-in-docker/basic-example.zip).
{{< /alert >}}

### Project Structure

The sample application has the following folder structure:

```
📂 basic-example/
├── 📂 output/                   # Output directory for signed files
├── 📄 .dockerignore             # Files to exclude from Docker build context
├── 📄 sample.pdf                # Sample input document to sign
├── 📄 Dockerfile                # Docker container definition
├── 📄 GroupDocs.Signature.PythonViaNET.lic  # License file (optional)
├── 📄 sign_pdf_with_text.py     # Main application code
├── 📄 README.md                 # Build and run instructions
└── 📄 requirements.txt          # Application dependencies
```

We're using a Python 3.11 slim image and installing required .NET dependencies `libicu` and `libssl1.1` manually.
Here are the most essential parts:

{{< tabs "example_run_in_docker" >}}

{{< tab "Dockerfile" >}}  
{{< highlight dockerfile "" >}}
# Use Python 3.11 slim base image which is smaller than the default base image
FROM python:3.11-slim

# Install prerequisites from a reliable source
ENV SNAPSHOT_DATE=20220328T000000Z
RUN echo "deb [trusted=yes] http://snapshot.debian.org/archive/debian/${SNAPSHOT_DATE} bullseye main" \
        > /etc/apt/sources.list.d/debian-archive.list && \
    apt-get -o Acquire::Check-Valid-Until=false update && \
    apt-get install -y --no-install-recommends \
        libicu67 \
        libssl1.1 && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

# Set workdir 
WORKDIR /app

# Install Python dependencies
COPY requirements.txt ./
RUN pip install -r requirements.txt

# Copy the rest of the app
COPY . .

# Run the app
CMD ["python", "sign_pdf_with_text.py"]
{{< /highlight >}}
{{< /tab >}}

{{< tab "sign_pdf_with_text.py" >}}  
{{< highlight python "" >}}
import os
import groupdocs.signature as gs
import groupdocs.signature.options as gso

def sign_pdf_with_text_signature():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Signature.PythonViaNET.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = gs.License()
        license.set_license(license_path)

    # Ensure output directory exists
    os.makedirs("./output", exist_ok=True)

    # The path to the input PDF file
    sample_pdf = "./sample.pdf"
    
    # The path to the output directory
    output_file_path = "./output/signed_sample.pdf"

    # Sign document with text signature
    with gs.Signature(sample_pdf) as signature:
        text_sign_options = gso.TextSignOptions("Hello from Docker!")
        signature.sign(output_file_path, text_sign_options)

    print(f"\nSource document signed successfully.\nFile saved at {output_file_path}")

if __name__ == "__main__":
    sign_pdf_with_text_signature()
{{< /highlight >}}
{{< /tab >}}

{{< tab "requirements.txt" >}}  
{{< highlight text "" >}}
groupdocs-signature-net>=25.4
{{< /highlight >}}
{{< /tab >}}

{{< tab "Input files" >}}  
{{< tab-text >}}
Sample input file [sample.pdf](/signature/python-net/_sample_files/getting-started/running-in-docker/sample.pdf).
{{< /tab-text >}}
{{< /tab >}}

{{< /tabs >}}

### Building and Running the Application

To create the Docker image, run the following command in the directory containing the Dockerfile:

```bash
docker build -t groupdocs-signature-net:basic-example .
```

To run the application and mount the output directory:

```bash
docker run -it --rm -v ${PWD}/output:/app/output groupdocs-signature-net:basic-example
```

### Command Explanation

- `-it`: Runs the container in interactive mode
- `--rm`: Automatically removes the container when it exits
- `-v`: Mounts the host directory to the container directory for file output

### App Output

The app creates the signed PDF file [signed_sample.pdf](/signature/python-net/_sample_files/getting-started/running-in-docker/signed_sample.pdf) in the `output` folder.


## Troubleshooting

### Font Issues

If you encounter font-related errors:

```bash
# Install additional fonts
RUN apt-get update && apt-get install -y fonts-liberation fonts-dejavu-core
```

### Exceptions

In case you experience any other exceptions when running the application please contact us using the [GroupDocs Free Support Forum](https://forum.groupdocs.com/) and we'll be happy to help.


---

## Running in Docker

Path: /total/net/running-in-docker/


In this documentation topic you will learn how to run GroupDocs.Total for .NET in Docker container based on simple code examples.

## Limitations

If the target framework is .NET 6 or over, due to limitations in the System.Drawing.Common version 6.0.0 (see [Microsoft documentation](https://learn.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only#new-behavior)), you need to add the following setting to the `.csproj` file.

```xml
<ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Drawing.EnableUnixSupport" Value="true" />
</ItemGroup>
```

or you can also add `runtimeconfig.json` file to the root of you project 

```json
{
  "configProperties": {
    "System.Drawing.EnableUnixSupport": true
  }
}
```
## Dependencies

When using GroupDocs.Total in Linux environment, the following packages should be installed as they are required for the proper library work:

1. **libgdiplus** - is the Mono library that provides a GDI+-compatible API on non-Windows operating systems.
2. **libx11-dev** - Needed for drawing functions (image/font rendering).
3. **fontconfig** - Enables font lookup for text rendering with System.Drawing.
4. **ttf-mscorefonts-installer** - package with Microsoft compatible fonts, required for GroupDocs.Total.
 
To install packages on Debian-based Linux distributions use [apt-get](https://wiki.debian.org/apt-get) utility:

```bash
sudo apt-get update
sudo apt-get install -y libgdiplus libx11-dev fontconfig ttf-mscorefonts-installer
```

In case packages are not available, you can add the contrib repository:

```bash
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
```

## Basic Example

This is the most basic example that shows how to run GroupDocs.Total for .NET in Docker. The example demonstrates document conversion functionality using a simple console application.

{{< alert style="info" >}}
You can download this sample application from [here](/total/net/_sample_files/getting-started/running-in-docker/basic-example.zip).
{{< /alert >}}

### Project Structure

The sample application has the following folder structure:

```
📂 basic-example/
├── 📂 output/                   # Output directory for converted files
├── 📄 .dockerignore             # Files to exclude from Docker build context
├── 📄 business-plan.docx        # Sample input document
├── 📄 Dockerfile                # Docker container definition
├── 📄 GroupDocs.Total.lic       # License file (optional)
├── 📄 Program.cs                # Main application code
├── 📄 BasicExample.csproj       # .NET project file
└── 📄 BasicExample.sln          # Visual Studio solution file
```

We're using the official Microsoft .NET 6 SDK image to build and run the application. This approach provides a complete development environment with all necessary tools. Here are the most essential parts:

{{< tabs "example1" >}}

{{< tab "Dockerfile" >}}  
{{< highlight dockerfile "" >}}
FROM mcr.microsoft.com/dotnet/sdk:6.0
WORKDIR /app

# Install dependencies
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
RUN apt update && apt install -y \
    libgdiplus \
    libx11-dev \
    fontconfig \
    ttf-mscorefonts-installer

# Copy the app
COPY . .

# Run the app
ENTRYPOINT ["dotnet", "run", "--framework", "net6.0", "--verbosity", "normal"]
{{< /highlight >}}
{{< /tab >}}

{{< tab "Program.cs" >}}  
{{< highlight cs "" >}}
using System.IO;
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

// Set the license (Optional)
string licensePath = Path.GetFullPath("./GroupDocs.Total.lic");
License license = new License();
license.SetLicense(licensePath);

// Initialize convert options and converter
PdfConvertOptions options = new PdfConvertOptions();
Converter converter = new Converter("./business-plan.docx");

// Convert and save file
converter.Convert("./output/business-plan.pdf", options);
{{< /highlight >}}
{{< /tab >}}

{{< tab "BasicExample.csproj" >}}  
{{< highlight xml "" >}}
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Drawing.EnableUnixSupport" Value="true" />
  </ItemGroup>

  <ItemGroup>
    <PackageReference Include="GroupDocs.Total" Version="26.3.0" />
  </ItemGroup>

</Project>
{{< /highlight >}}
{{< /tab >}}

{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
Sample input file: [Download business-plan.docx](/total/net/_sample_files/getting-started/running-in-docker/business-plan.docx)
{{< /tab-text >}}
{{< /tab >}}

{{< /tabs >}}

### Building and Running the Application

To create the Docker image, run the following command in the directory containing the Dockerfile:

```bash
docker build -t groupdocs-total:basic-example .
```

To run the application and mount the output directory:

{{< tabs "run-commands" >}}
{{< tab "Windows (PowerShell)" >}}
```bash
docker run -it --rm -v ${PWD}/output:/app/output groupdocs-total:basic-example
```
{{< /tab >}}
{{< tab "Windows (Command Prompt)" >}}
```cmd
docker run -it --rm -v %cd%/output:/app/output groupdocs-total:basic-example
```
{{< /tab >}}
{{< tab "Linux/macOS" >}}
```bash
docker run -it --rm -v $(pwd)/output:/app/output groupdocs-total:basic-example
```
{{< /tab >}}
{{< /tabs >}}

The application creates the output `business-plan.pdf` file and places it into the `output` folder on your host machine. You can download expected output file from [here](/total/net/_sample_files/getting-started/running-in-docker/business-plan.pdf).

### Command Explanation

- `-it`: Runs the container in interactive mode
- `--rm`: Automatically removes the container when it exits
- `-v`: Mounts the host directory to the container directory for file output

## Troubleshooting

The most common issues that can be resolved right away are **font-related problems**. Typically, you need to install the appropriate font that supports the character set used in your documents.

### Chinese Characters

If your documents contain Chinese text and characters do not display correctly, you may need to install the **SimSun** font.

#### Option 1: Copy from a Windows machine

You can copy the `SimSun` font file (`simsun.ttc`) from a Windows system and include it in your Docker image:

```bash
# Copy SimSun font from local directory into the container
COPY simsun.ttc /usr/share/fonts/truetype/simsun.ttc

# Update font cache
RUN fc-cache -f -v
```

> 💡 Tip: You can find `simsun.ttc` in `C:\Windows\Fonts` on a Windows machine.

#### Option 2: Install compatible CJK font

Alternatively, you can download and install a compatible CJK font package directly in your Dockerfile:

```bash
# Install Chinese fonts
RUN apt-get update && apt-get install -y fonts-arphic-ukai fonts-arphic-uming
```

These fonts provide good coverage for Simplified and Traditional Chinese characters.

### Other Font Issues

If you encounter other font-related errors, install the following packages:

```bash
# Install additional fonts
RUN apt-get update && apt-get install -y fonts-liberation fonts-dejavu-core
```

#### fonts-liberation

Provides free replacements for Microsoft’s proprietary fonts. Many documents, especially DOCX, PPTX, and PDFs, use Microsoft fonts. On Linux systems, these aren’t available by default, so `fonts-liberation` ensures text renders correctly and preserves layout without needing the actual Microsoft fonts.

Includes:

* Liberation Sans → substitute for Arial  
* Liberation Serif → substitute for Times New Roman  
* Liberation Mono → substitute for Courier New

#### fonts-dejavu-core

Provides high-quality, Unicode-complete fonts that extend the Bitstream Vera family. It offers very wide Unicode coverage, meaning it supports many symbols, mathematical characters, and international scripts. It’s a default choice in many Linux distributions for general-purpose text rendering.

Includes:

* DejaVu Sans  
* DejaVu Serif  
* DejaVu Sans Mono

### Exceptions or Errors

If you experience any other exceptions when running the application, please contact us using the [GroupDocs Free Support Forum](https://forum.groupdocs.com/) and we'll be happy to help.


---

## Running in Docker

Path: /total/python-net/running-in-docker/


In this guide, you’ll learn how to run GroupDocs.Total for Python via .NET inside a Docker container using simple code examples.

## Limitations

Currently, not all GroupDocs Python APIs support Linux. This limitation will be addressed in upcoming releases.

APIs that support Linux are the following:

* [groupdocs‑comparison‑net](https://pypi.org/project/groupdocs-comparison-net/)
* [groupdocs‑watermark‑net](https://pypi.org/project/groupdocs-watermark-net/)
* [groupdocs‑metadata‑net](https://pypi.org/project/groupdocs-metadata-net/)
* [groupdocs‑merger‑net](https://pypi.org/project/groupdocs-merger-net/)

This guide will show how to use GroupDocs.Merger for Python via .NET in Docker container.

## Dependencies

When using the GroupDocs Python SDK in a Linux environment, make sure the following packages are installed, as they are required for proper library operation:

* `libicu` — ICU library (must not exceed version 70)
* `libssl1.1` — OpenSSL library required by .NET Core 3.1

## Basic Example

This is the most basic example that shows how to run GroupDocs Python APIs in Docker. The example demonstrates how to merge tow DOCX files using GroupDocs.Merger in Docker container.

{{< alert style="info" >}}
You can download this sample application from [here](/total/net/_sample_files/getting-started/running-in-docker/basic-example.zip).
{{< /alert >}}

### Project Structure

The sample application has the following folder structure:

```
📂 basic-example/
├── 📂 output/                   # Output directory for converted files
├── 📄 .dockerignore             # Files to exclude from Docker build context
├── 📄 appendix.docx             # Sample input document to merge
├── 📄 beginning.docx            # Sample input document to merge
├── 📄 Dockerfile                # Docker container definition
├── 📄 GroupDocs.Total.lic       # License file (optional)
├── 📄 merge_docx_files.py       # Main application code
├── 📄 README.md                 # Build and run instructions
└── 📄 requirements.txt          # Application dependencies
```

We’re using a Python 3.11 slim image and installing required .NET dependencies `libicu` and `libssl1.1` manually.
Here are the most essential parts:

{{< tabs "example_run_in_docker" >}}

{{< tab "Dockerfile" >}}  
{{< highlight dockerfile "" >}}
# Use Python 3.11 slim base image which is smaller than the default base image
FROM python:3.11-slim

# Install prerequisites from a reliable source
ENV SNAPSHOT_DATE=20220328T000000Z
RUN echo "deb [trusted=yes] http://snapshot.debian.org/archive/debian/${SNAPSHOT_DATE} bullseye main" \
        > /etc/apt/sources.list.d/debian-archive.list && \
    apt-get -o Acquire::Check-Valid-Until=false update && \
    apt-get install -y --no-install-recommends \
        libicu67 \
        libssl1.1 && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

# Set workdir 
WORKDIR /app

# Install Python dependencies
COPY requirements.txt ./
RUN pip install -r requirements.txt

# Copy the rest of the app
COPY . .

# Run the app
CMD ["python", "merge_docx_files.py"]
{{< /highlight >}}
{{< /tab >}}

{{< tab "merge_docx_files.py" >}}  
{{< highlight python "" >}}
import os
from groupdocs.merger import License, Merger

def merge_docx_files():
    # Get license file absolute path
    license_path = os.path.abspath("./GroupDocs.Total.lic")

    if os.path.exists(license_path):
        # Create License and set the path
        license = License()
        license.set_license(license_path)

    # Ensure output directory exists
    os.makedirs("./output", exist_ok=True)

    # Initialize the merger
    with Merger("./beginning.docx") as merger:
        # Append appendix.docx to beginning.docx
        merger.join("./appendix.docx")
        # Save the merged document
        merger.save("./output/merged.docx")

if __name__ == "__main__":
    merge_docx_files()
{{< /highlight >}}
{{< /tab >}}

{{< tab "requirements.txt" >}}  
{{< highlight text "" >}}
groupdocs-merger-net>=25.3
{{< /highlight >}}
{{< /tab >}}

{{< tab "Input files" >}}  
{{< tab-text >}}
Sample input files [beginning.docx](/total/python-net/_sample_files/getting-started/running-in-docker/beginning.docx) and [appendix.docx](/total/python-net/_sample_files/getting-started/running-in-docker/appendix.docx).
{{< /tab-text >}}
{{< /tab >}}

{{< /tabs >}}

### Building and Running the Application

To create the Docker image, run the following command in the directory containing the Dockerfile:

```bash
docker build -t groupdocs-merger-net:basic-example .
```

To run the application and mount the output directory:

```bash
docker run -it --rm -v ${PWD}/output:/app/output groupdocs-merger-net:basic-example
```

### Command Explanation

- `-it`: Runs the container in interactive mode
- `--rm`: Automatically removes the container when it exits
- `-v`: Mounts the host directory to the container directory for file output


### App Output

The app creates the merged DOCX file [merged.docx](/total/python-net/_sample_files/getting-started/running-in-docker/merged.docx) in the `output` folder.


## Troubleshooting

### Font Issues

If you encounter font-related errors:

```bash
# Install additional fonts
RUN apt-get update && apt-get install -y fonts-liberation fonts-dejavu-core
```

### Exceptions

In case you experience any other exeptions when running the application please contact us using the [GroupDocs Free Support Forum](https://forum.groupdocs.com/) and we'll be happy to help.

---

## Running in Docker

Path: /viewer/nodejs-java/running-in-docker/


This guide shows how to run GroupDocs.Viewer for Node.js via Java inside a Docker container using a minimal example.

## Limitations

- Linux containers are recommended and fully supported.
- Ensure adequate fonts are installed in the container for accurate text layout.
- For Metered licensing, outbound internet access is required to report consumption. File-license mode works fully offline.

## Dependencies

We are going to build the Docker image in two stages to minimize the final image size. In the first stage we build the application, and in the second stage we run it.

The key dependencies for the build stage are Node.js, JDK (Java Development Kit), and build tools. The final runtime stage requires only Node.js and JRE (Java Runtime).  

## Basic Example

This is a practical example showing how to render a document in a Docker container using the sample code. The final Docker image can be run as an application by passing the source file for rendering, the output file name, and an optional license file. See the [Temporary License](https://purchase.groupdocs.com/temporary-license/) page for more details.

{{< alert style="info" >}}
You can download this sample application from [here](/viewer/nodejs-java/_sample_files/getting-started/running-in-docker/basic-example.zip).

{{< /alert >}}

### Project Structure

```text
📂 basic-example/
├── 📂 work/                           
│   ├── 📄 sample.pdf                  # Input document to render
│   └── 📄 GroupDocs.Viewer.lic        # The license file (optional)
├── 📄 .dockerignore                   # Files to exclude from Docker build context
├── 📄 Dockerfile                      # Docker container definition
├── 📄 package.json                    # Node.js project file
├── 📄 render-file.js                  # Main application code
└── 📄 README.md                       # App readme
```

Let's look at the most essential parts of the application:

{{< tabs "example_run_in_docker" docs-to-code-examples-skip >}}
{{< tab "render-file.js" >}}  
```js
import { Viewer, License, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

// Get the input file, output path, and license paths from the command line arguments
const [inputPath, outputPath, licensePathArg] = process.argv.slice(2);

// Get the license path from the command line arguments or the environment variable
const licensePath = licensePathArg || process.env.GROUPDOCS_LICENSE_PATH;
if (licensePath) {
  const license = new License();
  license.setLicense(licensePath);
}

// Create a new viewer instance
const viewer = new Viewer(inputPath);

// Render the file to HTML
const viewOptions = HtmlViewOptions.forEmbeddedResources(outputPath + '/page_{0}.html');
viewer.view(viewOptions);

// Exit the process
process.exit(0);
```
{{< /tab >}}

{{< tab "package.json" >}}  
{{< highlight json "" >}}

{
  "name": "GroupDocs.Viewer for Node.js via Java Example",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "main": "render-file.js",
  "license": "MIT",
  "scripts": {
    "start": "node render-file.js"
  },
  "engines": {
    "node": ">=20"
  },
  "dependencies": {
    "@groupdocs/groupdocs.viewer": "^25.12.0"
  }
}

{{< /highlight >}}
{{< /tab >}}

{{< tab "Dockerfile" >}}  
{{< highlight dockerfile "" >}}

# Build stage – compiles native module and installs dependencies
FROM node:20-bullseye AS build
RUN apt-get update && apt-get install -y \
    openjdk-17-jdk-headless \
    build-essential

# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm install --omit=dev

# Copy the rest of the app
COPY . .

# Final stage – slim runtime image
FROM node:20-bullseye-slim AS final

# Install Java runtime
RUN apt-get update && apt-get install -y \
    openjdk-17-jre-headless  
    
# Clean up cache
RUN rm -rf /var/lib/apt/lists/*

# Set JAVA_HOME and update PATH
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# Set working directory
WORKDIR /app

# Copy built application and node_modules from the build stage
COPY --from=build /app .

# Set the entry point and default command
ENTRYPOINT ["node", "/app/render-file.js"]
{{< /highlight >}}
{{< /tab >}}

{{< tab "Input file" >}}  
{{< tab-text >}}
Sample input file [sample.pdf](/viewer/nodejs-java/_sample_files/getting-started/running-in-docker/sample.pdf) to render.
{{< /tab-text >}}
{{< /tab >}}

{{< /tabs >}}

### Building the Docker Image

To create the Docker image, run the following command in the directory containing the `Dockerfile`:

```bash
docker build -t groupdocs-viewer-sample:latest .
```

### Running the Application

In this example we mount the `work` directory and use it both to pass source files into the container and to store the rendered output.

If you do not have a license file, you can use the following command that omits the last parameter. GroupDocs.Viewer will work in trial mode.

```bash
docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-viewer-sample:latest sample.pdf output
```

You can add a license parameter if you have a trial or full license file:

```bash
docker run --rm -v "${pwd}/work:/work" -w /work groupdocs-viewer-sample:latest sample.pdf output GroupDocs.Viewer.lic
```

#### Command Explanation

- `--rm`: Automatically removes the container when it exits
- `-v`: Mounts the host directory to the container directory for file output
- `-w`: Sets the working directory inside container

### App Output

The app renders a PDF file and outputs HTML files in the `work` folder. The output contains rendered pages in HTML format.

## Troubleshooting

### Font Issues

If you encounter missing glyphs or layout differences, install additional fonts:

```dockerfile
RUN apt-get update && apt-get install -y fonts-liberation fonts-dejavu-core && rm -rf /var/lib/apt/lists/*
```

### node-gyp Build Errors

- Ensure `build-essential` and `python3` are installed.
- Rebuild if needed: `npm rebuild`.

### Java Not Found

- Confirm OpenJDK is installed and `JAVA_HOME`/`PATH` are set in the image.

### Permissions or Volume Mounts

- Verify the mounted directories exist and are writable by the container user.

---

For general setup details, see [System Requirements]({{< ref "viewer/nodejs-java/getting-started/system-requirements" >}}) and [Installation]({{< ref "viewer/nodejs-java/getting-started/installation" >}}).


---

## Save with default options

Path: /redaction/java/save-with-default-options/

The simplest way to save the document is it provide no parameters to Save method. In this case the document will be rasterized to PDF and will have the same name as the original one except its extension (.PDF). The PDF file will be overwritten.

The following example demonstrates usage of Save() method with default options.



```java
final Redactor redactor = new Redactor("sample.docx");
try 
{
    // Here we can use document instance to perform redactions
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    // Save the document with default options (convert pages into images, save as PDF)
    redactor.save();
}
finally { redactor.close(); }

```

---

## Saving EditableDocument to stream

Path: /editor/java/saving-editabledocument-to-stream/

> This article shows and explains the advances techniques and approaches while working with EditableDocument in advanced level — saving to stream with resource callback, saving resources separately from HTML markup, and saving HTML markup with adjustable resource links.

{{< alert style="info" >}}Information, explained in this article, is applicable for the GroupDocs.Editor for Java [version 24.4](https://releases.groupdocs.com/editor/java/release-notes/2024/groupdocs-editor-for-java-24-4-release-notes/) and higher.{{< /alert >}}

## Introduction

In the latest versions of the GroupDocs.Editor for Java, especially in the [version 24.4](https://releases.groupdocs.com/editor/java/release-notes/2024/groupdocs-editor-for-java-24-4-release-notes/), the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) class, which is one of the most important among all types in the GroupDocs.Editor, was significantly expanded and improved. These new features are focused on saving the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) to the HTML format into the stream using different ways, and allowing to specify a resource template string. This article covers all of them.

## Saving to stream the HTML markup only

Starting from the [version 23.9](https://releases.groupdocs.com/editor/java/release-notes/2023/groupdocs-editor-for-java-23-9-release-notes/), the `EditableDocument` class contains a new instane method [`getContent`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#getContent--), which allows to save an HTML marjup of the HTML document to the specified stream with specified encoding. Its signature is below:

```java
public String getContent()
```

This method internally converts the content of the `EditableDocument` instance to the HTML markup, where CSS stylesheets and images are not stored inside the markup. These external resources (CSS and images) are referenced through the links (URIs) by specifying their filenames. So, for example, if one HTML document has one stylesheet and two images with filenames "foo.jpeg" and "bar.png", they will be referenced in the HTML markup by the next:

```html
<link href="stylesheet.css" rel="stylesheet" />
.....
<IMG src="foo.jpeg" />
.....
<IMG src="bar.png" />
```

With this method, there is no option to specify or adjust the reference to the external resources somehow. Also, this method is useful for saving the HTML markup only, but not the external resources.

For dealing with these issues the next way was introduced.

## Saving whole HTML document to stream with resource callback

Starting from the [version 24.4](https://releases.groupdocs.com/editor/java/release-notes/2024/groupdocs-editor-for-java-24-4-release-notes/) a new [`save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#save-java.io.Writer-com.groupdocs.editor.options.HtmlSaveOptions-) method overload was added:

```java
void save(Writer htmlMarkup, HtmlSaveOptions saveOptions)
```

This method enables the most advanced, detailed and adjustable saving of the `EditableDocument` instance to the HTML format.

First parameter is an output parameter, into which the HTML markup will be written. User must specify any valid implementation of the `java.io.Writer` abstract class, usually `java.io.Writer` or `java.io.FileWriter`. It cannot be `null`.

Second parameter is the new public class [`HtmlSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/htmlsaveoptions/), which is described below. This argument also canot be `null`.

Class [`HtmlSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/htmlsaveoptions/) contains 4 properties, only one of them is mandatory and cannot be null.

- [`HtmlTagCase`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/htmlsaveoptions/#getHtmlTagCase--) property controls how the HTML tag names will be present in HTML markup: All lower case (default value), All upper case, or First letter upper case. Its value is a special enum - [`TagRenderingCase`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.serialization/tagrenderingcase/).
- [`AttributeValueDelimiter`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/htmlsaveoptions/#getAttributeValueDelimiter--) property controls which delimiter around the attribute values in HTML elements will be used: single quote (default value) or double quote. Its value is a special value type - [`QuoteType`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.serialization/quotetype/).
- [`EmbedStylesheetsIntoMarkup`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/htmlsaveoptions/#getEmbedStylesheetsIntoMarkup--) property is a boolean flag, which controls where to store the CSS stylesheet(s): as external resources (`false`), or embed them into the HTML markup, inside the `STYLE` element in the `HTML`->`HEAD` section (`true`). By default is `false` — do not embed inside the HTML markup.
- [`SavingCallback`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/htmlsaveoptions/#getSavingCallback--) is the most important and the only mandatory property, that myust be specified by user and cannot be `null`. It is a reference to the user-defined resource callback, which implements an interface [`IHtmlSavingCallback`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ihtmlsavingcallback/).

When the [`save`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#save-java.lang.String-) method is called, the GroupDocs.Editor scans the content of `EditableDocument` instance and gathers all resources: images, stylesheets, audio, etc. For each of these resources it calls the [`saveOneResource`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ihtmlsavingcallback/#saveOneResource-com.groupdocs.editor.htmlcss.resources.IHtmlResource-) method, which is defined in the [`IHtmlSavingCallback`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ihtmlsavingcallback/) interface and implemented by the user. When calling this method, the GroupDocs.Editor passes the resource itself as a type, which implements a [`IHtmlResource`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource/) interface — it will be [`JpegImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.raster/jpegimage/) for JPEG images, [`CssText`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.textual/csstext/) for CSS stylesheets, [`Mp3Audio`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.audio/mp3audio/) for MP3 audio files and so on.

When user obtains such a resource instance in the `saveOneResource` method, he can do with it what he wants: save to the disk, to the database, convert it somehow, or even do nothing. What is important, the user **must** return a link to this resource through the `return` value. So when the GroupDocs.Editor will start to form an HTML markup in order to write it to the `java.io.Writer htmlMarkup` argument, it will use the user-provided links to the resources in it.

The complete code sample below demonstrates the creating of `EditableDocument` instance by opening an arbitrary DOCX file for edit, then creationg the custom implementation of the `IHtmlSavingCallback`, which saves the provided resources to the database, and saving the content of the `EditableDocument` in the HTML format.

```java
public void SavingToStreamPublicExample()
{
	//Define an input document
	String inputDocx = "Path\\SampleDoc.docx";

	//Create and instance of custom SavingCallback
	SavingCallback callback = new SavingCallback();

	//Create HTML saving options
	HtmlSaveOptions saveOptions = new HtmlSaveOptions();
	saveOptions.setEmbedStylesheetsIntoMarkup(false);//Do not embed CSS into markup
	saveOptions.setAttributeValueDelimiter(QuoteType.DoubleQuote.getCode());
	saveOptions.setHtmlTagCase(TagRenderingCase.UpperCase);
	saveOptions.setSavingCallback(callback);//Specify our custom callback

	//Create an Editor class instance - load options are not necessary for DOCX and are default here
	Editor editor = new Editor(inputDocx);
	{
		//Create an EditableDocument instance - edit options are not specified and thus are default
		using (EditableDocument document = editor.edit())
		{
			//Define a StringWriter, into which the HTML markup will be written
			StringWriter writer = new StringWriter;
			document.save(writer, saveOptions);
		}
	}
}

	private final static class SavingCallback implements IHtmlSavingCallback
	{
		public final String saveOneResource(IHtmlResource resource)
		{
			//save this stream to the DB or to the disk somehow
			InputStream resourceStream = resource.getByteContent();

			//form and return a reference to the resource depending on resource type
			if (Operators.is(resource, CssText.class))
			{
				return StringExtensions.format("https://mywebsite.web/stylesheet/{0}", resource.getFilenameWithExtension());
			}
			else
			{
				return StringExtensions.format("https://mywebsite.web/GetImage/name={0}", resource.getFilenameWithExtension());
			}
		}
	}
```

After executing this code, the `markup` variable of `StringWriter` type will contain an HTML markup, where the references to the external resources will be like:

```html
<link href="https://mywebsite.web/stylesheet/stylesheet.css" rel="stylesheet"/>
.....
<IMG src="https://mywebsite.web/GetImage/name=foo.jpeg"/>
.....
<IMG src="https://mywebsite.web/GetImage/name=bar.png"/>
```

## Saving HTML markup with template strings for resource links

Sometimes it is necessary to save only markup, and do not save the resources. In such cases the approach, described above, may be treates as too redundant. The `EditableDocument` class from its beginning contains methods `getContent()` and `getBodyContent()`. These two methods have two overloads, but in general the first one returns the whole HTML markup of the document, while the second — only the inner content of the HTML->BODY element, without the BODY opening and closing tags.

Before the version 24.4 was released, these two methods allowed to specify the external resource prefixes, so when generating the HTML markup, these prefixes are added to resource names. For example, if the document has two images, let's say, "foo.jpeg" and "bar.png", then, by calling the `EditableDocument.getBodyContent("https://mywebsite.web/image?name=")`, the output markup will contain two IMG elements with the next content:

```html
<IMG src="https://mywebsite.web/image?name=foo.jpeg"/>
.....
<IMG src="https://mywebsite.web/image?name=bar.png"/>
```

However, this state of things had two main flaws:
- It was not possible to insert the resource name *inside* the request URI, only at the end.
- It was not possible to insert the resource name more than once in the single request URI.

GroupDocs.Editor version 24.4 fixes both these issues. The methods signatures are intact, but now they treat the specified strings not as the prefixes, but as the *template format strings*. Protocol is the next:

1. If specified template string is null or empty, then pure resource name will be placed in the HTML markup.
2. If specified template string contains one unique valid placeholder, which occurs one or more times, the resource name will replace the placeholder in the HTML markup.
3. Otherwise, if specified template string contains more than one unique placeholder, or contains no placeholder at all, it will be treated as a prefix string.

Due to this protocol the old-written user code will work the same as for the previous versions, because the template strings do not have the placeholders and thus are treated as prefixes.

But when using the template string, now, when calling the `EditableDocument.getBodyContent("https://mywebsite.web/image?name={0}&stamp=456789&token={0}&expireIn=123987")` method, the image named "foo.jpeg" will be presented in the output markup as the next:

```html
<IMG src="https://mywebsite.web/image?name=foo.jpeg&stamp=456789&token=foo.jpeg&expireIn=123987"/>
```

So this new mechanism allows to specify the request URIs for the external images and stylesheets very precisely.


---

## Saving EditableDocument to stream

Path: /editor/net/saving-editabledocument-to-stream/

> This article shows and explains the advances techniques and approaches while working with EditableDocument in advanced level — saving to stream with resource callback, saving resources separately from HTML markup, and saving HTML markup with adjustable resource links.

{{< alert style="info" >}}Information, explained in this article, is applicable for the GroupDocs.Editor for .NET [version 23.9](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-9-release-notes/) and higher.{{< /alert >}}

## Introduction

In the latest versions of the GroupDocs.Editor for .NET, especially in the [version 23.9](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-9-release-notes/), the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, which is one of the most important among all types in the GroupDocs.Editor, was significantly expanded and improved. These new features are focused on saving the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) to the HTML format into the stream using different ways, and allowing to specify a resource template string. This article covers all of them.

## Saving to stream the HTML markup only

Starting from the [version 23.4](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-4-release-notes/), the `EditableDocument` class contains a new instane method [`GetContent`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/getcontent/#getcontent_2), which allows to save an HTML marjup of the HTML document to the specified stream with specified encoding. Its signature is below:

```csharp
TStream GetContent<TStream>(TStream storage, System.Text.Encoding encoding) where TStream : System.IO.Stream
```

This generic method obtains an inheritor of the System.IO.Stream abstract class through the `storage` parameter, writes an HTML markup to it with specified character encoding, and returns a reference to the `storage`.

This method internally converts the content of the `EditableDocument` instance to the HTML markup, where CSS stylesheets and images are not stored inside the markup. These external resources (CSS and images) are referenced through the links (URIs) by specifying their filenames. So, for example, if one HTML document has one stylesheet and two images with filenames "foo.jpeg" and "bar.png", they will be referenced in the HTML markup by the next:

```html
<link href="stylesheet.css" rel="stylesheet" />
.....
<IMG src="foo.jpeg" />
.....
<IMG src="bar.png" />
```

With this method, there is no option to specify or adjust the reference to the external resources somehow. Also, this method is useful for saving the HTML markup only, but not the external resources.

For dealing with these issues the next way was introduced.

## Saving whole HTML document to stream with resource callback

Starting from the [version 23.9](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-9-release-notes/) a new [`Save`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/save/#save) method overload was added:

```csharp
void Save(System.IO.TextWriter htmlMarkup, Options.HtmlSaveOptions saveOptions)
```

This method enables the most advanced, detailed and adjustable saving of the `EditableDocument` instance to the HTML format.

First parameter is an output parameter, into which the HTML markup will be written. User must specify any valid implementation of the `System.IO.TextWriter` abstract class, usually `System.IO.StringWriter` or `System.IO.StreamWriter`. It cannot be `null`.

Second parameter is the new public class [`Options.HtmlSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/htmlsaveoptions/), which is described below. This argument also canot be `null`.

Class [`Options.HtmlSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/htmlsaveoptions/) contains 4 properties, only one of them is mandatory and cannot be null.

- [`HtmlTagCase`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/htmlsaveoptions/htmltagcase/) property controls how the HTML tag names will be present in HTML markup: All lower case (default value), All upper case, or First letter upper case. Its value is a special enum - [`TagRenderingCase`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.serialization/tagrenderingcase/).
- [`AttributeValueDelimiter`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/htmlsaveoptions/attributevaluedelimiter/) property controls which delimiter around the attribute values in HTML elements will be used: single quote (default value) or double quote. Its value is a special value type - [`QuoteType`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.serialization/quotetype/).
- [`EmbedStylesheetsIntoMarkup`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/htmlsaveoptions/embedstylesheetsintomarkup/) property is a boolean flag, which controls where to store the CSS stylesheet(s): as external resources (`false`), or embed them into the HTML markup, inside the `STYLE` element in the `HTML`->`HEAD` section (`true`). By default is `false` — do not embed inside the HTML markup.
- [`SavingCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/htmlsaveoptions/savingcallback/) is the most important and the only mandatory property, that myust be specified by user and cannot be `null`. It is a reference to the user-defined resource callback, which implements an interface [`IHtmlSavingCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ihtmlsavingcallback/).

When the [`Save`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/save/#save) method is called, the GroupDocs.Editor scans the content of `EditableDocument` instance and gathers all resources: images, stylesheets, audio, etc. For each of these resources it calls the [`SaveOneResource`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ihtmlsavingcallback/saveoneresource/) method, which is defined in the [`IHtmlSavingCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ihtmlsavingcallback/) interface and implemented by the user. When calling this method, the GroupDocs.Editor passes the resource itself as a type, which implements a [`IHtmlResource`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource/) interface — it will be [`JpegImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.raster/jpegimage/) for JPEG images, [`CssText`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.textual/csstext/) for CSS stylesheets, [`Mp3Audio`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.audio/mp3audio/) for MP3 audio files and so on.

When user obtains such a resource instance in the `SaveOneResource` method, he can do with it what he wants: save to the disk, to the database, convert it somehow, or even do nothing. What is important, the user **must** return a link to this resource through the `return` value. So when the GroupDocs.Editor will start to form an HTML markup in order to write it to the `System.IO.TextWriter htmlMarkup` argument, it will use the user-provided links to the resources in it.

The complete code sample below demonstrates the creating of `EditableDocument` instance by opening an arbitrary DOCX file for edit, then creationg the custom implementation of the `IHtmlSavingCallback`, which saves the provided resources to the database, and saving the content of the `EditableDocument` in the HTML format.

```csharp
public void SavingToStreamPublicExample()
{
	//Define an input document
	string inputDocx = "Path\\SampleDoc.docx";

	//Create and instance of custom SavingCallback
	SavingCallback callback = new SavingCallback();

	//Create HTML saving options
	GroupDocs.Editor.Options.HtmlSaveOptions saveOptions = new Options.HtmlSaveOptions();
	saveOptions.EmbedStylesheetsIntoMarkup = false;//Do not embed CSS into markup
	saveOptions.AttributeValueDelimiter = GroupDocs.Editor.HtmlCss.Serialization.QuoteType.DoubleQuote;
	saveOptions.HtmlTagCase = GroupDocs.Editor.HtmlCss.Serialization.TagRenderingCase.UpperCase;
	saveOptions.SavingCallback = callback;//Specify our custom callback

	//Create an Editor class instance - load options are not necessary for DOCX and are default here
	using (GroupDocs.Editor.Editor editor = new GroupDocs.Editor.Editor(inputDocx))
	{
		//Create an EditableDocument instance - edit options are not specified and thus are default
		using (EditableDocument document = editor.Edit())
		{
			//Define a StringWriter, into which the HTML markup will be written
			System.Text.StringBuilder markup = new StringBuilder();
			using (System.IO.StringWriter writer = new StringWriter(markup))
			{
				//Save the document
				document.Save(writer, saveOptions);
			}
		}
	}
}

private sealed class SavingCallback : GroupDocs.Editor.Options.IHtmlSavingCallback
{
	public string SaveOneResource(IHtmlResource resource)
	{
		//save this stream to the DB or to the disk somehow
		Stream resourceStream = resource.ByteContent;

		//form and return a reference to the resource depending on resource type
		if (resource is GroupDocs.Editor.HtmlCss.Resources.Textual.CssText)
		{
			return string.Format("https://mywebsite.web/stylesheet/{0}", resource.FilenameWithExtension);
		}
		else
		{
			return string.Format("https://mywebsite.web/GetImage/name={0}", resource.FilenameWithExtension);
		}
	}
}
```

After executing this code, the `markup` variable of `StringBuilder` type will contain an HTML markup, where the references to the external resources will be like:

```html
<link href="https://mywebsite.web/stylesheet/stylesheet.css" rel="stylesheet"/>
.....
<IMG src="https://mywebsite.web/GetImage/name=foo.jpeg"/>
.....
<IMG src="https://mywebsite.web/GetImage/name=bar.png"/>
```

## Saving HTML markup with template strings for resource links

Sometimes it is necessary to save only markup, and do not save the resources. In such cases the approach, described above, may be treates as too redundant. The `EditableDocument` class from its beginning contains methods `GetContent` and `GetBodyContent`. These two methods have two overloads, but in general the first one returns the whole HTML markup of the document, while the second — only the inner content of the HTML->BODY element, without the BODY opening and closing tags.

Before the version 23.9 was released, these two methods allowed to specify the external resource prefixes, so when generating the HTML markup, these prefixes are added to resource names. For example, if the document has two images, let's say, "foo.jpeg" and "bar.png", then, by calling the `EditableDocument.GetBodyContent("https://mywebsite.web/image?name=")`, the output markup will contain two IMG elements with the next content:

```html
<IMG src="https://mywebsite.web/image?name=foo.jpeg"/>
.....
<IMG src="https://mywebsite.web/image?name=bar.png"/>
```

However, this state of things had two main flaws:
- It was not possible to insert the resource name *inside* the request URI, only at the end.
- It was not possible to insert the resource name more than once in the single request URI.

GroupDocs.Editor version 23.9 fixes both these issues. The methods signatures are intact, but now they treat the specified strings not as the prefixes, but as the *template format strings*. Protocol is the next:

1. If specified template string is null or empty, then pure resource name will be placed in the HTML markup.
2. If specified template string contains one unique valid placeholder, which occurs one or more times, the resource name will replace the placeholder in the HTML markup.
3. Otherwise, if specified template string contains more than one unique placeholder, or contains no placeholder at all, it will be treated as a prefix string.

Due to this protocol the old-written user code will work the same as for the previous versions, because the template strings do not have the placeholders and thus are treated as prefixes.

But when using the template string, now, when calling the `EditableDocument.GetBodyContent("https://mywebsite.web/image?name={0}&stamp=456789&token={0}&expireIn=123987")` method, the image named "foo.jpeg" will be presented in the output markup as the next:

```html
<IMG src="https://mywebsite.web/image?name=foo.jpeg&stamp=456789&token=foo.jpeg&expireIn=123987"/>
```

So this new mechanism allows to specify the request URIs for the external images and stylesheets very precisely.


---

## Saving EditableDocument to Stream

Path: /editor/nodejs-java/saving-editabledocument-to-stream/


> This article shows and explains advanced techniques and approaches while working with `EditableDocument` at an advanced level — saving to stream with resource callback, saving resources separately from HTML markup, and saving HTML markup with adjustable resource links.

**Note:** The information explained in this article is applicable for GroupDocs.Editor for Node.js via Java **version 24.4** and higher.

## Introduction

In the latest versions of GroupDocs.Editor for Node.js via Java, especially in **version 24.4**, the [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/editabledocument/) class, which is one of the most important among all types in GroupDocs.Editor, was significantly expanded and improved. These new features are focused on saving the `EditableDocument` to the HTML format into a stream using different ways and allowing you to specify a resource template string. This article covers all of them.

## Saving HTML Markup to Stream Only

Starting from **version 23.9**, the `EditableDocument` class contains a new instance method `getContent()`, which allows you to get the HTML markup of the document as a string. Its signature is:

```javascript
getContent()
```

This method internally converts the content of the `EditableDocument` instance to HTML markup, where CSS stylesheets and images are not stored inside the markup. These external resources (CSS and images) are referenced through links (URIs) by specifying their filenames. So, for example, if one HTML document has one stylesheet and two images with filenames "foo.jpeg" and "bar.png", they will be referenced in the HTML markup as:

```html
<link href="stylesheet.css" rel="stylesheet" />
...
<img src="foo.jpeg" />
...
<img src="bar.png" />
```

With this method, there is no option to specify or adjust the references to the external resources. Also, this method is useful for saving the HTML markup only, but not the external resources.

To deal with these issues, the following approach was introduced.

## Saving the Whole HTML Document to Stream with Resource Callback

Starting from **version 24.4**, a new `save()` method overload was added:

```javascript
save(htmlMarkup, saveOptions)
```

This method enables the most advanced, detailed, and adjustable saving of the `EditableDocument` instance to the HTML format.

- **`htmlMarkup`**: The first parameter is an output parameter into which the HTML markup will be written. You must specify any valid writable stream, such as `fs.createWriteStream()` or any other writable stream. It cannot be `null`.

- **`saveOptions`**: The second parameter is an instance of the new public class `HtmlSaveOptions`, which is described below. This argument also cannot be `null`.

### HtmlSaveOptions Class

The `HtmlSaveOptions` class contains four properties, only one of which is mandatory and cannot be `null`.

- **`htmlTagCase`**: Controls how the HTML tag names will be presented in HTML markup: All lower case (default value), All upper case, or First letter upper case. Its value is a special enum `TagRenderingCase`.

- **`attributeValueDelimiter`**: Controls which delimiter around the attribute values in HTML elements will be used: single quote (default value) or double quote. Its value is a special value type `QuoteType`.

- **`embedStylesheetsIntoMarkup`**: A boolean flag that controls where to store the CSS stylesheet(s): as external resources (`false`), or embed them into the HTML markup, inside the `<style>` element in the `<html><head>` section (`true`). By default, it is `false` — do not embed inside the HTML markup.

- **`savingCallback`**: The most important and the only mandatory property that must be specified by the user and cannot be `null`. It is a reference to the user-defined resource callback, which implements the `IHtmlSavingCallback` interface.

### Implementing IHtmlSavingCallback Interface

When the `save()` method is called, GroupDocs.Editor scans the content of the `EditableDocument` instance and gathers all resources: images, stylesheets, audio, etc. For each of these resources, it calls the `saveOneResource(resource)` method, which is defined in the `IHtmlSavingCallback` interface and implemented by you. When calling this method, GroupDocs.Editor passes the resource itself as a type that implements the `IHtmlResource` interface — it will be `JpegImage` for JPEG images, `CssText` for CSS stylesheets, `Mp3Audio` for MP3 audio files, and so on.

When you obtain such a resource instance in the `saveOneResource` method, you can do with it what you want: save it to disk, to a database, convert it somehow, or even do nothing. Importantly, you **must** return a link to this resource through the `return` value. So when GroupDocs.Editor starts to form the HTML markup to write it to the `htmlMarkup` argument, it will use the user-provided links to the resources in it.

### Code Example

The complete code sample below demonstrates creating an `EditableDocument` instance by opening an arbitrary DOCX file for editing, then creating a custom implementation of the `IHtmlSavingCallback`, which saves the provided resources to a database or elsewhere, and saving the content of the `EditableDocument` in the HTML format.

```javascript
// Import necessary modules
const groupdocsEditor = require('groupdocs-editor');
const fs = require('fs');

// Define an input document
const inputDocx = 'Path/SampleDoc.docx';

// Create an instance of the custom SavingCallback
class SavingCallback {
    saveOneResource(resource) {
        // Save this stream to the DB or to the disk somehow
        const resourceStream = resource.getByteContent();

        // Form and return a reference to the resource depending on resource type
        if (resource instanceof groupdocsEditor.CssText) {
            return `https://mywebsite.web/stylesheet/${resource.getFilenameWithExtension()}`;
        } else {
            return `https://mywebsite.web/GetImage/name=${resource.getFilenameWithExtension()}`;
        }
    }
}

const callback = new SavingCallback();

// Create HTML saving options
const saveOptions = new groupdocsEditor.HtmlSaveOptions();
saveOptions.setEmbedStylesheetsIntoMarkup(false); // Do not embed CSS into markup
saveOptions.setAttributeValueDelimiter(groupdocsEditor.QuoteType.DoubleQuote.getCode());
saveOptions.setHtmlTagCase(groupdocsEditor.TagRenderingCase.UpperCase);
saveOptions.setSavingCallback(callback); // Specify our custom callback

// Create an Editor class instance - load options are not necessary for DOCX and are default here
const editor = new groupdocsEditor.Editor(inputDocx);

// Create an EditableDocument instance - edit options are not specified and thus are default
const editableDocument = editor.edit();

// Define a writable stream into which the HTML markup will be written
const outputHtmlPath = 'Path/output.html';
const htmlStream = fs.createWriteStream(outputHtmlPath);

// Save the EditableDocument to the stream with the specified save options
editableDocument.save(htmlStream, saveOptions);

// Close the stream
htmlStream.end();

// Dispose of resources
editableDocument.dispose();
editor.dispose();
```

After executing this code, the `output.html` file will contain HTML markup where the references to the external resources will be like:

```html
<link href="https://mywebsite.web/stylesheet/stylesheet.css" rel="stylesheet"/>
...
<img src="https://mywebsite.web/GetImage/name=foo.jpeg"/>
...
<img src="https://mywebsite.web/GetImage/name=bar.png"/>
```

## Saving HTML Markup with Template Strings for Resource Links

Sometimes it is necessary to save only the markup and not save the resources. In such cases, the approach described above may be too redundant. The `EditableDocument` class from its beginning contains methods `getContent()` and `getBodyContent()`. These two methods have two overloads, but in general, the first one returns the whole HTML markup of the document, while the second — only the inner content of the `<body>` element, without the `<body>` opening and closing tags.

Before version 24.4 was released, these two methods allowed you to specify the external resource prefixes, so when generating the HTML markup, these prefixes are added to resource names. For example, if the document has two images, let's say, "foo.jpeg" and "bar.png", then, by calling:

```javascript
const bodyContent = editableDocument.getBodyContent("https://mywebsite.web/image?name=");
```

The output markup will contain two `<img>` elements with the following content:

```html
<img src="https://mywebsite.web/image?name=foo.jpeg"/>
...
<img src="https://mywebsite.web/image?name=bar.png"/>
```

However, this approach had two main flaws:

- It was not possible to insert the resource name *inside* the request URI, only at the end.
- It was not possible to insert the resource name more than once in a single request URI.

GroupDocs.Editor version 24.4 fixes both these issues. The method signatures are intact, but now they treat the specified strings not as prefixes but as *template format strings*. The protocol is as follows:

1. If the specified template string is `null` or empty, then the pure resource name will be placed in the HTML markup.
2. If the specified template string contains one unique valid placeholder `{0}`, which occurs one or more times, the resource name will replace the placeholder in the HTML markup.
3. Otherwise, if the specified template string contains more than one unique placeholder, or contains no placeholder at all, it will be treated as a prefix string.

Due to this protocol, old user code will work the same as in previous versions because the template strings do not have placeholders and thus are treated as prefixes.

But when using the template string, now, when calling:

```javascript
const bodyContent = editableDocument.getBodyContent("https://mywebsite.web/image?name={0}&stamp=456789&token={0}&expireIn=123987");
```

The image named "foo.jpeg" will be presented in the output markup as:

```html
<img src="https://mywebsite.web/image?name=foo.jpeg&stamp=456789&token=foo.jpeg&expireIn=123987"/>
```

So this new mechanism allows you to specify the request URIs for the external images and stylesheets very precisely.

---

By following this guide, you can effectively save the `EditableDocument` to a stream with advanced options, control how resources are handled, and adjust resource links using templates in GroupDocs.Editor for Node.js via Java.

**Note:** Be sure to replace the paths in the code examples with the actual paths used in your application.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Scan Barcode

Path: /parser/net/scan-barcode/

GroupDocs.Parser .Net allows to scan barcode from PDF, Microsoft Office formats: Word (DOC, DOCX), PowerPoint (PPT, PPTX), LibreOffice formats and many others (see full list at [supported document formats]({{< ref "parser/net/getting-started/supported-document-formats.md" >}}) article).

GroupDocs.Parser's barcode scanner is easy to use and powerful at the same time. Our experience allowed us to implement sophisticated algorithms, which allows to read even damaged barcodes.

This article demonstrates how to implement the simplest scenario - read barcode from any supported format without additional settings (to resolve complex scenarios see [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-barcodes/_index.md" >}}). 

## How to scan barcode in .Net with GroupDocs.Parser

To scan barcode from your file, simply call [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/getbarcodes) method:

```csharp
IEnumerable<PageBarcodeArea> GetBarcodes();
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects.

Here are the steps to extract a barcode from file:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial file;
- Check if the file supports barcodes extraction;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/getbarcodes) method and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to scan barcodes:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if the file supports barcode extraction
    if (!parser.Features.Barcodes)
    {
        Console.WriteLine("The file doesn't support barcode extraction.");
        return;
    }

    // Scan barcodes from the file
    IEnumerable<PageBarcodeArea> barcodes = parser.GetBarcodes();
    
    // Iterate over barcodes
    foreach (PageBarcodeArea barcode in barcodes)
    {
        // Print a barcode value
        Console.WriteLine(barcode.Value);
    }
}
```

## More resources

### Advanced usage topics

To learn more about scan barcode features, please refer the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-barcodes/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online Barcode Scanner App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to scan barcode from your files or mobile phone camera with our free online [GroupDocs Scanner App](https://products.groupdocs.app/scanner/scan-barcode) which is build with GroupDocs.Parser .Net.
---

## Scan QR Code

Path: /parser/net/scan-qr-code/

GroupDocs.Parser .Net allows to scan QR Code from PDF, MS Word (DOC, DOCX), MS PowerPoint (PPT, PPTX), LibreOffice formats and many others (see full list at [supported document formats]({{< ref "parser/net/getting-started/supported-document-formats.md" >}}) article).

GroupDocs.Parser's QR Code scanner is easy to use and powerful at the same time. Our sophisticated algorithms allow to read even damaged barcodes.

This article demonstrates how to implement QR Code reader from any supported format. 

## How to scan QR Code in .Net with GroupDocs.Parser

To scan QR Code from your file, simply call [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/getbarcodes) method:

```csharp
IEnumerable<PageBarcodeArea> GetBarcodes();
```

This method returns a collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects.

Here are the steps to extract a QR Code from file:

- Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial file;
- Check if the file supports barcodes extraction;
- Call [GetBarcodes](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/getbarcodes) method and obtain collection of [PageBarcodeArea](https://reference.groupdocs.com/parser/net/groupdocs.parser.data/pagebarcodearea) objects;
- Iterate through the collection and get a barcode value.

The following example shows how to scan barcode:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Check if the file supports barcodes extraction
    if (!parser.Features.Barcodes)
    {
        Console.WriteLine("The file doesn't support barcodes extraction.");
        return;
    }

    // Scan barcodes with type "QR" from your file.
    IEnumerable<PageBarcodeArea> qrcodes = parser.GetBarcodes().Where(i => i.CodeTypeName == "QR");

    // Iterate over barcodes
    foreach (PageBarcodeArea qrcode in qrcodes)
    {
        // Print the page index
        Console.WriteLine("Page: " + qrcode.Page.Index.ToString());
        // Print the qrcode value
        Console.WriteLine("Value: " + qrcode.Value);
    }
}
```

## More resources

### Advanced usage topics

To learn more about scan barcode features, please refer the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-barcodes/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online text extractor App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to scan QR Code from your file with our free online [GroupDocs Scanner App](https://products.groupdocs.app/scanner/scan-qr-code) which is build with GroupDocs.Parser .Net.
---

## Search for standard entries in the QR-Code signatures

Path: /signature/net/search-for-standard-entries-in-the-qr-code-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides additional features when searching for[QrCode Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodesignature)  that were previously added to document with embedded standard entry objects. Following standard entries are supported to search for and receive object back from Qr-Code

* [Email](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/email) that keeps in the QR-code standard email information with recipient, subject and body.
* [Address](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/address) with address information.
* [V-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/vcard) entry of visit card 3.0 specification with visited card details. More info could be found [here](https://en.wikipedia.org/wiki/VCard).
* [Me-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/mecard) entry implements similar to V-Card contact details standard. More details could be found [here](https://en.wikipedia.org/wiki/MeCard_(QR_code)).
* [EPC](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/epc) implements standard of the European Payments Council guidelines define the content of a QR code that can be used to initiate [SEPA](https://en.wikipedia.org/wiki/SEPA_credit_transfer) credit transfer. More details could be found [here](https://en.wikipedia.org/wiki/EPC_QR_code).
* [Event](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/event) entry implements event standard.  
* [WiFi](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/wifi) entry implements WiFI settings standard.
* [SMS](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/sms) entry implements sms properties.
* [CryptoCurrencyTransfer](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/cryptocurrencytransfer/) entry implements event standard.

## Search for QR-code signatures and extract Email object

This example shows how to search for QR-code signature and obtain [Email](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/email) object.  

```csharp
// instantiating the signature object
using (Signature signature = new Signature("signed.pdf"))
{
    // search document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    foreach (QrCodeSignature qrSignature in signatures)
    {
        Console.WriteLine("Found QRCode signature: {0} with text {1}", qrSignature.EncodeType.TypeName, qrSignature.Text);
        Email email = qrSignature.GetData<Email>();
        if (email != null)
        {
           Console.WriteLine($"Found Email signature: {email.Address} {email.Subject} {email.Body}");
        }
    }
}

```

## Search for QR-code signatures and extract Address object

This example shows how to search for QR-code signature and obtain [Address](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/address) object.  

```csharp
// instantiating the signature object
using (Signature signature = new Signature("signed.pdf"))
{
    // search document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    foreach (QrCodeSignature qrSignature in signatures)
    {
        Console.WriteLine("Found QRCode signature: {0} with text {1}", qrSignature.EncodeType.TypeName, qrSignature.Text);
        Address Address = qrSignature.GetData<Address>();
        if (Address != null)
        {
            Console.WriteLine($"Found Address signature: {Address.Country} {Address.State} {Address.City} {Address.ZIP}");
        }
     }
}

```

## Search for QR-code signatures and extract VCard object

This example shows how to obtain [V-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/vcard) entry from QR-Code electronic signatures.

```csharp
// instantiating the signature object
using (Signature signature = new Signature("signed.pdf"))
{
    // search document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
 foreach (QrCodeSignature qrSignature in signatures)
    {
        Console.WriteLine("Found QRCode signature: {0} with text {1}", qrSignature.EncodeType.TypeName, qrSignature.Text);
        VCard vcard = qrSignature.GetData<VCard>();
        if (vcard != null)
        {
            Console.WriteLine("Found VCard signature: {0} {1} from {2}. Email: {3}", vcard.FirstName, vcard.LastName, vcard.Company, vcard.Email);
        }
    }
}
```

## Search for QR-code with MeCard object

This example shows how to obtain [Me-Card](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/mecard) entry from QR-Code electronic signature.

```csharp
// instantiating the signature object
using (Signature signature = new Signature("sample.pdf"))
{
    // search document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    try
    {
        foreach (QrCodeSignature qrSignature in signatures)
        {
            MeCard meCard = qrSignature.GetData<MeCard>();
            if (meCard != null)
            {
                Console.WriteLine("Found MeCard signature: {0} {1} from {2}. Email: {3}", meCard.Name, meCard.Reading, meCard.Note, meCard.Email);
            }
            else
            {
                Helper.WriteError($"MeCard object was not found. QRCode {qrSignature.EncodeType.TypeName} with text {qrSignature.Text}");
            }
        }
    }
    catch
    {
        Console.WriteError("\nThis example requires license to properly run. " +
                      "\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
                      "\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
                      "\nLear how to request temporary license at https://purchase.groupdocs.com/temporary-license.");
    }
}
```

## Search for QR-code with EPC/SEPA object

This example shows how to obtain [EPC/SEPA](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/epc) entry from QR-Code electronic signatures.

```csharp
// instantiating the signature object
using (Signature signature = new Signature("sample.pdf"))
{
    // search document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    try
    {
        foreach (QrCodeSignature qrSignature in signatures)
        {
            EPC payment = qrSignature.GetData<EPC>();
            if (payment != null)
            {
                Console.WriteLine($"Found EPC payment signature. Name {payment.Name}, IBAN {payment.IBAN}. Amount {payment.Amount}. Ref: {payment.Reference} / {payment.Remittance}");
            }
            else
            {
                Helper.WriteError($"EPC object was not found. QRCode {qrSignature.EncodeType.TypeName} with text {qrSignature.Text}");
            }
        }
    }
    catch
    {
        Console.WriteError("\nThis example requires license to properly run. " +
                      "\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
                      "\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
                      "\nLear how to request temporary license at https://purchase.groupdocs.com/temporary-license.");
    }
}


```

## Search for QR-code with Event object

This example shows how to obtain [Event](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/event) entry from QR-Code electronic signatures.

```csharp
// instantiating the signature object
using (Signature signature = new Signature("sample.pdf"))
{
    // search document
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(SignatureType.QrCode);
    try
    {
        foreach (QrCodeSignature qrSignature in signatures)
        {
            Event evnt = qrSignature.GetData<Event>();
            if (evnt != null)
            {
                Console.WriteLine($"Found Event signature: {evnt.Title}/{evnt.Description} at {evnt.Location}. Started @ {evnt.StartDate}");
            }
            else
            {
                Helper.WriteError($"Event object was not found. QRCode {qrSignature.EncodeType.TypeName} with text {qrSignature.Text}");
            }
        }
    }
    catch
    {
        Console.WriteError("\nThis example requires license to properly run. " +
                      "\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
                      "\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
                      "\nLear how to request temporary license at https://purchase.groupdocs.com/temporary-license.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Select specific pages for rasterized PDF

Path: /redaction/net/select-specific-pages-for-rasterized-pdf/

Saving document as a rasterized PDF, you can specify starting page index (zero based) and the number of pages from this index to save. Also, you can change the Compliance level from PDF/A-1b, which is used by default, to PDF/A-1a:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(System.Drawing.Color.Red)));
    if (result.Status != RedactionStatus.Failed)
    {
        var options = new SaveOptions();
        options.Rasterization.Enabled = true;                           // the same as options.RasterizeToPDF = true;
        options.Rasterization.PageIndex = 5;                            // start from 6th page (index is 0-based)
        options.Rasterization.PageCount = 1;                            // save only one page
        options.Rasterization.Compliance = PdfComplianceLevel.PdfA1a;   // by default PdfComplianceLevel.Auto or PDF/A-1b
        options.AddSuffix = true;
        redactor.Save(options);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Select specific pages for rasterized PDF

Path: /redaction/python-net/select-specific-pages-for-rasterized-pdf/

Saving document as a rasterized PDF, you can specify starting page index (zero based) and the number of pages from this index to save. Also, you can change the Compliance level from PDF/A-1b, which is used by default, to PDF/A-1a:

**Python**

```python
from operator import truediv
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():

    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions(color)
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        if (result.status != gr.RedactionStatus.FAILED):
            # Save the processed document
            so = gro.SaveOptions()
            so.rasterization.enabled = True # convert pages to images for compatibility
            so.rasterization.page_index = 5 # start from 6th page (index is 0-based)
            so.rasterization.page_count = 1 # save only one page
            so.rasterization.compliance = gro.PdfComplianceLevel.PDF_A1A # PDF format
            so.add_suffix = False
            result_path = redactor.save(so)

            print(f"Document redacted successfully.\nCheck output in {result_path}")
        else:
            print(f"Redaction failed!")
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
   

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Set image size limits

Path: /viewer/java/set-image-size-limits-when-rendering-to-html/


The [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class has the following methods to get and set the image width or/and height:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
/**
 * Max width of an output image in pixels. (When converting single image to HTML only)
 */
public int getImageMaxWidth();

/**
 * Max width of an output image in pixels. (When converting single image to HTML only)
 */
public void setImageMaxWidth(int imageMaxWidth);

/**
 * Max height of an output image in pixels. (When converting single image to HTML only)
 */
public int getImageMaxHeight();

/**
 * Max height of an output image in pixels. (When converting single image to HTML only)
 */
public void setImageMaxHeight(int imageMaxHeight);

/**
 * The width of the output image in pixels. (When converting single image to HTML only)
 */
public int getImageWidth();

/**
 * The width of the output image in pixels. (When converting single image to HTML only)
 */
public void setImageWidth(int imageWidth);

/**
 * The height of an output image in pixels. (When converting single image to HTML only)
 */
public int getImageHeight();

/**
 * The height of an output image in pixels. (When converting single image to HTML only)
 */
public void setImageHeight(int imageHeight);
```
{{< /tab >}}
{{< /tabs >}}

You can set the width and/or height of the output images. Use one of the following methods: 

* To render a single image, use `setImageWidth`/`setImageHeight` methods.
* To render multiple images, set `setImageMaxWidth`/`setImageMaxHeight` methods. If an image exceeds these limits, it is resized proportionally.

{{< alert style="warning" >}}
If you use the `setImageWidth`/`setImageHeight` methods, the values specified by the`setImageMaxWidth`/`setImageMaxHeight` methods are ignored.
{{< /alert >}}

To call the `setImageMaxWidth`/`setImageMaxHeight` methods, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object.
2. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) object.
3. Call the `setImageMaxWidth()` and/or `setImageMaxHeight()` methods.
4. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

The following code snippet shows how to set the output image size limits:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.jpg")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    // Specify the maximum width and height.
    viewOptions.setImageMaxWidth(800);
    viewOptions.setImageMaxHeight(600);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Set image size limits

Path: /viewer/net/set-image-size-limits-when-rendering-to-html/


The [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) class has the following properties to set the image width or/and height:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
/// <summary>
/// Max width of an output image in pixels.
/// </summary>
public int ImageMaxWidth { get; set; }

/// <summary>
/// Max height of an output image in pixels.
/// </summary>
public int ImageMaxHeight { get; set; }

/// <summary>
/// The width of the output image in pixels.
/// </summary>
public int ImageWidth { get; set; }

/// <summary>
/// The height of an output image in pixels.
/// </summary>
public int ImageHeight { get; set; }
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Class SurroundingClass
    ''' <summary>
    ''' Max width of an output image in pixels.
    ''' </summary>
    Public Property ImageMaxWidth As Integer

    ''' <summary>
    ''' Max height of an output image in pixels.
    ''' </summary>
    Public Property ImageMaxHeight As Integer

    ''' <summary>
    ''' The width of the output image in pixels.
    ''' </summary>
    Public Property ImageWidth As Integer

    ''' <summary>
    ''' The height of an output image in pixels.
    ''' </summary>
    Public Property ImageHeight As Integer
End Class
```
{{< /tab >}}
{{< /tabs >}}

You can set the width and/or height of the output images. Use one of the following methods: 

* To render a single image, set ImageWidth/ImageHeight options.
* To render multiple images, set ImageMaxWidth/ImageMaxHeight options. If an image exceeds these limits, it is resized proportionally.

{{< alert style="warning" >}}
If you set the ImageWidth/ImageHeight options, the ImageMaxWidth/ImageMaxHeight options are ignored.
{{< /alert >}}

To set the ImageMaxWidth/ImageMaxHeight options, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object.
2. Instantiate the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) object.
3. Set the ImageMaxWidth and/or ImageMaxHeight values;
4. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method.

The following code snippet shows how to set the output image size limits:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.jpeg"))
{
    // Create view options.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Specify the maximum width and height.
    viewOptions.ImageMaxWidth = 800;
    viewOptions.ImageMaxHeight = 600;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.jpeg")
            ' Create view options.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
            ' Specify the maximum width and height.
            viewOptions.ImageMaxWidth = 800
            viewOptions.ImageMaxHeight = 600
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Set timeout for loading external resources

Path: /viewer/java/set-timeout-for-loading-external-resources-contained-by-a-document/

If a document contains external resources like images, GroupDocs.Viewer loads them while rendering the document.

In the 19.12 version and earlier, the default timeout was 100 seconds. It may slow rendering when a service that provides external resources is down.

Since the 19.12 version, the default timeout is 30 seconds. Besides that, you can specify the desired timeout using [LoadOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/LoadOptions).

This feature is supported for the [Word Processing File Formats](https://docs.fileformat.com/word-processing/).

The following code snippet shows how to set a timeout to load external resources:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.LoadOptions;
// ...

LoadOptions loadOptions = new LoadOptions();
// Specify a timeout.
loadOptions.setResourceLoadingTimeout(500);

// Render a file.
try (Viewer viewer = new Viewer("sample.doc", loadOptions)) {

    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Sign document with Digital signature - advanced

Path: /signature/java/sign-document-with-digital-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [DigitalSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions) class to specify different amount of settings for Digital signature

*   digital certificate (file on local disk [setCertificateFilePath](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#setCertificateFilePath(java.lang.String)) or stream [setCertificateStream](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#setCertificateStream(java.io.InputStream))) (required)
*   password of digital certificate [setPassword](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#setPassword(java.lang.String)) (required) 
*   digital signature details ([setReason](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#setReason(java.lang.String)), [setContact](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#setContact(java.lang.String)), [setLocation](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions#setLocation(java.lang.String)))
*   signature image as digital signature appearance on document page ([setImageFilePath](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setImageFilePath(java.lang.String)) or [setImageStream](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setImageStream(java.io.InputStream)))
*   image signature appearance on document page ([setHorizontalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setHorizontalAlignment(int)), [setMargin](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setMargin(com.groupdocs.signature.domain.Padding)) etc.)

Here are the steps to add Digital signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions) object with required certificate and its password.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions) to it.    
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.
    
This example shows how to sign PDF with Digital signature certificate and analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult)

```java
Signature signature = new Signature("sample.pdf"); 
DigitalSignOptions options = new DigitalSignOptions("certificate.pfx");
 
// certifiate password
options.setPassword("1234567890");
// digital certificate details
options.setReason("Sign");
options.setContact("JohnSmith");
options.setLocation("Office1");
 
// image as digital certificate appearance on document pages
options.setImageFilePath("sample.jpg");
//
options.setAllPages(true);
options.setWidth(80);
options.setHeight(60);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setBottom(10);
padding.setRight(10);
options.setMargin(padding);
 
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign documents with standard encryption for QR-code

Path: /signature/java/sign-documents-with-standard-encryption-for-qr-code/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java ) provides ability to encrypt QR-code signature with symmetric algorithms. Class [SymmetricEncryption](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.encryption/SymmetricEncryption ) implements one of the following values algorithms ([DES, TripleDES, RC2, Rijndael](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.encryption/SymmetricAlgorithmType )), string value key and string value salt.

Here are the steps to encrypt QR-code text with embedded encryption by GroupDocs.Signature:

* Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions ) object with [getData](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions#getData() ) or Text property
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions ) object according to your requirements and custom object to [getData](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions#getData() ) property.
* Call [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20java.util.List)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature ) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions ) to it.  

## How to encrypt QR-code signature

 This example shows how to encrypt QR-code signature.

```java
Signature signature = new Signature("sample.pdf"))

// setup key and passphrase
String key = "1234567890";
String salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
// setup QR-Code options
QrCodeSignOptions options = new QrCodeSignOptions();
options.setEncodeType(QrCodeTypes.QR);
	// setup Data property to Address instance
options.setData(address);
	// set right bottom corner
options.setHorizontalAlignment(HorizontalAlignment.Right);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setMargin(new Padding(10));
options.setWidth(100);
options.setHeight(100);
// sign document to file
signature.sign("QrCodeEncrypted.pdf", options);

```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Signing specific pages in the multipage document

Path: /signature/net/sign-specific_pages_in_multipage-document/

Base signature options [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) contains property [SignOptions.PagesSetup](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pagessetup/) which allows to set up specific page numbers.

This example shows how to sign specific pages in the multipage Tiff document through the [PagesSetup.PageNumbers](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/pagessetup/pagenumbers/) list of integer values.

```csharp
using (var signature = new Signature("multipage.tiff"))
{
    var options = new QrCodeSignOptions("Patient #36363393. R: No-Issues")
    {
        // set signature position 
        Left = 10,
        Top = 10,
        // set signature rectangle
        Width = 200,
        Height = 200,
        //specify pages numbers which we want to sign
        PagesSetup = new PagesSetup()
        {
            PageNumbers = new List<int> { 1, 3 }
        }
    };

    // sign document to file
    SignResult signResult = signature.Sign(outputFilePath, options);
    Console.WriteLine($"\nDocument signed with {signResult.Succeeded.Count} signatures");
    Console.WriteLine("\nList of newly created signatures:");
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"{temp.SignatureType} at page #{temp.PageNumber}: Id:{temp.SignatureId}.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Single Row Image in Text Document

Path: /assembly/java/single-row-image-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Text Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Single Row Image in Text Document

### Reporting Requirement

As a report developer, you are required to represent information of first single manager with the following key requirements:

*   Report must show image of the manager
*   It must show Name and age of manager
*   Report must be generated in the Text Document.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}Inserting Images Dynamically is not Supported yet{{< /alert >}}

```java
Name:	<<[manager.getName()]>>
Age:	<<[manager.getAge()]>>
```

### Download Single Row Image Template

Please download the sample template we created in this article:

*   [Single Row Image.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Text%20Templates/Single%20Row.txt?raw=true)

### Generating The Report

{{< gist GroupDocsGists c87f4a581ae7d23c97ee3a2c08c8087e >}}



---

## Single Row in Text Document

Path: /assembly/net/single-row-in-text-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row report in Text Document format.{{< /alert >}}

## Single Row in Text Document

{{< alert style="info" >}}This feature is supported by version 17.03 or greater.{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent information of first single customer with the following key requirements:

*   It must show Name and Contact Number of the customer
*   Report must be generated in the Text Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
Name:	<<[customer.CustomerName]>>
Contact Number:	<<[customer.CustomerContactNumber]>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Single Row Image Template

Please download the single row image document we created in this article:

*   [Single Row.txt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Text%20Templates/Single%20Row.txt?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< gist GroupDocsGists 2e51cfff8166768ebdcb9fa4de93e251 >}}



---

## Split text file

Path: /merger/net/split-text-file/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to split text file into several resultant text files. The default behaviour is to split each line into separate file.  
Here are the steps on how to split text file as described:

*   Initialize [TextSplitOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/textsplitoptions) class with output files path format, desired [TextSplitMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/textsplitmode) and line numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [Split](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/split/#split_1) method and pass [TextSplitOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/textsplitoptions) object to itfor saving resultant text files.

## Split text file to several one-line files (by exact line numbers)

The following code sample demonstrates how to split text file to two one-page documents with 3rd, 6th lines from source file:

```csharp
string filePath = @"c:\sample.txt";
string filePathOut = @"c:\output\line_{0}.{1}";

TextSplitOptions splitOptions = new TextSplitOptions(filePathOut, new int[] { 3, 6 });

using (Merger merger = new Merger(filePath))
{
    merger.Split(splitOptions);
}
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| line_0 | 3 |
| line_1 | 6 |

## Split text file to several multi-line files 

The following code sample demonstrates how to split text file to several multi-line files starting from 3rd and ending at 6th line numbers:

```csharp
string filePath = @"c:\sample.txt";
string filePathOut = @"c:\output\text_{0}.{1}";

TextSplitOptions splitOptions = new TextSplitOptions(filePathOut, TextSplitMode.Interval, new int[] { 3, 6 });

using (Merger merger = new Merger(filePath))
{
    merger.Split(splitOptions);
}
```

This code snippet will produce:

| Text file | Line numbers |
| --- | --- |
| text_0 | 1, 2 |
| text_1 | 3, 4, 5 |
| text_2 | 6 |


---

## Subscribing for signing process events

Path: /signature/java/subscribing-for-signing-process-events/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class contains several events that are being called for different process stages

*   [SignStarted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SignStarted) to handle process start event. This event is occur once [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method is called
*   [SignProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SignProgress) to handle progress event. This event occurs each time on signing each signature was completed.
*   [SignCompleted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SignCompleted) to handle completion event. This event occurs once [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) process was completed.    

Here are the steps to subscribe for signing process with GroupDocs.Signature:

*   Define required handler delegates to process signing events.    
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Subscribe for required events      
*   Instantiate required [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) object  
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass signature options in it
    

## Implement method for SignStarted event

GroupDocs.Signature expects [ProcessStartEventHandler](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.handler.events/ProcessStartEventHandler) delegate to subscribe for [SignStarted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#SignStarted) event

```java
private static void onSignStarted(Signature sender, ProcessStartEventArgs args)
{
    System.out.print("Sign process started at "+args.getStarted()+" with "+args.getTotalSignatures()+" total signatures to be put in document");
}
```

## Implement method for SignProgress event

```java
private static void onSignProgress(Signature sender, ProcessProgressEventArgs args)
{
    System.out.print("Sign progress. Processed "+args.getProcessedSignatures()+" signatures. Time spent "+args.getTicks()+" mlsec");
}
```

## Implement method for SignCompleted event

```java
private static void onSignCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    System.out.print("Sign process completed at "+args.getCompleted()+" with "+args.getTotalSignatures()+" total signatures. Process took "+args.getTicks()+" mlsec");
}
```

## Subscribing for signing process events

```java
private static void onSignStarted(Signature sender, ProcessStartEventArgs args)
{
    System.out.print("Sign process started at "+args.getStarted()+" with "+args.getTotalSignatures()+" total signatures to be put in document");
}
 
private static void onSignProgress(Signature sender, ProcessProgressEventArgs args)
{
    System.out.print("Sign progress. Processed "+args.getProcessedSignatures()+" signatures. Time spent "+args.getTicks()+" mlsec");
}
 
private static void onSignCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    System.out.print("Sign process completed at "+args.getCompleted()+" with "+args.getTotalSignatures()+" total signatures. Process took "+args.getTicks()+" mlsec");
}
 
 
/**
 * Sign document with text signature applying specific options
 */
public static void run()
{    
    try {
        Signature signature = new Signature("sample.pdf");
        signature.SignStarted.add(new ProcessStartEventHandler() {
            public void invoke(Signature sender, ProcessStartEventArgs args) {
                onSignStarted(sender, args);
            }
        });
        signature.SignProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                onSignProgress(sender, args);
            }
        });
        signature.SignCompleted.add(new ProcessCompleteEventHandler() {
            public void invoke(Signature  sender, ProcessCompleteEventArgs args) {
                onSignCompleted(sender, args);
            }
        });
 
        TextSignOptions options = new TextSignOptions("John Smith");
 
        // set signature position 
        options.setLeft(100);
        options.setTop(100);
 
        signature.sign("signed.pdf", options);
        System.out.print("\nSource document signed successfully.\nFile saved at " + outputFilePath);
 
    } catch (Exception e) {
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Subscribing for signing process events

Path: /signature/net/subscribing-for-signing-process-events/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class contains several events that are being called for different process stages

* [SignStarted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/signstarted) to handle process start event. This event is occur once [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method is called
* [SignProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/signprogress) to handle progress event. This event occurs each time on signing each signature was completed.
* [SignCompleted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/signcompleted) to handle completion event. This event occurs once [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) process was completed.

Here are the steps to subscribe for signing process with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Define required handler delegates to process signing events.
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Subscribe for required events
* Instantiate required [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signature options in it

## Implement method for SignStarted event

GroupDocs.Signature expects [ProcessStartEventHandler](https://reference.groupdocs.com/signature/net/groupdocs.signature/processprogresseventhandler) delegate to subscribe for [SignStarted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/signstarted) event

```csharp
private static void OnSignStarted(Signature signature, ProcessStartEventArgs args)
{
    Console.WriteLine("Sign process started at {0} with {1} total signatures to be put in document", args.Started, args.TotalSignatures);
}
```

## Implement method for SignProgress event

```csharp
 private static void OnSignProgress(Signature signature, ProcessProgressEventArgs args)
 {
     Console.WriteLine("Sign progress. Processed {0} signatures. Time spent {1} mlsec", args.ProcessedSignatures, args.Ticks);
 }
```

## Implement method for SignCompleted event

```csharp
private static void OnSignCompleted(Signature signature, ProcessCompleteEventArgs args)
{
    Console.WriteLine("Sign process completed at {0} with {1} total signatures. Process took {2} mlsec", args.Completed, args.TotalSignatures, args.Ticks);
}
```

## Subscribing for signing process events

```csharp
private static void OnSignStarted(Signature signature, ProcessStartEventArgs args)
{
    Console.WriteLine("Sign process started at {0} with {1} total signatures to be put in document", args.Started, args.TotalSignatures);
}

private static void OnSignProgress(Signature signature, ProcessProgressEventArgs args)
{
    Console.WriteLine("Sign progress. Processed {0} signatures. Time spent {1} mlsec", args.ProcessedSignatures, args.Ticks);
}

private static void OnSignCompleted(Signature signature, ProcessCompleteEventArgs args)
{
    Console.WriteLine("Sign process completed at {0} with {1} total signatures. Process took {2} mlsec", args.Completed, args.TotalSignatures, args.Ticks);
}

public static void Run()
{
    using (Signature signature = new Signature("sample.pdf"))
    {
        signature.SignStarted += OnSignStarted;
        signature.SignProgress += OnSignProgress;
        signature.SignCompleted += OnSignCompleted;
        TextSignOptions options = new TextSignOptions("John Smith")
        {
            // set signature position
            Left = 100,
            Top = 100
        };

        // sign document to file
        signature.Sign("SignedSample", options);
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Supported Document Types

Path: /merger/net/supported-document-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Password protection | Join | Split | Extract pages | Move page | Remove pages | Swap pages | Change page orientation | Rotate pages | Import document | Cross-format merge to PDF / XPS | Cross-format merge to DOC / DOCX |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [DOC](https://docs.fileformat.com/word-processing/doc/) | Microsoft Word Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCX](https://docs.fileformat.com/word-processing/docx/) | Microsoft Word Open XML Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [DOCM](https://docs.fileformat.com/word-processing/docm/) | Word Open XML Macro-Enabled Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOT](https://docs.fileformat.com/word-processing/dot/) | Word Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTX](https://docs.fileformat.com/word-processing/dotx/) | Word Open XML Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [DOTM](https://docs.fileformat.com/word-processing/dotm/) | Word Open XML Macro-Enabled Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [RTF](https://docs.fileformat.com/word-processing/rtf/) | Rich Text Format File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODT](https://docs.fileformat.com/word-processing/odt/) | OpenDocument Text Document | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTT](https://docs.fileformat.com/word-processing/ott/) | OpenDocument Document Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [HTML](https://docs.fileformat.com/web/html/) | Hypertext Markup Language File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) |   |
| [MHT](https://docs.fileformat.com/web/mhtml/) | MHTML Web Archive |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [MHTML](https://docs.fileformat.com/web/mhtml/) | MIME HTML |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [PDF](https://docs.fileformat.com/view/pdf/) | Portable Document Format File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [XPS](https://docs.fileformat.com/page-description-language/xps/) | XML Paper Specification File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [TEX](https://docs.fileformat.com/page-description-language/tex/) | LaTeX Source Document |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EPUB](https://docs.fileformat.com/ebook/epub/) | Open eBook File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [PS](https://docs.fileformat.com/page-description-language/ps/) | PostScript File  | ![(tick)](/merger/net/images/check.png)|     |     |     |     |     |     |     |     |   |     |     |
| [PPT](https://docs.fileformat.com/presentation/ppt/) | Microsoft PowerPoint 97-2003 Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTX](https://docs.fileformat.com/presentation/pptx/) | Microsoft PowerPoint Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPS](https://docs.fileformat.com/presentation/pps/) | Microsoft PowerPoint 97-2003 Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/) | Microsoft PowerPoint Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPTM](https://docs.fileformat.com/presentation/pptm/) | Microsoft PowerPoint Macro-Enabled Presentation | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/) | Microsoft PowerPoint Macro-Enabled Slide Show | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [POTM](https://docs.fileformat.com/presentation/potm/) | Microsoft PowerPoint Macro-Enabled Presentation Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [POTX](https://docs.fileformat.com/presentation/potx/) | Microsoft PowerPoint Presentation Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODP](https://docs.fileformat.com/presentation/odp/) | OpenDocument Presentation |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [OTP](https://docs.fileformat.com/presentation/otp/) | OpenDocument Presentation Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/) | Microsoft Excel 97-2003 Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/) | Microsoft Excel Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/) | Microsoft Excel Binary Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/) | Microsoft Excel Macro-Enabled Worksheet | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLT](https://docs.fileformat.com/spreadsheet/xlt/) | Microsoft Excel Template File | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/) | Excel Open XML Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/) | Excel Open XML Macro-Enabled Spreadsheet Template | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [XLAM](https://docs.fileformat.com/spreadsheet/xlam/) | Excel Open XML Macro-Enabled Add-in | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/) | OpenDocument Spreadsheet |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |
| [VSD](https://docs.fileformat.com/image/vsd/) | Visio Drawing File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [VSS](https://docs.fileformat.com/image/vss/) | Visio Stencil File |   |   |   |   |   |   |   |   |   |   |   |   |
| [VST](https://docs.fileformat.com/image/vst/) | Visio Drawing Template |   |   |   |   |   |   |   |   |   |   |   |   |
| [VSDX](https://docs.fileformat.com/image/vsdx/) | Microsoft Visio Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSDM](https://docs.fileformat.com/image/vsdm/) | Microsoft Visio Macro-Enabled Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSX](https://docs.fileformat.com/image/vssx/) | Microsoft Visio Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSSM](https://docs.fileformat.com/image/vssm/) | Microsoft Visio Macro-Enabled Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTX](https://docs.fileformat.com/image/vstx/) | Microsoft Visio Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSTM](https://docs.fileformat.com/image/vstm/) | Microsoft Visio Macro-Enabled Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VDX](https://docs.fileformat.com/image/vdx/) | Microsoft Visio 2003-2010 XML Drawing |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VSX](https://docs.fileformat.com/image/vsx/) | Microsoft Visio 2003-2010 XML Stencil |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [VTX](https://docs.fileformat.com/image/vtx/) | Microsoft Visio 2003-2010 XML Template |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |   |   |
| [ONE](https://docs.fileformat.com/note-taking/one/) | Microsoft OneNote | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |
| [TXT](https://docs.fileformat.com/word-processing/txt/) | Plain Text File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [ERR](https://docs.fileformat.com/misc/err/) | Error Log File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [CSV](https://docs.fileformat.com/spreadsheet/csv/) | Comma Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |
| [TSV](https://docs.fileformat.com/spreadsheet/tsv/) | Tab Separated Values File |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   |   |   |   |   |   |   |   |   |

{{< alert style="tip" >}}

**Can’t find your file format?**

We’re here to help! Please post a request on our [Free Support Forum](https://forum.groupdocs.com/c/merger/32), and our team will assist you.

{{< /alert >}}
---

## Swap pages

Path: /merger/java/swap-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to swap two pages positions within the source document. The result is a new document where two pages have their positions exchanged.

Here are the steps to swap document pages:

*   Initialize [SwapOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/SwapOptions) class with page numbers to swap;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [swapPages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#swapPages(com.groupdocs.merger.domain.options.interfaces.ISwapOptions)) method and pass [SwapOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/SwapOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to split document:

```java
String filePath = "c:\sample.pptx";
String filePathOut = "c:\output\result.pptx";

int pageNumber1 = 3;
int pageNumber2 = 6;
SwapOptions swapOptions = new SwapOptions(pageNumber2, pageNumber1);

Merger merger = new Merger(filePath);        
merger.swapPages(swapOptions);
merger.save(filePathOut);
```

---

## Swap pages

Path: /merger/nodejs-java/swap-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to swap two pages positions within the source document. The result is a new document where two pages have their positions exchanged.

Here are the steps to swap document pages:

*   Initialize [SwapOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/SwapOptions) class with page numbers to swap;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [swapPages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#swapPages(com.groupdocs.merger.domain.options.interfaces.ISwapOptions)) method and pass [SwapOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/SwapOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to split document:

```js
const inputFilePath = `c:/sample.pptx`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output/result.pptx`;
const swapOptions = new groupdocs.merger.SwapOptions(1, 3);
merger.swapPages(swapOptions);
merger.save(outputPath);
```

---

## Swap pages

Path: /merger/python-net/swap-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to swap two pages positions within the source document. The result is a new document where two pages have their positions exchanged.

Here are the steps to swap document pages:

*   Initialize [SwapOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/SwapOptions) class with page numbers to swap;
*   Instantiate [Merger](https://reference.groupdocs.com/net/merger/groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [swapPages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/swappages/) method and pass [SwapOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/SwapOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method specifying file path to save resultant document.

The following code sample demonstrates how to split document:

```python
with gm.Merger("c:/sample.pptx") as merger:
    swap_options = gm.domain.options.SwapOptions(1, 3)
    merger.swap_pages(swap_options)
    merger.save("c:/result.pptx")
```

---

## System Requirements

Path: /merger/java/system-requirements/

## Overview

GroupDocs.Merger for Java does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "merger/java/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Merger for Java supports any 32-bit or 64-bit operating system that runs the Java runtime including, but not limited:

### Windows

* Microsoft Windows 2003 Server ( x64, x86)
* Microsoft Windows 2008 Server ( x64, x86)
* Microsoft Windows 2012 Server ( x64, x86)
* Microsoft Windows 2012 R2 Server ( x64, x86)
* Microsoft Windows 2016 Server ( x64, x86)
* Microsoft Windows 2019 Server ( x64, x86)
* Microsoft Windows Vista ( x64, x86)
* Microsoft Windows XP ( x64, x86)
* Microsoft Windows 7 ( x64, x86)
* Microsoft Windows 8, 8.1 ( x64, x86)
* Microsoft Windows 10 ( x64, x86)
* Microsoft Azure

### Linux

* Linux (Ubuntu, OpenSUSE, CentOS, and others)

### Mac

* Mac OS X

## Supported Java Versions

GroupDocs.Merger for Java supports the following Java versions:

* J2SE 8.0 (1.8)
* or above (*for example Java 10*)

---

## Text redaction

Path: /redaction/net/text-redactions/

GroupDocs.Redaction allows to easily redact data of sensitive or private nature from your documents. The most popular redaction case is to remove a text from a document.

With GroupDocs.Redaction API you can apply text redaction using exact phrase or [regular expression](https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expressions) for documents of different formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list at [supported document formats]({{< ref "redaction/net/getting-started/supported-document-formats.md" >}}) article.

## Use exact phrase redaction

In the example below, we apply textual redaction, replacing personal exact phrase "John Doe" with "\[personal\]" (or any exemption code):

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
  redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
  redactor.Save();
}
```

By default, search for exact phase is case insensitive.For a case-sensitive redaction, there is a constructor parameter and corresponding public property:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
  redactor.Apply(new ExactPhraseRedaction("John Doe", true /*isCaseSensitive*/, new ReplacementOptions("[personal]")));
  redactor.Save();
}
```

If you need a color box over the redacted text, you can use color instead of replacement string. The redaction will erase matched text and put a rectangle of the specified color in place of redacted text:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
  redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(System.Drawing.Color.Black)));
  redactor.Save();
}
```

You might need to apply redaction to a right-to-left document, such as Arabic or Hebrew. The following example demonstrates how to apply ExactPhraseRedaction to an Arabic PDF document:

**C#**

```csharp
using (Redactor redactor = new Redactor("Arabic.pdf"))
{
    ExactPhraseRedaction red = new ExactPhraseRedaction("أﺑﺠﺪ", new ReplacementOptions("[test]"));
    red.IsRightToLeft = true;
    
    redactor.Apply(red);
    redactor.Save();
}
```

## Use regular expression

Behind the scenes, "exact phrase" redaction works though regular expressions, which are the baseline approach for redaction. In the example below, we redact out any text, matching "2 digits, space or nothing, 2 digits, again space and 6 digits" with a blue color box:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
  redactor.Apply(new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", new ReplacementOptions(System.Drawing.Color.Blue)));
  redactor.Save();
}
```

If you need to apply redact a whole paragraph, you might also need to use RegexRedaction. The following example demonstrates how to redact the whole paragraph in a PDF document:

**C#**

```csharp
using (Redactor redactor = new Redactor("LoremIpsum.pdf"))
{
    redactor.Apply(new RegexRedaction("(Lorem(\n|.)+?urna)", new ReplacementOptions(System.Drawing.Color.Red)));
    redactor.Save();
}
```


## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Text redaction

Path: /redaction/python-net/text-redactions/

GroupDocs.Redaction allows to easily redact data of sensitive or private nature from your documents. The most popular redaction case is to remove a text from a document.

With GroupDocs.Redaction API you can apply text redaction using exact phrase or [regular expression](https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expressions) for documents of different formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list at [supported document formats]({{< ref "redaction/python-net/getting-started/supported-document-formats.md" >}}) article.

## Use exact phrase redaction

In the example below, we apply textual redaction, replacing personal exact phrase "John Doe" with "\[personal\]" (or any exemption code):

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

By default, search for exact phase is case insensitive. For a case-sensitive redaction, there is a constructor parameter and corresponding public property:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    case_sensitive = True
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", case_sensitive, repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

If you need a color box over the redacted text, you can use color instead of replacement string. The redaction will erase matched text and put a rectangle of the specified color in place of redacted text:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():

    # Specify the redaction options
    color = grd.Color.from_argb(255, 220, 20, 60)
    repl_opt = grr.ReplacementOptions(color)
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        redactor.save()
```

You might need to apply redaction to a right-to-left document, such as Arabic or Hebrew. The following example demonstrates how to apply ExactPhraseRedaction to an Arabic PDF document:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[test]")
    ex_red = grr.ExactPhraseRedaction("أﺑﺠﺪ", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        redactor.save()
```

## Use regular expression

Behind the scenes, "exact phrase" redaction works though regular expressions, which are the baseline approach for redaction. In the example below, we redact out any text, matching "2 digits, space or nothing, 2 digits, again space and 6 digits" with a blue color box:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():

    # Specify the redaction options
    color = grd.Color.from_argb(255, 220, 20, 60)
    repl_opt = grr.ReplacementOptions(color)
    reg_red = grr.RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("sample.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(reg_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

If you need to apply redact a whole paragraph, you might also need to use RegexRedaction. The following example demonstrates how to redact the whole paragraph in a PDF document:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():

    # Specify the redaction options
    color = grd.Color.from_argb(255, 220, 20, 60)
    repl_opt = grr.ReplacementOptions(color)
    ex_red = grr.RegexRedaction("(Lorem(\n|.)+?urna)", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("sample.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        redactor.save()
```


## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
   

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).


---

## Text redactions

Path: /redaction/java/text-redactions/

### Use exact phrase redaction

In the example below, we apply textual redaction, replacing personal exact phrase "John Doe" with "\[personal\]" (or any exemption code):



```java
final Redactor redactor = new Redactor("sample.docx");
try 
{
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));
    redactor.save();
}
finally { redactor.close(); }
```

By default, search for exact phase is case insensitive.For a case-sensitive redaction, there is a constructor parameter and corresponding public property:



```java
final Redactor redactor = new Redactor("sample.docx");
try
{
    redactor.apply(new ExactPhraseRedaction("John Doe", true /*isCaseSensitive*/, new ReplacementOptions("[personal]")));
    redactor.save();
}
finally { redactor.close(); }
```

If you need a color box over the redacted text, you can use color instead of replacement string. The redaction will erase matched text and put a rectangle of the specified color in place of redacted text:



```java
final Redactor redactor = new Redactor("sample.docx");
try
{
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(java.awt.Color.RED)));
    redactor.save();
}
finally { redactor.close(); }
```

You might need to apply redaction to a right-to-left document, such as Arabic or Hebrew. The following example demonstrates how to apply ExactPhraseRedaction to an Arabic PDF document:

```java
final Redactor redactor = new Redactor("Arabic.pdf");
try
{
    ExactPhraseRedaction red = new ExactPhraseRedaction("أﺑﺠﺪ", new ReplacementOptions("[test]"));
    red.setRightToLeft(true);
    redactor.apply(red);
    redactor.save();
}
finally { redactor.close(); }
```

### Use regular expression

Behind the scenes, "exact phrase" redaction works though regular expressions, which are the baseline approach for redaction. In the example below, we redact out any text, matching "2 digits, space or nothing, 2 digits, again space and 6 digits" with a blue color box:



```java
final Redactor redactor = new Redactor("sample.docx");
try
{
    redactor.apply(new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", new ReplacementOptions(java.awt.Color.BLUE)));
    SaveOptions saveOptions = new SaveOptions();
    saveOptions.setAddSuffix(true);
    saveOptions.setRasterizeToPDF(false);
    redactor.save(saveOptions);
}
finally { redactor.close(); }
```

If you need to apply redact a whole paragraph, you might also need to use RegexRedaction. The following example demonstrates how to redact the whole paragraph in a PDF document:

```java
final Redactor redactor = new Redactor("LoremIpsum.pdf");
try
{
    redactor.apply(new RegexRedaction("(Lorem(\n|.)+?urna)", new ReplacementOptions("[test]")));
    SaveOptions saveOptions = new SaveOptions();
    saveOptions.setAddSuffix(true);
    saveOptions.setRasterizeToPDF(false);
    redactor.save(saveOptions);
}
finally { redactor.close(); }
```

---

## Update document password

Path: /merger/net/update-document-password/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to update password from password-protected document. The resultant document will have new password.  
Here are the steps to update document password:

*   Initialize [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) class specifying current password;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream and pass [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) object to it;
*   Initialize [UpdatePasswordOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/updatepasswordoptions) class specifying new document password;
*   Call [UpdatePassword](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/updatepassword) method and pass [UpdatePasswordOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/updatepasswordoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to update document password:

```csharp
string filePath = @"c:\sample.xlsx";
string filePathOut = @"c:\output\result.xlsx";

ILoadOptions loadOptions = new LoadOptions("SAMPLE_PASSWORD");
IUpdatePasswordOptions updateOptions = new UpdatePasswordOptions("NEW_SAMPLE_PASSWORD");

using (Merger merger = new Merger(filePath, loadOptions))
{
    merger.UpdatePassword(updateOptions);
    merger.Save(filePathOut);
}
```

---

## Update document password

Path: /merger/python-net/update-document-password/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net)** allows to update password from password-protected document. The resultant document will have new password.  
Here are the steps to update document password:

*   Initialize [LoadOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/loadoptions) class specifying current password;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger) object with source document path or stream and pass [LoadOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/loadoptions) object to it;
*   Initialize [UpdatePasswordOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/updatepasswordoptions) class specifying new document password;
*   Call [UpdatePassword](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/updatepassword) method and pass [UpdatePasswordOptions](https://reference.groupdocs.com/merger/python-net/groupdocs.merger.domain.options/updatepasswordoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/python-net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to update document password:

```python
load_options = gm.domain.options.LoadOptions("SomePasswordString")
with gm.Merger(constants.sample_xlsx_protected, load_options) as merger:
    update_password_options = gm.domain.options.UpdatePasswordOptions("OtherPasswordString")
    merger.update_password(update_password_options)
    merger.save(constants.output_xlsx)
```

---

## Update watermarks

Path: /watermark/net/basic-usage/update/

The GroupDocs.Watermark library is also capable of searching the document for any existing text or image watermarks. These can be watermarks added by any third-party tool, not only by GroupDocs.Watermark. Searching watermarks is possible for some of the supported formats. To learn whether it is available for your format, check [Supported formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}}). 

Once found you can update those watermarks.

{{< alert style="info" >}}Updating of watermarks is not allowed in evaluation mode. Please set up a license as described in [Licensing and evaluation]({{< ref "watermark/net/getting-started/evaluation-limitations-and-licensing" >}}).{{< /alert >}}

## Updating text watermarks

To search and update text watermarks:
1. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) an instance of the `Watermarker` class for a local file or file stream;
2. Specify the sought-after text of the watermarks. To define criteria use the instance of the [TextSearchCriteria](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search.searchcriteria/textsearchcriteria/) class. In this example, we will search for a particular string match.
3. Call the [Search](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermarker/search/#search_1) method of the `Watermarker` class to perform the search and obtain a collection of all possible watermarks that meet the search criteria.
4. Iterate through the collection of possible watermarks and update the found text occurrences using the [Text](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search/possiblewatermark/text/) property.
5. Call the [Save](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/4) method to store the document in a new location.

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Search.SearchCriteria;
using GroupDocs.Watermark.Search;

using (Watermarker watermarker = new Watermarker("C:\\Docs\\watermarked-sample.docx"))
{
    // Search watermark matching a particular text
    TextSearchCriteria searchCriteria = new TextSearchCriteria("Contract Draft", false);
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(searchCriteria);
    Console.WriteLine("Found {0} possible watermark(s).", possibleWatermarks.Count);
    foreach (PossibleWatermark watermark in possibleWatermarks)
    {
        try
        {
            // Update text
            watermark.Text = "Contract is no longer valid";            
        }
        catch (Exception e)
        {
            // Found entity may not support text editing
            // Passed argument can have inappropriate value
            // Process such cases here
        }
    }
    // Save document
    watermarker.Save("C:\\Docs\\updated-sample.docx");
}
```
Run the program. All found occurrences of "Contract Draft" in watermarks will be changed to "Contract is no longer valid".

![Updating text watermarks](/watermark/net/images/watermarking/update-text.png)

### What's next

Text search capabilities of GroupDocs.Watermark are not limited by simple text matches. To learn how to search using regular expressions, or search the watermarks on the basis of some particular text formatting, or update the formatting of found text, see the [Searching watermarks]({{< ref "watermark/net/developer-guide/advanced-usage/searching-and-modifying-watermarks/searching-watermarks.md" >}}) and [Modifying found watermark properties]({{< ref "watermark/net/developer-guide/advanced-usage/searching-and-modifying-watermarks/modifing-found-watermark-properties.md" >}}) articles of the "Advanced usage" section.

## Updating image watermarks

To search and update text watermarks:
1. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) an instance of the `Watermarker` class for a local file or file stream;
2. Specify the sought-after image of the watermarks. To define criteria use the instance of the [ImageSearchCriteria](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search.searchcriteria/imagesearchcriteria/) class.
3. Specify the maximum allowed difference between the images using the [MaxDifference](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search.searchcriteria/imagesearchcriteria/maxdifference/) property. Too strict threshold may fail to detect all needed images, while a very lenient threshold could match dissimilar images.
4. Call the [Search](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermarker/search/#search_1) method of the `Watermarker` class to perform the search and obtain a collection of all possible watermarks that meet the search criteria.
5. Iterate through the collection of possible watermarks and update the found image occurrences using the [ImageData](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search/possiblewatermark/imagedata/) property.
6. Call the [Save](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/4) method to store the document in a new location.

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Search.SearchCriteria;
using GroupDocs.Watermark.Search;

using (Watermarker watermarker = new Watermarker("C:\\Docs\\watermarked-sample.docx"))

{
    // Initialize criteria with the image    
    ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("C:\\Docs\\logo.png");
    //Set maximum allowed difference between images
    imageSearchCriteria.MaxDifference = 0.9;
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(imageSearchCriteria);
    Console.WriteLine("Found {0} possible watermark(s).", possibleWatermarks.Count);
    
    // Read new watermark image
    byte[] imageData = File.ReadAllBytes("C:\\Docs\\new-logo.png");
    foreach (PossibleWatermark watermark in possibleWatermarks)
    {
        try
        {
            // Replace image
            watermark.ImageData = imageData;
        }
        catch (Exception e)
        {
            // Found entity may not support text editing
            // Passed argument can have inappropriate value
            // Process such cases here
        }
    }
    // Save document
    watermarker.Save("C:\\Docs\\updated-sample.docx");    
}
```
Run the program. All found occurrences of image watermarks will be updated.

![Updating image watermarks](/watermark/net/images/watermarking/update-image.png)

### What's next

Searching by images is a way more complex operation that may require finding an appropriate difference threshold or even using other image comparison algorithms. GroupDocs.Watermark offers several image search criteria algorithms. To learn more about them, see the [Searching watermarks]({{< ref "watermark/net/developer-guide/advanced-usage/searching-and-modifying-watermarks/searching-watermarks.md" >}}) article of the "Advanced usage" section.


---

## Update watermarks

Path: /watermark/python-net/basic-usage/update/


Search for existing watermarks and update them.

## Updating text watermarks

Easily find and modify existing text watermarks in documents. With Python, you can search for a watermark by its text content and update it with a new value.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("C:\\Docs\\watermarked-sample.docx") as watermarker:
    criteria = gws_sc.TextSearchCriteria("Contract Draft", False)
    possible = watermarker.search(criteria)
    print("Found", possible.count, "possible watermark(s).")
    for wm in possible:
        try:
            wm.text = "Contract is no longer valid"
        except Exception:
            pass
    watermarker.save("C:\\Docs\\updated-sample.docx")
```

## Updating image watermarks

Quickly replace old or incorrect image watermarks with new ones. Python developers can search for an image watermark using perceptual hashing and swap it with an updated logo or graphic.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("C:\\Docs\\watermarked-sample.docx") as watermarker:
    image_criteria = gws_sc.ImageDctHashSearchCriteria("C:\\Docs\\logo.png")
    image_criteria.max_difference = 0.9
    possible = watermarker.search(image_criteria)
    print("Found", possible.count, "possible watermark(s).")
    with open("C:\\Docs\\new-logo.png", "rb") as f:
        image_data = f.read()
    for wm in possible:
        try:
            wm.image_data = image_data
        except Exception:
            pass
    watermarker.save("C:\\Docs\\updated-sample.docx")
```



---

## Updating Text signature with advanced options

Path: /signature/java/updating-text-signature-with-advanced-options/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextSignature](http://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) class to manipulate text signatures location, size and textual content over [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. This method returns [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) object to analyze if signatures were successfully processed.

Please be aware that [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class. The [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) contains list of successfully updated signatures and ones that failed. The Text signature could be failed to update due to several reasons:

*   if signature object was initialized with constructor by incorrect signature identifier;
*   if signature object was not found;
*   there was an error occurred while updating signature in the document.

Here are the steps to update Text signature in the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate [TextSearchOptions](http://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) object with desired properties;    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to obtain list of [TextSignatures](http://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature); 
*   Select from list [TextSignature](http://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) object(s) that should be updated;  
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it.    
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not.

Here are the alternative steps to update Text signature in the document with GroupDocs.Signature. This approach is based on saved signatures Id after [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) or [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) methods.

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate one or several [TextSignature](http://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/TextSignature) objects with signature Id(s) passed to constructor;      
*   Call [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class object [update](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#update(java.io.OutputStream,%20com.groupdocs.signature.domain.signatures.BaseSignature)) method and pass one or several signatures to it;    
*   Analyze [UpdateResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/UpdateResult) result to check whether signatures were updated or not.

The following table describes changeable properties for Text signatures dependent on document type.

| Document Type / Signature Property | Left | Top | Width | Height | Text | IsSignature |
| --- | --- | --- | --- | --- | --- | --- |
| Image | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) | ![(error)](/signature/java/images/error.png) |
| Spreadsheet | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| Pdf | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| Presentation | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |
| Word Processing | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) | ![(tick)](/signature/java/images/check.png) |

## Update Text signature in the document after Search

This example shows how to update Text signature that was found using [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method.

```java
// initialize Signature instance
Signature signature = new Signature("sampleSigned.pdf");
TextSearchOptions options = new TextSearchOptions();
 
List<TextSignature> signatures = signature.search(TextSignature.class, options);
List<BaseSignature> bS = new ArrayList<BaseSignature>();
// adjust signature properties
for (TextSignature temp : signatures)
{
    // apply some condition to adjust signature properties
    temp.setLeft(temp.getLeft() + 100);
    temp.setTop(temp.getTop() + 100);
    temp.setSignature(true);
    bS.add(temp);
}
// update all found signatures
UpdateResult updateResult = signature.update("sampleSigned.pdf",bS);
if (updateResult.getSucceeded().size() == signatures.size())
{
    System.out.print("\nAll signatures were successfully updated!");
}
else
{
    System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : "+updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## Update Text signature in document by known signature Identifier

This example shows how to update Text signature in the document by known signature Id (that was obtained by [Search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#search(java.lang.Class,%20int)) or [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/SignResult) method previously) and analyze result.

```java
// initialize Signature instance
Signature signature = new Signature("sampleSigned.pdf");
// read from some data source signature Id value
String[] signatureIdList = new String[]
        {
                "1dd21cf3-b904-4da9-9413-1ff1dab51974",                    
                "b0123987-b0d4-4004-86ec-30ab5c41ac7e"
        };
// create list of Barcode Signature by known SignatureId
List<BaseSignature> signatures = new ArrayList<BaseSignature>();
for (String item : signatureIdList)
{
    TextSignature temp = new TextSignature(item);
    temp.setWidth(150);
    temp.setHeight(150);
    temp.setLeft(200);
    temp.setTop(200);
    signatures.add(temp);
}
// update all found signatures
UpdateResult updateResult = signature.update("sampleSigned.pdf",signatures);
if (updateResult.getSucceeded().size() == signatures.size())
{
    System.out.print("\nAll signatures were successfully updated!");
}
else
{
    System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
    System.out.print("Not updated signatures : "+updateResult.getFailed().size());
}
System.out.print("List of updated signatures:");
for (BaseSignature temp : updateResult.getSucceeded())
{
    System.out.print("Signature# Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Use Microsoft Azure Computer Vision API

Path: /redaction/net/use-microsoft-azure-computer-vision/


This implementation is based on [Microsoft Azure Computer Vision API](https://docs.microsoft.com/en-US/azure/cognitive-services/computer-vision/). The service is paid, but you can [create a free subscription](https://azure.microsoft.com/free/cognitive-services/). Once you've done with subscription, you will have to [create Computer Vision resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision) using the free pricing tier (F0) to try the service, and upgrade later to a paid tier for production. As a result, you will get Computer Vision Endpoint and Subscription Key (let's suppose they are stored in the environment variables COMPUTER_VISION_ENDPOINT and COMPUTER_VISION_SUBSCRIPTION_KEY respectively). 

**C#**

```csharp
using Newtonsoft.Json.Linq;

public class ComputerVisionOcrConnector : IOcrConnector
{
    private const string OcrUri = "vision/v2.1/ocr";
    private readonly string SubscriptionKey;
    private readonly string Endpoint;

    public ComputerVisionOcrConnector()
    {
        Endpoint = Environment.GetEnvironmentVariable("COMPUTER_VISION_ENDPOINT");
        SubscriptionKey = Environment.GetEnvironmentVariable("COMPUTER_VISION_SUBSCRIPTION_KEY");
    }

    public string GetServiceUri(bool detectOrientation, string language)
    {
        // Request parameters. 
        // The language parameter doesn't specify a language, so the 
        // method detects it automatically.
        // The detectOrientation parameter is set to true, so the method detects and
        // and corrects text orientation before detecting text.

        // Assemble the URI for the REST API method.
        return string.Format("{0}{1}?language={2}&detectOrientation={3}", Endpoint, OcrUri,
            string.IsNullOrEmpty(language) ? "unk" : language, detectOrientation).ToLower();
    }

    public RecognizedImage Recognize(Stream imageStream)
    {
        try
        {
            using (WebClient client = new WebClient())
            {
                client.Headers[HttpRequestHeader.Accept] = "application/json";
                // authentication
                client.Headers.Add("Ocp-Apim-Subscription-Key", SubscriptionKey);
                // payload
                BinaryReader binaryReader = new BinaryReader(imageStream);
                var data = binaryReader.ReadBytes((int)imageStream.Length);
                client.Headers[HttpRequestHeader.ContentType] = "application/octet-stream";
                string stringResponse = string.Empty;
                try
                {
                    byte[] result = client.UploadData(GetServiceUri(true, null), data);
                    stringResponse = Encoding.UTF8.GetString(result);
                }
                catch (Exception ex)
                {
                    // MS Azure Cognintive services reports 400 Bad requests and other exceptions on small pictures and pictures with no text
                    Console.WriteLine("Microsoft Azure Cognitive Services consider this image as wrong ({0})", ex.ToString());
                }
                if (!string.IsNullOrEmpty(stringResponse))
                {
                    return CreateDtoFromResponse(JToken.Parse(stringResponse));
                }
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Microsoft Azure Cognitive Services Text Recognition failed: {0}", ex.ToString());
        }
        return new RecognizedImage(new List<TextLine>());
    }

    protected virtual RecognizedImage CreateDtoFromResponse(JToken jToken)
    {
        // Parse json response to extract lines and words with the bounding rectangles.
    }

    ...
}

```
The service returns a JSON-serialized with text regions and recognized words, each word with its bounding rectangle.

You can find full implementation and an example of its usage here [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save signed Word Processing with different output file type

Path: /signature/java/save-signed-word-processing-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class supports saving of Word Processing signed documents with different formats. Each of document type has list of compatible saving type. These values are listed in enum [WordProcessingSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/WordProcessingSaveFileFormat).

Here are the steps to save signed Word Processing document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java):

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class and pass source document path or stream as a constructor parameter.    
*   Instantiate required signature options.    
*   Instantiate the [WordProcessingSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/WordProcessingSaveOptions) object according to your requirements and specify [setFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/WordProcessingSaveOptions#setFileFormat(int)) as one of predefined values from [WordProcessingSaveFileFormat](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.enums/WordProcessingSaveFileFormat).     
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature)  class instance and pass signatureoptions and [WordProcessingSaveOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.saveoptions/WordProcessingSaveOptions) object to it.
    

Following example demonstrates how to save signed Word processing document with different output type

```java
Signature signature = new Signature("sample.docx");
// create QRCode option with predefined QRCode text
QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);
signOptions.setTop(100);
 
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions();
saveOptions.setFileFormat(WordProcessingSaveFileFormat.Odt);
saveOptions.setOverwriteExistingFiles(true);
// sign document to file
signature.sign("SignedDocx.odt", signOptions, saveOptions);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Save signed Word Processing with different output file type

Path: /signature/net/save-signed-word-processing-with-different-output-file-type/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class supports saving of Word Processing signed documents with different formats. Each of document type has list of compatible saving type. These values are listed in enum [WordProcessingSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/wordprocessingsavefileformat).

Here are the steps to save signed Word Processing document to different output type with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net):

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required signature options.
* Instantiate the [WordProcessingSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/wordprocessingsaveoptions) object according to your requirements and specify [FileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/wordprocessingsaveoptions/fileformat) as one of predefined values from [WordProcessingSaveFileFormat](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/wordprocessingsavefileformat).
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass signatureoptions and [WordProcessingSaveOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/wordprocessingsaveoptions) object to it.

Following example demonstrates how to save signed Word processing document with different output type

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    // create QRCode option with predefined QRCode text
    QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith")
    {
        // setup QRCode encoding type
        EncodeType = QRCodeTypes.QR,
        // set signature position
        Left = 100,
        Top = 100
    };
    WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions()
    {
        FileFormat = WordProcessingSaveFileFormat.Odt,
        OverwriteExistingFiles = true
    };
    // sign document to file
    signature.Sign("SignedDocx.odt", signOptions, saveOptions);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Working with Images

Path: /parser/python-net/working-with-images/


Use image areas to inspect page coordinates, image types, and to save embedded resources in the desired format.

## Save images to streams
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("brochure.pdf") as parser:
    images = parser.get_images()
    if images is None:
        print("Image extraction isn't supported for this format.")
    else:
        for image_area in images:
            with image_area.get_image_stream() as stream:
                data = stream.read()
                print(f"Read {len(data)} bytes from page {image_area.page.index + 1}")
```

{{< /tab >}}
{{< tab "brochure.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [brochure.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/working-with-images/working-with-images/brochure.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Tips

- `PageImageArea` exposes `rectangle`, `page`, and `file_type` so you can filter by size or format.  
- Use `save(path)` for convenience or `get_image_stream()` when you need to process bytes in memory.  
- For large documents, stop iterating once you have saved the images you need to minimize memory usage.


---

## Working with metadata in Diagrams

Path: /metadata/java/working-with-metadata-in-diagrams/

GroupDocs.Metadata for Java provides functionality that allows working with different kinds of diagrams such as VDX, VSDX, VSX, etc. For the full list of supported document formats please refer to [Supported document formats]({{< ref "metadata/java/getting-started/supported-document-formats.md" >}}).

## Detecting the exact type of a document

The following sample of code will help you to detect the exact type of a loaded diagram and extract some additional file format information.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PDF document
2.  Extract the root metadata package
3.  Use the [getDiagramType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DiagramRootPackage#getDiagramType()) method to obtain file format information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.diagram.<WBR>DiagramReadFileFormatProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputVdx)) {
	DiagramRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDiagramType().getFileFormat());
	System.out.println(root.getDiagramType().getDiagramFormat());
	System.out.println(root.getDiagramType().getMimeType());
	System.out.println(root.getDiagramType().getExtension());
}
```

## Reading built-In metadata properties

To access built-in metadata of a diagram, please use the [getDocumentProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage#getDocumentProperties()) method defined in the [DocumentRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.diagram.<WBR>DiagramReadBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputVsdx)) {
	DiagramRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentProperties().getCreator());
	System.out.println(root.getDocumentProperties().getCompany());
	System.out.println(root.getDocumentProperties().getKeywords());
	System.out.println(root.getDocumentProperties().getLanguage());
	System.out.println(root.getDocumentProperties().getTimeCreated());
	System.out.println(root.getDocumentProperties().getCategory());

	// ...
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a diagram please follow the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.diagram.<WBR>DiagramReadCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputVsdx)) {
	DiagramRootPackage root = metadata.getRootPackageGeneric();

	IReadOnlyList<MetadataProperty> customProperties = root.getDocumentProperties().findProperties(new ContainsTagSpecification(Tags.getDocument().getBuiltIn()).not());

	for (MetadataProperty property : customProperties) {
		System.out.println(String.format("%s = %s", property.getName(), property.getValue().getRawValue()));
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [findProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MetadataPackage#findProperties(com.groupdocs.metadata.search.Specification)) method for a certain metadata package (instance of the [DiagramPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DiagramPackage) class), the search result will contain only metadata properties that are specific for diagram documents. 

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a diagram (only the page count statistic is available at the moment).

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.diagram.<WBR>DiagramReadDocumentStatistics**

```csharp
try (Metadata metadata = new Metadata(Constants.InputVdx)) {
	DiagramRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentStatistics().getPageCount());
}
```

## Updating built-In metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a diagram document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.diagram.<WBR>DiagramUpdateBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputVdx)) {
	DiagramRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().setCreator("test author");
	root.getDocumentProperties().setTimeCreated(new Date());
	root.getDocumentProperties().setCompany("GroupDocs");
	root.getDocumentProperties().setCategory("test category");
	root.getDocumentProperties().setKeywords("metadata, built-in, update");

	// ...

	metadata.save(Constants.OutputVdx);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a diagram document. Please check the code sample below.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.diagram.<WBR>DiagramUpdateCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputVsdx)) {
	DiagramRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().set("customProperty1", "some value");
	root.getDocumentProperties().set("customProperty2", true);

	metadata.save(Constants.OutputVsdx);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in JPEG2000 images

Path: /metadata/java/working-with-metadata-in-jpeg2000-images/

## Reading JPEG2000 comments

The GroupDocs.Metadata API supports extracting format-specific information from JPEG2000 images.

The following are the steps to read the JPEG2000 comments (pieces of metadata represented as strings with the length up to 64 kbytes).

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a JPEG2000 image
2.  Get the root metadata package
3.  Extract  the native metadata package using the [Jpeg2000RootPackage.getJpeg2000Package](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/Jpeg2000RootPackage#getJpeg2000Package()) method
4.  Read the JPEG2000 comments

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.jpeg2000.Jpeg2000ReadComments**

```csharp
try (Metadata metadata = new Metadata(Constants.InputJpeg2000)) {
	Jpeg2000RootPackage root = metadata.getRootPackageGeneric();

	if (root.getJpeg2000Package().getComments() != null) {
		for (String comment : root.getJpeg2000Package().getComments()) {
			System.out.println(comment);
		}
	}
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java also allows managing XMP metadata in JPEG2000 images. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in JPEG2000 images. Please find appropriate code samples in the [Working with EXIF Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in JPEG2000 images

Path: /metadata/net/working-with-metadata-in-jpeg2000-images/

## Reading JPEG2000 comments

The GroupDocs.Metadata API supports extracting format-specific information from JPEG2000 images.

The following are the steps to read the JPEG2000 comments (pieces of metadata represented as strings with the length up to 64 kbytes).

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a JPEG2000 image
2.  Get the root metadata package
3.  Extract  the native metadata package using [Jpeg2000RootPackage.Jpeg2000Package](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/jpeg2000rootpackage/properties/jpeg2000package)
4.  Read the JPEG2000 comments

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Jpeg2000.Jpeg2000ReadComments**

```csharp
using (Metadata metadata = new Metadata(Constants.InputJpeg2000))
{
	var root = metadata.GetRootPackage<Jpeg2000RootPackage>();
	if (root.Jpeg2000Package.Comments != null)
	{
		foreach (var comment in root.Jpeg2000Package.Comments)
		{
			Console.WriteLine(comment);
		}
	}
}
```

## Working with XMP metadata

GroupDocs.Metadata for .NET also allows managing XMP metadata in JPEG2000 images. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in JPEG images. Please find appropriate code samples in the [Working with EXIF metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in MOV files

Path: /metadata/java/working-with-metadata-in-mov-files/

## Reading MOV format-specific properties

The GroupDocs.Metadata API supports extracting QuickTime atoms from a MOV video. The atom is the basic data unit in any QuickTime file. Please find more information on QuickTime atoms in the official specification: [https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFPreface/qtffPreface.html](https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFPreface/qtffPreface.html)

The following are the steps to extract QuickTime atoms from a MOV video.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a MOV video
2.  Get the root metadata package
3.  Extract  the native metadata package using the [MovRootPackage.getMovPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MovRootPackage#getMovPackage()) method
4.  Read the QuickTime atoms

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>video.mov.MovReadQuickTimeAtoms**

```csharp
try (Metadata metadata = new Metadata(Constants.InputMov)) {
	MovRootPackage root = metadata.getRootPackageGeneric();

	for (MovAtom atom : root.getMovPackage().getAtoms()) {
		System.out.println(atom.getType());
		System.out.println(atom.getOffset());
		System.out.println(atom.getSize());

		// ...
	}
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in MOV files. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in MOV Files

Path: /metadata/net/working-with-metadata-in-mov-files/

## Reading MOV format-specific properties

The GroupDocs.Metadata API supports extracting QuickTime atoms from a MOV video. The atom is the basic data unit in any QuickTime file. Please find more information on QuickTime atoms in the official specification: [https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFPreface/qtffPreface.html](https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFPreface/qtffPreface.html)

The following are the steps to extract QuickTime atoms from a MOV video.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a MOV video
2.  Get the root metadata package
3.  Extract  the native metadata package using [MovRootPackage.MovPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.video/movrootpackage/properties/movpackage)
4.  Read the QuickTime atoms

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Video.Mov.MovReadQuickTimeAtoms**

```csharp
using (Metadata metadata = new Metadata(Constants.InputMov))
{
	var root = metadata.GetRootPackage<MovRootPackage>();
	foreach (var atom in root.MovPackage.Atoms)
	{
		Console.WriteLine(atom.Type);
		Console.WriteLine(atom.Offset);
		Console.WriteLine(atom.Size);

		// ...
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in PDF documents

Path: /metadata/net/working-with-metadata-in-pdf-documents/

## Detecting the version of a PDF document

The following sample of code will help you to detect the PDF version a loaded document and extract some additional file format information.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PDF document
2.  Extract the root metadata package
3.  Use the [FileType](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/pdfrootpackage/properties/filetype) property to obtain file format information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfReadFileFormatProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();

	Console.WriteLine(root.FileType.FileFormat);
	Console.WriteLine(root.FileType.Version);
	Console.WriteLine(root.FileType.MimeType);
	Console.WriteLine(root.FileType.Extension);
}
```

## Reading built-in metadata properties

To access built-in metadata of a PDF document, please use the [DocumentProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1/properties/documentproperties) property defined in the [DocumentRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfReadBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();

	Console.WriteLine(root.DocumentProperties.Author);
	Console.WriteLine(root.DocumentProperties.CreatedDate);
	Console.WriteLine(root.DocumentProperties.Subject);
	Console.WriteLine(root.DocumentProperties.Producer);
	Console.WriteLine(root.DocumentProperties.Keywords);

	// ... 
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a PDF document please follow the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfReadCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();

	var customProperties = root.DocumentProperties.FindProperties(p => !p.Tags.Contains(Tags.Document.BuiltIn));
	foreach (var property in customProperties)
	{
		Console.WriteLine("{0} = {1}", property.Name, property.Value);
	}
}
```

As you can see the code sample uses the GroupDocs.Metadata search engine to retrieve all properties that are not marked with the BuiltIn tag. Since we call the [FindProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/metadatapackage/methods/findproperties) method for a certain metadata package (instance of the [PdfPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/pdfpackage) class), the search result will contain only metadata properties that are specific for PDF documents. 

## Inspecting PDF documents

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about digital signatures associated with a document, extract form fields, attachments, bookmarks, etc. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PDF document
2.  Extract the root metadata package
3.  Use the [InspectionPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/pdfrootpackage/properties/inspectionpackage) property to inspect the document

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfReadInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.SignedPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();
	if (root.InspectionPackage.Annotations != null)
	{
		foreach (var annotation in root.InspectionPackage.Annotations)
		{
			Console.WriteLine(annotation.Name);
			Console.WriteLine(annotation.Text);
			Console.WriteLine(annotation.PageNumber);
		}
	}

	if (root.InspectionPackage.Attachments != null)
	{
		foreach (var attachment in root.InspectionPackage.Attachments)
		{
			Console.WriteLine(attachment.Name);
			Console.WriteLine(attachment.MimeType);
			Console.WriteLine(attachment.Description);
		}
	}

	if (root.InspectionPackage.Bookmarks != null)
	{
		foreach (var bookmark in root.InspectionPackage.Bookmarks)
		{
			Console.WriteLine(bookmark.Title);
		}
	}

	if (root.InspectionPackage.DigitalSignatures != null)
	{
		foreach (var signature in root.InspectionPackage.DigitalSignatures)
		{
			Console.WriteLine(signature.CertificateSubject);
			Console.WriteLine(signature.Comments);
			Console.WriteLine(signature.SignTime);

			// ...
		}
	}

	if (root.InspectionPackage.Fields != null)
	{
		foreach (var field in root.InspectionPackage.Fields)
		{
			Console.WriteLine(field.Name);
			Console.WriteLine(field.Value);

			// ...
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a PDF document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfReadDocumentStatistics**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();

	Console.WriteLine(root.DocumentStatistics.CharacterCount);
	Console.WriteLine(root.DocumentStatistics.PageCount);
	Console.WriteLine(root.DocumentStatistics.WordCount);
}
```

## Updating built-In metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a PDF document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfUpdateBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();

	root.DocumentProperties.Author = "test author";
	root.DocumentProperties.CreatedDate = DateTime.Now;
	root.DocumentProperties.Title = "test title";
	root.DocumentProperties.Keywords = "metadata, built-in, update";

	// ... 

	metadata.Save(Constants.OutputPdf);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a PDF document. Please check the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfUpdateCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();

	root.DocumentProperties.Set("customProperty1", "some value");

	metadata.Save(Constants.OutputPdf);
}
```

## Updating inspection properties

When you inspect a document GroupDocs.Metadata for .NET forms a metadata package containing the extracted information. The package class also provides some basic methods that allow removing the extracted properties. The following code sample demonstrates how to remove the inspection properties from a PDF document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Pdf.<WBR>PdfUpdateInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.SignedPdf))
{
	var root = metadata.GetRootPackage<PdfRootPackage>();

	root.InspectionPackage.ClearAnnotations();
	root.InspectionPackage.ClearAttachments();
	root.InspectionPackage.ClearFields();
	root.InspectionPackage.ClearBookmarks();
	root.InspectionPackage.ClearDigitalSignatures();

	metadata.Save(Constants.OutputPdf);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with OpenType fonts

Path: /metadata/java/working-with-opentype-fonts/

OpenType is a format for scalable computer fonts. It was built on its predecessor TrueType, retaining TrueType's basic structure and adding many intricate data structures for prescribing typographic behavior.

{{< alert style="info" >}}Please find more information on the OpenType format here: https://en.wikipedia.org/wiki/OpenType.{{< /alert >}}

## Reading OpenType metadata

The GroupDocs.Metadata API supports extracting format-specific information from OpenType font files.

The following are the steps to read the header of an OpenType file.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an OpenType font file
2.  Get the root metadata package
3.  Extract  the native metadata package using the [OpenTypeRootPackage.getOpenTypePackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/OpenTypeRootPackage#getOpenTypePackage()) method
4.  Read the OpenType font properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>font.OpenTypeReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputTtf)) {
	OpenTypeRootPackage root = metadata.getRootPackageGeneric();

	// Read the OpenType font metadata
	for (OpenTypeFont metadataEntry : root.getOpenTypePackage().getFonts()) {
		// Display the values of some metadata properties
		System.out.println(metadataEntry.getCreated());
		System.out.println(metadataEntry.getDirectionHint());
		System.out.println(metadataEntry.getEmbeddingLicensingRights());
		System.out.println(metadataEntry.getFlags());
		System.out.println(metadataEntry.getFontFamilyName());
		System.out.println(metadataEntry.getFontRevision());
		System.out.println(metadataEntry.getFontSubfamilyName());
		System.out.println(metadataEntry.getFullFontName());
		System.out.println(metadataEntry.getGlyphBounds());
		System.out.println(metadataEntry.getMajorVersion());
		System.out.println(metadataEntry.getMinorVersion());
		System.out.println(metadataEntry.getModified());
		System.out.println(metadataEntry.getSfntVersion());
		System.out.println(metadataEntry.getStyle());
		System.out.println(metadataEntry.getTypographicFamily());
		System.out.println(metadataEntry.getTypographicSubfamily());
		System.out.println(metadataEntry.getWeight());
		System.out.println(metadataEntry.getWidth());

		for (OpenTypeBaseNameRecord nameRecord : metadataEntry.getNames()) {
			System.out.println(nameRecord.getNameID());
			System.out.println(nameRecord.getPlatform());
			System.out.println(nameRecord.getValue());
			if (nameRecord instanceof OpenTypeMacintoshNameRecord) {
				OpenTypeMacintoshNameRecord macintoshNameRecord = (OpenTypeMacintoshNameRecord) nameRecord;
				System.out.println(macintoshNameRecord.getEncoding());
				System.out.println(macintoshNameRecord.getLanguage());
			} else {
				if (nameRecord instanceof OpenTypeUnicodeNameRecord) {
					OpenTypeUnicodeNameRecord unicodeNameRecord = (OpenTypeUnicodeNameRecord) nameRecord;
					System.out.println(unicodeNameRecord.getEncoding());
				} else {
					if (nameRecord instanceof OpenTypeWindowsNameRecord) {
						OpenTypeWindowsNameRecord windowsNameRecord = (OpenTypeWindowsNameRecord) nameRecord;
						System.out.println(windowsNameRecord.getEncoding());
						System.out.println(windowsNameRecord.getLanguage());
					}
				}
			}
		}
	}
}
```

## Reading digital signatures

The code snippet bellow demonstrates how to extract information about digital signatures associated with an OpenType font.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) an OpenType font file
2.  Get the root metadata package
3.  Use the [getDigitalSignaturePackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/OpenTypeRootPackage#getDigitalSignaturePackage()) method to get access to all digital signatures associated with the file

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>font.OpenTypeReadDigitalSignatureProperties**

```csharp
public static void run() {
    try (Metadata metadata = new Metadata(Constants.InputTtf)) {
        OpenTypeRootPackage root = metadata.getRootPackageGeneric();

        if (root.getDigitalSignaturePackage() != null) {
            System.out.println(root.getDigitalSignaturePackage().getFlags());
            for (Cms signature : root.getDigitalSignaturePackage().getSignatures()) {
                System.out.println(signature.getSignTime());

                if (signature.getDigestAlgorithms() != null) {
                    for (Oid signatureDigestAlgorithm : signature.getDigestAlgorithms()) {
                        printOid(signatureDigestAlgorithm);
                    }
                }

                if (signature.getEncapsulatedContent() != null) {
                    printOid(signature.getEncapsulatedContent().getContentType());
                    System.out.println(signature.getEncapsulatedContent().getContentRawData().length);
                }

                if (signature.getCertificates() != null) {
                    for (CmsCertificate certificate : signature.getCertificates()) {
                        System.out.println(certificate.getNotAfter());
                        System.out.println(certificate.getNotBefore());
                        System.out.println(certificate.getRawData().length);
                    }
                }

                if (signature.getSigners() != null) {
                    for (CmsSigner signerInfoEntry : signature.getSigners()) {
                        System.out.println(signerInfoEntry.getSignatureValue());
                        printOid(signerInfoEntry.getDigestAlgorithm());
                        printOid(signerInfoEntry.getSignatureAlgorithm());
                        System.out.println(signerInfoEntry.getSigningTime());
                        printAttributes(signerInfoEntry.getSignedAttributes());
                        printAttributes(signerInfoEntry.getUnsignedAttributes());
                    }
                }
            }
        }
    }
}

private static void printOid(Oid oid) {
    // Display the property name and value of OID
    if (oid != null) {
        System.out.println(oid.getFriendlyName());
        System.out.println(oid.getValue());
    }
}

private static void printAttributes(CmsAttribute[] attributes) {
    //Display the CmsAttributes of an OID
    if (attributes != null) {
        for (CmsAttribute attribute : attributes) {
            printOid(attribute.getOid());
            System.out.println(attribute.getValue());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with saved Emails

Path: /metadata/net/working-with-saved-emails/

GroupDocs.Metadata for .NET provides functionality that allows handling the most popular email message formats: EML and MSG. The following are some commonly used scenarios of working with the message content and metadata.

## Reading EML message metadata

The EML message format is used by many email clients including Novell GroupWise, Microsoft Outlook Express, Lotus notes, Windows Mail, Mozilla Thunderbird, and Postbox. The files contain the email contents as plain text in MIME format, containing the email header and body, including attachments in one or more of several formats. The code sample below demonstrates how to extract metadata from an EML message.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Email.EmlReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputEml))
{
	var root = metadata.GetRootPackage<EmlRootPackage>();

	Console.WriteLine(root.EmailPackage.Sender);
	Console.WriteLine(root.EmailPackage.Subject);

	foreach (string recipient in root.EmailPackage.Recipients)
	{
		Console.WriteLine(recipient);
	}

	foreach (var attachedFileName in root.EmailPackage.AttachedFileNames)
	{
		Console.WriteLine(attachedFileName);
	}

	foreach (var header in root.EmailPackage.Headers)
	{
		Console.WriteLine("{0} = {1}", header.Name, header.Value);
	}

	// ...
}
```

## Reading MSG metadata

MSG files are usually created by the Microsoft Outlook email client. The MSG format is used to represent individual email messages, appointments, contacts, tasks, and so on in the file system. The following code snippet shows how to read most common properties of an email message stored as an MSG file.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Email.MsgReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputMsg))
{
	var root = metadata.GetRootPackage<MsgRootPackage>();

	Console.WriteLine(root.EmailPackage.Sender);
	Console.WriteLine(root.EmailPackage.Subject);

	foreach (string recipient in root.EmailPackage.Recipients)
	{
		Console.WriteLine(recipient);
	}

	foreach (var attachedFileName in root.EmailPackage.AttachedFileNames)
	{
		Console.WriteLine(attachedFileName);
	}

	foreach (var header in root.EmailPackage.Headers)
	{
		Console.WriteLine("{0} = {1}", header.Name, header.Value);
	}

	Console.WriteLine(root.EmailPackage.Body);
	Console.WriteLine(root.EmailPackage.DeliveryTime);

	// ...
}
```

## Removing email attachments

Both root package classes representing metadata in email messages ([EmlRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.email/emlrootpackage) and [MsgRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.email/msgrootpackage)) have the common ancestor which is the [EmailRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.email/emailrootpackage) class. Since the MSG and EML formats have really similar functionality, in most cases, you don't need to know the exact type of a loaded message. It is possible to refer to the [EmailRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.email/emailrootpackage) class to access all basic features related to email messages. The following code sample shows how to remove all email message attachments using an instance of the [EmailRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.email/emailrootpackage) class.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Email.EmailRemoveAttachments**

```csharp
using (Metadata metadata = new Metadata(Constants.InputEml))
{
	var root = metadata.GetRootPackage<EmailRootPackage>();

	root.ClearAttachments();

	metadata.Save(Constants.OutputEml);
}
```

## Updating email fields

GroupDocs.Metadata for .NET also allows the user to update some common email fields. The code sample below demonstrates how to alter the email subject and recipients.

**AdvancedUsage.ManagingMetadataForSpecificFormats.Email.EmailUpdateEmailFields**

```csharp
using (Metadata metadata = new Metadata(Constants.InputEml))
{
    var root = metadata.GetRootPackage<EmailRootPackage>();
    root.EmailPackage.Recipients = new string[] { "sample@aspose.com" };
    root.EmailPackage.CarbonCopyRecipients = new string[] { "sample@groupdocs.com" };
    root.EmailPackage.Subject = "RE: test subject";
    metadata.Save(Constants.OutputEml);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Xml to Md

Path: /markdown/net/convert/export-text/


Use GroupDocs.Markdown to convert TXT, XML, and other text-based formats to clean Markdown.

### Using static method

The simplest way to convert a text file:

{{< tabs "export-text-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Set license (optional)
if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

// Convert XML to Markdown string
string markdown = MarkdownConverter.ToMarkdown("llms-tech.xml");

// Or save directly to a file
MarkdownConverter.ToFile("llms-tech.xml", "export-text-static.md");
```
{{< /tab >}}
{{< tab "llms-tech.xml" >}}  
{{< tab-text >}}
`llms-tech.xml` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/llms-tech.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-text-static.md" >}}  
```text
Attention-based neural architecture that underpins most modern large language models.

2017

Attention Is All You Need


Language modeling

Machine translation
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-text/ExportTextStatic/export-text-static.md)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-text-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");

using var converter = new MarkdownConverter("llms-tech.xml");
var options = new ConvertOptions
{
    HeadingLevelOffset = 1
};

converter.Convert("export-text-instance.md", options);
```
{{< /tab >}}
{{< tab "llms-tech.xml" >}}  
{{< tab-text >}}
`llms-tech.xml` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/basic-usage/convert/llms-tech.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-text-instance.md" >}}  
```text
Attention-based neural architecture that underpins most modern large language models.

2017

Attention Is All You Need


Language modeling

Machine translation
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/basic-usage/convert/export-text/ExportTextInstance/export-text-instance.md)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/net/getting-started/supported-document-formats" >}}).

---

## Xml to Md

Path: /markdown/python-net/convert/export-text/


Use GroupDocs.Markdown to convert TXT, XML, and other text-based formats to clean Markdown.

### Using static method

The simplest way to convert a text file:

{{< tabs "export-text-static">}}
{{< tab "export_text_to_markdown.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter

def export_text_to_markdown():
    """Convert an XML/text file to Markdown using the static one-liner API."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Convert XML to a Markdown string in one call
    markdown = MarkdownConverter.to_markdown("llms-tech.xml")

    # Step 3: Or save the conversion result directly to a file
    MarkdownConverter.to_file("llms-tech.xml", "export-text.md")

if __name__ == "__main__":
    export_text_to_markdown()
```
{{< /tab >}}
{{< tab "llms-tech.xml" >}}  
{{< tab-text >}}
`llms-tech.xml` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/llms-tech.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-text.txt" >}}  
```text
`<Technologies>`

`<Category name="Model Architectures">`

`<Technology>`

`<Name>Transformer</Name>`

`<Description>Attention-based neural architecture used by most modern LLMs.</Description>`

...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-text/export_text_to_markdown/export-text.txt)
{{< /tab >}}
{{< tab "export-text.txt" >}}  
```text
`<Technologies>`

`<Category name="Model Architectures">`

`<Technology>`

`<Name>Transformer</Name>`

`<Description>Attention-based neural architecture used by most modern LLMs.</Description>`

[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-text/export_text_to_markdown/export-text.txt)
{{< /tab >}}
{{< /tabs >}}

### Using instance API with options

For more control, use the instance API:

{{< tabs "export-text-instance">}}
{{< tab "export_text_with_options.py" >}}  
```python
import os
from groupdocs.markdown import License, MarkdownConverter, ConvertOptions

def export_text_with_options():
    """Convert an XML/text file to Markdown using the instance API with heading offset."""

    # Step 1: Apply the license (optional for evaluation)
    if os.path.exists("GroupDocs.Markdown.lic"):
        License.set_("GroupDocs.Markdown.lic")

    # Step 2: Open the text file with a context manager
    with MarkdownConverter("llms-tech.xml") as converter:
        # Step 3: Configure conversion options
        options = ConvertOptions()
        options.heading_level_offset = 1  # shift all headings down one level

        # Step 

        # Step 4: Convert and save the Markdown output
        converter.convert("export-text-options.md", convert_options=options)

if __name__ == "__main__":
    export_text_with_options()
```
{{< /tab >}}
{{< tab "llms-tech.xml" >}}  
{{< tab-text >}}
`llms-tech.xml` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/basic-usage/convert/llms-tech.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "export-text-options.txt" >}}  
```text
`<Technologies>`

`<Category name="Model Architectures">`

`<Technology>`

`<Name>Transformer</Name>`

`<Description>Attention-based neural architecture used by most modern LLMs.</Description>`

...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-text/export_text_with_options/export-text-options.txt)
{{< /tab >}}
{{< tab "export-text-options.txt" >}}  
```text
`<Technologies>`

`<Category name="Model Architectures">`

`<Technology>`

`<Name>Transformer</Name>`

`<Description>Attention-based neural architecture used by most modern LLMs.</Description>`

[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/basic-usage/convert/export-text/export_text_with_options/export-text-options.txt)
{{< /tab >}}
{{< /tabs >}}

For the full list of input formats, see the [supported formats page]({{< ref "markdown/python-net/getting-started/supported-document-formats" >}}).

---

## Verify Digital Signatures in Document

Path: /signature/python-net/verify-digital-signatures-in-the-document/

# Verify Digital Signatures in Document

[GroupDocs.Signature](https://products.groupdocs.com/signature/python-net) provides the ability to verify digital signatures in documents. Digital signatures provide a secure way to verify the authenticity and integrity of documents.

## What is a Digital Signature?

A digital signature is a mathematical scheme for demonstrating the authenticity of digital messages or documents. It provides:
- Authentication: Confirms the identity of the signer
- Integrity: Ensures the document hasn't been modified
- Non-repudiation: Prevents the signer from denying they signed the document

## How to Verify Digital Signatures

The [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class provides the [Verify](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/verify/) method which allows you to verify digital signatures in documents. Here's how to use it:

1. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class and pass the source document path as a parameter.
2. Instantiate the [DigitalVerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalverifyoptions/) object with the required options.
3. Call the [Verify](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/verify/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class instance and pass the [DigitalVerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalverifyoptions/) to it.
4. Process the verification results.

Here's an example of how to verify digital signatures in a document:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import DigitalVerifyOptions
from groupdocs.signature.domain import DigitalSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create verification options
    options = DigitalVerifyOptions()
    
    # Verify document signatures
    result = signature.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
        print(f"Document contains {len(result.succeeded)} valid signatures")
        
        # Process verified signatures
        for digital_signature in result.succeeded:
            print(f"Signature found on page {digital_signature.page_number}")
            print(f"Signature time: {digital_signature.signed_on}")
            print(f"Signature is valid: {digital_signature.is_valid}")
    else:
        print("Document verification failed!")
        print(f"Document contains {len(result.failed)} invalid signatures")
```

## Advanced Usage

The [DigitalVerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalverifyoptions/) class provides various properties to customize the verification process:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import DigitalVerifyOptions
from groupdocs.signature.domain import DigitalSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create verification options
    options = DigitalVerifyOptions()
    
    # Specify pages to verify
    options.pages = [1, 2]  # Verify only pages 1 and 2
    
    # Verify document signatures
    result = signature.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
        print(f"Document contains {len(result.succeeded)} valid signatures")
        
        # Process verified signatures
        for digital_signature in result.succeeded:
            print(f"Signature found on page {digital_signature.page_number}")
            print(f"Signature time: {digital_signature.signed_on}")
            print(f"Signature is valid: {digital_signature.is_valid}")
            print(f"Signature type: {digital_signature.signature_type}")
            print(f"Signature provider: {digital_signature.provider_name}")
    else:
        print("Document verification failed!")
        print(f"Document contains {len(result.failed)} invalid signatures")
```

## Additional Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our examples:

* [GroupDocs.Signature for Python via .NET Examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)
* [GroupDocs.Signature for Python via .NET Plugins](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Plugins)
* [GroupDocs.Signature for Python via .NET Showcase Apps](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Showcase)

### Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to verify digital signatures in documents with our free online apps:

* [Verify Digital Signatures Online](https://products.groupdocs.app/signature/verify)

---

## Verify for multiple signatures

Path: /signature/net/verify-for-multiple-signatures/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) supports verification of documents for different signature types. This approach requires to add all required verification options to list.

Here are the steps to verify document for multiple signatures with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required several [VerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/verifyoptions) objects ([BarcodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodeverifyoptions), [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodeverifyoptions), [DigitalVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalverifyoptions), [TextVerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textverifyoptions)) and add instances to List<[VerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/verifyoptions)\> collection.
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass filled list of List<[VerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/verifyoptions)\> to it.

This example shows how to search for different signature types in the document.

```csharp
using (Signature signature = new Signature("sampleSigned.pdf"))
{
    TextVerifyOptions textVerifyOptions = new TextVerifyOptions()
    {
        AllPages = true, // this value is set by default
        SignatureImplementation = TextSignatureImplementation.Stamp,
        Text = "John",
        MatchType = TextMatchType.Contains
    };
    BarcodeVerifyOptions barcVerifyOptions = new BarcodeVerifyOptions()
    {
        AllPages = true, // this value is set by default
        Text = "John",
        MatchType = TextMatchType.Contains
    };
    QrCodeVerifyOptions qrcdVerifyOptions = new QrCodeVerifyOptions()
    {
        AllPages = true, // this value is set by default
        Text = "John",
        MatchType = TextMatchType.Contains
    };
    DigitalVerifyOptions digtVerifyOptions = new DigitalVerifyOptions("certificate.pdf")
    {
        Comments = "Test comment"
    };
    // verify document signatures
    List<VerifyOptions> listOptions = new List<VerifyOptions>();
    listOptions.Add(textVerifyOptions);
    listOptions.Add(barcVerifyOptions);
    listOptions.Add(qrcdVerifyOptions);
    listOptions.Add(digtVerifyOptions);
    VerificationResult result = signature.Verify(listOptions);
    if (result.IsValid)
    {
        Console.WriteLine("\nDocument was verified successfully!");
    }
    else
    {
        Console.WriteLine("\nDocument failed verification process.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify for multiple signatures

Path: /signature/nodejs-java/verify-for-multiple-signatures/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) supports verification of documents for different signature types. This approach requires adding all required verification options to a list.

Here are the steps to verify a document for multiple signatures with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path or stream as a constructor parameter.
* Instantiate the required several [VerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/verifyoptions) objects ([BarcodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/barcodeverifyoptions), [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodeverifyoptions), [DigitalVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/digitalverifyoptions), [TextVerifyOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textverifyoptions)) and add instances to a list of `List<VerifyOptions>`.
* Call the [Verify](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/verify) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the filled list of `List<VerifyOptions>` to it.

This example shows how to search for different signature types in the document.

```csharp
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; // Assuming Constants.SAMPLE_SIGNED_MULTI is defined elsewhere

  // Initialize Signature instance
  const signature = new signatureLib.Signature(filePath);

  // Initialize TextVerifyOptions
  const textVerifyOptions = new signatureLib.TextVerifyOptions();
  textVerifyOptions.setAllPages(true); // this value is set by default
  textVerifyOptions.setText('Text signature');
  textVerifyOptions.setSignatureImplementation(signatureLib.TextSignatureImplementation.Native);
  textVerifyOptions.setMatchType(signatureLib.TextMatchType.Contains);

  // Initialize BarcodeVerifyOptions
  const barcVerifyOptions = new signatureLib.BarcodeVerifyOptions();
  barcVerifyOptions.setAllPages(true); // this value is set by default
  barcVerifyOptions.setText('12345');
  barcVerifyOptions.setMatchType(signatureLib.TextMatchType.Contains);

  // Initialize QrCodeVerifyOptions
  const qrcdVerifyOptions = new signatureLib.QrCodeVerifyOptions();
  qrcdVerifyOptions.setAllPages(true); // this value is set by default
  qrcdVerifyOptions.setText('John');
  qrcdVerifyOptions.setMatchType(signatureLib.TextMatchType.Contains);

  // Initialize DigitalVerifyOptions
  const digtVerifyOptions = new signatureLib.DigitalVerifyOptions();
  digtVerifyOptions.setPassword('1234567890');

  // Verify document signatures
  const javaArray = java.newInstanceSync("java.util.ArrayList")
  javaArray.add(textVerifyOptions);
  javaArray.add(barcVerifyOptions);
  javaArray.add(qrcdVerifyOptions);
  javaArray.add(digtVerifyOptions);
  const result = signature.verify(javaArray);

  if (result.isValid()) {
    console.log('\nDocument was verified successfully!');
  } else {
    console.log('\nDocument failed the verification process.');
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET 
examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify for multiple signatures

Path: /signature/python-net/verify-for-multiple-signatures/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) supports verification of documents for different signature types. This approach requires to add all required verification options to list.

Here are the steps to verify document for multiple signatures with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Instantiate required several [VerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/verifyoptions) objects ([BarcodeVerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodeverifyoptions), [QrCodeVerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodeverifyoptions), [DigitalVerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalverifyoptions), [TextVerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textverifyoptions)) and add instances to list of [VerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/verifyoptions).
* Call [Verify](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass filled list of [VerifyOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/verifyoptions) to it.

This example shows how to search for different signature types in the document.

```python
import groupdocs.signature as signature
from groupdocs.signature.options import (
    TextVerifyOptions,
    BarcodeVerifyOptions,
    QrCodeVerifyOptions,
    DigitalVerifyOptions
)
from groupdocs.signature.domain.enums import TextMatchType, TextSignatureImplementation

# Initialize signature
with signature.Signature("sampleSigned.pdf") as sign:
    # Create text verification options
    text_verify_options = TextVerifyOptions()
    text_verify_options.all_pages = True  # this value is set by default
    text_verify_options.signature_implementation = TextSignatureImplementation.STAMP
    text_verify_options.text = "John"
    text_verify_options.match_type = TextMatchType.CONTAINS

    # Create barcode verification options
    barcode_verify_options = BarcodeVerifyOptions()
    barcode_verify_options.all_pages = True  # this value is set by default
    barcode_verify_options.text = "John"
    barcode_verify_options.match_type = TextMatchType.CONTAINS

    # Create QR code verification options
    qrcode_verify_options = QrCodeVerifyOptions()
    qrcode_verify_options.all_pages = True  # this value is set by default
    qrcode_verify_options.text = "John"
    qrcode_verify_options.match_type = TextMatchType.CONTAINS

    # Create digital verification options
    digital_verify_options = DigitalVerifyOptions("certificate.pdf")
    digital_verify_options.comments = "Test comment"

    # Create list of verification options
    verify_options = [
        text_verify_options,
        barcode_verify_options,
        qrcode_verify_options,
        digital_verify_options
    ]

    # Verify document signatures
    result = sign.verify(verify_options)
    
    if result.is_valid:
        print("\nDocument was verified successfully!")
    else:
        print("\nDocument failed verification process.")
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Verify for multiple signatures

Path: /signature/java/verify-for-multiple-signatures/

**[GroupDocs.Signature](https://products.groupdocs.com/signature/java)** supports verification of documents for different signature types. This approach requires to add all required verification options to list.

Here are the steps to verify document for multiple signatures with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate required several [VerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/VerifyOptions) objects ([BarcodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/BarcodeVerifyOptions), [QrCodeVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/QrCodeVerifyOptions), [DigitalVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/DigitalVerifyOptions), [TextVerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/TextVerifyOptions)) and add instances to List<[VerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/VerifyOptions)\> collection.
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(java.util.List)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass filled list of List<[VerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/VerifyOptions)\> to it.   


This example shows how to search for different signature types in the document.

```java
Signature signature = new Signature("sampleSigned.pdf");
TextVerifyOptions textVerifyOptions = new TextVerifyOptions();
textVerifyOptions.setAllPages(true); // this value is set by default
textVerifyOptions.setText("John");
textVerifyOptions.setSignatureImplementation(TextSignatureImplementation.Stamp);
textVerifyOptions.setMatchType(TextMatchType.Contains);
 
BarcodeVerifyOptions barcVerifyOptions = new BarcodeVerifyOptions();
barcVerifyOptions.setAllPages(true); // this value is set by default
barcVerifyOptions.setText("John");
barcVerifyOptions.setMatchType(TextMatchType.Contains);
 
QrCodeVerifyOptions qrcdVerifyOptions = new QrCodeVerifyOptions();
qrcdVerifyOptions.setAllPages(true); // this value is set by default
qrcdVerifyOptions.setText("John");
qrcdVerifyOptions.setMatchType(TextMatchType.Contains);
 
DigitalVerifyOptions digtVerifyOptions = new DigitalVerifyOptions();
digtVerifyOptions.setComments("Test comment"); // this value is set by default
 
// verify document signatures
List<VerifyOptions> listOptions = new ArrayList<VerifyOptions>();
listOptions.add(textVerifyOptions);
listOptions.add(barcVerifyOptions);
listOptions.add(qrcdVerifyOptions);
listOptions.add(digtVerifyOptions);
 
// verify signatures in document
VerificationResult result = signature.verify(listOptions);
if (result.isValid())
{
    System.out.print("\nDocument was verified successfully!");
}
else
{
    System.out.print("\nDocument failed verification process.");
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Verify QR Code Signatures in Document

Path: /signature/python-net/verify-qr-code-signatures-in-the-document/


[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides functionality to verify QR code signatures in documents. This guide demonstrates how to verify QR code signatures using Python.

## Basic Usage Example

Here's a simple example showing how to verify QR code signatures in a document:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeVerifyOptions
import groupdocs.signature.domain as gsd
# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create verification options
    options = QrCodeVerifyOptions()
    options.text = "https://www.example.com"
    options.match_type = gsd.TextMatchType.Contains
    options.all_pages = True  # verify on all pages
    
    # Verify signatures
    result = sign.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
    else:
        print("Document failed verification process.")
```

## Advanced Usage Example

Here's an example showing more advanced verification options:

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeVerifyOptions

# Initialize signature
with signature.Signature("sample_signed.pdf") as sign:
    # Create verification options with advanced settings
    options = QrCodeVerifyOptions()
    options.text = "https://www.example.com"
    options.match_type = signature.TextMatchType.Exact  # require exact match
    options.qr_code_type = signature.QrCodeType.QR  # specify QR code type
    options.all_pages = False  # verify only on specific pages
    options.page_numbers = [1, 2]  # verify on pages 1 and 2
    
    # Verify signatures
    result = sign.verify(options)
    
    if result.is_valid:
        print("Document was verified successfully!")
        # Print verification details
        for signature in result.succeeded:
            print(f"Found valid QR code: {signature.text}")
    else:
        print("Document failed verification process.")
        # Print failed verification details
        for signature in result.failed:
            print(f"Invalid QR code: {signature.text}")
```

## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To verify PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Load document from URL

Path: /signature/java/load-document-from-url/

Following example demonstrates how to work with documents from URL.

```java
String url = "https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET/blob/master/Examples/Resources/SampleFiles/sample.pdf?raw=true";
 
InputStream stream = new URL(url).openStream();
Signature signature = new Signature(stream);
 
TextSignOptions options = new TextSignOptions("John Smith");
 
// set signature position
options.setLeft(100);
options.setTop(100);
 
// sign document to file
signature.sign("SampleSigned.pdf", options);
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Load document from URL

Path: /signature/net/load-document-from-url/

Following example demonstrates how to work with documents from URL.

```csharp
public static void Run()
{
    string url = "https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET/blob/api-v2/Examples/Resources/SampleFiles/sample.pdf?raw=true";


    using (Stream stream = GetRemoteFile(url))
    {
        using (Signature signature = new Signature(stream))
        {
            TextSignOptions options = new TextSignOptions("John Smith")
            {
                Left = 100,
                Top = 100
            };

            // sign document to file
            signature.Sign("SampleSigned", options);
        }
    }
    Console.WriteLine("\nSource document signed successfully.\nFile saved at " + outputFilePath);
}

private static Stream GetRemoteFile(string url)
{
    WebRequest request = WebRequest.Create(url);

    using (WebResponse response = request.GetResponse())
        return GetFileStream(response);
}

private static Stream GetFileStream(WebResponse response)
{
    MemoryStream fileStream = new MemoryStream();

    using (Stream responseStream = response.GetResponseStream())
        responseStream.CopyTo(fileStream);

    fileStream.Position = 0;
    return fileStream;
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign Document with QR Code Signature

Path: /signature/python-net/esign-document-with-qr-code-signature/

## What is a QR Code?

QR code (or Quick Response code) is a sort of two-dimensional [barcode]({{< ref "signature/python-net/developer-guide/basic-usage/electronic-signature-types/esign-document-with-barcode-signature.md" >}}) that consists of black squares arranged in a square grid on a white background. QR codes can be read by smartphone cameras or specialized devices that are dedicated to QR reading - hand-held scanners, handy terminals, desktop scanners, embedded scanners, and so on. Usually QR codes contain data that points to a website or application, emails, or phone numbers, product identifiers, or trackers. Therefore, the scope of QR code applications extends from general marketing and item identification to document management.

![QR code](/signature/python-net/images/esign-document-with-qr-code-signature.png)

## How to eSign Document with QR-Code Signature

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) can sign the documents with QR codes of the following types. 

| |Aztec code | DataMatrix code | GS1 DataMatrix | GS1 QR code | QR |
| --- | --- | --- | --- | --- | --- |
| **Application** | * transport and ticketing;<br> * in airline industry for electronic boarding passes;<br> * in rail for tickets sold online and printed out by customers or displayed on mobile phone screens. Code is scanned by a handheld scanner by on-train staff or at the turnstile to validate the ticket.<br> * medicine - patient identification wristbands and labels for unit-of-use medications etc. | * printed media such as labels and letters;<br> * industrial engineering purposes - marking components etc;<br>  * food industry - to prevent food products being packaged and dated incorrectly; | Used in<br> * Healthcare;<br> * Government;<br> * Industrial.<br> Encodes item additional information, such as:<br> * weight;<br> * expiration date;<br> * batch number;<br> * date of manufacture;<br> * etc.| Used in marketing to encode additional item information on the package | Widely used in automotive industry and mobile applications. Useful for encoding large amount of data characters and specific URLs.| 
| **Length** | 3067 alphanumeric,<br> 3832 numeric,<br> 1914 bytes | 2335 alphanumeric,<br> 3116 numeric | 2335 alphanumeric,<br> 3116 numeric,<br> 1556 bytes | 7089 alphanumeric,<br> 4296 numeric,<br> 2953 bytes | 4296 alphanumeric,<br> 7089 numeric,<br> 2953 bytes |
| **Example** | ![Aztec](/signature/python-net/images/esign-document-with-qr-code-signature_1.png) | ![DataMatrix](/signature/python-net/images/esign-document-with-qr-code-signature_2.png) | ![GS1 DataMatrix](/signature/python-net/images/esign-document-with-qr-code-signature_3.png) | ![GS1 QR code](/signature/python-net/images/esign-document-with-qr-code-signature_4.png) | ![QR](/signature/python-net/images/esign-document-with-qr-code-signature_5.png)

When adding QR code electronic signature to a document, the main settings are the text to be encoded and the [type of the QR code](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/qrcodetypes/#fields) which should be specified via the [QrCodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesignoptions) class.  

Here are the steps to eSign a document with the QR code signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.

* Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesignoptions) object according to your requirements and specify the [encode_type](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesignoptions/encode_type) and [text](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions/text) properties.
  
* Call the [sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [QrCodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesignoptions) to it.

The code snippet below demonstrates how to sign a PDF document with the QR code signature using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeSignOptions
from groupdocs.signature.domain import QrCodeTypes
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create QR code signature options
        options = QrCodeSignOptions()
        
        # Set QR code text
        options.text = "John Smith"
        
        # Set QR code type
        options.encode_type = QrCodeTypes.QR
        
        # Set QR code position
        options.left = 100
        options.top = 100
        
        # Set QR code size
        options.width = 100
        options.height = 100
        
        # Set QR code colors
        options.foreground_color = gsd.Color.BLUE
        options.background_color = gsd.Color.WHITE
        
        # Sign document
        sign.sign("./SampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-qr-code-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced QR Code Options

Here's an example showing how to create a more complex QR code signature with additional customization:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import QrCodeSignOptions
from groupdocs.signature.domain import QrCodeTypes
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create QR code options
        options = QrCodeSignOptions("https://www.example.com/verify-document")
        
        # Setup QR code encoding type
        options.encode_type = QrCodeTypes.QR
        
        # Set signature position and size
        options.left = 100
        options.top = 100
        options.width = 200
        options.height = 200
        
        # Set QR code appearance
        options.foreground_color = gsd.Color.BLUE
        options.background_color = gsd.Color.WHITE
        
        # Set QR code error correction level (L, M, Q, H)
        options.error_correction_level = gsd.QrCodeErrorCorrectionLevel.H
        
        # Sign document
        sign.sign("./SampleSigned.pdf", options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-qr-code-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide demonstrates how to add QR code signatures to documents using [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net). It includes steps for generating a QR code signature, configuring its properties like size and encoding, and applying it to a document. QR code signatures can be used for quick verification of the signed document.


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign document with QR-code signature

Path: /signature/java/esign-document-with-qr-code-signature/

## What is a QR-code?

QR-code (or Quick Response code) is a sort of two-dimensional [barcode]({{< ref "signature/java/developer-guide/basic-usage/electronic-signature-types/esign-document-with-barcode-signature.md" >}}) that consists of black squares arranged in a square grid on a white background. QR-code can be read by smartphone camera or specialized devices that are dedicated to QR reading - hand-held scanners, handy terminals, fixed scanners that are used after placing it on a desktop, or embedding it in other devices. Usually QR-codes contain data that points to a website or application, emails, or phone numbers, product identifiers, or trackers. Therefore QR-code application scope extends general marketing and item identification to document management.

![](/signature/java/images/esign-document-with-qr-code-signature.png)

## How to eSign document with QR-Code signature 

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) allows to eSign documents with QR-codes of various types that is listed in a table below. 

|   | Aztec code | DataMatrix code | GS1 DataMatrix  | GS1 QR code  | QR |
| --- | --- | --- | --- | --- | --- |
| **Application** | transport and ticketing;  in airline industry for electronic boarding passes;  in rail for tickets sold online and printed out by customers or displayed on mobile phone screens. Code is scanned by a handheld scanner by on-train staff or at the turnstile to validate the ticket.  medicine - patient identification wristbands and labels for unit-of-use medications etc. | printed media such as labels and letters;  industrial engineering purposes - marking components etc;  food industry - to prevent food products being packaged and dated incorrectly; | Used in Healthcare;  Government;  Industrial. Encodes item additional information, such as: weight; expiration date; batch number; date of manufacture; etc. | Used in marketing to encode additional item information  on the package | Widely used in automotive industry and mobile applications. Useful for encoding  large amount of data characters and specific URLs. |
| **Length** | 3067 alphanumeric,  3832 numeric,  1914 bytes | 2335 alphanumeric, 3116 numeric | 2335 alphanumeric 3116 numeric,  1556 bytes | 7089 alphanumeric 4296 numeric,  2953 bytes | 4296 alphanumeric,  
7089 numeric,  2953 bytes |
| **Example** | ![](/signature/java/images/Aztec.png) | ![](/signature/java/images/DataMatrix.png) | ![](/signature/java/images/GS1.png) | ![](/signature/java/images/GS1_QR.png) | ![](/signature/java/images/QrCode2.png)


While adding QR-code electronic signature to document [GroupDocs.Signature](https://products.groupdocs.com/signature/java) the main settings are text to be encoded and QR-code [type](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.qrcodes/QrCodeType#getTypeIndex()) which should be specified via [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) class. 

Here are the steps to eSign document with QR-code signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
*   Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) object according to your requirements and specify [EncodeType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions#setEncodeType(com.groupdocs.signature.domain.qrcodes.QrCodeType)) and [Text](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/TextSignOptions#setText(java.lang.String)) properties.
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) to it.
    

The code snippet below demonstrates how to sign PDF document with QR-code signature.

```java
Signature signature = new Signature("sample.pdf");
 
// create QRCode option with predefined QRCode text
QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");
 
// setup QRCode encoding type
options.setEncodeType(QrCodeTypes.QR);
 
// set signature position
options.setLeft(100);
options.setTop(100);
 
 
// sign document to file
signature.sign("SampleSigned.pdf", options);
```

More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Signatures of the certain types

Path: /signature/net/delete-signatures-of-the-certain-types/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides overloaded [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method that accepts list of the [SignatureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signaturetype) enumeration values.
Please be aware that this method modifies the same document that was passed to constructor of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.

Here are the steps to delete signature by certain types from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or its stream as a constructor parameter;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass list of the required [SignatureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signaturetype) enumerations to it.

This example shows how to delete various signatures types from the document at once.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    // compose the list of signature types to delete
    var signedTypes = new List<SignatureType>
    {
        SignatureType.Text, 
        SignatureType.Image,
        SignatureType.Barcode,
        SignatureType.QrCode,
        SignatureType.Digital
    };
    // deleting QR-Code signatures from the document by signature types
    DeleteResult result = signature.Delete(signedTypes);
    if (result.Succeeded.Count > 0)
    {
        Console.WriteLine("Following signatures were removed:");
        int number = 1;
        foreach (BaseSignature temp in result.Succeeded)
        {
            Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}. Created: {temp.CreatedOn.ToShortDateString()}");
        }
    }
    else
    {
        Helper.WriteError("No one signature was deleted.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Delete Signatures of the certain type

Path: /signature/net/delete-signatures-of-the-certain-type/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides overloaded [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method that accepts one [SignatureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signaturetype) or list of them.
Please be aware that this method modifies the same document that was passed to constructor of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class.
## How to delete signature by specific type from the document
Here are the steps to delete signature by specific type from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or its stream as a constructor parameter;
* Call [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method and pass certain [SignatureType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signaturetype) enumeration to it.

This example shows how to delete QR-Code signatures from the document.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    // Deleting QR-Code signatures from the document
    DeleteResult result = signature.Delete(SignatureType.QrCode);

    if (result.Succeeded.Count > 0)
    {
        Console.WriteLine("Following QR-Code signatures were deleted:");

        int number = 1;
        foreach (QrCodeSignature temp in result.Succeeded)
        {
            Console.WriteLine(
                $"Signature #{number++}: Type: {temp.SignatureType}, " +
                $"Id: {temp.SignatureId}, Text: {temp.Text}"
            );
        }
    }
    else
    {
        Console.WriteLine("No QR-Code signatures were deleted.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [Advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Delete Signatures of the certain type

Path: /signature/nodejs-java/delete-signatures-of-the-certain-type/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides overloaded [Delete](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/delete/) method that accepts one [SignatureType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/signaturetype/) or list of them.
Please be aware that this method modifies the same document that was passed to constructor of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class.
## How to delete signature by specific type from the document
Here are the steps to delete signature by specific type from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass source document path or its stream as a constructor parameter;
* Call [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#delete) method and pass certain [SignatureType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/signaturetype/) enumeration to it.

This example shows how to delete QR-Code signatures from the document.

```javascript
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 
  const fileName = path.basename(filePath);
  
  const outputDirectory = path.join(Constants.OutputPath, 'DeleteBySignatureType');
  if (!fs.existsSync(outputDirectory)) {
    fs.mkdirSync(outputDirectory, { recursive: true });
  }

  // Copy source file since the delete method works with the same Document
  const outputFilePath = path.join(outputDirectory, fileName);
  // fs.copyFileSync(filePath, outputFilePath);

  // Processing QR-Code signatures
  const signature = new signatureLib.Signature(filePath);
    
  // Deleting QR-Code signatures from the document
  const result = await signature.delete(outputFilePath, signatureLib.SignatureType.QrCode);
  if (result.getSucceeded().size() > 0) {
    console.log('Following QR-Code signatures were deleted:');
    let number = 1;
    result.getSucceeded().toArray().forEach((o) => {
      const temp = o;
      console.log(`Signature #${number++}: Type: ${temp.getSignatureType()}, Id: ${temp.getSignatureId()}, Text: ${temp.getText()}`);
    });
  } else {
    console.log('No QR-Code signatures were deleted.');
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Delete Signatures of the certain types

Path: /signature/java/delete-signatures-of-the-certain-types/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides overloaded [deleteByTypes](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#deleteByTypes(java.io.OutputStream,%20java.util.List)) method that accepts list of the [SignatureType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/SignatureType) enumeration values.
Please be aware that this method modifies the same document that was passed to constructor of the [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class.

Here are the steps to delete signature by certain types from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path or its stream as a constructor parameter;
* Call [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) object [deleteByTypes](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#deleteByTypes(java.io.OutputStream,%20java.util.List))  method and pass list of the required [SignatureType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/SignatureType) enumerations to it.

This example shows how to delete various signatures types from the document at once.

```java
Signature signature = new Signature(outputFilePath);
{
	// compose the list of signature types to delete
	List<Integer> signedTypes = new ArrayList<Integer>();
	signedTypes.add(SignatureType.Text);
	signedTypes.add(SignatureType.Image);
	signedTypes.add(SignatureType.Barcode);
	signedTypes.add(SignatureType.QrCode);
	signedTypes.add(SignatureType.Digital);

	// deleting signatures from the document by signature types
	DeleteResult result = signature.deleteByTypes(outputFilePath,signedTypes);
	if (result.getSucceeded().size() > 0)
	{
		System.out.print("Following signatures were removed:");
		int number = 1;
		for(BaseSignature temp : result.getSucceeded())
		{
			System.out.print("Signature #"+number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+". Created: "+temp.getCreatedOn());
		}
	}
	else
	{
		System.out.print("No one signature was deleted.");
	}
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [Advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Signatures of the certain type

Path: /signature/java/delete-signatures-of-the-certain-type/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides overloaded [delete](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#delete(java.lang.String,%20int)) method that accepts one [SignatureType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/SignatureType) or list of them.
Please be aware that this method modifies the same document that was passed to constructor of the [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class.

Here are the steps to delete signature by specific type from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path or its stream as a constructor parameter;
* Call [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) object [delete](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#delete(java.lang.String,%20int)) method and pass certain [SignatureType](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.enums/SignatureType) enumeration to it.

This example shows how to delete QR-Code signatures from the document.

```java
Signature signature = new Signature("signed.pdf");
{
	// deleting QR-Code signatures from the document
	DeleteResult result = signature.delete("signed_out.pdf", SignatureType.QrCode);
	if (result.getSucceeded().size() > 0)
	{
		System.out.print("Following QR-Code signatures were deleted:");
		int number = 1;
		for (BaseSignature temp : result.getSucceeded())
		{
			System.out.print("Signature #"+number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+", Text: "+((QrCodeSignature)temp).getText());
		}
	}
	else
	{
		System.out.print("No one QR-Code signature was deleted.");
	}
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [Advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Delete Digital signatures from documents

Path: /signature/python-net/delete-digital-signatures-from-documents/

## Overview
[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [DigitalSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/digitalsignature) class to manipulate digital signatures and delete them from the documents over [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method.  
Please be aware that [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method modifies the same document that was passed to constructor of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class.

*Important information*. Please be aware that digitally signed documents with valid certificates (pfx files) are secured and verified. Changing digitally signed document makes them untrusted from the digital verification perspective. At this moment only Pdf documents support deletion of the specific digital signatures in case of many ones were added. Most documents support deletion of all digital signatures at once without separate certificates removal. It's strongly recommened to use deletion of electronic digital signatures by signature type Digital. See example [Delete Signatures of the certain type]

## How to delete Digital signature from the document
Here are the steps to delete Digital signature from the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate [DigitalSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsearchoptions) object with desired properties;
* Call [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method to obtain list of [DigitalSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/digitalsignature);
* Select from list [DigitalSignature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.domain/digitalsignature) object(s) that should be removed from the document;
* Call [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) object [Delete](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/delete) method and pass one or several signatures to it.  

This example shows how to delete Digital signature that was found using [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method.

```python
import groupdocs.signature as signature
from groupdocs.signature.options import DigitalSearchOptions

# Initialize signature
with signature.Signature("signed.pdf") as sign:
    # Create search options
    options = DigitalSearchOptions()
    
    # Search for digital signatures in the document
    signatures = sign.search(options)
    
    if len(signatures) > 0:
        digital_signature = signatures[0]
        result = sign.delete(digital_signature)
        
        if result:
            print(
                f"Digital signature with certificate subject {digital_signature.certificate.subject} "
                f"was deleted from document ['{fileName}']."
            )
        else:
            print(
                f"Signature was not deleted from the document! "
                f"Digital signature with certificate subject {digital_signature.certificate.subject} "
                f"was not found!"
            )
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for built-in Metadata signatures

Path: /signature/java/search-for-built-in-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) class to specify different options to search for Metadata signatures.

Most document types such as Word Processing, Spreadsheet and Presentation contains built-in metadata properties. Using property [setIncludeBuiltinProperties](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions#setIncludeBuiltinProperties(boolean)) of [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) allows to collect all supported built-in metadata properties of document. These properties are like document author, creation date, document keywords, titles, etc.

Here are the steps to search for metadata signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) object according to your requirements and specify [setIncludeBuiltinProperties](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions#setIncludeBuiltinProperties(boolean)) to true 
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) to it.
    

This example shows how to get built in Metadata signatures.

```java
Signature signature = new Signature("sample.xlsx");
MetadataSearchOptions options = new MetadataSearchOptions();
options.setName("Producer");
options.setIncludeBuiltinProperties(true);
options.setNameMatchType(TextMatchType.Contains);
 
// search for signatures in document
List<MetadataSignature> signatures = signature.search(MetadataSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (MetadataSignature metadataSignature : signatures)
{
    System.out.print("Metadata signature found. Name : "+metadataSignature.getName()+". Value: "+ metadataSignature.getValue());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Advanced search for Image signatures

Path: /signature/net/advanced-search-for-image-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) class to specify different options to search for Image Signatures

* bool ReturnContent property allows to return in the image signature its content;
* long MinContentSize property with non zero value limits the minimum size of image to return;
* long MaxContentSize property with non zero value limits the maximum size of image to return;
* [FileType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/filetype) ReturnContentType property allows to specify exact image content type

Here are the steps to search for image signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions)  object according to your requirements and specify search options
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) to it.
* Analyze if needed list of returned list of [ImageSignatures](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/imagesignature)

This example shows how to make advanced search for Image signature in the document and further image signatures analyzes with saving image content

```csharp
using (Signature signature = new Signature("sampleSignaed.docx"))
{
    // setup search options
    ImageSearchOptions searchOptions = new ImageSearchOptions()
    {
        // enable grabbing image content feature
        ReturnContent = true,
        // set minimum size if needed
        MinContentSize = 0,
        // set maximum size if needed
        MaxContentSize = 0,
        // specify exact image type to be returned
        ReturnContentType = FileType.JPEG,
    };
    // search document
    List<ImageSignature> signatures = signature.Search<ImageSignature>(searchOptions);
    Console.WriteLine($"\nSource document ['{fileName}'] contains following image signature(s).");
    // output signatures
    foreach (ImageSignature imageSignature in signatures)
    {
        Console.Write($"Found Image signature at page {imageSignature.PageNumber} and size {imageSignature.Size}.");
        Console.WriteLine($"Location at {imageSignature.Left}-{imageSignature.Top}. Size is {imageSignature.Width}x{imageSignature.Height}.");
    }
    //Save signature images
    string outputPath = System.IO.Path.Combine(Constants.OutputPath, "SearchForImageAdvanced");
    if (!Directory.Exists(outputPath))
    {
        Directory.CreateDirectory(outputPath);
    }
    int i = 0;
    foreach (ImageSignature imageSignature in signatures)
    {
        Console.Write($"Found Image signature at page {imageSignature.PageNumber} and size {imageSignature.Size}.");
        Console.WriteLine($"Location at {imageSignature.Left}-{imageSignature.Top}. Size is {imageSignature.Width}x{imageSignature.Height}.");
        string outputFilePath = System.IO.Path.Combine(outputPath, $"image{i}{imageSignature.Format.Extension}");
        using (FileStream fs = new FileStream(outputFilePath, FileMode.Create))
        {
            fs.Write(imageSignature.Content, 0, imageSignature.Content.Length);
        }
        i++;
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for Digital e-Signatures

Path: /signature/python-net/search-for-digital-e-signatures/


[GroupDocs.Signature](https://products.groupdocs.com/signature/python-net) provides the ability to search for digital electronic signatures in documents. Digital signatures provide a way to verify the authenticity and integrity of a document by using cryptographic techniques.

## How to Search for Digital Signatures

The [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class provides the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method which allows you to search for digital signatures in documents. Here's how to use it:

1. Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class and pass the source document path as a parameter.
2. Create an instance of [DigitalSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsearchoptions/) class.
3. Call the [Search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/) class instance and pass the search options to it.
4. Process the search results.

Here's an example of how to search for digital signatures in a document:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import DigitalSearchOptions
from groupdocs.signature.domain import DigitalSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = DigitalSearchOptions()
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} digital signatures")
    for digital_signature in result:
        print(f"Subject: {digital_signature.subject}")
        print(f"Issuer: {digital_signature.issuer}")
        print(f"Valid From: {digital_signature.valid_from}")
        print(f"Valid To: {digital_signature.valid_to}")
```

## Advanced Search Options

You can customize the search process by setting specific options:

```python
from groupdocs.signature import Signature
from groupdocs.signature.options import DigitalSearchOptions
from groupdocs.signature.domain import DigitalSignature

# Initialize Signature with input document
with Signature("sample.pdf") as signature:
    # Create search options
    search_options = DigitalSearchOptions()
    
    # Set search criteria
    search_options.subject = "John Doe"  # Search for specific subject
    search_options.issuer = "Certificate Authority"  # Search for specific issuer
    
    # Search for signatures
    result = signature.search(search_options)
    
    # Process found signatures
    print(f"Found {len(result)} digital signatures")
    for digital_signature in result:
        print(f"Subject: {digital_signature.subject}")
        print(f"Issuer: {digital_signature.issuer}")
        print(f"Valid From: {digital_signature.valid_from}")
        print(f"Valid To: {digital_signature.valid_to}")
```

## Additional Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our examples:

* [GroupDocs.Signature for Python via .NET Examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)
* [GroupDocs.Signature for Python via .NET Plugins](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Plugins)
* [GroupDocs.Signature for Python via .NET Showcase Apps](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET-Showcase)

### Free Online Apps

Along with full Python library we provide simple but powerful free Apps.

You are welcome to search for digital signatures in documents with our free online apps:

* [Search for Digital Signatures Online](https://products.groupdocs.app/signature/search/family)

---

## Search for QR-Code e-signatures

Path: /signature/java/search-for-qr-code-e-signatures/


When you search for electronic signatures of QR-Code type inside document with [GroupDocs.Signature](https://products.groupdocs.com/signature/java) it's only needed to [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object to Search method.   
Here are the quick guide of how to search for QR-code signatures:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;
    
*   Instantiate the [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) object according to your requirements and specify search options;  
    
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) to it.
    

The code snippet below demonstrates search for QR-code signature in the document.

```java
Signature signature = new Signature("sample.pdf");
QrCodeSearchOptions options = new QrCodeSearchOptions();
options.setAllPages(true); // this value is set by default

// search for signatures in document
List<QrCodeSignature> signatures = signature.search(QrCodeSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (QrCodeSignature qrCodeSignature : signatures)
{
    System.out.print("QRCode signature found at page "+qrCodeSignature.getPageNumber() +" with type "+qrCodeSignature.getEncodeType() +" and text "+ qrCodeSignature.getText());
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for Text e-signatures

Path: /signature/net/search-for-text-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) class to specify different options to search for Text electronic signatures within document.

Here are the steps to search for Text e-signatures using GroupDocs.Signature API:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate the [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) object according to your requirements and specify additional search options (if needed);  
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature)  class instance and pass [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) to it.

This example shows how to search for Text e-signature in the document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // setup search options
    TextSearchOptions searchOptions = new TextSearchOptions()
    {
        // search only page with specified number
        PageNumber = null,
        // specify as true to search all pages of a document
        AllPages = true,
        // specify text to search
        Text = "JS_",
        // specify text math type
        MatchType = TextMatchType.Contains
    };
    // search document
    List<TextSignature> signatures = signature.Search<TextSignature>(searchOptions);
    // output signatures
    foreach (TextSignature textSignature in signatures)
    {
         Console.Write($"Found Text signature: {textSignature.SignatureImplementation} " +
                       $"with text {textSignature.Text}.");
         Console.WriteLine($"Location at {textSignature.Left}-{textSignature.Top}. " +
                           $"Size is {textSignature.Width}x{textSignature.Height}.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Search for Text e-signatures

Path: /signature/nodejs-java/search-for-text-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides [TextSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsearchoptions) class to specify different options to search for Text electronic signatures within document.

Here are the steps to search for Text e-signatures using GroupDocs.Signature API:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsearchoptions) object according to your requirements and specify additional search options (if needed).
* Call the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [TextSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsearchoptions) to it.

This example shows how to search for Text e-signature in the document.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 
  const fileName = path.basename(filePath);
  const signature = new signatureLib.Signature(filePath);

  // Setup search options
  const options = new signatureLib.TextSearchOptions();
  options.setAllPages(true);

  // Search for text signatures in the document
  const signatures = signature.search(signatureLib.TextSignature.class, options).toArray();
  console.log(`\nSource document ['${fileName}'] contains the following text signature(s).`);

  // Enumerate all signatures for output
  for (const textSignature of signatures) {
    console.log(`Found Text signature at page ${textSignature.getPageNumber()} with type [${textSignature.getSignatureImplementation()}] and text '${textSignature.getText()}'.`);
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Search for Text e-Signatures

Path: /signature/python-net/search-for-text-e-signatures/

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides the [TextSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsearchoptions) class to specify different options for searching Text electronic signatures within documents.

Here are the steps to search for Text e-signatures using GroupDocs.Signature API:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsearchoptions) object according to your requirements and specify additional search options (if needed).
* Call the [search](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/search) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [TextSearchOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsearchoptions) to it.

This example shows how to search for Text e-signatures in a document using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSearchOptions
from groupdocs.signature.domain import TextMatchType

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Setup search options
    search_options = TextSearchOptions()
    
    # Search only page with specified number (None for all pages)
    search_options.page_number = None
    
    # Specify as True to search all pages of a document
    search_options.all_pages = True
    
    # Specify text to search
    search_options.text = "JS_"
    
    # Specify text match type
    search_options.match_type = TextMatchType.CONTAINS
    
    # Search document
    signatures = sign.search(search_options)
    
    # Output signatures
    for text_signature in signatures:
        print(f"Found Text signature: {text_signature.signature_implementation} "
              f"with text {text_signature.text}.")
        print(f"Location at {text_signature.left}-{text_signature.top}. "
              f"Size is {text_signature.width}x{text_signature.height}.")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/search-for-electronic-signatures-in-document/search-for-text-e-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Search Options

Here's an example showing how to use more advanced search options:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSearchOptions
from groupdocs.signature.domain import TextMatchType

# Initialize signature
with signature.Signature("sample.pdf") as sign:
    # Setup search options
    search_options = TextSearchOptions()
    
    # Search on specific pages
    search_options.page_number = 1
    search_options.all_pages = False
    
    # Search for text with specific match type
    search_options.text = "John"
    search_options.match_type = TextMatchType.EXACT
    
    # Search with specific signature implementation
    search_options.signature_implementation = signature.TextSignatureImplementation.NATIVE
    
    # Search document
    signatures = sign.search(search_options)
    
    # Process found signatures
    for text_signature in signatures:
        print(f"Found Text signature: {text_signature.text}")
        print(f"Page number: {text_signature.page_number}")
        print(f"Position: X={text_signature.left}, Y={text_signature.top}")
        print(f"Size: {text_signature.width}x{text_signature.height}")
        print(f"Font: {text_signature.font.family_name}, Size: {text_signature.font.size}")
        print(f"Color: {text_signature.fore_color}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/search-for-electronic-signatures-in-document/search-for-text-e-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Add image annotation

Path: /annotation/java/add-image-annotation/

Image annotation allows you to add an image on document page as shown in the picture below:

![](/annotation/net/images/add-image-annotation.png)

You can set the following properties of the [ImageAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/) class:

*   [ImagePath](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/#setImagePath-java.lang.String-) defines the image local or remote path
*   [Box](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position on the page using the [Rectangle](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models/rectangle/) structure (image will be resized for specified width and height)
*   [Opacity](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity (present in all supported formats, examples of it you can see above)
*   [Angle](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/#setAngle-java.lang.Double-) defines the annotation rotation angle

To add an image annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class. Specify the input document path or stream.
2.   Instantiate the [ImageAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [ImageAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/) class.
4.   Call the [Save](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add [ImageAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/imageannotation/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
try(final Annotator annotator = new Annotator("input.pdf")){
	ImageAnnotation imageAnnotation = new ImageAnnotation();
	imageAnnotation.setBox(new Rectangle(100, 100, 100, 100));
	imageAnnotation.setOpacity(0.7);
	imageAnnotation.setPageNumber(0);
	imageAnnotation.setImagePath("www.google.com.ua/images/branding/googlelogo/2x/googlelogo_color_92x30dp.png");
	imageAnnotation.setAngle(100.);
	annotator.add(imageAnnotation);
	annotator.save("result_image_annotation.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add image annotation

Path: /annotation/net/add-image-annotation/

Image annotation allows you to add an image on document page as shown in the picture below:

![](/annotation/net/images/add-image-annotation.png)

You can set the following properties of the [ImageAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/imageannotation) class:

*   [ImagePath](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation/properties/imagepath) defines the image local or remote path
*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation/properties/box) defines the annotation position on the page using the [Rectangle](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models/rectangle) structure (image will be resized for specified width and height)
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation/properties/opacity) allows you to set the annotation opacity (present in all supported formats, examples of it you can see above)
*   [Angle]() defines the annotation rotation angle

To add an image annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [ImageAnnotation](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [ImageAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/imageannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add [ImageAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/imageannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
            {
                ImageAnnotation area = new ImageAnnotation
                {
                    Box = new Rectangle(100, 100, 100, 100),
                    Opacity = 0.7,
                    PageNumber = 0,
                    ImagePath = "www.google.com.ua/images/branding/googlelogo/2x/googlelogo_color_92x30dp.png",
                    Angle = 100
                };
                annotator.Add(area);
                annotator.Save("result.pdf");
            }
```
{{< /tab >}}
{{< /tabs >}}
---

## Bulleted List in Email Document

Path: /assembly/java/bulleted-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Email format.{{< /alert >}}

## Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show all the clients in a bulleted list format.

## Adding Syntax to be evaluated by GroupDocs.Assembly Engine

### Recipients, Cc and Subject

```java
<<foreach [r in recipients]>><<[r]>>; <</foreach>>
<<[cc]>>
<<[subject]>>
```

### Body

```java
We provide support for the following clients:
<<foreach [in getClients()]>>•	<<[getName()]>>
<</foreach>>
```

## Download Bulleted List Template

Please download the sample Bulleted List document we created in this article:

*   [Bulleted List.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

## Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist samicheemagroupdocs e61f2df361bc042a989380c1fdc20435 >}}



---

## Bulleted List in Email Document

Path: /assembly/net/bulleted-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Bulleted List report in Email format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Bulleted List in Email

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

#### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   A report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   A report must show all the products in a bulleted list format.

#### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

##### Recipients, Cc and Subject

```csharp
<<foreach [r in recipients]>><<[r]>>; <</foreach>>
<<[cc]>>
<<[subject]>>

```

##### Body

```csharp
We provide support for the following clients:
<<foreach[in products]>>  ∙  <<[ProductName]>>
<</foreach>>

```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

#### Download Bulleted List Template

Please download the sample Bulleted List document we used in this article:

*   [Bulleted List.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Bulleted%20List.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists fd6c17536da63fea2bb7f8923a798993 >}}



---

## Cancellation

Path: /conversion/net/cancellation/


[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) supports cancellation of long-running conversion operations using the standard .NET [CancellationToken](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtoken) mechanism. This is particularly useful when converting large or complex documents where you need to:

* Set a maximum time limit for the conversion operation
* Allow users to cancel an ongoing conversion
* Implement responsive applications that can abort conversions on demand

## Using CancellationToken with classic syntax

To cancel or timeout a conversion operation, follow these steps:

1. Create a [CancellationTokenSource](https://learn.microsoft.com/en-us/dotnet/api/system.threading.cancellationtokensource) instance.
2. Optionally, configure automatic cancellation after a specified time using the `CancelAfter` method.
3. Create an instance of the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class and pass the source document path as the constructor parameter.
4. Instantiate the appropriate [ConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions) class (e.g., [PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions), [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions), etc.).
5. Call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_3) method with the `CancellationToken` parameter.
6. Handle the `OperationCanceledException` to gracefully manage cancellation scenarios.

The following code snippet shows how to set a timeout for a conversion operation:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

using (Converter converter = new Converter("sample.dwg"))
{
    using (CancellationTokenSource cts = new CancellationTokenSource())
    {
        // Auto-cancel after 60 seconds
        cts.CancelAfter(TimeSpan.FromSeconds(60));

        try
        {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.Convert("converted.pdf", options, cts.Token);
        }
        catch (OperationCanceledException)
        {
            Console.WriteLine("Conversion was cancelled or timed out");
        }
    }
}
```

## Using CancellationToken with fluent syntax

You can also use [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}}) to perform cancellable conversions.

The following code snippet shows how to use CancellationToken with fluent syntax:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

using (CancellationTokenSource cts = new CancellationTokenSource())
{
    // Auto-cancel after 60 seconds
    cts.CancelAfter(TimeSpan.FromSeconds(60));

    try
    {
        FluentConverter
            .Load("sample.dwg")
            .ConvertTo("converted.pdf")
            .WithOptions(new PdfConvertOptions())
            .Convert(cts.Token);
    }
    catch (OperationCanceledException)
    {
        Console.WriteLine("Conversion was cancelled or timed out");
    }
}
```

## Manual cancellation

You can also trigger cancellation manually, for example, in response to a user action:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

CancellationTokenSource cts = new CancellationTokenSource();

// Start conversion in a background task
Task conversionTask = Task.Run(() =>
{
    using (Converter converter = new Converter("large-document.dwg"))
    {
        try
        {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.Convert("converted.pdf", options, cts.Token);
            Console.WriteLine("Conversion completed successfully");
        }
        catch (OperationCanceledException)
        {
            Console.WriteLine("Conversion was cancelled by user");
        }
    }
});

// Simulate user cancellation after 10 seconds
Thread.Sleep(TimeSpan.FromSeconds(10));
cts.Cancel();

await conversionTask;
cts.Dispose();
```

---

## Clear watermarks

Path: /watermark/net/basic-usage/clear/

Removing existing watermarks is another powerful feature of the GroupDocs.Watermark library. It allows searching and then removing text or image watermarks from a wide range of supported documents. Removing watermarks is possible for some of the supported formats. To learn whether it is available for your format, check [Supported formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}}).

{{< alert style="info" >}}Updating of watermarks is not allowed in evaluation mode. Please set up a license as described in [Licensing and evaluation]({{< ref "watermark/net/getting-started/evaluation-limitations-and-licensing" >}}).{{< /alert >}}

## Deleting text watermarks

To search and remove text watermarks:
1. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) an instance of the `Watermarker` class for a local file or file stream;
2. Specify the sought-after text of the watermark. To define criteria use the instance of the [TextSearchCriteria](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search.searchcriteria/textsearchcriteria/) class. In this example, we will search for a particular string match.
3. Call the [Search](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermarker/search/#search_1) method of the `Watermarker` class to perform the search and obtain a collection of all possible watermarks that meet the search criteria.
4. Use the [Clear](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.common/removeonlylistbase-1/clear/) method of the `PossibleWatermarkCollection` class to remove all found watermarks.
5. Call the [Save](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/4) method to store the document in a new location.

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Search.SearchCriteria;
using GroupDocs.Watermark.Search;

using (Watermarker watermarker = new Watermarker("C:\\Docs\\watermarked-sample.docx"))
{
    // Search watermark matching a particular text
    TextSearchCriteria searchCriteria = new TextSearchCriteria("Contract Draft", false);
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(searchCriteria);    
    // Clear all found watermarks
    possibleWatermarks.Clear();
    // Save document
    watermarker.Save("C:\\Docs\\clean-sample.docx");
}
```
Run the program. All found occurrences of "Contract Draft" in watermarks will be removed.
![Cleaning text watermarks](/watermark/net/images/watermarking/clean-text.png)

## Deleting image watermarks

To search and remove image watermarks within the document:
1. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) an instance of the `Watermarker` class for a local file or file stream;
2. Specify the sought-after image of the watermarks. To define criteria use the instance of the [ImageSearchCriteria](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search.searchcriteria/imagesearchcriteria/) class.
3. (Optionally.) Specify the maximum allowed difference between the images using the [MaxDifference](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.search.searchcriteria/imagesearchcriteria/maxdifference/) property. Too strict threshold may fail to detect all needed images, while a very lenient threshold could match dissimilar images.
4. Call the [Search](https://reference.groupdocs.com/watermark/net/groupdocs.watermark/watermarker/search/#search_1) method of the `Watermarker` class to perform the search and obtain a collection of all possible watermarks that meet the search criteria.
5. Use the [Clear](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.common/removeonlylistbase-1/clear/) method of the `PossibleWatermarkCollection` class to remove all found watermarks.
6. Call the [Save](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.watermarker/save/methods/4) method to store the document in a new location.

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Search.SearchCriteria;
using GroupDocs.Watermark.Search;

using (Watermarker watermarker = new Watermarker("watermarked-sample.docx"))
{
    // Initialize criteria with the image    
    ImageSearchCriteria imageSearchCriteria = new ImageDctHashSearchCriteria("logo.png");
    //Set maximum allowed difference between images
    imageSearchCriteria.MaxDifference = 0.9;
    PossibleWatermarkCollection possibleWatermarks = watermarker.Search(imageSearchCriteria);
    // Clear all found watermarks
    possibleWatermarks.Clear();
    // Save document
    watermarker.Save("clean-sample.docx");
}

```
Run the program. All found occurrences of image watermarks will be deleted.

![Cleaning image watermarks](/watermark/net/images/watermarking/clean-image.png)


---

## Clear watermarks

Path: /watermark/nodejs-java/clear/

Removing existing watermarks is another powerful feature of the GroupDocs.Watermark library. It allows searching and then removing text or image watermarks from a wide range of supported documents. Removing watermarks is possible for some of the supported formats. To learn whether it is available for your format, check [Supported formats]({{< ref "watermark/nodejs-java/getting-started/supported-document-formats.md" >}}).

{{< alert style="info" >}}Updating of watermarks is not allowed in evaluation mode. Please set up a license as described in [Licensing and evaluation]({{< ref "watermark/nodejs-java/getting-started/evaluation-limitations-and-licensing" >}}).{{< /alert >}}

## Deleting text watermarks

To search and remove text watermarks follow next sample:

```js
const groupdocs.watermark = require('@groupdocs/groupdocs.watermark')

function removeTextWatermarks() {
    // Create an instance of Watermarker
    const watermarker = new groupdocsWatermark.Watermarker('sample.pdf');

    // Create a TextSearchCriteria instance
    const criteria = new groupdocsWatermark.TextSearchCriteria('test', false);
    const watermarks = watermarker.search(criteria);

    // Remove found text fragments
    watermarks.clear();

    // Save changes
    watermarker.save('result.pdf');

    // Close watermarker
    watermarker.close();
}
```

## Deleting image watermarks

To search and remove image watermarks within the document:

```js
const groupdocs.watermark = require('@groupdocs/groupdocs.watermark')

function removeImageWatermarks() {
  // Create watermarker
  const watermarker = new groupdocsWatermark.Watermarker('sample.docx');

  // Initialize search criteria with the image
  const imageSearchCriteria = new groupdocsWatermark.ImageDctHashSearchCriteria("logo.png");

  // Set maximum allowed difference between images
  imageSearchCriteria.setMaxDifference(0.9);

  // Search for possible watermarks matching the criteria
  const watermarks = watermarker.search(imageSearchCriteria);

  console.log(`Found ${watermarks.getCount()} possible watermark(s).`);

    // Remove found text fragments
    watermarks.clear();

    // Save changes
    watermarker.save('result.docx');

    // Close watermarker
    watermarker.close();
}

```
Run the program. All found occurrences of image watermarks will be deleted.


---

## Clear watermarks

Path: /watermark/python-net/basic-usage/clear/


Removing existing watermarks is supported for many formats. Check supported formats to confirm availability.

## Deleting text watermarks

Search for and remove specific text watermarks from documents. You can target them by their text value and clear them in a single step.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("C:\\Docs\\watermarked-sample.docx") as watermarker:
    criteria = gws_sc.TextSearchCriteria("Contract Draft", False)
    possible = watermarker.search(criteria)
    possible.clear()
    watermarker.save("C:\\Docs\\clean-sample.docx")
```
🔹 Use case: Remove outdated labels such as “Draft” or “Internal Use Only” before sharing the document externally.

## Deleting image watermarks

Easily find and delete image watermarks (such as logos, stamps, or backgrounds) using perceptual image matching.

```python
import groupdocs.watermark as gw
import groupdocs.watermark.search.searchcriteria as gws_sc

with gw.Watermarker("watermarked-sample.docx") as watermarker:
    image_criteria = gws_sc.ImageDctHashSearchCriteria("logo.png")
    image_criteria.max_difference = 0.9
    possible = watermarker.search(image_criteria)
    possible.clear()
    watermarker.save("clean-sample.docx")
```

🔹 Use case: Clean up old branding or remove unauthorized third-party logos from documents.

---

## Common List Image in Email Document

Path: /assembly/java/common-list-image-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List report in Email Document format.{{< /alert >}}

## Common List in Email Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show multiple managers' picture and name.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}Inserting Images Dynamically is not Supported yet{{< /alert >}}

```java
<<foreach [in getManagers()]>><<[getName()]>>
<</foreach>>
```

### Download Common List Template

Please download the sample Common List document we created in this article:

*   [Common List.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist samicheemagroupdocs f35458abe16581d077174c00c505ff1d >}}



---

## Common List Image in Email Document

Path: /assembly/net/common-list-image-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common List report in Email Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

## Common List in Email Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   A report must be in .eml or .msg format
*   It must add email recipient, CSS and subject of the email
*   A report must show multiple customers' name

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
<<foreach [in customers]>><<[CustomerName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

Download Common List Template

Please download the sample Common List document we used in this article:

*   [Common List.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Common%20List.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists 1980c861285d1fd9be006efbc4a4a5c0 >}}



---

## Common Master-Detail Image in Email Document

Path: /assembly/java/common-master-detail-image-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in Email Document format.{{< /alert >}}

## Common Master-Detail in Email Document

### Creating a Common Master-Detail

Please follow below steps to create Common Master-Detail Template in MS Outlook 2013:

1.  Create a new Email.
2.  Insert two shapes, one for holding image and other for holding other details.
3.  Save the Email.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers and clients with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show manager's picture and name.
*   It must associate the managers with their clients.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}NOTE: Dynamic inserting of images is not supported yet.{{< /alert >}}

```java
<<foreach [in getManagers()]>>Manager: <<[getName()]>>
Clients: <<foreach [in getContracts()]>><<[indexOf() != 0 ? ", " : ""]>>
<<[getClient().getName()]>><</foreach>>
<</foreach>>
```

### Download Common Master-Detail Template

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs c55506d4b7d27cd6d0d29db308fe9d54 >}}

---

## Common Master-Detail Image in Email Document

Path: /assembly/net/common-master-detail-image-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Common Master-Detail report in Email Document format.{{< /alert >}}

## Common Master-Detail in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater{{< /alert >}}

### Creating a Common Master-Detail

Please follow below steps to create Common Master-Detail Template in MS Outlook 2013:

1.  Create a new Email.
2.  Insert two shapes, one for holding image and other for holding other details.
3.  Save the Email.

### Reporting Requirement

As a report developer, you are required to represent the information of the managers and clients with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show customer's name.
*   It must associate the customers with their products.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
<<foreach [in customers]>>Customer:
<<[CustomerName]>>
Products: <<foreach [in
Order]>><<[IndexOf() != 0 ? ", " : ""]>><<[Product.ProductName]>><</foreach>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Common Master-Detail Template

Please download the sample Common Master-Detail document we created in this article:

*   [Common Master-Detail.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Common%20Master-Detail.msg?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist rida-fatima-aspose 25a382242465c5c3305a33d90e7aa1b4 >}}



---

## Compare annotations

Path: /annotation/java/comparing-annotations-using-equals-method/


GroupDocs.Annotation v21.7. and later allows you to compare annotations using the `Equals` method.

The following code snippet shows how to compare annotations:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to update annotation.

// Create an instance of Annotator class
try (Annotator annotator = new Annotator("annotated_file.pdf")) {
    List<AnnotationBase> annotations = annotator.get();
    
    // Create an instance of the ImageAnnotation class and add options
    ImageAnnotation imageAnnotation = new ImageAnnotation();
    imageAnnotation.setBox(new Rectangle(100, 100, 100, 100));
    imageAnnotation.setOpacity(0.7);
    imageAnnotation.setPageNumber(0);
    imageAnnotation.setImagePath("www.google.com.ua/images/branding/googlelogo/2x/googlelogo_color_92x30dp.png");
    imageAnnotation.setAngle(100.0);

    for(int i = 0; i < annotations.size(); i++) {
        // Compare annotations
        if (imageAnnotation.equals(annotations.get(i))) {
                // Do some stuff here...
        }
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Compare annotations

Path: /annotation/net/comparing-annotations-using-equals-method/


GroupDocs.Annotation allows you to compare annotations using the [Equals](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation/equals) method or the already implemented [IEquatable](https://docs.microsoft.com/en-us/dotnet/api/system.iequatable-1) interface.

The following code snippet shows how to compare annotations:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("annotated_file.pdf"))
{
	var annotations = annotator.Get();
	ImageAnnotation imageAnnotation = new ImageAnnotation
	{
		Box = new Rectangle(100, 100, 100, 100),
		Opacity = 0.7,
		PageNumber = 0,
		ImagePath = "www.google.com.ua/images/branding/googlelogo/2x/googlelogo_color_92x30dp.png",
		Angle = 100
	};
	foreach (var annotation in annotations)
	{
		if (imageAnnotation.Equals(annotation))
		{
			// Do some stuff here...
		}
	}
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Compare JSON documents

Path: /comparison/python-net/compare-json-documents/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) allows developers to easily **compare JSON files** and detect differences in deeply nested objects, arrays, data types, and structures.\
This is useful for validating APIs, configurations, and large datasets where accuracy is critical.

With the API, you can:

-   Compare two or more **JSON documents**\
-   Highlight differences in nested objects, arrays, and values\
-   Use **visual mode** (HTML report with highlights) or **textual mode** (JSON diff output)\
-   Apply or reject detected changes programmatically

### Example: Compare JSON files in Python

```python
import groupdocs.comparison as gc

source_path = "source.json"
target_path = "target.json"
result_path = "result.json"

# Initialize the comparer with the source JSON document
with gc.Comparer(source_path) as comparer:

    # Add the target JSON document
    comparer.add(target_path)

    # Compare and save the result file
    comparer.compare(result_path)
```

The resulting `result.json` will contain the combined JSON structure with **differences highlighted inline**.

## Visual comparison mode

Generate a **single HTML report** that highlights changes visually:\
- **Deleted items** appear in red\
- **Inserted or modified items** appear in blue

```python
import groupdocs.comparison as gc
from groupdocs.comparison.options import CompareOptions

source_path = "source.json"
target_path = "target.json"
result_path = "result.html"

options = CompareOptions()
options.generate_summary_page = True  # Include summary of changes

with gc.Comparer(source_path) as comparer:
    comparer.add(target_path)
    comparer.compare(result_path, options)
```

## Textual comparison mode

Produce a **merged JSON file** with inline diff markers:\
- Deleted content is wrapped in `[ ]`\
- Inserted content is wrapped in `( )`

```python
import groupdocs.comparison as gc
from groupdocs.comparison.options import CompareOptions

source_path = "source.json"
target_path = "target.json"
result_path = "result.json"

options = CompareOptions()
options.detect_style_changes = True
options.show_deleted_content = True

with gc.Comparer(source_path) as comparer:
    comparer.add(target_path)
    comparer.compare(result_path, options)
```

## Applying or rejecting changes

You can also programmatically **accept or reject** detected changes in
JSON comparison results:

```python
import groupdocs.comparison as gc

source_path = "source.json"
target_path = "target.json"
result_path = "result.json"

with gc.Comparer(source_path) as comparer:
    comparer.add(target_path)

    # Run comparison first
    comparer.compare(result_path)

    # Iterate over detected changes
    for change in comparer.get_changes():
        if change.comparison_action == "Deleted":
            change.comparison_action = "Reject"  # reject deletion
        else:
            change.comparison_action = "Accept"  # accept additions/updates

    # Apply the updated decisions
    comparer.apply_changes(result_path)
```

---

## Context Objects - Complete Guide

Path: /conversion/net/context-objects-complete-guide/


## Introduction

Starting with **GroupDocs.Conversion for .NET v24.10**, all delegate-based patterns use **Context Objects**. These objects provide rich information about the conversion process and enable dynamic, context-aware conversion configurations.

Context objects are **foundational** to understanding how delegates work in GroupDocs.Conversion. If you see patterns like `Func<LoadContext, LoadOptions>` or `Action<ConvertedContext>`, you're working with context objects.

## Why Context Objects?

Context objects provide:

- **Source information**: File name, format, hierarchy level
- **Conversion state**: Current page being processed, target format
- **Dynamic configuration**: Configure options based on actual document properties
- **Lifecycle callbacks**: Monitor conversion progress page-by-page or document-level

## The Six Context Types

GroupDocs.Conversion provides six context types, each serving a specific purpose:

| Context Type | Used In | Purpose |
|--------------|---------|---------|
| [LoadContext](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/loadcontext/) | `Func<LoadContext, LoadOptions>` | Provides source information when loading documents |
| [ConvertContext](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertcontext/) | `Func<ConvertContext, ConvertOptions>` | Provides conversion information and cancellation control |
| [SaveContext](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/savecontext/) | `Func<SaveContext, Stream>` | Provides target information for custom stream output |
| [SavePageContext](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/savepagecontext/) | `Func<SavePageContext, Stream>` | Provides page-specific information for stream output |
| [ConvertedContext](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertedcontext/) | `Action<ConvertedContext>` | Callback after entire document conversion completes |
| [ConvertedPageContext](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/convertedpagecontext/) | `Action<ConvertedPageContext>` | Callback after each page conversion completes |

---

## LoadContext

**Used in**: Converter constructor overloads with `Func<LoadContext, LoadOptions>` parameter

**Purpose**: Provides information about the source document when loading, enabling dynamic load options based on file properties.

### Properties

| Property | Type | Description |
|----------|------|-------------|
| `SourceFileName` | `string` | Name of the source file (read-only) |
| `SourceFormat` | `FileType` | Format of the source document (read-only) |
| `SourceStream` | `Stream` | Source document stream (read-only) |
| `HierarchyLevel` | `int` | Nesting depth of current document in container hierarchy (read-only) * |
| `ItemIndex` | `int` | Absolute sequential counter across all items (read-only) * |

\* `HierarchyLevel` shows nesting depth (0 = root, 1 = embedded in root, etc.). `ItemIndex` is an absolute counter (1, 2, 3...) across all items regardless of hierarchy. For regular documents, these values are always 0 and 1.

### Example

```csharp
using (var converter = new Converter(
    "invoice-2024.pdf",
    (LoadContext loadContext) =>
    {
        // Access source information
        Console.WriteLine($"Loading file: {loadContext.SourceFileName}");
        Console.WriteLine($"Format: {loadContext.SourceFormat}");

        // Return appropriate load options based on format
        return new PdfLoadOptions();
    }))
{
    converter.Convert("invoice-2024.docx", new WordProcessingConvertOptions());
}
```

---

## ConvertContext

**Used in**: `Convert()` method overloads with `Func<ConvertContext, ConvertOptions>` parameter

**Purpose**: Provides conversion information and allows setting cancellation token for the conversion process.

### Properties

| Property | Type | Description |
|----------|------|-------------|
| `CancellationToken` | `CancellationToken` | Cancellation token (**get; set;** - only settable property!) |
| `SourceFileName` | `string` | Name of the source file (read-only) |
| `SourceFormat` | `FileType` | Format of the source document (read-only) |

### Example

```csharp
using (var converter = new Converter("quarterly-report.pdf"))
{
    converter.Convert(
        (ConvertContext convertContext) =>
        {
            // Access conversion information
            Console.WriteLine($"Converting: {convertContext.SourceFileName}");
            Console.WriteLine($"From format: {convertContext.SourceFormat}");

            // Can set cancellation token
            convertContext.CancellationToken = CancellationToken.None;

            return new WordProcessingConvertOptions();
        },
        (ConvertedContext convertedContext) =>
        {
            // Save the converted stream to file
            using (var fileStream = File.Create("quarterly-report.docx"))
            {
                convertedContext.ConvertedStream.CopyTo(fileStream);
            }
        });
}
```

---

## SaveContext

**Used in**: `Convert()` method overloads with `Func<SaveContext, Stream>` parameter

**Purpose**: Provides information about the conversion output, enabling custom stream handling for the converted document.

### Properties

| Property | Type | Description |
|----------|------|-------------|
| `SourceFileName` | `string` | Name of the source file (read-only) |
| `SourceFormat` | `FileType` | Format of the source document (read-only) |
| `TargetFormat` | `string` | Target format for conversion (read-only) |
| `HierarchyLevel` | `int` | Nesting depth of current document in container hierarchy (read-only) * |
| `ItemIndex` | `int` | Absolute sequential counter across all items (read-only) * |

\* `HierarchyLevel` shows nesting depth (0 = root, 1 = embedded, etc.). `ItemIndex` is an absolute counter (1, 2, 3...) across all items. Only relevant for container documents (e.g., PST, OST, PDF with embedded files).

### Example

```csharp
using (var converter = new Converter("balance-sheet.pdf"))
{
    converter.Convert(
        (SaveContext saveContext) =>
        {
            // Access output information
            Console.WriteLine($"Source: {saveContext.SourceFileName}");
            Console.WriteLine($"From: {saveContext.SourceFormat}");
            Console.WriteLine($"To: {saveContext.TargetFormat}");

            // Return custom stream for output
            return File.Create("balance-sheet.xlsx");
        },
        new SpreadsheetConvertOptions());
}
```

---

## SavePageContext

**Used in**: `Convert()` method overloads with `Func<SavePageContext, Stream>` parameter

**Purpose**: Provides page-specific information for page-by-page conversion, enabling custom stream handling for each converted page.

### Properties

| Property | Type | Description |
|----------|------|-------------|
| `Page` | `int` | Page number from source document (read-only) |
| `SourceFileName` | `string` | Name of the source file (read-only) |
| `SourceFormat` | `FileType` | Format of the source document (read-only) |
| `TargetFormat` | `string` | Target format for conversion (read-only) |

### Example

```csharp
using (var converter = new Converter("contract-2024.pdf"))
{
    converter.Convert(
        (SavePageContext savePageContext) =>
        {
            // Access page-specific information
            Console.WriteLine($"Processing page: {savePageContext.Page}");
            Console.WriteLine($"Source: {savePageContext.SourceFileName}");
            Console.WriteLine($"From: {savePageContext.SourceFormat}");
            Console.WriteLine($"To: {savePageContext.TargetFormat}");

            // Return stream for this specific page
            return File.Create($"contract-2024-page-{savePageContext.Page}.png");
        },
        new ImageConvertOptions());
}
```

---

## ConvertedContext

**Used in**: `Convert()` method overloads with `Action<ConvertedContext>` parameter

**Purpose**: Callback invoked after the entire document conversion completes, providing access to the converted stream and conversion details.

### Properties

| Property | Type | Description |
|----------|------|-------------|
| `ConvertedFormat` | `string` | Format of the converted document (read-only) |
| `ConvertedStream` | `Stream` | Stream containing the converted document (read-only) |
| `SourceFileName` | `string` | Name of the source file (read-only) |
| `SourceFormat` | `FileType` | Format of the source document (read-only) |
| `HierarchyLevel` | `int` | Nesting depth of current document in container hierarchy (read-only) * |
| `ItemIndex` | `int` | Absolute sequential counter across all items (read-only) * |

\* `HierarchyLevel` shows nesting depth (0 = root, 1 = embedded, etc.). `ItemIndex` is an absolute counter (1, 2, 3...) across all items. Only relevant for container documents (e.g., PST, OST, PDF with embedded files).

### Example

```csharp
using (var converter = new Converter("sales-report.pdf"))
{
    converter.Convert(
        new WordProcessingConvertOptions(),
        (ConvertedContext convertedContext) =>
        {
            // Access conversion result information
            Console.WriteLine($"Converted: {convertedContext.SourceFileName}");
            Console.WriteLine($"From: {convertedContext.SourceFormat}");
            Console.WriteLine($"To: {convertedContext.ConvertedFormat}");
            Console.WriteLine("Conversion completed!");

            // Save the converted stream to file
            using (var fileStream = File.Create("sales-report.docx"))
            {
                convertedContext.ConvertedStream.CopyTo(fileStream);
            }
        });
}
```

---

## ConvertedPageContext

**Used in**: `Convert()` method overloads with `Action<ConvertedPageContext>` parameter

**Purpose**: Callback invoked after each page conversion completes, enabling page-by-page monitoring and handling.

### Properties

| Property | Type | Description |
|----------|------|-------------|
| `ConvertedFormat` | `string` | Format of the converted page (read-only) |
| `ConvertedStream` | `Stream` | Stream containing the converted page (read-only) |
| `Page` | `int` | Page number from source document (read-only) |
| `SourceFileName` | `string` | Name of the source file (read-only) |
| `SourceFormat` | `FileType` | Format of the source document (read-only) |

### Example

```csharp
using (var converter = new Converter("monthly-report.pdf"))
{
    converter.Convert(
        new WordProcessingConvertOptions(),
        (ConvertedPageContext convertedPageContext) =>
        {
            // Access page conversion result
            Console.WriteLine($"Page {convertedPageContext.Page} converted");
            Console.WriteLine($"Format: {convertedPageContext.ConvertedFormat}");
            Console.WriteLine($"Source: {convertedPageContext.SourceFileName}");
            Console.WriteLine($"From: {convertedPageContext.SourceFormat}");

            // Save each page's stream to file
            using (var fileStream = File.Create($"monthly-report-page-{convertedPageContext.Page}.docx"))
            {
                convertedPageContext.ConvertedStream.CopyTo(fileStream);
            }
        });
}
```

---

## Working with Container Documents

The `HierarchyLevel` and `ItemIndex` properties become relevant when converting **container documents** that can hold multiple items in a hierarchical structure.

### Understanding HierarchyLevel and ItemIndex

- **HierarchyLevel**: Shows the **nesting depth** of the current document
  - `0` = Root/main document
  - `1` = Directly embedded in main document
  - `2` = Embedded within an embedded document, etc.

- **ItemIndex**: **Absolute sequential counter** across ALL items
  - Starts at 1 and increments for each item
  - NOT per-hierarchy-level (it's global)

**Example hierarchy:**
```
Main PDF (Level 0, Index 1)
├─ Attachment 1 (Level 1, Index 2)
├─ Attachment 2 (Level 1, Index 3)
└─ Attachment 3 (Level 1, Index 4)
    └─ Sub-attachment (Level 2, Index 5)
```

### Container Document Types

- **Email containers**: PST, OST files (Outlook data files)
- **Email storage**: MBOX, NSF, OLM files
- **PDF with attachments**: PDF files containing embedded documents
- **Archive formats**: ZIP files (when extracted and converted)

### Example: Converting PST File with Hierarchy Information

```csharp
using (var converter = new Converter("mailbox-archive.pst"))
{
    int itemCount = 0;

    converter.Convert(
        (SaveContext saveContext) =>
        {
            itemCount++;

            // Access hierarchy information for container items
            Console.WriteLine($"Item #{itemCount}");
            Console.WriteLine($"  Source: {saveContext.SourceFileName}");
            Console.WriteLine($"  Hierarchy Level: {saveContext.HierarchyLevel}");
            Console.WriteLine($"  Item Index: {saveContext.ItemIndex}");
            Console.WriteLine($"  Target Format: {saveContext.TargetFormat}");

            // Create output file with hierarchy info in name
            var outputName = $"email-L{saveContext.HierarchyLevel}-I{saveContext.ItemIndex}.pdf";
            return File.Create(outputName);
        },
        new PdfConvertOptions());

    Console.WriteLine($"Total items converted: {itemCount}");
}
```

### Example: PDF with Embedded Files

```csharp
// LoadContext is called for EACH document in the hierarchy
using (var converter = new Converter(
    "contract-with-attachments.pdf",
    (LoadContext loadContext) =>
    {
        // HierarchyLevel shows WHERE in the hierarchy this document is
        // Level 0 = main document
        // Level 1 = directly embedded in main document
        // Level 2 = embedded within an embedded document, etc.

        Console.WriteLine($"Loading: {loadContext.SourceFileName}");
        Console.WriteLine($"  Hierarchy Level: {loadContext.HierarchyLevel}");
        Console.WriteLine($"  Item Index: {loadContext.ItemIndex}");

        if (loadContext.HierarchyLevel == 0)
        {
            Console.WriteLine("  -> This is the main document");
        }
        else if (loadContext.HierarchyLevel == 1)
        {
            Console.WriteLine("  -> This is an embedded file in the main document");
        }
        else
        {
            Console.WriteLine($"  -> This is nested {loadContext.HierarchyLevel} levels deep");
        }

        // Return appropriate load options for the document type
        return new PdfLoadOptions();
    }))
{
    int itemCount = 0;

    converter.Convert(
        (SaveContext saveContext) =>
        {
            itemCount++;

            // SaveContext shows hierarchy level during conversion
            var outputName = $"contract-L{saveContext.HierarchyLevel}-I{saveContext.ItemIndex}.pdf";
            Console.WriteLine($"Saving: {outputName}");

            return File.Create(outputName);
        },
        new PdfConvertOptions());

    Console.WriteLine($"Total items converted: {itemCount}");
}
```

**Key Points:**
- **LoadContext is called once for each document** in the container hierarchy (main document + each embedded document)
- **HierarchyLevel shows the nesting depth** of the document currently being loaded/converted:
  - `HierarchyLevel = 0` → Main/root document
  - `HierarchyLevel = 1` → Directly embedded in main document
  - `HierarchyLevel = 2` → Embedded within an embedded document, etc.
- **ItemIndex is an absolute sequential counter** - counts all items across the entire conversion (1, 2, 3, 4...), regardless of hierarchy level
- For regular documents (DOCX, XLSX, simple PDF without embedded files), `HierarchyLevel` is always 0 and `ItemIndex` is always 1

---

## Common Patterns

### Pattern 1: Dynamic Load Options Based on Source

```csharp
using (var converter = new Converter(
    "annual-report.pdf",
    (LoadContext loadContext) =>
    {
        // Choose load options based on actual file format
        if (loadContext.SourceFormat == FileType.Pdf)
            return new PdfLoadOptions { RemoveEmbeddedFiles = true };

        if (loadContext.SourceFormat == FileType.Docx)
            return new WordProcessingLoadOptions { DefaultFont = "Arial" };

        return null; // Auto-detect
    }))
{
    converter.Convert("annual-report.xlsx", new SpreadsheetConvertOptions());
}
```

### Pattern 2: Page-by-Page Conversion with Custom Names

```csharp
using (var converter = new Converter("employee-handbook.pdf"))
{
    converter.Convert(
        (SavePageContext savePageContext) =>
        {
            // Create separate file for each page with custom naming
            var fileName = $"handbook-section-{savePageContext.Page:D3}.docx";
            return File.Create(fileName);
        },
        new WordProcessingConvertOptions());
}
```

### Pattern 3: Conversion Progress Monitoring

```csharp
int processedPages = 0;

using (var converter = new Converter("product-catalog.pdf"))
{
    converter.Convert(
        new ImageConvertOptions { Format = ImageFileType.Png },
        (ConvertedPageContext convertedPageContext) =>
        {
            processedPages++;
            Console.WriteLine($"Progress: Page {processedPages} of product catalog converted");

            // Save page stream
            using (var fileStream = File.Create($"catalog-page-{convertedPageContext.Page:D3}.png"))
            {
                convertedPageContext.ConvertedStream.CopyTo(fileStream);
            }
        });
}
```

---

## Summary

Context objects are foundational to GroupDocs.Conversion's delegate-based patterns. Understanding them enables you to:

- **LoadContext**: Configure dynamic load options based on source properties
- **ConvertContext**: Control conversion process and access source information
- **SaveContext**: Handle custom output streams with full target information
- **SavePageContext**: Process pages individually with page-specific context
- **ConvertedContext**: Post-process entire converted document
- **ConvertedPageContext**: Monitor and handle page-by-page conversion results

All examples on this page have been verified through automated testing to ensure accuracy.

## See Also

- [Converter API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/)
- [Fluent Syntax]({{< ref "fluent-syntax" >}})
- [Load Options Overview]({{< ref "../advanced-usage/loading/load-options-for-different-document-types" >}})

---

## Convert to Presentation with advanced options

Path: /conversion/net/convert-to-presentation-with-advanced-options/

GroupDocs.Conversion provides [PresentationConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/presentationconvertoptions) to give you control over conversion result when convert to powerpoint presentation format. Along with [common convert options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}}) from base class [PresentationConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/presentationconvertoptions) has the following additional options:

*   **[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** specifies desired result document type. Available options are: *Ppt, Pps, Pptx, Ppsx, Odp, Otp, Potx, Pot, Potm, Pptm, Ppsm*.
*   **[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/presentationconvertoptions/password)** whether the converted document will be password protected with the specified password.
*   **[Zoom](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/presentationconvertoptions/zoom)** specifies the zoom level in percentage.

The following code snippet shows how to convert to Presentation with advanced options:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    PresentationConvertOptions options = new PresentationConvertOptions
    {
        PageNumber = 2,
        PagesCount = 1,
        Format = PresentationFileType.Ppt
    };
    converter.Convert("converted.ppt", options);
}
```

---

## Convert to WordProcessing with advanced options

Path: /conversion/java/convert-to-wordprocessing-with-advanced-options/


[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/java) offers the [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/) class, enabling fine-tuned control over the conversion process when working with word-processing formats. This class extends the base conversion options with additional advanced parameters, allowing developers to achieve highly customized results.
| Option | Description |
|--------|-------------|
|[**setFormat()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/#setFormat-com.groupdocs.conversion.filetypes.FileType-) |  Defines the desired output document type. Supported formats include `Doc`, `Docm`, `Docx`, `Dot`, `Dotx`, `Rtf`, `Odt`, `Ott`, `Mobi`, and `Txt`. |
|[**setPageWidth()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/#setPageWidth-float-) |  Sets the target page width after conversion (measured in points). |
|[**setPageHeight()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/#setPageHeight-float-) | Specifies the desired page height after conversion (measured in points). |
|[**setDpi()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/#setDpi-int-) | Adjusts the target page DPI (dots per inch) to control the quality and resolution of the output. |
|[**setPassword()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/#setPassword-java.lang.String-) | Enables password protection for the converted file, requiring a specified password for access. |
|[**setRtfOptions()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/#setRtfOptions-com.groupdocs.conversion.options.convert.RtfOptions-) | Configures RTF-specific settings through the `RtfOptions` class. Includes: [setExportImagesForOldReaders](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/rtfoptions/#setExportImagesForOldReaders-boolean-) - controls whether additional keywords for compatibility with older RTF readers are included, potentially affecting document size. |
|[**setZoom()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/#setZoom-int-) | Specifies the zoom level for the output document, defined as a percentage. |

The following example demonstrates how to convert a PDF document to an ODT file using advanced conversion options:

{{< tabs "code-example">}}
{{< tab "ConvertToWordProcessingWithAdvancedOptions.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.WordProcessingFileType;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;

public class ConvertToWordProcessingWithAdvancedOptions {
    public static void convert() {
        // Load the source document
        try(Converter converter = new Converter("professional-services.pdf")) {
            // Configure presentation conversion options
            WordProcessingConvertOptions options = new WordProcessingConvertOptions();
            options.setPageNumber(2);
            options.setPagesCount(1);
            options.setFormat(WordProcessingFileType.Doc);

            // Perform the conversion
            converter.convert("converted_with_options.doc", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "professional-services.pdf" >}}  
{{< tab-text >}}
`professional-services.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-wordprocessing-with-advanced-options/professional-services.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_options.doc" >}}  
{{< tab-text >}}
`converted_with_options.doc` is converted Doc document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-wordprocessing-with-advanced-options/converted_with_options.doc) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

This level of configurability makes the [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/wordprocessingconvertoptions/) class a powerful tool for developers seeking to optimize document conversion workflows.
---

## Convert to WordProcessing with advanced options

Path: /conversion/nodejs-java/convert-to-wordprocessing-with-advanced-options/

[**GroupDocs.Conversion**](#) provides the [WordProcessingConvertOptions](#) class to give you control over conversion result when convert to WordProcessing formats. Along with [common convert options](#) from base class [WordProcessingConvertOptions](#) has the following additional options:

*   [setFormat](#) specifies desired result document type. Available options are: *Doc, Docm, Docx, Dot, Dotx, Rtf, Odt, Ott, Mobi, Txt*.
*   [setWidth](#) specifies desired page width after conversion.  
*   [setHeight](#) specifies desired page height after conversion.     
*   [setDpi](#) specifies desired page dpi after conversion.
*   [setPassword](#) whether the converted document will be password protected with the specified password.
*   [setRtfOptions](#) specifies RTF specific options. [RtfOptions](#) class has single option [setExportImagesForOldReaders](#) specifies whether the keywords for "old readers" are written to RTF or not. This can significantly affect the size of the RTF document.
*   [setZoom](#) specifies the zoom level in percentage.

The following code snippet shows how to convert to WordProcessing document with advanced options:

```js
const converter = new groupdocs.conversion.Converter("sample.pdf");
const convertOptions = new groupdocs.conversion.WordProcessingConvertOptions();

convertOptions.setPageNumber(2);
convertOptions.setPagesCount(1);
convertOptions.setFormat(groupdocs.conversion.WordProcessingFileType.Odt);
converter.convert("converted.odt", convertOptions);
```

---

## Create custom format handler

Path: /redaction/java/create-custom-format-handler/

If format is not supported, you will need to implement a handler for it by inheriting from *DocumentFormatInstance* class. Depending on the document's features and required redactions, you will also need to implement one or several interfaces, allowing GroupDocs.Redaction to work with this document format.

| Interface | Description |
| --- | --- |
| *ITextualFormatInstance* | Required for document text redactions to work, replaces occurrences of given regular expression with text or a color block |
| *IMetadataAccess* | Required for metadata redactions, reads metadata and changes specific metadata item |
| *IAnnotatedDocument* | Required for annotation redactions, changes or deletes annotations, matching given regular expression |
| *IRasterizableDocument* | Required to rasterize (save document as a PDF with page images) |
| *IImageFormatInstance* | Required for raster image format redactions, based on area top-left corner coordinates and area size |
| *IPreviewable* | Required to provide document general information and preview functionality |

Each of these interfaces is optional, i.e. you don't have to implement all of them, e.g. *IImageFormatInstance* - if you don't need its functionality or *IMetadataAccess*, if your format does not support metadata.

Below, we create a *DocumentFormatInstance* class with custom logic for textual documents processing, supporting only textual redactions:



```java
import com.groupdocs.redaction.options.RedactorSettings;

public class CustomTextualDocument extends DocumentFormatInstance implements ITextualFormatInstance
{
    private RedactorSettings _settings;
    private final java.util.List<String> _fileContent;
 
    public CustomTextualDocument()
    {
        _fileContent = new java.util.ArrayList<>();
    }
 
    @Override
    public void initialize(DocumentFormatConfiguration config, RedactorSettings settings)
    {
        _settings = settings;
    }
 
    @Override
    public void load(java.io.InputStream input) throws java.lang.Exception
    {
        _fileContent.clear();
        java.io.BufferedReader reader = new java.io.BufferedReader(
                new java.io.InputStreamReader(input)
        );
        String line = reader.readLine();
        while (line != null)
        {
            _fileContent.add(line);
            line = reader.readLine();
        }            
        reader.close();
    }
 
    @Override
    public void save(java.io.OutputStream output) throws java.lang.Exception
    {
        java.io.BufferedWriter writer = new java.io.BufferedWriter(new java.io.OutputStreamWriter(output));
        for (String line : _fileContent)
        {
            writer.write(line);
        }
        writer.close();
    }
 
    @Override
    public RedactionResult replaceText(java.util.regex.Pattern regex, ReplacementOptions options)
    {
        try
        {
            if (options.getActionType() != ReplacementType.ReplaceString)
            {
                return RedactionResult.failed("This format allows only ReplaceString redactions!");
            }
            for (int i = 0; i < _fileContent.size(); i++)
            {
                _fileContent.set(i, regex.matcher(_fileContent.get(i)).replaceAll(options.getReplacement()));
            }
            return RedactionResult.successful();
        }
        catch (java.lang.Exception ex)
        {
            return RedactionResult.failed(ex.getMessage());
        }
    }
}
```

In order to use this class, we will need to add it to pre-configured formats, e.g. as a handler for dump files ("\*.dump"):



```java
DocumentFormatConfiguration format = new DocumentFormatConfiguration();
format.setExtensionFilter(".dump");
format.setDocumentType(typeof(CustomTextualDocument));

RedactorConfiguration config = DocumentFormatInstance.getDefaultConfiguration();
config.getAvailableFormats().add(format);
```

### Security and password protection

If your format supports security options like password protection, you'll have to pass true or false to *SetAccessGranted* method of *DocumentFormatInstance* class in your override of *Load* method and throw IncorrectPasswordException or PasswordRequiredException, if applicable. For instance:



```java
@Override
public void load(java.io.InputStream input) throws java.lang.Exception
{
    try
    {
		// check security and load document 

        setAccessGranted(true);
    }
    catch (SomeSecurityException ex)
    {
        setAccessGranted(false);
		// Password, provided with LoadOptions
        if (string.IsNullOrEmpty(Password))
            throw new Exceptions.PasswordRequiredException();
        else
            throw new Exceptions.IncorrectPasswordException();
    }
}

```

---

## Development Environment Installation and Configuration

Path: /assembly/java/installation/

## Development Environment

### Operating Systems

**GroupDocs.Assembly for Java** can be executed on any Operating System with Java JDK installed.

*   Windows Desktops and Servers
*   Linux
*   Mac OS

### Supported Runtime

**GroupDocs.Assembly for Java** supports Java run-time version 7 (1.7) and above.

### Development Environments

*   NetBeans
*   IntelliJ IDEA
*   Eclipse

## Installation from GroupDocs Artifactory using Maven

GroupDocs hosts all Java APIs on [GroupDocs Artifactory](https://releases.groupdocs.com/java/repo/). You can easily use [GroupDocs.Assembly for Java](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-assembly/) API directly into your Maven projects with simple configurations.

### Specify GroupDocs Repository Configuration

First, you need to specify GroupDocs repository configuration/location in your Maven `pom.xml` as follows:
```
<repositories>
	<repository>
		<id>GroupDocsJavaAPI</id>
		<name>GroupDocs Java API</name>
		<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```

### Define GroupDocs.Assembly for Java API Dependency

Then define GroupDocs.Assembly for Java API dependency in your `pom.xml` as follows:
```
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-assembly</artifactId>
        <version>20.3</version>
    </dependency>
</dependencies>
```

After performing above-mentioned steps, GroupDocs.Assembly for Java dependency will finally be added to your Maven project.

---

## Development Environment Installation and Configuration

Path: /assembly/net/development-environment-installation-and-configuration/

## Development Environment

Please visit [System Requirements](https://docs.groupdocs.com/assembly/net/system-requirements/).

## Installing GroupDocs.Assembly for .NET through NuGet

NuGet is the easiest way to download and install GroupDocs.Assembly for .NET. Following are the couple of ways to install GroupDocs.Assembly for .NET in your project using NuGet.

### Using Package Manager GUI

Follow these steps to reference GroupDocs.Assembly using Package Manager GUI:

*   Open your solution/project in Visual Studio.
*   Click **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution**. You can also access the same option through the Solution Explorer. Right-click the solution or project and select **Manage NuGet Packages** from the context menu.
*   Select **Browse** tab and type "GroupDocs.Assembly" in the search text box.
*   Click the **Install** button to install the latest version of the API into your project as shown in the following screenshot.

![](assembly/net/images/development-environment-installation-and-configuration.png)

### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Assembly using the Package Manager Console:

*   Open your solution/project in Visual Studio.
*   Select **Tools** -> **NuGet Package Manager** -> **Package Manager Console** from the menu to open package manager console.
*   Type the command "Install-Package GroupDocs.Assembly" and press enter to install the latest release into your application.
*   After successful installation, GroupDocs.Assembly will be referenced in your application.

![](assembly/net/images/development-environment-installation-and-configuration_1.png)

{{< alert style="warning" >}}These steps are written while using the Visual Studio 2015.{{< /alert >}}

### Video Demo

Please view [this](https://www.youtube.com/watch?v=fjT99lV0sdw&list=PL25CTxMCj5vOzsaE9Rwjwd4-OwvdaWmJ8&index=2) video demo to get a better demonstration of installation and usage of GroupDocs.Assembly for .NET 3.0.0.

---

## Document attributes

Path: /search/java/document-attributes/

Document attributes is a special feature designed for marking indexed documents with text labels without the need for re-indexing. Added attributes can be further used to filter documents during the search.

To add and delete attributes of indexed documents, use the [changeAttributes](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#changeAttributes(com.groupdocs.search.AttributeChangeBatch)) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class. This method accepts an [AttributeChangeBatch](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/AttributeChangeBatch) object containing the required attribute changes as a parameter.

The following example demonstrates how to add and remove attributes from indexed documents.



```java
String indexFolder = "c:\\MyIndex";
String documentFolder = "c:\\MyDocuments";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents in a document folder
index.add(documentFolder);
 
// Creating an attribute change container object
AttributeChangeBatch batch = new AttributeChangeBatch();
// Adding one attribute to all indexed documents
batch.addToAll("public");
// Removing one attribute from one indexed document
batch.remove("c:\\MyDocuments\\KeyPoints.doc", "public");
// Adding two attributes to one indexed document
batch.add("c:\\MyDocuments\\KeyPoints.doc", "main", "key");
 
// Applying attribute changes in the index
index.changeAttributes(batch);
 
// Searching in the index
SearchOptions options = new SearchOptions();
// Creating a document filter by attribute
options.setSearchDocumentFilter(SearchDocumentFilter.createAttribute("main"));
SearchResult result = index.search("Einstein", options);
```

Attributes can be associated with documents during indexing using the [FileIndexing](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#FileIndexing) event. The following example demonstrates this.



```java
String indexFolder = "c:\\MyIndex";
String documentFolder = "c:\\MyDocuments";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the FileIndexing event for adding attributes
index.getEvents().FileIndexing.add(new EventHandler<FileIndexingEventArgs>() {
    public void invoke(Object sender, FileIndexingEventArgs args) {
        if (args.getDocumentFullPath().endsWith("KeyPoints.doc")) {
            // Adding two attributes
            args.setAttributes(new String[] { "main", "key" });
        }
    }
});
 
// Indexing documents in a document folder
index.add(documentFolder);
 
// Searching in the index
SearchOptions options = new SearchOptions();
// Creating a document filter by attribute
options.setSearchDocumentFilter(SearchDocumentFilter.createAttribute("main"));
SearchResult result = index.search("Einstein", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document attributes

Path: /search/net/document-attributes/

Document attributes is a special feature designed for marking indexed documents with text labels without the need for re-indexing. Added attributes can be further used to filter documents during the search.

To add and delete attributes of indexed documents, use the [ChangeAttributes](https://reference.groupdocs.com/search/net/groupdocs.search/index/methods/changeattributes) method of the [Index](https://reference.groupdocs.com/search/net/groupdocs.search/index) class. This method accepts an [AttributeChangeBatch](https://reference.groupdocs.com/search/net/groupdocs.search.common/attributechangebatch) object containing the required attribute changes as a parameter.

The following example demonstrates how to add and remove attributes from indexed documents.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFolder = @"c:\MyDocuments";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Indexing documents in a document folder
index.Add(documentFolder);
  
// Creating an attribute change container object
AttributeChangeBatch batch = new AttributeChangeBatch();
// Adding one attribute to all indexed documents
batch.AddToAll("public");
// Removing one attribute from one indexed document
batch.Remove(@"c:\MyDocuments\KeyPoints.doc", "public");
// Adding two attributes to one indexed document
batch.Add(@"c:\MyDocuments\KeyPoints.doc", "main", "key");
  
// Applying attribute changes in the index
index.ChangeAttributes(batch);
 
// Searching in the index
SearchOptions options = new SearchOptions();
// Creating a document filter by attribute
options.SearchDocumentFilter = SearchDocumentFilter.CreateAttribute("main");
SearchResult result = index.Search("Einstein", options);
```

Attributes can be associated with documents during indexing using the [FileIndexing](https://reference.groupdocs.com/search/net/groupdocs.search.events/eventhub/events/fileindexing) event. The following example demonstrates this.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFolder = @"c:\MyDocuments";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the FileIndexing event for adding attributes
index.Events.FileIndexing += (sender, args) =>
{
    if (args.DocumentFullPath.EndsWith("KeyPoints.doc"))
    {
        // Adding two attributes
        args.Attributes = new string[] { "main", "key" };
    }
};
 
// Indexing documents in a document folder
index.Add(documentFolder);
 
// Searching in the index
SearchOptions options = new SearchOptions();
// Creating a document filter by attribute
options.SearchDocumentFilter = SearchDocumentFilter.CreateAttribute("main");
SearchResult result = index.Search("Einstein", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document attributes

Path: /search/nodejs-java/document-attributes/

Document attributes is a special feature designed for marking indexed documents with text labels without the need for re-indexing. Added attributes can be further used to filter documents during the search.

To add and delete attributes of indexed documents, use the [changeAttributes](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#changeAttributes(com.groupdocs.search.AttributeChangeBatch)) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class. This method accepts an [AttributeChangeBatch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/AttributeChangeBatch) object containing the required attribute changes as a parameter.

The following example demonstrates how to add and remove attributes from indexed documents.

```javascript
const indexFolder = 'c:/MyIndex';
const documentFolder = 'c:/MyDocuments';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents in a document folder
index.add(documentFolder);

const documents = index.getIndexedDocuments();

// Creating an attribute change container object
const batch = new groupdocs.search.AttributeChangeBatch();
// Adding one attribute to all indexed documents
batch.addToAll('public');
// Removing one attribute from one indexed document
batch.remove(documents[0].getFilePath(), 'public');
// Adding two attributes to one indexed document
batch.add(documents[0].getFilePath(), 'main', 'key');

// Applying attribute changes in the index
index.changeAttributes(batch);

// Searching in the index
const options = new groupdocs.search.SearchOptions();
// Creating a document filter by attribute
options.setSearchDocumentFilter(groupdocs.search.SearchDocumentFilter.createAttribute('main'));
const query = 'Einstein';
const result = index.search(query, options);
```

Attributes can be associated with documents during indexing using the [FileIndexing](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#FileIndexing) event. The following example demonstrates this.

```javascript
const indexFolder = 'c:/MyIndex';
const documentFolder = 'c:/MyDocuments';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the FileIndexing event to add attributes
index.getEvents().FileIndexing.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      if (args.getDocumentFullPath().endsWith('Lorem ipsum.pdf')) {
        // Adding two attributes
        args.setAttributes(['main', 'key']);
      }
    },
  }),
);

// Indexing documents in a document folder
index.add(documentFolder);

// Searching in the index
const options = new groupdocs.search.SearchOptions();
// Creating a document filter by attribute
options.setSearchDocumentFilter(groupdocs.search.SearchDocumentFilter.createAttribute('main'));
const query = 'Einstein';
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Edit Document

Path: /editor/nodejs-java/edit-document/


> This article describes how to open a previously loaded document for editing, which options should be applied, and how to send document content to a WYSIWYG HTML editor or any other editing application.

When a document is loaded into an instance of the `Editor` class, it is possible to open it for editing. In terms of **GroupDocs.Editor**, opening a document for editing involves creating an instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.EditableDocument) class by calling the `Editor.edit()` method. There are two overloads of the `edit()` method. The first one accepts a single parameter—an instance of the `EditOptions` class.

Each format family has its own implementation of the `EditOptions` class. They are listed in the table below.

| Format Family                      | Example Formats                                         | Edit Options Class                                                     |
|------------------------------------|---------------------------------------------------------|------------------------------------------------------------------------|
| **WordProcessing**                 | DOC, DOCX, DOCM, DOT, ODT                               | [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingEditOptions) |
| **Spreadsheet**                    | XLS, XLSX, XLSM, XLSB                                   | [`SpreadsheetEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.SpreadsheetEditOptions)      |
| **Delimiter-Separated Values (DSV)** | CSV, TSV                                               | [`DelimitedTextEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.DelimitedTextEditOptions)    |
| **Presentation**                   | PPT, PPTX, PPS, POT                                     | [`PresentationEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.PresentationEditOptions)     |
| **Plain Text Documents**           | TXT                                                     | [`TextEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.TextEditOptions)                    |
| **XML**                            | Any XML-based format like CSPROJ, SVG, etc.             | [`XmlEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.XmlEditOptions)                      |
| **eBook**                          | MOBI, AZW3, EPUB                                        | [`EbookEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.EbookEditOptions)                  |
| **Email**                          | EML, EMLX, TNEF, MSG, HTML, MHTML, ICS, VCF, PST, MBOX, OFT | [`EmailEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.EmailEditOptions)                  |

The second overload is parameterless—it chooses the most appropriate default edit options based on the input document format.

The `EditableDocument` instance holds a version of the input document converted to an internal intermediate format according to the edit options. When it is ready, it can emit HTML, CSS, and other appropriate content that can be passed directly to the WYSIWYG editor. This is demonstrated below.

```javascript
// Import the GroupDocs.Editor module
const groupdocsEditor = require('groupdocs-editor');
const fs = require('fs');

// Path to the input document
const inputFilePath = "C:\\input_path\\document.docx";

// Load the document into the Editor
const editor = new groupdocsEditor.Editor(inputFilePath);

// Edit the document with default edit options
const openedDocument = editor.edit(); // With default edit options

// Create and adjust custom edit options
const editOptions = new groupdocsEditor.WordProcessingEditOptions();
editOptions.setEnableLanguageInformation(true);
editOptions.setEnablePagination(true);

// Edit the document with custom edit options
const anotherOpenedDocument = editor.edit(editOptions);

// Obtain HTML markup and resources
const htmlContent = anotherOpenedDocument.getContent();
const resources = anotherOpenedDocument.getAllResources();

// Optionally, save the HTML content to a file
fs.writeFileSync('editedDocument.html', htmlContent);
```

Multiple `EditableDocument` instances can be generated from a single `Editor` instance with different edit options. For example, for a WordProcessing document, you can call the `edit()` method first with pagination disabled, and then with pagination enabled. In other words, you can generate several different `EditableDocument` representations of the single original document. Another example is generating multiple `EditableDocument` instances for a single input Spreadsheet document, where each instance represents a different worksheet of the Spreadsheet document. This is shown below.

```javascript
// Import the GroupDocs.Editor module
const groupdocsEditor = require('groupdocs-editor');
const fs = require('fs');

// Path to the input spreadsheet
const inputXlsxPath = "C://input/spreadsheet.xlsx";

// Load the spreadsheet into the Editor
const editor = new groupdocsEditor.Editor(inputXlsxPath);

// Create edit options for the first worksheet
const editOptions1 = new groupdocsEditor.SpreadsheetEditOptions();
editOptions1.setWorksheetIndex(0); // Index is 0-based, so this is the 1st worksheet
editOptions1.setExcludeHiddenWorksheets(true);

// Create edit options for the second worksheet
const editOptions2 = new groupdocsEditor.SpreadsheetEditOptions();
editOptions2.setWorksheetIndex(1); // Index is 0-based, so this is the 2nd worksheet
editOptions2.setExcludeHiddenWorksheets(false);

// Edit the first worksheet
const firstWorksheet = editor.edit(editOptions1);

// Edit the second worksheet
const secondWorksheet = editor.edit(editOptions2);

// Obtain HTML markup and resources for the first worksheet
const htmlContent1 = firstWorksheet.getContent();
const resources1 = firstWorksheet.getAllResources();

// Save the first worksheet's HTML content to a file
fs.writeFileSync('firstWorksheet.html', htmlContent1);

// Obtain HTML markup and resources for the second worksheet
const htmlContent2 = secondWorksheet.getContent();
const resources2 = secondWorksheet.getAllResources();

// Save the second worksheet's HTML content to a file
fs.writeFileSync('secondWorksheet.html', htmlContent2);
```

When the `EditableDocument` instance is ready, it can emit HTML markup, CSS markup, and other resources in different forms for passing them to the client-side WYSIWYG HTML editor or any other application that can edit HTML documents. This is briefly shown in the example below.

```javascript
// Edit the document
const document = editor.edit();

// Get the body content of the HTML
const bodyContent = document.getBodyContent();

// Get only the images from the document resources
const onlyImages = document.getImages();

// Get all resources (images, stylesheets, fonts, etc.)
const allResourcesTogether = document.getAllResources();

// Optionally, save the body content to a file
fs.writeFileSync('bodyContent.html', bodyContent);
```

For more information about obtaining HTML markup and resources from `EditableDocument`, please visit the following articles:

- [Get HTML Markup in Different Forms](/editor/nodejs-java/developer-guide/editabledocument/get-html-markup-in-different-forms)
- [Working with Resources](/editor/nodejs-java/developer-guide/editabledocument/working-with-resources)
- [Save HTML to Folder](/editor/nodejs-java/developer-guide/editabledocument/save-html-to-folder)


---

## Evaluation Limitations and Licensing

Path: /classification/net/evaluation-limitations-and-licensing/

## Evaluation Limitations

You can easily download GroupDocs.Classification for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license:  

*   Texts with more than 200 characters are not supported.
*   Documents with more than 200 characters are not supported.
*   For the sentiment classification this limitations are 100 for English and 30 Chinese.

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Classification API if you want to avoid its evaluation limitations.   
The license can be loaded from a file or stream object.

#### Setting License from File

The code below will explain how to set product license.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-classification/GroupDocs.Classification-for-.NET

// Setup license.

License license = new License();

license.SetLicense(licensePath);
```

#### Setting License from Stream

The following example shows how to load a license from a stream.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-classification/GroupDocs.Classification-for-.NET

using (FileStream fileStream = File.OpenRead("GroupDocs.Classification.lic"))
{
    License license = new License();

    license.SetLicense(fileStream);
}
```

Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Classification classes. 

When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application\_Start protected method. It is called once when the application starts.   
Do not call License.SetLicense from within Page\_Load methods since it means the license will be loaded every time a web page is loaded.

---

## Evaluation Limitations and Licensing

Path: /metadata/java/evaluation-limitations-and-licensing/

{{< alert style="info" >}}GroupDocs.Metadata also works without the license in trial mode with certain limitations{{< /alert >}}

## Evaluation version limitations

You can easily download GroupDocs.Metadata for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| API | Limitations |
| --- | --- |
| Document properties (Pdf, Word, Excel, PowerPoint, Visio, etc) | Only first 5 properties can be read |
| XMP API | Only first 2 XMP schemes can be read |
| EXIF API | GPS IFD and image thumbnail are unavailable  
Only first 5 properties can be read |
| IPTC API | Only first 5 properties can be read |
| Id3v2, Lyrics3, APEv2 tags | Only first 5 properties can be read |
| QuickTime atoms | Only first 5 atoms can be read |
| File open | Open maximum 15 files, otherwise, API throws exception |
| File save | Not supported in trial mode |

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Metadata API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object.

### Applying license from file

The code below will explain how to apply a  product license.

```csharp
// initialize License
License lic = new License();

// apply license
lic.setLicense("D:\\GroupDocs.Metadata.lic");

```

### Applying license from stream

The following example shows how to load a license from a stream.

```csharp
try (InputStream stream = new FileInputStream("D:\\GroupDocs.Metadata.lic")) {
	License license = new License();
	license.setLicense(stream);
}
```

{{< alert style="info" >}}
Calling [License.setLicense](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.licensing/License#setLicense(java.lang.String)) multiple times is not harmful but simply wastes processor time. It is called once when the application starts.
{{< /alert >}}

### Applying Metered license

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.licensing/Metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to `[setMeteredKey](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.licensing/Metered#setMeteredKey(java.lang.String,%20java.lang.String))` method.
3.  Do processing (perform task).
4.  call method `[getConsumptionQuantity](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.licensing/Metered#getConsumptionQuantity())` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  call method `[getConsumptionCredit](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.licensing/Metered#getConsumptionCredit())` of the `Metered` class (Since version 19.5).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

```csharp
// initialize Metered API
Metered metered = new Metered();

// set-up credentials
metered.setMeteredKey("publicKey", "privateKey");

```

---

## Evaluation Limitations and Licensing

Path: /search/java/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Search without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Version Limitations

You can easily download GroupDocs.Search for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

### Indexing Limitations

Following are the indexing limitations user will face while using the trial version of the **GroupDocs.Search API**:

*   Total number of indexed documents in one index or in several indexes for index repository cannot exceed 100 files.
*   Indexing stops when number of indexed documents in an index or in all indexes in index repository becomes 100.
*   All changed files can be updated in an index during Update.
*   New files can only be added to an index during update if total number of indexed documents is less than 100.

### Searching Limitations

Only first 10 documents returned in search result.

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Search API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Search.dll file and specify the file name, without a path, as shown in the examples below.

### Applying License from File

The code below will explain how to apply product license.



```java
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Search-for-Java

//initialize License
License lic = new License();

//Set license
lic.setLicense("GroupDocs.Search.lic");
```

### Applying License from Stream

The following example shows how to load a license from a stream.



```java
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Search-for-Java
Path fileLocation = Paths.get("GroupDocs.Search.lic");
 
try {
    byte[] data = Files.readAllBytes(fileLocation);
    ByteArrayInputStream inputStream = new ByteArrayInputStream(data);
 
    License lic = new License();
    lic.setLicense(inputStream);
} catch (IOException e) {
    System.out.println(e.getMessage());
}
```

### Applying Metered License

{{< alert style="info" >}}
You can also set Metered license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the **`Metered`**class.

1.  Create an instance of **`Metered` **class.
2.  Pass public & private keys to **s`etMeteredKey`** method.
3.  Do processing (perform task).
4.  Call method **g`etConsumptionQuantity` **of the **`Metered` **class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  Call method **g`etConsumptionCredit` **of the **`Metered` **class (Since version 19.5).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use **`Metered`** class.



```java
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Search-for-Java
 
String indexPath = "c:\\MyIndex";
String documentsPath = "c:\\MyDocuments";
String PublicKey = ""; // Your public license key
String PrivateKey = ""; // Your private license key
Metered metered = new Metered();
 
try {
    metered.setMeteredKey(PublicKey, PrivateKey);
} catch (Exception e) {
    System.out.println(e.getMessage());
}
 
// Do indexing and searching in licensed mode 
Index index = new Index(indexPath);
 
// Adding documents to index
index.add(documentsPath);
 
// Searching
SearchResult result = index.search("arbitrary");
 
// Get consumption quantity
try {
    double consumptionQuantitiy = Metered.getConsumptionQuantity();
} catch (Exception e) {
    System.out.println(e.getMessage());
}
 
// Get consumption credit
try {
    double consumptionCredit = Metered.getConsumptionCredit();
} catch (Exception e) {
    System.out.println(e.getMessage());
}
```

---

## Evaluation Limitations and Licensing

Path: /search/net/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Search without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Version Limitations

You can easily download GroupDocs.Search for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

### Indexing Limitations

Following are the indexing limitations user will face while using the trial version of the **GroupDocs.Search API**:

*   Total number of indexed documents in one index or in several indexes for index repository cannot exceed 100 files.
*   Indexing stops when number of indexed documents in an index or in all indexes in index repository becomes 100.
*   All changed files can be updated in an index during Update.
*   New files can only be added to an index during update if total number of indexed documents is less than 100.

### Searching Limitations

Only first 10 documents returned in search result.

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Search API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Search.dll file and specify the file name, without a path, as shown in the examples below.

### Applying License from File

The code below will explain how to apply product license.

**C#**

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Search-for-.NET

//initialize License
License lic = new License();

//Set license
lic.SetLicense("GroupDocs.Search.lic");
```

### Applying License from Stream

The following example shows how to load a license from a stream.

**C#**

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Search-for-.NET
using (FileStream fileStream = new FileStream("GroupDocs.Search.lic", FileMode.Open, FileAccess.Read))
{
    License lic = new License();
    lic.SetLicense(fileStream);
}
```

{{< alert style="info" >}}Calling License.SetLicense multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Search classes.When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application_Start protected method. It is called once when the application starts. Do not call License.SetLicense from within Page_Load methods since it means the license will be loaded every time a web page is loaded.{{< /alert >}}

### Applying Metered License

{{< alert style="info" >}}
You can also set [Metered](https://reference.groupdocs.com/net/search/groupdocs.search/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
{{< /alert >}}

Here are the simple steps to use the `Metered` class.

1.  Create an instance of `Metered` class.
2.  Pass public & private keys to S`etMeteredKey` method.
3.  Do processing (perform task).
4.  Call method G`etConsumptionQuantity` of the `Metered` class.
5.  It will return the amount/quantity of API requests that you have consumed so far.
6.  Call method G`etConsumptionCredit` of the `Metered` class (Since version 19.5).
7.  It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use `Metered` class.

**C#**

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-search/GroupDocs.Search-for-.NET
string PublicKey = ""; // Your public license key
string PrivateKey = ""; // Your private license key
Metered metered = new Metered();
metered.SetMeteredKey(PublicKey, PrivateKey);

// Do indexing and searching in licensed mode 
Index index = new Index(indexPath);

// Adding documents to index
index.AddToIndex(documentsPath);

// Searching
SearchResults results = index.Search("arbitrary");

// Get consumption quantity
decimal consumptionQuantitiy = GroupDocs.Search.Metered.GetConsumptionQuantity();

// Get consumption credit
decimal consumptionCredit = GroupDocs.Search.Metered.GetConsumptionCredit();
```

---

## Evaluation Limitations and Licensing

Path: /search/nodejs-java/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Search without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

## Evaluation Version Limitations

You can easily download GroupDocs.Search for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

### Indexing Limitations

Following are the indexing limitations user will face while using the trial version of the **GroupDocs.Search API**:

*   Total number of indexed documents in one index or in several indexes for index repository cannot exceed 100 files.
*   Indexing stops when number of indexed documents in an index or in all indexes in index repository becomes 100.
*   All changed files can be updated in an index during Update.
*   New files can only be added to an index during update if total number of indexed documents is less than 100.

### Searching Limitations

Only first 10 documents returned in search result.

## Licensing 

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Search API if you want to avoid its evaluation limitations. 

The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Search.dll file and specify the file name, without a path, as shown in the examples below.

### Applying License from File

The code below will explain how to apply product license.

```javascriptscript
const licensePath = "path to the .lic file";
const license = new groupdocs.search.License()
license.setLicense(licensePath);
```

### Applying License from Stream

The following example shows how to load a license from a stream.

```javascriptscript
const java = require('java');
let InputStream = java.import('java.io.FileInputStream');

const licensePath = "path to the .lic file";
const stream = new InputStream(licensePath);
const license = new groupdocs.search.License();
await license.setLicense(stream);
```

---

## Evaluation Limitations and Licensing

Path: /watermark/java/evaluation-limitations-and-licensing/

{{< alert style="info" >}}You can use GroupDocs.Watermark without the license. The usage and functionalities are pretty much same as the licensed one but you will face few limitations while using the non-licensed API.{{< /alert >}}

# Evaluation version limitations

You can easily download GroupDocs.Watermark for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.  

| API Feature | Limitation |
| --- | --- |
| Document loading | Only 10 documents can be loaded per application run.    |
| Watermark search/removing | Removing/replacing of document parts is not allowed in evaluation mode.  |
| Watermark adding | Only 1 watermark can be added to a document per editing session.  |
| Document saving | Evaluation warning watermark will be added to a document.  |

## Licensing

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Watermark API if you want to avoid its evaluation limitations.   
The license can be loaded from a file or stream object.

### Setting license from file

The code below will explain how to [set](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/License#setLicense(java.lang.String)) product [license](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/License) from a file.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java
//initialize License
License lic = new License();

//Set license
lic.setLicense("GroupDocs.Watermark.lic");
```

### Setting license from stream

The following example shows how to [load](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/License#setLicense(java.io.InputStream)) a [license](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/License) from a stream.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java
Path fileLocation = Paths.get("GroupDocs.Watermark.lic");
try {
    byte[] data = Files.readAllBytes(fileLocation);
    ByteArrayInputStream inputStream = new ByteArrayInputStream(data);
 
    License lic = new License();
    lic.setLicense(inputStream);
} catch (IOException e) {
    System.out.println(e.getMessage());
}
```

{{< alert style="info" >}}
Calling [License.setLicense](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/License#setLicense(java.io.InputStream)) multiple times is not harmful but simply wastes processor time. If you are developing a Windows or console application, call [License.setLicense](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/License#setLicense(java.io.InputStream)) in your startup code, before using GroupDocs.Watermark classes.
{{< /alert >}}

### Setting metered license
You can also set [Metered](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.
Here are the simple steps to use the [Metered](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered) class.
*       Create an instance of [Metered](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered) class.
*       Pass public & private keys to [setMeteredKey](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered#setMeteredKey(java.lang.String,%20java.lang.String)) method.
*       Do processing (perform task).
*       Call method [getConsumptionQuantity](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered#getConsumptionQuantity()) of the [Metered](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered) class.
*       It will return the amount/quantity of API requests that you have consumed so far.
*       Call method [getConsumptionCredit](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered#getConsumptionCredit()) of the [Metered](https://reference.groupdocs.com/watermark/java/com.groupdocs.watermark.licensing/Metered) class.
*       It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to set metered public and private keys.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java
string PublicKey = ""; // Your public license key
string PrivateKey = ""; // Your private license key
Metered metered = new Metered();
try {
    metered.setMeteredKey(PublicKey, PrivateKey);
} catch (Exception e) {
    System.out.println(e.getMessage());
}

// Get amount (MB) consumed
double amountConsumed = Metered.getConsumptionQuantity();
 
// Get count of credits consumed
double creditsConsumed = Metered.getConsumptionCredit();
```

---

## Extend supported extensions list

Path: /redaction/net/extend-supported-extensions-list/

This method can be used when for some reason files have non-standard extensions or if its format is supported, but not pre-configured. For instance, all kinds of plain text files (batch, command files, etc.) could be opened. In this case you do not need to create your own format handler. As it is shown below, you can add file extension (e.g. ".dump") as being handled by the same *[DocumentFormatInstance](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/documentformatinstance)* as all plain text files:

**C#**

```csharp
var config = RedactorConfiguration.GetInstance();
var settings = config.FindFormat(".txt");
settings.ExtensionFilter = settings.ExtensionFilter + ",.dump";
using (Redactor redactor = new Redactor(@"C:\sample.dump"))
{
   // Here we can use the document instance to perform redactions
}
```

In detail, creating your own document format instances is covered in another article.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Extend supported extensions list

Path: /redaction/python-net/extend-supported-extensions-list/

This method can be used when for some reason files have non-standard extensions or if its format is supported, but not pre-configured. For instance, all kinds of plain text files (batch, command files, etc.) could be opened. In this case you do not need to create your own format handler. As it is shown below, you can add file extension (e.g. ".dump") as being handled by the same *[DocumentFormatInstance](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.integration/documentformatinstance/)* as all plain text files:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.redaction.configuration as grc

def run():

    # Add .dump format to the list of supported formats
    config = grc.RedactorConfiguration.get_instance()

    settings = config.find_format(".txt")

    settings.extension_filter = settings.extension_filter + ",.dump";

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[redacted]")
    ex_red = grr.ExactPhraseRedaction("dolor", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.dump") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the redacted document
        redactor.save()
```

In detail, creating your own document format instances is covered in another article.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Extract emails from remote server via POP IMAP or Exchange Web Services protocols

Path: /parser/java/extract-emails-from-remote-server-via-pop-imap-or-exchange-web-services-protocols/

GroupDocs.Parser provides the functionality to extract emails from remote servers. The following email protocols are supported:

*   Post Office Protocol (POP)
*   Internet Message Access Protocol (IMAP)
*   Exchange Web Services (EWS)

To create an instance of [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) class to extract emails from a remote server the following constructor is used:

```java
Parser(EmailConnection connection);
Parser(EmailConnection connection, ParserSettings parserSettings)
```

The second constructor allows to use [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ParserSettings) object to control the process; for example, by adding logging functionality.

[EmailConnection](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/EmailConnection) is a base class. The following connection classes are used:

| Protocol | Class |
| --- | --- |
| Exchange Web Services | [EmailEwsConnection](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/EmailEwsConnection) |
| IMAP | [EmailImapConnection](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/EmailImapConnection) |
| POP | [EmailPopConnection](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/EmailPopConnection) |

Here are the steps to extract emails from the remote server:

*   Prepare connection string (see table below);
*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object with connection string;
*   Call [isContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isContainer())  property to check if container extraction is supported;
*   Call [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and obtain collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects;
*   Iterate through the collection and get [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for each item.

The following example shows how to extract emails from Exchange Server:

```java
// Create the connection object for Exchange Web Services protocol
EmailConnection connection = new EmailEwsConnection(
        "https://outlook.office365.com/ews/exchange.asmx",
        "email@server",
        "password");
// Create an instance of Parser class to extract emails from the remote server
try (Parser parser = new Parser(connection)) {
    // Check if container extraction is supported
    if (!parser.getFeatures().isContainer()) {
        System.out.println("Container extraction isn't supported.");
        return;
    }
    // Extract email messages from the server
    Iterable<ContainerItem> emails = parser.getContainer();
    // Iterate over attachments
    for (ContainerItem item : emails) {
        // Create an instance of Parser class for email message
        try (Parser emailParser = item.openParser()) {
            // Extract the email text
            try (TextReader reader = emailParser.getText()) {
                // Print the email text
                System.out.println(reader == null ? "Text extraction isn't supported." : reader.readToEnd());
            }
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract emails from remote server via POP IMAP or Exchange Web Services protocols

Path: /parser/net/extract-emails-from-remote-server-via-pop-imap-or-exchange-web-services-protocols/

GroupDocs.Parser allows you to extract emails from remote servers and data from the emails. The following email protocols are supported:

*   Post Office Protocol (POP)
*   Internet Message Access Protocol (IMAP)
*   Exchange Web Services (EWS)

To create an instance of [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) class to extract emails from a remote server the following constructors are used:

```csharp
Parser(EmailConnection connection);
Parser(EmailConnection connection, ParserSettings parserSettings);
```

The second constructor allows to use [ParserSettings](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/parsersettings) object to control the process; for example, by adding [logging functionality]({{< ref "parser/net/developer-guide/advanced-usage/logging.md" >}}).

[EmailConnection](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/emailconnection) is a base class. The following connection classes are used:

| Protocol | Class |
| --- | --- |
| POP | [EmailPopConnection](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/emailpopconnection) |
| IMAP | [EmailImapConnection](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/emailimapconnection) |
| Exchange Web Services | [EmailEwsConnection](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/emailewsconnection) |

Here are the steps to extract emails from the remote server:

*   Prepare connection string (see table below);
*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object with connection string;
*   Call [Features.Container](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/container) property to check if container extraction is supported;
*   Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain collection of document container item objects;
*   Iterate through the collection and get [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for each item.

The following example shows how to extract emails from Exchange Server:

```csharp
// Create the connection object for Exchange Web Services protocol 
EmailConnection connection = new EmailEwsConnection(
    "https://outlook.office365.com/ews/exchange.asmx",
    "email@server",
    "password");
 
// Create an instance of Parser class to extract emails from the remote server
using (Parser parser = new Parser(connection))
{
    // Check if container extraction is supported
    if (!parser.Features.Container)
    {
        Console.WriteLine("Container extraction isn't supported.");
        return;
    }
 
    // Extract email messages from the server
    IEnumerable<ContainerItem> emails = parser.GetContainer();
 
    // Iterate over attachments
    foreach (ContainerItem item in emails)
    {
        // Create an instance of Parser class for email message
        using (Parser emailParser = item.OpenParser())
        {
            // Extract the email text
            using (TextReader reader = emailParser.GetText())
            {
                // Print the email text
                Console.WriteLine(reader == null ? "Text extraction isn't supported." : reader.ReadToEnd());
            }
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract formatted text from documents

Path: /parser/java/extract-formatted-text-from-documents/

GroupDocs.Parser allows to extract formatted text from documents for those cases when simple plain text is not enough and you may need to keep formatting like text style, table layout etc.

This feature allows to extract text with integrated HTML tags, or Markdown syntax. Even PlainText mode allows to convert your documents to high quality text with integrated ASCII formatting symbols for tables, lists etc.

# Extract formatted text from documents

To extract a formatted text from documents simply call the [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method:

```java
TextReader getFormattedText(FormattedTextOptions options);
```

This method returns an instance of [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class with an extracted text. [FormattedTextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextOptions) has the following constructor:

```java
FormattedTextOptions(FormattedTextMode mode);
```

[FormattedTextMode](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextMode) enumeration has the following members:

| Member | Description |
| --- | --- |
| [Html](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextMode#Html) | HTML format. |
| [Markdown](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextMode#Markdown) | Markdown format. |
| [PlainText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextMode#PlainText) | Plain text format. |

[TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) class extends  [*java.io.Reader*](http://docs.oracle.com/javase/7/docs/api/java/io/Reader.html?is-external=true) and adds the following members:

| Member | Description |
| --- | --- |
| [readLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readLine()) | Reads a line of characters from the text reader and returns the data as a string. |
| [readToEnd](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader#readToEnd()) | Reads all characters from the current position to the end of the text reader and returns them as one string. |

Here are the steps to extract a HTML formatted text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [FormattedTextOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/FormattedTextOptions) with HTML text mode;
*   Call [getFormattedText(FormattedTextOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getFormattedText(com.groupdocs.parser.options.FormattedTextOptions)) method and obtain [TextReader](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TextReader) object;
*   Check if *reader* isn't *null* (formatted text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract a document text as HTML text:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract a formatted text into the reader
    try (TextReader reader = parser.getFormattedText(new FormattedTextOptions(FormattedTextMode.Html))) {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        System.out.println(reader == null ? "Formatted text extraction isn't suppported" : reader.readToEnd());
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract formatted text from documents

Path: /parser/net/extract-formatted-text-from-documents/

GroupDocs.Parser allows to extract formatted text from documents for those cases when simple plain text is not enough and you may need to keep formatting like text style, table layout etc.

This feature allows to extract text with integrated HTML tags, or Markdown syntax. Even PlainText mode allows to convert your documents to high quality text with integrated ASCII formatting symbols for tables, lists etc.

## Extract formatted text from documents

To extract a formatted text from documents simply call the [GetFormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method:

```csharp
TextReader GetFormattedText(FormattedTextOptions options);

```

Methods return an instance of [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) class with an extracted text. [FormattedTextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextoptions) has the following constructor:

```csharp
FormattedTextOptions(FormattedTextMode mode)

```

[FormattedTextMode](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextmode) enumeration has the following members:

| Member | Description |
| --- | --- |
| Html | Html format. |
| Markdown | Markdown format. |
| PlainText | Plain text format. |

Here are the steps to extract a HTML formatted text from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [FormattedTextOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/formattedtextoptions) with HTML text mode;
*   Call [GetFormattedText](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getformattedtext) method and obtain [TextReader](https://docs.microsoft.com/en-us/dotnet/api/system.io.textreader?view=netframework-2.0) object;
*   Check if *reader* isn't *null* (formatted text extraction is supported for the document);
*   Read a text from *reader*.

The following example shows how to extract formatted text from a document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract formatted text as HTML
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Html)))
    {
        // If formatted text extraction isn't supported, reader is null
        Console.WriteLine(reader == null ? "Formatted text extraction isn't supported" : reader.ReadToEnd());
    }
}
```

## More resources

### Advanced usage topics

To learn more about text extraction features, please refer the [advanced help section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/working-with-formatted-text/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online text extractor App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract text from your documents with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract pages

Path: /merger/java/extract-pages/

## Extract pages 

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to extract pages from source document. The result is a new document that contains only specified pages from the source document.

Here are the steps to extract document pages:

*   Initialize [ExtractOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/ExtractOptions) class with page numbers that should appear in the resultant document;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [extractPages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#extractPages(com.groupdocs.merger.domain.options.interfaces.IExtractOptions)) method and pass [ExtractOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/ExtractOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to extract document pages **by specifying exact page numbers**:

```java
String filePath = "c:\sample.pdf";
String filePathOut = "c:\output\result.pdf";

ExtractOptions extractOptions = new ExtractOptions(new int[] { 1, 4 }); // Resultant document will contain pages 1 and 4

Merger merger = new Merger(filePath);
merger.extractPages(extractOptions);
merger.save(filePathOut);
```

The following code sample demonstrates how to extract document pages **by specifying page numbers range**:

```java
String filePath = "c:\sample.pdf";
String filePathOut = "c:\output\result.pdf";

ExtractOptions extractOptions = new ExtractOptions(1, 3, RangeMode.EvenPages); // Resultant document will contain page 2

Merger merger = new Merger(filePath);
merger.extractPages(extractOptions);
merger.save(filePathOut);
```

---

## Extract pages

Path: /merger/nodejs-java/extract-pages/

## Extract pages 

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to extract pages from source document. The result is a new document that contains only specified pages from the source document.

Here are the steps to extract document pages:

*   Initialize [ExtractOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/ExtractOptions) class with page numbers that should appear in the resultant document;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [extractPages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#extractPages(com.groupdocs.merger.domain.options.interfaces.IExtractOptions)) method and pass [ExtractOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/ExtractOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to extract document pages **by specifying exact page numbers**:

```js
const inputFilePath = `c:/sample.pdf`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output/result.pdf`;
const java = require('java');
const pageArray = java.newArray('int', [1, 3]);
const extractOptions = new groupdocs.merger.ExtractOptions(pageArray);
merger.extractPages(extractOptions);
merger.save(outputPath);
```

The following code sample demonstrates how to extract document pages **by specifying page numbers range**:

```js
const inputFilePath = `c:/sample.pdf`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output/result.pdf`;
const evenPages = groupdocs.merger.RangeMode.EvenPages;
const extractOptions = new groupdocs.merger.ExtractOptions(1, 3, evenPages);
merger.extractPages(extractOptions);
merger.save(outputPath);
```

---

## Extract pages

Path: /merger/python-net/extract-pages/

## Extract pages 

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to extract pages from source document. The result is a new document that contains only specified pages from the source document.

Here are the steps to extract document pages:

*   Initialize [ExtractOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/ExtractOptions) class with page numbers that should appear in the resultant document;
*   Instantiate [Merger](https://reference.groupdocs.com/net/merger/groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [extractPages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/extractpages/) method and pass [ExtractOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/ExtractOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method specifying file path to save resultant document.

The following code sample demonstrates how to extract document pages **by specifying exact page numbers**:

```python
with gm.Merger("c:/sample.pdf") as merger:
    extract_options = gm.domain.options.ExtractOptions(1, 2)
    merger.extract_pages(extract_options)
    merger.save("c:/result.pdf")
```

The following code sample demonstrates how to extract document pages **by specifying page numbers range**:

```python
with gm.Merger("c:/sample.pdf") as merger:
    even_pages = gm.domain.options.RangeMode.EVENPAGES
    extract_options = gm.domain.options.ExtractOptions(1, 3, even_pages)
    merger.extract_pages(extract_options)
    merger.save("c:/result.pdf")
```

---

## Extract table of contents from Microsoft Office Word documents

Path: /parser/java/extract-table-of-contents-from-microsoft-office-word-documents/

To extract table of contents from Microsoft Office Word document [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method is used. Table of contents is generated by paragraphs with H1-H9 build-in styles.

{{< alert style="warning" >}}[getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method returns null value if table of contents extraction isn't supported for the document. For example, table of contents extraction isn't supported for TXT files. Therefore, for TXT file [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method returns null. If Microsoft Office Word document has no table of contents, [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method returns an empty collection.{{< /alert >}}

[getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method returns a collection of [TocItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem) objects. [extractText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem#extractText()) method returns a text from the chapter to which table of contents item refers (without sub-chapters). For example, "Heading 1.2" from the page

![](/parser/java/images/extract-table-of-contents-from-microsoft-office-word-documents.png)

returns the following text:

![](/parser/java/images/extract-table-of-contents-from-microsoft-office-word-documents_1.png)

"Heading 2" from the page:

![](/parser/java/images/extract-table-of-contents-from-microsoft-office-word-documents_2.png)

returns the following text:

![](/parser/java/images/extract-table-of-contents-from-microsoft-office-word-documents_3.png)

{{< alert style="warning" >}}java.lang.UnsupportedOperationException is thrown if getPageIndex() is null.{{< /alert >}}

Here are the steps to extract a text by an item of table of contents:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method and obtain the collection of [TocItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem) objects;
*   Iterate through the collection and extract a text.

The following example shows how to extract a text by an item of table of contents:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocxWithToc)) {
    // Get table of contents
    Iterable<TocItem> tocItems = parser.getToc();
    // Iterate over items
    for (TocItem tocItem : tocItems) {
        // Print the text of the chapter
        try (TextReader reader = tocItem.extractText()) {
            System.out.println("----");
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract Table of Contents from Microsoft Office Word Documents

Path: /parser/net/extract-table-of-contents-from-microsoft-office-word-documents/


## Overview

This guide explains how to extract the table of contents (TOC) from Microsoft Office Word documents (`.doc`, `.docx`) using GroupDocs.Parser for .NET. The TOC is automatically generated by detecting paragraphs with built-in heading styles (H1-H9)


## How TOC Extraction Works

The [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method analyzes your Word document and identifies all headings formatted with built-in heading styles. It returns a structured collection of TOC items that you can navigate programmatically.

To extract table of contents from Microsoft Office Word document [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method is used. Table of contents is generated by paragraphs with H1-H9 build-in styles.

{{< alert style="warning" >}}
[GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method returns *null* value if table of contents extraction isn't supported for the document. For example, table of contents extraction isn't supported for TXT files. Therefore, for TXT file [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method returns *null*. If Microsoft Office Word document has no table of contents, [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method returns an empty collection.
{{< /alert >}}

[GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method returns a collection of [TocItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem) objects. [TocItem.GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/methods/gettext) method returns a text from the chapter to which table of contents item refers (without sub-chapters). For example, "Heading 1.2" from the page

![](/parser/net/images/extract-table-of-contents-from-microsoft-office-word-documents.png)

returns the following text:

![](/parser/net/images/extract-table-of-contents-from-microsoft-office-word-documents_1.png)

"Heading 2" from the page:

![](/parser/net/images/extract-table-of-contents-from-microsoft-office-word-documents_2.png)

returns the following text:

![](/parser/net/images/extract-table-of-contents-from-microsoft-office-word-documents_3.png)

{{< alert style="warning" >}}
[InvalidOperationException](https://docs.microsoft.com/en-us/dotnet/api/system.invalidoperationexception?view=netframework-2.0) is thrown if [tocItem.PageIndex](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/properties/pageindex) is *null*.
{{< /alert >}}

Here are the steps to extract a text by an item of table of contents:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method and obtain the collection of [TocItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem) objects;
*   Iterate through the collection and extract a text.

The following example shows how to extract a text by an item of table of contents:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleDocxWithToc))
{
    // Get table of contents
    IEnumerable<TocItem> tocItems = parser.GetToc();
    // Iterate over items
    foreach (TocItem tocItem in tocItems)
    {
        // Print the text of the chapter
        using (TextReader reader = tocItem.ExtractText())
        {
            Console.WriteLine("----");
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
```
## Practical Use Cases

*   Document analysis: Quickly scan document structure and content
*   Content extraction: Pull specific sections based on headings
*   Navigation building: Create custom navigation systems for documents
*   Content validation: Verify document structure and heading hierarchy

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text structure

Path: /parser/java/extract-text-structure/

GroupDocs.Parser provides the functionality to extract the text structure from documents by the GetStructure method:

```java
XmlReader GetStructure();
```

This method returns XML representation of a document. A document has the following structure:

![](/parser/java/images/extract-text-structure.png)

| Tag | Description |
| --- | --- |
| document | The root tag |
| section | Represents a section of the document. Depending on the document type, it can represent a worksheet, a slide and so on. Can contain the following attributes:<ul><li>style - the style of the section</li><li>name - the name of the section (for example, the name of the sheet)</li></ul> |
| p | Represents a text paragraph. Can contain the following attribute:<ul><li>style - the style of paragraph |
| ul | Represents an unordered list |
| ol | Represents an ordered list |
| li | Represents a list item |
| shape | Represents a shape object. |
| table | Represents a table |
| tr | Represents a table row |
| td | Represents a table cell. Can contain the following attributes:<ul><li>rowIndex - the zero-based index of the row</li><li>columnIndex - the zero-based index of the column</li><li>rowSpan - the total number of rows that contain the table cell</li><li>columnSpan - the total number of columns that contain the table cell</li></ul> |

Tags have the following relations:

*   **document** tag can contain any number of section tags
*   **section** tag can contain any number of **p, ul, ol** or **table** tags in any sequence
*   **table** tag can contain any number of **tr** tags
*   **tr** tag can contain any number of **td** tags
*   **td** tag can contain one **p** tag

The **p** and **li** tags can contain **hyperlink, strong, em** tags and the value that represents a text:

![](/parser/java/images/extract-text-structure_1.png))![](/parser/java/images/extract-text-structure_2.png)

| Tag | Description |
| --- | --- |
| hyperlink | Represents a hyperlink. Can contain the following attribute:<ul><li>link - URL</li></ul> |
| strong | Represents a strong emphasis (bold text) |
| em | Represents a regular emphasis (italic text) |
| br | Represents a line break (empty tag) |

## Features of text extraction for different formats

### Word processing documents

Word processing documents have a more complex table cell and paragraph can contain any number of shapes.

A table cell can contain any number of paragraphs, lists and tables:

![](/parser/java/images/extract-text-structure_3.png)

A shape can contain a single hyperlink (empty tag) for the entire shape and any number of paragraphs, lists or tables:

![](/parser/java/images/extract-text-structure_4.png)

### Presentations

Presentations have a more complex table cell and section can contain any number of shapes.

A table cell can contain any number of paragraphs or lists:

![](/parser/java/images/extract-text-structure_5.png)

A shape can contain a single hyperlink (empty tag) for the entire shape and any number of paragraphs or lists:

![](/parser/java/images/extract-text-structure_6.png)

### Spreadsheets

Spreadsheets have the following document structure:

![](/parser/java/images/extract-text-structure_7.png)

It's more simple than others. A section can contain any number of shapes and only one table. A shape can contain a single hyperlink (empty tag) for the entire shape and any numbers of paragraphs.

## Examples

Here are the steps to extract hyperlinks from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getStructure](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getStructure()) method and obtain [*org.w3c.dom.Document*](https://docs.oracle.com/javase/7/docs/api/org/w3c/dom/Document.html?is-external=true) object;
*   Check if *document* isn't *null* (text structure extraction is supported for the document);
*   Process the XML document.

The following example shows how to extract hyperlinks from the document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleHyperlinksDocx)) {
    // Extract text structure to the XML reader
    Document document = parser.getStructure();
    // Check if text structure extraction is supported
    if (document == null) {
        System.out.println("Text structure extraction isn't supported.");
        return;
    }
    // Read XML document
    readNode(document.getDocumentElement());
}

private static void readNode(Node node) {
    NodeList nodes = node.getChildNodes();
    for (int i = 0; i < nodes.getLength(); i++) {
        Node n = nodes.item(i);
        if (n.getNodeName().toLowerCase() == "hyperlink") {
            Node a = n.getAttributes().getNamedItem("link");
            if (a != null) {
                System.out.println(a.getNodeValue());
            }
        }
        if(n.hasChildNodes()) {
            readNode(n);
        }
    }
}
```

The following document:

![](/parser/java/images/extract-text-structure_8.png)

has the following text structure:

```xml
<?xml version="1.0"?>
<document>
  <section>
    <p style="HEADING1">
      <shape>
        <p style="HEADING1">
          Lorem ipsum dolor sit amet, <hyperlink link="google.com">consectetuer</hyperlink> adipiscing elit. Maecenas porttitor congue massa.
        </p>
      </shape>Lorem
    </p>
    <p>
      Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Maecenas porttitor congue massa. Fusce posuere, magna sed <hyperlink link="bing.com">pulvinar ultricies</hyperlink>, purus lectus <strong>malesuada</strong> libero, sit amet commodo magna eros quis urna.
    </p>
    <ol>
      <li>Nunc viverra imperdiet enim. </li>
      <li>Fusce est.</li>
    </ol>
    <p>Vivamus a tellus. </p>
    <ul>
      <li>
        Pellentesque <em>
          <strong>habitant morbi tristique senectus et netus et</strong>
        </em> malesuada fames ac turpis egestas.
      </li>
      <li>Proin pharetra nonummy pede. </li>
      <li>Mauris et orci. </li>
      <li>Aenean nec lorem.</li>
    </ul>
    <table>
      <tr>
        <td rowIndex="0" columnIndex="0" rowSpan="1" columnSpan="1">
          <p>In porttitor.</p>
        </td>
        <td rowIndex="0" columnIndex="1" rowSpan="1" columnSpan="1">
          <p>
            Donec laoreet <strong>nonummy</strong> augue.
          </p>
        </td>
        <td rowIndex="0" columnIndex="2" rowSpan="1" columnSpan="1">
          <p>
            Suspendisse dui purus, <em>
              <strong>scelerisque</strong>
            </em> at, vulputate vitae, pretium mattis, nunc.
          </p>
        </td>
        <td rowIndex="0" columnIndex="3" rowSpan="1" columnSpan="1">
          <p>Mauris eget neque at sem venenatis eleifend. </p>
        </td>
      </tr>
      <tr>
        <td rowIndex="1" columnIndex="0" rowSpan="1" columnSpan="1">
          <p>Ut nonummy.</p>
        </td>
        <td rowIndex="1" columnIndex="1" rowSpan="1" columnSpan="1">
          <p>
            Fusce <hyperlink link="google.com">aliquet pede</hyperlink> non pede.
          </p>
        </td>
        <td rowIndex="1" columnIndex="2" rowSpan="1" columnSpan="1">
          <p>Suspendisse dapibus lorem pellentesque magna.</p>
        </td>
        <td rowIndex="1" columnIndex="3" rowSpan="1" columnSpan="1">
          <p>Integer nulla.</p>
        </td>
      </tr>
      <tr>
        <td rowIndex="2" columnIndex="0" rowSpan="3" columnSpan="1">
          <p>Donec blandit feugiat ligula.</p>
        </td>
        <td rowIndex="4" columnIndex="1" rowSpan="1" columnSpan="1">
          <p>
            Donec hendrerit, felis et <em>imperdiet</em> euismod, purus ipsum pretium metus, in lacinia nulla nisl eget sapien.
          </p>
        </td>
        <td rowIndex="2" columnIndex="2" rowSpan="3" columnSpan="1">
          <p>
            <strong>Donec</strong> ut est in lectus consequat consequat.
          </p>
        </td>
        <td rowIndex="2" columnIndex="3" rowSpan="3" columnSpan="1">
          <p>Etiam eget dui. Aliquam erat volutpat.</p>
        </td>
      </tr>
    </table>
    <p>Sed at lorem in nunc porta tristique. Proin nec augue.</p>
  </section>
</document>
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text structure

Path: /parser/net/extract-text-structure/

GroupDocs.Parser provides the functionality to extract the text structure from documents by the [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method:

```csharp
XmlReader GetStructure();
```

This method returns XML representation of a document. A document has the following structure:

![](/parser/net/images/extract-text-structure.png)


| Tag | Description |
| --- | --- |
| document | The root tag |
| section | Represents a section of the document. Depending on the document type, it can represent a worksheet, a slide and so on. Can contain the following attributes:<ul><li>style - the style of the section</li><li>name - the name of the section (for example, the name of the sheet)</li></ul> |
| p | Represents a text paragraph. Can contain the following attribute:<ul><li>style - the style of paragraph</li></ul> |
| ul | Represents an unordered list |
| ol | Represents an ordered list |
| li | Represents a list item |
| shape | Represents a shape object. |
| table | Represents a table |
| tr | Represents a table row |
| td | Represents a table cell. Can contain the following attributes:<ul><li>rowIndex - the zero-based index of the row</li><li>columnIndex - the zero-based index of the column</li><li>rowSpan - the total number of rows that contain the table cell</li><li>columnSpan - the total number of columns that contain the table cell</li></ul> |

Tags have the following relations:

*   **document** tag can contain any number of section tags
*   **section** tag can contain any number of **p, ul, ol** or **table** tags in any sequence
*   **table** tag can contain any number of **tr** tags
*   **tr** tag can contain any number of **td** tags
*   **td** tag can contain one **p** tag

The **p** and **li** tags can contain **hyperlink, strong, em** tags and the value that represents a text:

![](/parser/net/images/extract-text-structure_1.png))![](/parser/net/images/extract-text-structure_2.png)

| Tag | Description |
| --- | --- |
| hyperlink | Represents a hyperlink. Can contain the following attribute:<ul><li>link - URL</li></ul> |
| strong | Represents a strong emphasis (bold text) |
| em | Represents a regular emphasis (italic text) |
| br | Represents a line break (empty tag) |

## Features of text extraction for different formats

### Word processing documents

Word processing documents have a more complex table cell and paragraph can contain any number of shapes.

A table cell can contain any number of paragraphs, lists and tables:

![](/parser/net/images/extract-text-structure_3.png)

A shape can contain a single hyperlink (empty tag) for the entire shape and any number of paragraphs, lists or tables:

![](/parser/net/images/extract-text-structure_4.png)

### Presentations

Presentations have a more complex table cell and section can contain any number of shapes.

A table cell can contain any number of paragraphs or lists:

![](/parser/net/images/extract-text-structure_5.png)

A shape can contain a single hyperlink (empty tag) for the entire shape and any number of paragraphs or lists:

![](/parser/net/images/extract-text-structure_6.png)

### Spreadsheets

Spreadsheets have the following document structure:

![](/parser/net/images/extract-text-structure_7.png)

It's more simple than others. A section can contain any number of shapes and only one table. A shape can contain a single hyperlink (empty tag) for the entire shape and any numbers of paragraphs.

## Examples

Here are the steps to extract hyperlinks from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser)  object for the initial document;
*   Call [GetStructure](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getstructure) method and obtain [XmlReader](https://docs.microsoft.com/en-us/dotnet/api/system.xml.xmlreader?view=netframework-2.0) object;
*   Check if *reader* isn't null (text structure extraction is supported for the document);
*   Process the XML document.

The following example shows how to extract hyperlinks from the document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract text structure to the XML reader
    using (XmlReader reader = parser.GetStructure())
    {
        // Check if text structure extraction is supported
        if (reader == null)
        {
            Console.WriteLine("Text structure extraction isn't supported.");
            return;
        }

		// Process the XML document
        // Read the XML document to search hyperlinks
        while (reader.Read())
        {
            // Check if this is a start element with "hyperlink" name
            if (reader.NodeType == XmlNodeType.Element && reader.IsStartElement() && reader.Name.ToLowerInvariant() == "hyperlink")
            {
                // Extract "link" attribute
                string value = reader.GetAttribute("link");
                if (value != null)
                {
                    Console.WriteLine(value);
                }
            }
        }
    }
}
```

The following document:

![](/parser/net/images/extract-text-structure_8.png)

has the following text structure:

```xml
<?xml version="1.0"?>
<document>
  <section>
    <p style="HEADING1">
      <shape>
        <p style="HEADING1">
          Lorem ipsum dolor sit amet, <hyperlink link="google.com">consectetuer</hyperlink> adipiscing elit. Maecenas porttitor congue massa.
        </p>
      </shape>Lorem
    </p>
    <p>
      Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Maecenas porttitor congue massa. Fusce posuere, magna sed <hyperlink link="bing.com">pulvinar ultricies</hyperlink>, purus lectus <strong>malesuada</strong> libero, sit amet commodo magna eros quis urna.
    </p>
    <ol>
      <li>Nunc viverra imperdiet enim. </li>
      <li>Fusce est.</li>
    </ol>
    <p>Vivamus a tellus. </p>
    <ul>
      <li>
        Pellentesque <em>
          <strong>habitant morbi tristique senectus et netus et</strong>
        </em> malesuada fames ac turpis egestas.
      </li>
      <li>Proin pharetra nonummy pede. </li>
      <li>Mauris et orci. </li>
      <li>Aenean nec lorem.</li>
    </ul>
    <table>
      <tr>
        <td rowIndex="0" columnIndex="0" rowSpan="1" columnSpan="1">
          <p>In porttitor.</p>
        </td>
        <td rowIndex="0" columnIndex="1" rowSpan="1" columnSpan="1">
          <p>
            Donec laoreet <strong>nonummy</strong> augue.
          </p>
        </td>
        <td rowIndex="0" columnIndex="2" rowSpan="1" columnSpan="1">
          <p>
            Suspendisse dui purus, <em>
              <strong>scelerisque</strong>
            </em> at, vulputate vitae, pretium mattis, nunc.
          </p>
        </td>
        <td rowIndex="0" columnIndex="3" rowSpan="1" columnSpan="1">
          <p>Mauris eget neque at sem venenatis eleifend. </p>
        </td>
      </tr>
      <tr>
        <td rowIndex="1" columnIndex="0" rowSpan="1" columnSpan="1">
          <p>Ut nonummy.</p>
        </td>
        <td rowIndex="1" columnIndex="1" rowSpan="1" columnSpan="1">
          <p>
            Fusce <hyperlink link="google.com">aliquet pede</hyperlink> non pede.
          </p>
        </td>
        <td rowIndex="1" columnIndex="2" rowSpan="1" columnSpan="1">
          <p>Suspendisse dapibus lorem pellentesque magna.</p>
        </td>
        <td rowIndex="1" columnIndex="3" rowSpan="1" columnSpan="1">
          <p>Integer nulla.</p>
        </td>
      </tr>
      <tr>
        <td rowIndex="2" columnIndex="0" rowSpan="3" columnSpan="1">
          <p>Donec blandit feugiat ligula.</p>
        </td>
        <td rowIndex="4" columnIndex="1" rowSpan="1" columnSpan="1">
          <p>
            Donec hendrerit, felis et <em>imperdiet</em> euismod, purus ipsum pretium metus, in lacinia nulla nisl eget sapien.
          </p>
        </td>
        <td rowIndex="2" columnIndex="2" rowSpan="3" columnSpan="1">
          <p>
            <strong>Donec</strong> ut est in lectus consequat consequat.
          </p>
        </td>
        <td rowIndex="2" columnIndex="3" rowSpan="3" columnSpan="1">
          <p>Etiam eget dui. Aliquam erat volutpat.</p>
        </td>
      </tr>
    </table>
    <p>Sed at lorem in nunc porta tristique. Proin nec augue.</p>
  </section>
</document>
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text structure

Path: /parser/python-net/extract-text-structure/


GroupDocs.Parser provides functionality to extract the text structure from documents as an XML representation, preserving document hierarchy including sections, paragraphs, tables, and lists.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents for testing
- Understanding of XML structure

## Document structure elements

The XML structure contains the following tags:

| Tag | Description |
|-----|-------------|
| `document` | The root tag |
| `section` | Represents a section (worksheet, slide, etc.). Attributes: `style`, `name` |
| `p` | Represents a text paragraph. Attribute: `style` |
| `ul` | Represents an unordered list |
| `ol` | Represents an ordered list |
| `li` | Represents a list item |
| `shape` | Represents a shape object |
| `table` | Represents a table |
| `tr` | Represents a table row |
| `td` | Represents a table cell. Attributes: `rowIndex`, `columnIndex`, `rowSpan`, `columnSpan` |
| `hyperlink` | Represents a hyperlink. Attribute: `link` |
| `strong` | Represents bold text |
| `em` | Represents italic text |
| `br` | Represents a line break |

## Extract text structure

To extract the document structure as XML:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import xml.etree.ElementTree as ET

# Create an instance of Parser class
with Parser("./sample.docx") as parser:
    # Extract text structure
    xml_reader = parser.get_structure()
    
    # Check if structure extraction is supported
    if xml_reader is None:
        print("Text structure extraction isn't supported")
    else:
        # Read XML content
        xml_content = xml_reader
        print(xml_content)
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-structure/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns an XML representation of the document structure, or `None` if structure extraction is not supported.

## Parse and analyze document structure

To parse and analyze the XML structure:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import xml.etree.ElementTree as ET

# Create an instance of Parser class
with Parser("sample.docx") as parser:
    # Extract text structure
    xml_reader = parser.get_structure()
    
    if xml_reader is None:
        print("Structure extraction not supported")
    else:
        # Parse XML
        xml_content = xml_reader
        root = ET.fromstring(xml_content)
        
        # Count elements
        sections = root.findall('.//section')
        paragraphs = root.findall('.//p')
        tables = root.findall('.//table')
        hyperlinks = root.findall('.//hyperlink')
        
        print(f"Document Structure Analysis:")
        print(f"  Sections: {len(sections)}")
        print(f"  Paragraphs: {len(paragraphs)}")
        print(f"  Tables: {len(tables)}")
        print(f"  Hyperlinks: {len(hyperlinks)}")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-structure/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Parses the XML structure and provides statistics about document elements.

## Extract all hyperlinks from structure

To extract hyperlinks using the structure:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import xml.etree.ElementTree as ET

def extract_hyperlinks_from_structure(file_path):
    """
    Extract all hyperlinks using document structure.
    """
    with Parser(file_path) as parser:
        xml_reader = parser.get_structure()
        
        if xml_reader is None:
            print("Structure extraction not supported")
            return []
        
        # Parse XML
        xml_content = xml_reader
        root = ET.fromstring(xml_content)
        
        # Find all hyperlink elements
        hyperlinks = []
        for hyperlink in root.findall('.//hyperlink'):
            url = hyperlink.get('link', '')
            text = hyperlink.text or ''
            
            if url:
                hyperlinks.append({
                    'text': text,
                    'url': url
                })
        
        return hyperlinks

# Usage
links = extract_hyperlinks_from_structure("sample.pdf")
print(f"Found {len(links)} hyperlinks:
")
for link in links:
    print(f"  {link['text']} -> {link['url']}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-structure/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts all hyperlinks with their text and URLs from the document structure.

## Extract table structure

To analyze table structure:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import xml.etree.ElementTree as ET

def analyze_tables(file_path):
    """
    Analyze table structure in document.
    """
    with Parser(file_path) as parser:
        xml_reader = parser.get_structure()
        
        if xml_reader is None:
            print("Structure extraction not supported")
            return
        
        # Parse XML
        xml_content = xml_reader
        root = ET.fromstring(xml_content)
        
        # Find all tables
        tables = root.findall('.//table')
        
        print(f"Found {len(tables)} tables:
")
        
        for idx, table in enumerate(tables, 1):
            rows = table.findall('.//tr')
            
            print(f"Table {idx}:")
            print(f"  Rows: {len(rows)}")
            
            # Get column count from first row
            if rows:
                cells = rows[0].findall('.//td')
                print(f"  Columns: {len(cells)}")
            
            # Show cell spanning
            cells_with_span = table.findall('.//td[@rowSpan]') + table.findall('.//td[@columnSpan]')
            if cells_with_span:
                print(f"  Cells with spanning: {len(cells_with_span)}")
            
            print()

# Usage
analyze_tables("sample.xlsx")
```

{{< /tab >}}
{{< tab "sample.xlsx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.xlsx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-structure/sample.xlsx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides detailed analysis of table structures including rows, columns, and cell spanning.

## Extract formatted text

To extract text with formatting information:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import xml.etree.ElementTree as ET

def extract_formatted_text(file_path):
    """
    Extract text with formatting (bold, italic).
    """
    with Parser(file_path) as parser:
        xml_reader = parser.get_structure()
        
        if xml_reader is None:
            print("Structure extraction not supported")
            return
        
        # Parse XML
        xml_content = xml_reader
        root = ET.fromstring(xml_content)
        
        # Find formatted text
        bold_texts = root.findall('.//strong')
        italic_texts = root.findall('.//em')
        
        print("Bold text:")
        for text in bold_texts:
            if text.text:
                print(f"  - {text.text}")
        
        print("\nItalic text:")
        for text in italic_texts:
            if text.text:
                print(f"  - {text.text}")

# Usage
extract_formatted_text("sample.docx")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-structure/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts all bold and italic text from the document.

## Save structure to file

To save the XML structure to a file:
{{< tabs "example-6" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def save_structure_to_file(file_path, output_xml):
    """
    Extract and save document structure to XML file.
    """
    with Parser(file_path) as parser:
        xml_reader = parser.get_structure()
        
        if xml_reader is None:
            print("Structure extraction not supported")
            return False
        
        # Read and save XML
        xml_content = xml_reader
        
        with open(output_xml, 'w', encoding='utf-8') as f:
            f.write(xml_content)
        
        print(f"Structure saved to {output_xml}")
        return True

# Usage
save_structure_to_file("sample.pdf", "structure.xml")
```

{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Saves the document structure as an XML file for further processing.

## Extract section information

To extract information about document sections:
{{< tabs "example-7" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
import xml.etree.ElementTree as ET

def extract_section_info(file_path):
    """
    Extract section information from document.
    """
    with Parser(file_path) as parser:
        xml_reader = parser.get_structure()
        
        if xml_reader is None:
            print("Structure extraction not supported")
            return
        
        # Parse XML
        xml_content = xml_reader
        root = ET.fromstring(xml_content)
        
        # Find all sections
        sections = root.findall('.//section')
        
        print(f"Document has {len(sections)} sections:
")
        
        for idx, section in enumerate(sections, 1):
            name = section.get('name', f'Section {idx}')
            style = section.get('style', 'default')
            
            # Count elements in section
            paragraphs = section.findall('.//p')
            tables = section.findall('.//table')
            lists = section.findall('.//ul') + section.findall('.//ol')
            
            print(f"Section: {name}")
            print(f"  Style: {style}")
            print(f"  Paragraphs: {len(paragraphs)}")
            print(f"  Tables: {len(tables)}")
            print(f"  Lists: {len(lists)}")
            print()

# Usage
extract_section_info("sample.pptx")
```

{{< /tab >}}
{{< tab "sample.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pptx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-structure/sample.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Provides detailed information about each section in the document.

## Notes

- The `get_structure()` method returns `None` if structure extraction is not supported
- XML structure varies by document type (Word, Excel, PowerPoint)
- Use Python's `xml.etree.ElementTree` or other XML parsers to process the structure
- Structure extraction preserves document hierarchy and formatting information
- Useful for document analysis, content extraction, and format conversion
- Different document types have specific structure features (see documentation)

## Related pages

- [Extract text in Accurate mode]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode" >}})
- [Extract text areas]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-areas" >}})
- [Extract hyperlinks from document]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-hyperlinks/extract-hyperlinks-from-document" >}})


---

## Fluent syntax

Path: /merger/net/fluent-syntax/

Fluent syntax provides a compact call for most public methods of **[GroupDocs.Merger](https://products.groupdocs.com/merger/net)**.

These methods include:
* Join two or more documents,
* Join a specific or group of pages from various documents,
* Split a document into several resultant documents,
* Split document by providing specific page numbers,
* Change page position within a document,
* Remove single or multiple pages from the document,
* Rotate the page to an angle of 90, 180, or 270 degrees,
* Swap the position of two pages within a document,
* Extract a specific page or a range of pages from the document,
* Change page orientation (portrait, landscape) of specific or all pages within a document,
* Set, update or remove the document password,
* etc.
  
Please see the example how to use the fluent syntax below:

```csharp
using (Merger merger = new Merger(@"c:\document1.pdf"))
{
    merger
    .Join(@"c:\document2.docx")
    .Join(@"c:\document3.pptx")
    .Join(@"c:\document4.xlsx")
    .Save(@"c:\merged.pdf");
}
```


---

## Font embedding options

Path: /editor/java/font-embedding-options/

## Introduction

Starting from version 20.11 the GroupDocs.Editor for Java is able, along with font extraction, ability to embed fonts into the output WordProcessing document. This feature can be treated as similar to Microsoft Word feature to embed fonts into the saved document after its editing.

In counterpart to the _font extraction_ mechanism with corresponding [`FontExtractionOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/fontextractionoptions) class, which are responsible for extracting font resources from input WordProcessing document into intermediate [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), the font embedding mechanism with corresponding class are responsible for transferring fonts from [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) into output WordProcessing document through embedding. When user obtains a document content, edited in the WYSIWYG-editor, and creates a new [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance with edited document content, he then needs to invoke an [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor). [`save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method, that will generate an output WordProcessing document from specified [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) and [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class. The [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class is the point where font embedding, which is disabled by default, can be enabled and tuned.

When font embedding is enabled, the GroupDocs.Editor analyzes a document content of [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) and forms a list of all fonts, which are used in document body, for example, in paragraphs, labels and so on. After this GroupDocs.Editor tries to find all of these fonts in the font resources of input [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) (property [`EditableDocument.getFonts()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#getFonts--)). If [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) contains all font resources, that are used in document body, they will be embedded into the output WordProcessing document. However, if there are some fonts, used in the document content, which have no corresponding font resources in [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), then GroupDocs.Editor tries to find them in the OS (where GroupDocs.Editor is running), extract and embed into the output document.

There may be a situation, when during the document editing in WYSIWYG-editor end-user deleted some text, for example, a paragraph, with some specific font, and after the deletion this font is no longer used, while corresponding font resource is still leaving in the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument). During font embedding such dangling font resources are detected and ignored, so they will not be passed into the output document.

When working with fonts, the GroupDocs.Editor must work with so-called _system fonts_. System fonts are the fonts, which are the most vital for the operation system; for example, they are using in Windows Explorer, Console, system built-in applications of the operation system. When performing font embedding, user can define whether to embed the system fonts into the output document or not. Including system fonts may be useful if the user is on an East Asian system and wants to create a document that is readable by others who do not have fonts for that language on their system. For example, a user on a Japanese system could choose to embed the fonts in a document so that the Japanese document would be readable on all systems.

## Usage

In order to support fonts embedding, starting from the version 20.11, the [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class now contains a new property `getFontEmbedding()`. This property is of type `FontEmbeddingOptions` — it is enum with three possible values. By default, when creating a new instance of [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class, the value of `FontEmbedding` property is set to `NotEmbed`, — in this case GroupDocs.Editor do not embed fonts at all and thus acts like previous versions, so the existing client code will not be broken after updating from older versions to 20.11.

`FontEmbeddingOptions` enum contains two values for embedding fonts, which are almost the same, but with one slight difference:
* `EmbedAll`. As it is described above, when this option is chosen, the GroupDocs.Editor analyzes the document content for used fonts, and then looking for these fonts in EditableDocument and, if required, in operating system.This option resembles the "Embed fonts in the file" option with all sub-options turned off in Microsoft Word 2007 and higher.
* `EmbedWithoutSystem`. This option is almost the same as previous one, but with one little distinction: it does not embed system fonts. This option resembles the "Embed fonts in the file" option with enabled "Do not embed common system fonts" sub-option in Microsoft Word 2007 and higher.

In the example below all these options are shown:

```java
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);

//By default fonts are not embedded
Assert.assertEquals(FontEmbeddingOptions.NotEmbed, saveOptions.getFontEmbedding());

//Embed all used fonts, including system fonts
saveOptions.setFontEmbedding(FontEmbeddingOptions.EmbedAll);

//Embed all used fonts, but except system fonts
saveOptions.setFontEmbedding(FontEmbeddingOptions.EmbedWithoutSystem);
```

---

## Font embedding options

Path: /editor/net/font-embedding-options/

## Introduction

Starting from version 20.7 the GroupDocs.Editor for .NET is able, along with font extraction, ability to embed fonts into the output WordProcessing document. This feature can be treated as similar to Microsoft Word feature to embed fonts into the saved document after its editing.

In counterpart to the _font extraction_ mechanism with corresponding [`FontExtractionOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fontextractionoptions) class, which are responsible for extracting font resources from input WordProcessing document into intermediate [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), the font embedding mechanism with corresponding class are responsible for transferring fonts from [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) into output WordProcessing document through embedding. When user obtains a document content, edited in the WYSIWYG-editor, and creates a new [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance with edited document content, he then needs to invoke an [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor).[`Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method, that will generate an output WordProcessing document from specified [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) and [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class. The [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class is the point where font embedding, which is disabled by default, can be enabled and tuned.

When font embedding is enabled, the GroupDocs.Editor analyzes a document content of [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) and forms a list of all fonts, which are used in document body, for example, in paragraphs, labels and so on. After this GroupDocs.Editor tries to find all of these fonts in the font resources of input [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) (property [`EditableDocument.Fonts`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fonts)). If [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) contains all font resources, that are used in document body, they will be embedded into the output WordProcessing document. However, if there are some fonts, used in the document content, which have no corresponding font resources in [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), then GroupDocs.Editor tries to find them in the OS (where GroupDocs.Editor is running), extract and embed into the output document.

There may be a situation, when during the document editing in WYSIWYG-editor end-user deleted some text, for example, a paragraph, with some specific font, and after the deletion this font is no longer used, while corresponding font resource is still leaving in the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument). During font embedding such dangling font resources are detected and ignored, so they will not be passed into the output document.

When working with fonts, the GroupDocs.Editor must work with so-called _system fonts_. System fonts are the fonts, which are the most vital for the operation system; for example, they are using in Windows Explorer, Console, system built-in applications of the operation system. When performing font embedding, user can define whether to embed the system fonts into the output document or not. Including system fonts may be useful if the user is on an East Asian system and wants to create a document that is readable by others who do not have fonts for that language on their system. For example, a user on a Japanese system could choose to embed the fonts in a document so that the Japanese document would be readable on all systems.

## Usage

In order to support fonts embedding, starting from the version 20.7, the [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class now contains a new property `FontEmbedding`. This property is of type `FontEmbeddingOptions` — it is enum with three possible values. By default, when creating a new instance of [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class, the value of `FontEmbedding` property is set to `NotEmbed`, — in this case GroupDocs.Editor do not embed fonts at all and thus acts like previous versions, so the existing client code will not be broken after updating from older versions to 20.7.

`FontEmbeddingOptions` enum contains two values for embedding fonts, which are almost the same, but with one slight difference:
* `EmbedAll`. As it is described above, when this option is chosen, the GroupDocs.Editor analyzes the document content for used fonts, and then looking for these fonts in EditableDocument and, if required, in operating system.This option resembles the "Embed fonts in the file" option with all sub-options turned off in Microsoft Word 2007 and higher.
* `EmbedWithoutSystem`. This option is almost the same as previous one, but with one little distinction: it does not embed system fonts. This option resembles the "Embed fonts in the file" option with enabled "Do not embed common system fonts" sub-option in Microsoft Word 2007 and higher.

In the example below all these options are shown:

```csharp
Options.WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(Formats.WordProcessingFormats.Docx);
  
//By default fonts are not embedded
Assert.AreEqual(Options.FontEmbeddingOptions.NotEmbed, saveOptions.FontEmbedding);
  
//Embed all used fonts, including system fonts
saveOptions.FontEmbedding = Options.FontEmbeddingOptions.EmbedAll;
  
//Embed all used fonts, but except system fonts
saveOptions.FontEmbedding = Options.FontEmbeddingOptions.EmbedWithoutSystem;
```

---

## Font embedding options

Path: /editor/nodejs-java/font-embedding-options/


## Introduction

**GroupDocs.Editor** supports font embedding for output WordProcessing documents. This is similar to the feature in Microsoft Word that allows embedding fonts into a saved document after editing.

Font embedding differs from font extraction. While font extraction transfers font resources from the input document to the intermediate `EditableDocument`, font embedding works by embedding fonts into the output document from the `EditableDocument` after it has been edited. When saving the edited document, fonts used in the content can be embedded into the final output document, ensuring consistency across different environments.

### How it Works

When font embedding is enabled, **GroupDocs.Editor** analyzes the content of the `EditableDocument` for all the fonts used (e.g., in paragraphs, labels, etc.). It then checks if these fonts are available in the `EditableDocument`'s font resources (`EditableDocument.getFonts()`). If the fonts are available, they will be embedded in the output document. 

If the fonts are not found in the document, **GroupDocs.Editor** attempts to locate them in the operating system where the editor is running, and they will be embedded if found. Unused font resources (e.g., fonts associated with deleted content) are automatically ignored.

### Font Embedding Options

To support font embedding, the `WordProcessingSaveOptions` class has a new property: `getFontEmbedding()`. This property is of type `FontEmbeddingOptions`, an enum with three values:

1. **NotEmbed**: (Default) Fonts are not embedded in the output document, preserving behavior from older versions of **GroupDocs.Editor**.
2. **EmbedAll**: All fonts used in the document are embedded, including system fonts.
3. **EmbedWithoutSystem**: All fonts except system fonts are embedded.

System fonts are essential for operating systems (e.g., for UI elements like Windows Explorer, Console, etc.). Excluding system fonts may be desirable in certain cases, such as when creating documents on an East Asian system for distribution to users without those specific fonts.

### Example in Node.js

Here’s how to use the font embedding options in **Node.js**:

```javascript
const groupdocs = require('groupdocs-editor');
const WordProcessingSaveOptions = groupdocs.options.WordProcessingSaveOptions;
const FontEmbeddingOptions = groupdocs.options.FontEmbeddingOptions;
const WordProcessingFormats = groupdocs.formats.WordProcessingFormats;

// Create save options for a DOCX file
let saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);

// By default, fonts are not embedded
console.log(saveOptions.fontEmbedding === FontEmbeddingOptions.NotEmbed); // true

// Embed all used fonts, including system fonts
saveOptions.fontEmbedding = FontEmbeddingOptions.EmbedAll;

// Embed all used fonts, excluding system fonts
saveOptions.fontEmbedding = FontEmbeddingOptions.EmbedWithoutSystem;
```

### When to Use Font Embedding

Embedding fonts ensures that the output document maintains its original appearance, even when opened on systems that do not have the required fonts installed. This is particularly important when sharing documents across different platforms or geographic regions where font availability may vary.

By using the appropriate font embedding option, you can control whether to include system fonts, which may be unnecessary for most documents.

---

## Fuzzy search

Path: /search/java/fuzzy-search/

This page provides a fuzzy search definition, a description of its capabilities in GroupDocs.Search, and fuzzy search Java examples with use of GroupDocs.Search.

## Fuzzy search definition

Fuzzy search is a text search technique based on fuzzy logic that matches even where search queries or the text of documents to search for are written with errors.

## Fuzzy search features

Fuzzy search allows you to search for words that do not exactly match the search query. This type of search can be used, for example, to search for words containing spelling errors in documents. During fuzzy search, the number of possible differences with the search word is determined by the fuzzy search algorithm used. Differences or errors mean insertions, deletions, substitutions and, optionally, transpositions of adjacent characters.

GroupDocs.Search does not use special fuzzy queries. Instead, you can enable fuzzy search in search options for any search query, whether it is a single word, phrase or logical search query. And it becomes a fuzzy query.

The fuzzy search algorithm used is defined in the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class. By default, the algorithm provided by the [SimilarityLevel](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SimilarityLevel) class is used with the similarity level value of 0.5. This algorithm uses a linear dependence of the number of possible differences from the search word. To calculate the maximum number of possible differences, the following expression is used:

int maxMistakeCount = (int)((1 - similarityLevel) \* termLength);

where similarityLevel is a parameter of the fuzzy search algorithm; termLength is the length of the searched word.

An example of setting a fuzzy search algorithm of this type is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
String query = "Einstein";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
SearchOptions options = new SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new SimilarityLevel(0.8)); // Creating the fuzzy search algorithm
// This function specifies 0 as the maximum number of mistakes for words from 1 to 4 characters.
// It specifies 1 as the maximum number of mistakes for words from 5 to 9 characters.
// It specifies 2 as the maximum number of mistakes for words from 10 to 14 characters. And so on.
 
// Search in index
SearchResult result = index.search(query, options);
```

The fuzzy search algorithm can also be specified by a table of correspondences between the length of the searched word and the maximum number of possible differences. For this, the algorithm presented by the [TableDiscreteFunction](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TableDiscreteFunction) class is used. In this case, the correspondence table can be calculated based on the parameters of a step function. An example of setting a fuzzy search algorithm in the form of a step function is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
String query = "Einstein";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
SearchOptions options = new SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(1, new Step(5, 2), new Step(8, 3))); // Creating the fuzzy search algorithm
// This function specifies 1 as the maximum number of mistakes for words from 1 to 4 characters.
// It specifies 2 as the maximum number of mistakes for words from 5 to 7 characters.
// It specifies 3 as the maximum number of mistakes for words from 8 and more characters.
 
// Search in index
SearchResult result = index.search(query, options);
```

The fuzzy search options object allows you to specify the following options:

*   The [setFuzzyAlgorithm](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/FuzzySearchOptions#setFuzzyAlgorithm(com.groupdocs.search.options.FuzzyAlgorithm)) method sets the fuzzy search algorithm. The currently available fuzzy search algorithms are [SimilarityLevel](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SimilarityLevel) and [TableDiscreteFunction](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TableDiscreteFunction). The default value is an instance of [SimilarityLevel](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SimilarityLevel) class with a similarity level value of 0.5.
*   The [setOnlyBestResults](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/FuzzySearchOptions#setOnlyBestResults(boolean)) method sets a value indicating whether to return only the best results or not. The default value is false, which means that all results will be returned.
*   The [setOnlyBestResultsRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/FuzzySearchOptions#setOnlyBestResultsRange(byte)) method sets a value of exceeding the number of differences from the best result. The default value is 0.
*   The [setConsiderTranspositions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/FuzzySearchOptions#setConsiderTranspositions(boolean)) method sets a value indicating whether to consider the transposition of adjacent characters as one mistake or not. The default value is true.
*   The [setEnabled](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/FuzzySearchOptions#setEnabled(boolean)) method enables or disables the fuzzy search. The default value is false.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Fuzzy search

Path: /search/net/fuzzy-search/

This page provides a fuzzy search definition, a description of its capabilities in GroupDocs.Search, and fuzzy search C# examples with use of GroupDocs.Search.

## Fuzzy search definition

Fuzzy search is a text search technique based on fuzzy logic that matches even where search queries or the text of documents to search for are written with errors.

## Fuzzy search features

Fuzzy search allows you to search for words that do not exactly match the search query. This type of search can be used, for example, to search for words containing spelling errors in documents. During fuzzy search, the number of possible differences with the search word is determined by the fuzzy search algorithm used. Differences or errors mean insertions, deletions, substitutions and, optionally, transpositions of adjacent characters.

GroupDocs.Search does not use special fuzzy queries. Instead, you can enable fuzzy search in search options for any search query, whether it is a single word, phrase or logical search query. And it becomes a fuzzy query.

The fuzzy search algorithm used is defined in the [SearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions) class. By default, the algorithm provided by the [SimilarityLevel](https://reference.groupdocs.com/net/search/groupdocs.search.options/similaritylevel) class is used with the similarity level value of 0.5. This algorithm uses a linear dependence of the number of possible differences from the search word. To calculate the maximum number of possible differences, the following expression is used:

int maxMistakeCount = (int)((1 - similarityLevel) \* termLength);

where similarityLevel is a parameter of the fuzzy search algorithm; termLength is the length of the searched word.

An example of setting a fuzzy search algorithm of this type is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
string query = "Einstein";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
SearchOptions options = new SearchOptions();
options.FuzzySearch.Enabled = true; // Enabling the fuzzy search
options.FuzzySearch.FuzzyAlgorithm = new SimilarityLevel(0.8); // Creating the fuzzy search algorithm
// This function specifies 0 as the maximum number of mistakes for words from 1 to 4 characters.
// It specifies 1 as the maximum number of mistakes for words from 5 to 9 characters.
// It specifies 2 as the maximum number of mistakes for words from 10 to 14 characters. And so on.
 
// Search in index
SearchResult result = index.Search(query, options);
```

The fuzzy search algorithm can also be specified by a table of correspondences between the length of the searched word and the maximum number of possible differences. For this, the algorithm presented by the **[TableDiscreteFunction](https://reference.groupdocs.com/net/search/groupdocs.search.options/tablediscretefunction)** class is used. In this case, the correspondence table can be calculated based on the parameters of a step function. An example of setting a fuzzy search algorithm in the form of a step function is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
string query = "Einstein";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
SearchOptions options = new SearchOptions();
options.FuzzySearch.Enabled = true; // Enabling the fuzzy search
options.FuzzySearch.FuzzyAlgorithm = new TableDiscreteFunction(1, new Step(5, 2), new Step(8, 3)); // Creating the fuzzy search algorithm
// This function specifies 1 as the maximum number of mistakes for words from 1 to 4 characters.
// It specifies 2 as the maximum number of mistakes for words from 5 to 7 characters.
// It specifies 3 as the maximum number of mistakes for words from 8 and more characters.
 
// Search in index
SearchResult result = index.Search(query, options);
```

The fuzzy search options object allows you to specify the following options:

*   The [FuzzyAlgorithm](https://reference.groupdocs.com/net/search/groupdocs.search.options/fuzzysearchoptions/properties/fuzzyalgorithm) property defines the fuzzy search algorithm. The currently available fuzzy search algorithms are [SimilarityLevel](https://reference.groupdocs.com/net/search/groupdocs.search.options/similaritylevel) and [TableDiscreteFunction](https://reference.groupdocs.com/net/search/groupdocs.search.options/tablediscretefunction). The default value is an instance of [SimilarityLevel](https://reference.groupdocs.com/net/search/groupdocs.search.options/similaritylevel) class with a similarity level value of 0.5.
*   The [OnlyBestResults](https://reference.groupdocs.com/net/search/groupdocs.search.options/fuzzysearchoptions/properties/onlybestresults) property determines whether to return only the best results. The default value is false, which means that all results will be returned.
*   The [OnlyBestResultsRange](https://reference.groupdocs.com/net/search/groupdocs.search.options/fuzzysearchoptions/properties/onlybestresultsrange) property determines a value of exceeding the number of differences from the best result. The default value is 0.
*   The [ConsiderTranspositions](https://reference.groupdocs.com/net/search/groupdocs.search.options/fuzzysearchoptions/properties/considertranspositions) property determines whether to consider the transposition of adjacent characters as one mistake. The default value is true.
*   The [Enabled](https://reference.groupdocs.com/net/search/groupdocs.search.options/fuzzysearchoptions/properties/enabled) property enables or disables the fuzzy search. The default value is false.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Fuzzy search

Path: /search/nodejs-java/fuzzy-search/

This page provides a fuzzy search definition, a description of its capabilities in GroupDocs.Search, and fuzzy search Java examples with use of GroupDocs.Search.

## Fuzzy search definition

Fuzzy search is a text search technique based on fuzzy logic that matches even where search queries or the text of documents to search for are written with errors.

## Fuzzy search features

Fuzzy search allows you to search for words that do not exactly match the search query. This type of search can be used, for example, to search for words containing spelling errors in documents. During fuzzy search, the number of possible differences with the search word is determined by the fuzzy search algorithm used. Differences or errors mean insertions, deletions, substitutions and, optionally, transpositions of adjacent characters.

GroupDocs.Search does not use special fuzzy queries. Instead, you can enable fuzzy search in search options for any search query, whether it is a single word, phrase or logical search query. And it becomes a fuzzy query.

The fuzzy search algorithm used is defined in the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class. By default, the algorithm provided by the [SimilarityLevel](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SimilarityLevel) class is used with the similarity level value of 0.5. This algorithm uses a linear dependence of the number of possible differences from the search word. To calculate the maximum number of possible differences, the following expression is used:

int maxMistakeCount = (int)((1 - similarityLevel) \* termLength);

where similarityLevel is a parameter of the fuzzy search algorithm; termLength is the length of the searched word.

An example of setting a fuzzy search algorithm of this type is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';
const query = 'Einstein';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

const options = new groupdocs.search.SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new groupdocs.search.SimilarityLevel(0.8)); // Creating the fuzzy search algorithm
// This function specifies 0 as the maximum number of mistakes for words from 1 to 4 characters.
// It specifies 1 as the maximum number of mistakes for words from 5 to 9 characters.
// It specifies 2 as the maximum number of mistakes for words from 10 to 14 characters. And so on.

// Search in index
const result = index.search(query, options);
```

The fuzzy search algorithm can also be specified by a table of correspondences between the length of the searched word and the maximum number of possible differences. For this, the algorithm presented by the [TableDiscreteFunction](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TableDiscreteFunction) class is used. In this case, the correspondence table can be calculated based on the parameters of a step function. An example of setting a fuzzy search algorithm in the form of a step function is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';
const query = 'Einstein';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

const options = new groupdocs.search.SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options
  .getFuzzySearch()
  .setFuzzyAlgorithm(
    new groupdocs.search.TableDiscreteFunction(1, new groupdocs.search.Step(5, 2), new groupdocs.search.Step(8, 3)),
  ); // Creating the fuzzy search algorithm
// This function specifies 1 as the maximum number of mistakes for words from 1 to 4 characters.
// It specifies 2 as the maximum number of mistakes for words from 5 to 7 characters.
// It specifies 3 as the maximum number of mistakes for words from 8 and more characters.

// Search in index
const result = index.search(query, options);
```

The fuzzy search options object allows you to specify the following options:

*   The [setFuzzyAlgorithm](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/FuzzySearchOptions#setFuzzyAlgorithm(com.groupdocs.search.options.FuzzyAlgorithm)) method sets the fuzzy search algorithm. The currently available fuzzy search algorithms are [SimilarityLevel](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SimilarityLevel) and [TableDiscreteFunction](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TableDiscreteFunction). The default value is an instance of [SimilarityLevel](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SimilarityLevel) class with a similarity level value of 0.5.
*   The [setOnlyBestResults](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/FuzzySearchOptions#setOnlyBestResults(boolean)) method sets a value indicating whether to return only the best results or not. The default value is false, which means that all results will be returned.
*   The [setOnlyBestResultsRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/FuzzySearchOptions#setOnlyBestResultsRange(byte)) method sets a value of exceeding the number of differences from the best result. The default value is 0.
*   The [setConsiderTranspositions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/FuzzySearchOptions#setConsiderTranspositions(boolean)) method sets a value indicating whether to consider the transposition of adjacent characters as one mistake or not. The default value is true.
*   The [setEnabled](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/FuzzySearchOptions#setEnabled(boolean)) method enables or disables the fuzzy search. The default value is false.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Generate document pages preview

Path: /comparison/java/generate-document-pages-preview/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to generate page previews for source, target and output document(s) using the [generatePreview()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/document/#generatePreview-com.groupdocs.comparison.options.PreviewOptions-) method of the [Document](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/document) class.

Use the [PreviewOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/) class to manage the preview generation process - specify desired page numbers, image format, etc.

To generate the document preview using GroupDocs.Comparison API, follow these steps:

1.  Create an instance of the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) class. Specify the source document path as a constructor parameter.
2.  Add the target document to comparison using the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method.
3.  The [getSource()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getSource--) and [getTargets()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getTargets--) methods of the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object allows you to access source and target documents and the [generatePreview()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/document/#generatePreview-com.groupdocs.comparison.options.PreviewOptions-) method.
4.  Instantiate the [PreviewOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions) object. Specify the following parameters:
    *   delegate for each page stream creation (see the reatePageStreamFunction event handler)
    *   image preview format - [PNG / JPG / BMP](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options.enums/previewformats/)
    *   page numbers to process
    *   custom size of preview images (if needed)
    {{< alert style="info" >}}Stream created by the [CreatePageStreamFunction](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.common.function/createpagestreamfunction/) delegate is disposed automatically when preview image is generated. If you need to implement the custom disposing of the image preview stream, specify the [ReleasePageStreamFunction](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.common.function/releasepagestreamfunction/) argument to clean up resources.{{< /alert >}}
5.  Call the [generatePreview()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/document/#generatePreview-com.groupdocs.comparison.options.PreviewOptions-) method of the [Source](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getSource--) and [Targets](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getTargets--) documents. Specify the [PreviewOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/).

The [PreviewOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/) class main methods are as follows:

*   [getCreatePageStreamFunction()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/#getCreatePageStream--) returns a delegate which defines method to create output page preview stream
*   [getReleasePageStreamFunction()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/#getReleasePageStream--) returns a delegate which defines method to remove output page preview stream. This is can be used when need advanced control for resources handling
*   [setWidth](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/#setWidth-int-) sets the preview image width. Use this method to customize output image width
*   [setHeight](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/#setHeight-int-) sets the preview image height. Use this method to customize output image height
*   [setPageNumbers](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/#setPageNumbers-int---) defines an array of page numbers to be previewed;
*   [setPreviewFormat](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/previewoptions/#setPreviewFormat-com.groupdocs.comparison.options.enums.PreviewFormats-) sets the preview image format which provides ability to choose between image quality and size. Use the BMP format for the best image quality. Use the JPG format to produce smallest image size (and faster loading image previews), but with lower quality than BMP. By default GroupDocs.Comparison uses the PNG format to provide appropriate image quality and size.

The following code snippet shows how to generate document previews:

## Get page previews for source document

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.common.function.CreatePageStreamFunction;
import com.groupdocs.comparison.options.PreviewOptions;
import com.groupdocs.comparison.options.enums.PreviewFormats;
import java.io.FileOutputStream;
import java.io.OutputStream;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    PreviewOptions previewOptions = new PreviewOptions(new CreatePageStreamFunction() {
        @Override
        public OutputStream invoke(int pageNumber) {
            return new FileOutputStream(previewDirectory + "result_" + pageNumber + ".png");
        }
    });
    previewOptions.setPreviewFormat(PreviewFormats.PNG);
    previewOptions.setPageNumbers(new int[]{1, 2});
    comparer.getSource().generatePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/generate-document-pages-preview.png)

## Get page previews for target document

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.common.function.CreatePageStreamFunction;
import com.groupdocs.comparison.options.PreviewOptions;
import com.groupdocs.comparison.options.enums.PreviewFormats;
import java.io.FileOutputStream;
import java.io.OutputStream;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    PreviewOptions previewOptions = new PreviewOptions(new CreatePageStreamFunction() {
        @Override
        public OutputStream invoke(int pageNumber) {
            return new FileOutputStream(previewDirectory + "result_" + pageNumber + ".png");
        }
    });
    previewOptions.setPreviewFormat(PreviewFormats.PNG);
    previewOptions.setPageNumbers(new int[]{1, 2});
    comparer.getTargets().get(0).generatePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Get page previews for output document

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.Document;
import com.groupdocs.comparison.common.function.CreatePageStreamFunction;
import com.groupdocs.comparison.options.PreviewOptions;
import com.groupdocs.comparison.options.enums.PreviewFormats;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final Path resultPath = comparer.compare("result.docx");
    Document document = new Document(resultPath);
    PreviewOptions previewOptions = new PreviewOptions(new CreatePageStreamFunction() {
        @Override
        public OutputStream invoke(int pageNumber) {
            return new FileOutputStream(previewDirectory + "result_" + pageNumber + ".png");
        }
    });
    previewOptions.setPreviewFormat(PreviewFormats.PNG);
    previewOptions.setPageNumbers(new int[]{1, 2});
    document.generatePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Set specific size for preview images

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.Document;
import com.groupdocs.comparison.common.function.CreatePageStreamFunction;
import com.groupdocs.comparison.options.PreviewOptions;
import com.groupdocs.comparison.options.enums.PreviewFormats;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final Path resultPath = comparer.compare("result.docx");
    Document document = new Document(resultPath);
    
    PreviewOptions previewOptions = new PreviewOptions(new CreatePageStreamFunction() {
        @Override
        public OutputStream invoke(int pageNumber) {
            return new FileOutputStream(previewDirectory + 
                "result-SetSpecificImagesSize_" + pageNumber + ".png");
        }
    });
    previewOptions.setPreviewFormat(PreviewFormats.PNG);
    previewOptions.setPageNumbers(new int[]{1, 2});
    previewOptions.setHeight(1000);
    previewOptions.setWidth(1000);
    document.generatePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}This feature is not supported for WordProcessing documents.{{< /alert >}}

## Get page previews and clean resources manually

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.Document;
import com.groupdocs.comparison.common.function.CreatePageStreamFunction;
import com.groupdocs.comparison.common.function.ReleasePageStreamFunction;
import com.groupdocs.comparison.options.PreviewOptions;
import com.groupdocs.comparison.options.enums.PreviewFormats;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final Path resultPath = comparer.compare("result.docx");
    Document document = new Document(resultPath);
    
    PreviewOptions previewOptions = new PreviewOptions(new CreatePageStreamFunction() {
        @Override
        public OutputStream invoke(int pageNumber) {
            return new FileOutputStream(previewDirectory + 
                "result-GetPagePreviewsResouresCleaning_" + pageNumber + ".png");
        }
    });
    previewOptions.setPreviewFormat(PreviewFormats.PNG);
    previewOptions.setPageNumbers(new int[]{1, 2});
    previewOptions.setReleasePageStreamFunction(new ReleasePageStreamFunction() {
        @Override
        public void invoke(int pageNumber, OutputStream outputStream) {
            System.out.println("Releasing memory for page: " + pageNumber);
            outputStream.close();
        }
    });
    document.generatePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Generate document pages preview

Path: /comparison/net/generate-document-pages-preview/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to generate page previews for source, target and output document(s) using the [GeneratePreview](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/document/methods/generatepreview) method of the [Document](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/document) class.

Use the [PreviewOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions) class to manage the preview generation process - specify desired page numbers, image format, etc.

To generate the document preview using GroupDocs.Comparison API, follow these steps:

1.  Create an instance of the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) class. Specify the source document path as a constructor parameter.
2.  Add the target document to comparison using the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method.
3.  The [Source](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/properties/source) and [Targets](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/properties/targets) properties of the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object allows you to access source and target documents and provides the [GeneratePreview](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/document/methods/generatepreview) method;
4.  Instantiate the [PreviewOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions) object. Specify the following parameters:
    *   delegate for each page stream creation (see the CreatePageStream event handler)
    *   image preview format - PNG / JPG / BMP
    *   page numbers to process
    *   custom size of preview images (if needed)
    {{< alert style="info" >}}Stream created by the [CreatePageStream](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/fields/createpagestream) delegate is disposed automatically when preview image is generated. If you need to implement the custom disposing of the image preview stream, specify the [ReleasePageStream](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/fields/releasepagestream) argument to clean up resources.{{< /alert >}}
5.  Call the [GeneratePreview](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/document/methods/generatepreview) method of the [Source](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/properties/source) and [Targets](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/properties/targets) documents. Specify the [PreviewOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions).

The [PreviewOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions) class main properties are as follows:

*   [CreatePageStream](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/fields/createpagestream) is a delegate which defines method to create output page preview stream
*   [ReleasePageStream](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/fields/releasepagestream) is a delegate which defines method to remove output page preview stream. This is can be used when need advanced control for resources handling
*   [Width](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/properties/width) is preview image width. Use this property to customize output image width
*   [Height](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/properties/height) is preview image height. Use this property to customize output image height
*   [Resolution](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/properties/Resolution) allows to configure horizontal and vertical resolution values for image preview generation
*   [PageNumbers](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/properties/pagenumbers) defines numbers of pages to be previewed;
*   [PreviewFormat](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/previewoptions/properties/previewformat) gets or sets the preview image format which provides ability to choose between image quality and size. Use the BMP format for the best image quality. Use the JPG format to produce smallest image size (and faster loading image previews), but with lower quality than BMP. By default GroupDocs.Comparison uses the PNG format to provide appropriate image quality and size.

The following code snippet shows how to generate document previews:

## Get page previews for source document

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = Path.Combine(@"D:\Temp\", $"result_{pageNumber}.png");
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2 };
    comparer.Source.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/generate-document-pages-preview.png)

## Get page previews for target document

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = Path.Combine(@"C:\", $"result_{pageNumber}.png");
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2 };
    comparer.Targets[0].GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Get page previews for output document

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx");
    Document document = new Document(File.OpenRead("result.docx"));
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = Path.Combine(@"C:\", $"result_{pageNumber}.png");
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2 };
    document.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Set specific size and resolution for preview images

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer("source.pptx"))
{
    comparer.Add("target.pptx");
    comparer.Compare("result.pptx");
    Document document = new Document(File.OpenRead("result.pptx"));
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = Path.Combine(@"C:\", $"result_{pageNumber}.png");
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2 };
    previewOptions.Height = 1000;
    previewOptions.Width = 1000;

    previewOptions.Resolution = new PreviewResolution()
    {
      HorizontalResolution = 300,
      VerticalResolution = 300
    };

    document.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}This feature is not supported for WordProcessing documents.{{< /alert >}}

## Get page previews and clean resources manually

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

// Method should match with ReleasePageStream delegate signature
private void UserReleaseStreamMethod(int pageNumber, Stream stream)
{
    Console.WriteLine($"Releasing memory for page: {pageNumber}");
    stream.Close();
}

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx");
    Document document = new Document(File.OpenRead("result.docx"));
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = Path.Combine(@"C:\", $"result_{pageNumber}.png");
        return File.Create(pagePath);
    });
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    previewOptions.PageNumbers = new int[] { 1, 2 };
    // here we set delegate target method
    previewOptions.ReleasePageStream = UserReleaseStreamMethod;
    document.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Generate document pages preview

Path: /comparison/nodejs-java/generate-document-pages-preview/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to generate page previews for source, target and output document(s) using the `generatePreview()` method of the `Document` class.

Use the `PreviewOptions` class to manage the preview generation process - specify desired page numbers, image format, etc.

The `getSource()` and `getTargets()` methods of the `Comparer` object allow you to access source and target documents and the `generatePreview()` method. When creating `PreviewOptions`, you need to specify:
*   delegate for each page stream creation (see the CreatePageStreamFunction event handler)
*   image preview format - `PNG / JPG / BMP`
*   page numbers to process
*   custom size of preview images (if needed)
{{< alert style="info" >}}Stream created by the `CreatePageStreamFunction` delegate is automatically disposed when the preview image is generated. If you need to implement the custom disposing of the image preview stream, specify the `ReleasePageStreamFunction` argument to clean up resources.{{< /alert >}}

The `PreviewOptions` class's main methods are as follows:

*   `getCreatePageStreamFunction()` returns a delegate that defines a method to create the output page preview stream
*   `getReleasePageStreamFunction()` returns a delegate that defines a method to remove the output page preview stream. This can be used when you need advanced control of resource handling
*   `setWidth` sets the preview image width. Use this method to customize the output image width
*   `setHeight` sets the preview image height. Use this method to customize output image height
*   `setPageNumbers` defines an array of page numbers to be previewed;
*   `setPreviewFormat` sets the preview image format which provides an ability to choose between image quality and size. Use the BMP format for the best image quality. Use the JPG format to produce the smallest image size (and faster loading image previews) but with lower quality than BMP. By default, GroupDocs.Comparison uses the PNG format to provide appropriate image quality and size.

The following code snippets show how to generate document previews in different scenarios.

## Get page previews for source document

The following example generates PNG previews for the first two pages of the source document.

```javascript
'use strict';

// Import GroupDocs.Comparison for Node.js via Java and Java interop classes
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
const InputStream = java.import('java.io.FileInputStream');
const FileOutputStream = java.import('java.io.FileOutputStream');

// Open the source document as a Java input stream
const sourceFile = new InputStream('sample-files/source.docx');

// Initialize the Comparer using the source stream
const comparer = new groupdocs.Comparer(sourceFile);

// Define how each preview image stream should be created
const createPageStream = java.newProxy('com.groupdocs.comparison.common.function.CreatePageStreamFunction', {
  invoke: function (pageNumber) {
    // Create a separate PNG file for every generated page preview
    return new FileOutputStream('result_' + pageNumber + '.png');
  }
});

// Configure preview options: format and page numbers to render
const previewOptions = new groupdocs.PreviewOptions(createPageStream);
previewOptions.setPreviewFormat(groupdocs.PreviewFormats.PNG);
previewOptions.setPageNumbers(java.newArray('int', [1, 2]));

// Generate preview images for the source document
comparer.getSource().generatePreview(previewOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates how to generate page previews for the source document. It creates a `Comparer` instance with a source document stream, then creates a `CreatePageStreamFunction` proxy that creates a separate PNG file for each page preview. The `PreviewOptions` object is configured with PNG format and page numbers [1, 2], and `generatePreview()` is called on the source document accessed via `getSource()`. This generates preview images for the first two pages of the source document.

The result is as follows:

![](/comparison/nodejs-java/images/generate-document-pages-preview.png)

## Get page previews for the target document

The following example compares two documents and generates previews for the first target document.

```javascript
'use strict';

// Import GroupDocs.Comparison and Java NIO classes for writing output streams
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
const InputStream = java.import('java.io.FileInputStream');
const Files = java.import('java.nio.file.Files');
const Paths = java.import('java.nio.file.Paths');

// Load source and target documents as input streams
const source = new InputStream('sample-files/source.docx');
const target = new InputStream('sample-files/target.docx');

// Create a Comparer instance for the source file
const comparer = new groupdocs.Comparer(source);

// Add the target document to the comparison set
comparer.add(target);

// Configure preview generation (create PNG stream per page)
const createPageStream = java.newProxy('com.groupdocs.comparison.common.function.CreatePageStreamFunction', {
  invoke: function (pageNumber) {
    return Files.newOutputStream(Paths.get('result_' + pageNumber + '.png'));
  }
});

const previewOptions = new groupdocs.PreviewOptions(createPageStream);
previewOptions.setPreviewFormat(groupdocs.PreviewFormats.PNG);
previewOptions.setPageNumbers(java.newArray('int', [1, 2]));

// Generate preview images for the first target document in the comparer
comparer.getTargets().get(0).generatePreview(previewOptions);

// Exit the process
process.exit(0);
```

This example compares two documents first, then generates previews for the target document. It creates a `Comparer` instance with source and target streams, performs the comparison, and then accesses the first target document using `getTargets().get(0)`. It creates a `PreviewOptions` object with a stream creation function that uses Java NIO's `Files.newOutputStream()` and `Paths.get()` to create output streams, then calls `generatePreview()` on the target document to generate preview images.

## Get page previews for the output document

The following example first produces a comparison result document and then generates previews from that output file.

```javascript
'use strict';

// Import GroupDocs.Comparison and Java NIO classes for file I/O
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
const InputStream = java.import('java.io.FileInputStream');
const Files = java.import('java.nio.file.Files');
const Paths = java.import('java.nio.file.Paths');

// Define paths for input and output documents
const sourceFilePath = 'sample-files/source.docx';
const targetFilePath = 'sample-files/target.docx';
const outputFilePath = 'result.docx';

// Open source and target documents as streams
const sourceStream = new InputStream(sourceFilePath);
const targetStream = new InputStream(targetFilePath);

// Compare source and target, saving the merged result to disk
const comparer = new groupdocs.Comparer(sourceStream);
comparer.add(targetStream);
comparer.compare(outputFilePath);

// Open the generated output document as a GroupDocs Document instance
const document = new groupdocs.Document(outputFilePath);

// Configure preview generation for the result document
const createPageStream = java.newProxy('com.groupdocs.comparison.common.function.CreatePageStreamFunction', {
  invoke: function (pageNumber) {
    return Files.newOutputStream(Paths.get('result_' + pageNumber + '.png'));
  }
});

const previewOptions = new groupdocs.PreviewOptions(createPageStream);
previewOptions.setPreviewFormat(groupdocs.PreviewFormats.PNG);
const pageNumbersArray = java.newArray('int', [1, 2]);
previewOptions.setPageNumbers(pageNumbersArray);

// Generate preview images for the final comparison document
document.generatePreview(previewOptions);

// Exit the process
process.exit(0);
```

This example first performs a comparison and saves the result document, then generates previews from that output file. It creates a `Comparer`, performs the comparison, and saves the result. Then it creates a `Document` instance from the output file path and generates previews from that document. This approach allows you to generate previews of the final comparison result document, showing how the merged document with all changes highlighted appears.

## Set specific sizes for preview images

The following example sets a custom width and height for the generated preview images.

```javascript
'use strict';

// Import GroupDocs.Comparison and Java I/O for creating image files
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
const InputStream = java.import('java.io.FileInputStream');
const FileOutputStream = java.import('java.io.FileOutputStream');

// Define paths for input and output documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

// Open documents as streams and run comparison
const sourceStream = new InputStream(sourcePath);
const targetStream = new InputStream(targetPath);
const comparer = new groupdocs.Comparer(sourceStream);
comparer.add(targetStream);
comparer.compare(outputPath);

// Open the resulting document for preview generation
const document = new groupdocs.Document(outputPath);

// Configure how preview images will be written
const createPageStream = java.newProxy('com.groupdocs.comparison.common.function.CreatePageStreamFunction', {
  invoke: function (pageNumber) {
    return new FileOutputStream('result-' + pageNumber + '.png');
  }
});

// Create preview options with a custom size
const previewOptions = new groupdocs.PreviewOptions(createPageStream);
previewOptions.setPreviewFormat(groupdocs.PreviewFormats.PNG);
previewOptions.setPageNumbers(java.newArray('int', [1, 2]));
previewOptions.setHeight(1000); // target image height in pixels
previewOptions.setWidth(1000);  // target image width in pixels

// Generate resized preview images
document.generatePreview(previewOptions);

// Exit the process
process.exit(0);
```

This example demonstrates how to set custom dimensions for preview images. After performing the comparison and creating a `Document` instance from the result, it creates `PreviewOptions` and sets both `setHeight(1000)` and `setWidth(1000)` to generate preview images with specific pixel dimensions. This allows you to control the size of the generated preview images, which can be useful for creating thumbnails or ensuring consistent image sizes.

{{< alert style="info" >}}This feature is not supported for WordProcessing documents.{{< /alert >}}

## Get page previews and clean resources manually

The following example demonstrates how to plug in a custom release handler to manually dispose preview streams.

```javascript
'use strict';

// Import GroupDocs.Comparison and Java stream classes
const groupdocs = require('@groupdocs/groupdocs.comparison');

const java = require('java');
const InputStream = java.import('java.io.FileInputStream');
const FileOutputStream = java.import('java.io.FileOutputStream');

// Open source and target files as streams
const sourceFile = new InputStream('sample-files/source.docx');
const targetFile = new InputStream('sample-files/target.docx');

// Run comparison and obtain the path of the output document
const outputFile = 'result.docx';
const comparer = new groupdocs.Comparer(sourceFile);
comparer.add(targetFile);
const resultPath = comparer.compare(outputFile);

// Wrap the result document for preview generation
const document = new groupdocs.Document(resultPath);

// Create page stream factory for preview images
const createPageStream = java.newProxy('com.groupdocs.comparison.common.function.CreatePageStreamFunction', {
  invoke: function (pageNumber) {
    return new FileOutputStream('result-page-' + pageNumber + '.png');
  }
});

// Define custom cleanup logic for created streams
const releasePageStream = java.newProxy('com.groupdocs.comparison.common.function.ReleasePageStreamFunction', {
  invoke: function (pageNumber, outputStream) {
    console.log('Releasing memory for page: ', pageNumber);
    outputStream.close(); // close stream explicitly when GroupDocs is done with it
  }
});

// Use both factory and release handlers in preview options
const previewOptions = new groupdocs.PreviewOptions(createPageStream, releasePageStream);
previewOptions.setPreviewFormat(groupdocs.PreviewFormats.PNG);
previewOptions.setPageNumbers(java.newArray('int', [1, 2]));

// Generate page previews with custom resource management
document.generatePreview(previewOptions);

// Exit the process
process.exit(0);
```

This example demonstrates advanced resource management for preview generation. It creates both a `CreatePageStreamFunction` proxy to create output streams for each page preview and a `ReleasePageStreamFunction` proxy to manually clean up resources when preview generation is complete. The `ReleasePageStreamFunction` logs a message and explicitly closes the stream. Both functions are passed to the `PreviewOptions` constructor, giving you full control over stream lifecycle management, which is useful for memory-intensive operations or when you need custom cleanup logic.

---

## Generate document pages preview

Path: /signature/java/generate-document-pages-preview/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [PreviewOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions) class to specify different options to manage document pages preview generation process.  
  
Here are the steps to generate document preview with GroupDocs.Signature:
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
*   Instantiate the[ PreviewOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions) object with:     
    *   interface for each page stream creation (see [PageStreamFactory](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PageStreamFactory));         
    *   image preview format - PNG / JPG / BMP,         
    *   page numbers to process;        
    *   custom size of preview images (if needed).         
*   Call [generatePreview](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#generatePreview(com.groupdocs.signature.options.PreviewOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [PreviewOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PreviewOptions) to it.       
{{< alert style="info" >}}
Important note! Stream that were created by [createPageStream](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PageStreamFactory#createPageStream(int)) method will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional method [closePageStream](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PageStreamFactory#closePageStream(int,%20java.io.OutputStream)) to clean up resources.  
{{< /alert >}}


## Generate document preview from file on local disk

```java
   
	// instantiating the signature object
    final Signature signature = new Signature("sample.pdf");
     
	PreviewOptions previewOption = new PreviewOptions("C:\\GeneratePreviewHideSignatures\\image.jpg", 0);
	previewOptions.setPreviewFormat(PreviewFormats.PNG);
	signature.generatePreview(previewOptions);
    

```

## createPageStream method implementation

GroupDocs.Signature expects [createPageStream](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options/PageStreamFactory#createPageStream(int)) method to obtain each page stream for image preview generation process

```java
@Override
public OutputStream createPageStream(int pageNumber) {
    try {
        Path path = Paths.get("C:\\GeneratePreviewFolder");

        if (!Files.exists(path)) {
            Files.createDirectory(path);
            System.out.println("Directory created");
        } else {

            System.out.println("Directory already exists");
        }
        File filePath = new File(path+"\\image-"+pageNumber+".jpg");

        return new FileOutputStream(filePath);
    }catch (Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## ClosePageStream method implementation

```java
@Override
public void closePageStream(int pageNumber, OutputStream pageStream) {
    try {
        pageStream.close();
        String imageFilePath = new File("GeneratePreviewFolder", "image-" +pageNumber +  ".jpg").getPath();
        System.out.print("Image file "+imageFilePath+" is ready for preview");
    }catch (Exception e){
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## Generate document preview from stream with custom stream creating and closing methods

```java
// instantiating the signature object
	FileInputStream stream = new FileInputStream("sample.pdf")
    final Signature signature = new Signature(stream);
        // Image from specified page
	PreviewOptions previewOption = new PreviewOptions(new PageStreamFactory() {
    @Override
    public OutputStream createPageStream(int pageNumber) {
        try {
            Path path = Paths.get("C:\\GeneratePreviewHideSignatures");

            if (!Files.exists(path)) {

                Files.createDirectory(path);
                System.out.println("Directory created");
            } else {

                System.out.println("Directory already exists");
            }
            File filePath = new File(path+"\\image-"+pageNumber+".jpg");

            return new FileOutputStream(filePath);
        }catch (Exception e){
            throw new GroupDocsSignatureException(e.getMessage());
        }
    }

    @Override
    public void closePageStream(int pageNumber, OutputStream pageStream) {
        try {
            pageStream.close();
            String imageFilePath = new File("C:\\GeneratePreviewHideSignatures", "image-" +pageNumber +  ".jpg").getPath();
            System.out.print("Image file "+imageFilePath+" is ready for preview");
        }catch (Exception e){
            throw new GroupDocsSignatureException(e.getMessage());
        }
    }
});
	previewOptions.setPreviewFormat(PreviewFormats.PNG);
	signature.generatePreview(previewOptions);


```

## More resources 

### Advanced Usage Topics 

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples  

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Generate document pages preview

Path: /signature/net/generate-document-pages-preview/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) class to specify different options to manage document pages preview generation process. The feature also supports archives previewing.
  
Here are the steps to generate document preview with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) object with:
* delegate for each page stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/createpagestream));
* image preview format - PNG / JPG / BMP,
* page numbers to process;
* custom size of preview images (if needed).
{{< alert style="info" >}}
Stream that were created by CreatePageStreamdelegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument ReleaseStream to clean up resources.  
{{< /alert >}}
* Call GeneratePreview method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) to it.

## CreatePageStream delegate implementation

GroupDocs.Signature expects [CreatePageStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/createpagestream) delegate to obtain each page stream for image preview generation process

```csharp
private static Stream CreatePageStream(PreviewPageData pageData)
{
    string imageName = "image-" + pageData.PageNumber + ".jpg";
    string imageFilePath = Path.Combine("GeneratePreviewFolder", imageName);
    string folder = Path.GetDirectoryName(imageFilePath);
    if(!Directory.Exists(folder))
    {
        Directory.CreateDirectory(folder);
    }
    return new System.IO.FileStream(imageFilePath, FileMode.Create);
}
```

## ReleasePageStream delegate implementation

```csharp
private static void ReleasePageStream(PreviewPageData pageData, Stream pageStream)
{
     pageStream.Dispose();
     string imageName = "image-" + pageData.PageNumber + ".jpg";
     string imageFilePath = Path.Combine("GeneratePreviewFolder", imageName);
     Console.WriteLine("Image file {0} is ready for preview", imageFilePath);
}
```

## Generate document preview from file on local disk

```csharp
public static void GetPreview()
{
    using (Signature signature = new Signature("sample.pdf"))
    {
        // create preview options object
        PreviewOptions previewOption = new PreviewOptions(GeneratePreview.CreatePageStream)
        {
            PreviewFormat = PreviewOptions.PreviewFormats.JPEG,
        };
        // generate preview
        signature.GeneratePreview(previewOption);
    }
}

private static Stream CreatePageStream(PreviewPageData pageData)
{
    string imageName = "image-" + pageData.PageNumber + ".jpg";
    string imageFilePath = Path.Combine("GeneratePreviewFolder", imageName);
    var folder = Path.GetDirectoryName(imageFilePath);
    if(!Directory.Exists(folder))
    {
        Directory.CreateDirectory(folder);
    }
    return new System.IO.FileStream(imageFilePath, FileMode.Create);
}
```

## Generate document preview from stream with custom stream releasing delegate

```csharp
public static void GetPreview()
{
  using (var stream = File.OpenRead("sample.pdf"))
  {
    using (Signature signature = new Signature("sample.pdf"))
    {
        // create preview options object
        PreviewOptions previewOption = new PreviewOptions(GeneratePreview.CreatePageStream)
        {
            PreviewFormat = PreviewOptions.PreviewFormats.JPEG,
        };
        // generate preview
        signature.GeneratePreview(previewOption);
    }
  }
}

private static Stream CreatePageStream(PreviewPageData pageData)
{
    string imageName = "image-" + pageData.PageNumber + ".jpg";
    string imageFilePath = Path.Combine("GeneratePreviewFolder", imageName);
    var folder = Path.GetDirectoryName(imageFilePath);
    if(!Directory.Exists(folder))
    {
        Directory.CreateDirectory(folder);
    }
    return new System.IO.FileStream(imageFilePath, FileMode.Create);
}

private static void ReleasePageStream(PreviewPageData pageData, Stream pageStream)
{        
    pageStream.Dispose();
    string imageName = "image-" + pageData.PageNumber + ".jpg";
    string imageFilePath = Path.Combine("GeneratePreviewFolder", imageName);
    Console.WriteLine("Image file {0} is ready for preview", imageFilePath);
}
```

## Creating a document preview with custom Resolution

```csharp
// The path to the documents
string filePath = "sample.pdf";
using (Signature signature = new Signature(filePath))
{
    int resolution = 96;
    // create preview options object
    // You can reuse CreatePageStream and ReleasePageStream methods from the previous example
    PreviewOptions previewOption = new PreviewOptions(CreatePageStream, ReleasePageStream, resolution)
    {
        PreviewFormat = PreviewOptions.PreviewFormats.JPEG
    };
    // generate preview
    signature.GeneratePreview(previewOption);
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Generate document pages preview

Path: /signature/nodejs-java/generate-document-pages-preview/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [PreviewOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/previewoptions) class to specify different options for managing document pages preview generation. The feature also supports archive previewing.

Here are the steps to generate a document preview with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [PreviewOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/previewoptions) object with:
    * A delegate for each page stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/createpagestream));
    * Image preview format - PNG / JPG / BMP;
    * Page numbers to process;
    * Custom size for preview images (if needed).

{{< alert style="info" >}}
Streams created by the [CreatePageStream](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/createpagestream) delegate will be disposed of automatically after the preview image generation. If you need to implement custom image preview stream disposal, pass an additional argument [ReleaseStream](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/releasepagestream) to clean up resources.
{{< /alert >}}

* Call the [GeneratePreview](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/generatepreview) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [PreviewOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/previewoptions) to it.

## CreatePageStream delegate implementation

GroupDocs.Signature expects [CreatePageStream](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/createpagestream) delegate to obtain each page stream for image preview generation process

```javascript
  function generatePreview() {
    // The path to the documents directory.
    const filePath = Constants.SAMPLE_PDF; // Assuming Constants.SAMPLE_PDF is defined elsewhere

    const signature = new signatureLib.Signature(filePath);

    // Create preview options object
    const previewOption = new signatureLib.PreviewOptions(createPageStream, releasePageStream);
    previewOption.setPreviewFormat(PreviewOptions.PreviewFormats.JPEG);

    // Generate preview
    signature.generatePreview(previewOption);
  }

  function createPageStream(pageNumber) {
    const imageFilePath = path.join(Constants.OutputPath, 'GeneratePreviewFolder', `image-${pageNumber}.jpg`);
    const folder = path.dirname(imageFilePath);

    if (!fs.existsSync(folder)) {
      fs.mkdirSync(folder, { recursive: true });
    }

    return fs.createWriteStream(imageFilePath);
  }

  function releasePageStream(pageNumber, pageStream) {
    pageStream.end();
    const imageFilePath = path.join(Constants.OutputPath, 'GeneratePreviewFolder', `image-${pageNumber}.jpg`);
    console.log(`Image file ${imageFilePath} is ready for preview`);
  }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Generate document pages preview

Path: /signature/python-net/generate-document-pages-preview/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/python-net) provides [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) class to specify different options to manage document pages preview generation process. The feature also supports archives previewing.
  
Here are the steps to generate document preview with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) object with:
* delegate for each page stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/createpagestream));
* image preview format - PNG / JPG / BMP,
* page numbers to process;
* custom size of preview images (if needed).
{{< alert style="info" >}}
Stream that were created by CreatePageStreamdelegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument ReleaseStream to clean up resources.  
{{< /alert >}}
* Call GeneratePreview method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [PreviewOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewoptions) to it.

## CreatePageStream delegate implementation

GroupDocs.Signature expects CreatePageStreamdelegate to obtain each page stream for image preview generation process

```python
def create_page_stream(page_data):
    image_name = f"image-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    folder = os.path.dirname(image_file_path)
    if not os.path.exists(folder):
        os.makedirs(folder)
    return open(image_file_path, "wb")
```

## ReleasePageStream delegate implementation

```python
def release_page_stream(page_data, page_stream):
    page_stream.close()
    image_name = f"image-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    print(f"Image file {image_file_path} is ready for preview")
```

## Generate document preview from file on local disk

```python
import os
import groupdocs.signature as signature

def get_preview():
    with signature.Signature("sample.pdf") as sign:
        # create preview options object
        preview_option = signature.PreviewOptions(create_page_stream)
        preview_option.preview_format = signature.PreviewOptions.PreviewFormats.JPEG
        # generate preview
        sign.generate_preview(preview_option)

def create_page_stream(page_data):
    image_name = f"image-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    folder = os.path.dirname(image_file_path)
    if not os.path.exists(folder):
        os.makedirs(folder)
    return open(image_file_path, "wb")
```

## Generate document preview from stream with custom stream releasing delegate

```python
import os
import groupdocs.signature as signature

def get_preview():
    with open("sample.pdf", "rb") as stream:
        with signature.Signature(stream) as sign:
            # create preview options object
            preview_option = signature.PreviewOptions(create_page_stream, release_page_stream)
            preview_option.preview_format = signature.PreviewOptions.PreviewFormats.JPEG
            # generate preview
            sign.generate_preview(preview_option)

def create_page_stream(page_data):
    image_name = f"image-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    folder = os.path.dirname(image_file_path)
    if not os.path.exists(folder):
        os.makedirs(folder)
    return open(image_file_path, "wb")

def release_page_stream(page_data, page_stream):
    page_stream.close()
    image_name = f"image-{page_data.page_number}.jpg"
    image_file_path = os.path.join("GeneratePreviewFolder", image_name)
    print(f"Image file {image_file_path} is ready for preview")
```

## Creating a document preview with custom Resolution

```python
import os
import groupdocs.signature as signature

# The path to the documents
file_path = "sample.pdf"
with signature.Signature(file_path) as sign:
    resolution = 96
    # create preview options object
    # You can reuse create_page_stream and release_page_stream methods from the previous example
    preview_option = signature.PreviewOptions(create_page_stream, release_page_stream, resolution)
    preview_option.preview_format = signature.PreviewOptions.PreviewFormats.JPEG
    # generate preview
    sign.generate_preview(preview_option)
```



## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python)



### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Generate document preview

Path: /metadata/java/generate-document-preview/

If you need to implement a UI for your application it can be useful to generate image previews for a document the users are going to work with. Such previews can be easily displayed on a web page or in an appropriate component of a desktop/mobile application. The code sample below demonstrates how to generate image previews for certain document pages.

Here are the steps to generate a document preview for a particular page:

1.  [Load]({{< ref "metadata/java/developer-guide/basic-usage/generate-document-preview.md" >}}) a document to preview
2.  Specify a delegate that will be used to create the page streams (please see the [ICreatePageStream](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.options/ICreatePageStream) interface for more information)
3.  Specify the page numbers
4.  Generate previews for desired pages using the [generatePreview](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata#generatePreview(com.groupdocs.metadata.options.PreviewOptions)) method of the [Metadata](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata/Metadata) class

**basic\_usage.GenerateFilePreview**

```java
public class GenerateFilePreview {
    public static void run() {
        try (Metadata metadata = new Metadata(Constants.InputDocx)) {
            PreviewOptions previewOptions = new PreviewOptions(new GenerateFilePreview().new CreatePageStream());
            previewOptions.setPreviewFormat(PreviewFormats.PNG);
            previewOptions.setPageNumbers(new int[]{1});
            metadata.generatePreview(previewOptions);
        }
    }

    private class CreatePageStream implements ICreatePageStream {
        @Override
        public OutputStream createPageStream(int pageNumber) {
            File file = new File(String.format("%s\\result_%s.png", Constants.OutputPath, pageNumber));
            OutputStream stream = null;
            try {
                stream = new FileOutputStream(file);
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
            return stream;
        }
    }
}
```

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Generate document preview

Path: /metadata/net/generate-document-preview/

If you need to implement a UI for your application it can be useful to generate image previews for a document the users are going to work with. Such previews can be easily displayed on a web page or in an appropriate component of a desktop/mobile application. The code sample below demonstrates how to generate image previews for certain document pages.

Here are the steps to generate a document preview for a particular page:

1.  [Load]({{< ref "metadata/net/developer-guide/basic-usage/generate-document-preview.md" >}}) a document to preview
2.  Specify a delegate that will be used to create the page streams (please see the [CreatePageStream](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.options/createpagestream) delegate for more information)
3.  Specify the page numbers
4.  Generate previews for desired pages using the [GeneratePreview](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata/methods/generatepreview) method of the [Metadata](https://reference.groupdocs.com/net/metadata/groupdocs.metadata/metadata) class

**BasicUsage.GenerateFilePreview**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDocx))
{
	PreviewOptions previewOptions = new PreviewOptions(pageNumber => File.Create($"{Constants.OutputPath}\\result_{pageNumber}.png"));
	previewOptions.PreviewFormat = PreviewOptions.PreviewFormats.PNG;
	previewOptions.PageNumbers = new int[] { 1 };
	metadata.GeneratePreview(previewOptions);
}
```

## More resources
### Advanced usage topics
To learn more about document watermarking features and get familiar how to manage watermarks and more, please refer to the [advanced usage section]({{< ref "metadata/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Generate Document from Custom .NET Objects

Path: /assembly/net/basic-usage-custom-objects/


## Overview

One of the most common scenarios in document assembly is generating reports from custom .NET objects. GroupDocs.Assembly for .NET makes it easy to bind your business objects directly to templates, allowing you to create type-safe, maintainable document generation code.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents from templates
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data source objects

Here are the steps to generate documents from custom objects:

* Define your custom .NET class with public properties
* Create an instance of the class and populate it with data
* Create a template document with expression tags referencing object properties
* Use DocumentAssembler to assemble the template with your object
* Save the assembled document

{{< alert style="info" >}}
Custom objects must have public properties or fields to be accessible in templates. Private members are not accessible by the template engine.
{{< /alert >}}

## Define a Custom Class

Start by defining a class with properties you want to use in your template:

```csharp
public class Customer
{
    public string Name { get; set; }
    public string Email { get; set; }
    public string Address { get; set; }
    public DateTime RegistrationDate { get; set; }
    public decimal Balance { get; set; }
}
```

## Generate Document from Single Object

Generate a document from a single object instance:

```csharp
using GroupDocs.Assembly;

public static void GenerateFromSingleObject()
{
    // Create and populate object
    Customer customer = new Customer
    {
        Name = "John Doe",
        Email = "john.doe@example.com",
        Address = "123 Main St, New York, NY 10001",
        RegistrationDate = new DateTime(2023, 1, 15),
        Balance = 1250.75m
    };
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("CustomerTemplate.docx", "CustomerReport.docx", 
        new DataSourceInfo(customer, "customer"));
    
    Console.WriteLine("Document generated from custom object successfully.");
}
```

## Template Example

Your template (CustomerTemplate.docx) can reference object properties:

```
Customer Information

Name: <<[customer.Name]>>
Email: <<[customer.Email]>>
Address: <<[customer.Address]>>
Registration Date: <<[customer.RegistrationDate]:"yyyy-MM-dd">>
Balance: <<[customer.Balance]:"C">>
```

## Generate Document from Object Collection

You can also generate documents from collections of objects:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateFromCollection()
{
    // Create collection of objects
    List<Customer> customers = new List<Customer>
    {
        new Customer { Name = "John Doe", Email = "john@example.com", Balance = 1000m },
        new Customer { Name = "Jane Smith", Email = "jane@example.com", Balance = 2500m },
        new Customer { Name = "Bob Johnson", Email = "bob@example.com", Balance = 750m }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("CustomersTemplate.docx", "CustomersReport.docx", 
        new DataSourceInfo(customers, "customers"));
    
    Console.WriteLine("Document generated from collection successfully.");
}
```

Template for collection (using data band):

```
Customers List:

<<foreach [in customers]>>
<<[Name]>> - <<[Email]>> - Balance: <<[Balance]:"C">>
<</foreach>>
```

## Using Nested Objects

Custom objects can contain nested objects:

```csharp
public class Order
{
    public int OrderId { get; set; }
    public DateTime OrderDate { get; set; }
    public Customer Customer { get; set; }
    public decimal TotalAmount { get; set; }
}

public static void GenerateFromNestedObjects()
{
    Order order = new Order
    {
        OrderId = 1001,
        OrderDate = DateTime.Now,
        Customer = new Customer 
        { 
            Name = "John Doe", 
            Email = "john@example.com" 
        },
        TotalAmount = 599.99m
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("OrderTemplate.docx", "OrderReport.docx", 
        new DataSourceInfo(order, "order"));
    
    Console.WriteLine("Document generated from nested objects successfully.");
}
```

Template with nested object access:

```
Order #<<[order.OrderId]>>
Date: <<[order.OrderDate]:"yyyy-MM-dd">>

Customer:
Name: <<[order.Customer.Name]>>
Email: <<[order.Customer.Email]>>

Total: <<[order.TotalAmount]:"C">>
```

## Using Object Methods

You can call methods on objects in templates:

```csharp
public class Product
{
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int Quantity { get; set; }
    
    public decimal GetTotal()
    {
        return Price * Quantity;
    }
}

public static void GenerateWithMethods()
{
    Product product = new Product
    {
        Name = "Laptop",
        Price = 999.99m,
        Quantity = 2
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ProductTemplate.docx", "ProductReport.docx", 
        new DataSourceInfo(product, "product"));
    
    Console.WriteLine("Document generated with method calls successfully.");
}
```

Template using method:

```
Product: <<[product.Name]>>
Price: <<[product.Price]:"C">>
Quantity: <<[product.Quantity]>>
Total: <<[product.GetTotal()]:"C">>
```

{{< alert style="warning" >}}
Methods called in templates must be public and should not have side effects. The template engine may call methods multiple times during document assembly.
{{< /alert >}}

### Advanced Usage Topics

To learn more about working with complex object hierarchies, collections, LINQ queries on objects, and performance optimization, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Get a list of changes

Path: /comparison/nodejs-java/get-list-of-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to get a list of changes between the source and target documents.

The following code snippets show how to get a list of all changes:

## Get a list of changes from a local disk

The following example compares two local documents and then prints a detailed list of detected changes.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Create a Comparer instance for the source document on disk
const comparer = new groupdocs.Comparer('sample-files/source.docx');

// Add the target document to be compared against the source
comparer.add('sample-files/target.docx');

// Perform the comparison (no result file path is required for retrieving changes)
comparer.compare();

// Retrieve the array of ChangeInfo objects that describe each change
const changes = comparer.getChanges();

// Iterate through the collection and print details of every change
for (let index = 0; index < changes.length; index++) {
  const change = changes[index];

  const page = change.getPageInfo().getPageNumber(); // Page number where the change is located
  const type = change.getType().name();              // Type of change (Inserted, Deleted, etc.)
  const text = (change.getText() || '').trim();      // Normalized change text
  const src = (change.getSourceText() || '').trim(); // Text from the source document
  const tgt = (change.getTargetText() || '').trim(); // Text from the target document

  console.log(`[Page ${page}] ${type} "${text}", "${src}" -> "${tgt}"`);
}

// Exit the process when printing is finished
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and performs the comparison. It then retrieves all detected changes using `getChanges()` and iterates through the collection to extract and display detailed information about each change, including the page number, change type (Inserted, Deleted, etc.), the change text, and the source and target text fragments.

The result is as follows:

![](/comparison/nodejs-java/images/get-changes-list.png)

## Get a list of changes from a stream

The following example loads source and target documents from Java streams, compares them, and prints the list of changes.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import the Java bridge to work with FileInputStream
const java = require('java');
let InputStream = java.import('java.io.FileInputStream');

// Create input streams for the source and target documents
const sourceStream = new InputStream('sample-files/source.docx');
const targetStream = new InputStream('sample-files/target.docx');

// Create a Comparer instance using the source stream
const comparer = new groupdocs.Comparer(sourceStream);

// Add the target stream to be compared against the source
comparer.add(targetStream);

// Run the comparison to populate internal changes collection
comparer.compare();

// Retrieve the list of changes discovered during comparison
const changes = comparer.getChanges();

// Iterate through the collection and print detailed information about each change
for (let index = 0; index < changes.length; index++) {
  const change = changes[index];

  const page = change.getPageInfo().getPageNumber(); // Page number
  const type = change.getType().name();              // Change type
  const text = (change.getText() || '').trim();      // Combined change text
  const src = (change.getSourceText() || '').trim(); // Source text fragment
  const tgt = (change.getTargetText() || '').trim(); // Target text fragment

  console.log(`[Page ${page}] ${type} "${text}", "${src}" -> "${tgt}"`);
}

// Exit the process when all changes are printed
process.exit(0);
```

This example demonstrates the same workflow using Java input streams instead of file paths. It creates `InputStream` objects for both source and target documents, initializes the comparer with the source stream, adds the target stream, performs the comparison, and then retrieves and prints the list of changes with the same detailed information as the previous example.

---

## Get list of changes

Path: /comparison/java/get-list-of-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to get  list of changes between source and target documents.

To get list of changes, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method.
4.  Call the [getChanges](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getChanges--) method.

The following code snippets show how to get list of all changes:

## Get list of changes from local disk

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.result.ChangeInfo;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    comparer.compare();
    ChangeInfo[] changes = comparer.getChanges();
    for (ChangeInfo change : changes) {
        System.out.println("Change Type: " + change.getType() +
                           ", Page: " + change.getPageInfo().getPageNumber() +
                           ", Change ID: " + change.getId() +
                           ", Text: " + change.getText());
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/get-changes-list.png)

## Get list of changes from stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.result.ChangeInfo;
import java.io.FileInputStream;
import java.io.InputStream;
// ...

try (final FileInputStream sourceInputStream = new FileInputStream("source.docx");
    final Comparer comparer = new Comparer(sourceInputStream);
    final FileInputStream targetInputStream = new FileInputStream("target.docx")) {
    comparer.add(targetInputStream);
    comparer.compare();
    ChangeInfo[] changes = comparer.getChanges();
    for (ChangeInfo change : changes) {
        System.out.println("Change Type: " + change.getType() +
                            ", Page: " + change.getPageInfo().getPageNumber() +
                            ", Change ID: " + change.getId() +
                            ", Text: " + change.getText());
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Get list of changes

Path: /comparison/net/get-list-of-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to get  list of changes between source and target documents.

To get list of changes, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare) method.
4.  Call the [GetChanges](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/getchanges) method.

The following code snippets show how to get list of all changes:

## Get list of changes from local disk

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare();
    ChangeInfo[] changes = comparer.GetChanges();
    foreach (ChangeInfo change in changes)
        Console.WriteLine("Change Type: {0}, Page: {1}, Change ID: {2}, Text: {3}", 
            change.Type, 
            change.PageInfo.PageNumber, 
            change.Id, 
            change.Text
        );
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/get-changes-list.png)

## Get list of changes from stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer(File.OpenRead("source.docx")))
{
    comparer.Add(File.OpenRead("target.docx"));
    comparer.Compare();
    ChangeInfo[] changes = comparer.GetChanges();
    foreach (ChangeInfo change in changes)
        Console.WriteLine("Change Type: {0}, Page: {1}, Change ID: {2}, Text: {3}", 
            change.Type, 
            change.PageInfo.PageNumber, 
            change.Id, 
            change.Text
        );
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Get list of changes

Path: /comparison/python-net/get-list-of-changes/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) lets you query the list of detected changes after a comparison.

## Get list of changes from local disk

Run a comparison and iterate over the resulting `ChangeInfo` objects.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    comparer.compare()
    changes = comparer.get_changes()
    for change in changes:
        print(f"Type: {change.type}, Page: {change.page_info.page_number}, Id: {change.id}, Text: {change.text}")
```

🔹 Use case: Build a custom report UI that lists all differences with pagination info.

The result is as follows:

![](/comparison/python-net/images/get-changes-list.png)

## Get list of changes from stream

Compare from streams and retrieve the changes programmatically.

```python
import groupdocs.comparison as gc

with open("source.docx", "rb") as src, open("target.docx", "rb") as tgt:
    with gc.Comparer(src) as comparer:
        comparer.add(tgt)
        comparer.compare()
        changes = comparer.get_changes()
        for change in changes:
            print(f"Type: {change.type}, Page: {change.page_info.page_number}, Id: {change.id}, Text: {change.text}")
```

🔹 Use case: Integrate diff extraction into services that operate on file streams.



---

## Get the PDF output file information

Path: /viewer/java/get-pdf-output-file-info/


You can get the information about the PDF output file using the [getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method that returns a [ViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/) object. The object contains the [Pages](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/#getPages--) collection that represents each [Page](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/page/) of the document.

The following code snippet shows how to get the page count and the width and height of each document page:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
try (Viewer viewer = new Viewer("sample.pdf")) {
    // Get file information.
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.forPdfView();
    ViewInfo viewInfo = viewer.getViewInfo(viewInfoOptions);

    // Display page count.
    System.out.println("Pages count: " + viewInfo.getPages().size());

    // Display width and height of each page
    for (Page page : viewInfo.getPages()) {
        System.out.println("Page: " + page.getNumber() + "; Width: " + page.getWidth() + ", pixels");
        System.out.println("Page: " + page.getNumber() + "; Height: " + page.getHeight() + ", pixels");
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/java/images/get_pdf_output_file_info.png)

---

## Get the PDF output file information

Path: /viewer/net/get-pdf-output-file-info/


You can get the information about the PDF output file using the [GetViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/getviewinfo) method that returns a [ViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo) object. The object contains the [Pages](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/pages/) collection that represents each [Page](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/page/) of the document.

The following code snippet shows how to get the page count and the width and height of each document page:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("sample.pdf"))
{
    // Get file information.
    ViewInfoOptions viewInfoOptions = ViewInfoOptions.ForPdfView();
    ViewInfo viewInfo = viewer.GetViewInfo(viewInfoOptions);

    // Display page count.
    Console.WriteLine("Pages count: " + viewInfo.Pages.Count);

    // Display width and height of each page.
    foreach (Page page in viewInfo.Pages)
    {
        Console.WriteLine($"Page: {page.Number}; Width: {page.Width}, pixels");
        Console.WriteLine($"Page: {page.Number}; Height: {page.Height}, pixels");
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.pdf")
            ' Get file information.
            Dim viewInfoOptions As ViewInfoOptions = ViewInfoOptions.ForPdfView()
            Dim viewInfo As ViewInfo = viewer.GetViewInfo(viewInfoOptions)
        
            ' Display page count.
            Console.WriteLine("Pages count: " & viewInfo.Pages.Count.ToString())
        
            ' Display width and height of each page.
            For Each page As Page In viewInfo.Pages
                Console.WriteLine($"Page: {page.Number}; Width: {page.Width}, pixels")
                Console.WriteLine($"Page: {page.Number}; Height: {page.Height}, pixels")
            Next
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/get_pdf_output_file_info.png)

---

## How to change the maximum size of a file

Path: /viewer/java/how-to-change-max-file-size/

Due to the numerous resources and `.class` files in the JAR file, the `MANIFEST.MF` file has become huge. For instance, it is approximately 19.7 Mb for GroupDocs.Viewer v21.2 and 22.5 Mb for GroupDocs.Viewer v23.7. 

That is why you may get errors similar to the one below:

```sh
error: error reading /home/jenkins/.gradle/caches/modules-2/files-2.1/com.groupdocs/groupdocs-viewer/21.2/541f695e50f5ed475786402ce0be5978db3a8bb2/groupdocs-viewer-21.2.jar; Unsupported size: 19732345 for JarEntry META-INF/MANIFEST.MF. Allowed max size: 8000000 bytes
```

The issue arises from Java's file size limit, which is set at 8,000,000 bytes by default. You can resolve this using the `-Djdk.jar.maxSignatureFileSize=8000000` option in your Virtual Machine settings. Change the `8,000,000` to the required file size limit.


{{< tabs "example1">}}
{{< tab "Windows" >}}
```sh
SET MAVEN_OPTS="-Djdk.jar.maxSignatureFileSize=25000000"
mvn clean compile spring-boot:run
```
{{< /tab >}}
{{< tab "Linux" >}}
```sh
export MAVEN_OPTS="-Djdk.jar.maxSignatureFileSize=25000000"
mvn clean compile spring-boot:run
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
If needed, use the `JAVA_OPTS` or `JAVA_TOOL_OPTIONS` instead of `MAVEN_OPTS`.
{{< /alert >}}

---

## How to merge TIFF images using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-tiff-images-using-csharp/


## TIFF Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple TIFF documents in the preferred order and save them as a single file.

## About TIFF File Format

TIFF, Tag Image File Format, is a computer file used to store raster graphics and image information. A favorite among photographers, TIFFs are a handy way to store high-quality images before editing if you want to avoid lossy file formats.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### Source TIFF images

!["Sample1.tiff"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.tiff"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.tiff"](/merger/net/images/jpg/sample3.jpg)

### How to merge TIFF files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinmode) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```csharp
// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.tiff"))
{
    // Define image join options with vertical join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
    // Add another image file to merge
    merger.Join(@"c:\sample2.tiff", joinOptions);
    // Add next image file to merge
    merger.Join(@"c:\sample3.tiff", joinOptions);
    // Merge image files and save result
    merger.Save(@"c:\merged.tiff");
}
```

### Result merged TIFF image

!["Merged.tiff"](/merger/net/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TIFF Live Demo

GroupDocs.Merger for .NET provides an online [**TIFF Merger App**](https://products.groupdocs.app/merger/tiff), which allows you to try it for free and check its quality and accuracy.
---

## How to merge TIFF images using java

Path: /merger/java/getting-started/use-cases/how-to-merge-tiff-images-using-java/


## TIFF Merger Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple TIFF documents in the preferred order and save them as a single file.

## About TIFF File Format

TIFF, Tag Image File Format, is a computer file used to store raster graphics and image information. A favorite among photographers, TIFFs are a handy way to store high-quality images before editing if you want to avoid lossy file formats.

### Download and Configure

You can follow the steps below to reference GroupDocs.Merger for Java downloaded from official website [Downloads section](https://downloads.groupdocs.com/merger/java):

1. Unpack zip archive .
2. Switch to **lib** folder.
3. Run **install.bat** (for Windows) or **install.sh** (for Linux) file to install the library in your local maven repository.
4. After this you should add the merger **dependency** block to your *pom.xm*l project file.

### Source TIFF images

!["Sample1.tiff"](/merger/java/images/jpg/sample1.jpg)
!["Sample2.tiff"](/merger/java/images/jpg/sample2.jpg)
!["Sample3.tiff"](/merger/java/images/jpg/sample3.jpg)

### How to merge TIFF files in vertical mode

The following example demonstrates how to merge image files in vertical mode with several lines of java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinoptions/) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinmode/) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinoptions/) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [Save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged image file as parameter.

```java
// Load the source image file
Merger merger = new Merger("c:\sample1.tiff")

// Define image join options with vertical join mode
ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
// Add another image file to merge
merger.join("c:\sample2.tiff", joinOptions);
// Add next image file to merge
merger.join("c:\sample3.tiff", joinOptions);
// Merge image files and save result
merger.save("c:\merged.tiff");

```

### Result merged TIFF image

!["Merged.tiff"](/merger/java/images/jpg/merged_vertical.jpg)

### Code Examples

Please find more [use-cases and complete java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TIFF Live Demo

GroupDocs.Merger for Java provides an online [**TIFF Merger App**](https://products.groupdocs.app/merger/tiff), which allows you to try it for free and check its quality and accuracy.
---

## How to Run

Path: /assembly/python-net/how-to-run-examples/


The complete project [GroupDocs.Assembly Examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET) with code examples and sample files is hosted at Github.

## Run examples using PyPI

To get started make sure that [Python](https://www.python.org/) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET.git`
2. Navigate to the examples folder `cd ./GroupDocs.Assembly-for-Python-via-.NET/`
3. Install the necessary packages with the `pip install groupdocs-assembly-net` command.
4. Navigate to the examples folder `cd ./Examples`
5. Run the examples with the `python run_examples.py` command.

To check what examples are available open `Examples/run_examples.py` file using your favorite text editor. Uncomment examples that you want to run and type `python run_examples.py` to start them.



## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run

Path: /metadata/nodejs-java/how-to-run-examples/


The complete project [GroupDocs.Metadata Examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java) with code examples and sample files is hosted at Github.

## Run examples using NPM

To get started make sure that [Node.js](https://nodejs.org) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java.git`
2. Navigate to the examples folder `cd ./GroupDocs.Metadata-for-Node.js-via-Java/`
3. Install the necessary packages with the `npm install` command.
4. Navigate to the examples folder `cd ./Examples`
5. Run the examples with the `node runExamples.js` command.

To check what examples are available open `Examples/runExamples.js` file using your favorite text editor. Uncomment examples that you want to run and type `node runExamples.js` to start them.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run

Path: /metadata/python-net/how-to-run-examples/


The complete project [GroupDocs.Metadata Examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET) with code examples and sample files is hosted at Github.

## Run examples using PyPI

To get started make sure that [Python](https://www.python.org/) is installed.

1. Clone repository with GroupDocs.Metadata examples\
`git clone https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET.git`
2. Navigate to the examples folder\
`cd ./GroupDocs.Metadata-for-Python-via-.NET/`
3. Install the necessary packages\
`pip install groupdocs-metadata-net`
4. Navigate to the examples folder\
`cd ./Examples`
5. Run the examples\
`python run_examples.py`

To check what examples are available open `Examples/run_examples.py` file using your favorite text editor.

By default the examples are shipped without a license file and works in evaluation mode.
To run the examples in full featured mode, please set a valid license file path in the file "./Examples/constants.py":
```python
license_path = "С:\resources\Licenses\GroupDocs.Metadata.lic"
```
In case you don't have a license yet, feel free to [**get a temp license**](https://purchase.groupdocs.com/temporary-license) to evaluate GroupDocs.Metadata in full featured mode.


## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to run examples

Path: /conversion/java/how-to-run-examples/


The complete [GroupDocs.Conversion Examples](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java) project with code examples and sample files is hosted on GitHub.

## Run examples using Maven

To get started make sure that [Maven](https://maven.apache.org/download.cgi) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java.git`
2. Navigate to the examples folder `cd ./GroupDocs.Conversion-for-Java/Examples/`
3. Resolve dependencies and build the examples with the `mvn compile` command.
4. Run the examples with the `mvn exec:java` command.

To check what examples are available open `./src/main/java/com/groupdocs/conversion/examples/RunExamples.java` file using your favorite text editor. Uncomment examples that you want to run and type `mvn compile exec:java` to start them.

## Run examples using Eclipse IDE

To run the examples using Eclipse IDE import the project to get started with it:

1. Go to the `File` menu and click `Open Projects from File System...`
2. Open the `Examples` folder.
3. Open the `RunExamples.java` file and uncomment the examples you want to run.
4. Go to the `Run` menu and click `Run`.

The following screenshot shows the Examples project opened in Eclipse IDE.

![GroupDocs.Conversion for Java Examples in Eclipse IDE](/conversion/java/_images/how-to-run_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code, and create a pull request. We will review the changes and include them in the repository if found helpful.

---

## How to run examples

Path: /merger/nodejs-java/how-to-run-examples/


The complete project [GroupDocs.Merger Examples](https://github.com/groupdocs-merger/GroupDocs.Merger-for-Node.js-via-Java) with code examples and sample files is hosted at GitHub.

## Run examples using NPM

To get started make sure that [Node.js](https://nodejs.org) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-merger/GroupDocs.Merger-for-Node.js-via-Java.git`
2. Navigate to the examples folder `cd ./GroupDocs.Merger-for-Node.js-via-Java/`
3. Install the necessary packages with the `npm install` command.
4. Navigate to the examples folder `cd ./Examples`
5. Run the examples with the `node runExamples.js` command.

To check what examples are available open `Examples/runExamples.js` file using your favorite text editor. Uncomment examples that you want to run and type `node runExamples.js` to start them.


## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include them in the repository if found helpful.
---

## How to run examples

Path: /merger/python-net/how-to-run-examples/


The complete project [GroupDocs.Merger Examples](https://github.com/groupdocs-merger/GroupDocs.Merger-for-Python-via-.NET) with code examples and sample files is hosted at GitHub.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include them in the repository if found helpful.
---

## How to run examples

Path: /viewer/java/how-to-run-examples/


The complete project [GroupDocs.Viewer Examples](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java) with code examples and sample files is hosted at GitHub.

## Run examples using Maven

To get started make sure that [Maven](https://maven.apache.org/download.cgi) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java.git`
2. Navigate to the examples folder `cd ./GroupDocs.Viewer-for-Java/Examples/`
3. Resolve dependencies and build the examples by typing `mvn compile`
4. Run the examples by typing `mvn exec:java`

After you run the examples the following output should be printed to the console:
{{< tabs "example1">}}
{{< tab "Console" >}}  
```bash
Uncomment the example(s) that you want to run in RunExamples.java file.
=======================================================================

Source document rendered successfully.
Check output in /src/GroupDocs.Viewer-for-Java/Examples/output/HelloWorld

All done.
```
{{< /tab >}}
{{< /tabs >}}
By default there is only one `HelloWorld` example is executing and two HTML should be created in `/src/GroupDocs.Viewer-for-Java/Examples/output/HelloWorld` folder.

To check what examples are available open `./src/main/java/com/groupdocs/viewer/examples/RunExamples.java` file using your favorite text editor. Uncomment examples that you want to run and type `mvn compile exec:java` to start them.

## Run examples using Eclipse IDE

To run the examples using Eclipse IDE import the project to get started with it:

1. Go to `File` menu and click `Open Projects from File System...`
2. Open `Examples` folder
3. Open `RunExamples.java` file and uncomment the examples you want to run
4. Go to `Run` menu and click `Run`

The following screenshot shows the Examples project opened in Eclipse IDE.

![GroupDocs.Viewer for Java Examples in Eclipse IDE](/viewer/java/images/samples_eclipse-viewer.png)

The following text will be printed to the `Console` window:
{{< tabs "example2">}}
{{< tab "Console" >}}
```bash
Uncomment the example(s) that you want to run in RunExamples.java file.
=======================================================================

Source document rendered successfully.
Check output in /src/GroupDocs.Viewer-for-Java/Examples/output/HelloWorld

All done.
```
{{< /tab >}}
{{< /tabs >}}
---

## How to run examples

Path: /viewer/net/how-to-run-examples/


We offer multiple solutions on how you can run GroupDocs.Viewer examples, by building your own or using our back-end or front-end examples.

## Build project from scratch

You can build a project from scratch using Visual Studio or [.NET CLI](https://docs.microsoft.com/en-us/dotnet/core/tools/). We'll step you through both cases.

### Build project using .NET CLI

1. Make sure you have .NET Core or .NET SDK installed <https://dotnet.microsoft.com/download>.
2. Create a directory for your console app by executing e.g. `mkdir my-console-app` in your terminal.
3. Navigate to `my-console-app` directory by executing `cd my-console-app`.
4. Create empty console app by executing `dotnet new console`
5. Add GroupDocs.Viewer for .NET package `dotnet add package GroupDocs.Viewer`
6. Edit `Program.cs` and add the following lines to the `Main` method
{{< tabs "example1">}}
{{< tab "C#" >}}  
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
   string outputFilePathFormat = @"output\page-{0}.html";
   HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources(outputFilePathFormat);
   
   viewer.View(options);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            Dim outputFilePathFormat As String = "output\page-{0}.html"
            Dim options As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources(outputFilePathFormat)

            viewer.View(options)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
7. Replace `documentPath` value with the actual path to the document you're going to render.
8. Run the project by executing `dotnet run`.
9. Check the output in `C:\\output\\` directory.

### Build project using Visual Studio

1. Open Visual Studio and go to **File** -> **New** -> **Project**.
2. Select appropriate project type e.g. Console Application or Console App (.NET Framework)
3. Install **GroupDocs.Viewer for .NET** from Nuget or official GroupDocs website with one of ways listed in "Installation"({{< ref "installation" >}}) section.
4. Add the following code to the `Main` method:
{{< tabs "example2">}}
{{< tab "C#" >}}  
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
   string outputFilePathFormat = @"output\page-{0}.html";
   HtmlViewOptions options = HtmlViewOptions.ForEmbeddedResources(outputFilePathFormat);
   viewer.View(options);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            Dim outputFilePathFormat As String = "output\page-{0}.html"
            Dim options As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources(outputFilePathFormat)
            viewer.View(options)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
5. Replace `documentPath` value with the actual path to the document you're going to render.
6. Build and Run your project.
7. Rendered document pages will be saved in `C:\\output\\` directory.

## Run back-end examples

You can find number of back-end examples in our repository hosted on [Github](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET). You can either download the ZIP file from [here](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/archive/master.zip) or clone the repository of Github using your favorite git client.  
In case you download the ZIP file, extract the folders on your local disk.

1. Navigate to `Examples` directory and open `GroupDocs.Viewer.Examples.CSharp.sln` using Visual Studio.
2. Open `RunExamples.cs` file and uncomment the example(s) that you would like to run.
3. Optionally you can set the path to the license in `Utils.cs` file.

## Run Demo Projects

To run any demo from [GroupDocs.Viewer for .NET Demo projects](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/tree/master/Demos/) you can either:

* Clone the repository:
{{< tabs "example3">}}
{{< tab "Git" >}}  
```bash
git clone git@github.com:groupdocs-viewer/GroupDocs.Viewer-for-.NET.git  
```
{{< /tab >}}
{{< /tabs >}}
* Or [download](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/archive/master.zip) source code.

### ASP.NET Core Demo

1. Clone or download ["GroupDocs.Viewer-for-.NET"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET) repository from GitHub or skip this step if you already have the code.
2. Navigate to `Demos/ASP.NET Core` folder.
3. Execute `dotnet run` in a terminal.
4. Open [http://localhost:8080/viewer](http://localhost:8080/viewer) in your favorite browser.

### ASP.NET MVC Demo

1. Clone or download ["GroupDocs.Viewer-for-.NET"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET) repository from GitHub or skip this step if you already have the code.
2. Navigate to  `Demos/MVC` folder.
3. Open `GroupDocs.Viewer MVC.sln` solution in `Demos/MVC` folder using Visual Studio.
4. Update parameters in **web.config** and demo related properties in the **configuration.yml** to meet your requirements, see more about configuring the demo at ["Configuration"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/tree/master/Demos/MVC#configuration) section.
5. Run the project and open [http://localhost:8080/viewer](http://localhost:8080/viewer) in your favorite browser.

{{< alert style="info" >}}

For more details about demo configuration please refer to ["Configuration"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/tree/master/Demos/MVC#configuration) section.

{{< /alert >}}

### ASP.NET Web Forms Demo

1. Clone or download ["GroupDocs.Viewer-for-.NET"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET) repository from GitHub or skip this step if you already have the code.
2. Navigate to `Demos/WebForms` folder.
3. Open `GroupDocs.Viewer.WebForms.sln` solution using Visual Studio.
4. Open solution in the VisualStudio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
5. Open [http://localhost:8080/viewer](http://localhost:8080/viewer) in your favorite browser.

{{< alert style="info" >}}

For more details about demo configuration please refer to ["Configuration"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/tree/master/Demos/WebForms#configuration) section.

{{< /alert >}}

### WPF Demo

1. Clone or download ["GroupDocs.Viewer-for-.NET"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET) repository from GitHub or skip this step if you already have the code.
2. Navigate to `Demos/WPF/src` folder.
3. Open `GroupDocs.Viewer.WPF.sln` using Visual Studio.
4. Run the project.

### Windows Forms Demo

1. Clone or download ["GroupDocs.Viewer-for-.NET"](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET) repository from GitHub or skip this step if you already have the code.
2. Navigate to `Demos/WinForms/src` folder.
3. Open `GroupDocs.Viewer.WinForms.sln` using Visual Studio.
4. Run the project.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to run examples

Path: /watermark/net/how-to-run-examples/

{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Watermark has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Watermark examples, by building your own or using our examples out-of-the-box.

Please choose one from the following list:

## Build project from scratch

* Open Visual Studio and go to **File** -> **New** -> **Project**.
* Select appropriate project type - Console App, ASP.NET Web Application etc.
* Install **GroupDocs.Watermark for .NET** from Nuget or official GroupDocs website following this [guide]({{< ref "watermark/net/getting-started/installation.md" >}}).
* Code your first application with **GroupDocs.Watermark for .NET** like this

```csharp
string documentPath = "doc.pdf"; // NOTE: Put here actual path for your document
PdfLoadOptions loadOptions = new PdfLoadOptions();
using (Watermarker watermarker = new Watermarker(documentPath, loadOptions))
{
    TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 36, FontStyle.Bold | FontStyle.Italic));
    PdfXObjectWatermarkOptions options = new PdfXObjectWatermarkOptions();
    options.PageIndex = 0;

    watermarker.Add(watermark, options);
    watermarker.Save("watermarked.pdf");
}
```

* Build and Run your project.
* Watermarked document will appear in the working directory as *watermarked.pdf*.

## Run examples

The complete examples package of **GroupDocs.Watermark** is hosted on [GitHub](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-.NET). You can either download the ZIP file from [here](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-.NET/archive/master.zip) or clone the repository of GitHub using your favourite git client. In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![how-to-run-examples](/watermark/net/images/how-to-run-examples.jpg)

In extracted files and folders, you can find CSharp solution file. The project is created in **Microsoft Visual Studio 2019**. The **Resources** folder contains all the sample document and image files used in the examples. To run the examples, open the solution file in Visual Studio and build the project. To add missing references of **GroupDocs.Watermark** see [Installation]({{< ref "watermark/net/getting-started/installation.md" >}}). All the functions are called from **RunExamples.cs**.

Un-comment the function you want to run and comment the rest.

![how-to-run-examples_1](/watermark/net/images/how-to-run-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications. To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /annotation/net/how-to-run-examples/

{{< alert style="warning" >}}
Before running an example make sure that GroupDocs.Annotation has been installed successfully.
{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Annotation examples, by building your own or using our back-end or front-end examples out-of-the-box.

## Build project from scratch

To build a project from scratch, follow these steps:

1.   Open Visual Studio and navigate to **File** -> **New **\->** Project**.
2.   Select the appropriate project type - Console App, ASP.NET Web App etc.
3.   Install **GroupDocs.Annotation for .NET** from NuGet or official GroupDocs website as described in the [guide]({{< ref "annotation/net/getting-started/installation.md" >}}).
4.   Develop the application using **GroupDocs.Annotation for .NET** like this:
{{< tabs "example1">}}
{{< tab "C#" >}}  
```csharp
// Create list of annotations
List<AnnotationBase> annotations = new List<AnnotationBase>()
{
    new AreaAnnotation()
    {
        PageNumber = 0,
        Box = new Rectangle(100, 100, 100, 100),
        Message = "area"
    },
                
    new EllipseAnnotation()
        {
            PageNumber = 0,
            Box = new Rectangle(200, 200, 80, 80),
            Message = "ellipse"
        }
};

// Create annotator
using  (Annotator annotator = new Annotator("C:\output\input.pdf"))
{
    // Add annotations
    annotator.Add(annotations);
    // Save result to "C:\output\result.pdf"
    annotator.Save("C:\output\result.pdf", new SaveOptions());
}
```
{{< /tab >}}
{{< /tabs >}}    
5.   Build and run your project. 
6.   Rendered document pages appears in the `C:\\output\\` directory.

## Run back-end examples

You can find the complete package of the **GroupDocs.Annotation** examples on [GitHub](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET). You can either [download the ZIP file](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET/archive/master.zip) or clone the GitHub repository using your any git client.  
If you downloaded the ZIP file, extract the folders to the local disk. The extracted files and folders look as follows:

![](/annotation/net/images/how-to-run-examples.png)

Find the CSharp solution file. The project is created in **Microsoft Visual Studio 2019**. The `Resources` folder contains all the sample documents and images used in the examples.  
To run the examples, open the solution file with Visual Studio and build the project. If needed, add missing references of GroupDocs.Annotation. All the functions are called in the **RunExamples.cs** file. Uncomment the function(s) you want to run and comment the rest.

![](/annotation/net/images/how-to-run-examples_1.png)

## Run MVC examples

To run the [GroupDocs.Annotation for .NET MVC Example](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-MVC), follow these steps:

1.   Download the [source code](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-MVC/archive/master.zip) from GitHub or clone the repository: 
{{< tabs "example2">}}
{{< tab "Git" >}} 
```bash
git clone https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-MVC
{{< /tab >}}
{{< /tabs >}}  
2.   Open solution with the Visual Studio. Update common parameters in **web.config** and example related properties in **configuration.yml** to meet your requirements.  
3.   Open [http://localhost:8080/annotation](http://localhost:8080/annotation) in your favorite browser.

For details about project configuration please refer to this [guide](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-MVC#configuration).

## Run WebForms examples

To run the [GroupDocs.Annotation for .NET Web.Forms Example](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-WebForms), follow these steps:

1.   Download [the source code](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-WebForms/archive/master.zip) from GitHub or clone this repository:
{{< tabs "example3">}}
{{< tab "Git" >}} 
```bash
git clone https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-WebForms.git
```
{{< /tab >}}
{{< /tabs >}}  
2.   Open solution with the Visual Studio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
3.   Open [http://localhost:8080/annotation](http://localhost:8080/annotation) in your favorite browser.
For details about project configuration please refer to this [guide](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-.NET-WebForms#configuration).

## Run from Docker

Use the [Docker](https://www.docker.com/) image to try GroupDocs.Annotation for .NET features. Execute the following commands to run GroupDocs.Annotation for .NET from docker image:
{{< tabs "example4">}}
{{< tab "PowerShell" >}}
```
mkdir DocumentSamples
mkdir Licenses
docker run -p 8080:8080 --env application.hostAddress=localhost -v `pwd`/DocumentSamples:/home/groupdocs/app/DocumentSamples -v `pwd`/Licenses:/home/groupdocs/app/Licenses groupdocs/annotation
## Open http://localhost:8080/annotation in your favorite browser.
```
{{< /tab >}}
{{< /tabs >}}

## Contribute

If you want to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your applications.

To contribute, fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /comparison/java/how-to-run-examples/


{{< alert style="warning" >}}Before running an example, make sure that Java and Maven have been installed successfully and operate properly.{{< /alert >}}

## Download from GitHub

The complete examples package of **[GroupDocs.Comparison for Java](https://products.groupdocs.com/comparison/java)** is hosted on [Github](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java.git). You can either download the ZIP file from [here](https://codeload.github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java/zip/master) or clone the repository of Github using your favorite Github client.

If you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java/blob/master/Examples/GroupDocs.Comparison.Examples.Java/Data/Screenshots/folder.PNG?raw=true)

Open Eclipse and import the project to get started with it. Uncomment the appropriate example and run the project (the `main` method).

![](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java/blob/master/Examples/GroupDocs.Comparison.Examples.Java/Data/Screenshots/eclipse.PNG?raw=true)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /comparison/nodejs-java/how-to-run-examples/


The complete project [GroupDocs.Comparison for Node.js via Java — Code Examples](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Node.js-via-Java) with runnable examples and sample files is hosted on GitHub. The structure and commands below are based on this repository and its README.

## Prerequisites

Before running examples, make sure your environment meets the [System Requirements]({{< ref "comparison/nodejs-java/getting-started/system-requirements" >}}) and [Installation]({{< ref "comparison/nodejs-java/getting-started/installation" >}}) guides:

- **Node.js**: 20 LTS or later
- **Java**: JRE/JDK 8+ (17 LTS recommended)
- **Java environment**: `JAVA_HOME` set and added to `PATH`

Windows PowerShell:

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS:

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH=$JAVA_HOME/bin:$PATH
```

For more details, see the examples repository README:  
[GroupDocs.Comparison for Node.js via Java — Code Examples README](https://raw.githubusercontent.com/groupdocs-comparison/GroupDocs.Comparison-for-Node.js-via-Java/refs/heads/master/README.md).

## Run examples using npm

To get started, make sure that [Node.js](https://nodejs.org/) and Java are installed and configured as described above.

1. **Clone the repository with examples**

   ```bash
   git clone https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Node.js-via-Java.git
   cd GroupDocs.Comparison-for-Node.js-via-Java
   ```

2. **Install dependencies**

   ```bash
   npm install
   ```

   This installs the bundled `groupdocs-groupdocs.comparison-<version>.tgz` package and other dependencies defined in `package.json`.  
   If installation fails with native build errors, review the build tools section in [System Requirements]({{< ref "comparison/nodejs-java/getting-started/system-requirements" >}}).

3. **Run all examples**

   ```bash
   npm start
   ```

   Output documents are created under the `Output/` directory, grouped by example.

## Explore available examples

After running the project once, you may want to see what examples are available and how they are organized:

- Open `examples.js` and `runExamples.js` to review the list of functions being called.
- Enable or disable specific examples by editing `runExamples.js` and re-running:

  ```bash
  npm start
  ```

Refer to the examples README for an overview of QuickStart, BasicUsage, and AdvancedUsage folders and the scenarios they cover  
([README](https://raw.githubusercontent.com/groupdocs-comparison/GroupDocs.Comparison-for-Node.js-via-Java/refs/heads/master/README.md)).


---

## How to Run Examples

Path: /comparison/python-net/how-to-run-examples/

The complete project [GroupDocs.Comparison Examples](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-P-via-.NET) with code examples and sample files is hosted on GitHub.

## Run examples using PYPI

To get started make sure that [Python](https://python.org/) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Python-via-.NET.git`
2. Navigate to the project folder `cd ./GroupDocs.Comparison-for-Python-via-.NET`
3. Install the necessary packages with the `pip install groupdocs-comparison-net` command.
4. Run the examples with the `python run_examples.py` command.

To check what examples are available, open the `run_examples.py` file in your favorite text editor. Uncomment examples you want to run and type `python run_examples.py` to start them.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open-source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include them in the repository if found helpful.

---

## How to Run Examples

Path: /conversion/nodejs-java/how-to-run-examples/


The complete project [GroupDocs.Conversion for Node.js via Java — Code Examples](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Node.js-via-Java) with runnable examples and sample files is hosted on GitHub. The structure and commands below are based on this repository and its README.

## Prerequisites

Before running examples, make sure your environment meets the [System Requirements]({{< ref "conversion/nodejs-java/getting-started/system-requirements" >}}) and [Installation]({{< ref "conversion/nodejs-java/getting-started/installation" >}}) guides:

- **Node.js**: 20 LTS or later
- **Java**: JRE/JDK 8+ (17 LTS recommended)
- **Java environment**: `JAVA_HOME` set and added to `PATH`

Windows PowerShell:

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS:

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH=$JAVA_HOME/bin:$PATH
```

For more details, see the examples repository README:  
[GroupDocs.Conversion for Node.js via Java — Code Examples README](https://raw.githubusercontent.com/groupdocs-conversion/GroupDocs.Conversion-for-Node.js-via-Java/refs/heads/master/README.md).

## Run examples using npm

To get started, make sure that [Node.js](https://nodejs.org/) and Java are installed and configured as described above.

1. **Clone the repository with examples**

   ```bash
   git clone https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Node.js-via-Java.git
   cd GroupDocs.Conversion-for-Node.js-via-Java
   ```

2. **Install dependencies**

   ```bash
   npm install
   ```

   This installs the bundled `groupdocs-conversion-<version>.tgz` package and other dependencies defined in `package.json`.  
   If installation fails with native build errors, review the build tools section in [System Requirements]({{< ref "conversion/nodejs-java/getting-started/system-requirements" >}}).

3. **Run all examples**

   ```bash
   npm start
   ```

   Output documents are created under the `./Examples/Output/` directory

## Explore available examples

After running the project once, you may want to see what examples are available and how they are organized:

- Open `examples.js` and `runExamples.js` to review the list of functions being called.
- Enable or disable specific examples by editing `runExamples.js` and re-running:

  ```bash
  npm start
  ```

Refer to the examples [README](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Node.js-via-Java) for an overview of QuickStart, BasicUsage, and AdvancedUsage folders and the scenarios they cover.

---

## How to Run Examples

Path: /editor/java/how-to-run-examples/

## Download from GitHub

The complete examples package of **GroupDocs.Editor** is hosted on [Github](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java). You can either download the ZIP file or clone the repository of Github using your favorite Github client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:
![](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java/blob/master/Examples/Data/Screenshots/folder.JPG?raw=true)

Open Eclipse and import the project to get started with it. Archived project file can also be imported.Follow the given steps to run the application:

* Go to project properties.
* Click on Java Build Path.
* Go to Libraries and external Jars (GroupDocs.Editor.Jar).
![](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java/blob/master/Examples/Data/Screenshots/eclipse.JPG?raw=true)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /editor/net/how-to-run-examples/

{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Editor has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Editor examples, by building your own or using our back-end or front-end examples out-of-the-box.

Please choose one from the following list:

## Build project from scratch

* Open Visual Studio and go to **File** -> **New** -> **Project**.
* Select appropriate project type - Console App, ASP.NET Web Application etc.
* Install **GroupDocs.Editor for .NET** from Nuget or official GroupDocs website following this [guide]({{< ref "editor/net/getting-started/installation.md" >}}).
* Code your first application with **GroupDocs.Editor for .NET** like this:

```csharp
string documentPath = @"C:\sample.docx"; // NOTE: Put here actual path for your document
using (Editor editor = new Editor(documentPath))
{
    // Obtain editable document from original DOCX document
    WordProcessingEditOptions editOptions = new WordProcessingEditOptions();
    EditableDocument editableDocument = editor.Edit(editOptions);

    // Pass EditableDocument object to WYSIWYG editor and edit there...
    // ...

    // Save edited EditableDocument object to some WordProcessing format - DOC for example
    WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(Formats.WordProcessingFormats.Docx);
    editor.Save(editableDocument, @"C:\output\edited.docx", saveOptions);
}
```

* Build and Run your project. 
* Rendered document pages will appear inside *"C:\\output\\"* directory.

## Run back-end examples

The complete examples package of **GroupDocs.Editor** is hosted on [GitHub](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET). You can either download the ZIP file from [here](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET/archive/master.zip) or clone the repository of GitHub using your favourite git client.  
In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/editor/net/images/how-to-run-examples.png)

In extracted files and folders, you can find CSharp solution file. The project is created in **Microsoft Visual Studio 2019**. The **Resources** folder contains all the sample document and image files used in the examples.  
To run the examples, open the solution file in Visual Studio and build the project. To add missing references of **GroupDocs.Editor** see [Development Environment, Installation and Configuration]({{< ref "editor/net/getting-started/installation.md" >}}). All the functions are called from **RunExamples.cs**.
Un-comment the function you want to run and comment the rest.

![](/editor/net/images/how-to-run-examples_1.png)

## Run MVC examples

You can run [GroupDocs.Editor for .NET MVC Example](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-MVC) following these steps:

*  Download [source code](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-MVC/archive/master.zip) from GitHub or clone this repository

```csharp
git clone https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-MVC
```

* Open solution in the VisualStudio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
* Open [http://localhost:8080/editor](http://localhost:8080/editor) in your favorite browser

For more details about project configuration please refer to this [guide](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-MVC#configuration).

## Run WebForms examples

You can run [GroupDocs.Editor for .NET Web.Forms Example](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-WebForms) following these steps:

* Download [source code](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-WebForms/archive/master.zip) from GitHub or clone this repository
  
```csharp
git clone https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-WebForms
```

* Open solution in the VisualStudio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
* Open [http://localhost:8080/editor](http://localhost:8080/editor) in your favorite browser

For more details about project configuration please refer to this [guide](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET-WebForms#configuration).

## Run from Docker

Use [Docker](https://www.docker.com/) image to try GroupDocs.Editor features in an easy way. Here are the command to run GroupDocs.Editor from docker image.

```csharp
mkdir DocumentSamples
mkdir Licenses
docker run -p 8080:8080 --env application.hostAddress=localhost -v `pwd`/DocumentSamples:/home/groupdocs/app/DocumentSamples -v `pwd`/Licenses:/home/groupdocs/app/Licenses groupdocs/Editor
## Open http://localhost:8080/editor in your favorite browser.
```

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /editor/nodejs-java/how-to-run-examples/

## Download from GitHub

The complete examples package of **GroupDocs.Editor** is hosted on [Github](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java). You can either download the ZIP file or clone the repository of Github using your favorite Github client.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /metadata/net/how-to-run-examples/

## Download from GitHub

The complete examples package of **GroupDocs.Metadata** is hosted on [Github](https://github.com/groupdocsmetadata/GroupDocs_Metadata_NET). You can either download the ZIP file from [here](https://github.com/groupdocsmetadata/GroupDocs_Metadata_NET/archive/master.zip) or clone the repository of Github using your favorite Github client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/metadata/net/images/how-to-run-examples.png)

This project is created in **Microsoft Visual Studio 2017**. The **SampleFiles** folder contains all the sample document and image files used in the examples.

To run the examples, open solution file in Visual Studio and build the project. All the functions are called from **RunExamples.cs** . Uncomment the function you want to run.

![](/metadata/net/images/how-to-run-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /parser/java/how-to-run-examples/

## Download from GitHub

The complete examples package of **GroupDocs.Parser** is hosted on [GitHub](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java). You can either download the ZIP file from [here](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java/archive/master.zip) or clone the repository of GitHub using your favorite GitHub client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/parser/java/images/how-to-run-examples.png)

Open IntelliJ Idea and import the project to get started with it. Archived project file can also be imported. Follow the given steps to run the application:

*   Click file from the toolbar
*   Open project structure using  (CTRL + SHIFT + ALT + S on Windows/Linux, ? + ; on Mac OS X)
*   Select Modules at the left panel
*   Open Dependencies tab
*   Click '+' and click JARs or directories

![](/parser/java/images/how-to-run-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /parser/net/how-to-run-examples/

{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Parser has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Parser examples, by building your own or using our examples out-of-the-box.

Please choose one from the following list:


## Build project from scratch

*   Open Visual Studio and go to **File** -> **New** \-> **Project**;
*   Select appropriate project type - Console App, ASP.NET Web Application etc;
*   Install **GroupDocs.Parser for .NET **from Nuget or official GroupDocs website following this [guide]({{< ref "parser/net/getting-started/installation.md" >}});
*   Code your first application with **GroupDocs.Parser for .NET** like this:
    
    ```csharp
    // Create an instance of Parser class
    using (Parser parser = new Parser("c:\\documents\\sample.docx")) // NOTE: Put here actual path for your document
    {
        // Extract a text to the reader
        using (TextReader reader = parser.GetText())
        {
            // Print an extracted text (or "not supported" message)
            Console.WriteLine(reader == null ? "Text extraction isn't supported" : reader.ReadToEnd());
        }
    }
    ```
    

*   Build and Run your project;
*   Extracted text will appear on the console.

## Run examples

The complete examples package of **GroupDocs.Parser** is hosted on [GitHub](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET/). You can either download the ZIP file from [here](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET/archive/master.zip) or clone the repository of GitHub using your favorite git client.  
In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/parser/net/images/how-to-run-examples.png)

In extracted files and folders, you can find CSharp solution file. The project is created in **Microsoft Visual Studio 2019**. The **Resources **folder contains all the sample document and image files used in the examples.  
To run the examples, open the solution file in Visual Studio and build the project. To add missing references of **GroupDocs.Parser** see [Development Environment, Installation and Configuration]({{< ref "parser/net/getting-started/installation.md" >}}). All the functions are called from **RunExamples.cs**.
Un-comment the function you want to run and comment the rest.

![](/parser/net/images/how-to-run-examples_1.png)

---

## How to Run Examples

Path: /parser/python-net/how-to-run-examples/


The complete project [GroupDocs.Parser Examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET) with code examples and sample files is hosted on GitHub.

## Run examples using PyPI

To get started make sure that [Python](https://python.org/) is installed (version 3.5 or higher).

1. Clone repository with examples:
   ```bash
   git clone https://github.com/groupdocs-parser/GroupDocs.Parser-for-Python-via-.NET.git
   ```

2. Navigate to the project folder:
   ```bash
   cd ./GroupDocs.Parser-for-Python-via-.NET
   ```

3. Install the necessary packages:
   ```bash
   pip install groupdocs-parser-net
   ```

4. Run the examples:
   ```bash
   python run_examples.py
   ```

To check what examples are available, open the `run_examples.py` file in your favorite text editor. Uncomment examples you want to run and type `python run_examples.py` to start them.

## Build project from scratch

If you prefer to create a project from scratch, follow these steps:

### Step 1: Install GroupDocs.Parser

Install GroupDocs.Parser for Python via .NET using pip:

```bash
pip install groupdocs-parser-net
```

### Step 2: Create a Python Script

Create a new Python file (e.g., `example.py`) and add the following code:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_text_from_document():
    # Create an instance of Parser class
    with Parser("./sample.docx") as parser:
        # Extract text from the document
        text_reader = parser.get_text()
        
        if text_reader is not None:
            # Print the extracted text
            extracted_text = text_reader
            print(extracted_text)
        else:
            print("Text extraction isn't supported for this format")

if __name__ == "__main__":
    extract_text_from_document()
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/getting-started/how-to-run-examples/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Step 3: Run the Script

Execute your Python script:

```bash
python example.py
```

The extracted text will appear in the console.

## Common Examples

### Extract Text from PDF
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_text_from_pdf():
    with Parser("./sample.pdf") as parser:
        text_reader = parser.get_text()
        if text_reader:
            print(text_reader)

if __name__ == "__main__":
    extract_text_from_pdf()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/how-to-run-examples/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Extract Metadata
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_metadata_example():
    with Parser("./sample.docx") as parser:
        metadata = parser.get_metadata()
        if metadata:
            for item in metadata:
                print(f"{item.name}: {item.value}")

if __name__ == "__main__":
    extract_metadata_example()
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/getting-started/how-to-run-examples/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Extract Images
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

def extract_images_example():
    with Parser("./sample.pdf") as parser:
        images = parser.get_images()
        if images:
            for i, image in enumerate(images):
                with open(f"image_{i}.png", "wb") as file:
                    image_stream = image.get_image_stream()
                    file.write(image_stream.read())

if __name__ == "__main__":
    extract_images_example()
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/getting-started/how-to-run-examples/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open-source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include them in the repository if found helpful.

---

## How to Run Examples

Path: /redaction/java/how-to-run-examples/


## Prerequisites

Before running the examples, ensure you have:

- **Java JDK 8 or later** (JDK 17 LTS recommended) - See [System Requirements]({{< ref "redaction/java/getting-started/system-requirements.md" >}})
- **Maven 3.6 or later** - For building and running examples
- **Git** - To clone the repository (optional)

## Getting the Examples

### Option 1: Clone from GitHub

Clone the repository to your local machine:

```bash
git clone https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java.git
cd GroupDocs.Redaction-for-Java
```

### Option 2: Download ZIP

Download the repository as a ZIP file from [GitHub](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java) and extract it.

## Installation

Navigate to the `Examples` directory and install dependencies:

```bash
cd Examples
mvn clean install
```

This command will:
- Download the GroupDocs.Redaction library and all required dependencies
- Compile all example classes
- Prepare the project for execution

## Running All Examples

Execute all examples using Maven:

```bash
cd Examples
mvn compile exec:java
```

This will run all examples sequentially. Output files are saved to `target/Output/<example-name>/`.

## Output Location

All example outputs are saved to:

```
Examples/target/Output/<example-name>/
```

For example:
- `HelloWorld` example → `target/Output/HelloWorld/`
- `ApplyRedaction` example → `target/Output/ApplyRedaction/`

## Troubleshooting

### Maven Build Errors

If dependencies fail to download:

```bash
# Clean and rebuild
mvn clean install -U
```

### Java Version Issues

Ensure you're using Java 8 or later:

```bash
java -version
javac -version
```

Set `JAVA_HOME` environment variable if needed.

### Missing Sample Files

Ensure all sample files are present in `Examples/Resources/SampleFiles/`. If files are missing, examples may fail.

### License Warnings

Examples run in trial mode by default. To remove license warnings:

1. Get a temporary license from [GroupDocs](https://purchase.groupdocs.com/temp-license/100510)
2. Update `Constants.java` with your license path
3. Run `SetLicenseFromFile` example

## Repository

View the complete source code and examples on GitHub:

**https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java**
---

## How to Run Examples

Path: /redaction/net/how-to-run-examples/

{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Redaction has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Redaction examples, by building your own or using our back-end or front-end examples out-of-the-box.

Please choose one from the following list:


## Build project from scratch

*   Open Visual Studio and go to **File** -> **New **\->** Project**.
*   Select appropriate project type - Console App, ASP.NET Web Application etc.
*   Install **GroupDocs.Redaction for .NET **from Nuget or official GroupDocs website following this [guide]({{< ref "redaction/net/getting-started/how-to-run-examples.md" >}}).
*   Code your first application with **GroupDocs.Redaction for .NET **like this
    
    ```csharp
    string documentPath = @"C:\sample.docx"; // NOTE: Put here actual path for your document
    using (Redactor redactor = new Redactor(documentPath))
    {
          // replace with text
          redactor.Apply(new RegexRedaction("\\d{2}\\s*\\d{2}[^\\d]*\\d{6}", new ReplacementOptions("[removed]")));
          // replace with blue solid rectangle
          redactor.Apply(new RegexRedaction(@"^\d+[,\.]{1}\d+$", new ReplacementOptions(System.Drawing.Color.Blue)));
          redactor.Save();
    }
    ```
    
*   Build and Run your project. 
*   Redacted document will appear in workingdirectory as *"sample\_Redacted.pdf".*

## Run back-end examples

The complete examples package of **GroupDocs.Redaction** is hosted on [Github](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET). You can either download the ZIP file from [here](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET/archive/master.zip) or clone the repository of Github using your favorite git client.  
In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/redaction/net/images/how-to-run-examples.png)

In the extracted Examples folder you can find GroupDocs.Redaction.Examples C# solution file. The project is created in **Microsoft Visual Studio 2017**. The **Resources **folder contains all the sample document and image files used in the examples.  
To run the examples, open the solution file in Visual Studio and build the project. To add missing references of **GroupDocs.Redaction** see [Development Environment, Installation and Configuration](https://docs.groupdocs.com/display/redactionnet/Development+Environment%2C+Installation+and+Configuration). All the functions are called from **RunExamples.cs**.   
Un-comment the function you want to run and comment the rest.

![](/redaction/net/images/how-to-run-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /signature/java/how-to-run-examples/

  

## Download from GitHub

The complete examples package of **GroupDocs.Signature** is hosted on [GitHub](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java). You can either download the ZIP file or clone the repository of GitHub using your favorite GitHub client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/signature/java/images/how-to-run-examples.png)

Open Eclipse and import the project to get started with it. Archived project file can also be imported.Follow the given steps to run the application:

*   Go to project properties.
*   Click on Java Build Path.
*   Go to Libraries and external Jars (GroupDocs.Signature.Jar).

![](/signature/java/images/how-to-run-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /signature/net/how-to-run-examples/

This article describes how to run .NET digital signature API code examples.
{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Signature has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Signature examples, by building your own or using our back-end or front-end examples out-of-the-box.

Please choose one from the following list:

## Build project from scratch

* Open Visual Studio and go to **File** -> **New** -> **Project**.
* Select appropriate project type - Console App, ASP.NET Web Application etc.
* Install **GroupDocs.Signature for .NET** from Nuget or official GroupDocs website following this [guide]({{< ref "signature/net/getting-started/installation.md" >}}).
* Code your first application with **GroupDocs.Signature for .NET** like this

    ```csharp
    // The path to the documents directory.
    string filePath = @"C:\sample.docx"; // NOTE: Put here actual path for your document
    string fileName = Path.GetFileName(filePath);
    string outputFilePath = Path.Combine(@"C:\output", fileName);

    // Sign document with text signature.
    using (Signature signature = new Signature(filePath))
    {
        TextSignOptions textSignOptions = new TextSignOptions("John Smith");
        signature.Sign(outputFilePath, textSignOptions);
    }
    ```

* Build and Run your project.
* Signed document will appear inside "*C:\\output\\"* directory.

## Run back-end examples

The complete examples package of **GroupDocs.Signature** is hosted on [GitHub](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET). You can either download the ZIP file from [here](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET/archive/master.zip) or clone the repository of GitHub using your favourite git client.  
In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![HowToRun](/signature/net/images/how-to-run-examples.png)

In extracted files and folders, you can find CSharp solution file. The project is created in **Microsoft Visual Studio 2019**. The **Resources** folder contains all the sample document and image files used in the examples.  
To run the examples, open the solution file in Visual Studio and build the project. To add missing references of **GroupDocs.Signature** see [Development Environment, Installation and Configuration]({{< ref "signature/net/getting-started/installation.md" >}}). All the functions are called from **RunExamples.cs**.
Un-comment the function you want to run and comment the rest.

![HowToRun](/signature/net/images/how-to-run-examples_1.png)

## Run MVC examples

You can run [GroupDocs.Signature for .NET MVC Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC) following these steps:

* Download [source code](https://github.com/groupdocs-signature/GroupDocs.https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC-for-.NET-MVC/archive/master.zip) from GitHub or clone this repository

    ```csharp
    git clone https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC
    ```

* Open solution in the VisualStudio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
* Open [http://localhost:8080/signature](http://localhost:8080/signature) in your favorite browser

For more details about project configuration please refer to this [guide](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC#configuration).

## Run WebForms examples

You can run [GroupDocs.Signature for .NET Web.Forms Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms) following these steps:

* Download [source code](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms/archive/master.zip) from GitHub or clone this repository

    ```csharp
    git clone https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms
    ```

* Open solution in the VisualStudio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
* Open [http://localhost:8080/signature](http://localhost:8080/signature) in your favorite browser

For more details about project configuration please refer to this [guide](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms#configuration).

## Run from Docker

Use [Docker](https://www.docker.com/) image to try GroupDocs.Signature for .NET features in an easy way. Here are the command to run GroupDocs.Signature for .NET from docker image.

```csharp
mkdir DocumentSamples
mkdir Licenses
docker run -p 8080:8080 --env application.hostAddress=localhost -v `pwd`/DocumentSamples:/home/groupdocs/app/DocumentSamples -v `pwd`/Licenses:/home/groupdocs/app/Licenses groupdocs/signature
## Open http://localhost:8080/signature in your favorite browser.
```

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /viewer/nodejs-java/how-to-run-examples/


The complete project [GroupDocs.Viewer for Node.js via Java — Code Examples](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java) with runnable examples and sample files is hosted on GitHub. The structure and commands below are based on this repository and its README.

## Prerequisites

Before running examples, make sure your environment meets the [System Requirements]({{< ref "viewer/nodejs-java/getting-started/system-requirements" >}}) and [Installation]({{< ref "viewer/nodejs-java/getting-started/installation" >}}) guides:

- **Node.js**: 20 LTS or later
- **Java**: JRE/JDK 8+ (17 LTS recommended)
- **Java environment**: `JAVA_HOME` set and added to `PATH`

Windows PowerShell:

```powershell
$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"
```

Linux/macOS:

```bash
export JAVA_HOME=/usr/lib/jvm/java-17
export PATH=$JAVA_HOME/bin:$PATH
```

For more details, see the examples repository README:  
[GroupDocs.Viewer for Node.js via Java — Code Examples README](https://raw.githubusercontent.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java/refs/heads/master/README.md).

## Run examples using npm

To get started, make sure that [Node.js](https://nodejs.org/) and Java are installed and configured as described above.

1. **Clone the repository with examples**

   ```bash
   git clone git@github.com:groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java.git
   ```

2. **Navigate to the `Examples` folder**

   ```bash
   cd ./GroupDocs.Viewer-for-Node.js-via-Java/Examples
   ```

3. **Install dependencies**

   ```bash
   npm install
   ```

   This installs the bundled `groupdocs.viewer-<version>.tgz` package and other dependencies defined in `package.json`. We typically keep the package up to date with the latest version. If you need to use a different package version, you can update the `package.json` file accordingly.

   Alternatively, you can download the `tgz` file from the official [GroupDocs Releases](https://releases.groupdocs.com/viewer/nodejs-java/#direct-download) website. To install the package manually, copy the tgz file to the `Examples` directory and run the following command:
   
   ```bash
   npm install ./groupdocs.viewer-*.tgz
   ```

   If installation fails with native build errors, review the build tools section in [System Requirements]({{< ref "viewer/nodejs-java/getting-started/system-requirements" >}}).

4. **Configure license (optional)**

   If you have a license file, you can set the license path in the `run_all_examples.js` file. By default, GroupDocs.Viewer for Node.js via Java checks for the `GROUPDOCS_LICENSE_PATH` environment variable or looks for files with the `.lic` extension in the project's root directory. You can also [get a temporary license](https://purchase.groupdocs.com/temporary-license) to test all the features.

5. **Run all examples**

   ```bash
   npm start
   ```

   You can also run individual examples by navigating to the folder containing the example script and running it. Output files are placed in the same folder as the script file.

## More Resources

Find additional details and examples in the [GroupDocs.Viewer for Node.js via Java documentation](https://docs.groupdocs.com/viewer/nodejs-java/).

We also offer **GroupDocs.Viewer** packages for other platforms:
* [**GroupDocs.Viewer for .NET**](https://products.groupdocs.com/viewer/net/)
* [**GroupDocs.Viewer for Java**](https://products.groupdocs.com/viewer/java/)
* [**GroupDocs.Viewer for Python via .NET**](https://products.groupdocs.com/viewer/python-net/)
---

## How to Run Examples

Path: /watermark/nodejs-java/how-to-run-examples/

The complete project [GroupDocs.Watermark Examples](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Node.js-via-Java) with code examples and sample files is hosted on GitHub.

## Run examples using NPM

To get started make sure that [Node.js](https://nodejs.org/) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Node.js-via-Java.git`
2. Navigate to the project folder `cd ./GroupDocs.Watermark-for-Node.js-via-Java`
3. Install the necessary packages with the `npm install` command.
4. Run the examples with the `node runExamples.js` command.

To check what examples are available, open the `runExamples.js` file in your favorite text editor. Uncomment examples you want to run and type `node runExamples.js` to start them.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open-source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include them in the repository if found helpful.

---

## How to Run the Examples

Path: /annotation/java/how-to-run-the-examples/


## Download from GitHub

The package of GroupDocs.Annotation examples is hosted on [GitHub](https://github.com/groupdocs-annotation/GroupDocs.Annotation-for-Java). You can either download the ZIP file or clone the repository of GitHub using your favorite GitHub client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/annotation/java/images/how-to-run-the-examples.png)

Open Eclipse and import the project to get started with it. Archived project file can also be imported.Follow the given steps to run the application:

1.   Go to project properties.
2.   Click on Java Build Path.
3.   Go to Libraries and external Jars (GroupDocs.Annotation.Jar).

![](/annotation/java/images/how-to-run-the-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## In-Paragraph List in Email Document

Path: /assembly/java/in-paragraph-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Paragraph List report in Email Document format.{{< /alert >}}

## In-Paragraph List in Email Document

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   A descriptive or informative line like "We provide support for the following clients:".
*   Show all the clients along with the above sentence.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients: <<foreach [in getClients()]>><<[indexOf() != 0 ? ", " : ""]>><<[getName()]>><</foreach>>
```

### Download In-Paragraph List Template

Please download the sample Common List document we created in this article:

*   [In-Paragraph List.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs 3ff4323ee0af247c4d071c002294dff6 >}}

---

## In-Paragraph List in Email Document

Path: /assembly/net/in-paragraph-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a In-Paragraph List report in Email Document format.{{< /alert >}}

## In-Paragraph List in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to share the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   A descriptive or informative line like "We provide support for the following products:".
*   Show all the products along with the above sentence.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[IndexOf() != 0 ? ", " : ""]>>
<<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download In-Paragraph List Template

Please download the sample Common List document we created in this article:

*   [In-Paragraph List.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/In-Paragraph%20List.msg?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< gist rida-fatima-aspose b447f473d018009724f467a305acbc52 >}}

---

## Inserting Chart Axis Title Dynamically

Path: /assembly/java/inserting-chart-axis-title-dynamically/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.12 or greater{{< /alert >}}

## Column Chart in Microsoft Word Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
2.  Select "Column" in the sidebar, you will see a gallery of charts
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/java/inserting-chart-axis-title-dynamically/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine)
5.  Save your Document

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must show total Contract Prices by Quarters
*   Report must be generated in the Word Processing Document

### Adding Syntax to be Evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
<<title>><<foreach[in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x[key.getName()]>>
```

#### Chart Data (Excel)

|   | 1st Quarter<<y[where(c => c.getDate().getMonth()>= 0 && c.getDate().getMonth() <= 2).sum(c => c.getPrice())]>>  | 2nd Quarter<<y[where(c => c.getDate().getMonth()>= 3 && c.getDate().getMonth() <= 5).sum(c => c.getPrice())]>> | 3rd Quarter<<y[where(c => c.getDate().getMonth()>= 6 && c.getDate().getMonth()<= 8).sum(c => c.getPrice())]>> | 4th Quarter<<y[where(c => c.getDate().getMonth()>= 9 && c.getDate().getMonth()<= 11).sum(c => c.getPrice())]>> |
| --- | --- | --- | --- | --- |
| Category 1 | 4.3 | 2.4 | 2 | 3 |
| Category 2 | 2.5 | 4.4 | 2 | 2 |
| Category 3 | 3.5 | 1.8 | 3 | 5 |
| Category 4 | 4.5 | 2.8 | 5 | 2 |

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_dynamic_title.docx)

### Generating The Report

{{< gist GroupDocsGists a7289c11e8649e727dba5415fbe757ea >}}



---

## Inserting Chart Axis Title Dynamically in Word Document

Path: /assembly/net/inserting-chart-axis-title-dynamically-in-word-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.12 or greater.{{< /alert >}}

## Column Chart in Microsoft Word Document

### Creating a Column Chart

Practising the following steps, you can insert a Column Chart in MS Word 2013:

1.  Click in the document where you want to insert the chart, click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialog box
2.  Select "Column" in the sidebar, you will see a gallery of charts
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
4.  Edit the Worksheet with your data to update the chart. See [Chart Data (Excel)](https://docs.groupdocs.com/assembly/net/inserting-chart-axis-title-dynamically-in-word-document/#adding-syntax-to-be-evaluated-by-groupdocsassembly-engine)
5.  Save your Document

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must show the quantity of sales/orders
*   Sales/orders quantity must be represented by Quarters
*   It must associate order quantity with the corresponding customer
*   A report must be generated in the Word Processing Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<<title>><<foreach [in orders
.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>><<x [Key.CustomerName]>>
```

#### Chart Data (Excel)

|   | 1st Quarter<<y[Where(c => c.OrderDate.Month>= 1 && c.OrderDate.Month <= 3).Sum(c => c.ProductQuantity)]>> | 2nd Quarter<<y[Where(c => c.OrderDate.Month>= 4 && c.OrderDate.Month <= 6).Sum(c => c.ProductQuantity)]>> | 3rd Quarter<<y[Where(c => c.OrderDate.Month>= 7 && c.OrderDate.Month <= 9).Sum(c => c.ProductQuantity)]>> | 4th Quarter<<y[Where(c => c.OrderDate.Month>= 10 && c.OrderDate.Month <= 12).Sum(c => c.ProductQuantity)]>> |
| --- | --- | --- | --- | --- |
| Category 1 | 4.3 | 2.4 | 2 | 3 |
| Category 2 | 2.5 | 4.4 | 2 | 2 |
| Category 3 | 3.5 | 1.8 | 3 | 5 |
| Category 4 | 4.5 | 2.8 | 5 | 2 |

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering document we created in this article:

*   [Chart Template.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_dynamic_title.docx) (Template for CustomObject and JSON examples) 

### Generating The Report

#### Custom Objects

{{< gist GroupDocsGists df2cabaaed2bd0016d8e86ed74647366 >}}



---

## Installation

Path: /merger/java/installation/


## Operating Systems

**[GroupDocs.Merger for Java](https://products.groupdocs.com/merger/java)** can be executed on any Operating System with Java JDK installed.

- Windows Desktops and Servers
- Linux
- Mac OS

## Supported Runtime

**[GroupDocs.Merger for Java](https://products.groupdocs.com/merger/java)** supports Java run-time version 8 and above (Kotlin is supported as well).

## Development Environments

- NetBeans
- IntelliJ IDEA
- Eclipse

## Installation from GroupDocs Repository

All Java packages are hosted at [GroupDocs Artifact Repository](https://releases.groupdocs.com/java/repo/). You can easily reference [GroupDocs.Merger for Java API](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-merger/) directly in your project using following steps.

### Add GroupDocs Artifact Repository

First, you need to specify repository configuration/location in your project as follows:

{{< tabs "example1">}}
{{< tab "Maven" >}}
```xml
<repositories>
	<repository>
		<id>GroupDocs Artifact Repository</id>
        	<name>GroupDocs Artifact Repository</name>
        	<url>https://releases.groupdocs.com/java/repo/</url>
	</repository>
</repositories>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
repositories {
    maven {
        url "https://repository.groupdocs.com/repo/"
    }
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
repositories {
    maven(url = "https://repository.groupdocs.com/repo/")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
```
{{< /tab >}}
{{< /tabs >}}

### Add GroupDocs.Merger as a dependency

Then define GroupDocs.Merger for Java API dependency in your project as follows:

{{< tabs "example2">}}
{{< tab "Maven" >}}
```xml
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-merger</artifactId>
        <version>24.6</version>
    </dependency>
</dependencies>
```
{{< /tab >}}
{{< tab "Gradle" >}}
```xml
dependencies {
    implementation 'com.groupdocs:groupdocs-merger:24.6'
}
```
{{< /tab >}}
{{< tab "Kotlin" >}}
```xml
dependencies {
    implementation("com.groupdocs:groupdocs-merger:24.6")
}
```
{{< /tab >}}
{{< tab "Ivy" >}}
```xml
<dependency org="com.groupdocs" name="groupdocs-merger" rev="24.6">
   <artifact name="groupdocs-merger" ext="jar"/>
</dependency>
```
{{< /tab >}}
{{< tab "Sbt" >}}
```xml
libraryDependencies += "com.groupdocs" % "groupdocs-merger" % "24.6"
```
{{< /tab >}}
{{< /tabs >}}

_The latest version of Merger API can be [found here](https://releases.groupdocs.com/java/repo/com/groupdocs/groupdocs-merger/)_
---

## Licensing

Path: /comparison/net/licensing-and-evaluation-limitations/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Comparison provides different purchase plans or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are several general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Comparison without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Only first 2 pages can be processed.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Annotation without the limitations of the trial version, you can also request a 30-day Temporary License. For details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

{{< alert style="info" >}}

You can find the pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/comparison/net) page.

{{< /alert >}}

After getting the license, you need to set it. This section describes different ways to set the license.

The license should be set:

- Only once per application domain.
- Before using any other of GroupDocs.Annotation classes.

{{< alert style="info" >}}

The license can be set multiple times per app domain but we recommend doing it once since all calls to `SetLicense` except first will just waste processor time.

{{< /alert >}}

### Set License from File

The following code snippet shows how to set a license from file:

{{< tabs "example1">}}
{{< tab "C#" >}}

```csharp
using GroupDocs.Comparison;
// ...

string licensePath = "path to the .lic file";
License license = new License();
license.SetLicense(licensePath);
```

{{< /tab >}}
{{< /tabs >}}


### Set License from Stream

The following code snippet shows how to set a license from a stream:

{{< tabs "example2">}}
{{< tab "C#" >}}

```csharp
using GroupDocs.Comparison;
using System.IO;
// ...

string licensePath = "path to the .lic file";
using (FileStream fileStream = File.OpenRead(licensePath))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```

{{< /tab >}}
{{< /tabs >}}


### Set Metered License

You can also set the [Metered](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/metered/) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For  details, please refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

The following code snippet shows how to use `Metered` licensing:

{{< tabs "example3">}}
{{< tab "C#" >}}

```csharp
using System;
using GroupDocs.Comparison;
// ...

string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Comparison.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Comparison.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

{{< /tab >}}
{{< /tabs >}}
---

## Licensing

Path: /conversion/net/licensing-and-subscription/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Conversion offers a Free Trial and a 30-day Temporary License for evaluation and provides different purchase plans.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Conversion without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that are described in the next sections of this article.

The evaluation version comes with the limitations:

* Only the first 3 pages are processed.
* Documents with more than 3 pages are not supported.
* Trial badges are placed in the document on the top of each page.
  
### Temporary License

If you wish to test GroupDocs.Conversion without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set up a license

{{< alert style="info" >}}

You can find pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/conversion/net) page.

{{< /alert >}}

After the license is obtained you need to set up the license. This section describes options of how this can be done and also comments on some common questions.

The license should be set:

- Only once per application domain,
- and before using any other GroupDocs.Conversion classes.

{{< alert style="info" >}}

The license can be set multiple times per app domain but we recommend doing it once since all calls to the `SetLicense` method except for the first one will just waste processor time.

{{< /alert >}}


### Set License from File

The following code sets a license from a file.

```csharp
string licensePath = "path to the .lic file";
License license = new License();
license.SetLicense(licensePath);
```

### Set License from Stream

The following example shows how to set a license from a stream.

```csharp
string licensePath = "path to the .lic file";
using (FileStream fileStream = File.OpenRead(licensePath))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```
<!--
{{< alert style="info" >}}Calling [License](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/license).[SetLicense](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/license/setlicense/) multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.conversion classes.  
When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application\_Start protected method. It is called once when the application starts.  
Do not call [License](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/license).[SetLicense](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/license/setlicense/) from within Page\_Load methods since it means the license will be loaded every time a web page is loaded.
{{< /alert >}}
-->

### Set Metered License

You can also set [Metered](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/metered) license as an alternative to the license file. It is a new licensing mechanism that will be used along with the existing licensing method. It is useful for customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

Following is the sample code demonstrating how to use `Metered` licensing.
<!--
Here are the simple steps to use the `Metered` class.

1. Create an instance of [Metered](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/metered) class.
2. Pass public & private keys to [SetMeteredKey](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/metered/setmeteredkey/) method.
3. Do processing (perform task).
4. call method [GetConsumptionQuantity](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/metered/getconsumptionquantity) of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. call method [GetConsumptionCredit](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/metered/getconsumptioncredit) of the [Metered](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/metered) class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use [Metered](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/metered) class.
-->

```csharp
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Conversion.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Conversion.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

---

## Licensing

Path: /markdown/net/licensing-and-subscription/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Markdown offers a Free Trial and a 30-day Temporary License for evaluation and provides different purchase plans.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Markdown without buying a license.

### Free Trial

The evaluation version is the same as the purchased one -- the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that are described in the next sections of this article.

The evaluation version comes with the following limitations:

* Only the first 3 pages are processed.
* Documents with more than 3 pages are not supported.
* An evaluation watermark is placed at the top of each page.

### Temporary License

If you wish to test GroupDocs.Markdown without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to Set a License

{{< alert style="info" >}}
You can find pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/markdown/net) page.
{{< /alert >}}

After obtaining a license, you need to set it up. This section describes options for how this can be done and also comments on some common questions.

The license should be set:

- Only once per application domain.
- Before using any other GroupDocs.Markdown classes.

{{< alert style="info" >}}
The license can be set multiple times per app domain but we recommend doing it once since all calls after the first one will just waste processor time.
{{< /alert >}}

### Set License from File (Static Method)

The `License.Set()` static method is the simplest way to apply a license. You do not need to create a `License` instance.

{{< tabs "license-static-file" >}}
{{< tab "C#" >}}
```csharp
// Set the license using the static method
if (File.Exists("GroupDocs.Markdown.lic")) License.Set("GroupDocs.Markdown.lic");
```
{{< /tab >}}
{{< /tabs >}}

### Set License from File (Instance Method)

Alternatively, you can create a `License` instance and call `SetLicense()`:

{{< tabs "license-instance-file" >}}
{{< tab "C#" >}}
```csharp
string licensePath = "GroupDocs.Markdown.lic";
License license = new License();
license.SetLicense(licensePath);
```
{{< /tab >}}
{{< /tabs >}}

### Set License from Stream (Static Method)

You can also apply a license from a stream using the static `License.Set()` method:

{{< tabs "license-static-stream" >}}
{{< tab "C#" >}}
```csharp
using (FileStream stream = File.OpenRead("GroupDocs.Markdown.lic"))
{
    License.Set(stream);
}
```
{{< /tab >}}
{{< /tabs >}}

### Set License from Stream (Instance Method)

The following example shows how to set a license from a stream using the instance method:

{{< tabs "license-instance-stream" >}}
{{< tab "C#" >}}
```csharp
using (FileStream stream = File.OpenRead("GroupDocs.Markdown.lic"))
{
    License license = new License();
    license.SetLicense(stream);
}
```
{{< /tab >}}
{{< /tabs >}}

### Set Metered License

You can also set a [Metered](https://reference.groupdocs.com/markdown/net/groupdocs.markdown/metered) license as an alternative to a license file. It is a usage-based licensing mechanism that is billed based on the API features consumed. For more details, please refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

Use the `Metered` class to set up metered licensing and query your consumption:

{{< tabs "license-metered" >}}
{{< tab "C#" >}}
```csharp
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```
{{< /tab >}}
{{< /tabs >}}

---

## Licensing

Path: /markdown/python-net/licensing-and-subscription/


Sometimes, to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Markdown offers a Free Trial and a 30-day Temporary License for evaluation and provides different purchase plans.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Markdown without buying a license.

### Free Trial

The evaluation version is the same as the purchased one -- the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that are described in the next sections of this article.

The evaluation version comes with the following limitations:

* Only the first 3 pages are processed.
* Documents with more than 3 pages are not supported.
* An evaluation watermark is placed at the top of each page.

### Temporary License

If you wish to test GroupDocs.Markdown without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to Set a License

{{< alert style="info" >}}
You can find pricing information on the ["Pricing Information"](https://purchase.groupdocs.com/pricing/markdown/python-net) page.
{{< /alert >}}

After obtaining a license, you need to set it up. This section describes options for how this can be done and also comments on some common questions.

The license should be set:

- Only once per application domain.
- Before using any other GroupDocs.Markdown classes.

{{< alert style="info" >}}
The license can be set multiple times per app domain but we recommend doing it once since all calls after the first one will just waste processor time.
{{< /alert >}}

### Set License from File (Static Method)

The `License.set_()` static method is the simplest way to apply a license. You do not need to create a `License` instance.

{{< tabs "set-license-static">}}
{{< tab "set_license_static.py" >}}  
```python
import os
from groupdocs.markdown import License

def set_license_static():
    """Apply a license from a file using the static convenience method."""

    # Step 1: Set the license using the static method (call once per app)
    license_path = "GroupDocs.Markdown.lic"
    if os.path.exists(license_path):
        License.set_(license_path)

if __name__ == "__main__":
    set_license_static()
```
{{< /tab >}}
{{< /tabs >}}

### Set License from File (Instance Method)

Alternatively, you can create a `License` instance and call `set_license()`:

{{< tabs "set-license-instance">}}
{{< tab "set_license_instance.py" >}}  
```python
import os
from groupdocs.markdown import License

def set_license_instance():
    """Apply a license from a file using the instance method."""

    # Step 1: Define the path to the license file
    license_path = "GroupDocs.Markdown.lic"

    # Step 2: Create a License instance and apply the license
    if os.path.exists(license_path):
        license = License()
        license.set_license(license_path)

if __name__ == "__main__":
    set_license_instance()
```
{{< /tab >}}
{{< /tabs >}}

### Set License from Stream (Static Method)

You can also apply a license from a stream using the static `License.set_()` method:

{{< tabs "set-license-stream-static">}}
{{< tab "set_license_stream_static.py" >}}  
```python
import os
from groupdocs.markdown import License

def set_license_stream_static():
    """Apply a license from a stream using the static convenience method."""

    # Step 1: Open the license file as a binary stream
    license_path = "GroupDocs.Markdown.lic"
    if os.path.exists(license_path):
        with open(license_path, "rb") as stream:
            # Step 2: Apply the license from the stream
            License.set_(stream)

if __name__ == "__main__":
    set_license_stream_static()
```
{{< /tab >}}
{{< /tabs >}}

### Set License from Stream (Instance Method)

The following example shows how to set a license from a stream using the instance method:

{{< tabs "set-license-stream-instance">}}
{{< tab "set_license_stream_instance.py" >}}  
```python
import os
from groupdocs.markdown import License

def set_license_stream_instance():
    """Apply a license from a stream using the instance method."""

    # Step 1: Open the license file as a binary stream
    license_path = "GroupDocs.Markdown.lic"
    if os.path.exists(license_path):
        with open(license_path, "rb") as stream:
            # Step 2: Create a License instance and apply from the stream
            license = License()
            license.set_license(stream)

if __name__ == "__main__":
    set_license_stream_instance()
```
{{< /tab >}}
{{< /tabs >}}

### Set License from Environment Variable

You can auto-apply a license at import time by setting the `GROUPDOCS_LIC_PATH` environment variable. The license is applied automatically when the package is imported — no code changes needed:

```bash
export GROUPDOCS_LIC_PATH="path/to/GroupDocs.Markdown.lic"
```

The variable also accepts a URL if you serve the license from a license server:

```bash
export GROUPDOCS_LIC_PATH="https://license-server.example.com/api/license"
```

### Set Metered License

You can also set a [Metered](https://reference.groupdocs.com/markdown/python-net/groupdocs.markdown/metered) license as an alternative to a license file. It is a usage-based licensing mechanism that is billed based on the API features consumed. For more details, please refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.

Use the `Metered` class to set up metered licensing and query your consumption:

{{< tabs "set-metered-license">}}
{{< tab "set_metered_license.py" >}}  
```python
from groupdocs.markdown import Metered

def set_metered_license():
    """Set up metered (usage-based) licensing and query consumption."""

    # Step 1: Provide your metered license keys
    public_key = ""   # your public license key
    private_key = ""  # your private license key

    # Step 2: Create a Metered instance and activate the keys (skip if keys not set)
    if public_key and private_key:
        metered = Metered()
        metered.set_metered_key(public_key, private_key)

        # Step 3: Query amount (MB) consumed
        amount_consumed = Metered.get_consumption_quantity()
        print("Amount (MB) consumed: " + str(amount_consumed))

        # Step 4: Query count of credits consumed
        credits_consumed = Metered.get_consumption_credit()
        print("Credits consumed: " + str(credits_consumed))

if __name__ == "__main__":
    set_metered_license()
```
{{< /tab >}}
{{< /tabs >}}

---

## Licensing

Path: /signature/python-net/licensing/


To help you quickly explore library and its features, GroupDocs.Signature provides a Free Trial and a 30-day Temporary License for evaluation, as well as various purchase plans.

Sometimes, to get familiar with the system quickly, you may want to dive into the code right away. To make this easier, GroupDocs.Signature offers a Free Trial and a 30-day Temporary License for evaluation, along with various purchase plans.

{{< alert style="info" >}}
Please note that general policies and practices guide you on evaluating, licensing, and purchasing our products. See the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies/) section for details.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Signature without purchasing a license.

### Free Trial

The evaluation version is identical to the full version — it simply becomes fully licensed when you apply a license. Instructions for setting a license are provided in the following sections.

The evaluation version has the following limitations:
* Only the first three pages are processed.
* Documents with more than three pages are not supported.
* A trial watermark is placed at the top of each page.

### Temporary License

If you'd like to test GroupDocs.Signature without the limitations of the trial version, you can request a 30-day Temporary License. For more information, see the [Get a Temporary License](https://purchase.groupdocs.com/temporary-license) page.

## How to Set Up a License

{{< alert style="info" >}}
For information on pricing, visit the [Pricing Information](https://purchase.groupdocs.com/pricing/) page.
{{< /alert >}}

Once you’ve obtained a license, follow these instructions to set it up. 

A license should be set:
- Only once per application, and
- Before using any other GroupDocs.Signature classes.

{{< alert style="tip" >}}
Though the license can be set multiple times per application, it is recommended to set it only once, as repeated calls to the `set_license` method will use unnecessary processing time.
{{< /alert >}}

### Set Environment Variable

You can set the `GROUPDOCS_LIC_PATH` environment variable to the absolute path of the license file. GroupDocs.Signature will then read this value and apply the license.

{{< tabs "set-license-env-var">}}
{{< tab "Windows (Command Prompt)" >}}
```ps
set GROUPDOCS_LIC_PATH "C:\path\to\your\license\file.lic"
```
{{< /tab >}}
{{< tab "Windows (Powershell)" >}}
```ps
$env:GROUPDOCS_LIC_PATH="C:\path\to\your\license\file.lic"
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
export GROUPDOCS_LIC_PATH="/path/to/your/license/file.lic"
```
{{< /tab >}}
{{< /tabs >}}

### Copy License into Project Root Folder

GroupDocs.Signature can also read a license from the project’s root directory. Consider a simple Python app structure:

```Directory
📂 my-app
 ├──app.py
 ├──source.docx
 ├──groupdocs_signature_net-25.4-py3-none-*.whl
 └──GroupDocs.Signature.PythonViaNET.lic
```

When you run the application from the `my-app` folder, GroupDocs.Signature will check for files with a `.lic` extension in this folder. It will read the `GroupDocs.Signature.PythonViaNET.lic` file to apply the license.

### Set License from a File

The following code demonstrates setting a license from a file:

```python
import os
from groupdocs.signature import License

def set_license_from_file():
    # Get absolution path to license file
    license_path = os.path.abspath("./GroupDocs.Signature.PythonViaNET.lic")

    # Instantiate License and set the license
    license = License()
    license.set_license(license_path)

if __name__ == "__main__":
    set_license_from_file()
```

### Set License from a Stream

This example shows how to set a license from a stream:

```python
import os
from groupdocs.signature import License

def set_license_from_stream():
    # Get absolution path to license file
    license_path = os.path.abspath("./GroupDocs.Signature.PythonViaNET.lic")

    # Create a readable steam
    with open(license_path, "rb") as license_stream:
        # Instantiate License and set the license
        # Instantiate License and set the license
        license = License()
        license.set_license(license_stream)

if __name__ == "__main__":
    set_license_from_stream()
```

### Set Metered License

A [Metered License](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/metered) is also available as an alternative to a traditional license file. It is a usage-based licensing model that may be more suitable for customers who prefer to be billed based on actual API feature usage. For more information, refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered).

The following sample demonstrates how to use metered licensing:

```python
from groupdocs.signature import Metered

def set_metered_license():
    # Set your public and private keys
    public_key = "******" 
    private_key = "******" 

    # Instantiate Metered and set keys
    metered = Metered()
    metered.set_metered_key(public_key, private_key)

    # Get a number of MBs processed 
    mb_processed = metered.get_consumption_quantity()
    print("MB processed: ", mb_processed)

    # Get a number of credits used
    credits_used = metered.get_consumption_credit()
    print("Credits used: ", credits_used)

if __name__ == "__main__":
    set_metered_license()
```

---

## Licensing and Evaluation

Path: /total/python-net/licensing-and-evaluation/


This guide explains the different licensing options available for GroupDocs.Total for Python via .NET and how to properly set up licensing in your applications.

## Overview

GroupDocs offers multiple licensing options to suit your needs:
- Free Trial (for evaluation)
- 30-day Temporary License
- Purchased License
- Metered License (pay-as-you-go)

{{< alert style="info" >}}
For detailed information about our licensing policies and frequently asked questions, please visit the [Purchase Policies and FAQ](https://purchase.groupdocs.com/policies/) section.
{{< /alert >}}

## Evaluation Options

### Free Trial

The evaluation version is identical to the purchased version and becomes fully licensed once a valid license is applied. However, it includes the following limitations:
- Evaluation watermark on output documents
- Page processing limits (vary by product)
- Other product-specific limitations

### Temporary License

For testing without trial limitations, you can request a 30-day Temporary License:
1. Visit the [Get a Temporary License](https://purchase.groupdocs.com/temporary-license/) page
2. Follow the on-screen instructions to request your temporary license
3. Apply the license using one of the methods described below

## License Application

### Important Notes

- Set the license only once per application
- Set the license before using any GroupDocs.Total code
- Multiple calls to `set_license` are safe but unnecessary
- Avoid multiple calls to `set_metered_key`, as this may interfere with accurate consumption tracking.

### License Application Methods

You can apply the license using a file path or a stream.

{{< alert style="info" >}}
The following code examples show how to set license for GroupDocs.Conversion API but the process it the same for all of the APIs included into GroupDocs.Total.
{{< /alert >}}

#### 1. From a File

The following code demonstrates setting a license from a file:

```python
import os
from groupdocs.conversion import License

def set_license_from_file():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Total.lic")

    # Instantiate License and set the license
    license = License()
    license.set_license(license_path)

if __name__ == "__main__":
    set_license_from_file()
```

#### 2. From a Stream 

This example shows how to set a license from a stream:

```python
import os
from groupdocs.conversion import License

def set_license_from_stream():
    # Get absolute path to license file
    license_path = os.path.abspath("./GroupDocs.Total.lic")

    # Create a readable steam
    with open(license_path, "rb") as license_stream:
        # Instantiate and set the license
        license = License()
        license.set_license(license_stream)

if __name__ == "__main__":
    set_license_from_stream()
```

#### 3. Metered License

A [Metered License](https://reference.groupdocs.com/conversion/python-net/groupdocs.conversion/metered/) is also available as an alternative to a traditional license file. It is a usage-based licensing model that may be more suitable for customers who prefer to be billed based on actual API feature usage. For more information, refer to the [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered/).

The following sample demonstrates how to use metered licensing:

```python
from groupdocs.conversion import Metered

def set_metered_license():
    # Set your public and private keys
    public_key = "******" 
    private_key = "******" 

    # Instantiate Metered and set keys
    metered = Metered()
    metered.set_metered_key(public_key, private_key)

    # Get the number of MBs processed
    mb_processed = metered.get_consumption_quantity()
    print("MB processed: ", mb_processed)

    # Get the number of credits used
    credits_used = metered.get_consumption_credit()
    print("Credits used: ", credits_used)

if __name__ == "__main__":
    set_metered_license()
```

## Troubleshooting

### License File Naming
- You can rename the license file as needed
- Ensure the filename in your code matches the actual file name

### Common Issues

#### Can't find a license file

If you're setting a license file using a relative path and encountering issues, try using the absolute file path instead.
---

## Load document from Azure Blob Storage

Path: /annotation/net/load-document-from-azure-blob-storage/


The following code snippet shows how to load a document from Azure Blob Storage.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
string blobName = "sample.pdf";
using (Annotator annotator = new Annotator(DownloadFile(blobName)))
{
	AreaAnnotation area = new AreaAnnotation()
	{
		Box = new Rectangle(100, 100, 100, 100),
		BackgroundColor = 65535,
	};
	annotator.Add(area);
	annotator.Save("result.pdf");
}

public static Stream DownloadFile(string blobName)
{
	CloudBlobContainer container = GetContainer();
	CloudBlob blob = container.GetBlobReference(blobName);
	MemoryStream memoryStream = new MemoryStream();
	blob.DownloadToStream(memoryStream);
	memoryStream.Position = 0;
	return memoryStream;
}

private static CloudBlobContainer GetContainer()
{
	string accountName = "***";
	string accountKey = "***";
	string endpoint = $"https://{accountName}.blob.core.windows.net/";
	string containerName = "***";
	StorageCredentials storageCredentials = new StorageCredentials(accountName, accountKey);
	CloudStorageAccount cloudStorageAccount = new CloudStorageAccount(
		storageCredentials, new Uri(endpoint), null, null, null);
	CloudBlobClient cloudBlobClient = cloudStorageAccount.CreateCloudBlobClient();
	CloudBlobContainer container = cloudBlobClient.GetContainerReference(containerName);
	container.CreateIfNotExists();
	return container;
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}NOTE: Package WindowsAzure.Storage version 9.3.3 should be referenced{{< /alert >}}
---

## Load document from Azure Blob Storage

Path: /conversion/java/load-document-from-azure-blob-storage/

The following code snippet shows how to convert a document from Azure Blob Storage:

```java
  package com.groupdocs.conversion.examples.advanced_usage.loading.loading_documents_from_different_sources;

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.examples.Constants;

import com.groupdocs.conversion.exceptions.GroupDocsConversionException;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.microsoft.azure.storage.CloudStorageAccount;
import com.microsoft.azure.storage.blob.CloudBlob;
import com.microsoft.azure.storage.blob.CloudBlobClient;
import com.microsoft.azure.storage.blob.CloudBlobContainer;

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.File;


/**
* This example demonstrates how to download document from Azure Blob storage and convert document.
*/
public class LoadDocumentFromAzureBlobStorage {
    public static void run()
    {
        String blobName = "sample.docx";
        String convertedFile = "C:\\output\\converted.pdf"; 
        
        try {
        Converter converter = new Converter(new ByteArrayInputStream(DownloadFile(blobName).toByteArray()));
        PdfConvertOptions options = new PdfConvertOptions();
        converter.convert(convertedFile, options);
        }
        catch(Exception e){
            throw new GroupDocsConversionException(e.getMessage());
        }

        System.out.print("\nSource document converted successfully.\nCheck output in "+ convertedFile);
    }
    
    public static final String STORAGE_CONNECTION_STRING
            = "DefaultEndpointsProtocol=https;"
            + "AccountName=Ram;" //Your account name.
            + "AccountKey=key"; //your account key.

    public static ByteArrayOutputStream DownloadFile(String blobName) throws Exception
    {
        CloudBlobContainer container = GetContainer();

        CloudBlob blob = container.getBlockBlobReference(blobName);
        ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();
        blob.download(memoryStream);
        //memoryStream.Position = 0;
        return memoryStream;
    }

    private static CloudBlobContainer GetContainer() throws Exception
    {
        String containerName = "***";

        CloudStorageAccount cloudStorageAccount = CloudStorageAccount.parse(STORAGE_CONNECTION_STRING);
        CloudBlobClient cloudBlobClient = cloudStorageAccount.createCloudBlobClient();
        CloudBlobContainer container = cloudBlobClient.getContainerReference(containerName);
        container.createIfNotExists();

        return container;
    }
}

```

---

## Load file from Azure blob storage

Path: /conversion/net/load-file-from-azure-blob-storage/

The following code snippet shows how to convert a file from Azure Blob Storage:

```csharp
public static void Run()
{
    string blobName = "sample.docx";
    string outputFile = Path.Combine(@"c:\output", "converted.pdf");
    using (Converter converter = new Converter(() => DownloadFile(blobName)))
    {
        PdfConvertOptions options = new PdfConvertOptions();
        converter.Convert(outputFile, options);
    }
}
        
public static Stream DownloadFile(string blobName)
{
    CloudBlobContainer container = GetContainer();
    CloudBlob blob = container.GetBlobReference(blobName);
    MemoryStream memoryStream = new MemoryStream();
    blob.DownloadToStream(memoryStream);
    memoryStream.Position = 0;
    return memoryStream;
}

private static CloudBlobContainer GetContainer()
{
    string accountName = "***";
    string accountKey = "***";
    string endpoint = $"https://{accountName}.blob.core.windows.net/";
    string containerName = "***";
    StorageCredentials storageCredentials = new StorageCredentials(accountName, accountKey);
    CloudStorageAccount cloudStorageAccount = new CloudStorageAccount(
        storageCredentials, new Uri(endpoint), null, null, null);
    CloudBlobClient cloudBlobClient = cloudStorageAccount.CreateCloudBlobClient();
    CloudBlobContainer container = cloudBlobClient.GetContainerReference(containerName);
    container.CreateIfNotExists();
    return container;
}
```

---

## Load from Azure Blob Storage

Path: /viewer/java/load-document-from-azure-blob-storage/


{{< alert style="info" >}}

Install the [Microsoft Azure Client Library For Blob Storage](https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.21.1) and the [Microsoft Azure Client Library For Identity](https://mvnrepository.com/artifact/com.azure/azure-identity/1.8.1) to use the Blob clients.

{{< /alert >}}

The following code snippet shows how to load a document from Azure Blob Storage:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.azure.identity.DefaultAzureCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.storage.blob.BlobClient;
import com.azure.storage.blob.BlobContainerClient;
import com.azure.storage.blob.BlobServiceClient;
import com.azure.storage.blob.BlobServiceClientBuilder;
import com.azure.storage.blob.specialized.BlobInputStream;
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder()
        .build();

BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
        .endpoint("https://{accountName}.blob.core.windows.java/")
        .credential(defaultCredential)
        .buildClient();

BlobContainerClient blobContainerClient = blobServiceClient.createBlobContainer("container-name");
BlobClient blobClient = blobContainerClient.getBlobClient("sample.docx");

try (final BlobInputStream blobInputStream = blobClient.openInputStream();
     Viewer viewer = new Viewer(blobInputStream)) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Load from Azure Blob Storage

Path: /viewer/net/load-document-from-azure-blob-storage/


The following code snippet shows how to load a document from Azure Blob Storage.

{{< alert style="info" >}}

Runnig this code requires installing [Azure.Storage.Blobs](https://nuget.org/packages/Azure.Storage.Blobs) NuGet package.

{{< /alert >}}

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer;
using Azure.Storage.Blobs;
// ...

string blobName = "sample.docx";
Stream stream = DownloadFile(blobName);
LoadOptions loadOptions = new LoadOptions(FileType.DOCX);

using (Viewer viewer = new Viewer(stream, loadOptions))
{
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}

static Stream DownloadFile(string blobName)
{
    BlobContainerClient containerClient = GetContainerClient();

    // Get a reference to a blob
    BlobClient blobClient = containerClient.GetBlobClient(blobName);
    MemoryStream memoryStream = new MemoryStream();
    blobClient.DownloadTo(memoryStream);
    memoryStream.Position = 0;
    return memoryStream;
}

static BlobContainerClient GetContainerClient()
{
    string accountName = "***";
    string accountKey = "***";
    string endpointSuffix = "core.windows.net";
    string containerName = "***";

    string connectionString = $"DefaultEndpointsProtocol=https;AccountName={accountName};AccountKey={accountKey};EndpointSuffix={endpointSuffix}";

    // Create a BlobContainerClient object which will be used to create a container client
    BlobContainerClient blobContainerClient = new BlobContainerClient(connectionString, containerName);

    return blobContainerClient;
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer
Imports Azure.Storage.Blobs
' ...

Module Program
    Sub Main(args As String())
        Dim blobName As String = "sample.docx"
        Dim stream As Stream = DownloadFile(blobName)
        Dim loadOptions As New LoadOptions(FileType.DOCX)

        Using viewer As New Viewer(stream, loadOptions)
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub

    Private Function DownloadFile(ByVal blobName As String) As Stream
        Dim containerClient As BlobContainerClient = GetContainerClient()

        ' Get a reference to a blob
        Dim blobClient As BlobClient = containerClient.GetBlobClient(blobName)
        Dim memoryStream As New MemoryStream()
        blobClient.DownloadTo(memoryStream)
        memoryStream.Position = 0
        Return memoryStream
    End Function

    Private Function GetContainerClient() As BlobContainerClient
        Dim accountName As String = "***"
        Dim accountKey As String = "***"
        Dim endpointSuffix As String = "core.windows.net"
        Dim containerName As String = "***"

        Dim connectionString As String =
                $"DefaultEndpointsProtocol=https;AccountName={accountName};AccountKey={accountKey};EndpointSuffix={ _
                endpointSuffix}"

        ' Create a BlobContainerClient object which will be used to create a container client
        Dim blobContainerClient As New BlobContainerClient(connectionString, containerName)

        Return blobContainerClient
    End Function
End Module

```
{{< /tab >}}
{{< /tabs >}}

---

## Load PDF document with options

Path: /conversion/net/load-pdf-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [PdfLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions) to give you control over how the source PDF document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/format)** | The document type is auto-detected during loading, however, you can specify explicitly the type of the source document. Available options are: *Pdf, Epub, Xps, Tex, Ps, Pcl* |
|**[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/defaultfont/)** | A default font for PDF document. The specified font will be used if a font is missing. An absolute path to the font file must be provided. |
|**[FlattenAllFields](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/flattenallfields)** | Specifies that all fields in the source document should be flattened during conversion. |
|**[FontSubstitutes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/fontsubstitutes)** | Substitute specific fonts from the source document. |
|**[HidePdfAnnotations](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/hidepdfannotations)** | Specifies that annotations in the source document should be hidden. |
|**[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/password)** | A password to unlock the protected document. |
|**[RemoveEmbeddedFiles](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/removeembeddedfiles)** | Whether to remove the embedded files from the source document during the conversion. |

### Flatten all fields

The following code snippet shows how to convert a PDF document and flatten all fields:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PdfLoadOptions
{
    FlattenAllFields = true
};
using (Converter converter = new Converter("sample.pdf", getLoadOptions))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions();
    converter.Convert("converted.docx", options);
}
```

### Hide annotations

The following code snippet shows how to convert a PDF document and hide annotations:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PdfLoadOptions
{
    HidePdfAnnotations = true
};
using (Converter converter = new Converter("sample.pdf", getLoadOptions))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions();
    converter.Convert("converted.docx", options);
}
```

### Remove embedded files

The following code snippet shows how to convert a PDF document and remove embedded files:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PdfLoadOptions
{
    RemoveEmbeddedFiles = true
};
using (Converter converter = new Converter("sample.pdf", getLoadOptions))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions();
    converter.Convert("converted.docx", options);
}
```

### Set Default Font

GroupDocs.Conversion for .NET allows you to set a default font name when a font is not available in the document. You can use the **[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/defaultfont)** property of the **[PdfLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions)** class to set the default font name. In case the **[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pdfloadoptions/defaultfont)** property is not set the Times New Roman font will be used. The following code snippet shows how to set a default font name when converting from PDF to word-processing document:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PdfLoadOptions
{
    DefaultFont = "Helvetica"
};
using (Converter converter = new Converter("sample.pdf", getLoadOptions))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions();
    converter.Convert("converted.docx", options);
}
```

### Specify font substitution

The following code snippet shows how to convert a PDF document and specify font substitution for missing fonts:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PdfLoadOptions
{
    FontSubstitutes = new List<FontSubstitute>
    {
        FontSubstitute.Create("Tahoma", "Arial"),
        FontSubstitute.Create("Times New Roman", "Arial"),
    }
};
using (Converter converter = new Converter("sample.pdf", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.docx", options);
}
```

---

## Load Presentation document with options

Path: /conversion/java/load-presentation-document-with-options/

The [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/) library allows developers to load presentation files such as PPT, PPTX, and other formats into their applications with precise control over the loading process through customizable [PresentationLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions). This functionality supports advanced scenarios, including specifying slide numbers, handling hidden slides, or managing password-protected presentations.

The process involves initializing the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/converter/) class with the presentation file's path or stream. By defining specific properties in the [PresentationLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions), users can, for instance, load only selected slides or ensure compatibility with particular format variations. Once loaded, the document is ready for seamless conversion into any supported output format while maintaining high fidelity and preserving the source layout.

This approach is ideal for workflows involving large-scale presentation processing, batch conversions, or integrating document handling in server-side Java applications. For this the following options could be set:
| Option | Description |
|--------|-------------|
| [**setFormat()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions#setFormat(com.groupdocs.conversion.filetypes.PresentationFileType)) | allows you to specify explicitly the type of the source presentation document. Available options are: *Ppt, Pps, Pptx, Ppsx, Odp, Otp, Potx, Pot, Potm, Pptm, Ppsm*. |
| [**setDefaultFont()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions#setDefaultFont(java.lang.String)) | sets a default font for rendering the presentation. The following font will be used if a presentation font is missing. |
| [**setFontSubstitutes()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions#setFontSubstitutes(java.util.List))  |sets substitute specific fonts from the source presentation document. |
| [**setPassword()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions#setPassword(java.lang.String)) | specifies a password to unlock the protected document. |
| [**setHideComments()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions#setHideComments(boolean)) | specifies that comments from source presentation must be hidden during conversion. |
| [**setShowHiddenSlides()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/PresentationLoadOptions#setShowHiddenSlides(boolean)) | specifies that hidden slides should be included in the converted document. |

### Hide comments

The following code snippet shows how to convert a presentation and hide comments:

{{< tabs "code-example">}}
{{< tab "ConvertPresentationByHidingComments.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.PresentationLoadOptions;

public class ConvertPresentationByHidingComments {
    public static void convert() {
        PresentationLoadOptions loadOptions = new PresentationLoadOptions();
        loadOptions.setHideComments(true);

        try(Converter converter = new Converter("sample.pptx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_without_comments.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.pptx" >}}  
{{< tab-text >}}
`sample.pptx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-presentation-document-with-options/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_without_comments.pdf" >}}  
{{< tab-text >}}
`converted_without_comments.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-presentation-document-with-options/converted_without_comments.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Specify font substitutions

The following code snippet shows how to convert a presentation and specify font substitutions for missing fonts:

{{< tabs "code-example1">}}
{{< tab "ConvertPresentationBySpecifyingFontSubstitution.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.FontSubstitute;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.PresentationLoadOptions;
import java.util.ArrayList;
import java.util.List;

public class ConvertPresentationBySpecifyingFontSubstitution {
    public static void convert() {
        PresentationLoadOptions loadOptions = new PresentationLoadOptions();

        List<FontSubstitute> fontSubstitutes = new ArrayList<FontSubstitute>();
        fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial"));
        fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial"));

        loadOptions.setFontSubstitutes(fontSubstitutes);

        try(Converter converter = new Converter("sample.pptx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_substitutes.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.pptx" >}}  
{{< tab-text >}}
`sample.pptx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-presentation-document-with-options/sample.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_substitutes.pdf" >}}  
{{< tab-text >}}
`converted_with_substitutes.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-presentation-document-with-options/converted_with_substitutes.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Include hidden slides

The following code snippet shows how to convert a presentation including the hidden slides:

{{< tabs "code-example2">}}
{{< tab "ConvertPresentationWithHiddenSlidesIncluded.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.PresentationLoadOptions;

public class ConvertPresentationWithHiddenSlidesIncluded {
    public static void convert() {
        PresentationLoadOptions loadOptions = new PresentationLoadOptions();
        loadOptions.setShowHiddenSlides(true);

        try(Converter converter = new Converter("with_hidden_page.pptx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_hidden_slides.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}

```
{{< /tab >}}
{{< tab "with_hidden_page.pptx" >}}  
{{< tab-text >}}
`with_hidden_page.pptx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-presentation-document-with-options/with_hidden_page.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_hidden_slides.pdf" >}}  
{{< tab-text >}}
`converted_with_hidden_slides.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-presentation-document-with-options/converted_with_hidden_slides.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Load Presentation document with options

Path: /conversion/nodejs-java/load-presentation-document-with-options/

GroupDocs.Conversion provides [PresentationLoadOptions](#) to give you control over how the source presentation document will be processed. The following options could be set:

*   **[setFormat](#)** allows you to specify explicitly the type of the source presentation document. Available options are: *Ppt, Pps, Pptx, Ppsx, Odp, Otp, Potx, Pot, Potm, Pptm, Ppsm*.
*   **[setDefaultFont](#)** sets a default font for rendering the presentation. The following font will be used if a presentation font is missing.      
*   **[setFontSubstitutes](#)** sets substitute specific fonts from the source presentation document.
*   **[setPassword](#)** specifies a password to unlock the protected document.
*   **[setHideComments](#)** specifies that comments from source presentation must be hidden during conversion.
*   **[setShowHiddenSlides](#)** specifies that hidden slides should be included in the converted document.

### Hide comments

The following code snippet shows how to convert a presentation and hide comments:

```js
const loadOptions = new groupdocs.conversion.PresentationLoadOptions()
loadOptions.setHideComments(true)

const outputPath = "ConvertPresentationByHidingComments.pdf"

const converter = new groupdocs.conversion.Converter("sample.pptx", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`Pdf document converted successfully to ${outputPath} (by hiding comments)`)
converter.convert(outputPath, convertOptions)
```

### Specify font substitutions

The following code snippet shows how to convert a presentation and specify font substitutions for missing fonts:

```js
const java = require('java') 

const outputPath = "ConvertPresentationBySpecifyingFontSubstitution.pdf";

const fontSubstitutes = java.newInstanceSync("java.util.ArrayList");
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Tahoma", "Arial"));
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Times New Roman", "Arial"));

const loadOptions = new groupdocs.conversion.PresentationLoadOptions()
loadOptions.setDefaultFont("Helvetica.ttf");
loadOptions.setFontSubstitutes(fontSubstitutes);

const converter = new groupdocs.conversion.Converter("sample.pptx", loadOptions);
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

console.log(`Pdf document converted successfully to ${outputPath} (by specifying font subs)`);
converter.convert(outputPath, convertOptions);
```

### Include hidden slides

The following code snippet shows how to convert a presentation including the hidden slides:

```js
const loadOptions = new groupdocs.conversion.PresentationLoadOptions()
loadOptions.setShowHiddenSlides(true)

const outputPath = "ConvertPresentationWithHiddenSlidesIncluded.pdf"

const converter = new groupdocs.conversion.Converter("sample.pptx", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`Pdf document converted successfully to ${outputPath} (with hidden slides included)`)
converter.convert(outputPath, convertOptions)
```

---

## Logging

Path: /conversion/net/logging/

To enable logging, use the `ConsoleLogger` class or implement a custom logger via the `ILogger` interface.

* The [ILogger](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.logging/ilogger/) interface declares the methods used to perform logging.
* The [ConsoleLogger](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.logging/consolelogger/) class implements the methods that output log messages to a standard console.

The log contains the following types of messages:

* Error - for unrecoverable exceptions
* Warning - for recoverable/expected exceptions
* Trace - for general information

## Logging to the console
To log to a standard console, use the [ConsoleLogger](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.logging/consolelogger/) class implementation:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Logging;
using GroupDocs.Conversion.Options.Convert;

string documentPath = @"sample.docx"; // NOTE: Put here actual path to your document
string outputPath = @"converted.pdf";

// Create console logger
ConsoleLogger logger = new ConsoleLogger();

// Create ConverterSettings and specify logger.
Func<ConverterSettings> settingsFactory = () => new ConverterSettings
{
    Logger = logger
};

using (Converter converter = new Converter(documentPath, settingsFactory))
{
    PdfConvertOptions convertOptions = new PdfConvertOptions();
    converter.Convert(outputPath, convertOptions);
}
```

Console output would be as follows:

```console
[TRACE] Determine loaded for source document sample.docx ...
[TRACE] ... loader selected.
[TRACE] Loading source document sample.docx ...
[TRACE] ... document loaded.
[TRACE] Main document will be converted.
[TRACE] Starting conversion of sample.docx...
[TRACE]  ... pipeline selected ...
[TRACE]  ... conversion completed.
```

## Implementing custom logger

To log to a file, a stream or any other custom location, implement the [ILogger](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.logging/ilogger/) interface:

* For trace messages, implement the `public void Trace(string message)` method.
* For warning messages, implement the `public void Warning(string message)` method.
* For error messages, implement the `public void Error(string message)` method.

The following code snippet shows how to implement a simple file logger:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Logging;
using GroupDocs.Conversion.Options.Convert;

string documentPath = @"sample.docx"; // NOTE: Put here actual path to your document
string outputPath = @"converted.pdf";

// Create logger and specify the output file
ILogger logger = new CustomFileLogger("log.txt");

// Create ConverterSettings and specify logger.
Func<ConverterSettings> settingsFactory = () => new ConverterSettings
{
    Logger = logger
};

using (Converter converter = new Converter(documentPath, settingsFactory))
{
    PdfConvertOptions convertOptions = new PdfConvertOptions();
    converter.Convert(outputPath, convertOptions);
}

public class CustomFileLogger : ILogger
{
    private readonly string _fileName;

    /// <summary>
    /// Create logger to file.
    /// </summary>
    /// <param name="fileName">Full file name with path</param>
    public CustomFileLogger(string fileName)
    {
        _fileName = fileName;
    }

    /// <summary>
    /// Writes trace message to file.
    /// Trace log messages provide generally useful information about application flow.
    /// </summary>
    /// <param name="message">The trace message.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    public void Trace(string message)
    {
        File.AppendAllText(_fileName, $"[TRACE] {message}{Environment.NewLine}");
    }

    /// <summary>
    /// Writes warning message to file.
    /// Warning log messages provide information about the unexpected and recoverable event in application flow.
    /// </summary>
    /// <param name="message">The warning message.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    public void Warning(string message)
    {
        File.AppendAllText(_fileName, $"[WARN] {message}{Environment.NewLine}");
    }

    /// <summary>
    /// Writes an error message to file.
    /// Error log messages provide information about unrecoverable events in application flow.
    /// </summary>
    /// <param name="message">The error message.</param>
    /// <param name="exception">The exception.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="exception"/> is null.</exception>
    public void Error(string message, Exception exception)
    {
        File.AppendAllText(_fileName, $"[ERROR] {message}, exception: {exception}{Environment.NewLine}");
    }
}
```

The content of the `log.txt` file would be as follows:

```console
[TRACE] Determine loaded for source document sample.docx ...
[TRACE] ... loader selected.
[TRACE] Loading source document sample.docx ...
[TRACE] ... document loaded.
[TRACE] Main document will be converted.
[TRACE] Starting conversion of sample.docx...
[TRACE]  ... pipeline selected ... 
[TRACE]  ... conversion completed.
```
---

## Logging

Path: /viewer/java/logging/

By default, logging is disabled when rendering documents. You can log to a file.

To log to a text file, use the [FileLogger](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.logging/FileLogger) class.

The log contains the following four types of messages:

* Error means unrecoverable exceptions
* Warning means recoverable/expected exceptions
* Debug means debug information
* Trace means general information


The following code snippet shows how to log to a file using the [FileLogger](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.logging/filelogger/) class:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.ViewerSettings;
import com.groupdocs.viewer.logging.FileLogger;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.ViewOptions;
// ...

// Create logger and specify the output file
FileLogger fileLogger = new FileLogger("output.log");

// Create ViewerSettings and specify FileLogger
ViewerSettings viewerSettings = new ViewerSettings(fileLogger);

try (Viewer viewer = new Viewer("sample.pdf", viewerSettings)) {
    ViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("result.html");

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image shows the output.log file:

![](/viewer/java/images/how-to-set-up-logging-1.png)
---

## Logging

Path: /viewer/net/logging/

By default, logging is disabled when rendering documents. You can log to the console or a file.

To log, use the [ILogger](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.logging/ilogger) interface. It defines the methods required to instantiate and release the output file stream. Also, use the following classes:

* The [ConsoleLogger](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.logging/consolelogger) class defines the methods required to log to the console.
* The [FileLogger](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.logging/filelogger) class defines the methods required to log to a file.

The log contains the following three types of messages:

* Error means unrecoverable exceptions
* Warning means recoverable/expected exceptions
* Trace means general information

## Logging to a file

The following code snippet shows how to log to a file using the [FileLogger](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.logging/filelogger) class:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Logging;
using GroupDocs.Viewer.Options;
// ...

// Create logger and specify the output file.
FileLogger fileLogger = new FileLogger("output.log");

// Create ViewerSettings and specify FileLogger.
ViewerSettings viewerSettings = new ViewerSettings(fileLogger);

// Render a document.
using (Viewer viewer = new Viewer("sample.docx",viewerSettings))
{
    ViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("result.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Logging
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Create logger and specify the output file.
        Dim fileLogger As FileLogger = New FileLogger("output.log")
    
        ' Create ViewerSettings and specify FileLogger.
        Dim viewerSettings As ViewerSettings = New ViewerSettings(fileLogger)
    
        ' Render a document.
        Using viewer As Viewer = New Viewer("sample.docx", viewerSettings)
            Dim viewOptions As ViewOptions = HtmlViewOptions.ForEmbeddedResources("result.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows the output.log file:

![](/viewer/net/images/how-to-set-up-logging-1.png)

## Logging to the console

The following code snippet shows how to log to the console using the [ConsoleLogger](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.logging/consolelogger) class:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Logging;
using GroupDocs.Viewer.Options;
// ...

// Create console logger.
ConsoleLogger consoleLogger = new ConsoleLogger();

// Create ViewerSettings and specify FileLogger.
ViewerSettings viewerSettings = new ViewerSettings(consoleLogger);

// Render a document.
using (Viewer viewer = new Viewer("sample.docx", viewerSettings))
{
    ViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Logging
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Create console logger.
        Dim consoleLogger As ConsoleLogger = New ConsoleLogger()
    
        ' Create ViewerSettings and specify FileLogger.
        Dim viewerSettings As ViewerSettings = New ViewerSettings(consoleLogger)
    
        ' Render a document.
        Using viewer As Viewer = New Viewer("sample.docx", viewerSettings)
            Dim viewOptions As ViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![](/viewer/net/images/how-to-set-up-logging-2.png)

## Implementing custom logger

To create a logger, implement the [ILogger](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.logging/ilogger) interface:

* For trace messages, implement the `public void Trace(string message)` method.
* For warning messages, implement the `public void Warning(string message)` method.
* For error messages, implement the `public void Error(string message)` method.

The following code snippet shows how to implement a simple file logger:

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using System;
using System.IO;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Logging;
using GroupDocs.Viewer.Options;
// ...

// Create logger and specify the output file.
CustomLogger customLogger = new CustomLogger("output.log");

// Create ViewerSettings and specify CustomLogger.
ViewerSettings viewerSettings = new ViewerSettings(customLogger);

// Render a document.
using (Viewer viewer = new Viewer("sample.docx",viewerSettings))
{
    ViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources("result.html");

    viewer.View(viewOptions);
}

/// <summary>
/// Writes log messages to a file.
/// </summary>
public class CustomLogger : ILogger
{
    private readonly string _fileName;

    private CustomLogger() { }

    /// <summary>
    /// Create logger to a file.
    /// </summary>
    /// <param name="fileName">Full file name with path</param>
    public CustomLogger(string fileName)
    {
        _fileName = fileName;
    }

    /// <summary>
    /// Writes trace message to the file.
    /// Trace log messages provide generally useful information about application flow.
    /// </summary>
    /// <param name="message">The trace message.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    public void Trace(string message)
    {
        if (message == null)
            throw new ArgumentNullException(nameof(message));

        using (StreamWriter wr = new StreamWriter(_fileName, true))
        {
            wr.WriteLine($"[TRACE] {message}");
        }
    }

    /// <summary>
    /// Writes warning message to the file;
    /// Warning log messages provide information about the unexpected and recoverable events in application flow.
    /// </summary>
    /// <param name="message">The warning message.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    public void Warning(string message)
    {
        if (message == null)
            throw new ArgumentNullException(nameof(message));

        using (StreamWriter wr = new StreamWriter(_fileName, true))
        {
            wr.WriteLine($"[WARN] {message}");
        }
    }

    /// <summary>
    /// Writes an error message to the file.
    /// Error log messages provide information about unrecoverable events in application flow.
    /// </summary>
    /// <param name="message">The error message.</param>
    /// <param name="exception">The exception.</param>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
    /// <exception cref="System.ArgumentNullException">Thrown when <paramref name="exception"/> is null.</exception>
    public void Error(string message, Exception exception)
    {
        if (message == null)
            throw new ArgumentNullException(nameof(message));
        if (exception == null)
            throw new ArgumentNullException(nameof(exception));

        using (StreamWriter wr = new StreamWriter(_fileName, true))
        {
            wr.WriteLine($"[ERROR] {message}, exception: {exception}");
        }
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports System.IO
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Logging
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Create logger and specify the output file.
        Dim customLogger As CustomLogger = New CustomLogger("output.log")

        ' Create ViewerSettings and specify CustomLogger.
        Dim viewerSettings As ViewerSettings = New ViewerSettings(customLogger)

        ' Render a document.
        Using viewer As Viewer = New Viewer("sample.docx", viewerSettings)
            Dim viewOptions As ViewOptions = HtmlViewOptions.ForEmbeddedResources("result.html")
            viewer.View(viewOptions)
        End Using
    End Sub

    ' <summary>
    ' Writes log messages to a file.
    ' </summary>
    Public Class CustomLogger
        Implements ILogger

        Private ReadOnly _fileName As String

        Private Sub New()
        End Sub

        ''' <summary>
        ''' Create logger to a file.
        ''' </summary>
        ''' <param name="fileName">Full file name with path</param>
        Public Sub New(fileName As String)
            _fileName = fileName
        End Sub

        ''' <summary>
        ''' Writes warning message to the file;
        ''' Warning log messages provide information about the unexpected and recoverable events in application flow.
        ''' </summary>
        ''' <param name="message">The warning message.</param>
        ''' <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
        Public Sub ILogger_Warning(message As String) Implements ILogger.Warning
            If message Is Nothing Then
                Throw New ArgumentNullException(NameOf(message))
            End If

            Using wr As New StreamWriter(_fileName, True)
                wr.WriteLine($"[WARN] {message}")
            End Using
        End Sub

        ''' <summary>
        ''' Writes trace message to the file.
        ''' Trace log messages provide generally useful information about application flow.
        ''' </summary>
        ''' <param name="message">The trace message.</param>
        ''' <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
        Public Sub ILogger_Trace(message As String) Implements ILogger.Trace
            If message Is Nothing Then
                Throw New ArgumentNullException(NameOf(message))
            End If

            Using wr As New StreamWriter(_fileName, True)
                wr.WriteLine($"[TRACE] {message}")
            End Using
        End Sub

        ''' <summary>
        ''' Writes an error message to the file.
        ''' Error log messages provide information about unrecoverable events in application flow.
        ''' </summary>
        ''' <param name="message">The error message.</param>
        ''' <param name="exception">The exception.</param>
        ''' <exception cref="System.ArgumentNullException">Thrown when <paramref name="message"/> is null.</exception>
        ''' <exception cref="System.ArgumentNullException">Thrown when <paramref name="exception"/> is null.</exception>
        Public Sub [Error](message As String, exception As Exception) Implements ILogger.[Error]
            If message Is Nothing Then
                Throw New ArgumentNullException(NameOf(message))
            End If
            If exception Is Nothing Then
                Throw New ArgumentNullException(NameOf(exception))
            End If

            Using wr As New StreamWriter(_fileName, True)
                wr.WriteLine($"[ERROR] {message}, exception: {exception}")
            End Using
        End Sub
    End Class
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows the output.log file:

![](/viewer/net/images/how-to-set-up-logging-3.png)
---

## Merging Table Cells Dynamically

Path: /assembly/java/merging-table-cells-dynamically/

{{< alert style="info" >}}This feature is supported by version 19.1 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

# Merging Table Cells Dynamically

Using GroupDocs.Assembly for Java, you can merge table cells with equal textual contents within your reports dynamically using **cellMerge** tags. Syntax of a **cellMerge** tag is defined as follows:

`<<cellMerge -horz>>`

{{< alert style="warning" >}}A horz switch is optional. If the switch is present, it denotes a cell merging operation in a horizontal direction. If the switch is missing, it means that a cell merging operation is to be performed in a vertical direction (the default).{{< /alert >}}

For two or more successive table cells to be merged dynamically in either direction by the engine, the following requirements must be met:

*   Each of the cells must contain a **cellMerge** tag denoting a cell merging operation in the same direction.
*   Each of the cells must not be already merged in another direction.
*   The cells must have equal textual contents (ignoring leading and trailing whitespaces).

Consider the following template:

<table style="background-color: white; background-image: initial; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td style="width: 89.625px; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 98.625px; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr><tr><td style="width: 89.625px; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-top-color: initial; border-top-style: none; border-top-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">&lt;&lt;cellMerge&gt;&gt;&lt;&lt;[</span><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);"><span style="font-family: Consolas;">Variable1</span></span></strong><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">]&gt;&gt;</span></strong></p></td><td style="width: 98.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr><tr><td style="width: 89.625px; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-top-color: initial; border-top-style: none; border-top-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">&lt;&lt;cellMerge&gt;&gt;&lt;&lt;[</span><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);"><span style="font-family: Consolas;">Variable2</span></span></strong><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">]&gt;&gt;</span></strong></p></td><td style="width: 98.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr><tr><td style="width: 89.625px; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-top-color: initial; border-top-style: none; border-top-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 98.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr></tbody></table>
{{< alert style="warning" >}}The cellMerge tag works only if Variable1 and Variable2 have the same values.{{< /alert >}}

### Merging Table Cells Dynamically in Word Processing Document 

#### The Code

{{< gist GroupDocsGists a599c02fb2d040474cac0f63a6196d72 >}}

#### Download

*   [Merging Cells Dynamically.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Merging%20Cells%20Dynamically.docx)

### Merging Table Cells Dynamically in Presentation Document 

#### The Code

{{< gist GroupDocsGists a77fa5b41c336a97dc35833c75504aa4 >}}



#### Download

*   [Merging Cells Dynamically.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Merging%20Cells%20Dynamically.pptx)

### Merging Table Cells Dynamically in Spreadsheet Document 

#### The Code

{{< gist GroupDocsGists cdca8717022763fe59c22e23b2fd0785 >}}



#### Download

*   [Merging Cells Dynamically.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Merging%20Cells%20Dynamically.xlsx)

### Merging Table Cells Dynamically in Email Document 

#### The Code

{{< gist GroupDocsGists 2e4861574c4af4fbf40fa41dec7d4b5a >}}



#### Download

*   [Merging Cells Dynamically.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Merging%20Cells%20Dynamically.msg)

---

## Merging Table Cells Dynamically

Path: /assembly/net/merging-table-cells-dynamically/

{{< alert style="info" >}}This feature is supported by version 19.1 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

Using GroupDocs.Assembly for .NET, you can merge table cells with equal textual contents within your reports dynamically using **cellMerge** tags. Syntax of a **cellMerge** tag is defined as follows:

```
<<cellMerge -horz>>
```

{{< alert style="warning" >}}A horz switch is optional. If the switch is present, it denotes a cell merging operation in a horizontal direction. If the switch is missing, it means that a cell merging operation is to be performed in a vertical direction (the default).{{< /alert >}}

For two or more successive table cells to be merged dynamically in either direction by the engine, the following requirements must be met:

*   Each of the cells must contain a **cellMerge** tag denoting a cell merging operation in the same direction.
*   Each of the cells must not be already merged in another direction.
*   The cells must have equal textual contents (ignoring leading and trailing whitespaces).

Consider the following template:

<table style="background-color: white; background-image: initial; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td style="width: 89.625px; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 98.625px; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr><tr><td style="width: 89.625px; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-top-color: initial; border-top-style: none; border-top-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">&lt;&lt;cellMerge&gt;&gt;&lt;&lt;[</span><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);"><span style="font-family: Consolas;">Variable1</span></span></strong><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">]&gt;&gt;</span></strong></p></td><td style="width: 98.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr><tr><td style="width: 89.625px; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-top-color: initial; border-top-style: none; border-top-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">&lt;&lt;cellMerge&gt;&gt;&lt;&lt;[</span><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);"><span style="font-family: Consolas;">Variable2</span></span></strong><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">]&gt;&gt;</span></strong></p></td><td style="width: 98.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr><tr><td style="width: 89.625px; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; border-image-source: initial; border-image-slice: initial; border-image-width: initial; border-image-outset: initial; border-image-repeat: initial; border-top-color: initial; border-top-style: none; border-top-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 368.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td><td style="width: 98.625px; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><strong><span style="font-family: &quot;Courier New&quot;; color: rgb(127, 127, 127);">...</span></strong></p></td></tr></tbody></table>
{{< alert style="warning" >}}The cellMerge tag works only if Variable1 and Variable2 have the same values.{{< /alert >}}

## Merging Table Cells Dynamically in Word Processing Document 

### The Code

{{< gist GroupDocsGists ce6422b3a193b8e9605b67b8390a0104 >}}

### Download

*   [Merging Cells Dynamically.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Merging%20Cells%20Dynamically.docx "Merging Cells Dynamically.docx")

## Merging Table Cells Dynamically in Presentation Document 

### The Code

{{< gist GroupDocsGists 87e474e4821db631dd2733b3e24576a2 >}}

### Download

*   [Merging Cells Dynamically.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Merging%20Cells%20Dynamically.pptx "Merging Cells Dynamically.pptx")

## Merging Table Cells Dynamically in Spreadsheet Document 

### The Code

{{< gist GroupDocsGists e3219ee99eafecb21eef74867efe8ec3 >}}

### Download

*   [Merging Cells Dynamically.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Merging%20Cells%20Dynamically.xlsx "Merging Cells Dynamically.xlsx")

## Merging Table Cells Dynamically in Email Document 

### The Code

{{< gist GroupDocsGists 72a369bb6e7b74134f7a5e74c8dfd624 >}}

### Download

*   [Merging Cells Dynamically.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Merging%20Cells%20Dynamically.msg "Merging Cells Dynamically.msg")

---

## Metadata redactions

Path: /redaction/java/metadata-redactions/

### Filter metadata

Base functionality for all redactions, derived from MetadataRedaction base class is *metadata filtering* and it is mandatory for metadata redactions. It uses flagged enumeration *MetadataFilter*s, containing items for most frequent metadata entries. You can set the filter to *All*, or any combination of metadata. For instance, the example below sets filter to *Author*, *Manager* and *NameOfApplication* - for textual redaction or cleaning them out:



```java
// redaction derived from MetadataRedaction
redaction.setFilter(MetadataFilters.Author | MetadataFilters.Manager | MetadataFilters.NameOfApplication);
```

Below is the table with full list of *MetadataFilters* items:

| Filter | Numeric value | Description |
| --- | --- | --- |
| *None* | 0 | Empty filter setting, matches no metadata items |
| *Author* | 1 | Author of the document |
| *Category* | 2 | Category of the document |
| *Comments* | 4 | Document comment |
| *Company* | 8 | Company of the Author |
| *ContentStatus* | 16 | Content status |
| *CreatedTime* | 32 | Created time |
| *HyperlinkBase* | 64 | Hyperlink base |
| *LastPrinted* | 128 | Last printed date and time |
| *LastSavedBy* | 256 | Last saved by user |
| *LastSavedTime* | 1024 | Last saved date and time |
| *NameOfApplication* | 2048 | Name of application where the document was created |
| *Manager* | 4096 | Author's manager name |
| *RevisionNumber* | 8192 | Revision number |
| *Subject* | 16384 | Subject of the document |
| *Template* | 32768 | Document template name |
| *Title* | 65536 | Document title |
| *TotalEditingTime* | 131072 | Total editing time |
| *Version* | 262144 | Document's version |
| *Description* | 524288 | Document's description |
| *Keywords* | 1048576 | Document's keywords |
| *ContentType* | 2097152 | Content type |
| *All* | 2147483647 | All types of the metadata items |

### Clean metadata

You can replace all or specific metadata in the document with empty (blank or minimal) values. The example below blanks out all properties of the document:



```java
final Redactor redactor  = new Redactor("Sample.docx");
try 
{
    redactor.apply(new EraseMetadataRedaction(MetadataFilters.All));
    SaveOptions options = new  SaveOptions();
    options.setAddSuffix(true);
    options.setRasterizeToPDF(false);
    // Save the document to "*_Redacted.*" file in original format
    redactor.save(options);
}
finally { redactor.close(); }
```

You can specify *MetadataFilter.All* or use default constructor to blank out all metadata within given document, Custom - to clear all custom metadata entries.

### Redact metadata

You can use *MetadataSearchRedaction* to remove sensitive data from document's metadata using regular expressions. For instance, we can remove any mention of "Company Ltd.":



```java
final Redactor redactor  = new Redactor("Sample.docx");
try 
{
    redactor.apply(new MetadataSearchRedaction("Company Ltd.", "--company--"));
    SaveOptions options = new SaveOptions();
    options.setAddSuffix(true);
    options.setRasterizeToPDF(false);
    // Save the document to "*_Redacted.*" file in original format
    redactor.save(options);
}
finally { redactor.close(); }
```

First argument is regular expression, second is a replacement string. You can also set scope for redaction by setting filter, e.g. to *MetadataFilter.Company*. - it will leave the regular expressions matches undone in all metadata items, except "Company" property:



```java
final Redactor redactor  = new Redactor("Sample.docx");
try 
{
    MetadataSearchRedaction redaction = new MetadataSearchRedaction("Company Ltd.", "--company--");
    redaction.setFilter(MetadataFilters.Company);
    redactor.apply(redaction);
    SaveOptions options = new SaveOptions();
    options.setAddSuffix(true);
    options.setRasterizeToPDF(false);
    // Save the document to "*_Redacted.*" file in original format
    redactor.save(options);
}
finally { redactor.close(); }
```

### Metadata redaction status

All metadata redactions apply to each metadata item separately, and even if metadata item redaction fails, the rest of the metadata items will be updated. You can find a list of failed, skipped (rejected) metadata items and reasons for that in *ErrorMessage* property of *RedactorLogEntry.Result*.

---

## Metadata redactions

Path: /redaction/net/metadata-redactions/

With GroupDocs.Redaction API you can apply metadata redactions for documents of different formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list at [supported document formats]({{< ref "redaction/net/getting-started/supported-document-formats.md" >}}) article.

GroupDocs.Redactions provides a flexible API that allows to replace or remove metadata using filters or search by regular expression.

## Filter metadata

Base functionality for all redactions, derived from [MetadataRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/metadataredaction) base class is *metadata filtering* and it is mandatory for metadata redactions. It uses flagged enumeration [MetadataFilters](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/metadatafilters), containing items for most frequent metadata entries. You can set the filter to *All*, or any combination of metadata. For instance, the example below sets filter to *Author*, *Manager* and *NameOfApplication* - for textual redaction or cleaning them out:

**C#**

```csharp
// redaction derived from MetadataRedaction
redaction.Filter = MetadataFilters.Author | MetadataFilters.Manager | MetadataFilters.NameOfApplication;
```

Below is the table with full list of [MetadataFilters](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/metadatafilters) items:

| Filter | Numeric value | Description |
| --- | --- | --- |
| *None* | 0 | Empty filter setting, matches no metadata items |
| *Author* | 1 | Author of the document |
| *Category* | 2 | Category of the document |
| *Comments* | 4 | Document comment |
| *Company* | 8 | Company of the Author |
| *ContentStatus* | 16 | Content status |
| *CreatedTime* | 32 | Created time |
| *HyperlinkBase* | 64 | Hyperlink base |
| *LastPrinted* | 128 | Last printed date and time |
| *LastSavedBy* | 256 | Last saved by user |
| *LastSavedTime* | 1024 | Last saved date and time |
| *NameOfApplication* | 2048 | Name of application where the document was created |
| *Manager* | 4096 | Author's manager name |
| *RevisionNumber* | 8192 | Revision number |
| *Subject* | 16384 | Subject of the document |
| *Template* | 32768 | Document template name |
| *Title* | 65536 | Document title |
| *TotalEditingTime* | 131072 | Total editing time |
| *Version* | 262144 | Document's version |
| *Description* | 524288 | Document's description |
| *Keywords* | 1048576 | Document's keywords |
| *ContentType* | 2097152 | Content type |
| *All* | 2147483647 | All types of the metadata items |

## Clean metadata

You can replace all or specific metadata in the document with empty (blank or minimal) values using [EraseMetadataRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/erasemetadataredaction) class. The example below blanks out all properties of the document:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"C:\sample.docx"))
{
   redactor.Apply(new EraseMetadataRedaction(MetadataFilters.All));

   redactor.Save();
}
```

You can specify [MetadataFilter.All](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/metadatafilters) or use default constructor to blank out all metadata within given document, Custom - to clear all custom metadata entries.

## Redact metadata

You can use [MetadataSearchRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/metadatasearchredaction) to remove sensitive data from document's metadata using regular expressions. For instance, we can remove any mention of "Company Ltd.":

**C#**

```csharp
using (Redactor redactor = new Redactor(@"C:\sample.docx"))
{
   redactor.Apply(new MetadataSearchRedaction("Company Ltd.", "--company--"));

   redactor.Save();
}
```

First argument is regular expression, second is a replacement string. You can also set scope for redaction by setting filter, e.g. to [MetadataFilter.Company](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/metadatafilters). - it will leave the regular expressions matches undone in all metadata items, except "Company" property:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"C:\sample.docx"))
{
   MetadataSearchRedaction redaction = new MetadataSearchRedaction("Company Ltd.", "--company--");
   redaction.Filter = MetadataFilters.Company;
   redactor.Apply(redaction);
   redactor.Save();
}
```

## Metadata redaction status

All metadata redactions apply to each metadata item separately, and even if metadata item redaction fails, the rest of the metadata items will be updated. You can find a list of failed, skipped (rejected) metadata items and reasons for that in [ErrorMessage](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactionresult/properties/errormessage) property of [RedactorLogEntry.Result](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactorlogentry/properties/result).  
 

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Metadata redactions

Path: /redaction/python-net/metadata-redactions/

With GroupDocs.Redaction API you can apply metadata redactions for documents of different formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list at [supported document formats]({{< ref "redaction/python-net/getting-started/supported-document-formats.md" >}}) article.

GroupDocs.Redactions provides a flexible API that allows to replace or remove metadata using filters or search by regular expression.

## Filter metadata

Base functionality for all redactions, derived from [MetadataRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/metadataredaction/) base class is *metadata filtering* and it is mandatory for metadata redactions. It uses flagged enumeration [MetadataFilters](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/metadatafilters/), containing items for most frequent metadata entries. You can set the filter to *All*, or any combination of metadata. For instance, the example below sets filter to *Author*, *Manager* and *NameOfApplication* - for textual redaction or cleaning them out:

**Python**

```python
// redaction derived from MetadataRedaction
redaction.Filter = MetadataFilters.AUTHOR | MetadataFilters.MANAGER | MetadataFilters.NAME_OF_APPLICATION;
```

Below is the table with full list of [MetadataFilters](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/metadatafilters/) items:

| Filter | Numeric value | Description |
| --- | --- | --- |
| *None* | 0 | Empty filter setting, matches no metadata items |
| *Author* | 1 | Author of the document |
| *Category* | 2 | Category of the document |
| *Comments* | 4 | Document comment |
| *Company* | 8 | Company of the Author |
| *ContentStatus* | 16 | Content status |
| *CreatedTime* | 32 | Created time |
| *HyperlinkBase* | 64 | Hyperlink base |
| *LastPrinted* | 128 | Last printed date and time |
| *LastSavedBy* | 256 | Last saved by user |
| *LastSavedTime* | 1024 | Last saved date and time |
| *NameOfApplication* | 2048 | Name of application where the document was created |
| *Manager* | 4096 | Author's manager name |
| *RevisionNumber* | 8192 | Revision number |
| *Subject* | 16384 | Subject of the document |
| *Template* | 32768 | Document template name |
| *Title* | 65536 | Document title |
| *TotalEditingTime* | 131072 | Total editing time |
| *Version* | 262144 | Document's version |
| *Description* | 524288 | Document's description |
| *Keywords* | 1048576 | Document's keywords |
| *ContentType* | 2097152 | Content type |
| *All* | 2147483647 | All types of the metadata items |

## Clean metadata

You can replace all or specific metadata in the document with empty (blank or minimal) values using [EraseMetadataRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/erasemetadataredaction/) class. The example below blanks out all properties of the document:

**Python**

```python
using (Redactor redactor = new Redactor(@"C:\sample.docx"))
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    met_red = grr.EraseMetadataRedaction(grr.MetadataFilters.ALL)

    # Load the document to be redacted
    with gr.Redactor("sample.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(met_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

You can specify [MetadataFilter.All](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/metadatafilters/) or use default constructor to blank out all metadata within given document, Custom - to clear all custom metadata entries.

## Redact metadata

You can use [MetadataSearchRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/metadatasearchredaction/) to remove sensitive data from document's metadata using regular expressions. For instance, we can remove any mention of "Company Ltd.":

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    met_red = grr.MetadataSearchRedaction("Company Ltd.", "--company--")

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(met_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

First argument is regular expression, second is a replacement string. You can also set scope for redaction by setting filter, e.g. to [MetadataFilter.Company](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/metadatafilters/). - it will leave the regular expressions matches undone in all metadata items, except "Company" property:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    met_red = grr.MetadataSearchRedaction("Company Ltd.", "--company--")
    met_red.filter = grr.MetadataFilters.COMPANY

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(met_red)
        
        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

## Metadata redaction status

All metadata redactions apply to each metadata item separately, and even if metadata item redaction fails, the rest of the metadata items will be updated. You can find a list of failed, skipped (rejected) metadata items and reasons for that in [ErrorMessage](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionresult/error_message/) property of [RedactorLogEntry.Result](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactorlogentry/result/).  
 

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Numbered List in Email Document

Path: /assembly/java/numbered-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Email Document format.{{< /alert >}}

## Numbered List in Email Document

### Creating a Numbered List

Practicing the following steps you can create Numbered List Template in MS Outlook 2013.

1.  Create a new Email.
2.  Write a sentence like "We provide support for the following clients:".
3.  Start numbered list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show the client names in a numbered list.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```java
We provide support for the following clients:
1<<foreach [in getClients()]>><<[numberOf()]>>. <<[getName()]>>
<</foreach>>
```

### Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs 598ebf2271841f987e2056918ba0507f >}}



## Restart Numbering in Nested Numbered List 

{{< alert style="info" >}}This feature is supported by version 19.7 or greater.{{< /alert >}}


The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using *<<restartNum>>* tags. In particular, this feature is useful when working with a nested numbered list within a data band.

Assume that we are picking *Order* and *Service* classes as defined in the following *Custom Objects* of our business use case.

{{< gist GroupDocsGists ffcdf1d202f0e706b98796c722e438e3 >}}

Given that orders is an enumeration of Order instances, you could try to use the following template to output information on several orders in one document.

```java
<<foreach [in getContracts()]>><<[getClient().getName()]>> (Manager: <<[getManager().getName()]>>)
1.  <<foreach [service in getServices()]>><<[service.getName()]>>
<</foreach>><</foreach>>
```

The generated report will look as follows:
```
A Company (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
B Ltd. (Manager: John Smith)
	3.	Regular Cleaning
	4.	Oven Cleaning
C & D (Manager: John Smith)
	5.	Regular Cleaning
	6.	Oven Cleaning
E Corp. (Manager: Tony Anderson)
	7.	Regular Cleaning
	8.	Oven Cleaning
	9.	Carpet Cleaning
F & Partners (Manager: Tony Anderson)
	10.	Regular Cleaning
	11.	Oven Cleaning
	12.	Carpet Cleaning
```

However, there would be a single numbered list across all orders, which is not applicable for this scenario. Hence, you can make the list numbering to restart for every order by putting a *<<restartNum>>* tag into your template before a corresponding *<<foreach>>* tag as follows:

```java
<<foreach [in getContracts()]>><<[getClient().getName()]>> (Manager:<<[getManager().getName()]>>)
1.  <<restartNum>><<foreach [service in getServices()]>><<[service.getName()]>>
<</foreach>><</foreach>>
```

 Then, the generated report will look as follows:
```
A Company (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
B Ltd. (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
C & D (Manager: John Smith)
	1.	Regular Cleaning
	2.	Oven Cleaning
E Corp. (Manager: Tony Anderson)
	1.	Regular Cleaning
	2.	Oven Cleaning
	3.	Carpet Cleaning
F & Partners (Manager: Tony Anderson)
	1.	Regular Cleaning
	2.	Oven Cleaning
	3.	Carpet Cleaning
```

Download Numbered List Template

Please download the sample Numbered List template we created in this article:

*    [Numbered List\_RestartNum.msg](attachments/49545620/85426184.msg)

---

## Numbered List in Email Document

Path: /assembly/net/numbered-list-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Numbered List report in Email Document format.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater.{{< /alert >}}

## Numbered List in Email Document

### Creating a Numbered List

Practising the following steps you can create Numbered List Template in MS Outlook 2013.

1.  Create a new Email.
2.  Write a sentence like "We provide support for the following clients:".
3.  Start numbered list.
4.  Save the template.

### Reporting Requirement

As a report developer, you are required to represent the following key requirements:

*   The report must be in .eml or .msg format.
*   It must add email recipient, CSS and subject of the email.
*   The report must show the products in the numbered list.

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
We provide support for the following products:
<<foreach [in products]>><<[NumberOf()]>>. <<[ProductName]>>
<</foreach>>
```

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Download Numbered List Template

Please download the sample Numbered List document we created in this article:

*   [Numbered List.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Numbered%20List.msg?raw=true)

### Generating The Report

{{< gist GroupDocsGists a41628c2748f0237a84b710d9538fc4f >}}

## Numbering Restart in Nested Numbered List 

{{< alert style="info" >}}This feature is supported by version 19.7 or greater.{{< /alert >}}


The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using *<<restartNum>>* tags. In particular, this feature is useful when working with a nested numbered list within a data band.

Assume that we are picking *Order* and *Service* classes as defined in the following *Custom Objects* of our business use case.

{{< gist GroupDocsGists cd8768711ff88414192c3f50a9b7c918 >}}

Given that orders is an enumeration of Order instances, you could try to use the following template to output information on several orders in one document.

```csharp
<<foreach [in orders]>><<[Customer.CustomerName]>> (<<[Customer.CustomerContactNumber]>>)
1.	<<foreach [in Services]>><<[ServiceName]>>
<</foreach>><</foreach>>
```

The generated report will look as follows:

```
Jane Doe (+9211874)
	1.	Regular Cleaning
	2.	Oven Cleaning
John Smith (+458789)
	3.	Regular Cleaning
	4.	Oven Cleaning
	5.	Carpet Cleaning
John Smith (+458789)
	6.	Regular Cleaning
	7.	Carpet Cleaning
John Smith (+458789)
	8.	Oven Cleaning
```

However, there would be a single numbered list across all orders, which is not applicable for this scenario. Hence, you can make the list numbering to restart for every order by putting a *<<restartNum>>* tag into your template before a corresponding *<<foreach>>* tag as follows:

```csharp
<<foreach [in orders]>><<[ Customer.CustomerName]>> (<<[Customer.CustomerContactNumber]>>)
1.	<<restartNum>><<foreach [in Services]>><<[ServiceName]>>
<</foreach>><</foreach>>
```

 Then, the generated report will look as follows:

```
Jane Doe (+9211874)
	1.	Regular Cleaning
	2.	Oven Cleaning
John Smith (+458789)
	1.	Regular Cleaning
	2.	Oven Cleaning
	3.	Carpet Cleaning
John Smith (+458789)
	1.	Regular Cleaning
	2.	Carpet Cleaning
John Smith (+458789)
	1.	Oven Cleaning
```

## Download Numbered List Template

Please download the sample Numbered List template we created in this article:

*   [Numbered List\_RestartNum.msg](attachments/50266283/85426182.msg)

---

## Options and Configuration

Path: /parser/python-net/options/


Most parsing scenarios work with defaults, but `groupdocs.parser.options` exposes classes to control how documents are opened and processed. Use these options to handle passwords, guide format detection, or tune search and text extraction modes.

## Apply load options
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import LoadOptions

# Pass a password and open from a stream
with open("input/protected.pdf", "rb") as stream:
    options = LoadOptions("secret-password")
    with Parser(stream, options) as parser:
        reader = parser.get_text()
        print(reader if reader else "Text extraction isn't supported.")
```

{{< /tab >}}
{{< tab "protected.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [protected.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/options/input/protected.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## When to use other options

- **Search options** — control case-sensitivity or regex mode when calling search APIs.  
- **Text/formatting options** — request formatted text (HTML/Markdown/plain) where supported.  
- **Parser settings** — adjust resource loading or timeouts for specific environments.

Check the [`groupdocs.parser.options` namespace](https://reference.groupdocs.com/parser/python-net/groupdocs.parser.options/) for the complete list of option classes and their parameters, and pass them to the corresponding methods as documented in the API reference.




---

## eSign document with QR code signature

Path: /signature/net/esign-document-with-qr-code-signature/

## What is a QR code?

QR code (or Quick Response code) is a sort of two-dimensional [barcode]({{< ref "signature/net/developer-guide/basic-usage/electronic-signature-types/esign-document-with-barcode-signature.md" >}}) that consists of black squares arranged in a square grid on a white background. QR codes can be read by smartphone cameras or specialized devices that are dedicated to QR reading - hand-held scanners, handy terminals, desktop scanners, embedded scanners, and so on. Usually QR codes contain data that points to a website or application, emails, or phone numbers, product identifiers, or trackers. Therefore, the scope of QR code applications extends from general marketing and item identification to document management.

![QR code](/signature/net/images/esign-document-with-qr-code-signature.png)

## How to eSign document with QR-Code signature

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) can sign the documents with QR codes of the following types. 

| |Aztec code | DataMatrix code | GS1 DataMatrix  | GS1 QR code  | QR |
| --- | --- | --- | --- | --- | --- |
| **Application** | * transport and ticketing;<br> * in airline industry for electronic boarding passes;<br> * in rail for tickets sold online and printed out by customers or displayed on mobile phone screens. Code is scanned by a handheld scanner by on-train staff or at the turnstile to validate the ticket.<br> * medicine - patient identification wristbands and labels for unit-of-use medications etc. | * printed media such as labels and letters;<br> * industrial engineering purposes - marking components etc;<br>  * food industry - to prevent food products being packaged and dated incorrectly; | Used in<br> * Healthcare;<br> * Government;<br> * Industrial.<br> Encodes item additional information, such as:<br> * weight;<br> * expiration date;<br> * batch number;<br> * date of manufacture;<br> * etc.| Used in marketing to encode additional item information on the package | Widely used in automotive industry and mobile applications. Useful for encoding large amount of data characters and specific URLs.| 
| **Length** | 3067 alphanumeric,<br> 3832 numeric,<br> 1914 bytes | 2335 alphanumeric,<br> 3116 numeric | 2335 alphanumeric,<br> 3116 numeric,<br> 1556 bytes | 7089 alphanumeric,<br> 4296 numeric,<br> 2953 bytes | 4296 alphanumeric,<br> 7089 numeric,<br> 2953 bytes |
| **Example** | ![Aztec](/signature/net/images/esign-document-with-qr-code-signature_1.png) | ![DataMatrix](/signature/net/images/esign-document-with-qr-code-signature_2.png) | ![GS1 DataMatrix](/signature/net/images/esign-document-with-qr-code-signature_3.png) | ![GS1 QR code](/signature/net/images/esign-document-with-qr-code-signature_4.png) | ![QR](/signature/net/images/esign-document-with-qr-code-signature_5.png)

When adding QR code electronic signature to a document, the main settings are the text to be encoded and the [type of the QR code](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/qrcodetypes/#fields) which should be specified via the [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) class.  

Here are the steps to eSign a document with the QR code signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.

* Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object according to your requirements and specify the [EncodeType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/encodetype) and the [Text](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/text) properties.
  
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.

The code snippet below demonstrates how to sign a PDF document with the QR code signature.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // create QRCode option with predefined QRCode text
    QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith")
    {
        // setup QRCode encoding type
        EncodeType = QrCodeTypes.QR,
        // set signature position
        Left = 100,
        Top = 100
    };
    signature.Sign("SampleSigned.pdf", options);
}
```
### Summary
This guide demonstrates how to add QR code signatures to documents using [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) . It includes steps for generating a QR code signature, configuring its properties like size and encoding, and applying it to a document. QR code signatures can be used for quick verification of the signed document.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign document with QR code signature

Path: /signature/nodejs-java/esign-document-with-qr-code-signature/

## What is a QR code?

QR code (or Quick Response code) is a sort of two-dimensional [barcode]({{< ref "signature/nodejs-java/developer-guide/basic-usage/electronic-signature-types/esign-document-with-barcode-signature.md" >}}) that consists of black squares arranged in a square grid on a white background. QR codes can be read by smartphone cameras or specialized devices that are dedicated to QR reading - hand-held scanners, handy terminals, desktop scanners, embedded scanners, and so on. Usually QR codes contain data that points to a website or application, emails, or phone numbers, product identifiers, or trackers. Therefore, the scope of QR code applications extends from general marketing and item identification to document management.

![QR code](/signature/nodejs-java/images/esign-document-with-qr-code-signature.png)

## How to eSign document with QR-Code signature

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) can sign the documents with QR codes of the following types. 

| |Aztec code | DataMatrix code | GS1 DataMatrix  | GS1 QR code  | QR |
| --- | --- | --- | --- | --- | --- |
| **Application** | * transport and ticketing;<br> * in airline industry for electronic boarding passes;<br> * in rail for tickets sold online and printed out by customers or displayed on mobile phone screens. Code is scanned by a handheld scanner by on-train staff or at the turnstile to validate the ticket.<br> * medicine - patient identification wristbands and labels for unit-of-use medications etc. | * printed media such as labels and letters;<br> * industrial engineering purposes - marking components etc;<br>  * food industry - to prevent food products being packaged and dated incorrectly; | Used in<br> * Healthcare;<br> * Government;<br> * Industrial.<br> Encodes item additional information, such as:<br> * weight;<br> * expiration date;<br> * batch number;<br> * date of manufacture;<br> * etc.| Used in marketing to encode additional item information on the package | Widely used in automotive industry and mobile applications. Useful for encoding large amount of data characters and specific URLs.| 
| **Length** | 3067 alphanumeric,<br> 3832 numeric,<br> 1914 bytes | 2335 alphanumeric,<br> 3116 numeric | 2335 alphanumeric,<br> 3116 numeric,<br> 1556 bytes | 7089 alphanumeric,<br> 4296 numeric,<br> 2953 bytes | 4296 alphanumeric,<br> 7089 numeric,<br> 2953 bytes |
| **Example** | ![Aztec](/signature/nodejs-java/images/esign-document-with-qr-code-signature_1.png) | ![DataMatrix](/signature/nodejs-java/images/esign-document-with-qr-code-signature_2.png) | ![GS1 DataMatrix](/signature/nodejs-java/images/esign-document-with-qr-code-signature_3.png) | ![GS1 QR code](/signature/nodejs-java/images/esign-document-with-qr-code-signature_4.png) | ![QR](/signature/nodejs-java/images/esign-document-with-qr-code-signature_5.png)

When adding QR code electronic signature to a document, the main settings are the text to be encoded and the [type of the QR code](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.domain/qrcodetypes/#fields) which should be specified via the [QrCodeSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodesignoptions) class.  

Here are the steps to eSign a document with the QR code signature:
Here is the corrected text with accurate links:

---

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.

* Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodesignoptions) object according to your requirements and specify the [EncodeType](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodesignoptions/encodetype) and the [Text](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions/text) properties.

* Call the [Sign](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/sign) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [QrCodeSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/qrcodesignoptions) to it.

The code snippet below demonstrates how to sign a PDF document with the QR code signature.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF; // Assuming Constants.SAMPLE_PDF is defined elsewhere
  const fileName = path.basename(filePath);

  const outputFilePath = path.join(Constants.OutputPath, 'SignWithQRCode', fileName);
  const signature = new signatureLib.Signature(filePath);

  // Create QR code sign options
  const options = new signatureLib.QrCodeSignOptions('JohnSmith');

  // Setup QR code encoding type
  options.setEncodeType(signatureLib.QrCodeTypes.QR);
  
  // Set signature position
  options.setLeft(100);
  options.setTop(100);

  // Sign document to file
  signature.sign(outputFilePath, options);
  console.log(`\nSource document signed successfully.\nFile saved at ${outputFilePath}`);
```
### Summary
This guide demonstrates how to add QR code signatures to documents using [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) . It includes steps for generating a QR code signature, configuring its properties like size and encoding, and applying it to a document. QR code signatures can be used for quick verification of the signed document.



## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature Node.Js for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Rotate pages

Path: /viewer/java/flip-or-rotate-pages/

![Flip or rotate pages](/viewer/java/images/flip-or-rotate-pages.png)

To rotate a page when rendering document, use the [RotatePage](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewoptions/#rotatePage-int-com.groupdocs.viewer.options.Rotation-) method of the [ViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewoptions/) class. This method has the following two parameters:

1. page number
2. rotation angle

The rotation angle is one of the following:

* [Rotation.ON_90_DEGREE](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/rotation/#ON-90-DEGREE) rotate page on 90-degree clockwise
* [Rotation.ON_180_DEGREE](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/rotation/#ON-180-DEGREE) rotate page on 180-degree clockwise
* [Rotation.ON_270_DEGREE](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/rotation/#ON-270-DEGREE) rotate page on 270-degree clockwise

The following code snippet shows how to rotate output pages when rendering a document as PDF:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.Rotation;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    PdfViewOptions viewOptions = new PdfViewOptions();
    // Rotate the first page.
    viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

You can also view the [example](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java/blob/master/Examples/src/main/java/com/groupdocs/viewer/examples/advanced_usage/rendering/common_rendering_options/RotatePages.java) in our public [GitHub repository](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java).
---

## Rotate pages

Path: /viewer/net/flip-or-rotate-pages/

![Flip or rotate pages](/viewer/net/images/flip-or-rotate-pages.png)

To rotate a page when rendering document, use the [RotatePage](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewoptions/methods/rotatepage) method of the [ViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewoptions) class. This method has the following two parameters:

1. page number
2. rotation angle

The rotation angle is one of the following:

* [Rotation.On90Degree](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/rotation) rotate page on 90-degree clockwise
* [Rotation.On180Degree](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/rotation) rotate page on 180-degree clockwise
* [Rotation.On270Degree](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/rotation) rotate page on 270-degree clockwise

The following code snippet shows how to rotate output pages when rendering a document as PDF:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions();
    // Rotate the first page.
    viewOptions.RotatePage(1, Rotation.On90Degree);
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create a PDF file.
            Dim viewOptions As PdfViewOptions = New PdfViewOptions()
            ' Rotate the first page.
            viewOptions.RotatePage(1, Rotation.On90Degree)
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

You can also view the [example](https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET/blob/master/Examples/GroupDocs.Viewer.Examples.CSharp/AdvancedUsage/Rendering/CommonRenderingOptions/FlipRotatePages.cs) in our public GitHub repository .
---

## Save to Stream

Path: /redaction/net/save-to-stream/

You might need to save a document to any custom file at any location on the local disc or a even a Stream.

The following example demonstrates how to save a document to any location.

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Here we can use document instance to perform redactions
    RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(System.Drawing.Color.Red)));
    if (result.Status != RedactionStatus.Failed)
    {
        // Save the document to a custom location and convert its pages to images
        using (Stream fileStream = File.Open(@"C:\\Temp\\sample_output_file.pdf", FileMode.Open, FileAccess.ReadWrite))
        {
            redactor.Save(fileStream, new RasterizationOptions() { Enabled = true });
        }
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Save to Stream

Path: /redaction/python-net/save-to-stream/

You might need to save a document to any custom file at any location on the local disc or a even a Stream.

The following example demonstrates how to save a document to any location.

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():

    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions(color)
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        if (result.status != gr.RedactionStatus.FAILED):
            # Save the document to a custom location and convert its pages to images
            ro = gro.RasterizationOptions()
            ro.enabled = True
            with open(output_file, "wb") as stream_out:
                redactor.save(stream_out, ro)

            print(f"Document redacted successfully.\nCheck output in {source_file}")
        else:
            print(f"Redaction failed!")
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Search text in PDF documents

Path: /parser/java/search-text-in-pdf-documents/

To search a keyword in PDF documents [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult "class in com.groupdocs.parser.data") objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult "class in com.groupdocs.parser.data") objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null value if search isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null. For empty PDF document [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in PDF document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("nunc");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method is used for the advanced search in PDF documents - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in PDF document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdf)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("(\\\\sut\\\\s)", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in PDF documents

Path: /parser/net/search-text-in-pdf-documents/

To search a keyword in PDF documents [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns null value if search isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns null. For empty PDF document [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in PDF document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
   
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in PDF documents - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in PDF document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in PDF document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Select specific pages for rasterized PDF

Path: /redaction/java/select-specific-pages-for-rasterized-pdf/

### Select specific pages for rasterized PDF

Saving document as a rasterized PDF, you can specify starting page index (zero based) and the number of pages from this index to save. Also, you can change the Compliance level from PDF/A-1b, which is used by default, to PDF/A-1a:



```java
final Redactor redactor = new Redactor("MultipageSample.docx");
try 
{
    RedactorChangeLog result = redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(java.awt.Color.RED)));
    if (result.getStatus() != RedactionStatus.Failed)
    {
        SaveOptions options = new SaveOptions();
        options.getRasterization().setEnabled(true);                           // the same as options.RasterizeToPDF = true;
        options.getRasterization().setPageIndex(5);                            // start from 6th page (index is 0-based)
        options.getRasterization().setPageCount(1);                            // save only one page
        options.getRasterization().setCompliance(PdfComplianceLevel.PdfA1a);   // by default PdfComplianceLevel.Auto or PDF/A-1b
        options.setAddSuffix(true);
        redactor.save(options);
    }
}
finally { redactor.close(); }
```

---

## Sentiment classification usage

Path: /classification/net/sentiment-classification-usage/

Create an instance of **SentimentClassifier** class. It is multilingual and supports English, Chinese, Spanish, and German.

**Creates SentimentClassifier instance**

```csharp
var sentimentClassifier = new SentimentClassifier();
```

and call **PositiveProbability** method

**Classifies sentiment by text**

```csharp
var positiveProbability = sentimentClassifier.PositiveProbability("This is a new must-have thing.");
Console.WriteLine($"The probability of a positive sentiment is { positiveProbability }");
```

or call **Classify** method

**Classifies sentiment by text**

```csharp
var response = sentimentClassifier.Classify("This is a new must-have thing.");
Console.WriteLine($"The best class name:{response.BestClassName}, probability: {response.BestClassProbability}");
```

**Classifies sentiment by text with 3 classes taxonomy (Negative/Neutral/Positive)**

```csharp
var response = sentimentClassifier.Classify("This is a new must-have thing.", taxonomy: Taxonomy.Sentiment3);
Console.WriteLine($"The best class name:{response.BestClassName}, probability: {response.BestClassProbability}");
```

**SentimentClassifier** class is thread-safe.

---

## Set custom fonts

Path: /viewer/java/set-custom-fonts/

Many document formats are tightly bounded with fonts. For example, when user adds some text to the DOCX document, this text always have some defined font. Some document formats usually store the font data embedded in the document file itself, like PDF. But other, like Office family formats, usually rely on the fonts, installed in the operating system.

The situation, when some document was created on the _author’s machine_ and uses some font "AAA", and then is processed using the GroupDocs.Viewer on some _client’s machine_, where font "AAA" is missing, is typical. In such case GroupDocs.Viewer tries to **substitute this font** using some complex font substitution rules: it analyzes the metadata of the document, alternative names of the missing font, settings of the document, settings of the OS, list of all available fonts, installed in the OS and so on. Finally, when by some reason the OS is “clean”, when it has no installed fonts at all, then GroupDocs.Viewer will substitute the missing font with the one, that is embedded inside the GroupDocs.Viewer package (.jar); this font will serve as a "last resort" in case when no other fonts are available. For example, for the WordProcessing family formats, the GroupDocs.Viewer internally stores the "Fanwood" free font.

At this moment the GroupDocs.Viewer does the **font substitution** operation “silently” **during rendering** of the document (when the [`Viewer.view()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method is invoked) — there are no any messages or events when the font substitution mechanism is activated and which font is missing and onto which is replaced/substituted, and for which exact document. Such feature is hard to implement because it is too unclear, vague, and ambiguous what kind of notification should be emitted, in which form and how they can be utilizing on the client’s side.

However, users can control this process **before** the document is actually rendered. When the user initially _knows_ that some document uses font "AAA", _and_ also _knows_ that this font "AAA" is not installed on the target machine, where document should be rendered, _and_ user has the binary content of this font "AAA", he can specify it **before** calling the [`Viewer.view()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

In order to specify one or many custom fonts, which are not installed in the target operating system, user should _add custom font source(s)_. **Font source** is actually a folder, where one or many fonts are located. It is represented by a [`FolderFontSource`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/folderfontsource/) class. And the [`FontSettings`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/fontsettings/) class has a method [`setFontSources()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/fontsettings/#setFontSources-com.groupdocs.viewer.fonts.FontSource...-) for adding the **font sources** to the GroupDocs.Viewer.

The following code snippet demonstrates this. Let's assume that the "sample.docx" document uses some rare font "AAA.ttf", that is not installed on the target operating system. Then the user puts the file "AAA.ttf" to the `"C:\custom_fonts"` folder and then creates an instance of the [`FolderFontSource`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/folderfontsource/) class that points to this folder. Then this instance is passed to the [`FontSettings`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/fontsettings/) static class, and then the "sample.docx" file is rendered to HTML format. As a result, the "AAA" font will be used in the output HTML document.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.fonts.FolderFontSource;
import com.groupdocs.viewer.fonts.FontSettings;
import com.groupdocs.viewer.fonts.SearchOption;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

FolderFontSource fontSource = new FolderFontSource("C:\\custom_fonts", SearchOption.TOP_FOLDER_ONLY);
FontSettings.setFontSources(fontSource);

try (Viewer viewer = new Viewer("sample.docx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

However, in case when user has no access to the binary content of the font, that is used in the document and is not installed on the target operating system, user may **replace** the missing font onto some alternative. **Font replacement** here serves as a some sort of a user-defined **font substitution**, that is programmed **before** rendering of a document. More on this in a [separate article]({{< ref "viewer/java/developer-guide/rendering-documents/replace-missing-font.md" >}}).
---

## Set custom fonts

Path: /viewer/net/set-custom-fonts/

Many document formats are tightly bounded with fonts. For example, when user adds some text to the DOCX document, this text always have some defined font. Some document formats usually store the font data embedded in the document file itself, like PDF. But other, like Office family formats, usually rely on the fonts, installed in the operating system.

The situation, when some document was created on the _author’s machine_ and uses some font "AAA", and then is processed using the GroupDocs.Viewer on some _client’s machine_, where font "AAA" is missing, is typical. In such case GroupDocs.Viewer tries to **substitute this font** using some complex font substitution rules: it analyzes the metadata of the document, alternative names of the missing font, settings of the document, settings of the OS, list of all available fonts, installed in the OS and so on. Finally, when by some reason the OS is “clean”, when it has no installed fonts at all, then GroupDocs.Viewer will substitute the missing font with the one, that is embedded inside the GroupDocs.Viewer assembly (DLL); this font will serve as a "last resort" in case when no other fonts are available. For example, for the WordProcessing family formats, the GroupDocs.Viewer internally stores the "Fanwood" free font.

At this moment the GroupDocs.Viewer does the **font substitution** operation “silently” **during rendering** of the document (when the [`Viewer.View()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/view/#view) method is invoked) — there are no any messages or events when the font substitution mechanism is activated and which font is missing and onto which is replaced/substituted, and for which exact document. Such feature is hard to implement because it is too unclear, vague, and ambiguous what kind of notification should be emitted, in which form and how they can be utilizing on the client’s side.

However, users can control this process **before** the document is actually rendered. When the user initially _knows_ that some document uses font "AAA", _and_ also _knows_ that this font "AAA" is not installed on the target machine, where document should be rendered, _and_ user has the binary content of this font "AAA", he can specify it **before** calling the [`Viewer.View()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/view/#view) method.

In order to specify one or many custom fonts, which are not installed in the target operating system, user should _add custom font source(s)_. **Font source** is actually a folder, where one or many fonts are located. It is represented by a [`FolderFontSource`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/folderfontsource/) class. And the [`FontSettings`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontsettings/) class has a method [`SetFontSources()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontsettings/setfontsources/) for adding the **font sources** to the GroupDocs.Viewer.

The following code snippet demonstrates this. Let's assume that the "sample.docx" document uses some rare font "AAA.ttf", that is not installed on the target operating system. Then the user puts the file "AAA.ttf" to the `"C:\custom_fonts"` folder and then creates an instance of the [`FolderFontSource`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/folderfontsource/) class that points to this folder. Then this instance is passed to the [`FontSettings`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontsettings/) static class, and then the "sample.docx" file is rendered to HTML format. As a result, the "AAA" font will be used in the output HTML document.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Fonts;
// ...

// Specify the font source.
FolderFontSource fontSource = 
    new FolderFontSource(@"C:\custom_fonts", SearchOption.TopFolderOnly);
FontSettings.SetFontSources(fontSource);

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Fonts
' ...

Module Program
    Sub Main(args As String())
        ' Specify the font source.
        Dim fontSource As FolderFontSource = New FolderFontSource("C:\custom_fonts", SearchOption.TopFolderOnly)
        FontSettings.SetFontSources(fontSource)
    
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create an HTML file.
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources()
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

However, in case when user has no access to the binary content of the font, that is used in the document and is not installed on the target operating system, user may **replace** the missing font onto some alternative. **Font replacement** here serves as a some sort of a user-defined **font substitution**, that is programmed **before** rendering of a document. More on this in a [separate article]({{< ref "viewer/net/developer-guide/rendering-documents/replace-missing-font.md" >}}).
---

## Set license under Mono/Linux

Path: /conversion/net/set-license-under-mono-linux/


Sometimes under Mono/Linux when license is set from relative path unexpected exceptions are raised.

Under Mono/Linux use one of the following ways to set the license:

1. Set license with absolute path e.g.:

    ```csharp
    license.SetLicense("/home/<USERNAME>/conversion-sample-src/GroupDocs.Conversion.NET.lic");
    ```

2. Provide license stream loaded from the license file e.g.:
    
    ```csharp
    using(var licenseStream = new FileStream("GroupDocs.Conversion.NET.lic", FileMode.Open)) {

        license.SetLicense(licenseStream);
        
    }
    ```
---

## Showcases

Path: /conversion/java/showcases/

{{< alert style="info" >}}Want to try GroupDocs.Conversion for Java by yourself? Please check Java code sources, how-to examples and free online demonstrations provided below to learn more about file conversion features.{{< /alert >}}

## GitHub Examples

You may download GroupDocs.Conversion for Java code examples from our GitHub repository and see how to convert files programmatically:

* [GroupDocs.Conversion for Java examples, plugins, and showcase](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java)
* [Document Conversion for Java Spring Example](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java/tree/master/Demos/Spring)
* [Document Conversion for Java Dropwizard Example](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java/tree/master/Demos/Dropwizard)

## Online Demo

Along with full-featured Java library we provide free Apps and free services for document conversion.
To see a full potential of GroupDocs.Conversion, you are welcome to convert PDF to DOCX, JPG to XLSX, PPTX to PNG and more with **[Free Online Document Conversion App](https://products.groupdocs.app/conversion)**.

---

## Sign documents with standard QR-code entries

Path: /signature/java/sign-documents-with-standard-qr-code-entries/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to embed into QR-code signature standard entries like email, contact v-card, address etc. This feature supports standard QR-code representation of entries. At this moment following standard QR-code entries are supported

* [Email](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/email/ ) entry that allows to specify in QR-code standard email information with recipient, subject and body.
* [Address](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/address/ ) entry contains address information.
* [V-Card](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/vcard/ ) entry implements standard of visit card 3.0 specification. More details could be found [here](https://en.wikipedia.org/wiki/VCard).
* [Me-Card](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/mecard/ ) entry implements similar to V-Card contact details standard. More details could be found [here](https://en.wikipedia.org/wiki/MeCard_(QR_code)).
* [EPC](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/epc/ ) implements standard of the European Payments Council guidelines define the content of a QR code that can be used to initiate [SEPA](https://en.wikipedia.org/wiki/SEPA_credit_transfer) credit transfer. More details could be found [here](https://en.wikipedia.org/wiki/EPC_QR_code).
* [Event](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/event/ ) entry implements event standard.
* [CryptoCurrencyTransfer](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/cryptocurrencytransfer/) entry implements event standard.
* [WiFi](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/wifi/) entry implements WiFI settings standard.
* [SMS](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.extensions.serialization/sms/) entry implements sms properties.

Here are the steps to embed standard entry into QR-code with GroupDocs.Signature:  

* Create new instance of  [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature ) class and pass source document path as a constructor parameter.
* Create new instance of one of standard entries class.
* Create one or several objects of [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions ) object with [getData](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions#getData() ) value assigned with initialized standard object before.
* Instantiate the  [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions )  object according to your requirements and custom object to [getData](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions#getData() ) property.
* Call [sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20java.util.List) ) method of  [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature )  class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions ) to it.

## Sign PDF with email QR-code object

This example shows how to esign PDF with Email QR-code object.

```java
Signature signature = new Signature("sample.pdf"))

    // create Email object
    Email email = new Email();
	email.setAddress("sherlock@holmes.com");
	email.setSubject("Very important e-mail");
	email.setBody("Hello, Watson. Reach me ASAP!");


	// create options
	// create options
	QrCodeSignOptions options = new QrCodeSignOptions();
	options.setEncodeType(QrCodeTypes.QR);
	// setup Data property to Address instance
	options.setData(email);
	// set right bottom corner
	options.setHorizontalAlignment(HorizontalAlignment.Right);
	options.setVerticalAlignment(VerticalAlignment.Bottom);
	options.setMargin(new Padding(10));
	options.setWidth(100);
	options.setHeight(100);

    // sign document to file
    signature.sign("output.pdf", options);

```

## Sign PDF with Address inside the QR-Code image

This example shows how to esign PDF with address inside the QR-code image.

```java
Signature signature = new Signature("sample.pdf"))
{
    // create Address object
    Address address = new Address();
	address.setStreet("221B Baker Street");
	address.setCity("London");
	address.setState("NW");
	address.setZIP("NW16XE");
	address.setCountry("England");


	// create options
	QrCodeSignOptions options = new QrCodeSignOptions();
	options.setEncodeType(QrCodeTypes.QR);
		// setup Data property to Address instance
	options.setData(address);
		// set right bottom corner
	options.setHorizontalAlignment(HorizontalAlignment.Right);
	options.setVerticalAlignment(VerticalAlignment.Bottom);
	options.setMargin(new Padding(10));
	options.setWidth(100);
	options.setHeight(100);
    // sign document to file
    signature.sign("output.pdf", options);
}
```

## Sign PDF with V-Card (VCF) information in the QR-Code image

This example shows how to esign PDF with V-Card inside the QR-code image.

```java
Signature signature = new Signature("sample.pdf"))
{
    // create VCard object
    VCard vCard = new VCard();

	vCard.setFirstName("Sherlock");
	vCard.setMidddleName("Jay");
	vCard.setLastName("Holmes");
	vCard.setInitials("Mr.");
	vCard.setCompany("Watson Inc.");
	vCard.setJobTitle("Detective");
	vCard.setHomePhone("0333 003 3577");
	vCard.setWorkPhone("0333 003 3512");
	vCard.setEmail("watson@sherlockholmes.com");
	vCard.setUrl("http://sherlockholmes.com/");
	vCard.setBirthDay(new Date(1854, 1, 6));
	Address address = new Address();
	address.setStreet("221B Baker Street");
	address.setCity("London");
	address.setState("NW");
	address.setZIP("NW16XE");
	address.setCountry("England");
	vCard.setHomeAddress(address);


	// create options
	QrCodeSignOptions options = new QrCodeSignOptions();
	options.setEncodeType(QrCodeTypes.QR);
	// setup Data property to Address instance
	options.setData(vCard);
	// set right bottom corner
	options.setHorizontalAlignment(HorizontalAlignment.Right);
	options.setVerticalAlignment(VerticalAlignment.Bottom);
	options.setMargin(new Padding(10));
	options.setWidth(100);
	options.setHeight(100);

    // sign document to file
    signature.sign("output.pdf", options);
}
```

## Sign PDF with Me-Card information in the QR-Code image

This example shows how to esign PDF with Me-Card inside the QR-code image.

```java
Signature signature = new Signature("sample.pdf")
{
    // create MeCard object
    MeCard meCard = new MeCard();
	meCard.setName("Sherlock");
	meCard.setNickname("Jay");
	meCard.setReading("Holmes");
	meCard.setNote("Base Detective");
	meCard.setPhone("0333 003 3577");
	meCard.setAltPhone("0333 003 3512");
	meCard.setEmail("watson@sherlockholmes.com");
	meCard.setUrl("http://sherlockholmes.com/");
	meCard.setBirthDay(new Date(1854, 1, 6));
	Address address = new Address();
	address.setStreet("221B Baker Street");
	address.setCity("London");
	address.setState("NW");
	address.setZIP("NW16XE");
	address.setCountry("England");
	meCard.setAddress(address);

	// create options
	QrCodeSignOptions options = new QrCodeSignOptions();
	options.setEncodeType(QrCodeTypes.QR);
	// setup Data property to MeCard instance
	options.setData(meCard);
	// set right bottom corner
	options.setHorizontalAlignment(HorizontalAlignment.Right);
	options.setVerticalAlignment(VerticalAlignment.Bottom);
	options.setMargin(new Padding(10));
	options.setWidth(100);
	options.setHeight(100);

    // sign document to file
    signature.Sign("output.pdf", options);
}
```

## Sign PDF with EPC payment in the QR-Code image

This example shows how to esign PDF with EPC / SEPA payment inside the QR-code image.

```java
Signature signature = new Signature("sample.pdf")
{
    // create EPC object
	EPC epc = new EPC();
	epc.setName("Sherlock");
	epc.setBIC("MrSherlockH");
	epc.setIBAN("BE72000000001616");
	epc.setAmount(123456.78D);
	epc.setCode("SHRL");
	epc.setReference("Private service");
	epc.setInformation("Thanks for help");

	// create options
	QrCodeSignOptions options = new QrCodeSignOptions();
	options.setEncodeType(QrCodeTypes.QR);
	// setup Data property to EPC instance
	options.setData(epc);
	// set right bottom corner
	options.setHorizontalAlignment(HorizontalAlignment.Right);
	options.setVerticalAlignment(VerticalAlignment.Bottom);
	options.setMargin(new Padding(10));
	options.setWidth(100);
	options.setHeight(100);

    // sign document to file
    signature.sign("output.pdf", options);
}
```

## Sign PDF with Event information in the QR-Code image

This example shows how to esign PDF with event data inside the QR-code image.

```java
Signature signature = new Signature("sample.pdf")
{
    // create Event object
    Event evnt = new Event();

	evnt.setTitle("GTM(9-00)");
	evnt.setDescription("General Team Meeting");
	evnt.setLocation("Conference-Room");
	Calendar c1 = Calendar.getInstance();
	c1.setTime(new Date());
	c1.add(Calendar.DATE, 1);
	c1.add(Calendar.HOUR, 9);
	Calendar c2 = Calendar.getInstance();
	c2.setTime(new Date());
	c2.add(Calendar.DATE, 1);
	c2.add(Calendar.HOUR, 9);
	c2.add(Calendar.MINUTE, 30);
	evnt.setStartDate(c1.getTime());
	evnt.setEndDate(c2.getTime());

	// create options
	QrCodeSignOptions options = new QrCodeSignOptions();
	options.setEncodeType(QrCodeTypes.QR);
	// setup Data property to Event instance
	options.setData(evnt);
	// set right bottom corner
	options.setHorizontalAlignment(HorizontalAlignment.Right);
	options.setVerticalAlignment(VerticalAlignment.Bottom);
	options.setMargin(new Padding(10));
	options.setWidth(100);
	options.setHeight(100);
    // sign document to file
    signature.sign("output.pdf", options);
}
```
## Sign PDF with CryptoCurrencyTransfer information in the QR-Code image

This example shows how to esign PDF with Cryptocurrency transfer data inside the QR-code image.

```java
Signature signature = new Signature("sample.pdf");

// create crypto currency object
CryptoCurrencyTransfer transfer = new CryptoCurrencyTransfer();
transfer.setType(CryptoCurrencyType.Bitcoin);
transfer.setAddress("1JHG2qjdk5Khiq7X5xQrr1wfigepJEK3t");
transfer.setAmount(1234.56M);
transfer.setMessage("Consulting services");

// create alternative crypto currency object
CryptoCurrencyTransfer customTransfer = new CryptoCurrencyTransfer();
customTransfer.setType(CryptoCurrencyType.Custom);
customTransfer.setCustomType("SuperCoin");
customTransfer.setAddress("15N3yGu3UFHeyUNdzQ5sS3aRFRzu5Ae7EZ");
customTransfer.setAmount(6543.21M);
customTransfer.setMessage("Accounting services");

// create QR-code options
QrCodeSignOptions options1 = new QrCodeSignOptions();

// setup Data property to Address instance
options1.setData(transfer);
options1.setLeft(10);
options1.setTop(10);

// create alternative QR-code options
QrCodeSignOptions options2 = new QrCodeSignOptions();

// setup Data property to Address instance
options2.setData(customTransfer);
options2.setLeft(10);
options2.setTop(200);

List<SignOptions> listOptions = new List<SignOptions>();
listOptions.add(options1);
listOptions.add(options2);
// sign document to file
signature.sign("output.pdf", listOptions);

```

## Create an image with the WiFi QR Code information

This example shows how to create an image with the WiFi QR Code object.

```java
Signature signature = new Signature("sample.png");

// create WiFi object
WiFi wifi  = new WiFi();
wifi.setSSID("GuestNetwork!");
wifi.setEncryption(WiFiEncryptionType.WPAWPA2);
wifi.setPassword("guest");
wifi.setHidden(false);

// create options
QrCodeSignOptions options = new QrCodeSignOptions();

options.setEncodeType(QrCodeTypes.QR);
// setup Data property to WiFi object instance
options.setData(wifi);
// set right bottom corner
options.setHorizontalAlignment(HorizontalAlignment.Right);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setWidth(100);
options.setHeight(100);
options.setMargin(new Padding(10));


// sign document to image file
signature.sign("output.png", options);

```

## Sign PDF with SMS data information in the QR-Code

This example shows how to esign PDF with QR Code SMS data on the PDF page. This could be used for automatic document verification or subscription. 

```java
Signature signature = new Signature("sample.pdf");

// create SMS object
SMS sms = new SMS();
sms.setNumber("0800 048 0408");
sms.setMessage("Document approval automatic SMS message");

// create options
QrCodeSignOptions options = new QrCodeSignOptions();
options.setEncodeType(QrCodeTypes.QR);
	// setup Data property to Address instance
options.setData(sms);
	// set right bottom corner
options.setHorizontalAlignment(HorizontalAlignment.Right);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setWidth(100);
options.setHeight(100);
options.setMargin(new Padding(10));

// sign document to file
signature.sign("output.pdf", options);

```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Single Row Image in Email Document

Path: /assembly/java/single-row-image-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Email Document format.{{< /alert >}}

## Single Row Image in Email Document

### Reporting Requirement

As a report developer, you are required to represent information of first single manager with the following key requirements:

*   Report must be in .eml or .msg format.
*   It must add email recipient, css and subject of the email.
*   Report must show image of the manager
*   It must show Name and age of manager

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

{{< alert style="warning" >}}Inserting Images Dynamically is not Supported yet{{< /alert >}}

```java
Name:	<<[manager.getName()]>>
Age:	<<[manager.getAge()]>>
```

### Download Single Row Image Template

Please download the sample template we created in this article:

*   [Single Row Image.eml](https://raw.githubusercontent.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Bulleted%20List.eml?raw=true)

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/){{< /alert >}}{{< gist samicheemagroupdocs e39e429b95be8b91f06b1a7716d748e1 >}}



---

## Single Row Image in Email Document

Path: /assembly/net/single-row-image-in-email-document/

{{< alert style="info" >}}In this article, we will use GroupDocs.Assembly to generate a Single Row Image report in Email Document format.{{< /alert >}}

## Single Row Image in Email Document

{{< alert style="info" >}}This feature is supported by version 17.8.0 or greater{{< /alert >}}

### Reporting Requirement

As a report developer, you are required to represent information of first single manager with the following key requirements:

*   Report must be in .eml or .msg format
*   It must add email recipient, css and subject of the email
*   Report must show image of the manager
*   It must show Name and contact number of customer

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

```csharp
Name:	<<[customer.CustomerName]>>
Contact Number:	<<[customer.CustomerContactNumber]>>
```

### Download Single Row Image Template

Please download the sample template we created in this article:

*   [Single Row Image.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/raw/master/Examples/Data/Source/Email%20Templates/Single%20Row.msg?raw=true)

{{< alert style="success" >}}For detailed technical information about syntax,expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/).{{< /alert >}}

### Generating The Report

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< gist rida-fatima-aspose d1b17449056fb2f542e302e6015014c8 >}}



---

## Spelling corrector

Path: /search/java/spelling-corrector/

The [SpellingCorrector](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SpellingCorrector) class is designed to correct spelling errors in search queries, as well as to store words with correct spelling. You can learn about spelling correction in search queries on the [Spell checking]({{< ref "search/java/developer-guide/advanced-usage/searching/spell-checking.md" >}}) page.

To get the number of words in the spelling corrector dictionary, use the [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SpellingCorrector#getCount()) method.

To get an array of words containing in the spelling corrector dictionary, the [getWords](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SpellingCorrector#getWords()) method is used.

To add words to the spelling corrector dictionary, use the [addRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SpellingCorrector#addRange(java.lang.Iterable)) method.

The [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SpellingCorrector#clear()) method is used to remove all words from the spelling corrector dictionary.

To export words to a file, use the [exportDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import words from a file, use the [importDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the spelling corrector.



```java
String indexFolder = "c:\\MyIndex\\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.getDictionaries().getSpellingCorrector().getCount() > 0) {
    // Removing all words from the dictionary
    index.getDictionaries().getSpellingCorrector().clear();
}
 
// Adding words to the dictionary
String[] words = new String[] { "achieve", "accomplish", "attain", "reach" };
index.getDictionaries().getSpellingCorrector().addRange(words);
 
// Export words to a file
index.getDictionaries().getSpellingCorrector().exportDictionary("C:\\Words.txt");
 
// Import words from a file
index.getDictionaries().getSpellingCorrector().importDictionary("C:\\Words.txt");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Spelling corrector

Path: /search/net/spelling-corrector/

The [SpellingCorrector](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/spellingcorrector) class is designed to correct spelling errors in search queries, as well as to store words with correct spelling. You can learn about spelling correction in search queries on the [Spell checking]({{< ref "search/net/developer-guide/advanced-usage/searching/spell-checking.md" >}}) page.

To get the number of words in the spelling corrector dictionary, use the [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/spellingcorrector/properties/count) property.

To get an array of words containing in the spelling corrector dictionary, the [GetWords](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/spellingcorrector/methods/getwords) method is used.

To add words to the spelling corrector dictionary, use the [AddRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/spellingcorrector/methods/addrange/index) method.

The [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/spellingcorrector/methods/clear) method is used to remove all words from the spelling corrector dictionary.

To export words to a file, use the [ExportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/exportdictionary) method.

To import words from a file, use the [ImportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/importdictionary) method.

The following example demonstrates the use of methods of the spelling corrector.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.Dictionaries.SpellingCorrector.Count > 0)
{
    // Removing all words from the dictionary
    index.Dictionaries.SpellingCorrector.Clear();
}
 
// Adding words to the dictionary
string[] words = new string[] { "achieve", "accomplish", "attain", "reach" };
index.Dictionaries.SpellingCorrector.AddRange(words);
 
// Export words to a file
index.Dictionaries.SpellingCorrector.ExportDictionary(@"C:\Words.txt");
 
// Import words from a file
index.Dictionaries.SpellingCorrector.ImportDictionary(@"C:\Words.txt");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Spelling corrector

Path: /search/nodejs-java/spelling-corrector/

The [SpellingCorrector](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SpellingCorrector) class is designed to correct spelling errors in search queries, as well as to store words with correct spelling. You can learn about spelling correction in search queries on the [Spell checking]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/spell-checking.md" >}}) page.

To get the number of words in the spelling corrector dictionary, use the [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SpellingCorrector#getCount()) method.

To get an array of words containing in the spelling corrector dictionary, the [getWords](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SpellingCorrector#getWords()) method is used.

To add words to the spelling corrector dictionary, use the [addRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SpellingCorrector#addRange(java.lang.Iterable)) method.

The [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SpellingCorrector#clear()) method is used to remove all words from the spelling corrector dictionary.

To export words to a file, use the [exportDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import words from a file, use the [importDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the spelling corrector.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index from in specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

if (index.getDictionaries().getSpellingCorrector().getCount() > 0) {
  // Removing all words from the dictionary
  index.getDictionaries().getSpellingCorrector().clear();
}

// Adding words to the dictionary
const words = java.newArray('java.lang.String', ['achieve', 'accomplish', 'attain', 'expression', 'reach']);
index.getDictionaries().getSpellingCorrector().addRange(words);

// Export words to a file
const fileName = Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/spellingCorrector/Words.txt';
index.getDictionaries().getSpellingCorrector().exportDictionary(fileName);

// Import words from a file
index.getDictionaries().getSpellingCorrector().importDictionary(fileName);

// Search in the index
const query = 'experssino';
const options = new groupdocs.search.SearchOptions();
options.getSpellingCorrector().setEnabled(true);
options.getSpellingCorrector().setMaxMistakeCount(2);
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Spreadsheet conversion options

Path: /markdown/net/spreadsheet-options/


When converting spreadsheets, use these properties on `ConvertOptions` to control the Markdown table output.

### Column and row truncation

{{< tabs "spreadsheet-truncation">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    MaxColumns = 8,     // Only first 8 columns
    MaxRows = 50,       // Only first 50 data rows per sheet
};

MarkdownConverter.ToFile("cost-analysis.xlsx", "spreadsheet-truncation.md", options);

// Truncated columns/rows show "..." indicators.
// Warnings are reported in ConvertResult.Warnings.
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "spreadsheet-truncation.md" >}}  
```text
## Summary

| Category | FY2024 | FY2025 | FY2026 |
| --- | --- | --- | --- |
| Parts and materials | $1,325,000.00 | $1,480,000.00 | $1,620,000.00 |
| Manufacturing equipment | $900,500.00 | $980,000.00 | $1,050,000.00 |
| Warehousing | $420,000.00 | $510,000.00 | $590,000.00 |
| Shipping | $380,000.00 | $445,000.00 | $520,000.00 |
| Marketing | $250,000.00 | $340,000.00 | $480,000.00 |
| R&D | $180,000.00 | $230,000.00 | $310,000.00 |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/spreadsheet-options/SpreadsheetTruncation/spreadsheet-truncation.md)
{{< /tab >}}
{{< /tabs >}}

### Sheet separator and hidden sheets

{{< tabs "spreadsheet-sheets">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    SheetSeparator = "\n---\n",    // Separator between worksheets
    IncludeHiddenSheets = false    // Skip hidden worksheets (default)
};

using var converter = new MarkdownConverter("cost-analysis.xlsx");
ConvertResult result = converter.Convert("spreadsheet-sheets.md", options);

foreach (string warning in result.Warnings)
    Console.WriteLine($"Warning: {warning}");
// e.g. "Worksheet 'Data' truncated at 50 rows."
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "spreadsheet-sheets.md" >}}  
```text
## Summary

| Category | FY2024 | FY2025 | FY2026 |
| --- | --- | --- | --- |
| Parts and materials | $1,325,000.00 | $1,480,000.00 | $1,620,000.00 |
| Manufacturing equipment | $900,500.00 | $980,000.00 | $1,050,000.00 |
| Warehousing | $420,000.00 | $510,000.00 | $590,000.00 |
| Shipping | $380,000.00 | $445,000.00 | $520,000.00 |
| Marketing | $250,000.00 | $340,000.00 | $480,000.00 |
| R&D | $180,000.00 | $230,000.00 | $310,000.00 |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/spreadsheet-options/SpreadsheetSheets/spreadsheet-sheets.md)
{{< /tab >}}
{{< /tabs >}}

### Available options

| Property | Type | Default | Description |
|---|---|---|---|
| `MaxColumns` | `int` | `0` (unlimited) | Maximum columns per table |
| `MaxRows` | `int` | `0` (unlimited) | Maximum data rows per worksheet |
| `SheetSeparator` | `string` | `"\n---\n"` | Separator inserted between worksheets |
| `IncludeHiddenSheets` | `bool` | `false` | Whether to include hidden worksheets |

---

## Spreadsheet conversion options

Path: /markdown/python-net/spreadsheet-options/


When converting spreadsheets, use these properties on `ConvertOptions` to control the Markdown table output.

### Column and row truncation

{{< tabs "spreadsheet-truncation">}}
{{< tab "spreadsheet_truncation.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def spreadsheet_truncation():
    """Convert a spreadsheet with column and row truncation limits."""

    # Step 1: Configure column and row limits
    options = ConvertOptions()
    options.max_columns = 8     # only include the first 8 columns
    options.max_rows = 50       # only include the first 50 data rows per sheet

    # Step 2: Convert with truncation options using keyword argument
    md = MarkdownConverter.to_markdown("cost-analysis.xlsx", convert_options=options)

    # Truncated columns/rows show "..." indicators.
    # Warnings are reported in ConvertResult.warnings.

if __name__ == "__main__":
    spreadsheet_truncation()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Sheet separator and hidden sheets

{{< tabs "spreadsheet-sheets">}}
{{< tab "spreadsheet_sheets.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def spreadsheet_sheets():
    """Convert a workbook with custom sheet separators and hidden sheet filtering."""

    # Step 1: Configure sheet separator and hidden sheet behavior
    options = ConvertOptions()
    options.sheet_separator = "\n---\n"      # horizontal rule between worksheets
    options.include_hidden_sheets = False    # skip hidden worksheets (default)

    # Step 2: Open the workbook with a context manager
    with MarkdownConverter("cost-analysis.xlsx") as converter:
        # Step 3: Convert using keyword argument for options
        result = converter.convert(convert_options=options)

        # Step 4: Check for conversion warnings (e.g., truncation)
        for warning in result.warnings:
            print(f"Warning: {warning}")
        # e.g. "Worksheet 'Data' truncated at 50 rows."

if __name__ == "__main__":
    spreadsheet_sheets()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Available options

| Property | Type | Default | Description |
|---|---|---|---|
| `max_columns` | `int` | `0` (unlimited) | Maximum columns per table |
| `max_rows` | `int` | `0` (unlimited) | Maximum data rows per worksheet |
| `sheet_separator` | `str` | `"\n---\n"` | Separator inserted between worksheets |
| `include_hidden_sheets` | `bool` | `False` | Whether to include hidden worksheets |

---

## Subscribing for verification process events

Path: /signature/java/subscribing-for-verification-process-events/

[Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class contains several events that are being called for different verification process stages

*   [VerifyStarted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#VerifyStarted) to handle process start event. This event is occur once [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method is called
*   [VerifyProgress](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#VerifyProgress) to handle progress event. This event occurs each time on verifying each signature was completed.
*   [VerifyCompleted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#VerifyCompleted) to handle completion event. This event occurs once [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) process was completed.    

Here are the steps to subscribe for verification process with GroupDocs.Signature:
*   Define required handler delegates to process signing events.    
*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Subscribe for required events      
*   Instantiate required [VerifyOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.verify/VerifyOptions) object  
*   Call [verify](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#verify(com.groupdocs.signature.options.verify.VerifyOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass verify options in it .
    

## Implement method for VerifyStarted event

GroupDocs.Signature expects [ProcessStartEventHandler](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.handler.events/ProcessStartEventHandler) delegate to subscribe for [VerifyStarted](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#VerifyStarted) event

```java
private static void onVerifyStarted(Signature sender, ProcessStartEventArgs args)
{
    System.out.print("Verify process started at "+args.getStarted()+" with "+args.getTotalSignatures()+" total signatures to be put in document");
}
```

## Implement method for VerifyProgress event

```java
 private static void onVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    System.out.print("Verify progress. Processed "+args.getProcessedSignatures()+" signatures. Time spent "+args.getTicks()+" mlsec");
}
```

## Implement method for VerifyCompleted event

```java
private static void onVerifyCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    System.out.print("Verify process completed at "+args.getCompleted()+" with "+args.getTotalSignatures()+" total signatures. Process took "+args.getTicks()+" mlsec");
}
```

## Subscribing for verification process events

```java
private static void onVerifyStarted(Signature sender, ProcessStartEventArgs args)
{
    System.out.print("Verify process started at "+args.getStarted()+" with "+args.getTotalSignatures()+" total signatures to be put in document");
}
 
private static void onVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    System.out.print("Verify progress. Processed "+args.getProcessedSignatures()+" signatures. Time spent "+args.getTicks()+" mlsec");
}
 
private static void onVerifyCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    System.out.print("Verify process completed at "+args.getCompleted()+" with "+args.getTotalSignatures()+" total signatures. Process took "+args.getTicks()+" mlsec");
}
 
 
public static void run()
{   
 
    try {
        Signature signature = new Signature("sample.pdf");
        signature.VerifyStarted.add(new ProcessStartEventHandler() {
            public void invoke(Signature sender, ProcessStartEventArgs args) {
                onVerifyStarted(sender, args);
            }
        });
 
 
        signature.VerifyProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                onVerifyProgress(sender, args);
            }
 
 
        });
        signature.VerifyCompleted.add(new ProcessCompleteEventHandler() {
            public void invoke(Signature sender, ProcessCompleteEventArgs args) {
                onVerifyCompleted(sender, args);
            }
        });
 
        TextVerifyOptions options = new TextVerifyOptions("John Smith");
        options.setAllPages(true);
 
        // verify document
        VerificationResult result = signature.verify(options);
        if (result.isValid())
        {
            System.out.print("\nDocument was verified successfully!");
    }
        else
        {
            System.out.print("\nDocument failed verification process.");
        }
 
    } catch (Exception e) {
        throw new GroupDocsSignatureException(e.getMessage());
    }
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Subscribing for verification process events

Path: /signature/net/subscribing-for-verification-process-events/

[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class contains several events that are being called for different verification process stages

* [VerifyStarted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verifystarted) to handle process start event. This event is occur once [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method is called
* [VerifyProgress](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verifyprogress) to handle progress event. This event occurs each time on verifying each signature was completed.
* [VerifyCompleted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verifycompleted) to handle completion event. This event occurs once [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) process was completed.

Here are the steps to subscribe for verification process with GroupDocs.Signature:

* Define required handler delegates to process signing events.
* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Subscribe for required events
* Instantiate required [VerifyOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/verifyoptions) object
* Call [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass verify options in it

## Implement method for VerifyStarted event

GroupDocs.Signature expects [ProcessStartEventHandler](https://reference.groupdocs.com/signature/net/groupdocs.signature/processprogresseventhandler) delegate to subscribe for [VerifyStarted](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verifystarted) event

```csharp
private static void OnVerifyStarted(Signature signature, ProcessStartEventArgs args)
{
    Console.WriteLine("Verify process started at {0} with {1} total signatures to be put in document", args.Started, args.TotalSignatures);
}
```

## Implement method for VerifyProgress event

```csharp
 private static void OnVerifyProgress(Signature signature, ProcessProgressEventArgs args)
 {
     Console.WriteLine("Verify progress. Processed {0} signatures. Time spent {1} mlsec", args.ProcessedSignatures, args.Ticks);
 }
```

## Implement method for VerifyCompleted event

```csharp
private static void OnVerifyCompleted(Signature signature, ProcessCompleteEventArgs args)
{
    Console.WriteLine("Verify process completed at {0} with {1} total signatures. Process took {2} mlsec", args.Completed, args.TotalSignatures, args.Ticks);
}
```

## Subscribing for verification process events

```csharp
private static void OnVerifyStarted(Signature sender, ProcessStartEventArgs args)
{
    Console.WriteLine("Verify process started at {0} with {1} total signatures to be put in document", args.Started, args.TotalSignatures);
}
/// <summary>
/// Defines on progress event
/// </summary>
/// <param name="sender"></param>
/// <param name="args"></param>
private static void OnVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    Console.WriteLine("Verify progress. Processed {0} signatures. Time spent {1} mlsec", args.ProcessedSignatures, args.Ticks);
}
/// <summary>
/// Defines on completed event
/// </summary>
/// <param name="sender"></param>
/// <param name="args"></param>
private static void OnVerifyCompleted(Signature sender, ProcessCompleteEventArgs args)
{
    Console.WriteLine("Verify process completed at {0} with {1} total signatures. Process took {2} mlsec", args.Completed, args.TotalSignatures, args.Ticks);
}
/// <summary>
/// Verify document with text signature applying specific options and subscribe for events
/// </summary>
public static void Run()
{
    // The path to the documents directory.
    string filePath = Constants.SAMPLE_PDF;
    using (Signature signature = new Signature(filePath))
    {
        signature.VerifyStarted += OnVerifyStarted;
        signature.VerifyProgress += OnVerifyProgress;
        signature.VerifyCompleted += OnVerifyCompleted;
        TextVerifyOptions options = new TextVerifyOptions("John Smith")
        {
           AllPages = true
        };
        // verify document
        VerificationResult result = signature.Verify(options);
        if (result.IsValid)
        {
            Console.WriteLine("\nDocument was verified successfully!");
        }
        else
        {
            Console.WriteLine("\nDocument failed verification process.");
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Supported Image Types

Path: /merger/net/supported-image-formats/

The following table indicates the file formats that GroupDocs.Merger can work with.

| Format | Description | Join | Split | Extract pages | Rotate | Cross-format image merging | Cross-format merge to PDF |
| --- | --- | --- | --- | --- | --- | --- | --- |
| [JPG](https://docs.fileformat.com/image/jpeg/) | JPG Image File | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [JPEG](https://docs.fileformat.com/image/jpeg/) | JPEG Image File | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [BMP](https://docs.fileformat.com/image/bmp/) | Bitmap Image File | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [PNG](https://docs.fileformat.com/image/png/) | Portable Network Graphics | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [GIF](https://docs.fileformat.com/image/gif/) | Graphical Interchange Format | ![(tick)](/merger/net/images/check.png) |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [TIF](https://docs.fileformat.com/image/tiff/) | Tagged Image Format | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [TIFF](https://docs.fileformat.com/image/tiff/) | Tagged Image File Format | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |   | ![(tick)](/merger/net/images/check.png) |
| [SVG](https://docs.fileformat.com/image/svg/) | Scalar Vector Graphics | ![(tick)](/merger/net/images/check.png) |   |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [SVGZ](https://docs.fileformat.com/image/svgz/) | Compressed Scalar Vector Graphics | ![(tick)](/merger/net/images/check.png) |   |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EMF](https://docs.fileformat.com/image/emf/) | Windows Enhanced Metafile | ![(tick)](/merger/net/images/check.png) |   |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |
| [EMZ](https://docs.fileformat.com/image/emz/) | Windows Compressed Enhanced Metafile | ![(tick)](/merger/net/images/check.png) |   |   |   | ![(tick)](/merger/net/images/check.png) | ![(tick)](/merger/net/images/check.png) |

---

## Swap pages

Path: /merger/net/swap-pages/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to swap two pages positions within the source document. The result is a new document where two pages have their positions exchanged.

Here are the steps to swap document pages:
*   Initialize [SwapOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/swapoptions) class with page numbers to swap;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [SwapPages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/swappages) method and pass [SwapOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/swapoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to split document:

```csharp
string filePath = @"c:\sample.pptx";
string filePathOut = @"c:\output\result.pptx";

int pageNumber1 = 3;
int pageNumber2 = 6;
SwapOptions swapOptions = new SwapOptions(pageNumber2, pageNumber1);

using (Merger merger = new Merger(filePath))
{
    merger.SwapPages(swapOptions);
    merger.Save(filePathOut);
}
```

---

## System requirements

Path: /redaction/python-net/system-requirements/

{{< alert style="info" >}}

GroupDocs.Redaction for Python via .NET operates independently of external software like Microsoft Word, Excel, or PowerPoint. To install GroupDocs.Redaction for Python, simply follow one of the methods described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Requirements

* [Python 3.9](https://www.python.org/downloads/) or above
* [.NET 6.0](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) Runtime or above

## Supported Operating Systems

GroupDocs.Redaction for Python via .NET is compatible with both 32-bit and 64-bit operating systems. It relies on the .NET Core Runtime; however, installing the .NET Core Runtime separately is not required.

### Windows

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

### Linux
* Ubuntu
* OpenSUSE
* CentOS
* and others


## Development Environments

GroupDocs.Redaction for Python requires Python and .NET. You can use any preferred text editor for development, such as Atom, Sublime Text, Visual Studio Code, and more.

  
---

## System requirements

Path: /watermark/python-net/system-requirements/

{{< alert style="info" >}}

GroupDocs.Watermark for Python via .NET does not require any external software to be installed such as Microsoft Word, Microsoft Excel or Microsoft PowerPoint. To install GroupDocs.Watermark for Python just follow one of the ways as described in the [Installation]({{< ref "installation" >}}) section.

{{< /alert >}}

## Requirements

* [Python 3.9](https://www.python.org/downloads/) or above
* [.NET 6.0](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) Runtime or above

## Supported Operating Systems

GroupDocs.Watermark for Python can be used on any 32-bit or 64-bit operating system. Dependencies of .NET Core Runtime. Installing .NET Core Runtime itself is NOT required.

### Windows

* Microsoft Windows Server 2003 and later
* Microsoft Windows XP (x64, x86)
* Microsoft Windows Vista (x64, x86)
* Microsoft Windows 7, 8, 8.1 (x64, x86)
* Microsoft Windows 10 (x64, x86)
* Microsoft Windows 11 (x64)

### Linux
* Ubuntu
* OpenSUSE
* CentOS
* and others


## Development Environments

GroupDocs.Watermark for Python requirements Python and .NET. You  can use any text editor like Atom, Sublime, Visual Studio Code, etc.

  
---

## System Requirements

Path: /viewer/python-net/system-requirements/


## General Requirements

- **Python:** Versions **3.5–3.13**  
  Download from the official website: https://www.python.org/downloads/

## Supported Operating Systems

### Linux and macOS

- Supported on **Intel** and **Apple Silicon (M-series)** processors
- Requires additional system libraries for image and font rendering (see below)

### Windows

- **Windows 11** (x64)
- **Windows 10** (x64, x86)
- **Windows 7, 8, 8.1, Vista, XP** (x64, x86)
- **Windows Server 2003 and later**

## Additional System Libraries

### Linux and macOS Requirements

GroupDocs.Viewer for Python via .NET relies on **`libgdiplus`** to process images and documents that contain images.

---

## Linux Installation

On Linux, install the following packages to ensure correct operation.

### System.Drawing.Common Dependencies

1. **libgdiplus** — Mono library providing a GDI+-compatible API on non-Windows systems  
2. **libc6-dev** — Development files for the GNU C Library

### Microsoft Fonts (Recommended for Accurate Text Rendering)

3. **wget** — File download utility  
4. **cabextract** — Microsoft Cabinet file extractor  
5. **xfonts-utils** — X11 font utilities  
6. **ttf-mscorefonts-installer** — Microsoft-compatible core fonts

### Globalization and Cryptography

7. **libicu67** — ICU library (**exact version required**)  
8. **libssl1.1** — OpenSSL library (**exact version required**)

> **Note:**  
> The packages **libicu67** and **libssl1.1** must match the exact versions listed above.  
> If they are unavailable in your distribution’s default repositories, use a Debian snapshot
> repository or install them from alternative sources.

### Installation (Debian-based Distributions)

Use `apt-get` to install all required dependencies:

~~~bash
# Enable contrib repository (required for Microsoft fonts)
sudo sed -i 's/deb \(.*\) main$/deb \1 main contrib/g' /etc/apt/sources.list 2>/dev/null || \
    sudo sed -i 's/Components: main/Components: main contrib/g' /etc/apt/sources.list.d/*.sources 2>/dev/null || true

# Update package list
sudo apt-get update

# Accept Microsoft fonts EULA (non-interactive)
echo "ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | sudo debconf-set-selections

# Install Microsoft fonts
sudo apt-get install -y --no-install-recommends \
    wget \
    cabextract \
    xfonts-utils \
    ttf-mscorefonts-installer

# Install System.Drawing.Common dependencies
sudo apt-get install -y --no-install-recommends \
    libgdiplus \
    libc6-dev

# Install globalization and cryptography dependencies
sudo apt-get install -y --no-install-recommends \
    libicu67 \
    libssl1.1
~~~

> **Tip:**  
> If `libicu67` or `libssl1.1` are missing, you may need a Debian snapshot repository:
>
> ~~~bash
> SNAPSHOT_DATE=20220328T000000Z
> echo "deb [trusted=yes] http://snapshot.debian.org/archive/debian/${SNAPSHOT_DATE} bullseye main" \
>     | sudo tee /etc/apt/sources.list.d/debian-archive.list
> sudo apt-get -o Acquire::Check-Valid-Until=false update
> ~~~

---

## macOS Installation

Install the required library using [Homebrew](https://brew.sh/):

~~~bash
brew install mono-libgdiplus
~~~

Ensure **`libgdiplus`** is installed if you experience issues when rendering images or image-based documents.

---

## Technical Support

Path: /conversion/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including those evaluating the product. You can access support at the [Free Support Forum](https://forum.groupdocs.com/) and the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not offer technical support by phone. Phone support is available only for sales and purchase inquiries.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need assistance with GroupDocs.Conversion, please consider the following:

1. Ensure you are using the latest version of GroupDocs.Conversion before reporting an issue. Check the [releases page](https://releases.groupdocs.com/conversion/python-net/) for the latest version.
2. Review the forums and this documentation to see if your question has already been answered.
3. Post your question in the [GroupDocs.Conversion Free Support Forum](https://forum.groupdocs.com/c/conversion). Our development team will assist you directly.
4. Please allow for time zone differences when waiting for a reply on the forums.

## Paid Support Helpdesk

Paid support requests are given higher priority than free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to receive higher priority assistance.

## Report an Issue or Feature Request

To ensure your issue, question, or feature request is resolved efficiently, please follow these steps:

1. Attach the original document and any relevant code snippet that reproduces the issue. If you need to attach multiple files, compress them into a single archive. It’s safe to attach documents on the GroupDocs Forum, as only you and GroupDocs developers will have access.
2. Include details about the environment where the issue occurs.
3. Report one issue per thread. If you have additional questions, issues, or feature requests, please create separate threads for each.


---

## Traverse a whole metadata tree

Path: /metadata/java/traverse-a-whole-metadata-tree/

In some cases, it's required to get access to all properties extracted from a document, video, image, etc. GroupDocs.Metadata represents any loaded file as a tree consisting of metadata properties and nested metadata packages. You can easily iterate through the metadata tree using the code snippet below:

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to examine
2.  Obtain the [RootMetadataPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/RootMetadataPackage) instance which is the root of the whole metadata tree extracted from the file
3.  Use any algorithm of your choice to traverse the tree.

**advanced\_usage.TraverseWholeMetadataTree**

```csharp
public static void run() {
	try (Metadata metadata = new Metadata(Constants.JpegWithXmp)) {
		displayMetadataTree(metadata.getRootPackage(), 0);
	}
}
private static void displayMetadataTree(MetadataPackage metadata, int indent) {
	if (metadata != null) {
		String stringMetadataType = String.valueOf(metadata.getMetadataType());
		System.out.printf("%" + (stringMetadataType.length() + indent) + "s%n", stringMetadataType);
		for (MetadataProperty property : metadata) {
			String stringPropertyRepresentation = "Name: " + property.getName() + ", Value: " + property.getValue();
			System.out.printf("%" + (stringPropertyRepresentation.length() + indent + 1) + "s%n", stringPropertyRepresentation);
			if (property.getValue() != null) {
				switch (property.getValue().getType()) {
					case MetadataPropertyType.Metadata:
						displayMetadataTree(property.getValue().toClass(MetadataPackage.class), indent + 2);
						break;
					case MetadataPropertyType.MetadataArray:
						displayMetadataTree(property.getValue().toArray(MetadataPackage.class), indent + 2);
						break;
				}
			}
		}
	}
}
private static void displayMetadataTree(MetadataPackage[] metadataArray, int indent) {
	if (metadataArray != null) {
		for (MetadataPackage metadata : metadataArray) {
			displayMetadataTree(metadata, indent);
		}
	}
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Traverse a whole metadata tree

Path: /metadata/net/traverse-a-whole-metadata-tree/

In some cases, it's required to get access to all properties extracted from a document, video, image, etc. GroupDocs.Metadata represents any loaded file as a tree consisting of metadata properties and nested metadata packages. You can easily iterate through the metadata tree using the code snippet below:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to examine
2.  Obtain the [RootMetadataPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/rootmetadatapackage) instance which is the root of the whole metadata tree extracted from the file
3.  Use any algorithm of your choice to traverse the tree.

**AdvancedUsage.TraverseWholeMetadataTree**

```csharp
public static void Run()
{
	using (Metadata metadata = new Metadata(Constants.JpegWithXmp))
	{
		DisplayMetadataTree(metadata.GetRootPackage(), 0);
	}
}

private static void DisplayMetadataTree(MetadataPackage package, int indent)
{
	if (package != null)
	{
		var stringMetadataType = package.MetadataType.ToString();
		Console.WriteLine(stringMetadataType.PadLeft(stringMetadataType.Length + indent));
		foreach (MetadataProperty property in package)
		{
			string stringPropertyRepresentation = string.Format("Name: {0}, Value: {1}", property.Name, property.Value);
			Console.WriteLine(stringPropertyRepresentation.PadLeft(stringPropertyRepresentation.Length + indent + 1));
			if (property.Value != null)
			{
				switch (property.Value.Type)
				{
					case MetadataPropertyType.Metadata:
						DisplayMetadataTree(property.Value.ToClass<MetadataPackage>(), indent + 2);
						break;
					case MetadataPropertyType.MetadataArray:
						DisplayMetadataTree(property.Value.ToArray<MetadataPackage>(), indent + 2);
						break;
				}
			}
		}
	}
}

private static void DisplayMetadataTree(MetadataPackage[] packages, int indent)
{
	if (packages != null)
	{
		foreach (var package in packages)
		{
			DisplayMetadataTree(package, indent);
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Update annotations

Path: /annotation/java/update-annotations/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/java) allows you to update annotations.  

To update annotations, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Create an [AnnotationBase](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/annotationbase) implementation and specify Id of existed annotation (if annotation with that Id is not found, it is ignored) or path list of annotations (all existed annotations are removed).
3.   Call the [update](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#update-java.util.List-com.groupdocs.annotation.models.annotationmodels.AnnotationBase--) method of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify annotations.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code demonstrates how to update annotations:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates how to update annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("Original first comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Original second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of AreaAnnotation class and set options
    AreaAnnotation original = new AreaAnnotation();
    original.setId(1);
    original.setBackgroundColor(65535);
    original.setBox(new Rectangle(100, 100, 100, 100));
    original.setCreatedOn(Calendar.getInstance().getTime());
    original.setMessage("This is original annotation");
    original.setReplies(replies);
    
    // Add original annotation
    annotator.add(original);
    
    // Save to file
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
LoadOptions tmp0 = new LoadOptions();

// Open annotated document
Annotator annotator1 = new Annotator("outputPath", tmp0);
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("Updated first comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Updated second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Suggest we want change some properties of existed annotation
    AreaAnnotation updated = new AreaAnnotation();
    updated.setId(1);
    updated.setBackgroundColor(255);
    updated.setBox(new Rectangle(0, 0, 50, 200));
    updated.setCreatedOn(Calendar.getInstance().getTime());
    updated.setMessage("This is updated annotation");
    updated.setReplies(replies);
    
    // update annotation
    annotator1.update(updated);
    
    // Save to file
    annotator1.save(outputPath);
} finally {
    if (annotator1 != null) {
        annotator1.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

You can also update annotation using Id or pass the list of annotations. In that case all previous annotations will be replaced by new list.

To do this, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Create an [AnnotationBase](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/annotationbase) implementation and set Id of existed annotation (if annotation with that Id is not found, it is ignored) or path list of annotations (all existed annotations will be removed).
3.   Call the [update()]https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#update-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method of the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify annotations.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code demonstrates how to update annotations using Id:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
using (Annotator annotator = new Annotator("input.pdf"))
            {
                AreaAnnotation original = new AreaAnnotation
                {
                    Id = 1,
                    BackgroundColor = 65535,
                    Box = new Rectangle(100, 100, 100, 100),
                    CreatedOn = DateTime.Now,
                    Message = "This is original annotation",
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "Original first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Original second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                // add original annotation
                annotator.Add(original);
                annotator.Save("result.pdf");
            }
 
            // open annotated document
            using (Annotator annotator = new Annotator("result.pdf"))
            {
                //assuming we are going to change some properties of existing annotation
                AreaAnnotation updated = new AreaAnnotation
                {
                    // It's important to set existed annotation Id
                    Id = 1,
                    BackgroundColor = 255,
                    Box = new Rectangle(0, 0, 50, 200),
                    CreatedOn = DateTime.Now,
                    Message = "This is updated annotation",
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "Updated first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Updated second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                // update annotation
                annotator.Update(updated);
                annotator.Save("result.pdf");
            }
```
{{< /tab >}}
{{< /tabs >}}
---

## Update annotations

Path: /annotation/net/update-annotations/

[GroupDocs.Annotation](https://products.groupdocs.com/annotation/net) allows you to update annotations by specifying their [Id properties](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/annotationbase/properties/id). Also you can update  annotations by providing a collection of updated annotation objects that replaces all existing document annotations.  

To update annotations, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Create an [AnnotationBase](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/annotationbase) implementation and set Id of existed annotation (if annotation with that Id is not found, it is ignored) or path list of annotations (all existed annotations are removed).
3.   Call the [Update](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/update/index) method of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify annotations.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code demonstrates how to update annotations:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
            {
                AreaAnnotation original = new AreaAnnotation
                {
                    Id = 1,
                    BackgroundColor = 65535,
                    Box = new Rectangle(100, 100, 100, 100),
                    CreatedOn = DateTime.Now,
                    Message = "This is original annotation",
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "Original first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Original second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                // add original annotation
                annotator.Add(original);
                annotator.Save("result.pdf");
            }

            // open annotated document
            using (Annotator annotator = new Annotator("result.pdf"))
            {
                //assuming we are going to change some properties of existing annotation
                AreaAnnotation updated = new AreaAnnotation
                {
                    // It's important to set existed annotation Id
                    Id = 1,
                    BackgroundColor = 255,
                    Box = new Rectangle(0, 0, 50, 200),
                    CreatedOn = DateTime.Now,
                    Message = "This is updated annotation",
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "Updated first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Updated second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                // update annotation
                annotator.Update(updated);
                annotator.Save("result.pdf");
            }
```
{{< /tab >}}
{{< /tabs >}}

You can also update annotation using Id. You can also pass the list of annotations. In that case all previous annotations will be replaced by new list.

To do this, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Create an [AnnotationBase](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/annotationbase) implementation and set Id of existed annotation (if annotation with that Id is not found, it is ignored) or path list of annotations (all existed annotations will be removed).
3.   Call the [Update](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/update/index) method of the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify annotations.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code demonstrates how to update annotations using Id:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
            {
                AreaAnnotation original = new AreaAnnotation
                {
                    Id = 1,
                    BackgroundColor = 65535,
                    Box = new Rectangle(100, 100, 100, 100),
                    CreatedOn = DateTime.Now,
                    Message = "This is original annotation",
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "Original first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Original second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                // add original annotation
                annotator.Add(original);
                annotator.Save("result.pdf");
            }
 
            // open annotated document
            using (Annotator annotator = new Annotator("result.pdf"))
            {
                //assuming we are going to change some properties of existing annotation
                AreaAnnotation updated = new AreaAnnotation
                {
                    // It's important to set existed annotation Id
                    Id = 1,
                    BackgroundColor = 255,
                    Box = new Rectangle(0, 0, 50, 200),
                    CreatedOn = DateTime.Now,
                    Message = "This is updated annotation",
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "Updated first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Updated second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                // update annotation
                annotator.Update(updated);
                annotator.Save("result.pdf");
            }
```
{{< /tab >}}
{{< /tabs >}}
---

## Working with metadata in ProjectManagement formats

Path: /metadata/java/working-with-metadata-in-projectmanagement-formats/

GroupDocs.Metadata for Java provides functionality that allows working with MPP files created by different versions of Microsoft Project. Please see the code samples below for more information.

## Reading built-In metadata properties

To access built-in metadata of a ProjectManagement document, please use the [getDocumentProperties](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage#getDocumentProperties()) method defined in the [DocumentRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/DocumentRootPackage) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.project\_management.<WBR>ProjectManagementReadBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputMpp)) {
	ProjectManagementRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getDocumentProperties().getAuthor());
	System.out.println(root.getDocumentProperties().getCreationDate());
	System.out.println(root.getDocumentProperties().getCompany());
	System.out.println(root.getDocumentProperties().getCategory());
	System.out.println(root.getDocumentProperties().getKeywords());
	System.out.println(root.getDocumentProperties().getRevision());
	System.out.println(root.getDocumentProperties().getSubject());

	// ...
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a ProjectManagement document please follow the code sample below.

**advanced_usage.managing_metadata_for_specific_formats.<WBR>document.project_management.<WBR>ProjectManagementReadCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputMpp)) {
    ProjectManagementRootPackage root = metadata.getRootPackageGeneric();
  
    IReadOnlyList<MetadataProperty> customProperties = root.getDocumentProperties().findProperties(new ContainsTagSpecification(Tags.getDocument().getBuiltIn()).not());
  
    for (MetadataProperty property : customProperties) {
        System.out.println(String.format("%s = %s", property.getName(), property.getValue()));
    }
}
```

## Updating built-in metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a ProjectManagement document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.project\_management.<WBR>ProjectManagementUpdateBuiltInProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputMpp)) {
	ProjectManagementRootPackage root = metadata.getRootPackageGeneric();

	root.getDocumentProperties().setAuthor("test author");
	root.getDocumentProperties().setCreationDate(new Date());
	root.getDocumentProperties().setCompany("GroupDocs");
	root.getDocumentProperties().setComments("test comment");
	root.getDocumentProperties().setKeywords("metadata, built-in, update");

	// ...

	metadata.save(Constants.OutputMpp);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a ProjectManagement document. Please check the code sample below.
**advanced_usage.managing_metadata_for_specific_formats.<WBR>document.project_management.<WBR>ProjectManagementUpdateCustomProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputMpp)) {
  
    ProjectManagementRootPackage root = metadata.getRootPackageGeneric();
  
    root.getDocumentProperties().set("customProperty1", "some value");
    root.getDocumentProperties().set("customProperty2", 7);
    root.getDocumentProperties().set("customProperty3", true);
  
    metadata.save(Constants.OutputMpp);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in ProjectManagement formats

Path: /metadata/net/working-with-metadata-in-projectmanagement-formats/

GroupDocs.Metadata for .NET provides functionality that allows working with MPP files created by different versions of Microsoft Project. Please see the code samples below for more information.

## Reading built-In metadata properties

To access built-in metadata of a ProjectManagement document, please use the [DocumentProperties](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1/properties/documentproperties) property defined in the [DocumentRootPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document.documentrootpackage/1) class.

The following code snippet extracts built-in metadata properties and displays them on the screen.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.ProjectManagement.<WBR>ProjectManagementReadBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputMpp))
{
	var root = metadata.GetRootPackage<ProjectManagementRootPackage>();

	Console.WriteLine(root.DocumentProperties.Author);
	Console.WriteLine(root.DocumentProperties.CreationDate);
	Console.WriteLine(root.DocumentProperties.Company);
	Console.WriteLine(root.DocumentProperties.Category);
	Console.WriteLine(root.DocumentProperties.Keywords);
	Console.WriteLine(root.DocumentProperties.Revision);
	Console.WriteLine(root.DocumentProperties.Subject);

	// ... 
}
```

## Reading custom metadata properties

If you need to extract custom metadata properties of a ProjectManagement document please follow the code sample below.
**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.ProjectManagement.<WBR>ProjectManagementReadCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputMpp))
{
    var root = metadata.GetRootPackage<ProjectManagementRootPackage>();
    var customProperties = root.DocumentProperties.FindProperties(p => !p.Tags.Contains(Tags.Document.BuiltIn));
    foreach (var property in customProperties)
    {
        Console.WriteLine("{0} = {1}", property.Name, property.Value);
    }
}
```

## Updating built-in metadata properties

Updating any built-in document properties is as simple as getting them. The following code sample demonstrates how to update built-in metadata properties in a ProjectManagement document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.ProjectManagement.<WBR>ProjectManagementUpdateBuiltInProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputMpp))
{
	var root = metadata.GetRootPackage<ProjectManagementRootPackage>();

	root.DocumentProperties.Author = "test author";
	root.DocumentProperties.CreationDate = DateTime.Now;
	root.DocumentProperties.Company = "GroupDocs";
	root.DocumentProperties.Comments = "test comment";
	root.DocumentProperties.Keywords = "metadata, built-in, update";

	// ... 

	metadata.Save(Constants.OutputMpp);
}
```

## Adding or updating custom metadata properties

The GroupDocs.Metadata API also allows adding and updating custom metadata properties in a ProjectManagement document. Please check the code sample below.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.ProjectManagement.<WBR>ProjectManagementUpdateCustomProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputMpp))
{
    var root = metadata.GetRootPackage<ProjectManagementRootPackage>();
 
    root.DocumentProperties.Set("customProperty1", "some value");
    root.DocumentProperties.Set("customProperty2", 7);
    root.DocumentProperties.Set("customProperty3", true);
 
    // ...
 
    metadata.Save(Constants.OutputMpp);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with OpenType fonts

Path: /metadata/net/working-with-opentype-fonts/

OpenType is a format for scalable computer fonts. It was built on its predecessor TrueType, retaining TrueType's basic structure and adding many intricate data structures for prescribing typographic behavior.

{{< alert style="info" >}}Please find more information on the OpenType format here: https://en.wikipedia.org/wiki/OpenType.{{< /alert >}}

## Reading OpenType metadata

The GroupDocs.Metadata API supports extracting format-specific information from OpenType font files.

The following are the steps to read the header of an OpenType file.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an OpenType font file
2.  Get the root metadata package
3.  Extract  the native metadata package using [OpenTypeRootPackage.OpenTypePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.font/opentyperootpackage/properties/opentypepackage)
4.  Read the OpenType font properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Font.OpenTypeReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputTtf))
{
	var root = metadata.GetRootPackage<OpenTypeRootPackage>();
	// Read the OpenType font metadata
	foreach (var metadataEntry in root.OpenTypePackage.Fonts)
	{
		// Display the values of some metadata properties
		Console.WriteLine(metadataEntry.Created);
		Console.WriteLine(metadataEntry.DirectionHint);
		Console.WriteLine(metadataEntry.EmbeddingLicensingRights);
		Console.WriteLine(metadataEntry.Flags);
		Console.WriteLine(metadataEntry.FontFamilyName);
		Console.WriteLine(metadataEntry.FontRevision);
		Console.WriteLine(metadataEntry.FontSubfamilyName);
		Console.WriteLine(metadataEntry.FullFontName);
		Console.WriteLine(metadataEntry.GlyphBounds);
		Console.WriteLine(metadataEntry.MajorVersion);
		Console.WriteLine(metadataEntry.MinorVersion);
		Console.WriteLine(metadataEntry.Modified);
		Console.WriteLine(metadataEntry.SfntVersion);
		Console.WriteLine(metadataEntry.Style);
		Console.WriteLine(metadataEntry.TypographicFamily);
		Console.WriteLine(metadataEntry.TypographicSubfamily);
		Console.WriteLine(metadataEntry.Weight);
		Console.WriteLine(metadataEntry.Width);

		foreach (OpenTypeBaseNameRecord nameRecord in metadataEntry.Names)
		{
			Console.WriteLine(nameRecord.NameID);
			Console.WriteLine(nameRecord.Platform);
			Console.WriteLine(nameRecord.Value);

			OpenTypeMacintoshNameRecord macintoshNameRecord = nameRecord as OpenTypeMacintoshNameRecord;
			if (macintoshNameRecord != null)
			{
				Console.WriteLine(macintoshNameRecord.Encoding);
				Console.WriteLine(macintoshNameRecord.Language);
			}
			else
			{
				OpenTypeUnicodeNameRecord unicodeNameRecord = nameRecord as OpenTypeUnicodeNameRecord;
				if (unicodeNameRecord != null)
				{
					Console.WriteLine(unicodeNameRecord.Encoding);
				}
				else
				{
					OpenTypeWindowsNameRecord windowsNameRecord = nameRecord as OpenTypeWindowsNameRecord;
					if (windowsNameRecord != null)
					{
						Console.WriteLine(windowsNameRecord.Encoding);
						Console.WriteLine(windowsNameRecord.Language);
					}
				}
			}
		}
	}
}
```

## Reading digital signatures

The code snippet bellow demonstrates how to extract information about digital signatures associated with an OpenType font.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) an OpenType font file
2.  Get the root metadata package
3.  Use the [DigitalSignaturePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.font/opentyperootpackage/properties/digitalsignaturepackage) property to get access to all digital signatures associated with the file

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Font.OpenTypeReadDigitalSignatureProperties**

```csharp
public static void Run()
{
	using (Metadata metadata = new Metadata(Constants.InputTtf))
	{
		var root = metadata.GetRootPackage<OpenTypeRootPackage>();
		if (root.DigitalSignaturePackage != null)
		{
			Console.WriteLine(root.DigitalSignaturePackage.Flags);
			foreach (var signature in root.DigitalSignaturePackage.Signatures)
			{
				Console.WriteLine(signature.SignTime);
				if (signature.DigestAlgorithms != null)
				{
					foreach (var signatureDigestAlgorithm in signature.DigestAlgorithms)
					{
						PrintOid(signatureDigestAlgorithm);
					}
				}
				if (signature.EncapsulatedContent != null)
				{
					PrintOid(signature.EncapsulatedContent.ContentType);
					Console.WriteLine(signature.EncapsulatedContent.ContentRawData.Length);
				}
				if (signature.Certificates != null)
				{
					foreach (var certificate in signature.Certificates)
					{
						Console.WriteLine(certificate.NotAfter);
						Console.WriteLine(certificate.NotBefore);
						Console.WriteLine(certificate.RawData.Length);
					}
				}
				if (signature.Signers != null)
				{
					foreach (var signerInfoEntry in signature.Signers)
					{
						Console.WriteLine(signerInfoEntry.SignatureValue);
						PrintOid(signerInfoEntry.DigestAlgorithm);
						PrintOid(signerInfoEntry.SignatureAlgorithm);
						Console.WriteLine(signerInfoEntry.SigningTime);
						PrintAttributes(signerInfoEntry.SignedAttributes);
						PrintAttributes(signerInfoEntry.UnsignedAttributes);
					}
				}
			}
		}
	}
}

private static void PrintOid(Oid oid)
{
	// Display the property name and value of OID
	if (oid != null)
	{
		Console.WriteLine(oid.FriendlyName);
		Console.WriteLine(oid.Value);
	}
}

private static void PrintAttributes(CmsAttribute[] attributes)
{
	//Display the CmsAttributes of an OID
	if (attributes != null)
	{
		foreach (CmsAttribute attribute in attributes)
		{
			PrintOid(attribute.Oid);
			Console.WriteLine(attribute.Value);
		}
	}
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with saved Emails

Path: /metadata/java/working-with-saved-emails/

GroupDocs.Metadata for Java provides functionality that allows handling the most popular email message formats: EML and MSG. The following are some commonly used scenarios of working with the message content and metadata.

## Reading EML message metadata

The EML message format is used by many email clients including Novell GroupWise, Microsoft Outlook Express, Lotus notes, Windows Mail, Mozilla Thunderbird, and Postbox. The files contain the email contents as plain text in MIME format, containing the email header and body, including attachments in one or more of several formats. The code sample below demonstrates how to extract metadata from an EML message.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>email.EmlReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEml)) {
	EmlRootPackage root = metadata.getRootPackageGeneric();
	System.out.println(root.getEmailPackage().getSender());
	System.out.println(root.getEmailPackage().getSubject());

	for (String recipient : root.getEmailPackage().getRecipients()) {
		System.out.println(recipient);
	}

	for (String attachedFileName : root.getEmailPackage().getAttachedFileNames()) {
		System.out.println(attachedFileName);
	}

	for (MetadataProperty header : root.getEmailPackage().getHeaders()) {
		System.out.println(String.format("%s = %s", header.getName(), header.getValue()));
	}

	// ...
}
```

## Reading MSG metadata

MSG files are usually created by the Microsoft Outlook email client. The MSG format is used to represent individual email messages, appointments, contacts, tasks, and so on in the file system. The following code snippet shows how to read most common properties of an email message stored as an MSG file.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>email.MsgReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputMsg)) {
	MsgRootPackage root = metadata.getRootPackageGeneric();
	System.out.println(root.getMsgPackage().getSender());
	System.out.println(root.getMsgPackage().getSubject());

	for (String recipient : root.getMsgPackage().getRecipients()) {
		System.out.println(recipient);
	}

	for (String attachedFileName : root.getMsgPackage().getAttachedFileNames()) {
		System.out.println(attachedFileName);
	}

	for (MetadataProperty header : root.getMsgPackage().getHeaders()) {
		System.out.println(String.format("%s = %s", header.getName(), header.getValue()));
	}

	System.out.println(root.getMsgPackage().getBody());
	System.out.println(root.getMsgPackage().getDeliveryTime());

	// ...
}
```

## Removing email attachments

Both root package classes representing metadata in email messages ([EmlRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/EmlRootPackage) and [MsgRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MsgRootPackage)) have the common ancestor which is the [EmailRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/EmailRootPackage) class. Since the MSG and EML formats have really similar functionality, in most cases, you don't need to know the exact type of a loaded message. It is possible to refer to the [EmailRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/EmailRootPackage) class to access all basic features related to email messages. The following code sample shows how to remove all email message attachments using an instance of the [EmailRootPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/EmailRootPackage) class.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>email.EmailRemoveAttachments**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEml)) {
	EmailRootPackage root = metadata.getRootPackageGeneric();
	root.clearAttachments();
	metadata.save(Constants.OutputEml);
}
```

## Updating email fields

GroupDocs.Metadata for Java also allows the user to update some common email fields. The code sample below demonstrates how to alter the email subject and recipients.

**advanced_usage.managing_metadata_for_specific_formats.email.EmailUpdateEmailFields**

```csharp
try (Metadata metadata = new Metadata(Constants.InputEml)) {
    EmailRootPackage root = metadata.getRootPackageGeneric();
    root.getEmailPackage().setRecipients(new String[] { "sample@aspose.com" });
    root.getEmailPackage().setCarbonCopyRecipients(new String[] { "sample@groupdocs.com" });
    root.getEmailPackage().setSubject("RE: test subject");
    metadata.save(Constants.OutputEml);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Verify Digital signatures in image

Path: /signature/net/verify-digital-signatures-in-image/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) for .NET supports verifying digital signatures embedded in raster images using **steganography** (LSB - Least Significant Bit technique). These signatures are invisibly embedded in image pixels and can be verified using the password that was used during signing.

### Key Features

* **Password-Based Verification**: Verify signatures using the password from signing
* **Detection Thresholds**: Configurable detection threshold for verification (0-100%)
* **Full Data Extraction**: Optional full data extraction mode for maximum accuracy
* **Format Support**: Works with PNG and JPG image formats
* **Probability Detection**: Get probability scores when using full extraction mode

## How It Works

Digital signature verification in images:

1. **Extraction**: The embedded signature data is extracted from the least significant bits of image pixels
2. **Password Verification**: The extracted data is verified using the provided password
3. **Threshold Check**: The detection threshold determines if enough signature data was found
4. **Result**: Returns verification status and signature details

## Requirements

### Password Requirements

* **Must Match**: Password must match the one used during signing
* **Case Sensitive**: Yes, passwords are case-sensitive
* **Minimum Length**: 4 characters (same as signing)

### Supported Formats

* ✅ **PNG** - Fully supported
* ✅ **JPG/JPEG** - Fully supported
* ❌ **BMP** - Not supported for digital steganography signatures

## Basic Usage

### Verifying a Signed Image

```csharp
using GroupDocs.Signature;
using GroupDocs.Signature.Options;

// Load the signed image
using (Signature signature = new Signature("signed_image.png"))
{
    // Create verify options with the same password used for signing
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MySecurePassword123"
    };

    // Verify the signature
    VerificationResult verifyResult = signature.Verify(verifyOptions);
    
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Digital signature is valid!");
        Console.WriteLine($"Found {verifyResult.Succeeded.Count} verified signatures.");
    }
    else
    {
        Console.WriteLine("Digital signature is invalid or not found.");
    }
}
```

### Complete Verification Example

```csharp
using GroupDocs.Signature;
using GroupDocs.Signature.Options;

string signedFile = "signed_document.png";
string password = "SecurePassword123";

// Verify the signed image
using (Signature signature = new Signature(signedFile))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = password
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Digital signature is valid!");
        Console.WriteLine($"Verified signatures: {verifyResult.Succeeded.Count}");

        foreach (var sig in verifyResult.Succeeded)
        {
            if (sig is DigitalSignature digitalSig)
            {
                Console.WriteLine($"  Signature ID: {digitalSig.SignatureId}");
                Console.WriteLine($"  Sign Time: {digitalSig.SignTime}");
                Console.WriteLine($"  Is Valid: {digitalSig.IsValid}");
            }
        }
    }
    else
    {
        Console.WriteLine("✗ Digital signature is invalid or not found.");

        if (verifyResult.Failed != null && verifyResult.Failed.Count > 0)
        {
            Console.WriteLine($"  Failed verifications: {verifyResult.Failed.Count}");
            foreach (var failure in verifyResult.Failed)
            {
                Console.WriteLine($"    - {failure}");
            }
        }
    }
}
```

## Advanced Usage

### Custom Detection Threshold

The detection threshold determines the minimum percentage of signature data that must be detected for verification to succeed (0-100%). Default is 75%.

```csharp
using (Signature signature = new Signature("signed_image.png"))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MySecurePassword123",
        DetectionThresholdPercent = 90  // Require 90% detection
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Signature verified with 90% threshold");
    }
    else
    {
        Console.WriteLine("Signature verification failed - threshold not met");
    }
}
```

### Testing Different Thresholds

```csharp
using (Signature signature = new Signature("signed_image.png"))
{
    string password = "MyPassword123";
    
    // Test different threshold values
    int[] thresholds = { 50, 75, 90, 95, 100 };
    
    foreach (int threshold in thresholds)
    {
        ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
        {
            Password = password,
            DetectionThresholdPercent = threshold
        };

        VerificationResult verifyResult = signature.Verify(verifyOptions);
        
        Console.WriteLine($"Threshold {threshold}%: {(verifyResult.IsValid ? "✓ Valid" : "✗ Invalid")}");
    }
}
```

### Full Data Extraction Mode

For maximum accuracy, you can enable full data extraction mode. This performs a more thorough analysis and provides a probability score.

```csharp
using (Signature signature = new Signature("signed_image.png"))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MySecurePassword123",
        UseFullDataExtraction = true,  // Enable full extraction
        DetectionThresholdPercent = 85
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Signature verified with full data extraction");
        
        // DetectedProbability is set when UseFullDataExtraction is true
        if (verifyOptions.DetectedProbability.HasValue)
        {
            Console.WriteLine($"Detection probability: {verifyOptions.DetectedProbability.Value}%");
        }
    }
}
```

### Working with Streams

You can verify images using streams instead of file paths:

```csharp
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Options;

// Verifying from stream
using (Stream imageStream = new FileStream("signed_image.png", FileMode.Open, FileAccess.Read))
using (Signature signature = new Signature(imageStream))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MySecurePassword123"
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Signature is valid!");
    }
}
```

## Detection Threshold

The `DetectionThresholdPercent` property controls how strict the verification is:

* **Lower Threshold (0-50%)**: More lenient, may detect partial signatures
* **Default (75%)**: Balanced detection
* **Higher Threshold (90-100%)**: Very strict, requires nearly complete signature data

### Choosing the Right Threshold

```csharp
// For lenient verification (may detect partial signatures)
ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
{
    Password = "MyPassword",
    DetectionThresholdPercent = 50  // Lower threshold
};

// For balanced verification (default)
verifyOptions.DetectionThresholdPercent = 75;  // Default

// For strict verification (requires complete signature)
verifyOptions.DetectionThresholdPercent = 95;  // High threshold
```

### Threshold Examples

```csharp
using (Signature signature = new Signature("signed_image.png"))
{
    string password = "MyPassword123";
    
    // Test with different thresholds
    var thresholds = new[] { 50, 75, 90, 95, 100 };
    
    foreach (int threshold in thresholds)
    {
        ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
        {
            Password = password,
            DetectionThresholdPercent = threshold
        };

        VerificationResult verifyResult = signature.Verify(verifyOptions);
        
        string status = verifyResult.IsValid ? "✓ Valid" : "✗ Invalid";
        Console.WriteLine($"{threshold}% threshold: {status}");
    }
}
```

## Full Data Extraction

When `UseFullDataExtraction` is enabled:

* Performs more thorough analysis using `AnalyzePercentageDigitalSignature`
* Provides a probability score (0-100%) in `DetectedProbability`
* More accurate but slightly slower
* Useful when standard verification is uncertain

### Using Full Data Extraction

```csharp
using (Signature signature = new Signature("signed_image.png"))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MyPassword",
        UseFullDataExtraction = true,
        DetectionThresholdPercent = 85
    };

    VerificationResult result = signature.Verify(verifyOptions);

    if (result.IsValid && verifyOptions.DetectedProbability.HasValue)
    {
        Console.WriteLine($"✓ Signature detected with {verifyOptions.DetectedProbability.Value}% probability");
    }
    else
    {
        Console.WriteLine("✗ Signature not detected or below threshold");
    }
}
```

### When to Use Full Data Extraction

Use full data extraction when:
* Standard verification gives uncertain results
* You need maximum accuracy
* Image may have been slightly modified
* You want probability scores

```csharp
// First try standard verification
ImageDigitalVerifyOptions standardOptions = new ImageDigitalVerifyOptions
{
    Password = "MyPassword"
};

VerificationResult standardResult = signature.Verify(standardOptions);

if (!standardResult.IsValid)
{
    // If standard verification fails, try full extraction
    ImageDigitalVerifyOptions fullExtractionOptions = new ImageDigitalVerifyOptions
    {
        Password = "MyPassword",
        UseFullDataExtraction = true,
        DetectionThresholdPercent = 70  // Lower threshold for full extraction
    };

    VerificationResult fullResult = signature.Verify(fullExtractionOptions);
    
    if (fullResult.IsValid)
    {
        Console.WriteLine($"Signature found with {fullExtractionOptions.DetectedProbability}% probability");
    }
}
```

## Handling Verification Results

### Detailed Result Processing

```csharp
using (Signature signature = new Signature("signed_image.png"))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MyPassword123"
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);

    if (verifyResult.IsValid)
    {
        Console.WriteLine($"✓ Signature valid. Found {verifyResult.Succeeded.Count} signature(s).");
        
        foreach (var sig in verifyResult.Succeeded)
        {
            if (sig is DigitalSignature digitalSig)
            {
                Console.WriteLine($"  Signature ID: {digitalSig.SignatureId}");
                Console.WriteLine($"  Sign Time: {digitalSig.SignTime}");
                Console.WriteLine($"  Is Valid: {digitalSig.IsValid}");
            }
        }
    }
    else
    {
        Console.WriteLine("✗ Signature invalid or not found.");
        
        if (verifyResult.Failed != null && verifyResult.Failed.Count > 0)
        {
            Console.WriteLine($"  Failed verifications: {verifyResult.Failed.Count}");
            foreach (var failure in verifyResult.Failed)
            {
                Console.WriteLine($"    - {failure}");
            }
        }
    }
}
```

## Error Handling

### Wrong Password

```csharp
try
{
    using (Signature signature = new Signature("signed_image.png"))
    {
        ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
        {
            Password = "WrongPassword"  // Wrong password
        };

        VerificationResult verifyResult = signature.Verify(verifyOptions);
        
        if (!verifyResult.IsValid)
        {
            Console.WriteLine("Signature verification failed - wrong password or no signature found.");
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error during verification: {ex.Message}");
}
```

### Password Validation

```csharp
try
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "123"  // Too short, minimum is 4 characters
    };

    using (Signature signature = new Signature("signed_image.png"))
    {
        VerificationResult verifyResult = signature.Verify(verifyOptions);
    }
}
catch (ArgumentException ex)
{
    Console.WriteLine($"Password validation error: {ex.Message}");
    // Output: "Password must be at least 4 characters long."
}
```

### Threshold Range Validation

```csharp
try
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MyPassword",
        DetectionThresholdPercent = 150  // Invalid: must be 0-100
    };

    using (Signature signature = new Signature("signed_image.png"))
    {
        VerificationResult verifyResult = signature.Verify(verifyOptions);
    }
}
catch (ArgumentOutOfRangeException ex)
{
    Console.WriteLine($"Threshold error: {ex.Message}");
    // Output: "Detection threshold must be within 0-100 range."
}
```

## Best Practices

### 1. Use Appropriate Thresholds

```csharp
// For critical applications, use higher threshold
ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
{
    Password = password,
    DetectionThresholdPercent = 95,  // High threshold for critical verification
    UseFullDataExtraction = true     // Maximum accuracy
};
```

### 2. Handle Verification Results Properly

```csharp
VerificationResult verifyResult = signature.Verify(verifyOptions);

if (verifyResult.IsValid)
{
    // Process successful verification
    ProcessValidSignature(verifyResult.Succeeded);
}
else
{
    // Handle failed verification
    HandleInvalidSignature(verifyResult.Failed);
}
```

### 3. Try Full Extraction if Standard Verification Fails

```csharp
// First attempt with standard verification
ImageDigitalVerifyOptions standardOptions = new ImageDigitalVerifyOptions
{
    Password = password,
    DetectionThresholdPercent = 75
};

VerificationResult result = signature.Verify(standardOptions);

if (!result.IsValid)
{
    // Try with full extraction and lower threshold
    ImageDigitalVerifyOptions fullOptions = new ImageDigitalVerifyOptions
    {
        Password = password,
        UseFullDataExtraction = true,
        DetectionThresholdPercent = 60  // Lower threshold
    };

    result = signature.Verify(fullOptions);
}
```

### 4. Store Passwords Securely

```csharp
// Retrieve password from secure storage
string password = GetPasswordFromSecureStorage();

ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
{
    Password = password
};
```

### 5. Verify Original Signed Images

```csharp
// Always verify the original signed image, not edited copies
string originalSignedImage = "signed_image.png";  // Original
string editedImage = "edited_signed_image.png";    // May have corrupted signature

// Verify original
using (Signature signature = new Signature(originalSignedImage))
{
    ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
    {
        Password = "MyPassword"
    };

    VerificationResult result = signature.Verify(verifyOptions);
    // This should work
}
```

## Troubleshooting

### Issue: Verification Fails with Correct Password

**Possible Causes**:
* Image was edited or compressed after signing
* Wrong detection threshold
* Image format not fully supported
* Image corruption

**Solutions**:

1. **Try Lower Threshold**:
```csharp
ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
{
    Password = "MyPassword",
    DetectionThresholdPercent = 50  // Lower threshold
};
```

2. **Enable Full Data Extraction**:
```csharp
ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
{
    Password = "MyPassword",
    UseFullDataExtraction = true,
    DetectionThresholdPercent = 60
};
```

3. **Verify Original Image**:
```csharp
// Always verify the original signed image, not edited copies
using (Signature signature = new Signature("original_signed_image.png"))
{
    // Verify here
}
```

### Issue: Wrong Password Error

**Solution**: Ensure the password matches exactly (case-sensitive) the one used during signing.

```csharp
// Password must match exactly (case-sensitive)
ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
{
    Password = "MyPassword123"  // Must match signing password exactly
};
```

### Issue: BMP Format Not Working

**Solution**: BMP format does not support LSB steganography digital signatures. Use PNG or JPG format instead.

```csharp
// Only PNG and JPG are supported
string[] supportedFormats = { ".png", ".jpg", ".jpeg" };
```

### Issue: Threshold Too High

**Solution**: Lower the detection threshold if verification fails.

```csharp
// Start with lower threshold
ImageDigitalVerifyOptions verifyOptions = new ImageDigitalVerifyOptions
{
    Password = "MyPassword",
    DetectionThresholdPercent = 50  // Lower threshold
};

// If that works, gradually increase to find optimal threshold
```

## Summary

Verifying digital signatures in images provides:

* ✅ **Password-Based Security**: Verify using the signing password
* ✅ **Flexible Thresholds**: Configurable detection sensitivity (0-100%)
* ✅ **High Accuracy**: Optional full data extraction mode
* ✅ **Format Support**: Works with PNG and JPG formats
* ✅ **Probability Scores**: Get detection probability with full extraction

Use this feature when you need to:
* Verify image authenticity and integrity
* Check if images contain embedded signatures
* Validate images using password-based signatures
* Detect signatures with configurable sensitivity

Remember to:
* Use the exact password from signing (case-sensitive)
* Choose appropriate detection thresholds
* Use full data extraction for maximum accuracy
* Verify original signed images (not edited copies)
* Handle verification results properly

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.


---

## eSign Document with Text Signature

Path: /signature/python-net/esign-document-with-text-signature/

## What is a Text Signature?

A **Text** electronic signature is an arbitrary text that is added to a document in a native way depending on the type of the document. GroupDocs.Signature provides the text signature feature and allows customizing a wide range of text settings - from font name, size and color to alignment, borders, shadow effects etc. This is how a text signature may look like:  

![Text](/signature/python-net/images/esign-document-with-text-signature.png)

## How to eSign Document with Text Signature

Let's try to add a text signature to a PDF programmatically using Python.

To manipulate text signatures programmatically [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) provides the [TextSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions) class and the whole workflow is as easy as follows:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions) object according to your requirements and specify the signature options.
* Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [TextSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions) to it.

This example shows how to add a text signature to a document using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSignOptions
from groupdocs.signature.domain import SignatureFont, TextSignature
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create text signature options
        text_options = TextSignOptions("John Smith")
        
        # Set advanced options
        text_options.font = gsd.SignatureFont()
        text_options.font.size = 20
        text_options.font.family_name = "Arial"
        text_options.font.bold = True
        text_options.font.italic = True
        text_options.fore_color = gsd.Color.BLUE
        text_options.back_color = gsd.Color.WHITE
        text_options.opacity = 0.8
        text_options.rotation_angle = 45
        
        # Set text alignment
        text_options.horizontal_alignment = gsd.HorizontalAlignment.CENTER
        text_options.vertical_alignment = gsd.VerticalAlignment.CENTER
        
        # Add border
        text_options.border_color = gsd.Color.BLACK
        text_options.border_style = gsd.DashStyle.SOLID
        text_options.border_width = 2
        
        # Sign document
        sign.sign("./sample_signed.pdf", text_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-text-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Text Signature Options

You can customize the text signature further with additional options:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSignOptions
from groupdocs.signature.domain import SignatureFont, TextSignature
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create text signature options
        text_options = TextSignOptions("John Smith")
        
        # Set advanced options
        text_options.font = gsd.SignatureFont()
        text_options.font.size = 20
        text_options.font.family_name = "Arial"
        text_options.font.bold = True
        text_options.font.italic = True
        text_options.fore_color = gsd.Color.BLUE
        text_options.back_color = gsd.Color.WHITE
        text_options.opacity = 0.8
        text_options.rotation_angle = 45
        
        # Set text alignment
        text_options.horizontal_alignment = gsd.HorizontalAlignment.CENTER
        text_options.vertical_alignment = gsd.VerticalAlignment.CENTER
        
        # Add border
        text_options.border_color = gsd.Color.BLACK
        text_options.border_style = gsd.DashStyle.SOLID
        text_options.border_width = 2
        
        # Sign document
        sign.sign("./sample_signed.pdf", text_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-text-signature/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide explains how to add text-based signatures to documents with [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net). It covers configuring text properties such as font, color, size, and position, and applying the text signature to a document. The signed document is then saved with the added text signature.


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign document with extensions

Path: /signature/net/sign-document-with-extensions/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides with [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) property Extensions that expects list of different extensions classes. At this moment here are few of them

* [SpreadsheetPosition](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/spreadsheetposition) that allows to specify for Spreadsheet documents signature position as Row and Column numbers
* [TextShadow](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain.extensions/textshadow) alternative extension for Text signature property

Here are the steps to add extensions to signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with all required additional options.
* Create instance of required Extension and call [SignOptions.Extensions.Add](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/extensions) method with passed object
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.

## Sign document with Text signature

This example shows how to add Text signature to document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // set signature alignment
        // when VerticalAlignment is set the Top coordinate will be ignored.
        // Use Margin properties Top, Bottom to provide vertical offset
        VerticalAlignment = Domain.VerticalAlignment.Top,
        // when HorizontalAlignment is set the Left coordinate will be ignored.
        // Use Margin properties Left, Right to provide horizontal offset
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Top = 20, Right = 20 },
        // adjust signature appearance
        // setup signature border
        Border = new Border()
        {
            Color = Color.DarkGreen,
            DashStyle = DashStyle.DashLongDashDot,
            Transparency = 0.5,
            Visible = true,
            Weight = 2
        },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new LinearGradientBrush(Color.LimeGreen, Color.DarkGreen)
        },
        // set rotation
        RotationAngle = 45,
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image

    };
    // set up shadow options for text
    TextShadow shadow = new TextShadow();
    shadow.Color = Color.OrangeRed;
    shadow.Angle = 135;
    shadow.Blur = 5;
    shadow.Distance = 4;
    shadow.Transparency = 0.2;
    //add text shadow to signature extensions
    options.Extensions.Add(shadow);

    // specify Spreadsheet position over extension
     options.Extensions.Add(new SpreadsheetPosition(10, 10));
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign document with Text signature

Path: /signature/java/esign-document-with-text-signature/

## What is a Text signature?

A **Text** electronic signature is an arbitrary text that is added to a document in a native way dependent on document type. GroupDocs.Signature provides text signature feature and allows to customize wide range of text settings - from font name, size and color to alignment, borders, shadow effects etc. This is how text signature may look like:  

![](/signature/java/images/esign-document-with-text-signature.png)

## How to eSign document with Text signature 

  

o manipulate with text signatures programmatically [GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) class and the whole workflow as easy as follows:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) object according to your requirements and specify Text signature options.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) to it.
    

This example shows how to add Text signature to document.

```java
Signature signature = new Signature("sample.pdf");

TextSignOptions options = new TextSignOptions("John Smith");
// set signature position
options.setLeft(100);
options.setTop(100);

// set signature rectangle
options.setWidth(100);
options.setHeight(30);

// set text color and Font
options.setForeColor(Color.RED);
SignatureFont signatureFont = new SignatureFont();
signatureFont.setSize(12);
signatureFont.setFamilyName("Comic Sans MS");
options.setFont(signatureFont);

// sign document to file
signature.sign("sample_signed.pdf", options);
```

More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for built-in Metadata signatures

Path: /signature/net/search-for-built-in-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) class to specify different options to search for Metadata signatures.

Most document types such as Word Processing, Spreadsheet and Presentation contains built-in metadata properties. Using property [IncludeBuiltinProperties](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions/includebuiltinproperties) of [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) allows to collect all supported built-in metadata properties of document. These properties are like document author, creation date, document keywords, titles, etc.

Here are the steps to search for metadata signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) object according to your requirements and specify [IncludeBuiltinProperties](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions/includebuiltinproperties) to true  
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) to it.

This example shows how to get built in Metadata signatures.

```csharp
using (Signature signature = new Signature("sample.xlsx"))
{
    MetadataSearchOptions options = new MetadataSearchOptions()
    {
        Name = "Producer",
        IncludeBuiltinProperties = true,
        NameMatchType = TextMatchType.Contains
    };
    // search for signatures in document
    List<SpreadsheetMetadataSignature> signatures = signature.Search<SpreadsheetMetadataSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var metadataSignature in signatures)
    {
        Console.WriteLine("Metadata signature found. Name : {0}. Value: {1}. Type: {2}", metadataSignature.Name, metadataSignature.Value,metadataSignature.Type);
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Advanced search for Form Field signatures

Path: /signature/java/advanced-search-for-form-field-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [FormFieldSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/FormFieldSearchOptions) class to specify different options to search for Form Field Signatures.

Here are the steps to search for Form Field signatures within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [FormFieldSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/FormFieldSearchOptions) object according to your requirements and specify search options      
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [FormFieldSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/FormFieldSearchOptions) to it.
    

This example shows how to make advanced search for Form Field signatures in the document.

```java
Signature signature = new Signature("signed.pdf");
FormFieldSearchOptions options = new FormFieldSearchOptions();
options.setValue("Value1");
options.setAllPages(true);
options.setName("TestField");
options.setType(FormFieldType.Text);
 
// search for signatures in document
List<FormFieldSignature> signatures = signature.search(FormFieldSignature.class, options);
System.out.print("\nSource document contains following signatures.");
for (FormFieldSignature formFieldSignature : signatures)
{
    System.out.print("FormField signature found. Name : "+formFieldSignature.getName()+". Value: " +formFieldSignature.getValue());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for Image e-signatures

Path: /signature/java/search-for-image-e-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) class to specify different options to search for Image e-signatures.

 Here are the steps to search for Image signatures within the document with GroupDocs.Signature API:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter;    
*   Instantiate the [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) object according to your requirements and specify additional search options (if needed);  
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) to it.
    

The code snippet below demonstrates how to search for Image electronic signature in the document.

```java
Signature signature = new Signature(sample.pdf);
// setup search options
ImageSearchOptions searchOptions = new ImageSearchOptions();   
 
// search document
List<ImageSignature> signatures = signature.search(ImageSignature.class,searchOptions);
System.out.print("\nSource document ['" + fileName + "'] contains following image signature(s).");
// output signatures   
for (ImageSignature imageSignature : signatures)
{
 
   System.out.print("Found Image signature at page "+imageSignature.getPageNumber()+" and size "+imageSignature.getSize()+".");
   System.out.print("Location at "+imageSignature.getLeft()+"-"+imageSignature.getTop()+". Size is "+imageSignature.getWidth()+"x"+imageSignature.getHeight()+".");
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## How to search for Image signatures

Path: /signature/net/search-for-image-e-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) class to specify different options to search for Image e-signatures.

 Here are the steps to search for Image signatures within the document with GroupDocs.Signature API:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter;
* Instantiate the [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) object according to your requirements and specify additional search options (if needed);
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) to it.

The code snippet below demonstrates how to search for Image electronic signature in the document.

```csharp
string fileName = "sample.pdf";
using (Signature signature = new Signature(fileName))
{
    // search document
    List<ImageSignature> signatures = signature.Search<ImageSignature>(SignatureType.Image);
    Console.WriteLine($"\nSource document ['{fileName}'] contains following image signature(s).");
    // output signatures
    foreach (ImageSignature imageSignature in signatures)
    {
        Console.WriteLine($"Image signature found at page {imageSignature.PageNumber} " +
                          $"with size {imageSignature.Size}. Created {imageSignature.CreatedOn}, " +
                          $"modified {imageSignature.ModifiedOn}");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## How to search for Image signatures

Path: /signature/nodejs-java/search-for-image-e-signatures/

Here are the steps to search for Image signatures within the document using [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java):

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [ImageSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/imagesearchoptions) object according to your requirements and specify additional search options (if needed).
* Call the [Search](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/#search) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [ImageSearchOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/imagesearchoptions) to it.
The code snippet below demonstrates how to search for Image electronic signature in the document.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_SIGNED_MULTI; 
  const fileName = path.basename(filePath);
  const signature = new signatureLib.Signature(filePath);

  // Search document
  const signatures = signature.search(signatureLib.ImageSignature.class, signatureLib.SignatureType.Image).toArray();
  console.log(`\nSource document ['${fileName}'] contains the following image signature(s).`);

  // Output signatures
  for (const imageSignature of signatures) {
    console.log(`Found Image signature at page ${imageSignature.getPageNumber()} and size ${imageSignature.getSize()}.`);
  }
```


## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add link annotation

Path: /annotation/java/add-link-annotation/

Link annotation adds a hyperlink to document as shown in the picture below:

![](/annotation/java/images/add-link-annotation.png)

You can use the following methods to set the properties of the [LinkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/linkannotation) class:

*   [setUrl()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/linkannotation/#setUrl-java.lang.String-) defines link to a web resource
*   [setPoints()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/linkannotation/#setPoints-java.util.List-com.groupdocs.annotation.models.Point--) defines the annotation positions as an array of points.  
    
To add a link annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [LinkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/linkannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [LinkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/linkannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add [LinkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/linkannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding link annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies = Arrays.asList(reply1, reply2);
    
    List<Point> points = Arrays.asList(new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650));                
    
    // Create an instance of LinkAnnotation class and set options
    LinkAnnotation link = new LinkAnnotation();
    link.setCreatedOn(Calendar.getInstance().getTime());
    link.setMessage("This is link annotation");
    link.setOpacity(0.7);
    link.setPageNumber(0);
    
    link.setPoints(points);               
    
    link.setReplies(replies);
    link.setUrl("https://www.google.com");
    
    // Add annotation and save to file
    annotator.add(link);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add link annotation

Path: /annotation/net/add-link-annotation/

Link annotation adds a hyperlink to document as shown in the picture below:

![](/annotation/net/images/add-link-annotation.png)

You can set the following properties of the  [LinkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/linkannotation) class:

*   [Url](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/linkannotation/properties/url) defines link to a web resource
*   [Points](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/linkannotation/properties/points) defines the annotation positions as an array of points.  
    

To add a link annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [LinkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/linkannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [LinkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/linkannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add [LinkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/linkannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add link annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	LinkAnnotation link= new LinkAnnotation
    {
    	Url = "https://www.groupdocs.com/",
        CreatedOn = DateTime.Now,
        Message = "This is link annotation",
        BackgroundColor = 65535,
        PageNumber = 0,
        Points = new List<Point>
        {
        	new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650)
        },
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(link);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Annotation redactions

Path: /redaction/java/annotation-redactions/

### Remove annotations (comments etc)

You can use GroupDocs.Redaction to remove all or specific comments and other annotations from the document. For example, we can remove all comments from the document, containing texts like "use", "show" or "describe" in its body:



```java
final Redactor redactor = new Redactor("annotated_sample.xlsx");
try 
{
    redactor.apply(new DeleteAnnotationRedaction("(?im:(use|show|describe))"));
    SaveOptions options = new  SaveOptions();
    options.setAddSuffix(true);
    options.setRasterizeToPDF(false);
    redactor.save(options);
}
finally { redactor.close(); }
```

You can use constructor without arguments to remove all annotations within the document.

### Redact annotations

Instead of removing all or specific annotations, you can remove sensitive data from the annotation text. For instance, we can remove all mentions of "John" in the given document, e.g.:



```java
final Redactor redactor = new Redactor("annotated_sample.xlsx");
try 
{
    redactor.apply(new AnnotationRedaction("(?im:john)", "[redacted]"));
    SaveOptions options = new  SaveOptions();
    options.setAddSuffix(true);
    options.setRasterizeToPDF(false);
    redactor.save(options);
}
finally { redactor.close(); }
```

---

## Annotation redactions

Path: /redaction/net/annotation-redactions/

With GroupDocs.Redaction API you can apply annotation redactions for documents of different formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list at [supported document formats]({{< ref "redaction/net/getting-started/supported-document-formats.md" >}}) article.

GroupDocs.Redactions provides a flexible API that allows to remove sensitive data from annotation text, or completely remove annotations by a regular expression.

## Remove annotations (comments etc)

You can use GroupDocs.Redaction to remove all or specific comments and other annotations from the document. For example, we can remove all comments from the document, containing texts like "use", "show" or "describe" in its body:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"D:\test.docx"))
{
   redactor.Apply(new DeleteAnnotationRedaction("(?im:(use|show|describe))"));

   redactor.Save()
}
```

You can use constructor without arguments to remove all annotations within the document.

## Redact annotations

Instead of removing all or specific annotations, you can remove sensitive data from the annotation text. For instance, we can remove all mentions of "John" in the given document, e.g.:

**C#**

```csharp
using (Redactor redactor = new Redactor(@"C:\test.pdf"))
{
   redactor.Apply(new AnnotationRedaction("(?im:john)", "[redacted]"));

   redactor.Save()
}
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Annotation redactions

Path: /redaction/python-net/annotation-redactions/

With GroupDocs.Redaction API you can apply annotation redactions for documents of different formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and others. See full list at [supported document formats]({{< ref "redaction/python-net/getting-started/supported-document-formats.md" >}}) article.

GroupDocs.Redactions provides a flexible API that allows to remove sensitive data from annotation text, or completely remove annotations by a regular expression.

## Remove annotations (comments etc)

You can use GroupDocs.Redaction to remove all or specific comments and other annotations from the document. For example, we can remove all comments from the document, containing texts like "use", "show" or "describe" in its body:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr

def run():
    # Specify the redaction options
    a_red = grr.DeleteAnnotationRedaction("(?im:(use|show|describe))")

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(a_red)
        
        # Save the redacted document
        redactor.save()
```

You can use constructor without arguments to remove all annotations within the document.

## Redact annotations

Instead of removing all or specific annotations, you can remove sensitive data from the annotation text. For instance, we can remove all mentions of "John" in the given document, e.g.:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr

def run():
    # Specify the redaction options
    a_red = grr.AnnotationRedaction("(?im:john)", "[redacted]")

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Apply the redaction
        result = redactor.apply(a_red)
        
        # Save the redacted document
        redactor.save()
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Change page orientation

Path: /merger/java/change-page-orientation/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to set **Portrait** or **Landscape** page orientation for specific or all document pages.

Here are the steps to change page orientation:

*   Initialize [OrientationOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/OrientationOptions) class with desired orientation mode and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [changeOrientation](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#changeOrientation(com.groupdocs.merger.domain.options.interfaces.IOrientationOptions)) method and pass [OrientationOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/OrientationOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to change page orientation:

```java
String filePath = "c:\sample.docx";
String filePathOut = "c:\output\result.docx";

OrientationOptions orientationOptions = new OrientationOptions(OrientationMode.Landscape, new int[] { 3, 4 });

Merger merger = new Merger(filePath);
merger.changeOrientation(orientationOptions);
merger.save(filePathOut);
```

---

## Change page orientation

Path: /merger/nodejs-java/change-page-orientation/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to set **Portrait** or **Landscape** page orientation for specific or all document pages.

Here are the steps to change page orientation:

*   Initialize [OrientationOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/OrientationOptions) class with desired orientation mode and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [changeOrientation](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#changeOrientation(com.groupdocs.merger.domain.options.interfaces.IOrientationOptions)) method and pass [OrientationOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/OrientationOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to change page orientation:

```js
const inputFilePath = `c:/sample.docx`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output/result.docx`;
const orientationMode = groupdocs.merger.OrientationMode.Landscape;
const orientationOptions = new groupdocs.merger.OrientationOptions(orientationMode, 1, 2);
merger.changeOrientation(orientationOptions);
merger.save(outputPath);
```

---

## Change page orientation

Path: /merger/python-net/change-page-orientation/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to set **Portrait** or **Landscape** page orientation for specific or all document pages.

Here are the steps to change page orientation:

*   Initialize [OrientationOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/OrientationOptions) class with desired orientation mode and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/net/merger/groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [changeOrientation](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/changeorientation/) method and pass [OrientationOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/OrientationOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method specifying file path to save resultant document.

The following code sample demonstrates how to change page orientation:

```python
with gm.Merger("c:/sample1.docx") as merger:
    orientation_mode = gm.domain.options.OrientationMode.LANDSCAPE
    orientation_options = gm.domain.options.OrientationOptions(orientation_mode, 1, 2)
    merger.change_orientation(orientation_options)
    merger.save("c:/merged.docx")
```

---

## Control temporary files

Path: /comparison/java/control-temporary-files/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to manage temporary files and directories. To do this, follow these steps:

1. Create a class that implements the `com.groupdocs.comparison.common.tempfiles.TemporaryFileManager` interface and its methods:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
class CustomTemporaryFileManager implements TemporaryFileManager {

    @Override
    public Path createTempDirectory() {
        // Implementation
    }

    @Override
    public Path createTempDirectory(String... pathsAsStrings) {
        // Implementation
    }

    @Override
    public Path createTempDirectory(Path... paths) {
        // Implementation
    }

    @Override
    public Path createTempFile() {
        // Implementation
    }

    @Override
    public Path createTempFile(String... pathsAsStrings) {
        // Implementation
    }

    @Override
    public Path createTempFile(Path... paths) {
        // Implementation
    }

    @Override
    public void delete(Path path) {
        // Implementation
    }

    @Override
    public void cleanup() {
        // Implementation
    }
}
```
{{< /tab >}}
{{< /tabs >}}

2. Create an object of this class and pass it to the `setInstance` method of `TemporaryFileManagerFactory`:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
final CustomTemporaryFileManager customTemporaryFileManager = new CustomTemporaryFileManager();
TemporaryFileManagerFactory.setInstance(customTemporaryFileManager);
```
{{< /tab >}}
{{< /tabs >}}

Now [GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) uses the implementation for creating temporary files and directories.
 
3. Use it in the next way:

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
final TemporaryFileManager temporaryFileManager = TemporaryFileManagerFactory.getInstance();
final Path tempFile = temporaryFileManager.createTempFile("temp.txt");
// Do something with the file
temporaryFileManager.delete(tempFile);
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
Default implementation creates temporary files and directories in a directory specified by `java.io.tmpdir` property.
{{< /alert >}}

---

## Control temporary files

Path: /viewer/java/control-temporary-files/


[GroupDocs.Viewer](https://products.groupdocs.com/viewer/java) allows you to control a way temporary files and directories is created. Follow these steps to implement custom logic for creating temporary files and folders:

1. Create a class that implements the `com.groupdocs.viewer.common.tempfiles.TemporaryFileManager` interface and its methods:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
class CustomTemporaryFileManager implements TemporaryFileManager {

    @Override
    public Path createTempDirectory() {
        // Implementation
    }

    @Override
    public Path createTempDirectory(String... pathsAsStrings) {
        // Implementation
    }

    @Override
    public Path createTempDirectory(Path... paths) {
        // Implementation
    }

    @Override
    public Path createTempFile() {
        // Implementation
    }

    @Override
    public Path createTempFile(String... pathsAsStrings) {
        // Implementation
    }

    @Override
    public Path createTempFile(Path... paths) {
        // Implementation
    }

    @Override
    public void delete(Path path) {
        // Implementation
    }

    @Override
    public void cleanup() {
        // Implementation
    }
}
```
{{< /tab >}}
{{< /tabs >}}

2. Create an object of the class and specify it as a parameter of the `setInstance` method of `TemporaryFileManagerFactory`:
{{< tabs "example2">}}
{{< tab "Java" >}}
```java
final CustomTemporaryFileManager customTemporaryFileManager = new CustomTemporaryFileManager();
TemporaryFileManagerFactory.setInstance(customTemporaryFileManager);
```
{{< /tab >}}
{{< /tabs >}}
   Now [GroupDocs.Viewer](https://products.groupdocs.com/viewer/java) uses this implementation for creating temporary files and directories.
 
3. Use the implementation for your needs as follows:
 
{{< tabs "example3">}}
{{< tab "Java" >}}
```java
final TemporaryFileManager temporaryFileManager = TemporaryFileManagerFactory.getInstance();
final Path tempFile = temporaryFileManager.createTempFile("temp.txt");
// Do something with the file
temporaryFileManager.delete(tempFile);
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}

Default implementation creates the temporary files and directories in a directory specified by the `java.io.tmpdir` property.

{{< /alert >}}
---

## Convert to Spreadsheet with advanced options

Path: /conversion/net/convert-to-spreadsheet-with-advanced-options/

GroupDocs.Conversion provides the [SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions) class to give you control over conversion result when convert to spreadsheet format. Along with [common convert options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}}) from base class [SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions) has the following additional options:

*   **[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** specifies desired result document type. Available options are: *Xls, Xlsx, Xlsm, Xlsb, Ods, Ots, Xltx, Xlt, Xltm, Tsc, Xlam, Csv, Tsv*.
*   **[Encoding](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions/encoding)** specifies the encoding to be used when converting to delimited formats (CSV, TSV). Default is UTF-8.
*   **[Separator](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions/separator)** specifies the separator character to be used when converting to delimited formats (CSV, TSV). For CSV, the default is comma (`,`). For TSV, use tab character (`\t`).
*   **[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions/password)** whether the converted document will be password protected with the specified password.
*   **[Zoom](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions/zoom)** specifies the zoom level in percentage. Default is 100.

The following code snippet shows how to convert to Spreadsheet with advanced options:

```csharp
using (Converter converter = new Converter("sample.docx"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions
    {
        PageNumber = 2,
        PagesCount = 1,
        Format = SpreadsheetFileType.Xlsx,
        Zoom = 150
    };
    converter.Convert("converted.xlsx", options);
}
```

## Converting to CSV with Encoding

When converting to CSV format, you can specify the character encoding:

```csharp
using System.Text;
using (Converter converter = new Converter("sample.xlsx"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions
    {
        Format = SpreadsheetFileType.Csv,
        Encoding = Encoding.UTF8
    };
    converter.Convert("converted.csv", options);
}
```

## Converting to CSV with Custom Separator

Use a custom separator character for CSV conversion. Semicolon separator is common in European locales where comma is used as a decimal separator:

```csharp
using (Converter converter = new Converter("sample.xlsx"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions
    {
        Format = SpreadsheetFileType.Csv,
        Separator = ';'  // Semicolon separator for European locales
    };
    converter.Convert("converted.csv", options);
}
```

## Converting to CSV with Encoding and Separator

Combine both encoding and separator settings for international CSV exports:

```csharp
using System.Text;
using (Converter converter = new Converter("sample.xlsx"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions
    {
        Format = SpreadsheetFileType.Csv,
        Encoding = Encoding.UTF8,
        Separator = ';'
    };
    converter.Convert("international-data.csv", options);
}
```

## Converting to TSV (Tab-Separated Values)

Convert to TSV format using tab character as separator:

```csharp
using (Converter converter = new Converter("sample.xlsx"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions
    {
        Format = SpreadsheetFileType.Tsv,
        Separator = '\t'  // Tab character
    };
    converter.Convert("converted.tsv", options);
}
```

## More Resources

- [API Reference: SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/spreadsheetconvertoptions)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})

---

## Create custom format handler

Path: /redaction/net/create-custom-format-handler/

If format is not supported, you will need to implement a handler for it by inheriting from [DocumentFormatInstance](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/documentformatinstance) class. Depending on the document's features and required redactions, you will also need to implement one or several interfaces, allowing GroupDocs.Redaction to work with this document format.

| Interface | Description |
| --- | --- |
| [ITextualFormatInstance](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/itextualformatinstance) | Required for document text redactions to work, replaces occurrences of given regular expression with text or a color block |
| [IMetadataAccess](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/imetadataaccess) | Required for metadata redactions, reads metadata and changes specific metadata item |
| [IAnnotatedDocument](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/iannotateddocument) | Required for annotation redactions, changes or deletes annotations, matching given regular expression |
| [IRasterizableDocument](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/irasterizabledocument) | Required to rasterize (save document as a PDF with page images) |
| [IImageFormatInstance](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/iimageformatinstance) | Required for raster image format redactions, based on area top-left corner coordinates and area size |
| [IPreviewable](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/ipreviewable) | Required to provide document general information and preview functionality |

Each of these interfaces is optional, i.e. you don't have to implement all of them, e.g. [IImageFormatInstance](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/iimageformatinstance) - if you don't need its functionality or [IMetadataAccess](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/imetadataaccess), if your format does not support metadata.

Below, we create a [DocumentFormatInstance](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/documentformatinstance) class with custom logic for textual documents processing, supporting only textual redactions:

**C#**

```csharp
public class CustomTextualDocument : DocumentFormatInstance, ITextualFormatInstance
{
    private RedactorSettings Settings { get; set; }
    private List<string> FileContent { get; set; }

    public CustomTextualDocument()
    {
        FileContent = new List<string>();
    }

    public override void Initialize(DocumentFormatConfiguration config, RedactorSettings settings)
    {
        Settings = settings;
    }

    public override void Load(System.IO.Stream input)
    {
        FileContent.Clear();
        using (var reader = new StreamReader(input))
        {
            while (!reader.EndOfStream)
            {
                FileContent.Add(reader.ReadLine());
            }
        }
    }

    public override void Save(System.IO.Stream output)
    {
        var writer = new StreamWriter(output);
        foreach (var line in FileContent)
        {
            writer.WriteLine(line);
        }
        writer.Flush();
    }

    public RedactionResult ReplaceText(Regex regex, Redactions.ReplacementOptions options)
    {
        try
        {
            if (options.ActionType != Redactions.ReplacementType.ReplaceString)
            {
                return new RedactionResult.Failed("This format allows only ReplaceString redactions!");
            }
            for (int i = 0; i < FileContent.Count; i++)
            {
                FileContent[i] = regex.Replace(FileContent[i], options.Replacement);
            }
            return RedactionResult.Successful();
        }
        catch (Exception ex)
        {
            return RedactionResult.Failed(ex.ToString());
        }
    }
}

```

In order to use this class, we will need to add it to pre-configured formats, e.g. as a handler for dump files ("\*.dump"):

**C#**

```csharp
var config = RedactorConfiguration.GetInstance();
config.AvailableFormats.Add(new DocumentFormatConfiguration()
{
    ExtensionFilter = ".dump",
    DocumentType = typeof(CustomTextualDocument)
});
```

## Security and password protection

If your format supports security options like password protection, you'll have to pass true or false to [SetAccessGranted](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/documentformatinstance/methods/setaccessgranted) method of [DocumentFormatInstance](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/documentformatinstance) class in your override of [Load](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration/documentformatinstance/methods/load) method and throw [IncorrectPasswordException](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.exceptions/incorrectpasswordexception) or [PasswordRequiredException](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.exceptions/passwordrequiredexception), if applicable. For instance:

**C#**

```csharp
public override void Load(System.IO.Stream input)
{
    try
    {
		// check security and load document 

        SetAccessGranted(true);
    }
    catch (SomeSecurityException)
    {
        SetAccessGranted(false);
		// Password, provided with LoadOptions
        if (string.IsNullOrEmpty(Password))
            throw new Exceptions.PasswordRequiredException();
        else
            throw new Exceptions.IncorrectPasswordException();
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Create PDF with Image Redaction

Path: /redaction/java/create-pdf-with-image-redaction/


In some cases you might need to redact the pages of a document as images, redacting entire areas of the page instead or in addition to a specific text. With GroupDocs.Redaction you can use the following approach:  

*   open the document and apply all required redactions to the document's body (text, annotations, etc.);
    
*   save it as a rasterized PDF file (containing images of the original document's pages);
    
*   apply ImageAreaRedaction to remove specific areas on the pages within the PDF document.  
    
The following example demonstrates how to create a rasterized PDF from a Microsoft Word document and apply image redactions to its pages:


```java
ByteArrayInputStream inputStream = null;
// Rasterize the document before applying redactions
final Redactor raterizer = new Redactor("C:\\Temp\\sample.docx");
try 
{
    // Perform annotation and textual redactions, if needed
    ByteArrayOutputStream stream = new ByteArrayOutputStream();
    RasterizationOptions options = new RasterizationOptions();
    options.setEnabled(true);
    raterizer.save(stream, options);
    inputStream = new ByteArrayInputStream(stream.toByteArray());  
    stream.close();
}
finally { raterizer.close(); }
if (inputStream != null)
{
    // Re-open the rasterized PDF document to redact its pages as images
    final Redactor redactor = new Redactor(inputStream);
    try 
    {
        RedactorChangeLog result = redactor.apply(new ImageAreaRedaction(new java.awt.Point(1160, 2375),
            new RegionReplacementOptions(java.awt.Color.BLUE, new java.awt.Dimension(1050, 720))));
        if (result.getStatus() != RedactionStatus.Failed)
        {
            final FileOutputStream fileStream = new FileOutputStream("C:\\Temp\\sample_docx_Raster.pdf");
            try 
            {
                RasterizationOptions options = new  RasterizationOptions();
                options.setEnabled(false);
                redactor.save(fileStream, options);
            }
            finally { fileStream.close(); }
        }         
    }
    finally { redactor.close(); inputStream.close(); }
}
```

Please, note that you don't have to use GroupDocs.Redaction to create a rasterized PDF from an office document. You will be able to use it, if you don't have any other tool for that.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Document filtering during indexing

Path: /search/java/document-filtering-during-indexing/

This page contains a description of the use of document filters for indexing, as well as descriptions of all types of filters with examples of their creation.

## Setting a filter

To indicate which documents from adding folders should be indexed and which not, the [setDocumentFilter](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setDocumentFilter(com.groupdocs.search.DocumentFilter)) method of the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class can be used to specify a filter based on various properties of these documents. If a document adding separately or located in an adding folder does not match the filter, then it will not be added and indexed. The default value is null, which means that all added files will be indexed if their format is supported. The following example demonstrates how to set a document filter for indexing.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating a filter that skips documents with extensions '.doc', '.docx', '.rtf'
IndexSettings settings = new IndexSettings();
DocumentFilter fileExtensionFilter = DocumentFilter.createFileExtension(".doc", ".docx", ".rtf"); // Creating file extension filter that allows only specified extensions
DocumentFilter invertedFilter = DocumentFilter.createNot(fileExtensionFilter); // Inverting file extension filter to allow all extensions except specified ones
settings.setDocumentFilter(invertedFilter);
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents
index.add(documentsFolder);
```

## Creation time filters

The first type of filters is based on the time the document file was created. Such filters can skip files created earlier than a certain date, later than a certain date, or outside a certain range of dates. Examples of these filters are given below.



```java
// The first filter skips files created earlier than January 1, 2017, 00:00:00 a.m.
DocumentFilter filter1 = DocumentFilter.createCreationTimeLowerBound(new Date(2017 - 1900, 1 - 1, 1));
 
// The second filter skips files created later than June 15, 2018, 00:00:00 a.m.
DocumentFilter filter2 = DocumentFilter.createCreationTimeUpperBound(new Date(2018 - 1900, 6 - 1, 15));
 
// The third filter skips files created outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m.
DocumentFilter filter3 = DocumentFilter.createCreationTimeRange(new Date(2017 - 1900, 1 - 1, 1), new Date(2018 - 1900, 6 - 1, 15));
```

## Modification time filters

The next type of filters works similarly, but based on the document file modification date. Examples are presented below.



```java
// The first filter skips files modified earlier than January 1, 2017, 00:00:00 a.m.
DocumentFilter filter1 = DocumentFilter.createModificationTimeLowerBound(new Date(2017 - 1900, 1 - 1, 1));
 
// The second filter skips files modified later than June 15, 2018, 00:00:00 a.m.
DocumentFilter filter2 = DocumentFilter.createModificationTimeUpperBound(new Date(2018 - 1900, 6 - 1, 15));
 
// The third filter skips files modified outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m.
DocumentFilter filter3 = DocumentFilter.createModificationTimeRange(new Date(2017 - 1900, 1 - 1, 1), new Date(2018 - 1900, 6 - 1, 15));
```

## File path filters

The next type of filters allows you to set a regular expression for skipping those documents whose full paths do not match the specified pattern. This type of filters uses the **java.util.regex.Pattern** class to compare with a pattern.



```java
// The filter skips files that do not contain the word 'Einstein' in their paths
DocumentFilter filter = DocumentFilter.createFilePathRegularExpression("Einstein", Pattern.CASE_INSENSITIVE);
```

## File length filters

The following group of filters uses the file length in bytes for filtering. It is possible to specify a lower bound, an upper bound or the range of acceptable file length. Examples are below.



```java
// The first filter skips documents less than 50 KB in length
DocumentFilter filter1 = DocumentFilter.createFileLengthLowerBound(50 * 1024);
 
// The second filter skips documents more than 10 MB in length
DocumentFilter filter2 = DocumentFilter.createFileLengthUpperBound(10 * 1024 * 1024);
 
// The third filter skips documents less than 100 KB and more than 5 MB in length
DocumentFilter filter3 = DocumentFilter.createFileLengthRange(100 * 1024, 5 * 1024 * 1024);
```

## File extension filter

The following type of filters allows you to specify a list of valid file extensions for indexing.



```java
// This filter allows indexing only FB2, EPUB, and TXT files
DocumentFilter filter = DocumentFilter.createFileExtension(".fb2", ".epub", ".txt");
```

## Logical NOT filter

The next type of filter allows you to invert the logic of an internal filter.



```java
IndexSettings settings = new IndexSettings();
DocumentFilter filter = DocumentFilter.createFileExtension(".htm", ".html");
DocumentFilter invertedFilter = DocumentFilter.createNot(filter); // Inverting file extension filter to allow all extensions except of HTM and HTML
settings.setDocumentFilter(invertedFilter);
```

## Logical AND filter

The filter of the following type allows you to compose a complex filter from several other filters, using the logic "AND". This composite filter requires the simultaneous fulfillment of the conditions of all internal filters for each file to be added. The example below shows how to make a filter that allows indexing only documents created in the date range from 01/01/2015 to 01/01/2016, with the extension '.txt' and a size of no more than 8 MB.



```java
IndexSettings settings = new IndexSettings();
DocumentFilter filter1 = DocumentFilter.createCreationTimeRange(new Date(2015 - 1900, 1 - 1, 1), new Date(2016 - 1900, 1 - 1, 1));
DocumentFilter filter2 = DocumentFilter.createFileExtension(".txt");
DocumentFilter filter3 = DocumentFilter.createFileLengthUpperBound(8 * 1024 * 1024);
DocumentFilter finalFilter = DocumentFilter.createAnd(filter1, filter2, filter3);
settings.setDocumentFilter(finalFilter);
```

## Logical OR filter

The filter of the following type allows you to compose a complex filter from several other filters, using the logic "OR". This composite filter requires fulfillment of the condition of at least one internal filter for each added file. The example below shows how to create a filter that limits the size of text files to 5 mb and other files to 10 mb.



```java
IndexSettings settings = new IndexSettings();
DocumentFilter txtFilter = DocumentFilter.createFileExtension(".txt");
DocumentFilter notTxtFilter = DocumentFilter.createNot(txtFilter);
DocumentFilter bound5Filter = DocumentFilter.createFileLengthUpperBound(5 * 1024 * 1024);
DocumentFilter bound10Filter = DocumentFilter.createFileLengthUpperBound(10 * 1024 * 1024);
DocumentFilter txtSizeFilter = DocumentFilter.createAnd(txtFilter, bound5Filter);
DocumentFilter notTxtSizeFilter = DocumentFilter.createAnd(notTxtFilter, bound10Filter);
DocumentFilter finalFilter = DocumentFilter.createOr(txtSizeFilter, notTxtSizeFilter);
settings.setDocumentFilter(finalFilter);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document filtering during indexing

Path: /search/net/document-filtering-during-indexing/

This page contains a description of the use of document filters for indexing, as well as descriptions of all types of filters with examples of their creation.

## Setting a filter

To indicate which documents from adding folders should be indexed and which not, the [DocumentFilter](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/documentfilter) property of the [IndexSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings) class can be used to specify a filter based on various properties of these documents. If a document adding separately or located in an adding folder does not match the filter, then it will not be added and indexed. The default value is null, which means that all added files will be indexed if their format is supported. The following example demonstrates how to set a document filter for indexing.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating a filter that skips documents with extensions '.doc', '.docx', '.rtf'
IndexSettings settings = new IndexSettings();
DocumentFilter fileExtensionFilter = DocumentFilter.CreateFileExtension(".doc", ".docx", ".rtf"); // Creating file extension filter that allows only specified extensions
DocumentFilter invertedFilter = DocumentFilter.CreateNot(fileExtensionFilter); // Inverting file extension filter to allow all extensions except specified ones
settings.DocumentFilter = invertedFilter;
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents
index.Add(documentsFolder);
```

## Creation time filters

The first type of filters is based on the time the document file was created. Such filters can skip files created earlier than a certain date, later than a certain date, or outside a certain range of dates. Examples of these filters are given below.

**C#**

```csharp
// The first filter skips files created earlier than January 1, 2017, 00:00:00 a.m.
DocumentFilter filter1 = DocumentFilter.CreateCreationTimeLowerBound(new DateTime(2017, 1, 1));
 
// The second filter skips files created later than June 15, 2018, 00:00:00 a.m.
DocumentFilter filter2 = DocumentFilter.CreateCreationTimeUpperBound(new DateTime(2018, 6, 15));
 
// The third filter skips files created outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m.
DocumentFilter filter3 = DocumentFilter.CreateCreationTimeRange(new DateTime(2017, 1, 1), new DateTime(2018, 6, 15));
```

## Modification time filters

The next type of filters works similarly, but based on the document file modification date. Examples are presented below.

**C#**

```csharp
// The first filter skips files modified earlier than January 1, 2017, 00:00:00 a.m.
DocumentFilter filter1 = DocumentFilter.CreateModificationTimeLowerBound(new DateTime(2017, 1, 1));
 
// The second filter skips files modified later than June 15, 2018, 00:00:00 a.m.
DocumentFilter filter2 = DocumentFilter.CreateModificationTimeUpperBound(new DateTime(2018, 6, 15));
 
// The third filter skips files modified outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m.
DocumentFilter filter3 = DocumentFilter.CreateModificationTimeRange(new DateTime(2017, 1, 1), new DateTime(2018, 6, 15));
```

## File path filters

The next type of filters allows you to set a regular expression for skipping those documents whose full paths do not match the specified pattern. This type of filters uses the **System.Text.RegularExpressions.Regex** class to compare with a pattern.

**C#**

```csharp
// The filter skips files that do not contain the word 'Einstein' in their paths
DocumentFilter filter = DocumentFilter.CreateFilePathRegularExpression("Einstein", RegexOptions.IgnoreCase);
```

## File length filters

The following group of filters uses the file length in bytes for filtering. It is possible to specify a lower bound, an upper bound or the range of acceptable file length. Examples are below.

**C#**

```csharp
 // The first filter skips documents less than 50 KB in length
DocumentFilter filter1 = DocumentFilter.CreateFileLengthLowerBound(50 * 1024);
 
// The second filter skips documents more than 10 MB in length
DocumentFilter filter2 = DocumentFilter.CreateFileLengthUpperBound(10 * 1024 * 1024);
 
// The third filter skips documents less than 100 KB and more than 5 MB in length
DocumentFilter filter3 = DocumentFilter.CreateFileLengthRange(100 * 1024, 5 * 1024 * 1024);
```

## File extension filter

The following type of filters allows you to specify a list of valid file extensions for indexing.

**C#**

```csharp
// This filter allows indexing only FB2, EPUB, and TXT files
DocumentFilter filter = DocumentFilter.CreateFileExtension(".fb2", ".epub", ".txt");
```

## Logical NOT filter

The next type of filter allows you to invert the logic of an internal filter.

**C#**

```csharp
IndexSettings settings = new IndexSettings();
DocumentFilter filter = DocumentFilter.CreateFileExtension(".htm", ".html");
DocumentFilter invertedFilter = DocumentFilter.CreateNot(filter); // Inverting file extension filter to allow all extensions except of HTM and HTML
settings.DocumentFilter = invertedFilter;
```

## Logical AND filter

The filter of the following type allows you to compose a complex filter from several other filters, using the logic "AND". This composite filter requires the simultaneous fulfillment of the conditions of all internal filters for each file to be added. The example below shows how to make a filter that allows indexing only documents created in the date range from 01/01/2015 to 01/01/2016, with the extension '.txt' and a size of no more than 8 MB.

**C#**

```csharp
IndexSettings settings = new IndexSettings();
DocumentFilter filter1 = DocumentFilter.CreateCreationTimeRange(new DateTime(2015, 1, 1), new DateTime(2016, 1, 1));
DocumentFilter filter2 = DocumentFilter.CreateFileExtension(".txt");
DocumentFilter filter3 = DocumentFilter.CreateFileLengthUpperBound(8 * 1024 * 1024);
DocumentFilter finalFilter = DocumentFilter.CreateAnd(filter1, filter2, filter3);
settings.DocumentFilter = finalFilter;
```

## Logical OR filter

The filter of the following type allows you to compose a complex filter from several other filters, using the logic "OR". This composite filter requires fulfillment of the condition of at least one internal filter for each added file. The example below shows how to create a filter that limits the size of text files to 5 mb and other files to 10 mb.

**C#**

```csharp
IndexSettings settings = new IndexSettings();
DocumentFilter txtFilter = DocumentFilter.CreateFileExtension(".txt");
DocumentFilter notTxtFilter = DocumentFilter.CreateNot(txtFilter);
DocumentFilter bound5Filter = DocumentFilter.CreateFileLengthUpperBound(5 * 1024 * 1024);
DocumentFilter bound10Filter = DocumentFilter.CreateFileLengthUpperBound(10 * 1024 * 1024);
DocumentFilter txtSizeFilter = DocumentFilter.CreateAnd(txtFilter, bound5Filter);
DocumentFilter notTxtSizeFilter = DocumentFilter.CreateAnd(notTxtFilter, bound10Filter);
DocumentFilter finalFilter = DocumentFilter.CreateOr(txtSizeFilter, notTxtSizeFilter);
settings.DocumentFilter = finalFilter;
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document filtering during indexing

Path: /search/nodejs-java/document-filtering-during-indexing/

This page contains a description of the use of document filters for indexing, as well as descriptions of all types of filters with examples of their creation.

## Setting a filter

To indicate which documents from adding folders should be indexed and which not, the [setDocumentFilter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setDocumentFilter(com.groupdocs.search.DocumentFilter)) method of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class can be used to specify a filter based on various properties of these documents. If a document adding separately or located in an adding folder does not match the filter, then it will not be added and indexed. The default value is null, which means that all added files will be indexed if their format is supported. The following example demonstrates how to set a document filter for indexing.

```javascript
const indexFolder = 'c:/MyIndex';
const documentsFolder = 'c:/MyDocuments';

// Creating a filter that skips documents with extensions '.doc', '.docx', '.rtf'
const settings = new groupdocs.search.IndexSettings();
const fileExtensionFilter = groupdocs.search.DocumentFilter.createFileExtension('.doc', '.docx', '.rtf'); // Creating file extension filter that allows only specified extensions
const invertedFilter = groupdocs.search.DocumentFilter.createNot(fileExtensionFilter); // Inverting file extension filter to allow all extensions except specified ones
settings.setDocumentFilter(invertedFilter);

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Indexing documents
index.add(documentsFolder);
```

## Creation time filters

The first type of filters is based on the time the document file was created. Such filters can skip files created earlier than a certain date, later than a certain date, or outside a certain range of dates. Examples of these filters are given below.

```javascript
// The first filter skips files created earlier than January 1, 2017, 00:00:00 a.m.
const filter1 = groupdocs.search.DocumentFilter.createCreationTimeLowerBound(Utils.createDate(2017, 1, 1));

// The second filter skips files created later than June 15, 2018, 00:00:00 a.m.
const filter2 = groupdocs.search.DocumentFilter.createCreationTimeUpperBound(Utils.createDate(2018, 6, 15));

// The third filter skips files created outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m.
const filter3 = groupdocs.search.DocumentFilter.createCreationTimeRange(
  Utils.createDate(2017, 1, 1),
  Utils.createDate(2018, 6, 15),
```

## Modification time filters

The next type of filters works similarly, but based on the document file modification date. Examples are presented below.

```javascript
// The first filter skips files modified earlier than January 1, 2017, 00:00:00 a.m.
const filter1 = groupdocs.search.DocumentFilter.createModificationTimeLowerBound(Utils.createDate(2017, 1, 1));

// The second filter skips files modified later than June 15, 2018, 00:00:00 a.m.
const filter2 = groupdocs.search.DocumentFilter.createModificationTimeUpperBound(Utils.createDate(2018, 6, 15));

// The third filter skips files modified outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m.
const filter3 = groupdocs.search.DocumentFilter.createModificationTimeRange(
  Utils.createDate(2017, 1, 1),
  Utils.createDate(2018, 6, 15),
);
```

## File path filters

The next type of filters allows you to set a regular expression for skipping those documents whose full paths do not match the specified pattern. This type of filters uses the **java.util.regex.Pattern** class to compare with a pattern.

```javascript
// Creating a filter that skips files that do not contain the word 'Ipsum' in their paths
const filter = groupdocs.search.DocumentFilter.createFilePathRegularExpression('Ipsum', java.getStaticFieldValue('java.util.regex.Pattern', 'CASE_INSENSITIVE'));
```

## File length filters

The following group of filters uses the file length in bytes for filtering. It is possible to specify a lower bound, an upper bound or the range of acceptable file length. Examples are below.

```javascript
// The first filter skips documents less than 50 KB in length
const filter1 = groupdocs.search.DocumentFilter.createFileLengthLowerBound(50 * 1024);

// The second filter skips documents more than 10 MB in length
const filter2 = groupdocs.search.DocumentFilter.createFileLengthUpperBound(10 * 1024 * 1024);

// The third filter skips documents less than 50 KB and more than 100 KB in length
const filter3 = groupdocs.search.DocumentFilter.createFileLengthRange(50 * 1024, 100 * 1024);
```

## File extension filter

The following type of filters allows you to specify a list of valid file extensions for indexing.

```javascript
// This filter allows indexing only FB2, EPUB, and TXT files
const filter = groupdocs.search.DocumentFilter.createFileExtension('.fb2', '.epub', '.txt');
```

## Logical NOT filter

The next type of filter allows you to invert the logic of an internal filter.

```javascript
const settings = new groupdocs.search.IndexSettings();
const filter = groupdocs.search.DocumentFilter.createFileExtension('.htm', '.html', '.pdf');
const invertedFilter = groupdocs.search.DocumentFilter.createNot(filter); // Inverting file extension filter to allow all extensions except of HTM, HTML, and PDF
settings.setDocumentFilter(invertedFilter);
```

## Logical AND filter

The filter of the following type allows you to compose a complex filter from several other filters, using the logic "AND". This composite filter requires the simultaneous fulfillment of the conditions of all internal filters for each file to be added. The example below shows how to make a filter that allows indexing only documents created in the date range from 01/01/2015 to 01/01/2016, with the extension '.txt' and a size of no more than 8 MB.

```javascript
const settings = new groupdocs.search.IndexSettings();
const filter1 = groupdocs.search.DocumentFilter.createCreationTimeRange(
  Utils.createDate(2015, 1, 1),
  Utils.createDate(2016, 1, 1),
);
const filter2 = groupdocs.search.DocumentFilter.createFileExtension('.txt');
const filter3 = groupdocs.search.DocumentFilter.createFileLengthUpperBound(8 * 1024 * 1024);
const finalFilter = groupdocs.search.DocumentFilter.createAnd(filter1, filter2, filter3);
settings.setDocumentFilter(finalFilter); // Setting the filter
```

## Logical OR filter

The filter of the following type allows you to compose a complex filter from several other filters, using the logic "OR". This composite filter requires fulfillment of the condition of at least one internal filter for each added file. The example below shows how to create a filter that limits the size of text files to 5 mb and other files to 10 mb.

```javascript
const settings = new groupdocs.search.IndexSettings();
const txtFilter = groupdocs.search.DocumentFilter.createFileExtension('.txt');
const notTxtFilter = groupdocs.search.DocumentFilter.createNot(txtFilter);
const bound5Filter = groupdocs.search.DocumentFilter.createFileLengthUpperBound(5 * 1024 * 1024);
const bound10Filter = groupdocs.search.DocumentFilter.createFileLengthUpperBound(10 * 1024 * 1024);
const txtSizeFilter = groupdocs.search.DocumentFilter.createAnd(txtFilter, bound5Filter);
const notTxtSizeFilter = groupdocs.search.DocumentFilter.createAnd(notTxtFilter, bound10Filter);
const finalFilter = groupdocs.search.DocumentFilter.createOr(txtSizeFilter, notTxtSizeFilter);
settings.setDocumentFilter(finalFilter); // Setting the filter
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document preview

Path: /watermark/net/basic-usage/preview/


GroupDocs.Watermark library equipped with the capability to generate preview images for every page of your documents, simplifying your workflow and enhancing efficiency. With this feature, users can  effortlessly preview their documents with a glance, enabling swift navigation and ensuring seamless accessibility to crucial content. 

## Generate document preview

To create document preview:
1. [Create](https://reference.groupdocs.com/net/watermark/groupdocs.watermark/watermarker/constructors/4) an instance of the `Watermarker` class for a local file or file stream;

2. Instantiate the [PreviewOptions](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.options/previewoptions/) object with the delegate for stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.options/createpagestream/));
If you need to implement custom image preview stream disposing you have to pass additional argument [ReleasePageStream](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.options/releasepagestream/) to clean up resources.  

3. Specify [PreviewFormat](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.options/previewoptions.previewformats/) - PNG / JPG / BMP, and other properties like PageNumbers for which you want to generate preview. Additionaly for most of documents you can use specific PreviewOptions overloads, like [PdfPreviewOptions](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.options.pdf/pdfpreviewoptions/), [SpreadsheetPreviewOptions](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.options.spreadsheet/spreadsheetpreviewoptions/) which allows to configure the resolution for the generated images in dots per inch.

4. Call method GeneratePreview method of the Watermarker object and pass PreviewOptions to it.


```csharp
string outputDirectory = Constants.GetOutputDirectoryPath();

using (Watermarker watermarker = new Watermarker("sample.pdf"))
{
    CreatePageStream createPageStreamDelegate = delegate(int number)
    {
        string previewImageFileName = Path.Combine(outputDirectory, 
            string.Format("page{0}.png", number));
        return File.OpenWrite(previewImageFileName);
    };

    ReleasePageStream releasePageStreamDelegate = delegate(int number, Stream stream)
    {
        stream.Close();
    };

    PreviewOptions previewOptions = new PreviewOptions(createPageStreamDelegate,
        releasePageStreamDelegate)
    {
        PreviewFormat = PreviewOptions.PreviewFormats.PNG,
        PageNumbers = new []{1, 2}
    };
    
    watermarker.GeneratePreview(previewOptions);
}
```
Run the program. It will create images in the outputDirectory corresponding to the pages of the document.


---

## Document preview

Path: /watermark/python-net/basic-usage/preview/


Generate preview images for document pages.

Easily render document pages as images for preview purposes. With Python, you can generate page thumbnails (e.g., PNG or JPG) to display documents without fully opening them in a viewer.

## Generate document preview

```python
import os
import io
import groupdocs.watermark as gw
import groupdocs.watermark.options as gwo

output_directory = os.path.join(os.getcwd(), "preview")
os.makedirs(output_directory, exist_ok=True)

def create_page_stream(number: int):
    path = os.path.join(output_directory, f"page{number}.png")
    return open(path, "wb")

def release_page_stream(number: int, stream):
    stream.close()

with gw.Watermarker("sample.pdf") as watermarker:
    preview_options = gwo.PreviewOptions(create_page_stream, release_page_stream)
    preview_options.preview_format = gwo.PreviewOptions.PreviewFormats.PNG
    preview_options.page_numbers = [1, 2]
    watermarker.generate_preview(preview_options)
```

The images will be created in the specified output directory.

🔹 Use case: Generate page previews for displaying in a web app, dashboard, or document management system without requiring end users to download the full file.


---

## Error handling

Path: /markdown/net/error-handling/


All `Convert()` methods throw on failure. Use standard try/catch with specific exception types:

{{< tabs "error-handling-example">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

try
{
    MarkdownConverter.ToFile("annual-report.docx", "error-handling-example.md");
}
catch (DocumentProtectedException)
{
    Console.WriteLine("Wrong or missing password.");
}
catch (InvalidFormatException)
{
    Console.WriteLine("File is corrupt or unsupported.");
}
catch (GroupDocsMarkdownException ex)
{
    Console.WriteLine($"Conversion failed: {ex.Message}");
}
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "error-handling-example.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/error-handling/ErrorHandlingExample/error-handling-example.md)
{{< /tab >}}
{{< /tabs >}}

### Exception types

| Exception | When thrown |
|---|---|
| `DocumentProtectedException` | Document is password-protected and no password or wrong password was provided |
| `InvalidFormatException` | File is corrupt or has an unrecognized format |
| `GroupDocsMarkdownException` | General conversion error |

### Conversion warnings

Non-fatal issues are reported via `ConvertResult.Warnings`:

{{< tabs "warnings-example">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

using var converter = new MarkdownConverter("cost-analysis.xlsx");
ConvertResult result = converter.Convert("warnings-example.md", new ConvertOptions { MaxRows = 10 });

foreach (string warning in result.Warnings)
    Console.WriteLine($"Warning: {warning}");
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "warnings-example.md" >}}  
```text
## Summary

| Category | FY2024 | FY2025 | FY2026 |
| --- | --- | --- | --- |
| Parts and materials | $1,325,000.00 | $1,480,000.00 | $1,620,000.00 |
| Manufacturing equipment | $900,500.00 | $980,000.00 | $1,050,000.00 |
| Warehousing | $420,000.00 | $510,000.00 | $590,000.00 |
| Shipping | $380,000.00 | $445,000.00 | $520,000.00 |
| Marketing | $250,000.00 | $340,000.00 | $480,000.00 |
| R&D | $180,000.00 | $230,000.00 | $310,000.00 |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/error-handling/WarningsExample/warnings-example.md)
{{< /tab >}}
{{< /tabs >}}

---

## Error handling

Path: /markdown/python-net/error-handling/


All conversion methods raise exceptions on failure. Use standard try/except with specific exception types:

{{< tabs "error-handling-example">}}
{{< tab "error_handling_example.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter
from groupdocs.markdown import DocumentProtectedException, InvalidFormatException, GroupDocsMarkdownException

def error_handling_example():
    """Demonstrate error handling with specific exception types during conversion."""

    try:
        # Step 1: Attempt to convert the document
        MarkdownConverter.to_file("annual-report.docx", "error-handling.md")
    except DocumentProtectedException:
        # Step 2a: Handle password-protected documents
        print("Wrong or missing password.")
    except InvalidFormatException:
        # Step 2b: Handle corrupt or unsupported file formats
        print("File is corrupt or unsupported.")
    except GroupDocsMarkdownException as ex:
        # Step 2c: Handle any other conversion errors
        print(f"Conversion failed: {ex}")

if __name__ == "__main__":
    error_handling_example()
```
{{< /tab >}}
{{< tab "annual-report.docx" >}}  
{{< tab-text >}}
`annual-report.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/annual-report.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "error-handling.txt" >}}  
{{< tab-text >}}
Output produced by this example ([download](/markdown/python-net/_output_files/developer-guide/advanced-usage/error-handling/error_handling_example/error-handling.txt)):
````
[queryEmployees]

Employee Information for Employee [EmployeeID]: [FirstName] [LastName]


# Employee Information


| Job Title |  AUTOTEXTLIST  \t "<wr:out select='${varName1.Title}'/>" [Title] |
| --- | --- |
...
````
{{< /tab-text >}}
{{< /tab >}}
{{< tab "error-handling.txt" >}}  
{{< tab-text >}}
Output produced by this example ([download](/markdown/python-net/_output_files/developer-guide/advanced-usage/error-handling/error_handling_example/error-handling.txt)):
<pre><code>[queryEmployees]

Employee Information for Employee [EmployeeID]: [FirstName] [LastName]


# Employee Information


| Job Title |  AUTOTEXTLIST  \t &quot;&lt;wr:out select='${varName1.Title}'/&gt;&quot; [Title] |
| --- | --- |
...</code></pre>
{{< /tab-text >}}
{{< /tab >}}
{{< tab "error-handling.txt" >}}  
```text
[queryEmployees]

Employee Information for Employee [EmployeeID]: [FirstName] [LastName]


# Employee Information


| Job Title |  AUTOTEXTLIST  \t "<wr:out select='${varName1.Title}'/>" [Title] |
| --- | --- |
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/error-handling/error_handling_example/error-handling.txt)
{{< /tab >}}
{{< tab "error-handling.txt" >}}  
```text
[queryEmployees]

Employee Information for Employee [EmployeeID]: [FirstName] [LastName]


# Employee Information


| **Job Title** | **[Title]** |
| --- | --- |
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/error-handling/error_handling_example/error-handling.txt)
{{< /tab >}}
{{< /tabs >}}

### Exception types

| Exception | When raised |
|---|---|
| `DocumentProtectedException` | Document is password-protected and no password or wrong password was provided |
| `InvalidFormatException` | File is corrupt or has an unrecognized format |
| `GroupDocsMarkdownException` | General conversion error |

### Conversion warnings

Non-fatal issues are reported via `ConvertResult.warnings`:

{{< tabs "warnings-example">}}
{{< tab "warnings_example.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions

def warnings_example():
    """Show how to inspect non-fatal conversion warnings after converting."""

    # Step 1: Open the spreadsheet with a context manager
    with MarkdownConverter("cost-analysis.xlsx") as converter:
        # Step 2: Configure row truncation
        options = ConvertOptions()
        options.max_rows = 10  # limit to first 10 data rows per sheet

        # Step 3: Convert using keyword argument for options
        result = converter.convert("warnings.md", convert_options=options)

        # Step 4: Inspect non-fatal warnings (e.g., truncation notices)
        for warning in result.warnings:
            print(f"Warning: {warning}")

if __name__ == "__main__":
    warnings_example()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "warnings.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
...
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/error-handling/warnings_example/warnings.txt)
{{< /tab >}}
{{< tab "warnings.txt" >}}  
```text
## Cost data and chart

|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
|  |  | Cost Analysis |  |  |  |  |  |
|  |  | PARETO CHART |  |  |  |  |  |
|  |  | COST ANALYSIS |  |  |  |  | COST CENTER |
|  |  | Cost center | Annual cost  | Percent of total | Cumulative percent |  |  |
|  |  | Parts and materials | $1,325,000.00  | 31.17% | 31.17% |  |  |
|  |  | Manufacturing equipment | $900,500.00  | 21.19% | 52.36% |  |  |
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/error-handling/warnings_example/warnings.txt)
{{< /tab >}}
{{< /tabs >}}

---

## Errors and Exceptions

Path: /parser/python-net/errors-and-exceptions/


GroupDocs.Parser raises exceptions from `groupdocs.parser.exceptions` for invalid inputs, unsupported formats, and access issues. Catch these exceptions to provide clear feedback and retry logic.

## Handle unsupported formats
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.exceptions import UnsupportedDocumentFormatException

try:
    with Parser("./unknown.xyz") as parser:
        reader = parser.get_text()
        print(reader if reader else "No text available.")
except Exception as e:
    print(e)
```

{{< /tab >}}
{{< /tabs >}}

## Troubleshooting checklist

- Confirm the file path exists and is readable by the current user.  
- If the document is password-protected, provide the password via `LoadOptions`.  
- For image-heavy PDFs on Linux, install `libgdiplus` and font packages.  
- Review the [API reference](https://reference.groupdocs.com/parser/python-net/) for method-specific exceptions and option requirements.  
- Check [system requirements]({{< ref "parser/python-net/system-requirements.md" >}}) and ensure the correct .NET runtime is installed.




---

## Extract metadata from documents

Path: /parser/java/extract-metadata-from-documents/

GroupDocs.Parser allows to extract basic metadata from documents of various formats: PDF, Emails, Ebooks, Microsoft Office: Word (DOC, DOCX), PowerPoint (PPT, PPTX), Excel (XLS, XLSX), LibreOffice formats and many others (see full list at [supported document formats]({{< ref "parser/java/getting-started/supported-document-formats.md" >}}) article).

# Extract metadata from documents

To extract metadata from documents simply call the [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method:

```java
Iterable<MetadataItem> getMetadata();
```

This method returns a collection of [MetadataItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/MetadataItem) objects with following members:

| Member | Description |
| --- | --- |
| [getName](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/MetadataItem#getName()) | The name of the metadata item |
| [getValue](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/MetadataItem#getValue()) | The value of the metadata item |

Here are the steps to extract metadata from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getMetadata()) method and obtain collection of document metadata objects;
*   Check if *collection* isn't *null* (metadata extraction is supported for the document);
*   Iterate through the collection and get metadata names and values.  

The following example shows how to extract metadata from a document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Extract metadata from the document
    Iterable<MetadataItem> metadata = parser.getMetadata();
    // Check if metadata extraction is supported
    if (metadata == null) {
        System.out.println("Metatada extraction isn't supported");
    }
    // Iterate over metadata items
    for (MetadataItem item : metadata) {
        // Print an item name and value
        System.out.println(String.format("%s: %s", item.getName(), item.getValue()));
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract metadata from documents

Path: /parser/net/extract-metadata-from-documents/

GroupDocs.Parser allows to extract basic metadata (document properties, file information) from documents of various formats: PDF, Emails, Ebooks, Microsoft Office: Word (DOC, DOCX), PowerPoint (PPT, PPTX), Excel (XLS, XLSX), LibreOffice formats and many others.

{{< alert style="info" >}}
**Supported Formats:** For a complete list of formats that support metadata extraction, see the [Supported Document Formats]({{< ref "parser/net/getting-started/supported-document-formats.md" >}}) page.
{{< /alert >}}

## Extract metadata from documents

To extract metadata from documents simply call the [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method:

```csharp
IEnumerable<MetadataItem> GetMetadata();

```

This method returns a collection of [MetadataItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/metadataitem) objects with following members:

| Member | Description |
| --- | --- |
| [Name](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/metadataitem/properties/name) | The name of the metadata item |
| [Value](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/metadataitem/properties/value) | The value of the metadata item |

Here are the steps to extract metadata from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetMetadata](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getmetadata) method and obtain collection of document metadata objects;
*   Iterate through the collection and get metadata names and values.

The following example shows how to extract metadata from a document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract metadata from the document
    IEnumerable<MetadataItem> metadata = parser.GetMetadata();
    // Check if metadata extraction is supported
    if (metadata == null)
    {
        Console.WriteLine("Metadata extraction isn't supported");
        return;
    }

    // Iterate over metadata items
    foreach (MetadataItem item in metadata)
    {
        // Print an item name and value
        Console.WriteLine(string.Format("{0}: {1}", item.Name, item.Value));
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online metadata extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract metadata from your documents with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract Metadata from Documents

Path: /parser/python-net/extract-metadata-from-documents/


GroupDocs.Parser extracts metadata such as author, title, creation date, and custom properties from supported formats (see [supported formats]({{< ref "parser/python-net/supported-document-formats.md" >}})).

## Extract metadata
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("./sample.pdf") as parser:
    metadata_items = parser.get_metadata()
    if metadata_items is None:
        print("Metadata extraction is not supported for this format.")
    else:
        for item in metadata_items:
            print(f"{item.name}: {item.value}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-metadata-from-documents/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Steps

1. Create a `Parser` for the target document.  
2. Call `get_metadata()` to receive a collection of metadata items.  
3. Iterate through `name` and `value` pairs and process them as needed.

For deeper parsing (attachments, text, images), combine metadata extraction with other basic usage topics.
---
id: extract-metadata-from-documents
url: parser/python-net/extract-metadata-from-documents
title: Extract Metadata from Documents
weight: 7
version: 25.12
description: "Extract metadata (author, title, custom properties) from PDF, Office, images, emails, and other formats using GroupDocs.Parser for Python via .NET."
productName: GroupDocs.Parser for Python via .NET
hideChildren: false
toc: true
tags: python, parser, metadata, document-properties, v25.12
---

GroupDocs.Parser extracts metadata such as author, title, creation date, and custom properties from supported formats (see [supported formats]({{< ref "parser/python-net/supported-document-formats.md" >}})).

## Extract metadata
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("./sample.pdf") as parser:
    metadata_items = parser.get_metadata()
    if metadata_items is None:
        print("Metadata extraction is not supported for this format.")
    else:
        for item in metadata_items:
            print(f"{item.name}: {item.value}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-metadata-from-documents/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Steps

1. Create a `Parser` for the target document.  
2. Call `get_metadata()` to receive a collection of metadata items.  
3. Iterate through `name` and `value` pairs and process them as needed.

For deeper parsing (attachments, text, images), combine metadata extraction with other basic usage topics.




---

## Extract pages

Path: /merger/net/extract-pages/

**GroupDocs.Merger** allows to extract pages from source document. The result is a new document that contains only specified pages from the source document.

Here are the steps to extract document pages:

*   Initialize [ExtractOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/extractoptions) class with page numbers that should appear in the resultant document;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [ExtractPages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/extractpages) method and pass [ExtractOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/extractoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to extract document pages **by specifying exact page numbers**:

```csharp
string filePath = @"c:\sample.pdf";
string filePathOut = @"c:\output\result.pdf";

ExtractOptions extractOptions = new ExtractOptions(new int[] { 1, 4 }); // Resultant document will contain pages 1 and 4

using (Merger merger = new Merger(filePath))
{
    merger.ExtractPages(extractOptions);
    merger.Save(filePathOut);
}
```

The following code sample demonstrates how to extract document pages **by specifying page numbers range**:

```csharp
string filePath = @"c:\sample.pdf";
string filePathOut = @"c:\output\result.pdf";

ExtractOptions extractOptions = new ExtractOptions(1, 3, RangeMode.EvenPages); // Resultant document will contain page 2
using (Merger merger = new Merger(filePath))
{
	merger.ExtractPages(extractOptions);
    merger.Save(filePathOut);
}
```

---

## Extract text areas

Path: /parser/java/extract-text-areas/

GroupDocs.Parser provides the functionality to extract text areas from documents by the following methods:

```java
Iterable<PageTextArea> getTextAreas();
Iterable<PageTextArea> getTextAreas(PageTextAreaOptions options);
Iterable<PageTextArea> getTextAreas(int pageIndex);
Iterable<PageTextArea> getTextAreas(int pageIndex, PageTextAreaOptions options);
```

The methods return a collection of [PageTextArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea) objects:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getText()) | The value of the text area. |
| [getBaseLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getBaseLine()) | The base line of the text area. |
| [getTextStyle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getTextStyle()) | The text style of the text area. |
| [getAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getAreas()) | The collection of child text areas. |

Text area represents a rectangular page area with a text. Text area can be simple or composite. The simple text area contains only a text and [getAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getAreas()) property is always an empty collection (not null). The composite text area doesn't have its own text. Text property is calculated by its children texts which are contained in [getAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getAreas()) property.

## Extract text areas

Here are the steps to extract text areas from the whole document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getTextAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getTextAreas()) method and obtain collection of [PageTextArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea) objects;
*   Check if *collection* isn't null (text areas extraction is supported for the document);
*   Iterate through the collection and get rectangles and text.

The following example shows how to extract all text areas from the whole document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Extract text areas
    Iterable<PageTextArea> areas = parser.getTextAreas();
    // Check if text areas extraction is supported
    if (areas == null) {
        System.out.println("Page text areas extraction isn't supported");
        return;
    }
    // Iterate over page text areas
    for (PageTextArea a : areas) {
        // Print a page index, rectangle and text area value:
        System.out.println(String.format("Page: %d, R: %s, Text: %s", a.getPage().getIndex(), a.getRectangle(), a.getText()));
    }
}
```

## Extract text areas from a document page

Here are the steps to extract text areas from the document page:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [isTextAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isTextAreas())  property to check if text areas extraction is supported for the document;
*   Call [getTextAreas(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getTextAreas(int)) method with the page index and obtain collection of [PageTextArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea) objects;
*   Check if *collection* isn't *null* (text areas extraction is supported for the document);
*   Iterate through the collection and get rectangles and text.

The following example shows how to extract text areas from a document page:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Check if the document supports text areas extraction
    if (!parser.getFeatures().isTextAreas()) {
        System.out.println("Document isn't supports text areas extraction.");
        return;
    }
    // Get the document info
    IDocumentInfo documentInfo = parser.getDocumentInfo();
    // Check if the document has pages
    if (documentInfo.getPageCount() == 0) {
        System.out.println("Document hasn't pages.");
        return;
    }
    // Iterate over pages
    for (int pageIndex = 0; pageIndex < documentInfo.getPageCount(); pageIndex++) {
        // Print a page number
        System.out.println(String.format("Page %d/%d", pageIndex + 1, documentInfo.getPageCount()));
        // Iterate over page text areas
        // We ignore null-checking as we have checked text areas extraction feature support earlier
        for (PageTextArea a : parser.getTextAreas(pageIndex)) {
            // Print a rectangle and text area value:
            System.out.println(String.format("R: %s, Text: %s", a.getRectangle(), a.getText()));
        }
    }
}
```

## Extract text areas with options

[PageTextAreaOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageTextAreaOptions) parameter is used to customize text areas extraction process. This class has the following members:

| Member | Description |
| --- | --- |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageAreaOptions#getRectangle()) | The rectangular area that contains a text area. |
| [getExpression](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageTextAreaOptions#getExpression()) | The regular expression. |
| [isMatchCase](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageTextAreaOptions#isMatchCase()) | The value that indicates whether a text case isn't ignored. |
| [isUniteSegments](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageTextAreaOptions#isUniteSegments()) | The value that indicates whether segments are united. |
| [isIgnoreFormatting](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageTextAreaOptions#isIgnoreFormatting()) | The value that indicates whether text formatting is ignored. |

Here are the steps to extract text areas from the upper-left corner:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [PageTextAreaOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/PageTextAreaOptions) with the rectangular area;
*   Call [getTextAreas(int, PageTextAreaOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getTextAreas(int,%20com.groupdocs.parser.options.PageTextAreaOptions)) method and obtain collection of [PageTextArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea) objects;
*   Check if *collection* isn't *null* (text areas extraction is supported for the document);
*   Iterate through the collection and get rectangles and text.

The following example shows how to extract only text areas with digits from the upper-left corner:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Create the options which are used for text area extraction
    PageTextAreaOptions options = new PageTextAreaOptions("\\s[a-z]{2}\\s", new Rectangle(new Point(0, 0), new Size(300, 100)));
    // Extract text areas which contain only digits from the upper-left corner of a page:
    Iterable<PageTextArea> areas = parser.getTextAreas(options);
    // Check if text areas extraction is supported
    if (areas == null) {
        System.out.println("Page text areas extraction isn't supported");
        return;
    }
    // Iterate over page text areas
    for (PageTextArea a : areas) {
        // Print a page index, rectangle and text area value:
        System.out.println(String.format("Page: %d, R: %s, Text: %s", a.getPage().getIndex(), a.getRectangle(), a.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text areas

Path: /parser/net/extract-text-areas/

GroupDocs.Parser provides the functionality to extract text areas from documents by the following methods:

```csharp
IEnumerable<PageTextArea> GetTextAreas();
IEnumerable<PageTextArea> GetTextAreas(PageTextAreaOptions options);
IEnumerable<PageTextArea> GetTextAreas(int pageIndex);
IEnumerable<PageTextArea> GetTextAreas(int pageIndex, PageTextAreaOptions options);
```

The methods return a collection of [PageTextArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area. |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/text) | The value of the text area. |
| [BaseLine](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/baseline) | The base line of the text area. |
| [TextStyle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/textstyle) | The text style of the text area. |
| [Areas](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/areas) | The collection of child text areas. |

Text area represents a rectangular page area with a text. Text area can be simple or composite. The simple text area contains only a text and [Areas](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/areas) property is always an empty collection (not null). The composite text area doesn't have its own text. Text property is calculated by its children texts which are contained in [Areas](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/areas) property.

## Extract text areas

Here are the steps to extract text areas from the whole document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetTextAreas](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettextareas) method and obtain collection of [PageTextArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea) objects;
*   Check if *collection* isn't *null* (text areas extraction is supported for the document);
*   Iterate through the collection and get rectangles and text.

The following example shows how to extract all text areas from the whole document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Extract text areas
    IEnumerable<PageTextArea> areas = parser.GetTextAreas();
    // Check if text areas extraction is supported
    if(areas == null)
    {
        Console.WriteLine("Page text areas extraction isn't supported");
        return;
    }

    // Iterate over page text areas
    foreach(PageTextArea a in areas)
    {
        // Print a page index, rectangle and text area value:
        Console.WriteLine(string.Format("Page: {0}, R: {1}, Text: {2}", a.Page.Index, a.Rectangle, a.Text));
    }
}
```

## Extract text areas from a document page

Here are the steps to extract text areas from a document page:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [Features.TextAreas](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/textareas) property to check if text areas extraction is supported for the document;
*   Call [GetTextAreas(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettextareas/methods/2) method with the page index and obtain collection of [PageTextArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea) objects;
*   Check if *collection* isn't *null* (text areas extraction is supported for the document);
*   Iterate through the collection and get rectangles and text.

The following example shows how to extract text areas from a document page:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Check if the document supports text areas extraction
    if(!parser.Features.TextAreas)
    {
        Console.WriteLine("Document isn't supports text areas extraction.");
        return;
    }

    // Get the document info
    IDocumentInfo documentInfo = parser.GetDocumentInfo();
    // Check if the document has pages
    if(documentInfo.PageCount == 0)
    {
        Console.WriteLine("Document hasn't pages.");
        return;
    }

    // Iterate over pages
    for(int pageIndex = 0; pageIndex < documentInfo.PageCount; pageIndex++)
    {
        // Print a page number 
        Console.WriteLine(string.Format("Page {0}/{1}", pageIndex + 1, documentInfo.PageCount));

        // Iterate over page text areas
        // We ignore null-checking as we have checked text areas extraction feature support earlier
        foreach(PageTextArea a in parser.GetTextAreas(pageIndex))
        {
            // Print a rectangle and text area value:
            Console.WriteLine(string.Format("R: {0}, Text: {1}", a.Rectangle, a.Text));
        }
    }
}
```

## Extract text areas with options

[PageTextAreaOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pagetextareaoptions) parameter is used to customize text areas extraction process. This class has the following members:

| Member | Description |
| --- | --- |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pageareaoptions/properties/rectangle) | The rectangular area that contains a text area. |
| [Expression](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pagetextareaoptions/properties/expression) | The regular expression. |
| [MatchCase](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pagetextareaoptions/properties/matchcase) | The value that indicates whether a text case isn't ignored. |
| [UniteSegments](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pagetextareaoptions/properties/unitesegments) | The value that indicates whether segments are united. |
| [IgnoreFormatting](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pagetextareaoptions/properties/ignoreformatting) | The value that indicates whether text formatting is ignored. |

Here are the steps to extract text areas from the upper-left corner:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [PageTextAreaOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/pagetextareaoptions) with the rectangular area;
*   Call [GetTextAreas(int, PageTextAreaOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettextareas/methods/3) method and obtain collection of [PageTextArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea) objects;
*   Check if *collection* isn't *null* (text areas extraction is supported for the document);
*   Iterate through the collection and get rectangles and text.

The following example shows how to extract only text areas with digits from the upper-left corner:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Create the options which are used for text area extraction
    PageTextAreaOptions options = new PageTextAreaOptions("[0-9]+", new Rectangle(new Point(0, 0), new Size(300, 100)));

    // Extract text areas which contain only digits from the upper-left corner of a page:
    IEnumerable<PageTextArea> areas = parser.GetTextAreas(options);
    // Check if text areas extraction is supported
    if(areas == null)
    {
        Console.WriteLine("Page text areas extraction isn't supported");
        return;
    }

    // Iterate over page text areas
    foreach(PageTextArea a in areas)
    {
        // Print a page index, rectangle and text area value:
        Console.WriteLine(string.Format("Page: {0}, R: {1}, Text: {2}", a.Page.Index, a.Rectangle, a.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text areas

Path: /parser/python-net/extract-text-areas/


GroupDocs.Parser provides functionality to extract text areas with position information (coordinates) and formatting details from documents.

## Prerequisites

- GroupDocs.Parser for Python via .NET installed
- Sample documents for testing
- Understanding of coordinate systems in documents

## What are text areas?

Text areas represent rectangular regions on a page containing text. Each text area includes:

- **Page index:** The page where the text appears
- **Rectangle:** Position and size (x, y, width, height)
- **Text:** The actual text content
- **Baseline:** The baseline position of the text
- **Text style:** Formatting information (font, size, etc.)
- **Child areas:** For composite text areas

## Extract text areas from document

To extract all text areas from a document:
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Extract text areas
    text_areas = parser.get_text_areas()
    
    # Check if text areas extraction is supported
    if text_areas is None:
        print("Text areas extraction isn't supported")
    else:
        # Iterate over text areas
        for area in text_areas:
            # Print page index, rectangle, and text
            print(f"Page: {area.page.index}, Rectangle: {area.rectangle}, Text: {area.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-areas/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns a collection of `PageTextArea` objects with position and text information for each text area in the document.

## Extract text areas from document page

To extract text areas from a specific page:
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Check if text areas extraction is supported
    if not parser.features.text_areas:
        print("Document doesn't support text areas extraction")
        return
    
    # Get document info
    info = parser.get_document_info()
    
    # Check if document has pages
    if info.page_count == 0:
        print("Document has no pages")
        return
    
    # Iterate over pages
    for page_index in range(info.page_count):
        print(f"
Page {page_index + 1}/{info.page_count}")
        
        # Extract text areas from the page
        text_areas = parser.get_text_areas(page_index)
        
        # Iterate over text areas
        if text_areas:
            for area in text_areas:
                # Print rectangle and text
                rect = area.rectangle
                print(f"Position: ({rect.left}, {rect.top}), Size: ({rect.width}x{rect.height})")
                print(f"Text: {area.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-areas/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns text areas only for the specified page, allowing page-by-page processing.

## Extract text areas with options

To extract text areas from a specific region with filtering:
{{< tabs "example-3" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTextAreaOptions, Rectangle, Point, Size

# Create an instance of Parser class
with Parser("./sample.pdf") as parser:
    # Define the region (upper-left corner, 300x100 pixels)
    region = Rectangle(Point(0, 0), Size(300, 100))
    
    # Create options to extract only text areas with digits in the specified region
    options = PageTextAreaOptions(r"\d+", region)
    
    # Extract text areas
    text_areas = parser.get_text_areas(options)
    
    if text_areas is None:
        print("Text areas extraction isn't supported")
    else:
        # Iterate over filtered text areas
        for area in text_areas:
            print(f"Page: {area.page.index}, Rectangle: {area.rectangle}, Text: {area.text}")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-areas/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Returns only text areas that match the regular expression pattern and fall within the specified rectangular region.

## Extract text areas with formatting

To extract text areas and access formatting information:
{{< tabs "example-4" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

# Create an instance of Parser class
with Parser("./sample.docx") as parser:
    # Extract text areas
    text_areas = parser.get_text_areas()
    
    if text_areas is None:
        print("Text areas extraction isn't supported")
    else:
        # Iterate over text areas
        for area in text_areas:
            # Get text style if available
            if area.text_style:
                print(f"Text: {area.text}")
                print(f"Font: {area.text_style.name}")
                print(f"Size: {area.text_style.font_size}")
                print(f"Bold: {area.text_style.is_bold}")
                print(f"Italic: {area.text_style.is_italic}")
                print("---")
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-areas/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

**Expected behavior:** Extracts text areas with detailed formatting information, useful for document analysis.

## Extract specific text from regions

Extract text from multiple predefined regions:
{{< tabs "example-5" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.options import PageTextAreaOptions, Rectangle, Point, Size

def extract_from_regions(file_path, regions):
    """
    Extract text from specific regions of a document.
    
    Args:
        file_path: Path to the document
        regions: List of tuples (x, y, width, height)
    """
    with Parser(file_path) as parser:
        if not parser.features.text_areas:
            print("Text areas extraction not supported")
            return {}
        
        results = {}
        
        for idx, (x, y, w, h) in enumerate(regions):
            # Create rectangle for this region
            rect = Rectangle(Point(x, y), Size(w, h))
            options = PageTextAreaOptions(None, rect)
            
            # Extract text areas from this region
            areas = parser.get_text_areas(options)
            
            # Collect text from all areas in this region
            text_list = [area.text for area in areas] if areas else []
            results[f"region_{idx}"] = " ".join(text_list)
        
        return results

# Define regions (e.g., header, body, footer)
regions = [
    (0, 0, 600, 100),      # Header region
    (0, 100, 600, 700),    # Body region
    (0, 800, 600, 100)     # Footer region
]

# Extract text from regions
extracted = extract_from_regions("sample.pdf", regions)
for region_name, text in extracted.items():
    print(f"{region_name}: {text[:100]}...")
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/parser/python-net/_sample_files/developer-guide/advanced-usage/extraction/extract-text-areas/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Notes

- Text area extraction is more detailed than simple text extraction
- Not all document formats support text area extraction - check `parser.features.text_areas` first
- Coordinates are in document-specific units (usually points or pixels)
- Composite text areas contain child text areas in the `areas` property
- Use regular expressions in `PageTextAreaOptions` to filter text areas by content
- Rectangle coordinates start from the top-left corner (0, 0)

## Related pages

- [Extract text in Accurate mode]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-in-accurate-mode" >}})
- [Search text in documents]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/search-text" >}})
- [Extract text structure]({{< ref "parser/python-net/developer-guide/advanced-usage/extraction/extract-text-structure" >}})


---

## Generate document pages preview

Path: /merger/java/generate-document-pages-preview/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) provides [PreviewOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/PreviewOptions) class to specify different options to manage preview of document pages.  
  
Here are the steps to generate document preview with GroupDocs.Merger:
*   Create new instance of [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) class and pass source document path as a constructor parameter.    
*   Instantiate the [PreviewOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/PreviewOptions) object with:    
    *   delegate for each page output stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.common/CreatePageStream));         
    *   image preview format - PNG / JPG / BMP;        
    *   page numbers to process;        
    *   custom size of preview images (if needed).           
{{< alert style="info" >}}
OutputStream that were created by [CreatePageStream](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.common/CreatePageStream) delegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument [ReleasePageStream](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.common/ReleasePageStream) to clean up resources.
{{< /alert >}}
*   Call [generatePreview](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#generatePreview(com.groupdocs.merger.domain.options.interfaces.IPreviewOptions)) method of [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) class instance and pass [PreviewOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/PreviewOptions) to it.
    

## CreatePageStream delegate implementation

GroupDocs.Merger expects [CreatePageStream](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.common/CreatePageStream) delegate to obtain each page stream for image preview generation process

```java
private static OutputStream createPageStream(int pageNumber)
{
    try{
        String imageFilePath = new File("GeneratePreviewFolder", "image-" + pageNumber + ".jpg").getPath();
        return new FileOutputStream(imageFilePath);
    }catch (Exception e){
        throw new GroupDocsException(e.getMessage());
    }
}
```

## ReleasePageStream delegate implementation

```java
private static void releasePageStream(int pageNumber, OutputStream pageStream) 
{
    try {
        pageStream.close();
        String imageFilePath = new File("GeneratePreviewFolder", "image-" + pageNumber + ".jpg").getPath();
        System.out.print("Image file "+imageFilePath+" is ready for preview.");
    }catch (Exception e){
        throw new GroupDocsException(e.getMessage());
    }
}
```

## Generate document preview from file on local disk

```java
public static void getPreview()
{   
 	string filePath = "c:\sample.xlsx";
    Merger merger = new Merger(filePath);

	IPreviewOptions previewOption = new PreviewOptions(new CreatePageStream() {
    	@Override
    	public OutputStream invoke(int pageNumber) {
        	return createPageStream(pageNumber);
    	}
	}, PreviewMode.JPEG);
	merger.generatePreview(previewOption);
}
 
private static OutputStream createPageStream(int pageNumber)
{
    try{
        String imageFilePath = new File("GeneratePreviewFolder", "image-" + pageNumber + ".jpg").getPath();
        return new FileOutputStream(imageFilePath);
    }catch (Exception e){
        throw new GroupDocsException(e.getMessage());
    }

}
```

## Generate document preview from stream with custom stream releasing delegate

```java
public static void getPreview()
{
    string filePath = "c:\sample.xlsx";
	Merger merger = new Merger(filePath);

	IPreviewOptions previewOption = new PreviewOptions(new CreatePageStream() {
 	   @Override
	    public OutputStream invoke(int pageNumber) {
 	       return createPageStream(pageNumber);
 	   }
	}, new ReleasePageStream() {
	    @Override
  	  public void invoke(int pageNumber, OutputStream pageStream) {
  	      releasePageStream(pageNumber, pageStream);
  	  }
	}, PreviewMode.JPEG);
	merger.generatePreview(previewOption);
}
 

private static OutputStream createPageStream(int pageNumber)
{
    try{
        String imageFilePath = new File("GeneratePreviewFolder", "image-" + pageNumber + ".jpg").getPath();
        return new FileOutputStream(imageFilePath);
    }catch (Exception e){
        throw new GroupDocsException(e.getMessage());
    }

}

private static void releasePageStream(int pageNumber, OutputStream pageStream)
{
    try {
        pageStream.close();
        String imageFilePath = new File("GeneratePreviewFolder", "image-" + pageNumber + ".jpg").getPath();
        System.out.print("Image file "+imageFilePath+" is ready for preview.");
    }catch (Exception e){
        throw new GroupDocsException(e.getMessage());
    }
}
private static String getImagePath(int pageNumber)
{
    return Constants.OutputPath +"GeneratePreview\\image-"+pageNumber+".jpg";
}
```

{{< alert style="info" >}}
NOTE: Stream that was created over [CreatePageStream](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.common/CreatePageStream) delegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument [ReleasePageStream](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.common/ReleasePageStream)to clean up resources.
{{< /alert >}}

---

## Generate document pages preview

Path: /merger/net/generate-document-pages-preview/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** provides [PreviewOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/previewoptions) class to specify different options to manage preview of document pages.  
  
Here are the steps to generate document preview with GroupDocs.Merger:
*   Create new instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source document path as a constructor parameter.    
*   Instantiate the [PreviewOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/previewoptions) object with:    
    *   delegate for each page stream creation (see event handler [CreatePageStream](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.common/createpagestream));         
    *   image preview format - PNG / JPG / BMP;        
    *   page numbers to process;        
    *   custom size of preview images (if needed).           
{{< alert style="info" >}} 
Stream that were created by [CreatePageStream](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.common/createpagestream) delegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument [ReleasePageStream](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.common/releasepagestream) to clean up resources.  
{{< /alert >}}     
*   Call [GeneratePreview](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/generatepreview) method of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class instance and pass [PreviewOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/previewoptions) to it.
    

## CreatePageStream delegate implementation

GroupDocs.Merger expects [CreatePageStream](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.common/createpagestream) delegate to obtain each page stream for image preview generation process

```csharp
private static Stream CreatePageStream(int pageNumber)
{
    string imageFilePath = Path.Combine("GeneratePreviewFolder", "image-" + pageNumber.ToString() + ".jpg");
    var folder = Path.GetDirectoryName(imageFilePath);
    if(!Directory.Exists(folder))
    {
        Directory.CreateDirectory(folder);
    }
    return new System.IO.FileStream(imageFilePath, FileMode.Create);
}
```

## ReleasePageStream delegate implementation

```csharp
private static void ReleasePageStream(int pageNumber, Stream pageStream)
{
     pageStream.Dispose();
     string imageFilePath = Path.Combine("GeneratePreviewFolder", "image-" + pageNumber.ToString() + ".jpg");
     Console.WriteLine("Image file {0} is ready for preview", imageFilePath);
}
```

## Generate document preview from file on local disk

```csharp
public static void GetPreview()
{   
    string filePath = @"c:\sample.xlsx";
    using (Merger merger = new Merger(filePath))
    {
        IPreviewOptions previewOption = new PreviewOptions(CreatePageStream, PreviewMode.JPEG);
        merger.GeneratePreview(previewOption);
    }
}
 
private static Stream CreatePageStream(int pageNumber)
{
    string imageFilePath = Path.Combine("GeneratePreviewFolder", "image-" + pageNumber.ToString() + ".jpg");
    var folder = Path.GetDirectoryName(imageFilePath);
    if(!Directory.Exists(folder))
    {
        Directory.CreateDirectory(folder);
    }
    return new System.IO.FileStream(imageFilePath, FileMode.Create);
}
```

## Generate document preview from stream with custom stream releasing delegate

```csharp
public static void GetPreview()
{
    string filePath = @"c:\sample.xlsx";
    using (Merger merger = new Merger(filePath))
    {
        IPreviewOptions previewOption = new PreviewOptions(CreatePageStream, ReleasePageStream, PreviewMode.JPEG);
        merger.GeneratePreview(previewOption);
    }
}
 
private static Stream CreatePageStream(int pageNumber)
{
    string imageFilePath = Path.Combine("GeneratePreviewFolder", "image-" + pageNumber.ToString() + ".jpg");
    var folder = Path.GetDirectoryName(imageFilePath);
    if(!Directory.Exists(folder))
    {
        Directory.CreateDirectory(folder);
    }
    return new System.IO.FileStream(imageFilePath, FileMode.Create);
}

private static void ReleasePageStream(int pageNumber, Stream pageStream)
{
     pageStream.Dispose();
     string imageFilePath = Path.Combine("GeneratePreviewFolder", "image-" + pageNumber.ToString() + ".jpg");
     Console.WriteLine("Image file {0} is ready for preview", imageFilePath);
}
```

{{< alert style="info" >}}
NOTE: Stream that was created over [CreatePageStream](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.common/createpagestream) delegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument [ReleasePageStream](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.common/releasepagestream) to clean up resources.
{{< /alert >}}


---

## Generate Document from XML Data Source

Path: /assembly/net/basic-usage-xml-datasource/


## Overview

GroupDocs.Assembly for .NET provides the `XmlDataSource` class to work with XML data directly in templates. Unlike using DataSet, XmlDataSource automatically recognizes data types (numbers, dates, booleans) from XML, making it easier to perform calculations and formatting.

The main classes involved are:
- [XmlDataSource](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/xmldatasource/) - loads and parses XML data
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [XmlDataLoadOptions](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/xmldataloadoptions/) - configures XML loading behavior

Here are the steps to generate documents from XML:

* Create or obtain XML data (from file, string, or stream)
* Instantiate XmlDataSource with the XML data
* Create a template document with expression tags referencing XML elements
* Use DocumentAssembler to assemble the template with XmlDataSource
* Save the assembled document

{{< alert style="info" >}}
XmlDataSource automatically recognizes Int64, Double, Boolean, and DateTime values from XML strings, enabling numeric operations and date formatting in templates without explicit type conversion.
{{< /alert >}}

## Generate Document from XML File

The simplest way to use XML data is from a file:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromXmlFile()
{
    XmlDataSource xmlDataSource = new XmlDataSource("data.xml");

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(xmlDataSource, "data"));
}
```

## XML File Example

Your XML file (data.xml) might look like this:

```xml
<Person>
    <Name>John Doe</Name>
    <Age>30</Age>
    <Birth>1989-04-01 4:00:00 pm</Birth>
    <Email>john.doe@example.com</Email>
</Person>
```

## Template Example for XML Object

For the XML above, your template can reference elements directly:

```
Name: <<[data.Name]>>
Age: <<[data.Age]>>
Date of Birth: <<[data.Birth]:"dd.MM.yyyy">>
Email: <<[data.Email]>>
```

## Generate Document from XML String

You can also create XmlDataSource from an XML string:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromXmlString()
{
    string xmlString = @"<Person>
        <Name>Jane Smith</Name>
        <Age>28</Age>
        <Birth>1992-01-31 07:00:00 am</Birth>
        <Email>jane.smith@example.com</Email>
    </Person>";
    
    XmlDataSource xmlDataSource = new XmlDataSource(xmlString);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(xmlDataSource, "person"));
}
```

## Working with XML Arrays

When your XML root contains an array of elements, XmlDataSource treats it as a collection:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromXmlArray()
{
    string xmlArray = @"<Persons>
        <Person>
            <Name>John Doe</Name>
            <Age>30</Age>
        </Person>
        <Person>
            <Name>Jane Smith</Name>
            <Age>28</Age>
        </Person>
        <Person>
            <Name>Bob Johnson</Name>
            <Age>35</Age>
        </Person>
    </Persons>";
    
    XmlDataSource xmlDataSource = new XmlDataSource(xmlArray);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(xmlDataSource, "persons"));
}
```

## Template Example for XML Array

For XML arrays, use a foreach data band:

```
<<foreach [in persons]>>
Name: <<[Name]>>, Age: <<[Age]>>
<</foreach>>

Average age: <<[persons.Average(p => p.Age)]>>
```

## Working with Nested XML Elements

XmlDataSource handles nested XML structures automatically:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromNestedXml()
{
    string nestedXml = @"<Company>
        <Name>ABC Corp</Name>
        <Address>
            <Street>123 Main St</Street>
            <City>New York</City>
            <Zip>10001</Zip>
        </Address>
        <Employees>
            <Employee>
                <Name>John Doe</Name>
                <Position>Developer</Position>
            </Employee>
            <Employee>
                <Name>Jane Smith</Name>
                <Position>Manager</Position>
            </Employee>
        </Employees>
    </Company>";
    
    XmlDataSource xmlDataSource = new XmlDataSource(nestedXml);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(xmlDataSource, "company"));
}
```

Template for nested XML:

```
Company: <<[company.Name]>>
Address: <<[company.Address.Street]>>, <<[company.Address.City]>> <<[company.Address.Zip]>>

Employees:
<<foreach [in company.Employees]>>
- <<[Name]>>, <<[Position]>>
<</foreach>>
```

## Configure XML Data Load Options

You can configure how XmlDataSource parses XML:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateWithXmlOptions()
{
    XmlDataLoadOptions options = new XmlDataLoadOptions();
    options.AlwaysGenerateRootObject = true; // Always create root object
    
    XmlDataSource xmlDataSource = new XmlDataSource("data.xml", options);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(xmlDataSource, "data"));
}
```

{{< alert style="warning" >}}
By default, if a root XML element contains only a sequence of elements of one type, the engine skips the root object. Set `AlwaysGenerateRootObject` to true to always include it.
{{< /alert >}}

### Advanced Usage Topics

To learn more about working with XML schemas, complex XML structures, XML attributes, and advanced XmlDataSource options, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Generate signature preview

Path: /signature/java/generate-signature-preview/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [PreviewSignatureOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options/PreviewSignatureOptions) class to specify different options to manage signatures preview generation process.  
  
Here are the steps to generate signature preview with GroupDocs.Signature:

* Instantiate the required [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/SignOptions) object with the settings you want to generate the preview
* Instantiate the [PreviewSignatureOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options/PreviewSignatureOptions) object with:
* delegate for signature stream creation (see interface [PageSignatureStreamFactory](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options/PageSignatureStreamFactory));
* image preview format - PNG / JPG / BMP,
* unique signature identifier.

{{< alert style="info" >}}
Stream that were created by [createSignatureStream](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options/PageSignatureStreamFactory#createSignatureStream(com.groupdocs.signature.options.PreviewSignatureOptions)) delegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument [closeSignatureStream](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options/PageSignatureStreamFactory#createSignatureStream(com.groupdocs.signature.options.PreviewSignatureOptions)) to clean up resources.  
{{< /alert >}}
* Call the static method [generateSignaturePreview](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#generateSignaturePreview(com.groupdocs.signature.options.PreviewSignatureOptions)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) and pass [PreviewSignatureOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options/PreviewSignatureOptions) to it.

## CreateSignatureStream delegate implementation

GroupDocs.Signature expects [createSignatureStream](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options/PageSignatureStreamFactory#createSignatureStream(com.groupdocs.signature.options.PreviewSignatureOptions)) delegate to obtain each signature stream for image preview generation process

```java
private static OutputStream createSignatureStream(PreviewSignatureOptions previewOptions)
    {
        try {
            Path path = Paths.get("C:\\Output\\GenerateSignaturePreviewAdvanced\\");
            if (!Files.exists(path)) {

                Files.createDirectory(path);
                System.out.println("Directory created");
            } else {

                System.out.println("Directory already exists");
            }
            File imageFilePath = new File(path+"\\signature"+previewOptions.getSignatureId()+"-"+previewOptions.getSignOptions().getSignatureType()+".jpg");
            return new FileOutputStream(imageFilePath);
        }catch (Exception e) {
            throw new RuntimeException(e.getMessage());
        }

    }
```

## ReleaseSignatureStream delegate implementation

```java
 private static void releaseSignatureStream(PreviewSignatureOptions previewOptions, OutputStream signatureStream)
    {
        try {
            signatureStream.close();
            String imageFilePath = new File("C:\\Output\\GenerateSignaturePreviewAdvanced\\\\signature"+previewOptions.getSignatureId()+"-"+previewOptions.getSignOptions().getSignatureType()+".jpg").getPath();
            System.out.print("Image file "+imageFilePath+" is ready for preview");
        }catch (Exception e){
            throw new RuntimeException(e.getMessage());
        }
    }
```

## Generate signature preview

```java
public static void GetPreview()
{
    // create options
    QrCodeSignOptions signOptions = new QrCodeSignOptions();
        {
            signOptions.setEncodeType(QrCodeTypes.QR);
                // setup Data property with Address object
            Address address = new Address();
            address.setStreet("221B Baker Street");
            address.setCity("London");
            address.setState("NW");
            address.setZIP("NW16XE");
            address.setCountry("England");
            signOptions.setData(address);
                // set right bottom corner
            signOptions.setHorizontalAlignment(HorizontalAlignment.Left);
            signOptions.setVerticalAlignment(VerticalAlignment.Center);
            signOptions.setWidth(100);
            signOptions.setHeight(100);
            signOptions.setMargin(new Padding(10));
        };

        // create signature preview options object
        PreviewSignatureOptions previewOption = new PreviewSignatureOptions(signOptions, new PageSignatureStreamFactory() {
            @Override
            public OutputStream createSignatureStream(PreviewSignatureOptions previewOptions) {
                return generateSignatureStream(previewOptions);
            }

            @Override
            public void closeSignatureStream(PreviewSignatureOptions previewOptions, OutputStream pageStream) {
                releaseSignatureStream(previewOptions, pageStream);
            }
        });
        previewOption.setSignatureId(UUID.randomUUID().toString());
        previewOption.setPreviewFormat(PreviewFormats.JPEG);

        // generate preview
        Signature.generateSignaturePreview(previewOption);
}

    private static OutputStream generateSignatureStream(PreviewSignatureOptions previewOptions)
    {
        try {
            Path path = Paths.get(Constants.OutputPath, "\\GenerateSignaturePreviewAdvanced\\");
            if (!Files.exists(path)) {

                Files.createDirectory(path);
                System.out.println("Directory created");
            } else {

                System.out.println("Directory already exists");
            }
            File imageFilePath = new File(path+"\\signature"+previewOptions.getSignatureId()+"-"+previewOptions.getSignOptions().getSignatureType()+".jpg");
            return new FileOutputStream(imageFilePath);
        }catch (Exception e) {
            throw new RuntimeException(e.getMessage());
        }
    }

    private static void releaseSignatureStream(PreviewSignatureOptions previewOptions, OutputStream signatureStream)
    {
        try {
            signatureStream.close();
            String imageFilePath = new File(Constants.OutputPath + "\\GeneratePreviewHideSignatures\\signature"+previewOptions.getSignatureId()+"-"+previewOptions.getSignOptions().getSignatureType()+".jpg").getPath();
            System.out.print("Image file "+imageFilePath+" is ready for preview");
        }catch (Exception e){
            throw new RuntimeException(e.getMessage());
        }
    }
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Generate signature preview

Path: /signature/net/generate-signature-preview/

## Overview

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) [PreviewSignatureOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewsignatureoptions) class to specify different options to manage signatures preview generation process.  
  
Here are the steps how to generate signature preview with GroupDocs.Signature:

* Instantiate the required [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with the settings you want to generate the preview
* Instantiate the [PreviewSignatureOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewsignatureoptions) object with:
* delegate for signature stream creation (see event handler [CreateSignatureStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/createsignaturestream));
* image preview format - PNG / JPG / BMP,
* unique signature identifier.

{{< alert style="info" >}}
Stream that were created by [CreateSignatureStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/createsignaturestream) delegate will be disposed automatically once after generation of preview image. If you need to implement custom image preview stream disposing you have to pass additional argument [ReleaseSignatureStream](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/releasesignaturestream) to clean up resources.  
{{< /alert >}}
* Call the static method [GenerateSignaturePreview](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/generatesignaturepreview) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) and pass [PreviewSignatureOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/previewsignatureoptions) to it.

## Generate signature preview

This example demonstrates how to generate a preview image for a QR Code signature using GroupDocs.Signature with default sizes.

```csharp
public static void GetPreview()
{
    // Create QR code sign options
    QrCodeSignOptions signOptions = new QrCodeSignOptions
    {
        EncodeType = QrCodeTypes.QR,
        Data = new GroupDocs.Signature.Domain.Extensions.Address
        {
            Street = "221B Baker Street",
            City = "London",
            State = "NW",
            ZIP = "NW16XE",
            Country = "England"
        },
        HorizontalAlignment = HorizontalAlignment.Left,
        VerticalAlignment = VerticalAlignment.Center,
        Margin = new Padding(10)
    };

    // Create signature preview options
    PreviewSignatureOptions previewOption = new PreviewSignatureOptions(
        signOptions, 
        CreateSignatureStream, 
        ReleaseSignatureStream
    )
    {
        SignatureId = Guid.NewGuid().ToString(),
        PreviewFormat = PreviewSignatureOptions.PreviewFormats.JPEG
    };

    // Generate signature preview
    Signature.GenerateSignaturePreview(previewOption);
}

private static Stream CreateSignatureStream(PreviewSignatureOptions previewOptions)
{
    string imageFilePath = 
        $"signature-{previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name}.jpg";

    return new FileStream(imageFilePath, FileMode.Create);
}

private static void ReleaseSignatureStream(PreviewSignatureOptions previewOptions, 
    Stream signatureStream)
{
    signatureStream.Dispose();
    Console.WriteLine(
        $"Signature {previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name} is ready for preview"
    );
}
```

##  Adaptive rendering for QR Code signature previews

{{< alert style="info" >}}
If the specified width and height are not appropriate for generating a readable QR Code preview, the system will automatically use default size values. These defaults are chosen as the nearest optimal dimensions to ensure the QR Code remains clear and scannable. 
{{< /alert >}}

This example demonstrates how to generate a preview image for a QR Code signature using GroupDocs.Signature. You’ll see how to configure the QR Code’s appearance, including size, color, and text alignment, and how to generate and save the preview image stream.

```csharp
public static void GetPreview()
{
    // Initialize QR Code signing options
    QrCodeSignOptions qrSignOptions = new QrCodeSignOptions("GROUP DOCS", QrCodeTypes.QR)
    {
        Width = 250,                          // Width of the QR code
        Height = 270,                         // Height of the QR code
        ForeColor = Color.Red,                // Color of the QR code
        CodeTextAlignment = CodeTextAlignment.Below, // Text alignment relative to the QR code
        Text = "GROUP DOCS"                   // Text displayed below the QR code
    };

    // Configure preview generation options for the QR code signature
    PreviewSignatureOptions previewOptions = new PreviewSignatureOptions(
        qrSignOptions,
        CreateSignatureStream,   // Delegate to create the stream
        ReleaseSignatureStream   // Delegate to release the stream
    )
    {
        SignatureId = Guid.NewGuid().ToString(),  // Unique identifier for the preview
        PreviewFormat = PreviewSignatureOptions.PreviewFormats.PNG  // Output format of preview
    };

    // Generate the signature preview image
    Signature.GenerateSignaturePreview(previewOptions);
}

private static Stream CreateSignatureStream(PreviewSignatureOptions previewOptions)
{
    string imageFilePath = 
        $"signature-{previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name}.jpg";

    return new FileStream(imageFilePath, FileMode.Create);
}

private static void ReleaseSignatureStream(PreviewSignatureOptions previewOptions, 
    Stream signatureStream)
{
    signatureStream.Dispose();
    Console.WriteLine(
        $"Signature {previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name} is ready for preview"
    );
}
```

##  Adaptive rendering for Barcode signature previews

{{< alert style="info" >}}
When the width and height provided for the Barcode preview are not suitable, the preview generation will fall back to default size values. These defaults are selected to produce a barcode image that is readable and properly rendered.
{{< /alert >}}

This section shows how to create a preview for a Barcode signature. The example covers setting barcode properties such as type, size, and color, as well as generating the preview image with a custom stream handler.

```csharp
public static void GetPreview()
{
    // Initialize QR Code signing options
    BarcodeSignOptions signOptions = new BarcodeSignOptions("GROUP DOCS", BarcodeTypes.MaxiCode)
    {
        Width = 400,                          // Width of the Barcode code
        Height = 400,                         // Height of the Barcode code
        ForeColor = Color.Red,                // Color of the Barcode code
        CodeTextAlignment = CodeTextAlignment.Below, // Text alignment relative to the Barcode code
        Text = "GROUP DOCS"                   // Text displayed below the Barcode code
    };

    // Configure preview generation options for the QR code signature
    PreviewSignatureOptions previewOptions = new PreviewSignatureOptions(
        qrSignOptions,
        CreateSignatureStream,   // Delegate to create the stream
        ReleaseSignatureStream   // Delegate to release the stream
    )
    {
        SignatureId = Guid.NewGuid().ToString(),  // Unique identifier for the preview
        PreviewFormat = PreviewSignatureOptions.PreviewFormats.PNG  // Output format of preview
    };

    // Generate the signature preview image
    Signature.GenerateSignaturePreview(previewOptions);
}

private static Stream CreateSignatureStream(PreviewSignatureOptions previewOptions)
{
    string imageFilePath = 
        $"signature-{previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name}.jpg";

    return new FileStream(imageFilePath, FileMode.Create);
}

private static void ReleaseSignatureStream(PreviewSignatureOptions previewOptions, 
    Stream signatureStream)
{
    signatureStream.Dispose();
    Console.WriteLine(
        $"Signature {previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name} is ready for preview"
    );
}
```

## Rotate Barcode and QR Code previews

This example demonstrates how to apply rotation to Barcode and QR Code signature previews. Rotation can help fit signatures into specific layout requirements or create visual effects.

```csharp
public static void GetPreview()
{
    // Initialize Barcode signing options
    BarcodeSignOptions barcodeSignOptions = new BarcodeSignOptions("GROUP DOCS", BarcodeTypes.MaxiCode)
    {
        Width = 400,                               // Width of the barcode
        Height = 400,                              // Height of the barcode
        ForeColor = Color.Red,                     // Foreground color of the barcode
        CodeTextAlignment = CodeTextAlignment.Below,  // Position of the text relative to the barcode
        Text = "GROUP DOCS",                       // Text displayed with the barcode
        RotationAngle = 45                         // Rotate the barcode by 45 degrees
    };

    // Configure preview generation options for the QR code signature
    PreviewSignatureOptions previewOptions = new PreviewSignatureOptions(
        qrSignOptions,
        CreateSignatureStream,   // Delegate to create the stream
        ReleaseSignatureStream   // Delegate to release the stream
    )
    {
        SignatureId = Guid.NewGuid().ToString(),  // Unique identifier for the preview
        PreviewFormat = PreviewSignatureOptions.PreviewFormats.PNG  // Output format of preview
    };

    // Generate the signature preview image
    Signature.GenerateSignaturePreview(previewOptions);
}

private static Stream CreateSignatureStream(PreviewSignatureOptions previewOptions)
{
    string imageFilePath = 
        $"signature-{previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name}.jpg";

    return new FileStream(imageFilePath, FileMode.Create);
}

private static void ReleaseSignatureStream(PreviewSignatureOptions previewOptions, 
    Stream signatureStream)
{
    signatureStream.Dispose();
    Console.WriteLine(
        $"Signature {previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name} is ready for preview"
    );
}
```

## Transparency for Barcode/QR previews

This snippet shows how to set the transparency level of Barcode or QR Code previews, allowing you to customize the signature's visual blending with the underlying document.

```csharp
public static void GetPreview()
{
    // Initialize barcode signing options with Codabar type
    BarcodeSignOptions barcodeSignOptions = new BarcodeSignOptions("GROUP DOCS", BarcodeTypes.Codabar)
    {
        Width = 400,                               // Width of the barcode preview
        Height = 400,                              // Height of the barcode preview
        ForeColor = Color.Red,                     // Foreground color of the barcode bars
        CodeTextAlignment = CodeTextAlignment.Below,  // Position text below the barcode
        Text = "GROUP DOCS",                       // Text displayed with the barcode
        Transparency = 0.5                         // Set barcode background transparency (50%)
    };

    // Configure preview generation options for the QR code signature
    PreviewSignatureOptions previewOptions = new PreviewSignatureOptions(
        qrSignOptions,
        CreateSignatureStream,   // Delegate to create the stream
        ReleaseSignatureStream   // Delegate to release the stream
    )
    {
        SignatureId = Guid.NewGuid().ToString(),  // Unique identifier for the preview
        PreviewFormat = PreviewSignatureOptions.PreviewFormats.PNG  // Output format of preview
    };

    // Generate the signature preview image
    Signature.GenerateSignaturePreview(previewOptions);
}

private static Stream CreateSignatureStream(PreviewSignatureOptions previewOptions)
{
    string imageFilePath = 
        $"signature-{previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name}.jpg";

    return new FileStream(imageFilePath, FileMode.Create);
}

private static void ReleaseSignatureStream(PreviewSignatureOptions previewOptions, 
    Stream signatureStream)
{
    signatureStream.Dispose();
    Console.WriteLine(
        $"Signature {previewOptions.SignatureId}-" +
        $"{previewOptions.SignOptions.GetType().Name} is ready for preview"
    );
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Get source and target text from files

Path: /comparison/java/get-source-and-target-text-from-files/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to get source and target texts of specific changes in the output file.

To get a list of changed source and target texts, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method.
4.  Call the [getChanges()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getChanges--) method.

The following code snippets show how to get specified texts from a file.

## Get source and target text from local disk

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.result.ChangeInfo;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final Path resultPath = comparer.compare("result.docx");
    ChangeInfo[] changes = comparer.getChanges();
    for (ChangeInfo change : changes) {
        System.out.println();
        System.out.println("Source text: " + change.getSourceText());
        System.out.println("Target text: " + change.getTargetText());
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/get-source-and-target-text-from-files.png)

## Get source and target text from stream

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.result.ChangeInfo;
import java.nio.file.Path;
import java.io.FileInputStream;
import java.io.InputStream;
// ...

try (Comparer comparer = new Comparer(sourceInputStream)) {
    comparer.add(targetInputStream);
    final Path resultPath = comparer.compare("result.docx");
    ChangeInfo[] changes = comparer.getChanges();
    for (ChangeInfo change : changes){
        System.out.println();
        System.out.println("Source text: "+change.getSourceText());
        System.out.println("Target text: "+change.getTargetText());
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Get source and target text from files

Path: /comparison/net/get-source-and-target-text-from-files/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to get source and target texts of specific changes in the output file.

To get a list of changed source and target texts, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare) method.
4.  Call the [GetChanges](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/getchanges) method.

The following code snippets show how to get specified texts from a file.

## Get source and target text from local disk

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Result;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx");
    ChangeInfo[] changes = comparer.GetChanges();
    foreach (ChangeInfo change in changes)
    {
        Console.WriteLine("");
        Console.WriteLine("Source text: " + change.SourceText);
        Console.WriteLine("Target text: " + change.TargetText);
    }
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/get-source-and-target-text-from-files.png)

## Get source and target text from stream

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Result;
using System.IO;
// ...

using (Comparer comparer = new Comparer(File.OpenRead("source.docx")))
{
    comparer.Add(File.OpenRead("target.docx"));
    comparer.Compare("result.docx");
    ChangeInfo[] changes = comparer.GetChanges();
    foreach (ChangeInfo change in changes)
    {
        Console.WriteLine("");
        Console.WriteLine("Source text: " + change.SourceText);
        Console.WriteLine("Target text: " + change.TargetText);
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Get source and target text from files

Path: /comparison/nodejs-java/get-source-and-target-text-from-files/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to get source and target texts of specific changes in the output file.

The following code snippets show how to get specified texts from a file.

## Get source and target text from a local disk

The following example compares two DOCX files from disk and prints the source and target text for each detected change.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and output documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to the comparison set
comparer.add(targetPath);

// Execute the comparison and write the result to the output file
comparer.compare(outputPath);

// Retrieve the list of detected changes after comparison
const changes = comparer.getChanges();

// Iterate over each change and display its source/target text fragments
for (let i = 0; i < changes.length; i++) {
  const change = changes[i];

  // Blank line for readability between changes
  console.log();

  // Output text from the source and target documents for this change
  console.log('Source text: ', change.getSourceText());
  console.log('Target text: ', change.getTargetText());
}

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and performs the comparison. After the comparison, it retrieves all detected changes using `getChanges()` and iterates through them to extract and display the source text (original text from the source document) and target text (modified text from the target document) for each change. This allows you to see exactly what text was changed between the documents.

The result is as follows:

![](/comparison/nodejs-java/images/get-source-and-target-text-from-files.png)

## Get source and target text from a stream

The following example performs the same operation using Java input streams instead of file paths.

```javascript
'use strict';

// Import the GroupDocs.Comparison for Node.js via Java SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Import Java bridge to work with FileInputStream
const java = require('java');
const InputStream = java.import('java.io.FileInputStream');

// Create input streams for source and target documents
const sourceInputStream = new InputStream('sample-files/source.docx');
const targetInputStream = new InputStream('sample-files/target.docx');

// Define the output file path for the comparison result
const outputPath = 'result.docx';

// Initialize the comparer with the source document stream
const comparer = new groupdocs.Comparer(sourceInputStream);

// Add the target document stream to the comparer
comparer.add(targetInputStream);

// Perform the comparison and generate the result file
comparer.compare(outputPath);

// Retrieve the list of detected changes
const changes = comparer.getChanges();

// Iterate over each change and output its source/target text portions
for (let i = 0; i < changes.length; i++) {
  const change = changes[i];
  console.log('Source text: ', change.getSourceText());
  console.log('Target text: ', change.getTargetText());
}

// Terminate the process with a success exit code
process.exit(0);
```

This example demonstrates the same workflow using Java input streams instead of file paths. It creates `InputStream` objects for both source and target documents, initializes the comparer with the source stream, adds the target stream, performs the comparison, and then retrieves and displays the source and target text for each detected change, just like the previous example but using streams.

---

## Get source and target text from files

Path: /comparison/python-net/get-source-and-target-text-from-files/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) provides access to the source and target text for each detected change.

## Get source and target text from local disk

Compare two files and print the source/target text for each change.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    comparer.compare("result.docx")
    changes = comparer.get_changes()
    for change in changes:
        print()
        print("Source text:", change.source_text)
        print("Target text:", change.target_text)
```

🔹 Use case: Extract changed text pairs to power side-by-side diff review tools.

The result is as follows:

![](/comparison/python-net/images/get-source-and-target-text-from-files.png)


## Get source and target text from stream

Work directly with streams and retrieve the same data programmatically.

```python
import groupdocs.comparison as gc

with open("source.docx", "rb") as src, open("target.docx", "rb") as tgt:
    with gc.Comparer(src) as comparer:
        comparer.add(tgt)
        comparer.compare("result.docx")
        changes = comparer.get_changes()
        for change in changes:
            print()
            print("Source text:", change.source_text)
            print("Target text:", change.target_text)
```

🔹 Use case: Feed structured change text into analytics or translation workflows.



---

## Get supported file formats

Path: /metadata/java/get-supported-file-formats/

The [getSupportedFileTypes](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/FileType#getSupportedFileTypes()) method of the [FileType](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/FileType) class is used to obtain a list of supported file types.

An example of obtaining a list of supported file types is presented below.

```java
Iterable<FileType> supportedFileTypes = FileType.getSupportedFileTypes();
Iterator iterator = supportedFileTypes.iterator();      
while (iterator.hasNext()) {
    FileType fileType = (FileType)iterator.next();
    System.out.println(fileType.getExtension() + " - " + fileType.getDescription());
}
```

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Getting all used fonts in the loaded document

Path: /viewer/java/getting-used-fonts/

Starting from [version 25.9](https://releases.groupdocs.com/viewer/java/release-notes/2025/groupdocs-viewer-for-java-25-9-release-notes/) the GroupDocs.Viewer is able to collect and return all fonts, which are used inside the document, loaded to the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class instance. This includes both metadata about every font and its binary content. GroupDocs.Viewer is able to return both fonts, which are embedded inside the document (stored inside the document file) and the system fonts, which are stored in the system folder and are _used_ in the document content.

Metadata and binary content about one used font is represented by the new struct [`UsedFontInfo`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/), that is located in the [`com.groupdocs.viewer.fonts`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/) namespace. This struct has the next properties:

- [`getName`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/#getName--) of a [`java.lang.String`](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html) type — a unique name of the font family (without name of the font style), never is null or empty string.
- [`isEmbedded`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/#isEmbedded--) [boolean](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) flag, indicates whether font is embedded inside the document content (`true`) or is a system font (`false`). Need to mention that the documents of the Spreadsheet format family (like XLS, XLSX etc) cannot hold embedded fonts, so for them this property always returns `false`.
- [`getStyle`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/#getStyle--) of a [`FontStyles`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/fontstyles/) enum — style name of the given font. May be one of 4 values: `Regular` (default), `Bold`, `Italic`, and `BoldItalic`. Need to mention that PDF documents use only the fonts with a `Regular` style.
- [`getContent`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/#getContent--) of the `byte[]` type — a byte array, that contains a full content of the given font. In very rare cases may be null or empty, when the given font is a system font and the runtime is not able to get its content. This usually happens on Linux.
- [`getFormat`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/#getFormat--) enum of [`FontFormat`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/fontformat/) type — indicates a format of the given font. The following formats are currently supported: TrueType font format (TTF), OpenType font format (OTF), TrueType Collection font format (TTC), Embedded OpenType font format (EOT). If the GroupDocs.Viewer cannot grab the binary content of the system font (Content property is null), this property may return the `FontFormat.Unknown` value.
- [`getCharset`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/#getCharset--) of [`int`](https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html) type — represents a character set of this font. Returns valid number only for the WordProcessing and Spreadsheet format families, for all other formats returns `0` (zero).

In order to obtain the fonts used in the given document, this document should be loaded to the instance of the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class using one of its constructors and then the [`getAllFonts()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getAllFonts-) instance method should be invoked. This method returns a list of all used fonts, where each font is represented as an instance of previously described [`UsedFontInfo`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/) struct. If a given document does not use any fonts or due to its format it cannot use any fonts (for example, archives or raster images), then the empty list will be returned.

## Example

Example below shows loading the sample DOCX document to the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class, and then returning and printing all fonts used within it.

{{< tabs "Loading">}}
{{< tab "GetAllFonts.java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.fonts.FontFormat;
import com.groupdocs.viewer.fonts.FontStyles;
import com.groupdocs.viewer.fonts.UsedFontInfo;

public class GetAllFonts {
    public static void run() {
        try (Viewer viewer = new Viewer("sample.docx")) {
            List<UsedFontInfo> list = viewer.getAllFonts();
            for (UsedFontInfo font : list) {
                System.out.printf(
                        "%s font '%s' of '%s' style has %d bytes and is of '%s' format%n",
                        font.isEmbedded() ? "Embedded" : "System",
                        font.getName(),
                        FontStyles.toString(font.getStyle()),
                        font.getContent().length,
                        FontFormat.toString(font.getFormat())
                );
            }
        } catch (Exception e){
            throw new RuntimeException(e);
        }
        System.out.println("\nSuccessfully extracted all fonts.");
    }

    public static void main(String[] args){
        run();
    }
}
```
{{< /tab >}}
{{< tab "Expected output" >}}  
```yaml
System font 'Arial' of 'Regular' style has 1045960 bytes and is of 'TrueType (TTF)' format
System font 'Calibri' of 'Italic' style has 1228564 bytes and is of 'TrueType (TTF)' format
System font 'Cambria Math' of 'Regular' style has 1792664 bytes and is of 'TrueType Collection (TTC)' format
System font 'MS Gothic' of 'Regular' style has 8990160 bytes and is of 'TrueType Collection (TTC)' format
System font 'Calibri' of 'Bold' style has 1647428 bytes and is of 'TrueType (TTF)' format
System font 'Cambria' of 'Bold' style has 841440 bytes and is of 'TrueType (TTF)' format
System font 'Calibri' of 'Regular' style has 1681220 bytes and is of 'TrueType (TTF)' format
System font 'Courier New' of 'Regular' style has 806504 bytes and is of 'TrueType (TTF)' format
```
{{< /tab >}}
{{< tab "sample.docx" >}}  
{{< tab-text >}}
`sample.docx` is sample file used in this example. Click [here](/viewer/java/sample-files/developer-guide/search-highlight-text/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Additional notes

After explaining the public API need to describe the next three important principles regarding the fonts:

1. GroupDocs.Viewer is able to extract and return fonts only from those document formats, which _may_ _have_ fonts. For example, the PDF, DOCX, XLSX, PPTX, document formats support and use fonts for representing their content, so GroupDocs.Viewer can find and return these fonts. However, such document formats like plain text (TXT), raster images (like PNG and JPEG), archives and so on do not support fonts. In case when such document will be loaded to the GroupDocs.Viewer and user will try to get the list of fonts, the empty list will be returned.
2. Need to distinguish font family and font style. For example, some DOCX document may use the "Arial" font family for both the regular text, bold, italic, and bold italic. In case of such a document the GroupDocs.Viewer will return 4 instances of the [`UsedFontInfo`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/usedfontinfo/) all of them have the "Arial" name, but different [styles](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/fontstyles/) ("Arial Regular", "Arial Bold", "Arial Italic", "Arial BoldItalic"), and each of them will have different binary content.
3. In some cases GroupDocs.Viewer may return an empty list of fonts even for those document, which actually has and uses fonts. This happens in case when a document, usually a WordProcessing document like DOC/DOCX/DOCM, was created on the author's machine and uses _only_ the unique fonts, which are not preinstalled on the operating system, but were manually installed on those author's machine. Then this document was transferred to the target machine, where the GroupDocs.Viewer is running and tries to extract and return fonts. But the problem is that those original unique fonts are absent on the target machine. As a result, the GroupDocs.Viewer "knows" which fonts are used in the loaded document, but it cannot find their content, so it omits such fonts without content.

---

## Getting all used fonts in the loaded document

Path: /viewer/net/getting-used-fonts/


GroupDocs.Viewer has a feature to collect and return all fonts, which are used inside the document, loaded to the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. These fonts are returned as an array, where each item represents a single font with its metadata and binary content. GroupDocs.Viewer is able to return both fonts, which are embedded inside the document (stored inside the document file) and the system fonts, which are stored in the system folder of the operating system and are _used_ in the document content. Need to mention that documents of some formats may contain fonts, which are referenced or even stored inside the document, but are not applied to the text inside the document; the GroupDocs.Viewer tries to detect and exclude such fonts from the returned list.

Need also to mention that the GroupDocs.Viewer is able to extract and return fonts only from those document formats, which _may_ _have_ fonts. For example, the PDF, DOCX, XLSX, PPTX, and other similar document formats support and use fonts for representing their textual content, so GroupDocs.Viewer can find and return these fonts. However, such document formats like plain text (TXT), raster images (like PNG and JPEG), archives and so on do not support fonts. In case when such document will be loaded to the GroupDocs.Viewer and user will try to get the list of fonts, the empty array will be returned.

In order to obtain the fonts used in the given document, this document should be loaded to the instance of the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class using one of its constructors. After document being loaded, the [`GetAllFonts()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/getallfonts/) instance method should be called. This method returns a list of all used fonts as an array of `IFontInfo[]` type, where `IFontInfo` is an interface that describes one font with its metadata and binary content. As it was said before, if a given document does not use any fonts or due to its format it cannot use any fonts (for example, archives or raster images), then the empty array will be returned.

Short code sample below demonstrates loading a DOCX document to the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class, getting a list of all used fonts, and then iterating over this list and displaying info about each font within it.

{{< tabs "Loading">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
// ...

const string filename = "sample.docx";
string inputPath = "\full\path\" + filename;

using (Viewer viewer = new Viewer(inputPath))
{
    Fonts.IFontInfo[] allFonts = viewer.GetAllFonts();
    Console.WriteLine("{0} fonts found in the '{1}' document", allFonts.Length, filename);
    foreach (Fonts.IFontInfo font in allFonts)
    {
        Console.WriteLine("Font '{0}' of {1} style has {2} bytes and is of {3} format",
            font.FamilyName,
            font.Style,
            font.Content.Length,
            font.Format);
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
' ...

Const filename As String = "sample.docx"
Dim inputPath As String = "\full\path\" & filename

Using viewer As New Viewer(inputPath)
    Dim allFonts As Fonts.IFontInfo() = viewer.GetAllFonts()
    Console.WriteLine("{0} fonts found in the '{1}' document", allFonts.Count, filename)
    For Each font As Fonts.IFontInfo In allFonts
        Console.WriteLine("Font '{0}' of {1} style has {2} bytes and is of {3} format",
            font.FamilyName,
            font.Style,
            font.Content.Length,
            font.Format)
    Next
End Using
```
{{< /tab >}}
{{< /tabs >}}

For the given sample DOCX document there is the next output in console:

```
3 fonts found in the 'sample.docx' document
Font 'Sancreek' of Regular style has 47612 bytes and is of 'OpenType' format
Font 'Trade Winds' of Regular style has 84588 bytes and is of 'OpenType' format
Font 'Arial' of Regular style has 1036584 bytes and is of 'TrueType' format
```

## Explaining IFontInfo

GroupDocs.Viewer supports extracting fonts from 4 main formats family: PDF, WordProcessing, Spreadsheet, and Presentation, and each of them have a slightly different concept of the fonts. For example, font content may be embedded inside the PDF, WordProcessing, and Presentation document, but not in the Spreadsheet. WordProcessing and Spreadsheet fonts provide a number, that represents a character set, but PDF and Presentation — don't. WordProcessing fonts may have an alternative font names. Also font substitution exists only for the WordProcessing documents. As a result, each formats family has its own font-related type:

1. WordProcessing — `WordProcessingFontInfo` and `WordProcessingSubstitutedFontInfo`.
2. Spreadsheet — `SpreadsheetFontInfo`.
3. Presentation — `PresentationFontInfo`.
4. PDF — `PdfFontInfo`.

And the `IFontInfo` interface declares the minimum set of properties, which are common for every font type:

- [`FamilyName`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/IFontInfo/FamilyName/) of a [`System.String`](https://learn.microsoft.com/en-us/dotnet/api/system.string) type — a unique name of the font family (without name of the font style), never is null or empty string.
- [`Style`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/IFontInfo/style/) of a [`FontStyles`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontstyles/) type — style of the given font. May be one of 4 values: `Regular` (default), `Bold`, `Italic`, and `BoldItalic`. [`FontStyles`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontstyles/) struct represent all possible font styles and provides a convenient properties for working with them.
- [`Content`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/IFontInfo/content/) of a `byte[]` type — a byte array, that contains a full content of the given font. In very rare cases may be `null`, when the given font is a system font and the runtime is not able to get its content. This usually happens on Linux.
- [`Format`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/IFontInfo/format/) of [`FontFormat`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontformat/) enum — indicates a format of the given font. The following formats are currently supported: TrueType font format (TTF), OpenType font format (OTF), TrueType Collection font format (TTC), Embedded OpenType font format (EOT). If the GroupDocs.Viewer cannot grab the binary content of the system font (`Content` property is `null`), this property may return the `FontFormat.Unknown` value.

**Important note**. Need to distinguish the _font family_ and the _font style_. For example, some DOCX document may use the "Arial" font family for both the regular text, bold, italic, and bold italic. In case of such a document the GroupDocs.Viewer will return 4 instances of the [`WordProcessingFontInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/WordProcessingFontInfo/); all of them have the "Arial" family name, but different [styles](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontstyles/) ("Arial Regular", "Arial Bold", "Arial Italic", "Arial BoldItalic"), and each of them will have different binary content.

## Explaining font substitution

There is a quite often scenario, which is applicable only for the WordProcessing formats family, when a document like DOC/DOCX/DOCM was created on the author's machine and uses some _unique_ fonts, which are not preinstalled on the operating system by default, but were manually installed on those author's machine. Then this document was transferred to the target machine, where the GroupDocs.Viewer is running and tries to extract and return fonts. But the problem is that those original unique fonts are absent on the target machine, and GroupDocs.Viewer cannot get their content.

In such case the GroupDocs.Viewer mimics the Microsoft Word behavior and initiates the **font substitution mechanism**. This is actually an algorithm, that replaces the missing fonts onto those, which are accessible on the target machine and are supposed to be the most similar to the missing ones. Such fonts, which are not used in the original document, but are selected to replace the missing fonts, are called **substituted**. GroupDocs.Viewer provides a special type for them — a `WordProcessingSubstitutedFontInfo` struct. This type contains a family name and style of the original font, that is missing on the target machine, and a name, format, and binary content of the substituted font, that is present and used instead it.

## Timeline

Initially the font extraction feature was introduced in the [version 25.3](https://releases.groupdocs.com/viewer/net/release-notes/2025/groupdocs-viewer-for-net-25-3-release-notes/) — there was a single universal type `UsedFontInfo` for representing any font info.

In the [version 25.6](https://releases.groupdocs.com/viewer/net/release-notes/2025/groupdocs-viewer-for-net-25-6-release-notes/) the font extraction was improved, especially for the WordProcessing formats family, and the public API was slightly changed (new properties were added to the `UsedFontInfo` type).

In the [version 25.9](https://releases.groupdocs.com/viewer/net/release-notes/2025/groupdocs-viewer-for-net-25-9-release-notes/) the font extraction was significantly reworked and improved by supporting the substituted fonts for the WordProcessing formats family. Public API was also significantly changed — now every formats family has its own font info type, that implements the `IFontInfo` interface.
---

## Getting indexed documents

Path: /search/java/getting-indexed-documents/

This page contains a description of how to get a list of indexed documents from an index, and how to get the text of indexed documents in HTML or plain text format.

## Getting indexed documents

To get a list of indexed documents from an index, use the [getIndexedDocuments](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getIndexedDocuments()) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class. Documents with the extensions ZIP, PST, OST can also contain internal documents. To get a list of internal documents, use the [getIndexedDocumentItems](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getIndexedDocumentItems(com.groupdocs.search.results.DocumentInfo)) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class. For ZIP archives, this way you can access documents of arbitrary nesting depth. An example of obtaining a list of documents from an index is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Getting list of indexed documents
DocumentInfo[] documents = index.getIndexedDocuments();
for (DocumentInfo document : documents) {
    System.out.println(document.getFilePath());
    DocumentInfo[] items = index.getIndexedDocumentItems(document); // Getting list of document items
    for (DocumentInfo item : items) {
        System.out.println("\t" + item.getInnerPath());
    }
}
```

## Getting text of indexed documents

The text of the indexed document can also be extracted from an index if the option to save the text of documents in the index has been enabled. If this option was not enabled when creating an index, then when the [getDocumentText](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getDocumentText(com.groupdocs.search.results.DocumentInfo,%20com.groupdocs.search.common.OutputAdapter)) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class is called, the text of the document will be retrieved again. Details about saving the text of documents in an index can be found on the page [Storing text of indexed documents]({{< ref "search/java/developer-guide/advanced-usage/indexing/storing-text-of-indexed-documents.md" >}}).

The generated text of the document is passed to an instance of a class derived from the abstract class [OutputAdapter](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/OutputAdapter). Details on the output adapters are presented on the page [Output adapters]({{< ref "search/java/developer-guide/advanced-usage/searching/output-adapters.md" >}}).

After generating the text of a document into a file, this file can be opened by an Internet browser. The following example shows how to extract document text from an index.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Getting list of indexed documents
DocumentInfo[] documents = index.getIndexedDocuments();

// Getting a document text
if (documents.length > 0) {
    FileOutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, "C:\\Text.html");
    index.getDocumentText(documents[0], outputAdapter);
}
```

To extract the text of a document from an index, the method overloading is also presented, which takes an instance of the [TextOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions) class as a parameter. In this class, the following options can be specified:

*   [setCustomExtractor](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#setCustomExtractor(com.groupdocs.search.common.IFieldExtractor)) method sets an extractor used during indexing, it is necessary if the text of the document was not saved in the index;
*   [setAdditionalFields](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#setAdditionalFields(com.groupdocs.search.common.DocumentField%5B%5D)) method sets additional document fields added during document indexing which are also necessary if the document text was not saved in the index;
*   [setCancellation](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method sets an object used to cancel the operation;
*   [getMetadataIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#getMetadataIndexingOptions()) method returns an object for specifying metadata indexing options.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Getting indexed documents

Path: /search/net/getting-indexed-documents/

This page contains a description of how to get a list of indexed documents from an index, and how to get the text of indexed documents in HTML or plain text format.

## Getting indexed documents

To get a list of indexed documents from an index, use the [GetIndexedDocuments](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getindexeddocuments) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class. Documents with the extensions ZIP, PST, OST can also contain internal documents. To get a list of internal documents, use the [GetIndexedDocumentItems](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getindexeddocumentitems) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class. For ZIP archives, this way you can access documents of arbitrary nesting depth. An example of obtaining a list of documents from an index is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Getting list of indexed documents
DocumentInfo[] documents = index.GetIndexedDocuments();
for (int i = 0; i < documents.Length; i++)
{
    DocumentInfo document = documents[i];
    Console.WriteLine(document.FilePath);
    DocumentInfo[] items = index.GetIndexedDocumentItems(document); // Getting list of document items
    for (int j = 0; j < items.Length; j++)
    {
        DocumentInfo item = items[j];
        Console.WriteLine("\t" + item.InnerPath);
    }
}
```

## Getting text of indexed documents

The text of the indexed document can also be extracted from an index if the option to save the text of documents in the index has been enabled. If this option was not enabled when creating an index, then when the [GetDocumentText](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getdocumenttext/index) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class is called, the text of the document will be retrieved again. Details about saving the text of documents in an index can be found on the page [Storing text of indexed documents]({{< ref "search/net/developer-guide/advanced-usage/indexing/storing-text-of-indexed-documents.md" >}}).

The generated text of the document is passed to an instance of a class derived from the abstract class [OutputAdapter](https://reference.groupdocs.com/net/search/groupdocs.search.common/outputadapter). Details on the output adapters are presented on the page [Output adapters]({{< ref "search/net/developer-guide/advanced-usage/searching/output-adapters.md" >}}).

After generating the text of a document into a file, this file can be opened by an Internet browser. The following example shows how to extract document text from an index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Getting list of indexed documents
DocumentInfo[] documents = index.GetIndexedDocuments();
 
// Getting a document text
if (documents.Length > 0)
{
    FileOutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, @"C:\Text.html");
    index.GetDocumentText(documents[0], outputAdapter);
}
```

To extract the text of a document from an index, the method overloading is also presented, which takes an instance of the [TextOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions) class as a parameter. In this class, the following options can be specified:

*   [CustomExtractor](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/customextractor) is a custom extractor used during indexing, it is necessary if the text of the document was not saved in the index;
*   [AdditionalFields](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/additionalfields) are additional document fields added during document indexing which are also necessary if the document text was not saved in the index;
*   [Cancellation](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/cancellation) is an object used to cancel the operation;
*   [MetadataIndexingOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/metadataindexingoptions) is an object for specifying metadata indexing options.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Getting indexed documents

Path: /search/nodejs-java/getting-indexed-documents/

This page contains a description of how to get a list of indexed documents from an index, and how to get the text of indexed documents in HTML or plain text format.

## Getting indexed documents

To get a list of indexed documents from an index, use the [getIndexedDocuments](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getIndexedDocuments()) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class. Documents with the extensions ZIP, PST, OST can also contain internal documents. To get a list of internal documents, use the [getIndexedDocumentItems](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getIndexedDocumentItems(com.groupdocs.search.results.DocumentInfo)) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class. For ZIP archives, this way you can access documents of arbitrary nesting depth. An example of obtaining a list of documents from an index is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Getting list of indexed documents
const documents = index.getIndexedDocuments();
for (const document of documents) {
  console.log(document.getFilePath());
  const items = index.getIndexedDocumentItems(document); // Getting list of document items
  for (const item of items) {
    console.log('\t' + item.getInnerPath());
  }
}
```

## Getting text of indexed documents

The text of the indexed document can also be extracted from an index if the option to save the text of documents in the index has been enabled. If this option was not enabled when creating an index, then when the [getDocumentText](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getDocumentText(com.groupdocs.search.results.DocumentInfo,%20com.groupdocs.search.common.OutputAdapter)) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class is called, the text of the document will be retrieved again. Details about saving the text of documents in an index can be found on the page [Storing text of indexed documents]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/storing-text-of-indexed-documents.md" >}}).

The generated text of the document is passed to an instance of a class derived from the abstract class [OutputAdapter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/OutputAdapter). Details on the output adapters are presented on the page [Output adapters]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/output-adapters.md" >}}).

After generating the text of a document into a file, this file can be opened by an Internet browser. The following example shows how to extract document text from an index.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index settings instance
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Getting list of indexed documents
const documents = index.getIndexedDocuments();

// Getting a document text
if (documents.length > 0) {
  const outputAdapter = new groupdocs.search.FileOutputAdapter(
      groupdocs.search.OutputFormat.Html,
    Utils.OutputPath + 'AdvancedUsage/Searching/gettingIndexedDocuments/Text.html',
  );
  index.getDocumentText(documents[0], outputAdapter);

  // Getting list of files in the archive
  const items = index.getIndexedDocumentItems(documents[0]);
  if (items.length > 0) {
    const outputAdapter2 = new groupdocs.search.FileOutputAdapter(
      groupdocs.search.OutputFormat.Html,
      Utils.OutputPath + 'AdvancedUsage/Searching/gettingIndexedDocuments/ItemText.html',
    );
    index.getDocumentText(items[0], outputAdapter2);
  }
}
```

To extract the text of a document from an index, the method overloading is also presented, which takes an instance of the [TextOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions) class as a parameter. In this class, the following options can be specified:

*   [setCustomExtractor](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#setCustomExtractor(com.groupdocs.search.common.IFieldExtractor)) method sets an extractor used during indexing, it is necessary if the text of the document was not saved in the index;
*   [setAdditionalFields](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#setAdditionalFields(com.groupdocs.search.common.DocumentField%5B%5D)) method sets additional document fields added during document indexing which are also necessary if the document text was not saved in the index;
*   [setCancellation](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method sets an object used to cancel the operation;
*   [getMetadataIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#getMetadataIndexingOptions()) method returns an object for specifying metadata indexing options.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Getting known property descriptors

Path: /metadata/java/getting-known-property-descriptors/

This code snippet demonstrates how to extract information about known properties that can be encountered in a particular package.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to examine
2.  Get a collection of [PropertyDescriptor](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PropertyDescriptor) instances for any desired metadata package
3.  Iterate through the extracted descriptors

**advanced\_usage.GettingKnownPropertyDescriptors**

```csharp
try (Metadata metadata = new Metadata(Constants.InputDoc)) {
	WordProcessingRootPackage root = metadata.getRootPackageGeneric();

	for (PropertyDescriptor descriptor : root.getDocumentProperties().getKnowPropertyDescriptors()) {
		System.out.println(descriptor.getName());
		System.out.println(descriptor.getType());
		System.out.println(descriptor.getAccessLevel());
		for (PropertyTag tag : descriptor.getTags()) {
			System.out.println(tag);
		}
		System.out.println();
	}
}
```

{{< alert style="info" >}}
Not all possible properties are presented in the [getKnowPropertyDescriptors](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/MetadataPackage#getKnowPropertyDescriptors()) collection. The library provides information on the most frequently used properties only. If there is no descriptor for some property it is still accessible through the GroupDocs.Metadata search engine in read-only mode.
{{< /alert >}}

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Getting known property descriptors

Path: /metadata/net/getting-known-property-descriptors/

This code snippet demonstrates how to extract information about known properties that can be encountered in a particular package.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to examine
2.  Get a collection of [PropertyDescriptor](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/propertydescriptor) instances for any desired metadata package
3.  Iterate through the extracted descriptors

**AdvancedUsage.GettingKnownPropertyDescriptors**

```csharp
using (Metadata metadata = new Metadata(Constants.InputDoc))
{
	var root = metadata.GetRootPackage<WordProcessingRootPackage>();
	foreach (var descriptor in root.DocumentProperties.KnowPropertyDescriptors)
	{
		Console.WriteLine(descriptor.Name);
		Console.WriteLine(descriptor.Type);
		Console.WriteLine(descriptor.AccessLevel);

		foreach (var tag in descriptor.Tags)
		{
			Console.WriteLine(tag);
		}

		Console.WriteLine();
	}
}
```

{{< alert style="info" >}}
Not all possible properties are presented in the [KnowPropertyDescriptors](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.common/metadatapackage/properties/knowpropertydescriptors) collection. The library provides information on the most frequently used properties only. If there is no descriptor for some property it is still accessible through the GroupDocs.Metadata search engine in read-only mode.
{{< /alert >}}

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Getting known property descriptors

Path: /metadata/nodejs-java/getting-known-property-descriptors/

This code snippet demonstrates how to extract information about known properties that can be encountered in a particular package.

1.  **Load** a file to examine
2.  Get a collection of **PropertyDescriptor** instances for any desired metadata package
3.  Iterate through the extracted descriptors

**advanced\_usage.GettingKnownPropertyDescriptors**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata("input.doc");
    var root = metadata.getRootPackageGeneric();
    var descriptors = root.getDocumentProperties().getKnowPropertyDescriptors();
    for(var i=0;i<descriptors.getCount(); i++)
    {
      var descriptor = descriptors.get_Item(i);
      console.log(descriptor.getName());
      console.log(descriptor.getType().getRawValue());
      console.log(descriptor.getAccessLevel().getRawValue());

      var tags = descriptor.getTags();
      for(var j=0;j<tags.getCount(); j++)
        {
          console.log(tags.get_Item(j).getCategory().toString());
        }
    }
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}
Not all possible properties are presented in the **getKnowPropertyDescriptors** collection. The library provides information on the most frequently used properties only. If there is no descriptor for some property it is still accessible through the GroupDocs.Metadata search engine in read-only mode.
{{< /alert >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Getting known property descriptors

Path: /metadata/python-net/getting-known-property-descriptors/

This example demonstrates how to extract information about known properties that can be encountered in a particular package.

1.  [Load]({{< ref "metadata/python-net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a file to examine
2.  Get a collection of property descriptors for the desired metadata package
3.  Iterate through the extracted descriptors

**advanced_usage.getting_known_property_descriptors**


```python
def run():
    with gm.Metadata(constants.input_doc) as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "document_properties") and root.document_properties is not None:
            for descriptor in root.document_properties.know_property_descriptors:
                print(descriptor.name)
                print(descriptor.type)
                print(descriptor.access_level)

                for tag in descriptor.tags:
                    print(tag)

                print()
```


{{< alert style="info" >}}
Not all possible properties are presented in the KnowPropertyDescriptors collection. The library provides information on the most frequently used properties only. If there is no descriptor for some property it is still accessible through the GroupDocs.Metadata search engine in read-only mode.
{{< /alert >}}

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## How to build in docker

Path: /conversion/net/build-in-docker/


## Build web API project with GroupDocs.Conversion in Docker

To build an web API which is using GroupDocs.Conversion for .NET in docker container use this sample Docker file:

```docker
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

RUN apt-get update && apt-get install -y ffmpeg libgdiplus

RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig
RUN fc-cache -f -v

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["YourApi/YourApi.csproj", "TestApi/"]
RUN dotnet restore "YourApi/YourApi.csproj"
COPY . .
WORKDIR "/src/YourApi"
RUN dotnet build "YourApi.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "YourApi.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "YourApi.dll"]
```

As you can see the process is the same as building a regular web API project in docker. The main difference is the installation of needed libraries which allows GroupDocs.Conversion for .NET to work properly in a docker container:

```docker
RUN apt-get update && apt-get install -y ffmpeg libgdiplus

RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig
RUN fc-cache -f -v
```

Also please do not forget to add runtimeconfig.template.json file next to your project file with the following content:

```json
{
    "configProperties": {
        "System.Drawing.EnableUnixSupport": true
    }
}
```

This will prevent exception "The type initializer for `gdip` throws exception". To learn more about this [read here](https://docs.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only).
---

## How to merge archives to ZIP using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-archives-to-zip-using-csharp/


## ZIP Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple archive documents in the preferred order and save them as a single ZIP file.

## About ZIP File Format

A file with .zip extension is an archive that can hold one or more files or directories. The archive can have compression applied to the included files in order to reduce the ZIP file size. ZIP file format was made public back in February 1989 by Phil Katz for achieving archiving of files and folders. The format was made part of PKZIP utility, created by PKWARE, Inc. Right after the availability of available specifications, many companies made ZIP file format part of their software utilities including Microsoft (since Windows 7), Apple (Mac OS X ) and many others.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### How to merge archives to ZIP file

The following example demonstrates how to merge archives to ZIP file with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged archive file as parameter.

```csharp
// Load the source archive file
using (Merger merger = new Merger(@"c:\sample1.zip"))
{
    // Add another archive file to merge
    merger.Join(@"c:\sample2.tar");
    // Add next archive file to merge
    merger.Join(@"c:\sample3.rar");
    // Merge archive files and save result
    merger.Save(@"c:\merged.zip");
}
```

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge ZIP Live Demo

GroupDocs.Merger for .NET provides an online [**Archive to ZIP Merger App**](https://products.groupdocs.app/merger/archive-to-zip), which allows you to try it for free and check its quality and accuracy.
---

## How to merge archives to ZIP using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-archives-to-zip-using-java/


## ZIP Merger Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple archive documents in the preferred order and save them as a single ZIP file.

## About ZIP File Format

A file with .zip extension is an archive that can hold one or more files or directories. The archive can have compression applied to the included files in order to reduce the ZIP file size. ZIP file format was made public back in February 1989 by Phil Katz for achieving archiving of files and folders. The format was made part of PKZIP utility, created by PKWARE, Inc. Right after the availability of available specifications, many companies made ZIP file format part of their software utilities including Microsoft (since Windows 7), Apple (Mac OS X ) and many others.


### How to merge archives to ZIP file

The following example demonstrates how to merge archives to ZIP file with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.lang.String-) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [Save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged archive file as parameter.

```java
// Load the source archive file
Merger merger = new Merger("c:\sample1.zip");
{
    // Add another archive file to merge
    merger.join("c:\sample2.zip");
    // Merge archive files and save result
    merger.save("c:\merged.zip");
}
```

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Archives Live Demo

GroupDocs.Merger for Java provides online [**ZIP Merger App**](https://products.groupdocs.app/merger/zip) and [**TAR Merger App**](https://products.groupdocs.app/merger/tar), which allow you to try it for free and check its quality and accuracy.
---

## How to merge archives to ZIP using Node.js via Java

Path: /merger/nodejs-java/getting-started/use-cases/how-to-merge-archives-to-zip-using-nodejs-java/


## ZIP Merger Node.js via Java API

[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) allows developers to combine multiple archive documents in the preferred order and save them as a single ZIP file.

## About ZIP File Format

A file with .zip extension is an archive that can hold one or more files or directories. The archive can have compression applied to the included files in order to reduce the ZIP file size. ZIP file format was made public back in February 1989 by Phil Katz for achieving archiving of files and folders. The format was made part of PKZIP utility, created by PKWARE, Inc. Right after the availability of available specifications, many companies made ZIP file format part of their software utilities including Microsoft (since Windows 7), Apple (Mac OS X ) and many others.


### How to merge archives to ZIP file

The following example demonstrates how to merge archives to ZIP file with several lines of Node.js via Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.lang.String-) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged archive file as parameter.

```js
const merger = new groupdocs.merger.Merger(`c:/sample1.zip`);
merger.join('c:/sample2.tar');
merger.join('c:/sample3.rar');
merger.save(`c:/merged.zip`);
```

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Archives Live Demo

GroupDocs.Merger for Node.js via Java provides online [**ZIP Merger App**](https://products.groupdocs.app/merger/zip) and [**TAR Merger App**](https://products.groupdocs.app/merger/tar), which allow you to try it for free and check its quality and accuracy.
---

## How to merge archives to ZIP using Python via .NET

Path: /merger/python-net/getting-started/use-cases/how-to-merge-archives-to-zip-using-python-net/


## ZIP Merger Python via .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) allows developers to combine multiple archive documents in the preferred order and save them as a single ZIP file.

## About ZIP File Format

A file with .zip extension is an archive that can hold one or more files or directories. The archive can have compression applied to the included files in order to reduce the ZIP file size. ZIP file format was made public back in February 1989 by Phil Katz for achieving archiving of files and folders. The format was made part of PKZIP utility, created by PKWARE, Inc. Right after the availability of available specifications, many companies made ZIP file format part of their software utilities including Microsoft (since Windows 7), Apple (Mac OS X ) and many others.


### How to merge archives to ZIP file

The following example demonstrates how to merge archives to ZIP file with several lines of Python via .NET code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged archive file as parameter.

```python
with gm.Merger("c:/sample1.zip") as merger:
    merger.join("c:/sample2.tar")
    merger.join("c:/sample3.rar")
    merger.save("c:/merged.zip")
```

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Archives Live Demo

GroupDocs.Merger for Python via .NET provides online [**ZIP Merger App**](https://products.groupdocs.app/merger/zip) and [**TAR Merger App**](https://products.groupdocs.app/merger/tar), which allow you to try it for free and check its quality and accuracy.
---

## How to Run

Path: /watermark/java/how-to-run/

## Download from GitHub

The complete examples package of **GroupDocs.Watermark **is hosted on [GitHub](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java). You can either download the ZIP file from [here](https://codeload.github.com/groupdocs-watermark/GroupDocs.watermark-for-Java/zip/master) or clone the repository of Github using your favorite Github client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/watermark/java/images/how-to-run.png)

The project uses Maven build system and any modern IDE can easily open or import the project and download its dependencies. Following image shows how it looks like when opening example project in Eclipse.

![](/watermark/java/images/how-to-run_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All the examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to run examples

Path: /conversion/net/how-to-run-examples/

<!--
{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Conversion has been installed successfully.{{< /alert >}}

This article describes how to run .NET file conversion API code examples.
-->
We offer multiple solutions on how you can run GroupDocs.Conversion examples, by building your own or using our back-end or front-end examples.

<!--Please choose one from the following list:-->

## Build a project from scratch

You can build a project from scratch using Visual Studio or [.NET CLI](https://docs.microsoft.com/en-us/dotnet/core/tools/). We'll step you through both cases.

### Build a project using .NET CLI

This method applies to .NET 6+ projects.

1. Make sure you have .NET SDK installed <https://dotnet.microsoft.com/download>.
2. Create a directory for your console app by executing the `mkdir my-console-app` command in your terminal.
3. Navigate to the `my-console-app` directory by executing the `cd my-console-app` command.
4. Create an empty console app by executing the `dotnet new console` command.
5. Add the GroupDocs.Conversion for .NET package by executing the `dotnet add package GroupDocs.Conversion` command.
6. Edit `Program.cs` and add the following lines to the `Main` method:
  
  ```csharp
    using GroupDocs.Conversion;
	using GroupDocs.Conversion.Options.Convert;

    string documentPath = @"C:\sample.docx"; // NOTE: Put here actual path for your document
    string outputPath = @"C:\output\converted.pdf";
  
    using (Converter converter = new Converter(documentPath))
    {
        PdfConvertOptions convertOptions = new PdfConvertOptions();
        converter.Convert(outputPath, convertOptions);
    }
  ```
  
7. Replace the `documentPath` value with the actual path to the document you're going to convert.
8. Run the project by executing the `dotnet run` command.
9. The converted document will be saved in the `C:\\output\\` directory.

### Build a project using Visual Studio

This method applies to both .NET 6+ and .NET Framework 4.6.2+ projects.

1. Open Visual Studio and go to **File** -> **New** -> **Project**.
2. Select the appropriate project type - Console App, ASP.NET Web Application etc.
3. Install the appropriate **GroupDocs.Conversion** NuGet package for your target framework:
   * [GroupDocs.Conversion](https://www.nuget.org/packages/GroupDocs.Conversion) - for .NET 6+
   * [GroupDocs.Conversion.NETFramework](https://www.nuget.org/packages/GroupDocs.Conversion.NETFramework) - for .NET Framework 4.6.2+

   For detailed installation instructions, see the [Installation guide]({{< ref "conversion/net/getting-started/installation.md" >}}).
4. Add the following code to the `Main` method:

  ```csharp
    using GroupDocs.Conversion;
	using GroupDocs.Conversion.Options.Convert;

    string documentPath = @"C:\sample.docx"; // NOTE: Put here actual path for your document
    string outputPath = @"C:\output\converted.pdf";
  
    using (Converter converter = new Converter(documentPath))
    {
        PdfConvertOptions convertOptions = new PdfConvertOptions();
        converter.Convert(outputPath, convertOptions);
    }
  ```

5. Replace the `documentPath` value with the actual path to the document you're going to convert.
6. Build and Run your project.
7. The converted document will be saved in the `C:\\output\\` directory.

## Run back-end examples

You can find many back-end examples in our [GitHub](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET) repository. You can either download the ZIP file from [here](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/archive/master.zip) or clone the repository from GitHub using your favorite Git client.  
In case you download the ZIP file, extract the folders on your local disk.

1. Navigate to the `Examples` directory and open the `GroupDocs.Conversion.Examples.CSharp.sln` solution using Visual Studio.
2. Open the `RunExamples.cs` file and uncomment the example(s) that you would like to run.
3. Optionally, you can set the path to the license in `Utils.cs` file.

## Run demo projects

To run any demo from [GroupDocs.Conversion for .NET Demo projects](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/tree/master/Demos/), you can either:

* Clone the repository:

  ```bash
  git clone git@github.com:groupdocs-conversion/GroupDocs.Conversion-for-.NET.git  
  ```

* or [download](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/archive/master.zip) the source code.

### ASP.NET MVC demo

1. Clone or download the [GroupDocs.Conversion-for-.NET](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET) repository from GitHub or skip this step if you already have the code.
2. Navigate to the `Demos/MVC` directory.
3. Open the `GroupDocs.Conversion.MVC.sln` solution using Visual Studio.
4. Update common parameters in the `**web.config**` file and demo-related properties in the `**configuration.yml**` file to meet your requirements.
<!--
 see more about configuring the demo at ["Configuration"](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/tree/master/Demos/MVC#configuration) section. -->
5. Run the project and open [http://localhost:8080/conversion](http://localhost:8080/conversion) in your favorite browser.
<!--
{{< alert style="info" >}}

For more details about demo configuration please refer to ["Configuration"](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/tree/master/Demos/MVC#configuration) section.

{{< /alert >}}
-->
### ASP.NET Web Forms demo

1. Clone or download the [GroupDocs.Conversion-for-.NET](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET) repository from GitHub or skip this step if you already have the code.
2. Navigate to `Demos/WebForms` directory.
3. Open the `GroupDocs.Conversion.WebForms.sln` solution using Visual Studio.
4. Update common parameters in the `**web.config**` file and demo-related properties in the `**configuration.yml**` file to meet your requirements.
5. Open [http://localhost:8080/conversion](http://localhost:8080/conversion) in your favorite browser.

<!--
{{< alert style="info" >}}

For more details about demo configuration please refer to ["Configuration"](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET/tree/master/Demos/WebForms#configuration) section.

{{< /alert >}}
-->
### Docker demo

Use the [Docker](https://www.docker.com/) image to try GroupDocs.Conversion for .NET features in an easy way. Here are the commands to run GroupDocs.Conversion for .NET from the Docker image.

```bash
mkdir DocumentSamples
mkdir Licenses
docker run -p 8080:8080 --env application.hostAddress=localhost  \
    -v `pwd`/DocumentSamples:/home/groupdocs/app/DocumentSamples  \
    -v `pwd`/Licenses:/home/groupdocs/app/Licenses  \
    groupdocs/conversion
## Open http://localhost:8080/conversion in your favorite browser.
```

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include them in the repository if found helpful.

---

## How to run examples

Path: /markdown/net/how-to-run-examples/

<!--
{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Markdown has been installed successfully.{{< /alert >}}

This article describes how to run .NET file markdown API code examples.
-->
We offer multiple solutions on how you can run GroupDocs.Markdown examples, by building your own or using our back-end or front-end examples.

<!--Please choose one from the following list:-->

## Build a project from scratch

You can build a project from scratch using Visual Studio or [.NET CLI](https://docs.microsoft.com/en-us/dotnet/core/tools/). We'll step you through both cases.

### Build a project using .NET CLI

1. Make sure you have .NET SDK installed <https://dotnet.microsoft.com/download>.
2. Create a directory for your console app by executing the `mkdir my-console-app` command in your terminal.
3. Navigate to the `my-console-app` directory by executing the `cd my-console-app` command.
4. Create an empty console app by executing the `dotnet new console` command.
5. Add the GroupDocs.Markdown for .NET package by executing the `dotnet add package GroupDocs.Markdown` command.
6. Edit `Program.cs` and add the following lines to the `Main` method:
  
  {{< tabs "dotnet-cli-example" >}}
  {{< tab "C#" >}}
  ```csharp
    using GroupDocs.Markdown;

    string documentPath = "business-plan.docx";
    string outputPath = "converted.md";
  
	using (var converter = new MarkdownConverter(documentPath))
	{
		converter.Convert(outputPath);
	}
  ```
  {{< /tab >}}
  {{< tab "business-plan.docx" >}}
  {{< tab-text >}}
  `business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/business-plan.docx) to download it.
  {{< /tab-text >}}
  {{< /tab >}}
{{< tab "converted.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/getting-started/how-to-run-examples/DotnetCliExample/converted.md)
{{< /tab >}}
{{< /tabs >}}
  
7. Replace the `documentPath` value with the actual path to the document you're going to convert.
8. Run the project by executing the `dotnet run` command.
9. The converted document will be saved in the `C:\\output\\` directory.

### Build a project using Visual Studio

1. Open Visual Studio and go to **File** -> **New** -> **Project**.
2. Select the appropriate project type - Console App, ASP.NET Web Application etc.
3. Install **GroupDocs.Markdown for .NET** from Nuget or the official GroupDocs website following this [guide]({{< ref "markdown/net/getting-started/installation.md" >}}).
4. Add the following code to the `Main` method:

  {{< tabs "visual-studio-example" >}}
  {{< tab "C#" >}}
  ```csharp
    using GroupDocs.Markdown;

    string documentPath = "business-plan.docx";
    string outputPath = "converted.md";
  
	using (var converter = new MarkdownConverter(documentPath))
	{
		converter.Convert(outputPath);
	}
  ```
  {{< /tab >}}
  {{< tab "business-plan.docx" >}}
  {{< tab-text >}}
  `business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/business-plan.docx) to download it.
  {{< /tab-text >}}
  {{< /tab >}}
{{< tab "converted.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/getting-started/how-to-run-examples/VisualStudioExample/converted.md)
{{< /tab >}}
{{< /tabs >}}

5. Replace the `documentPath` value with the actual path to the document you're going to convert.
6. Build and Run your project.
7. The converted document will be saved in the `C:\\output\\` directory.

## Run back-end examples

You can find many back-end examples in our [GitHub](https://github.com/groupdocs-markdown/GroupDocs.Markdown-for-.NET) repository. You can either download the ZIP file from [here](https://github.com/groupdocs-markdown/GroupDocs.Markdown-for-.NET/archive/master.zip) or clone the repository from GitHub using your favorite Git client.  
In case you download the ZIP file, extract the folders on your local disk.

1. Navigate to the `Examples` directory and open the `GroupDocs.Markdown.Examples.CSharp.sln` solution using Visual Studio.
2. Open the `RunExamples.cs` file and uncomment the example(s) that you would like to run.
3. Optionally, you can set the path to the license in `Utils.cs` file.

## Run demo projects

To run any demo from [GroupDocs.Markdown for .NET Demo projects](https://github.com/groupdocs-markdown/GroupDocs.Markdown-for-.NET/tree/master/Demos/), you can either:

* Clone the repository:

  ```bash
  git clone git@github.com:groupdocs-markdown/GroupDocs.Markdown-for-.NET.git  
  ```

* or [download](https://github.com/groupdocs-markdown/GroupDocs.Markdown-for-.NET/archive/master.zip) the source code.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include them in the repository if found helpful.
---

## How to run examples

Path: /redaction/python-net/how-to-run-examples/


The complete project [GroupDocs.Redaction Examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET) with code examples and sample files is hosted at GitHub.

## Run examples using PyPI

To get started make sure that [Python](https://www.python.org/) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET.git`
2. Navigate to the examples folder `cd ./GroupDocs.Redaction-for-Python-via-.NET/`
3. Install the necessary packages with the `pip install groupdocs-redaction-net` command.
4. Navigate to the examples folder `cd ./Examples`
5. Run the examples with the `python runExamples.py` command.

To check what examples are available open `Examples/runExamples.py` file using your favorite text editor. Uncomment examples that you want to run and type `python runExamples.py` to start them.


## Contribute

If you would like to add or enhance an example, we encourage you to contribute to the project. All examples in this repository are open-source and can be freely utilized in your own applications.

To contribute, simply fork the repository, make your changes to the source code, and submit a pull request. We will review your contributions and, if they are beneficial, include them in the repository.
---

## How to run examples

Path: /watermark/python-net/how-to-run-examples/


The complete project [GroupDocs.Watermark Examples](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Python-via-.NET) with code examples and sample files is hosted at GitHub.

## Run examples using PyPI

To get started make sure that [Python](https://www.python.org/) is installed.

1. Clone repository with examples `git clone https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Python-via-.NET.git`
2. Navigate to the examples folder `cd ./GroupDocs.Watermark-for-Python-via-.NET/`
3. Install the necessary packages with the `pip install groupdocs-watermark-net` command.
4. Navigate to the examples folder `cd ./Examples`
5. Run the examples with the `python runExamples.py` command.

To check what examples are available open `Examples/runExamples.py` file using your favorite text editor. Uncomment examples that you want to run and type `python runExamples.py` to start them.


## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include them in the repository if found helpful.
---

## How to Run Examples

Path: /assembly/java/how-to-run-examples/

## Download from GitHub

The complete examples package of **GroupDocs.Assembly** is hosted on [Github](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java). You can either download the ZIP file from [here](https://codeload.github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/zip/master) or clone the repository of Github using your favorite Github client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Images/folder.PNG?raw=true)

Open Eclipse and import the project to get started with it. Archived project file can also be imported.Follow the given steps to run the application:

*   Go to project properties.
*   Click on Java Build Path.
*   Go to Libraries and external Jars (GroupDocs.Assembly.Jar).

![](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Images/eclipse.PNG?raw=true)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /classification/net/how-to-run-examples/

## Software Requirements

Please make sure you meet the following requirements before downloading and running the examples.

1.  Visual Studio 2013  or higher
2.  NuGet Package Manager installed in Visual Studio. Make sure that latest NuGet API version is installed in Visual Studio. For details on how to install NuGet package manager please check [http://docs.nuget.org/ndocs/guides/install-nuget](http://docs.nuget.org/ndocs/guides/install-nuget)
3.  Go to Tools->Options->NuGet Package Manager->Package Sources and make sure that the option **nuget.org** is checked
4.  Example project uses NuGet Automatic Package Restore feature therefore you should have an active internet connection. If you do not have an active internet connection on the machine where examples are to be executed please check [Installation](https://auckland.dynabic.com/wiki/display/classification/Installation "Installation") and manually add reference to GroupDocs.Classification.dll in the example project.

## Download from GitHub

All examples of GroupDocs.Classification for .NET are hosted on [GitHub](https://github.com/groupdocs-classification/GroupDocs.Classification-for-.NET).

*   You can either clone the repository using your favorite GitHub client or download the ZIP file from [here](https://github.com/groupdocs-classification/GroupDocs.Classification-for-.NET/archive/master.zip).
*   Extract the contents of ZIP file to any folder on your computer. All the examples are located in the **Examples** folder.
*   There are two Visual Studio solution files, one in Examples folder and one in Showcases folder.
*   The projects are created in Visual Studio 2019, but the solution should be compatible with Visual Studio 2013 and higher.
*   Open the solution file in Visual Studio and build the project.
*   On first run the dependencies will automatically be downloaded via NuGet.
*   **Data** folder at the root folder of **Examples** contains input files which CSharp examples used. It is mandatory that you download the **Data** folder along with the examples project.
*   Open Program.cs file, all the examples are called from here.
*   Uncomment the License file setting if you have a license.

Please feel free to reach out using our [Forums ](https://forum.groupdocs.com/c/classification)if you have any issues setting up or running the examples.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples and showcase projects in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /comparison/net/how-to-run-examples/


{{< alert style="warning" >}}Make sure that GroupDocs.Comparison has been installed properly before running examples.{{< /alert >}}

We offer multiple solutions on how you can run [GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) examples, by building your own or using our back-end or front-end examples out-of-the-box.

Please choose one from the following list:

## Build project from scratch

1. Open Visual Studio and navigate to **File** -> **New** -> **Project**.
2. Select the appropriate project type - Console App, ASP.NET Web Application etc.
3. Install **GroupDocs.Comparison for .NET** from Nuget or official GroupDocs website following the [guide]({{< ref "comparison/net/getting-started/installation.md" >}}).
4. Develop your first application with **GroupDocs.Comparison for .NET** like shown below:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
// ...

string sourceDocumentPath = @"C:\source.docx"; // NOTE: Put here actual path to source document
string targetDocumentPath = @"C:\target.docx"; // NOTE: Put here actual path to source document
string outputPath = @"C:\result.docx"; // NOTE: Put here actual path to source document

using (Comparer comparer = new Comparer(sourceDocumentPath))
{
    comparer.Add(targetDocumentPath);
    comparer.Compare(outputPath);
}
```
{{< /tab >}}
{{< /tabs >}}

5. Build and run your project.
6. Check the rendered document pages at path specified in the _"outputPath"_ parameter.

## Run back-end examples

The [GitHub](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET) hosts the complete GroupDocs.Comparison examples package. You can either [download the ZIP file](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET/archive/master.zip) or clone the GitHub repository using your favorite git client.  
If you download the ZIP file, extract it content to your local disk. The extracted files and folders will look as follows:

![](/comparison/net/images/how-to-run-examples.jpg)

In extracted files and folders, you can find CSharp solution file. The project is created using Visual Studio 2019. The **Resources** folder contains all the sample document and image files used in the examples.  
To run the examples, open the solution file in Visual Studio and build the project. To add missing references of GroupDocs.Comparison see [the installation guide]({{< ref "comparison/net/getting-started/installation.md" >}}). The **RunExamples.cs** calls all the functions.
Uncomment the function to run and comment the rest.

![](/comparison/net/images/how-to-run-examples_1.png)

## Run MVC examples

To run [GroupDocs.Comparison for .NET MVC Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-MVC), follow these steps:

1. Download [source code](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-MVC/archive/master.zip) from GitHub or clone this repository:
{{< tabs "example2">}}
{{< tab "CLI" >}}
  ```git
  git clone https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-MVC
  ```
{{< /tab >}}
{{< /tabs >}}

2. Open solution in the VisualStudio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
3. Open [http://localhost:8080/comparison](http://localhost:8080/comparison) in your favorite browser

For more details about project configuration please refer to this [guide](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-MVC#configuration).

## Run WebForms examples

You can run [GroupDocs.Comparison for .NET Web.Forms Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-WebForms) following these steps:

1. Download the [source code](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-WebForms/archive/master.zip) from GitHub or clone the repository:
 
{{< tabs "example3">}}
{{< tab "CLI" >}}
  ```git
  git clone https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-WebForms
  ```
{{< /tab >}}
{{< /tabs >}}

2. Open solution in the VisualStudio. Update common parameters in **web.config** and example related properties in the **configuration.yml** to meet your requirements.
3. Open [http://localhost:8080/comparison](http://localhost:8080/comparison) in browser.

For details, see the [guide](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-WebForms#configuration).

## Run using Docker

Use the [Docker](https://www.docker.com/) image to try GroupDocs.Comparison for .NET features in an easy way. Execute the following commands to run GroupDocs.Comparison for .NET from docker image:

{{< tabs "example4">}}
{{< tab "CLI" >}}
```powershell
mkdir DocumentSamples
mkdir Licenses
docker run -p 8080:8080 --env application.hostAddress=localhost -v `pwd`/DocumentSamples:/home/groupdocs/app/DocumentSamples -v `pwd`/Licenses:/home/groupdocs/app/Licenses groupdocs/comparison
## Open http://localhost:8080/comparison in your favorite browser.
```
{{< /tab >}}
{{< /tabs >}}

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /search/java/how-to-run-examples/

## Download from GitHub

The complete examples package of **GroupDocs.Search** is hosted on [GitHub](https://github.com/groupdocs-search/GroupDocs.Search-for-Java). You can either download the ZIP file from [here](https://github.com/groupdocs-search/GroupDocs.Search-for-Java/archive/master.zip) or clone the repository of GitHub using your favourite GitHub client.

In case you download the ZIP file, extract the folders on your local disk.

Open IntelliJ Idea and import the project to get started with it. Archived project file can also be imported. Follow the given steps to run the application:

*   Click file from the toolbar
*   Open project structure using
*   Select Modules at the left panel
*   Open Dependencies tab
*   Click '+' and click JARs or directories

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /search/net/how-to-run-examples/

## Build project from scratch

*   Open Visual Studio and go to **File** -> **New** -> **Project**.
*   Select appropriate project type - Console App, ASP.NET Web Application etc.
*   Install **GroupDocs.Search for .NET** from Nuget or official GroupDocs website following this [guide]({{< ref "search/net/getting-started/installation.md" >}}).
*   Code your first application with **GroupDocs.Search for .NET** like this:
    

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\"; // NOTE: Put here actual path for your documents
string query = "Einstein";

Index index = new Index(indexFolder); // Creating index in the specified folder
index.Add(documentsFolder); // Indexing documents from the specified folder

SearchResult result = index.Search(query); // Searching in index
foreach (FoundDocument document in result)
{
    Console.WriteLine(document.DocumentInfo.FilePath);
}
```

*   Build and Run your project.
*   List of found documents will appear in the console.

## Download examples from GitHub

The complete examples package of **GroupDocs.Search** is hosted on [GitHub](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET). You can either download the ZIP file from [here](https://codeload.github.com/groupdocs-search/GroupDocs.Search-for-.NET/zip/master) or clone the repository of GitHub using your favourite GitHub client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/search/net/images/how-to-run-examples.jpg)

In extracted files and folders, you can find the following solution file:

*   CSharp solution file

The project is created in **Microsoft Visual Studio 2012**. The **Data** folder contains all the sample document files used in the examples.

To run the examples, open the solution file in Visual Studio and build the project. To add missing references for **GroupDocs.Search** see [Installation]({{< ref "search/net/getting-started/installation.md" >}}). All the functions are called from **Program.cs**. Un-comment the function you want to run and comment the rest.

![](/search/net/images/how-to-run-examples_1.jpg)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /search/nodejs-java/how-to-run-examples/

The complete project [GroupDocs.Search Examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Node.js-via-Java) with code examples and sample files is hosted at Github.

## Run examples using NPM

To get started make sure that [Node.js](https://nodejs.org/) is installed.

1. Clone repository with examples git clone `https://github.com/groupdocs-search/GroupDocs.Search-for-Node.js-via-Java.git`
2. Navigate to the examples folder `cd ./GroupDocs.Search-for-Node.js-via-Java/`
3. Install the necessary packages with the `npm install` command.
4. Navigate to the examples folder `cd ./Examples`
5. Run the examples with the `node runExamples.js` command.

To check what examples are available open `Examples/runExamples.js` file using your favorite text editor. Uncomment examples that you want to run and type `node runExamples.js` to start them.

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code example and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## How to Run Examples

Path: /viewer/python-net/how-to-run-examples/


This page explains how to set up and run the code examples for **GroupDocs.Viewer for Python via .NET**.  
The examples demonstrate common usage scenarios such as rendering documents to **HTML, PDF, PNG, and JPEG**, working with documents inside archives, and retrieving document information.

## Prerequisites

Before running the examples, ensure that you have:

1. A **configured environment** that meets the requirements described in the [System Requirements]({{< ref "/viewer/python-net/getting-started/system-requirements.md" >}}) topic.
2. The **examples repository**, downloaded or cloned from GitHub:  
   <https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET>

## Project Structure

The examples repository closely follows the structure of this documentation, making it easy to locate specific examples and related input files.

```
📂 GroupDocs.Viewer-for-Python-via-.NET
├── Demos
│   ├── hello-world-docker
│   │   ├── output
│   │   ├── Dockerfile
│   │   ├── README.md
│   │   ├── render_docx_to_html.py
│   │   ├── requirements.txt
│   │   └── sample.docx
│   └── hello-world-macos
│       ├── output
│       ├── README.md
│       ├── render_docx_to_html.py
│       ├── requirements.txt
│       └── sample.docx
├── Examples
│   ├── getting-started
│   │   └── hello-world
│   │       ├── render_docx_to_html.py
│   │       ├── render_docx_to_pdf.py
│   │       ├── render_docx_to_png.py
│   │       └── sample.docx
│   ├── licensing
│   │   ├── set_license_from_file.py
│   │   ├── set_license_from_stream.py
│   │   └── set_metered_license.py
│   ├── requirements.txt
│   └── run_all_examples.py
├── LICENSE
```

## Setup Instructions

### 1. Create and Activate a Virtual Environment

Navigate to the `Examples` directory and create a virtual environment.

**Create a virtual environment:**

{{< tabs "example1">}}
{{< tab "Linux" >}}
```bash
python3 -m venv .venv
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m venv .venv
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py -m venv .venv
```
{{< /tab >}}
{{< /tabs >}}

**Activate the virtual environment:**

{{< tabs "example2">}}
{{< tab "Linux" >}}
```bash
source .venv/bin/activate
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
source .venv/bin/activate
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
.venv\Scripts\activate
```
{{< /tab >}}
{{< /tabs >}}

### 2. Install Dependencies

After activating the virtual environment, install the required dependencies:

{{< tabs "example3">}}
{{< tab "Linux" >}}
```bash
python3 -m pip install -r requirements.txt
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 -m pip install -r requirements.txt
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py -m pip install -r requirements.txt
```
{{< /tab >}}
{{< /tabs >}}

### 3. Configure License (Optional)

If you have a license file, you can configure it in the `run_all_examples.py` file.  
By default, **GroupDocs.Viewer for Python via .NET** searches for:

- The `GROUPDOCS_LIC_PATH` environment variable, or  
- A file with the `.lic` extension located in the project root directory.

{{< alert style="info" >}}
For more details about licensing, evaluation limitations, and obtaining a temporary license, see the [Licensing]({{< ref "/viewer/python-net/getting-started/licensing-and-subscription.md" >}}) documentation.
{{< /alert >}}

## Running Examples

### 1. Run All Examples

To execute all available examples, run the `run_all_examples.py` script:

{{< tabs "example4">}}
{{< tab "Linux" >}}
```bash
python3 run_all_examples.py
```
{{< /tab >}}
{{< tab "macOS" >}}
```bash
python3 run_all_examples.py
```
{{< /tab >}}
{{< tab "Windows" >}}
```ps
py run_all_examples.py
```
{{< /tab >}}
{{< /tabs >}}

This script runs each example sequentially and demonstrates:
- Rendering documents to HTML, PDF, PNG, and JPEG
- Processing documents stored in archives
- Retrieving document information
- Applying various rendering options

### 2. Run a Specific Example

To run a single example, navigate to the directory containing the desired script and execute it directly using Python.

### 3. Output Files

Most examples generate one or more output files. These files are typically saved in the same directory as the example script.  

## Troubleshooting

If you experience issues while running the examples:

- Verify that all dependencies are installed correctly.
- Ensure your environment meets the documented system requirements.
- Visit the [Technical Support]({{< ref "viewer/python-net/technical-support" >}}) page for additional help.

---

## How to run GroupDocs.Viewer in Docker

Path: /viewer/net/how-to-run-groupdocs-viewer-in-docker/


Docker provides an isolated environment for services and applications. In this topic we containerize sample application that is using GroupDocs.Viewer. You can learn more about conteinerization at [Introduction to .NET and Docker](https://learn.microsoft.com/en-us/dotnet/core/docker/introduction).

Running GroupDocs.Viewer in Docker is straightforward. First we prepare a sample application that uses [GroupDocs.Viewer.CrossPlatform](https://www.nuget.org/packages/GroupDocs.Viewer.CrossPlatform) NuGet package and than we build Docker image and run the applicaiton in Docker container.

In this documentation article we're going to use [Official .NET Docker image](https://learn.microsoft.com/en-us/dotnet/architecture/microservices/net-core-net-framework-containers/official-net-docker-images) that based on Debian Linux distribution.

## Prerequisites

**Docker:** Docker must be installed on your system. Refer to the official Docker documentation for detailed installation instructions check [Get Docker](https://docs.docker.com/get-docker/).

**.NET Application:** In this topic we'll run a sample .NET 8 application. You can download it from [here](/viewer/net/sample-files/how-to-run-groupdocs-viewer-in-docker/DemoApp.zip). Alternatively, you can use your own application based on the code snippets provided below.

{{< tabs "demo-app">}}
{{< tab "DemoApp.csproj" >}}  
```xml
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="GroupDocs.Viewer.CrossPlatform" Version="24.4.0" />
  </ItemGroup>

  <ItemGroup>
    <None Update="formatting.docx">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
  </ItemGroup>

</Project>
```
{{< /tab >}}
{{< tab "Program.cs" >}}  
```cs
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

namespace DemoApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // Instantiate Viewer and pass file name
            using (Viewer viewer = new Viewer("formatting.docx"))
            {
                // Configure view options
                HtmlViewOptions viewOptions =
                    HtmlViewOptions.ForEmbeddedResources("output/page-{0}.html");

                // Render DOCX to HTML
                viewer.View(viewOptions);
            }
        }
    }
}
```
{{< /tab >}}
{{< tab "formatting.docx" >}}  
{{< tab-text >}}
`formatting.docx` is sample DOCX file that we're going to use in this example. Click [here](/viewer/net/sample-files/how-to-run-groupdocs-viewer-in-docker/formatting.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Your folder tree should look similar to the following directory structure:

```Directory
📂 DemoApp
 ├──DemoApp.csproj
 ├──Program.cs
 └──formatting.docx
```

{{< alert style="info" >}}

This demo application references [GroupDocs.Viewer.CrossPlatform](https://www.nuget.org/packages/GroupDocs.Viewer.CrossPlatform) package. This package is recommended for Linux and macOS because it does not use `System.Drawing.Common` as a graphical subsystem, [which is only supported on Windows](https://learn.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only).

{{</ alert >}}

## Add Dockerfile

To create Docker image add a `Dockerfile` and a `.dockerignore` file to your project. 

{{< tabs "dockerfile">}}
{{< tab "Dockerfile" >}}  
```Dockerfile
FROM mcr.microsoft.com/dotnet/sdk:8.0
WORKDIR /app

# Add `contrib` archive area to package sources list
RUN sed -i 's/^Components: main$/& contrib/' /etc/apt/sources.list.d/debian.sources

# Download the package lists from the repositories
# and install two packages `fontconfig` and `ttf-mscorefonts-installer`
RUN apt update && apt install -y \
    fontconfig \
    ttf-mscorefonts-installer 

# Copy the application and restore packages
COPY . .
RUN dotnet restore 

# Run the application
ENTRYPOINT ["dotnet", "run"]
```
{{< /tab >}}
{{< tab ".dockerignore" >}}  
```txt
**/.dockerignore
**/Dockerfile*
**/.vs
**/.vscode
**/*.*proj.user
**/bin
**/obj
```
{{< /tab >}}
{{< /tabs >}}

At this point folder tree should look similar to the following directory structure:

```Directory
📂 DemoApp
 ├──DemoApp.csproj
 ├──Program.cs
 ├──formatting.docx
 ├──Dockerfile
 └──.dockerignore
```

The `Dockerfile` contains instructions to install two dependencies required by GroupDocs.Viewer:

**fontconfig:** This library configures and customizes font access.

**ttf-mscorefonts-installer:** This package provides Microsoft TrueType core fonts. It's available in the [contrib](https://www.debian.org/doc/debian-policy/ch-archive#s-contrib) archive area. (Note: Using non-free fonts may have licensing implications, so be sure to check the license terms.)

## Build Docker image

At this point we're ready to build Docker image. Make sure that Docker is up and running, navigate to `DemoApp` directory and type the following in command line to build the image.

```bash
docker build -t viewer-demo-app .
```

`-t` - is used to name and tag the image. We name the image `viewer-demo-app` with no tag.

`.`  - build context path. In this example it is current directory.

## Run Docker container

To run our containerized application use the following command in the `DemoApp` directory.

```bash
docker run --rm -v ${pwd}/output:/app/output viewer-demo-app
```

`--rm` - Removes the container and cleanups file system on completion.

`-v ${pwd}/output:/app/output` - Maps `./output` directory on our host OS to `/app/output` directory in Docker container.

After you run the application the `./output` directory will to contain two files `page-1.html` and `page-2.html` due to trial limitations. To render all the files you have to set a valid license. Learn more about evaluation and free trial limitations at [How to Evaluate GroupDocs.Viewer](/viewer/net/licensing-and-evaluation/).

## Conclusion

This topic demonstrated containerizing a sample .NET 8 application with Docker for running GroupDocs.Viewer. 
---

## How to Work with GroupDocs.Assembly for .NET Standard 2.0

Path: /assembly/net/how-to-work-with-groupdocs.assembly-for-net-standard-2.0/

GroupDocs.Assembly is built on top of several Aspose products. Some of the products use [SkiaSharp](https://www.nuget.org/packages/SkiaSharp/) to deal with graphics-related tasks within .NET Standard 2.0, whereas the others prefer [System.Drawing.Common](https://www.nuget.org/packages/System.Drawing.Common/). That is why, GroupDocs.Assembly depends on the both packages.

A recommended way to deal with these and other GroupDocs.Assembly for .NET Standard 2.0 dependencies is installing of [GroupDocs.Assembly NuGet package](https://www.nuget.org/packages/GroupDocs.Assembly/). Otherwise, you can install all dependencies listed at [the NuGet package page](https://www.nuget.org/packages/GroupDocs.Assembly/) manually.

Depending on OS you work on, you may need to install some additional dependencies as explained further.

## Using GroupDocs.Assembly for .NET Standard 2.0 in Windows

No additional dependencies arise.

## Using GroupDocs.Assembly for .NET Standard 2.0 in Linux

In addition to GroupDocs.Assembly NuGet package dependencies, [SkiaSharp.NativeAssets.Linux](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/) should be installed. Also, installing of additional components is required as shown by the following commands:

```
apt-get update && apt-get install -y libfontconfig1
```

```
apt-get update && apt-get install -y --allow-unauthenticated libc6-dev libgdiplus libx11-dev
```

## Using GroupDocs.Assembly for .NET Standard 2.0 in macOS

In addition to GroupDocs.Assembly NuGet package dependencies, [runtime.osx.10.10-x64.CoreCompat.System.Drawing](https://www.nuget.org/packages/runtime.osx.10.10-x64.CoreCompat.System.Drawing/) should be installed.

## Using GroupDocs.Assembly for .NET Standard 2.0 in Docker

Additional steps required to use GroupDocs.Assembly for .NET Standard 2.0 in Docker correspond to a type of containers being used. For example, for Linux containers, you should take the same additional steps as per "Using GroupDocs.Assembly for .NET Standard 2.0 in Linux" section.

---

## Inserting Chart Axis Title Dynamically in Spreadsheet Document

Path: /assembly/java/inserting-chart-axis-title-dynamically-in-spreadsheet-document/

{{< alert style="info" >}}This feature is supported by version 18.1 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft Excel Document

### Creating a Column Chart

Following steps, you can create a column chart in MS Excel 2013:

1.  Create a new Workbook
2.  Click the "Insert" tab, and then click "Insert Column Chart" icon in the Charts group to view the drop-down list
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your Worksheet
4.  Edit the Worksheet with your data to update the chart
5.  Save your Document

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must show the quantity of sales/orders
*   Sales/orders quantity must be represented by Quarters
*   It must associate order quantity with the corresponding customer
*   A report must be generated in the Spreadsheet Document

### Adding Syntax to be Evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
<<[title]>><<foreach [in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x [key.getName()]>>
```

#### Chart Data

**Legend Entries**

```java
="1st Quarter<<y [where(c => c.getDate().getMonth() >= 0 && c.getDate().getMonth() <= 2).sum(c => c.getPrice())]>>"
="2nd Quarter<<y [where(c => c.getDate().getMonth() >= 3 && c.getDate().getMonth() <= 5).sum(c => c.getPrice())]>>"
="3rd Quarter<<y [where(c => c.getDate().getMonth() >= 6 && c.getDate().getMonth() <= 8).sum(c => c.getPrice())]>>"
="4th Quarter<<y [where(c => c.getDate().getMonth() >= 9 && c.getDate().getMonth() <= 11).sum(c => c.getPrice())]>>"
```

#### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering with Dynamic Title document we created in this article:

*   [Chart Template.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_Dynamic_Title.xlsx) (Template for CustomObject and JSON examples) 

### Generating The Report

{{< gist GroupDocsGists 2f73ae9a61cddc1c34067925ce1d0f1c >}}



---

## Inserting Chart Axis Title Dynamically in Spreadsheet Document

Path: /assembly/net/inserting-chart-axis-title-dynamically-in-spreadsheet-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 18.1 or greater.{{< /alert >}}

## Column Chart in Microsoft Excel Document

### Creating a Column Chart

Following steps, you can create a column chart in MS Excel 2013:

1.  Create a new Workbook
2.  Click the "Insert" tab, and then click "Insert Column Chart" icon in the Charts group to view the drop-down list
3.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your Worksheet
4.  Edit the Worksheet with your data to update the chart
5.  Save your Document

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must show the quantity of sales/orders
*   Sales/orders quantity must be represented by Quarters
*   It must associate order quantity with the corresponding customer
*   A report must be generated in the Spreadsheet Document

### Adding Syntax to be Evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<<[title]>><<foreach [in orders
.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>><<x [Key.CustomerName]>>
```

#### Chart Data

**Legend Entries**

```csharp
="1st Quarter<<y [Where(c => c.OrderDate.Month >= 1 && c.OrderDate.Month <= 3).Sum(c => c.ProductQuantity)]>>"
="2nd Quarter<<y [Where(c => c.OrderDate.Month >= 4 && c.OrderDate.Month <= 6).Sum(c => c.ProductQuantity)]>>"
="3rd Quarter<<y [Where(c => c.OrderDate.Month >= 7 && c.OrderDate.Month <= 9).Sum(c => c.ProductQuantity)]>>"
="4th Quarter<<y [Where(c => c.OrderDate.Month >= 10 && c.OrderDate.Month <= 12).Sum(c => c.ProductQuantity)]>>"
```

### Download Template

Please download the sample Chart with Filtering, Grouping, and Ordering with Dynamic Title document we created in this article:

*   [Chart Template.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_Dynamic_Title.xlsx) (Template for CustomObject and JSON examples) 

### Generating The Report

{{< gist GroupDocsGists 251fa6d077fd45b1222a6f352c4329b2 >}}



---

## Launch in operating systems other than windows

Path: /watermark/net/launch-in-operating-systems-other-than-windows/

## Limitations

1. Because of the lack of Windows fonts in target OS (Android, macOS, Linux, etc), fonts used in documents are substituted with available fonts, this might lead to inaccurate document layout when rendering the document to PNG, JPG, and PDF.
2. If GroupDocs.Watermark for .NET Standard is intended to be used in a Linux environment, an additional NuGet package should be referenced to make it work correctly with graphics: [SkiaSharp.NativeAssets.Linux](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux) for Ubuntu (it also should work on most Debian-based Linux distributions) or [Goelze.SkiaSharp.NativeAssets.AlpineLinux](https://www.nuget.org/packages/Goelze.SkiaSharp.NativeAssets.AlpineLinux) for Alpine Linux.
3. If the target framework is .NET 6, due to limitations in the System.Drawing.Common library in .NET 6 (see [Microsoft documentation](https://learn.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only#new-behavior)), you need to add the following setting to the `.csproj` file.

```csharp
	<ItemGroup>
		<RuntimeHostConfigurationOption Include="System.Drawing.EnableUnixSupport" Value="true" />
	</ItemGroup>
```

## Recommendations

When using GroupDocs.Watermark in a non-Windows environment, the following packages should be installed to improve rendering results and prevent possible runtime errors:

1. libgdiplus - is the Mono library that provides a GDI+-compatible API on non-Windows operating systems.
2. libc6-dev - package contains the symlinks, headers, and object files needed to compile and link programs which use the standard C library.
3. ttf-mscorefonts-installer - package with Microsoft compatible fonts.

To install packages on Debian-based Linux distributions use [apt-get](https://wiki.debian.org/apt-get) utility:

1. sudo apt-get install libgdiplus
2. sudo apt-get install libc6-dev
3. sudo apt-get install ttf-mscorefonts-installer

4. 

## How to run .net GroupDocs.Watermark in the Docker

Running GroupDocs.Watermark in Docker is straightforward. All you need to do is add the installation of the packages described in the previous paragraph to the docker file. An example beginning of the Dockerfile might look like this:

```Dockerfile
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

# Add libgdiplus, libc6-dev
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Add `contrib` archive area to package sources list
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list
# Add fonts
RUN apt-get update; apt-get install -y ttf-mscorefonts-installer fontconfig
RUN fc-cache -f -v

# etc
```

**fontconfig:** This library configures and customizes font access.

**ttf-mscorefonts-installer:** This package provides Microsoft TrueType core fonts. It's available in the [contrib](https://www.debian.org/doc/debian-policy/ch-archive#s-contrib) archive area. (Note: Using non-free fonts may have licensing implications, so be sure to check the license terms.)

---

## Licensing and Subscription

Path: /merger/java/licensing-and-subscription/


Sometimes, in order to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Merger provides different plans for purchase or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Merger without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Resultant document will be trimmed to first 3 pages.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Merger without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Merger API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Merger.dll file and specify the file name, without a path, as shown in the examples below.

### Setting License from File

The code below will explain how to set product license.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-merger/GroupDocs.Merger-for-Java
// Setup license.
License license = new License();
license.setLicense(licensePath);
```

### Setting License from Stream

The following example shows how to load a license from a stream.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-merger/GroupDocs.Merger-for-Java
InputStream fileStream = new FileInputStream("GroupDocs.Merger.lic"))
License license = new License();
license.setLicense(fileStream);
```

{{< alert style="info" >}}Calling License.setLicense multiple times is not harmful but simply wastes processor time. Call License.setLicense in your startup code, before using GroupDocs.Merger classes. Do not call License.setLicense from within Page_Load methods since it means the license will be loaded every time a web page is loaded.{{< /alert >}}

### Setting Metered License

{{< alert style="info" >}}You can also set [Metered](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.{{< /alert >}}
Here are the simple steps to use the [Metered](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered) class.

1. Create an instance of [Metered](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered) class.
2. Pass public & private keys to [setMeteredKey](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered#setMeteredKey(java.lang.String,%20java.lang.String)) method.
3. Do processing (perform task).
4. call method [getConsumptionQuantity](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered#getConsumptionQuantity()) of the [Metered](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered) class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. call method [getConsumptionCredit](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered#getConsumptionCredit()) of the [Metered](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered) class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use [Metered](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered) class.

Following is the sample code demonstrating how to use [Metered](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.licensing.metered/Metered) class.

```java
// For complete examples and data files, please go to https://github.com/groupdocs-merger/GroupDocs.Merger-for-Java
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.setMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
double amountConsumed = Metered.getConsumptionQuantity();
System.out.print("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
double creditsConsumed = Metered.getConsumptionCredit();
System.out.print("Credits consumed: " + creditsConsumed);
```
---

## Load custom fonts.

Path: /annotation/net/loading-custom-fonts/


GroupDocs.Annotation v21.5 and later allows you to generate preview for documents using custom fonts. To do this, specify the [FontDirectories](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/loadoptions/properties/fontdirectories) property of the [LoadOptions](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/loadoptions) class.

The following code snippet shows how to use custom fonts while generating preview:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator(fs, new LoadOptions { FontDirectories = new List<string> { $"D:/fonts" } }))
{
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = $"D:/result_{pageNumber}.png";
        return File.Create(pagePath);
    });

    annotator.Document.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Load personal storage PST or OST with options

Path: /conversion/java/load-personal-storage-pst-or-ost-with-options/

[GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/) provides developers with the ability to load and process email storage files, such as PST (Personal Storage Table) or OST (Offline Storage Table), with advanced configuration options. This functionality supports custom handling of email data during the conversion process, enabling precise control over the input data. Using the [PersonalStorageLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/personalstorageloadoptions/) class for this you can set the following options:
| Option | Description |
|--------|-------------|
| [**setConvertOwned()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/personalstorageloadoptions/#isConvertOwned--) | Controls whether owned documents of the document container must be converted. |
| [**setConvertOwner()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/personalstorageloadoptions/#isConvertOwner--) | Controls whether the document container itself must be converted. If this property is true the document container will be the first converted document. |
| [**setDepth()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/personalstorageloadoptions/#getDepth--) | Controls how many levels in depth to perform the conversion. |
| [**setFolder()**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/personalstorageloadoptions/#getFolder--) | A folder to be processed. Default is Inbox. |

### Get folders from personal storage

The following code snippet shows how to get folders within the personal storage document:

{{< tabs "code-example">}}
{{< tab "ConvertPdfAndFlattenAllFields.java" >}}
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.documentinfo.IDocumentInfo;
import com.groupdocs.conversion.contracts.documentinfo.PersonalStorageDocumentInfo;
import com.groupdocs.conversion.contracts.documentinfo.PersonalStorageFolderInfo;
import com.groupdocs.conversion.examples.Constants;

public class GetFoldersFromPersonalStorage {
    public static void convert() {
        try(Converter converter = new Converter("sample.ost")) {
            IDocumentInfo documentInfo = converter.getDocumentInfo();
            PersonalStorageDocumentInfo ostInfo = (PersonalStorageDocumentInfo) documentInfo;
            System.out.print(ostInfo.getRootFolderName());
            for (PersonalStorageFolderInfo folder : ostInfo.getFolders()) {
                System.out.print(folder);
            }
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.ost" >}}  
{{< tab-text >}}
`sample.ost` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-personal-storage-pst-or-ost-with-options/sample.ost) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


### Convert each personal storage content to different formats

The following code snippet shows how to convert each personal storage content to a different format based on the content type: 

*   JPG attachments will be converted to PNG
*   DOCX attachments will be converted to PDF
*   Emails and all other types will be converted to HTML

{{< tabs "code-example1">}}
{{< tab "ConvertPersonalStorageContentToDifferentFormats.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.ConvertOptionsProvider;
import com.groupdocs.conversion.contracts.LoadOptionsForFileTypeProvider;
import com.groupdocs.conversion.contracts.SaveDocumentStreamForFileType;
import com.groupdocs.conversion.filetypes.EmailFileType;
import com.groupdocs.conversion.filetypes.ImageFileType;
import com.groupdocs.conversion.filetypes.WordProcessingFileType;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.convert.WebConvertOptions;
import com.groupdocs.conversion.options.load.EmailLoadOptions;
import com.groupdocs.conversion.options.load.PersonalStorageLoadOptions;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;

public class ConvertPersonalStorageContentToDifferentFormats {
    public static void convert() {
        LoadOptionsForFileTypeProvider loadOptionsProvider = (fileType)->{
            if (fileType == EmailFileType.Ost)
            {
                PersonalStorageLoadOptions personalOpt = new PersonalStorageLoadOptions();
                personalOpt.setFolder("Inbox");
                return personalOpt;
            }

            if (fileType == EmailFileType.Msg)
            {
                EmailLoadOptions emailOpt =  new EmailLoadOptions();
                emailOpt.setConvertOwner(true);
                emailOpt.setConvertOwned(true);
                emailOpt.setDepth(2);
                return emailOpt;
            }
            return null;
        };

        try(Converter converter = new Converter("sample.ost", loadOptionsProvider))
        {
            final int[] index = {0};
            SaveDocumentStreamForFileType saveStream = (fileType) -> {
                String fileName = String.format("converted_%d.%s", index[0], fileType.getExtension());
                index[0]++;
                try {
                    return new FileOutputStream(fileName);
                } catch (FileNotFoundException e) {
                    throw new RuntimeException(e);
                }
            };
            ConvertOptionsProvider provider = (sourceFileName, fileType) -> {
                if (fileType == ImageFileType.Jpg)
                {
                    ImageConvertOptions imageOpt =  new ImageConvertOptions();
                    imageOpt.setFormat(ImageFileType.Png);
                    return imageOpt;
                }
                if (fileType == WordProcessingFileType.Docx)
                {
                    return new PdfConvertOptions();
                }
                return new WebConvertOptions();
            };

            converter.convert(saveStream, provider);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.ost" >}}  
{{< tab-text >}}
`sample.ost` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-personal-storage-pst-or-ost-with-options/sample.ost) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "output.zip" >}}  
{{< tab-text >}}
The result of this conversion is a variety of different file types, which we put into `output.zip` archive. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-personal-storage-pst-or-ost-with-options/output.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Load personal storage PST or OST with options

Path: /conversion/net/load-personal-storage-pst-or-ost-with-options/

GroupDocs.Conversion provides [PersonalStorageLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/personalstorageloadoptions) to give you control over how the source personal storage (PST/OST) document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[ConvertOwned](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/personalstorageloadoptions/convertowned)** | Controls whether owned documents of the document container must be converted. |
|**[ConvertOwner](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/personalstorageloadoptions/convertowner)** | Controls whether the document container itself must be converted. If this property is true the document container will be the first converted document. |
|**[Depth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/personalstorageloadoptions/depth)** | Controls how many levels in depth to perform the conversion. |
|**[Folder](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/personalstorageloadoptions/folder)** | A folder to be processed. Default is Inbox. |

### Get folders from personal storage

The following code snippet shows how to get folders within the personal storage document:

```csharp
using (Converter converter = new Converter("sample.pst"))
{
    var documentInfo = converter.GetDocumentInfo();
    var ostInfo = (PersonalStorageDocumentInfo) documentInfo;
    Console.WriteLine(ostInfo.RootFolderName);
    foreach (var folder in ostInfo.Folders)
    {
        Console.WriteLine(folder);
    }
}
```

### Convert each personal storage content to different formats

The following code snippet shows how to convert each personal storage content to a different format based on the content type:

*   JPG attachments will be converted to PNG
*   DOCX attachments will be converted to PDF
*   Emails and all other types will be converted to HTML

```csharp
using (Converter converter = new Converter("sample.pst", (LoadContext loadContext) =>
       {
           if (loadContext.SourceFormat == EmailFileType.Ost)
           {
               return new PersonalStorageLoadOptions
               {
                   Folder = "Inbox",
               };
           }
           if (loadContext.SourceFormat == EmailFileType.Msg)
           {
               return new EmailLoadOptions
               {
                   ConvertOwner = true,
                   ConvertOwned = true,
                   Depth = 2
               };
           }
           return null;
       }))
{
    int index = 0;
    converter.Convert((SaveContext saveContext) =>
    {
        string fileName = $"converted_{++index}.{saveContext.TargetFormat.Extension}";
        return new FileStream(fileName, FileMode.Create);
    }, (ConvertContext convertContext) =>
    {
        if (convertContext.SourceFormat == ImageFileType.Jpg)
        {
            return new ImageConvertOptions
            {
                Format = ImageFileType.Png
            };
        }
        if (convertContext.SourceFormat == WordProcessingFileType.Docx)
        {
            return new PdfConvertOptions();
        }
        return new WebConvertOptions();
    });
}
```

---

## Load Spreadsheet document with options

Path: /conversion/java/load-spreadsheet-document-with-options/

The [GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/) library allows developers to load and manipulate spreadsheet files with advanced configuration using the [SpreadsheetLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions). This class provides a flexible approach for customizing how spreadsheet data is interpreted and loaded prior to conversion. For this the following options could be set:
| Option | Description |
|--------|-------------|
| [**setFormat()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setFormat(com.groupdocs.conversion.filetypes.SpreadsheetFileType)) | Allows you to specify explicitly the type of the source spreadsheet document. Available options are: *Xls, Xlsx, Xlsm, Xlsb, Ods, Ots, Xltx, Xlt, Xltm, Tsv, Xlam, Csv*. |
| [**setDefaultFont()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setDefaultFont(java.lang.String)) | Sets a default font. The following font will be used if a spreadsheet font is missing. |
| [**setFontSubstitutes()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setFontSubstitutes(java.util.List)) | Sets substitute specific fonts from the source spreadsheet document. |
| [**setShowGridLines()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setShowGridLines(boolean)) | Specifies that grid lines should be visible. |
| [**setShowHiddenSheets()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setShowHiddenSheets(boolean)) | Specifies that hidden sheet should be included in the converted document. |
| [**setOnePagePerSheet()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setOnePagePerSheet(boolean)) | Specifies that one sheet from the spreadsheet must be converted to a single page. |
| [**setConvertRange()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setConvertRange(java.lang.String)) | Specifies that a specific range of cells must be converted. Example: "D1:F8". |
| [**setSkipEmptyRowsAndColumns()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setSkipEmptyRowsAndColumns(boolean)) | Specifies that empty rows and columns must be ignored. |
| [**setPassword()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setPassword(java.lang.String)) | Specifies a password to unlock the protected document. |
| [**setHideComments()**](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/SpreadsheetLoadOptions#setHideComments(boolean)) | Specifies that comments from the source spreadsheet must be hidden during conversion. |

These options enable precise handling of spreadsheet formats like XLS, XLSX, CSV, and others, simplifying the process of preparing files for conversion into a target format.

### Hide comments

The following code snippet shows how to convert a spreadsheet and hide comments:

{{< tabs "code-example">}}
{{< tab "ConvertSpreadsheetAndHideComments.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class ConvertSpreadsheetAndHideComments {
    public static void convert() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setHideComments(true);
        loadOptions.setOnePagePerSheet(true);

        try(Converter converter = new Converter("cost-analysis.xlsx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_without_comments.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_without_comments.pdf" >}}  
{{< tab-text >}}
`converted_without_comments.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/converted_without_comments.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Show grid lines

The following code snippet shows how to convert a spreadsheet and show grid lines:

{{< tabs "code-example1">}}
{{< tab "ConvertSpreadsheetByShowingGridLines.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class ConvertSpreadsheetByShowingGridLines {
    public static void convert() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setShowGridLines(true);
        loadOptions.setOnePagePerSheet(true);

        try(Converter converter = new Converter("sample.xlsx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_gridlines.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.xlsx" >}}  
{{< tab-text >}}
`sample.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/sample.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_gridlines.pdf" >}}  
{{< tab-text >}}
`converted_with_gridlines.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/converted_with_gridlines.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Skip empty rows and columns

The following code snippet shows how to convert a spreadsheet and skip empty rows and columns:

{{< tabs "code-example2">}}
{{< tab "ConvertSpreadsheetBySkippingEmptyRowsAndColumns.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class ConvertSpreadsheetBySkippingEmptyRowsAndColumns {
    public static void convert() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setSkipEmptyRowsAndColumns(true);
        loadOptions.setOnePagePerSheet(true);

        try(Converter converter = new Converter("sample.xlsx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_skipping_empty_rows.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.xlsx" >}}  
{{< tab-text >}}
`sample.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/sample.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_skipping_empty_rows.pdf" >}}  
{{< tab-text >}}
`converted_with_skipping_empty_rows.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/converted_with_skipping_empty_rows.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Specify font substitution

The following code snippet shows how to convert a spreadsheet and specify font substitution for missing fonts:

{{< tabs "code-example3">}}
{{< tab "ConvertSpreadsheetBySpecifyingFontSubstitution.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.FontSubstitute;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;
import java.util.ArrayList;
import java.util.List;

public class ConvertSpreadsheetBySpecifyingFontSubstitution {
    public static void convert() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

        List<FontSubstitute> fontSubstitutes = new ArrayList<FontSubstitute>();
        fontSubstitutes.add(FontSubstitute.create("Aharoni", "Arial"));

        loadOptions.setOnePagePerSheet(true);
        loadOptions.setFontSubstitutes(fontSubstitutes);

        try(Converter converter = new Converter("cost-analysis.xlsx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_fontsubstitution.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_fontsubstitution.pdf" >}}  
{{< tab-text >}}
`converted_with_fontsubstitution.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/converted_with_fontsubstitution.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Specify range

The following code snippet shows how to convert a spreadsheet and specify the exact range of rows and columns to be converted:

{{< tabs "code-example4">}}
{{< tab "ConvertSpreadsheetBySpecifyingRange.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class ConvertSpreadsheetBySpecifyingRange {
    public static void convert() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setConvertRange("10:30");
        loadOptions.setOnePagePerSheet(true);

        try(Converter converter = new Converter("sample.xlsx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_by_specifying_range.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.xlsx" >}}  
{{< tab-text >}}
`sample.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/sample.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_by_specifying_range.pdf" >}}  
{{< tab-text >}}
`converted_by_specifying_range.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/converted_by_specifying_range.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Include hidden sheets

The following code snippet shows how to convert a spreadsheet including the hidden sheets:

{{< tabs "code-example5">}}
{{< tab "ConvertSpreadsheetWithHiddenSheetsIncluded.java" >}} 
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

public class ConvertSpreadsheetWithHiddenSheetsIncluded {
    public static void convert() {
        SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
        loadOptions.setShowHiddenSheets(true);
        loadOptions.setOnePagePerSheet(true);

        try(Converter converter = new Converter("with_hidden_sheet.xlsx", () -> loadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert("converted_with_hidden_sheets.pdf", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "with_hidden_sheet.xlsx" >}}  
{{< tab-text >}}
`with_hidden_sheet.xlsx` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/with_hidden_sheet.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted_with_hidden_sheets.pdf" >}}  
{{< tab-text >}}
`converted_with_hidden_sheets.pdf` is converted PDF document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-spreadsheet-document-with-options/converted_with_hidden_sheets.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Load Spreadsheet document with options

Path: /conversion/nodejs-java/load-spreadsheet-document-with-options/

GroupDocs.Conversion provides [SpreadsheetLoadOptions](#) to give you control over how the source spreadsheet document will be processed. The following options could be set:

*   **[setFormat](#)** allows you to specify explicitly the type of the source spreadsheet document. Available options are: *Xls, Xlsx, Xlsm, Xlsb, Ods, Ots, Xltx, Xlt, Xltm, Tsv, Xlam, Csv*.
*   **[setDefaultFont](#)** sets a default font. The following font will be used if a spreadsheet font is missing.      
*   **[setFontSubstitutes](#)** sets substitute specific fonts from the source spreadsheet document.
*   **[setShowGridLines](#)** specifies that grid lines should be visible.    
*   **[setShowHiddenSheets](#)** specifies that hidden sheet should be included in the converted document.     
*   **[setOnePagePerSheet](#)** specifies that one sheet from the spreadsheet must be converted to a single page.    
*   **[setConvertRange](#)** specifies that a specific range of cells must be converted. Example: "D1:F8".
*   **[setSkipEmptyRowsAndColumns](#)** specifies that empty rows and columns must be ignored.
*   **[setPassword](#)** specifies a password to unlock the protected document.
*   **[setHideComments](#)** specifies that comments from the source spreadsheet must be hidden during conversion.

### Hide comments

The following code snippet shows how to convert a spreadsheet and hide comments:

```js
const loadOptions = new groupdocs.conversion.SpreadsheetLoadOptions();
loadOptions.setHideComments(true);
loadOptions.setOnePagePerSheet(true);

const outputPath = "ConvertSpreadsheetAndHideComments.pdf";

const converter = new groupdocs.conversion.Converter("sample.xlsx", loadOptions);
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

console.log(`Spreadsheet document converted successfully to ${outputPath} (hide comments)`);
converter.convert(outputPath, convertOptions);
```

### Show grid lines

The following code snippet shows how to convert a spreadsheet and show grid lines:

```js
const loadOptions = new groupdocs.conversion.SpreadsheetLoadOptions();
loadOptions.setShowGridLines(true);
loadOptions.setOnePagePerSheet(true);

const outputPath = "ConvertSpreadsheetByShowingGridLines.pdf";

const converter = new groupdocs.conversion.Converter("sample.xlsx", loadOptions);
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

console.log(`Spreadsheet document converted successfully to ${outputPath} (show grid lines)`);
converter.convert(outputPath, convertOptions);
```

### Skip empty rows and columns

The following code snippet shows how to convert a spreadsheet and skip empty rows and columns:

```js
const loadOptions = new groupdocs.conversion.SpreadsheetLoadOptions();
loadOptions.setSkipEmptyRowsAndColumns(true);
loadOptions.setOnePagePerSheet(true);

const outputPath = "ConvertSpreadsheetBySkippingEmptyRowsAndColumns.pdf";

const converter = new groupdocs.conversion.Converter("sample.xlsx", loadOptions);
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

console.log(`Spreadsheet document converted successfully to ${outputPath} (skip empty rows & columns)`);
converter.convert(outputPath, convertOptions);
```

### Specify font substitution

The following code snippet shows how to convert a spreadsheet and specify font substitution for missing fonts:

```js
const java = require('java');

const outputPath = "ConvertSpreadsheetBySpecifyingFontsubstitution.pdf";

const fontSubstitutes = java.newInstanceSync("java.util.ArrayList");
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Tahoma", "Arial"));
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Times New Roman", "Arial"));

const loadOptions = new groupdocs.conversion.SpreadsheetLoadOptions();
loadOptions.setDefaultFont("Helvetica.ttf");
loadOptions.setOnePagePerSheet(true);
loadOptions.setFontSubstitutes(fontSubstitutes);

const converter = new groupdocs.conversion.Converter("sample.xlsx", loadOptions);
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

console.log(`Spreadsheet document converted successfully to ${outputPath} (by specifying font subs)`);
converter.convert(outputPath, convertOptions);
```

### Specify range

The following code snippet shows how to convert a spreadsheet and specify the exact range of rows and columns to be converted:

```js
const loadOptions = new groupdocs.conversion.SpreadsheetLoadOptions();
loadOptions.setConvertRange('10:30');
loadOptions.setOnePagePerSheet(true);

const outputPath = "ConvertSpreadsheetBySpecifyingRange.pdf";

const converter = new groupdocs.conversion.Converter("sample.xlsx", loadOptions);
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

console.log(`Spreadsheet document converted successfully to ${outputPath} (by specifying range)`);
converter.convert(outputPath, convertOptions);
```

### Include hidden sheets

The following code snippet shows how to convert a spreadsheet including the hidden sheets:

```js
const loadOptions = new groupdocs.conversion.SpreadsheetLoadOptions();
loadOptions.setShowHiddenSheets(true);
loadOptions.setOnePagePerSheet(true);

const outputPath = "ConvertSpreadsheetWithHiddenSheetsIncluded.pdf";

const converter = new groupdocs.conversion.Converter("sample.xlsx", loadOptions);
const convertOptions = new groupdocs.conversion.PdfConvertOptions();

console.log(`Spreadsheet document converted successfully to ${outputPath} (with hidden sheets included)`);
converter.convert(outputPath, convertOptions);
```

---

## Render Project documents as HTML, PDF, and image files

Path: /viewer/java/render-ms-project-files/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render Project files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Project or other project management software to load and view Project files within your Java application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/project" >}} {{< icon "gdoc_person" >}} View Project files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Project Management file formats

GroupDocs.Viewer supports the following Project Management file formats:

* [Microsoft Project](https://docs.fileformat.com/project-management/mpp) (.MPP)
* [Microsoft Project Template](https://docs.fileformat.com/project-management/mpt) (.MPT)
* [Microsoft Project Exchange File](https://docs.fileformat.com/project-management/mpx) (.MPX)

## Render Project files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Project file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    // Render the project's active view as HTML.
    // {0} is replaced with the current page number in the output file names.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to HTML](/viewer/java/images/rendering-basics/render-ms-project-files/render-project-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    // Render the project's active view as HTML.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the page number and resource name, respectively.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-ms-project-files/render-project-to-html-external-resources.png)

## Render Project files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Project file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PDF](/viewer/java/images/rendering-basics/render-ms-project-files/render-project-to-pdf.png)

## Render Project files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Project file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    // Render the project's active view as PNG.
    // {0} is replaced with the page numbers in the output image names.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(1600);
    viewOptions.setHeight(650);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PNG](/viewer/java/images/rendering-basics/render-ms-project-files/render-project-to-png-image.png)

## Render Project files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a Project file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    // Render the project's active view as JPG.
    // {0} is replaced with the page numbers in the output image names.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(1600);
    viewOptions.setHeight(650);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Get information about a Project file

Follow the steps below to obtain information about a Project file (the file format, the number of pages, the project's start and end dates): 

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [ProjectManagementViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/projectmanagementviewinfo) type.
3. Use the `ProjectManagementViewInfo` class properties to retrieve information about the Project file.

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ProjectManagementViewInfo;
// ...

ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();

ProjectManagementViewInfo info;
try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    info = (ProjectManagementViewInfo) viewer.getViewInfo(viewInfoOptions);
}
System.out.println("Document type is: " + info.getFileType());
System.out.println("Pages count: " + info.getPages().size());
System.out.println("Project start date: " + info.getStartDate());
System.out.println("Project end date: " + info.getEndDate());
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a Project file](/viewer/java/images/rendering-basics/render-ms-project-files/retrieve-project-file-information.png)

## Specify the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert your Project document to HTML, PDF, or image format. Use the [ProjectManagementOptions.setPageSize](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/projectmanagementoptions/#setPageSize-com.groupdocs.viewer.options.PageSize-) method to select one of the predefined page sizes (LETTER, LEDGER, A0, A1, A2, A3, or A4) (see the [PageSize](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pagesize) enumeration). You can use this method for the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

The following example specifies page size for the output PDF file:

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.ProjectManagementOptions
// ...

try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Specify the page size.
    viewOptions.getProjectManagementOptions().setPageSize(PageSize.A3);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}


## Adjust the time unit

When rendering a Project file, GroupDocs.Viewer selects the smallest time unit on a timescale based on the total length of the project. You can adjust the timescale to show smaller or greater time units (from days to months). To do this, use the [ViewOptions.getProjectManagementOptions().setTimeUnit](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/projectmanagementoptions/#setTimeUnit-com.groupdocs.viewer.options.TimeUnit-) method for a target view to one of the following [TimeUnit](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/timeunit) enumeration members:

* `DAYS` displays days on the timescale.
* `THIRDS_OF_MONTHS` displays the Beginning/Middle/End (B/M/E) of each month on the timescale.
* `MONTHS` displays months on the timescale.
* `UNSPECIFIED` means that the timescale unit is not specified.

The following code sample demonstrates how to specify the timescale unit when rendering a Project file to HTML:

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.ProjectManagementOptions
// ...

try (Viewer viewer = new Viewer("sample.mpp")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewOptions.getProjectManagementOptions().setTimeUnit(TimeUnit.DAYS);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render a Project with the timescale unit set to thirds of months](/viewer/java/images/rendering-basics/render-ms-project-files/render-project-with-custom-time-unit.png)

## Render specific dates

With GroupDocs.Viewer, you can render only a portion of the project's timeline when you convert your Project file to HTML, PDF, or image format. Use the [ViewOptions.getProjectManagementOptions().setStartDate](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/projectmanagementoptions/#setStartDate-java.util.Date-) and [ViewOptions.getProjectManagementOptions().setEndDate](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/projectmanagementoptions/#setEndDate-java.util.Date-) methods for a target view to specify a date range the timeline should display. If you set only the `StartDate` property, the timeline displays information for tasks from the specified date to the project's finish date. If you set only the `EndDate` property, the timeline contains dates from the project's start date to the specified date.

The example below demonstrates how to convert a Project file to PDF and set the timeline date range.

{{< tabs "example9">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ProjectManagementViewInfo;
// ...
try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {

    ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
    ProjectManagementViewInfo viewInfo = (ProjectManagementViewInfo) viewer.getViewInfo(viewInfoOptions);
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    viewOptions.getProjectManagementOptions().setStartDate(new Date(2022, 8, 1, 0, 0));
    viewOptions.getProjectManagementOptions().setEndDate(new Date(2022, 9, 1, 0, 0));

    viewer.view(viewOptions);
}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render tasks for a specific date range](/viewer/java/images/rendering-basics/render-ms-project-files/render-tasks-between-two-dates.png)

## Render notes

Microsoft Project allows you to add notes to tasks, resources, and assignments.

![Speaker notes in Microsoft Project](/viewer/java/images/rendering-basics/render-ms-project-files/project-task-notes.png)

If you need to display these notes in the output HTML, PDF, or image files, use the [ViewOptions.setRenderNotes](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setRenderNotes-boolean-) method for a target view.

The following code sample converts a Project file with task notes to PDF:

{{< tabs "example10">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.ProjectManagementOptions
// ...

try (Viewer viewer = new Viewer("SoftwareDevelopmentPlan.mpp")) {
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    // Enable notes rendering.
    viewOptions.setRenderNotes(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. Notes are rendered on a separate page.

![Render a Project file with task notes](/viewer/java/images/rendering-basics/render-ms-project-files/render-task-notes-to-pdf.png)

---

## Render Project documents as HTML, PDF, and image files

Path: /viewer/net/render-ms-project-files/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render Project files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Project or other project management software to load and view Project files within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/project" >}} {{< icon "gdoc_person" >}} View Project files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Project Management file formats

GroupDocs.Viewer supports the following Project Management file formats:

* [Microsoft Project](https://docs.fileformat.com/project-management/mpp) (.MPP)
* [Microsoft Project Template](https://docs.fileformat.com/project-management/mpt) (.MPT)
* [Microsoft Project Exchange File](https://docs.fileformat.com/project-management/mpx) (.MPX)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

{{< alert style="info" >}}Family of the Project Management file formats (MPP, MPT, and MPX) currently is not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

## Render Project files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Project file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Render the project's active view as HTML.
    // {0} is replaced with the current page number in the output file names.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Render the project's active view as HTML.
            ' {0} is replaced with the current page number in the output file names.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to HTML](/viewer/net/images/rendering-basics/render-ms-project-files/render-project-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Render the project's active view as HTML.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Render the project's active view as HTML.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-ms-project-files/render-project-to-html-external-resources.png)

## Render Project files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Project file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Create a PDF file for the project's active view.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Create a PDF file for the project's active view.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PDF](/viewer/net/images/rendering-basics/render-ms-project-files/render-project-to-pdf.png)

## Render Project files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Project file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Render the project's active view as PNG.
    // {0} is replaced with the current page number in the output file names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 1600;
    viewOptions.Height = 650;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Render the project's active view as PNG.
            ' {0} is replaced with the current page number in the output file names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 1600
            viewOptions.Height = 650
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PNG](/viewer/net/images/rendering-basics/render-ms-project-files/render-project-to-png-image.png)

## Render Project files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a Project file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Render the project's active view as JPEG.
    // {0} is replaced with the current page number in the output file names.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 1600;
    viewOptions.Height = 650;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Render the project's active view as JPEG.
            ' {0} is replaced with the current page number in the output file names.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 1600
            viewOptions.Height = 650
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Get information about a Project file

Follow the steps below to obtain information about a Project file (the file format, the number of pages, the project's start and end dates): 

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.GetViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getviewinfo) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [ProjectManagementViewInfo](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/projectmanagementviewinfo) type.
3. Use the `ProjectManagementViewInfo` class properties to retrieve information about the Project file.

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    var viewInfoOptions = ViewInfoOptions.ForHtmlView();
    var viewInfo = viewer.GetViewInfo(viewInfoOptions) as ProjectManagementViewInfo;

    if (viewInfo != null)
    {
        // Display information about the Project file.
        Console.WriteLine($"File type: {viewInfo.FileType}");
        Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}");
        Console.WriteLine($"Project start date: {viewInfo.StartDate}");
        Console.WriteLine($"Project end date: {viewInfo.EndDate}");
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            Dim viewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo = TryCast(viewer.GetViewInfo(viewInfoOptions), ProjectManagementViewInfo)
        
            If viewInfo IsNot Nothing Then
                ' Display information about the Project file.
                Console.WriteLine($"File type: {viewInfo.FileType}")
                Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}")
                Console.WriteLine($"Project start date: {viewInfo.StartDate}")
                Console.WriteLine($"Project end date: {viewInfo.EndDate}")
            End If
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a Project file](/viewer/net/images/rendering-basics/render-ms-project-files/retrieve-project-file-information.png)

## Specify the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert your Project document to HTML, PDF, or image format. Assign a [PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pagesize) enumeration member to the [ProjectManagementOptions.PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/projectmanagementoptions/properties/pagesize) property to select one of the predefined page sizes (Letter, Ledger, A0, A1, A2, A3, or A4). You can access this property for the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

The following example specifies page size for the output PDF file:

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify the page size.
    viewOptions.ProjectManagementOptions.PageSize = PageSize.A3;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify the page size.
            viewOptions.ProjectManagementOptions.PageSize = PageSize.A3
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}


## Adjust the time unit

When rendering a Project file, GroupDocs.Viewer selects the smallest time unit on a timescale based on the total length of the project. You can adjust the timescale to show smaller or greater time units (from days to months). To do this, set the [ViewOptions.ProjectManagementOptions.TimeUnit](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/projectmanagementoptions/properties/timeunit) property for a target view to one of the following [TimeUnit](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/timeunit) enumeration members:

* `Days` displays days on the timescale.
* `ThirdsOfMonths` displays the Beginning/Middle/End (B/M/E) of each month on the timescale.
* `Months` displays months on the timescale.
* `Unspecified` means that the timescale unit is not specified.

The following code sample demonstrates how to specify the timescale unit when rendering a Project file to HTML:

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Convert the document to HTML.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output_{0}.html");
    // Specify the time unit.
    viewOptions.ProjectManagementOptions.TimeUnit = TimeUnit.ThirdsOfMonths;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Convert the document to HTML.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output_{0}.html")
            ' Specify the time unit.
            viewOptions.ProjectManagementOptions.TimeUnit = TimeUnit.ThirdsOfMonths
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render a Project with the timescale unit set to thirds of months](/viewer/net/images/rendering-basics/render-ms-project-files/render-project-with-custom-time-unit.png)

## Render specific dates

With GroupDocs.Viewer, you can render only a portion of the project's timeline when you convert your Project file to HTML, PDF, or image format. Set the [ViewOptions.ProjectManagementOptions.StartDate](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/projectmanagementoptions/properties/startdate) and [ViewOptions.ProjectManagementOptions.EndDate](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/projectmanagementoptions/properties/enddate) properties for a target view to specify a date range the timeline should display. If you set only the `StartDate` property, the timeline displays information for tasks from the specified date to the project's finish date. If you set only the `EndDate` property, the timeline contains dates from the project's start date to the specified date.

The example below demonstrates how to convert a Project file to PDF and set the timeline date range.

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify the date range.
    viewOptions.ProjectManagementOptions.StartDate = new DateTime(2022, 08, 01);
    viewOptions.ProjectManagementOptions.EndDate = new DateTime(2022, 09, 01);
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify the date range.
            viewOptions.ProjectManagementOptions.StartDate = New DateTime(2022, 08, 01)
            viewOptions.ProjectManagementOptions.EndDate = New DateTime(2022, 09, 01)
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render tasks for a specific date range](/viewer/net/images/rendering-basics/render-ms-project-files/render-tasks-between-two-dates.png)

## Render notes

Microsoft Project allows you to add notes to tasks, resources, and assignments.

![Speaker notes in Microsoft PowerPoint](/viewer/net/images/rendering-basics/render-ms-project-files/project-task-notes.png)

If you need to display these notes in the output HTML, PDF, or image files, enable the [ViewOptions.RenderNotes](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/rendernotes) property for a target view.

The following code sample converts a Project file with task notes to PDF:

{{< tabs "example10">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("SoftwareDevelopmentPlan.mpp"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Enable notes rendering.
    viewOptions.RenderNotes = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("SoftwareDevelopmentPlan.mpp")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Enable notes rendering.
            viewOptions.RenderNotes = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. Notes are rendered on a separate page.

![Render a Project file with task notes](/viewer/net/images/rendering-basics/render-ms-project-files/render-task-notes-to-pdf.png)

---

## Render Project documents as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-ms-project-files/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to render Project files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Project or other project management software to load and view Project files within your Node.js application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/project" >}} {{< icon "gdoc_person" >}} View Project files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Project Management file formats

GroupDocs.Viewer supports the following Project Management file formats:

* [Microsoft Project](https://docs.fileformat.com/project-management/mpp) (.MPP)
* [Microsoft Project Template](https://docs.fileformat.com/project-management/mpt) (.MPT)
* [Microsoft Project Exchange File](https://docs.fileformat.com/project-management/mpx) (.MPX)

## Render Project files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Project file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "render-project-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
// Render the project's active view as HTML.
// {0} is replaced with the current page number in the output file names.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-project-to-html-embedded/mpp-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to HTML](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/render-project-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-project-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
// Render the project's active view as HTML.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-project-to-html-external/mpp-to-html-page_{0}.html", "render-project-to-html-external/mpp-to-html-page_{0}/resource_{0}_{1}", "render-project-to-html-external/mpp-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/render-project-to-html-external-resources.png)

## Render Project files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Project file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-project-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
// Create a PDF file.
const viewOptions = PdfViewOptions("render-project-to-pdf/mpp-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PDF](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/render-project-to-pdf.png)

## Render Project files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Project file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-project-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
// Render the project's active view as PNG.
// {0} is replaced with the page numbers in the output image names.
const viewOptions = PngViewOptions("render-project-to-png/mpp-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(1600)
viewOptions.setHeight(650)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PNG](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/render-project-to-png-image.png)

## Render Project files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert a Project file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-project-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
// Render the project's active view as JPG.
// {0} is replaced with the page numbers in the output image names.
const viewOptions = JpgViewOptions("render-project-to-jpeg/mpp-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(1600)
viewOptions.setHeight(650)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get information about a Project file

Follow the steps below to obtain information about a Project file (the file format, the number of pages, the project's start and end dates): 

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [ProjectManagementViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/projectmanagementviewinfo) type.
3. Use the `ProjectManagementViewInfo` class properties to retrieve information about the Project file.

{{< tabs "get-project-file-information">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
  
const viewInfoOptions = ViewInfoOptions.forHtmlView()
const viewInfo = viewer.getViewInfo(viewInfoOptions)

console.log("File type: " + viewInfo.getFileType())
console.log("Pages count: " + viewInfo.getPages().size())
console.log("Project start date: " + viewInfo.getStartDate())
console.log("Project end date: " + viewInfo.getEndDate())
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a Project file](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/retrieve-project-file-information.png)

## Specify the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert your Project document to HTML, PDF, or image format. Use the [ProjectManagementOptions.setPageSize](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/projectmanagementoptions/#setPageSize-com.groupdocs.viewer.options.PageSize-) method to select one of the predefined page sizes (LETTER, LEDGER, A0, A1, A2, A3, or A4) (see the [PageSize](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pagesize) enumeration). You can use this method for the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

The following example specifies page size for the output PDF file:

{{< tabs "render-project-with-page-size">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions, PageSize } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
// Create a PDF file.
const viewOptions = PdfViewOptions("render-project-with-page-size/mpp-to-pdf.pdf")
// Specify the page size.
viewOptions.getProjectManagementOptions().setPageSize(PageSize.A3);
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


## Adjust the time unit

When rendering a Project file, GroupDocs.Viewer selects the smallest time unit on a timescale based on the total length of the project. You can adjust the timescale to show smaller or greater time units (from days to months). To do this, use the [ViewOptions.getProjectManagementOptions().setTimeUnit](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/projectmanagementoptions/#setTimeUnit-com.groupdocs.viewer.options.TimeUnit-) method for a target view to one of the following [TimeUnit](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/timeunit) enumeration members:

* `DAYS` displays days on the timescale.
* `THIRDS_OF_MONTHS` displays the Beginning/Middle/End (B/M/E) of each month on the timescale.
* `MONTHS` displays months on the timescale.
* `UNSPECIFIED` means that the timescale unit is not specified.

The following code sample demonstrates how to specify the timescale unit when rendering a Project file to HTML:

{{< tabs "render-project-with-time-unit">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions, TimeUnit } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.mpp")
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-project-with-time-unit/mpp-to-html.html")
viewOptions.getProjectManagementOptions().setTimeUnit(TimeUnit.DAYS)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render a Project with the timescale unit set to thirds of months](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/render-project-with-custom-time-unit.png)

## Render specific dates

With GroupDocs.Viewer, you can render only a portion of the project's timeline when you convert your Project file to HTML, PDF, or image format. Use the [ViewOptions.getProjectManagementOptions().setStartDate](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/projectmanagementoptions/#setStartDate-java.util.Date-) and [ViewOptions.getProjectManagementOptions().setEndDate](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/projectmanagementoptions/#setEndDate-java.util.Date-) methods for a target view to specify a date range the timeline should display. If you set only the `StartDate` property, the timeline displays information for tasks from the specified date to the project's finish date. If you set only the `EndDate` property, the timeline contains dates from the project's start date to the specified date.

The example below demonstrates how to convert a Project file to PDF and set the timeline date range.

{{< tabs "render-project-specific-dates" docs-to-code-examples-skip >}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';
import java from 'java';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-project-specific-dates/mpp-to-html.html")

// Create Java Date objects from JavaScript dates
const startDate = java.newInstanceSync('java.util.Date', java.newLong(new Date(2000, 6, 1, 0, 0).getTime()));
const endDate = java.newInstanceSync('java.util.Date', java.newLong(new Date(2000, 7, 31, 0, 0).getTime()));

viewOptions.getProjectManagementOptions().setStartDate(startDate)
viewOptions.getProjectManagementOptions().setEndDate(endDate)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Render tasks for a specific date range](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/render-tasks-between-two-dates.png)

## Render notes

Microsoft Project allows you to add notes to tasks, resources, and assignments.

![Speaker notes in Microsoft Project](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/project-task-notes.png)

If you need to display these notes in the output HTML, PDF, or image files, use the [ViewOptions.setRenderNotes](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/baseviewoptions/#setRenderNotes-boolean-) method for a target view.

The following code sample converts a Project file with task notes to PDF:

{{< tabs "render-project-with-notes">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("SoftwareDevelopmentPlan.mpp")
// Create a PDF file.
const viewOptions = PdfViewOptions("render-project-with-notes/mpp-to-pdf.pdf")
// Enable notes rendering.
viewOptions.setRenderNotes(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "SoftwareDevelopmentPlan.mpp" >}}
{{< tab-text >}}
`SoftwareDevelopmentPlan.mpp` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ms-project-files/SoftwareDevelopmentPlan.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. Notes are rendered on a separate page.

![Render a Project file with task notes](/viewer/nodejs-java/images/rendering-basics/render-ms-project-files/render-task-notes-to-pdf.png)

---

## Render Project documents as HTML, PDF, and image files

Path: /viewer/python-net/render-ms-project-files/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to render Project files in HTML, PDF, PNG, and JPEG formats. You do not need to use Microsoft Project or other project management software to load and view Project files within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/project" >}} {{< icon "gdoc_person" >}} View Project files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Project Management file formats

GroupDocs.Viewer supports the following Project Management file formats:

* [Microsoft Project](https://docs.fileformat.com/project-management/mpp) (.MPP)
* [Microsoft Project Template](https://docs.fileformat.com/project-management/mpt) (.MPT)
* [Microsoft Project Exchange File](https://docs.fileformat.com/project-management/mpx) (.MPX)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

{{< alert style="info" >}}Family of the Project Management file formats (MPP, MPT, and MPX) currently is not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

## Render Project files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [[Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Project file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_project_to_html():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Render the project's active view as HTML.
        # {0} is replaced with the current page number in the output file names.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_project_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_to_html()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to HTML](/viewer/python-net/images/rendering-basics/render-ms-project-files/render-project-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_project_to_html_external():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Render the project's active view as HTML.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_project_to_html_external/pdf_page_{0}.html", "render_project_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_project_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_to_html_external()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-ms-project-files/render-project-to-html-external-resources.png)

## Render Project files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [[Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Project file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_project_to_pdf():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Create a PDF file for the project's active view.
        viewOptions = PdfViewOptions("render_project_to_pdf/project_file.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_to_pdf()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PDF](/viewer/python-net/images/rendering-basics/render-ms-project-files/render-project-to-pdf.png)

## Render Project files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [[Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Project file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_project_to_png():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Render the project's active view as PNG.
        # {0} is replaced with the current page number in the output file names.
        viewOptions = PngViewOptions("render_project_to_png/project_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 1600
        viewOptions.height = 650
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_to_png()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a Project file to PNG](/viewer/python-net/images/rendering-basics/render-ms-project-files/render-project-to-png-image.png)

## Render Project files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [[Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a Project file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_project_to_jpg():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Render the project's active view as JPEG.
        # {0} is replaced with the current page number in the output file names.
        viewOptions = JpgViewOptions("render_project_to_jpg/project_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 1600
        viewOptions.height = 650
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_to_jpg()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get information about a Project file

Follow the steps below to obtain information about a Project file (the file format, the number of pages, the project's start and end dates): 

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.get_view_info](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [ProjectManagementViewInfo](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/projectmanagementviewinfo) type.
3. Use the `ProjectManagementViewInfo` class properties to retrieve information about the Project file.

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions
from groupdocs.viewer.results import ProjectManagementViewInfo

def get_project_info():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        viewOptions = ViewInfoOptions.for_html_view()
        view_info = viewer.get_view_info(viewOptions)       
        print("File type: " + str(view_info.file_type))
        print("The number of pages: " + str(len(view_info.pages)))

if __name__ == "__main__":
    get_project_info()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about a Project file](/viewer/python-net/images/rendering-basics/render-ms-project-files/retrieve-project-file-information.png)

## Specify the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert your Project document to HTML, PDF, or image format. Assign a [PageSize](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pagesize) enumeration member to the [project_management_options.page_size](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/projectmanagementoptions/#properties) property to select one of the predefined page sizes (Letter, Ledger, A0, A1, A2, A3, or A4). You can access this property for the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

The following example specifies page size for the output PDF file:

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PageSize

def render_project_with_page_size():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Convert the document to PDF.
        viewOptions = PdfViewOptions("render_project_with_page_size/project_with_page_size.pdf")
        # Specify the page size.
        viewOptions.project_management_options.page_size = PageSize.A3
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_with_page_size()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


## Adjust the time unit

When rendering a Project file, GroupDocs.Viewer selects the smallest time unit on a timescale based on the total length of the project. You can adjust the timescale to show smaller or greater time units (from days to months). To do this, set the [ViewOptions.project_management_options.time_unit](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/projectmanagementoptions/#properties) property for a target view to one of the following [TimeUnit](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/timeunit) enumeration members:

* `DAYS` displays days on the timescale.
* `THIRDS_OF_MONTHS` displays the Beginning/Middle/End (B/M/E) of each month on the timescale.
* `MONTHS` displays months on the timescale.
* `UNSPECIFIED` means that the timescale unit is not specified.

The following code sample demonstrates how to specify the timescale unit when rendering a Project file to HTML:

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, TimeUnit

def render_project_with_time_unit():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Convert the document to HTML.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_project_with_time_unit/output_{0}.html")
        # Specify the time unit.
        viewOptions.project_management_options.time_unit = TimeUnit.THIRDS_OF_MONTHS
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_with_time_unit()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result.

![Render a Project with the timescale unit set to thirds of months](/viewer/python-net/images/rendering-basics/render-ms-project-files/render-project-with-custom-time-unit.png)

## Render notes

Microsoft Project allows you to add notes to tasks, resources, and assignments.

![Speaker notes in Microsoft PowerPoint](/viewer/python-net/images/rendering-basics/render-ms-project-files/project-task-notes.png)

If you need to display these notes in the output HTML, PDF, or image files, enable the [ViewOptions.render_notes](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property for a target view.

The following code sample converts a Project file with task notes to PDF:

{{< tabs "example10">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_project_with_notes():
    # Load Project file
    with Viewer("sample.mpp") as viewer:
        # Convert the document to PDF.
        viewOptions = PdfViewOptions("render_project_with_notes/project_with_notes.pdf")
        # Enable notes rendering.
        viewOptions.render_notes = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_project_with_notes()
```
{{< /tab >}}
{{< tab "sample.mpp" >}}
{{< tab-text >}}
`sample.mpp` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ms-project-files/sample.mpp) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. Notes are rendered on a separate page.

![Render a Project file with task notes](/viewer/python-net/images/rendering-basics/render-ms-project-files/render-task-notes-to-pdf.png)

---

## Replace missing font

Path: /viewer/java/replace-missing-font/

You can specify the default font name for a document. GroupDocs.Viewer uses this font during rendering instead of any not installed fonts. For example, if the document includes a font containing non-English characters, specify the default font name to ensure that GroupDocs.Viewer replaces any missing font with one which has the same character set. 

The following code snippet shows how to set the default font name:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pptx")) {
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    viewOptions.setDefaultFontName("Courier New");
    viewer.view(viewOptions);
}  
```
{{< /tab >}}
{{< /tabs >}}
---

## Replace missing font

Path: /viewer/net/replace-missing-font/

You can specify the default font name for a document. GroupDocs.Viewer uses this font during rendering instead of any not installed fonts. For example, if the document includes a font containing non-English characters, specify the default font name to ensure that GroupDocs.Viewer replaces any missing font with one which has the same character set. 

The following code snippet shows how to set the default font name:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.pptx"))
{
    // Create options for rendering HTML document with embedded resources
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
   
    // Specify a default font name is the options
    viewOptions.DefaultFontName = "Courier New";
    
    // Render input PPTX to output HTML
    viewer.View(viewOptions);
}          
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.pptx")
            ' Create options for rendering HTML document with embedded resources
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources   ()
        
            ' Specify a default font name is the options
            viewOptions.DefaultFontName = "Courier New"
            
            ' Render input PPTX to output HTML
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Search text in Emails

Path: /parser/java/search-text-in-emails/

To search a keyword in emails [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in the email:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial email;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null* value if search isn't supported for the email. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns *null*. For an empty email [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in the email:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleMsg)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("test");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) is used for the advanced search in emails - like search with regular expressions. [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in the email:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial email;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in the email:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleMsg)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("\\\\sthe\\\\s", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Emails

Path: /parser/net/search-text-in-emails/

To search a keyword in emails [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in the email:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial email;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null* value if search isn't supported for the email. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null*. For an empty email [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in the email:
```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
   
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in emails - like search with regular expressions. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in the email:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial email;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in the email:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft Office Word documents

Path: /parser/java/search-text-in-microsoft-office-word-documents/

To search a keyword in Microsoft Office Word documents [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects. For details, see [Search Text]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}[search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null value if search isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns null. For empty Microsoft Office Word document [search(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String)) method returns an empty collection.{{< /alert >}}

The following example shows how to find a keyword in Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Search a keyword:
    Iterable<SearchResult> sr = parser.search("nunc");
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

[search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method is used for the advanced search in Microsoft Office Word documents - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) parameter is used to customize a search.

{{< alert style="warning" >}}Search by pages in Microsoft Office Word document page is more resource consuming operation.{{< /alert >}}

Here are the steps to search with a regular expression in Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/SearchOptions) object with the parameters for the search;
*   Call [search(String, SearchOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#search(java.lang.String,%20com.groupdocs.parser.options.SearchOptions)) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/SearchResult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft Office Word document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocx)) {
    // Search with a regular expression with case matching
    Iterable<SearchResult> sr = parser.search("(\\sut\\s)", new SearchOptions(true, false, true));
    // Iterate over search results
    for (SearchResult s : sr) {
        // Print an index and found text:
        System.out.println(String.format("At %d: %s", s.getPosition(), s.getText()));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Search text in Microsoft Office Word documents

Path: /parser/net/search-text-in-microsoft-office-word-documents/

To search a keyword in Microsoft Office Word documents [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

Here are the steps to search a keyword in Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null* value if search isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null*. For empty Microsoft Office Word document [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in Microsoft Office Word document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
 
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in Microsoft Office Word documents - like search with regular expressions, search by pages etc. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

{{< alert style="warning" >}}
Search by pages in Microsoft Office Word document page is more resource consuming operation.
{{< /alert >}}

Here are the steps to search with a regular expression in Microsoft Office Word document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in Microsoft Office Word document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Sign document with extensions

Path: /signature/java/sign-document-with-extensions/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides with [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) property Extensions that expects list of different extensions classes. At this moment here are few of them

*   [SpreadsheetPosition](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/SpreadsheetPosition) that allows to specify for Spreadsheet documents signature position as Row and Column numbers
*   [TextShadow](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.extensions/TextShadow) alternative extension for Text signature property

Here are the steps to add extensions to signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) object with all required additional options.    
*   Create instance of required Extension and call [SignOptions.getExtensions().add](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#getExtensions()) method with passed object      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions) to it.
    

## Sign document with Text signature

This example shows how to add Text signature to document.

```java
Signature signature = new Signature("sample.pdf");
 
TextSignOptions options = new TextSignOptions("John Smith");
 
// set signature position
options.setLeft(100);
options.setTop(100);
 
// set signature rectangle
options.setWidth(100);
options.setHeight(30);
 
// set signature alignment
// when VerticalAlignment is set the Top coordinate will be ignored.
// Use Margin properties Top, Bottom to provide vertical offset
options.setVerticalAlignment(VerticalAlignment.Top);
 
// when HorizontalAlignment is set the Left coordinate will be ignored.
// Use Margin properties Left, Right to provide horizontal offset
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setBottom(20);
padding.setRight(20);
options.setMargin(padding);
 
// adjust signature appearance
 
// setup signature border
Border border = new Border();
border.setColor(Color.GREEN);
border.setDashStyle(DashStyle.DashLongDashDot);
border.setTransparency(0.5);
border.setVisible(true);
border.setWeight(2);
options.setBorder(border);
 
// set text color and Font
options.setForeColor(Color.RED);
SignatureFont signatureFont = new SignatureFont();
signatureFont.setSize(12);
signatureFont.setFamilyName("Comic Sans MS");
options.setFont(signatureFont);
 
// setup background
Background background = new Background();
background.setColor(Color.LIGHT_GRAY);
background.setTransparency(0.5);
background.setBrush(new LinearGradientBrush(Color.GREEN, Color.DARK_GRAY, 0));
options.setBackground(background);
 
// set rotation
options.setRotationAngle(45);
 
// set alternative signature implementation on document page
options.setSignatureImplementation(TextSignatureImplementation.Image);
 
// set up shadow options for text
TextShadow shadow = new TextShadow();
shadow.setColor(Color.ORANGE);
shadow.setAngle(135);
shadow.setBlur(5);
shadow.setDistance(4);
shadow.setTransparency(0.2);
 
//add text shadow to signature extensions
options.getExtensions().add(shadow);
 
// sign document to file
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Stop word dictionary

Path: /search/java/stop-word-dictionary/

The [StopWordDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/StopWordDictionary) class is designed to store stop words in an index. Information on using stop words during indexing is provided on the [Indexing with stop words]({{< ref "search/java/developer-guide/advanced-usage/indexing/indexing-with-stop-words.md" >}}) page.

To get the number of stop words in the dictionary, use the [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/StopWordDictionary#getCount()) method.

To add stop words to the dictionary, use the [addRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/StopWordDictionary#addRange(java.lang.Iterable)) method.

To remove words from the dictionary, use the [removeRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/StopWordDictionary#removeRange(java.lang.Iterable)) method.

To check for a word in a dictionary, use the [contains](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/StopWordDictionary#contains(java.lang.String)) method.

To remove all words from the dictionary, use the [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/StopWordDictionary#clear()) method.

To export words to a file, use the [exportDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import words from a file, use the [importDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the stop word dictionary.



```java
String indexFolder = "c:\\MyIndex\\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.getDictionaries().getStopWordDictionary().getCount() > 0) {
    // Removing all words from the dictionary
    index.getDictionaries().getStopWordDictionary().clear();
}
 
// Adding stop words to the dictionary
String[] words = new String[] { "a", "an", "the", "but", "by" };
index.getDictionaries().getStopWordDictionary().addRange(words);
 
if (index.getDictionaries().getStopWordDictionary().contains("but") &&
    index.getDictionaries().getStopWordDictionary().contains("by")) {
    // Removing words from the dictionary
    index.getDictionaries().getStopWordDictionary().removeRange(new String[] { "but", "by" });
}
 
// Export words to a file
index.getDictionaries().getStopWordDictionary().exportDictionary("C:\\Words.txt");
 
// Import words from a file
index.getDictionaries().getStopWordDictionary().importDictionary("C:\\Words.txt");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Stop word dictionary

Path: /search/net/stop-word-dictionary/

The [StopWordDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/stopworddictionary) class is designed to store stop words in an index. Information on using stop words during indexing is provided on the [Indexing with stop words]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-with-stop-words.md" >}}) page.

To get the number of stop words in the dictionary, use the [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/stopworddictionary/properties/count) property.

To add stop words to the dictionary, use the [AddRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/stopworddictionary/methods/addrange/index) method.

To remove words from the dictionary, use the [RemoveRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/stopworddictionary/methods/removerange/index) method.

To check for a word in a dictionary, use the [Contains](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/stopworddictionary/methods/contains) method.

To remove all words from the dictionary, use the [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/stopworddictionary/methods/clear) method.

To export words to a file, use the [ExportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/exportdictionary) method.

To import words from a file, use the [ImportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/importdictionary) method.

The following example demonstrates the use of methods of the stop word dictionary.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
 
// Creating an index from in specified folder
Index index = new Index(indexFolder);
 
if (index.Dictionaries.StopWordDictionary.Count > 0)
{
    // Removing all words from the dictionary
    index.Dictionaries.StopWordDictionary.Clear();
}
 
// Adding stop words to the dictionary
string[] words = new string[] { "a", "an", "the", "but", "by" };
index.Dictionaries.StopWordDictionary.AddRange(words);
 
if (index.Dictionaries.StopWordDictionary.Contains("but") &&
    index.Dictionaries.StopWordDictionary.Contains("by"))
{
    // Removing words from the dictionary
    index.Dictionaries.StopWordDictionary.RemoveRange(new string[] { "but", "by" });
}
 
// Export words to a file
index.Dictionaries.StopWordDictionary.ExportDictionary(@"C:\Words.txt");
 
// Import words from a file
index.Dictionaries.StopWordDictionary.ImportDictionary(@"C:\Words.txt");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Stop word dictionary

Path: /search/nodejs-java/stop-word-dictionary/

The [StopWordDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/StopWordDictionary) class is designed to store stop words in an index. Information on using stop words during indexing is provided on the [Indexing with stop words]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/indexing-with-stop-words.md" >}}) page.

To get the number of stop words in the dictionary, use the [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/StopWordDictionary#getCount()) method.

To add stop words to the dictionary, use the [addRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/StopWordDictionary#addRange(java.lang.Iterable)) method.

To remove words from the dictionary, use the [removeRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/StopWordDictionary#removeRange(java.lang.Iterable)) method.

To check for a word in a dictionary, use the [contains](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/StopWordDictionary#contains(java.lang.String)) method.

To remove all words from the dictionary, use the [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/StopWordDictionary#clear()) method.

To export words to a file, use the [exportDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import words from a file, use the [importDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the stop word dictionary.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index from in specified folder
const index = new groupdocs.search.Index(indexFolder);

if (index.getDictionaries().getStopWordDictionary().getCount() > 0) {
  // Removing all words from the dictionary
  index.getDictionaries().getStopWordDictionary().clear();
}

// Adding stop words to the dictionary
const words = java.newArray('java.lang.String', ['a', 'an', 'the', 'but', 'by']);
index.getDictionaries().getStopWordDictionary().addRange(words);

if (
  index.getDictionaries().getStopWordDictionary().contains('but') &&
  index.getDictionaries().getStopWordDictionary().contains('by')
) {
  // Removing words from the dictionary
  index
    .getDictionaries()
    .getStopWordDictionary()
    .removeRange(java.newArray('java.lang.String', ['but', 'by']));
}

// Export words to a file
const fileName = Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/stopWordDictionary/Words.txt';
index.getDictionaries().getStopWordDictionary().exportDictionary(fileName);

// Import words from a file
index.getDictionaries().getStopWordDictionary().importDictionary(fileName);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search in the index
const query = 'but';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## System Requirements

Path: /merger/net/system-requirements/

## Overview

GroupDocs.Merger for .NET does not require any external software or third party tool to be installed. Just follow one of the way as described in [Development Environment, Installation and Configuration]({{< ref "merger/net/getting-started/installation.md" >}}).

## Supported Operating Systems

GroupDocs.Merger for .NET supports any 32-bit or 64-bit operating system where .NET or Mono framework is installed including, but not limited to:

### Windows

*   Microsoft Windows 2003 Server ( x64, x86)
*   Microsoft Windows 2008 Server ( x64, x86)
*   Microsoft Windows 2012 Server ( x64, x86)
*   Microsoft Windows 2012 R2 Server ( x64, x86)
*   Microsoft Windows 2016 Server ( x64, x86)
*   Microsoft Windows 2019 Server ( x64, x86)
*   Microsoft Windows Vista ( x64, x86)
*   Microsoft Windows XP ( x64, x86)
*   Microsoft Windows 7 ( x64, x86)
*   Microsoft Windows 8, 8.1 ( x64, x86)
*   Microsoft Windows 10 ( x64, x86)
*   Microsoft Azure

### Linux

*   Linux (Ubuntu, OpenSUSE, CentOS and others)

### Mac

*   Mac OS X

## Supported Frameworks

GroupDocs.Merger for .NET supports .NET and Mono frameworks as follows:

### .NET Standard 2.0

Any type of .NET Standard 2.0 application is supported.

### .NET Frameworks

*   .NET Framework 2.0
*   .NET Framework 3.5
*   .NET Framework 4.0
*   .NET Framework 4.0_ClientProfile
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.5.2
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.5.0
*   .NET Framework 4.5.1
*   .NET Framework 4.6.0
*   .NET Framework 4.6.2
*   .NET Framework 4.7
*   .NET Framework 4.7.2
*   .NET Standard 2.0 
*   .NET Core 2.0
*   .NET Core 2.1

### Mono Framework

*   Mono 2.6.7 or later

## Development Environments

GroupDocs.Merger for .NET can be used to develop applications in any development environment that targets the .NET platform, but the following environments are explicitly supported:

*   Microsoft Visual Studio 2010
*   Microsoft Visual Studio 2011
*   Microsoft Visual Studio 2012
*   Microsoft Visual Studio 2013
*   Microsoft Visual Studio 2015
*   Microsoft Visual Studio 2017
*   Microsoft Visual Studio 2019
*   Xamarin.Android
*   Xamarin.IOS
*   Xamarin.Mac
*   MonoDevelop 2.4 and later

---

## Technical Support

Path: /metadata/nodejs-java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Metadata, consider the following:

* Make sure you are using the latest GroupDocs.Metadata version before reporting an issue. See [NPM](https://www.npmjs.com/package/@groupdocs/groupdocs.metadata) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Metadata Free Support Forum](https://forum.groupdocs.com/c/metadata/9), and we'll assist you. Questions are answered directly by the GroupDocs.Metadata development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Metadata, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.
---

## Technical Support

Path: /metadata/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Metadata, consider the following:

* Make sure you are using the latest GroupDocs.Metadata version before reporting an issue. See [PyPI](https://pypi.org/project/groupdocs-metadata-net) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Metadata Free Support Forum](https://forum.groupdocs.com/c/metadata/9), and we'll assist you. Questions are answered directly by the GroupDocs.Metadata development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Metadata, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.
---

## Technical Support

Path: /signature/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including those evaluating the product. You can access support at the [Free Support Forum](https://forum.groupdocs.com/) and the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not offer technical support by phone. Phone support is available only for sales and purchase inquiries.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need assistance with GroupDocs.Signature, please consider the following:

1. Ensure you are using the latest version of GroupDocs.Signature before reporting an issue. Check the [releases page](https://releases.groupdocs.com/signature/python-net/) for the latest version.
2. Review the forums and this documentation to see if your question has already been answered.
3. Post your question in the [GroupDocs.Signature Free Support Forum](https://forum.groupdocs.com/c/signature). Our development team will assist you directly.
4. Please allow for time zone differences when waiting for a reply on the forums.

## Paid Support Helpdesk

Paid support requests are given higher priority than free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to receive higher priority assistance.

## Report an Issue or Feature Request

To ensure your issue, question, or feature request is resolved efficiently, please follow these steps:

1. Attach the original document and any relevant code snippet that reproduces the issue. If you need to attach multiple files, compress them into a single archive. It’s safe to attach documents on the GroupDocs Forum, as only you and GroupDocs developers will have access.
2. Include details about the environment where the issue occurs.
3. Report one issue per thread. If you have additional questions, issues, or feature requests, please create separate threads for each.


---

## Technical Support

Path: /viewer/java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Viewer, consider the following:

* Make sure you are using the latest GroupDocs.Viewer version before reporting an issue. See [GroupDocs Artifact Repository](https://repository.groupdocs.com/webapp/#/artifacts/browse/tree/General/repo/com/groupdocs/groupdocs-viewer) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Viewer Free Support Forum](https://forum.groupdocs.com/c/viewer/9), and we'll assist you. Questions are answered directly by the GroupDocs.Viewer development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Viewer, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /viewer/nodejs-java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Viewer, consider the following:

* Make sure you are using the latest GroupDocs.Viewer version before reporting an issue. See [NPM](https://www.npmjs.com/package/@groupdocs/groupdocs.viewer) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Viewer Free Support Forum](https://forum.groupdocs.com/c/viewer/9), and we'll assist you. Questions are answered directly by the GroupDocs.Viewer development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Viewer, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /viewer/python-net/technical-support/


GGroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including those evaluating the product. You can access support at the [Free Support Forum](https://forum.groupdocs.com/) and the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not offer technical support by phone. Phone support is available only for sales and purchase inquiries.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need assistance with GroupDocs.Viewer, please consider the following:

1. Ensure you are using the latest version of GroupDocs.Viewer before reporting an issue. Check the [releases page](https://releases.groupdocs.com/viewer/python-net/) for the latest version.
2. Review the forums and this documentation to see if your question has already been answered.
3. Post your question in the [GroupDocs.Viewer Free Support Forum](https://forum.groupdocs.com/c/viewer). Our development team will assist you directly.
4. Please allow for time zone differences when waiting for a reply on the forums.

## Paid Support Helpdesk

Paid support requests are given higher priority than free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to receive higher priority assistance.

## Report an Issue or Feature Request

To ensure your issue, question, or feature request is resolved efficiently, please follow these steps:

1. Attach the original document and any relevant code snippet that reproduces the issue. If you need to attach multiple files, compress them into a single archive. It’s safe to attach documents on the GroupDocs Forum, as only you and GroupDocs developers will have access.
2. Include details about the environment where the issue occurs.
3. Report one issue per thread. If you have additional questions, issues, or feature requests, please create separate threads for each.

---

## Technical Support

Path: /watermark/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Watermark, consider the following:

* Make sure you are using the latest GroupDocs.Watermark version before reporting an issue. See [PyPI](https://pypi.org/project/groupdocs-watermark-net) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Watermark Free Support Forum](https://forum.groupdocs.com/c/watermark/9), and we'll assist you. Questions are answered directly by the GroupDocs.Watermark development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Watermark, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## eSign document with Text signature

Path: /signature/net/esign-document-with-text-signature/

## What is a Text signature?

A **Text** electronic signature is an arbitrary text that is added to a document in a native way depending on the type of the document. GroupDocs.Signature provides the text signature feature and allows customizing a wide range of text settings - from font name, size and color to alignment, borders, shadow effects etc. This is how a text signature may look like:  

![Text](/signature/net/images/esign-document-with-text-signature.png)

## How to eSign document with Text signature

Let's try to add a text signature to a PDF programmatically.

To manipulate text signatures programmatically [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) class and the whole workflow is as easy as follows:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) object according to your requirements and specify the signature options.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) to it.

This example shows how to add a text signature to a document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // set Text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };
    // sign document to file
    signature.Sign("sample_signed.pdf", options);
}
```
### Summary
This guide explains how to add text-based signatures to documents with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) . It covers configuring text properties such as font, color, size, and position, and applying the text signature to a document. The signed document is then saved with the added text signature.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign document with Text signature

Path: /signature/nodejs-java/esign-document-with-text-signature/

## What is a Text signature?

A **Text** electronic signature is an arbitrary text that is added to a document in a native way depending on the type of the document. GroupDocs.Signature provides the text signature feature and allows customizing a wide range of text settings - from font name, size and color to alignment, borders, shadow effects etc. This is how a text signature may look like:  

![Text](/signature/nodejs-java/images/esign-document-with-text-signature.png)

## How to eSign document with Text signature

Let's try to add a text signature to a PDF programmatically.

To manipulate text signatures programmatically, [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) provides the [TextSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions) class, and the whole workflow is as easy as follows:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions) object according to your requirements and specify the signature options.
* Call the [Sign](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [TextSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/textsignoptions) to it.

This example shows how to add a text signature to a document.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF;
  const fileName = path.basename(filePath);

  const outputFilePath = path.join(Constants.OutputPath, 'SignWithText', fileName);
  const signature = new signatureLib.Signature(filePath);

  // Create text sign options
  const options = new signatureLib.TextSignOptions('John Smith');
  // Set signature position
  options.setLeft(100);
  options.setTop(100);

  // Set signature rectangle
  options.setWidth(100);
  options.setHeight(30);

  // Set text color and font
  //options.setForeColor(new Color(255, 0, 0)); // Red color
  const signatureFont = new signatureLib.SignatureFont();
  signatureFont.setSize(12);
  signatureFont.setFamilyName('Comic Sans MS');
  options.setFont(signatureFont);

  // Sign document to file
  signature.sign(outputFilePath, options);
  console.log(`\nSource document signed successfully.\nFile saved at ${outputFilePath}`);
```
### Summary
This guide explains how to add text-based signatures to documents with [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) . It covers configuring text properties such as font, color, size, and position, and applying the text signature to a document. The signed document is then saved with the added text signature.

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature Node.Js for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Use advanced rasterization options

Path: /redaction/java/use-advanced-rasterization-options/

### Use advanced rasterization options

In order to use the advanced rasterization options you have to pass one of the options to [Save](https://reference.groupdocs.com/java/redaction/groupdocs.redaction/redactor/methods/save) method. In this case the document will be rasterized to PDF, but the scan-like effects will be applied to its pages.

The following example demonstrates how to apply the [AdvancedRasterizationOptions](https://reference.groupdocs.com/redaction/java/groupdocs.redaction.options/advancedrasterizationoptions/) with default settings. 

```java
final Redactor redactor = new Redactor("Sample.docx");
try 
{
    // Save the document with advanced options (convert pages into images, and save PDF with scan-like pages)
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");
    so.getRasterization().setEnabled(true);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Border);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Noise);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Grayscale);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Tilt);
    redactor.save(so);
}
finally { redactor.close(); }

```

### Use border rasterization option

You can set the custom border width by providing the "border" dictionary item with an integer value.

The following example demonstrates how to apply the border advanced rasterization option with custom settings.

```java
final Redactor redactor = new Redactor("Sample.docx");
try 
{
    // Save the document with a custom border
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");
    so.getRasterization().setEnabled(true);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Border, new HashMap<String, String>() { { put("border", "10"); } });
    redactor.save(so);
}
finally { redactor.close(); }

```

### Use grayscale rasterization option

The following example demonstrates how to apply the grayscale advanced rasterization option.

```java
final Redactor redactor = new Redactor("Sample.docx");
try 
{
    // Save the document converting it to a grayscale
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");
    so.getRasterization().setEnabled(true);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Grayscale);
    redactor.save(so);
}
finally { redactor.close(); }

```

### Use noise rasterization option

You can set up the custom noise effects by providing the "maxSpots" and "spotMaxSize" dictionary items having integer values. The "maxSpots" defines the maximal number of spots, which is random, and "spotMaxSize" defines the largest allowed spot size.

The following example demonstrates how to apply the noise advanced rasterization option with custom settings.

```java
final Redactor redactor = new Redactor("Sample.docx");
try 
{
    // Save the document with the custom number and size of noise effects
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");
    so.getRasterization().setEnabled(true);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Noise, 
            new HashMap<String, String>() { { put("maxSpots", "150"); put("spotMaxSize", "15"); } });
    redactor.save(so);
}
finally { redactor.close(); }

```

### Use tilt rasterization option

You can set up the custom tilt effects by providing the "minAngle" and "randomAngleMax" dictionary items having integer values. The "minAngle" defines the minimal rotation angle and "randomAngleMax" is a maximal rotation angle, randomly added to "minAngle".

The following example demonstrates how to apply the tilt advanced rasterization option with custom settings.

```java
final Redactor redactor = new Redactor("Sample.docx");
try 
{
    // Save the document with the custom tilt effect
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");
    so.getRasterization().setEnabled(true);
    so.getRasterization().addAdvancedOption(AdvancedRasterizationOptions.Tilt,
            new HashMap<String, String>() { { put("minAngle", "85"); put("randomAngleMax", "5"); } });
    redactor.save(so);
}
finally { redactor.close(); }

```


---

## Use advanced rasterization options

Path: /redaction/net/use-advanced-rasterization-options/

## Use advanced rasterization options

In order to use the advanced rasterization options you have to pass one of the options to [Save](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactor/methods/save) method. In this case the document will be rasterized to PDF, but the scan-like effects will be applied to its pages.

The following example demonstrates how to apply the [AdvancedRasterizationOptions](https://reference.groupdocs.com/redaction/net/groupdocs.redaction.options/advancedrasterizationoptions/) with default settings. 

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Save the document with advanced options (convert pages into images, and save PDF with scan-like pages)
    var so = new SaveOptions();
    so.Rasterization.Enabled = true;
    so.RedactedFileSuffix = "_scan";
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Border);
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Noise);
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Grayscale);
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Tilt);
    redactor.Save(so);
}

```

### Use border rasterization option

You can set the custom border width by providing the "border" dictionary item with an integer value.

The following example demonstrates how to apply the border advanced rasterization option with custom settings.

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Save the document with a custom border
    var so = new SaveOptions();
    so.Rasterization.Enabled = true;
    so.RedactedFileSuffix = "_scan";
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Border, new Dictionary<string, string>() { { "border", "10" } });
    redactor.Save(so);
}

```

### Use grayscale rasterization option

The following example demonstrates how to apply the grayscale advanced rasterization option.

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Save the document with the custom grayscale effect
    var so = new SaveOptions();
    so.Rasterization.Enabled = true;
    so.RedactedFileSuffix = "_scan";
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Grayscale);
    redactor.Save(so);
}

```

### Use noise rasterization option

You can set up the custom noise effects by providing the "maxSpots" and "spotMaxSize" dictionary items having integer values. The "maxSpots" defines the maximal number of spots, which is random, and "spotMaxSize" defines the largest allowed spot size.

The following example demonstrates how to apply the noise advanced rasterization option with custom settings.

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Save the document with the custom number and size of noise effects
    var so = new SaveOptions();
    so.Rasterization.Enabled = true;
    so.RedactedFileSuffix = "_scan";
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Noise, 
                    new Dictionary<string, string>() { { "maxSpots", "150" }, { "spotMaxSize", "15" } });
    redactor.Save(so);
}

```

### Use tilt rasterization option

You can set up the custom tilt effects by providing the "minAngle" and "randomAngleMax" dictionary items having integer values. The "minAngle" defines the minimal rotation angle and "randomAngleMax" is a maximal rotation angle, randomly added to "minAngle".

The following example demonstrates how to apply the tilt advanced rasterization option with custom settings.

**C#**

```csharp
using (Redactor redactor = new Redactor(@"sample.docx"))
{
    // Save the document with the custom tilt effect
    var so = new SaveOptions();
    so.Rasterization.Enabled = true;
    so.RedactedFileSuffix = "_scan";
    so.Rasterization.AddAdvancedOption(AdvancedRasterizationOptions.Tilt,
                    new Dictionary<string, string>() { { "minAngle", "85" }, { "randomAngleMax", "5" } });
    redactor.Save(so);
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our�GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Use advanced rasterization options

Path: /redaction/python-net/use-advanced-rasterization-options/

## Use advanced rasterization options

In order to use the advanced rasterization options you have to pass one of the options to [Save](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactor/save/) method. In this case the document will be rasterized to PDF, but the scan-like effects will be applied to its pages.

The following example demonstrates how to apply the [AdvancedRasterizationOptions](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.options/advancedrasterizationoptions/) with default settings. 

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("[personal]")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(ex_red)
        
        # Save the document with advanced options (convert pages into images, and save PDF with scan-like pages)
        so = gro.SaveOptions()
        so.rasterization.enabled = True
        so.redacted_file_suffix = "_scan"
        so.rasterization.add_advanced_option(gro.AdvancedRasterizationOptions.BORDER)
        so.rasterization.add_advanced_option(gro.AdvancedRasterizationOptions.NOISE)
        so.rasterization.add_advanced_option(gro.AdvancedRasterizationOptions.GRAYSCALE)
        so.rasterization.add_advanced_option(gro.AdvancedRasterizationOptions.TILT)
        redactor.save(so)
```

### Use grayscale rasterization option

The following example demonstrates how to apply the grayscale advanced rasterization option.

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Save the document with the custom grayscale effect
        so = gro.SaveOptions()
        so.rasterization.enabled = True
        so.redacted_file_suffix = "_scan"
        so.rasterization.add_advanced_option(gro.AdvancedRasterizationOptions.GRAYSCALE)
        result_path = redactor.save(so)
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our�GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Working with metadata in Note formats

Path: /metadata/java/working-with-metadata-in-note-formats/

GroupDocs.Metadata for Java provides functionality that allows working with ONE files created by different versions of Microsoft OneNote. Please see the code samples below for more information.

## Inspecting Note documents

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about pages in a note document. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Note document
2.  Extract the root metadata package
3.  Use the [getInspectionPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/NoteRootPackage#getInspectionPackage()) method to inspect the document

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.note.<WBR>NoteReadInspectionProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputOne)) {
	NoteRootPackage root = metadata.getRootPackageGeneric();
	if (root.getInspectionPackage().getPages() != null) {
		for (NotePage page : root.getInspectionPackage().getPages()) {
			System.out.println(page.getTitle());
			System.out.println(page.getAuthor());
			System.out.println(page.getCreationTime());
			System.out.println(page.getLastModificationTime());
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a Note document.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>document.note.<WBR>NoteReadDocumentStatistics**

```csharp
try (Metadata metadata = new Metadata(Constants.InputOne)) {
    NoteRootPackage root = metadata.getRootPackageGeneric();
    System.out.println(root.getDocumentStatistics().getCharacterCount());
    System.out.println(root.getDocumentStatistics().getPageCount());
    System.out.println(root.getDocumentStatistics().getWordCount());
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in Note formats

Path: /metadata/net/working-with-metadata-in-note-formats/

GroupDocs.Metadata for .NET provides functionality that allows working with ONE files created by different versions of Microsoft OneNote. Please see the code samples below for more information.

## Inspecting Note documents

The inspection feature that is introduced in this section doesn't work with metadata directly but extracts some useful pieces of information that can be considered as metadata under some circumstances. For example, you may want to obtain information about pages in a note document. Please follow the example below to learn how to do that.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a Note document
2.  Extract the root metadata package
3.  Use the [InspectionPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.document/noterootpackage/properties/inspectionpackage) property to inspect the document

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Note.<WBR>NoteReadInspectionProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputOne))
{
	var root = metadata.GetRootPackage<NoteRootPackage>();

	if (root.InspectionPackage.Pages != null)
	{
		foreach (var page in root.InspectionPackage.Pages)
		{
			Console.WriteLine(page.Title);
			Console.WriteLine(page.Author);
			Console.WriteLine(page.CreationTime);
			Console.WriteLine(page.LastModificationTime);
		}
	}
}
```

## Reading document statistics

Most office applications are able to display simple text statistics for loaded documents. It can be an estimated word count, page count, character count, etc. The GroupDocs.Metadata API provides similar functionality for some document formats. The following code sample demonstrates how to obtain the text statistics for a Note document.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Document.Note.<WBR>NoteReadDocumentStatistics**

```csharp
using (Metadata metadata = new Metadata(Constants.InputOne))
{
    var root = metadata.GetRootPackage<NoteRootPackage>();
    Console.WriteLine(root.DocumentStatistics.CharacterCount);
    Console.WriteLine(root.DocumentStatistics.PageCount);
    Console.WriteLine(root.DocumentStatistics.WordCount);
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in PNG images

Path: /metadata/java/working-with-metadata-in-png-images/

## Reading PNG metadata properties

The GroupDocs.Metadata API supports extracting format-specific information from PNG images.

The following are the steps to read the native PNG metadata.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PNG image
2.  Get the root metadata package
3.  Extract  the native metadata package using [PngRootPackage.getPngPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PngRootPackage#getPngPackage())
4.  Read the PNG metadata properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.png.PngReadTextChunks**

```java
try (Metadata metadata = new Metadata(Constants.InputPng)) {
    PngRootPackage root = metadata.getRootPackageGeneric();
    for (PngTextChunk chunk : root.getPngPackage().getTextChunks()) {
  
        System.out.println(chunk.getKeyword());
        System.out.println(chunk.getText());
  
        if (chunk instanceof PngCompressedTextChunk) {
            PngCompressedTextChunk compressedChunk = (PngCompressedTextChunk) chunk;
            System.out.println(compressedChunk.getCompressionMethod());
        }
  
        if (chunk instanceof PngInternationalTextChunk) {
            PngInternationalTextChunk internationalChunk = (PngInternationalTextChunk) chunk;
            System.out.println(internationalChunk.isCompressed());
            System.out.println(internationalChunk.getLanguage());
            System.out.println(internationalChunk.getTranslatedKeyword());
        }
    }
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in PNG images. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in PNG images. Please find appropriate code samples in the [Working with EXIF Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in PNG images

Path: /metadata/net/working-with-metadata-in-png-images/

## Reading PNG metadata properties

The GroupDocs.Metadata API supports extracting format-specific information from PNG images.

The following are the steps to read the native PNG metadata.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PNG image
2.  Get the root metadata package
3.  Extract  the native metadata package using [PngRootPackage.PngPackage](https://reference.groupdocs.com/metadata/net/groupdocs.metadata.formats.image/pngrootpackage/properties/pngpackage)
4.  Read the PNG metadata properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Png.PngReadTextChunks**

```csharp
using (Metadata metadata = new Metadata(Constants.InputPng))
{
    var root = metadata.GetRootPackage<PngRootPackage>();
    foreach (var chunk in root.PngPackage.TextChunks)
    {
        Console.WriteLine(chunk.Keyword);
        Console.WriteLine(chunk.Text);
        var compressedChunk = chunk as PngCompressedTextChunk;
        if (compressedChunk != null)
        {
            Console.WriteLine(compressedChunk.CompressionMethod);
        }
        var internationalChunk = chunk as PngInternationalTextChunk;
        if (internationalChunk != null)
        {
            Console.WriteLine(internationalChunk.IsCompressed);
            Console.WriteLine(internationalChunk.Language);
            Console.WriteLine(internationalChunk.TranslatedKeyword);
        }
    }
}
```

## Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in PNG images. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in PNG images. Please find appropriate code samples in the [Working with EXIF metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with TORRENT files

Path: /metadata/java/working-with-torrent-files/

In the BitTorrent file distribution system, a torrent file or METAINFO is a computer file that contains metadata about files and folders to be distributed, and usually also a list of the network locations of trackers, which are computers that help participants in the system find each other and form efficient distribution groups called swarms. A torrent file does not contain the content to be distributed; it only contains information about those files, such as their names, sizes, folder structure, and cryptographic hash values for verifying file integrity. 

{{< alert style="info" >}}For more information on torrent files please refer to this article: https://en.wikipedia.org/wiki/Torrent_file{{< /alert >}}

## Reading TORRENT file metadata

To get TORRENT file metadata, the following steps are needed to be followed:

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a TORRENT file
2.  Get the root metadata package
3.  Extract  the native metadata package using the [TorrentRootPackage.getTorrentPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/TorrentRootPackage#getTorrentPackage()) method
4.  Read the TORRENT file properties

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>peer2peer.TorrentReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputTorrent)) {
	TorrentRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getTorrentPackage().getAnnounce());
	System.out.println(root.getTorrentPackage().getComment());
	System.out.println(root.getTorrentPackage().getCreatedBy());
	System.out.println(root.getTorrentPackage().getCreationDate());

	for (TorrentSharedFilePackage file : root.getTorrentPackage().getSharedFiles()) {
		System.out.println(file.getName());
		System.out.println(file.getLength());
	}
	// ...
}
```

## Updating TORRENT file metadata

The GroupDocs.Metadata API also supports updating some metadata properties of a TORRENT file. Please see the code snippet below to learn how to do that.

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>peer2peer.TorrentReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.InputTorrent)) {
	TorrentRootPackage root = metadata.getRootPackageGeneric();

	root.getTorrentPackage().setComment("test comment");
	root.getTorrentPackage().setCreatedBy("GroupDocs.Metadata");
	root.getTorrentPackage().setCreationDate(new Date());

	metadata.save(Constants.OutputTorrent);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with TORRENT files

Path: /metadata/net/working-with-torrent-files/

In the BitTorrent file distribution system, a torrent file or METAINFO is a computer file that contains metadata about files and folders to be distributed, and usually also a list of the network locations of trackers, which are computers that help participants in the system find each other and form efficient distribution groups called swarms. A torrent file does not contain the content to be distributed; it only contains information about those files, such as their names, sizes, folder structure, and cryptographic hash values for verifying file integrity. 

{{< alert style="info" >}}For more information on torrent files please refer to this article: https://en.wikipedia.org/wiki/Torrent_file{{< /alert >}}

## Reading TORRENT file metadata

To get TORRENT file metadata, the following steps are needed to be followed:

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a TORRENT file
2.  Get the root metadata package
3.  Extract  the native metadata package using [TorrentRootPackage.TorrentPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.peer2peer/torrentrootpackage/properties/torrentpackage)
4.  Read the TORRENT file properties

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Peer2Peer.TorrentReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputTorrent))
{
	var root = metadata.GetRootPackage<TorrentRootPackage>();

	Console.WriteLine(root.TorrentPackage.Announce);
	Console.WriteLine(root.TorrentPackage.Comment);
	Console.WriteLine(root.TorrentPackage.CreatedBy);
	Console.WriteLine(root.TorrentPackage.CreationDate);

	foreach (var file in root.TorrentPackage.SharedFiles)
	{
		Console.WriteLine(file.Name);
		Console.WriteLine(file.Length);
	}

	// ...
}
```

## Updating TORRENT file metadata

The GroupDocs.Metadata API also supports updating some metadata properties of a TORRENT file. Please see the code snippet below to learn how to do that.

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Peer2Peer.TorrentReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.InputTorrent))
{
	var root = metadata.GetRootPackage<TorrentRootPackage>();
	Console.WriteLine(root.TorrentPackage.Announce);
	Console.WriteLine(root.TorrentPackage.Comment);
	Console.WriteLine(root.TorrentPackage.CreatedBy);
	Console.WriteLine(root.TorrentPackage.CreationDate);

	foreach (var file in root.TorrentPackage.SharedFiles)
	{
		Console.WriteLine(file.Name);
		Console.WriteLine(file.Length);
	}

	// ...
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## eSign Document with Stamp Signature

Path: /signature/python-net/esign-document-with-stamp-signature/

## What is a Stamp Signature?

A **stamp** signature is a special type of electronic signature that has the visual appearance of a round seal and its visual parameters can be set programmatically.
Every stamp signature can have multiple "stamp lines" with custom text and different line thicknesses, colors, font weights and sizes. Here is an example of how a stamp signature created with [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) may look like:

![Stamp](/signature/python-net/images/esign-document-with-stamp-signature.png)

GroupDocs.Signature provides the [StampSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/stampsignoptions) class to specify different options for Stamp signature:

* Stamp type - Round or Square;
* Height and width in pixels;
* Alignment and position within the document page;
* and many more.

Each Stamp option contains inner and outer lines. Inner lines represent vertical lines inside the stamp, while outer lines represent circles (or rectangles based on stamp type) around the stamp with their own text, border settings, background etc.

Here are the steps to add a Stamp signature to a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [StampSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/stampsignoptions) object according to your requirements and specify appropriate options.
* Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the [StampSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/stampsignoptions) to it.

## How to eSign Document with Stamp Signature

This example shows how to add a Stamp signature to a document using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import StampSignOptions
from groupdocs.signature.domain import StampLine
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.docx") as sign:
        # Create stamp signature options
        options = StampSignOptions()
        
        # Set stamp signature position
        options.left = 100
        options.top = 100
        
        # Setup first external line of Stamp
        outer_line = StampLine()
        outer_line.text = " * European Union * European Union  * European Union  *"
        outer_line.font.font_size = 12
        outer_line.height = 22
        outer_line.text_bottom_intent = 6
        outer_line.text_color = gsd.Color.WHITE_SMOKE
        outer_line.background_color = gsd.Color.DARK_SLATE_BLUE
        options.outer_lines.add(outer_line)
        
        # Inner square lines - horizontal lines inside the rings
        inner_line = StampLine()
        inner_line.text = "John"
        inner_line.text_color = gsd.Color.MEDIUM_VIOLET_RED
        inner_line.font.font_size = 20
        inner_line.font.bold = True
        inner_line.height = 40
        options.inner_lines.add(inner_line)
        
        # Sign document
        sign.sign("./SampleSigned.docx", options)
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-stamp-signature/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Stamp Signature Options

Here's an example showing how to create a more complex stamp signature with multiple lines and custom styling:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import StampSignOptions
from groupdocs.signature.domain import StampLine
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.docx") as sign:
        # Create stamp signature options
        options = StampSignOptions()
        
        # Set stamp signature position and size
        options.left = 100
        options.top = 100
        options.width = 200
        options.height = 200
        
        # Set stamp type (Round or Square)
        options.stamp_type = gsd.StampType.ROUND
        
        # Setup outer lines
        outer_line1 = StampLine()
        outer_line1.text = " * APPROVED * "
        outer_line1.font.font_size = 14
        outer_line1.font.bold = True
        outer_line1.height = 30
        outer_line1.text_color = gsd.Color.WHITE
        outer_line1.background_color = gsd.Color.DARK_BLUE
        options.outer_lines.add(outer_line1)
        
        outer_line2 = StampLine()
        outer_line2.text = " * 2024 * "
        outer_line2.font.font_size = 12
        outer_line2.height = 25
        outer_line2.text_color = gsd.Color.WHITE
        outer_line2.background_color = gsd.Color.DARK_BLUE
        options.outer_lines.add(outer_line2)
        
        # Setup inner lines
        inner_line1 = StampLine()
        inner_line1.text = "John Smith"
        inner_line1.font.font_size = 20
        inner_line1.font.bold = True
        inner_line1.height = 40
        inner_line1.text_color = gsd.Color.DARK_BLUE
        options.inner_lines.add(inner_line1)
        
        inner_line2 = StampLine()
        inner_line2.text = "CEO"
        inner_line2.font.font_size = 16
        inner_line2.height = 30
        inner_line2.text_color = gsd.Color.DARK_BLUE
        options.inner_lines.add(inner_line2)
        
        # Sign document
        sign.sign("./SampleSigned.docx", options)
```

{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.docx](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-stamp-signature/sample.docx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide explains how to apply stamp-based signatures to documents using [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net). It covers the process of creating a stamp signature, customizing its appearance, and positioning it on the document. The signed document can then be saved with the stamp signature applied.


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign document with Form Field signature - advanced

Path: /signature/net/sign-document-with-form-field-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) class to specify different options for Form Field signature. The Form Field signature is special document predefined input field control with unique name inside the document content that expects some input from user.

At the moment GroupDocs.Siganture supports creation of Form Field signatures for Pdf documents only.

The [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) class contains one [FormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/formfieldsignature/) object to put to the document.

Here are the list of different Form Field signature classes that could be set to [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions)

* [TextFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/checkboxformfieldsignature) - represents text input form field on document page.
* [CheckboxFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/checkboxformfieldsignature) - represents check box field on the document page.
* [ComboboxFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/comboboxformfieldsignature) - represents combo box field signature input with list of possible options on document page.
* [RadioButtonFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/radiobuttonformfieldsignature) - represents radio button signature on document page.
* [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalformfieldsignature) - represents digital signature input form on document page.  

Here are the steps to add Form Field signatures into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) object according to your requirements.
* Instantiate one of the derived classes from [FormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/formfieldsignature/) object. It could be [TextFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/checkboxformfieldsignature), [CheckboxFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/checkboxformfieldsignature) or [DigitalFormFieldSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/digitalformfieldsignature).
* Set FormFieldSignOptions.[Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions/signature) property with created object.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

Following examples show different scenarios of using form fields on document page. These samples are supported for Pdf documents.

## Sign Pdf document with various Form Field signatures  

This example shows how to add various Form Field signature to document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    List<SignOptions> listOptions = new List<SignOptions>();

    // instantiate text form field signature
    FormFieldSignature textSignature = new TextFormFieldSignature("tbData1", "Value-1");
    // instantiate options based on text form field signature
    FormFieldSignOptions optionsTextFF = new FormFieldSignOptions(textSignature)
    {
        HorizontalAlignment = HorizontalAlignment.Left,
        VerticalAlignment = VerticalAlignment.Top,
        Margin = new Padding(10, 20, 0, 0),
        Height = 10,
        Width = 100
    };
    // instantiate text form field signature
    CheckboxFormFieldSignature chbSignature = new CheckboxFormFieldSignature("chbData1", true);
    // instantiate options based on text form field signature
    FormFieldSignOptions optionsTextCHB = new FormFieldSignOptions(chbSignature)
    {
        HorizontalAlignment = HorizontalAlignment.Center,
        VerticalAlignment = VerticalAlignment.Top,
        Margin = new Padding(0, 0, 0, 0),
        Height = 10,
        Width = 100,
    };
    // instantiate text form field signature
    DigitalFormFieldSignature digSignature = new DigitalFormFieldSignature("dgData1");
    // instantiate options based on text form field signature
    FormFieldSignOptions optionsTextDIG = new FormFieldSignOptions(digSignature)
    {
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Top,
        Margin = new Padding(0, 50, 0, 0),
        Height = 10,
        Width = 100,
    };
    listOptions.Add(optionsTextFF);
    listOptions.Add(optionsTextCHB);
    listOptions.Add(optionsTextDIG);
    // sign document to file
    signature.Sign("signedSample.pdf", listOptions);

}
```

## Sign PDF document with Combobox Form Field signature  

This example shows how to add combo box Form Field signature to PDF document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)  

```csharp
// initialize Signature instance
using (Signature signature = new Signature(filePath))
{
    // instantiate combo box form field signature
    List<string> items = new List<string>() { "Red", "Green", "Blue" };
    ComboboxFormFieldSignature combobox = new ComboboxFormFieldSignature("combo1", items, "Blue");
    // instantiate options based on text form field signature
    FormFieldSignOptions options = new FormFieldSignOptions(combobox)
    {
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Top,
        Margin = new Padding(0, 0, 0, 0),
        Height = 100,
        Width = 300,
    };
    // sign document to file
    SignResult signResult = signature.Sign("sampleSigned.pdf", options);
}
```

## Sign PDF document with Radio buttons Form Field signature  

This example shows how to add radio buttons Form Field signature to PDF document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)  

```csharp
// initialize Signature instance
using (Signature signature = new Signature(filePath))
{
    // instantiate radio-button form field signature
    List<string> radioOptions = new List<string>() { "One", "Two", "Three" };
    RadioButtonFormFieldSignature radioSignature = new RadioButtonFormFieldSignature("radioData1", radioOptions, "Two");
    // instantiate options based on text form field signature
    FormFieldSignOptions options = new FormFieldSignOptions(radioSignature)
    {
        HorizontalAlignment = HorizontalAlignment.Right,
        VerticalAlignment = VerticalAlignment.Top,
        Margin = new Padding(0, 0, 0, 0),
        Height = 100,
        Width = 300,
    };
    // sign document to file
    SignResult signResult = signature.Sign("sampleSigned.pdf", options );
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## eSign document with Stamp signature

Path: /signature/java/esign-document-with-stamp-signature/

## What is a Stamp signature?

A **stamp** signature is a special type of electronic signature that have visual appearance of round seal and its visual parameters can be set programmatically.   
Every stamp signature can have multiple "stamp lines" with custom text and different line thickness, color, font weight and size. Here is an example of how stamp signature created with [**GroupDocs.Siganture**](https://products.groupdocs.com/signature/java) may look like: 

![](/signature/java/images/esign-document-with-stamp-signature.png)

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) provides [StampSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/StampSignOptions) class to specify different options for Stamp signature:

*   Stamp type - Round or Square;
*   Height and width in pixels;
*   Alignment and position within the document page;
*   and many more.

Each Stamp option contains inner and outer lines. Inner lines represent vertical lines inside the stamp, when outer lines represent circles (or rectangles based on stamp type) around stamp with own text, border settings, background etc.

Here are the steps to add Stamp signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [StampSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/StampSignOptions) object according to your requirements and specify appropriate options.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [StampSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/StampSignOptions) to it.
    

## How to eSign document with Stamp signature 

This example shows how to add Stamp signature to document.

```java
Signature signature = new Signature("sample.docx");

StampSignOptions options = new StampSignOptions();
// set stamp signature position
options.setLeft(100);
options.setTop(100);

// setup first external line of Stamp
StampLine outerLine = new StampLine();
outerLine.setText(" * European Union * European Union  * European Union  * European Union  * European Union  * ");
outerLine.getFont().setSize(12);
outerLine.setHeight(22);
outerLine.setTextBottomIntent(6);
outerLine.setTextColor(Color.WHITE);
outerLine.setBackgroundColor(Color.BLUE);
options.getOuterLines().add(outerLine);

//Inner square lines - horizontal lines inside the rings
StampLine innerLine = new StampLine();
innerLine.setText("John");
innerLine.setTextColor(Color.RED);
SignatureFont signFont = new SignatureFont();
signFont.setSize(20);
signFont.setBold(true);
innerLine.setFont(signFont);
innerLine.setHeight(40);
options.getInnerLines().add(innerLine);
// sign document to file
signature.sign("SampleSigned.docx", options);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Advanced search for Form Field signatures

Path: /signature/net/advanced-search-for-form-field-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [FormFieldSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsearchoptions) class to specify different options to search for Form Field Signatures.

Here are the steps to search for Form Field signatures within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [FormFieldSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsearchoptions) object according to your requirements and specify search options
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [FormFieldSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsearchoptions) to it.

This example shows how to make advanced search for Form Field signatures in the document.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    FormFieldSearchOptions options = new FormFieldSearchOptions()
    {
        Value = "Value1",
        AllPages = true,
        Name = "TestField",
        Type = FormFieldType.Text
    };
    // search for signatures in document
    List<FormFieldSignature> signatures = signature.Search<FormFieldSignature>(options);
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var formFieldSignature in signatures)
    {
        Console.WriteLine("FormField signature found. Name : {0}. Value: {1}", formFieldSignature.Name, formFieldSignature.Value);
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Search for multiple e-signature types

Path: /signature/java/search-for-multiple-e-signature-types/

Sometimes you may want to search for electronic signatures of different types simultaneously. [**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) allows searching documents for different signature types in an easy and intuitive way. In common words the idea is to pass collection of desired signature types to Search method.

Here are the steps to search for multiple signatures types within the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
    
*   Instantiate search options for required signature types and them to collection of List<[SearchOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/SearchOptions)\>  type.
    The possible options are: 
    
    *   [BarcodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/BarcodeSearchOptions) - to search for Barcode signatures;
        
    *   [DigitalSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/DigitalSearchOptions) -  to search for Digital signatures;
        
    *   [FormFieldSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/FormFieldSearchOptions) - to search for Form-field signatures;
    *   [ImageSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/ImageSearchOptions) - to search for Image signatures;
        
    *   [MetadataSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/MetadataSearchOptions) - to search for Metadata signatures;
        
    *   [QrCodeSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/QrCodeSearchOptions) - to search for QR-code signatures;
        
    *   [TextSearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/TextSearchOptions) to search for Text signatures.
        
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.util.List)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass collection of [search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.search/SearchOptions) options to it.
    

This example shows how to search for multiple electronic signature types in the document.

```java
Signature signature = new Signature("SingedSample.pdf");
BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
barcodeOptions.setAllPages(true);
barcodeOptions.setEncodeType(BarcodeTypes.Code128);
 
QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
qrCodeOptions.setAllPages(true);
qrCodeOptions.setEncodeType(QrCodeTypes.QR);
qrCodeOptions.setText("John");
qrCodeOptions.setMatchType(TextMatchType.Contains);
 
MetadataSearchOptions metadataOptions = new MetadataSearchOptions();
metadataOptions.setAllPages(true);
metadataOptions.setIncludeBuiltinProperties(true);
 
// add options to list
List<SearchOptions> listOptions = new ArrayList<SearchOptions>();
listOptions.add(barcodeOptions);
listOptions.add(qrCodeOptions);
listOptions.add(metadataOptions);
 
// search for signatures in document
SearchResult result = signature.search(listOptions);
if (result.getSignatures().size() > 0)
{
    System.out.print("\nSource document contains following signatures.");
    for (BaseSignature resSignature : result.getSignatures())
    {
        System.out.print("Signature found at page "+resSignature.getPageNumber()+" with type "+resSignature.getSignatureType());
    }
}
else
{
    System.out.print("No one signature was found.");
}
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Search for multiple e-signature types

Path: /signature/net/search-for-multiple-e-signature-types/

Sometimes you may want to search for electronic signatures of different types simultaneously. [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) allows searching documents for different signature types in an easy and intuitive way. In common words the idea is to pass collection of desired signature types to Search method.

Here are the steps to search for multiple signatures types within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate search options for required signature types and them to collection of List<[SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions)\>  type.

The possible options are:

* [BarcodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesearchoptions) - to search for Barcode signatures;
* [DigitalSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsearchoptions) -  to search for Digital signatures;
* [FormFieldSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsearchoptions) - to search for Form-field signatures;
* [ImageSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesearchoptions) - to search for Image signatures;
* [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) - to search for Metadata signatures;
* [QrCodeSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesearchoptions) - to search for QR-code signatures;
* [TextSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsearchoptions) to search for Text signatures.
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass collection of [search options](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) to it.

This example shows how to search for multiple electronic signature types in the document.

```csharp
using (Signature signature = new Signature("SingedSample.pdf"))
{
    // define few search options
    BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions()
    {
        EncodeType = BarcodeTypes.Code128
    };
    QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions()
    {
        EncodeType = QrCodeTypes.QR,
        Text = "John",
        MatchType = TextMatchType.Contains
    };
    MetadataSearchOptions metadataOptions = new MetadataSearchOptions()
    {
        IncludeBuiltinProperties = true
    };

    // add options to list
    List<SearchOptions> listOptions = new List<SearchOptions>();
    listOptions.Add(barcodeOptions);
    listOptions.Add(qrCodeOptions);
    listOptions.Add(metadataOptions);

    // search for signatures in document
    SearchResult result = signature.Search(listOptions);
    if (result.Signatures.Count > 0)
    {
        Console.WriteLine("\nSource document contains following signatures.");
        foreach (var resSignature in result.Signatures)
        {
            Console.WriteLine("Signature found at page {0} with type {1}", 
                resSignature.PageNumber,
                resSignature.SignatureType);
        }
    }
    else
    {
        Console.WriteLine("Signatures was not found.");
    }
}
```

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Add point annotation

Path: /annotation/java/add-point-annotation/

Point annotation sticks comments to any point in a document as shown in the picture below:

![](/annotation/java/images/add-point-annotation.png)

You can use the following methods to set the properties of the [PointAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/pointannotation) class:

*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/pointannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position on the page
    

To add a point annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [PointAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/pointannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [PointAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/pointannotation) class.
4.  Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream. 

The following code snippet shows how to add [PointAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/pointannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding point annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of PointAnnotation class and set options
    PointAnnotation point = new PointAnnotation();
    point.setBox(new Rectangle(100, 100, 0, 0));
    point.setCreatedOn(Calendar.getInstance().getTime());
    point.setMessage("This is point annotation");
    point.setPageNumber(0);
    point.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(point);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add point annotation

Path: /annotation/net/add-point-annotation/

Point annotation sticks comments to any point in a document as shown in the picture below:

![](/annotation/net/images/add-point-annotation.png)

You can specify the following properties of the [PointAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/pointannotation) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/pointannotation/properties/box) defines the annotation position on the page
    

To add a point annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [PointAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/pointannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [PointAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/pointannotation) class.
4.  Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream. 

The following code snippet shows how to add [PointAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/pointannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add point annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	PointAnnotation point = new PointAnnotation
    {
    	Box = new Rectangle(100, 100, 0, 0),
        CreatedOn = DateTime.Now,
        Message = "This is point annotation",
        PageNumber = 0,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
             	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(point);
    annotator.Save("result.pdf"));
} 
```
{{< /tab >}}
{{< /tabs >}}
---

## Async API

Path: /markdown/net/async-api/


All static and instance methods have async counterparts. File I/O is truly asynchronous — source files are read and output files are written using async streams. CPU-bound conversion runs on the thread pool.

{{< alert style="info" >}}
The async API is available on .NET 6.0+ and .NET Framework 4.6.2+.
{{< /alert >}}

### Static async methods

{{< tabs "async-static">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Convert to string
string md = await MarkdownConverter.ToMarkdownAsync("business-plan.docx");

// Convert to file
await MarkdownConverter.ToFileAsync("business-plan.docx", "report.md");

// With options
var options = new ConvertOptions { IncludeFrontMatter = true };
string md = await MarkdownConverter.ToMarkdownAsync("business-plan.docx", null, options);

// Get document info
DocumentInfo info = await MarkdownConverter.GetInfoAsync("business-plan.docx");
Console.WriteLine($"{info.FileFormat}, {info.PageCount} pages");
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "report.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/async-api/AsyncStatic/report.md)
{{< /tab >}}
{{< /tabs >}}

### Instance async methods

{{< tabs "async-instance">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

using var converter = new MarkdownConverter("business-plan.docx");

// Convert to string
await converter.ConvertAsync("async-instance.md");

// Convert with options
var options = new ConvertOptions { HeadingLevelOffset = 1 };
ConvertResult result = await converter.ConvertAsync(options);

// Convert to file
await converter.ConvertAsync("async-instance.md");

// Get document info
DocumentInfo info = await converter.GetDocumentInfoAsync();
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "async-instance.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/async-api/AsyncInstance/async-instance.md)
{{< /tab >}}
{{< /tabs >}}

### Cancellation

All async methods accept a `CancellationToken`:

{{< tabs "async-cancellation">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var cts = new CancellationTokenSource(TimeSpan.FromSeconds(30));

try
{
    await MarkdownConverter.ToFileAsync(
        "professional-services.pdf",
        "async-cancellation.md",
        cancellationToken: cts.Token);
}
catch (TaskCanceledException)
{
    Console.WriteLine("Conversion timed out.");
}
```
{{< /tab >}}
{{< tab "professional-services.pdf" >}}  
{{< tab-text >}}
`professional-services.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/professional-services.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "async-cancellation.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAIAAADHHcVbAAAAA3NCSVQICAjb4U/gAAAMWElEQVR4nO3dUWzV130H8L+nSnsgxYTa5kbEnhJgJpJ98aQseTAxUaoiW1RDSiseykoCNE9boyoIZEWLVImosoZSpeve0Ighax4iDRRpky02oWKbh2aVCralhGBANSAu4Lq5NJ60tz0c8t/lf6/h2jjg/M/nIz8c7v/v3z345atz/v9zTkNpaiwBgFj92aPuAAA8SoIQgKgJQgCiJggBiNo3Mv/+53/9r4tXbi6u1t/v/Pa6tjXzXV1cZTXVVFNNNdVc2poZ2SCcmr4xfv7KQr8y+NPc/97j6uIqq6mmmmqqqebS1szIBuH6tjUNDQ0Xp2988T8LqAIAX1NLOSIEgK+dhsyC+p/87FdpEP7dzm+va613jjVJkvVtax5b8efzXb04fWNBY1U11VRTTTXVXJ
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/async-api/AsyncCancellation/async-cancellation.md)
{{< /tab >}}
{{< /tabs >}}

### ASP.NET Core example

{{< tabs "async-aspnet">}}
{{< tab "C#" >}}
```csharp
[ApiController]
[Route("api/[controller]")]
public class ConvertController : ControllerBase
{
    [HttpPost("to-markdown")]
    public async Task<IActionResult> ConvertToMarkdown(IFormFile file)
    {
        using var stream = file.OpenReadStream();
        using var converter = new MarkdownConverter(stream);

        ConvertResult result = await converter.ConvertAsync(
            new ConvertOptions { Flavor = MarkdownFlavor.GitHub });

        return Content(result.Content, "text/markdown");
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Change page orientation

Path: /merger/net/change-page-orientation/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to set **Portrait** or **Landscape** page orientation for specific or all document pages.

Here are the steps to change page orientation:

*   Initialize [OrientationOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/orientationoptions) class with desired orientation mode and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [ChangeOrientation](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/changeorientation) method and pass [OrientationOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/orientationoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to change page orientation:

```csharp
string filePath = @"c:\sample.docx";
string filePathOut = @"c:\output\result.docx";

OrientationOptions orientationOptions = new OrientationOptions(OrientationMode.Landscape, new int[] { 3, 4 });

using (Merger merger = new Merger(filePath))
{
    merger.ChangeOrientation(orientationOptions);
    merger.Save(filePathOut);
}
```

---

## Convert to WordProcessing with advanced options

Path: /conversion/net/convert-to-wordprocessing-with-advanced-options/

GroupDocs.Conversion provides the [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions) class to give you control over conversion result when convert to WordProcessing formats. Along with [common convert options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}}) from base class [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions) has the following additional options:

*   **[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** specifies desired result document type. Available options are: *Doc, Docm, Docx, Dot, Dotx, Rtf, Odt, Ott, Mobi, Txt, Md*.
*   **[PageWidth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/pagewidth)** specifies desired page width in points after conversion (1 point = 1/72 inch). When set, PageSize is automatically changed to Custom.
*   **[PageHeight](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/pageheight)** specifies desired page height in points after conversion (1 point = 1/72 inch). When set, PageSize is automatically changed to Custom.
*   **[PageSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/pagesize)** specifies page size. Available options are: *Default, A3, A4, A5, Letter, Legal, Tabloid*.
*   **[PageOrientation](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/pageorientation)** specifies page orientation. Available options are: *Default, Landscape, Portrait*.
*   **[FallbackPageSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/fallbackpagesize)** specifies the fallback page size to use when the input document's page size cannot be determined.
*   **[Dpi](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/dpi)** specifies desired page dpi after conversion. The default resolution is 96 dpi.
*   **[MarginTop](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/margintop)** specifies the desired page top margin in points after conversion.
*   **[MarginBottom](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/marginbottom)** specifies the desired page bottom margin in points after conversion.
*   **[MarginLeft](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/marginleft)** specifies the desired page left margin in points after conversion.
*   **[MarginRight](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/marginright)** specifies the desired page right margin in points after conversion.
*   **[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/password)** whether the converted document will be password protected with the specified password.
*   **[PdfRecognitionMode](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/pdfrecognitionmode)** specifies the recognition mode when converting from PDF. Available options are: *Textbox, Flow*. Flow mode is recommended for maximum content editability.
*   **[RtfOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/rtfoptions)** specifies RTF specific options. See [below](#rtfoptions).
*   **[MarkdownOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/markdownoptions)** specifies Markdown specific options when converting to Markdown format.
*   **[Zoom](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions/zoom)** specifies the zoom level in percentage. Default is 100.

The following code snippet shows how to convert to WordProcessing with advanced options:

```csharp
using (Converter converter = new Converter("sample.pdf"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        PageNumber = 2,
        PagesCount = 1,
        Format = WordProcessingFileType.Docx,
        PageOrientation = PageOrientation.Portrait
    };
    converter.Convert("converted.docx", options);
}
```

## Page Size and Dimensions

You can control page size using either predefined sizes or custom dimensions:

### Using Predefined Page Size

```csharp
using (Converter converter = new Converter("sample.pdf"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        PageSize = PageSize.A4,
        PageOrientation = PageOrientation.Portrait
    };
    converter.Convert("a4-document.docx", options);
}
```

### Using Custom Dimensions

```csharp
using (Converter converter = new Converter("sample.pdf"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        PageWidth = 612,   // 8.5 inches × 72 points/inch
        PageHeight = 792   // 11 inches × 72 points/inch
    };
    converter.Convert("custom-size.docx", options);
}
```

## Page Margins

Set custom margins for all four sides:

```csharp
using (Converter converter = new Converter("sample.pdf"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        MarginTop = 72,     // 1 inch
        MarginBottom = 72,  // 1 inch
        MarginLeft = 90,    // 1.25 inches
        MarginRight = 90    // 1.25 inches
    };
    converter.Convert("margins-document.docx", options);
}
```

## PDF Recognition Mode

When converting from PDF, control how content is interpreted:

```csharp
using (Converter converter = new Converter("document.pdf"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        PdfRecognitionMode = PdfRecognitionMode.Flow  // Recommended for editable content
    };
    converter.Convert("editable-document.docx", options);
}
```

Available recognition modes:
- **Textbox** - Preserves exact layout using textboxes (less editable)
- **Flow** - Optimizes for content flow and editability (recommended)

### RtfOptions

The [RtfOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/rtfoptions) class provides RTF-specific convert options:

*   **ExportImagesForOldReaders** - specifies whether the keywords for "old readers" are written to RTF or not. This can significantly affect the size of the RTF document.

The following code snippet shows how to convert to RTF with specific options:

```csharp
using (Converter converter = new Converter("sample.pdf"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        Format = WordProcessingFileType.Rtf,
        RtfOptions = new RtfOptions
        {
            ExportImagesForOldReaders = true
        }
    };
    converter.Convert("converted.rtf", options);
}
```

## Convert to Markdown

Convert documents to Markdown format:

```csharp
using (Converter converter = new Converter("sample.pdf"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        Format = WordProcessingFileType.Md
    };
    converter.Convert("converted.md", options);
}
```

## More Resources

- [API Reference: WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})

---

## Create and edit new WordProcessing document

Path: /editor/net/create-document/


This guide shows how to create a new blank document in a specific format using the `Editor` class from GroupDocs.Editor for .NET.

It is possible to create a new blank document in all major document formats, including text (DOCX), workbooks (XLSX), presentations (PPTX), e-books (EPUB) and emails (EML). See the full list of [supported document formats](https://docs.groupdocs.com/editor/net/supported-document-formats/), take a note on a "Create" column, which indicates whether it is possible to create a new document of a particular format.


---

## Prerequisites

* **.NET Framework 4.6.2**
* **.NET 6.0**

> ✅ Officially supported target frameworks based on the latest package version (25.7.0).
> 🔗 See more here: [NuGet – GroupDocs.Editor](https://www.nuget.org/packages/GroupDocs.Editor/)

### Install GroupDocs.Editor for .NET

```bash
dotnet add package GroupDocs.Editor
```

---

## Steps to Create and Edit a Document

### 1. Create a new document and apply edit options

```csharp
using System;
using System.IO;
using GroupDocs.Editor;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;


    using (Editor editor = new Editor(WordProcessingFormats.Docx))
    WordProcessingEditOptions editOptions = new WordProcessingEditOptions
    {
        EnablePagination = false,
        EnableLanguageInformation = true
    };

    EditableDocument editable = editor.Edit(editOptions);
```

### 2. Modify the HTML content

```csharp
    string html = editable.GetEmbeddedHtml();

    string updatedHtml = html.Replace(
        "<span class = \"text001\">&#xa0;</span>",
        "<span class = \"text001\">New text</span>");

    EditableDocument updatedDoc = EditableDocument.FromMarkup(updatedHtml);
```

### 3. Save the final document

```csharp
    WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
    saveOptions.EnablePagination = true;
    using Stream memoryStream = new MemoryStream();
    editor.Save(updatedDoc, memoryStream, saveOptions);

```

---

## Result

The code creates a new DOCX document, modifies its HTML body, and saves the final version to memory.
You can optionally save it to a physical file or return it via API.

---

## See also

* [`Editor` class constructor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/editor/#constructor)
* [`Editor.Edit(WordProcessingEditOptions)`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit/)
* [`Editor.Save(EditableDocument, Stream, WordProcessingSaveOptions)`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save/)
* ▶ [GitHub Sample: EditNewDocument.cs](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET/blob/master/Examples/GroupDocs.Editor.Examples.CSharp/AdvancedUsage/EditNewDocument.cs)


---

## Create new document by format

Path: /editor/java/create-document/



GroupDocs.Editor for Java empowers developers to effortlessly create and edit documents in various formats, including WordProcessing, Spreadsheet, Presentation, Ebook, and Email. This article provides a comprehensive guide on utilizing GroupDocs.Editor to obtain a new document in a specified format, extracting content from a client, processing it, and ultimately saving it to the resultant document.

## Getting Started with GroupDocs.Editor

To initiate the document creation process, the [**GroupDocs.Editor**](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/) constructor is employed. This constructor enables the creation of documents in different formats. Let's explore the key components of the code and how it handles various  [Document Formats](https://docs.groupdocs.com/editor/java/supported-document-formats/).

### 1. WordProcessing Document:

```java
ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();

// Create a new WordProcessing document and save it.
Editor editor = new Editor(WordProcessingFormats.Docx);
{
    // Edit the WordProcessing document with default options.
    EditableDocument defaultWordProcessingDoc = editor.edit();

    // Edit the WordProcessing document with specified options and some defined settings.
    WordProcessingEditOptions wordProcessingEditOptions = new WordProcessingEditOptions();
    wordProcessingEditOptions.setEnablePagination(false);  // Disable pagination for the document.
    wordProcessingEditOptions.setEnableLanguageInformation(true);  // Enable language information for the document.
    wordProcessingEditOptions.setFontExtraction(FontExtractionOptions.ExtractAllEmbedded);  // Extract all embedded fonts.

    EditableDocument editableWordProcessingDocument = editor.edit(wordProcessingEditOptions);
    editor.save(memoryStream);
}
```

### 2. Spreadsheet Document:

```java
ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();

// Create a new Spreadsheet document and save it.
Editor editor = new Editor(SpreadsheetFormats.Xlsx);
{
    // Edit the Spreadsheet document with default options.
    EditableDocument defaultEditableSpreadsheetDocument = editor.edit();

    // Edit the Spreadsheet document with specified options and some defined settings.
    SpreadsheetEditOptions spreadsheetEditOptions = new SpreadsheetEditOptions();
    spreadsheetEditOptions.setWorksheetIndex(0);
    spreadsheetEditOptions.setExcludeHiddenWorksheets(true);

    EditableDocument editableSpreadsheetDocument = editor.edit(spreadsheetEditOptions);
    editor.save(memoryStream);
}
```

### 3. Presentation Document:

```java
ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();

// Create a new Presentation document and save it.
Editor editor = new Editor(PresentationFormats.Pptx);
{
    // Edit the Presentation document with default options.
    EditableDocument defaultEditablePresentationDocument = editor.edit();

    // Edit the Presentation document with specified options and some defined settings.
    PresentationEditOptions presentationEditOptions = new PresentationEditOptions();
    presentationEditOptions.setShowHiddenSlides(false);
    presentationEditOptions.setSlideNumber(0);

    EditableDocument editablePresentationDocument = editor.edit(presentationEditOptions);
    editor.save(memoryStream);
}
```


### 4. Email Document:

```java
ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();

// Create a new Email document and save it.
Editor editor = new Editor(EmailFormats.Eml);
{
    // Edit the Email document with default options.
    EditableDocument defaultEditableEmailDocument = editor.edit();

    // Edit the Email document with specified options and some defined settings.
    EmailEditOptions emailEditOptions = new EmailEditOptions();
    emailEditOptions.setMailMessageOutput(MailMessageOutput.All);

    EditableDocument editableEmailDocument = editor.edit(emailEditOptions);
    editor.save(memoryStream);
}
```

## Conclusion

This article has provided a step-by-step guide on leveraging GroupDocs.Editor for Java to create new documents in various formats. By utilizing the constructor and specified edit options, developers can seamlessly integrate document creation and editing capabilities into their applications. Whether it's a WordProcessing, Spreadsheet, Presentation, Ebook, or Email document, GroupDocs.Editor simplifies the process, offering flexibility and efficiency in document manipulation. For more in-depth information, refer to the official [GroupDocs.Editor documentation](https://docs.groupdocs.com/editor/java/).

---

## Create New Document by Format

Path: /editor/nodejs-java/create-document/


**GroupDocs.Editor for Node.js via Java** empowers developers to effortlessly create and edit documents in various formats, including WordProcessing, Spreadsheet, Presentation, Ebook, and Email. This article provides a comprehensive guide on utilizing GroupDocs.Editor to create a new document in a specified format, process it, and ultimately save it to the resultant document.

## Getting Started with GroupDocs.Editor

To initiate the document creation process, the [**GroupDocs.Editor**](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/) constructor is employed. This constructor enables the creation of documents in different formats. Let's explore the key components of the code and how it handles various [Document Formats](https://docs.groupdocs.com/editor/nodejsjava/supported-document-formats/).

### 1. WordProcessing Document

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Create a new WordProcessing document
const editor = new groupdocsEditor.Editor(groupdocsEditor.WordProcessingFormats.Docx);

// Edit the WordProcessing document with default options
const defaultWordProcessingDoc = editor.edit();

// Edit the WordProcessing document with specified options and some defined settings
const wordProcessingEditOptions = new groupdocsEditor.WordProcessingEditOptions();
wordProcessingEditOptions.setEnablePagination(false);  // Disable pagination for the document
wordProcessingEditOptions.setEnableLanguageInformation(true);  // Enable language information for the document
wordProcessingEditOptions.setFontExtraction(groupdocsEditor.FontExtractionOptions.ExtractAllEmbedded);  // Extract all embedded fonts

const editableWordProcessingDocument = editor.edit(wordProcessingEditOptions);

// Save the document to a file
const outputFilePath = 'output.docx';
const saveOptions = new groupdocsEditor.WordProcessingSaveOptions(groupdocsEditor.WordProcessingFormats.Docx);

editor.save(editableWordProcessingDocument, outputFilePath, saveOptions);

// Dispose of resources
editableWordProcessingDocument.dispose();
editor.dispose();
```

### 2. Spreadsheet Document

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Create a new Spreadsheet document
const editor = new groupdocsEditor.Editor(groupdocsEditor.SpreadsheetFormats.Xlsx);

// Edit the Spreadsheet document with default options
const defaultEditableSpreadsheetDocument = editor.edit();

// Edit the Spreadsheet document with specified options and some defined settings
const spreadsheetEditOptions = new groupdocsEditor.SpreadsheetEditOptions();
spreadsheetEditOptions.setWorksheetIndex(0);
spreadsheetEditOptions.setExcludeHiddenWorksheets(true);

const editableSpreadsheetDocument = editor.edit(spreadsheetEditOptions);

// Save the document to a file
const outputFilePath = 'output.xlsx';
const saveOptions = new groupdocsEditor.SpreadsheetSaveOptions(groupdocsEditor.SpreadsheetFormats.Xlsx);

editor.save(editableSpreadsheetDocument, outputFilePath, saveOptions);

// Dispose of resources
editableSpreadsheetDocument.dispose();
editor.dispose();
```

### 3. Presentation Document

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Create a new Presentation document
const editor = new groupdocsEditor.Editor(groupdocsEditor.PresentationFormats.Pptx);

// Edit the Presentation document with default options
const defaultEditablePresentationDocument = editor.edit();

// Edit the Presentation document with specified options and some defined settings
const presentationEditOptions = new groupdocsEditor.PresentationEditOptions();
presentationEditOptions.setShowHiddenSlides(false);
presentationEditOptions.setSlideNumber(0);

const editablePresentationDocument = editor.edit(presentationEditOptions);

// Save the document to a file
const outputFilePath = 'output.pptx';
const saveOptions = new groupdocsEditor.PresentationSaveOptions(groupdocsEditor.PresentationFormats.Pptx);

editor.save(editablePresentationDocument, outputFilePath, saveOptions);

// Dispose of resources
editablePresentationDocument.dispose();
editor.dispose();
```

### 4. Email Document

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Create a new Email document
const editor = new groupdocsEditor.Editor(groupdocsEditor.EmailFormats.Eml);

// Edit the Email document with default options
const defaultEditableEmailDocument = editor.edit();

// Edit the Email document with specified options and some defined settings
const emailEditOptions = new groupdocsEditor.EmailEditOptions();
emailEditOptions.setMailMessageOutput(groupdocsEditor.MailMessageOutput.All);

const editableEmailDocument = editor.edit(emailEditOptions);

// Save the document to a file
const outputFilePath = 'output.eml';
const saveOptions = new groupdocsEditor.EmailSaveOptions(groupdocsEditor.EmailFormats.Eml);

editor.save(editableEmailDocument, outputFilePath, saveOptions);

// Dispose of resources
editableEmailDocument.dispose();
editor.dispose();
```

## Conclusion

This article has provided a step-by-step guide on leveraging GroupDocs.Editor for Node.js via Java to create new documents in various formats. By utilizing the constructor and specified edit options, developers can seamlessly integrate document creation and editing capabilities into their applications. Whether it's a WordProcessing, Spreadsheet, Presentation, Ebook, or Email document, GroupDocs.Editor simplifies the process, offering flexibility and efficiency in document manipulation. For more in-depth information, refer to the official [GroupDocs.Editor for Node.js via Java documentation](https://docs.groupdocs.com/editor/nodejsjava/).

---

**Note:** Make sure to replace `'output.docx'`, `'output.xlsx'`, `'output.pptx'`, and `'output.eml'` with the actual paths where you want to save your documents.

---

By following this guide, you can effectively create new documents in various formats using GroupDocs.Editor for Node.js via Java. This allows you to programmatically generate and manipulate documents within your Node.js applications.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.

---
---

## Create PDF with Image Redaction

Path: /redaction/net/create-pdf-with-image-redaction/


In some cases you might need to redact the pages of a document as images, redacting entire areas of the page instead or in addition to a specific text. With GroupDocs.Redaction you can use the following approach:  

*   open the document and apply all required redactions to the document's body (text, annotations, etc.);
    
*   save it as a rasterized PDF file (containing images of the original document's pages);
    
*   apply ImageAreaRedaction to remove specific areas on the pages within the PDF document.  
    
The following example demonstrates how to create a rasterized PDF from a Microsoft Word document and apply image redactions to its pages:

**C#**

```csharp
var stream = new MemoryStream();
// Rasterize the document before applying redactions
using (var redactor = new Redactor("C:\\Temp\\sample.docx"))
{
    // Perform annotation and textual redactions, if needed
    redactor.Save(stream, new RasterizationOptions() { Enabled = true });
    stream.Seek(0, SeekOrigin.Begin);
}
// Re-open the rasterized PDF document to redact its pages as images
using (var redactor = new Redactor(stream))
{
    RedactorChangeLog result = redactor.Apply(new Redactions.ImageAreaRedaction(new System.Drawing.Point(1160, 2375),
        new RegionReplacementOptions(System.Drawing.Color.Aqua, new System.Drawing.Size(1050, 720))));
    if (result.Status != RedactionStatus.Failed)
    {
        using (var fileStream = File.OpenWrite("C:\\Temp\\sample_docx_Raster.pdf"))
        {
            redactor.Save(fileStream, new RasterizationOptions() { Enabled = false });
        }
    }
}
```

Please, note that you don't have to use GroupDocs.Redaction to create a rasterized PDF from an office document. You will be able to use it, if you don't have any other tool for that.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Create PDF with Image Redaction

Path: /redaction/python-net/create-pdf-with-image-redaction/


In some cases you might need to redact the pages of a document as images, redacting entire areas of the page instead or in addition to a specific text. With GroupDocs.Redaction you can use the following approach:  

*   open the document and apply all required redactions to the document's body (text, annotations, etc.);
*   save it as a rasterized PDF file (containing images of the original document's pages);
*   apply ImageAreaRedaction to remove specific areas on the pages within the PDF document.  
    
The following example demonstrates how to create a rasterized PDF from a Microsoft Word document and apply image redactions to its pages:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.redaction.configuration as grc
import groupdocs.pydrawing as grd
from io import BytesIO
import os

def run():

    # Create an in-memory binary stream
    stream = BytesIO()

    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:

        # Save the redacted document
        ro = gro.RasterizationOptions()
        ro.enabled = True
        redactor.save(stream, ro)
        stream.seek(0)

    # Define the position on image
    sample_point = grd.Point(40, 160)
    # Define the size of the area which need to be redacted
    sample_size = grd.Size(350, 75)
    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Specify the redaction options
    repl_opt = grr.RegionReplacementOptions(color, sample_size)
    img_red = grr.ImageAreaRedaction(sample_point, repl_opt)

    # Load the stream to be redacted
    with gr.Redactor(stream) as redactor:

        # Apply the redaction
        result = redactor.apply(img_red)
        
        # Re-open the rasterized PDF document to redact its pages as images
        if (result.status != gr.RedactionStatus.FAILED):
            # Save the document to a custom location and convert its pages to images
            ro = gro.RasterizationOptions()
            ro.enabled = True
            with open("output.pdf", "wb") as stream_out:
                redactor.save(stream_out, ro)
```

Please, note that you don't have to use GroupDocs.Redaction to create a rasterized PDF from an office document. You will be able to use it, if you don't have any other tool for that.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Detect encoding

Path: /parser/java/detect-encoding/

GroupDocs.Parser provides the functionality to detect the encoding of a plain text file. The following encodings are supported:

*   UTF32 LE
*   UTF32 BE
*   UTF16 LE
*   UTF16 BE
*   UTF8
*   UTF7
*   ANSI  

Encoding can be detected by BOM or by the content of the file (if BOM isn't presented).  

Here are the steps to detect the encoding of the document:

*   Instantiate [LoadOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions) object with the default ANSI encoding;
*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getDocumentInfo()) method and cast the result to [TextDocumentInfo](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextDocumentInfo)
*   Read the [getCharset](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/TextDocumentInfo#getCharset()) property. 

The following example shows how to detect the encoding of the document:

```java
// Create an instance of LoadOptions class with the default ANSI encoding.
// This encoding is returned for ANSI text documents.
LoadOptions loadOptions = new LoadOptions(FileFormat.WordProcessing, null, null, Charset.forName("US-ASCII"));
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleText, loadOptions)) {
    // Get the document info
    IDocumentInfo info = parser.getDocumentInfo();
    // Check if it's the document info of a plain text document
    if (info instanceof TextDocumentInfo == false) {
        System.out.println("Isn't a plain text document");
        return;
    }
    // Print the encoding
    System.out.println("Encoding: " + ((TextDocumentInfo) info).getCharset().displayName());
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Detect encoding

Path: /parser/net/detect-encoding/

GroupDocs.Parser provides the functionality to detect the encoding of a plain text file. The following encodings are supported:

*   UTF32 LE
*   UTF32 BE
*   UTF16 LE
*   UTF16 BE
*   UTF8
*   UTF7
*   ANSI  

Encoding can be detected by BOM or by the content of the file (if BOM isn't presented). 

Here are the steps to detect the encoding of the document:

*   Instantiate [LoadOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions) object with the default ANSI encoding;
*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getdocumentinfo) method and cast the result to [TextDocumentInfo](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textdocumentinfo);
*   Read the [Encoding](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/textdocumentinfo/properties/encoding) property.

The following example shows how to detect the encoding of the document:

```csharp
// Create an instance of LoadOptions class with the default ANSI encoding.
// This encoding is returned for ANSI text documents.
LoadOptions loadOptions = new LoadOptions(FileFormat.WordProcessing, null, null, Encoding.GetEncoding(1251));
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SampleText, loadOptions))
{
    // Get the document info
    TextDocumentInfo info = parser.GetDocumentInfo() as TextDocumentInfo;
    // Check if it's the document info of a plain text document
    if (info == null)
    {
        Console.WriteLine("Isn't a plain text document");
        return;
    }

    // Print the encoding
    Console.WriteLine("Encoding: " + info.Encoding.WebName);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Document renaming

Path: /search/java/document-renaming/

Sometimes a situation arises when an indexed document is renamed, but its contents have not changed. In this case, to save computing resources, you can notify the index about the renaming of the document, and then the document will not be reindexed during the update operation.

To notify an index about renaming a document, the [notifyIndex](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#notifyIndex(com.groupdocs.search.Notification)) method is used with the corresponding notification object as a parameter.

You should keep in mind that if an index is notified of the renaming of a document, it will not be reindexed the next time you call the [update](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#update()) method, even if its contents have changed. The following example demonstrates how to notify an index of a renamed document.



```java
String indexFolder = "c:\\MyIndex";
String documentFolder = "c:\\MyDocuments";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents in a document folder
index.add(documentFolder);
 
// Renaming a document
String oldDocumentPath = "c:\\MyDocuments\\OldDocumentName.txt";
String newDocumentPath = "c:\\MyDocuments\\NewDocumentName.txt";
new File(oldDocumentPath).renameTo(new File(newDocumentPath));
 
// Notifying the index about renaming
Notification notification = Notification.createRenameNotification(oldDocumentPath, newDocumentPath);
boolean result = index.notifyIndex(notification);
 
// Updating the index
// The renamed document will not be reindexed
index.update();
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document renaming

Path: /search/net/document-renaming/

Sometimes a situation arises when an indexed document is renamed, but its contents have not changed. In this case, to save computing resources, you can notify the index about the renaming of the document, and then the document will not be reindexed during the update operation.

To notify an index about renaming a document, the [Notify](https://reference.groupdocs.com/search/net/groupdocs.search/index/methods/notify) method is used with the corresponding notification object as a parameter.

You should keep in mind that if an index is notified of the renaming of a document, it will not be reindexed the next time you call the [Update](https://reference.groupdocs.com/search/net/groupdocs.search/index/methods/update) method, even if its contents have changed. The following example demonstrates how to notify an index of a renamed document.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFolder = @"c:\MyDocuments";
   
// Creating an index
Index index = new Index(indexFolder);
   
// Indexing documents in a document folder
index.Add(documentFolder);
   
// Renaming a document
string oldDocumentPath = @"c:\MyDocuments\OldDocumentName.txt";
string newDocumentPath = @"c:\MyDocuments\NewDocumentName.txt";
File.Move(oldDocumentPath, newDocumentPath);
   
// Notifying the index about renaming
Notification notification = Notification.CreateRenameNotification(oldDocumentPath, newDocumentPath);
bool result = index.Notify(notification);
   
// Updating the index
// The renamed document will not be reindexed
index.Update();
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Document renaming

Path: /search/nodejs-java/document-renaming/

Sometimes a situation arises when an indexed document is renamed, but its contents have not changed. In this case, to save computing resources, you can notify the index about the renaming of the document, and then the document will not be reindexed during the update operation.

To notify an index about renaming a document, the [notifyIndex](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#notifyIndex(com.groupdocs.search.Notification)) method is used with the corresponding notification object as a parameter.

You should keep in mind that if an index is notified of the renaming of a document, it will not be reindexed the next time you call the [update](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#update()) method, even if its contents have changed. The following example demonstrates how to notify an index of a renamed document.

```javascript
const indexFolder = 'c:/MyIndex';
const documentFolder = 'c:/MyDocuments';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents in a document folder
index.add(documentFolder);

// Renaming a document
const oldDocumentPath = documentFolder + 'Lorem ipsum.txt';
const newDocumentPath = documentFolder + 'Lorem ipsum renamed.txt';
fs.renameSync(oldDocumentPath, newDocumentPath);

// Notifying the index about renaming
const notification = java.callStaticMethodSync(
  'com.groupdocs.search.Notification',
  'createRenameNotification',
  oldDocumentPath,
  newDocumentPath,
);
const result = index.notifyIndex(notification);
console.log('\nSuccessful rename: ' + result);

// Updating the index
// The renamed document will not be reindexed
index.update();
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Extract images from documents

Path: /parser/java/extract-images-from-documents/

GroupDocs.Parser allows to extract images from PDF, Emails, Ebooks, Microsoft Office: Word (DOC, DOCX), PowerPoint (PPT, PPTX), Excel (XLS, XLSX), LibreOffice formats and many others (see full list at [supported document formats]({{< ref "parser/java/getting-started/supported-document-formats.md" >}}) article).

GroupDocs.Parser's allows to easily implement simple and complex image extraction cases at the same time (see more at [advanced help section]({{< ref "parser/java/developer-guide/advanced-usage/working-with-images/_index.md" >}})).

In this article you can see how to extract images from any supported format without additional settings.

# Extract images from documents

To extract images from documents simply call the [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method:

```java
Iterable<PageImageArea> getImages();
```

This method returns a collection of [PageImageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea) objects:

| Member | Description |
| --- | --- |
| [getPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getPage()) | The page that contains the text area. |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area on the page that contains the text area. |
| [getFileType](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getFileType()) | The format of the image. |
| [getRotation](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getRotation()) | The rotation angle of the image. |
| [getImageStream](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream()) | Returns the image stream. |
| [getImageStream(ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#getImageStream(com.groupdocs.parser.options.ImageOptions)) | Returns the image stream in a different format. |
| [save(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String)) | Saves the image to the file. |
| [save(String, ImageOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageImageArea#save(java.lang.String,%20com.groupdocs.parser.options.ImageOptions)) | Saves the image to the file in a different format. |

Here are the steps to extract images from the whole document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getImages](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getImages()) method and obtain collection of image objects;
*   Check if *collection* isn't *null* (images extraction is supported for the document);
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract all images from the whole document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleImagesPdf)) {
    // Extract images
    Iterable<PageImageArea> images = parser.getImages();
    // Check if images extraction is supported
    if (images == null) {
        System.out.println("Images extraction isn't supported");
        return;
    }
    // Iterate over images
    for (PageImageArea image : images) {
        // Print a page index, rectangle and image type:
        System.out.println(String.format("Page: %d, R: %s, Type: %s", image.getPage().getIndex(), image.getRectangle(), image.getFileType()));
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract images from documents

Path: /parser/net/extract-images-from-documents/

GroupDocs.Parser allows to extract images from PDF, Emails, Ebooks, Microsoft Office: Word (DOC, DOCX), PowerPoint (PPT, PPTX), Excel (XLS, XLSX), LibreOffice formats and many others (see full list at [supported document formats]({{< ref "parser/net/getting-started/supported-document-formats.md" >}}) article).

GroupDocs.Parser's allows to easily implement simple and complex image extraction cases at the same time (see more at [advanced help section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-images/_index.md" >}})).

In this article you can see how to extract images from any supported format without additional settings.

## Extract images from documents

To extract images from documents simply call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method:

```csharp
IEnumerable<PageImageArea> GetImages();

```

The methods return a collection of [PageImageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea) objects:

| Member | Description |
| --- | --- |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page that contains the text area. |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area on the page that contains the text area. |
| [FileType](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/filetype) | The format of the image. |
| [Rotation](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/properties/rotation) | The rotation angle of the image. |
| Stream [GetImageStream()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/getimagestream) | Returns the image stream. |
| Stream [GetImageStream(ImageOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.pageimagearea/getimagestream/methods/1) | Returns the image stream in a different format. |
| void [Save(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pageimagearea/methods/save) | Saves the image to the file. |
| void Save(String, ImageOptions) | Saves the image to the file in a different format. |

Here are the steps to extract images from the whole document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser)  object for the initial document;
*   Call [GetImages](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getimages) method and obtain collection of image objects;
*   Check if *collection* isn't null (images extraction is supported for the document);
*   Iterate through the collection and get sizes, image types and image contents.

The following example shows how to extract images from a document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract images
    IEnumerable<PageImageArea> images = parser.GetImages();
    
    // Check if image extraction is supported
    if (images == null)
    {
        Console.WriteLine("Image extraction isn't supported");
        return;
    }
    
    // Iterate over images
    foreach (PageImageArea image in images)
    {
        // Print page index and image type
        Console.WriteLine($"Page: {image.Page.Index + 1}, Type: {image.FileType}");
    }
}
```

## More resources

### Advanced usage topics

To learn more about image extraction feature, please refer the [advanced help section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-images/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online image extractor App

Along with full featured .NET library we provide simple, but powerfull free APPs.

You are welcome to extract images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [GroupDocs Parser App](https://products.groupdocs.app/parser).
---

## Extract Images from Documents

Path: /parser/python-net/extract-images-from-documents/


GroupDocs.Parser can list and export images from supported documents (PDF, Office, emails, eBooks, and more).

## Extract images
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("./slides.pptx") as parser:
    images = parser.get_images()
    if images is None:
        print("Image extraction isn't supported for this format.")
    else:
        for index, image_area in enumerate(images, start=1):
            print(f"Page: {image_area.page.index + 1}, Type: {image_area.file_type}")
            # Save each image
            output_path = f"image-{index}.{image_area.file_type.extension}"
            image_area.save(output_path)
```

{{< /tab >}}
{{< tab "slides.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [slides.pptx](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-images-from-documents/slides.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Steps

1. Create `Parser` for the source file.  
2. Call `get_images()` to obtain `PageImageArea` items.  
3. Inspect `page`, `rectangle`, `file_type`, and save streams with `save()` or `get_image_stream()`.

For coordinates-based processing and format conversion, see the [advanced images guide]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-images/_index.md" >}}); the same workflow applies in Python.
---
id: extract-images-from-documents
url: parser/python-net/extract-images-from-documents
title: Extract Images from Documents
weight: 8
version: 25.12
description: "Extract embedded images from PDF, Word, Excel, presentations, emails, and archives using GroupDocs.Parser for Python via .NET."
productName: GroupDocs.Parser for Python via .NET
hideChildren: false
toc: true
tags: python, parser, image-extraction, v25.12
---

GroupDocs.Parser can list and export images from supported documents (PDF, Office, emails, eBooks, and more).

## Extract images
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser

with Parser("./slides.pptx") as parser:
    images = parser.get_images()
    if images is None:
        print("Image extraction isn't supported for this format.")
    else:
        for index, image_area in enumerate(images, start=1):
            print(f"Page: {image_area.page.index + 1}, Type: {image_area.file_type}")
            # Save each image
            output_path = f"image-{index}.{image_area.file_type.extension}"
            image_area.save(output_path)
```

{{< /tab >}}
{{< tab "slides.pptx" >}}
{{< tab-text >}}
The following sample file is used in this example: [slides.pptx](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-images-from-documents/slides.pptx)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Steps

1. Create `Parser` for the source file.  
2. Call `get_images()` to obtain `PageImageArea` items.  
3. Inspect `page`, `rectangle`, `file_type`, and save streams with `save()` or `get_image_stream()`.

For coordinates-based processing and format conversion, consult the `.NET` [advanced images guide]({{< ref "parser/net/developer-guide/advanced-usage/working-with-images/_index.md" >}}); the same workflow applies in Python.




---

## Extraction in separate process

Path: /search/net/extraction-in-separate-process/

Extracting data from documents is the most resource-intensive operation of the indexing process. And in case of insufficient memory, an exception occurs that completely interrupts the process of indexing a group of documents. To prevent this situation, data can be extracted in a separate process. In this case, insufficient memory when extracting data from one document will lead to a failure in indexing only this document. Indexing of the remaining documents in the group will continue further.

Extracting data from documents in a separate process also solves another problem – the problem of immediate interruption of a document indexing process when the allocated time limit for indexing one document is exceeded.

To extract data from documents in a separate process, you need to configure the appropriate indexing options, and also create a simple console application project that the GroupDocs.Search library will run in a separate process as a data extraction service. The console application project for data extraction must have the GroupDocs.Search library as a dependency, as does the main project using the library. The console application project code is presented in the following listing.

**C#**

```csharp
public class Program
{
    static void Main(string[] args)
    {
        using (var host = new GroupDocs.Search.ExtractionHost(args))
        {
            host.Run();
        }
    }
}
```

An example of setting indexing options for data extraction in a separate process is shown in the listing below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";

// Getting the path to the console application location
string assemblyPath = typeof(GroupDocs.Search.Extraction.Program).Assembly.Location;

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Setting indexing options for data extraction in a separate process
IndexingOptions options = new IndexingOptions();
options.SeparateProcessOptions.ExtractInSeparateProcess = true;
options.SeparateProcessOptions.AssemblyPath = assemblyPath;
options.SeparateProcessOptions.Timeout = new TimeSpan(0, 1, 0);

// Indexing documents from the specified folder
index.Add(documentFolder, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Generate Document from JSON Data Source

Path: /assembly/net/basic-usage-json-datasource/


## Overview

GroupDocs.Assembly for .NET enables you to generate documents directly from JSON data sources. The `JsonDataSource` class automatically parses JSON and makes it available to your templates, supporting both simple and complex JSON structures.

The main classes involved are:
- [JsonDataSource](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/jsondatasource/) - loads and parses JSON data
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents from templates
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps the data source

Here are the steps to generate documents from JSON:

* Create or obtain JSON data (from file, API, or string)
* Instantiate JsonDataSource with the JSON data
* Create a template document with expression tags referencing JSON properties
* Use DocumentAssembler to assemble the template with JsonDataSource
* Save the assembled document

{{< alert style="info" >}}
JsonDataSource automatically recognizes JSON types (numbers, booleans, dates, strings) and makes them available with proper types in templates, enabling numeric operations and date formatting.
{{< /alert >}}

## Generate Document from JSON File

The simplest way to use JSON data is from a file:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromJsonFile()
{
    JsonDataSource jsonDataSource = new JsonDataSource("data.json");

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(jsonDataSource, "data"));
}
```

## Generate Document from JSON String

You can also create JsonDataSource from a JSON string:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromJsonString()
{
    string jsonString = @"{
        ""name"": ""John Doe"",
        ""age"": 30,
        ""email"": ""john.doe@example.com"",
        ""active"": true
    }";
    
    JsonDataSource jsonDataSource = new JsonDataSource(jsonString);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(jsonDataSource, "person"));
}
```

## Working with JSON Arrays

When your JSON root is an array, JsonDataSource treats it as a collection:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromJsonArray()
{
    string jsonArray = @"[
        { ""name"": ""John"", ""age"": 30 },
        { ""name"": ""Jane"", ""age"": 28 },
        { ""name"": ""Bob"", ""age"": 35 }
    ]";
    
    JsonDataSource jsonDataSource = new JsonDataSource(jsonArray);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(jsonDataSource, "people"));
}
```

## Template Example for JSON Object

For a JSON object like `{"name": "John", "age": 30}`, your template can reference properties directly:

```
Name: <<[data.name]>>
Age: <<[data.age]>>
```

## Template Example for JSON Array

For a JSON array, use a foreach data band to iterate:

```
<<foreach [in people]>>
Name: <<[name]>>, Age: <<[age]>>
<</foreach>>
```

## Working with Nested JSON Objects

JsonDataSource handles nested JSON structures automatically:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateFromNestedJson()
{
    string nestedJson = @"{
        ""company"": ""ABC Corp"",
        ""address"": {
            ""street"": ""123 Main St"",
            ""city"": ""New York"",
            ""zip"": ""10001""
        },
        ""employees"": [
            { ""name"": ""John"", ""position"": ""Developer"" },
            { ""name"": ""Jane"", ""position"": ""Manager"" }
        ]
    }";
    
    JsonDataSource jsonDataSource = new JsonDataSource(nestedJson);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(jsonDataSource, "company"));
}
```

Template for nested JSON:

```
Company: <<[company.company]>>
Address: <<[company.address.street]>>, <<[company.address.city]>> <<[company.address.zip]>>

Employees:
<<foreach [in company.employees]>>
- <<[name]>>, <<[position]>>
<</foreach>>
```

## Configure JSON Data Load Options

You can configure how JsonDataSource parses JSON:

```csharp
using GroupDocs.Assembly;
using GroupDocs.Assembly.Data;

public static void GenerateWithJsonOptions()
{
    JsonDataLoadOptions options = new JsonDataLoadOptions();
    options.AlwaysGenerateRootObject = true; // Always create root object
    options.SimpleValueParseMode = JsonSimpleValueParseMode.Strict; // Strict type parsing
    
    JsonDataSource jsonDataSource = new JsonDataSource("data.json", options);

    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx",
        new DataSourceInfo(jsonDataSource, "data"));
}
```

{{< alert style="warning" >}}
By default, if a root JSON element is an object with only one property that is an object or array, the engine skips the root object. Set `AlwaysGenerateRootObject` to true to always include it.
{{< /alert >}}

### Advanced Usage Topics

To learn more about working with complex JSON structures, date-time parsing, and advanced JsonDataSource options, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Get document info

Path: /watermark/net/get-document-info/

GroupDocs.Watermark allows obtaining document information which includes:

* [FileType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common/idocumentinfo/properties/filetype)
* [PageCount](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common/idocumentinfo/properties/pagecount)
* [Size](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common/idocumentinfo/properties/size)
* [IsEncrypted](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common/idocumentinfo/properties/isencrypted)

The following code samples demonstrate how to get document information.

## Get document information from a file from local disk

This example demonstrates how to get document information from the local file.

**BasicUsage.GetDocumentInfoForTheFileFromLocalDisk**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\source.docx"
using (Watermarker watermarker = new Watermarker("source.docx"))
{
    IDocumentInfo info = watermarker.GetDocumentInfo();
    Console.WriteLine("File type: {0}", info.FileType);
    Console.WriteLine("Number of pages: {0}", info.PageCount);
    Console.WriteLine("Document size: {0} bytes", info.Size);
}
```

## Get document information from a stream

This example demonstrates how to get document information from the file stream.

**BasicUsage.GetDocumentInfoForTheFileFromStream**

```csharp
// Specify an absolute or relative path to your document. Ex: @"C:\Docs\source.docx"
using (FileStream stream = File.OpenRead("source.docx"))
{
    using (Watermarker watermarker = new Watermarker(stream))
    {
        IDocumentInfo info = watermarker.GetDocumentInfo();
        Console.WriteLine("File type: {0}", info.FileType);
        Console.WriteLine("Number of pages: {0}", info.PageCount);
        Console.WriteLine("Document size: {0} bytes", info.Size);
    }
}
```


---

## Get document info

Path: /watermark/python-net/get-document-info/


GroupDocs.Watermark can obtain document information:

- FileType
- PageCount
- Size
- IsEncrypted

## Get document information from a file from local disk

GroupDocs.Watermark lets you extract key details about a document before working with it. You can check its format, size, number of pages, and encryption status either from a file on disk or directly from a stream.

```python
import groupdocs.watermark as gw

with gw.Watermarker("source.docx") as watermarker:
    info = watermarker.get_document_info()
    print("File type:", info.file_type)
    print("Number of pages:", info.page_count)
    print("Document size:", info.size)
```

## Get document information from a stream

```python
import io
import groupdocs.watermark as gw

with open("source.docx", "rb") as f:
    stream = io.BytesIO(f.read())

with gw.Watermarker(stream) as watermarker:
    info = watermarker.get_document_info()
    print("File type:", info.file_type)
    print("Number of pages:", info.page_count)
    print("Document size:", info.size)
```

🔹 Use case: Validate documents before processing (e.g., reject encrypted files, check page limits, or confirm file type).

---

## Get file info

Path: /watermark/nodejs-java/get-file-info/


With [GroupDocs.Watermark](https://products.groupdocs.com/watermark/nodejs-java) you can retrieve the following information about a file:

*   `FileType`<!--](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.interfaces/idocumentinfo/filetype/)--> represents the document file type (PDF, Word document, Excel spreadsheet, PowerPoint presentation, image etc.).
*   `PageCount`<!--](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.interfaces/idocumentinfo/pagecount/)--> represents the number of pages in a document.
*   `FileSize`<!--](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.interfaces/idocumentinfo/size/)--> represents the document file size.
*   `PagesInfo`<!--](https://reference.groupdocs.com/watermark/net/groupdocs.watermark.interfaces/idocumentinfo/pagesinfo/)--> represents the page information.

The following code samples show how to get file information:

## Get file info for the file from a local disk

```javascript
const watermarker = new groupdocs.watermark.Watermarker(documentPath);

const documentInfo = watermarker.getDocumentInfo();
console.log('File type:', documentInfo.getFileType().toString());
console.log('Number of pages:', documentInfo.getPageCount());
console.log('Document size:', documentInfo.getSize(), 'bytes');
```



---

## Hello, world!

Path: /watermark/net/hello-world/

In this article, you will learn how to create a simple C# application that appends a text watermark using the GroupDocs.Watermark API. 

{{% alert color="primary" %}} 
We assume that you already have a basic knowledge of **Microsoft Visual Studio** and **C#**.
{{% /alert %}}

## Requirements

- A [compatible]({{< ref "watermark/net/getting-started/system-requirements.md" >}}) system with Microsoft Visual Studio installed. As an individual developer, you can use a free Visual Studio Community Edition.
- **5 minutes** of your spare time.

## Preparing

1. Open Visual Studio and go to **File** -> **New** -> **Project**.
2. Select the **Console App** project type.
3. [Install]({{< ref "watermark/net/getting-started/installation.md" >}}) **GroupDocs.Watermark** NuGet package to the project.

## Coding

1. Create an instance of the `Watermarker` class for the local document. You can specify an absolute or relative path:
   ```csharp
   Watermarker watermarker = new Watermarker("C:\\Docs\\sample.docx")
   ```
2. Create an instance of the `TextWatermark` class and specify the desired text and font for the watermark:
   ```csharp
   TextWatermark watermark = new TextWatermark("Hello, world!", new Font("Arial", 36));
   ```
3. Apply the watermark:
   ```csharp
   watermarker.Add(watermark);
   ```
4. Save the resulting document:
   ```csharp
   watermarker.Save("C:\\Docs\\watermarked-sample.docx");
   ```

Full code:

```csharp
using GroupDocs.Watermark;
using GroupDocs.Watermark.Watermarks;

// Specify an absolute or relative path to your document.
using (Watermarker watermarker = new Watermarker("C:\\Docs\\sample.docx"))
{
   // Specify the desired text and font for the watermark
   TextWatermark watermark = new TextWatermark("Test watermark", 
      new Font("Arial", 36, FontStyle.Bold | FontStyle.Italic));
      
   watermark.HorizontalAlignment = HorizontalAlignment.Center;
   watermark.VerticalAlignment = VerticalAlignment.Center;

   watermark.Opacity = 0.4;
   watermark.RotateAngle = 45;
   watermark.ForegroundColor = Color.Red;

    // Apply the watermark
    watermarker.Add(watermark);
    // Save the resulting document
    watermarker.Save("C:\\Docs\\watermarked-sample.docx");
}
```

Additionally, if you are certain about your file extension or know the document type in advance, you can specify the FileType through the LoadOptions class. Specifying it eliminates the need for format detection, enabling faster and more efficient document processing:

```csharp

var filePath = "C:\\Docs\\sample.docx";
var loadOptions = new LoadOptions()
{
    FileType = FileType.FromExtension(Path.GetExtension(filePath))
};

// Or set the FormatFamily property directly when using a stream, for example:
loadOptions.FormatFamily = FormatFamily.WordProcessing;

using (var watermarker = new Watermarker(filePath, loadOptions))
{ .... }

```

## Running

Run the program. A new watermarked document will appear in the specified path.

!["Hello, world!" example](/watermark/net/images/hello-world.png)

## What's next

Congratulations! You have added a simple text watermark to a document. Read the [Developer guide]({{< ref "watermark/net/developer-guide" >}}) and [API reference](https://reference.groupdocs.com/watermark/net/) to learn how to customize text watermarks, add images as watermarks, search documents for existing watermarks, and much more.

---

## Highlighting search results

Path: /search/java/highlighting-search-results/

This page describes how to highlight search results in the text of a document.

## Hit highlighting in the text of entire document

After performing a search, occurrences of found words and phrases for a particular document can be highlighted in the text of the document using the [highlight](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#highlight(com.groupdocs.search.results.FoundDocument,%20com.groupdocs.search.highlighters.Highlighter)) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class. To do this, a highlighter of the corresponding type must be passed as an argument to the method.

The Index class also represents an overload of the [highlight](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#highlight(com.groupdocs.search.results.FoundDocument,%20com.groupdocs.search.highlighters.Highlighter)) method, which takes an object of the [HighlightOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions) class as an argument. The [HighlightOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions) class contains properties for setting the following options:

*   [setCustomExtractor](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#setCustomExtractor(com.groupdocs.search.common.IFieldExtractor)) method sets an extractor used during indexing, it is necessary if the text of the document was not saved in the index.
*   [setAdditionalFields](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#setAdditionalFields(com.groupdocs.search.common.DocumentField%5B%5D)) method sets additional document fields added during document indexing which are also necessary if the document text was not saved in the index.
*   [setCancellation](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method sets an object used to cancel the operation.
*   [setGenerateHead](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#setGenerateHead(boolean)) method sets a flag to specify whether the Head tag is generated in the output HTML.
*   [getMetadataIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/TextOptions#getMetadataIndexingOptions()) method returns an object for specifying metadata indexing options.
*   [setUseInlineStyles](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setUseInlineStyles(boolean)) method sets a flag to specify whether inline styles or CSS class are used to highlight occurrences.
*   [setHighlightColor](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setHighlightColor(com.groupdocs.search.options.Color)) method sets a color used to highlight occurrences.
*   [TermHighlightStartTag](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setTermHighlightStartTag(java.lang.String)) is the start tag of the highlighting of the found word. This tag is used only when highlighting in plain text.
*   [TermHighlightEndTag](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setTermHighlightEndTag(java.lang.String)) is the end tag of the highlighting of the found word. This tag is used only when highlighting in plain text.

The other options are used for highlighting occurrences in text fragments.

To highlight search results in the text of the whole document, a highlighter of the [DocumentHighlighter](https://reference.groupdocs.com/search/java/com.groupdocs.search.highlighters/DocumentHighlighter) class is used. To create a highlighter of this type, you must pass an object of a class derived from the abstract class [OutputAdapter](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/OutputAdapter) to its constructor. Details on the output adapters are presented on the page [Output adapters]({{< ref "search/java/developer-guide/advanced-usage/searching/output-adapters.md" >}}).

If after generation the text of a document was saved to a file, this file can be opened by an Internet browser to navigate the occurrences of the words found. To navigate the occurrences, the following text is added to the URL in a browser:

#hitN

where N is a number starting from zero. The full document URL in a browser might look like this:

file:///C:/Text.html#hit0

The following example demonstrates how to highlight search results in the text of an entire document.

```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";

// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentFolder);

// Search for the word 'Universe'
SearchResult result = index.search("Universe");

// Highlighting occurrences in the text
if (result.getDocumentCount() > 0) {
    FoundDocument document = result.getFoundDocument(0); // Getting the first found document
    StructureOutputAdapter outputAdapter = new StructureOutputAdapter(OutputFormat.PlainText); // Creating the output adapter
    Highlighter highlighter = new DocumentHighlighter(outputAdapter); // Creating the highlighter instance
    HighlightOptions options = new HighlightOptions(); // Creating the highlight options
    options.setTermHighlightStartTag("<Term>"); // Setting the start tag for the found word
    options.setTermHighlightEndTag("</Term>"); // Setting the end tag for the found word
    index.highlight(document, highlighter, options); // Generating plain text with highlighted occurrences

    DocumentField[] fields = outputAdapter.getResult();
    System.out.println(document.toString());
    for (DocumentField field : fields) {
        // Printing field names of the found document
        System.out.println("\t" + field.getName());
    }
}
```

## Hit highlighting in text fragments

Occurrences can also be highlighted in separate HTML or plain text fragments. For this, the highlighter of the [FragmentHighlighter](https://reference.groupdocs.com/search/java/com.groupdocs.search.highlighters/FragmentHighlighter) class is used. The following parameters are presented in the [HighlightOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions) class to use with the highlighter of this type:

*   [setTermsBefore](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setTermsBefore(int)) method is used to specify the maximum number of words in a text fragment before highlighted word. The value must be in the range from 0 to 10000. The default value is 7.
*   [setTermsAfter](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setTermsAfter(int)) method is used to specify the maximum number of words in a text fragment after highlighted word. The value must be in the range from 0 to 10000. The default value is 7.
*   [setTermsTotal](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setTermsTotal(int)) is used to specify the maximum number of words in a text fragment. The value must be in the range from 0 to 10000. The default value is 21.
*   [TermHighlightStartTag](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setTermHighlightStartTag(java.lang.String)) is the start tag of the highlighting of the found word. This tag is used only when highlighting in plain text.
*   [TermHighlightEndTag](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/HighlightOptions#setTermHighlightEndTag(java.lang.String)) is the end tag of the highlighting of the found word. This tag is used only when highlighting in plain text.

Generated text fragments with highlighted occurrences can be used, for example, to generate web pages containing search results on a site.

The example below demonstrates how to highlight search results in separate text fragments.

```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";

// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search for the word 'Einstein'
SearchResult result = index.search("Einstein");

// Assigning highlight options
HighlightOptions options = new HighlightOptions();
options.setTermsBefore(5);
options.setTermsAfter(5);
options.setTermsTotal(15);
options.setHighlightColor(new Color(0, 0, 127));
options.setUseInlineStyles(true);

// Highlighting found words in separate text fragments of a document
FoundDocument document = result.getFoundDocument(0);
FragmentHighlighter highlighter = new FragmentHighlighter(OutputFormat.Html);
index.highlight(document, highlighter, options);

// Getting the result
FragmentContainer[] fragmentContainers = highlighter.getResult();
for (FragmentContainer container : fragmentContainers) {
    String[] fragments = container.getFragments();
    if (fragments.length > 0) {
        System.out.println(container.getFieldName());
        System.out.println();
        for (String fragment : fragments) {
            // Printing HTML markup to console
            System.out.println(fragment);
            System.out.println();
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Highlighting search results

Path: /search/net/highlighting-search-results/

This page describes how to highlight search results in the text of a document.

## Hit highlighting in the text of entire document

After performing a search, occurrences of found words and phrases for a particular document can be highlighted in the text of the document using the [Highlight](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/highlight/index) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class. To do this, a highlighter of the corresponding type must be passed as an argument to the method.

The Index class also represents an overload of the [Highlight](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/highlight/index) method, which takes an object of the [HighlightOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/highlightoptions) class as an argument. The [HighlightOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/highlightoptions) class contains properties for setting the following options:

*   [CustomExtractor](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/customextractor) is an extractor used during indexing, it is necessary if the text of the document was not saved in the index.
*   [AdditionalFields](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/additionalfields) are additional document fields added during document indexing which are also necessary if the document text was not saved in the index.
*   [Cancellation](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/cancellation) is an object used to cancel the operation.
*   [GenerateHead](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/generatehead) is a flag to specify whether the Head tag is generated in the output HTML.
*   [MetadataIndexingOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/textoptions/properties/metadataindexingoptions) is an object for specifying metadata indexing options.
*   [UseInlineStyles](https://reference.groupdocs.com/search/net/groupdocs.search.options/highlightoptions/properties/useinlinestyles) is a flag to specify whether inline styles or CSS class are used to highlight occurrences.
*   [HighlightColor](https://reference.groupdocs.com/search/net/groupdocs.search.options/highlightoptions/properties/highlightcolor) is a color used to highlight occurrences.
*   [TermHighlightStartTag](https://reference.groupdocs.com/search/net/groupdocs.search.options/highlightoptions/properties/termhighlightstarttag) is the start tag of the highlighting of the found word. This tag is used only when highlighting in plain text.
*   [TermHighlightEndTag](https://reference.groupdocs.com/search/net/groupdocs.search.options/highlightoptions/properties/termhighlightendtag) is the end tag of the highlighting of the found word. This tag is used only when highlighting in plain text.

The other options are used for highlighting occurrences in text fragments.

To highlight search results in the text of the whole document, a highlighter of the [DocumentHighlighter](https://reference.groupdocs.com/net/search/groupdocs.search.highlighters/documenthighlighter) class is used. To create a highlighter of this type, you must pass an object of a class derived from the abstract class [OutputAdapter](https://reference.groupdocs.com/net/search/groupdocs.search.common/outputadapter) to its constructor. Details on the output adapters are presented on the page [Output adapters]({{< ref "search/net/developer-guide/advanced-usage/searching/output-adapters.md" >}}).

If after generation the text of a document was saved to a file, this file can be opened by an Internet browser to navigate the occurrences of the words found. To navigate the occurrences, the following text is added to the URL in a browser:

#hitN

where N is a number starting from zero. The full document URL in a browser might look like this:

[file:///C:/Text.html#hit0](file:///C:/Text.html#hit0)

The following example demonstrates how to highlight search results in the text of an entire document.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";

// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.TextStorageSettings = new TextStorageSettings(Compression.High); // Enabling storage of extracted text in the index

// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);

// Indexing documents from the specified folder
index.Add(documentFolder);

// Search for the word 'Universe'
SearchResult result = index.Search("Universe");

// Highlighting occurrences in the text
if (result.DocumentCount > 0)
{
    FoundDocument document = result.GetFoundDocument(0); // Getting the first found document
    StructureOutputAdapter outputAdapter = new StructureOutputAdapter(OutputFormat.PlainText); // Creating the output adapter
    Highlighter highlighter = new DocumentHighlighter(outputAdapter); // Creating the highlighter instance
    HighlightOptions options = new HighlightOptions(); // Creating the highlight options
    options.TermHighlightStartTag = "<Term>"; // Setting the start tag for the found word
    options.TermHighlightEndTag = "</Term>"; // Setting the end tag for the found word
    index.Highlight(document, highlighter, options); // Generating plain text with highlighted occurrences

    DocumentField[] fields = outputAdapter.GetResult();
    Console.WriteLine(document.ToString());
    for (int i = 0; i < fields.Length; i++)
    {
        // Printing field names of the found document
        DocumentField field = fields[i];
        Console.WriteLine("\t" + field.Name);
    }
}
```

## Hit highlighting in text fragments

Occurrences can also be highlighted in separate HTML or plain text fragments. For this, the highlighter of the [FragmentHighlighter](https://reference.groupdocs.com/net/search/groupdocs.search.highlighters/fragmenthighlighter) class is used. The following properties are presented in the [HighlightOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/highlightoptions) class to use with the highlighter of this type:

*   [TermsBefore](https://reference.groupdocs.com/net/search/groupdocs.search.options/highlightoptions/properties/termsbefore) is used to specify the maximum number of words in a text fragment before highlighted word. The value must be in the range from 0 to 10000. The default value is 7.
*   [TermsAfter](https://reference.groupdocs.com/net/search/groupdocs.search.options/highlightoptions/properties/termsafter) is used to specify the maximum number of words in a text fragment after highlighted word. The value must be in the range from 0 to 10000. The default value is 7.
*   [TermsTotal](https://reference.groupdocs.com/net/search/groupdocs.search.options/highlightoptions/properties/termstotal) is used to specify the maximum number of words in a text fragment. The value must be in the range from 0 to 10000. The default value is 21.
*   [TermHighlightStartTag](https://reference.groupdocs.com/search/net/groupdocs.search.options/highlightoptions/properties/termhighlightstarttag) is the start tag of the highlighting of the found word. This tag is used only when highlighting in plain text.
*   [TermHighlightEndTag](https://reference.groupdocs.com/search/net/groupdocs.search.options/highlightoptions/properties/termhighlightendtag) is the end tag of the highlighting of the found word. This tag is used only when highlighting in plain text.

Generated text fragments with highlighted occurrences can be used, for example, to generate web pages containing search results on a site.

The example below demonstrates how to highlight search results in separate text fragments.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.TextStorageSettings = new TextStorageSettings(Compression.High); // Enabling storage of extracted text in the index

// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);

// Indexing documents from the specified folder
index.Add(documentsFolder);

// Search for the word 'Einstein'
SearchResult result = index.Search("Einstein");

// Assigning highlight options
HighlightOptions options = new HighlightOptions();
options.TermsBefore = 5;
options.TermsAfter = 5;
options.TermsTotal = 15;
options.HighlightColor = new Color(0, 0, 127);
options.UseInlineStyles = true;

// Highlighting found words in separate text fragments of a document
FoundDocument document = result.GetFoundDocument(0);
FragmentHighlighter highlighter = new FragmentHighlighter(OutputFormat.Html);
index.Highlight(document, highlighter, options);

// Getting the result
FragmentContainer[] fragmentContainers = highlighter.GetResult();
for (int i = 0; i < fragmentContainers.Length; i++)
{
    FragmentContainer container = fragmentContainers[i];
    string[] fragments = container.GetFragments();
    if (fragments.Length > 0)
    {
        Console.WriteLine(container.FieldName);
        Console.WriteLine();
        for (int j = 0; j < fragments.Length; j++)
        {
            // Printing HTML markup to console
            Console.WriteLine(fragments[j]);
            Console.WriteLine();
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Highlighting search results

Path: /search/nodejs-java/highlighting-search-results/

This page describes how to highlight search results in the text of a document.

## Hit highlighting in the text of entire document

After performing a search, occurrences of found words and phrases for a particular document can be highlighted in the text of the document using the [highlight](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#highlight(com.groupdocs.search.results.FoundDocument,%20com.groupdocs.search.highlighters.Highlighter)) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class. To do this, a highlighter of the corresponding type must be passed as an argument to the method.

The Index class also represents an overload of the [highlight](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#highlight(com.groupdocs.search.results.FoundDocument,%20com.groupdocs.search.highlighters.Highlighter)) method, which takes an object of the [HighlightOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions) class as an argument. The [HighlightOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions) class contains properties for setting the following options:

*   [setCustomExtractor](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#setCustomExtractor(com.groupdocs.search.common.IFieldExtractor)) method sets an extractor used during indexing, it is necessary if the text of the document was not saved in the index.
*   [setAdditionalFields](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#setAdditionalFields(com.groupdocs.search.common.DocumentField%5B%5D)) method sets additional document fields added during document indexing which are also necessary if the document text was not saved in the index.
*   [setCancellation](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method sets an object used to cancel the operation.
*   [setGenerateHead](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#setGenerateHead(boolean)) method sets a flag to specify whether the Head tag is generated in the output HTML.
*   [getMetadataIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/TextOptions#getMetadataIndexingOptions()) method returns an object for specifying metadata indexing options.
*   [setUseInlineStyles](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setUseInlineStyles(boolean)) method sets a flag to specify whether inline styles or CSS class are used to highlight occurrences.
*   [setHighlightColor](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setHighlightColor(com.groupdocs.search.options.Color)) method sets a color used to highlight occurrences.
*   [TermHighlightStartTag](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setTermHighlightStartTag(java.lang.String)) is the start tag of the highlighting of the found word. This tag is used only when highlighting in plain text.
*   [TermHighlightEndTag](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setTermHighlightEndTag(java.lang.String)) is the end tag of the highlighting of the found word. This tag is used only when highlighting in plain text.

The other options are used for highlighting occurrences in text fragments.

To highlight search results in the text of the whole document, a highlighter of the [DocumentHighlighter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.highlighters/DocumentHighlighter) class is used. To create a highlighter of this type, you must pass an object of a class derived from the abstract class [OutputAdapter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/OutputAdapter) to its constructor. Details on the output adapters are presented on the page [Output adapters]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/output-adapters.md" >}}).

If after generation the text of a document was saved to a file, this file can be opened by an Internet browser to navigate the occurrences of the words found. To navigate the occurrences, the following text is added to the URL in a browser:

#hitN

where N is a number starting from zero. The full document URL in a browser might look like this:

file:///C:/Text.html#hit0

The following example demonstrates how to highlight search results in the text of an entire document.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index settings instance
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentFolder);

// Search for the word 'ipsum'
const result = index.search('ipsum');

// Highlighting occurrences in the text
if (result.getDocumentCount() > 0) {
  {
    const document = result.getFoundDocument(0); // Getting the first found document
    const outputAdapter = new groupdocs.search.FileOutputAdapter(groupdocs.search.OutputFormat.Html, 'c:/Result.html/'); // Creating an output adapter to a file
    const highlighter = new groupdocs.search.DocumentHighlighter(outputAdapter); // Creating the highlighter object
    const options = new groupdocs.search.HighlightOptions(); // Creating the highlight options
    options.setHighlightColor(new groupdocs.search.Color(150, 255, 150)); // Setting highlight color
    options.setUseInlineStyles(false); // Using CSS styles to highlight occurrences
    options.setGenerateHead(true); // Generating Head tag in output HTML
    index.highlight(document, highlighter, options); // Generating HTML formatted text with highlighted occurrences
  }
  {
    const document = result.getFoundDocument(0); // Getting the first found document
    const outputAdapter = new groupdocs.search.StructureOutputAdapter(groupdocs.search.OutputFormat.PlainText); // Creating the output adapter
    const highlighter = new groupdocs.search.DocumentHighlighter(outputAdapter); // Creating the highlighter instance
    const options = new groupdocs.search.HighlightOptions(); // Creating the highlight options
    options.setTermHighlightStartTag('<Term>'); // Setting the start tag for the found word
    options.setTermHighlightEndTag('</Term>'); // Setting the end tag for the found word
    index.highlight(document, highlighter, options); // Generating plain text with highlighted occurrences

    const fields = outputAdapter.getResult();
    console.log(document.toString());
    for (const field of fields) {
      // Printing field names of the found document
      console.log('\t' + field.getName());
    }
  }
}
```

## Hit highlighting in text fragments

Occurrences can also be highlighted in separate HTML or plain text fragments. For this, the highlighter of the [FragmentHighlighter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.highlighters/FragmentHighlighter) class is used. The following parameters are presented in the [HighlightOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions) class to use with the highlighter of this type:

*   [setTermsBefore](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setTermsBefore(int)) method is used to specify the maximum number of words in a text fragment before highlighted word. The value must be in the range from 0 to 10000. The default value is 7.
*   [setTermsAfter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setTermsAfter(int)) method is used to specify the maximum number of words in a text fragment after highlighted word. The value must be in the range from 0 to 10000. The default value is 7.
*   [setTermsTotal](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setTermsTotal(int)) is used to specify the maximum number of words in a text fragment. The value must be in the range from 0 to 10000. The default value is 21.
*   [TermHighlightStartTag](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setTermHighlightStartTag(java.lang.String)) is the start tag of the highlighting of the found word. This tag is used only when highlighting in plain text.
*   [TermHighlightEndTag](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/HighlightOptions#setTermHighlightEndTag(java.lang.String)) is the end tag of the highlighting of the found word. This tag is used only when highlighting in plain text.

Generated text fragments with highlighted occurrences can be used, for example, to generate web pages containing search results on a site.

The example below demonstrates how to highlight search results in separate text fragments.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index settings instance
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentFolder);

// Search for the word 'ipsum'
const result = index.search('ipsum');

// Assigning highlight options
const options = new groupdocs.search.HighlightOptions();
options.setTermsBefore(5);
options.setTermsAfter(5);
options.setTermsTotal(15);
options.setHighlightColor(new groupdocs.search.Color(127, 200, 255));
options.setUseInlineStyles(true);

// Highlighting found words in separate text fragments of a document
const document = result.getFoundDocument(0);
const highlighter = new groupdocs.search.FragmentHighlighter(groupdocs.search.OutputFormat.Html);
index.highlight(document, highlighter, options);

// Getting the result
let text = '';
const fragmentContainers = highlighter.getResult();
for (const container of fragmentContainers) {
  const fragments = container.getFragments();
  if (fragments.length > 0) {
    text += '\n<br>';
    text += container.getFieldName();
    text += '<br>\n';
    for (const fragment of fragments) {
      // Printing HTML markup to console
      text += fragment;
      text += '\n';
    }
  }
}
console.log(text);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## How to build in docker Alpine Linux

Path: /conversion/net/build-in-docker-alpine-linux/


## Build web API project with GroupDocs.Conversion in Docker

To build an web API which is using GroupDocs.Conversion for .NET in docker container with Alpine Linux use this sample Docker file:

```docker
FROM mcr.microsoft.com/dotnet/aspnet:6.0-alpine AS base
WORKDIR /app
EXPOSE 80
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

RUN apk add --no-cache icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib
RUN apk add --no-cache ffmpeg libgdiplus

RUN apk add --no-cache msttcorefonts-installer fontconfig
RUN update-ms-fonts && fc-cache fc-cache -f

FROM mcr.microsoft.com/dotnet/sdk:6.0-alpine AS build
WORKDIR /src
COPY ["YourApi/YourApi.csproj", "TestApi/"]
RUN dotnet restore "YourApi/YourApi.csproj"
COPY . .
WORKDIR "/src/YourApi"
RUN dotnet build "YourApi.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "YourApi.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "YourApi.dll"]
```

As you can see the process is the same as building a regular web API project in docker. The main difference is the installation of needed libraries which allows GroupDocs.Conversion for .NET to work properly in a docker container:

```docker
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

RUN apk add --no-cache icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib
RUN apk add --no-cache ffmpeg libgdiplus

RUN apk add --no-cache msttcorefonts-installer fontconfig
RUN update-ms-fonts && fc-cache fc-cache -f
```

Also please do not forget to add runtimeconfig.template.json file next to your project file with the following content:

```json
{
    "configProperties": {
        "System.Drawing.EnableUnixSupport": true
    }
}
```

This will prevent exception "The type initializer for `gdip` throws exception". To learn more about this [read here](https://docs.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only).
---

## How to merge images to JPEG using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-images-to-jpeg-using-csharp/


## JPEG Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple image documents in the preferred order and save them as a single JPEG file.

## About JPEG File Format

JPEG is a type of image format that is saved using the method of lossy compression. The output image, as result of compression, is a trade-off between storage size and image quality. Users can adjust the compression level to achieve the desired quality level while at the same time reduce the storage size. Image quality is negligibly affected if 10:1 compression is applied to the image. The higher the compression value, the higher the degradation in image quality.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### Source images

!["Sample1.jpg"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/net/images/jpg/sample3.jpg)

### How to merge images to JPEG file

The following example demonstrates how to merge images to JPEG file with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinmode) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```csharp
// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.jpeg"))
{
    // Define image join options with horizontal join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
    // Add another image file to merge
    merger.Join(@"c:\sample2.png", joinOptions);
    // Define image join options with vertical join mode
    joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
    // Add next image file to merge
    merger.Join(@"c:\sample3.bmp", joinOptions);
    // Merge image files and save result
    merger.Save(@"c:\merged.jpeg");
}
```

### Result merged JPEG image

!["Merged.jpeg"](/merger/net/images/jpg/merged_grid.jpg)

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge JPEG Live Demo

GroupDocs.Merger for .NET provides an online [**Image to JPEG Merger App**](https://products.groupdocs.app/merger/image-to-jpeg), which allows you to try it for free and check its quality and accuracy.
---

## How to merge images to JPEG using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-images-to-jpeg-using-java/


## JPEG Merger .NET API

[com.groupdocs.merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple image documents in the preferred order and save them as a single JPEG file.

## About JPEG File Format

JPEG is a type of image format that is saved using the method of lossy compression. The output image, as result of compression, is a trade-off between storage size and image quality. Users can adjust the compression level to achieve the desired quality level while at the same time reduce the storage size. Image quality is negligibly affected if 10:1 compression is applied to the image. The higher the compression value, the higher the degradation in image quality.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/java) to download API jar package and add it to the .pom file. :
```java
<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>23.2</version>
</dependency>
```

### Source images

!["Sample1.jpg"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/net/images/jpg/sample3.jpg)

### How to merge images to JPEG file

The following example demonstrates how to merge images to JPEG file with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinoptions/) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinmode/) as a constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#Merger-java.io.InputStream-) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/imagejoinoptions/) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged image file as parameter.

```java
// Load the source image file
Merger merger = new Merger("c:\sample1.jpeg")
{
    // Define image join options with horizontal join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Horizontal);
    // Add another image file to merge
    merger.join("c:\sample2.png", joinOptions);
    // Define image join options with vertical join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
    // Add next image file to merge
    merger.join("c:\sample3.bmp", joinOptions);
    // Merge image files and save result
    merger.save("c:\merged.jpeg");
}
```

### Result merged JPEG image

!["Merged.jpeg"](/merger/net/images/jpg/merged_grid.jpg)

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge JPEG Live Demo

GroupDocs.Merger for Java provides an online [**Image to JPEG Merger App**](https://products.groupdocs.app/merger/image-to-jpeg), which allows you to try it for free and check its quality and accuracy.
---

## How to merge source code files

Path: /comparison/java/how-to-merge-source-code-files/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to merge source code files by using the [ComparisonAction](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction/) properties:

- [ComparisonAction.ACCEPT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction/#ACCEPT) accepts the found changes and adds them to the file without highlighting
- [ComparisonAction.REJECT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction/#REJECT) rejects the found changes and removes them from the output file

To apply/reject changes to output file, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method.
4.  Call the [getChanges()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#getChanges--) method to get changes list.
5.  Call the [setComparisonAction()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/changeinfo/#setComparisonAction-com.groupdocs.comparison.result.ComparisonAction-) method of the appropriate change object. Specify the [ComparisonAction.ACCEPT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction#ACCEPT) or the [ComparisonAction.REJECT](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction#REJECT) value.
6.  Call the [applyChanges()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#applyChanges-java.lang.String-com.groupdocs.comparison.options.save.SaveOptions-com.groupdocs.comparison.options.ApplyChangeOptions-) method. Specify the collection of changes.

For example, you need to compare and merge several versions of source code files and to accept or discard changes made by different persons.

![](/comparison/java/images/how-to-merge-source-code-file-source.png)
![](/comparison/java/images/how-to-merge-source-code-file-target.png)

The differences show that two methods are in the **source.cs** file: `AddNumbers` and `Sum`.

If you do not use the [ComparisonAction](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction/) property, all changes are committed to the output file, and these methods are removed. If you need to control the merging of files, the [ComparisonAction](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/comparisonaction/) property helps you.

The following code snippet shows how to merge two source code files:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.ApplyChangeOptions;
import com.groupdocs.comparison.result.ChangeInfo;
import com.groupdocs.comparison.result.ComparisonAction;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    final Path resultPath = comparer.compare("result.docx");

    ChangeInfo[] changes = comparer.getChanges();
    for (int i = 0; i < 10; i++) {
        changes[i].setComparisonAction(ComparisonAction.ACCEPT);
    }

    for (int i = 10; i < changes.length; i++) {
    	changes[i].setComparisonAction(ComparisonAction.REJECT);
    }

    comparer.applyChanges(resultPath, new ApplyChangeOptions(changes));
}
```
{{< /tab >}}
{{< /tabs >}}


As a result, you get a merged source code file where the deleted elements are marked in <font color="red">**red**</font>, the added – in <font color="blue">**blue**</font>, and the modified – in <font color="green">**green**</font>.

Also you  receive an HTML file in HTML  with changed places in the code.

| Result source code file                                                 | Result HTML file                                                          |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| ![](/comparison/java/images/how-to-merge-source-code-file-result-CS.png) | ![](/comparison/java/images/how-to-merge-source-code-file-result-HTML.png) |

As you can see from the resulting files, only one of the two methods was removed.

---

## How to merge source code files

Path: /comparison/net/how-to-merge-source-code-files/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to merge source code files by using the [ComparisonAction](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/changeinfo/properties/comparisonaction) properties:

- [ComparisonAction.Accept](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/comparisonaction) accepts the found changes and adds them to the file without highlighting
- [ComparisonAction.Reject](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/comparisonaction) rejects the found changes and removes them from the output file

To apply/reject changes to output file, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Call the [Compare](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/compare/index) method.
4.  Call the [GetChanges](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/getchanges/index) method to get changes list.
5.  Set the [ComparisonAction](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.result/changeinfo/properties/comparisonaction) of the appropriate change object to the [ComparisonAction.Accept](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.result/comparisonaction) or [ComparisonAction.Reject](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.result/comparisonaction) value;
6.  Call the [ApplyChanges](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/applychanges/index) method. Specify the collection of changes.

For example, you need to compare and merge several versions of source code files and to accept or discard changes made by different persons.

![](/comparison/net/images/how-to-merge-source-code-file-source.png)
![](/comparison/net/images/how-to-merge-source-code-file-target.png)

The differences show that two methods are in the **source.cs** file: `AddNumbers` and `Sum`.

If you do not use the [ComparisonAction](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/changeinfo/properties/comparisonaction) property, all changes are committed to the output file, and these methods are removed. If you need to control the merging of files, the [ComparisonAction](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.result/changeinfo/properties/comparisonaction) property helps you.

The following code snippet shows how to merge two source code files:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Result;
using GroupDocs.Comparison.Options;
using System.IO;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    comparer.Compare("result.docx");

    ChangeInfo[] changes = comparer.GetChanges();
    for (int i = 0; i < 10; i++)
    {
        changes[i].ComparisonAction = ComparisonAction.Accept;
    }

    for (int i = 10; i < changes.Length; i++)
    {
    	changes[i].ComparisonAction = ComparisonAction.Reject;
    }

    comparer.ApplyChanges(File.Create("result.docx"), new ApplyChangeOptions { Changes = changes });
}
```
{{< /tab >}}
{{< /tabs >}}


As a result, you get a merged source code file where the deleted elements are marked in <font color="red">**red**</font>, the added – in <font color="blue">**blue**</font>, and the modified – in <font color="green">**green**</font>.

Also you  receive an HTML file in HTML  with changed places in the code.

| Result source code file                                                 | Result HTML file                                                          |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| ![](/comparison/net/images/how-to-merge-source-code-file-result-CS.png) | ![](/comparison/net/images/how-to-merge-source-code-file-result-HTML.png) |

As you can see from the resulting files, only one of the two methods was removed.

---

## How to merge source code files

Path: /comparison/nodejs-java/how-to-merge-source-code-files/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to merge source code files by using the `ComparisonAction` properties:

- `ComparisonAction.ACCEPT` accepts the found changes and adds them to the file without highlighting
- `ComparisonAction.REJECT` rejects the found changes and removes them from the output file

For example, you need to compare and merge several versions of source code files and accept or discard changes made by different persons.

![](/comparison/nodejs-java/images/how-to-merge-source-code-file-source.png)
![](/comparison/nodejs-java/images/how-to-merge-source-code-file-target.png)

The differences show that the two methods are in the **source.cs** file: `AddNumbers` and `Sum`.

If you do not use the `ComparisonAction` property, all changes are committed to the output file, and these methods are removed. If you need to control the merging of files, the `ComparisonAction` property helps you.

The following code snippet shows how to merge two source code files:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');
const java = require('java');

// Define file paths for source, target, and output documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

// Initialize comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to be compared against the source
comparer.add(targetPath);

// Execute the comparison operation
comparer.compare(outputPath);

// Retrieve the list of detected changes
const changes = comparer.getChanges();

// Accept the first 10 changes (or fewer if less than 10 exist)
for (let i = 0; i < 10 && i < changes.length; i++) {
    changes[i].setComparisonAction(groupdocs.ComparisonAction.ACCEPT);
}

// Reject the remaining changes
for (let i = 10; i < changes.length; i++) {
    changes[i].setComparisonAction(groupdocs.ComparisonAction.REJECT);
}

// Prepare options for applying changes
// Convert JavaScript array to Java array
const changeArray = java.newArray('com.groupdocs.comparison.result.ChangeInfo', changes);
const applyChangeOptions = new groupdocs.ApplyChangeOptions();
applyChangeOptions.setChanges(changeArray);

// Apply the changes to the source document and save the result
comparer.applyChanges(outputPath, applyChangeOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance, adds the target document, and performs the comparison. It then retrieves all detected changes and selectively accepts the first 10 changes while rejecting the rest. The changes are converted to a Java array and wrapped in an `ApplyChangeOptions` object, which is then used with `applyChanges()` to generate the final merged document. This approach allows fine-grained control over which changes are included in the final result.

As a result, you get a merged source code file where the deleted elements are marked in <font color="red">**red**</font>, the added – in <font color="blue">**blue**</font>, and the modified – in <font color="green">**green**</font>.

Also, you receive an HTML file with changed places in the code.

| Result source code file                                                 | Result HTML file                                                          |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| ![](/comparison/nodejs-java/images/how-to-merge-source-code-file-result-CS.png) | ![](/comparison/nodejs-java/images/how-to-merge-source-code-file-result-HTML.png) |

As you can see from the resulting files, only one of the two methods was removed.

---

## How to merge source code files

Path: /comparison/python-net/how-to-merge-source-code-files/


GroupDocs.Comparison allows you to merge source code files by using the `ComparisonAction`property:

- `ComparisonAction.Accept` accepts the found changes and adds them to the file without highlighting
- `ComparisonAction.Reject` rejects the found changes and removes them from the output file

---

## Steps to apply or reject changes

1. Instantiate the `Comparer` object. Specify the source document path or stream.  
2. Call the `add` method. Specify the target document path or stream.  
3. Call the `compare` method.  
4. Call the `get_changes`) method to get the list of changes.  
5. Set the `comparison_action` property of the appropriate change object to either `ComparisonAction.ACCEPT` or `ComparisonAction.REJECT`.  
6. Call the `apply_changes` method. Pass the collection of changes to apply.  

---

## Example scenario

You need to compare and merge several versions of source code files and selectively accept or discard changes made by different authors.

**Before comparison:**  
![Source file](/comparison/python-net/images/how-to-merge-source-code-file-source.png)  
![Target file](/comparison/python-net/images/how-to-merge-source-code-file-target.png)

The differences show that two methods are in the **source.cs** file: `AddNumbers` and `Sum`.

If you do not use the `comparison_action` property, all changes are automatically applied to the output file, and these methods are removed. If you need to control the merging process, the `comparison_action` property helps you do that.

---

## Python example: merge two source code files

```python
import groupdocs.comparison as gc
from groupdocs.comparison.result import ComparisonAction
from groupdocs.comparison.options import ApplyChangeOptions

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    comparer.compare("result.docx")

    changes = comparer.get_changes()

    # Accept first 10 changes
    for i in range(min(10, len(changes))):
        changes[i].comparison_action = ComparisonAction.ACCEPT

    # Reject the rest
    for i in range(10, len(changes)):
        changes[i].comparison_action = ComparisonAction.REJECT

    options = ApplyChangeOptions()
    options.changes = changes
    with open("result.docx", "wb") as result_file:
        comparer.apply_changes(result_file, options)
```

---

## Result

As a result, you get a merged source code file where:  
- Deleted elements are marked in **red**
- Added elements are marked in **blue**
- Modified elements are marked in **green**

Also, you receive an HTML file that highlights all the changed places in the code.

| Result source code file                                                 | Result HTML file                                                          |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| ![](/comparison/python-net/images/how-to-merge-source-code-file-result-CS.png) | ![](/comparison/python-net/images/how-to-merge-source-code-file-result-HTML.png) |

As you can see from the resulting files, only one of the two methods was removed.

---

## How to Run Examples

Path: /merger/java/how-to-run-examples/

{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Merger has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Merger examples, by building your own or using our back-end or front-end examples out-of-the-box.

Please choose one from the following list:

## Download from GitHub

The complete examples package of **GroupDocs.Merger** is hosted on [Github](https://github.com/groupdocs-merger/GroupDocs.Merger-for-Java). You can either download the ZIP file or clone the repository of Github using your favorite Github client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/merger/java/images/how-to-run-examples.png)

Open Eclipse (or IntelliJ) and import the project to get started with it. Archived project file can also be imported.Follow the given steps to run the application:

* Go to project properties.
* Click on Java Build Path.
* Go to Libraries and external Jars (GroupDocs.Merger.jar).

![](/merger/java/images/how-to-run-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## Index Browser

Path: /search/java/index-browser/

## Index Browser

Index Browser is a .NET (Framework and Core) application for managing indexes created using the GroupDocs.Search library.

The Index Browser allows you:

- Create and delete indexes.
- Add documents to opened index.
- Search opened index and view the results.
- View the contents of indexed documents.

The Index Browser project is available on GitHub:

[https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/tree/master/Demos/IndexBrowser](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/tree/master/Demos/IndexBrowser)

After launching the Index Browser application, click the **Set license** button and select the license file to work with the GroupDocs.Search for .NET library.

<img src="/search/net/images/set-license.png" alt="set-license" width="656"/>

To create an index, click the **Create index** button.

<img src="/search/net/images/create-index.png" alt="create-index" width="656"/>

Enter the index location directory on the disk in the field **Index folder**. Enter the index name (to be displayed in the list). Click the **Create** button.

<img src="/search/net/images/create.png" alt="create" width="656"/>

To unload the index from memory, click the **Close index** button in the upper right corner of the application window.

<img src="/search/net/images/close-index.png" alt="close-index" width="656"/>

To open an index, select the desired index in the list and click the **Load index** button. A window for working with the index will open.

<img src="/search/net/images/load-index.png" alt="load-index" width="656"/>

To add documents to the index, open the **Operations** tab. Click the **Add directory** or **Add files** button to select a folder or file, respectively.

<img src="/search/net/images/add-files.png" alt="add-files" width="656"/>

The added paths to files or folders will appear in the **Selected paths** list. Click the **Start indexing** button and wait for the indexing process to complete.

<img src="/search/net/images/start-indexing.png" alt="start-indexing" width="656"/>

To search the index, open the **Search** tab. Enter your search query in the **Query** field. Below the query field, specify the search options you require. Press the **Search** button or the Enter key on your keyboard. A list of found files will be displayed on the left side of the window. Please note that to search for a phrase, you must enclose the query in double quotes. For more information about the search query language, see the article [Search operation table](https://docs.groupdocs.com/search/java/search-operation-table/).

<img src="/search/net/images/search.png" alt="search" width="656"/>

To navigate through the found documents, select the file you are interested in by clicking on it in the list. The text of the document will be displayed on the right side of the window. The arrow buttons allow you to move in the text from one found occurrence to another.

<img src="/search/net/images/arrow-buttons.png" alt="arrow-buttons" width="656"/>

---

## Index Browser

Path: /search/net/index-browser/

## Index Browser

Index Browser is a .NET (Framework and Core) application for managing indexes created using the GroupDocs.Search library.

The Index Browser allows you:

- Create and delete indexes.
- Add documents to opened index.
- Search opened index and view the results.
- View the contents of indexed documents.

The Index Browser project is available on GitHub:

[https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/tree/master/Demos/IndexBrowser](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/tree/master/Demos/IndexBrowser)

After launching the Index Browser application, click the **Set license** button and select the license file to work with the GroupDocs.Search for .NET library.

<img src="/search/net/images/set-license.png" alt="set-license" width="656"/>

To create an index, click the **Create index** button.

<img src="/search/net/images/create-index.png" alt="create-index" width="656"/>

Enter the index location directory on the disk in the field **Index folder**. Enter the index name (to be displayed in the list). Click the **Create** button.

<img src="/search/net/images/create.png" alt="create" width="656"/>

To unload the index from memory, click the **Close index** button in the upper right corner of the application window.

<img src="/search/net/images/close-index.png" alt="close-index" width="656"/>

To open an index, select the desired index in the list and click the **Load index** button. A window for working with the index will open.

<img src="/search/net/images/load-index.png" alt="load-index" width="656"/>

To add documents to the index, open the **Operations** tab. Click the **Add directory** or **Add files** button to select a folder or file, respectively.

<img src="/search/net/images/add-files.png" alt="add-files" width="656"/>

The added paths to files or folders will appear in the **Selected paths** list. Click the **Start indexing** button and wait for the indexing process to complete.

<img src="/search/net/images/start-indexing.png" alt="start-indexing" width="656"/>

To search the index, open the **Search** tab. Enter your search query in the **Query** field. Below the query field, specify the search options you require. Press the **Search** button or the Enter key on your keyboard. A list of found files will be displayed on the left side of the window. Please note that to search for a phrase, you must enclose the query in double quotes. For more information about the search query language, see the article [Search operation table](https://docs.groupdocs.com/search/net/search-operation-table/).

<img src="/search/net/images/search.png" alt="search" width="656"/>

To navigate through the found documents, select the file you are interested in by clicking on it in the list. The text of the document will be displayed on the right side of the window. The arrow buttons allow you to move in the text from one found occurrence to another.

<img src="/search/net/images/arrow-buttons.png" alt="arrow-buttons" width="656"/>

---

## Index Browser

Path: /search/nodejs-java/index-browser/

## Index Browser

Index Browser is a .NET (Framework and Core) application for managing indexes created using the GroupDocs.Search library.

The Index Browser allows you:

- Create and delete indexes.
- Add documents to opened index.
- Search opened index and view the results.
- View the contents of indexed documents.

The Index Browser project is available on GitHub:

[https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/tree/master/Demos/IndexBrowser](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/tree/master/Demos/IndexBrowser)

After launching the Index Browser application, click the **Set license** button and select the license file to work with the GroupDocs.Search for .NET library.

<img src="/search/net/images/set-license.png" alt="set-license" width="656"/>

To create an index, click the **Create index** button.

<img src="/search/net/images/create-index.png" alt="create-index" width="656"/>

Enter the index location directory on the disk in the field **Index folder**. Enter the index name (to be displayed in the list). Click the **Create** button.

<img src="/search/net/images/create.png" alt="create" width="656"/>

To unload the index from memory, click the **Close index** button in the upper right corner of the application window.

<img src="/search/net/images/close-index.png" alt="close-index" width="656"/>

To open an index, select the desired index in the list and click the **Load index** button. A window for working with the index will open.

<img src="/search/net/images/load-index.png" alt="load-index" width="656"/>

To add documents to the index, open the **Operations** tab. Click the **Add directory** or **Add files** button to select a folder or file, respectively.

<img src="/search/net/images/add-files.png" alt="add-files" width="656"/>

The added paths to files or folders will appear in the **Selected paths** list. Click the **Start indexing** button and wait for the indexing process to complete.

<img src="/search/net/images/start-indexing.png" alt="start-indexing" width="656"/>

To search the index, open the **Search** tab. Enter your search query in the **Query** field. Below the query field, specify the search options you require. Press the **Search** button or the Enter key on your keyboard. A list of found files will be displayed on the left side of the window. Please note that to search for a phrase, you must enclose the query in double quotes. For more information about the search query language, see the article [Search operation table](https://docs.groupdocs.com/search/nodejs-java/search-operation-table/).

<img src="/search/net/images/search.png" alt="search" width="656"/>

To navigate through the found documents, select the file you are interested in by clicking on it in the list. The text of the document will be displayed on the right side of the window. The arrow buttons allow you to move in the text from one found occurrence to another.

<img src="/search/net/images/arrow-buttons.png" alt="arrow-buttons" width="656"/>

---

## Inserting Chart Axis Title Dynamically in Presentation Document

Path: /assembly/java/inserting-chart-axis-title-dynamically-in-presentation-document/

{{< alert style="info" >}}This feature is supported by version 18.1 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Column Chart in Microsoft PowerPoint Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS PowerPoint 2013:

1.  Create a new presentation slide
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialogue box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
5.  Edit the Worksheet with your data to update the chart
6.  Save your Document

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must show quantity of sales/orders
*   Sales/orders quantity must be represented by Quarters
*   It must associate order quantity with the corresponding customer
*   Report must be generated in the Presentation Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
Total Contract Prices by Quarters<<foreach [in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x [key.getName()]>>
```

#### Chart Data (Excel)

<table border="1" cellspacing="0" cellpadding="0" width="710" style="width: 532.45pt; margin-left: 15.75pt; border-collapse: collapse; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"><tbody><tr><td width="98" valign="top" style="width: 73.65pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;">&nbsp;</p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">1st Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 0 &amp;&amp; c.getDate().getMonth() &lt;= 2).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">2nd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 3 &amp;&amp; c.getDate().getMonth() &lt;= 5).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">3rd Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 6 &amp;&amp; c.getDate().getMonth() &lt;= 8).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: windowtext; border-top-style: solid; border-top-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: initial; border-left-style: none; border-left-width: initial; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">4th Quarter&lt;&lt;y [where(c =&gt; c.getDate().getMonth() &gt;= 9 &amp;&amp; c.getDate().getMonth() &lt;= 11).sum(c =&gt; c.getPrice())]&gt;&gt;</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 1</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">1.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">3</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td></tr><tr><td width="98" valign="bottom" style="width: 73.65pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-left-color: windowtext; border-left-style: solid; border-left-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p style="margin-bottom: 0.0001pt; line-height: normal;"><span style="color: black;">Category 4</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">4.5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2.8</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">5</span></p></td><td width="153" valign="bottom" style="width: 114.7pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial; border-bottom-color: windowtext; border-bottom-style: solid; border-bottom-width: 1pt; border-right-color: windowtext; border-right-style: solid; border-right-width: 1pt; padding-top: 0in; padding-right: 5.4pt; padding-bottom: 0in; padding-left: 5.4pt;"><p align="right" style="margin-bottom: 0.0001pt; text-align: right; line-height: normal;"><span style="color: black;">2</span></p></td></tr></tbody></table>
### Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_Dynamic_Title.pptx) (Template for CustomObject and JSON examples) 

### Generating The Report

{{< gist GroupDocsGists 75f94ab726de5feb2bd2d30cb369a001 >}}



---

## Inserting Chart Axis Title Dynamically in Presentation Document

Path: /assembly/net/inserting-chart-axis-title-dynamically-in-presentation-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 18.1 or greater.{{< /alert >}}

## Column Chart in Microsoft PowerPoint Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS PowerPoint 2013:

1.  Create a new presentation slide
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialogue box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your document
5.  Edit the Worksheet with your data to update the chart
6.  Save your Document

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   Report must show quantity of sales/orders
*   Sales/orders quantity must be represented by Quarters
*   It must associate order quantity with the corresponding customer
*   Report must be generated in the Presentation Document

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<<[title]>>foreach [in orders.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>>
<<x [Key.CustomerName]>>
```

#### Chart Data (Excel)

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1st Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 1 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 3).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2nd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 4 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 6).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3rd Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 7 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 9).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4th Quarter&lt;&lt;y [Where(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &gt;= 10 &amp;&amp; </span><span style="font-family: Calibri; font-size: 11pt;">c.Date.Month</span><span style="font-family: Calibri; font-size: 11pt;"> &lt;= 12).Sum(c =&gt; </span><span style="font-family: Calibri; font-size: 11pt;">c.ProductQuantity</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 1</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">1.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">3</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td></tr><tr style="height: 15pt;"><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 1.75pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">Category 4</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 104.9pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">4.5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 108.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2.8</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 99.6pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">5</span></p></td><td style="border-bottom-color: rgb(0, 0, 0); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(0, 0, 0); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(0, 0, 0); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(0, 0, 0); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 100.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">2</span></p></td></tr></tbody></table>
### Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_Dynamic_Title.pptx) (Template for CustomObject and JSON examples) 

### Generating The Report

{{< gist GroupDocsGists 8e05be1d16986e473ccd928dfc28c10a >}}



---

## Installation

Path: /merger/net/installation/

## Install from Nuget

NuGet is the easiest way to download and install GroupDocs.Merger for .NET. There are ways to install it in your project.

### Install via Package Manager GUI

Follow these steps to reference GroupDocs.Merger using Package Manager GUI:

* Open your solution/project in Visual Studio.
* Click **Tools** -> **NuGet Package Manager** -> **Manage NuGet Packages for Solution**. You can also access the same option through the Solution Explorer. Right-click the solution or project and select Manage NuGet Packages from the context menu.
* Select **Browse** tab and type "GroupDocs.Merger" in the search text box.
* Click the **Install** button to install the latest version of the API into your project as shown in the following screenshot.  
![](/merger/net/images/installation.png)

### Using Package Manager Console

You can follow the steps below to reference GroupDocs.Merger for .NET using the Package Manager Console:

* Open your solution/project in Visual Studio.
* Select **Tools** -> **NuGet Package Manager** -> **Package Manager Console** from the menu to open package manager console.
* Type the command "Install-Package GroupDocs.Merger" and press enter to install the latest release into your application.
* After successful installation, GroupDocs.Merger will be referenced in your application.  
![](/merger/net/images/installation_1.png)

## Install from official GroupDocs website

You can follow the steps below to reference GroupDocs.Merger for .NET downloaded from official website [Downloads section](https://downloads.groupdocs.com/merger/net):

1. Unpack zip archive or follow MSI install wizard instructions.
2. In the Solution Explorer, expand the project node you want to add a reference to.
3. Right-click the **References** node for the project and select **Add Reference** from the menu.
4. In the Add Reference dialog box, select the **.NET** tab (it's usually selected by default).
5. If you have used MSI installer to install GroupDocs.Merger, you will see GroupDocs.Merger in the top pane. Select it and then click the **Select** button.
6. If you have downloaded and unpacked the DLL only, click the **Browse** button and locate the GroupDocs.Merger.dll file.
    You have referenced GroupDocs.Merger and it should appear in the **SelectedComponents** pane of the dialog box.
7. Click **OK**.
    GroupDocs.Merger reference appears under the **References** node of the project.

---

## Load Presentation document with options

Path: /conversion/net/load-presentation-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [PresentationLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions) to give you control over how Microsoft PowerPoint or Open Document presentation will be converted into the target format. The following options could be set:
| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/format)** | The document type is auto-detected during loading, however, you can specify explicitly the type of the source presentation document. Available options are: *Ppt, Pps, Pptx, Ppsx, Odp, Otp, Potx, Pot, Potm, Pptm, Ppsm* |
|**[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/defaultfont)** | A default font for rendering the presentation. The following font will be used if a presentation font is missing. |
|**[FontSubstitutes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/fontsubstitutes)** | Substitute specific fonts from the source presentation document. |
|**[HideComments](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/hidecomments)** | Specifies that comments from source presentation must be hidden during conversion |
|**[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/password)** | A password to unlock the protected document |
|**[ShowHiddenSlides](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/showhiddenslides)** | Specifies that hidden slides should be included in the converted document |
|**[SkipExternalResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/skipexternalresources)** |  If enabled, the external resources (except for those listed in `WhitelistedResources`) will not be loaded during the conversion. |
|**[WhitelistedResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/whitelistedresources)** | Specifies which external resources will be loaded even when the loading of other external resources is restricted. |

## Hide comments

Like many other Microsoft Office applications PowerPoint provides the "Comments" feature to simplify the presentation review. By default, the Comments pane will be present in a converted document. If you want to hide comments, set the [HideComments](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/hidecomments) property to *true* as shown in a code snippet below:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PresentationLoadOptions
{
    HideComments = true
};
using (Converter converter = new Converter("sample.pptx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Specify font substitutions

Original PowerPoint presentations may use some specific and non-standard fonts for text formatting that are not available at the time of conversion. GroupDocs.Conversion for .NET allows you to provide substitutions for missing fonts by setting the [FontSubstitues](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/fontsubstitutes) collection with original/substitute font pairs.

The following code snippet shows how to convert a PPTX presentation and specify substitutions for missing fonts:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PresentationLoadOptions
{
    DefaultFont = "Helvetica",
    FontSubstitutes = new List<FontSubstitute>
    {
       FontSubstitute.Create("Tahoma", "Arial"),
       FontSubstitute.Create("Times New Roman", "Arial"),
    }
};
using (Converter converter = new Converter("sample.pptx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Include hidden slides

Just like you can show or hide slides in a Microsoft PowerPoint presentation manually, GroupDocs.Conversion for .NET allows displaying of the hidden slides in the converted document programmatically (by default all hidden slides are excluded from the converted document). You just have to set the [ShowHiddenSlides](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/presentationloadoptions/showhiddenslides) property to *true*.

The following code snippet shows how to convert a PPTX presentation including the hidden slides:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PresentationLoadOptions
{
    ShowHiddenSlides = true
};
using (Converter converter = new Converter("sample.pptx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Skip loading of external resources

In the context of presentations, external resources typically refer to elements or materials that are not directly embedded within the presentation file itself but are instead referenced or linked to enhance the presentation's content or functionality. These external resources can include various types of content and tools that complement the presentation. Common external resources include images, audio, video, fonts, styles, data sources, and so on. 

In some cases, you may want to skip loading all or just some of the external resources during the conversion. For example, when these resources become unavailable. Read the [Skip loading of external resources]({{< ref "conversion/net/developer-guide/advanced-usage/loading/skip-external-resources.md" >}}) article to learn how to do this with **GroupDocs.Conversion for .NET** 
---

## Load TXT document with options

Path: /conversion/java/load-txt-document-with-options/

GroupDocs.Conversion provides the [TxtLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/TxtLoadOptions) class to give you better control over how the source text document will be processed. The following options could be set: 

*   **[setDetectNumberingWithWhitespaces](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/TxtLoadOptions#setDetectNumberingWithWhitespaces(boolean))** allows specifying how numbered list items are recognized when a plain-text document is converted. If this option is set to false, the lists recognition algorithm detects list paragraphs, when list numbers end with either dot, right bracket or bullet symbols (such as "•", "\*", "-" or "o"). If this option is set to true, the white spaces are also used as list number delimiters: the list recognition algorithm for Arabic style numbering (1., 1.1.2.) uses both white spaces and dot (".") symbols.
*   **[setLeadingSpacesOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/TxtLoadOptions#setLeadingSpacesOptions(com.groupdocs.conversion.options.load.TxtLeadingSpacesOptions))** specifies how leading spaces will be processed. The available options are: *ConvertToIdent, Preserve, Trim*.
*   **[setTrailingSpacesOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/TxtLoadOptions#setTrailingSpacesOptions(com.groupdocs.conversion.options.load.TxtTrailingSpacesOptions))** specifies how trailing spaces will be processed. The available options are: *Preserve, Trim*.
*   **[setEncoding](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/TxtLoadOptions#setEncoding(java.nio.charset.Charset))** specifies the encoding to be used to load the document.

### Control behavior of processing leading spaces

The following code snippet shows how to convert a TXT document and control the way the leading spaces are processed:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.TxtLeadingSpacesOptions;
import com.groupdocs.conversion.options.load.TxtLoadOptions;
...
TxtLoadOptions loadOptions =  new TxtLoadOptions();
loadOptions.setLeadingSpacesOptions(TxtLeadingSpacesOptions.ConvertToIndent);
loadOptions.setDetectNumberingWithWhitespaces(true);

Converter converter = new Converter("sample.txt", loadOptions);
PdfConvertOptions options = new PdfConvertOptions();
converter.convert("converted.pdf", options);
```

### Control behavior of processing trailing spaces

The following code snippet shows how to convert a TXT document and the way the trailing spaces are processed:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.TxtLoadOptions;
import com.groupdocs.conversion.options.load.TxtTrailingSpacesOptions;
...
TxtLoadOptions loadOptions =  new TxtLoadOptions();
loadOptions.setTrailingSpacesOptions(TxtTrailingSpacesOptions.Trim);

Converter converter = new Converter("sample.txt", loadOptions);
PdfConvertOptions options = new PdfConvertOptions();
converter.convert("converted.pdf", options);
```

### Specify encoding

The following code snippet shows how to convert a TXT document and specify the encoding:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.TxtLoadOptions;
import java.nio.charset.Charset;
...
TxtLoadOptions loadOptions =  new TxtLoadOptions();
loadOptions.setEncoding(Charset.forName("shift_jis"));

Converter converter = new Converter("sample.txt", loadOptions);
PdfConvertOptions options = new PdfConvertOptions();
converter.convert("converted.pdf", options);
```

---

## Load TXT document with options

Path: /conversion/nodejs-java/load-txt-document-with-options/

GroupDocs.Conversion provides [TxtLoadOptions](#) to give you control over how the source text document will be processed. The following options could be set: 

*   **[setDetectNumberingWithWhitespaces](#)** allows specifying how numbered list items are recognized when a plain-text document is converted. If this option is set to false, the lists recognition algorithm detects list paragraphs, when list numbers end with either dot, right bracket or bullet symbols (such as "•", "\*", "-" or "o"). If this option is set to true, the white spaces are also used as list number delimiters: the list recognition algorithm for Arabic style numbering (1., 1.1.2.) uses both white spaces and dot (".") symbols.
*   **[setLeadingSpacesOptions](#)** specifies how leading spaces will be processed. The available options are: *ConvertToIdent, Preserve, Trim*.
*   **[setTrailingSpacesOptions](#)** specifies how trailing spaces will be processed. The available options are: *Preserve, Trim*.
*   **[setEncoding](#)**  specifies the encoding to be used to load the document.

### Control behavior of processing leading spaces

The following code snippet shows how to convert a TXT document and control the way the leading spaces are processed:

```js
const loadOptions = new groupdocs.conversion.TxtLoadOptions()
loadOptions.setLeadingSpacesOptions(groupdocs.conversion.TxtLeadingSpacesOptions.ConvertToIndent);
loadOptions.setDetectNumberingWithWhitespaces(true);

const outputPath = "ConvertTxtByControllingLeadingSpacesBehavior.pdf"

const converter = new groupdocs.conversion.Converter("sample.txt", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`Txt document converted successfully to ${outputPath} (by controlling leading spaces behavior)`)
converter.convert(outputPath, convertOptions)
```

### Control behavior of processing trailing spaces

The following code snippet shows how to convert a TXT document and the way the trailing spaces are processed:

```js
const loadOptions = new groupdocs.conversion.TxtLoadOptions()
loadOptions.setTrailingSpacesOptions(groupdocs.conversion.TxtTrailingSpacesOptions.Trim);

const outputPath = "ConvertTxtByControllingTrailingSpacesBehavior.pdf"

const converter = new groupdocs.conversion.Converter("sample.txt", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`Txt document converted successfully to ${outputPath} (by controlling trailing spaces behavior)`)
converter.convert(outputPath, convertOptions)
```

### Specify encoding

The following code snippet shows how to convert a TXT document and specify the encoding:

```js
const loadOptions = new groupdocs.conversion.TxtLoadOptions()
loadOptions.setEncoding("Shift_JIS")

const outputPath = "ConvertTxtBySpecifyingEncoding.pdf"

const converter = new groupdocs.conversion.Converter("sample.txt", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`Txt document converted successfully to ${outputPath} (by specifying encoding)`)
converter.convert(outputPath, convertOptions)
```

---

## Locales for output document

Path: /editor/java/locales-for-output-document/

[WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class contains 3 very similar properties of the same type `java.util.Locale`:

```java
public java.util.Locale getLocale()
public void setLocale(java.util.Locale)

public java.util.Locale getLocaleBi()
public void setLocaleBi(java.util.Locale)

public java.util.Locale getLocaleFarEast()
public void setLocaleFarEast(java.util.Locale)
```

In most cases the output WordProcessing document, which is generated from the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance by the [`Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method, contains valid locales for the textual content. But in some cases it is necessary to forcibly and explicitly set a some specific locale for the output document. These three options provide such possibility. However keep in mind that they are suitable only when document should have some single locale. If document is multi-language and contains, for example, English and Spanish text, setting the locale to English ("en-GB", for example) will mark the Spanish text as English too, so spell checking in MS Word, for example, will not work properly for such text.

By default all these three locale-related properties are not specified, their values are NULL. In such case MS Word (or other program) will detect (or choose) the document locale according to its own settings or other factors. Additionally, if document is multi-language, it is strongly encouraged to enable the [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/#getEnableLanguageInformation--) property in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions) class while editing original document, and not to use these 3 properties.

The [`Locale`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getLocale--) property is intended to set the locale for usual left-to-right text, which consists of letters.  
The [`LocaleBi`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getLocaleBi--) property should be used when text is right-to-left (RTL), for example, [Arabic script](https://en.wikipedia.org/wiki/Arabic_script) or [Hebrew alphabet](https://en.wikipedia.org/wiki/Hebrew_alphabet).  
The [`LocaleFarEast`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getLocaleFarEast--) property should be used for East-Asian (Far-East) text, including [CJK characters](https://en.wikipedia.org/wiki/CJK_characters).

---

## Locales for output document

Path: /editor/net/locales-for-output-document/

[WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class contains 3 very similar properties of the same type `System.Globalization.CultureInfo`:

```csharp
public System.Globalization.CultureInfo Locale { get; set; }
public System.Globalization.CultureInfo LocaleBi { get; set; }
public System.Globalization.CultureInfo LocaleFarEast { get; set; }
```

In most cases the output WordProcessing document, which is generated from the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance by the [`editor.Save()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method, contains valid locales for the textual content. But in some cases it is necessary to forcibly and explicitly set a some specific locale for the output document. These three options provide such possibility. However keep in mind that they are suitable only when document should have some single locale. If document is multi-language and contains, for example, English and Spanish text, setting the locale to English ("en-GB", for example) will mark the Spanish text as English too, so spell checking in MS Word, for example, will not work properly for such text.

By default all these three locale-related properties are not specified, their values are NULL. In such case MS Word (or other program) will detect (or choose) the document locale according to its own settings or other factors. Additionally, if document is multi-language, it is strongly encouraged to enable the [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions/enablelanguageinformation) property in the [WordProcessingEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class while editing original document, and not to use these 3 properties.

The [`Locale`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/locale) property is intended to set the locale for usual left-to-right text, which consists of letters.  
The [`LocaleBi`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/localebi) property should be used when text is right-to-left (RTL), for example, [Arabic script](https://en.wikipedia.org/wiki/Arabic_script) or [Hebrew alphabet](https://en.wikipedia.org/wiki/Hebrew_alphabet).  
The [`LocaleFarEast`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/localefareast) property should be used for East-Asian (Far-East) text, including [CJK characters](https://en.wikipedia.org/wiki/CJK_characters).

---

## Locales for Output Document

Path: /editor/nodejs-java/locales-for-output-document/


The [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingSaveOptions) class contains three similar properties of the type `Locale`:

```javascript
// Getter and Setter for locale
public Locale getLocale()
public void setLocale(Locale value)

// Getter and Setter for localeBi
public Locale getLocaleBi()
public void setLocaleBi(Locale value)

// Getter and Setter for localeFarEast
public Locale getLocaleFarEast()
public void setLocaleFarEast(Locale value)
```

In most cases, the output WordProcessing document generated from the [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.EditableDocument) instance by the [`Editor.save()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#save(com.groupdocs.editor.EditableDocument,%20java.io.OutputStream,%20com.groupdocs.editor.options.ISaveOptions)) method contains valid locales for the textual content. However, in some scenarios, it is necessary to explicitly set a specific locale for the output document. These three options provide that capability. Keep in mind that they are suitable only when the document should have a single locale. If the document is multilingual and contains, for example, English and Spanish text, setting the locale to English ("en-GB") will mark the Spanish text as English too. As a result, spell checking in MS Word may not work properly for the Spanish text.

By default, all these three locale-related properties are not specified; their values are `null`. In such cases, MS Word (or other programs) will detect (or choose) the document locale according to their own settings or other factors. Additionally, if the document is multilingual, it is strongly recommended to enable the [`enableLanguageInformation`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingEditOptions#isEnableLanguageInformation()) property in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingEditOptions) class while editing the original document, and not to use these three properties.

- The [`locale`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingSaveOptions#getLocale()) property is intended to set the locale for standard left-to-right text, which consists of letters.
- The [`localeBi`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingSaveOptions#getLocaleBi()) property should be used when the text is right-to-left (RTL), for example, [Arabic script](https://en.wikipedia.org/wiki/Arabic_script) or [Hebrew alphabet](https://en.wikipedia.org/wiki/Hebrew_alphabet).
- The [`localeFarEast`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingSaveOptions#getLocaleFarEast()) property should be used for East Asian (Far East) text, including [CJK characters](https://en.wikipedia.org/wiki/CJK_characters).

## Example Usage

The following example demonstrates how to set the locale properties when saving a WordProcessing document:

```javascript
// Import necessary modules
const groupdocs_editor = require('groupdocs-editor');
const fs = require('fs');

// Load the source WordProcessing document
const editor = new groupdocs_editor.Editor('SampleDoc.docx');

// Create WordProcessingEditOptions and enable language information if needed
const editOptions = new groupdocs_editor.WordProcessingEditOptions();
editOptions.enableLanguageInformation = true;

// Edit the document to get an EditableDocument instance
const editableDocument = editor.edit(editOptions);

// Create WordProcessingSaveOptions
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions();

// Set the desired locale (e.g., English - United Kingdom)
saveOptions.locale = java.util.Locale.UK;

// For right-to-left languages (e.g., Arabic - Saudi Arabia)
// saveOptions.localeBi = new java.util.Locale("ar", "SA");

// For Far East languages (e.g., Japanese)
// saveOptions.localeFarEast = java.util.Locale.JAPANESE;

// Save the edited document with the specified locale settings
editor.save(editableDocument, 'OutputDoc.docx', saveOptions);

console.log('Document saved successfully with specified locale.');
```

**Note:**

- Replace `'SampleDoc.docx'` with the path to your source document.
- The `java.util.Locale` class is used to specify the locale. You can create a new locale by specifying the language and country codes.

## Important Considerations

- **Single Locale Documents:** These properties are suitable only when the document contains text in a single language. If your document is multilingual, using these properties might not yield the desired results.
- **Multilingual Documents:** For documents containing multiple languages, it's recommended to enable the `enableLanguageInformation` property in the `WordProcessingEditOptions` class and avoid setting the locale properties in `WordProcessingSaveOptions`.
  
  ```javascript
  const editOptions = new groupdocs_editor.WordProcessingEditOptions();
  editOptions.enableLanguageInformation = true;
  ```

- **Default Behavior:** If the locale properties are not set, their values are `null`, and the locale will be determined by MS Word or other programs based on their settings.

## Understanding the Locale Properties

- **`locale`:** Sets the locale for standard left-to-right text, such as English, French, or German.
- **`localeBi`:** Sets the locale for right-to-left (RTL) text, such as Arabic or Hebrew.
- **`localeFarEast`:** Sets the locale for East Asian languages, including Chinese, Japanese, and Korean.

## Specifying Locales

You can specify a locale using the `java.util.Locale` class. Here are some examples:

```javascript
// English (United Kingdom)
saveOptions.locale = java.util.Locale.UK;

// English (United States)
saveOptions.locale = java.util.Locale.US;

// Spanish (Spain)
saveOptions.locale = new java.util.Locale("es", "ES");

// Arabic (Saudi Arabia)
saveOptions.localeBi = new java.util.Locale("ar", "SA");

// Chinese (Simplified)
saveOptions.localeFarEast = java.util.Locale.SIMPLIFIED_CHINESE;

// Japanese
saveOptions.localeFarEast = java.util.Locale.JAPANESE;
```

## Conclusion

By setting the locale properties in `WordProcessingSaveOptions`, you can control the language settings of your output WordProcessing documents when using GroupDocs.Editor for Node.js via Java. This is particularly useful when dealing with documents in specific languages or scripts, such as RTL or East Asian languages.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.
---

## Merge text files

Path: /merger/java/merge/txt/


A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by sequence of characters.

## How to merge text files in Java

When it's required to organize several text files into one file it's possible to solve the task with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/java) only and no need to use any third-party software.

The workflow of combining files together is quite simple:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source TXT file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TXT file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other TXT documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged TXT file as parameter.

The following example demonstrates how to merge TXT files with several lines of java code:

```java
// Load the source TXT file
Merger merger = new Merger("c:\sample1.txt")

// Add another TXT file to merge
merger.join("c:\sample2.txt");
// Merge TXT files and save result
merger.save("c:\merged.txt");
```

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TXT Live Demo

GroupDocs.Merger for Java provides an online [**TXT Merger App**](https://products.groupdocs.app/merger/txt), which allows you to try it for free and check its quality and accuracy.

---

## Merge text files

Path: /merger/nodejs-java/merge/txt/


A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by sequence of characters.

## How to merge text files in Node.js via Java

When it's required to organize several text files into one file it's possible to solve the task with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) only and no need to use any third-party software.

The workflow of combining files together is quite simple:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source TXT file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TXT file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other TXT documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged TXT file as parameter.

The following example demonstrates how to merge TXT files with several lines of java code:

```js
const merger = new groupdocs.merger.Merger('c:/sample1.txt');
merger.join('c:/sample2.txt');
merger.save('c:/merged.txt');
```

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TXT Live Demo

GroupDocs.Merger for Node.js via Java provides an online [**TXT Merger App**](https://products.groupdocs.app/merger/txt), which allows you to try it for free and check its quality and accuracy.

---

## Merge text files

Path: /merger/python-net/merge/txt/


A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by sequence of characters.

## How to merge text files in Python via .NET

When it's required to organize several text files into one file it's possible to solve the task with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) only and no need to use any third-party software.

The workflow of combining files together is quite simple:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source TXT file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TXT file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other TXT documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged TXT file as parameter.

The following example demonstrates how to merge TXT files with several lines of net code:

```python
with gm.Merger("c:/sample1.txt") as merger:
    merger.join("c:/sample2.txt")
    merger.save("c:/merged.txt")
```

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TXT Live Demo

GroupDocs.Merger for Python via .NET provides an online [**TXT Merger App**](https://products.groupdocs.app/merger/txt), which allows you to try it for free and check its quality and accuracy.

---

## Put image annotations over the text using ZIndex

Path: /annotation/net/put-image-annotation-over-text/


GroupDocs.Annotation v21.5 and later allows you to specify images placing order for the Word file formats. To do this, set the [ZIndex](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation/properties/zindex) property of the [ImageAnnotation](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/imageannotation) class.

The following code snippets shows how to specify a `ZIndex` of the image annotation:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
ImageAnnotation area = new ImageAnnotation
{
    Box = new Rectangle(100, 100, 100, 100),
    Opacity = 0.7,
    PageNumber = 0,
    ImagePath = "www.google.com.ua/images/branding/googlelogo/2x/googlelogo_color_92x30dp.png",
    Angle = 100,
    ZIndex = 3
};
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="info" >}}The feature is supported for Words files only. Other formats ignore this property{{< /alert >}}


---

## Render EBooks as HTML, PDF, and image files

Path: /viewer/java/render-ebooks/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your EBooks (EPUB, MOBI) in HTML, PDF, PNG, and JPEG formats. You do not need to use any book reader to load and view EBooks within your Java application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a book you want to view to the class constructor. You can load the book from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the EBook to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/ebook" >}} {{< icon "gdoc_person" >}} View EBooks online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported EBooks file formats

GroupDocs.Viewer supports the following EBooks file formats:

* [EPUB](https://docs.fileformat.com/ebook/epub/) (.EPUB)
* [MOBI](https://docs.fileformat.com/ebook/mobi/) (.MOBI)

## Render EBooks as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an EBook file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("abook.epub")) {
    // Create an HTML files.
    // {0} is replaced with the current page number in the file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to HTML](/viewer/java/images/rendering-basics/render-ebooks/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("abook.epub")) {
   // Create an HTML file for each page.
   // Specify the HTML file names and location of external resources.
   // {0} and {1} are replaced with the current page number and resource name, respectively.
   HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-ebooks/render-to-html-external-resources.png)

## Render EBooks as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an EBook file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("abook.epub")) {
    // Create a PDF file for the document.
    // Specify the PDF file name.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to PDF](/viewer/java/images/rendering-basics/render-ebooks/render-to-pdf.png)

## Render EBooks as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an EBook file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("abook.epub")) {
    // Create a PNG image for each document page.
    // {0} is replaced with the current page number in the image name.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an EBook file to PNG](/viewer/java/images/rendering-basics/render-ebooks/render-to-png-image.png)

## Render EBooks as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an EBook file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("abook.epub")) {
    // Create a JPG image for each document page.
    // {0} is replaced with the current page number in the image name.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Render EBooks as HTML, PDF, and image files

Path: /viewer/net/render-ebooks/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your EBooks (EPUB, MOBI) in HTML, PDF, PNG, and JPEG formats. You do not need to use any book reader to load and view EBooks within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a book you want to view to the class constructor. You can load the book from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the EBook to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/ebook" >}} {{< icon "gdoc_person" >}} View EBookd online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported EBooks file formats

GroupDocs.Viewer supports the following EBooks file formats:

* [EPUB](https://docs.fileformat.com/ebook/epub/) (.EPUB)
* [MOBI](https://docs.fileformat.com/ebook/mobi/) (.MOBI)
* [AZW3](https://docs.fileformat.com/ebook/azw3/) (.AZW3)

GroupDocs.Viewer can detect the book format automatically based on information in the file header.

## Render EBooks as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an EBook file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("abook.epub"))
{
    // Create an HTML file for each document page.
    // {0} is replaced with the current page number in the file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("abook.epub")
            ' Create an HTML file for each document page.
            ' {0} is replaced with the current page number in the file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to HTML](/viewer/net/images/rendering-basics/render-ebooks/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("abook.epub"))
{
    // Create an HTML file for each document page.
    // Specify the HTML file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("abook.epub")
            ' Create an HTML file for each document page.
            ' Specify the HTML file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_ {1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-ebooks/render-to-html-external-resources.png)

## Render EBooks as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an EBook to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("abook.epub"))
{
    // Create a PDF file for the document.
    // Specify the PDF file name.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("abook.epub")
            ' Create a PDF file for the document.
            ' Specify the PDF file name.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to PDF](/viewer/net/images/rendering-basics/render-ebooks/render-to-pdf.png)

## Render EBooks as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an EBook to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("abook.epub"))
{
    // Create a PNG image for each document page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new PngViewOptions("output_{0}.png");

    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("abook.epub")
            ' Create a PNG image for each document page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New PngViewOptions("output_{0}.png")

            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an EBook to PNG](/viewer/net/images/rendering-basics/render-ebooks/render-to-png-image.png)

## Render EBooks as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an EBook to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("abook.epub"))
{
    // Create a JPEG image for each document page.
    // {0} is replaced with the current page number in the image name.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("abook.epub")
            ' Create a JPEG image for each document page.
            ' {0} is replaced with the current page number in the image name.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")

            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}


---

## Render EBooks as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-ebooks/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your EBooks (EPUB, MOBI) in HTML, PDF, PNG, and JPEG formats. You do not need to use any book reader to load and view EBooks within your Node.js application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance. Pass a book you want to view to the class constructor. You can load the book from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the EBook to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/ebook" >}} {{< icon "gdoc_person" >}} View EBooks online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported EBooks file formats

GroupDocs.Viewer supports the following EBooks file formats:

* [EPUB](https://docs.fileformat.com/ebook/epub/) (.EPUB)
* [MOBI](https://docs.fileformat.com/ebook/mobi/) (.MOBI)

## Render EBooks as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an EBook file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "render-ebook-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.epub")
// Create an HTML file for the drawing.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-ebook-to-html-embedded/epub-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to HTML](/viewer/nodejs-java/images/rendering-basics/render-ebooks/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-ebook-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.epub")
// Create an HTML file for each page.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-ebook-to-html-external/epub-to-html-page_{0}.html", "render-ebook-to-html-external/epub-to-html-page_{0}/resource_{0}_{1}", "render-ebook-to-html-external/epub-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-ebooks/render-to-html-external-resources.png)

## Render EBooks as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an EBook file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-ebook-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.epub")
// Create a PDF file for the document.
// Specify the PDF file name.
const viewOptions = PdfViewOptions("render-ebook-to-pdf/epub-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to PDF](/viewer/nodejs-java/images/rendering-basics/render-ebooks/render-to-pdf.png)

## Render EBooks as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an EBook file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-ebook-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.epub")
// Create a PNG image for each document page.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-ebook-to-png/epub-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an EBook file to PNG](/viewer/nodejs-java/images/rendering-basics/render-ebooks/render-to-png-image.png)

## Render EBooks as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an EBook file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-ebook-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.epub")
// Create a JPG image for each document page.
// {0} is replaced with the current page number in the image name.
const viewOptions = JpgViewOptions("render-ebook-to-jpeg/epub-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Render EBooks as HTML, PDF, and image files

Path: /viewer/python-net/render-ebooks/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to render your EBooks (EPUB, MOBI) in HTML, PDF, PNG, and JPEG formats. You do not need to use any book reader to load and view EBooks within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass a book you want to view to the class constructor. You can load the book from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the EBook to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/ebook" >}} {{< icon "gdoc_person" >}} View EBookd online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported EBooks file formats

GroupDocs.Viewer supports the following EBooks file formats:

* [EPUB](https://docs.fileformat.com/ebook/epub/) (.EPUB)
* [MOBI](https://docs.fileformat.com/ebook/mobi/) (.MOBI)
* [AZW3](https://docs.fileformat.com/ebook/azw3/) (.AZW3)

GroupDocs.Viewer can detect the book format automatically based on information in the file header.

## Render EBooks as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an EBook file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_ebook_to_html():
    # Load EBook
    with Viewer("sample.epub") as viewer:
        # Create an HTML file for each document page.
        # {0} is replaced with the current page number in the file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_ebook_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_ebook_to_html()
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to HTML](/viewer/python-net/images/rendering-basics/render-ebooks/render-to-html-embedded-resources.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_ebook_to_html_external():
    # Load EBook
    with Viewer("sample.epub") as viewer:
        # Create an HTML file for each document page.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_ebook_to_html_external/pdf_page_{0}.html", "render_ebook_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_ebook_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_ebook_to_html_external()
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-ebooks/render-to-html-external-resources.png)

## Render EBooks as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an EBook to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_ebook_to_pdf():
    # Load EBook
    with Viewer("sample.epub") as viewer:
        # Create a PDF file for the document.
        # Specify the PDF file name.
        viewOptions = PdfViewOptions("render_ebook_to_pdf/ebook.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_ebook_to_pdf()
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an EBook to PDF](/viewer/python-net/images/rendering-basics/render-ebooks/render-to-pdf.png)

## Render EBooks as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an EBook to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_ebook_to_png():
    # Load EBook
    with Viewer("sample.epub") as viewer:
        # Create a PNG image for each document page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_ebook_to_png/ebook_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_ebook_to_png()
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
The following image demonstrates the result:

![Render an EBook to PNG](/viewer/python-net/images/rendering-basics/render-ebooks/render-to-png-image.png)

## Render EBooks as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an EBook to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_ebook_to_jpg():
    # Load EBook
    with Viewer("sample.epub") as viewer:
        # Create a JPEG image for each document page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = JpgViewOptions("render_ebook_to_jpg/ebook_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_ebook_to_jpg()
```
{{< /tab >}}
{{< tab "sample.epub" >}}
{{< tab-text >}}
`sample.epub` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-ebooks/sample.epub) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


---

## Rotate pages

Path: /merger/java/rotate-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/java) allows to change page rotation angle by setting it to 90, 180 or 270 degrees for specific or all document pages.  
Here are the steps to change page rotation:

*   Initialize [RotateOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RotateOptions) class with desired rotation angle and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [rotatePages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#rotatePages(com.groupdocs.merger.domain.options.interfaces.IRotateOptions)) method and pass [RotateOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RotateOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to change page rotation:

```java
String filePath = "c:\sample.pdf";
String filePathOut = "c:\output\result.pdf";

RotateOptions rotateOptions = new RotateOptions(RotateMode.Rotate180, new int[] { 2, 3 });

Merger merger = new Merger(filePath);
merger.rotatePages(rotateOptions);
merger.save(filePathOut);
```

---

## Rotate pages

Path: /merger/nodejs-java/rotate-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/nodejs-java) allows to change page rotation angle by setting it to 90, 180 or 270 degrees for specific or all document pages.  
Here are the steps to change page rotation:

*   Initialize [RotateOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RotateOptions) class with desired rotation angle and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [rotatePages](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#rotatePages(com.groupdocs.merger.domain.options.interfaces.IRotateOptions)) method and pass [RotateOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/RotateOptions) object to it;
*   Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to change page rotation:

```js
const inputFilePath = `c:/sample.pdf`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/output/result.pdf`;
const rotateMode = groupdocs.merger.RotateMode.Rotate180;
const rotateOptions = new groupdocs.merger.RotateOptions(rotateMode, 1, 2);
merger.rotatePages(rotateOptions);
merger.save(outputPath);
```

---

## Rotate pages

Path: /merger/python-net/rotate-pages/

[**GroupDocs.Merger**](https://products.groupdocs.com/merger/python-net) allows to change page rotation angle by setting it to 90, 180 or 270 degrees for specific or all document pages.  
Here are the steps to change page rotation:

*   Initialize [RotateOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/RotateOptions) class with desired rotation angle and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/net/merger/groupdocs.merger/Merger) object with source document path or InputStream;
*   Call [rotatePages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/rotatepages/) method and pass [RotateOptions](https://reference.groupdocs.com/net/merger/groupdocs.merger.domain.options/RotateOptions) object to it;
*   Call [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method specifying file path to save resultant document.

The following code sample demonstrates how to change page rotation:

```python
with gm.Merger("c:/sample.pdf") as merger:
    rotate_mode = gm.domain.options.RotateMode.ROTATE180
    rotate_options = gm.domain.options.RotateOptions(rotate_mode, 1, 2)
    merger.rotate_pages(rotate_options)
    merger.save("c:/result.pdf")
```

---

## Save document

Path: /editor/java/save-document/

This article describes how to obtain edited document content from client, process it and save to the resultant document of some specified format.

In a nutshell, the core process of document editing, where a user types some text across the pages of the document, inserts images, makes some edits, removes words or paragraphs, or moves some document parts from one location to another, is performed in some 3rd party software with GUI outside of the GroupDocs.Editor. This software may be, for example, but not limiting to:

- a web-based WYSIWYG HTML-editor, that is usually a pure client-side application, written on JavaScript and running in the browser. This may be, for example, a TinyMCE or CKEditor;
- desktop (like WinForms or WPF) application;
- mobile application, running on Android or iOS.

The core requirement for this application is to be able to open, view and edit HTML content. The GroupDocs.Editor on its side accepts various document formats (WordProcessing, Spreadsheet, Presentation, and many more) and prepares them for editing in external applications by converting to the HTML markup and placing it in the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) container. So when calling the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/).[Edit()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#edit--) method, the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) with the **original content** inside it is generated.

Then the user obtains this **original content** from the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), pushes it to the external HTML-editor, makes edits, and when these edits are done, a user has the **modified content**. In the GroupDocs.Editor terminology saving a document means obtaining the **modified content** and generating the document in output format (WordProcessing, Spreadsheet, Presentation, and many more) from it. And this article explains how to do this.

In short, saving a document implies the next three steps:

1. Obtain the **modified content** from somewhere (HTML-editor or any other storage or method) and create an instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) from it. [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) actually serves as an object-oriented wrapper of the document content.
2. Select a desired output format, into which the **modified content** should be saved, and optional parameters.
3. Save the **modified content** to the document of previously chosen format by specified file path or into specified stream using the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/).[Save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-com.groupdocs.editor.EditableDocument-java.lang.String-com.groupdocs.editor.options.ISaveOptions-) method.

These three steps are explained in detail and with code samples below.

## Obtaining the modified content

Different content editors provide the content in different forms. Some may return HTML markup as a `String`, while the external resources like stylesheet(s) and/or image(s) are located in some specific folder as files. Others may return both main content and resources as a collection of byte streams. Some HTML-editors may generate a single string, which already contains all HTML markup with resources baked into it using base64 encoding. There may be unlimited possibilities to do that, and thus the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class has different static factories, which obtain **modified content** of the HTML document in different forms on input and according to this generate the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance:

1. [fromFile](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#fromFile-java.lang.String-java.lang.String-) method is designed for opening HTML-documents from disk — it obtains path to \*.html file (that contains HTML-markup) and an optional path to corresponding resource folder that contains different resources, like stylesheets, images, font files, audio files and so on.
2. [fromMarkup](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#fromMarkup-java.lang.String-java.util.List-com.groupdocs.editor.htmlcss.resources.IHtmlResource--) method is designed for opening HTML-documents from memory — it obtains HTML-markup as a `String` and an optional list of [IHtmlResource](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource) items, like stylesheets, images, fonts, audio resources and so on.
3. [`fromMarkupAndResourceFolder` method](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#fromMarkupAndResourceFolder-java.lang.String-java.lang.String-) is designed for opening HTML-documents from mixed storages — it obtains the HTML-markup as a `String`, but resources are obtained from a path to corresponding resource folder, which, unlike previous methods, is mandatory (such directory should exist).

More information about creating [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instances from files or markup with resources can be found in corresponding article "[Create EditableDocument from file or markup]({{< ref "editor/java/developer-guide/editabledocument/create-editabledocument-from-file-or-markup.md" >}})".

## Create and adjust saving options

When the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance with the **modified content** is created, it's time to save it to the resultant document of some defined format, and the GroupDocs.Editor needs to know this format. Like with load and edit options, every family format has its own class that implements [ISaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/isaveoptions/) interface. These classes are listed below.

| Format family | Example formats | Save options class | Format class |
| --- | --- | --- | --- |
| WordProcessing | DOC, DOCX, DOCM, DOT, ODT | [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/) | [WordProcessingFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats/) |
| Spreadsheet | XLS, XLSX, XLSM, XLSB | [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/) | [SpreadsheetFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/spreadsheetformats/) |
| Delimiter-Separated Values (DSV) | CSV, TSV | [DelimitedTextSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtextsaveoptions/) | [SpreadsheetFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/spreadsheetformats/) |
| Presentation | PPT, PPTX, PPS, POT | [PresentationSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/) | [PresentationFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/presentationformats/) |
| Plain Text documents | TXT | [TextSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/textsaveoptions/) | [TextualFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/textualformats/) |
| Fixed-layout format | PDF | [PdfSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/pdfsaveoptions/) | [FixedLayoutFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/fixedlayoutformats/) |
| Fixed-layout format | XPS | [XpsSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xpssaveoptions/) | [FixedLayoutFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/fixedlayoutformats/) |
| Email | EML, EMLX, TNEF, MSG, HTML, MHTML, ICS, VCF, PST, MBOX, OFT | [EmailSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emailsaveoptions/) | [EmailFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/emailformats/) |
| e-Books | ePub, Mobi, AZW3 | [EbookSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/) | [EBookFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/) |

So, let’s say it is necessary to save the **modified content** to the document of DOCX format. DOCS is the part of WordProcessing family. So the instance of the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/) class should be created, and the [WordProcessingFormats.Docx](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats/#Docx) value should be specified in its constructor. Like this:

```java
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
```

If it is also necessary to encode the resultant document with the password, it can be done using one line of code:

```java
saveOptions.setPassword("some-password");
```

Of course, different formats have different options. For example, there is a `Password` property in [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/), [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/spreadsheetsaveoptions/), [PresentationSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/presentationsaveoptions/), but there is no anything similar in [XpsSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xpssaveoptions/), [EmailSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emailsaveoptions/), [TextSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/textsaveoptions/), and [EbookSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/), because these formats do not support password protection.

Also need to mention that the format of input document with **original content** and format of the resultant document with **modified content** may be different. For example, the original document can be some WordProcessing formats, while the output document can be TXT or PDF. Or the original document can be a PDF, while output — DOCX. Same transitions are allowed between Spreadsheets and DSV (two-ways). But, of course, they are not allowed, where formats are theoretically incompatible in their essence, like WordProcessing and Spreadsheet.

## Saving modified content to the document

Finally, when the instance of [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class with modified content inside is created, and the format of the resultant document is defined, it is possible to generate this resultant document using the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/).[Save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-com.groupdocs.editor.EditableDocument-java.lang.String-com.groupdocs.editor.options.ISaveOptions-) method. This method has two overloads. These overloads differ only with the way how output document is specified: as path, where file should be created, or as a byte stream, into which the document content should be written. All other parameters are the same.

Here is a signature:

```java
save(EditableDocument inputDocument, String filePath, ISaveOptions saveOptions)
save(EditableDocument inputDocument, OutputStream outputDocument, ISaveOptions saveOptions)
```

Here:
- The 1st parameter — `EditableDocument inputDocument` — is a [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance with **modified content** inside, created on the 1st step.
- The 2nd parameter is a `OutputStream`, into which the resultant document of defined format should be written, or a file path, where the resultant document of defined format should be stored.
- The 3rd parameter is an instance of some save options, which defines the format of the resultant document and additional adjustments, created on the 2nd step.

## Complete code example

Because the WYSIWYG HTML-editor is not a part of the GroupDocs.Editor, it is hard to provide a lightweight code example with fully functional editing. So in this sample the content will be edited programmatically, using a [`String.Replace`](https://learn.microsoft.com/ru-ru/dotnet/api/system.string.replace) method.

```java
import com.groupdocs.editor.Editor;
import com.groupdocs.editor.EditableDocument;
import com.groupdocs.editor.options.PdfSaveOptions;
import com.groupdocs.editor.options.WordProcessingSaveOptions; 
import com.groupdocs.editor.formats.WordProcessingFormats; 
// ...

// Create Editor class by loading an input document in DOCX format by path
Editor editor = new Editor("input.docx");

// Open document for edit and obtain EditableDocument
EditableDocument original = editor.edit();

// Get the original content as a string
String originalContent = original.getEmbeddedHtml();

// Get the modified content by editing original content
String modifiedContent = originalContent.replace("old", "new");

// Create EditableDocument from modified content
EditableDocument modified = EditableDocument.fromMarkup(modifiedContent, null);

// Create and adjust 2 different saving options
WordProcessingSaveOptions docxSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();

// Save modified content to the 2 documents
editor.save(modified, "output.docx", docxSaveOptions);
editor.save(modified, "output.pdf", pdfSaveOptions);

// Dispose all
original.dispose();
modified.dispose();
editor.dispose();
```

In this example 2 different save options are created and two different [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/).[Save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-com.groupdocs.editor.EditableDocument-java.lang.String-com.groupdocs.editor.options.ISaveOptions-) calls are made for saving the modified content to the DOCX and PDF formats.

---

## Save document

Path: /editor/net/save-document/

> This article describes how to obtain edited document content from client, process it and save to the resultant document of some specified format.

In a nutshell, the core process of document editing, where a user types some text across the pages of the document, inserts images, makes some edits, removes words or paragraphs, or moves some document parts from one location to another, is performed in some 3rd party software with GUI outside of the GroupDocs.Editor. This software may be, for example, but not limiting to:

- a web-based WYSIWYG HTML-editor, that is usually a pure client-side application, written on JavaScript and running in the browser. This may be, for example, a TinyMCE or CKEditor;
- desktop (like WinForms or WPF) application;
- mobile application, running on Android or iOS.

The core requirement for this application is to be able to open, view and edit HTML content. The GroupDocs.Editor on its side accepts various document formats (WordProcessing, Spreadsheet, Presentation, and many more) and prepares them for editing in external applications by converting to the HTML markup and placing it in the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) container. So when calling the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor).[Edit()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method, the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) with the **original content** inside it is generated.

Then the user obtains this **original content** from the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), pushes it to the external HTML-editor, makes edits, and when these edits are done, a user has the **modified content**. In the GroupDocs.Editor terminology saving a document means obtaining the **modified content** and generating the document in output format (WordProcessing, Spreadsheet, Presentation, and many more) from it. And this article explains how to do this.

In short, saving a document implies the next three steps:

1. Obtain the **modified content** from somewhere (HTML-editor or any other storage or method) and create an instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) from it. [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) actually serves as an object-oriented wrapper of the document content.
2. Select a desired output format, into which the **modified content** should be saved, and optional parameters.
3. Save the **modified content** to the document of previously chosen format by specified file path or into specified stream using the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor).[Save()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

These three steps are explained in detail and with code samples below.

## Obtaining the modified content

Different content editors provide the content in different forms. Some may return HTML markup as a [`System.String`](https://learn.microsoft.com/en-us/dotnet/api/system.string), while the external resources like stylesheet(s) and/or image(s) are located in some specific folder as files. Others may return both main content and resources as a collection of byte streams. Some HTML-editors may generate a single string, which already contains all HTML markup with resources baked into it using base64 encoding. There may be unlimited possibilities to do that, and thus the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class has different static factories, which obtain **modified content** of the HTML document in different forms on input and according to this generate the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance:

1. [`FromFile` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/fromfile) is designed for opening HTML-documents from disk — it obtains path to \*.html file (that contains HTML-markup) and an optional path to corresponding resource folder that contains different resources, like stylesheets, images, font files, audio files and so on.
2. [`FromMarkup` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkup) is designed for opening HTML-documents from memory — it obtains the HTML-markup as a [`System.String`](https://docs.microsoft.com/en-us/dotnet/api/system.string?view=net-6.0) and an optional list of [IHtmlResource](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource) items, like stylesheets, images, fonts, audio resources and so on.
3. [`FromMarkupAndResourceFolder` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkupandresourcefolder) is designed for opening HTML-documents from mixed storages — it obtains the HTML-markup as a [`System.String`](https://docs.microsoft.com/en-us/dotnet/api/system.string?view=net-6.0), but resources are obtained from a path to corresponding resource folder, which, unlike previous methods, is mandatory (such directory should exist).

More information about creating [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instances from files or markup with resources can be found in corresponding article "[Create EditableDocument from file or markup]({{< ref "editor/net/developer-guide/editabledocument/create-editabledocument-from-file-or-markup.md" >}})".

## Create and adjust saving options

When the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance with the **modified content** is created, it's time to save it to the resultant document of some defined format, and the GroupDocs.Editor needs to know this format. Like with load and edit options, every family format has its own class that implements [ISaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/isaveoptions) interface. These classes are listed below.

| Format family | Example formats | Save options class | Format class |
| --- | --- | --- | --- |
| WordProcessing | DOC, DOCX, DOCM, DOT, ODT | [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) | [WordProcessingFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats) |
| Spreadsheet | XLS, XLSX, XLSM, XLSB | [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) | [SpreadsheetFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/spreadsheetformats) |
| Delimiter-Separated Values (DSV) | CSV, TSV | [DelimitedTextSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtextsaveoptions) | [SpreadsheetFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/spreadsheetformats/) |
| Presentation | PPT, PPTX, PPS, POT | [PresentationSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) | [PresentationFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/presentationformats) |
| Plain Text documents | TXT | [TextSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/textsaveoptions) | [TextualFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/textualformats) |
| Fixed-layout format | PDF | [PdfSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions) | [FixedLayoutFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/fixedlayoutformats) |
| Fixed-layout format | XPS | [XpsSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xpssaveoptions) | [FixedLayoutFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/fixedlayoutformats) |
| Email | EML, EMLX, TNEF, MSG, HTML, MHTML, ICS, VCF, PST, MBOX, OFT | [EmailSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emailsaveoptions) | [EmailFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/emailformats) |
| e-Books | ePub, Mobi, AZW3 | [EbookSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions/) | [EBookFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats) |

So, let’s say it is necessary to save the **modified content** to the document of DOCX format. DOCS is the part of WordProcessing family. So the instance of the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class should be created, and the [WordProcessingFormats.Docx](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats/docx/) value should be specified in its constructor. Like this:

{{< tabs "Save options creation">}}
{{< tab "C#" >}}
```csharp
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim saveOptions As WordProcessingSaveOptions = New WordProcessingSaveOptions(WordProcessingFormats.Docx)
```
{{< /tab >}}
{{< /tabs >}}

If it is also necessary to encode the resultant document with the password, it can be done using one line of code:

{{< tabs "Save options adjustment">}}
{{< tab "C#" >}}
```csharp
saveOptions.Password = "some-password";
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
saveOptions.Password = "some-password"
```
{{< /tab >}}
{{< /tabs >}}

Of course, different formats have different options. For example, there is a `Password` property in [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions), [SpreadsheetSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions), [PresentationSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions), but there is no anything similar in [XpsSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xpssaveoptions), [EmailSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emailsaveoptions), [TextSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/textsaveoptions), and [EbookSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions/), because these formats do not support password protection.

Also need to mention that the format of input document with **original content** and format of the resultant document with **modified content** may be different. For example, the original document can be some WordProcessing formats, while the output document can be TXT or PDF. Or the original document can be a PDF, while output — DOCX. Same transitions are allowed between Spreadsheets and DSV (two-ways). But, of course, they are not allowed, where formats are theoretically incompatible in their essence, like WordProcessing and Spreadsheet.

## Saving modified content to the document

Finally, when the instance of [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class with modified content inside is created, and the format of the resultant document is defined, it is possible to generate this resultant document using the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor).[Save()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method. This method has two overloads. These overloads differ only with the way how output document is specified: as path, where file should be created, or as a byte stream, into which the document content should be written. All other parameters are the same.

Here is a signature:
{{< tabs "Save signature">}}
{{< tab "C#" >}}
```csharp
Save(EditableDocument inputDocument, string filePath, ISaveOptions saveOptions)
Save(EditableDocument inputDocument, Stream outputDocument, ISaveOptions saveOptions)
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Save(inputDocument As EditableDocument, filePath As String, saveOptions As ISaveOptions)
Save(inputDocument As EditableDocument, outputDocument As Stream, saveOptions As ISaveOptions)
```
{{< /tab >}}
{{< /tabs >}}
Here:
- The 1st parameter — `EditableDocument inputDocument` — is a [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance with **modified content** inside, created on the 1st step.
- The 2nd parameter is a [stream](https://learn.microsoft.com/en-us/dotnet/api/system.io.stream), into which the resultant document of defined format should be written, or a `string`, that represents a file path, where the resultant document of defined format should be stored.
- The 3rd parameter is an instance of some save options, which defines the format of the resultant document and additional adjustments, created on the 2nd step.

In the [version 25.7](https://releases.groupdocs.com/editor/net/release-notes/2025/groupdocs-editor-for-net-25-7-release-notes/) a new overload of the `Editor.Save()` method was added:

{{< tabs "Save simplified">}}
{{< tab "C#" >}}
```csharp
Save(EditableDocument inputDocument, string filePath)
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Save(inputDocument As EditableDocument, filePath As String)
```
{{< /tab >}}
{{< /tabs >}}

This overload is essentially a wrapper for the previously mentioned overload — it analyzes the file extension of the `filePath` argument and inferes the default saving options automatically.

## Complete code example

Because the WYSIWYG HTML-editor is not a part of the GroupDocs.Editor, it is hard to provide a lightweight code example with fully functional editing. So in this sample the content will be edited programmatically, using a [`String.Replace`](https://learn.microsoft.com/ru-ru/dotnet/api/system.string.replace) method.

{{< tabs "Full example">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;
// ...

// Create Editor class by loading an input document in DOCX format by path
Editor editor = new Editor("input.docx");

// Open document for edit and obtain EditableDocument
EditableDocument original = editor.Edit();

// Get the original content as a string
string originalContent = original.GetEmbeddedHtml();

// Get the modified content by editing original content
string modifiedContent = originalContent.Replace("old", "new");

// Create EditableDocument from modified content
EditableDocument modified = EditableDocument.FromMarkup(modifiedContent, null);

// Create and adjust 2 different saving options
WordProcessingSaveOptions docxSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();

// Save modified content to the 2 documents
editor.Save(modified, "output.docx", docxSaveOptions);
editor.Save(modified, "output.pdf", pdfSaveOptions);

// Dispose all
original.Dispose();
modified.Dispose();
editor.Dispose();
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Editor.Formats
Imports GroupDocs.Editor.Options
' ...

' Create Editor class by loading an input document in DOCX format by path
Dim editor As Editor = New Editor("input.docx")

' Open document for edit And obtain EditableDocument
Dim original As EditableDocument = editor.Edit()

' Get the original content as a string
Dim originalContent As String = original.GetEmbeddedHtml()

' Get the modified content by editing original content
Dim modifiedContent As String = originalContent.Replace("old", "new")


' Create EditableDocument from modified content
Dim modified As EditableDocument = EditableDocument.FromMarkup(modifiedContent, Nothing)

' Create And adjust 2 different saving options
Dim docxSaveOptions As WordProcessingSaveOptions = New WordProcessingSaveOptions(WordProcessingFormats.Docx)
Dim pdfSaveOptions As PdfSaveOptions = New PdfSaveOptions()

' Save modified content to the 2 documents
editor.Save(modified, "output.docx", docxSaveOptions)
editor.Save(modified, "output.pdf", pdfSaveOptions)

' Dispose all
original.Dispose()
modified.Dispose()
editor.Dispose()
```
{{< /tab >}}
{{< /tabs >}}

In this example 2 different save options are created and two different [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor).[Save()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) calls are made for saving the modified content to the DOCX and PDF formats.

---

## Save Document

Path: /editor/nodejs-java/save-document/


This article describes how to obtain edited document content from the client, process it, and save it to the resultant document of a specified format using **GroupDocs.Editor for Node.js via Java**.

When the end-user has finished editing the document in the WYSIWYG HTML editor (usually a pure client-side application written in JavaScript), they submit the editing operation, and the HTML markup with stylesheets, images, and possibly other resources are passed to the server-side. To generate a document of some output format, these resources should be passed to the [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/EditableDocument).

As shown in previous articles, instances of [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/EditableDocument) are generated and returned by the [`Editor.edit()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#edit--) method and then are used for emitting HTML markup and resources to pass them *to* the WYSIWYG editor.

However, `EditableDocument` also has a second purpose—to obtain edited content *from* the WYSIWYG editor. The `EditableDocument` class has no public constructors; instead, it has two static factory methods that obtain the HTML document in different forms:

1. **[`fromFile()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/EditableDocument#fromFile--):** Designed for opening HTML documents from disk—it accepts the path to the `.html` file and the path to the corresponding resource folder.
2. **[`fromMarkup()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/EditableDocument#fromMarkup--):** Designed for opening HTML documents from memory—it accepts HTML markup as a `String` and a list of [`IHtmlResource`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.htmlcss.resources/IHtmlResource) items.

More information about creating `EditableDocument` instances from files or markup with resources can be found in the corresponding article: [Create EditableDocument from File or Markup](/editor/nodejs-java/developer-guide/editabledocument/create-editabledocument-from-file-or-markup/).

## Saving the Edited Document

When the `EditableDocument` is created, it can be converted to the output document. To do this, you must use the [`Editor.save()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#save--) method, which has two overloads. These overloads differ only in the way the output document is specified: as a path where the file should be created, or as a byte stream into which the document content should be written. All other parameters are the same. They are:

1. **EditableDocument Instance:**
   - An instance of the `EditableDocument` class that holds the content of the edited document.
2. **Output Document:**
   - Specified as a file path (`String`) or byte stream (`OutputStream`).
3. **Save Options:**
   - Mandatory save options, represented by one of the inheritors of the [`ISaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/ISaveOptions) interface.

### Save Options Classes

Like with load and edit options, every format family has its own class that implements the `ISaveOptions` interface. These classes are listed below:

| Format Family                    | Example Formats                 | Save Options Class                                                                                 | Format Class                                                                                 |
|----------------------------------|---------------------------------|----------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
| WordProcessing                   | DOC, DOCX, DOCM, DOT, ODT       | [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/WordProcessingSaveOptions) | [`WordProcessingFormats`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats/WordProcessingFormats) |
| Spreadsheet                      | XLS, XLSX, XLSM, XLSB           | [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/SpreadsheetSaveOptions)       | [`SpreadsheetFormats`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats/SpreadsheetFormats) |
| Delimiter-Separated Values (DSV) | CSV, TSV                        | [`DelimitedTextSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/DelimitedTextSaveOptions)   | [`TextualFormats`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats/TextualFormats) |
| Presentation                     | PPT, PPTX, PPS, POT             | [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/PresentationSaveOptions)     | [`PresentationFormats`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats/PresentationFormats) |
| Plain Text Documents             | TXT                             | [`TextSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/TextSaveOptions)                     | [`TextualFormats`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats/TextualFormats) |
| PDF                              | PDF                             | [`PdfSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/PdfSaveOptions)                       | N/A                                                                                          |

## Code Example

The source code below shows how to create an instance of the `EditableDocument` class and subsequently save two versions of the document: one to a file and the second to another file in a different format.

```javascript
// Import the necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');

// Load the edited HTML document from a file
const inputHtmlPath = 'C:\\input\\document.html';
const document = groupdocsEditor.EditableDocument.fromFile(inputHtmlPath, null);

// Create an Editor instance (original document path can be provided if needed)
const editor = new groupdocsEditor.Editor('C:\\path\\original.docx');

// Save the first version to a file
const outputPath1 = 'C:\\output_path\\document.rtf';
const saveOptions1 = new groupdocsEditor.WordProcessingSaveOptions(groupdocsEditor.WordProcessingFormats.Rtf);
editor.save(document, outputPath1, saveOptions1);

// Save the second version to another file
const outputPath2 = 'C:\\output_path\\document.docm';
const saveOptions2 = new groupdocsEditor.WordProcessingSaveOptions(groupdocsEditor.WordProcessingFormats.Docm);
editor.save(document, outputPath2, saveOptions2);

// Dispose of resources
document.dispose();
editor.dispose();
```

In the example above:

- **Loading the Edited HTML Document:**
  - We use `EditableDocument.fromFile()` to load the edited HTML document from the specified path.
- **Creating an Editor Instance:**
  - We create an `Editor` instance by specifying the original document path.
- **Saving the First Version:**
  - We specify the output path and create `WordProcessingSaveOptions` with the desired format (`Rtf`).
  - We call `editor.save()` to save the document.
- **Saving the Second Version:**
  - We repeat the process with a different output path and format (`Docm`).

As you can see from the example above, it is possible to create multiple output documents from a single `EditableDocument` with different save options and different formats. These output formats do not need to be the same as the format of the input document.

Furthermore, in some cases, the format family can also be different. For example, the original document can be one of the WordProcessing formats, while the output document can be TXT or PDF. Similar transitions are allowed between Spreadsheets and DSV (two-way). However, transitions are not allowed where formats are theoretically incompatible in their essence, such as between WordProcessing and Spreadsheet formats.

## Conclusion

This article has demonstrated how to save edited documents using **GroupDocs.Editor for Node.js via Java**. By obtaining the edited content from the client, creating an `EditableDocument` instance, and using the appropriate save options, you can generate output documents in various formats. This flexibility allows you to integrate document editing and conversion capabilities into your Node.js applications effectively.

---

**Note:** Be sure to replace `'C:\\input\\document.html'`, `'C:\\path\\original.docx'`, and output paths with the actual file paths in your application.

---

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.



---

## Save output to a stream

Path: /viewer/java/save-output-to-stream/

By default, GroupDocs.Viewer saves output results to the local disk. Also, it can provide results as a stream.

To provide output results as a stream, use one of the following interfaces:

* [FileStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/FileStreamFactory) defines methods to instantiate and release the output file streams.
* [PageStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/PageStreamFactory) defines methods to instantiate and release the output page streams.
* [ResourceStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/ResourceStreamFactory) defines the methods to create resource URLs, instantiate, and release output HTML resource streams.

Use these interface as follows:

* When rendering to PDF, implement the [FileStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/FileStreamFactory) interface and pass the implementation to the [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) constructor.
* When rendering to JPG/PNG or HTML with embedded resources, implement the [PageStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/PageStreamFactory) interface and pass the implementation to the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/)/[PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) constructor or to the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) [forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources-com.groupdocs.viewer.interfaces.PageStreamFactory-) factory method.
* When rendering into HTML with external resources, implement the [PageStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/PageStreamFactory) and [ResourceStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/ResourceStreamFactory) interfaces and pass the implementation to the [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/)/[PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) constructor or to the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) [forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources-com.groupdocs.viewer.interfaces.PageStreamFactory-com.groupdocs.viewer.interfaces.ResourceStreamFactory-) factory method.

The following code snippet shows how to render to HTML with embedded resources and to provide the output result as a stream. To do this, it implements the [PageStreamFactory](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.interfaces/PageStreamFactory) interface only.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.interfaces.PageStreamFactory;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.ViewOptions;
// ...

final List<ByteArrayOutputStream> pages = new ArrayList<>();

try (Viewer viewer = new Viewer("sample.docx")) {

    PageStreamFactory pageStreamFactory = new PageStreamFactory() {

        @Override
        public OutputStream createPageStream(int pageNumber) {
            ByteArrayOutputStream pageStream = new ByteArrayOutputStream();

            pages.add(pageStream);

            return pageStream;
        }

        @Override
        public void closePageStream(int pageNumber, OutputStream outputStream) {
            //Do not release page stream as we'll need to keep the stream open
        }
    };

    ViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageStreamFactory);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Save output to a stream

Path: /viewer/net/save-output-to-stream/

By default, GroupDocs.Viewer saves output results to the local disk. Also, it can provide results as a stream.

To provide output results as a stream, use one of the following interfaces:

* [IFileStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/ifilestreamfactory) defines methods to instantiate and release the output file streams.
* [IPageStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/ipagestreamfactory) defines methods to instantiate and release the output page streams.
* [IResourceStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/iresourcestreamfactory) defines the methods to create resource URLs, instantiate, and release output HTML resource streams.

Use these interface as follows:

* When rendering to PDF, implement the [IFileStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/ifilestreamfactory) interface and pass the implementation to the [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions) constructor.
* When rendering to JPG/PNG or HTML with embedded resources, implement the [IPageStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/ipagestreamfactory) interface and pass the implementation to the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)/[PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions) constructor or to the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) [ForEmbeddedResources](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options.htmlviewoptions/forembeddedresources/methods/3) factory method.
* When rendering into HTML with external resources, implement the [IPageStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/ipagestreamfactory) and [IResourceStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/iresourcestreamfactory) interfaces and pass the implementation to the [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)/[PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions) constructor or to the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) [ForExternalResources](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options.htmlviewoptions/forexternalresources/methods/3) factory method.

The following code snippet shows how to render to HTML with embedded resources and to provide the output result as a stream. To do this, it implements the [IPageStreamFactory](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.interfaces/ipagestreamfactory) interface only.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using System.Collections.Generic;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Interfaces;
// ...

// Create the list to store output pages
List<MemoryStream> pages = new List<MemoryStream>();

using (Viewer viewer = new Viewer("sample.docx"))
{
    MemoryPageStreamFactory pageStreamFactory = new MemoryPageStreamFactory(pages);
    ViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources(pageStreamFactory);
    viewer.View(viewOptions);
}

internal class MemoryPageStreamFactory : IPageStreamFactory
{
    private readonly List<MemoryStream> _pages;

    public MemoryPageStreamFactory(List<MemoryStream> pages)
    {
        _pages = pages;
    }

    public Stream CreatePageStream(int pageNumber)
    {
        MemoryStream pageStream = new MemoryStream();
        _pages.Add(pageStream);
        return pageStream;
    }

    public void ReleasePageStream(int pageNumber, Stream pageStream)
    {
        //Do not release page stream as we'll need to keep the stream open
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Interfaces
' ...

Module Program
    Sub Main(args As String())
        ' Create the list to store output pages
        Dim pages As New List(Of MemoryStream)()

        Using viewer As New Viewer("sample.docx")
            Dim pageStreamFactory As New MemoryPageStreamFactory(pages)
            Dim viewOptions As ViewOptions = HtmlViewOptions.ForEmbeddedResources(pageStreamFactory)
            viewer.View(viewOptions)
        End Using
    End Sub

    Class MemoryPageStreamFactory
        Implements IPageStreamFactory

        Private ReadOnly _pages As List(Of MemoryStream)

        Public Sub New(pages As List(Of MemoryStream))
            _pages = pages
        End Sub

        Public Function CreatePageStream(pageNumber As Integer) As Stream Implements IPageStreamFactory.CreatePageStream
            Dim pageStream As New MemoryStream()
            _pages.Add(pageStream)
            Return pageStream
        End Function

        Public Sub ReleasePageStream(pageNumber As Integer, pageStream As Stream) _
            Implements IPageStreamFactory.ReleasePageStream
            'Do not release page stream as we'll need to keep the stream open
        End Sub
    End Class
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Search and highlight text in the loaded document

Path: /viewer/java/search-highlight-text/

Starting from [version 25.9](https://releases.groupdocs.com/viewer/java/release-notes/2025/groupdocs-viewer-for-java-25-9-release-notes/) the GroupDocs.Viewer is able to search the text spans in the loaded documents and highlight the found text. This feature can be described with the next three basic statements:

1. Searching text is supported for almost all document family formats, which may have textual content: all formats within WordProcessing family (DOC, DOCX, ODT, RTF, etc.), Spreadsheet (XLS, XLSX, ODS, CSV, etc.), Presentation (PPT, PPTX, PPS, POT, etc.), e-Books (ePub, AZW3, Mobi), and fixed-layout formats (PDF and XPS).
2. Search may be performed by entered search term (text literal) or by a regular expression (RegEx).
3. Highlighting of the found text is adjustable — it is possible to set the color of the found text (foreground color) and/or the color of the background.


Once a search operation is performed and some text is found, the document may be rendered to the HTML, PDF, PNG, or JPEG, and the found text will be highlighted in these produced documents. Just need to remember that search must be done _before_ rendering the document, not after.

In order to perform a search a new public instance method was added to the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class — [`void search(SearchHighlightOptions options)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#search-com.groupdocs.viewer.options.SearchHighlightOptions-). As it is seen from its signature, this method obtains on input an instance of the [`SearchHighlightOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/) class. This class contains both a search term (phrase), search options, and highlight options, applied to the found text. This is described in detail below:

- [`setSearchTerm`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/#setSearchTerm-java.lang.String-) property of a [`java.lang.String`](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html) type allows to specify a search text, which must be highlighted if found, or a regex pattern for search.
- [`setSearchTermRegEx`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/#setSearchTermRegEx-boolean-) property of [boolean](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) type indicates whether the value of the previously described `SearchTerm` property should be treated as a text literal (`false`) or as a regular expression (`true`). Default is `false` — treat as a text literal.
- [`setBackgroundColor`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/#setBackgroundColor-com.groupdocs.viewer.drawing.Argb32Color-) property of [`Argb32Color`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.drawing/argb32color/) type allows to specify a background color of the found text. By default, if this property is not specified, or its value is fully transparent, a yellow color will be applied to the background of the found text.
- [`setForegroundColor`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/#setForegroundColor-com.groupdocs.viewer.drawing.Argb32Color-) property of [`Argb32Color`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.drawing/argb32color/) type allows to specify a color, which will be applied to the found text itself (foreground color). By default, if this property is not specified, or its value is fully transparent, the color of found text will be untouched.

Summing up, in order to search for some text and highlight it using GroupDocs.Viewer, need to perform the next four steps:

1. Load the input document to the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class through its constructor.
2. Create an instance [`SearchHighlightOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/) class and tune its options — specify at least a [`setSearchTerm`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/#setSearchTerm-java.lang.String-) property.
3. Invoke the [`Viewer.search(SearchHighlightOptions)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#search-com.groupdocs.viewer.options.SearchHighlightOptions-) method with a previously created and prepared [`SearchHighlightOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/searchhighlightoptions/) instance.
4. Render the document to the HTML, PDF, PNG, and/or JPEG using a [`Viewer.view()`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

Code sample below shows loading two distinct documents — DOCX and PDF, and performing search in them using text literal and RegEx. Finally, documents are saved to HTML and PNG.


{{< tabs "Search">}}
{{< tab "SearchHighlightText.java" >}}  
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.PngViewOptions;
import com.groupdocs.viewer.options.SearchHighlightOptions;

public class SearchHighlightText {
    public static void search() throws Exception {
        // Creating two instances of SearchHighlightOptions and adjusting them
        SearchHighlightOptions byLiteral = new SearchHighlightOptions();
        byLiteral.setSearchTerm("some text");
        byLiteral.setSearchTermRegEx(false);

        SearchHighlightOptions byRegEx = new SearchHighlightOptions();
        byRegEx.setSearchTerm("text\\s*#(\\d+)");
        byRegEx.setSearchTermRegEx(true);

        // Loading two documents to the two instances of Viewer class
        try (Viewer docxViewer = new Viewer("sample.docx");
             Viewer pdfViewer = new Viewer("sample.pdf")) {
            // Performing search in both Viewer instances
            docxViewer.search(byLiteral);
            pdfViewer.search(byRegEx);

            // Rendering both documents - 1st to HTML and 2nd to PNG
            docxViewer.view(HtmlViewOptions.forEmbeddedResources("result_{0}.html"));
            pdfViewer.view(new PngViewOptions());
        }
    }

    public static void main(String[] args){
        search();
    }
}
```
{{< /tab >}}
{{< tab "sample.docx" >}}  
{{< tab-text >}}
`sample.docx` is sample file used in this example. Click [here](/viewer/java/sample-files/developer-guide/search-highlight-text/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "result_3.html" >}}  
{{< tab-text >}}
`result_3.html` is rendered HTML document. Click [here](/viewer/java/sample-files/developer-guide/search-highlight-text/result_3.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Search and highlight text in the loaded document

Path: /viewer/net/search-highlight-text/

Starting from [version 25.4](https://releases.groupdocs.com/viewer/net/release-notes/2025/groupdocs-viewer-for-net-25-4-release-notes/) the GroupDocs.Viewer is able to search the text spans in the loaded documents and highlight the found text. This feature can be described with the next three basic statements:

1. Searching text is supported for almost all document family formats, which may have textual content: all formats within WordProcessing family (DOC, DOCX, ODT, RTF, etc.), Spreadsheet (XLS, XLSX, ODS, CSV, etc.), Presentation (PPT, PPTX, PPS, POT, etc.), e-Books (ePub, AZW3, Mobi), and fixed-layout formats (PDF and XPS).
2. Search may be performed by entered search term (text literal) or by a regular expression (RegEx).
3. Highlighting of the found text is adjustable — it is possible to set the color of the found text (foreground color) and/or the color of the background.


Once a search operation is performed and some text is found, the document may be rendered to the HTML, PDF, PNG, or JPEG, and the found text will be highlighted in these produced documents. Just need to remember that search must be done _before_ rendering the document, not after.

In order to perform a search a new public instance method was added to the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class — [`void Search(Options.SearchHighlightOptions options)`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/search/). As it is seen from its signature, this method obtains on input an instance of the [`Options.SearchHighlightOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/SearchHighlightOptions/) class. This class contains both a search term (phrase), search options, and highlight options, applied to the found text. This is described in detail below:

- [`SearchTerm`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/searchhighlightoptions/searchterm/) property of a [`System.String`](https://learn.microsoft.com/en-us/dotnet/api/system.string) type allows to specify a search text, which must be highlighted if found, or a regex pattern for search.
- [`IsSearchTermRegEx`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/searchhighlightoptions/issearchtermregex/) property of [boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean) type indicates whether the value of the previously described `SearchTerm` property should be treated as a text literal (`false`) or as a regular expression (`true`). Default is `false` — treat as a text literal.
- [`BackgroundColor`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/searchhighlightoptions/backgroundcolor/) property of [`Argb32Color`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.drawing/argb32color/) type allows to specify a background color of the found text. By default, if this property is not specified, or its value is fully transparent, a yellow color will be applied to the background of the found text.
- [`ForegroundColor`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/searchhighlightoptions/foregroundcolor/) property of [`Argb32Color`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.drawing/argb32color/) type allows to specify a color, which will be applied to the found text itself (foreground color). By default, if this property is not specified, or its value is fully transparent, the color of found text will be untouched.

Summing up, in order to search for some text and highlight it using GroupDocs.Viewer, need to perform the next four steps:

1. Load the input document to the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class through its constructor.
2. Create an instance [`SearchHighlightOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/SearchHighlightOptions/) class and tune its options — specify at least a [`SearchTerm`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/searchhighlightoptions/searchterm/) property.
3. Invoke the [`Viewer.Search(SearchHighlightOptions)`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/search/) method with a previously created and prepared [`SearchHighlightOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/searchhighlightoptions/) instance.
4. Render the document to the HTML, PDF, PNG, and/or JPEG using a [`Viewer.View()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/view/#view) method.

Code sample below shows loading two distinct documents — DOCX and PDF, and performing search in them using text literal and RegEx. Finally, documents are saved to HTML and PNG.


{{< tabs "Search">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

// Creating two instances of SearchHighlightOptions and adjusting them
SearchHighlightOptions byLiteral = new SearchHighlightOptions()
{
    SearchTerm = "some text",
    IsSearchTermRegEx = false
};
SearchHighlightOptions byRegEx = new SearchHighlightOptions()
{
    SearchTerm = @"text\s*#(\d+)",
    IsSearchTermRegEx = true
};

// Loading two documents to the two instances of Viewer class
using (Viewer docxViewer = new Viewer("sample.docx"))
using (Viewer pdfViewer = new Viewer("sample.pdf"))
{
    // Performing search in both Viewer instances
    docxViewer.Search(byLiteral);
    pdfViewer.Search(byRegEx);

    // Rendering both documents - 1st to HTML and 2nd to PNG
    docxViewer.View(HtmlViewOptions.ForEmbeddedResources());
    pdfViewer.View(new PngViewOptions());
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

' Creating two instances of SearchHighlightOptions and adjusting them
Dim byLiteral As New SearchHighlightOptions() With {
    .SearchTerm = "some text",
    .IsSearchTermRegEx = False
}
Dim byRegEx As New SearchHighlightOptions() With {
    .SearchTerm = "text\s*#(\d+)",
    .IsSearchTermRegEx = True
}

' Loading two documents to the two instances of Viewer class
Using docxViewer As New Viewer("sample.docx"), pdfViewer As New Viewer("sample.pdf")
    ' Performing search in both Viewer instances
    docxViewer.Search(byLiteral)
    pdfViewer.Search(byRegEx)

    'Rendering both documents - 1st to HTML and 2nd to PNG
    docxViewer.View(HtmlViewOptions.ForEmbeddedResources())
    pdfViewer.View(New PngViewOptions())
End Using
```
{{< /tab >}}
{{< /tabs >}}
---

## Sign document with Form Field signature - advanced

Path: /signature/java/sign-document-with-form-field-signature-advanced/

GroupDocs.Signature provides [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) class to specify different options for Form Field signature. The Form Field signature is special document predefined input field control with unique name inside the document content that expects some input from user.

At the moment GroupDocs.Siganture supports creation of Form Field signatures for Pdf documents only.

The [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) class contains one [FormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) object to put to the document.

Here are the list of different Form Field signature classes that could be set to [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions)

*   [TextFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/TextFormFieldSignature) - represents text input form field on document page. 
*   [CheckboxFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/CheckboxFormFieldSignature) - represents check box field on the document page.
*   [DigitalFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/DigitalFormFieldSignature) - represents digital signature input form on document page.  
    

Here are the steps to add Form Field signatures into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) object according to your requirements.    
*   Instantiate one of the derived classes from [FormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/FormFieldSignature) object. It could be [TextFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/TextFormFieldSignature), [CheckboxFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/CheckboxFormFieldSignature) or [DigitalFormFieldSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures.formfield/DigitalFormFieldSignature).    
*   Set FormFieldSignOptions.[setSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions#setSignature(com.groupdocs.signature.domain.signatures.formfield.FormFieldSignature)) property with created object.      
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of  [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) to it.       
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

  

## Sign Pdf document with  Form Field signature  

This example shows how to add Form Field signature to document. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult)  

```java
Signature signature = new Signature("sample.pdf");
 
List<SignOptions> listOptions = new ArrayList<SignOptions>();
 
// instantiate text form field signature
FormFieldSignature textSignature = new TextFormFieldSignature("tbData1", "Value-1");
// instantiate options based on text form field signature
FormFieldSignOptions optionsTextFF = new FormFieldSignOptions(textSignature);
optionsTextFF.setHorizontalAlignment(HorizontalAlignment.Left);
optionsTextFF.setVerticalAlignment(VerticalAlignment.Top);
optionsTextFF.setMargin(new Padding(10, 20, 0, 0));
optionsTextFF.setHeight(10);
optionsTextFF.setWidth(100);            
 
// instantiate text form field signature
CheckboxFormFieldSignature chbSignature = new CheckboxFormFieldSignature("chbData1", true);
// instantiate options based on text form field signature
FormFieldSignOptions optionsTextCHB = new FormFieldSignOptions(chbSignature) ;           
optionsTextCHB.setHorizontalAlignment(HorizontalAlignment.Center);
optionsTextCHB.setVerticalAlignment(VerticalAlignment.Top);
optionsTextCHB.setMargin(new Padding(0, 0, 0, 0));
optionsTextCHB.setHeight(10);
optionsTextCHB.setWidth(100);    
 
// instantiate text form field signature
DigitalFormFieldSignature digSignature = new DigitalFormFieldSignature("dgData1");
// instantiate options based on text form field signature
FormFieldSignOptions optionsTextDIG = new FormFieldSignOptions(digSignature);           
optionsTextDIG.setHorizontalAlignment(HorizontalAlignment.Right);
optionsTextDIG.setVerticalAlignment(VerticalAlignment.Top);
optionsTextDIG.setMargin(new Padding(0, 50, 0, 0));
optionsTextDIG.setHeight(10);
optionsTextDIG.setWidth(100);            
 
listOptions.add(optionsTextFF);
listOptions.add(optionsTextCHB);
listOptions.add(optionsTextDIG);
 
// sign document to file
SignResult signResult = signature.sign("signedSample.pdf", listOptions);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Spreadsheet redactions

Path: /redaction/java/spreadsheet-redactions/

### Filter by spreadsheet and column

If you have a document with one or more tables, organized into worksheets (one table per worksheet) - such as Microsoft Excel documents - you can use specific type of textual redactions, *CellColumnRedaction*. It allows you to set the scope of the redaction to a specific worksheet and/or column. The options are:

*   optionally set worksheet name or its numeric index (if both are missing, redaction affects all worksheets)
*   optionally set column (all columns are used, if the column filter is not set)

If no filters are set, redactions affects the entire document. All indices are zero-based. Below is an example, where we use all filters, to redact second column with emails (e.g. loaded from database) on a worksheet "Customers", leaving untouched all other emails in the document:



```java
final Redactor redactor  = new Redactor("sample.xlsx");
try 
{
    CellFilter filter = new CellFilter();
    filter.setColumnIndex(1);
    filter.setWorkSheetName("Customers");
    Pattern expression = Pattern.compile("^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$");
    RedactorChangeLog result = redactor.apply(new CellColumnRedaction(filter, expression, new ReplacementOptions("[customer email]")));
    if (result.getStatus() != RedactionStatus.Failed)
    {
        SaveOptions so = new SaveOptions();
        so.setAddSuffix(true);
        so.setRasterizeToPDF(false);
        redactor.save(so);
    };
}
finally { redactor.close(); }
```

---

## Spreadsheet redactions

Path: /redaction/net/spreadsheet-redactions/

GroupDocs.Redaction allows to redact data of sensitive or private nature from your XLS, XLSX, ODS spreadsheet document formats and others. See full list at [supported document formats]({{< ref "redaction/net/getting-started/supported-document-formats.md" >}}) article.

## Filter by spreadsheet and column

If you have a document with one or more tables, organized into worksheets (one table per worksheet) - such as Microsoft Excel documents - you can use specific type of textual redactions, [CellColumnRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/cellcolumnredaction). It allows you to set the scope of the redaction to a specific worksheet and/or column. The options are:

*   optionally set worksheet name or its numeric index (if both are missing, redaction affects all worksheets)
*   optionally set column (all columns are used, if the column filter is not set)

If no filters are set, redactions affects the entire document. All indices are zero-based. Below is an example, where we use all filters, to redact second column with emails (e.g. loaded from database) on a worksheet "Customers", leaving untouched all other emails in the document:

**C#**

```csharp
using (Redactor redactor = new Redactor("D:\\Sales in September.xslx"))
{
   var filter = new CellFilter()
   {
      ColumnIndex = 1, // zero-based 2nd column
      WorkSheetName = "Customers"
   };
   var expression = new Regex("^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$");
   RedactorChangeLog changeLog = redactor.Apply(new CellColumnRedaction(filter, expression, new ReplacementOptions("[customer email]")));
   if (result.Status != RedactionStatus.Failed)
   {
      doc.Save(new SaveOptions() { AddSuffix = true });
   };
}
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Spreadsheet redactions

Path: /redaction/python-net/spreadsheet-redactions/

GroupDocs.Redaction allows to redact data of sensitive or private nature from your XLS, XLSX, ODS spreadsheet document formats and others. See full list at [supported document formats]({{< ref "redaction/python-net/getting-started/supported-document-formats.md" >}}) article.

## Redact spreadsheet content

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    repl_opt = grr.ReplacementOptions("-redacted-")
    ex_red = grr.ExactPhraseRedaction("John Doe", repl_opt)

    #Load the document to be redacted
    with gr.Redactor("source.xlsx") as redactor:

        #Apply the redaction
        result = redactor.apply(ex_red)

        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## eSign document with Stamp signature

Path: /signature/net/esign-document-with-stamp-signature/

## What is a Stamp signature?

A **stamp** signature is a special type of electronic signature that has the visual appearance of a round seal and its visual parameters can be set programmatically.
Every stamp signature can have multiple "stamp lines" with custom text and different line thicknesses, colors, font weights and sizes. Here is an example of how a stamp signature created with [**GroupDocs.Siganture**](https://products.groupdocs.com/signature/net) may look like:

![Stamp](/signature/net/images/esign-document-with-stamp-signature.png)

GroupDocs.Signature provides the [StampSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/stampsignoptions) class to specify different options for Stamp signature:

* Stamp type - Round or Square;
* Height and width in pixels;
* Alignment and position within the document page;
* and many more.

Each Stamp option contains inner and outer lines. Inner lines represent vertical lines inside the stamp, while outer lines represent circles (or rectangles based on stamp type) around the stamp with their own text, border settings, background etc.

Here are the steps to add a Stamp signature to a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [StampSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/stampsignoptions) object according to your requirements and specify appropriate options.
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [StampSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/stampsignoptions) to it.

## How to eSign document with Stamp signature

This example shows how to add a Stamp signature to a document.

```csharp
using (Signature signature = new Signature("sample.docx"))
{
    StampSignOptions options = new StampSignOptions()
    {
        // set stamp signature position
        Left = 100,
        Top = 100,
    };
    // setup first external line of Stamp
    StampLine outerLine = new StampLine();
    outerLine.Text = " * European Union * European Union  * European Union  *";
    outerLine.Font.FontSize = 12;
    outerLine.Height = 22;
    outerLine.TextBottomIntent = 6;
    outerLine.TextColor = Color.WhiteSmoke;
    outerLine.BackgroundColor = Color.DarkSlateBlue;
    options.OuterLines.Add(outerLine);
    //Inner square lines - horizontal lines inside the rings
    StampLine innerLine = new StampLine();
    innerLine.Text = "John";
    innerLine.TextColor = Color.MediumVioletRed;
    innerLine.Font.FontSize = 20;
    innerLine.Font.Bold = true;
    innerLine.Height = 40;
    options.InnerLines.Add(innerLine);

    signature.Sign("SampleSigned.docx", options);
}
```
### Summary
This guide explains how to apply stamp-based signatures to documents using [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) . It covers the process of creating a stamp signature, customizing its appearance, and positioning it on the document. The signed document can then be saved with the stamp signature applied.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign document with Stamp signature

Path: /signature/nodejs-java/esign-document-with-stamp-signature/

## What is a Stamp signature?

A **stamp** signature is a special type of electronic signature that has the visual appearance of a round seal and its visual parameters can be set programmatically.
Every stamp signature can have multiple "stamp lines" with custom text and different line thicknesses, colors, font weights and sizes. Here is an example of how a stamp signature created with [**GroupDocs.Siganture**](https://products.groupdocs.com/signature/nodejs-java) may look like:

![Stamp](/signature/nodejs-java/images/esign-document-with-stamp-signature.png)

GroupDocs.Signature provides the [StampSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/stampsignoptions) class to specify different options for Stamp signature:

* Stamp type - Round or Square;
* Height and width in pixels;
* Alignment and position within the document page;
* and many more.

Each Stamp option contains inner and outer lines. Inner lines represent vertical lines inside the stamp, while outer lines represent circles (or rectangles based on stamp type) around the stamp with their own text, border settings, background etc.

Here are the steps to add a Stamp signature to a document with GroupDocs.Signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [StampSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/stampsignoptions) object according to your requirements and specify appropriate options.
* Call the [Sign](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature/signature) class instance and pass the [StampSignOptions](https://reference.groupdocs.com/signature/nodejs-java/com.groupdocs.signature.options/stampsignoptions) to it.

## How to eSign document with Stamp signature

This example shows how to add a Stamp signature to a document.

```javascript
  // The path to the documents directory.
  const filePath = Constants.SAMPLE_PDF; // Assuming Constants.SAMPLE_PDF is defined elsewhere
  const fileName = path.basename(filePath);

  const outputFilePath = path.join(Constants.OutputPath, 'SignWithStamp', fileName);
  const signature = new signatureLib.Signature(filePath);

  // Create stamp sign options
  const options = new signatureLib.StampSignOptions();

  // Set stamp signature position
  options.setLeft(100);
  options.setTop(100);

  // Setup first external line of Stamp
  const outerLine = new signatureLib.StampLine();
  outerLine.setText(" * European Union * European Union  * European Union  * European Union  * European Union  * ");
  outerLine.getFont().setSize(12);
  outerLine.setHeight(22);
  outerLine.setTextBottomIntent(6);
  //outerLine.setTextColor(Color.WHITE);
  //outerLine.setBackgroundColor(Color.BLUE);
  options.getOuterLines().add(outerLine);

  // Inner square lines - horizontal lines inside the rings
  const innerLine = new signatureLib.StampLine();
  innerLine.setText("John");
  //innerLine.setTextColor(Color.RED);
  const signFont = new signatureLib.SignatureFont();
  signFont.setSize(20);
  signFont.setBold(true);
  innerLine.setFont(signFont);
  innerLine.setHeight(40);
  options.getInnerLines().add(innerLine);

  // Sign document to file
  signature.sign(outputFilePath, options);
  console.log(`\nSource document signed successfully.\nFile saved at ${outputFilePath}`);
```
### Summary
This guide explains how to apply stamp-based signatures to documents using [**GroupDocs.Signature**](https://products.groupdocs.com/signature/nodejs-java) . It covers the process of creating a stamp signature, customizing its appearance, and positioning it on the document. The signed document can then be saved with the stamp signature applied.



## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature Node.Js for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Synonym dictionary

Path: /search/java/synonym-dictionary/

The [SynonymDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SynonymDictionary) class is designed to store synonyms in an index. For information on searching using synonyms, see the [Synonym search]({{< ref "search/java/developer-guide/advanced-usage/searching/synonym-search.md" >}}) page.

To get the number of synonyms in the dictionary, use the [getCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SynonymDictionary#getCount()) method.

To add groups of synonyms to the dictionary, use the [addRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SynonymDictionary#addRange(java.lang.Iterable)) method.

The [clear](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SynonymDictionary#clear()) method is used to remove all synonyms from the dictionary.

The [getSynonyms](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SynonymDictionary#getSynonyms(java.lang.String)) method is used to get a list of synonyms for a given word.

The [getSynonymGroups](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SynonymDictionary#getSynonymGroups(java.lang.String)) method is used to get all synonym groups to which a given word belongs.

To get all synonym groups from the dictionary, use the [getAllSynonymGroups](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/SynonymDictionary#getAllSynonymGroups()) method.

To export synonyms to a file, use the [exportDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import synonyms from a file, use the [importDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the synonym dictionary.



```java
String indexFolder = "c:\\MyIndex\\";

// Creating an index from in specified folder
Index index = new Index(indexFolder);

// Creating an index in memory with default synonym dictionary
Index index = new Index();

// Getting synonyms for word 'make'
String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");
System.out.println("Synonyms for 'make':");
for (String synonym : synonyms) {
    System.out.println(synonym);
}

// Getting groups of synonyms to which word 'make' belongs to
String[][] groups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");
System.out.println("Synonym groups for 'make':");
for (String[] group : groups) {
    for (String group1 : group) {
        System.out.print(group1 + " ");
    }
    System.out.println();
}

if (index.getDictionaries().getSynonymDictionary().getCount() > 0) {
    // Removing all synonyms from the dictionary
    index.getDictionaries().getSynonymDictionary().clear();
}

// Adding synonyms to the dictionary
String[][] synonymGroups = new String[][] {
    new String[] { "achieve", "accomplish", "attain", "reach" },
    new String[] { "accept", "take", "have" },
};
index.getDictionaries().getSynonymDictionary().addRange(synonymGroups);

// Export synonyms to a file
index.getDictionaries().getSynonymDictionary().exportDictionary("C:\\Synonyms.dat");

// Import synonyms from a file
index.getDictionaries().getSynonymDictionary().importDictionary("C:\\Synonyms.dat");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Synonym dictionary

Path: /search/net/synonym-dictionary/

The [SynonymDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/synonymdictionary) class is designed to store synonyms in an index. For information on searching using synonyms, see the [Synonym search]({{< ref "search/net/developer-guide/advanced-usage/searching/synonym-search.md" >}}) page.

To get the number of synonyms in the dictionary, use the [Count](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/synonymdictionary/properties/count) property.

To add groups of synonyms to the dictionary, use the [AddRange](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/synonymdictionary/methods/addrange/index) method.

The [Clear](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/synonymdictionary/methods/clear) method is used to remove all synonyms from the dictionary.

The [GetSynonyms](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/synonymdictionary/methods/getsynonyms) method is used to get a list of synonyms for a given word.

The [GetSynonymGroups](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/synonymdictionary/methods/getsynonymgroups) method is used to get all synonym groups to which a given word belongs.

To get all synonym groups from the dictionary, use the [GetAllSynonymGroups](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/synonymdictionary/methods/getallsynonymgroups) method.

To export synonyms to a file, use the [ExportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/exportdictionary) method.

To import synonyms from a file, use the [ImportDictionary](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/dictionarybase/methods/importdictionary) method.

The following example demonstrates the use of methods of the synonym dictionary.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";

// Creating an index from in specified folder
Index index = new Index(indexFolder);

// Getting synonyms for word 'make'
string[] synonyms = index.Dictionaries.SynonymDictionary.GetSynonyms("make");
Console.WriteLine("Synonyms for 'make':");
for (int i = 0; i < synonyms.Length; i++)
{
    Console.WriteLine(synonyms[i]);
}

// Getting groups of synonyms to which word 'make' belongs to
string[][] groups = index.Dictionaries.SynonymDictionary.GetSynonymGroups("make");
Console.WriteLine("Synonym groups for 'make':");
for (int i = 0; i < groups.Length; i++)
{
    string[] group = groups[i];
    for (int j = 0; j < group.Length; j++)
    {
        Console.Write(group[j] + " ");
    }
    Console.WriteLine();
}

if (index.Dictionaries.SynonymDictionary.Count > 0)
{
    // Removing all synonyms from the dictionary
    index.Dictionaries.SynonymDictionary.Clear();
}

// Adding synonyms to the dictionary
string[][] synonymGroups = new string[][]
{
    new string[] { "achieve", "accomplish", "attain", "reach" },
    new string[] { "accept", "take", "have" },
};
index.Dictionaries.SynonymDictionary.AddRange(synonymGroups);

// Export synonyms to a file
index.Dictionaries.SynonymDictionary.ExportDictionary(@"C:\Synonyms.dat");

// Import synonyms from a file
index.Dictionaries.SynonymDictionary.ImportDictionary(@"C:\Synonyms.dat");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Synonym dictionary

Path: /search/nodejs-java/synonym-dictionary/

The [SynonymDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SynonymDictionary) class is designed to store synonyms in an index. For information on searching using synonyms, see the [Synonym search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/synonym-search.md" >}}) page.

To get the number of synonyms in the dictionary, use the [getCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SynonymDictionary#getCount()) method.

To add groups of synonyms to the dictionary, use the [addRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SynonymDictionary#addRange(java.lang.Iterable)) method.

The [clear](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SynonymDictionary#clear()) method is used to remove all synonyms from the dictionary.

The [getSynonyms](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SynonymDictionary#getSynonyms(java.lang.String)) method is used to get a list of synonyms for a given word.

The [getSynonymGroups](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SynonymDictionary#getSynonymGroups(java.lang.String)) method is used to get all synonym groups to which a given word belongs.

To get all synonym groups from the dictionary, use the [getAllSynonymGroups](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/SynonymDictionary#getAllSynonymGroups()) method.

To export synonyms to a file, use the [exportDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#exportDictionary(java.lang.String)) method.

To import synonyms from a file, use the [importDictionary](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/DictionaryBase#importDictionary(java.lang.String)) method.

The following example demonstrates the use of methods of the synonym dictionary.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index from in specified folder
const index = new groupdocs.search.Index(indexFolder, true);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Getting synonyms for word 'make'
const synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms('make');
console.log("Synonyms for 'make':");
for (const synonym of synonyms) {
  console.log(synonym);
}

// Getting groups of synonyms to which word 'make' belongs to
const groups = index.getDictionaries().getSynonymDictionary().getSynonymGroups('make');
console.log("Synonym groups for 'make':");
for (const group of groups) {
  for (const group1 of group) {
    console.log(group1 + ' ');
  }
  console.log();
}

if (index.getDictionaries().getSynonymDictionary().getCount() > 0) {
  // Removing all synonyms from the dictionary
  index.getDictionaries().getSynonymDictionary().clear();
}

// Adding synonyms to the dictionary
const synonymGroups = java.newInstanceSync('java.util.ArrayList');
synonymGroups.add(java.newArray('java.lang.String', ['achieve', 'accomplish', 'attain', 'reach']));
synonymGroups.add(java.newArray('java.lang.String', ['achieve', 'accept', 'take', 'have']));
synonymGroups.add(java.newArray('java.lang.String', ['improve', 'better']));
index.getDictionaries().getSynonymDictionary().addRange(synonymGroups);

// Export synonyms to a file
const fileName = Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/synonymDictionary/Synonyms.dat';
index.getDictionaries().getSynonymDictionary().exportDictionary(fileName);

// Import synonyms from a file
index.getDictionaries().getSynonymDictionary().importDictionary(fileName);

// Search in the index
const query = 'achieve';
const options = new groupdocs.search.SearchOptions();
options.setUseSynonymSearch(true); // Enabling synonym search
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with interpreted values

Path: /metadata/java/working-with-interpreted-values/

Sometimes it's not really obvious what a particular metadata property is supposed to mean. A good example of such vague property is a numeric flag or enumeration. For example, here is the description of the EXIF ExposureProgram tag taken from the official EXIF specification:

{{< alert style="info" >}}
The class of the program used by the camera to set exposure when the picture is taken. The tag values are as follows.

0 = Not defined

1 = Manual

2 = Normal program

3 = Aperture priority

4 = Shutter priority

5 = Creative program

6 = Action program

7 = Portrait mode

8 = Landscape mode

{{< /alert >}}

As you can see, all modes are represented by numeric values. If you are not familiar with the specification, you will get a hard time converting these bare numbers to something meaningful. This is where interpreted values come into play. They provide a user-friendly description of the original property value. The code snippet below demonstrates how to extract the ExposureProgram property and display its original value and interpreted value.

```java
try (Metadata metadata = new Metadata("D:\\input.heic"))
{
    IExif root = (IExif)metadata.getRootPackage();
    if (root.getExifPackage() != null)
    {
        TiffShortTag property = (TiffShortTag)root.getExifPackage().getExifIfdPackage().getByTiffTagID(TiffTagID.ExposureProgram);
        if (property != null)
        {
            System.out.println(property.getTagValue()[0]); // 2
            System.out.println(property.getInterpretedValue()); // Normal program
        }
    }
}
```

From release to release, we add interpreters to metadata properties extracted from various formats. To get a full list of properties having interpreted values for a particular file please use the below example:

**advanced_usage.WorkingWithInterpretedValues**

```java
public class WorkingWithInterpretedValues {
     public static void run() {
        File folder = new File(Constants.InputPath);
        for (File file : folder.listFiles()) {
            try (Metadata metadata = new Metadata(file.getAbsolutePath())) {
                if (metadata.getFileFormat() != FileFormat.Unknown && !metadata.getDocumentInfo().isEncrypted()) {
                    System.out.println();
                    System.out.println(file.getName());
                     
                    IReadOnlyList<MetadataProperty> properties = metadata.findProperties(
                            new WorkingWithInterpretedValues().new InterpretedValueIsNotNullSpecification());
                    for (MetadataProperty property : properties) {
                            System.out.println(property.getName());
                            System.out.println(property.getValue().getRawValue());
                            System.out.println(property.getInterpretedValue().getRawValue());
                    }
                }
            }
        }
    }
      
    private class InterpretedValueIsNotNullSpecification extends Specification {
        public boolean isSatisfiedBy(MetadataProperty candidate) {
            return candidate.getInterpretedValue() != null;
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with interpreted values

Path: /metadata/net/working-with-interpreted-values/

Sometimes it's not really obvious what a particular metadata property is supposed to mean. A good example of such vague property is a numeric flag or enumeration. For example, here is the description of the EXIF ExposureProgram tag taken from the official EXIF specification:

{{< alert style="info" >}}
The class of the program used by the camera to set exposure when the picture is taken. The tag values are as follows.

0 = Not defined

1 = Manual

2 = Normal program

3 = Aperture priority

4 = Shutter priority

5 = Creative program

6 = Action program

7 = Portrait mode

8 = Landscape mode

{{< /alert >}}

As you can see, all modes are represented by numeric values. If you are not familiar with the specification, you will get a hard time converting these bare numbers to something meaningful. This is where interpreted values come into play. They provide a user-friendly description of the original property value. The code snippet below demonstrates how to extract the ExposureProgram property and display its original value and interpreted value.


```csharp
using (Metadata metadata = new Metadata(@"D:\input.heic"))
{
    var root = (IExif)metadata.GetRootPackage();
    if (root.ExifPackage != null)
    {
        var property = root.ExifPackage.ExifIfdPackage[TiffTagID.ExposureProgram] as TiffShortTag;
        if (property != null)
        {
            Console.WriteLine(property.TagValue[0]); // 2
            Console.WriteLine(property.InterpretedValue); // Normal program
        }
    }
}
```

From release to release, we add interpreters to metadata properties extracted from various formats. To get a full list of properties having interpreted values for a particular file please use the below example:

**AdvancedUsage.WorkingWithInterpretedValues**

```csharp
foreach (string file in Directory.GetFiles(Constants.InputPath))
{
    using (Metadata metadata = new Metadata(file))
    {
        if (metadata.FileFormat != FileFormat.Unknown && !metadata.GetDocumentInfo().IsEncrypted)
        {
            Console.WriteLine();
            Console.WriteLine(file);
            var properties = metadata.FindProperties(p => p.InterpretedValue != null);
            foreach (var property in properties)
            {
                Console.WriteLine(property.Name);
                Console.WriteLine(property.Value.RawValue);
                Console.WriteLine(property.InterpretedValue.RawValue);
            }
        }
    }
}
```

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with interpreted values

Path: /metadata/nodejs-java/working-with-interpreted-values/

Sometimes it's not really obvious what a particular metadata property is supposed to mean. A good example of such vague property is a numeric flag or enumeration. 
From release to release, we add interpreters to metadata properties extracted from various formats. To get a full list of properties having interpreted values for a particular file please use the below example:

**advanced_usage.WorkingWithInterpretedValues**

{{< tabs "example1">}}
{{< tab "JavaScript" >}}
```js
const metadata = new groupdocs.metadata.Metadata(Constants.InputDoc);
    var properties = metadata.findProperties(new groupdocs.metadata.OfTypeSpecification(groupdocs.metadata.MetadataPropertyType.Integer));
      for(var i=0;i<properties.getCount(); i++){
        var property = properties.get_Item(i);
        if(property.getInterpretedValue() != null)
        {
          console.log(property.getName());
          console.log(property.getValue().getRawValue());
          console.log(property.getInterpretedValue().getRawValue());
        }
```
{{< /tab >}}
{{< /tabs >}}

## More resources

### Advanced usage topics

To learn more about library features and get familiar how to manage metadata and more, please refer to the[advanced usage section]({{< ref "metadata/nodejs-java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)

*   [GroupDocs.Metadata for Node.js via Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java)
    

### Free online document metadata management App

Along with a full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with interpreted values

Path: /metadata/python-net/working-with-interpreted-values/

Sometimes it's not really obvious what a particular metadata property is supposed to mean. A good example of such vague property is a numeric flag or enumeration. For example, here is the description of the EXIF ExposureProgram tag taken from the official EXIF specification:

{{< alert style="info" >}}
The class of the program used by the camera to set exposure when the picture is taken. The tag values are as follows.

0 = Not defined

1 = Manual

2 = Normal program

3 = Aperture priority

4 = Shutter priority

5 = Creative program

6 = Action program

7 = Portrait mode

8 = Landscape mode

{{< /alert >}}

As you can see, all modes are represented by numeric values. If you are not familiar with the specification, you will get a hard time converting these bare numbers to something meaningful. This is where interpreted values come into play. They provide a user-friendly description of the original property value. The code snippet below demonstrates how to extract the ExposureProgram property and display its original value and interpreted value.


```python
def run_single_file():
    with gm.Metadata(r"D:\\input.heic") as metadata:
        root = metadata.get_root_package()
        if hasattr(root, "exif_package") and root.exif_package is not None:
            prop = root.exif_package.exif_ifd_package[TiffTagID.EXPOSURE_PROGRAM]
            if prop is not None:
                print(prop.tag_value[0])  # e.g., 2
                print(prop.interpreted_value)  # e.g., Normal program
```


From release to release, we add interpreters to metadata properties extracted from various formats. To get a full list of properties having interpreted values for a particular file please use the below example:

**advanced_usage.working_with_interpreted_values**


```python
def run():
    files = os.listdir(constants.input_path)
    for file in files:
        full = constants.input_path + file
        with gm.Metadata(full) as metadata:
            if metadata.file_format != gm.common.FileFormat.UNKNOWN and metadata.get_document_info().is_encrypted != True:
                print()
                print(full)
                properties = metadata.find_properties(lambda p: p.interpreted_value is not None)
                for prop in properties:
                    print(prop.name)
                    print(prop.value.raw_value)
                    print(prop.interpreted_value.raw_value)
```


## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    
*   [GroupDocs.Metadata for Python via .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Python-via-.NET/)

### Free online document metadata management App
Along with full featured Python via .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).



---

## Working with metadata in PSD images

Path: /metadata/java/working-with-metadata-in-psd-images/

## Reading Photoshop Metadata properties

The GroupDocs Metadata API allows the user to read Adobe Photoshop metadata associated with a PSD image. For more information on the Photoshop file format and metadata blocks please refer to the specification: [https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/](https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/).

The code sample below demonstrates how to extract image resource blocks (building blocks of the Photoshop file format) from a PSD image.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PSD file
2.  Get the root metadata package
3.  Extract the [ImageResourcePackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ImageResourcePackage) instance and obtain a list of [ImageResourceBlock](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/ImageResourceBlock) objects
4.  Iterate trough the collection of resource blocks

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.psd.PsdReadImageResourceBlocks**

```csharp
try (Metadata metadata = new Metadata(Constants.PsdWithIrb)) {
	PsdRootPackage root = metadata.getRootPackageGeneric();
	if (root.getImageResourcePackage() != null) {
		for (ImageResourceBlock block : root.getImageResourcePackage().toList()) {
			System.out.println(block.getSignature());
			System.out.println(block.getID());
			System.out.println(block.getName());
			System.out.println(block.getData());
		}
	}
}
```

## Reading the image header and information about PSD layers

The GroupDocs.Metadata API also supports extracting some other format-specific information from PSD images.

The following are the steps to read the header of a PSD file and extract information about the PSD layers.

1.  [Load]({{< ref "metadata/java/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PSD image
2.  Get the root metadata package
3.  Extract  the native metadata package using the [PsdRootPackage.getPsdPackage](https://reference.groupdocs.com/metadata/java/com.groupdocs.metadata.core/PsdRootPackage#getPsdPackage()) method
4.  Read the PSD header and layer information

**advanced\_usage.managing\_metadata\_for\_specific\_formats.<WBR>image.psd.PsdReadNativeMetadataProperties**

```csharp
try (Metadata metadata = new Metadata(Constants.PsdWithIptc)) {
	PsdRootPackage root = metadata.getRootPackageGeneric();

	System.out.println(root.getPsdPackage().getChannelCount());
	System.out.println(root.getPsdPackage().getColorMode());
	System.out.println(root.getPsdPackage().getCompression());
	System.out.println(root.getPsdPackage().getPhotoshopVersion());

	for (PsdLayer layer : root.getPsdPackage().getLayers()) {
		System.out.println(layer.getName());
		System.out.println(layer.getBitsPerPixel());
		System.out.println(layer.getChannelCount());
		System.out.println(layer.getFlags());
		System.out.println(layer.getHeight());
		System.out.println(layer.getWidth());

		// ...
	}

	// ...
}
```

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in JPEG images. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in JPEG images. Please find appropriate code samples in the [Working with EXIF Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## Working with IPTC metadata

GroupDocs.Metadata for Java is also able to work with IPTC metadata in PSD images. Please find more information in the [Working with IPTC IIM Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-iptc-iim-metadata.md" >}}) section.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in PSD images

Path: /metadata/net/working-with-metadata-in-psd-images/

## Reading Photoshop Metadata properties

The GroupDocs Metadata API allows the user to read Adobe Photoshop metadata associated with a PSD image. For more information on the Photoshop file format and metadata blocks please refer to the specification: [https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/](https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/).

The code sample below demonstrates how to extract image resource blocks (building blocks of the Photoshop file format) from a PSD image.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PSD file
2.  Get the root metadata package
3.  Extract the [ImageResourcePackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/imageresourcepackage) instance and obtain a list of [ImageResourceBlock](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/imageresourceblock) objects
4.  Iterate trough the collection of resource blocks

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Psd.PsdReadImageResourceBlocks**

```csharp
using (Metadata metadata = new Metadata(Constants.PsdWithIrb))
{
	var root = metadata.GetRootPackage<PsdRootPackage>();
	if (root.ImageResourcePackage != null)
	{
		foreach (var block in root.ImageResourcePackage.ToList())
		{
			Console.WriteLine(block.Signature);
			Console.WriteLine(block.ID);
			Console.WriteLine(block.Name);
			Console.WriteLine(block.Data);
		}
	}
}
```

## Reading the image header and information about PSD layers

The GroupDocs.Metadata API also supports extracting some other format-specific information from PSD images.

The following are the steps to read the header of a PSD file and extract information about the PSD layers.

1.  [Load]({{< ref "metadata/net/developer-guide/advanced-usage/loading-files/_index.md" >}}) a PSD image
2.  Get the root metadata package
3.  Extract  the native metadata package using the [PsdRootPackage.PsdPackage](https://reference.groupdocs.com/net/metadata/groupdocs.metadata.formats.image/psdrootpackage/properties/psdpackage) property
4.  Read the PSD header and layer information

**AdvancedUsage.ManagingMetadataForSpecificFormats.<WBR>Image.Psd.PsdReadNativeMetadataProperties**

```csharp
using (Metadata metadata = new Metadata(Constants.PsdWithIptc))
{
	var root = metadata.GetRootPackage<PsdRootPackage>();

	Console.WriteLine(root.PsdPackage.ChannelCount);
	Console.WriteLine(root.PsdPackage.ColorMode);
	Console.WriteLine(root.PsdPackage.Compression);
	Console.WriteLine(root.PsdPackage.PhotoshopVersion);

	foreach (var layer in root.PsdPackage.Layers)
	{
		Console.WriteLine(layer.Name);
		Console.WriteLine(layer.BitsPerPixel);
		Console.WriteLine(layer.ChannelCount);
		Console.WriteLine(layer.Flags);
		Console.WriteLine(layer.Height);
		Console.WriteLine(layer.Width);

		// ...
	}

	// ...
}
```

## Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in PSD images. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in PSD images. Please find appropriate code samples in the [Working with EXIF metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## Working with IPTC metadata

GroupDocs.Metadata for .NET is also able to work with IPTC metadata in PSD images. Please find more information in the [Working with IPTC IIM metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-iptc-iim-metadata.md" >}}) section.

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## eSign Document with Multiple Signatures

Path: /signature/python-net/esign-document-with-multiple-signatures/

[**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net) allows signing a document with several signatures simultaneously and even apply signatures of different types to the same document.

Doing this is as simple as:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class and pass the source document path or stream as a constructor parameter.
* Instantiate all required sign options objects depending on signature type:
    * [BarcodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/barcodesignoptions) - for Barcode signatures;
    * [DigitalSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/digitalsignoptions/) - for Digital signatures;
    * [FormFieldSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/formfieldsignoptions) - for Form-field signatures;
    * [ImageSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/imagesignoptions) - for Image signatures;
    * [MetadataSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/metadatasignoptions) - for Metadata signatures;
    * [QrCodeSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/qrcodesignoptions) - for QR-code signatures
    * [StampSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/stampsignoptions) - for Stamp signatures;
    * [TextSignOptions](https://reference.groupdocs.com/signature/python-net/groupdocs.signature.options/textsignoptions) - for Text signatures.
* Fill the collection with sign options from the previous step.  
* Call the [Sign](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/python-net/groupdocs.signature/signature) class instance and pass the collection of sign options to it.

This code snippet below demonstrates how to eSign a PDF document with multiple signatures at the same time using Python:

{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSignOptions, BarcodeSignOptions, QrCodeSignOptions, DigitalSignOptions
from groupdocs.signature.domain import BarcodeTypes, QrCodeTypes
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Define text signature options
        text_options = TextSignOptions("This is test message")
        text_options.vertical_alignment = gsd.VerticalAlignment.TOP
        text_options.horizontal_alignment = gsd.HorizontalAlignment.LEFT
        
        # Define barcode signature options
        barcode_options = BarcodeSignOptions("123456")
        barcode_options.encode_type = BarcodeTypes.CODE_128
        barcode_options.left = 100
        barcode_options.top = 100
        
        # Define QR code signature options
        qrcode_options = QrCodeSignOptions("JohnSmith")
        qrcode_options.encode_type = QrCodeTypes.QR
        qrcode_options.left = 100
        qrcode_options.top = 200
        
        # Define digital signature options
        digital_options = DigitalSignOptions("./certificate.pfx")
        digital_options.image_file_path = "./signature.jpg"
        digital_options.vertical_alignment = gsd.VerticalAlignment.CENTER
        digital_options.horizontal_alignment = gsd.HorizontalAlignment.CENTER
        digital_options.password = "1234567890"
        
        # Define list of signature options
        list_options = [text_options, barcode_options, qrcode_options, digital_options]
        
        # Sign document
        sign.sign("./signed.pdf", list_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-multiple-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< tab "signature.jpg" >}}
{{< tab-text >}}
The following sample file is used in this example: [signature.jpg](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-multiple-signatures/signature.jpg)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Advanced Multiple Signatures Example

Here's a more advanced example showing how to add multiple signatures with different styles and positions:

{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
import groupdocs.signature as signature
from groupdocs.signature.options import TextSignOptions, ImageSignOptions, QrCodeSignOptions
from groupdocs.signature.domain import QrCodeTypes
import groupdocs.signature.domain as gsd
import sys 
import os

def run():
    with signature.Signature("./sample.pdf") as sign:
        # Create text signature options
        text_options = TextSignOptions("Approved by John Smith")
        text_options.font = gsd.SignatureFont()
        text_options.font.bold = True 
        text_options.font.size = 20.0
        text_options.font.family_name = "Arial"
        text_options.vertical_alignment = gsd.VerticalAlignment.TOP
        text_options.horizontal_alignment = gsd.HorizontalAlignment.RIGHT
        text_options.margin = gsd.Padding(10, 10, 0, 0)
        
        # Create image signature options
        image_options = ImageSignOptions("./stamp.png")
        image_options.width = 200
        image_options.height = 100
        image_options.vertical_alignment = gsd.VerticalAlignment.BOTTOM
        image_options.horizontal_alignment = gsd.HorizontalAlignment.LEFT
        image_options.margin = gsd.Padding(0, 0, 10, 10)
        
        # Create QR code signature options
        qrcode_options = QrCodeSignOptions("https://www.example.com/verify")
        qrcode_options.encode_type = QrCodeTypes.QR
        qrcode_options.width = 100
        qrcode_options.height = 100
        qrcode_options.vertical_alignment = gsd.VerticalAlignment.CENTER
        qrcode_options.horizontal_alignment = gsd.HorizontalAlignment.CENTER
        
        # Define list of signature options
        list_options = [text_options, image_options, qrcode_options]
        
        # Sign document
        sign.sign("./signed.pdf", list_options)
```

{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
The following sample file is used in this example: [sample.pdf](/signature/python-net/_sample_files/developer-guide/basic-usage/electronic-signature-types/esign-document-with-multiple-signatures/sample.pdf)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Summary
This guide demonstrates how to apply multiple types of electronic signatures (e.g., text, barcode, image) to a document using [**GroupDocs.Signature for Python via .NET**](https://products.groupdocs.com/signature/python-net). It explains how to combine different signature types, configure each one, and save the signed document with multiple signature styles.


## More Resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for Python via .NET examples](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Python-via-.NET)


### Free Online Apps

Along with the full-featured Python library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Sign document with Image signature - advanced

Path: /signature/net/sign-document-with-image-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) class to specify different options for Image signature as follow

* signature alignment ([HorizontalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/horizontalalignment), [VerticalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/verticalalignment))
* margins ([Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions/margin))
* additional extensions and appearances ([Extensions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/extensions), [Appearance](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions/appearance))

Here are the steps to add Image signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) object according to your requirements and specify image signature options.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to specify different Image signature options. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.xlsx"))
{
    ImageSignOptions options = new ImageSignOptions("sample.jpg")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // set signature alignment
        // when VerticalAlignment is set the Top coordinate will be ignored.
        // Use Margin properties Top, Bottom to provide vertical offset
        VerticalAlignment = Domain.VerticalAlignment.Top,
        // when HorizontalAlignment is set the Left coordinate will be ignored.
        // Use Margin properties Left, Right to provide horizontal offset
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Top = 20, Right = 20 },
        // set rotation
        RotationAngle = 45,
        // setup image additional appearance as Brightness and Border
        Appearance = new ImageAppearance()
        {
            Brightness = 0.9f          
        },
        Border = new Border()
        {
            Color = Color.DarkGreen,
            DashStyle = DashStyle.DashLongDashDot,
            Transparency = 0.5,
            Visible = true,
            Weight = 2
        }
    };

    // sign document to file
    SignResult signResult = signature.Sign("sgnedSample.xlsx", options);
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate image signatures and/or sign your files with them for free, you can use the [Generate Image](https://products.groupdocs.app/signature/generate/image) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## eSign document with multiple signatures

Path: /signature/java/esign-document-with-multiple-signatures/

[GroupDocs.Signature](https://products.groupdocs.com/signature/java) allows to sign document with several signatures simultaneously and even apply signatures of different types to the same document.   
Doing this is as simple as:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.    
*   Instantiate required all required sign options objects dependent on signature type:    
    *   [BarcodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/BarcodeSignOptions) - for Barcode signatures;
    *   [DigitalSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/DigitalSignOptions) - for Digital signatures;
    *   [FormFieldSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/FormFieldSignOptions) - for Form-field signatures;
    *   [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) - for Image signatures;
    *   [MetadataSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/MetadataSignOptions) - for Metadata signatures;
    *   [QrCodeSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/QrCodeSignOptions) - for QR-code signatures
    *   [StampSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/StampSignOptions) - for Stamp signatures;
    *   [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) - for Text signatures.
*   Fill collection with sign options from previous step.  
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20java.util.List)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass collection of sign options to it.
    
This code snippet below demonstrates how to eSign PDF document with multiple signatures at the same time.

```java
Signature signature = new Signature("sample.pdf");
// setup options with text of signature
// define several signature options of different types and settings
TextSignOptions textOptions = new TextSignOptions("This is test message");
textOptions.setVerticalAlignment(VerticalAlignment.Top);
textOptions.setHorizontalAlignment(HorizontalAlignment.Left);

BarcodeSignOptions barcodeOptions = new BarcodeSignOptions("123456");
barcodeOptions.setEncodeType(BarcodeTypes.Code128);
barcodeOptions.setLeft(100);
barcodeOptions.setTop(100);

QrCodeSignOptions qrcodeOptions = new QrCodeSignOptions("JohnSmith");
qrcodeOptions.setEncodeType(QrCodeTypes.QR);
qrcodeOptions.setLeft(100);
qrcodeOptions.setTop(200);

DigitalSignOptions digitalOptions = new DigitalSignOptions("certificate.pfx");
digitalOptions.setImageFilePath("sample.jpg");
digitalOptions.setVerticalAlignment(VerticalAlignment.Center);
digitalOptions.setHorizontalAlignment(HorizontalAlignment.Center);
digitalOptions.setPassword("1234567890");

// define list of signature options
List<SignOptions> listOptions = new ArrayList<SignOptions>();

listOptions.add(textOptions);
listOptions.add(barcodeOptions);
listOptions.add(qrcodeOptions);
listOptions.add(digitalOptions);

// sign document to file
signature.sign("signed.pdf", listOptions);
```

## More resources

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Add polyline annotation

Path: /annotation/java/add-polyline-annotation/

Polyline annotation allows you to draw shapes and freehand lines as shown in the picture below: 

![](/annotation/java/images/add-polyline-annotation.png)

You can use the following methods to set the properties of the [PolylineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation) class:

*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position on the page
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPenColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation/#setPenColor-java.lang.Integer-) defines the frame color
*   [setPenStyle()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation/#setPenStyle-java.lang.Byte-) defines the frame line style (solid, dash, dot etc.)
*   [setPenWidth()](https://reference.groupdocs.comhttps://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation/#setPenWidth-java.lang.Byte-) defines the frame line width in pixels
*   [setSvgPath()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation/#setSvgPath-java.lang.String-) defines the SVG path that describes shape

To add a polyline annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [PolylineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [PolylineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation) class.
4.  Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream. 

The following code snippet shows how to add [PolylineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/polylineannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding polyline annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");

try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of AreaAnnotation class and set options
    PolylineAnnotation polyline = new PolylineAnnotation();
    polyline.setBox(new Rectangle(250, 35, 102, 12));
    polyline.setCreatedOn(Calendar.getInstance().getTime());
    polyline.setMessage("This is polyline annotation");
    polyline.setOpacity(0.7);
    polyline.setPageNumber(0);
    polyline.setPenColor(65535);
    polyline.setPenStyle(PenStyle.Dot);
    polyline.setPenWidth((byte) 3);
    polyline.setReplies(replies);
    polyline.setSvgPath("M250.8280751173709,48.209295774647885l0.6986854460093896,0l0.6986854460093896,-1.3973708920187793l0.6986854460093896,0l0.6986854460093896,-1.3973708920187793l1.3973708920187793,-0.6986854460093896l0.6986854460093896,-0.6986854460093896l0.6986854460093896,0l2.096056338028169,-1.3973708920187793l3.493427230046948,-1.3973708920187793l0.6986854460093896,-0.6986854460093896l1.3973708920187793,-1.3973708920187793l0.6986854460093896,0l1.3973708920187793,-0.6986854460093896l0.6986854460093896,0l0.6986854460093896,-0.6986854460093896l0.6986854460093896,0l0.6986854460093896,0l0,-0.6986854460093896l0.6986854460093896,0l0.6986854460093896,0l1.3973708920187793,0l0,-0.6986854460093896l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l2.096056338028169,-0.6986854460093896l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l1.3973708920187793,0l1.3973708920187793,0l1.3973708920187793,0l2.096056338028169,0l5.589483568075117,0l1.3973708920187793,0l2.096056338028169,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l1.3973708920187793,0l1.3973708920187793,0l0.6986854460093896,0.6986854460093896l1.3973708920187793,0l2.096056338028169,1.3973708920187793l0.6986854460093896,0l0.6986854460093896,0l0,0.6986854460093896l1.3973708920187793,0l0.6986854460093896,0.6986854460093896l1.3973708920187793,0.6986854460093896l0,0.6986854460093896l0.6986854460093896,0l1.3973708920187793,0.6986854460093896l1.3973708920187793,0.6986854460093896l3.493427230046948,0.6986854460093896l1.3973708920187793,0.6986854460093896l2.096056338028169,0.6986854460093896l1.3973708920187793,0.6986854460093896l1.3973708920187793,0l1.3973708920187793,0.6986854460093896l0.6986854460093896,0l0.6986854460093896,0.6986854460093896l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l2.7947417840375586,0l1.3973708920187793,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l2.7947417840375586,0l0.6986854460093896,0l2.7947417840375586,0l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,-0.6986854460093896l0.6986854460093896,0");
    
    // Add annotation and save to file
    annotator.add(polyline);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add polyline annotation

Path: /annotation/net/add-polyline-annotation/

Polyline annotation allows you to draw shapes and freehand lines as shown in the picture below: 

![](/annotation/net/images/add-polyline-annotation.png)

You can specify the following properties of the [PolylineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/polylineannotation) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/box) defines the annotation position on the page
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/opacity) allows you to set the annotation opacity
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/pencolor) defines the frame color
*   [PenStyle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penstyle) defines the frame line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/penwidth) defines the frame line width in pixels
*   [SvgPath](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/polylineannotation/properties/svgpath) defines the SVG path that describes shape

To add a polyline annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [PolylineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/polylineannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [PolylineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/polylineannotation) class.
4.  Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream. 

The following code snippet shows how to add [PolylineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/polylineannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add polyline annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	PolylineAnnotation polyline = new PolylineAnnotation
    {
    	Box = new Rectangle(250, 35, 102, 12),
        CreatedOn = DateTime.Now,
        Message = "This is polyline annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = 65535,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
       },
       SvgPath = "M250.8280751173709,48.209295774647885l0.6986854460093896,0l0.6986854460093896,-1.3973708920187793l0.6986854460093896,0l0.6986854460093896,-1.3973708920187793l1.3973708920187793,-0.6986854460093896l0.6986854460093896,-0.6986854460093896l0.6986854460093896,0l2.096056338028169,-1.3973708920187793l3.493427230046948,-1.3973708920187793l0.6986854460093896,-0.6986854460093896l1.3973708920187793,-1.3973708920187793l0.6986854460093896,0l1.3973708920187793,-0.6986854460093896l0.6986854460093896,0l0.6986854460093896,-0.6986854460093896l0.6986854460093896,0l0.6986854460093896,0l0,-0.6986854460093896l0.6986854460093896,0l0.6986854460093896,0l1.3973708920187793,0l0,-0.6986854460093896l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l2.096056338028169,-0.6986854460093896l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l1.3973708920187793,0l1.3973708920187793,0l1.3973708920187793,0l2.096056338028169,0l5.589483568075117,0l1.3973708920187793,0l2.096056338028169,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l1.3973708920187793,0l1.3973708920187793,0l0.6986854460093896,0.6986854460093896l1.3973708920187793,0l2.096056338028169,1.3973708920187793l0.6986854460093896,0l0.6986854460093896,0l0,0.6986854460093896l1.3973708920187793,0l0.6986854460093896,0.6986854460093896l1.3973708920187793,0.6986854460093896l0,0.6986854460093896l0.6986854460093896,0l1.3973708920187793,0.6986854460093896l1.3973708920187793,0.6986854460093896l3.493427230046948,0.6986854460093896l1.3973708920187793,0.6986854460093896l2.096056338028169,0.6986854460093896l1.3973708920187793,0.6986854460093896l1.3973708920187793,0l1.3973708920187793,0.6986854460093896l0.6986854460093896,0l0.6986854460093896,0.6986854460093896l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l2.7947417840375586,0l1.3973708920187793,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l1.3973708920187793,0l0.6986854460093896,0l2.7947417840375586,0l0.6986854460093896,0l2.7947417840375586,0l1.3973708920187793,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,0l0.6986854460093896,-0.6986854460093896l0.6986854460093896,0"
    };
    annotator.Add(polyline);
    annotator.Save("result.pdf");
} 
```
{{< /tab >}}
{{< /tabs >}}
---

## Add text watermarks

Path: /viewer/java/add-text-watermark/

To add a watermark to the HTML/JPG/PNG/PDF output, follow these steps:

1. Create an instance of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class (or [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/), or [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/), or [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/));
2. Create a [Watermark](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/Watermark) object and populate its properties;
3. Call the [setWatermark](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewoptions/#setWatermark-com.groupdocs.viewer.options.Watermark-) method of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/HtmlViewOptions) (or [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/PngViewOptions), or [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/JpgViewOptions), or [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/PdfViewOptions)) class and specify the object created on step 2;
4. Call the [Viewer.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

The following code snippet shows how to apply the watermark to the output pages.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.Watermark;
// ...

try (Viewer viewer = new Viewer("sample.docx")) {
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
    // Add watermark.
    viewOptions.setWatermark(new Watermark("This is a watermark"));

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add text watermarks

Path: /viewer/net/add-text-watermark/

To add a watermark to the HTML/JPG/PNG/PDF output, follow these steps:

1. Create an instance of the [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) class (or [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions), or [JpgViewOption](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions), or [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions));
2. Create a [Watermark](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/watermark) object and populate its properties;
3. Assign the [Watermark](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/watermark) object to [HtmlViewOptions.Watermark](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewoptions/properties/watermark) (or [PngViewOptions.Watermark](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewoptions/properties/watermark), or [JpgViewOptions.](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewoptions/properties/watermark)[Watermark](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions), or [PdfViewOptions.Watermark](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/viewoptions/properties/watermark)) property;
4. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method.

The following code snippet shows how to apply the watermark to the output pages.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Add watermark
    viewOptions.Watermark = new Watermark("This is a watermark");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create an HTML file.
            Dim viewOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources   ()
            ' Add watermark
            viewOptions.Watermark = New Watermark("This is a watermark")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Add text watermarks

Path: /viewer/nodejs-java/add-text-watermark/

To add a watermark to the HTML/JPG/PNG/PDF output, follow these steps:

1. Create an instance of the [HtmlViewOptions](#) class (or [PngViewOptions](#), or [JpgViewOptions](#), or [PdfViewOptions](#));
2. Create a [Watermark](#) object and populate its properties;
3. Call the [setWatermark](#) method of the [HtmlViewOptions](#) (or [PngViewOptions](#), or [JpgViewOptions](#), or [PdfViewOptions](#)) class and specify the object created on step 2;
4. Call the [Viewer.view()](#) method.

The following code snippet shows how to apply the watermark to the output pages.

{{< tabs "add-text-watermark">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions, Watermark } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.docx")
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources("add-text-watermark/docx-to-html-watermark.html")
// Add watermark.
const watermark = new Watermark('This is a watermark')
viewOptions.setWatermark(watermark);
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/developer-guide/rendering-documents/add-text-watermark/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Add text watermarks

Path: /viewer/python-net/add-text-watermark/

To add a watermark to the HTML/JPG/PNG/PDF output, follow these steps:

1. Create an instance of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) class (or [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/), or [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/), or [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/));
2. Create a [Watermark](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/watermark/) object and populate its properties;
3. Call the [watermark](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/#properties) method of the [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) (or [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/), or [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/), or [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/)) class and specify the object created on step 2;
4. Call the [Viewer.view()](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

The following code snippet shows how to apply the watermark to the output pages.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, Watermark

def add_text_watermark():
    # Load document
    with Viewer("sample.docx") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("add_text_watermark/output-watermark.html")
        # Add watermark.
        viewOptions.watermark = Watermark("This is a watermark")
        viewer.view(viewOptions)

if __name__ == "__main__":
    add_text_watermark()
```
{{< /tab >}}
{{< tab "sample.docx" >}}
{{< tab-text >}}
`sample.docx` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/add-text-watermark/sample.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Agents and LLM integration

Path: /markdown/net/agents-and-llm-integration/


## AI agent and LLM friendly

GroupDocs.Markdown for .NET is designed to work seamlessly with AI agents, LLMs, and automated code generation tools. The library ships machine-readable documentation in multiple formats so that AI assistants can discover and use the API without manual guidance.

## MCP server

GroupDocs provides an [MCP (Model Context Protocol) server](https://docs.groupdocs.com/mcp) that enables LLMs to query the documentation on demand instead of loading it all at once. This saves tokens and lets your AI assistant fetch only the information it needs for the current task.

To connect your AI tool to the MCP server, add the GroupDocs endpoint to your MCP configuration:

{{< tabs "mcp-setup">}}
{{< tab "Claude Code / Claude Desktop" >}}
```json
// Claude Code:   ~/.claude/settings.json (or project .mcp.json)
// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "GitHub Copilot" >}}
```json
// .vscode/mcp.json in your project root
{
  "servers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "Cursor" >}}
```json
// .cursor/mcp.json in your project root
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "OpenCode" >}}
```json
// ~/.config/opencode/config.json
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "Generic MCP" >}}
```json
// Any MCP-compatible client
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< /tabs >}}

See [https://docs.groupdocs.com/mcp](https://docs.groupdocs.com/mcp) for full setup instructions and the list of available tools.

## Machine-readable documentation

Every documentation page is available as a plain Markdown file that AI tools can fetch and process directly:

| Resource | URL |
|---|---|
| Full documentation (single file) | `https://docs.groupdocs.com/markdown/net/llms-full.txt` |
| Full documentation (all products) | `https://docs.groupdocs.com/markdown/llms-full.txt` |
| Individual page (any page) | Append `.md` to the page URL, e.g. `https://docs.groupdocs.com/markdown/net.md` |
| Quick start guide | `https://docs.groupdocs.com/markdown/net/quick-start-guide.md` |

### How to use with AI tools

Point your AI assistant to the full documentation file for comprehensive context:

```
Fetch https://docs.groupdocs.com/markdown/net/llms-full.txt and use it
as a reference for GroupDocs.Markdown for .NET API.
```

Or reference individual pages for focused tasks:

```
Read https://docs.groupdocs.com/markdown/net/quick-start-guide.md
and help me convert a PDF to Markdown.
```

## Why Markdown output is ideal for AI pipelines

GroupDocs.Markdown converts documents into clean, structured Markdown — the preferred input format for LLMs and RAG systems:

- **Preserves document structure** — headings, lists, tables, and emphasis are retained as semantic markup
- **No binary noise** — unlike PDF or DOCX, Markdown is plain text that tokenizes efficiently
- **Chunk-friendly** — split by headings (`## `) for embedding and retrieval
- **Deterministic output** — same input always produces the same Markdown, enabling reliable pipelines

```csharp
using GroupDocs.Markdown;

// Convert any document to LLM-ready Markdown
var options = new ConvertOptions
{
    ImageExportStrategy = new SkipImagesStrategy(), // text-only for RAG
    Flavor = MarkdownFlavor.CommonMark
};

string markdown = MarkdownConverter.ToMarkdown("professional-services.pdf", options);

// Split into chunks by headings for embedding
string[] chunks = markdown.Split(
    new[] { "\n## ", "\n# " },
    StringSplitOptions.RemoveEmptyEntries);
```

## See also

- [Convert documents for RAG pipelines]({{< ref "markdown/net/developer-guide/use-cases/convert-for-rag" >}})
- [API Reference](https://reference.groupdocs.com/markdown/net)

---

## Agents and LLM integration

Path: /markdown/python-net/agents-and-llm-integration/


## AI agent and LLM friendly

GroupDocs.Markdown for Python via .NET is designed to work seamlessly with AI agents, LLMs, and automated code generation tools. The library ships machine-readable documentation in multiple formats — including an `AGENTS.md` file inside the pip package itself — so that AI assistants can discover and use the API without manual guidance.

## MCP server

GroupDocs provides an [MCP (Model Context Protocol) server](https://docs.groupdocs.com/mcp) that enables LLMs to query the documentation on demand instead of loading it all at once. This saves tokens and lets your AI assistant fetch only the information it needs for the current task.

To connect your AI tool to the MCP server, add the GroupDocs endpoint to your MCP configuration:

{{< tabs "mcp-setup">}}
{{< tab "Claude Code / Claude Desktop" >}}
```json
// Claude Code:   ~/.claude/settings.json (or project .mcp.json)
// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "GitHub Copilot" >}}
```json
// .vscode/mcp.json in your project root
{
  "servers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "Cursor" >}}
```json
// .cursor/mcp.json in your project root
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "OpenCode" >}}
```json
// ~/.config/opencode/config.json
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< tab "Generic MCP" >}}
```json
// Any MCP-compatible client
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```
{{< /tab >}}
{{< /tabs >}}

See [https://docs.groupdocs.com/mcp](https://docs.groupdocs.com/mcp) for full setup instructions and the list of available tools.

## AGENTS.md — built into the package

The `groupdocs-markdown-net` pip package includes an `AGENTS.md` file at `groupdocs/markdown/AGENTS.md`. AI coding assistants that scan installed packages (such as Claude Code, Cursor, GitHub Copilot) can automatically discover the API surface, usage patterns, and troubleshooting tips.

After installing the package, you can find it at:

```bash
pip show -f groupdocs-markdown-net | grep AGENTS
```

## Machine-readable documentation

Every documentation page is available as a plain Markdown file that AI tools can fetch and process directly:

| Resource | URL |
|---|---|
| Full documentation (single file) | `https://docs.groupdocs.com/markdown/python-net/llms-full.txt` |
| Full documentation (all products) | `https://docs.groupdocs.com/markdown/llms-full.txt` |
| Individual page (any page) | Append `.md` to the page URL, e.g. `https://docs.groupdocs.com/markdown/python-net.md` |
| Quick start guide | `https://docs.groupdocs.com/markdown/python-net/quick-start-guide.md` |

### How to use with AI tools

Point your AI assistant to the full documentation file for comprehensive context:

```
Fetch https://docs.groupdocs.com/markdown/python-net/llms-full.txt and use it
as a reference for GroupDocs.Markdown for Python via .NET API.
```

Or reference individual pages for focused tasks:

```
Read https://docs.groupdocs.com/markdown/python-net/quick-start-guide.md
and help me convert a PDF to Markdown.
```

## Why Markdown output is ideal for AI pipelines

GroupDocs.Markdown converts documents into clean, structured Markdown — the preferred input format for LLMs and RAG systems:

- **Preserves document structure** — headings, lists, tables, and emphasis are retained as semantic markup
- **No binary noise** — unlike PDF or DOCX, Markdown is plain text that tokenizes efficiently
- **Chunk-friendly** — split by headings (`## `) for embedding and retrieval
- **Deterministic output** — same input always produces the same Markdown, enabling reliable pipelines

```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, SkipImagesStrategy, MarkdownFlavor

# Convert any document to LLM-ready Markdown
options = ConvertOptions()
options.image_export_strategy = SkipImagesStrategy()  # text-only for RAG
options.flavor = MarkdownFlavor.COMMON_MARK

md = MarkdownConverter.to_markdown("business-plan.pdf", convert_options=options)

# Split into chunks by headings for embedding
import re
chunks = re.split(r'\n#{1,2} ', md)
```

## AGENTS.md reference

The content below is the same `AGENTS.md` file that ships inside the `groupdocs-markdown-net` package. Copy it into your project as `AGENTS.md` or point your AI assistant to this page.

````markdown
# GroupDocs.Markdown for Python via .NET -- AGENTS.md

> Instructions for AI agents working with this package.

Convert documents to/from Markdown -- DOCX, PDF, XLSX, EPUB, HTML and 20+ formats.

## Install

```bash
pip install groupdocs-markdown-net
```

**Python**: 3.5 - 3.14 | **Platforms**: Windows, Linux, macOS

## Resources

| Resource | URL |
|---|---|
| Documentation | https://docs.groupdocs.com/markdown/python-net/ |
| LLM-optimized docs | https://docs.groupdocs.com/markdown/python-net/llms-full.txt |
| API reference | https://reference.groupdocs.com/markdown/python-net/ |
| Code examples | https://docs.groupdocs.com/markdown/python-net/developer-guide/ |
| Release notes | https://releases.groupdocs.com/markdown/python-net/release-notes/ |
| PyPI | https://pypi.org/project/groupdocs-markdown-net/ |
| Free support forum | https://forum.groupdocs.com/c/markdown/ |
| Temporary license | https://purchase.groupdocs.com/temporary-license |

## MCP Server

Connect your AI tool to the GroupDocs documentation server for on-demand API lookups:

```json
{
  "mcpServers": {
    "groupdocs-docs": {
      "url": "https://docs.groupdocs.com/mcp"
    }
  }
}
```

Works with Claude Code (`~/.claude/settings.json`), Cursor (`.cursor/mcp.json`), VS Code Copilot (`.vscode/mcp.json`), and any MCP-compatible client.

## Imports

```python
from groupdocs.markdown import License, ConvertOptions, ConvertResult, CustomImageSavingArgs, CustomImagesStrategy, CustomUriExportStrategy, DefaultUriExportStrategy, DocumentInfo, ExportImagesAsBase64Strategy, ExportImagesToFileSystemStrategy, ExportOptions, FileFormat, LoadOptions, MarkdownConverter, MarkdownFlavor, SkipImagesStrategy, UriSavingArgs, DocumentProtectedException
```

## Quick Start

```python
from groupdocs.markdown import MarkdownConverter

# Convert to string
md = MarkdownConverter.to_markdown("report.docx")
print(md)

# Save to file
MarkdownConverter.to_file("report.docx", "report.md")
```

## With Options

```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, LoadOptions

load_opts = LoadOptions()
load_opts.password = "secret"

options = ConvertOptions()
options.heading_level_offset = 1
options.include_front_matter = True

md = MarkdownConverter.to_markdown("document.docx",
    load_options=load_opts, convert_options=options)
```

## Instance API

```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, SkipImagesStrategy

with MarkdownConverter("document.docx") as converter:
    options = ConvertOptions()
    options.image_export_strategy = SkipImagesStrategy()
    result = converter.convert(convert_options=options)
    if result.is_success:
        print(result.content)
```

## Image Strategies

```python
from groupdocs.markdown import ConvertOptions, SkipImagesStrategy
from groupdocs.markdown import ExportImagesToFileSystemStrategy, ExportImagesAsBase64Strategy

options = ConvertOptions()
options.image_export_strategy = SkipImagesStrategy()                        # skip
options.image_export_strategy = ExportImagesToFileSystemStrategy("./images") # to dir
options.image_export_strategy = ExportImagesAsBase64Strategy()               # embed
```

## Custom Image Handler (Callback)

```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, CustomImagesStrategy

counter = [0]
def rename_handler(call_info):
    ctx = call_info["context"]  # keys: ImageFileName, ShapeType, OutputDirectory
    counter[0] += 1
    return {"output_image_file_name": f"fig-{counter[0]}.png"}

options = ConvertOptions()
options.image_export_strategy = CustomImagesStrategy("./images", rename_handler)
MarkdownConverter.to_file("document.docx", "output.md", convert_options=options)
```

## URI Rewriting (Callback)

```python
from groupdocs.markdown import (MarkdownConverter, ConvertOptions,
    ExportImagesToFileSystemStrategy, CustomUriExportStrategy)

def cdn_handler(call_info):
    name = call_info["context"]["ResourceFileName"]  # keys: ResourceFileName, ResourceFileUri
    return {"resource_file_uri": f"https://cdn.example.com/{name}"}

options = ConvertOptions()
options.image_export_strategy = ExportImagesToFileSystemStrategy("./images")
options.uri_export_strategy = CustomUriExportStrategy(cdn_handler)
MarkdownConverter.to_file("document.docx", "output.md", convert_options=options)
```

## Get Document Info

```python
info = MarkdownConverter.get_info("document.docx")
print(f"Format: {info.file_format}, Pages: {info.page_count}")
```

## Convert from Markdown

```python
from groupdocs.markdown import MarkdownConverter
MarkdownConverter.from_markdown("input.md", "output.pdf")
MarkdownConverter.from_markdown("input.md", "output.docx")
```

## Licensing

```python
from groupdocs.markdown import License

# From file
License().set_license("path/to/license.lic")

# From stream
with open("license.lic", "rb") as f:
    License().set_license(f)
```

Or auto-apply: `export GROUPDOCS_LIC_PATH="path/to/license.lic"`

**Evaluation**: works without a license with limitations (page/document count cap, evaluation mark in output). Get a free 30-day full license: https://purchase.groupdocs.com/temporary-license

## API Reference

### MarkdownConverter

| Method | Returns | Description |
|---|---|---|
| `__init__(source_path)` | | Constructor |
| `convert_async()` | `Task[ConvertResult]` |  |
| `get_document_info_async()` | `Task[DocumentInfo]` |  |
| `convert()` | `ConvertResult` |  |
| `get_document_info()` | `DocumentInfo` |  |
| `to_markdown_async(source_path)` | `Task[str]` | static |
| `to_file_async(source_path, output_path, convert_options)` | `Task` | static |
| `get_info_async(source_path, load_options)` | `Task[DocumentInfo]` | static |
| `to_markdown(source_path)` | `str` | static |
| `to_file(source_path, output_path)` | `None` | static |
| `get_info(source_path)` | `DocumentInfo` | static |
| `get_supported_formats()` | `IReadOnlyList[FileFormat]` | static |
| `from_markdown(markdown_path, output_path)` | `None` | static |
| `from_markdown_string(markdown_content, output_path, options)` | `None` | static |

### ConvertOptions

| Property | Type | Writable |
|---|---|---|
| `image_export_strategy` | `IImageExportStrategy` | yes |
| `uri_export_strategy` | `IUriExportStrategy` | yes |
| `page_numbers` | `Int32[]` | yes |
| `heading_level_offset` | `int` | yes |
| `include_front_matter` | `bool` | yes |
| `flavor` | `MarkdownFlavor` | yes |
| `max_columns` | `int` | yes |
| `max_rows` | `int` | yes |
| `sheet_separator` | `str` | yes |
| `include_hidden_sheets` | `bool` | yes |

### LoadOptions

| Property | Type | Writable |
|---|---|---|
| `password` | `str` | yes |
| `file_format` | `FileFormat` | read-only |

### ExportOptions

| Property | Type | Writable |
|---|---|---|
| `format` | `FileFormat` | yes |

### ConvertResult

| Property | Type | Writable |
|---|---|---|
| `is_success` | `bool` | read-only |
| `error_message` | `str` | read-only |
| `content` | `str` | read-only |
| `exception` | `Exception` | read-only |
| `warnings` | `IReadOnlyList[str]` | read-only |

### DocumentInfo

| Property | Type | Writable |
|---|---|---|
| `file_format` | `FileFormat` | read-only |
| `page_count` | `int` | read-only |
| `title` | `str` | read-only |
| `author` | `str` | read-only |
| `is_encrypted` | `bool` | read-only |

### Callback Response Keys

| Handler | Key | Effect |
|---|---|---|
| `CustomImagesStrategy` | `output_image_file_name` | Override file name |
| `CustomImagesStrategy` | `replacement_image_path` | Replace image content |
| `CustomUriExportStrategy` | `resource_file_uri` | Override URI in output |

Return `None` to keep defaults. Exceptions preserve original Python type.

## Key Patterns

- **Properties**: use `snake_case` -- auto-mapped to .NET `PascalCase`
- **Context managers**: `with MarkdownConverter(...) as x:` ensures resources are released
- **Streams**: pass `open("file", "rb")` or `io.BytesIO(data)` where .NET expects Stream
- **Enums**: case-insensitive, lazy-loaded (e.g., `FileType.DOCX`)
- **Callbacks**: pass Python functions directly where .NET expects handler interfaces

## Troubleshooting

**`DllNotFoundException: libSkiaSharp`** -- stale system copy conflicts with bundled version. Rename it: `sudo mv /usr/local/lib/libSkiaSharp.dylib /usr/local/lib/libSkiaSharp.dylib.bak`

**`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT` errors** -- do NOT set this. Install ICU: `sudo apt install libicu-dev`

**`TypeLoadException`** -- reinstall: `pip install --force-reinstall groupdocs-markdown-net`

**Still stuck?** Post your question at https://forum.groupdocs.com/c/markdown/ -- the development team responds directly.
````

## See also

- [Convert documents for RAG pipelines]({{< ref "markdown/python-net/developer-guide/use-cases/convert-for-rag" >}})
- [API Reference](https://reference.groupdocs.com/markdown/python-net)

---

## Convert to XML or JSON data with advanced options

Path: /conversion/java/convert-to-data-with-advanced-options/

[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) enables converting documents to web data formats such as JSON and XML with advanced customization options through the [WebConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webconvertoptions/) class. This class allows precise control over the conversion process, including specifying the output format via the [setFormat](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/convertoptions/#setFormat-com.groupdocs.conversion.filetypes.FileType-) method.

## Supported Formats
The conversion supports multiple web data formats. To convert documents into JSON or XML, you must set the `Format` property to either `WebFileType.Json` or `WebFileType.Xml`.

## Convert CSV to JSON
Below is a code example demonstrating how to convert a CSV file to JSON format using

{{< tabs "code-example">}}
{{< tab "ConvertCsvToJson.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WebConvertOptions;
import com.groupdocs.conversion.filetypes.WebFileType;

public class ConvertCsvToJson {
    public static void convert() {
        // Initialize the Converter for the input file
        try(Converter converter = new Converter("sample.csv") {
            // Set up WebConvertOptions with JSON format
            WebConvertOptions options = new WebConvertOptions();
            options.setFormat(WebFileType.Json);

            // Perform the conversion
            converter.convert("converted.json", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.csv" >}}  
{{< tab-text >}}
`sample.csv` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-data-with-advanced-options/sample.csv) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.json" >}}  
{{< tab-text >}}
`converted.json` is converted JSON file. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-to-html-with-advanced-options/converted.json) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

By utilizing these options, you can generate tailored XML or JSON outputs suitable for integration with other systems or APIs.
---

## Convert to XML or JSON data with advanced options

Path: /conversion/net/convert-to-data-with-advanced-options/

GroupDocs.Conversion provides the [WebConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions/) class to give you control over the conversion result while converting to JSON, XML or other web data formats. To convert your document to XML or JSON format, specify the desired format using the [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) property.

The following code snippet shows how to convert a CSV spreadsheet to JSON format:

```csharp
using (Converter converter = new Converter("sample.csv"))
{
    WebConvertOptions options = new WebConvertOptions
    {
        Format = WebFileType.Json
    };
    converter.Convert("converted.json", options);
}
```

---

## Extract data from attachments and ZIP archives

Path: /parser/java/extract-data-from-attachments-and-zip-archives/

It is easy to extract data, text, images and use any GroupDocs.Parser feature for ZIP-archived documents. The same feature allows to get attachments from PDF and Emails and extract data from them.

# Extract data from attachments and ZIP archives

To extract documents from ZIP files and get attachments from containers simply call the [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method:

```java
Iterable<ContainerItem> getContainer();
```

This method returns a collection of [ContainerItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem) objects:

| Member | Description |
| --- | --- |
| [getName](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getName()) | The name of the item. |
| [getDirectory](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getDirectory()) | The directory of the item. |
| [getFilePath](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getFilePath()) | The full path of the item. |
| [getSize](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getSize()) | The size of the item in bytes. |
| [getMetadata](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#getMetadata()) | The collection of item metadata. |
| [detectFileType(FileTypeDetectionMode)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.data/ContainerItem#detectFileType(com.groupdocs.parser.options.FileTypeDetectionMode)) | Detects a file type of the container item. |
| [openStream](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openStream()) | Opens the stream of the item content. |
| [openParser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openParser()) | Creates the Parser object for the item content. |
| [openParser(LoadOptions)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openParser(com.groupdocs.parser.options.LoadOptions)) | Creates the Parser object for the item content with [LoadOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions). |
| [openParser(LoadOptions, ParserSettings)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/ContainerItem#openParser(com.groupdocs.parser.options.LoadOptions,%20com.groupdocs.parser.options.ParserSettings)) | Creates the Parser object for the item content with [LoadOptions](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/LoadOptions) and [ParserSettings](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ParserSettings). |

Container represents both container-only files (like zip archives, outlook storage) and documents with attachments (like emails, PDF Portfolios).

Here are the steps to extract a text from from zip entities:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getContainer](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getContainer()) method and obtain collection of document container item objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and obtain [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object to extract a text.

The following example shows how to extract a text from from zip entities:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleZip)) {
    // Extract attachments from the container
    Iterable<ContainerItem> attachments = parser.getContainer();
    // Check if container extraction is supported
    if (attachments == null) {
        System.out.println("Container extraction isn't supported");
    }
    // Iterate over zip entities
    for (ContainerItem item : attachments) {
        // Print the file path
        System.out.println(item.getFilePath());
        try {
            // Create Parser object for the zip entity content
            try (Parser attachmentParser = item.openParser()) {
                // Extract an zip entity text
                try (TextReader reader = attachmentParser.getText()) {
                    System.out.println(reader == null ? "No text" : reader.readToEnd());
                }
            }
        } catch (UnsupportedDocumentFormatException ex) {
            System.out.println("Isn't supported.");
        }
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract data from attachments and ZIP archives

Path: /parser/net/extract-data-from-attachments-and-zip-archives/

It is easy to extract data, text, images and use any GroupDocs.Parser feature for ZIP-archived documents. The same feature allows to get attachments from  PDF and Emails and extract data from them.

# Extract data from attachments and ZIP archives

To extract documents from ZIP files and get attachments from containers simply call the [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method:

```csharp
IEnumerable<ContainerItem> GetContainer()

```

This method returns a collection of [ContainerItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem) objects:

| Member | Description |
| --- | --- |
| [Name](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/name) | The name of the item. |
| [Directory](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/directory) | The directory of the item. |
| [FilePath](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/filepath) | The full path of the item. |
| [Size](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/size) | The size of the item in bytes. |
| [Metadata](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/properties/metadata) | The collection of item metadata. |
| Stream [OpenStream()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/methods/openstream) | Opens the stream of the item content. |
| Parser [OpenParser()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/containeritem/methods/openparser) | Creates the Parser object for the item content. |
| Parser [OpenParser(LoadOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.containeritem/openparser/methods/1) | Creates the Parser object for the item content with [LoadOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions). |
| Parser [OpenParser(LoadOptions, ParserSettings)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data.containeritem/openparser/methods/2) | Creates the Parser object for the item content with [LoadOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/loadoptions) and [ParserSettings](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/parsersettings). |

Container represents both container-only files (like zip archives, outlook storage) and documents with attachments (like emails, PDF Portfolios).

Here are the steps to extract an email text from outlook storage:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetContainer](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/getcontainer) method and obtain collection of document container item objects;
*   Check if *collection* isn't *null* (container extraction is supported for the document);
*   Iterate through the collection and obtain [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object to extract a text.

The following example shows how to extract a text from zip entities:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract attachments from the container
    IEnumerable<ContainerItem> attachments = parser.GetContainer();
    // Check if container extraction is supported
    if (attachments == null)
    {
        Console.WriteLine("Container extraction isn't supported");
    }
    // Iterate over zip entities
    foreach (ContainerItem item in attachments)
    {
        // Print the file path
        Console.WriteLine(item.FilePath);
        try
        {
            // Create Parser object for the zip entity content
            using (Parser attachmentParser = item.OpenParser())
            {
                // Extract a zip entity text
                using (TextReader reader = attachmentParser.GetText())
                {
                    Console.WriteLine(reader == null ? "No text" : reader.ReadToEnd());
                }
            }
        }
        catch (UnsupportedDocumentFormatException)
        {
            Console.WriteLine("Isn't supported.");
        }
    }
}
```

## More resources

### Advanced usage topics

To learn more how to work with attachments and ZIP archives, please refer the [advanced help section]({{< ref "parser/net/developer-guide/advanced-usage/working-with-zip-archives-and-attachments/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract text, metadata and images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).

---

## Extract Data from Attachments and ZIP Archives

Path: /parser/python-net/extract-data-from-attachments-and-zip-archives/


Use container extraction to open archive-like formats (ZIP, RAR, TAR), Outlook stores (PST/OST), PDF portfolios, and email attachments, then parse their contents.

## Extract and parse attachments
{{< tabs "example-1" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.exceptions import UnsupportedDocumentFormatException

with Parser("./archive.zip") as parser:
    attachments = parser.get_container()
    if attachments is None:
        print("Container extraction isn't supported for this format.")
    else:
        for item in attachments:
            print(item.file_path)
            try:
                with item.open_parser() as attachment_parser:
                    reader = attachment_parser.get_text()
                    print(reader if reader else "No text available.")
            except Exception as e:
                print(e)
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-data-from-attachments-and-zip-archives/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Steps

1. Instantiate `Parser` for the container file.  
2. Call `get_container()` to list `ContainerItem` entries.  
3. For each item, use `open_parser()` to create a `Parser` over the embedded content and reuse standard extraction methods (`get_text`, `get_images`, `get_metadata`, etc.).  
4. Handle unsupported formats with `UnsupportedDocumentFormatException`.

For working with attachments in complex scenarios (nested containers, load options), see the [advanced containers guide]({{< ref "parser/python-net/developer-guide/advanced-usage/working-with-archives/_index.md" >}}).
---
id: extract-data-from-attachments-and-zip-archives
url: parser/python-net/extract-data-from-attachments-and-zip-archives
title: Extract Data from Attachments and ZIP Archives
weight: 9
version: 25.12
description: "Work with containers such as ZIP archives, email stores, and PDF portfolios using GroupDocs.Parser for Python via .NET."
productName: GroupDocs.Parser for Python via .NET
hideChildren: false
toc: true
tags: python, parser, attachments, zip, container, v25.12
---

Use container extraction to open archive-like formats (ZIP, RAR, TAR), Outlook stores (PST/OST), PDF portfolios, and email attachments, then parse their contents.

## Extract and parse attachments
{{< tabs "example-2" >}}
{{< tab "Python" >}}

```python
from groupdocs.parser import Parser
from groupdocs.parser.exceptions import UnsupportedDocumentFormatException

with Parser("./archive.zip") as parser:
    attachments = parser.get_container()
    if attachments is None:
        print("Container extraction isn't supported for this format.")
    else:
        for item in attachments:
            print(item.file_path)
            try:
                with item.open_parser() as attachment_parser:
                    reader = attachment_parser.get_text()
                    print(reader if reader else "No text available.")
            except UnsupportedDocumentFormatException:
                print("Item format is not supported.")
```

{{< /tab >}}
{{< tab "archive.zip" >}}
{{< tab-text >}}
The following sample file is used in this example: [archive.zip](/parser/python-net/_sample_files/developer-guide/basic-usage/extract-data-from-attachments-and-zip-archives/archive.zip)
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Steps

1. Instantiate `Parser` for the container file.  
2. Call `get_container()` to list `ContainerItem` entries.  
3. For each item, use `open_parser()` to create a `Parser` over the embedded content and reuse standard extraction methods (`get_text`, `get_images`, `get_metadata`, etc.).  
4. Handle unsupported formats with `UnsupportedDocumentFormatException`.

For working with attachments in complex scenarios (nested containers, load options), follow the `.NET` [advanced container guide]({{< ref "parser/net/developer-guide/advanced-usage/working-with-zip-archives-and-attachments/_index.md" >}}); the same workflow applies in Python.




---

## Extract text by table of contents item

Path: /parser/java/extract-text-by-table-of-contents-item/

GroupDocs.Parser provides the functionality to extract a text by an item of table of contents. This feature is supported for Word Processing, PDF, ePUB and CHM documents (for more details, see [Supported Document Formats]({{< ref "parser/java/getting-started/supported-document-formats.md" >}})).

Text is extracted by [extractText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem#extractText()) method:

```java
// Print the text of the chapter
try(TextReader reader = tocItem.extractText()) {
    System.out.println("----");
    System.out.println(reader.ReadToEnd());
}
```

This method returns a text from the chapter to which table of contents item refers (without sub-chapters). For example, "Heading 1.2" from the page

![](/parser/java/images/extract-text-by-table-of-contents-item.png)

returns the following text:

![](/parser/java/images/extract-text-by-table-of-contents-item_1.png)

"Heading 2" from the page:

![](/parser/java/images/extract-text-by-table-of-contents-item_2.png)

returns the following text:

![](/parser/java/images/extract-text-by-table-of-contents-item_3.png)

{{< alert style="warning" >}}
*[java.lang.UnsupportedOperationException](https://docs.oracle.com/javase/7/docs/api/java/lang/UnsupportedOperationException.html)* is thrown if [getPageIndex](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem#getPageIndex()) is *null*.
{{< /alert >}}

Here are the steps to extract a text by an item of table of contents:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method and obtain the collection of [TocItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem "class in com.groupdocs.parser.data") objects;
*   Check if collection isn't *null* (table of contents extraction is supported for the document);
*   Iterate through the *collection* and extract a text

The following example shows how to extract a text by an item of table of contents:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleDocxWithToc)) {
    // Get table of contents
    Iterable<TocItem> tocItems = parser.getToc();
    // Check if toc extraction is supported
    if (tocItems == null) {
        System.out.println("Table of contents extraction isn't supported");
    }
    // Iterate over items
    for (TocItem tocItem : tocItems) {
        // Print the text of the chapter
        try (TextReader reader = tocItem.extractText()) {
            System.out.println("----");
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract text by table of contents item

Path: /parser/net/extract-text-by-table-of-contents-item/

GroupDocs.Parser provides the functionality to extract a text by an item of table of contents. This feature is supported for Word Processing, PDF, ePUB and CHM documents (for more details, see [Supported Document Formats]({{< ref "parser/net/getting-started/supported-document-formats.md" >}})).

Text is extracted by [TocItem.ExtractText](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/methods/extracttext) method:

```csharp
// Get the first item of table of contents
TocItem tocItem = parser.GetToc().First();

// Print the text of the chapter
using (TextReader reader = tocItem.ExtractText())
{
    Console.WriteLine("----");
    Console.WriteLine(reader.ReadToEnd());
}
```

This method returns a text from the chapter to which table of contents item refers (without sub-chapters). For example, "Heading 1.2" from the page

![](/parser/net/images/extract-text-by-table-of-contents-item.png)

returns the following text:

![](/parser/net/images/extract-text-by-table-of-contents-item_1.png)

"Heading 2" from the page:

![](/parser/net/images/extract-text-by-table-of-contents-item_2.png)

returns the following text:

![](/parser/net/images/extract-text-by-table-of-contents-item_3.png)

{{< alert style="warning" >}}
[InvalidOperationException](https://docs.microsoft.com/en-us/dotnet/api/system.invalidoperationexception?view=netframework-2.0) is thrown if [tocItem.PageIndex](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/properties/pageindex) is *null*.
{{< /alert >}}

Here are the steps to extract a text by an item of table of contents:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method and obtain the collection of [TocItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem) objects;
*   Check if *collection* isn't *null* (table of contents extraction is supported for the document);
*   Iterate through the collection and extract a text by [GetText](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/methods/gettext) method.  

The following example shows how to extract text by table of contents items:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Get table of contents
    IEnumerable<TocItem> toc = parser.GetToc();
    
    // Check if TOC extraction is supported
    if (toc == null)
    {
        Console.WriteLine("Table of contents extraction isn't supported");
        return;
    }
    
    // Iterate over items
    foreach (TocItem i in toc)
    {
        // Check if page index has a value
        if (i.PageIndex == null)
        {
            continue;
        }
        // Extract a page text
        using (TextReader reader = i.ExtractText())
        {
            Console.WriteLine(reader == null ? "No text" : reader.ReadToEnd());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Generate Document from Database

Path: /assembly/net/basic-usage-database-datasource/


## Overview

GroupDocs.Assembly for .NET seamlessly integrates with ADO.NET, allowing you to generate documents directly from database queries. You can use DataSet, DataTable, DataView, or IDataReader as data sources, making it easy to create reports from SQL Server, Oracle, MySQL, and other databases.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources
- ADO.NET classes: DataSet, DataTable, DataView, IDataReader

Here are the steps to generate documents from databases:

* Connect to your database using ADO.NET
* Execute SQL queries and populate DataSet or DataTable
* Create a template document with expression tags referencing table and column names
* Use DocumentAssembler to assemble the template with database data
* Save the assembled document

{{< alert style="info" >}}
GroupDocs.Assembly supports all standard ADO.NET data sources, including DataSet, DataTable, DataView, DataRow, DataRowView, IDataReader, and IDataRecord.
{{< /alert >}}

## Generate Document from DataTable

The simplest approach is to use a DataTable:

```csharp
using GroupDocs.Assembly;
using System.Data;
using System.Data.SqlClient;

public static void GenerateFromDataTable()
{
    // Connect to database and populate DataTable
    string connectionString = "Server=localhost;Database=MyDB;Integrated Security=true;";
    string query = "SELECT CustomerName, Email, Balance FROM Customers";
    
    DataTable customersTable = new DataTable();
    
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        using (SqlCommand command = new SqlCommand(query, connection))
        {
            using (SqlDataAdapter adapter = new SqlDataAdapter(command))
            {
                adapter.Fill(customersTable);
            }
        }
    }
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(customersTable, "customers"));
    
    Console.WriteLine("Document generated from DataTable successfully.");
}
```

## Template Example for DataTable

In your template, reference columns by name:

```
Customers List:

<<foreach [in customers]>>
<<[CustomerName]>> - <<[Email]>> - Balance: <<[Balance]:"C">>
<</foreach>>
```

## Generate Document from DataSet

When working with multiple tables, use DataSet:

```csharp
using GroupDocs.Assembly;
using System.Data;
using System.Data.SqlClient;

public static void GenerateFromDataSet()
{
    string connectionString = "Server=localhost;Database=MyDB;Integrated Security=true;";
    
    DataSet dataSet = new DataSet();
    
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        // Load customers table
        using (SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT * FROM Customers", connection))
        {
            adapter.Fill(dataSet, "Customers");
        }
        
        // Load orders table
        using (SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT * FROM Orders", connection))
        {
            adapter.Fill(dataSet, "Orders");
        }
    }
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(dataSet, "ds"));
    
    Console.WriteLine("Document generated from DataSet successfully.");
}
```

## Template Example for DataSet

Reference tables by name in your template:

```
Customers:
<<foreach [in ds.Customers]>>
<<[CustomerName]>> - <<[Email]>>
<</foreach>>

Orders:
<<foreach [in ds.Orders]>>
Order #<<[OrderId]>> - Amount: <<[Amount]:"C">>
<</foreach>>
```

## Generate Document from IDataReader

For large datasets, use IDataReader for efficient streaming:

```csharp
using GroupDocs.Assembly;
using System.Data;
using System.Data.SqlClient;

public static void GenerateFromDataReader()
{
    string connectionString = "Server=localhost;Database=MyDB;Integrated Security=true;";
    string query = "SELECT CustomerName, Email, Balance FROM Customers";
    
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        
        using (SqlCommand command = new SqlCommand(query, connection))
        using (SqlDataReader reader = command.ExecuteReader())
        {
            DocumentAssembler assembler = new DocumentAssembler();
            assembler.AssembleDocument("Template.docx", "Output.docx", 
                new DataSourceInfo(reader, "customers"));
            
            Console.WriteLine("Document generated from DataReader successfully.");
        }
    }
}
```

## Using DataView for Filtered Data

You can use DataView to filter and sort data before assembly:

```csharp
using GroupDocs.Assembly;
using System.Data;
using System.Data.SqlClient;

public static void GenerateFromDataView()
{
    string connectionString = "Server=localhost;Database=MyDB;Integrated Security=true;";
    
    DataTable customersTable = new DataTable();
    
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        using (SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT * FROM Customers", connection))
        {
            adapter.Fill(customersTable);
        }
    }
    
    // Create filtered and sorted DataView
    DataView customersView = new DataView(customersTable);
    customersView.RowFilter = "Balance > 1000";
    customersView.Sort = "CustomerName ASC";
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(customersView, "customers"));
    
    Console.WriteLine("Document generated from DataView successfully.");
}
```

## Working with Related Tables

DataSet supports data relations for master-detail reports:

```csharp
using GroupDocs.Assembly;
using System.Data;
using System.Data.SqlClient;

public static void GenerateWithRelations()
{
    string connectionString = "Server=localhost;Database=MyDB;Integrated Security=true;";
    
    DataSet dataSet = new DataSet();
    
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        using (SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT * FROM Customers", connection))
        {
            adapter.Fill(dataSet, "Customers");
        }
        
        using (SqlDataAdapter adapter = new SqlDataAdapter(
            "SELECT * FROM Orders", connection))
        {
            adapter.Fill(dataSet, "Orders");
        }
    }
    
    // Create relation
    DataRelation relation = new DataRelation(
        "CustomerOrders",
        dataSet.Tables["Customers"].Columns["CustomerId"],
        dataSet.Tables["Orders"].Columns["CustomerId"]);
    dataSet.Relations.Add(relation);
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("Template.docx", "Output.docx", 
        new DataSourceInfo(dataSet.Tables["Customers"], "customers"));
    
    Console.WriteLine("Document generated with relations successfully.");
}
```

Template with relations:

```
<<foreach [in customers]>>
Customer: <<[CustomerName]>>
Orders:
<<foreach [in GetChildRows(\"CustomerOrders\")]>>
  - Order #<<[OrderId]>>: <<[Amount]:"C">>
<</foreach>>
<</foreach>>
```

{{< alert style="warning" >}}
When using database connections, always ensure proper disposal of resources. Use `using` statements or try-finally blocks to close connections and readers.
{{< /alert >}}

### Advanced Usage Topics

To learn more about working with complex database queries, stored procedures, parameterized queries, and performance optimization for large datasets, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Get only summary page

Path: /comparison/java/get-only-summary-page/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to detect changes between source and target files and create the summary page only.

To get only summary page, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object. Set the [ShowOnlySummaryPage](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowOnlySummaryPage-boolean-) property to `true`;
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how to get only summary page.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    CompareOptions options = new CompareOptions();
    options.setShowOnlySummaryPage(true);
    final Path resultPath = comparer.compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/get-only-summary-page.png)
---

## Get only summary page

Path: /comparison/net/get-only-summary-page/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to detect changes between source and target files and create the summary page only.

To get only summary page, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object. Set the [ShowOnlySummaryPage](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showonlysummarypage) property to `true`;
4.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how to get only summary page.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions options = new CompareOptions() {ShowOnlySummaryPage = true};
      comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/get-only-summary-page.png)
---

## Get only summary page

Path: /comparison/nodejs-java/get-only-summary-page/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to detect changes between source and target files and create the summary page only.

The following code snippet shows how to get only a summary page.

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and output documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

// Initialize comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to be compared with the source
comparer.add(targetPath);

// Create comparison options and configure to show only summary page
const options = new groupdocs.CompareOptions();
options.setShowOnlySummaryPage(true); // enable summary-only view

// Execute comparison and save result to output path
comparer.compare(outputPath, options);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It sets `setShowOnlySummaryPage(true)` to generate only the summary page without the full document content. When the comparison is performed, the result document will contain only the summary page with statistics about detected changes, making it useful for quick overviews without the full document content.

The result is as follows:

![](/comparison/nodejs-java/images/get-only-summary-page.png)
---

## Get only summary page

Path: /comparison/python-net/get-only-summary-page/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) can generate only the summary page with high-level statistics and change counts.

## Get only summary page

Enable summary-only output to reduce file size and focus on key metrics.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.show_only_summary_page = True
    comparer.compare("result.docx", options)
```

🔹 Use case: Share a concise overview of differences without exposing full document content.

The result is as follows:

![](/comparison/python-net/images/get-only-summary-page.png)



---

## Get supported file formats

Path: /watermark/net/get-supported-file-formats/

GroupDocs.Watermark allows to get the [list of all supported file formats]({{< ref "watermark/net/getting-started/supported-document-formats.md" >}}) by following the below steps:

* Call the [GetSupportedFileTypes](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common/filetype/methods/getsupportedfiletypes) method of the [FileType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common/filetype) class;
* Enumerate through the collection of [FileType](https://reference.groupdocs.com/net/watermark/groupdocs.watermark.common/filetype) objects.

The following code sample demonstrates how to get a supported file formats list.

**BasicUsage.GetSupportedFileFormats**

```csharp
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes();
foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType);
}
```

---

## Get supported file formats

Path: /watermark/nodejs-java/get-supported-document-formats/


[GroupDocs.Watermark](https://products.groupdocs.com/watermark/nodejs-java) allows you to get the list of all [supported file formats]({{< ref "watermark/nodejs-java/getting-started/supported-document-formats.md" >}}). To do this, follow these steps:

1. Call the `getSupportedFileTypes`<!--](https://reference.groupdocs.com/watermark/nodejs-java/com.groupdocs.watermark.result/filetype/#getSupportedFileTypes- -)--> method of the `FileType`<!--](https://reference.groupdocs.com/watermark/nodejs-java/com.groupdocs.watermark.result/filetype/)--> class.
2. Enumerate through the collection of the `FileType`<!--](https://reference.groupdocs.com/watermark/nodejs-java/com.groupdocs.watermark.result/filetype/)--> objects.

The following code snippet shows how to obtain a list of supported file formats:


```javascript
const supportedFileTypes = groupdocs.watermark.FileType.getSupportedFileTypes();
supportedFileTypes.forEach(fileType => {
  console.log(fileType.toString());
});
```
---

## Get supported file formats

Path: /watermark/python-net/get-supported-file-formats/


Get the list of all supported file formats.

Quickly retrieve the complete list of file formats supported by GroupDocs.Watermark. This allows Python developers to dynamically check compatibility before processing documents.

```python
from groupdocs.watermark.common import FileType

supported = FileType.get_supported_file_types()
for ft in supported:
    print(ft)
```

🔹 Use case: Build flexible applications that can automatically validate user-uploaded files and inform them if watermarking is supported.


---

## Homophone search

Path: /search/java/homophone-search/

Homophone search, or in other words phonic search, allows you to find not only the words specified in the search query, but also the homophones, words that are pronounced the same but differ in meaning.

To enable homophone search, you have to call the [setUseHomophoneSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setUseHomophoneSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class with the true value as an argument. By default, homophone search is disabled.

The default homophone dictionary contains homophones only for the English language. To manage the homophone dictionary, see the [Homophone dictionary]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/homophone-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The following example demonstrates the homophone search.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.setUseHomophoneSearch(true); // Enabling homophone search
 
// Search for the word 'coal'
// In addition to the word 'coal', the words 'cole' and 'kohl' will also be found
SearchResult result = index.search("coal", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Homophone search

Path: /search/net/homophone-search/

Homophone search, or in other words phonic search, allows you to find not only the words specified in the search query, but also the homophones, words that are pronounced the same but differ in meaning.

To enable homophone search, you must set the [UseHomophoneSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/usehomophonesearch) property of the [SearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions) class to true. By default, homophone search is disabled.

The default homophone dictionary contains homophones only for the English language. To manage the homophone dictionary, see the [Homophone dictionary]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/homophone-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The following example demonstrates the homophone search.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.UseHomophoneSearch = true; // Enabling homophone search
 
// Search for the word 'coal'
// In addition to the word 'coal', the words 'cole' and 'kohl' will also be found
SearchResult result = index.Search("coal", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Homophone search

Path: /search/nodejs-java/homophone-search/

Homophone search, or in other words phonic search, allows you to find not only the words specified in the search query, but also the homophones, words that are pronounced the same but differ in meaning.

To enable homophone search, you have to call the [setUseHomophoneSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setUseHomophoneSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class with the true value as an argument. By default, homophone search is disabled.

The default homophone dictionary contains homophones only for the English language. To manage the homophone dictionary, see the [Homophone dictionary]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/homophone-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The following example demonstrates the homophone search.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Creating a search options object
const options = new groupdocs.search.SearchOptions();
options.setUseHomophoneSearch(true); // Enabling homophone search

// Search for the word 'call'
// In addition to the word 'call', the word 'caul' will also be found
const query = 'call';
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## How to merge images to PDF using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-images-to-pdf-using-csharp/


## PDF Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple image documents in the preferred order and save them as a single PDF file.

## About PDF File Format

Portable Document Format (PDF) is a type of document created by Adobe back in the 1990s. The purpose of this file format was to introduce a standard for representation of documents and other reference material in a format that is independent of application software, hardware as well as Operating System. PDF files can be opened in Adobe Acrobat Reader/Writer as well in most modern browsers like Chrome, Safari, Firefox via extensions/plug-ins.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to download API DLLs or MSI installer or NuGet:
```csharp
PM> Install-Package GroupDocs.Merger
```

### Source images

!["Sample1.jpg"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/net/images/jpg/sample3.jpg)

### How to merge image files to PDF

The following example demonstrates how to merge image files to PDF file with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements. Additionally, pass instance of [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) class as a second constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PDF file as parameter.

```csharp

// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.jpeg", new LoadOptions(FileType.PDF)))
{
    // Add another image file to merge
    merger.Join(@"c:\sample2.png");
    // Add next image file to merge
    merger.Join(@"c:\sample3.bmp");
    // Merge image files and save PDF result
    merger.Save(@"c:\merged.pdf");
}
```

### Result merged PDF file

!["Merged.pdf"](/merger/net/images/jpg/merged_images_to_pdf.jpg)

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PDF Live Demo

GroupDocs.Merger for .NET provides an online [**Merge Image to PDF App**](https://products.groupdocs.app/merger/image-to-pdf), which allows you to try it for free and check its quality and accuracy.
---

## How to merge images to PDF using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-images-to-pdf-using-java/


## PDF Merger Java API

[com.groupdocs.merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple image documents in the preferred order and save them as a single PDF file.

## About PDF File Format

Portable Document Format (PDF) is a type of document created by Adobe back in 1990s. The purpose of this file format was to introduce a standard for representation of documents and other reference material in a format that is independent of application software, hardware as well as Operating System. PDF files can be opened in Adobe Acrobat Reader/Writer as well in most modern browsers like Chrome, Safari, Firefox via extensions/plug-ins.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/java) to download API jar package and add it to the .pom file. :
```java
<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>23.2</version>
</dependency>
```

### Source images

!["Sample1.jpg"](/merger/net/images/jpg/sample1.jpg)
!["Sample2.jpg"](/merger/net/images/jpg/sample2.jpg)
!["Sample3.jpg"](/merger/net/images/jpg/sample3.jpg)

### How to merge image files to PDF

The following example demonstrates how to merge image files to PDF file with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements. Additionally, pass instance of [LoadOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/loadoptions/) class as a second constructor parameter.
* Add another image file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) method. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged PDF file as parameter.

```java

// Load the source image file
Merger merger = new Merger("c:\sample1.jpeg", new LoadOptions(FileType.PDF))
{
    // Add another image file to merge
    merger.join("c:\sample2.png");
    // Add next image file to merge
    merger.join("c:\sample3.bmp");
    // Merge image files and save PDF result
    merger.save("c:\merged.pdf");
}
```

### Result merged PDF file

!["Merged.pdf"](/merger/net/images/jpg/merged_images_to_pdf.jpg)

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PDF Live Demo

GroupDocs.Merger for Java provides an online [**Image to PDF Merger App**](https://products.groupdocs.app/merger/image-to-pdf), which allows you to try it for free and check its quality and accuracy.
---

## How to merge MP3 files using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-mp3-files-using-csharp/


## MP3 Merger .NET API

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple MP3 audio files in the preferred order and save them as a single file.

## About MP3 File Format

The MP3 (MPEG-1 Audio Layer 3) file format is a widely used audio compression format known for its ability to significantly reduce the file size of audio recordings while maintaining reasonably good sound quality. MP3 is a lossy audio compression format, which means that it achieves smaller file sizes by removing some of the audio data that is less perceptible to the human ear. 

MP3 is one of the most universally supported audio formats. It is compatible with a wide range of devices, software, and platforms, making it suitable for sharing and playback across different systems.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to obtain the API DLLs, MSI installer, or NuGet package:
```shell
PM> Install-Package GroupDocs.Merger
```

### Source Audio Files

<audio controls="controls">
  <source type="audio/mp3" src="/merger/net/images/audio/sample1.mp3"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

<audio controls="controls">
  <source type="audio/mp3" src="/merger/net/images/audio/sample2.mp3"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>


### How To Merge Several MP3 Files Into A Single File

The following example demonstrates how to merge multiple audio files with several lines of C# code:

* Create an instance of the [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass the source audio file path as a constructor parameter. You may specify absolute or relative file paths as per your requirements.
* Add another audio file to merge with the [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other audio files you want to merge.
* Call the [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the resulting audio file as a parameter.

```csharp
// Load the source MP3 file
using (var merger = new GroupDocs.Merger.Merger(@"c:\sample1.mp3"))
{
    // Add another MP3 file to merge
    merger.Join(@"c:\sample2.mp3");
    // Merge MP3 files and save result
    merger.Save(@"c:\merged.mp3");
}
```

### Result Of Joining MP3 Files

<audio controls="controls">
  <source type="audio/mp3" src="/merger/net/images/audio/merged.mp3"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

### Code Examples

Explore C# source code of our backend and frontend [examples and use-cases]({{< ref "merger/net/showcases.md" >}}). You can experiment with them at no cost!

### Merge MP3 Live Demo

GroupDocs.Merger for .NET offers an online [**MP3 Merger App**](https://products.groupdocs.app/merger/mp3) that enables you to test it without charge, assessing its quality and precision.
---

## Image redactions

Path: /redaction/java/image-redactions/

### Redact image area

GroupDocs.Redactions prodives a set of features to redact data of sensitive nature from images of various formats like JPG, PNG, TIFF and others. See full list at [supported document formats]({{< ref "redaction/java/getting-started/supported-document-formats.md" >}}) article.

GroupDocs.Redaction fr Java since version 21.6 supports two ways of redacting images, both in separate image files and embedded images:
*   You can put a colored box over a given area, such as header, footer, or an area, where customer's data are expected to appear.
*   You can use any 3-rd party OCR engine to process the image, search it for text and redact sensitive data within the image.   

GroupDocs.Redaction for Java also allows you to change image metadata (e.g. edit EXIF data of an image or act as an "EXIF eraser").

## Redact image area

In order to redact image area, you have to use [ImageAreaRedaction](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.redactions/ImageAreaRedaction) class:

**Java**

```java
final Redactor redactor  = new Redactor("D:\\test.jpg");
try 
{
    //Define the position on image
    java.awt.Point samplePoint = new java.awt.Point(385, 485);
    //Define the size of the area which need to be redacted
    java.awt.Dimension sampleSize = new java.awt.Dimension(1793, 2069);
    //Perform redaction
    RedactorChangeLog result = redactor.apply(new ImageAreaRedaction(samplePoint,
        new RegionReplacementOptions(java.awt.Color.BLUE, sampleSize)));
    if (result.getStatus() != RedactionStatus.Failed)
    {
       //The redacted output will save as PDF 
       redactor.save();
    };
}
finally { redactor.close(); }
```

If the redaction cannot be applied to this type of files, e.g. MS Word document without embedded images, [RedactorChangeLog.getStatus()](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction/RedactorChangeLog#getStatus()) will be [RedactionStatus.Skipped](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction/RedactionStatus).

## Redact recognized text from an image

To enable OCR-processing and search for a text using regular expressions, you have to implement [IOcrConnector](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.integration/IOcrConnector) interface and pass the instance to [RedactorSettings](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.options/RedactorSettings) constructor. For more details, see [OCR Usage Basics]({{< ref "redaction/java/developer-guide/advanced-usage/using-ocr/ocr-usage-basics" >}}) article.

**Java**

```Java
try (Redactor redactor = new Redactor("D:\\test.jpg", new LoadOptions(), new RedactorSettings(new MyCustomOcrConnector())))
{
   RedactorChangeLog result = redactor.apply(new RegexRedaction("\\d{4}", new ReplacementOptions(java.awt.Color.BLUE)));
   if (result.getStatus() != RedactionStatus.Failed)
   {
      redactor.save();
   };
}
```

In the example above **MyCustomOcrConnector** class implements [IOcrConnector](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.integration/IOcrConnector) interface.


### Clean image metadata

GroupDocs.Redaction for Java allows you to change image metadata (e.g. edit EXIF data of an image or act as an "EXIF eraser").

The following example demonstrates how to edit exif data (erase them) from a photo or any other image:



```java
final Redactor redactor  = new Redactor("D:\\photo.jpg");
try 
{
    RedactorChangeLog result = redactor.apply(new EraseMetadataRedaction(MetadataFilters.All));
    if (result.getStatus() != RedactionStatus.Failed)
    {
       //The redacted output will save as PDF 
       redactor.save();
    };
}
finally { redactor.close(); }
```

If the redaction cannot be applied to this type of files, e.g. BMP image, *RedactorChangeLog.getStatus()* will be *RedactionStatus.Skipped*.

## Redact embedded images

You can redact image area within all kinds of embedded images inside a document. You can both use [ImageAreaRedaction](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.redactions/ImageAreaRedaction) class and any type of [TextRedaction](https://reference.groupdocs.com/redaction/java/com.groupdocs.redaction.redactions/TextRedaction) (regular expression, exact phrase), if the OCR is enabled in **RedactorSettings** (see [OCR Usage Basics]({{< ref "redaction/java/developer-guide/advanced-usage/using-ocr/ocr-usage-basics" >}}) article). 

The following example demonstrates how to redact all embedded images within a Microsoft Word document:

```java
final Redactor redactor = new Redactor("D:\\sample.docx");
try 
{
    java.awt.Point samplePoint = new java.awt.Point(516, 311);
    java.awt.Dimension sampleSize = new java.awt.Dimension(170, 35);
    RedactorChangeLog result = redactor.apply(new ImageAreaRedaction(samplePoint,
        new RegionReplacementOptions(java.awt.Color.BLUE, sampleSize)));
    if (result.getStatus() != RedactionStatus.Failed)
    {
        redactor.save();
    };
}
finally { redactor.close(); }
```

If the redaction cannot be applied to this type of files, e.g. a spreadsheet document, *RedactorChangeLog.getStatus()* will be *RedactionStatus.Skipped*.

## Multi-frame images

You can remove frames from a multi-frame image with a given origin and frame count. For additional information look at [remove page redactions]({{< ref "redaction/java/developer-guide/basic-usage/remove-page-redactions.md" >}}) article.

Some image formats, such as DjVu documents, require [pre-rasterization]({{< ref "redaction/java/developer-guide/advanced-usage/loading-documents/pre-rasterize.md" >}}) and further saving in PDF format. 

---

## Image redactions

Path: /redaction/net/image-redactions/

GroupDocs.Redactions prodives a set of features to redact data of sensitive nature from images of various formats like JPG, PNG, TIFF and others. See full list at [supported document formats]({{< ref "redaction/net/getting-started/supported-document-formats.md" >}}) article.

GroupDocs.Redaction since version 21.3 supports two ways of redacting images, both in separate image files and embedded images:
*   You can put a colored box over a given area, such as header, footer, or an area, where customer's data are expected to appear.
*   You can use any 3-rd party OCR engine to process the image, search it for text and redact sensitive data within the image.   

GroupDocs.Redaction for .NET also allows you to change image metadata (e.g. edit EXIF data of an image or act as an "EXIF eraser").

## Redact image area

In order to redact image area, you have to use [ImageAreaRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/imagearearedaction) class:

**C#**

```csharp
using (Redactor redactor = new Redactor("D:\\test.jpg"))
{
   System.Drawing.Point samplePoint = new System.Drawing.Point(516, 311);
   System.Drawing.Size sampleSize = new System.Drawing.Size(170, 35);
   RedactorChangeLog result = redactor.Apply(new ImageAreaRedaction(samplePoint,
                new RegionReplacementOptions(System.Drawing.Color.Blue, sampleSize)));
   if (result.Status != RedactionStatus.Failed)
   {
      redactor.Save();
   };
}
```

If the redaction cannot be applied to this type of files, e.g. MS Word document without embedded images, [RedactorChangeLog.Status](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactorchangelog/properties/status) will be [RedactionStatus.Skipped](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactionstatus).

## Redact recognized text from an image

To enable OCR-processing and search for a text using regular expressions, you have to implement [IOcrConnector](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration.ocr/iocrconnector) interface and pass the instance to [RedactorSettings](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.options/redactorsettings) constructor. For more details, see [OCR Usage Basics]({{< ref "redaction/net/developer-guide/advanced-usage/using-ocr/ocr-usage-basics" >}}) article.

**C#**

```csharp
using (Redactor redactor = new Redactor("D:\\test.jpg", new LoadOptions(), new RedactorSettings(new MyCustomOcrConnector())))
{
   RedactorChangeLog result = redactor.Apply(new RegexRedaction("\\d{4}", new ReplacementOptions(System.Drawing.Color.Blue)));
   if (result.Status != RedactionStatus.Failed)
   {
      redactor.Save();
   };
}
```

In the example above **MyCustomOcrConnector** class implements [IOcrConnector](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.integration.ocr/iocrconnector) interface.

## Clean image metadata

The following example demonstrates how to edit exif data (erase them) from a photo or any other image:

**C#**

```csharp
using (Redactor redactor = new Redactor("D:\\photo.jpg"))
{
    redactor.Apply(new EraseMetadataRedaction(MetadataFilters.All));
    // Save the document to "*_Redacted.*" file in original format
    redactor.Save(new SaveOptions() { AddSuffix = true, RasterizeToPDF = false });
}
```

If the redaction cannot be applied to this type of files, e.g. BMP image, [RedactorChangeLog.Status](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactorchangelog/properties/status) will be [RedactionStatus.Skipped](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactionstatus).

## Redact embedded images

You can redact image area within all kinds of embedded images inside a document. You can both use [ImageAreaRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/imagearearedaction) class and any type of [TextRedaction](https://reference.groupdocs.com/net/redaction/groupdocs.redaction.redactions/textredaction) (regular expression, exact phrase), if the OCR is enabled in **RedactorSettings** (see [OCR Usage Basics]({{< ref "redaction/net/developer-guide/advanced-usage/using-ocr/ocr-usage-basics" >}}) article). 

The following example demonstrates how to redact all embedded images within a Microsoft Word document:

**C#**

```csharp
using (Redactor redactor = new Redactor("D:\\sample.docx"))
{
   System.Drawing.Point samplePoint = new System.Drawing.Point(516, 311);
   System.Drawing.Size sampleSize = new System.Drawing.Size(170, 35);
   RedactorChangeLog result = redactor.Apply(new ImageAreaRedaction(samplePoint,
                new RegionReplacementOptions(System.Drawing.Color.Blue, sampleSize)));
   if (result.Status != RedactionStatus.Failed)
   {
      redactor.Save();
   };
}
```

If the redaction cannot be applied to this type of files, e.g. a spreadsheet document, [RedactorChangeLog.Status](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactorchangelog/properties/status) will be [RedactionStatus.Skipped](https://reference.groupdocs.com/net/redaction/groupdocs.redaction/redactionstatus).

## Multi-frame images

You can remove frames from a multi-frame image with a given origin and frame count. For additional information look at [remove page redactions]({{< ref "redaction/net/developer-guide/basic-usage/remove-page-redactions.md" >}}) article.

Some image formats, such as DjVu documents, require [pre-rasterization]({{< ref "redaction/net/developer-guide/advanced-usage/loading-documents/pre-rasterize.md" >}}) and further saving in PDF format. 

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Image redactions

Path: /redaction/python-net/image-redactions/

GroupDocs.Redactions provides a set of features to redact data of sensitive nature from images of various formats like JPG, PNG, TIFF and others. See full list at [supported document formats]({{< ref "redaction/python-net/getting-started/supported-document-formats.md" >}}) article.

GroupDocs.Redaction  supports two ways of redacting images, both in separate image files and embedded images:
*   You can put a colored box over a given area, such as header, footer, or an area, where customer's data are expected to appear.
*   You can use any 3-rd party OCR engine to process the image, search it for text and redact sensitive data within the image.   

GroupDocs.Redaction for Python via .NET also allows you to change image metadata (e.g. edit EXIF data of an image or act as an "EXIF eraser").

## Redact image area

In order to redact image area, you have to use [ImageAreaRedaction](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction.redactions/imagearearedaction/) class:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():

    # Define the position on image
    sample_point = grd.Point(385, 485)
    # Define the size of the area which need to be redacted
    sample_size = grd.Size(1793, 2069)
    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Specify the redaction options
    repl_opt = grr.RegionReplacementOptions(color, sample_size)
    img_red = grr.ImageAreaRedaction(sample_point, repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.jpg") as redactor:

        # Apply the redaction
        result = redactor.apply(img_red)

        if (result.status != gr.RedactionStatus.FAILED):
            # By default, the redacted document is saved in PDF format
            result_path = redactor.save()
```

If the redaction cannot be applied to this type of files, e.g. MS Word document without embedded images, [RedactorChangeLog.Status](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactorchangelog/status/) will be [RedactionStatus.Skipped](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionstatus/).

## Clean image metadata

The following example demonstrates how to edit exif data (erase them) from a photo or any other image:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():
    
    print("\n[Example Basic Usage] # clean_image_metadada.py : Clean all image metadata")

    # Specify the redaction options to remove all metadata
    er_opt = grr.EraseMetadataRedaction(grr.MetadataFilters.ALL)

    # Load the document to be redacted
    with gr.Redactor("source.jpg") as redactor:

        # Apply the redaction
        result = redactor.apply(er_opt)

        # Save the redacted document
        so = gro.SaveOptions()
        so.add_suffix = True
        so.rasterize_to_pdf = False
        result_path = redactor.save(so)
```

If the redaction cannot be applied to this type of files, e.g. BMP image, [RedactorChangeLog.Status](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactorchangelog/status/) will be [RedactionStatus.Skipped](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionstatus/).

## Redact embedded images

You can redact image area within all kinds of embedded images inside a document. 

The following example demonstrates how to redact all embedded images within a Microsoft Word document:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr
import groupdocs.pydrawing as grd

def run():
    # Define the position on image
    sample_point = grd.Point(516, 311)
    # Define the size of the area which need to be redacted
    sample_size = grd.Size(170, 35)
    # Define color of redaction
    color = grd.Color.from_argb(255, 220, 20, 60)

    # Specify the redaction options
    repl_opt = grr.RegionReplacementOptions(color, sample_size)
    img_red = grr.ImageAreaRedaction(sample_point, repl_opt)

    # Load the document to be redacted
    with gr.Redactor("source.docx") as redactor:

        # Apply the redaction
        result = redactor.apply(img_red)

        if (result.status != gr.RedactionStatus.FAILED):
            # By default, the redacted document is saved in PDF format
            result_path = redactor.save()
```

If the redaction cannot be applied to this type of files, e.g. a spreadsheet document, [RedactorChangeLog.Status](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactorchangelog/status/) will be [RedactionStatus.Skipped](https://reference.groupdocs.com/redaction/python-net/groupdocs.redaction/redactionstatus/).

## Multi-frame images

You can remove frames from a multi-frame image with a given origin and frame count. For additional information look at [remove page redactions]({{< ref "redaction/python-net/developer-guide/basic-usage/remove-page-redactions.md" >}}) article.

Some image formats, such as DjVu documents, require [pre-rasterization]({{< ref "redaction/python-net/developer-guide/advanced-usage/loading-documents/pre-rasterize.md" >}}) and further saving in PDF format. 

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Image search options

Path: /search/java/image-search-options/

This page contains a description of all search options that can be specified in an instance of the [ImageSearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageSearchOptions) class.

## setHashDifferences method

The [setHashDifferences](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageSearchOptions#setHashDifferences(int)) method allows you to specify the maximum number of mismatched bits in the image hash. If all the bits in the hash match, then the images match completely. The more different bits, the more the images differ from each other. The default value is 5. The value must be in the range from 0 to 32.

## setMaxResultCount method

The [setMaxResultCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageSearchOptions#setMaxResultCount(int)) method allows you to specify the maximum number of found images for an image reverse search request. The default value is 1000.

## setSearchDocumentFilter method

The [setSearchDocumentFilter](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageSearchOptions#setSearchDocumentFilter(com.groupdocs.search.options.ISearchDocumentFilter)) method allows you to specify the filter of documents returned as a search result. By default, all documents found will be returned as a search result. For details, see the [Document filtering in search result]({{< ref "search/java/developer-guide/advanced-usage/searching/document-filtering-in-search-result.md" >}}) page.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Image search options

Path: /search/net/image-search-options/

This page contains a description of all search options that can be specified in an instance of the [ImageSearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/imagesearchoptions) class.

## HashDifferences property

The [HashDifferences](https://reference.groupdocs.com/net/search/groupdocs.search.options/imagesearchoptions/properties/hashdifferences) property allows you to specify the maximum number of mismatched bits in the image hash. If all the bits in the hash match, then the images match completely. The more different bits, the more the images differ from each other. The default value of the property is 5. The value must be in the range from 0 to 32.

## MaxResultCount property

The [MaxResultCount](https://reference.groupdocs.com/net/search/groupdocs.search.options/imagesearchoptions/properties/maxresultcount) property allows you to specify the maximum number of found images for an image reverse search request. The default value is 1000.

## SearchDocumentFilter property

The [SearchDocumentFilter](https://reference.groupdocs.com/net/search/groupdocs.search.options/imagesearchoptions/properties/searchdocumentfilter) property allows you to specify the filter of documents returned as a search result. By default, all documents found will be returned as a search result. For details, see the [Document filtering in search result]({{< ref "search/net/developer-guide/advanced-usage/searching/document-filtering-in-search-result.md" >}}) page.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Image search options

Path: /search/nodejs-java/image-search-options/

This page contains a description of all search options that can be specified in an instance of the [ImageSearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageSearchOptions) class.

## setHashDifferences method

The [setHashDifferences](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageSearchOptions#setHashDifferences(int)) method allows you to specify the maximum number of mismatched bits in the image hash. If all the bits in the hash match, then the images match completely. The more different bits, the more the images differ from each other. The default value is 5. The value must be in the range from 0 to 32.

## setMaxResultCount method

The [setMaxResultCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageSearchOptions#setMaxResultCount(int)) method allows you to specify the maximum number of found images for an image reverse search request. The default value is 1000.

## setSearchDocumentFilter method

The [setSearchDocumentFilter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageSearchOptions#setSearchDocumentFilter(com.groupdocs.search.options.ISearchDocumentFilter)) method allows you to specify the filter of documents returned as a search result. By default, all documents found will be returned as a search result. For details, see the [Document filtering in search result]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/document-filtering-in-search-result.md" >}}) page.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing additional fields

Path: /search/java/indexing-additional-fields/

Sometimes when indexing, it is necessary to associate each document with certain additional metadata, for example, a set of tags, a number in the library catalog, the subject of a document, etc. To accomplish this task, additional fields can be added to each indexed document in addition to those already in the document itself.

Additional fields are associated with the document through the arguments of the [FileIndexing](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#FileIndexing) event that occurs before indexing each added document. When adding each field, its name and contents are specified. The name of the added field can match the names of other added fields or fields of the document itself. During the search inside the fields with the same name, coincidences with the text of all fields with the specified name will be taken into account.

The example below demonstrates the associating of additional fields with documents during indexing.



```java
// Defining somewhere a dictionary containing subjects of documents
final HashMap<String, String> subjects = new HashMap();
subjects.put("C:\\MyDocuments\\BhagavadGitaAsItIs.pdf".toLowerCase(), "Spiritual");
// ...
 
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().FileIndexing.add(new EventHandler<FileIndexingEventArgs>() {
    public void invoke(Object sender, FileIndexingEventArgs args) {
        String subject = subjects.get(args.getDocumentFullPath().toLowerCase()); // Getting a subject for the current document
        if (subject != null) {
            args.setAdditionalFields(new DocumentField[] { // Setting additional fields for the current document
                new DocumentField("Subject", subject)
            });
        }
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing additional fields

Path: /search/net/indexing-additional-fields/

Sometimes when indexing, it is necessary to associate each document with certain additional metadata, for example, a set of tags, a number in the library catalog, the subject of a document, etc. To accomplish this task, additional fields can be added to each indexed document in addition to those already in the document itself.

Additional fields are associated with the document through the arguments of the [FileIndexing](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/fileindexing) event that occurs before indexing each added document. When adding each field, its name and contents are specified. The name of the added field can match the names of other added fields or fields of the document itself. During the search inside the fields with the same name, coincidences with the text of all fields with the specified name will be taken into account.

The example below demonstrates the associating of additional fields with documents during indexing.

**C#**

```csharp
// Defining somewhere a dictionary containing subjects of documents
Dictionary<string, string> subjects = new Dictionary<string, string>();
subjects.Add(@"C:\MyDocuments\BhagavadGitaAsItIs.pdf".ToLowerInvariant(), "Spiritual");
// ...
 
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.FileIndexing += (sender, args) =>
{
    string subject;
    if (subjects.TryGetValue(args.DocumentFullPath.ToLowerInvariant(), out subject)) // Getting a subject for the current document
    {
        args.AdditionalFields = new DocumentField[] // Setting additional fields for the current document
        {
            new DocumentField("Subject", subject)
        };
    }
};
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing additional fields

Path: /search/nodejs-java/indexing-additional-fields/

Sometimes when indexing, it is necessary to associate each document with certain additional metadata, for example, a set of tags, a number in the library catalog, the subject of a document, etc. To accomplish this task, additional fields can be added to each indexed document in addition to those already in the document itself.

Additional fields are associated with the document through the arguments of the [FileIndexing](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#FileIndexing) event that occurs before indexing each added document. When adding each field, its name and contents are specified. The name of the added field can match the names of other added fields or fields of the document itself. During the search inside the fields with the same name, coincidences with the text of all fields with the specified name will be taken into account.

The example below demonstrates the associating of additional fields with documents during indexing.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Defining subjects of documents
const documents = ['Lorem ipsum.pdf', 'English.docx', 'Lorem ipsum.docx', 'English.txt', 'Lorem ipsum.txt'];
const subjects = ['Latin', 'English', 'Latin', 'English', 'Latin'];

// Creating an index
const index = new groupdocs.search.Index(indexFolder, true);

// Subscribing to the event
index.getEvents().FileIndexing.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      const fileName = path.basename(args.getDocumentFullPath());
      let subject = null;
      for (let i = 0; i < documents.length; i++) {
        if (documents[i] == fileName) {
          subject = subjects[i]; // Getting a subject for the current document
        }
      }
      if (subject != null) {
        // Setting additional fields for the current document
        args.setAdditionalFields(
          java.newArray('com.groupdocs.search.common.DocumentField', [
            new groupdocs.search.DocumentField('Subject', subject),
          ]),
        );
      }
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Inserting Chart Axis Title Dynamically in Email Document

Path: /assembly/java/inserting-chart-axis-title-dynamically-in-email-document/

{{< alert style="info" >}}This feature is supported by version 18.1 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Column Chart in Email Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS Outlook 2013:

1.  Create a new Email
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialogue box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your email
5.  Edit the Worksheet with your data to update the chart
6.  Save your Email

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must be in .eml or .msg format
*   It must add email recipient, CSS and subject of the email
*   Report must show total Order Quantity by Quarters

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```java
<<[title]>><<foreach [in getContracts()
.where(c => c.getDate().getYear() + 1900 == 2015)
.groupBy(c => c.getManager())
.orderBy(g => g.key.getName())]>><<x [key.getName()]>>
```

#### Chart Data (Excel)

|            | 1st Quarter<<y [where(c => c.getDate().getMonth() >= 0 && c.getDate().getMonth() <= 2).sum(c => c.getPrice())]>> | 2nd Quarter<<y [where(c => c.getDate().getMonth() >= 3 && c.getDate().getMonth() <= 5).sum(c => c.getPrice())]>> | 3rd Quarter<<y [where(c => c.getDate().getMonth() >= 6 && c.getDate().getMonth() <= 8).sum(c => c.getPrice())]>> | 4th Quarter<<y [where(c => c.getDate().getMonth() >= 9 && c.getDate().getMonth() <= 11).sum(c => c.getPrice())]>> |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| Category 1 | 4.3                                                          | 2.4                                                          | 2                                                            | 3                                                            |
| Category 2 | 2.5                                                          | 4.4                                                          | 2                                                            | 2                                                            |
| Category 3 | 3.5                                                          | 1.8                                                          | 3                                                            | 5                                                            |
| Category 4 | 4.5                                                          | 2.8                                                          | 5                                                            | 2                                                            |

### Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_Dynamic_Title.msg)

### Generating The Report

{{< gist GroupDocsGists 10096bac56029ef28eed87add3a237a0 >}}



---

## Inserting Chart Axis Title Dynamically in Email Document

Path: /assembly/net/inserting-chart-axis-title-dynamically-in-email-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This feature is supported by version 18.1 or greater.{{< /alert >}}

## Column Chart in Email Document

### Creating a Column Chart

Please follow below steps to create a column chart in MS Outlook 2013:

1.  Create a new Email
2.  Click the "Insert" tab, and then click "Chart" in the illustrations group to open the "Insert Chart" dialogue box
3.  Select "Column" in the sidebar, you will see a gallery of charts
4.  Select the "100% Stacked Column" and press "OK" to insert the chart and Worksheet template to your email
5.  Edit the Worksheet with your data to update the chart
6.  Save your Email

### Reporting Requirement

As a report developer, you are required to share orders quantity of the customers dynamically with the following key requirements:

*   A report must be in .eml or .msg format
*   It must add email recipient, CSS and subject of the email
*   Report must show total Order Quantity by Quarters

### Adding Syntax to be evaluated by GroupDocs.Assembly Engine

#### Chart Title

```csharp
<<[title>><<foreach
[in orders
.Where(c => c.OrderDate.Year == 2015)
.GroupBy(c => c.Customer)
.OrderBy(g => g.Key.CustomerName)]>><<x
[Key.CustomerName]>>
```

#### Chart Data (Excel)

|            | 1st Quarter<<y [Where(c => c.Date.Month >= 1 && c.Date.Month <= 3).Sum(c => c.ProductQuantity)]>> | 2nd Quarter<<y [Where(c => c.Date.Month >= 4 && c.Date.Month <= 6).Sum(c => c.ProductQuantity)]>> | 3rd Quarter<<y [Where(c => c.Date.Month >= 7 && c.Date.Month <= 9).Sum(c => c.ProductQuantity)]>> | 4th Quarter<<y [Where(c => c.Date.Month >= 10 && c.Date.Month <= 12).Sum(c => c.ProductQuantity)]>> |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| Category 1 | 4.3                                                          | 2.4                                                          | 2                                                            | 3                                                            |
| Category 2 | 2.5                                                          | 4.4                                                          | 2                                                            | 2                                                            |
| Category 3 | 3.5                                                          | 1.8                                                          | 3                                                            | 5                                                            |
| Category 4 | 4.5                                                          | 2.8                                                          | 5                                                            | 2                                                            |

### Download Template

Please download the sample Chart Template we created in this article:

*   [Chart Template.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Chart%20with%20Filtering%2C%20Grouping%2C%20and%20Ordering_Dynamic_Title.msg)

### Generating The Report

{{< gist GroupDocsGists 0740b6ac3fefe47e4508be49b8939a4a >}}



---

## Licensing and  Subscription

Path: /merger/net/licensing-and-subscription/


Sometimes, in order to study the system better, you want to dive into the code as fast as possible. To make this easier, GroupDocs.Merger provides different plans for purchase or offers a Free Trial and a 30-day Temporary License for evaluation.

{{< alert style="info" >}}
Note that there are a number of general policies and practices that guide you on how to evaluate, properly license, and purchase our products. You can find them in the ["Purchase Policies and FAQ"](https://purchase.groupdocs.com/policies) section.
{{< /alert >}}

## Free Trial or Temporary License

You can try GroupDocs.Merger without buying a license.

### Free Trial

The evaluation version is the same as the purchased one – the evaluation version simply becomes licensed when you set the license. You can set the license in a number of ways that described in the next sections of this article.

The evaluation version comes with the limitations:

- Resultant document will be trimmed to first 3 pages.
- Trial badges are placed in the document on the top of each page.

### Temporary License

If you wish to test GroupDocs.Merger without the limitations of the trial version, you can also request a 30-day Temporary License. For more details, see the ["Get a Temporary License"](https://purchase.groupdocs.com/temporary-license) page.

## How to set a license

The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don't modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Merger API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object. The easiest way to set a license is to put the license file in the same folder as the GroupDocs.Merger.dll file and specify the file name, without a path, as shown in the examples below.

### Setting License from File

The code below will explain how to set product license.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET
// Setup license.
License license = new License();
license.SetLicense(licensePath);
```

### Setting License from Stream

The following example shows how to load a license from a stream.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET
using (FileStream fileStream = File.OpenRead("GroupDocs.Merger.lic"))
{
    License license = new License();
    license.SetLicense(fileStream);
}
```

{{< alert style="info" >}}Calling [License](https://reference.groupdocs.com/merger/net/groupdocs.merger/license).[SetLicense](https://reference.groupdocs.com/merger/net/groupdocs.merger/license/setlicense) multiple times is not harmful but simply wastes processor time. If you are developing a Windows Forms or console application, call License.SetLicense in your startup code, before using GroupDocs.Merger classes.  
When developing an ASP.NET application, you can call License.SetLicense from the Global.asax.cs (Global.asax.vb) file in the Application\_Start protected method. It is called once when the application starts.  
Do not call [License](https://reference.groupdocs.com/merger/net/groupdocs.merger/license).[SetLicense](https://reference.groupdocs.com/merger/net/groupdocs.merger/license/setlicense) from within Page\_Load methods since it means the license will be loaded every time a web page is loaded.
{{< /alert >}}

### Setting Metered License

{{< alert style="info" >}}You can also set [Metered](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered) license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to [Metered Licensing FAQ](https://purchase.groupdocs.com/faqs/licensing/metered) section.{{< /alert >}}
Here are the simple steps to use the `Metered` class.

1. Create an instance of [Metered](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered) class.
2. Pass public & private keys to [SetMeteredKey](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered/setmeteredkey) method.
3. Do processing (perform task).
4. call method [GetConsumptionQuantity](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered/getconsumptionquantity) of the `Metered` class.
5. It will return the amount/quantity of API requests that you have consumed so far.
6. call method [GetConsumptionCredit](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered/getconsumptioncredit) of the [Metered](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered) class.
7. It will return the credit that you have consumed so far.

Following is the sample code demonstrating how to use [Metered](https://reference.groupdocs.com/merger/net/groupdocs.merger/metered) class.

```csharp
// For complete examples and data files, please go to https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET
string publicKey = ""; // Your public license key
string privateKey = ""; // Your private license key

Metered metered = new Metered();
metered.SetMeteredKey(publicKey, privateKey);

// Get amount (MB) consumed
decimal amountConsumed = GroupDocs.Merger.Metered.GetConsumptionQuantity();
Console.WriteLine("Amount (MB) consumed: " + amountConsumed);

// Get count of credits consumed
decimal creditsConsumed = GroupDocs.Merger.Metered.GetConsumptionCredit();
Console.WriteLine("Credits consumed: " + creditsConsumed);
```

---

## Load Spreadsheet document with options

Path: /conversion/net/load-spreadsheet-document-with-options/


[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides the [SpreadsheetLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions) class which controls how the source spreadsheet will be processed. Below are some of the load options that you can use while [converting spreadsheets]({{< ref "conversion/net/developer-guide/basic-usage/convert/spreadsheet" >}}):

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/format)** | The document type is auto-detected while loading. However, you can explicitly specify the type of the source spreadsheet document. Available options are: *Csv, Fods, Ods, Ots, Tsv, Xlam, Xls, Xlsb, Xlsm, Xlsx, Xlt, Xltm, Xltx* |
|**[AllColumnsInOnePagePerSheet](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/allcolumnsinonepagepersheet)** | If *true*, all column content from a single sheet will be converted into a single page. The width of paper size of page setup will be ignored, while keeping the rest of page settings. |
|**[AutoFitRows](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/autofitrows)** | If enabled, automatically adjusts the content of all rows while converting. |
|**[CheckExcelRestriction](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/checkexcelrestriction)** | Whether to check restrictions of Excel file when modifying cell objects. |
|**[ConvertRange](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/convertrange)** | Defines a specific range of cells to be converted. For example: "D1:F8" |
|**[CultureInfo](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/cultureinfo)** | Specifies system culture info at the time file is loaded. |
|**[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/defaultfont)** | Specify the default font to use if a spreadsheet font is missing. |
|**[FontSubstitutes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/fontsubstitutes)** | Substitute specific fonts from the source spreadsheet. |
|**[HideComments](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/hidecomments)** | Specify if the comments from the source spreadsheet should be hidden during conversion. |
|**[OnePagePerSheet](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/onepagepersheet)** | If specified, each spreadsheet will be converted into a single page. |
|**[OptimizePdfSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/optimizepdfsize)** | If enabled, optimizes the resulting PDF for smaller file size, rather than for better print quality. |
|**[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/password)** | Defines a password to unlock a protected document. |
|**[SheetIndexes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/sheetindexes/)** | Defines the indexes of the particular sheets to be converted. |
|**[Sheets](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/sheets/)** | Defines the names of the particular sheets to be converted. |
|**[ShowGridLines](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/showgridlines)** | Specify if the grid lines should be visible. |
|**[ShowHiddenSheets](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/showhiddensheets)** | Specify if the hidden sheets should be included in the converted document. |
|**[SkipEmptyRowsAndColumns](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/skipemptyrowsandcolumns)** | Specify if empty rows and columns should be ignored. |
|**[ColumnsPerPage](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/columnsperpage)** | Specifies the number of columns to include on each page when converting large spreadsheets. |
|**[RowsPerPage](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/rowsperpage)** | Specifies the number of rows to include on each page when converting large spreadsheets. |
|**[SkipHeaders](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/skipheaders)** | Specifies the number of header rows to skip during conversion. |
|**[SkipFooters](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/skipfooters)** | Specifies the number of footer rows to skip during conversion. |
|**[PrintComments](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/printcomments)** | Specifies how to render comments during conversion. |
|**[IgnoreFormulaCalculationErrors](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/ignoreformulacalculationerrors)** | If *true*, ignores errors that occur during formula calculation. Useful for spreadsheets with broken or external references. |

### Hide comments

The following code snippet shows how to convert a spreadsheet and hide comments:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    HideComments = true,
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Show grid lines

The following code snippet shows how to convert a spreadsheet and show grid lines:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    ShowGridLines = true,
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Skip empty rows and columns

The following code snippet shows how to convert a spreadsheet and skip empty rows and columns:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    SkipEmptyRowsAndColumns = true,
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify font substitution

The following code snippet shows how to convert a spreadsheet and specify font substitution for missing fonts:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    DefaultFont = "Helvetica",
    FontSubstitutes = new List<FontSubstitute>
    {
        FontSubstitute.Create("Tahoma", "Arial"),
        FontSubstitute.Create("Times New Roman", "Arial"),
    },
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify particular sheets

You can specify the sheets to be converted either by names or by indexes. 

The following code snippet shows how to convert a spreadsheet and specify the desired sheets by their names:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    Sheets = new[] {"Expenses", "Taxes" },
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

The following code snippet shows how to convert a spreadsheet and specify the desired sheets by their zero-based indexes:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    SheetIndexes = new[] { 0, 2 },
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify range

The following code snippet shows how to convert a spreadsheet and specify the exact range of rows and columns to be converted:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    ConvertRange = "10:30",
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Include hidden sheets

The following code snippet shows how to convert a spreadsheet including the hidden sheets:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    ShowHiddenSheets = true,
    OnePagePerSheet = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Automatically fit rows

To fit the row content of all rows while converting from a spreadsheet, set the [AutoFitRows](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/spreadsheetloadoptions/autofitrows/) property to `true`:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SpreadsheetLoadOptions
{
    AutoFitRows = true
};
using (Converter converter = new Converter("sample.xlsx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

---

## Load WordProcessing document with options

Path: /conversion/java/load-wordprocessing-document-with-options/

GroupDocs.Conversion provides the [WordProcessingLoadOptions](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions) class to give you better control over how the source WordProcessing document will be processed. The following options could be set: 

*   **[setFormat](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions#setFormat(com.groupdocs.conversion.filetypes.WordProcessingFileType))** allows you to specify explicitly the type of the source WordProcessing document. Available options are: *Doc, Docm, Docx, Dot, Dotm, Dotx, Rtf, Odt, Ott, Mobi, Txt*.
*   **[setAutoFontSubstitution](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions#setAutoFontSubstitution(boolean))** - if false, GroupDocs.Conversion uses the DefaultFont for the substitution of missing fonts. If true, GroupDocs.Conversion evaluates all the related fields in FontInfo (Panose, Sig, etc.) for the missing font and finds the closest match among the available font sources.   
    Note: that the font substitution mechanism will override the DefaultFont in cases when FontInfo for the missing font is available in the document.
*   **[setDefaultFont](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions#setDefaultFont(java.lang.String))** specifies the font to use if a document font is missing.
*   **[setFontSubstitutes](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions#setFontSubstitutes(java.util.List))** sets substitute specific fonts from the source document.
*   **[setPassword](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions#setPassword(java.lang.String))** specifies a password to unlock the protected document.
*   **[setHideWordTrackedChanges](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions#setHideWordTrackedChanges(boolean))** specifies that tracked changes should not be included in the converted document.
*   **[setHideComments](https://reference.groupdocs.com/java/conversion/com.groupdocs.conversion.options.load/WordProcessingLoadOptions#setHideComments(boolean))** specifies that comments from the source document should be hidden in the converted document.

### Hide comments

The following code snippet shows how to convert a WordProcessing document and hide comments:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
...
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setHideComments(true);

Converter converter = new Converter("sample.docx", loadOptions);
PdfConvertOptions options = new PdfConvertOptions();
converter.convert("converted.pdf", options);
```

### Hide tracked changes

The following code snippet shows how to convert a WordProcessing document and hide tracked changes:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
...
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setHideWordTrackedChanges(true);

Converter converter = new Converter("sample.docx", loadOptions);
PdfConvertOptions options = new PdfConvertOptions();
converter.convert("converted.pdf", options);
```

### Specify font substitution

The following code snippet shows how to convert a WordProcessing document and specify font substitution for missing fonts:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.FontSubstitute;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
import java.util.ArrayList;
import java.util.List;
...
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setAutoFontSubstitution(false);
loadOptions.setDefaultFont("Helvetica");
List<FontSubstitute> fontSubstitutes = new ArrayList<FontSubstitute>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial"));
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial"));
loadOptions.setAutoFontSubstitution(false);
loadOptions.setFontSubstitutes(fontSubstitutes);

Converter converter = new Converter("sample.docx", loadOptions);
PdfConvertOptions options = new PdfConvertOptions();
converter.convert("converted.pdf", options);
```

---

## Load WordProcessing document with options

Path: /conversion/nodejs-java/load-wordprocessing-document-with-options/

GroupDocs.Conversion provides [WordProcessingLoadOptions](#) to give you control over how the source WordProcessing document will be processed. The following options could be set: 

*   **[setFormat](#)** allows you to specify explicitly the type of the source WordProcessing document. Available options are: *Doc, Docm, Docx, Dot, Dotm, Dotx, Rtf, Odt, Ott, Mobi, Txt*.
*   **[setAutoFontSubstitution](#)** whether false, GroupDocs.Conversion uses the DefaultFont for the substitution of missing fonts. If true, GroupDocs.Conversion evaluates all the related fields in FontInfo (Panose, Sig etc) for the missing font and finds the closest match among the available font sources.   
    Note: that the font substitution mechanism will override the DefaultFont in cases when FontInfo for the missing font is available in the document.
*   **[setDefaultFont](#)** specifies the font to use if a document font is missing.
*   **[setFontSubstitutes](#)** sets substitute specific fonts from the source document.
*   **[setPassword](#)** specifies a password to unlock the protected document.
*   **[setHideWordTrackedChanges](#)** specifies that tracked changes should not be included in the converted document.
*   **[setHideComments](#)** specifies that comments from the source document should be hidden in the converted document.

### Hide comments

The following code snippet shows how to convert a WordProcessing document and hide comments:

```js
const loadOptions = new groupdocs.conversion.WordProcessingLoadOptions()
loadOptions.setHideComments(true)

const outputPath = "ConvertWordProcessingByHidingComments.pdf"

const converter = new groupdocs.conversion.Converter("sample.docx", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`WordProcessing document converted successfully to ${outputPath} (by hiding comments)`)
converter.convert(outputPath, convertOptions)
```

### Hide tracked changes

The following code snippet shows how to convert a WordProcessing document and hide tracked changes:

```js
const loadOptions = new groupdocs.conversion.WordProcessingLoadOptions()
loadOptions.setHideWordTrackedChanges(true)

const outputPath = "ConvertWordProcessingByHidingTrackedChanges.pdf"

const converter = new groupdocs.conversion.Converter("sample.docx", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`WordProcessing document converted successfully to ${outputPath} (By hiding tracked changes)`)
converter.convert(outputPath, convertOptions)
```

### Specify font substitution

The following code snippet shows how to convert a WordProcessing document and specify font substitution for missing fonts:

```js
const java = require('java') 

const outputPath = "ConvertWordProcessingBySpecifyingFontSubstitution.pdf"

const fontSubstitutes = java.newInstanceSync("java.util.ArrayList")
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Tahoma", "Arial"));
fontSubstitutes.add(groupdocs.conversion.FontSubstitute.create("Times New Roman", "Arial"));

const loadOptions = new groupdocs.conversion.WordProcessingLoadOptions()
loadOptions.setDefaultFont("Helvetica.ttf");
loadOptions.setAutoFontSubstitution(false);
loadOptions.setFontSubstitutes(fontSubstitutes);

const converter = new groupdocs.conversion.Converter("sample.docx", loadOptions)
const convertOptions = new groupdocs.conversion.PdfConvertOptions()

console.log(`WordProcessing document converted successfully to ${outputPath} (by specifying font subs)`)
converter.convert(outputPath, convertOptions)
```
---

## Memory optimization option

Path: /editor/java/memory-optimization-option/

By default [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) tries to perform computations and complete the task as fast as possible, and if this challenge requires a lot of memory to be used, GroupDocs.Editor does it. However, in some very specific cases, when processing document is very huge, and GroupDocs.Editor works in 32-bit application, which is limited to 2GiB per process, or user machine has very limited amount of free memory, the SystemOutOfMemoryException may occur. In order to solve such problem the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class contains the [`OptimizeMemoryUsage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getOptimizeMemoryUsage--) property:

```java
public boolean getOptimizeMemoryUsage()
public void getOptimizeMemoryUsage(boolean)
```

By default it has a "*false*" value, which means that the memory optimization is disabled for the sake of the best possible performance. By setting a "*true*" user can enable another document generating mechanism, which can significantly decrease memory consumption while generating large documents at the cost of slower generation time while performing the [`Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method.

---

## Memory optimization option

Path: /editor/net/memory-optimization-option/

By default [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) tries to perform computations and complete the task as fast as possible, and if this challenge requires a lot of memory to be used, GroupDocs.Editor does it. However, in some very specific cases, when processing document is very huge, and GroupDocs.Editor works in 32-bit application, which is limited to 2GiB per process, or user machine has very limited amount of free memory, the SystemOutOfMemoryException may occur. In order to solve such problem the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class contains the [`OptimizeMemoryUsage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/optimizememoryusage) property:

```csharp
public bool OptimizeMemoryUsage { get; set; }
```

By default it has a "*false*" value, which means that the memory optimization is disabled for the sake of the best possible performance. By setting a "*true*" user can enable another document generating mechanism, which can significantly decrease memory consumption while generating large documents at the cost of slower generation time while performing the [`editor.Save()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

---

## Memory Optimization Option

Path: /editor/nodejs-java/memory-optimization-option/


By default, [**GroupDocs.Editor**](https://products.groupdocs.com/editor/nodejs-java) aims to perform computations and complete tasks as quickly as possible. If a task requires a lot of memory, GroupDocs.Editor utilizes it to optimize performance. However, in certain scenarios—such as processing very large documents, running in a 32-bit application limited to 2GiB per process, or operating on a machine with limited free memory—a `SystemOutOfMemoryException` may occur. To address this issue, the [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingSaveOptions) class provides the `optimizeMemoryUsage` property:

```javascript
// Getter and Setter for optimizeMemoryUsage
public boolean getOptimizeMemoryUsage()
public void setOptimizeMemoryUsage(boolean value)
```

By default, this property is set to `false`, meaning memory optimization is disabled in favor of achieving the best possible performance. Setting it to `true` enables an alternative document generation mechanism that significantly reduces memory consumption when generating large documents. However, this comes at the cost of slower generation time when performing the `editor.save()` method.

## Example Usage

The following example demonstrates how to enable memory optimization when saving a large WordProcessing document:

```javascript
// Import necessary modules
const groupdocs_editor = require('groupdocs-editor');
const fs = require('fs');

// Load the source WordProcessing document
const editor = new groupdocs_editor.Editor('LargeDocument.docx');

// Create WordProcessingEditOptions if needed
const editOptions = new groupdocs_editor.WordProcessingEditOptions();

// Edit the document to get an EditableDocument instance
const editableDocument = editor.edit(editOptions);

// Create WordProcessingSaveOptions
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions();

// Enable memory optimization
saveOptions.optimizeMemoryUsage = true;

// Save the edited document with memory optimization enabled
editor.save(editableDocument, 'OutputDocument.docx', saveOptions);

console.log('Document saved successfully with memory optimization enabled.');
```

**Note:**

- Replace `'LargeDocument.docx'` with the path to your large WordProcessing document.
- Enabling `optimizeMemoryUsage` reduces memory consumption but may increase the time it takes to save the document.

## Important Considerations

- **Performance Trade-off:** Enabling memory optimization reduces memory usage but may result in slower document generation. Use this option when dealing with very large documents or limited memory environments.
- **Default Behavior:** By default, `optimizeMemoryUsage` is set to `false` to prioritize performance.
- **Exception Handling:** If you encounter a `SystemOutOfMemoryException` or similar memory-related issues, consider enabling this option.

## Conclusion

The `optimizeMemoryUsage` property in `WordProcessingSaveOptions` offers a way to handle large documents efficiently when using GroupDocs.Editor for Node.js via Java. By adjusting this setting, you can balance memory consumption and performance according to your application's requirements.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.
---

## eSign document with multiple signatures

Path: /signature/net/esign-document-with-multiple-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) allows signing a document with several signatures simultaneously and even apply signatures of different types to the same document.

Doing this is as simple as:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path or stream as a constructor parameter.
* Instantiate all required sign options objects depending on signature type:
    * [BarcodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/barcodesignoptions) - for Barcode signatures;
    * [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) - for Digital signatures;
    * [FormFieldSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/formfieldsignoptions) - for Form-field signatures;
    * [ImageSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagesignoptions) - for Image signatures;
    * [MetadataSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasignoptions) - for Metadata signatures;
    * [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) - for QR-code signatures
    * [StampSIgnOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/stampsignoptions) - for Stamp signatures;
    * [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) - for Text signatures.
* Fill the collection with sign options from the previous step.  
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the collection of sign options to it.

This code snippet below demonstrates how to eSign a PDF document with multiple signatures at the same time.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    // define several signature options of different types and settings
    TextSignOptions textOptions = new TextSignOptions("This is test message")
    {
        VerticalAlignment = VerticalAlignment.Top,
        HorizontalAlignment = HorizontalAlignment.Left
    };

    BarcodeSignOptions barcodeOptions = new BarcodeSignOptions("123456")
    {
        EncodeType = BarcodeTypes.Code128,
        Left = 100,
        Top = 100
    };
    QrCodeSignOptions qrcodeOptions = new QrCodeSignOptions("JohnSmith")
    {
        EncodeType = QrCodeTypes.QR,
        Left = 100,
        Top = 200
    };
    DigitalSignOptions digitalOptions = new DigitalSignOptions("certificate.pfx")
    {
        ImageFilePath = Constants.ImageHandwrite,
        VerticalAlignment = VerticalAlignment.Center,
        HorizontalAlignment = HorizontalAlignment.Center,
        Password = "1234567890"
    };
    // define list of signature options
    List<SignOptions> listOptions = new List<SignOptions>();
    listOptions.Add(textOptions);
    listOptions.Add(barcodeOptions);
    listOptions.Add(qrcodeOptions);
    listOptions.Add(digitalOptions);

    // sign document to file
    signature.Sign("signed.pdf", listOptions);
}    
```
### Summary
This guide demonstrates how to apply multiple types of electronic signatures (e.g., text, barcode, image) to a document using [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) . It explains how to combine different signature types, configure each one, and save the signed document with multiple signature styles.
### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Render web documents as PDF, PNG, and JPEG files

Path: /viewer/java/render-web-documents/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render web documents as PDF, PNG, and JPEG files. Use this library to view web files within your Java application. 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a web document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to PDF or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/web" >}} {{< icon "gdoc_person" >}} View web files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported web file formats

GroupDocs.Viewer supports the following web file formats:

* [Hypertext Markup Language Format](https://docs.fileformat.com/web/html/) (.HTML / .HTM)
* [MIME HTML Format](https://docs.fileformat.com/web/mhtml/) (.MHTML)
* [MHTML Web Archive](https://docs.fileformat.com/web/mht/) (.MHT)
* [Compiled HTML Help Format](https://docs.fileformat.com/web/chm/) (.CHM)

## Render web documents as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a web file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("groupdocs-documentation.mhtml")) {
    // Create a PDF file for the document.
    // Specify the PDF file name.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PDF](/viewer/java/images/rendering-basics/render-web-documents/render-web-to-pdf.png)

## Render web documents as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a web file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("groupdocs-documentation.mhtml")) {
    // Convert the web file to PNG.
    // {0} is replaced with the page numbers in the output image names.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(800);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PNG](/viewer/java/images/rendering-basics/render-web-documents/render-web-to-png.png)

## Render web documents as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a web file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("groupdocs-documentation.mhtml")) {
    // Create a JPEG image for each drawing page.
    // {0} is replaced with the current page number in the image name.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(1600);
    viewOptions.setHeight(650);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Convert CHM files to HTML

[CHM](https://docs.fileformat.com/web/chm/) is a Microsoft proprietary online help format that is often used for software documentation. With GroupDocs.Viewer, you can convert a CHM file to HTML to display this file in a web browser. To do this, create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.chm")) {
    // Convert the CHM file to HTML.
    // {0} is replaced with the page numbers in the output file names.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("chm_result_{0}.html");
    // Enable the following option to display all CHM content on a single HTML page.
    // viewOptions.setRenderToSinglePage(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to HTML](/viewer/java/images/rendering-basics/render-web-documents/render-chm-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.chm")) {
    // Convert the CHM file to HTML.
    // Specify the output file names and location of external resources.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Render web documents as PDF, PNG, and JPEG files

Path: /viewer/net/render-web-documents/


[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render web documents as PDF, PNG, and JPEG files. Use this library to view web files within your .NET application. 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a web document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to PDF or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/web" >}} {{< icon "gdoc_person" >}} View web files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported web file formats

GroupDocs.Viewer supports the following web file formats:

* [Hypertext Markup Language Format](https://docs.fileformat.com/web/html/) (.HTML / .HTM)
* [MIME HTML Format](https://docs.fileformat.com/web/mhtml/) (.MHTML)
* [MHTML Web Archive](https://docs.fileformat.com/web/mht/) (.MHT)
* [Compiled HTML Help Format](https://docs.fileformat.com/web/chm/) (.CHM)

GroupDocs.Viewer can detect the document format automatically by analyzing file contents.

## Render web documents as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a web file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("groupdocs-documentation.mhtml"))
{
    // Create a PDF file for the document.
    // Specify the PDF file name.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("groupdocs-documentation.mhtml")
            ' Create a PDF file for the document.
            ' Specify the PDF file name.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PDF](/viewer/net/images/rendering-basics/render-web-documents/render-web-to-pdf.png)

## Render web documents as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a web file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("groupdocs-documentation.mhtml"))
{
    // Convert the web file to PNG.
    // {0} is replaced with the page numbers in the output image names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("groupdocs-documentation.mhtml")
            ' Convert the web file to PNG.
            ' {0} is replaced with the page numbers in the output image names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PNG](/viewer/net/images/rendering-basics/render-web-documents/render-web-to-png.png)

## Render web documents as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a web file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("groupdocs-documentation.mhtml"))
{
    // Convert the web file to JPEG.
    // {0} is replaced with the page numbers in the output image names.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("groupdocs-documentation.mhtml")
            ' Convert the web file to JPEG.
            ' {0} is replaced with the page numbers in the output image names.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Convert CHM files to HTML

[CHM](https://docs.fileformat.com/web/chm/) is a Microsoft proprietary online help format that is often used for software documentation. With GroupDocs.Viewer, you can convert a CHM file to HTML to display this file in a web browser. To do this, create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.chm"))
{
    // Convert the CHM file to HTML.
    // {0} is replaced with the page numbers in the output file names.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("chm_result_{0}.html");
    // Enable the following option to display all CHM content on a single HTML page.
    // options.RenderToSinglePage = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.chm")
            ' Convert the CHM file to HTML.
            ' {0} is replaced with the page numbers in the output file names.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("chm_result_{0}.html")
            ' Enable the following option to display all CHM content on a single HTML page.
            ' options.RenderToSinglePage = true;
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to HTML](/viewer/net/images/rendering-basics/render-web-documents/render-chm-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.chm"))
{
    // Convert the CHM file to HTML.
    // Specify the output file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.chm")
            ' Convert the CHM file to HTML.
            ' Specify the output file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}


## Specify rendering options

GroupDocs.Viewer supports the [WebDocumentOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions) class that allows you to specify different options for rendering web files. To access these options, use the [WebDocumentOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/webdocumentoptions) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

### Adjust page margins

Use the following properties to specify the size of page margins in the output files when you convert your web documents to HTML, PDF, and image formats: 

* [WebDocumentOptions.TopMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/topmargin)---Specifies the distance (in points) between the top edge of the page and the top boundary of the body text. The default value is 72 points.
* [WebDocumentOptions.BottomMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/bottommargin)---Specifies the distance (in points) between the bottom edge of the page and the bottom boundary of the body text. The default value is 72 points.
* [WebDocumentOptions.LeftMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/leftmargin)---Specifies the distance (in points) between the left edge of the page and the left boundary of the body text. The default value is 5 points.
* [WebDocumentOptions.RightMargin](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/rightmargin)---Specifies the distance (in points) between the right edge of the page and the right boundary of the body text. The default value is 5 points.

The example below converts a web document to PDF and specifies page margins for the output file. 

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("groupdocs-documentation.mhtml"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify the size of page margins in points.
    viewOptions.WebDocumentOptions.LeftMargin = 40;
    viewOptions.WebDocumentOptions.RightMargin = 40;
    viewOptions.WebDocumentOptions.TopMargin = 40;
    viewOptions.WebDocumentOptions.BottomMargin = 40;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("groupdocs-documentation.mhtml")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify the size of page margins in points.
            viewOptions.WebDocumentOptions.LeftMargin = 40
            viewOptions.WebDocumentOptions.RightMargin = 40
            viewOptions.WebDocumentOptions.TopMargin = 40
            viewOptions.WebDocumentOptions.BottomMargin = 40
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Set the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert your web document to another format. Assign a [PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pagesize) enumeration member to the [WebDocumentOptions.PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/webdocumentoptions/properties/pagesize) property to select one of the predefined page sizes (Letter, Ledger, A0, A1, A2, A3, or A4).

The following example specifies page size for the output PDF file:

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("groupdocs-documentation.mhtml"))
{
    // Convert the document to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify the page size.
    viewOptions.WebDocumentOptions.PageSize = PageSize.A3;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("groupdocs-documentation.mhtml")
            ' Convert the document to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify the page size.
            viewOptions.WebDocumentOptions.PageSize = PageSize.A3
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Render web documents as PDF, PNG, and JPEG files

Path: /viewer/nodejs-java/render-web-documents/

[GroupDocs.Viewer for Node.js](https://products.groupdocs.com/viewer/nodejs-java) allows you to render web documents as PDF, PNG, and JPEG files. Use this library to view web files within your Java application. 

To start using the GroupDocs.Viewer API, create a [Viewer](#) class instance. Pass a web document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](#) method overloads to convert the document to PDF or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/web" >}} {{< icon "gdoc_person" >}} View web files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported web file formats

GroupDocs.Viewer supports the following web file formats:

* [Hypertext Markup Language Format](https://docs.fileformat.com/web/html/) (.HTML / .HTM)
* [MIME HTML Format](https://docs.fileformat.com/web/mhtml/) (.MHTML)
* [MHTML Web Archive](https://docs.fileformat.com/web/mht/) (.MHT)
* [Compiled HTML Help Format](https://docs.fileformat.com/web/chm/) (.CHM)

## Render web documents as PDF

Create a [PdfViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a web file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-web-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("groupdocs-documentation.mhtml")
 // Create a PDF file for the document.
// Specify the PDF file name.
const viewOptions = PdfViewOptions("render-web-to-pdf/mhtml-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "groupdocs-documentation.mhtml" >}}
{{< tab-text >}}
`groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PDF](/viewer/nodejs-java/images/rendering-basics/render-web-documents/render-web-to-pdf.png)

## Render web documents as PNG

Create a [PngViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a web file to PNG. Use the [PngViewOptions.setHeight](#) and [PngViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-web-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("groupdocs-documentation.mhtml")
// Convert the web file to PNG.
// {0} is replaced with the page numbers in the output image names.
const viewOptions = PngViewOptions("render-web-to-png/mhtml-to-png-page_{0}.png")
 // Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(800)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "groupdocs-documentation.mhtml" >}}
{{< tab-text >}}
`groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PNG](/viewer/nodejs-java/images/rendering-basics/render-web-documents/render-web-to-png.png)

## Render web documents as JPEG

Create a [JpgViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a web file to JPEG. Use the [JpgViewOptions.setHeight](#) and [JpgViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-web-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("groupdocs-documentation.mhtml")
// Create a JPEG image for each drawing page.
// {0} is replaced with the current page number in the image name.
const viewOptions = JpgViewOptions("render-web-to-jpeg/mhtml-to-jpg-page_{0}.jpg")
 // Set width and height.
viewOptions.setWidth(1600)
viewOptions.setHeight(650)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "groupdocs-documentation.mhtml" >}}
{{< tab-text >}}
`groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Convert CHM files to HTML

[CHM](https://docs.fileformat.com/web/chm/) is a Microsoft proprietary online help format that is often used for software documentation. With GroupDocs.Viewer, you can convert a CHM file to HTML to display this file in a web browser. To do this, create an [HtmlViewOptions](#) class instance and pass it to the [Viewer.view](#) method. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](#) method and specify the output file name.

{{< tabs "render-chm-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.chm")
// Convert the CHM file to HTML.
// {0} is replaced with the page numbers in the output file names.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-chm-to-html-embedded/chm-to-html-page_{0}.html")
// Enable the following option to display all CHM content on a single HTML page.
// viewOptions.setRenderToSinglePage(true);
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.chm" >}}
{{< tab-text >}}
`sample.chm` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-web-documents/sample.chm) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to HTML](/viewer/nodejs-java/images/rendering-basics/render-web-documents/render-chm-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.forExternalResources](#) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-chm-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.chm")
// Convert the CHM file to HTML.
// Specify the output file names and location of external resources.
const viewOptions = HtmlViewOptions.forExternalResources("render-chm-to-html-external/chm-to-html-page_{0}.html", "render-chm-to-html-external/chm-to-html-page_{0}/resource_{0}_{1}", "render-chm-to-html-external/chm-to-html-page_{0}/resource_{0}_{1}");
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.chm" >}}
{{< tab-text >}}
`sample.chm` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-web-documents/sample.chm) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Render web documents as PDF, PNG, and JPEG files

Path: /viewer/python-net/render-web-documents/

[GroupDocs.Viewer for Python](https://products.groupdocs.com/viewer/python-net) allows you to render web documents as PDF, PNG, and JPEG files. Use this library to view web files within your Java application. 

To start using the GroupDocs.Viewer API, create a [Viewer](#) class instance. Pass a web document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to PDF or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/web" >}} {{< icon "gdoc_person" >}} View web files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported web file formats

GroupDocs.Viewer supports the following web file formats:

* [Hypertext Markup Language Format](https://docs.fileformat.com/web/html/) (.HTML / .HTM)
* [MIME HTML Format](https://docs.fileformat.com/web/mhtml/) (.MHTML)
* [MHTML Web Archive](https://docs.fileformat.com/web/mht/) (.MHT)
* [Compiled HTML Help Format](https://docs.fileformat.com/web/chm/) (.CHM)

## Render web documents as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a web file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_web_to_pdf():
    # Load web document
    with Viewer("groupdocs-documentation.mhtml") as viewer:
        # Create a PDF file for the document.
        # Specify the PDF file name.
        viewOptions = PdfViewOptions("render_web_to_pdf/optimized_for_web.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_web_to_pdf()
```
{{< /tab >}}
{{< tab "groupdocs-documentation.mhtml" >}}
{{< tab-text >}}
`groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PDF](/viewer/python-net/images/rendering-basics/render-web-documents/render-web-to-pdf.png)

## Render web documents as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a web file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_web_to_png():
    # Load web document
    with Viewer("groupdocs-documentation.mhtml") as viewer:
        # Convert the web file to PNG.
        # {0} is replaced with the page numbers in the output image names.
        viewOptions = PngViewOptions("render_web_to_png/optimized_for_web_{0}.pdf")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 800
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_web_to_png()
```
{{< /tab >}}
{{< tab "groupdocs-documentation.mhtml" >}}
{{< tab-text >}}
`groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to PNG](/viewer/python-net/images/rendering-basics/render-web-documents/render-web-to-png.png)

## Render web documents as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a web file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_web_to_jpg():
    # Load web document
    with Viewer("groupdocs-documentation.mhtml") as viewer:
        # Create a JPEG image for each page.
        # {0} is replaced with the current page number in the image name.
        viewOptions = JpgViewOptions("render_web_to_jpg/web_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 1600
        viewOptions.height = 650
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_web_to_jpg()
```
{{< /tab >}}
{{< tab "groupdocs-documentation.mhtml" >}}
{{< tab-text >}}
`groupdocs-documentation.mhtml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-web-documents/groupdocs-documentation.mhtml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Convert CHM files to HTML

[CHM](https://docs.fileformat.com/web/chm/) is a Microsoft proprietary online help format that is often used for software documentation. With GroupDocs.Viewer, you can convert a CHM file to HTML to display this file in a web browser. To do this, create an [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create an HTML file with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_chm_to_html():
    # Load CHM file
    with Viewer("sample.chm") as viewer:
        # Convert the CHM file to HTML.
        # {0} is replaced with the page numbers in the output file names.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_chm_to_html/chm_result_{0}.html")
        # Enable the following option to display all CHM content on a single HTML page.
        # viewOptions.render_to_single_page = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_chm_to_html()
```
{{< /tab >}}
{{< tab "sample.chm" >}}
{{< tab-text >}}
`sample.chm` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-web-documents/sample.chm) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a web file to HTML](/viewer/python-net/images/rendering-basics/render-web-documents/render-chm-to-html.png)

### Create an HTML file with external resources

If you want to store an HTML file and additional resource files (such as fonts, images, and stylesheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_chm_to_html_external():
    # Load CHM file
    with Viewer("sample.chm") as viewer:
        # Convert the CHM file to HTML.
        # Specify the output file names and location of external resources.
        viewOptions = HtmlViewOptions.for_external_resources("render_chm_to_html_external/pdf_page_{0}.html", "render_chm_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_chm_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_chm_to_html_external()
```
{{< /tab >}}
{{< tab "sample.chm" >}}
{{< tab-text >}}
`sample.chm` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-web-documents/sample.chm) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Rotate pages

Path: /merger/net/rotate-pages/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** allows to change page rotation angle by setting it to 90, 180 or 270 degrees for specific or all document pages.  
Here are the steps to change page rotation:

*   Initialize [RotateOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/rotateoptions) class with desired rotation angle and page numbers;
*   Instantiate [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object with source document path or stream;
*   Call [RotatePages](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/rotatepages) method and pass [RotateOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/rotateoptions) object to it;
*   Call [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method specifying file path to save resultant document.

The following code sample demonstrates how to change page rotation:

```csharp
string filePath = @"c:\sample.pdf";
string filePathOut = @"c:\output\result.pdf";

RotateOptions rotateOptions = new RotateOptions(RotateMode.Rotate180, new int[] { 2, 3, 6 });

using (Merger merger = new Merger(filePath))
{
    merger.RotatePages(rotateOptions);
    merger.Save(filePathOut);
}
```

---

## Set resolution of document preview.

Path: /annotation/net/set-document-preview-resolution/


GroupDocs.Annotation v21.5 and later allows you to set resolution of the document's preview. By default, it is 96 points per inch. Set the [Resolution](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions/properties/resolution) property of the [PreviewOptions](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.options/previewoptions) class to change the resolution.

The following code snippets shows how to set preview resolution to 144 PPI:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf"))
{
    PreviewOptions previewOptions = new PreviewOptions(pageNumber =>
    {
        var pagePath = $"result_{pageNumber}.png";
        return File.Create(pagePath);
    })
    {
        // Set resolution
        Resolution = 144
    };

    annotator.Document.GeneratePreview(previewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Sign document with Image signature - advanced

Path: /signature/java/sign-document-with-image-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) class to specify different options for Image signature as follow

*   signature alignment ([setHorizontalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setHorizontalAlignment(int)), [setVerticalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setVerticalAlignment(int)))
*   margins ([setMargin](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions#setMargin(com.groupdocs.signature.domain.Padding)))
*   additional extensions and appearances ([setExtensions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setExtensions(java.util.List)), [setAppearance](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/SignOptions#setAppearance(com.groupdocs.signature.options.appearances.SignatureAppearance)))

Here are the steps to add Image signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) object according to your requirements and specify image signature options.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [ImageSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/ImageSignOptions) to it.      
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

  

This example shows how to specify different Image signature options. See [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) 

```java
Signature signature = new Signature(sample.xlsx);
 
ImageSignOptions options = new ImageSignOptions("sample.jpg");
 
// set signature position
options.setLeft(100);
options.setTop(100);
 
// set signature rectangle
options.setWidth(100);
options.setHeight(30);
 
// set signature alignment
// when VerticalAlignment is set the Top coordinate will be ignored.
// Use Margin properties Top, Bottom to provide vertical offset
options.setVerticalAlignment(VerticalAlignment.Top);
 
// when HorizontalAlignment is set the Left coordinate will be ignored.
// Use Margin properties Left, Right to provide horizontal offset
options.setHorizontalAlignment(HorizontalAlignment.Right);
 
Padding padding = new Padding();
padding.setRight(20);
padding.setTop(20);
options.setMargin(padding);
 
// set rotation
options.setRotationAngle(45);
 
//setup signature border
Border border = new Border();
border.setColor(Color.GREEN);
border.setDashStyle(DashStyle.DashLongDashDot);
border.setWeight(5);
border.setVisible(true);

options.setBorder(border);
 
// sign document to file
SignResult signResult = signature.sign("sgnedSample.xlsx", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App  

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## URI rewriting

Path: /markdown/net/uri-rewriting/


Use `UriExportStrategy` with `CustomUriExportStrategy` and `IUriSavingHandler` to rewrite resource URIs in the Markdown output. This is useful when images are served from a CDN or a different path than where they're saved.

{{< alert style="info" >}}
URI rewriting works with file-based image strategies (`ExportImagesToFileSystemStrategy` or `CustomImagesStrategy`). It has no effect when images are embedded as Base64.
{{< /alert >}}

### Prepend a CDN base URL

{{< tabs "uri-cdn">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

public class CdnUriHandler : IUriSavingHandler
{
    public void Handle(UriSavingArgs args)
    {
        args.SetResourceFileUri("https://cdn.example.com/assets/" + args.ResourceFileName);
    }
}

var options = new ConvertOptions
{
    ImageExportStrategy = new ExportImagesToFileSystemStrategy("output/images")
    {
        ImagesRelativePath = "images"
    },
    UriExportStrategy = new CustomUriExportStrategy(new CdnUriHandler())
};

MarkdownConverter.ToFile("business-plan.docx", "output/report.md", options);
// Images saved locally to output/images/
// Markdown references: ![](https://cdn.example.com/assets/img-001.png)
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "uri-cdn.zip" >}}  
```text
output/images/img-001.png (4 KB)
output/images/img-002.jpg (41 KB)
output/images/img-003.png (14 KB)
output/report.md (5 KB)
```
[Download full output](/markdown/net/_output_files/developer-guide/advanced-usage/uri-rewriting/UriCdn/uri-cdn.zip)
{{< /tab >}}
{{< /tabs >}}

### UriSavingArgs properties

| Property | Description |
|---|---|
| `ResourceFileName` | Default file name generated by the library |
| `ResourceFileUri` | Default URI that would appear in the Markdown |
| `SetResourceFileUri(string)` | Override the URI written to the Markdown output |

---

## URI rewriting

Path: /markdown/python-net/uri-rewriting/


Use `uri_export_strategy` with `CustomUriExportStrategy` and a Python callable to rewrite resource URIs in the Markdown output. This is useful when images are served from a CDN or a different path than where they're saved.

{{< alert style="info" >}}
URI rewriting works with file-based image strategies (`ExportImagesToFileSystemStrategy` or `CustomImagesStrategy`). It has no effect when images are embedded as Base64.
{{< /alert >}}

### Prepend a CDN base URL

{{< tabs "uri-rewriting-cdn">}}
{{< tab "uri_rewriting_cdn.py" >}}  
```python
from groupdocs.markdown import (
    MarkdownConverter, ConvertOptions,
    ExportImagesToFileSystemStrategy, CustomUriExportStrategy
)

def uri_rewriting_cdn():
    """Rewrite image URIs to point to a CDN base URL in the Markdown output."""

    # Step 1: Define the CDN base URL
    CDN_BASE = "https://cdn.example.com/assets/"

    # Step 2: Create a handler that prepends the CDN URL to each resource
    def cdn_handler(call_info):
        """Called for each resource URI during conversion.
        Receives context with ResourceFileName, ResourceFileUri.
        Returns dict with resource_file_uri to override the URI."""
        ctx = call_info["context"]
        original = ctx["ResourceFileName"]
        return {"resource_file_uri": CDN_BASE + original}

    # Step 3: Configure image and URI export strategies
    options = ConvertOptions()
    options.image_export_strategy = ExportImagesToFileSystemStrategy("./output/images")
    options.uri_export_strategy = CustomUriExportStrategy(cdn_handler)

    # Step 4: Convert and save using keyword argument for options
    MarkdownConverter.to_file("business-plan.docx", "output/report.md", convert_options=options)
    # Images saved locally to output/images/
    # Markdown references: ![](https://cdn.example.com/assets/img-001.png)

if __name__ == "__main__":
    import os
    os.makedirs("output/images", exist_ok=True)
    uri_rewriting_cdn()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/developer-guide/advanced-usage/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "uri-rewriting-cdn.zip" >}}  
```text
output/report.txt (21 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/uri-rewriting/uri_rewriting_cdn/uri-rewriting-cdn.zip)
{{< /tab >}}
{{< tab "uri-rewriting-cdn.zip" >}}  
```text
output/images/img-001.jpg (56 KB)
output/report.txt (20 KB)
```
[Download full output](/markdown/python-net/_output_files/developer-guide/advanced-usage/uri-rewriting/uri_rewriting_cdn/uri-rewriting-cdn.zip)
{{< /tab >}}
{{< /tabs >}}

### UriSavingArgs properties

| Property | Description |
|---|---|
| `ResourceFileName` | Default file name generated by the library |
| `ResourceFileUri` | Default URI that would appear in the Markdown |
| `resource_file_uri` | Override the URI written to the Markdown output (return value) |

---

## Word forms provider

Path: /search/java/word-forms-provider/

The [IWordFormsProvider](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface is designed to implement a word forms provider for searching by word forms. For information on searching by word forms, see [Search for different word forms]({{< ref "search/java/developer-guide/advanced-usage/searching/search-for-different-word-forms.md" >}}) page.

The [IWordFormsProvider](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface contains only one [getWordForms](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/IWordFormsProvider#getWordForms(java.lang.String)) method, which returns various forms for the word passed as an argument. An example implementation of a simple provider of word forms is presented below.



```java
public class SimpleWordFormsProvider implements IWordFormsProvider {
    public final String[] getWordForms(String word)     {
        ArrayList<String> result = new ArrayList<String>();
 
        // Assume that the input word is in the plural, then we add the singular
        if (word.length() > 2 &&
            word.toLowerCase().endsWith("es")) {
            result.add(word.substring(0, word.length() - 2));
        }
        if (word.length() > 1 &&
            word.toLowerCase().endsWith("s")) {
            result.add(word.substring(0, word.length() - 1));
        }
 
        // Then assume that the input word is in the singular, we add the plural
        if (word.length() > 1 &&
            word.toLowerCase().endsWith("y")) {
            result.add(word.substring(0, word.length() - 1).concat("is"));
        }
        result.add(word.concat("s"));
        result.add(word.concat("es"));
        // All rules are implemented in the EnglishWordFormsProvider class
 
        return result.toArray(new String[0]);
    }
}
```

By default, the [EnglishWordFormsProvider](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/EnglishWordFormsProvider) class is used, which for English generates various forms of nouns, adjectives, pronouns, verbs, etc. An example of setting a custom provider of word forms is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Setting the custom word forms provider instance
index.getDictionaries().setWordFormsProvider(new SimpleWordFormsProvider());
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.setUseWordFormsSearch(true); // Enabling search for word forms
 
// Searching in the index
SearchResult result = index.search("relative", options);
 
// The following words can be found:
// relative
// relatives
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Word forms provider

Path: /search/net/word-forms-provider/

The [IWordFormsProvider](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/iwordformsprovider) interface is designed to implement a word forms provider for searching by word forms. For information on searching by word forms, see [Search for different word forms]({{< ref "search/net/developer-guide/advanced-usage/searching/search-for-different-word-forms.md" >}}) page.

The [IWordFormsProvider](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/iwordformsprovider) interface contains only one [GetWordForms](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/iwordformsprovider/methods/getwordforms) method, which returns various forms for the word passed as an argument. An example implementation of a simple provider of word forms is presented below.

**C#**

```csharp
public class SimpleWordFormsProvider : IWordFormsProvider
{
    public string[] GetWordForms(string word)
    {
        List<string> result = new List<string>();
 
        // We assume that the input word is in the plural, then we add the singular
        if (word.Length > 2 &&
            word.EndsWith("es", StringComparison.InvariantCultureIgnoreCase))
        {
            result.Add(word.Substring(0, word.Length - 2));
        }
        if (word.Length > 1 &&
            word.EndsWith("s", StringComparison.InvariantCultureIgnoreCase))
        {
            result.Add(word.Substring(0, word.Length - 1));
        }
 
        // Then we assume that the input word is in the singular, we add the plural
        if (word.Length > 1 &&
            word.EndsWith("e", StringComparison.InvariantCultureIgnoreCase))
        {
            result.Add(word + "s");
        }
        if (word.Length > 1 &&
            word.EndsWith("y", StringComparison.InvariantCultureIgnoreCase))
        {
            result.Add(word.Substring(0, word.Length - 1) + "is");
        }
        result.Add(word + "es");
        // All rules are implemented in the EnglishWordFormsProvider class
 
        return result.ToArray();
    }
}
```

By default, the **[EnglishWordFormsProvider](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/englishwordformsprovider)** class is used, which for English generates various forms of nouns, adjectives, pronouns, verbs, etc. An example of setting a custom provider of word forms is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Setting the custom word forms provider instance
index.Dictionaries.WordFormsProvider = new SimpleWordFormsProvider();
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.UseWordFormsSearch = true; // Enabling search for word forms
 
// Searching in the index
SearchResult result = index.Search("relative", options);
 
// The following words can be found:
// relative
// relatives
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Word forms provider

Path: /search/nodejs-java/word-forms-provider/

The [IWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface is designed to implement a word forms provider for searching by word forms. For information on searching by word forms, see [Search for different word forms]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-for-different-word-forms.md" >}}) page.

The [IWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface contains only one [getWordForms](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/IWordFormsProvider#getWordForms(java.lang.String)) method, which returns various forms for the word passed as an argument. An example implementation of a simple provider of word forms is presented below.

```javascript
const wordFormsProvider = java.newProxy('com.groupdocs.search.dictionaries.IWordFormsProvider', {
  getWordForms: function (word) {
    const result = [];

    // Assume that the input word is in the plural, then we add the singular
    if (word.length > 2 && word.toLowerCase().endsWith('es')) {
      result.push(word.substr(0, word.length - 2));
    }
    if (word.length > 1 && word.toLowerCase().endsWith('s')) {
      result.push(word.substr(0, word.length - 1));
    }

    // Then assume that the input word is in the singular, we add the plural
    if (word.length > 1 && word.toLowerCase().endsWith('y')) {
      result.push(word.substr(0, word.length - 1) + 'is');
    }
    result.push(word + 's');
    result.push(word + 'es');
    // All rules are implemented in the EnglishWordFormsProvider class

    return java.newArray('java.lang.String', result);
  },
});
```

By default, the [EnglishWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/EnglishWordFormsProvider) class is used, which for English generates various forms of nouns, adjectives, pronouns, verbs, etc. An example of setting a custom provider of word forms is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, true);

// Subscribing to the event
index.getEvents().ErrorOccurred.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log(args.getMessage());
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);

String.prototype.endsWith = function (str) {
  var lastIndex = this.lastIndexOf(str);
  return lastIndex !== -1 && lastIndex + str.length === this.length;
};

// Setting the custom word forms provider instance
const wordFormsProvider = ... // See code example above
index.getDictionaries().setWordFormsProvider(wordFormsProvider);

// Creating a search options instance
const options = new groupdocs.search.SearchOptions();
options.setUseWordFormsSearch(true); // Enabling search for word forms

// Searching in the index
const query = 'mrs';
const result = index.search(query, options);

// The following words can be found:
// mrs
// mr
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with metadata in HEIF/HEIC images

Path: /metadata/java/working-with-metadata-in-heic-heif-images/

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in HEIF/HEIC images. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in HEIF/HEIC images. Please find appropriate code samples in the [Working with EXIF Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in HEIF/HEIC images

Path: /metadata/net/working-with-metadata-in-heic-heif-images/

## Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in HEIF/HEIC images. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in HEIF/HEIC images. Please find appropriate code samples in the [Working with EXIF metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Working with metadata in TIFF images

Path: /metadata/java/working-with-metadata-in-tiff-images/

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in TIFF images. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in TIFF images. Please find appropriate code samples in the [Working with EXIF Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## Working with IPTC metadata

GroupDocs.Metadata for Java is also able to work with IPTC metadata in TIFF images. Please find more information in the [Working with IPTC IIM Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-iptc-iim-metadata.md" >}}) section.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in TIFF images

Path: /metadata/net/working-with-metadata-in-tiff-images/

## Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in TIFF images. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in TIFF images. Please find appropriate code samples in the [Working with EXIF metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## Working with IPTC metadata

GroupDocs.Metadata for .NET is also able to work with IPTC metadata in TIFF images. Please find more information in the [Working with IPTC IIM metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-iptc-iim-metadata.md" >}}) section.

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Sign document with Metadata signature - advanced

Path: /signature/net/sign-document-with-metadata-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to secure Metadata signatures, same as embed into it data objects. These feature are implemented over data serialization and encryption. Also there is ability to provide custom data serialization and encryption to secure your signature data the most. Here are feature summary

* ability to encrypt Metadata signature string values
* ability to embedded custom objects into Metadata signatures with data encryption
* ability to specify custom objects encryption
* ability to implement custom data serialization  
  
## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Searching for document signatures excluding external components

Path: /signature/java/searching-for-document-signatures-excluding-external-components/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides boolean property [setSkipExternal](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions#setSkipExternal(boolean)) of [SearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions) class to specify if searching process should exclude external signatures (external signatures are the signatures that were added with an 3rd party software and not with GroupDocs.Signature).

Since 20.3 version every time when document is being signed information about document signatures are stored in document's metadata. Which means that all created signatures by GroupDocs.Signature can be distinguished from an actual document content and [setSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature#setSignature(boolean)) flag will be set as true. [setSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature#setSignature(boolean)) property specifies if document component (text/image/barcode/qr-code) is the actual signature or element of document content.

In order to convert signatures added by 3rd party software or by previous version of GroupDocs.Signature, just run [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions))with[setSkipExternal](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions#setSkipExternal(boolean)) property set to false (this is default value) and update [setSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature#setSignature(boolean)) for each signature returned by the search result.

There are few ways to manipulate with document signature search results:

*   If signature is no longer required it can be removed from the document by [delete](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#delete(java.io.OutputStream,%20java.util.List)) method;
*   Signature could be marked as document native content by setting up [setSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature#setSignature(boolean)) = false property,in this case [setSkipExternal](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions#setSkipExternal(boolean)) field will allow [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions)) method to skip this signature;
*   Signatures that were added before 20.3 are treated as non signatures because information about them are not yet stored in the document. Setting [setSkipExternal](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions#setSkipExternal(boolean)) flag to true will exclude these signatures from [Search](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#search(int...))result.

Here are the steps to search for signatures and exclude external components of the document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.
*   Instantiate the [SearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions) object according to your requirements and specify [setSkipExternal ](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions#setSkipExternal(boolean)) to true 
*   Call [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions))  method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [SearchOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions) to it.
    

## Excluding external signatures from search

Following example demonstrates usage of [setSkipExternal ](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.search/SearchOptions#setSkipExternal(boolean))  property for excluding non actual signatures from search result

**Using SearchOptions SkipExternal property to exclude non actual signatures from search**

```java
Signature signature = new Signature("sample_signed.pdf");
 
TextSearchOptions options = new TextSearchOptions();
options.setSkipExternal(true);
options.setAllPages(false);
// search for text signatures in document
List<TextSignature> signatures = signature.search(TextSignature.class,options);
System.out.print("\nSource document contains following text signature(s).");
// enumerate all signature for output
//foreach to while statements conversion
 
try
{
    for (TextSignature sign : signatures)
    {
        if (sign != null)
        {
            System.out.print("Found Text signature at page "+sign.getPageNumber()+" with type ["+sign.getSignatureImplementation()+"] and text '"+sign.getText()+"'.");
            System.out.print("Location at "+sign.getLeft()+"-"+sign.getTop()+". Size is "+sign.getWidth()+"x"+sign.getHeight()+".");
        }
    }
}
catch (Exception ex) {
    System.out.print("System Exception: " + ex.getMessage());
}
```

## Updating signatures from GroupDocs.Signature 20.3 and below

Following examples shows the way to mark signatures in document as actual signatures ([setSignature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain.signatures/BaseSignature#setSignature(boolean)) = true)

**How to mark signatures in document as actual signatures**

```java
 // initialize Signature instance 
Signature signature = new Signature("sample_signed.pdf");
// define few search options
BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
// add options to list
List<SearchOptions> listOptions = new ArrayList<SearchOptions>();
listOptions.add(barcodeOptions);
listOptions.add(qrCodeOptions);
 
// search for signatures in document
SearchResult result = signature.search(listOptions);
if (result.getSignatures().size() > 0)
{
    System.out.print("\nTrying to update all signatures...");
    // mark all signatures as actual Signatures
    for (BaseSignature baseSignature : result.getSignatures())
    {
        baseSignature.setSignature(true);
    }
    // update all found signatures
    UpdateResult updateResult = signature.update(outputFilePath,result.getSignatures());
    if (updateResult.getSucceeded().size() == result.getSignatures().size())
    {
        System.out.print("\nAll signatures were successfully updated!");
    }
    else
    {
        System.out.print("Successfully updated signatures : "+updateResult.getSucceeded().size());
        System.out.print("Not updated signatures : "+updateResult.getFailed().size());
    }
    System.out.print("\nList of updated signatures:");
    int number = 1;
    for (BaseSignature temp : updateResult.getSucceeded())
    {
        System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
    }
}
else
{
    System.out.print("No one signature was found.");
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Searching for document signatures excluding external components

Path: /signature/net/searching-for-document-signatures-excluding-external-components/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides boolean property [SkipExternal](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions/skipexternal) of [SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) class to specify if searching process should exclude external signatures (external signatures are the signatures that were added with an 3rd party software and not with GroupDocs.Signature).

Since 19.12 version every time when document is being signed information about document signatures are stored in document's metadata. Which means that all created signatures by GroupDocs.Signature can be distinguished from an actual document content and [IsSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature/issignature) flag will be set as true. [IsSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature/issignature) property specifies if document component (text/image/barcode/qr-code) is the actual signature or element of document content.

In order to convert signatures added by 3rd party software or by previous version of GroupDocs.Signature, just run [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) with[SkipExternal](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions/skipexternal) property set to false (this is default value) and update [IsSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature/issignature) for each signature returned by the search result.

There are few ways to manipulate with document signature search results:

* If signature is no longer required it can be removed from the document by [Delete](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/delete) method;
* Signature could be marked as document native content by setting up [IsSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature/issignature) = false property,in this case [SkipExternal](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions/skipexternal) field will allow [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search)  method to skip this signature;
* Signatures that were added before 19.12 are treated as non signatures because information about them are not yet stored in the document. Setting [SkipExternal](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions/skipexternal) flag to true will exclude these signatures from [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) result.

Here are the steps to search for signatures and exclude external components of the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) object according to your requirements and specify [SkipExternal](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions/skipexternal) to true
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search)  method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) to it.

## Excluding external signatures from search

 Following example demonstrates usage of [SkipExternal](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions/skipexternal) property for excluding non actual signatures from search result

### Using SearchOptions SkipExternal property to exclude non actual signatures from search

```csharp
using (Signature signature = new Signature("sample_signed.pdf"))
{
    TextSearchOptions options = new TextSearchOptions()
    {
        // specify SkipExternal value to exclude non signature objects from Search result
        SkipExternal = true,
        // specify search on all pages
        AllPages = false
    };
    // search for text signatures in document
    List<TextSignature> signatures = signature.Search<TextSignature>(options);
    Console.WriteLine("\nSource document contains following text signature(s).");
    // enumerate all signature for output
    foreach (TextSignature textSignature in signatures)
    {
        if (textSignature != null)
        {
            Console.WriteLine($"Found Text signature at page {textSignature.PageNumber} with type [{textSignature.SignatureImplementation}] and text '{textSignature.Text}'.");
            Console.WriteLine($"Location at {textSignature.Left}-{textSignature.Top}. Size is {textSignature.Width}x{textSignature.Height}.");
        }
    }
}
```

## Updating signatures from GroupDocs.Signature 19.11 and below

Following examples shows the way to mark signatures in document as actual signatures ([IsSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/basesignature/issignature) = true)

### How to mark signatures in document as actual signatures

```csharp
 // initialize Signature instance
 using (Signature signature = new Signature("sample_signed.pdf"))
 {
     // define search options to select required signatures om the document
     BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
     QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
     TextSearchOptions textOptions = new TextSearchOptions();
     // add options to list
     List<SearchOptions> listOptions = new List<SearchOptions>();
     listOptions.Add(barcodeOptions);
     listOptions.Add(qrCodeOptions);
     listOptions.Add(textOptions);
     // search for signatures in document
     SearchResult result = signature.Search(listOptions);
     if (result.Signatures.Count > 0)
     {
         Console.WriteLine("\nTrying to update all signatures...");
         // mark all signatures as actual Signatures
         foreach(BaseSignature baseSignature in result.Signatures)
         {
             baseSignature.IsSignature = true;
         }
         // update all found signatures
         UpdateResult updateResult = signature.Update(result.Signatures);
         if(updateResult.Succeeded.Count == result.Signatures.Count)
         {
             Console.WriteLine("\nAll signatures were successfully updated!");
         }
         else
         {
             Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
             Console.WriteLine($"Not updated signatures : {updateResult.Failed.Count}");
         }
         Console.WriteLine("\nList of updated signatures:");
         int number = 1;
         foreach(BaseSignature temp in updateResult.Succeeded)
         {
             Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
         }
     }
     else
     {
         Console.WriteLine("No one signature was found.");
     }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add replacement annotation

Path: /annotation/java/add-replacement-annotation/

Replacement annotation replaces original text with specified text fragmentas shown in the picture below: 

![](/annotation/java/images/add-replacement-annotation.png)

You can use the following methods to set the properties of the [ReplacementAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation) class:

*   [setFontColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation/#setFontColor-java.lang.Integer-) defines the color of annotation text
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPoints()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation/#setPoints-java.util.List-com.groupdocs.annotation.models.Point--) defines the annotation positions as array of points
*   [setTextToReplace()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation/#setTextToReplace-java.lang.String-) defines the replacement text   
     

To add a replacement annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [ReplacementAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [ReplacementAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation) class.
4.  Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream. 

  

The following code snippet shows how to add [ReplacementAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/replacementannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding text replacement annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    Point point1 = new Point(80, 730);
    Point point2 = new Point(240, 730);
    Point point3 = new Point(80, 650);
    Point point4 = new Point(240, 650);

    List<Point> points = new ArrayList<Point>();
    points.add(point1);
    points.add(point2);
    points.add(point3);
    points.add(point4);

    // Create an instance of ReplacementAnnotation class and set options
    ReplacementAnnotation replacement = new ReplacementAnnotation();
    replacement.setCreatedOn(Calendar.getInstance().getTime());
    replacement.setFontColor(65535);
    replacement.setMessage("This is replacement annotation");
    replacement.setOpacity(0.7);
    replacement.setPageNumber(0);
    replacement.setPoints(points);
    replacement.setReplies(replies);
    replacement.setTextToReplace("replaced text");
    
    // Add annotation and save to file
    annotator.add(replacement);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add replacement annotation

Path: /annotation/net/add-replacement-annotation/

Replacement annotation replaces original text with specified text fragmentas shown in the picture below: 

![](/annotation/net/images/add-replacement-annotation.png)

You can specify the following properties of the [ReplacementAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/replacementannotation) class:

*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/replacementannotation/properties/fontcolor) defines the color of annotation text
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/replacementannotation/properties/opacity) allows you to set the annotation opacity
*   [Points](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/replacementannotation/properties/points) defines the annotation positions as array of points
*   [TextToReplace](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/replacementannotation/properties/texttoreplace) defines the replacement text   
     

To add a replacement annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [ReplacementAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/replacementannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [ReplacementAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/replacementannotation) class.
4.  Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream. 

  

The following code snippet shows how to add [ReplacementAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/replacementannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add replacement annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	ReplacementAnnotation replacement = new ReplacementAnnotation
    {
    	CreatedOn = DateTime.Now,
        FontColor = 65535,
        Message = "This is replacement annotation",
        Opacity = 0.7,
        PageNumber = 0,
        FontSize = 11,
        Points = new List<Point>
        {
        	new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650)
        },
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
         },
         TextToReplace = "replaced text"
     };
     annotator.Add(replacement);
     annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Configuring search network

Path: /search/java/configuring-search-network/

Configuring a search network involves creating a configuration using the [Configurator](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/configurator/) class and the fluent interface.

The [Configurator](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/configurator/) class has methods for configuring general index settings, as well as for configuring each individual network node.

The [setIndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/configurator/#setIndexSettings--) method creates an instance of the [IndexSettingsConfigurator](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/indexsettingsconfigurator/) class, which allows you to set the following settings for each index of the distributed search network:
 - Flag for using stop words when indexing ([setUseStopWords](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/indexsettingsconfigurator/#setUseStopWords-boolean-) method).
 - Flag for using character replacements during indexing ([setUseCharacterReplacements](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/indexsettingsconfigurator/#setUseCharacterReplacements-boolean-) method).
 - Flag for using the extracted text storage, as well as the degree of text compression in the storage ([setTextStorageSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/indexsettingsconfigurator/#setTextStorageSettings-boolean-com.groupdocs.search.options.Compression-) method).
 - Index type ([setIndexType](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/indexsettingsconfigurator/#setIndexType-com.groupdocs.search.options.IndexType-) method).
 - Number of threads used for searching ([setSearchThreads](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/indexsettingsconfigurator/#setSearchThreads-com.groupdocs.search.options.NumberOfThreads-) method).

To complete the configuration of index settings, you must call the [completeIndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/indexsettingsconfigurator/#completeIndexSettings--) method.

To configure individual search network nodes, use the [addNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/configurator/#addNode-int-) method, which returns an instance of the [NodeConfigurator](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/) class.

The [NodeConfigurator](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/) class allows you to set the following node parameters:
 - Set the required IP address and port number of the search network node ([setTcpEndpoint](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/#setTcpEndpoint-java.lang.String-int-) method).
 - Declare the node as a receiver of log messages for all other network nodes ([addLogSink](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/#addLogSink--) method).
 - Add an indexing service, which is the input for all operations that change the contents of shards in network nodes ([addIndexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/#addIndexer-java.lang.String-) method). This service must be presented on the network exactly once.
 - Add a search service, which is the input for all search queries to the network ([addSearcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/#addSearcher-java.lang.String-) method).
 - Add an extraction service used to extract data from documents added to the search network ([addExtractor](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/#addExtractor-java.lang.String-) method). Increasing the number of extraction services (one per network node) increases the performance of search network indexing.
 - Add a shard service used to store extracted data in a form suitable for searching on the network ([addShard](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/#addShard-java.lang.String-) method). Increasing the number of shards (one for each network node) increases the performance of searching the network.

To complete the configuration of a network node, you must call the [completeNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/nodeconfigurator/#completeNode--) method.

Once the search network configuration is complete, you must call the [completeConfiguration](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/configurator/#completeConfiguration--) method, which will return an instance of the [Configuration](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/configuration/) class.

An instance of the [Configuration](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.configuring/configuration/) class can be saved to a file or stream in the XML format using the Save method, and subsequently can be loaded from the file or stream using the Load method.

The following code example shows how to create a search network configuration that describes four nodes.

```java
String address = "127.0.0.1";
Configuration configuration = new Configurator()
    .setIndexSettings()
        .setUseStopWords(false)
        .setUseCharacterReplacements(false)
        .setTextStorageSettings(true, Compression.High)
        .setIndexType(IndexType.NormalIndex)
        .setSearchThreads(NumberOfThreads.Default)
        .completeIndexSettings()
    .addNode(0)
        .setTcpEndpoint(address, basePort)
        .addLogSink()
        .addIndexer(basePath + "Indexer0")
        .addSearcher(basePath + "Searcher0")
        .completeNode()
    .addNode(1)
        .setTcpEndpoint(address, basePort + 1)
        .addShard(basePath + "Shard1")
        .addExtractor(basePath + "Extractor1")
        .completeNode()
    .addNode(2)
        .setTcpEndpoint(address, basePort + 2)
        .addShard(basePath + "Shard2")
        .addExtractor(basePath + "Extractor2")
        .completeNode()
    .addNode(3)
        .setTcpEndpoint(address, basePort + 3)
        .addShard(basePath + "Shard3")
        .addExtractor(basePath + "Extractor3")
        .completeNode()
    .completeConfiguration();
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Configuring search network

Path: /search/net/configuring-search-network/

Configuring a search network involves creating a configuration using the [Configurator](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/configurator/) class and the fluent interface.

The [Configurator](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/configurator/) class has methods for configuring general index settings, as well as for configuring each individual network node.

The [SetIndexSettings](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/configurator/setindexsettings/) method creates an instance of the [IndexSettingsConfigurator](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/indexsettingsconfigurator/) class, which allows you to set the following settings for each index of the distributed search network:
 - Flag for using stop words when indexing ([SetUseStopWords](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/indexsettingsconfigurator/setusestopwords/) method).
 - Flag for using character replacements during indexing ([SetUseCharacterReplacements](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/indexsettingsconfigurator/setusecharacterreplacements/) method).
 - Flag for using the extracted text storage, as well as the degree of text compression in the storage ([SetTextStorageSettings](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/indexsettingsconfigurator/settextstoragesettings/) method).
 - Index type ([SetIndexType](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/indexsettingsconfigurator/setindextype/) method).
 - Number of threads used for searching ([SetSearchThreads](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/indexsettingsconfigurator/setsearchthreads/) method).

To complete the configuration of index settings, you must call the [CompleteIndexSettings](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/indexsettingsconfigurator/completeindexsettings/) method.

To configure individual search network nodes, use the [AddNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/configurator/addnode/) method, which returns an instance of the [NodeConfigurator](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/) class.

The [NodeConfigurator](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/) class allows you to set the following node parameters:
 - Set the required IP address and port number of the search network node ([SetTcpEndpoint](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/settcpendpoint/) method).
 - Declare the node as a receiver of log messages for all other network nodes ([AddLogSink](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/addlogsink/) method).
 - Add an indexing service, which is the input for all operations that change the contents of shards in network nodes ([AddIndexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/addindexer/) method). This service must be presented on the network exactly once.
 - Add a search service, which is the input for all search queries to the network ([AddSearcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/addsearcher/) method).
 - Add an extraction service used to extract data from documents added to the search network ([AddExtractor](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/addextractor/) method). Increasing the number of extraction services (one per network node) increases the performance of search network indexing.
 - Add a shard service used to store extracted data in a form suitable for searching on the network ([AddShard](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/addshard/) method). Increasing the number of shards (one for each network node) increases the performance of searching the network.

To complete the configuration of a network node, you must call the [CompleteNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/nodeconfigurator/completenode/) method.

Once the search network configuration is complete, you must call the [CompleteConfiguration](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/configurator/completeconfiguration/) method, which will return an instance of the [Configuration](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/configuration/) class.

An instance of the [Configuration](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.configuring/configuration/) class can be saved to a file or stream in the XML format using the Save method, and subsequently can be loaded from the file or stream using the Load method.

The following code example shows how to create a search network configuration that describes four nodes.

**C#**

```csharp
string address = "127.0.0.1";
Configuration configuration = new Configurator()
    .SetIndexSettings()
        .SetUseStopWords(false)
        .SetUseCharacterReplacements(false)
        .SetTextStorageSettings(true, Compression.High)
        .SetIndexType(IndexType.NormalIndex)
        .SetSearchThreads(NumberOfThreads.Default)
        .CompleteIndexSettings()
    .AddMasterNode(0)
        .AddIndexer(basePath + "Indexer0")
        .AddSearcher(basePath + "Searcher0")
        .CompleteNode()
    .AddSlaveNode(1)
        .SetTcpEndpoint(address, basePort + 1)
        .AddShard(basePath + "Shard1")
        .AddExtractor(basePath + "Extractor1")
        .CompleteNode()
    .AddSlaveNode(2)
        .SetTcpEndpoint(address, basePort + 2)
        .AddShard(basePath + "Shard2")
        .AddExtractor(basePath + "Extractor2")
        .CompleteNode()
    .AddSlaveNode(3)
        .SetTcpEndpoint(address, basePort + 3)
        .AddShard(basePath + "Shard3")
        .AddExtractor(basePath + "Extractor3")
        .CompleteNode()
    .CompleteConfiguration();
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Convert JSON as a data source to a spreadsheet

Path: /conversion/net/convert-json-as-datasource-to-spreadsheet/


The following code snippet shows how to convert a JSON file to a spreadsheet. It means that you use this JSON as the data source and convert it to a spreadsheet:

```csharp
using (Converter converter = new Converter("data.json"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
    converter.Convert("converted.xlsx", options);
}
```

---

## Converting JSON to a Spreadsheet

Path: /conversion/java/convert-json-as-datasource-to-spreadsheet/


[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) allows converting JSON data into spreadsheet formats like XLSX, effectively treating the JSON file as a data source for the spreadsheet. This functionality is achieved using the [SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/spreadsheetconvertoptions/) class.

## Convert JSON to Spreadsheet
Here’s how you can achieve this in Java:

{{< tabs "code-example">}}
{{< tab "ConvertJsonAsDataSourceToSpreadsheet.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

public class ConvertJsonAsDataSourceToSpreadsheet {
    public static void convert() {
        // Initialize the Converter for the input file
        try(Converter converter = new Converter("sample.json") {
            // Set up SpreadsheetConvertOptions
            SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();

            // Perform the conversion
            converter.convert("converted.xlsx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample.json" >}}  
{{< tab-text >}}
`sample.json` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-json-as-datasource-to-spreadsheet/sample.json) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.xlsx" >}}  
{{< tab-text >}}
`converted.xlsx` is converted XLSX file. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-json-as-datasource-to-spreadsheet/converted.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

This flexibility allows you to transform JSON data into well-organized spreadsheets tailored to specific requirements.
---

## Export annotations

Path: /annotation/net/export-annotations/


GroupDocs v22.1 allows you to export annotations from a document to an XML file.

The following code snippet shows how to export annotations:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf-file")) // specify the path to the input PDF file
{
	annotator.ExportAnnotationsFromXMLFile("input.XML-file"); // specify the path to the input XML file
    annotator.Save("result_export");
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Export styles during document editing

Path: /editor/java/styles-export/

The [family of WordProcessing formats](https://docs.fileformat.com/word-processing/), commonly represented by the [Office Open XML](https://docs.fileformat.com/word-processing/docx/) formats and [Open Document Format (ODT)](https://docs.fileformat.com/word-processing/odt/) formats, have a concept of _styles_. Here the _style_ is a defined set of formatting options, which can be applied to some span of text, paragraphs, lists, or tables. Styles can be built-in (defined by the word processor program, MS Word, for example), or user-defined. Every style has a unique name and can be derived from another style. In MS Word styles are usually located in the “Styles” area in the “Main” tab; users can select a desired text or paragraph of the document and then click on the preferred style in order to apply the style formatting.

Every style has the next characteristics and parameters:

1. It has a unique name.
2. It can be a character style (applied for textual content within paragraph), a paragraph style (applied to paragraph(s)), a list style (applied for list items), and a table style (applied to the whole table).
3. It can be either built-in in MS Word or user-defined.
   * For the built-in styles only: it can be heading style or not.
4. It can be a Quick Style or not; if yes, this style is shown in the Quick Style gallery inside MS Word UI.
5. It may be based on some other style or not.

Before the [version 24.4](https://releases.groupdocs.com/editor/java/release-notes/2024/groupdocs-editor-for-java-24-4-release-notes/) the GroupDocs.Editor had no support of styles: they were not exported to the HTML/CSS markup during editing the document and not imported back during saving the document, and there were no possibility for the end-user to determine how the specific text or paragraph was originally formatted: whether it was formatted by using a custom formatting or using the styles.

Starting from the [version 24.4](https://releases.groupdocs.com/editor/java/release-notes/2024/groupdocs-editor-for-java-24-4-release-notes/) the GroupDocs.Editor finally supports styles on export. This feature is not an option, it is always turned on and starting from the version 24.4 the HTML markup and CSS stylesheet is generated differently. GroupDocs.Editor exports the WordProcessing styles by transforming them onto the CSS rulesets and referencing these rulesets from the HTML markup.

Here is an example of CSS markup, which contains a MS Word built-in style named “Heading 1”:

```css
.Heading_1, .Quick-style, .BuiltIn-style, .Heading-style, .Paragraph-style { 
	-aw-style-name: heading1; 
	-gd-style-name: 'Heading 1'; 
	font-family: Cambria; 
	font-size: 14pt; 
	font-weight: bold; 
	font-style: normal; 
	color: rgb(54, 95, 145); 
	text-align: left; 
	margin-top: 24pt; 
	margin-bottom: 0pt; 
	line-height: 134.16667%; 
}
```

The original style name is preserved in the custom property “-gd-style-name”. Because it is a built-in style, it also has a style identifier in the custom property “-aw-style-name”. The class selectors inside the grouped selector of this ruleset also stores the style’s parameters:

- First class selector is a unique style name, adjusted to meet the “CSS identifier” requirements.
- Second class selector shows whether it is a quick style.
- Third class selector shows whether it is a built-in style or user style.
- Fourth class selector shows whether it is a built-in heading style.
- Fifth style selector defines the style type: Character, Paragraph, List, or Table.

Here is an example of CSS markup, which contains a custom user-defined character style named “Подзаголовок Знак”:

```css
.Подзаголовок_Знак, .User-style, .Character-style { 
	-gd-style-name: 'Подзаголовок Знак'; 
	font-family: Cambria; 
	font-size: 12pt; 
	font-weight: normal; 
	font-style: italic; 
	color: rgb(79, 129, 189); 
	letter-spacing: 0.75pt; 
}
```

Despite that with this new feature the HTML markup has modified slightly, and CSS markup has modified drastically, the feature was developed in such a way to not disturb or distort the representation of the document in the browser. So when opening and comparing in the web-browser the two edited documents side-by-side, where the left one is generated by the previous [version 23.9](https://releases.groupdocs.com/editor/java/release-notes/2023/groupdocs-editor-for-java-23-9-release-notes/), and the right is generated by the version 24.4, there will be no visual difference.

In the next version of the GroupDocs.Editor we plan to implement an import of styles back when saving previously opened and edited documents back to the WordProcessing format.

---

## Export styles during document editing

Path: /editor/net/styles-export/

The [family of WordProcessing formats](https://docs.fileformat.com/word-processing/), commonly represented by the [Office Open XML](https://docs.fileformat.com/word-processing/docx/) formats and [Open Document Format (ODT)](https://docs.fileformat.com/word-processing/odt/) formats, have a concept of _styles_. Here the _style_ is a defined set of formatting options, which can be applied to some span of text, paragraphs, lists, or tables. Styles can be built-in (defined by the word processor program, MS Word, for example), or user-defined. Every style has a unique name and can be derived from another style. In MS Word styles are usually located in the “Styles” area in the “Main” tab; users can select a desired text or paragraph of the document and then click on the preferred style in order to apply the style formatting.

Every style has the next characteristics and parameters:

1. It has a unique name.
2. It can be a character style (applied for textual content within paragraph), a paragraph style (applied to paragraph(s)), a list style (applied for list items), and a table style (applied to the whole table).
3. It can be either built-in in MS Word or user-defined.
   * For the built-in styles only: it can be heading style or not.
4. It can be a Quick Style or not; if yes, this style is shown in the Quick Style gallery inside MS Word UI.
5. It may be based on some other style or not.

Before the [version 23.8](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-8-release-notes/) the GroupDocs.Editor had no support of styles: they were not exported to the HTML/CSS markup during editing the document and not imported back during saving the document, and there were no possibility for the end-user to determine how the specific text or paragraph was originally formatted: whether it was formatted by using a custom formatting or using the styles.

Starting from the [version 23.8](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-8-release-notes/) the GroupDocs.Editor finally supports styles on export. This feature is not an option, it is always turned on and starting from the version 23.8 the HTML markup and CSS stylesheet is generated differently. GroupDocs.Editor exports the WordProcessing styles by transforming them onto the CSS rulesets and referencing these rulesets from the HTML markup.

Here is an example of CSS markup, which contains a MS Word built-in style named “Heading 1”:

```css
.Heading_1, .Quick-style, .BuiltIn-style, .Heading-style, .Paragraph-style { 
	-aw-style-name: heading1; 
	-gd-style-name: 'Heading 1'; 
	font-family: Cambria; 
	font-size: 14pt; 
	font-weight: bold; 
	font-style: normal; 
	color: rgb(54, 95, 145); 
	text-align: left; 
	margin-top: 24pt; 
	margin-bottom: 0pt; 
	line-height: 134.16667%; 
}
```

The original style name is preserved in the custom property “-gd-style-name”. Because it is a built-in style, it also has a style identifier in the custom property “-aw-style-name”. The class selectors inside the grouped selector of this ruleset also stores the style’s parameters:

- First class selector is a unique style name, adjusted to meet the “CSS identifier” requirements.
- Second class selector shows whether it is a quick style.
- Third class selector shows whether it is a built-in style or user style.
- Fourth class selector shows whether it is a built-in heading style.
- Fifth style selector defines the style type: Character, Paragraph, List, or Table.

Here is an example of CSS markup, which contains a custom user-defined character style named “Подзаголовок Знак”:

```css
.Подзаголовок_Знак, .User-style, .Character-style { 
	-gd-style-name: 'Подзаголовок Знак'; 
	font-family: Cambria; 
	font-size: 12pt; 
	font-weight: normal; 
	font-style: italic; 
	color: rgb(79, 129, 189); 
	letter-spacing: 0.75pt; 
}
```

Despite that with this new feature the HTML markup has modified slightly, and CSS markup has modified drastically, the feature was developed in such a way to not disturb or distort the representation of the document in the browser. So when opening and comparing in the web-browser the two edited documents side-by-side, where the left one is generated by the previous [version 23.5](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-5-release-notes/), and the right is generated by the version 23.8, there will be no visual difference.

In the next version of the GroupDocs.Editor we plan to implement an import of styles back when saving previously opened and edited documents back to the WordProcessing format.

---

## Export Styles During Document Editing

Path: /editor/nodejs-java/styles-export/


The [family of WordProcessing formats](https://docs.fileformat.com/word-processing/), commonly represented by the [Office Open XML](https://docs.fileformat.com/word-processing/docx/) formats and [Open Document Format (ODT)](https://docs.fileformat.com/word-processing/odt/), have a concept of _styles_. In this context, a _style_ is a defined set of formatting options that can be applied to spans of text, paragraphs, lists, or tables. Styles can be built-in (defined by the word processor program, such as MS Word) or user-defined. Each style has a unique name and can be derived from another style. In MS Word, styles are usually located in the "Styles" area on the "Home" tab; users can select desired text or paragraphs and then click on the preferred style to apply the style formatting.

Every style has the following characteristics and parameters:

1. **Unique Name:** Each style has a unique identifier.
2. **Style Type:** It can be a character style (applied to text within a paragraph), a paragraph style (applied to paragraph(s)), a list style (applied to list items), or a table style (applied to the entire table).
3. **Origin:** It can be either built-in in MS Word or user-defined.
   - **Built-in Styles Only:** It can be a heading style or not.
4. **Quick Style:** It can be a Quick Style or not; if it is, the style is shown in the Quick Style gallery inside the MS Word UI.
5. **Based On:** It may be based on another style or not.

Before [version 24.4](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node-js-via-java-24-4-release-notes/), GroupDocs.Editor did not support styles: they were neither exported to the HTML/CSS markup during editing nor imported back during saving. There was no possibility for the end-user to determine how specific text or paragraphs were originally formatted—whether they were formatted using custom formatting or styles.

Starting from [version 24.4](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node-js-via-java-24-4-release-notes/), GroupDocs.Editor finally supports styles on export. This feature is always enabled and modifies the way HTML markup and CSS stylesheets are generated. GroupDocs.Editor exports WordProcessing styles by transforming them into CSS rulesets and referencing these rulesets from the HTML markup.

## How Styles are Exported

Here is an example of CSS markup that contains an MS Word built-in style named "Heading 1":

```css
.Heading_1, .Quick-style, .BuiltIn-style, .Heading-style, .Paragraph-style { 
    -aw-style-name: heading1; 
    -gd-style-name: 'Heading 1'; 
    font-family: Cambria; 
    font-size: 14pt; 
    font-weight: bold; 
    font-style: normal; 
    color: rgb(54, 95, 145); 
    text-align: left; 
    margin-top: 24pt; 
    margin-bottom: 0pt; 
    line-height: 134.16667%; 
}
```

The original style name is preserved in the custom property `-gd-style-name`. Because it is a built-in style, it also has a style identifier in the custom property `-aw-style-name`. The class selectors inside the grouped selector of this ruleset also store the style's parameters:

- **First Class Selector:** A unique style name, adjusted to meet the CSS identifier requirements.
- **Second Class Selector:** Indicates whether it is a Quick Style.
- **Third Class Selector:** Indicates whether it is a built-in style or user-defined.
- **Fourth Class Selector:** Indicates whether it is a built-in heading style.
- **Fifth Class Selector:** Defines the style type: Character, Paragraph, List, or Table.

Here is an example of CSS markup that contains a custom user-defined character style named "Subheading Char":

```css
.Subheading_Char, .User-style, .Character-style { 
    -gd-style-name: 'Subheading Char'; 
    font-family: Cambria; 
    font-size: 12pt; 
    font-weight: normal; 
    font-style: italic; 
    color: rgb(79, 129, 189); 
    letter-spacing: 0.75pt; 
}
```

Despite this new feature modifying the HTML and CSS markup, it was developed to not disturb or distort the representation of the document in the browser. When opening and comparing two edited documents side-by-side—one generated by the previous [version 23.9](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2023/groupdocs-editor-for-node-js-via-java-23-9-release-notes/) and the other by version 24.4—there will be no visual difference in the browser.

## Important Notes

- **Always Enabled:** This feature is not an option; it is always turned on starting from version 24.4.
- **No Visual Differences:** The changes in the HTML and CSS markup do not affect the visual representation of the document in web browsers.
- **Future Improvements:** In the next version of GroupDocs.Editor, we plan to implement the import of styles back when saving previously opened and edited documents to the WordProcessing format.

## Example Usage

When you edit a WordProcessing document using GroupDocs.Editor for Node.js via Java, the styles are automatically preserved and exported into the HTML and CSS. Here's how you can edit a document:

```javascript
// Import necessary modules
const groupdocs_editor = require('groupdocs-editor');
const fs = require('fs');

// Load the source WordProcessing document
const editor = new groupdocs_editor.Editor('SampleDocument.docx');

// Create WordProcessingEditOptions if needed
const editOptions = new groupdocs_editor.WordProcessingEditOptions();

// Edit the document to get an EditableDocument instance
const editableDocument = editor.edit(editOptions);

// Get the HTML content and resources
const htmlContent = editableDocument.getContent();
const allResources = editableDocument.getEmbeddedHtmlResources();

// Save the HTML content and CSS stylesheet
fs.writeFileSync('EditedDocument.html', htmlContent);

// Save the CSS stylesheet if it's not embedded
if (editableDocument.hasExternalCssContent()) {
    const cssContent = editableDocument.getExternalCssContent();
    fs.writeFileSync('styles.css', cssContent);
}

// Optionally, save other resources like images
// ... (handling other resources)

// After editing, you can save the document back to WordProcessing format
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Docx);

// Save the edited document
editor.save(editableDocument, 'EditedDocument.docx', saveOptions);

console.log('Document edited and saved successfully.');
```

**Note:**

- Replace `'SampleDocument.docx'` with the path to your WordProcessing document.
- The styles from the original document are preserved and exported into the HTML and CSS automatically.

## Conclusion

The support for exporting styles during document editing enhances the capability of GroupDocs.Editor for Node.js via Java to handle complex WordProcessing documents. It ensures that all built-in and custom styles are preserved during the editing process, providing a more accurate representation of the original document in HTML/CSS format.

This feature is particularly useful for developers who need to maintain the styling and formatting consistency of documents when converting them to HTML for editing and then back to WordProcessing formats.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Extract data from PDF forms

Path: /parser/java/extract-data-from-pdf-forms/

GroupDocs.Parser allows to parse form data from PDF documents.

# Extract data from PDF forms

To extract PDF form data please call the [parseForm](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseForm()) method:

```java
DocumentData parseForm();
```

This method returns an instance of [DocumentData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData) class with the extracted data.

Here are the steps to parse form of the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [parseForm](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#parseForm()) method and obtain the [DocumentData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData) object;
*   Check if *data* isn't *null* (parse form is supported for the document);
*   Iterate over field data to obtain form data.

The following example shows how to parse a form of the document:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleFormsPdf)) {
    // Extract data from PDF document
    DocumentData data = parser.parseForm();
    // Check if form extraction is supported
    if (data == null) {
        System.out.println("Form extraction isn't supported.");
        return;
    }
    // Iterate over extracted data
    for (int i = 0; i < data.getCount(); i++) {
        System.out.print(data.get(i).getName() + ": ");
        PageTextArea area = data.get(i).getPageArea() instanceof PageTextArea
                ? (PageTextArea) data.get(i).getPageArea()
                : null;
        System.out.println(area == null ? "Not a template field" : area.getText());
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract data from PDF forms

Path: /parser/net/extract-data-from-pdf-forms/

GroupDocs.Parser allows to parse form data from PDF documents.

To extract PDF form data please call the [ParseForm](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parseform) method:

```csharp
DocumentData ParseForm()

```

This method returns an instance of [DocumentData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata) class with the extracted data.

Here are the steps to parse form of the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document
*   Call [ParseForm](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/parseform) method and obtain the [DocumentData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata) object;
*   Check if *data* isn't *null* (parse form is supported for the document);
*   Iterate over field data to obtain form data.

The following example shows how to parse a form of the document:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Extract data from PDF document
    DocumentData data = parser.ParseForm();
    
    // Check if form extraction is supported
    if (data == null)
    {
        Console.WriteLine("Form extraction isn't supported");
        return;
    }
    
    // Iterate over extracted data
    for (int i = 0; i < data.Count; i++)
    {
        Console.Write(data[i].Name + ": ");
        PageTextArea area = data[i].PageArea as PageTextArea;
        Console.WriteLine(area == null ? "Not a template field" : area.Text);
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract text, metadata and images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).

---

## Extracting document metainfo

Path: /editor/java/extracting-document-metainfo/

> This demonstration shows and explains usage of the [getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-) method, that extracts meta info from the document.

## Introduction

In some situations it is required to grab meta info from the document before actually editing it. For example, user wants to edit last tab of the multi-tabbed spreadsheet, but he doesn't know, how many tabs the document contains. Ir it is unclear for the user, is the document password-protected or not. For such situations [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) provides a [getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-) method, that returns detailed meta info (metadata) about the specified document.

## Using the method

In order to grab the meta info from the document, it should firstly be loaded into the `Editor` class. Then [getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-) should be called. This method obtains one parameter — password as a string. If document is encoded and user knows the password, he can specify it here. For other cases the null or empty string can be passed. Code example below demonstrates the usage:

```java
Editor editor = new Editor("C://input//document.docx");
IDocumentInfo infoDocxWithoutPassword = editor.getDocumentInfo(null);
IDocumentInfo infoDocxWithPassword = editor.getDocumentInfo("password");
```

There can be several scenarios here regarding whether document is encoded or not, and did user specified a password:

1. If password is specified, but document is not password-protected, or the document format doesn't support encoding at all, the password will be ignored.
2. If document is password-protected, but password is not specified, the [PasswordRequiredException](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/passwordrequiredexception) will be thrown while calling [getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-).
3. If document is password-protected,and password is specified, but is incorrect, the [IncorrectPasswordException](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/incorrectpasswordexception) will be thrown while calling [getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-).

## Explaining resulting type

[getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-) method returns a [IDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo). This is interface, that stores meta info about one particular document and contains the next properties:

1. [PageCount](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#getPageCount--). This is a positive number, that returns page count for WordProcessing documents, tabs (worksheets) count for Spreadsheets, and 1 for pageless documents like XML or TXT.
2. [Size](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#getSize--). Document size in bytes.
3. [IsEncrypted](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#isEncrypted--). A boolean flag that indicates whether document is encrypted with the password or not. If document is of type, that doesn't support encryption at all, like CSV or XML, this property will return 'false'.
4. [Format](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#getFormat--). Returns info about the format itself.

There are three inheritors of the [IDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo) interface:

1. [WordProcessingDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo) — common for all WordProcessing family formats.
2. [SpreadsheetDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/spreadsheetdocumentinfo) — common for all Spreadsheet family formats.
3. [PresentationDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/presentationdocumentinfo) — common for all Presentation family formats.
4. [TextualDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo) — common for all textual types, including all DSV (like CSV and TSV), XML, HTML, and plain text.
5. [FixedLayoutDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/fixedlayoutdocumentinfo/) - common for all documents with a fixed-layout format, this includes only PDF and XPS.
6. [EmailDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/emaildocumentinfo/) - common for all Email family formats, like EML, MSG, VCF, PST, MBOX and others.
7. [EbookDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/) - common for all eBook family formats like MOBI and ePub.
8. [MarkdownDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/markdowndocumentinfo/) - special struct, that is dedicated especially for the Markdown (MD) textual format.

One important thing to note: if [getDocumentInfo()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-) returns NULL value instead of some of [IDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo) inheritors, this means that specified document is not supported by the GroupDocs.Editor and thus cannot be opened for editing or saved.

## Explaining document format

[IDocumentInfo](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/) interface contains a [`getFormat()` property](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/#getFormat--) of [IDocumentFormat](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats.abstraction/idocumentformat/) type. [IDocumentFormat](https://reference2.groupdocs.com/editor/java/com.groupdocs.editor.formats.abstraction/idocumentformat/) is an interface, that is common for all format descriptors. It is designed for indicating one particular document format and stores format name, extension, MIME-code, and has equality operators.

Each inheritor of [IDocumentFormat](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats.abstraction/idocumentformat/) interface delivers three properties, all of a [java.lang.String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html) type: 
1. [getName()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats.abstraction/idocumentformat/#getName--), that provides name of the format.
2. [getExtension()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats.abstraction/idocumentformat/#getExtension--), that provides a format extension.
3. [getMime()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats.abstraction/idocumentformat/#getMime--), that provides a MIME-code for a particular format

[`IDocumentFormat` interface](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats.abstraction/idocumentformat/) has seven inheritors, all of them are structs:
1. [WordProcessingFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats/) — holds all formats from WordProcessing family.
2. [SpreadsheetFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/spreadsheetformats/) — holds all formats from Spreadsheet family.
3. [PresentationFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/presentationformats/) — holds all formats from Presentation family.
4. [TextualFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/textualformats/) — holds all formats with text-based nature.
5. [FixedLayoutFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/fixedlayoutformats/) - holds all formats from the fixed-layout format family. This includes only PDF and XPS.
6. [EBookFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/) - holds all eBool (Electronic book) formats like Mobi and ePub.
7. [EmailFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/emailformats/) - holds all email (electronic mail) formats like EML and MSG.


---

## Extracting document metainfo

Path: /editor/net/extracting-document-metainfo/

> This demonstration shows and explains usage of the [GetDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) method, that extracts meta info from the document.

## Introduction

In some situations it is required to grab meta info from the document before actually editing it. For example, user wants to edit last tab of the multi-tabbed spreadsheet, but he doesn't know, how many tabs the document contains. Ir it is unclear for the user, is the document password-protected or not. For such situations [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) provides a [GetDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) method, that returns detailed meta info (metadata) about the specified document.

## Using the method

In order to grab the meta info from the document, it should firstly be loaded into the `Editor` class. Then [GetDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo)() should be called. This method obtains one parameter — password as a string. If document is encoded and user knows the password, he can specify it here. For other cases the null or empty string can be passed. Code example below demonstrates the usage:

```csharp
Editor editor = new Editor("C://input/document.docx");
IDocumentInfo infoDocxWithoutPassword = editorDocx.GetDocumentInfo(null);
IDocumentInfo infoDocxWithPassword = editorDocx.GetDocumentInfo("password"); 
```

There can be several scenarios here regarding whether document is encoded or not, and did user specified a password:

1. If password is specified, but document is not password-protected, or the document format doesn't support encoding at all, the password will be ignored.
2. If document is password-protected, but password is not specified, the [PasswordRequiredException](https://reference.groupdocs.com/editor/net/groupdocs.editor/passwordrequiredexception) will be thrown while calling [GetDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo)().
3. If document is password-protected,and password is specified, but is incorrect, the [IncorrectPasswordException](https://reference.groupdocs.com/editor/net/groupdocs.editor/incorrectpasswordexception) will be thrown while calling [GetDocumentInfo()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo).

## Explaining resulting type

[GetDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo)() method returns a [IDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo). This is interface, that stores meta info about one particular document and contains the next properties:

1. [PageCount](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/pagecount). This is a positive number, that returns page count for WordProcessing, PDF and XPS documents, tabs (worksheets) count for Spreadsheets, slides count for Presentations and a number `1` for pageless documents like XML or TXT.
2. [Size](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/size). Document size in bytes.
3. [IsEncrypted](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/isencrypted). A boolean flag that indicates whether document is encrypted with the password or not. If document is of type, that doesn't support encryption at all, like CSV or XML, this property always returns `false`.
4. [Format](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/format). Returns info about the format itself.

There are eight inheritors of the [IDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) interface, all are structs:

1. [WordProcessingDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo) — common for all WordProcessing family formats.
2. [SpreadsheetDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/spreadsheetdocumentinfo) — common for all Spreadsheet family formats.
3. [PresentationDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/presentationdocumentinfo) — common for all Presentation family formats.
4. [TextualDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo) — common for all textual types, including all DSV (like CSV and TSV), XML, HTML, and plain text.
5. [FixedLayoutDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo) - common for all documents with a fixed-layout format, this includes only PDF and XPS.
6. [EmailDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/emaildocumentinfo) - common for all Email family formats, like EML, MSG, VCF, PST, MBOX and others.
7. [EbookDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo) - common for all eBook family formats like MOBI and ePub.
8. [MarkdownDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/markdowndocumentinfo) - special struct, that is dedicated especially for the Markdown (MD) textual format.


One important thing to note: if [GetDocumentInfo()](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) returns `NULL` value instead of some of [IDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) inheritors, this means that specified document is not supported by the GroupDocs.Editor and thus cannot be opened for editing or saved.

## Explaining document format

[IDocumentInfo](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) interface contains a [`Format` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/format) of [IDocumentFormat](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat) type. [IDocumentFormat](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat) is an interface, that is common for all format descriptors. It is designed for indicating one particular document format and stores format name, extension, MIME-code, and has equality operators.

Each inheritor of [IDocumentFormat](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat) interface delivers three properties, all of a [System.String](https://docs.microsoft.com/en-us/dotnet/api/system.string?view=net-6.0) type: 
1. [Name](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat/name), that provides name of the format.
2. [Extension](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat/extension), that provides a format extension.
3. [Mime](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat/mime), that provides a MIME-code for a particular format

[`IDocumentFormat` interface](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat) has seven inheritors, all of them are structs:
1. [WordProcessingFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats) — holds all formats from WordProcessing family.
2. [SpreadsheetFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/spreadsheetformats) — holds all formats from Spreadsheet family.
3. [PresentationFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/spreadsheetformats) — holds all formats from Presentation family.
4. [TextualFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/textualformats) — holds all formats with text-based nature.
5. [FixedLayoutFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/fixedlayoutformats) - holds all formats from the fixed-layout format family. This includes only PDF and XPS.
6. [EBookFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats) - holds all eBool (Electronic book) formats like Mobi and ePub.
7. [EmailFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/emailformats) - holds all email (electronic mail) formats like EML and MSG.


---

## Extracting Document Metainfo

Path: /editor/nodejs-java/extracting-document-metainfo/


> This guide demonstrates how to use the [`getDocumentInfo()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#getDocumentInfo-java.lang.String-) method to extract metadata from a document using **GroupDocs.Editor for Node.js via Java**.

## Introduction

In some situations, it is necessary to retrieve metadata from a document before actually editing it. For example, a user might want to edit the last worksheet of a multi-tabbed spreadsheet but doesn't know how many worksheets the document contains. Or it might be unclear whether the document is password-protected. For such situations, **GroupDocs.Editor** provides a [`getDocumentInfo()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#getDocumentInfo-java.lang.String-) method that returns detailed metadata about the specified document.

## Using the Method

To extract metadata from a document, you first need to load it into the `Editor` class. Then, call the `getDocumentInfo()` method. This method accepts one parameter—`password` as a string. If the document is encrypted and you know the password, you can specify it here. In other cases, you can pass `null` or an empty string. The code example below demonstrates the usage:

```javascript
// Import the necessary modules
const fs = require('fs');
const groupdocsEditor = require('@groupdocs/groupdocs.editor');

// Load the document into the Editor class
const inputFilePath = 'C://input//document.docx';
const inputStream = fs.createReadStream(inputFilePath);
const editor = new groupdocsEditor.Editor(inputStream);

// Get document info without specifying a password
const infoDocxWithoutPassword = editor.getDocumentInfo(null);

// Get document info with a password
const infoDocxWithPassword = editor.getDocumentInfo('password');

// Close the editor instance
editor.dispose();
```

### Scenarios Regarding Password Protection

There can be several scenarios depending on whether the document is encrypted and whether a password is specified:

1. **Password Specified, Document Not Password-Protected:**
   - If a password is specified but the document is not password-protected, or the document format doesn't support encryption, the password will be ignored.

2. **Document Password-Protected, Password Not Specified:**
   - If the document is password-protected but no password is specified, a [`PasswordRequiredException`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/PasswordRequiredException) will be thrown when calling `getDocumentInfo()`.

3. **Incorrect Password Specified:**
   - If the document is password-protected and an incorrect password is specified, an [`IncorrectPasswordException`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/IncorrectPasswordException) will be thrown when calling `getDocumentInfo()`.

## Understanding the Resulting Type

The `getDocumentInfo()` method returns an instance of [`IDocumentInfo`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/IDocumentInfo). This interface stores metadata about the document and contains the following properties:

1. **getPageCount():**
   - Returns a positive number indicating the page count for WordProcessing documents, worksheets count for Spreadsheets, and `1` for pageless documents like XML or TXT.

2. **getSize():**
   - Returns the document size in bytes.

3. **isEncrypted():**
   - A boolean flag indicating whether the document is encrypted with a password. If the document format doesn't support encryption, this property returns `false`.

4. **getFormat():**
   - Returns information about the document format.

### Inheritors of IDocumentInfo

There are several inheritors of the `IDocumentInfo` interface, each specific to a document family:

1. **WordProcessingDocumentInfo:**
   - For all WordProcessing formats.

2. **SpreadsheetDocumentInfo:**
   - For all Spreadsheet formats.

3. **PresentationDocumentInfo:**
   - For all Presentation formats.

4. **TextualDocumentInfo:**
   - For textual types, including DSV (like CSV and TSV), XML, HTML, and plain text.

5. **FixedLayoutDocumentInfo:**
   - For documents with a fixed-layout format, such as PDF and XPS.

6. **EmailDocumentInfo:**
   - For all Email formats, like EML, MSG, VCF, PST, MBOX, and others.

7. **EbookDocumentInfo:**
   - For all eBook formats like MOBI and EPUB.

8. **MarkdownDocumentInfo:**
   - Specific to the Markdown (MD) textual format.

**Note:** If `getDocumentInfo()` returns `null` instead of an `IDocumentInfo` inheritor, it means the specified document is not supported by GroupDocs.Editor and cannot be opened for editing or saving.

## Understanding Document Format

The `IDocumentInfo` interface contains a [`getFormat()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/IDocumentInfo#getFormat--) property of type [`IDocumentFormat`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats.abstraction/IDocumentFormat). This interface represents a particular document format and stores the format name, extension, and MIME type.

Each inheritor of `IDocumentFormat` provides three properties, all of type `String`:

1. **getName():**
   - Provides the name of the format.

2. **getExtension():**
   - Provides the format extension.

3. **getMime():**
   - Provides the MIME type for the particular format.

The `IDocumentFormat` interface has several inheritors, all of them are structs:

1. **WordProcessingFormats:**
   - Holds all formats from the WordProcessing family.

2. **SpreadsheetFormats:**
   - Holds all formats from the Spreadsheet family.

3. **PresentationFormats:**
   - Holds all formats from the Presentation family.

4. **TextualFormats:**
   - Holds all formats with a text-based nature.

5. **FixedLayoutFormats:**
   - Holds all formats from the fixed-layout format family (e.g., PDF and XPS).

6. **EBookFormats:**
   - Holds all eBook formats like MOBI and EPUB.

7. **EmailFormats:**
   - Holds all email formats like EML and MSG.

## Complete Example

Here is a complete example demonstrating how to extract metadata from a WordProcessing document:

```javascript
// Import the necessary modules
const fs = require('fs');
const groupdocsEditor = require('@groupdocs/groupdocs.editor');

try {
    // Load the document into the Editor class
    const inputFilePath = 'C://input//document.docx';
    const inputStream = fs.createReadStream(inputFilePath);
    const editor = new groupdocsEditor.Editor(inputStream);

    // Get document info without specifying a password
    const infoDocxWithoutPassword = editor.getDocumentInfo(null);

    console.log('Page Count:', infoDocxWithoutPassword.getPageCount());
    console.log('Size (bytes):', infoDocxWithoutPassword.getSize());
    console.log('Is Encrypted:', infoDocxWithoutPassword.isEncrypted());

    const format = infoDocxWithoutPassword.getFormat();
    console.log('Format Name:', format.getName());
    console.log('Format Extension:', format.getExtension());
    console.log('Format MIME Type:', format.getMime());

    // Close the editor instance
    editor.dispose();
} catch (error) {
    if (error instanceof groupdocsEditor.PasswordRequiredException) {
        console.error('The document is password-protected. Please provide a password.');
    } else if (error instanceof groupdocsEditor.IncorrectPasswordException) {
        console.error('The provided password is incorrect.');
    } else {
        console.error('An error occurred:', error);
    }
}
```

## Conclusion

This guide has demonstrated how to use GroupDocs.Editor for Node.js via Java to extract metadata from documents before editing them. By utilizing the `getDocumentInfo()` method, you can obtain valuable information such as page count, size, encryption status, and format details. This functionality is essential for applications that require pre-processing or validation of documents before further manipulation.

---

**Note:** Replace `'C://input//document.docx'` with the actual path to your document.

---

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.

---

**Tip:** Always handle exceptions appropriately in your applications, especially when dealing with password-protected or unsupported documents.
---

## Get extended information on the summary page

Path: /comparison/java/get-extended-information-on-the-summary-page/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to detect changes between source and target files and display changes on the separate page - [SummaryPage](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setGenerateSummaryPage-boolean-).
You can also get the extended information about comparison of documents, which is displayed in the [SummaryPage](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setGenerateSummaryPage-boolean-).

To get extended information, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object. Set the [ExtendedSummaryPage](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setExtendedSummaryPage-boolean-) property to `true`.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how to get extended information:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    CompareOptions options = new CompareOptions();
    options.setExtendedSummaryPage(true);
    final Path resultPath = comparer.compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/how-to-get-extended-information-image.png)



---

## Get extended information on the summary page

Path: /comparison/net/get-extended-information-on-the-summary-page/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to detect changes between source and target files and display changes on the separate page - [SummaryPage](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/generatesummarypage).
You can also get the extended information about comparison of documents, which is displayed in the [SummaryPage](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/generatesummarypage).

To get extended information, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object. Set the [ExtendedSummaryPage](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/extendedsummarypage) property to `true`.
4.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how to get extended information:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions options = new CompareOptions() {ExtendedSummaryPage = true};
    comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/how-to-get-extended-information-image.png)



---

## Get extended information on the summary page

Path: /comparison/nodejs-java/get-extended-information-on-the-summary-page/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to detect changes between source and target files and display changes on the separate page - `SummaryPage`.
You can also get extended information about the comparison of documents, which is displayed in the `SummaryPage`.

The following code snippet shows how to get extended information:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target and output documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to the comparison set
comparer.add(targetPath);

// Create comparison options
const options = new groupdocs.CompareOptions();

// Enable generation of an extended summary page in the result
options.setExtendedSummaryPage(true);

// Execute the comparison and save the result to the specified output path
const resultPath = comparer.compare(outputPath, options);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It enables extended summary page generation by setting `setExtendedSummaryPage(true)`, then performs the comparison. The result document will include an extended summary page with detailed information about all detected changes, providing more comprehensive statistics than a standard summary page.

The result is as follows:

![](/comparison/nodejs-java/images/how-to-get-extended-information-image.png)



---

## Get extended information on the summary page

Path: /comparison/python-net/get-extended-information-on-the-summary-page/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) can generate a summary page with additional statistics about the comparison.

## Enable extended information on the summary page

Include extended statistics along with the standard summary page.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.extended_summary_page = True
    comparer.compare("result.docx", options)
```

🔹 Use case: Provide management with detailed metrics beyond the standard summary counts.


The result is as follows:

![](/comparison/python-net/images/how-to-get-extended-information-image.png)





---

## How to merge WAV files using C#

Path: /merger/net/getting-started/use-cases/how-to-merge-wav-files-using-csharp/


## WAV Merger .NET API

Developers can use [GroupDocs.Merger](https://products.groupdocs.com/merger/net) to concatenate multiple WAV audio files in the desired sequence and save them as a single  file.

## About WAV File Format

The WAV (Waveform Audio File Format) is a popular audio file format that is commonly used for storing uncompressed audio data. The format doesn’t apply any compression to the bitstream and stores the audio recordings with different sampling rates and bitrates. It has been and is one of the standard formats for audio CDs. 

WAV files are widely supported by audio software and hardware devices, making them a versatile choice for audio recording, editing, and playback.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/net) to obtain the API DLLs, MSI installer, or NuGet package:
```shell
PM> Install-Package GroupDocs.Merger
```
### Source Audio Files

<audio controls="controls">
  <source type="audio/wav" src="/merger/net/images/audio/sample1.wav"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

<audio controls="controls">
  <source type="audio/wav" src="/merger/net/images/audio/sample2.wav"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

### How To Merge Several WAV Files Into A Single File

The following example demonstrates how to combine multiple audio files with several lines of C# code:

* Create an instance of the [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass the source audio file path as a constructor parameter. You may specify absolute or relative file paths as per your requirements.
* Add another audio file to merge with the [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other audio files you want to merge.
* Call the [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the resulting audio file as a parameter.

```csharp
// Load the source WAV file
using (var merger = new GroupDocs.Merger.Merger(@"c:\sample1.wav"))
{
    // Add another WAV file to merge
    merger.Join(@"c:\sample2.wav");
    // Merge WAV files and save result
    merger.Save(@"c:\merged.wav");
}
```

### Result Of Joining WAV Files

<audio controls="controls">
  <source type="audio/wav" src="/merger/net/images/audio/merged.wav"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Combining WAV Live Demo

GroupDocs.Merger for .NET provides an online [**WAV Merger App**](https://products.groupdocs.app/merger/wav), which allows you to try it for free and check its quality and accuracy.
---

## How to merge WAV files using Java

Path: /merger/java/getting-started/use-cases/how-to-merge-wav-files-using-java/


## WAV Merger Java API

Developers can use [GroupDocs.Merger](https://products.groupdocs.com/merger/java) to concatenate multiple WAV audio files in the desired sequence and save them as a single  file.

## About WAV File Format

The WAV (Waveform Audio File Format) is a popular audio file format that is commonly used for storing uncompressed audio data. The format doesn’t apply any compression to the bitstream and stores the audio recordings with different sampling rates and bitrates. It has been and is one of the standard formats for audio CDs. 

WAV files are widely supported by audio software and hardware devices, making them a versatile choice for audio recording, editing, and playback.

### Download and Configure

Use the [downloads section](https://downloads.groupdocs.com/merger/java) to obtain the .jar package

### Source Audio Files

<audio controls="controls">
  <source type="audio/wav" src="/merger/net/images/audio/sample1.wav"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

<audio controls="controls">
  <source type="audio/wav" src="/merger/net/images/audio/sample2.wav"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

### How To Merge Several WAV Files Into A Single File

The following example demonstrates how to combine multiple audio files with several lines of Java code:

* Create an instance of the [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass the source audio file path as a constructor parameter. You may specify absolute or relative file paths as per your requirements.
* Add another audio file to merge with the [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) method. Repeat this step for other audio files you want to merge.
* Call the [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the resulting audio file as a parameter.

```java
// Load the source WAV file
Merger merger = new Merger("c:\sample1.wav"))
{
    // Add another WAV file to merge
    merger.join("c:\sample2.wav");
    // Merge WAV files and save result
    merger.save("c:\merged.wav");
}
```

### Result Of Joining WAV Files

<audio controls="controls">
  <source type="audio/wav" src="/merger/net/images/audio/merged.wav"></source>  
  <p>Your browser does not support the audio element.</p>
</audio>

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Combining WAV Live Demo

GroupDocs.Merger for .NET provides an online [**WAV Merger App**](https://products.groupdocs.app/merger/wav), which allows you to try it for free and check its quality and accuracy.
---

## How to Run Examples

Path: /assembly/net/how-to-run-examples/

## Download from GitHub

The complete examples package of **[GroupDocs.Assembly](https://reference.groupdocs.com/net/assembly)** is hosted on [Github](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET). You can either download the ZIP file from [here](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/archive/master.zip) or clone the repository of Github using your favorite Github client.

In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Screenshots/Windows%20Explorer.png?raw=true)

In extracted files and folders, you can see solution file for C# Project.

This project is created in **Microsoft Visual Studio 2013**. The **Data** folder contains some sample input templates used in the examples.

To run the examples, open solution file in Visual Studio and build the project. To add missing references of **GroupDocs.Assembly** see [Development Environment, Installation and Configuration]({{< ref "assembly/net/getting-started/development-environment-installation-and-configuration.md" >}}). All the functions are called from **Program.cs**. Un-comment the function you want to run and comment the rest.

![](https://github.com/groupdocsassembly/GroupDocs_Assembly_NET/blob/master/Examples/Data/Screenshots/program.PNG?raw=true)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples and showcase projects in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the code sample and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## eSign image with Digital signature

Path: /signature/net/esign-image-with-digital-signature/


## What is an Image Digital Signature?

An **Image Digital Signature** uses **steganography** (LSB - Least Significant Bit technique) to embed digital signatures directly into raster image pixels. This method allows you to add invisible, password-protected signatures to images while maintaining image quality. The signature data is embedded into the least significant bits of image pixels, making the signature undetectable to the naked eye.

### Key Features

* **Invisible Signatures**: Signatures are embedded directly into image pixels using steganography
* **Password Protection**: Signatures are protected with a password (minimum 4 characters)
* **Format Support**: Works with PNG and JPG image formats
* **Quality Preservation**: Image quality remains virtually unchanged
* **Size Requirements**: Images must meet minimum size requirements (8x8 pixels, 16,384 total pixels)

## Requirements

### Image Size Requirements

* **Minimum Width**: 8 pixels
* **Minimum Height**: 8 pixels
* **Minimum Total Pixels**: 16,384 pixels (width × height)

### Password Requirements

* **Minimum Length**: 4 characters
* **Case Sensitive**: Yes
* **Special Characters**: Allowed

### Supported Formats

* ✅ **PNG** - Fully supported
* ✅ **JPG/JPEG** - Fully supported
* ❌ **BMP** - Not supported for digital steganography signatures

## How to eSign image with Digital signature

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides the [ImageDigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagedigitalsignoptions) class to specify settings for digital signatures in images using steganography.

Here are the steps to sign an image with a digital signature:

* Create a new instance of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source image path as a constructor parameter
* Instantiate the [ImageDigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagedigitalsignoptions) object and set the [Password](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagedigitalsignoptions/password) property (minimum 4 characters)
* Call the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of the [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass the [ImageDigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/imagedigitalsignoptions) to it

This example shows how to sign an image with a digital signature using steganography.

```csharp
using (Signature signature = new Signature("image.png"))
{
    // Create sign options with password
    ImageDigitalSignOptions signOptions = new ImageDigitalSignOptions
    {
        Password = "MySecurePassword123"
    };

    // Sign the image
    SignResult signResult = signature.Sign("signed_image.png", signOptions);
    
    Console.WriteLine($"Image signed successfully. Found {signResult.Succeeded.Count} signatures.");
}
```

### Signing Images from Streams

You can also sign images using streams instead of file paths:

```csharp
using (Stream inputStream = new FileStream("image.png", FileMode.Open, FileAccess.Read))
using (Signature signature = new Signature(inputStream))
{
    ImageDigitalSignOptions signOptions = new ImageDigitalSignOptions
    {
        Password = "MySecurePassword123"
    };

    using (Stream outputStream = new FileStream("signed_image.png", FileMode.Create))
    {
        SignResult signResult = signature.Sign(outputStream, signOptions);
        Console.WriteLine($"Signed: {signResult.Succeeded.Count} signature(s) added.");
    }
}
```

### Error Handling

The library automatically validates password length and image size requirements. Handle exceptions appropriately:

```csharp
try
{
    using (Signature signature = new Signature("image.png"))
    {
        ImageDigitalSignOptions signOptions = new ImageDigitalSignOptions
        {
            Password = "MyPassword123"  // Minimum 4 characters required
        };

        SignResult signResult = signature.Sign("signed_image.png", signOptions);
        Console.WriteLine("✓ Image signed successfully!");
    }
}
catch (ArgumentException ex)
{
    Console.WriteLine($"Password validation error: {ex.Message}");
    // Password must be at least 4 characters long
}
catch (InvalidOperationException ex)
{
    Console.WriteLine($"Image size error: {ex.Message}");
    // Image is too small for digital steganography signature
}
```

## Limitations and Considerations

### Format Limitations

* **PNG**: Fully supported ✅
* **JPG/JPEG**: Fully supported ✅
* **BMP**: Not supported ❌
* **Other formats**: Not supported ❌

### Image Size Limitations

* Images smaller than 8x8 pixels cannot be signed
* Images with fewer than 16,384 pixels cannot be signed

### Steganography Considerations

* Image compression (especially JPG) may affect signature detection
* Image editing may corrupt embedded signatures
* Always keep original signed images for verification
* The signature is embedded invisibly in the image pixels

### Summary

This guide demonstrates how to use [**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) to sign images with digital signatures using steganography. It covers loading images, configuring password-protected digital signatures that are embedded invisibly into image pixels, and saving signed images. The feature provides invisible authentication while maintaining image quality and requires minimum size requirements for images.

### Advanced Usage Topics

To learn more about document eSign features, please refer to the [advanced usage section]({{< ref "signature/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.


---

## Import annotations

Path: /annotation/net/import-annotations/


GroupDocs.Annotation v22.1 and later allows you to import annotations from the XML files.

The following code snippet shows how to import annotations from an XML file:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("input.pdf-file")) // specify the path to the file with the annotated
{
	annotator.ImportAnnotationsFromDocument("result.XML-file"); // specify the path to the result XML file
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Indexing from different sources

Path: /search/java/indexing-from-different-sources/

GroupDocs.Search allows indexing documents from various sources:

- From files in the file system.
- From a stream.
- From a data structure as an array of fields.

The library also allows indexing from all presented sources with lazy initialization.

Please note that the update operation automatically generates a list of changed files only when indexing from the local file system. When indexing from streams or structures, documents cannot be updated with the update operation. To update documents from these sources, you must re-index the modified documents by passing their keys and updated data to the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#add(com.groupdocs.search.Document[],%20com.groupdocs.search.options.IndexingOptions)) method.

## Indexing from a file

It should be borne in mind that the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#add(com.groupdocs.search.Document[],%20com.groupdocs.search.options.IndexingOptions)) method with the parameter of type [Document](https://reference.groupdocs.com/search/java/com.groupdocs.search/Document)[] allows indexing only documents individually, and not entire folders. The advantage of using this method overload is that you can add attributes and additional fields to the indexed document before calling the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#add(com.groupdocs.search.Document[],%20com.groupdocs.search.options.IndexingOptions)) method. The following example demonstrates how to index a document from a file.

**Java**

```java
String indexFolder = "c:\\MyIndex";
String documentFilePath = "c:\\MyDocuments\\ExampleDocument.pdf"";

// Creating an index
IndexSettings settings = new IndexSettings();
settings.setUseRawTextExtraction(false);
Index index = new Index(indexFolder, settings);

// Creating a document object
Document document = Document.createFromFile(documentFilePath);
Document[] documents = new Document[] {
    document,
};

// Indexing document from the file
IndexingOptions options = new IndexingOptions();
index.add(documents, options);
```

## Indexing from a stream

The following example demonstrates how to index a document from a stream.

**Java**

```java
String indexFolder = "c:\\MyIndex";
String documentFilePath = "c:\\MyDocuments\\ExampleDocument.pdf";

// Creating an index
Index index = new Index(indexFolder);

// Creating a document object
InputStream stream = new FileInputStream(documentFilePath); // Opening a stream
Document document = Document.createFromStream(documentFilePath, new Date(), ".pdf", stream);
Document[] documents = new Document[] {
    document,
};

// Indexing document from the stream
IndexingOptions options = new IndexingOptions();
index.add(documents, options);

// Closing the document stream after indexing is complete
stream.close();
```

## Indexing from a structure

The following example demonstrates how to index a document from a structure.

**Java**

```java
String indexFolder = "c:\\MyIndex";
String documentFilePath = "c:\\MyDocuments\\ExampleDocument.txt";

// Creating an index
Index index = new Index(indexFolder);

// Creating a document object
String text = new String(Files.readAllBytes(Paths.get(documentFilePath)), StandardCharsets.UTF_8);
DocumentField[] fields = new DocumentField[] {
    new DocumentField(CommonFieldNames.Content, text),
};
Document document = Document.createFromStructure("ExampleDocument", new Date(), fields);
Document[] documents = new Document[] {
    document,
};

// Indexing document from the structure
IndexingOptions options = new IndexingOptions();
index.add(documents, options);
```

## Indexing from URL

The following example demonstrates how to index a document by URL when lazy initialized.

**Java**

```java
private static class DocumentLoaderFromUrl implements IDocumentLoader {
    private final String documentKey;
    private final String url;
    private final String extension;

    public DocumentLoaderFromUrl(String documentKey, String url, String extension) {
        this.documentKey = documentKey;
        this.url = url;
        this.extension = extension;
    }

    @Override
    public final Document loadDocument() {
        try {
            URL urlInstance = new URL(url);
            InputStream stream = urlInstance.openStream();
            Document document = Document.createFromStream(documentKey, new Date(), extension, stream);
            return document;
        } catch (java.io.IOException ex) {
            throw new RuntimeException(ex);
        }
    }

    @Override
    public final void closeDocument() {
    }
}


String indexFolder = "c:\\MyIndex";
String url = "http://example.com/ExampleDocument.pdf";

// Creating an index
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));
settings.setUseRawTextExtraction(false);
Index index = new Index(indexFolder, settings, true);

index.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
    @Override
    public void invoke(Object s, IndexErrorEventArgs a) {
        System.out.println(a.getMessage());
    }
});

// Creating a document object
String documentKey = url;
IDocumentLoader documentLoader = new DocumentLoaderFromUrl(documentKey, url, ".pdf");
Document document = Document.createLazy(DocumentSourceKind.Stream, documentKey, documentLoader);
Document[] documents = new Document[] {
    document,
};

// Indexing the lazy-loaded document
IndexingOptions options = new IndexingOptions();
index.add(documents, options);
```

## Indexing from FTP

The following example demonstrates how to index a document from FTP when lazy initialized.

**Java**

```java
private static class DocumentLoaderFromUrl implements IDocumentLoader {
    private final String documentKey;
    private final String url;
    private final String extension;

    public DocumentLoaderFromUrl(String documentKey, String url, String extension) {
        this.documentKey = documentKey;
        this.url = url;
        this.extension = extension;
    }

    @Override
    public final Document loadDocument() {
        try {
            URL urlInstance = new URL(url);
            InputStream stream = urlInstance.openStream();
            Document document = Document.createFromStream(documentKey, new Date(), extension, stream);
            return document;
        } catch (java.io.IOException ex) {
            throw new RuntimeException(ex);
        }
    }

    @Override
    public final void closeDocument() {
    }
}


String indexFolder = "c:\\MyIndex";
String url = "ftp://example.com/ExampleDocument.pdf";

// Creating an index
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));
settings.setUseRawTextExtraction(false);
Index index = new Index(indexFolder, settings, true);

index.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
    @Override
    public void invoke(Object s, IndexErrorEventArgs a) {
        System.out.println(a.getMessage());
    }
});

// Creating a document object
String documentKey = url;
IDocumentLoader documentLoader = new DocumentLoaderFromUrl(documentKey, url, ".pdf");
Document document = Document.createLazy(DocumentSourceKind.Stream, documentKey, documentLoader);
Document[] documents = new Document[] {
    document,
};

// Indexing the lazy-loaded document
IndexingOptions options = new IndexingOptions();
index.add(documents, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing from different sources

Path: /search/net/indexing-from-different-sources/


GroupDocs.Search allows indexing documents from various sources:

- From files in the file system.
- From a stream.
- From a data structure as an array of fields.

The library also allows indexing from all presented sources with lazy initialization.

Please note that the update operation automatically generates a list of changed files only when indexing from the local file system. When indexing from streams or structures, documents cannot be updated with the update operation. To update documents from these sources, you must re-index the modified documents by passing their keys and updated data to the [Add](https://reference.groupdocs.com/search/net/groupdocs.search/index/methods/add/index) method.

## Indexing from a file

It should be borne in mind that the [Add](https://reference.groupdocs.com/search/net/groupdocs.search/index/methods/add/index) method with the parameter of type [Document](https://reference.groupdocs.com/search/net/groupdocs.search.common/document)[] allows indexing only documents individually, and not entire folders. The advantage of using this method overload is that you can add attributes and additional fields to the indexed document before calling the [Add](https://reference.groupdocs.com/search/net/groupdocs.search/index/methods/add/index) method. The following example demonstrates how to index a document from a file.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFilePath = @"c:\MyDocuments\ExampleDocument.pdf";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Creating a document object
Document document = Document.CreateFromFile(documentFilePath);
Document[] documents = new Document[]
{
    document,
};
  
// Indexing document from the file
IndexingOptions options = new IndexingOptions();
index.Add(documents, options);
```

## Indexing from a stream

The following example demonstrates how to index a document from a stream.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFilePath = @"c:\MyDocuments\ExampleDocument.pdf";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Creating a document object
Stream stream = File.OpenRead(documentFilePath); // Opening a stream
Document document = Document.CreateFromStream(documentFilePath, DateTime.Now, ".pdf", stream);
Document[] documents = new Document[]
{
    document,
};
  
// Indexing document from the stream
IndexingOptions options = new IndexingOptions();
index.Add(documents, options);
  
// Closing the document stream after indexing is complete
stream.Close();
```

## Indexing from a structure

The following example demonstrates how to index a document from a structure.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFilePath = @"c:\MyDocuments\ExampleDocument.txt";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Creating a document object
string text = File.ReadAllText(documentFilePath);
DocumentField[] fields = new DocumentField[]
{
    new DocumentField(CommonFieldNames.Content, text),
};
Document document = Document.CreateFromStructure("ExampleDocument", DateTime.Now, fields);
Document[] documents = new Document[]
{
    document,
};
  
// Indexing document from the structure
IndexingOptions options = new IndexingOptions();
index.Add(documents, options);
```

## Indexing from URL

The following example demonstrates how to index a document by URL when lazy initialized.

**C#**

```csharp
private class DocumentLoaderFromUrl : IDocumentLoader
{
    private readonly string documentKey;
    private readonly string url;
    private readonly string extension;
  
    public DocumentLoaderFromUrl(string documentKey, string url, string extension)
    {
        this.documentKey = documentKey;
        this.url = url;
        this.extension = extension;
    }
  
    public Document LoadDocument()
    {
        ServicePointManager.Expect100Continue = true;
        ServicePointManager.SecurityProtocol =
            SecurityProtocolType.Ssl3 |
            SecurityProtocolType.Tls |
            SecurityProtocolType.Tls12 |
            SecurityProtocolType.Tls11;
  
        WebRequest request = WebRequest.Create(url);
        using (WebResponse response = request.GetResponse())
        using (Stream stream = response.GetResponseStream())
        {
            MemoryStream memoryStream = new MemoryStream();
            stream.CopyTo(memoryStream);
            memoryStream.Position = 0;
            Document document = Document.CreateFromStream(documentKey, DateTime.Now, extension, memoryStream);
            return document;
        }
    }
  
    public void CloseDocument()
    {
    }
}
 
 
string indexFolder = @"c:\MyIndex";
string url = "http://example.com/ExampleDocument.pdf";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Creating a document object
string documentKey = url;
IDocumentLoader documentLoader = new DocumentLoaderFromUrl(documentKey, url, ".pdf");
Document document = Document.CreateLazy(DocumentSourceKind.Stream, documentKey, documentLoader);
Document[] documents = new Document[]
{
    document,
};
  
// Indexing the lazy-loaded document
IndexingOptions options = new IndexingOptions();
index.Add(documents, options);
```

## Indexing from FTP

The following example demonstrates how to index a document from FTP when lazy initialized.

**C#**

```csharp
private class DocumentLoaderFromUrl : IDocumentLoader
{
    private readonly string documentKey;
    private readonly string url;
    private readonly string extension;
  
    public DocumentLoaderFromUrl(string documentKey, string url, string extension)
    {
        this.documentKey = documentKey;
        this.url = url;
        this.extension = extension;
    }
  
    public Document LoadDocument()
    {
        FtpWebRequest request = (FtpWebRequest)WebRequest.Create(url);
        using (WebResponse response = request.GetResponse())
        using (Stream stream = response.GetResponseStream())
        {
            MemoryStream memoryStream = new MemoryStream();
            stream.CopyTo(memoryStream);
            memoryStream.Position = 0;
            Document document = Document.CreateFromStream(documentKey, DateTime.Now, extension, memoryStream);
            return document;
        }
    }
  
    public void CloseDocument()
    {
    }
}
 
 
string indexFolder = @"c:\MyIndex";
string url = "ftp://example.com/ExampleDocument.pdf";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Creating a document object
string documentKey = url;
IDocumentLoader documentLoader = new DocumentLoaderFromUrl(documentKey, url, ".pdf");
Document document = Document.CreateLazy(DocumentSourceKind.Stream, documentKey, documentLoader);
Document[] documents = new Document[]
{
    document,
};
  
// Indexing the lazy-loaded document
IndexingOptions options = new IndexingOptions();
index.Add(documents, options);
```

## Indexing from Amazon S3 Storage

The following example demonstrates how to index a document from Amazon S3 Storage when lazy initialized.

**C#**

```csharp
private class DocumentLoaderFromAmazon : IDocumentLoader
{
    private readonly string documentKey;
    private readonly string extension;
    private readonly string storageKey;
  
    public DocumentLoaderFromAmazon(string documentKey, string extension, string storageKey)
    {
        this.documentKey = documentKey;
        this.extension = extension;
        this.storageKey = storageKey;
    }
  
    public Document LoadDocument()
    {
        AmazonS3Client client = new AmazonS3Client();
        string bucketName = "my-bucket";
        GetObjectRequest request = new GetObjectRequest
        {
            Key = storageKey,
            BucketName = bucketName,
        };
        using (GetObjectResponse response = client.GetObject(request))
        {
            MemoryStream memoryStream = new MemoryStream();
            response.ResponseStream.CopyTo(memoryStream);
            memoryStream.Position = 0;
            Document document = Document.CreateFromStream(documentKey, DateTime.Now, extension, memoryStream);
            return document;
        }
    }
  
    public void CloseDocument()
    {
    }
}
 
 
string indexFolder = @"c:\MyIndex";
string key = "example.pdf";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Creating a document object
IDocumentLoader documentLoader = new DocumentLoaderFromAmazon("documentKey", ".pdf", key);
Document document = Document.CreateLazy(DocumentSourceKind.Stream, "documentKey", documentLoader);
Document[] documents = new Document[]
{
    document,
};
  
// Indexing the lazy-loaded document
IndexingOptions options = new IndexingOptions();
index.Add(documents, options);
```

## Indexing from Azure Blob Storage

The following example demonstrates how to index a document from Azure Blob Storage when lazy initialized.

**C#**

```csharp
private class DocumentLoaderFromAzure : IDocumentLoader
{
    private readonly string documentKey;
    private readonly string extension;
    private readonly string blobName;
  
    public DocumentLoaderFromAzure(string documentKey, string extension, string blobName)
    {
        this.documentKey = documentKey;
        this.extension = extension;
        this.blobName = blobName;
    }
  
    public Document LoadDocument()
    {
        string accountName = "***";
        string accountKey = "***";
        string endpoint = $"https://{accountName}.blob.core.windows.net/";
        string containerName = "***";
        StorageCredentials storageCredentials = new StorageCredentials(accountName, accountKey);
        CloudStorageAccount cloudStorageAccount = new CloudStorageAccount(
            storageCredentials, new Uri(endpoint), null, null, null);
        CloudBlobClient cloudBlobClient = cloudStorageAccount.CreateCloudBlobClient();
        CloudBlobContainer container = cloudBlobClient.GetContainerReference(containerName);
        container.CreateIfNotExists();
  
        CloudBlob blob = container.GetBlobReference(blobName);
        MemoryStream memoryStream = new MemoryStream();
        blob.DownloadToStream(memoryStream);
        memoryStream.Position = 0;
  
        Document document = Document.CreateFromStream(documentKey, DateTime.Now, extension, memoryStream);
        return document;
    }
  
    public void CloseDocument()
    {
    }
}
 
 
string indexFolder = @"c:\MyIndex";
string blobName = "example.pdf";
  
// Creating an index
Index index = new Index(indexFolder);
  
// Creating a document object
IDocumentLoader documentLoader = new DocumentLoaderFromAzure("documentKey", ".pdf", blobName);
Document document = Document.CreateLazy(DocumentSourceKind.Stream, "documentKey", documentLoader);
Document[] documents = new Document[]
{
    document,
};
  
// Indexing the lazy-loaded document
IndexingOptions options = new IndexingOptions();
index.Add(documents, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing from different sources

Path: /search/nodejs-java/indexing-from-different-sources/

GroupDocs.Search allows indexing documents from various sources:

- From files in the file system.
- From a stream.
- From a data structure as an array of fields.

The library also allows indexing from all presented sources with lazy initialization.

Please note that the update operation automatically generates a list of changed files only when indexing from the local file system. When indexing from streams or structures, documents cannot be updated with the update operation. To update documents from these sources, you must re-index the modified documents by passing their keys and updated data to the [add](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#add(com.groupdocs.search.Document[],%20com.groupdocs.search.options.IndexingOptions)) method.

## Indexing from a file

It should be borne in mind that the [add](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#add(com.groupdocs.search.Document[],%20com.groupdocs.search.options.IndexingOptions)) method with the parameter of type [Document](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Document)[] allows indexing only documents individually, and not entire folders. The advantage of using this method overload is that you can add attributes and additional fields to the indexed document before calling the [add](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#add(com.groupdocs.search.Document[],%20com.groupdocs.search.options.IndexingOptions)) method. The following example demonstrates how to index a document from a file.

```javascript
const indexFolder = 'c:/MyIndex';
const documentFilePath = 'c:/MyDocuments/ExampleDocument.pdf';

// Creating an index
const settings = new groupdocs.search.IndexSettings();
const index = new groupdocs.search.Index(indexFolder, settings);

// Creating a document object
const document = groupdocs.search.Document.createFromFile(documentFilePath);
const documents = java.newArray('com.groupdocs.search.Document', [document]);

// Indexing document from the file
const options = new groupdocs.search.IndexingOptions();
options.setUseRawTextExtraction(false);
index.add(documents, options);
```

## Indexing from a stream

The following example demonstrates how to index a document from a stream.

```javascript
const indexFolder = 'c:/MyIndex';
const documentFilePath = 'c:/MyDocuments/ExampleDocument.pdf';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Creating a document object
const stream = java.newInstanceSync('java.io.FileInputStream', documentFilePath); // Opening a stream
const document = groupdocs.search.Document.createFromStream(documentFilePath, new Date(), '.pdf', stream);
const documents = java.newArray('com.groupdocs.search.Document', [document]);

// Indexing document from the stream
const options = new groupdocs.search.IndexingOptions();
index.add(documents, options);

// Closing the document stream after indexing is complete
stream.close();
```

## Indexing from a structure

The following example demonstrates how to index a document from a structure.

```javascript
const indexFolder = 'c:/MyIndex';
const documentFilePath = 'c:/MyDocuments/ExampleDocument.pdf';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Creating a document object
const text = fs.readFileSync(documentFilePath, 'utf8').toString();
const fields = java.newArray('com.groupdocs.search.common.DocumentField', [
  new groupdocs.search.DocumentField(groupdocs.search.CommonFieldNames.Content, text),
]);
const document = groupdocs.search.Document.createFromStructure(
  'ExampleDocument',
  java.newInstanceSync('java.util.Date'),
  fields,
);
const documents = java.newArray('com.groupdocs.search.Document', [document]);

// Indexing document from the structure
const options = new groupdocs.search.IndexingOptions();
index.add(documents, options);
```

## Indexing from URL

The following example demonstrates how to index a document by URL when lazy initialized.

```javascript
const indexFolder = 'c:/MyIndex';
const url = 'http://example.com/ExampleDocument.pdf';

// Creating an index
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High));
const index = new groupdocs.search.Index(indexFolder, settings, true);

index.getEvents().ErrorOccurred.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log(args.getMessage());
    },
  }),
);

// Creating a document object
const documentKey = url;
const extension = path.extname(url);
const documentLoader = java.newProxy('com.groupdocs.search.common.IDocumentLoader', {
  loadDocument: function () {
    const urlInstance = java.newInstanceSync('java.net.URL', url);
    const stream = urlInstance.openStream();
    const document = groupdocs.search.Document.createFromStream(
      documentKey,
      java.newInstanceSync('java.util.Date'),
      extension,
      stream,
    );
    return document;
  },
  closeDocument: function () {},
});
const document = groupdocs.search.Document.createLazy(
  groupdocs.search.DocumentSourceKind.Stream,
  documentKey,
  documentLoader,
);
const documents = java.newArray('com.groupdocs.search.Document', [document]);

// Indexing the lazy-loaded document
const options = new groupdocs.search.IndexingOptions();
options.setUseRawTextExtraction(false);
index.add(documents, options);
```

## Indexing from FTP

The following example demonstrates how to index a document from FTP when lazy initialized.

```javascript
const indexFolder = 'c:/MyIndex';
const url = 'ftp://example.com/ExampleDocument.pdf';

// Creating an index
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High));
const index = new groupdocs.search.Index(indexFolder, settings, true);

index.getEvents().ErrorOccurred.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log(args.getMessage());
    },
  }),
);

// Creating a document object
const documentKey = url;
const extension = path.extname(url);
const documentLoader = java.newProxy('com.groupdocs.search.common.IDocumentLoader', {
  loadDocument: function () {
    const urlInstance = java.newInstanceSync('java.net.URL', url);
    const stream = urlInstance.openStream();
    const document = groupdocs.search.Document.createFromStream(
      documentKey,
      java.newInstanceSync('java.util.Date'),
      extension,
      stream,
    );
    return document;
  },
  closeDocument: function () {},
});

const document = groupdocs.search.Document.createLazy(
  groupdocs.search.DocumentSourceKind.Stream,
  documentKey,
  documentLoader,
);
const documents = java.newArray('com.groupdocs.search.Document', [document]);

// Indexing the lazy-loaded document
const options = new groupdocs.search.IndexingOptions();
options.setUseRawTextExtraction(false);
index.add(documents, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Keyboard layout correction

Path: /search/java/keyboard-layout-correction/

When entering search queries, users of your software may make input errors, forgetting to switch the desired keyboard layout. For example, entering the word 'Einstein' in the Russian keyboard layout will result in the word 'Уштыеушт' appearing.

To automatically fix such misprints, the keyboard layout correction feature can be used. To enable this feature, you must pass the true value as an argument to the [setEnabled](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/KeyboardLayoutCorrectorOptions#setEnabled(boolean)) method in the search options. By default, this feature is disabled.

The following example demonstrates using of the keyboard layout correction feature.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.getKeyboardLayoutCorrector().setEnabled(true); // Enabling keyboard layout correction
 
// Search for word 'Уштыеушт' gives documents containing word 'Einstein'
SearchResult result = index.search("Уштыеушт", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Keyboard layout correction

Path: /search/net/keyboard-layout-correction/

When entering search queries, users of your software may make input errors, forgetting to switch the desired keyboard layout. For example, entering the word 'Einstein' in the Russian keyboard layout will result in the word 'Уштыеушт' appearing.

To automatically fix such misprints, the keyboard layout correction feature can be used. To enable this feature, you must set the true value for the [Enabled](https://reference.groupdocs.com/net/search/groupdocs.search.options/keyboardlayoutcorrectoroptions/properties/enabled) property in the search options. By default, this feature is disabled.

The following example demonstrates using of the keyboard layout correction feature.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Indexing documents from the specified folder
index.Add(documentsFolder);

// Creating a search options object
SearchOptions options = new SearchOptions();
options.KeyboardLayoutCorrector.Enabled = true; // Enabling keyboard layout correction

// Search for word 'Уштыеушт' gives documents containing word 'Einstein'
SearchResult result = index.Search("Уштыеушт", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Keyboard layout correction

Path: /search/nodejs-java/keyboard-layout-correction/

When entering search queries, users of your software may make input errors, forgetting to switch the desired keyboard layout. For example, entering the word 'Einstein' in the Russian keyboard layout will result in the word 'Уштыеушт' appearing.

To automatically fix such misprints, the keyboard layout correction feature can be used. To enable this feature, you must pass the true value as an argument to the [setEnabled](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/KeyboardLayoutCorrectorOptions#setEnabled(boolean)) method in the search options. By default, this feature is disabled.

The following example demonstrates using of the keyboard layout correction feature.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Creating a search options object
const options = new groupdocs.search.SearchOptions();
options.getKeyboardLayoutCorrector().setEnabled(true); // Enabling keyboard layout correction

// Search for word 'ызщкеыьфт' gives documents containing word 'sportsman'
const query = 'ызщкеыьфт';
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Load TXT document with options

Path: /conversion/net/load-txt-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [TxtLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/txtloadoptions) to give you control over how the source text document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[DetectNumberingWithWhitespaces](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/txtloadoptions/detectnumberingwithwhitespaces)** | Allows specifying how numbered list items are recognized when a plain-text document is converted. If this option is set to false, the list's recognition algorithm detects list paragraphs, when list numbers end with either dot, right bracket or bullet symbols (such as "•", "\*", "-" or "o"). If this option is set to true, the white spaces are also used as list number delimiters: the list recognition algorithm for Arabic style numbering (1., 1.1.2.) uses both white spaces and dot (".") symbols. |
|**[Encoding](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/txtloadoptions/encoding)** | Specifies the encoding to be used to load the document. |
|**[LeadingSpacesOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/txtloadoptions/leadingspacesoptions)** | Specifies how leading spaces will be processed. The available options are: *ConvertToIdent, Preserve, Trim* |
|**[TrailingSpacesOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/txtloadoptions/trailingspacesoptions)** | Specifies how trailing spaces will be processed. The available options are: *Preserve, Trim* |

### Control behavior of processing leading spaces

The following code snippet shows how to convert a TXT document and control the way the leading spaces are processed:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new TxtLoadOptions
{
    LeadingSpacesOptions = TxtLeadingSpacesOptions.ConvertToIndent,
    DetectNumberingWithWhitespaces = true
};
using (Converter converter = new Converter("sample.txt", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Control behavior of processing trailing spaces

The following code snippet shows how to convert a TXT document and the way the trailing spaces are processed:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new TxtLoadOptions
{
    TrailingSpacesOptions = TxtTrailingSpacesOptions.Trim
};
using (Converter converter = new Converter("sample.txt", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

### Specify encoding

The following code snippet shows how to convert a TXT document and specify the encoding:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new TxtLoadOptions
{
    Encoding = Encoding.GetEncoding("shift_jis")
};
using (Converter converter = new Converter("sample.txt", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

---

## Merge HTML

Path: /merger/net/merge/html/


HTML (Hyper Text Markup Language) is the extension for web pages created for display in browsers. Known as language of the web, HTML has evolved with requirements of new information requirements to be displayed as part of web pages. The latest variant is known as HTML 5 that gives a lot of flexibility for working with the language. HTML pages are either received from server, where these are hosted, or can be loaded from local system as well.

## How to merge HTML files programmatically

When you need to merge multiple HTML pages into a single file you can do this  with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/net) and all content like text, images, tables, graphs, forms etc. will be preserved.

The following in an example of how to merge HTML files programmatically:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source HTML file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another HTML file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other HTML documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged HTML file as parameter.

```csharp
// Load the source HTML file
using (Merger merger = new Merger(@"c:\sample1.html"))
{
    // Add another HTML file to merge
    merger.Join(@"c:\sample2.html");
    // Merge HTML files and save result
    merger.Save(@"c:\merged.html");
}
```

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge HTML Live Demo

GroupDocs.Merger for .NET provides an online [**HTML Merger App**](https://products.groupdocs.app/merger/html), which allows you to try it for free and check its quality and accuracy.

---

## Optimize the PDF file by removing unused resources

Path: /viewer/java/optimization-pdf-remove-unused-resources/


In some cases [PDF](https://docs.fileformat.com/pdf/) documents may contain different resources, which are unused, which means they are not accessible and visible when viewing the document in any PDF viewer. Starting from the [version 24.12](https://releases.groupdocs.com/viewer/java/release-notes/2024/groupdocs-viewer-for-java-24-12-release-notes/) the GroupDocs.Viewer is able to remove such unused resources using two new public properties of the boolean type: `setRemoveUnusedObjects(...)` and `setRemoveUnusedStreams(...)`, both of which are located in the [`PdfOptimizationOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfoptimizationoptions/) class. By default, both options are disabled (`false`), so the GroupDocs.Viewer will not apply this optimization.

In order to explain these two options and their differences, we need to dive into the PDF structure a little bit.

PDF document consists of PDF objects. Every object has its number (ID) and may belong to one of the following types: name, string, number, boolean, null object, dictionary, array (forms PDF document structure), and stream (raw binary data). Objects may be referenced from other objects, for example, a dictionary or array may contain references to other objects. These references unite all parts of the PDF document and form a PDF document structure. Stream objects contain binary data, and the size of these data may be large. For example, images or fonts are stored as stream objects. After some manipulations with the document, some streams may be "orphaned" i.e. they may not have any reference to them. For example, the old image was replaced with the new one, but the binary data of the old image was not removed. In other words, the stream does not belong anymore to the document logically but still contained in the document physically. For removing such orphaned objects the `RemoveUnusedObjects` property exists — it finds orphaned objects in the document and removes them, this can help to decrease the document size of such objects found.

Every document page has its `Resources` dictionary which contains data like images, fonts, etc. which are used in the page contents. Resources are referenced by their names in the dictionary, for example, the page may contain the operator to draw the image with the name "Image12" on the particular place of the page. In some cases, the resource may become unused, for example, the image was removed from the page contents but left in page resources, or the page was extracted from the document but its resources still contain common resources of the document. Resource became "orphaned", please note that this is another situation, then described in `RemoveUnusedObject` explanation, because the object is still referenced from the resources dictionary of the page, but the resource is never used by the page (its name never used in page contents). `RemoveUnusedStreams` property, when enabled, finds and removes these unnecessary resources. Since after this process removed resource stream objects became not linked with document structure, `RemoveUnusedObjects` option is automatically activated when `RemoveUnusedResources` is used.

Here is an example, where both options are applied to the same input PDF file, so Viewer produces two output PDF files with distinct options applied.

{{< tabs "Example1">}}
{{< tab "Java" >}}
```java
final String filename = "sample.pdf";

PdfViewOptions viewOptions1 = new PdfViewOptions("output1.pdf");
viewOptions1.setPdfOptimizationOptions(new PdfOptimizationOptions());
viewOptions1.getPdfOptimizationOptions().setRemoveUnusedObjects(true);

PdfViewOptions viewOptions2 = new PdfViewOptions("output2.pdf");
viewOptions2.setPdfOptimizationOptions(new PdfOptimizationOptions());
viewOptions2.getPdfOptimizationOptions().setRemoveUnusedStreams(true);

try (Viewer viewer = new Viewer(filename)) {
    viewer.view(viewOptions1);
    viewer.view(viewOptions2);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kitlin
val filename = "sample.pdf"

val viewOptions1 = PdfViewOptions("output1.pdf").apply {
    pdfOptimizationOptions = PdfOptimizationOptions().apply {
        removeUnusedObjects = true
    }
}

val viewOptions2 = PdfViewOptions("output2.pdf").apply {
    pdfOptimizationOptions = PdfOptimizationOptions().apply {
        removeUnusedStreams = true
    }
}

Viewer(filename).use { viewer ->
    viewer.view(viewOptions1)
    viewer.view(viewOptions2)
}
```
{{< /tab >}}
{{< /tabs >}}

As it is explained above, the effectiveness of the described optimizations depends solely on the specific PDF file — if it has no “orphaned” objects or streams, then these optimizations will do nothing, they only increase the document processing time. However, in some cases they can reduce the document size significantly, even several times.

We checked both `RemoveUnusedObjects` and `RemoveUnusedStreams` on our internal sample PDF documents, and measured their size before and after applied optimizations. Results are shown in the table below.

| Filename                                                                                 | Original size, bytes | `RemoveUnusedObjects`, bytes | `RemoveUnusedStreams`, bytes  |
|------------------------------------------------------------------------------------------|----------------------|------------------------------|-------------------------------|
| [Sample1.pdf](/viewer/java/sample-files/developer-guide/rendering-documents/Sample1.pdf) | 131 832              | 2 274                        | 131 832                       |
| [Sample2.pdf](/viewer/java/sample-files/developer-guide/rendering-documents/Sample2.pdf) | 131 870              | 131 774                      | 2 690                         |


---

## Optimize the PDF file by removing unused resources

Path: /viewer/net/optimization-pdf-remove-unused-resources/


In some cases [PDF](https://docs.fileformat.com/pdf/) documents may contain different resources, which are unused, which means they are not accessible and visible when viewing the document in any PDF viewer. Starting from the [version 24.6](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-6-release-notes/) the GroupDocs.Viewer is able to remove such unused resources using wo new public properties of the boolean type: `RemoveUnusedObjects` and `RemoveUnusedStreams`, both of which are located in the [`PdfOptimizationOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfoptimizationoptions/) class. By default both options are disabled (`false`), so the GroupDocs.Viewer will not apply this optimization.

In order to explain these two options and their differences, we need to dive into the PDF structure a little bit.

PDF document consists of PDF objects. Every object has its number (ID) and may belong to one of the following types: name, string, number, boolean, null object, dictionary, array (forms PDF document structure), and stream (raw binary data). Objects may be referenced from other objects, for example, a dictionary or array may contain references to other objects. These references unite all parts of the PDF document and form a PDF document structure. Stream objects contain binary data, and the size of these data may be large. For example, images or fonts are stored as stream objects. After some manipulations with the document, some streams may be "orphaned" i.e. they may not have any reference to them. For example, the old image was replaced with the new one, but the binary data of the old image was not removed. In other words, the stream does not belong anymore to the document logically but still contained in the document physically. For removing such orphaned objects the `RemoveUnusedObjects` property exists — it finds orphaned objects in the document and removes them, this can help to decrease the document size of such objects found.

Every document page has its `Resources` dictionary which contains data like images, fonts, etc. which are used in the page contents. Resources are referenced by their names in the dictionary, for example, the page may contain the operator to draw the image with the name "Image12" on the particular place of the page. In some cases, the resource may become unused, for example, the image was removed from the page contents but left in page resources, or the page was extracted from the document but its resources still contain common resources of the document. Resource became "orphaned", please note that this is another situation, then described in `RemoveUnusedObject` explanation, because the object is still referenced from the resources dictionary of the page, but the resource is never used by the page (its name never used in page contents). `RemoveUnusedStreams` property, when enabled, finds and removes these unnecessary resources. Since after this process removed resource stream objects became not linked with document structure, `RemoveUnusedObjects` option is automatically activated when `RemoveUnusedResources` is used.

Here is an example, where both options are applied to the same input PDF file, so Viewer produces two output PDF files with distinct options applied.

{{< tabs "Example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

const string filename = "sample.pdf";

PdfViewOptions viewOptions1 = new PdfViewOptions("output1.pdf");
viewOptions1.PdfOptimizationOptions = new PdfOptimizationOptions();
viewOptions1.PdfOptimizationOptions.RemoveUnusedObjects = true;

PdfViewOptions viewOptions2 = new PdfViewOptions("output2.pdf");
viewOptions2.PdfOptimizationOptions = new PdfOptimizationOptions();
viewOptions2.PdfOptimizationOptions.RemoveUnusedStreams = true;

using (Viewer viewer = new Viewer(filename))
{
    viewer.View(viewOptions1);
    viewer.View(viewOptions2);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Const filename As String = "sample.pdf"

        Dim viewOptions1 As PdfViewOptions = New PdfViewOptions("output1.pdf")
        viewOptions1.PdfOptimizationOptions = New PdfOptimizationOptions()
        viewOptions1.PdfOptimizationOptions.RemoveUnusedObjects = True

        Dim viewOptions2 As PdfViewOptions = New PdfViewOptions("output2.pdf")
        viewOptions2.PdfOptimizationOptions = New PdfOptimizationOptions()
        viewOptions2.PdfOptimizationOptions.RemoveUnusedStreams = True

        Using viewer As New Viewer(filename)
            viewer.View(viewOptions1)
            viewer.View(viewOptions2)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

As it is explained above, the effectiveness of the described optimizations depends solely on the specific PDF file — if it has no “orphaned” objects or streams, then these optimizations will do nothing, they only increase the document processing time. However, in some cases they can reduce the document size significantly, even several times.

We checked both `RemoveUnusedObjects` and `RemoveUnusedStreams` on our internal sample PDF documents, and measured their size before and after applied optimizations. Results are shown in the table below.

| Filename    | Original size, bytes | `RemoveUnusedObjects`, bytes | `RemoveUnusedStreams`, bytes |
| ----------- | ------- | -------- | ------- |
| [Sample1.pdf](/viewer/net/sample-files/developer-guide/rendering-documents/Sample1.pdf) | 131 832 | 2 274    | 131 832 |
| [Sample2.pdf](/viewer/net/sample-files/developer-guide/rendering-documents/Sample2.pdf) | 131 870 | 131 774  | 2 690   |


---

## Optimize the PDF file by removing unused resources

Path: /viewer/python-net/optimization-pdf-remove-unused-resources/


In some cases [PDF](https://docs.fileformat.com/pdf/) documents may contain different resources, which are unused, which means they are not accessible and visible when viewing the document in any PDF viewer. Starting from this [version 24.9](https://releases.groupdocs.com/viewer/python-net/release-notes/2024/groupdocs-viewer-for-python-via-net-24-9-release-notes/) the GroupDocs.Viewer is able to remove such unused resources using wo new public properties of the boolean type: `remove_unused_objects` and `remove_unused_streams`, both of which are located in the [`PdfOptimizationOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfoptimizationoptions/) class. By default both options are disabled (`False`), so the GroupDocs.Viewer will not apply this optimization.

In order to explain these two options and their differences, we need to dive into the PDF structure a little bit.

PDF document consists of PDF objects. Every object has its number (ID) and may belong to one of the following types: name, string, number, boolean, null object, dictionary, array (forms PDF document structure), and stream (raw binary data). Objects may be referenced from other objects, for example, a dictionary or array may contain references to other objects. These references unite all parts of the PDF document and form a PDF document structure. Stream objects contain binary data, and the size of these data may be large. For example, images or fonts are stored as stream objects. After some manipulations with the document, some streams may be "orphaned" i.e. they may not have any reference to them. For example, the old image was replaced with the new one, but the binary data of the old image was not removed. In other words, the stream does not belong anymore to the document logically but still contained in the document physically. For removing such orphaned objects the `remove_unused_objects` property exists — it finds orphaned objects in the document and removes them, this can help to decrease the document size of such objects found.

Every document page has its `Resources` dictionary which contains data like images, fonts, etc. which are used in the page contents. Resources are referenced by their names in the dictionary, for example, the page may contain the operator to draw the image with the name "Image12" on the particular place of the page. In some cases, the resource may become unused, for example, the image was removed from the page contents but left in page resources, or the page was extracted from the document but its resources still contain common resources of the document. Resource became "orphaned", please note that this is another situation, then described in `RemoveUnusedObject` explanation, because the object is still referenced from the resources dictionary of the page, but the resource is never used by the page (its name never used in page contents). `remove_unused_streams` property, when enabled, finds and removes these unnecessary resources. Since after this process removed resource stream objects became not linked with document structure, `remove_unused_objects` option is automatically activated when `RemoveUnusedResources` is used.

Here is an example, where both options are applied to the same input PDF file, so Viewer produces two output PDF files with distinct options applied.

{{< tabs "Example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PdfOptimizationOptions

def remove_unused_resources():

    view_options_1 = PdfViewOptions("remove_unused_resources/removed_unused_objects.pdf")
    view_options_1.pdf_optimization_options = PdfOptimizationOptions()
    view_options_1.pdf_optimization_options.remove_unused_objects = True

    view_options_2 = PdfViewOptions("remove_unused_resources/removed_unused_streams.pdf")
    view_options_2.pdf_optimization_options = PdfOptimizationOptions()
    view_options_2.pdf_optimization_options.remove_unused_streams = True

    with Viewer("sample.pdf") as viewer:
        viewer.view(view_options_1)
        viewer.view(view_options_2)

if __name__ == "__main__":
    remove_unused_resources()
```
{{< /tab >}}
{{< tab "sample.pdf" >}}
{{< tab-text >}}
`sample.pdf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/developer-guide/rendering-documents/rendering-to-pdf/optimization-pdf-options/pdf-remove-unused-resources/sample.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

As it is explained above, the effectiveness of the described optimizations depends solely on the specific PDF file — if it has no “orphaned” objects or streams, then these optimizations will do nothing, they only increase the document processing time. However, in some cases they can reduce the document size significantly, even several times.

We checked both `remove_unused_objects` and `remove_unused_streams` on our internal sample PDF documents, and measured their size before and after applied optimizations. Results are shown in the table below.

| Filename    | Original size, bytes | `remove_unused_objects`, bytes | `remove_unused_streams`, bytes |
| ----------- | ------- | -------- | ------- |
| [Sample1.pdf](/viewer/net/sample-files/developer-guide/rendering-documents/Sample1.pdf) | 131 832 | 2 274    | 131 832 |
| [Sample2.pdf](/viewer/net/sample-files/developer-guide/rendering-documents/Sample2.pdf) | 131 870 | 131 774  | 2 690   |


---

## Convert PDF files

Path: /conversion/java/convert/pdf/


Portable Document Format (PDF) was developed to introduce a standard for document representation and other reference material in a format that is independent of application software, hardware as well as from operating systems. Content of PDF files is not limited to text only, it could be hyperlinks, images, interactive buttons and forms, electronic signatures, watermarks, and many more. Therefore, it is often needed to convert PDF files to some other formats to edit or modify their content. Using **GroupDocs.Conversion for Java** library you can convert PDF files to a wide range of popular file formats, and all you need for this is just several lines of lines code in Java programming language.

GroupDocs.Conversion for Java supports different kinds of conversions from PDF documents to other file formats, and also conversion from different formats to PDF. You can examine conversion quality and accuracy online by using [GroupDocs.Conversion App](https://products.groupdocs.app/conversion/family) live demo. It works on any device and is  free.  
  
## Supported PDF file Conversions

{{< include file="/conversion/java/_includes/supported-conversions/pdf.md" type="page" >}}
  
## Convert PDF to Word

Microsoft Word is one of the most convenient ways to edit and manage document content, that's why PDF to Word conversion is so popular. Transforming a PDF file to a Word document in a manual way could be a tricky and lengthy process. Much easier is to convert PDF to Word programmatically in Java.
This way any file created as PDF could be converted to a Word document for later content manipulations and editing text, tables, images, lists, etc.

GroupDocs.Conversion for Java supports PDF conversion to all popular formats of Microsoft Word like - DOC, DOCX, RTF, etc. The document transformation process is quite simple and straightforward from the user's point of view - all you need is two-three lines of code. The default format for PDF to Word conversion is DOCX - it's a well-known format for Microsoft Word 2007 and later versions which is a combination of XML and binary files.  
Here is a code snippet for PDF to DOCX conversion:
{{< tabs "code-example">}}
{{< tab "PdfToDocxDocument.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;

public class PdfToDocxDocument {
    public static void convert() {
        // Initialize the converter with the source document
        try (Converter converter = new Converter("professional-services.pdf")) {
            // Set the convert options for DOCX format
            WordProcessingConvertOptions options = new WordProcessingConvertOptions();
            // Convert to DOCX format
            converter.convert("converted.docx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "professional-services.pdf" >}}  
{{< tab-text >}}
`professional-services.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/professional-services.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.docx" >}}  
{{< tab-text >}}
`converted.docx` is converted DOCX document. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/converted.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

GroupDocs.Conversion for Java also provides the [WordProcessingFileType](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.filetypes/wordprocessingfiletype/) class if you need to specify another Word file format as a target for your conversion. For example, DOC format represents documents generated by Microsoft Word 97-2003 and still is quite popular and the code snippet for PDF to DOC conversion is the following:
{{< tabs "code-example1">}}
{{< tab "PdfToDocDocument.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.WordProcessingFileType;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;

public class PdfToDocDocument {
    public static void convert() {
        // Initialize the converter with the source document
        try (Converter converter = new Converter("sample-with-toc.pdf")) {
            // Set the convert options for DOCX format
            WordProcessingConvertOptions options = new WordProcessingConvertOptions();
            options.setFormat(WordProcessingFileType.Doc);
            // Convert to DOCX format
            converter.convert("converted.doc", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample-with-toc.pdf" >}}  
{{< tab-text >}}
`sample-with-toc.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/sample-with-toc.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.doc" >}}  
{{< tab-text >}}
`converted.doc` is converted DOC document. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/converted.doc) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Convert PDF to Excel

Spreadsheet formats are designed to represent data in the form of rows and columns, and this way tables are much easier to use. Therefore, when it's required to transform data from a PDF file into Excel format GroupDocs.Conversion library comes to the rescue.  
  
You can choose from a wide range of supported spreadsheet formats:

* Microsoft Excel - XLS, XLSX, XLSM, XLSB, XLTX, XLT;
* OpenDocument - ODS, OTS;
* Apple iWork Numbers.

Required spreadsheet format can be specified with the help of the [SpreadsheetFileType](https://reference.groupdocs.com/conversion/java/groupdocs.conversion.filetypes/spreadsheetfiletype) class, however, the default format for PDF to Spreadsheet conversion is XLSX.
Please check below how to convert PDF to Excel in Java in a few lines of code.
{{< tabs "code-example2">}}
{{< tab "PdfToXlsxDocument.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

public class PdfToXlsxDocument {
    public static void convert() {
        // Initialize the converter with the source document
        try (Converter converter = new Converter("sample-with-toc.pdf")) {
            // Set the convert options for XLSX format
            SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
            // Convert to XLSX format
            converter.convert("converted.xlsx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample-with-toc.pdf" >}}  
{{< tab-text >}}
`sample-with-toc.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/sample-with-toc.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.xlsx" >}}  
{{< tab-text >}}
`converted.xlsx` is converted XLSX document. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/converted.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Convert PDF to PowerPoint

Presentation file formats store collections of records to accommodate data such as slides, shapes, text, animations, video, audio, and embedded objects. The most popular app for creating and editing presentations is Microsoft PowerPoint with its PPT and PPTX file formats, though there are plenty of applications that work with OpenDocument formats like ODP and OTP.

GroupDocs.Conversion is a wise choice when you have to convert a PDF file into PowerPoint format, and here is what the code snippet looks like for PDF to PPTX conversion in Java language:
{{< tabs "code-example3">}}
{{< tab "PdfToPptxDocument.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

public class PdfToPptxDocument {
    public static void convert() {
        // Initialize the converter with the source document
        try (Converter converter = new Converter("sample-with-toc.pdf")) {
            // Set the convert options for PPTX format
            PresentationConvertOptions options = new PresentationConvertOptions();
            // Convert to PPTX format
            converter.convert("converted.pptx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample-with-toc.pdf" >}}  
{{< tab-text >}}
`sample-with-toc.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/sample-with-toc.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.pptx" >}}  
{{< tab-text >}}
`converted.pptx` is converted PPTX document. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/converted.pptx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

In case you need to convert PDF to another presentation format please use the [PresentationFileType](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.filetypes/presentationfiletype/) class to specify it.

## Convert PDF to Image (PNG, JPG, BMP, TIFF)

A popular use case is when you need to save the whole PDF document or some specific document pages as a collection of images. GroupDocs.Conversion for Java allows converting PDF to images of many popular formats like - TIFF, JPG, PNG, GIF, BMP, and many others.
The code snippet for such conversion is a bit different from other conversions as you have to declare a [SavePageStream](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.contracts/savedocumentstream/) delegate that specifies the name format for the saved images. You can choose the desired image format by using the [ImageFileType](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.filetypes/ImageFileType) class.

Please check a complete code example of PDF to PNG conversion below:
{{< tabs "code-example4">}}
{{< tab "PdfToPngDocument.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;

public class PdfToPngDocument {
    public static void convert() {
        // Initialize the converter with the source document
        try (Converter converter = new Converter("sample-with-toc.pdf")) {
            // Lambda function to create an output stream for each page
            SavePageStream getPageStream = page -> {
                try {
                    // Creates an output stream to save each page as a separate PNG file
                    return new FileOutputStream(String.format("converted-page-%s.png", page));
                } catch (FileNotFoundException e) {
                    // Throws a runtime exception in case of an error
                    throw new RuntimeException(e);
                }
            };

            // Create an object for conversion settings
            ImageConvertOptions options = new ImageConvertOptions();
            
            // Set the output file format to PNG
            options.setFormat(ImageFileType.Png);

            // Perform PDF to PNG conversion, using the page stream function
            converter.convert(getPageStream, options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "sample-with-toc.pdf" >}}  
{{< tab-text >}}
`sample-with-toc.pdf` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/sample-with-toc.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "PdftoPng.zip" >}}  
{{< tab-text >}}
`PdftoPng.zip` is an archive that contains all pages converted to PNG. Click [here](/conversion/java/_sample_files/developer-guide/convert/pdf/PdftoPng.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Conclusion

[GroupDocs.Conversion for Java](https://products.groupdocs.com/conversion/java/) simplifies the process of converting PDFs to various formats while preserving accuracy and formatting. With a straightforward API and minimal coding effort, developers can integrate powerful document conversion features into Java applications.

---

## Convert PDF files

Path: /conversion/net/convert/pdf/


Portable Document Format (PDF) was developed to introduce a standard for document representation and other reference material in a format that is independent of application software, hardware as well as from operating systems. Content of PDF files is not limited to text only, it could be hyperlinks, images, interactive buttons and forms, electronic signatures, watermarks, and many more. Therefore, it is often needed to convert PDF files to some other formats to edit or modify their content. Using **GroupDocs.Conversion for .NET** library you can convert PDF files to a wide range of popular file formats, and all you need for this is just several lines of lines code in C# programming language.

GroupDocs.Conversion for .NET supports different kinds of conversions from PDF documents to other file formats, and also conversion from different formats to PDF. You can examine conversion quality and accuracy online by using [GroupDocs.Conversion App](https://products.groupdocs.app/conversion/family) live demo. It works on any device and is free.  
  
## Supported PDF file Conversions

{{< include file="/conversion/net/_includes/supported-conversions/pdf.md" type="page" >}}

## Convert PDF to Word

Microsoft Word is one of the most convenient ways to edit and manage document content, that's why PDF to Word conversion is so popular. Transforming a PDF file to a Word document in a manual way could be a tricky and lengthy process. Much easier is to convert PDF to Word programmatically in C#.
This way any file created as PDF could be converted to a Word document for later content manipulations and editing text, tables, images, lists, etc.

GroupDocs.Conversion for .NET supports PDF conversion to all popular formats of Microsoft Word like - DOC, DOCX, RTF, etc. The document transformation process is quite simple and straightforward from the user's point of view - all you need is two-three lines of code. The default format for PDF to Word conversion is DOCX - it's a well-known format for Microsoft Word 2007 and later versions which is a combination of XML and binary files.  
Here is a code snippet for PDF to DOCX conversion:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    // Set the convert options for DOCX format
   var options = new WordProcessingConvertOptions();
    // Convert to DOCX format
    converter.Convert("converted.docx", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertTo("converted.docx")
    .Convert();
```

GroupDocs.Conversion for .NET also provides the [WordProcessingFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/wordprocessingfiletype) class if you need to specify another Word file format as a target for your conversion. For example, DOC format represents documents generated by Microsoft Word 97-2003 and still is quite popular and the code snippet for PDF to DOC conversion is the following:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    // Set the convert options for DOC format
    var options = new WordProcessingConvertOptions  
    {  
      Format = GroupDocs.Conversion.FileTypes.WordProcessingFileType.Doc  
    };
    // Convert to DOC format
    converter.Convert("converted.doc", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertTo("converted.doc").WithOptions(new WordProcessingConvertOptions  
    {  
      Format = GroupDocs.Conversion.FileTypes.WordProcessingFileType.Doc  
    })
    .Convert();
```

## Convert PDF to Excel

Spreadsheet formats are designed to represent data in the form of rows and columns, and this way tables are much easier to use. Therefore, when it's required to transform data from a PDF file into Excel format GroupDocs.Conversion library comes to the rescue.  
  
You can choose from a wide range of supported spreadsheet formats:

* Microsoft Excel - XLS, XLSX, XLSM, XLSB, XLTX, XLT;
* OpenDocument - ODS, OTS;
* Apple iWork Numbers.

Required spreadsheet format can be specified with the help of the [SpreadsheetFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/spreadsheetfiletype) class, however, the default format for PDF to Spreadsheet conversion is XLSX.
Please check below how to convert PDF to Excel in C# in a few lines of code.

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    // Set the convert options for XLSX format
    var options = new SpreadsheetConvertOptions();
    // Convert to XLSX format
    converter.Convert("converted.xlsx", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertTo("converted.xlsx")
    .Convert();
```

## Convert PDF to PowerPoint

Presentation file formats store collections of records to accommodate data such as slides, shapes, text, animations, video, audio, and embedded objects. The most popular app for creating and editing presentations is Microsoft PowerPoint with its PPT and PPTX file formats, though there are plenty of applications that work with OpenDocument formats like ODP and OTP.

GroupDocs.Conversion for .NET is a wise choice when you have to convert a PDF file into PowerPoint format, and here is what the code snippet looks like for PDF to PPTX conversion in C# language:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    // Set the convert options for PPTX format
   var options = new PresentationConvertOptions();
    // Convert to PPTX format
    converter.Convert("converted.pptx", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertTo("converted.pptx")
    .Convert();
```

In case you need to convert PDF to another presentation format please use the [PresentationFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/presentationfiletype) class to specify it.

## Convert PDF to HTML

Converting PDF to HTML format is useful when you need to publish PDF content on the web, embed it into web applications, or share documents with users who don't have PDF viewing software. The GroupDocs.Conversion library allows exporting PDF documents to HTML and MHTML formats while preserving the document structure and formatting.

The code snippet for PDF to HTML conversion is pretty simple:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    // Set the convert options for HTML format
    var options = new WebConvertOptions();
    // Convert to HTML format
    converter.Convert("converted.html", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertTo("converted.html")
    .Convert();
```

When converting to MHTML format, specify the `Format` property of the [WebConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions) class:

```csharp
var options = new WebConvertOptions
{
    Format = GroupDocs.Conversion.FileTypes.WebFileType.Mhtml
};
```

## Convert PDF to Image

A popular use case is when you need to save the whole PDF document or some specific document pages as a collection of images. GroupDocs.Conversion for .NET allows converting PDF to images of many popular formats like - TIFF, JPG, PNG, GIF, BMP, and many others.
The code snippet for such conversion is a bit different from other conversions as you have to declare a [SavePageStream](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/savepagestream) delegate that specifies the name format for the saved images. You can choose the desired image format by using the [ImageFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/imagefiletype) class.

### Convert PDF to PNG

Please check a complete code example of PDF to PNG conversion below:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    Func<SavePageContext, Stream> getPageStream = saveContext => new FileStream(string.Format("converted-page-{0}.png", saveContext.Page), FileMode.Create);

    // Set the convert options for PNG format
    var options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png };
    // Convert to PNG format
    converter.Convert(getPageStream, options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertByPageTo(saveContext => new FileStream(string.Format("converted-page-{0}.png", saveContext.Page), FileMode.Create))
    .WithOptions(new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png })
    .Convert();
```

### Convert PDF to JPG

The PDF to JPG conversion is another popular use case and the code snippet for it is similar to what was described before. The only difference is the output image files extension and the `ImageConvertOptions.Format` property that should be set to `ImageFileType.Jpg`:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    Func<SavePageContext, Stream> getPageStream = saveContext => new FileStream(string.Format("converted-page-{0}.jpg", saveContext.Page), FileMode.Create);

    // Set the convert options for JPG format
    var options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Jpg };
    // Convert to JPG format
    converter.Convert(getPageStream, options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertByPageTo((SavePageContext saveContext) => new FileStream(string.Format("converted-page-{0}.jpg", saveContext.Page), FileMode.Create))
    .WithOptions(new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Jpg })
    .Convert();
```

### Convert PDF to TIFF

Tagged Image File Format (TIFF) is a little bit special since it can contain multi-page images. So when converting PDF to TIFF you can either save each page as a separate image or save it as a multi-page image.

To save each page separately, use the [SavePageStream](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/savepagestream) delegate and specify the output format by using the [ImageFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/imagefiletype) class:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    Func<SavePageContext, Stream> getPageStream = saveContext => new FileStream(string.Format("converted-page-{0}.tiff", saveContext.Page), FileMode.Create);

    // Set the convert options for TIFF format
    var options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Tiff };
    // Convert to TIFF format
    converter.Convert(getPageStream, options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertByPageTo((SavePageContext saveContext) => new FileStream(string.Format("converted-page-{0}.tiff", saveContext.Page), FileMode.Create))
    .WithOptions(new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Tiff })
    .Convert();
```

To save PDF as a multi-page TIFF, just specify the output format by using the [ImageFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/imagefiletype) class:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    // Set the convert options for TIFF format
    var options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Tiff };
    // Convert to TIFF format
    converter.Convert("multi-page.tiff", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertTo("multi-page.tiff")
    .WithOptions(new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Tiff })
    .Convert();
```

### Convert a single page from PDF to image

When working with multi-page PDF documents, you may need to convert only a specific page rather than the entire document. This is useful for creating thumbnails, extracting diagrams, or sharing individual pages as images.

{{< alert style="info" >}}
When converting to image formats other than TIFF (such as PNG, JPG, GIF, BMP), you can only save one page per output file. Saving multiple pages to a single file is only supported for TIFF format.
{{< /alert >}}

To convert a single page, use the [PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pagenumber) property of the [ImageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/imageconvertoptions) class. The page numbers are 1-based, meaning the first page is page 1.

The following code snippet shows how to convert page 2 from a PDF document to PNG format:

```csharp
// Load the source PDF file
using (var converter = new GroupDocs.Conversion.Converter("sample.pdf"))
{
    // Set the convert options for PNG format
    var options = new ImageConvertOptions
    {
        Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png,
        PageNumber = 2
    };
    // Convert to PNG format
    converter.Convert("converted-page-2.png", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.pdf")
    .ConvertTo("converted-page-2.png")
    .WithOptions(new ImageConvertOptions
    {
        Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png,
        PageNumber = 2
    })
    .Convert();
```

For more information about page selection options, refer to the [Convert specific pages]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/convert-specific-pages.md" >}}) and [Convert N consecutive pages]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/convert-n-consecutive-pages.md" >}}) articles.

---

## Convert PDF files

Path: /conversion/nodejs-java/convert/pdf/


Portable Document Format (PDF) was developed to introduce a standard for document representation and other reference material in a format that is independent of application software, hardware as well as from operating systems. Content of PDF files is not limited to text only, it could be hyperlinks, images, interactive buttons and forms, electronic signatures, watermarks, and many more. Therefore, it is often needed to convert PDF files to some other formats to edit or modify their content. Using **GroupDocs.Conversion for Node.js via Java** library you can convert PDF files to a wide range of popular file formats, and all you need for this is just several lines of lines code in Java programming language.

GroupDocs.Conversion for Node.js via Java supports different kinds of conversions from PDF documents to other file formats, and also conversion from different formats to PDF. You can examine conversion quality and accuracy online by using [GroupDocs.Conversion App](https://products.groupdocs.app/conversion/family) live demo. It works on any device and is free.  
  
## Supported PDF file Conversions

{{< include file="/conversion/nodejs-java/_includes/supported-conversions/pdf.md" type="page" >}}
  
## Convert PDF to Word

Microsoft Word is one of the most convenient ways to edit and manage document content, that's why PDF to Word conversion is so popular. Transforming a PDF file to a Word document in a manual way could be a tricky and lengthy process. Much easier is to convert PDF to Word programmatically in Java.
This way any file created as PDF could be converted to a Word document for later content manipulations and editing text, tables, images, lists, etc.

GroupDocs.Conversion for Node.js via Java supports PDF conversion to all popular formats of Microsoft Word like - DOC, DOCX, RTF, etc. The document transformation process is quite simple and straightforward from the user's point of view - all you need is two-three lines of code. The default format for PDF to Word conversion is DOCX - it's a well-known format for Microsoft Word 2007 and later versions which is a combination of XML and binary files.  
Here is a code snippet for PDF to DOCX conversion:

```js
// Load the source PDF file
const converter = new groupdocs.conversion.Converter("sample.pdf");
// Set the convert options for DOCX format
const options = new groupdocs.conversion.WordProcessingConvertOptions();
// Convert to DOCX format
converter.convert("converted.docx", options);
```

GroupDocs.Conversion for Node.js via Java also provides the [WordProcessingFileType](#) class if you need to specify another Word file format as a target for your conversion. For example, DOC format represents documents generated by Microsoft Word 97-2003 and still is quite popular and the code snippet for PDF to DOC conversion is the following:

```js
// Load the source PDF file
const converter = new groupdocs.conversion.Converter("sample.pdf");
// Set the convert options for DOC format
const options = new groupdocs.conversion.WordProcessingConvertOptions();
options.setFormat(groupdocs.conversion.WordProcessingFileType.Doc);
// Convert to DOC format
converter.convert("converted.doc", options);
```

## Convert PDF to Excel

Spreadsheet formats are designed to represent data in the form of rows and columns, and this way tables are much easier to use. Therefore, when it's required to transform data from a PDF file into Excel format GroupDocs.Conversion library comes to the rescue.  
  
You can choose from a wide range of supported spreadsheet formats:

* Microsoft Excel - XLS, XLSX, XLSM, XLSB, XLTX, XLT;
* OpenDocument - ODS, OTS;
* Apple iWork Numbers.

Required spreadsheet format can be specified with the help of the [SpreadsheetFileType](#) class, however, the default format for PDF to Spreadsheet conversion is XLSX.
Please check below how to convert PDF to Excel in JavaScript in a few lines of code.

```js
// Load the source PDF file
const converter = new groupdocs.conversion.Converter("sample.pdf");
// Set the convert options for XLSX format
const options = new groupdocs.conversion.SpreadsheetConvertOptions();
// Convert to XLSX format
converter.convert("converted.xlsx", options);
```

## Convert PDF to PowerPoint

Presentation file formats store collections of records to accommodate data such as slides, shapes, text, animations, video, audio, and embedded objects. The most popular app for creating and editing presentations is Microsoft PowerPoint with its PPT and PPTX file formats, though there are plenty of applications that work with OpenDocument formats like ODP and OTP.

GroupDocs.Conversion is a wise choice when you have to convert a PDF file into PowerPoint format, and here is what the code snippet looks like for PDF to PPTX conversion in JavaScript language:

```js
// Load the source PDF file
const converter = new groupdocs.conversion.Converter("sample.pdf");
// Set the convert options for PPTX format
const options = new groupdocs.conversion.PresentationConvertOptions();
// Convert to PPTX format
converter.convert("converted.pptx", options);
```

In case you need to convert PDF to another presentation format please use the [PresentationFileType](#) class to specify it.

## Convert PDF to Image

A popular use case is when you need to save the whole PDF document or some specific document pages as a collection of images. GroupDocs.Conversion for Node.js via Java allows converting PDF to images of many popular formats like - TIFF, JPG, PNG, GIF, BMP, and many others.
The code snippet for such conversion is a bit different from other conversions as you have to declare a [SavePageStream](#) delegate that specifies the name format for the saved images. You can choose the desired image format by using the [ImageFileType](#) class.

## Convert PDF to PNG

Please check a complete code example of PDF to PNG conversion below:

```js
// Load the source PDF file
const converter = new groupdocs.conversion.Converter("sample.pdf");
const outputFileTemplate = "converted-page-.png";

// Set the convert options for PNG format
const options = new groupdocs.conversion.ImageConvertOptions();
options.setFormat(groupdocs.conversion.ImageFileType.Png);
// Convert to PNG format
converter.convert(outputFileTemplate, options);
```

## Convert PDF to JPG

The PDF to JPG conversion is another popular use case and the code snippet for it is similar to what was described before. The only difference is the output image files extension and that the `ImageFileType.Jpg` argument should be passed to the `setFormat` method:

```js
// Load the source PDF file
const converter = new groupdocs.conversion.Converter("sample.pdf");
const outputFileTemplate = "converted-page-.jpg";
// Set the convert options for JPG format
const options = new groupdocs.conversion.ImageConvertOptions();
options.setFormat(groupdocs.conversion.ImageFileType.Jpg);
// Convert to JPG format
converter.convert(outputFileTemplate, options);
```

---

## Remove page redactions

Path: /redaction/java/remove-page-redactions/


GroupDocs.Redaction allows to easily to remove pages from PDF documents, slides from presentations and worksheets from spreadsheet documents. 

With GroupDocs.Redaction API you can remove pages by specifying the page range by means of its relative position (the beginning or the end), zero-based index and the count of pages to remove. At this time the supported formats are: PDF, presentations (Microsoft PowerPoint, OpenOffice Presentations), word processing documents (Microsoft Word, OpenOffice Texts, Rich Text Files), spreadsheets (Microsoft Excel, OpenOffice Spreadsheets, etc.) and multi-frame images.

## Remove page range

In the example below, we remove 2nd, 3rd and 4th pages from the document, if the document has enough pages:

```java
final Redactor redactor  = new Redactor("Sample.pdf");
try 
{
    IDocumentInfo info = redactor.getDocumentInfo();
    int startIndex = 1, pagesToDelete = 1;
    // Removes 1 page starting from 2nd one, requires at least 2 pages
    if (info.getPageCount() >= 2)
    {
        redactor.apply(new RemovePageRedaction(PageSeekOrigin.Begin, startIndex, pagesToDelete));
        SaveOptions tmp0 = new  SaveOptions();
        tmp0.setAddSuffix(true);
        tmp0.setRasterizeToPDF(false);
        redactor.save(tmp0);
    }
}
finally { redactor.close(); }
```

## Remove last page

In some cases you might need to delete the last page or a number of pages, no matter how many pages are there.

The following example demonstrates how to remove the last page from a document:

```java
final Redactor redactor  = new Redactor("Sample.pdf");
try 
{
    // Requires at least 1 page
    if (redactor.getDocumentInfo().getPageCount() >= 1)
    {
        redactor.apply(new RemovePageRedaction(PageSeekOrigin.End, 0, 1));
        SaveOptions tmp0 = new  SaveOptions();
        tmp0.setAddSuffix(true);
        tmp0.setRasterizeToPDF(false);
        redactor.save(tmp0);
    }
}
finally { redactor.close(); }
```

## Remove frame from image

In case of a multi-frame image you might need to delete a number of frames (treated as "pages").

The following example demonstrates how to remove 3 frames from an animated GIF image:

```java
final Redactor redactor = new Redactor("Animated.gif");
try 
{
    // Removes 5 frames starting from 3nd one, requires at least 7 frames
    if (redactor.getDocumentInfo().getPageCount() >= 7)
    {
        redactor.apply(new RemovePageRedaction(PageSeekOrigin.Begin, 2, 5));
        redactor.save();
    }
}
finally { redactor.close(); }
```
    
    


---

## Remove page redactions

Path: /redaction/net/remove-page-redactions/


GroupDocs.Redaction allows to easily to remove pages from PDF documents, slides from presentations and worksheets from spreadsheet documents. 

With GroupDocs.Redaction API you can remove pages by specifying the page range by means of its relative position (the beginning or the end), zero-based index and the count of pages to remove. At this time the supported formats are: PDF, presentations (Microsoft PowerPoint, OpenOffice Presentations), word processing documents (Microsoft Word, OpenOffice Texts, Rich Text Files), spreadsheets (Microsoft Excel, OpenOffice Spreadsheets, etc.) and multi-frame images.

## Remove page range

In the example below, we remove 2nd, 3rd and 4th pages from the document, if the document has enough pages:

**C#**

```csharp
using (Redactor redactor = new Redactor("sample.pdf"))
{
    // Removes 3 pages starting from 2nd one, requires at least 4 pages
    if (redactor.GetDocumentInfo().PageCount >= 4)
    {
        redactor.Apply(new RemovePageRedaction(PageSeekOrigin.Begin, 1, 3));
        redactor.Save();
    }
}
```

## Remove last page

In some cases you might need to delete the last page or a number of pages, no matter how many pages are there.

The following example demonstrates how to remove the last page from a document:

**C#**

```csharp
using (Redactor redactor = new Redactor("sample.pdf"))
{
    // Requires at least 1 page
    if (redactor.GetDocumentInfo().PageCount >= 1)
    {
        redactor.Apply(new RemovePageRedaction(PageSeekOrigin.End, 0, 1));
        redactor.Save();
    }
}
```

## Remove frame from image

In case of a multi-frame image you might need to delete a number of frames (treated as "pages").

The following example demonstrates how to remove 3 frames from an animated GIF image:

**C#**

```csharp
using (Redactor redactor = new Redactor("sample.gif"))
{
    // Removes 5 frames starting from 3nd one, requires at least 7 frames
    if (redactor.GetDocumentInfo().PageCount >= 7)
    {
        redactor.Apply(new RemovePageRedaction(PageSeekOrigin.Begin, 2, 5));
        redactor.Save();
    }
}
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
    
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Remove page redactions

Path: /redaction/python-net/remove-page-redactions/


GroupDocs.Redaction allows to easily to remove pages from PDF documents, slides from presentations and worksheets from spreadsheet documents. 

With GroupDocs.Redaction API you can remove pages by specifying the page range by means of its relative position (the beginning or the end), zero-based index and the count of pages to remove. At this time the supported formats are: PDF, presentations (Microsoft PowerPoint, OpenOffice Presentations), word processing documents (Microsoft Word, OpenOffice Texts, Rich Text Files), spreadsheets (Microsoft Excel, OpenOffice Spreadsheets, etc.) and multi-frame images.

## Remove page range

In the example below, we remove 2nd, 3rd and 4th pages from the document, if the document has enough pages:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr

def run():
    
    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:
        
        # Get document info
        doc_info = redactor.get_document_info()

        # Requires at least 4 pages
        if doc_info.page_count > 3:

            # Remove 3 pages starting from 2nd one, requires at least 4 pages
            rem_opt = grr.RemovePageRedaction(grr.PageSeekOrigin.BEGIN, 1, 3)
    
            # Apply the redaction
                result = redactor.apply(rem_opt)
        
                # Save the redacted document
                 redactor.save()
```

## Remove last page

In some cases you might need to delete the last page or a number of pages, no matter how many pages are there.

The following example demonstrates how to remove the last page from a document:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.redactions as grr

def run():
    
    # Load the document to be redacted
    with gr.Redactor("source.pdf") as redactor:
        
        # Get document info
        doc_info = redactor.get_document_info()

        # Requires at least 1 page
        if doc_info.page_count > 0:

            rem_opt = grr.RemovePageRedaction(grr.PageSeekOrigin.END, 0, 1)
    
            # Apply the redaction
                result = redactor.apply(rem_opt)
        
                # Save the redacted document
                 redactor.save()
```

## Remove frame from image

In case of a multi-frame image you might need to delete a number of frames (treated as "pages").

The following example demonstrates how to remove 3 frames from an animated GIF image:

**Python**

```python
import groupdocs.redaction as gr
import groupdocs.redaction.options as gro
import groupdocs.redaction.redactions as grr

def run():

    # Specify the redaction options
    rem_opt = grr.RemovePageRedaction(grr.PageSeekOrigin.BEGIN, 2, 5)

    # Load the document to be redacted
    with gr.Redactor("sample.gif") as redactor:

        # Remove 3 frames starting from 3nd one, requires at least 7 frames
        doc_info = redactor.get_document_info()

        if doc_info.page_count >= 7:
            # Apply the redaction
            result = redactor.apply(rem_opt)
        
            # Save the redacted document
            so = gro.SaveOptions()
            so.add_suffix = True
            so.rasterize_to_pdf = False
            result_path = redactor.save(so)
```

## More resources

### Advanced usage topics

To learn more about document redaction features, please refer to the [advanced usage section]({{< ref "redaction/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Redaction for Python via .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Python-via-.NET)
*   [GroupDocs.Redaction for .NET examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-.NET)
*   [GroupDocs.Redaction for Java examples](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
    

### Free online document redaction App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to perform redactions for various document formats like PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Redaction App](https://products.groupdocs.app/redaction).

---

## Render text documents as HTML, PDF, and image files

Path: /viewer/java/render-text-files/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to convert text documents to HTML, PDF, PNG, and JPEG formats so you can view document content in a web browser, PDF or image viewer application.

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a text document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/total" >}} {{< icon "gdoc_person" >}} View text files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported text file formats

GroupDocs.Viewer supports the following text and programming file formats:

* [.AS / .AS3 (ActionScript File)](https://docs.fileformat.com/programming/as/)
* [.ASM (Assembly Language Source Code File)](https://docs.fileformat.com/programming/asm/)
* [.BAT (DOS Batch File)](https://docs.fileformat.com/executable/bat/)
* [.C (C/C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CC (C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CMAKE (CMake File)](https://docs.fileformat.com/programming/cmake/)
* [.CPP (C++ Source Code File)](https://docs.fileformat.com/programming/cpp/)
* [.CS (C# Source Code File)](https://docs.fileformat.com/specification/programming/cs/)
* [.CSS (Cascading Style Sheet)](https://docs.fileformat.com/web/css/)
* [.CXX (C++ Source Code File)](https://docs.fileformat.com/programming/cxx/)
* [.DIFF (Patch File)](https://docs.fileformat.com/programming/diff/)
* [.ERB (Ruby ERB Script)](https://docs.fileformat.com/programming/erb/)
* [.GROOVY (Groovy Source Code File)](https://docs.fileformat.com/programming/groovy/)
* [.H (C/C++/Objective-C Header File)](https://docs.fileformat.com/programming/h/)
* [.HAML (Haml Source Code File)](https://docs.fileformat.com/programming/haml/)
* [.HH (C++ Header File)](https://docs.fileformat.com/programming/hh/)
* [.JAVA (Java Source Code File)](https://docs.fileformat.com/programming/java/)
* [.JS (JavaScript File)](https://docs.fileformat.com/web/js/)
* [.JSON (JavaScript Object Notation File)](https://docs.fileformat.com/web/json/)
* [.LESS (LESS Style Sheet)](https://docs.fileformat.com/web/less/)
* [.LOG (Log File)](https://docs.fileformat.com/database/log/)
* [.M (Objective-C Implementation File)](https://docs.fileformat.com/programming/m/)
* [.MAKE (Xcode Makefile Script)](https://docs.fileformat.com/programming/make/)
* [.MD (Markdown Documentation File)](https://docs.fileformat.com/word-processing/md/)
* [.ML (ML Source Code File)](https://docs.fileformat.com/programming/ml/)
* [.MM (Objective-C++ Source File)](https://docs.fileformat.com/programming/mm/)
* [.PHP (PHP Source Code File)](https://docs.fileformat.com/programming/php/)
* [.PL (Perl Script)](https://docs.fileformat.com/programming/pl/)
* [.PROPERTIES (Java Properties File)](https://en.wikipedia.org/wiki/.properties)
* [.PY (Python Script)](https://docs.fileformat.com/programming/py/)
* [.RB (Ruby Source Code)](https://docs.fileformat.com/ebook/rb/)
* [.RST (reStructuredText File)](https://docs.fileformat.com/programming/rst/)
* [.SASS (Syntactically Awesome StyleSheets File)](https://docs.fileformat.com/web/sass/)
* [.SCALA (Scala Source Code File)](https://docs.fileformat.com/programming/scala/)
* [.SCM (Scheme Source Code File)](https://docs.fileformat.com/programming/scm/)
* [.SCRIPT (Generic Script File)](https://docs.fileformat.com/programming/script/)
* [.SH (Bash Shell Script)](https://docs.fileformat.com/programming/sh/)
* [.SML (Standard ML Source Code File)](https://en.wikipedia.org/wiki/Standard_ML)
* [.SQL (Structured Query Language Data File)](https://docs.fileformat.com/database/sql/)
* [.TXT (Plain Text File)](https://docs.fileformat.com/word-processing/txt/)
* [.VB (Visual Basic Source Code File)](https://docs.fileformat.com/specification/programming/vb/)
* [.VIM (Vim Settings File)](https://docs.fileformat.com/misc/vim/)
* [.XML (XML File)](https://docs.fileformat.com/web/xml/)
* [.YAML (YAML Document)](https://docs.fileformat.com/programming/yaml/)

When you load a text document from a file, you should explicitly specify their format. To do this, create a [LoadOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions) class instance and use the [FileType](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/#setFileType-com.groupdocs.viewer.FileType-) method. Then pass this instance to the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class constructor.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.options.LoadOptions;
// ...

// Specify the file encoding. 
LoadOptions loadOptions = new LoadOptions(FileType.MD);

// Convert the document to PDF.
try (Viewer viewer = new Viewer(inputStream, loadOptions)) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}

```
{{< /tab >}}
{{< /tabs >}}

## Render text files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a text file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create HTML files with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("TermsOfService.txt")) {
    // Convert the text file to HTML.
    // {0} is replaced with the current page number in the output file names.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to HTML](/viewer/java/images/rendering-basics/render-text-files/render-to-html-embedded-resources.png)

### Create HTML files with external resources

If you want to store output HTML files and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("TermsOfService.txt")) {
   // Create an HTML file for each PDF page.
   // Specify the HTML file names and location of external resources.
   // {0} and {1} are replaced with the current page number and resource name, respectively.
   HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
   viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-text-files/render-to-html-external-resources.png)

### Create a single HTML page

If you need to display the entire document content on a single HTML page, use the [HtmlViewOptions.setRenderToSinglePage](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setRenderToSinglePage-boolean-) method, as shown below:

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("TermsOfService.txt")) {
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    // Render the file to a single page. 
    viewOptions.setRenderToSinglePage(true);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render text files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a text file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("TermsOfService.txt")) {
    // Convert the text file to PDF.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PDF](/viewer/java/images/rendering-basics/render-text-files/render-to-pdf.png)

## Render text files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a text file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("TermsOfService.txt")) {
    // Convert the text file to PNG.
    // {0} is replaced with the current page number in the output image names.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PNG](/viewer/java/images/rendering-basics/render-text-files/render-to-png-image.png)

## Render text files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert a text file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("TermsOfService.txt")) {
    // Convert the text file to JPEG.
    // {0} is replaced with the current page number in the output image names.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [TextOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoptions) class that allows you to specify different options for rendering text files. To access these options, use the [setTextOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setTextOptions-com.groupdocs.viewer.options.TextOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

The `TextOptions` class supports the following methods:

* [setMaxRowsPerPage](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoptions/#setMaxRowsPerPage-int-)---Specifies the maximum number of rows per page. The default value is **55**.

* [setMaxCharsPerRow](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/textoptions/#setMaxCharsPerRow-int-)---Specifies the maximum number of characters per row. The default value is **85**.

The following example demonstrates how to change the number of rows displayed on each HTML page:

{{< tabs "example9">}}
{{< tab "Java" >}}
```java

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("TermsOfService.txt")) {
    // Convert the text file to HTML.
    // {0} is replaced with the current page number in the output file names.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    // Set the maximum number of rows per page.
    viewOptions.getTextOptions().setMaxRowsPerPage(30);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result:

![Specify the number of rows per page](/viewer/java/images/rendering-basics/render-text-files/set-max-rows-per-page.png)
 
---

## Render text documents as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-text-files/

[GroupDocs.Viewer for Node.js](https://products.groupdocs.com/viewer/nodejs-java) allows you to convert text documents to HTML, PDF, PNG, and JPEG formats so you can view document content in a web browser, PDF or image viewer application.

To start with the GroupDocs.Viewer API, create a [Viewer](#) class instance. Pass a text document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](#) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/total" >}} {{< icon "gdoc_person" >}} View text files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported text file formats

GroupDocs.Viewer supports the following text and programming file formats:

* [.AS / .AS3 (ActionScript File)](https://docs.fileformat.com/programming/as/)
* [.ASM (Assembly Language Source Code File)](https://docs.fileformat.com/programming/asm/)
* [.BAT (DOS Batch File)](https://docs.fileformat.com/executable/bat/)
* [.C (C/C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CC (C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CMAKE (CMake File)](https://docs.fileformat.com/programming/cmake/)
* [.CPP (C++ Source Code File)](https://docs.fileformat.com/programming/cpp/)
* [.CS (C# Source Code File)](https://docs.fileformat.com/specification/programming/cs/)
* [.CSS (Cascading Style Sheet)](https://docs.fileformat.com/web/css/)
* [.CXX (C++ Source Code File)](https://docs.fileformat.com/programming/cxx/)
* [.DIFF (Patch File)](https://docs.fileformat.com/programming/diff/)
* [.ERB (Ruby ERB Script)](https://docs.fileformat.com/programming/erb/)
* [.GROOVY (Groovy Source Code File)](https://docs.fileformat.com/programming/groovy/)
* [.H (C/C++/Objective-C Header File)](https://docs.fileformat.com/programming/h/)
* [.HAML (Haml Source Code File)](https://docs.fileformat.com/programming/haml/)
* [.HH (C++ Header File)](https://docs.fileformat.com/programming/hh/)
* [.JAVA (Java Source Code File)](https://docs.fileformat.com/programming/nodejs-java/)
* [.JS (JavaScript File)](https://docs.fileformat.com/web/js/)
* [.JSON (JavaScript Object Notation File)](https://docs.fileformat.com/web/json/)
* [.LESS (LESS Style Sheet)](https://docs.fileformat.com/web/less/)
* [.LOG (Log File)](https://docs.fileformat.com/database/log/)
* [.M (Objective-C Implementation File)](https://docs.fileformat.com/programming/m/)
* [.MAKE (Xcode Makefile Script)](https://docs.fileformat.com/programming/make/)
* [.MD (Markdown Documentation File)](https://docs.fileformat.com/word-processing/md/)
* [.ML (ML Source Code File)](https://docs.fileformat.com/programming/ml/)
* [.MM (Objective-C++ Source File)](https://docs.fileformat.com/programming/mm/)
* [.PHP (PHP Source Code File)](https://docs.fileformat.com/programming/php/)
* [.PL (Perl Script)](https://docs.fileformat.com/programming/pl/)
* [.PROPERTIES (Java Properties File)](https://en.wikipedia.org/wiki/.properties)
* [.PY (Python Script)](https://docs.fileformat.com/programming/py/)
* [.RB (Ruby Source Code)](https://docs.fileformat.com/ebook/rb/)
* [.RST (reStructuredText File)](https://docs.fileformat.com/programming/rst/)
* [.SASS (Syntactically Awesome StyleSheets File)](https://docs.fileformat.com/web/sass/)
* [.SCALA (Scala Source Code File)](https://docs.fileformat.com/programming/scala/)
* [.SCM (Scheme Source Code File)](https://docs.fileformat.com/programming/scm/)
* [.SCRIPT (Generic Script File)](https://docs.fileformat.com/programming/script/)
* [.SH (Bash Shell Script)](https://docs.fileformat.com/programming/sh/)
* [.SML (Standard ML Source Code File)](https://en.wikipedia.org/wiki/Standard_ML)
* [.SQL (Structured Query Language Data File)](https://docs.fileformat.com/database/sql/)
* [.TXT (Plain Text File)](https://docs.fileformat.com/word-processing/txt/)
* [.VB (Visual Basic Source Code File)](https://docs.fileformat.com/specification/programming/vb/)
* [.VIM (Vim Settings File)](https://docs.fileformat.com/misc/vim/)
* [.XML (XML File)](https://docs.fileformat.com/web/xml/)
* [.YAML (YAML Document)](https://docs.fileformat.com/programming/yaml/)

When you load a text document from a file, you should explicitly specify their format. To do this, create a [LoadOptions](#) class instance and use the [FileType](#) method. Then pass this instance to the [Viewer](#) class constructor.

{{< tabs "render-text-file-with-loadoptions">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions, LoadOptions, FileType } from '@groupdocs/groupdocs.viewer';

// Specify the file encoding. 
const loadOptions = new LoadOptions(FileType.MD)
// Convert the document to PDF.
const viewer = new Viewer("TermsOfService.txt", loadOptions)
const viewOptions = PdfViewOptions("render-text-file-with-loadoptions/txt-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render text files as HTML

Create an [HtmlViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a text file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create HTML files with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.forEmbeddedResources](#) method and specify the output file name.

{{< tabs "render-text-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("TermsOfService.txt")
// Convert the text file to HTML.
// {0} is replaced with the current page number in the output file names.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-text-to-html-embedded/txt-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to HTML](/viewer/nodejs-java/images/rendering-basics/render-text-files/render-to-html-embedded-resources.png)

### Create HTML files with external resources

If you want to store output HTML files and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.forExternalResources](#) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-text-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("TermsOfService.txt")
// Create an HTML file for each PDF page.
// Specify the HTML file names and location of external resources.
// {0} and {1} are replaced with the current page number and resource name, respectively.
const viewOptions = HtmlViewOptions.forExternalResources("render-text-to-html-external/txt-to-html-page_{0}.html", "render-text-to-html-external/txt-to-html-page_{0}/resource_{0}_{1}", "render-text-to-html-external/txt-to-html-page_{0}/resource_{0}_{1}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-text-files/render-to-html-external-resources.png)

### Create a single HTML page

If you need to display the entire document content on a single HTML page, use the [HtmlViewOptions.setRenderToSinglePage](#) method, as shown below:

{{< tabs "render-text-to-single-html-page">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("TermsOfService.txt")
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-text-to-single-html-page/txt-to-html.html")
// Render the file to a single page. 
viewOptions.setRenderToSinglePage(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render text files as PDF

Create a [PdfViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a text file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-text-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("TermsOfService.txt")
// Convert the text file to PDF.
const viewOptions = PdfViewOptions("render-text-to-pdf/txt-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PDF](/viewer/nodejs-java/images/rendering-basics/render-text-files/render-to-pdf.png)

## Render text files as PNG

Create a [PngViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a text file to PNG. Use the [PngViewOptions.setHeight](#) and [PngViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-text-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("TermsOfService.txt")
// Convert the text file to PNG.
// {0} is replaced with the current page number in the output image names.
const viewOptions = PngViewOptions("render-text-to-png/txt-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PNG](/viewer/nodejs-java/images/rendering-basics/render-text-files/render-to-png-image.png)

## Render text files as JPEG

Create a [JpgViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert a text file to JPEG. Use the [JpgViewOptions.setHeight](#) and [JpgViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-text-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("TermsOfService.txt")
// Convert the text file to JPEG.
// {0} is replaced with the current page number in the output image names.
const viewOptions = JpgViewOptions("render-text-to-jpeg/txt-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [TextOptions](#) class that allows you to specify different options for rendering text files. To access these options, use the [setTextOptions](#) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](#) 
* [PdfViewOptions](#)
* [PngViewOptions](#)
* [JpgViewOptions](#)

The `TextOptions` class supports the following methods:

* [setMaxRowsPerPage](#)---Specifies the maximum number of rows per page. The default value is **55**.

* [setMaxCharsPerRow](#)---Specifies the maximum number of characters per row. The default value is **85**.

The following example demonstrates how to change the number of rows displayed on each HTML page:

{{< tabs "render-text-with-max-rows-per-page">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("TermsOfService.txt")
 // Convert the text file to HTML.
// {0} is replaced with the current page number in the output file names.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-text-with-max-rows-per-page/txt-to-html-page_{0}.html")
// Set the maximum number of rows per page.
viewOptions.getTextOptions().setMaxRowsPerPage(30)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "TermsOfService.txt" >}}
{{< tab-text >}}
`TermsOfService.txt` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-text-files/TermsOfService.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result:

![Specify the number of rows per page](/viewer/nodejs-java/images/rendering-basics/render-text-files/set-max-rows-per-page.png)
 
---

## Render text documents as HTML, PDF, and image files

Path: /viewer/python-net/render-text-files/

[GroupDocs.Viewer for Python](https://products.groupdocs.com/viewer/python-net) allows you to convert text documents to HTML, PDF, PNG, and JPEG formats so you can view document content in a web browser, PDF or image viewer application.

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/) class instance. Pass a text document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/total" >}} {{< icon "gdoc_person" >}} View text files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported text file formats

GroupDocs.Viewer supports the following text and programming file formats:

* [.AS / .AS3 (ActionScript File)](https://docs.fileformat.com/programming/as/)
* [.ASM (Assembly Language Source Code File)](https://docs.fileformat.com/programming/asm/)
* [.BAT (DOS Batch File)](https://docs.fileformat.com/executable/bat/)
* [.C (C/C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CC (C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CMAKE (CMake File)](https://docs.fileformat.com/programming/cmake/)
* [.CPP (C++ Source Code File)](https://docs.fileformat.com/programming/cpp/)
* [.CS (C# Source Code File)](https://docs.fileformat.com/specification/programming/cs/)
* [.CSS (Cascading Style Sheet)](https://docs.fileformat.com/web/css/)
* [.CXX (C++ Source Code File)](https://docs.fileformat.com/programming/cxx/)
* [.DIFF (Patch File)](https://docs.fileformat.com/programming/diff/)
* [.ERB (Ruby ERB Script)](https://docs.fileformat.com/programming/erb/)
* [.GROOVY (Groovy Source Code File)](https://docs.fileformat.com/programming/groovy/)
* [.H (C/C++/Objective-C Header File)](https://docs.fileformat.com/programming/h/)
* [.HAML (Haml Source Code File)](https://docs.fileformat.com/programming/haml/)
* [.HH (C++ Header File)](https://docs.fileformat.com/programming/hh/)
* [.JAVA (Java Source Code File)](https://docs.fileformat.com/programming/python-net/)
* [.JS (JavaScript File)](https://docs.fileformat.com/web/js/)
* [.JSON (JavaScript Object Notation File)](https://docs.fileformat.com/web/json/)
* [.LESS (LESS Style Sheet)](https://docs.fileformat.com/web/less/)
* [.LOG (Log File)](https://docs.fileformat.com/database/log/)
* [.M (Objective-C Implementation File)](https://docs.fileformat.com/programming/m/)
* [.MAKE (Xcode Makefile Script)](https://docs.fileformat.com/programming/make/)
* [.MD (Markdown Documentation File)](https://docs.fileformat.com/word-processing/md/)
* [.ML (ML Source Code File)](https://docs.fileformat.com/programming/ml/)
* [.MM (Objective-C++ Source File)](https://docs.fileformat.com/programming/mm/)
* [.PHP (PHP Source Code File)](https://docs.fileformat.com/programming/php/)
* [.PL (Perl Script)](https://docs.fileformat.com/programming/pl/)
* [.PROPERTIES (Java Properties File)](https://en.wikipedia.org/wiki/.properties)
* [.PY (Python Script)](https://docs.fileformat.com/programming/py/)
* [.RB (Ruby Source Code)](https://docs.fileformat.com/ebook/rb/)
* [.RST (reStructuredText File)](https://docs.fileformat.com/programming/rst/)
* [.SASS (Syntactically Awesome StyleSheets File)](https://docs.fileformat.com/web/sass/)
* [.SCALA (Scala Source Code File)](https://docs.fileformat.com/programming/scala/)
* [.SCM (Scheme Source Code File)](https://docs.fileformat.com/programming/scm/)
* [.SCRIPT (Generic Script File)](https://docs.fileformat.com/programming/script/)
* [.SH (Bash Shell Script)](https://docs.fileformat.com/programming/sh/)
* [.SML (Standard ML Source Code File)](https://en.wikipedia.org/wiki/Standard_ML)
* [.SQL (Structured Query Language Data File)](https://docs.fileformat.com/database/sql/)
* [.TXT (Plain Text File)](https://docs.fileformat.com/word-processing/txt/)
* [.VB (Visual Basic Source Code File)](https://docs.fileformat.com/specification/programming/vb/)
* [.VIM (Vim Settings File)](https://docs.fileformat.com/misc/vim/)
* [.XML (XML File)](https://docs.fileformat.com/web/xml/)
* [.YAML (YAML Document)](https://docs.fileformat.com/programming/yaml/)

When you load a text document from a file, you should explicitly specify their format. To do this, create a [LoadOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/loadoptions/) class instance and use the [FileType](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/filetype/) method. Then pass this instance to the [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/) class constructor.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer, FileType
from groupdocs.viewer.options import LoadOptions, PdfViewOptions

def render_text_with_load_options():
    # Specify the file encoding. 
    load_options = LoadOptions(FileType.MD)
    # Convert the document to PDF.
    with Viewer("terms_of_service.txt", load_options) as viewer:
        viewOptions = PdfViewOptions("render_text_with_load_options/text_with_load_options.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_text_with_load_options()
```
{{< /tab >}}
{{< tab "terms_of_service.txt" >}}
{{< tab-text >}}
`terms_of_service.txt` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-text-files/terms_of_service.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render text files as HTML

Create an [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a text file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create HTML files with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_text_to_html():
    # Load text file
    with Viewer("terms_of_service.txt") as viewer:
        # Convert the text file to HTML.
        # {0} is replaced with the current page number in the output file names.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_text_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_text_to_html()
```
{{< /tab >}}
{{< tab "terms_of_service.txt" >}}
{{< tab-text >}}
`terms_of_service.txt` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-text-files/terms_of_service.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to HTML](/viewer/python-net/images/rendering-basics/render-text-files/render-to-html-embedded-resources.png)

### Create HTML files with external resources

If you want to store output HTML files and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_text_to_html_external():
    # Load text file
    with Viewer("terms_of_service.txt") as viewer:
        # Create an HTML file for each page.
        # Specify the HTML file names and location of external resources.
        # {0} and {1} are replaced with the current page number and resource name, respectively.
        viewOptions = HtmlViewOptions.for_external_resources("render_text_to_html_external/pdf_page_{0}.html", "render_text_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_text_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_text_to_html_external()
```
{{< /tab >}}
{{< tab "terms_of_service.txt" >}}
{{< tab-text >}}
`terms_of_service.txt` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-text-files/terms_of_service.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-text-files/render-to-html-external-resources.png)

### Create a single HTML page

If you need to display the entire document content on a single HTML page, use the [HtmlViewOptions.setRenderToSinglePage](#) method, as shown below:

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_text_to_single_html():
    # Load text file
    with Viewer("terms_of_service.txt") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_text_to_single_html/text_to_single_html.html")
        # Render the file to a single page. 
        viewOptions.render_to_single_page = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_text_to_single_html()
```
{{< /tab >}}
{{< tab "terms_of_service.txt" >}}
{{< tab-text >}}
`terms_of_service.txt` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-text-files/terms_of_service.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render text files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a text file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_text_to_pdf():
    # Load text file
    with Viewer("terms_of_service.txt") as viewer:
        # Convert the text file to PDF.
        viewOptions = PdfViewOptions("render_text_to_pdf/text_document.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_text_to_pdf()
```
{{< /tab >}}
{{< tab "terms_of_service.txt" >}}
{{< tab-text >}}
`terms_of_service.txt` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-text-files/terms_of_service.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PDF](/viewer/python-net/images/rendering-basics/render-text-files/render-to-pdf.png)

## Render text files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a text file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_text_to_png():
    # Load text file
    with Viewer("terms_of_service.txt") as viewer:
        # Convert the text file to PNG.
        # {0} is replaced with the current page number in the output image names.
        viewOptions = PngViewOptions("render_text_to_png/text_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 550
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_text_to_png()
```
{{< /tab >}}
{{< tab "terms_of_service.txt" >}}
{{< tab-text >}}
`terms_of_service.txt` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-text-files/terms_of_service.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PNG](/viewer/python-net/images/rendering-basics/render-text-files/render-to-png-image.png)

## Render text files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert a text file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_text_to_jpg():
    # Load text file
    with Viewer("terms_of_service.txt") as viewer:
        # Convert the text file to JPEG.
        # {0} is replaced with the current page number in the output image names.
        viewOptions = JpgViewOptions("render_text_to_jpg/text_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 550
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_text_to_jpg()
```
{{< /tab >}}
{{< tab "terms_of_service.txt" >}}
{{< tab-text >}}
`terms_of_service.txt` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-text-files/terms_of_service.txt) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Render XML documents as HTML, PDF, PNG, and JPEG files

Path: /viewer/java/render-xml-documents/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) started to support XML format a long time ago, but XML documents were treated as plain text, and thus it was not as useful as it might be. Starting from [version 24.12](https://releases.groupdocs.com/viewer/java/release-notes/2024/groupdocs-viewer-for-java-24-12-release-notes/#new-xml-converter), the completely new XML processing module was implemented, and now XML documents are processed differently, not as plain text documents. This article explains this new XML processing module.

## Opening the XML document

First of all need to emphasize that the new XML processing module had not touched the public API at all — no new options, classes, properties or methods were added or modified. In order to process input XML document properly using the new XML processing module, need to either specify the [`LoadOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/) class instance with [`FileType.XML`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/filetype/#XML) in its [constructor](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/#LoadOptions-com.groupdocs.viewer.FileType-) or just pass the XML document as filename with `*.xml` extension. Code example below shows all possible ways:

{{< tabs "Loading example">}}
{{< tab "Java" >}}
```java
// 1. Specify by filename
String inputXmlDocument = "Sample.xml";
try (Viewer viewer = new Viewer(inputXmlDocument)) {
    // do some work...
}

// 2. Specify by filename and FileStream
String inputXmlPath = "path/Sample.xml";
try (FileInputStream inputXmlFileStream = new FileInputStream(inputXmlPath);
    Viewer viewer = new Viewer(inputXmlFileStream)) {
    // do some work...
}

// 3. Specify by load options
// fill ByteArrayOutputStream with content of XML document
LoadOptions loadOptions = new LoadOptions(FileType.XML);
try (Viewer viewer = new Viewer(new ByteArrayInputStream(xmlContent.toByteArray()), loadOptions)) {
    // do some work...
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kitlin
// 1. Specify by filename
val inputXmlDocument = "Sample.xml"
Viewer(inputXmlDocument).use { viewer ->
    // do some work...
}

// 2. Specify by filename and FileStream
val inputXmlPath = "path/Sample.xml"
FileInputStream(inputXmlPath).use { inputXmlFileStream ->
    Viewer(inputXmlFileStream).use { viewer ->
        // do some work...
    }
}

// 3. Specify by load options
// fill ByteArrayOutputStream with content of XML document
val loadOptions = LoadOptions(FileType.XML)
ByteArrayInputStream(xmlContent.toByteArray()).use { inputStream ->
    Viewer(inputStream, loadOptions).use { viewer ->
        // do some work...
    }
}
```
{{< /tab >}}
{{< /tabs >}}


If the instance of the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class is initialized using one of the ways described above, the new XML processing module will be used.

By default, all XML documents must have an [XML declaration](https://developer.mozilla.org/en-US/docs/Web/XML/XML_introduction#xml_declaration), which is located in the very beginning of the XML document and which stores the encoding of the consecutive content, for example: 

`<?xml version="1.1" encoding="UTF-8" ?>`

By default, GroupDocs.Viewer uses it. But there is a possibility to override this character encoding, if needed. In order to do this the [`loadOptions.setCharset(...)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/#setCharset-java.nio.charset.Charset-) property should be set while initializing the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class, as it is shown below:

{{< tabs "Custom encoding example">}}
{{< tab "Java" >}}
```java
LoadOptions loadOpts = new LoadOptions(FileType.XML);
loadOpts.setCharset(java.nio.charset.StandardCharsets.US_ASCII);
try (Viewer viewer = new Viewer(new ByteArrayInputStream(xmlContent.getBytes(java.nio.charset.StandardCharsets.US_ASCII)), loadOpts)) {
    // do some work...
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
val loadOpts = LoadOptions(FileType.XML)
loadOpts.charset = Charsets.US_ASCII
Viewer(ByteArrayInputStream(xmlContent.toByteArray(Charsets.US_ASCII)), loadOpts).use { viewer ->
    // do some work...
}
```
{{< /tab >}}
{{< /tabs >}}


The rest of this article explains features of this new XML processing module.

### XML detection

All XML documents with no exceptions may be threatened (interpreted) as the plain text documents (TXT). GroupDocs.Viewer allows for users to explicitly specify the format of the loaded document with the [`LoadOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/) class and its [`FileType`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/filetype/) property. But when the [`LoadOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/) instance is not specified in the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) constructor, the GroupDocs.Viewer tries to detect the format of the loaded document automatically. First of all, the GroupDocs.Viewer tries to recognize the extension of the file name, if the document is specified by the file path or [`InputStream`](https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html). And if the extension is recognized, the loaded document will be processed according to it.

This algorithm also has a drawback — if the file extension is incorrect, for example, the loaded file is actually of the PDF format, but has an extension “.docx”, its processing will be failed and exception will be thrown. In the context of document processing all is even more complicated, because the current XML processor can successfully handle pure plain text files without even a single XML tag inside. But this is highly inefficient — the resultant quality with such plain text documents, processed as XML by the XML processor, will be the same as processed by the text processor, but the performance will be significantly worse.

Starting from the [version 25.9](https://releases.groupdocs.com/viewer/java/release-notes/2025/groupdocs-viewer-for-java-25-9-release-notes/), if the document is loaded to the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) instance by file path or [`InputStream`](https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html), and no [`LoadOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/loadoptions/) with [`FileType`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/filetype/) is specified, and the extension is “.xml”, the GroupDocs.Viewer additionally checks whether the loaded document is a truly XML. If yes, it will be processed as XML, but if it does not contain even a single XML tag, it will be processed as a plain text.

## Representation

The main task of the new XML processing module is to represent the XML markup, obtained from the user, in a structured, formatted, hierarchical view, with highlighting of every distinct entity of this XML structure. For the GroupDocs.Viewer there is no matter how human-friendly is represented the XML markup in original document: it may be divided by line breaks onto separate lines per every element, or the whole document may be stored in a single line of text; it may have indents or not, — all of this does not matter. The GroupDocs.Viewer parses the input XML document and creates a hierarchical Document Object Model (DOM), and then serializes it to the HTML, PDF, PNG or JPEG depending on user options.

In particular, when serializing, GroupDocs.Viewer puts every XML element (node) on a new line, and with left indent, which indicates nesting of a certain element. Every entity of the XML document, — XML element, attribute, its value, text node, XML comment, CDATA section, — has its own highlighting: font style, type, color, size and so on. All quotes, used for unquoting the attribute values, are unified.

The screenshot below shows such scenario. On the left side there is a [sample XML document](/viewer/java/sample-files/render-xml-documents/books-single-line.xml), where all content is stored within a single line, with no indents, line breaks, horizontal tabs, or even extra whitespaces. On the right side the resultant HTML file, generated by the GroupDocs.Viewer, is shown. There can be seen structured view with correct line breaks and indents, valid highlighting of every XML entity, and recognition of the URIs and email addresses.

![Generate HTML view for input XML](/viewer/java/images/rendering-basics/render-xml-documents/XML-to-HTML.png)

## Fix incorrect XML structure

The World Wide Web Consortium has clearly defined what is a valid XML document, and what is not. The term “[well-formed document](https://developer.mozilla.org/en-US/docs/Web/XML/XML_introduction#correct_xml_valid_and_well-formed)” defines a those XML document, which "adheres to the syntax rules specified by the XML 1.0 specification in that it must satisfy both physical and logical structures"([ref](http://www.csdservices.com/articles/csdservices)). In particular, a valid XML document must contain only valid characters, its start tags and end tags must be matched, correctly opened and closed, elements must be properly nested, and so on. Unfortunately, not all existing XML documents are well-formed and sometimes there is a necessity to view them. Different XML markup viewers often are unable to properly show invalid XML documents.

GroupDocs.Viewer with its new XML processing module is able to correctly parse, process, format, highlight and view even the heavily distorted XML documents. There is partial list of different damages in XML structure, which GroupDocs.Viewer can fix and process:

- Invalid and illegal characters, including `<` and `&` characters in wrong places.
- Start tags, which are not closed.
- End tags, which are not opened.
- Interleaved (overlapped) tags.
- Start and end tags with unmatched letter cases.
- Truncated (cut from end) markup.
- Attribute names without values.
- Unquoted attribute values (without enclosing quotes).
- Attribute values, which are unquoted partially, with only opening or only closing quote.
- Attribute values, which have redundant quote inside.

GroupDocs.Viewer detects and fixes all these and even more issues in XML markup and also writes them to the log.

Screenshot below demonstrates this in action. [Sample XML file "InvalidXml.xml"](/viewer/java/sample-files/render-xml-documents/InvalidXml.xml) contains all possible damages, described above. In cannot be correctly formatted and highlighted by most popular XML viewing and editing applications. But with the new XML processing module the GroupDocs.Viewer fixes its structure and displays it absolutely correct.

![Generate HTML view for input XML](/viewer/java/images/rendering-basics/render-xml-documents/XML-fixed.png)

## Recognition of URIs and email addresses

While processing the XML markup, the GroupDocs.Viewer scans the XML content for any valid URI, if found, represents them as external links in the resultant HTML format: by using the [A element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a). GroupDocs.Viewer is searching for URIs in: text nodes, CDATA sections, XML comments, attribute values, DocType definitions.

Regarding the email addresses, the GroupDocs.Viewer searches them only in attribute values, and if found, represents them with [mailto](https://en.wikipedia.org/wiki/Mailto) scheme and [A element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a).

If the XML document is saved not to the HTML format, but to the PDF, the URIs and email addresses will be interactive too. But if the output format is PNG or JPEG, the output will be a raster image without any interactive links, of course.

## Saving to HTML format

For saving the documents to the HTML format the GroupDocs.Viewer provides a [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class. There are two ways of creating an instance of this class: using either [`forExternalResources`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) or [`forEmbeddedResources`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) static methods. First method is designed for saving HTML document in a such way, that all its resources (stylesheets, images, fonts etc) are stored separately, while second method stores all resources of the HTML document inside its content: stylesheets are saved inside the STYLE elements, SVG graphics is inlined inside HTML markup, while all other resources (mostly raster images and fonts) are stored according to the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme) and converted to the [base64](https://en.wikipedia.org/wiki/Base64) format.

But in the context of the XML documents the way of creating the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) instance is not important, because the XML documents cannot have resources, which may be stored externally or embedded. So, when saving XML documents to the HTML, you can create the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) instance in both ways — the result will be the same, no external resources will be produced.

Another important thing is that the XML format by its nature has no pages — it is a hierarchical structure, where some elements are nested inside another, and there is no even similar to pages here. So the best way to represent them in HTML format is to generate a single-page HTML document, so all XML content will be represented in a single HTML document. In order to do this the option [`htmlViewOptions.setRenderToSinglePage(...)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setRenderToSinglePage-boolean-) needs to be set up to the true value. By default, this option has a false value, so the output HTML document will be paginated — split into multiple chunks.

Code example below shows rendering of input XML file to the HTML in both ways:

{{< tabs "Saving to HTML example">}}
{{< tab "Java" >}}
```java
HtmlViewOptions paginatedHtmlOptions = HtmlViewOptions.forEmbeddedResources("page-{0}.html");
HtmlViewOptions singleHtmlOptions = HtmlViewOptions.forEmbeddedResources("single-page.html");
singleHtmlOptions.setRenderToSinglePage(true);

String inputXmlDocument = "Sample.xml";

try (Viewer viewer = new Viewer(inputXmlDocument)) {
    viewer.view(paginatedHtmlOptions);
    viewer.view(singleHtmlOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
val paginatedHtmlOptions = HtmlViewOptions.forEmbeddedResources("page-{0}.html")
val singleHtmlOptions = HtmlViewOptions.forEmbeddedResources("single-page.html").apply {
    isRenderToSinglePage = true
}

val inputXmlDocument = "Sample.xml"
Viewer(inputXmlDocument).use { viewer ->
    viewer.view(paginatedHtmlOptions)
    viewer.view(singleHtmlOptions)
}
```
{{< /tab >}}
{{< /tabs >}}

All other options, which are present in the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/) class, have no effect when saving XML to HTML, except the [`setRenderToSinglePage(...)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#setRenderToSinglePage-boolean-) flag.

## Saving to PDF format

PDF format by its nature has pages, so if the XML content because of its big size cannot fit in the single PDF page, then it will be paginated. Unlike the HTML, PNG, or JPEG, the GroupDocs.Viewer generates only a single PDF file for a single input XML document, with one or more pages. [`PdfViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) class is responsible for saving XML to the PDF, and example below shows this:

{{< tabs "Saving to PDF example">}}
{{< tab "Java" >}}
```java
PdfViewOptions pdfOptions = new PdfViewOptions("output.pdf");
String inputXmlDocument = "Sample.xml";
try (Viewer viewer = new Viewer(inputXmlDocument)) {
    viewer.view(pdfOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
val pdfOptions = PdfViewOptions("output.pdf")
val inputXmlDocument = "Sample.xml"
Viewer(inputXmlDocument).use { viewer ->
    viewer.view(pdfOptions)
}
```
{{< /tab >}}
{{< /tabs >}}

As for the version 24.12 all options, which are present in the [`PdfViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions/) class, have no effect when saving XML to PDF.

## Saving to raster PNG and JPEG formats

[`PngViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) and [`JpgViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) are responsible for saving XML to the PNG and JPEG raster image formats. Like for the PDF, if XML content cannot fit into the area of one image, it will be paginated and spread across multiple images.

Size of the output images will be calculated automatically based on the XML content, as for the version 24.12 there is no possibility to set the size forcibly, and `setWidth(...)`, `setHeight(...)`, `setMaxWidth(...)`, and `setMaxHeight(...)` properties of the [`PngViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) and [`JpgViewOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) classes have no effect when saving XML to PNG or JPEG.

There is a possibility to set a quality of output JPEG image by setting a [`jpgViewOptions.setQuality(...)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setQuality-byte-) instance property, which has a default value `90`.

Example below shows saving input XML to the output PNG and JPEG:

{{< tabs "Saving to PNG and JPEG example">}}
{{< tab "Java" >}}
```java
PngViewOptions pngOptions = new PngViewOptions("page-{0}.png");
JpgViewOptions jpegOptions = new JpgViewOptions("page-{0}.jpeg");
jpegOptions.setQuality((byte) 80); // setting output JPEG quality explicitly

String inputXmlDocument = "Sample.xml";
try (Viewer viewer = new Viewer(inputXmlDocument)) {
    viewer.view(pngOptions);
    viewer.view(jpegOptions);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kitlin
val pngOptions = PngViewOptions("page-{0}.png")
val jpegOptions = JpgViewOptions("page-{0}.jpeg").apply {
    quality = 80
}

val inputXmlDocument = "Sample.xml"
Viewer(inputXmlDocument).use { viewer ->
    viewer.view(pngOptions)
    viewer.view(jpegOptions)
}
```
{{< /tab >}}
{{< /tabs >}}

## Retrieving information about XML view

Like for all other supported formats, GroupDocs.Viewer supports returning information about specific XML documents. Like for all other formats, for doing this you need to call the [`getViewInfo(...)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) instance method of the [`Viewer`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) class, which returns an instance of [`ViewInfo`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/) class. This [`ViewInfo`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/) instance contains all information about the view depending on [`ViewInfoOptions`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions/), passed to the [`getViewInfo(...)`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method.

Example below shows obtaining [`ViewInfo`](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/viewinfo/) for a single XML document for HTML, PDF, and PNG formats.

{{< tabs "Retrieving information about XML view example">}}
{{< tab "Java" >}}
```java
ViewInfoOptions viewInfoOptionsHtmlSingle = ViewInfoOptions.forHtmlView(true);
ViewInfoOptions viewInfoOptionsPdf = ViewInfoOptions.forPdfView();
ViewInfoOptions viewInfoOptionsPng = ViewInfoOptions.forPngView();

String inputXmlDocument = "Sample.xml";

try (Viewer viewer = new Viewer(inputXmlDocument)) {
    ViewInfo resultHtmlSingle = viewer.getViewInfo(viewInfoOptionsHtmlSingle);
    ViewInfo resultPdf = viewer.getViewInfo(viewInfoOptionsPdf);
    ViewInfo resultPng = viewer.getViewInfo(viewInfoOptionsPng);
}
```
{{< /tab >}}
{{< tab "Kotlin">}}
```kotlin
val viewInfoOptionsHtmlSingle = ViewInfoOptions.forHtmlView(true)
val viewInfoOptionsPdf = ViewInfoOptions.forPdfView()
val viewInfoOptionsPng = ViewInfoOptions.forPngView()

val inputXmlDocument = "Sample.xml"

Viewer(inputXmlDocument).use { viewer ->
    val resultHtmlSingle = viewer.getViewInfo(viewInfoOptionsHtmlSingle)
    val resultPdf = viewer.getViewInfo(viewInfoOptionsPdf)
    val resultPng = viewer.getViewInfo(viewInfoOptionsPng)
}
```
{{< /tab >}}
{{< /tabs >}}

## Conclusion

Before the release of the [version 24.12](https://releases.groupdocs.com/viewer/java/release-notes/2024/groupdocs-viewer-for-java-24-12-release-notes/#new-xml-converter) the XML format was supported by the GroupDocs.Viewer, but XML files were treated as the plain text, without any XML-specific features like structure formatting, highlighting, proper pagination, and so on.

Starting from the version 24.12, the new dedicated XML processing module makes XML support to be a truly powerful and useful feature, and ability to fix and display even the heavily corrupted XML documents allows to use the GroupDocs.Viewer for viewing XML documents in those cases, when all other competitors failed.












---

## Render XML documents as HTML, PDF, PNG, and JPEG files

Path: /viewer/net/render-xml-documents/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) started to support XML format a long time ago, but XML documents were treated as plain text, and thus it was not as useful as it might be. Starting from [version 24.8](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-8-release-notes/#new-xml-converter), the completely new XML processing module was implemented, and now XML documents are processed differently, not as plain text documents. This article explains this new XML processing module.

## Opening the XML document

First of all need to emphasize that the new XML processing module had not touched the public API at all — no new options, classes, properties or methods were added or modified. In order to process input XML document properly using the new XML processing module, need to either specify the [`LoadOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/) class instance with [`FileType.XML`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype/xml/) in its [constructor](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/loadoptions/#constructor_1) or just pass the XML document as filename with `*.xml` extension. Code example below shows all possible ways:

{{< tabs "Loading example">}}
{{< tab "C#" >}}
```csharp
// 1. Specify by filename
string inputXmlDocument = "Sample.xml";
using (Viewer viewer = new Viewer(inputXmlDocument))
{
    // do some work...
}

//2. Specify by filename and FileStream
string inputXmlPath = "path/Sample.xml";
using (FileStream inputXmlFileStream = File.OpenRead(inputXmlPath))
using (Viewer viewer = new Viewer(inputXmlFileStream))
{
    // do some work...
}

// 3. Specify by load options
MemoryStream xmlContent = new MemoryStream();
// fill MemoryStream with content of XML document
GroupDocs.Viewer.Options.LoadOptions loadOptions = new LoadOptions(FileType.XML);
using (Viewer viewer = new Viewer(xmlContent, loadOptions))
{
    // do some work...
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
' 1. Specify by filename
Dim inputXmlDocument As String = "Sample.xml"
Using viewer As New Viewer(inputXmlDocument)
    'do some work...
End Using

' 2. Specify by filename and FileStream
Dim inputXmlPath As String = "path/Sample.xml"
Using inputXmlFileStream As FileStream = File.OpenRead(inputXmlPath),
    viewer As New Viewer(inputXmlFileStream)
    'do some work...
End Using

' 3. Specify by load options
Dim xmlContent As MemoryStream = New MemoryStream
' fill MemoryStream with content of XML document
Dim loadOptions As GroupDocs.Viewer.Options.LoadOptions = New LoadOptions(FileType.XML)
Using viewer As New Viewer(xmlContent, loadOptions)
    'do some work...
End Using
```
{{< /tab >}}
{{< /tabs >}}


If the instance of the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/) class is initialized using one of the ways described above, the new XML processing module will be used.

By default all XML documents must have an [XML declaration](https://developer.mozilla.org/en-US/docs/Web/XML/XML_introduction#xml_declaration), which is located in the very beginning of the XML document and which stores the encoding of the consecutive content, for example: 

`<?xml version="1.1" encoding="UTF-8" ?>`

By default GroupDocs.Viewer uses it. But there is a possibility to override this character encoding, if needed. In order to do this the [`LoadOptions.Encoding`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/encoding/) property should be set while initializing the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/) class, as it is shown below:

{{< tabs "Custom encoding example">}}
{{< tab "C#" >}}
```csharp
LoadOptions loadOpts = new LoadOptions(FileType.XML);
loadOpts.Encoding = System.Text.Encoding.ASCII;
using (Viewer viewer = new Viewer(xmlContent, loadOpts))
{
    // do some work...
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim loadOpts As LoadOptions = New LoadOptions(FileType.XML)
loadOpts.Encoding = System.Text.Encoding.ASCII
Using viewer As New Viewer(xmlContent, loadOpts)
    'do some work...
End Using
```
{{< /tab >}}
{{< /tabs >}}


The rest of this article explains features of this new XML processing module.

### XML detection

All XML documents with no exceptions may be threatened (interpreted) as the plain text documents (TXT). GroupDocs.Viewer allows for users to explicitly specify the format of the loaded document with the [`LoadOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/) class and its [`FileType`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/filetype/) property. But when the [`LoadOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/) instance is not specified in the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) constructor, the GroupDocs.Viewer tries to detect the format of the loaded document automatically. First of all, the GroupDocs.Viewer tries to recognize the extension of the file name, if the document is specified by the file path or [`FileStream`](https://learn.microsoft.com/en-us/dotnet/api/system.io.filestream). And if the extension is recognized, the loaded document will be processed according to it.

This algorithm also has a drawback — if the file extension is incorrect, for example, the loaded file is actually of the PDF format, but has an extension “.docx”, its processing will be failed and exception will be thrown. In the context of document processing all is even more complicated, because the current XML processor can successfully handle pure plain text files without even a single XML tag inside. But this is highly inefficient — the resultant quality with such plain text documents, processed as XML by the XML processor, will be the same as processed by the text processor, but the performance will be significantly worse.

Starting from the [version 25.3](https://releases.groupdocs.com/viewer/net/release-notes/2025/groupdocs-viewer-for-net-25-3-release-notes/), if the document is loaded to the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) instance by file path or [`FileStream`](https://learn.microsoft.com/en-us/dotnet/api/system.io.filestream), and no [`LoadOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/) with [`FileType`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions/filetype/) is specified, and the extension is “.xml”, the GroupDocs.Viewer additionally checks whether the loaded document is a truly XML. If yes, it will be processed as XML, but if it does not contain even a single XML tag, it will be processed as a plain text.

## Representation

The main task of the new XML processing module is to represent the XML markup, obtained from the user, in a structured, formatted, hierarchical view, with highlighting of every distinct entity of this XML structure. For the GroupDocs.Viewer there is no matter how human-friendly is represented the XML markup in original document: it may be divided by line breaks onto separate lines per every element, or the whole document may be stored in a single line of text; it may have indents or not, — all of this does not matter. The GroupDocs.Viewer parses the input XML document and creates a hierarchical Document Object Model (DOM), and then serializes it to the HTML, PDF, PNG or JPEG depending on user options.

In particular, when serializing, GroupDocs.Viewer puts every XML element (node) on a new line, and with left indent, which indicates nesting of a certain element. Every entity of the XML document, — XML element, attribute, its value, text node, XML comment, CDATA section, — has its own highlighting: font style, type, color, size and so on. All quotes, used for enquoting the attribute values, are unified.

The screenshot below shows such scenario. On the left side there is a [sample XML document](/viewer/net/sample-files/render-xml-documents/books-single-line.xml), where all content is stored within a single line, with no indents, line breaks, horizontal tabs, or even extra whitespaces. On the right side the resultant HTML file, generated by the GroupDocs.Viewer, is shown. There can be seen structured view with corrent line breaks and indents, valid highlighting of every XML entity, and recognition of the URIs and email addresses.

![Generate HTML view for input XML](/viewer/net/images/rendering-basics/render-xml-documents/XML-to-HTML.png)

## Fix incorrect XML structure

The World Wide Web Consortium has clearly defined what is a valid XML document, and what is not. The term “[well-formed document](https://developer.mozilla.org/en-US/docs/Web/XML/XML_introduction#correct_xml_valid_and_well-formed)” defines a those XML document, which "adheres to the syntax rules specified by the XML 1.0 specification in that it must satisfy both physical and logical structures"([ref](http://www.csdservices.com/articles/csdservices)). In particular, a valid XML document must contain only valid characters, its start tags and end tags must be matched, correctly opened and closed, elements must be properly nested, and so on. Unfortunately, not all existing XML documents are well-formed and sometimes there is a necessity to view them. Different XML markup viewers often are unable to properly show invalid XML documents.

GroupDocs.Viewer with its new XML processing module is able to correctly parse, process, format, highlight and view even the heavily distorted XML documents. There is partial list of different damages in XML structure, which GroupDocs.Viewer can fix and process:

- Invalid and illegal characters, including `<` and `&` characters in wrong places.
- Start tags, which are not closed.
- End tags, which are not opened.
- Interleaved (overlapped) tags.
- Start and end tags with unmatched letter cases.
- Truncated (cutted from end) markup.
- Attribute names without values.
- Un-enquoted attribute values (without enclosing quotes).
- Attribute values, which are enquoted partially, with only opening or only closing quote.
- Attribute values, which have redundant quote inside.

GroupDocs.Viewer detects and fixes all these and even more issues in XML markup and also writes them to the log.

Screenshot below demonstrates this in action. [Sample XML file "InvalidXml.xml"](/viewer/net/sample-files/render-xml-documents/InvalidXml.xml) contains all possible damages, described above. In cannot be correctly formatted and highlighted by most popular XML viewing and editing applications. But with the new XML processing module the GroupDocs.Viewer fixes its structure and displays it absolutely correct.

![Generate HTML view for input XML](/viewer/net/images/rendering-basics/render-xml-documents/XML-fixed.png)

## Recognition of URIs and email addresses

While processing the XML markup, the GroupDocs.Viewer scans the XML content for any valid URI, if found, represents them as external links in the resultant HTML format: by using the [A element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a). GroupDocs.Viewer is searching for URIs in: text nodes, CDATA sections, XML comments, attribute values, DocType definitions.

Regarding the email addresses, the GroupDocs.Viewer searches them only in attribute values, and if found, represents them with [mailto](https://en.wikipedia.org/wiki/Mailto) scheme and [A element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a).

If the XML document is saved not to the HTML format, but to the PDF, the URIs and email addresses will be interactive too. But if the output format is PNG or JPEG, the output will be a raster image without any interactive links, of course.

## Saving to HTML format

For saving the documents to the HTML format the GroupDocs.Viewer provides a [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) class. There are two ways of creating an instance of this class: using either [`ForExternalResources`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/forexternalresources/#forexternalresources) or [`ForEmbeddedResources`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/forembeddedresources/#forembeddedresources) static methods. First method is designed for saving HTML document in a such way, that all its resources (stylesheets, images, fonts etc) are stored separately, while second method stores all resources of the HTML document inside its content: stylesheets are saved inside the STYLE elements, SVG graphics is inlined inside HTML markup, while all other resources (mostly raster images and fonts) are stored according to the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme) and converted to the [base64](https://en.wikipedia.org/wiki/Base64) format.

But in the context of the XML documents the way of creating the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) instance is not important, because the XML documents cannot have resources, which may be stored externally or embedded. So, when saving XML documents to the HTML, you can create the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) instance in both ways — the result will be the same, no external resources will be produced.

Another important thing is that the XML format by its nature has no pages — it is a hierarchical structure, where some elements are nested inside another, and there is no even similar to pages here. So the best way to represent them in HTML format is to generate a single-page HTML document, so all XML content will be represented in a single HTML document. In order to do this the option [`HtmlViewOptions.RenderToSinglePage`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/rendertosinglepage/) needs to be set up to the true value. By default this option has a false value, so the output HTML document will be paginated — splitted into multiple chunks.

Code example below shows rendering of input XML file to the HTML in both ways:

{{< tabs "Saving to HTML example">}}
{{< tab "C#" >}}
```csharp
HtmlViewOptions paginatedHtmlOptions = HtmlViewOptions.ForEmbeddedResources("page-{0}.html");
HtmlViewOptions singleHtmlOptions = HtmlViewOptions.ForEmbeddedResources("single-page.html");
singleHtmlOptions.RenderToSinglePage = true;

string inputXmlDocument = "Sample.xml";
using (Viewer viewer = new Viewer(inputXmlDocument))
{
    viewer.View(paginatedHtmlOptions);
    viewer.View(singleHtmlOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim paginatedHtmlOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources("page-{0}.html")
Dim singleHtmlOptions As HtmlViewOptions = HtmlViewOptions.ForEmbeddedResources("single-page.html")
singleHtmlOptions.RenderToSinglePage = True

Dim inputXmlDocument As String = "Sample.xml"
Using viewer As New Viewer(inputXmlDocument)
    viewer.View(paginatedHtmlOptions)
    viewer.View(singleHtmlOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

All other options, which are present in the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/) class, have no effect when saving XML to HTML, except the [`RenderToSinglePage`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/rendertosinglepage/) flag.

## Saving to PDF format

PDF format by its nature has pages, so if the XML content because of its big size cannot fit in the single PDF page, then it will be paginated. Unlike the HTML, PNG, or JPEG, the GroupDocs.Viewer generates only a single PDF file for a single input XML document, with one or more pages. [`PdfViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions/) class is responsible for saving XML to the PDF, and example below shows this:

{{< tabs "Saving to PDF example">}}
{{< tab "C#" >}}
```csharp
PdfViewOptions pdfOptions = new PdfViewOptions("output.pdf");
string inputXmlDocument = "Sample.xml";
using (Viewer viewer = new Viewer(inputXmlDocument))
{
    viewer.View(pdfOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim pdfOptions As PdfViewOptions = New PdfViewOptions("output.pdf")
Dim inputXmlDocument As String = "Sample.xml"
Using viewer As New Viewer(inputXmlDocument)
    viewer.View(pdfOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

As for the version 24.8 all options, which are present in the [`PdfViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions/) class, have no effect when saving XML to PDF.

## Saving to raster PNG and JPEG formats

[`PngViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/) and [`JpgViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/) are responsible for saving XML to the PNG and JPEG raster image formats. Like for the PDF, if XML content cannot fit into the area of one image, it will be paginated and spread across multiple images.

Size of the output images will be calculated automatically based on the XML content, as for the version 24.8 there is no possibility to set the size forcibly, and `Width`, `Height`, `MaxWidth`, and `MaxHeight` properties of the [`PngViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/) and [`JpgViewOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/) classes have no effect when saving XML to PNG or JPEG.

There is a possibility to set a quality of output JPEG image by setting a [`JpgViewOptions.Quality`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/quality/) instance property, which has a default value `90`.

Example below shows saving input XML to the output PNG and JPEG:

{{< tabs "Saving to PNG and JPEG example">}}
{{< tab "C#" >}}
```csharp
PngViewOptions pngOptions = new PngViewOptions("page-{0}.png");
JpgViewOptions jpegOptions = new JpgViewOptions("page-{0}.jpeg");
jpegOptions.Quality = 80; // setting output JPEG quality explicitly

string inputXmlDocument = "Sample.xml";
using (Viewer viewer = new Viewer(inputXmlDocument))
{
    viewer.View(pngOptions);
    viewer.View(jpegOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim pngOptions As PngViewOptions = New PngViewOptions("page-{0}.png")
Dim jpegOptions As JpgViewOptions = New JpgViewOptions("page-{0}.jpeg")
jpegOptions.Quality = 80 ' setting output JPEG quality explicitly

Dim inputXmlDocument As String = "Sample.xml"
Using viewer As New Viewer(inputXmlDocument)
    viewer.View(pngOptions)
    viewer.View(jpegOptions)
End Using
```
{{< /tab >}}
{{< /tabs >}}

## Retrieving information about XML view

Like for all other supported formats, GroupDocs.Viewer supports returning information about specific XML documents. Like for all other formats, for doing this you need to call the [`GetViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/getviewinfo/) instance method of the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/) class, which returns an instance of [`ViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/) class. This [`ViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/) instance contains all information about the view depending on [`ViewInfoOptions`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions/), passed to the [`GetViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/getviewinfo/) method.

Example below shows obtaining [`ViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/) for a single XML document for HTML, PDF, and PNG formats.

{{< tabs "Retrieving information about XML view example">}}
{{< tab "C#" >}}
```csharp
ViewInfoOptions viewInfoOptionsHtmlSingle = ViewInfoOptions.ForHtmlView(true);
ViewInfoOptions viewInfoOptionsPdf = ViewInfoOptions.ForPdfView();
ViewInfoOptions viewInfoOptionsPng = ViewInfoOptions.ForPngView();

string inputXmlDocument = "Sample.xml";
using (Viewer viewer = new Viewer(inputXmlDocument))
{
    ViewInfo resultHtmlSingle = viewer.GetViewInfo(viewInfoOptionsHtmlSingle);
    ViewInfo resultPdf = viewer.GetViewInfo(viewInfoOptionsPdf);
    ViewInfo resultPng = viewer.GetViewInfo(viewInfoOptionsPng);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Dim viewInfoOptionsHtmlSingle As ViewInfoOptions = ViewInfoOptions.ForHtmlView(True)
Dim viewInfoOptionsPdf As ViewInfoOptions = ViewInfoOptions.ForPdfView()
Dim viewInfoOptionsPng As ViewInfoOptions = ViewInfoOptions.ForPngView()

Dim inputXmlDocument As String = "Sample.xml"
Using viewer As New Viewer(inputXmlDocument)
    Dim resultHtmlSingle As ViewInfo = viewer.GetViewInfo(viewInfoOptionsHtmlSingle)
    Dim resultPdf As ViewInfo = viewer.GetViewInfo(viewInfoOptionsPdf)
    Dim resultPng As ViewInfo = viewer.GetViewInfo(viewInfoOptionsPng)
End Using
```
{{< /tab >}}
{{< /tabs >}}

## Conclusion

Before the release of the [version 24.8](https://releases.groupdocs.com/viewer/net/release-notes/2024/groupdocs-viewer-for-net-24-8-release-notes/#new-xml-converter) the XML format was supported by the GroupDocs.Viewer, but XML files were treated as the plain text, without any XML-specific features like structure formatting, highlighting, proper pagination, and so on.

Starting from the version 24.8, the new dedicated XML processing module makes XML support to be a truly powerful and useful feature, and ability to fix and display even the heavily corrupted XML documents allows to use the GroupDocs.Viewer for viewing XML documents in those cases, when all other competitors failed.












---

## Render XML documents as HTML, PDF, PNG, and JPEG files

Path: /viewer/python-net/render-xml-documents/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) started to support XML format a long time ago, but XML documents were treated as plain text, and thus it was not as useful as it might be. Starting from [version 24.9](https://releases.groupdocs.com/viewer/python-net/release-notes/2024/groupdocs-viewer-for-python-via-net-24-9-release-notes/#new-xml-converter), the completely new XML processing module was implemented, and now XML documents are processed differently, not as plain text documents. This article explains this new XML processing module.

## Opening the XML document

First of all need to emphasize that the new XML processing module had not touched the public API at all — no new options, classes, properties or methods were added or modified. In order to process input XML document properly using the new XML processing module, need to either specify the [`LoadOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/loadoptions/) class instance with [`FileType.XML`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/filetype/) in its [constructor](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/loadoptions/#constructors) or just pass the XML document as filename with `*.xml` extension. Code example below shows all possible ways:

{{< tabs "Loading example">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer, FileType
from groupdocs.viewer.options import LoadOptions

def load_xml_document():
    # Method 1: Load XML document by specifying filename with .xml extension
    # GroupDocs.Viewer automatically detects XML format from file extension
    with Viewer("sample.xml") as viewer:
        # Render document
        pass

    # Method 2: Load XML document by explicitly specifying file type in LoadOptions
    # Create load options and set file type to XML
    load_options = LoadOptions()
    load_options.file_type = FileType.XML

    # Load XML document with explicit load options
    with Viewer("sample.xml", load_options) as viewer:
        # Render document
        pass

if __name__ == "__main__":
    load_xml_document()
```
{{< /tab >}}
{{< tab "sample.xml" >}}
{{< tab-text >}}
`sample.xml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-xml-documents/sample.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


If the instance of the [`Viewer`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/) class is initialized using one of the ways described above, the new XML processing module will be used.

By default all XML documents must have an [XML declaration](https://developer.mozilla.org/en-US/docs/Web/XML/XML_introduction#xml_declaration), which is located in the very beginning of the XML document and which stores the encoding of the consecutive content, for example: 

`<?xml version="1.1" encoding="UTF-8" ?>`

By default GroupDocs.Viewer uses it. But there is a possibility to override this character encoding, if needed. In order to do this the [`LoadOptions.encoding`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/loadoptions/#properties) property should be set while initializing the [`Viewer`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/) class, as it is shown below:

{{< tabs "Custom encoding example">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer, FileType
from groupdocs.viewer.options import LoadOptions

def load_xml_with_encoding():
    # Create load options for XML file type
    load_options = LoadOptions(FileType.XML)
    # Override the encoding specified in XML declaration
    # This allows you to use a different encoding than what's declared in the XML file
    load_options.encoding = "ASCII"

    # Load XML document with custom encoding
    with Viewer("sample.xml", load_options) as viewer:
        # Render document
        pass

if __name__ == "__main__":
    load_xml_with_encoding()
```
{{< /tab >}}
{{< tab "sample.xml" >}}
{{< tab-text >}}
`sample.xml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-xml-documents/sample.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


The rest of this article explains features of this new XML processing module.

## Representation

The main task of the new XML processing module is to represent the XML markup, obtained from the user, in a structured, formatted, hierarchical view, with highlighting of every distinct entity of this XML structure. For the GroupDocs.Viewer there is no matter how human-friendly is represented the XML markup in original document: it may be divided by line breaks onto separate lines per every element, or the whole document may be stored in a single line of text; it may have indents or not, — all of this does not matter. The GroupDocs.Viewer parses the input XML document and creates a hierarchical Document Object Model (DOM), and then serializes it to the HTML, PDF, PNG or JPEG depending on user options.

In particular, when serializing, GroupDocs.Viewer puts every XML element (node) on a new line, and with left indent, which indicates nesting of a certain element. Every entity of the XML document, — XML element, attribute, its value, text node, XML comment, CDATA section, — has its own highlighting: font style, type, color, size and so on. All quotes, used for enquoting the attribute values, are unified.

The screenshot below shows such scenario. On the left side there is a [sample XML document](/viewer/net/sample-files/render-xml-documents/books-single-line.xml), where all content is stored within a single line, with no indents, line breaks, horizontal tabs, or even extra whitespaces. On the right side the resultant HTML file, generated by the GroupDocs.Viewer, is shown. There can be seen structured view with corrent line breaks and indents, valid highlighting of every XML entity, and recognition of the URIs and email addresses.

![Generate HTML view for input XML](/viewer/net/images/rendering-basics/render-xml-documents/XML-to-HTML.png)

## Fix incorrect XML structure

The World Wide Web Consortium has clearly defined what is a valid XML document, and what is not. The term “[well-formed document](https://developer.mozilla.org/en-US/docs/Web/XML/XML_introduction#correct_xml_valid_and_well-formed)” defines a those XML document, which "adheres to the syntax rules specified by the XML 1.0 specification in that it must satisfy both physical and logical structures"([ref](http://www.csdservices.com/articles/csdservices)). In particular, a valid XML document must contain only valid characters, its start tags and end tags must be matched, correctly opened and closed, elements must be properly nested, and so on. Unfortunately, not all existing XML documents are well-formed and sometimes there is a necessity to view them. Different XML markup viewers often are unable to properly show invalid XML documents.

GroupDocs.Viewer with its new XML processing module is able to correctly parse, process, format, highlight and view even the heavily distorted XML documents. There is partial list of different damages in XML structure, which GroupDocs.Viewer can fix and process:

- Invalid and illegal characters, including `<` and `&` characters in wrong places.
- Start tags, which are not closed.
- End tags, which are not opened.
- Interleaved (overlapped) tags.
- Start and end tags with unmatched letter cases.
- Truncated (cutted from end) markup.
- Attribute names without values.
- Un-enquoted attribute values (without enclosing quotes).
- Attribute values, which are enquoted partially, with only opening or only closing quote.
- Attribute values, which have redundant quote inside.

GroupDocs.Viewer detects and fixes all these and even more issues in XML markup and also writes them to the log.

Screenshot below demonstrates this in action. [Sample XML file "InvalidXml.xml"](/viewer/net/sample-files/render-xml-documents/InvalidXml.xml) contains all possible damages, described above. In cannot be correctly formatted and highlighted by most popular XML viewing and editing applications. But with the new XML processing module the GroupDocs.Viewer fixes its structure and displays it absolutely correct.

![Generate HTML view for input XML](/viewer/net/images/rendering-basics/render-xml-documents/XML-fixed.png)

## Recognition of URIs and email addresses

While processing the XML markup, the GroupDocs.Viewer scans the XML content for any valid URI, if found, represents them as external links in the resultant HTML format: by using the [A element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a). GroupDocs.Viewer is searching for URIs in: text nodes, CDATA sections, XML comments, attribute values, DocType definitions.

Regarding the email addresses, the GroupDocs.Viewer searches them only in attribute values, and if found, represents them with [mailto](https://en.wikipedia.org/wiki/Mailto) scheme and [A element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a).

If the XML document is saved not to the HTML format, but to the PDF, the URIs and email addresses will be interactive too. But if the output format is PNG or JPEG, the output will be a raster image without any interactive links, of course.

## Saving to HTML format

For saving the documents to the HTML format the GroupDocs.Viewer provides a [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) class. There are two ways of creating an instance of this class: using either [`for_external_resources`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) or [`for_embedded_resources`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) static methods. First method is designed for saving HTML document in a such way, that all its resources (stylesheets, images, fonts etc) are stored separately, while second method stores all resources of the HTML document inside its content: stylesheets are saved inside the STYLE elements, SVG graphics is inlined inside HTML markup, while all other resources (mostly raster images and fonts) are stored according to the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme) and converted to the [base64](https://en.wikipedia.org/wiki/Base64) format.

But in the context of the XML documents the way of creating the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) instance is not important, because the XML documents cannot have resources, which may be stored externally or embedded. So, when saving XML documents to the HTML, you can create the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) instance in both ways — the result will be the same, no external resources will be produced.

Another important thing is that the XML format by its nature has no pages — it is a hierarchical structure, where some elements are nested inside another, and there is no even similar to pages here. So the best way to represent them in HTML format is to generate a single-page HTML document, so all XML content will be represented in a single HTML document. In order to do this the option [`HtmlViewOptions.render_to_single_page`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#properties) needs to be set up to the true value. By default this option has a false value, so the output HTML document will be paginated — splitted into multiple chunks.

Code example below shows rendering of input XML file to the HTML in both ways:

{{< tabs "Saving to HTML example">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_xml_to_html():
    # Create HTML view options for paginated output
    # {0} will be replaced with page number
    paginated_html_options = HtmlViewOptions.for_embedded_resources("render_xml_to_html/page-{0}.html")
    
    # Create HTML view options for single-page output
    single_html_options = HtmlViewOptions.for_embedded_resources("render_xml_to_html/single-page.html")
    # Enable single-page rendering - all XML content in one HTML file
    single_html_options.render_to_single_page = True

    # Load XML document
    with Viewer("sample.xml") as viewer:
        # Render to paginated HTML (multiple HTML files)
        viewer.view(paginated_html_options)
        # Render to single-page HTML (one HTML file)
        viewer.view(single_html_options)

if __name__ == "__main__":
    render_xml_to_html()
```
{{< /tab >}}
{{< tab "sample.xml" >}}
{{< tab-text >}}
`sample.xml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-xml-documents/sample.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

All other options, which are present in the [`HtmlViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/) class, have no effect when saving XML to HTML, except the [`render_to_single_page`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#properties) flag.

## Saving to PDF format

PDF format by its nature has pages, so if the XML content because of its big size cannot fit in the single PDF page, then it will be paginated. Unlike the HTML, PNG, or JPEG, the GroupDocs.Viewer generates only a single PDF file for a single input XML document, with one or more pages. [`PdfViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/) class is responsible for saving XML to the PDF, and example below shows this:

{{< tabs "Saving to PDF example">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_xml_to_pdf():
    # Create PDF view options and specify output file path
    pdf_options = PdfViewOptions("render_xml_to_pdf/xml_document.pdf")
    
    # Load XML document
    with Viewer("sample.xml") as viewer:
        # Render XML document to PDF format
        # If content is large, it will be automatically paginated
        viewer.view(pdf_options)

if __name__ == "__main__":
    render_xml_to_pdf()
```
{{< /tab >}}
{{< tab "sample.xml" >}}
{{< tab-text >}}
`sample.xml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-xml-documents/sample.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

As for the version 24.8 all options, which are present in the [`PdfViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions/) class, have no effect when saving XML to PDF.

## Saving to raster PNG and JPEG formats

[`PngViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/) and [`JpgViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/) are responsible for saving XML to the PNG and JPEG raster image formats. Like for the PDF, if XML content cannot fit into the area of one image, it will be paginated and spread across multiple images.

Size of the output images will be calculated automatically based on the XML content, as for the version 24.8 there is no possibility to set the size forcibly, and `width`, `height`, `max_width`, and `max_height` properties of the [`PngViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/) and [`JpgViewOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/) classes have no effect when saving XML to PNG or JPEG.

There is a possibility to set a quality of output JPEG image by setting a [`JpgViewOptions.quality`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) instance property, which has a default value `90`.

Example below shows saving input XML to the output PNG and JPEG:

{{< tabs "Saving to PNG and JPEG example">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions, JpgViewOptions

def render_xml_to_images():
    # Create PNG view options
    # {0} will be replaced with page number if content spans multiple images
    pngOptions = PngViewOptions("render_xml_to_images/page-{0}.png")
    
    # Create JPEG view options
    jpegOptions = JpgViewOptions("render_xml_to_images/page-{0}.jpeg")
    # Set JPEG image quality (1-100, default is 90)
    jpegOptions.quality = 80

    # Load XML document
    with Viewer("sample.xml") as viewer:
        # Render XML document to PNG format
        viewer.view(pngOptions)
        # Render XML document to JPEG format
        viewer.view(jpegOptions)

if __name__ == "__main__":
    render_xml_to_images()
```
{{< /tab >}}
{{< tab "sample.xml" >}}
{{< tab-text >}}
`sample.xml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-xml-documents/sample.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Retrieving information about XML view

Like for all other supported formats, GroupDocs.Viewer supports returning information about specific XML documents. Like for all other formats, for doing this you need to call the [`get_view_info`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) instance method of the [`Viewer`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/) class, which returns an instance of [`ViewInfo`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/viewinfo/) class. This [`ViewInfo`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/viewinfo/) instance contains all information about the view depending on [`ViewInfoOptions`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewinfooptions/), passed to the [`get_view_info`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

Example below shows obtaining [`ViewInfo`](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.results/viewinfo/) for a single XML document for HTML, PDF, and PNG formats.

{{< tabs "Retrieving information about XML view example">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import ViewInfoOptions

def get_xml_view_info():
    # Create view info options for HTML format (single page)
    view_info_options_html_single = ViewInfoOptions.for_html_view(True)
    # Create view info options for PDF format
    view_info_options_pdf = ViewInfoOptions.for_pdf_view()
    # Create view info options for PNG format
    view_info_options_png = ViewInfoOptions.for_png_view()

    # Load XML document
    with Viewer("sample.xml") as viewer:
        # Get view information for HTML format (single page)
        result_html_single = viewer.get_view_info(view_info_options_html_single)  
        # Get view information for PDF format
        result_pdf = viewer.get_view_info(view_info_options_pdf) 
        # Get view information for PNG format
        result_png = viewer.get_view_info(view_info_options_png)

if __name__ == "__main__":
    get_xml_view_info()
```
{{< /tab >}}
{{< tab "sample.xml" >}}
{{< tab-text >}}
`sample.xml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-xml-documents/sample.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
---

## Rotating PDF documents

Path: /annotation/net/rotatitng-pdf-documents/


GroupDocs.Annotation v21.12 and later allows you to rotate the PDF document page by 90, 180, 270 degrees clockwise. To do this, specify the page number as the [ProcessPages](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/processpages/) property and then set the [Rotation](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/annotator/rotation/) property to one of the following values:

* None does not rotate the document
* on90 rotates the document 90 degrees clockwise
* on180 rotates the document 180 degrees clockwise
* on270 rotates the document 270 degrees clockwise

By default, the property is set to `None`.

The following code snippets shows how to rotate the first page by 90 degrees clockwise:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using (Annotator annotator = new Annotator("annotated_file.pdf"))
{
	annotator.ProcessPages = 1;
	annotator.Rotation = RotationDocument.on90;
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Set image quality

Path: /annotation/net/change-image-quality/


GroupDocs.Annotation v22.4 and later allows you to set the quality of an image added to a document. To do this, specify the `imageQuality` parameter of the [AddImageToDocument](https://reference.groupdocs.com/annotation/net/groupdocs.annotation/document/addimagetodocument/) method.

The parameter value is from 1 to 100. 1 means the lowest resolution, and 100 means the highest.

The following code snippet shows how to set the image quality:

{{< tabs "example1">}}
{{< tab "C#" >}} 
```csharp
using (Annotator annotator = new Annotator("input.pdf-file")) // specify the path to the input PDF file
{
	string dataDir = "input.pdf"; // specify the path to the input PDF file
    string data = "image.jpg"; // the path to the JPG file
    int pageNumber = 1; // set the page where the image will be inserted
    int imageQuality = 10; // set image quality from 1 to 100
    annotator.Document.AddImageToDocument(dataDir, data, pageNumber, imageQuality);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Set image size limits

Path: /viewer/java/set-image-size-limits-when-rendering-to-png-jpg/

The [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) and [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) classes implement the [IMaxSizeOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/imaxsizeoptions/) interface that contains properties for size limits:

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
/**
 * Limits of image size options interface.
 */
public interface IMaxSizeOptions {
    /**
     * Max width of an output image in pixels.
     */
    int getMaxWidth();
    /**
     * Max width of an output image in pixels.
     */
    int setMaxWidth();
    /**
     * Max height of an output image in pixels.
     */
    int getMaxHeight();
    /**
     * Max height of an output image in pixels.
     */
    int setMaxHeight();
}
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="warning" >}}
If you call the setImageWidth/setImageHeight options, calls of the setImageMaxWidth/setImageMaxHeight methods are ignored.
{{< /alert >}}

To set the ImageMaxWidth/ImageMaxHeight options, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/Viewer) object.
2. Instantiate the [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/) or [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/) object.
3. Call the setMaxWidth and/or setMaxHeight methods.
4. Call the [View.view()](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#view-com.groupdocs.viewer.options.ViewOptions-) method.

The following code snippet shows how to set the output image size limits:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.jpg")) {
    JpgViewOptions viewOptions = new JpgViewOptions("result_{0}.jpg");
    // PngViewOptions viewOptions = new PngViewOptions("result_{0}.png");
    // Specify the maximum width and height.
    viewOptions.setMaxWidth(800);
    viewOptions.setMaxHeight(600);

    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Set image size limits

Path: /viewer/net/set-image-size-limits-when-rendering-to-png-jpg/

The [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions) and [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) classes implement the [IMaxSizeOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/imaxsizeoptions) interface that contains properties for size limits:

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
/// <summary>
/// Limits of image size options interface. 
/// </summary>
public interface IMaxSizeOptions
{
    /// <summary>
    /// Max width of an output image in pixels.
    /// </summary>
    int MaxWidth { get; set; }

    /// <summary>
    /// Max height of an output image in pixels.
    /// </summary>
    int MaxHeight { get; set; }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
''' <summary>
''' Limits of image size options interface. 
''' </summary>
Public Interface IMaxSizeOptions
    ''' <summary>
    ''' Max width of an output image in pixels.
    ''' </summary>
    Property MaxWidth As Integer

    ''' <summary>
    ''' Max height of an output image in pixels.
    ''' </summary>
    Property MaxHeight As Integer
End Interface
```
{{< /tab >}}
{{< /tabs >}}

{{< alert style="warning" >}}
If you set the ImageWidth/ImageHeight options, the ImageMaxWidth/ImageMaxHeight options are ignored.
{{< /alert >}}

To set the ImageMaxWidth/ImageMaxHeight options, follow these steps:

1. Instantiate the [Viewer](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer) object.
2. Instantiate the [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions) or [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions) object.
3. Set MaxWidth and/or MaxHeight values.
4. Call the [View](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/view) method.

The following code snippet shows how to set the output image size limits:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.jpg"))
{
    // Create a JPG or PNG file.
    JpgViewOptions viewOptions = new JpgViewOptions("result_{0}.jpg");
    // or PngViewOptions viewOptions = new PngViewOptions("result_{0}.png");
    
    // Specify the maximum width and height.
    viewOptions.MaxWidth = 800;
    viewOptions.MaxHeight = 600;

    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.jpg")
            ' Create a JPG or PNG file.
            Dim viewOptions As JpgViewOptions = New JpgViewOptions("result_{0}.jpg")
            ' or PngViewOptions viewOptions = new PngViewOptions("result_{0}.png");
        
            ' Specify the maximum width and height.
            viewOptions.MaxWidth = 800
            viewOptions.MaxHeight = 600
        
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}
---

## Sign document with Metadata signature - advanced

Path: /signature/java/sign-document-with-metadata-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides ability to secure Metadata signatures, same as embed into it data objects. These feature are implemented over data serialization and encryption. Also there is ability to provide custom data serialization and encryption to secure your signature data the most. Here are feature summary

*   ability to encrypt Metadata signature string values
*   ability to embedded custom objects into Metadata signatures with data encryption
*   ability to specify custom objects encryption
*   ability to implement custom data serialization  
      

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Technical support

Path: /conversion/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Conversion, consider the following:

1. Make sure you are using the latest GroupDocs.Conversion version before reporting an issue. See [GroupDocs.Conversion for .NET NuGet Package](https://www.nuget.org/packages/GroupDocs.Conversion/) to find out about the latest version.
2. Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
3. Post your question at [GroupDocs.Conversion Free Support Forum](https://forum.groupdocs.com/c/conversion), and we'll assist you. Questions are answered directly by the GroupDocs.Conversion development team.
4. When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Conversion, follow these simple steps to make sure it is resolved in the most efficient way:

1. Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
2. Add information about the environment you are facing the issue.
3. Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical support

Path: /conversion/nodejs-java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Conversion, consider the following:

1. Make sure you are using the latest GroupDocs.Conversion version before reporting an issue. See [GroupDocs.Conversion for Node.js via Java NPM Package](https://www.npmjs.com/package/@groupdocs/groupdocs.conversion) to find out about the latest version.
2. Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
3. Post your question at [GroupDocs.Conversion Free Support Forum](https://forum.groupdocs.com/c/conversion), and we'll assist you. Questions are answered directly by the GroupDocs.Conversion development team.
4. When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Conversion, follow these simple steps to make sure it is resolved in the most efficient way:

1. Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs Forums because only you and the GroupDocs developers will have access to the attached files.
2. Add information about the environment you are facing the issue.
3. Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical support

Path: /markdown/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Markdown, consider the following:

1. Make sure you are using the latest GroupDocs.Markdown version before reporting an issue. See [GroupDocs.Markdown for .NET NuGet Package](https://www.nuget.org/packages/GroupDocs.Markdown/) to find out about the latest version.
2. Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
3. Post your question at [GroupDocs.Markdown Free Support Forum](https://forum.groupdocs.com/c/markdown), and we'll assist you. Questions are answered directly by the GroupDocs.Markdown development team.
4. When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Markdown, follow these simple steps to make sure it is resolved in the most efficient way:

1. Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
2. Add information about the environment you are facing the issue.
3. Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.
---

## Technical support

Path: /markdown/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Markdown, consider the following:

1. Make sure you are using the latest GroupDocs.Markdown version before reporting an issue. See [GroupDocs.Markdown for Python via .NET on PyPI](https://pypi.org/project/groupdocs-markdown-net/) to find out about the latest version.
2. Have a look through the forums, this documentation, and the API Reference before reporting an issue -- perhaps your question has already been answered.
3. Post your question at [GroupDocs.Markdown Free Support Forum](https://forum.groupdocs.com/c/markdown), and we'll assist you. Questions are answered directly by the GroupDocs.Markdown development team.
4. When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have higher priority compared to the free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Markdown, follow these simple steps to make sure it is resolved in the most efficient way:

1. Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
2. Add information about the environment you are facing the issue.
3. Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical support

Path: /viewer/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Viewer, follow these steps:

1. Make sure you are using the latest GroupDocs.Viewer version before reporting an issue. See [GroupDocs.Viewer for .NET NuGet Package](https://www.nuget.org/packages/GroupDocs.Viewer/) to find out about the latest version.
2. Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
3. Post your question at [GroupDocs.Viewer Free Support Forum](https://forum.groupdocs.com/c/viewer/9), and we'll assist you. Questions are answered directly by the GroupDocs.Viewer development team.
4. When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority in comparison to the free support requests. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set a higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Viewer, follow these steps to ensure it is resolved most efficiently:

1. Include the original document and the code snippet causing the problem. If you need to attach several files, zip them into one. Only you and the GroupDocs developers have access to the attached files.
2. Add information about the environment you face the issue.
3. Report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /annotation/java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Annotation, consider the following:

* Make sure you are using the latest GroupDocs.Annotation version before reporting an issue.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Annotation Free Support Forum](https://forum.groupdocs.com/c/annotation/10), and we'll assist you. Questions are answered directly by the GroupDocs.Annotation development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Annotation, follow these simple steps to make sure it is resolved most efficiently:

1. Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
2. Add information about the environment you are facing the issue.
3.* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /annotation/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Annotation, consider the following:

* Make sure you are using the latest GroupDocs.Annotation version before reporting an issue. See [GroupDocs.Annotation for .NET NuGet Package](https://www.nuget.org/packages/GroupDocs.Annotation/) to find out the latest version.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Annotation Free Support Forum](https://forum.groupdocs.com/c/annotation/10), and we'll assist you. Questions are answered directly by the GroupDocs.Annotation development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Annotation, follow these simple steps to make sure it is resolved most efficiently:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /comparison/java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Comparison, consider the following:

* Make sure you are using the latest GroupDocs.Annotation version before reporting an issue.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Comparison Free Support Forum](https://forum.groupdocs.com/c/comparison/12), and we will assist you. Questions are answered directly by the GroupDocs.Comparison development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Annotation, follow these simple steps to make sure it is resolved most efficiently:

* Include the original document(s) and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /comparison/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Comparison, consider the following:

* Make sure you are using the latest GroupDocs.Annotation version before reporting an issue. See [GroupDocs.Comparison for .NET NuGet Package](https://www.nuget.org/packages/GroupDocs.Comparison/) to find out the latest version.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Comparison Free Support Forum](https://forum.groupdocs.com/c/comparison/12), and we will assist you. Questions are answered directly by the GroupDocs.Comparison development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Annotation, follow these simple steps to make sure it is resolved most efficiently:

* Include the original document(s) and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /comparison/nodejs-java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Comparison, consider the following:

* Make sure you are using the latest GroupDocs.Comparison version before reporting an issue.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Comparison Free Support Forum](https://forum.groupdocs.com/c/comparison/12), and we will assist you. Questions are answered directly by the GroupDocs.Comparison development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set a higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Comparison, follow these simple steps to make sure it is resolved most efficiently:

* Include the original document(s) and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /comparison/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Comparison, consider the following:

* Make sure you are using the latest GroupDocs.Comparison version before reporting an issue.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Comparison Free Support Forum](https://forum.groupdocs.com/c/comparison/12), and we will assist you. Questions are answered directly by the GroupDocs.Comparison development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set a higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Comparison, follow these simple steps to make sure it is resolved most efficiently:

* Include the original document(s) and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /conversion/java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Conversion, consider the following:

1. Make sure you are using the latest GroupDocs.Conversion version before reporting an issue. See [GroupDocs.Conversion for Java Releases](https://releases.groupdocs.com/conversion/java/) to find out about the latest version.
2. Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
3. Post your question at [GroupDocs.Conversion Free Support Forum](https://forum.groupdocs.com/c/conversion), and we'll assist you. Questions are answered directly by the GroupDocs.Conversion development team.
4 When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

1. Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Conversion, follow these simple steps to make sure it is resolved in the most efficient way:

1. Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
2. Add information about the environment you are facing the issue.
3. Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /editor/java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Editor, consider the following:

* Make sure you are using the latest GroupDocs.Editor version before reporting an issue. See [GroupDocs.Editor for Java Package](https://repository.groupdocs.com/webapp/#/artifacts/browse/tree/General/repo/com/groupdocs/groupdocs-editor) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Editor Free Support Forum](https://forum.groupdocs.com/c/editor), and we'll assist you. Questions are answered directly by the GroupDocs.Editor development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Editor, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /editor/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Editor, consider the following:

* Make sure you are using the latest GroupDocs.Editor version before reporting an issue. See [GroupDocs.Editor for .NET NuGet Package](https://www.nuget.org/packages/GroupDocs.Editor/) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Editor Free Support Forum](https://forum.groupdocs.com/c/editor), and we'll assist you. Questions are answered directly by the GroupDocs.Editor development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Editor, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /editor/nodejs-java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Editor, consider the following:

* Make sure you are using the latest GroupDocs.Editor version before reporting an issue. See [GroupDocs.Editor for Node.js Package](https://www.npmjs.com/package/@groupdocs/groupdocs.editor) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Editor Free Support Forum](https://forum.groupdocs.com/c/editor), and we'll assist you. Questions are answered directly by the GroupDocs.Editor development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Editor, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /merger/java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Merger, consider the following:

* Make sure you are using the latest GroupDocs.Merger version before reporting an issue. See [GroupDocs.Merger for Java Repository](https://repository.groupdocs.com/webapp/#/artifacts/browse/tree/General/repo/com/groupdocs/groupdocs-merger) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Merger Free Support Forum](https://forum.groupdocs.com/c/merger), and we'll assist you. Questions are answered directly by the GroupDocs.Merger development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Merger, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /merger/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Merger, consider the following:

* Make sure you are using the latest GroupDocs.Merger version before reporting an issue. See [GroupDocs.Merger for .NET NuGet Package](https://www.nuget.org/packages/GroupDocs.Merger/) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Merger Free Support Forum](https://forum.groupdocs.com/c/merger), and we'll assist you. Questions are answered directly by the GroupDocs.Merger development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Merger, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /merger/nodejs-java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Merger, consider the following:

* Make sure you are using the latest GroupDocs.Merger version before reporting an issue. See [GroupDocs.Merger for Node.js via Java Repository](https://repository.groupdocs.com/webapp/#/artifacts/browse/tree/General/repo/com/groupdocs/groupdocs-merger) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Merger Free Support Forum](https://forum.groupdocs.com/c/merger), and we'll assist you. Questions are answered directly by the GroupDocs.Merger development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Merger, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /merger/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Merger, consider the following:

* Make sure you are using the latest GroupDocs.Merger version before reporting an issue. See [GroupDocs.Merger for Python via .NET Repository](https://repository.groupdocs.com/webapp/#/artifacts/browse/tree/General/repo/com/groupdocs/groupdocs-merger) to find out about the latest version.
* Have a look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Merger Free Support Forum](https://forum.groupdocs.com/c/merger), and we'll assist you. Questions are answered directly by the GroupDocs.Merger development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues has higher priority comparing to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Merger, follow these simple steps to make sure it is resolved in the most efficient way:

* Include the original document and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers will have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Technical Support

Path: /parser/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Parser, consider the following:

* Make sure you are using the latest GroupDocs.Parser version before reporting an issue.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Parser Free Support Forum](https://forum.groupdocs.com/c/parser), and we will assist you. Questions are answered directly by the GroupDocs.Parser development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set a higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Parser, follow these simple steps to make sure it is resolved most efficiently:

* Include the original document(s) and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.


---

## Technical Support

Path: /total/java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/), [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) and [Paid Consulting](https://consulting.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## Support Options

### Free Support Forum

The [GroupDocs Free Support Forum](https://forum.groupdocs.com/) is available to all users and provides:
- Direct access to the GroupDocs.Total development team
- Community-driven support and knowledge sharing
- No time limitations on support requests
- Access to historical solutions and discussions

### Paid Support Helpdesk

The [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) offers:
- Higher priority response times
- Dedicated support team
- Extended support hours
- Priority issue resolution

### Paid Consulting

We can work together with you on your project and develop a part or complete application. If you need new features in the existing GroupDocs product or to create API for new file formats, send us a request at [consulting.groupdocs.com/contact](https://consulting.groupdocs.com/contact/).

## Getting Support

### Before Contacting Support

1. Ensure you're using the latest version of GroupDocs.Total
   - Check [GroupDocs Artifact Repository](https://releases.groupdocs.com/#/artifacts/browse/tree/General/repo/com/groupdocs/groupdocs-total) for updates
2. Review existing resources:
   - Search the [documentation](https://docs.groupdocs.com/total/java/)
   - Check the [API Reference](https://reference.groupdocs.com/)
   - Browse the [support forum](https://forum.groupdocs.com/c/total/8) for similar issues

### Reporting Issues

When reporting an issue, include:

1. **Required Information:**
   - Original document(s) causing the problem
   - Code snippet demonstrating the issue
   - Environment details (OS, Java version, etc.)
   - Steps to reproduce the issue

2. **Best Practices:**
   - Create a separate thread for each issue
   - Use clear, descriptive titles
   - Attach files in ZIP format if multiple files are needed
   - Allow for time zone differences when waiting for responses

---

## Technical Support

Path: /total/net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/), [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) and [Paid Consulting](https://consulting.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## Support Options

### Free Support Forum

The [GroupDocs Free Support Forum](https://forum.groupdocs.com/) is available to all users and provides:
- Direct access to the GroupDocs.Total development team
- Community-driven support and knowledge sharing
- No time limitations on support requests
- Access to historical solutions and discussions

### Paid Support Helpdesk

The [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) offers:
- Higher priority response times
- Dedicated support team
- Extended support hours
- Priority issue resolution

### Paid Consulting

We can work together with you on your project and develop a part or complete application. If you need new features in the existing GroupDocs product or to create API for new file formats, send us a request at [consulting.groupdocs.com/contact](https://consulting.groupdocs.com/contact/).

## Getting Support

### Before Contacting Support

1. Ensure you're using the latest version of GroupDocs.Total
   - Check [GroupDocs.Total](https://www.nuget.org/packages/GroupDocs.Total/) and [GroupDocs.Total.NETFramework](https://www.nuget.org/packages/GroupDocs.Total.NETFramework/) packages for updates
2. Review existing resources:
   - Search the [documentation](https://docs.groupdocs.com/total/net/)
   - Check the [API Reference](https://reference.groupdocs.com/)
   - Browse the [support forum](https://forum.groupdocs.com/c/total/8) for similar issues

### Reporting Issues

When reporting an issue, include:

1. **Required Information:**

   - Original document(s) causing the problem
   - Code snippet demonstrating the issue
   - Environment details (OS, .NET version, etc.)
   - Steps to reproduce the issue

2. **Best Practices:**

   - Create a separate thread for each issue
   - Use clear, descriptive titles
   - Attach files in ZIP format if multiple files are needed
   - Allow for time zone differences when waiting for responses

---

## Technical Support

Path: /total/python-net/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/), [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) and [Paid Consulting](https://consulting.groupdocs.com/).

{{< alert style="info" >}}

Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.

{{< /alert >}}

## Support Options

### Free Support Forum

The [GroupDocs Free Support Forum](https://forum.groupdocs.com/) is available to all users and provides:

- Direct access to the GroupDocs.Total development team
- Community-driven support and knowledge sharing
- No time limitations on support requests
- Access to historical solutions and discussions

### Paid Support Helpdesk

The [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) offers:

- Higher priority response times
- Dedicated support team
- Extended support hours
- Priority issue resolution

### Paid Consulting

We can work together with you on your project and develop a part or complete application. If you need new features in the existing GroupDocs product or to create API for new file formats, send us a request at [consulting.groupdocs.com/contact](https://consulting.groupdocs.com/contact/).

## Getting Support

### Before Contacting Support

1. Ensure you're using the latest version of GroupDocs.Total
   
   - Check [groupdocs-total-net](https://pypi.org/project/groupdocs-total-net/) package for updates

2. Review existing resources:
   
   - Search the [documentation](https://docs.groupdocs.com/total/)
   - Browse the [support forum](https://forum.groupdocs.com/c/total/8) for similar issues

### Reporting Issues

When reporting an issue, include:

1. **Required Information:**

   - Original document(s) causing the problem
   - Code snippet demonstrating the issue
   - Environment details (OS, Python version, package version, etc.)
   - Steps to reproduce the issue

2. **Best Practices:**

   - Create a separate thread for each issue
   - Use clear, descriptive titles
   - Attach files in ZIP format if multiple files are needed
   - Allow for time zone differences when waiting for responses

---

## Technical Support

Path: /watermark/nodejs-java/technical-support/


GroupDocs provides unlimited free technical support for all of its products. Support is available to all users, including evaluation. The support is provided at [Free Support Forum](https://forum.groupdocs.com/) and [Paid Support Helpdesk](https://helpdesk.groupdocs.com/).

{{< alert style="info" >}}
Please note that GroupDocs does not provide technical support over the phone. Phone support is only available for sales and purchase questions.
{{< /alert >}}

## GroupDocs Free Support Forum

If you need help with GroupDocs.Watermark, consider the following:

* Make sure you are using the latest GroupDocs.Watermark version before reporting an issue.
* Look through the forums, this documentation, and the API Reference before reporting an issue – perhaps your question has already been answered.
* Post your question at [GroupDocs.Watermark Free Support Forum](https://forum.groupdocs.com/c/watermark/19), and we will assist you. Questions are answered directly by the GroupDocs.Watermark development team.
* When expecting a reply on the forums, please allow for time zone differences.

## Paid Support Helpdesk

The paid support issues have a higher priority compared to the free support requests.

* Post your question at the [Paid Support Helpdesk](https://helpdesk.groupdocs.com/) to set a higher priority for the issue.

## Report an Issue or Feature Request

When posting your issue, question, or feature request with GroupDocs.Watermark, follow these simple steps to make sure it is resolved most efficiently:

* Include the original document(s) and possibly the code snippet that is causing the problem. If you need to attach a few files, zip them into one. It is safe to attach your documents to GroupDocs.Forums because only you and the GroupDocs developers have access to the attached files.
* Add information about the environment you are facing the issue.
* Try to report one issue per thread. If you have another issue, question, or feature request, please report it in a separate thread.

---

## Working with metadata in WEBP images

Path: /metadata/java/working-with-metadata-in-webp-images/

## Working with XMP metadata

GroupDocs.Metadata for Java allows managing XMP metadata in JPEG images. For more details please refer to the following guide: [Working with XMP Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in JPEG images. Please find appropriate code samples in the [Working with EXIF Metadata]({{< ref "metadata/java/developer-guide/advanced-usage/working-with-metadata-standards/working-with-exif-metadata.md" >}}) section.

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)
    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)
    

### Free online document metadata management App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).

---

## Working with metadata in WEBP images. Working with metadata in ASF files

Path: /metadata/net/working-with-metadata-in-webp-imagesworking-with-metadata-in-asf-files/

## Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in WEBP images. For more details please refer to the following guide: [Working with XMP metadata]({{< ref "metadata/net/developer-guide/advanced-usage/working-with-metadata-standards/working-with-xmp-metadata.md" >}}).

## More resources
### GitHub examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Metadata for .NET examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-.NET)    
*   [GroupDocs.Metadata for Java examples](https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Java)    

### Free online document metadata management App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to view and edit metadata of PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, emails, images and more with our free online [Free Online Document Metadata Viewing and Editing App](https://products.groupdocs.app/metadata).
---

## Sign document with QR-code signature - advanced

Path: /signature/net/sign-document-with-qr-code-signature-advanced/

GroupDocs.Signature provides [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) class to specify additional options for QR-code signature with following signature appearance

* signature alignment ([HorizontalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/horizontalalignment), [VerticalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/verticalalignment))
* margins ([Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/margin))
* border and background settings ([Border,](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/border) [Background](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/background))
* font and colors ([Font](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/font), [Forecolor](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/forecolor))

Here are the steps to add QR-code signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) object with all required additional options.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add Barcode signature to document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
 using (Signature signature = new Signature("sample.docx"))
 {
     // create QRCode option with predefined QRCode text
     QrCodeSignOptions options = new QrCodeSignOptions("12345678")
     {
         // setup QRCode encoding type
         EncodeType = QrCodeTypes.QR,
         // set signature position
         Left = 100,
         Top = 100,
         // set signature alignment
         // when VerticalAlignment is set the Top coordinate will be ignored.
         // Use Margin properties Top, Bottom to provide vertical offset
         VerticalAlignment = VerticalAlignment.Top,
         // when HorizontalAlignment is set the Left coordinate will be ignored.
         // Use Margin properties Left, Right to provide horizontal offset
         HorizontalAlignment = HorizontalAlignment.Right,
         Margin = new Padding() { Top = 20, Right = 20 },
         // adjust signature appearance
         // setup signature border
         Border = new Border()
         {
             Color = Color.DarkGreen,
             DashStyle = DashStyle.DashLongDashDot,
             Transparency = 0.5,
             Visible = true,
             Weight = 2
         },
         // set text color and Font
         ForeColor = Color.Red,
         Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
         // setup background
         Background = new Background()
         {
             Color = Color.LimeGreen,
             Transparency = 0.5,
             Brush = new LinearGradientBrush(Color.LimeGreen, Color.DarkGreen)
         }
     };
     // sign document to file
     SignResult signResult = signature.Sign("signed.docx", options);
     Console.WriteLine("\nList of newly created signatures:");
     int number = 1;
     foreach (BaseSignature temp in signResult.Succeeded)
     {
         Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
     }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To generate QR codes and/or sign your files with QR codes for free, you can use the [QR Code Generator](https://products.groupdocs.app/signature/generate/qrcode) online app.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the other online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.
---

## Searching for document signatures with exception handling

Path: /signature/java/searching-for-document-signatures-with-exception-handling/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides different error messages due to validation issues, missing required data, files etc. For handling these exceptions class [GroupDocsSignatureException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/GroupDocsSignatureException)should be used.

Here are the steps to handle exceptions from GroupDocs.Signature while searching for document signatures:

*   Compose try-catch block above [search](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#search(java.lang.Class,%20com.groupdocs.signature.options.search.SearchOptions))  method with catching [GroupDocsSignatureException](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.exception/GroupDocsSignatureException) type error.
    

## Exception handling while searching for document signatures

This example shows how to handle GroupDocs.Signature exceptions.

```java
try {
    LoadOptions loadOptions = new LoadOptions();
    Signature signature = new Signature("samplePasswordProtected.pdf");
    // create QRCode option with predefined QRCode text
    DigitalSearchOptions options = new DigitalSearchOptions();
 
    // search signature document
    List<DigitalSignature> signatures = signature.search(DigitalSignature.class,options);
} catch (GroupDocsSignatureException ex) {
    System.out.print("GroupDocs Signature Exception: " + ex.getMessage());
} catch (Exception ex) {
    System.out.print("System Exception: " + ex.getMessage());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Searching for document signatures with exception handling

Path: /signature/net/searching-for-document-signatures-with-exception-handling/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides different error messages due to validation issues, missing required data, files etc. For handling these exceptions class [GroupDocsSignatureException](https://reference.groupdocs.com/signature/net/groupdocs.signature/groupdocssignatureexception) should be used.

Here are the steps to handle exceptions from GroupDocs.Signature while searching for document signatures:

* Compose try-catch block above [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search)  method with catching [GroupDocsSignatureException](https://reference.groupdocs.com/signature/net/groupdocs.signature/groupdocssignatureexception) type error.

## Exception handling while searching for document signatures

This example shows how to handle GroupDocs.Signature exceptions.

```csharp
try
{
    // dont specify Password on protected document
    LoadOptions loadOptions = new LoadOptions();
    using (Signature signature = new Signature("samplePasswordProtected.pdf"))
    {
        DigitalSearchOptions options = new DigitalSearchOptions()
        {
        };
        // sign document to file
        List<DigitalSignature> signatures = signature.Search<DigitalSignature>(options);
    }
}
catch (GroupDocsSignatureException ex)
{
    Console.WriteLine("GroupDocs Signature Exception: " + ex.Message);
}
catch (Exception ex)
{
    Console.WriteLine("System Exception: " + ex.Message);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add resource redaction annotation

Path: /annotation/java/add-resource-redaction-annotation/

Resource redaction annotation fills black rectangle with fixed position to hide a text as shown in the picture below:

![](/annotation/java/images/add-resource-redaction-annotation.png)

You can use the following methods to set the properties of the [ResourcesRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) class:

*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/resourcesredactionannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation on the page

To add a resource redaction annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [ResourceRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [ResourceRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) class.
4.  Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream. 

The following code snippet shows how to add [ResourcesRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding resources redaction annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of ResourcesRedactionAnnotation class and set options
    ResourcesRedactionAnnotation resourcesRedaction = new ResourcesRedactionAnnotation();
    resourcesRedaction.setBox(new Rectangle(100, 100, 100, 100));
    resourcesRedaction.setCreatedOn(Calendar.getInstance().getTime());
    resourcesRedaction.setMessage("This is resources redaction annotation");
    resourcesRedaction.setPageNumber(0);
    resourcesRedaction.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(resourcesRedaction);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add resource redaction annotation

Path: /annotation/net/add-resource-redaction-annotation/

Resource redaction annotation fills black rectangle with fixed position to hide a text as shown in the picture below:

![](/annotation/net/images/add-resource-redaction-annotation.png)

You can specify the following properties of the [ResourcesRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/resourcesredactionannotation/properties/box) defines the annotation on the page

To add a resource redaction annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [ResourceRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [ResourceRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) class.
4.  Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream. 

The following code snippet shows how to add [ResourcesRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/resourcesredactionannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add resource redaction annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	ResourcesRedactionAnnotation resourcesRedaction = new ResourcesRedactionAnnotation
    {
    	Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Message = "This is resources redaction annotation",
        PageNumber = 0,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
   };
   annotator.Add(resourcesRedaction);
   annotator.Save("result.pdf");
} 

```
{{< /tab >}}
{{< /tabs >}}
---

## Compare of Variables and Document properties

Path: /comparison/java/compare-of-variables-and-document-properties/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare various properties of a Word document such as _Variable_, _Built_, and _Custom_ properties.

Use the following methods of the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) class to enable comparison functions for document properties:

- [setCompareVariableProperty()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setCompareVariableProperty-boolean-) allows the comparison of _variable_ properties
- [setCompareDocumentProperty()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setCompareDocumentProperty-boolean-) allows  the comparison of _built_ and _custom_ properties

To activate compare document properties, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/) object. Specify the source file path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object. Call the [setCompareVariableProperty()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setCompareVariableProperty-boolean-) method to compare the _variable_ properties and/or the [setCompareDocumentProperty()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setCompareDocumentProperty-boolean-) for _built_ and _custom_ properties.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object from the previous step.

The following code snippet shows how activate comparison of the _variable_, _Bbuilt_ and _custom_ properties:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    CompareOptions options = new CompareOptions();

    // to activate comparison of variable properties
    options.setCompareVariableProperty(true); 

    // to activate the comparison of built and custom properties
    options.setCompareDocumentProperty(true); 

    final Path resultPath = comparer.compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/java/images/properties-summary-page.png)

---

## Compare of Variables and Document properties

Path: /comparison/net/compare-of-variables-and-document-properties/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare various properties of a Word document such as _Variable_, _Built_, and _Custom_ properties.

Use the following fields of the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) class to enable comparison functions for document properties:

- [CompareVariableProperty](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/comparevariableproperty) allows the comparison of _variable_ properties
- [CompareDocumentProperty](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/comparedocumentproperty) allows  the comparison of _built_ and _custom_ properties

To activate compare document properties, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify the source file path or stream.
2.  Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/add/index) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. Set the [CompareVariableProperty](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/comparevariableproperty) property to `true` for the _variable_ properties and/or [CompareDocumentProperty](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/comparedocumentproperty)  for _built_ and _custom_ properties.
4.  Call the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how activate comparison of the Variable, Built and Custom properties:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions options = new CompareOptions();
    options.CompareVariableProperty = true; // to activate the comparison of variable properties
    options.CompareDocumentProperty = true; // to activate the comparison of built and custom properties

    comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/properties-summary-page.png)

---

## Compare of Variables and Document properties

Path: /comparison/nodejs-java/compare-of-variables-and-document-properties/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare various properties of a Word document such as _Variable_, _Built_, and _Custom_ properties.

Use the following methods of the `CompareOptions` class to enable comparison functions for document properties:

- `setCompareVariableProperty()` allows the comparison of _variable_ properties
- `setCompareDocumentProperty()` allows the comparison of _built_ and _custom_ properties

The following code snippet shows how to activate the comparison of the _variable_, _built_ and _custom_ properties:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

 // Enable strict mode for better error handling
 // Define file paths for source, target, and output documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

 // Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

 // Add the target document to be compared against the source
comparer.add(targetPath);

 // Create a CompareOptions instance to customize comparison settings
const options = new groupdocs.CompareOptions();

 // Enable comparison of variable (custom) properties
options.setCompareVariableProperty(true);

 // Enable comparison of built-in document properties
options.setCompareDocumentProperty(true);

 // Execute the comparison and save the result to the output path
comparer.compare(outputPath, options);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It enables comparison of both variable properties (using `setCompareVariableProperty(true)`) and document properties including built-in and custom properties (using `setCompareDocumentProperty(true)`), then performs the comparison with these options. Any differences in document properties will be highlighted in the result document.

The result is as follows:

![](/comparison/nodejs-java/images/properties-summary-page.png)

---

## Compare variables and document properties

Path: /comparison/python-net/compare-of-variables-and-document-properties/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) lets you compare Word document properties, including variable, built-in, and custom properties.

## Compare document properties

Enable property comparison to detect changes in metadata.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.compare_variable_property = True  # compare variable properties
    options.compare_document_property = True  # compare built and custom properties
    comparer.compare("result.docx", options)
```

🔹 Use case: Ensure key metadata values remain consistent across document versions.


The result is as follows:

![](/comparison/net/images/properties-summary-page.png)

---

## Convert Image using OCR

Path: /conversion/net/convert-image-using-ocr/

### Convert Image using OCR

GroupDocs.Conversion for .NET provide an extension point which allows convert images using OCR processing. To use this you have to implement **[IOcrConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.ocr/iocrconnector)** interface and provide instance of it in **[ImageLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/imageloadoptions)**.

The following code snippet shows how to convert image using OCR processing and extract text from image and convert it to PDF:

First create a class that implements [IOcrConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.ocr/iocrconnector)**
```csharp
internal class OcrConnector : IOcrConnector
{
    public RecognizedImage Recognize(Stream imageStream)
    {
        try
        {
            var api = new AsposeOcr();
            var ocrInput = new OcrInput(InputType.SingleImage);

            using (MemoryStream ms = new MemoryStream())
            {
                imageStream.Position = 0;
                imageStream.CopyTo(ms);
                ms.Position = 0;
                ocrInput.Add(ms);

                var detectedRectangles = api.DetectRectangles(ocrInput, AreasType.LINES, false).First();
                var result = api.Recognize(ocrInput, new RecognitionSettings
                    {
                        DetectAreasMode = DetectAreasMode.COMBINE,
                        RecognitionAreas = detectedRectangles.Rectangles
                    })
                    .First();
                return CreateRecognizedImageFromResult(result);
            }
        }
        catch (System.Exception ex)
        {
            Console.WriteLine("Aspose.OCR Recognition failed: {0}", ex);
        }

        return RecognizedImage.Empty;
    }

    private RecognizedImage CreateRecognizedImageFromResult(RecognitionResult result)
    {
        var lines = new List<TextLine>();

        for (var i = 0; i < result.RecognitionAreasText.Count; i++)
        {
            var rectangle = result.RecognitionAreasRectangles[i];
            var s = result.RecognitionAreasText[i].Trim('\r', '\n');
            var fragments = SplitToFragments(s, rectangle.X, rectangle.Y, rectangle.Width, rectangle.Height);
            lines.Add(new TextLine(fragments));
        }

        return new RecognizedImage(lines);
    }

    private static List<TextFragment> SplitToFragments(string lineText, int rectangleX, int rectangleY,
        int rectangleWidth, int rectangleHeight)
    {
        var fragments = new List<TextFragment>();
        if (!string.IsNullOrEmpty(lineText))
        {
            int index = 0, fragIndex = 0;
            bool isWhitespace = false;
            List<char> frag = new List<char>();
            int previousWidth = 0;
            float fixWidthChar = rectangleWidth / GetEquivalentLength(lineText);
            while (index < lineText.Length)
            {
                if (frag.Count == 0)
                {
                    isWhitespace = (lineText[index] == ' ');
                }
                else
                {
                    bool altIsWhitespace = (lineText[index] == ' ');
                    if (index == lineText.Length - 1) frag.Add(lineText[index]);
                    if (altIsWhitespace != isWhitespace || (index == lineText.Length - 1))
                    {
                        string fragment = new string(frag.ToArray());
                        int fragWidth = (int)Math.Round(GetEquivalentLength(fragment) * fixWidthChar);
                        int actualLength = (index == lineText.Length - 1) ? lineText.Length : index;
                        previousWidth =
                            (int)Math.Round(GetEquivalentLength(lineText.Substring(0, actualLength - frag.Count)) *
                                            fixWidthChar);
                        fragments.Add(new TextFragment(fragment, new System.Drawing.Rectangle(
                            rectangleX + previousWidth,
                            rectangleY, fragWidth, rectangleHeight)));
                        fragIndex += fragment.Length;
                        frag.Clear();
                        isWhitespace = altIsWhitespace;
                    }
                }

                frag.Add(lineText[index]);
                index++;
            }
        }

        return fragments;
    }

    private static readonly List<char> NarrowChars = new List<char>(new char[]
    {
        ',', '.', ':', ';', '!', '|', '(', ')', '{', '}',
        'l', 'i', 'I', '-', '+', 'f', 't', 'r'
    });

    private static readonly List<char> WideChars = new List<char>(new char[] { '\t', 'm', 'w', 'M', 'W' });

    private static float GetEquivalentLength(string lineText)
    {
        var length = 0F;
        foreach (var c in lineText)
        {
            if (c == ' ')
                length += 0.6F;
            else if (NarrowChars.Contains(c))
                length += 0.5F;
            else if (WideChars.Contains(c) || char.IsUpper(c))
                length += 1.5F;
            else
                length += 1F;
        }

        return length;
    }
}
```

Then provide **OcrConnector** instance in **[RasterImageLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/rasterimageloadoptions)**:

```csharp
var imageLoadOptions = new RasterImageLoadOptions();
imageLoadOptions.SetOcrConnector(new OcrConnector());

using (Converter converter = new Converter("sample.jpeg", (LoadContext loadContext) => imageLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

{{< alert style="info" >}}The example uses Aspose.OCR but any OCR processing library could be used{{< /alert >}}


---

## Extract table of contents

Path: /parser/java/extract-table-of-contents/

GroupDocs.Parser allows to extract table of contents from Microsoft Word (DOC, DOCX etc), PDF documents and Ebooks.

# Extract table of contents

To extract table of contents from documents, please use the [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method:

```java
Iterable<TocItem> getToc();
```

[TocItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem) class has the following members:

| Member | Description |
| --- | --- |
| [getDepth](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem#getDepth()) | The depth level. |
| [getPageIndex](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem#getPageIndex()) | The page index. |
| [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem#getText()) | The text. |
| [extractText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem#extractText()) | Extracts a text from the document to which [TocItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem) object refers. For detail, see [Extract text by table of contents item]({{< ref "parser/java/developer-guide/advanced-usage/working-with-text/extract-text-by-table-of-contents-item.md" >}}) |

Here are the steps to extract extract table of contents from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object for the initial document;
*   Call [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method and obtain collection of [TocItem](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/TocItem) objects;
*   Check if *collection* isn't *null* (table of contents  extraction is supported for the document);
*   Iterate through the collection and get page index to extract a page text from the document.

The following example shows how to extract table of contents from CHM file:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SampleChm)) {
    // Check if text extraction is supported
    if (!parser.getFeatures().isText()) {
        System.out.println("Text extraction isn't supported.");
        return;
    }
    // Check if toc extraction is supported
    if (!parser.getFeatures().isToc()) {
        System.out.println("Toc extraction isn't supported.");
        return;
    }
    // Get table of contents
    Iterable<TocItem> toc = parser.getToc();
    // Iterate over items
    for (TocItem i : toc) {
        // Print the Toc text
        System.out.println(i.getText());
        // Check if page index has a value
        if (i.getPageIndex() == null) {
            continue;
        }
        // Extract a page text
        try (TextReader reader = parser.getText(i.getPageIndex())) {
            System.out.println(reader.readToEnd());
        }
    }
}
```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/java/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract table of contents

Path: /parser/net/extract-table-of-contents/

GroupDocs.Parser allows to extract table of contents from Microsoft Word (DOC, DOCX etc), PDF documents and Ebooks.

## Extract table of contents

To extract TOC from documents, please use the [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method:

```csharp
IEnumerable<TocItem> GetToc()

```

[TocItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem) class has the following members:

| Member | Description |
| --- | --- |
| [Depth](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/properties/depth) | The depth level. |
| [PageIndex](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/properties/pageindex) | The page index. |
| [Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/properties/text) | The text. |
| TextReader [ExtractText()](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem/methods/extracttext) | Extract a text from the document to which [TocItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem) object refers. For detail, see [Extract Text By Table of Contents Item]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/extract-text-by-table-of-contents-item.md" >}}) |

Here are the steps to extract extract table of contents from the document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method and obtain collection of [TocItem](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/tocitem) objects;
*   Check if *collection* isn't *null* (table of contents  extraction is supported for the document);
*   Iterate through the collection and get page index to extract a page text from the document.

The following example shows how to extract table of contents from CHM file:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(filePath))
{
    // Check if text extraction is supported
    if (!parser.Features.Text)
    {
        Console.WriteLine("Text extraction isn't supported.");
        return;
    }
    // Check if toc extraction is supported
    if (!parser.Features.Toc)
    {
        Console.WriteLine("Toc extraction isn't supported.");
        return;
    }
    // Get table of contents
    IEnumerable<TocItem> toc = parser.GetToc();
    // Iterate over items
    foreach (TocItem i in toc)
    {
        // Print the Toc text
        Console.WriteLine(i.Text);
        // Check if page index has a value
        if (i.PageIndex == null)
        {
            continue;
        }
        // Extract a page text
        using (TextReader reader = parser.GetText(i.PageIndex.Value))
        {
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}

```

## More resources

### Advanced usage topics

To learn more about document data extraction features and get familiar how to extract text, images, forms and more, please refer to the [advanced usage section]({{< ref "parser/net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to extract text, metadata and images from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## How to correctly merge documents using C#

Path: /merger/net/getting-started/use-cases/how-to-correctly-merge-documents-using-csharp/

# with File Paths

The easiest and most reliable way to merge PDF files, using the "GroupDocs.Merger for .NET" product, is to use the full paths to these files.

The following example demonstrates how to merge PDF files using file paths in C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass the full PDF file path as a constructor parameter.
* Add another PDF file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PDF file as parameter.

```csharp
// Load the source PDF file
using (Merger merger = new Merger(@"c:\sample1.pdf"))
{
    // Add another PDF file to merge
    merger.Join(@"c:\sample2.pdf");
    // Merge PDF files and save result
    merger.Save(@"c:\merged.pdf");
}
```

# with File Streams

There are also several ways to work with streams of files that need to be merged using the GroupDocs.Merger product. The most reliable way to combine files without additional parameters is to use the System.FileStream class.

The following example demonstrates how to merge DOCX file streams in C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass the DOCX file stream as a constructor parameter.
* Add another DOCX file stream to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged DOCX file as parameter.

```csharp
string filePath1 = "c:/sample1.docx";
string filePath2 = "c:/sample2.docx";

FileStream fileStream1 = File.OpenRead(filePath1);
FileStream fileStream2 = File.OpenRead(filePath2);

// Load the source DOCX file stream
using (Merger merger = new Merger(fileStream1))
{
    // Add another DOCX file stream to merge
    merger.Join(fileStream2);
    // Merge DOCX file streams and save result
    merger.Save(@"c:\merged.docx");
}
```

# with Memory Streams

There are situations, and quite often, when it is necessary to work with other classes inherited from System.Stream, for example with MemoryStream or others. In this case, it is necessary to use additional parameters to specify the exact file type that is used in this case. Because the "GroupDocs.Merger for .NET" product cannot always accurately determine the file type by its stream. Therefore, to avoid exceptions when merging PDF and other files, see the example below:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass instance of [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) with PPTX file type as a constructor parameter.
* Create an instance of [JoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/joinoptions) class with PPTX file type as a constructor parameter.
* Add another PPTX stream to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [JoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/joinoptions) class as a method parameter.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PPTX file as parameter.

```csharp

string filePath1 = "c:/sample1.pptx";
string filePath2 = "c:/sample2.pptx";

FileType fileType1 = FileType.FromExtension(Path.GetExtension(filePath1));
FileType fileType2 = FileType.FromExtension(Path.GetExtension(filePath2));

MemoryStream memoryStream1 = new MemoryStream();
using (FileStream fileStream1 = File.OpenRead(filePath1))
{
    fileStream1.CopyTo(memoryStream1);
}

MemoryStream memoryStream2 = new MemoryStream();
using (FileStream fileStream2 = File.OpenRead(filePath2))
{
    fileStream2.CopyTo(memoryStream2);
}

// Init Load options with defined FileType
LoadOptions loadOptions = new LoadOptions(fileType1);

// Load the source PPTX stream
using (Merger merger = new Merger(memoryStream1, loadOptions))
{
    // Define join options with PPTX file type
    JoinOptions joinOptions = new JoinOptions(fileType2);
    // Add another PPTX stream to merge
    merger.Join(memoryStream2, joinOptions);
    // Merge PPTX streams and save result
    merger.Save(@"c:\merged.pptx");
}
```

# with Memory Streams for cross-merging

There may also be situations when it is necessary to combine different types of streams into PDF. In this case, you can use the example below:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass instance of [LoadOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/loadoptions) with ini DOCX file type and out PDF one as a constructor parameters.
* Create an instance of [JoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/joinoptions) class with PPTX file type as a constructor parameter.
* Add another PPTX stream to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [JoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/joinoptions) class as a method parameter.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PDF file as parameter.

```csharp

string filePath1 = "c:/sample1.docx";
string filePath2 = "c:/sample2.pptx";

MemoryStream memoryStream1 = new MemoryStream();
using (FileStream fileStream1 = File.OpenRead(filePath1))
{
    fileStream1.CopyTo(memoryStream1);
}

MemoryStream memoryStream2 = new MemoryStream();
using (FileStream fileStream2 = File.OpenRead(filePath2))
{
    fileStream2.CopyTo(memoryStream2);
}

// Init Load options with defined FileTypes
LoadOptions loadOptions = new LoadOptions(FileType.DOCX, FileType.PDF);

// Load the source DOCX stream as PDF
using (Merger merger = new Merger(memoryStream1, loadOptions))
{
    // Define join options with PPTX file type
    JoinOptions joinOptions = new JoinOptions(FileType.PPTX);
    // Add another PPTX stream to merge
    merger.Join(memoryStream2, joinOptions);
    // Merge document streams and save PDF result
    merger.Save(@"c:\merged.pdf");
}
```

---

## How to properly merge documents using Java

Path: /merger/java/getting-started/use-cases/how-to-properly-merge-documents-using-java/

# with File Paths

The easiest and most reliable way to merge PDF files, using the "GroupDocs.Merger for Java" product, is to use the full paths to these files.

The following example demonstrates how to merge PDF files using file paths in Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#Merger-java.lang.String-) class and pass the full PDF file path as a constructor parameter.
* Add another PDF file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.lang.String-) method.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.lang.String-) method and specify the filename for the merged PDF file as parameter.

```java
// Load the source PDF file
Merger merger = new Merger("c:\sample1.pdf");

// Add another PDF file to merge
merger.join("c:\sample2.pdf");
// Merge PDF files and save result
merger.save("c:\merged.pdf");

```


# with File Input Streams

There are situations, and quite often, when it is necessary to work with other classes inherited from java.io.InputStream, for example with FileInputStream or others. In this case, it is necessary to use additional parameters to specify the exact file type that is used in this case. Because the "GroupDocs.Merger for Java" product cannot always accurately determine the file type by its stream. Therefore, to avoid exceptions when merging PDF and other files, see the example below:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#Merger-java.io.InputStream-com.groupdocs.merger.domain.options.interfaces.ILoadOptions-) class and pass instance of [LoadOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/loadoptions/) with PPTX file type as a constructor parameter.
* Create an instance of [JoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/joinoptions/) class with PPTX file type as a constructor parameter.
* Add another PPTX stream to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-com.groupdocs.merger.domain.options.interfaces.IJoinOptions-) method and pass instance of [JoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/joinoptions/) class as a method parameter.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.lang.String-) method and specify the filename for the merged PPTX file as parameter.

```java

String filePath1 = "c:/sample1.pptx";
String filePath2 = "c:/sample2.pptx";

FileType fileType1 = FileType.fromExtension(filePath1.substring(filePath1.lastIndexOf('.')));
FileType fileType2 = FileType.fromExtension(filePath2.substring(filePath2.lastIndexOf('.')));

File initialFile1 = new File(filePath1);
InputStream fileStream1 = new FileInputStream(initialFile1);

File initialFile2 = new File(filePath2);
InputStream fileStream2 = new FileInputStream(initialFile2);

// Init Load options with defined FileType
LoadOptions loadOptions = new LoadOptions(fileType1);

// Load the source PPTX stream
Merger merger = new Merger(fileStream1, loadOptions);

// Define join options with PPTX file type
JoinOptions joinOptions = new JoinOptions(fileType2);
// Add another PPTX stream to merge
merger.join(fileStream2, joinOptions);
// Merge PPTX streams and save result
merger.save("c:\merged.pptx");

```

# with File Input Streams for cross-merging

There may also be situations when it is necessary to combine different types of streams into PDF. In this case, you can use the example below:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#Merger-java.io.InputStream-com.groupdocs.merger.domain.options.interfaces.ILoadOptions-) class and pass instance of [LoadOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/loadoptions/) with ini DOCX file type and out PDF one as a constructor parameters.
* Create an instance of [JoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/joinoptions/) class with PPTX file type as a constructor parameter.
* Add another PPTX stream to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-com.groupdocs.merger.domain.options.interfaces.IJoinOptions-) method and pass instance of [JoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/joinoptions/) class as a method parameter.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.lang.String-) method and specify the filename for the merged PDF file as parameter.

```java

String filePath1 = "c:/sample1.docx";
String filePath2 = "c:/sample2.pptx";

File initialFile1 = new File(filePath1);
InputStream fileStream1 = new FileInputStream(initialFile1);

File initialFile2 = new File(filePath2);
InputStream fileStream2 = new FileInputStream(initialFile2);

// Init Load options with defined FileTypes
LoadOptions loadOptions = new LoadOptions(FileType.DOCX, FileType.PDF);

// Load the source DOCX stream as PDF
Merger merger = new Merger(fileStream1, loadOptions);

// Define join options with PPTX file type
JoinOptions joinOptions = new JoinOptions(FileType.PPTX);
// Add another PPTX stream to merge
merger.join(fileStream2, joinOptions);
// Merge document streams and save PDF result
merger.save("c:\merged.pdf");

```

---

## How to Run Examples

Path: /merger/net/how-to-run-examples/

{{< alert style="warning" >}}Before running an example make sure that GroupDocs.Merger has been installed successfully.{{< /alert >}}

We offer multiple solutions on how you can run GroupDocs.Merger examples, by building your own or using our back-end or front-end examples out-of-the-box.

Please choose one from the following list:

## Build project from scratch

* Open Visual Studio and go to **File** -> **New** -> **Project**.
* Select appropriate project type - Console App, ASP.NET Web Application etc.
* Install **GroupDocs.Merger for .NET** from Nuget or official GroupDocs website following this [guide]({{< ref "merger/net/getting-started/installation.md" >}}).
* Code your first application with **GroupDocs.Merger for .NET** like this
  
    ```csharp
    // The path to the documents directory.
    string firstDocPath = @"C:\sample.docx"; // NOTE: Put here actual path for your document
    string secondDocPath = @"C:\sample2.docx"; // NOTE: Put here actual path for your document
    string outputPath = @"C:\output\result.docx";
  
    // Join two documents and save into result.docx.
    using (Merger merger = new Merger(firstDocPath))
    {
    	merger.Join(secondDocPath);
        merger.Save(outputPath);
    }  
    ```  

* Build and Run your project.
* Signed document will appear inside *"C:\\output\\"* directory.

## Run back-end examples

The complete examples package of **GroupDocs.Merger** is hosted on [GitHub](https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET). You can either download the ZIP file from [here](https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET/archive/master.zip) or clone the repository of GitHub using your favourite git client.  
In case you download the ZIP file, extract the folders on your local disk. The extracted files and folders will look like following image:

![](/merger/net/images/how-to-run-examples.png)

In extracted files and folders, you can find CSharp solution file. The project is created in **Microsoft Visual Studio 2019**. The **Resources** folder contains all the sample document and image files used in the examples.  
To run the examples, open the solution file in Visual Studio and build the project. To add missing references of **GroupDocs.Merger** see [Development Environment, Installation and Configuration]({{< ref "merger/net/getting-started/installation.md" >}}). All the functions are called from **RunExamples.cs**.
Un-comment the function you want to run and comment the rest.

![](/merger/net/images/how-to-run-examples_1.png)

## Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples in this repository are open source and can be freely used in your own applications.  
To contribute, you can fork the repository, edit the code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

## Indexing metadata of documents

Path: /search/java/indexing-metadata-of-documents/

GroupDocs.Search allows creating of full-text and / or metadata index on documents. To index only metadata without main content of documents, you only need to set [IndexType.MetadataIndex](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexType#MetadataIndex) when creating an index. The size of an index of this type will be very small.

The following example demonstrates the creation of the metadata index.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an instance of index settings
IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex); // Setting index type
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Searching in the index
SearchResult result = index.search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing metadata of documents

Path: /search/net/indexing-metadata-of-documents/

GroupDocs.Search allows creating of full-text and / or metadata index on documents. To index only metadata without main content of documents, you only need to set IndexType.MetadataIndex when creating an index. The size of an index of this type will be very small.

The following example demonstrates the creation of the metadata index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an instance of index settings
IndexSettings settings = new IndexSettings();
settings.IndexType = IndexType.MetadataIndex; // Setting index type
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Searching in the index
SearchResult result = index.Search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing metadata of documents

Path: /search/nodejs-java/indexing-metadata-of-documents/

GroupDocs.Search allows creating of full-text and / or metadata index on documents. To index only metadata without main content of documents, you only need to set [IndexType.MetadataIndex](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexType#MetadataIndex) when creating an index. The size of an index of this type will be very small.

The following example demonstrates the creation of the metadata index.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an instance of index settings
const settings = new groupdocs.search.IndexSettings();
settings.setIndexType(groupdocs.search.IndexType.MetadataIndex); // Setting the index type

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Searching in the index
const query = 'Einstein';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Load WordProcessing document with options

Path: /conversion/net/load-wordprocessing-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [WordProcessingLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions) to give you control over how the source Microsoft Word document will be converted. The following options could be set:
| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/format)** | The document type is auto-detected during loading, however, you can specify explicitly the type of the source WordProcessing document. Available options are: *Doc, Docm, Docx, Dot, Dotm, Dotx, Rtf, Odt, Ott, Mobi, Txt* |
|**[AutoFontSubstitution](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/autofontsubstitution)** | If false, GroupDocs.Conversion uses the DefaultFont for the substitution of missing fonts. If true, GroupDocs.Conversion evaluates all the related fields in FontInfo (Panose, Sig etc) for the missing font and finds the closest match among the available font sources.|
|**[BookmarkOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/bookmarkoptions)** | Specifies options for handling bookmarks. |
|**[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/defaultfont)** | Specifies the font to use if a document font is missing. |
|**[EmbedTrueTypeFonts](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/embedtruetypefonts)** | Specifies whether to embed true type fonts in the output document. Default is false. |
|**[FontSubstitutes](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/fontsubstitutes)** | Substitute specific fonts from the source document. |
|**[HideComments](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/hidecomments)** | Specifies that comments from the source document should be hidden in the converted document. |
|**[HideWordTrackedChanges](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/hidewordtrackedchanges)** | Specifies that tracked changes should not be included in the converted document. |
|**[KeepDateFieldOriginalValue](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/keepdatefieldoriginalvalue)** | Specifies whether to keep the original values of date fields. Default is false. |
|**[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/password)** | A password to unlock the protected document. |
|**[PreserveFormFields](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/preserveformfields)** | Specifies whether to preserve Microsoft Word form fields as form fields in PDF or convert them to text. Default is false. |
|**[SkipExternalResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/skipexternalresources)** | If enabled, the external resources (except for those listed in `WhitelistedResources`) will not be loaded during the conversion. |
|**[UpdateFields](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/updatefields)** | Specifies whether to update fields after loading. Default is false. |
|**[UpdatePageLayout](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/updatepagelayout)** | Specifies whether to update page layout after loading. Default is false. |
|**[UseTextShaper](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/usetextshaper)** | Specifies whether to use a text shaper for better kerning display. Default is false. |
|**[WhitelistedResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/wordprocessingloadoptions/whitelistedresources)** | Specifies which external resources will be loaded even when the loading of other external resources is restricted. |

    Note: that the font substitution mechanism will override the DefaultFont in cases when FontInfo for the missing font is available in the document.

## Hide comments

Microsoft Word provides the "Comment" feature that allows multiple authors or reviewers to discuss a document when they are not working with it simultaneously. All added comments are displayed in an area to the right of the document text. After the DOCX document with comments is converted to another format, the Comments pane is also present in a resultant document. If it's required to hide comments in a converted document programmatically, you can use the following code sample to do this with a couple of lines of C# code:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new WordProcessingLoadOptions
{
    HideComments = true
};
using (Converter converter = new Converter("sample.docx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Hide tracked changes

Track Changes is another feature of Microsoft Word that provides a handy way to collaborate during document proofreading and review - it's like you're marking errors with a pen and making some notes in the margins. All changes made by coworkers are highlighted and may be rejected or accepted and become permanent. By default, the Track Changes panel will also be displayed when converting a DOCX document to another format, however, there is an option to hide it completely using GroupDocs.Conversion for .NET API. 

The following code snippet shows how to convert a DOCX document to PDF and hide tracked changes pane:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new WordProcessingLoadOptions
{
    HideWordTrackedChanges = true
};
using (Converter converter = new Converter("sample.docx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Specify font substitution

Microsoft Word document content is often formatted with different fonts like Arial, Calibri, Times New Roman etc., and these fonts are usually stored at the computer where the document is originally created or edited. Sometimes it happens that during DOCX document conversion to another format, some fonts used by a particular document are not present on the computer where conversion is performed. So the resulting converted document may look too different from the original file.

Of course GroupDocs.Conversion for .NET will try to select the most appropriate font substitution from available font sources and fonts embedded in the original document, but you can also specify font substitution explicitly. For doing this it is just needed to call the [Create](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/fontsubstitute/create) method of [FontSubstitute](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.contracts/fontsubstitute) class and provide names for original and substitute fonts.

The following code snippet shows how to convert a DOCX document with font substitution for missing fonts:

```csharp
Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new WordProcessingLoadOptions
{
    AutoFontSubstitution = false,
	DefaultFont = "Helvetica",
    FontSubstitutes = new List<FontSubstitute>
    {
        FontSubstitute.Create("Tahoma", "Arial"),
        FontSubstitute.Create("Times New Roman", "Arial"),
    }
};
using (Converter converter = new Converter("sample.docx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Skip loading of external resources

In the context of word-processing documents, external resources refer to any elements, materials, or data that are not directly embedded within the document itself but are referenced or linked to enhance the document's content or functionality. These external resources can take various forms and are often used to supplement the text and improve the overall quality and richness of the document. Common external resources include images and graphics, tables and spreadsheets, audio and video, fonts, styles, data sources, mathematical equations and so on. 

In some cases, you may want to skip loading all or just some of the external resources during the conversion. For example, when these resources become unavailable. Read the [Skip loading of external resources]({{< ref "conversion/net/developer-guide/advanced-usage/loading/skip-external-resources.md" >}}) article to learn how to do this with **GroupDocs.Conversion for .NET**.

---

## Nesting search queries in object form

Path: /search/java/nesting-search-queries-in-object-form/

The table below shows all combinations of nesting search queries in object form with an indication of their possibility (+) or impossibility (–).

<table>
    <thead>
        <tr>
            <th>Nested query type</th>
            <th colspan=5>Parent query type</th>
        </tr>
        <tr>
            <th width="20%"></th>
            <th width="16%">Field</th>
            <th width="16%">PhraseSearch</th>
            <th width="16%">Not</th>
            <th width="16%">Or</th>
            <th width="16%">And</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Word</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>WordPattern</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>NumericRange</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Regex</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Field</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>DateRange</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>PhraseSearch</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Not</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Or</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>And</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Wildcard</td>
            <td>–</td>
            <td>+</td>
            <td>–</td>
            <td>–</td>
            <td>–</td>
        </tr>
    </tbody>
</table>

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Nesting search queries in object form

Path: /search/net/nesting-search-queries-in-object-form/

The table below shows all combinations of nesting search queries in object form with an indication of their possibility (+) or impossibility (–).

<table>
    <thead>
        <tr>
            <th>Nested query type</th>
            <th colspan=5>Parent query type</th>
        </tr>
        <tr>
            <th width="20%"></th>
            <th width="16%">Field</th>
            <th width="16%">PhraseSearch</th>
            <th width="16%">Not</th>
            <th width="16%">Or</th>
            <th width="16%">And</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Word</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>WordPattern</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>NumericRange</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Regex</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Field</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>DateRange</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>PhraseSearch</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Not</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Or</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>And</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Wildcard</td>
            <td>–</td>
            <td>+</td>
            <td>–</td>
            <td>–</td>
            <td>–</td>
        </tr>
    </tbody>
</table>

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Nesting search queries in object form

Path: /search/nodejs-java/nesting-search-queries-in-object-form/

The table below shows all combinations of nesting search queries in object form with an indication of their possibility (+) or impossibility (–).

<table>
    <thead>
        <tr>
            <th>Nested query type</th>
            <th colspan=5>Parent query type</th>
        </tr>
        <tr>
            <th width="20%"></th>
            <th width="16%">Field</th>
            <th width="16%">PhraseSearch</th>
            <th width="16%">Not</th>
            <th width="16%">Or</th>
            <th width="16%">And</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Word</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>WordPattern</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>NumericRange</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Regex</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Field</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>DateRange</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>PhraseSearch</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Not</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Or</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>And</td>
            <td>+</td>
            <td>–</td>
            <td>+</td>
            <td>+</td>
            <td>+</td>
        </tr>
        <tr>
            <td>Wildcard</td>
            <td>–</td>
            <td>+</td>
            <td>–</td>
            <td>–</td>
            <td>–</td>
        </tr>
    </tbody>
</table>

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Render images as HTML, PDF, PNG, and JPEG files

Path: /viewer/java/render-images/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to load images in various formats and convert them to HTML, PDF, PNG, and JPEG. Incorporate this library into your Java application (web or desktop) to build your own image viewer.

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass an image you want to view to the class constructor. You can load the image from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. For multipage images (such as TIFF, CDR, DICOM, WebP, and so on), you can specify the pages to render.

{{< button style="primary" link="https://products.groupdocs.app/viewer/image" >}} {{< icon "gdoc_person" >}} View image files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported image file formats

GroupDocs.Viewer supports the following image file formats:

* [.AI (Adobe Illustrator Artwork)](https://docs.fileformat.com/image/ai/)
* [.APNG (Animated Portable Network Graphic)](https://docs.fileformat.com/image/apng/)
* [.BMP (Bitmap Image)](https://docs.fileformat.com/image/bmp)
* [.CDR (CorelDRAW Image File)](https://docs.fileformat.com/image/cdr)
* [.CGM (Computer Graphics Metafile)](https://docs.fileformat.com/page-description-language/cgm)
* [.CMX (Corel Presentation Exchange Image)](https://docs.fileformat.com/image/cmx)
* [.DCM (DICOM Image)](https://docs.fileformat.com/image/dicom)
* [.DIB (Device Independent Bitmap File)](https://docs.fileformat.com/image/dib)
* [.DJVU (DjVu Image)](https://docs.fileformat.com/image/djvu)
* [.DNG (Digital Negative Image)](https://docs.fileformat.com/image/dng)
* [.EMF (Enhanced Windows Metafile)](https://docs.fileformat.com/image/emf)
* [.EMZ (Windows Compressed Enhanced Metafile)](https://docs.fileformat.com/image/emz/)
* [.EPS (Encapsulated PostScript File)](https://docs.fileformat.com/page-description-language/eps)
* [.FODG (OpenDocument Flat XML Graphics)](https://docs.fileformat.com/image/fodg/)
* [.GIF (Graphical Interchange Format)](https://docs.fileformat.com/image/gif)
* [.ICO (Icon File)](https://docs.fileformat.com/image/ico)
* [.J2C (JPEG 2000 Code Stream)](https://docs.fileformat.com/image/j2c/)
* [.J2K (JPEG 2000 Image)](https://docs.fileformat.com/image/j2k/)
* [.JP2 (JPEG 2000 Core Image File)](https://docs.fileformat.com/image/jp2/)
* [.JPC (JPEG 2000 Code Stream File)](https://docs.fileformat.com/image/jpc/)
* [.JPEG / .JPG (JPEG Image)](https://docs.fileformat.com/image/jpeg)
* [.JPF (JPEG 2000 Image)](https://docs.fileformat.com/image/jpf/)
* [.JPM (JPEG 2000 Multi-layer Image Format)](https://docs.fileformat.com/image/jpm/)
* [.JPX (JPEG 2000 Image File)](https://docs.fileformat.com/image/jpx/)
* [.JLS (JPEG-LS Image)](https://docs.fileformat.com/)
* [.ODG (OpenDocument Graphics File)](https://docs.fileformat.com/image/odg)
* [.OTG (OpenDocument Graphic Template)](https://docs.fileformat.com/image/otg/)
* [.PCL (Printer Command Language Document)](https://docs.fileformat.com/page-description-language/pcl)
* [.PNG (Portable Network Graphics)](https://docs.fileformat.com/image/png)
* [.PS (PostScript File)](https://docs.fileformat.com/page-description-language/ps)
* [.PSB (Photoshop Large Document Format)](https://docs.fileformat.com/image/psb)
* [.PSD (Adobe Photoshop Document)](https://docs.fileformat.com/image/psd)
* [.SVG (Scalable Vector Graphics File)](https://docs.fileformat.com/page-description-language/svg)
* [.SVGZ (Compressed SVG File)](https://docs.fileformat.com/image/svgz/)
* [.TGA (TARGA Graphics)](https://docs.fileformat.com/image/tga/) 
* [.TIF / .TIFF (Tagged Image File Format)](https://docs.fileformat.com/image/tiff)
* [.WEBP (WebP Image)](https://docs.fileformat.com/image/webp)
* [.WMF (Windows Metafile)](https://docs.fileformat.com/image/wmf)
* [.WMZ (Compressed Windows Metafile)](https://docs.fileformat.com/image/wmz/)

## Render images as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an image to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an image in an HTML page, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("vector-image.svg")) {
    // Specify the HTML file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to HTML](/viewer/java/images/rendering-basics/render-images/render-image-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an image to a separate folder, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("vector-image.svg")) {
    // Specify the HTML file name and location of external resources.
    // {0} is replaced with the resource name in the output file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("output.html", "output/resource_{0}", "output/resource_{0}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is shown below. The image is placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-images/render-image-to-html-external-resources.png)

## Render images as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an image to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("vector-image.svg")) {
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PDF](/viewer/java/images/rendering-basics/render-images/render-image-to-pdf.png)

## Convert images to PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an image to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("vector-image.svg")) {
    // Create a PNG image.
    PngViewOptions viewOptions = new PngViewOptions("output.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PNG](/viewer/java/images/rendering-basics/render-images/render-image-to-png.png)

## Convert images to JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an image to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("vector-image.svg")) {
    // Create a JPG image for the letter.
    JpgViewOptions viewOptions = new JpgViewOptions("output.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Render a PSD file with custom fonts

When you render a PSD file with custom fonts, you can specify a folder that contains necessary fonts to prevent font substitution during rendering. To do this, follow the steps below:

1. Create a [FolderFontSource](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/folderfontsource) class instance and specify a path to the folder that stores custom fonts. Pass a [SearchOption](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/searchoption) enumeration member to the class constructor to define the search scope. The following options are available:
    * `TOP_FOLDER_ONLY`---Searches for the fonts only in the current folder.
    * `ALL_FOLDERS`---Searches for the fonts in the current folder and its subfolders.

2. Call the [FontSettings.setFontSources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.fonts/fontsettings/#setFontSources-com.groupdocs.viewer.fonts.FontSource...-) static method and pass the specified font source to this method as a parameter. This method allows you to specify multiple font sources.

You can also use the [ViewOptions.setDefaultFontName](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setDefaultFontName-java.lang.String-) method to specify the default font that should be used when a particular font is not found.

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.viewer.Fonts;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

// Create font sources.
// Add custom fonts folder to look for fonts recursively. (look into subfolders too).
FolderFontSource folderFontSource = new FolderFontSource("C:\\custom_fonts_folder", SearchOption.ALL_FOLDERS);
// Add custom fonts folder to look for fonts only in this folder (wihout subfolders).
FolderFontSource additionalFontSource = new FolderFontSource("C:\\custom_additional_fonts_folder", SearchOption.TOP_FOLDER_ONLY);
// Call SetFontSources method and supply font sources as arguments.
FontSettings.setFontSources(folderFontSource, additionalFontSource);

try (Viewer viewer = new Viewer("sample.psd")) {
    JpgViewOptions options = new JpgViewOptions("output.jpg");
    options.setDefaultFontName("Arial");

    viewer.view(options);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Render images as HTML, PDF, PNG, and JPEG files

Path: /viewer/nodejs-java/render-images/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to load images in various formats and convert them to HTML, PDF, PNG, and JPEG. Incorporate this library into your Java application (web or desktop) to build your own image viewer.

To start with the GroupDocs.Viewer API, create a [Viewer](#) class instance. Pass an image you want to view to the class constructor. You can load the image from a file or stream. Call one of the [Viewer.view](#) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. For multipage images (such as TIFF, CDR, DICOM, WebP, and so on), you can specify the pages to render.

{{< button style="primary" link="https://products.groupdocs.app/viewer/image" >}} {{< icon "gdoc_person" >}} View image files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported image file formats

GroupDocs.Viewer supports the following image file formats:

* [.AI (Adobe Illustrator Artwork)](https://docs.fileformat.com/image/ai/)
* [.APNG (Animated Portable Network Graphic)](https://docs.fileformat.com/image/apng/)
* [.BMP (Bitmap Image)](https://docs.fileformat.com/image/bmp)
* [.CDR (CorelDRAW Image File)](https://docs.fileformat.com/image/cdr)
* [.CGM (Computer Graphics Metafile)](https://docs.fileformat.com/page-description-language/cgm)
* [.CMX (Corel Presentation Exchange Image)](https://docs.fileformat.com/image/cmx)
* [.DCM (DICOM Image)](https://docs.fileformat.com/image/dicom)
* [.DIB (Device Independent Bitmap File)](https://docs.fileformat.com/image/dib)
* [.DJVU (DjVu Image)](https://docs.fileformat.com/image/djvu)
* [.DNG (Digital Negative Image)](https://docs.fileformat.com/image/dng)
* [.EMF (Enhanced Windows Metafile)](https://docs.fileformat.com/image/emf)
* [.EMZ (Windows Compressed Enhanced Metafile)](https://docs.fileformat.com/image/emz/)
* [.EPS (Encapsulated PostScript File)](https://docs.fileformat.com/page-description-language/eps)
* [.FODG (OpenDocument Flat XML Graphics)](https://docs.fileformat.com/image/fodg/)
* [.GIF (Graphical Interchange Format)](https://docs.fileformat.com/image/gif)
* [.ICO (Icon File)](https://docs.fileformat.com/image/ico)
* [.J2C (JPEG 2000 Code Stream)](https://docs.fileformat.com/image/j2c/)
* [.J2K (JPEG 2000 Image)](https://docs.fileformat.com/image/j2k/)
* [.JP2 (JPEG 2000 Core Image File)](https://docs.fileformat.com/image/jp2/)
* [.JPC (JPEG 2000 Code Stream File)](https://docs.fileformat.com/image/jpc/)
* [.JPEG / .JPG (JPEG Image)](https://docs.fileformat.com/image/jpeg)
* [.JPF (JPEG 2000 Image)](https://docs.fileformat.com/image/jpf/)
* [.JPM (JPEG 2000 Multi-layer Image Format)](https://docs.fileformat.com/image/jpm/)
* [.JPX (JPEG 2000 Image File)](https://docs.fileformat.com/image/jpx/)
* [.JLS (JPEG-LS Image)](https://docs.fileformat.com/)
* [.ODG (OpenDocument Graphics File)](https://docs.fileformat.com/image/odg)
* [.OTG (OpenDocument Graphic Template)](https://docs.fileformat.com/image/otg/)
* [.PCL (Printer Command Language Document)](https://docs.fileformat.com/page-description-language/pcl)
* [.PNG (Portable Network Graphics)](https://docs.fileformat.com/image/png)
* [.PS (PostScript File)](https://docs.fileformat.com/page-description-language/ps)
* [.PSB (Photoshop Large Document Format)](https://docs.fileformat.com/image/psb)
* [.PSD (Adobe Photoshop Document)](https://docs.fileformat.com/image/psd)
* [.SVG (Scalable Vector Graphics File)](https://docs.fileformat.com/page-description-language/svg)
* [.SVGZ (Compressed SVG File)](https://docs.fileformat.com/image/svgz/)
* [.TGA (TARGA Graphics)](https://docs.fileformat.com/image/tga/) 
* [.TIF / .TIFF (Tagged Image File Format)](https://docs.fileformat.com/image/tiff)
* [.WEBP (WebP Image)](https://docs.fileformat.com/image/webp)
* [.WMF (Windows Metafile)](https://docs.fileformat.com/image/wmf)
* [.WMZ (Compressed Windows Metafile)](https://docs.fileformat.com/image/wmz/)

## Render images as HTML

Create an [HtmlViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert an image to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an image in an HTML page, call the [HtmlViewOptions.forEmbeddedResources](#) method and specify the output file name.

{{< tabs "render-image-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("vector-image.svg")
// Specify the HTML file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-image-to-html-embedded/svg-to-html.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to HTML](/viewer/nodejs-java/images/rendering-basics/render-images/render-image-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an image to a separate folder, call the [HtmlViewOptions.forExternalResources](#) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-image-to-html-external">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("vector-image.svg")
// Specify the HTML file name and location of external resources.
// {0} is replaced with the resource name in the output file name.
const viewOptions = HtmlViewOptions.forExternalResources("render-image-to-html-external/svg-to-html.html", "render-image-to-html-external/svg-to-html/resource_{0}", "render-image-to-html-external/svg-to-html/resource_{0}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The result is shown below. The image is placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-images/render-image-to-html-external-resources.png)

## Render images as PDF

Create a [PdfViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert an image to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-image-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("vector-image.svg")
// Create a PDF file.
const viewOptions = PdfViewOptions("render-image-to-pdf/svg-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PDF](/viewer/nodejs-java/images/rendering-basics/render-images/render-image-to-pdf.png)

## Convert images to PNG

Create a [PngViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert an image to PNG. Use the [PngViewOptions.setHeight](#) and [PngViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-image-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("vector-image.svg")
// Create a PNG image.
const viewOptions = PngViewOptions("render-image-to-png/svg-to-png.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PNG](/viewer/nodejs-java/images/rendering-basics/render-images/render-image-to-png.png)

## Convert images to JPEG

Create a [JpgViewOptions](#) class instance and pass it to the [Viewer.view](#) method to convert an image to JPEG. Use the [JpgViewOptions.setHeight](#) and [JpgViewOptions.setWidth](#) methods to specify the output image size in pixels.

{{< tabs "render-image-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("vector-image.svg")
// Create a JPG image for the letter.
const viewOptions = JpgViewOptions("render-image-to-jpeg/svg-to-jpg.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render a PSD file with custom fonts

When you render a PSD file with custom fonts, you can specify a folder that contains necessary fonts to prevent font substitution during rendering. To do this, follow the steps below:

1. Create a [FolderFontSource](#) class instance and specify a path to the folder that stores custom fonts. Pass a [SearchOption](#) enumeration member to the class constructor to define the search scope. The following options are available:
    * `TOP_FOLDER_ONLY`---Searches for the fonts only in the current folder.
    * `ALL_FOLDERS`---Searches for the fonts in the current folder and its subfolders.

2. Call the [FontSettings.setFontSources](#) static method and pass the specified font source to this method as a parameter. This method allows you to specify multiple font sources.

You can also use the [ViewOptions.setDefaultFontName](#) method to specify the default font that should be used when a particular font is not found.

{{< tabs "render-psd-with-custom-fonts">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions, FolderFontSource, SearchOption, FontSettings } from '@groupdocs/groupdocs.viewer';

// Create font sources.
// Add custom fonts folder to look for fonts recursively. (look into subfolders too).
const folderFontSource = new FolderFontSource("C:/custom_fonts_folder", SearchOption.ALL_FOLDERS);
// Add custom fonts folder to look for fonts only in this folder (wihout subfolders).
const additionalFontSource = new FolderFontSource("C:/custom_additional_fonts_folder", SearchOption.TOP_FOLDER_ONLY);
// Call SetFontSources method and supply font sources as arguments.
FontSettings.setFontSources(folderFontSource, additionalFontSource);
const viewer = new Viewer("sample.psd")

// Create a JPG image for the letter.
const viewOptions = JpgViewOptions("render-psd-with-custom-fonts/psd-to-jpg.jpg")
viewOptions.setDefaultFontName("Arial")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.psd" >}}
{{< tab-text >}}
`sample.psd` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-images/sample.psd) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Render images as HTML, PDF, PNG, and JPEG files

Path: /viewer/python-net/render-images/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to load images in various formats and convert them to HTML, PDF, PNG, and JPEG. Incorporate this library into your Python application (web or desktop) to build your own image viewer.

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass an image you want to view to the class constructor. You can load the image from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. For multipage images (such as TIFF, CDR, DICOM, WebP, and so on), you can specify the pages to render.

{{< button style="primary" link="https://products.groupdocs.app/viewer/image" >}} {{< icon "gdoc_person" >}} View image files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-Python" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported image file formats

GroupDocs.Viewer supports the following image file formats:

* [.AI (Adobe Illustrator Artwork)](https://docs.fileformat.com/image/ai/)
* [.APNG (Animated Portable Network Graphic)](https://docs.fileformat.com/image/apng/)
* [.BMP (Bitmap Image)](https://docs.fileformat.com/image/bmp)
* [.CDR (CorelDRAW Image File)](https://docs.fileformat.com/image/cdr)
* [.CGM (Computer Graphics Metafile)](https://docs.fileformat.com/page-description-language/cgm)
* [.CMX (Corel Presentation Exchange Image)](https://docs.fileformat.com/image/cmx)
* [.DCM (DICOM Image)](https://docs.fileformat.com/image/dicom)
* [.DIB (Device Independent Bitmap File)](https://docs.fileformat.com/image/dib)
* [.DJVU (DjVu Image)](https://docs.fileformat.com/image/djvu)
* [.DNG (Digital Negative Image)](https://docs.fileformat.com/image/dng)
* [.EMF (Enhanced Windows Metafile)](https://docs.fileformat.com/image/emf)
* [.EMZ (Windows Compressed Enhanced Metafile)](https://docs.fileformat.com/image/emz/)
* [.EPS (Encapsulated PostScript File)](https://docs.fileformat.com/page-description-language/eps)
* [.FODG (OpenDocument Flat XML Graphics)](https://docs.fileformat.com/image/fodg/)
* [.GIF (Graphical Interchange Format)](https://docs.fileformat.com/image/gif)
* [.ICO (Icon File)](https://docs.fileformat.com/image/ico)
* [.J2C (JPEG 2000 Code Stream)](https://docs.fileformat.com/image/j2c/)
* [.J2K (JPEG 2000 Image)](https://docs.fileformat.com/image/j2k/)
* [.JP2 (JPEG 2000 Core Image File)](https://docs.fileformat.com/image/jp2/)
* [.JPC (JPEG 2000 Code Stream File)](https://docs.fileformat.com/image/jpc/)
* [.JPEG / .JPG (JPEG Image)](https://docs.fileformat.com/image/jpeg)
* [.JPF (JPEG 2000 Image)](https://docs.fileformat.com/image/jpf/)
* [.JPM (JPEG 2000 Multi-layer Image Format)](https://docs.fileformat.com/image/jpm/)
* [.JPX (JPEG 2000 Image File)](https://docs.fileformat.com/image/jpx/)
* [.JLS (JPEG-LS Image)](https://docs.fileformat.com/)
* [.ODG (OpenDocument Graphics File)](https://docs.fileformat.com/image/odg)
* [.OTG (OpenDocument Graphic Template)](https://docs.fileformat.com/image/otg/)
* [.PCL (Printer Command Language Document)](https://docs.fileformat.com/page-description-language/pcl)
* [.PNG (Portable Network Graphics)](https://docs.fileformat.com/image/png)
* [.PS (PostScript File)](https://docs.fileformat.com/page-description-language/ps)
* [.PSB (Photoshop Large Document Format)](https://docs.fileformat.com/image/psb)
* [.PSD (Adobe Photoshop Document)](https://docs.fileformat.com/image/psd)
* [.SVG (Scalable Vector Graphics File)](https://docs.fileformat.com/page-description-language/svg)
* [.SVGZ (Compressed SVG File)](https://docs.fileformat.com/image/svgz/)
* [.TGA (TARGA Graphics)](https://docs.fileformat.com/image/tga/) 
* [.TIF / .TIFF (Tagged Image File Format)](https://docs.fileformat.com/image/tiff)
* [.WEBP (WebP Image)](https://docs.fileformat.com/image/webp)
* [.WMF (Windows Metafile)](https://docs.fileformat.com/image/wmf)
* [.WMZ (Compressed Windows Metafile)](https://docs.fileformat.com/image/wmz/)

## Render images as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an image in an HTML page, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_image_to_html():
    # Load image
    with Viewer("vector-image.svg") as viewer:
        # Specify the HTML file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_image_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_image_to_html()
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to HTML](/viewer/python-net/images/rendering-basics/render-images/render-image-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an image to a separate folder, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_image_to_html_external():
    # Load image
    with Viewer("vector-image.svg") as viewer:
        # Specify the HTML file name and location of external resources.
        # {0} is replaced with the resource name in the output file name.
        viewOptions = HtmlViewOptions.for_external_resources("render_image_to_html_external/pdf_page_{0}.html", "render_image_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_image_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_image_to_html_external()
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The result is shown below. The image is placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-images/render-image-to-html-external-resources.png)

## Render images as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_image_to_pdf():
    # Load image
    with Viewer("vector-image.svg") as viewer:
        # Create a PDF file.
        viewOptions = PdfViewOptions("render_image_to_pdf/pdf_document.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_image_to_pdf()
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PDF](/viewer/python-net/images/rendering-basics/render-images/render-image-to-pdf.png)

## Convert images to PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties)) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_image_to_png():
    # Load image
    with Viewer("vector-image.svg") as viewer:
        # Create a PNG image.
        viewOptions = PngViewOptions("render_image_to_png/image.png")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 550
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_image_to_png()
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PNG](/viewer/python-net/images/rendering-basics/render-images/render-image-to-png.png)

## Convert images to JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an image to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_image_to_jpg():
    # Load image
    with Viewer("vector-image.svg") as viewer:
        # Create a JPG image.
        viewOptions = JpgViewOptions("render_image_to_jpg/image_to_jpg.jpg")
        # Set width and height.
        viewOptions.width = 950
        viewOptions.height = 550
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_image_to_jpg()
```
{{< /tab >}}
{{< tab "vector-image.svg" >}}
{{< tab-text >}}
`vector-image.svg` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-images/vector-image.svg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render a PSD file with custom fonts

When you render a PSD file with custom fonts, you can specify a folder that contains necessary fonts to prevent font substitution during rendering. To do this, follow the steps below:

1. Create a [FolderFontSource](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.fonts/folderfontsource/) class instance and specify a path to the folder that stores custom fonts. Pass a [SearchOption](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.fonts/folderfontsource/#properties) enumeration member to the class constructor to define the search scope. The following options are available:
    * `TOP_FOLDER_ONLY`---Searches for the fonts only in the current folder.
    * `ALL_FOLDERS`---Searches for the fonts in the current folder and its subfolders.

2. Call the [FontSettings.set_font_sources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.fonts/fontsettings/#methods) static method and pass the specified font source to this method as a parameter. This method allows you to specify multiple font sources.

You can also use the [ViewOptions.default_font_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/viewoptions/) method to specify the default font that should be used when a particular font is not found.

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
import os
from groupdocs.viewer import Viewer
from groupdocs.viewer.fonts import FolderFontSource, SearchOption, FontSettings
from groupdocs.viewer.options import JpgViewOptions

def render_psd_with_custom_fonts():
    # Create font sources.
    os.makedirs("./custom_fonts_folder", exist_ok=True)
    os.makedirs("./custom_additional_fonts_folder", exist_ok=True)

    # Add custom fonts folder to look for fonts recursively. (look into subfolders too).
    folderFontSource = [FolderFontSource("./custom_fonts_folder", SearchOption.ALL_FOLDERS)]
    # Add custom fonts folder to look for fonts only in this folder (without subfolders).
    additionalFontSource = [FolderFontSource("./custom_additional_fonts_folder", SearchOption.TOP_FOLDER_ONLY)]
    # Call SetFontSources method and supply font sources as arguments.
    FontSettings.set_font_sources(folderFontSource, additionalFontSource)

    # Load PSD file
    with Viewer("sample.psd") as viewer:
        # Create a JPG image.
        viewOptions = JpgViewOptions("render_psd_with_custom_fonts/psd_with_custom_fonts.jpg")
        viewOptions.default_font_name = "Arial"
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_psd_with_custom_fonts()
```
{{< /tab >}}
{{< tab "sample.psd" >}}
{{< tab-text >}}
`sample.psd` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-images/sample.psd) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Sign document with QR-code signature - advanced

Path: /signature/java/sign-document-with-qr-code-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) class to specify additional options for QR-code signature with following signature appearance

*   signature alignment
*   margins
*   border and background settings
*   font and colors

Here are the steps to add QR-code signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class and pass source document path or stream as a constructor parameter.
*   Instantiate the [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) object with all required additional options.
*   Call [sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20java.util.List)) method of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/Signature) class instance and pass [QrCodeSignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/QrCodeSignOptions) to it.
*   Analyze [SignResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.
    

This example shows how to add QR-Code signature to document.

```java
 Signature signature = new Signature("sample.xlsx");
// create QRCode option with predefined QRCode text
QrCodeSignOptions signOptions = new QrCodeSignOptions("12345678");
 
// setup QRCode encoding type
signOptions.setEncodeType(QrCodeTypes.QR);
// set signature position
signOptions.setLeft(100);
signOptions.setTop(100);
 
// set signature alignment
 
// when VerticalAlignment is set the Top coordinate will be ignored.
// Use Margin properties Top, Bottom to provide vertical offset
signOptions.setVerticalAlignment(VerticalAlignment.Top);
 
// when HorizontalAlignment is set the Left coordinate will be ignored.
// Use Margin properties Left, Right to provide horizontal offset
signOptions.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setRight(20);
padding.setTop(20);
signOptions.setMargin(padding);
 
// adjust signature appearance
 
// setup signature border
Border border = new Border();
border.setColor(Color.GREEN);
border.setDashStyle(DashStyle.DashLongDashDot);
border.setWeight(2);
border.setTransparency(0.5);
border.setVisible(true);
signOptions.setBorder(border);
 
// set text color and Font
signOptions.setForeColor(Color.RED);
SignatureFont font = new SignatureFont();
font.setSize(12);
font.setFamilyName("Comic Sans MS");
signOptions.setFont(font);
 
// setup background
Background background = new Background();
background.setColor(Color.GREEN);
background.setTransparency(0.5);
background.setBrush(new LinearGradientBrush(Color.GREEN, Color.DARK_GRAY, 0));
signOptions.setBackground(background);
 
// sign document to file
SignResult signResult = signature.sign("sampleSigned.xlsx", signOptions);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**. E

---

## User roles

Path: /annotation/net/apply-roles/


GroupDocs.Annotation v22.11 and later allows you to specify a user role for each user.

You can specify a [User](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models/user/) object for any reply. This object represents the author of the reply. You can also set a role of the user:
- Viewer - GroupDocs.Annotation does not add their replies to the document.
- Editor - GroupDocs.Annotation adds their replies. 
Use this feature to control if a user can or cannot add comments to the document.

The following code snippet shows how to add a user role: 

{{< tabs "example1">}}
{{< tab "C#" >}} 
```csharp

using (Annotator annotator = new Annotator("input.pdf-file"))
{
  AreaAnnotation area = new AreaAnnotation
  {
    BackgroundColor = 65535,
    Box = new Rectangle(100, 100, 100, 100),
    CreatedOn = DateTime.Now,
    Message = "This is area annotation",
    Opacity = 0.7,
    PageNumber = 0,
    Replies = new List<Reply>
    {
        new Reply 
        {
            Comment = "This comment will be applied",
            RepliedOn = DateTime.Now,
            User = new User(1, "Reviewer", Role.Editor)
        },
        new Reply
        {
            Comment = "This comment will NOT be applied",
            RepliedOn = DateTime.Now,
            User = new User(1, "Member", Role.Viewer)
        }
    }
  };

  annotator.Add(area);
  annotator.Save("result_export");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Advanced search for Metadata signatures

Path: /signature/java/advanced-search-for-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to search Metadata signatures and convert obtained values to various data types.

Here are the steps to search for Metadata signature and obtain required data type with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/net/signature/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
    
*   Create objects of [MetadataSearchOptions](https://reference.groupdocs.com/net/signature/groupdocs.signature.options/metadatasearchoptions) class  
    
*   Call [Search](https://reference.groupdocs.com/net/signature/groupdocs.signature/signature/methods/search/_1) method of [Signature](https://reference.groupdocs.com/net/signature/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/net/signature/groupdocs.signature.options/metadatasearchoptions)  to it.
    
*   Call proper conversion method to obtain corresponding Metadata value to required data type.

## Search for electronic Metadata signature values with various data type

This example shows how to search for Metadata signature values with various data types.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    // search for signatures in document
    List<PdfMetadataSignature> signatures = signature.Search<PdfMetadataSignature>(SignatureType.Metadata);
    // try to get each Pdf signature with proper data type added in Basic usage example SignPdfWithMetadata             
    PdfMetadataSignature mdSignature;
    // See example SignPdfWithMetadata with added various data type values to signatures
    try
    {
        mdSignature = signatures.FirstOrDefault(p => p.Name == "Author");
        Console.WriteLine($"\t[{mdSignature.Name}] as String = {mdSignature.ToString()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "CreatedOn");
        Console.WriteLine($"\t[{mdSignature.Name}] as String = {mdSignature.ToDateTime().ToShortDateString()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "DocumentId");
        Console.WriteLine($"\t[{mdSignature.Name}] as Integer = {mdSignature.ToInteger()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "SignatureId");
        Console.WriteLine($"\t[{mdSignature.Name}] as Double = {mdSignature.ToDouble()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "Amount");
        Console.WriteLine($"\t[{mdSignature.Name}] as Decimal = {mdSignature.ToDecimal()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "Total");
        Console.WriteLine($"\t[{mdSignature.Name}] as Float = {mdSignature.ToSingle()}");
    }
    catch (Exception ex)
    {
        Helper.WriteError($"Error obtaining signature: {ex.Message}");
    }
}
```

## More resources
### GitHub Examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)     
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)    
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)    

### Free Online App 
Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.
---

## Advanced search for Metadata signatures

Path: /signature/net/advanced-search-for-metadata-signatures/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides ability to search Metadata signatures and convert obtained values to various data types.

Here are the steps to search for Metadata signature and obtain required data type with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path or stream as a constructor parameter.
* Create objects of [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions) class
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [MetadataSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/metadatasearchoptions)  to it.
* Call proper conversion method to obtain corresponding Metadata value to required data type.

## Search for electronic Metadata signature values with various data type

This example shows how to search for Metadata signature values with various data types.

```csharp
using (Signature signature = new Signature("signed.pdf"))
{
    // search for signatures in document
    List<PdfMetadataSignature> signatures = signature.Search<PdfMetadataSignature>(SignatureType.Metadata);
    // try to get each Pdf signature with proper data type added in Basic usage example SignPdfWithMetadata
    PdfMetadataSignature mdSignature;
    // See example SignPdfWithMetadata with added various data type values to signatures
    try
    {
        mdSignature = signatures.FirstOrDefault(p => p.Name == "Author");
        Console.WriteLine($"\t[{mdSignature.Name}] as String = {mdSignature.ToString()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "CreatedOn");
        Console.WriteLine($"\t[{mdSignature.Name}] as String = {mdSignature.ToDateTime().ToShortDateString()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "DocumentId");
        Console.WriteLine($"\t[{mdSignature.Name}] as Integer = {mdSignature.ToInteger()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "SignatureId");
        Console.WriteLine($"\t[{mdSignature.Name}] as Double = {mdSignature.ToDouble()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "Amount");
        Console.WriteLine($"\t[{mdSignature.Name}] as Decimal = {mdSignature.ToDecimal()}");
        mdSignature = signatures.FirstOrDefault(p => p.Name == "Total");
        Console.WriteLine($"\t[{mdSignature.Name}] as Float = {mdSignature.ToSingle()}");
    }
    catch (Exception ex)
    {
        Helper.WriteError($"Error obtaining signature: {ex.Message}");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add strikeout annotation

Path: /annotation/java/add-strikeout-annotation/

Strikeout annotation strike-throughs a text fragment as shown in the picture below:

![](/annotation/java/images/add-strikeout-annotation.png)

You can use the following methods to set the properties of the [StrikeoutAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/strikeoutannotation) class:

*   [setFontColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/strikeoutannotation/#setFontColor-java.lang.Integer-) defines the color of the annotation text
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/strikeoutannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPoints()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/strikeoutannotation/#setPoints-java.util.List-com.groupdocs.annotation.models.Point--) defines the annotation positions as array of points 
      

To add a strikeout annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [StrikeoutAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/strikeoutannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [StrikeoutAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/strikeoutannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.  

  
The following code snippet shows how to add [StrikeoutAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/strikeoutannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding text strikeout annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    Point point1 = new Point(80, 730);
    Point point2 = new Point(240, 730);
    Point point3 = new Point(80, 650);
    Point point4 = new Point(240, 650);

    List<Point> points = new ArrayList<Point>();
    points.add(point1);
    points.add(point2);
    points.add(point3);
    points.add(point4);

    // Create an instance of StrikeoutAnnotation class and set options
    StrikeoutAnnotation strikeout = new StrikeoutAnnotation();
    strikeout.setCreatedOn(Calendar.getInstance().getTime());
    strikeout.setFontColor(65535);
    strikeout.setMessage("This is strikeout annotation");
    strikeout.setOpacity(0.7);
    strikeout.setPageNumber(0);
    strikeout.setPoints(points);
    strikeout.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(strikeout);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add strikeout annotation

Path: /annotation/net/add-strikeout-annotation/

Strikeout annotation strike-throughs a text fragment as shown in the picture below:

![](/annotation/net/images/add-strikeout-annotation.png)

You can specify the following properties of the [StrikeoutAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/strikeoutannotation) class:

*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/strikeoutannotation/properties/fontcolor) defines the color of the annotation text
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/areaannotation/properties/opacity) allows you to set the annotation opacity
*   [Points](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/strikeoutannotation/properties/points) defines the annotation positions as array of points 
      

To add a strikeout annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [StrikeoutAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/strikeoutannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [StrikeoutAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/strikeoutannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.  

  
The following code snippet shows how to add [StrikeoutAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/strikeoutannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add strikeout annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	StrikeoutAnnotation strikeout = new StrikeoutAnnotation
    {
    	CreatedOn = DateTime.Now,
        FontColor = 65535,
        BackgroundColor = 16761035,
        Message = "This is strikeout annotation",
        Opacity = 0.7,
        PageNumber = 0,
        Points = new List<Point>
        {
        	new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650)
        },
        Replies = new List<Reply>
        {
        	new Reply
            {
             	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
     };
     annotator.Add(strikeout);
     annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Compare bookmarks in Word documents

Path: /comparison/java/compare-bookmarks-in-word/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare bookmarks in the Word documents.

To compare bookmarks in the Word documents, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/) object. Specify the source file path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object. Set the [CompareBookmarks](https://reference.groupdocs.com/comparison/java/groupdocs.comparison.options/compareoptions/properties/comparebookmarks) property to `true`.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object from the previous step.

The following code snippet shows how to demonstrate how to compare bookmarks:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");

    CompareOptions compareOptions = new CompareOptions();
    compareOptions.setCompareBookmarks(true);
    final Path resultPath = comparer.compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result of compared bookmarks is as follows:

![](/comparison/java/images/compared-bookmarks.png)

---

## Compare bookmarks in Word documents

Path: /comparison/net/compare-bookmarks-in-word/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare bookmarks in the Word documents.

To compare bookmarks in the Word documents, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify the source file path or stream.
2.  Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/add/index) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. Set the [CompareBookmarks](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/comparebookmarks) property to `true`.
4.  Call the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how to demonstrate how to compare bookmarks:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");

    comparer.Compare("result.docx", new CompareOptions {
        CompareBookmarks = true
    });
}
```
{{< /tab >}}
{{< /tabs >}}

The result of compared bookmarks is as follows:

![](/comparison/net/images/compared-bookmarks.png)

---

## Compare bookmarks in Word documents

Path: /comparison/nodejs-java/compare-bookmarks-in-word/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare bookmarks in Word documents.

The following code snippet shows how to demonstrate how to compare bookmarks:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target and output documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document that will be compared against the source
comparer.add(targetPath);

// Create comparison options object to customize the comparison behavior
const compareOptions = new groupdocs.CompareOptions();

// Enable comparison of bookmarks during the process
compareOptions.setCompareBookmarks(true);

// Execute the comparison and save the result to the specified output file
comparer.compare(outputPath, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example initializes a `Comparer` with the source document, adds the target document, and creates a `CompareOptions` object. It enables bookmark comparison by setting `setCompareBookmarks(true)`, then performs the comparison with these options. This ensures that bookmarks in both documents are compared and any differences are highlighted in the result document.

The result of compared bookmarks is as follows:

![](/comparison/nodejs-java/images/compared-bookmarks.png)

---

## Compare bookmarks in Word documents

Path: /comparison/python-net/compare-bookmarks-in-word/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) supports bookmark comparison in Word documents.

## Enable bookmark comparison

Turn on bookmark comparison to detect differences in bookmarked ranges.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.compare_bookmarks = True
    comparer.compare("result.docx", options)
```

🔹 Use case: Validate that critical bookmarked sections (e.g., clauses) remain unchanged.

The result is as follows:

![](/comparison/python-net/images/compared-bookmarks.png)



---

## Enabling inline CSS styles

Path: /editor/java/inline-styles/

In the GroupDocs.Editor, the editing operation implies that the source document is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instance, and this instance can emit HTML- and CSS-markup to be placed in the client-side WYSIWYG-editor, then end-user edits this document in the web-browser, and finally document is saved — this implies converting document content from HTML/CSS back to the original (or some other) format.

Prior to the [version 24.4](https://releases.groupdocs.com/editor/java/release-notes/2024/groupdocs-editor-for-java-24-4-release-notes/) of the GroupDocs.Editor the HTML-version of a document, which is obtained from [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) class, the CSS styles were placed in the external stylesheet file “style.css”. HTML file in this case contains a reference to the external stylesheet. And there was no possibility to change the location of CSS styles.

[Version 24.4](https://releases.groupdocs.com/editor/java/release-notes/2024/groupdocs-editor-for-java-24-4-release-notes/) of GroupDocs.Editor introduces a new option — an ability to enable the “inline styles” mode for all of the documents, which belong to the [family of WordProcessing formats](https://docs.fileformat.com/word-processing/). In this mode only [WordProcessing styles are exported to the external stylesheet](https://docs.groupdocs.com/editor/java/styles-export/), while all other styles — text and paragraph formatting, list and table settings, — are exported directly to the HTML markup. They became _inline CSS styles_, which means that in this case the styles are saved in the [“style” HTML attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/style) for every HTML element. As a result, an HTML document, generated with enabled inline styles option, has larger HTML-markup and lesser CSS-markup, compared to the one, where this option is disabled.

The inline styles option is represented as a public property of the [`Boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) type in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/) class. By default it is disabled (`false`), so the GroupDocs.Editor will act in the same behavior, as its previous versions.

```java
public final boolean getUseInlineStyles()
public final void setUseInlineStyles(boolean value)
```
The example below shows opening and editing a single WordProcessing document twice: first one in default style, and then with enabled inline styles.

```java
// Obtain a valid full path to the existing WordProcessing file
String inputPath = "SampleDoc.docx";

// Create default edit options, where all styles are external
WordProcessingEditOptions editOptionsExternalStyles = new WordProcessingEditOptions();

//Create custom edit options, where most of styles are inline
WordProcessingEditOptions editOptionsInlineStyles = new WordProcessingEditOptions();
// Enable inline styles in this instance
editOptionsInlineStyles.setUseInlineStyles(true);

// Create instance of the Editor class and load a document
Editor editor = new Editor(inputPath);
{
	// Get editable document instance, where all styles are external 
	EditableDocument docWithExternalStyles = editor.edit(editOptionsExternalStyles);

	// Get editable document instance, where most of styles are inline
	EditableDocument docWithInlineStyles = editor.edit(editOptionsInlineStyles);

	// Get only HTML-markup, where all styles are external
	String htmlMarkupExternal = docWithExternalStyles.getContent();

	// Get only HTML-markup, where most of styles are inline
	String htmlMarkupInline = docWithInlineStyles.getContent();

}

```

Need to emphasize that no matter where the CSS styles are located — inside the HTML-markup or in the external file, — the final representation of the HTML-document in the web-browser will be identical.

Also please take into account that this feature exists only for the WordProcessing formats family.
---

## Enabling inline CSS styles

Path: /editor/net/inline-styles/

In the GroupDocs.Editor, the editing operation implies that the source document is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, and this instance can emit HTML- and CSS-markup to be placed in the client-side WYSIWYG-editor, then end-user edits this document in the web-browser, and finally document is saved — this implies converting document content from HTML/CSS back to the original (or some other) format.

Prior to the [version 23.8](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-8-release-notes/) of the GroupDocs.Editor the HTML-version of a document, which is obtained from [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, the CSS styles were placed in the external stylesheet file “style.css”. HTML file in this case contains a reference to the external stylesheet. And there was no possibility to change the location of CSS styles.

[Version 23.8](https://releases.groupdocs.com/editor/net/release-notes/2023/groupdocs-editor-for-net-23-8-release-notes/) of GroupDocs.Editor introduces a new option — an ability to enable the “inline styles” mode for all of the documents, which belong to the [family of WordProcessing formats](https://docs.fileformat.com/word-processing/). In this mode only [WordProcessing styles are exported to the external stylesheet](https://docs.groupdocs.com/editor/net/styles-export/), while all other styles — text and paragraph formatting, list and table settings, — are exported directly to the HTML markup. They became _inline CSS styles_, which means that in this case the styles are saved in the [“style” HTML attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/style) for every HTML element. As a result, an HTML document, generated with enabled inline styles option, has larger HTML-markup and lesser CSS-markup, compared to the one, where this option is disabled.

The inline styles option is represented as a public property of the [`System.Boolean`](https://learn.microsoft.com/en-us/dotnet/api/system.boolean) type in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class. By default it is disabled (`false`), so the GroupDocs.Editor will act in the same behavior, as its previous versions.

```csharp
public bool UseInlineStyles { get; set; }
```
The example below shows opening and editing a single WordProcessing document twice: first one in default style, and then with enabled inline styles.

```csharp
// Obtain a valid full path to the existing WordProcessing file
string inputPath = "SampleDoc.docx";

// Create default edit options, where all styles are external
WordProcessingEditOptions editOptionsExternalStyles = new WordProcessingEditOptions();

//Create custom edit options, where most of styles are inline
WordProcessingEditOptions editOptionsInlineStyles = new WordProcessingEditOptions();
// Enable inline styles in this instance
editOptionsInlineStyles.UseInlineStyles = true;

// Create instance of the Editor class and load a document
using (Editor editor = new Editor(inputPath))
{
	// Get editable document instance, where all styles are external 
	EditableDocument docWithExternalStyles = editor.Edit(editOptionsExternalStyles);

	// Get editable document instance, where most of styles are inline
	EditableDocument docWithInlineStyles = editor.Edit(editOptionsInlineStyles);

	// Get only HTML-markup, where all styles are external
	string htmlMarkupExternal = docWithExternalStyles.GetContent();

	// Get only HTML-markup, where most of styles are inline
	string htmlMarkupInline = docWithInlineStyles.GetContent();

	// Make sure that HTML-markup with inline styles is bigger
	Assert.Greater(htmlMarkupInline.Length, htmlMarkupExternal.Length);
}

```

Need to emphasize that no matter where the CSS styles are located — inside the HTML-markup or in the external file, — the final representation of the HTML-document in the web-browser will be identical.

Also please take into account that this feature exists only for the WordProcessing formats family.
---

## Enabling Inline CSS Styles

Path: /editor/nodejs-java/inline-styles/


In GroupDocs.Editor for Node.js via Java, the editing operation involves converting the source document into an [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/EditableDocument) instance. This instance can emit HTML and CSS markup to be placed in a client-side WYSIWYG editor. The end-user edits the document in a web browser, and finally, the document is saved—implying a conversion of the document content from HTML/CSS back to the original (or another) format.

Prior to [version 24.4](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node-js-via-java-24-4-release-notes/) of GroupDocs.Editor for Node.js via Java, the HTML version of a document obtained from the `EditableDocument` class placed CSS styles in an external stylesheet file named `style.css`. The HTML file contained a reference to this external stylesheet, and there was no option to change the location of CSS styles.

Starting with [version 24.4](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node-js-via-java-24-4-release-notes/), GroupDocs.Editor introduces a new option—enabling the "inline styles" mode for all documents belonging to the [family of WordProcessing formats](https://docs.fileformat.com/word-processing/). In this mode, only WordProcessing styles are exported to the external stylesheet, while all other styles—text and paragraph formatting, list and table settings—are exported directly into the HTML markup. They become _inline CSS styles_, meaning the styles are saved in the [`style` HTML attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/style) for each HTML element. As a result, an HTML document generated with the inline styles option enabled has larger HTML markup and a smaller CSS file compared to when this option is disabled.

The inline styles option is represented as a public property of the `Boolean` type in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/WordProcessingEditOptions) class. By default, it is disabled (`false`), so GroupDocs.Editor will behave the same as in previous versions unless you enable it.

```javascript
// Getter and Setter for useInlineStyles
public boolean getUseInlineStyles()
public void setUseInlineStyles(boolean value)
```

The example below shows how to open and edit a WordProcessing document twice: first with the default setting (external styles) and then with the inline styles option enabled.

```javascript
// Import necessary modules
const groupdocs_editor = require('groupdocs-editor');

// Obtain a valid full path to the existing WordProcessing file
const inputPath = "SampleDoc.docx";

// Create default edit options, where all styles are external
const editOptionsExternalStyles = new groupdocs_editor.WordProcessingEditOptions();

// Create custom edit options, where most styles are inline
const editOptionsInlineStyles = new groupdocs_editor.WordProcessingEditOptions();
// Enable inline styles in this instance
editOptionsInlineStyles.setUseInlineStyles(true);

// Create an instance of the Editor class and load the document
const editor = new groupdocs_editor.Editor(inputPath);

// Get EditableDocument instance with external styles
const docWithExternalStyles = editor.edit(editOptionsExternalStyles);

// Get EditableDocument instance with inline styles
const docWithInlineStyles = editor.edit(editOptionsInlineStyles);

// Get only HTML markup with external styles
const htmlMarkupExternal = docWithExternalStyles.getContent();

// Get only HTML markup with inline styles
const htmlMarkupInline = docWithInlineStyles.getContent();

// Optionally, save the HTML content to files
const fs = require('fs');
fs.writeFileSync('ExternalStyles.html', htmlMarkupExternal);
fs.writeFileSync('InlineStyles.html', htmlMarkupInline);
```

**Note:** Replace `"SampleDoc.docx"` with the actual path to your WordProcessing document.

It's important to emphasize that no matter where the CSS styles are located—inside the HTML markup or in an external file—the final representation of the HTML document in the web browser will be identical.

Also, please note that this feature exists only for the WordProcessing formats family.

## Conclusion

The ability to enable inline CSS styles provides greater flexibility in how styles are managed within your HTML documents. This can be particularly useful in scenarios where managing external CSS files is inconvenient or when you want to simplify the deployment of HTML content by embedding styles directly into the HTML markup.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.
---

## Extract and Convert Archive Contents

Path: /conversion/net/convert-contents-of-rar-or-zip-document-to-different-formats-and-compress/


GroupDocs.Conversion can extract files from archives (ZIP, RAR, 7z, TAR) and convert each file to a different format. This guide covers two workflows for processing archive contents.

**To convert archive formats** (ZIP to 7z, etc.) **without extracting contents**, see [Convert Archive Formats]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-compression-with-advanced-options.md" >}}).

## Two Content Extraction Workflows

| Workflow | What It Does | Result |
|----------|-------------|--------|
| **[Workflow 1](#workflow-1-extract-and-convert-to-individual-files)** | Extract and convert each file separately | Individual converted files (e.g., doc-1.pdf, doc-2.pdf) |
| **[Workflow 2](#workflow-2-convert-contents-and-re-compress)** | Convert contents AND create new archive | New archive with converted contents |

## Workflow 1: Extract and Convert to Individual Files

Extract files from an archive and convert each one separately (no re-compression).

```csharp
using GroupDocs.Conversion.Fluent;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Contracts;
using System.IO;

// ZIP contains: report.docx, summary.docx, analysis.docx
FluentConverter.Load("documents.zip")
    .ConvertTo((SaveContext saveContext) =>
    {
        // Create separate output file for each document
        string fileName = $"converted-document-{saveContext.ItemIndex}.pdf";
        return File.Create(Path.Combine(@"C:\output", fileName));
    })
    .WithOptions(new PdfConvertOptions())
    .Convert();

// Output: converted-document-1.pdf, converted-document-2.pdf, converted-document-3.pdf
```

**Using original filenames:**

```csharp
FluentConverter.Load("documents.zip")
    .ConvertTo((SaveContext saveContext) =>
    {
        string originalName = saveContext.SourceFileName ?? $"document-{saveContext.ItemIndex}";
        string fileName = Path.ChangeExtension(originalName, ".pdf");
        return File.Create(Path.Combine(@"C:\output", fileName));
    })
    .WithOptions(new PdfConvertOptions())
    .Convert();

// Output: report.pdf, summary.pdf, analysis.pdf
```

## Workflow 2: Convert Contents and Re-compress

Extract files, convert them, and package into a new archive:

```csharp
using GroupDocs.Conversion.Fluent;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Contracts;
using GroupDocs.Conversion.FileTypes;
using System.IO;

FluentConverter.Load("documents.rar")
    .ConvertTo((SaveContext saveContext) => new MemoryStream())
    .WithOptions(new PdfConvertOptions())
    .Compress(new CompressionConvertOptions
    {
        Format = CompressionFileType.Zip
    })
    .OnCompressionCompleted(compressedStream =>
    {
        using (var fileStream = File.Create("converted-documents.zip"))
        {
            compressedStream.CopyTo(fileStream);
        }
    })
    .Convert();

// Output: converted-documents.zip containing PDFs
```

**With password protection:**

```csharp
FluentConverter.Load("sensitive-files.zip")
    .ConvertTo((SaveContext saveContext) => new MemoryStream())
    .WithOptions(new PdfConvertOptions())
    .Compress(new CompressionConvertOptions
    {
        Format = CompressionFileType.Zip,
        Password = "SecurePassword123"
    })
    .OnCompressionCompleted(compressedStream =>
    {
        using (var fileStream = File.Create("protected-archive.zip"))
        {
            compressedStream.CopyTo(fileStream);
        }
    })
    .Convert();
```

## Choosing the Right Workflow

| Your Goal | Use |
|-----------|-----|
| Extract and convert each file separately | **Workflow 1** |
| Convert contents AND create new archive | **Workflow 2** |
| Change archive format only (no conversion) | See [Convert Archive Formats]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-compression-with-advanced-options.md" >}}) |

## Supported Archive Formats

**Input (read):** ZIP, RAR, 7z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ, CAB, LZ, CPIO, ISO

**Output (write):** ZIP, 7z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ (RAR output not supported due to licensing)

## See Also

- [Convert Archive Formats (ZIP, 7z, TAR, RAR)]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-compression-with-advanced-options.md" >}}) - Change archive format without extracting contents
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})
- [FluentConverter API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.fluent/fluentconverter/)

---

## Generate Output in Same Format as Template

Path: /assembly/net/basic-usage-same-format-output/


## Overview

By default, GroupDocs.Assembly for .NET saves assembled documents in the same format as the template. This means a DOCX template produces a DOCX output, an XLSX template produces an XLSX output, and so on. The output format is determined by the file extension of the output path.

The main class involved is:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents and determines output format

Here are the steps to generate output in the same format:

* Create a template document in your desired format (DOCX, XLSX, PPTX, etc.)
* Specify an output path with the same file extension as the template
* Assemble the document using DocumentAssembler
* The output will automatically be in the same format as the template

{{< alert style="info" >}}
The output format is automatically determined by the file extension of the output path. No additional configuration is needed to preserve the template format.
{{< /alert >}}

## Generate DOCX from DOCX Template

Generate a Word document from a Word template:

```csharp
using GroupDocs.Assembly;

public static void GenerateDocxFromDocx()
{
    // Template and output are both DOCX
    string templatePath = "InvoiceTemplate.docx";
    string outputPath = "Invoice.docx";
    
    var invoiceData = new { 
        CustomerName = "ABC Corp", 
        Amount = 1500.00m,
        Date = DateTime.Now
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(invoiceData, "invoice"));
    
    Console.WriteLine("DOCX document generated from DOCX template.");
}
```

## Generate XLSX from XLSX Template

Generate an Excel spreadsheet from an Excel template:

```csharp
using GroupDocs.Assembly;

public static void GenerateXlsxFromXlsx()
{
    // Template and output are both XLSX
    string templatePath = "ReportTemplate.xlsx";
    string outputPath = "Report.xlsx";
    
    var reportData = new { 
        Title = "Monthly Sales",
        Month = "January 2024"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(reportData, "report"));
    
    Console.WriteLine("XLSX document generated from XLSX template.");
}
```

## Generate PPTX from PPTX Template

Generate a PowerPoint presentation from a PowerPoint template:

```csharp
using GroupDocs.Assembly;

public static void GeneratePptxFromPptx()
{
    // Template and output are both PPTX
    string templatePath = "PresentationTemplate.pptx";
    string outputPath = "Presentation.pptx";
    
    var presentationData = new { 
        Title = "Quarterly Review",
        Quarter = "Q1 2024"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(presentationData, "presentation"));
    
    Console.WriteLine("PPTX document generated from PPTX template.");
}
```

## Generate MSG from MSG Template

Generate an email message from an email template:

```csharp
using GroupDocs.Assembly;

public static void GenerateMsgFromMsg()
{
    // Template and output are both MSG
    string templatePath = "EmailTemplate.msg";
    string outputPath = "Email.msg";
    
    var emailData = new { 
        Recipient = "customer@example.com",
        Subject = "Invoice",
        Body = "Please find attached invoice."
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(emailData, "email"));
    
    Console.WriteLine("MSG document generated from MSG template.");
}
```

## Using Streams with Same Format

When using streams, the format is still preserved based on the template format:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void GenerateSameFormatFromStream()
{
    // Load DOCX template from stream
    byte[] templateBytes = File.ReadAllBytes("Template.docx");
    
    using (MemoryStream templateStream = new MemoryStream(templateBytes))
    using (FileStream outputStream = new FileStream("Output.docx", FileMode.Create))
    {
        var data = new { Name = "Test", Value = 100 };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templateStream, outputStream, 
            new DataSourceInfo(data, "item"));
        
        Console.WriteLine("Document generated from stream in same format.");
    }
}
```

## Format Compatibility

The following formats support same-format output:

- **Word Processing**: DOCX, DOC, RTF, ODT, OTT
- **Spreadsheet**: XLSX, XLS, XLSM, ODS
- **Presentation**: PPTX, PPT, PPTM, ODP
- **Email**: MSG, EML, EMLX
- **Other**: HTML, TXT, XML

{{< alert style="warning" >}}
Some older formats (like DOC, XLS, PPT) may have limitations compared to their newer counterparts (DOCX, XLSX, PPTX). For best results, use the newer Office Open XML formats.
{{< /alert >}}

### Advanced Usage Topics

To learn more about format conversion, saving to different formats, and format-specific options, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Indexing options

Path: /search/java/indexing-options/

This page contains a description of all the properties of the [IndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions) class.

## setCancellation method

The [setCancellation](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method is used to specify an object of type [Cancellation](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/Cancellation), used to cancel of an index operation. The default value is null. An operation can be canceled if necessary with a time delay. Note that after cancellation, an index may not immediately stop an operation, but with a some delay.

The following example demonstrates cancelling of an indexing operation.

```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Creating an instance of indexing options
IndexingOptions options = new IndexingOptions();
options.setCancellation(new Cancellation()); // Setting a cancellation object
options.getCancellation().cancelAfter(300000); // Setting a time period of 300 seconds after which the indexing operation will be cancelled

// Indexing documents from the specified folder
index.add(documentFolder, options);
```

## setAsync method

The [setAsync](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions#setAsync(boolean)) method is used to specify whether to perform indexing operation asynchronously or synchronously. The default value is false, meaning synchronous execution. The example below demonstrates the performing of an asynchronous indexing.

```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";

// Creating index in the specified folder
Index index = new Index(indexFolder);

// Subscribing to the event
index.getEvents().StatusChanged.add(new EventHandler<BaseIndexEventArgs>() {
    public void invoke(Object sender, BaseIndexEventArgs args) {
        if (args.getStatus() != IndexStatus.InProgress) {
            // A notification of the operation completion should be here
        }
    }
});

// Creating an instance of indexing options
IndexingOptions options = new IndexingOptions();
options.setAsync(true); // Specifying the asynchronous performing of the operation

// Indexing documents from the specified folder
// The method will return control before the indexing operation is completed
index.add(documentFolder, options);
```

## setThreads method

The [setThreads](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions#setThreads(int)) method is used to set the number of threads used for indexing. The default value is 1. The number of indexing threads cannot be less than 1 or more than 4.

A larger number of threads accelerates the indexing process. However, be careful when specifying the number of indexing threads more than 1, because the amount of memory used during indexing is directly proportional to the number of threads involved. If there is 4 GB of RAM or less in the system, using more than 1 thread may result in out of memory error. In addition, the hard disk where the files for indexing are located may be the bottleneck and performance will not increase.

The following example demonstrates how to perform indexing in 2 threads.

```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Creating an instance of indexing options
IndexingOptions options = new IndexingOptions();
options.setThreads(2); // Setting the number of indexing threads

// Indexing documents from the specified folder
index.add(documentFolder, options);
```

## getMetadataIndexingOptions method

The [getMetadataIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions#getMetadataIndexingOptions()) method returns an instance of the [MetadataIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions) class. This class contains methods for setting metadata indexing options:

* The [setIndexingEmptyValues](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setIndexingEmptyValues(boolean)) method sets a value indicating whether to index empty field values or not. The default value is true.
* The [setIndexingEmptyNames](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setIndexingEmptyNames(boolean)) method sets a value indicating whether to index empty field names or not. The default value is true.
* The [setDefaultFieldName](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setDefaultFieldName(java.lang.String)) method sets the default field name used to index empty field names. The default value is "unknown".
* The [setSeparatorInCompoundName](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setSeparatorInCompoundName(java.lang.String)) method sets the separator in the compound name of a field. The default value is "." (period character).
* The [setMaxBytesToIndexField](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxBytesToIndexField(int)) method sets the maximum number of values indexed from an array of byte values. The default value is Integer.MAX\_VALUE.
* The [setMaxIntsToIndexField](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxIntsToIndexField(int)) method sets the maximum number of values indexed from an array of int values. The default value is Integer.MAX\_VALUE.
* The [setMaxLongsToIndexField](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxLongsToIndexField(int)) method sets the maximum number of values indexed from an array of long values. The default value is Integer.MAX\_VALUE.
* The [setMaxDoublesToIndexField](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxDoublesToIndexField(int)) method sets the maximum number of values indexed from an array of double values. The default value is Integer.MAX\_VALUE.
* The [setSeparatorBetweenValues](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MetadataIndexingOptions#setSeparatorBetweenValues(java.lang.String)) method sets the separator between values in a field of type array. The default value is " " (space character).

The following example demonstrates how to set the metadata indexing options.

```java
String indexFolder = "c:\\MyIndex";
String documentFolder = "c:\\MyDocuments";

// Creating an index
Index index = new Index(indexFolder);

// Setting the metadata indexing options
IndexingOptions options = new IndexingOptions();
options.getMetadataIndexingOptions().setDefaultFieldName("default");
options.getMetadataIndexingOptions().setSeparatorInCompoundName("\\");
options.getMetadataIndexingOptions().setMaxBytesToIndexField(10);
options.getMetadataIndexingOptions().setMaxIntsToIndexField(10);
options.getMetadataIndexingOptions().setMaxLongsToIndexField(10);
options.getMetadataIndexingOptions().setMaxDoublesToIndexField(10);

// Starting indexing operation
index.add(documentFolder, options);
```

## getOcrIndexingOptions method

The [getOcrIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions#getOcrIndexingOptions()) method returns an instance of the [OcrIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/OcrIndexingOptions) class. This class contains properties for setting OCR processing options:

* The [setEnabledForSeparateImages](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/OcrIndexingOptions#setEnabledForSeparateImages(boolean)) method sets a value indicating whether to recognize text in separate image files. The default value is false.
* The [setEnabledForEmbeddedImages](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/OcrIndexingOptions#setEnabledForEmbeddedImages(boolean)) method sets a value indicating whether to recognize text in embedded images. The default value is false.
* The [setEnabledForContainerItemImages](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/OcrIndexingOptions#setEnabledForContainerItemImages(boolean)) method sets a value indicating whether to recognize text in images that are items in a container (ZIP archive, OST/PST storage). The default value is false.
* The [setOcrConnector](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/OcrIndexingOptions#setOcrConnector(com.groupdocs.search.options.IOcrConnector)) method sets an OCR connector that is used for OCR processing. The default value is null, which means no OCR is used.

## getImageIndexingOptions method

The [getImageIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions#getImageIndexingOptions()) method returns an instance of the [ImageIndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageIndexingOptions) class. This class provides image indexing options for reverse image search:

* The [setEnabledForSeparateImages](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageIndexingOptions#setEnabledForSeparateImages(boolean)) method sets a value indicating whether to index separate image files. The default value is false.
* The [setEnabledForEmbeddedImages](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageIndexingOptions#setEnabledForEmbeddedImages(boolean)) method sets a value indicating whether to index embedded images (for example, images in a DOCX document). The default value is false.
* The [setEnabledForContainerItemImages](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/ImageIndexingOptions#setEnabledForContainerItemImages(boolean)) method sets a value indicating whether to index images that are items in a container (ZIP archive, OST/PST storage). The default value is false.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing options

Path: /search/net/indexing-options/

This page contains a description of all the properties of the [IndexingOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/indexingoptions) class.

## Cancellation property

The **[Cancellation](https://reference.groupdocs.com/net/search/groupdocs.search.options/indexingoptions/properties/cancellation)** property is used to specify an object of type [Cancellation](https://reference.groupdocs.com/net/search/groupdocs.search.common/cancellation), used to cancel of an index operation. The default value of the [Cancellation](https://reference.groupdocs.com/net/search/groupdocs.search.options/indexingoptions/properties/cancellation) property is null. An operation can be canceled if necessary with a time delay. Note that after cancellation, an index may not immediately stop an operation, but with a some delay.

The following example demonstrates cancelling of an indexing operation.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Creating an instance of indexing options
IndexingOptions options = new IndexingOptions();
options.Cancellation = new Cancellation(); // Setting a cancellation object
options.Cancellation.CancelAfter(300000); // Setting a time period of 300 seconds after which the indexing operation will be cancelled
 
// Indexing documents from the specified folder
index.Add(documentFolder, options);
```

## IsAsync property

The **[IsAsync](https://reference.groupdocs.com/net/search/groupdocs.search.options/indexingoptions/properties/isasync)** property is used to specify whether to perform indexing operation asynchronously or synchronously. The default value is false, meaning synchronous execution. The example below demonstrates the performing of an asynchronous indexing.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating index in the specified folder
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.StatusChanged += (sender, args) =>
{
    if (args.Status != IndexStatus.InProgress)
    {
        // A notification of the operation completion should be here
    }
};
 
// Creating an instance of indexing options
IndexingOptions options = new IndexingOptions();
options.IsAsync = true; // Specifying the asynchronous performing of the operation
 
// Indexing documents from the specified folder
// The method will return control before the indexing operation is completed
index.Add(documentFolder, options);
```

## AutoDetectEncoding property

The [AutoDetectEncoding](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/autodetectencoding/) property is a flag that allows you to automatically detect the following encodings of text files during indexing: UTF-32 LE, UTF-32 BE, UTF-16 LE, UTF-16 BE, UTF-8, UTF-7. By default, the encoding auto detection of text files is disabled. But in any case, the encoding of a text file can be set during indexing when the [FileIndexing](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/fileindexing) event is raised. Detailed information on detecting and setting the encoding of text files is presented on the page [Text file encoding detection]({{< ref "search/net/developer-guide/advanced-usage/indexing/text-file-encoding-detection.md" >}}).

## Encoding property

The [Encoding](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/encoding/) property specifies the encoding used to extract text from text files. The default value is null, which means that the default encoding UTF-8 is used. If [AutoDetectEncoding](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/autodetectencoding/) is true then value of this property is used as the default encoding.

## Threads property

The [Threads](https://reference.groupdocs.com/net/search/groupdocs.search.options/indexingoptions/properties/threads) property is used to set the number of threads used for indexing. The default value is 1. The number of indexing threads cannot be less than 1 or more than 4.

A larger number of threads accelerates the indexing process. However, be careful when specifying the number of indexing threads more than 1, because the amount of memory used during indexing is directly proportional to the number of threads involved. If there is 4 GB of RAM or less in the system, using more than 1 thread may result in out of memory error. In addition, the hard disk where the files for indexing are located may be the bottleneck and performance will not increase.

The following example demonstrates how to perform indexing in 2 threads.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Creating an instance of indexing options
IndexingOptions options = new IndexingOptions();
options.Threads = 2; // Setting the number of indexing threads
 
// Indexing documents from the specified folder
index.Add(documentFolder, options); 
```

## UseRawTextExtraction property

The [UseRawTextExtraction](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/userawtextextraction/) property allows you to specify a value indicating whether to use raw text extraction mode whenever possible during indexing. The raw text extraction mode can significantly speed up the indexing process at the cost of losing the formatting quality of the extracted text. The default value for this property is true.

## UseBackupPrivilege property

The [UseBackupPrivilege](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/usebackupprivilege/) property allows you to specify whether the process should use the backup privilege to access files and directories. When set to true, this property allows the process to bypass file and directory security checks, permitting access to protected resources typically restricted by ACLs – as long as the process has the proper privileges.

This feature is only supported on Windows operating systems. On non-Windows platforms,
enabling this property has no effect.

Note that this requires the process to be running with administrative rights.

## MetadataIndexingOptions property

The [MetadataIndexingOptions](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/metadataindexingoptions/) property is represented by an object of the [MetadataIndexingOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions) class. This class contains properties for setting metadata indexing options:

* The [IndexingEmptyValues](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/indexingemptyvalues) property sets a value indicating whether to index empty field values or not. The default value is true.
* The [IndexingEmptyNames](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/indexingemptynames) property sets a value indicating whether to index empty field names or not. The default value is true.
* The [DefaultFieldName](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/defaultfieldname) property sets the default field name used to index empty field names. The default value is "unknown".
* The [SeparatorInCompoundName](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/separatorincompoundname) property sets the separator in the compound name of a field. The default value is "." (period character).
* The [MaxBytesToIndexField](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/maxbytestoindexfield) property sets the maximum number of values indexed from an array of byte values. The default value is int.MaxValue.
* The [MaxIntsToIndexField](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/maxintstoindexfield) property sets the maximum number of values indexed from an array of int values. The default value is int.MaxValue.
* The [MaxLongsToIndexField](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/maxlongstoindexfield) property sets the maximum number of values indexed from an array of long values. The default value is int.MaxValue.
* The [MaxDoublesToIndexField](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/maxdoublestoindexfield) property sets the maximum number of values indexed from an array of double values. The default value is int.MaxValue.
* The [SeparatorBetweenValues](https://reference.groupdocs.com/net/search/groupdocs.search.options/metadataindexingoptions/properties/separatorbetweenvalues) property sets the separator between values in a field of type array. The default value is " " (space character).

The following example demonstrates how to set the metadata indexing options.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFolder = @"c:\MyDocuments";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Setting the metadata indexing options
var options = new IndexingOptions();
options.MetadataIndexingOptions.DefaultFieldName = "default";
options.MetadataIndexingOptions.SeparatorInCompoundName = @"\";
options.MetadataIndexingOptions.MaxBytesToIndexField = 10;
options.MetadataIndexingOptions.MaxIntsToIndexField = 10;
options.MetadataIndexingOptions.MaxLongsToIndexField = 10;
options.MetadataIndexingOptions.MaxDoublesToIndexField = 10;
 
// Starting indexing operation
index.Add(documentFolder, options);
```

## OcrIndexingOptions property

The [OcrIndexingOptions](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/ocrindexingoptions/) property is represented by an object of the [OcrIndexingOptions](https://reference.groupdocs.com/search/net/groupdocs.search.options/ocrindexingoptions) class. This class contains properties for setting OCR processing options:

* The [EnabledForSeparateImages](https://reference.groupdocs.com/net/search/groupdocs.search.options/ocrindexingoptions/properties/enabledforseparateimages) property sets a value indicating whether to recognize text in separate image files. The default value is false.
* The [EnabledForEmbeddedImages](https://reference.groupdocs.com/net/search/groupdocs.search.options/ocrindexingoptions/properties/enabledforembeddedimages) property sets a value indicating whether to recognize text in embedded images. The default value is false.
* The [EnabledForContainerItemImages](https://reference.groupdocs.com/search/net/groupdocs.search.options/ocrindexingoptions/properties/enabledforcontaineritemimages) property sets a value indicating whether to recognize text in images that are items in a container (ZIP archive, OST/PST storage). The default value is false.
* The [OcrConnector](https://reference.groupdocs.com/net/search/groupdocs.search.options/ocrindexingoptions/properties/ocrconnector) property sets an OCR connector that is used for OCR processing. The default value is null, which means no OCR is used.

## ImageIndexingOptions property

The [ImageIndexingOptions](https://reference.groupdocs.com/search/net/groupdocs.search.options/baseoptions/imageindexingoptions/) property is represented by an object of the [ImageIndexingOptions](https://reference.groupdocs.com/search/net/groupdocs.search.options/imageindexingoptions) class. This class provides image indexing options for reverse image search:

* The [EnabledForSeparateImages](https://reference.groupdocs.com/search/net/groupdocs.search.options/imageindexingoptions/properties/enabledforseparateimages) property sets a value indicating whether to index separate image files. The default value is false.
* The [EnabledForEmbeddedImages](https://reference.groupdocs.com/search/net/groupdocs.search.options/imageindexingoptions/properties/enabledforembeddedimages) property sets a value indicating whether to index embedded images (for example, images in a DOCX document). The default value is false.
* The [EnabledForContainerItemImages](https://reference.groupdocs.com/search/net/groupdocs.search.options/imageindexingoptions/properties/enabledforcontaineritemimages) property sets a value indicating whether to index images that are items in a container (ZIP archive, OST/PST storage). The default value is false.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing options

Path: /search/nodejs-java/indexing-options/

This page contains a description of all the properties of the [IndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions) class.

## setCancellation method

The [setCancellation](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method is used to specify an object of type [Cancellation](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/Cancellation), used to cancel of an index operation. The default value is null. An operation can be canceled if necessary with a time delay. Note that after cancellation, an index may not immediately stop an operation, but with a some delay.

The following example demonstrates cancelling of an indexing operation.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Creating an instance of indexing options
const options = new groupdocs.search.IndexingOptions();
options.setCancellation(new groupdocs.search.Cancellation()); // Setting a cancellation object
options.getCancellation().cancelAfter(3000); // Setting a time period of 3 seconds after which the indexing operation will be cancelled

// Indexing documents from the specified folder
index.add(documentFolder, options);
```

## setAsync method

The [setAsync](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions#setAsync(boolean)) method is used to specify whether to perform indexing operation asynchronously or synchronously. The default value is false, meaning synchronous execution. The example below demonstrates the performing of an asynchronous indexing.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().StatusChanged.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      if (
        String(args.getStatus()) == String(groupdocs.search.IndexStatus.Ready) ||
        String(args.getStatus()) == String(groupdocs.search.IndexStatus.Failed)
      ) {
        // A notification of the operation completion should be here
        console.log('Status: ' + args.getStatus());
      }
    },
  }),
);

// Creating an instance of indexing options
const options = new groupdocs.search.IndexingOptions();
options.setAsync(true); // Specifying the asynchronous performing of the operation

// Indexing documents from the specified folder
// The method will return control before the indexing operation is completed
index.add(documentFolder, options);
```

## setThreads method

The [setThreads](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions#setThreads(int)) method is used to set the number of threads used for indexing. The default value is 1. The number of indexing threads cannot be less than 1 or more than 4.

A larger number of threads accelerates the indexing process. However, be careful when specifying the number of indexing threads more than 1, because the amount of memory used during indexing is directly proportional to the number of threads involved. If there is 4 GB of RAM or less in the system, using more than 1 thread may result in out of memory error. In addition, the hard disk where the files for indexing are located may be the bottleneck and performance will not increase.

The following example demonstrates how to perform indexing in 2 threads.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Creating an instance of indexing options
const options = new groupdocs.search.IndexingOptions();
options.setThreads(2); // Setting the number of indexing threads

// Indexing documents from the specified folder
index.add(documentFolder, options);
```

## getMetadataIndexingOptions method

The [getMetadataIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions#getMetadataIndexingOptions()) method returns an instance of the [MetadataIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions) class. This class contains methods for setting metadata indexing options:

* The [setIndexingEmptyValues](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setIndexingEmptyValues(boolean)) method sets a value indicating whether to index empty field values or not. The default value is true.
* The [setIndexingEmptyNames](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setIndexingEmptyNames(boolean)) method sets a value indicating whether to index empty field names or not. The default value is true.
* The [setDefaultFieldName](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setDefaultFieldName(java.lang.String)) method sets the default field name used to index empty field names. The default value is "unknown".
* The [setSeparatorInCompoundName](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setSeparatorInCompoundName(java.lang.String)) method sets the separator in the compound name of a field. The default value is "." (period character).
* The [setMaxBytesToIndexField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxBytesToIndexField(int)) method sets the maximum number of values indexed from an array of byte values. The default value is Integer.MAX\_VALUE.
* The [setMaxIntsToIndexField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxIntsToIndexField(int)) method sets the maximum number of values indexed from an array of int values. The default value is Integer.MAX\_VALUE.
* The [setMaxLongsToIndexField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxLongsToIndexField(int)) method sets the maximum number of values indexed from an array of long values. The default value is Integer.MAX\_VALUE.
* The [setMaxDoublesToIndexField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setMaxDoublesToIndexField(int)) method sets the maximum number of values indexed from an array of double values. The default value is Integer.MAX\_VALUE.
* The [setSeparatorBetweenValues](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MetadataIndexingOptions#setSeparatorBetweenValues(java.lang.String)) method sets the separator between values in a field of type array. The default value is " " (space character).

The following example demonstrates how to set the metadata indexing options.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Setting the metadata indexing options
const options = new groupdocs.search.IndexingOptions();
options.getMetadataIndexingOptions().setDefaultFieldName('default');
options.getMetadataIndexingOptions().setSeparatorInCompoundName('\\');
options.getMetadataIndexingOptions().setMaxBytesToIndexField(10);
options.getMetadataIndexingOptions().setMaxIntsToIndexField(10);
options.getMetadataIndexingOptions().setMaxLongsToIndexField(10);
options.getMetadataIndexingOptions().setMaxDoublesToIndexField(10);

// Starting indexing operation
index.add(documentFolder, options);
```

## getOcrIndexingOptions method

The [getOcrIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions#getOcrIndexingOptions()) method returns an instance of the [OcrIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/OcrIndexingOptions) class. This class contains properties for setting OCR processing options:

* The [setEnabledForSeparateImages](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/OcrIndexingOptions#setEnabledForSeparateImages(boolean)) method sets a value indicating whether to recognize text in separate image files. The default value is false.
* The [setEnabledForEmbeddedImages](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/OcrIndexingOptions#setEnabledForEmbeddedImages(boolean)) method sets a value indicating whether to recognize text in embedded images. The default value is false.
* The [setEnabledForContainerItemImages](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/OcrIndexingOptions#setEnabledForContainerItemImages(boolean)) method sets a value indicating whether to recognize text in images that are items in a container (ZIP archive, OST/PST storage). The default value is false.
* The [setOcrConnector](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/OcrIndexingOptions#setOcrConnector(com.groupdocs.search.options.IOcrConnector)) method sets an OCR connector that is used for OCR processing. The default value is null, which means no OCR is used.

## getImageIndexingOptions method

The [getImageIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions#getImageIndexingOptions()) method returns an instance of the [ImageIndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageIndexingOptions) class. This class provides image indexing options for reverse image search:

* The [setEnabledForSeparateImages](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageIndexingOptions#setEnabledForSeparateImages(boolean)) method sets a value indicating whether to index separate image files. The default value is false.
* The [setEnabledForEmbeddedImages](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageIndexingOptions#setEnabledForEmbeddedImages(boolean)) method sets a value indicating whether to index embedded images (for example, images in a DOCX document). The default value is false.
* The [setEnabledForContainerItemImages](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/ImageIndexingOptions#setEnabledForContainerItemImages(boolean)) method sets a value indicating whether to index images that are items in a container (ZIP archive, OST/PST storage). The default value is false.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Load XML document with options

Path: /conversion/net/load-xml-document-with-options/

GroupDocs.Conversion provides [XmlLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/xmlloadoptions) to give you control over how the source XML document will be processed. The following options could be set:
| Option | Description |
|--------|-------------|
|**[BasePath](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/basepath)** | Specifies the base path/url for the HTML |  
|**[Encoding](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/encoding)** | Specifies the encoding to be used to load the document. If not specified, the encoding will be determined from the document's character set attribute |
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/loadoptions/format)** | Input document file type |
|**[PageNumbering](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/pagenumbering)** | Whether to generate page numbers for the converted document. Default: false |
|**[ResourceLoadingTimeout](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/resourceloadingtimeout)** | Specifies the timeout of loading the external resources. |
|**[SkipExternalResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/skipexternalresources)** |  If enabled, the external resources (except for those listed in `WhitelistedResources`) will not be loaded during the conversion. |
|**[UseAsDataSource](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/xmlloadoptions/useasdatasource)** | Use source XML document as a data source |
|**[WhitelistedResources](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/webloadoptions/whitelistedresources)** | Specifies which external resources will be loaded even when the loading of other external resources is restricted. |
|**[XslFoFactory](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/xmlloadoptions/xslfofactory)** | XSL document stream to convert XML-FO using XSL. |
|**[XsltFactory](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/xmlloadoptions/xsltfactory/)** | XSLT document stream to convert XML performing XSL transformation to HTML. |

### Convert XML as a data source to a spreadsheet

The following code snippet shows how to use XML as a data source and convert it to a spreadsheet:

```csharp
using (Converter converter = new Converter("data.xml", (LoadContext loadContext) => new XmlLoadOptions
{
    UseAsDataSource = true
}))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
    converter.Convert("converted.xlsx", options);
}
```

### Convert XML transformed through XSLT to a PDF:

The following code shows how to convert a XML transformed through XSLT to a PDF:

```csharp
using (var converter = new Converter("books.xml", (LoadContext loadContext) => new XmlLoadOptions
   {
       XsltFactory = () => File.OpenRead("books.xsl")
   }))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```

## Skip loading of external resources

External resources refer to data or content that is referenced or linked from within an XML document but is stored separately, typically in separate files or locations.  Common external resources include DTDs or XML schemas, entities, XSLT Stylesheets, data sources, images, multimedia, and so on. 

In some cases, you may want to skip loading all or just some of the external resources during the conversion. For example, when these resources become unavailable. Read the [Skip loading of external resources]({{< ref "conversion/net/developer-guide/advanced-usage/loading/skip-external-resources.md" >}}) article to learn how to do this with **GroupDocs.Conversion for .NET**.

---

## Loading XML Documents with Options

Path: /conversion/java/load-xml-document-with-options/

[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) provides the [XmlLoadOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/xmlloadoptions/) class to offer fine-grained control over how XML documents are processed during conversion. This flexibility is particularly useful when working with XML data sources, applying XSL transformations, or handling external resources.
| Option | Description |
|--------|-------------|
|[**setUseAsDataSource**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/xmlloadoptions/#setUseAsDataSource-boolean-) | Specifies whether to treat the source XML document as a data source. |
|[**setXslFoFactory**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/xmlloadoptions/#setXslFoFactory-java.util.function.Supplier-com.aspose.ms.System.IO.Stream--) | Provides an XSL document stream to convert XML-FO using XSL Formatting Objects. |
|[**setXsltFactory**](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/xmlloadoptions/#setXsltFactory-java.util.function.Supplier-com.aspose.ms.System.IO.Stream--) | Provides an XSLT document stream to apply XSLT transformations, typically for converting to HTML. |

These options enable you to customize the XML document loading process based on your specific requirements.

### Convert XML as a Data Source to a Spreadsheet

This example demonstrates how to use an XML document as a data source and convert it into a spreadsheet format:

{{< tabs "code-example">}}
{{< tab "XmlToSpreadsheet.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;
import com.groupdocs.conversion.options.load.XmlLoadOptions;

public class XmlToSpreadsheet {
    public static void convert() {
         // Load XML as a data source
        XmlLoadOptions loadOptions = new XmlLoadOptions();
        loadOptions.setUseAsDataSource(true);

        // Initialize the converter with XML and load options
        try(Converter converter = new Converter("data.xml", () -> loadOptions)) {

            // Conversion options for spreadsheet
            SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();

            // Convert XML to XLSX
            converter.convert("converted.xlsx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "data.xml" >}}  
{{< tab-text >}}
`data.xml` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-xml-document-with-options/data.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.xlsx" >}}  
{{< tab-text >}}
`converted.xlsx` is converted XLSX document. Click [here](/conversion/java/_sample_files/developer-guide/loading-documents/load-xml-document-with-options/converted.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}


## Skipping the Loading of External Resources

**External resources** refer to data or content that is linked from within an XML document but stored separately. This includes:
- Document Type Definitions (DTDs) or XML Schemas (XSDs)
- External entities
- XSLT stylesheets
- Linked images or multimedia content
- Data sources referenced in the XML

**Why Skip External Resources?**

You may want to skip loading external resources in the following cases:
- **Unavailable Resources:** When external resources are missing or inaccessible.
- **Security Concerns:** To prevent XML External Entity (XXE) attacks.
- **Performance Optimization:** To improve conversion speed by avoiding unnecessary external calls.

To learn more about skipping external resources, refer to the *[Skip Loading of External Resources](https://docs.groupdocs.com/conversion/java/skip-loading-external-resources/)* article in the [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) documentation.
---

## Numeric range search

Path: /search/java/numeric-range-search/

Numeric range search or numerical search allows you to search in documents any integer numbers in the range from 0 to 9223372036854775807 (Long.MAX\_VALUE). Please note that the number in the text must not be separated by spaces, otherwise it will already be several numbers. A search query of this type is specified as follows:

number ~~ number

The example below demonstrates the numeric range search in text and object forms.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.search("500 ~~ 600");
 
// Search with object query
SearchQuery query2 = SearchQuery.createNumericRangeQuery(500, 600);
SearchResult result2 = index.search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Numeric range search

Path: /search/net/numeric-range-search/

Numeric range search or numerical search allows you to search in documents any integer numbers in the range from 0 to 9223372036854775807 (Int64.MaxValue). Please note that the number in the text must not be separated by spaces, otherwise it will already be several numbers. A search query of this type is specified as follows:

number ~~ number

The example below demonstrates the numeric range search in text and object forms.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search with text query
SearchResult result1 = index.Search("500 ~~ 600");
 
// Search with object query
SearchQuery query2 = SearchQuery.CreateNumericRangeQuery(500, 600);
SearchResult result2 = index.Search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Numeric range search

Path: /search/nodejs-java/numeric-range-search/

Numeric range search or numerical search allows you to search in documents any integer numbers in the range from 0 to 9223372036854775807. Please note that the number in the text must not be separated by spaces, otherwise it will already be several numbers. A search query of this type is specified as follows:

number ~~ number

The example below demonstrates the numeric range search in text and object forms.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search with text query
const query1 = '400 ~~ 4000';
const result1 = index.search(query1);

// Search with object query
const query2 = groupdocs.search.SearchQuery.createNumericRangeQuery(400, 4000);
const result2 = index.search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Render email messages as HTML, PDF, PNG, and JPEG files

Path: /viewer/java/render-email-messages/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render your email messages in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party email clients to view the contents of email files within your Java application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass an email message you want to view to the class constructor. You can load the message from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the loaded message to HTML, PDF, or image format. These methods allow you to render the entire message or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/email" >}} {{< icon "gdoc_person" >}} View email files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported email file formats

GroupDocs.Viewer supports the following email file formats:

* [Email Message](https://docs.fileformat.com/email/eml) (.EML)
* [Apple Mail Message](https://docs.fileformat.com/email/emlx) (.EMLX)
* [Email Mailbox File](https://docs.fileformat.com/email/mbox/) (.MBOX)
* [Outlook Message Item File](https://docs.fileformat.com/email/msg) (.MSG)
* [vCard (Virtual Contact) File](https://docs.fileformat.com/email/vcf/) (.VCF, .VCARD)

## Render email messages as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an email message to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and exclude specific fonts. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an email message in an HTML page, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    // Create an HTML file for the letter.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to HTML](/viewer/java/images/rendering-basics/render-email-messages/render-email-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an email message to a separate folder, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    // Specify the HTML file name and location of external resources.
    // {0} is replaced with the resource name in the output file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("output.html", "output/resource_{0}", "output/resource_{0}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is shown below. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/java/images/rendering-basics/render-email-messages/render-email-to-html-external-resources.png)

## Render email messages as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an email message to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    // Create a PDF file for the letter.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PDF](/viewer/java/images/rendering-basics/render-email-messages/render-email-to-pdf.png)

## Render email messages as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an email message to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    // Create a PNG image for the letter.
    PngViewOptions viewOptions = new PngViewOptions("output.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PNG](/viewer/java/images/rendering-basics/render-email-messages/render-email-to-png.png)

## Render email messages as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an email message to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    // Create a JPG image for the letter.
    JpgViewOptions viewOptions = new JpgViewOptions("output.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [EmailOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/emailoptions) class that allows you to specify different options for rendering email messages. To access these options, use the [setEmailOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setEmailOptions-com.groupdocs.viewer.options.EmailOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

### Set the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert an email message to HTML, PDF, or image format. Use the [EmailOptions.setPageSize](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/emailoptions/#setPageSize-com.groupdocs.viewer.options.PageSize-) method to select one of the predefined page sizes (LETTER, LEDGER, A0, A1, A2, A3, or A4) (see the [PageSize](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pagesize) enumeration).

The following example specifies page size for the output PDF file:

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PageSize;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewOptions.getEmailOptions().setPageSize(PageSize.LETTER);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Rename fields in the message header

GroupDocs.Viewer allows you to change how standard fields (such as _From_, _To_, _Subject_, and so on) are displayed in the email message header.

![Default fields in the message header](/viewer/java/images/rendering-basics/render-email-messages/default-message-fields.png)

Use the [EmailOptions.setFieldTextMap](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/emailoptions/#setFieldTextMap-java.util.Map-com.groupdocs.viewer.options.Field-java.lang.String--) method to specify custom field labels. Static fields of the [Field](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/field) class allow you to access default email header fields, as shown in the example below.

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.Field;
import com.groupdocs.viewer.options.HtmlViewOptions;

import java.util.HashMap;
import java.util.Map;
// ...
try (Viewer viewer = new Viewer("sample.eml")) {
    // Specify custom field labels.
    Map<Field, String> map = new HashMap<>();
    map.put(Field.FROM, "Sender");
    map.put(Field.TO, "Recipient");
    map.put(Field.SENT, "Date");
    map.put(Field.SUBJECT, "Email subject");
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    viewOptions.getEmailOptions().setFieldTextMap(map);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Custom fields in the message header](/viewer/java/images/rendering-basics/render-email-messages/custom-message-fields.png)

### Specify the date and time format and change the time zone

When rendering email messages, GroupDocs.Viewer formats date and time information in the message header based on the system's date and time settings. If you want to change the default date and time format or specify the time zone offset, use the following methods:

* [EmailOptions.setDateTimeFormat](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/emailoptions/#setDateTimeFormat-java.lang.String-)---Allows you to define a custom date and time format. See the following topics for details: 
    * [Standard date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings)
    * [Custom date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings)
* [EmailOptions.setTimeZoneOffset](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/emailoptions/#setTimeZoneOffset-java.util.TimeZone-)---Specifies the hours and minutes offset from UTC. The offset is displayed with a leading sign. A plus sign (+) indicates time ahead of UTC, and a minus sign (-) indicates time behind UTC. 

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.utils.PathUtils;

import java.util.TimeZone;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    // Create an HTML file
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources("output.html");
    // Apply a custom format to the date in the email message header.
    options.getEmailOptions().setDateTimeFormat("MM d yyyy HH:mm tt zzz");
    // Specify the time zone offset. 
    options.getEmailOptions().setTimeZoneOffset(TimeZone.getTimeZone("GMT+1"));

    viewer.view(options);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Custom date-time format](/viewer/java/images/rendering-basics/render-email-messages/custom-date-time-format.png)

---

## Render email messages as HTML, PDF, PNG, and JPEG files

Path: /viewer/nodejs-java/render-email-messages/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to render your email messages in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party email clients to view the contents of email files within your Node.js application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance. Pass an email message you want to view to the class constructor. You can load the message from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the loaded message to HTML, PDF, or image format. These methods allow you to render the entire message or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/email" >}} {{< icon "gdoc_person" >}} View email files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported email file formats

GroupDocs.Viewer supports the following email file formats:

* [Email Message](https://docs.fileformat.com/email/eml) (.EML)
* [Apple Mail Message](https://docs.fileformat.com/email/emlx) (.EMLX)
* [Email Mailbox File](https://docs.fileformat.com/email/mbox/) (.MBOX)
* [Outlook Message Item File](https://docs.fileformat.com/email/msg) (.MSG)
* [vCard (Virtual Contact) File](https://docs.fileformat.com/email/vcf/) (.VCF, .VCARD)

## Render email messages as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an email message to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and exclude specific fonts. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an email message in an HTML page, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method and specify the output file name.

{{< tabs "render-email-to-html-embedded">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.eml")
// Create an HTML file for the letter.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-email-to-html-embedded/eml-to-html.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to HTML](/viewer/nodejs-java/images/rendering-basics/render-email-messages/render-email-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an email message to a separate folder, call the [HtmlViewOptions.forExternalResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forExternalResources--) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "render-email-to-html-external">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.eml")) {
    // Specify the HTML file name and location of external resources.
    // {0} is replaced with the resource name in the output file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forExternalResources("output.html", "output/resource_{0}", "output/resource_{0}");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.eml")
// Specify the HTML file name and location of external resources.
// {0} is replaced with the resource name in the output file name.
const viewOptions = HtmlViewOptions.forExternalResources("render-email-to-html-external/eml-to-html.html", "render-email-to-html-external/eml-to-html/resource_{0}", "render-email-to-html-external/eml-to-html/resource_{0}")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The result is shown below. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/nodejs-java/images/rendering-basics/render-email-messages/render-email-to-html-external-resources.png)

## Render email messages as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an email message to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-email-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.eml")
// Create a PDF file for the letter.
const viewOptions = PdfViewOptions("render-email-to-pdf/eml-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PDF](/viewer/nodejs-java/images/rendering-basics/render-email-messages/render-email-to-pdf.png)

## Render email messages as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an email message to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-email-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.eml")
// Create a PNG image for the letter.
const viewOptions = PngViewOptions("render-email-to-png/eml-to-png.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PNG](/viewer/nodejs-java/images/rendering-basics/render-email-messages/render-email-to-png.png)

## Render email messages as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an email message to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-email-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.eml")
// Create a JPG image for the letter.
const viewOptions = JpgViewOptions("render-email-to-jpeg/eml-to-jpg.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [EmailOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/emailoptions) class that allows you to specify different options for rendering email messages. To access these options, use the [setEmailOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/baseviewoptions/#setEmailOptions-com.groupdocs.viewer.options.EmailOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

### Set the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert an email message to HTML, PDF, or image format. Use the [EmailOptions.setPageSize](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/emailoptions/#setPageSize-com.groupdocs.viewer.options.PageSize-) method to select one of the predefined page sizes (LETTER, LEDGER, A0, A1, A2, A3, or A4) (see the [PageSize](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pagesize) enumeration).

The following example specifies page size for the output PDF file:

{{< tabs "render-email-with-page-size">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions, PageSize } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.eml")
// Create a PDF file for the letter.
const viewOptions = PdfViewOptions("render-email-with-page-size/eml-to-pdf.pdf")
viewOptions.getEmailOptions().setPageSize(PageSize.LETTER)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Rename fields in the message header

GroupDocs.Viewer allows you to change how standard fields (such as _From_, _To_, _Subject_, and so on) are displayed in the email message header.

![Default fields in the message header](/viewer/nodejs-java/images/rendering-basics/render-email-messages/default-message-fields.png)

Use the [EmailOptions.setFieldTextMap](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/emailoptions/#setFieldTextMap-java.util.Map-com.groupdocs.viewer.options.Field-java.lang.String--) method to specify custom field labels. Static fields of the [Field](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/field) class allow you to access default email header fields, as shown in the example below.

{{< tabs "render-email-rename-fields">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions, Field } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.eml")
// Specify custom field labels.
const field = Field
const map = {}
map[field.FROM] = "Sender"
map[field.TO] = "Receiver"
map[field.SENT] = "Date"
map[field.SUBJECT] = "Email subject"
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-email-rename-fields/eml-to-html.html")
viewOptions.getEmailOptions().setFieldTextMap(map)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Custom fields in the message header](/viewer/nodejs-java/images/rendering-basics/render-email-messages/custom-message-fields.png)

### Specify the date and time format and change the time zone

When rendering email messages, GroupDocs.Viewer formats date and time information in the message header based on the system's date and time settings. If you want to change the default date and time format or specify the time zone offset, use the following methods:

* [EmailOptions.setDateTimeFormat](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/emailoptions/#setDateTimeFormat-java.lang.String-)---Allows you to define a custom date and time format. See the following topics for details: 
    * [Standard date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings)
    * [Custom date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings)
* [EmailOptions.setTimeZoneOffset](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/emailoptions/#setTimeZoneOffset-java.util.TimeZone-)---Specifies the hours and minutes offset from UTC. The offset is displayed with a leading sign. A plus sign (+) indicates time ahead of UTC, and a minus sign (-) indicates time behind UTC. 

{{< tabs "render-email-datetime-format">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';
import java from 'java';

const timeOffset = java.import("java.util.TimeZone").getTimeZone("GMT+1")

const viewer = new Viewer("sample.eml")
// Create an HTML file
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-email-datetime-format/eml-to-html.html")
// Apply a custom format to the date in the email message header.
viewOptions.getEmailOptions().setDateTimeFormat("MM d yyyy HH:mm tt zzz");
// Specify the time zone offset. 
viewOptions.getEmailOptions().setTimeZoneOffset(timeOffset)

viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Custom date-time format](/viewer/nodejs-java/images/rendering-basics/render-email-messages/custom-date-time-format.png)

---

## Render email messages as HTML, PDF, PNG, and JPEG files

Path: /viewer/python-net/render-email-messages/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to render your email messages in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party email clients to view the contents of email files within your .NET application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass an email message you want to view to the class constructor. You can load the message from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the loaded message to HTML, PDF, or image format. These methods allow you to render the entire message or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/email" >}} {{< icon "gdoc_person" >}} View email files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported email file formats

GroupDocs.Viewer supports the following email file formats:

* [Email Message](https://docs.fileformat.com/email/eml) (.EML)
* [Apple Mail Message](https://docs.fileformat.com/email/emlx) (.EMLX)
* [Email Mailbox File](https://docs.fileformat.com/email/mbox/) (.MBOX)
* [Outlook Message Item File](https://docs.fileformat.com/email/msg) (.MSG)
* [vCard (Virtual Contact) File](https://docs.fileformat.com/email/vcf/) (.VCF, .VCARD)

GroupDocs.Viewer can detect the email file format automatically based on information in the file header.

## Render email messages as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an email message to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and exclude specific fonts. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an email message in an HTML page, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_email_to_html():
    # Load email message
    with Viewer("sample.eml") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_email_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_email_to_html()
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to HTML](/viewer/python-net/images/rendering-basics/render-email-messages/render-email-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an email message to a separate folder, call the [HtmlViewOptions.for_external_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_email_to_html_external():
    # Load email message
    with Viewer("sample.eml") as viewer:
        # Specify the HTML file name and location of external resources.
        # {0} is replaced with the resource name in the output file name.
        viewOptions = HtmlViewOptions.for_external_resources("render_email_to_html_external/pdf_page_{0}.html", "render_email_to_html_external/pdf_page_{0}/resource_{0}_{1}", "render_email_to_html_external/pdf_page_{0}/resource_{0}_{1}")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_email_to_html_external()
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The result is shown below. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/python-net/images/rendering-basics/render-email-messages/render-email-to-html-external-resources.png)

## Render email messages as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an email message to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_email_to_pdf():
    # Load email message
    with Viewer("sample.eml") as viewer:
        # Create a PDF file.
        viewOptions = PdfViewOptions("render_email_to_pdf/email_message.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_email_to_pdf()
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PDF](/viewer/python-net/images/rendering-basics/render-email-messages/render-email-to-pdf.png)

## Render email messages as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an email message to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_email_to_png():
    # Load email message
    with Viewer("sample.eml") as viewer:
        # Create a PNG file.
        viewOptions = PngViewOptions("render_email_to_png/email_page_0.png")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_email_to_png()
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PNG](/viewer/python-net/images/rendering-basics/render-email-messages/render-email-to-png.png)

## Render email messages as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an email message to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_email_to_jpg():
    # Load email message
    with Viewer("sample.eml") as viewer:
        # Create a JPG file.
        viewOptions = JpgViewOptions("render_email_to_jpg/email_to_jpg.jpg")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_email_to_jpg()
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [EmailOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/emailoptions) class that allows you to specify different options for rendering email messages. To access these options, use the [EmailOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

### Set the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert an email message to HTML, PDF, or image format. Assign a [PageSize](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pagesize/) enumeration member to the [email_options.page_size](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/emailoptions/#properties) property to select one of the predefined page sizes (UNSPECIFIED, LETTER, LEDGER, A0, A1, A2, A3, or A4).

The following example specifies page size for the output PDF file:

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions, PageSize

def render_email_with_page_size():
    # Load email message
    with Viewer("sample.eml") as viewer:
        # Create a PDF file.
        viewOptions = PdfViewOptions("render_email_with_page_size/email_with_page_size.pdf")
        # Specify the page size.
        viewOptions.email_options.page_size = PageSize.LETTER
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_email_with_page_size()
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Specify the date and time format and change the time zone

When rendering email messages, GroupDocs.Viewer formats date and time information in the message header based on the system's date and time settings. If you want to change the default date and time format or specify the time zone offset, use the following properties:

* [email_options.date_time_format](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/emailoptions/#properties)---Allows you to define a custom date and time format. See the following topics for details: 
    * [Standard date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings)
    * [Custom date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings)
* [email_options.time_zone_offset](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/emailoptions/#properties)---Specifies the hours and minutes offset from UTC. The offset is displayed with a leading sign. A plus sign (+) indicates time ahead of UTC, and a minus sign (-) indicates time behind UTC. 

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from datetime import timedelta
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_email_with_datetime_format():
    # Load email message
    with Viewer("sample.eml") as viewer:
        # Create an HTML file.
        options = HtmlViewOptions.for_embedded_resources("render_email_with_datetime_format/email_with_datetime_format.html")
        # Apply a custom format to the date in the email message header.
        options.email_options.date_time_format = "MM d yyyy HH:mm tt zzz"
        # Specify the time zone offset. 
        options.email_options.time_zone_offset = timedelta(hours=1)

        viewer.view(options)

if __name__ == "__main__":
    render_email_with_datetime_format()
```
{{< /tab >}}
{{< tab "sample.eml" >}}
{{< tab-text >}}
`sample.eml` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-email-messages/sample.eml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Custom date-time format](/viewer/python-net/images/rendering-basics/render-email-messages/custom-date-time-format.png)

---

## Render text documents as HTML, PDF, and image files

Path: /viewer/net/render-text-files/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to convert text documents to HTML, PDF, PNG, and JPEG formats so you can view document content in a web browser, PDF or image viewer application.

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a text document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/total" >}} {{< icon "gdoc_person" >}} View text files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported text file formats

GroupDocs.Viewer supports the following text and programming file formats:

* [.AS / .AS3 (ActionScript File)](https://docs.fileformat.com/programming/as/)
* [.ASM (Assembly Language Source Code File)](https://docs.fileformat.com/programming/asm/)
* [.BAT (DOS Batch File)](https://docs.fileformat.com/executable/bat/)
* [.C (C/C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CC (C++ Source Code File)](https://docs.fileformat.com/programming/c/)
* [.CMAKE (CMake File)](https://docs.fileformat.com/programming/cmake/)
* [.CPP (C++ Source Code File)](https://docs.fileformat.com/programming/cpp/)
* [.CS (C# Source Code File)](https://docs.fileformat.com/specification/programming/cs/)
* [.CSS (Cascading Style Sheet)](https://docs.fileformat.com/web/css/)
* [.CXX (C++ Source Code File)](https://docs.fileformat.com/programming/cxx/)
* [.DIFF (Patch File)](https://docs.fileformat.com/programming/diff/)
* [.ERB (Ruby ERB Script)](https://docs.fileformat.com/programming/erb/)
* [.GROOVY (Groovy Source Code File)](https://docs.fileformat.com/programming/groovy/)
* [.H (C/C++/Objective-C Header File)](https://docs.fileformat.com/programming/h/)
* [.HAML (Haml Source Code File)](https://docs.fileformat.com/programming/haml/)
* [.HH (C++ Header File)](https://docs.fileformat.com/programming/hh/)
* [.JAVA (Java Source Code File)](https://docs.fileformat.com/programming/java/)
* [.JS (JavaScript File)](https://docs.fileformat.com/web/js/)
* [.JSON (JavaScript Object Notation File)](https://docs.fileformat.com/web/json/)
* [.LESS (LESS Style Sheet)](https://docs.fileformat.com/web/less/)
* [.LOG (Log File)](https://docs.fileformat.com/database/log/)
* [.M (Objective-C Implementation File)](https://docs.fileformat.com/programming/m/)
* [.MAKE (Xcode Makefile Script)](https://docs.fileformat.com/programming/make/)
* [.MD (Markdown Documentation File)](https://docs.fileformat.com/word-processing/md/)
* [.ML (ML Source Code File)](https://docs.fileformat.com/programming/ml/)
* [.MM (Objective-C++ Source File)](https://docs.fileformat.com/programming/mm/)
* [.PHP (PHP Source Code File)](https://docs.fileformat.com/programming/php/)
* [.PL (Perl Script)](https://docs.fileformat.com/programming/pl/)
* [.PROPERTIES (Java Properties File)](https://en.wikipedia.org/wiki/.properties)
* [.PY (Python Script)](https://docs.fileformat.com/programming/py/)
* [.RB (Ruby Source Code)](https://docs.fileformat.com/ebook/rb/)
* [.RST (reStructuredText File)](https://docs.fileformat.com/programming/rst/)
* [.SASS (Syntactically Awesome StyleSheets File)](https://docs.fileformat.com/web/sass/)
* [.SCALA (Scala Source Code File)](https://docs.fileformat.com/programming/scala/)
* [.SCM (Scheme Source Code File)](https://docs.fileformat.com/programming/scm/)
* [.SCRIPT (Generic Script File)](https://docs.fileformat.com/programming/script/)
* [.SH (Bash Shell Script)](https://docs.fileformat.com/programming/sh/)
* [.SML (Standard ML Source Code File)](https://en.wikipedia.org/wiki/Standard_ML)
* [.SQL (Structured Query Language Data File)](https://docs.fileformat.com/database/sql/)
* [.TXT (Plain Text File)](https://docs.fileformat.com/word-processing/txt/)
* [.VB (Visual Basic Source Code File)](https://docs.fileformat.com/specification/programming/vb/)
* [.VIM (Vim Settings File)](https://docs.fileformat.com/misc/vim/)
* [.YAML (YAML Document)](https://docs.fileformat.com/programming/yaml/)

When you load a text document from a file or [FileStream](https://learn.microsoft.com/en-us/dotnet/api/system.io.filestream), GroupDocs.Viewer detects the document's format based on the filename extension. If you use other stream types to load your document (such as [MemoryStream](https://learn.microsoft.com/en-us/dotnet/api/system.io.memorystream) or [NetworkStream](https://learn.microsoft.com/en-us/dotnet/api/system.net.sockets.networkstream)), GroupDocs.Viewer can determine the file format only for the following document types: TXT, CS, and VB. For other file types, you should explicitly specify their format. To do this, create a [LoadOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/loadoptions) class instance with the [FileType](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/filetype) parameter and pass this instance to the [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class constructor.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using System.IO;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

Stream stream = GetFileStream("markdown-file.md"); //TODO: implement this method

// Specify the file encoding. 
LoadOptions loadOptions = new LoadOptions(FileType.MD);

// Convert the document to PDF.
using (var viewer = new Viewer(stream, loadOptions))
{
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System.IO
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
            Dim stream As Stream = GetFileStream("markdown-file.md") 'TODO: implement this method
        
            ' Specify the file encoding. 
            Dim loadOptions As LoadOptions = New LoadOptions(FileType.MD)
        
            ' Convert the document to PDF.
            Using viewer = New Viewer(stream, loadOptions)
                Dim viewOptions = New PdfViewOptions("output.pdf")
                viewer.View(viewOptions)
            End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render text files as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a text file to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}).

### Create HTML files with embedded resources

To save all elements of an HTML page (including text, graphics, and stylesheets) into a single file, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TermsOfService.txt"))
{
    // Convert the text file to HTML.
    // {0} is replaced with the current page number in the output file names.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TermsOfService.txt")
            ' Convert the text file to HTML.
            ' {0} is replaced with the current page number in the output file names.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to HTML](/viewer/net/images/rendering-basics/render-text-files/render-to-html-embedded-resources.png)

### Create HTML files with external resources

If you want to store output HTML files and additional resource files (such as fonts, images, and style sheets) separately, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TermsOfService.txt"))
{
    // Convert the text file to HTML.
    // Specify the output file names and location of external resources.
    // {0} and {1} are replaced with the current page number and resource name, respectively.
    var viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TermsOfService.txt")
            ' Convert the text file to HTML.
            ' Specify the output file names and location of external resources.
            ' {0} and {1} are replaced with the current page number and resource name, respectively.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("page_{0}.html", "page_{0}/resource_{0}_{1}", "page_{0}/resource_{0}_{1}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-text-files/render-to-html-external-resources.png)

### Create a single HTML page

If you need to display the entire document content on a single HTML page, enable the [HtmlViewOptions.RenderToSinglePage](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/properties/rendertosinglepage) option, as shown below:

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TermsOfService.txt"))
{
    // Convert the text file to HTML.
    // Specify the output file name.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    // Render the file to a single page. 
    viewOptions.RenderToSinglePage = true;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TermsOfService.txt")
            ' Convert the text file to HTML.
            ' Specify the output file name.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            ' Render the file to a single page. 
            viewOptions.RenderToSinglePage = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render text files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a text file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TermsOfService.txt"))
{
    // Convert the text file to PDF.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TermsOfService.txt")
            ' Convert the text file to PDF.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PDF](/viewer/net/images/rendering-basics/render-text-files/render-to-pdf.png)

## Render text files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a text file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TermsOfService.txt"))
{
    // Convert the text file to PNG.
    // {0} is replaced with the current page number in the output image names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TermsOfService.txt")
            ' Convert the text file to PNG.
            ' {0} is replaced with the current page number in the output image names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a text file to PNG](/viewer/net/images/rendering-basics/render-text-files/render-to-png-image.png)

## Render text files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert a text file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TermsOfService.txt"))
{
    // Convert the text file to JPEG.
    // {0} is replaced with the current page number in the output image names.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TermsOfService.txt")
            ' Convert the text file to JPEG.
            ' {0} is replaced with the current page number in the output image names.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [TextOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/textoptions) class that allows you to specify different options for rendering text files. To access these options, use the [TextOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/textoptions) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

The `TextOptions` class contains the following properties:

* [MaxRowsPerPage](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/textoptions/properties/maxrowsperpage)---Specifies the maximum number of rows per page. The default value is **55**.

* [MaxCharsPerRow](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/textoptions/properties/maxcharsperrow)---Specifies the maximum number of characters per row. The default value is **85**.

The following example demonstrates how to change the number of rows displayed on each HTML page:

{{< tabs "example9">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("TermsOfService.txt"))
{
    // Convert the text file to HTML.
    // {0} is replaced with the current page number in the output file names.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html");
    // Set the maximum number of rows per page.
    viewOptions.TextOptions.MaxRowsPerPage = 30;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("TermsOfService.txt")
            ' Convert the text file to HTML.
            ' {0} is replaced with the current page number in the output file names.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("page_{0}.html")
            ' Set the maximum number of rows per page.
            viewOptions.TextOptions.MaxRowsPerPage = 30
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The image below illustrates the result:

![Specify the number of rows per page](/viewer/net/images/rendering-basics/render-text-files/set-max-rows-per-page.png)
 
---

## Sign document with Stamp signature - advanced

Path: /signature/net/sign-document-with-stamp-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [StampSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/stampsignoptions) class with additional properties to specify different options for Stamp Signature. This signature type implements stamps with different implementation, forms, lines etc. Each Stamp option contains inner and outer lines. Inner lines represent vertical lines inside the stamp, when outer lines represent circles (or rectangles based on stamp type) around stamp with own text, border settings, background etc

Here are the steps to add Stamp signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [StampSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/stampsignoptions) object according to your requirements and specify Text Signature options.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [StampSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/stampsignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

This example shows how to add Stamp signature to document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature(filePath))
{
    // setup options with text of signature
    StampSignOptions signOptions = new StampSignOptions()
    {
        Height = 300,
        Width = 300,
        VerticalAlignment = VerticalAlignment.Bottom,
        HorizontalAlignment = HorizontalAlignment.Right,
        Margin = new Padding() { Right = 10, Bottom = 10 },
        Background = new Background() { Color = Color.DarkOrange },
        BackgroundColorCropType = StampBackgroundCropType.OuterArea,
        ImageFilePath = @"center.jpg",
        BackgroundImageCropType = StampBackgroundCropType.InnerArea,
        AllPages = true
    };
    //add few outer round lines
    signOptions.OuterLines.Add(
        new StampLine()
        {
            Text = "* European Union *",
            TextRepeatType = StampTextRepeatType.FullTextRepeat,
            Font = new SignatureFont() { Size = 12 },
            Height = 22,
            TextBottomIntent = 6,
            TextColor = Color.WhiteSmoke,
            BackgroundColor = Color.DarkSlateBlue
        }
    );
    signOptions.OuterLines.Add(
        new StampLine()
        {
            Height = 2,
            BackgroundColor = Color.White
        }
    );
    signOptions.OuterLines.Add(
        new StampLine()
        {
            Text = "* Entrepreneur *",
            TextRepeatType = StampTextRepeatType.FullTextRepeat,
            TextColor = Color.DarkSlateBlue,
            Font = new SignatureFont() { Size = 15 },
            Height = 30,
            TextBottomIntent = 8,
            InnerBorder = new BorderLine() { Color = Color.DarkSlateBlue, DashStyle = DashStyle.Dot },
            OuterBorder = new BorderLine() { Color = Color.DarkSlateBlue },
        }
    );
    //Inner square lines
    signOptions.InnerLines.Add(
        new StampLine()
        {
            Text = "John",
            TextColor = Color.MediumVioletRed,
            Font = new SignatureFont() { Size = 20, Bold = true },
            Height = 40,
        }
    );
    signOptions.InnerLines.Add(
        new StampLine()
        {
            Text = "Smith",
            TextColor = Color.MediumVioletRed,
            Font = new SignatureFont() { Size = 20, Bold = true },
            Height = 40
        }
    );
    signOptions.InnerLines.Add(
        new StampLine()
        {
            Text = "SSN 1230242424",
            TextColor = Color.MediumVioletRed,
            Font = new SignatureFont() { Size = 12, Bold = true },
            Height = 40,
        }
    );
    // sign document
    string signedPath = @"C:\GroupDocs\Output\Pdf_Documents_Stamp.pdf";
    signature.Sign(signedPath, signOptions);
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.


---

## Add search text annotation

Path: /annotation/java/add-search-text-annotation/

Search text annotation searches for specific text and highlight it as shown in the picture below:

![](/annotation/net/images/add-text-search-annotation.png)
                          

You can specify the following properties of the [SearchTextAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/) class:

*   [BackgroundColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/#setBackgroundColor-java.lang.Integer-) defines the area background color
*   [Text](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/#setText-java.lang.String-) defines the text to be found. If the document does not contain the specific text, nothing will be highlighted
*   [FontColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/#setFontColor-java.lang.Integer-) defines the color of the text
*   [FontFamily](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/#setFontFamily-java.lang.String-) defines the name of text font
*   [FontSize](hhttps://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/#setFontSize-java.lang.Double-) defines the text font size

To add a search text annotation, follow these steps: 

1.   Instantiate the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class. Specify the input document path or stream.
2.   Instantiate the [SearchText](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [SearchTextAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/) class.
4.   Call the [Save](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows demonstrates how to add [SearchTextAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/searchtextfragment/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
//Add search text annotation to the document from local disk
try(final Annotator annotator = new Annotator("input.pdf")){
	SearchTextFragment searchTextFragment = new SearchTextFragment();
	searchTextFragment.setText("Welcome to GroupDocs");//If the document does not contain this text, nothing will be highlighted
	searchTextFragment.setFontSize(10.);
	searchTextFragment.setFontFamily("Calibri");
	searchTextFragment.setFontColor(65535);
	searchTextFragment.setBackgroundColor(16761035);
	annotator.add(searchTextFragment);
	annotator.save("result_add_search_text.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add search text annotation

Path: /annotation/net/add-search-text-annotation/

Search text annotation searches for specific text and highlight it as shown in the picture below:

![](/annotation/net/images/add-text-search-annotation.png)
                          

You can specify the following properties of the [SearchTextAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/searchtextannotation) class:

*   [BackgroundColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/searchtextannotation/properties/backgroundcolor) defines the area background color
*   [Text](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/searchtextannotation/properties/text) defines the text to be found. If the document does not contain the specific text, nothing will be highlighted
*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/searchtextannotation/properties/fontcolor) defines the color of the text
*   [FontFamily](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/searchtextannotation/properties/fontfamily) defines the name of text font
*   [FontSize](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/searchtextannotation/properties/fontsize) defines the text font size

To add a search text annotation, follow these steps: 

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [SearchText](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/searchtextannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [SearchTextAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/searchtextannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows demonstrates how to add [SearchTextAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/searchtextannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add search text annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	SearchTextFragment searchText = new SearchTextFragment()
    {
    	Text = "Welcome to GroupDocs", //If the document does not contain this text, nothing will be highlighted
        FontSize = 10,
        FontFamily = "Calibri",
        FontColor = 65535,
        BackgroundColor = 16761035,
	};
    annotator.Add(searchText);
    annotator.Save("result.pdf");
} 
```
{{< /tab >}}
{{< /tabs >}}
---

## Add text field annotation

Path: /annotation/java/add-text-field-annotation/

Text field annotation adds a rectangle with a text as shown in the picture below:

![](/annotation/java/images/add-text-field-annotation.png)

You can use the following methods to set the properties of the [TextFieldAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation) class:

*   [setBackgroundColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setBackgroundColor-java.lang.Integer-) defines the area background color
*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position at the document page
*   [setText()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setText-java.lang.String-) defines the text to place in the rectangle
*   [setFontColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setFontColor-java.lang.Integer-) defines the color of the text
*   [setFontFamily()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setFontFamily-java.lang.String-) defines the name of the text font
*   [setFontSize()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setFontSize-java.lang.Double-) defines the size of the text font
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPenStyle()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setPenStyle-java.lang.Byte-) defines the frame line style (solid, dash, dot etc.)
*   [setPenWidth()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setPenWidth-java.lang.Byte-) - defines frame line width in pixels
*   [setPenColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setPenColor-java.lang.Integer-) defines the frame color
*   [setTextHorizontalAlignment()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation/#setTextHorizontalAlignment-java.lang.Integer-) defines the text horizontal alignment

To add a text field annotation, follow these steps: 

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [TextFieldAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [TextFieldAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.  

The following code snippet shows how to add [TextFieldAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textfieldannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding text field annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of TextFieldAnnotation class and set options
    TextFieldAnnotation textField = new TextFieldAnnotation();
    textField.setBackgroundColor(65535);
    textField.setBox(new Rectangle(100, 100, 100, 100));
    textField.setCreatedOn(Calendar.getInstance().getTime());
    textField.setText("Some text");
    textField.setFontColor(65535);
    textField.setFontSize((double)12);
    textField.setMessage("This is text field annotation");
    textField.setOpacity(0.7);
    textField.setPageNumber(0);
    textField.setPenStyle(PenStyle.Dot);
    textField.setPenWidth((byte) 3);
    textField.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(textField);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Add text field annotation

Path: /annotation/net/add-text-field-annotation/

Text field annotation adds a rectangle with a text inside as shown in the picture below:

![](/annotation/net/images/add-text-field-annotation.png)

You can specify the following properties of the [TextFieldAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textfieldannotation) class:

*   [BackgroundColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/backgroundcolor) defines the area background color
*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/box) defines the annotation position at the document page
*   [Text](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/text) defines the text to place in the rectangle
*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/fontcolor) defines the color of the text
*   [FontFamily](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/fontfamily) defines the name of the text font
*   [FontSize](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/fontsize) defines the size of the text font
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/opacity) allows you to set the annotation opacity
*   [PenStyle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/penstyle) defines the frame line style (solid, dash, dot etc.)
*   [PenWidth](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/penwidth) - defines frame line width in pixels
*   [PenColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/pencolor) defines the frame color
*   [TextHorizontalAlignment]() defines the text horizontal alignment

To add a text field annotation, follow these steps: 

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [TextFieldAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textfieldannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [TextFieldAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textfieldannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.  

The following code snippet shows how to add [TextFieldAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textfieldannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add text field annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	TextFieldAnnotation textField = new TextFieldAnnotation
    {
    	BackgroundColor = 65535,
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Text = "Some text",
        FontColor = 65535,
        FontSize = 12,
        Message = "This is text field annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        FontFamily = "Arial",
        TextHorizontalAlignment = HorizontalAlignment.Center,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
	};
    annotator.Add(textField);
    annotator.Save("result.pdf");
} 
```
{{< /tab >}}
{{< /tabs >}}

---

## Convert XML as a data source to a Spreadsheet, CSV or JSON

Path: /conversion/java/convert-xml-as-datasource-to-spreadsheet-csv-json/


[GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) allows you to use XML as a structured data source and convert it into various formats such as `Spreadsheet` (XLSX), `CSV`, or `JSON`. This flexibility is beneficial for analyzing data, processing it, or integrating it into other applications. Below are examples for each type of conversion implemented in Java.

## Convert XML to Spreadsheet (XLSX)

{{< tabs "code-example">}}
{{< tab "ConvertXmlToSpreadsheet.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;
import com.groupdocs.conversion.options.load.XmlLoadOptions;

public class ConvertXmlToSpreadsheet {
    public static void convert() {
        // Initialize the Converter with XML load options
        XmlLoadOptions loadOptions = new XmlLoadOptions();
        loadOptions.setUseAsDataSource(true);

        // Initialize the Converter for the input file
        try(Converter converter = new Converter("data.xml", ()-> loadOptions) {
            // Configure spreadsheet conversion options
            SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();

            // Perform the conversion
            converter.convert("converted.xlsx", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "data.xml" >}}  
{{< tab-text >}}
`data.xml` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-xml-as-datasource-to-spreadsheet-csv-json/data.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.xlsx" >}}  
{{< tab-text >}}
`converted.xlsx` is converted XLSX document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-xml-as-datasource-to-spreadsheet-csv-json/converted.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Convert XML to CSV

{{< tabs "code-example1">}}
{{< tab "ConvertXmlToCsv.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.SpreadsheetFileType;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;
import com.groupdocs.conversion.options.load.XmlLoadOptions;

public class ConvertXmlToCsv {
    public static void convert() {
        // Initialize the Converter with XML load options
        XmlLoadOptions loadOptions = new XmlLoadOptions();
        loadOptions.setUseAsDataSource(true);

        // Initialize the Converter for the input file
        try(Converter converter = new Converter("sample.xml", ()-> loadOptions) {
            // Configure spreadsheet conversion options for CSV format
            SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
            options.setFormat(SpreadsheetFileType.Csv);

            // Perform the conversion
            converter.convert("converted.csv", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "data.xml" >}}  
{{< tab-text >}}
`data.xml` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-xml-as-datasource-to-spreadsheet-csv-json/data.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.csv" >}}  
{{< tab-text >}}
`converted.csv` is converted CSV document. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-xml-as-datasource-to-spreadsheet-csv-json/converted.csv) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Convert XML to JSON

{{< tabs "code-example2">}}
{{< tab "ConvertXmlToJson.java" >}}  
```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WebConvertOptions;
import com.groupdocs.conversion.filetypes.WebFileType;
import com.groupdocs.conversion.options.load.XmlLoadOptions;

public class ConvertXmlToJson {
    public static void convert() {
        // Initialize the Converter with XML load options
        XmlLoadOptions loadOptions = new XmlLoadOptions();
        loadOptions.setUseAsDataSource(true);

        // Initialize the Converter for the input file
        try(Converter converter = new Converter("data.xml", ()-> loadOptions) {
            // Configure web conversion options for JSON format
            WebConvertOptions options = new WebConvertOptions();
            options.setFormat(WebFileType.Json);

            // Perform the conversion
            converter.convert("converted.json", options);
        }
    }

    public static void main(String[] args){
        convert();
    }
}
```
{{< /tab >}}
{{< tab "data.xml" >}}  
{{< tab-text >}}
`data.xml` is sample file used in this example. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-xml-as-datasource-to-spreadsheet-csv-json/data.xml) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.json" >}}  
{{< tab-text >}}
`converted.json` is converted JSON file. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/convert-xml-as-datasource-to-spreadsheet-csv-json/converted.json) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}
### Key Notes:

#### XML as a Data Source:
The [XmlLoadOptions.setUseAsDataSource(true)](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.load/xmlloadoptions/#setUseAsDataSource-boolean-) treats the XML file as a structured data source, making it suitable for tabular formats (like Spreadsheet or CSV) or hierarchical formats (like JSON).
#### Conversion Options:
- [SpreadsheetConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/spreadsheetconvertoptions/): Used for converting XML to Spreadsheet or CSV.
- [WebConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/webconvertoptions/): Used for converting XML to JSON.
#### Output File Formats:
- XLSX for Excel spreadsheets.
- CSV for comma-separated values.
- JSON for structured web-friendly data.

These examples allow seamless integration of XML data into your workflows, whether for analysis, reporting, or web development.
---

## Convert XML as a data source to a Spreadsheet, CSV or JSON

Path: /conversion/net/convert-xml-as-datasource-to-spreadsheet-csv-json/


GroupDocs.Conversion for .NET enables you to effortlessly transform XML documents into various formats, such as spreadsheets (XLSX), CSV, or JSON, by using the XML content as a structured data source. This guide provides a step-by-step approach to perform these conversions, ensuring seamless integration into your applications. Whether you need to analyze data in Excel, export it to a CSV file, or structure it in JSON, GroupDocs.Conversion makes the process straightforward and efficient.

The following code snippet shows how to convert a XML file to a spreadsheet. It means that you use this XML as the data source and convert it to a spreadsheet:

```csharp
using (var converter = new Converter("data.xml", (LoadContext loadContext) => new XmlLoadOptions
       {
           UseAsDataSource = true
       }))
{
    var options = new SpreadsheetConvertOptions();
    converter.Convert("converted.xlsx", options);
}
```

## Convert XML to CSV

The following code snippet demonstrates how to convert an XML file to a CSV format. By using the XML as a data source, the data is extracted and structured into a comma-separated values (CSV) file for easy use in applications like spreadsheets or data processing tools:

```csharp
using (var converter = new Converter("sample.xml", (LoadContext loadContext) => new XmlLoadOptions
       {
           UseAsDataSource = true
       }))
{
    var options = new SpreadsheetConvertOptions
    {
        Format = SpreadsheetFileType.Csv
    };
    converter.Convert("converted.csv", options);
}
```

## Convert XML to JSON

The following code snippet illustrates how to convert an XML file to JSON format. By treating the XML as a data source, the content is structured and saved in a JSON file, making it suitable for use in web applications, APIs, or other JSON-based systems:

```csharp
using (var converter = new Converter(source, (LoadContext loadContext) => new XmlLoadOptions
       {
           UseAsDataSource = true
       }))
{
    var options = new WebConvertOptions()
    {
        Format = WebFileType.Json
    };
    converter.Convert("converted.json", options);
}
```

---

## Generate Output in Different Format

Path: /assembly/net/basic-usage-different-format-output/


## Overview

GroupDocs.Assembly for .NET allows you to generate output documents in a different format than the template. For example, you can create a DOCX template but output a PDF, or create an XLSX template but output HTML. The output format is determined by the file extension of the output path.

The main class involved is:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents and converts to output format

Here are the steps to generate output in a different format:

* Create a template document in one format (e.g., DOCX)
* Specify an output path with a different file extension (e.g., .pdf, .html)
* Assemble the document using DocumentAssembler
* The output will be automatically converted to the specified format

{{< alert style="info" >}}
Format conversion is automatic based on the output file extension. Supported conversions depend on the template format - Word templates can convert to PDF, HTML, and more, while spreadsheet templates have more limited conversion options.
{{< /alert >}}

## Convert DOCX Template to PDF

Generate a PDF from a Word template:

```csharp
using GroupDocs.Assembly;

public static void ConvertDocxToPdf()
{
    // DOCX template, PDF output
    string templatePath = "InvoiceTemplate.docx";
    string outputPath = "Invoice.pdf";
    
    var invoiceData = new { 
        CustomerName = "ABC Corp", 
        Amount = 1500.00m,
        Date = DateTime.Now
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(invoiceData, "invoice"));
    
    Console.WriteLine("PDF generated from DOCX template.");
}
```

## Convert DOCX Template to HTML

Generate an HTML file from a Word template:

```csharp
using GroupDocs.Assembly;

public static void ConvertDocxToHtml()
{
    // DOCX template, HTML output
    string templatePath = "ReportTemplate.docx";
    string outputPath = "Report.html";
    
    var reportData = new { 
        Title = "Monthly Report",
        Month = "January 2024"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(reportData, "report"));
    
    Console.WriteLine("HTML generated from DOCX template.");
}
```

## Convert DOCX Template to XPS

Generate an XPS document from a Word template:

```csharp
using GroupDocs.Assembly;

public static void ConvertDocxToXps()
{
    // DOCX template, XPS output
    string templatePath = "DocumentTemplate.docx";
    string outputPath = "Document.xps";
    
    var documentData = new { 
        Title = "Document Title",
        Content = "Document content"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(documentData, "document"));
    
    Console.WriteLine("XPS generated from DOCX template.");
}
```

## Convert XLSX Template to PDF

Generate a PDF from an Excel template:

```csharp
using GroupDocs.Assembly;

public static void ConvertXlsxToPdf()
{
    // XLSX template, PDF output
    string templatePath = "SpreadsheetTemplate.xlsx";
    string outputPath = "Spreadsheet.pdf";
    
    var data = new { 
        ReportTitle = "Sales Report",
        Quarter = "Q1 2024"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(data, "report"));
    
    Console.WriteLine("PDF generated from XLSX template.");
}
```

## Convert PPTX Template to PDF

Generate a PDF from a PowerPoint template:

```csharp
using GroupDocs.Assembly;

public static void ConvertPptxToPdf()
{
    // PPTX template, PDF output
    string templatePath = "PresentationTemplate.pptx";
    string outputPath = "Presentation.pdf";
    
    var presentationData = new { 
        Title = "Quarterly Review",
        Quarter = "Q1 2024"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(presentationData, "presentation"));
    
    Console.WriteLine("PDF generated from PPTX template.");
}
```

## Convert Email Template to PDF

Generate a PDF from an email template:

```csharp
using GroupDocs.Assembly;

public static void ConvertEmailToPdf()
{
    // MSG template, PDF output
    string templatePath = "EmailTemplate.msg";
    string outputPath = "Email.pdf";
    
    var emailData = new { 
        Recipient = "customer@example.com",
        Subject = "Invoice",
        Body = "Please find attached invoice."
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(emailData, "email"));
    
    Console.WriteLine("PDF generated from email template.");
}
```

## Supported Format Conversions

The following conversions are supported:

**From Word Processing (DOCX, DOC, RTF, etc.):**
- PDF, XPS, HTML, MHTML, EPUB, TIFF, SVG, PS, PCL, Markdown, TXT, XAML

**From Spreadsheet (XLSX, XLS, etc.):**
- PDF, XPS, HTML, MHTML, TIFF

**From Presentation (PPTX, PPT, etc.):**
- PDF, XPS, TIFF

**From Email (MSG, EML, etc.):**
- PDF, XPS, HTML, MHTML, Markdown, TXT, XAML

{{< alert style="warning" >}}
Not all format combinations are supported. Word processing templates have the most conversion options, while spreadsheet and presentation templates have more limited output formats.
{{< /alert >}}

### Advanced Usage Topics

To learn more about format-specific options, conversion settings, and advanced format handling, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Indexing password protected documents

Path: /search/java/indexing-password-protected-documents/

This page describes how to perform indexing of password protected documents.

## Indexing using the password dictionary

To perform indexing of password protected documents using a password dictionary, you must add passwords for all protected documents to the dictionary before indexing. To add a document password to the dictionary, you must specify the full path to the document as a key and the actual password to the document. For more information about managing the password dictionary see the [Document passwords]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/document-passwords.md" >}}) page in the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The password dictionary is stored on disk in encrypted form. However, very simple encryption is used, so if you want to protect the passwords themselves, it is better to use the [PasswordRequired](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#PasswordRequired) event to set passwords.

The following example demonstrates how to perform indexing of password protected documents using a password dictionary.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Adding document passwords to the dictionary
String path = new File("C:\\MyDocuments\\ProtectedDocument.pdf").getAbsolutePath();
index.getDictionaries().getDocumentPasswords().add(path, "123456");
// ...
 
// Indexing documents from the specified folder
// Passwords will be automatically retrieved from the dictionary when necessary
index.add(documentsFolder);
```

## Indexing using the PasswordRequired event

The password for the protected document can also be provided when the [PasswordRequired](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#PasswordRequired) event occurs. This method is more secure, however, it requires matching the indexed documents and their passwords in the event handler.

Both of the described methods for providing document passwords can be used together. The index first checks for a document password in the password dictionary, and then, if the password is absent, raises the [PasswordRequired](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#PasswordRequired) event. If the password is not provided or an incorrect password is provided, the index will raise the [ErrorOccurred](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#ErrorOccurred) event with the corresponding error message and the document will not be indexed. You can learn more about index events on the page [Search index events]({{< ref "search/java/developer-guide/advanced-usage/creating-an-index/search-index-events.md" >}}).

The following example shows how to provide password for a document using the [PasswordRequired](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#PasswordRequired) event.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().PasswordRequired.add(new EventHandler<PasswordRequiredEventArgs>() {
    public void invoke(Object sender, PasswordRequiredEventArgs args) {
        if (args.getDocumentFullPath().endsWith("ProtectedDocument.pdf")) {
            args.setPassword("123456"); // Providing password for the file 'ProtectedDocument.pdf'
        }
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing password protected documents

Path: /search/net/indexing-password-protected-documents/

This page describes how to perform indexing of password protected documents.

## Indexing using the password dictionary

To perform indexing of password protected documents using a password dictionary, you must add passwords for all protected documents to the dictionary before indexing. To add a document password to the dictionary, you must specify the full path to the document as a key and the actual password to the document. For more information about managing the password dictionary see the [Document passwords]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/document-passwords.md" >}}) page in the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}} section.

The password dictionary is stored on disk in encrypted form. However, very simple encryption is used, so if you want to protect the passwords themselves, it is better to use the [PasswordRequired](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/passwordrequired) event to set passwords.

The following example demonstrates how to perform indexing of password protected documents using a password dictionary.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Adding document passwords to the dictionary
string key = Path.GetFullPath(@"C:\MyDocuments\ProtectedDocument.pdf");
index.Dictionaries.DocumentPasswords.Add(key, "123456");
// ...
 
// Indexing documents from the specified folder
// Passwords will be automatically retrieved from the dictionary when necessary
index.Add(documentsFolder);
```

## Indexing using the PasswordRequired event

The password for the protected document can also be provided when the **[PasswordRequired](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/passwordrequired)** event occurs. This method is more secure, however, it requires matching the indexed documents and their passwords in the event handler.

Both of the described methods for providing document passwords can be used together. The index first checks for a document password in the password dictionary, and then, if the password is absent, raises the **[PasswordRequired](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/passwordrequired)** event. If the password is not provided or an incorrect password is provided, the index will raise the **[ErrorOccurred](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/erroroccurred)** event with the corresponding error message and the document will not be indexed. You can learn more about index events on the page [Search index events]({{< ref "search/net/developer-guide/advanced-usage/creating-an-index/search-index-events.md" >}}.

The following example shows how to provide password for a document using the **[PasswordRequired](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/passwordrequired)** event.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.PasswordRequired += (sender, args) =>
{
    if (args.DocumentFullPath.EndsWith("ProtectedDocument.pdf", StringComparison.InvariantCultureIgnoreCase))
    {
        args.Password = "123456"; // Providing password for the file 'ProtectedDocument.pdf'
    }
};
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing password protected documents

Path: /search/nodejs-java/indexing-password-protected-documents/

This page describes how to perform indexing of password protected documents.

## Indexing using the password dictionary

To perform indexing of password protected documents using a password dictionary, you must add passwords for all protected documents to the dictionary before indexing. To add a document password to the dictionary, you must specify the full path to the document as a key and the actual password to the document. For more information about managing the password dictionary see the [Document passwords]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/document-passwords.md" >}}) page in the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The password dictionary is stored on disk in encrypted form. However, very simple encryption is used, so if you want to protect the passwords themselves, it is better to use the [PasswordRequired](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#PasswordRequired) event to set passwords.

The following example demonstrates how to perform indexing of password protected documents using a password dictionary.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder, true);

// Adding document passwords to the dictionary
const path1 = path.resolve(Utils.PasswordProtectedDocumentsPath + 'English.docx');
index.getDictionaries().getDocumentPasswords().add(path1, '123456');
const path2 = path.resolve(Utils.PasswordProtectedDocumentsPath + 'Lorem ipsum.docx');
index.getDictionaries().getDocumentPasswords().add(path2, '123456');

// Indexing documents from the specified folder
// Passwords will be automatically retrieved from the dictionary when necessary
index.add(documentsFolder);
```

## Indexing using the PasswordRequired event

The password for the protected document can also be provided when the [PasswordRequired](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#PasswordRequired) event occurs. This method is more secure, however, it requires matching the indexed documents and their passwords in the event handler.

Both of the described methods for providing document passwords can be used together. The index first checks for a document password in the password dictionary, and then, if the password is absent, raises the [PasswordRequired](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#PasswordRequired) event. If the password is not provided or an incorrect password is provided, the index will raise the [ErrorOccurred](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#ErrorOccurred) event with the corresponding error message and the document will not be indexed. You can learn more about index events on the page [Search index events]({{< ref "search/nodejs-java/developer-guide/advanced-usage/creating-an-index/search-index-events.md" >}}).

The following example shows how to provide password for a document using the [PasswordRequired](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#PasswordRequired) event.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().PasswordRequired.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      if (args.getDocumentFullPath().endsWith('.docx')) {
        args.setPassword('123456'); // Providing password for DOCX files
      }
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Load Image Documents with Options

Path: /conversion/net/load-image-document-with-options/


## Introduction

The **ImageLoadOptions** class enables you to configure how image documents are loaded in GroupDocs.Conversion. This is particularly useful when you need to explicitly specify the format, configure font handling for vector images, or control font folder behavior.

ImageLoadOptions works with all common image formats including PNG, JPG, GIF, BMP, TIFF, WEBP, PSD, and more.

## Properties

| Property | Type | Description |
|----------|------|-------------|
| `Format` | `ImageFileType` | Explicitly specify the input image format (get; set;) |
| `DefaultFont` | `string` | Default font for PSD, EMF, WMF images containing text (get; set;) |
| `ResetFontFolders` | `bool` | Reset font folders before loading document (get; set;) |

## Basic Usage

For most scenarios, GroupDocs.Conversion automatically detects the image format. However, you can explicitly specify it using ImageLoadOptions:

```csharp
using (var converter = new Converter(
    "product-photo.png",
    (LoadContext loadContext) => new ImageLoadOptions
    {
        Format = ImageFileType.Png
    }))
{
    converter.Convert("product-photo.pdf", new PdfConvertOptions());
}
```

## Property Examples

### Specifying Format

Explicitly specify the input image format when automatic detection might be ambiguous or when you want to ensure a specific format is used:

```csharp
using (var converter = new Converter(
    "company-logo.png",
    (LoadContext loadContext) => new ImageLoadOptions
    {
        Format = ImageFileType.Png
    }))
{
    converter.Convert("company-logo.pdf", new PdfConvertOptions());
}
```

**Supported formats:** Jpg, Png, Gif, Bmp, Tiff, Webp, Jpeg, Ico, Psd, Heic, and more.

### DefaultFont for Vector Images

When converting vector images (PSD, EMF, WMF) that contain text, you can specify a fallback font to use if the original font is missing:

```csharp
using (var converter = new Converter(
    "design-mockup.psd",
    (LoadContext loadContext) => new ImageLoadOptions
    {
        DefaultFont = "Arial"
    }))
{
    converter.Convert("design-mockup.pdf", new PdfConvertOptions());
}
```

**When to use:**
- Converting Photoshop files (PSD) with text layers
- Converting Enhanced Metafiles (EMF) containing text
- Converting Windows Metafiles (WMF) with embedded text
- Ensuring consistent rendering when fonts are unavailable

### ResetFontFolders

Control font folder configuration when loading images:

```csharp
using (var converter = new Converter(
    "banner-ad.png",
    (LoadContext loadContext) => new ImageLoadOptions
    {
        ResetFontFolders = true
    }))
{
    converter.Convert("banner-ad.pdf", new PdfConvertOptions());
}
```

**Use case:** When you need to ensure a clean font environment for consistent rendering across different systems.

## Using All Properties Together

Combine all ImageLoadOptions properties for complete control:

```csharp
using (var converter = new Converter(
    "banner-ad.png",
    (LoadContext loadContext) => new ImageLoadOptions
    {
        Format = ImageFileType.Png,
        DefaultFont = "Calibri",
        ResetFontFolders = true
    }))
{
    converter.Convert("banner-ad.docx", new WordProcessingConvertOptions());
}
```

## Common Scenarios

### Converting Different Image Formats

GroupDocs.Conversion supports converting images to various output formats:

#### Image to PDF

```csharp
using (var converter = new Converter(
    "profile-picture.png",
    (LoadContext loadContext) => new ImageLoadOptions { Format = ImageFileType.Png }))
{
    converter.Convert("profile-picture.pdf", new PdfConvertOptions());
}
```

#### Image to Word Document

```csharp
using (var converter = new Converter(
    "screenshot.png",
    (LoadContext loadContext) => new ImageLoadOptions { Format = ImageFileType.Png }))
{
    converter.Convert("screenshot.docx", new WordProcessingConvertOptions());
}
```

#### Image to Excel Spreadsheet

```csharp
using (var converter = new Converter(
    "thumbnail.png",
    (LoadContext loadContext) => new ImageLoadOptions { Format = ImageFileType.Png }))
{
    converter.Convert("thumbnail.xlsx", new SpreadsheetConvertOptions());
}
```

## When to Use ImageLoadOptions

Use ImageLoadOptions when you need to:

1. **Explicitly specify format** - When automatic detection might be insufficient or you want to enforce a specific format
2. **Handle missing fonts** - When converting vector images (PSD, EMF, WMF) that might have font availability issues
3. **Control font behavior** - When you need to reset font folders for consistent rendering
4. **Process ambiguous files** - When files have incorrect extensions or no extensions

## Without ImageLoadOptions

For simple conversions, you can rely on automatic format detection:

```csharp
using (var converter = new Converter("product-photo.png"))
{
    converter.Convert("product-photo.pdf", new PdfConvertOptions());
}
```

GroupDocs.Conversion automatically detects the format in most cases, so ImageLoadOptions is optional unless you need the specific configuration it provides.

## Supported Image Formats

ImageLoadOptions works with:
- **Raster formats**: PNG, JPG/JPEG, GIF, BMP, TIFF, WEBP, HEIC
- **Vector formats**: EMF, WMF, SVG
- **Professional formats**: PSD (Photoshop), ICO (Icons)

## Summary

ImageLoadOptions provides fine-grained control over image document loading:
- **Format**: Explicitly specify the input image format
- **DefaultFont**: Set fallback font for vector images with text
- **ResetFontFolders**: Control font folder configuration

All examples on this page have been verified through automated testing to ensure accuracy.

## See Also

- [Context Objects - Complete Guide]({{< ref "conversion/net/developer-guide/basic-usage/context-objects-complete-guide" >}})
- [ImageFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/imagefiletype/)
- [ImageLoadOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/imageloadoptions/)

---

## Output adapters

Path: /search/java/output-adapters/

Output adapters are used to output generated HTML or plain text to various output objects. The following output adapters are currently supported:

*   [FileOutputAdapter](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/FileOutputAdapter) is an output adapter that is used to output text to a file. The path to a file is specified in the constructor of the adapter.
*   [StreamOutputAdapter](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/StreamOutputAdapter) is an output adapter that is used to output text to a stream. The stream is specified in the constructor of the adapter.
*   [StringOutputAdapter](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/StringOutputAdapter) is an output adapter that is used to output text to a string. The resulting string can be accessed through the [getResult](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/StringOutputAdapter#getResult()) method of the adapter class.
*   [StructureOutputAdapter](https://reference.groupdocs.com/search/java/groupdocs.search.common/StructureOutputAdapter) is an output adapter that is used to output the text of each field of the document separately. The resulting array of fields can be accessed through the [getResult](https://reference.groupdocs.com/search/java/groupdocs.search.common/StructureOutputAdapter#getResult()) method of the adapter class.

The example below demonstates how to use adapters of different types.

```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";

// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Getting list of indexed documents
DocumentInfo[] documents = index.getIndexedDocuments();

// Getting a document text
if (documents.length > 0) {
    DocumentInfo document = documents[0];

    // Output to a file
    FileOutputAdapter fileOutputAdapter = new FileOutputAdapter(OutputFormat.Html, "C:\\Text.html");
    index.getDocumentText(document, fileOutputAdapter);

    // Output to a stream
    try (OutputStream stream = new ByteArrayOutputStream()) {
        StreamOutputAdapter streamOutputAdapter = new StreamOutputAdapter(OutputFormat.Html, stream);
        index.getDocumentText(document, streamOutputAdapter);
    }

    // Output to a string
    StringOutputAdapter stringOutputAdapter = new StringOutputAdapter(OutputFormat.Html);
    index.getDocumentText(document, stringOutputAdapter);
    String htmlText = stringOutputAdapter.getResult();
    System.out.println(htmlText);

    // Output to a structure
    StructureOutputAdapter structureOutputAdapter = new StructureOutputAdapter(OutputFormat.PlainText);
    index.getDocumentText(document, structureOutputAdapter);
    DocumentField[] fields = structureOutputAdapter.getResult();
    System.out.println(document.toString());
    for (DocumentField field : fields) {
        System.out.println("\t" + field.getName());
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Output adapters

Path: /search/net/output-adapters/

Output adapters are used to output generated HTML or plain text to various output objects. The following output adapters are currently supported:

*   [FileOutputAdapter](https://reference.groupdocs.com/net/search/groupdocs.search.common/fileoutputadapter) is an output adapter that is used to output text to a file. The path to a file is specified in the constructor of the adapter.
*   [StreamOutputAdapter](https://reference.groupdocs.com/net/search/groupdocs.search.common/streamoutputadapter) is an output adapter that is used to output text to a stream. The stream is specified in the constructor of the adapter.
*   [StringOutputAdapter](https://reference.groupdocs.com/net/search/groupdocs.search.common/stringoutputadapter) is an output adapter that is used to output text to a string. The resulting string can be accessed through the [GetResult](https://reference.groupdocs.com/net/search/groupdocs.search.common/stringoutputadapter/methods/getresult) method of the adapter class.
*   [StructureOutputAdapter](https://reference.groupdocs.com/net/search/groupdocs.search.common/structureoutputadapter) is an output adapter that is used to output the text of each field of the document separately. The resulting array of fields can be accessed through the [GetResult](https://reference.groupdocs.com/net/search/groupdocs.search.common/structureoutputadapter/methods/getresult) method of the adapter class.

The example below demonstates how to use adapters of different types.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.TextStorageSettings = new TextStorageSettings(Compression.High); // Enabling storage of extracted text in the index

// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);

// Indexing documents from the specified folder
index.Add(documentsFolder);

// Getting list of indexed documents
DocumentInfo[] documents = index.GetIndexedDocuments();

// Getting a document text
if (documents.Length > 0)
{
    DocumentInfo document = documents[0];

    // Output to a file
    FileOutputAdapter fileOutputAdapter = new FileOutputAdapter(OutputFormat.Html, @"C:\Text.html");
    index.GetDocumentText(document, fileOutputAdapter);

    // Output to a stream
    using (Stream stream = new MemoryStream())
    {
        StreamOutputAdapter streamOutputAdapter = new StreamOutputAdapter(OutputFormat.Html, stream);
        index.GetDocumentText(document, streamOutputAdapter);
    }

    // Output to a string
    StringOutputAdapter stringOutputAdapter = new StringOutputAdapter(OutputFormat.Html);
    index.GetDocumentText(document, stringOutputAdapter);
    string htmlText = stringOutputAdapter.GetResult();
    Console.WriteLine(htmlText);

    // Output to a structure
    StructureOutputAdapter structureOutputAdapter = new StructureOutputAdapter(OutputFormat.PlainText);
    index.GetDocumentText(document, structureOutputAdapter);
    DocumentField[] fields = structureOutputAdapter.GetResult();
    Console.WriteLine(document.ToString());
    for (int i = 0; i < fields.Length; i++)
    {
        DocumentField field = fields[i];
        Console.WriteLine("\t" + field.Name);
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Output adapters

Path: /search/nodejs-java/output-adapters/

Output adapters are used to output generated HTML or plain text to various output objects. The following output adapters are currently supported:

*   [FileOutputAdapter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/FileOutputAdapter) is an output adapter that is used to output text to a file. The path to a file is specified in the constructor of the adapter.
*   [StreamOutputAdapter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/StreamOutputAdapter) is an output adapter that is used to output text to a stream. The stream is specified in the constructor of the adapter.
*   [StringOutputAdapter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/StringOutputAdapter) is an output adapter that is used to output text to a string. The resulting string can be accessed through the [getResult](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/StringOutputAdapter#getResult()) method of the adapter class.
*   [StructureOutputAdapter](https://reference.groupdocs.com/search/nodejs-java/groupdocs.search.common/StructureOutputAdapter) is an output adapter that is used to output the text of each field of the document separately. The resulting array of fields can be accessed through the [getResult](https://reference.groupdocs.com/search/nodejs-java/groupdocs.search.common/StructureOutputAdapter#getResult()) method of the adapter class.

The example below demonstates how to use adapters of different types.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index settings instance
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High)); // Enabling the storage of extracted text in the index

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Getting list of indexed documents
const documents = index.getIndexedDocuments();

// Getting a document text
if (documents.length > 0) {
  const document = documents[0];

  // Output to a file
  const fileOutputAdapter = new groupdocs.search.FileOutputAdapter(groupdocs.search.OutputFormat.Html, 'c:/Result.html/');
  index.getDocumentText(document, fileOutputAdapter);

  // Output to a stream
  const stream = java.newInstanceSync('java.io.ByteArrayOutputStream');
  const streamOutputAdapter = new groupdocs.search.StreamOutputAdapter(groupdocs.search.OutputFormat.Html, stream);
  index.getDocumentText(document, streamOutputAdapter);

  // Output to a string
  const stringOutputAdapter = new groupdocs.search.StringOutputAdapter(groupdocs.search.OutputFormat.Html);
  index.getDocumentText(document, stringOutputAdapter);
  const result = stringOutputAdapter.getResult();
  //console.log(result);

  // Output to a structure
  const structureOutputAdapter = new groupdocs.search.StructureOutputAdapter(groupdocs.search.OutputFormat.PlainText);
  index.getDocumentText(document, structureOutputAdapter);
  const fields = structureOutputAdapter.getResult();
  console.log(document.toString());
  for (const field of fields) {
    console.log('\t' + field.getName());
  }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Render images as HTML, PDF, PNG, and JPEG files

Path: /viewer/net/render-images/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to load images in various formats and convert them to HTML, PDF, PNG, and JPEG. Incorporate this library into your .NET application (web or desktop) to build your own image viewer.

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass an image you want to view to the class constructor. You can load the image from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the image to HTML, PDF, PNG, or JPEG format. For multipage images (such as TIFF, CDR, DICOM, WebP, and so on), you can specify the pages to render.

{{< button style="primary" link="https://products.groupdocs.app/viewer/image" >}} {{< icon "gdoc_person" >}} View image files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported image file formats

GroupDocs.Viewer supports the following image file formats:

* [.AI (Adobe Illustrator Artwork)](https://docs.fileformat.com/image/ai/)
* [.APNG (Animated Portable Network Graphic)](https://docs.fileformat.com/image/apng/)
* [.BMP (Bitmap Image)](https://docs.fileformat.com/image/bmp)
* [.CDR (CorelDRAW Image File)](https://docs.fileformat.com/image/cdr)
* [.CGM (Computer Graphics Metafile)](https://docs.fileformat.com/page-description-language/cgm)
* [.CMX (Corel Presentation Exchange Image)](https://docs.fileformat.com/image/cmx)
* [.DCM (DICOM Image)](https://docs.fileformat.com/image/dicom)
* [.DIB (Device Independent Bitmap File)](https://docs.fileformat.com/image/dib)
* [.DJVU (DjVu Image)](https://docs.fileformat.com/image/djvu)
* [.DNG (Digital Negative Image)](https://docs.fileformat.com/image/dng)
* [.EMF (Enhanced Windows Metafile)](https://docs.fileformat.com/image/emf)
* [.EMZ (Windows Compressed Enhanced Metafile)](https://docs.fileformat.com/image/emz/)
* [.EPS (Encapsulated PostScript File)](https://docs.fileformat.com/page-description-language/eps)
* [.FODG (OpenDocument Flat XML Graphics)](https://docs.fileformat.com/image/fodg/)
* [.GIF (Graphical Interchange Format)](https://docs.fileformat.com/image/gif)
* [.ICO (Icon File)](https://docs.fileformat.com/image/ico)
* [.J2C (JPEG 2000 Code Stream)](https://docs.fileformat.com/image/j2c/)
* [.J2K (JPEG 2000 Image)](https://docs.fileformat.com/image/j2k/)
* [.JP2 (JPEG 2000 Core Image File)](https://docs.fileformat.com/image/jp2/)
* [.JPC (JPEG 2000 Code Stream File)](https://docs.fileformat.com/image/jpc/)
* [.JPEG / .JPG (JPEG Image)](https://docs.fileformat.com/image/jpeg)
* [.JPF (JPEG 2000 Image)](https://docs.fileformat.com/image/jpf/)
* [.JPM (JPEG 2000 Multi-layer Image Format)](https://docs.fileformat.com/image/jpm/)
* [.JPX (JPEG 2000 Image File)](https://docs.fileformat.com/image/jpx/)
* [.JLS (JPEG-LS Image)](https://docs.fileformat.com/)
* [.ODG (OpenDocument Graphics File)](https://docs.fileformat.com/image/odg)
* [.OTG (OpenDocument Graphic Template)](https://docs.fileformat.com/image/otg/)
* [.PCL (Printer Command Language Document)](https://docs.fileformat.com/page-description-language/pcl)
* [.PNG (Portable Network Graphics)](https://docs.fileformat.com/image/png)
* [.PS (PostScript File)](https://docs.fileformat.com/page-description-language/ps)
* [.PSB (Photoshop Large Document Format)](https://docs.fileformat.com/image/psb)
* [.PSD (Adobe Photoshop Document)](https://docs.fileformat.com/image/psd)
* [.SVG (Scalable Vector Graphics File)](https://docs.fileformat.com/page-description-language/svg)
* [.SVGZ (Compressed SVG File)](https://docs.fileformat.com/image/svgz/)
* [.TGA (TARGA Graphics)](https://docs.fileformat.com/image/tga/) 
* [.TIF / .TIFF (Tagged Image File Format)](https://docs.fileformat.com/image/tiff)
* [.WEBP (WebP Image)](https://docs.fileformat.com/image/webp)
* [.WMF (Windows Metafile)](https://docs.fileformat.com/image/wmf)
* [.WMZ (Compressed Windows Metafile)](https://docs.fileformat.com/image/wmz/)

GroupDocs.Viewer can detect the image format automatically based on information in the file header.

{{< alert style="info" >}}All Photoshop-related image formats (AI, PSD, and PSB) currently are not supported by the GroupDocs.Viewer.CrossPlatform.{{< /alert >}}

## Render images as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an image to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and optimize it for printing. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an image in an HTML page, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("vector-image.svg"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("vector-image.svg")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to HTML](/viewer/net/images/rendering-basics/render-images/render-image-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an image to a separate folder, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("vector-image.svg"))
{
    // Specify the HTML file name and location of external resources.
    // {0} is replaced with the resource name in the output file name.
    var viewOptions = HtmlViewOptions.ForExternalResources("output.html", "output/resource_{0}", "output/resource_{0}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("vector-image.svg")
            ' Specify the HTML file name and location of external resources.
            ' {0} is replaced with the resource name in the output file name.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("output.html", "output/resource_{0}",    "output/resource_{0}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The result is shown below. The image is placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-images/render-image-to-html-external-resources.png)

## Render images as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an image to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("vector-image.svg"))
{
    // Create a PDF file.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("vector-image.svg")
            ' Create a PDF file.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PDF](/viewer/net/images/rendering-basics/render-images/render-image-to-pdf.png)

## Convert images to PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an image to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("vector-image.svg"))
{
    // Create a PNG image.
    var viewOptions = new PngViewOptions("output.png");
    // Set width and height.
    viewOptions.Width = 1600;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("vector-image.svg")
            ' Create a PNG image.
            Dim viewOptions = New PngViewOptions("output.png")
            ' Set width and height.
            viewOptions.Width = 1600
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an image to PNG](/viewer/net/images/rendering-basics/render-images/render-image-to-png.png)

## Convert images to JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an image to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("vector-image.svg"))
{
    // Create a JPEG image.
    var viewOptions = new JpgViewOptions("output.jpg");
    // Set width and height.
    viewOptions.Width = 1600;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("vector-image.svg")
            ' Create a JPEG image.
            Dim viewOptions = New JpgViewOptions("output.jpg")
            ' Set width and height.
            viewOptions.Width = 1600
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Render a PSD file with custom fonts

When you render a PSD file with custom fonts, you can specify a folder that contains necessary fonts to prevent font substitution during rendering. To do this, follow the steps below:

1. Create a [FolderFontSource](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/folderfontsource) class instance and specify a path to the folder that stores custom fonts. Pass a [SearchOption](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/folderfontsource/properties/searchoption) enumeration member to the class constructor to define the search scope. The following options are available:
    * `TopFolderOnly`---Searches for the fonts only in the current folder.
    * `AllFolders`---Searches for the fonts in the current folder and its subfolders.

2. Call the [FontSettings.SetFontSources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.fonts/fontsettings/methods/setfontsources) static method and pass the specified font source to this method as a parameter. This method allows you to specify multiple font sources.

You can also set the [ViewOptions.DefaultFontName](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/defaultfontname) property to specify the default font that should be used when a particular font is not found.

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Fonts;
using GroupDocs.Viewer.Options;
// ...

// Specify a folder that stores custom fonts used in a PSD file.
var fontSource = new FolderFontSource(@"C:\custom_fonts_folder", SearchOption.AllFolders);
FontSettings.SetFontSources(fontSource);

using (var viewer = new Viewer("sample.psd"))
{
    // Convert a PSD file to PNG.
    var viewOptions = new PngViewOptions("output.png");
    // Specify the default font that should be used to replace missing fonts.
    viewOptions.DefaultFontName = "Arial";
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Fonts
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        ' Specify a folder that stores custom fonts used in a PSD file.
        Dim fontSource = New FolderFontSource("C:\custom_fonts_folder", SearchOption.AllFolders)
        FontSettings.SetFontSources(fontSource)
    
        Using viewer = New Viewer("sample.psd")
            ' Convert a PSD file to PNG.
            Dim viewOptions = New PngViewOptions("output.png")
            ' Specify the default font that should be used to replace missing fonts.
            viewOptions.DefaultFontName = "Arial"
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Render Outlook data files as HTML, PDF, and image files

Path: /viewer/java/render-outlook-data-files/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render Microsoft Outlook data files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of OST and PST files within your Java application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/outlook" >}} {{< icon "gdoc_person" >}} View Outlook files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Outlook data file formats

GroupDocs.Viewer supports the following Outlook data file formats:

* [Outlook Offline Storage Table](https://docs.fileformat.com/email/ost) (.OST)
* [Outlook Personal Storage Table](https://docs.fileformat.com/email/pst) (.PST)

## Render Outlook data files as HTML

To convert an OST or PST file to HTML, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pst")) {
    // Specify the HTML file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to HTML](/viewer/java/images/rendering-basics/render-outlook-files/render-pst-to-html.png)

## Render Outlook data files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an OST or PST file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pst")) {
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PDF](/viewer/java/images/rendering-basics/render-outlook-files/render-pst-to-pdf.png)

## Render Outlook data files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an OST or PST file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pst")) {
    // Convert the PST file to PNG.
    // {0} is replaced with the page numbers in the output image names.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PNG](/viewer/java/images/rendering-basics/render-outlook-files/render-pst-to-png.png)

## Render Outlook data files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an OST or PST file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.pst")) {
    // Convert the PST file to JPG.
    // {0} is replaced with the page numbers in the output image names.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Get information about folders in an Outlook data file

Follow the steps below to obtain information about folders contained in an Outlook data file.

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [OutlookViewInfo](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/outlookviewinfo/) type.
3. Use the [OutlookViewInfo.getFolders](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.results/outlookviewinfo/#getFolders--) method to obtain the list of folders in the Outlook data file.

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.OutlookViewInfo;
// ...

ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
OutlookViewInfo viewInfo;
try (Viewer viewer = new Viewer("sample.pst")) {
    viewInfo = (OutlookViewInfo) viewer.getViewInfo(viewInfoOptions);
}
// Display information about the PST file.
System.out.println("File type: " + viewInfo.getFileType());
System.out.println("The number of pages: " + viewInfo.getPages().size());
// Display the list of folders that the PST file contains.
System.out.println("The file contains the following folders:");
for (String folder : viewInfo.getFolders()) {
    System.out.println(folder);
}
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [OutlookOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/outlookoptions) class that allows you to specify different options for rendering Outlook data files. To access these options, use the [setOutlookOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setOutlookOptions-com.groupdocs.viewer.options.OutlookOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

### Render a specific folder

When you convert an OST or PST file to HTML, PDF, or image format, GroupDocs.Viewer renders messages from all folders contained in the file (including nested folders). If you want to render items from a specific folder, use the [OutlookOptions.setFolder](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/outlookoptions/#setFolder-java.lang.String-) method for a target view. Specify the folder name as follows: `{Parent folder name}\\{Subfolder name}`.


{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

// Create an HTML file.
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
// Render messages from the "Inbox" folder and its subfolders.
viewOptions.getOutlookOptions().setFolder("Inbox");
try (Viewer viewer = new Viewer("sample.pst")) {
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Limit the number of folder items to render

When you load large Outlook data files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [OutlookOptions.setMaxItemsInFolder](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/outlookoptions/#setMaxItemsInFolder-int-) method to limit the number of rendered items (messages, contacts, or tasks) in each folder. The default property value is **50**. Set this property to **0** to render all existing items. 

The following example demonstrates how to specify the maximum number of folder items to render:

{{< tabs "example7">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

// Create an HTML file.
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources();
// Specify the maximum number of folder items.
viewOptions.getOutlookOptions().setMaxItemsInFolder(30);
try (Viewer viewer = new Viewer("sample.pst")) {
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Filter messages

Microsoft Outlook allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in Microsoft Outlook](/viewer/java/images/rendering-basics/render-outlook-files/filter-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering an Outlook data file to HTML, PDF, or image format. To do this, use the following methods:

* [OutlookOptions.setTextFilter](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/outlookoptions/#setTextFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the subject or body.
* [OutlookOptions.setAddressFilter](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/outlookoptions/#setAddressFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in a PST file before rendering this file to HTML:

{{< tabs "example8">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.nsf")) {
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    // Set filters.
    viewOptions.getOutlookOptions().setTextFilter("Viewer");
    viewOptions.getOutlookOptions().setAddressFilter("groupdocs.com");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Render Outlook data files as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-outlook-data-files/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to render Microsoft Outlook data files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of OST and PST files within your Node.js application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/outlook" >}} {{< icon "gdoc_person" >}} View Outlook files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Outlook data file formats

GroupDocs.Viewer supports the following Outlook data file formats:

* [Outlook Offline Storage Table](https://docs.fileformat.com/email/ost) (.OST)
* [Outlook Personal Storage Table](https://docs.fileformat.com/email/pst) (.PST)

## Render Outlook data files as HTML

To convert an OST or PST file to HTML, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method.

{{< tabs "render-pst-to-html">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pst")
// Specify the HTML file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-pst-to-html/pst-to-html.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to HTML](/viewer/nodejs-java/images/rendering-basics/render-outlook-files/render-pst-to-html.png)

## Render Outlook data files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an OST or PST file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-pst-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pst")
// Create a PDF file.
const viewOptions = PdfViewOptions("render-pst-to-pdf/pst-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PDF](/viewer/nodejs-java/images/rendering-basics/render-outlook-files/render-pst-to-pdf.png)

## Render Outlook data files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an OST or PST file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-pst-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pst")
// Convert the PST file to PNG.
// {0} is replaced with the page numbers in the output image names.
const viewOptions = PngViewOptions("render-pst-to-png/pst-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PNG](/viewer/nodejs-java/images/rendering-basics/render-outlook-files/render-pst-to-png.png)

## Render Outlook data files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an OST or PST file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-pst-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pst")
// Convert the PST file to JPG.
// {0} is replaced with the page numbers in the output image names.
const viewOptions = JpgViewOptions("render-pst-to-jpeg/pst-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Get information about folders in an Outlook data file

Follow the steps below to obtain information about folders contained in an Outlook data file.

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [OutlookViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/outlookviewinfo/) type.
3. Use the [OutlookViewInfo.getFolders](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/outlookviewinfo/#getFolders--) method to obtain the list of folders in the Outlook data file.

{{< tabs "get-pst-folders-info">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions } from '@groupdocs/groupdocs.viewer';

function readFolders(viewer, viewInfoOptions, folder) {
  viewInfoOptions.getOutlookOptions().setFolder(folder)

  const viewInfo = viewer.getViewInfo(viewInfoOptions)
  const folders = viewInfo.getFolders()

  for (let i = 0; i < folders.size(); i++) {
    console.log(" - ", folders.get(i).toString())
    readFolders(viewer, viewInfoOptions, folders.get(i).toString())
  }
}

const viewer = new Viewer("sample.pst")
  
const viewInfoOptions = ViewInfoOptions.forHtmlView()
const viewInfo = viewer.getViewInfo(viewInfoOptions)

// Display information about the PST file.
console.log("File type: " + viewInfo.getFileType())
console.log("Pages count: " + viewInfo.getPages().size())
// Display the list of folders that the PST file contains.
console.log("The file contains the following folders:")
console.log(" - /")
readFolders(viewer, viewInfoOptions, "")
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [OutlookOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/outlookoptions) class that allows you to specify different options for rendering Outlook data files. To access these options, use the [setOutlookOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/baseviewoptions/#setOutlookOptions-com.groupdocs.viewer.options.OutlookOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

### Render a specific folder

When you convert an OST or PST file to HTML, PDF, or image format, GroupDocs.Viewer renders messages from all folders contained in the file (including nested folders). If you want to render items from a specific folder, use the [OutlookOptions.setFolder](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/outlookoptions/#setFolder-java.lang.String-) method for a target view. Specify the folder name as follows: `{Parent folder name}\\{Subfolder name}`.


{{< tabs "render-pst-specific-folder">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pst")
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources()
// Render messages from the "Deleted Items" folder and its subfolders.
viewOptions.getOutlookOptions().setFolder("Deleted Items")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Limit the number of folder items to render

When you load large Outlook data files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [OutlookOptions.setMaxItemsInFolder](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/outlookoptions/#setMaxItemsInFolder-int-) method to limit the number of rendered items (messages, contacts, or tasks) in each folder. The default property value is **50**. Set this property to **0** to render all existing items. 

The following example demonstrates how to specify the maximum number of folder items to render:

{{< tabs "render-pst-limit-items">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pst")
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources()
// Specify the maximum number of folder items.
viewOptions.getOutlookOptions().setMaxItemsInFolder(30)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Filter messages

Microsoft Outlook allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in Microsoft Outlook](/viewer/nodejs-java/images/rendering-basics/render-outlook-files/filter-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering an Outlook data file to HTML, PDF, or image format. To do this, use the following methods:

* [OutlookOptions.setTextFilter](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/outlookoptions/#setTextFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the subject or body.
* [OutlookOptions.setAddressFilter](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/outlookoptions/#setAddressFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in a PST file before rendering this file to HTML:

{{< tabs "render-pst-filter-messages">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.pst")
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-pst-filter-messages/pst-to-html.html")
// Set filters.
viewOptions.getOutlookOptions().setTextFilter("Viewer")
viewOptions.getOutlookOptions().setAddressFilter("groupdocs.com")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Render Outlook data files as HTML, PDF, and image files

Path: /viewer/python-net/render-outlook-data-files/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to render Microsoft Outlook data files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of OST and PST files within your .NET application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/outlook" >}} {{< icon "gdoc_person" >}} View Outlook files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Outlook data file formats

GroupDocs.Viewer supports the following Outlook data file formats:

* [Outlook Offline Storage Table](https://docs.fileformat.com/email/ost) (.OST)
* [Outlook Personal Storage Table](https://docs.fileformat.com/email/pst) (.PST)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render Outlook data files as HTML

To convert an OST or PST file to HTML, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_outlook_to_html():
    # Load Outlook data file
    with Viewer("sample.pst") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_outlook_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_outlook_to_html()
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to HTML](/viewer/python-net/images/rendering-basics/render-outlook-files/render-pst-to-html.png)

## Render Outlook data files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an OST or PST file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_outlook_to_pdf():
    # Load Outlook data file
    with Viewer("sample.pst") as viewer:
        # Create a PDF file.
        viewOptions = PdfViewOptions("render_outlook_to_pdf/outlook_data.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_outlook_to_pdf()
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PDF](/viewer/python-net/images/rendering-basics/render-outlook-files/render-pst-to-pdf.png)

## Render Outlook data files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an OST or PST file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_outlook_to_png():
    # Load Outlook data file
    with Viewer("sample.pst") as viewer:
        # Convert the PST file to PNG.
        # {0} is replaced with the page numbers in the output image names.
        viewOptions = PngViewOptions("render_outlook_to_png/outlook_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_outlook_to_png()
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PNG](/viewer/python-net/images/rendering-basics/render-outlook-files/render-pst-to-png.png)

## Render Outlook data files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an OST or PST file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_outlook_to_jpg():
    # Load Outlook data file
    with Viewer("sample.pst") as viewer:
        # Convert the PST file to JPEG.
        # {0} is replaced with the page numbers in the output image names.
        viewOptions = JpgViewOptions("render_outlook_to_jpg/outlook_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 900
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_outlook_to_jpg()
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [OutlookOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/outlookoptions) class that allows you to specify different options for rendering Outlook data files. To access these options, use the [outlook_options](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/#properties) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

### Render a specific folder

When you convert an OST or PST file to HTML, PDF, or image format, GroupDocs.Viewer renders messages from all folders contained in the file (including nested folders). If you want to render items from a specific folder, set the [outlook_options.folder](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/outlookoptions/#properties) property for a target view. Specify the folder name as follows: `{Parent folder name}\\{Subfolder name}`.


{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_outlook_specific_folder():
    # Load Outlook data file
    with Viewer("sample.pst") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_outlook_specific_folder/outlook_specific_folder.html")
        # Render messages from the "Inbox" folder and its subfolders.
        viewOptions.outlook_options.folder = "Inbox"
        # Render messages from a specific subfolder in the "Inbox" folder.
        # viewOptions.outlook_options.folder = "Inbox\\Work\\Urgent"
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_outlook_specific_folder()
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Limit the number of folder items to render

When you load large Outlook data files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [OutlookOptions.max_items_in_folder](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/outlookoptions/#properties) property to limit the number of rendered items (messages, contacts, or tasks) in each folder. The default property value is **50**. Set this property to **0** to render all existing items. 

The following example demonstrates how to specify the maximum number of folder items to render:

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_outlook_with_max_items():
    # Load Outlook data file
    with Viewer("sample.pst") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_outlook_with_max_items/outlook_with_max_items.html")
        # Specify the maximum number of folder items.
        viewOptions.outlook_options.max_items_in_folder = 30
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_outlook_with_max_items()
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Filter messages

Microsoft Outlook allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in Microsoft Outlook](/viewer/python-net/images/rendering-basics/render-outlook-files/filter-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering an Outlook data file to HTML, PDF, or image format. To do this, use the following properties:

* [OutlookOptions.text_filter](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/outlookoptions/#properties)---Allows you to render all messages that contain specific text in the subject or body.
* [OutlookOptions.address_filter](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/outlookoptions/#properties)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in a PST file before rendering this file to HTML:

{{< tabs "example7">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_outlook_with_filters():
    # Load Outlook data file
    with Viewer("sample.pst") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_outlook_with_filters/outlook_with_filters.html")
        # Set filters.
        viewOptions.outlook_options.text_filter = "Viewer"
        viewOptions.outlook_options.address_filter = "groupdocs.com"
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_outlook_with_filters()
```
{{< /tab >}}
{{< tab "sample.pst" >}}
{{< tab-text >}}
`sample.pst` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-outlook-data-files/sample.pst) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Show results of comparison as a Word Track Changes

Path: /comparison/java/word-track-changes/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to customize the display of revisions in the output document.

Revision is a collection of changes received when comparing documents using built-in Word tools.

By default, the Word Track Changes option is `false`. Follow these steps to turn on the Word Track Changes:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/) object. Specify the source file path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object. Set the [WordTrackChanges](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setWordTrackChanges-boolean-) property to `true`;
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object from the previous step.

The following code snippet shows how to disable the display of revisions:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    CompareOptions options = new CompareOptions();
    options.setWordTrackChanges(true);
    comparer.compare(resultPath, options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                     WordTrackChanges true                      |
| :------------------------------------------------------------: |
| ![](/comparison/java/images/word-track-changes-option-true.png) |




|                     WordTrackChanges false                      |
| :-------------------------------------------------------------: |
| ![](/comparison/java/images/word-track-changes-option-false.png) |


---

## Show results of comparison as a Word Track Changes

Path: /comparison/net/word-track-changes/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to customize the display of revisions in the output document.

Revision is a collection of changes received when comparing documents using built-in Word tools.

By default, the Word Track Changes option is `false`. Follow these steps to turn on the Word Track Changes:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify the source file path or stream.
2.  Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/add/index) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. Set the [WordTrackChanges](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/wordtrackchanges) property to `true`;
4.  Call the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how to disable the display of revisions:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions options = new CompareOptions() { WordTrackChanges = true };
    comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                     WordTrackChanges true                      |
| :------------------------------------------------------------: |
| ![](/comparison/net/images/word-track-changes-option-true.png) |




|                     WordTrackChanges false                      |
| :-------------------------------------------------------------: |
| ![](/comparison/net/images/word-track-changes-option-false.png) |


---

## Show results of comparison as a Word Track Changes

Path: /comparison/nodejs-java/word-track-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to customize the display of revisions in the output document.

Revision is a collection of changes received when comparing documents using built-in Word tools.

By default, the Word Track Changes option is `false`. The following code snippet shows how to enable Word Track Changes:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and result documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const resultPath = 'sample-files/result_word_track.docx';

// Create a comparer instance using the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to the comparison set
comparer.add(targetPath);

// Initialize comparison options
const options = new groupdocs.CompareOptions();

// Enable Word Track Changes in the output document
options.setWordTrackChanges(true);

// Perform the comparison and save the result to the specified path
comparer.compare(resultPath, options);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It enables Word Track Changes by setting `setWordTrackChanges(true)`. When the comparison is performed, the result document will use Microsoft Word's built-in Track Changes feature to display revisions, making it compatible with Word's revision tracking system and allowing users to accept or reject changes directly in Word.

The result is as follows:

|                     WordTrackChanges true                      |
| :------------------------------------------------------------: |
| ![](/comparison/nodejs-java/images/word-track-changes-option-true.png) |




|                     WordTrackChanges false                      |
| :-------------------------------------------------------------: |
| ![](/comparison/nodejs-java/images/word-track-changes-option-false.png) |


---

## Sign document with Stamp signature - advanced

Path: /signature/java/sign-document-with-stamp-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [StampSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/StampSignOptions) class with additional properties to specify different options for Stamp Signature. This signature type implements stamps with different implementation, forms, lines etc. Each Stamp option contains inner and outer lines. Inner lines represent vertical lines inside the stamp, when outer lines represent circles (or rectangles based on stamp type) around stamp with own text, border settings, background etc

Here are the steps to add Stamp signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [StampSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/StampSignOptions) object according to your requirements and specify Text Signature options.    
*   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [StampSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/StampSignOptions) to it.    
*   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.
    

This example shows how to add Stamp signature to document.

```java
Signature signature = new Signature("sample.pdf");
// setup options with text of signature
StampSignOptions signOptions = new StampSignOptions();
 
signOptions.setHeight(300);
signOptions.setWidth(300);
 
signOptions.setVerticalAlignment(VerticalAlignment.Bottom);
signOptions.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setRight(10);
padding.setBottom(10);
signOptions.setMargin(padding);
Background background = new Background();
background.setColor( Color.ORANGE);
signOptions.setBackground(background);
signOptions.setBackgroundColorCropType(StampBackgroundCropType.OuterArea);
signOptions.setImageFilePath(Constants.ImageStamp);
signOptions.setBackgroundImageCropType(StampBackgroundCropType.InnerArea);
signOptions.setAllPages(true);
 
 
//add few outer round lines
StampLine outerLine1 = new StampLine();
outerLine1.setText("* European Union *");
outerLine1.setTextRepeatType(StampTextRepeatType.FullTextRepeat);
SignatureFont signatureFont1 = new SignatureFont();
signatureFont1.setSize(12);
signatureFont1.setFamilyName("Arial");
outerLine1.setFont(signatureFont1);
outerLine1.setHeight(30);
outerLine1.setTextBottomIntent(6);
outerLine1.setTextColor(Color.WHITE);
outerLine1.setBackgroundColor(Color.BLUE);
signOptions.getOuterLines().add(outerLine1);
 
StampLine outerLine2 = new StampLine();
outerLine2.setHeight(2);
outerLine2.setBackgroundColor(Color.WHITE);
signOptions.getOuterLines().add(outerLine2);
 
StampLine outerLine3 = new StampLine();
outerLine3.setText("* Entrepreneur *");
outerLine3.setTextColor(Color.BLUE);
outerLine3.setTextRepeatType(StampTextRepeatType.FullTextRepeat);
SignatureFont signatureFont3 = new SignatureFont();
signatureFont3.setSize(15);
outerLine3.setFont(signatureFont3);
outerLine3.setHeight(30);
outerLine3.setTextBottomIntent(8);
Border innerBorder3 = new Border();
innerBorder3.setColor(Color.DARK_GRAY);
innerBorder3.setDashStyle(DashStyle.Dot);
outerLine3.setInnerBorder(innerBorder3);
Border outerBorder3 = new Border();
outerBorder3.setColor(Color.BLUE);
outerLine3.setOuterBorder(outerBorder3);
signOptions.getOuterLines().add(outerLine3);
 
 
//Inner square lines
StampLine innerLine1 = new StampLine();
innerLine1.setText("John");
innerLine1.setTextColor(Color.RED);
SignatureFont signFont1 = new SignatureFont();
signFont1.setSize(20);
signFont1.setBold(true);
innerLine1.setFont(signFont1);
innerLine1.setHeight(40);
signOptions.getInnerLines().add(innerLine1);
 
StampLine innerLine2 = new StampLine();
innerLine2.setText("Smith");
innerLine2.setTextColor(Color.RED);
SignatureFont signFont2 = new SignatureFont();
signFont2.setSize(20);
signFont2.setBold(true);
innerLine2.setFont(signFont2);
innerLine2.setHeight(40);
signOptions.getInnerLines().add(innerLine2);
 
StampLine innerLine3 = new StampLine();
innerLine3.setText("SSN 1230242424");
innerLine3.setTextColor(Color.MAGENTA);
SignatureFont signFont3 = new SignatureFont();
signFont3.setSize(12);
signFont3.setBold(true);
innerLine3.setFont(signFont3);
innerLine3.setHeight(40);
signOptions.getInnerLines().add(innerLine3);
 
// sign document
SignResult signResult = signature.sign("signed.pdf", signOptions);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign document with Text signature - advanced

Path: /signature/net/sign-document-with-text-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) class to specify additional options for text signature to specify following signature appearance

* signature alignment ([HorizontalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/horizontalalignment), [VerticalAlignment](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/verticalalignment))
* margins ([Margin](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/margin))
* border and background settings ([Border,](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/border) [Background](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/background))
* font and colors ([Font](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/font), [Forecolor](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/qrcodesignoptions/forecolor))
* text signature implementation ([stamp, text as image, watermark, annotation, shaped](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions/signatureimplementation) etc)

Here are the steps to add Text signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) object with all required additional options .
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [TextSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/textsignoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add Text signature to document with advanced setup and analyzing result of method. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // set signature alignment
        // when VerticalAlignment is set the Top coordinate will be ignored.
        // Use Margin properties Top, Bottom to provide vertical offset
        VerticalAlignment = Domain.VerticalAlignment.Top,
        // when HorizontalAlignment is set the Left coordinate will be ignored.
        // Use Margin properties Left, Right to provide horizontal offset
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Top = 20, Right = 20 },
        // adjust signature appearance
        // setup signature border
        Border = new Border()
        {
            Color = Color.DarkGreen,
            DashStyle = DashStyle.DashLongDashDot,
            Transparency = 0.5,
            Visible = true,
            Weight = 2
        },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new LinearGradientBrush(Color.LimeGreen, Color.DarkGreen)
        },
        // set rotation
        RotationAngle = 45,
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image

    };
    // set up shadow options for text
    TextShadow shadow = new TextShadow()
    {
        Color = Color.OrangeRed,
        Angle = 135,
        Blur = 5,
        Distance = 4,
        Transparency = 0.2
    };
    //add text shadow to signature extensions
    options.Extensions.Add(shadow);
    // sign document to file
    SignResult signResult = signature.Sign("signedSample.pdf", options);
    Console.WriteLine("List of newly created signatures:");
    int number = 1;
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
 }
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add text redaction annotation

Path: /annotation/java/add-text-redaction-annotation/

Text redaction annotation fills part of text with black rectangle to hide its content as shown in the picture below:

![](/annotation/java/images/add-text-redaction-annotation.png)

You can use the following methods to set the properties of the [TextRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textredactionannotation) class:

*   [setPoints()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textredactionannotation/#setPoints-java.util.List-com.groupdocs.annotation.models.Point--) defines annotation positions as array of points 
    

To add a text redaction annotation, follow these steps:

1.  Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.  Instantiate the [TextRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textredactionannotation) class. Specify the appropriate properties (position, page number, etc).
3.  Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [TextRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textredactionannotation) class.
4.  Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.  

The following code snippet shows how to add [TextRedactionAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/textredactionannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding text redaction annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    Point point1 = new Point(80, 730);
    Point point2 = new Point(240, 730);
    Point point3 = new Point(80, 650);
    Point point4 = new Point(240, 650);
    
    List<Point> points = new ArrayList<Point>();
    points.add(point1);
    points.add(point2);
    points.add(point3);
    points.add(point4);

    // Create an instance of TextRedactionAnnotation class and set options
    TextRedactionAnnotation textRedaction = new TextRedactionAnnotation();
    textRedaction.setCreatedOn(Calendar.getInstance().getTime());
    textRedaction.setMessage("This is text redaction annotation");
    textRedaction.setPageNumber(0);
    textRedaction.setPoints(points);
    textRedaction.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(textRedaction);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add text redaction annotation

Path: /annotation/net/add-text-redaction-annotation/

Text redaction annotation fills part of text with black rectangle to hide content as shown in the picture below:

![](/annotation/net/images/add-text-redaction-annotation.png)

You can specify the following properties of the [TextRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textredactionannotation) class:

*   [Points](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textredactionannotation/properties/points) defines annotation positions as array of points 
    

To add a text redaction annotation, follow these steps:

1.  Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.  Instantiate the [TextRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textredactionannotation) class. Specify the appropriate properties (position, page number, etc).
3.  Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [TextRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textredactionannotation) class.
4.  Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.  

The following code snippet shows how to add [TextRedactionAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/textredactionannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add text redaction annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	TextRedactionAnnotation textRedaction = new TextRedactionAnnotation
    {
    	CreatedOn = DateTime.Now,
        Message = "This is text redaction annotation",
        FontColor = 16761035,
        PageNumber = 0,
        Points = new List<Point>
        {
        	new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650)
        },
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
         }
     };
     annotator.Add(textRedaction);
     annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Convert XML to PDF Using XSL-FO

Path: /conversion/net/convert-xml-to-pdf-with-xsl-fo/


GroupDocs.Conversion for .NET allows you to convert XML files to PDF format using XSL-FO templates. This approach lets you define the layout and style of the PDF by transforming the XML content through an XSL-FO stylesheet. Follow this guide to perform the conversion seamlessly.

## Key Features
- Convert XML to PDF with custom styles using XSL-FO.
- Define PDF layout and formatting using XSL-FO templates.
- Flexible and efficient for generating PDFs from structured XML data.

## Prerequisites
Ensure you have the following ready before proceeding:
1. GroupDocs.Conversion for .NET installed in your project.
2. An XML file containing the data to convert.
3. An XSL-FO stylesheet that defines the PDF layout and design.

## Code Example: XML to PDF Conversion

The following code snippet demonstrates how to convert an XML file to PDF using an XSL-FO template:

```csharp
// Load the XML file with the XSL-FO stylesheet
using (var converter = new Converter("books.xml", (LoadContext loadContext) => new XmlLoadOptions
       {
           XslFoFactory = () => new FileStream("bookstore-pdf-template.xsl", FileMode.Open)
       }))
{
    // Set the output format to PDF
    var options = new PdfConvertOptions();
    
    // Perform the conversion
    converter.Convert("converted.pdf", options);
}

---

## Edit PDF

Path: /editor/net/edit-pdf/

> This example demonstrates the standard open-edit-save pipeline with PDF documents, using different options on every step.

## Introduction

The [PDF documents, or documents in a Portable Document Format](https://docs.fileformat.com/pdf/), developed by Adobe Corp, are widely used over all Internet and document management systems. PDF format has a crucial distinction from other formats such as [DOCX](https://docs.fileformat.com/word-processing/docx/), [TXT](https://docs.fileformat.com/word-processing/txt/), or [HTML](https://docs.fileformat.com/web/html/)/[CSS](https://docs.fileformat.com/web/css/) — it is a so-called fixed-layout format. The main purpose of PDF is to be platform-independent and store the exact representation of a document, — wherever and whenever this document is opened, it should provide the per-character and even a per-pixel fidelity. This means that a document, once created, is "baked" in terms of its representation and editability. While you can freely edit any DOCX document by adding, removing or moving any part of its content, and page layout is organically updated to fit newly added paragraphs or images (or pages are collapsed when text and other content is removed from the beginning or the middle of the document), the PDF documents sustain "frozen". PDF documents have pages, but every word, character, pixel is strictly bound to every page and cannot be moved. In fact, PDF format doesn't contain the definitions of paragraphs, titles, sentences, words and even letters — internally PDF document consists of pages, where every page contains a set of glyphs (visual character), where every glyph has coordinated where it is located on this page. Same for images and other visual elements. Words, text blocks, paragraphs and so on, visually identifiable by the users, who open PDF in some viewer like Adobe Reader, are nothing more than a set of symbols, displaced by coordinates over all the page to be "like a text". For example, tables are nothing more than a set of the drawn lines to form a visual grid with glyphs, drawn in its cells. From this point of view, PDF format is much closer to raster or vector images like JPEG, PNG, or SVG, then to "truly" text documents like DOCX or TXT.

Concluding:
- Editing the PDF documents like ordinary DOCX, TXT, or HTML is an extremely difficult and complex task.
- Quality of editing the PDF document may be very close to what we can do with usual text documents, but it will never be 100%, especially when input PDF has quite complex formatting and content.
- Due to the complexity of PDF format and a process of making it editable, this operation requires a lot of processing time and memory.

From its emergence the GroupDocs.Editor for .NET had no support for editing the PDF documents. But starting from the [version 22.7](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-7-release-notes/) we finally released this possibility! And this article explains in detail how to edit PDF document of any complexity like an ordinary text or WordProcessing document.

**Important note!**

{{< alert style="info" >}}GroupDocs.Editor for .NET [version 22.7](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-7-release-notes/) is distributed for three platforms/runtimes: .NET Framework 2.0, .NET Framework 4.6.1 and .NET Standard 2.0. Ability to edit PDF documents is available only for the .NET Framework 4.6.1 and higher, or .NET Standard 2.0 and higher.{{< /alert >}}

## In two words

Editing of the PDF documents is the same as editing any other documents:

1. Load a PDF document to the [`GroupDocs.Editor.Editor` class](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) with  [`GroupDocs.Editor.Options.PdfLoadOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfloadoptions), specify a password if needed.
2. Edit a document using [`GroupDocs.Editor.Editor.Edit()` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit/#edit) with [`PdfEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfeditoptions) and obtain an instance of [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument).
3. Send a document content to the client-side, edit it there with WYSIWYG-editor, send modified (edited) content back to the server-side.
4. Create an instance of [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) with modified content and call an [`GroupDocs.Editor.Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) using [`PdfSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions).

Short code example below:

```csharp
//0. Simple preparations of input data
const string filename = "NET_Framework-protected.pdf";
const string password = "password";
string inputPath = System.IO.Path.Combine(Common.TestHelper.PdfFolder, filename);

//1. Create a load options class with password
GroupDocs.Editor.Options.PdfLoadOptions loadOptions = new PdfLoadOptions();
loadOptions.Password = password;

//2. Create edit options and tune/adjust if necessary
GroupDocs.Editor.Options.PdfEditOptions editOptions = new PdfEditOptions();
editOptions.EnablePagination = true;//enable pagination for per-page processing in WYSIWYG-editor
editOptions.Pages = PageRange.FromStartPageTillEnd(3);//edit not all pages, but starting from 3rd and till the end

//3. Create Editor instance, load a document
GroupDocs.Editor.Editor editor = new Editor(inputPath, loadOptions);

//4. Edit a document and generate EditableDocument
GroupDocs.Editor.EditableDocument originalDoc = editor.Edit(editOptions);

//5. Generate HTML/CSS, send it to WYSIWYG, edit there...and obtain edited version
string originalContent = originalDoc.GetEmbeddedHtml();
string editedContent = originalContent.Replace(".NET Framework", "I love Java!!!");

//6. Generate EditableDocument from edited content
EditableDocument editedDoc = EditableDocument.FromMarkup(editedContent, null);

//7. Create and adjust save options
GroupDocs.Editor.Options.PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.Compliance = PdfCompliance.Pdf20;

//8. Save to a file or a stream
string outputPath = System.IO.Path.Combine(Common.TestHelper.OutputFolder, filename);
editor.Save(editedDoc, outputPath, saveOptions);

//9. Don't forget to dispose all resources
originalDoc.Dispose();
editedDoc.Dispose();
editor.Dispose();
```

## Loading

[Class `GroupDocs.Editor.Options.PdfLoadOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfloadoptions) is responsible for loading the PDF files into the [`GroupDocs.Editor.Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor). It has only one property — a [`Password`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfloadoptions/password) of a [`string`](https://docs.microsoft.com/en-us/dotnet/api/system.string?view=net-6.0) type. By default it is a `null` — no password is specified. This property is vital when an input document is encoded with a password. If a document is not encoded — property value is ignored whether it was specified or not.

Actually, when input PDF is not password-protected, the `PdfLoadOptions` is not necessary at all — the GroupDocs.Editor will automatically detect the PDF format and apply the default `PdfLoadOptions` by itself. However, specifying even default `PdfLoadOptions` will speed-up the document processing, because in this case the GroupDocs.Editor will not spend the processing time for the automatic format detection routine.

```csharp
//Creating the default PDF loading options
PdfLoadOptions loadOptions = new PdfLoadOptions();

//Setting a password
loadOptions.Password = "some_password";

string inputPdfPath = System.IO.Path.Combine(Common.TestHelper.PdfFolder, "NET_Framework-protected.pdf");

//Loading a PDF without PDF load options
Editor editor1 = new Editor(inputPdfPath);

//Loading a PDF with PDF load options
Editor editor2 = new Editor(inputPdfPath, loadOptions);
```

## Editing

Like for other format families in GroupDocs.Editor, there is a special [`GroupDocs.Editor.Options.PdfEditOptions` class](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfeditoptions) for editing the PDF documents. This class has no its own members — instead it implements a [`FixedLayoutEditOptionsBase` abstract class](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fixedlayouteditoptionsbase), which is common for PDF and XPS formats (because they are very close in their purpose and idea).

The next properties are inherited from the `FixedLayoutEditOptionsBase`:

1. [`Boolean`](https://docs.microsoft.com/en-us/dotnet/api/system.boolean?view=net-6.0) flag [`SkipImages`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fixedlayouteditoptionsbase/skipimages). By default if has a `false` value — images are not skipped and are preserved. However, if you need only textual information from the document, you can set this flag to true.

2. [`Boolean`](https://docs.microsoft.com/en-us/dotnet/api/system.boolean?view=net-6.0) flag [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fixedlayouteditoptionsbase/enablepagination). It has the exact meaning as [the same flag](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions/enablepagination) in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions). This flag sets the document conversion mode: the **float** (default value is `false`) or **paginal** (`true`). For the PDF and XPS documents it means the same:
> - When the float mode is selected, the document content will be converted to a pageless (float) HTML document, where there is only a single page (like any common web-document).
>
> - When the paginal mode is selected, the pages of the document will be preserved in the generated HTML document, like it can be seen in the PDF viewer like Adobe Reader.
>Actually, the relevance and necessity of this mode relies mostly on your WYSIWYG-editor.

3. [`Pages` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fixedlayouteditoptionsbase/pages) of the [`PageRange` type](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pagerange). `PageRange` is an immutable struct, that holds a page range of any document, without relation to the specific document. And the `Pages` property through a `PageRange` struct allows setting a page range, which should be processed. By default all the pages of the input document are processed ([`PageRange.IsDefault`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pagerange/isdefault)` == true`). You can choose the different ways to set a page range using different static methods from a `PageRange` struct. Also pay attention — in `PageRange` pages are specified via page numbers, not via indexes, so they are 1-based, but not 0-based.

When the instance of a `PdfEditOptions` class is created and adjusted, you can pass it to the [`Editor.Edit(PdfEditOptions editOptions)`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit/#edit) method and obtain an instance of [`EditableDocument` class](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), which is ready for generating HTML/CSS markup and sending it to the client-side.

By the way, if a default `PdfEditOptions` instance is acceptable for you, i.e. you do not want to adjust its settings, you allowed to omit `PdfEditOptions` creating at all — just call the [`Editor.Edit()` parameterless overload](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) and the GroupDocs.Editor will internally generate and apply the default `PdfEditOptions` for the input PDF document.

Code sample below demonstrates all described in details:

```csharp
//0. Prepare path to your input PDF file
const string filename = "Comparison for .NET.pdf";
string inputPdfPath = System.IO.Path.Combine(Common.TestHelper.PdfFolder, filename);

//1. Create Editor instance - we do not use PdfLoadOptions here
Editor editor = new Editor(inputPdfPath);

//2. Edit PDF document with default PdfEditOptions - no need to create and pass PdfEditOptions explicitly
EditableDocument originalDefaultDoc = editor.Edit();

//3. Create and adjust PdfEditOptions for advanced edit

//3.1. Create instance of PdfEditOptions class with specified pagination mode (enabled)
PdfEditOptions editOptions = new PdfEditOptions(true);

//3.2. Set to skip images - now they will be omitted during processing
editOptions.SkipImages = true;

//3.3. Set a page range - only second and third pages (input document initially has 4 pages)
editOptions.Pages = PageRange.FromStartPageWithCount(2, 2);//don't forget that page numbers are 1-based

//4. Edit the same PDF document with tuned edit options
EditableDocument tunedDoc = editor.Edit(editOptions);
```

## Saving

Like for other document formats, there is a special class that is responsible for saving the PDF documents — a [`GroupDocs.Editor.Options.PdfSaveOptions` class](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions), which implements [`ISaveOptions` interface](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/isaveoptions).

This class has the next properties:

1. [`String`](https://docs.microsoft.com/en-us/dotnet/api/system.string?view=net-6.0) [property `Password`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/password) — allows to protect the output PDF document with a specified password. By default is `null` — password-protection is not applied. When specified and is not a `null` or empty string, then the output PDF will be encrypted with RC4 (key length of 128 bit).

2. [`Compliance` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/compliance) allows setting the PDF standards compliance level for output PDF. It has an enum type [`PdfCompliance`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfcompliance), each value represents one specific PDF compliance level. By default is a PDF 1.7 (ISO 32000-1) standard.

3. [`OptimizeMemoryUsage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/optimizememoryusage) [`boolean`](https://docs.microsoft.com/en-us/dotnet/api/system.boolean?view=net-6.0) flag, that allows to modify the process of generation of an output PDF document from an `EditableDocument` instance in such a way that this process will take a lesser memory consumption at the cost of the longer processing time. By default it has a `false` value, which means that the memory optimization is disabled for the sake of better performance. In case of extremely huge documents, enabling this property is vital in order to cope with [`OutOfMemoryException`](https://docs.microsoft.com/en-us/dotnet/api/system.OutOfMemoryException?view=net-6.0), especially on 32-bit processes.

4. [`FontEmbedding`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/fontembedding/) property of [`FontEmbeddingOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fontembeddingoptions) type is responsible for embedding the font resources into the resultant PDF document. `FontEmbeddingOptions` is an enum that has several values, which allow to control which fonts should be embedded into PDF. By default fonts are not embedded at all (`NotEmbed`). When specifying the `EmbedAll` enum value, all used fonts in the document will be embedded inside the resultant PDF. When specifying the `EmbedWithoutSystem` — only those fonts, which are absent in the current operating system (where the GroupDocs.Editor is running).

Unlike the [`PdfLoadOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfloadoptions) and [`PdfEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfeditoptions), which are optional when they are default (may be omitted during loading and editing respectively), the [`PdfSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions) is mandatory even if all its values are default.

Code sample below shows all necessary preparations (load and edit operations) and then saving in details.

```csharp
//0. Prepare path to your input PDF file
const string filename = "Comparison for .NET.pdf";
string inputPdfPath = System.IO.Path.Combine(Common.TestHelper.PdfFolder, filename);

//1. Create Editor instance - we do not use PdfLoadOptions here
Editor editor = new Editor(inputPdfPath);

//2. Edit PDF document with default PdfEditOptions - no need to create and pass PdfEditOptions explicitly
EditableDocument originalDoc = editor.Edit();

//3. Generate HTML/CSS/resources, send to WYSIWYG-editor, edit there, send back to server and create EditableDocument... omitted here
EditableDocument editedDoc = originalDoc;//just use the same in the sake of simplicity

//4. Prepare PDF save options:
//4.1. Create instance
Options.PdfSaveOptions saveOptionsAdjusted = new PdfSaveOptions();
//4.2. Adjust properties
saveOptionsAdjusted.Password = "some_password";//protect output PDF with password
saveOptionsAdjusted.FontEmbedding = FontEmbeddingOptions.EmbedAll;//set font embedding - all used
saveOptionsAdjusted.Compliance = PdfCompliance.Pdf20;//set a PDF 2.0 (ISO 32000-2) standard compliance
saveOptionsAdjusted.OptimizeMemoryUsage = true;//set memory optimization on

//5. Create an output stream and save to it
using (System.IO.MemoryStream outputStream = new MemoryStream())
{
	editor.Save(editedDoc, outputStream, saveOptionsAdjusted);
}

//6. Create another, default at this time, PDF save options
Options.PdfSaveOptions saveOptionsDefault = new PdfSaveOptions();

//7. Save to the file path at this time
string outputPdfPath = System.IO.Path.Combine(Common.TestHelper.OutputFolder, filename);
editor.Save(editedDoc, outputPdfPath, saveOptionsDefault);

//8. Don't forget to dispose all
originalDoc.Dispose();
editedDoc.Dispose();
editor.Dispose();
```

In this example we’ve created two output PDF files with different PDF saving options from one source EditableDocument, and saved them to the two distinct storages (memory and disk).

## Obtaining PDF document info

Article [Extracting document metainfo](https://docs.groupdocs.com/editor/net/extracting-document-metainfo/) describes the [`GetDocumentInfo()` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo), that allows to detect the document format and extract its metadata without editing it. Actually, after adding PDF support to the GroupDocs.Editor, this mechanism also works with PDF documents.

When the [`GetDocumentInfo()` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) is called for the [`Editor` class](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance that is loaded with a PDF document, the method will return a [`GroupDocs.Editor.Metadata.FixedLayoutDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo) instance — it is a common class for all fixed-layout documents, PDF and XPS in particular.

As all [`IDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) implementations, it has four properties:

1. [`Format` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo/format) of [`Formats.FixedLayoutFormats` type](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/fixedlayoutformats). For PDF documents it always is a [`FixedLayoutFormats.Pdf`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/fixedlayoutformats/fields/pdf).
2. [`PageCount` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo/pagecount) of [integer (`Int32`)](https://docs.microsoft.com/en-us/dotnet/api/system.int32?view=net-6.0) type. Returns a number of pages.
3. [`Size` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo/size) of a [long integer (`Int64`)](https://docs.microsoft.com/en-us/dotnet/api/system.int64?view=net-6.0) type. Returns a file size in bytes.
4. [`IsEncrypted` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/fixedlayoutdocumentinfo/isencrypted) of a [`Boolean`](https://docs.microsoft.com/en-us/dotnet/api/system.boolean?view=net-6.0) type. For the password-encoded documents it returns `true`, and `false` otherwise. For XPS files it always returns `false`, because the XPS format doesn’t support encryption.

As usual, if the input PDF, loaded into the [`Editor` class](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor), is encoded, then its correct password should be specified in the [`GetDocumentInfo()` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo). If PDF is not encoded, then the value of the [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) is ignored.

**Important note!**

{{< alert style="info" >}}Unlike the editing process, the extraction of metadata from PDF doesn’t require the .NET Framework 4.6.1 and higher, or .NET Standard 2.0 and higher — it is supportable from the lowest .NET Framework 2.0.{{< /alert >}}

The code example below demonstrates the extracting metadata from two PDFs: first one is unprotected, while second - protected.

```csharp
//0. Prepare path to your input unprotected and protected PDF files
const string filenameUnprotected = "Comparison for .NET.pdf";
const string filenameProtected = "NET_Framework-protected.pdf";
string inputPdfUnprotectedPath = System.IO.Path.Combine(Common.TestHelper.PdfFolder, filenameUnprotected);
string inputPdfProtectedPath = System.IO.Path.Combine(Common.TestHelper.PdfFolder, filenameProtected);

//1. Create two Editor instances - we do not use PdfLoadOptions here
Editor editorUnprotected = new Editor(inputPdfUnprotectedPath);
Editor editorProtected = new Editor(inputPdfProtectedPath);

//2. Extract metadata: do not specify a password (null value instead) for the 1st, and DO specify for the 2nd
GroupDocs.Editor.Metadata.IDocumentInfo unprotectedPdfInfo = editorUnprotected.GetDocumentInfo(null);
GroupDocs.Editor.Metadata.IDocumentInfo protectedPdfInfo = editorProtected.GetDocumentInfo("password");

//3. Cast it if necessary and check properties
GroupDocs.Editor.Metadata.FixedLayoutDocumentInfo castedUnprotected = (FixedLayoutDocumentInfo)unprotectedPdfInfo;
Assert.AreEqual(4, castedUnprotected.PageCount);
Assert.IsFalse(castedUnprotected.IsEncrypted);
Assert.AreEqual(246298, castedUnprotected.Size);
Assert.AreEqual(Formats.FixedLayoutFormats.Pdf, castedUnprotected.Format);

Assert.AreEqual(14, protectedPdfInfo.PageCount);
Assert.IsTrue(protectedPdfInfo.IsEncrypted);
Assert.AreEqual(1016198, protectedPdfInfo.Size);
Assert.AreEqual(Formats.FixedLayoutFormats.Pdf, protectedPdfInfo.Format);
```

## Extended info

### EnablePagination in save options

In the previous versions of the GroupDocs.Editor the [`PdfSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions) contained an [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/enablepagination) boolean flag. Starting from the [version 22.7](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-7-release-notes/) this flag was marked as [`Obsolete`](https://docs.microsoft.com/en-us/dotnet/api/system.obsoleteattribute?view=net-6.0) and its value is ignored whether it was specified by the user or was left intact. This was done by the improvements of the backward converter, which generates the output PDF from [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument). Now the backward converter automatically detects the content in the obtained [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) — if it was generated with the [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/fixedlayouteditoptionsbase/enablepagination) flag set to `true` in [`PdfEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfeditoptions), then pagination will be applied to the output PDF, and same for the `false` value.

If you’re using the GroupDocs.Editor version older then 22.7, you should specify the [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions/enablepagination) flag manually and in accordance with the value of the same flag in the [`PdfEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfeditoptions): if `EnablePagination` in [`PdfEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfeditoptions) is set to `true`, then in the [`PdfSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions) it should also be `true`; same for `false`.

Starting from the [version 23.2](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-2-release-notes/) the `EnablePagination` flag was completely removed from the [`PdfSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/pdfsaveoptions) class, so please update your code while migrating from the older versions to the newer.

### Different output formats

Keep in mind that, when input PDF was edited and you’re going to save it, it is not necessary to save it exactly in the PDF format — you are free to choose any compatible format, like all WordProcessing formats, or text format, or eBook format.

Code example below shows editing a PDF file and then saving the edited content to three different files in different formats.

```csharp
//0. Prepare path to your input PDF file
const string filename = "Comparison for .NET.pdf";
string inputPdfPath = System.IO.Path.Combine(Common.TestHelper.PdfFolder, filename);

//1. Create Editor instance - we do not use PdfLoadOptions here
Editor editor = new Editor(inputPdfPath);

//2. Edit PDF document with default PdfEditOptions - no need to create and pass PdfEditOptions explicitly
EditableDocument originalDoc = editor.Edit();

//3. Generate HTML/CSS/resources, send to WYSIWYG-editor, edit there, send back to server and create EditableDocument... omitted here
EditableDocument editedDoc = originalDoc;//just use the same in the sake of simplicity

//4. Prepare PDF save options
Options.PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
pdfSaveOptions.Compliance = PdfCompliance.PdfA2a;

//5. Prepare DOCX save options
Options.WordProcessingSaveOptions docxSaveOptions = new WordProcessingSaveOptions(Formats.WordProcessingFormats.Docx);

//6. Prepare TXT save options
Options.TextSaveOptions txtSaveOptions = new TextSaveOptions();
txtSaveOptions.PreserveTableLayout = true;

//7. Save to PDF format to the stream
using (MemoryStream pdfStream = new MemoryStream())
{
	editor.Save(editedDoc, pdfStream, pdfSaveOptions);
}

//8. Save to DOCX format to the stream
using (MemoryStream docxStream = new MemoryStream())
{
	editor.Save(editedDoc, docxStream, docxSaveOptions);
}

//9. Save to TXT format to the stream
using (MemoryStream txtStream = new MemoryStream())
{
	editor.Save(editedDoc, txtStream, txtSaveOptions);
}

//10. Dispose all resources
editedDoc.Dispose();
originalDoc.Dispose();
editor.Dispose();
```

---

## Indexing reports

Path: /search/java/indexing-reports/

Indexing reports are created for indexing and updating operations. Indexing reports can be retrieved from the index using the [getIndexingReports](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getIndexingReports()) method. Reports are stored in the index only while the index is loaded into RAM for use. If you reload the index, the reports will not be restored.

You can configure the maximum number of stored reports using the [setMaxIndexingReportCount](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setMaxIndexingReportCount(int)) method of the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class. The default value is 5. Learn more about index settings on the page [Search index settings]({{< ref "search/java/developer-guide/advanced-usage/creating-an-index/search-index-settings.md" >}}).

Each index report contains the following information:

*   The total number of documents in the index;
*   The total number of words in the index;
*   The total length of indexed documents in MB;
*   Number of index segments;
*   The total size of the index on disk in bytes;
*   The indexing start time;
*   The indexing end time;
*   The indexing duration;
*   List of errors;
*   List of indexed documents;
*   List of updated documents;
*   List of removed documents.

The following example demonstrates how to get indexing reports from an index.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder1 = "c:\\MyDocuments1\\";
String documentsFolder2 = "c:\\MyDocuments2\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents
index.add(documentsFolder1);
index.add(documentsFolder2);
 
// Getting indexing reports
IndexingReport[] reports = index.getIndexingReports();
 
// Printing information from reports to the console
for (IndexingReport report : reports) {
    System.out.println("Time: " + report.getStartTime());
    System.out.println("Duration: " + report.getIndexingTime());
    System.out.println("Documents total: " + report.getTotalDocumentsInIndex());
    System.out.println("Terms total: " + report.getTotalTermCount());
    System.out.println("Indexed documents size (MB): " + report.getIndexedDocumentsSize());
    System.out.println("Index size (MB): " + (report.getTotalIndexSize() / 1024.0 / 1024.0));
    System.out.println();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing reports

Path: /search/net/indexing-reports/

Indexing reports are created for indexing and updating operations. Indexing reports can be retrieved from the index using the [GetIndexingReports](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getindexingreports) method. Reports are stored in the index only while the index is loaded into RAM for use. If you reload the index, the reports will not be restored.

You can configure the maximum number of stored reports using the [MaxIndexingReportCount](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/maxindexingreportcount) property of the [IndexSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings) class. The default value is 5. Learn more about index settings on the page [Search index settings]({{< ref "search/net/developer-guide/advanced-usage/creating-an-index/search-index-settings.md" >}}.

Each index report contains the following information:

*   The total number of documents in the index;
*   The total number of words in the index;
*   The total length of indexed documents in MB;
*   Number of index segments;
*   The total size of the index on disk in bytes;
*   The indexing start time;
*   The indexing end time;
*   The indexing duration;
*   List of errors;
*   List of indexed documents;
*   List of updated documents;
*   List of removed documents.

The following example demonstrates how to get indexing reports from an index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder1 = @"c:\MyDocuments1\";
string documentsFolder2 = @"c:\MyDocuments2\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents
index.Add(documentsFolder1);
index.Add(documentsFolder2);
 
// Getting indexing reports
IndexingReport[] reports = index.GetIndexingReports();
 
// Printing information from reports to the console
foreach (IndexingReport report in reports)
{
    Console.WriteLine("Time: " + report.StartTime);
    Console.WriteLine("Duration: " + report.IndexingTime);
    Console.WriteLine("Documents total: " + report.TotalDocumentsInIndex);
    Console.WriteLine("Terms total: " + report.TotalTermCount);
    Console.WriteLine("Indexed documents size (MB): " + report.IndexedDocumentsSize);
    Console.WriteLine("Index size (MB): " + (report.TotalIndexSize / 1024.0 / 1024.0));
    Console.WriteLine();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing reports

Path: /search/nodejs-java/indexing-reports/

Indexing reports are created for indexing and updating operations. Indexing reports can be retrieved from the index using the [getIndexingReports](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getIndexingReports()) method. Reports are stored in the index only while the index is loaded into RAM for use. If you reload the index, the reports will not be restored.

You can configure the maximum number of stored reports using the [setMaxIndexingReportCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setMaxIndexingReportCount(int)) method of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class. The default value is 5. Learn more about index settings on the page [Search index settings]({{< ref "search/nodejs-java/developer-guide/advanced-usage/creating-an-index/search-index-settings.md" >}}).

Each index report contains the following information:

*   The total number of documents in the index;
*   The total number of words in the index;
*   The total length of indexed documents in MB;
*   Number of index segments;
*   The total size of the index on disk in bytes;
*   The indexing start time;
*   The indexing end time;
*   The indexing duration;
*   List of errors;
*   List of indexed documents;
*   List of updated documents;
*   List of removed documents.

The following example demonstrates how to get indexing reports from an index.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder1 = 'c:/MyDocuments1/';
const documentsFolder2 = 'c:/MyDocuments2/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents
index.add(documentsFolder1);
index.add(documentsFolder2);

// Getting indexing reports
const reports = index.getIndexingReports();

// Printing information from reports to the console
for (const report of reports) {
  console.log('Time: ' + report.getStartTime());
  console.log('Duration: ' + report.getIndexingTime());
  console.log('Documents total: ' + report.getTotalDocumentsInIndex());
  console.log('Terms total: ' + report.getTotalTermCount());
  console.log('Indexed documents size (MB): ' + report.getIndexedDocumentsSize());
  console.log('Index size (MB): ' + report.getTotalIndexSize() / 1024.0 / 1024.0);
  console.log();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Load EBook Documents with Options

Path: /conversion/net/load-ebook-document-with-options/


## Introduction

The **EBookLoadOptions** class enables you to configure how electronic book (ebook) documents are loaded in GroupDocs.Conversion. This class supports popular ebook formats used across various reading platforms and devices.

EBookLoadOptions works with common ebook formats including MOBI (Kindle), EPUB (universal standard), and AZW3 (Kindle Fire).

## Properties

| Property | Type | Description |
|----------|------|-------------|
| `Format` | `EBookFileType` | The input ebook format (read-only; get;) |

## Basic Usage

For most scenarios, GroupDocs.Conversion automatically detects the ebook format:

```csharp
using (var converter = new Converter("digital-novel.mobi"))
{
    converter.Convert("digital-novel.pdf", new PdfConvertOptions());
}
```

## Using EBookLoadOptions with LoadContext

When you need explicit control over loading behavior, use EBookLoadOptions with the LoadContext delegate pattern:

```csharp
using (var converter = new Converter(
    "technical-manual.epub",
    (LoadContext loadContext) => new EBookLoadOptions()))
{
    converter.Convert("technical-manual.pdf", new PdfConvertOptions());
}
```

## Common Conversion Scenarios

### EBook to PDF

Convert ebooks to PDF for universal compatibility and printing:

```csharp
using (var converter = new Converter(
    "cookbook-recipes.mobi",
    (LoadContext loadContext) => new EBookLoadOptions()))
{
    converter.Convert("cookbook-recipes.pdf", new PdfConvertOptions());
}
```

### EBook to Word Document

Convert ebooks to editable Word documents:

```csharp
using (var converter = new Converter(
    "travel-guide.epub",
    (LoadContext loadContext) => new EBookLoadOptions()))
{
    converter.Convert("travel-guide.docx", new WordProcessingConvertOptions());
}
```

### EBook to HTML

Convert ebooks to web-friendly HTML format:

```csharp
using (var converter = new Converter(
    "reference-book.azw3",
    (LoadContext loadContext) => new EBookLoadOptions()))
{
    converter.Convert("reference-book.html", new WebConvertOptions());
}
```

## Working with Different EBook Formats

GroupDocs.Conversion supports multiple ebook formats through EBookLoadOptions. Each format should be explicitly specified:

### MOBI (Mobipocket)

MOBI is a widely-used format, especially for Amazon Kindle devices:

```csharp
using (var converter = new Converter(
    "mystery-novel.mobi",
    (LoadContext loadContext) => new EBookLoadOptions
    {
        Format = EBookFileType.Mobi
    }))
{
    converter.Convert("mystery-novel.pdf", new PdfConvertOptions());
}
```

### EPUB (Electronic Publication)

EPUB is an open standard format supported by most ebook readers:

```csharp
using (var converter = new Converter(
    "user-manual.epub",
    (LoadContext loadContext) => new EBookLoadOptions
    {
        Format = EBookFileType.Epub
    }))
{
    converter.Convert("user-manual.docx", new WordProcessingConvertOptions());
}
```

### AZW3 (Kindle Format 8)

AZW3 is Amazon's modern ebook format with enhanced features:

```csharp
using (var converter = new Converter(
    "reference-book.azw3",
    (LoadContext loadContext) => new EBookLoadOptions
    {
        Format = EBookFileType.Azw3
    }))
{
    converter.Convert("reference-book.html", new WebConvertOptions());
}
```

## Supported EBook Formats

EBookLoadOptions works with:
- **MOBI** - Mobipocket format (Amazon Kindle)
- **EPUB** - Electronic Publication (universal standard)
- **AZW3** - Kindle Format 8 (Kindle Fire and newer devices)

## Common Use Cases

Use EBookLoadOptions when you need to:

1. **Convert digital publications** - Transform ebooks into formats suitable for different platforms
2. **Create printable versions** - Convert ebooks to PDF for physical printing
3. **Extract content** - Convert ebooks to Word or HTML for editing and content reuse
4. **Cross-platform compatibility** - Convert between different ebook formats (EPUB to MOBI, etc.)
5. **Publishing workflows** - Integrate ebook conversion into digital publishing pipelines

## When to Use EBookLoadOptions

Use EBookLoadOptions when:

- Working with electronic book formats (MOBI, EPUB, AZW3)
- Converting digital publications to other formats
- Building ebook management or publishing systems
- Creating multi-format output from ebook sources
- You need explicit control over ebook document loading

## Without EBookLoadOptions

For simple conversions, you can rely on automatic format detection:

```csharp
using (var converter = new Converter("digital-novel.mobi"))
{
    converter.Convert("digital-novel.pdf", new PdfConvertOptions());
}
```

GroupDocs.Conversion automatically detects the ebook format in most cases, so EBookLoadOptions is optional unless you need specific loading configuration.

## Output Format Compatibility

EBooks can be converted to various output formats:

- **Document formats**: PDF, DOCX, RTF, TXT
- **Web formats**: HTML, MHTML
- **Spreadsheet formats**: XLSX, XLS
- **Presentation formats**: PPTX, PPT
- **Other ebook formats**: EPUB, MOBI, AZW3

**Note**: Image formats (PNG, JPG) require page-by-page conversion using SavePageContext since ebooks are multi-page documents.

## Summary

EBookLoadOptions provides control over electronic book document loading:
- **Format**: Read-only property indicating the ebook format
- **Supports**: MOBI, EPUB, AZW3 formats
- **Use Case**: Digital publishing, cross-platform ebook conversion, content extraction

All examples on this page have been verified through automated testing to ensure accuracy.

## See Also

- [Context Objects - Complete Guide]({{< ref "conversion/net/developer-guide/basic-usage/context-objects-complete-guide" >}})
- [EBookFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/ebookfiletype/)
- [EBookLoadOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/ebookloadoptions/)

---

## Output format and password

Path: /editor/java/output-format-and-password/

[WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class is responsible for tuning and adjusting the saving process, when [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, that contains already edited document content, should be converted to the output document of some WordProcessing format. In other words, [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) specify how exactly edited HTML should be saved to output document.

Unlike load and edit options, [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class has one mandatory [constructor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions#WordProcessingSaveOptions-com.groupdocs.editor.formats.WordProcessingFormats-), that obtains one parameter — `outputFormat`. The `outputFormat` parameter has a [WordProcessingFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats) type. In turn, this type contains all supported formats from WordProcessing format family, which are supportable for saving document. Each field of [WordProcessingFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats) struct represent one separate WordProcessing format — DOC, DOCX, RTF, ODT etc. There is also an [`All`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats/#All) field, that allows to enumerate over all WordProcessing formats. So, with the `outputFormat` parameter user should select a specific format of the output WordProcessing document, which should be generated by the [Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method.

This constructor is mandatory, because it is unacceptable to create a [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) instance without output format; otherwise, how GroupDocs.Editor "should know" in which specific format the document should be saved? However, output format can be changed later, after creating an instance of the [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class, with the [OutputFormat](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions#WordProcessingSaveOptions-com.groupdocs.editor.formats.WordProcessingFormats-) property. This property also has a getter, that allows to obtain output format, specified previously in constructor.

Almost all WordProcessing formats, especially with binary nature, support file encoding with the password. If such document is encoded, it is required to specify a password for opening it. [WordProcessingSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions) class has the [next property](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingsaveoptions/#getPassword--), which allows to set a password:

```java
public String getPassword()
public void getPassword(String)
```

By default the value of this property is NULL, which means that password will not be applied. If user specifies a string in this property, the output document will be encoded and protected with this string as a password. If user had specified some password in this property at some step, but then wants to dismiss password and do not encode the document, he can set the value to NULL or empty string, — both these values will be interpreted as "do not set a password" when calling the [`Editor.save()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method.

---

## Output format and password

Path: /editor/net/output-format-and-password/

[`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class is responsible for tuning and adjusting the saving process, when [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, that contains already edited document content, should be converted to the output document of some WordProcessing format. In other words, the [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class specifies how exactly the edited HTML should be saved to the output document.

Unlike load and edit options, [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class has one mandatory [constructor](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/wordprocessingsaveoptions/), that obtains one parameter — `outputFormat`. The `outputFormat` parameter has a [`WordProcessingFormats`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats) type. In turn, this type contains all supported formats from the [family of WordProcessing formats](https://docs.fileformat.com/word-processing/), which are supportable for saving document. Each field of [`WordProcessingFormats`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats) struct represent one separate WordProcessing format — DOC, DOCX, RTF, ODT etc. There is also an [`All`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats/fields/all) field, that allows to enumerate over all WordProcessing formats. So, with the `outputFormat` parameter user should select a specific format of the output WordProcessing document, which should be generated by the [`editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

This constructor is mandatory, because it is unacceptable to create a [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) instance without output format; otherwise, how GroupDocs.Editor "should know" into which specific format the document should be saved? However, output format can be changed later, after creating an instance of the [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class, with the [`OutputFormat`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/outputformat) property. This property also has a getter, that allows to obtain output format, specified previously in a constructor.

Almost all WordProcessing formats, especially with binary nature, support file encoding with the password. If such document is encoded, it is required to specify a password for opening it. [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions) class has the [next property](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingsaveoptions/password), which allows to set a password:

```csharp
public string Password { get; set; }
```

By default the value of this property is `NULL`, which means that password will not be applied. If user specifies a string in this property, the output document will be encoded and protected with this string as a password. If user had specified some password in this property at some step, but then wants to dismiss password and do not encode the document, he can set the value to NULL or empty string, — both these values will be interpreted as "do not set a password" when calling the [`editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

---

## Output Format and Password

Path: /editor/nodejs-java/output-format-and-password/


The [`WordProcessingSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.WordProcessingSaveOptions) class is responsible for configuring the saving process when an [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.EditableDocument) instance—containing the edited document content—is converted into an output document of a specific WordProcessing format. In other words, `WordProcessingSaveOptions` specify how the edited HTML should be saved to the output document.

Unlike load and edit options, the `WordProcessingSaveOptions` class requires one mandatory constructor parameter: `outputFormat`. The `outputFormat` parameter has a [`WordProcessingFormats`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats.WordProcessingFormats) type. This type includes all supported formats from the WordProcessing format family that are available for saving documents. Each field of the `WordProcessingFormats` class represents a separate WordProcessing format—such as DOC, DOCX, RTF, ODT, etc. There's also an `All` field that allows you to enumerate over all WordProcessing formats.

With the `outputFormat` parameter, you should select the specific format of the output WordProcessing document to be generated by the `editor.save()` method.

This constructor is mandatory because it's essential for GroupDocs.Editor to know the specific format in which the document should be saved. However, the output format can be changed later, after creating an instance of the `WordProcessingSaveOptions` class, using the `setOutputFormat()` method. You can also retrieve the currently set output format using the `getOutputFormat()` method.

Almost all WordProcessing formats, especially those with a binary nature, support file encryption with a password. If such a document is encrypted, it requires a password to open. The `WordProcessingSaveOptions` class has the `setPassword()` method, which allows you to set a password for the output document:

```javascript
// Getter and Setter for password
public String getPassword()
public void setPassword(String value)
```

By default, the value of this property is `null`, which means that no password will be applied. If you specify a string in this property, the output document will be encrypted and protected with this string as a password. If you have previously set a password but later decide to remove it, you can set the value to `null` or an empty string—both will be interpreted as "do not set a password" when calling the `editor.save()` method.

## Example Usage

The following example demonstrates how to change the output format and set a password for the edited WordProcessing document using GroupDocs.Editor for Node.js via Java.

```javascript
// Import necessary modules
const groupdocs_editor = require('groupdocs-editor');
const fs = require('fs');

// Load the source WordProcessing document
const editor = new groupdocs_editor.Editor('SampleDocument.docx');

// Create WordProcessingEditOptions if needed
const editOptions = new groupdocs_editor.WordProcessingEditOptions();

// Edit the document to get an EditableDocument instance
const editableDocument = editor.edit(editOptions);

// Create WordProcessingSaveOptions with the desired output format
// For example, to save the document in RTF format
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Rtf);

// Set a password for the output document
saveOptions.setPassword('yourPassword123');

// Save the edited document with the specified save options
editor.save(editableDocument, 'OutputDocument.rtf', saveOptions);

console.log('Document saved successfully with the specified format and password.');
```

**Notes:**

- Replace `'SampleDocument.docx'` with the path to your source WordProcessing document.
- Replace `'OutputDocument.rtf'` with the desired output file path.
- Replace `'yourPassword123'` with your desired password.

## Changing Output Formats

You can choose from various WordProcessing formats when saving the document. The `WordProcessingFormats` class provides constants for all supported formats. Here are some examples:

```javascript
// Save as DOCX
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Docx);

// Save as DOC
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Doc);

// Save as RTF
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Rtf);

// Save as ODT
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Odt);
```

You can also change the output format after creating the `WordProcessingSaveOptions` instance:

```javascript
// Create save options with initial format
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Docx);

// Later in the code, change the output format to ODT
saveOptions.setOutputFormat(groupdocs_editor.WordProcessingFormats.Odt);
```

## Removing the Password

If you have set a password previously and want to save the document without encryption, set the password to `null` or an empty string:

```javascript
// Remove the password protection
saveOptions.setPassword(null);
// or
saveOptions.setPassword('');
```

## Complete Example

Below is a complete example that demonstrates changing the output format to DOC, setting a password, and then removing the password before saving:

```javascript
// Import necessary modules
const groupdocs_editor = require('groupdocs-editor');
const fs = require('fs');

// Load the source WordProcessing document
const editor = new groupdocs_editor.Editor('SampleDocument.docx');

// Create WordProcessingEditOptions if needed
const editOptions = new groupdocs_editor.WordProcessingEditOptions();

// Edit the document to get an EditableDocument instance
const editableDocument = editor.edit(editOptions);

// Create WordProcessingSaveOptions with the desired output format (DOC)
const saveOptions = new groupdocs_editor.WordProcessingSaveOptions(groupdocs_editor.WordProcessingFormats.Doc);

// Set a password for the output document
saveOptions.setPassword('securePass!');

// Later, decide to remove the password
saveOptions.setPassword(null); // or saveOptions.setPassword('');

// Save the edited document with the specified save options
editor.save(editableDocument, 'OutputDocument.doc', saveOptions);

console.log('Document saved successfully without password protection.');
```

## Conclusion

The `WordProcessingSaveOptions` class in GroupDocs.Editor for Node.js via Java provides flexible options for configuring the saving process of edited WordProcessing documents. You can specify the output format and set or remove passwords for the output document, giving you control over the format and security of the files you generate.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Phrase search

Path: /search/java/phrase-search/

This page contains a phrase search definition as well as a phrase search description with use of GroupDocs.Search API.

## Phrase search definition

Phrase search is a type of search that allows users to search for documents containing an exact sentence or phrase rather than containing a set of keywords in random order.

## Phrase search in GroupDocs.Search

Phrase search allows you to perform search for exact phrase and find a given sequence of words in the text of indexed documents. In text form, the following syntax is used to specify a phrase search query:

*   "word1 word2 word3 ..."

Quotation marks are required, for example:

string query = "\\"theory of relativity\\"";

Please note that if stop words are used in a search query, the phrase will still be found, however, instead of stop words, the search engine will try to substitute any words.

The following example demonstrates performing the phrase search with a query in text and object form.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search for the phrase 'theory of relativity' in text form
String query1 = "\"theory of relativity\"";
SearchResult result1 = index.search(query1);
 
// Search for the phrase 'theory of relativity' in object form
SearchQuery word1 = SearchQuery.createWordQuery("theory");
SearchQuery word2 = SearchQuery.createWordQuery("of");
SearchQuery word3 = SearchQuery.createWordQuery("relativity");
SearchQuery query2 = SearchQuery.createPhraseSearchQuery(word1, word2, word3);
SearchResult result2 = index.search(query2);
```

## Phrase search with wildcards

Phrase search other than words can also use two kinds of wildcard characters:

*   \* byte-number
*   \* byte-number ~~ byte-number

where byte-number is a number from 0 to 255.

The first pattern represents the exact number of unknown words in a phrase, for example \*2. The second pattern represents the range of the number of unknown words in a phrase, for example \*1~~2.

Phrase search query with wildcards is flexible enough to be used instead of span term query (span query).

The following example demonstrates the use of wildcards in phrase search queries in text and object form.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search for the phrase in text form
String query1 = "\"theory *1~~2 relativity\"";
SearchResult result1 = index.search(query1);
 
// Search for the phrase in object form
SearchQuery word1 = SearchQuery.createWordQuery("theory");
SearchQuery wildcard2 = SearchQuery.createWildcardQuery(1, 2);
SearchQuery word3 = SearchQuery.createWordQuery("relativity");
SearchQuery query2 = SearchQuery.createPhraseSearchQuery(word1, wildcard2, word3);
SearchResult result2 = index.search(query2);
 
// The search can find the following phrases:
// "theory of relativity"
// "theory of special relativity"
```

Phrase search can be combined with other types of searches. The specification of search queries in text form is presented on the [Query language specification]({{< ref "search/java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}) page. A table of the possibility of nesting search queries in object form is presented on the [Nesting search queries in object form]({{< ref "search/java/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}) page.

The following example demonstrates the use of both wildcards representing words and characters in words.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search for the phrase in text form
String query1 = "\"Test?(0~1) *1~~2 relativity\"";
SearchResult result1 = index.search(query1);
 
// Search for the phrase in object form
WordPattern pattern = new WordPattern();
pattern.appendString("Test");
pattern.appendWildcard(0, 1);
SearchQuery wordPattern1 = SearchQuery.createWordPatternQuery(pattern);
SearchQuery wildcard2 = SearchQuery.createWildcardQuery(1, 2);
SearchQuery word3 = SearchQuery.createWordQuery("relativity");
SearchQuery query2 = SearchQuery.createPhraseSearchQuery(wordPattern1, wildcard2, word3);
SearchResult result2 = index.search(query2);
 
// The search can find the following phrases:
// "Test of special relativity"
// "Tests of special relativity"
// "Test of general relativity"
// "Tests of general relativity"
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Phrase search

Path: /search/net/phrase-search/

This page contains a phrase search definition as well as a phrase search description with use of GroupDocs.Search API.

## Phrase search definition

Phrase search is a type of search that allows users to search for documents containing an exact sentence or phrase rather than containing a set of keywords in random order.

## Phrase search in GroupDocs.Search

Phrase search allows you to perform search for exact phrase and find a given sequence of words in the text of indexed documents. In text form, the following syntax is used to specify a phrase search query:

*   "word1 word2 word3 ..."

Quotation marks are required, for example:

string query = "\\"theory of relativity\\"";

Please note that if stop words are used in a search query, the phrase will still be found, however, instead of stop words, the search engine will try to substitute any words.

The following example demonstrates performing the phrase search with a query in text and object form.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search for the phrase 'theory of relativity' in text form
string query1 = "\"theory of relativity\"";
SearchResult result1 = index.Search(query1);
 
// Search for the phrase 'theory of relativity' in object form
SearchQuery word1 = SearchQuery.CreateWordQuery("theory");
SearchQuery word2 = SearchQuery.CreateWordQuery("of");
SearchQuery word3 = SearchQuery.CreateWordQuery("relativity");
SearchQuery query2 = SearchQuery.CreatePhraseSearchQuery(word1, word2, word3);
SearchResult result2 = index.Search(query2);
```

## Phrase search with wildcards

Phrase search other than words can also use two kinds of wildcard characters:

*   \* byte-number
*   \* byte-number ~~ byte-number

where byte-number is a number from 0 to 255.

The first pattern represents the exact number of unknown words in a phrase, for example \*2. The second pattern represents the range of the number of unknown words in a phrase, for example \*1~~2.

Phrase search query with wildcards is flexible enough to be used instead of span term query (span query).

The following example demonstrates the use of wildcards in phrase search queries in text and object form.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search for the phrase in text form
string query1 = "\"theory *1~~2 relativity\"";
SearchResult result1 = index.Search(query1);
 
// Search for the phrase in object form
SearchQuery word1 = SearchQuery.CreateWordQuery("theory");
SearchQuery wildcard2 = SearchQuery.CreateWildcardQuery(1, 2);
SearchQuery word3 = SearchQuery.CreateWordQuery("relativity");
SearchQuery query2 = SearchQuery.CreatePhraseSearchQuery(word1, wildcard2, word3);
SearchResult result2 = index.Search(query2);
 
// The search can find the following phrases:
// "theory of relativity"
// "theory of special relativity"
```

Phrase search can be combined with other types of searches. The specification of search queries in text form is presented on the [Query language specification]({{< ref "search/net/developer-guide/advanced-usage/searching/query-language-specification.md" >}}) page. A table of the possibility of nesting search queries in object form is presented on the [Nesting search queries in object form]({{< ref "search/net/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}) page.

The following example demonstrates the use of both wildcards representing words and characters in words.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search for the phrase in text form
string query1 = "\"Test?(0~1) *1~~2 relativity\"";
SearchResult result1 = index.Search(query1);
 
// Search for the phrase in object form
WordPattern pattern = new WordPattern();
pattern.AppendString("Test");
pattern.AppendWildcard(0, 1);
SearchQuery wordPattern1 = SearchQuery.CreateWordPatternQuery(pattern);
SearchQuery wildcard2 = SearchQuery.CreateWildcardQuery(1, 2);
SearchQuery word3 = SearchQuery.CreateWordQuery("relativity");
SearchQuery query2 = SearchQuery.CreatePhraseSearchQuery(wordPattern1, wildcard2, word3);
SearchResult result2 = index.Search(query2);
 
// The search can find the following phrases:
// "Test of special relativity"
// "Tests of special relativity"
// "Test of general relativity"
// "Tests of general relativity"
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Phrase search

Path: /search/nodejs-java/phrase-search/

This page contains a phrase search definition as well as a phrase search description with use of GroupDocs.Search API.

## Phrase search definition

Phrase search is a type of search that allows users to search for documents containing an exact sentence or phrase rather than containing a set of keywords in random order.

## Phrase search in GroupDocs.Search

Phrase search allows you to perform search for exact phrase and find a given sequence of words in the text of indexed documents. In text form, the following syntax is used to specify a phrase search query:

*   "word1 word2 word3 ..."

Quotation marks are required, for example:

string query = "\\"theory of relativity\\"";

Please note that if stop words are used in a search query, the phrase will still be found, however, instead of stop words, the search engine will try to substitute any words.

The following example demonstrates performing the phrase search with a query in text and object form.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search for the phrase 'sollicitudin at ligula' in text form
const query1 = '"sollicitudin at ligula"';
const result1 = index.search(query1);

// Search for the phrase 'sollicitudin at ligula' in object form
const word1 = groupdocs.search.SearchQuery.createWordQuery('sollicitudin');
const word2 = groupdocs.search.SearchQuery.createWordQuery('at');
const word3 = groupdocs.search.SearchQuery.createWordQuery('ligula');
const query2 = groupdocs.search.SearchQuery.createPhraseSearchQuery(word1, word2, word3);
const result2 = index.search(query2);
```

## Phrase search with wildcards

Phrase search other than words can also use two kinds of wildcard characters:

*   \* byte-number
*   \* byte-number ~~ byte-number

where byte-number is a number from 0 to 255.

The first pattern represents the exact number of unknown words in a phrase, for example \*2. The second pattern represents the range of the number of unknown words in a phrase, for example \*1~~2.

Phrase search query with wildcards is flexible enough to be used instead of span term query (span query).

The following example demonstrates the use of wildcards in phrase search queries in text and object form.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search for the phrase in text form
const query1 = '"sollicitudin *0~~3 ligula"';
const result1 = index.search(query1);

// Search for the phrase in object form
const word1 = groupdocs.search.SearchQuery.createWordQuery('sollicitudin');
const wildcard2 = groupdocs.search.SearchQuery.createWildcardQuery(0, 3);
const word3 = groupdocs.search.SearchQuery.createWordQuery('ligula');
const query2 = groupdocs.search.SearchQuery.createPhraseSearchQuery(word1, wildcard2, word3);
const result2 = index.search(query2);

// The search can find the following phrases:
// "sollicitudin of ligula"
// "sollicitudin ligula"
```

Phrase search can be combined with other types of searches. The specification of search queries in text form is presented on the [Query language specification]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}) page. A table of the possibility of nesting search queries in object form is presented on the [Nesting search queries in object form]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}) page.

The following example demonstrates the use of both wildcards representing words and characters in words.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search for the phrase in text form
const query1 = '"sollicitudin  *0~~3  ?(0~4)la"';
const result1 = index.search(query1);

// Search for the phrase in object form
const word1 = groupdocs.search.SearchQuery.createWordQuery('sollicitudin');
const wildcard2 = groupdocs.search.SearchQuery.createWildcardQuery(0, 3);
const pattern = new groupdocs.search.WordPattern();
pattern.appendWildcard(0, 4);
pattern.appendString('la');
const wordPattern3 = groupdocs.search.SearchQuery.createWordPatternQuery(pattern);
const query2 = groupdocs.search.SearchQuery.createPhraseSearchQuery(word1, wildcard2, wordPattern3);
const result2 = index.search(query2);

// The search can find the following phrases:
// "sollicitudin of ligula"
// "sollicitudin ligula"
// "sollicitudin, nulla"
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Render email messages as HTML, PDF, PNG, and JPEG files

Path: /viewer/net/render-email-messages/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render your email messages in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party email clients to view the contents of email files within your .NET application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass an email message you want to view to the class constructor. You can load the message from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the loaded message to HTML, PDF, or image format. These methods allow you to render the entire message or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/email" >}} {{< icon "gdoc_person" >}} View email files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported email file formats

GroupDocs.Viewer supports the following email file formats:

* [Email Message](https://docs.fileformat.com/email/eml) (.EML)
* [Apple Mail Message](https://docs.fileformat.com/email/emlx) (.EMLX)
* [Email Mailbox File](https://docs.fileformat.com/email/mbox/) (.MBOX)
* [Outlook Message Item File](https://docs.fileformat.com/email/msg) (.MSG)
* [vCard (Virtual Contact) File](https://docs.fileformat.com/email/vcf/) (.VCF, .VCARD)

GroupDocs.Viewer can detect the email file format automatically based on information in the file header.

## Render email messages as HTML

Create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an email message to HTML. The `HtmlViewOptions` class properties allow you to control the conversion process. For instance, you can embed all external resources in the generated HTML file, minify the output file, and exclude specific fonts. Refer to the following documentation section for details: [Rendering to HTML]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-html/_index.md" >}}). 

### Create an HTML file with embedded resources

To embed an email message in an HTML page, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method and specify the output file name.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
   // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to HTML](/viewer/net/images/rendering-basics/render-email-messages/render-email-to-html-embedded-resources.png)

### Create an HTML file with external resources

To save an email message to a separate folder, call the [HtmlViewOptions.ForExternalResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forexternalresources/index) method and pass the following parameters:

  * The output file path format
  * The path format for the folder with external resources
  * The resource URL format

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
    // Specify the HTML file name and location of external resources.
    // {0} is replaced with the resource name in the output file name.
    var viewOptions = HtmlViewOptions.ForExternalResources("output.html", "output/resource_{0}", "output/resource_{0}");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Specify the HTML file name and location of external resources.
            ' {0} is replaced with the resource name in the output file name.
            Dim viewOptions = HtmlViewOptions.ForExternalResources("output.html",   "output/resource_{0}", "output/resource_{0}")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The result is shown below. External resources are placed in a separate folder.

![Place HTML resources in a separate folder](/viewer/net/images/rendering-basics/render-email-messages/render-email-to-html-external-resources.png)

## Render email messages as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an email message to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
    // Create a PDF file.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Create a PDF file.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PDF](/viewer/net/images/rendering-basics/render-email-messages/render-email-to-pdf.png)

## Render email messages as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an email message to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
    // Create a PNG image.
    var viewOptions = new PngViewOptions("output.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Create a PNG image.
            Dim viewOptions = New PngViewOptions("output.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an email message to PNG](/viewer/net/images/rendering-basics/render-email-messages/render-email-to-png.png)

## Render email messages as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an email message to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
    // Create a JPG image.
    var viewOptions = new JpgViewOptions("output.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Create a JPG image.
            Dim viewOptions = New JpgViewOptions("output.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [EmailOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/emailoptions) class that allows you to specify different options for rendering email messages. To access these options, use the [EmailOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/emailoptions/) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

### Set the output page size

GroupDocs.Viewer allows you to specify page size for the output file when you convert an email message to HTML, PDF, or image format. Assign a [PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pagesize/) enumeration member to the [EmailOptions.PageSize](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/emailoptions/pagesize/) property to select one of the predefined page sizes (Letter, Ledger, A0, A1, A2, A3, or A4).

The following example specifies page size for the output PDF file:

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
    // Create a PDF file.
    var viewOptions = new PdfViewOptions("output.pdf");
    // Specify the page size.
    viewOptions.EmailOptions.PageSize = PageSize.Letter;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Create a PDF file.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            ' Specify the page size.
            viewOptions.EmailOptions.PageSize = PageSize.Letter
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Rename fields in the message header

GroupDocs.Viewer allows you to change how standard fields (such as _From_, _To_, _Subject_, and so on) are displayed in the email message header.

![Default fields in the message header](/viewer/net/images/rendering-basics/render-email-messages/default-message-fields.png)

Use the [EmailOptions.FieldTextMap](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/emailoptions/properties/fieldtextmap) property to specify custom field labels. Static fields of the [Field](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/field/) class allow you to access default email header fields, as shown in the example below.

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    // Specify custom field labels.
    viewOptions.EmailOptions.FieldTextMap[Field.From] = "Sender";
    viewOptions.EmailOptions.FieldTextMap[Field.To] = "Recipient";
    viewOptions.EmailOptions.FieldTextMap[Field.Sent] = "Date";
    viewOptions.EmailOptions.FieldTextMap[Field.Subject] = "Email subject";
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            ' Specify custom field labels.
            viewOptions.EmailOptions.FieldTextMap(Field.From) = "Sender"
            viewOptions.EmailOptions.FieldTextMap(Field.[To]) = "Recipient"
            viewOptions.EmailOptions.FieldTextMap(Field.Sent) = "Date"
            viewOptions.EmailOptions.FieldTextMap(Field.Subject) = "Email subject"
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Custom fields in the message header](/viewer/net/images/rendering-basics/render-email-messages/custom-message-fields.png)

### Specify the date and time format and change the time zone

When rendering email messages, GroupDocs.Viewer formats date and time information in the message header based on the system's date and time settings. If you want to change the default date and time format or specify the time zone offset, use the following properties:

* [EmailOptions.DateTimeFormat](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/emailoptions/datetimeformat/)---Allows you to define a custom date and time format. See the following topics for details: 
    * [Standard date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings)
    * [Custom date and time format strings](https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings)
* [EmailOptions.TimeZoneOffset](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/emailoptions/timezoneoffset/)---Specifies the hours and minutes offset from UTC. The offset is displayed with a leading sign. A plus sign (+) indicates time ahead of UTC, and a minus sign (-) indicates time behind UTC. 

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.eml"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    // Apply a custom format to the date in the email message header.
    viewOptions.EmailOptions.DateTimeFormat = "MMMM dd, yyyy H:mm:ss zzz";
    // Specify the time zone offset. 
    viewOptions.EmailOptions.TimeZoneOffset = new TimeSpan(-7, 0, 0);
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.eml")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            ' Apply a custom format to the date in the email message header.
            viewOptions.EmailOptions.DateTimeFormat = "MMMM dd, yyyy H:mm:ss zzz"
            ' Specify the time zone offset. 
            viewOptions.EmailOptions.TimeZoneOffset = New TimeSpan(-7, 0, 0)
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image illustrates the result:

![Custom date-time format](/viewer/net/images/rendering-basics/render-email-messages/custom-date-time-format.png)

## Get mail message metadata before rendering

Sometimes it is necessary to know some metadata of the email message, loaded to the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/) class, before its actual rendering through the [`Viewer.View()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/view/#view) method. GroupDocs.Viewer for such cases provides the [`ViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/) class that can be obtained by calling a [`Viewer.GetViewInfo()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/getviewinfo/#getviewinfo) method. However, this [`ViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/) class is common for all supported document formats and has no specific properties, which are present only in the mail messages.

Starting from the version 26.1 the GroupDocs.Viewer public API has a new class [`MailMessageViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/mailmessageviewinfo/). This class is a direct inheritor of the common class [`ViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/), so it has all its properties, but also introduce the few new ones, specific for the mail messages:

- `Sent` property of `DateTime` type — returns a date and time, stored in the mail message in its original form “as-is”, without adjusting it to the local date time and so on.
- `Subject` of `String` type — return a subject of the mail message.
- `From` of `String` type — returns a “From” email address.

To obtain a metadata of the given mail message, this mail message initially should be loaded to the [`Viewer`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/) class through its [constructor](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/viewer/#constructor_4), and then the [`Viewer.GetViewInfo()`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/getviewinfo/#getviewinfo) method should be called. This method then returns the instance of the [`ViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/viewinfo/) class, which should be casted to the [`MailMessageViewInfo`](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/mailmessageviewinfo/) type. And that’s all! Source code is below:

{{< tabs "Get-view-info-example">}}
{{< tab "C#" >}}
```csharp
using System;
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (Viewer viewer = new Viewer("sample.eml"))
{
    ViewInfo generalInfo = viewer.GetViewInfo(ViewInfoOptions.ForHtmlView());
    // explicit casting
    MailMessageViewInfo mailMessageInfo = (MailMessageViewInfo)generalInfo;
    Console.WriteLine("From: {0}; Subject: {1}; Sent: {2}.", mailMessageInfo.From, mailMessageInfo.Subject, mailMessageInfo.Sent);

    // Render to any output format if needed
    viewer.View(HtmlViewOptions.ForEmbeddedResources());
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports System
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Using viewer As New Viewer("sample.eml")
    Dim generalInfo As ViewInfo = viewer.GetViewInfo(ViewInfoOptions.ForHtmlView())
    ' explicit casting
    Dim mailMessageInfo As MailMessageViewInfo = DirectCast(generalInfo, MailMessageViewInfo)
    Console.WriteLine("From: {0}; Subject: {1}; Sent: {2}.", mailMessageInfo.From, mailMessageInfo.Subject, mailMessageInfo.Sent)

    ' Render to any output format if needed
    viewer.View(HtmlViewOptions.ForEmbeddedResources())
End Using
```
{{< /tab >}}
{{< /tabs >}}
---

## Render Lotus Notes database files as HTML, PDF, and image files

Path: /viewer/java/render-lotus-notes-database-files/

[GroupDocs.Viewer for Java](https://products.groupdocs.com/viewer/java) allows you to render [Lotus Notes Storage Facility (NSF)](https://docs.fileformat.com/database/nsf/) files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of NSF files within your Java application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/nsf" >}} {{< icon "gdoc_person" >}} View NSF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Render Lotus Notes database files as HTML

To convert an NSF file to HTML, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method.

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.nsf")) {
    // Specify the HTML file name.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to HTML](/viewer/java/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-html.png)

## Render Lotus Notes database files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an NSF file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.nsf")) {
    // Create a PDF file.
    PdfViewOptions viewOptions = new PdfViewOptions("output.pdf");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PDF](/viewer/java/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-pdf.png)

## Render Lotus Notes database files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an NSF file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.nsf")) {
    // Convert the NSF file to PNG.
    // {0} is replaced with the page numbers in the output image names.
    PngViewOptions viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PNG](/viewer/java/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-png.png)

## Render Lotus Notes database files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer/viewer/) method to convert an NSF file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.nsf")) {
    // Convert the NSF file to JPG.
    // {0} is replaced with the page numbers in the output image names.
    JpgViewOptions viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.setWidth(950);
    viewOptions.setHeight(550);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [MailStorageOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/mailstorageoptions) class that allows you to specify different options for rendering Lotus Notes database files. To access these options, use the [setMailStorageOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/baseviewoptions/#setMailStorageOptions-com.groupdocs.viewer.options.MailStorageOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/jpgviewoptions)

### Limit the number of items to render

When you load large Lotus Notes database files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [MailStorageOptions.setMaxItems](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/mailstorageoptions/#setMaxItems-int-) method to limit the number of rendered items. The default property value is **0** (all existing items appear in the output file). 

The following example demonstrates how to specify the maximum number of items to render:

{{< tabs "example5">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.nsf")) {
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    // Specify the maximum items to render.
    viewOptions.getMailStorageOptions().setMaxItems(20);
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

### Filter messages

IBM Notes allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in IBM Notes](/viewer/java/images/rendering-basics/render-lotus-notes-data-files/filter-nsf-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering a Lotus Notes database file to HTML, PDF, or image format. To do this, use the following properties:

* [MailStorageOptions.setTextFilter](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/mailstorageoptions/#setTextFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the subject or body.
* [MailStorageOptions.setAddressFilter](https://reference.groupdocs.com/viewer/java/com.groupdocs.viewer.options/mailstorageoptions/#setAddressFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in an NSF file before rendering this file to HTML:

{{< tabs "example6">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
// ...

try (Viewer viewer = new Viewer("sample.nsf")) {
    // Create an HTML file.
    HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources("output.html");
    // Set filters.
    viewOptions.setTextFilter("April 2015");
    viewOptions.setAddressFilter("test@test.com");
    viewer.view(viewOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Render Lotus Notes database files as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-lotus-notes-database-files/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to render [Lotus Notes Storage Facility (NSF)](https://docs.fileformat.com/database/nsf/) files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of NSF files within your Node.js application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/nsf" >}} {{< icon "gdoc_person" >}} View NSF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Render Lotus Notes database files as HTML

To convert an NSF file to HTML, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method.

{{< tabs "render-nsf-to-html">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.nsf")
// Specify the HTML file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-nsf-to-html/nsf-to-html.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to HTML](/viewer/nodejs-java/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-html.png)

## Render Lotus Notes database files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an NSF file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-nsf-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.nsf")
// Create a PDF file.
const viewOptions = PdfViewOptions("render-nsf-to-pdf/nsf-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PDF](/viewer/nodejs-java/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-pdf.png)

## Render Lotus Notes database files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an NSF file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-nsf-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.nsf")
// Convert the NSF file to PNG.
// {0} is replaced with the page numbers in the output image names.
const viewOptions = PngViewOptions("render-nsf-to-png/nsf-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PNG](/viewer/nodejs-java/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-png.png)

## Render Lotus Notes database files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an NSF file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-nsf-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.nsf")
// Convert the NSF file to JPG.
// {0} is replaced with the page numbers in the output image names.
const viewOptions = JpgViewOptions("render-nsf-to-jpeg/nsf-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [MailStorageOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/mailstorageoptions) class that allows you to specify different options for rendering Lotus Notes database files. To access these options, use the [setMailStorageOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/baseviewoptions/#setMailStorageOptions-com.groupdocs.viewer.options.MailStorageOptions-) method for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

### Limit the number of items to render

When you load large Lotus Notes database files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [MailStorageOptions.setMaxItems](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/mailstorageoptions/#setMaxItems-int-) method to limit the number of rendered items. The default property value is **0** (all existing items appear in the output file). 

The following example demonstrates how to specify the maximum number of items to render:

{{< tabs "render-nsf-limit-items">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.nsf")
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-nsf-limit-items/nsf-to-html.html")
// Specify the maximum items to render.
viewOptions.getMailStorageOptions().setMaxItems(20)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Filter messages

IBM Notes allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in IBM Notes](/viewer/nodejs-java/images/rendering-basics/render-lotus-notes-data-files/filter-nsf-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering a Lotus Notes database file to HTML, PDF, or image format. To do this, use the following properties:

* [MailStorageOptions.setTextFilter](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/mailstorageoptions/#setTextFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the subject or body.
* [MailStorageOptions.setAddressFilter](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/mailstorageoptions/#setAddressFilter-java.lang.String-)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in an NSF file before rendering this file to HTML:

{{< tabs "render-nsf-filter-messages">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("sample.nsf")
// Create an HTML file.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-nsf-filter-messages/nsf-to-html.html")
 // Set filters.
viewOptions.getMailStorageOptions().setTextFilter("April 2015");
viewOptions.getMailStorageOptions().setAddressFilter("test@test.com");
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Render Lotus Notes database files as HTML, PDF, and image files

Path: /viewer/python-net/render-lotus-notes-database-files/

[GroupDocs.Viewer for Python via .NET](https://products.groupdocs.com/viewer/python-net) allows you to render [Lotus Notes Storage Facility (NSF)](https://docs.fileformat.com/database/nsf/) files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of NSF files within your .NET application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/nsf" >}} {{< icon "gdoc_person" >}} View NSF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Python-via-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Render Lotus Notes database files as HTML

To convert an NSF file to HTML, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_nsf_to_html():
    # Load NSF file
    with Viewer("sample.nsf") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_nsf_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_nsf_to_html()
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to HTML](/viewer/python-net/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-html.png)

## Render Lotus Notes database files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an NSF file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_nsf_to_pdf():
    # Load NSF file
    with Viewer("sample.nsf") as viewer:
        # Create a PDF file.
        viewOptions = PdfViewOptions("render_nsf_to_pdf/lotus_notes.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_nsf_to_pdf()
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PDF](/viewer/python-net/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-pdf.png)

## Render Lotus Notes database files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an NSF file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_nsf_to_png():
    # Load NSF file
    with Viewer("sample.nsf") as viewer:
        # Convert the NSF file to PNG.
        # {0} is replaced with the page numbers in the output image names.
        viewOptions = PngViewOptions("render_nsf_to_png/lotus_notes_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_nsf_to_png()
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PNG](/viewer/python-net/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-png.png)

## Render Lotus Notes database files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an NSF file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_nsf_to_jpg():
    # Load NSF file
    with Viewer("sample.nsf") as viewer:
        # Convert the NSF file to JPEG.
        # {0} is replaced with the page numbers in the output image names.
        viewOptions = JpgViewOptions("render_nsf_to_jpg/nsf_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_nsf_to_jpg()
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [MailStorageOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/mailstorageoptions/) class that allows you to specify different options for rendering Lotus Notes database files. To access these options, use the [MailStorageOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/baseviewoptions/) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

### Limit the number of items to render

When you load large Lotus Notes database files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [mail_storage_options.max_items](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/mailstorageoptions/#properties) property to limit the number of rendered items. The default property value is **0** (all existing items appear in the output file). 

The following example demonstrates how to specify the maximum number of items to render:

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_nsf_with_max_items():
    # Load NSF file
    with Viewer("sample.nsf") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_nsf_with_max_items/nsf_with_max_items.html")
        # Specify the maximum items to render.
        viewOptions.mail_storage_options.max_items = 20
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_nsf_with_max_items()
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Filter messages

IBM Notes allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in IBM Notes](/viewer/python-net/images/rendering-basics/render-lotus-notes-data-files/filter-nsf-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering a Lotus Notes database file to HTML, PDF, or image format. To do this, use the following properties:

* [mail_storage_options.text_filter](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/mailstorageoptions/)---Allows you to render all messages that contain specific text in the subject or body.
* [mail_storage_options.address_filter](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/mailstorageoptions/)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in an NSF file before rendering this file to HTML:

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_nsf_with_filters():
    # Load NSF file
    with Viewer("sample.nsf") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_nsf_with_filters/nsf_with_filters.html")
        # Set filters
        viewOptions.mail_storage_options.text_filter = "Viewer"
        viewOptions.mail_storage_options.address_filter = "groupdocs@mail.com"
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_nsf_with_filters()
```
{{< /tab >}}
{{< tab "sample.nsf" >}}
{{< tab-text >}}
`sample.nsf` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-lotus-notes-files/sample.nsf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

---

## Show revisions

Path: /comparison/python-net/show-revisions/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) lets you toggle the visibility of revisions in the output document.

## Hide revisions in the result

Turn off revision display to simplify the output document.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.show_revisions = False
    comparer.compare("result.docx", options)
```

🔹 Use case: Produce a clean deliverable without inline revision markers for end users.

The result is as follows:

|              Disable display Revisions               |
| :--------------------------------------------------: |
| ![](/comparison/python-net/images/show-revisions-false.png) |



---

## Show Revisions

Path: /comparison/java/show-revisions/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to compare and customize the display of revisions in the output document.

Revision is a collection of changes received when comparing documents using built-in Word tools.

By default, the display of revisions is enabled. To turn off the display of revisions, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/) object. Specify the source file path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object. Set the [ShowRevisions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowRevisions-boolean-) property to `false`.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object from the previous step.

The following code snippet shows how disable the display of revisions:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.nio.file.Path;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");
    CompareOptions options = new CompareOptions();
    options.setShowRevisions(false);
    final Path resultPath = comparer.compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                            Closed state                             |                             Open state                             |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/java/images/show-revisions-true-close-revisions.png) | ![](/comparison/java/images/show-revisions-true-open-revisions.png) |


|              Disable display Revisions               |
| :--------------------------------------------------: |
| ![](/comparison/java/images/show-revisions-false.png) |


---

## Show Revisions

Path: /comparison/net/show-revisions/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to compare and customize the display of revisions in the output document.

Revision is a collection of changes received when comparing documents using built-in Word tools.

By default, the display of revisions is enabled. To turn off the display of revisions, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify the source file path or stream.
2.  Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/add/index) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. Set the [ShowRevisions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showrevisions) property to `false`.
4.  Call the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how disable the display of revisions:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions options = new CompareOptions() { ShowRevisions = false };
    comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                            Closed state                             |                             Open state                             |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/net/images/show-revisions-true-close-revisions.png) | ![](/comparison/net/images/show-revisions-true-open-revisions.png) |


|              Disable display Revisions               |
| :--------------------------------------------------: |
| ![](/comparison/net/images/show-revisions-false.png) |


---

## Show Revisions

Path: /comparison/nodejs-java/show-revisions/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to compare and customize the visibility of revisions in the output document.

Revision is a collection of changes received when comparing documents using built-in Word tools.

By default, the visibility of revisions is enabled. The following code snippet shows how to disable the visibility of revisions:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and result documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const outputPath = 'result.docx';

// Initialize comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document that will be compared against the source
comparer.add(targetPath);

// Set up comparison options
const options = new groupdocs.CompareOptions();

// Disable revision marks in the output document
options.setShowRevisions(false);

// Perform the comparison and write the result to the output file
comparer.compare(outputPath, options);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It disables the display of revision marks by setting `setShowRevisions(false)`. When the comparison is performed, the result document will not show revision marks, displaying the final content directly without revision tracking indicators.

The result is as follows:

|                            Closed state                             |                             Open state                             |
| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
| ![](/comparison/nodejs-java/images/show-revisions-true-close-revisions.png) | ![](/comparison/nodejs-java/images/show-revisions-true-open-revisions.png) |


|              Disable display Revisions               |
| :--------------------------------------------------: |
| ![](/comparison/nodejs-java/images/show-revisions-false.png) |


---

## Sign document with Text signature - advanced

Path: /signature/java/sign-document-with-text-signature-advanced/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) provides [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) class to specify additional options for text signature to specify following signature appearance

*   signature alignment ([setHorizontalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setHorizontalAlignment(int)), [setVerticalAlignment](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setVerticalAlignment(int)))
*   margins ([setMargin](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setMargin(com.groupdocs.signature.domain.Padding)))
*   border and background settings ([setBorder,](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setBorder(com.groupdocs.signature.domain.Border))[setBackground](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setBackground(com.groupdocs.signature.domain.Background)))
*   font and colors ([setFont](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setFont(com.groupdocs.signature.domain.SignatureFont)), [setForeColor](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setForeColor(java.awt.Color)))
*   text signature implementation ([stamp, text as image, watermark, annotation, shaped](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions#setSignatureImplementation(int)) etc)

Here are the steps to add Text signature into document with GroupDocs.Signature:

*   *   Create new instance of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class and pass source document path as a constructor parameter.        
    *   Instantiate the [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) object with all required additional options.        
    *   Call [sign](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature#sign(java.io.OutputStream,%20com.groupdocs.signature.options.sign.SignOptions)) method of [Signature](https://reference.groupdocs.com/java/signature/com.groupdocs.signature/Signature) class instance and pass [TextSignOptions](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.options.sign/TextSignOptions) to it. 
    *   Analyze [SignResult](https://reference.groupdocs.com/java/signature/com.groupdocs.signature.domain/SignResult) result to check newly created signatures if needed.

This example shows how to add Text signature to document with advanced setup and analyzing result of method. See [SignResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/SignResult)

```java
Signature signature = new Signature("sample.pdf");
 
TextSignOptions options = new TextSignOptions("John Smith");
 
// set signature position
options.setLeft(100);
options.setTop(100);
 
// set signature rectangle
options.setWidth(100);
options.setHeight(30);
 
// set signature alignment
 
// when VerticalAlignment is set the Top coordinate will be ignored.
// Use Margin properties Top, Bottom to provide vertical offset
options.setVerticalAlignment(VerticalAlignment.Top);
 
// when HorizontalAlignment is set the Left coordinate will be ignored.
// Use Margin properties Left, Right to provide horizontal offset
options.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setBottom(20);
padding.setRight(20);
options.setMargin(padding);
 
// adjust signature appearance
 
// setup signature border
Border border = new Border();
border.setColor(Color.GREEN);
border.setDashStyle(DashStyle.DashLongDashDot);
border.setTransparency(0.5);
border.setVisible(true);
border.setWeight(2);
options.setBorder(border);
 
// set text color and Font
options.setForeColor(Color.RED);
SignatureFont signatureFont = new SignatureFont();
signatureFont.setSize(12);
signatureFont.setFamilyName("Comic Sans MS");
options.setFont(signatureFont);
 
// setup background
Background background = new Background();
background.setColor(Color.LIGHT_GRAY);
background.setTransparency(0.5);
background.setBrush(new LinearGradientBrush(Color.GREEN, Color.DARK_GRAY, 0));
options.setBackground(background);
 
// set rotation
options.setRotationAngle(45);
 
// set alternative signature implementation on document page
options.setSignatureImplementation(TextSignatureImplementation.Image);
 
 
 
// set up shadow options for text
TextShadow shadow = new TextShadow();
shadow.setColor(Color.ORANGE);
shadow.setAngle(135);
shadow.setBlur(5);
shadow.setDistance(4);
shadow.setTransparency(0.2);
 
//add text shadow to signature extensions
options.getExtensions().add(shadow);
 
// sign document to file
SignResult signResult = signature.sign("signed.pdf", options);
// analyzing result
System.out.print("List of newly created signatures:");
int number = 1;
for(BaseSignature temp : signResult.getSucceeded())
{
    System.out.print("Signature #"+ number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+
            ",Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
}
```

## More resources

### GitHub Examples 

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)    
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)   
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)
    

### Free Online App 

Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Work with Streams vs File Paths

Path: /assembly/net/basic-usage-streams-vs-files/


## Overview

GroupDocs.Assembly for .NET supports both file paths and streams for template loading and document saving. Understanding when to use each approach helps you build efficient, scalable applications. File paths are simpler for local file system operations, while streams are essential for memory-based processing, remote templates, and web applications.

The main class involved is:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - provides overloads for both file paths and streams

Here are the considerations for choosing between streams and file paths:

* Use file paths for simple local file system operations
* Use streams for memory-based processing, remote templates, or web applications
* Mix file paths and streams as needed for your scenario
* Always properly dispose of streams to avoid resource leaks

{{< alert style="info" >}}
DocumentAssembler provides multiple overloads supporting various combinations of file paths and streams for both input templates and output documents.
{{< /alert >}}

## When to Use File Paths

File paths are ideal for:
- Simple local file system operations
- Templates stored on disk
- Output documents saved to disk
- Desktop applications with direct file access

```csharp
using GroupDocs.Assembly;

public static void UseFilePaths()
{
    // Simple file path approach
    string templatePath = @"C:\Templates\InvoiceTemplate.docx";
    string outputPath = @"C:\Output\Invoice.docx";
    
    var data = new { CustomerName = "ABC Corp", Amount = 1500.00m };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument(templatePath, outputPath, 
        new DataSourceInfo(data, "invoice"));
    
    Console.WriteLine("Document assembled using file paths.");
}
```

## When to Use Streams

Streams are essential for:
- Memory-based processing (no disk I/O)
- Templates loaded from databases or remote sources
- Web applications serving documents directly
- Processing templates in memory for performance

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void UseStreams()
{
    // Load template into memory
    byte[] templateBytes = File.ReadAllBytes("Template.docx");
    
    using (MemoryStream templateStream = new MemoryStream(templateBytes))
    using (MemoryStream outputStream = new MemoryStream())
    {
        var data = new { Title = "Report", Date = DateTime.Now };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templateStream, outputStream, 
            new DataSourceInfo(data, "report"));
        
        // Use output stream (e.g., send via HTTP, save to database)
        byte[] outputBytes = outputStream.ToArray();
        File.WriteAllBytes("Output.docx", outputBytes);
        
        Console.WriteLine("Document assembled using streams.");
    }
}
```

## Mixed Approach: File Path Input, Stream Output

Load template from file, save to stream:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void FilePathInputStreamOutput()
{
    // Template from file path
    string templatePath = "Template.docx";
    
    // Output to memory stream
    using (MemoryStream outputStream = new MemoryStream())
    {
        var data = new { Name = "Test", Value = 100 };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templatePath, outputStream, 
            new DataSourceInfo(data, "item"));
        
        // Use output stream (e.g., send via HTTP response)
        byte[] outputBytes = outputStream.ToArray();
        
        Console.WriteLine($"Document assembled, output size: {outputBytes.Length} bytes");
    }
}
```

## Mixed Approach: Stream Input, File Path Output

Load template from stream, save to file:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void StreamInputFilePathOutput()
{
    // Template from memory stream
    byte[] templateBytes = File.ReadAllBytes("Template.docx");
    
    using (MemoryStream templateStream = new MemoryStream(templateBytes))
    {
        // Output to file path
        string outputPath = "Output.docx";
        
        var data = new { Title = "Report", Date = DateTime.Now };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templateStream, outputPath, 
            new DataSourceInfo(data, "report"));
        
        Console.WriteLine("Document assembled from stream to file.");
    }
}
```

## Web Application Example

In web applications, streams are typically preferred:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static byte[] GenerateDocumentForWeb(byte[] templateBytes, object data)
{
    using (MemoryStream templateStream = new MemoryStream(templateBytes))
    using (MemoryStream outputStream = new MemoryStream())
    {
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templateStream, outputStream, 
            new DataSourceInfo(data, "data"));
        
        return outputStream.ToArray();
    }
}
```

## Loading Template from Remote Source

Streams enable loading templates from URLs or remote sources:

```csharp
using GroupDocs.Assembly;
using System.IO;
using System.Net.Http;

public static async Task<byte[]> LoadTemplateFromUrl(string url, object data)
{
    using (HttpClient client = new HttpClient())
    {
        // Download template
        byte[] templateBytes = await client.GetByteArrayAsync(url);
        
        using (MemoryStream templateStream = new MemoryStream(templateBytes))
        using (MemoryStream outputStream = new MemoryStream())
        {
            DocumentAssembler assembler = new DocumentAssembler();
            assembler.AssembleDocument(templateStream, outputStream, 
                new DataSourceInfo(data, "data"));
            
            return outputStream.ToArray();
        }
    }
}
```

## Stream Disposal Best Practices

Always properly dispose of streams:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void ProperStreamDisposal()
{
    // Good: Using statement ensures disposal
    using (FileStream templateStream = new FileStream("Template.docx", FileMode.Open))
    using (FileStream outputStream = new FileStream("Output.docx", FileMode.Create))
    {
        var data = new { Name = "Test" };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templateStream, outputStream, 
            new DataSourceInfo(data, "item"));
    } // Streams are automatically disposed here
    
    Console.WriteLine("Streams properly disposed.");
}
```

{{< alert style="warning" >}}
DocumentAssembler does not automatically dispose of input streams. Always use `using` statements or manually dispose streams to avoid resource leaks. Output streams are managed by the assembler.
{{< /alert >}}

## Performance Considerations

- **File Paths**: Simpler but require disk I/O
- **Streams**: More flexible, can be faster for memory operations
- **Memory Streams**: Best for small to medium documents
- **File Streams**: Better for large documents to avoid memory pressure

### Advanced Usage Topics

To learn more about advanced stream handling, custom stream implementations, and performance optimization, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Sign document with ordering the signatures

Path: /signature/net/sign-document-with-ordering/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides with [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) property ZOrder that expects integer values as Z-order position. The signatures with a higher number of this property will be displayed above the others.

Here are the steps to manually adjust the ordering of signatures on the document page with GroupDocs.Signature:

* Create a new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with the required options and set the ZOrder property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.

## Sign document with Text signature

This example shows how to add Text signature to document.

```csharp
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // set signature alignment
        // when VerticalAlignment is set the Top coordinate will be ignored.
        // Use Margin properties Top, Bottom to provide vertical offset
        VerticalAlignment = Domain.VerticalAlignment.Top,
        // when HorizontalAlignment is set the Left coordinate will be ignored.
        // Use Margin properties Left, Right to provide horizontal offset
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Top = 20, Right = 20 },
        // adjust signature appearance
        // setup signature border
        Border = new Border()
        {
            Color = Color.DarkGreen,
            DashStyle = DashStyle.DashLongDashDot,
            Transparency = 0.5,
            Visible = true,
            Weight = 2
        },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new LinearGradientBrush(Color.LimeGreen, Color.DarkGreen)
        },
        // set rotation
        RotationAngle = 45,
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image

    };
    // set up shadow options for text
    TextShadow shadow = new TextShadow();
    shadow.Color = Color.OrangeRed;
    shadow.Angle = 135;
    shadow.Blur = 5;
    shadow.Distance = 4;
    shadow.Transparency = 0.2;
    //add text shadow to signature extensions
    options.Extensions.Add(shadow);

    // specify Spreadsheet position over extension
     options.Extensions.Add(new SpreadsheetPosition(10, 10));
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign document with XAdES Digital signature

Path: /signature/net/sign-document-with-xades-digital-signature/

{{< alert style="info" >}}This feature is supported only for Spreadsheet document types{{< /alert >}}

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) class to specify different amount of settings for Digital signature same as property XAdES of [XAdES](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/xadestype/) enumeration type. This property specifies the implementation of [XAdES format](https://en.wikipedia.org/wiki/XAdES) for Spreadsheet documents only (for now).

Here are the steps to add XAdES type signature into document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with required certificate and its password.
* Set property [XAdESType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/xadestype) to value XAdES
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  

This example shows how to add Digital signature to document. See [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult)

```csharp
using (Signature signature = new Signature("sample.xlsx"))
{
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // set XAdES type
        XAdESType = XAdESType.XAdES,
        // certificate password
        Password = "1234567890",
        // digital certificate details
        Reason = "Sign",
        Contact = "JohnSmith",
        Location = "Office1"
    };
    SignResult signResult = signature.Sign(outputFilePath, options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add squiggly annotation

Path: /annotation/java/add-squiggly-annotation/

Squiggly annotation marks text with a squiggly styling as shown in the picture below:

![](/annotation/net/images/add-squiggly-annotation.png)

You can specify the following properties of the [SquigglyAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/) class:

*   [FontColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/#setFontColor-java.lang.Integer-) defines the color of the annotation text
*   [Opacity](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [Points](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/#setPoints-java.util.List-com.groupdocs.annotation.models.Point--) defines the annotation positions as array of points 
*   [BackgroundColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/#setBackgroundColor-java.lang.Integer-) defines the area background color
*   [SquigglyColor](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/#setSquigglyColor-java.lang.Integer-) defines the annotation line color

To add a squiggly annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/) class. Specify the input document path or stream.
2.   Instantiate the [SquigglyAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [SquigglyAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/) class;
4.  Call the [Save](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.  

The following code snippet shows how to add [SquigglyAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/squigglyannotation/) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
//Add squiggly annotation to the document from local disk
try(final Annotator annotator = new Annotator("input.pdf")){
	SquigglyAnnotation squigglyAnnotation = new SquigglyAnnotation();
	squigglyAnnotation.setCreatedOn(new Date());
	squigglyAnnotation.setFontColor(65535);
	squigglyAnnotation.setBackgroundColor(16761035);
	squigglyAnnotation.setMessage("This is squiggly annotation");
	squigglyAnnotation.setOpacity(0.7);
	squigglyAnnotation.setPageNumber(0);
	squigglyAnnotation.setSquigglyColor(1422623);//Supported only Word and PDF
	List points = new ArrayList<Point>();
	points.add(new Point(80, 730));
	points.add(new Point(240, 730));
	points.add(new Point(80, 650));
	points.add(new Point(240, 650));

	Reply reply1 = new Reply();
	reply1.setComment("First comment");
	reply1.setRepliedOn(new Date());

	Reply reply2 = new Reply();
	reply2.setComment("Second comment");
	reply2.setRepliedOn(new Date());

	List<Reply> replies = new ArrayList<>();
	replies.add(reply1);
	replies.add(reply2);

	squigglyAnnotation.setReplies(replies);

	annotator.add(squigglyAnnotation);
	annotator.save("result_squiggly_annotation.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add squiggly annotation

Path: /annotation/net/add-squiggly-annotation/

Squiggly annotation marks text with a squiggly styling as shown in the picture below:

![](/annotation/net/images/add-squiggly-annotation.png)

You can specify the following properties of the [SquigglyAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/squigglyannotation) class:

*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/squigglyannotation/properties/fontcolor) defines the color of the annotation text
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/squigglyannotation/properties/opacity) allows you to set the annotation opacity
*   [Points](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/squigglyannotation/properties/points) defines the annotation positions as array of points 
*   [BackgroundColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/textfieldannotation/properties/backgroundcolor) defines the area background color
*   [SquigglyColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/squigglyannotation/properties/squigglycolor) defines the annotation line color

To add a squiggly annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [SquigglyAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/squigglyannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [SquigglyAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/squigglyannotation) class;
4.  Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.  

The following code snippet shows how to add [SquigglyAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/squigglyannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add squiggly annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	SquigglyAnnotation squiggly = new SquigglyAnnotation
    {
    	CreatedOn = DateTime.Now,
        FontColor = 65535,
        BackgroundColor = 16761035,
        Message = "This is squiggly annotation",
        Opacity = 0.7,
        PageNumber = 0,
        SquigglyColor = 1422623, //Supported only Word and PDF
        Points = new List<Point>
        {
        	new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650)
        },
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(squiggly);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add underline annotation

Path: /annotation/java/add-underline-annotation/

GroupDocs.Annotation allows you to underline text as shown in the picture below:

![](/annotation/java/images/add-underline-annotation.png)

You can use the following methods to set the properties of the [UnderlineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation) class:

*   [setFontColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation/#setFontColor-java.lang.Integer-) defines the color of the annotation text
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setPoints()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation/#setPoints-java.util.List-com.groupdocs.annotation.models.Point--) defines the annotation positions as array of points
*   [setUnderlineColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation/#setUnderlineColor-java.lang.Integer-) defines the color of the underline line

To add an underline annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [UnderlineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [UnderlineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

The following code snippet shows how to add [UnderlineAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/underlineannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding text underline annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    Point point1 = new Point(80, 730);
    Point point2 = new Point(240, 730);
    Point point3 = new Point(80, 650);
    Point point4 = new Point(240, 650);

    List<Point> points = new ArrayList<Point>();
    points.add(point1);
    points.add(point2);
    points.add(point3);
    points.add(point4);

    // Create an instance of AreaAnnotation class and set options
    UnderlineAnnotation underline = new UnderlineAnnotation();
    underline.setCreatedOn(Calendar.getInstance().getTime());
    underline.setFontColor(65535);
    underline.setMessage("This is underline annotation");
    underline.setOpacity(0.1);
    underline.setPageNumber(0);
    underline.setPoints(points);
    underline.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(underline);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Add underline annotation

Path: /annotation/net/add-underline-annotation/

Underline annotation underlines text as shown in the picture below:

![](/annotation/net/images/add-underline-annotation.png)

You can specify the following properties of the [UnderlineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/underlineannotation) class:

*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/underlineannotation/properties/fontcolor) defines the color of the annotation text
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/underlineannotation/properties/opacity) allows you to set the annotation opacity
*   [Points](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/underlineannotation/properties/points) defines the annotation positions as array of points
*   [UnderlineColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/underlineannotation/properties/underlinecolor) defines the color of the underline line

To add an underline annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [UnderlineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/underlineannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [UnderlineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/underlineannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

The following code snippet shows how to add [UnderlineAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/underlineannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add underline annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	UnderlineAnnotation underline = new UnderlineAnnotation
    {
    	CreatedOn = DateTime.Now,
        FontColor = 65535,
        BackgroundColor = 16761035,
        Message = "This is underline annotation",
        Opacity = 0.7,
        PageNumber = 0,
        UnderlineColor = 1422623, //Supported only Word and PDF documents
        Points = new List<Point>
        {
        	new Point(80, 730), new Point(240, 730), new Point(80, 650), new Point(240, 650)
        },
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(underline);
    annotator.Save("result.pdf");
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Convert XML Through XSLT Transformation to HTML, WordProcessing, or PDF

Path: /conversion/net/convert-xml-to-html-and-other-formats/


GroupDocs.Conversion for .NET allows you to transform XML data into a variety of formats, including HTML, WordProcessing documents (e.g., DOCX), and PDFs, using XSLT stylesheets. This method offers flexibility to define the layout, structure, and styling of the target format while leveraging the powerful XML transformation capabilities of XSLT.

## Key Features

- Transform XML data into different formats using custom XSLT templates.
- Output formats supported: HTML, DOCX, and PDF.
- Highly customizable transformation based on XSLT design.

## Prerequisites

Before proceeding, ensure the following:
1. GroupDocs.Conversion for .NET is installed in your project.
2. An XML file with the data to convert.
3. An XSLT stylesheet defining the transformation logic.

## Examples

### 1. Convert XML to HTML

The following code demonstrates converting XML to an HTML file using an XSLT template:

```csharp
using (var converter = new Converter("books.xml", (LoadContext loadContext) => new XmlLoadOptions
       {
           XsltFactory = () => new FileStream("bookstore-template.xslt", FileMode.Open)
       }))
{
    var options = new WebConvertOptions();
    converter.Convert("converted.html", options);
}
```

### 2. Convert XML to Wordprocessing

The following code demonstrates converting XML to a DOCX file using an XSLT template:

```csharp
using (var converter = new Converter("books.xml", (LoadContext loadContext) => new XmlLoadOptions
       {
           XsltFactory = () => new FileStream("bookstore-template.xslt", FileMode.Open)
       }))
{
    var options = new WordProcessingConvertOptions();
    converter.Convert("converted.docx", options);
}
```

### 3. Convert XML to PDF

The following code demonstrates converting XML to a PDF file using an XSLT template:

```csharp
using (var converter = new Converter("books.xml", (LoadContext loadContext) => new XmlLoadOptions
       {
           XsltFactory = () => new FileStream("bookstore-template.xslt", FileMode.Open)
       }))
{
    var options = new PdfConvertOptions();
    converter.Convert("converted.pdf", options);
}
```
---

## Generate Tables from Collection Data

Path: /assembly/net/basic-usage-generate-tables/


## Overview

Tables are one of the most common ways to display structured data in documents. GroupDocs.Assembly for .NET makes it easy to generate dynamic tables by iterating over collections and populating table rows with data.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources

Here are the steps to generate tables from collections:

* Create a table in your template document with a header row
* Add a data band row using `<<foreach>>` syntax to iterate over your collection
* Reference collection item properties in table cells
* Close the data band with `<<foreach>>`
* Assemble the document with your collection data

{{< alert style="info" >}}
Table-row data bands automatically repeat the table row for each item in the collection, creating a complete table with all data rows.
{{< /alert >}}

## Generate Table from .NET Object Collection

Create a table from a list of custom objects:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Product
{
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int Quantity { get; set; }
}

public static void GenerateTableFromCollection()
{
    // Create sample data
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Price = 999.99m, Quantity = 5 },
        new Product { Name = "Mouse", Price = 29.99m, Quantity = 20 },
        new Product { Name = "Keyboard", Price = 79.99m, Quantity = 15 }
    };
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("TableTemplate.docx", "TableOutput.docx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Table generated successfully.");
}
```

## Template Structure for Tables

In your template document (TableTemplate.docx), create a table with this structure:

| Product Name | Price | Quantity |
|--------------|-------|----------|
| `<<foreach [in products]>>` | | |
| `<<[Name]>>` | `<<[Price]>>` | `<<[Quantity]>>` |
| `<<foreach>>` | | |

The `<<foreach>>` tags should span the entire data row. After assembly, you'll get:

| Product Name | Price | Quantity |
|--------------|-------|----------|
| Laptop | 999.99 | 5 |
| Mouse | 29.99 | 20 |
| Keyboard | 79.99 | 15 |

## Generate Table with Formatting

You can format table cell values using format strings:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateFormattedTable()
{
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Price = 999.99m, Quantity = 5 },
        new Product { Name = "Mouse", Price = 29.99m, Quantity = 20 }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("TableTemplate.docx", "FormattedTable.docx", 
        new DataSourceInfo(products, "products"));
}
```

Template with formatting:

| Product Name | Price | Quantity |
|--------------|-------|----------|
| `<<foreach [in products]>>` | | |
| `<<[Name]>>` | `<<[Price]:"C">>` | `<<[Quantity]>>` |
| `<<foreach>>` | | |

The `:"C"` format string formats the price as currency.

## Generate Table from DataTable

You can also generate tables from ADO.NET DataTable:

```csharp
using GroupDocs.Assembly;
using System.Data;

public static void GenerateTableFromDataTable()
{
    // Create DataTable
    DataTable productsTable = new DataTable("Products");
    productsTable.Columns.Add("Name", typeof(string));
    productsTable.Columns.Add("Price", typeof(decimal));
    productsTable.Columns.Add("Quantity", typeof(int));
    
    // Add rows
    productsTable.Rows.Add("Laptop", 999.99m, 5);
    productsTable.Rows.Add("Mouse", 29.99m, 20);
    productsTable.Rows.Add("Keyboard", 79.99m, 15);
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("TableTemplate.docx", "DataTableOutput.docx", 
        new DataSourceInfo(productsTable, "products"));
    
    Console.WriteLine("Table generated from DataTable successfully.");
}
```

## Generate Table with Totals

Add a total row after the data rows:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateTableWithTotals()
{
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Price = 999.99m, Quantity = 5 },
        new Product { Name = "Mouse", Price = 29.99m, Quantity = 20 },
        new Product { Name = "Keyboard", Price = 79.99m, Quantity = 15 }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("TableWithTotalsTemplate.docx", "TableWithTotals.docx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Table with totals generated successfully.");
}
```

Template structure:

| Product Name | Price | Quantity |
|--------------|-------|----------|
| `<<foreach [in products]>>` | | |
| `<<[Name]>>` | `<<[Price]:"C">>` | `<<[Quantity]>>` |
| `<<foreach>>` | | |
| **Total** | `<<[products.Sum(p => p.Price)]:"C">>` | `<<[products.Sum(p => p.Quantity)]>>` |

## Generate Table in Spreadsheet

Tables work similarly in spreadsheet templates:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateTableInSpreadsheet()
{
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Price = 999.99m, Quantity = 5 },
        new Product { Name = "Mouse", Price = 29.99m, Quantity = 20 }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("TableTemplate.xlsx", "TableOutput.xlsx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Table generated in spreadsheet successfully.");
}
```

{{< alert style="warning" >}}
In spreadsheet templates, the data band row must be within a table structure. Select the range and create a table in Excel before adding the foreach syntax.
{{< /alert >}}

### Advanced Usage Topics

To learn more about filtering, sorting, grouping table data, conditional table rows, and advanced table formatting, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Indexing with stop words

Path: /search/java/indexing-with-stop-words/

Stop words are frequently used words that do not carry a semantic meaning and can be removed from an index to reduce its size.

You can enable or disable the use of stop words by calling the [setUseStopWords](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setUseStopWords(boolean)) method of the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class. The default value is true, meaning that stop words are filtered during indexing and not added to the index.

A list of stop words to use during indexing can be specified in the stop word dictionary. By default, the stop word dictionary is filled with the most widely used pronouns and prepositions of English and Russian. The list of stop words used can be easily replaced or supplemented and it is saved when the index is reloaded. For information on managing the stop word dictionary, see the [Stop word dictionary]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/stop-word-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

If you need to keep all text information extracted from documents, and you are not afraid of a significant increase in the size of the index, then an example of indexing without stop words can be found below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index settings with disabled using of stop words
IndexSettings settings = new IndexSettings();
settings.setUseStopWords(false);
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Searching in the index
// Now in the index it is possible to search for the stop word 'on'
SearchResult result = index.search("on");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing with stop words

Path: /search/net/indexing-with-stop-words/

Stop words are frequently used words that do not carry a semantic meaning and can be removed from an index to reduce its size.

You can enable or disable the use of stop words by setting a value of the [UseStopWords](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/usestopwords) property of the [IndexSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings) class. The default value is true, meaning that stop words are filtered during indexing and not added to an index.

A list of stop words to use during indexing can be specified in the stop word dictionary. By default, the stop word dictionary is filled with the most widely used pronouns and prepositions of English and Russian. The list of stop words used can be easily replaced or supplemented and it is saved when the index is reloaded. For information on managing the stop word dictionary, see the [Stop word dictionary]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/stop-word-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

If you need to keep all text information extracted from documents, and you are not afraid of a significant increase in the size of the index, then an example of indexing without stop words can be found below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index settings with disabled using of stop words
IndexSettings settings = new IndexSettings();
settings.UseStopWords = false;
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Searching in the index
// Now in the index it is possible to search for the stop word 'on'
SearchResult result = index.Search("on");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing with stop words

Path: /search/nodejs-java/indexing-with-stop-words/

Stop words are frequently used words that do not carry a semantic meaning and can be removed from an index to reduce its size.

You can enable or disable the use of stop words by calling the [setUseStopWords](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setUseStopWords(boolean)) method of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class. The default value is true, meaning that stop words are filtered during indexing and not added to the index.

A list of stop words to use during indexing can be specified in the stop word dictionary. By default, the stop word dictionary is filled with the most widely used pronouns and prepositions of English and Russian. The list of stop words used can be easily replaced or supplemented and it is saved when the index is reloaded. For information on managing the stop word dictionary, see the [Stop word dictionary]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/stop-word-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

If you need to keep all text information extracted from documents, and you are not afraid of a significant increase in the size of the index, then an example of indexing without stop words can be found below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index settings with disabled using of stop words
const settings = new groupdocs.search.IndexSettings();
settings.setUseStopWords(false);

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings, true);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Searching in the index
// Now in the index it is possible to search for the stop word 'on'
const query = 'on';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Load Database Documents with Options

Path: /conversion/net/load-database-document-with-options/


## Introduction

The **DatabaseLoadOptions** class enables you to configure how database documents and scripts are loaded in GroupDocs.Conversion. This class supports enterprise database formats used in corporate environments and database administration.

DatabaseLoadOptions works with database formats including NSF (Lotus Notes/IBM Notes storage) and SQL (Structured Query Language scripts).

## Properties

| Property | Type | Description |
|----------|------|-------------|
| `Format` | `DatabaseFileType` | The input database format (get; set;) |

## Basic Usage

For most scenarios, GroupDocs.Conversion automatically detects the database format:

```csharp
using (var converter = new Converter("customer-records.nsf"))
{
    converter.Convert("customer-records.pdf", new PdfConvertOptions());
}
```

## Using DatabaseLoadOptions with LoadContext

When you need explicit control over loading behavior, use DatabaseLoadOptions with the LoadContext delegate pattern:

```csharp
using (var converter = new Converter(
    "email-archive.nsf",
    (LoadContext loadContext) => new DatabaseLoadOptions()))
{
    converter.Convert("email-archive.pdf", new PdfConvertOptions());
}
```

## Working with Different Database Formats

GroupDocs.Conversion supports multiple database formats through DatabaseLoadOptions. Each format should be explicitly specified:

### NSF (Lotus Notes Storage Facility)

NSF is the database file format used by IBM Notes (formerly Lotus Notes), commonly used for storing emails, calendars, documents, and forms in enterprise environments:

```csharp
using (var converter = new Converter(
    "project-notes.nsf",
    (LoadContext loadContext) => new DatabaseLoadOptions
    {
        Format = DatabaseFileType.Nsf
    }))
{
    converter.Convert("project-notes.pdf", new PdfConvertOptions());
}
```

**Common use cases:**
- Email archives and mailbox exports
- Corporate document management systems
- Project collaboration databases
- Team calendars and scheduling systems

### SQL (Structured Query Language)

SQL files contain database scripts and queries used to create, modify, or query relational databases:

```csharp
using (var converter = new Converter(
    "schema-definition.sql",
    (LoadContext loadContext) => new DatabaseLoadOptions
    {
        Format = DatabaseFileType.Sql
    }))
{
    converter.Convert("schema-definition.pdf", new PdfConvertOptions());
}
```

**Common use cases:**
- Database schema documentation
- Migration script archives
- SQL query documentation
- Database backup scripts as PDF

## Converting Multiple Database Formats

Convert different database formats in a single workflow:

```csharp
// NSF to PDF
using (var converter = new Converter(
    "team-calendar.nsf",
    (LoadContext loadContext) => new DatabaseLoadOptions
    {
        Format = DatabaseFileType.Nsf
    }))
{
    converter.Convert("team-calendar.pdf", new PdfConvertOptions());
}

// SQL to PDF
using (var converter = new Converter(
    "migration-script.sql",
    (LoadContext loadContext) => new DatabaseLoadOptions
    {
        Format = DatabaseFileType.Sql
    }))
{
    converter.Convert("migration-script.pdf", new PdfConvertOptions());
}
```

## Supported Database Formats

DatabaseLoadOptions works with:
- **NSF** - Notes Storage Facility (IBM Notes/Lotus Notes database format)
- **SQL** - Structured Query Language scripts and queries

## Common Use Cases

Use DatabaseLoadOptions when you need to:

1. **Archive email systems** - Convert Lotus Notes mailboxes to PDF for long-term storage
2. **Document database schemas** - Create PDF documentation from SQL scripts
3. **Compliance and auditing** - Convert database documents for regulatory compliance
4. **Knowledge management** - Extract and convert corporate knowledge from Notes databases
5. **Database documentation** - Generate readable documentation from SQL scripts
6. **Legacy system migration** - Convert old Lotus Notes databases to modern formats

## When to Use DatabaseLoadOptions

Use DatabaseLoadOptions when:

- Converting Lotus Notes/IBM Notes databases (NSF)
- Processing SQL scripts and database queries
- Working with enterprise database documentation
- Archiving corporate email and collaboration data
- You need explicit control over database document loading

## Without DatabaseLoadOptions

For simple conversions, you can rely on automatic format detection:

```csharp
using (var converter = new Converter("customer-records.nsf"))
{
    converter.Convert("customer-records.pdf", new PdfConvertOptions());
}
```

GroupDocs.Conversion automatically detects the database format in most cases, so DatabaseLoadOptions is optional unless you need specific loading configuration.

## Output Format Compatibility

Database documents can be converted to various output formats:

- **Document formats**: PDF, DOCX, TXT, RTF
- **Web formats**: HTML, MHTML
- **Spreadsheet formats**: XLSX, XLS
- **Presentation formats**: PPTX, PPT
- **Image formats**: PNG, JPG, TIFF (page-by-page conversion)

## NSF Format Details

The NSF format is a container that can include:
- Email messages
- Calendar entries
- Contact information
- Documents and attachments
- Forms and views
- Access control lists

When converting NSF files, GroupDocs.Conversion processes the database structure and content, making it suitable for archival and documentation purposes.

## SQL Format Details

SQL files typically contain:
- CREATE TABLE statements
- ALTER TABLE modifications
- INSERT/UPDATE/DELETE operations
- SELECT queries
- Stored procedures
- Database constraints and indexes

Converting SQL files to PDF creates readable documentation of database schemas and operations, useful for:
- Code reviews
- Database design documentation
- Training materials
- Change management records

## Summary

DatabaseLoadOptions provides control over database document loading:
- **Format**: Specify NSF or SQL format explicitly
- **Supports**: IBM Notes databases (NSF) and SQL scripts
- **Use Case**: Enterprise data archival, compliance, database documentation

All examples on this page have been verified through automated testing to ensure accuracy.

## See Also

- [Context Objects - Complete Guide]({{< ref "conversion/net/developer-guide/basic-usage/context-objects-complete-guide" >}})
- [DatabaseFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/databasefiletype/)
- [DatabaseLoadOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/databaseloadoptions/)

---

## Merge archives

Path: /merger/java/merge/archives/


## How to merge archive files in Java

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to combine multiple ZIP documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine archive documents of any archive extensions such as ZIP or TAR.

The following example demonstrates how to merge archive files with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.lang.String-) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged archive file as parameter.

```java
// Load the source archive file
Merger merger = new Merger("c:\sample1.zip");
{
    // Add another archive file to merge
    merger.join("c:\sample2.zip");
    // Merge archive files and save result
    merger.save("c:\merged.zip");
}
```

### Merge different archive file formats

This section describes how to merge different archive file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge archives to ZIP in Java]({{< ref "merger/java/getting-started/use-cases/how-to-merge-archives-to-zip-using-java.md" >}})

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Archives Live Demo

GroupDocs.Merger for Java provides online [**ZIP Merger App**](https://products.groupdocs.app/merger/zip) and [**TAR Merger App**](https://products.groupdocs.app/merger/tar), which allow you to try it for free and check its quality and accuracy.
---

## Merge archives

Path: /merger/net/merge/archives/


## How to merge archive files in C\#

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple ZIP documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine archive documents of any archive extensions such as ZIP or TAR.

The following example demonstrates how to merge archive files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged archive file as parameter.

```csharp
// Load the source archive file
using (Merger merger = new Merger(@"c:\sample1.zip"))
{
    // Add another archive file to merge
    merger.Join(@"c:\sample2.zip");
    // Merge archive files and save result
    merger.Save(@"c:\merged.zip");
}
```

### Merge different archive file formats

This section describes how to merge different archive file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge archives to ZIP in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-archives-to-zip-using-csharp.md" >}})

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Archives Live Demo

GroupDocs.Merger for .NET provides online [**ZIP Merger App**](https://products.groupdocs.app/merger/zip) and [**TAR Merger App**](https://products.groupdocs.app/merger/tar), which allow you to try it for free and check its quality and accuracy.
---

## Merge archives

Path: /merger/nodejs-java/merge/archives/


## How to merge archive files in Node.js via Java

[GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) allows developers to combine multiple ZIP documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine archive documents of any archive extensions such as ZIP or TAR.

The following example demonstrates how to merge archive files with several lines of Node.js via Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.lang.String-) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and specify the filename for the merged archive file as parameter.

```js
const inputFilePath = `c:/sample1.zip`;
const merger = new groupdocs.merger.Merger(inputFilePath);
const outputPath = `c:/merged.zip`;
merger.join('c:/sample2.zip');
merger.save(outputPath);
```

### Merge different archive file formats

This section describes how to merge different archive file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge archives to ZIP in Node.js via Java]({{< ref "merger/nodejs-java/getting-started/use-cases/how-to-merge-archives-to-zip-using-nodejs-java.md" >}})

### Code Examples

Please find more [use-cases and complete Node.js via Java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Archives Live Demo

GroupDocs.Merger for Node.js via Java provides online [**ZIP Merger App**](https://products.groupdocs.app/merger/zip) and [**TAR Merger App**](https://products.groupdocs.app/merger/tar), which allow you to try it for free and check its quality and accuracy.
---

## Merge archives

Path: /merger/python-net/merge/archives/


## How to merge archive files in Python via .NET

[GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) allows developers to combine multiple ZIP documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine archive documents of any archive extensions such as ZIP or TAR.

The following example demonstrates how to merge archive files with several lines of Python via .NET code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/) class and pass source archive file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another archive file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other archive documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged archive file as parameter.

```python
with gm.Merger("c:/sample1.zip") as merger:
    merger.join("c:/sample2.zip")
    merger.save("c:/merged.zip")
```

### Merge different archive file formats

This section describes how to merge different archive file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge archives to ZIP in Python via .NET]({{< ref "merger/python-net/getting-started/use-cases/how-to-merge-archives-to-zip-using-python-net.md" >}})

### Code Examples

Please find more [use-cases and complete Python via .NET sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Archives Live Demo

GroupDocs.Merger for Python via .NET provides online [**ZIP Merger App**](https://products.groupdocs.app/merger/zip) and [**TAR Merger App**](https://products.groupdocs.app/merger/tar), which allow you to try it for free and check its quality and accuracy.
---

## Queries in text and object form

Path: /search/java/queries-in-text-and-object-form/

There are two ways to create a search query: in text or object form.

A search query in text form is simpler but less flexible. The flexibility of queries in object form lies in the fact that it is possible for each subquery to set separate search options. In object form, you can also use, for example, regular expression query as a part of more complex one. All combinations of nesting search queries in object form can be found on the page [Nesting search queries in object form]({{< ref "search/java/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}).

The correlation of two forms of search queries is that each text query before search is transformed to query in object form. Therefore, processor handles queries in object form faster.

The full specification of the query language in text form is presented on the page [Query language specification]({{< ref "search/java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}). Syntax with examples of all elements allowed in text search queries is presented on the page [Search operation table]({{< ref "search/java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}).

Each example in this documentation is usually given with the search query in text and object form.

The example of complex query in object form is given below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating index
Index index = new Index(indexFolder);
 
// Indexing
index.add(documentsFolder);
 
// Creating subquery 1 - simple word query
SearchQuery subquery1 = SearchQuery.createWordQuery("future");
subquery1.setSearchOptions(new SearchOptions()); // Setting search options only for subquery 1
subquery1.getSearchOptions().getFuzzySearch().setEnabled(true);
subquery1.getSearchOptions().getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(3)); // The maximum number of differences is 3
 
// Creating subquery 2 - numeric range query
SearchQuery subquery2 = SearchQuery.createNumericRangeQuery(1, 1000000);
 
// Creating subquery 3 - regular expression query 
SearchQuery subquery3 = SearchQuery.createRegexQuery("(.)\\1");
 
// Combining subqueries into one query - phrase search query
SearchQuery query = SearchQuery.createPhraseSearchQuery(subquery1, subquery2, subquery3);
 
// Creating overall search options with increased capacity of occurrences
SearchOptions options = new SearchOptions();
options.setMaxOccurrenceCountPerTerm(1000000);
options.setMaxTotalOccurrenceCount(10000000);
 
// Searching
SearchResult result = index.search(query, options);
 
// The result may contain the following word sequences:
// futile 12 blessed
// father 7 excellent
// tyre 8 assyria
// return 147 229
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Queries in text and object form

Path: /search/net/queries-in-text-and-object-form/

There are two ways to create a search query: in text or object form.

A search query in text form is simpler but less flexible. The flexibility of queries in object form lies in the fact that it is possible for each subquery to set separate search options. In object form, you can also use, for example, regular expression query as a part of more complex one. All combinations of nesting search queries in object form can be found on the page [Nesting search queries in object form]({{< ref "search/net/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}).

The correlation of two forms of search queries is that each text query before search is transformed to query in object form. Therefore, processor handles queries in object form faster.

The full specification of the query language in text form is presented on the page [Query language specification]({{< ref "search/net/developer-guide/advanced-usage/searching/query-language-specification.md" >}}). Syntax with examples of all elements allowed in text search queries is presented on the page [Search operation table]({{< ref "search/net/developer-guide/advanced-usage/searching/search-operation-table.md" >}}).

Each example in this documentation is usually given with the search query in text and object form.

The example of complex query in object form is given below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating index
Index index = new Index(indexFolder);
 
// Indexing
index.Add(documentsFolder);
 
// Creating subquery 1 - simple word query
SearchQuery subquery1 = SearchQuery.CreateWordQuery("future");
subquery1.SearchOptions = new SearchOptions(); // Setting search options only for subquery 1
subquery1.SearchOptions.FuzzySearch.Enabled = true;
subquery1.SearchOptions.FuzzySearch.FuzzyAlgorithm = new TableDiscreteFunction(3); // The maximum number of differences is 3
 
// Creating subquery 2 - numeric range query
SearchQuery subquery2 = SearchQuery.CreateNumericRangeQuery(1, 1000000);
 
// Creating subquery 3 - regular expression query 
SearchQuery subquery3 = SearchQuery.CreateRegexQuery(@"(.)\1");
 
// Combining subqueries into one query - phrase search query
SearchQuery query = SearchQuery.CreatePhraseSearchQuery(subquery1, subquery2, subquery3);
 
// Creating overall search options with increased capacity of occurrences
SearchOptions options = new SearchOptions();
options.MaxOccurrenceCountPerTerm = 1000000;
options.MaxTotalOccurrenceCount = 10000000;
 
// Searching
SearchResult result = index.Search(query, options);
 
// The result may contain the following word sequences:
// futile 12 blessed
// father 7 excellent
// tyre 8 assyria
// return 147 229
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Queries in text and object form

Path: /search/nodejs-java/queries-in-text-and-object-form/

There are two ways to create a search query: in text or object form.

A search query in text form is simpler but less flexible. The flexibility of queries in object form lies in the fact that it is possible for each subquery to set separate search options. In object form, you can also use, for example, regular expression query as a part of more complex one. All combinations of nesting search queries in object form can be found on the page [Nesting search queries in object form]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}).

The correlation of two forms of search queries is that each text query before search is transformed to query in object form. Therefore, processor handles queries in object form faster.

The full specification of the query language in text form is presented on the page [Query language specification]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}). Syntax with examples of all elements allowed in text search queries is presented on the page [Search operation table]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}).

Each example in this documentation is usually given with the search query in text and object form.

The example of complex query in object form is given below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating index
const index = new groupdocs.search.Index(indexFolder);

// Indexing
index.add(documentsFolder);

// Creating subquery 1 - simple word query
const subquery1 = groupdocs.search.SearchQuery.createWordQuery('future');
subquery1.setSearchOptions(new groupdocs.search.SearchOptions()); // Setting search options only for subquery 1
subquery1.getSearchOptions().getFuzzySearch().setEnabled(true);
subquery1.getSearchOptions().getFuzzySearch().setFuzzyAlgorithm(new groupdocs.search.TableDiscreteFunction(3)); // The maximum number of differences is 3

// Creating subquery 2 - wildcard query
const subquery2 = groupdocs.search.SearchQuery.createWildcardQuery(1);

// Creating subquery 3 - regular expression query
const subquery3 = groupdocs.search.SearchQuery.createRegexQuery('(.)\\1');

// Combining subqueries into one query - phrase search query
const query = groupdocs.search.SearchQuery.createPhraseSearchQuery(subquery1, subquery2, subquery3);

// Creating overall search options with increased capacity of occurrences
const options = new groupdocs.search.SearchOptions();
options.setMaxOccurrenceCountPerTerm(1000000);
options.setMaxTotalOccurrenceCount(10000000);

// Searching
const result = index.search(query, options);

// The result may contain the following word sequences:
// futile * blessed
// father * excellent
// tyre * assyria
// return * 229
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Render archives as HTML, PDF, and image files

Path: /viewer/nodejs-java/render-archive-files/

[GroupDocs.Viewer for Node.js via Java](https://products.groupdocs.com/viewer/nodejs-java) allows you to view the contents of archive files in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party file archiver and compression software to display archive file contents within your Node.js application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer) class instance. Pass an archive file you want to view to the class constructor. You can load the archive from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method overloads to convert the archive file to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/archive" >}} {{< icon "gdoc_person" >}} View archive files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-Node.js-via-Java" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported archive and compressed file formats

GroupDocs.Viewer supports the following archive file formats:

* [.7Z (7-Zip Compressed File)](https://docs.fileformat.com/compression/7z)
* [.BZ2 (Bzip2 Compressed File)](https://docs.fileformat.com/compression/bz2)
* [.GZ (Gnu Zipped Archive)](https://docs.fileformat.com/compression/gz)
* [.RAR (WinRAR Compressed Archive)](https://docs.fileformat.com/compression/rar)
* [.TAR (Consolidated Unix File Archive)](https://docs.fileformat.com/compression/tar)
* [.TGZ / .TAR.GZ (Gzipped Tar File)](https://docs.fileformat.com/compression/tgz/)
* [.TXZ / .TAR.XZ (XZ Compressed Tar Archive)](https://docs.fileformat.com/compression/xz/)
* [.XZ (XZ Compressed Archive)](https://docs.fileformat.com/compression/xz/)
* [.ZIP (Zipped File)](https://docs.fileformat.com/compression/zip)

## Render archive files as HTML

To convert an archive file to HTML, call the [HtmlViewOptions.forEmbeddedResources](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#forEmbeddedResources--) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method.

{{< tabs "render-archive-to-html">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("documents.zip")
// Create an HTML file for top folder and each subfolder in the archive.
// {0} is replaced with the current page number in the file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-archive-to-html/zip-to-html-page_{0}.html")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to HTML](/viewer/nodejs-java/images/rendering-basics/render-archive-files/render-archive-to-html-embedded-resources.png)

### Create a single HTML page

If you need to display the contents of an archive file on a single HTML page, use the [HtmlViewOptions.setRenderToSinglePage](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions/#setRenderToSinglePage-boolean-) method, as shown below:

{{< tabs "render-archive-to-single-page">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("documents.zip")
// Create an HTML file for the top folder and each subfolder in the archive.
// {0} is replaced with the current page number in the output file name.
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-archive-to-single-page/zip-to-html-page_{0}.html")
// Specify the number of items to display on each HTML page.
viewOptions.setRenderToSinglePage(true)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The animation below demonstrates the result. You can navigate between the archive folders. Click on a particular folder to see its contents. To go backward, click the required folder name in the navigation bar at the top of the web page.

![Navigate between folders in the archive](/viewer/nodejs-java/images/rendering-basics/render-archive-files/navigate-between-archive-files.gif)

## Render archive files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an archive file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file or reorder its pages. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/nodejs-java/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "render-archive-to-pdf">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PdfViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("documents.zip")
// Specify the PDF file name.
const viewOptions = PdfViewOptions("render-archive-to-pdf/zip-to-pdf.pdf")
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PDF](/viewer/nodejs-java/images/rendering-basics/render-archive-files/render-archive-to-pdf.png)

## Render archive files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an archive file to PNG. Use the [PngViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setHeight-int-) and [PngViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-archive-to-png">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, PngViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("documents.zip")
// Create a PNG image for the top folder and each subfolder in the archive.
// {0} is replaced with the current page number in the image name.
const viewOptions = PngViewOptions("render-archive-to-png/zip-to-png-page_{0}.png")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PNG](/viewer/nodejs-java/images/rendering-basics/render-archive-files/render-archive-to-png-image.png)

## Render archive files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/) method to convert an archive file to JPEG. Use the [JpgViewOptions.setHeight](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setHeight-int-) and [JpgViewOptions.setWidth](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions/#setWidth-int-) methods to specify the output image size in pixels.

{{< tabs "render-archive-to-jpeg">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, JpgViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("documents.zip")
// Create a JPG image for the top folder and each subfolder in the archive.
// {0} is replaced with the current page number in the image name.
const viewOptions = JpgViewOptions("render-archive-to-jpeg/zip-to-jpg-page_{0}.jpg")
// Set width and height.
viewOptions.setWidth(950)
viewOptions.setHeight(550)
viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Obtain information about folders in an archive file

Follow the steps below to obtain information about folders contained in an archive file. You can use this information to [specify which folder to display in the output file](#render-a-specific-folder).

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.getViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer/viewer/#getViewInfo-com.groupdocs.viewer.options.ViewInfoOptions-) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [ArchiveViewInfo](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/archiveviewinfo/) type.
3. Use the [ArchiveViewInfo.getFolders](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.results/archiveviewinfo/#getFolders--) method to obtain the lists of folders in the archive file.

{{< tabs "get-archive-folders-info">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, ViewInfoOptions } from '@groupdocs/groupdocs.viewer'

const viewer = new Viewer('sample.zip')

const viewInfoOptions = ViewInfoOptions.forHtmlView()
const viewInfo = viewer.getViewInfo(viewInfoOptions)
const folders = viewInfo.getFolders()

console.log('File type: ' + viewInfo.getFileType())
console.log('Pages count: ' + viewInfo.getPages().size())
console.log('Folders: ')
for (let i = 0; i < folders.size(); i++) {
  console.log(' - ', folders.get(i).toString())
}
```
{{< /tab >}}
{{< tab "sample.zip" >}}
{{< tab-text >}}
`sample.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/sample.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image shows a sample console output:

![Get information about an archive file](/viewer/nodejs-java/images/rendering-basics/render-archive-files/retrieve-archive-information.png)

GroupDocs.Viewer also allows you to list and extract all files contained in the archive. Refer to the following help topics for details:

* [List attachments](/viewer/nodejs-java/how-to-list-attachments/)
* [Save attachments](/viewer/nodejs-java/how-to-extract-and-save-attachments/)

## Render a specific folder

When you convert an archive file to HTML, PDF, or image format, GroupDocs.Viewer renders items from all folders contained in the archive. If you need to render items from a specific folder, use the [ArchiveOptions.setFolder](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/archiveoptions/#setFolder-java.lang.String-) method of one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/jpgviewoptions)

{{< tabs "render-archive-specific-folder">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("documents.zip")
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-archive-specific-folder/zip-to-html-page_{0}.html")
 
viewOptions.getArchiveOptions().setFolder("Documents/CAD files");

viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify the archive file name

When rendering an archive file, GroupDocs.Viewer displays the archive file name in the header of each page. If you need to change or hide this name, use the [ArchiveOptions.setFileName](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/archiveoptions/#setFileName-com.groupdocs.viewer.options.FileName-) method for a target view. You can set this option to one of the following values:

* [FileName.SOURCE](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/filename/#SOURCE)--- Returns the name of the source file (this name is used by default).
* [FileName.EMPTY](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/filename/#EMPTY)---Specifies an empty name. Use this value to hide the archive file name in the output file.
* A [FileName](https://reference.groupdocs.com/viewer/nodejs-java/com.groupdocs.viewer.options/filename) instance with a custom name you want to display in the output file.

The following code snippet demonstrates how to use a custom name when rendering an archive file to HTML:

{{< tabs "render-archive-with-custom-filename">}}
{{< tab "JavaScript" >}}
```js
import { Viewer, HtmlViewOptions, FileName } from '@groupdocs/groupdocs.viewer';

const viewer = new Viewer("documents.zip")
const viewOptions = HtmlViewOptions.forEmbeddedResources("render-archive-with-custom-filename/zip-to-html-page_{0}.html")

const fileName = new FileName("Sample Files")
viewOptions.getArchiveOptions().setFileName(fileName);

viewer.view(viewOptions)
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/nodejs-java/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Set a custom archive name](/viewer/nodejs-java/images/rendering-basics/render-archive-files/set-archive-name.png)

---

## Render archives as HTML, PDF, and image files

Path: /viewer/python-net/render-archive-files/

[GroupDocs.Viewer for Python via .Net](https://products.groupdocs.com/viewer/python-net) allows you to view the contents of archive files in HTML, PDF, PNG, and JPEG formats. You do not need to use third-party file archiver and compression software to display archive file contents within your .NET application (web or desktop). 

To start using the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer) class instance. Pass an archive file you want to view to the class constructor. You can load the archive from a file or stream. Call one of the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method overloads to convert the archive file to HTML, PDF, or image format.

{{< button style="primary" link="https://products.groupdocs.app/viewer/archive" >}} {{< icon "gdoc_person" >}} View archive files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported archive and compressed file formats

GroupDocs.Viewer supports the following archive file formats:

* [.7Z (7-Zip Compressed File)](https://docs.fileformat.com/compression/7z)
* [.BZ2 (Bzip2 Compressed File)](https://docs.fileformat.com/compression/bz2)
* [.GZ (Gnu Zipped Archive)](https://docs.fileformat.com/compression/gz)
* [.RAR (WinRAR Compressed Archive)](https://docs.fileformat.com/compression/rar)
* [.TAR (Consolidated Unix File Archive)](https://docs.fileformat.com/compression/tar)
* [.TGZ / .TAR.GZ (Gzipped Tar File)](https://docs.fileformat.com/compression/tgz/)
* [.TXZ / .TAR.XZ (XZ Compressed Tar Archive)](https://docs.fileformat.com/compression/xz/)
* [.XZ (XZ Compressed Archive)](https://docs.fileformat.com/compression/xz/)
* [.ZIP (Zipped File)](https://docs.fileformat.com/compression/zip)

GroupDocs.Viewer can detect the archive file format automatically based on information in the file header.

## Render archive files as HTML

To convert an archive file to HTML, call the [HtmlViewOptions.for_embedded_resources](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#methods) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method.

{{< tabs "example1">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_archive_to_html():
    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create an HTML file for the top folder and each subfolder in the archive.
        # {0} is replaced with the current page number in the output file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_archive_to_html/pdf_page_{0}.html")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_archive_to_html()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to HTML](/viewer/python-net/images/rendering-basics/render-archive-files/render-archive-to-html-embedded-resources.png)

### Specify the number of items to render

GroupDocs.Viewer supports the [HtmlViewOptions.archive_options.items_per_page](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/archiveoptions/#properties) option that allows you to specify the number of archive items to display on each HTML page. The default property value is **16**.

The following example demonstrates how to set this option in code:

{{< tabs "example2">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_archive_with_items_per_page():
    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create an HTML file for the top folder and each subfolder in the archive.
        # {0} is replaced with the current page number in the output file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_archive_with_items_per_page/archive_with_items_per_page_{0}.html")
        # Specify the number of items to display on each HTML page.
        viewOptions.archive_options.items_per_page = 10
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_archive_with_items_per_page()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

### Create a single HTML page

If you need to display the contents of an archive file on a single HTML page, enable the [HtmlViewOptions.render_to_single_page](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions/#properties) option, as shown below:

{{< tabs "example3">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_archive_to_single_html():
    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_archive_to_single_html/archive_to_single_html.html")
        # Render the archive file to a single page.
        viewOptions.render_to_single_page = True
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_archive_to_single_html()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The animation below demonstrates the result. You can navigate between the archive folders. Click on a particular folder to see its contents. To go backward, click the required folder name in the navigation bar at the top of the web page.

![Navigate between folders in the archive](/viewer/python-net/images/rendering-basics/render-archive-files/navigate-between-archive-files.gif)

## Render archive files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an archive file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file or reorder its pages. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/python-net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example4">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PdfViewOptions

def render_archive_to_pdf():
    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create a PDF file.
        viewOptions = PdfViewOptions("render_archive_to_pdf/archive_content.pdf")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_archive_to_pdf()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PDF](/viewer/python-net/images/rendering-basics/render-archive-files/render-archive-to-pdf.png)

## Render archive files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an archive file to PNG. Use the [PngViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) and [PngViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example5">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import PngViewOptions

def render_archive_to_png():
    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create a PNG image for the top folder and each subfolder in the archive.
        # {0} is replaced with the current page number in the image name.
        viewOptions = PngViewOptions("render_archive_to_png/archive_page_0_{0}.png")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_archive_to_png()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an archive file to PNG](/viewer/python-net/images/rendering-basics/render-archive-files/render-archive-to-png-image.png)

## Render archive files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.view](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer/viewer/#methods) method to convert an archive file to JPEG. Use the [JpgViewOptions.height](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) and [JpgViewOptions.width](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions/#properties) properties to specify the output image size in pixels.

{{< tabs "example6">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import JpgViewOptions

def render_archive_to_jpg():
    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create a JPEG image for the top folder and each subfolder in the archive.
        # {0} is replaced with the current page number in the image name.
        viewOptions = JpgViewOptions("render_archive_to_jpg/archive_to_jpg_{0}.jpg")
        # Set width and height.
        viewOptions.width = 800
        viewOptions.height = 1000
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_archive_to_jpg()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Render a specific folder

When you convert an archive file to HTML, PDF, or image format, GroupDocs.Viewer renders items from all folders contained in the archive. If you need to render items from a specific folder, specify the [ArchiveOptions.folder](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/archiveoptions/#properties) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/jpgviewoptions)

{{< tabs "example8">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions

def render_specific_archive_folder():

    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create an HTML file.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_specific_archive_folder/specific_archive_folder.html")
        viewOptions.archive_options.folder = "first_folder"
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_specific_archive_folder()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

## Specify the archive file name

When rendering an archive file, GroupDocs.Viewer displays the archive file name in the header of each page. If you need to change or hide this name, define the [archive_options.file_name](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/archiveoptions/#properties) property for a target view. You can set this option to one of the following values:

* [FileName.SOURCE](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/filename/#properties)--- Returns the name of the source file (this name is used by default).
* [FileName.EMPTY](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/filename/#properties)---Specifies an empty name. Use this value to hide the archive file name in the output file.
* A [FileName](https://reference.groupdocs.com/viewer/python-net/groupdocs.viewer.options/filename/) instance with a custom name you want to display in the output file.

The following code snippet demonstrates how to use a custom name when rendering an archive file to HTML:

{{< tabs "example9">}}
{{< tab "Python" >}}
```python
from groupdocs.viewer import Viewer
from groupdocs.viewer.options import HtmlViewOptions, FileName

def render_archive_with_custom_filename():
    # Load archive file
    with Viewer("documents.zip") as viewer:
        # Create an HTML file for the top folder and each subfolder in the archive.
        # {0} is replaced with the current page number in the output file name.
        viewOptions = HtmlViewOptions.for_embedded_resources("render_archive_with_custom_filename/archive_with_custom_filename_{0}.html")
        # Specify a custom filename
        viewOptions.archive_options.file_name = FileName("Sample Files")
        viewer.view(viewOptions)

if __name__ == "__main__":
    render_archive_with_custom_filename()
```
{{< /tab >}}
{{< tab "documents.zip" >}}
{{< tab-text >}}
`documents.zip` is the sample file used in this example. Click [here](/viewer/python-net/_sample_files/rendering-basics/render-archive-files/documents.zip) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

The image below demonstrates the result.

![Set a custom archive name](/viewer/python-net/images/rendering-basics/render-archive-files/set-archive-name.png)

---

## Show gap lines instead of changes

Path: /comparison/java/show-gap-lines/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to adjust appearance of the output document.

By default, changes from the two input files (source and target files) are added to the output document and highlighted. Use the [ShowInsertedContent](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowInsertedContent-boolean-) and [ShowDeletedContent](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowDeletedContent-boolean-) properties to configure the content of the output file.

Use the [LeaveGaps](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setLeaveGaps-boolean-) property to adjust the display of the output document, which allows to replace changed content with empty lines. To use this property, activate the [ShowInsertedContent](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowInsertedContent-boolean-) and [ShowDeletedContent](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowDeletedContent-boolean-) properties.

Follow these steps to adjust appearance of the output document:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/) object. Specify the source file path or stream.
2.  Call the [add()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object. Set the [ShowInsertedContent](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowInsertedContent-boolean-), [ShowDeletedContent](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowDeletedContent-boolean-), and/or [LeaveGaps](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setLeaveGaps-boolean-) properties.
4.  Call the [compare()](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/) object from the previous step.

The following code snippet shows how get the desired result

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");

    CompareOptions options = new CompareOptions();
    options.setShowInsertedContent(false);
    options.setShowDeletedContent(false);
    options.setLeaveGaps(true);

    comparer.compare(resultPath, options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                        Default result                         |                Result without LeaveGaps property                 |
| :-----------------------------------------------------------: | :--------------------------------------------------------------: |
| ![](/comparison/java/images/show-gap-lines-default-result.png) | ![](/comparison/java/images/show-gap-lines-without-leavegaps.png) |

|                        Default result                         |                Result with LeaveGaps property                 |
| :-----------------------------------------------------------: | :-----------------------------------------------------------: |
| ![](/comparison/java/images/show-gap-lines-default-result.png) | ![](/comparison/java/images/show-gap-lines-with-leavegaps.png) |

---

## Show gap lines instead of changes

Path: /comparison/net/show-gap-lines/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to adjust appearance of the output document.

By default, changes from the two input files (source and target files) are added to the output document and highlighted. Use the [ShowInsertedContent](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showinsertedcontent) and [ShowDeletedContent](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showdeletedcontent) properties to configure the content of the output file.

Use the [LeaveGaps](https://reference.groupdocs.com/error/404?path=comparison/net/groupdocs.comparison.options/compareoptions/properties/leavegaps) property to adjust the display of the output document, which allows to replace changed content with empty lines. To use this property, activate the [ShowInsertedContent](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showinsertedcontent) and [ShowDeletedContent](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showdeletedcontent) properties.

Follow these steps to adjust appearance of the output document:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify the source file path or stream.
2.  Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/add/index) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. Sets the [ShowInsertedContent](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showinsertedcontent), [ShowDeletedContent](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/showdeletedcontent), and/or [LeaveGaps](https://reference.groupdocs.com/error/404?path=comparison/net/groupdocs.comparison.options/compareoptions/properties/leavegaps) properties.
4.  Call the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how get the desired result

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");

    CompareOptions options = new CompareOptions();
    options.ShowInsertedContent = false;
    options.ShowDeletedContent = false;
    options.LeaveGaps = true;

    comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

|                        Default result                         |                Result without LeaveGaps property                 |
| :-----------------------------------------------------------: | :--------------------------------------------------------------: |
| ![](/comparison/net/images/show-gap-lines-default-result.png) | ![](/comparison/net/images/show-gap-lines-without-leavegaps.png) |

|                        Default result                         |                Result with LeaveGaps property                 |
| :-----------------------------------------------------------: | :-----------------------------------------------------------: |
| ![](/comparison/net/images/show-gap-lines-default-result.png) | ![](/comparison/net/images/show-gap-lines-with-leavegaps.png) |

---

## Show gap lines instead of changes

Path: /comparison/nodejs-java/show-gap-lines/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to adjust the appearance of the output document.

By default, changes from the two input files (source and target files) are added to the output document and highlighted. Use the `ShowInsertedContent` and `ShowDeletedContent` properties to configure the content of the output file.

Use the `LeaveGaps` property to adjust the display of the output document, which replaces the changed content with empty lines. To use this property, activate the `ShowInsertedContent` and `ShowDeletedContent` properties.

The following code snippet shows how to get the desired result

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and result documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const resultPath = 'result.docx';

// Initialize comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to be compared
comparer.add(targetPath);

// Create comparison options object
const options = new groupdocs.CompareOptions();

// Do not display inserted content in the result
options.setShowInsertedContent(false);

// Do not display deleted content in the result
options.setShowDeletedContent(false);

// Keep gaps where deletions occurred
options.setLeaveGaps(true);

// Execute comparison and save the result to the specified path
comparer.compare(resultPath, options);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It configures the output to hide both inserted and deleted content by setting `setShowInsertedContent(false)` and `setShowDeletedContent(false)`, then enables gap lines by setting `setLeaveGaps(true)`. When the comparison is performed, instead of showing the actual changed content, empty lines (gaps) will be inserted where changes occurred, providing a cleaner view of the document structure.

The result is as follows:

|                        Default result                         |                Result without LeaveGaps property                 |
| :-----------------------------------------------------------: | :--------------------------------------------------------------: |
| ![](/comparison/nodejs-java/images/show-gap-lines-default-result.png) | ![](/comparison/nodejs-java/images/show-gap-lines-without-leavegaps.png) |

|                        Default result                         |                Result with LeaveGaps property                 |
| :-----------------------------------------------------------: | :-----------------------------------------------------------: |
| ![](/comparison/nodejs-java/images/show-gap-lines-default-result.png) | ![](/comparison/nodejs-java/images/show-gap-lines-with-leavegaps.png) |

---

## Show gap lines instead of changes

Path: /comparison/python-net/show-gap-lines/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) lets you adjust the output appearance by replacing changed content with empty lines.

## Replace changes with gap lines

Disable inserted/deleted content in the result and leave gaps where changes occurred.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.show_inserted_content = False
    options.show_deleted_content = False
    options.leave_gaps = True
    comparer.compare("result.docx", options)
```

🔹 Use case: Provide redacted-style diffs that keep layout alignment without showing actual changed text.

The result is as follows:

|                        Default result                         |                Result without LeaveGaps property                 |
| :-----------------------------------------------------------: | :--------------------------------------------------------------: |
| ![](/comparison/python-net/images/show-gap-lines-default-result.png) | ![](/comparison/python-net/images/show-gap-lines-without-leavegaps.png) |

|                        Default result                         |                Result with LeaveGaps property                 |
| :-----------------------------------------------------------: | :-----------------------------------------------------------: |
| ![](/comparison/python-net/images/show-gap-lines-default-result.png) | ![](/comparison/python-net/images/show-gap-lines-with-leavegaps.png) |



---

## Sign document with ordering the signatures

Path: /signature/java/sign-document-with-ordering/

[**com.groupdocs.signature**](https://products.groupdocs.com/signature/java) provides with [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/signoptions/) property ZOrder that expects integer values as Z-order position. The signatures with a higher number of this property will be displayed above the others.

Here are the steps to manually adjust the ordering of signatures on the document page with com.groupdocs.signature:

* Create a new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/) class and pass the source document path as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/signoptions/) object with the required options and set the ZOrder property.
* Call [sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/#sign-java.lang.String-com.groupdocs.signature.options.sign.SignOptions-) method of  [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/signoptions/) to it.

## Sign document with Text signature

This example shows how to add Text signature to document.

```java
using (Signature signature = new Signature("sample.pdf"))
{
    TextSignOptions options = new TextSignOptions("John Smith")
    {
        // set signature position
        Left = 100,
        Top = 100,
        // set signature rectangle
        Width = 100,
        Height = 30,
        // set signature alignment
        // when VerticalAlignment is set the Top coordinate will be ignored.
        // Use Margin properties Top, Bottom to provide vertical offset
        VerticalAlignment = Domain.VerticalAlignment.Top,
        // when HorizontalAlignment is set the Left coordinate will be ignored.
        // Use Margin properties Left, Right to provide horizontal offset
        HorizontalAlignment = Domain.HorizontalAlignment.Right,
        Margin = new Padding() { Top = 20, Right = 20 },
        // adjust signature appearance
        // setup signature border
        Border = new Border()
        {
            Color = Color.DarkGreen,
            DashStyle = DashStyle.DashLongDashDot,
            Transparency = 0.5,
            Visible = true,
            Weight = 2
        },
        // set text color and Font
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" },
        // setup background
        Background = new Background()
        {
            Color = Color.LimeGreen,
            Transparency = 0.5,
            Brush = new LinearGradientBrush(Color.LimeGreen, Color.DarkGreen)
        },
        // set rotation
        RotationAngle = 45,
        // set alternative signature implementation on document page
        SignatureImplementation = TextSignatureImplementation.Image

    };
    // set up shadow options for text
    TextShadow shadow = new TextShadow();
    shadow.Color = Color.OrangeRed;
    shadow.Angle = 135;
    shadow.Blur = 5;
    shadow.Distance = 4;
    shadow.Transparency = 0.2;
    //add text shadow to signature extensions
    options.Extensions.Add(shadow);

    // specify Spreadsheet position over extension
     options.Extensions.Add(new SpreadsheetPosition(10, 10));
    // sign document to file
    signature.Sign("signed.pdf", options);
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign document with XAdES Digital signature

Path: /signature/java/sign-document-with-xades-digital-signature/

{{< alert style="info" >}}This feature is supported only for Spreadsheet document types{{< /alert >}}

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [DigitalSignOptions](https://reference.groupdocs.com/net/signature/groupdocs.signature.options/digitalsignoptions) class to specify different amount of settings for Digital signature same as property XAdES of [XAdES](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/xadestype) enumeration type. This property specifies the implementation of [XAdES format](https://en.wikipedia.org/wiki/XAdES) for Spreadsheet documents only (for now).

Here are the steps to add XAdES type signature into document with GroupDocs.Signature:

*   Create new instance of [Signature](https://reference.groupdocs.com/net/signature/groupdocs.signature/signature) class and pass source document path as a constructor parameter.    
*   Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/net/signature/groupdocs.signature.options/digitalsignoptions) object with required certificate and its password.    
*   Set property [XAdESType](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/properties/xadestype) to value XAdES      
*   Call [Sign](https://reference.groupdocs.com/net/signature/groupdocs.signature/signature/methods/sign) method of  [Signature](https://reference.groupdocs.com/net/signature/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/net/signature/groupdocs.signature.options/digitalsignoptions) to it.    
*   Analyze [SignResult](https://reference.groupdocs.com/net/signature/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.  
      
    

This example shows how to add Digital signature to document. See [SignResult](https://reference.groupdocs.com/net/signature/groupdocs.signature.domain/signresult) 

```csharp
using (Signature signature = new Signature("sample.xlsx"))
{
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // set XAdES type
        XAdESType = XAdESType.XAdES,
        // certificate password
        Password = "1234567890",
        // digital certificate details
        Reason = "Sign",
        Contact = "JohnSmith",
        Location = "Office1"
    };
    SignResult signResult = signature.Sign(outputFilePath, options);
}
```

## More resources
### GitHub Examples
You may easily run the code above and see the feature in action in our GitHub examples:
*   [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)    
*   [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)    
*   [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)     
*   [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)    
*   [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)    
*   [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)    

### Free Online App 
Along with full-featured .NET library we provide simple, but powerful free Apps.  
You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Sign document with XML Advanced Electronic Signature

Path: /signature/net/sign-document-with-xml-advanced-electronic-signature/

{{< alert style="info" >}}XML Advanced Electronic Signature feature is now supported under .Net Framework only for Spreadsheet documents{{< /alert >}}

**GroupDocs.Signature** provides [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) class to specify different amount of settings for Digital signature. One of these properties is the field of enumeration type [XAdESType](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/xadestype)

Here are the steps to add XML Advanced Electronic Signature with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) object with required certificate and its password.
* Set property XAdESType to enumeration value **XAdESType.XAdES.**
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [DigitalSignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/digitalsignoptions/) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult) result to check newly created signatures if needed.

## Sign Spreadsheet document with XML Advanced Electronic Signature

This example shows how to add Digital signature to document.

```csharp
using (Signature signature = new Signature("sample.xlsx"))
{
    DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
    {
        // set XAdES type
        XAdESType = XAdESType.XAdES,
        // certificate password
        Password = "1234567890",
        // digital certificate details
        Reason = "Sign",
        Contact = "JohnSmith",
        Location = "Office1"
    };
    SignResult signResult = signature.Sign(outputFilePath, options);
    Console.WriteLine($"\nSource document was signed successfully with {signResult.Succeeded.Count} signature(s).\nFile saved at {outputFilePath}.");
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Sign document with analysis of the Sign process result

Path: /signature/net/sign-document-with-result-analysis/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides the each method result as the implementation of the [IResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/iresult/) interface which contains the process metrics.

Here are the steps to analyze the process result with GroupDocs.Signature:

* Create a new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source document path as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object with the required options and set the ZOrder property.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult/) response of the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method.


## Sign document with result analysis

This example shows how to analize sign process result.

```csharp
public static void Run()
{
    using (Signature signature = new Signature("sample.pdf"))
    {
        // create QRCode option with predefined QRCode text
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");

        // sign document to file
        SignResult signResult = signature.Sign("output.pdf", options);

        // analyze SignResult (IResult properties)
        Console.WriteLine($"Sign-process was executed for {signResult.ProcessingTime} mls");
        Console.WriteLine($"Input document size {signResult.SourceDocumentSize} bytes");
        Console.WriteLine($"Output document size {signResult.DestinDocumentSize} bytes");
        Console.WriteLine($"Total processed signatures {signResult.TotalSignatures}");
        if (signResult.Failed.Count == 0)
        {
            Console.WriteLine("\nAll signatures were successfully created!");
        }
        else
        {
            Console.WriteLine($"Successfully created signatures : {signResult.Succeeded.Count}");
            Helper.WriteError($"Failed signatures : {signResult.Failed.Count}");
        }
        Console.WriteLine("\nList of newly created signatures:");
        int number = 1;
        foreach (BaseSignature temp in signResult.Succeeded)
        {
            Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}");
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Advanced search archive documents

Path: /signature/net/advanced-search-archive-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [archiveSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/archivesearchoptions) class to specify different options to search text data within the archive documents. 
Please be aware that the search result will be always as the MetadataSignature.

Here are the steps to search for the values within the archive document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the various [SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) objects according to your requirements. Here there's ability to compose list of any search options types.
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass list of the [SearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/searchoptions) to it.

This example shows how to make advanced search for any data within the archive documents.

```csharp
using (var signature = new Signature("archive.zip"))
{
    // create list of signature options
    var bcOptions = new BarcodeSearchOptions(BarcodeTypes.Code128);
    var qrOptions = new QrCodeSearchOptions(QrCodeTypes.QR);

    // setup search options
    List<SearchOptions> listOptions = new List<SearchOptions>() { bcOptions, qrOptions };

    // search archive for documents
    var searchResult = signature.Search(listOptions);

    // check the result                
    Console.WriteLine("\nList of successfully processed documents:");
    int number = 1;
    foreach (DocumentResultSignature document in searchResult.Succeeded)
    {
        Console.WriteLine($"Document #{number++}: {document.FileName}. Processed: {document.ProcessingTime}, mls");
        foreach (BaseSignature temp in document.Succeeded)
        {
            Console.WriteLine($"\t\t#{temp.SignatureId}: {temp.SignatureType}");
        }
    }
    if (searchResult.Failed.Count > 0)
    {
        Console.WriteLine("\nList of failed documents:");
        number = 1;
        foreach (DocumentResultSignature document in searchResult.Failed)
        {
            Console.WriteLine($"ERROR in Document #{number++}-{document.FileName}: {document.ErrorMessage}, mls");
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Add watermark annotation

Path: /annotation/java/add-watermark-annotation/

Watermark annotation allows you to add a text watermark as shown in the picture below:

![](/annotation/java/images/add-watermark-annotation.png)

You can use the following methods to set the properties of the [WatermarkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation) class:

*   [setBox()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setBox-com.groupdocs.annotation.models.Rectangle-) defines the annotation position at the document page
*   [setText()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setText-java.lang.String-) defines the watermark text
*   [setFontColor()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setFontColor-java.lang.Integer-) defines the color of the annotation text
*   [setFontFamily()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setFontFamily-java.lang.String-) defines the font of the annotation text
*   [setFontSize()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setFontSize-java.lang.Double-) defines the text font size
*   [setOpacity()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setOpacity-java.lang.Double-) allows you to set the annotation opacity
*   [setAngle()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setAngle-java.lang.Double-) defines the watermark text angle
*   [setVerticalAlignment()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setVerticalAlignment-java.lang.Integer-)  defines the vertical alignment
*   [setHorizontalAlignment()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setHorizontalAlignment-java.lang.Integer-) defines the horizontal alignment
*   [setAutoScale()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation/#setAutoScale-java.lang.Boolean-) sets the watermark size  depending on the word length and the page size

To add a watermark annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/java/annotation/com.groupdocs.annotation/Annotator) class. Specify the input document path or stream.
2.   Instantiate the [WatermarkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [add()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#add-com.groupdocs.annotation.models.annotationmodels.AnnotationBase-) method. Specify the [WatermarkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation) class.
4.   Call the [save()](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation/annotator/#save--) method. Specify the output document path or stream.

  

The following code snippet shows demonstrates how to add [WatermarkAnnotation](https://reference.groupdocs.com/annotation/java/com.groupdocs.annotation.models.annotationmodels/watermarkannotation) to the document:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
// This example demonstrates adding watermark annotation.

// Create an instance of Annotator class
Annotator annotator = new Annotator("inputPath");
try {
    // Create an instance of Reply class and add comments
    Reply reply1 = new Reply();
    reply1.setComment("First comment");
    reply1.setRepliedOn(Calendar.getInstance().getTime());

    Reply reply2 = new Reply();
    reply2.setComment("Second comment");
    reply2.setRepliedOn(Calendar.getInstance().getTime());

    java.util.List<Reply> replies =  new ArrayList<Reply>();
    replies.add(reply1);
    replies.add(reply2);

    // Create an instance of WatermarkAnnotation class and set options
    WatermarkAnnotation watermark = new WatermarkAnnotation();
    watermark.setAngle((double) 75);
    watermark.setBox(new Rectangle(200, 200, 100, 50));
    watermark.setCreatedOn(Calendar.getInstance().getTime());
    watermark.setText("Watermark");
    watermark.setFontColor(65535);
    watermark.setFontSize((double) 12);
    watermark.setMessage("This is watermark annotation");
    watermark.setOpacity(0.7);
    watermark.setPageNumber(0);
    watermark.setReplies(replies);
    
    // Add annotation and save to file
    annotator.add(watermark);
    annotator.save("outputPath");
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
```
{{< /tab >}}
{{< /tabs >}}.
---

## Add watermark annotation

Path: /annotation/net/add-watermark-annotation/

Watermark annotation adds text watermark as shown in the picture below:

![](/annotation/net/images/add-watermark-annotation.png)

You can specify the following properties of the [WatermarkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/watermarkannotation) class:

*   [Box](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/properties/box) defines the annotation position at the document page
*   [Text](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/properties/text) defines the watermark text
*   [FontColor](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/properties/fontcolor) defines the color of the annotation text
*   [FontFamily](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/properties/fontfamily) defines the font of the annotation text
*   [FontSize](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/properties/fontsize) defines the text font size. If the `AutoScale` property is `true`, GroupDocs.Annotation ignores this property
*   [Opacity](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/properties/opacity) allows you to set the annotation opacity
*   [Angle](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/properties/angle) defines the watermark text angle
*   [VerticalAlignment](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/verticalalignment/)  defines the vertical alignment
*   [HorizontalAlignment](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/horizontalalignment/) defines the horizontal alignment
*   [AutoScale](https://reference.groupdocs.com/annotation/net/groupdocs.annotation.models.annotationmodels/watermarkannotation/autoscale/) sets the watermark size  depending on the word length and the page size. If this property is `true`, GroupDocs.Annotation ignores the `FontSize` property

To add a watermark annotation, follow these steps:

1.   Instantiate the [Annotator](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator) class. Specify the input document path or stream.
2.   Instantiate the [WatermarkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/watermarkannotation) class. Specify the appropriate properties (position, page number, etc).
3.   Call the [Add](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/add) method. Specify the [WatermarkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/watermarkannotation) class.
4.   Call the [Save](https://reference.groupdocs.com/net/annotation/groupdocs.annotation/annotator/methods/save/index) method. Specify the output document path or stream.

  

The following code snippet shows demonstrates how to add [WatermarkAnnotation](https://reference.groupdocs.com/net/annotation/groupdocs.annotation.models.annotationmodels/watermarkannotation) to the document:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
//Add watermark annotation to the document from local disk
using (Annotator annotator = new Annotator("input.pdf"))
{
	WatermarkAnnotation watermark = new WatermarkAnnotation
    {
    	Angle = 75,
        Box = new Rectangle(200, 200, 100, 50),
        CreatedOn = DateTime.Now,
        Text = "Watermark",
        FontColor = 65535,
        FontSize = 12,
        Message = "This is watermark annotation",
        Opacity = 0.7,
        AutoScale = true,
        HorizontalAlignment = HorizontalAlignment.Center,
        VerticalAlignment = VerticalAlignment.Center,
        Replies = new List<Reply>
        {
        	new Reply
            {
            	Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
            	Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(watermark);
    annotator.Save("result.pdf");
} 
```
{{< /tab >}}
{{< /tabs >}}.
---

## Convert to eBook with advanced options

Path: /conversion/net/convert-to-ebook-with-advanced-options/


## Introduction

GroupDocs.Conversion provides [EBookConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ebookconvertoptions) to give you control over conversion result when converting to eBook formats. Along with [common convert options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}}) from the base class, [EBookConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ebookconvertoptions) provides the following additional options:

## Properties

| Property | Type | Description |
|----------|------|-------------|
| [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) | `EBookFileType` | Specifies the desired eBook format. Available options are: *Epub, Mobi, Azw3* |
| [PageSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pageconvertoptions-1/pagesize) | `PageSize` | Sets the page size for the converted eBook |
| [PageWidth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pageconvertoptions-1/pagewidth) | `double` | Sets custom page width in points |
| [PageHeight](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pageconvertoptions-1/pageheight) | `double` | Sets custom page height in points |
| [PageOrientation](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pageconvertoptions-1/pageorientation) | `PageOrientation` | Sets page orientation (*Portrait* or *Landscape*) |
| [FallbackPageSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pageconvertoptions-1/fallbackpagesize) | `PageSize` | Sets fallback page size when source page dimensions cannot be determined |
| [PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pagenumber) | `int` | Specifies the starting page number for conversion |
| [PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pagescount) | `int` | Specifies the number of pages to convert |
| [Pages](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pages) | `List<int>` | Specifies specific page numbers to convert |

## Basic Usage

Convert any document to EPUB format with default options:

```csharp
using (var converter = new Converter("document.pdf"))
{
    var options = new EBookConvertOptions();
    converter.Convert("document.epub", options);
}
```

## Converting to Different eBook Formats

Convert documents to EPUB, MOBI, or AZW3 formats by specifying the desired format:

### Convert to EPUB

```csharp
using (var converter = new Converter("document.pdf"))
{
    var options = new EBookConvertOptions
    {
        Format = EBookFileType.Epub
    };
    converter.Convert("output.epub", options);
}
```

### Convert to MOBI

```csharp
using (var converter = new Converter("document.docx"))
{
    var options = new EBookConvertOptions
    {
        Format = EBookFileType.Mobi
    };
    converter.Convert("output.mobi", options);
}
```

### Convert to AZW3

```csharp
using (var converter = new Converter("presentation.pptx"))
{
    var options = new EBookConvertOptions
    {
        Format = EBookFileType.Azw3
    };
    converter.Convert("output.azw3", options);
}
```

## Page Orientation

Set the page orientation for the converted eBook:

```csharp
using (var converter = new Converter("landscape-document.pdf"))
{
    var options = new EBookConvertOptions
    {
        PageOrientation = PageOrientation.Landscape
    };
    converter.Convert("landscape-ebook.epub", options);
}
```

## Custom Page Dimensions

Specify custom page width and height in points for precise control:

```csharp
using (var converter = new Converter("document.pdf"))
{
    var options = new EBookConvertOptions
    {
        PageWidth = 432,   // Width in points (6 inches × 72 points/inch)
        PageHeight = 648   // Height in points (9 inches × 72 points/inch)
    };
    converter.Convert("custom-size.epub", options);
}
```

## Converting Specific Pages

Convert only selected pages from the source document:

### Convert First Page Only

```csharp
using (var converter = new Converter("multi-page.pdf"))
{
    var options = new EBookConvertOptions
    {
        PageNumber = 1,
        PagesCount = 1
    };
    converter.Convert("first-page.epub", options);
}
```

### Convert Specific Page Range

```csharp
using (var converter = new Converter("report.pdf"))
{
    var options = new EBookConvertOptions
    {
        PageNumber = 2,   // Start from page 2
        PagesCount = 5    // Convert 5 pages (pages 2-6)
    };
    converter.Convert("selected-pages.epub", options);
}
```

## Supported Source Formats

You can convert the following document types to eBook formats:

- **Documents**: PDF, DOC, DOCX, RTF, ODT, TXT
- **Presentations**: PPT, PPTX, ODP
- **Spreadsheets**: XLS, XLSX, ODS, CSV
- **Web**: HTML, MHTML, HTM
- **Images**: JPG, PNG, TIFF, BMP (single or multi-page)
- **eBooks**: Convert between EPUB, MOBI, and AZW3 formats

## eBook Format Details

### EPUB (Electronic Publication)

EPUB is the most widely supported eBook format, compatible with:
- Apple Books (iOS, macOS)
- Google Play Books
- Adobe Digital Editions
- Most e-readers (except Amazon Kindle)

**Use Cases:**
- General-purpose eBook distribution
- Publishing for non-Kindle devices
- Academic and technical documentation
- Digital magazines and newspapers

### MOBI (Mobipocket)

MOBI is Amazon's legacy eBook format, supported by:
- Older Kindle devices
- Kindle apps (with limitations)

**Use Cases:**
- Legacy Kindle device support
- Older eBook reader compatibility

**Note**: For modern Kindle devices, use AZW3 instead.

### AZW3 (Kindle Format 8)

AZW3 is Amazon's modern eBook format with enhanced features:
- Better typography and formatting
- Fixed layout support
- Enhanced image handling
- Kindle-exclusive features

**Use Cases:**
- Publishing to Amazon Kindle Store
- Kindle device optimization
- Enhanced formatting requirements

## Common Use Cases

### 1. Digital Publishing

Convert manuscripts and documents to eBook format for digital distribution:

```csharp
using (var converter = new Converter("manuscript.docx"))
{
    var options = new EBookConvertOptions
    {
        Format = EBookFileType.Epub,
        PageOrientation = PageOrientation.Portrait
    };
    converter.Convert("published-book.epub", options);
}
```

### 2. Technical Documentation

Create eBook versions of technical manuals and documentation:

```csharp
using (var converter = new Converter("user-manual.pdf"))
{
    var options = new EBookConvertOptions
    {
        Format = EBookFileType.Mobi,
        PageWidth = 432,   // 6 inches × 72 points/inch
        PageHeight = 648   // 9 inches × 72 points/inch
    };
    converter.Convert("user-manual.mobi", options);
}
```

### 3. Report Distribution

Convert business reports to portable eBook format:

```csharp
using (var converter = new Converter("quarterly-report.xlsx"))
{
    var options = new EBookConvertOptions
    {
        Format = EBookFileType.Epub,
        PageOrientation = PageOrientation.Landscape
    };
    converter.Convert("quarterly-report.epub", options);
}
```

### 4. Course Materials

Transform educational content into readable eBook format:

```csharp
using (var converter = new Converter("lecture-slides.pptx"))
{
    var options = new EBookConvertOptions
    {
        Format = EBookFileType.Azw3,
        PageNumber = 1,
        PagesCount = 50
    };
    converter.Convert("course-material.azw3", options);
}
```

## When to Use EBookConvertOptions

Use EBookConvertOptions when you need to:

- **Publish content** for e-readers and mobile reading apps
- **Create portable versions** of documents optimized for reading devices
- **Distribute documentation** in universally accessible eBook formats
- **Convert between eBook formats** (EPUB to MOBI, etc.)
- **Customize page layout** for specific e-reader dimensions
- **Extract portions** of documents as standalone eBooks
- **Optimize reading experience** with proper orientation and sizing

## Best Practices

1. **Choose the right format**:
   - Use EPUB for maximum compatibility
   - Use MOBI for legacy Kindle support
   - Use AZW3 for modern Kindle devices

2. **Set appropriate page dimensions**:
   - Standard eBook (6"×9"): 432×648 points
   - Tablet readers (8"×10.67"): 576×768 points
   - Custom dimensions for specific devices (1 point = 1/72 inch)

3. **Consider orientation**:
   - Portrait for text-heavy content
   - Landscape for image-heavy or technical content

4. **Optimize source documents**:
   - Use clear heading structures
   - Ensure proper table of contents
   - Optimize images for eBook display

## Summary

EBookConvertOptions provides comprehensive control over eBook conversions:

- **Three formats**: EPUB, MOBI, and AZW3 support
- **Page customization**: Control size, orientation, and dimensions
- **Selective conversion**: Convert specific pages or page ranges
- **Wide compatibility**: Convert from numerous source formats
- **Reading optimization**: Tailor output for specific devices and use cases

All examples on this page have been verified through automated testing to ensure accuracy.

## See Also

- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})
- [EBookConvertOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ebookconvertoptions/)
- [EBookFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/ebookfiletype/)

---

## Generate Bullet Lists from Data Source

Path: /assembly/net/basic-usage-generate-bullet-lists/


## Overview

Bullet lists are a common way to display collections of items in documents. GroupDocs.Assembly for .NET makes it easy to generate bulleted lists by iterating over data collections using foreach data bands within list structures.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources

Here are the steps to generate bullet lists:

* Create a bullet list in your template document
* Add a foreach data band within the list to iterate over your collection
* Reference collection item properties in list items
* Close the foreach data band
* Assemble the document with your collection data

{{< alert style="info" >}}
The foreach data band automatically repeats list items for each element in the collection, creating a complete bulleted list with all data items.
{{< /alert >}}

## Generate Bullet List from .NET Collection

Create a bullet list from a list of objects:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Product
{
    public string Name { get; set; }
    public string Description { get; set; }
}

public static void GenerateBulletList()
{
    // Create sample data
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Description = "High-performance laptop" },
        new Product { Name = "Mouse", Description = "Wireless mouse" },
        new Product { Name = "Keyboard", Description = "Mechanical keyboard" }
    };
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("BulletListTemplate.docx", "BulletListOutput.docx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Bullet list generated successfully.");
}
```

## Template Structure for Bullet Lists

In your template document (BulletListTemplate.docx), create a bullet list with this structure:

```
We provide the following products:

<<foreach [in products]>>
• <<[Name]>> - <<[Description]>>
<</foreach>>
```

After assembly, you'll get:

```
We provide the following products:

• Laptop - High-performance laptop
• Mouse - Wireless mouse
• Keyboard - Mechanical keyboard
```

## Generate Bullet List from DataTable

You can also generate bullet lists from ADO.NET DataTable:

```csharp
using GroupDocs.Assembly;
using System.Data;

public static void GenerateBulletListFromDataTable()
{
    // Create DataTable
    DataTable productsTable = new DataTable("Products");
    productsTable.Columns.Add("Name", typeof(string));
    productsTable.Columns.Add("Description", typeof(string));
    
    // Add rows
    productsTable.Rows.Add("Laptop", "High-performance laptop");
    productsTable.Rows.Add("Mouse", "Wireless mouse");
    productsTable.Rows.Add("Keyboard", "Mechanical keyboard");
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("BulletListTemplate.docx", "BulletListOutput.docx", 
        new DataSourceInfo(productsTable, "products"));
    
    Console.WriteLine("Bullet list generated from DataTable successfully.");
}
```

## Simple Bullet List (Name Only)

For simple lists showing only names:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateSimpleBulletList()
{
    List<string> items = new List<string> 
    { 
        "Item 1", 
        "Item 2", 
        "Item 3" 
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("SimpleBulletListTemplate.docx", "SimpleBulletListOutput.docx", 
        new DataSourceInfo(items, "items"));
    
    Console.WriteLine("Simple bullet list generated successfully.");
}
```

Template for simple list:

```
Items:
<<foreach [in items]>>
• <<[items_Text]>>
<</foreach>>
```

## Bullet List in Spreadsheet

Bullet lists work in spreadsheet templates too:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateBulletListInSpreadsheet()
{
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Description = "High-performance laptop" },
        new Product { Name = "Mouse", Description = "Wireless mouse" }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("BulletListTemplate.xlsx", "BulletListOutput.xlsx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Bullet list generated in spreadsheet successfully.");
}
```

## Bullet List in Email

Generate bullet lists in email messages:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateBulletListInEmail()
{
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Description = "High-performance laptop" },
        new Product { Name = "Mouse", Description = "Wireless mouse" }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("BulletListTemplate.msg", "BulletListOutput.msg", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Bullet list generated in email successfully.");
}
```

{{< alert style="warning" >}}
In Word documents, ensure the bullet list formatting is applied in the template. The foreach data band will repeat the list item format for each collection element.
{{< /alert >}}

### Advanced Usage Topics

To learn more about nested bullet lists, conditional list items, and advanced list formatting, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Generating page preview for WordProcessing document

Path: /editor/java/generating-page-preview/

Starting from the [version 23.9](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-9-release-notes/) the GroupDocs.Editor for Java allows to generate a preview for arbitrary page in the loaded WordProcessing document, like DOC, DOCX, DOCM, RTF, ODT etc. The preview is generated in the SVG format, which is a vector graphics format and is supported in the numerous image viewers and also by any modern browser.

Using this feature the users can view and inspect any document of the imported WordProcessing document without actually editing it. This preview cannot be edited by the GroupDocs.Editor itself, it can be only obtained in SVG format and saved as usual - to the byte stream or file.

This feature is working regardless of the licensing mode of the GroupDocs.Editor for Java: it works the same for both trial and licensed mode, there are no trial limitations for this feature. While generating the pages preview, the GroupDocs.Editor doesn’t write off the consumed bytes or credits.

With this feature was introduced, the GroupDocs.Editor for Java finally supports generating a preview for all three major office format families: WordProcessing, [Spreadsheet](https://docs.groupdocs.com/editor/java/generating-worksheets-preview-for-spreadsheet/) and [Presentation](https://docs.groupdocs.com/editor/java/generating-slides-preview-for-presentation/).

For generating the pages preview for a particular WordProcessing document the user must perform the next steps:

- Load a desired WordProcesing file to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/) class.
- Call the [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method and specify a password for the loaded document in case if this document is protected with a password.
- Because the loaded file has a format from the WordProcessing family (like DOCX, RTF, etc), then the [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method must return the instance of the [`com.groupdocs.editor.metadata.WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo/) struct, casted to the [`IDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/) interface. Cast it back from [`IDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/) to the [`WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo/) type.
- In the obtained struct [`WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo/) invoke a new instance method [`generatePreview(int pageIndex)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo/#generatePreview-int-) and in this method specify a zero-based _index_ (do not confuse with the page _numbers_, which are 1-based) of the desired page. If the specified index is lesser than 0 or exceeds the number of pages within a given document, then the [IllegalArgumentException](https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html) exception will be thrown.
- The [`generatePreview(int pageIndex)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo/#generatePreview-int-) method returns a page preview as an SVG vector image, that is encapsulated in the [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) public class from the [`com.groupdocs.editor.htmlcss.resources.images.vector`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/) namespace. This class has all necessary methods and properties to obtain the content of an SVG image in any desired form, save it to disk, stream and so on.

The code sample below shows opening an unprotected WordProcessing DOCX file, obtaining a number of all pages inside this DOCX file, and then generating the previews for every page in a loop. Then these previews are saved to the disk. Please note that the GroupDocs.Editor is working in the trial mode, but page preview is generated for all the pages, and no trial copyright marks are present on these previews.

```java
// Obtain a valid full path to the WordProcessing file
String inputPath = "SampleDoc.docx";

// Load WordProcessing file to the Editor constructor
Editor editor = new Editor(inputPath);
{
	// Get document info for this file
	IDocumentInfo infoUncasted = editor.getDocumentInfo(null);

	//Make sure it is really a WordProcessing of DOCX format
	Assert.assertEquals(WordProcessingFormats.Docx, infoUncasted.getFormat());

	// Cast this document info to the WordProcessingDocumentInfo type
	WordProcessingDocumentInfo infoWordProcessing = (WordProcessingDocumentInfo)infoUncasted;

	// Get the number of all pages
	int pagesCount = infoWordProcessing.getPageCount();	

	//Iterate through all pages and generate the preview on every iteration
	for (int pageIndex = 0; pageIndex < pagesCount; pageIndex++)
	{
		// Generate one preview as SVG image by page index
		SvgImage oneSvgPreview = infoWordProcessing.generatePreview(pageIndex);

		// Save SVG preview to the file
		oneSvgPreview.save("outputFolder" + oneSvgPreview.getFilenameWithExtension());
	}
}
```

All WordProcessing formats are able to store the raster images. So when the specific page of some loaded document has one or more raster images, and for this page the SVG preview is generated, this/these raster image(s) will be embedded inside SVG in base64 format using the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme).

Concluding, the new page preview feature is by its essence a new public method in the existing [`WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/wordprocessingdocumentinfo/) struct, that obtains a page index and returns an instance of [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class. If the end-user needs to obtain a preview of the page in a raster format, but not in the vector, he can use the [`saveToPng()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/#saveToPng-java.io.OutputStream-) method in the [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class — this method converts the SVG content of the current [`SvgImage`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/svgimage/) to the PNG format and saves it to the specified [`java.io.OutputStream`](https://docs.oracle.com/javase/8/docs/api/java/io/OutputStream.html).
---

## Generating page preview for WordProcessing document

Path: /editor/net/generating-page-preview/

Starting from the [version 23.5](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-5-release-notes/) the GroupDocs.Editor for .NET allows to generate a preview for arbitrary page in the loaded WordProcessing document, like DOC, DOCX, DOCM, RTF, ODT etc. The preview is generated in the SVG format, which is a vector graphics format and is supported in the numerous image viewers and also by any modern browser.

Using this feature the users can view and inspect any document of the imported WordProcessing document without actually editing it. This preview cannot be edited by the GroupDocs.Editor itself, it can be only obtained in SVG format and saved as usual - to the byte stream or file.

This feature is working regardless of the licensing mode of the GroupDocs.Editor for .NET: it works the same for both trial and licensed mode, there are no trial limitations for this feature. While generating the pages preview, the GroupDocs.Editor doesn’t write off the consumed bytes or credits.

With this feature was introduced, the GroupDocs.Editor for .NET finally supports generating a preview for all three major office format families: WordProcessing, [Spreadsheet](https://docs.groupdocs.com/editor/net/generating-worksheets-preview-for-spreadsheet/) and [Presentation](https://docs.groupdocs.com/editor/net/generating-slides-preview-for-presentation/).

For generating the pages preview for a particular WordProcessing document the user must perform the next steps:

- Load a desired WordProcesing file to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/) class.
- Call the [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo/) method and specify a password for the loaded document in case if this document is protected with a password.
- Because the loaded file has a format from the WordProcessing family (like DOCX, RTF, etc), then the [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo/) method must return the instance of the [`GroupDocs.Editor.Metadata.WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo/) struct, casted to the [`IDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/) interface. Cast it back from [`IDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/) to the [`WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo/) type.
- In the obtained struct [`WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo/) invoke a new instance method [`GeneratePreview(int pageIndex)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo/generatepreview/) and in this method specify a zero-based _index_ (do not confuse with the page _numbers_, which are 1-based) of the desired page. If the specified index is lesser than 0 or exceeds the number of pages within a given document, then the [System.ArgumentOutOfRangeException](https://learn.microsoft.com/en-us/dotnet/api/system.ArgumentOutOfRangeException?view=net-7.0) exception will be thrown.
- The [`GeneratePreview(int pageIndex)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo/generatepreview/) method returns a page preview as an SVG vector image, that is encapsulated in the [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) public class from the [`GroupDocs.Editor.HtmlCss.Resources.Images.Vector`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/) namespace. This class has all necessary methods and properties to obtain the content of an SVG image in any desired form, save it to disk, stream and so on.

The code sample below shows opening an unprotected WordProcessing DOCX file, obtaining a number of all pages inside this DOCX file, and then generating the previews for every page in a loop. Then these previews are saved to the disk. Please note that the GroupDocs.Editor is working in the trial mode, but page preview is generated for all the pages, and no trial copyright marks are present on these previews.

```csharp
// Obtain a valid full path to the WordProcessing file
string inputPath = "SampleDoc.docx";

// Load WordProcessing file to the Editor constructor
using (GroupDocs.Editor.Editor editor = new Editor(inputPath))
{
	// Get document info for this file
	IDocumentInfo infoUncasted = editor.GetDocumentInfo(null);

	//Make sure it is really a WordProcessing of DOCX format
	Assert.AreEqual(Formats.WordProcessingFormats.Docx, infoUncasted.Format);

	// Cast this document info to the WordProcessingDocumentInfo type
	WordProcessingDocumentInfo infoWordProcessing = (WordProcessingDocumentInfo)infoUncasted;

	// Get the number of all pages
	int pagesCount = infoWordProcessing.PageCount;	

	//Iterate through all pages and generate the preview on every iteration
	for (int pageIndex = 0; pageIndex < pagesCount; pageIndex++)
	{
		// Generate one preview as SVG image by page index
		SvgImage oneSvgPreview = infoWordProcessing.GeneratePreview(pageIndex);

		// Save SVG preview to the file
		oneSvgPreview.Save(Path.Combine(outputFolder, oneSvgPreview.FilenameWithExtension));
	}
}
```

All WordProcessing formats are able to store the raster images. So when the specific page of some loaded document has one or more raster images, and for this page the SVG preview is generated, this/these raster image(s) will be embedded inside SVG in base64 format using the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme).

Concluding, the new page preview feature is by its essence a new public method in the existing [`WordProcessingDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/wordprocessingdocumentinfo/) struct, that obtains a page index and returns an instance of [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class. If the end-user needs to obtain a preview of the page in a raster format, but not in the vector, he can use the [`SaveToPng`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/savetopng/) method in the [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) class — this method converts the SVG content of the current [`SvgImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector/svgimage/) to the PNG format and saves it to the specified [`System.IO.Stream`](https://learn.microsoft.com/en-us/dotnet/api/system.IO.Stream?view=net-6.0).
---

## Generating Page Preview for WordProcessing Documents

Path: /editor/nodejs-java/generating-page-preview/


Starting from [version 23.9](https://docs.groupdocs.com/editor/nodejs-java/groupdocs-editor-for-node-js-via-java-23-9-release-notes/), GroupDocs.Editor for Node.js via Java allows you to generate a preview for any page of a loaded WordProcessing document, such as DOC, DOCX, DOCM, RTF, ODT, and more. The preview is generated in SVG format, a vector graphics format supported by numerous image viewers and modern browsers.

This feature enables users to view and inspect any page of the imported WordProcessing document without actually editing it. The generated preview cannot be edited by GroupDocs.Editor itself; it can only be obtained in SVG format and saved as needed—to a byte stream or file.

This feature works regardless of the licensing mode of GroupDocs.Editor for Node.js via Java: it functions the same for both trial and licensed modes, and there are no trial limitations for this feature. While generating page previews, GroupDocs.Editor doesn’t consume any credits or impose any limitations.

With this addition, GroupDocs.Editor for Node.js via Java now supports generating previews for all three major office format families: WordProcessing, [Spreadsheet](https://docs.groupdocs.com/editor/nodejs-java/generating-worksheets-preview-for-spreadsheet/), and [Presentation](https://docs.groupdocs.com/editor/nodejs-java/generating-slides-preview-for-presentation/).

## Steps to Generate Page Previews

To generate page previews for a particular WordProcessing document, follow these steps:

1. **Load the WordProcessing File:**
   Load the desired WordProcessing file into the `Editor` class.

2. **Retrieve Document Information:**
   Call the `getDocumentInfo()` method. If the document is password-protected, specify the password.

3. **Cast to WordProcessingDocumentInfo:**
   Since the loaded file is a WordProcessing document (like DOCX, RTF, etc.), the `getDocumentInfo()` method returns an instance of the `WordProcessingDocumentInfo` class. Cast the returned `IDocumentInfo` to `WordProcessingDocumentInfo`.

4. **Generate Page Preview:**
   Use the `generatePreview(pageIndex)` method on the `WordProcessingDocumentInfo` instance, specifying a zero-based page index. If the index is out of range, an exception will be thrown.

5. **Save or Use the SVG Preview:**
   The `generatePreview(pageIndex)` method returns a page preview as an SVG image, encapsulated in the `SvgImage` class. Use the methods provided by this class to obtain the SVG content, save it to disk, stream it, etc.

## Code Sample

The following code sample demonstrates how to open an unprotected WordProcessing DOCX file, obtain the total number of pages, generate previews for each page, and save these previews to disk. Note that even in trial mode, GroupDocs.Editor generates previews for all pages without any trial watermarks.

```javascript
// Import necessary modules
const fs = require('fs');
const groupdocs_editor = require('groupdocs-editor');

// Obtain a valid full path to the WordProcessing file
const inputPath = "SampleDoc.docx";

// Load the WordProcessing file into the Editor
const editor = new groupdocs_editor.Editor(inputPath);

// Get document info for this file
const infoUncasted = editor.getDocumentInfo();

// Ensure it is a WordProcessing document (e.g., DOCX format)
if (infoUncasted.getFormat() === groupdocs_editor.WordProcessingFormats.Docx) {

    // Cast document info to WordProcessingDocumentInfo type
    const infoWordProcessing = infoUncasted;

    // Get the number of pages
    const pagesCount = infoWordProcessing.getPageCount();

    // Iterate through all pages and generate a preview for each
    for (let pageIndex = 0; pageIndex < pagesCount; pageIndex++) {

        // Generate one preview as an SVG image by page index
        const oneSvgPreview = infoWordProcessing.generatePreview(pageIndex);

        // Save the SVG preview to a file
        const outputFilePath = `outputFolder/Page_${pageIndex + 1}.svg`;
        fs.writeFileSync(outputFilePath, oneSvgPreview.getContent());

        console.log(`Page ${pageIndex + 1} preview saved to ${outputFilePath}`);
    }
} else {
    console.error("The provided document is not a WordProcessing format.");
}
```

**Note:** Make sure to replace `"SampleDoc.docx"` with the actual path to your WordProcessing document and `"outputFolder"` with the desired output directory.

## Handling Raster Images in Previews

WordProcessing formats can contain raster images. When generating an SVG preview for a page that includes raster images, these images are embedded inside the SVG using base64 encoding via the [data URI scheme](https://en.wikipedia.org/wiki/Data_URI_scheme).

## Converting SVG to PNG

If you need the page preview in a raster format instead of SVG, you can convert the SVG to PNG using the `saveToPng()` method available in the `SvgImage` class. This method converts the SVG content to PNG format and saves it to the specified output stream.

```javascript
// Continue from the previous code sample

// Generate one preview as an SVG image by page index
const oneSvgPreview = infoWordProcessing.generatePreview(pageIndex);

// Save the SVG preview as a PNG image
const pngOutputFilePath = `outputFolder/Page_${pageIndex + 1}.png`;
const pngStream = fs.createWriteStream(pngOutputFilePath);
oneSvgPreview.saveToPng(pngStream);
pngStream.end();

console.log(`Page ${pageIndex + 1} preview saved as PNG to ${pngOutputFilePath}`);
```

## Conclusion

The new page preview feature adds a valuable capability to GroupDocs.Editor for Node.js via Java, allowing you to generate and utilize previews of individual pages within WordProcessing documents. This can be particularly useful for applications that require document thumbnails, page-specific views, or any scenario where a visual representation of the document's pages is needed without loading the entire document into an editor.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.
---

## Load finance document with options

Path: /conversion/net/load-finance-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [FinanceLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/financeloadoptions) to control how source finance documents are processed. Finance documents include XBRL (eXtensible Business Reporting Language) and iXBRL (inline XBRL) files used for financial reporting.

The following options are available:

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/financeloadoptions/format)** | The document type is auto-detected during loading, but you can explicitly specify the source format. Available options are: *Xbrl, IXbrl* |

## Load XBRL document

The following code snippet shows how to load an XBRL document with explicit format specification:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new FinanceLoadOptions
{
    Format = FinanceFileType.Xbrl
};

using (Converter converter = new Converter("financial-report.xbrl", getLoadOptions))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
    converter.Convert("financial-report.xlsx", options);
}
```

## Load iXBRL document

The following code snippet shows how to load an iXBRL (inline XBRL) document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new FinanceLoadOptions
{
    Format = FinanceFileType.IXbrl
};

using (Converter converter = new Converter("financial-statement.ixbrl", getLoadOptions))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
    converter.Convert("financial-statement.xlsx", options);
}
```

## Convert finance document to CSV

The following code snippet shows how to load an XBRL document and convert it to CSV format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new FinanceLoadOptions
{
    Format = FinanceFileType.Xbrl
};

using (Converter converter = new Converter("quarterly-report.xbrl", getLoadOptions))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions
    {
        Format = SpreadsheetFileType.Csv
    };
    converter.Convert("quarterly-report.csv", options);
}
```

## Convert between finance formats

The following code snippet shows how to convert from iXBRL to XBRL:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new FinanceLoadOptions
{
    Format = FinanceFileType.IXbrl
};

using (Converter converter = new Converter("annual-report.ixbrl", getLoadOptions))
{
    FinanceConvertOptions options = new FinanceConvertOptions
    {
        Format = FinanceFileType.Xbrl
    };
    converter.Convert("annual-report.xbrl", options);
}
```

---

## Logging

Path: /search/java/logging/

This page contains information on creating and assigning a logger of an index, as well as on the implementation of a custom logger.

## Use of standard file logger

In order to save information about events and errors in an index into a file, you should use the standard file logger or your own custom logger. It is important to remember that each time you open an existing index, you must create and assign an instance of the logger again, because the logger is not saved. The good news is that the same code can be used to create a new index and open an existing one. In this case, when opening an existing index, a logger will be used from the index settings passed to the constructor, the remaining index settings will be loaded from disk.

The following example demonstrates the use of the standard file logger. The constructor parameters of this logger are the path to the log file and its maximum size in MB.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
String query = "Einstein";
String logPath = "c:\\Log.txt";
 
IndexSettings settings = new IndexSettings();
settings.setLogger(new FileLogger(logPath, 4.0)); // Specifying the path to the log file and a maximum length of 4 MB
 
Index index = new Index(indexFolder, settings); // Creating or loading an index from the specified folder
 
index.add(documentsFolder); // Indexing documents from the specified folder
 
SearchResult result = index.search(query); // Search in the index
```

## Implementing custom logger

Sometimes you may need to implement your own logger, for example, to display the log in the console. An example implementation of such a logger is presented below.



```java
public class ConsoleLogger implements ILogger {
    public ConsoleLogger() {
    }
 
    public void error(String message) {
        System.out.println("Error: " + message);
    }
 
    public void trace(String message) {
        System.out.println(message);
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Logging

Path: /search/net/logging/

This page contains information on creating and assigning a logger of an index, as well as on the implementation of a custom logger.

## Use of standard file logger

In order to save information about events and errors in an index into a file, you should use the standard file logger or your own custom logger. It is important to remember that each time you open an existing index, you must create and assign an instance of the logger again, because the logger is not saved. The good news is that the same code can be used to create a new index and open an existing one. In this case, when opening an existing index, a logger will be used from the index settings passed to the constructor, the remaining index settings will be loaded from disk.

The following example demonstrates the use of the standard file logger. The constructor parameters of this logger are the path to the log file and its maximum size in MB.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
string query = "Einstein";
string logPath = @"c:\Log.txt";
 
IndexSettings settings = new IndexSettings();
settings.Logger = new FileLogger(logPath, 4.0); // Specifying the path to the log file and a maximum length of 4 MB
 
Index index = new Index(indexFolder, settings); // Creating or loading an index from the specified folder
 
index.Add(documentsFolder); // Indexing documents from the specified folder
 
SearchResult result = index.Search(query); // Search in index
```

## Implementing custom logger

Sometimes you may need to implement your own logger, for example, to display the log in the console. An example implementation of such a logger is presented below.

**C#**

```csharp
public class ConsoleLogger : ILogger
{
    public ConsoleLogger()
    {
    }
 
    public void Error(string message)
    {
        Console.WriteLine("Error: " + message);
    }
 
    public void Trace(string message)
    {
        Console.WriteLine(message);
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Logging

Path: /search/nodejs-java/logging/

This page contains information on creating and assigning a logger of an index, as well as on the implementation of a custom logger.

## Use of standard file logger

In order to save information about events and errors in an index into a file, you should use the standard file logger or your own custom logger. It is important to remember that each time you open an existing index, you must create and assign an instance of the logger again, because the logger is not saved. The good news is that the same code can be used to create a new index and open an existing one. In this case, when opening an existing index, a logger will be used from the index settings passed to the constructor, the remaining index settings will be loaded from disk.

The following example demonstrates the use of the standard file logger. The constructor parameters of this logger are the path to the log file and its maximum size in MB.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';
const query = 'Einstein';
const logPath = 'c:/Log.txt';

const settings = new groupdocs.search.IndexSettings();
settings.setLogger(new groupdocs.search.FileLogger(logPath, 4.0)); // Specifying the path to the log file and a maximum length of 4 MB

const index = new groupdocs.search.Index(indexFolder, settings); // Creating or loading an index from the specified folder

index.add(documentsFolder); // Indexing documents from the specified folder

const result = index.search(query); // Search in index
```

## Implementing custom logger

Sometimes you may need to implement your own logger, for example, to display the log in the console. An example implementation of such a logger is presented below.

```javascript
// Implementing a custom console logger
const consoleLogger = java.newProxy('com.groupdocs.search.common.ILogger', {
  error: function (message) {
    console.log('Error: ' + message);
  },
  trace: function (message) {
    console.log(message);
  },
});

settings.setLogger(consoleLogger); // Setting the custom logger
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Query language specification

Path: /search/java/query-language-specification/

The text below represents the complete specification of the search query DSL (Domain Specific Language) used in text queries. See also [Search operation table]({{< ref "search/java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}), [Search flow]({{< ref "search/java/developer-guide/advanced-usage/searching/search-flow.md" >}}).

*query*:

*   *regex-query*
*   *non-regex-query*

*regex-query*:

*   ^*pattern*

*non-regex-query*:

*   *unary-query*
*   *binary-query*

*unary-query*:

*   *word*
*   *word-pattern* (since v.18.12)
*   *phrase-query*
*   *field-name-query*
*   *numeric-range-query*
*   *date-range-query*
*   *parenthesized-query*
*   *not-query*

*phrase-query*:

*   *phrase-item-list*

*phrase-item-list*:

*   *phrase-item phrase-item*
*   *phrase-item-list phrase-item*

*phrase-item*:

*   *word*
*   *word-pattern* (since v.18.12)
*   *wildcard* (since v.18.1)

*word*:

*   any word without special characters

*word-pattern* (since v.18.12)

*   any non-special characters
*   ? (question marks)
*   ?(n\~m) (Wildcard groups, where n is *byte-number*, m is *byte-number*, and n <= m. For example: ?(1~2) )

*wildcard*: (since v.18.1)

*   \* *byte-number*
*   \* *byte-number* ~~ *byte-number*

*byte-number*: (since v.18.1)

*   Any integer number in the range from 0 to 255

*field-name-query*:

*   *field-name*: *unary-query*

*numeric-range-query*:

*   *number* ~~ *number*

*number*:

*   Any non-negative integer number

*date-range-query*:

*   daterange( *date* ~~ *date* )

*date*:

*   A date in the format \'yyyy-MM-dd\'. For example: 2019-09-16

*parenthesized-query*:

*   ( *non-regex-query* )

*not-query*:

*   ! *unary-query*
*   NOT *unary-query*

*binary-query*:

*   *and-query*
*   *or-query*

*and-query*:

*   *non-regex-query* & *unary-query*
*   *non-regex-query* AND *unary-query*

*or-query*:

*   *non-regex-query* | *unary-query*
*   *non-regex-query* || *unary-query*
*   *non-regex-query* OR *unary-query*

*escape-sequence:* (since v.19.2)

*   \\*N*  
    where *N* is one of  
    *( ) : \" & | ! ^ ~ \* ? \\*  
    or  
    *s* (for space character)
*   \\u*hhhh*  
    where *h* is hexadecimal digit (for any Unicode character)

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Query language specification

Path: /search/net/query-language-specification/

The text below represents the complete specification of the search query DSL (Domain Specific Language) used in text queries. See also [Search operation table]({{< ref "search/net/developer-guide/advanced-usage/searching/search-operation-table.md" >}}), [Search flow]({{< ref "search/net/developer-guide/advanced-usage/searching/search-flow.md" >}}).

*query*:

*   *regex-query*
*   *non-regex-query*

*regex-query*:

*   ^*pattern*

*non-regex-query*:

*   *unary-query*
*   *binary-query*

*unary-query*:

*   *word*
*   *word-pattern* (since v.18.12)
*   *phrase-query*
*   *field-name-query*
*   *numeric-range-query*
*   *date-range-query*
*   *parenthesized-query*
*   *not-query*

*phrase-query*:

*   *phrase-item-list*

*phrase-item-list*:

*   *phrase-item phrase-item*
*   *phrase-item-list phrase-item*

*phrase-item*:

*   *word*
*   *word-pattern* (since v.18.12)
*   *wildcard* (since v.18.1)

*word*:

*   any word without special characters

*word-pattern* (since v.18.12)

*   any non-special characters
*   ? (question marks)
*   ?(n\~m) (Wildcard groups, where n is *byte-number*, m is *byte-number*, and n <= m. For example: ?(1~2) )

*wildcard*: (since v.18.1)

*   \* *byte-number*
*   \* *byte-number* ~~ *byte-number*

*byte-number*: (since v.18.1)

*   Any integer number in the range from 0 to 255

*field-name-query*:

*   *field-name*: *unary-query*

*numeric-range-query*:

*   *number* ~~ *number*

*number*:

*   Any non-negative integer number

*date-range-query*:

*   daterange( *date* ~~ *date* )

*date*:

*   A date in the format \'yyyy-MM-dd\'. For example: 2019-09-16

*parenthesized-query*:

*   ( *non-regex-query* )

*not-query*:

*   ! *unary-query*
*   NOT *unary-query*

*binary-query*:

*   *and-query*
*   *or-query*

*and-query*:

*   *non-regex-query* & *unary-query*
*   *non-regex-query* AND *unary-query*

*or-query*:

*   *non-regex-query* | *unary-query*
*   *non-regex-query* || *unary-query*
*   *non-regex-query* OR *unary-query*

*escape-sequence:* (since v.19.2)

*   \\*N*  
    where *N* is one of  
    *( ) : \" & | ! ^ ~ \* ? \\*  
    or  
    *s* (for space character)
*   \\u*hhhh*  
    where *h* is hexadecimal digit (for any Unicode character)

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Query language specification

Path: /search/nodejs-java/query-language-specification/

The text below represents the complete specification of the search query DSL (Domain Specific Language) used in text queries. See also [Search operation table]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}), [Search flow]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-flow.md" >}}).

*query*:

*   *regex-query*
*   *non-regex-query*

*regex-query*:

*   ^*pattern*

*non-regex-query*:

*   *unary-query*
*   *binary-query*

*unary-query*:

*   *word*
*   *word-pattern* (since v.18.12)
*   *phrase-query*
*   *field-name-query*
*   *numeric-range-query*
*   *date-range-query*
*   *parenthesized-query*
*   *not-query*

*phrase-query*:

*   *phrase-item-list*

*phrase-item-list*:

*   *phrase-item phrase-item*
*   *phrase-item-list phrase-item*

*phrase-item*:

*   *word*
*   *word-pattern* (since v.18.12)
*   *wildcard* (since v.18.1)

*word*:

*   any word without special characters

*word-pattern* (since v.18.12)

*   any non-special characters
*   ? (question marks)
*   ?(n\~m) (Wildcard groups, where n is *byte-number*, m is *byte-number*, and n <= m. For example: ?(1~2) )

*wildcard*: (since v.18.1)

*   \* *byte-number*
*   \* *byte-number* ~~ *byte-number*

*byte-number*: (since v.18.1)

*   Any integer number in the range from 0 to 255

*field-name-query*:

*   *field-name*: *unary-query*

*numeric-range-query*:

*   *number* ~~ *number*

*number*:

*   Any non-negative integer number

*date-range-query*:

*   daterange( *date* ~~ *date* )

*date*:

*   A date in the format \'yyyy-MM-dd\'. For example: 2019-09-16

*parenthesized-query*:

*   ( *non-regex-query* )

*not-query*:

*   ! *unary-query*
*   NOT *unary-query*

*binary-query*:

*   *and-query*
*   *or-query*

*and-query*:

*   *non-regex-query* & *unary-query*
*   *non-regex-query* AND *unary-query*

*or-query*:

*   *non-regex-query* | *unary-query*
*   *non-regex-query* || *unary-query*
*   *non-regex-query* OR *unary-query*

*escape-sequence:* (since v.19.2)

*   \\*N*  
    where *N* is one of  
    *( ) : \" & | ! ^ ~ \* ? \\*  
    or  
    *s* (for space character)
*   \\u*hhhh*  
    where *h* is hexadecimal digit (for any Unicode character)

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Render Outlook data files as HTML, PDF, and image files

Path: /viewer/net/render-outlook-data-files/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render Microsoft Outlook data files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of OST and PST files within your .NET application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/outlook" >}} {{< icon "gdoc_person" >}} View Outlook files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Supported Outlook data file formats

GroupDocs.Viewer supports the following Outlook data file formats:

* [Outlook Offline Storage Table](https://docs.fileformat.com/email/ost) (.OST)
* [Outlook Personal Storage Table](https://docs.fileformat.com/email/pst) (.PST)

GroupDocs.Viewer can detect the document format automatically based on information in the file header.

## Render Outlook data files as HTML

To convert an OST or PST file to HTML, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to HTML](/viewer/net/images/rendering-basics/render-outlook-files/render-pst-to-html.png)

## Render Outlook data files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an OST or PST file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Create a PDF file.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Create a PDF file.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PDF](/viewer/net/images/rendering-basics/render-outlook-files/render-pst-to-pdf.png)

## Render Outlook data files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an OST or PST file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Convert the PST file to PNG.
    // {0} is replaced with the page numbers in the output image names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Convert the PST file to PNG.
            ' {0} is replaced with the page numbers in the output image names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render a PST file to PNG](/viewer/net/images/rendering-basics/render-outlook-files/render-pst-to-png.png)

## Render Outlook data files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an OST or PST file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Convert the PST file to JPEG.
    // {0} is replaced with the page numbers in the output image names.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    // Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 900;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Convert the PST file to JPEG.
            ' {0} is replaced with the page numbers in the output image names.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            ' Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 900
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Get information about folders in an Outlook data file

Follow the steps below to obtain information about folders contained in an Outlook data file.

1. Create a [ViewInfoOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/viewinfooptions) instance for a specific view.
2. Call the [Viewer.GetViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer/viewer/methods/getviewinfo) method, pass the `ViewInfoOptions` instance to this method as a parameter, and cast the returned object to the [OutlookViewInfo](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.results/outlookviewinfo) type.
3. Use the [OutlookViewInfo.Folders](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.results/outlookviewinfo/properties/folders) property to obtain the list of folders in the Outlook data file.

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
using GroupDocs.Viewer.Results;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Create an HTML file.
    var viewInfoOptions = ViewInfoOptions.ForHtmlView();
    var viewInfo = viewer.GetViewInfo(viewInfoOptions) as OutlookViewInfo;

    if (viewInfo != null)
    {
        // Display information about the PST file.
        Console.WriteLine($"File type: {viewInfo.FileType}");
        Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}");

        // Display the list of folders that the PST file contains.
        Console.WriteLine("The file contains the following folders:");
        foreach (string folder in viewInfo.Folders)
            Console.WriteLine(folder);
    }
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
Imports GroupDocs.Viewer.Results
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Create an HTML file.
            Dim viewInfoOptions = ViewInfoOptions.ForHtmlView()
            Dim viewInfo = TryCast(viewer.GetViewInfo(viewInfoOptions), OutlookViewInfo)
        
            If viewInfo IsNot Nothing Then
                ' Display information about the PST file.
                Console.WriteLine($"File type: {viewInfo.FileType}")
                Console.WriteLine($"The number of pages: {viewInfo.Pages.Count}")
        
                ' Display the list of folders that the PST file contains.
                Console.WriteLine("The file contains the following folders:")
                For Each folder As String In viewInfo.Folders
                    Console.WriteLine(folder)
                Next
            End If
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [OutlookOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/outlookoptions) class that allows you to specify different options for rendering Outlook data files. To access these options, use the [OutlookOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/properties/outlookoptions) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

### Render a specific folder

When you convert an OST or PST file to HTML, PDF, or image format, GroupDocs.Viewer renders messages from all folders contained in the file (including nested folders). If you want to render items from a specific folder, set the [OutlookOptions.Folder](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/outlookoptions/properties/folder) property for a target view. Specify the folder name as follows: `{Parent folder name}\\{Subfolder name}`.


{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Render messages from the "Inbox" folder and its subfolders.
    viewOptions.OutlookOptions.Folder = "Inbox";
    // Render messages from a specific subfolder in the "Inbox" folder.
    // viewOptions.OutlookOptions.Folder = "Inbox\\Work\\Urgent";
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
            ' Render messages from the "Inbox" folder and its subfolders.
            viewOptions.OutlookOptions.Folder = "Inbox"
            ' Render messages from a specific subfolder in the "Inbox" folder.
            ' viewOptions.OutlookOptions.Folder = "Inbox\\Work\\Urgent";
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Limit the number of folder items to render

When you load large Outlook data files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [OutlookOptions.MaxItemsInFolder](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/outlookoptions/properties/maxitemsinfolder) property to limit the number of rendered items (messages, contacts, or tasks) in each folder. The default property value is **50**. Set this property to **0** to render all existing items. 

The following example demonstrates how to specify the maximum number of folder items to render:

{{< tabs "example7">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Specify the maximum number of folder items.
    viewOptions.OutlookOptions.MaxItemsInFolder = 30;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
            ' Specify the maximum number of folder items.
            viewOptions.OutlookOptions.MaxItemsInFolder = 30
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Filter messages

Microsoft Outlook allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in Microsoft Outlook](/viewer/net/images/rendering-basics/render-outlook-files/filter-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering an Outlook data file to HTML, PDF, or image format. To do this, use the following properties:

* [OutlookOptions.TextFilter](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/outlookoptions/properties/textfilter)---Allows you to render all messages that contain specific text in the subject or body.
* [OutlookOptions.AddressFilter](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/outlookoptions/properties/addressfilter)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in a PST file before rendering this file to HTML:

{{< tabs "example8">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.pst"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Set filters.
    viewOptions.OutlookOptions.TextFilter = "Viewer";
    viewOptions.OutlookOptions.AddressFilter = "groupdocs.com";
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.pst")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
            ' Set filters.
            viewOptions.OutlookOptions.TextFilter = "Viewer"
            viewOptions.OutlookOptions.AddressFilter = "groupdocs.com"
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Set shape color independently of font color

Path: /comparison/net/set-shape-color-independently-of-font-color/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) provides the option to specify the color for changed shapes.

To compare two documents with custom change color for shapes, follow these steps:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
2.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object. Specify the [ShapeColor](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/stylesettings/shapecolor/) for the [InsertedItemStyle](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/inserteditemstyle/)/[DeletedItemStyle](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/deleteditemstyle/)/[ChangedItemStyle](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/changeditemstyle/) parameters.
4. Set [MarkChangedContent](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/markchangedcontent) to true.
5.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/compareoptions) object.

The following code snippets show how to compare documents with specific color options for shapes:

## Compare documents from local disk with custom change color for shapes

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");
    CompareOptions compareOptions = new CompareOptions()
    {
        DetectStyleChanges = true,
        MarkChangedContent = true,
        InsertedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Blue,
            ShapeColor = System.Drawing.Color.Purple
        },
        DeletedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Red,
            ShapeColor = System.Drawing.Color.Orange
        },
        ChangedItemStyle = new StyleSettings()
        {
            FontColor = System.Drawing.Color.Green,
            ShapeColor = System.Drawing.Color.LightGreen
        }
    }
    comparer.Compare("result.docx", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/set-shape-color-independently-of-font-color.png)

---

## Set shape color independently of font color

Path: /comparison/python-net/set-shape-color-independently-of-font-color/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) lets you control colors for shapes separately from font colors.

## Set shape color for detected changes

Enable style detection and specify separate shape colors per change type.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.detect_style_changes = True
    options.mark_changed_content = True
    options.inserted_item_style = gc.StyleSettings(
        font_color=gc.Color.from_name("blue"),
        shape_color=gc.Color.from_name("purple"),
    )
    options.deleted_item_style = gc.StyleSettings(
        font_color=gc.Color.from_name("red"),
        shape_color=gc.Color.from_name("orange"),
    )
    options.changed_item_style = gc.StyleSettings(
        font_color=gc.Color.from_name("green"),
        shape_color=gc.Color.from_name("lightgreen"),
    )
    comparer.compare("result.docx", options)
```

🔹 Use case: Emphasize shape modifications (e.g., diagrams) without altering text color coding.


The result is as follows:

![](/comparison/python-net/images/set-shape-color-independently-of-font-color.png)

---

## Setting author of changes

Path: /comparison/java/setting-author-of-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java) allows you to set author of changes name in the resulting document. To do this, follow these steps:
1. Instantiate the [Comparer](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer) object. Specify a source file path or an input stream.
2. Call the [add](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#add-java.lang.String-) method. Specify a target file path or an input stream.
3. Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object. Set the [WordTrackChanges](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setWordTrackChanges-boolean-) and [ShowRevisions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setShowRevisions-boolean-) properties to `true`.
4. Set author of changes by changing the [RevisionAuthorName](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions/#setRevisionAuthorName-java.lang.String-) property.
5. Call the [compare](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison/comparer/#compare-java.lang.String-) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/compareoptions) object from previous step.

The following code snippet shows how to change author of changes:

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
// ...

try (Comparer comparer = new Comparer("source.docx")) {
    comparer.add("target.docx");

    CompareOptions compareOptions = new CompareOptions();
    compareOptions.setShowRevisions(true);
    compareOptions.setWordTrackChanges(true);
    compareOptions.setRevisionAuthorName("New author");

    comparer.compare(resultPath, compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

 ![Change author](/comparison/java/images/set-new-author-of-changes-example.png)



---

## Setting author of changes

Path: /comparison/net/setting-author-of-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to set author of changes name in the resulting document. To do this, follow these steps:
1. Instantiate the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify a source file path or an input stream.
2. Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/add/index) method. Specify a target file path or an input stream.
3. Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. Set the [WordTrackChanges](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/wordtrackchanges) and [ShowRevisions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/showrevisions/) properties to `true`.
4. Set author of changes by changing the [RevisionAuthorName](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/revisionauthorname) property.
5. Call the [Compare](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object from previous step.

The following code snippet shows how to change author of changes:

{{< tabs "example1">}}
{{< tab ".NET" >}}
```cs
using (Comparer comparer = new Comparer("source.docx"))
{
  comparer.Add("target.docx");

  CompareOptions options = new CompareOptions()
  {
    ShowRevisions = true,
    WordTrackChanges = true,
    RevisionAuthorName = "New author",
  };

  comparer.Compare("result.docx", options);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

 ![Change author](/comparison/net/images/set-new-author-of-changes-example.png)



---

## Setting author of changes

Path: /comparison/nodejs-java/setting-author-of-changes/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/nodejs-java) allows you to set the changes author name in the resulting document.

The following code snippet shows how to set the changes author:

```javascript
'use strict';

// Import the GroupDocs Comparison Node.js SDK
const groupdocs = require('@groupdocs/groupdocs.comparison');

// Define file paths for source, target, and result documents
const sourcePath = 'sample-files/source.docx';
const targetPath = 'sample-files/target.docx';
const resultPath = 'result.docx';

// Initialize the comparer with the source document
const comparer = new groupdocs.Comparer(sourcePath);

// Add the target document to the comparison set
comparer.add(targetPath);

// Create comparison options to customize the output
const compareOptions = new groupdocs.CompareOptions();

// Enable revision tracking and set author information
compareOptions.setShowRevisions(true);               // show changes as revisions
compareOptions.setWordTrackChanges(true);           // generate Word track changes
compareOptions.setRevisionAuthorName('New author'); // author name for revisions

// Execute the comparison and save the result to the specified path
comparer.compare(resultPath, compareOptions);

// Terminate the process with a success exit code
process.exit(0);
```

This example creates a `Comparer` instance with the source document, adds the target document, and creates a `CompareOptions` object. It enables revision tracking by setting both `setShowRevisions(true)` and `setWordTrackChanges(true)`, then sets the author name for revisions using `setRevisionAuthorName('New author')`. When the comparison is performed, all changes will be marked as revisions with the specified author name in the result document.

The result is as follows:

 ![Changes author](/comparison/nodejs-java/images/set-new-author-of-changes-example.png)



---

## Setting author of changes

Path: /comparison/python-net/setting-author-of-changes/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) allows you to set the revision author name for changes in the result.

## Set revision author name

Enable revisions, track Word changes, and set the author name to appear in the result.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    options = gc.CompareOptions()
    options.show_revisions = True
    options.word_track_changes = True
    options.revision_author_name = "New author"
    comparer.compare("result.docx", options)
```

🔹 Use case: Attribute changes to a specific reviewer or automated system in audit trails.

The result is as follows:

 ![Change author](/comparison/net/images/set-new-author-of-changes-example.png)

---

## Sign document with analysis of the Sign process result

Path: /signature/java/sign-document-with-result-analysis/

[**com.groupdocs.signature**](https://products.groupdocs.com/signature/java) provides the each method result as the implementation of the [IResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/iresult/) interface which contains the process metrics.

Here are the steps to analyze the process result with com.groupdocs.signature:

* Create a new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/) class and pass the source document path as a constructor parameter.
* Instantiate the [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/signoptions/) object with the required options and set the ZOrder property.
* Call [sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/#sign-java.lang.String-com.groupdocs.signature.options.sign.SignOptions-) method of  [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/signoptions/) to it.
* Analyze [SignResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/) response of the [sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/#sign-java.lang.String-com.groupdocs.signature.options.sign.SignOptions-) method.


## Sign document with result analysis

This example shows how to analize sign process result.

```java
public static void Run()
{
    Signature signature = new Signature("sample.pdf");
    {
        // create QRCode option with predefined QRCode text
        QrCodeSignOptions options = new QrCodeSignOptions("JohnSmith");

        // sign document to file
        SignResult signResult = signature.sign("output.pdf", options);

        // analyze SignResult (IResult properties)
        System.out.print("Sign-process was executed for "+signResult.getProcessingTime()+" mls");
        System.out.print("Input document size "+signResult.getSourceDocumentSize()+" bytes");
        System.out.print("Output document size "+signResult.getDestinDocumentSize()+" bytes");
        System.out.print("Total processed signatures "+signResult.getTotalSignatures());
        if (signResult.getFailed().size() == 0)
        {
            System.out.print("\nAll signatures were successfully created!");
        }
        else
        {
            System.out.print("Successfully created signatures : "+signResult.getSucceeded().size());
            System.out.print("Failed signatures : "+signResult.getFailed().size());
        }
        System.out.print("\nList of newly created signatures:");
        int number = 1;
        for (BaseSignature temp : signResult.getSucceeded())
        {
            System.out.print("Signature #"+ +number++ +": Type: "+temp.getSignatureType()+" Id:"+temp.getSignatureId()+", Location: "+temp.getLeft()+"x"+temp.getTop()+". Size: "+temp.getWidth()+"x"+temp.getHeight());
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Convert to Email with advanced options

Path: /conversion/net/convert-to-email-with-advanced-options/


## Introduction

GroupDocs.Conversion provides [EmailConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/emailconvertoptions) for converting between email formats. **Important**: EmailConvertOptions is specifically for email-to-email format conversions (e.g., MSG to EML), not for converting general documents to email formats.

## Properties

| Property | Type | Description |
|----------|------|-------------|
| [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) | `EmailFileType` | Specifies the desired email format. Available options are: *Eml, Emlx, Msg, Vcf, Mbox, Pst, Ost, Olm* |
| [AttachmentContentHandler](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/emailconvertoptions/attachmentcontenthandler) | `Delegate` | A delegate to handle custom processing of email attachments during conversion |

## Basic Usage

Convert MSG files to EML format with default options:

```csharp
using (var converter = new Converter("message.msg"))
{
    var options = new EmailConvertOptions();
    converter.Convert("message.eml", options);
}
```

## Converting Between Email Formats

### Convert MSG to EML

The most common email format conversion - from Outlook MSG to standard EML:

```csharp
using (var converter = new Converter("newsletter.msg"))
{
    var options = new EmailConvertOptions
    {
        Format = EmailFileType.Eml
    };
    converter.Convert("newsletter.eml", options);
}
```

### Convert MSG to EMLX

Convert Outlook messages to Apple Mail format:

```csharp
using (var converter = new Converter("meeting-invite.msg"))
{
    var options = new EmailConvertOptions
    {
        Format = EmailFileType.Emlx
    };
    converter.Convert("meeting-invite.emlx", options);
}
```

### Convert EML to MSG

Convert standard EML files to Outlook MSG format:

```csharp
using (var converter = new Converter("customer-inquiry.eml"))
{
    var options = new EmailConvertOptions
    {
        Format = EmailFileType.Msg
    };
    converter.Convert("customer-inquiry.msg", options);
}
```

## Supported Email Formats

EmailConvertOptions works with the following email formats:

- **EML** - RFC-822 standard email format (most email clients)
- **EMLX** - Apple Mail email format (macOS Mail app)
- **MSG** - Microsoft Outlook and Exchange format
- **VCF** - Virtual Card Format (contact information)
- **MBOX** - Container format for email collections
- **PST** - Outlook Personal Storage Files
- **OST** - Outlook Offline Storage Files
- **OLM** - Microsoft Outlook for macOS format

**Note**: Not all format combinations are supported. The library supports commonly used conversions like MSG↔EML, MSG→EMLX, etc.

## Email Format Details

### MSG (Microsoft Outlook Message)

MSG is the proprietary format used by Microsoft Outlook:
- **Advantages**: Preserves Outlook-specific formatting, supports rich metadata
- **Platform**: Windows Outlook, Exchange Server
- **Use Case**: Enterprise email systems, Outlook integration

### EML (Electronic Mail Format)

EML is the standard RFC-822 email format:
- **Advantages**: Universal compatibility, plain text based
- **Platform**: Cross-platform (Thunderbird, Windows Mail, macOS Mail, webmail)
- **Use Case**: Email archival, cross-platform compatibility, email backups

### EMLX (Apple Mail Format)

EMLX is Apple's implementation of the EML standard:
- **Advantages**: Optimized for macOS Mail, includes additional metadata
- **Platform**: macOS Mail application
- **Use Case**: Mac-specific email workflows, Apple ecosystem integration

## Common Use Cases

### 1. Email Migration

Migrate email archives between different email clients:

```csharp
// Convert Outlook MSG archive to standard EML for cross-platform use
using (var converter = new Converter("archive-2024.msg"))
{
    var options = new EmailConvertOptions
    {
        Format = EmailFileType.Eml
    };
    converter.Convert("archive-2024.eml", options);
}
```

### 2. Platform Migration

Move from Windows Outlook to macOS Mail:

```csharp
// Convert MSG emails to EMLX for Apple Mail
using (var converter = new Converter("important-emails.msg"))
{
    var options = new EmailConvertOptions
    {
        Format = EmailFileType.Emlx
    };
    converter.Convert("important-emails.emlx", options);
}
```

### 3. Email Standardization

Convert proprietary formats to standards-based formats:

```csharp
// Standardize various email formats to EML
using (var converter = new Converter("meeting-notes.msg"))
{
    var options = new EmailConvertOptions
    {
        Format = EmailFileType.Eml
    };
    converter.Convert("meeting-notes.eml", options);
}
```

### 4. Email Client Compatibility

Ensure emails can be opened in different email clients:

```csharp
// Convert EML to MSG for Outlook users
using (var converter = new Converter("customer-feedback.eml"))
{
    var options = new EmailConvertOptions
    {
        Format = EmailFileType.Msg
    };
    converter.Convert("customer-feedback.msg", options);
}
```

## When to Use EmailConvertOptions

Use EmailConvertOptions when you need to:

- **Migrate email systems** between different platforms (Outlook ↔ Apple Mail ↔ Thunderbird)
- **Archive emails** in standard formats for long-term storage
- **Ensure compatibility** across different email clients
- **Convert between formats** for workflow integration
- **Standardize email formats** within an organization
- **Support multi-platform** email access

## Limitations

### Email-to-Email Only

EmailConvertOptions is **not** for converting general documents to email formats:

```csharp
// ❌ This will NOT work - cannot convert PDF to email format
using (var converter = new Converter("document.pdf"))
{
    var options = new EmailConvertOptions { Format = EmailFileType.Msg };
    converter.Convert("document.msg", options); // ConversionNotSupportedException
}
```

### Supported Source Formats

EmailConvertOptions works with:
- Email formats converting to other email formats
- Some format combinations may not be supported (e.g., MSG to MBOX)

## Converting Emails to Other Formats

To convert email messages to documents (PDF, DOCX, etc.), use the appropriate ConvertOptions for the target format:

```csharp
// ✅ Convert email to PDF
using (var converter = new Converter("message.msg"))
{
    var options = new PdfConvertOptions();
    converter.Convert("message.pdf", options);
}

// ✅ Convert email to Word document
using (var converter = new Converter("newsletter.eml"))
{
    var options = new WordProcessingConvertOptions();
    converter.Convert("newsletter.docx", options);
}
```

## Best Practices

1. **Choose the right target format**:
   - Use EML for maximum cross-platform compatibility
   - Use MSG for Outlook-specific workflows
   - Use EMLX for macOS Mail integration

2. **Test format combinations**:
   - Not all email-to-email conversions are supported
   - Verify your specific conversion path works before batch processing

3. **Preserve email structure**:
   - Email formats preserve headers, attachments, and metadata differently
   - Test conversions to ensure critical information is retained

4. **Handle attachments appropriately**:
   - Email attachments are typically preserved during format conversion
   - Use AttachmentContentHandler for custom attachment processing needs

## Summary

EmailConvertOptions provides control over email format conversions:

- **Email-to-Email conversions**: Convert between MSG, EML, EMLX, and other email formats
- **Platform migration**: Move emails between different email clients and platforms
- **Format standardization**: Convert proprietary formats to standards-based formats
- **Important limitation**: Cannot convert general documents to email formats

All examples on this page have been verified through automated testing to ensure accuracy.

## See Also

- [Convert Email Formats - Basic Usage]({{< ref "conversion/net/developer-guide/basic-usage/convert/email" >}})
- [Load Email Documents with Options]({{< ref "conversion/net/developer-guide/advanced-usage/loading/load-options-for-different-document-types/load-email-document-with-options" >}})
- [Convert Email Attachments]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-each-email-attachment-to-different-format" >}})
- [EmailConvertOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/emailconvertoptions/)
- [EmailFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/emailfiletype/)

---

## Convert to Project Management formats with advanced options

Path: /conversion/net/convert-to-project-management-with-advanced-options/


GroupDocs.Conversion provides the [ProjectManagementConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/projectmanagementconvertoptions) class to specify Project Management file format conversion settings.

## Supported Project Management Formats

The following project management formats are supported:

| Format | Extension | Description | Application |
|--------|-----------|-------------|-------------|
| **MPP** | .mpp | Microsoft Project binary format | Microsoft Project |
| **MPT** | .mpt | Microsoft Project template | Microsoft Project |
| **MPX** | .mpx | Microsoft Project Exchange (ASCII format) | Microsoft Project & Primavera |
| **XER** | .xer | Primavera P6 format | Primavera P6 |

## Properties

**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired project management file format. Available options are: *Mpp, Mpt, Mpx, Xer*.

## Conversion Examples

ProjectManagementConvertOptions supports conversion between project management formats. The following examples demonstrate common conversions.

### MPP to MPX

Convert a Microsoft Project binary file (MPP) to MPX (Project Exchange Format):

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "construction-plan.mpp";
string outputFile = "construction-plan.mpx";

using (var converter = new Converter(sourceFile))
{
    var options = new ProjectManagementConvertOptions
    {
        Format = ProjectManagementFileType.Mpx
    };
    converter.Convert(outputFile, options);
}
```

### XER (Primavera) to MPX

Convert a Primavera P6 file (XER) to Microsoft Project Exchange format (MPX):

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "engineering-project.xer";
string outputFile = "engineering-project.mpx";

using (var converter = new Converter(sourceFile))
{
    var options = new ProjectManagementConvertOptions
    {
        Format = ProjectManagementFileType.Mpx
    };
    converter.Convert(outputFile, options);
}
```

## Format Support Notes

Project Management to Project Management conversions are supported for select format combinations:
- MPP → MPX, XER
- MPT → MPX, XER
- MPX → MPP, XER (some restrictions apply)
- XER → MPX, MPP

**Note:** To convert FROM Project Management formats to PDF or images, use [PdfConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-pdf-with-advanced-options.md" >}}) or [ImageConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-image-with-advanced-options.md" >}}).

## More Resources

- [API Reference: ProjectManagementConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/projectmanagementconvertoptions)
- [API Reference: ProjectManagementFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/projectmanagementfiletype)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})

---

## Generate Numbered Lists from Data Source

Path: /assembly/net/basic-usage-generate-numbered-lists/


## Overview

Numbered lists provide a sequential, ordered way to display collections of items in documents. GroupDocs.Assembly for .NET enables you to generate numbered lists by iterating over data collections using foreach data bands within numbered list structures.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources

Here are the steps to generate numbered lists:

* Create a numbered list in your template document
* Add a foreach data band within the list to iterate over your collection
* Reference collection item properties in list items
* Optionally use NumberOf() to display item numbers
* Close the foreach data band
* Assemble the document with your collection data

{{< alert style="info" >}}
The foreach data band automatically repeats numbered list items for each element in the collection, maintaining proper numbering sequence.
{{< /alert >}}

## Generate Numbered List from .NET Collection

Create a numbered list from a list of objects:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Task
{
    public string Title { get; set; }
    public string Description { get; set; }
}

public static void GenerateNumberedList()
{
    // Create sample data
    List<Task> tasks = new List<Task>
    {
        new Task { Title = "Design", Description = "Create design mockups" },
        new Task { Title = "Develop", Description = "Implement features" },
        new Task { Title = "Test", Description = "Perform testing" }
    };
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("NumberedListTemplate.docx", "NumberedListOutput.docx", 
        new DataSourceInfo(tasks, "tasks"));
    
    Console.WriteLine("Numbered list generated successfully.");
}
```

## Template Structure for Numbered Lists

In your template document (NumberedListTemplate.docx), create a numbered list:

```
Tasks to complete:

<<foreach [in tasks]>>
<<[Title]>> - <<[Description]>>
<</foreach>>
```

After assembly, you'll get:

```
Tasks to complete:

1. Design - Create design mockups
2. Develop - Implement features
3. Test - Perform testing
```

## Using NumberOf() Function

You can explicitly display item numbers using the NumberOf() function:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateNumberedListWithNumber()
{
    List<string> items = new List<string> 
    { 
        "First item", 
        "Second item", 
        "Third item" 
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("NumberedListTemplate.docx", "NumberedListOutput.docx", 
        new DataSourceInfo(items, "items"));
    
    Console.WriteLine("Numbered list with explicit numbers generated successfully.");
}
```

Template with NumberOf():

```
Items:
<<foreach [in items]>>
<<[NumberOf()]>>. <<[items_Text]>>
<</foreach>>
```

## Generate Numbered List from DataTable

Generate numbered lists from ADO.NET DataTable:

```csharp
using GroupDocs.Assembly;
using System.Data;

public static void GenerateNumberedListFromDataTable()
{
    // Create DataTable
    DataTable tasksTable = new DataTable("Tasks");
    tasksTable.Columns.Add("Title", typeof(string));
    tasksTable.Columns.Add("Description", typeof(string));
    
    // Add rows
    tasksTable.Rows.Add("Design", "Create design mockups");
    tasksTable.Rows.Add("Develop", "Implement features");
    tasksTable.Rows.Add("Test", "Perform testing");
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("NumberedListTemplate.docx", "NumberedListOutput.docx", 
        new DataSourceInfo(tasksTable, "tasks"));
    
    Console.WriteLine("Numbered list generated from DataTable successfully.");
}
```

## Numbered List in Spreadsheet

For spreadsheet templates, you can create numbered lists in cells:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateNumberedListInSpreadsheet()
{
    List<Task> tasks = new List<Task>
    {
        new Task { Title = "Design", Description = "Create design mockups" },
        new Task { Title = "Develop", Description = "Implement features" }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("NumberedListTemplate.xlsx", "NumberedListOutput.xlsx", 
        new DataSourceInfo(tasks, "tasks"));
    
    Console.WriteLine("Numbered list generated in spreadsheet successfully.");
}
```

Template for spreadsheet (in-cell):

```
"We provide support for the following products:<<foreach [in products]>>
<<[NumberOf()]>>. <<[ProductName]>><</foreach>>"
```

## Numbered List in Email

Generate numbered lists in email messages:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateNumberedListInEmail()
{
    List<Task> tasks = new List<Task>
    {
        new Task { Title = "Design", Description = "Create design mockups" },
        new Task { Title = "Develop", Description = "Implement features" }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("NumberedListTemplate.msg", "NumberedListOutput.msg", 
        new DataSourceInfo(tasks, "tasks"));
    
    Console.WriteLine("Numbered list generated in email successfully.");
}
```

{{< alert style="warning" >}}
In Word documents, ensure the numbered list formatting is applied in the template. The foreach data band will repeat the list item format and maintain proper numbering for each collection element.
{{< /alert >}}

### Advanced Usage Topics

To learn more about custom numbering formats, nested numbered lists, and advanced list formatting options, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Load GIS document with options

Path: /conversion/net/load-gis-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [GisLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/gisloadoptions) to control how source GIS (Geographic Information System) documents are processed. GIS documents include formats like GeoJSON, KML, GPX, and other geospatial data files.

The following options are available:

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/gisloadoptions/format)** | The document type is auto-detected during loading, but you can explicitly specify the source format. Available options include: *GeoJson, Gpx, Kml, Osm, TopoJson, Gml* |
|**[Width](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/gisloadoptions/width)** | Sets the desired page width (in pixels) for rendering the GIS document. Default value is 1000. |
|**[Height](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/gisloadoptions/height)** | Sets the desired page height (in pixels) for rendering the GIS document. Default value is 1000. |

## Load GeoJSON document

The following code snippet shows how to load a GeoJSON document with explicit format specification:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new GisLoadOptions
{
    Format = GisFileType.GeoJson
};

using (Converter converter = new Converter("map-data.geojson", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("map-data.pdf", options);
}
```

## Load GPX document

The following code snippet shows how to load a GPX (GPS Exchange Format) document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new GisLoadOptions
{
    Format = GisFileType.Gpx
};

using (Converter converter = new Converter("route-tracking.gpx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("route-tracking.pdf", options);
}
```

## Load GIS document with custom dimensions

The following code snippet shows how to load a GeoJSON document and set custom rendering dimensions:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new GisLoadOptions
{
    Format = GisFileType.GeoJson,
    Width = 1500,
    Height = 1200
};

using (Converter converter = new Converter("city-boundaries.geojson", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("city-boundaries.pdf", options);
}
```

## Convert GIS document to image

The following code snippet shows how to load a GeoJSON document and convert it to an image with custom dimensions:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new GisLoadOptions
{
    Format = GisFileType.GeoJson,
    Width = 800,
    Height = 600
};

using (Converter converter = new Converter("region-map.geojson", getLoadOptions))
{
    ImageConvertOptions options = new ImageConvertOptions
    {
        Format = ImageFileType.Png
    };
    converter.Convert("region-map.png", options);
}
```

## Convert between GIS formats

The following code snippet shows how to convert from GPX to KML format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new GisLoadOptions
{
    Format = GisFileType.Gpx
};

using (Converter converter = new Converter("hiking-trail.gpx", getLoadOptions))
{
    GisConvertOptions options = new GisConvertOptions
    {
        Format = GisFileType.Kml
    };
    converter.Convert("hiking-trail.kml", options);
}
```

---

## Merge indexes

Path: /search/java/merge-indexes/

The merge operation is designed to combine two or more indexes into one index to accelerate the search and to simplify the work with indexes. When merging, only the index at which the [merge](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#merge(com.groupdocs.search.Index,%20com.groupdocs.search.options.MergeOptions)) method was called is changed. This index as a result of the operation contains all the documents that were contained in all indexes together. The second index or index repository after the merge can be deleted to free up disk space.

The [MergeOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MergeOptions) class contains a method for specifying a cancellation object, as well as a method for specifying whether the operation will be performed asynchronously. By default, index merging operation is performed synchronously.

The [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class has method overloads for merging a single index and a whole index repository. Before performing a merge, checks are made to ensure that the indexes are of the same type. Merging is performed only on those indexes that have the same [IndexType](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexType) value as the index on which the [merge](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#merge(com.groupdocs.search.Index,%20com.groupdocs.search.options.MergeOptions)) method is called.

The following example demonstrates the merging of two indexes.

```java
String indexFolder1 = "c:\\MyIndex1\\";
String indexFolder2 = "c:\\MyIndex2\\";
String documentsFolder1 = "c:\\MyDocuments1\\";
String documentsFolder2 = "c:\\MyDocuments2\\";
 
Index index1 = new Index(indexFolder1); // Creating index1
index1.add(documentsFolder1); // Indexing documents
 
Index index2 = new Index(indexFolder2); // Creating index2
index2.add(documentsFolder2); // Indexing documents
 
MergeOptions options = new MergeOptions();
options.setCancellation(new Cancellation()); // Creating cancellation object to be able to cancel the oparation
 
// Merging index2 into index1
// Files of index2 will not be changed
index1.merge(index2, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge indexes

Path: /search/net/merge-indexes/

The merge operation is designed to combine two or more indexes into one index to accelerate the search and to simplify the work with indexes. When merging, only the index at which the [Merge](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/merge/index) method was called is changed. This index as a result of the operation contains all the documents that were contained in all indexes together. The second index or index repository after the merge can be deleted to free up disk space.

The [MergeOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/mergeoptions) class contains a property for specifying a cancellation object, as well as a property for specifying whether the operation will be performed asynchronously. By default, index merging operation is performed synchronously.

The [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class has method overloads for merging a single index and a whole index repository. Before performing a merge, checks are made to ensure that the indexes are of the same type. Merging is performed only on those indexes that have the same [IndexType](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/indextype) value as the index on which the [Merge](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/merge/index) method is called.

The following example demonstrates the merging of two indexes.

**C#**

```csharp
string indexFolder1 = @"c:\MyIndex1\";
string indexFolder2 = @"c:\MyIndex2\";
string documentsFolder1 = @"c:\MyDocuments1\";
string documentsFolder2 = @"c:\MyDocuments2\";
 
Index index1 = new Index(indexFolder1); // Creating index1
index1.Add(documentsFolder1); // Indexing documents
 
Index index2 = new Index(indexFolder2); // Creating index2
index2.Add(documentsFolder2); // Indexing documents
 
MergeOptions options = new MergeOptions();
options.Cancellation = new Cancellation(); // Creating cancellation object to be able to cancel the oparation
 
// Merging index2 into index1
// Files of index2 will not be changed
index1.Merge(index2, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge indexes

Path: /search/nodejs-java/merge-indexes/

The merge operation is designed to combine two or more indexes into one index to accelerate the search and to simplify the work with indexes. When merging, only the index at which the [merge](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#merge(com.groupdocs.search.Index,%20com.groupdocs.search.options.MergeOptions)) method was called is changed. This index as a result of the operation contains all the documents that were contained in all indexes together. The second index or index repository after the merge can be deleted to free up disk space.

The [MergeOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MergeOptions) class contains a method for specifying a cancellation object, as well as a method for specifying whether the operation will be performed asynchronously. By default, index merging operation is performed synchronously.

The [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class has method overloads for merging a single index and a whole index repository. Before performing a merge, checks are made to ensure that the indexes are of the same type. Merging is performed only on those indexes that have the same [IndexType](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexType) value as the index on which the [merge](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#merge(com.groupdocs.search.Index,%20com.groupdocs.search.options.MergeOptions)) method is called.

The following example demonstrates the merging of two indexes.

```javascript
const indexFolder1 = 'c:/MyIndex1/';
const indexFolder2 = 'c:/MyIndex2/';
const documentsFolder1 = 'c:/MyDocuments1/';
const documentsFolder2 = 'c:/MyDocuments2/';

const index1 = new groupdocs.search.Index(indexFolder1); // Creating index1
index1.add(documentsFolder1); // Indexing documents

const index2 = new groupdocs.search.Index(indexFolder2); // Creating index2
index2.add(documentsFolder2); // Indexing documents

const options = new groupdocs.search.MergeOptions();
options.setCancellation(new groupdocs.search.Cancellation()); // Creating cancellation object to be able to cancel the oparation
options.getCancellation().cancelAfter(5000); // Setting a time limit for the operation of 5 seconds

// Merging index2 into index1
// Files of index2 will not be changed
index1.merge(index2, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Regular expression search

Path: /search/java/regular-expression-search/

Regular expression (RegEx) search queries are universal and very flexible, but at the same time, in large indexes, their performance becomes extremely low. Another limitation of regular expressions is that search with a pattern is done for each word separately, and not the entire text of a document field.

Queries of this type always starts with the caret character, and if the regular expression itself also starts with the caret character, then there will be two caret characters at the beginning of the query.

A regex search query in text form cannot be combined with other types of queries. See the [Query language specification]({{< ref "search/java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}) page. However, in object form, regular expressions can be combined with other queries. See the [Nesting search queries in object form]({{< ref "search/java/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}) page.

The following example demonstrates the regex search in text and object forms.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search for the phrase in text form
String query1 = "^^(.)\\1{1,}"; // The first caret character at the beginning indicates that this is a regular expression search query
SearchResult result1 = index.search(query1); // Search for two or more identical characters at the beginning of a word
 
// Search for the phrase in object form
SearchQuery query2 = SearchQuery.createRegexQuery("^(.)\\1{1,}"); // Search for two or more identical characters at the beginning of a word
SearchResult result2 = index.search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Regular expression search

Path: /search/net/regular-expression-search/

Regular expression (RegEx) search queries are universal and very flexible, but at the same time, in large indexes, their performance becomes extremely low. Another limitation of regular expressions is that search with a pattern is done for each word separately, and not the entire text of a document field.

Queries of this type always starts with the caret character, and if the regular expression itself also starts with the caret character, then there will be two caret characters at the beginning of the query.

A regex search query in text form cannot be combined with other types of queries. See the  [Query language specification]({{< ref "search/net/developer-guide/advanced-usage/searching/query-language-specification.md" >}}) page. However, in object form, regular expressions can be combined with other queries. See the [Nesting search queries in object form]({{< ref "search/net/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}) page.

The following example demonstrates the regex search in text and object forms.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search for the phrase in text form
string query1 = "^^(.)\\1{1,}"; // The first caret character at the beginning indicates that this is a regular expression search query
SearchResult result1 = index.Search(query1); // Search for two or more identical characters at the beginning of a word
 
// Search for the phrase in object form
SearchQuery query2 = SearchQuery.CreateRegexQuery("^(.)\\1{1,}"); // Search for two or more identical characters at the beginning of a word
SearchResult result2 = index.Search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Regular expression search

Path: /search/nodejs-java/regular-expression-search/

Regular expression (RegEx) search queries are universal and very flexible, but at the same time, in large indexes, their performance becomes extremely low. Another limitation of regular expressions is that search with a pattern is done for each word separately, and not the entire text of a document field.

Queries of this type always starts with the caret character, and if the regular expression itself also starts with the caret character, then there will be two caret characters at the beginning of the query.

A regex search query in text form cannot be combined with other types of queries. See the [Query language specification]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}) page. However, in object form, regular expressions can be combined with other queries. See the [Nesting search queries in object form]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/nesting-search-queries-in-object-form.md" >}}) page.

The following example demonstrates the regex search in text and object forms.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search for the phrase in text form
const query1 = '^^(.)\\1{1,}'; // The first caret character at the beginning indicates that this is a regular expression search query
const result1 = index.search(query1); // Search for two or more identical characters at the beginning of a word

// Search for the phrase in object form
const query2 = groupdocs.search.SearchQuery.createRegexQuery('^(.)\\1{1,}'); // Search for two or more identical characters at the beginning of a word
const result2 = index.search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Render Lotus Notes database files as HTML, PDF, and image files

Path: /viewer/net/render-lotus-notes-database-files/

[GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) allows you to render [Lotus Notes Storage Facility (NSF)](https://docs.fileformat.com/database/nsf/) files in HTML, PDF, PNG, and JPEG formats. Use this library to display the contents of NSF files within your .NET application (web or desktop). 

To start with the GroupDocs.Viewer API, create a [Viewer](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer) class instance. Pass a document you want to view to the class constructor. You can load the document from a file or stream. Call one of the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method overloads to convert the document to HTML, PDF, or image format. These methods allow you to render the entire document or specific pages.

{{< button style="primary" link="https://products.groupdocs.app/viewer/nsf" >}} {{< icon "gdoc_person" >}} View NSF files online {{< /button >}} {{< button style="primary" link="https://github.com/groupdocs-viewer/GroupDocs.Viewer-for-.NET" >}} {{< icon "gdoc_github" >}} View demos and examples on GitHub {{< /button >}}

## Render Lotus Notes database files as HTML

To convert an NSF file to HTML, call the [HtmlViewOptions.ForEmbeddedResources](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions/methods/forembeddedresources/index) method to create an [HtmlViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/htmlviewoptions) class instance and pass this instance to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method.

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.nsf"))
{
   // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.nsf")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources("output.html")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to HTML](/viewer/net/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-html.png)

## Render Lotus Notes database files as PDF

Create a [PdfViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pdfviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an NSF file to PDF. The `PdfViewOptions` class properties allow you to control the conversion process. For instance, you can protect the output PDF file, reorder its pages, and specify the quality of document images. Refer to the following documentation section for details: [Rendering to PDF]({{< ref "viewer/net/developer-guide/rendering-documents/rendering-to-pdf/_index.md" >}}).

{{< tabs "example2">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.nsf"))
{
    // Create a PDF file.
    var viewOptions = new PdfViewOptions("output.pdf");
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.nsf")
            ' Create a PDF file.
            Dim viewOptions = New PdfViewOptions("output.pdf")
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PDF](/viewer/net/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-pdf.png)

## Render Lotus Notes database files as PNG

Create a [PngViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an NSF file to PNG. Use the [PngViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/height) and [PngViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/pngviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example3">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.nsf"))
{
    // Convert the NSF file to PNG.
    // {0} is replaced with the page numbers in the output image names.
    var viewOptions = new PngViewOptions("output_{0}.png");
    //  Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.nsf")
            ' Convert the NSF file to PNG.
            ' {0} is replaced with the page numbers in the output image names.
            Dim viewOptions = New PngViewOptions("output_{0}.png")
            '  Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

The following image demonstrates the result:

![Render an NSF file to PNG](/viewer/net/images/rendering-basics/render-lotus-notes-data-files/render-nsf-to-png.png)

## Render Lotus Notes database files as JPEG

Create a [JpgViewOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions) class instance and pass it to the [Viewer.View](https://reference.groupdocs.com/viewer/net/groupdocs.viewer/viewer/methods/view/index) method to convert an NSF file to JPEG. Use the [JpgViewOptions.Height](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/height) and [JpgViewOptions.Width](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/jpgviewoptions/properties/width) properties to specify the output image size in pixels.

{{< tabs "example4">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.nsf"))
{
    // Convert the NSF file to JPEG.
    // {0} is replaced with the page numbers in the output image names.
    var viewOptions = new JpgViewOptions("output_{0}.jpg");
    //  Set width and height.
    viewOptions.Width = 800;
    viewOptions.Height = 1000;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.nsf")
            ' Convert the NSF file to JPEG.
            ' {0} is replaced with the page numbers in the output image names.
            Dim viewOptions = New JpgViewOptions("output_{0}.jpg")
            '  Set width and height.
            viewOptions.Width = 800
            viewOptions.Height = 1000
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

## Specify rendering options

GroupDocs.Viewer supports the [MailStorageOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/mailstorageoptions/) class that allows you to specify different options for rendering Lotus Notes database files. To access these options, use the [MailStorageOptions](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/baseviewoptions/mailstorageoptions/) property for one of the following classes (depending on the output file format):

* [HtmlViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/htmlviewoptions) 
* [PdfViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pdfviewoptions)
* [PngViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/pngviewoptions)
* [JpgViewOptions](https://reference.groupdocs.com/net/viewer/groupdocs.viewer.options/jpgviewoptions)

### Limit the number of items to render

When you load large Lotus Notes database files, it may take a significant amount of time to retrieve and render file contents. To improve rendering performance, use the [MailStorageOptions.MaxItems](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/mailstorageoptions/maxitems/) property to limit the number of rendered items. The default property value is **0** (all existing items appear in the output file). 

The following example demonstrates how to specify the maximum number of items to render:

{{< tabs "example5">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.nsf"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Specify the maximum items to render.
    viewOptions.MailStorageOptions.MaxItems = 20;
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.nsf")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
            ' Specify the maximum items to render.
            viewOptions.MailStorageOptions.MaxItems = 20
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

### Filter messages

IBM Notes allows you to filter messages by specific words in the message body or by part of the sender's or recipient's address.

![Filter messages in IBM Notes](/viewer/net/images/rendering-basics/render-lotus-notes-data-files/filter-nsf-messages.png)

With GroupDocs.Viewer, you can also filter messages before rendering a Lotus Notes database file to HTML, PDF, or image format. To do this, use the following properties:

* [MailStorageOptions.TextFilter](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/mailstorageoptions/textfilter/)---Allows you to render all messages that contain specific text in the subject or body.
* [MailStorageOptions.AddressFilter](https://reference.groupdocs.com/viewer/net/groupdocs.viewer.options/mailstorageoptions/addressfilter/)---Allows you to render all messages that contain specific text in the sender's or recipient's address.

The following code sample filters messages in an NSF file before rendering this file to HTML:

{{< tabs "example6">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (var viewer = new Viewer("sample.nsf"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();
    // Set filters.
    viewOptions.MailStorageOptions.TextFilter = "Viewer";
    viewOptions.MailStorageOptions.AddressFilter = "groupdocs@mail.com";
    viewer.View(viewOptions);
}
```
{{< /tab >}}
{{< tab "VB.NET">}}
```vb
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer = New Viewer("sample.nsf")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()
            ' Set filters.
            viewOptions.MailStorageOptions.TextFilter = "Viewer"
            viewOptions.MailStorageOptions.AddressFilter = "groupdocs@mail.com"
            viewer.View(viewOptions)
        End Using
    End Sub
End Module
```
{{< /tab >}}
{{< /tabs >}}

---

## Reverse image search

Path: /search/java/reverse-image-search/

Reverse image search is a search for images that are similar to a given reference image.

In the GroupDocs.Search index, reverse image search allows you to search for similar images in ZIP archives, various documents, and individual files.
The image search is performed by comparing the perceptual hash of the reference image with the hashes of the images in the index. The idea of ​​a perceptual hash is that for very similar images it has a value with a minimum number of different bits, and for very different images it gives a large number of different bits.

In the GroupDocs.Search engine, reverse image search, like full-text search, consists of two stages: the indexing stage and the actual search stage.

To search for images in the index, you must enable at least one of the flags in the options at the indexing stage:
* setEnabledForSeparateImages is for indexing images in separate files.
* setEnabledForEmbeddedImages is for indexing images embedded in various documents.
* setEnabledForContainerItemImages is for indexing images that are elements of container documents, such as ZIP archives, OST/PST storages.
For more information, see the [Indexing options]({{< ref "search/java/developer-guide/advanced-usage/indexing/indexing-options.md" >}}) page.

The following options are available during the search stage:
* setHashDifferences method sets the maximum number of different bits in the hashes of found images. This value ranges from 0 to 32.
* setMaxResultCount method sets the maximum number of found images.
* setSearchDocumentFilter method sets the filter for found documents.
For more information, see the [Image search options]({{< ref "search/java/developer-guide/advanced-usage/searching/image-search-options.md" >}}) page.

The following code example demonstrates all stages of the reverse image search:

```java
String indexFolder = "c:\\MyIndex";
String documentsFolder = "c:\\MyDocuments";

// Creating an index
Index index = new Index(indexFolder);

// Setting the image indexing options
IndexingOptions indexingOptions = new IndexingOptions();
indexingOptions.getImageIndexingOptions().setEnabledForContainerItemImages(true);
indexingOptions.getImageIndexingOptions().setEnabledForEmbeddedImages(true);
indexingOptions.getImageIndexingOptions().setEnabledForSeparateImages(true);

// Indexing documents in a document folder
index.add(documentsFolder, indexingOptions);

// Setting the image search options
ImageSearchOptions imageSearchOptions = new ImageSearchOptions();
imageSearchOptions.setHashDifferences(10);
imageSearchOptions.setMaxResultCount(10000);
imageSearchOptions.setSearchDocumentFilter(SearchDocumentFilter.createFileExtension(".zip", ".png", ".jpg"));

// Creating a reference image for search
SearchImage searchImage = SearchImage.create("c:\\MyDocuments\\image.png");

// Searching in the index
ImageSearchResult result = index.search(searchImage, imageSearchOptions);

System.out.print("Images found: " + result.getImageCount());
for (int i = 0; i < result.getImageCount(); i++) {
    FoundImageFrame image = result.getFoundImage(i);
    System.out.print(image.getDocumentInfo().toString());
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Reverse image search

Path: /search/net/reverse-image-search/

Reverse image search is a search for images that are similar to a given reference image.

In the GroupDocs.Search index, reverse image search allows you to search for similar images in ZIP archives, various documents, and individual files.
The image search is performed by comparing the perceptual hash of the reference image with the hashes of the images in the index. The idea of ​​a perceptual hash is that for very similar images it has a value with a minimum number of different bits, and for very different images it gives a large number of different bits.

In the GroupDocs.Search engine, reverse image search, like full-text search, consists of two stages: the indexing stage and the actual search stage.

To search for images in the index, you must enable at least one of the flags in the options at the indexing stage:
* EnabledForSeparateImages is for indexing images in separate files.
* EnabledForEmbeddedImages is for indexing images embedded in various documents.
* EnabledForContainerItemImages is for indexing images that are elements of container documents, such as ZIP archives, OST/PST storages.
For more information, see the [Indexing options]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-options.md" >}}) page.

The following options are available during the search stage:
* HashDifferences sets the maximum number of different bits in the hashes of found images. This value ranges from 0 to 32.
* MaxResultCount sets the maximum number of found images.
* SearchDocumentFilter sets the filter for found documents.
For more information, see the [Image search options]({{< ref "search/net/developer-guide/advanced-usage/searching/image-search-options.md" >}}) page.

The following code example demonstrates all stages of the reverse image search:

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentFolder = @"c:\MyDocuments";

// Creating an index
Index index = new Index(indexFolder);

// Setting the image indexing options
IndexingOptions indexingOptions = new IndexingOptions();
indexingOptions.ImageIndexingOptions.EnabledForContainerItemImages = true;
indexingOptions.ImageIndexingOptions.EnabledForEmbeddedImages = true;
indexingOptions.ImageIndexingOptions.EnabledForSeparateImages = true;

// Indexing documents in a document folder
index.Add(documentFolder, indexingOptions);

// Setting the image search options
ImageSearchOptions imageSearchOptions = new ImageSearchOptions();
imageSearchOptions.HashDifferences = 10;
imageSearchOptions.MaxResultCount = 100;
imageSearchOptions.SearchDocumentFilter = SearchDocumentFilter.CreateFileExtension(".zip", ".png", ".jpg");

// Creating a reference image for search
SearchImage searchImage = SearchImage.Create(@"c:\MyDocuments\image.png");

// Searching in the index
ImageSearchResult result = index.Search(searchImage, imageSearchOptions);

Console.WriteLine("Images found: " + result.ImageCount);
for (int i = 0; i < result.ImageCount; i++)
{
    FoundImageFrame image = result.GetFoundImage(i);
    Console.WriteLine(image.DocumentInfo.ToString());
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Reverse image search

Path: /search/nodejs-java/reverse-image-search/

Reverse image search is a search for images that are similar to a given reference image.

In the GroupDocs.Search index, reverse image search allows you to search for similar images in ZIP archives, various documents, and individual files.
The image search is performed by comparing the perceptual hash of the reference image with the hashes of the images in the index. The idea of ​​a perceptual hash is that for very similar images it has a value with a minimum number of different bits, and for very different images it gives a large number of different bits.

In the GroupDocs.Search engine, reverse image search, like full-text search, consists of two stages: the indexing stage and the actual search stage.

To search for images in the index, you must enable at least one of the flags in the options at the indexing stage:
* setEnabledForSeparateImages is for indexing images in separate files.
* setEnabledForEmbeddedImages is for indexing images embedded in various documents.
* setEnabledForContainerItemImages is for indexing images that are elements of container documents, such as ZIP archives, OST/PST storages.
For more information, see the [Indexing options]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/indexing-options.md" >}}) page.

The following options are available during the search stage:
* setHashDifferences method sets the maximum number of different bits in the hashes of found images. This value ranges from 0 to 32.
* setMaxResultCount method sets the maximum number of found images.
* setSearchDocumentFilter method sets the filter for found documents.
For more information, see the [Image search options]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/image-search-options.md" >}}) page.

The following code example demonstrates all stages of the reverse image search:

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Setting the image indexing options
const indexingOptions = new groupdocs.search.IndexingOptions();
indexingOptions.getImageIndexingOptions().setEnabledForContainerItemImages(true);
indexingOptions.getImageIndexingOptions().setEnabledForEmbeddedImages(true);
indexingOptions.getImageIndexingOptions().setEnabledForSeparateImages(true);

// Indexing documents in a document folder
index.add(documentsFolder, indexingOptions);

// Setting the image search options
const imageSearchOptions = new groupdocs.search.ImageSearchOptions();
imageSearchOptions.setHashDifferences(10);
imageSearchOptions.setMaxResultCount(10000);
imageSearchOptions.setSearchDocumentFilter(
  groupdocs.search.SearchDocumentFilter.createFileExtension('.zip', '.png', '.jpg'),
);

// Creating a reference image for search
const searchImage = groupdocs.search.SearchImage.create(Utils.ImagesPath + 'ic_arrow_downward_black_18dp.png');

// Searching in the index
const result = index.search(searchImage, imageSearchOptions);

console.log('Images found: ' + result.getImageCount());
for (let i = 0; i < result.getImageCount(); i++) {
  const image = result.getFoundImage(i);
  console.log(image.getDocumentInfo().toString());
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Specify file type for comparison manually

Path: /comparison/net/specify-file-type-manually/


[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) provides the option to specify file type for comparison manually.

To compare two documents and specify file type for comparison manually follow these steps:

1.  Instantiate the [LoadOptions](https://reference.groupdocs.com/net/comparison/groupdocs.comparison.options/loadoptions) object. Specify the [FileType](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/loadoptions/filetype/).
2.  Instantiate the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) object. Specify the source document path or stream.
3.  Call the [Add](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer/methods/add/index) method. Specify the target document path or stream.
4.  Call the [Comparer](https://reference.groupdocs.com/net/comparison/groupdocs.comparison/comparer) method.

The following code snippets show how to compare documents with a manually specified file type:

## Compare documents from local disk and specify file type for comparison manually

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

string sourcePath = @"source.docx";
string targetPath = @"target.docx";
string resultPath = @"result.docx";

// Create load options and set the file type
LoadOptions loadOptions = new LoadOptions();
loadOptions.FileType = FileType.DOCX;

using (Comparer comparer = new Comparer(sourcePath, loadOptions))
{
    // Add target document
    comparer.Add(targetPath, loadOptions);

    // Compare and save comparison result
    comparer.Compare(resultPath);
}
```
{{< /tab >}}
{{< /tabs >}}

---

## Specify file type for comparison manually

Path: /comparison/python-net/specify-file-type-manually/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) allows you to manually specify the file type for each input using `LoadOptions`.

## Compare documents from local disk and specify file type manually

Explicitly set input `FileType` when the extension is ambiguous or missing.

```python
import groupdocs.comparison as gc

source_path = "source.docx"
target_path = "target.docx"
result_path = "result.docx"

# Create load options and set the file type
load_options = gc.LoadOptions()
load_options.file_type = gc.FileType.DOCX

with gc.Comparer(source_path, load_options) as comparer:
    comparer.add(target_path, load_options)
    comparer.compare(result_path)
```

🔹 Use case: Process files with incorrect or missing extensions by forcing the correct type.



---

## Advanced search certificate documents

Path: /signature/net/advanced-search-certificate-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides [CertificateSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/certificatesearchoptions) class to specify different options to search text data within the certificate documents. 
Please be aware that the search result will be always as the MetadataSignature.

Here are the steps to search for the values within the certificate document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Instantiate the [CertificateSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/certificatesearchoptions) object according to your requirements and specify search options.
* Call [Search](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/search) method of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [CertificateSearchOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/certificatesearchoptions) to it.

This example shows how to make advanced search for text data within the certificate documents.

```csharp
var loadOptions = new LoadOptions()
{
    Password = "1234567890"
};

using (var signature = new Signature("certificate.pfx", loadOptions))
{
    var options = new CertificateSearchOptions()
    {
        // check the serial number
        Text = "AAD0D15C628A",
        // find exact math
        MatchType = TextMatchType.Contains,
    };

    // search for certificate data
    var result = signature.Search<MetadataSignature>(options);
    if (result.Count>0)
    {
        Console.WriteLine("\nCertificate contains following search results");
        foreach (MetadataSignature temp in result)
        {
            Console.WriteLine($"\t\t-{temp.Name} - {temp.Value}");
        }
    }
    else
    {
        Helper.WriteError("\nCertificate failed search process.");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Convert to Diagram with advanced options

Path: /conversion/net/convert-to-diagram-with-advanced-options/


## Introduction

GroupDocs.Conversion provides [DiagramConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/diagramconvertoptions) for converting between diagram formats. Along with [common convert options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}}) from the base class, [DiagramConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/diagramconvertoptions) provides the following additional options:

## Properties

| Property | Type | Description |
|----------|------|-------------|
| [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) | `DiagramFileType` | Specifies the desired diagram format |
| [AutoFitPageToDrawingContent](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/diagramconvertoptions/autofitpagetodrawingcontent) | `bool` | Defines whether to enlarge the page to fit drawing content |
| [PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pagenumber) | `int` | Specifies the starting page number for conversion |
| [PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pagescount) | `int` | Specifies the number of pages to convert |
| [Pages](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/commonconvertoptions-1/pages) | `List<int>` | Specifies specific page numbers to convert |

## Basic Usage

Convert diagram files with default options:

```csharp
using (var converter = new Converter("flowchart.vsdx"))
{
    var options = new DiagramConvertOptions();
    converter.Convert("flowchart-copy.vsdx", options);
}
```

## Converting Between Diagram Formats

### Convert VSDX to VSD

Convert modern Visio format to legacy binary format:

```csharp
using (var converter = new Converter("network-diagram.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        Format = DiagramFileType.Vsd
    };
    converter.Convert("network-diagram.vsd", options);
}
```

### Convert VSD to VSDX

Modernize legacy Visio files to the current format:

```csharp
using (var converter = new Converter("legacy-diagram.vsd"))
{
    var options = new DiagramConvertOptions
    {
        Format = DiagramFileType.Vsdx
    };
    converter.Convert("modernized-diagram.vsdx", options);
}
```

## Auto-Fit Page to Drawing Content

Automatically adjust the page size to fit all drawing content:

```csharp
using (var converter = new Converter("org-chart.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        AutoFitPageToDrawingContent = true
    };
    converter.Convert("org-chart-autofit.vsdx", options);
}
```

This feature is useful when:
- Diagrams have content extending beyond page boundaries
- You want to eliminate excessive white space
- Creating PDFs or images with optimal dimensions
- Preparing diagrams for presentations

## Converting Specific Pages

Convert only selected pages from multi-page diagrams:

### Convert First Page Only

```csharp
using (var converter = new Converter("multi-page-diagram.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        PageNumber = 1,
        PagesCount = 1
    };
    converter.Convert("selected-page.vsdx", options);
}
```

### Convert Specific Page Range

```csharp
using (var converter = new Converter("architecture-plans.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        PageNumber = 2,   // Start from page 2
        PagesCount = 3    // Convert 3 pages (pages 2-4)
    };
    converter.Convert("selected-pages.vsdx", options);
}
```

## Supported Diagram Formats

DiagramConvertOptions works with the following Visio formats:

### Modern Formats (Office 2013+)
- **VSDX** - Visio Drawing (default format for Visio 2013 and later)
- **VSSX** - Visio Stencil
- **VSTX** - Visio Template

### Legacy Formats (Office 2010 and earlier)
- **VSD** - Visio Drawing (binary format)
- **VSS** - Visio Stencil (binary format)
- **VST** - Visio Template (binary format)

### Macro-Enabled Formats
- **VSDM** - Visio Macro-Enabled Drawing
- **VSSM** - Visio Macro-Enabled Stencil
- **VSTM** - Visio Macro-Enabled Template

### XML Formats
- **VDX** - Visio Drawing XML
- **VSX** - Visio Stencil XML
- **VTX** - Visio Template XML

### Web Format
- **VDW** - Visio Web Drawing

## Format Details

### VSDX vs VSD

**VSDX (Modern Format)**:
- XML-based open format
- Smaller file sizes (compression)
- Better compatibility with Office 365
- Preferred for new diagrams

**VSD (Legacy Format)**:
- Binary format
- Larger file sizes
- Required for older Visio versions (2010 and earlier)
- Use for backward compatibility

### Stencil Files (VSS/VSSX)

Stencils contain reusable shapes and templates:
- VSS - Legacy stencil format
- VSSX - Modern stencil format
- Used for maintaining consistent diagram elements

### Template Files (VST/VSTX)

Templates provide starting points for new diagrams:
- VST - Legacy template format
- VSTX - Modern template format
- Include predefined layouts and styles

## Common Use Cases

### 1. Format Modernization

Upgrade legacy Visio files to modern format:

```csharp
using (var converter = new Converter("legacy-flowchart.vsd"))
{
    var options = new DiagramConvertOptions
    {
        Format = DiagramFileType.Vsdx,
        AutoFitPageToDrawingContent = true
    };
    converter.Convert("modern-flowchart.vsdx", options);
}
```

### 2. Diagram Optimization

Optimize diagrams by auto-fitting content:

```csharp
using (var converter = new Converter("process-diagram.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        AutoFitPageToDrawingContent = true
    };
    converter.Convert("optimized-diagram.vsdx", options);
}
```

### 3. Page Extraction

Extract specific pages from large diagram sets:

```csharp
using (var converter = new Converter("complete-architecture.vsdx"))
{
    var options = new DiagramConvertOptions
    {
        PageNumber = 5,
        PagesCount = 1
    };
    converter.Convert("network-layer.vsdx", options);
}
```

### 4. Batch Conversion

Standardize diagram formats across an organization:

```csharp
string[] diagramFiles = Directory.GetFiles(@"C:\diagrams", "*.vsd");

foreach (var file in diagramFiles)
{
    using (var converter = new Converter(file))
    {
        var options = new DiagramConvertOptions
        {
            Format = DiagramFileType.Vsdx
        };

        string outputFile = Path.ChangeExtension(file, ".vsdx");
        converter.Convert(outputFile, options);
    }
}
```

## When to Use DiagramConvertOptions

Use DiagramConvertOptions when you need to:

- **Convert between Visio formats** (VSD ↔ VSDX, etc.)
- **Modernize legacy diagrams** to current Visio format
- **Optimize diagram pages** with auto-fit functionality
- **Extract specific pages** from multi-page diagrams
- **Standardize diagram formats** across projects
- **Prepare diagrams** for archival or distribution

## Converting Diagrams to Other Formats

To convert diagram files to non-diagram formats (PDF, images, documents), use the appropriate ConvertOptions for the target format:

```csharp
// Convert diagram to PDF
using (var converter = new Converter("flowchart.vsdx"))
{
    var options = new PdfConvertOptions();
    converter.Convert("flowchart.pdf", options);
}

// Convert diagram to PNG images (page by page)
using (var converter = new Converter("org-chart.vsdx"))
{
    var options = new ImageConvertOptions
    {
        Format = ImageFileType.Png
    };
    converter.Convert("org-chart-page.png", options);
}

// Convert diagram to Word document
using (var converter = new Converter("process-flow.vsdx"))
{
    var options = new WordProcessingConvertOptions();
    converter.Convert("process-flow.docx", options);
}
```

## Best Practices

1. **Use modern formats** (VSDX, VSSX, VSTX) for new diagrams:
   - Better compression
   - Improved compatibility
   - Enhanced features

2. **Enable auto-fit when appropriate**:
   - Eliminates unnecessary whitespace
   - Optimizes output dimensions
   - Improves readability

3. **Convert VSD to VSDX** for long-term storage:
   - Smaller file sizes
   - Better archival format
   - Future-proof compatibility

4. **Extract pages strategically**:
   - Reduce file sizes
   - Focus on specific content
   - Improve processing speed

5. **Test macro-enabled conversions**:
   - VSDM, VSSM, VSTM contain macros
   - Verify macro requirements in target environment
   - Consider security implications

## Summary

DiagramConvertOptions provides comprehensive control over diagram format conversions:

- **Format conversion**: Convert between 13 Visio format types
- **Auto-fit functionality**: Automatically adjust pages to content
- **Page selection**: Convert specific pages or page ranges
- **Format modernization**: Upgrade legacy VSD files to modern VSDX
- **Diagram optimization**: Optimize page sizes and content fitting

All examples on this page have been verified through automated testing to ensure accuracy.

## See Also

- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})
- [DiagramConvertOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/diagramconvertoptions/)
- [DiagramFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/diagramfiletype/)

---

## Convert to Finance formats with advanced options

Path: /conversion/net/convert-to-finance-with-advanced-options/


GroupDocs.Conversion provides the [FinanceConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/financeconvertoptions) class to specify financial data format conversion settings. This class implements [IPagedConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions) for page selection support.

## Supported Finance Formats

The following financial data formats are recognized:

| Format | Extension | Description | Use Case |
|--------|-----------|-------------|----------|
| **XBRL** | .xbrl | eXtensible Business Reporting Language | Financial reporting, regulatory compliance |
| **iXBRL** | .ixbrl | Inline XBRL (HTML + XBRL) | Human-readable and machine-readable financial reports |
| **OFX** | .ofx | Open Financial Exchange | Banking data, financial transactions |

## Properties

**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired financial file format. Available options are: *Xbrl, IXbrl, Ofx*.

**[PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagenumber)** - Specifies the starting page number for conversion.

**[PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagescount)** - Specifies the number of pages to convert.

## API Structure

The following example shows the API structure for FinanceConvertOptions:

```csharp
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

// Create options object
FinanceConvertOptions options = new FinanceConvertOptions
{
    Format = FinanceFileType.Xbrl,
    PageNumber = 1,      // Starting page (for multi-page sources)
    PagesCount = 10      // Number of pages to process
};
```

## Converting Between Finance Formats

You can convert between XBRL and iXBRL formats. This allows you to transform between human-readable inline XBRL and standard XBRL format.

### Convert XBRL to iXBRL

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

// Load the source XBRL file
using (Converter converter = new Converter("financial-report.xbrl"))
{
    // Configure iXBRL convert options
    FinanceConvertOptions options = new FinanceConvertOptions
    {
        Format = FinanceFileType.IXbrl
    };

    // Convert and save
    converter.Convert("financial-report.ixbrl", options);
}
```

### Convert iXBRL to XBRL

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

// Load the source iXBRL file
using (Converter converter = new Converter("inline-report.ixbrl"))
{
    // Configure XBRL convert options
    FinanceConvertOptions options = new FinanceConvertOptions
    {
        Format = FinanceFileType.Xbrl
    };

    // Convert and save
    converter.Convert("inline-report.xbrl", options);
}
```

## Format Selection

You can specify different financial formats using the Format property:

### XBRL Format

XBRL (eXtensible Business Reporting Language) is the international standard for digital business reporting:

```csharp
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

FinanceConvertOptions xbrlOptions = new FinanceConvertOptions
{
    Format = FinanceFileType.Xbrl
};
```

### iXBRL Format

iXBRL (Inline XBRL) combines human-readable HTML with machine-readable XBRL data:

```csharp
FinanceConvertOptions ixbrlOptions = new FinanceConvertOptions
{
    Format = FinanceFileType.IXbrl
};
```

### OFX Format

OFX (Open Financial Exchange) is used for financial data exchange between institutions and applications:

```csharp
FinanceConvertOptions ofxOptions = new FinanceConvertOptions
{
    Format = FinanceFileType.Ofx
};
```

## Format Support Notes

**Supported conversions:**
- XBRL ↔ iXBRL (bidirectional conversion between standard and inline XBRL)

**Not supported:**
- Conversion from standard document formats (PDF, Word, Excel) to financial formats
- Conversion from financial formats to other formats (PDF, images, etc.)
- OFX conversions to/from XBRL or iXBRL

Financial formats like XBRL require highly specific data structures, taxonomies, and metadata that are not present in general documents.

## More Resources

- [API Reference: FinanceConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/financeconvertoptions)
- [API Reference: FinanceFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/financefiletype)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})

---

## Generate Master-Detail Reports

Path: /assembly/net/basic-usage-master-detail/


## Overview

Master-detail reports display hierarchical data where each master record (parent) has associated detail records (children). GroupDocs.Assembly for .NET supports master-detail reports through nested foreach data bands, allowing you to display parent records with their related child records.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources

Here are the steps to generate master-detail reports:

* Define data structures with parent-child relationships
* Create a template with nested foreach data bands
* Outer foreach iterates over master records
* Inner foreach iterates over detail records for each master
* Assemble the document with your hierarchical data

{{< alert style="info" >}}
Nested foreach data bands allow you to create complex hierarchical reports. The outer band processes master records, while inner bands process related detail records.
{{< /alert >}}

## Define Master-Detail Data Structure

Start by defining classes with parent-child relationships:

```csharp
public class Order
{
    public int OrderId { get; set; }
    public DateTime OrderDate { get; set; }
    public string CustomerName { get; set; }
    public List<OrderItem> Items { get; set; }
}

public class OrderItem
{
    public string ProductName { get; set; }
    public int Quantity { get; set; }
    public decimal Price { get; set; }
}
```

## Generate Master-Detail Report

Create a master-detail report from hierarchical data:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateMasterDetailReport()
{
    // Create sample data with master-detail relationship
    List<Order> orders = new List<Order>
    {
        new Order
        {
            OrderId = 1001,
            OrderDate = new DateTime(2024, 1, 15),
            CustomerName = "John Doe",
            Items = new List<OrderItem>
            {
                new OrderItem { ProductName = "Laptop", Quantity = 1, Price = 999.99m },
                new OrderItem { ProductName = "Mouse", Quantity = 2, Price = 29.99m }
            }
        },
        new Order
        {
            OrderId = 1002,
            OrderDate = new DateTime(2024, 1, 16),
            CustomerName = "Jane Smith",
            Items = new List<OrderItem>
            {
                new OrderItem { ProductName = "Keyboard", Quantity = 1, Price = 79.99m }
            }
        }
    };
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("MasterDetailTemplate.docx", "MasterDetailOutput.docx", 
        new DataSourceInfo(orders, "orders"));
    
    Console.WriteLine("Master-detail report generated successfully.");
}
```

## Template Structure for Master-Detail

In your template (MasterDetailTemplate.docx), use nested foreach data bands:

```
<<foreach [in orders]>>
Order #<<[OrderId]>>
Date: <<[OrderDate]:"yyyy-MM-dd">>
Customer: <<[CustomerName]>>

Items:
<<foreach [in Items]>>
  - <<[ProductName]>> (Qty: <<[Quantity]>>, Price: <<[Price]:"C">>)
<</foreach>>

Total: <<[Items.Sum(i => i.Price * i.Quantity)]:"C">>

<</foreach>>
```

After assembly, you'll get:

```
Order #1001
Date: 2024-01-15
Customer: John Doe

Items:
  - Laptop (Qty: 1, Price: $999.99)
  - Mouse (Qty: 2, Price: $29.99)

Total: $1,059.97

Order #1002
Date: 2024-01-16
Customer: Jane Smith

Items:
  - Keyboard (Qty: 1, Price: $79.99)

Total: $79.99
```

## Master-Detail in Tables

You can also create master-detail reports in table format:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateMasterDetailTable()
{
    List<Order> orders = new List<Order>
    {
        new Order
        {
            OrderId = 1001,
            CustomerName = "John Doe",
            Items = new List<OrderItem>
            {
                new OrderItem { ProductName = "Laptop", Quantity = 1, Price = 999.99m },
                new OrderItem { ProductName = "Mouse", Quantity = 2, Price = 29.99m }
            }
        }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("MasterDetailTableTemplate.docx", "MasterDetailTableOutput.docx", 
        new DataSourceInfo(orders, "orders"));
    
    Console.WriteLine("Master-detail table generated successfully.");
}
```

Template table structure:

| Order ID | Customer | Product | Quantity | Price |
|----------|----------|---------|----------|-------|
| `<<foreach [in orders]>>` | | | | |
| `<<[OrderId]>>` | `<<[CustomerName]>>` | `<<foreach [in Items]>>` | | |
| | | `<<[ProductName]>>` | `<<[Quantity]>>` | `<<[Price]:"C">>` |
| | | `<<foreach>>` | | |
| `<<foreach>>` | | | | |

## Using Aggregates in Master-Detail

Calculate totals and aggregates for each master record:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void GenerateMasterDetailWithAggregates()
{
    List<Order> orders = new List<Order>
    {
        new Order
        {
            OrderId = 1001,
            CustomerName = "John Doe",
            Items = new List<OrderItem>
            {
                new OrderItem { ProductName = "Laptop", Quantity = 1, Price = 999.99m },
                new OrderItem { ProductName = "Mouse", Quantity = 2, Price = 29.99m }
            }
        }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("MasterDetailTemplate.docx", "MasterDetailOutput.docx", 
        new DataSourceInfo(orders, "orders"));
    
    Console.WriteLine("Master-detail report with aggregates generated successfully.");
}
```

Template with aggregates:

```
<<foreach [in orders]>>
Order #<<[OrderId]>> - <<[CustomerName]>>

Items:
<<foreach [in Items]>>
  <<[ProductName]>> - <<[Quantity]>> x <<[Price]:"C">> = <<[Quantity * Price]:"C">>
<</foreach>>

Subtotal: <<[Items.Sum(i => i.Price * i.Quantity)]:"C">>
Item Count: <<[Items.Count()]>>
<</foreach>>
```

{{< alert style="warning" >}}
When using nested foreach data bands, ensure proper closing tags. Each opening `<<foreach>>` must have a corresponding closing `<<foreach>>`.
{{< /alert >}}

### Advanced Usage Topics

To learn more about complex hierarchical structures, multiple levels of nesting, and advanced master-detail patterns, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Load page description language document with options

Path: /conversion/net/load-page-description-language-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [PageDescriptionLanguageLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pagedescriptionlanguageloadoptions) to control how source page description language (PDL) documents are processed. PDL documents include formats like XPS, SVG, EPS, PostScript (PS), TEX, and PCL.

The following options are available:

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/pagedescriptionlanguageloadoptions/format)** | The document type is auto-detected during loading, but you can explicitly specify the source format. Available options include: *Xps, Eps, Svg, Ps, Tex, Pcl, Cgm, Oxps* |

## Load XPS document

The following code snippet shows how to load an XPS document with explicit format specification:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PageDescriptionLanguageLoadOptions
{
    Format = PageDescriptionLanguageFileType.Xps
};

using (Converter converter = new Converter("document.xps", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("document.pdf", options);
}
```

## Load EPS document

The following code snippet shows how to load an EPS (Encapsulated PostScript) document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PageDescriptionLanguageLoadOptions
{
    Format = PageDescriptionLanguageFileType.Eps
};

using (Converter converter = new Converter("vector-graphic.eps", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("vector-graphic.pdf", options);
}
```

## Load PostScript document

The following code snippet shows how to load a PostScript (PS) document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PageDescriptionLanguageLoadOptions
{
    Format = PageDescriptionLanguageFileType.Ps
};

using (Converter converter = new Converter("print-file.ps", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("print-file.pdf", options);
}
```

## Convert XPS to SVG

The following code snippet shows how to load an XPS document and convert it to SVG:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PageDescriptionLanguageLoadOptions
{
    Format = PageDescriptionLanguageFileType.Xps
};

using (Converter converter = new Converter("layout.xps", getLoadOptions))
{
    PageDescriptionLanguageConvertOptions options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Svg
    };
    converter.Convert("layout.svg", options);
}
```

## Convert EPS to SVG

The following code snippet shows how to convert from EPS to SVG format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new PageDescriptionLanguageLoadOptions
{
    Format = PageDescriptionLanguageFileType.Eps
};

using (Converter converter = new Converter("illustration.eps", getLoadOptions))
{
    PageDescriptionLanguageConvertOptions options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Svg
    };
    converter.Convert("illustration.svg", options);
}
```

---

## OCR support

Path: /search/java/ocr-support/

OCR support means the ability to connect an external module (library) for the recognition of printed text (optical character recognition, OCR) on images, either separate or embedded in documents.

To connect OCR, you need to implement the IOcrConnector interface in the client code.

The following example demonstrates how to implement the OCR connector using com.aspose.ocr library for text recognition in images.

```java
String indexFolder = "c:\\MyIndex";
String documentFolder = "c:\\MyDocuments";

// Creating an index
Index index = new Index(indexFolder);

// Setting the OCR indexing options
IndexingOptions options = new IndexingOptions();
options.getOcrIndexingOptions().setEnabledForSeparateImages(true);
options.getOcrIndexingOptions().setEnabledForEmbeddedImages(true);
options.getOcrIndexingOptions().setOcrConnector(new OcrConnector());

// Indexing documents in a document folder
index.add(documentFolder, options);

// Searching in the index
SearchResult result = index.search("Einstein");

...

// Implementing the OCR connector that uses com.aspose.ocr library
public static class OcrConnector implements IOcrConnector {
    public OcrConnector() {
    }

    @Override
    public final String recognize(OcrContext context) {
        if (null == context.getImageLocation()) {
            throw new NotSupportedException("The image type is not supported: " + context.getImageLocation());
        } else {
            switch (context.getImageLocation()) {
            case Separate:
            case Embedded:
            case ContainerItem:
                return recognizePrivate(context);
            default:
                throw new NotSupportedException("The image type is not supported: " + context.getImageLocation());
            }
        }
    }

    private String recognizePrivate(OcrContext context) {
        try {
            java.awt.image.BufferedImage image = javax.imageio.ImageIO.read(context.getImageStream());
            com.aspose.ocr.AsposeOCR asposeOcr = new com.aspose.ocr.AsposeOCR();
            String result = asposeOcr.RecognizePage(image);
            return result;
        } catch (java.io.IOException ex) {
            throw new RuntimeException(ex);
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## OCR support

Path: /search/net/ocr-support/

OCR support means the ability to connect an external module (library) for the recognition of printed text (optical character recognition, OCR) on images, either separate or embedded in documents.

To connect OCR, you need to implement the IOcrConnector interface in the client code.

The following example demonstrates how to implement the OCR connector using Aspose.OCR library for text recognition in images.

```csharp
string indexFolder = @"c:\MyIndex";
string documentFolder = @"c:\MyDocuments";

// Creating an index
Index index = new Index(indexFolder);

// Setting the OCR indexing options
IndexingOptions options = new IndexingOptions();
options.OcrIndexingOptions.EnabledForSeparateImages = true;
options.OcrIndexingOptions.EnabledForEmbeddedImages = true;
options.OcrIndexingOptions.OcrConnector = new AsposeOcrConnector();

// Indexing documents in a document folder
index.Add(documentFolder, options);

// Searching in the index
SearchResult result = index.Search("Einstein");

...

// Implementing the OCR connector that uses Aspose.OCR library
// You need to install the following package:
// https://www.nuget.org/packages/Aspose.OCR/
public class AsposeOcrConnector : IOcrConnector
{
    public AsposeOcrConnector()
    {
    }

    public string Recognize(OcrContext context)
    {
        string extension = context.ImageFileExtension.ToLowerInvariant();
        if (context.ImageLocation == ImageLocation.Separate)
        {
            switch (extension)
            {
                case ".gif":
                case ".png":
                case ".jpg":
                case ".jpeg":
                case ".bmp":
                case ".tif":
                case ".tiff":
                case "":
                    return RecognizePrivate(context);

                default:
                    return null;
            }
        }
        else if (context.ImageLocation == ImageLocation.Embedded ||
            context.ImageLocation == ImageLocation.ContainerItem)
        {
            return RecognizePrivate(context);
        }
        else
        {
            throw new NotSupportedException("The image type is not supported: " + context.ImageLocation);
        }
    }

    private string RecognizePrivate(OcrContext context)
    {
        MemoryStream memoryStream = new MemoryStream((int)context.ImageStream.Length);
        context.ImageStream.CopyTo(memoryStream);

        AsposeOcr asposeOcr = new AsposeOcr();
        string result = asposeOcr.RecognizeImage(memoryStream);
        return result;
    }
}
```

The next example demonstrates how to implement the OCR connector using Aspose Cloud OCR API.

```csharp
// Implementing the OCR connector that uses Aspose Cloud OCR
// The full API for Aspose Cloud OCR for .NET you can find in the repository:
// https://github.com/aspose-ocr-cloud/aspose-ocr-cloud-dotnet
// Sid and key you can get after free registration at
// https://dashboard.aspose.cloud/applications
public class AsposeCloudOcrConnector : IOcrConnector
{
    private readonly Configuration _configuration;

    public AsposeCloudOcrConnector()
    {
        _configuration = new Configuration();
        _configuration.AppSid = "...";
        _configuration.AppKey = "...";
    }

    public string Recognize(OcrContext context)
    {
        OcrApi api = new OcrApi(_configuration);
        var request = new PostOcrFromUrlOrContentRequest(context.ImageStream);
        OCRResponse response = api.PostOcrFromUrlOrContent(request);
        return response.Text;
    }
}
```

And the following example demonstrates how to implement the OCR connector using Tesseract.

```csharp
// Implementing the OCR connector that uses Tesseract
// You need to install the following packages:
// https://www.nuget.org/packages/Tesseract/
// https://www.nuget.org/packages/Tesseract.Data.English/
public class TesseractOcrConnector : IOcrConnector
{
    public TesseractOcrConnector()
    {
    }

    public string Recognize(OcrContext context)
    {
        var buffer = new byte[context.ImageStream.Length];
        context.ImageStream.Read(buffer, 0, buffer.Length);

        var path = Path.GetDirectoryName(Assembly.GetExecutingAssembly().CodeBase);
        path = Path.Combine(path, "tessdata");
        path = path.Replace("file:\\", "");

        using (var engine = new TesseractEngine(path, "eng", EngineMode.Default))
        using (Pix img = Pix.LoadFromMemory(buffer))
        using (Page recognizedPage = engine.Process(img))
        {
            string recognizedText = recognizedPage.GetText();
            return recognizedText;
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## OCR support

Path: /search/nodejs-java/ocr-support/

OCR support means the ability to connect an external module (library) for the recognition of printed text (optical character recognition, OCR) on images, either separate or embedded in documents.

To connect OCR, you need to implement the IOcrConnector interface in the client code.

The following example demonstrates how to implement the OCR connector using com.aspose.ocr library for text recognition in images.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';
const query = 'Einstein';

// Creating an index
const index = new groupdocs.search.Index(indexFolder, true);

// Subscribing to the ErrorOccurred event
index.getEvents().ErrorOccurred.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      console.log(args.getMessage());
    },
  }),
);

// Setting the OCR indexing options
const options = new groupdocs.search.IndexingOptions();
options.getOcrIndexingOptions().setEnabledForSeparateImages(true);
options.getOcrIndexingOptions().setEnabledForEmbeddedImages(true);
const ocrConnector = java.newProxy('com.groupdocs.search.options.IOcrConnector', {
  recognize: function (context) {
    switch (String(context.getImageLocation())) {
      case 'Separate':
      case 'Embedded':
      case 'ContainerItem':
        const image = java.callStaticMethodSync('javax.imageio.ImageIO', 'read', context.getImageStream());
        const asposeOcr = new groupdocs.search.AsposeOcr();
        const result = asposeOcr.RecognizePage(image);
        return result;
      default:
        throw new Error('The image type is not supported: ' + context.getImageLocation());
    }
  },
});
options.getOcrIndexingOptions().setOcrConnector(ocrConnector);

// Indexing documents in a document folder
index.add(documentsFolder, options);

// Searching in the index
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

* [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

* [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search by chunks

Path: /search/java/search-by-chunks/

The GroupDocs.Search API provides the ability to perform search by chunks. This means that in one call to the [search](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#search(java.lang.String,%20com.groupdocs.search.options.SearchOptions)) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class, only in one index segment search is performed. This feature becomes relevant when searching in large indexes containing tens and hundreds of thousands of documents.

When performing search by chunks, the [search](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#search(java.lang.String,%20com.groupdocs.search.options.SearchOptions)) method is first called with the chunk search flag set to true via [setChunkSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setChunkSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class. And then the search in each subsequent segment is performed using the [searchNext](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#searchNext(com.groupdocs.search.common.ChunkSearchToken)) method with passing [ChunkSearchToken](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/ChunkSearchToken) of the next chunk as an argument.

The following example demonstrates the search by chunks.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
String query = "Einstein";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.setChunkSearch(true); // Enabling the search by chunks
 
// Starting the search by chunks
SearchResult result = index.search(query, options);
System.out.println("Document count: " + result.getDocumentCount());
System.out.println("Occurrence count: " + result.getOccurrenceCount());
 
// Continuing the search by chunks
while (result.getNextChunkSearchToken() != null) {
    result = index.searchNext(result.getNextChunkSearchToken());
    System.out.println("Document count: " + result.getDocumentCount());
    System.out.println("Occurrence count: " + result.getOccurrenceCount());
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search by chunks

Path: /search/net/search-by-chunks/

The GroupDocs.Search API provides the ability to perform search by chunks. This means that in one call to the [Search](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/search/index) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class, only in one index segment search is performed. This feature becomes relevant when searching in large indexes containing tens and hundreds of thousands of documents.

When performing search by chunks, the [Search](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/search/index) method is first called with the [IsChunkSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/ischunksearch) flag set to true in the search options. And then the search in each subsequent segment is performed using the [SearchNext](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/searchnext/index) method with passing [ChunkSearchToken](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/nextchunksearchtoken) of the next chunk as an argument.

The following example demonstrates the search by chunks.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
string query = "Einstein";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.IsChunkSearch = true; // Enabling the search by chunks
 
// Starting the search by chunks
SearchResult result = index.Search(query, options);
Console.WriteLine("Document count: " + result.DocumentCount);
Console.WriteLine("Occurrence count: " + result.OccurrenceCount);
 
// Continuing the search by chunks
while (result.NextChunkSearchToken != null)
{
    result = index.SearchNext(result.NextChunkSearchToken);
    Console.WriteLine("Document count: " + result.DocumentCount);
    Console.WriteLine("Occurrence count: " + result.OccurrenceCount);
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search by chunks

Path: /search/nodejs-java/search-by-chunks/

The GroupDocs.Search API provides the ability to perform search by chunks. This means that in one call to the [search](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#search(java.lang.String,%20com.groupdocs.search.options.SearchOptions)) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class, only in one index segment search is performed. This feature becomes relevant when searching in large indexes containing tens and hundreds of thousands of documents.

When performing search by chunks, the [search](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#search(java.lang.String,%20com.groupdocs.search.options.SearchOptions)) method is first called with the chunk search flag set to true via [setChunkSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setChunkSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class. And then the search in each subsequent segment is performed using the [searchNext](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#searchNext(com.groupdocs.search.common.ChunkSearchToken)) method with passing [ChunkSearchToken](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/ChunkSearchToken) of the next chunk as an argument.

The following example demonstrates the search by chunks.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder1 = 'c:/MyDocuments1/';
const documentsFolder2 = 'c:/MyDocuments2/';
const documentsFolder3 = 'c:/MyDocuments3/';
const query = 'invitation';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder1);
index.add(documentsFolder2);
index.add(documentsFolder3);

// Creating a search options instance
const options = new groupdocs.search.SearchOptions();
options.setChunkSearch(true); // Enabling the search by chunks

// Starting the search by chunks
let result = index.search(query, options);
console.log('Document count: ' + result.getDocumentCount());
console.log('Occurrence count: ' + result.getOccurrenceCount());

// Continuing the search by chunks
while (result.getNextChunkSearchToken() != null) {
  result = index.searchNext(result.getNextChunkSearchToken());
  console.log();
  console.log('Document count: ' + result.getDocumentCount());
  console.log('Occurrence count: ' + result.getOccurrenceCount());
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Convert Archive Formats (ZIP, 7z, TAR, RAR)

Path: /conversion/net/convert-to-compression-with-advanced-options/


This guide shows how to convert archives between formats (ZIP to 7z, ZIP to TAR, etc.) without modifying the files inside. The archive format changes, but the contents remain unchanged.

**To extract and convert files inside archives**, see [Extract and Convert Archive Contents]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-contents-of-rar-or-zip-document-to-different-formats-and-compress.md" >}}).

## Basic Archive Format Conversion

Convert ZIP to 7z:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

using (var converter = new Converter("archive.zip"))
{
    var options = new CompressionConvertOptions
    {
        Format = CompressionFileType.SevenZ
    };
    converter.Convert("archive.7z", options);
}
```

Convert ZIP to TAR:

```csharp
using (var converter = new Converter("documents.zip"))
{
    var options = new CompressionConvertOptions
    {
        Format = CompressionFileType.Tar
    };
    converter.Convert("documents.tar", options);
}
```

## Password Protection

Add password to output archive:

```csharp
using (var converter = new Converter("data.zip"))
{
    var options = new CompressionConvertOptions
    {
        Format = CompressionFileType.SevenZ,
        Password = "SecurePassword123"
    };
    converter.Convert("data-protected.7z", options);
}
```

## CompressionConvertOptions Properties

| Property | Type | Description |
|----------|------|-------------|
| [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) | `CompressionFileType` | Target archive format (ZIP, 7z, TAR, etc.) |
| [Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/compressionconvertoptions/password) | `string` | Optional password to protect the output archive |

## Supported Archive Formats

**Input (read):** ZIP, RAR, 7z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ, CAB, LZ, CPIO, ISO

**Output (write):** ZIP, 7z, TAR, TAR.GZ, TAR.BZ2, TAR.XZ

{{< alert style="warning" >}}
**RAR Output Limitation:** RAR archives can be read as input but **cannot be created as output** due to licensing restrictions. Use ZIP, 7z, or TAR as alternatives.
{{< /alert >}}

## Format Comparison

**ZIP** - Most compatible, good compression, universal support
**7z (SevenZ)** - Best compression ratio, open source, requires 7-Zip
**TAR** - Unix/Linux standard, preserves permissions, often used with compression (TAR.GZ)
**RAR** - Input only, cannot be created as output

## Batch Processing

Convert multiple archives:

```csharp
string[] zipFiles = Directory.GetFiles(@"C:\archives", "*.zip");

foreach (var zipFile in zipFiles)
{
    string outputFile = Path.Combine(
        @"C:\converted",
        Path.GetFileNameWithoutExtension(zipFile) + ".7z"
    );

    using (var converter = new Converter(zipFile))
    {
        var options = new CompressionConvertOptions
        {
            Format = CompressionFileType.SevenZ,
            Password = "Batch2024"
        };
        converter.Convert(outputFile, options);
    }
}
```

## Common Scenarios

**Cross-platform distribution** (ZIP to TAR.GZ):

```csharp
using (var converter = new Converter("windows-software.zip"))
{
    var options = new CompressionConvertOptions
    {
        Format = CompressionFileType.Gz  // TAR.GZ
    };
    converter.Convert("unix-software.tar.gz", options);
}
```

**Maximum compression** (ZIP to 7z):

```csharp
using (var converter = new Converter("large-dataset.zip"))
{
    var options = new CompressionConvertOptions
    {
        Format = CompressionFileType.SevenZ
    };
    converter.Convert("large-dataset.7z", options);
}
```

**Legacy RAR conversion** (RAR to ZIP):

```csharp
using (var converter = new Converter("old-archive.rar"))
{
    var options = new CompressionConvertOptions
    {
        Format = CompressionFileType.Zip
    };
    converter.Convert("new-archive.zip", options);
}
```

## FluentConverter Alternative

You can also use FluentConverter for archive format conversion:

```csharp
using GroupDocs.Conversion.Fluent;
using GroupDocs.Conversion.Contracts;

FluentConverter.Load("archive.zip")
    .ConvertTo((SaveContext saveContext) => File.Create("archive.7z"))
    .WithOptions(new CompressionConvertOptions
    {
        Format = CompressionFileType.SevenZ
    })
    .Convert();
```

The standard Converter API shown above is simpler for basic format conversion.

## Limitations

**Cannot convert regular documents to archives:**

```csharp
// ❌ THIS WILL FAIL
using (var converter = new Converter("document.pdf"))
{
    var options = new CompressionConvertOptions
    {
        Format = CompressionFileType.Zip
    };
    converter.Convert("output.zip", options);
}
```

Archives contain multiple files. To extract and convert archive contents, see [Working with Archive Files]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-contents-of-rar-or-zip-document-to-different-formats-and-compress.md" >}}).

## See Also

- [Working with Archive Files (ZIP, RAR, 7z, TAR)]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-contents-of-rar-or-zip-document-to-different-formats-and-compress.md" >}})
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})
- [CompressionConvertOptions API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/compressionconvertoptions/)
- [CompressionFileType API Reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/compressionfiletype/)

---

## Convert to CAD formats with advanced options

Path: /conversion/net/convert-to-cad-with-advanced-options/


GroupDocs.Conversion provides the [CadConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/cadconvertoptions) class to specify CAD file format conversion settings. This class implements [IPagedConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions) for page selection and [IPageSizeConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagesizeconvertoptions) for page sizing.

## Supported CAD Formats

The following CAD (Computer-Aided Design) formats are recognized:

| Format | Extension | Description |
|--------|-----------|-------------|
| **DWG** | .dwg | AutoCAD Drawing Database (binary format) |
| **DXF** | .dxf | Drawing Exchange Format (ASCII/binary) |
| **DWF** | .dwf | Design Web Format (compressed 2D/3D) |
| **DWFX** | .dwfx | Design Web Format XPS |
| **DWT** | .dwt | AutoCAD Drawing Template |
| **DGN** | .dgn | MicroStation Design File |
| **IFC** | .ifc | Industry Foundation Classes (BIM) |
| **STL** | .stl | Stereolithography (3D printing) |
| **PLT** | .plt | HPGL Plot File |
| **IGS** | .igs | IGES Drawing File |
| **CF2** | .cf2 | Common File Format (3D package designs) |

## Properties

**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired CAD file format. Available options are: *Dwg, Dxf, Dwf, Dwfx, Dwt, Dgn, Ifc, Stl, Plt, Igs, Cf2*.

**[PageSize](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagesizeconvertoptions/pagesize)** - Sets the page size (A3, A4, Letter, etc.) for the output document.

**[PageWidth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagesizeconvertoptions/pagewidth)** - Sets custom page width in points. When set, PageSize automatically changes to Custom.

**[PageHeight](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagesizeconvertoptions/pageheight)** - Sets custom page height in points. When set, PageSize automatically changes to Custom.

**[PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagenumber)** - Specifies the starting page number for conversion.

**[PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagescount)** - Specifies the number of pages to convert.

## API Structure

The following example shows the API structure for CadConvertOptions:

```csharp
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

// Create options object
CadConvertOptions options = new CadConvertOptions
{
    Format = CadFileType.Dwg,
    PageSize = GroupDocs.Conversion.Options.Convert.PageSize.A4,
    PageNumber = 1,      // Starting page
    PagesCount = 10      // Number of pages to process
};
```

## Conversion Examples

CadConvertOptions supports conversion between CAD formats. The following examples demonstrate common conversions.

### DWG to DXF

Convert an AutoCAD DWG file to DXF (Drawing Exchange Format):

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "drawing.dwg";
string outputFile = "drawing.dxf";

using (var converter = new Converter(sourceFile))
{
    var options = new CadConvertOptions
    {
        Format = CadFileType.Dxf
    };
    converter.Convert(outputFile, options);
}
```

### DWG to DWF

Convert a DWG file to DWF (Design Web Format):

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "blueprint.dwg";
string outputFile = "blueprint.dwf";

using (var converter = new Converter(sourceFile))
{
    var options = new CadConvertOptions
    {
        Format = CadFileType.Dwf
    };
    converter.Convert(outputFile, options);
}
```

## Page Size Options

Control output page dimensions using PageSize or custom dimensions:

### Using Standard Page Size

Set a standard page size (A4, A3, Letter, etc.):

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "technical-drawing.dwg";
string outputFile = "technical-drawing-a4.dxf";

using (var converter = new Converter(sourceFile))
{
    var options = new CadConvertOptions
    {
        Format = CadFileType.Dxf,
        PageSize = PageSize.A4
    };
    converter.Convert(outputFile, options);
}
```

### Using Custom Page Dimensions

Define custom page width and height in points:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "floor-plan.dwg";
string outputFile = "floor-plan-custom.dxf";

using (var converter = new Converter(sourceFile))
{
    var options = new CadConvertOptions
    {
        Format = CadFileType.Dxf,
        PageWidth = 800,   // Width in points
        PageHeight = 600   // Height in points
    };
    converter.Convert(outputFile, options);
}
```

## Format Support Notes

CAD to CAD conversions are supported for select format combinations:
- DWG → DXF, DWF
- DGN → DXF, DWF
- DWT → DXF, DWF
- STL → DXF, DWF (limited support)
- Other CAD formats → DXF, DWF (varies by format)

Conversions from non-CAD formats (PDF, Word, Excel) to CAD formats are not supported.

**Note:** To convert FROM CAD formats to PDF or images, use [PdfConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-pdf-with-advanced-options.md" >}}) or [ImageConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-image-with-advanced-options.md" >}}).

## More Resources

- [API Reference: CadConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/cadconvertoptions)
- [API Reference: CadFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/cadfiletype)
- [Convert CAD Formats]({{< ref "conversion/net/developer-guide/basic-usage/convert/cad.md" >}})
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})

---

## How to verify signatures with predicate functions

Path: /signature/net/verify-signatures-with-predicate-functions/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) provides LINQ query support for verification process.

Here are the steps to verify Barcode signature within the document with GroupDocs.Signature:

* Create new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass source document path as a constructor parameter.
* Use a LINQ query inside the [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method method to define verification criteria, such as checking that the signature type is Barcode and that the SignatureId equals "123".
* Execute the verification by calling the [Verify](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/verify) method and passing the query.
* Process the verification result by iterating through the returned signatures if needed.

This example shows how to verify Barcode signature with LINQ query in the document

```csharp
// Define the path to the PDF file.
string filePath = Constants.SAMPLE_PDF;
string fileName = Path.GetFileName(filePath);

// Use the 'using' statement for automatic resource management.
using (var signature = new Signature(filePath))
{
    // Perform a varify to validate signatures of type Barcode with a specific SignatureId.
    var signatures = signature.Verify(signatureItem => 
        signatureItem.SignatureType == SignatureType.Barcode && 
        signatureItem.SignatureId.Equals("123", StringComparison.Ordinal)
    );
   // Optionally, process the verified signatures here.
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Load 3D document with options

Path: /conversion/net/load-3d-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [ThreeDLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/threedloadoptions) to control how source 3D model documents are processed. 3D documents include formats like FBX, OBJ, GLTF, 3DS, U3D, and other 3D modeling file formats.

The following options are available:

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/threedloadoptions/format)** | The document type is auto-detected during loading, but you can explicitly specify the source format. Available options include: *Fbx, ThreeDS, ThreeMF, Amf, Ase, Dae, Drc, Gltf, Obj, Ply, Rvm, U3d, Usd, Usdz, Vrml, X* |

## Load FBX document

The following code snippet shows how to load an FBX (Filmbox) document with explicit format specification:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new ThreeDLoadOptions
{
    Format = ThreeDFileType.Fbx
};

using (Converter converter = new Converter("character-model.fbx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("character-model.pdf", options);
}
```

## Load OBJ document

The following code snippet shows how to load an OBJ (Wavefront) document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new ThreeDLoadOptions
{
    Format = ThreeDFileType.Obj
};

using (Converter converter = new Converter("building-model.obj", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("building-model.pdf", options);
}
```

## Convert FBX to OBJ

The following code snippet shows how to load an FBX document and convert it to OBJ format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new ThreeDLoadOptions
{
    Format = ThreeDFileType.Fbx
};

using (Converter converter = new Converter("animated-scene.fbx", getLoadOptions))
{
    ThreeDConvertOptions options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.Obj
    };
    converter.Convert("animated-scene.obj", options);
}
```

## Convert OBJ to GLTF

The following code snippet shows how to convert from OBJ to GLTF format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new ThreeDLoadOptions
{
    Format = ThreeDFileType.Obj
};

using (Converter converter = new Converter("product-design.obj", getLoadOptions))
{
    ThreeDConvertOptions options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.Gltf
    };
    converter.Convert("product-design.gltf", options);
}
```

## Convert FBX to U3D

The following code snippet shows how to convert from FBX to U3D (Universal 3D) format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new ThreeDLoadOptions
{
    Format = ThreeDFileType.Fbx
};

using (Converter converter = new Converter("game-asset.fbx", getLoadOptions))
{
    ThreeDConvertOptions options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.U3d
    };
    converter.Convert("game-asset.u3d", options);
}
```

---

## Optimize index

Path: /search/java/optimize-index/

An index optimization operation allows you to reduce the number of segments in an index, thereby increasing search performance in the index.

To perform this operation, there is an overload that takes the [MergeOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MergeOptions) instance as a parameter. In the [MergeOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/MergeOptions) class, there is a method for specifying a cancellation object and a method for specifying whether to perform the operation asynchronously. By default, the operation is performed synchronously.

The following example demonstrates how to perform the index optimization.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder1 = "c:\\MyDocuments1\\";
String documentsFolder2 = "c:\\MyDocuments2\\";
String documentsFolder3 = "c:\\MyDocuments3\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
index.add(documentsFolder1); // Indexing documents from the specified folder
index.add(documentsFolder2); // Each call to Add creates at least one new segment in the index
index.add(documentsFolder3);
 
MergeOptions options = new MergeOptions();
options.setCancellation(new Cancellation()); // Creating cancellation object to be able to cancel the operation
options.getCancellation().cancelAfter(100000); // Setting maximum duration of the operation to 100 seconds
 
// Merging segments of the index
index.optimize(options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Optimize index

Path: /search/net/optimize-index/

An index optimization operation allows you to reduce the number of segments in an index, thereby increasing search performance in the index.

To perform this operation, there is an overload that takes the [MergeOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/mergeoptions) instance as a parameter. In the [MergeOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/mergeoptions) class, there is a property for specifying a cancellation object and a property for specifying whether to perform the operation asynchronously. By default, the operation is performed synchronously.

The following example demonstrates how to perform the index optimization.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder1 = @"c:\MyDocuments1\";
string documentsFolder2 = @"c:\MyDocuments2\";
string documentsFolder3 = @"c:\MyDocuments3\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
index.Add(documentsFolder1); // Indexing documents from the specified folder
index.Add(documentsFolder2); // Each call to Add creates at least one new segment in the index
index.Add(documentsFolder3);
 
MergeOptions options = new MergeOptions();
options.Cancellation = new Cancellation(); // Creating cancellation object to be able to cancel the operation
options.Cancellation.CancelAfter(100000); // Setting maximum duration of the operation to 100 seconds
 
// Merging segments of the index
index.Optimize(options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Optimize index

Path: /search/nodejs-java/optimize-index/

An index optimization operation allows you to reduce the number of segments in an index, thereby increasing search performance in the index.

To perform this operation, there is an overload that takes the [MergeOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MergeOptions) instance as a parameter. In the [MergeOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/MergeOptions) class, there is a method for specifying a cancellation object and a method for specifying whether to perform the operation asynchronously. By default, the operation is performed synchronously.

The following example demonstrates how to perform the index optimization.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder1 = 'c:/MyDocuments1/';
const documentsFolder2 = 'c:/MyDocuments2/';
const documentsFolder3 = 'c:/MyDocuments3/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, true);

index.add(documentsFolder1); // Indexing documents from the specified folder
index.add(documentsFolder2); // Each call to Add creates at least one new segment in the index
index.add(documentsFolder3);

const options = new groupdocs.search.MergeOptions();
options.setCancellation(new groupdocs.search.Cancellation()); // Creating cancellation object to be able to cancel the operation
options.getCancellation().cancelAfter(30000); // Setting maximum duration of the operation to 30 seconds

// Merging segments of the index
index.optimize(options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search flow

Path: /search/java/search-flow/

The table below shows the internal stages of each search operation. See also [Query language specification]({{< ref "search/java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}), [Search operation table]({{< ref "search/java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}).

| Operation | Search flow |
| --- | --- |
| Simple term search (case insensitive) | Keyboard layout correction<br/>Spelling correction<br/>Homophone search<br/>Synonym search<br/>Word forms search (since v.18.7)<br/>Fuzzy search<br/>Retrieving results |
| Simple term search (case sensitive) | Retrieving results |
| Wildcard search (since v.18.12) | Wildcard search<br/>Retrieving results |
| Date range search | Retrieving results |
| Numeric range search | Retrieving results |
| Phrase search | Retrieving results for each term of a phrase<br/>Joining sets of results |
| Regex search | Regex search<br/>Fuzzy search<br/>Retrieving results |
| And, Or | Retrieving results for each operand<br/>Combining sets of results |
| Not | Retrieving results for operand<br/>Inverting set of results |

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search flow

Path: /search/net/search-flow/

The table below shows the internal stages of each search operation. See also [Query language specification]({{< ref "search/net/developer-guide/advanced-usage/searching/query-language-specification.md" >}}), [Search operation table]({{< ref "search/net/developer-guide/advanced-usage/searching/search-operation-table.md" >}}).

| Operation | Search flow |
| --- | --- |
| Simple term search (case insensitive) | Keyboard layout correction<br/>Spelling correction<br/>Homophone search<br/>Synonym search<br/>Word forms search (since v.18.7)<br/>Fuzzy search<br/>Retrieving results |
| Simple term search (case sensitive) | Retrieving results |
| Wildcard search (since v.18.12) | Wildcard search<br/>Retrieving results |
| Date range search | Retrieving results |
| Numeric range search | Retrieving results |
| Phrase search | Retrieving results for each term of a phrase<br/>Joining sets of results |
| Regex search | Regex search<br/>Fuzzy search<br/>Retrieving results |
| And, Or | Retrieving results for each operand<br/>Combining sets of results |
| Not | Retrieving results for operand<br/>Inverting set of results |

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search flow

Path: /search/nodejs-java/search-flow/

The table below shows the internal stages of each search operation. See also [Query language specification]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}), [Search operation table]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}).

| Operation | Search flow |
| --- | --- |
| Simple term search (case insensitive) | Keyboard layout correction<br/>Spelling correction<br/>Homophone search<br/>Synonym search<br/>Word forms search (since v.18.7)<br/>Fuzzy search<br/>Retrieving results |
| Simple term search (case sensitive) | Retrieving results |
| Wildcard search (since v.18.12) | Wildcard search<br/>Retrieving results |
| Date range search | Retrieving results |
| Numeric range search | Retrieving results |
| Phrase search | Retrieving results for each term of a phrase<br/>Joining sets of results |
| Regex search | Regex search<br/>Fuzzy search<br/>Retrieving results |
| And, Or | Retrieving results for each operand<br/>Combining sets of results |
| Not | Retrieving results for operand<br/>Inverting set of results |

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Separate data extraction

Path: /search/java/separate-data-extraction/

The feature described in this article makes it possible to separate the operations of extracting data from a document and adding the extracted data to the index. The extracted data can be easily serialized and deserialized as needed.

This feature can be useful because the operation of extracting text and other data from documents can be very long for some formats. At the same time, adding data to the index is a rather lightweight operation. And thus, separating these operations can lead to a significant increase in the total time when the index is not busy performing any operations. And the subsequent addition of new data extractors will significantly increase the performance of indexing. In this case, data extractors can even work on separate servers, completely freeing the indexing server from extracting operations.

The [Extractor](https://reference.groupdocs.com/search/java/com.groupdocs.search/Extractor) class is used to extract data from documents. Upon completion of the operation, the extract method returns an instance of the [ExtractedData](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/ExtractedData) class, which is used directly to add to the index.

The following example demonstrates how to perform separate data extraction and indexing.

```java
String indexFolder = "c:\\MyIndex";
String documentPath = "c:\\MyDocuments\\MyDocument.pdf";

// Extracting data from a document
Extractor extractor = new Extractor();
Document document = Document.createFromFile(documentPath);
ExtractionOptions extractionOptions = new ExtractionOptions();
extractionOptions.setUseRawTextExtraction(false);
ExtractedData extractedData = extractor.extract(document, extractionOptions);

// Serializing the data
byte[] array = extractedData.serialize();

// Deserializing the data
ExtractedData deserializedData = ExtractedData.deserialize(array);

// Creating an index
com.groupdocs.search.Index index = new com.groupdocs.search.Index(indexFolder);

// Indexing the data
ExtractedData[] data = new ExtractedData[] {
    deserializedData
};
index.add(data, new IndexingOptions());

// Searching in the index
SearchResult result = index.search("Einstein");
```

Note that when indexed documents change and need to be updated in the index, the same code must be executed. That is, data must be extracted separately from the updated documents and then the extracted data must be added to the index.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Separate data extraction

Path: /search/net/separate-data-extraction/

The feature described in this article makes it possible to separate the operations of extracting data from a document and adding the extracted data to the index. The extracted data can be easily serialized and deserialized as needed.

This feature can be useful because the operation of extracting text and other data from documents can be very long for some formats. At the same time, adding data to the index is a rather lightweight operation. And thus, separating these operations can lead to a significant increase in the total time when the index is not busy performing any operations. And the subsequent addition of new data extractors will significantly increase the performance of indexing. In this case, data extractors can even work on separate servers, completely freeing the indexing server from extracting operations.

The [Extractor](https://reference.groupdocs.com/search/net/groupdocs.search/extractor) class is used to extract data from documents. Upon completion of the operation, the [Extract](https://reference.groupdocs.com/search/net/groupdocs.search/extractor/methods/extract) method returns an instance of the [ExtractedData](https://reference.groupdocs.com/search/net/groupdocs.search.common/extracteddata) class, which is used directly to add to the index.

The following example demonstrates how to perform separate data extraction and indexing.

**C#**

```csharp
string indexFolder = @"c:\MyIndex";
string documentPath = @"c:\MyDocuments\MyDocument.pdf";

// Extracting data from a document
Extractor extractor = new Extractor();
Document document = Document.CreateFromFile(documentPath);
ExtractionOptions extractionOptions = new ExtractionOptions();
extractionOptions.UseRawTextExtraction = false;
ExtractedData extractedData = extractor.Extract(document, extractionOptions);

// Serializing the data
byte[] array = extractedData.Serialize();

// Deserializing the data
ExtractedData deserializedData = ExtractedData.Deserialize(array);

// Creating an index
Index index = new Index(indexFolder);

if (deserializedData.IsExtractionSuccessful)
{
    // Indexing the data
    ExtractedData[] data = new ExtractedData[]
    {
        deserializedData
    };
    index.Add(data, new IndexingOptions());

    // Searching in the index
    SearchResult result = index.Search("Einstein");
}
```

Note that when indexed documents change and need to be updated in the index, the same code must be executed. That is, data must be extracted separately from the updated documents and then the extracted data must be added to the index.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Separate data extraction

Path: /search/nodejs-java/separate-data-extraction/

The feature described in this article makes it possible to separate the operations of extracting data from a document and adding the extracted data to the index. The extracted data can be easily serialized and deserialized as needed.

This feature can be useful because the operation of extracting text and other data from documents can be very long for some formats. At the same time, adding data to the index is a rather lightweight operation. And thus, separating these operations can lead to a significant increase in the total time when the index is not busy performing any operations. And the subsequent addition of new data extractors will significantly increase the performance of indexing. In this case, data extractors can even work on separate servers, completely freeing the indexing server from extracting operations.

The [Extractor](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Extractor) class is used to extract data from documents. Upon completion of the operation, the extract method returns an instance of the [ExtractedData](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/ExtractedData) class, which is used directly to add to the index.

The following example demonstrates how to perform separate data extraction and indexing.

```javascript
const indexFolder = 'c:/MyIndex';
const documentPath = 'c:/MyDocuments/MyDocument.pdf';

// Extracting data from a document
const extractor = new groupdocs.search.Extractor();
const document = groupdocs.search.Document.createFromFile(documentPath);
const extractionOptions = new groupdocs.search.ExtractionOptions();
extractionOptions.setUseRawTextExtraction(false);
const extractedData = extractor.extract(document, extractionOptions);

// Serializing the data
const array1 = extractedData.serialize();
const array2 = [];
for (let i = 0; i < array1.length; i++) {
  array2[i] = array1[i];
}

// Deserializing the data
const buffer = java.newArray('byte', array2);
const deserializedData = groupdocs.search.ExtractedData.deserialize(buffer);

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Indexing the data
const data = java.newArray('com.groupdocs.search.ExtractedData', [deserializedData]);
index.add(data, new groupdocs.search.IndexingOptions());

// Searching in the index
const query = 'Einstein';
const result = index.search(query);
```

Note that when indexed documents change and need to be updated in the index, the same code must be executed. That is, data must be extracted separately from the updated documents and then the extracted data must be added to the index.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Specify OOXML Compliance Level for Word Documents

Path: /assembly/java/developer-guide/basic-usage/specify-ooxml-compliance/


## Overview

GroupDocs.Assembly for Java allows you to control the OOXML compliance level when saving Word documents to OOXML formats (DOCX, DOCM, DOTX, DOTM, FlatOpc, etc.). You can explicitly specify the compliance level or let the system automatically preserve the original document's compliance level.

The main classes involved are:
- [LoadSaveOptions](https://reference.groupdocs.com/assembly/java/groupdocs.assembly/loadsaveoptions/) - contains the OoxmlCompliance property
- [DocumentAssembler](https://reference.groupdocs.com/assembly/java/groupdocs.assembly/documentassembler/) - assembles documents with specified compliance

Here are the steps to specify OOXML compliance:

* Create LoadSaveOptions for your output format
* Set the OoxmlCompliance property to the desired compliance level (or leave null for automatic preservation)
* Use DocumentAssembler with the LoadSaveOptions to assemble the document
* The output document will be saved with the specified compliance level

{{< alert style="info" >}}
The OoxmlCompliance property only applies to OOXML formats (DOCX, DOCM, DOTX, DOTM, FlatOpc, etc.) and is ignored for other file formats. When set to null (default), the system automatically preserves the original document's compliance level if it was Transitional, otherwise uses Strict compliance.
{{< /alert >}}

## Available OOXML Compliance Levels

The `OoxmlCompliance` enumeration provides three compliance levels:

- **Ecma**: Specifies ECMA-376 compliance level
- **Transitional**: Specifies ISO/IEC 29500:2008 Transitional compliance level (commonly used for compatibility)
- **Strict**: Specifies ISO/IEC 29500:2008 Strict compliance level (fully compliant with the standard)

## Specify Explicit OOXML Compliance Level

You can explicitly set the OOXML compliance level when assembling a document:

```java
import com.groupdocs.assembly.*;

public static void specifyExplicitCompliance() throws Exception
{
    DocumentAssembler assembler = new DocumentAssembler();

    // Create LoadSaveOptions with explicit OOXML compliance
    LoadSaveOptions options = new LoadSaveOptions(FileFormat.DOCX);
    options.setOoxmlCompliance(OoxmlCompliance.STRICT); // or OoxmlCompliance.ECMA, OoxmlCompliance.TRANSITIONAL

    // Data object (Java has no anonymous types; use a POJO or Map)
    CompanyData data = new CompanyData();
    data.setCompanyName("ABC Corp");
    data.setYear(2026);

    assembler.assembleDocument("Template.docx", "Output.docx", options,
        new DataSourceInfo(data, "company"));
}

// Simple POJO for the data source (getters required for assembly engine)
static class CompanyData
{
    private String companyName;
    private int year;

    public String getCompanyName() { return companyName; }
    public void setCompanyName(String value) { this.companyName = value; }
    public int getYear() { return year; }
    public void setYear(int value) { this.year = value; }
}
```

## Use Transitional Compliance

For maximum compatibility with older Office versions, use Transitional compliance:

```java
import com.groupdocs.assembly;

public static void useTransitionalCompliance() throws Exception
{
    DocumentAssembler assembler = new DocumentAssembler();

    LoadSaveOptions options = new LoadSaveOptions(FileFormat.DOCX);
    options.setOoxmlCompliance(OoxmlCompliance.TRANSITIONAL);

    OrderData data = new OrderData();
    data.setCustomerName("John Doe");
    data.setOrderNumber("ORD-12345");

    assembler.assembleDocument("Template.docx", "Output.docx", options,
        new DataSourceInfo(data, "order"));
}

// POJO for the data source
static class OrderData
{
    private String customerName;
    private String orderNumber;

    public String getCustomerName() { return customerName; }
    public void setCustomerName(String value) { this.customerName = value; }
    public String getOrderNumber() { return orderNumber; }
    public void setOrderNumber(String value) { this.orderNumber = value; }
}
```

## Use Ecma Compliance

For ECMA-376 standard compliance:

```java
import com.groupdocs.assembly.*;

public static void useEcmaCompliance() throws Exception
{
    DocumentAssembler assembler = new DocumentAssembler();

    LoadSaveOptions options = new LoadSaveOptions(FileFormat.DOCX);
    options.setOoxmlCompliance(OoxmlCompliance.ECMA);

    ReportData data = new ReportData();
    data.setReportTitle("Monthly Report");
    data.setMonth("January 2026");

    assembler.assembleDocument("Template.docx", "Output.docx", options,
        new DataSourceInfo(data, "report"));
}

// POJO for the data source
static class ReportData
{
    private String reportTitle;
    private String month;

    public String getReportTitle() { return reportTitle; }
    public void setReportTitle(String value) { this.reportTitle = value; }
    public String getMonth() { return month; }
    public void setMonth(String value) { this.month = value; }
}
```

## Automatic Preservation of Original Compliance

When `OoxmlCompliance` is not explicitly set (default `null`), the system automatically preserves the original document's compliance level if it was Transitional:

```java
import com.groupdocs.assembly.*;

public static void preserveOriginalCompliance() throws Exception
{
    DocumentAssembler assembler = new DocumentAssembler();

    // OoxmlCompliance is null by default - original compliance will be preserved
    LoadSaveOptions options = new LoadSaveOptions(FileFormat.DOCX);
    // options.getOoxmlCompliance() is null - automatic preservation

    DocumentData data = new DocumentData();
    data.setTitle("Document Title");
    data.setContent("Document content");

    // Output document will maintain Transitional compliance from template if it was Transitional
    assembler.assembleDocument("Template_Transitional.docx", "Output.docx", options,
        new DataSourceInfo(data, "document"));
}

// POJO for the data source
static class DocumentData
{
    private String title;
    private String content;

    public String getTitle() { return title; }
    public void setTitle(String value) { this.title = value; }
    public String getContent() { return content; }
    public void setContent(String value) { this.content = value; }
}
```

## Using with Different OOXML Formats

The OoxmlCompliance property works with all OOXML formats:

```java
import com.groupdocs.assembly.*;

public static void useWithDifferentFormats() throws Exception
{
    DocumentAssembler assembler = new DocumentAssembler();

    ItemData data = new ItemData();
    data.setName("Test Document");
    data.setValue(100);

    // DOCX format
    LoadSaveOptions docxOptions = new LoadSaveOptions(FileFormat.DOCX);
    docxOptions.setOoxmlCompliance(OoxmlCompliance.STRICT);
    assembler.assembleDocument("Template.docx", "Output.docx", docxOptions,
        new DataSourceInfo(data, "item"));

    // DOCM format (macro-enabled)
    LoadSaveOptions docmOptions = new LoadSaveOptions(FileFormat.DOCM);
    docmOptions.setOoxmlCompliance(OoxmlCompliance.TRANSITIONAL);
    assembler.assembleDocument("Template.docm", "Output.docm", docmOptions,
        new DataSourceInfo(data, "item"));

    // DOTX format (template)
    LoadSaveOptions dotxOptions = new LoadSaveOptions(FileFormat.DOTX);
    dotxOptions.setOoxmlCompliance(OoxmlCompliance.STRICT);
    assembler.assembleDocument("Template.dotx", "Output.dotx", dotxOptions,
        new DataSourceInfo(data, "item"));
}

// POJO for the data source
static class ItemData
{
    private String name;
    private int value;

    public String getName() { return name; }
    public void setName(String value) { this.name = value; }
    public int getValue() { return value; }
    public void setValue(int value) { this.value = value; }
}
```

## Using with Streams

You can also specify OOXML compliance when working with streams:

```java
import com.groupdocs.assembly.*;
import java.io.*;

public static void useComplianceWithStreams() throws Exception
{
    DocumentAssembler assembler = new DocumentAssembler();

    LoadSaveOptions options = new LoadSaveOptions(FileFormat.DOCX);
    options.setOoxmlCompliance(OoxmlCompliance.STRICT);

    CompanyData data = new CompanyData();
    data.setCompany("My Company");
    data.setYear(2024);

    try (InputStream templateStream = new FileInputStream("Template.docx");
         OutputStream outputStream = new FileOutputStream("Output.docx"))
    {
        assembler.assembleDocument(templateStream, outputStream, options,
            new DataSourceInfo(data, "company"));
    }
}

// POJO for the data source
static class CompanyData
{
    private String company;
    private int year;

    public String getCompany() { return company; }
    public void setCompany(String value) { this.company = value; }
    public int getYear() { return year; }
    public void setYear(int value) { this.year = value; }
}
```

## Compliance Level Behavior

Understanding how compliance levels work:

- **When explicitly set**: The specified compliance level is used when saving to OOXML formats
- **When null (default)**: 
  - If the original document had Transitional compliance, it is preserved
  - Otherwise, Strict compliance is used
- **For non-OOXML formats**: The property is ignored (e.g., PDF, HTML, RTF)

```java
import com.groupdocs.assembly.*;

public static void demonstrateComplianceBehavior() throws Exception
{
    DocumentAssembler assembler = new DocumentAssembler();

    DocData data = new DocData();
    data.setTitle("Test");
    data.setContent("Content");

    // Explicit Strict compliance
    LoadSaveOptions strictOptions = new LoadSaveOptions(FileFormat.DOCX);
    strictOptions.setOoxmlCompliance(OoxmlCompliance.STRICT);
    assembler.assembleDocument("Template.docx", "Output_Strict.docx", strictOptions,
        new DataSourceInfo(data, "doc"));

    // Automatic preservation (null)
    LoadSaveOptions autoOptions = new LoadSaveOptions(FileFormat.DOCX);
    // autoOptions.getOoxmlCompliance() is null - will preserve if Transitional
    assembler.assembleDocument("Template.docx", "Output_Auto.docx", autoOptions,
        new DataSourceInfo(data, "doc"));

    // Note: For PDF output, OoxmlCompliance is ignored
    LoadSaveOptions pdfOptions = new LoadSaveOptions(FileFormat.PDF);
    pdfOptions.setOoxmlCompliance(OoxmlCompliance.STRICT); // Ignored for PDF
    assembler.assembleDocument("Template.docx", "Output.pdf", pdfOptions,
        new DataSourceInfo(data, "doc"));
}

// POJO for the data source
static class DocData
{
    private String title;
    private String content;

    public String getTitle() { return title; }
    public void setTitle(String value) { this.title = value; }
    public String getContent() { return content; }
    public void setContent(String value) { this.content = value; }
}
```

{{< alert style="warning" >}}
The OoxmlCompliance property only affects OOXML formats. When saving to other formats like PDF, HTML, or RTF, this property is ignored. The compliance level is determined by the output format, not the template format.
{{< /alert >}}

### Advanced Usage Topics

To learn more about format-specific options, document conversion settings, and advanced compliance handling, please refer to the [advanced usage section]({{< ref "assembly/java/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured Java library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Specify OOXML Compliance Level for Word Documents

Path: /assembly/net/basic-usage-ooxml-compliance/


## Overview

GroupDocs.Assembly for .NET allows you to control the OOXML compliance level when saving Word documents to OOXML formats (DOCX, DOCM, DOTX, DOTM, FlatOpc, etc.). You can explicitly specify the compliance level or let the system automatically preserve the original document's compliance level.

The main classes involved are:
- [LoadSaveOptions](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/loadsaveoptions/) - contains the OoxmlCompliance property
- [OoxmlCompliance](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/ooxmlcompliance/) - enumeration specifying compliance levels
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents with specified compliance

Here are the steps to specify OOXML compliance:

* Create LoadSaveOptions for your output format
* Set the OoxmlCompliance property to the desired compliance level (or leave null for automatic preservation)
* Use DocumentAssembler with the LoadSaveOptions to assemble the document
* The output document will be saved with the specified compliance level

{{< alert style="info" >}}
The OoxmlCompliance property only applies to OOXML formats (DOCX, DOCM, DOTX, DOTM, FlatOpc, etc.) and is ignored for other file formats. When set to null (default), the system automatically preserves the original document's compliance level if it was Transitional, otherwise uses Strict compliance.
{{< /alert >}}

## Available OOXML Compliance Levels

The `OoxmlCompliance` enumeration provides three compliance levels:

- **Ecma**: Specifies ECMA-376 compliance level
- **Transitional**: Specifies ISO/IEC 29500:2008 Transitional compliance level (commonly used for compatibility)
- **Strict**: Specifies ISO/IEC 29500:2008 Strict compliance level (fully compliant with the standard)

## Specify Explicit OOXML Compliance Level

You can explicitly set the OOXML compliance level when assembling a document:

```csharp
using GroupDocs.Assembly;

public static void SpecifyExplicitCompliance()
{
    DocumentAssembler assembler = new DocumentAssembler();

    // Create LoadSaveOptions with explicit OOXML compliance
    var options = new LoadSaveOptions(FileFormat.Docx);
    options.OoxmlCompliance = OoxmlCompliance.Strict; // or Ecma, Transitional

    var data = new { CompanyName = "ABC Corp", Year = 2024 };
    
    assembler.AssembleDocument("Template.docx", "Output.docx", options,
        new DataSourceInfo(data, "company"));
}
```

## Use Transitional Compliance

For maximum compatibility with older Office versions, use Transitional compliance:

```csharp
using GroupDocs.Assembly;

public static void UseTransitionalCompliance()
{
    DocumentAssembler assembler = new DocumentAssembler();

    var options = new LoadSaveOptions(FileFormat.Docx);
    options.OoxmlCompliance = OoxmlCompliance.Transitional;

    var data = new { CustomerName = "John Doe", OrderNumber = "ORD-12345" };
    
    assembler.AssembleDocument("Template.docx", "Output.docx", options,
        new DataSourceInfo(data, "order"));
}
```

## Use Ecma Compliance

For ECMA-376 standard compliance:

```csharp
using GroupDocs.Assembly;

public static void UseEcmaCompliance()
{
    DocumentAssembler assembler = new DocumentAssembler();

    var options = new LoadSaveOptions(FileFormat.Docx);
    options.OoxmlCompliance = OoxmlCompliance.Ecma;

    var data = new { ReportTitle = "Monthly Report", Month = "January 2024" };
    
    assembler.AssembleDocument("Template.docx", "Output.docx", options,
        new DataSourceInfo(data, "report"));
}
```

## Automatic Preservation of Original Compliance

When `OoxmlCompliance` is not explicitly set (default `null`), the system automatically preserves the original document's compliance level if it was Transitional:

```csharp
using GroupDocs.Assembly;

public static void PreserveOriginalCompliance()
{
    DocumentAssembler assembler = new DocumentAssembler();

    // OoxmlCompliance is null by default - original compliance will be preserved
    var options = new LoadSaveOptions(FileFormat.Docx);
    // options.OoxmlCompliance is null - automatic preservation

    var data = new { Title = "Document Title", Content = "Document content" };
    
    // Output document will maintain Transitional compliance from template if it was Transitional
    assembler.AssembleDocument("Template_Transitional.docx", "Output.docx", options,
        new DataSourceInfo(data, "document"));
}
```

## Using with Different OOXML Formats

The OoxmlCompliance property works with all OOXML formats:

```csharp
using GroupDocs.Assembly;

public static void UseWithDifferentFormats()
{
    DocumentAssembler assembler = new DocumentAssembler();
    var data = new { Name = "Test Document", Value = 100 };
    
    // DOCX format
    var docxOptions = new LoadSaveOptions(FileFormat.Docx);
    docxOptions.OoxmlCompliance = OoxmlCompliance.Strict;
    assembler.AssembleDocument("Template.docx", "Output.docx", docxOptions,
        new DataSourceInfo(data, "item"));
    
    // DOCM format (macro-enabled)
    var docmOptions = new LoadSaveOptions(FileFormat.Docm);
    docmOptions.OoxmlCompliance = OoxmlCompliance.Transitional;
    assembler.AssembleDocument("Template.docm", "Output.docm", docmOptions,
        new DataSourceInfo(data, "item"));
    
    // DOTX format (template)
    var dotxOptions = new LoadSaveOptions(FileFormat.Dotx);
    dotxOptions.OoxmlCompliance = OoxmlCompliance.Strict;
    assembler.AssembleDocument("Template.dotx", "Output.dotx", dotxOptions,
        new DataSourceInfo(data, "item"));
}
```

## Using with Streams

You can also specify OOXML compliance when working with streams:

```csharp
using GroupDocs.Assembly;
using System.IO;

public static void UseComplianceWithStreams()
{
    DocumentAssembler assembler = new DocumentAssembler();

    var options = new LoadSaveOptions(FileFormat.Docx);
    options.OoxmlCompliance = OoxmlCompliance.Strict;

    var data = new { Company = "My Company", Year = 2024 };
    
    using (FileStream templateStream = new FileStream("Template.docx", FileMode.Open))
    using (FileStream outputStream = new FileStream("Output.docx", FileMode.Create))
    {
        assembler.AssembleDocument(templateStream, outputStream, options,
            new DataSourceInfo(data, "company"));
    }
}
```

## Compliance Level Behavior

Understanding how compliance levels work:

- **When explicitly set**: The specified compliance level is used when saving to OOXML formats
- **When null (default)**: 
  - If the original document had Transitional compliance, it is preserved
  - Otherwise, Strict compliance is used
- **For non-OOXML formats**: The property is ignored (e.g., PDF, HTML, RTF)

```csharp
using GroupDocs.Assembly;

public static void DemonstrateComplianceBehavior()
{
    DocumentAssembler assembler = new DocumentAssembler();
    var data = new { Title = "Test", Content = "Content" };
    
    // Explicit Strict compliance
    var strictOptions = new LoadSaveOptions(FileFormat.Docx);
    strictOptions.OoxmlCompliance = OoxmlCompliance.Strict;
    assembler.AssembleDocument("Template.docx", "Output_Strict.docx", strictOptions,
        new DataSourceInfo(data, "doc"));
    
    // Automatic preservation (null)
    var autoOptions = new LoadSaveOptions(FileFormat.Docx);
    // autoOptions.OoxmlCompliance is null - will preserve if Transitional
    assembler.AssembleDocument("Template.docx", "Output_Auto.docx", autoOptions,
        new DataSourceInfo(data, "doc"));
    
    // Note: For PDF output, OoxmlCompliance is ignored
    var pdfOptions = new LoadSaveOptions(FileFormat.Pdf);
    pdfOptions.OoxmlCompliance = OoxmlCompliance.Strict; // Ignored for PDF
    assembler.AssembleDocument("Template.docx", "Output.pdf", pdfOptions,
        new DataSourceInfo(data, "doc"));
}
```

{{< alert style="warning" >}}
The OoxmlCompliance property only affects OOXML formats. When saving to other formats like PDF, HTML, or RTF, this property is ignored. The compliance level is determined by the output format, not the template format.
{{< /alert >}}

### Advanced Usage Topics

To learn more about format-specific options, document conversion settings, and advanced compliance handling, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Signing archive documents in batch

Path: /signature/java/signing-archive-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/java) supports signing archive files with formats like ZIP, TAR the same way as usual documents. The only difference in the [SignResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/) of the [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/#sign-java.io.OutputStream-com.groupdocs.signature.options.sign.SignOptions-) method will contain for archive files the lists of [Succeeded](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/#getSucceeded--) and [Failed](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/#getFailed--/) of the [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/#sign-java.io.OutputStream-com.groupdocs.signature.options.sign.SignOptions-) method will contain for archive files the lists of [Succeeded](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/#getSucceeded--) signatures as the  
list of the [DocumentResultSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/documentresultsignature/) instances.

Here are the steps to sign the archive files like ZIP, TAR with GroupDocs.Signature:

* Create a new instance of [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/) class and pass the source archive path or stream of the archive as a constructor parameter.
* Instantiate the single [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/signoptions/) object or list of this class with the required options.
* Call [Sign](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/#sign-java.io.OutputStream-com.groupdocs.signature.options.sign.SignOptions-) method of  [Signature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature/signature/) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.options.sign/signoptions/) to it.
* The passed signature options will be applied to the all documents within the archive.
* Analyze response [SignResult](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/) over the properties [Succeeded](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/#getSucceeded--) and [Failed](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain/signresult/#getFailed--) signatures as the instances of the [DocumentResultSignature](https://reference.groupdocs.com/signature/java/com.groupdocs.signature.domain.signatures/documentresultsignature/)

## Sign archive document

This example shows how to sign archive document with few SignOptions.

```java
    /**
     * <p>
     * Sign ZIP Documents with varios signature options
     * </p>
     */
Signature signature = new Signature("sample.zip");
{
    // create sign options
    TextSignOptions options = new TextSignOptions("signed!");
    {
        // set signature position
        options.setLeft(100);
        options.setTop(100);
    };
    // sign archive to new zip file
    SignResult result = signature.sign("output.zip", options);
    // analyze signed documents
     for (BaseSignature o : signResult.getSucceeded())
    {
        DocumentResultSignature document = (DocumentResultSignature)o;
        System.out.print("Document #"+ number++ +": "+document.getFileName()+". Processed: "+document.getProcessingTime()+", mls");
    }
    if (signResult.getFailed().size() > 0)
    {
        System.out.print("\nList of failed documents:");
        number = 1;
        for (BaseSignature o : signResult.getFailed())
        {
            DocumentResultSignature document = (DocumentResultSignature)o;
            System.out.print("Document #"+number++ +": "+document.getFileName()+". Processed: "+document.getProcessingTime()+", mls");
        }
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online App

Along with full-featured .NET library we provide simple, but powerful free Apps.

You are welcome to eSign PDF, Word, Excel, PowerPoint documents with free to use online **[GroupDocs Signature App](https://products.groupdocs.app/signature)**.

---

## Signing archive documents in batch

Path: /signature/net/signing-archive-documents/

[**GroupDocs.Signature**](https://products.groupdocs.com/signature/net) supports signing archive files with formats like ZIP, TAR, 7Z, LZ, GZIP the same way as usual documents. The only difference in the [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult/) of the [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method will contain for archive files the lists of [Succeeded](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult/succeeded) and [Failed](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult/failed) signatures as the list of the [DocumentResultSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/documentresultsignature/) instances.

Here are the steps to sign the archive files like ZIP, TAR, 7z, LZ, GZIP with GroupDocs.Signature:

* Create a new instance of [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class and pass the source archive path or stream of the archive as a constructor parameter.
* Instantiate the single [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) object or list of this class with the required options.
* Call [Sign](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature/sign/) method of  [Signature](https://reference.groupdocs.com/signature/net/groupdocs.signature/signature) class instance and pass [SignOptions](https://reference.groupdocs.com/signature/net/groupdocs.signature.options/signoptions) to it.
* The passed signature options will be applied to the all documents within the archive.
* Analyze response [SignResult](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult/) over the properties [Succeeded](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult/succeeded) and [Failed](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/signresult/failed) signatures as the instances of the [DocumentResultSignature](https://reference.groupdocs.com/signature/net/groupdocs.signature.domain/documentresultsignature/)

## Sign archive document

This example shows how to sign archive document with few SignOptions.

```csharp
/// <summary>
/// Support Succeeded and Failed list as result of processing archives
/// </summary>
using (var signature = new Signature("sample.zip"))
{
    // create sign options
    var options = new TextSignOptions("signed!")
    {
        // set signature position
        Left = 100,
        Top = 100
    };
    // sign archive to new zip file
    SignResult result = signature.Sign("output.zip", options);
    // analyze signed documents
    foreach (DocumentResultSignature document in result.Succeeded)
    {
        Console.WriteLine($"Document {document.FileName}. Processed: {document.ProcessingTime}, mls");
    }
    if (signResult.Failed.Count > 0)
    {
        Console.WriteLine("\nList of failed documents:");
        number = 1;
        foreach (DocumentResultSignature document in result.Failed)
        {
            Console.WriteLine($"Document {document.FileName}. Processed: {document.ProcessingTime}, mls");
        }
    }
}
```

## Sign single-file archive documents
LZ and GZIP formats compress individual files into single-file archives, optimizing them for storage and transmission.

{{< alert style="note" >}}
The name of the archive file should match the name of the file contained.
{{< /alert >}}

This example shows how to sign GZIP archive document with SignOptions.

```csharp
using (Signature signature = new Signature("sample.pdf.gz"))
{
    // create sign options
    TextSignOptions options = new TextSignOptions("signed!")
    {
        // set signature position
        Left = 100,
        Top = 100
    };
    // sign archive to new zip file
    SignResult result = signature.Sign("output.pdf.gz", options);
    // analyze signed documents
    foreach (DocumentResultSignature document in result.Succeeded)
    {
        Console.WriteLine($"Document {document.FileName}. Processed: {document.ProcessingTime}, mls");
    }
}
```

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Signature for .NET examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET)
* [GroupDocs.Signature for Java examples, plugins, and showcase](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java)
* [Document Signature for .NET MVC UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-MVC)
* [Document Signature for .NET App WebForms UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-.NET-WebForms)
* [Document Signature for Java App Dropwizard UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Dropwizard)
* [Document Signature for Java Spring UI Example](https://github.com/groupdocs-signature/GroupDocs.Signature-for-Java-Spring)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the **[GroupDocs.Signature App Product Family](https://products.groupdocs.app/signature/family)**.

---

## Convert to Page Description Language formats with advanced options

Path: /conversion/net/convert-to-page-description-language-with-advanced-options/


GroupDocs.Conversion provides the [PageDescriptionLanguageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pagedescriptionlanguageconvertoptions) class to specify Page Description Language (PDL) file format conversion settings. This class implements [IPagedConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions), [IPageRangedConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagerangedconvertoptions), and [IWatermarkedConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/iwatermarkedconvertoptions) for page selection, page range specification, and watermark support.

## Supported Page Description Language Formats

The following PDL (Page Description Language) formats are supported:

| Format | Extension | Description |
|--------|-----------|-------------|
| **SVG** | .svg | Scalable Vector Graphics (XML-based vector format) |
| **SVGZ** | .svgz | Compressed SVG using GZIP |
| **XPS** | .xps | XML Paper Specification (Microsoft) |
| **OXPS** | .oxps | Open XML Paper Specification |
| **EPS** | .eps | Encapsulated PostScript |
| **PS** | .ps | PostScript Document |
| **PCL** | .pcl | Printer Command Language (HP) |
| **TEX** | .tex | LaTeX Source Document |
| **CGM** | .cgm | Computer Graphics Metafile |

## Properties

**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired PDL file format. Available options are: *Svg, Svgz, Xps, Oxps, Eps, Ps, Pcl, Tex, Cgm*.

**[Width](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pagedescriptionlanguageconvertoptions/width)** - Sets the desired page width in pixels.

**[Height](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pagedescriptionlanguageconvertoptions/height)** - Sets the desired page height in pixels.

**[PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagenumber)** - Specifies the starting page number for conversion.

**[PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagescount)** - Specifies the number of pages to convert.

**[Pages](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagerangedconvertoptions/pages)** - Specifies a list of specific page numbers to convert.

**[Watermark](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/iwatermarkedconvertoptions/watermark)** - Applies a watermark to the converted document.

## Conversion Examples

PageDescriptionLanguageConvertOptions supports conversion between PDL formats. The following examples demonstrate common conversions.

### XPS to SVG

Convert an XPS document to SVG (Scalable Vector Graphics):

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "document.xps";
string outputFile = "document.svg";

using (var converter = new Converter(sourceFile))
{
    var options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Svg
    };
    converter.Convert(outputFile, options);
}
```

### EPS to XPS

Convert an EPS (Encapsulated PostScript) file to XPS:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "illustration.eps";
string outputFile = "illustration.xps";

using (var converter = new Converter(sourceFile))
{
    var options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Xps
    };
    converter.Convert(outputFile, options);
}
```

### PostScript to SVG

Convert a PostScript (PS) file to SVG:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "print-file.ps";
string outputFile = "print-file.svg";

using (var converter = new Converter(sourceFile))
{
    var options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Svg
    };
    converter.Convert(outputFile, options);
}
```

## Custom Dimensions

Control output page dimensions using Width and Height properties:

### Using Custom Page Dimensions

Define custom page width and height in pixels:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "technical-diagram.xps";
string outputFile = "technical-diagram.svg";

using (var converter = new Converter(sourceFile))
{
    var options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Svg,
        Width = 800,   // Width in pixels
        Height = 600   // Height in pixels
    };
    converter.Convert(outputFile, options);
}
```

## Watermark Support

Add text or image watermarks to converted documents:

### Adding Text Watermark

Apply a text watermark to the converted document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "confidential.xps";
string outputFile = "confidential.svg";

using (var converter = new Converter(sourceFile))
{
    var options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Svg,
        Watermark = new WatermarkTextOptions("CONFIDENTIAL")
        {
            Color = System.Drawing.Color.Red,
            Width = 200,
            Height = 50,
            Top = 100,
            Left = 100
        }
    };
    converter.Convert(outputFile, options);
}
```

## Format Support Notes

PDL to PDL conversions are supported for most format combinations:
- XPS → SVG, EPS, PS, PCL, TEX
- EPS → SVG, XPS, PS, PCL, TEX
- PS → SVG, XPS, EPS, PCL, TEX
- SVG → XPS, EPS, PS, PCL, TEX
- TEX → SVG, XPS, EPS, PS, PCL
- PCL → SVG, XPS, EPS, PS, TEX

**Note:** To convert FROM PDL formats to PDF or images, use [PdfConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-pdf-with-advanced-options.md" >}}) or [ImageConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-image-with-advanced-options.md" >}}).

## More Resources

- [API Reference: PageDescriptionLanguageConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pagedescriptionlanguageconvertoptions)
- [API Reference: PageDescriptionLanguageFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/pagedescriptionlanguagefiletype)
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})

---

## Disable image comparison in PDF documents

Path: /comparison/net/disable-image-comparison-in-pdf-documents/


---

[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to disable image comparison in PDF documents.

By default, the CompareImagesPdf option is `true`. Follow these steps to turn off image comparison:

1.  Instantiate the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) object. Specify the source file path or stream.
2.  Call the [Add](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer/methods/add/index) method. Specify the target file path or stream.
3.  Instantiate the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object. Set the [CompareImagesPdf](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/compareimagespdf) property to `false`;
3.  Set the [ImagesInheritanceMode](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions/properties/imagesinheritancemode) property to `ImagesInheritance.Source` or `ImagesInheritance.Target`;
4.  Call the [Comparer](https://reference.groupdocs.com/comparison/net/groupdocs.comparison/comparer) method. Specify the [CompareOptions](https://reference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) object from the previous step.

The following code snippet shows how to disable image comparison in PDF documents:

{{< tabs "example1">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
// ...

using (Comparer comparer = new Comparer("source.pdf"))
{
    comparer.Add("target.pdf");
    CompareOptions compareOptions = new CompareOptions()
    {
        CompareImagesPdf = false,
        ImagesInheritanceMode = ImagesInheritance.Target
    }
    comparer.Compare("result.pdf", compareOptions);
}
```
{{< /tab >}}
{{< /tabs >}}

The result is as follows:

![](/comparison/net/images/disable-image-comparison-in-pdf-documents.png)

---

## Disable image comparison in PDF documents

Path: /comparison/python-net/disable-image-comparison-in-pdf-documents/


[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) can turn off image comparison in PDFs when you only care about text changes.

## Disable image comparison for PDFs

Set `compare_images_pdf` to `False` and choose image inheritance behavior.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.pdf") as comparer:
    comparer.add("target.pdf")
    options = gc.CompareOptions()
    options.compare_images_pdf = False
    options.images_inheritance_mode = gc.ImagesInheritance.TARGET
    comparer.compare("result.pdf", options)
```

🔹 Use case: Speed up PDF comparisons and avoid noise from embedded graphics.

The result is as follows:

![](/comparison/python-net/images/disable-image-comparison-in-pdf-documents.png)



---

## Generate document pages preview

Path: /comparison/python-net/generate-document-pages-preview/


Use GroupDocs.Comparison to render lightweight page images for quick previews.

```python
import groupdocs.comparison as gc

def save_page_callback(page_number: int, stream):
    with open(f"page-{page_number}.png", "wb") as f:
        f.write(stream.read())

with gc.Comparer("source.docx") as comparer:
    preview_options = gc.PreviewOptions(save_page_callback)
    preview_options.preview_format = gc.PreviewFormats.PNG
    preview_options.page_numbers = [1, 2, 3]

    comparer.get_pages(preview_options)
```

You can choose output format (PNG/JPEG), control resolution, and render only selected pages.

🔹 Use case: Generate thumbnails for a review dashboard without downloading full documents.



---

## Insert Images Dynamically

Path: /assembly/net/basic-usage-generate-images/


## Overview

GroupDocs.Assembly for .NET allows you to insert images dynamically into documents using image tags. Images can be loaded from file paths, URLs, streams, byte arrays, or Base64-encoded strings, making it easy to include dynamic images in your reports.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources

Here are the steps to insert images dynamically:

* Add a textbox to your template at the location where you want the image
* Set the textbox size and appearance to match desired image dimensions
* Insert an image tag `<<image [expression]>>` within the textbox
* Provide image data from file path, URL, stream, or byte array
* Assemble the document

{{< alert style="info" >}}
Image tags are replaced with actual images during document assembly. The textbox acts as a placeholder and container for the image.
{{< /alert >}}

## Insert Image from File Path

Insert an image from a file path:

```csharp
using GroupDocs.Assembly;

public class Product
{
    public string Name { get; set; }
    public string ImagePath { get; set; }
}

public static void InsertImageFromFilePath()
{
    // Sample data with image path
    var product = new Product
    {
        Name = "Laptop",
        ImagePath = @"C:\Images\laptop.jpg"
    };
    
    // Assemble document
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ImageTemplate.docx", "ImageOutput.docx", 
        new DataSourceInfo(product, "product"));
    
    Console.WriteLine("Image inserted from file path successfully.");
}
```

## Template Structure for Images

In your template (ImageTemplate.docx):

1. Insert a textbox where you want the image
2. Set the textbox size (width and height)
3. Add the image tag inside the textbox:

```
Product: <<[product.Name]>>

[Textbox with image tag:]
<<image [product.ImagePath]>>
```

## Insert Image from URL

Insert an image from a URL:

```csharp
using GroupDocs.Assembly;

public class Product
{
    public string Name { get; set; }
    public string ImageUrl { get; set; }
}

public static void InsertImageFromUrl()
{
    var product = new Product
    {
        Name = "Laptop",
        ImageUrl = "https://example.com/images/laptop.jpg"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ImageTemplate.docx", "ImageOutput.docx", 
        new DataSourceInfo(product, "product"));
    
    Console.WriteLine("Image inserted from URL successfully.");
}
```

Template:

```
Product: <<[product.Name]>>

[Textbox:]
<<image [product.ImageUrl]>>
```

## Insert Image from Byte Array

Insert an image from binary data:

```csharp
using GroupDocs.Assembly;
using System.IO;

public class Product
{
    public string Name { get; set; }
    public byte[] ImageData { get; set; }
}

public static void InsertImageFromByteArray()
{
    // Load image into byte array
    byte[] imageBytes = File.ReadAllBytes(@"C:\Images\laptop.jpg");
    
    var product = new Product
    {
        Name = "Laptop",
        ImageData = imageBytes
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ImageTemplate.docx", "ImageOutput.docx", 
        new DataSourceInfo(product, "product"));
    
    Console.WriteLine("Image inserted from byte array successfully.");
}
```

Template:

```
Product: <<[product.Name]>>

[Textbox:]
<<image [product.ImageData]>>
```

## Insert Image from Stream

Insert an image from a stream:

```csharp
using GroupDocs.Assembly;
using System.IO;

public class Product
{
    public string Name { get; set; }
    public Stream ImageStream { get; set; }
}

public static void InsertImageFromStream()
{
    using (FileStream imageStream = new FileStream(@"C:\Images\laptop.jpg", FileMode.Open))
    {
        var product = new Product
        {
            Name = "Laptop",
            ImageStream = imageStream
        };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument("ImageTemplate.docx", "ImageOutput.docx", 
            new DataSourceInfo(product, "product"));
        
        Console.WriteLine("Image inserted from stream successfully.");
    }
}
```

## Image Sizing Options

Control how images are sized within textboxes:

```csharp
using GroupDocs.Assembly;

public static void InsertImageWithSizing()
{
    var product = new Product
    {
        Name = "Laptop",
        ImagePath = @"C:\Images\laptop.jpg"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ImageTemplate.docx", "ImageOutput.docx", 
        new DataSourceInfo(product, "product"));
    
    Console.WriteLine("Image inserted with sizing options.");
}
```

Template sizing options:

- `<<image [product.ImagePath]>>` - Stretch to fill textbox (default)
- `<<image [product.ImagePath] -keepRatio>>` - Keep aspect ratio within textbox
- `<<image [product.ImagePath] -fitHeight>>` - Fit to textbox height
- `<<image [product.ImagePath] -fitWidth>>` - Fit to textbox width
- `<<image [product.ImagePath] -fitSize>>` - Resize textbox to image size
- `<<image [product.ImagePath] -fitSizeLim>>` - Resize textbox up to image size

## Insert Multiple Images from Collection

Insert images for each item in a collection:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void InsertImagesFromCollection()
{
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", ImagePath = @"C:\Images\laptop.jpg" },
        new Product { Name = "Mouse", ImagePath = @"C:\Images\mouse.jpg" }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ImagesTemplate.docx", "ImagesOutput.docx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Images inserted from collection successfully.");
}
```

Template with foreach:

```
<<foreach [in products]>>
Product: <<[Name]>>

[Textbox:]
<<image [ImagePath]>>

<</foreach>>
```

{{< alert style="warning" >}}
If an image expression returns a stream, the stream is automatically closed by the assembler after the image is loaded. Do not dispose the stream manually.
{{< /alert >}}

### Advanced Usage Topics

To learn more about image formatting, Base64-encoded images, image optimization, and advanced image handling, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Load compression document with options

Path: /conversion/net/load-compression-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [CompressionLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/compressionloadoptions) to control how source compression files are processed. Compression files include formats like ZIP, 7Z, RAR, TAR, GZIP, and other archive formats.

The following options are available:

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/compressionloadoptions/format)** | The document type is auto-detected during loading, but you can explicitly specify the source format. Available options include: *SevenZ, Bz2, Cab, Cpio, Gz, Gzip, Lz, Lzma, Rar, Tar, Xz, Z, Zip* |
|**[Password](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/compressionloadoptions/password)** | Set password to load protected archive |
|**[ConvertOwned](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/compressionloadoptions/convertowned)** | The owned documents will be converted (read-only, set to true by default) |
|**[ConvertOwner](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/compressionloadoptions/convertowner)** | The owner will not be converted (read-only, set to false by default) |
|**[Depth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/compressionloadoptions/depth)** | Controls recursion depth for nested documents. Default value is 3. |

## Load ZIP archive

The following code snippet shows how to load a ZIP archive with explicit format specification:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CompressionLoadOptions
{
    Format = CompressionFileType.Zip
};

using (Converter converter = new Converter("documents-archive.zip", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("documents-archive.pdf", options);
}
```

## Load RAR archive

The following code snippet shows how to load a RAR archive:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CompressionLoadOptions
{
    Format = CompressionFileType.Rar
};

using (Converter converter = new Converter("backup-files.rar", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("backup-files.pdf", options);
}
```

## Load 7Z archive

The following code snippet shows how to load a 7Z archive:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CompressionLoadOptions
{
    Format = CompressionFileType.SevenZ
};

using (Converter converter = new Converter("project-files.7z", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("project-files.pdf", options);
}
```

## Convert between compression formats

The following code snippet shows how to convert from ZIP to 7Z format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CompressionLoadOptions
{
    Format = CompressionFileType.Zip
};

using (Converter converter = new Converter("source-archive.zip", getLoadOptions))
{
    CompressionConvertOptions options = new CompressionConvertOptions
    {
        Format = CompressionFileType.SevenZ
    };
    converter.Convert("source-archive.7z", options);
}
```

## Load password-protected archive

The following code snippet shows how to load a password-protected ZIP archive:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new CompressionLoadOptions
{
    Format = CompressionFileType.Zip,
    Password = "archive-password"
};

using (Converter converter = new Converter("protected-archive.zip", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("protected-archive.pdf", options);
}
```

---

## Merge images

Path: /merger/net/merge/images/


## How to merge image files in C\#

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to combine multiple JPG documents in the preferred order and save them as a single file. You will not spend your time doing these operations manually on desktop software.
 With GroupDocs.Merger it is possible to combine image documents of any JPG, PNG or BMP extensions.

The following example demonstrates how to merge image files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source image file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Create an instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class and pass enum value of [ImageJoinMode](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinmode) as a constructor parameter.
* Add another image file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method and pass instance of [ImageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/imagejoinoptions) class as a method parameter. Repeat this step for other image documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged image file as parameter.

```csharp
// Load the source image file
using (Merger merger = new Merger(@"c:\sample1.jpg"))
{
    // Define image join options with vertical join mode
    ImageJoinOptions joinOptions = new ImageJoinOptions(ImageJoinMode.Vertical);
    // Add another image file to merge
    merger.Join(@"c:\sample2.jpg", joinOptions);
    // Merge image files and save result
    merger.Save(@"c:\merged.jpg");
}
```

### Merge different image file formats

This section describes how to merge different image file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge JPG images in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-jpg-images-using-csharp.md" >}})
* [How to merge PNG images in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-png-images-using-csharp.md" >}})
* [How to merge BMP images in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-bmp-images-using-csharp.md" >}})
* [How to merge TIF images in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-tif-images-using-csharp.md" >}})
* [How to merge GIF images in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-gif-images-using-csharp.md" >}})
* [How to merge TIFF images in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-tiff-images-using-csharp.md" >}})

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge Images Live Demo

GroupDocs.Merger offers the following free online tools to test its quality and accuracy:
* [**JPG Merger App**](https://products.groupdocs.app/merger/jpg)
* [**PNG Merger App**](https://products.groupdocs.app/merger/png)
* [**BMP Merger App**](https://products.groupdocs.app/merger/bmp)
* [**GIF Merger App**](https://products.groupdocs.app/merger/gif)
* [**TIFF Merger App**](https://products.groupdocs.app/merger/tiff)
---

## Search for different word forms

Path: /search/java/search-for-different-word-forms/

The search for different word forms allows you to search for nouns in the singular or plural, adjectives in the degree of comparison, forms of regular and irregular verbs, etc.

Search for different word forms is enabled if the [setUseWordFormsSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setUseWordFormsSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class is called with the true value as an argument. By default, the search for different word forms is disabled.

To generate various forms of words, a class that implements the [IWordFormsProvider](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface is used. The default class is [EnglishWordFormsProvider](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/EnglishWordFormsProvider), which supports English-only word forms. To add support for word forms in other languages, see the [Word forms provider]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/word-forms-provider.md" >}}) page.

The following example demonstrates how to perform search for different word forms in an index.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.setUseWordFormsSearch(true); // Enabling search for word forms
 
// Searching in the index
SearchResult result = index.search("relative", options);
 
// The following words can be found:
// relative
// relatives
// relatively
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search for different word forms

Path: /search/net/search-for-different-word-forms/

The search for different word forms allows you to search for nouns in the singular or plural, adjectives in the degree of comparison, forms of regular and irregular verbs, etc.

Search for different word forms is enabled if the [UseWordFormsSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/usewordformssearch) property of the [SearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions) class is set to true. By default, the search for different word forms is disabled.

To generate various forms of words, a class that implements the [IWordFormsProvider](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/iwordformsprovider) interface is used. The default class is [EnglishWordFormsProvider](https://reference.groupdocs.com/net/search/groupdocs.search.dictionaries/englishwordformsprovider), which supports English-only word forms. To add support for word forms in other languages, see the [Word forms provider]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/word-forms-provider.md" >}}) page.

The following example demonstrates how to perform search for different word forms in an index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.UseWordFormsSearch = true; // Enabling search for word forms
 
// Searching in the index
SearchResult result = index.Search("relative", options);
 
// The following words can be found:
// relative
// relatives
// relatively
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search for different word forms

Path: /search/nodejs-java/search-for-different-word-forms/

The search for different word forms allows you to search for nouns in the singular or plural, adjectives in the degree of comparison, forms of regular and irregular verbs, etc.

Search for different word forms is enabled if the [setUseWordFormsSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setUseWordFormsSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class is called with the true value as an argument. By default, the search for different word forms is disabled.

To generate various forms of words, a class that implements the [IWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/IWordFormsProvider) interface is used. The default class is [EnglishWordFormsProvider](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.dictionaries/EnglishWordFormsProvider), which supports English-only word forms. To add support for word forms in other languages, see the [Word forms provider]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/word-forms-provider.md" >}}) page.

The following example demonstrates how to perform search for different word forms in an index.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Creating a search options instance
const options = new groupdocs.search.SearchOptions();
options.setUseWordFormsSearch(true); // Enabling search for word forms

// Searching in the index
const query = 'wished';
const result = index.search(query, options);

// The following words can be found:
// wished
// wish
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search for text containing special characters

Path: /search/java/search-for-text-containing-special-characters/

In the case where the search query must contain special characters that are not control characters, these characters must be escaped.
The special characters are:
<pre>
( ) : " & | ! ^ ~ * ? \ <i>space</i>
</pre>
These characters can be escaped by adding a \\ sign to the left of the character. For example:  
\\& - escaping & character;  
\\~ - escaping ~ character;  
\\s - escaping space character.  
See [Search operation table]({{< ref "search/java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}) for detailes on search query syntax.

However, it must be remembered that if the escaped character is a separator, then it will still not be found in the text, since it is not indexed. And as a result, words containing such characters will also not be found when searching for an exact match.

If the search query contains separator characters, words containing these characters will not be found. Since, in fact, when indexing, these characters break the word into parts, and they themselves are deleted and not indexed.
Therefore, when performing a search, the query must be checked for the content of separator characters. Each word containing such characters should be broken into several smaller words and form a search phrase.

The order of processing each word in a search query is as follows:
1. If separators are present in the word, they are replaced by spaces, and the word search is converted to a phrase search.
2. If special characters are present in the word, they are escaped.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Setting character types
index.getDictionaries().getAlphabet().setRange(new char[] { '&' }, CharacterType.Letter);
index.getDictionaries().getAlphabet().setRange(new char[] { '-' }, CharacterType.Separator);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Defining a search query
String word = "rock&roll-music";

// Replacing separators with the space characters
StringBuilder result = new StringBuilder();
for (int i = 0; i < word.length(); i++) {
    char character = word.charAt(i);
    CharacterType characterType = index.getDictionaries().getAlphabet().getCharacterType(character);
    if (characterType == CharacterType.Separator) {
        result.append(' ');
    } else {
        result.append(character);
    }
}

// Escaping special characters
String specialCharacters = "():\"&|!^~*?\\";
for (int i = result.length() - 1; i >= 0; i--) {
    char c = result.charAt(i);
    if (specialCharacters.indexOf(c) != -1) {
        result.insert(i, '\\');
    }
}

String query = result.toString();
if (query.contains(" ")) {
    query = "\"" + query + "\"";
}

// Searching
SearchResult searchResult = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search for text containing special characters

Path: /search/net/search-for-text-containing-special-characters/

In the case where the search query must contain special characters that are not control characters, these characters must be escaped.
The special characters are:
<pre>
( ) : " & | ! ^ ~ * ? \ <i>space</i>
</pre>
These characters can be escaped by adding a \\ sign to the left of the character. For example:  
\\& - escaping & character;  
\\~ - escaping ~ character;  
\\s - escaping space character.  
See [Search operation table]({{< ref "search/net/developer-guide/advanced-usage/searching/search-operation-table.md" >}}) for detailes on search query syntax.

However, it must be remembered that if the escaped character is a separator, then it will still not be found in the text, since it is not indexed. And as a result, words containing such characters will also not be found when searching for an exact match.

If the search query contains separator characters, words containing these characters will not be found. Since, in fact, when indexing, these characters break the word into parts, and they themselves are deleted and not indexed.
Therefore, when performing a search, the query must be checked for the content of separator characters. Each word containing such characters should be broken into several smaller words and form a search phrase.

The order of processing each word in a search query is as follows:
1. If separators are present in the word, they are replaced by spaces, and the word search is converted to a phrase search.
2. If special characters are present in the word, they are escaped.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Setting character types
index.Dictionaries.Alphabet.SetRange(new char[] { '&' }, CharacterType.Letter);
index.Dictionaries.Alphabet.SetRange(new char[] { '-' }, CharacterType.Separator);

// Indexing documents from the specified folder
index.Add(documentsFolder);

// Defining a search query
string word = "rock&roll-music";

// Replacing separators with the space characters
StringBuilder result = new StringBuilder();
for (int i = 0; i < word.Length; i++)
{
    char character = word[i];
    CharacterType characterType = index.Dictionaries.Alphabet.GetCharacterType(character);
    if (characterType == CharacterType.Separator)
    {
        result.Append(' ');
    }
    else
    {
        result.Append(character);
    }
}

// Escaping special characters
const string specialCharacters = "():\"&|!^~*?\\";
for (int i = result.Length - 1; i >= 0; i--)
{
    char c = result[i];
    if (specialCharacters.Contains(c.ToString()))
    {
        result.Insert(i, '\\');
    }
}

string query = result.ToString();
if (query.Contains(" "))
{
    query = "\"" + query + "\"";
}

// Searching
SearchResult searchResult = index.Search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search for text containing special characters

Path: /search/nodejs-java/search-for-text-containing-special-characters/

In the case where the search query must contain special characters that are not control characters, these characters must be escaped.
The special characters are:
<pre>
( ) : " & | ! ^ ~ * ? \ <i>space</i>
</pre>
These characters can be escaped by adding a \\ sign to the left of the character. For example:  
\\& - escaping & character;  
\\~ - escaping ~ character;  
\\s - escaping space character.  
See [Search operation table]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-operation-table.md" >}}) for detailes on search query syntax.

However, it must be remembered that if the escaped character is a separator, then it will still not be found in the text, since it is not indexed. And as a result, words containing such characters will also not be found when searching for an exact match.

If the search query contains separator characters, words containing these characters will not be found. Since, in fact, when indexing, these characters break the word into parts, and they themselves are deleted and not indexed.
Therefore, when performing a search, the query must be checked for the content of separator characters. Each word containing such characters should be broken into several smaller words and form a search phrase.

The order of processing each word in a search query is as follows:
1. If separators are present in the word, they are replaced by spaces, and the word search is converted to a phrase search.
2. If special characters are present in the word, they are escaped.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Setting character types
const characters1 = java.newArray('char', ['&']);
const characters2 = java.newArray('char', ['-']);
index.getDictionaries().getAlphabet().setRange(characters1, groupdocs.search.CharacterType.Letter);
index.getDictionaries().getAlphabet().setRange(characters2, groupdocs.search.CharacterType.Separator);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Defining a search query
const word = 'rock&roll-music';

// Replacing separators with the space characters
let result = '';
for (let i = 0; i < word.length; i++) {
  const character = word.charAt(i);
  const ch = java.newChar(character);
  const characterType = index.getDictionaries().getAlphabet().getCharacterType(ch);
  if (String(characterType) == String(groupdocs.search.CharacterType.Separator)) {
    result += ' ';
  } else {
    result += character;
  }
}

// Escaping special characters
const specialCharacters = '():"&|!^~*?\\';
for (let i = result.length - 1; i >= 0; i--) {
  const c = result.charAt(i);
  if (specialCharacters.indexOf(c) != -1) {
    result = result.slice(0, i) + '\\' + result.slice(i);
  }
}

let query = result.toString();
if (query.includes(' ')) {
  query = '"' + query + '"';
}

// Searching
const searchResult = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search network deployment

Path: /search/java/search-network-deployment/

The GroupDocs.Search search network consists of one master node and several slave nodes. Each node is a hardware server with the Java platform deployed on it. Inside the Java platform, an application is deployed that creates an instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/) class.

An instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/) class provides the services described in the configuration:
 - Indexing service;
 - Search services;
 - Extraction services;
 - Shard services.

Indexing and search services also provide an interface to access all search network features.

To deploy the GroupDocs.Search search network, you must perform the following steps:
 - On each slave server, create an instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/) class, call the [start](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/#start--) method.
 - On the master server, create an instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/) class, passing the configuration object to the constructor.
 - Call the [configureAllNodes](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/#configureAllNodes--) method of the [SearchNetworkNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/) object on the master server.
 - Call the [start](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/#start--) method of the [SearchNetworkNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/) object on the master server.

The following code example demonstrates starting a slave node on the server.

```java
SearchNetworkNode node1 = new SearchNetworkNode(
    1,
    basePath + "Node1",
    new TcpSettings(basePort + 1, sendTimeout, receiveTimeout));
node1.start();
```

The following code example demonstrates starting a master node on the server.

```java
SearchNetworkNode node0 = new SearchNetworkNode(
    0,
    basePath + "Node0",
    new TcpSettings(basePort, sendTimeout, receiveTimeout),
    new ConsoleLogger(),
    configuration);

node0.getEvents().ConfigurationCompleted.add(new EventHandler() {
    @Override
    public void invoke(Object s, EventArgs e) {
        System.out.println("Configuration complete");
    }
});

System.out.println();
System.out.println("Configuring the search network");
node0.configureAllNodes();

System.out.println("Launching the search network");
node0.start();
```

The following code example demonstrates the implementation of a simple console logger.

```java
public class ConsoleLogger implements ILogger {
    public ConsoleLogger() {
    }

    @Override
    public void error(String message) {
        System.out.println("Error: " + message);
    }

    @Override
    public void trace(String message) {
        System.out.println(message);
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search network deployment

Path: /search/net/search-network-deployment/

The GroupDocs.Search search network consists of one master node and several slave nodes. Each node is a hardware server with the .NET platform deployed on it. Inside the .NET platform, an application is deployed that creates an instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/) class.

An instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/) class provides the services described in the configuration:
 - Indexing service;
 - Search services;
 - Extraction services;
 - Shard services.

Indexing and search services also provide an interface to access all search network features.

To deploy the GroupDocs.Search search network, you must perform the following steps:
 - On each slave server, create an instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/) class, call the [Start](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/start/) method.
 - On the master server, create an instance of the [SearchNetworkNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/) class, passing the configuration object to the constructor.
 - Call the [ConfigureAllNodes](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/configureallnodes/) method of the [SearchNetworkNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/) object on the master server.
 - Call the [Start](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/start/) method of the [SearchNetworkNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/) object on the master server.

The following code example demonstrates starting a slave node on the server.

**C#**

```csharp
SearchNetworkNode node1 = SearchNetworkNode.CreateSlaveNode(
    1,
    basePath + "Node1",
    new TcpSettings(basePort + 1, sendTimeout, receiveTimeout, connectTimeout, retryTimeout));
node1.Start();
```

The following code example demonstrates starting a master node on the server.

**C#**

```csharp
SearchNetworkNode node0 = SearchNetworkNode.CreateMasterNode(
    0,
    basePath + "Node0",
    new TcpSettings(basePort, sendTimeout, receiveTimeout, connectTimeout, retryTimeout),
    new ConsoleLogger(),
    configuration);

node0.Events.ConfigurationCompleted += (s, e) =>
{
    Console.WriteLine("Configuration complete");
};

Console.WriteLine();
Console.WriteLine("Configuring the search network");
node0.ConfigureAllNodes();

Console.WriteLine("Launching the search network");
node0.Start();
```

The following code example demonstrates the implementation of a simple console logger.

**C#**

```csharp
class ConsoleLogger : ILogger
{
    public void Error(string message)
    {
        Console.WriteLine("Error: " + message);
    }

    public void Trace(string message)
    {
        Console.WriteLine("Trace: " + message);
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Storing text of indexed documents

Path: /search/java/storing-text-of-indexed-documents/

Text extracted from indexed documents can be stored in an index to provide the extracted text to the user faster when called the [getDocumentText](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getDocumentText(com.groupdocs.search.results.DocumentInfo,%20com.groupdocs.search.common.OutputAdapter)) method, as well as to accelerate text generation with highlighting of search results.

To specify storage parameters, use the [setTextStorageSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setTextStorageSettings(com.groupdocs.search.options.TextStorageSettings)) method of the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class. The default value is null, which means that the text of the documents is not stored in the index.

When saving text in the index, the values defined in a [Compression](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/Compression) class are used to specify the compression ratio of the saved text. Compression can be normal, high, or text can be saved without compression. The choice of compression ratio affects the final size of the index, as well as the speed of indexing. A high compression ratio reduces index size and indexing speed, and the lack of compression makes index size and indexing speed maximum. The default compression ratio is normal.

The example below demonstrates storing text in an index using the high compression ratio.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High)); // Setting high compression ratio for the index text storage
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents
index.add(documentsFolder);
 
// Searching
SearchResult result = index.search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Storing text of indexed documents

Path: /search/net/storing-text-of-indexed-documents/

Text extracted from indexed documents can be stored in an index to provide the extracted text to the user faster when called the [GetDocumentText](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getdocumenttext/index) method, as well as to accelerate text generation with highlighting of search results.

To specify storage parameters, use the [TextStorageSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/textstoragesettings) property of the [IndexSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings) class. The default value is null, which means that the text of the documents is not stored in the index.

When saving text in the index, the [Compression](https://reference.groupdocs.com/net/search/groupdocs.search.options/textstoragesettings/properties/compression) property is used to specify the compression ratio of the saved text. Compression can be normal, high, or text can be saved without compression. The choice of compression ratio affects the final size of the index, as well as the speed of indexing. A high compression ratio reduces index size and indexing speed, and the lack of compression makes index size and indexing speed maximum. The default compression ratio is normal.

The example below demonstrates storing text in an index using the high compression ratio.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index settings instance
IndexSettings settings = new IndexSettings();
settings.TextStorageSettings = new TextStorageSettings(Compression.High); // Setting high compression ratio for the index text storage
 
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
 
// Indexing documents
index.Add(documentsFolder);
 
// Searching
SearchResult result = index.Search("Einstein");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Storing text of indexed documents

Path: /search/nodejs-java/storing-text-of-indexed-documents/

Text extracted from indexed documents can be stored in an index to provide the extracted text to the user faster when called the [getDocumentText](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getDocumentText(com.groupdocs.search.results.DocumentInfo,%20com.groupdocs.search.common.OutputAdapter)) method, as well as to accelerate text generation with highlighting of search results.

To specify storage parameters, use the [setTextStorageSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setTextStorageSettings(com.groupdocs.search.options.TextStorageSettings)) method of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class. The default value is null, which means that the text of the documents is not stored in the index.

When saving text in the index, the values defined in a [Compression](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/Compression) class are used to specify the compression ratio of the saved text. Compression can be normal, high, or text can be saved without compression. The choice of compression ratio affects the final size of the index, as well as the speed of indexing. A high compression ratio reduces index size and indexing speed, and the lack of compression makes index size and indexing speed maximum. The default compression ratio is normal.

The example below demonstrates storing text in an index using the high compression ratio.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index settings instance
const settings = new groupdocs.search.IndexSettings();
settings.setTextStorageSettings(new groupdocs.search.TextStorageSettings(groupdocs.search.Compression.High)); // Setting high compression ratio for the index text storage

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder, settings, true);

// Indexing documents
index.add(documentsFolder);

// Now the index contains the text of all indexed documents,
// so the operations of getting the text of documents and highlighting occurrences are faster.

// Searching
const query = 'Einstein';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Convert word processing documents

Path: /conversion/java/convert/wordprocessing/


When it comes to convenient fast creation and editing of textual documents, using Microsoft Word is the first thing that comes to mind. Then there is often a need to transform DOC or DOCX documents into another format like PDF, HTML, or image for easier mailing, printing, and sharing with other people.
GroupDocs.Conversion for Java allows you to convert Word documents into other formats with minimal effort - all you need is just several lines of Java code.

This section explains how to convert word-processing documents with the help of GroupDocs.Conversion for Java.

## Supported word-processing file conversions

{{< include file="/conversion/java/_includes/supported-conversions/word-processing.md" type="page" >}}

## Convert Word document to PDF

While converting a file from Microsoft Office Word to PDF format, GroupDocs.Conversion for Java performs multiple calculations under the hood to preserve the document's original appearance and to correctly reproduce the layout of the converted PDF document like it was designed for the initial DOC or DOCX document in Microsoft Word. All this is necessary because Word documents are in flow-layout format and their appearance may differ depending on the device and platform that are used for viewing them. On the contrary, PDF format is fixed-layout and has the same appearance on different devices.  
  
The following section explains how to convert DOC or DOCX to PDF programmatically without Microsoft Office and with the help of GroupDocs.Conversion for Java.  

### Convert DOCX (or DOC) to PDF

GroupDocs.Conversion provides an easy and concise way to convert DOCX to PDF - all you need is a couple of lines of code to:

1. Load your DOCX document into the `Converter` object by providing a filename with the extension.
2. Invoke the `convert` method of the `Converter` object and specify the desired output format as PDF by passing the `PdfConvertOptions` object to it along with the name of the converted file.
  
The following code example demonstrates how to convert a document from DOCX into PDF format:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source DOCX file
Converter converter = new Converter("sample.docx");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```
  
{{< alert style="info" >}}
NOTE: Please be aware that the number of pages in a source document affects the conversion time.
{{< /alert >}}

## Convert Word document to HTML or MHTML

HTML is a very popular web page format as it can be viewed on every device and platform that has a web browser. MHTML format in turn represents a web page archive format that is known as archive format because it saves the web HTML code and associated resources in a single file. These resources include anything linked to the webpage such as images, applets, animations, audio files, and so on. MHTML files can be opened in a variety of applications such as Internet Explorer and Microsoft Word.  

Converting Microsoft Word documents to HTML or MHTML formats is a popular and demanded feature of GroupDocs.Conversion. The basic use case of DOCX to HTML conversion could be implemented in several lines of Java code - all you need is to specify the source file name with the extension and call the `convert` method of the `Converter` class passing the name of the target HTML file to it. Please check the complete code snippet below:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.MarkupConvertOptions;
...
// Load the source DOCX file
Converter converter = new Converter("sample.docx");
// Set the convert options for HTML format
MarkupConvertOptions options = new MarkupConvertOptions();
// Save converted HTML file
converter.convert("converted.html", options);
```

When converting a DOC or DOCX file to MHTML format the only difference from the previous code example is that it is needed to call [MarkupConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/MarkupConvertOptions) `setFormat` method with **MarkupFileType.Mhtml**. The code snippet for DOCX to MHTML conversion will look as follows:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.MarkupConvertOptions;
import com.groupdocs.conversion.filetypes.MarkupFileType;
...
// Load the source DOCX file
Converter converter = new Converter("sample.docx");
MarkupConvertOptions options = new MarkupConvertOptions();
options.setFormat(MarkupFileType.Mhtml);
// Save converted HTML file
converter.convert("converted.html", options);
```

## Convert Word document to Image

At times you may need to get images of DOC or DOCX document pages - it may be useful as a faster and therefore more efficient substitution for physical document scanning, when creating document pages previews for your website or application, or when trying to show your documents to someone who hasn’t Microsoft Word installed on their workstation. Then the solution is to convert a document into JPG, PNG, TIFF or any other supported image format (see the full list of [available conversions](#supported-word-processing-file-conversions)). 

Similarly to other code examples that were explained already, all you need to convert a Word document to an image is to load the source DOC/DOCX file into the `Converter` object and call the `convert` method. The only difference is that every page from the source Word document will be saved as a separate image file, so it is required to specify the naming format for output images (page numbers will be set on the fly).  

Please check the complete code example of how to convert DOCX to PNG below:

```java
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.SavePageStream;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.filetypes.ImageFileType;
...
String outputFileNameFormat = "converted-page-%s.png";
SavePageStream getPageStream = page => new FileOutputStream(String.format(outputFileNameFormat, page));

// Load the source DOCX file
Converter converter = new Converter("sample.docx");
// Set the convert options for PNG format
ImageConvertOptions options = new ImageConvertOptions();
options.setFormat(ImageFileType.Png);  
// Convert to PNG format
converter.convert(getPageStream, options);
```

## Convert Word document to Markdown

Markdown format gained popularity among developers because of its versatility - while it is used for writing programs description and documentation, its structure is quite simple and plain so it is good for transforming to PDF, HTML, DOCX and other formats.
GroupDocs.Conversion allows you to convert Microsoft Word documents to markdown files with ".md" extension without too much effort. Let’s see how to convert DOCX to MD using Java programming language.  

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
import com.groupdocs.conversion.filetypes.WordProcessingFileType;
...
// Load the source DOCX file
Converter converter = new Converter("sample.docx");
WordProcessingConvertOptions options = new WordProcessingConvertOptions();
options.setFormat(WordProcessingFileType.Md);
// Save converted TXT file
converter.convert("converted.md", options);
```
  
So again - all you need to do for a quick convert with GroupDocs.Conversion for Java is to - load the source Word document into the `Converter` class and call the `convert` method to save the converted file. That’s it!

---

## Convert word processing documents

Path: /conversion/net/convert/wordprocessing/


When it comes to convenient fast creation and editing of textual documents, using Microsoft Word is the first thing that comes to mind. Then there is often a need to transform DOC or DOCX documents into another format like PDF, HTML, or image for easier mailing, printing, and sharing with other people.
GroupDocs.Conversion for .NET allows you to convert Word documents into other formats with minimal effort - all you need is just several lines of C# code.

This section explains how to convert word-processing documents with the help of GroupDocs.Conversion for .NET.

## Supported word-processing file conversions

{{< include file="/conversion/net/_includes/supported-conversions/word-processing.md" type="page" >}}

## Convert Word document to PDF

While converting a file from Microsoft Office Word to PDF format, GroupDocs.Conversion for .NET performs multiple calculations under the hood to preserve the document's original appearance and to correctly reproduce the layout of the converted PDF document like it was designed for the initial DOC or DOCX document in Microsoft Word. All this is necessary because Word documents are in flow-layout format and their appearance may differ depending on the device and platform that are used for viewing them. On the contrary, PDF format is fixed-layout and has the same appearance on different devices.  
  
The following section explains how to convert DOC or DOCX to PDF programmatically without Microsoft Office and with the help of GroupDocs.Conversion for .NET.  

### Convert DOCX (or DOC) to PDF

GroupDocs.Conversion provides an easy and concise way to convert DOCX to PDF - all you need is a couple of lines of code to:

1. Load your DOCX document into the `Converter` object by providing a filename with the extension.
2. Invoke the `Convert` method of the `Converter` object and specify the desired output format as PDF by passing the `PdfConvertOptions` object to it along with the name of the converted file.  
  
The following code example demonstrates how to convert a document from DOCX into PDF format:

```csharp
// Load the source DOCX file
using(var converter = new GroupDocs.Conversion.Converter("sample.docx"))
{
    // Set the convert options for PDF format
    var options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```
  
{{< alert style="info" >}}
NOTE: Please be aware that the number of pages in a source document affects the conversion time.
{{< /alert >}}

## Convert Word document to HTML or MHTML

HTML is a very popular web page format as it can be viewed on every device and platform that has a web browser. MHTML format in turn represents a web page archive format that is known as archive format because it saves the web HTML code and associated resources in a single file. These resources include anything linked to the webpage such as images, applets, animations, audio files, and so on. MHTML files can be opened in a variety of applications such as Internet Explorer and Microsoft Word.  

Converting Microsoft Word documents to HTML or MHTML formats is a popular and demanded feature of GroupDocs.Conversion. The basic use case of DOCX to HTML conversion could be implemented in several lines of C# code - all you need is to specify the source file name with the extension and call the `Convert` method of the `Converter` class passing the name of the target HTML file to it. Please check the complete code snippet below:

```csharp
// Load the source DOCX file
using(var converter = new GroupDocs.Conversion.Converter("sample.docx"))
{
    // Set the convert options for HTML format
    var options = new WebConvertOptions();
    // Save converted HTML file
    converter.Convert("converted.html", options);
}
```

When converting a DOC or DOCX file to MHTML format the only difference from the previous code example is that it is needed to set the  [WebConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions) `Format` property to  **WebFileType.Mhtml**. The code snippet for DOCX to MHTML conversion will look as follows:

```csharp
// Load the source DOCX file
using(var converter = new GroupDocs.Conversion.Converter("sample.docx"))
{
    var options = new WebConvertOptions
    {  
        Format = GroupDocs.Conversion.FileTypes.WebFileType.Mhtml
    };
    // Save converted HTML file
    converter.Convert("converted.html", options);
}
```

## Convert Word document to Image

At times you may need to get images of DOC or DOCX document pages - it may be useful as a faster and therefore more efficient substitution for physical document scanning, when creating document pages previews for your website or application, or when trying to show your documents to someone who hasn’t Microsoft Word installed on their workstation. Then the solution is to convert a document into JPG, PNG, TIFF or any other supported image format (see the full list of [available conversions](#supported-word-processing-file-conversions)). 

Similarly to other code examples that were explained already, all you need to convert a Word document to an image is to load the source DOC/DOCX file into the `Converter` object and call the `Convert` method. The only difference is that every page from the source Word document will be saved as a separate image file, so it is required to specify the naming format for output images (page numbers will be set on the fly).  

Please check the complete code example of how to convert DOCX to PNG below:

```csharp
string outputFileNameFormat = "converted-page-{0}.png";
Func<SavePageContext, Stream> getPageStream = saveContext => new FileStream(string.Format(outputFileNameFormat, saveContext.Page), FileMode.Create);

// Load the source DOCX file
using (Converter converter = new GroupDocs.Conversion.Converter("sample.docx"))
{
    // Set the convert options for PNG format
    ImageConvertOptions options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png };
    // Convert to PNG format
    converter.Convert(getPageStream, options);
}
```

## Convert Word document to Markdown

Markdown format gained popularity among developers because of its versatility - while it is used for writing programs description and documentation, its structure is quite simple and plain so it is good for transforming to PDF, HTML, DOCX and other formats.
GroupDocs.Conversion allows you to convert Microsoft Word documents to markdown files with the ".md" extension without too much effort. Let’s see how to convert DOCX to MD using C# programming language.  

```csharp
// Load the source DOCX file
using (var converter = new GroupDocs.Conversion.Converter("sample.docx"))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions
    {
        Format = GroupDocs.Conversion.FileTypes.WordProcessingFileType.Md
    };
    // Save converted MD file
    converter.Convert("converted.md", options);
}
```
  
So again - all you need to do for a quick convert with GroupDocs.Conversion for .NET is to - load the source Word document into the `Converter` class and call the `Convert` method to save the converted file. That’s it!

---

## Convert word processing documents

Path: /conversion/nodejs-java/convert/wordprocessing/


When it comes to convenient fast creation and editing of textual documents, using Microsoft Word is the first thing that comes to mind. Then there is often a need to transform DOC or DOCX documents into another format like PDF, HTML, or image for easier mailing, printing, and sharing with other people.
GroupDocs.Conversion for Java allows you to convert Word documents into other formats with minimal effort - all you need is just several lines of Java code.

This section explains how to convert word-processing documents with the help of GroupDocs.Conversion for Java.

## Supported word-processing file conversions

{{< include file="/conversion/nodejs-java/_includes/supported-conversions/word-processing.md" type="page" >}}

## Convert Word document to PDF

While converting a file from Microsoft Office Word to PDF format, GroupDocs.Conversion for Java performs multiple calculations under the hood to preserve the document's original appearance and to correctly reproduce the layout of the converted PDF document like it was designed for the initial DOC or DOCX document in Microsoft Word. All this is necessary because Word documents are in flow-layout format and their appearance may differ depending on the device and platform that are used for viewing them. On the contrary, PDF format is fixed-layout and has the same appearance on different devices.  
  
The following section explains how to convert DOC or DOCX to PDF programmatically without Microsoft Office and with the help of GroupDocs.Conversion for Java.  

## Convert DOCX (or DOC) to PDF

GroupDocs.Conversion provides an easy and concise way to convert DOCX to PDF - all you need is a couple of lines of code to:

1. Load your DOCX document into the `Converter` object by providing a filename with the extension.
2. Invoke the `convert` method of the `Converter` object and specify the desired output format as PDF by passing the `PdfConvertOptions` object to it along with the name of the converted file.
  
The following code example demonstrates how to convert a document from DOCX into PDF format:

```js
// Load the source DOCX file
const converter = new groupdocs.conversion.Converter("sample.docx");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```
  
{{< alert style="info" >}}
NOTE: Please be aware that the number of pages in a source document affects the conversion time.
{{< /alert >}}

## Convert Word document to HTML or MHTML

HTML is a very popular web page format as it can be viewed on every device and platform that has a web browser. MHTML format in turn represents a web page archive format that is known as archive format because it saves the web HTML code and associated resources in a single file. These resources include anything linked to the webpage such as images, applets, animations, audio files, and so on. MHTML files can be opened in a variety of applications such as Internet Explorer and Microsoft Word.  

Converting Microsoft Word documents to HTML or MHTML formats is a popular and demanded feature of GroupDocs.Conversion. The basic use case of DOCX to HTML conversion could be implemented in several lines of Java code - all you need is to specify the source file name with the extension and call the `convert` method of the `Converter` class passing the name of the target HTML file to it. Please check the complete code snippet below:

```js
// Load the source DOCX file
const converter = new groupdocs.conversion.Converter("sample.docx");
// Set the convert options for HTML format
const options = new groupdocs.conversion.MarkupConvertOptions();
// Save converted HTML file
converter.convert("converted.html", options);
```

When converting a DOC or DOCX file to MHTML format the only difference from the previous code example is that it is needed to call [MarkupConvertOptions](#) `setFormat` method with **MarkupFileType.Mhtml**. The code snippet for DOCX to MHTML conversion will look as follows:

```js
// Load the source DOCX file
const converter = new groupdocs.conversion.Converter("sample.docx");
const options = new groupdocs.conversion.MarkupConvertOptions();
options.setFormat(groupdocs.conversion.MarkupFileType.Mhtml);
// Save converted HTML file
converter.convert("converted.html", options);
```

## Convert Word document to Image

At times you may need to get images of DOC or DOCX document pages - it may be useful as a faster and therefore more efficient substitution for physical document scanning, when creating document pages previews for your website or application, or when trying to show your documents to someone who hasn’t Microsoft Word installed on their workstation. Then the solution is to convert a document into JPG, PNG, TIFF or any other supported image format (see the full list of [available conversions](#supported-word-processing-file-conversions)). 

Similarly to other code examples that were explained already, all you need to convert a Word document to an image is to load the source DOC/DOCX file into the `Converter` object and call the `convert` method. The only difference is that every page from the source Word document will be saved as a separate image file, so it is required to specify the naming format for output images (page numbers will be set on the fly).  

Please check the complete code example of how to convert DOCX to PNG below:

```js
const outputFileTemplate = "converted-page-.png";

// Load the source DOCX file
const converter = new groupdocs.conversion.Converter("sample.docx");
// Set the convert options for PNG format
const options = new groupdocs.conversion.ImageConvertOptions();
options.setFormat(groupdocs.conversion.ImageFileType.Png);  
// Convert to PNG format
converter.convert(outputFileTemplate, options);
```

## Convert Word document to Markdown

Markdown format gained popularity among developers because of its versatility - while it is used for writing programs description and documentation, its structure is quite simple and plain so it is good for transforming to PDF, HTML, DOCX and other formats.
GroupDocs.Conversion allows you to convert Microsoft Word documents to markdown files with ".md" extension without too much effort. Let’s see how to convert DOCX to MD using Java programming language.  

```js
// Load the source DOCX file
const converter = new groupdocs.conversion.Converter("sample.docx");
const options = new groupdocs.conversion.WordProcessingConvertOptions();
options.setFormat(groupdocs.conversion.WordProcessingFileType.Md);
// Save converted TXT file
converter.convert("converted.txt", options);
```
  
So again - all you need to do for a quick convert with GroupDocs.Conversion for Java is to - load the source Word document into the `Converter` class and call the `convert` method to save the converted file. That’s it!

---

## Convert to 3D formats with advanced options

Path: /conversion/net/convert-to-3d-with-advanced-options/


GroupDocs.Conversion provides the [ThreeDConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/threedconvertoptions) class to specify 3D file format conversion settings. This class implements [IPagedConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions) for page selection support.

## Supported 3D Formats

The following 3D (Three-Dimensional) file formats are supported:

| Format | Extension | Description |
|--------|-----------|-------------|
| **FBX** | .fbx | Autodesk FilmBox (motion capture, animation) |
| **3DS** | .3ds | 3D Studio (DOS) mesh file format |
| **3MF** | .3mf | 3D Manufacturing Format |
| **AMF** | .amf | Additive Manufacturing File Format |
| **ASE** | .ase | Autodesk ASCII Scene Export |
| **DAE** | .dae | Digital Asset Exchange (COLLADA) |
| **DRC** | .drc | Google Draco compressed 3D |
| **FBX** | .fbx | Autodesk Filmbox |
| **GLTF** | .gltf | GL Transmission Format (JSON) |
| **GLB** | .glb | Binary GL Transmission Format |
| **OBJ** | .obj | Wavefront 3D Object File |
| **PLY** | .ply | Polygon File Format |
| **RVM** | .rvm | AVEVA Plant Design Model |
| **U3D** | .u3d | Universal 3D File Format |
| **USD** | .usd | Universal Scene Description |
| **USDZ** | .usdz | Universal Scene Description (ZIP) |
| **VRML** | .vrml | Virtual Reality Modeling Language |
| **X** | .x | DirectX 3D Graphics (legacy) |
| **JT** | .jt | Jupiter Tessellation (ISO 14306) |

## Properties

**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired 3D file format. Available options include: *Fbx, Obj, Gltf, ThreeDS, U3d, Dae, Drc, Rvm, Amf, Ply*, and others.

**[PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagenumber)** - Specifies the starting page number for conversion (when source has multiple views/scenes).

**[PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagescount)** - Specifies the number of pages to convert.

## Conversion Examples

ThreeDConvertOptions supports conversion between 3D formats. The following examples demonstrate common conversions.

### FBX to OBJ

Convert an Autodesk FBX model to Wavefront OBJ format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "character-model.fbx";
string outputFile = "character-model.obj";

using (var converter = new Converter(sourceFile))
{
    var options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.Obj
    };
    converter.Convert(outputFile, options);
}
```

### OBJ to FBX

Convert a Wavefront OBJ model to Autodesk FBX format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "building-model.obj";
string outputFile = "building-model.fbx";

using (var converter = new Converter(sourceFile))
{
    var options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.Fbx
    };
    converter.Convert(outputFile, options);
}
```

### FBX to GLTF

Convert an FBX model to GLTF (GL Transmission Format) for web and mobile:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "product-design.fbx";
string outputFile = "product-design.gltf";

using (var converter = new Converter(sourceFile))
{
    var options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.Gltf
    };
    converter.Convert(outputFile, options);
}
```

### OBJ to 3DS

Convert an OBJ model to 3D Studio format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "terrain-model.obj";
string outputFile = "terrain-model.3ds";

using (var converter = new Converter(sourceFile))
{
    var options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.ThreeDS
    };
    converter.Convert(outputFile, options);
}
```

### FBX to U3D

Convert an FBX model to Universal 3D format for PDF embedding:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "mechanical-part.fbx";
string outputFile = "mechanical-part.u3d";

using (var converter = new Converter(sourceFile))
{
    var options = new ThreeDConvertOptions
    {
        Format = ThreeDFileType.U3d
    };
    converter.Convert(outputFile, options);
}
```

## Format Support Notes

3D to 3D conversions are supported for most format combinations:
- FBX → OBJ, GLTF, 3DS, U3D, DAE, DRC, AMF, PLY, RVM
- OBJ → FBX, GLTF, 3DS, U3D, DAE, DRC, AMF, PLY, RVM
- GLTF → FBX, OBJ, 3DS, U3D, DAE, DRC, AMF, PLY, RVM
- 3DS → FBX, OBJ, GLTF, U3D, DAE, DRC, AMF, PLY, RVM
- All source 3D formats → Common target formats (FBX, OBJ, GLTF, etc.)

**Note:** To convert FROM 3D formats to PDF, use [PdfConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-pdf-with-advanced-options.md" >}}).

## More Resources

- [API Reference: ThreeDConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/threedconvertoptions)
- [API Reference: ThreeDFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/threedfiletype)
- [Convert 3D Formats]({{< ref "conversion/net/developer-guide/basic-usage/convert/3d.md" >}})
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})

---

## Insert Hyperlinks Dynamically

Path: /assembly/net/basic-usage-insert-hyperlinks/


## Overview

GroupDocs.Assembly for .NET enables you to insert hyperlinks dynamically into documents using link tags. Hyperlinks can point to external URLs, bookmarks within the document, or specific cells/slides depending on the document type.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles documents
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources

Here are the steps to insert hyperlinks dynamically:

* Create a template document with link tags
* Use the syntax `<<link [uri_expression][display_text_expression]>>`
* Provide URI and optional display text from your data source
* Assemble the document

{{< alert style="info" >}}
Link tags are replaced with clickable hyperlinks during document assembly. The URI expression is mandatory, while display text is optional.
{{< /alert >}}

## Insert Hyperlink with URL and Text

Insert a hyperlink with both URL and display text:

```csharp
using GroupDocs.Assembly;

public class Website
{
    public string Name { get; set; }
    public string Url { get; set; }
}

public static void InsertHyperlink()
{
    var website = new Website
    {
        Name = "Visit our website",
        Url = "https://www.example.com"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("HyperlinkTemplate.docx", "HyperlinkOutput.docx", 
        new DataSourceInfo(website, "website"));
    
    Console.WriteLine("Hyperlink inserted successfully.");
}
```

## Template Structure for Hyperlinks

In your template (HyperlinkTemplate.docx), use link tags:

```
Please <<link [website.Url][website.Name]>> for more information.
```

After assembly:

```
Please Visit our website for more information.
```

(The text "Visit our website" will be a clickable hyperlink.)

## Hyperlink with URL Only

If you omit the display text, the URL is used as the display text:

```csharp
using GroupDocs.Assembly;

public static void InsertHyperlinkUrlOnly()
{
    var website = new Website
    {
        Url = "https://www.example.com"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("HyperlinkTemplate.docx", "HyperlinkOutput.docx", 
        new DataSourceInfo(website, "website"));
    
    Console.WriteLine("Hyperlink with URL only inserted successfully.");
}
```

Template:

```
Visit <<link [website.Url]>> for more information.
```

## Insert Multiple Hyperlinks from Collection

Insert hyperlinks for each item in a collection:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void InsertHyperlinksFromCollection()
{
    List<Website> websites = new List<Website>
    {
        new Website { Name = "Home", Url = "https://www.example.com" },
        new Website { Name = "About", Url = "https://www.example.com/about" },
        new Website { Name = "Contact", Url = "https://www.example.com/contact" }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("HyperlinksTemplate.docx", "HyperlinksOutput.docx", 
        new DataSourceInfo(websites, "websites"));
    
    Console.WriteLine("Hyperlinks inserted from collection successfully.");
}
```

Template with foreach:

```
Links:
<<foreach [in websites]>>
- <<link [Url][Name]>>
<</foreach>>
```

## Hyperlink to Bookmark (Word Documents)

Link to bookmarks within the same document:

```csharp
using GroupDocs.Assembly;

public class Section
{
    public string Title { get; set; }
    public string BookmarkName { get; set; }
}

public static void InsertBookmarkLink()
{
    var section = new Section
    {
        Title = "Go to Introduction",
        BookmarkName = "Introduction"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("BookmarkLinkTemplate.docx", "BookmarkLinkOutput.docx", 
        new DataSourceInfo(section, "section"));
    
    Console.WriteLine("Bookmark hyperlink inserted successfully.");
}
```

Template:

```
<<link [section.BookmarkName][section.Title]>>
```

## Hyperlink to Cell (Spreadsheet Documents)

Link to cells in spreadsheet documents:

```csharp
using GroupDocs.Assembly;

public static void InsertCellLink()
{
    var data = new { CellReference = "A1", DisplayText = "Go to Home" };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("CellLinkTemplate.xlsx", "CellLinkOutput.xlsx", 
        new DataSourceInfo(data, "data"));
    
    Console.WriteLine("Cell hyperlink inserted successfully.");
}
```

Template:

```
<<link ["A1"]["Go to Home"]>>
```

## Hyperlink to Slide (Presentation Documents)

Link to slides in presentation documents:

```csharp
using GroupDocs.Assembly;

public static void InsertSlideLink()
{
    var data = new { SlideNumber = "Slide1", DisplayText = "Go to First Slide" };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("SlideLinkTemplate.pptx", "SlideLinkOutput.pptx", 
        new DataSourceInfo(data, "data"));
    
    Console.WriteLine("Slide hyperlink inserted successfully.");
}
```

Template:

```
<<link ["Slide1"]["Go to First Slide"]>>
```

## Using Uri Objects

You can use Uri objects directly:

```csharp
using GroupDocs.Assembly;
using System;

public class Website
{
    public Uri Url { get; set; }
    public string Name { get; set; }
}

public static void InsertHyperlinkWithUri()
{
    var website = new Website
    {
        Url = new Uri("https://www.example.com"),
        Name = "Visit our website"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("HyperlinkTemplate.docx", "HyperlinkOutput.docx", 
        new DataSourceInfo(website, "website"));
    
    Console.WriteLine("Hyperlink with Uri object inserted successfully.");
}
```

{{< alert style="warning" >}}
Link tags cannot be used within charts. For hyperlinks in charts, use alternative approaches or place links outside chart elements.
{{< /alert >}}

### Advanced Usage Topics

To learn more about bookmark creation, complex hyperlink scenarios, and advanced link formatting, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Load diagram document with options

Path: /conversion/net/load-diagram-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [DiagramLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/diagramloadoptions) to control how source diagram files are processed. Diagram files include formats like VSD, VSDX, VDX, VSDM, VSSX, and other Microsoft Visio formats.

The following options are available:

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/diagramloadoptions/format)** | The document type is auto-detected during loading, but you can explicitly specify the source format. Available options include: *Vsd, Vsdx, Vsx, Vtx, Vdx, Vssx, Vstx, Vsdm, Vssm, Vstm* |
|**[DefaultFont](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/diagramloadoptions/defaultfont)** | Default font for rendering the diagram. The following font will be used if a diagram font is missing. |

## Load VSD file

The following code snippet shows how to load a VSD (Visio Drawing) file with explicit format specification:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new DiagramLoadOptions
{
    Format = DiagramFileType.Vsd
};

using (Converter converter = new Converter("design-diagram.vsd", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("design-diagram.pdf", options);
}
```

## Load VSDX file

The following code snippet shows how to load a VSDX (Visio Drawing XML) file:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new DiagramLoadOptions
{
    Format = DiagramFileType.Vsdx
};

using (Converter converter = new Converter("flowchart.vsdx", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("flowchart.pdf", options);
}
```

## Load VSD with default font

The following code snippet shows how to load a VSD file with a default font for missing fonts:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new DiagramLoadOptions
{
    Format = DiagramFileType.Vsd,
    DefaultFont = "Arial"
};

using (Converter converter = new Converter("network-diagram.vsd", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("network-diagram.pdf", options);
}
```

## Convert VSDX to Word document

The following code snippet shows how to load a VSDX file and convert it to a Word document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new DiagramLoadOptions
{
    Format = DiagramFileType.Vsdx
};

using (Converter converter = new Converter("process-flow.vsdx", getLoadOptions))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions();
    converter.Convert("process-flow.docx", options);
}
```

## Convert between diagram formats

The following code snippet shows how to convert from VSD to VSDX format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new DiagramLoadOptions
{
    Format = DiagramFileType.Vsd
};

using (Converter converter = new Converter("legacy-diagram.vsd", getLoadOptions))
{
    DiagramConvertOptions options = new DiagramConvertOptions
    {
        Format = DiagramFileType.Vsdx
    };
    converter.Convert("legacy-diagram.vsdx", options);
}
```

## Convert VSDX to PowerPoint

The following code snippet shows how to load a VSDX file and convert it to a PowerPoint presentation:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new DiagramLoadOptions
{
    Format = DiagramFileType.Vsdx
};

using (Converter converter = new Converter("org-chart.vsdx", getLoadOptions))
{
    PresentationConvertOptions options = new PresentationConvertOptions();
    converter.Convert("org-chart.pptx", options);
}
```

---

## Search operation table

Path: /search/java/search-operation-table/

The table below provides syntax of all elements allowed in text search queries. See also [Query language specification]({{< ref "search/java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}), [Search flow]({{< ref "search/java/developer-guide/advanced-usage/searching/search-flow.md" >}}).

| Element | Syntax | Description | Examples |
| --- | --- | --- | --- |
| Parentheses | ( *inner-query* ) | Parentheses are used to specify order of operations. | <ul><li>term1 &#124; (term2 &amp; term3)</li><li>(\"total expenses\" &#124; \"total costs\") &amp; (82000 ~~ 83000 |
| Field specifier | *field-name* : *inner-query* | Field specifier is used to specify field name. | <ul><li>content : term</li><li>creationdate : (2010 ~~ 2013)</li><li>filename : report &amp; creationdate : 2009 |
| Exact phrase query specifier | \" *exact-phrase-query* \" | Exact phrase query specifier is used to specify phrase for phrase search. | <ul><li>\"term1 term2 term3\"</li><li>\"computational complexity theory\"</li><li>\"formal language\" AND harrison |
| And operation | *left-query* &amp; *right-query*<br/>*left-query* AND *right-query* | And operation is used to find documents that contain both left query and right query. | <ul><li>term1 &amp; term2</li><li>term1 AND term2</li><li>computational &amp; complexity |
| Or operation | *left-query* &#124; *right-query*<br/>*left-query* &#124;&#124; *right-query*<br/>*left-query* OR *right-query* | Or operation is used to find documents that contain left query, or right query, or both. | <ul><li>term1 &#124; term2</li><li>term1 &#124;&#124; term2</li><li>term1 OR term2</li><li>\"cumulative distribution function\" OR \"cumulative density function\" |
| Not operation | ! *inner-query*<br/>NOT *inner-query* | Not operation is used to find all documents which do not contain inner query. | <ul><li>! term</li><li>NOT term</li><li>author : (Cardano AND NOT Gerolamo) |
| Macro name specifier | @*macro-name* | Macro name specifier is used to specify name of macro within search query that will be replaced with the body of the macro before parsing the query. | <ul><li>@query\_macro</li><li>@macro1 &amp; @macro2 |
| Regular expression specifier | ^*regular-expression* | Regular expression specifier is used to specify query that is regular expression. | <ul><li>^^\[0-9\]{1,5}$ |
| Numeric range specifier | *start-number* ~~ *end-number* | Numeric range specifier is used to specify range for numeric range search. | <ul><li>13 ~~ 42</li><li>10000000000 ~~ 100000000000 |
| Date range specifier | daterange( *start-date* ~~ *end-date*)<br/>where *start-date* and *end-date* are dates in the format \'yyyy-MM-dd\'. | Date range specifier is used to specify range for date range search. | <ul><li>daterange(2017-09-28 ~~ 2017-11-11) |
| Wildcard (since v.18.12) | ? - wildcard character,<br/>?(*N*~*M*) - wildcard character range,<br/>\**N* - wildcard word,<br/>\**N*~~*M* - wildcard word range,<br/>where *N* and *M* are in the range from 0 to 255. | Wildcard characters and wildcard words are used to search for words with unknown characters and phrases with unknown words, respectively. | <ul><li>?ffect - for \'affect\', \'effect\'</li><li>princip?(2\~4) - for \'principal\', \'principle\', \'principles\', \'principally\'</li><li>?(0\~2)sure - for \'assure\', \'ensure\', \'sure\'</li><li>\"\\\"First law \*1 thermodynamics\\\"\" - for \'First law of thermodynamics\'</li><li>\"\\\"Frodo \*1~~5 Pippin\\\"\" - for \'Frodo spoke to Pippin\', \'Frodo stripped the blankets from Pippin\' |
| Escape sequence (since v.19.2) | \\*N*<br/>where *N* can be one of<br/>( ) : \" & &#124; ! ^ ~ \* ? \\<br/>\- or -<br/>s (for space character)<br/>\- or -<br/>u*hhhh*<br/>where *h* is hexadecimal digit (for any Unicode character) | The escape sequence allows a special character to be used in a query as it is. Note that an escaped character must be represented in Alphabet in order for it to be indexed as a valid character (not as Separator). | <ul><li>\\& - escaping & character</li><li>\\~ - escaping ~ character</li><li>\\s - escaping space character</li><li>\\u0026 - escaping & character (Unicode code)</li><li>R\\&B - searching for 'R&B' as a whole word (& character must have an appropriate type in Alphabet before indexing) |

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search operation table

Path: /search/net/search-operation-table/

The table below provides syntax of all elements allowed in text search queries. See also [Query language specification]({{< ref "search/net/developer-guide/advanced-usage/searching/query-language-specification.md" >}}), [Search flow]({{< ref "search/net/developer-guide/advanced-usage/searching/search-flow.md" >}}).

| Element | Syntax | Description | Examples |
| --- | --- | --- | --- |
| Parentheses | ( *inner-query* ) | Parentheses are used to specify order of operations. | <ul><li>term1 &#124; (term2 &amp; term3)</li><li>(\"total expenses\" &#124; \"total costs\") &amp; (82000 ~~ 83000 |
| Field specifier | *field-name* : *inner-query* | Field specifier is used to specify field name. | <ul><li>content : term</li><li>creationdate : (2010 ~~ 2013)</li><li>filename : report &amp; creationdate : 2009 |
| Exact phrase query specifier | \" *exact-phrase-query* \" | Exact phrase query specifier is used to specify phrase for phrase search. | <ul><li>\"term1 term2 term3\"</li><li>\"computational complexity theory\"</li><li>\"formal language\" AND harrison |
| And operation | *left-query* &amp; *right-query*<br/>*left-query* AND *right-query* | And operation is used to find documents that contain both left query and right query. | <ul><li>term1 &amp; term2</li><li>term1 AND term2</li><li>computational &amp; complexity |
| Or operation | *left-query* &#124; *right-query*<br/>*left-query* &#124;&#124; *right-query*<br/>*left-query* OR *right-query* | Or operation is used to find documents that contain left query, or right query, or both. | <ul><li>term1 &#124; term2</li><li>term1 &#124;&#124; term2</li><li>term1 OR term2</li><li>\"cumulative distribution function\" OR \"cumulative density function\" |
| Not operation | ! *inner-query*<br/>NOT *inner-query* | Not operation is used to find all documents which do not contain inner query. | <ul><li>! term</li><li>NOT term</li><li>author : (Cardano AND NOT Gerolamo) |
| Macro name specifier | @*macro-name* | Macro name specifier is used to specify name of macro within search query that will be replaced with the body of the macro before parsing the query. | <ul><li>@query\_macro</li><li>@macro1 &amp; @macro2 |
| Regular expression specifier | ^*regular-expression* | Regular expression specifier is used to specify query that is regular expression. | <ul><li>^^\[0-9\]{1,5}$ |
| Numeric range specifier | *start-number* ~~ *end-number* | Numeric range specifier is used to specify range for numeric range search. | <ul><li>13 ~~ 42</li><li>10000000000 ~~ 100000000000 |
| Date range specifier | daterange( *start-date* ~~ *end-date*)<br/>where *start-date* and *end-date* are dates in the format \'yyyy-MM-dd\'. | Date range specifier is used to specify range for date range search. | <ul><li>daterange(2017-09-28 ~~ 2017-11-11) |
| Wildcard (since v.18.12) | ? - wildcard character,<br/>?(*N*~*M*) - wildcard character range,<br/>\**N* - wildcard word,<br/>\**N*~~*M* - wildcard word range,<br/>where *N* and *M* are in the range from 0 to 255. | Wildcard characters and wildcard words are used to search for words with unknown characters and phrases with unknown words, respectively. | <ul><li>?ffect - for \'affect\', \'effect\'</li><li>princip?(2\~4) - for \'principal\', \'principle\', \'principles\', \'principally\'</li><li>?(0\~2)sure - for \'assure\', \'ensure\', \'sure\'</li><li>\"\\\"First law \*1 thermodynamics\\\"\" - for \'First law of thermodynamics\'</li><li>\"\\\"Frodo \*1~~5 Pippin\\\"\" - for \'Frodo spoke to Pippin\', \'Frodo stripped the blankets from Pippin\' |
| Escape sequence (since v.19.2) | \\*N*<br/>where *N* can be one of<br/>( ) : \" & &#124; ! ^ ~ \* ? \\<br/>\- or -<br/>s (for space character)<br/>\- or -<br/>u*hhhh*<br/>where *h* is hexadecimal digit (for any Unicode character) | The escape sequence allows a special character to be used in a query as it is. Note that an escaped character must be represented in Alphabet in order for it to be indexed as a valid character (not as Separator). | <ul><li>\\& - escaping & character</li><li>\\~ - escaping ~ character</li><li>\\s - escaping space character</li><li>\\u0026 - escaping & character (Unicode code)</li><li>R\\&B - searching for 'R&B' as a whole word (& character must have an appropriate type in Alphabet before indexing) |

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search operation table

Path: /search/nodejs-java/search-operation-table/

The table below provides syntax of all elements allowed in text search queries. See also [Query language specification]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/query-language-specification.md" >}}), [Search flow]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-flow.md" >}}).

| Element | Syntax | Description | Examples |
| --- | --- | --- | --- |
| Parentheses | ( *inner-query* ) | Parentheses are used to specify order of operations. | <ul><li>term1 &#124; (term2 &amp; term3)</li><li>(\"total expenses\" &#124; \"total costs\") &amp; (82000 ~~ 83000 |
| Field specifier | *field-name* : *inner-query* | Field specifier is used to specify field name. | <ul><li>content : term</li><li>creationdate : (2010 ~~ 2013)</li><li>filename : report &amp; creationdate : 2009 |
| Exact phrase query specifier | \" *exact-phrase-query* \" | Exact phrase query specifier is used to specify phrase for phrase search. | <ul><li>\"term1 term2 term3\"</li><li>\"computational complexity theory\"</li><li>\"formal language\" AND harrison |
| And operation | *left-query* &amp; *right-query*<br/>*left-query* AND *right-query* | And operation is used to find documents that contain both left query and right query. | <ul><li>term1 &amp; term2</li><li>term1 AND term2</li><li>computational &amp; complexity |
| Or operation | *left-query* &#124; *right-query*<br/>*left-query* &#124;&#124; *right-query*<br/>*left-query* OR *right-query* | Or operation is used to find documents that contain left query, or right query, or both. | <ul><li>term1 &#124; term2</li><li>term1 &#124;&#124; term2</li><li>term1 OR term2</li><li>\"cumulative distribution function\" OR \"cumulative density function\" |
| Not operation | ! *inner-query*<br/>NOT *inner-query* | Not operation is used to find all documents which do not contain inner query. | <ul><li>! term</li><li>NOT term</li><li>author : (Cardano AND NOT Gerolamo) |
| Macro name specifier | @*macro-name* | Macro name specifier is used to specify name of macro within search query that will be replaced with the body of the macro before parsing the query. | <ul><li>@query\_macro</li><li>@macro1 &amp; @macro2 |
| Regular expression specifier | ^*regular-expression* | Regular expression specifier is used to specify query that is regular expression. | <ul><li>^^\[0-9\]{1,5}$ |
| Numeric range specifier | *start-number* ~~ *end-number* | Numeric range specifier is used to specify range for numeric range search. | <ul><li>13 ~~ 42</li><li>10000000000 ~~ 100000000000 |
| Date range specifier | daterange( *start-date* ~~ *end-date*)<br/>where *start-date* and *end-date* are dates in the format \'yyyy-MM-dd\'. | Date range specifier is used to specify range for date range search. | <ul><li>daterange(2017-09-28 ~~ 2017-11-11) |
| Wildcard (since v.18.12) | ? - wildcard character,<br/>?(*N*~*M*) - wildcard character range,<br/>\**N* - wildcard word,<br/>\**N*~~*M* - wildcard word range,<br/>where *N* and *M* are in the range from 0 to 255. | Wildcard characters and wildcard words are used to search for words with unknown characters and phrases with unknown words, respectively. | <ul><li>?ffect - for \'affect\', \'effect\'</li><li>princip?(2\~4) - for \'principal\', \'principle\', \'principles\', \'principally\'</li><li>?(0\~2)sure - for \'assure\', \'ensure\', \'sure\'</li><li>\"\\\"First law \*1 thermodynamics\\\"\" - for \'First law of thermodynamics\'</li><li>\"\\\"Frodo \*1~~5 Pippin\\\"\" - for \'Frodo spoke to Pippin\', \'Frodo stripped the blankets from Pippin\' |
| Escape sequence (since v.19.2) | \\*N*<br/>where *N* can be one of<br/>( ) : \" & &#124; ! ^ ~ \* ? \\<br/>\- or -<br/>s (for space character)<br/>\- or -<br/>u*hhhh*<br/>where *h* is hexadecimal digit (for any Unicode character) | The escape sequence allows a special character to be used in a query as it is. Note that an escaped character must be represented in Alphabet in order for it to be indexed as a valid character (not as Separator). | <ul><li>\\& - escaping & character</li><li>\\~ - escaping ~ character</li><li>\\s - escaping space character</li><li>\\u0026 - escaping & character (Unicode code)</li><li>R\\&B - searching for 'R&B' as a whole word (& character must have an appropriate type in Alphabet before indexing) |

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Text file encoding detection

Path: /search/java/text-file-encoding-detection/

To automatically detect the encoding of a text file, the [setAutoDetectEncoding](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setAutoDetectEncoding(boolean)) method defined in the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class can be used. Passing the true value as an argument to this method allows to detect the following encodings:

*   UTF-32 LE,
*   UTF-32 BE,
*   UTF-16 LE,
*   UTF-16 BE,
*   UTF-8,
*   UTF-7,
*   ANSI.

By default, the encoding auto detection of text files is disabled. But in any case, the encoding of a text file can be set during indexing when the [FileIndexing](https://reference.groupdocs.com/search/java/com.groupdocs.search.events/EventHub#FileIndexing) event is raised. If the encoding of a text file has not been detected or specified in the event arguments, then the default encoding, UTF-8, is used. Available encodings are presented in the [Encodings](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/Encodings) class. When the encoding of a text file is detected and used for indexing, it is saved in the index to use in such methods of [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class like [highlight](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#highlight(com.groupdocs.search.results.FoundDocument,%20com.groupdocs.search.highlighters.Highlighter)) and [getDocumentText](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getDocumentText(com.groupdocs.search.results.DocumentInfo,%20com.groupdocs.search.common.OutputAdapter)).

The example below shows how to set encoding of a text during indexing.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.getEvents().FileIndexing.add(new EventHandler<FileIndexingEventArgs>() {
    public void invoke(Object sender, FileIndexingEventArgs args) {
        if (args.getDocumentFullPath().endsWith(".txt")) {
            args.setEncoding(Encodings.Windows_1253); // Setting encoding for each text file
        }
    }
});
 
// Indexing documents from the specified folder
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Text file encoding detection

Path: /search/net/text-file-encoding-detection/

To automatically detect encoding of a text file, the [AutoDetectEncoding](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/autodetectencoding) property defined in the [IndexingOptions](https://reference.groupdocs.com/search/net/groupdocs.search.options/indexingoptions/) class can be used. Setting this property to true allows to detect the following encodings:

*   UTF-32 LE,
*   UTF-32 BE,
*   UTF-16 LE,
*   UTF-16 BE,
*   UTF-8,
*   UTF-7,

By default, the encoding auto detection of text files is disabled. But in any case, the encoding of a text file can be set during indexing when the [FileIndexing](https://reference.groupdocs.com/net/search/groupdocs.search.events/eventhub/events/fileindexing) event is raised. If the encoding of a text file has not been detected or specified in the event arguments, then the default encoding, UTF-8, is used. Available encodings are presented in the [Encodings](https://reference.groupdocs.com/net/search/groupdocs.search.common/encodings) class. When the encoding of a text file is detected and used for indexing, it is saved in the index to use in such methods of [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class like [Highlight](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/highlight/index) and [GetDocumentText](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getdocumenttext/index).

The example below shows how to set encoding of a text during indexing.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Subscribing to the event
index.Events.FileIndexing += (sender, args) =>
{
    if (args.DocumentFullPath.EndsWith(".txt", StringComparison.InvariantCultureIgnoreCase))
    {
        args.Encoding = Encodings.Windows_1253; // Setting encoding for each text file
    }
};
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
```

External tools, such as Utf.Unknown, can be used to determine the encoding of a text file during indexing.
Any encoding can be detected, including ANSI.

```
PM> NuGet\Install-Package UTF.Unknown
```

Below is an example of using the external library to determine the encoding of a text file.

**C#**

```csharp
index.Events.FileIndexing += (sender, args) =>
{
    byte[] data = File.ReadAllBytes(args.DocumentFullPath);
    UtfUnknown.DetectionResult result = UtfUnknown.CharsetDetector.DetectFromBytes(data);
    if (result.Detected != null)
    {
        Console.WriteLine("Encoding detected: " + result.Detected.EncodingName);
        args.Encoding = result.Detected.EncodingName;
    }
};
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Text file encoding detection

Path: /search/nodejs-java/text-file-encoding-detection/

To automatically detect the encoding of a text file, the [setAutoDetectEncoding](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setAutoDetectEncoding(boolean)) method defined in the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class can be used. Passing the true value as an argument to this method allows to detect the following encodings:

*   UTF-32 LE,
*   UTF-32 BE,
*   UTF-16 LE,
*   UTF-16 BE,
*   UTF-8,
*   UTF-7,
*   ANSI.

By default, the encoding auto detection of text files is disabled. But in any case, the encoding of a text file can be set during indexing when the [FileIndexing](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.events/EventHub#FileIndexing) event is raised. If the encoding of a text file has not been detected or specified in the event arguments, then the default encoding, UTF-8, is used. Available encodings are presented in the [Encodings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/Encodings) class. When the encoding of a text file is detected and used for indexing, it is saved in the index to use in such methods of [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class like [highlight](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#highlight(com.groupdocs.search.results.FoundDocument,%20com.groupdocs.search.highlighters.Highlighter)) and [getDocumentText](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getDocumentText(com.groupdocs.search.results.DocumentInfo,%20com.groupdocs.search.common.OutputAdapter)).

The example below shows how to set encoding of a text during indexing.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Subscribing to the event
index.getEvents().FileIndexing.add(
  java.newProxy('com.groupdocs.search.events.EventHandler', {
    invoke: function (sender, args) {
      if (args.getDocumentFullPath().endsWith('.txt')) {
        args.setEncoding(groupdocs.search.Encodings.utf_32); // Setting encoding for each text file
      }
    },
  }),
);

// Indexing documents from the specified folder
index.add(documentsFolder);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Apply Formatting to Numbers, Dates, and Text in C#

Path: /assembly/net/basic-usage-formatting/


## Overview

GroupDocs.Assembly for .NET provides comprehensive formatting capabilities for numbers, dates, and text in templates. You can use format strings (similar to .NET formatting) and built-in text transformation functions to control how data is displayed in your documents.

The main syntax elements are:
- Format strings: `<<[expression]:"format">>` - apply .NET format strings
- Text functions: `upper`, `lower`, `capital`, `firstcap` - transform text case

Here are the steps to apply formatting:

* Use format strings in expression tags for numbers and dates
* Apply text transformation functions for string formatting
* Combine formatting with expressions and calculations
* Test formatting to ensure desired output

{{< alert style="info" >}}
Format strings follow .NET formatting conventions. Use standard numeric format specifiers (C, N, F, etc.) and date/time format strings (yyyy-MM-dd, etc.).
{{< /alert >}}

## Format Numbers

Format numeric values using format strings:

```csharp
using GroupDocs.Assembly;

public class Invoice
{
    public decimal Amount { get; set; }
    public double Percentage { get; set; }
    public int Quantity { get; set; }
}

public static void FormatNumbers()
{
    var invoice = new Invoice
    {
        Amount = 1500.75m,
        Percentage = 0.15,
        Quantity = 25
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("FormattingTemplate.docx", "FormattingOutput.docx", 
        new DataSourceInfo(invoice, "invoice"));
    
    Console.WriteLine("Numbers formatted successfully.");
}
```

## Template Examples for Number Formatting

In your template, use format strings:

```
Amount: <<[invoice.Amount]:"C">>
Percentage: <<[invoice.Percentage]:"P">>
Quantity: <<[invoice.Quantity]:"N0">>
```

Common numeric format strings:
- `"C"` - Currency (e.g., $1,500.75)
- `"N"` or `"N2"` - Number with decimals (e.g., 1,500.75)
- `"F"` or `"F2"` - Fixed-point (e.g., 1500.75)
- `"P"` - Percentage (e.g., 15.00%)
- `"D"` - Decimal (for integers)

## Format Dates and Times

Format date-time values:

```csharp
using GroupDocs.Assembly;
using System;

public class Report
{
    public DateTime CreatedDate { get; set; }
    public DateTime DueDate { get; set; }
}

public static void FormatDates()
{
    var report = new Report
    {
        CreatedDate = new DateTime(2024, 1, 15, 14, 30, 0),
        DueDate = new DateTime(2024, 2, 15)
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("FormattingTemplate.docx", "FormattingOutput.docx", 
        new DataSourceInfo(report, "report"));
    
    Console.WriteLine("Dates formatted successfully.");
}
```

## Template Examples for Date Formatting

```
Created: <<[report.CreatedDate]:"yyyy-MM-dd HH:mm">>
Due Date: <<[report.DueDate]:"MMMM dd, yyyy">>
```

Common date format strings:
- `"yyyy-MM-dd"` - 2024-01-15
- `"MM/dd/yyyy"` - 01/15/2024
- `"MMMM dd, yyyy"` - January 15, 2024
- `"dd.MM.yyyy"` - 15.01.2024
- `"HH:mm"` - 14:30

## Format Text (Case Transformation)

Transform text case using built-in functions:

```csharp
using GroupDocs.Assembly;

public class Product
{
    public string Name { get; set; }
    public string Description { get; set; }
}

public static void FormatText()
{
    var product = new Product
    {
        Name = "laptop computer",
        Description = "HIGH-PERFORMANCE DEVICE"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("FormattingTemplate.docx", "FormattingOutput.docx", 
        new DataSourceInfo(product, "product"));
    
    Console.WriteLine("Text formatted successfully.");
}
```

## Template Examples for Text Formatting

```
Name: <<[product.Name]:upper>>
Description: <<[product.Description]:lower>>
Title: <<[product.Name]:capital>>
```

Text transformation functions:
- `:upper` - Convert to UPPERCASE
- `:lower` - Convert to lowercase
- `:capital` - Capitalize Each Word
- `:firstcap` - Capitalize First Letter Only

## Combine Formatting with Calculations

Format calculated values:

```csharp
using GroupDocs.Assembly;

public class Order
{
    public int Quantity { get; set; }
    public decimal UnitPrice { get; set; }
}

public static void FormatCalculations()
{
    var order = new Order
    {
        Quantity = 5,
        UnitPrice = 29.99m
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("FormattingTemplate.docx", "FormattingOutput.docx", 
        new DataSourceInfo(order, "order"));
    
    Console.WriteLine("Calculations formatted successfully.");
}
```

Template:

```
Quantity: <<[order.Quantity]>>
Unit Price: <<[order.UnitPrice]:"C">>
Total: <<[order.Quantity * order.UnitPrice]:"C">>
```

## Custom Numeric Formats

Use custom format strings for specific requirements:

```csharp
using GroupDocs.Assembly;

public static void CustomNumericFormats()
{
    var data = new { 
        Phone = 1234567890,
        Code = 42,
        Rate = 0.1234
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("FormattingTemplate.docx", "FormattingOutput.docx", 
        new DataSourceInfo(data, "data"));
    
    Console.WriteLine("Custom formats applied successfully.");
}
```

Template with custom formats:

```
Phone: <<[data.Phone]:"(###) ###-####">>
Code: <<[data.Code]:"000">>
Rate: <<[data.Rate]:"0.00%">>
```

## Formatting in Different Document Types

Formatting works consistently across document types:

```csharp
using GroupDocs.Assembly;

public static void FormatInSpreadsheet()
{
    var invoice = new Invoice
    {
        Amount = 1500.75m,
        CreatedDate = DateTime.Now
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("FormattingTemplate.xlsx", "FormattingOutput.xlsx", 
        new DataSourceInfo(invoice, "invoice"));
    
    Console.WriteLine("Formatting applied in spreadsheet successfully.");
}
```

{{< alert style="warning" >}}
Format strings are case-sensitive. Use uppercase letters for standard format specifiers (C, N, F, P) and follow .NET formatting conventions exactly.
{{< /alert >}}

### Advanced Usage Topics

To learn more about custom format providers, culture-specific formatting, and advanced formatting scenarios, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Convert to GIS formats with advanced options

Path: /conversion/net/convert-to-gis-with-advanced-options/


GroupDocs.Conversion provides the [GisConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/gisconvertoptions) class to specify GIS (Geographic Information System) file format conversion settings.

## Supported GIS Formats

The following GIS (Geographic Information System) formats are supported:

| Format | Extension | Description |
|--------|-----------|-------------|
| **GeoJSON** | .geojson | JSON-based format for geographical features |
| **KML** | .kml | Keyhole Markup Language (Google Earth) |
| **GPX** | .gpx | GPS Exchange Format |
| **TopoJSON** | .topojson | GeoJSON extension with topology encoding |
| **GML** | .gml | Geography Markup Language (XML-based) |
| **OSM** | .osm | OpenStreetMap XML format |
| **SHP** | .shp | ESRI Shapefile |
| **GDB** | .gdb | ESRI Geodatabase |

## Properties

**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired GIS file format. Available options are: *GeoJson, Kml, Gpx, TopoJson, Gml, Osm, Shp, Gdb*.

## Conversion Examples

GisConvertOptions supports conversion between GIS formats. The following examples demonstrate common conversions.

### GeoJSON to KML

Convert a GeoJSON file to KML (Keyhole Markup Language) for Google Earth:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "geographic-data.geojson";
string outputFile = "geographic-data.kml";

using (var converter = new Converter(sourceFile))
{
    var options = new GisConvertOptions
    {
        Format = GisFileType.Kml
    };
    converter.Convert(outputFile, options);
}
```

### GPX to GeoJSON

Convert a GPX (GPS Exchange Format) file to GeoJSON:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "tracking-route.gpx";
string outputFile = "tracking-route.geojson";

using (var converter = new Converter(sourceFile))
{
    var options = new GisConvertOptions
    {
        Format = GisFileType.GeoJson
    };
    converter.Convert(outputFile, options);
}
```

### GeoJSON to TopoJSON

Convert a GeoJSON file to TopoJSON format for topology-preserving conversions:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.FileTypes;

string sourceFile = "map-boundaries.geojson";
string outputFile = "map-boundaries.topojson";

using (var converter = new Converter(sourceFile))
{
    var options = new GisConvertOptions
    {
        Format = GisFileType.TopoJson
    };
    converter.Convert(outputFile, options);
}
```

## Format Support Notes

GIS to GIS conversions are supported for most format combinations:
- GeoJSON → KML, GPX, TopoJSON, GML
- KML → GeoJSON, GPX, TopoJSON
- GPX → GeoJSON, KML, TopoJSON
- GML → GeoJSON, KML, GPX, TopoJSON
- OSM → GeoJSON, KML, GPX, TopoJSON
- TopoJSON → GeoJSON, KML, GPX

**Note:** To convert FROM GIS formats to PDF, images, or other document formats, use [PdfConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-pdf-with-advanced-options.md" >}}), [ImageConvertOptions]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-image-with-advanced-options.md" >}}), or other appropriate ConvertOptions classes.

## More Resources

- [API Reference: GisConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/gisconvertoptions)
- [API Reference: GisFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/gisfiletype)
- [Convert GIS Formats]({{< ref "conversion/net/developer-guide/basic-usage/convert/gis.md" >}})
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})

---

## Load SVG document with options

Path: /conversion/net/load-svg-document-with-options/

[**GroupDocs.Conversion**](https://products.groupdocs.com/conversion/net) provides [SvgLoadOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/svgloadoptions) to control how source SVG (Scalable Vector Graphics) files are processed.

The following options are available:

| Option | Description |
|--------|-------------|
|**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/svgloadoptions/format)** | The document type is auto-detected during loading, but you can explicitly specify the source format as SVG |
|**[MinimumWidth](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/svgloadoptions/minimumwidth)** | Set minimum width for converting SVG document. Used when converting to raster formats. Default value is 800. |
|**[MinimumHeight](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/svgloadoptions/minimumheight)** | Set minimum height for converting SVG document. Used when converting to raster formats. Default value is 600. |
|**[CropToContentBounds](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.load/svgloadoptions/croptocontentbounds)** | Gets or sets a value indicating whether to crop the SVG bounding box to the content bounds before conversion. Default value is false. |

## Load SVG file

The following code snippet shows how to load an SVG file with explicit format specification:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SvgLoadOptions
{
    Format = PageDescriptionLanguageFileType.Svg
};

using (Converter converter = new Converter("vector-graphic.svg", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("vector-graphic.pdf", options);
}
```

## Load SVG with custom dimensions

The following code snippet shows how to load an SVG file with custom minimum dimensions for raster format conversion:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SvgLoadOptions
{
    Format = PageDescriptionLanguageFileType.Svg,
    MinimumWidth = 1200,
    MinimumHeight = 900
};

using (Converter converter = new Converter("logo.svg", getLoadOptions))
{
    ImageConvertOptions options = new ImageConvertOptions
    {
        Format = ImageFileType.Png
    };
    converter.Convert("logo.png", options);
}
```

## Load SVG with crop to content bounds

The following code snippet shows how to load an SVG file with cropping to content bounds:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SvgLoadOptions
{
    Format = PageDescriptionLanguageFileType.Svg,
    CropToContentBounds = true
};

using (Converter converter = new Converter("icon.svg", getLoadOptions))
{
    PdfConvertOptions options = new PdfConvertOptions();
    converter.Convert("icon.pdf", options);
}
```

## Convert SVG to page description language format

The following code snippet shows how to load an SVG file and convert it to XPS format:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SvgLoadOptions
{
    Format = PageDescriptionLanguageFileType.Svg
};

using (Converter converter = new Converter("diagram.svg", getLoadOptions))
{
    PageDescriptionLanguageConvertOptions options = new PageDescriptionLanguageConvertOptions
    {
        Format = PageDescriptionLanguageFileType.Xps
    };
    converter.Convert("diagram.xps", options);
}
```

## Convert SVG to Word document

The following code snippet shows how to load an SVG file and convert it to a Word document:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SvgLoadOptions
{
    Format = PageDescriptionLanguageFileType.Svg
};

using (Converter converter = new Converter("infographic.svg", getLoadOptions))
{
    WordProcessingConvertOptions options = new WordProcessingConvertOptions();
    converter.Convert("infographic.docx", options);
}
```

## Convert SVG to HTML

The following code snippet shows how to load an SVG file and convert it to HTML:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Options.Load;

Func<LoadContext, LoadOptions> getLoadOptions = loadContext => new SvgLoadOptions
{
    Format = PageDescriptionLanguageFileType.Svg
};

using (Converter converter = new Converter("chart.svg", getLoadOptions))
{
    WebConvertOptions options = new WebConvertOptions();
    converter.Convert("chart.html", options);
}
```

---

## Merge TEX

Path: /merger/java/merge/tex/


## How to merge TEX files in Java

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to merge TEX files when it's needed to organize multiple
 TEX files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine TEX documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge TEX files with several lines of java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source TEX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TEX file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other TEX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged TEX file as parameter.

```java
// Load the source TEX file
Merger merger = new Merger("c:\sample1.tex")

// Add another TEX file to merge
merger.join("c:\sample2.tex");
// Merge TEX files and save result
merger.save("c:\merged.tex");
```

### About TEX File Format 

TeX is a language that consists of programming as well as mark-up features, used to typeset documents. Donald Knuth from Stanford University, is the creator of this resourceful typesetting system. Across the world, TeX is the ultimate choice of authors and publishers to produce high quality technical documents. TeX performs an outstanding job of formatting complex mathematical expressions. In conjunction with a high-quality phototypesetter, TeX competes the results generated by the best traditional typesetting systems.

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TEX Live Demo 

GroupDocs.Merger for Java provides an online [**TEX Merger App**](https://products.groupdocs.app/merger/tex), which allows you to try it for free and check its quality and accuracy.

[!["Merge TEX"](/merger/java/images/merge/merge-tex.png)](https://products.groupdocs.app/merger/tex)
---

## Search options

Path: /search/java/search-options/

This page contains a description of all search options that can be specified in an instance of the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class.

## setCancellation method

The [setCancellation](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method allows you to specify the object to cancel the search operation. The search can be canceled without delay by calling the [Cancel](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/Cancellation#cancel()) method or by calling the [CancelAfter](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/Cancellation#cancelAfter(int)) method with the delay in milliseconds as an argument.

## getDateFormats method

The [getDateFormats](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#getDateFormats()) method returns a collection of date formats that allows you to specify formats for the date range search feature. For details, see the [Date range search]({{< ref "search/java/developer-guide/advanced-usage/searching/date-range-search.md" >}}) page.

## getFuzzySearch method

The [getFuzzySearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#getFuzzySearch()) method returns a fuzzy search options object that allows you to enable fuzzy search and set its options. By default, the fuzzy search feature is disabled. For details, see the [Fuzzy search]({{< ref "search/java/developer-guide/advanced-usage/searching/fuzzy-search.md" >}}) page.

## setChunkSearch method

The [setChunkSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setChunkSearch(boolean)) method allows you to enable search by chunks. By default, the search by chunks feature is disabled. For details, see the [Search by chunks]({{< ref "search/java/developer-guide/advanced-usage/searching/search-by-chunks.md" >}}) page.

## getKeyboardLayoutCorrector method

The [getKeyboardLayoutCorrector](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#getKeyboardLayoutCorrector()) method returns a keyboard layout corrector options object, which allows you to enable keyboard layout correction in search queries. By default, the keyboard layout correction feature is disabled. See the [Keyboard layout correction]({{< ref "search/java/developer-guide/advanced-usage/searching/keyboard-layout-correction.md" >}}) page for details.

## setMaxOccurrenceCountPerTerm method

The [setMaxOccurrenceCountPerTerm](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setMaxOccurrenceCountPerTerm(int)) method allows you to specify the maximum number of occurrences of each word found that will be returned as a search result. The default value is 100000.

## setMaxTotalOccurrenceCount method

The [setMaxTotalOccurrenceCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setMaxTotalOccurrenceCount(int)) method allows you to specify the maximum number of occurrences in total for all found words, which will be returned as a search result. The default value is 500000.

## setSearchDocumentFilter method

The [setSearchDocumentFilter](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setSearchDocumentFilter(com.groupdocs.search.options.ISearchDocumentFilter)) method allows you to specify the filter of documents returned as a search result. By default, all documents found will be returned as a search result. For details, see the [Document filtering in search result]({{< ref "search/java/developer-guide/advanced-usage/searching/document-filtering-in-search-result.md" >}}) page.

## getSpellingCorrector method

The [getSpellingCorrector](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#getSpellingCorrector()) method returns the spelling corrector options object, which allows you to enable spelling correction in search queries and specify spelling correction options. By default, spelling correction is disabled. See the [Spell checking]({{< ref "search/java/developer-guide/advanced-usage/searching/spell-checking.md" >}}) page for details.

## setUseCaseSensitiveSearch method

The [setUseCaseSensitiveSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setUseCaseSensitiveSearch(boolean)) method allows you to perform case-sensitive search. Please note that case-sensitive search is not compatible with other types of searches. By default, case-insensitive search is performed. For details, see the [Case sensitive search]({{< ref "search/java/developer-guide/advanced-usage/searching/case-sensitive-search.md" >}}) page.

## setUseHomophoneSearch method

The [setUseHomophoneSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setUseHomophoneSearch(boolean)) method allows you to enable homophone search feature. By default, the homophone search feature is disabled. For details, see the [Homophone search]({{< ref "search/java/developer-guide/advanced-usage/searching/homophone-search.md" >}}) page.

## setUseSynonymSearch method

The [setUseSynonymSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setUseSynonymSearch(boolean)) method allows you to enable synonym search feature. By default, the synonym search feature is disabled. For details, see the [Synonym search]({{< ref "search/java/developer-guide/advanced-usage/searching/synonym-search.md" >}}) page.

## setUseWordFormsSearch method

The [setUseWordFormsSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setUseWordFormsSearch(boolean)) method allows you to enable the word forms search feature. By default, the word forms search feature is disabled. For details, see the [Search for different word forms]({{< ref "search/java/developer-guide/advanced-usage/searching/search-for-different-word-forms.md" >}}) page.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search options

Path: /search/net/search-options/

This page contains a description of all search options that can be specified in an instance of the [SearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions) class.

## Cancellation property

The [Cancellation](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/cancellation) property allows you to specify the object to cancel the search operation. The search can be canceled without delay by calling the [Cancel](https://reference.groupdocs.com/net/search/groupdocs.search.common/cancellation/methods/cancel) method or by calling the [CancelAfter](https://reference.groupdocs.com/net/search/groupdocs.search.common/cancellation/methods/cancelafter) method with the delay in milliseconds as an argument.

## DateFormats property

The [DateFormats](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/dateformats) property allows you to specify formats for the date range search feature. For details, see the [Date range search]({{< ref "search/net/developer-guide/advanced-usage/searching/date-range-search.md" >}}) page.

## FuzzySearch property

The [FuzzySearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/fuzzysearch) property returns a fuzzy search options object that allows you to enable fuzzy search and set its options. By default, the fuzzy search feature is disabled. For details, see the [Fuzzy search]({{< ref "search/net/developer-guide/advanced-usage/searching/fuzzy-search.md" >}}) page.

## IsChunkSearch property

The [IsChunkSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/ischunksearch) property allows you to enable search by chunks. By default, the search by chunks feature is disabled. For details, see the [Search by chunks]({{< ref "search/net/developer-guide/advanced-usage/searching/search-by-chunks.md" >}}) page.

## KeyboardLayoutCorrector property

The [KeyboardLayoutCorrector](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/keyboardlayoutcorrector) property returns a keyboard layout corrector options object, which allows you to enable keyboard layout correction in search queries. By default, the keyboard layout correction feature is disabled. See the [Keyboard layout correction]({{< ref "search/net/developer-guide/advanced-usage/searching/keyboard-layout-correction.md" >}}) page for details.

## MaxOccurrenceCountPerTerm property

The [MaxOccurrenceCountPerTerm](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/maxoccurrencecountperterm) property allows you to specify the maximum number of occurrences of each word found that will be returned as a search result. The default value is 100000.

## MaxTotalOccurrenceCount property

The [MaxTotalOccurrenceCount](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/maxtotaloccurrencecount) property allows you to specify the maximum number of occurrences in total for all found words, which will be returned as a search result. The default value is 500000.

## SearchDocumentFilter property

The [SearchDocumentFilter](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/searchdocumentfilter) property allows you to specify the filter of documents returned as a search result. By default, all documents found will be returned as a search result. For details, see the [Document filtering in search result]({{< ref "search/net/developer-guide/advanced-usage/searching/document-filtering-in-search-result.md" >}}) page.

## SpellingCorrector property

The [SpellingCorrector](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/spellingcorrector) property returns the spelling corrector options object, which allows you to enable spelling correction in search queries and specify spelling correction options. By default, spelling correction is disabled. See the [Spell checking]({{< ref "search/net/developer-guide/advanced-usage/searching/spell-checking.md" >}}) page for details.

## UseCaseSensitiveSearch property

The [UseCaseSensitiveSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/usecasesensitivesearch) property allows you to perform case-sensitive search. Please note that case-sensitive search is not compatible with other types of searches. By default, case-insensitive search is performed. For details, see the [Case sensitive search]({{< ref "search/net/developer-guide/advanced-usage/searching/case-sensitive-search.md" >}}) page.

## UseHomophoneSearch property

The [UseHomophoneSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/usehomophonesearch) property allows you to enable homophone search feature. By default, the homophone search feature is disabled. For details, see the [Homophone search]({{< ref "search/net/developer-guide/advanced-usage/searching/homophone-search.md" >}}) page.

## UseSynonymSearch property

The [UseSynonymSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/usesynonymsearch) property allows you to enable synonym search feature. By default, the synonym search feature is disabled. For details, see the [Synonym search]({{< ref "search/net/developer-guide/advanced-usage/searching/synonym-search.md" >}}) page.

## UseWordFormsSearch property

The [UseWordFormsSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/usewordformssearch) property allows you to enable the word forms search feature. By default, the word forms search feature is disabled. For details, see the [Search for different word forms]({{< ref "search/net/developer-guide/advanced-usage/searching/search-for-different-word-forms.md" >}}) page.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search options

Path: /search/nodejs-java/search-options/

This page contains a description of all search options that can be specified in an instance of the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class.

## setCancellation method

The [setCancellation](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setCancellation(com.groupdocs.search.common.Cancellation)) method allows you to specify the object to cancel the search operation. The search can be canceled without delay by calling the [Cancel](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/Cancellation#cancel()) method or by calling the [CancelAfter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/Cancellation#cancelAfter(int)) method with the delay in milliseconds as an argument.

## getDateFormats method

The [getDateFormats](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#getDateFormats()) method returns a collection of date formats that allows you to specify formats for the date range search feature. For details, see the [Date range search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/date-range-search.md" >}}) page.

## getFuzzySearch method

The [getFuzzySearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#getFuzzySearch()) method returns a fuzzy search options object that allows you to enable fuzzy search and set its options. By default, the fuzzy search feature is disabled. For details, see the [Fuzzy search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/fuzzy-search.md" >}}) page.

## setChunkSearch method

The [setChunkSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setChunkSearch(boolean)) method allows you to enable search by chunks. By default, the search by chunks feature is disabled. For details, see the [Search by chunks]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-by-chunks.md" >}}) page.

## getKeyboardLayoutCorrector method

The [getKeyboardLayoutCorrector](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#getKeyboardLayoutCorrector()) method returns a keyboard layout corrector options object, which allows you to enable keyboard layout correction in search queries. By default, the keyboard layout correction feature is disabled. See the [Keyboard layout correction]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/keyboard-layout-correction.md" >}}) page for details.

## setMaxOccurrenceCountPerTerm method

The [setMaxOccurrenceCountPerTerm](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setMaxOccurrenceCountPerTerm(int)) method allows you to specify the maximum number of occurrences of each word found that will be returned as a search result. The default value is 100000.

## setMaxTotalOccurrenceCount method

The [setMaxTotalOccurrenceCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setMaxTotalOccurrenceCount(int)) method allows you to specify the maximum number of occurrences in total for all found words, which will be returned as a search result. The default value is 500000.

## setSearchDocumentFilter method

The [setSearchDocumentFilter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setSearchDocumentFilter(com.groupdocs.search.options.ISearchDocumentFilter)) method allows you to specify the filter of documents returned as a search result. By default, all documents found will be returned as a search result. For details, see the [Document filtering in search result]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/document-filtering-in-search-result.md" >}}) page.

## getSpellingCorrector method

The [getSpellingCorrector](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#getSpellingCorrector()) method returns the spelling corrector options object, which allows you to enable spelling correction in search queries and specify spelling correction options. By default, spelling correction is disabled. See the [Spell checking]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/spell-checking.md" >}}) page for details.

## setUseCaseSensitiveSearch method

The [setUseCaseSensitiveSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setUseCaseSensitiveSearch(boolean)) method allows you to perform case-sensitive search. Please note that case-sensitive search is not compatible with other types of searches. By default, case-insensitive search is performed. For details, see the [Case sensitive search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/case-sensitive-search.md" >}}) page.

## setUseHomophoneSearch method

The [setUseHomophoneSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setUseHomophoneSearch(boolean)) method allows you to enable homophone search feature. By default, the homophone search feature is disabled. For details, see the [Homophone search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/homophone-search.md" >}}) page.

## setUseSynonymSearch method

The [setUseSynonymSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setUseSynonymSearch(boolean)) method allows you to enable synonym search feature. By default, the synonym search feature is disabled. For details, see the [Synonym search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/synonym-search.md" >}}) page.

## setUseWordFormsSearch method

The [setUseWordFormsSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setUseWordFormsSearch(boolean)) method allows you to enable the word forms search feature. By default, the word forms search feature is disabled. For details, see the [Search for different word forms]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-for-different-word-forms.md" >}}) page.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Update index

Path: /search/java/update-index/

This page contains a description of updating indexed documents, as well as updating an index version.

## Update indexed documents

The update operation is used to reindex documents that have been changed, deleted or added to indexed folders. Changing a filter specified by the argument of the [setDocumentFilter](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setDocumentFilter(com.groupdocs.search.DocumentFilter)) method of the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class can also lead to a change in the list of indexed documents.

When updating, the same options can be specified in the instance of the [UpdateOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/UpdateOptions) class, which are set in the [IndexingOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/IndexingOptions) class to specify indexing options. See the [Indexing options]({{< ref "search/java/developer-guide/advanced-usage/indexing/indexing-options.md" >}}) page.

The following example demonstrates how to update an index using 2 threads.



```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentFolder);
 
// Change, delete, add documents in the document folder
// ...
 
UpdateOptions options = new UpdateOptions();
options.setThreads(2); // Setting the number of indexing threads
index.update(options); // Updating the index
```

## Update index version

Sometimes when a new version of the GroupDocs.Search library is released, the format for storing the index on disk changes. In this case, you also need to update the index. However, updating the index version is different. To do this, use the [IndexUpdater](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexUpdater) class. Without updating the index version, loading the index of the previous version will fail.

When the index version is updated, the documents are reindexed and saved in a folder different from the original in the new format. However, the index of old version does not change. The folder containing the old version of the index may be deleted after the update. The following example demonstrates updating a previous version of an index.



```java
String sourceIndexFolder = "c:\\MyOldIndex\\";
String targetIndexFolder = "c:\\MyNewIndex\\";
 
IndexUpdater updater = new IndexUpdater();
 
if (updater.canUpdateVersion(sourceIndexFolder)) {
    // The index of old version does not change
    int result = updater.updateVersion(sourceIndexFolder, targetIndexFolder);
    // Class VersionUpdateResult contains all possible result values
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Update index

Path: /search/net/update-index/

This page contains a description of updating indexed documents, as well as updating an index version.

## Update indexed documents

The update operation is used to reindex documents that have been changed, deleted or added to indexed folders. Changing a filter specified by the [DocumentFilter](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/documentfilter) property of the [IndexSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings) class can also lead to a change in the list of indexed documents.

When updating, the same options can be specified in the instance of the [UpdateOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/updateoptions) class, which are set in the [IndexingOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/indexingoptions) class to specify indexing options. See the [Indexing options]({{< ref "search/net/developer-guide/advanced-usage/indexing/indexing-options.md" >}}) page.

The following example demonstrates how to update an index using 2 threads.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentFolder);
 
// Change, delete, add documents in the document folder
// ...
 
UpdateOptions options = new UpdateOptions();
options.Threads = 2; // Setting the number of indexing threads
index.Update(options); // Updating the index
```

## Update index version

Sometimes when a new version of the GroupDocs.Search library is released, the format for storing the index on disk changes. In this case, you also need to update the index. However, updating the index version is different. To do this, use the [IndexUpdater](https://reference.groupdocs.com/net/search/groupdocs.search/indexupdater) class. Without updating the index version, loading the index of the previous version will fail.

When the index version is updated, the documents are reindexed and saved in a folder different from the original in the new format. However, the index of old version does not change. The folder containing the old version of the index may be deleted after the update. The following example demonstrates updating a previous version of an index.

**C#**

```csharp
string sourceIndexFolder = @"c:\MyOldIndex\";
string targetIndexFolder = @"c:\MyNewIndex\";
 
IndexUpdater updater = new IndexUpdater();
 
if (updater.CanUpdateVersion(sourceIndexFolder))
{
    // The index of old version does not change
    VersionUpdateResult result = updater.UpdateVersion(sourceIndexFolder, targetIndexFolder);
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Update index

Path: /search/nodejs-java/update-index/

This page contains a description of updating indexed documents, as well as updating an index version.

## Update indexed documents

The update operation is used to reindex documents that have been changed, deleted or added to indexed folders. Changing a filter specified by the argument of the [setDocumentFilter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setDocumentFilter(com.groupdocs.search.DocumentFilter)) method of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class can also lead to a change in the list of indexed documents.

When updating, the same options can be specified in the instance of the [UpdateOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/UpdateOptions) class, which are set in the [IndexingOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/IndexingOptions) class to specify indexing options. See the [Indexing options]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/indexing-options.md" >}}) page.

The following example demonstrates how to update an index using 2 threads.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';
const query = 'son';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentFolder);

// Change, delete, add documents in the document folder
// ...

const options = new groupdocs.search.UpdateOptions();
options.setThreads(2); // Setting the number of indexing threads
index.update(options); // Updating the index
```

## Update index version

Sometimes when a new version of the GroupDocs.Search library is released, the format for storing the index on disk changes. In this case, you also need to update the index. However, updating the index version is different. To do this, use the [IndexUpdater](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexUpdater) class. Without updating the index version, loading the index of the previous version will fail.

When the index version is updated, the documents are reindexed and saved in a folder different from the original in the new format. However, the index of old version does not change. The folder containing the old version of the index may be deleted after the update. The following example demonstrates updating a previous version of an index.

```javascript
const sourceIndexFolder = 'c:/MyOldIndex/';
const targetIndexFolder = 'c:/MyNewIndex/';

// Creating updater
const updater = new groupdocs.search.IndexUpdater();

if (updater.canUpdateVersion(sourceIndexFolder)) {
  // The index of old version does not change
  const result = updater.updateVersion(sourceIndexFolder, targetIndexFolder);
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Add Conditional Content with If/Else

Path: /assembly/net/basic-usage-conditional-content/


## Overview

Conditional blocks allow you to display different content in your documents based on data values. GroupDocs.Assembly for .NET supports if/elseif/else syntax similar to C#, enabling you to create dynamic documents that adapt their content based on conditions.

The main syntax elements are:
- `<<if [condition]>>` - display content if condition is true
- `<<elseif [condition]>>` - display content if previous conditions are false and this condition is true
- `<<else>>` - display content if all conditions are false
- `<<if>>` - closing tag

Here are the steps to use conditional content:

* Create a template with conditional blocks
* Define conditions using C# expressions that return boolean values
* Provide content for each condition branch
* Assemble the document with your data

{{< alert style="info" >}}
Conditional expressions must return boolean values. You can use comparison operators (==, !=, <, >, <=, >=), logical operators (&&, ||, !), and method calls that return bool.
{{< /alert >}}

## Simple If/Else Block

Display content based on a simple condition:

```csharp
using GroupDocs.Assembly;

public class Customer
{
    public string Name { get; set; }
    public decimal Balance { get; set; }
}

public static void SimpleConditional()
{
    var customer = new Customer
    {
        Name = "John Doe",
        Balance = 1500.00m
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ConditionalTemplate.docx", "ConditionalOutput.docx", 
        new DataSourceInfo(customer, "customer"));
    
    Console.WriteLine("Conditional content generated successfully.");
}
```

## Template Example for Simple If/Else

In your template (ConditionalTemplate.docx):

```
Customer: <<[customer.Name]>>

<<if [customer.Balance > 1000]>>
Status: Premium Customer
You have a high balance and qualify for special benefits.
<<else>>
Status: Standard Customer
Thank you for your business.
<<if>>
```

## If/Elseif/Else Block

Use multiple conditions with elseif:

```csharp
using GroupDocs.Assembly;

public class Order
{
    public decimal Amount { get; set; }
}

public static void MultipleConditions()
{
    var order = new Order
    {
        Amount = 750.00m
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ConditionalTemplate.docx", "ConditionalOutput.docx", 
        new DataSourceInfo(order, "order"));
    
    Console.WriteLine("Multiple conditions processed successfully.");
}
```

Template with elseif:

```
Order Amount: <<[order.Amount]:"C">>

<<if [order.Amount > 1000]>>
Discount: 10% (Large order discount)
<<elseif [order.Amount > 500]>>
Discount: 5% (Medium order discount)
<<else>>
Discount: No discount available
<<if>>
```

## Conditional Content with Collections

Check if collections have items:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Report
{
    public List<string> Items { get; set; }
}

public static void ConditionalWithCollections()
{
    var report = new Report
    {
        Items = new List<string> { "Item 1", "Item 2", "Item 3" }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ConditionalTemplate.docx", "ConditionalOutput.docx", 
        new DataSourceInfo(report, "report"));
    
    Console.WriteLine("Conditional content with collections generated successfully.");
}
```

Template:

```
<<if [report.Items.Any()]>>
Items:
<<foreach [in report.Items]>>
- <<[report.Items_Text]>>
<</foreach>>
<<else>>
No items available.
<<if>>
```

## Conditional Content in Data Bands

Use conditional blocks within foreach loops:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Product
{
    public string Name { get; set; }
    public decimal Price { get; set; }
    public bool InStock { get; set; }
}

public static void ConditionalInDataBand()
{
    List<Product> products = new List<Product>
    {
        new Product { Name = "Laptop", Price = 999.99m, InStock = true },
        new Product { Name = "Mouse", Price = 29.99m, InStock = false },
        new Product { Name = "Keyboard", Price = 79.99m, InStock = true }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ConditionalTemplate.docx", "ConditionalOutput.docx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Conditional content in data band generated successfully.");
}
```

Template:

```
<<foreach [in products]>>
<<[Name]>> - <<[Price]:"C">>
<<if [InStock]>>
✓ In Stock
<<else>>
✗ Out of Stock
<<if>>

<</foreach>>
```

## Complex Conditions

Use logical operators for complex conditions:

```csharp
using GroupDocs.Assembly;

public class Employee
{
    public int YearsOfService { get; set; }
    public decimal Salary { get; set; }
    public string Department { get; set; }
}

public static void ComplexConditions()
{
    var employee = new Employee
    {
        YearsOfService = 5,
        Salary = 75000m,
        Department = "Engineering"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ConditionalTemplate.docx", "ConditionalOutput.docx", 
        new DataSourceInfo(employee, "employee"));
    
    Console.WriteLine("Complex conditions processed successfully.");
}
```

Template with complex conditions:

```
<<if [employee.YearsOfService >= 5 && employee.Salary > 70000]>>
Eligible for promotion
<<elseif [employee.Department == "Engineering"]>>
Consider for technical leadership
<<else>>
Standard review process
<<if>>
```

## Conditional Formatting

Apply different formatting based on conditions:

```csharp
using GroupDocs.Assembly;

public class Invoice
{
    public decimal Amount { get; set; }
    public bool IsPaid { get; set; }
}

public static void ConditionalFormatting()
{
    var invoice = new Invoice
    {
        Amount = 1500.00m,
        IsPaid = false
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ConditionalTemplate.docx", "ConditionalOutput.docx", 
        new DataSourceInfo(invoice, "invoice"));
    
    Console.WriteLine("Conditional formatting applied successfully.");
}
```

Template:

```
Amount: <<[invoice.Amount]:"C">>

<<if [invoice.IsPaid]>>
Status: PAID
<<else>>
Status: UNPAID - Payment Required
<<if>>
```

## Using Methods in Conditions

Call methods that return boolean values:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Order
{
    public List<OrderItem> Items { get; set; }
    
    public bool HasItems()
    {
        return Items != null && Items.Count > 0;
    }
}

public class OrderItem
{
    public string Name { get; set; }
}

public static void ConditionalWithMethods()
{
    var order = new Order
    {
        Items = new List<OrderItem> { new OrderItem { Name = "Product" } }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("ConditionalTemplate.docx", "ConditionalOutput.docx", 
        new DataSourceInfo(order, "order"));
    
    Console.WriteLine("Conditional with methods processed successfully.");
}
```

Template:

```
<<if [order.HasItems()]>>
Order contains items.
<<else>>
Order is empty.
<<if>>
```

{{< alert style="warning" >}}
Conditional blocks must be properly closed with `<<if>>`. Nested conditional blocks are supported, but ensure proper nesting and closing of all blocks.
{{< /alert >}}

### Advanced Usage Topics

To learn more about table-row conditional blocks, conditional formatting in different document types, and advanced conditional scenarios, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Merge EPUB

Path: /merger/java/merge/epub/


## How to merge EPUB files in Java

You can easily combine multiple EPUB files into one using [GroupDocs.Merger](https://products.groupdocs.com/merger/java) library API and all the files content will be preserved.
The following example demonstrates how to merge EPUB files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source EPUB file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another EPUB file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other EPUB documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged EPUB file as parameter.

```java
// Load the source EPUB file
Merger merger = new Merger("c:\sample1.epub")

// Add another EPUB file to merge
merger.join("c:\sample2.epub");
// Merge EPUB files and save result
merger.save("c:\merged.epub");
```

### About EPUB File Format 

Files with .EPUB extension are an e-book file format that provide a standard digital publication format for publishers and consumers. The format has been so common by now that it is supported by many e-readers and software applications. For example, on Mac OS, the pre-installed Books software provides the support for opening such files. In addition, there are a lot of compatible software available for smartphones, tablets and computers.

### Code Examples

Please find more [use-cases and complete java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge EPUB Live Demo 

GroupDocs.Merger for Java provides an online [**EPUB Merger App**](https://products.groupdocs.app/merger/epub), which allows you to try it for free and check its quality and accuracy.

[!["Merge EPUB"](/merger/java/images/merge/merge-epub.png)](https://products.groupdocs.app/merger/epub)
---

## Merge EPUB

Path: /merger/nodejs-java/merge/epub/


## How to merge EPUB files in Node.js via Java

You can easily combine multiple EPUB files into one using [GroupDocs.Merger](https://products.groupdocs.com/merger/nodejs-java) library API and all the files content will be preserved.
The following example demonstrates how to merge EPUB files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source EPUB file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another EPUB file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other EPUB documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged EPUB file as parameter.

```js
const inputFilePath = `c:/sample1.epub`;
const merger = new groupdocs.merger.Merger(inputFilePath)
const outputPath = `c:/merged.epub`;
merger.join('c:/sample2.epub');
merger.save(outputPath);
```

### About EPUB File Format 

Files with .EPUB extension are an e-book file format that provide a standard digital publication format for publishers and consumers. The format has been so common by now that it is supported by many e-readers and software applications. For example, on Mac OS, the pre-installed Books software provides the support for opening such files. In addition, there are a lot of compatible software available for smartphones, tablets and computers.

### Code Examples

Please find more [use-cases and complete java sources]({{< ref "merger/nodejs-java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge EPUB Live Demo 

GroupDocs.Merger for Node.js via Java provides an online [**EPUB Merger App**](https://products.groupdocs.app/merger/epub), which allows you to try it for free and check its quality and accuracy.

[!["Merge EPUB"](/merger/java/images/merge/merge-epub.png)](https://products.groupdocs.app/merger/epub)
---

## Merge EPUB

Path: /merger/python-net/merge/epub/


## How to merge EPUB files in Python via .NET

You can easily combine multiple EPUB files into one using [GroupDocs.Merger](https://products.groupdocs.com/merger/python-net) library API and all the files content will be preserved.
The following example demonstrates how to merge EPUB files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class and pass source EPUB file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another EPUB file to merge with [join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join) method. Repeat this step for other EPUB documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged EPUB file as parameter.

```python
with gm.Merger("c:/sample1.epub") as merger:
    merger.join("c:/sample2.epub")
    merger.save("c:/merged.epub")
```

### About EPUB File Format 

Files with .EPUB extension are an e-book file format that provide a standard digital publication format for publishers and consumers. The format has been so common by now that it is supported by many e-readers and software applications. For example, on Mac OS, the pre-installed Books software provides the support for opening such files. In addition, there are a lot of compatible software available for smartphones, tablets and computers.

### Code Examples

Please find more [use-cases and complete net sources]({{< ref "merger/python-net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge EPUB Live Demo 

GroupDocs.Merger for Python via .NET provides an online [**EPUB Merger App**](https://products.groupdocs.app/merger/epub), which allows you to try it for free and check its quality and accuracy.

[!["Merge EPUB"](/merger/net/images/merge/merge-epub.png)](https://products.groupdocs.app/merger/epub)
---

## Search reports

Path: /search/java/search-reports/

Each time you perform a search in an index, a report is generated for that search. An array of search reports can be obtained by calling [getSearchReports](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#getSearchReports()) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class. Reports are stored in the index only while the index is loaded into RAM for use. If you reload the index, the reports will not be restored.

You can configure the maximum number of stored reports using the [setMaxSearchReportCount](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings#setMaxSearchReportCount(int)) method of the [IndexSettings](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexSettings) class. The default value is 10. Learn more about index settings on the page [Search index settings]({{< ref "search/java/developer-guide/advanced-usage/creating-an-index/search-index-settings.md" >}}).

Each index search report contains the following information:

*   The start time of the search;
*   The end time of the search;
*   The search duration;
*   The number of documents found;
*   The total number of occurrences found;
*   The search query;
*   The search options.

The following example demonstrates how to get search reports from an index.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Searching in index
SearchResult result1 = index.search("Einstein");
SearchResult result2 = index.search("\"Theory of Relativity\"");
 
// Getting search reports
SearchReport[] reports = index.getSearchReports();
 
// Printing reports to the console
for (SearchReport report : reports) {
    System.out.println("Query: " + report.getTextQuery());
    System.out.println("Time: " + report.getStartTime());
    System.out.println("Duration: " + report.getSearchDuration());
    System.out.println("Documents: " + report.getDocumentCount());
    System.out.println("Occurrences: " + report.getOccurrenceCount());
    System.out.println();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search reports

Path: /search/net/search-reports/

Each time you perform a search in an index, a report is generated for that search. An array of search reports can be obtained by calling [GetSearchReports](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/getsearchreports) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class. Reports are stored in the index only while the index is loaded into RAM for use. If you reload the index, the reports will not be restored.

You can configure the maximum number of stored reports using the [MaxSearchReportCount](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings/properties/maxsearchreportcount) property of the [IndexSettings](https://reference.groupdocs.com/net/search/groupdocs.search/indexsettings) class. The default value is 10. Learn more about index settings on the page [Search index settings]({{< ref "search/net/developer-guide/advanced-usage/creating-an-index/search-index-settings.md" >}}).

Each index search report contains the following information:

*   The start time of the search;
*   The end time of the search;
*   The search duration;
*   The number of documents found;
*   The total number of occurrences found;
*   The search query;
*   The search options.

The following example demonstrates how to get search reports from an index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Searching in index
SearchResult result1 = index.Search("Einstein");
SearchResult result2 = index.Search("\"Theory of Relativity\"");
 
// Getting search reports
SearchReport[] reports = index.GetSearchReports();
 
// Printing reports to the console
foreach (SearchReport report in reports)
{
    Console.WriteLine("Query: " + report.TextQuery);
    Console.WriteLine("Time: " + report.StartTime);
    Console.WriteLine("Duration: " + report.SearchDuration);
    Console.WriteLine("Documents: " + report.DocumentCount);
    Console.WriteLine("Occurrences: " + report.OccurrenceCount);
    Console.WriteLine();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search reports

Path: /search/nodejs-java/search-reports/

Each time you perform a search in an index, a report is generated for that search. An array of search reports can be obtained by calling [getSearchReports](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#getSearchReports()) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class. Reports are stored in the index only while the index is loaded into RAM for use. If you reload the index, the reports will not be restored.

You can configure the maximum number of stored reports using the [setMaxSearchReportCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setMaxSearchReportCount(int)) method of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class. The default value is 10. Learn more about index settings on the page [Search index settings]({{< ref "search/nodejs-java/developer-guide/advanced-usage/creating-an-index/search-index-settings.md" >}}).

Each index search report contains the following information:

*   The start time of the search;
*   The end time of the search;
*   The search duration;
*   The number of documents found;
*   The total number of occurrences found;
*   The search query;
*   The search options.

The following example demonstrates how to get search reports from an index.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Searching in index
const query1 = 'water';
const result1 = index.search(query1);
const query2 = '"Lorem ipsum"';
const result2 = index.search(query2);

// Getting search reports
const reports = index.getSearchReports();

// Printing reports to the console
for (const report of reports) {
  console.log('Query: ' + report.getTextQuery());
  console.log('Time: ' + report.getStartTime());
  console.log('Duration: ' + report.getSearchDuration());
  console.log('Documents: ' + report.getDocumentCount());
  console.log('Occurrences: ' + report.getOccurrenceCount());
  console.log();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge Open Document files

Path: /merger/java/merge/open-document/


### About ODP File Format

ODT files are type of documents created with word processing applications that are based on OpenDocument Text File format. These are created with word processor applications such as free OpenOffice Writer and can hold content such as text, images, objects and styles. The ODT file is to Writer word processor what the DOCX is to Microsoft Word. Several applications including Google Docs and Google’s web-based word processor included with Google Drive can open the ODT files for editing. Microsoft Word can also open ODT files and save it in to other formats such as DOC and DOCX.

### About ODT File Format

ODT files are type of documents created with word processing applications that are based on OpenDocument Text File format. These are created with word processor applications such as free OpenOffice Writer and can hold content such as text, images, objects and styles. The ODT file is to Writer word processor what the DOCX is to Microsoft Word. Several applications including Google Docs and Google’s web-based word processor included with Google Drive can open the ODT files for editing. Microsoft Word can also open ODT files and save it in to other formats such as DOC and DOCX.

### About ODS File Format

Files with ODS extension stand for OpenDocument Spreadsheet Document format that is editable by the user. Data is stored inside the ODF file into rows and columns. It is an XML-based format and is one of the several subtypes in the Open Document Formats (ODF) family. The format is specified as part of the ODF 1.2 specifications published and maintained by OASIS.

## How to merge ODT files

[GroupDocs.Merger](https://products.groupdocs.com/merger/java) allows developers to merge ODT files when it's needed to organize multiple
 ODT files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine ODT documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge ODT files with several lines of Java code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class and pass source ODT file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another ODT file to merge with [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream)) method. Repeat this step for other ODT documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#save(java.io.OutputStream)) method and specify the filename for the merged ODT file as parameter.

```java
// Load the source ODT file
Merger merger = new Merger("c:\sample1.odt")
	
// Add another ODT file to merge
merger.join("c:\sample2.odt");
// Merge ODT files and save result
merger.save("c:\merged.odt");
```

NOTE: You may merge other Open Document formats like ODP, OTP and ODS in the same way as shown above. For this provide files by specifying their names with extension.

### Code Examples

Please find more [use-cases and complete Java sources]({{< ref "merger/java/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge ODT Live Demo

GroupDocs.Merger for Java provides an online [**ODT Merger App**](https://products.groupdocs.app/merger/odt), which allows you to try it for free and check its quality and accuracy.

---

## Search results

Path: /search/java/search-results/

Search results are represented by the [SearchResult](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult) class, an instance of which is returned by the [search](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#search(java.lang.String)) method of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class. The [search](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexRepository#search(java.lang.String)) method of the [IndexRepository](https://reference.groupdocs.com/search/java/com.groupdocs.search/IndexRepository) class also returns an instance of the [SearchResult](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult) class.

The [SearchResult](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult) class contains the following members:

*   The [getDocumentCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getDocumentCount()) method returns the number of documents found.
*   The [getOccurrenceCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getOccurrenceCount()) method returns the total number of occurrences found.
*   The [getTruncated](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getTruncated()) method returns a value indicating that the result is truncated due to limits specified in the search options.
*   The [getWarnings](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getWarnings()) method returns a warnings describing the result, for example, a warning about the presence of stop word in a search query.
*   The [getNextChunkSearchToken](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getNextChunkSearchToken()) method returns a chunk search token to search for the next chunk. For details on search by chunks, see the [Search by chunks]({{< ref "search/java/developer-guide/advanced-usage/searching/search-by-chunks.md" >}}) page.
*   The [getStartTime](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getStartTime()) method returns the start time of the search.
*   The [getEndTime](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getEndTime()) method returns the end time of the search.
*   The [getSearchDuration](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getSearchDuration()) method returns the search duration.
*   The [getFoundDocument](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/SearchResult#getFoundDocument(int)) method returns the found document by index.

The found document is represented by an instance of the [FoundDocument](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument) class. The [FoundDocument](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument) class contains the following members:

*   The [getDocumentInfo](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#getDocumentInfo()) method returns the document info object containing the file path, the file type, the format family, and the inner document path for items of container documents.
*   The [getRelevance](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#getRelevance()) method returns the relevance of the document in the search result.
*   The [getOccurrenceCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#getOccurrenceCount()) method returns the number of occurrences found in the document.
*   The [getFoundFields](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#getFoundFields()) method returns the found document fields.
*   The [getTerms](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#getTerms()) method returns the found terms. The value is evaluated each time the property is accessed based on the data for each document field found.
*   The [getTermSequences](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#getTermSequences()) method returns the found term sequences.
*   The [serialize](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#serialize()) method serializes the current found document instance to a byte array.
*   The [deserialize](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocument#deserialize(byte[])) method deserializes an instance of found document from a byte array.

The found document field is represented by an instance of the [FoundDocumentField](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField) class. The [FoundDocumentField](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField) class contains the following members:

*   The [getFieldName](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#getFieldName()) method returns the field name.
*   The [getOccurrenceCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#getOccurrenceCount()) method returns the number of occurrences found.
*   The [getTerms](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#getTerms()) method returns the terms found.
*   The [getTermsOccurrences](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#getTermsOccurrences()) method returns the occurrences of the found terms.
*   The [getTermSequences](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#getTermSequences()) method returns the term sequences found.
*   The [getTermSequencesOccurrences](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#getTermSequencesOccurrences()) method returns the occurrences of the found term sequences.
*   The [serialize](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#serialize()) method serializes the current found document field instance to a byte array.
*   The [deserialize](https://reference.groupdocs.com/search/java/com.groupdocs.search.results/FoundDocumentField#deserialize(byte[])) method deserializes an instance of found document field from a byte array.

The following example shows how to print information on the documents found in the console.



```java
String indexFolder = "c:\\MyIndex\\";
String documentFolder = "c:\\MyDocuments\\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentFolder);
 
// Creating search options
SearchOptions options = new SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(3)); // Setting the maximum number of differences to 3
 
// Search for documents containing the word 'Einstein' or the phrase 'Theory of Relativity'
SearchResult result = index.search("Einstein OR \"Theory of Relativity\"", options);
 
// Printing the result
System.out.println("Documents: " + result.getDocumentCount());
System.out.println("Total occurrences: " + result.getOccurrenceCount());
for (int i = 0; i < result.getDocumentCount(); i++) {
    FoundDocument document = result.getFoundDocument(i);
    System.out.println("\tDocument: " + document.getDocumentInfo().getFilePath());
    System.out.println("\tOccurrences: " + document.getOccurrenceCount());
    for (FoundDocumentField field : document.getFoundFields()) {
        System.out.println("\t\tField: " + field.getFieldName());
        System.out.println("\t\tOccurrences: " + document.getOccurrenceCount());
        // Printing found terms
        if (field.getTerms() != null) {
            for (int k = 0; k < field.getTerms().length; k++) {
                System.out.println("\t\t\t" + field.getTerms()[k] + " - " + field.getTermsOccurrences()[k]);
            }
        }
        // Printing found phrases
        if (field.getTermSequences() != null) {
            for (int k = 0; k < field.getTermSequences().length; k++) {
                String[] terms = field.getTermSequences()[k];
                String sequence = "";
                for (String term : terms) {
                    sequence += term + " ";
                }
                System.out.println("\t\t\t" + sequence + " - " + field.getTermSequencesOccurrences()[k]);
            }
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search results

Path: /search/net/search-results/

Search results are represented by the [SearchResult](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult) class, an instance of which is returned by the [Search](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/search/index) method of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class. The [Search](https://reference.groupdocs.com/net/search/groupdocs.search/indexrepository/methods/search/index) method of the [IndexRepository](https://reference.groupdocs.com/net/search/groupdocs.search/indexrepository) class also returns an instance of the [SearchResult](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult) class.

The [SearchResult](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult) class contains the following members:

*   The [DocumentCount](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/documentcount) property returns the number of documents found.
*   The [OccurrenceCount](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/occurrencecount) property returns the total number of occurrences found.
*   The [Truncated](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/truncated) property returns a value indicating that the result is truncated due to limits specified in the search options.
*   The [Warnings](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/warnings) property returns a warnings describing the result, for example, a warning about the presence of stop word in a search query.
*   The [NextChunkSearchToken](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/nextchunksearchtoken) property returns a chunk search token to search for the next chunk. For details on search by chunks, see the [Search by chunks]({{< ref "search/net/developer-guide/advanced-usage/searching/search-by-chunks.md" >}}) page.
*   The [StartTime](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/starttime) property returns the start time of the search.
*   The [EndTime](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/endtime) property returns the end time of the search.
*   The [SearchDuration](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/properties/searchduration) property returns the search duration.
*   The [GetFoundDocument](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/methods/getfounddocument) method returns the found document by index.
*   The [GetEnumerator](https://reference.groupdocs.com/net/search/groupdocs.search.results/searchresult/methods/getenumerator) method returns an enumerator that iterates through the collection of the documents found.

The found document is represented by an instance of a [FoundDocument](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument) class. The [FoundDocument](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument) class contains the following members:

*   The [DocumentInfo](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument/properties/documentinfo) property returns the document info object containing the file path, the file type, the format family, and the inner document path for items of container documents.
*   The [Relevance](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument/properties/relevance) property returns the relevance of the document in the search result.
*   The [OccurrenceCount](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument/properties/occurrencecount) property returns the number of occurrences found in the document.
*   The [FoundFields](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument/properties/foundfields) property returns the found document fields.
*   The [Terms](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument/properties/terms) property returns the found terms. The value is evaluated each time the property is accessed based on the data for each document field found.
*   The [TermSequences](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocument/properties/termsequences) property returns the found term sequences.
*   The [Serialize](https://reference.groupdocs.com/search/net/groupdocs.search.results/founddocument/methods/serialize) method serializes the current found document instance to a byte array.
*   The [Deserialize](https://reference.groupdocs.com/search/net/groupdocs.search.results/founddocument/methods/deserialize) method deserializes an instance of found document from a byte array.

The found document field is represented by an instance of a [FoundDocumentField](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield) class. The [FoundDocumentField](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield) class contains the following members:

*   The [FieldName](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield/properties/fieldname) property returns the field name.
*   The [OccurrenceCount](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield/properties/occurrencecount) property returns the number of occurrences found.
*   The [Terms](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield/properties/terms) property returns the terms found.
*   The [TermsOccurrences](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield/properties/termsoccurrences) property returns the occurrences of the found terms.
*   The [TermSequences](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield/properties/termsequences) property returns the term sequences found.
*   The [TermSequencesOccurrences](https://reference.groupdocs.com/net/search/groupdocs.search.results/founddocumentfield/properties/termsequencesoccurrences) property returns the occurrences of the found term sequences.
*   The [Serialize](https://reference.groupdocs.com/search/net/groupdocs.search.results/founddocumentfield/methods/serialize) method serializes the current found document field instance to a byte array.
*   The [Deserialize](https://reference.groupdocs.com/search/net/groupdocs.search.results/founddocumentfield/methods/deserialize) method deserializes an instance of found document field from a byte array.

The following example shows how to print information on the documents found in the console.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentFolder = @"c:\MyDocuments\";
 
// Creating an index
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentFolder);
 
// Creating search options
SearchOptions options = new SearchOptions();
options.FuzzySearch.Enabled = true; // Enabling the fuzzy search
options.FuzzySearch.FuzzyAlgorithm = new TableDiscreteFunction(3); // Setting the maximum number of differences to 3
 
// Search for documents containing the word 'Einstein' or the phrase 'Theory of Relativity'
SearchResult result = index.Search("Einstein OR \"Theory of Relativity\"", options);
 
// Printing the result
Console.WriteLine("Documents: " + result.DocumentCount);
Console.WriteLine("Total occurrences: " + result.OccurrenceCount);
for (int i = 0; i < result.DocumentCount; i++)
{
    FoundDocument document = result.GetFoundDocument(i);
    Console.WriteLine("\tDocument: " + document.DocumentInfo.FilePath);
    Console.WriteLine("\tOccurrences: " + document.OccurrenceCount);
    for (int j = 0; j < document.FoundFields.Length; j++)
    {
        FoundDocumentField field = document.FoundFields[j];
        Console.WriteLine("\t\tField: " + field.FieldName);
        Console.WriteLine("\t\tOccurrences: " + document.OccurrenceCount);
        // Printing found terms
        if (field.Terms != null)
        {
            for (int k = 0; k < field.Terms.Length; k++)
            {
                Console.WriteLine("\t\t\t" + field.Terms[k].PadRight(20) + field.TermsOccurrences[k]);
            }
        }
        // Printing found phrases
        if (field.TermSequences != null)
        {
            for (int k = 0; k < field.TermSequences.Length; k++)
            {
                string sequence = string.Join(" ", field.TermSequences[k]);
                Console.WriteLine("\t\t\t" + sequence.PadRight(30) + field.TermSequencesOccurrences[k]);
            }
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search results

Path: /search/nodejs-java/search-results/

Search results are represented by the [SearchResult](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult) class, an instance of which is returned by the [search](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#search(java.lang.String)) method of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class. The [search](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexRepository#search(java.lang.String)) method of the [IndexRepository](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexRepository) class also returns an instance of the [SearchResult](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult) class.

The [SearchResult](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult) class contains the following members:

*   The [getDocumentCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getDocumentCount()) method returns the number of documents found.
*   The [getOccurrenceCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getOccurrenceCount()) method returns the total number of occurrences found.
*   The [getTruncated](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getTruncated()) method returns a value indicating that the result is truncated due to limits specified in the search options.
*   The [getWarnings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getWarnings()) method returns a warnings describing the result, for example, a warning about the presence of stop word in a search query.
*   The [getNextChunkSearchToken](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getNextChunkSearchToken()) method returns a chunk search token to search for the next chunk. For details on search by chunks, see the [Search by chunks]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/search-by-chunks.md" >}}) page.
*   The [getStartTime](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getStartTime()) method returns the start time of the search.
*   The [getEndTime](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getEndTime()) method returns the end time of the search.
*   The [getSearchDuration](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getSearchDuration()) method returns the search duration.
*   The [getFoundDocument](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/SearchResult#getFoundDocument(int)) method returns the found document by index.

The found document is represented by an instance of the [FoundDocument](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument) class. The [FoundDocument](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument) class contains the following members:

*   The [getDocumentInfo](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#getDocumentInfo()) method returns the document info object containing the file path, the file type, the format family, and the inner document path for items of container documents.
*   The [getRelevance](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#getRelevance()) method returns the relevance of the document in the search result.
*   The [getOccurrenceCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#getOccurrenceCount()) method returns the number of occurrences found in the document.
*   The [getFoundFields](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#getFoundFields()) method returns the found document fields.
*   The [getTerms](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#getTerms()) method returns the found terms. The value is evaluated each time the property is accessed based on the data for each document field found.
*   The [getTermSequences](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#getTermSequences()) method returns the found term sequences.
*   The [serialize](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#serialize()) method serializes the current found document instance to a byte array.
*   The [deserialize](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocument#deserialize(byte[])) method deserializes an instance of found document from a byte array.

The found document field is represented by an instance of the [FoundDocumentField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField) class. The [FoundDocumentField](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField) class contains the following members:

*   The [getFieldName](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#getFieldName()) method returns the field name.
*   The [getOccurrenceCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#getOccurrenceCount()) method returns the number of occurrences found.
*   The [getTerms](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#getTerms()) method returns the terms found.
*   The [getTermsOccurrences](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#getTermsOccurrences()) method returns the occurrences of the found terms.
*   The [getTermSequences](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#getTermSequences()) method returns the term sequences found.
*   The [getTermSequencesOccurrences](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#getTermSequencesOccurrences()) method returns the occurrences of the found term sequences.
*   The [serialize](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#serialize()) method serializes the current found document field instance to a byte array.
*   The [deserialize](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.results/FoundDocumentField#deserialize(byte[])) method deserializes an instance of found document field from a byte array.

The following example shows how to print information on the documents found in the console.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentFolder = 'c:/MyDocuments/';

// Creating an index
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentFolder);

// Creating search options
const options = new groupdocs.search.SearchOptions();
options.getFuzzySearch().setEnabled(true); // Enabling the fuzzy search
options.getFuzzySearch().setFuzzyAlgorithm(new groupdocs.search.TableDiscreteFunction(3)); // Setting the maximum number of differences to 3

// Search for documents containing the word 'water' or the phrase 'Lorem ipsum'
const query = 'water OR "Lorem ipsum"';
const result = index.search(query, options);

// Printing the result
console.log('Documents: ' + result.getDocumentCount());
console.log('Total occurrences: ' + result.getOccurrenceCount());
for (let i = 0; i < result.getDocumentCount(); i++) {
  const document = result.getFoundDocument(i);
  console.log('\tDocument: ' + document.getDocumentInfo().getFilePath());
  console.log('\tOccurrences: ' + document.getOccurrenceCount());
  for (const field of document.getFoundFields()) {
    console.log('\t\tField: ' + field.getFieldName());
    console.log('\t\tOccurrences: ' + document.getOccurrenceCount());
    // Printing found terms
    if (field.getTerms() != null) {
      for (let k = 0; k < field.getTerms().length; k++) {
        console.log('\t\t\t' + field.getTerms()[k] + ' - ' + field.getTermsOccurrences()[k]);
      }
    }
    // Printing found phrases
    if (field.getTermSequences() != null) {
      for (let k = 0; k < field.getTermSequences().length; k++) {
        const terms = field.getTermSequences()[k];
        let sequence = '';
        for (const term of terms) {
          sequence += term + ' ';
        }
        console.log('\t\t\t' + sequence + ' - ' + field.getTermSequencesOccurrences()[k]);
      }
    }
  }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Use Simple Aggregates (Sum, Count, Average)

Path: /assembly/net/basic-usage-aggregates/


## Overview

GroupDocs.Assembly for .NET supports LINQ-based aggregate functions that allow you to calculate sums, counts, averages, and other aggregate values directly in templates. These functions work with collections and enable you to display totals, summaries, and statistical information in your documents.

The main aggregate functions are:
- `Sum()` - calculate sum of numeric values
- `Count()` - count number of items
- `Average()` - calculate average of numeric values
- `Min()` - find minimum value
- `Max()` - find maximum value

Here are the steps to use aggregates:

* Create a template with aggregate expressions
* Use LINQ aggregate methods on collections
* Reference aggregate results in your template
* Assemble the document with your data

{{< alert style="info" >}}
Aggregate functions use LINQ syntax and work with any collection type, including lists, arrays, DataTables, and other enumerable collections.
{{< /alert >}}

## Calculate Sum

Calculate the sum of values in a collection:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class OrderItem
{
    public string ProductName { get; set; }
    public decimal Price { get; set; }
    public int Quantity { get; set; }
}

public static void CalculateSum()
{
    List<OrderItem> items = new List<OrderItem>
    {
        new OrderItem { ProductName = "Laptop", Price = 999.99m, Quantity = 1 },
        new OrderItem { ProductName = "Mouse", Price = 29.99m, Quantity = 2 },
        new OrderItem { ProductName = "Keyboard", Price = 79.99m, Quantity = 1 }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("AggregatesTemplate.docx", "AggregatesOutput.docx", 
        new DataSourceInfo(items, "items"));
    
    Console.WriteLine("Sum calculated successfully.");
}
```

## Template Example for Sum

In your template (AggregatesTemplate.docx):

```
Items:
<<foreach [in items]>>
<<[ProductName]>> - <<[Price]:"C">> x <<[Quantity]>>
<</foreach>>

Total: <<[items.Sum(i => i.Price * i.Quantity)]:"C">>
```

## Calculate Count

Count the number of items in a collection:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void CalculateCount()
{
    List<string> products = new List<string> 
    { 
        "Laptop", 
        "Mouse", 
        "Keyboard", 
        "Monitor" 
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("AggregatesTemplate.docx", "AggregatesOutput.docx", 
        new DataSourceInfo(products, "products"));
    
    Console.WriteLine("Count calculated successfully.");
}
```

Template:

```
Products:
<<foreach [in products]>>
- <<[products_Text]>>
<</foreach>>

Total Products: <<[products.Count()]>>
```

## Calculate Average

Calculate the average of numeric values:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Sale
{
    public decimal Amount { get; set; }
}

public static void CalculateAverage()
{
    List<Sale> sales = new List<Sale>
    {
        new Sale { Amount = 1000.00m },
        new Sale { Amount = 1500.00m },
        new Sale { Amount = 800.00m },
        new Sale { Amount = 1200.00m }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("AggregatesTemplate.docx", "AggregatesOutput.docx", 
        new DataSourceInfo(sales, "sales"));
    
    Console.WriteLine("Average calculated successfully.");
}
```

Template:

```
Sales:
<<foreach [in sales]>>
<<[Amount]:"C">>
<</foreach>>

Average Sale: <<[sales.Average(s => s.Amount)]:"C">>
```

## Calculate Min and Max

Find minimum and maximum values:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void CalculateMinMax()
{
    List<Sale> sales = new List<Sale>
    {
        new Sale { Amount = 1000.00m },
        new Sale { Amount = 1500.00m },
        new Sale { Amount = 800.00m }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("AggregatesTemplate.docx", "AggregatesOutput.docx", 
        new DataSourceInfo(sales, "sales"));
    
    Console.WriteLine("Min and max calculated successfully.");
}
```

Template:

```
Minimum Sale: <<[sales.Min(s => s.Amount)]:"C">>
Maximum Sale: <<[sales.Max(s => s.Amount)]:"C">>
```

## Multiple Aggregates

Use multiple aggregates in the same template:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void MultipleAggregates()
{
    List<OrderItem> items = new List<OrderItem>
    {
        new OrderItem { ProductName = "Laptop", Price = 999.99m, Quantity = 1 },
        new OrderItem { ProductName = "Mouse", Price = 29.99m, Quantity = 2 },
        new OrderItem { ProductName = "Keyboard", Price = 79.99m, Quantity = 1 }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("AggregatesTemplate.docx", "AggregatesOutput.docx", 
        new DataSourceInfo(items, "items"));
    
    Console.WriteLine("Multiple aggregates calculated successfully.");
}
```

Template:

```
Items:
<<foreach [in items]>>
<<[ProductName]>> - <<[Price]:"C">> x <<[Quantity]>>
<</foreach>>

Summary:
Total Items: <<[items.Count()]>>
Total Quantity: <<[items.Sum(i => i.Quantity)]>>
Total Amount: <<[items.Sum(i => i.Price * i.Quantity)]:"C">>
Average Price: <<[items.Average(i => i.Price)]:"C">>
```

## Aggregates with Conditions

Use aggregates with filtered data:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public static void AggregatesWithConditions()
{
    List<OrderItem> items = new List<OrderItem>
    {
        new OrderItem { ProductName = "Laptop", Price = 999.99m, Quantity = 1 },
        new OrderItem { ProductName = "Mouse", Price = 29.99m, Quantity = 2 },
        new OrderItem { ProductName = "Keyboard", Price = 79.99m, Quantity = 1 }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("AggregatesTemplate.docx", "AggregatesOutput.docx", 
        new DataSourceInfo(items, "items"));
    
    Console.WriteLine("Conditional aggregates calculated successfully.");
}
```

Template:

```
High-value items (Price > 100):
<<foreach [in items.Where(i => i.Price > 100)]>>
<<[ProductName]>> - <<[Price]:"C">>
<</foreach>>

Total High-value: <<[items.Where(i => i.Price > 100).Sum(i => i.Price)]:"C">>
```

## Aggregates in Master-Detail Reports

Calculate aggregates for detail records within master records:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class Order
{
    public int OrderId { get; set; }
    public List<OrderItem> Items { get; set; }
}

public static void AggregatesInMasterDetail()
{
    List<Order> orders = new List<Order>
    {
        new Order
        {
            OrderId = 1001,
            Items = new List<OrderItem>
            {
                new OrderItem { ProductName = "Laptop", Price = 999.99m, Quantity = 1 },
                new OrderItem { ProductName = "Mouse", Price = 29.99m, Quantity = 2 }
            }
        }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("AggregatesTemplate.docx", "AggregatesOutput.docx", 
        new DataSourceInfo(orders, "orders"));
    
    Console.WriteLine("Master-detail aggregates calculated successfully.");
}
```

Template:

```
<<foreach [in orders]>>
Order #<<[OrderId]>>
Items:
<<foreach [in Items]>>
  <<[ProductName]>> - <<[Price]:"C">> x <<[Quantity]>>
<</foreach>>
Order Total: <<[Items.Sum(i => i.Price * i.Quantity)]:"C">>
<</foreach>>
```

{{< alert style="warning" >}}
Aggregate functions require collections. Ensure your data source is a collection type (List, Array, DataTable, etc.) when using aggregates.
{{< /alert >}}

### Advanced Usage Topics

To learn more about grouping, filtering with aggregates, custom aggregate functions, and performance optimization, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Search thread safety

Path: /search/java/search-thread-safety/

## Multiple simultaneous searches

Search in an index is a thread safe operation. This means that calls to the [search](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#search(java.lang.String)) and [searchNext](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index#searchNext(com.groupdocs.search.common.ChunkSearchToken)) methods can be made from different threads to the same instance of the [Index](https://reference.groupdocs.com/search/java/com.groupdocs.search/Index) class without any cross-threading problems.

## Search during indexing, updating, optimizing, or merging operation

Simultaneous search from different threads is a thread safe operation and can be performed even during indexing, updating, optimizing, and merging operations.

However, indexing, updating, optimizing, and merging operations themselves cannot be performed at the same time. A new start of one of these operations before the completion of the previous operation will result in an error.

Details on performing these operations can be found in the [Indexing]({{< ref "search/java/developer-guide/advanced-usage/indexing/_index.md" >}}) section and on the [Merge indexes]({{< ref "search/java/developer-guide/advanced-usage/indexing/merge-indexes.md" >}}), [Optimize index]({{< ref "search/java/developer-guide/advanced-usage/indexing/optimize-index.md" >}}), and [Update index]({{< ref "search/java/developer-guide/advanced-usage/indexing/update-index.md" >}}) pages.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search thread safety

Path: /search/net/search-thread-safety/

## Multiple simultaneous searches

Search in an index is a thread safe operation. This means that calls to the [Search](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/search/index) and [SearchNext](https://reference.groupdocs.com/net/search/groupdocs.search/index/methods/searchnext/index) methods can be made from different threads to the same instance of the [Index](https://reference.groupdocs.com/net/search/groupdocs.search/index) class without any cross-threading problems.

## Search during indexing, updating, optimizing, or merging operation

Simultaneous search from different threads is a thread safe operation and can be performed even during indexing, updating, optimizing, and merging operations.

However, indexing, updating, optimizing, and merging operations themselves cannot be performed at the same time. A new start of one of these operations before the completion of the previous operation will result in an error.

Details on performing these operations can be found in the [Indexing]({{< ref "search/net/developer-guide/advanced-usage/indexing/_index.md" >}}) section and on the [Merge indexes]({{< ref "search/net/developer-guide/advanced-usage/indexing/merge-indexes.md" >}}), [Optimize index]({{< ref "search/net/developer-guide/advanced-usage/indexing/optimize-index.md" >}}), and [Update index]({{< ref "search/net/developer-guide/advanced-usage/indexing/update-index.md" >}}) pages.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search thread safety

Path: /search/nodejs-java/search-thread-safety/

## Multiple simultaneous searches

Search in an index is a thread safe operation. This means that calls to the [search](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#search(java.lang.String)) and [searchNext](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index#searchNext(com.groupdocs.search.common.ChunkSearchToken)) methods can be made from different threads to the same instance of the [Index](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/Index) class without any cross-threading problems.

## Search during indexing, updating, optimizing, or merging operation

Simultaneous search from different threads is a thread safe operation and can be performed even during indexing, updating, optimizing, and merging operations.

However, indexing, updating, optimizing, and merging operations themselves cannot be performed at the same time. A new start of one of these operations before the completion of the previous operation will result in an error.

Details on performing these operations can be found in the [Indexing]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/_index.md" >}}) section and on the [Merge indexes]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/merge-indexes.md" >}}), [Optimize index]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/optimize-index.md" >}}), and [Update index]({{< ref "search/nodejs-java/developer-guide/advanced-usage/indexing/update-index.md" >}}) pages.

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Spell checking

Path: /search/java/spell-checking/

During the search, a search query can be checked for spelling errors in words. To enable spelling correction in search queries, the [setEnabled](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SpellingCorrectorOptions#setEnabled(boolean)) method of the spelling corrector options is called with the true value as an argument. By default, the spelling correction is disabled.

The spelling corrector considers the following types of misprints: adding a character, deleting a character, replacing a character, and, optionally, transposing two adjacent characters.

By default, the spelling corrector dictionary contains only English words. To manage the spelling corrector dictionary, see the [Spelling corrector]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/spelling-corrector.md" >}}) page of the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The spelling corrector options class contains the following options:

*   [setMaxMistakeCount](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SpellingCorrectorOptions#setMaxMistakeCount(int)) sets the maximum number of mistakes possible in each word of a search query. The default value is 2.
*   [setOnlyBestResults](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SpellingCorrectorOptions#setOnlyBestResults(boolean)) sets a value indicating whether only the best results will be returned by the spelling corrector. The default value is false.
*   [setOnlyBestResultsRange](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SpellingCorrectorOptions#setOnlyBestResultsRange(byte)) sets the maximum exceeding of the minimum number of mistakes that are found by the spelling corrector. The default value is 0.
*   [setConsiderTranspositions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SpellingCorrectorOptions#setConsiderTranspositions(boolean)) sets a value indicating whether the spelling corrector must consider transposition of two adjacent characters as a single mistake (true) or two mistakes (false). The default value is true.

The following example shows how to perform a search using the spelling correction.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.getSpellingCorrector().setEnabled(true); // Enabling the spelling correction
options.getSpellingCorrector().setMaxMistakeCount(1); // Setting the maximum number of mistakes
options.getSpellingCorrector().setOnlyBestResults(true); // Enabling the option for only the best results of the spelling correction
 
// Search for the word "Rleativity" containing a spelling error
// The word "Relativity" will be found that differs from the search query in two transposed letters
SearchResult result = index.search("Rleativity", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Spell checking

Path: /search/net/spell-checking/

During the search, a search query can be checked for spelling errors in words. To enable spelling correction in search queries, the [Enabled](https://reference.groupdocs.com/net/search/groupdocs.search.options/spellingcorrectoroptions/properties/enabled) property of the spelling corrector options is set to true. By default, the spelling correction is disabled.

The spelling corrector considers the following types of misprints: adding a character, deleting a character, replacing a character, and, optionally, transposing two adjacent characters.

By default, the spelling corrector dictionary contains only English words. To manage the spelling corrector dictionary, see the [Spelling corrector]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/spelling-corrector.md" >}}) page of the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The [SpellingCorrectorOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/spellingcorrectoroptions) class contains the following properties:

*   [MaxMistakeCount](https://reference.groupdocs.com/net/search/groupdocs.search.options/spellingcorrectoroptions/properties/maxmistakecount) is the maximum number of mistakes possible in each word of a search query. The default value is 2.
*   [OnlyBestResults](https://reference.groupdocs.com/net/search/groupdocs.search.options/spellingcorrectoroptions/properties/onlybestresults) is a value indicating whether only the best results will be returned by the spelling corrector. The default value is false.
*   [OnlyBestResultsRange](https://reference.groupdocs.com/net/search/groupdocs.search.options/spellingcorrectoroptions/properties/onlybestresultsrange) is the maximum exceeding of the minimum number of mistakes that are found by the spelling corrector. The default value is 0.
*   [ConsiderTranspositions](https://reference.groupdocs.com/net/search/groupdocs.search.options/spellingcorrectoroptions/properties/considertranspositions) is a value indicating whether the spelling corrector must consider transposition of two adjacent characters as a single mistake (true) or two mistakes (false). The default value is true.

The following example shows how to perform a search using the spelling correction.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Creating a search options instance
SearchOptions options = new SearchOptions();
options.SpellingCorrector.Enabled = true; // Enabling the spelling correction
options.SpellingCorrector.MaxMistakeCount = 1; // Setting the maximum number of mistakes
options.SpellingCorrector.OnlyBestResults = true; // Enabling the option for only the best results of the spelling correction
 
// Search for the word "Rleativity" containing a spelling error
// The word "Relativity" will be found that differs from the search query in two transposed letters
SearchResult result = index.Search("Rleativity", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Spell checking

Path: /search/nodejs-java/spell-checking/

During the search, a search query can be checked for spelling errors in words. To enable spelling correction in search queries, the [setEnabled](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SpellingCorrectorOptions#setEnabled(boolean)) method of the spelling corrector options is called with the true value as an argument. By default, the spelling correction is disabled.

The spelling corrector considers the following types of misprints: adding a character, deleting a character, replacing a character, and, optionally, transposing two adjacent characters.

By default, the spelling corrector dictionary contains only English words. To manage the spelling corrector dictionary, see the [Spelling corrector]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/spelling-corrector.md" >}}) page of the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The spelling corrector options class contains the following options:

*   [setMaxMistakeCount](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SpellingCorrectorOptions#setMaxMistakeCount(int)) sets the maximum number of mistakes possible in each word of a search query. The default value is 2.
*   [setOnlyBestResults](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SpellingCorrectorOptions#setOnlyBestResults(boolean)) sets a value indicating whether only the best results will be returned by the spelling corrector. The default value is false.
*   [setOnlyBestResultsRange](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SpellingCorrectorOptions#setOnlyBestResultsRange(byte)) sets the maximum exceeding of the minimum number of mistakes that are found by the spelling corrector. The default value is 0.
*   [setConsiderTranspositions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SpellingCorrectorOptions#setConsiderTranspositions(boolean)) sets a value indicating whether the spelling corrector must consider transposition of two adjacent characters as a single mistake (true) or two mistakes (false). The default value is true.

The following example shows how to perform a search using the spelling correction.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Creating a search options instance
const options = new groupdocs.search.SearchOptions();
options.getSpellingCorrector().setEnabled(true); // Enabling the spelling correction
options.getSpellingCorrector().setMaxMistakeCount(1); // Setting the maximum number of mistakes
options.getSpellingCorrector().setOnlyBestResults(true); // Enabling the option for only the best results of the spelling correction

// Search for the word "houseohld" containing a spelling error
// The word "household" will be found that differs from the search query in two transposed letters
const query = 'houseohld';
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with Lazy And Recursive Access of Data

Path: /assembly/net/working-with-lazy-and-recursive-access-of-data/

{{< alert style="info" >}}The code uses some of the objects defined in The Business Layer.{{< /alert >}}

## Purpose

At some point, you may want to or trying to use IDataRecord and IDataReader recursively in your application using GroupDocs.Assembly for .NET. But these Interfaces cannot serve the purpose. However, it is quite possible to accomplish the same goal using custom types.
See IDataReader and IDataRecords Implementors [here](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-data-sources).

## Creating Template

![](https://raw.githubusercontent.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/master/Examples/Data/Screenshots/template.PNG)

## Download Template

Get template from here.

*   [Lazy and recursive.docs](https://github.com/atirtahirgroupdocs/GroupDocs_Assembly_NET/blob/master/Examples/Data/Source/Word%20Templates/Lazy%20And%20Recursive.docx?raw=true)

## Generating The Report

{{< gist GroupDocsGists 96a8b32f705ac6c4ecd9cd2ebb698372 >}}



---

## Working with Template Syntax Formatting

Path: /assembly/java/working-with-template-syntax-formatting/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Template Syntax Formats

### Specifying String and Numeric Formats

Learn more about string and numeric formats [here]({{< ref "assembly/java/getting-started/features-overview.md#features-overview-template-syntax-formatsfor-expression-results" >}}).

### Template Syntax

| **Manager**                                                 | **Contract Price**                                           |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| `<<foreach [in getManagers()]>><br /><<[getName()]:upper>>` | `<<[getContracts().sum(<br />  c =><br /> c.getPrice())]:arabicDash>><br /><</foreach>>` |
| **Total:**                                                  | `<<[getManagers().sum(<br />  m => m.getContracts().sum(<br />    c => c.getPrice()))]>>    ` |

### Download Template

Get template from here.

*   [Numeric upper.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Numeric%20upper.docx?raw=true)

### The Code

{{< gist GroupDocsGists e4325ba680fa92b7f2a008f88987d480 >}}



---

## Synonym search

Path: /search/java/synonym-search/

Synonym search allows you to find not only the words specified in the search query, but also the synonyms, words that means the same.

To enable synonym search, you must call the [setUseSynonymSearch](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions#setUseSynonymSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/java/com.groupdocs.search.options/SearchOptions) class with the true value as an argument. By default, synonym search is disabled.

The default synonym dictionary contains synonyms only for the English language. To manage the synonym dictionary, see the [Synonym dictionary]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/synonym-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The following example demonstrates the synonym search.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true); // Enabling synonym search
 
// Search for the word 'answer'
// In addition to the word 'answer', the words 'reply' and 'response' will also be found
SearchResult result = index.search("answer", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Synonym search

Path: /search/net/synonym-search/

Synonym search allows you to find not only the words specified in the search query, but also the synonyms, words that means the same.

To enable synonym search, you must set the [UseSynonymSearch](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions/properties/usesynonymsearch) property of the [SearchOptions](https://reference.groupdocs.com/net/search/groupdocs.search.options/searchoptions) class to true. By default, synonym search is disabled.

The default synonym dictionary contains synonyms only for the English language. To manage the synonym dictionary, see the [Synonym dictionary]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/synonym-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The following example demonstrates the synonym search.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Creating a search options object
SearchOptions options = new SearchOptions();
options.UseSynonymSearch = true; // Enabling synonym search
 
// Search for the word 'answer'
// In addition to the word 'answer', the words 'reply' and 'response' will also be found
SearchResult result = index.Search("answer", options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Synonym search

Path: /search/nodejs-java/synonym-search/

Synonym search allows you to find not only the words specified in the search query, but also the synonyms, words that means the same.

To enable synonym search, you must call the [setUseSynonymSearch](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions#setUseSynonymSearch(boolean)) method of the [SearchOptions](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.options/SearchOptions) class with the true value as an argument. By default, synonym search is disabled.

The default synonym dictionary contains synonyms only for the English language. To manage the synonym dictionary, see the [Synonym dictionary]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/synonym-dictionary.md" >}}) page in the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

The following example demonstrates the synonym search.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Creating a search options object
const options = new groupdocs.search.SearchOptions();
options.setUseSynonymSearch(true); // Enabling synonym search

// Search for the word 'improve'
// In addition to the word 'improve', the words 'better' will also be found
const query = 'improve';
const result = index.search(query, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with Outer Document Insertion

Path: /assembly/java/working-with-outer-document-insertion/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Inserting Documents Dynamically

You can insert contents of outer documents into your reports dynamically using doc tags. A doc tag denotes a placeholder within a template for a document to be inserted during run-time.

```java
<<doc [document_expression]>>
```

{{< alert style="warning" >}}A doc tag can be used almost anywhere in a template document except text-boxes and charts.{{< /alert >}}

An expression declared within a doc tag is used by the engine to load a document to be inserted during run-time. The expression must return a value of one of the following types:

*   A byte array containing document data
*   A Stream instance able to read document data
*   An instance of the Document class
*   A string containing a document URI

{{< alert style="warning" >}}If an expression declared within a doc tag returns a stream object, then the stream is closed by the engine as soon as a corresponding document is loaded.{{< /alert >}}

By default, a document being inserted is not checked against template syntax and is not populated with data. However, you can enable this by using a build switch as follows.

```java
<<doc [document_expression] -build>>
```

When a build switch is used, the engine treats a document being inserted as a template that can access the following data available at the scope of a corresponding doc tag:

*   Data sources
*   Variables
*   A contextual object (see "[Using Contextual Object Member Access](https://docs.aspose.com/display/wordsnet/Template+Syntax#nowhere)" for more information)
*   Known external types (see "[Setting up Known External Types](https://docs.aspose.com/display/wordsnet/Template+Syntax#nowhere)" for more information)

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/java/working-with-groupdocs-assembly-engine/){{< /alert >}}

## Working with Outer Document Insertion 

### Download Templates

Get designed and outer templates from here.

*   [OuterDocInsertion.odt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/OuterDocInsertion.docx?raw=true)
*   [OuterDoc.docx](https://github.com/aliahmedgroupdocs/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/OuterDocument/OuterDoc.docx)

### The Code

{{< gist GroupDocsGists 34b13865c8dda8793d034ad699e0215a >}}

## Outer Document Insertion in Word Processing Formats

{{< alert style="info" >}}This feature is supported by version 18.12 or greater.{{< /alert >}}

### Download Templates

Get designed and outer templates from here.

*   [NestedExternalDocument.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Nested%20External%20Document.docx)
*   [OuterDocument.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/OuterDocument/NestedOuterDocument.docx)

### The Code

{{< gist GroupDocsGists b15426f07e0bea783e56b9c7282af55a >}}

## Outer Document Insertion in Email Formats

{{< alert style="info" >}}This feature is supported by version 18.12 or greater.{{< /alert >}}

### Download Templates

Get designed and outer templates from here.

*   [NestedExternalDocument.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Nested%20External%20Document.msg)
*   [OuterDocument.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/OuterDocument/NestedOuterDocument.docx)

### The Code

{{< gist GroupDocsGists 7340a6f3264cb45bc688a3c1618255d1 >}}



---

## Working with Template Syntax Formatting

Path: /assembly/net/working-with-template-syntax-formatting/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.2.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Template Syntax Formats

### Specifying String and Numeric Formats

Learn more about string and numeric formats [here](http://www.groupdocs.com/docs/display/assemblynet/Features+Overview#FeaturesOverview-TemplateSyntaxFormatsforExpressionResults).

#### Template Syntax

<table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(191, 191, 191); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(191, 191, 191); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(191, 191, 191); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(191, 191, 191); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 456.45pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><table cellspacing="0" cellpadding="0" style="border-collapse: collapse; margin-left: 0pt;"><tbody><tr><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Products</span></p></td><td style="border-bottom-color: rgb(102, 102, 102); border-bottom-style: solid; border-bottom-width: 1.5pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Order</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;"> Price</span></p></td></tr><tr><td colspan="2" style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 445.15pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt; text-align: center;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;if [!</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Any</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">()]&gt;&gt;No data</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">&lt;&lt;else&gt;&gt;&lt;&lt;foreach [in </span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">orders</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">]&gt;&gt;&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Product.</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">ProductName</span><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">] : upper&gt;&gt;</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">P</span><span style="font-family: Calibri; font-size: 11pt;">rice</span><span style="font-family: Calibri; font-size: 11pt;">] : arabicDash&gt;&gt;&lt;&lt;/foreach&gt;&gt;</span></p></td></tr><tr><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 266.8pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt; font-weight: bold;">Total:</span></p></td><td style="border-bottom-color: rgb(153, 153, 153); border-bottom-style: solid; border-bottom-width: 0.75pt; border-left-color: rgb(153, 153, 153); border-left-style: solid; border-left-width: 0.75pt; border-right-color: rgb(153, 153, 153); border-right-style: solid; border-right-width: 0.75pt; border-top-color: rgb(153, 153, 153); border-top-style: solid; border-top-width: 0.75pt; padding-left: 5.03pt; padding-right: 5.03pt; vertical-align: top; width: 167.55pt;"><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&lt;&lt;[</span><span style="font-family: Calibri; font-size: 11pt;">Sum</span><span style="font-family: Calibri; font-size: 11pt;">(c =&gt; c.</span><span style="font-family: Calibri; font-size: 11pt;">P</span><span style="font-family: Calibri; font-size: 11pt;">rice</span><span style="font-family: Calibri; font-size: 11pt;">)]&gt;&gt;&lt;&lt;/if&gt;&gt;</span></p></td></tr><tr style="height: 0pt;"><td style="width: 277.6pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td><td style="width: 178.35pt; border-top-color: initial; border-top-style: none; border-top-width: initial; border-right-color: initial; border-right-style: none; border-right-width: initial; border-bottom-color: initial; border-bottom-style: none; border-bottom-width: initial; border-left-color: initial; border-left-style: none; border-left-width: initial;"></td></tr></tbody></table><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p><p style="margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0pt;"><span style="font-family: Calibri; font-size: 11pt;">&nbsp;</span></p></td></tr></tbody></table>
{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: Working with GroupDocs.Assembly Engine{{< /alert >}}

#### Download Template

Get the template from here.

*   [String\_Numeric\_Formatting.ods](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/String_Numeric_Formatting.odt?raw=true)

#### The Code

{{< gist GroupDocsGists cc1574aacc60dd670dfadd92109bf833 >}}



---

## Updating Fields while Assembling Word Processing Documents

Path: /assembly/java/updating-fields-while-assembling-word-processing-documents/

## Updating Fields

### The Recipe

*   Set up source document template path
*   Set up destination report path
*   Instantiate DocumentAssembler class
*   Set options, **DocumentAssemblyOptions.UPDATE\_FIELDS\_AND\_FORMULAS**
*   Generate report

### Download Template

Get the template from here.

*   [Update field.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Update%20field.docx?raw=true)

### The Code

{{< gist GroupDocsGists e4689a8e711347bb81f1ed7600a1e923 >}}



---

## Using aliases

Path: /search/java/using-aliases/

The use of aliases allows you to reduce the length of search queries in text form. To use an alias in a search query, you must enter the @ symbol with the name of the alias after it without spaces.

Aliases are stored in the alias dictionary. By default the alias dictionary is empty. Detailed information on managing the alias dictionary can be found on the [Alias dictionary]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/alias-dictionary.md" >}}) page of the [Managing dictionaries]({{< ref "search/java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

An example of using aliases for searching is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Adding aliases to the alias dictionary
index.getDictionaries().getAliasDictionary().add("t", "(theory OR relativity)");
index.getDictionaries().getAliasDictionary().add("e", "(Einstein OR Albert)");
 
// Search in the index
SearchResult result = index.search("@t OR @e");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Using aliases

Path: /search/net/using-aliases/

The use of aliases allows you to reduce the length of search queries in text form. To use an alias in a search query, you must enter the @ symbol with the name of the alias after it without spaces.

Aliases are stored in the alias dictionary. By default the alias dictionary is empty. Detailed information on managing the alias dictionary can be found on the [Alias dictionary]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/alias-dictionary.md" >}}) page of the [Managing dictionaries]({{< ref "search/net/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

An example of using aliases for searching is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Adding aliases to the alias dictionary
index.Dictionaries.AliasDictionary.Add("t", "(theory OR relativity)");
index.Dictionaries.AliasDictionary.Add("e", "(Einstein OR Albert)");
 
// Search in the index
SearchResult result = index.Search("@t OR @e");
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Using aliases

Path: /search/nodejs-java/using-aliases/

The use of aliases allows you to reduce the length of search queries in text form. To use an alias in a search query, you must enter the @ symbol with the name of the alias after it without spaces.

Aliases are stored in the alias dictionary. By default the alias dictionary is empty. Detailed information on managing the alias dictionary can be found on the [Alias dictionary]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/alias-dictionary.md" >}}) page of the [Managing dictionaries]({{< ref "search/nodejs-java/developer-guide/advanced-usage/managing-dictionaries/_index.md" >}}) section.

An example of using aliases for searching is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Adding aliases to the alias dictionary
index.getDictionaries().getAliasDictionary().add('t', '(gravida OR promotion)');
index.getDictionaries().getAliasDictionary().add('e', '(viverra OR farther)');

// Search in the index
const query = '@t OR @e';
const result = index.search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with Outer Document Insertion

Path: /assembly/net/working-with-outer-document-insertion/

{{< alert style="info" >}}This feature is supported by version 3.2.0 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Inserting Documents Dynamically

You can insert contents of outer documents to your reports dynamically using doc tags. A doc tag denotes a placeholder within a template for a document to be inserted during run-time.

```csharp
<<doc [document_expression]>>
```

{{< alert style="warning" >}}A doc tag can be used almost anywhere in a template document except text-boxes and charts.{{< /alert >}}

An expression declared within a doc tag is used by the engine to load a document to be inserted during run-time. The expression must return a value of one of the following types:

*   A byte array containing document data
*   A Stream instance able to read document data
*   An instance of the Document class
*   A string containing a document URI

{{< alert style="warning" >}}If an expression declared within a doc tag returns a stream object, then the stream is closed by the engine as soon as a corresponding document is loaded.{{< /alert >}}

By default, a document being inserted is not checked against template syntax and is not populated with data. However, you can enable this by using a build switch as follows.

```csharp
<<doc [document_expression] -build>>
```

When a build switch is used, the engine treats a document being inserted as a template that can access the following data available at the scope of a corresponding doc tag:

*   Data sources
*   Variables
*   A contextual object (see "[Using Contextual Object Member Access](https://docs.aspose.com/display/wordsnet/Template+Syntax#nowhere)" for more information)
*   Known external types (see "[Setting up Known External Types](https://docs.aspose.com/display/wordsnet/Template+Syntax#nowhere)"for more information)

{{< alert style="success" >}}For detailed technical information about syntax, expressions and report generation by the engine, please visit: [Working with GroupDocs.Assembly Engine](https://docs.groupdocs.com/assembly/net/working-with-groupdocs-assembly-engine/){{< /alert >}}

### Working with Outer Document Insertion 

#### Download Templates

Get designed and outer templates from here.

*   [OuterDocInsertion.odt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/OuterDocInsertion.odt?raw=true)
*   [OuterDoc.odt](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/OuterDocuments/outerDoc.odt?raw=true)

#### The Code

{{< gist GroupDocsGists d86e65933ed173d59f1e5109ff20d33b >}}

### Outer Document Insertion in Word Processing Formats

{{< alert style="info" >}}This feature is supported by version 18.12 or greater.{{< /alert >}}

#### Download Templates

Get designed and outer templates from here.

*   [NestedExternalDocument.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Nested%20External%20Document.docx)
*   [OuterDocument.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/OuterDocuments/OuterDocument.docx)

#### The Code

{{< gist GroupDocsGists db91bbaafa91669b04f305bbf909a9cd >}}

### Outer Document Insertion in Email Formats

{{< alert style="info" >}}This feature is supported by version 18.12 or greater.{{< /alert >}}

#### Download Templates

Get designed and outer templates from here.

*   [NestedExternalDocument.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Nested%20External%20Document.msg)
*   [OuterDocument.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/OuterDocuments/OuterDocument.docx)

#### The Code

{{< gist GroupDocsGists 54701f594999260d10a4e6d66fa069e7 >}}

---

## Calculate Formula while Assembling Spreadsheet Documents

Path: /assembly/java/calculate-formula-while-assembling-spreadsheet-documents/

## Calculate Formula

### The Recipe

*   Set up source document template path
*   Set up destination report path
*   Instantiate DocumentAssembler class
*   Set options, **DocumentAssemblyOptions.UPDATE\_FIELDS\_AND\_FORMULAS**
*   Generate report

### Download Template

Get the template from here.

*   [Update formula.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Spreadsheet%20Templates/Update%20formula.xlsx?raw=true)

### The Code

{{< gist GroupDocsGists b6b73ca430d573c372ff100ffab9ebb0 >}}



---

## Generate Email Messages from Data

Path: /assembly/net/basic-usage-generate-emails/


## Overview

GroupDocs.Assembly for .NET enables you to generate email messages dynamically from templates. You can set email attributes like subject, body, and recipients (To, CC, BCC) using template syntax, making it easy to create personalized email messages from data sources.

The main classes involved are:
- [DocumentAssembler](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/) - assembles email messages
- [DataSourceInfo](https://reference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo/) - wraps data sources

Here are the steps to generate email messages:

* Create an email template (MSG or EML format)
* Set email attributes (subject, To, CC, BCC) using template syntax
* Create email body content with data binding
* Assemble the email message with your data source
* Save the assembled email

{{< alert style="info" >}}
Email templates support the same template syntax as Word documents, including expression tags, data bands, conditional blocks, and formatting.
{{< /alert >}}

## Generate Email with Subject and Body

Create a simple email with dynamic subject and body:

```csharp
using GroupDocs.Assembly;

public class EmailData
{
    public string Recipient { get; set; }
    public string Subject { get; set; }
    public string CustomerName { get; set; }
    public decimal InvoiceAmount { get; set; }
}

public static void GenerateEmail()
{
    var emailData = new EmailData
    {
        Recipient = "customer@example.com",
        Subject = "Invoice #1001",
        CustomerName = "John Doe",
        InvoiceAmount = 1500.00m
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("EmailTemplate.msg", "EmailOutput.msg", 
        new DataSourceInfo(emailData, "email"));
    
    Console.WriteLine("Email generated successfully.");
}
```

## Email Template Structure

In your email template (EmailTemplate.msg), set attributes and body:

**Subject field:**
```
<<[email.Subject]>>
```

**To field:**
```
<<[email.Recipient]>>
```

**Body:**
```
Dear <<[email.CustomerName]>>,

Please find your invoice below:

Amount: <<[email.InvoiceAmount]:"C">>

Thank you for your business.
```

## Generate Email with Multiple Recipients

Set multiple recipients using foreach:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class EmailData
{
    public List<string> Recipients { get; set; }
    public string Subject { get; set; }
    public string Message { get; set; }
}

public static void GenerateEmailWithMultipleRecipients()
{
    var emailData = new EmailData
    {
        Recipients = new List<string> 
        { 
            "recipient1@example.com", 
            "recipient2@example.com" 
        },
        Subject = "Important Update",
        Message = "This is an important message for all recipients."
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("EmailTemplate.msg", "EmailOutput.msg", 
        new DataSourceInfo(emailData, "email"));
    
    Console.WriteLine("Email with multiple recipients generated successfully.");
}
```

Template for multiple recipients:

**To field:**
```
<<foreach [r in email.Recipients]>><<[r]>>; <</foreach>>
```

**Body:**
```
<<[email.Message]>>
```

## Generate Email with CC and BCC

Set CC and BCC recipients:

```csharp
using GroupDocs.Assembly;

public class EmailData
{
    public string To { get; set; }
    public string Cc { get; set; }
    public string Bcc { get; set; }
    public string Subject { get; set; }
    public string Body { get; set; }
}

public static void GenerateEmailWithCcBcc()
{
    var emailData = new EmailData
    {
        To = "customer@example.com",
        Cc = "manager@example.com",
        Bcc = "archive@example.com",
        Subject = "Invoice",
        Body = "Please find attached invoice."
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("EmailTemplate.msg", "EmailOutput.msg", 
        new DataSourceInfo(emailData, "email"));
    
    Console.WriteLine("Email with CC and BCC generated successfully.");
}
```

Template:

**To field:**
```
<<[email.To]>>
```

**CC field:**
```
<<[email.Cc]>>
```

**BCC field:**
```
<<[email.Bcc]>>
```

**Body:**
```
<<[email.Body]>>
```

## Generate Email with Rich Content

Create emails with tables, lists, and formatted content:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class OrderEmail
{
    public string CustomerName { get; set; }
    public string Subject { get; set; }
    public List<OrderItem> Items { get; set; }
}

public class OrderItem
{
    public string ProductName { get; set; }
    public decimal Price { get; set; }
}

public static void GenerateRichEmail()
{
    var orderEmail = new OrderEmail
    {
        CustomerName = "John Doe",
        Subject = "Order Confirmation",
        Items = new List<OrderItem>
        {
            new OrderItem { ProductName = "Laptop", Price = 999.99m },
            new OrderItem { ProductName = "Mouse", Price = 29.99m }
        }
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("EmailTemplate.msg", "EmailOutput.msg", 
        new DataSourceInfo(orderEmail, "order"));
    
    Console.WriteLine("Rich email generated successfully.");
}
```

Template body:

```
Dear <<[order.CustomerName]>>,

Thank you for your order. Here are your items:

<<foreach [in order.Items]>>
• <<[ProductName]>> - <<[Price]:"C">>
<</foreach>>

Total: <<[order.Items.Sum(i => i.Price)]:"C">>
```

## Generate Email from Collection

Generate multiple emails from a collection:

```csharp
using GroupDocs.Assembly;
using System.Collections.Generic;

public class CustomerEmail
{
    public string Email { get; set; }
    public string Name { get; set; }
    public string Subject { get; set; }
}

public static void GenerateEmailsFromCollection()
{
    List<CustomerEmail> customers = new List<CustomerEmail>
    {
        new CustomerEmail 
        { 
            Email = "customer1@example.com", 
            Name = "John Doe",
            Subject = "Personalized Message"
        },
        new CustomerEmail 
        { 
            Email = "customer2@example.com", 
            Name = "Jane Smith",
            Subject = "Personalized Message"
        }
    };
    
    // Generate email for each customer
    DocumentAssembler assembler = new DocumentAssembler();
    foreach (var customer in customers)
    {
        string outputPath = $"Email_{customer.Name.Replace(" ", "_")}.msg";
        assembler.AssembleDocument("EmailTemplate.msg", outputPath, 
            new DataSourceInfo(customer, "customer"));
    }
    
    Console.WriteLine("Emails generated from collection successfully.");
}
```

## Set Email From Address

Set the sender (From) address:

```csharp
using GroupDocs.Assembly;

public class EmailData
{
    public string From { get; set; }
    public string To { get; set; }
    public string Subject { get; set; }
}

public static void GenerateEmailWithFrom()
{
    var emailData = new EmailData
    {
        From = "sender@example.com",
        To = "recipient@example.com",
        Subject = "Test Email"
    };
    
    DocumentAssembler assembler = new DocumentAssembler();
    assembler.AssembleDocument("EmailTemplate.msg", "EmailOutput.msg", 
        new DataSourceInfo(emailData, "email"));
    
    Console.WriteLine("Email with From address generated successfully.");
}
```

Template:

**From field:**
```
<<[email.From]>>
```

{{< alert style="warning" >}}
Email templates must be in MSG or EML format. The template structure depends on the email client used to create it. Ensure proper formatting for HTML or RTF email bodies.
{{< /alert >}}

### Advanced Usage Topics

To learn more about email attachments, HTML email bodies, email headers, and advanced email generation scenarios, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Wildcard search

Path: /search/java/wildcard-search/

Wildcard search allows you to search for words with unknown letters or ranges of letters.

In text form of a search query, there are 2 forms of wildcard characters:

*   ? for a single character;
*   ?(*n*~*m*) for a group of characters, where *n* and *m* are numbers from 0 to 255, and *n* <= *m*.

Wildcard search is similar to [regular expression search]({{< ref "search/java/developer-guide/advanced-usage/searching/regular-expression-search.md" >}}), but it works significantly faster when groups of wildcard characters are less and closer to the end of a search query.

It is important to know that wildcard search is flexible enough to use for prefix queries, since prefix query is a special case of a wildcard query.

Examples of wildcard search with queries in text form are presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search in the index
SearchResult result1 = index.search("m?rry"); // Search for 'merry', 'marry', etc.
SearchResult result2 = index.search("card?(1~6)"); // Search for 'cardiff', 'cardinal', 'cardio', 'cards', etc.
```

To build a query for the wildcard search in object form, use the [WordPattern](https://reference.groupdocs.com/search/java/com.groupdocs.search.common/WordPattern) class. This class contains methods for adding known parts of a word and wildcards to a template. An example of constructing a query in object form is presented below.



```java
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.add(documentsFolder);
 
// Search with pattern "m?rry"
// Search for 'merry', 'marry', etc.
WordPattern pattern1 = new WordPattern();
pattern1.appendString("m");
pattern1.appendOneCharacterWildcard();
pattern1.appendString("rry");
SearchQuery query1 = SearchQuery.createWordPatternQuery(pattern1);
SearchResult result1 = index.search(query1);
 
// Search with pattern "card?(1~6)"
// Search for 'cardiff', 'cardinal', 'cardio', 'cards', etc.
WordPattern pattern2 = new WordPattern();
pattern2.appendString("card");
pattern2.appendWildcard(1, 6);
SearchQuery query2 = SearchQuery.createWordPatternQuery(pattern2);
SearchResult result2 = index.search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Wildcard search

Path: /search/net/wildcard-search/

Wildcard search allows you to search for words with unknown letters or ranges of letters.

In text form of a search query, there are 2 forms of wildcard characters:

*   ? for a single character;
*   ?(*n*~*m*) for a group of characters, where *n* and *m* are numbers from 0 to 255, and *n* <= *m*.

Wildcard search is similar to [regular expression search]({{< ref "search/net/developer-guide/advanced-usage/searching/regular-expression-search.md" >}}), but it works significantly faster when groups of wildcard characters are less and closer to the end of a search query.

It is important to know that wildcard search is flexible enough to use for prefix queries, since prefix query is a special case of a wildcard query.

Examples of wildcard search with queries in text form are presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search in the index
SearchResult result1 = index.Search("m?rry"); // Search for 'merry', 'marry', etc.
SearchResult result2 = index.Search("card?(1~6)"); // Search for 'cardiff', 'cardinal', 'cardio', 'cards', etc.
```

To build a query for the wildcard search in object form, use the [WordPattern](https://reference.groupdocs.com/net/search/groupdocs.search.common/wordpattern) class. This class contains methods for adding known parts of a word and wildcards to a template. An example of constructing a query in object form is presented below.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";
 
// Creating an index in the specified folder
Index index = new Index(indexFolder);
 
// Indexing documents from the specified folder
index.Add(documentsFolder);
 
// Search with pattern "m?rry"
// Search for 'merry', 'marry', etc.
WordPattern pattern1 = new WordPattern();
pattern1.AppendString("m");
pattern1.AppendOneCharacterWildcard();
pattern1.AppendString("rry");
SearchQuery query1 = SearchQuery.CreateWordPatternQuery(pattern1);
SearchResult result1 = index.Search(query1);
 
// Search with pattern "card?(1~6)"
// Search for 'cardiff', 'cardinal', 'cardio', 'cards', etc.
WordPattern pattern2 = new WordPattern();
pattern2.AppendString("card");
pattern2.AppendWildcard(1, 6);
SearchQuery query2 = SearchQuery.CreateWordPatternQuery(pattern2);
SearchResult result2 = index.Search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Wildcard search

Path: /search/nodejs-java/wildcard-search/

Wildcard search allows you to search for words with unknown letters or ranges of letters.

In text form of a search query, there are 2 forms of wildcard characters:

*   ? for a single character;
*   ?(*n*~*m*) for a group of characters, where *n* and *m* are numbers from 0 to 255, and *n* <= *m*.

Wildcard search is similar to [regular expression search]({{< ref "search/nodejs-java/developer-guide/advanced-usage/searching/regular-expression-search.md" >}}), but it works significantly faster when groups of wildcard characters are less and closer to the end of a search query.

It is important to know that wildcard search is flexible enough to use for prefix queries, since prefix query is a special case of a wildcard query.

Examples of wildcard search with queries in text form are presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search in the index
const query1 = 'm???is';
const result1 = index.search(query1); // Search for 'mauris', 'mollis', 'mattis', 'magnis', etc.
const query2 = 'pri?(1~7)';
const result2 = index.search(query2); // Search for 'private', 'principles', 'principle', etc.
```

To build a query for the wildcard search in object form, use the [WordPattern](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search.common/WordPattern) class. This class contains methods for adding known parts of a word and wildcards to a template. An example of constructing a query in object form is presented below.

```javascript
const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Search with pattern "m???is"
// Search for 'mauris', 'mollis', 'mattis', 'magnis', etc.
const pattern1 = new groupdocs.search.WordPattern();
pattern1.appendString('m');
pattern1.appendOneCharacterWildcard();
pattern1.appendOneCharacterWildcard();
pattern1.appendOneCharacterWildcard();
pattern1.appendString('is');
const query1 = groupdocs.search.SearchQuery.createWordPatternQuery(pattern1);
const result1 = index.search(query1);

// Search with pattern "pri?(1~7)"
// Search for 'private', 'principles', 'principle', etc.
const pattern2 = new groupdocs.search.WordPattern();
pattern2.appendString('pri');
pattern2.appendWildcard(1, 7);
const query2 = groupdocs.search.SearchQuery.createWordPatternQuery(pattern2);
const result2 = index.search(query2);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Adding NEXT Field into Template Syntax

Path: /assembly/java/adding-next-field-into-template-syntax/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**Template Syntax**

```java
We provide support for the following clients:
•	<<foreach [in getClients()]>><<next>><<[getName()]>>
<</foreach>>
```

## The Recipe

*   Set up the source document template path
*   Set up destination report path
*   Instantiate DocumentAssembler class
*   Generate report

### Download Template

Get the template from here:

*   [Using next.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Using%20next.docx?raw=true)

### The Code

{{< gist GroupDocsGists f5bf95c52059f408b60bd47c1f9c4d7d >}}



---

## Merge PDF

Path: /merger/net/merge/pdf/


## How to merge PDF files in C\#

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to merge PDF files when it's needed to organize multiple
 PDF files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine PDF documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge PDF files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source PDF file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PDF file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other PDF documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PDF file as parameter.

```csharp
// Load the source PDF file
using (Merger merger = new Merger(@"c:\sample1.pdf"))
{
    // Add another PDF file to merge
    merger.Join(@"c:\sample2.pdf");
    // Merge PDF files and save result
    merger.Save(@"c:\merged.pdf");
}
```

### How to merge PDF files with bookmarks in C\#

Also, there is an ability to merge Pdf files with bookmarks, please see an according example below:

```csharp
// Load the source PDF file
using (Merger merger = new Merger(@"c:\sample1.pdf"))
{
    // Init PdfJoinOptions with UseBookmarks flag
    PdfJoinOptions pdfJoinOptions = new PdfJoinOptions();
    pdfJoinOptions.UseBookmarks = true;
    // Add another PDF file to merge
    merger.Join(@"c:\sample2.pdf", pdfJoinOptions);
    // Merge PDF files and save result
    merger.Save(@"c:\merged.pdf");
}
```

### How to correctly merge PDF streams in C\#

You can read the following article: [How to correctly merge PDF streams]({{< ref "merger/net/getting-started/use-cases/how-to-correctly-merge-documents-using-csharp.md" >}})

### About PDF File Format

Portable Document Format (PDF) is a type of document created by Adobe back in the 1990s. The purpose of this file format was to introduce a standard for representation of documents and other reference material in a format that is independent of application software, hardware as well as Operating System. PDF files can be opened in Adobe Acrobat Reader/Writer as well in most modern browsers like Chrome, Safari, Firefox via extensions/plug-ins.

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PDF Live Demo

GroupDocs.Merger for .NET provides an online [**PDF Merger App**](https://products.groupdocs.app/merger/pdf), which allows you to try it for free and check its quality and accuracy.

[!["Merge PDF"](/merger/net/images/merge/merge-pdf.png)](https://products.groupdocs.app/merger/pdf)
---

## Save comparison result in different format

Path: /comparison/python-net/save-comparison-result-in-different-format/


Export the comparison result to a different format (e.g., PDF or HTML) by setting the desired output in `CompareOptions`.

```python
import groupdocs.comparison as gc

with gc.Comparer("source.docx") as comparer:
    comparer.add("target.docx")

    options = gc.CompareOptions()
    options.result_document_format = gc.FileFormat.PDF  # e.g., export result to PDF

    comparer.compare("result.pdf", options)
```

Supported output formats depend on the source file type. Common targets include DOCX, PDF, and HTML.

🔹 Use case: Deliver a PDF diff to stakeholders while keeping DOCX for editing.



---

## Search network node events

Path: /search/java/search-network-node-events/

This page contains information about the purpose and use of all search network events.

## ConfigurationCompleted event

The [ConfigurationCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#ConfigurationCompleted) event occurs when the search network configuration process is finished.

## IndexingCompleted event

The [IndexingCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#IndexingCompleted) event occurs when indexing of all enqueued documents is finished.

## DeletionCompleted event

The [DeletionCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#DeletionCompleted) event occurs when all enqueued deletions of documents are finished.

## OptimizationCompleted event

The [OptimizationCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#OptimizationCompleted) event occurs when optimization of all nodes is finished.

## SynchronizationCompleted event

The [SynchronizationCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#SynchronizationCompleted) event occurs when synchronization with all nodes is finished.

## AttributeChangesCompleted event

The [AttributeChangesCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#AttributeChangesCompleted) event occurs when all enqueued attribute changes are finished.

## StatusChanged event

The [StatusChanged](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#StatusChanged) event occurs when the search network status changes.

## DataExtracted event

The [DataExtracted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#DataExtracted) event occurs when the data has been extracted from a document.

## DocumentIndexed event

The [DocumentIndexed](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#DocumentIndexed) event occurs when a document has been indexed.

## DocumentDeleted event

The [DocumentDeleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#DocumentDeleted) event occurs when a document has been deleted.

## ErrorOccurred event

The [ErrorOccurred](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#ErrorOccurred) event occurs when an error occurs in one of the nodes of the search network.

## IndexingProgressChanged event

The [IndexingProgressChanged](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#IndexingProgressChanged) event occurs when the progress of the indexing operation has changed.

## OptimizationProgressChanged event

The [OptimizationProgressChanged](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#OptimizationProgressChanged) event occurs when the progress of the optimization operation has changed.

## Code example

```java
node.getEvents().IndexingCompleted.add(new EventHandler() {
    @Override
    public void invoke(Object s, EventArgs e) {
        System.out.println("Indexing complete");
    }
});
node.getEvents().DeletionCompleted.add(new EventHandler() {
    @Override
    public void invoke(Object s, EventArgs e) {
        System.out.println("Deleting complete");
    }
});
node.getEvents().OptimizationCompleted.add(new EventHandler() {
    @Override
    public void invoke(Object s, EventArgs e) {
        System.out.println("Optimization complete");
    }
});
node.getEvents().SynchronizationCompleted.add(new EventHandler() {
    @Override
    public void invoke(Object s, EventArgs e) {
        System.out.println("Synchronization complete");
    }
});
node.getEvents().AttributeChangesCompleted.add(new EventHandler() {
    @Override
    public void invoke(Object s, EventArgs e) {
        System.out.println("Attribute changes complete");
    }
});
node.getEvents().StatusChanged.add(new EventHandler<StatusChangedEventArgs>() {
    @Override
    public void invoke(Object s, StatusChangedEventArgs e) {
        System.out.println("Status changed: " + e.getOldStatus().name() + " -> " + e.getNewStatus().name());
    }
});
node.getEvents().DataExtracted.add(new EventHandler<DataExtractedEventArgs>() {
    @Override
    public void invoke(Object s, DataExtractedEventArgs e) {
        System.out.println("Data extracted (" + e.getExtractorIndex() + "): " + e.getDocumentKey());
    }
});
node.getEvents().DocumentIndexed.add(new EventHandler<DocumentIndexedEventArgs>() {
    @Override
    public void invoke(Object s, DocumentIndexedEventArgs e) {
        System.out.println("Document indexed (" + e.getShardIndex() + "): " + e.getDocumentKey());
    }
});
node.getEvents().DocumentDeleted.add(new EventHandler<DocumentDeletedEventArgs>() {
    @Override
    public void invoke(Object s, DocumentDeletedEventArgs e) {
        System.out.println("Document deleted (" + e.getShardIndex() + "): " + e.getDocumentKey());
    }
});
node.getEvents().ErrorOccurred.add(new EventHandler<ErrorOccurredEventArgs>() {
    @Override
    public void invoke(Object s, ErrorOccurredEventArgs e) {
        System.out.println("Error occurred (" + e.getNodeIndex() + ", " + e.getServiceIndex() + "): " + e.getMessage());
    }
});
node.getEvents().IndexingProgressChanged.add(new EventHandler<NetworkIndexingProgressEventArgs>() {
    @Override
    public void invoke(Object s, NetworkIndexingProgressEventArgs e) {
        System.out.println("Indexing progress changed (" + e.getNodeIndex() + ", " + e.getServiceIndex() + "): " + e.getProgressPercentage());
    }
});
node.getEvents().OptimizationProgressChanged.add(new EventHandler<NetworkOptimizationProgressEventArgs>() {
    @Override
    public void invoke(Object s, NetworkOptimizationProgressEventArgs e) {
        System.out.println("Optimization progress changed (" + e.getNodeIndex() + ", " + e.getServiceIndex() + "): " + e.getProgressPercentage());
    }
});
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Search network node events

Path: /search/net/search-network-node-events/

This page contains information about the purpose and use of all search network events.

## ConfigurationCompleted event

The [ConfigurationCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/configurationcompleted/) event occurs when the search network configuration process is finished.

## IndexingCompleted event

The [IndexingCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/indexingcompleted/) event occurs when indexing of all enqueued documents is finished.

## DeletionCompleted event

The [DeletionCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/deletioncompleted/) event occurs when all enqueued deletions of documents are finished.

## OptimizationCompleted event

The [OptimizationCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/optimizationcompleted/) event occurs when optimization of all nodes is finished.

## SynchronizationCompleted event

The [SynchronizationCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/synchronizationcompleted/) event occurs when synchronization with all nodes is finished.

## AttributeChangesCompleted event

The [AttributeChangesCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/attributechangescompleted/) event occurs when all enqueued attribute changes are finished.

## StatusChanged event

The [StatusChanged](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/statuschanged/) event occurs when the search network status changes.

## DataExtracted event

The [DataExtracted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/dataextracted/) event occurs when the data has been extracted from a document.

## DocumentIndexed event

The [DocumentIndexed](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/documentindexed/) event occurs when a document has been indexed.

## DocumentDeleted event

The [DocumentDeleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/documentdeleted/) event occurs when a document has been deleted.

## ErrorOccurred event

The [ErrorOccurred](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/erroroccurred/) event occurs when an error occurs in one of the nodes of the search network.

## IndexingProgressChanged event

The [IndexingProgressChanged](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/indexingprogresschanged/) event occurs when the progress of the indexing operation has changed.

## OptimizationProgressChanged event

The [OptimizationProgressChanged](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/optimizationprogresschanged/) event occurs when the progress of the optimization operation has changed.

## Code example

**C#**

```csharp
node.Events.IndexingCompleted += (s, e) =>
{
    Console.WriteLine("Indexing complete");
};
node.Events.DeletionCompleted += (s, e) =>
{
    Console.WriteLine("Deleting complete");
};
node.Events.OptimizationCompleted += (s, e) =>
{
    Console.WriteLine("Optimization complete");
};
node.Events.SynchronizationCompleted += (s, e) =>
{
    Console.WriteLine("Synchronization complete");
};
node.Events.AttributeChangesCompleted += (s, e) =>
{
    Console.WriteLine("Attribute changes complete");
};
node.Events.StatusChanged += (s, e) =>
{
    Console.WriteLine("Status changed: " + e.OldStatus + " -> " + e.NewStatus);
};
node.Events.DataExtracted += (s, e) =>
{
    Console.WriteLine("Data extracted (" + e.ExtractorIndex + "): " + e.DocumentKey);
};
node.Events.DocumentIndexed += (s, e) =>
{
    Console.WriteLine("Document indexed (" + e.ShardIndex + "): " + e.DocumentKey);
};
node.Events.DocumentDeleted += (s, e) =>
{
    Console.WriteLine("Document deleted (" + e.ShardIndex + "): " + e.DocumentKey);
};
node.Events.ErrorOccurred += (s, e) =>
{
    Console.WriteLine("Error occurred (" + e.NodeIndex + ", " + e.ServiceIndex + "): " + e.Message);
};
node.Events.IndexingProgressChanged += (s, e) =>
{
    Console.WriteLine("Indexing progress changed (" + e.NodeIndex + ", " + e.ServiceIndex + "): " + e.ProgressPercentage);
};
node.Events.OptimizationProgressChanged += (s, e) =>
{
    Console.WriteLine("Optimization progress changed (" + e.NodeIndex + ", " + e.ServiceIndex + "): " + e.ProgressPercentage);
};
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Convert spreadsheets

Path: /conversion/java/convert/spreadsheet/

Microsoft Excel with its popular XLS and XLSX formats is a recognized authority in the area of working with tabular data, reports, accounting data, and numbers. However, there are often situations when installing Excel software for working with spreadsheets is not possible for various reasons. This is exactly the situation when converting the source workbook into another format can be a solution. 

Even though a direct conversion of tables to other formats can be a very complicated process, the **GroupDocs.Conversion for Java** successfully solves this class of tasks - from the developer's point of view, it is needed to load the source workbook and save the converted document in some other format. That’s it!

## Supported spreadsheet file conversions

{{< include file="/conversion/java/_includes/supported-conversions/spreadsheet.md" type="page" >}}

## Convert Excel workbook to PDF

Nowadays, PDF format has become one of the common ways to share documents between people and organizations of any kind. In software development, it is also quite a popular use case to convert Excel workbooks into PDF format. GroupDocs.Conversion keeps great display accuracy when converting XLSX/XLS workbooks to PDF, and no additional software is required.  

Use the [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/Converter) class to save an Excel workbook to PDF using its [convert](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/Converter#convert(java.lang.String,%20com.groupdocs.conversion.options.convert.ConvertOptions)) method. There is a complete list of steps that should be followed for XLSX to PDF conversion:  

1. Instantiate an object of the `Converter` class by passing the source XLSX file name into it.
2. Call the `convert` method and specify the output file name along with the [PdfConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/PdfConvertOptions) object as we are converting the workbook into PDF format. The converted PDF file will be saved under the selected file name.  

```Java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source XLSX file
Converter converter = new Converter("sample.xlsx");
PdfConvertOptions options = new PdfConvertOptions();
// Save converted PDF file
converter.convert("converted.pdf", options);
```

## Convert Excel workbook to HTML/MHTML

The GroupDocs.Conversion library allows exporting Excel spreadsheets to HTML and MHTML formats which are popular web formats, also used for emails and other areas.
The main difference between HTML and MHTML is that the latter combines all document content like CSS styles, images, audio etc. into a single file.  
The code snippet for XLSX to HTML or MHTML conversion using Java programming language is pretty simple:  

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.MarkupConvertOptions;
...
// Load the source XLSX file
Converter converter = new Converter("sample.xlsx");
MarkupConvertOptions options = new MarkupConvertOptions();
// Save converted HTML file
converter.convert("converted.html", options);
```

When converting to MHTML you may use the same code example as above, just call the `setFormat` method of the [MarkupConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/MarkupConvertOptions) like this:  

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.MarkupConvertOptions;
import com.groupdocs.conversion.filetypes.MarkupFileType;
...
// Load the source XLSX file
Converter converter = new Converter("sample.xlsx");
MarkupConvertOptions options = new MarkupConvertOptions();
options.setFormat(MarkupFileType.Mhtml);
// Save converted MHTML file
converter.convert("converted.mhtml", options);
```

## Convert Excel workbook to DOCX

The GroupDocs.Conversion library empowers you with the ability to convert Microsoft Excel files into a wide range of Microsoft Word formats (please refer to the full list of [supported conversions](#supported-spreadsheet-file-conversions)). The most commonly used Microsoft Word formats are DOCX and DOC, and when converting an XLSX spreadsheet you should specify the desired target format by calling the `setFormat` method of the [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/WordProcessingConvertOptions) object.  

Here is a complete code example for XLSX to DOCX conversion using Java language below:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
...
// Load the source XLSX file
Converter converter = new Converter("sample.xlsx");
WordProcessingConvertOptions options = new WordProcessingConvertOptions();
// Save converted DOCX file
converter.convert("converted.docx", options);
```

## Convert Excel workbook to PPTX

When it is needed to present Microsoft Excel data and charts to a wide audience it may be more convenient to transform XLS(X) workbook into Microsoft PowerPoint format. The GroupDocs.Conversion library supports such Excel to PowerPoint transformations when workbook spreadsheets are converted to presentation slides.  

Similarly to other conversions, you may choose the desired presentation file format by calling the `setFormat` method of the [PresentationConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/PresentationConvertOptions) class. PPTX is the default format for presentations so when converting to PPTX, the `setFormat` call may be omitted.  

Please examine the code snippet that demonstrates how to convert XLSX to PPTX using Java language:  

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PresentationConvertOptions;
...
// Load the source XLS file
Converter converter = new Converter("sample.xlsx");
PresentationConvertOptions options = new PresentationConvertOptions();
// Save converted PPTX file
converter.convert("converted.pptx", options);
```

---

## Convert spreadsheets

Path: /conversion/net/convert/spreadsheet/


Microsoft Excel with its popular XLS and XLSX formats is a recognized authority in the area of working with tabular data, reports, accounting data, and numbers. However, there are often situations when installing Excel software for working with spreadsheets is not possible for various reasons. This is exactly the situation when converting the source workbook into another format can be a solution. 

Even though direct converting tables to other formats can be a very complicated process, **GroupDocs.Conversion for .NET** successfully solves this class of tasks - from the developer's point of view, it is needed to load the source workbook and save the converted document in some other format. That’s it!

## Supported spreadsheet file conversions

{{< include file="/conversion/net/_includes/supported-conversions/spreadsheet.md" type="page" >}}

## Convert Excel workbook to PDF

Nowadays, PDF format has become one of the common ways to share documents between people and organizations of any kind. In software development, it is also quite a popular use case to convert Excel workbooks into PDF format. GroupDocs.Conversion keeps great display accuracy when converting XLSX/XLS workbooks to PDF, and no additional software is required.  

Use the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) class to save an Excel workbook to PDF using its [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_16) method. There is a complete list of steps that should be followed for XLSX to PDF conversion:  

1. Instantiate an object of the `Converter` class by passing the source XLSX file name into it.
2. Call the `Convert` method and specify the output file name along with the [PdfConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/pdfconvertoptions) object as we are converting the workbook into PDF format. The converted PDF file will be saved under the selected file name.  

```csharp
// Load the source XLSX file
using (var converter = new GroupDocs.Conversion.Converter("sample.xlsx"))
{
    var options = new PdfConvertOptions();
    // Save converted PDF file
    converter.Convert("converted.pdf", options);
}
```

## Convert Excel workbook to HTML/MHTML

The GroupDocs.Conversion library allows exporting Excel spreadsheets to HTML and MHTML formats which are popular web formats, also used for emails and other areas.
The main difference between HTML and MHTML is that the latter combines all document content like CSS styles, images, audio etc. into a single file.  
The code snippet for XLSX to HTML or MHTML conversion using C# programming language is pretty simple:  

```csharp
// Load the source XLSX file
using (var converter = new GroupDocs.Conversion.Converter("sample.xlsx"))
{
    var options = new WebConvertOptions();
    // Save converted HTML file
    converter.Convert("converted.html", options);
}
```

When converting to MHTML you may use the same code example as above, just specify Format for [WebConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/webconvertoptions) like this:  

```csharp
var options = new WebConvertOptions
{  
    Format = GroupDocs.Conversion.FileTypes.MarkupFileType.Mhtml
};
```

## Convert Excel workbook to DOCX

The GroupDocs.Conversion library empowers you with the ability to convert Microsoft Excel files into a wide range of Microsoft Word formats (please refer to the full list of [supported conversions](#supported-spreadsheet-file-conversions)). The most commonly used Microsoft Word formats are DOCX and DOC, and when converting an XLSX spreadsheet you should specify the desired target format by setting the `Format` property of the  [WordProcessingConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/wordprocessingconvertoptions) object.  

Here is a complete code example for XLSX to DOCX conversion using C# language:

```csharp
// Load the source XLSX file
using (var converter = new GroupDocs.Conversion.Converter("sample.xlsx"))
{
    var options = new WordProcessingConvertOptions();
    // Save converted DOCX file
    converter.Convert("converted.docx", options);
}
```

## Convert Excel workbook to PPTX

When it is needed to present Microsoft Excel data and charts to a wide audience it may be more convenient to transform XLS(X) workbook into Microsoft PowerPoint format. The GroupDocs.Conversion library supports such Excel to PowerPoint transformations when workbook spreadsheets are converted to presentation slides.  

Similarly to other conversions, you may choose the desired presentation file format by specifying the `Format` property of the [PresentationConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/presentationconvertoptions) class. PPTX is the default format for presentations so when converting to PPTX, the `Format` property may be omitted.  

Please examine the code snippet that demonstrates how to convert XLSX to PPTX using C# language:  

```csharp
// Load the source XLS file
using (var converter = new GroupDocs.Conversion.Converter("sample.xlsx"))
{
    var options = new PresentationConvertOptions();
    // Save converted PPTX file
    converter.Convert("converted.pptx", options);
}
```

---

## Convert spreadsheets

Path: /conversion/nodejs-java/convert/spreadsheet/

Microsoft Excel with its popular XLS and XLSX formats is a recognized authority in the area of working with tabular data, reports, accounting data, and numbers. However, there are often situations when installing Excel software for working with spreadsheets is not possible for various reasons. This is exactly the situation when converting the source workbook into another format can be a solution. 

Even though direct converting tables to other formats can be a very complicated process, **GroupDocs.Conversion for Node.js via Java** successfully solves this class of tasks - from the developer's point of view, it is needed to load the source workbook and save the converted document in some other format. That’s it!

## Supported spreadsheet file conversions

{{< include file="/conversion/nodejs-java/_includes/supported-conversions/spreadsheet.md" type="page" >}}

## Convert Excel workbook to PDF

Nowadays, PDF format has become one of the common ways to share documents between people and organizations of any kind. In software development, it is also quite a popular use case to convert Excel workbooks into PDF format. GroupDocs.Conversion keeps great display accuracy when converting XLSX/XLS workbooks to PDF, and no additional software is required.  

Use the [Converter](#) class to save an Excel workbook to PDF using its [convert](#) method. There is a complete list of steps that should be followed for XLSX to PDF conversion:  

1. Instantiate an object of the `Converter` class by passing the source XLSX file name into it.
2. Call the `convert` method and specify the output file name along with the [PdfConvertOptions](#) object as we are converting the workbook into PDF format. The converted PDF file will be saved under the selected file name.  

```js
// Load the source XLSX file
const converter = new groupdocs.conversion.Converter("sample.xlsx");
const options = new groupdocs.conversion.PdfConvertOptions();
// Save converted PDF file
converter.convert("converted.pdf", options);
```

## Convert Excel workbook to HTML/MHTML

The GroupDocs.Conversion library allows exporting Excel spreadsheets to HTML and MHTML formats which are popular web formats, also used for emails and other areas.
The main difference between HTML and MHTML is that the latter combines all document content like CSS styles, images, audio etc. into a single file.  
The code snippet for XLSX to HTML or MHTML conversion using JavaScript programming language is pretty simple:  

```js
// Load the source XLSX file
const converter = new groupdocs.conversion.Converter("sample.xlsx");
const options = new groupdocs.conversion.MarkupConvertOptions();
// Save converted HTML file
converter.convert("converted.html", options);
```

When converting to MHTML you may use the same code example as above, just call the `setFormat` method of the [MarkupConvertOptions](#) like this:  

```js
const options = new groupdocs.conversion.MarkupConvertOptions();
options.setFormat(groupdocs.conversion.MarkupFileType.Mhtml);
```

## Convert Excel workbook to DOCX

The GroupDocs.Conversion library empowers you with the ability to convert Microsoft Excel files into a wide range of Microsoft Word formats (please refer to the full list of [supported conversions](#supported-spreadsheet-file-conversions)). The most commonly used Microsoft Word formats are DOCX and DOC, and when converting an XLSX spreadsheet you should specify the desired target format by calling the `setFormat` method of the [WordProcessingConvertOptions](#) object.  

Here is a complete code example for XLSX to DOCX conversion using JavaScript language below:

```js
// Load the source XLSX file
const converter = new groupdocs.conversion.Converter("sample.xlsx");
const options = new groupdocs.conversion.WordProcessingConvertOptions();
// Save converted DOCX file
converter.convert("converted.docx", options);
```

## Convert Excel workbook to PPTX

When it is needed to present Microsoft Excel data and charts to a wide audience it may be more convenient to transform XLS(X) workbook into Microsoft PowerPoint format. The GroupDocs.Conversion library supports such Excel to PowerPoint transformations when workbook spreadsheets are converted to presentation slides.  

Similarly to other conversions, you may choose the desired presentation file format by calling the `setFormat` method of the [PresentationConvertOptions](#) class. PPTX is the default format for presentations so when converting to PPTX, the `setFormat` call may be omitted.  

Please examine the code snippet that demonstrates how to convert XLSX to PPTX using JavaScript language:  

```js
// Load the source XLS file
const converter = new groupdocs.conversion.Converter("sample.xlsx");
cosnt options = new groupdocs.conversion.PresentationConvertOptions();
// Save converted PPTX file
converter.convert("converted.pptx", options);
```

---

## Updating Fields while Assembling Word Processing Documents

Path: /assembly/net/updating-fields-while-assembling-word-processing-documents/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.3.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

### The Recipe

*   Set up the source document template path
*   Set up destination report path
*   Instantiate DocumentAssembler class
*   Set options, **[DocumentAssemblyOptions.UpdateFieldsAndFormulas](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassemblyoptions)**
*   Generate report

### Download Template

Get the template from here.

*   [Update\_Field\_XML.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Update_Field_XML.docx?raw=true)

### The Code

{{< gist GroupDocsGists d9af36df97a2bf7f50d0fb63c9ec34c6 >}}



---

## Work with Word Track Changes

Path: /comparison/python-net/word-track-changes/


By default, GroupDocs.Comparison can include or ignore Word Track Changes (revisions) during comparison. Use `CompareOptions` to control this behavior.

## Example: Include Word revisions during comparison

Enable the comparison engine to detect and include tracked revisions (changes, comments, insertions, deletions) from Word documents when generating the comparison result. This ensures that any previously tracked changes are not lost during the comparison process.

```python
import groupdocs.comparison as gc

with gc.Comparer("source-with-revisions.docx") as comparer:
    comparer.add("target.docx")

    options = gc.CompareOptions()
    options.word_track_changes = True  # include tracked revisions

    comparer.compare("result.docx", options)
```

🔹Enable the comparison engine to detect and include tracked revisions (changes, comments, insertions, deletions) from Word documents when generating the comparison result. This ensures that any previously tracked changes are not lost during the comparison process.

## Example: Ignore Word revisions during comparison

Compare only the final text and ignore previously tracked revisions so historical edits do not affect the diff.

```python
import groupdocs.comparison as gc

with gc.Comparer("source-with-revisions.docx") as comparer:
    comparer.add("target.docx")

    options = gc.CompareOptions()
    options.word_track_changes = False  # ignore tracked revisions

    comparer.compare("result.docx", options)
```

🔹 Use case: Produce a clean diff focused on current content for executive review.

Note: Availability of particular options may depend on the document format and library version.

The result is as follows:

|                     WordTrackChanges true                      |
| :------------------------------------------------------------: |
| ![](/comparison/python-net/images/word-track-changes-option-true.png) |




|                     WordTrackChanges false                      |
| :-------------------------------------------------------------: |
| ![](/comparison/python-net/images/word-track-changes-option-false.png) |



---

## Calculate Formula while Assembling Spreadsheet Documents

Path: /assembly/net/calculate-formula-while-assembling-spreadsheet-documents/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.3.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

### The Recipe

*   Set up the source document template path
*   Set up destination report path
*   Instantiate DocumentAssembler class
*   Set options, [DocumentAssemblyOptions.UpdateFieldsAndFormulas](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassemblyoptions)
*   Generate report

### Download Template

Get the template from here.

*   [Update-Fomula.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Spreadsheet%20Templates/Update-Fomula.xlsx?raw=true)

### The Code

{{< gist GroupDocsGists 8b52aa31a79fa631c3b75efb29d11507 >}}



---

## Handle Common Template and Data Errors

Path: /assembly/net/basic-usage-error-handling/


## Overview

Error handling is crucial when generating documents from templates and data sources. GroupDocs.Assembly for .NET provides exceptions that help you identify and resolve issues with templates, data sources, or assembly operations. Understanding common error scenarios and how to handle them improves the reliability of your document generation code.

The main exception types are:
- `DocumentAssemblerException` - general assembly errors
- Template syntax errors
- Data source errors
- Missing member errors

Here are the steps to handle errors:

* Wrap assembly operations in try-catch blocks
* Catch specific exception types
* Validate data sources before assembly
* Handle missing members gracefully
* Log errors for debugging

{{< alert style="info" >}}
GroupDocs.Assembly provides detailed error messages that help identify the exact location and cause of template or data errors.
{{< /alert >}}

## Basic Error Handling

Wrap assembly operations in try-catch blocks:

```csharp
using GroupDocs.Assembly;
using System;

public static void BasicErrorHandling()
{
    try
    {
        var data = new { Name = "John Doe", Age = 30 };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument("Template.docx", "Output.docx", 
            new DataSourceInfo(data, "data"));
        
        Console.WriteLine("Document assembled successfully.");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error assembling document: {ex.Message}");
        // Handle error appropriately
    }
}
```

## Handle Template Syntax Errors

Catch and handle template syntax errors:

```csharp
using GroupDocs.Assembly;
using System;

public static void HandleTemplateErrors()
{
    try
    {
        var data = new { Name = "John Doe" };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument("Template.docx", "Output.docx", 
            new DataSourceInfo(data, "data"));
    }
    catch (DocumentAssemblerException ex)
    {
        Console.WriteLine($"Template error: {ex.Message}");
        Console.WriteLine($"Error details: {ex.InnerException?.Message}");
        // Log error, notify user, or use fallback template
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Unexpected error: {ex.Message}");
    }
}
```

## Handle Missing Data Members

Handle cases where template references missing data members:

```csharp
using GroupDocs.Assembly;
using System;

public static void HandleMissingMembers()
{
    try
    {
        // Data doesn't have all properties referenced in template
        var data = new { Name = "John Doe" };
        // Template might reference data.Email which doesn't exist
        
        DocumentAssembler assembler = new DocumentAssembler();
        
        // Option 1: Allow missing members (returns null/empty)
        assembler.Options |= DocumentAssemblyOptions.AllowMissingMembers;
        
        assembler.AssembleDocument("Template.docx", "Output.docx", 
            new DataSourceInfo(data, "data"));
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}
```

## Validate Data Before Assembly

Validate data sources before assembly:

```csharp
using GroupDocs.Assembly;
using System;
using System.Collections.Generic;

public static void ValidateDataBeforeAssembly()
{
    var products = new List<Product>();
    // products might be empty or null
    
    if (products == null || products.Count == 0)
    {
        Console.WriteLine("Warning: No products to process.");
        return;
    }
    
    try
    {
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument("Template.docx", "Output.docx", 
            new DataSourceInfo(products, "products"));
        
        Console.WriteLine("Document assembled successfully.");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}
```

## Handle File Not Found Errors

Check if template file exists:

```csharp
using GroupDocs.Assembly;
using System;
using System.IO;

public static void HandleFileNotFound()
{
    string templatePath = "Template.docx";
    
    if (!File.Exists(templatePath))
    {
        Console.WriteLine($"Template file not found: {templatePath}");
        return;
    }
    
    try
    {
        var data = new { Name = "John Doe" };
        
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument(templatePath, "Output.docx", 
            new DataSourceInfo(data, "data"));
        
        Console.WriteLine("Document assembled successfully.");
    }
    catch (FileNotFoundException ex)
    {
        Console.WriteLine($"File not found: {ex.FileName}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}
```

## Handle Data Type Errors

Validate data types before assembly:

```csharp
using GroupDocs.Assembly;
using System;

public class Invoice
{
    public string CustomerName { get; set; }
    public decimal? Amount { get; set; } // Nullable
}

public static void HandleDataTypeErrors()
{
    var invoice = new Invoice
    {
        CustomerName = "John Doe",
        Amount = null // Might cause issues if template expects non-null
    };
    
    try
    {
        DocumentAssembler assembler = new DocumentAssembler();
        assembler.AssembleDocument("Template.docx", "Output.docx", 
            new DataSourceInfo(invoice, "invoice"));
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Data type error: {ex.Message}");
        // Handle null values or provide defaults
    }
}
```

## Comprehensive Error Handling

Combine multiple error handling strategies:

```csharp
using GroupDocs.Assembly;
using System;
using System.IO;

public static void ComprehensiveErrorHandling()
{
    string templatePath = "Template.docx";
    string outputPath = "Output.docx";
    
    // Validate inputs
    if (string.IsNullOrEmpty(templatePath) || !File.Exists(templatePath))
    {
        Console.WriteLine("Invalid template path.");
        return;
    }
    
    try
    {
        var data = new { Name = "John Doe", Age = 30 };
        
        // Validate data
        if (data == null)
        {
            Console.WriteLine("Data source is null.");
            return;
        }
        
        DocumentAssembler assembler = new DocumentAssembler();
        
        // Configure error handling options
        assembler.Options |= DocumentAssemblyOptions.AllowMissingMembers;
        
        assembler.AssembleDocument(templatePath, outputPath, 
            new DataSourceInfo(data, "data"));
        
        Console.WriteLine("Document assembled successfully.");
    }
    catch (DocumentAssemblerException ex)
    {
        Console.WriteLine($"Assembly error: {ex.Message}");
        if (ex.InnerException != null)
        {
            Console.WriteLine($"Inner exception: {ex.InnerException.Message}");
        }
        // Log detailed error information
    }
    catch (FileNotFoundException ex)
    {
        Console.WriteLine($"File not found: {ex.FileName}");
    }
    catch (UnauthorizedAccessException ex)
    {
        Console.WriteLine($"Access denied: {ex.Message}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Unexpected error: {ex.Message}");
        Console.WriteLine($"Stack trace: {ex.StackTrace}");
    }
}
```

## Handle Stream Errors

Properly handle stream-related errors:

```csharp
using GroupDocs.Assembly;
using System;
using System.IO;

public static void HandleStreamErrors()
{
    try
    {
        using (FileStream templateStream = new FileStream("Template.docx", FileMode.Open))
        using (FileStream outputStream = new FileStream("Output.docx", FileMode.Create))
        {
            var data = new { Name = "John Doe" };
            
            DocumentAssembler assembler = new DocumentAssembler();
            assembler.AssembleDocument(templateStream, outputStream, 
                new DataSourceInfo(data, "data"));
        }
    }
    catch (IOException ex)
    {
        Console.WriteLine($"IO error: {ex.Message}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}
```

## Error Handling Best Practices

1. **Always use try-catch blocks** around assembly operations
2. **Validate inputs** before assembly (file existence, data null checks)
3. **Use specific exception types** when possible
4. **Enable AllowMissingMembers** option if your data structure is dynamic
5. **Log errors** with sufficient detail for debugging
6. **Provide user-friendly error messages** in production code

{{< alert style="warning" >}}
Some errors might occur during template evaluation. Always test templates with sample data before deploying to production. Consider using template validation tools or test assemblies.
{{< /alert >}}

### Advanced Usage Topics

To learn more about detailed error logging, template validation, custom error handling, and debugging techniques, please refer to the [advanced usage section]({{< ref "assembly/net/developer-guide/advanced-usage/_index.md" >}}).

## More resources

### GitHub Examples

You may easily run the code above and see the feature in action in our GitHub examples:

* [GroupDocs.Assembly for .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
* [GroupDocs.Assembly for Java examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)
* [GroupDocs.Assembly for Python via .NET examples, plugins, and showcase](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)

### Free Online Apps

Along with the full-featured .NET library, we provide simple but powerful free online apps.

To assemble documents from templates and data sources, you can use the online apps from the **[GroupDocs.Assembly App Product Family](https://products.groupdocs.app/assembly/family)**.


---

## Loading Multiple DocumentTable Objects from a Single File as a Single Operation

Path: /assembly/java/loading-multiple-documenttable-objects-from-a-single-file-as-a-single-operation/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Loading Multiple DocumentTable Objects

API provides the ability to load multiple DocumentTable objects from a single file as a single operation. Following classes and interfaces of the **GroupDocs.Assembly.Data** namespace have been added:

*   DocumentTableSet
*   DocumentTableCollection
*   IDocumentTableLoadHandler
*   DocumentTableLoadArgs.

Moreover, following properties of the **GroupDocs.Assembly.Data.DocumentTable** class have been added:

*   Name
*   IndexInDocument

### Download

#### Data Source Document

*   [Multiple Tables Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Word%20DataSource/Multiple%20Tables%20Data.docx?raw=true)

#### Template

*   [Using Document Table Set as Data Source.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Using%20Document%20Table%20Set%20as%20Data%20Source.pptx?raw=true)

## Loading DocumentTableSet using Default Options

{{< gist GroupDocsGists a9f1b1ea045eff6e7004b46256c9e26c >}}

## Loading DocumentTableSet using Custom Options

{{< gist GroupDocsGists 3b0816c688566c74b9ca36b5de92b129 >}}

## Using DocumentTableSet as Data Source

{{< gist GroupDocsGists 707671eb240c923a431ba23be6869c84 >}}

## CustomDocumentTableLoadHandler

{{< gist GroupDocsGists 5d1dc2b3d63082d2e07439a8ce58ba59 >}}

## ColumnNameExtractingDocumentTableLoadHandler

{{< gist GroupDocsGists edfa4d2ffc4b2aff4da49dc86dc08e63 >}}



---

## Adding NEXT Field into Template Syntax

Path: /assembly/net/adding-next-field-into-template-syntax/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for .NET 3.3.0 or later releases.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**Template Syntax**

```csharp
We provide support for the following products:
. <<foreach [in products]>><<next>><<[ProductName]>>
<</foreach>>
```

## The Recipe

*   Set up the source document template path
*   Set up destination report path
*   Instantiate [DocumentAssembler](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler) class
*   Generate report

### Download Template

Get the template from here.

*   [Using Next.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Using%20Next.docx?raw=true)

### The Code

{{< gist GroupDocsGists 5b2f5abf4f1a745b99baba52177f4db3 >}}

---

## Adding NEXT Field into Template Syntax

Path: /assembly/python-net/adding-next-field-into-template-syntax/

{{< alert style="info" >}}This feature is only compatible with GroupDocs.Assembly for Python via .NET 3.3.0 or later releases.{{< /alert >}}

## Adding Syntax to be evaluated by GroupDocs.Assembly Engine

**Template Syntax**

```python
We provide support for the following products:
. <<foreach [in products]>><<next>><<[ProductName]>>
<</foreach>>
```

## The Recipe

*   Set up the source document template path
*   Set up destination report path
*   Instantiate [DocumentAssembler](https://reference.groupdocs.com/python-net/assembly/groupdocs.assembly/documentassembler) class
*   Generate report

## More resources

### Advanced usage topics

To learn more about library features, please refer to the[advanced usage section]({{< ref "assembly/python-net/developer-guide/advanced-usage/_index.md" >}}).

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Assembly for .NET examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET)
    
*   [GroupDocs.Assembly for Java examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java)

*   [GroupDocs.Assembly for Python via .NET examples](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Python-via-.NET)
    

---

## Defining Relations Between DocumentTable Instances Loaded from a Single Document

Path: /assembly/java/defining-relations-between-documenttable-instances-loaded-from-a-single-document/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Defining Relations Between Document Table Instances

API provides the ability to define relations between DocumentTable instances loaded from a single document. The following classes of the **GroupDocs.Assembly.Data** namespace have been added:

*   DocumentTableRelation
*   DocumentTableRelationCollection

Moreover, The **Relations** property of the **GroupDocs.Assembly.Data.DocumentTableSet** class has been added.

### Download

#### Data Source Document

*   [Related Tables Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Excel%20DataSource/Related%20Tables%20Data.xlsx?raw=true)

#### Template

*   [Using Document Table Relations.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Using%20Document%20Table%20Relations.docx?raw=true)

## Using Document Table Relations

{{< gist GroupDocsGists 4ae828a9377501da26d5db1c51b5cc83 >}}

## ColumnNameExtractingDocumentTableLoadHandler

{{< gist GroupDocsGists 110dd713ad2133a916048bfca273f644 >}}



---

## Changing Automatically Detected Types of DocumentTable Columns

Path: /assembly/java/changing-automatically-detected-types-of-documenttable-columns/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Changing Automatically Detected Types

API provides the ability to change automatically detected types of DocumentTable columns. The **Type** property setter has been added to the **GroupDocs.Assembly.Data.DocumentTableColumn** class.

Moreover, The **Relations** property of the **GroupDocs.Assembly.Data.DocumentTableSet** class has been added.

### Download

#### Data Source Document

*   [Managers Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Data%20Sources/Word%20DataSource/Managers%20Data.docx?raw=true)

#### Template

*   [Changing Document Table Column Type.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Changing%20Document%20Table%20Column%20Type.pptx?raw=true)

## Changing Document Table Column Type

{{< gist GroupDocsGists c131b7bf63e6ce3f763b96ca2848c703 >}}



---

## Loading Multiple DocumentTable Objects from a Single File as a Single Operation

Path: /assembly/net/loading-multiple-documenttable-objects-from-a-single-file-as-a-single-operation/

{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Loading Multiple DocumentTable Objects

GroupDocs.Assembly for .NET API provides the ability to load multiple DocumentTable objects from a single file as a single operation. Following classes and interfaces of the [GroupDocs.Assembly.Data](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/) namespace have been added:

*   [DocumentTableSet](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttableset)
*   [DocumentTableCollection](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecollection)
*   [IDocumentTableLoadHandler](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/idocumenttableloadhandler)
*   [DocumentTableLoadArgs.](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttableloadargs)

Moreover, following properties of the [GroupDocs.Assembly.Data.DocumentTable](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttable) class have been added:

*   Name
*   IndexInDocument

### Data Source Document

*   [Multiple Tables Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Word%20DataSource/Multiple%20Tables%20Data.docx?raw=true)

### Template

*   [Using Document Table Set as Data Source.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Using%20Document%20Table%20Set%20as%20Data%20Source.pptx?raw=true)

## Loading DocumentTableSet using Default Options

{{< gist GroupDocsGists a6f71eb9b5b06dc1c9038fd25965ade9 >}}

## Loading DocumentTableSet using Custom Options

{{< gist GroupDocsGists b9765c9a2d1ab7a67c4215eec42306fd >}}

## Using DocumentTableSet as Data Source

{{< gist GroupDocsGists 5a753fa52864e3126a697ac0f0d96b15 >}}

## CustomDocumentTableLoadHandler

{{< gist GroupDocsGists 6c1d6116bd499686ad3cec225423b3ce >}}

## ColumnNameExtractingDocumentTableLoadHandler

{{< gist GroupDocsGists a855621e468c2c627534255dbcb7657c >}}

---

## Changing Background Color Dynamically

Path: /assembly/java/changing-background-color-dynamically/

{{< alert style="info" >}}This feature is supported by version 17.12 or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Changing Background Color

You can set text background color for document contents dynamically using backColor tags.

{{< gist GroupDocsGists 4258abbc1ca5ff7b45f1288d20bd4c15 >}}

### Download

*   [Change Background Color Dynamically.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/In-Table%20List_BackgroundColor.docx)

---

## Defining Relations Between DocumentTable Instances Loaded from a Single Document

Path: /assembly/net/defining-relations-between-documenttable-instances-loaded-from-a-single-document/

## Define Relations Between Document Table Instances

API provides ability to define relations between [DocumentTable](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttable) instances loaded from a single document. The following classes of the [GroupDocs.Assembly.Data](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/) namespace have been added:

*   [DocumentTableRelation](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablerelation)
*   [DocumentTableRelationCollection](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablerelationcollection)

Moreover, the **Relations** property of the [GroupDocs.Assembly.Data.DocumentTableSet](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttableset) class has been added.

### Data Source Document

*   [Related Tables Data.xlsx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Excel%20DataSource/Related%20Tables%20Data.xlsx?raw=true)

### Template

*   [Using Document Table Relations.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Using%20Document%20Table%20Relations.docx?raw=true)

## Using Document Table Relations

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist GroupDocsGists ce6189b20fa197fee3b15833b26127fc >}}

## ColumnNameExtractingDocumentTableLoadHandler

{{< gist GroupDocsGists a855621e468c2c627534255dbcb7657c >}}



---

## Changing Automatically Detected Types of DocumentTable Columns

Path: /assembly/net/changing-automatically-detected-types-of-documenttable-columns/

API provides the ability to change automatically detected types of DocumentTable columns. The **Type** property setter has been added to the [GroupDocs.Assembly.Data.DocumentTableColumn](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttablecolumn) class.

Moreover, The **Relations** property of the [GroupDocs.Assembly.Data.DocumentTableSet](https://reference.groupdocs.com/net/assembly/groupdocs.assembly.data/documenttableset) class has been added.

## Data Source Document

*   [Managers Data.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Data%20Sources/Word%20DataSource/Managers%20Data.docx?raw=true)

## Template

*   [Changing Document Table Column Type.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Changing%20Document%20Table%20Column%20Type.pptx?raw=true)

## Changing Document Table Column Type

{{< alert style="info" >}}The code uses some of the objects defined in: The Business Layer{{< /alert >}}{{< gist GroupDocsGists 99b0961e79cc8080f9e461ede36f2d8e >}}

---

## Working with String Template

Path: /assembly/java/working-with-string-template/

GroupDocs.Assembly API allows you to use a string as input and output template, instead of document. This feature improves programmability while working with strings instead of documents, the resultant output string can be used as per the application needs. Follow these steps to using a string as input and output template:

*   Initialize **DocumentAssembler**
*   Define **sourceString "<<\[yourValue\]>>"**
*   Convert sourceString to **sourceBytes** using **ByteArrayInputStream(sourceBytes)**
*   Get **targetBytes** using **DocumentAssembler.assembleDocument()**
*   Get** targetString **using **new String(targetBytes, StandardCharsets.UTF\_8)**

{{< gist GroupDocsGists 6af297f6037c73ea88d0947c4dcec6b7 >}}

---

## Changing Background Color Dynamically

Path: /assembly/net/changing-background-color-dynamically/

{{< alert style="info" >}}This feature is supported by version 17.12 or greater{{< /alert >}}

You can set text background color for document contents dynamically using backColor tags.

### The Code

{{< alert style="info" >}}The code uses some of the objects defined in: [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/){{< /alert >}}{{< gist GroupDocsGists ee5d086fa3fa545f0b9f78647054674b >}}

### Download

*   [Change Background Color Dynamically.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/In-Table%20List%20with%20Running%20(Progressive)%20Total_BackgroundColor.docx)

---

## Changing Target File Format

Path: /assembly/java/changing-target-file-format/

{{< alert style="info" >}}This feature is supported by version 18.9. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

# Changing Target File Format

GroupDocs.Assembly provides a powerful feature to change the target file format of an assembled document using file extension or explicit specifying. GroupDocs.Assembly API provides the ability to change target file format when assembling the following file formats:

*   Word Processing documents
*   Spreadsheet documents 
*   Presentation documents 
*   Email documents 
*   Text documents 

Supported output file formats depending on input file formats can be found at [this page]({{< ref "assembly/java/getting-started/introducing-groupdocs.assembly-for-java.md#supported-output-file-formats-dependingon-input-file-formats" >}}).

### Changing Target File Format using File Extension

{{< gist GroupDocsGists 3d8ce601fa438c84ff9a760aee18a7b5 >}}

### Changing Target File Format using Explicit Specifying

{{< gist GroupDocsGists 7fc012830ee5afd819c9f05535d81e50 >}}



---

## Removing Empty Paragraphs

Path: /assembly/java/removing-empty-paragraphs/

{{< alert style="info" >}}This feature is supported by version 18.10. or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

GroupDocs.Assembly for Java API supports the removal of paragraphs becoming empty after template syntax tags are removed or replaced with empty values. A new member **REMOVE\_EMPTY\_PARAGRAPHS **is added to **DocumentAssemblyOptions**. When this new option is applied to **DocumentAssembler** options through **DocumentAssembler.setOptions()**, the engine additionally removes empty paragraphs.

## Removing Empty Paragraphs in Word Processing Document 

### The Code

{{< gist GroupDocsGists 5c3a2b1ce4879f7c1d139023f5ca370c >}}

### Download

*   [Empty Paragraph.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Word%20Templates/Empty%20Paragraph.docx)

## Removing Empty Paragraphs in Presentation Document 

### The Code

{{< gist GroupDocsGists 8a60018c3b127c1652d70fb6ff623be5 >}}

### Download

*   [Empty Paragraph.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Presentation%20Templates/Empty%20Paragraph.pptx)

## Removing Empty Paragraphs in Email Document 

### The Code

{{< gist GroupDocsGists a1361185b1472dcea8c0cb015ab89e0c >}}

### Download

*   [Empty Paragraph.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-Java/blob/master/Examples/GroupDocs.Assembly.Examples.Java/Data/Storage/Email%20Templates/Empty%20Paragraph.msg)

---

## Working with String Template

Path: /assembly/net/working-with-string-template/

GroupDocs.Assembly API allows you to use a string as input and output template, instead of document. This feature improves programmability while working with strings instead of documents, the resultant output string can be used as per the application needs. Follow these steps to using a string as input and output template:

*   Initialize [DocumentAssembler](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler)
*   Define **sourceString @"<<\[yourValue\]>>"**
*   Convert sourceString to **sourceBytes** using **Encoding.UTF8.GetBytes(sourceString)**
*   Get**targetBytes** using [DocumentAssembler.AssembleDocument()](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler/methods/assembledocument/index)
*   Get **targetString** using **Encoding.UTF8.GetString(targetBytes)**

---

## Changing Target File Format

Path: /assembly/net/changing-target-file-format/

{{< alert style="info" >}}This feature is supported by version 18.9. or greater{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

GroupDocs.Assembly provides a powerful feature to change the target file format of an assembled document using file extension or explicit specification. [GroupDocs.Assembly](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/) API provides the ability to change target file format when assembling the following file formats:

*   Word Processing documents
*   Spreadsheet documents 
*   Presentation documents 
*   Email documents 
*   Text documents 

Supported output file formats depending on input file formats can be found at [this page]({{< ref "assembly/net/getting-started/introducing-groupdocs.assembly-for-.net.md#supported-output-file-formats-depending-on-input-file-formats" >}}).

## Changing Target File Format using File Extension

{{< gist GroupDocsGists e02a1027d7d94b9e7c50d0ec9095e7ae >}}

## Changing Target File Format using Explicit Specification

{{< gist GroupDocsGists 773e2931d3de1b7c6f73a4a65ee0a01a >}}
---

## Use of In-line Syntax Error Messages into Templates

Path: /assembly/java/use-of-in-line-syntax-error-messages-into-templates/

{{< alert style="info" >}}This feature is supported by version 19.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This version provide the ability to display inline template syntax errors in generated, Word Processing, Presentation, Spreadsheets, Emails and Plain Text documents .{{< /alert >}}

## Use of In-line Syntax Error Messages

By default, Document Assembler throws an exception when encounters a template syntax error. Such an exception provides information on a reason of the error and specifies a tag or expression part where the error is encountered. In most cases, this information is enough to find a place in a template causing the error and fix it.

However, when dealing with complex templates containing a large number of tags, it becomes harder to find an exact place in a template causing an error. To make things easier, the engine supports the *DocumentAssemblyOptions.INLINE\_ERROR\_MESSAGES* option that enables in-lining of a syntax error message into a template document at an exact position where the error occurs during run-time.

{{< alert style="warning" >}}A template syntax error message is written using a bold font to make it more apparent.{{< /alert >}}

Consider the following template.

```java
<<var [name]>>
```

By default, such a template causes the engine to throw an exception while building a report. However, when *DocumentAssemblyOptions.INLINE\_ERROR\_MESSAGES* is applied, no exception is thrown and the report looks as follows then.

```java
<<var [name] Error! An assignment operator is expected. >>
```

{{< alert style="warning" >}}Only messages describing errors in template syntax can be in-lined, messages describing errors encountered during expression's evaluation cannot be appeared.{{< /alert >}}

When DocumentAssemblyOptions.INLINE\_ERROR\_MESSAGES is applied, a Boolean value returned by a  DocumentAssembler.assembleDocument overload indicates whether building of a report was finished successfully or was interrupted because of a template syntax error. This enables you to process reports which building succeeded or failed differently as shown in the following code snippet.

{{< gist GroupDocsGists 5de10b3f197d01029e4370d87304ba82 >}}

{{< alert style="warning" >}}In this article the Word Processing document template file has been used. Therefore, the process for the other file formats is same.{{< /alert >}}  

## Download Demo File

Please download the sample demo document files:

*   [Inline error demo.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Inline%20Error%20Demo.docx?raw=true)

---

## Removing Empty Paragraphs

Path: /assembly/net/removing-empty-paragraphs/

{{< alert style="info" >}}This feature is supported by version 18.10. or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

GroupDocs.Assembly for .NET API supports the removal of paragraphs becoming empty after template syntax tags are removed or replaced with empty values. A new member **RemoveEmptyParagraphs** is added to [DocumentAssemblyOptions](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassemblyoptions)**.** When this new option is applied to [DocumentAssembler](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler) options through [DocumentAssembler.Options](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler/properties/options), the engine additionally removes empty paragraphs.

## Removing Empty Paragraphs in Word Processing Document

{{< gist GroupDocsGists 1baca62f7f2fb6b15feacc8686d431fa >}}

### Download

*   [Empty Paragraph.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Empty%20Paragraph.docx)

## Removing Empty Paragraphs in Presentation Document

{{< gist GroupDocsGists 7c9fc9e774e865e047e668ee915fea7e >}}

### Download

*   [Empty Paragraph.pptx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Presentation%20Templates/Empty%20Paragraph.pptx)

## Removing Empty Paragraphs in Email Document

{{< gist GroupDocsGists 5ba8a40ae2ca44cc4bd4576d5a2648e9 >}}

### Download

*   [Empty Paragraph.msg](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Email%20Templates/Empty%20Paragraph.msg)
---

## Using Markdown Documents

Path: /assembly/java/using-markdown-documents/

{{< alert style="info" >}}This feature is supported by version 19.8 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

## Markdown Documents (MD) 

**Markdown** is a [lightweight markup language](https://en.wikipedia.org/wiki/Lightweight_markup_language) intended for one purpose, to be used to format text on the web with plain text formatting syntax. Let it be clear that Markdown is not a replacement for HTML because its syntax is very small, containing a very small subset of HTML tags. The reason behind the Markdown is to make it easy to read, write and edit prose. In other words we can say that HTML is a publishing format while the Markdown is a writing format.

The text files created with Markdown language dialects is saved with **.MD** or **.MARKDOWN** file extension. The MD files are saved in plain text format that uses Markdown language which also includes inline text symbols, defining how a text can be formatted such as indentations, table formatting, fonts, and headers.

## Working with Markdown Documents

Since version 19.8, the GroupDocs.Assembly provides abilities for saving of assembled Markdown documents to Word Processing formats and saving of assembled Word Processing documents and emails to Markdown. 

The API supports the following Markdown features:

*   Headings
*   Block quotes
*   Horizontal rules
*   Bold emphasis
*   Italic emphasis

### Extended the set of supported Markdown features

{{< alert style="info" >}}This feature is supported by version 19.11 or greater.{{< /alert >}}

Since version 19.11, the following Markdown features are supported when saving assembled Markdown documents to Word Processing formats and saving assembled Word Processing documents and emails to Markdown:

*   [Indented code blocks ](https://spec.commonmark.org/0.29/#indented-code-blocks)
*   [Fenced code blocks](https://spec.commonmark.org/0.29/#fenced-code-blocks)
*   [Inline code spans](https://spec.commonmark.org/0.29/#code-spans)
*   [Strikethrough text](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#emphasis)
*   Unordered list (version 20.3 or later)

Following sections show that how we can load from and save to Markdown documents:

### Saving an Assembled Markdown Documents to Word Processing Docs

Suppose, we have an assembled Markdown (MD) document ([ReadMe.md](https://docs.groupdocs.com/download/attachments/85230860/ReadMe.md?version=1&modificationDate=1566999867974&api=v2)) as template having the content as shown below:

```java
# <<[product]>>
-----
## Description
<<[description]>>
## Evaluation and Licensing
The library comes up with some limitations in the evaluation mode. 
In order to test full features of <<[product]>>, 
please request a **free 30-day temporary license**.
```

The following code snippet demonstrates the saving this MD document to a Word Processing file.

{{< gist GroupDocsGists a71a5d818455bbb866dc60349138fcd5 saveMdtoWord_UsingExtension_19.8.java >}}

The resultant word document ([ReadMe Out.docx](https://docs.groupdocs.com/download/attachments/85230860/ReadMe%20Out.docx?version=1&modificationDate=1566999867970&api=v2)) is available for download.

### Saving an Assembled Word Processing Document or Email to Markdown

{{< alert style="info" >}}The version 19.8 supports only assembled emails and Word Processing documents to save into Markdown format.{{< /alert >}}

Suppose, we have a Word Processing template([ReadMe.docx](https://docs.groupdocs.com/download/attachments/85230860/ReadMe.docx?version=1&modificationDate=1567001059552&api=v2)) having the same content as above Markdown template.

 The following code snippet demonstrates the saving this assembled Word Processing document to a Markdown file.

{{< gist GroupDocsGists a71a5d818455bbb866dc60349138fcd5 saveWordOrEmailtoMD_UsingExtension_19.8.java >}}

The resultant word document ([ReadMe Out.md](https://docs.groupdocs.com/download/attachments/85230860/ReadMe%20Out.md?version=1&modificationDate=1567001143475&api=v2)) is available for download.

### Saving an Assembled Word Processing Document or Email to Markdown (Explicit)

The following code snippet shows the saving of an assembled Word Processing document or email to Markdown using explicit specifying:

{{< gist GroupDocsGists a71a5d818455bbb866dc60349138fcd5 saveWordOrEmailtoMD_Explicit_19.8.java >}}



---

## Indexing documents

Path: /search/java/indexing-documents/

Documents can be added to the search network using the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#add-com.groupdocs.search.Document---java.lang.String---com.groupdocs.search.options.IndexingOptions-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class.

The first parameter of the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#add-com.groupdocs.search.Document---java.lang.String---com.groupdocs.search.options.IndexingOptions-) method is an array of documents to be added. Currently, documents created from a stream or from a structure are supported.

The second parameter of the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#add-com.groupdocs.search.Document---java.lang.String---com.groupdocs.search.options.IndexingOptions-) method is an array of optional passwords for opening added documents.

The third parameter of the [add](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#add-com.groupdocs.search.Document---java.lang.String---com.groupdocs.search.options.IndexingOptions-) method is the indexing options object.

The following code example demonstrates adding documents from a stream.

```java
InputStream[] streams = new InputStream[filePaths.length];
Document[] documents = new Document[filePaths.length];
String[] passwords = new String[filePaths.length];
for (int i = 0; i < filePaths.length; i++) {
    String filePath = filePaths[i];
    String extension = FilenameUtils.getExtension(filePath);
    InputStream stream = new FileInputStream(filePath);
    streams[i] = stream;
    Document document = Document.createFromStream(
        filePath,
        new Date(),
        extension,
        stream);
    documents[i] = document;
}

Indexer indexer = node.getIndexer();
IndexingOptions options = new IndexingOptions();
options.setUseRawTextExtraction(false);
options.getImageIndexingOptions().setEnabledForSeparateImages(true);
options.getImageIndexingOptions().setEnabledForEmbeddedImages(true);
options.getImageIndexingOptions().setEnabledForContainerItemImages(true);
options.getOcrIndexingOptions().setEnabledForSeparateImages(true);
options.getOcrIndexingOptions().setEnabledForEmbeddedImages(true);
options.getOcrIndexingOptions().setEnabledForContainerItemImages(true);
indexer.add(documents, passwords, options);

for (InputStream stream : streams) {
    stream.close();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Indexing documents

Path: /search/net/indexing-documents/

Documents can be added to the search network using the [Add](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/add/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class.

The first parameter of the [Add](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/add/) method is an array of documents to be added. Currently, documents created from a stream or from a structure are supported.

The second parameter of the [Add](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/add/) method is an array of optional passwords for opening added documents.

The third parameter of the [Add](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/add/) method is the indexing options object.

The following code example demonstrates adding documents from a stream.

**C#**

```csharp
Stream[] streams = new Stream[filePaths.Length];
Document[] documents = new Document[filePaths.Length];
string[] passwords = new string[filePaths.Length];
for (int i = 0; i < filePaths.Length; i++)
{
    string filePath = filePaths[i];
    DateTime modificationDate = File.GetLastWriteTime(filePath);
    string fileName = Path.GetFileName(filePath);
    string extension = Path.GetExtension(filePath);
    Stream stream = File.OpenRead(filePath);
    streams[i] = stream;
    Document document = Document.CreateFromStream(
        fileName,
        modificationDate,
        extension,
        stream);
    documents[i] = document;
}

Indexer indexer = node.Indexer;

IndexingOptions options = new IndexingOptions();
options.UseRawTextExtraction = false;
options.ImageIndexingOptions.EnabledForSeparateImages = true;
options.ImageIndexingOptions.EnabledForEmbeddedImages = true;
options.ImageIndexingOptions.EnabledForContainerItemImages = true;
options.OcrIndexingOptions.EnabledForSeparateImages = true;
options.OcrIndexingOptions.EnabledForEmbeddedImages = true;
options.OcrIndexingOptions.EnabledForContainerItemImages = true;

indexer.Add(documents, passwords, options);

for (int i = 0; i < streams.Length; i++)
{
    streams[i].Close();
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge Word Documents

Path: /merger/net/merge/word/


A word processing file contains user information in plain text or rich text format. A **plain text** file format contains unformatted text and no font or page settings can be applied. In contrast, a **rich text** file format allows formatting options such as setting fonts type, styles (bold, italic, underline, etc.), page margins, headings, bullets and numbers, and several other formatting features. The use of plain text files have reduced significantly with passage of time as there are more powerful computers and programs available to offer rich text files processing.

Common plain text file extensions and associated file formats include **TXT**, **CSV**, while file extensions for rich text documents include **DOCX**, **DOC** and **RTF**.
  
## How to merge DOCX documents

DOCX is a well-known format for Microsoft Word documents. Introduced from 2007 with the release of Microsoft Office 2007, the structure of this new Document format was changed from plain binary to a combination of XML and binary files. DOCX files can be opened with Word 2007 and lateral versions, but not with the earlier versions of MS Word which support DOC file extensions

Below is code snippet in C# that demonstrates how to merge DOCX files into single file.

```csharp
// Load the source DOCX file
using (Merger merger = new Merger(@"c:\sample1.docx"))
{
    // Add another DOCX file to merge
    merger.Join(@"c:\sample2.docx");
    // Merge DOCX files and save result
    merger.Save(@"c:\merged.docx");
}
```

## How to merge Word documents without starting from a new page

There is an additional option for Word document joining that allows to merge those documents without page breaking between them, i.e. the last page of the initial document will be merged with the first page of the next document as one page.

Below is code snippet in C# that demonstrates how to merge DOC files into single file without starting from a new page.

```csharp
// Load the source DOC file
using (Merger merger = new Merger(@"c:\sample1.doc"))
{
    // Define Word join options
    WordJoinOptions joinOptions = new WordJoinOptions();
    joinOptions.Mode = WordJoinMode.Continuous;
    // Add another DOC file to merge
    merger.Join(@"c:\sample2.doc", joinOptions);
    // Merge DOC files and save result
    merger.Save(@"c:\merged.doc");
}
```


## How to merge Word documents without section breaks

There is also another additional option for merging Word documents, which allows you to merge these documents without breaking sections, i.e. all sections and pages of all merged documents will be merged without breaks.

Below is code snippet in C# that demonstrates how to merge DOC files into single file without section breaks.

```csharp
// Load the source DOC file
using (Merger merger = new Merger(@"c:\sample1.doc"))
{
    // Define Word join options
    WordJoinOptions joinOptions = new WordJoinOptions();
    joinOptions.Mode = WordJoinMode.DisableSectionBreaks;
    // Add another DOC file to merge
    merger.Join(@"c:\sample2.doc", joinOptions);
    // Merge DOC files and save result
    merger.Save(@"c:\merged.doc");
}
```

## How to merge Word documents with pre-defined Compliance mode

There is an additional option for Word document joining that allows to merge those documents with pre-defined Compliance mode for the Word Ooxml formats such as .docx, .docm, .dotx, .dotm etc.

Below is code snippet in C# that demonstrates how to merge DOCX files into single file with ISO/IEC 29500:2008 Strict compliance level.

```csharp
// Load the source DOCX file
using (Merger merger = new Merger(@"c:\sample1.docx"))
{
    // Define Word join options
    WordJoinOptions joinOptions = new WordJoinOptions();
    joinOptions.Compliance = WordJoinCompliance.Iso29500_2008_Strict;
    // Add another DOCX file to merge
    merger.Join(@"c:\sample2.docx", joinOptions);
    // Merge DOCX files and save result
    merger.Save(@"c:\merged.docx");
}
```

## How to merge TXT files

A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by a sequence of characters.

You can combine any number of text files like shows this C# code sample:

```csharp
// Load the source TXT file
using (Merger merger = new Merger(@"c:\sample1.txt"))
{
    // Add another TXT file to merge
    merger.Join(@"c:\sample2.txt");
    // Merge TXT files and save result
    merger.Save(@"c:\merged.txt");
}
```

## How to merge RTF files

Introduced and documented by Microsoft, the Rich Text Format (RTF) represents a method of encoding formatted text and graphics for use within applications. The format facilitates cross-platform document exchange with other Microsoft Products, thus serving the purpose of interoperability. This capability makes it a standard of data transfer between word processing software and, hence, contents can be transferred from one operating system to another without losing document formatting.

Joining multiple RTF documents into one is pretty the same as for any other formats - just specify files you want to merge and save the resultant document.

```csharp
// Load the source RTF file
using (Merger merger = new Merger(@"c:\sample1.rtf"))
{
    // Add another RTF file to merge
    merger.Join(@"c:\sample2.rtf");
    // Merge RTF files and save result
    merger.Save(@"c:\merged.rtf");
}
```

## How to merge DOCX streams

Please read the following article: [How to correctly merge DOCX streams]({{< ref "merger/net/getting-started/use-cases/how-to-correctly-merge-documents-using-csharp.md" >}})

### Code Examples

Please find more [use-cases and complete C# sources](https://docs.groupdocs.com/merger/net/showcases/) of our backend and frontend examples and try them for free!

### Merge Word files Live Demo

GroupDocs.Merger for .NET provides an online [**Word Merger App**](https://products.groupdocs.app/merger/word), which allows you to try it for free and check its quality and accuracy.

---

## Convert presentations

Path: /conversion/java/convert/presentation/


Microsoft PowerPoint presentations of PPT and PPTX formats are widely used for slideshows that contain rich multimedia materials and as a modern software replacement for old slide projector devices. Microsoft Office suite includes PowerPoint and other tools, like Word and Excel, for better office productivity.  
Although Microsoft Office provides a possibility to save PPT or PPTX presentations to other formats like images, HTML, XML, etc. It may be boring, time-consuming, and ineffective to save numerous files manually.    
  
In such a situation, GroupDocs.Conversion for Java will help you with converting presentations into a wide range of output file formats. And you don't even need to install any third-party software for that! Everything can be made with just several lines of Java code.  
  
This article explains how to convert PPT (or PPTX) presentations to other file formats programmatically with Java language.

## Supported presentation file conversions

{{< include file="/conversion/java/_includes/supported-conversions/presentation.md" type="page" >}}

## Convert PPT to PPTX

Before we will take a deeper look at transforming PPT/PPTX presentations into other formats let’s learn how to convert PPT to PPTX (and vice versa).

The key difference between these two formats is that PPT specifies the Binary File Format used by Microsoft PowerPoint 97-2003, and the PPTX format is based on the Microsoft PowerPoint Open XML presentation file format that you can open on a PC in PowerPoint 2007 (or Mac in PowerPoint 2008) and newer versions.
  
The basic PPT to PPTX conversion could be performed using the code snippet below. The sequence of required steps is quite intuitive - load source PPT file into [Converter](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/Converter) object and call [convert](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion/Converter#convert(java.lang.String,%20com.groupdocs.conversion.options.convert.ConvertOptions)) method to save converted PPTX file. The PPTX format is chosen as the default format when instantiating the [PresentationConvertOptions](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/PresentationConvertOptions) object without calling the [setFormat](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/ConvertOptions#setFormat(com.groupdocs.conversion.filetypes.FileType)) method explicitly.

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PresentationConvertOptions;
...
// Load the source PPT file
Converter converter = new Converter("sample.ppt");
PresentationConvertOptions options = new PresentationConvertOptions();
// Save converted PPTX file
converter.convert("converted.pptx", options);
```

An opposite conversion from PPTX to PPT is also could be implemented with a minimum of Java code. The main difference is that you should call the [setFormat](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/ConvertOptions#setFormat(com.groupdocs.conversion.filetypes.FileType)) method with the [FileTypes.PresentationFileType.Ppt](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.filetypes/PresentationFileType#Ppt) argument. Please take a look at the code example below:  

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PresentationConvertOptions;
import com.groupdocs.conversion.filetypes.PresentationFileType;
...
// Load the source PPTX file
Converter converter = new Converter("sample.pptx");
PresentationConvertOptions options = new PresentationConvertOptions();
options.setFormat(PresentationFileType.Ppt);
// Save converted PPT file
converter.convert("converted.ppt", options);
```

## Convert PowerPoint to PDF

Portable Document Format (PDF) is very popular nowadays for many reasons, therefore converting PowerPoint presentations to PDF format is also quite a demanding feature for customers from different areas. PowerPoint presentations could be presented in multiple file formats like PPT, PPTX, PPSM, PPS, etc. So let’s see how to convert them into PDF using Java code.  
  
The actual process of conversion is very simple - provide your presentation file to the `Converter` class, call the `convert` method which will do all necessary transformations and save the output PDF file where you want it to be saved. Let’s review just several code examples of PDF conversion, as for other presentation formats it’s almost the same - the only difference is a file extension of your input presentation file.

### Convert PPTX to PDF

Here is an example of converting a PPTX presentation to PDF format. As you can see it's pretty simple and straightforward.  

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source PPTX file
Converter converter = new Converter("sample.pptx");
PdfConvertOptions options = new PdfConvertOptions();
// Save converted PDF file
converter.convert("converted.pdf", options);
```

### Convert PPSM to PDF

Files with PPSM extension represent Macro-enabled Slide Show file format created with Microsoft PowerPoint 2007 or higher. Another similar file format is [PPTM](https://docs.fileformat.com/presentation/pptm/) which differs in opening with Microsoft PowerPoint in editable format instead of running as Slide Show. When run as a slideshow, the PPSM file shows the presentation slides with contents intact in the slide show and is in read-only mode by default. PPSM files can still be edited in Microsoft PowerPoint by opening them in PowerPoint.

The Java code required for converting PPSM into PDF is provided below.

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source PPSM file
Converter converter = new Converter("sample.ppsm");
PdfConvertOptions options = new PdfConvertOptions();
// Save converted PDF file
converter.convert("converted.pdf", options);
```

## Convert Presentation to image

There is often a need to transform a PowerPoint presentation into a collection of images. Of course, it could be manually exported with the help of Microsoft PowerPoint, but in case you don't have it at hand or in case there is a big number of presentations to be converted,  it’s more convenient to convert the presentation to images programmatically.  
No matter which image format you choose - GroupDocs.Conversion supports a wide range of them - **PNG**, **JPG/JPEG**, **TIF/TIFF**, **GIF** (and many [others]({{< ref "conversion/java/supported-document-formats.md" >}})).  
  
Here is a code snippet that shows how to convert PPTX to PNG image in Java programming language:

```java
import java.io.FileOutputStream;
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.SavePageStream;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.filetypes.ImageFileType;
...
SavePageStream getPageStream = page => new FileOutputStream(String.format("converted-slide-%s.png", page));
// Load the source PPTX file
Converter converter = new Converter("sample.pptx");
// Set the convert options for PNG format
ImageConvertOptions options = new ImageConvertOptions();
options.setFormat(ImageFileType.Png);  
// Convert to PNG format
converter.convert(getPageStream, options);
```

---

## Convert presentations

Path: /conversion/net/convert/presentation/


Microsoft PowerPoint presentations of PPT and PPTX formats are widely used for slideshows that contain rich multimedia materials and as a modern software replacement for old slide projector devices. Microsoft Office suite includes PowerPoint and other tools, like Word and Excel, for better office productivity.  
Although Microsoft Office provides a possibility to save PPT or PPTX presentations to other formats like images, HTML, XML, etc. It may be boring, time-consuming, and ineffective to save numerous files manually.    
  
In such a situation, GroupDocs.Conversion for .NET will help you with converting presentations into a wide range of output file formats. And you don't even need to install any third-party software for that! Everything can be made with just several lines of C# code.  
  
This article explains how to convert PPT (or PPTX) presentations to other file formats programmatically using C# language.

## Supported presentation file conversions

{{< include file="/conversion/net/_includes/supported-conversions/presentation.md" type="page" >}}

## Convert PPT to PPTX

Before we will take a deeper look at transforming PPT/PPTX presentations into other formats let’s learn how to convert PPT to PPTX (and vice versa).

The key difference between these two formats is that PPT specifies the Binary File Format used by Microsoft PowerPoint 97-2003, and the PPTX format is based on the Microsoft PowerPoint Open XML presentation file format that you can open on a PC in PowerPoint 2007 (or Mac in PowerPoint 2008) and newer versions.  
  
The basic PPT to PPTX conversion could be performed using the code snippet below. The sequence of required steps is quite intuitive - load the source PPT file into the [Converter](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter) object and call the [Convert](https://reference.groupdocs.com/conversion/net/groupdocs.conversion/converter/convert/#convert_16) method to save the converted PPTX file. The PPTX format is chosen as the default format when instantiating the [PresentationConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/presentationconvertoptions) object without specifying the [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) property explicitly.

```csharp
// Load the source PPT file
using (var converter = new GroupDocs.Conversion.Converter("sample.ppt"))
{
    var options = new PresentationConvertOptions();
    // Save converted PPTX file
    converter.Convert("converted.pptx", options);
}
```

An opposite conversion from PPTX to PPT is also could be implemented with a minimum of C# code. The main difference is that the [Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/) property should be set to [FileTypes.PresentationFileType.Ppt](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/presentationfiletype/ppt/).  Please take a look at the code example below:  

```csharp
// Load the source PPTX file
using (var converter = new GroupDocs.Conversion.Converter("sample.pptx"))
{
    PresentationConvertOptions options = new PresentationConvertOptions { Format = GroupDocs.Conversion.FileTypes.PresentationFileType.Ppt };
    // Save converted PPT file
    converter.Convert("converted.ppt", options);
}
```

## Convert PowerPoint to PDF

Portable Document Format (PDF) is very popular nowadays for many reasons, therefore converting PowerPoint presentations to PDF format is also quite a demanding feature for customers from different areas. PowerPoint presentations could be presented in multiple file formats like PPT, PPTX, PPSM, PPS, etc. So let’s see how to convert them into PDF using C# code.  
  
The actual process of conversion is very simple - provide your presentation file to the `Converter` class, call the `Convert` method which will do all necessary transformations and save the output PDF file where you want it to be saved. Let’s review just several code examples of PDF conversion, as for other presentation formats it’s almost the same - the only difference is a file extension of your input presentation file.

### Convert PPTX to PDF

Here is an example of converting a PPTX presentation to PDF format. As you can see it's pretty simple and straightforward.  

```csharp
// Load the source PPTX file
using (var converter = new GroupDocs.Conversion.Converter("sample.pptx"))
{
    var options = new PdfConvertOptions();
    // Save converted PDF file
    converter.Convert("converted.pdf", options);
}
```

### Convert PPSM to PDF

Files with PPSM extension represent Macro-enabled Slide Show file format created with Microsoft PowerPoint 2007 or higher. Another similar file format is [PPTM](https://docs.fileformat.com/presentation/pptm/) which differs in opening with Microsoft PowerPoint in editable format instead of running as Slide Show. When run as a slideshow, the PPSM file shows the presentation slides with contents intact in the slide show and is in read-only mode by default. PPSM files can still be edited in Microsoft PowerPoint by opening them in PowerPoint.

The C# code required for converting PPSM into PDF is provided below.

```csharp
// Load the source PPSM file
using (var converter = new GroupDocs.Conversion.Converter("sample.ppsm"))
{
    var options = new PdfConvertOptions();
    // Save converted PDF file
    converter.Convert("converted.pdf", options);
}
```

## Convert presentation to image

There is often a need to transform a PowerPoint presentation into a collection of images. Of course, it could be manually exported with the help of Microsoft PowerPoint, but in case you don't have it at hand or when there is a big number of presentations to be converted,  it’s more convenient to convert the presentation to images programmatically.  
No matter which image format you choose - GroupDocs.Conversion supports a wide range of them - **PNG**, **JPG/JPEG**, **TIF/TIFF**, **GIF** (and many [others]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})).  
  
Here is a code snippet that shows how to convert PPTX to PNG image in C# programming language:

```csharp
Func<SavePageContext, Stream> getPageStream = saveContext => new FileStream(string.Format("converted-slide-{0}.png", saveContext.Page), FileMode.Create);
// Load the source PPTX file
using (Converter converter = new GroupDocs.Conversion.Converter("sample.pptx"))
{
    // Set the convert options for PNG format
    ImageConvertOptions options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png };
    // Convert to PNG format
    converter.Convert(getPageStream, options);
}
```

---

## Convert presentations

Path: /conversion/nodejs-java/convert/presentation/


Microsoft PowerPoint presentations of PPT and PPTX formats are widely used for slideshows that contain rich multimedia materials and as a modern software replacement for old slide projector devices. Microsoft Office suite includes PowerPoint and other tools, like Word and Excel, for better office productivity.  
Although Microsoft Office provides a possibility to save PPT or PPTX presentations to other formats like images, HTML, XML, etc. It may be boring, time-consuming, and ineffective to save numerous files manually.   
  
In such a situation, GroupDocs.Conversion for Node.js via Java will help you with converting presentations into a wide range of output file formats. And you don't even need to install any third-party software for that! Everything can be made with just several lines of JavaScript code.  
  
This article explains how to convert PPT (or PPTX) presentations to other file formats programmatically with JavaScript language.

## Supported presentation file conversions

{{< include file="/conversion/nodejs-java/_includes/supported-conversions/presentation.md" type="page" >}}

## Convert PPT to PPTX

Before we will take a deeper look at transforming PPT/PPTX presentations into other formats let’s learn how to convert PPT to PPTX (and vice versa).

The key difference between these two formats is that PPT specifies the Binary File Format used by Microsoft PowerPoint 97-2003, and the PPTX format is based on the Microsoft PowerPoint Open XML presentation file format that you can open on a PC in PowerPoint 2007 (or Mac in PowerPoint 2008) and newer versions.
  
The basic PPT to PPTX conversion could be performed using the code snippet below. The sequence of required steps is quite intuitive - load source PPT file into [Converter](#) object and call [convert](#) method to save converted PPTX file. The PPTX format is chosen as the default format when instantiating the [PresentationConvertOptions](#) object without calling the [setFormat](#) method explicitly.

```js
// Load the source PPT file
const converter = new groupdocs.conversion.Converter("sample.ppt");
const options = new groupdocs.conversion.PresentationConvertOptions();
// Save converted PPTX file
converter.convert("converted.pptx", options);
```

An opposite conversion from PPTX to PPT is also could be implemented with a minimum of JavaScript code. The main difference is that you should call the [setFormat](#) method with the [FileTypes.PresentationFileType.Ppt](#) argument. Please take a look at the code example below:  

```js
// Load the source PPTX file
const converter = new groupdocs.conversion.Converter("sample.ppt");
const options = new groupdocs.conversion.PresentationConvertOptions();
options.setFormat(PresentationFileType.Ppt);
// Save converted PPT file
converter.convert("converted.ppt", options);
```

## Convert PowerPoint to PDF

Portable Document Format (PDF) is very popular nowadays for many reasons, therefore converting PowerPoint presentations to PDF format is also quite a demanding feature for customers from different areas. PowerPoint presentations could be presented in multiple file formats like PPT, PPTX, PPSM, PPS, etc. So let’s see how to convert them into PDF using JavaScript code.  
  
The actual process of conversion is very simple - provide your presentation file to the `Converter` class, call the `convert` method which will do all necessary transformations and save the output PDF file where you want it to be saved. Let’s review just several code examples of PDF conversion, as for other presentation formats it’s almost the same - the only difference is a file extension of your input presentation file.

### Convert PPTX to PDF

Here is an example of converting a PPTX presentation to PDF format. As you can see it's pretty simple and straightforward.  

```js
// Load the source PPTX file
const converter = new groupdocs.conversion.Converter("sample.ppt");
const options = new groupdocs.conversion.PdfConvertOptions();
// Save converted PDF file
converter.convert("converted.pdf", options);
```

### Convert PPSM to PDF

Files with PPSM extension represent Macro-enabled Slide Show file format created with Microsoft PowerPoint 2007 or higher. Another similar file format is [PPTM](https://docs.fileformat.com/presentation/pptm/) which differs in opening with Microsoft PowerPoint in editable format instead of running as Slide Show. When run as a slideshow, the PPSM file shows the presentation slides with contents intact in the slide show and is in read-only mode by default. PPSM files can still be edited in Microsoft PowerPoint by opening them in PowerPoint.

The JavaScript code required for converting PPSM into PDF is provided below.

```js
// Load the source PPSM file
const converter = new groupdocs.conversion.Converter("sample.ppsm");
const options = new groupdocs.conversion.PdfConvertOptions();
// Save converted PDF file
converter.convert("converted.pdf", options);
```

## Convert Presentation to image

There is often a need to transform a PowerPoint presentation into a collection of images. Of course, it could be manually exported with the help of Microsoft PowerPoint, but in case you don't have it at hand or in case there is a big number of presentations to be converted,  it’s more convenient to convert the presentation to images programmatically.  
No matter which image format you choose - GroupDocs.Conversion supports a wide range of them - **PNG**, **JPG/JPEG**, **TIF/TIFF**, **GIF** (and many [others]({{< ref "conversion/nodejs-java/getting-started/supported-document-formats.md" >}})).  
  
Here is a code snippet that shows how to convert PPTX to PNG image in JavaScript programming language:

```js
const outputFileTemplate = "converted-page-.png";
// Load the source PPTX file
const converter = new groupdocs.conversion.Converter("sample.pptx");
// Set the convert options for PNG format
const options = new groupdocs.conversion.ImageConvertOptions();
options.setFormat(groupdocs.conversion.ImageFileType.Png);  
// Convert to PNG format
converter.convert(outputFileTemplate, options);
```

---

## Use of In-line Syntax Error Messages into Templates

Path: /assembly/net/use-of-in-line-syntax-error-messages-into-templates/

{{< alert style="info" >}}This feature is supported by version 19.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}{{< alert style="info" >}}This version provide the ability to display inline template syntax errors in generated, Word Processing, Presentation, Spreadsheets, Emails and Plain Text documents.{{< /alert >}}

By default, Document Assembler throws an exception when encounters a template syntax error. Such an exception provides information on a reason of the error and specifies a tag or expression part where the error is encountered. In most cases, this information is enough to find a place in a template causing the error and fix it.

However, when dealing with complex templates containing a large number of tags, it becomes harder to find an exact place in a template causing an error. To make things easier, the engine supports the [DocumentAssemblyOptions.InlineErrorMessages](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassemblyoptions) option that enables in-lining of a syntax error message into a template document at an exact position where the error occurs during run-time.

{{< alert style="warning" >}}A template syntax error message is written using a bold font to make it more apparent.{{< /alert >}}

Consider the following template.

```csharp
<<var [name]>>
```

By default, such a template causes the engine to throw an exception while building a report. However, when* *DocumentAssemblyOptions.InlineErrorMessages** is applied, no exception is thrown and the report looks as follows then.

```csharp
<<var [name] Error! An assignment operator is expected. >>
```

{{< alert style="warning" >}}Only messages describing errors in template syntax can be in-lined, messages describing errors encountered during expression's evaluation cannot be appeared.{{< /alert >}}

When **DocumentAssemblyOptions.InlineErrorMessages** is applied, a Boolean value returned by a[DocumentAssembler.AssembleDocument](https://reference.groupdocs.com/net/assembly/groupdocs.assembly/documentassembler/methods/index) overload indicates whether building of a report was finished successfully or was interrupted because of a template syntax error. This enables you to process reports which building succeeded or failed differently as shown in the following code snippet.

{{< gist GroupDocsGists 38423b1ec37339adfe83cd82adb8b617 >}}

{{< alert style="warning" >}}In this article the Word Processing document template file has been used. Therefore, the process for the other file formats is same.{{< /alert >}}

### Download Demo File

Please download the sample demo document files:

*   [Inline error demo.docx](https://github.com/groupdocs-assembly/GroupDocs.Assembly-for-.NET/blob/master/Examples/Data/Source/Word%20Templates/Inline%20Error%20Demo.docx?raw=true)

---

## Using Markdown Documents

Path: /assembly/net/using-markdown-documents/

{{< alert style="info" >}}This feature is supported by version 19.8 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

## Markdown Documents (MD) 

**Markdown** is a [lightweight markup language](https://en.wikipedia.org/wiki/Lightweight_markup_language) intended for one purpose, to be used to format text on the web with plain text formatting syntax. Let it be clear that Markdown is not a replacement for HTML because its syntax is very small, containing a very small subset of HTML tags. The reason behind the Markdown is to make it easy to read, write and edit prose. In other words we can say that HTML is a publishing format while the Markdown is a writing format.

The text files created with Markdown language dialects is saved with **.MD** or **.MARKDOWN** file extension. The MD files are saved in plain text format that uses Markdown language which also includes inline text symbols, defining how a text can be formatted such as indentations, table formatting, fonts, and headers.

## Working with Markdown Documents

Since version 19.8, the GroupDocs.Assembly provides abilities for saving of assembled Markdown documents to Word Processing formats and saving of assembled Word Processing documents and emails to Markdown. 

The API supports the following Markdown features:

*   Headings
*   Block quotes
*   Horizontal rules
*   Bold emphasis
*   Italic emphasis

### Extended the set of supported Markdown features

{{< alert style="info" >}}This feature is supported by version 19.11 or greater.{{< /alert >}}

Since version 19.11, the following Markdown features are supported when saving assembled Markdown documents to Word Processing formats and saving assembled Word Processing documents and emails to Markdown:

*   [Indented code blocks ](https://spec.commonmark.org/0.29/#indented-code-blocks)
*   [Fenced code blocks](https://spec.commonmark.org/0.29/#fenced-code-blocks)
*   [Inline code spans](https://spec.commonmark.org/0.29/#code-spans)
*   [Strikethrough text](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#emphasis)
*   Unordered list (v 19.12 or later)

Following sections show that how we can load from and save to Markdown documents:

### Saving an Assembled Markdown Documents to Word Processing Docs

Suppose, we have an assembled Markdown (MD) document ([ReadMe.md](attachments/85230860/85426211.md)) as template having the content as shown below:

```csharp
# <<[product]>>
-----
## Description
<<[description]>>
## Evaluation and Licensing
The library comes up with some limitations in the evaluation mode. 
In order to test full features of <<[product]>>, 
please request a **free 30-day temporary license**.
```

The following code snippet demonstrates the saving this MD document to a Word Processing file.

{{< gist GroupDocsGists b06d6c5655c84fc772c6411d66016943 SaveMdtoWord_UsingExtension_19.8.cs >}}

The resultant word document ([ReadMe Out.docx](attachments/85230860/85426210.docx)) is available for download.

### Saving an Assembled Word Processing Document or Email to Markdown

{{< alert style="info" >}}The version 19.8 supports only assembled emails and Word Processing documents to save into Markdown format.{{< /alert >}}

Suppose, we have a Word Processing template([ReadMe.docx](attachments/85230860/85426212.docx)) having the same content as above Markdown template.

The following code snippet demonstrates the saving this assembled Word Processing document to a Markdown file.

{{< gist GroupDocsGists b06d6c5655c84fc772c6411d66016943 SaveWordtoMD_UsingExtension_19.8.cs >}}

The resultant word document ([ReadMe Out.md](attachments/85230860/85426213.md)) is available for download.

### Saving an Assembled Word Processing Document or Email to Markdown (Explicit)

The following code snippet shows the saving of an assembled Word Processing document or email to Markdown using explicit specifying:

{{< gist GroupDocsGists b06d6c5655c84fc772c6411d66016943 SaveWordtoMD_Explicit_19.8.cs >}}

---

## Inserting Images Dynamically

Path: /assembly/java/inserting-images-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

You can insert images to your reports dynamically using image tags. To declare a dynamically inserted image within your template, do the following steps:

1.  Add a textbox to your template at the place where you want an image to be inserted.
2.  Set common image attributes such as frame, size, and others for the textbox, making the textbox look like a blank inserted image.
3.  Specify an image tag within the textbox using the following syntax.

```java
<<image [image_expression]>>
```

And simply call the assembler method to generate report like following code snippets:

{{< gist GroupDocsGists ecbe5e7331f08a3f0bccd81a1ef57995 insertImageDynamicallyInWord_20.3.java >}}

The expression declared within an image tag is used by the assembler to build an image to be inserted. The expression must return a value of one of the following types:

*   A byte array containing an image data
*   A InputStream instance able to read an image data
*   An BufferredImage object
*   A string containing an image URI, path, or Base64-encoded image data

While building a report, the following procedure is applied to an image tag:

1.  The expression declared within the tag is evaluated and its result is used to form an image.
2.  The corresponding textbox is filled with this image.
3.  The tag is removed from the textbox.

{{< alert style="warning" >}}If the expression declared within an image tag returns a stream object, then it is closed by the assembler as soon as the corresponding image is built. {{< /alert >}}

By default, the assembler stretches an image filling a textbox to the size of the textbox. However, you can change this behavior in the following ways:

*   To keep the size of the textbox and stretch the image within bounds of the textbox preserving the ratio of the image, use the *keepRatio* switch as follows:
  
    ```java
    <<image [image_expression] -keepRatio>>
    ```
    
*   To keep the width of the textbox and change its height preserving the ratio of the image, use the fitHeight switch as follows.
  
    ```java
    <<image [image_expression] -fitHeight>>
    ```
    
*   To keep the height of the textbox and change its width preserving the ratio of the image, use the fitWidth switch as follows.
  
    ```java
    <<image [image_expression] -fitWidth>>
    ```
    
*   To change the size of the textbox according to the size of the image, use the fitSize switch as follows.
  
    ```java
    <<image [image_expression] -fitSize>>
    ```
    
*   To change the size of the textbox according to the size of the image without increasing the size of the textbox, use the fitSizeLim switch as follows.
  
    ```java
    <<image [image_expression] -fitSizeLim>>
    ```
    
    
    {{< alert style="warning" >}}If the size of the image is greater than the size of the textbox, then the fitSizeLim switch acts like fitHeight or fitWidth. Otherwise, the fitSizeLim switch acts like fitSize.{{< /alert >}}
    

{{< alert style="warning" >}}Dynamic insertion of images from Base64-encoded bytes is available for file formats where dynamic image insertion is available for almost all supported file formats.{{< /alert >}}

---

## Inserting Documents Dynamically

Path: /assembly/java/inserting-documents-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

{{< alert style="warning" >}}Dynamic insertion of documents from Base64-encoded bytes is available for file formats where dynamic document insertion is available for Word Processing documents and emails with HTML and RTF bodies only.{{< /alert >}}

You can insert contents of outer documents to your reports dynamically using `doc` tags. A `doc` tag denotes a placeholder within a template for a document to be inserted during run time.

Syntax of a `doc` tag is defined as follows:

```java
<<doc [document_expression]>>
```

And simply call the assembler method to generate report like following code snippets:

{{< gist GroupDocsGists ecbe5e7331f08a3f0bccd81a1ef57995 insertDocumentDynamicallyInWord_20.3.java >}}

{{< alert style="warning" >}}A `doc` tag can be used almost anywhere in a template document except textboxes and charts.{{< /alert >}}

An expression declared within a `doc` tag is used by the assembler to load a document to be inserted during runtime. The expression must return a value of one of the following types:

*   A byte array containing document data
*   An InputStream[ instance able to read document data](http://msdn.microsoft.com/en-us/library/system.io.stream(v=vs.110).aspx)
*   An instance of the `Document` class
*   A string containing a document URI, path, or Base64-encoded document data

While building a report, an expression declared within a `doc` tag is evaluated and its result is used to load a document which content replaces the `doc` tag then.

{{< alert style="warning" >}}If an expression declared within a `doc` tag returns a stream object, then the stream is closed by the assembler as soon as a corresponding document is loaded.{{< /alert >}}

By default, while inserting content of an outer document, the engine applies corresponding styles of a template document. This makes content of a result document look more consistent. However, you can keep source formatting for content being inserted by using a `sourceStyles` switch as shown in the following snippet:

```java
<<doc [document_expression] -sourceStyles>>
```

By default, a document being inserted is not checked against template syntax and is not populated with data. However, you can enable this by using a `build` switch as follows.

```java
<<doc [document_expression] -build>>
```

When a `build` switch is used, the assembler treats a document being inserted as a template that can access the following data available at the scope of a corresponding `doc` tag:

*   Data sources
*   Variables
*   A contextual object (see [“Using Contextual Object Member Access”](https://docs.groupdocs.com/assembly/java/template-syntax-part-1-of-2/#using-contextual-object-member-access) for more information)
*   Known external types (see [“Setting up Known External Types”](https://docs.groupdocs.com/assembly/java/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information)


---

## Inserting Documents Dynamically

Path: /assembly/net/inserting-documents-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

{{< alert style="warning" >}}Dynamic insertion of documents from Base64-encoded bytes is available for file formats where dynamic document insertion is available for Word Processing documents and emails with HTML and RTF bodies only.{{< /alert >}}

You can insert contents of outer documents to your reports dynamically using `doc` tags. A `doc` tag denotes a placeholder within a template for a document to be inserted during runtime.

Syntax of a `doc` tag is defined as follows:

```csharp
<<doc [document_expression]>>
```

And simply call the assembler method to generate report like following code snippets:

{{< gist GroupDocsGists b06d6c5655c84fc772c6411d66016943 InsertDocumentDynamicallyInWord_20.3.cs >}}

{{< alert style="warning" >}}A `doc` tag can be used almost anywhere in a template document except textboxes and charts.{{< /alert >}}

An expression declared within a `doc` tag is used by the assembler to load a document to be inserted during runtime. The expression must return a value of one of the following types:

*   A byte array containing document data
*   A [Stream](http://msdn.microsoft.com/en-us/library/system.io.stream(v=vs.110).aspx) instance able to read document data
*   An instance of the Document class
*   A string containing a document URI, path, or Base64-encoded document data

While building a report, an expression declared within a `doc` tag is evaluated and its result is used to load a document which content replaces the `doc` tag then.

{{< alert style="warning" >}}If an expression declared within a `doc` tag returns a stream object, then the stream is closed by the assembler as soon as a corresponding document is loaded.{{< /alert >}}

By default, while inserting content of an outer document, the engine applies corresponding styles of a template document. This makes content of a result document look more consistent. However, you can keep source formatting for content being inserted by using a `sourceStyles` switch as shown in the following snippet:

```csharp
<<doc [document_expression] -sourceStyles>>
```

By default, a document being inserted is not checked against template syntax and is not populated with data. However, you can enable this by using a `build` switch as follows:

```csharp
<<doc [document_expression] -build>>
```

When a `build` switch is used, the assembler treats a document being inserted as a template that can access the following data available at the scope of a corresponding `doc` tag:

*   Data sources
*   Variables
*   A contextual object (see [“Using Contextual Object Member Access”](https://docs.groupdocs.com/assembly/net/template-syntax-part-1-of-2/#using-contextual-object-member-access) for more information)
*   Known external types (see [“Setting up Known External Types”](https://docs.groupdocs.com/assembly/net/groupdocs-assembly-engine-apis/#setting-up-known-external-types) for more information)

---

## Inserting Images Dynamically

Path: /assembly/net/inserting-images-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

You can insert images to your reports dynamically using image tags. To declare a dynamically inserted image within your template, do the following steps:

1.  Add a textbox to your template at the place where you want an image to be inserted.
2.  Set common image attributes such as frame, size, and others for the textbox, making the textbox look like a blank inserted image.
3.  Specify an image tag within the textbox using the following syntax.

```csharp
<<image [image_expression]>>
```

And simply call the assembler method to generate report like following code snippets:

{{< gist GroupDocsGists b06d6c5655c84fc772c6411d66016943 InsertImageDynamicallyInWord_20.3.cs >}}

The expression declared within an image tag is used by the assembler to build an image to be inserted. The expression must return a value of one of the following types:

*   A byte array containing an image data
*   A [Stream](http://msdn.microsoft.com/en-us/library/system.io.stream(v=vs.110).aspx) instance able to read an image data
*   An [Image](http://msdn.microsoft.com/en-us/library/system.drawing.image(v=vs.110).aspx) object
*   A string containing an image URI, path, or Base64-encoded image data

While building a report, the following procedure is applied to an image tag:

1.  The expression declared within the tag is evaluated and its result is used to form an image.
2.  The corresponding textbox is filled with this image.
3.  The tag is removed from the textbox.

{{< alert style="warning" >}}If the expression declared within an image tag returns a stream object, then it is closed by the assembler as soon as the corresponding image is built. {{< /alert >}}

By default, the assembler stretches an image filling a textbox to the size of the textbox. However, you can change this behavior in the following ways:

*   To keep the size of the textbox and stretch the image within bounds of the textbox preserving the ratio of the image, use the *keepRatio* switch as follows:
  
    ```csharp
    <<image [image_expression] -keepRatio>>
    ```
    
*   To keep the width of the textbox and change its height preserving the ratio of the image, use the fitHeight switch as follows.
  
    ```csharp
    <<image [image_expression] -fitHeight>>
    ```
    
*   To keep the height of the textbox and change its width preserving the ratio of the image, use the fitWidth switch as follows.
  
    ```csharp
    <<image [image_expression] -fitWidth>>
    ```
    
*   To change the size of the textbox according to the size of the image, use the fitSize switch as follows.
  
    ```csharp
    <<image [image_expression] -fitSize>>
    ```
    
*   To change the size of the textbox according to the size of the image without increasing the size of the textbox, use the fitSizeLim switch as follows.
  
    ```csharp
    <<image [image_expression] -fitSizeLim>>
    ```
    
    {{< alert style="warning" >}}If the size of the image is greater than the size of the textbox, then the fitSizeLim switch acts like fitHeight or fitWidth. Otherwise, the fitSizeLim switch acts like fitSize.{{< /alert >}}
    

{{< alert style="warning" >}}Dynamic insertion of images from Base64-encoded bytes is available for file formats where dynamic image insertion is available for almost all supported file formats.{{< /alert >}}

---

## Set Checkbox Values Dynamically

Path: /assembly/java/set-checkbox-values-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/java/the-business-layer/).{{< /alert >}}

You can set checkbox values to either checked or unchecked in your reports dynamically by taking the following steps:

1.  Add a checkbox content control to your template at a place where you want it to appear in a result document.
2.  By editing content control properties, add a check tag to the title of the checkbox content control using the following syntax.

```java
<<check [conditional_expression]>>
```

The code will look like following snippet:

{{< gist GroupDocsGists ecbe5e7331f08a3f0bccd81a1ef57995 setCheckboxValueDynamicallyInWord_20.3.java >}}

Here, conditional\_expression defines a condition upon which the value of the checkbox content control is to be set to checked (or unchecked, if the condition is not met). The conditional expression must return a Boolean value.

While building a report, a conditional expression declared within a check tag is evaluated and the value of its containing checkbox content control is set accordingly. The check tag itself is removed then.

{{< alert style="warning" >}}Dynamic checkbox value setting is available for Word Processing documents only.{{< /alert >}}

---

## Deleting documents

Path: /search/java/deleting-documents/

Documents can be deleted from the search network using the [delete](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#delete-java.lang.String---com.groupdocs.search.options.DeleteOptions-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class.

To delete documents, you must pass an array of document keys, as well as a delete options object, to the [delete](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#delete-java.lang.String---com.groupdocs.search.options.DeleteOptions-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class.

An asynchronous delete flag is available as an option. In the case of asynchronous deletion, you can track the completion of the operation by subscribing to the [DeletionCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#DeletionCompleted) event.

The following code example demonstrates how to delete documents from the search network.

```java
System.out.println();
System.out.println("Deleting documents");

String[] fileNames = new String[filePaths.length];
for (int i = 0; i < filePaths.length; i++) {
    String filePath = filePaths[i];
    fileNames[i] = filePath;
}

Indexer indexer = node.getIndexer();

DeleteOptions options = new DeleteOptions();
indexer.delete(fileNames, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Deleting documents

Path: /search/net/deleting-documents/

Documents can be deleted from the search network using the [Delete](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/delete/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class.

To delete documents, you must pass an array of document keys, as well as a delete options object, to the [Delete](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/delete/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class.

An asynchronous delete flag is available as an option. In the case of asynchronous deletion, you can track the completion of the operation by subscribing to the [DeletionCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/deletioncompleted/) event.

The following code example demonstrates how to delete documents from the search network.

**C#**

```csharp
Console.WriteLine();
Console.WriteLine("Deleting documents");

string[] fileNames = new string[filePaths.Length];
for (int i = 0; i < filePaths.Length; i++)
{
    string filePath = filePaths[i];
    string fileName = Path.GetFileName(filePath);
    fileNames[i] = fileName;
}

Indexer indexer = node.Indexer;

DeleteOptions options = new DeleteOptions();
indexer.Delete(fileNames, options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## How to edit CSV file

Path: /editor/java/how-to-edit-csv-file/

> This demonstration shows and explains all necessary moments and options regarding processing DSV spreadsheets (Delimiter-separated values)

## Introduction

DSV (Delimiter-Separated Values) documents are specific form of text-based spreadsheets with delimiters (separators). Due of their nature the [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) processes this class of documents separately from usual binary spreadsheets. In counterpart to usual spreadsheets, DSV documents due to their textual nature have only single tab (worksheet) and cannot be encoded. But any non-empty string may be treated as separator, so user always need to specify it explicitly.
The most common types of DSV are:

1. CSV (Comma-Separated value)
2. TSV (Tab-Separated value)
3. Semicolon-separated value
4. Whitespace-separated value
5. ...and any other

GroupDocs.Editor supports DSV with any separator, which can be character or a set of characters (string).

## Loading CSV file for edit

Unlike WordProcessing and Spreadsheet documents, DSV documents are loaded into the [Editor](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class without any loading options. They are simple text files by their nature, so it is nothing to adjust:

```java
String inputCsvPath = "C://input//spreadsheet.csv";
Editor editor = new Editor(inputCsvPath);
```

## Editing CSV file

In order to open any DSV document for edit, user must use [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions) class, which single constructor has one mandatory parameter — string separator (delimiter), that should not be NULL or empty string. There are also several optional properties. Two properties — [getConvertDateTimeData()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions#getConvertDateTimeData--) and [getConvertNumericData()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions#getConvertNumericData--) — are boolean flags, which indicate how to treat numbers. GroupDocs.Editor can recognize digits within cells and treat them as numbers or date-time values. By default this recognition is disabled, but user can turn it on. Next property — [getTreatConsecutiveDelimitersAsOne()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions#getTreatConsecutiveDelimitersAsOne--), — is also a boolean flag, which determines how the consecutive delimiters should be treated — as several (default - false) or as a single one (true).

Last property — [getOptimizeMemoryUsage()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions#getOptimizeMemoryUsage--), — is also a boolean flag, but with completely different purpose. By default GroupDocs.Editor algorithms are tuned for maximum performance for reducing the latency time; memory consumption has lower priority. However in some rare cases user may need to load and open very huge DSV, several hundreds of MiBs or even close to GiB. In such cases GroupDocs.Editor (Java in fact) may throw an OutOfMemoryException. For coping with such use-cases the [getOptimizeMemoryUsage()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions#getOptimizeMemoryUsage--) flag was introduced. By enabling it user switches GroupDocs.Editor to use another processing algorithms, which consume relatively low amount of memory at the cost of lower performance.

Example below demonstrates using the [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions) for editing CSV document, where comma character is a delimiter:

```java
DelimitedTextEditOptions editOptions = new DelimitedTextEditOptions(",");
editOptions.setConvertDateTimeData(false);
editOptions.setConvertNumericData(true);
editOptions.setTreatConsecutiveDelimitersAsOne(true);
editOptions.setOptimizeMemoryUsage(true);

EditableDocument document = editor.edit(editOptions);
```

## Save edited CSV file

After being edited, input DSV can be saved back to DSV (not necessary with the same separator) or to any supportable Spreadsheet document. In order to save document to DSV format user must use the [DelimitedTextSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtextsaveoptions) class, which, like the [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtexteditoptions), has one constructor with mandatory string parameter — separator (delimiter), that should not be NULL or empty string.

There are also other properties:

1. [getEncoding()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtextsaveoptions#getEncoding--). Allows to specify the encoding of generated DSV. By default, if not specified, is UTF8.
2. [getTrimLeadingBlankRowAndColumn()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtextsaveoptions#getTrimLeadingBlankRowAndColumn--). Boolean flag, that indicates whether leading blank rows and columns should be trimmed like what MS Excel does.
3. [getKeepSeparatorsForBlankRow()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/delimitedtextsaveoptions#getKeepSeparatorsForBlankRow--). Boolean flag, that indicates whether separators should be output for blank row. Default value is false which means the content for blank row will be empty.

Example below demonstrates loading CSV, opening it to the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance, and saving to TSV and XLSM.

```java
String inputCsvPath = "C://input//spreadsheet.csv";
Editor editor = new Editor(inputCsvPath);

DelimitedTextEditOptions editOptions = new DelimitedTextEditOptions(",");
EditableDocument document = editor.edit(editOptions);

DelimitedTextSaveOptions tsvSaveOptions = new DelimitedTextSaveOptions("\t");
tsvSaveOptions.setTrimLeadingBlankRowAndColumn(true);
tsvSaveOptions.setKeepSeparatorsForBlankRow(false);

SpreadsheetSaveOptions xlsmSaveOptions = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsm);

String tsvSavePath = "C://output//spreadsheet.tsv";
String xlsmSavePath = "C://output//spreadsheet.xlsm";

editor.save(document, tsvSavePath, tsvSaveOptions);
editor.save(document, xlsmSavePath, xlsmSaveOptions);
```

In this example output "'spreadsheet.tsv" will have a UTF-8 encoding.

---

## How to edit CSV file

Path: /editor/net/how-to-edit-csv-file/

> This demonstration shows and explains all necessary moments and options regarding processing DSV spreadsheets (Delimiter-separated values) like CSV and others

## Introduction

DSV (Delimiter-Separated Values) files are specific form of text-based spreadsheets with delimiters (separators). Due of their nature the [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) processes this class of documents separately from usual binary spreadsheets. In counterpart to usual spreadsheets, DSV documents due to their textual nature have only single tab (worksheet) and cannot be encoded. But any non-empty string may be treated as separator, so user always need to specify it explicitly.

The most common types of DSV are:

1. CSV (Comma-Separated value)
2. TSV (Tab-Separated value)
3. Semicolon-separated value
4. Whitespace-separated value
5. ...and any other

GroupDocs.Editor supports DSV with any separator, which can be character or a set of characters (string).

## Loading CSV file for edit

Unlike WordProcessing and Spreadsheet documents, DSV documents are loaded into the [Editor](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class without any loading options. They are simple text files by their nature, so it is nothing to adjust:

```csharp
string inputCsvPath = "C://input/spreadsheet.csv";
Editor editor = new Editor(inputCsvPath);
```

## Edit CSV file

In order to open any DSV document for edit, user must use [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions) class, which single constructor has one mandatory parameter — string separator (delimiter), that should not be NULL or empty string. There are also several optional properties. Two properties — [ConvertDateTimeData](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions/convertdatetimedata) and [ConvertNumericData](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions/convertnumericdata) — are boolean flags, which indicate how to treat numbers. GroupDocs.Editor can recognize digits within cells and treat them as numbers or date-time values. By default this recognition is disabled, but user can turn it on. Next property — [TreatConsecutiveDelimitersAsOne](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions/treatconsecutivedelimitersasone), — is also a boolean flag, which determines how the consecutive delimiters should be treated — as several (default - false) or as a single one (true).

Last property — [OptimizeMemoryUsage](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions/optimizememoryusage), — is also a boolean flag, but with completely different purpose. By default GroupDocs.Editor algorithms are tuned for maximum performance for reducing the latency time; memory consumption has lower priority. However in some rare cases user may need to load and open very huge DSV, several hundreds of MiBs or even close to GiB. In such cases GroupDocs.Editor (.NET Framework in fact) may throw an OutOfMemoryException. For coping with such use-cases the [OptimizeMemoryUsage](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions/optimizememoryusage) flag was introduced. By enabling it user switches GroupDocs.Editor to use another processing algorithms, which consume relatively low amount of memory at the cost of lower performance.

Example below demonstrates using the [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions) for editing CSV document, where comma character is a delimiter:

```csharp
DelimitedTextEditOptions editOptions = new DelimitedTextEditOptions(",");
editOptions.ConvertDateTimeData = false;
editOptions.ConvertNumericData = true;
editOptions.TreatConsecutiveDelimitersAsOne = true;
editOptions.OptimizeMemoryUsage = true;

EditableDocument document = editor.Edit(editOptions);
```

## Save CSV file after editing

After being edited, input DSV can be saved back to DSV (not necessary with the same separator) or to any supportable Spreadsheet document. In order to save document to DSV format user must use the [DelimitedTextSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtextsaveoptions) class, which, like the [DelimitedTextEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtexteditoptions), has one constructor with mandatory string parameter — separator (delimiter), that should not be NULL or empty string.

There are also other properties:

1. [Encoding](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtextsaveoptions/encoding). Allows to specify the encoding of generated DSV. By default, if not specified, is UTF8.
2. [TrimLeadingBlankRowAndColumn](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtextsaveoptions/trimleadingblankrowandcolumn). Boolean flag, that indicates whether leading blank rows and columns should be trimmed like what MS Excel does.
3. [KeepSeparatorsForBlankRow](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/delimitedtextsaveoptions/keepseparatorsforblankrow). Boolean flag, that indicates whether separators should be output for blank row. Default value is false which means the content for blank row will be empty.

Example below demonstrates loading CSV, opening it to the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, and saving to TSV and XLSM.

```csharp
string inputCsvPath = "C://input/spreadsheet.csv";
Editor editor = new Editor(inputCsvPath);

DelimitedTextEditOptions editOptions = new DelimitedTextEditOptions(",");
EditableDocument document = editor.Edit(editOptions);

DelimitedTextSaveOptions tsvSaveOptions = new DelimitedTextSaveOptions("\t");
tsvSaveOptions.TrimLeadingBlankRowAndColumn = true;
tsvSaveOptions.KeepSeparatorsForBlankRow = false;

SpreadsheetSaveOptions xlsmSaveOptions = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsm);

string tsvSavePath = "C://output/spreadsheet.tsv";
string xlsmSavePath = "C://output/spreadsheet.xlsm";

editor.Save(document, tsvSavePath, tsvSaveOptions);
editor.Save(document, xlsmSavePath, xlsmSaveOptions);
```

In this example output "'spreadsheet.tsv" will have a UTF-8 encoding.

---

## How to Edit CSV File

Path: /editor/nodejs-java/how-to-edit-csv-file/


> This guide explains all necessary aspects and options regarding processing DSV spreadsheets (Delimiter-Separated Values) using GroupDocs.Editor for Node.js via Java.

## Introduction

DSV (Delimiter-Separated Values) documents are a specific form of text-based spreadsheets that use delimiters (separators) to separate values. Due to their nature, **GroupDocs.Editor** processes this class of documents separately from usual binary spreadsheets. Unlike typical spreadsheets, DSV documents have only a single tab (worksheet) and cannot be encoded. However, any non-empty string may be treated as a separator, so you always need to specify it explicitly.

The most common types of DSV are:

1. **CSV (Comma-Separated Values)**
2. **TSV (Tab-Separated Values)**
3. **Semicolon-Separated Values**
4. **Whitespace-Separated Values**
5. **...and any other delimiter**

GroupDocs.Editor supports DSV with any separator, which can be a character or a set of characters (string).

## Loading a CSV File for Editing

Unlike WordProcessing and Spreadsheet documents, DSV documents are loaded into the `Editor` class without any loading options. They are simple text files by their nature, so there is nothing to adjust:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Specify the input CSV file path
const inputCsvPath = "C://input//spreadsheet.csv";

// Create an instance of the Editor
const editor = new groupdocsEditor.Editor(inputCsvPath);
```

## Editing a CSV File

To open any DSV document for editing, you must use the `DelimitedTextEditOptions` class, whose constructor has one mandatory parameter—a string separator (delimiter) that should not be null or an empty string. There are also several optional properties:

1. **convertDateTimeData**: Boolean flag indicating whether to recognize date-time values within cells. By default, this recognition is disabled.
2. **convertNumericData**: Boolean flag indicating whether to recognize numeric values within cells. By default, this recognition is disabled.
3. **treatConsecutiveDelimitersAsOne**: Boolean flag that determines how consecutive delimiters should be treated—as several (default `false`) or as a single one (`true`).
4. **optimizeMemoryUsage**: Boolean flag with a completely different purpose. By default, GroupDocs.Editor algorithms are tuned for maximum performance to reduce latency time; memory consumption has a lower priority. However, in some rare cases, you may need to load and open a very large DSV file, several hundreds of MBs or even close to a GB. In such cases, GroupDocs.Editor (or Java, in fact) may throw an OutOfMemoryException. To cope with such use-cases, the `optimizeMemoryUsage` flag was introduced. By enabling it, you switch GroupDocs.Editor to use alternative processing algorithms, which consume relatively low amounts of memory at the cost of lower performance.

The example below demonstrates using the `DelimitedTextEditOptions` for editing a CSV document where the comma character is the delimiter:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Prepare DelimitedTextEditOptions
const editOptions = new groupdocsEditor.DelimitedTextEditOptions(",");
editOptions.setConvertDateTimeData(false);
editOptions.setConvertNumericData(true);
editOptions.setTreatConsecutiveDelimitersAsOne(true);
editOptions.setOptimizeMemoryUsage(true);

// Open the document for editing
const document = editor.edit(editOptions);
```

## Saving the Edited CSV File

After being edited, the input DSV can be saved back to DSV (not necessarily with the same separator) or to any supported Spreadsheet document. To save the document to DSV format, you must use the `DelimitedTextSaveOptions` class, which, like the `DelimitedTextEditOptions`, has a constructor with a mandatory string parameter—the separator (delimiter) that should not be null or an empty string.

There are also other properties:

1. **encoding**: Allows specifying the encoding of the generated DSV. By default, if not specified, it is UTF-8.
2. **trimLeadingBlankRowAndColumn**: Boolean flag that indicates whether leading blank rows and columns should be trimmed, similar to what MS Excel does.
3. **keepSeparatorsForBlankRow**: Boolean flag that indicates whether separators should be output for a blank row. The default value is `false`, which means the content for a blank row will be empty.

The example below demonstrates loading a CSV file, opening it into an `EditableDocument` instance, and saving it to TSV and XLSM formats:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Specify the input CSV file path
const inputCsvPath = "C://input//spreadsheet.csv";

// Create an instance of the Editor
const editor = new groupdocsEditor.Editor(inputCsvPath);

// Prepare DelimitedTextEditOptions
const editOptions = new groupdocsEditor.DelimitedTextEditOptions(",");
const document = editor.edit(editOptions);

// Prepare DelimitedTextSaveOptions for TSV
const tsvSaveOptions = new groupdocsEditor.DelimitedTextSaveOptions("\t");
tsvSaveOptions.setTrimLeadingBlankRowAndColumn(true);
tsvSaveOptions.setKeepSeparatorsForBlankRow(false);

// Prepare SpreadsheetSaveOptions for XLSM
const xlsmSaveOptions = new groupdocsEditor.SpreadsheetSaveOptions(groupdocsEditor.SpreadsheetFormats.Xlsm);

// Specify output paths
const tsvSavePath = "C://output//spreadsheet.tsv";
const xlsmSavePath = "C://output//spreadsheet.xlsm";

// Save the document as TSV
editor.save(document, tsvSavePath, tsvSaveOptions);

// Save the document as XLSM
editor.save(document, xlsmSavePath, xlsmSaveOptions);
```

In this example, the output file `'spreadsheet.tsv'` will have UTF-8 encoding.

---

By following this guide, you can effectively edit CSV and other DSV files using GroupDocs.Editor for Node.js via Java, customizing the editing process according to your specific needs.

> **Note:** Be sure to replace the paths in the code examples with the actual paths on your system.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Convert images

Path: /conversion/java/convert/image/


## About image file formats

An image file format is a standard method for organizing and storing images on devices like computers, tablets, and smartphones. Digital images store image data in a 2-dimensional grid of pixels where each pixel is a representation of color in terms of a number of bits. Image file types are classified into vector image formats and raster image formats. 3D Images are another type of vector image file format that is used for managing 3D images.

### Raster formats

**Raster Graphics** are digital images that comprise pixels data for the representation of colors. These are the most common image types for graphics used for the web as well as digital photos. Some of the raster images can be compressed to reduce image file size. Common raster image file extensions and their file formats include **BMP** (Bitmap image file), **PNG** (Portable Network Graphics), and **GIF** (Graphics Interchange File).

### Vector formats

**Vector images** are defined by 2D points, instead of pixels, which are connected to give a geometric shape to the image. The points have properties that define the direction of paths, color, shape, curve, thickness, and fill. Common vector image file extensions and their file formats include **SVG** (Scalable Vector Graphics), **EPS** (Encapsulated PostScript language), and **PDF** (Portable Document Format).

## Supported image file conversions

{{< include file="/conversion/java/_includes/supported-conversions/image.md" type="page" >}}

## Convert image to PDF

Converting an image into a PDF file is a common use case for example when you need to create a PDF document from a scanned paper. [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) allows resolving this task easily and intuitively just using a few lines of Java code as described below:

1. Create an instance of the `Converter` class and pass the source JPG file path as a constructor parameter. You may specify absolute or relative file paths as per your requirements.
2. Create an instance of the `PdfConvertOptions` class.
3. Call the `convert` method and pass the filename for the converted PDF file and the `PdfConvertOptions` object from the previous step as parameters.

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source JPG file
Converter converter = new Converter("sample.jpg");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

NOTE: The code example above is the same for other image formats into PDF conversion, the only difference - you have to provide the file name with the appropriate extension.

## Convert image to Excel

If you need to get data from your previous tax returns into Excel and you only have printed copies just take a picture of each one and convert these images into XLS/XLSX workbook.

### Convert JPG to XLSX

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;
...
// Load the source JPG file
Converter converter = new Converter("sample.jpg");
SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
// Save converted XLS file
converter.convert("jpg-converted-to.xlsx", options);
```

### Convert PNG to XLSX

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.SpreadsheetConvertOptions;
...
// Load the source PNG  file
Converter converter = new Converter("sample.png");
SpreadsheetConvertOptions options = new SpreadsheetConvertOptions();
// Save converted XLS file
converter.convert("png-converted-to.xlsx", options);
```

## Convert image to PowerPoint presentation

If you need to make a PowerPoint presentation from images of **PNG**, **JPG/JPEG**, **TIF/TIFF**, **GIF**, or other formats, a possible solution is to convert them programmatically.  
Let’s review several code examples in Java language below and see how to transform an image into a PPT/PPTX presentation.

### Convert JPG to PPTX

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PresentationConvertOptions;
...
// Load the source JPG file
Converter converter = new Converter("sample.jpg");
PresentationConvertOptions options = new PresentationConvertOptions();
// Save converted PPT file  
converter.convert("jpg-converted-to.pptx", options);
```

### Convert PNG to PPTX

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PresentationConvertOptions;
...
// Load the source PNG file
Converter converter = new Converter("sample.png");
PresentationConvertOptions options = new PresentationConvertOptions();
// Save converted PPT file
converter.convert("png-converted-to.pptx", options);
```

## Convert image to Microsoft Word document

To easily transform images into Microsoft Word documents programmatically, please check the following code snippet in Java:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WordProcessingConvertOptions;
...
// Load the source JPG file
Converter converter = new Converter("sample.jpg");
WordProcessingConvertOptions options = new WordProcessingConvertOptions();
// Save converted DOCX file
converter.convert("jpg-converted-to.docx", options);
```

---

## Convert images

Path: /conversion/net/convert/image/


## About image file formats

An image file format is a standard method for organizing and storing images on devices like computers, tablets, and smartphones. Digital images store image data in a 2-dimensional grid of pixels where each pixel is a representation of color in terms of a number of bits. Image file types are classified into vector image formats and raster image formats. 3D Images are another type of vector image file format that is used for managing 3D images.

### Raster formats

**Raster Graphics** are digital images that comprise pixels data for the representation of colors. These are the most common image types for graphics used for the web as well as digital photos. Some of the raster images can be compressed to reduce image file size. Common raster image file extensions and their file formats include **BMP** (Bitmap image file), **PNG** (Portable Network Graphics), and **GIF** (Graphics Interchange File).

### Vector formats

**Vector images** are defined by 2D points, instead of pixels, which are connected to give a geometric shape to the image. The points have properties that define the direction of paths, color, shape, curve, thickness, and fill. Common vector image file extensions and their file formats include **SVG** (Scalable Vector Graphics), **EPS** (Encapsulated PostScript language), and **PDF** (Portable Document Format).

## Supported image file conversions

{{< include file="/conversion/net/_includes/supported-conversions/image.md" type="page" >}}

## Convert image to PDF

Converting an image into a PDF file is a common use case for example when you need to create a PDF document from a scanned paper. [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) allows resolving this task easily and intuitively just using a few lines of C# code as described below:

1. Create an instance of the `Converter` class and pass the source JPG file path as a constructor parameter. You may specify absolute or relative file paths as per your requirements.
2. Create an instance of the `PdfConvertOptions` class.
3. Call the `Convert` method and pass the filename for the converted PDF file and the `PdfConvertOptions` object from the previous step as parameters.

```csharp
// Load the source JPG file
using (var converter = new GroupDocs.Conversion.Converter("sample.jpg"))
{
    // Set the convert options for PDF format
    var options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.jpg")
    .ConvertTo("converted.pdf")
    .Convert();
```

NOTE: The code example above is the same for other image formats into PDF conversion, the only difference - you have to provide the file name with the appropriate extension.

## Convert image to Excel

If you need to get data from your previous tax returns into Excel and you only have printed copies just take a picture of each one and convert these images into XLS/XLSX workbook.

### Convert JPG to XLS

```csharp
// Load the source JPG file
using (var converter = new GroupDocs.Conversion.Converter("sample.jpg"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions { Format = GroupDocs.Conversion.FileTypes.SpreadsheetFileType.Xls };
    // Save converted XLS file
    converter.Convert("jpg-converted-to.xls", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.jpg")
    .ConvertTo("jpg-converted-to.xls")
    .WithOptions(new SpreadsheetConvertOptions { Format = GroupDocs.Conversion.FileTypes.SpreadsheetFileType.Xls })
    .Convert();
```

### Convert PNG to XLS

```csharp
// Load the source PNG file
using (var converter = new GroupDocs.Conversion.Converter("sample.png"))
{
    SpreadsheetConvertOptions options = new SpreadsheetConvertOptions { Format = GroupDocs.Conversion.FileTypes.SpreadsheetFileType.Xls };
    // Save converted XLS file
    converter.Convert("png-converted-to.xls", options);
}
```

You can choose from a variety of spreadsheet formats using the [SpreadsheetFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/spreadsheetfiletype) class, including XLS, XLSX, ODS, and others.

## Convert image to PowerPoint presentation

If you need to make a PowerPoint presentation from images of **PNG**, **JPG/JPEG**, **TIF/TIFF**, **GIF**, or other formats, a possible solution is to convert them programmatically.  
Let’s review several code examples in C# language below and see how to transform an image into a PPT/PPTX presentation.

### Convert JPG to PPT

```csharp
// Load the source JPG file
using (var converter = new GroupDocs.Conversion.Converter("sample.jpg"))
{
    PresentationConvertOptions options = new PresentationConvertOptions { Format = GroupDocs.Conversion.FileTypes.PresentationFileType.Ppt };
    // Save converted PPT file
    converter.Convert("jpg-converted-to.ppt", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.jpg")
    .ConvertTo("jpg-converted-to.ppt")
    .WithOptions(new PresentationConvertOptions { Format = GroupDocs.Conversion.FileTypes.PresentationFileType.Ppt })
    .Convert();
```

### Convert PNG to PPT

```csharp
// Load the source PNG file
using (var converter = new GroupDocs.Conversion.Converter("sample.png"))
{
    PresentationConvertOptions options = new PresentationConvertOptions { Format = GroupDocs.Conversion.FileTypes.PresentationFileType.Ppt };
    // Save converted PPT file
    converter.Convert("png-converted-to.ppt", options);
}
```

You can choose from a variety of presentation formats using the [PresentationFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/presentationfiletype) class, including PPT, PPTX, ODP, and others.

## Convert image to Microsoft Word document

To easily transform images into Microsoft Word documents programmatically, please check the following code snippet in C#:

```csharp
// Load the source JPG file
using (var converter = new GroupDocs.Conversion.Converter("sample.jpg"))
{
    var options = new WordProcessingConvertOptions();
    // Save converted DOCX file
    converter.Convert("jpg-converted-to.docx", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.jpg")
    .ConvertTo("jpg-converted-to.docx")
    .Convert();
```

## Convert between image formats

Converting between different image formats is a common requirement. For example, you may need to convert PNG to JPG for smaller file sizes, or convert to TIFF for archival purposes.

### Convert PNG to JPG

```csharp
// Load the source PNG file
using (var converter = new GroupDocs.Conversion.Converter("sample.png"))
{
    var options = new ImageConvertOptions
    {
        Format = GroupDocs.Conversion.FileTypes.ImageFileType.Jpg
    };
    // Save converted JPG file
    converter.Convert("png-converted-to.jpg", options);
}
```

or using [fluent syntax]({{< ref "conversion/net/developer-guide/basic-usage/fluent-syntax.md" >}})

```csharp
FluentConverter
    .Load("sample.png")
    .ConvertTo("png-converted-to.jpg")
    .WithOptions(new ImageConvertOptions
    {
        Format = GroupDocs.Conversion.FileTypes.ImageFileType.Jpg
    })
    .Convert();
```

### Convert JPG to PNG

```csharp
// Load the source JPG file
using (var converter = new GroupDocs.Conversion.Converter("sample.jpg"))
{
    var options = new ImageConvertOptions
    {
        Format = GroupDocs.Conversion.FileTypes.ImageFileType.Png
    };
    // Save converted PNG file
    converter.Convert("jpg-converted-to.png", options);
}
```

### Convert image to TIFF

TIFF (Tagged Image File Format) is widely used for storing high-quality images. You can convert any supported image format to TIFF:

```csharp
// Load the source image file
using (var converter = new GroupDocs.Conversion.Converter("sample.jpg"))
{
    var options = new ImageConvertOptions
    {
        Format = GroupDocs.Conversion.FileTypes.ImageFileType.Tiff
    };
    // Save converted TIFF file
    converter.Convert("converted.tiff", options);
}
```

You can choose from a wide range of supported image formats using the [ImageFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/imagefiletype) class, including: BMP, GIF, ICO, JP2, JPEG, PNG, PSD, SVG, TIFF, WEBP, and many others.

For advanced image conversion options like setting image quality, resolution, and other parameters, refer to the [Convert to image with advanced options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-image-with-advanced-options.md" >}}) article.

---

## Convert images

Path: /conversion/nodejs-java/convert/image/


## About image file formats

An image file format is a standard method for organizing and storing images on devices like computers, tablets, and smartphones. Digital images store image data in a 2-dimensional grid of pixels where each pixel is a representation of color in terms of a number of bits. Image file types are classified into vector image formats and raster image formats. 3D Images are another type of vector image file format that is used for managing 3D images.

### Raster formats

**Raster Graphics** are digital images that comprise pixels data for the representation of colors. These are the most common image types for graphics used for the web as well as digital photos. Some of the raster images can be compressed to reduce image file size. Common raster image file extensions and their file formats include **BMP** (Bitmap image file), **PNG** (Portable Network Graphics), and **GIF** (Graphics Interchange File).

### Vector formats

**Vector images** are defined by 2D points, instead of pixels, which are connected to give a geometric shape to the image. The points have properties that define the direction of paths, color, shape, curve, thickness, and fill. Common vector image file extensions and their file formats include **SVG** (Scalable Vector Graphics), **EPS** (Encapsulated PostScript language), and **PDF** (Portable Document Format).

## Supported image file conversions

{{< include file="/conversion/nodejs-java/_includes/supported-conversions/image.md" type="page" >}}

## Convert image to PDF

Converting an image into a PDF file is a common use case for example when you need to create a PDF document from a scanned paper. [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) allows resolving this task easily and intuitively just using a few lines of JavaScript code as described below:

1. Create an instance of the `Converter` class and pass the source JPG file path as a constructor parameter. You may specify absolute or relative file paths as per your requirements.
2. Create an instance of the `PdfConvertOptions` class.
3. Call the `convert` method and pass the filename for the converted PDF file and the `PdfConvertOptions` object from the previous step as parameters.

```js
// Load the source JPG file
const converter = new groupdocs.conversion.Converter("sample.jpg");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

NOTE: The code example above is the same for other image formats into PDF conversion, the only difference - you have to provide the file name with the appropriate extension.

## Convert image to Excel

If you need to get data from your previous tax returns into Excel and you only have printed copies just take a picture of each one and convert these images into XLS/XLSX workbook.

### Convert JPG to XLSX

```js
// Load the source JPG file
const converter = new groupdocs.conversion.Converter("sample.jpg");
const options = new groupdocs.conversion.SpreadsheetConvertOptions();
// Save converted XLS file
converter.convert("jpg-converted-to.xlsx", options);
```

### Convert PNG to XLSX

```js
// Load the source PNG  file
const converter = new groupdocs.conversion.Converter("sample.png");
const options = new groupdocs.conversion.SpreadsheetConvertOptions();
// Save converted XLS file
converter.convert("png-converted-to.xlsx", options);
```

## Convert image to PowerPoint presentation

If you need to make a PowerPoint presentation from images of **PNG**, **JPG/JPEG**, **TIF/TIFF**, **GIF**, or other formats, a possible solution is to convert them programmatically.  
Let’s review several code examples in JavaScript language below and see how to transform an image into a PPT/PPTX presentation.

### Convert JPG to PPTX

```js
// Load the source JPG file
const converter = new groupdocs.conversion.Converter("sample.jpg");
const options = new groupdocs.conversion.PresentationConvertOptions();
// Save converted PPT file  
converter.convert("jpg-converted-to.pptx", options);
```

### Convert PNG to PPTX

```js
// Load the source PNG file
const converter = new groupdocs.conversion.Converter("sample.jpg");
const options = new groupdocs.conversion.PresentationConvertOptions();
// Save converted PPT file
converter.convert("png-converted-to.pptx", options);
```

## Convert image to Microsoft Word document

To easily transform images into Microsoft Word documents programmatically, please check the following code snippet in JavaScript:

```js
// Load the source JPG file
const converter = new groupdocs.conversion.Converter("sample.jpg");
const options = new groupdocs.conversion.WordProcessingConvertOptions();
// Save converted DOCX file
converter.convert("jpg-converted-to.docx", options);
```

---

## Merge audio

Path: /merger/net/merge/audio/


## How to merge audio files in C\#

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) facilitates developers to combine multiple audio files according to their preferred sequence and save them as a single audio file. This eliminates the need for manual operations with desktop software, saving you valuable time. Currently, GroupDocs.Merger allows combining audio files having the same extensions. For example, WAV file with other WAV files, or MP3 file with other MP3 files.

Here's a C# code snippet demonstrating how to concatenate audio files:

* Create an instance of the [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass the source audio file path as a constructor parameter. You may specify absolute or relative file paths as per your requirements.
* Add another audio file to merge with the [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Audio file should be of the same format as the initial one. Repeat this step for other audio files you want to merge.
* Call the [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the resulting audio file as a parameter.

```csharp
// Load the source WAV file
using (var merger = new GroupDocs.Merger.Merger(@"c:\sample1.wav"))
{
    // Add another WAV file to merge
    merger.Join(@"c:\sample2.wav");
    // Merge audio files and save result
    merger.Save(@"c:\merged.wav");
}
```

### Merging Different Audio File Formats

This section describes how to combine miscellaneous audio file formats using GroupDocs.Merger API. Please look at the articles listed below:

* [How to merge WAV files in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-wav-files-using-csharp.md" >}})
* [How to merge MP3 files in C\#]({{< ref "merger/net/getting-started/use-cases/how-to-merge-mp3-files-using-csharp.md" >}})

### Code Examples

Please visit [Showcases]({{< ref "merger/net/showcases.md" >}}) to learn and try our free backend and frontend examples and use-cases!

### Live Demos

GroupDocs.Merger for .NET offers the following free online tools to test its quality and accuracy:
* [**WAV Merger App**](https://products.groupdocs.app/merger/wav)
* [**MP3 Merger App**](https://products.groupdocs.app/merger/mp3)
---

## Merge PowerPoint Presentations

Path: /merger/net/merge/powerpoint/


You must be familiar with **PPTX** and **PPT** extension files, these are Presentation file formats that store collection of records to accommodate presentation data such as: slides, shapes, text, animations, video, audio and embedded objects. A presentation can be saved/converted into other file formats as well such as PDF, BMP, PNG, JPEG, and XPS.

Common Presentation file extensions and their associated file formats include **PPTX**, **PPT**, **PPSX** and **PPS**.

## How to merge PPSX presentations

PPSX, Power Point Slide Show, file are created using Microsoft PowerPoint 2007 and above for Slide Show purpose. It is an update to the PPS file format that was supported by Microsoft PowerPoint 97-2003 versions. When a PPSX file is shared with another user and opened, it starts as PowerPoint show unlike PPTX file that opens in editable mode. The sequence of slide show is the same as in the original presentation. All the slides accompany the images, sounds and other embedded media accompany the presentation slides to the PPSX during the slideshow.

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source PPSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another PPSX file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other PPSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged PPSX file as parameter.

```csharp
// Load the source PPSX file
using (Merger merger = new Merger(@"c:\sample1.ppsx"))
{
    // Add another PPSX file to merge
    merger.Join(@"c:\sample2.ppsx");
    // Merge PPSX files and save result
    merger.Save(@"c:\merged.ppsx");
}
```

NOTE: You may merge other Presentation formats like PPTX, PPT and PPS in the same way as shown above. For this provide files by specifying their names with extension.

## How to merge PPTX streams

Please read the following article: [How to correctly merge PPTX streams]({{< ref "merger/net/getting-started/use-cases/how-to-correctly-merge-documents-using-csharp.md" >}})

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge PowerPoint Live Demo

GroupDocs.Merger for .NET provides an online [**PowerPoint Merger App**](https://products.groupdocs.app/merger/powerpoint), which allows you to try it for free and check its quality and accuracy.

---

## Set Checkbox Values Dynamically

Path: /assembly/net/set-checkbox-values-dynamically/

{{< alert style="info" >}}This feature is supported by version 20.3 or greater.{{< /alert >}}{{< alert style="info" >}}The code uses some of the objects defined in [The Business Layer](https://docs.groupdocs.com/assembly/net/the-business-layer/).{{< /alert >}}

You can set checkbox values to either checked or unchecked in your reports dynamically by taking the following steps:

1.  Add a checkbox content control to your template at a place where you want it to appear in a result document.
2.  By editing content control properties, add a check tag to the title of the checkbox content control using the following syntax.

```csharp
<<check [conditional_expression]>>
```

The code will look like following snippet:

{{< gist GroupDocsGists b06d6c5655c84fc772c6411d66016943 SetCheckboxValueDynamicallyInWord_20.3.cs >}}

Here, conditional\_expression defines a condition upon which the value of the checkbox content control is to be set to checked (or unchecked, if the condition is not met). The conditional expression must return a Boolean value.

While building a report, a conditional expression declared within a check tag is evaluated and the value of its containing checkbox content control is set accordingly. The check tag itself is removed then.

{{< alert style="warning" >}}Dynamic checkbox value setting is available for Word Processing documents only.{{< /alert >}}

---

## How to edit XML file

Path: /editor/java/how-to-edit-xml/

> This example demonstrates the opening, editing and saving the XML documents, using different options and adjustments.

## Introduction

com.groupdocs.editor has supported importing the documents in [XML (eXtensible Markup Language)](https://docs.fileformat.com/web/xml/) format for a long time. However, in [version 23.5](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-5-release-notes/) the XML processing mechanism was completely redeveloped and drastically enhanced, XML editing public options were also redesigned and significantly expanded, with new sub-option classes and new public types.

Current article describes this new XML processing mechanism and is applicable to the GroupDocs.Editor [version 23.5](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-5-release-notes/) and above.

## Loading XML documents

Loading of the XML documents to the `com.groupdocs.`[`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/) class is usual and the same as for other formats. There are no dedicated load options for the XML format, it is enough to specify the file itself through file path or [ByteArrayInputStream](https://docs.oracle.com/javase/8/docs/api/java/io/ByteArrayInputStream.html).

If loading through file path, the file extension does not matter, so you may freely load an XML file not only with the `*.xml`, but with any other extension like `*.csproj`, `*.svg` or any other extension - only valid internal structure matters.

Also please note that you cannot treat HTML files like XML — only [XHTML](https://en.wikipedia.org/wiki/XHTML) can be treated like valid XML.

Code example below shows loading of the same document by two approaches into the two different [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/) instances:

```java
	String inputFilePath = Constants.SAMPLE_XML;
	final FileInputStream xmlStream = new FileInputStream(inputFilePath) ;
	Editor editorFromPath = new Editor(inputFilePath);
	try 
	{//from the path
		Editor editorFromStream = new Editor(new FileInputStream(inputFilePath));
		try /*JAVA: was using*///from the stream
		{
			//Here two Editor instances can separately work with one file
		}
		finally {
			(editorFromStream).dispose();
		}
	}
	finally {
		(editorFromPath).dispose();
	}
```

## Editing XML documents

Like for other format families in GroupDocs.Editor, there is a special [`XmlEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/) class for editing the XML documents. As always, it is not mandatory when editing a document, so the [`Editor.edit()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#edit--) overload without parameter may be used — GroupDocs.Editor will automatically detect the format and apply the default options. The example below shows such a case: XML document is loaded, edited, and then the edited content, represented with a [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) class, may be passed to the WYSIWYG-editor or any other HTML editing software, or simply saved to the disk, as it is shown in the example.

```java
	String xmlInputPath = Constants.SAMPLE_XML;
	String outputPath = Constants.getOutputFilePath(Constants.removeExtension(Path.getFileName(xmlInputPath)), "html");

	Editor editor = new Editor(xmlInputPath);
	try /*JAVA: was using*/
	{
		final EditableDocument edited = editor.edit();
		try /*JAVA: was using*/
		{
			//Send to WYSIWYG-editor or somewhere else
			edited.save(outputPath);
		}
		finally {
			(edited).dispose();
		}
	}
	finally {
		(editor).dispose();
	}
```

[`XmlEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/) class has different properties, some of them are grouped into “wrappers” — special classes [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/) and [`XmlFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/), which are described below in detail. The most useful and important properties, however, are directly inside the [`XmlEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/) class.

#### Encoding

[`java.nio.charset.Charset`](https://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html) [`getEncoding()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getEncoding--) 

This property allows to set the encoding, which will be applied while opening an input XML file (keep in mind that any XML is first of all a text file). By default all XML files are UTF8, so the default value of this option is also UTF8.

#### FixIncorrectStructure

[`boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) [`getFixIncorrectStructure()](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getFixIncorrectStructure--)

GroupDocs.Editor can handle without error or exception any XML document: corrupted, truncated, with invalid structure, it can even treat HTML like XML. However, the representation of such a document may degrade in such cases — for example, it is impossible to properly display the nested hierarchical structure, if it is broken.

In order to fix this, the [`getFixIncorrectStructure()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getFixIncorrectStructure--) boolean flag is introduced. If enabled, the GroupDocs.Editor scans the XML document and tries to fix its structure. In particular, it escapes some prohibited characters, properly closes unclosed tags, opens unopened tags, fixes overlapping tags, and so on.

Because such document scanning and fixing requires additional computational resources and in general most of XML documents are valid, this mechanism is disabled by default: [`getFixIncorrectStructure()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getFixIncorrectStructure--) has a `false` value. So for enabling it, you must set the `true` value manually.

#### RecognizeUris

[`boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) [`getRecognizeUris()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getRecognizeUris--)

This property enables the mechanism of recognizing and preparing the URIs (web address). By default this mechanism is disabled (`false`) and URIs, if they are present in the text nodes or attribute values inside the XML documents, are represented as an ordinary text. When this property is enabled (`true`), the GroupDocs.Editor scans the XML document for any valid URIs, and if found, represents them as external links in the resultant HTML format: by using the A element. GroupDocs.Editor is searching for URIs in: text nodes, CDATA sections, XML comments, attribute values, DocType definitions.

#### RecognizeEmails

[`boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) [`getRecognizeEmails()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getRecognizeEmails--)

This property is very similar to the [`getRecognizeUris()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getRecognizeUris--): it does the same, but at this time for email addresses. By default it is disabled, so if the email address is present in the input XML, the output HTML will contain it as ordinary text. However, if enabled by setting `true`, all valid email addresses will be represented with [mailto](https://en.wikipedia.org/wiki/Mailto) scheme and A element.

Unlike the [`getRecognizeUris()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getRecognizeUris--) property, the [`getRecognizeEmails()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getRecognizeEmails--), if enabled, is working only for attribute values.

#### TrimTrailingWhitespaces

[`boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) [`getTrimTrailingWhitespaces()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getTrimTrailingWhitespaces--)

This property enables the truncation of trailing whitespaces in the text nodes — the textual content, located between start and end tags (inner-tag text). By default is disabled (`false`) — trailing whitespaces will be preserved. Line breaks are also treated as whitespaces. May be useful when input XML is formed with line breaks and empty spans for the sake of readability.

#### AttributeValuesQuoteType

[`QuoteType`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.serialization/quotetype/) [`getAttributeValuesQuoteType()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getAttributeValuesQuoteType--)

[`QuoteType`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.serialization/quotetype/) is a new type, introduced in the [version 23.5](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-5-release-notes/) — it is a struct, that represents two types of quotes, permissible in the XML format in attribute values: a *single quote*, represented by the `U+0027 APOSTROPHE` character, and a *double quote*, represented by the `U+0022 QUOTATION MARK` character.

With this option users can redefine the quote type, used in the original XML document, and set the desired quote, which should be present in the resultant HTML. By default the double quotes are used.

Next and last two properties, — [`getHighlightOptions()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getHighlightOptions--) and [`getFormatOptions()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getFormatOptions--), — have compound values, described below. What is important, that users cannot create instances of wrapping classes [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/) and [`XmlFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/) and set the values of [`getHighlightOptions()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getHighlightOptions--) and [`getFormatOptions()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getFormatOptions--) (including setting them to null). It is intended that only members of [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/) and [`XmlFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/) have to be changed from the default values.

### HighlightOptions

The [`getHighlightOptions()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getHighlightOptions--) property has a type of [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/). An already created instance of `XmlHighlightOptions` is already set in the `setHighlightOptions()` property and a reference to it cannot be modified; only members of `XmlHighlightOptions` are allowed to modify.

XmlHighlightOptions has 6 sub-properties:

1. [`getXmlTagsFontSettings()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#getXmlTagsFontSettings--) is responsible for representing the font of XML tags, this include both start and end tags, angle brackets with tag names. By default it is a “`Calibri`” font, `12pt` size.
2. [`getAttributeNamesFontSettings()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#getAttributeNamesFontSettings--) is responsible for representing the font of attribute names. By default is a “`Calibri`” font, `11pt` size, `red` color.
3. [`getAttributeValuesFontSettings()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#getAttributeValuesFontSettings--) is responsible for representing the font of attribute values. By default is a “`Calibri`” font, `11pt` size, `blue` color.
4. [`getInnerTextFontSettings()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#getInnerTextFontSettings--) is responsible for representing the font of text nodes (text inside and between XML elements). By default is a "`Times New Roman`" font, `11pt` size, `black` color.
5. [`getHtmlCommentsFontSettings()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#getHtmlCommentsFontSettings--) is responsible for representing the font of HTML comments (XML comments with a syntax of HTML comments), including a pair of opening `<!--` and closing `-–>` tags. By default is a "`Consolas`" font, `11pt` size, `green` color.
6. [`getCDataFontSettings()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#getCDataFontSettings--) is responsible for representing the font of CDATA sections, including a pair of opening `<![CDATA[` and closing `]]>` tags. By default is a "`Calibri`" font, `11pt` size, `coral` color.

All these properties are of a [`WebFont`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/webfont/) class — a new public type, introduced in the [version 23.5](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-5-release-notes/). It has 6 public properties, one of them is of [`String`](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html) type, while 5 others are structs, each of which holds and represents some aspect of the font. [`WebFont`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/webfont/) class may be treated as a container for the font properties, where by default every property has some default value, and users can change some or every of them in defined limits.

1. Font name — [`getName()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/webfont/#getName--) property of a [`String`](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html) type. Is translated into the `font-family` CSS declaration.
2. Font size — [`getSize()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/webfont/#getSize--) property of [`FontSize`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.css.properties/fontsize/) type. Is translated into the `font-size` CSS declaration.
3. Font color — [`getColor()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/webfont/#getColor--) property of [`ArgbColor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.css.datatypes/argbcolor/) type. Is translated into the `color` CSS declaration.
4. Font weight (boldness) — [`getWeight()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/webfont/#getWeight--) property of [`FontWeight`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.css.properties/fontweight/) type. Is translated into the `font-weight` CSS declaration.
5. Font style — [`getStyle()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/#getStyle--) property of [`FontStyle`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.css.properties/fontstyle/) type. Is translated into the `font-style` CSS declaration.
6. Text decoration line — [`getLine()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/#getLine--) property of [`WebFont.TextDecorationLine`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/webfont.textdecorationline/) enum type. Is translated into the `text-decoration-line` CSS declaration.


[`XmlHighlightOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/) also has two useful public members:

- [`isDefault()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#isdefault--) [boolean](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) property, that indicates whether the current instance has a default value, which means that all properties are in their initial state.
- [`resetToDefault()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/#resettodefault--) method, that resets all properties to their initial values

Code sample below shows a creation of the [`XmlEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/) instance and setting different (but not all) properties within the [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/) sub-property.

```java
	XmlEditOptions editOptions = new XmlEditOptions();
	Assert.assertTrue(editOptions.getHighlightOptions().isDefault());
	XmlHighlightOptions highlightOptions = editOptions.getHighlightOptions();

	//Setting XML tags font settings
	highlightOptions.getXmlTagsFontSettings().setSize(FontSize.Large);
	highlightOptions.getXmlTagsFontSettings().setColor(ArgbColor.KnownColors.CssLevel1.Olive);

	//Setting attribute names font settings
	highlightOptions.getAttributeNamesFontSettings().setName("Arial");
	highlightOptions.getAttributeNamesFontSettings().setLine(WebFont.TextDecorationLine.Underline);
	highlightOptions.getAttributeNamesFontSettings().setWeight(FontWeight.Lighter);

	//Setting attribute values font settings
	highlightOptions.getAttributeValuesFontSettings().setLine((byte) (WebFont.TextDecorationLine.Underline + WebFont.TextDecorationLine.Overline));
	highlightOptions.getAttributeValuesFontSettings().setStyle(FontStyle.Italic);

	//Setting CDATA sections font settings
	highlightOptions.getCDataFontSettings().setLine(WebFont.TextDecorationLine.LineThrough);
	highlightOptions.getCDataFontSettings().setSize(FontSize.Smaller);

	//Setting HTML comments font settings
	highlightOptions.getHtmlCommentsFontSettings().setColor(ArgbColor.KnownColors.CssLevel3.Lightgreen);
	highlightOptions.getHtmlCommentsFontSettings().setName("Courier New");

	//Setting text node font settings
	highlightOptions.getInnerTextFontSettings().setWeight(FontWeight.fromNumber(300));
	highlightOptions.getInnerTextFontSettings().setSize(FontSize.XSmall);

	//Checking they are not default
	Assert.assertFalse(editOptions.getHighlightOptions().isDefault());

	//Resetting to default
	highlightOptions.resetToDefault();

	//Checking they are default again now
	Assert.assertTrue(editOptions.getHighlightOptions().isDefault());
```

### FormatOptions

The [`getFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/#getFormatOptions--) property has a type of [`XmlFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/). Like with `getHighlightOptions()` property, the `getFormatOptions()` property has already set an instance of the `XmlFormatOptions` class with all sub-properties having their default values. Similarly, a reference to this `XmlFormatOptions` instance cannot be modified, but only obtained through the getter, and no new instance of `XmlFormatOptions` can be created.

[`XmlFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/) class has only three sub-properties:

1. [`boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) [`getEachAttributeFromNewline()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/#getEachAttributeFromNewline--). XML documents usually have the XML elements with a set of attribute-value pairs. By default these pairs are represented in the resultant HTML in a single line next to the element name (`false` value). However, when setting this property to `true`, each and every pair of attribute-value in every XML element will be placed on a new separate line in the resultant HTML.
2. [`boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) [`getLeafTextNodesOnNewline()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/#getLeafTextNodesOnNewline--). XML documents usually have the text nodes — pieces of textual content, located inside and/or between adjacent XML elements. By default these text nodes are represented in the resultant HTML along with other XML nodes, in the same line with them (`false` value). However, when setting this property to `true`, each text node will be placed on a new line with a bigger left indent.
3. [`com.groupdocs.editor.htmlcss.css.datatypes.Length`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.css.datatypes/length/) [`getLeftIndent()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/#getLeftIndent--). XML is a hierarchical structure, and most of WYSIWYG-editors display hierarchical structures using left indentation: the deeper node is located inside the tree (bigger nesting level) — the bigger left indent is. GroupDocs.Editor does the same, and the [`getLeftIndent()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/#getLeftIndent--) property regulates how big is a left indent distance for a one level. By default it is 10 points (`pt`). So the root element will have no indent at all, 1st nesting level will be `10pt` shifted, 2nd level — `20pt`, 3rd level — `30pt`, and so on. This length is represented by a public type [`com.groupdocs.editor.htmlcss.css.datatypes.Length`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.css.datatypes/length/) and can be easily changed to desired. What is more, it can be specified not necessarily in points, but in any CSS-compatible length unit, like percent, pixel, centimeter, and so on. Left indent can be disabled at all by setting a unitless zero to this property like this: [`Length.UnitlessZero`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.css.datatypes/length/#UnitlessZero). But keep in mind that non-zero unitless values are prohibited according to the CSS specification, and GroupDocs.Editor prohibits such values too.

Like in [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlhighlightoptions/), the [`XmlFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/) has a useful `boolean` property [`isDefault()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/isdefault), that indicates whether the current instance has all properties to be set to their initial values.

Code sample below shows a creation of the [`XmlEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/) instance and setting different properties within the [`XmlFormatOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmlformatoptions/) sub-property.

```java
	XmlEditOptions editOptions = new XmlEditOptions();

	//Checking that options are default for now
	Assert.assertTrue(editOptions.getFormatOptions().isDefault());
	XmlFormatOptions formatOptions = editOptions.getFormatOptions();

	//Each attribute-value pair must be placed on a new line
	formatOptions.setEachAttributeFromNewline(true);

	//Text nodes (textual content between and inside XML elements) must be placed on a new line
	formatOptions.setLeafTextNodesOnNewline(true);

	//Setting a custom text indent using 'Length' data type, which is composed from value with unit
	formatOptions.setLeftIndent(Length.fromValueWithUnit(20, Length.Unit.Px));

	//Checking that options are not default now
	Assert.assertFalse(editOptions.getFormatOptions().isDefault());

	//Disabling a left indent at all
	formatOptions.setLeftIndent(Length.UnitlessZero);
```

## Complex example

Now, when the [`XmlEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/) class with all its properties and sub-properties is described in detail, it's time to bring it together. Code example below shows opening a XML file from file path, creating and adjusting two different [`XmlEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/xmleditoptions/) instances, and editing a document twice with these two different option classes to obtain two different [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) representations. Then these [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) are saved to the two different HTML files.

```java
	String xmlInputPath = Constants.SAMPLE_XML;

	String outputPath1 = Constants.getOutputFilePath("1--"+Constants.removeExtension(Path.getFileName(xmlInputPath)), "html");
	String outputPath2 = Constants.getOutputFilePath("2--"+Constants.removeExtension(Path.getFileName(xmlInputPath)), "html");

	XmlEditOptions editOptions1 = new XmlEditOptions();
	editOptions1.setRecognizeEmails(true);
	editOptions1.setRecognizeUris(true);
	editOptions1.setFixIncorrectStructure(true);
	editOptions1.setAttributeValuesQuoteType(QuoteType.SingleQuote);
	editOptions1.getFormatOptions().setLeftIndent(Length.parse("20px"));
	editOptions1.getHighlightOptions().getXmlTagsFontSettings().setLine((byte) (WebFont.TextDecorationLine.Underline + WebFont.TextDecorationLine.Overline));
	editOptions1.getHighlightOptions().getXmlTagsFontSettings().setWeight(FontWeight.Bold);

	XmlEditOptions editOptions2 = new XmlEditOptions();
	editOptions2.setTrimTrailingWhitespaces(true);
	editOptions2.setAttributeValuesQuoteType(QuoteType.DoubleQuote);
	editOptions2.getFormatOptions().setLeafTextNodesOnNewline(true);
	editOptions2.getHighlightOptions().getXmlTagsFontSettings().setSize(FontSize.XLarge);
	editOptions2.getHighlightOptions().getHtmlCommentsFontSettings().setLine(WebFont.TextDecorationLine.LineThrough);

	Editor editor = new Editor(xmlInputPath);
	try /*JAVA: was using*/
	{
		final EditableDocument edited1 = editor.edit(editOptions1);
		try /*JAVA: was using*/
		{
			final EditableDocument edited2 = editor.edit(editOptions2);
			try /*JAVA: was using*/
			{
				edited1.save(outputPath1);
				edited2.save(outputPath2);
			}
			finally {
				(edited2).dispose();
			}
		}
		finally {
			(edited1).dispose();
		}
	}
	finally {
		(editor).dispose();
	}
```

## Getting document metainfo

Article "[Extracting document metainfo](https://docs.groupdocs.com/editor/java/extracting-document-metainfo/)" describes the [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method, that allows to detect the document format and extract its metadata without editing it. XML format is supported as well.

When the [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method is called for the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class instance, which was previously created with an XML document loaded into the constructor, this method returns a [`com.groupdocs.editor.metadata.TextualDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo/) instance — it is a common class for all document formats of a textual nature, like HTML, XML, TXT.

As all [`IDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/) implementations, the [`TextualDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo/) has four inherited properties, but also one own property:

1. [`getFormat()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo/#getFormat--) property of [`com.groupdocs.editor.formats.TextualFormats`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/textualformats/) type. For XML documents it always is a [`TextualFormats.Xml`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/textualformats/#Xml).
2. [`getPageCount()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo/#getPageCount--) property of [integer](https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html) type. Always returns 1, since XML documents have no pages at all.
3. [`getSize()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo/#getSize--) property of a long integer (Int64) type. Returns a file size in bytes, not the number of characters.
4. [`isEncrypted()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo/#isEncrypted--) property of a Boolean type. Always returns false, because XML documents, like any other textual documents, cannot be encrypted.
5. [`getEncoding()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/textualdocumentinfo/#getEncoding--) property of System.Text.Encoding type. Returns detected presumable encoding of the XML document.

Code example below shows obtaining the metainfo for the XML file and checking its properties.

```java
	String xmlInputPath = Constants.SAMPLE_XML;

	Editor editor = new Editor(xmlInputPath);
	try /*JAVA: was using*/
	{
		IDocumentInfo info = editor.getDocumentInfo(null);
		TextualDocumentInfo xmlInfo = (TextualDocumentInfo)info;
		Assert.assertEquals(java.nio.charset.Charset.defaultCharset(), xmlInfo.getEncoding());
		Assert.assertFalse(xmlInfo.isEncrypted());
		Assert.assertEquals(1, xmlInfo.getPageCount());
		Assert.assertEquals(TextualFormats.Xml, xmlInfo.getFormat());
		//msAssert.Greater(xmlInfo.Size, 0);
	}
	finally {
		(editor).dispose();
	}
```

---

## How to edit XML file

Path: /editor/net/how-to-edit-xml/

> This example demonstrates the opening, editing and saving the XML documents, using different options and adjustments.

## Introduction

GroupDocs.Editor has supported importing the documents in [XML (eXtensible Markup Language)](https://docs.fileformat.com/web/xml/) format for a long time. However, in [version 23.2](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-2-release-notes/) the XML processing mechanism was completely redeveloped and drastically enhanced, XML editing public options were also redesigned and significantly expanded, with new sub-option classes and new public types.

Current article describes this new XML processing mechanism and is applicable to the GroupDocs.Editor [version 23.2](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-2-release-notes/) and above.

## Loading XML documents

Loading of the XML documents to the `GroupDocs.Editor.`[`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class is usual and the same as for other formats. There are no dedicated load options for the XML format, it is enough to specify the file itself through file path or [byte stream](https://docs.microsoft.com/en-us/dotnet/api/system.IO.Stream?view=net-6.0).

If loading through file path, the file extension does not matter, so you may freely load an XML file not only with the `*.xml`, but with any other extension like `*.csproj`, `*.svg` or any other extension - only valid internal structure matters.

Also please note that you cannot treat HTML files like XML — only [XHTML](https://en.wikipedia.org/wiki/XHTML) can be treated like valid XML.

Code example below shows loading of the same document by two approaches into the two different [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instances:

```csharp
const string xmlFilename = "Sample.xml";
string xmlInputPath = System.IO.Path.Combine("full_folder_path", xmlFilename);

using (FileStream xmlStream = System.IO.File.OpenRead(xmlInputPath))
using (GroupDocs.Editor.Editor editorFromPath = new Editor(xmlInputPath))//from the path
using (GroupDocs.Editor.Editor editorFromStream = new Editor(xmlStream))//from the stream
{
	//Here two Editor instances can separately work with one file
}
```

## Editing XML documents

Like for other format families in GroupDocs.Editor, there is a special [`XmlEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/) class for editing the XML documents. As always, it is not mandatory when editing a document, so the [`Editor.Edit()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) overload without parameter may be used — GroupDocs.Editor will automatically detect the format and apply the default options. The example below shows such a case: XML document is loaded, edited, and then the edited content, represented with a [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class, may be passed to the WYSIWYG-editor or any other HTML editing software, or simply saved to the disk, as it is shown in the example.

```csharp
const string xmlFilename = "Sample.xml";
string xmlInputPath = System.IO.Path.Combine("full_folder_path", xmlFilename);

string outputPath = System.IO.Path.Combine("output_folder_path", string.Format("{0}.html", Path.GetFileNameWithoutExtension(xmlFilename)));

using (GroupDocs.Editor.Editor editor = new Editor(xmlInputPath))
{
	using (EditableDocument edited = editor.Edit())
	{
		//Send to WYSIWYG-editor or somewhere else
		edited.Save(outputPath);
	}
}
```

[`XmlEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/) class has different properties, some of them are grouped into “wrappers” — special classes [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/) and [`XmlFormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/), which are described below in detail. The most useful and important properties, however, are directly inside the [`XmlEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/) class.

#### Encoding

[`System.Text.Encoding`](https://learn.microsoft.com/en-us/dotnet/api/system.text.encoding?view=net-7.0) [`Encoding`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/encoding) 

This property allows to set the encoding, which will be applied while opening an input XML file (keep in mind that any XML is first of all a text file). By default all XML files are UTF8, so the default value of this option is also UTF8.

#### FixIncorrectStructure

[`bool`](https://learn.microsoft.com/en-us/dotnet/api/system.boolean?view=net-7.0) [`FixIncorrectStructure`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/fixincorrectstructure)

GroupDocs.Editor can handle without error or exception any XML document: corrupted, truncated, with invalid structure, it can even treat HTML like XML. However, the representation of such a document may degrade in such cases — for example, it is impossible to properly display the nested hierarchical structure, if it is broken.

In order to fix this, the [`FixIncorrectStructure`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/fixincorrectstructure) boolean flag is introduced. If enabled, the GroupDocs.Editor scans the XML document and tries to fix its structure. In particular, it escapes some prohibited characters, properly closes unclosed tags, opens unopened tags, fixes overlapping tags, and so on.

Because such document scanning and fixing requires additional computational resources and in general most of XML documents are valid, this mechanism is disabled by default: [`FixIncorrectStructure`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/fixincorrectstructure) has a `false` value. So for enabling it, you must set the `true` value manually.

#### RecognizeUris

[`bool`](https://learn.microsoft.com/en-us/dotnet/api/system.boolean?view=net-7.0) [`RecognizeUris`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/recognizeuris)

This property enables the mechanism of recognizing and preparing the URIs (web address). By default this mechanism is disabled (`false`) and URIs, if they are present in the text nodes or attribute values inside the XML documents, are represented as an ordinary text. When this property is enabled (`true`), the GroupDocs.Editor scans the XML document for any valid URIs, and if found, represents them as external links in the resultant HTML format: by using the A element. GroupDocs.Editor is searching for URIs in: text nodes, CDATA sections, XML comments, attribute values, DocType definitions.

#### RecognizeEmails

[`bool`](https://learn.microsoft.com/en-us/dotnet/api/system.boolean?view=net-7.0) [`RecognizeEmails`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/recognizeemails)

This property is very similar to the [`RecognizeUris`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/recognizeuris): it does the same, but at this time for email addresses. By default it is disabled, so if the email address is present in the input XML, the output HTML will contain it as ordinary text. However, if enabled by setting `true`, all valid email addresses will be represented with [mailto](https://en.wikipedia.org/wiki/Mailto) scheme and A element.

Unlike the [`RecognizeUris`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/recognizeuris) property, the [`RecognizeEmails`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/recognizeemails), if enabled, is working only for attribute values.

#### TrimTrailingWhitespaces

[`bool`](https://learn.microsoft.com/en-us/dotnet/api/system.boolean?view=net-7.0) [`TrimTrailingWhitespaces`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/trimtrailingwhitespaces)

This property enables the truncation of trailing whitespaces in the text nodes — the textual content, located between start and end tags (inner-tag text). By default is disabled (`false`) — trailing whitespaces will be preserved. Line breaks are also treated as whitespaces. May be useful when input XML is formed with line breaks and empty spans for the sake of readability.

#### AttributeValuesQuoteType

[`QuoteType`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.serialization/quotetype/) [`AttributeValuesQuoteType`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/attributevaluesquotetype)

[`QuoteType`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.serialization/quotetype/) is a new type, introduced in the [version 23.2](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-2-release-notes/) — it is a struct, that represents two types of quotes, permissible in the XML format in attribute values: a *single quote*, represented by the `U+0027 APOSTROPHE` character, and a *double quote*, represented by the `U+0022 QUOTATION MARK` character.

With this option users can redefine the quote type, used in the original XML document, and set the desired quote, which should be present in the resultant HTML. By default the double quotes are used.

Next and last two properties, — [`HighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/highlightoptions/) and [`FormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/formatoptions/), — have compound values, described below. What is important, that users cannot create instances of wrapping classes [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/) and [`XmlFormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/) and set the values of [`HighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/highlightoptions/) and [`FormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/formatoptions/) (including setting them to null). It is intended that only members of [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/) and [`XmlFormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/) have to be changed from the default values.

### HighlightOptions

The [`HighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/highlightoptions/) property has a type of [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/). An already created instance of `XmlHighlightOptions` is already set in the `HighlightOptions` property and a reference to it cannot be modified; only members of `XmlHighlightOptions` are allowed to modify.

XmlHighlightOptions has 6 sub-properties:

1. [`XmlTagsFontSettings`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/xmltagsfontsettings) is responsible for representing the font of XML tags, this include both start and end tags, angle brackets with tag names. By default it is a “`Calibri`” font, `12pt` size.
2. [`AttributeNamesFontSettings`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/attributenamesfontsettings) is responsible for representing the font of attribute names. By default is a “`Calibri`” font, `11pt` size, `red` color.
3. [`AttributeValuesFontSettings`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/attributevaluesfontsettings) is responsible for representing the font of attribute values. By default is a “`Calibri`” font, `11pt` size, `blue` color.
4. [`InnerTextFontSettings`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/innertextfontsettings) is responsible for representing the font of text nodes (text inside and between XML elements). By default is a "`Times New Roman`" font, `11pt` size, `black` color.
5. [`HtmlCommentsFontSettings`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/htmlcommentsfontsettings) is responsible for representing the font of HTML comments (XML comments with a syntax of HTML comments), including a pair of opening `<!--` and closing `-–>` tags. By default is a "`Consolas`" font, `11pt` size, `green` color.
6. [`CDataFontSettings`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/cdatafontsettings) is responsible for representing the font of CDATA sections, including a pair of opening `<![CDATA[` and closing `]]>` tags. By default is a "`Calibri`" font, `11pt` size, `coral` color.

All these properties are of a [`WebFont`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/) class — a new public type, introduced in the [version 23.2](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-2-release-notes/). It has 6 public properties, one of them is of [`System.String`](https://learn.microsoft.com/en-us/dotnet/api/system.string?view=net-7.0) type, while 5 others are structs, each of which holds and represents some aspect of the font. [`WebFont`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/) class may be treated as a container for the font properties, where by default every property has some default value, and users can change some or every of them in defined limits.

1. Font name — [`Name`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/name/) property of a [`System.String`](https://learn.microsoft.com/en-us/dotnet/api/system.string?view=net-7.0) type. Is translated into the `font-family` CSS declaration.
2. Font size — [`Size`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/size/) property of [`FontSize`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.properties/fontsize/) type. Is translated into the `font-size` CSS declaration.
3. Font color — [`Color`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/color/) property of [`ArgbColor`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.datatypes/argbcolor/) type. Is translated into the `color` CSS declaration.
4. Font weight (boldness) — [`Weight`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/weight/) property of [`FontWeight`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.properties/fontweight/) type. Is translated into the `font-weight` CSS declaration.
5. Font style — [`Style`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/style/) property of [`FontStyle`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.properties/fontstyle/) type. Is translated into the `font-style` CSS declaration.
6. Text decoration line — [`Line`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/webfont/line/) property of [`TextDecorationLineType`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.properties/textdecorationlinetype/) type. Is translated into the `text-decoration-line` CSS declaration.

WebFont has also some other public functions — the ability to check on equality with itself (`System.IEquatable`) and support of deep cloning (`System.ICloneable`).

[`XmlHighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/) also has two useful public members:

- [`IsDefault`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/isdefault) [boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean?view=net-7.0) property, that indicates whether the current instance has a default value, which means that all properties are in their initial state.
- [`ResetToDefault()`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/resettodefault) method, that resets all properties to their initial values

Code sample below shows a creation of the [`XmlEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/) instance and setting different (but not all) properties within the [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/) sub-property.

```csharp
Options.XmlEditOptions editOptions = new XmlEditOptions();
Assert.IsTrue(editOptions.HighlightOptions.IsDefault);
Options.XmlHighlightOptions highlightOptions = editOptions.HighlightOptions;

//Setting XML tags font settings
highlightOptions.XmlTagsFontSettings.Size = HtmlCss.Css.Properties.FontSize.Large;
highlightOptions.XmlTagsFontSettings.Color = HtmlCss.Css.DataTypes.ArgbColor.KnownColors.CssLevel1.Olive;

//Setting attribute names font settings
highlightOptions.AttributeNamesFontSettings.Name = "Arial";
highlightOptions.AttributeNamesFontSettings.Line = HtmlCss.Css.Properties.TextDecorationLineType.Underline;
highlightOptions.AttributeNamesFontSettings.Weight = HtmlCss.Css.Properties.FontWeight.Lighter;

//Setting attribute values font settings
highlightOptions.AttributeValuesFontSettings.Line = HtmlCss.Css.Properties.TextDecorationLineType.Underline + HtmlCss.Css.Properties.TextDecorationLineType.Overline;
highlightOptions.AttributeValuesFontSettings.Style = HtmlCss.Css.Properties.FontStyle.Italic;

//Setting CDATA sections font settings
highlightOptions.CDataFontSettings.Line = HtmlCss.Css.Properties.TextDecorationLineType.LineThrough;
highlightOptions.CDataFontSettings.Size = HtmlCss.Css.Properties.FontSize.Smaller;

//Setting HTML comments font settings
highlightOptions.HtmlCommentsFontSettings.Color = HtmlCss.Css.DataTypes.ArgbColor.KnownColors.CssLevel3.Lightgreen;
highlightOptions.HtmlCommentsFontSettings.Name = "Courier New";

//Setting text node font settings
highlightOptions.InnerTextFontSettings.Weight = HtmlCss.Css.Properties.FontWeight.FromNumber(300);
highlightOptions.InnerTextFontSettings.Size = HtmlCss.Css.Properties.FontSize.XSmall;

//Checking they are not default
Assert.IsFalse(editOptions.HighlightOptions.IsDefault);

//Resetting to default
highlightOptions.ResetToDefault();

//Checking they are default again now
Assert.IsTrue(editOptions.HighlightOptions.IsDefault);
```

### FormatOptions

The [`FormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/formatoptions/) property has a type of [`XmlFormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/). Like with `HighlightOptions` property, the `FormatOptions` property has already set an instance of the `XmlFormatOptions` class with all sub-properties having their default values. Similarly, a reference to this `XmlFormatOptions` instance cannot be modified, but only obtained through the getter, and no new instance of `XmlFormatOptions` can be created.

[`XmlFormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/) class has only three sub-properties:

1. [`bool`](https://learn.microsoft.com/en-us/dotnet/api/system.boolean?view=net-7.0) [`EachAttributeFromNewline`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/eachattributefromnewline/). XML documents usually have the XML elements with a set of attribute-value pairs. By default these pairs are represented in the resultant HTML in a single line next to the element name (`false` value). However, when setting this property to `true`, each and every pair of attribute-value in every XML element will be placed on a new separate line in the resultant HTML.
2. [`bool`](https://learn.microsoft.com/en-us/dotnet/api/system.boolean?view=net-7.0) [`LeafTextNodesOnNewline`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/leaftextnodesonnewline). XML documents usually have the text nodes — pieces of textual content, located inside and/or between adjacent XML elements. By default these text nodes are represented in the resultant HTML along with other XML nodes, in the same line with them (`false` value). However, when setting this property to `true`, each text node will be placed on a new line with a bigger left indent.
3. [`HtmlCss.Css.DataTypes.Length`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.datatypes/length/) [`LeftIndent`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/leftindent). XML is a hierarchical structure, and most of WYSIWYG-editors display hierarchical structures using left indentation: the deeper node is located inside the tree (bigger nesting level) — the bigger left indent is. GroupDocs.Editor does the same, and the [`LeftIndent`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/leftindent) property regulates how big is a left indent distance for a one level. By default it is 10 points (`pt`). So the root element will have no indent at all, 1st nesting level will be `10pt` shifted, 2nd level — `20pt`, 3rd level — `30pt`, and so on. This length is represented by a public type [`HtmlCss.Css.DataTypes.Length`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.datatypes/length/) and can be easily changed to desired. What is more, it can be specified not necessarily in points, but in any CSS-compatible length unit, like percent, pixel, centimeter, and so on. Left indent can be disabled at all by setting a unitless zero to this property like this: [`Length.UnitlessZero`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.css.datatypes/length/unitlesszero/). But keep in mind that non-zero unitless values are prohibited according to the CSS specification, and GroupDocs.Editor prohibits such values too.

Like in [`XmlHighlightOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlhighlightoptions/), the [`XmlFormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/) has a useful `boolean` property [`IsDefault`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/isdefault), that indicates whether the current instance has all properties to be set to their initial values.

Code sample below shows a creation of the [`XmlEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/) instance and setting different properties within the [`XmlFormatOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmlformatoptions/) sub-property.

```csharp
Options.XmlEditOptions editOptions = new XmlEditOptions();

//Checking that options are default for now
Assert.IsTrue(editOptions.FormatOptions.IsDefault);
Options.XmlFormatOptions formatOptions = editOptions.FormatOptions;

//Each attribute-value pair must be placed on a new line
formatOptions.EachAttributeFromNewline = true;

//Text nodes (textual content between and inside XML elements) must be placed on a new line
formatOptions.LeafTextNodesOnNewline = true;

//Setting a custom text indent using 'Length' data type, which is composed from value with unit
formatOptions.LeftIndent = HtmlCss.Css.DataTypes.Length.FromValueWithUnit(20, HtmlCss.Css.DataTypes.Length.Unit.Px);

//Checking that options are not default now
Assert.IsFalse(editOptions.FormatOptions.IsDefault);

//Disabling a left indent at all
formatOptions.LeftIndent = HtmlCss.Css.DataTypes.Length.UnitlessZero;
```

## Complex example

Now, when the [`XmlEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/) class with all its properties and sub-properties is described in detail, it's time to bring it together. Code example below shows opening a XML file from file path, creating and adjusting two different [`XmlEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/xmleditoptions/) instances, and editing a document twice with these two different option classes to obtain two different [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) representations. Then these [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) are saved to the two different HTML files.

```csharp
const string xmlFilename = "Sample.xml";
string xmlInputPath = System.IO.Path.Combine("input_folder_path", xmlFilename);

string outputPath1 = System.IO.Path.Combine("output_folder_path", string.Format("1-{0}.html", Path.GetFileNameWithoutExtension(xmlFilename)));
string outputPath2 = System.IO.Path.Combine("output_folder_path", string.Format("2-{0}.html", Path.GetFileNameWithoutExtension(xmlFilename)));

Options.XmlEditOptions editOptions1 = new XmlEditOptions();
editOptions1.RecognizeEmails = true;
editOptions1.RecognizeUris = true;
editOptions1.FixIncorrectStructure = true;
editOptions1.AttributeValuesQuoteType = HtmlCss.Serialization.QuoteType.SingleQuote;
editOptions1.FormatOptions.LeftIndent = HtmlCss.Css.DataTypes.Length.Parse("20px");
editOptions1.HighlightOptions.XmlTagsFontSettings.Line = HtmlCss.Css.Properties.TextDecorationLineType.Underline + HtmlCss.Css.Properties.TextDecorationLineType.Overline;
editOptions1.HighlightOptions.XmlTagsFontSettings.Weight = HtmlCss.Css.Properties.FontWeight.Bold;

Options.XmlEditOptions editOptions2 = new XmlEditOptions();
editOptions2.TrimTrailingWhitespaces = true;
editOptions2.AttributeValuesQuoteType = HtmlCss.Serialization.QuoteType.DoubleQuote;
editOptions2.FormatOptions.LeafTextNodesOnNewline = true;
editOptions2.HighlightOptions.XmlTagsFontSettings.Size = HtmlCss.Css.Properties.FontSize.XLarge;
editOptions2.HighlightOptions.HtmlCommentsFontSettings.Line = HtmlCss.Css.Properties.TextDecorationLineType.LineThrough;

using (GroupDocs.Editor.Editor editor = new Editor(xmlInputPath))
{
	using (EditableDocument edited1 = editor.Edit(editOptions1))
	using (EditableDocument edited2 = editor.Edit(editOptions2))
	{
		edited1.Save(outputPath1);
		edited2.Save(outputPath2);
	}
}
```

## Getting document metainfo

Article "[Extracting document metainfo](https://docs.groupdocs.com/editor/net/extracting-document-metainfo/)" describes the [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) method, that allows to detect the document format and extract its metadata without editing it. XML format is supported as well.

When the [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) method is called for the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class instance, which was previously created with an XML document loaded into the constructor, this method returns a [`GroupDocs.Editor.Metadata.TextualDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo/) instance — it is a common class for all document formats of a textual nature, like HTML, XML, TXT.

As all [`IDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) implementations, the [`TextualDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo/) has four inherited properties, but also one own property:

1. [`Format`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo/format/) property of [`Formats.TextualFormats`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/textualformats/) type. For XML documents it always is a [`TextualFormats.Xml`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/textualformats/xml/).
2. [`PageCount`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo/pagecount) property of [integer (Int32)](https://docs.microsoft.com/en-us/dotnet/api/system.int32?view=net-6.0) type. Always returns 1, since XML documents have no pages at all.
3. [`Size`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo/size) property of a long integer (Int64) type. Returns a file size in bytes, not the number of characters.
4. [`IsEncrypted`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo/isencrypted) property of a Boolean type. Always returns false, because XML documents, like any other textual documents, cannot be encrypted.
5. [`Encoding`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/textualdocumentinfo/encoding) property of System.Text.Encoding type. Returns detected presumable encoding of the XML document.

Code example below shows obtaining the metainfo for the XML file and checking its properties.

```csharp
const string xmlFilename = "Sample.xml";
string xmlInputPath = System.IO.Path.Combine("input_folder_path", xmlFilename);

using (GroupDocs.Editor.Editor editor = new Editor(xmlInputPath))
{
	GroupDocs.Editor.Metadata.IDocumentInfo info = editor.GetDocumentInfo(null);
	GroupDocs.Editor.Metadata.TextualDocumentInfo xmlInfo = (TextualDocumentInfo)info;
	Assert.AreEqual(System.Text.Encoding.UTF8, xmlInfo.Encoding);
	Assert.IsFalse(xmlInfo.IsEncrypted);
	Assert.AreEqual(1, xmlInfo.PageCount);
	Assert.AreEqual(GroupDocs.Editor.Formats.TextualFormats.Xml, xmlInfo.Format);
	Assert.Greater(xmlInfo.Size, 0);
}
```

---

## How to Edit XML File

Path: /editor/nodejs-java/how-to-edit-xml/


> This example demonstrates how to open, edit, and save XML documents using different options and adjustments in Node.js via Java.

## Introduction

GroupDocs.Editor for Node.js via Java has supported importing documents in the [XML (eXtensible Markup Language)](https://docs.fileformat.com/web/xml/) format for a long time. However, in [version 24.6](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node-js-via-java-24-6-release-notes/), the XML processing mechanism was completely redeveloped and drastically enhanced. XML editing public options were also redesigned and significantly expanded, with new sub-option classes and new public types.

This article describes this new XML processing mechanism and is applicable to GroupDocs.Editor for Node.js via Java [version 24.6](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node-js-via-java-24-6-release-notes/) and above.

## Loading XML Documents

Loading XML documents into the `Editor` class is straightforward and similar to other formats. There are no dedicated load options for the XML format; you just need to specify the file itself through a file path or an input stream.

If loading through a file path, the file extension does not matter, so you may freely load an XML file not only with the `*.xml` extension but with any other extension like `*.csproj`, `*.svg`, or any other extension—as long as it has a valid internal structure.

Also, please note that you cannot treat HTML files like XML—only [XHTML](https://en.wikipedia.org/wiki/XHTML) can be treated as valid XML.

The code example below shows loading the same document by two approaches into two different `Editor` instances:

```javascript
// Import necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

// Specify the input file path
const inputFilePath = 'path/to/sample.xml';

// Load from file path
const editorFromPath = new groupdocsEditor.Editor(inputFilePath);

// Load from stream
const xmlStream = fs.createReadStream(inputFilePath);
const editorFromStream = new groupdocsEditor.Editor(xmlStream);

// Now you can work with both editor instances
// ...

// Don't forget to dispose of the editors when done
editorFromPath.dispose();
editorFromStream.dispose();
```

## Editing XML Documents

Like for other format families in GroupDocs.Editor, there is a special `XmlEditOptions` class for editing XML documents. As always, it is not mandatory when editing a document; you can use the `editor.edit()` method without parameters—GroupDocs.Editor will automatically detect the format and apply the default options. The example below shows such a case: an XML document is loaded, edited, and then the edited content, represented with an `EditableDocument` class, may be passed to the WYSIWYG editor or any other HTML editing software, or simply saved to disk, as shown in the example.

```javascript
// Import necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

// Specify the input and output file paths
const xmlInputPath = 'path/to/sample.xml';
const outputPath = 'path/to/output.html';

// Create an Editor instance
const editor = new groupdocsEditor.Editor(xmlInputPath);

// Open the document for editing
const editableDocument = editor.edit();

// Get the HTML content (you can send this to a WYSIWYG editor)
const htmlContent = editableDocument.getContent();

// Optionally, save the HTML content to a file
fs.writeFileSync(outputPath, htmlContent);

// Dispose of resources
editableDocument.dispose();
editor.dispose();
```

The `XmlEditOptions` class has various properties, some of which are grouped into "wrappers"—special classes `XmlHighlightOptions` and `XmlFormatOptions`, which are described in detail below. The most useful and important properties, however, are directly inside the `XmlEditOptions` class.

### Encoding

`encoding`

This property allows you to set the encoding that will be applied while opening an input XML file (keep in mind that any XML is first of all a text file). By default, all XML files are UTF-8, so the default value of this option is also UTF-8.

### FixIncorrectStructure

`fixIncorrectStructure`

GroupDocs.Editor can handle any XML document without error or exception: corrupted, truncated, with invalid structure—it can even treat HTML like XML. However, the representation of such a document may degrade in such cases—for example, it is impossible to properly display the nested hierarchical structure if it is broken.

To fix this, the `fixIncorrectStructure` boolean flag is introduced. If enabled, GroupDocs.Editor scans the XML document and tries to fix its structure. In particular, it escapes some prohibited characters, properly closes unclosed tags, opens unopened tags, fixes overlapping tags, and so on.

Because such document scanning and fixing requires additional computational resources and, in general, most XML documents are valid, this mechanism is disabled by default (`false`). So, to enable it, you must set it to `true` manually.

### RecognizeUris

`recognizeUris`

This property enables the mechanism of recognizing and preparing URIs (web addresses). By default, this mechanism is disabled (`false`), and URIs, if they are present in text nodes or attribute values inside the XML documents, are represented as ordinary text. When this property is enabled (`true`), GroupDocs.Editor scans the XML document for any valid URIs, and if found, represents them as external links in the resultant HTML format using the `<a>` element. GroupDocs.Editor searches for URIs in text nodes, CDATA sections, XML comments, attribute values, and DocType definitions.

### RecognizeEmails

`recognizeEmails`

This property is very similar to `recognizeUris`; it does the same but for email addresses. By default, it is disabled, so if an email address is present in the input XML, the output HTML will contain it as ordinary text. However, if enabled by setting it to `true`, all valid email addresses will be represented with the [mailto](https://en.wikipedia.org/wiki/Mailto) scheme and the `<a>` element.

Unlike the `recognizeUris` property, the `recognizeEmails` property, if enabled, works only for attribute values.

### TrimTrailingWhitespaces

`trimTrailingWhitespaces`

This property enables the truncation of trailing whitespaces in text nodes—the textual content located between start and end tags (inner-tag text). By default, it is disabled (`false`), so trailing whitespaces will be preserved. Line breaks are also treated as whitespaces. This may be useful when the input XML is formed with line breaks and empty spans for the sake of readability.

### AttributeValuesQuoteType

`attributeValuesQuoteType`

`QuoteType` is a new type introduced in version 23.5—it represents two types of quotes permissible in the XML format in attribute values: a single quote (`'`) and a double quote (`"`).

With this option, users can redefine the quote type used in the original XML document and set the desired quote, which should be present in the resultant HTML. By default, double quotes are used.

The next two properties—`highlightOptions` and `formatOptions`—have compound values, described below. Users cannot create instances of the wrapping classes `XmlHighlightOptions` and `XmlFormatOptions` and set the values of `highlightOptions` and `formatOptions` (including setting them to null). It is intended that only members of `XmlHighlightOptions` and `XmlFormatOptions` are to be changed from their default values.

#### HighlightOptions

The `highlightOptions` property has a type of `XmlHighlightOptions`. An already created instance of `XmlHighlightOptions` is set in the `highlightOptions` property, and a reference to it cannot be modified; only members of `XmlHighlightOptions` are allowed to be modified.

`XmlHighlightOptions` has six sub-properties:

1. **xmlTagsFontSettings**: Responsible for representing the font of XML tags, including both start and end tags, angle brackets with tag names. By default, it is a "Calibri" font, 12pt size.
2. **attributeNamesFontSettings**: Responsible for representing the font of attribute names. By default, it is a "Calibri" font, 11pt size, red color.
3. **attributeValuesFontSettings**: Responsible for representing the font of attribute values. By default, it is a "Calibri" font, 11pt size, blue color.
4. **innerTextFontSettings**: Responsible for representing the font of text nodes (text inside and between XML elements). By default, it is a "Times New Roman" font, 11pt size, black color.
5. **htmlCommentsFontSettings**: Responsible for representing the font of HTML comments (XML comments with the syntax of HTML comments), including a pair of opening `<!--` and closing `-->` tags. By default, it is a "Consolas" font, 11pt size, green color.
6. **cDataFontSettings**: Responsible for representing the font of CDATA sections, including a pair of opening `<![CDATA[` and closing `]]>` tags. By default, it is a "Calibri" font, 11pt size, coral color.

All these properties are of the `WebFont` class—a new public type introduced in version 23.5. It has several public properties, each of which holds and represents some aspect of the font.

`XmlHighlightOptions` also has two useful public members:

- `isDefault`: Boolean property that indicates whether the current instance has default values, which means that all properties are in their initial state.
- `resetToDefault()`: Method that resets all properties to their initial values.

The code sample below shows the creation of an `XmlEditOptions` instance and setting different (but not all) properties within the `XmlHighlightOptions` sub-property.

```javascript
// Import necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Create XmlEditOptions instance
const editOptions = new groupdocsEditor.XmlEditOptions();

// Check if options are default
console.log('Are highlight options default?', editOptions.getHighlightOptions().isDefault());

// Get highlight options
const highlightOptions = editOptions.getHighlightOptions();

// Setting XML tags font settings
highlightOptions.getXmlTagsFontSettings().setSize(groupdocsEditor.FontSize.Large);
highlightOptions.getXmlTagsFontSettings().setColor(groupdocsEditor.ArgbColor.fromKnownColor('Olive'));

// Setting attribute names font settings
highlightOptions.getAttributeNamesFontSettings().setName('Arial');
highlightOptions.getAttributeNamesFontSettings().setLine(groupdocsEditor.WebFont.TextDecorationLine.Underline);
highlightOptions.getAttributeNamesFontSettings().setWeight(groupdocsEditor.FontWeight.Lighter);

// Setting attribute values font settings
highlightOptions.getAttributeValuesFontSettings().setLine(
    groupdocsEditor.WebFont.TextDecorationLine.Underline | groupdocsEditor.WebFont.TextDecorationLine.Overline
);
highlightOptions.getAttributeValuesFontSettings().setStyle(groupdocsEditor.FontStyle.Italic);

// Setting CDATA sections font settings
highlightOptions.getCDataFontSettings().setLine(groupdocsEditor.WebFont.TextDecorationLine.LineThrough);
highlightOptions.getCDataFontSettings().setSize(groupdocsEditor.FontSize.Smaller);

// Setting HTML comments font settings
highlightOptions.getHtmlCommentsFontSettings().setColor(groupdocsEditor.ArgbColor.fromKnownColor('LightGreen'));
highlightOptions.getHtmlCommentsFontSettings().setName('Courier New');

// Setting text node font settings
highlightOptions.getInnerTextFontSettings().setWeight(groupdocsEditor.FontWeight.fromNumber(300));
highlightOptions.getInnerTextFontSettings().setSize(groupdocsEditor.FontSize.XSmall);

// Checking they are not default
console.log('Are highlight options default now?', highlightOptions.isDefault());

// Resetting to default
highlightOptions.resetToDefault();

// Checking they are default again
console.log('Are highlight options default after reset?', highlightOptions.isDefault());
```

#### FormatOptions

The `formatOptions` property has a type of `XmlFormatOptions`. Like with `highlightOptions`, the `formatOptions` property already has an instance of `XmlFormatOptions` with all sub-properties having their default values. A reference to this instance cannot be modified, but only obtained through the getter, and no new instance of `XmlFormatOptions` can be created.

`XmlFormatOptions` has three sub-properties:

1. **eachAttributeFromNewline**: Boolean flag. By default, attribute-value pairs are represented in the resultant HTML in a single line next to the element name (`false` value). When set to `true`, each pair of attribute-value in every XML element will be placed on a new separate line in the resultant HTML.
2. **leafTextNodesOnNewline**: Boolean flag. By default, text nodes are represented in the resultant HTML along with other XML nodes, in the same line (`false` value). When set to `true`, each text node will be placed on a new line with a bigger left indent.
3. **leftIndent**: Represents the left indent distance for one level of nesting. By default, it is 10 points (`pt`). This property uses the `Length` data type, and you can specify the value in any CSS-compatible length unit.

Like `XmlHighlightOptions`, `XmlFormatOptions` has a useful boolean property `isDefault()` that indicates whether the current instance has all properties set to their initial values.

The code sample below shows the creation of an `XmlEditOptions` instance and setting different properties within the `XmlFormatOptions` sub-property.

```javascript
// Import necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Create XmlEditOptions instance
const editOptions = new groupdocsEditor.XmlEditOptions();

// Check if options are default
console.log('Are format options default?', editOptions.getFormatOptions().isDefault());

// Get format options
const formatOptions = editOptions.getFormatOptions();

// Each attribute-value pair must be placed on a new line
formatOptions.setEachAttributeFromNewline(true);

// Text nodes must be placed on a new line
formatOptions.setLeafTextNodesOnNewline(true);

// Setting a custom left indent using 'Length' data type
formatOptions.setLeftIndent(groupdocsEditor.Length.fromValueWithUnit(20, groupdocsEditor.Length.Unit.Px));

// Checking that options are not default now
console.log('Are format options default now?', formatOptions.isDefault());

// Disabling left indent
formatOptions.setLeftIndent(groupdocsEditor.Length.UnitlessZero);
```

## Complex Example

Now that the `XmlEditOptions` class with all its properties and sub-properties is described in detail, it's time to bring it together. The code example below shows opening an XML file from a file path, creating and adjusting two different `XmlEditOptions` instances, and editing a document twice with these two different option classes to obtain two different `EditableDocument` representations. Then these `EditableDocument` instances are saved to two different HTML files.

```javascript
// Import necessary modules
const fs = require('fs');
const path = require('path');
const groupdocsEditor = require('groupdocs-editor');

// Specify input and output paths
const xmlInputPath = 'path/to/sample.xml';

const outputPath1 = 'path/to/output1.html';
const outputPath2 = 'path/to/output2.html';

// Create and adjust the first XmlEditOptions instance
const editOptions1 = new groupdocsEditor.XmlEditOptions();
editOptions1.setRecognizeEmails(true);
editOptions1.setRecognizeUris(true);
editOptions1.setFixIncorrectStructure(true);
editOptions1.setAttributeValuesQuoteType(groupdocsEditor.QuoteType.SingleQuote);
editOptions1.getFormatOptions().setLeftIndent(groupdocsEditor.Length.parse('20px'));
editOptions1.getHighlightOptions().getXmlTagsFontSettings().setLine(
    groupdocsEditor.WebFont.TextDecorationLine.Underline | groupdocsEditor.WebFont.TextDecorationLine.Overline
);
editOptions1.getHighlightOptions().getXmlTagsFontSettings().setWeight(groupdocsEditor.FontWeight.Bold);

// Create and adjust the second XmlEditOptions instance
const editOptions2 = new groupdocsEditor.XmlEditOptions();
editOptions2.setTrimTrailingWhitespaces(true);
editOptions2.setAttributeValuesQuoteType(groupdocsEditor.QuoteType.DoubleQuote);
editOptions2.getFormatOptions().setLeafTextNodesOnNewline(true);
editOptions2.getHighlightOptions().getXmlTagsFontSettings().setSize(groupdocsEditor.FontSize.XLarge);
editOptions2.getHighlightOptions().getHtmlCommentsFontSettings().setLine(groupdocsEditor.WebFont.TextDecorationLine.LineThrough);

// Create an Editor instance
const editor = new groupdocsEditor.Editor(xmlInputPath);

// Edit the document with the first set of options
const edited1 = editor.edit(editOptions1);

// Edit the document with the second set of options
const edited2 = editor.edit(editOptions2);

// Save the first edited document to an HTML file
fs.writeFileSync(outputPath1, edited1.getContent());

// Save the second edited document to another HTML file
fs.writeFileSync(outputPath2, edited2.getContent());

// Dispose of resources
edited1.dispose();
edited2.dispose();
editor.dispose();
```

## Getting Document Metainfo

The article "[Extracting Document Metainfo](/editor/nodejs-java/extracting-document-metainfo)" describes the `getDocumentInfo()` method, which allows detecting the document format and extracting its metadata without editing it. The XML format is supported as well.

When the `getDocumentInfo()` method is called for the `Editor` class instance, which was previously created with an XML document loaded into the constructor, this method returns a `TextualDocumentInfo` instance—it is a common class for all document formats of a textual nature, like HTML, XML, TXT.

As with all `IDocumentInfo` implementations, the `TextualDocumentInfo` has four inherited properties, but also one own property:

1. **format**: Property of `TextualFormats` type. For XML documents, it is always `TextualFormats.Xml`.
2. **pageCount**: Integer type. Always returns 1 since XML documents have no pages.
3. **size**: Long integer type. Returns the file size in bytes, not the number of characters.
4. **isEncrypted**: Boolean type. Always returns `false` because XML documents, like any other textual documents, cannot be encrypted.
5. **encoding**: Returns the detected presumable encoding of the XML document.

The code example below shows obtaining the metainfo for the XML file and checking its properties.

```javascript
// Import necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Specify the input XML file path
const xmlInputPath = 'path/to/sample.xml';

// Create an Editor instance
const editor = new groupdocsEditor.Editor(xmlInputPath);

// Get document info
const info = editor.getDocumentInfo();
const xmlInfo = info;

// Output the properties
console.log('Encoding:', xmlInfo.getEncoding());
console.log('Is Encrypted:', xmlInfo.isEncrypted());
console.log('Page Count:', xmlInfo.getPageCount());
console.log('Format:', xmlInfo.getFormat());
console.log('Size:', xmlInfo.getSize());

// Dispose of the editor
editor.dispose();
```

## Conclusion

By following this guide, you can effectively edit XML files using GroupDocs.Editor for Node.js via Java. The `XmlEditOptions` class provides extensive customization for processing XML documents, including fixing incorrect structures, recognizing URIs and emails, customizing font settings, and formatting options.

This capability is particularly useful for applications that require programmatic manipulation of XML files, such as configuration files, project files, or any XML-based data.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## Convert images with optical character recognition

Path: /conversion/java/convert/image-with-ocr/


## About image file formats

An image file format is a standard method for organizing and storing images on devices like computers, tablets and smartphones. Digital images store image data in a 2-dimensional grid of pixels where each pixel is a representation of color in terms of a number of bits. Image file types are classified into vector image formats and raster image formats. 3D Images are another type of vector image file format that is used for managing 3D images.

### Raster formats

**Raster Graphics** are digital images that comprise of pixels data for the representation of colors. These are the most common image types for graphics used for the web as well as digital photos. Some of the raster images can be compressed to reduce image file size. Common raster image file extensions and their file formats include **BMP** (Bitmap image file), **PNG** (Portable Network Graphics) and **GIF** (Graphics Interchange File).

### Vector formats

**Vector images** are defined by 2D points, instead of pixels, which are connected to give a geometric shape to the image. The points have properties that define the direction of paths, color, shape, curve, thickness, and fill. Common vector image file extensions and their file formats include **SVG** (Scalable Vector Graphics), **EPS** (Encapsulated PostScript language) and **PDF** (Portable Document Format).

## Convert from an image using OCR

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your image files using OCR.  

To allow OCR conversions [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) provides an extension point to offload the actual OCR process to the OCR processing library, but at the same time gives you the simplicity of conversion setup. The extension point is the [IOcrConnector](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.integration.ocr/iocrconnector/) interface. 

First, you must decide which OCR processing library will use. Different libraries have different setup processes.

In our example, we will use Aspose.OCR. Install the [Aspose.OCR](https://releases.aspose.com/java/repo/com/aspose/aspose-ocr/) nuget package in your project. Then implement [IOcrConnector](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.integration.ocr/iocrconnector/). The following code snippet provides a sample implementation:


{{< tabs "example-1">}}
{{< tab "ConvertImageUsingOcr.java" >}}  
```java
import com.aspose.ocr.*;
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.examples.Constants;
import com.groupdocs.conversion.integration.ocr.IOcrConnector;
import com.groupdocs.conversion.integration.ocr.RecognizedImage;
import com.groupdocs.conversion.integration.ocr.TextFragment;
import com.groupdocs.conversion.integration.ocr.TextLine;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.ImageLoadOptions;
import javax.imageio.ImageIO;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.InputStream;
import java.lang.Character;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

/**
 * This example demonstrates how to convert image using ocr
 */
public class ConvertImageUsingOcr {
    public static void run() {
        String outputFile = Constants.getConvertedPath("converted.pdf");

        ImageLoadOptions imageLoadOptions = new ImageLoadOptions();
        imageLoadOptions.setOcrConnector(new OcrConnector());

        //Once the `IOcrConnector` interface is implemented, the JPG to PDF conversion code snippet looks like this:
        try (Converter converter = new Converter(Constants.SAMPLE_JPEG, () -> imageLoadOptions)) {
            PdfConvertOptions options = new PdfConvertOptions();
            converter.convert(outputFile, options);
        } catch (Exception e) {
            System.out.println("Conversion failed: " + e.getMessage());
        }

        System.out.printf("\nDocument converted successfully. \nCheck output in %s%n", outputFile);
    }

}
class OcrConnector implements IOcrConnector {
    @Override
    public RecognizedImage recognize(InputStream imageStream) {
        try {
            AsposeOCR api = new AsposeOCR();
            OcrInput ocrInput = new OcrInput(InputType.SingleImage);

            BufferedImage image = ImageIO.read(imageStream);
            ocrInput.add(image);

            RectangleOutput detectedRectangles = api.DetectRectangles(ocrInput, AreasType.LINES, false).get(0);

            RecognitionSettings recognitionSettings = new RecognitionSettings();
            recognitionSettings.setDetectAreasMode(DetectAreasMode.COMBINE);
            recognitionSettings.setRecognitionAreas(detectedRectangles.Rectangles);

            RecognitionResult result = api.Recognize(ocrInput, recognitionSettings).get(0);

            return createRecognizedImageFromResult(result);
        } catch (Exception ex) {
            System.out.println("OCR Recognition failed: " + ex.getMessage());
        }
        return RecognizedImage.EMPTY;
    }

    private RecognizedImage createRecognizedImageFromResult(RecognitionResult result) {
        List<TextLine> lines = new ArrayList<>();

        for (int i = 0; i < result.recognitionAreasText.size(); i++) {
            String text = result.recognitionAreasText.get(i).trim();
            Rectangle rectangle = result.recognitionAreasRectangles.get(i);
            List<TextFragment> fragments = splitToFragments(text, (int)rectangle.getX(), (int)rectangle.getY(), (int)rectangle.getWidth(), (int)rectangle.getHeight());
            lines.add(new TextLine(fragments));
        }
        return new RecognizedImage(lines);
    }

    private List<TextFragment> splitToFragments(String lineText, int rectangleX, int rectangleY, int rectangleWidth, int rectangleHeight) {
        List<TextFragment> fragments = new ArrayList<>();
        if (lineText != null && !lineText.isEmpty()) {
            List<Character> frag = new ArrayList<>();
            boolean isWhitespace = false;
            float fixWidthChar = rectangleWidth / getEquivalentLength(lineText);

            for (int i = 0; i < lineText.length(); i++) {
                if (frag.isEmpty()) {
                    isWhitespace = (lineText.charAt(i) == ' ');
                } else {
                    boolean currentIsWhitespace = (lineText.charAt(i) == ' ');
                    if (i == lineText.length() - 1) frag.add(lineText.charAt(i));
                    if (currentIsWhitespace != isWhitespace || i == lineText.length() - 1) {
                        String fragment = frag.stream().map(String::valueOf).reduce("", String::concat);
                        int fragWidth = Math.round(getEquivalentLength(fragment) * fixWidthChar);
                        fragments.add(new TextFragment(fragment, new Rectangle(rectangleX, rectangleY, fragWidth, rectangleHeight)));
                        frag.clear();
                        isWhitespace = currentIsWhitespace;
                    }
                }
                frag.add(lineText.charAt(i));
            }
        }
        return fragments;
    }

    private float getEquivalentLength(String lineText) {
        float length = 0;
        for (char c : lineText.toCharArray()) {
            if (c == ' ') {
                length += 0.6f;
            } else if (NARROW_CHARS.contains(c)) {
                length += 0.5f;
            } else if (WIDE_CHARS.contains(c) || Character.isUpperCase(c)) {
                length += 1.5f;
            } else {
                length += 1.0f;
            }
        }
        return length;
    }

    private final List<Character> NARROW_CHARS = Arrays.asList(',', '.', ':', ';', '!', '|', '(', ')', '{', '}', 'l', 'i', 'I', '-', '+', 'f', 't', 'r');
    private final List<Character> WIDE_CHARS = Arrays.asList('\t', 'm', 'w', 'M', 'W');
}
```
{{< /tab >}}
{{< tab "sample.jpeg" >}}  
{{< tab-text >}}
`sample.jpeg` is the sample file used in this example. Click [here](/conversion/java/_images/sample.jpeg) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "converted.pdf" >}}  
{{< tab-text >}}
`converted.pdf` is the expected output PDF file. Click [here](/conversion/java/_sample_files/developer-guide/converting-documents/image-ocr/converted.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< /tabs >}}

Put it simply - you install an OCR processing library, implement the `IOcrConnector` interface, load an image file into the `Converter` class providing the `IOcrConnector` instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/) for more conversion options and customizations.
{{< /alert >}}

---

## Convert images with optical character recognition

Path: /conversion/net/convert/image-with-ocr/


## About image file formats

An image file format is a standard method for organizing and storing images on devices like computers, tablets and smartphones. Digital images store image data in a 2-dimensional grid of pixels where each pixel is a representation of color in terms of a number of bits. Image file types are classified into vector image formats and raster image formats. 3D Images are another type of vector image file format that is used for managing 3D images.

### Raster formats

**Raster Graphics** are digital images that comprise of pixels data for the representation of colors. These are the most common image types for graphics used for the web as well as digital photos. Some of the raster images can be compressed to reduce image file size. Common raster image file extensions and their file formats include **BMP** (Bitmap image file), **PNG** (Portable Network Graphics) and **GIF** (Graphics Interchange File).

### Vector formats

**Vector images** are defined by 2D points, instead of pixels, which are connected to give a geometric shape to the image. The points have properties that define the direction of paths, color, shape, curve, thickness, and fill. Common vector image file extensions and their file formats include **SVG** (Scalable Vector Graphics), **EPS** (Encapsulated PostScript language) and **PDF** (Portable Document Format).

## Convert from an image using OCR

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your image files using OCR.  

To allow OCR conversions [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) provides an extension point to offload the actual OCR process to the OCR processing library, but at the same time gives you the simplicity of conversion setup. The extension point is the [IOcrConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.ocr/iocrconnector) interface. 

First, you must decide which OCR processing library will use. Different libraries have different setup processes.

In our example, we will use Aspose.OCR. Install the [Aspose.OCR](https://www.nuget.org/packages/Aspose.OCR) nuget package in your project. Then implement [IOcrConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.ocr/iocrconnector). The following code snippet provides a sample implementation:

```csharp
public class OcrConnector : IOcrConnector
{
    public RecognizedImage Recognize(Stream imageStream)
    {
        try
        {
            var api = new AsposeOcr();
            var ocrInput = new OcrInput(InputType.SingleImage);

            using (MemoryStream ms = new MemoryStream())
            {
                imageStream.Position = 0;
                imageStream.CopyTo(ms);
                ms.Position = 0;
                ocrInput.Add(ms);

                var detectedRectangles = api.DetectRectangles(ocrInput, AreasType.LINES, false).First();
                var result = api.Recognize(ocrInput, new RecognitionSettings
                    {
                        DetectAreasMode = DetectAreasMode.COMBINE,
                        RecognitionAreas = detectedRectangles.Rectangles
                    })
                    .First();
                return CreateRecognizedImageFromResult(result);
            }
        }
        catch (System.Exception ex)
        {
            Console.WriteLine("Aspose.OCR Recognition failed: {0}", ex);
        }

        return RecognizedImage.Empty;
    }

    private RecognizedImage CreateRecognizedImageFromResult(RecognitionResult result)
    {
        var lines = new List<TextLine>();

        for (var i = 0; i < result.RecognitionAreasText.Count; i++)
        {
            var rectangle = result.RecognitionAreasRectangles[i];
            var s = result.RecognitionAreasText[i].Trim('\r', '\n');
            var fragments = SplitToFragments(s, rectangle.X, rectangle.Y, rectangle.Width, rectangle.Height);
            lines.Add(new TextLine(fragments));
        }

        return new RecognizedImage(lines);
    }

    private static List<TextFragment> SplitToFragments(string lineText, int rectangleX, int rectangleY,
        int rectangleWidth, int rectangleHeight)
    {
        var fragments = new List<TextFragment>();
        if (!string.IsNullOrEmpty(lineText))
        {
            int index = 0, fragIndex = 0;
            bool isWhitespace = false;
            List<char> frag = new List<char>();
            int previousWidth = 0;
            float fixWidthChar = rectangleWidth / GetEquivalentLength(lineText);
            while (index < lineText.Length)
            {
                if (frag.Count == 0)
                {
                    isWhitespace = (lineText[index] == ' ');
                }
                else
                {
                    bool altIsWhitespace = (lineText[index] == ' ');
                    if (index == lineText.Length - 1) frag.Add(lineText[index]);
                    if (altIsWhitespace != isWhitespace || (index == lineText.Length - 1))
                    {
                        string fragment = new string(frag.ToArray());
                        int fragWidth = (int)Math.Round(GetEquivalentLength(fragment) * fixWidthChar);
                        int actualLength = (index == lineText.Length - 1) ? lineText.Length : index;
                        previousWidth =
                            (int)Math.Round(GetEquivalentLength(lineText.Substring(0, actualLength - frag.Count)) *
                                            fixWidthChar);
                        fragments.Add(new TextFragment(fragment, new System.Drawing.Rectangle(
                            rectangleX + previousWidth,
                            rectangleY, fragWidth, rectangleHeight)));
                        fragIndex += fragment.Length;
                        frag.Clear();
                        isWhitespace = altIsWhitespace;
                    }
                }

                frag.Add(lineText[index]);
                index++;
            }
        }

        return fragments;
    }

    private static readonly List<char> NarrowChars = new List<char>(new char[]
    {
        ',', '.', ':', ';', '!', '|', '(', ')', '{', '}',
        'l', 'i', 'I', '-', '+', 'f', 't', 'r'
    });

    private static readonly List<char> WideChars = new List<char>(new char[] { '\t', 'm', 'w', 'M', 'W' });

    private static float GetEquivalentLength(string lineText)
    {
        var length = 0F;
        foreach (var c in lineText)
        {
            if (c == ' ')
                length += 0.6F;
            else if (NarrowChars.Contains(c))
                length += 0.5F;
            else if (WideChars.Contains(c) || char.IsUpper(c))
                length += 1.5F;
            else
                length += 1F;
        }

        return length;
    }
}
```

Once the `IOcrConnector` interface is implemented, the JPG to DOCX conversion code snippet looks like this:

```csharp
// Load the source JPG file
RasterImageLoadOptions loadOptions = new RasterImageLoadOptions();
loadOptions.SetOcrConnector(new OcrConnector());

using (Converter converter = new Converter("sample.jpg", (LoadContext loadContext) => loadOptions))
{
    // Set the convert options for DOCX format
    WordProcessingConvertOptions options = new WordProcessingConvertOptions();
    // Convert to DOCX format
    converter.Convert("converted.docx", options);
}
```

Put it simply - you install an OCR processing library, implement the `IOcrConnector` interface, load an image file into the `Converter` class providing the `IOcrConnector` instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## How to edit e-Book file

Path: /editor/java/how-to-edit-ebook/

## Introduction

The GroupDocs.Editor for Java supports 3 formats from the e-Book family: 

1. [MOBI](https://docs.fileformat.com/ebook/mobi/) (MobiPocket),
2. [AZW3](https://docs.fileformat.com/ebook/azw3/), also known as Kindle Format 8 (KF8),
3. [ePub](https://docs.fileformat.com/ebook/epub/) (Electronic Publication).

As for the 23.9 version, the AZW3 and ePub formats are supported on both import (load) and export (save), while MOBI is supported only on import (support of MOBI on export was scheduled for the next release).

Starting from the version [23.9](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-9-release-notes/), the MOBI format is fully supported on export.

## Load e-Book files for edit

GroupDocs.Editor for Java doesn't contain loading options nor for the whole e-Book formats family neither for the specific e-Book formats — users should specify e-Books through file path or byte stream without any loading options at all. 

Code example below shows loading of 3 different e-Books in different formats into the 3 different istances of the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class from different sources:

```java
String mobiPath = "path/to/A-Room-with-a-View-morrison.mobi");
String azw3Path = "path/to/Around the World in 28 Languages.azw3";
String epubPath = "path/to/Alices Adventures in Wonderland.epub";

Editor editorMobi = new Editor(mobiPath);

FileInputStream azw3Stream = new FileInputStream(azw3Path);
Editor editorAzw3 = new Editor(azw3Stream;);

byte[] epubBytes = Files.readAllBytes(Paths.get(epubPath));
ByteArrayInputStream epubStream = new ByteArrayInputStream(epubBytes);
Editor editorEpub = new Editor(epubStream);


// ...
// Don't forget to dispose Editors when work is done
editorMobi.dispose();
editorAzw3.dispose();
editorEpub.dispose();
```

## Edit e-Book files

There is a common edit options for the whole e-Book formats family — a [`EbookEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/) class. The content of this class resembles the content of the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/) class, because [`EbookEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/) contains a subset of options from [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/) — [`getEnablePagination()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnablePagination--) and [`getEnableLanguageInformation()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnableLanguageInformation--) and, as in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/), they are disabled (`false`) by default.

- [`getEnablePagination()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnablePagination--) — allows to enable or disable pagination in the resultant HTML document. By default is disabled (`false`). This option controls how exactly the content of the e-Book will be converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) representation while edited — in the _float_ (`false`) or in the _paged_ (`true`) mode. At the end, this options affects on the structure and representation of the HTML/CSS document, that the end-user edits in the WYSIWYG-editor.
- [`getEnableLanguageInformation()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnableLanguageInformation--) — allows to export (`true`) or do not export (`false`) the language information to the resultant HTML markup. By default is disabled (`false`). This is useful when an e-Book contains text on different languages, and you want to preserve this language-specific metainformation while editing document in the WYSIWYG-editor.

Like for all supported document formats and options, in order to edit the document, user should firstly load it to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class (this step was reviewed in the section above) and then call an [`edit(IEditOptions)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#edit-com.groupdocs.editor.options.IEditOptions-) method. Like for all supported document formats, the [`EbookEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/) are optional and user may call a parameterless [`edit()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#edit--) method — in this case the default [`EbookEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/) will be implicitly applied.

Code example below demonstrates a loading of a single ePub file to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) instance and then editing it twice with two different edit options (default and custom) and generating two different [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instances from an input single ePub file. Then two different HTML markup pieces are generated from these two [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) instances.

```java
String epubPath = "path/to/Alices Adventures in Wonderland.epub";

Editor editorEpub = new Editor(epubPath);

EbookEditOptions defaultEditOptions = new EbookEditOptions();

EbookEditOptions customEditOptions = new EbookEditOptions();
customEditOptions.setEnablePagination(true);
customEditOptions.setEnableLanguageInformation(true);

EditableDocument defaultEdited = editorEpub.edit(defaultEditOptions);
EditableDocument customEdited = editorEpub.edit(customEditOptions);

String embeddedHtmlDefaultEdited = defaultEdited.getEmbeddedHtml();
String embeddedHtmlCustomEdited = customEdited.getEmbeddedHtml();

// ...
// Don't forget to dispose Editor and EditableDocuments when work is done
defaultEdited.dispose();
customEdited.dispose();
editorEpub.dispose();
```

## Save e-Book files after edit

{{< alert style="info" >}}This section describes the saving of e-book files in the GroupDocs.Editor version 23.9 and newer. In using older versions, this description is invalid and source code is not working.{{< /alert >}}

Starting from the version 23.9 the GroupDocs.Editor for Java has obtained an ability to save e-books in all 3 supported formats: MOBI, AZW3, and ePub. Saving of the e-books is performed like for all other formats. When e-book content was edited by the client in the WYSIWYG-editor and was sent back to the server-side, it should be passed to the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/), and then this instance should be passed to the [`com.groupdocs.editor.Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#save-java.lang.String-) method.

The [`Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/#save-java.lang.String-) method obtains an instance of the [`ISaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/isaveoptions/) interface, and for saving in some of the e-book formats the [`EbookSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/) class should be used. This class is common for all supported e-book formats within e-book family: MOBI, AZW3 and ePub. It has one constructor with a mandatory parameter — a desired output format, into which the resultant document will be stored. This specific format should be specified as one of the [`EBookFormats`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/) value: [`Mobi`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/#Mobi), [`Azw3`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/#Azw3), or [`Epub`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/#Epub). Once the instance was created, this format can be obtained and changed using the `OutputFormat` property.

The [`EbookSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/) class has also two another properties: `SplitHeadingLevel` and `ExportDocumentProperties`.

- [`getSplitHeadingLevel()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/#getSplitHeadingLevel--) of the `System.Int32` type controls how (if so) to split the content of e-book onto packages in the resultant file. It doesn't affect the representation of a file, opened in any e-Book reader; rather, it is about an internal structure of the e-Book file. If you dont bother about internal structure of the e-book file, you may leave this property to has the default value (`2`). Setting it to `0` will disable splitting, so all content of the e-Book will be incorporarted into a single package inside the resultant file.
- [`getExportDocumentProperties()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/#getExportDocumentProperties--) of the `System.Boolean` type controls whether to export built-in and custom document properties inside the resultant e-Book file. If you have no plans to reconvert the resultant e-book to some other format, you may leave it intact — the default `false` value disables the exporting of the document properties, so the resultant document will be a little bit smaller in size.

Code example below demonstrates a loading of a single ePub file to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) instance, editing it with default options, and saving to the ePub, AZW3, and Mobi with different options for each one.

```java
String epubPath = "path/to/Alices Adventures in Wonderland.epub";

String epubOutputPath = "Output_ePub.epub";
String azw3OutputPath = "Output_AZW3.azw3";
String mobiOutputPath = "Output_Mobi.azw3";

GroupDocs.Editor.Editor editor = new Editor(epubPath);

//edit with default EbookEditOptions
EditableDocument edited = editor.Edit();

EbookSaveOptions epubSaveOptions = new EbookSaveOptions(EBookFormats.Epub);
epubSaveOptions.setExportDocumentProperties(true);
epubSaveOptions.setSplitHeadingLevel(5);

EbookSaveOptions azw3SaveOptions = new new EbookSaveOptions(EBookFormats.Azw3);
azw3SaveOptions.setSplitHeadingLevel(1);

EbookSaveOptions mobiSaveOptions = new EbookSaveOptions(EBookFormats.Mobi);

editor.save(edited, epubOutputPath, epubSaveOptions);
editor.save(edited, azw3OutputPath, azw3SaveOptions);
editor.save(edited, mobiOutputPath, mobiSaveOptions);

// ...
// Don't forget to dispose Editor and EditableDocument when work is done
edited.dispose();
editor.dispose();
```

## Extracting metainfo from e-Book files

Like for all supported formats, the GroupDocs.Editor for Java provides an ability to detected the document metainfo for all supported e-Book formats by using a [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method of the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class. In case when a valid e-Book was loaded into the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) instance, a [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) will return an instance of a [`EbookDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/) class, which inherits from [`IDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/) interface, which, in turn, defines 4 properties: [`getFormat()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/#getFormat--), [`getPageCount()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/#getPageCount--), [`getSize()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/#getSize--), and [`isEncrypted()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/#isEncrypted--).

- [`getFormat()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#getFormat--) property returns a [`EBookFormats`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/) struct, which for the e-Books can be a `Mobi`, `Azw3`, or `Epub` value.
- [`getPageCount()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#getPageCount--) property returns an **approximate** number of pages in case of MOBI or AZW3 or a number of chapters in case of ePub. For the Mobi and AZW3, it is approximate, because Mobi/AZW3 format internally is a set of HTML documents (chapters), which are not separated on pages and even have no strict page dimensions, which allows to split content on page blocks and thus calculate the number of pages. This decision was made by Mobi/AZW3 format designers intentionally to allows variable page size (and count) on different devices — from FullHD displays to smartphones. So, for returning a page count for a Mobi/AZW3 document, GroupDocs.Editor assumes standard A4 page size in a portrait orientation, splits existing document content on such "papers", and then calculates its count. So the returning number should be treated very carefully and approximately, users should not rely on it.
- [`getSize()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#getSize--) property returns a number of bytes of e-Book file.
- [`isEncrypted()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#isEncrypted--) property always returns a `false` value, because e-Books cannot be encrypted with password, like PDF or Office Open XML.

Code example below demonstrates a loading of 3 different e-Books in different formats (Mobi, AZW3 and ePub) into the 3 different istances of the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class and then extracting information about them and checking it with NUnit.

```java
String mobiPath = "Ebook.mobi");
String azw3Path = "Ebook.azw3";
String epubPath = "Ebook.epub";

Editor editorMobi = new Editor(mobiPath);
Editor editorAzw3 = new Editor(azw3Path);
Editor editorEpub = new Editor(epubPath);

IDocumentInfo mobiInfo = editorMobi.getDocumentInfo(null);
IDocumentInfo azw3Info = editorAzw3.getDocumentInfo(null);
IDocumentInfo epubInfo = editorEpub.getDocumentInfo(null);

Assert.assertEquals(EBookFormats.Mobi, mobiInfo.getFormat());
Assert.assertEquals(EBookFormats.Azw3, azw3Info.getFormat());
Assert.assertEquals(EBookFormats.Epub, epubInfo.getFormat());

// ...
// Don't forget to dispose Editors when work is done
editorMobi.dispose();
editorAzw3.dispose();
editorEpub.dispose();
```










---

## How to edit e-Book file

Path: /editor/net/how-to-edit-ebook/

## Introduction

For the [version 22.9](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-9-release-notes/), the GroupDocs.Editor for .NET supports 3 formats from the e-Book family: 

1. [MOBI](https://docs.fileformat.com/ebook/mobi/) (MobiPocket),
2. [AZW3](https://docs.fileformat.com/ebook/azw3/), also known as Kindle Format 8 (KF8),
3. [ePub](https://docs.fileformat.com/ebook/epub/) (Electronic Publication).

As for the 22.9 version, the AZW3 and ePub formats are supported on both import (load) and export (save), while MOBI is supported only on import (support of MOBI on export was scheduled for the next release).

Starting from the version [23.4](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-4-release-notes/), the MOBI format is fully supported on export.

## Load e-Book files for edit

GroupDocs.Editor for .NET doesn't contain loading options nor for the whole e-Book formats family neither for the specific e-Book formats — users should specify e-Books through file path or byte stream without any loading options at all. 

Code example below shows loading of 3 different e-Books in different formats into the 3 different istances of the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class from different sources:

```csharp
string mobiPath = "path/to/A-Room-with-a-View-morrison.mobi");
string azw3Path = "path/to/Around the World in 28 Languages.azw3";
string epubPath = "path/to/Alices Adventures in Wonderland.epub";

GroupDocs.Editor.Editor editorMobi = new Editor(mobiPath);

FileStream azw3Stream = File.OpenRead(azw3Path);
GroupDocs.Editor.Editor editorAzw3 = new Editor(azw3Stream);

byte[] epubBytes = File.ReadAllBytes(epubPath);
MemoryStream epubStream = new MemoryStream(epubBytes);
GroupDocs.Editor.Editor editorEpub = new Editor(epubStream);


// ...
// Don't forget to dispose Editors when work is done
editorMobi.Dispose();
editorAzw3.Dispose();
editorEpub.Dispose();
```

## Edit e-Book files

There is a common edit options for the whole e-Book formats family — a [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) class. The content of this class resembles the content of the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class, because [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) contains a subset of options from [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) — [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablepagination) and [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablelanguageinformation) and, as in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions), they are disabled (`false`) by default.

- [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablepagination) — allows to enable or disable pagination in the resultant HTML document. By default is disabled (`false`). This option controls how exactly the content of the e-Book will be converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) representation while edited — in the _float_ (`false`) or in the _paged_ (`true`) mode. At the end, this options affects on the structure and representation of the HTML/CSS document, that the end-user edits in the WYSIWYG-editor.
- [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablelanguageinformation) — allows to export (`true`) or do not export (`false`) the language information to the resultant HTML markup. By default is disabled (`false`). This is useful when an e-Book contains text on different languages, and you want to preserve this language-specific metainformation while editing document in the WYSIWYG-editor.

Like for all supported document formats and options, in order to edit the document, user should firstly load it to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class (this step was reviewed in the section above) and then call an [`Edit(IEditOptions)`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit/#edit) method. Like for all supported document formats, the [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) are optional and user may call a parameterless [`Edit()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) method — in this case the default [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) will be implicitly applied.

Code example below demonstrates a loading of a single ePub file to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance and then editing it twice with two different edit options (default and custom) and generating two different [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instances from an input single ePub file. Then two different HTML markup pieces are generated from these two [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instances.

```csharp
string epubPath = "path/to/Alices Adventures in Wonderland.epub";

GroupDocs.Editor.Editor editorEpub = new Editor(epubPath);

Options.EbookEditOptions defaultEditOptions = new Options.EbookEditOptions();

Options.EbookEditOptions customEditOptions = new Options.EbookEditOptions();
customEditOptions.EnablePagination = true;
customEditOptions.EnableLanguageInformation = true;

EditableDocument defaultEdited = editorEpub.Edit(defaultEditOptions);
EditableDocument customEdited = editorEpub.Edit(customEditOptions);

string embeddedHtmlDefaultEdited = defaultEdited.GetEmbeddedHtml();
string embeddedHtmlCustomEdited = customEdited.GetEmbeddedHtml();

// ...
// Don't forget to dispose Editor and EditableDocuments when work is done
defaultEdited.Dispose();
customEdited.Dispose();
editorEpub.Dispose();
```

## Save e-Book files after edit

{{< alert style="info" >}}This section describes the saving of e-book files in the GroupDocs.Editor version 23.4 and newer. In using older versions, this description is invalid and source code is not working.{{< /alert >}}

Starting from the version 23.4 the GroupDocs.Editor for .NET has obtained an ability to save e-books in all 3 supported formats: MOBI, AZW3, and ePub. Saving of the e-books is performed like for all other formats. When e-book content was edited by the client in the WYSIWYG-editor and was sent back to the server-side, it should be passed to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), and then this instance should be passed to the [`GroupDocs.Editor.Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

The [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method obtains an instance of the [`ISaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/isaveoptions/) interface, and for saving in some of the e-book formats the [`EbookSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions) class should be used. This class is common for all supported e-book formats within e-book family: MOBI, AZW3 and ePub. It has one constructor with a mandatory parameter — a desired output format, into which the resultant document will be stored. This specific format should be specified as one of the [`Formats.EBookFormats`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats/) value: [`Mobi`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats/mobi/), [`Azw3`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats/azw3/), or [`Epub`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats/epub/). Once the instance was created, this format can be obtained and changed using the `OutputFormat` property.

The [`EbookSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions) class has also two another properties: `SplitHeadingLevel` and `ExportDocumentProperties`.

- [`SplitHeadingLevel`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions/splitheadinglevel/) of the `System.Int32` type controls how (if so) to split the content of e-book onto packages in the resultant file. It doesn't affect the representation of a file, opened in any e-Book reader; rather, it is about an internal structure of the e-Book file. If you dont bother about internal structure of the e-book file, you may leave this property to has the default value (`2`). Setting it to `0` will disable splitting, so all content of the e-Book will be incorporarted into a single package inside the resultant file.
- [`ExportDocumentProperties`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions/exportdocumentproperties/) of the `System.Boolean` type controls whether to export built-in and custom document properties inside the resultant e-Book file. If you have no plans to reconvert the resultant e-book to some other format, you may leave it intact — the default `false` value disables the exporting of the document properties, so the resultant document will be a little bit smaller in size.

Code example below demonstrates a loading of a single ePub file to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance, editing it with default options, and saving to the ePub, AZW3, and Mobi with different options for each one.

```csharp
string epubPath = Path.Combine(Common.TestHelper.EpubFolder, "Alices Adventures in Wonderland.epub");

string epubOutputPath = "Output_ePub.epub";
string azw3OutputPath = "Output_AZW3.azw3";
string mobiOutputPath = "Output_Mobi.azw3";

GroupDocs.Editor.Editor editor = new Editor(epubPath);

//edit with default EbookEditOptions
EditableDocument edited = editor.Edit();

Options.EbookSaveOptions epubSaveOptions = new Options.EbookSaveOptions(Formats.EBookFormats.Epub);
epubSaveOptions.ExportDocumentProperties = true;
epubSaveOptions.SplitHeadingLevel = 5;

Options.EbookSaveOptions azw3SaveOptions = new Options.EbookSaveOptions(Formats.EBookFormats.Azw3);
azw3SaveOptions.SplitHeadingLevel = 1;

Options.EbookSaveOptions mobiSaveOptions = new Options.EbookSaveOptions(Formats.EBookFormats.Mobi);

editor.Save(edited, epubOutputPath, epubSaveOptions);
editor.Save(edited, azw3OutputPath, azw3SaveOptions);
editor.Save(edited, mobiOutputPath, mobiSaveOptions);

// ...
// Don't forget to dispose Editor and EditableDocument when work is done
edited.Dispose();
editor.Dispose();
```

### Saving e-Book files before version 23.4

{{< alert style="info" >}}This section describes the saving of e-book files in the GroupDocs.Editor versions 22.9 - 23.2. From the version 23.4 (inclusive) and newer this description is invalid and source code is not working.{{< /alert >}}

Starting from the version 22.9 and before the version 23.4 the GroupDocs.Editor for .NET was able to save e-books only in AZW3 and ePub formats, while MOBI was not supported on the export. Due to this fact and unlike other format families and unlike a single [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) class, which is common for all e-Book formats, there was no single options class for saving into different e-Book formats at that moment. And because the GroupDocs.Editor for .NET has supported saving into AZW3 and ePub, there were distinct save options classes for each of these two formats:

- [`EpubSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/epubsaveoptions) - for saving into ePub format
- [`Azw3SaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/azw3saveoptions) - for saving into AZW3 format

These classes had one common property - a `SplitHeadingLevel` of the `System.Int32` type. This property controls how (if so) to split the content of AZW3 or ePub e-book onto packages in the resultant file. It doesn't affect the representation of a file, opened in any e-Book reader; rather, it is about an internal structure of the e-Book file. If you dont bother about internal structure of the ePub or AZW3 file, you may leave this property to has the default value.

[`EpubSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/epubsaveoptions) also has an `ExportDocumentProperties` boolean property — it controls whether to export built-in and custom document properties inside the resultant IDPF ePub e-Book. If you have no plans to reconvert the resultant ePub to some other format, you may leave it intact — the default `false` value disables the exporting of the document properties, so the resultant document will be a little bit smaller in size.

Code example below demonstrates a loading of a single ePub file to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance, editing it with default options, and saving to the ePub and AZW3 with different options for each one.

```csharp
string epubPath = "path/to/Alices Adventures in Wonderland.epub";
string epubOutputPath = "Output_ePub.epub";
string azw3OutputPath = "Output_AZW3.azw3";

GroupDocs.Editor.Editor editor = new Editor(epubPath);

//edit with default EbookEditOptions
EditableDocument edited = editor.Edit();

Options.EpubSaveOptions epubSaveOptions = new Options.EpubSaveOptions();
epubSaveOptions.ExportDocumentProperties = true;
epubSaveOptions.SplitHeadingLevel = 5;

Options.Azw3SaveOptions azw3SaveOptions = new Options.Azw3SaveOptions();
azw3SaveOptions.SplitHeadingLevel = 1;

editor.Save(edited, epubOutputPath, epubSaveOptions);
editor.Save(edited, azw3OutputPath, azw3SaveOptions);

// ...
// Don't forget to dispose Editor and EditableDocument when work is done
edited.Dispose();
editor.Dispose();
```

## Extracting metainfo from e-Book files

Like for all supported formats, the GroupDocs.Editor for .NET provides an ability to detected the document metainfo for all supported e-Book formats by using a [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) method of the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class. In case when a valid e-Book was loaded into the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance, a [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) will return an instance of a [`Metadata.EbookDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo) class, which inherits from [`IDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) interface, which, in turn, defines 4 properties: [`Format`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/format), [`PageCount`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/pagecount), [`Size`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/size), and [`IsEncrypted`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo/isencrypted).

- [`Format`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/format) property returns a [`Formats.EBookFormats`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats) struct, which for the e-Books can be a `Mobi`, `Azw3`, or `Epub` value.
- [`PageCount`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/pagecount) property returns an **approximate** number of pages in case of MOBI or AZW3 or a number of chapters in case of ePub. For the Mobi and AZW3, it is approximate, because Mobi/AZW3 format internally is a set of HTML documents (chapters), which are not separated on pages and even have no strict page dimensions, which allows to split content on page blocks and thus calculate the number of pages. This decision was made by Mobi/AZW3 format designers intentionally to allows variable page size (and count) on different devices — from FullHD displays to smartphones. So, for returning a page count for a Mobi/AZW3 document, GroupDocs.Editor assumes standard A4 page size in a portrait orientation, splits existing document content on such "papers", and then calculates its count. So the returning number should be treated very carefully and approximately, users should not rely on it.
- [`Size`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/size) property returns a number of bytes of e-Book file.
- [`IsEncrypted`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/isencrypted) property always returns a `false` value, because e-Books cannot be encrypted with password, like PDF or Office Open XML.

Code example below demonstrates a loading of 3 different e-Books in different formats (Mobi, AZW3 and ePub) into the 3 different istances of the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class and then extracting information about them and checking it with NUnit.

```csharp
string mobiPath = "Ebook.mobi");
string azw3Path = "Ebook.azw3";
string epubPath = "Ebook.epub";

GroupDocs.Editor.Editor editorMobi = new Editor(mobiPath);
GroupDocs.Editor.Editor editorAzw3 = new Editor(azw3Path);
GroupDocs.Editor.Editor editorEpub = new Editor(epubPath);

GroupDocs.Editor.Metadata.IDocumentInfo mobiInfo = editorMobi.GetDocumentInfo(null);
GroupDocs.Editor.Metadata.IDocumentInfo azw3Info = editorAzw3.GetDocumentInfo(null);
GroupDocs.Editor.Metadata.IDocumentInfo epubInfo = editorEpub.GetDocumentInfo(null);

Assert.AreEqual(Formats.EBookFormats.Mobi, mobiInfo.Format);
Assert.AreEqual(Formats.EBookFormats.Azw3, azw3Info.Format);
Assert.AreEqual(Formats.EBookFormats.Epub, epubInfo.Format);

// ...
// Don't forget to dispose Editors when work is done
editorMobi.Dispose();
editorAzw3.Dispose();
editorEpub.Dispose();
```










---

## How to edit Mobi file

Path: /editor/java/how-to-edit-mobi-file/

## Introduction

Mobi format is an E-Book format, developed by the French company MobiPocket and is based on XML. E-Books in this format can contain text with rich formatting, images, and different annotations like bookmarks, notes, highlights, corrections and so on. Mobi books can have a DRM protection.

Starting from the [version 23.9](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-9-release-notes/) the GroupDocs.Editor for Java is able to save (export) documents in the Mobi format, so from this version it can be said that Mobi is fully supported: on import, export and auto-detection.

## Loading Mobi file for edit

Despite of a distinct format, which doesn't belong to any of existing format families, Mobi has no dedicated loading options. So for loading it into the instance of the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class, users should simply specify a path to the Mobi file or a stream with its content in the constructor:

```java
String inputMobiPath = "C://input/book.mobi";
Editor editorFromPath = new Editor(inputMobiPath);
  
FileInputStream  inputMobiStream = new FileInputStream("C://input/book.mobi");
Editor editorFromStream = new Editor(inputMobiStream);
```

There is no loading options, because Mobi has nothing to tune-up during loading, — it cannot have a password protection, and can be processed only in one way.

## Editing Mobi file

Because Mobi belongs to the e-Book format family, it utilize common edit options for all e-Book formats — an [`EbookEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/). This class may be described as a truncated version of a [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/) class, because [`EbookEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/) contains a subset of options from [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/) — [`getEnablePagination()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnablePagination--) and [`getEnableLanguageInformation()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnableLanguageInformation--) and, as in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/), they are disabled (`false`) by default:

```java
public boolean getEnablePagination();
public void setEnablePagination(boolean value);
  
public boolean getEnableLanguageInformation();
public void setEnableLanguageInformation(boolean value);
```

They have exactly the same meaning as their "siblings" from [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/wordprocessingeditoptions/). [`getEnablePagination()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnablePagination--) allows to switch between float and paginal mode in the resultant HTML document. [`getEnableLanguageInformation()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebookeditoptions/#getEnableLanguageInformation--) allows to enable exporting language information in HTML. This is very useful for books, which have parts of text, written on different languages.

Example of usage is below (let's assume that [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) instance with loaded Mobi document is already created):

```java
EbookEditOptions editOptions = new EbookEditOptions();
editOptions.setEnablePagination(true);
editOptions.setEnableLanguageInformation(true);
EditableDocument opened = editor.edit(editOptions);
{
    //save it or pass to the WYSIWYG-editor
}
```

## Save Mobi file after edit

Before the [version 23.4](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-9-release-notes/), the GroupDocs.Editor for Java was able only to load and edit the Mobi documents, but not to save (export) in the Mobi format. In other words, it was able to open and edit the Mobi document, and then save the edited document in some other format, but not in the Mobi. And in version 23.9 the export in the Mobi format was finally implemented.

For all the format families the saving procedure is the same — it is required to obtain a content of the edited document on the server-side, create an instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument/) from it, and then pass it to the [`com.groupdocs.editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) instance method. And because the Mobi format belongs to the e-Book formats family, in order to save the document in the Mobi format a [`EbookSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/) class is required.

This class has a [mandatory constructor with a single parameter](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/) — a desired [e-Book format](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/). For the Mobi it should be a [`EBookFormats.Mobi`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/#Mobi). All other parameters in the EbookSaveOptions class are in fact optional, but nevertheless described below:

- [`getSplitHeadingLevel()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/#getSplitHeadingLevel--) of the `System.Int32` type controls an internal structure of the generated Mobi file: whether its internal content is divided onto packages and if yes, then how. This parameter exists because a content of the Mobi file is stored in the packages, usually, a package per chapter. And some users may want to control the policy of distribution of the content into the packages. By default its parameter is “`2`” — the most optimal.
- [`ExportDocumentProperties`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/#getExportDocumentProperties--) of the `System.Boolean` type also has a relation to the internal structure of the Mobi file — it decides whether to embed the built-in and custom document properties inside the resultant Mobi file (`true`) or not (`false`). By default is `false` — do not embed.

Concluding: in order to save the edited document in the Mobi format, the user should create an instance of the [`EbookSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/ebooksaveoptions/) class with [`EBookFormats.Mobi`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/#Mobi) argument in the constructor parameter, and then pass this instance to the [`Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method along with other arguments.

The code example below demonstrates the full roundtrip: opening a Mobi document, editing it, and saving the edited version to the Mobi format.

```java
//Create an Editor instance and load an input Mobi file
Editor editor = new Editor("Input.mobi");

//Create edit options
EbookEditOptions editOptions = new EbookEditOptions();

//Edit the Mobi document and obtain
EditableDocument doc = editor.edit(editOptions);

//Send EditableDocument to the client-side, edit it there, and obtain an edited version

//Create Mobi save options
EbookSaveOptions saveOptions = new EbookSaveOptions(EBookFormats.Mobi);
saveOptions.setExportDocumentProperties(true);//Tune save options

//Save the edited document in a Mobi format
editor.save(doc, "Output.mobi", saveOptions);

//Dispose document and Editor instances
doc.dispose();
editor.dispose();
```

## Detecting Mobi file

As for documents of all supporting types, Mobi documents can be detected using a [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) method of the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class. In case when a valid Mobi document was loaded into the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) instance, a [`getDocumentInfo()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#getDocumentInfo-java.lang.String-) will return an instance of a [`EbookDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/) class, which inherits from [`IDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo/) interface, which, in turn, defines 4 properties: `getFormat()`, `getPageCount()`, `getSize()`, and `isEncrypted()`.

- [`getFormat()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#getFormat--) property returns a [`EBookFormats`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/ebookformats/) struct, which for the files with a `*.mobi` extension can have a `Mobi` or `Azw3` value.
- [`getPageCount()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#getPageCount--) property returns an **approximate** number of pages in case of MOBI or AZW3 or a number of chapters in case of ePub. For the Mobi, it is approximate, because Mobi format internally is a set of HTML documents (chapters), which are not separated on pages and even have no strict page dimensions, which allows to split content on page blocks and thus calculate the number of pages. This decision was made by Mobi format designers intentionally to allows variable page size (and count) on different devices — from FullHD displays to smartphones. So, for returning a page count for a Mobi document, GroupDocs.Editor assumes standard A4 page size in a portrait orientation, splits existing document content on such "papers", and then calculates its count. So the returning number should be treated very carefully and approximately, users should not rely on it.
- [`getSize()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#getSize--) property returns a number of bytes of a Mobi document.
- [`isEncrypted()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/ebookdocumentinfo/#isEncrypted--) property always returns a `false` value, because Mobi documents cannot be encrypted with password, like PDF or Office Open XML.

---

## How to edit Mobi file

Path: /editor/net/how-to-edit-mobi-file/

## Introduction

Mobi format is an E-Book format, developed by the French company MobiPocket and is based on XML. E-Books in this format can contain text with rich formatting, images, and different annotations like bookmarks, notes, highlights, corrections and so on. Mobi books can have a DRM protection.

Starting from the [version 20.7](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-20-7-release-notes/), the GroupDocs.Editor for .NET is able to open (load) Mobi documents for editing. However, on that moment a saving _into_ Mobi was not available, so users were forced to choose some other format (the most likely AZW3 or ePub) in order to save edited Mobi document.

Starting from the [version 22.7](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-7-release-notes/) the GroupDocs.Editor is able to edit the e-books in [AZW3 format](https://docs.fileformat.com/ebook/azw3/), also known as Kindle Format 8 (KF8), whech may be considered as a successor to the Mobi. Unlike the MOBI, the AZW3 are supported on import (since version 22.7) and export (since version 22.9).

Starting from the [version 23.4](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-4-release-notes/) the GroupDocs.Editor for .NET is able to save (export) documents in the Mobi format, so from this version it can be said that Mobi is fully supported: on import, export and auto-detection.

## Loading Mobi file for edit

Despite of a distinct format, which doesn't belong to any of existing format families, Mobi has no dedicated loading options. So for loading it into the instance of the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class, users should simply specify a path to the Mobi file or a stream with its content in the constructor:

```csharp
string inputMobiPath = "C://input/book.mobi";
Editor editorFromPath = new Editor(inputMobiPath);
  
FileStream inputMobiStream = File.OpenRead("C://input/book.mobi");
Editor editorFromStream = new Editor(inputMobiStream);
```

There is no loading options, because Mobi has nothing to tune-up during loading, — it cannot have a password protection, and can be processed only in one way.

## Editing Mobi file

Because Mobi belongs to the e-Book format family, it utilize common edit options for all e-Book formats — an [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions). This class may be described as a truncated version of a [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) class, because [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) contains a subset of options from [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions) — [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablepagination) and [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablelanguageinformation) and, as in the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions), they are disabled (`false`) by default:

```csharp
public bool EnablePagination { get; set; }
  
public bool EnableLanguageInformation { get; set; }
```

They have exactly the same meaning as their "siblings" from [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/wordprocessingeditoptions). [`EnablePagination`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablepagination) allows to switch between float and paginal mode in the resultant HTML document. [`EnableLanguageInformation`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions/enablelanguageinformation) allows to enable exporting language information in HTML. This is very useful for books, which have parts of text, written on different languages.

Example of usage is below (let's assume that [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance with loaded Mobi document is already created):

```csharp
Options.EbookEditOptions editOptions = new Options.EbookEditOptions();
editOptions.EnablePagination = true;
editOptions.EnableLanguageInformation = true;
using (EditableDocument opened = editor.Edit(editOptions))
{
    //save it or pass to the WYSIWYG-editor
}
```

{{< alert style="info" >}}The [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions) class was firstly introduced in the GroupDocs.Editor for .NET [version 22.9](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-9-release-notes/). However, prior this version, there was a class `MobiEditOptions`, which was designed especially for the Mobi format. In the 22.9 version of GroupDocs.Editor for .NET this `MobiEditOptions` class was removed in favor to the more generalized [`EbookEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebookeditoptions), so when updating from the 22.7 or older versions to the 22.9 or newer, please update the class name accordingly. All class members in these both classes are identical.{{< /alert >}}

## Save Mobi file after edit

Starting from the [version 20.7](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-20-7-release-notes/), and before the [version 23.4](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-23-4-release-notes/), the GroupDocs.Editor for .NET was able only to load and edit the Mobi documents, but not to save (export) in the Mobi format. In other words, it was able to open and edit the Mobi document, and then save the edited document in some other format, but not in the Mobi. And in version 23.4 the export in the Mobi format was finally implemented.

For all the format families the saving procedure is the same — it is required to obtain a content of the edited document on the server-side, create an instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) from it, and then pass it to the [`GroupDocs.Editor.Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) instance method. And because the Mobi format belongs to the e-Book formats family, in order to save the document in the Mobi format a [`EbookSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions) class is required.

This class has a [mandatory constructor with a single parameter](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions/ebooksaveoptions/) — a desired [e-Book format](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats/). For the Mobi it should be a [`EBookFormats.Mobi`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats/mobi/). All other parameters in the EbookSaveOptions class are in fact optional, but nevertheless described below:

- [`SplitHeadingLevel`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions/splitheadinglevel/) of the `System.Int32` type controls an internal structure of the generated Mobi file: whether its internal content is divided onto packages and if yes, then how. This parameter exists because a content of the Mobi file is stored in the packages, usually, a package per chapter. And some users may want to control the policy of distribution of the content into the packages. By default its parameter is “`2`” — the most optimal.
- [`ExportDocumentProperties`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions/exportdocumentproperties/) of the `System.Boolean` type also has a relation to the internal structure of the Mobi file — it decides whether to embed the built-in and custom document properties inside the resultant Mobi file (`true`) or not (`false`). By default is `false` — do not embed.

Concluding: in order to save the edited document in the Mobi format, the user should create an instance of the [`EbookSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/ebooksaveoptions) class with [`EBookFormats.Mobi`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats/mobi/) argument in the constructor parameter, and then pass this instance to the [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method along with other arguments.

The code example below demonstrates the full roundtrip: opening a Mobi document, editing it, and saving the edited version to the Mobi format.

```csharp
//Create an Editor instance and load an input Mobi file
Editor editor = new Editor("Input.mobi");

//Create edit options
Options.EbookEditOptions editOptions = new EbookEditOptions();

//Edit the Mobi document and obtain
EditableDocument doc = editor.Edit(editOptions);

//Send EditableDocument to the client-side, edit it there, and obtain an edited version

//Create Mobi save options
Options.EbookSaveOptions saveOptions = new EbookSaveOptions(Formats.EBookFormats.Mobi);
saveOptions.ExportDocumentProperties = true;//Tune save options

//Save the edited document in a Mobi format
editor.Save(doc, "Output.mobi", saveOptions);

//Dispose document and Editor instances
doc.Dispose();
editor.Dispose();
```

## Detecting Mobi file

As for documents of all supporting types, Mobi documents can be detected using a [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) method of the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class. In case when a valid Mobi document was loaded into the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance, a [`GetDocumentInfo()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) will return an instance of a [`Metadata.EbookDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo) class, which inherits from [`IDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) interface, which, in turn, defines 4 properties: `Format`, `PageCount`, `Size`, and `IsEncrypted`.

- [`Format`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/format) property returns a [`Formats.EBookFormats`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats) struct, which for the files with a `*.mobi` extension can have a `Mobi` or `Azw3` value.
- [`PageCount`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/pagecount) property returns an **approximate** number of pages in case of MOBI or AZW3 or a number of chapters in case of ePub. For the Mobi, it is approximate, because Mobi format internally is a set of HTML documents (chapters), which are not separated on pages and even have no strict page dimensions, which allows to split content on page blocks and thus calculate the number of pages. This decision was made by Mobi format designers intentionally to allows variable page size (and count) on different devices — from FullHD displays to smartphones. So, for returning a page count for a Mobi document, GroupDocs.Editor assumes standard A4 page size in a portrait orientation, splits existing document content on such "papers", and then calculates its count. So the returning number should be treated very carefully and approximately, users should not rely on it.
- [`Size`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/size) property returns a number of bytes of a Mobi document.
- [`IsEncrypted`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/ebookdocumentinfo/isencrypted) property always returns a `false` value, because Mobi documents cannot be encrypted with password, like PDF or Office Open XML.

---

## How to Edit MOBI File

Path: /editor/nodejs-java/how-to-edit-mobi-file/


## Introduction

The MOBI format is an e-book format developed by the French company MobiPocket and is based on XML. E-books in this format can contain text with rich formatting, images, and different annotations like bookmarks, notes, highlights, corrections, and more. MOBI books can have DRM protection.

Starting from [version 24.6](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node.js-via-java-24-6-release-notes/), **GroupDocs.Editor for Node.js via Java** is able to save (export) documents in the MOBI format. Therefore, MOBI is fully supported: on import, export, and auto-detection.

## Loading MOBI File for Edit

Despite being a distinct format that doesn't belong to any existing format families, MOBI has no dedicated loading options. So, to load it into an instance of the [`Editor`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor) class, you should simply specify a path to the MOBI file or a stream with its content in the constructor:

```javascript
// Import necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Loading from path
const inputMobiPath = 'C://input/book.mobi';
const editorFromPath = new groupdocsEditor.Editor(inputMobiPath);

// Loading from stream
const inputMobiStream = fs.createReadStream('C://input/book.mobi');
const editorFromStream = new groupdocsEditor.Editor(inputMobiStream);
```

There are no loading options because MOBI has nothing to tune during loading—it cannot have password protection and can be processed only in one way.

## Editing MOBI File

Because MOBI belongs to the e-book format family, it utilizes common edit options for all e-book formats—the [`EbookEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/EbookEditOptions) class. This class can be described as a truncated version of the [`WordProcessingEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/WordProcessingEditOptions) class because `EbookEditOptions` contains a subset of options from `WordProcessingEditOptions`—[`getEnablePagination()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/EbookEditOptions#getEnablePagination--) and [`getEnableLanguageInformation()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/EbookEditOptions#getEnableLanguageInformation--). As in `WordProcessingEditOptions`, they are disabled (`false`) by default:

```javascript
// Properties of EbookEditOptions
getEnablePagination();
setEnablePagination(value);

getEnableLanguageInformation();
setEnableLanguageInformation(value);
```

They have exactly the same meaning as their counterparts from `WordProcessingEditOptions`:

- `getEnablePagination()` allows switching between flow and paginal mode in the resultant HTML document.
- `getEnableLanguageInformation()` enables exporting language information in HTML, which is useful for books that have parts of text written in different languages.

Example of usage (assuming that an `Editor` instance with a loaded MOBI document is already created):

```javascript
// Create edit options
const editOptions = new groupdocsEditor.EbookEditOptions();
editOptions.setEnablePagination(true);
editOptions.setEnableLanguageInformation(true);

// Edit the MOBI document
const opened = editor.edit(editOptions);

// Now, you can save it or pass it to the WYSIWYG editor
```

## Saving MOBI File After Edit

Before [version 24.6](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2024/groupdocs-editor-for-node.js-via-java-24-6-release-notes/), **GroupDocs.Editor for Node.js via Java** was only able to load and edit MOBI documents but not save (export) them in the MOBI format. In other words, it was able to open and edit the MOBI document and then save the edited document in some other format but not in MOBI. In version 23.9, export in the MOBI format was finally implemented.

For all the format families, the saving procedure is the same—you need to obtain the content of the edited document on the server-side, create an instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/EditableDocument) from it, and then pass it to the `editor.save()` method. Because the MOBI format belongs to the e-book formats family, to save the document in the MOBI format, an instance of the [`EbookSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/EbookSaveOptions) class is required.

This class has a [mandatory constructor with a single parameter](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/EbookSaveOptions#EbookSaveOptions-com.groupdocs.editor.formats.EBookFormats-)—a desired [e-book format](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats/EBookFormats). For MOBI, it should be `EBookFormats.Mobi`. All other parameters in the `EbookSaveOptions` class are optional but are described below:

- [`getSplitHeadingLevel()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/EbookSaveOptions#getSplitHeadingLevel--) of type `Number` controls the internal structure of the generated MOBI file—whether its internal content is divided into packages and, if yes, how. This parameter exists because the content of the MOBI file is stored in packages, usually one package per chapter. Some users may want to control the policy of distributing content into packages. By default, this parameter is `2`, which is optimal.
- [`getExportDocumentProperties()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options/EbookSaveOptions#getExportDocumentProperties--) of type `Boolean` decides whether to embed the built-in and custom document properties inside the resultant MOBI file (`true`) or not (`false`). By default, it is `false`—do not embed.

In summary, to save the edited document in the MOBI format, you should create an instance of the `EbookSaveOptions` class with `EBookFormats.Mobi` as the constructor parameter and then pass this instance to the `editor.save()` method along with other arguments.

The code example below demonstrates the full round-trip: opening a MOBI document, editing it, and saving the edited version to the MOBI format.

```javascript
// Import necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Create an Editor instance and load an input MOBI file
const editor = new groupdocsEditor.Editor('Input.mobi');

// Create edit options
const editOptions = new groupdocsEditor.EbookEditOptions();

// Edit the MOBI document and obtain EditableDocument
const doc = editor.edit(editOptions);

// Send EditableDocument to the client-side, edit it there, and obtain an edited version

// For demonstration, let's assume the edited HTML content is obtained
const editedHtmlContent = doc.getContent(); // This should be the edited content from the client-side

// Create an EditableDocument from the edited HTML content
const editedDocument = groupdocsEditor.EditableDocument.fromMarkup(editedHtmlContent, null);

// Create MOBI save options
const saveOptions = new groupdocsEditor.EbookSaveOptions(groupdocsEditor.EBookFormats.Mobi);
saveOptions.setExportDocumentProperties(true); // Tune save options

// Save the edited document in MOBI format
editor.save(editedDocument, 'Output.mobi', saveOptions);

// Dispose of document and Editor instances
doc.dispose();
editedDocument.dispose();
editor.dispose();
```

## Detecting MOBI File

As with documents of all supported types, MOBI documents can be detected using the [`getDocumentInfo()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#getDocumentInfo--) method of the [`Editor`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor) class. When a valid MOBI document is loaded into the `Editor` instance, `getDocumentInfo()` will return an instance of the [`EbookDocumentInfo`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/EbookDocumentInfo) class, which inherits from the [`IDocumentInfo`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/IDocumentInfo) interface. This interface defines four properties: `getFormat()`, `getPageCount()`, `getSize()`, and `isEncrypted()`.

- **[`getFormat()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/EbookDocumentInfo#getFormat--):** Returns an `EBookFormats` struct, which for files with a `.mobi` extension can have a `Mobi` or `Azw3` value.
- **[`getPageCount()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/EbookDocumentInfo#getPageCount--):** Returns an **approximate** number of pages in the case of MOBI or AZW3, or a number of chapters in the case of EPUB. For MOBI, it is approximate because the MOBI format internally is a set of HTML documents (chapters), which are not separated into pages and even have no strict page dimensions. This design allows variable page size (and count) on different devices—from Full HD displays to smartphones. Therefore, to return a page count for a MOBI document, GroupDocs.Editor assumes a standard A4 page size in portrait orientation, splits existing document content into such "pages," and then calculates the count. The returned number should be treated carefully and approximately; users should not rely on it.
- **[`getSize()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/EbookDocumentInfo#getSize--):** Returns the number of bytes of a MOBI document.
- **[`isEncrypted()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata/EbookDocumentInfo#isEncrypted--):** Always returns `false` because MOBI documents cannot be encrypted with a password like PDF or Office Open XML.

Example of detecting a MOBI file:

```javascript
// Import necessary modules
const groupdocsEditor = require('@groupdocs/groupdocs.editor');
const fs = require('fs');

// Load the MOBI file into the Editor
const editor = new groupdocsEditor.Editor('Input.mobi');

// Get document info
const documentInfo = editor.getDocumentInfo();

console.log('Format:', documentInfo.getFormat().getName());
console.log('Page Count:', documentInfo.getPageCount());
console.log('Size (bytes):', documentInfo.getSize());
console.log('Is Encrypted:', documentInfo.isEncrypted());

// Dispose of the editor instance
editor.dispose();
```

## Conclusion

In this article, we've demonstrated how to edit MOBI files using **GroupDocs.Editor for Node.js via Java**. We've covered loading the MOBI file, editing it using `EbookEditOptions`, saving the edited document back to MOBI format, and detecting MOBI files using `getDocumentInfo()`. With the support for MOBI format starting from version 23.9, you can fully integrate MOBI file editing into your Node.js applications.

---

**Note:** Replace `'Input.mobi'` and `'Output.mobi'` with the actual paths to your MOBI files.

---

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java) repository on GitHub.

---

## Edit TXT

Path: /editor/java/edit-txt/

> This demonstration shows how to load, open for editing and save textual documents, explains edit and save options and their destination.

## How to edit TXT file?

Textual documents are simple Plain Text flat files (TXT), that contain no images, pages, paragraphs, lists, tables and so on. However, users can create some primitive formatting like lists with leading markers, left indents with whitespaces, tables with pseudo-graphics, paragraphs with line breaks, and so on. [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java) can recognize some of these structures. Other non-obvious feature, that GroupDocs.Editor provide, is ability to save edited TXT document not only back to TXT, but also to WordProcessing.

## Loading text file for edit

Unlike WordProcessing and Spreadsheet documents, DSV documents are loaded into the `Editor` class without any loading options. They are simple text files by their nature, so it is nothing to adjust:

```java
String inputTxtPath = "C://input//file.txt";
Editor editor = new Editor(inputTxtPath);
```

## Edit text file

In order to open a text document for edit by creating the [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance it is required to use the [TextEditOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/texteditoptions) class. This class has several options (properties), that are described below:

1. [Encoding](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/texteditoptions/#getEncoding--) — allows to set character encoding of the input text document. By default, if not specified, is UTF8.
2. [RecognizeLists](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/texteditoptions/#getRecognizeLists--) — boolean flag, that indicates how exactly numbered list items are recognized. If this option is set to false (default value), lists recognition algorithm detects list paragraphs, when list numbers ends with either dot, right bracket or bullet symbols (such as "•", "\*", "-" or "o"). If this option is set to true, whitespaces are also used as list number delimiters: list recognition algorithm for Arabic style numbering (1., 1.1.2.) uses both whitespaces and dot (".") symbols.
3. [LeadingSpaces](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/texteditoptions/#getLeadingSpaces--) — enum flag, that indicates how consecutive leading spaces should be handled: convert to left indent (default value), preserve as consecutive spaces, or trim.
4. [TrailingSpaces](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/texteditoptions/#getTrailingSpaces--) — enum flag, that indicates how consecutive trailing spaces should be handled: truncated (default value), or trim.
5. [EnablePagination](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/texteditoptions/#getEnablePagination--) — boolean flag, that allows to enable paged view of the document. In their nature all text documents are pageless, however, GroupDocs.Editor allows to split them on pages, like MS Word does.
6. Direction — enum flag, which allows to specify the direction of text flow in the input plain text document. By default is Left-to-Right.

Source code below demonstrates using this option class and opening input text document for editing. Then, when [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance is ready, example below demonstrates, how to emit HTML markup from it, edit it and create new [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) instance from edited content:

```java
TextEditOptions editOptions = new TextEditOptions();
editOptions.setEncoding(StandardCharsets.UTF_8);
editOptions.setRecognizeLists(true);
editOptions.setLeadingSpaces(TextLeadingSpacesOptions.ConvertToIndent);
editOptions.setTrailingSpaces(TextTrailingSpacesOptions.Trim);
editOptions.setDirection(TextDirection.Auto);

EditableDocument beforeEdit = editor.edit(editOptions); // Create EditableDocument instance

String originalTextContent = beforeEdit.getContent(); // Get HTML content
String updatedTextContent = originalTextContent.replace("text", "EDITED text"); // Edit content
List<IHtmlResource> allResources = beforeEdit.getAllResources(); // Get resources (only one stylesheet actually in this case)

//Finally, create new EditableDocument
EditableDocument afterEdit = EditableDocument.fromMarkup(updatedTextContent, allResources);
```

## Save text file after edit

After being edited, text document can be saved back as TXT or as WordProcessing. For saving back to TXT format user must use a [TextSaveOptions](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/textsaveoptions) class, that have three properties, described below:

1. [Encoding](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/textsaveoptions/#getEncoding--) — character encoding of the text document, which will be applied for its saving. By default, if not specified, is UTF8.
2. [AddBidiMarks](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/textsaveoptions/#getAddBidiMarks--) — boolean flag, that determines whether to add bi-directional marks before each BiDi run when saving in plain text format.
3. [PreserveTableLayout](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/textsaveoptions/#getAddBidiMarks--) — boolean flag, that specifies whether the GroupDocs.Editor should try to preserve layout of tables when saving in the plain text format. The default value is false.

Source code below shows how to save  [EditableDocument](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) to both TXt and WordProcessing formats:

```java
TextSaveOptions txtSaveOptions = new TextSaveOptions();
txtSaveOptions.setAddBidiMarks(true);
txtSaveOptions.setPreserveTableLayout(true);

WordProcessingSaveOptions wordSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);

String outputTxtPath = "C:\\output\\document.txt";
String outputWordPath = "C:\\output\\document.docm";

editor.save(afterEdit, outputTxtPath, txtSaveOptions);
editor.save(afterEdit, outputWordPath, wordSaveOptions);
```

As a result, after running this example user will have two versions of the edited document: in TXT and DOCM formats.

---

## Edit TXT

Path: /editor/net/edit-txt/

> This demonstration shows how to load, open for editing and save text documents, explains edit and save options and their destination.

## How to edit TXT file?

Textual documents are simple Plain Text flat files (TXT), that contain no images, pages, paragraphs, lists, tables and so on. However, users can create some primitive formatting like lists with leading markers, left indents with whitespaces, tables with pseudo-graphics, paragraphs with line breaks, and so on. [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net) can recognize some of these structures. Other non-obvious feature, that GroupDocs.Editor provide, is ability to save edited TXT document not only back to TXT, but also to WordProcessing.

## Loading text file for edit

Unlike WordProcessing and Spreadsheet documents, DSV documents are loaded into the `Editor` class without any loading options. They are simple text files by their nature, so it is nothing to adjust:

```csharp
string inputTxtPath = "C://input/file.txt";
Editor editor = new Editor(inputTxtPath);
```

## Edit text file

In order to open a text document for edit by creating the [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance it is required to use the [TextEditOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions) class. This class has several options (properties), that are described below:

1. [Encoding](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions/encoding) — allows to set character encoding of the input text document. By default, if not specified, is UTF8.
2. [RecognizeLists](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions/recognizelists) — boolean flag, that indicates how exactly numbered list items are recognized. If this option is set to false (default value), lists recognition algorithm detects list paragraphs, when list numbers ends with either dot, right bracket or bullet symbols (such as "•", "\*", "-" or "o"). If this option is set to true, whitespaces are also used as list number delimiters: list recognition algorithm for Arabic style numbering (1., 1.1.2.) uses both whitespaces and dot (".") symbols.
3. [LeadingSpaces](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions/leadingspaces) — enum flag, that indicates how consecutive leading spaces should be handled: convert to left indent (default value), preserve as consecutive spaces, or trim.
4. [TrailingSpaces](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions/trailingspaces) — enum flag, that indicates how consecutive trailing spaces should be handled: truncated (default value), or trim.
5. [EnablePagination](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions/enablepagination) — boolean flag, that allows to enable paged view of the document. In their nature all text documents are pageless, however, GroupDocs.Editor allows to split them on pages, like MS Word does.
6. [Direction](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/texteditoptions/direction) — enum flag, which allows to specify the direction of text flow in the input plain text document. By default is Left-to-Right.

Source code below demonstrates using this option class and opening input text document for editing. Then, when [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance is ready, example below demonstrates, how to emit HTML markup from it, edit it and create new [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance from edited content:

```csharp
TextEditOptions editOptions = new TextEditOptions();
editOptions.Encoding = System.Text.Encoding.UTF8;
editOptions.RecognizeLists = true;
editOptions.LeadingSpaces = TextLeadingSpacesOptions.ConvertToIndent;
editOptions.TrailingSpaces = TextTrailingSpacesOptions.Trim;
editOptions.Direction = TextDirection.Auto;

EditableDocument beforeEdit = editor.Edit(editOptions); // Create EditableDocument instance

string originalTextContent = beforeEdit.GetContent(); // Get HTML content
string updatedTextContent = originalTextContent.Replace("text", "EDITED text"); // Edit content
List<IHtmlResource> allResources = beforeEdit.AllResources; // Get resources (only one stylesheet actually in this case)

//Finally, create new EditableDocument
EditableDocument afterEdit = EditableDocument.FromMarkup(updatedTextContent, allResources);
```

## Save text file after edit

After being edited, text document can be saved back as TXT or as WordProcessing. For saving back to TXT format user must use a [TextSaveOptions](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/textsaveoptions) class, that have three properties, described below:

1. [Encoding](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/textsaveoptions/encoding) — character encoding of the text document, which will be applied for its saving. By default, if not specified, is UTF8.
2. [AddBidiMarks](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/textsaveoptions/addbidimarks) — boolean flag, that determines whether to add bi-directional marks before each BiDi run when saving in plain text format.
3. [PreserveTableLayout](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/textsaveoptions/addbidimarks) — boolean flag, that specifies whether the GroupDocs.Editor should try to preserve layout of tables when saving in the plain text format. The default value is false.

Source code below shows how to save  [EditableDocument](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) to both TXt and WordProcessing formats:

```csharp
TextSaveOptions txtSaveOptions = new TextSaveOptions();
txtSaveOptions.AddBidiMarks = true;
txtSaveOptions.PreserveTableLayout = true;

WordProcessingSaveOptions wordSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);

string outputTxtPath = "C:\output\document.txt";
string outputWordPath = "C:\output\document.docm";

editor.Save(afterEdit, outputTxtPath, txtSaveOptions);
editor.Save(afterEdit, outputWordPath, wordSaveOptions);
```

As a result, after running this example user will have two versions of the edited document: in TXT and DOCM formats.

---

## Edit TXT

Path: /editor/nodejs-java/edit-txt/


> This demonstration shows how to load, open for editing, and save textual documents, explains edit and save options and their purpose.

## How to Edit a TXT File?

Textual documents are simple plain text flat files (TXT) that contain no images, pages, paragraphs, lists, tables, and so on. However, users can create some primitive formatting like lists with leading markers, left indents with whitespaces, tables with pseudo-graphics, paragraphs with line breaks, and so on. **GroupDocs.Editor** can recognize some of these structures. Another non-obvious feature that GroupDocs.Editor provides is the ability to save an edited TXT document not only back to TXT but also to WordProcessing formats.

## Loading Text File for Editing

Unlike WordProcessing and Spreadsheet documents, text documents are loaded into the `Editor` class without any loading options. They are simple text files by their nature, so there is nothing to adjust:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Specify the input TXT file path
const inputTxtPath = "C://input//file.txt";

// Create an instance of Editor
const editor = new groupdocsEditor.Editor(inputTxtPath);
```

## Edit Text File

In order to open a text document for editing by creating an `EditableDocument` instance, it is required to use the `TextEditOptions` class. This class has several options (properties) that are described below:

1. **Encoding** — allows setting the character encoding of the input text document. By default, if not specified, it is UTF-8.
2. **RecognizeLists** — boolean flag that indicates how exactly numbered list items are recognized. If this option is set to `false` (default value), the list recognition algorithm detects list paragraphs when list numbers end with either a dot, right bracket, or bullet symbols (such as "•", "*", "-" or "o"). If this option is set to `true`, whitespaces are also used as list number delimiters: the list recognition algorithm for Arabic style numbering (1., 1.1.2.) uses both whitespaces and dot (".") symbols.
3. **LeadingSpaces** — enum flag that indicates how consecutive leading spaces should be handled: convert to left indent (default value), preserve as consecutive spaces, or trim.
4. **TrailingSpaces** — enum flag that indicates how consecutive trailing spaces should be handled: truncated (default value) or trim.
5. **EnablePagination** — boolean flag that allows enabling paged view of the document. By their nature, all text documents are pageless; however, GroupDocs.Editor allows splitting them into pages, like MS Word does.
6. **Direction** — enum flag that allows specifying the direction of text flow in the input plain text document. By default, it is Left-to-Right.

The source code below demonstrates using this options class and opening an input text document for editing. Then, when the `EditableDocument` instance is ready, the example below demonstrates how to emit HTML markup from it, edit it, and create a new `EditableDocument` instance from the edited content:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Prepare TextEditOptions
const editOptions = new groupdocsEditor.TextEditOptions();
editOptions.setEncoding('UTF-8');
editOptions.setRecognizeLists(true);
editOptions.setLeadingSpaces(groupdocsEditor.TextLeadingSpacesOptions.ConvertToIndent);
editOptions.setTrailingSpaces(groupdocsEditor.TextTrailingSpacesOptions.Trim);
editOptions.setDirection(groupdocsEditor.TextDirection.Auto);

// Create EditableDocument instance
const beforeEdit = editor.edit(editOptions);

// Get HTML content
const originalTextContent = beforeEdit.getContent();

// Edit content
const updatedTextContent = originalTextContent.replace(/text/g, 'EDITED text');

// Get resources (only one stylesheet actually in this case)
const allResources = beforeEdit.getAllResources();

// Finally, create new EditableDocument
const afterEdit = groupdocsEditor.EditableDocument.fromMarkup(updatedTextContent, allResources);
```

## Save Text File After Editing

After being edited, the text document can be saved back as TXT or as a WordProcessing document. To save back to TXT format, you must use the `TextSaveOptions` class, which has three properties described below:

1. **Encoding** — character encoding of the text document, which will be applied for its saving. By default, if not specified, it is UTF-8.
2. **AddBidiMarks** — boolean flag that determines whether to add bi-directional marks before each BiDi run when saving in plain text format.
3. **PreserveTableLayout** — boolean flag that specifies whether GroupDocs.Editor should try to preserve the layout of tables when saving in the plain text format. The default value is `false`.

The source code below shows how to save the `EditableDocument` to both TXT and WordProcessing formats:

```javascript
// Import the necessary modules
const groupdocsEditor = require('groupdocs-editor');

// Prepare TextSaveOptions
const txtSaveOptions = new groupdocsEditor.TextSaveOptions();
txtSaveOptions.setAddBidiMarks(true);
txtSaveOptions.setPreserveTableLayout(true);

// Prepare WordProcessingSaveOptions
const wordSaveOptions = new groupdocsEditor.WordProcessingSaveOptions(groupdocsEditor.WordProcessingFormats.Docm);

// Specify output paths
const outputTxtPath = "C:\\output\\document.txt";
const outputWordPath = "C:\\output\\document.docm";

// Save the edited document as TXT
editor.save(afterEdit, outputTxtPath, txtSaveOptions);

// Save the edited document as WordProcessing format
editor.save(afterEdit, outputWordPath, wordSaveOptions);
```

---

By following this guide, you can effectively edit plain text files using GroupDocs.Editor for Node.js via Java, customizing the editing process according to your specific needs.

---

## Merge Excel spreadsheets

Path: /merger/net/merge/excel/


A **spreadsheet** file contains data in the form of rows and columns. A spreadsheet file can be saved in several different file formats, each having a different file extension for unique representation. Data is stored in cells either in plain form such as text string, numbers, date, currency, etc. or as formulas that change a cell’s value when referenced cell values change.

Common spreadsheet file extensions and their file formats include **XLSX** (Microsoft Excel Open XML Spreadsheet), **ODS** (OpenDocument Spreadsheet) and **XLS** (Microsoft Excel Binary File Format).

XLSX is well-known format for Microsoft Excel documents that was introduced by Microsoft with the release of Microsoft Office 2007. Based on structure organized according to the Open Packaging Conventions as outlined in Part 2 of the OOXML standard ECMA-376, the new format is a zip package that contains a number of XML files. The underlying structure and files can be examined by simply unzipping the .xlsx file.

## How to merge XLSX files programmatically

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to merge XLSX files when it's needed to organize multiple
 XLSX files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine XLSX documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge XLSX files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source XLSX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another XLSX file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other XLSX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged XLSX file as parameter.

```csharp
// Load the source XLSX file
using (Merger merger = new Merger(@"c:\sample1.xlsx"))
{
    // Add another XLSX file to merge
    merger.Join(@"c:\sample2.xlsx");
    // Merge XLSX files and save result
    merger.Save(@"c:\merged.xlsx");
}
```

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge XLSX Live Demo

GroupDocs.Merger for .NET provides an online [**XLSX Merger App**](https://products.groupdocs.app/merger/xlsx), which allows you to try it for free and check its quality and accuracy.

---

## Optimizing shards

Path: /search/java/optimizing-shards/

All search network shards can be optimized with a single call the [optimize](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#optimize-com.groupdocs.search.options.OptimizeOptions-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class.

The optimization minimizes the number of index segments on each shard. As a result, search performance increases.

An asynchronous execution flag is available as an option. In the case of asynchronous optimization, you can track the completion of the operation by subscribing to the [OptimizationCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#OptimizationCompleted) event.

The following code example demonstrates how to perform search network optimization.

```java
System.out.println("Optimizing shards");
Indexer indexer = node.getIndexer();
OptimizeOptions options = new OptimizeOptions();
indexer.optimize(options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Optimizing shards

Path: /search/net/optimizing-shards/

All search network shards can be optimized with a single call the [Optimize](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/optimize/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class.

The optimization minimizes the number of index segments on each shard. As a result, search performance increases.

An asynchronous execution flag is available as an option. In the case of asynchronous optimization, you can track the completion of the operation by subscribing to the [OptimizationCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/optimizationcompleted/) event.

The following code example demonstrates how to perform search network optimization.

**C#**

```csharp
Console.WriteLine("Optimizing shards");
Indexer indexer = node.Indexer;
OptimizeOptions options = new OptimizeOptions();
indexer.Optimize(options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Convert web formats

Path: /conversion/java/convert/web/


## About HTML and other web file formats

HTML (Hyper Text Markup Language) is the extension for web pages created for display in browsers. Known as the language of the web, HTML has evolved with requirements of new information to be displayed as part of web pages. 

It takes many file types when building a webpage. Web file formats define the standards for the development of webpages and are related to the platform in which these are built. A complete website can be built consisting of static as well as dynamic web pages. 

Common web file extensions and their associate file formats include HTML (HyperText Markup Language), ASP (Active Server Pages), XML (Extensible Markup Language), CSS (Cascading Style Sheets), JSON (JavaScript Object Notation), and others.

## Supported web file conversions

{{< include file="/conversion/java/_includes/supported-conversions/web.md" type="page" >}}

## Convert from web formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java/) you can easily convert web format into another file format.  
For example, HTML to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source HTML file
Converter converter = new Converter("sample.html");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an HTML file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/package-summary) for more conversion options and customizations.
{{< /alert >}}

### Convert to web formats

On the other hand, converting your files to web formats is also quite simple and natural.
The following code snippet shows how to convert a PDF document to HTML format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java).

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.WebConvertOptions;
...
// Load the source PDF file
Converter converter = new Converter("sample.pdf");
// Set the convert options for HTML format
WebConvertOptions options = new WebConvertOptions();
// Convert to HTML format
converter.convert("converted.html", options);
```

---

## Convert web formats

Path: /conversion/net/convert/web/


## About HTML and other web file formats

HTML (Hyper Text Markup Language) is the extension for web pages created for display in browsers. Known as the language of the web, HTML has evolved with requirements of new information to be displayed as part of web pages. 

It takes many file types when building a webpage. Web file formats define the standards for the development of webpages and are related to the platform in which these are built. A complete website can be built consisting of static as well as dynamic web pages. 

Common web file extensions and their associate file formats include HTML (HyperText Markup Language), ASP (Active Server Pages), XML (Extensible Markup Language), CSS (Cascading Style Sheets), JSON (JavaScript Object Notation), and others.

## Supported web file conversions

{{< include file="/conversion/net/_includes/supported-conversions/web.md" type="page" >}}

## Convert from web formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert web format into another file format.  
For example, the HTML to PDF conversion code snippet looks like this:

```csharp
// Load the source HTML file
using (Converter converter = new Converter("sample.html"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load an HTML file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to web formats

On the other hand, converting your files to web formats is also quite simple and natural.
The following code snippet shows how to convert a PDF document to HTML format in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source PDF file
using (Converter converter = new Converter("sample.pdf"))
{
    // Set the convert options for HTML format
    var options = new WebConvertOptions();
    // Convert to HTML format
    converter.Convert("converted.html", options);
}
```

---

## Convert web formats

Path: /conversion/nodejs-java/convert/web/


## About HTML and other web file formats

HTML (Hyper Text Markup Language) is the extension for web pages created for display in browsers. Known as the language of the web, HTML has evolved with requirements of new information to be displayed as part of web pages. 

It takes many file types when building a webpage. Web file formats define the standards for the development of webpages and are related to the platform in which these are built. A complete website can be built consisting of static as well as dynamic web pages. 

Common web file extensions and their associate file formats include HTML (HyperText Markup Language), ASP (Active Server Pages), XML (Extensible Markup Language), CSS (Cascading Style Sheets), JSON (JavaScript Object Notation), and others.

## Supported web file conversions

{{< include file="/conversion/java/_includes/supported-conversions/web.md" type="page" >}}

## Convert from web formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java/) you can easily convert web format into another file format.  
For example, HTML to PDF conversion code snippet looks like this:

```js
// Load the source HTML file
const converter = new groupdocs.conversion.Converter("sample.html");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an HTML file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/package-summary) for more conversion options and customizations.
{{< /alert >}}

### Convert to web formats

On the other hand, converting your files to web formats is also quite simple and natural.
The following code snippet shows how to convert a PDF document to HTML format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java).

```js
// Load the source PDF file
Converter converter = new groupdocs.conversion.Converter("sample.pdf");
// Set the convert options for HTML format
WebConvertOptions options = new groupdocs.conversion.WebConvertOptions();
// Convert to HTML format
converter.convert("converted.html", options);
```

---

## Edit Email

Path: /editor/java/edit-email/

> This example demonstrates the standard open-edit-save pipeline with Email documents, using different options on every step.

## Introduction

There is a group of [Email file formats](https://docs.fileformat.com/email/), which usually are intended for storing individual mail letters, or contact data, personal information, calendar and so on. There are plenty of them, because almost every email program uses its own set of such formats. 

From its emergence the GroupDocs.Editor for Java had no support for editing the such documents in Email formats. But starting from the [version 22.9](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-22-9-release-notes/) we finally released this possibility! And this article explains in detail how to edit different Email files, because due to their nature their editing differs from editing common text documents.

## Loading

Loding of the Email documents is usual and the same as for other formats. Like with text, XPS and e-Book formats, and unlike the PDF and Office formats, there is no loading options for the Email documents — just specify a path to the file or a [byte stream](https://docs.oracle.com/javase/7/docs/api/java/io/ByteArrayInputStream.html?is-external=true) with the document content in the constructor of the [`com.groupdocs.editor.Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class and that's all.

Code example below demonstrates loading a single EML file to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) instance through the file path and byte stream.

```java
String emlFilename = "C:\Attachments.eml";

InputStream emlStream = new FileInputStream(new File(emlFilename));
Editor editorFromPath = new Editor(emlFilename))//from the path
Editor editorFromStream = new Editor(emlStream)//from the stream
{
	//Here two Editor instances can separately work with one file
}
```

## Editing

Like for all other formats, there is a special [`EmailEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emaileditoptions) class for adjusting editing of the Email documents. Instance of this class should be specified in the [`Editor.edit(IEditOptions editOptions)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#edit-com.groupdocs.editor.options.IEditOptions-) method. And, like for all other formats, it is possible to use a parameterless overload of the [`Editor.edit()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#edit--) — in this case, if Email document was loaded to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) instance, the GroupDocs.Editor will automatically apply the default [`EmailEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emaileditoptions).

[`EmailEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emaileditoptions) class has only one member — a [`MailMessageOutput`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/mailmessageoutput/) property of a [`MailMessageOutput`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/mailmessageoutput/) type. [`MailMessageOutput`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/mailmessageoutput/) is a flagged enum that controls, which parts of the mail message should be delivered to the output [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) and then to the emitted HTML. The [`MailMessageOutput`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/mailmessageoutput/) enum has both *atomic* values that are responsible for a single part of the mail message, as well as *combined* values, like `Common` and `All`. It is allowed to use not only these combined values, but any user-defined combination of atomic values is acceptable. For example, it is possible to create a combination `Subject | Date | To | Cc | Bcc | From`, which processes only a metadata, but not the body and attachments list.

It is important to mention that currently the com.groupdocs.editor.Editor cannot process the content of the attachments, it can only display a list of attachment names. So the `MailMessageOutput.Attachments` flag, when specified, emits a list of attachment names, if they are present in the mail message.

Code example below shows adjusting of the [`MailMessageOutput`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/mailmessageoutput/) and generating two different [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) for editing from a single input Email document.

```java
//0. Prepare a sample file
String emlFilename = "C:\Attachments.eml";
InputStream emlInputPath = System.IO.Path.Combine(Common.TestHelper.EmailFolder, emlFilename);

//1. Load to the Editor class
Editor editor = new Editor(emlInputPath);

//2. Create 1st edit options with only metadata
EmailEditOptions editOptions = new EmailEditOptions(MailMessageOutput.Subject | MailMessageOutput.From | MailMessageOutput.To | MailMessageOutput.Cc | MailMessageOutput.Bcc | MailMessageOutput.Date);

//2. Create 2nd edit options with only subject, body and attachments list
EmailEditOptions editOptionsBody = new EmailEditOptions(MailMessageOutput.Subject | MailMessageOutput.Body | MailMessageOutput.Attachments);

//3. Generate two different EditableDocument with these options from single input "Attachments.eml"
EditableDocument onlyMetadata = editor.edit(editOptionsMetadata);
EditableDocument onlyBody = editor.edit(editOptionsBody);

//4. Then emit HTML/CSS and send to the WYSIWYG-editor on the client-side
```

## Saving

Saving the edited Email documents in general follows the same principles, like for other document formats, but with several distinctions. As usual, after obtaining an edited HTML-content from the client-side WYSIWYG-editor an instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) should be created, and then need to pass it to the [`com.groupdocs.editor.Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method.

Like for all other formats, during saving, along with the [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) and a path or a stream, an inheritor of the [`ISaveOptions` interface](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/isaveoptions) should be specified, and for email documents it is a [`EmailSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emailsaveoptions/) class. Like the previously described [`EmailEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emaileditoptions/), this class has only one member — a [`MailMessageOutput`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/mailmessageoutput/) property of a [`MailMessageOutput`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/mailmessageoutput/) type. The only distinction between this `MailMessageOutput` property in `EmailEditOptions` and `EmailSaveOptions` is that in the first case the `MailMessageOutput` property controls, which parts of the mail message will be processed while generating [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) from the input Email file, while in the second case the `MailMessageOutput` property controls, which parts of the mail message will be processed while generating output Email file from [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument), obtained after editing. So it is possible, for example, send to the WYSIWYG-editor a full mail message with 100% all content, but generate an output file only with a `Subject` and `Body` content, for example.

Email format family consists of many different formats, but the [`EmailSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/emailsaveoptions/) does not allow to specify the format for the output document — it automatically be the same, as the format of the original Email document, loaded into the [`com.groupdocs.editor.Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) class. So, for example, if you loaded the MSG file, then the [`com.groupdocs.editor.Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method will also generate the MSG file, and no matter which file extension you specify.

Code example below shows full load-edit-save pipeline for the Email documents. It loads a document, makes it editable with `MailMessageOutput.All` combined flag, and then generates to output Email documents: first one is saved to the file with `MailMessageOutput.Common`, while second is saved to the stream with customly created combined flag.

```java
//0. Prepare a sample file
String msgInputPath = "C:\ComplexExample.msg";

//1. Load to the Editor class
Editor msgEditor = new Editor(msgInputPath);

//2. Create edit options with all content
EmailEditOptions editOptions = new EmailEditOptions(MailMessageOutput.All);

//3. Generate an editable document
EditableDocument originalDoc = msgEditor.edit(editOptions);

//4. Emit HTML from EditableDocument, send it to the client-side, edit it there in WYSIWYG-editor (omitted here)
String savedHtmlContent = originalDoc.getEmbeddedHtml();

//5. Obtain edited content from the client-side and generate a new EditableDocument from it (omitted here)
EditableDocument editedDoc = EditableDocument.fromMarkup(savedHtmlContent, null);

//6. Create 1st save options
EmailSaveOptions saveOptions1 = new EmailSaveOptions(MailMessageOutput.Common);

//7. Create 2nd save options
EmailSaveOptions saveOptions2 = new EmailSaveOptions(MailMessageOutput.Body | MailMessageOutput.Attachments);

//8. Generate and save 1st output MSG to the file
String outputMsgPath = "C:\OutputFile.msg";
msgEditor.save(editedDoc, outputMsgPath, saveOptions1);

//9. Generate and save 2nd output MSG to the stream
Stream outputMsgStream = "C:\OutputStream.msg";
msgEditor.save(editedDoc, outputMsgStream, saveOptions2);

//10. Dispose all resources
outputMsgStream.dispose();
editedDoc.dispose();
originalDoc.dispose();
msgEditor.dispose();
```

## Obtaining Email document info

Article [Extracting document metainfo](https://docs.groupdocs.com/editor/java/extracting-document-metainfo/) describes the [`getDocumentInfo()` method](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-), that allows to detect the document format and extract its metadata without editing it. Actually, after adding Email support to the GroupDocs.Editor, this mechanism also works with Email documents.

When the [`getDocumentInfo()` method](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor#getDocumentInfo-java.lang.String-) is called for the [`Editor` class](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor) instance that is loaded with an Email document, the method will return a [`com.groupdocs.editor.metadata.EmailDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/emaildocumentinfo/) instance — it is a common class for all Email formats like EML, EMLX, MSG and so on.

As all [`IDocumentInfo`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo) implementations, it has four properties:

1. [`getFormat()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#getFormat--) property of [`formats.EmailFormats`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/emailformats/) type. It indicates the specific format of the given Email document.
2. [`getPageCount()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#getPageCount--) property of [int](https://docs.oracle.com/javase/7/docs/api/java/lang/Integer.html) type. It always return 1, because email documents don't have paged view
3. [`getSize()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#getSize--) property of a [long](https://docs.oracle.com/javase/7/docs/api/java/lang/Long.html) type. Returns a file size in bytes.
4. [`isEncrypted()` property](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.metadata/idocumentinfo#isEncrypted--) of a [`boolean`](https://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html) type. Because email documents cannot be encrypted with password, this property always returns `false`.

Code example below displays extracting document info from three different Email documents of different formats. 

```java
String emlInputPath = "C:\Attachments.eml";

String msgInputPath = "C:\ComplexExample.msg";

String pstInputPath = "C:\PersonalStorage.pst";

Editor emlEditor = new Editor(emlInputPath);
Editor msgEditor = new Editor(msgInputPath);
Editor pstEditor = new Editor(pstInputPath);

IDocumentInfo emlDocInfo = emlEditor.getDocumentInfo(null);
IDocumentInfo msgDocInfo = msgEditor.getDocumentInfo(null);
IDocumentInfo pstDocInfo = pstEditor.getDocumentInfo(null);

Assert.isTrue(emlDocInfo instanceof EmailDocumentInfo);
Assert.isTrue(msgDocInfo instanceof EmailDocumentInfo);
Assert.isTrue(pstDocInfo instanceof EmailDocumentInfo);

Assert.areEqual(com.groupdocs.editor.formats.EmailFormats.Eml, emlDocInfo.getFormat());
Assert.areEqual(com.groupdocs.editor.formats.EmailFormats.Msg, msgDocInfo.getFormat());
Assert.areEqual(com.groupdocs.editor.formats.EmailFormats.Pst, pstDocInfo.getFormat());

emlEditor.dispose();
msgEditor.dispose();
pstEditor.dispose();
```







---

## Edit Email

Path: /editor/net/edit-email/

> This example demonstrates the standard open-edit-save pipeline with Email documents, using different options on every step.

## Introduction

There is a group of [Email file formats](https://docs.fileformat.com/email/), which usually are intended for storing individual mail letters, or contact data, personal information, calendar and so on. There are plenty of them, because almost every email program uses its own set of such formats. 

From its emergence the GroupDocs.Editor for .NET had no support for editing the such documents in Email formats. But starting from the [version 22.7](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-7-release-notes/) we finally released this possibility! And this article explains in detail how to edit different Email files, because due to their nature their editing differs from editing common text documents.

## Loading

Loding of the Email documents is usual and the same as for other formats. Like with text, XPS and e-Book formats, and unlike the PDF and Office formats, there is no loading options for the Email documents — just specify a path to the file or a [byte stream](https://docs.microsoft.com/en-us/dotnet/api/system.IO.Stream?view=net-6.0) with the document content in the constructor of the [`GroupDocs.Editor.Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class and that's all.

Code example below demonstrates loading a single EML file to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance through the file path and byte stream.

```csharp
const string emlFilename = "Attachments.eml";
string emlInputPath = System.IO.Path.Combine(Common.TestHelper.EmailFolder, emlFilename);

using (FileStream emlStream = File.OpenRead(emlInputPath))
using (Editor editorFromPath = new Editor(emlInputPath))//from the path
using (Editor editorFromStream = new Editor(emlStream))//from the stream
{
	//Here two Editor instances can separately work with one file
}
```

## Editing

Like for all other formats, there is a special [`EmailEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emaileditoptions) class for adjusting editing of the Email documents. Instance of this class should be specified in the [`Editor.Edit(IEditOptions editOptions)`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit/#edit) method. And, like for all other formats, it is possible to use a parameterless overload of the [`Editor.Edit()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) — in this case, if Email document was loaded to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance, the GroupDocs.Editor will automatically apply the default [`EmailEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emaileditoptions).

[`EmailEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emaileditoptions) class has only one member — a [`MailMessageOutput`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emaileditoptions/mailmessageoutput) property of a [`MailMessageOutput`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/mailmessageoutput) type. [`MailMessageOutput`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/mailmessageoutput) is a flagged enum that controls, which parts of the mail message should be delivered to the output [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) and then to the emitted HTML. The [`MailMessageOutput`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/mailmessageoutput) enum has both *atomic* values that are responsible for a single part of the mail message, as well as *combined* values, like `Common` and `All`. It is allowed to use not only these combined values, but any user-defined combination of atomic values is acceptable. For example, it is possible to create a combination `Subject | Date | To | Cc | Bcc | From`, which processes only a metadata, but not the body and attachments list.

It is important to mention that currently the GroupDocs.Editor cannot process the content of the attachments, it can only display a list of attachment names. So the `MailMessageOutput.Attachments` flag, when specified, emits a list of attachment names, if they are present in the mail message.

Code example below shows adjusting of the [`MailMessageOutput`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/mailmessageoutput) and generating two different [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) for editing from a single input Email document.

```csharp
//0. Prepare a sample file
const string emlFilename = "Attachments.eml";
string emlInputPath = System.IO.Path.Combine(Common.TestHelper.EmailFolder, emlFilename);

//1. Load to the Editor class
Editor editor = new Editor(emlInputPath);

//2. Create 1st edit options with only metadata
Options.EmailEditOptions editOptionsMetadata = new EmailEditOptions(MailMessageOutput.Subject | MailMessageOutput.From | MailMessageOutput.To | MailMessageOutput.Cc | MailMessageOutput.Bcc | MailMessageOutput.Date);

//2. Create 2nd edit options with only subject, body and attachments list
Options.EmailEditOptions editOptionsBody = new EmailEditOptions(MailMessageOutput.Subject | MailMessageOutput.Body | MailMessageOutput.Attachments);

//3. Generate two different EditableDocument with these options from single input "Attachments.eml"
EditableDocument onlyMetadata = editor.Edit(editOptionsMetadata);
EditableDocument onlyBody = editor.Edit(editOptionsBody);

//4. Then emit HTML/CSS and send to the WYSIWYG-editor on the client-side
```

## Saving

Saving the edited Email documents in general follows the same principles, like for other document formats, but with several distinctions. As usual, after obtaining an edited HTML-content from the client-side WYSIWYG-editor an instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) should be created, and then need to pass it to the [`GroupDocs.Editor.Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

Like for all other formats, during saving, along with the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) and a path or a stream, an inheritor of the [`ISaveOptions` interface](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/isaveoptions) should be specified, and for email documents it is a [`EmailSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emailsaveoptions) class. Like the previously described [`EmailEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emaileditoptions), this class has only one member — a [`MailMessageOutput`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emailsaveoptions/mailmessageoutput) property of a [`MailMessageOutput`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/mailmessageoutput) type. The only distinction between this `MailMessageOutput` property in `EmailEditOptions` and `EmailSaveOptions` is that in the first case the `MailMessageOutput` property controls, which parts of the mail message will be processed while generating [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) from the input Email file, while in the second case the `MailMessageOutput` property controls, which parts of the mail message will be processed while generating output Email file from [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), obtained after editing. So it is possible, for example, send to the WYSIWYG-editor a full mail message with 100% all content, but generate an output file only with a `Subject` and `Body` content, for example.

Email format family consists of many different formats, but the [`EmailSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/emailsaveoptions) does not allow to specify the format for the output document — it automatically be the same, as the format of the original Email document, loaded into the [`GroupDocs.Editor.Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class. So, for example, if you loaded the MSG file, then the [`GroupDocs.Editor.Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method will also generate the MSG file, and no matter which file extension you specify.

Code example below shows full load-edit-save pipeline for the Email documents. It loads a document, makes it editable with `MailMessageOutput.All` combined flag, and then generates to output Email documents: first one is saved to the file with `MailMessageOutput.Common`, while second is saved to the stream with customly created combined flag.

```csharp
//0. Prepare a sample file
const string msgFilename = "ComplexExample.msg";
string msgInputPath = System.IO.Path.Combine(Common.TestHelper.EmailFolder, msgFilename);

//1. Load to the Editor class
Editor msgEditor = new Editor(msgInputPath);

//2. Create edit options with all content
Options.EmailEditOptions editOptions = new EmailEditOptions(MailMessageOutput.All);

//3. Generate an editable document
EditableDocument originalDoc = msgEditor.Edit(editOptions);

//4. Emit HTML from EditableDocument, send it to the client-side, edit it there in WYSIWYG-editor (omitted here)
string savedHtmlContent = originalDoc.GetEmbeddedHtml();

//5. Obtain edited content from the client-side and generate a new EditableDocument from it (omitted here)
EditableDocument editedDoc = EditableDocument.FromMarkup(savedHtmlContent, null);

//6. Create 1st save options
EmailSaveOptions saveOptions1 = new EmailSaveOptions(MailMessageOutput.Common);

//7. Create 2nd save options
EmailSaveOptions saveOptions2 = new EmailSaveOptions(MailMessageOutput.Body | MailMessageOutput.Attachments);

//8. Generate and save 1st output MSG to the file
string outputMsgPath = System.IO.Path.Combine(Common.TestHelper.OutputFolder, "OutputFile.msg");
msgEditor.Save(editedDoc, outputMsgPath, saveOptions1);

//9. Generate and save 2nd output MSG to the stream
Stream outputMsgStream = File.Create(Path.Combine(Common.TestHelper.OutputFolder, "OutputStream.msg"));
msgEditor.Save(editedDoc, outputMsgStream, saveOptions2);

//10. Dispose all resources
outputMsgStream.Dispose();
editedDoc.Dispose();
originalDoc.Dispose();
msgEditor.Dispose();
```

## Obtaining Email document info

Article [Extracting document metainfo](https://docs.groupdocs.com/editor/net/extracting-document-metainfo/) describes the [`GetDocumentInfo()` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo), that allows to detect the document format and extract its metadata without editing it. Actually, after adding Email support to the GroupDocs.Editor, this mechanism also works with Email documents.

When the [`GetDocumentInfo()` method](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/getdocumentinfo) is called for the [`Editor` class](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instance that is loaded with an Email document, the method will return a [`GroupDocs.Editor.Metadata.EmailDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/emaildocumentinfo) instance — it is a common class for all Email formats like EML, EMLX, MSG and so on.

As all [`IDocumentInfo`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/idocumentinfo) implementations, it has four properties:

1. [`Format`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/emaildocumentinfo/format) property of [`Formats.EmailFormats`](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/emailformats) type. It indicates the specific format of the given Email document.
2. [`PageCount`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/emaildocumentinfo/pagecount) property of [integer (`Int32`)](https://docs.microsoft.com/en-us/dotnet/api/system.int32?view=net-6.0) type. It always return 1, because email documents don't have paged view
3. [`Size`](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/emaildocumentinfo/size) property of a [long integer (`Int64`)](https://docs.microsoft.com/en-us/dotnet/api/system.int64?view=net-6.0) type. Returns a file size in bytes.
4. [`IsEncrypted` property](https://reference.groupdocs.com/editor/net/groupdocs.editor.metadata/emaildocumentinfo/isencrypted) of a [`Boolean`](https://docs.microsoft.com/en-us/dotnet/api/system.boolean?view=net-6.0) type. Because email documents cannot be encrypted with password, this property always returns `false`.

Code example below displays extracting document info from three different Email documents of different formats. Source code is represented as a unit-test, written with NUnit framework.

```csharp
const string emlFilename = "Attachments.eml";
string emlInputPath = System.IO.Path.Combine(Common.TestHelper.EmailFolder, emlFilename);

const string msgFilename = "ComplexExample.msg";
string msgInputPath = System.IO.Path.Combine(Common.TestHelper.EmailFolder, msgFilename);

const string pstFilename = "PersonalStorage.pst";
string pstInputPath = System.IO.Path.Combine(Common.TestHelper.EmailFolder, pstFilename);

Editor emlEditor = new Editor(emlInputPath);
Editor msgEditor = new Editor(msgInputPath);
Editor pstEditor = new Editor(pstInputPath);

IDocumentInfo emlDocInfo = emlEditor.GetDocumentInfo(null);
IDocumentInfo msgDocInfo = msgEditor.GetDocumentInfo(null);
IDocumentInfo pstDocInfo = pstEditor.GetDocumentInfo(null);

Assert.IsTrue(emlDocInfo is EmailDocumentInfo);
Assert.IsTrue(msgDocInfo is EmailDocumentInfo);
Assert.IsTrue(pstDocInfo is EmailDocumentInfo);

Assert.AreEqual(GroupDocs.Editor.Formats.EmailFormats.Eml, emlDocInfo.Format);
Assert.AreEqual(GroupDocs.Editor.Formats.EmailFormats.Msg, msgDocInfo.Format);
Assert.AreEqual(GroupDocs.Editor.Formats.EmailFormats.Pst, pstDocInfo.Format);

emlEditor.Dispose();
msgEditor.Dispose();
pstEditor.Dispose();
```







---

## Edit Email

Path: /editor/nodejs-java/edit-email/


> This example demonstrates the standard open-edit-save pipeline with Email documents, using different options at every step.

## Introduction

There are plenty of them because almost every email program uses its own set of such formats.

From its emergence, GroupDocs.Editor for Node.js via Java had no support for editing such documents in Email formats. But starting from [version 22.9](https://releases.groupdocs.com/editor/nodejs-java/release-notes/2022/groupdocs-editor-for-node-js-via-java-22-9-release-notes/), we finally released this capability! This article explains in detail how to edit different Email files because, due to their nature, their editing differs from editing common text documents.

## Loading

Loading Email documents is straightforward and the same as for other formats. Like with text, XPS, and eBook formats, and unlike the PDF and Office formats, there are no loading options for Email documents—just specify a path to the file or a byte stream with the document content in the constructor of the [`Editor`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor) class, and that's all.

The code example below demonstrates loading a single EML file into the `Editor` instance through the file path and byte stream.

```javascript
// Import necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

// Path to the EML file
const emlFilePath = "C:\\Attachments.eml";

// Load from file path
const editorFromPath = new groupdocsEditor.Editor(emlFilePath);

// Load from stream
const emlStream = fs.createReadStream(emlFilePath);
const editorFromStream = new groupdocsEditor.Editor(emlStream);

// Now you can work with the editor instances
// ...

// Don't forget to dispose of the editors when done
editorFromPath.dispose();
editorFromStream.dispose();
```

## Editing

Like for all other formats, there is a special [`EmailEditOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.EmailEditOptions) class for adjusting the editing of Email documents. An instance of this class should be specified in the [`editor.edit(editOptions)`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#edit(com.groupdocs.editor.options.EditOptions)) method. And, like for all other formats, it is possible to use a parameterless overload of the [`editor.edit()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#edit()) method—in this case, if an Email document was loaded into the `Editor` instance, GroupDocs.Editor will automatically apply the default `EmailEditOptions`.

The `EmailEditOptions` class has one member—a `mailMessageOutput` property of the [`MailMessageOutput`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.MailMessageOutput) type. `MailMessageOutput` is a flagged enumeration that controls which parts of the mail message should be delivered to the output `EditableDocument` and then to the emitted HTML. The `MailMessageOutput` enum has both *atomic* values that are responsible for a single part of the mail message, as well as *combined* values, like `Common` and `All`. It is allowed to use not only these combined values but any user-defined combination of atomic values. For example, it is possible to create a combination of `Subject | Date | To | Cc | Bcc | From`, which processes only metadata but not the body and attachments list.

It is important to mention that currently, GroupDocs.Editor cannot process the content of attachments; it can only display a list of attachment names. So the `MailMessageOutput.Attachments` flag, when specified, emits a list of attachment names if they are present in the mail message.

The code example below shows adjusting the `MailMessageOutput` and generating two different `EditableDocument` instances for editing from a single input Email document.

```javascript
// Import necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

// Prepare a sample file
const emlFilePath = "C:\\Attachments.eml";

// Load into the Editor class
const editor = new groupdocsEditor.Editor(emlFilePath);

// Create 1st edit options with only metadata
const editOptionsMetadata = new groupdocsEditor.EmailEditOptions();
editOptionsMetadata.setMailMessageOutput(
    groupdocsEditor.MailMessageOutput.Subject |
    groupdocsEditor.MailMessageOutput.From |
    groupdocsEditor.MailMessageOutput.To |
    groupdocsEditor.MailMessageOutput.Cc |
    groupdocsEditor.MailMessageOutput.Bcc |
    groupdocsEditor.MailMessageOutput.Date
);

// Create 2nd edit options with only subject, body, and attachments list
const editOptionsBody = new groupdocsEditor.EmailEditOptions();
editOptionsBody.setMailMessageOutput(
    groupdocsEditor.MailMessageOutput.Subject |
    groupdocsEditor.MailMessageOutput.Body |
    groupdocsEditor.MailMessageOutput.Attachments
);

// Generate two different EditableDocument instances from a single input "Attachments.eml"
const onlyMetadata = editor.edit(editOptionsMetadata);
const onlyBody = editor.edit(editOptionsBody);

// Now you can work with the EditableDocument instances
// ...

// Don't forget to dispose of the editor and EditableDocuments when done
onlyMetadata.dispose();
onlyBody.dispose();
editor.dispose();
```

## Saving

Saving the edited Email documents generally follows the same principles as for other document formats but with some distinctions. As usual, after obtaining edited HTML content from the client-side WYSIWYG editor, an instance of the `EditableDocument` should be created, and then it needs to be passed to the [`editor.save()`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#save(com.groupdocs.editor.EditableDocument,%20java.lang.String,%20com.groupdocs.editor.options.SaveOptions)) method.

Like for all other formats, during saving, along with the `EditableDocument` and a path or a stream, an inheritor of the [`SaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.SaveOptions) interface should be specified. For Email documents, it is the [`EmailSaveOptions`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.options.EmailSaveOptions) class. Like the previously described `EmailEditOptions`, this class has one member—a `mailMessageOutput` property of the `MailMessageOutput` type. The only distinction between this `mailMessageOutput` property in `EmailEditOptions` and `EmailSaveOptions` is that in the first case, the `mailMessageOutput` property controls which parts of the mail message will be processed while generating `EditableDocument` from the input Email file, while in the second case, the `mailMessageOutput` property controls which parts of the mail message will be processed while generating the output Email file from the `EditableDocument` obtained after editing. So it is possible, for example, to send to the WYSIWYG editor a full mail message with 100% of all content but generate an output file only with the `Subject` and `Body` content.

The Email format family consists of many different formats, but the `EmailSaveOptions` does not allow specifying the format for the output document—it will automatically be the same as the format of the original Email document loaded into the `Editor` class. So, for example, if you loaded an MSG file, then the `editor.save()` method will also generate an MSG file, no matter which file extension you specify.

The code example below shows the full load-edit-save pipeline for Email documents. It loads a document, makes it editable with `MailMessageOutput.All` combined flag, and then generates two output Email documents: the first one is saved to a file with `MailMessageOutput.Common`, while the second is saved to a stream with a custom combined flag.

```javascript
// Import necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

// Prepare a sample file
const msgInputPath = "C:\\ComplexExample.msg";

// Load into the Editor class
const msgEditor = new groupdocsEditor.Editor(msgInputPath);

// Create edit options with all content
const editOptions = new groupdocsEditor.EmailEditOptions();
editOptions.setMailMessageOutput(groupdocsEditor.MailMessageOutput.All);

// Generate an editable document
const originalDoc = msgEditor.edit(editOptions);

// Emit HTML from EditableDocument, send it to the client-side, edit it there in WYSIWYG editor (omitted here)
const savedHtmlContent = originalDoc.getEmbeddedHtml();

// Assume the edited content is obtained from the client-side and stored in 'editedHtmlContent' (omitted here)
const editedHtmlContent = savedHtmlContent; // For demonstration purposes

// Obtain edited content and generate a new EditableDocument from it
const editedDoc = groupdocsEditor.EditableDocument.fromMarkup(editedHtmlContent, null);

// Create 1st save options
const saveOptions1 = new groupdocsEditor.EmailSaveOptions();
saveOptions1.setMailMessageOutput(groupdocsEditor.MailMessageOutput.Common);

// Create 2nd save options
const saveOptions2 = new groupdocsEditor.EmailSaveOptions();
saveOptions2.setMailMessageOutput(
    groupdocsEditor.MailMessageOutput.Body |
    groupdocsEditor.MailMessageOutput.Attachments
);

// Generate and save 1st output MSG to the file
const outputMsgPath = "C:\\OutputFile.msg";
msgEditor.save(editedDoc, outputMsgPath, saveOptions1);

// Generate and save 2nd output MSG to the stream
const outputMsgStream = fs.createWriteStream("C:\\OutputStream.msg");
msgEditor.save(editedDoc, outputMsgStream, saveOptions2);

// Dispose of all resources
outputMsgStream.end();
editedDoc.dispose();
originalDoc.dispose();
msgEditor.dispose();
```

## Obtaining Email Document Info

The article [Extracting Document Metainfo](/editor/nodejs-java/extracting-document-metainfo) describes the [`getDocumentInfo()` method](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor/Editor#getDocumentInfo(java.lang.String)), which allows detecting the document format and extracting its metadata without editing it. After adding Email support to GroupDocs.Editor, this mechanism also works with Email documents.

When the `getDocumentInfo()` method is called for the `Editor` instance that is loaded with an Email document, the method will return an instance of the [`EmailDocumentInfo`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.metadata.EmailDocumentInfo) class—it is a common class for all Email formats like EML, EMLX, MSG, and so on.

As all `IDocumentInfo` implementations, it has four properties:

1. **`getFormat()`**: Property of [`EmailFormats`](https://reference.groupdocs.com/editor/nodejs-java/com.groupdocs.editor.formats.EmailFormats) type. It indicates the specific format of the given Email document.
2. **`getPageCount()`**: Property of `int` type. It always returns 1 because Email documents don't have a paged view.
3. **`getSize()`**: Property of `long` type. Returns the file size in bytes.
4. **`isEncrypted()`**: Property of `boolean` type. Because Email documents cannot be encrypted with a password, this property always returns `false`.

The code example below demonstrates extracting document info from three different Email documents of different formats.

```javascript
// Import necessary modules
const fs = require('fs');
const groupdocsEditor = require('groupdocs-editor');

// Paths to the Email documents
const emlInputPath = "C:\\Attachments.eml";
const msgInputPath = "C:\\ComplexExample.msg";
const pstInputPath = "C:\\PersonalStorage.pst";

// Load into the Editor class
const emlEditor = new groupdocsEditor.Editor(emlInputPath);
const msgEditor = new groupdocsEditor.Editor(msgInputPath);
const pstEditor = new groupdocsEditor.Editor(pstInputPath);

// Get document info
const emlDocInfo = emlEditor.getDocumentInfo();
const msgDocInfo = msgEditor.getDocumentInfo();
const pstDocInfo = pstEditor.getDocumentInfo();

// Check if the returned info is of type EmailDocumentInfo
console.log(emlDocInfo instanceof groupdocsEditor.EmailDocumentInfo); // true
console.log(msgDocInfo instanceof groupdocsEditor.EmailDocumentInfo); // true
console.log(pstDocInfo instanceof groupdocsEditor.EmailDocumentInfo); // true

// Verify the formats
console.log(emlDocInfo.getFormat() === groupdocsEditor.EmailFormats.Eml); // true
console.log(msgDocInfo.getFormat() === groupdocsEditor.EmailFormats.Msg); // true
console.log(pstDocInfo.getFormat() === groupdocsEditor.EmailFormats.Pst); // true

// Dispose of the editors
emlEditor.dispose();
msgEditor.dispose();
pstEditor.dispose();
```

## Conclusion

By following the steps outlined in this guide, you can effectively edit Email documents using GroupDocs.Editor for Node.js via Java. The process involves loading the Email document, configuring editing options to specify which parts of the email to edit, editing the content using a WYSIWYG HTML editor, and finally saving the edited content back into an Email format.

This capability is particularly useful for applications that require programmatic manipulation of Email messages, such as email automation systems, archiving solutions, or custom email clients.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.


---

## Merge text files

Path: /merger/net/merge/txt/


A file with .TXT extension represents a text document that contains plain text in the form of lines. Paragraphs in a text document are recognized by carriage returns and are used for better arrangement of file contents. A standard text document can be opened in any text editor or word processing application on different operating systems. All the text contained in such a file is in human-readable format and represented by sequence of characters.

## How to merge text files in C\#

When it's required to organize several text files into one file it's possible to solve the task with help of [GroupDocs.Merger](https://products.groupdocs.com/merger/net) only and no need to use any third-party software.

The workflow of combining files together is quite simple:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source TXT file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TXT file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other TXT documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged TXT file as parameter.

The following example demonstrates how to merge TXT files with several lines of C# code:

```csharp
// Load the source TXT file
using (Merger merger = new Merger(@"c:\sample1.txt"))
{
    // Add another TXT file to merge
    merger.Join(@"c:\sample2.txt");
    // Merge TXT files and save result
    merger.Save(@"c:\merged.txt");
}
```

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TXT Live Demo

GroupDocs.Merger for .NET provides an online [**TXT Merger App**](https://products.groupdocs.app/merger/txt), which allows you to try it for free and check its quality and accuracy.

---

## Convert page layout formats

Path: /conversion/java/convert/page-layout/


## About page layout formats

Page layout languages are used in desktop and electronic publishing. The main focus of these languages is to facilitate a two-dimensional graphic design. Popular page layout formats include TEX, SVG, PS, and EPS.

## Supported page layout conversions

{{< include file="/conversion/java/_includes/supported-conversions/page-description-language.md" type="page" >}}

## Convert from page layout formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert a page layout file format into another file format.
For example, TEX to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source TEX file
Converter converter = new Converter("sample.tex");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a TEX file into `Converter`, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/com.groupdocs.conversion.options.convert/package-frame) for more conversion options and customizations.
{{< /alert >}}

### Convert to page layout formats

On the other hand, converting your files to page layout format is also quite simple and natural.
The following code snippet shows how to convert a DOCX document to TEX format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java).

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.filetypes.PdfFileType;
...
// Load the source DOCX file
Converter converter = Converter("sample.docx");
// Set the convert options for TEX format
PdfConvertOptions options = new PdfConvertOptions();
options.setFormat(PdfFileType.Tex);
// Convert to TEX format
converter.convert("converted.tex", options);
```

---

## Convert page layout formats

Path: /conversion/nodejs-java/convert/page-layout/


## About page layout formats

Page layout languages are used in desktop and electronic publishing. The main focus of these languages is to facilitate a two-dimensional graphic design. Popular page layout formats include TEX, SVG, PS, and EPS.

## Supported page layout conversions

{{< include file="/conversion/java/_includes/supported-conversions/page-description-language.md" type="page" >}}

## Convert from page layout formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert a page layout file format into another file format.
For example, TEX to PDF conversion code snippet looks like this:

```js
// Load the source TEX file
const converter = new groupdocs.conversion.Converter("sample.tex");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a TEX file into `Converter`, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/nodejs-java/com.groupdocs.conversion.options.convert/package-frame) for more conversion options and customizations.
{{< /alert >}}

### Convert to page layout formats

On the other hand, converting your files to page layout format is also quite simple and natural.
The following code snippet shows how to convert a DOCX document to TEX format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java).

```js
// Load the source DOCX file
const converter = new groupdocs.conversion.Converter("sample.docx");
// Set the convert options for TEX format
const options = new groupdocs.conversion.PdfConvertOptions();
options.setFormat(groupdocs.conversion.PdfFileType.Tex);
// Convert to TEX format
converter.convert("converted.tex", options);
```
---

## Synchronizing shards

Path: /search/java/synchronizing-shards/

If there is any communication interruption in the search network, some operations may not complete correctly. To resolve such problems, you need to call the [synchronize](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#synchronize-com.groupdocs.search.options.SynchronizeOptions-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class.

The asynchronous operation flag is available as an option. You can track the completion of the operation by subscribing to the [SynchronizationCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#SynchronizationCompleted) event.

The following code example demonstrates how to synchronize search network nodes.

```java
System.out.println("Synchronizing shards");
Indexer indexer = node.getIndexer();
SynchronizeOptions options = new SynchronizeOptions();
indexer.synchronize(options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Synchronizing shards

Path: /search/net/synchronizing-shards/

If there is any communication interruption in the search network, some operations may not complete correctly. To resolve such problems, you need to call the [Synchronize](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/synchronize/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class.

The asynchronous operation flag is available as an option. You can track the completion of the operation by subscribing to the [SynchronizationCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/synchronizationcompleted/) event.

The following code example demonstrates how to synchronize search network nodes.

**C#**

```csharp
Console.WriteLine("Synchronizing shards");
Indexer indexer = node.Indexer;
SynchronizeOptions options = new SynchronizeOptions();
indexer.Synchronize(options);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Convert compression formats

Path: /conversion/java/convert/compression/


## About compression file formats

File compression is a process aimed at reducing file sizes by eliminating unnecessary data. This compression technique enables the creation of smaller file archives, simplifying the transfer and backup of large files or file collections. Additionally, compressed files facilitate faster and more convenient downloads while maximizing the storage capacity of removable media. Below, we are going to guide you on converting the most popular compression file formats using GroupDocs.Conversion.

## Supported compression file conversions

{{< include file="/conversion/java/_includes/supported-conversions/compression.md" type="page" >}}

<!--
## Extract from ZIP

Leverage the power of [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) to effortlessly extract content from your archives. See below for an example of how to extract content from a ZIP archive:

```csharp
// Load the source ZIP file
using (Converter converter = new Converter("sample.zip"))
{
    converter.Convert(() => new MemoryStream(), (Stream convertedStream, string sourceFileName) =>
    {
        // store extracted content
        string fileName = Path.Combine(outputFolder, sourceFileName);
        Directory.CreateDirectory(Path.GetDirectoryName(fileName)!);
        using (var fs = new FileStream(fileName, FileMode.Create))
        {
            convertedStream.CopyTo(fs);
        }
    }, (_, _) => null);
}

```
In simple terms, using **GroupDocs.Conversion** is as easy as loading a ZIP file into the `Converter` class and specifying a handler to store the resulting output. Once you've completed these steps, GroupDocs.Conversion takes care of the rest, handling the conversion process seamlessly.

{{< alert style="info" >}}
Refer to the [API reference](https://apireference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}
-->

## Extract and convert from an archive 

Using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java), you can convert the archive content to your desired format. 

To illustrate, here is a code sample showcasing how to convert the content of a ZIP archive to PDF format:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import java.io.FileOutputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
...
try (Converter converter = new Converter("sample.zip")) {
            converter.convert(() -> new ByteArrayOutputStream(), (convertedStream, sourceFileName) -> {
                String outputFolder = "C:\\Output";
				Path path = Paths.get(outputFolder , sourceFileName + ".pdf");
                if (!path.getParent().toFile().exists())
                    Files.createDirectory(path.getParent());
                try (FileOutputStream fs = new FileOutputStream(path.toFile()); InputStream inputStream = convertedStream.toInputStream();) {
                    int read = 0;
                    byte[] buf = new byte[1024];
                    do {
                        read = inputStream.read(buf, 0, buf.length);
                        if (read > 0) {
                            fs.write(buf, 0, read);
                        }

                    } while (read > 0);
                }
                return null;
            }, (s, fileType) -> new PdfConvertOptions());
        }
```
With this code snippet, you can effortlessly convert the content of a ZIP archive to PDF format using GroupDocs.Conversion in Java. Enjoy the simplicity and flexibility of converting your archive content to meet your specific needs.

{{< alert style="info" >}}
Refer to the [API reference](https://apireference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}


---

## Convert compression formats

Path: /conversion/net/convert/compression/


## About compression file formats

File compression is the process of reducing the size of one or more files. It shrinks big files into much smaller ones by removing unneeded data. The compressed file archive makes it easier to send and back up large files or groups of files. Moreover, such files make downloading faster and easier, besides, they allow more data to be stored on removable media. There are various compression formats. Below, we are going to describe how to convert the most popular compression file formats using GroupDocs.Conversion.

## Supported compression file conversions

{{< include file="/conversion/net/_includes/supported-conversions/compression.md" type="page" >}}

## Extract from ZIP

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily extract content from your archives. For example, a code snippet of extraction from a ZIP archive will look like this:

```csharp
// Load the source ZIP file
using (Converter converter = new Converter("sample.zip"))
{
    converter.Convert(_ => null, (ConvertedContext convertedContext) =>
    {
        // store extracted content
        string fileName = Path.Combine(outputFolder, convertedContext.SourceFileName);
        Directory.CreateDirectory(Path.GetDirectoryName(fileName)!);
        using (var fs = new FileStream(fileName, FileMode.Create))
        {
            convertedContext.ConvertedStream.CopyTo(fs);
        }
    });
}
```

Put it simply - you just load a ZIP file into the `Converter` class, provide null convert options and a handler in which to store the result and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://apireference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Extract and convert from a RAR 

You also can convert the archive content during extraction to a desired format. Extraction and conversion to PDF format are also quite simple and natural.
The following code snippet shows how to convert the content of a RAR archive to PDF in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source RAR file
using (Converter converter = new Converter("sample.rar"))
{
    // Set the convert option for PDF format. This will convert each file in the archive to PDF
    PdfConvertOptions options = new PdfConvertOptions();
    int i = 0;
    // Extract and convert to PDF
    converter.Convert((SaveContext saveContext) => new FileStream(Path.Combine(outputFolder, $"converted-{++i}.{saveContext.TargetFormat.Extension}"), FileMode.Create), options);
}
```

---

## Convert CAD formats

Path: /conversion/java/convert/cad/


## About CAD file formats

CAD stands for Computer-Aided Design. The term CADD (for Computer-Aided Design and Drafting) is also used. It is used for a 3D graphics file format and may contain 2D or 3D designs. A CAD file is a digital file format of an object generated and used by CAD software. A CAD file contains a technical drawing, blueprint, schematic, or 3D rendering of an object. There may be other CAD tools that can be used to create, open, edit, and export these .cad files to more widely used CAD drawing file formats. Below, we are going to describe how to convert the most popular CAD file formats.

## Supported CAD file conversions

{{< include file="/conversion/java/_includes/supported-conversions/cad.md" type="page" >}}

## Convert from CAD formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your CAD document into another file format.  
For example, a DWG to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source DWG file
Converter converter = new Converter("sample.dwg");
// Set the convert options for PDF format
PdfConvertOptions options = new CadConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a CAD file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another CAD format

On the other hand, converting your CAD files to another CAD format is also quite simple and natural.
The following code snippet shows how to convert a DWG document to STL in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java).

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.CadConvertOptions;
import com.groupdocs.conversion.filetypes.CadFileType;
...
// Load the source DWG file
Converter converter = new Converter("sample.dwg");
// Set the convert options for STL format
CadConvertOptions options = new CadConvertOptions();
options.setFormat(CadFileType.Stl);
// Convert to STL format
converter.convert("converted.stl", options);
```

---

## Convert CAD formats

Path: /conversion/net/convert/cad/


## About CAD file formats

CAD stands for Computer-Aided Design. The term CADD (for Computer-Aided Design and Drafting) is also used. It is used for a 3D graphics file format and may contain 2D or 3D designs. A CAD file is a digital file format of an object generated and used by CAD software. A CAD file contains a technical drawing, blueprint, schematic, or 3D rendering of an object. There may be other CAD tools that can be used to create, open, edit, and export these .cad files to more widely used CAD drawing file formats. Below, we are going to describe how to convert the most popular CAD file formats.

## Supported CAD file conversions

{{< include file="/conversion/net/_includes/supported-conversions/cad.md" type="page" >}}

## Convert from CAD formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your CAD document into another file format.  
For example, a DWG to PDF conversion code snippet looks like this:

```csharp
// Load the source DWG file
using (Converter converter = new Converter("sample.dwg"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a CAD file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another CAD format

On the other hand, converting your CAD files to another CAD format is also quite simple and natural.
The following code snippet shows how to convert a DWG document to STL in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source DWG file
using (Converter converter = new Converter("sample.dwg"))
{
    // Set the convert options for STL format
    var options = new CadConvertOptions {
        Format = CadFileType.Stl
    };
    // Convert to STL format
    converter.Convert("converted.stl", options);
}
```

---

## Convert CAD formats

Path: /conversion/nodejs-java/convert/cad/


## About CAD file formats

CAD stands for Computer-Aided Design. The term CADD (for Computer-Aided Design and Drafting) is also used. It is used for a 3D graphics file format and may contain 2D or 3D designs. A CAD file is a digital file format of an object generated and used by CAD software. A CAD file contains a technical drawing, blueprint, schematic, or 3D rendering of an object. There may be other CAD tools that can be used to create, open, edit, and export these .cad files to more widely used CAD drawing file formats. Below, we are going to describe how to convert the most popular CAD file formats.

## Supported CAD file conversions

{{< include file="/conversion/java/_includes/supported-conversions/cad.md" type="page" >}}

## Convert from CAD formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your CAD document into another file format.  
For example, a DWG to PDF conversion code snippet looks like this:

```js
// Load the source DWG file
const converter = new groupdocs.conversion.Converter("sample.dwg");
// Set the convert options for PDF format
const options = new groupdocs.conversion.CadConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a CAD file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/nodejs-java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another CAD format

On the other hand, converting your CAD files to another CAD format is also quite simple and natural.
The following code snippet shows how to convert a DWG document to STL in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java).

```js
// Load the source DWG file
const converter = new groupdocs.conversion.Converter("sample.dwg")
// Set the convert options for STL format
const options = new groupdocs.conversion.CadConvertOptions()
options.setFormat(groupdocs.conversion.CadFileType.Stl)
// Convert to STL format
converter.convert("converted.stl", options)
```
---

## Convert database formats

Path: /conversion/java/convert/database/

A database is a collection of data that is organized in tables and maintained on a computer storage device and accessed electronically. Relational databases store data in database tables that are linked to each other via formal design and modeling techniques. Data in a database is analyzed using the Database Management System (DBMS) which is the main source of interaction with end users, applications, and the database itself.

Popular database file extensions and their file formats include SQLite, DB, ACCDB, and MDB.

## Supported database file conversions

{{< include file="/conversion/java/_includes/supported-conversions/database.md" type="page" >}}

## Convert from database formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your document into another file format.  
For example, a LOG to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source LOG file
Converter converter = new Converter("sample.log");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a LOG file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert database formats

Path: /conversion/net/convert/database/

A database is a collection of data that is organized in tables and maintained on a computer storage device and accessed electronically. Relational databases store data in database tables that are linked to each other via formal design and modeling techniques. Data in a database is analyzed using the Database Management System (DBMS) which is the main source of interaction with end users, applications, and the database itself.

Popular database file extensions and their file formats include SQLite, DB, ACCDB, and MDB.

## Supported database file conversions

{{< include file="/conversion/net/_includes/supported-conversions/database.md" type="page" >}}

## Convert from database formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your document into another file format.  
For example, a LOG to PDF conversion code snippet looks like this:

```csharp
// Load the source LOG file
using (var converter = new GroupDocs.Conversion.Converter("sample.log"))
{
    // Set the convert options for PDF format
   var options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a LOG file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert database formats

Path: /conversion/nodejs-java/convert/database/

A database is a collection of data that is organized in tables and maintained on a computer storage device and accessed electronically. Relational databases store data in database tables that are linked to each other via formal design and modeling techniques. Data in a database is analyzed using the Database Management System (DBMS) which is the main source of interaction with end users, applications, and the database itself.

Popular database file extensions and their file formats include SQLite, DB, ACCDB, and MDB.

## Supported database file conversions

{{< include file="/conversion/java/_includes/supported-conversions/database.md" type="page" >}}

## Convert from database formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your document into another file format.  
For example, a LOG to PDF conversion code snippet looks like this:


```js
// Load the source LOG file
const converter = new groupdocs.conversion.Converter("sample.log")
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions()
// Convert to PDF format
converter.convert("converted.pdf", options)
```

Put it simply - you just load a LOG file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert diagrams

Path: /conversion/java/convert/diagram/


## About diagram formats

Microsoft Visio comes as part of the Microsoft Office suite and is used for diagramming and vector drawing applications. It is used to create several different types of diagrams including flow charts, UML diagrams, network diagrams, and a lot of others.

Visio file formats include file types such as VSDX, VSX, VTX, VDX, VSSX, VSTX, VSDM, VSSM, and VSTM file formats that are saved to the disc when a user creates a project in Microsoft Visio.

## Supported diagram file conversions

{{< include file="/conversion/java/_includes/supported-conversions/diagram.md" type="page" >}}

## Convert from diagram formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your diagram document into another file format.  
For example, VSDX to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source VSDX file
Converter converter = new Converter("sample.vsdx");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a diagram file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another diagram format

On the other hand, converting your diagram files to another diagram format is also quite simple and natural.
The following code snippet shows how to convert a VSDX format to a VDW format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java).

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.DiagramConvertOptions;
...
// Load the source VSDX file
Converter converter = new Converter("sample.vsdx");
// Set the convert options for VDW format
DiagramConvertOptions options = new DiagramConvertOptions();
options.setFormat(DiagramFileType.Vdw);
// Convert to VDW format
converter.convert("converted.vdw", options);
```

---

## Convert diagrams

Path: /conversion/net/convert/diagram/


## About diagram formats

Microsoft Visio comes as part of the Microsoft Office suite and is used for diagramming and vector drawing applications. It is used to create several different types of diagrams including flow charts, UML diagrams, network diagrams, and a lot of others.

Visio file formats include file types such as VSDX, VSX, VTX, VDX, VSSX, VSTX, VSDM, VSSM, VSTM file formats that are saved to the disc when a user creates a project in Microsoft Visio.

## Supported diagram file conversions

{{< include file="/conversion/net/_includes/supported-conversions/diagram.md" type="page" >}}

## Convert from diagram formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your diagram document into another file format.  
For example, VSDX to PDF conversion code snippet looks like this:

```csharp
// Load the source VSDX file
using (Converter converter = new Converter("sample.vsdx"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a diagram file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another diagram format

On the other hand, converting your diagram files to another diagram format is also quite simple and natural.
The following code snippet shows how to convert a VSDX format to a VDW format in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source VSDX file
using (Converter converter = new Converter("sample.vsdx"))
{
    // Set the convert options for VDW format
    var options = new DiagramConvertOptions {
        Format = DiagramFileType.Vdw
    };
    // Convert to VDW format
    converter.Convert("converted.vdw", options);
}
```

---

## Convert diagrams

Path: /conversion/nodejs-java/convert/diagram/


## About diagram formats

Microsoft Visio comes as part of the Microsoft Office suite and is used for diagramming and vector drawing applications. It is used to create several different types of diagrams including flow charts, UML diagrams, network diagrams, and a lot of others.

Visio file formats include file types such as VSDX, VSX, VTX, VDX, VSSX, VSTX, VSDM, VSSM, and VSTM file formats that are saved to the disc when a user creates a project in Microsoft Visio.

## Supported diagram file conversions

{{< include file="/conversion/java/_includes/supported-conversions/diagram.md" type="page" >}}

## Convert from diagram formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your diagram document into another file format.  
For example, VSDX to PDF conversion code snippet looks like this:

```js
// Load the source VSDX file
const converter = new groupdocs.conversion.Converter("sample.vsdx");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a diagram file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/nodejs-java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another diagram format

On the other hand, converting your diagram files to another diagram format is also quite simple and natural.
The following code snippet shows how to convert a VSDX format to a VDW format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java).

```js
// Load the source VSDX file
const converter = new groupdocs.conversion.Converter("sample.vsdx");
// Set the convert options for VDW format
const options = new groupdocs.conversion.DiagramConvertOptions();
options.setFormat(groupdocs.conversion.DiagramFileType.Vdw);
// Convert to VDW format
converter.convert("converted.vdw", options);
```

---

## Convert eBook formats

Path: /conversion/java/convert/ebook/


## About eBook file formats

eBook files are electronic files that can be opened on digital devices known as eReaders. An eReader can be any device such as a computer, a tablet, or a smartphone. The most popular eBook file format is the XML-based ePub. An eBook can contain different types of content such as text, images, and video. Common eBook file extensions and their file formats include EPUB (electronic publication), FB2 (FictionBook 2.0), and Mobi (MobiPocket eBook File).

## Supported eBook file conversions

{{< include file="/conversion/java/_includes/supported-conversions/ebook.md" type="page" >}}

## Convert from eBook formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your eBook document into another file format.  
For example, an eBook to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source eBook file
Converter converter = new Converter("sample.mobi");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an eBook file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to eBook formats

On the other hand, converting your files to eBook format is also quite simple and natural. Minimally, all you need is to specify the desired output format in the `setFormat` method of the [EBookConvertOptions](https://reference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert/ebookconvertoptions/) class instance.

The following code snippet shows how to convert a PDF document to eBook format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java).

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.EBookConvertOptions;
...
// Load the source PDF file
Converter converter = new Converter("sample.pdf");
// Set the convert options for eBook format
EBookConvertOptions options = new EBookConvertOptions();
options.setFormat(EBookFileType.Epub);
// Convert to eBook format
converter.convert("converted.epub", options);
```

---

## Convert eBook formats

Path: /conversion/net/convert/ebook/


## About eBook file formats

eBook files are electronic files that can be opened on digital devices known as eReaders. An eReader can be any device such as a computer, a tablet, or a smartphone. The most popular eBook file format is the XML-based ePub. An eBook can contain different types of content such as text, images, and video. Common eBook file extensions and their file formats include EPUB (electronic publication), FB2 (FictionBook 2.0), and Mobi (MobiPocket eBook File).

## Supported eBook file conversions

{{< include file="/conversion/net/_includes/supported-conversions/ebook.md" type="page" >}}

## Convert from eBook formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your eBook document into another file format.  
For example, an eBook to PDF conversion code snippet looks like this:

```csharp
// Load the source eBook file
using (Converter converter = new Converter("sample.mobi"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load an eBook file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to eBook formats

On the other hand, converting your files to eBook format is also quite simple and natural. Minimally, all you need is to specify the desired output format in the `Format` property of the [EBookConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ebookconvertoptions/) class instance.

The following code snippet shows how to convert a PDF document to eBook format in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source PDF file
using (Converter converter = new Converter("sample.pdf"))
{
    // Set the convert options for eBook format
    var options = new EBookConvertOptions {
        Format = EBookFileType.Epub
    };
    // Convert to eBook format
    converter.Convert("converted.epub", options);
}
```

---

## Convert eBook formats

Path: /conversion/nodejs-java/convert/ebook/


## About eBook file formats

eBook files are electronic files that can be opened on digital devices known as eReaders. An eReader can be any device such as a computer, a tablet, or a smartphone. The most popular eBook file format is the XML-based ePub. An eBook can contain different types of content such as text, images, and video. Common eBook file extensions and their file formats include EPUB (electronic publication), FB2 (FictionBook 2.0), and Mobi (MobiPocket eBook File).

## Supported eBook file conversions

{{< include file="/conversion/java/_includes/supported-conversions/ebook.md" type="page" >}}

## Convert from eBook formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your eBook document into another file format.  
For example, an eBook to PDF conversion code snippet looks like this:

```js
// Load the source eBook file
const converter = new groupdocs.conversion.Converter("sample.mobi");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an eBook file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/nodejs-java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to eBook formats

On the other hand, converting your files to eBook format is also quite simple and natural. Minimally, all you need is to specify the desired output format in the `setFormat` method of the [EBookConvertOptions](https://reference.groupdocs.com/conversion/nodejs-java/groupdocs.conversion.options.convert/ebookconvertoptions/) class instance.

The following code snippet shows how to convert a PDF document to eBook format in Java using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java).

```js
// Load the source PDF file
const converter = new groupdocs.conversion.Converter("sample.pdf");
// Set the convert options for eBook format
consst options = new groupdocs.conversion.EBookConvertOptions();
options.setFormat(groupdocs.conversion.EBookFileType.Epub);
// Convert to eBook format
converter.convert("converted.epub", options);
```

---

## Convert email formats

Path: /conversion/java/convert/email/

Email file formats are used by email applications to store their various data including email messages, attachments, folders, address books, etc. Email file formats are mainly associated with Outlook Express Email Message files. Additional types of files may also be using the Email file extension.

## Supported email file conversions

{{< include file="/conversion/java/_includes/supported-conversions/email-and-outlook.md" type="page" >}}

## Convert from email formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your document into another file format.  
For example, MSG to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source MSG file
Converter converter = new Converter("sample.msg");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an MSG file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert email formats

Path: /conversion/net/convert/email/

Email file formats are used by email applications to store their various data including email messages, attachments, folders, address books etc. Email file formats are mainly associated with Outlook Express Email Message files. Additional types of files may also be using the Email file extension.

## Supported email file conversions

{{< include file="/conversion/net/_includes/supported-conversions/email-and-outlook.md" type="page" >}}

## Convert from email formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your document into another file format.  
For example, MSG to PDF conversion code snippet looks like this:

```csharp
// Load the source MSG file
using (var converter = new GroupDocs.Conversion.Converter("sample.msg"))
{
    // Set the convert options for PDF format
   var options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load an MSG file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert email formats

Path: /conversion/nodejs-java/convert/email/

Email file formats are used by email applications to store their various data including email messages, attachments, folders, address books, etc. Email file formats are mainly associated with Outlook Express Email Message files. Additional types of files may also be using the Email file extension.

## Supported email file conversions

{{< include file="/conversion/java/_includes/supported-conversions/email-and-outlook.md" type="page" >}}

## Convert from email formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your document into another file format.  
For example, MSG to PDF conversion code snippet looks like this:

```js
// Load the source MSG file
const converter = new groupdocs.conversion.Converter("sample.msg");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an MSG file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert finance formats

Path: /conversion/net/convert/finance/

Financial formats provide a standardized structure for organizing and presenting financial data. They play a crucial role in streamlining financial processes, improving data accuracy, ensuring compliance, enhancing transparency, and facilitating efficient data exchange and analysis in the financial industry.
Popular finance file extensions and their file formats include XBRL, IXBRL and OFX.

## Supported finance file conversions

{{< include file="/conversion/net/_includes/supported-conversions/finance.md" type="page" >}}

## Convert from finance formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your finance document into another file format.  
For example, the XBRL to XLSX conversion code snippet looks like this:

```csharp
// Load the source XBRL file
using (var converter = new GroupDocs.Conversion.Converter("sample.xbrl"))
{
    // Set the convert options for Spreadsheet format
   var options = new SpreadsheetConvertOptions();
    // Convert to XLSX format
    converter.Convert("converted.xlsx", options);
}
```

Put it simply - you just load your finance document into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 

## Convert to another finance format

On the other hand, converting your files to another finance format is also quite simple and natural.
The following code snippet shows how to convert an XBRL document to an IXBRL format in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source XBRL file
using (var converter = new GroupDocs.Conversion.Converter("sample.xbrl"))
{
    // Set the convert options for finance format
    var options = new FinanceConvertOptions { 
       Format = FinanceFileType.IXbrl
    };
    // Convert to IXBRL format
    converter.Convert("converted.ixbrl", options);
}
```
---

## Convert font formats

Path: /conversion/java/convert/font/


Font files contain information about font tables, glyphs, and script outlines that can be accessed by an operating system and applications to render text. Popular file formats include TTF, OTF, CFF, and EOT.

## Supported font file conversions

{{< include file="/conversion/java/_includes/supported-conversions/font.md" type="page" >}}

## Convert to another font format

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your font file from one format into another.
For example, CFF to TTF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.FontConvertOptions;
...
// Load the source font file
Converter converter = new Converter("Lato-Regular.cff");
// Set the convert options
FontConvertOptions options = new FontConvertOptions();
options.setFormat(FontFileType.Ttf);
// Convert to TTF format
converter.convert("Lato-Regular.ttf", options);
```

Put it simply - you just load a CFF file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert font formats

Path: /conversion/net/convert/font/


Font files contain information about font tables, glyphs, and script outlines that can be accessed by an operating system and applications to render text. Popular file formats include TTF, OTF, CFF and EOT.

## Supported font file conversions

{{< include file="/conversion/net/_includes/supported-conversions/font.md" type="page" >}}

## Convert to another font format

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your font file from one format into another.
For example, CFF to TTF conversion code snippet looks like this:

```csharp
using GroupDocs.Conversion;
using GroupDocs.Conversion.FileTypes;
using GroupDocs.Conversion.Options.Convert;

// Load the source font file
using (Converter converter = new Converter("Lato-Regular.cff"))
{
    // Set the convert options
    var options = new FontConvertOptions
    {
        Format = FontFileType.Ttf
    };
    // Convert to TTF format
    converter.Convert("Lato-Regular.ttf", options);
}
```

Put it simply - you just load a CFF file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert font formats

Path: /conversion/nodejs-java/convert/font/


Font files contain information about font tables, glyphs, and script outlines that can be accessed by an operating system and applications to render text. Popular file formats include TTF, OTF, CFF, and EOT.

## Supported font file conversions

{{< include file="/conversion/java/_includes/supported-conversions/font.md" type="page" >}}

## Convert to another font format

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your font file from one format into another.
For example, CFF to TTF conversion code snippet looks like this:

```js
// Load the source font file
const converter = new groupdocs.conversion.Converter("Lato-Regular.cff");
// Set the convert options
const options = new groupdocs.conversion.FontConvertOptions();
options.setFormat(groupdocs.conversion.FontFileType.Ttf);
// Convert to TTF format
converter.convert("Lato-Regular.ttf", options);
```

Put it simply - you just load a CFF file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert GIS formats

Path: /conversion/net/convert/gis/


## About GIS file formats

A GIS (Geographic Information System) map file consists of spatial or geographic information about a certain location or area. A GIS mapping software is a program or set of programs that present spatial or geographical data to viewers for visualization, analysis and management. A GIS file can be created manually, extracted from a GPS device or recorded through remote sensing devices and applications. GIS finds its usage in almost all fields of life; from agriculture to town planning, resources analysis, urban planning and for creation of strategies to solve problems.

Common GIS file extensions and their file formats include GPX (GPS Exchange File Format), KML (Keyhole Markup Language File) and SHP (ESRI Shapefile).

## Supported GIS file conversions

{{< include file="/conversion/net/_includes/supported-conversions/gis.md" type="page" >}}

## Convert from GIS formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your GIS map file into another file format.  
For example, GPX to PDF conversion code snippet looks like this:

```csharp
// Load the source GPX file
using (Converter converter = new Converter("sample.gpx"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a GIS file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another GIS format

On the other hand, converting your GIS files to another GIS format is also quite simple and natural.
The following code snippet shows how to convert a GPX file to KML in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source GPX file
using (Converter converter = new Converter("sample.gpx"))
{
    // Set the convert options for KML format
    var options = new GisConvertOptions {
        Format = GisFileType.Kml
    };
    // Convert to KML format
    converter.Convert("converted.kml", options);
}
```

---

## Merge TEX

Path: /merger/net/merge/tex/


## How to merge TEX files in C#

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to merge TEX files when it's needed to organize multiple
 TEX files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine TEX documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge TEX files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source TEX file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another TEX file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other TEX documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged TEX file as parameter.

```csharp
// Load the source TEX file
using (Merger merger = new Merger(@"c:\sample1.tex"))
{
    // Add another TEX file to merge
    merger.Join(@"c:\sample2.tex");
    // Merge TEX files and save result
    merger.Save(@"c:\merged.tex");
}
```

### About TEX File Format 

TeX is a language that consists of programming as well as mark-up features, used to typeset documents. Donald Knuth from Stanford University, is the creator of this resourceful typesetting system. Across the world, TeX is the ultimate choice of authors and publishers to produce high quality technical documents. TeX performs an outstanding job of formatting complex mathematical expressions. In conjunction with a high-quality phototypesetter, TeX competes the results generated by the best traditional typesetting systems.

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge TEX Live Demo 

GroupDocs.Merger for .NET provides an online [**TEX Merger App**](https://products.groupdocs.app/merger/tex), which allows you to try it for free and check its quality and accuracy.

[!["Merge TEX"](/merger/net/images/merge/merge-tex.png)](https://products.groupdocs.app/merger/tex)
---

## Convert note-taking formats

Path: /conversion/java/convert/note/


## About note-taking file formats

Note-taking program files contain sections and pages for storing notes. A note document can be as simple as a text document as well as more detailed consisting of digital images, audio/video clips, and hand sketch drawings.

Common OneNote file extensions and their associated file formats is .ONE.

## Supported note-taking file conversions

{{< include file="/conversion/java/_includes/supported-conversions/note.md" type="page" >}}

## Convert from note-taking formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your OneNote document into another file format. For example, OneNote to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source OneNote file
Converter converter = new Converter("sample.one");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a OneNote file into the `Converter` class instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## Convert note-taking formats

Path: /conversion/net/convert/note/


## About note-taking file formats

Note-taking program files contain sections and pages for storing notes. A note document can be as simple as a text document as well as more detailed consisting of digital images, audio/video clips, and hand sketch drawings.

Common OneNote file extensions and their associated file formats is .ONE.

## Supported note-taking file conversions

{{< include file="/conversion/net/_includes/supported-conversions/note.md" type="page" >}}

## Convert from note-taking formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your OneNote document into another file format. For example, OneNote to PDF conversion code snippet looks like this:

```csharp
// Load the source OneNote file
using (Converter converter = new Converter("sample.one"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a OneNote file into the `Converter` class instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## Convert note-taking formats

Path: /conversion/nodejs-java/convert/note/


## About note-taking file formats

Note-taking program files contain sections and pages for storing notes. A note document can be as simple as a text document as well as more detailed consisting of digital images, audio/video clips, and hand sketch drawings.

Common OneNote file extensions and their associated file formats is .ONE.

## Supported note-taking file conversions

{{< include file="/conversion/java/_includes/supported-conversions/note.md" type="page" >}}

## Convert from note-taking formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your OneNote document into another file format. For example, OneNote to PDF conversion code snippet looks like this:

```js
// Load the source OneNote file
const converter = new groupdocs.conversion.Converter("sample.one");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a OneNote file into the `Converter` class instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/nodejs-java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## Convert page layout formats

Path: /conversion/net/convert/page-layout/


## About page layout formats

Page layout languages are used in desktop and electronic publishing. The main focus of these languages is to facilitate a two-dimensional graphic design. Popular page layout formats include TEX, SVG, PS, and EPS.

## Supported page layout conversions

{{< include file="/conversion/net/_includes/supported-conversions/page-description-language.md" type="page" >}}

## Convert from page layout formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert a page layout file format into another file format.  
For example, the TEX to PDF conversion code snippet looks like this:

```csharp
// Load the source TEX file
using (var converter = new GroupDocs.Conversion.Converter("sample.tex"))
{
    // Set the convert options for PDF format
   var options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a page layout file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to page layout formats

On the other hand, converting your files to page layout format is also quite simple and natural.
The following code snippet shows how to convert a DOCX document to TEX format in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source DOCX file
using (var converter = new GroupDocs.Conversion.Converter("sample.docx"))
{
    // Set the convert options
    var options = new PageDescriptionLanguageConvertOptions()
    {
        Format = PageDescriptionLanguageFileType.Tex
    };
    // Convert to TEX format
    converter.Convert("converted.tex", options);
}
```

---

## Convert project management formats

Path: /conversion/java/convert/project-management/

A project file is a collection of tasks, resources, and scheduling to get a measurable output in the form of a product or a service. Gantt charts are used to establish a visual flow of activities against time for the identified tasks that can also be exported to PDF or image formats for documentation.
Common Project Management file extensions and their associated file formats include MPP, MPX and XER.

## Supported project management file conversions

{{< include file="/conversion/java/_includes/supported-conversions/project-management.md" type="page" >}}

## Convert from project management formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your document into another file format.  
For example, the MPP to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source MPP file
Converter converter = new Converter("sample-project.mpp");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an MPP file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert project management formats

Path: /conversion/net/convert/project-management/

A project file is a collection of tasks, resources, and scheduling to get a measurable output in the form of a product or a service. Gantt charts are used to establish a visual flow of activities against time for the identified tasks that can also be exported to PDF or image formats for documentation.
Common Project Management file extensions and their associated file formats include MPP, MPX and XER.

## Supported project management file conversions

{{< include file="/conversion/net/_includes/supported-conversions/project-management.md" type="page" >}}

## Convert from project management formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your document into another file format.  
For example, the MPP to PDF conversion code snippet looks like this:

```csharp
// Load the source MPP file
using (var converter = new GroupDocs.Conversion.Converter("sample-project.mpp"))
{
    // Set the convert options for PDF format
   var options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load an MPP file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert project management formats

Path: /conversion/nodejs-java/convert/project-management/

A project file is a collection of tasks, resources, and scheduling to get a measurable output in the form of a product or a service. Gantt charts are used to establish a visual flow of activities against time for the identified tasks that can also be exported to PDF or image formats for documentation.
Common Project Management file extensions and their associated file formats include MPP, MPX and XER.

## Supported project management file conversions

{{< include file="/conversion/java/_includes/supported-conversions/project-management.md" type="page" >}}

## Convert from project management formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your document into another file format.  
For example, the MPP to PDF conversion code snippet looks like this:

```js
// Load the source MPP file
const converter = new groupdocs.conversion.Converter("sample-project.mpp");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load an MPP file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest. 
---

## Convert publisher formats

Path: /conversion/java/convert/publisher/


## About Publisher formats

If you are in the digital marketing business, do email marketing, or have some publishing agency, you must be aware of Microsoft Publisher. It lets you create design layouts that contain information including text, raster and vector graphics. These can be used to create newsletters, flyers, brochures, postcards, and email content.

Publisher file formats include file types such as PUB file format that is saved to a disc when a user creates a project in Microsoft Publisher and saves it to disc.

## Supported Publisher file conversions

{{< include file="/conversion/java/_includes/supported-conversions/publisher.md" type="page" >}}

## Convert from Publisher formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/java) you can easily convert your Publisher file into another file format. For example, the Publisher to PDF conversion code snippet looks like this:

```java
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
...
// Load the source Publisher file
Converter converter = new Converter("sample.pub");
// Set the convert options for PDF format
PdfConvertOptions options = new PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a Publisher file into the `Converter` class instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## Convert publisher formats

Path: /conversion/net/convert/publisher/


## About Publisher formats

If you are in the digital marketing business, do email marketing, or have some publishing agency, you must be aware of Microsoft Publisher. It lets you create design layouts that contain information including text, raster and vector graphics. These can be used to create newsletters, flyers, brochures, postcards, and email content.

Publisher file formats include file types such as PUB file format that is saved to a disc when a user creates a project in Microsoft Publisher and saves it to disc.

## Supported Publisher file conversions

{{< include file="/conversion/net/_includes/supported-conversions/publisher.md" type="page" >}}

## Convert from Publisher formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your Publisher file into another file format. For example, the Publisher to PDF conversion code snippet looks like this:

```csharp
// Load the source Publisher file
using (Converter converter = new Converter("sample.pub"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a Publisher file into the `Converter` class instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## Convert publisher formats

Path: /conversion/nodejs-java/convert/publisher/


## About Publisher formats

If you are in the digital marketing business, do email marketing, or have some publishing agency, you must be aware of Microsoft Publisher. It lets you create design layouts that contain information including text, raster and vector graphics. These can be used to create newsletters, flyers, brochures, postcards, and email content.

Publisher file formats include file types such as PUB file format that is saved to a disc when a user creates a project in Microsoft Publisher and saves it to disc.

## Supported Publisher file conversions

{{< include file="/conversion/java/_includes/supported-conversions/publisher.md" type="page" >}}

## Convert from Publisher formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/nodejs-java) you can easily convert your Publisher file into another file format. For example, the Publisher to PDF conversion code snippet looks like this:

```js
// Load the source Publisher file
const converter = new groupdocs.conversion.Converter("sample.pub");
// Set the convert options for PDF format
const options = new groupdocs.conversion.PdfConvertOptions();
// Convert to PDF format
converter.convert("converted.pdf", options);
```

Put it simply - you just load a Publisher file into the `Converter` class instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/nodejs-java/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## Working with attributes

Path: /search/java/working-with-attributes/

Text attributes of documents are changed without the need to re-index documents in the search network.

To change document attributes, use the [changeAttributes](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#changeAttributes-com.groupdocs.search.common.AttributeChangeBatch-com.groupdocs.search.options.ChangeAttributesOptions-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class.

The asynchronous operation flag is available as an option. You can track the completion of the operation by subscribing to the [AttributeChangesCompleted](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.events/nodeeventhub/#AttributeChangesCompleted) event.

The following code example demonstrates changing document attributes on the search network.

```java
System.out.println("Adding attribute: " + attribute);

Indexer indexer = node.getIndexer();

AttributeChangeBatch batch = new AttributeChangeBatch();
batch.add(documentKey, attribute);
ChangeAttributesOptions options = new ChangeAttributesOptions();
indexer.changeAttributes(batch, options);
```

To get all the attributes of a document, use the [getAttributes](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#getAttributes-java.lang.String-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class. You must pass the document key as a parameter.

The following code example demonstrates retrieving document attributes from the search network.

```java
Searcher searcher = node.getSearcher();
Indexer indexer = node.getIndexer();

int[] shardIndices = node.getShardIndices();
System.out.println();
for (int i = 0; i < shardIndices.length; i++) {
    int shardIndex = shardIndices[i];
    NetworkDocumentInfo[] infos = searcher.getIndexedDocuments(shardIndex);
    for (NetworkDocumentInfo info : infos) {
        int nodeIndex = node.getNodeIndex(info.getShardIndex());
        System.out.println(nodeIndex + ": " + info.getShardIndex() + ": " +
                hasErrors(info) + ": " + info.getDocumentInfo().getFilePath());
        String[] attributes = indexer.getAttributes(info.getDocumentInfo().getFilePath());
        for (String attribute1 : attributes) {
            System.out.println("\t\t" + attribute1);
        }
    }
}
```

More information about working with text attributes of documents in the article [Document attributes](https://docs.groupdocs.com/search/java/document-attributes/).

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with attributes

Path: /search/net/working-with-attributes/

Text attributes of documents are changed without the need to re-index documents in the search network.

To change document attributes, use the [ChangeAttributes](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/changeattributes/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class.

The asynchronous operation flag is available as an option. You can track the completion of the operation by subscribing to the [AttributeChangesCompleted](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.events/nodeeventhub/attributechangescompleted/) event.

The following code example demonstrates changing document attributes on the search network.

**C#**

```csharp
Console.WriteLine("Adding attribute: " + attribute);

Indexer indexer = node.Indexer;

AttributeChangeBatch batch = new AttributeChangeBatch();
batch.Add(documentKey, attribute);
ChangeAttributesOptions options = new ChangeAttributesOptions();
indexer.ChangeAttributes(batch, options);
```

To get all the attributes of a document, use the [GetAttributes](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/getattributes/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class. You must pass the document key as a parameter.

The following code example demonstrates retrieving document attributes from the search network.

**C#**

```csharp
Searcher searcher = node.Searcher;
Indexer indexer = node.Indexer;

int[] shardIndices = node.GetShardIndices();
Console.WriteLine();
for (int i = 0; i < shardIndices.Length; i++)
{
    int shardIndex = shardIndices[i];
    NetworkDocumentInfo[] infos = searcher.GetIndexedDocuments(shardIndex);
    for (int j = 0; j < infos.Length; j++)
    {
        NetworkDocumentInfo info = infos[j];
        int nodeIndex = node.GetNodeIndex(info.ShardIndex);
        Console.WriteLine(nodeIndex + ": " + info.ShardIndex + ": " +
            HasErrors(info) + ": " + info.DocumentInfo.FilePath);
        string[] attributes = indexer.GetAttributes(info.DocumentInfo.FilePath);
        for (int k = 0; k < attributes.Length; k++)
        {
            Console.WriteLine("\t\t" + attributes[k]);
        }
    }
}
```

More information about working with text attributes of documents in the article [Document attributes](https://docs.groupdocs.com/search/net/document-attributes/).

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with formats

Path: /editor/java/working-with-formats/

> This article describes classes and interfaces of [**GroupDocs.Editor**](https://products.groupdocs.com/editor/java), which represent all supportable family formats and individual formats.

GroupDocs.Editor supports different document formats, all of them are conditionally divided onto several family formats:

1. WordProcessing formats, which includes DOC, DOCX, DOCM, RTF, ODT etc.
2. Spreadsheet formats, which includes XLS, XLT, XLSX, XLSM, XLTX, ODS etc.
3. Delimiter-Separated Values (DSV) formats, also known as delimited text, that are text-based form of spreadsheets, and includes CSV, TSV, semicolon-delimited, whitespace-delimited etc.
4. Presentation formats, which includes PPT, PPS, POT, PPTX, PPTM etc.
5. Text-based formats, which includes TXT, HTML, XML etc.
6. Fixed-layout formats, which includes only PDF at this time (for version 19.12).

For representing some of these format families the [Formats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/)namespace and [IDocumentFormat](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/idocumentformat) interface exists, along with four inheritors of this interface:

1. [WordProcessingFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats), which is common for all WordProcessing formats.
2. [SpreadsheetFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/spreadsheetformats), which is common for all Spreadsheet formats.
3. [PresentationFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/presentationformats), which is common for all Presentation formats.
4. [TextualFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/textualformats), which is common for all text-based formats, including plain text (TXT), markup formats (XML and HTML), and all Delimiter-Separated Values (DSV) formats.

All these types are immutable structs, all of them have text properties, which reflect their names and file extensions, all of them are equatable. Every struct has a set of static fields, each one represents one specific format within given family format. For every struct there is a `FromExtension` static method, that obtains a file extension, parses it and returns an instance of appropriate format. Every struct has an `All` static field, which allows enumeration over all specific formats within given family format.

Example below demonstrates all main features for the [WordProcessingFormats](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.formats/wordprocessingformats) struct; same is applicable for all other structs.

```java
//fetching one format
WordProcessingFormats dotm = WordProcessingFormats.Dotm;
System.out.println(String.format("DOT Macro-enabled: Name is {0}, extension is {1}", dotm.getName(), dotm.getExtension()));
//iterating over all formats within WordProcessing family
for (WordProcessingFormats oneFormat : (Iterable<WordProcessingFormats>) WordProcessingFormats.All) {
    System.out.println(String.format("Name is {0}, extension is {1}", oneFormat.getName(), oneFormat.getExtension()));
}
//Parsing from extension
WordProcessingFormats expectedDocm = WordProcessingFormats.fromExtension(".docm");
```

---

## Working with formats

Path: /editor/net/working-with-formats/

> This article describes classes and interfaces of [**GroupDocs.Editor**](https://products.groupdocs.com/editor/net), which represent all supportable family formats and individual formats.

GroupDocs.Editor supports different document formats, all of them are conditionally divided onto several family formats:

1. WordProcessing formats, which includes DOC, DOCX, DOCM, RTF, ODT etc.
2. Spreadsheet formats, which includes XLS, XLT, XLSX, XLSM, XLTX, ODS etc.
3. Delimiter-Separated Values (DSV) formats, also known as delimited text, that are text-based form of spreadsheets, and includes CSV, TSV, semicolon-delimited, whitespace-delimited etc.
4. Presentation formats, which includes PPT, PPS, POT, PPTX, PPTM etc.
5. Text-based formats, which includes TXT, HTML, XML etc.
6. Fixed-layout formats, which includes PDF and XPS formats, where their representation is "baked" to be uniform on every platform.
7. eBook formats, which includes Mobi, AZW3 and ePub.
8. Email formats, which includes MSG, EML, PST and others.

For representing some of these format families the [Formats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/) namespace and [IDocumentFormat](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/idocumentformat) interface exists, along with seven inheritors of this interface:

1. [WordProcessingFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats), which is common for all WordProcessing formats.
2. [SpreadsheetFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/spreadsheetformats), which is common for all Spreadsheet formats.
3. [PresentationFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/presentationformats), which is common for all Presentation formats.
4. [TextualFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/textualformats), which is common for all text-based formats, including plain text (TXT), markup formats (XML and HTML), and all Delimiter-Separated Values (DSV) formats.
5. [EBookFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/ebookformats), which is common for all E-book formats, including MOBI, AZW3, and ePub.
6. [FixedLayoutFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/fixedlayoutformats), which is common for only the PDF and XPS (this includes OpenXPS).
7. [EmailFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/emailformats), which is common for all electronic mail formats.

All these types are immutable structs, all of them have text properties, which reflect their names, MIME codes, and file extensions, all of them are equatable. Every struct has a set of static fields, each one represents one specific format within given family format. For every struct there is a `FromExtension` static method, that obtains a file extension, parses it and returns an instance of appropriate format. Every struct has an `All` static field, which allows enumeration over all specific formats within given family format.

Example below demonstrates all main features for the [WordProcessingFormats](https://reference.groupdocs.com/editor/net/groupdocs.editor.formats/wordprocessingformats) struct; same is applicable for all other structs.

```csharp
//fetching one format
WordProcessingFormats dotm = Formats.WordProcessingFormats.Dotm;
Console.WriteLine("DOT Macro-enabled: Name is {0}, extension is {1}", dotm.Name, dotm.Extension);
//iterating over all formats within WordProcessing family
foreach (WordProcessingFormats oneFormat in Formats.WordProcessingFormats.All)
{
    Console.WriteLine("Name is {0}, extension is {1}", oneFormat.Name, oneFormat.Extension);
}
//Parsing from extension
Formats.WordProcessingFormats expectedDocm = WordProcessingFormats.FromExtension(".docm");
```

---

## Merge EPUB

Path: /merger/net/merge/epub/


## How to merge EPUB files in C\#

You can easily combine multiple EPUB files into one using [GroupDocs.Merger](https://products.groupdocs.com/merger/net) library API and all the files content will be preserved.
The following example demonstrates how to merge EPUB files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source EPUB file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another EPUB file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other EPUB documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged EPUB file as parameter.

```csharp
// Load the source EPUB file
using (Merger merger = new Merger(@"c:\sample1.epub"))
{
    // Add another EPUB file to merge
    merger.Join(@"c:\sample2.epub");
    // Merge EPUB files and save result
    merger.Save(@"c:\merged.epub");
}
```

### About EPUB File Format 

Files with .EPUB extension are an e-book file format that provide a standard digital publication format for publishers and consumers. The format has been so common by now that it is supported by many e-readers and software applications. For example, on Mac OS, the pre-installed Books software provides the support for opening such files. In addition, there are a lot of compatible software available for smartphones, tablets and computers.

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge EPUB Live Demo 

GroupDocs.Merger for .NET provides an online [**EPUB Merger App**](https://products.groupdocs.app/merger/epub), which allows you to try it for free and check its quality and accuracy.

[!["Merge EPUB"](/merger/net/images/merge/merge-epub.png)](https://products.groupdocs.app/merger/epub)
---

## Text search in network

Path: /search/java/text-search-in-network/

To run a text search, use the [searchFirst](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#searchFirst-java.lang.String-com.groupdocs.search.options.SearchOptions-) method of the [Searcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/) class. This method returns the first portion of results.

To continue the search, the [searchNext](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#searchNext-com.groupdocs.search.scaling.results.NetworkSearchToken-) method is used, returning the second and subsequent portions of results.

Text and object forms of the search query are supported when appropriate overloads of the SearchFirst method are used. The options for a network search are the same as those for a single index search.

The following code example demonstrates performing a full-text search on the search network.

```java
Searcher searcher = node.getSearcher();

SearchOptions options = new SearchOptions();
options.setChunkSearch(true);
options.setUseSynonymSearch(useSynonymSearch);
int totalOccurrences = 0;
ArrayList<NetworkFoundDocument> documents = new ArrayList<NetworkFoundDocument>();

NetworkSearchResult result;
if (isObjectForm) {
    SearchQuery query = SearchQuery.createWordQuery(word);
    System.out.println();
    System.out.println("First time search in object form for: " + query);
    result = searcher.searchFirst(query, options);
} else {
    String query = word;
    System.out.println();
    System.out.println("First time search in text form for: " + query);
    result = searcher.searchFirst(query, options);
}

addDocsFromResult(documents, result);
totalOccurrences += result.getOccurrenceCount();
traceResult(result);

while (result.getNextChunkSearchToken() != null) {
    System.out.println();
    System.out.println("Next time search for: " + word);

    result = searcher.searchNext(result.getNextChunkSearchToken());

    addDocsFromResult(documents, result);
    totalOccurrences += result.getOccurrenceCount();
    traceResult(result);
}

System.out.println();
System.out.println("Total occurrences: " + totalOccurrences);
```

More information about search queries can be found in the article [Queries in text and object form](https://docs.groupdocs.com/search/java/queries-in-text-and-object-form/).

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Text search in network

Path: /search/net/text-search-in-network/

To run a text search, use the [SearchFirst](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/searchfirst/#searchfirst_1) method of the [Searcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/) class. This method returns the first portion of results.

To continue the search, the [SearchNext](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/searchnext/) method is used, returning the second and subsequent portions of results.

Text and object forms of the search query are supported when appropriate overloads of the SearchFirst method are used. The options for a network search are the same as those for a single index search.

The following code example demonstrates performing a full-text search on the search network.

**C#**

```csharp
Searcher searcher = node.Searcher;

SearchQuery query = SearchQuery.CreateWordQuery(word);
Console.WriteLine();
Console.WriteLine("First time search for: " + query);
SearchOptions options = new SearchOptions();
options.IsChunkSearch = true;
options.UseSynonymSearch = useSynonymSearch;
int totalOccurrences = 0;
List<NetworkFoundDocument> documents = new List<NetworkFoundDocument>();

NetworkSearchResult result = searcher.SearchFirst(query, options);

AddDocsFromResult(documents, result);
totalOccurrences += result.OccurrenceCount;
TraceResult(result);

while (result.NextChunkSearchToken != null)
{
    Console.WriteLine();
    Console.WriteLine("Next time search for: " + query);

    result = searcher.SearchNext(result.NextChunkSearchToken);

    AddDocsFromResult(documents, result);
    totalOccurrences += result.OccurrenceCount;
    TraceResult(result);
}

Console.WriteLine();
Console.WriteLine("Total occurrences: " + totalOccurrences);
```

More information about search queries can be found in the article [Queries in text and object form](https://docs.groupdocs.com/search/net/queries-in-text-and-object-form/).

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Working with HTML resources

Path: /editor/java/working-with-html-resources/

> This article describes capabilities of GroupDocs.Editor while working with HTML resources, which are an integral part of HTML document


## What HTML resources are?
Almost all existing document formats (except of plain TXT and some others) contain a concept of _resources_. This usually includes images, specific fonts (which are not installed in operating system) and so on - depending on specific document format. In order to edit documents in browser, the GroupDocs.Editor must convert them to HTML and only then send to the client-side WYSIWYG-editor. In this case GroupDocs.Editor must work with HTML resources, which may be divided onto three groups: _images_, _stylesheets_ and _fonts_.

In context of public API of the GroupDocs.Editor the work with all resources is located inside the [`com.groupdocs.editor.htmlcss.resources`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/) namespace. There is a public interface — [`IHtmlResource`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource), which is common for all existing HTML resources. There are also three sub-namespaces — each one for a distinct resource type:

1. [`com.groupdocs.editor.htmlcss.resources.images`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images/) — contains all supportable image formats, including raster (like JPEG, PNG and GIF) and vector (SVG and WMF/EMF). The [`Images`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images/) namespace itself contains several auxiliary types and interfaces, and also two sub-namespaces: [com.groupdocs.editor.htmlcss.resources.images.raster](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.raster/) and [com.groupdocs.editor.htmlcss.resources.images.vector](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.images.vector/). Each of these two sub-namespaces contains specific classes for specific image formats.
2. [`com.groupdocs.editor.htmlcss.resources.fonts`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.fonts/) — contains classes, which represent each supportable font formats: WOFF, WOFF2, TTF, OTF, and EOT.
3. [`com.groupdocs.editor.htmlcss.resources.textual`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.textual/) — contains classes, which represent all supportable textual formats: CSS and XML.
4. [`com.groupdocs.editor.htmlcss.resources.audio`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.audio/) — contains classes, which represent all supportable audio formats. This namespace was added in version 22.6 and initially it supports only MP3 audio format, so there is only one class for representing it: [Mp3Audio](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources.audio/mp3audio).

## Detecting the exact HTML resource format automatically

Lets imagine a situation, when a customer edited a document in WYSIWYG-editor, obtained edited HTML markup with HTML resources (images, one or multiple stylesheets, and fonts, and even possible some audio files), and want to create an instance of [`EditableDocument`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument) class using a [`fromMarkup`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editabledocument#fromMarkup-java.lang.String-java.util.List-com.groupdocs.editor.htmlcss.resources.IHtmlResource--) method, which obtains on input a string with HTML markup and a [IHtmlResource](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource) , which in fact usually is a collection of HTML resources. But how should he obtain a set of [IHtmlResource](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource) instances, taking into account that all resources are represented as a set of files (in better case) or even as a set of byte streams? For such case GroupDocs.Editor contains a special utility class [com.groupdocs.editor.htmlcss.resources.ResourceTypeDetector](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/resourcetypedetector). This static class was introduced in the version 22.4 and contains only two static methods:

1. [**detectTypeFromFilename**](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/resourcetypedetector#detectTypeFromFilename(java.lang.String)) — obtains a filename with extension (or a pure extension) on input and tries to associate it with the most appropriate resource format. If successful, returns a type, which describes this format, in a form of a [IResourceType](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/iresourcetype) inheritor. If format cannot be properly recognized, returns a NULL value. So, if user has a filename of a resource, and using this method, he can determine a format. But what to do, if there are no filenames with extension or even files, and resources are represented by byte streams? Of filenames are meaningless, have no extension, or their extensions are aforehand incorrect? For such cases the next method is suitable.

2. [**tryDetectResource**](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/resourcetypedetector#tryDetectResource(-java.io.InputStream-java.lang.String-com.groupdocs.editor.htmlcss.resources.IResourceType-)) — obtains on input a byte stream ([InputStream](https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html)), filename and optionally an assumptive format, parses and recognizes input data and returns an inheritor of ['IHtmlResource'](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.htmlcss.resources/ihtmlresource) interface on success or NULL value on failure. This method analyzes a content of input byte stream in any case and returns a valid format even if filename extension and assumptive format are both incorrect; such miscase will only worsen a performance. On another hand, correct filename extension and/or assumptive format do increase a performance. Anyway, input stream should be a completely valid: it must not be a NULL value or a Stream.Null instance, it should be readable and seekable, should not be disposed and its position should be valid.

---

## Working with HTML resources

Path: /editor/net/working-with-html-resources/

> This article describes capabilities of GroupDocs.Editor while working with HTML resources, which are an integral part of HTML document


## What HTML resources are?
Almost all existing document formats (except of plain TXT and some others) contain a concept of _resources_. This usually includes images, specific fonts (which are not installed in operating system) and so on - depending on specific document format. In order to edit documents in browser, the GroupDocs.Editor must convert them to HTML and only then send to the client-side WYSIWYG-editor. In this case GroupDocs.Editor must work with HTML resources, which may be divided onto three groups: _images_, _stylesheets_ and _fonts_.

In context of public API of the GroupDocs.Editor the work with all resources is located inside the [`GroupDocs.Editor.HtmlCss.Resources`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/) namespace. There is a public interface — [`IHtmlResource`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource), which is common for all existing HTML resources. There are also three sub-namespaces — each one for a distinct resource type:

1. [`GroupDocs.Editor.HtmlCss.Resources.Images`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images/index) — contains all supportable image formats, including raster (like JPEG, PNG and GIF) and vector (SVG and WMF/EMF). The [`Images`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images) namespace itself contains several auxiliary types and interfaces, and also two sub-namespaces: [GroupDocs.Editor.HtmlCss.Resources.Images.Raster](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.raster) and [GroupDocs.Editor.HtmlCss.Resources.Images.Vector](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.images.vector). Each of these two sub-namespaces contains specific classes for specific image formats.
2. [`GroupDocs.Editor.HtmlCss.Resources.Fonts`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.fonts) — contains classes, which represent each supportable font formats: WOFF, WOFF2, TTF, OTF, and EOT.
3. [`GroupDocs.Editor.HtmlCss.Resources.Textual`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.textual) — contains classes, which represent all supportable textual formats: CSS and XML.
4. [`GroupDocs.Editor.HtmlCss.Resources.Audio`](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.audio) — contains classes, which represent all supportable audio formats. This namespace was added in version 21.10 and initially it supports only MP3 audio format, so there is only one class for representing it: [Mp3Audio](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources.audio/mp3audio).

## Detecting the exact HTML resource format automatically

Lets imagine a situation, when a customer edited a document in WYSIWYG-editor, obtained edited HTML markup with HTML resources (images, one or multiple stylesheets, and fonts, and even possible some audio files), and want to create an instance of [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class using a [`FromMarkup`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument/frommarkup) method, which obtains on input a string with HTML markup and a <code>IEnumerable&lt;<a href="https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource">IHtmlResource</a>&gt;</code>, which in fact usually is a collection of HTML resources. But how should he obtain a set of [IHtmlResource](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource) instances, taking into account that all resources are represented as a set of files (in better case) or even as a set of byte streams? For such case GroupDocs.Editor contains a special utility class [GroupDocs.Editor.HtmlCss.Resources.ResourceTypeDetector](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/resourcetypedetector). This static class was introduced in the version 21.3 and contains only two static methods:

1. [**DetectTypeFromFilename**](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/resourcetypedetector/detecttypefromfilename) — obtains a filename with extension (or a pure extension) on input and tries to associate it with the most appropriate resource format. If successful, returns a type, which describes this format, in a form of a [IResourceType](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/iresourcetype) inheritor. If format cannot be properly recognized, returns a NULL value. So, if user has a filename of a resource, and using this method, he can determine a format. But what to do, if there are no filenames with extension or even files, and resources are represented by byte streams? Of filenames are meaningless, have no extension, or their extensions are aforehand incorrect? For such cases the next method is suitable.

2. [**TryDetectResource**](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/resourcetypedetector/trydetectresource) — obtains on input a byte stream ([System.IO.Stream](http://msdn2.microsoft.com/en-us/library/8f86tw9e)), filename and optionally an assumptive format, parses and recognizes input data and returns an inheritor of ['IHtmlResource'](https://reference.groupdocs.com/editor/net/groupdocs.editor.htmlcss.resources/ihtmlresource) interface on success or NULL value on failure. This method analyzes a content of input byte stream in any case and returns a valid format even if filename extension and assumptive format are both incorrect; such miscase will only worsen a performance. On another hand, correct filename extension and/or assumptive format do increase a performance. Anyway, input stream should be a completely valid: it must not be a NULL value or a Stream.Null instance, it should be readable and seekable, should not be disposed and its position should be valid.

---

## Edit Markdown documents

Path: /editor/java/edit-markdown/

> This example demonstrates the standard open-edit-save pipeline with Markdown (MD) documents, using different options on every step.

## Introduction

[Markdown](https://docs.fileformat.com/word-processing/md/) is a lightweight markup language, which became popular last time. Markdown files with an `*.md` extension are actually plain text files, contain special syntax, support text formatting, tables, lists, images and so on. There are actually several dialects of markdown, including GFM, CommonMark, Multi-Markdown and so on.

Starting from the [version 23.2](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-2-release-notes/), GroupDocs.Editor for Java fully supports the Markdown format on both import, export, and also its auto-detection.

As for the [version 23.2](https://docs.groupdocs.com/editor/java/groupdocs-editor-for-java-23-2-release-notes/), GroupDocs.Editor for Java supports the following Markdown features, which mostly follow the CommonMark specification and are represented as appropriate styles or direct formatting:

- Headings
- Blockquotes
- Code blocks
- Horizontal rules
- Bold emphasis
- Italic emphasis
- StrikeThrough formatting
- Numbered and bulleted lists
- Tables
- Internal images, stored with base64 encoding
- External images

## Loading

Loading of the Markdown documents to the [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) class is usual and the same as for other formats. There are no dedicated load options for the Markdown format, it is enough to specify the file itself through file path or [`InputStream`](https://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html).

Code example below shows loading the same Markdown file to the two [`Editor`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/) instances through file path and a byte stream, and then checking how the GroupDocs.Editor will detect the format of specified file.

```java
String filename = "sample.md";
String inputPath = System.IO.Path.Combine("markdown folder", filename);

Editor fromStream = new Editor(new FileInputStream(inputPath));
Editor fromPath = new Editor(inputPath);

com.groupdocs.editor.metadata.IDocumentInfo info = fromPath.getDocumentInfo(null);
Assert.assertEquals(com.groupdocs.editor.formats.TextualFormats.Md, info.getFormat());


```

## Editing

There is a special class [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdowneditoptions/) for editing the Markdown files. As always, it is not mandatory when editing a document, so the [`Editor.edit()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#edit--) overload without parameter may be used — GroupDocs.Editor will automatically detect the format and apply the default options.

However, specifying the custom [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdowneditoptions/) may be vital when an input Markdown file has external images; “external” means that images are stored somewhere else, and in the Markdown code there are _links_ to these images. When [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdowneditoptions/) are not specified and correctly tuned (explained below), the GroupDocs.Editor will not be able to locate such images. In order to point all external images, the instance of [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdowneditoptions/) should be created, and an [`getImageLoadCallback()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdowneditoptions/#getImageLoadCallback--) property should be correctly specified.

For doing this the user must create its own type, that implements a [`IMarkdownImageLoadCallback`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/imarkdownimageloadcallback/) interface. This interface defines a single method [`processImage()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/imarkdownimageloadcallback/#processImage-com.groupdocs.editor.options.MarkdownImageLoadArgs-), which obtains a [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadargs/) type and must return a value of [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadingaction/) enumeration.

Working mechanism is the next. GroupDocs.Editor parses an input Markdown file line by line, character by character. When it encounters the link to the external image, it creates an instance of [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadargs/) with all data about this image — its filename (or relative path, or URL) and a boolean flag, that indicates whether it is a local link (in the filesystem) or a web link. Then, when [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdowneditoptions/) have the [`setImageLoadCallback`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdowneditoptions/#setImageLoadCallback-com.groupdocs.editor.options.IMarkdownImageLoadCallback-) property specified with the user implementation of [`IMarkdownImageLoadCallback`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/imarkdownimageloadcallback/), then GroupDocs.Editor invokes the [`processImage()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/imarkdownimageloadcallback/#processImage-com.groupdocs.editor.options.MarkdownImageLoadArgs-) method by passing a prepared [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadargs/) into it. Then GroupDocs.Editor “waits” until the user code makes a decision — a return value of the [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadingaction/) enumeration.

If user implementation returns a [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadingaction/#Skip)`.Skip` value, then the image will be skipped — the resultant document will have an “empty area”, where the image should be.

If user implementation returns a [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadingaction/#Default)`.Default` value, then the GroupDocs.Editor will try to load an image by itself — this is possible, if, for example, a link to image is an absolute path or URL.

If user implementation returns a [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadingaction/#UserProvided)`.UserProvided`, then this means that user code must provide the image data by itself specifying it in the [`setData(byte[] data)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadargs/#setData-byte---). In that case GroupDocs.Editor will process the specified binary data for this image.

Code example below shows exactly the last scenario, where the end-user creates his own implementation of the [`IMarkdownImageLoadCallback`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/imarkdownimageloadcallback/) interface.

Let’s say we have the next file and folder structure:
- root/`input.md`
- root/images/`image1.png`
- root/images/`image2.jpeg`

The `input.md` is a Markdown file we want to open and edit, that is located in the “root” folder, and it uses (references) two raster images `image1.png` and `image2.jpeg`, located in the “images” subfolder.


```java
public void EditingMarkdown()
{
	String inputMdPath = Path.Combine("root", "input.md");
	String imagesFolder = Path.Combine("root", "images");

	// Creating the edit options
	MarkdownEditOptions editOptions = new MarkdownEditOptions();
	editOptions.setImageLoadCallback(new MdImageLoader(imagesFolder));

	Editor editor = new Editor(inputMdPath);

	EditableDocument beforeEdit = editor.edit(editOptions);

	// Make sure there are 2 images here
	Assert.assertEquals(2, beforeEdit.getImages().size());
	Assert.assertEquals("png", beforeEdit.getImages().get(0).getType().getFileExtension());
	Assert.assertEquals("jpeg", beforeEdit.getImages().get(1).getType().getFileExtension());

	String originalHtmlContent = beforeEdit.getEmbeddedHtml();

	// Send the 'originalHtmlContent' to the client-side WYSIWYG-editor,
	// obtain the edited version and create a new EditableDocument from it

	EditableDocument afterEdit = EditableDocument.fromMarkup(originalHtmlContent, null);

	// Make sure 2 images are still here
	Assert.assertEquals(2, afterEdit.getImages().size());
	Assert.assertEquals("png", afterEdit.getImages().get(0).getType().getFileExtension());
	Assert.assertEquals("jpeg", afterEdit.getImages().get(1).getType().getFileExtension());

	// Save to the DOCX, for example
	WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
	String outputDocxPath = Path.Combine("root", "Output."+ saveOptions.getOutputFormat().getExtension());

	editor.save(afterEdit, outputDocxPath, saveOptions);

}

static class MdImageLoader implements IMarkdownImageLoadCallback
{
	private final String _imagesFolder;

	public MdImageLoader(String imagesFolder)
	{
		this._imagesFolder = imagesFolder;
	}

	public final byte processImage(MarkdownImageLoadArgs args)
	{
		String filePath = new java.io.File(this._imagesFolder, Paths.get(args.getImageFileName()).getFileName().toString()).getPath();

		byte[] data = Files.readAllBytes(filePath);
		args.setData(data);

		return MarkdownImageLoadingAction.UserProvided;
	}
}
```

In this example there is a user-created `MdImageLoader` class. It is initialized with the images folder path, and in the `processImage` method file content is read and pushed to the [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadargs/) class through the [`setData(byte[] data)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownimageloadargs/#setData-byte---) method.

## Saving

GroupDocs.Editor also supports saving into the Markdown format. Like for any other format, for saving into markdown the user must create an instance of [`MarkdownSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/) class and specify it in the [`com.groupDocs.editor.Editor.save()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor/editor/#save-com.groupdocs.editor.EditableDocument-java.io.OutputStream-com.groupdocs.editor.options.ISaveOptions-) method.

If the document, destined for the saving in markdown format, has images, they should be “resolved” in a way similar to described above. But there is no callback for saving the images here. Instead of it, user has 3 choices:
1. Ignore images - they will be absent.
2. Save images inside the Markdown code, when they will be stored in base64 encoding.
3. Save images as files separately in the specified folder, and in the markdown code there will be references to these image files.

For doing this the [`MarkdownSaveOptions`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/) class has several properties. [`getExportImagesAsBase64()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/#getExportImagesAsBase64--) is a boolean flag, by default set to `false`. If setted to `true`, the content of the images will be injected inside output Markdown as base64. Also, if this flag is set to `true`, it has the highest priority, and the [`getImagesFolder()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/#getImagesFolder--) property is ignored.

[`getImagesFolder()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/#getImagesFolder--) property, in turn, works when [`setExportImagesAsBase64(boolean)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/#setExportImagesAsBase64-boolean-) is set to `false`. This property, if specified, should contain a valid full path to the existing folder, where GroupDocs.Editor should save images.

The example below shows opening an input DOCX file for editing and saving it into 3 different Markdown output files, each of one has its own saving properties.

```java
String filename = "SampleDoc.docx";
String inputPath = Path.Combine("some-path", filename);

String outputFolder = "Some-full-path-to-output-folder";

String outputMdEmbeddedFilePath = Path.Combine(outputFolder, "Output_Markdown_Embedded.md");
String outputMdExternalFilePath = Path.Combine(outputFolder, "Output_Markdown_External.md");
String outputMdAbsentFilePath = Path.Combine(outputFolder, "Output_Markdown_Absent.md");

Editor editor = new Editor(inputPath);
EditableDocument beforeEdit = editor.edit();
// Send content to client-side WYSIWYG-editor, edit it there, send back to the server-side
EditableDocument afterEdit = EditableDocument.fromMarkup(beforeEdit.getEmbeddedHtml(), null);

{// Saving to "embedded" version, where all images are injected inside MD with base64 encoding
	MarkdownSaveOptions mdSaveOptionsEmbedded = new MarkdownSaveOptions();
	mdSaveOptionsEmbedded.setExportImagesAsBase64(true);
	editor.save(afterEdit, outputMdEmbeddedFilePath, mdSaveOptionsEmbedded);
}

{// Saving to "external" version, where all images are stored in distinct files, while MD contains links to these files as paths in file system
	MarkdownSaveOptions mdSaveOptionsExternal = new MarkdownSaveOptions();
	mdSaveOptionsExternal.setImagesFolder(outputFolder);
	editor.save(afterEdit, outputMdExternalFilePath, mdSaveOptionsExternal);
}

{// Saving to "absent" version, where all images are skipped and are not present in MD
	MarkdownSaveOptions mdSaveOptionsAbsent = new MarkdownSaveOptions();
	ByteArrayOutputStream outputMdAbsentTemp = new ByteArrayOutputStream();
	editor.save(afterEdit, outputMdAbsentTemp, mdSaveOptionsAbsent);
	OutputStream outputMdAbsentStream = new FileOutputStream(outputMdAbsentFilePath);
	outputMdAbsentTemp.writeTo(outputMdAbsentStream);
	outputMdAbsentStream.close();
	outputMdAbsentTemp.close();
}
	
// Disposing all resources
beforeEdit.dispose();
afterEdit.dispose();
editor.dispose();
```

In this example you can see a little trick — for the “absent” version the document content is saved to the [`ByteArrayOutputStream`](https://docs.oracle.com/javase/7/docs/api/java/io/ByteArrayOutputStream.html), and then copied to the [`FileOutputStream`](https://docs.oracle.com/javase/7/docs/api/java/io/FileOutputStream.html). This is done, because GroupDocs.Editor has a trick: if both [`getExportImagesAsBase64()`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/#getExportImagesAsBase64--) is set to `false` and [`setImagesFolder(String)`](https://reference.groupdocs.com/editor/java/com.groupdocs.editor.options/markdownsaveoptions/#setImagesFolder-java.lang.String-) is not set, then GroupDocs.Editor tries to analyze the specified stream. If this stream is a [`FileOutputStream`](https://docs.oracle.com/javase/7/docs/api/java/io/FileOutputStream.html), the GroupDocs.Editor obtains a path to the folder and saves images in it. So, in order to “deceive” the GroupDocs.Editor in this example, the [`ByteArrayOutputStream`](https://docs.oracle.com/javase/7/docs/api/java/io/ByteArrayOutputStream.html) was used.

## Roundtrip

Because Markdown format is supported on import and export, it is possible to perform a roundtrip scenario with it — open a markdown file for editing, edit it and then save the edited version to the Markdown format too. The example below demonstrates such a scenario.

```java
public void MarkdownRoundtrip()
{
	String inputFolderPath = "Some-full-path-to-input-folder";
	String outputFolder = "Some-full-path-to-output-folder";
	String outputMdPath = Path.Combine(outputFolder, "Output.md");

	String filename = "ComplexImage.md";
	String inputPath = Path.Combine(inputFolderPath, filename);	

	MarkdownEditOptions editOptions = new MarkdownEditOptions();
	editOptions.setImageLoadCallback(new MdImageLoader(inputFolderPath);

	MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
	saveOptions.setTableContentAlignment(MarkdownTableContentAlignment.Center);
	saveOptions.setImagesFolder(outputFolder);

	Editor editor = new Editor(inputPath);
	{
		EditableDocument doc = editor.edit(editOptions);
		{
			Assert.assertEquals(3, doc.getImages().size());
			// edit "doc" in WYSIWYG-editor and obtain its edited version

			editor.save(doc, outputMdPath, saveOptions);
		}
	}
}

static class MdImageLoader implements IMarkdownImageLoadCallback
{
	private final String _imagesFolder;

	public MdImageLoader(String imagesFolder)
	{
		this._imagesFolder = imagesFolder;
	}

	public final byte processImage(MarkdownImageLoadArgs args)
	{
		String filePath = new java.io.File(this._imagesFolder, Paths.get(args.getImageFileName()).getFileName().toString()).getPath();
		byte[] data = Files.readAllBytes(filePath);
		args.setData(data);

		return MarkdownImageLoadingAction.UserProvided;
	}
}
```
---

## Edit Markdown documents

Path: /editor/net/edit-markdown/

> This example demonstrates the standard open-edit-save pipeline with Markdown (MD) documents, using different options on every step.

## Introduction

[Markdown](https://docs.fileformat.com/word-processing/md/) is a lightweight markup language, which became popular last time. Markdown files with an `*.md` extension are actually plain text files, contain special syntax, support text formatting, tables, lists, images and so on. There are actually several dialects of markdown, including GFM, CommonMark, Multi-Markdown and so on.

Starting from the [version 22.11](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-11-release-notes/), GroupDocs.Editor for .NET fully supports the Markdown format on both import, export, and also its auto-detection.

As for the [version 22.11](https://docs.groupdocs.com/editor/net/groupdocs-editor-for-net-22-11-release-notes/), GroupDocs.Editor for .NET supports the following Markdown features, which mostly follow the CommonMark specification and are represented as appropriate styles or direct formatting:

- Headings
- Blockquotes
- Code blocks
- Horizontal rules
- Bold emphasis
- Italic emphasis
- StrikeThrough formatting
- Numbered and bulleted lists
- Tables
- Internal images, stored with base64 encoding
- External images

## Loading

Loading of the Markdown documents to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class is usual and the same as for other formats. There are no dedicated load options for the Markdown format, it is enough to specify the file itself through file path or [byte stream](https://docs.microsoft.com/en-us/dotnet/api/system.IO.Stream?view=net-6.0).

Code example below shows loading the same Markdown file to the two [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) instances through file path and a byte stream, and then checking how the GroupDocs.Editor will detect the format of specified file.

```csharp
const string filename = "sample.md";
string inputPath = System.IO.Path.Combine("markdown folder", filename);

using (FileStream content = File.OpenRead(inputPath))
{
	using (Editor fromStream = new Editor(content)
	using (Editor fromPath = new Editor(inputPath))
	{
		GroupDocs.Editor.Metadata.IDocumentInfo info = fromStream.GetDocumentInfo(null);
		Assert.AreEqual(Formats.TextualFormats.Md, info.Format);
	}
}
```

## Editing

There is a special class [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdowneditoptions/) for editing the Markdown files. As always, it is not mandatory when editing a document, so the [`Editor.Edit()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/edit) overload without parameter may be used — GroupDocs.Editor will automatically detect the format and apply the default options.

However, specifying the custom [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdowneditoptions/) may be vital when an input Markdown file has external images; “external” means that images are stored somewhere else, and in the Markdown code there are _links_ to these images. When [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdowneditoptions/) are not specified and correctly tuned (explained below), the GroupDocs.Editor will not be able to locate such images. In order to point all external images, the instance of [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdowneditoptions/) should be created, and an [`ImageLoadCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdowneditoptions/imageloadcallback/) property should be correctly specified.

For doing this the user must create its own type, that implements a [`IMarkdownImageLoadCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/imarkdownimageloadcallback/) interface. This interface defines a single method [`ProcessImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/imarkdownimageloadcallback/processimage/), which obtains a [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadargs/) type and must return a value of [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadingaction/) enumeration.

Working mechanism is the next. GroupDocs.Editor parses an input Markdown file line by line, character by character. When it encounters the link to the external image, it creates an instance of [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadargs/) with all data about this image — its filename (or relative path, or URL) and a boolean flag, that indicates whether it is a local link (in the filesystem) or a web link. Then, when [`MarkdownEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdowneditoptions/) have the [`ImageLoadCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdowneditoptions/imageloadcallback/) property specified with the user implementation of [`IMarkdownImageLoadCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/imarkdownimageloadcallback/), then GroupDocs.Editor invokes the [`ProcessImage`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/imarkdownimageloadcallback/processimage/) method by passing a prepared [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadargs/) into it. Then GroupDocs.Editor “waits” until the user code makes a decision — a return value of the [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadingaction/) enumeration.

If user implementation returns a [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadingaction/)`.Skip` value, then the image will be skipped — the resultant document will have an “empty area”, where the image should be.

If user implementation returns a [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadingaction/)`.Default` value, then the GroupDocs.Editor will try to load an image by itself — this is possible, if, for example, a link to image is an absolute path or URL.

If user implementation returns a [`MarkdownImageLoadingAction`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadingaction/)`.UserProvided`, then this means that user code must provide the image data by itself specifying it in the [`SetData(byte[] data)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadargs/setdata/). In that case GroupDocs.Editor will process the specified binary data for this image.

Code example below shows exactly the last scenario, where the end-user creates his own implementation of the [`IMarkdownImageLoadCallback`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/imarkdownimageloadcallback/) interface.

Let’s say we have the next file and folder structure:
- root/`input.md`
- root/images/`image1.png`
- root/images/`image2.jpeg`

The `input.md` is a Markdown file we want to open and edit, that is located in the “root” folder, and it uses (references) two raster images `image1.png` and `image2.jpeg`, located in the “images” subfolder.


```csharp
public void EditingMarkdown()
{
	string inputMdPath = Path.Combine("root", "input.md");
	string imagesFolder = Path.Combine("root", "images");

	// Creating the edit options
	Options.MarkdownEditOptions editOptions = new MarkdownEditOptions();
	editOptions.ImageLoadCallback = new MdImageLoader(imagesFolder);

	using (Editor editor = new Editor(inputMdPath))
	{
		EditableDocument beforeEdit = editor.Edit(editOptions);

		// Make sure there are 2 images here
		Assert.AreEqual(2, beforeEdit.Images.Count);
		Assert.AreEqual("png", beforeEdit.Images[0].Type.FileExtension);
		Assert.AreEqual("jpeg", beforeEdit.Images[1].Type.FileExtension);

		string originalHtmlContent = beforeEdit.GetEmbeddedHtml();

		// Send the 'originalHtmlContent' to the client-side WYSIWYG-editor,
		// obtain the edited version and create a new EditableDocument from it

		EditableDocument afterEdit = EditableDocument.FromMarkup(originalHtmlContent, null);

		// Make sure 2 images are still here
		Assert.AreEqual(2, afterEdit.Images.Count);
		Assert.AreEqual("png", afterEdit.Images[0].Type.FileExtension);
		Assert.AreEqual("jpeg", afterEdit.Images[1].Type.FileExtension);

		// Save to the DOCX, for example
		Options.WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(Formats.WordProcessingFormats.Docx);
		 string outputDocxPath = Path.Combine("root", "Output."+ saveOptions.OutputFormat.Extension);

		editor.Save(afterEdit, outputDocxPath, saveOptions);		

	}
}

internal sealed class MdImageLoader : Options.IMarkdownImageLoadCallback
{
	private readonly string _imagesFolder;

	public MdImageLoader(string imagesFolder)
	{
		this._imagesFolder = imagesFolder;
	}

	public MarkdownImageLoadingAction ProcessImage(MarkdownImageLoadArgs args)
	{
		string filePath = Path.Combine(this._imagesFolder, Path.GetFileName(args.ImageFileName));
		using (FileStream content = File.OpenRead(filePath))
		{
			byte[] data = new byte[content.Length];
			content.Read(data, 0, (int)content.Length);
			args.SetData(data);
		}
		return MarkdownImageLoadingAction.UserProvided;
	}
}
```

In this example there is a user-created `MdImageLoader` class. It is initialized with the images folder path, and in the `ProcessImage` method file content is read and pushed to the [`MarkdownImageLoadArgs`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadargs/) class through the [`SetData(byte[] data)`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownimageloadargs/setdata/) method.

## Saving

GroupDocs.Editor also supports saving into the Markdown format. Like for any other format, for saving into markdown the user must create an instance of [`MarkdownSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/) class and specify it in the [`GroupDocs.Editor.Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.

If the document, destined for the saving in markdown format, has images, they should be “resolved” in a way similar to described above. But there is no callback for saving the images here. Instead of it, user has 3 choices:
1. Ignore images - they will be absent.
2. Save images inside the Markdown code, when they will be stored in base64 encoding.
3. Save images as files separately in the specified folder, and in the markdown code there will be references to these image files.

For doing this the [`MarkdownSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/) class has several properties. [`ExportImagesAsBase64`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/exportimagesasbase64/) is a boolean flag, by default set to `false`. If setted to `true`, the content of the images will be injected inside output Markdown as base64. Also, if this flag is set to `true`, it has the highest priority, and the [`ImagesFolder`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/imagesfolder/) property is ignored.

[`ImagesFolder`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/imagesfolder/) property, in turn, works when [`ExportImagesAsBase64`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/exportimagesasbase64/) is set to `false`. This property, if specified, should contain a valid full path to the existing folder, where GroupDocs.Editor should save images.

The example below shows opening an input DOCX file for editing and saving it into 3 different Markdown output files, each of one has its own saving properties.

```csharp
const string filename = "SampleDoc.docx";
string inputPath = Path.Combine("some-path", filename);

string outputFolder = "Some-full-path-to-output-folder";

string outputMdEmbeddedFilePath = Path.Combine(outputFolder, "Output_Markdown_Embedded.md");
string outputMdExternalFilePath = Path.Combine(outputFolder, "Output_Markdown_External.md");
string outputMdAbsentFilePath = Path.Combine(outputFolder, "Output_Markdown_Absent.md");

GroupDocs.Editor.Editor editor = new Editor(inputPath);                
EditableDocument beforeEdit = editor.Edit();
// Send content to client-side WYSIWYG-editor, edit it there, send back to the server-side
EditableDocument afterEdit = EditableDocument.FromMarkup(beforeEdit.GetEmbeddedHtml(), null);

{// Saving to "embedded" version, where all images are injected inside MD with base64 encoding
	Options.MarkdownSaveOptions mdSaveOptionsEmbedded = new MarkdownSaveOptions();
	mdSaveOptionsEmbedded.ExportImagesAsBase64 = true;
	editor.Save(afterEdit, outputMdEmbeddedFilePath, mdSaveOptionsEmbedded);
}

{// Saving to "external" version, where all images are stored in distinct files, while MD contains links to these files as paths in file system
	Options.MarkdownSaveOptions mdSaveOptionsExternal = new MarkdownSaveOptions();
	mdSaveOptionsExternal.ImagesFolder = outputFolder;
	editor.Save(afterEdit, outputMdExternalFilePath, mdSaveOptionsExternal);
}

{// Saving to "absent" version, where all images are skipped and are not present in MD
	Options.MarkdownSaveOptions mdSaveOptionsAbsent = new MarkdownSaveOptions();
	MemoryStream outputMdAbsentTemp = new MemoryStream();
	editor.Save(afterEdit, outputMdAbsentTemp, mdSaveOptionsAbsent);
	outputMdAbsentTemp.Position = 0;
	FileStream outputMdAbsentStream = File.Create(outputMdAbsentFilePath);
	outputMdAbsentTemp.CopyTo(outputMdAbsentStream);
	outputMdAbsentStream.Close();
	outputMdAbsentTemp.Close();
}
	
// Disposing all resources
beforeEdit.Dispose();
afterEdit.Dispose();
editor.Dispose();
```

In this example you can see a little trick — for the “absent” version the document content is saved to the [`MemoryStream`](https://docs.microsoft.com/en-us/dotnet/api/system.IO.MemoryStream?view=net-6.0), and then copied to the [`FileStream`](https://docs.microsoft.com/en-us/dotnet/api/system.IO.FileStream?view=net-6.0). This is done, because GroupDocs.Editor has a trick: if both [`ExportImagesAsBase64`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/exportimagesasbase64/) is set to `false` and [`ImagesFolder`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/markdownsaveoptions/imagesfolder/) is not set, then GroupDocs.Editor tries to analyze the specified stream. If this stream is a [`FileStream`](https://docs.microsoft.com/en-us/dotnet/api/system.IO.FileStream?view=net-6.0), the GroupDocs.Editor obtains a path to the folder and saves images in it. So, in order to “deceive” the GroupDocs.Editor in this example, the [`MemoryStream`](https://docs.microsoft.com/en-us/dotnet/api/system.IO.MemoryStream?view=net-6.0) was used.

## Roundtrip

Because Markdown format is supported on import and export, it is possible to perform a roundtrip scenario with it — open a markdown file for editing, edit it and then save the edited version to the Markdown format too. The example below demonstrates such a scenario.

```csharp
public void MarkdownRoundtrip()
{
	string inputFolderPath = "Some-full-path-to-input-folder";
	string outputFolder = "Some-full-path-to-output-folder";
	string outputMdPath = Path.Combine(outputFolder, "Output.md");

	const string filename = "ComplexImage.md";
	string inputPath = Path.Combine(inputFolderPath, filename);	

	Options.MarkdownEditOptions editOptions = new MarkdownEditOptions();
	editOptions.ImageLoadCallback = new MdImageLoader(inputFolderPath);

	Options.MarkdownSaveOptions saveOptions = new Options.MarkdownSaveOptions();
	saveOptions.TableContentAlignment = MarkdownTableContentAlignment.Center;
	saveOptions.ImagesFolder = outputFolder;

	using (Editor editor = new Editor(inputPath))
	{
		using (EditableDocument doc = editor.Edit(editOptions))
		{
			Assert.AreEqual(3, doc.Images.Count);
			// edit "doc" in WYSIWYG-editor and obtain its edited version

			editor.Save(doc, outputMdPath, saveOptions);
		}
	}
}

internal sealed class MdImageLoader : Options.IMarkdownImageLoadCallback
{
	private readonly string _imagesFolder;

	public MdImageLoader(string imagesFolder)
	{
		this._imagesFolder = imagesFolder;
	}

	public MarkdownImageLoadingAction ProcessImage(MarkdownImageLoadArgs args)
	{
		string filePath = Path.Combine(this._imagesFolder, Path.GetFileName(args.ImageFileName));
		using (FileStream content = File.OpenRead(filePath))
		{
			byte[] data = new byte[content.Length];
			content.Read(data, 0, (int)content.Length);
			args.SetData(data);
		}
		return MarkdownImageLoadingAction.UserProvided;
	}
}
```
---

## Edit Markdown Documents

Path: /editor/nodejs-java/edit-markdown/


> This example demonstrates the standard open-edit-save pipeline with Markdown (MD) documents, using different options at every step.

## Introduction

[Markdown](https://docs.fileformat.com/word-processing/md/) is a lightweight markup language that has become popular recently. Markdown files with a `*.md` extension are plain text files containing special syntax, supporting text formatting, tables, lists, images, and more. There are several dialects of Markdown, including GFM, CommonMark, Multi-Markdown, and others.

GroupDocs.Editor for Node.js via Java fully supports the Markdown format on both import and export, including its auto-detection.

GroupDocs.Editor for Node.js via Java supports the following Markdown features, which mostly follow the CommonMark specification and are represented as appropriate styles or direct formatting:

- Headings
- Blockquotes
- Code blocks
- Horizontal rules
- Bold emphasis
- Italic emphasis
- Strikethrough formatting
- Numbered and bulleted lists
- Tables
- Internal images, stored with base64 encoding
- External images

## Loading

Loading Markdown documents into the `Editor` class is straightforward and similar to other formats. There are no dedicated load options for the Markdown format; it is enough to specify the file itself through a file path or an input stream.

The code example below shows loading the same Markdown file into two `Editor` instances through a file path and a byte stream, and then checking how GroupDocs.Editor will detect the format of the specified file.

```javascript
// Import necessary modules
const fs = require('fs');
const path = require('path');
const groupdocsEditor = require('groupdocs-editor');

// Specify the file name and path
const filename = 'sample.md';
const inputPath = path.join('path', 'to', 'markdown', filename);

// Load from file path
const editorFromPath = new groupdocsEditor.Editor(inputPath);

// Load from stream
const fileStream = fs.createReadStream(inputPath);
const editorFromStream = new groupdocsEditor.Editor(fileStream);

// Get document info
const info = editorFromPath.getDocumentInfo();

if (info.getFormat() === groupdocsEditor.TextualFormats.Md) {
    console.log('The document format is Markdown.');
} else {
    console.log('The document format is not Markdown.');
}

// Dispose of editors when done
editorFromPath.dispose();
editorFromStream.dispose();
```

## Editing

There is a special class `MarkdownEditOptions` for editing Markdown files. It is not mandatory when editing a document; you can use the `editor.edit()` overload without parameters—GroupDocs.Editor will automatically detect the format and apply the default options.

However, specifying custom `MarkdownEditOptions` may be essential when the input Markdown file has external images; "external" means that images are stored elsewhere, and in the Markdown code there are _links_ to these images. When `MarkdownEditOptions` are not specified and correctly configured (explained below), GroupDocs.Editor will not be able to locate such images. To reference all external images, an instance of `MarkdownEditOptions` should be created, and the `setImageLoadCallback()` property should be correctly specified.

To do this, you must create your own class that implements the `IMarkdownImageLoadCallback` interface. This interface defines a single method `processImage()`, which receives a `MarkdownImageLoadArgs` object and must return a value of the `MarkdownImageLoadingAction` enumeration.

The working mechanism is as follows. GroupDocs.Editor parses an input Markdown file line by line, character by character. When it encounters a link to an external image, it creates an instance of `MarkdownImageLoadArgs` with all data about this image—its filename (or relative path, or URL) and a boolean flag indicating whether it is a local link (in the filesystem) or a web link. Then, when `MarkdownEditOptions` have the `setImageLoadCallback()` property specified with your implementation of `IMarkdownImageLoadCallback`, GroupDocs.Editor invokes the `processImage()` method by passing the prepared `MarkdownImageLoadArgs` into it. GroupDocs.Editor then "waits" until your code makes a decision—a return value of the `MarkdownImageLoadingAction` enumeration.

If your implementation returns `MarkdownImageLoadingAction.Skip`, then the image will be skipped—the resultant document will have an "empty area" where the image should be.

If your implementation returns `MarkdownImageLoadingAction.Default`, then GroupDocs.Editor will try to load the image by itself—this is possible if, for example, the link to the image is an absolute path or URL.

If your implementation returns `MarkdownImageLoadingAction.UserProvided`, then this means that your code must provide the image data by itself, specifying it in the `setData()` method of `MarkdownImageLoadArgs`. In that case, GroupDocs.Editor will process the specified binary data for this image.

The code example below shows exactly the last scenario, where you create your own implementation of the `IMarkdownImageLoadCallback` interface.

Let's say we have the following file and folder structure:

- root/`input.md`
- root/images/`image1.png`
- root/images/`image2.jpeg`

The `input.md` is a Markdown file we want to open and edit, located in the "root" folder, and it uses (references) two raster images `image1.png` and `image2.jpeg`, located in the "images" subfolder.

```javascript
// Import necessary modules
const fs = require('fs');
const path = require('path');
const groupdocsEditor = require('groupdocs-editor');

// Define the custom image loader class
class MdImageLoader {
    constructor(imagesFolder) {
        this.imagesFolder = imagesFolder;
    }

    // Implement the processImage method
    processImage(args) {
        const imagePath = path.join(this.imagesFolder, path.basename(args.getImageFileName()));
        const imageData = fs.readFileSync(imagePath);
        args.setData(imageData);
        return groupdocsEditor.MarkdownImageLoadingAction.UserProvided;
    }
}

function editingMarkdown() {
    const inputMdPath = path.join('root', 'input.md');
    const imagesFolder = path.join('root', 'images');

    // Create the edit options
    const editOptions = new groupdocsEditor.MarkdownEditOptions();
    editOptions.setImageLoadCallback(new MdImageLoader(imagesFolder));

    const editor = new groupdocsEditor.Editor(inputMdPath);

    const beforeEdit = editor.edit(editOptions);

    // Ensure there are 2 images
    console.log('Number of images:', beforeEdit.getImages().length);
    console.log('First image type:', beforeEdit.getImages()[0].getType().getFileExtension());
    console.log('Second image type:', beforeEdit.getImages()[1].getType().getFileExtension());

    const originalHtmlContent = beforeEdit.getEmbeddedHtml();

    // Send the 'originalHtmlContent' to the client-side WYSIWYG editor,
    // obtain the edited version, and create a new EditableDocument from it
    const editedHtmlContent = originalHtmlContent; // For demonstration purposes

    const afterEdit = groupdocsEditor.EditableDocument.fromMarkup(editedHtmlContent, null);

    // Ensure 2 images are still present
    console.log('Number of images after edit:', afterEdit.getImages().length);
    console.log('First image type after edit:', afterEdit.getImages()[0].getType().getFileExtension());
    console.log('Second image type after edit:', afterEdit.getImages()[1].getType().getFileExtension());

    // Save to DOCX, for example
    const saveOptions = new groupdocsEditor.WordProcessingSaveOptions(groupdocsEditor.WordProcessingFormats.Docx);
    const outputDocxPath = path.join('root', `Output.${saveOptions.getOutputFormat().getExtension()}`);

    editor.save(afterEdit, outputDocxPath, saveOptions);

    // Dispose of resources
    beforeEdit.dispose();
    afterEdit.dispose();
    editor.dispose();
}

// Call the function
editingMarkdown();
```

In this example, there is a user-created `MdImageLoader` class. It is initialized with the images folder path, and in the `processImage` method, the file content is read and provided to the `MarkdownImageLoadArgs` object through the `setData()` method.

## Saving

GroupDocs.Editor also supports saving into the Markdown format. Like for any other format, to save into Markdown you must create an instance of the `MarkdownSaveOptions` class and specify it in the `editor.save()` method.

If the document intended for saving in Markdown format has images, they should be handled in a way similar to that described above. But there is no callback for saving the images here. Instead, you have three choices:

1. **Ignore images**: They will be absent in the output.
2. **Save images inside the Markdown code**: Images will be stored in base64 encoding within the Markdown document.
3. **Save images as separate files**: Images are saved in the specified folder, and the Markdown code contains references to these image files.

To do this, the `MarkdownSaveOptions` class has several properties:

- `setExportImagesAsBase64(boolean value)`: If set to `true`, the content of the images will be embedded inside the output Markdown as base64. If this flag is set to `true`, it has the highest priority, and the `setImagesFolder()` property is ignored.
- `setImagesFolder(String path)`: Specifies the path to the folder where images should be saved. This property works when `setExportImagesAsBase64(false)` is set.

The example below shows opening an input DOCX file for editing and saving it into three different Markdown output files, each with its own saving properties.

```javascript
// Import necessary modules
const fs = require('fs');
const path = require('path');
const groupdocsEditor = require('groupdocs-editor');

const filename = 'SampleDoc.docx';
const inputPath = path.join('some-path', filename);

const outputFolder = 'path/to/output/folder';

const outputMdEmbeddedFilePath = path.join(outputFolder, 'Output_Markdown_Embedded.md');
const outputMdExternalFilePath = path.join(outputFolder, 'Output_Markdown_External.md');
const outputMdAbsentFilePath = path.join(outputFolder, 'Output_Markdown_Absent.md');

const editor = new groupdocsEditor.Editor(inputPath);
const beforeEdit = editor.edit();
// Send content to client-side WYSIWYG editor, edit it there, send back to server-side
const afterEdit = groupdocsEditor.EditableDocument.fromMarkup(beforeEdit.getEmbeddedHtml(), null);

// Saving to "embedded" version, where all images are embedded in MD with base64 encoding
{
    const mdSaveOptionsEmbedded = new groupdocsEditor.MarkdownSaveOptions();
    mdSaveOptionsEmbedded.setExportImagesAsBase64(true);
    editor.save(afterEdit, outputMdEmbeddedFilePath, mdSaveOptionsEmbedded);
}

// Saving to "external" version, where images are stored as separate files, and MD contains links to these files
{
    const mdSaveOptionsExternal = new groupdocsEditor.MarkdownSaveOptions();
    mdSaveOptionsExternal.setImagesFolder(outputFolder);
    editor.save(afterEdit, outputMdExternalFilePath, mdSaveOptionsExternal);
}

// Saving to "absent" version, where images are skipped and not present in MD
{
    const mdSaveOptionsAbsent = new groupdocsEditor.MarkdownSaveOptions();
    // Using an in-memory buffer to avoid saving images
    const outputMdAbsentTemp = [];
    editor.save(afterEdit, (data) => outputMdAbsentTemp.push(data), mdSaveOptionsAbsent);
    const outputMdAbsentContent = Buffer.concat(outputMdAbsentTemp);
    fs.writeFileSync(outputMdAbsentFilePath, outputMdAbsentContent);
}

// Dispose of resources
beforeEdit.dispose();
afterEdit.dispose();
editor.dispose();
```

In this example, for the "absent" version, the document content is saved to an in-memory buffer and then written to a file. This approach avoids GroupDocs.Editor's default behavior of saving images when a file stream is provided.

## Roundtrip

Because the Markdown format is supported on import and export, it is possible to perform a roundtrip scenario with it—open a Markdown file for editing, edit it, and then save the edited version to the Markdown format again. The example below demonstrates such a scenario.

```javascript
// Import necessary modules
const fs = require('fs');
const path = require('path');
const groupdocsEditor = require('groupdocs-editor');

// Define the custom image loader class
class MdImageLoader {
    constructor(imagesFolder) {
        this.imagesFolder = imagesFolder;
    }

    // Implement the processImage method
    processImage(args) {
        const imagePath = path.join(this.imagesFolder, path.basename(args.getImageFileName()));
        const imageData = fs.readFileSync(imagePath);
        args.setData(imageData);
        return groupdocsEditor.MarkdownImageLoadingAction.UserProvided;
    }
}

function markdownRoundtrip() {
    const inputFolderPath = 'path/to/input/folder';
    const outputFolder = 'path/to/output/folder';
    const outputMdPath = path.join(outputFolder, 'Output.md');

    const filename = 'ComplexImage.md';
    const inputPath = path.join(inputFolderPath, filename);

    const editOptions = new groupdocsEditor.MarkdownEditOptions();
    editOptions.setImageLoadCallback(new MdImageLoader(inputFolderPath));

    const saveOptions = new groupdocsEditor.MarkdownSaveOptions();
    saveOptions.setTableContentAlignment(groupdocsEditor.MarkdownTableContentAlignment.Center);
    saveOptions.setImagesFolder(outputFolder);

    const editor = new groupdocsEditor.Editor(inputPath);

    const doc = editor.edit(editOptions);

    console.log('Number of images:', doc.getImages().length);

    // Edit 'doc' in WYSIWYG editor and obtain its edited version
    // For demonstration, we use the same document
    const editedDoc = doc;

    editor.save(editedDoc, outputMdPath, saveOptions);

    // Dispose of resources
    doc.dispose();
    editor.dispose();
}

// Call the function
markdownRoundtrip();
```

In this example, we perform a roundtrip: we load a Markdown document with images, edit it, and save it back to Markdown format, ensuring that images are correctly handled.

---

By following this guide, you can effectively edit Markdown documents using GroupDocs.Editor for Node.js via Java, customizing the editing process according to your specific needs.

**Note:** Be sure to replace the paths in the code examples with the actual paths on your system.

For more examples and detailed information, you can refer to the [GroupDocs.Editor for Node.js via Java Examples](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Node.js-via-Java/tree/master/Examples) repository on GitHub.

---

## How to migrate to GroupDocs.Viewer 19.8 or higher

Path: /viewer/java/how-to-migrate-to-groupdocs-viewer-19-8-or-higher/

This article contains information about migration from the legacy API to [GroupDocs.Viewer](https://products.groupdocs.com/viewer) 20.1 or higher.

## Why To Migrate

Here are the key reasons to use the new updated API provided by GroupDocs.Viewer for Java since version 20.1:

* **Viewer** class introduced as a **single entry point** to manage the document rendering process to any supported file format (instead of **ViewerHtmlHander** / **ViewerImageHander** classes from previous versions).
* The overall **rendering speed improved** dramatically by saving rendered page as soon as it was rendered, not when all pages list were rendered.
* Product architecture was redesigned from scratch in order to **decreased memory usage** (from 10% to 400% approx. depending on document type).
* Document **viewing options simplified** so it’s easy to instantiate proper options class and control over document rendering and saving processes.

## How To Migrate

Here is a brief comparison of how to display document into HTML form using old and new API.  

### Using legacy API

{{< tabs "example1">}}
{{< tab "Java" >}}
```java
    //Get Configurations
    ViewerConfig config = Utilities.getConfigurations();

    // Create html handler
    ViewerHtmlHandler htmlHandler = new ViewerHtmlHandler(config);

    // Guid implies that unique document name 
    String guid = "sample.docx";

    // Document password
    String documentPassword = "password";

    //Instantiate the HtmlOptions object
    HtmlOptions options = new HtmlOptions();

    //to get html representations of pages with embedded resources
    options.setResourcesEmbedded(true);

    // Set password if document is password protected. 
    if (documentPassword != null && !documentPassword.isEmpty()) {
        options.setPassword(documentPassword);
    }

    //Get document pages in html form
    List<PageHtml> pages = htmlHandler.getPages(guid, options);

    for (PageHtml page : pages) {
        //Save each page at disk
        Utilities.saveAsHtml(page.getPageNumber() + "_" + documentName, page.getHtmlContent());
    }
```
{{< /tab >}}
{{< /tabs >}}

### Using new API

{{< tabs "example2">}}
{{< tab "Java" >}}
```java
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.LoadOptions;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.Page;
import com.groupdocs.viewer.results.ViewInfo;
// ...

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("password");

try (Viewer viewer = new Viewer("sample.docx", loadOptions)) {
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources("page_{0}.html");
    viewer.view(options);

    final ViewInfo viewInfo = viewer.getViewInfo(ViewInfoOptions.forHtmlView());
    final List<Page> pages = viewInfo.getPages();

    for (Page page : pages) {
        final int pageNumber = page.getNumber();
        System.out.println("Page number: " + pageNumber + ", file saved as 'page_" + pageNumber + ".html'");
    }
}
```
{{< /tab >}}
{{< /tabs >}}
---

## Extract data from databases

Path: /parser/java/extract-data-from-databases/

GroupDocs.Parser provides the functionality to extract data from databases via JDBC.

## Extract data with Connection object

To create an instance of [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) class to extract data from a database with [*java.sql.Connection*](http://docs.oracle.com/javase/7/docs/api/java/sql/Connection.html?is-external=true) object the following constructor is used:

```csharp
Parser(java.sql.Connection connection);
Parser(java.sql.Connection connection, ParserSettings parserSettings);
```

The second constructor allows to use [ParserSettings](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/ParserSettings) object to control the process; for example, by adding logging functionality.

Here are the steps to extract data from Sqlite database:

*  Prepare [*java.sql.Connection*](http://docs.oracle.com/javase/7/docs/api/java/sql/Connection.html?is-external=true) object;
*  Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object with connection object;
*  Call [isText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isText()) property to check if text extraction is supported;
*  Call [isToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isToc()) property to check if table of contents extraction is supported;
*  Call [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method and obtain collection of tables;
*  Iterate through the collection and get a text from tables.

The following example shows how to extract data from Sqlite database:

```csharp
// Create DbConnection object
java.sql.Connection connection = java.sql.DriverManager.getConnection(String.format("jdbc:sqlite:%s", Constants.SampleDatabase));
// Create an instance of Parser class to extract tables from the database
try (Parser parser = new Parser(connection)) {
    // Check if text extraction is supported
    if (!parser.getFeatures().isText()) {
        System.out.println("Text extraction isn't supported.");
        return;
    }
    // Check if toc extraction is supported
    if (!parser.getFeatures().isToc()) {
        System.out.println("Toc extraction isn't supported.");
        return;
    }
    // Get a list of tables
    Iterable<TocItem> toc = parser.getToc();
    // Iterate over tables
    for(TocItem i : toc)
    {
        // Print the table name
        System.out.println(i.extractText());
        // Extract a table content as a text
        try(TextReader reader = parser.getText(i.getPageIndex().intValue()))
        {
            System.out.println(reader.readToEnd());
        }
    }
}
```

## Extract data with connection string

To create an instance of [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) class to extract data from a database with connection string the following constructor is used:

```java
Parser(String filePath, LoadOptions loadOptions);
```

The list of tables is represented as table of contents. The table extraction is processed by [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getText()) method.

Here are the steps to extract emails from Sqlite database:

*   Prepare connection string;
*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object with connection string;
*   Call [isText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isText()) property to check if text extraction is supported;
*   Call [isToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/Features#isToc()) property to check if table of contents extraction is supported;
*   Call [getToc](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser#getToc()) method and obtain collection of tables;
*   Iterate through the collection and get a text from tables.

The following example shows how to extract data from Sqlite database:

```java
String connectionString = String.format("jdbc:sqlite:%s", Constants.SampleDatabase);
// Create an instance of Parser class to extract tables from the database
// As filePath connection parameters are passed; LoadOptions is set to Database file format
try (Parser parser = new Parser(connectionString, new LoadOptions(FileFormat.Database))) {
    // Check if text extraction is supported
    if (!parser.getFeatures().isText()) {
        System.out.println("Text extraction isn't supported.");
        return;
    }
    // Check if toc extraction is supported
    if (!parser.getFeatures().isToc()) {
        System.out.println("Toc extraction isn't supported.");
        return;
    }
    // Get a list of tables
    Iterable<TocItem> toc = parser.getToc();
    // Iterate over tables
    for (TocItem i : toc) {
        // Print the table name
        System.out.println(i.getText());
        // Extract a table content as a text
        try (TextReader reader = parser.getText(i.getPageIndex())) {
            System.out.println(reader.readToEnd());
        }
    }
}

```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Extract data from databases

Path: /parser/net/extract-data-from-databases/

GroupDocs.Parser provides the functionality to extract data from databases via ADO.NET. This feature allows you to parse database tables and extract their content as text, similar to how you would extract data from document files.

## API Overview

### Constructors

The `Parser` class provides constructors specifically for database extraction:

```csharp
// Constructor with DbConnection (recommended for .NET Core/.NET 5+)
Parser(DbConnection connection);
Parser(DbConnection connection, ParserSettings parserSettings);

// Constructor with connection string (only for .NET Framework)
Parser(string connectionString, LoadOptions loadOptions);
```

### Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `connection` | `DbConnection` | An active ADO.NET database connection object |
| `connectionString` | `string` | Database connection string (only supported in .NET Framework) |
| `loadOptions` | `LoadOptions` | Must be set to `FileFormat.Database` when using connection string |
| `parserSettings` | `ParserSettings` | Optional settings for logging and other parser configurations |

### Return Types

- **GetToc()** returns `IEnumerable<TocItem>` where each `TocItem` represents a database table
- **GetText(int pageIndex)** returns `TextReader` containing the table data for the specified table index
- **Features.Text** and **Features.Toc** properties indicate if text and table extraction are supported

## Supported Database Providers

GroupDocs.Parser works with any ADO.NET-compatible database provider. Common providers include:

- **SQLite** - Requires `System.Data.SQLite` NuGet package
- **SQL Server** - Built-in support via `System.Data.SqlClient`
- **MySQL** - Requires `MySql.Data` NuGet package
- **PostgreSQL** - Requires `Npgsql` NuGet package
- **Oracle** - Requires `Oracle.ManagedDataAccess` NuGet package

## Limitations

- Database extraction is primarily for text-based table content
- Complex relationships between tables are not automatically resolved
- Only table data can be extracted, not views or stored procedures
- The connection string method is only available in .NET Framework

## Extract Data with DbConnection Object (Recommended)

The `DbConnection` approach is the recommended method and works with all .NET platforms (.NET Framework, .NET Core, .NET 5+).

### Constructor Signatures

```csharp
// Basic constructor
Parser(DbConnection connection);

// With parser settings (for logging, etc.)
Parser(DbConnection connection, ParserSettings parserSettings)
```

The second constructor allows you to use [ParserSettings](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/parsersettings) object to control the process; for example, by adding [logging functionality]({{< ref "parser/net/developer-guide/advanced-usage/logging.md" >}}).

### Step-by-Step Guide

Here are the steps to extract data from a database:

* Prepare [DbConnection](https://docs.microsoft.com/en-us/dotnet/api/system.data.common.dbconnection?view=netcore-3.1) object;
* Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object with connection string;
* Call [Features.Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/text) property to check if text extraction is supported;
* Call [Features.Toc](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/toc) property to check if table of contents extraction is supported;
* Call [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method and obtain collection of tables;
* Iterate through the collection and get a text from tables.

### Complete Example: SQLite Database

The following example shows how to extract data from a SQLite database:

```csharp
using System.Data.Common;
using System.Data.SQLite;
using GroupDocs.Parser;
using GroupDocs.Parser.Data;

// Connection string for SQLite database
string dbPath = "sample.db";
string connectionString = $"Data Source={dbPath};Version=3;";

// Create DbConnection object
using (DbConnection connection = new SQLiteConnection(connectionString))
{
    connection.Open();
    
    // Create an instance of Parser class to extract tables from the database
    using (Parser parser = new Parser(connection))
    {
        // Check if text extraction is supported
        if (!parser.Features.Text)
        {
            Console.WriteLine("Text extraction isn't supported for this database.");
            return;
        }
        
        // Check if table of contents (table list) extraction is supported
        if (!parser.Features.Toc)
        {
            Console.WriteLine("Table of contents extraction isn't supported.");
            return;
        }
        
        // Get a list of all tables in the database
        IEnumerable<TocItem> tables = parser.GetToc();
        
        // Iterate over each table
        foreach (TocItem table in tables)
        {
            Console.WriteLine($"\n=== Table: {table.Text} ===");
            
            // Extract table content as text
            // PageIndex represents the table index
            using (TextReader reader = parser.GetText(table.PageIndex.Value))
            {
                if (reader != null)
                {
                    string tableContent = reader.ReadToEnd();
                    Console.WriteLine(tableContent);
                }
                else
                {
                    Console.WriteLine("Unable to extract data from this table.");
                }
            }
        }
    }
}
```

### Example: SQL Server Database

```csharp
using System.Data.Common;
using System.Data.SqlClient;
using GroupDocs.Parser;

string connectionString = "Server=localhost;Database=MyDatabase;Integrated Security=true;";

using (DbConnection connection = new SqlConnection(connectionString))
{
    connection.Open();
    
    using (Parser parser = new Parser(connection))
    {
        if (parser.Features.Text && parser.Features.Toc)
        {
            foreach (TocItem table in parser.GetToc())
            {
                Console.WriteLine($"Extracting from table: {table.Text}");
                using (TextReader reader = parser.GetText(table.PageIndex.Value))
                {
                    if (reader != null)
                    {
                        Console.WriteLine(reader.ReadToEnd());
                    }
                }
            }
        }
    }
}
```

## Extract Data with Connection String

{{< alert style="danger" >}}**Important:** This functionality is supported **only in .NET Framework** version of GroupDocs.Parser for .NET. For .NET Core, .NET 5+, or cross-platform applications, use the `DbConnection` approach described above.{{< /alert >}}

### Constructor

To create an instance of [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) class to extract data from a database using a connection string, use:

```csharp
Parser(string connectionString, LoadOptions loadOptions);
```

### Parameters

- **connectionString**: The database connection string (not a file path)
- **loadOptions**: Must be initialized with `FileFormat.Database`

The list of tables is represented as table of contents (TOC). Each table can be extracted using the [GetText(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/gettext/methods/2) method where the integer parameter is the table index from the TOC.

Here are the steps to extract data from Sqlite database:

*   Prepare connection string;
*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object with connection string;
*   Call [Features.Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/text) property to check if text extraction is supported;
*   Call [Features.Toc](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/features/properties/toc) property to check if table of contents extraction is supported;
*   Call [GetToc](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/gettoc) method and obtain collection of tables;
*   Iterate through the collection and get a text from tables.

### Complete Example (.NET Framework Only)

```csharp
using GroupDocs.Parser;
using GroupDocs.Parser.Options;

string databasePath = "sample.db";
string connectionString = string.Format(
    "Provider=System.Data.Sqlite;Data Source={0};Version=3;", 
    databasePath
);

// Create an instance of Parser class to extract tables from the database
// Pass connection string as first parameter and LoadOptions with FileFormat.Database
using (Parser parser = new Parser(connectionString, new LoadOptions(FileFormat.Database)))
{
    // Check if text extraction is supported
    if (!parser.Features.Text)
    {
        Console.WriteLine("Text extraction isn't supported.");
        return;
    }
    
    // Check if table of contents extraction is supported
    if (!parser.Features.Toc)
    {
        Console.WriteLine("Table of contents extraction isn't supported.");
        return;
    }
    
    // Get a list of all tables in the database
    IEnumerable<TocItem> tables = parser.GetToc();
    
    // Iterate over tables
    foreach (TocItem table in tables)
    {
        // Print the table name
        Console.WriteLine($"\nTable: {table.Text}");
        
        // Extract table content as text using the table's page index
        using (TextReader reader = parser.GetText(table.PageIndex.Value))
        {
            if (reader != null)
            {
                Console.WriteLine(reader.ReadToEnd());
            }
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## GroupDocs.Assembly for .NET 25.12 Release Notes

Path: /assembly/net/groupdocs-assembly-for-net-25-12-release-notes/


## Major Features, Enhancement and Fixes

The **GroupDocs.Assembly for .NET 25.12** release introduces significant enhancements for OOXML compliance handling and fixes critical issues with template expression processing and barcode generation.

**OOXML Compliance Support**: This release adds comprehensive support for OOXML compliance levels in Word documents. You can now explicitly specify the compliance level (Ecma, Transitional, or Strict) when saving documents, and the system automatically preserves the original document's compliance when appropriate.

**Template Expression Processing**: Fixed an issue where template expressions inside inline content controls (SdtRun) were not being processed, ensuring all template expressions are correctly replaced regardless of their location in the document.

**Barcode Generation Reliability**: Improved barcode generation on Linux platforms by properly handling transparent colors and enforcing minimum dimensions for Codabar barcodes, ensuring barcodes render correctly across all platforms.

## Full List of Features Covering all Changes in this Release

| Key             | Category | Summary                                                      |
| :-------------- | :------- | :----------------------------------------------------------- |
| ASSEMBLYNET-70 | ★ Feature | Implement explicit OOXML compliance specification for Words documents |
| ASSEMBLYNET-69 | ✜ Enhancement | Implement automatic preservation of original Words document compliance |
| ASSEMBLYNET-68 | ✜ Enhancement | Implement OOXML compliance support for Words documents |
| ASSEMBLYNET-75 | ✜ Enhancement | Improved Codabar barcode generation reliability by enforcing minimum X Dimension |
| ASSEMBLYNET-76 | ✜ Enhancement | Improved Barcode generation reliability to avoid transparent colors usage |
| ASSEMBLYNET-73 | 🔧 Fix | Missing replacement of template expressions inside SdtRun |
| ASSEMBLYNET-60 | 🔧 Fix | Barcodes render blank when assembling on Linux (.NET 8) |

## Public API and Backward Incompatible Changes

{{< alert style="info" >}}This section outlines public API changes introduced in GroupDocs.Assembly for .NET 25.13. It includes new and deprecated methods, as well as internal behavioral changes that may affect existing implementations. Any regression or modified behavior is highlighted here.{{< /alert >}}

### 1. New Public Enumeration: OoxmlCompliance

A new public enumeration `OoxmlCompliance` has been added to specify the OOXML compliance level when saving Word documents to OOXML formats:

```csharp
namespace GroupDocs.Assembly
{
    /// <summary>
    /// Specifies the OOXML compliance level to use when saving Word documents to OOXML formats.
    /// </summary>
    public enum OoxmlCompliance
    {
        /// <summary>
        /// Specifies ECMA-376 compliance level.
        /// </summary>
        Ecma,
        
        /// <summary>
        /// Specifies ISO/IEC 29500:2008 Transitional compliance level.
        /// </summary>
        Transitional,
        
        /// <summary>
        /// Specifies ISO/IEC 29500:2008 Strict compliance level.
        /// </summary>
        Strict
    }
}
```

**Available Options:**
- `Ecma`: Specifies ECMA-376 compliance level
- `Transitional`: Specifies ISO/IEC 29500:2008 Transitional compliance level (commonly used for compatibility)
- `Strict`: Specifies ISO/IEC 29500:2008 Strict compliance level (fully compliant with the standard)

### 2. New Property in LoadSaveOptions: OoxmlCompliance

A new nullable property `OoxmlCompliance` has been added to the `LoadSaveOptions` class:

```csharp
public class LoadSaveOptions
{
    /// <summary>
    /// Gets or sets the OOXML compliance level to use when saving Word documents to OOXML formats.
    /// The default value is null, which means the compliance level will be determined automatically.
    /// </summary>
    public OoxmlCompliance? OoxmlCompliance { get; set; }
}
```

**Usage:**
- When set to `null` (default): The system automatically preserves the original document's compliance level if it was Transitional, otherwise uses Strict compliance
- When explicitly set: The specified compliance level will be used when saving to OOXML formats
- This property only applies to OOXML formats (DOCX, DOCM, DOTX, DOTM, FlatOpc, etc.) and is ignored for other file formats

### How to Specify Explicit OOXML Compliance Level

The following code snippet demonstrates how to explicitly specify the OOXML compliance level when assembling a Word document:

```csharp
var source = "template.docx";
var target = "output.docx";
var data = "data.json";

// Create LoadSaveOptions with explicit OOXML compliance
var options = new LoadSaveOptions(FileFormat.Docx);
options.OoxmlCompliance = OoxmlCompliance.Strict; // or Ecma, Transitional

var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);
```

### How to Preserve Original Document Compliance Automatically

When `OoxmlCompliance` is not explicitly set (default `null`), the system automatically preserves the original document's compliance level if it was Transitional:

```csharp
var source = "template_transitional.docx"; // Document with Transitional compliance
var target = "output.docx";
var data = "data.json";

// OoxmlCompliance is null by default - original compliance will be preserved
var options = new LoadSaveOptions(FileFormat.Docx);
// options.OoxmlCompliance is null - automatic preservation

var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);
// Output document will maintain Transitional compliance
```

### How to Process Template Expressions in Inline Content Controls

Template expressions inside inline content controls (SdtRun) are now properly processed. The following example demonstrates that expressions work correctly in all content control types:

```csharp
var source = "template_with_sdtrun.docx";
var target = "output.docx";
var data = "data.json";

// Template document contains:
// - SdtBlock: <<[field1]>>
// - SdtRun (Inline): <<[field2]>>  // Now properly processed
// - Regular text: <<[field3]>>

var options = new LoadSaveOptions(FileFormat.Docx);
var dataSourceInfo = new DataSourceInfo(new JsonDataSource(data));
var assembler = new DocumentAssembler();
assembler.AssembleDocument(source, target, options, dataSourceInfo);
// All template expressions are now correctly replaced, including those in SdtRun
```

---

## Image search in network

Path: /search/java/image-search-in-network/

To run a reverse image search, use the [searchFirst](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#searchFirst-com.groupdocs.search.common.SearchImage-com.groupdocs.search.options.ImageSearchOptions-) method of the [Searcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/) class. This method returns the first portion of results.

To continue the search, the [searchNext](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#searchNext-com.groupdocs.search.scaling.results.NetworkImageSearchToken-) method is used, returning the second and subsequent portions of results.

The search image object and search options object are the same as those used for single index searches.

The following code example demonstrates performing a reverse image search on the search network.

```java
System.out.println("First image search");

Searcher searcher = node.getSearcher();
ImageSearchOptions options = new ImageSearchOptions();
options.setHashDifferences(hashDifferences);
int total = 0;

NetworkImageSearchResult result = searcher.searchFirst(searchImage, options);
System.out.println("Images found (shard " + result.getShardIndex() + "): " + result.getImageCount());
total += result.getImageCount();

while (result.getNetworkImageSearchToken() != null) {
    System.out.println();
    System.out.println("Next image search");

    result = searcher.searchNext(result.getNetworkImageSearchToken());
    System.out.println("Images found (shard " + result.getShardIndex() + "): " + result.getImageCount());
    total += result.getImageCount();
}

System.out.println();
System.out.println("Total images found (diffs = " + hashDifferences + "): " + total);
```

More information about reverse image search in the [article](https://docs.groupdocs.com/search/java/reverse-image-search/).

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Image search in network

Path: /search/net/image-search-in-network/

To run a reverse image search, use the [SearchFirst](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/searchfirst/#searchfirst) method of the [Searcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/) class. This method returns the first portion of results.

To continue the search, the [SearchNext](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/searchnext/#searchnext) method is used, returning the second and subsequent portions of results.

The search image object and search options object are the same as those used for single index searches.

The following code example demonstrates performing a reverse image search on the search network.

**C#**

```csharp
Console.WriteLine("First image search");

Searcher searcher = node.Searcher;
ImageSearchOptions options = new ImageSearchOptions();
options.HashDifferences = hashDifferences;
int total = 0;

NetworkImageSearchResult result = searcher.SearchFirst(searchImage, options);
Console.WriteLine("Images found (shard " + result.ShardIndex + "): " + result.ImageCount);
total += result.ImageCount;

while (result.NetworkImageSearchToken != null)
{
    Console.WriteLine();
    Console.WriteLine("Next image search");

    result = searcher.SearchNext(result.NetworkImageSearchToken);
    Console.WriteLine("Images found (shard " + result.ShardIndex + "): " + result.ImageCount);
    total += result.ImageCount;
}

Console.WriteLine();
Console.WriteLine("Total images found (diffs = " + hashDifferences + "): " + total);
```

More information about reverse image search in the [article](https://docs.groupdocs.com/search/net/reverse-image-search/).

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge Open Document files

Path: /merger/net/merge/open-document/


### About ODP File Format

ODT files are type of documents created with word processing applications that are based on OpenDocument Text File format. These are created with word processor applications such as free OpenOffice Writer and can hold content such as text, images, objects and styles. The ODT file is to Writer word processor what the DOCX is to Microsoft Word. Several applications including Google Docs and Google’s web-based word processor included with Google Drive can open the ODT files for editing. Microsoft Word can also open ODT files and save it in to other formats such as DOC and DOCX.

### About ODT File Format

ODT files are type of documents created with word processing applications that are based on OpenDocument Text File format. These are created with word processor applications such as free OpenOffice Writer and can hold content such as text, images, objects and styles. The ODT file is to Writer word processor what the DOCX is to Microsoft Word. Several applications including Google Docs and Google’s web-based word processor included with Google Drive can open the ODT files for editing. Microsoft Word can also open ODT files and save it in to other formats such as DOC and DOCX.

### About ODS File Format

Files with ODS extension stand for OpenDocument Spreadsheet Document format that is editable by the user. Data is stored inside the ODF file into rows and columns. It is an XML-based format and is one of the several subtypes in the Open Document Formats (ODF) family. The format is specified as part of the ODF 1.2 specifications published and maintained by OASIS.

## How to merge ODT files

[GroupDocs.Merger](https://products.groupdocs.com/merger/net) allows developers to merge ODT files when it's needed to organize multiple
 ODT files into single document or send fewer attachments etc. And you can do this without any third-party software or manual work involved.
 With GroupDocs.Merger it is possible to combine ODT documents of any size and structure - all text, images, tables, graphs, forms and other content will be preserved.

The following example demonstrates how to merge ODT files with several lines of C# code:

* Create an instance of [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class and pass source ODT file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
* Add another ODT file to merge with [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method. Repeat this step for other ODT documents you want to merge.
* Call [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) class [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save) method and specify the filename for the merged ODT file as parameter.

```csharp
// Load the source ODT file
using (Merger merger = new Merger(@"c:\sample1.odt"))
{
    // Add another ODT file to merge
    merger.Join(@"c:\sample2.odt");
    // Merge ODT files and save result
    merger.Save(@"c:\merged.odt");
}
```

NOTE: You may merge other Open Document formats like ODP, OTP and ODS in the same way as shown above. For this provide files by specifying their names with extension.

### Code Examples

Please find more [use-cases and complete C# sources]({{< ref "merger/net/showcases.md" >}}) of our backend and frontend examples and try them for free!

### Merge ODT Live Demo

GroupDocs.Merger for .NET provides an online [**ODT Merger App**](https://products.groupdocs.app/merger/odt), which allows you to try it for free and check its quality and accuracy.

---

## Merge pages from various documents

Path: /merger/java/merge-pages-from-various-documents/

**[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** allows to merge the source document with specific document pages from joined document into one resultant document by specifying desired page numbers or page ranges. Joined documents should be of the same format.

Here are the steps to join several document parts:

* Instantiate [Merger](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger) object with source document path or InputStream;
* Instantiate [JoinOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/JoinOptions) object and specify desired page numbers or page range to join;
* Call [join](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#join(java.lang.String,%20com.groupdocs.merger.domain.options.interfaces.IJoinOptions)) method and pass joined document file path or InputStream to it specifying [JoinOptions](https://reference.groupdocs.com/java/merger/com.groupdocs.merger.domain.options/JoinOptions) object as parameter. Repeat this step for every joined document part.
* Call [save](https://reference.groupdocs.com/java/merger/com.groupdocs.merger/Merger#save(java.lang.String)) method specifying file path to save resultant document.

The following code sample demonstrates how to join document parts:

```java
String filePath = "c:\sample.docx";
String filePath2 = "c:\sample2.docx";
String filePathOut = "c:\output\result.docx";

JoinOptions joinOptions = new JoinOptions(1, 2);

Merger merger = new Merger(filePath);
merger.join(filePath2 , joinOptions);
merger.save(filePathOut);
```

---

## Migration Notes

Path: /merger/java/migration-notes/

### Why To Migrate?  

Here are the key reasons to use the new updated API provided by GroupDocs.Merger for Java since version 19.12:
*   [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger) class introduced as a **single entry point** to manage the document processing of any supported file format (instead of **DocumentHander** class from previous versions).     
*   Product architecture was redesigned from scratch in order to **decreased memory usage** (from 10% to 400% approx. depending on document type).    
*   Document processing **API simplified and improved** so it’s easy to instantiate proper options class and control over document structure manipulation processes.    

### How To Migrate?
Here is a brief comparison of how to join documents using old and new API.  

**Old coding style**

```java
// Preparing.
String password = "SomePasswordString";

InputStream documentExample1 = new FileInputStream("c:\\sample1.docx");
InputStream documentExample2 = new FileInputStream("c:\\sample2.docx");

List<JoinItem> documentStreams = new ArrayList<JoinItem>();

JoinItem item1 = new JoinItem(documentExample1, FileFormat.Pdf, password);
documentStreams.add(item1);

JoinItem item2 = new JoinItem(documentExample2, FileFormat.Pdf, password);
documentStreams.add(item2);

// Main method.
DocumentResult result = new DocumentHandler().join(documentStreams);
OutputStream documentStream = result.getStream();

ByteArrayOutputStream byteArrayStream = (ByteArrayOutputStream) documentStream;
byte[] bytes = byteArrayStream.toByteArray();

FileOutputStream fos = new FileOutputStream(CommonUtilities.outputPath + fileName);
fos.write(bytes, 0, bytes.length);
fos.close();
```

**New coding style**

```java
Merger merger = new Merger("c:\\sample1.docx")
merger.join("c:\\sample2.docx");
merger.save("c:\\output\\result.docx");
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "merger/java/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-merger/GroupDocs.Merger-for-Java) samples and showcases.

---

## Migration Notes

Path: /merger/net/migration-notes/

### Why To Migrate?
 
Here are the key reasons to use the new updated API provided by GroupDocs.Merger for .NET since version 19.9:
*   **[Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger)** class introduced as a **single entry point** to manage the document processing of any supported file format (instead of **DocumentHander** class from previous versions).     
*   Product architecture was redesigned from scratch in order to **decreased memory usage** (from 10% to 400% approx. depending on document type).    
*   Document processing **API simplified and improved** so it’s easy to instantiate proper options class and control over document structure manipulation processes.
    

### How To Migrate?

Here is a brief comparison of how to join documents using old and new API.  

**Old coding style**

```csharp
string sourceFile1 = CommonUtilities.fileOne + fileOne;
string sourceFile2 = CommonUtilities.fileTwo + fileTwo;


// Preparing.
string password = "SomePasswordString";
Stream openFile1 = new FileStream(sourceFile1, FileMode.Open);
Stream openFile2 = new FileStream(sourceFile2, FileMode.Open);

List<JoinItem> documentStreams = new List<JoinItem>();

JoinItem item1 = new JoinItem(openFile1, FileFormat.Docx, password);
documentStreams.Add(item1);
JoinItem item2 = new JoinItem(openFile2, FileFormat.Docx, password);
documentStreams.Add(item2);


// Main method.
DocumentResult result = new DocumentHandler().Join(documentStreams);

Stream documentStream = result.Stream;
var fileStream = File.Create(CommonUtilities.outputPath + "OutPut." + FileFormat.Docx);
documentStream.CopyTo(fileStream);
documentStream.Close();
```

**New coding style**

```csharp
using (Merger merger = new Merger(@"c:\sample1.docx"))
{
    merger.Join(@"c:\sample2.docx");
    merger.Save(@"c:\output\result.docx");
}
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "merger/net/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-merger/GroupDocs.Merger-for-.NET) samples and showcases.

---

## Merge documents to DOC

Path: /merger/java/merge-documents-to-doc/

## Introduction

Consider the functionality for merging files of various formats such as [DOC](https://docs.fileformat.com/word-processing/doc/), [PDF](https://docs.fileformat.com/view/pdf/), [XPS](https://docs.fileformat.com/page-description-language/xps/), [EPUB](https://docs.fileformat.com/ebook/epub/) and [TEX](https://docs.fileformat.com/page-description-language/tex/) into a DOC document. Let's see, why do we need to combine these files into a DOC document? This article discusses the DOC format, but those ones will be more in the near future. But turn back to the DOC format. It is a standard format that allows you to display information the same on any device with any platform. It is comfortable for transferring info via the Internet or to a printer. That is why this format is chosen for the current task of combining files of various formats.

## Merge documents to DOC / DOCX

Multiple files (even different types of PDF files such as [PDF](https://docs.fileformat.com/view/pdf/), [XPS](https://docs.fileformat.com/page-description-language/xps/), [EPUB](https://docs.fileformat.com/ebook/epub/) and [TEX](https://docs.fileformat.com/page-description-language/tex/)) can be combined into a single DOC / DOCX file by using **[GroupDocs.Merger](https://products.groupdocs.com/merger/java )** API. You can also use this [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream) ) method to combine multiple DOC / DOCX files. This cross-format merge to DOC / DOCX could be useful for the cases when there is no ability to merge only DOC files. For now, GroupDocs.Merger API allows to [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream) ) other file types without password with the DOC / DOCX document loaded into [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger ) object.

The following example demonstrates how to merge DOC file with [PDF](https://docs.fileformat.com/view/pdf/), [XPS](https://docs.fileformat.com/page-description-language/xps/), [EPUB](https://docs.fileformat.com/ebook/epub/) and [TEX](https://docs.fileformat.com/page-description-language/tex/) file types:

```java
Merger merger = new Merger("c:\document1.doc"))
{
     merger.join("c:\document2.pdf");
     merger.join("c:\document3.xps");
     merger.join("c:\document4.epub");
     merger.join("c:\document5.tex");
 
	merger.save("c:\merged.doc");
}
```

Also, please read the following article: [How to properly merge streams to DOCX]({{< ref "merger/java/getting-started/use-cases/how-to-properly-merge-documents-using-java.md" >}})

---

## Working with templates

Path: /parser/java/working-with-templates/

Document template is set by [Template](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/Template) class. It contains template items - fields and tables. Each item has the unique (in the template bounds) name and optional page index - value that represents the index of the page where the template item is located; *null* if the template item is located on any page.

## Template fields

The template field is set by [TemplateField](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateField) class with the following constructor:

```java
TemplateField(TemplatePosition position, String name, Integer pageIndex)

```

| Parameter | Description |
| --- | --- |
| position | Defines the way how to find the field on a page. |
| name | A unique template item name. |
| pageIndex | The page index. An integer value that represents the index of the page where the template item is located; null if the template item is located on any page. |

[TemplatePosition](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplatePosition) is an abstract base class. The following classes are used to set template positions:

*   [TemplateFixedPosition](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateFixedPosition). Provides a template field position which is defined by the rectangular area.
*   [TemplateRegexPosition](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateRegexPosition). Provides a template field position which uses the regular expression.
*   [TemplateLinkedPosition](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateLinkedPosition). Provides a template field position which uses the linked field.

### TemplateFixedPosition

This is simplest way to define the field position. It requires to set a rectangular area on the page that bounds the field value. All the text that is contained (even partially) into the rectangular area will be extracted as a value:

```java
// Create a fixed template field with "Address" name which is bounded by a rectangle at the position (35, 160) and with the size (110, 20)
TemplateField templateField = new TemplateField(
    new TemplateFixedPosition(new Rectangle(new Point(35, 160), new Size(110, 20))),
    "Address");

```

It is recommended to define a rectangular area above (below) the center of the line that is below (above) the selected area, in order to avoid the excessive extraction of the text. For example:

| Template definition | Result |
| --- | --- |
| ![](/parser/java/images/working-with-templates.png)
  | Extracts only one line:  
67890 |
| ![](/parser/java/images/working-with-templates_1.png)) | Extracts two lines
4321 First Street  
Anytown, State ZIP |
|  ![](/parser/java/images/working-with-templates_2.png)) | Extracts four lines
Company Name  
4321 First Street  
Anytown, State ZIP  
Date: 06/02/2019 |

### TemplateRegexPosition

This way to define the field position allows to find a field value by a regular expression. For example, if the document contains "Invoice Number INV-12345" then template field can be defined in the following way:

```java
// Create a regex template field with "InvoiceNumber" name
TemplateField templateField = new TemplateField(
    new TemplateRegexPosition("Invoice Number\\s+[A-Z0-9\\-]+"), 
    "InvoiceNumber");

```

In this case as a value the entire string is extracted. To extract only a part of the string the regular expression group "value" is used:

```java
// Create a regex template field with "InvoiceNumber" name with "value" group
TemplateField templateField = new TemplateField(
    new TemplateRegexPosition("Invoice Number\\s+(?<value>[A-Z0-9\\-]+)"),
    "InvoiceNumber");

```

In this case as a value "INV-3337" string is extracted.

Regular expression fields can be used as linked fields.

### TemplateLinkedPosition

This way to define the field position allows to find a field value by extracting a rectangular area around the linked field. For example, if it's known that the field with an invoice number is placed on the right of "Invoice number" string the following code is used:

```java
// Create a regex template field to find "Invoice Number" text
TemplateField invoice = new TemplateField(new TemplateRegexPosition("Invoice Number"), "Invoice");
// Create a related template field associated with "Invoice" field and extract the value on the right of it
TemplateField invoiceNumber = new TemplateField(
    new TemplateLinkedPosition("invoice", new Size(100, 15), new TemplateLinkedPositionEdges(false, false, true, false)),
    "InvoiceNumber");

```

| Template definition | Result |
| --- | --- |
| ![](/parser/java/images/working-with-templates_3.png)) | Extracts a text on the right of "Invoice Number" field:INV-3337 

To simplify the setting of the size of template field [isAutoScale](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateLinkedPosition#isAutoScale()) property is used. The size of template field is scaled according to the related field if [isAutoScale](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateLinkedPosition#isAutoScale()) is set to true. This is useful when the font size is not known in advance, but the proportions of the size of the value (the ratio of height to width) are approximately known:

```java
// Create a regex template field to find "Invoice Number" text
TemplateField invoice = new TemplateField(new TemplateRegexPosition("Invoice Number"), "Invoice");
// Create a related template field associated with "Invoice" field and extract the value on the right of it
TemplateField invoiceNumber = new TemplateField(
    new TemplateLinkedPosition("invoice", new Size(100, 15), new TemplateLinkedPositionEdges(false, false, true, false), true),
    "InvoiceNumber");

```

| Template definition | Result |
| --- | --- |
| ![](/parser/java/images/working-with-templates_4.png)) | Extracts a text on the right of "Invoice Number" field:INV-3337 

The field value can be extracted from either side of the related field. The side of the value extraction is set by [getEdges](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateLinkedPosition#getEdges()) property. The size of rectangular area is set by [getSearchArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateLinkedPosition#getSearchArea()) property. The position of rectangular area depends on the side of the value extraction:

```java
Left: (LinkedField.Rectangle.Left - SearchAreaSize.Width; LinkedField.Rectangle.Top)
Top: (LinkedField.Rectangle.Left; LinkedField.Rectangle.Top - SearchAreaSize.Height)
Right: (LinkedField.Rectangle.Right; LinkedField.Rectangle.Top)
Bottom: (LinkedField.Rectangle.Left; LinkedField.Rectangle.Bottom)

```

The related field can be any field which was previously defined in the template:

```java
// Create a regex template field
TemplateField fromField = new TemplateField(new TemplateRegexPosition("From"), "From", 0);
// Create a related template field linked to "From" regex field and placed under it
TemplateField companyField = new TemplateField(
    new TemplateLinkedPosition("From", new Size(100, 10), new TemplateLinkedPositionEdges(false, false, false, true)),
    "FromCompany", 
    0);
// Create a related template field linked to "FromCompany" related field and placed under it
TemplateField addressField = new TemplateField(
    new TemplateLinkedPosition("FromCompany", new Size(100, 30), new TemplateLinkedPositionEdges(false, false, false, true)),
    "FromAddress", 
    0);

```

| Template definition | Result |
| --- | --- |
| ![](/parser/java/images/working-with-templates_5.png)) | The extraction is processed in the following way:Extracts data of "From" regex field (green
Extracts data of "FromCompany" related field (yellow)  
Extracts data of "FromAddress" related field (red) |

A value of the field depends on the related field. The field is always empty if the related field doesn't have a value. If the field has a value then it has a link to the related field.

### Document template with fields

An instance of [Template](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/Template) class is created by the constructor:

```java
Template(IEnumerable<TemplateItem> items)

```

This constructor accepts a collection of template items:

```java
// Create an array of template fields
TemplateItem[] fields = new TemplateItem[]
{
    new TemplateField(new TemplateRegexPosition("From"), "From", 0),
    new TemplateField(
        new TemplateLinkedPosition("From", new Size(100, 10), new TemplateLinkedPositionEdges(false, false, false, true)),
        "FromCompany",
        0),
    new TemplateField(
        new TemplateLinkedPosition("FromCompany", new Size(100, 30), new TemplateLinkedPositionEdges(false, false, false, true)),
        "FromAddress",
        0)
};
// Create a document template
Template template = new Template(java.util.Arrays.asList(fields));

```

The field name is case-insensitive (Field and FIELD - the same names) and must be unique in the template. The related field must be associated with the early defined field. If these conditions don't meet, the exception is thrown.

## Template tables

Template table is set by [TemplateTable](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTable) class with the following constructors:

```java
TemplateTable(TemplateTableLayout layout, String name, Integer pageIndex)
TemplateTable(TemplateTableParameters parameters, String name, Integer pageIndex)

```

Template table can be set by detector parameters or table layout. If the page index is omitted, tables are extracted from every document page. It's useful in the cases when the document contains pages with the same layout (pages differ only by data).

[TemplateTableParameters](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTableParameters) class has the following constructors:

```java
TemplateTableParameters(Rectangle rectangle, Iterable<Double> verticalSeparators)
TemplateTableParameters(Rectangle rectangle, Iterable<Double> verticalSeparators, Boolean hasMergedCells, Integer minRowCount, Integer minColumnCount, Integer minVerticalSpace)

```

Each of parameters is optional. The most easy way to define a table is to set the rectangular area of the table and columns separators:

```java
TemplateTableParameters parameters = new TemplateTableParameters(
    new Rectangle(new Point(175, 350), new Size(400, 200)),
    java.util.Arrays.asList(new Double[] { 185.0, 370.0, 425.0, 485.0, 545.0 }));

```

If a template table is set by detector parameters, the table is detected automatically:

```java
TemplateTableParameters parameters = new TemplateTableParameters(
    new Rectangle(new Point(175, 350), new Size(400, 200)),
    java.util.Arrays.asList(new Double[] { 185.0, 370.0, 425.0, 485.0, 545.0 }));

TemplateTable table = new TemplateTable(parameters, "Details", 0);

// Create a document template
Template template = new Template(java.util.Arrays.asList(new TemplateItem[] { table }));

```

Template table is set by table layout if the table can't be detected automatically:

```java
TemplateTableLayout layout = new TemplateTableLayout(
    java.util.Arrays.asList(new Double[] { 50.0, 95.0, 275.0 }),
    java.util.Arrays.asList(new Double[] { 325.0, 340.0, 365.0 }));

TemplateTable table = new TemplateTable(layout, "Details", null);
Template template = new Template(java.util.Arrays.asList(new TemplateItem[] { table }));

```

These collections represent bounds of columns and rows. For example, for 2x2 table there are 3 vertical and 3 horizontal separators:

```
---------
|   |   |
---------
|   |   |
---------

```

[moveTo(Point)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTableLayout#moveTo(com.groupdocs.parser.data.Point)) method is used to move Table Layout. 

For example, a document has tables on each page (or a set of documents with a table on the page). These tables differ by position and content, but have the same columns and rows. In this case a user can define [TemplateTableLayout](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTableLayout) object at (0, 0) once and then move it to the location of the definite table.

If the table position depends on the other object of the page, a user can define [TemplateTableLayout](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTableLayout) object based on template document and then move it according to an anchor object. For example, if this is a summary table and it is followed by details table (which can contain a different count of rows). In this case a user can define [TemplateTableLayout](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTableLayout) object on template document (with the known details table rectangle) and then move [TemplateTableLayout](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTableLayout) object according to the difference of details table rectangle of template and real document.

[moveTo(Point)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.templates/TemplateTableLayout#moveTo(com.groupdocs.parser.data.Point)) method returns a copy of the current object. A user can pass any coordinates (even negative - then layout will be moved to the left/top).

## Template barcodes

Template barcodes work in the same way as a template field with the fixed position. The following example shows how to define a template barcode field:

```java
// Define a barcode field
TemplateBarcode barcode = new TemplateBarcode(
        new Rectangle(new Point(590, 80), new Size(150, 150)),
        "QR");
// Create a template
Template template = new Template(Arrays.asList(new TemplateItem[]{barcode}));
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdfWithBarcodes)) {
    // Parse the document by the template
    DocumentData data = parser.parseByTemplate(template);
    // Print all extracted data
    for (int i = 0; i < data.getCount(); i++) {
        // Print field name
        System.out.print(data.get(i).getName() + ": ");
        // As we have defined only barcode fields in the template,
        // we cast PageArea property value to PageBarcodeArea
        PageBarcodeArea area = data.get(i).getPageArea() instanceof PageBarcodeArea
                ? (PageBarcodeArea) data.get(i).getPageArea()
                : null;
        System.out.println(area == null ? "Not a template barcode field" : area.getValue());
    }
}
```

## Complex template example

This example shows the template which is used to parse the following invoice:

![](/parser/java/images/working-with-templates_6.jpg)

```java
// Create detector parameters for "Details" table
TemplateTableParameters detailsTableParameters = new TemplateTableParameters(new Rectangle(new Point(35, 320), new Size(530, 55)), null);
// Create detector parameters for "Summary" table
TemplateTableParameters summaryTableParameters = new TemplateTableParameters(new Rectangle(new Point(330, 385), new Size(220, 65)), null);
// Create a collection of template items
TemplateItem[] templateItems = new TemplateItem[]
        {
                new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 135), new Size(100, 10))), "FromCompany"),
                new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 150), new Size(100, 35))), "FromAddress"),
                new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 190), new Size(150, 2))), "FromEmail"),
                new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 250), new Size(100, 2))), "ToCompany"),
                new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 260), new Size(100, 15))), "ToAddress"),
                new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 290), new Size(150, 2))), "ToEmail"),
                new TemplateField(new TemplateRegexPosition("Invoice Number"), "InvoiceNumber"),
                new TemplateField(new TemplateLinkedPosition(
                        "InvoiceNumber",
                        new Size(200, 15),
                        new TemplateLinkedPositionEdges(false, false, true, false)),
                        "InvoiceNumberValue"),
                new TemplateField(new TemplateRegexPosition("Order Number"), "InvoiceOrder"),
                new TemplateField(new TemplateLinkedPosition(
                        "InvoiceOrder",
                        new Size(200, 15),
                        new TemplateLinkedPositionEdges(false, false, true, false)),
                        "InvoiceOrderValue"),
                new TemplateField(new TemplateRegexPosition("Invoice Date"), "InvoiceDate"),
                new TemplateField(new TemplateLinkedPosition(
                        "InvoiceDate",
                        new Size(200, 15),
                        new TemplateLinkedPositionEdges(false, false, true, false)),
                        "InvoiceDateValue"),
                new TemplateField(new TemplateRegexPosition("Due Date"), "DueDate"),
                new TemplateField(new TemplateLinkedPosition(
                        "DueDate",
                        new Size(200, 15),
                        new TemplateLinkedPositionEdges(false, false, true, false)),
                        "DueDateValue"),
                new TemplateField(new TemplateRegexPosition("Total Due"), "TotalDue"),
                new TemplateField(new TemplateLinkedPosition(
                        "TotalDue",
                        new Size(200, 15),
                        new TemplateLinkedPositionEdges(false, false, true, false)),
                        "TotalDueValue"),
                new TemplateTable(detailsTableParameters, "details", null),
                new TemplateTable(summaryTableParameters, "summary", null)
        };
// Create a document template
Template template = new Template(java.util.Arrays.asList(templateItems));


```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Working with templates

Path: /parser/net/working-with-templates/

Document template is set by [Template](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/template) class. It contains template items - fields and tables. Each item has the unique (in the template bounds) name and optional page index - value that represents the index of the page where the template item is located; *null* if the template item is located on any page.

## Template fields

The template field is set by [TemplateField](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatefield) class with the following constructor:

```csharp
TemplateField(TemplatePosition position, string name, int? pageIndex)
```

| Parameter | Description |
| --- | --- |
| position | Defines the way how to find the field on a page. |
| name | A unique template item name. |
| pageIndex | The page index. An integer value that represents the index of the page where the template item is located; *null* if the template item is located on any page. |

[TemplatePosition](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templateposition) is an abstract base class. The following classes are used to set template positions:

*   [TemplateFixedPosition](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatefixedposition). Provides a template field position which is defined by the rectangular area.
*   [TemplateRegexPosition](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templateregexposition). Provides a template field position which uses the regular expression.
*   [TemplateLinkedPosition](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatelinkedposition). Provides a template field position which uses the linked field.

### TemplateFixedPosition

This is simplest way to define the field position. It requires to set a rectangular area on the page that bounds the field value. All the text that is contained (even partially) into the rectangular area will be extracted as a value:

```csharp
// Create a fixed template field with "Address" name which is bounded by a rectangle
// at the position (35, 160) and with the size (110, 20)
TemplateField templateField = new TemplateField(
    new TemplateFixedPosition(new Rectangle(new Point(35, 160), new Size(110, 20))),
    "Address");
```

It is recommended to define a rectangular area above (below) the center of the line that is below (above) the selected area, in order to avoid the excessive extraction of the text. For example:

| Template definition | Result |
| --- | --- |
| ![](/parser/net/images/working-with-templates.png)) | Extracts only one line
67890 |
|  ![](/parser/net/images/working-with-templates_1.png)) | Extracts two lines
4321 First Street  
Anytown, State ZIP |
| ![](/parser/net/images/working-with-templates_2.png)) | Extracts four lines
Company Name  
4321 First Street  
Anytown, State ZIP  
Date: 06/02/2019 |

### TemplateRegexPosition

This way to define the field position allows to find a field value by a regular expression. For example, if the document contains "Invoice Number INV-12345" then template field can be defined in the following way:

```csharp
// Create a regex template field with "InvoiceNumber" name
TemplateField templateField = new TemplateField(
    new TemplateRegexPosition("Invoice Number\\s+[A-Z0-9\\-]+"), 
    "InvoiceNumber");
```

In this case as a value the entire string is extracted. To extract only a part of the string the regular expression group "value" is used:

```csharp
// Create a regex template field with "InvoiceNumber" name with "value" group
TemplateField templateField = new TemplateField(
    new TemplateRegexPosition("Invoice Number\\s+(?<value>[A-Z0-9\\-]+)"),
    "InvoiceNumber");
```

In this case as a value "INV-3337" string is extracted.

Regular expression fields can be used as linked fields.

### TemplateLinkedPosition

This way to define the field position allows to find a field value by extracting a rectangular area around the linked field. For example, if it's known that the field with an invoice number is placed on the right of "Invoice number" string the following code is used:

```csharp
// Create a regex template field to find "Invoice Number" text
TemplateField invoice = new TemplateField(new TemplateRegexPosition("Invoice Number"), "Invoice");
// Create a related template field associated with "Invoice" field and extract the value on the right of it
TemplateField invoiceNumber = new TemplateField(
    new TemplateLinkedPosition("invoice", new Size(100, 15), new TemplateLinkedPositionEdges(false, false, true, false)),
    "InvoiceNumber");
```

| Template definition | Result |
| --- | --- |
| ![](/parser/net/images/working-with-templates_3.png)) | Extracts a text on the right of "Invoice Number" field:INV-3337 

To simplify the setting of the size of template field [AutoScale](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatelinkedposition/properties/autoscale) property is used. The size of template field is scaled according to the related field if [AutoScale](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatelinkedposition/properties/autoscale) is set to *true*. This is useful when the font size is not known in advance, but the proportions of the size of the value (the ratio of height to width) are approximately known:

```csharp
// Create a regex template field to find "Invoice Number" text
TemplateField invoice = new TemplateField(new TemplateRegexPosition("Invoice Number"), "Invoice");
// Create a related template field associated with "Invoice" field and extract the value on the right of it
TemplateField invoiceNumber = new TemplateField(
    new TemplateLinkedPosition("invoice", new Size(100, 15), new TemplateLinkedPositionEdges(false, false, true, false), true),
    "InvoiceNumber");
```

| Template definition | Result |
| --- | --- |
| ![](/parser/net/images/working-with-templates_4.png)) | Extracts a text on the right of "Invoice Number" field:INV-3337 

The field value can be extracted from either side of the related field. The side of the value extraction is set by [Edges](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatelinkedposition/properties/edges) property. The size of rectangular area is set by [SearchArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatelinkedposition/properties/searcharea) property. The position of rectangular area depends on the side of the value extraction:

```csharp
Left: (LinkedField.Rectangle.Left - SearchAreaSize.Width; LinkedField.Rectangle.Top)
Top: (LinkedField.Rectangle.Left; LinkedField.Rectangle.Top - SearchAreaSize.Height)
Right: (LinkedField.Rectangle.Right; LinkedField.Rectangle.Top)
Bottom: (LinkedField.Rectangle.Left; LinkedField.Rectangle.Bottom)
```

The related field can be any field which was previously defined in the template:

```csharp
// Create a regex template field
TemplateField fromField = new TemplateField(new TemplateRegexPosition("From"), "From", 0);
// Create a related template field linked to "From" regex field and placed under it
TemplateField companyField = new TemplateField(
    new TemplateLinkedPosition("From", new Size(100, 10), new TemplateLinkedPositionEdges(false, false, false, true)),
    "FromCompany", 
    0);
// Create a related template field linked to "FromCompany" related field and placed under it
TemplateField addressField = new TemplateField(
    new TemplateLinkedPosition("FromCompany", new Size(100, 30), new TemplateLinkedPositionEdges(false, false, false, true)),
    "FromAddress", 
    0);
```

| Template definition | Result |
| --- | --- |
| ![](/parser/net/images/working-with-templates_5.png)) | The extraction is processed in the following way:Extracts data of "From" regex field (green
Extracts data of "FromCompany" related field (yellow)  
Extracts data of "FromAddress" related field (red) |

A value of the field depends on the related field. The field is always empty if the related field doesn't have a value. If the field has a value then it has a link to the related field.

### Document template with fields

An instance of [Template](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/template) class is created by the constructor:

```csharp
Template(IEnumerable<TemplateItem> items)
```

This constructor accepts a collection of template items:

```csharp
// Create an array of template fields
TemplateItem[] fields = new TemplateItem[]
{
    new TemplateField(new TemplateRegexPosition("From"), "From", 0),
    new TemplateField(
        new TemplateLinkedPosition("From", new Size(100, 10), new TemplateLinkedPositionEdges(false, false, false, true)),
        "FromCompany",
        0),
    new TemplateField(
        new TemplateLinkedPosition("FromCompany", new Size(100, 30), new TemplateLinkedPositionEdges(false, false, false, true)),
        "FromAddress",
        0)
};
// Create a document template
Template template = new Template(fields);
```

The field name is case-insensitive (Field and FIELD - the same names) and must be unique in the template. The related field must be associated with the early defined field. If these conditions don't meet, the exception is thrown.

## Template tables

Template table is set by [TemplateTable](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetable) class with the following constructors:

```csharp
TemplateTable(TemplateTableLayout layout, string name, int? pageIndex)
TemplateTable(TemplateTableParameters parameters, string name, int? pageIndex)
```

Template table can be set by detector parameters or table layout. If the page index is omitted, tables are extracted from every document page. It's useful in the cases when the document contains pages with the same layout (pages differ only by data).

[TemplateTableParameters](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetableparameters) class has the following constructors:

```csharp
TemplateTableParameters(Rectangle rectangle, IEnumerable<double> verticalSeparators)
TemplateTableParameters(Rectangle rectangle, IEnumerable<double> verticalSeparators, bool? hasMergedCells, int? minRowCount, int? minColumnCount, int? minVerticalSpace)
```

Each of parameters is optional. The most easy way to define a table is to set the rectangular area of the table and columns separators:

```csharp
TemplateTableParameters parameters = new TemplateTableParameters(
    new Rectangle(new Point(175, 350), new Size(400, 200)),
    new double[] { 185, 370, 425, 485, 545 });
```

If a template table is set by detector parameters, the table is detected automatically:

```csharp
TemplateTableParameters parameters = new TemplateTableParameters(
    new Rectangle(new Point(175, 350), new Size(400, 200)),
    new double[] { 185, 370, 425, 485, 545 });

TemplateTable table = new TemplateTable(parameters, "Details", 0);

// Create a document template
Template template = new Template(new TemplateItem[] { table });
```

Template table is set by table layout if the table can't be detected automatically:

```csharp
TemplateTableLayout layout = new TemplateTableLayout(
    new double[] { 50, 95, 275 },
    new double[] { 325, 340, 365 });

TemplateTable table = new TemplateTable(layout, "Details", null);
Template template = new Template(new TemplateItem[] { table });
```

These collections represent bounds of columns and rows. For example, for 2x2 table there are 3 vertical and 3 horizontal separators:

```
---------
|   |   |
---------
|   |   |
---------
```

[MoveTo](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetablelayout/methods/moveto) method is used to move Table Layout. 

For example, a document has tables on each page (or a set of documents with a table on the page). These tables differ by position and content, but have the same columns and rows. In this case a user can define [TemplateTableLayout](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetablelayout) object at (0, 0) once and then move it to the location of the definite table.

If the table position depends on the other object of the page, a user can define [TemplateTableLayout](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetablelayout) object based on template document and then move it according to an anchor object. For example, if this is a summary table and it is followed by details table (which can contain a different count of rows). In this case a user can define [TemplateTableLayout](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetablelayout) object on template document (with the known details table rectangle) and then move [TemplateTableLayout](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetablelayout) object according to the difference of details table rectangle of template and real document.

[MoveTo](https://reference.groupdocs.com/net/parser/groupdocs.parser.templates/templatetablelayout/methods/moveto) method returns a copy of the current object. A user can pass any coordinates (even negative - then layout will be moved to the left/top).

## Template barcodes

Template barcodes work in the same way as a template field with the fixed position. The following example shows how to define a template barcode field:

```csharp
// Define a barcode field
TemplateBarcode barcode = new TemplateBarcode(
    new Rectangle(new Point(590, 80), new Size(150, 150)),
    "QR");

// Create a template
Template template = new Template(new TemplateItem[] { barcode });

// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Parse the document by the template
    DocumentData data = parser.ParseByTemplate(template);

    // Print all extracted data
    for (int i = 0; i < data.Count; i++)
    {
        Console.Write(data[i].Name + ": ");
        PageBarcodeArea area = data[i].PageArea as PageBarcodeArea;
        Console.WriteLine(area == null ? "Not a template barcode field" : area.Value);
    }
}
```

## Complex template example

This example shows the template which is used to parse the following invoice:

![](/parser/net/images/working-with-templates_6.jpg)

```csharp
// Create detector parameters for "Details" table
TemplateTableParameters detailsTableParameters = new TemplateTableParameters(new Rectangle(new Point(35, 320), new Size (530, 55)), null);
 
// Create detector parameters for "Summary" table
TemplateTableParameters summaryTableParameters = new TemplateTableParameters(new Rectangle(new Point(330, 385), new Size(220, 65)), null);
 
// Create a collection of template items
TemplateItem[] templateItems = new TemplateItem[]
{
    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 135), new Size(100, 10))), "FromCompany"),
    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 150), new Size(100, 35))), "FromAddress"),
    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 190), new Size(150, 2))), "FromEmail"),
    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 250), new Size(100, 2))), "ToCompany"),
    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 260), new Size(100, 15))), "ToAddress"),
    new TemplateField(new TemplateFixedPosition(new Rectangle(new Point(35, 290), new Size(150, 2))), "ToEmail"),

    new TemplateField(new TemplateRegexPosition("Invoice Number"), "InvoiceNumber"),
    new TemplateField(new TemplateLinkedPosition(
        "InvoiceNumber",
        new Size(200, 15),
        new TemplateLinkedPositionEdges(false, false, true, false)),
        "InvoiceNumberValue"),

    new TemplateField(new TemplateRegexPosition("Order Number"), "InvoiceOrder"),
    new TemplateField(new TemplateLinkedPosition(
        "InvoiceOrder",
        new Size(200, 15),
        new TemplateLinkedPositionEdges(false, false, true, false)),
        "InvoiceOrderValue"),

    new TemplateField(new TemplateRegexPosition("Invoice Date"), "InvoiceDate"),
    new TemplateField(new TemplateLinkedPosition(
        "InvoiceDate",
        new Size(200, 15),
        new TemplateLinkedPositionEdges(false, false, true, false)),
        "InvoiceDateValue"),

    new TemplateField(new TemplateRegexPosition("Due Date"), "DueDate"),
    new TemplateField(new TemplateLinkedPosition(
        "DueDate",
        new Size(200, 15),
        new TemplateLinkedPositionEdges(false, false, true, false)),
        "DueDateValue"),

    new TemplateField(new TemplateRegexPosition("Total Due"), "TotalDue"),
    new TemplateField(new TemplateLinkedPosition(
        "TotalDue",
        new Size(200, 15),
        new TemplateLinkedPositionEdges(false, false, true, false)),
        "TotalDueValue"),

    new TemplateTable(detailsTableParameters, "details", null),
    new TemplateTable(summaryTableParameters, "summary", null)
};
 
// Create a document template
Template template = new Template(templateItems); 
```

## Images and scanned PDFs

Starting from version 25.2, GroupDocs.Parser for .NET supports template-based parsing for images and scanned PDF documents. By default, it uses built-in OCR, which can be [replaced](https://docs.groupdocs.com/parser/net/use-ocr-connector/) with any other OCR engine. OCR is automatically enabled for images, but for scanned PDFs, you need to use methods with ParseByTemplateOptions.

```C#
// Load a document template from the file
Template template = Template.Load("template.xml");

// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Parse the document by the template (force OCR usage)
    DocumentData data = parser.ParseByTemplate(template, new ParseByTemplateOptions(true));

    // Print all extracted data
    for (int i = 0; i < data.Count; i++)
    {
        // Print the field's name and text
        Console.WriteLine(data[i].Name + ": " + data[i].Text);
    }
}
```

This functionality has some limitations: only simple fields, tables, and barcodes are supported. Other field types will be ignored.

## Template serialization

Since GroupDocs.Parser for .NET 23.12 it's possible to load templates from XML files instead of creating them in the code.

```c#
// Load a document template from the file
Template template = Template.Load("template.xml");

// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Parse the document by the template
    DocumentData data = parser.ParseByTemplate(template);

    // Print all extracted data
    for (int i = 0; i < data.Count; i++)
    {
        // Print the field's name and text
        Console.WriteLine(data[i].Name + ": " + data[i].Text);
    }
}
```

Templates can be saved from the code:

```C#
// Create a collection of template items
TemplateItem[] templateItems = new TemplateItem[]
{
    // ... items were omitted, see samples above
};

// Create a document template
Template template = new Template(templateItems);
// Save the document template to the file
template.Save("template.xml");
```

You can also create templates in any text editor. XML DTD file is the following:

```XML
<!ELEMENT template (items)>
<!ATTLIST template version CDATA #REQUIRED>
<!ATTLIST template rectangleTolerance CDATA #IMPLIED>

<!ELEMENT items (barcode|field|table)*>

<!ELEMENT barcode EMPTY>
<!ATTLIST barcode name CDATA #REQUIRED>
<!ATTLIST barcode pageIndex CDATA #IMPLIED>
<!ATTLIST barcode position CDATA #REQUIRED>
<!ATTLIST barcode size CDATA #REQUIRED>

<!ELEMENT field (fixed|regex|link)>
<!ATTLIST field name CDATA #REQUIRED>
<!ATTLIST field pageIndex CDATA #IMPLIED>

<!ELEMENT fixed EMPTY>
<!ATTLIST fixed position CDATA #REQUIRED>
<!ATTLIST fixed size CDATA #REQUIRED>

<!ELEMENT regex EMPTY>
<!ATTLIST regex expression CDATA #REQUIRED>
<!ATTLIST regex matchCase CDATA #IMPLIED>

<!ELEMENT link EMPTY>
<!ATTLIST link fieldName CDATA #REQUIRED>
<!ATTLIST link searchArea CDATA #REQUIRED>
<!ATTLIST link edges CDATA #REQUIRED>
<!ATTLIST link autoScale CDATA #IMPLIED>

<!ELEMENT table (layout|parameters)>
<!ATTLIST table name CDATA #REQUIRED>
<!ATTLIST table pageIndex CDATA #IMPLIED>

<!ELEMENT layout EMPTY>
<!ATTLIST layout verticalSeparators CDATA #REQUIRED>
<!ATTLIST layout horizontalSeparators CDATA #REQUIRED>

<!ELEMENT parameters EMPTY>
<!ATTLIST parameters position CDATA #REQUIRED>
<!ATTLIST parameters size CDATA #REQUIRED>
<!ATTLIST parameters verticalSeparators CDATA #IMPLIED>
<!ATTLIST parameters hasMergedCells CDATA #IMPLIED>
<!ATTLIST parameters minRowCount CDATA #IMPLIED>
<!ATTLIST parameters minColumnCount CDATA #IMPLIED>
<!ATTLIST parameters minVerticalSpace CDATA #IMPLIED>
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Merge documents to PDF

Path: /merger/java/merge-documents-to-pdf/

## Introduction

Consider the functionality for merging files of various formats such as [PDF](https://docs.fileformat.com/view/pdf/) / [XPS](https://docs.fileformat.com/page-description-language/xps/), [DOC](https://docs.fileformat.com/word-processing/doc/), [PPT](https://docs.fileformat.com/presentation/ppt/) and [XLS](https://docs.fileformat.com/spreadsheet/xls/) into a PDF document. Let's see, why do we need to combine these files into a PDF document? This article discusses the PDF format, but those ones will be more in the near future. But turn back to the PDF format. It is a standard format that allows you to display information the same on any device with any platform. It is comfortable for transferring info via the Internet or to a printer. That is why this format is chosen for the current task of combining files of various formats.

## Merge documents to PDF / XPS

Multiple files (even different types of files such as [DOC](https://docs.fileformat.com/word-processing/doc/), [PPT](https://docs.fileformat.com/presentation/ppt/), [XLS](https://docs.fileformat.com/spreadsheet/xls/)) can be combined into a single PDF / XPS file by using **[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** API. You can also use this [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream) ) method to combine multiple PDF / XPS files. This cross-format merge to PDF / XPS could be useful for the cases when there is no ability to merge only PDF / XPS files. For now, GroupDocs.Merger API allows to [Join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger#join(java.io.InputStream) ) other file types without password with the PDF / XPS document loaded into [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/Merger ) object.

The following example demonstrates how to merge PDF file with [DOC](https://docs.fileformat.com/word-processing/doc/), [PPT](https://docs.fileformat.com/presentation/ppt/) and [XLS](https://docs.fileformat.com/spreadsheet/xls/) file types:

```java
Merger merger = new Merger("c:\document1.pdf");
{
    merger.join("c:\document2.doc");
    merger.join("c:\document3.ppt");
    merger.join("c:\document4.xls");
  
    merger.save("c:\merged.pdf");
}
```

Also, please read the following article: [How to properly merge streams to PDF]({{< ref "merger/java/getting-started/use-cases/how-to-properly-merge-documents-using-java.md" >}})
---

## Working with data extracted by template

Path: /parser/java/working-with-data-extracted-by-template/

## DocumentData class

Extracted data are stored in the instance of [DocumentData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData) class:

| Member | Description |
| --- | --- |
| [getCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData#getCount()) | The total number of the data fields. |
| [get(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData#get(int)) | The data field. |
| [getFieldsByName(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/DocumentData#getFieldsByName(java.lang.String)) | Returns the collection of data fields where the name is equal to fieldName |

[FieldData](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/FieldData) class has the following members:

| Member | Description |
| --- | --- |
| [getName](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/FieldData#getName()) | The field name. |
| [getPageIndex](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/FieldData#getPageIndex()) | The page index. |
| [getPageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/FieldData#getPageArea()) | The value of the field. |
| [getLinkedField](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/FieldData#getLinkedField()) | The linked field. |

Field data are stored in [getPageArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/FieldData#getPageArea()) property. Depending on the type of the value it can contain the instance of [PageTextArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea) or [PageTableArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTableArea) classes:

```java
// Get the field data
FieldData field = data.get(i);
// Check if the field data contains a text
if(field.getPageArea() instanceof PageTextArea)
{
    // Print the field value
    System.out.println((PageTextArea)field.getPageArea()).getText());
}

```

[PageTextArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea) class represents a text block on the page. This class has the following members:

| Member | Description |
| --- | --- |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area that bounds the text area. |
| [getPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getPage()) | The page information (page index and page size). |
| [getText](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getText()) | The value of the text area. |
| [getBaseLine](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getBaseLine()) | The base line of the text area. |
| [getTextStyle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getTextStyle()) | The style of the text block (like font name, font size etc.) |
| [getAreas](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTextArea#getAreas()) | The collection of child text areas. |

The text area can be single or composite. In the first case it contains a text which is bounded by a rectangular area. In the second case it contains other text areas; text and table properties are calculated by child text areas.

[PageTableArea](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTableArea) class represents a table. This class has the following members:

| Member | Description |
| --- | --- |
| [getRectangle](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getRectangle()) | The rectangular area that bounds text area. |
| [getPage](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageArea#getPage()) | The page information (page index and page size) |
| [getRowCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTableArea#getRowCount()) | The total number of the table rows. |
| [getColumnCount](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTableArea#getColumnCount()) | The total number of the table columns. |
| [getCell(int, int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTableArea#getCell(int,%20int)) | The table cell by row and column indexes. |
| [getRowHeight(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTableArea#getRowHeight(int)) | Returns the row height. |
| [getColumnWidth(int)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.data/PageTableArea#getColumnWidth(int)) | Returns the column width. |

There are two ways to work with fields data.

## Iterate through fields

The following example shows how to iterate via extracted field data:

```java
// Print all extracted data
for (int i = 0; i < data.getCount(); i++) {
    // Print field name
    System.out.print(data.get(i).getName() + ": ");
    // As we have defined only text fields in the template,
    // we cast PageArea property value to PageTextArea
    PageTextArea area = data.get(i).getPageArea() instanceof PageTextArea
            ? (PageTextArea) data.get(i).getPageArea()
            : null;
    System.out.println(area == null ? "Not a template field" : area.getText());
}
```

## Get field by name

The following example shows how to get field by the name:

```java
// Print prices
System.out.println("Prices:");
for (FieldData field : data.getFieldsByName("Price")) {
    PageTextArea area = field.getPageArea() instanceof PageTextArea
            ? (PageTextArea) field.getPageArea()
            : null;
    System.out.println(area == null ? "Not a template field" : area.getText());
}
```

This functionality allows to iterate all data fields and select the most suitable of them. For example, if more than one text value meets the condition of the regular expression, a user can iterate over them and select the most suitable one.

## Working with tables

The following example shows how to work with extracted tables:

```java
// Parse the document by the template
DocumentData data = parser.parseByTemplate(template);
// Print all extracted data
for (int i = 0; i < data.getCount(); i++) {
    System.out.print(data.get(i).getName() + ": ");
    // Check if the field is a table
    PageTableArea area = data.get(i).getPageArea() instanceof PageTableArea
            ? (PageTableArea) data.get(i).getPageArea()
            : null;
    if (area == null) {
        continue;
    }
    // Iterate via table rows
    for (int row = 0; row < area.getRowCount(); row++) {
        // Iterate via table columns
        for (int column = 0; column < area.getColumnCount(); column++) {
            // Get the cell value
            PageTextArea cellValue = area.getCell(row, column).getPageArea() instanceof PageTextArea
                    ? (PageTextArea) area.getCell(row, column).getPageArea()
                    : null;
            // Print the space between columns
            if (column > 0) {
                System.out.print("\t");
            }
            // Print the cell value
            System.out.print(cellValue == null ? "" : cellValue.getText());
        }
        // Print new line
        System.out.println();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Working with data extracted by template

Path: /parser/net/working-with-data-extracted-by-template/

## DocumentData class

Extracted data are stored in the instance of [DocumentData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata) class:

| Member | Description |
| --- | --- |
| [Count](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata/properties/count) | The total number of the data fields. |
| DataField [Item](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata/properties/item) | The data field. |
| IList<FieldData> [GetFieldsByName(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/documentdata/methods/getfieldsbyname) | Returns the collection of data fields where the name is equal to field name. |

[FieldData](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/fielddata) class has the following members:

| Member | Description |
| --- | --- |
| [Name](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/fielddata/properties/name) | The field name. |
| [PageIndex](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/fielddata/properties/pageindex) | The page index. |
| [PageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/fielddata/properties/pagearea) | The value of the field. |
| [LinkedField](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/fielddata/properties/linkedfield) | The linked field. |

Field data are stored in [PageArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/fielddata/properties/pagearea) property. Depending on the type of the value it can contain the instance of [PageTextArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea) or [PageTableArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea) classes:

```csharp
// Get the field data
FieldData field = data[i];
// Check if the field data contains a text
if(field.PageArea is PageTextArea)
{
    // Print the field value
    Console.WriteLine((field.PageArea as PageTextArea).Text);
}
```

[PageTextArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea) class represents a text block on the page. This class has the following members:

| Member | Description |
| --- | --- |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area that bounds the text area. |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page information (page index and page size). |
| [Text](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/text) | The value of the text area. |
| [BaseLine](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/baseline) | The base line of the text area. |
| [TextStyle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/textstyle) | The style of the text block (like font name, font size etc.) |
| [Areas](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetextarea/properties/areas) | The collection of child text areas. |

The text area can be single or composite. In the first case it contains a text which is bounded by a rectangular area. In the second case it contains other text areas; text and table properties are calculated by child text areas.

[PageTableArea](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea) class represents a table. This class has the following members:

| Member | Description |
| --- | --- |
| [Rectangle](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/rectangle) | The rectangular area that bounds text area. |
| [Page](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagearea/properties/page) | The page information (page index and page size) |
| [RowCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/rowcount) | The total number of the table rows. |
| [ColumnCount](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/columncount) | The total number of the table columns. |
| PageTableAreaCell [Item](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/properties/item) | The table cell by row and column indexes. |
| double [GetRowHeight(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/methods/getrowheight) | The the row height. |
| double [GetColumnWidth(int)](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/pagetablearea/methods/getcolumnwidth) | Returns the column width. |

There are two ways to work with fields data.

## Iterate through fields

The following example shows how to iterate via extracted field data:

```csharp
for (int i = 0; i < data.Count; i++) {
    Console.Write(data[i].Name + ": ");
    PageTextArea area = data[i].PageArea as PageTextArea;
    Console.WriteLine(area == null ? "Not a template field" : area.Text);
}
```

## Get field by name

The following example shows how to get field by the name:

```csharp
// Get all the fields with "Address" name
IList<FieldData> addressFields = data.GetFieldsByName("Address");
if(addressFields.Count == 0) {
    Console.WriteLine("Address not found");
}
else {
    Console.WriteLine("Address");
    // Iterate over the fields collection
    for (int i = 0; i < addressFields.Count; i++) {
        PageTextArea area = addressFields[i].PageArea as PageTextArea;
        Console.WriteLine(area == null ? "Not a template field" : area.Text);        
        
        // If it's a related field:
        if(addressFields[i].LinkedField != null) {
            Console.Write("Linked to ");
            PageTextArea linkedArea = addressFields[i].LinkedField.PageArea as PageTextArea;
            Console.WriteLine(linkedArea == null ? "Not a template field" : linkedArea.Text);            
        }
    }
}
```

This functionality allows to iterate all data fields and select the most suitable of them. For example, if more than one text value meets the condition of the regular expression, a user can iterate over them and select the most suitable one.

## Working with tables

The following example shows how to work with extracted tables:

```csharp
// Print all extracted data
for (int i = 0; i < data.Count; i++)
{
    Console.Write(data[i].Name + ": ");
    // Check if the field is a table
    PageTableArea area = data[i].PageArea as PageTableArea;
    if (area == null)
    {
        continue;
    }
    // Iterate via table rows
    for (int row = 0; row < area.RowCount; row++)
    {
        // Iterate via table columns
        for (int column = 0; column < area.ColumnCount; column++)
        {
            // Get the cell value
            PageTextArea cellValue = area[row, column].PageArea as PageTextArea;
            // Print the space between columns
            if (column > 0)
            {
                Console.Write("\t");
            }
            // Print the cell value
            Console.Write(cellValue == null ? "" : cellValue.Text);
        }
        // Print a new line
        Console.WriteLine();
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Logging

Path: /parser/java/logging/

[ILogger](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger) interface is used to receive the information about errors, warnings and events which occur while data extraction. [ILogger](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger) interface has the following members:

| Member | Description |
| --- | --- |
| [error(String, java.lang.Exception)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger#error(java.lang.String,%20java.lang.Exception)) | Logs an error that occurred during data extraction. |
| [warning(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger#warning(java.lang.String)) | Logs a warning that occurred during data extraction. |
| [trace(String)](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger#trace(java.lang.String)) | Logs an event occurred during data extraction. |

Here are the steps to receive the information via [ILogger](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger) interface:

*   Implement the class with [ILogger](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger) interface implementation;
*   Instantiate [Parser](https://reference.groupdocs.com/java/parser/com.groupdocs.parser/Parser) object with [ParserSettings](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ParserSettings) object.

The following example shows how to receive the information via [ILogger](https://reference.groupdocs.com/java/parser/com.groupdocs.parser.options/ILogger) interface.

```java
try {
    // Create an instance of Logger class
    Logger logger = new Logger();
    // Create an instance of Parser class with the parser settings
    try (Parser parser = new Parser(Constants.SamplePassword, null, new ParserSettings(logger))) {
        // Check if text extraction is supported
        if (!parser.getFeatures().isText()) {
            System.out.println("Text extraction isn't supported.");
            return;
        }
        // Print the document text
        try (TextReader reader = parser.getText()) {
            System.out.println(reader.readToEnd());
        }
    }
} catch (InvalidPasswordException | IOException ex) {
    ; // Ignore the exception
}

class Logger implements ILogger {
    public void error(String message, Exception exception) {
        // Print error message
        System.out.println("Error: " + message);
    }

    public void trace(String message) {
        // Print event message
        System.out.println("Event: " + message);
    }

    public void warning(String message) {
        // Print warning message
        System.out.println("Warning: " + message);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured Java library we provide simple, but powerful free Apps.

You are welcome to extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Logging

Path: /parser/net/logging/

[ILogger](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger) interface is used to receive the information about errors, warnings and events which occur while data extraction. [ILogger](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger) interface has the following members:

| Member | Description |
| --- | --- |
| [Error(string, Exception)](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger/methods/error) | Logs an error that occurred during data extraction. |
| [Warning(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger/methods/warning) | Logs a warning that occurred during data extraction. |
| [Trace(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger/methods/trace) | Logs an event occurred during data extraction. |

Here are the steps to receive the information via [ILogger](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger) interface:

*   Implement the class with [ILogger](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger) interface implementation;
*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser)  object with [ParserSettings](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/parsersettings) object.

The following example shows how to receive the information via [ILogger](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/ilogger) interface.

```csharp
try
{
    // Create an instance of Logger class
    Logger logger = new Logger();
    // Create an instance of Parser class with the parser settings
    using (Parser parser = new Parser(Constants.SamplePassword, null, new ParserSettings(logger)))
    {
        // Check if text extraction is supported
        if (!parser.Features.Text)
        {
            Console.WriteLine("Text extraction isn't supported.");
            return;
        }
        // Print the document text
        using (TextReader reader = parser.GetText())
        {
            Console.WriteLine(reader.ReadToEnd());
        }
    }
}
catch (InvalidPasswordException)
{
    ; // Ignore the exception
}

private class Logger : ILogger
{
    public void Error(string message, Exception exception)
    {
        // Print error message
        Console.WriteLine("Error: " + message);
    }
    public void Trace(string message)
    {
        // Print event message
        Console.WriteLine("Event: " + message);
    }
    public void Warning(string message)
    {
        // Print warning message
        Console.WriteLine("Warning: " + message);
    }
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Generate previews

Path: /parser/java/generate-previews/

GroupDocs.Parser provides the functionality to generate document page previews by [generatePreview(PreviewOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#generatePreview(com.groupdocs.parser.options.PreviewOptions)) method:

```csharp
void generatePreview(PreviewOptions previewOptions)
```

[PreviewOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/PreviewOptions) class is used to set requirements and stream delegates for preview generation.

Here are the steps to generate document page previews:

* Prepare [PreviewOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/PreviewOptions) object;
* Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser) object;
* Call [generatePreview(PreviewOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#generatePreview(com.groupdocs.parser.options.PreviewOptions)) method.

The following example shows how to generate document page previews:

```java
// Create an instance of Parser class to generate document page previews
try (Parser parser = new Parser(Constants.SamplePdfWithToc)) {
    // Create preview options
    PreviewOptions previewOptions = new PreviewOptions(
            new ICreatePageStream() {
                @Override
                public OutputStream createPageStream(int pageNumber) {
                    try {
                        return new FileOutputStream(getOutputPath(String.format("preview_%d.png", pageNumber)));
                    } catch (IOException ex) {
                        throw new RuntimeException(ex.getMessage());
                    }
                }
            });
    // Set PNG as an output image format
    previewOptions.setPreviewFormat(PreviewFormats.Png);
    // Set DPI for the output image
    previewOptions.setDpi(72);
    // Generate previews
    parser.generatePreview(previewOptions);
}

private static String getOutputPath(String fileName) throws java.io.IOException {
    return Constants.getOutputFilePath(fileName);
}
```

{{< alert style="info" >}}Spreadsheets are rendered by tiles. See the example bellow.{{< /alert >}}

Here are the steps to generate spreadsheets page previews:

* Prepare [PreviewOptions](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.options/PreviewOptions) object;
* Instantiate [Parser](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser) object;
* Call [generatePreview(PreviewOptions)](https://reference.groupdocs.com/parser/java/com.groupdocs.parser/Parser#generatePreview(com.groupdocs.parser.options.PreviewOptions)) method.

The following example shows how to generate spreadsheet page previews:

```java
// Create an instance of Parser class to generate spreadsheet page previews
try (Parser parser = new Parser(Constants.SampleXlsx)) {
    final PageRenderInfo[] renderInfo = {null};
    // Create preview options
    PreviewOptions previewOptions = new PreviewOptions(
            new ICreatePageStream() {
                @Override
                public OutputStream createPageStream(int pageNumber) {
                    try {
                        return new FileOutputStream(getOutputPath(renderInfo[0], pageNumber));
                    } catch (IOException ex) {
                        throw new RuntimeException(ex.getMessage());
                    }
                }
            });
    // Set delegate to obtain the render info
    previewOptions.setPreviewPageRender(
            new IPreviewPageRender() {
                @Override
                public void previewPageRender(PageRenderInfo pageRenderInfo) {
                    renderInfo[0] = pageRenderInfo;
                }
            });
    // Set PNG as an output image format
    previewOptions.setPreviewFormat(PreviewFormats.Png);
    // Set DPI for the output image
    previewOptions.setDpi(72);
    // Generate previews
    parser.generatePreview(previewOptions);
}

private static String getOutputPath(PageRenderInfo renderInfo, int pageNumber) throws java.io.IOException {
    // Set the file name. If the render info is set, then tile name is {Row}x{Column}.png
    String fileName = renderInfo == null
            ? String.format("preview_%d.png", pageNumber)
            : String.format("%d\\%dx%d.png", renderInfo.getPageNumber(), renderInfo.getRow(pageNumber), renderInfo.getColumn(pageNumber));
    return Constants.getOutputFilePath(fileName);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Generate previews

Path: /parser/net/generate-previews/

GroupDocs.Parser provides the functionality to generate document page previews by [GeneratePreview(PreviewOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/generatepreview) method:

```csharp
void GeneratePreview(PreviewOptions previewOptions);
```

[PreviewOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/previewoptions) class is used to set requirements and stream delegates for preview generation.

Here are the steps to generate document page previews:

* Prepare [PreviewOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/previewoptions) object;
* Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object;
* Call [GeneratePreview(PreviewOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/generatepreview) method.

The following example shows how to generate document page previews:

```csharp
// Create an instance of Parser class to generate document page previews
using (Parser parser = new Parser(Constants.SamplePdfWithToc))
{
    // Create preview options
    PreviewOptions previewOptions = new PreviewOptions(pageNumber => File.Create(GetOutputPath($"preview_{pageNumber}.png")));
    // Set PNG as an output image format
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    // Set DPI for the output image
    previewOptions.Dpi = 72;

    // Generate previews
    parser.GeneratePreview(previewOptions);
}            

private static string GetOutputPath(string fileName)
{
    // Create the output directory if necessary
    if (!Directory.Exists(Constants.OutputPath))
    {
        Directory.CreateDirectory(Constants.OutputPath);
    }

    return Path.Combine(Constants.OutputPath, fileName);
}
```

{{< alert style="info" >}}Spreadsheets are rendered by tiles. See the example bellow.{{< /alert >}}

Here are the steps to generate spreadsheets page previews:

* Prepare [PreviewOptions](https://reference.groupdocs.com/parser/net/groupdocs.parser.options/previewoptions) object;
* Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object;
* Call [GeneratePreview(PreviewOptions)](https://reference.groupdocs.com/parser/net/groupdocs.parser/parser/methods/generatepreview) method.

The following example shows how to generate spreadsheet page previews:

```csharp
// Create an instance of Parser class to generate spreadsheet page previews
using (Parser parser = new Parser(Constants.SampleXlsx))
{
    PageRenderInfo renderInfo = null;

    // Create preview options
    PreviewOptions previewOptions = new PreviewOptions(pageNumber => File.Create(GetOutputPath(renderInfo, pageNumber)));
    // Set delegate to obtain the render info
    previewOptions.PreviewPageRender = info => renderInfo = info;
    // Set PNG as an output image format
    previewOptions.PreviewFormat = PreviewFormats.PNG;
    // Set DPI for the output image
    previewOptions.Dpi = 72;

    // Generate previews
    parser.GeneratePreview(previewOptions);
}

private static string GetOutputPath(PageRenderInfo renderInfo, int pageNumber)
{
    // Set the output directory. If the render info is set, then sheets are rendered on its own directory
    string outputDirectory = renderInfo == null 
        ? Constants.OutputPath 
        : Path.Combine(Constants.OutputPath, $"preview_{renderInfo.PageNumber}");

    // Create the output directory if necessary
    if (!Directory.Exists(outputDirectory))
    {
        Directory.CreateDirectory(outputDirectory);
    }

    // Set the file name. If the render info is set, then tile name is {Row}x{Column}.png
    string fileName = renderInfo == null
        ? $"preview_{pageNumber}.png"
        : $"{renderInfo.GetRow(pageNumber)}x{renderInfo.GetColumn(pageNumber)}.png";

    return Path.Combine(outputDirectory, fileName);
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Export Data

Path: /parser/java/export-data/

GroupDocs.Parser for Java provides the functionality to export data to XML files. [XmlExporter](https://reference.groupdocs.com/parser/java/com.groupdocs.parser.export/xmlexporter) class is used for this. 

The following example shows how to extract barcodes from a document and export them to the XML file:

```java
// Create an instance of Parser class
try (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Check if the document supports barcodes extraction
    if (!parser.getFeatures().isBarcodes())
    {
        System.out.println("Document doesn't support barcodes extraction.");
        return;
    }
    // Create the options which are used for barcodes extraction
    BarcodeOptions options = new BarcodeOptions(QualityMode.Low, QualityMode.Low, "QR");
    // Extract barcodes from the document
    Iterable<PageBarcodeArea> barcodes = parser.getBarcodes(options);
    // Export data to "data.xml" file
    XmlExporter exporter = new XmlExporter();
    exporter.exportBarcodes(barcodes, "data.xml");
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Export Data

Path: /parser/net/export-data/

GroupDocs.Parser provides the functionality to export data to JSON or XML files. [JsonExporter](https://reference.groupdocs.com/parser/net/groupdocs.parser.export/jsonexporter) or [XmlExporter](https://reference.groupdocs.com/parser/net/groupdocs.parser.export/xmlexporter) classes are used for this. Also extensions methods from [Extensions](https://reference.groupdocs.com/parser/net/groupdocs.parser.export/extensions) class can be used to simplify the code.

The following example shows how to extract barcodes from a document and export them to the JSON file:

```csharp
// Create an instance of Parser class
using (Parser parser = new Parser(Constants.SamplePdfWithBarcodes))
{
    // Check if the document supports barcodes extraction
    if (!parser.Features.Barcodes)
    {
        Console.WriteLine("Document doesn't support barcodes extraction.");
        return;
    }

    // Create the options which are used for barcodes extraction
    BarcodeOptions options = new BarcodeOptions(QualityMode.Low, QualityMode.Low, "QR");

    // Extract barcodes from the document
    IEnumerable<PageBarcodeArea> barcodes = parser.GetBarcodes(options);
    
    // Export data to "data.json" file
    barcodes.ExportAsJson("data.json");
}
```

## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## Highlighting results in network

Path: /search/java/highlighting-results-in-network/

Search results in the search network can be highlighted in the text of the found document using the [highlight](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#highlight-com.groupdocs.search.scaling.results.NetworkFoundDocument-com.groupdocs.search.highlighters.Highlighter-com.groupdocs.search.options.HighlightOptions-) method of the [Searcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/) class.

The set of available classes for highlighting text, as well as the highlighting options, are identical to those used for highlighting search results in a single index. Please see also the [Highlighting search results](https://docs.groupdocs.com/search/java/highlighting-search-results/) page.

The following code example demonstrates highlighting search results on the search network.

```java
Searcher searcher = node.getSearcher();

FragmentHighlighter highlighter = new FragmentHighlighter(OutputFormat.PlainText);

HighlightOptions options = new HighlightOptions();
options.setTermsAfter(5);
options.setTermsBefore(5);
options.setTermsTotal(15);
searcher.highlight(document, highlighter, options);

FragmentContainer[] result = highlighter.getResult();
System.out.println();
for (FragmentContainer container : result) {
    if (container.getCount() == 0) continue;

    String[] fragments = container.getFragments();
    System.out.println(container.getFieldName());
    int count = Math.min(fragments.length, maxFragments);
    for (int j = 0; j < count; j++) {
        System.out.println("\t" + fragments[j]);
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Highlighting results in network

Path: /search/net/highlighting-results-in-network/

Search results in the search network can be highlighted in the text of the found document using the [Highlight](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/highlight/) method of the [Searcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/) class.

The set of available classes for highlighting text, as well as the highlighting options, are identical to those used for highlighting search results in a single index. Please see also the [Highlighting search results](https://docs.groupdocs.com/search/net/highlighting-search-results/) page.

The following code example demonstrates highlighting search results on the search network.

**C#**

```csharp
Searcher searcher = node.Searcher;

FragmentHighlighter highlighter = new FragmentHighlighter(OutputFormat.PlainText);

HighlightOptions options = new HighlightOptions();
options.TermsAfter = 5;
options.TermsBefore = 5;
options.TermsTotal = 15;
searcher.Highlight(document, highlighter, options);

FragmentContainer[] result = highlighter.GetResult();
Console.WriteLine();
for (int i = 0; i < result.Length; i++)
{
    FragmentContainer container = result[i];
    if (container.Count == 0) continue;

    string[] fragments = container.GetFragments();
    Console.WriteLine(container.FieldName);
    int count = Math.Min(fragments.Length, maxFragments);
    for (int j = 0; j < count; j++)
    {
        Console.WriteLine("\t" + fragments[j]);
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge pages from various documents

Path: /merger/net/merge-pages-from-various-documents/

With **[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** you can combine different pages from multiple source documents into a single document. 

* To merge the entire first document along with specific pages from the second and subsequent documents, you can make use of the [PageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pagejoinoptions/) object, which is explained on this page.
* To merge arbitrary pages from all the source documents, you can use the [PageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/) object, which is explained in detail in the [Merge pages in the arbitrary order]({{< ref "merger/net/developer-guide/merge/merge-pages-in-arbitrary-order.md" >}}) section.

Using the [PageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pagejoinoptions/) object, you can merge the source document with specific document pages from the joined documents into one resultant document by specifying desired page numbers or page ranges. Joined documents should be of the same format.

 Here are the steps to join several document parts:

*   Create a [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object and provide the path or stream of the source file.
*   Create a [PageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pagejoinoptions/) object and specify desired page numbers or page ranges to join.
*   Use the [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join_3) to add another source document. Provide the path or stream of the source file and the [PageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pagejoinoptions) object as parameters. Repeat this step for every joined document part.
*   Save the resulting document by calling the [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and providing a file path.

The following code sample demonstrates how to join document parts:

```csharp
string filePath = @"c:\sample.docx";
string filePath2 = @"c:\sample2.docx";
string filePathOut = @"c:\output\result.docx";

PageJoinOptions joinOptions = new PageJoinOptions(1, 4, RangeMode.OddPages);

using (Merger merger = new Merger(filePath))
{
    merger.Join(filePath2, joinOptions);
    merger.Save(filePathOut);
}
```

---

## Convert 3D formats

Path: /conversion/net/convert/3d/


## About 3D file formats

The electronic representation of a three-dimensional object is known as a 3D file. A 3D file format is used to store information about 3D models. It usually stores information about 3D models as plain text or binary data. There are literally hundreds of 3D file formats that are widely used in 3D games, printing, computer-aided design, manufacturing, academia, engineering and more. Each industry has its own 3D file formats for several reasons. 

## Supported 3D file conversions

{{< include file="/conversion/net/_includes/supported-conversions/3d.md" type="page" >}}

## Convert from 3D formats

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your 3D document into another file format.  
For example, 3D to PDF conversion code snippet looks like this:

```csharp
// Load the source 3D file
using (Converter converter = new Converter("sample.3ds"))
{
    // Set the convert options for PDF format
    PdfConvertOptions options = new PdfConvertOptions();
    // Convert to PDF format
    converter.Convert("converted.pdf", options);
}
```

Put it simply - you just load a 3D file into the `Converter` class, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Convert to another 3D format

On the other hand, converting your files to another 3D format is also quite simple and natural.
The following code snippet shows how to convert 3DS document to FBX in C# using [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net).

```csharp
// Load the source 3DS file
using (Converter converter = new Converter("sample.3ds"))
{
    // Set the convert options for 3D format
    var options = new ThreeDConvertOptions { 
       Format = ThreeDFileType.Fbx
    };
    // Convert to FBX format
    converter.Convert("converted.fbx", options);
}
```

---

## Getting documents in network

Path: /search/java/getting-documents-in-network/

To obtain a list of indexed documents in a specific search network shard, you must call the [getIndexedDocuments](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#getIndexedDocuments-int-) method of the [Searcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/) class.

To obtain a list of shards of the search network, use the [getShardIndices](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/#getShardIndices--) method of the [SearchNetworkNode](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searchnetworknode/) class.

It is also possible to get a list of nested items of indexed container document. To do this, use the [getIndexedDocumentItems](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#getIndexedDocumentItems-com.groupdocs.search.scaling.results.NetworkDocumentInfo-) method of the [Searcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/) class.

The following code example demonstrates obtaining a list of documents indexed in the search network, as well as outputting the resulting data to the console.

```java
Searcher searcher = node.getSearcher();
Indexer indexer = node.getIndexer();

int[] shardIndices = node.getShardIndices();
System.out.println();
for (int i = 0; i < shardIndices.length; i++) {
    int shardIndex = shardIndices[i];
    NetworkDocumentInfo[] infos = searcher.getIndexedDocuments(shardIndex);
    for (NetworkDocumentInfo info : infos) {
        int nodeIndex = node.getNodeIndex(info.getShardIndex());
        System.out.println(nodeIndex + ": " + info.getShardIndex() + ": " + info.getDocumentInfo().getFilePath());
        String[] attributes = indexer.getAttributes(info.getDocumentInfo().getFilePath());
        for (String attribute : attributes) {
            System.out.println("\t\t" + attribute);
        }

        NetworkDocumentInfo[] items = searcher.getIndexedDocumentItems(info);
        for (NetworkDocumentInfo item : items) {
            System.out.println("\t" + nodeIndex + ": " + item.getShardIndex() + ": " + item.getDocumentInfo().toString());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Getting documents in network

Path: /search/net/getting-documents-in-network/

To obtain a list of indexed documents in a specific search network shard, you must call the [GetIndexedDocuments](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/getindexeddocuments/) method of the [Searcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/) class.

To obtain a list of shards of the search network, use the [GetShardIndices](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/getshardindices/) method of the [SearchNetworkNode](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searchnetworknode/) class.

It is also possible to get a list of nested items of indexed container document. To do this, use the [GetIndexedDocumentItems](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/getindexeddocumentitems/) method of the [Searcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/) class.

The following code example demonstrates obtaining a list of documents indexed in the search network, as well as outputting the resulting data to the console.

**C#**

```csharp
Searcher searcher = node.Searcher;
Indexer indexer = node.Indexer;

int[] shardIndices = node.GetShardIndices();
Console.WriteLine();
for (int i = 0; i < shardIndices.Length; i++)
{
    int shardIndex = shardIndices[i];
    NetworkDocumentInfo[] infos = searcher.GetIndexedDocuments(shardIndex);
    for (int j = 0; j < infos.Length; j++)
    {
        NetworkDocumentInfo info = infos[j];
        int nodeIndex = node.GetNodeIndex(info.ShardIndex);
        Console.WriteLine(nodeIndex + ": " + info.ShardIndex + ": " + info.DocumentInfo.FilePath);
        string[] attributes = indexer.GetAttributes(info.DocumentInfo.FilePath);
        for (int k = 0; k < attributes.Length; k++)
        {
            Console.WriteLine("\t\t" + attributes[k]);
        }

        NetworkDocumentInfo[] items = searcher.GetIndexedDocumentItems(info);
        for (int k = 0; k < items.Length; k++)
        {
            NetworkDocumentInfo item = items[k];
            Console.WriteLine("\t" + nodeIndex + ": " + item.ShardIndex + ": " + item.DocumentInfo.ToString());
        }
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge pages in the arbitrary order

Path: /merger/java/merge-pages-in-arbitrary-order/

With **[GroupDocs.Merger](https://products.groupdocs.com/merger/java)** you can combine different pages from multiple source documents into a single document. 

* To merge the entire first document along with specific pages from the second and subsequent documents, you can make use of the [PageJoinOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/pagejoinoptions/) object, which is explained in detail in the [Merge pages from various documents]({{< ref "merger/java/developer-guide/merge/merge-pages-from-various-documents.md" >}}) section.

* To merge arbitrary pages from all the source documents, you can use the [PageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/) object, which is explained on this page.


Using the [PageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/) object, you can define the specific order in which the pages from the source documents will be combined. For instance, you can merge the 3rd page from Document A with the 5th page from Document B and then with the 2nd page from Document A.

To start using the `PageBuilder` class, you need to create an instance of it. You can then use the `addPage` method to append a single page, or the `addPageRange` method to append a range of pages. Once you have added all the pages in the required order, you can apply them to the documents by calling the `Merger.applyPageBuilder` method.


## Specifying the required pages by their number

The `addPage` method allows several ways to define the page to be added.
The easiest way is to pass the `IPageInfo` object that describes the page's source document and its number. 

Here are the steps to combine several pages from various documents specifying the pages by their numbers:

*   Create a [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) object and provide the path or stream of the source file.
*   Use the [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) to add another source document. Repeat this step for each document you want to merge.
*   Create a [PageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/) object by calling the `Merger.createPageBuilder` method.
*   Call the [addPage](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/#addPage-com.groupdocs.merger.domain.result.IPageInfo-) method and pass the `IPageInfo` object describing the appropriate page. Note that the `IPageInfo` object uses zero-based notation for both source documents and page numbers.  Repeat this step for every page you want to add.
*   Use the [applyPageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#applyPageBuilder-com.groupdocs.merger.domain.builders.PageBuilder-) method to apply the specified order of pages to the merged document.
*   Save the resulting document by calling the [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and providing a file path.


```java
String filePath = "c:\sample.docx";
String filePath2 = "c:\sample2.docx";
String filePathOut = "c:\output\result.docx";

Merger merger = new Merger(filePath);
{
    merger.join(filePath2);

    PageBuilder pageBuilder = merger.createPageBuilder(null);
    // Add page 1 from the first document
    pageBuilder.addPage(pageBuilder.getDocuments().get(0).getPages()[0]);
    // Add page 3 from the second document
    pageBuilder.addPage(pageBuilder.getDocuments().get(1).getPages()[2]);
    // Add page 4 from the first document 
    pageBuilder.addPage(pageBuilder.getDocuments().get(0).getPages()[3]);
    // Add page 2 from the second document
    pageBuilder.addPage(pageBuilder.getDocuments().get(1).getPages()[1]);
    // Add page 1 from the second document
    pageBuilder.addPage(pageBuilder.getDocuments().get(1).getPages()[0]);
    // Add page 6 from the first document 
    pageBuilder.addPage(pageBuilder.getDocuments().get(1).getPages()[5]);

    // Apply the page order
    merger.applyPageBuilder(pageBuilder);

    merger.save(filePathOut);
}
```

## Specifying the required pages by their index

When adding many pages, specifying them by number is not optimal since in that case each call of the `addPage` method invokes loading of document information. To improve performance, you can skip loading the document information and specify pages by their index instead.

To combine several pages from various documents specifying the pages by their index:

*   Create a [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) object and provide the path or stream of the source file.
*   Use the [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) to add another source document. Repeat this step for each document you want to merge.
*   Create a [PageBuilderOptions](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.options/pagebuilderoptions/) object and set the `LoadDocumentInfo` property to `false`.
*   Create a [PageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/) object by calling the `Merger.createPageBuilder` method and pass the `PageBuilderOptions` to it.
*   Call the [addPage](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/#addPage-int-int-) method and pass the source document index and the index number of the needed page. Repeat this step for every page you want to add.
*   Call the [applyPageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#applyPageBuilder-com.groupdocs.merger.domain.builders.PageBuilder-) method to apply the specified order of pages to the merged document.
*   Save the resulting document by calling the [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and providing a file path.

```java
String filePath = "c:\sample.docx";
String filePath2 = "c:\sample2.docx";
String filePathOut = "c:\output\result.docx";

Merger merger = new Merger(filePath);
{
    merger.join(filePath2);

    PageBuilderOptions pageBuilderOptions = new PageBuilderOptions();
    pageBuilderOptions.setLoadDocumentInfo(false);

    PageBuilder pageBuilder = merger.createPageBuilder(pageBuilderOptions);
    // Add page 1 from the first document
    pageBuilder.addPage(pageBuilder.getDocuments().get(0).getIndex(), 1);
    // Add page 3 from the second document
    pageBuilder.addPage(pageBuilder.getDocuments().get(1).getIndex(), 3);
    // Add page 4 from the first document 
    pageBuilder.addPage(pageBuilder.getDocuments().get(0).getIndex(), 4);
    // Add page 2 from the second document
    pageBuilder.addPage(pageBuilder.getDocuments().get(1).getIndex(), 2);
    // Add page 1 from the second document
    pageBuilder.addPage(pageBuilder.getDocuments().get(1).getIndex(), 1);
    // Add page 6 from the first document 
    pageBuilder.addPage(pageBuilder.getDocuments().get(0).getIndex(), 6);
    
    // Apply the page order
    merger.applyPageBuilder(pageBuilder);

    merger.save(filePathOut);
}
```
## Specifying the range of the required pages

When you need to add multiple pages at once, you can use the `addPageRange` method. It accepts an array of `IPageInfo` objects, each describing the appropriate page.

Here are the steps to combine several pages from various documents specifying them as a range:

*   Create a [Merger](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/) object and provide the path or stream of the source file.
*   Use the [join](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#join-java.io.InputStream-) to add another source document. Repeat this step for each document you want to merge.
*   Create a [PageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/) object by calling the `Merger.createPageBuilder` method.
*   Call the [addPageRange](https://reference.groupdocs.com/merger/java/com.groupdocs.merger.domain.builders/pagebuilder/#addPageRange-com.groupdocs.merger.domain.result.IPageInfo---) method and pass an array of `IPageInfo` objects describing the appropriate pages. Please note that `IPageInfo` objects use zero-based notation for source documents and page numbers.
*   Use the [applyPageBuilder](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#applyPageBuilder-com.groupdocs.merger.domain.builders.PageBuilder-) method to apply the specified order of pages to the merged document.
*   Save the resulting document by calling the [save](https://reference.groupdocs.com/merger/java/com.groupdocs.merger/merger/#save-java.io.OutputStream-) method and providing a file path.


```java
String filePath = "c:\sample.docx";
String filePath2 = "c:\sample2.docx";
String filePathOut = "c:\output\result.docx";

Merger merger = new Merger(filePath);
{
    merger.join(filePath2);

    PageBuilder pageBuilder = merger.createPageBuilder(null);
    // Specify a range of pages
        IPageInfo[] range = new IPageInfo[] {
            pageBuilder.getDocuments().get(0).getPages()[0], // Page 1 from the first document
            pageBuilder.getDocuments().get(1).getPages()[2], // Page 3 from the second document
            pageBuilder.getDocuments().get(0).getPages()[3], // Page 4 from the first document
            pageBuilder.getDocuments().get(1).getPages()[1], // Page 2 from the second document
            pageBuilder.getDocuments().get(1).getPages()[0], // Page 1 from the second document
            pageBuilder.getDocuments().get(0).getPages()[5], // Page 6 from the first document
        };
      // Append a page of pages
    pageBuilder.addPageRange(range);

    // Apply the page order
    merger.applyPageBuilder(pageBuilder);

    merger.save(filePathOut);
}
```
---

## Merge pages in the arbitrary order

Path: /merger/net/merge-pages-in-arbitrary-order/

With **[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** you can combine different pages from multiple source documents into a single document. 

* To merge the entire first document along with specific pages from the second and subsequent documents, you can make use of the [PageJoinOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pagejoinoptions/) object, which is explained in detail in the [Merge pages from various documents]({{< ref "merger/net/developer-guide/merge/merge-pages-from-various-documents.md" >}}) section.

* To merge arbitrary pages from all the source documents, you can use the [PageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/) object, which is explained on this page.


Using the [PageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/) object, you can define the specific order in which the pages from the source documents will be combined. For instance, you can merge the 3rd page from Document A with the 5th page from Document B and then with the 2nd page from Document A.

To start using the `PageBuilder` class, you need to create an instance of it. You can then use the `AddPage` method to append a single page, or the `AddPageRange` method to append a range of pages. Once you have added all the pages in the required order, you can apply them to the documents by calling the `Merger.ApplyPageBuilder` method.


## Specifying the required pages by their number

The `AddPage` method allows several ways to define the page to be added.
The easiest way is to pass the `IPageInfo` object that describes the page's source document and its number. 

Here are the steps to combine several pages from various documents specifying the pages by their numbers:

*   Create a [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object and provide the path or stream of the source file.
*   Use the [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join_3) to add another source document. Repeat this step for each document you want to merge.
*   Create a [PageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/) object by calling the `Merger.CreatePageBuilder` method.
*   Call the [AddPage](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/addpage) method and pass the `IPageInfo` object describing the appropriate page. Note that the `IPageInfo` object uses zero-based notation for both source documents and page numbers.  Repeat this step for every page you want to add.
*   Use the [ApplyPageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/applypagebuilder) method to apply the specified order of pages to the merged document.
*   Save the resulting document by calling the [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and providing a file path.


```csharp
string filePath = @"c:\sample1.docx";
string filePath2 = @"c:\sample2.docx";
string filePathOut = @"c:\output\result.docx";

using (Merger merger = new Merger(filePath))
{
    merger.Join(filePath2);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // Add page 1 from the first document
    pageBuilder.AddPage(pageBuilder.Documents[0].Pages[0]);
    // Add page 3 from the second document
    pageBuilder.AddPage(pageBuilder.Documents[1].Pages[2]);
    // Add page 4 from the first document 
    pageBuilder.AddPage(pageBuilder.Documents[0].Pages[3]);
    // Add page 2 from the second document
    pageBuilder.AddPage(pageBuilder.Documents[1].Pages[1]);
    // Add page 1 from the second document
    pageBuilder.AddPage(pageBuilder.Documents[1].Pages[0]);
    // Add page 6 from the first document 
    pageBuilder.AddPage(pageBuilder.Documents[0].Pages[5]);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(filePathOut);
}
```

## Specifying the required pages by their index

When adding many pages, specifying them by number is not optimal since in that case each call of the `AddPage` method invokes loading of document information. To improve performance, you can skip loading the document information and specify pages by their index instead.

To combine several pages from various documents specifying the pages by their index:

*   Create a [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object and provide the path or stream of the source file.
*   Use the [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join_3) to add another source document. Repeat this step for each document you want to merge.
*   Create a [PageBuilderOptions](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.options/pagebuilderoptions/) object and set the `LoadDocumentInfo` property to `false`.
*   Create a [PageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/) object by calling the `Merger.CreatePageBuilder` method and pass the `PageBuilderOptions` to it.
*   Call the [AddPage](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/addpage) method and pass the source document index and the index number of the needed page. Repeat this step for every page you want to add.
*   Call the [ApplyPageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/applypagebuilder) method to apply the specified order of pages to the merged document.
*   Save the resulting document by calling the [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and providing a file path.

```csharp
string filePath = @"c:\sample1.docx";
string filePath2 = @"c:\sample2.docx";
string filePathOut = @"c:\output\result.docx";

using (Merger merger = new Merger(filePath))
{
    merger.Join(filePath2);

    PageBuilderOptions pageBuilderOptions = new PageBuilderOptions();
    pageBuilderOptions.LoadDocumentInfo = false;

    PageBuilder pageBuilder = merger.CreatePageBuilder(pageBuilderOptions);
    // Add page 1 from the first document
    pageBuilder.AddPage(pageBuilder.Documents[0].Index, 1);
    // Add page 3 from the second document
    pageBuilder.AddPage(pageBuilder.Documents[1].Index, 3);
    // Add page 4 from the first document 
    pageBuilder.AddPage(pageBuilder.Documents[0].Index, 4);
    // Add page 2 from the second document
    pageBuilder.AddPage(pageBuilder.Documents[1].Index, 2);
    // Add page 1 from the second document
    pageBuilder.AddPage(pageBuilder.Documents[1].Index, 1);
    // Add page 6 from the first document 
    pageBuilder.AddPage(pageBuilder.Documents[0].Index, 6);
    
    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(filePathOut);
}
```
## Specifying the range of the required pages

When you need to add multiple pages at once, you can use the `AddPageRange` method. It accepts an array of `IPageInfo` objects, each describing the appropriate page.

Here are the steps to combine several pages from various documents specifying them as a range:

*   Create a [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object and provide the path or stream of the source file.
*   Use the [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join/#join_3) to add another source document. Repeat this step for each document you want to merge.
*   Create a [PageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/) object by calling the `Merger.CreatePageBuilder` method.
*   Call the [AddPageRange](https://reference.groupdocs.com/merger/net/groupdocs.merger.domain.builders/pagebuilder/addpagerange) method and pass an array of `IPageInfo` objects describing the appropriate pages. Please note that `IPageInfo` objects use zero-based notation for source documents and page numbers.
*   Use the [ApplyPageBuilder](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/applypagebuilder) method to apply the specified order of pages to the merged document.
*   Save the resulting document by calling the [Save](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/save/#save_1) method and providing a file path.


```csharp
string filePath = @"c:\sample1.docx";
string filePath2 = @"c:\sample2.docx";
string filePathOut = @"c:\output\result.docx";

using (Merger merger = new Merger(filePath))
{
    merger.Join(filePath2);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // Specify a range of pages
    IPageInfo[] range = new IPageInfo[] {
                    pageBuilder.Documents[0].Pages[0], // Page 1 from the first document
                    pageBuilder.Documents[1].Pages[2], // Page 3 from the second document
                    pageBuilder.Documents[0].Pages[3], // Page 4 from the first document
                    pageBuilder.Documents[1].Pages[1], // Page 2 from the second document
                    pageBuilder.Documents[1].Pages[0], // Page 1 from the second document
                    pageBuilder.Documents[0].Pages[5], // Page 6 from the first document                    
                };
    // Append a range of pages
    pageBuilder.AddPageRange(range);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(filePathOut);
}
```
---

## Getting document text in network

Path: /search/java/getting-document-text-in-network/

To obtain the extracted text of indexed documents in the search network, the [getDocumentText](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#getDocumentText-com.groupdocs.search.scaling.results.NetworkDocumentInfo-com.groupdocs.search.common.OutputAdapter-) method of the [Searcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/) class is used.

The first parameter of the [getDocumentText](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#getDocumentText-com.groupdocs.search.scaling.results.NetworkDocumentInfo-com.groupdocs.search.common.OutputAdapter-) method is a document represented by the [NetworkDocumentInfo](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling.results/networkdocumentinfo/) class. A list of all indexed documents in the search network can be obtained using the [getIndexedDocuments](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#getIndexedDocuments-int-) method of the [Searcher](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/) class.

The second parameter of the [getDocumentText](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/searcher/#getDocumentText-com.groupdocs.search.scaling.results.NetworkDocumentInfo-com.groupdocs.search.common.OutputAdapter-) method is the result output adapter. In this operation, the same output adapter classes are used as those used in similar operations of a single index. For information about output adapters, see the article [Output adapters](https://docs.groupdocs.com/search/java/output-adapters/).

The following code example demonstrates retrieving the text of documents indexed in the search network, as well as outputting the resulting data to the console.

```java
Searcher searcher = node.getSearcher();

ArrayList<NetworkDocumentInfo> documents = new ArrayList<NetworkDocumentInfo>();
int[] shardIndices = node.getShardIndices();
for (int i = 0; i < shardIndices.length; i++) {
    int shardIndex = shardIndices[i];
    NetworkDocumentInfo[] infos = searcher.getIndexedDocuments(shardIndex);
    documents.addAll(Arrays.asList(infos));
    for (NetworkDocumentInfo info : infos) {
        NetworkDocumentInfo[] items = searcher.getIndexedDocumentItems(info);
        documents.addAll(Arrays.asList(items));
    }
}

for (int i = 0; i < documents.size(); i++) {
    NetworkDocumentInfo document = documents.get(i);
    if (document.getDocumentInfo().toString().contains(containsInPath)) {
        System.out.println();
        System.out.println(document.getDocumentInfo().toString());

        StringOutputAdapter outputAdapter = new StringOutputAdapter(OutputFormat.PlainText);
        searcher.getDocumentText(document, outputAdapter);

        System.out.println(outputAdapter.getResult());
        break;
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Getting document text in network

Path: /search/net/getting-document-text-in-network/

To obtain the extracted text of indexed documents in the search network, the [GetDocumentText](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/getdocumenttext/) method of the [Searcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/) class is used.

The first parameter of the [GetDocumentText](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/getdocumenttext/) method is a document represented by the [NetworkDocumentInfo](https://reference.groupdocs.com/search/net/groupdocs.search.scaling.results/networkdocumentinfo/) class. A list of all indexed documents in the search network can be obtained using the [GetIndexedDocuments](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/getindexeddocuments/) method of the [Searcher](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/) class.

The second parameter of the [GetDocumentText](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/searcher/getdocumenttext/) method is the result output adapter. In this operation, the same output adapter classes are used as those used in similar operations of a single index. For information about output adapters, see the article [Output adapters](https://docs.groupdocs.com/search/net/output-adapters/).

The following code example demonstrates retrieving the text of documents indexed in the search network, as well as outputting the resulting data to the console.

**C#**

```csharp
Searcher searcher = node.Searcher;

List<NetworkDocumentInfo> documents = new List<NetworkDocumentInfo>();
int[] shardIndices = node.GetShardIndices();
for (int i = 0; i < shardIndices.Length; i++)
{
    int shardIndex = shardIndices[i];
    NetworkDocumentInfo[] infos = searcher.GetIndexedDocuments(shardIndex);
    documents.AddRange(infos);
    for (int j = 0; j < infos.Length; j++)
    {
        NetworkDocumentInfo info = infos[j];
        NetworkDocumentInfo[] items = searcher.GetIndexedDocumentItems(info);
        documents.AddRange(items);
    }
}

for (int i = 0; i < documents.Count; i++)
{
    NetworkDocumentInfo document = documents[i];
    if (document.DocumentInfo.ToString().Contains(containsInPath))
    {
        Console.WriteLine();
        Console.WriteLine(document.DocumentInfo.ToString());

        StringOutputAdapter outputAdapter = new StringOutputAdapter(OutputFormat.PlainText);
        searcher.GetDocumentText(document, outputAdapter);

        Console.WriteLine(outputAdapter.GetResult());
        break;
    }
}
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge documents to DOC

Path: /merger/net/merge-documents-to-doc/

## Introduction

Consider the functionality for merging files of various formats such as [DOC](https://docs.fileformat.com/word-processing/doc/), [PDF](https://docs.fileformat.com/view/pdf/), [XPS](https://docs.fileformat.com/page-description-language/xps/), [EPUB](https://docs.fileformat.com/ebook/epub/) and [TEX](https://docs.fileformat.com/page-description-language/tex/) into a DOC document. Let's see, why do we need to combine these files into a DOC document? This article discusses the DOC format, but those ones will be more in the near future. But turn back to the DOC format. It is a standard format that allows you to display information the same on any device with any platform. It is comfortable for transferring info via the Internet or to a printer. That is why this format is chosen for the current task of combining files of various formats.

## Merge documents to DOC / DOCX

Multiple files (even different types of PDF files such as [PDF](https://docs.fileformat.com/view/pdf/), [XPS](https://docs.fileformat.com/page-description-language/xps/), [EPUB](https://docs.fileformat.com/ebook/epub/) and [TEX](https://docs.fileformat.com/page-description-language/tex/)) can be combined into a single DOC / DOCX file by using **[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** API. You can also use this [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method to combine multiple DOC / DOCX files. This cross-format merge to DOC / DOCX could be useful for the cases when there is no ability to merge only DOC files. For now, GroupDocs.Merger API allows to [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) other file types without password with the DOC / DOCX document loaded into [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object.

The following example demonstrates how to merge DOC file with [PDF](https://docs.fileformat.com/view/pdf/), [XPS](https://docs.fileformat.com/page-description-language/xps/), [EPUB](https://docs.fileformat.com/ebook/epub/) and [TEX](https://docs.fileformat.com/page-description-language/tex/) file types:

```csharp
using (Merger merger = new Merger(@"c:\document1.doc"))
{
    merger.Join(@"c:\document2.pdf");
    merger.Join(@"c:\document3.xps");
    merger.Join(@"c:\document4.epub");
    merger.Join(@"c:\document5.tex");
    merger.Save(@"c:\merged.doc");
}
```

Also, please read the following article: [How to correctly merge streams to DOCX]({{< ref "merger/net/getting-started/use-cases/how-to-correctly-merge-documents-using-csharp.md" >}})
---

## Convert audio formats

Path: /conversion/net/convert/audio/


## About audio file formats

The audio file format is a category of digital file formats for the representation of audio information along with its meta-data. Multiple audio file formats exist based on the nature of data contained within the audio file. Such files can be stored in compressed as well as uncompressed audio file formats. Popular audio file formats include MP3, WAV, PCM, and WMA.

## Supported audio file conversions

{{< include file="/conversion/net/_includes/supported-conversions/audio.md" type="page" >}}

## Convert to another audio format

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your audio file into another audio file format.

To allow audio conversions, [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) provides an extension point to offload actual audio conversion to an audio processing library, but at the same time gives you the simplicity of conversion setup. The extension point is the [IAudioConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.audio/iaudioconnector) interface. 

First, you must decide which audio processing library you will use. Different libraries have different setup processes.

In our example, we will use the FFMPEG library. We recommend using [Chocolatey](https://chocolatey.org/) to install the [FFMPG](https://ffmpeg.org/) library and all needed dependencies. 
To install FFMPEG with Chocolatey, run the following console command:
```shell
choco install ffmpeg
```

Once the audio processing library is installed, you must implement an [IAudioConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.audio/iaudioconnector) interface. For this implementation, the [FFMpegCore](https://www.nuget.org/packages/FFMpegCore) NuGet package must be installed in your project. The following snippet provides a sample implementation:

```csharp
public class AudioConnector : IAudioConnector
{
    private readonly Dictionary<AudioFileType, Action<FFMpegArgumentOptions>> _optionsMap = new Dictionary<AudioFileType, Action<FFMpegArgumentOptions>>();

    public AudioConnector()
    {
        _optionsMap.Add(AudioFileType.Mp3, SetMp3ConvertOptions);
        _optionsMap.Add(AudioFileType.Ogg, SetOggConvertOptions);
        _optionsMap.Add(AudioFileType.Aac, SetAacConvertOptions);
        _optionsMap.Add(AudioFileType.Ac3, SetAc3ConvertOptions);
        _optionsMap.Add(AudioFileType.Flac, SetFlacConvertOptions);
        _optionsMap.Add(AudioFileType.Wma, SetWmaConvertOptions);
        _optionsMap.Add(AudioFileType.Wav, SetWavConvertOptions);
        _optionsMap.Add(AudioFileType.M4a, SetM4aConvertOptions);
        _optionsMap.Add(AudioFileType.Aiff, SetAiffConvertOptions);
    }

    public Stream ConvertAudio(Stream sourceStream, AudioConvertOptions convertOptions)
    { 
        var resultStream = new MemoryStream();

        var arguments = FFMpegArguments
            .FromPipeInput(new StreamPipeSource(sourceStream))
            .OutputToPipe(new StreamPipeSink(resultStream), options =>
            {
                if (_optionsMap.ContainsKey(convertOptions.Format))
                {
                    _optionsMap[convertOptions.Format].Invoke(options);
                }
                else
                {
                    throw new InvalidOperationException(
                        $"Conversion to {convertOptions.Format.Extension} is not supported at the moment");
                }
            });
        arguments.ProcessSynchronously();
            
        return resultStream;
    }

    private void SetMp3ConvertOptions(FFMpegArgumentOptions options)
    {
        options.WithAudioCodec(AudioCodec.LibMp3Lame);
        options.ForceFormat("mp3");
    }

    private void SetOggConvertOptions(FFMpegArgumentOptions options)
    {
        options.WithAudioCodec(AudioCodec.LibVorbis);
        options.ForceFormat("ogg");
    }

    private void SetAacConvertOptions(FFMpegArgumentOptions options)
    {
        options.WithAudioCodec(AudioCodec.Aac);
        options.ForceFormat("adts");
    }

    private void SetAc3ConvertOptions(FFMpegArgumentOptions options)
    {
        options.WithAudioCodec(AudioCodec.Ac3);
        options.ForceFormat("ac3");
    }

    private void SetFlacConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("flac");
    }

    private void SetWmaConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("asf");
    }

    private void SetWavConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("wav");
    }

    private void SetM4aConvertOptions(FFMpegArgumentOptions options)
    {
        options.WithAudioCodec(AudioCodec.Aac);
        options.ForceFormat("adts");
    }

    private void SetAiffConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("aiff");
    }
}
```

Once the `IAudioConnector` interface is implemented, the MP3 to FLAC conversion code snippet looks like this:

```csharp
// Load the source MP3 file
AudioLoadOptions loadOptions = new AudioLoadOptions();
loadOptions.SetAudioConnector(new AudioConnector());
using (Converter converter = new Converter("sample.mp3", (LoadContext loadContext) => loadOptions))
{
    // Set the convert options for FLAC format
    AudioConvertOptions options = new AudioConvertOptions {
        Format = AudioFileType.Flac
    };
    // Convert to FLAC format
    converter.Convert("converted.flac", options);
}
```

Put it simply - you install the audio processing library, implement the `IAudioConnector` interface which links `GroupDocs.Conversion` with the audio processing library, load an audio file into the `Converter` class providing the `IAudioConnector` instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

---

## Managing dictionaries in network

Path: /search/java/managing-dictionaries-in-network/

To obtain a dictionary from a shard of a search network node, use the [getDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#getDictionary-com.groupdocs.search.dictionaries.DictionaryType-int-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class. The first parameter of the [getDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#getDictionary-com.groupdocs.search.dictionaries.DictionaryType-int-) method is the type of the required dictionary, and the second parameter is the index of the shard in the network. The method returns an object of type [DictionaryBase](https://reference.groupdocs.com/search/java/com.groupdocs.search.dictionaries/dictionarybase/), which must be cast to the required dictionary type. In the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class there are also methods that immediately return the desired dictionary type without casting the type and without specifying the type in the parameters.

You can then perform all operations on the dictionary object that are valid for a dictionary in a single index. For information about working with dictionaries, see articles [Managing Dictionaries](https://docs.groupdocs.com/search/java/managing-dictionaries/).

And after setting up the dictionary, you need to return the dictionary object back to the shard using the [setDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#setDictionary-com.groupdocs.search.dictionaries.DictionaryBase-int-) method of the [Indexer](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/) class, specifying the index of the desired shard. Alternatively, you can set the dictionary object to all shards by the [setDictionary](https://reference.groupdocs.com/search/java/com.groupdocs.search.scaling/indexer/#setDictionary-com.groupdocs.search.dictionaries.DictionaryBase-) method with one parameter without specifying the shard index.

The following code example demonstrates working with dictionaries on the search network.

```java
System.out.println("Adding synonyms");

Indexer indexer = node.getIndexer();

int[] indices = node.getShardIndices();
SynonymDictionary dictionary = indexer.getSynonymDictionary(indices[0]);

if (clearBeforeAdding) {
    dictionary.clear();
}
dictionary.addRange(new String[][] { group });

indexer.setDictionary(dictionary);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Managing dictionaries in network

Path: /search/net/managing-dictionaries-in-network/

To obtain a dictionary from a shard of a search network node, use the [GetDictionary](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/getdictionary/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class. The first parameter of the [GetDictionary](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/getdictionary/) method is the type of the required dictionary, and the second parameter is the index of the shard in the network. The method returns an object of type [DictionaryBase](https://reference.groupdocs.com/search/net/groupdocs.search.dictionaries/dictionarybase/), which must be cast to the required dictionary type. In the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class there are also methods that immediately return the desired dictionary type without casting the type and without specifying the type in the parameters.

You can then perform all operations on the dictionary object that are valid for a dictionary in a single index. For information about working with dictionaries, see articles [Managing Dictionaries](https://docs.groupdocs.com/search/net/managing-dictionaries/).

And after setting up the dictionary, you need to return the dictionary object back to the shard using the [SetDictionary](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/setdictionary/) method of the [Indexer](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/) class, specifying the index of the desired shard. Alternatively, you can set the dictionary object to all shards by the [SetDictionary](https://reference.groupdocs.com/search/net/groupdocs.search.scaling/indexer/setdictionary/) method with one parameter without specifying the shard index.

The following code example demonstrates working with dictionaries on the search network.

**C#**

```csharp
Console.WriteLine("Adding synonyms");

Indexer indexer = node.Indexer;

int[] indices = node.GetShardIndices();
SynonymDictionary dictionary = indexer.GetSynonymDictionary(indices[0]);

if (clearBeforeAdding)
{
    dictionary.Clear();
}
dictionary.AddRange(new string[][] { group });

indexer.SetDictionary(dictionary);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)

*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)


### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).

---

## Merge documents to PDF

Path: /merger/net/merge-documents-to-pdf/

## Introduction

Consider the functionality for merging files of various formats such as [PDF](https://docs.fileformat.com/view/pdf/) / [XPS](https://docs.fileformat.com/page-description-language/xps/), [DOC](https://docs.fileformat.com/word-processing/doc/), [PPT](https://docs.fileformat.com/presentation/ppt/) and [XLS](https://docs.fileformat.com/spreadsheet/xls/) into a PDF document. Let's see, why do we need to combine these files into a PDF document? This article discusses the PDF format, but those ones will be more in the near future. But turn back to the PDF format. It is a standard format that allows you to display information the same on any device with any platform. It is comfortable for transferring info via the Internet or to a printer. That is why this format is chosen for the current task of combining files of various formats.

## Merge documents to PDF / XPS

Multiple files (even different types of files such as [DOC](https://docs.fileformat.com/word-processing/doc/), [PPT](https://docs.fileformat.com/presentation/ppt/), [XLS](https://docs.fileformat.com/spreadsheet/xls/)) can be combined into a single PDF / XPS file by using **[GroupDocs.Merger](https://products.groupdocs.com/merger/net)** API. You can also use this [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) method to combine multiple PDF / XPS files. This cross-format merge to PDF / XPS could be useful for the cases when there is no ability to merge only PDF / XPS files. For now, GroupDocs.Merger API allows to [Join](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger/join) other file types without password with the PDF / XPS document loaded into [Merger](https://reference.groupdocs.com/merger/net/groupdocs.merger/merger) object.

The following example demonstrates how to merge PDF file with [DOC](https://docs.fileformat.com/word-processing/doc/), [PPT](https://docs.fileformat.com/presentation/ppt/) and [XLS](https://docs.fileformat.com/spreadsheet/xls/) file types:

```csharp
using (Merger merger = new Merger(@"c:\document1.pdf"))
{
    merger.Join(@"c:\document2.doc");
    merger.Join(@"c:\document3.ppt");
    merger.Join(@"c:\document4.xls");
    merger.Save(@"c:\merged.pdf");
}
```

Also, please read the following article: [How to correctly merge streams to PDF]({{< ref "merger/net/getting-started/use-cases/how-to-correctly-merge-documents-using-csharp.md" >}})
---

## Convert videos

Path: /conversion/net/convert/video/


## About video file formats

Everyone is familiar with videos that we daily watch on media devices such as Televisions, Cinema screens, and social media channels such as Facebook, Twitter, YouTube, and many others. But have you ever wondered how these videos are stored and the formats in which these can be uploaded for viewing? What is the best file format for your video to be hosted on different storage media? Video file formats comprise many different video types for storing videos and to be used for various purposes. Popular video file formats that you may have come across include AVI, MOV, WMV, M4V, and MP4.

## Supported video file conversions

{{< include file="/conversion/net/_includes/supported-conversions/video.md" type="page" >}}

## Convert to another video format

With [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) you can easily convert your video file into another video file format.  

To allow video conversions [GroupDocs.Conversion](https://products.groupdocs.com/conversion/net) provides an extension point to offload actual video conversion to the video processing library, but at the same time gives you the simplicity of conversion setup. The extension point is the [IVideoConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.video/ivideoconnector) interface. 

At first, you must decide which video processing library you will use. Different libraries have different setup processes.

In our example, we will use the FFMPEG library. We recommend using [Chocolatey](https://chocolatey.org/) to install [FFMPG](https://ffmpeg.org/) and all needed dependencies. 
To install FFMPEG with Chocolatey, run the following console command:
```shell
choco install ffmpeg
```

Once the video processing library is installed, you must implement the [IVideoConnector](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.integration.video/ivideoconnector) interface. For this implementation, the [FFMpegCore](https://www.nuget.org/packages/FFMpegCore)](https://www.nuget.org/packages/FFMpegCore) NuGet package must be installed in your project. The following snippet provides a sample implementation:

```csharp
public class VideoConnector : IVideoConnector
{
    private readonly Dictionary<VideoFileType, Action<FFMpegArgumentOptions>> _optionsMap = new();
    public VideoConnector()
    {
        _optionsMap.Add(VideoFileType.Avi, SetAviConvertOptions);
        _optionsMap.Add(VideoFileType.Flv, SetFlvConvertOptions);
        _optionsMap.Add(VideoFileType.Mkv, SetMkvConvertOptions);
        _optionsMap.Add(VideoFileType.Mp4, SetMp4ConvertOptions);
        _optionsMap.Add(VideoFileType.Wmv, SetWmvConvertOptions);
        _optionsMap.Add(VideoFileType.Mov, SetMovConvertOptions);
        _optionsMap.Add(VideoFileType.Webm, SetWebmConvertOptions);
    }

    public Stream ConvertVideo(Stream sourceStream, VideoConvertOptions convertOptions)
    { 
        var resultStream = new MemoryStream();

        var arguments = FFMpegArguments
            .FromPipeInput(new StreamPipeSource(sourceStream))
            .OutputToPipe(new StreamPipeSink(resultStream), options =>
            {
                if (_optionsMap.ContainsKey(convertOptions.Format))
                {
                    _optionsMap[convertOptions.Format].Invoke(options);
                }
                else
                {
                    throw new InvalidOperationException(
                        $"Conversion to {convertOptions.Format.Extension} is not supported at the moment");
                }
            });
        arguments.ProcessSynchronously();
            
        return resultStream;
    }

    private void SetAviConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("avi");
    }

    private void SetFlvConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("flv");
    }

    private void SetMkvConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("matroska");
    }

    private void SetMp4ConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("mp4");
        options.WithCustomArgument("-movflags empty_moov");
    }

    private void SetWmvConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("asf");
    }

    private void SetMovConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("mov");
        options.WithCustomArgument("-movflags empty_moov");
    }

    private void SetWebmConvertOptions(FFMpegArgumentOptions options)
    {
        options.ForceFormat("webm");
    }

}
```

Once the `IVideoConnector` interface is implemented, the AVI to MP4 conversion code snippet looks like this:

```csharp
// Load the source AVI file
VideoLoadOptions loadOptions = new VideoLoadOptions();
loadOptions.SetVideoConnector(new VideoConnector());
using (Converter converter = new Converter("sample.avi", (LoadContext loadContext) => loadOptions))
{
    // Set the convert options for MP4 format
    VideoConvertOptions options = new VideoConvertOptions {
        Format = VideoFileType.Mp4
    };
    // Convert to MP4 format
    converter.Convert("converted.mp4", options);
}
```

Put it simply - you install the video processing library, implement the `IVideoConnector` interface which links the `GroupDocs.Conversion` with video processing library, load a video file into the `Converter` class providing the `IVideoConnector` instance, select the desired output format and **GroupDocs.Conversion** does all the rest.  

{{< alert style="info" >}}
Refer to the [API reference](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert) for more conversion options and customizations.
{{< /alert >}}

## Extract audio track
Extracting an audio track from a video is similar to converting video, however, you need to set the [ExtractAudioOnly](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/videoconvertoptions/extractaudioonly/) property to `true` and specify the desired output format in the [AudioFormat](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/videoconvertoptions/audioformat/) property:

```csharp
// Load the source AVI file
VideoLoadOptions loadOptions = new VideoLoadOptions();
loadOptions.SetVideoConnector(new VideoConnector());
using (Converter converter = new Converter("sample_with_audio.avi", (LoadContext loadContext) => loadOptions))
{
    // Set the convert options
    VideoConvertOptions options = new VideoConvertOptions
    {
        ExtractAudioOnly = true,
        AudioFormat = AudioFileType.Ogg
    };
    // Convert to audio file
    converter.Convert("extracted_audio.ogg", options);
}
```
---

## Migration Notes

Path: /editor/java/migration-notes/

## Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Editor for Java since version 20.8:

* **Editor** class introduced as a **single entry point** to manage the document editing process to any supported file format (instead of **EditorHander** class from previous versions).
* Product architecture was redesigned from scratch in order to **decreased memory usage** (from 10% to 400% approx. depending on document type).
* Document **editing** and **saving options simplified** so it’s easy to instantiate proper options class and control over document editing and saving processes.

## How To Migrate?

Here is a brief comparison of how to edit document in HTML form using old and new API.  

**Old coding style**

```java
InputStream sourceStream = new FileInputStream("C:\\sample.docx");

try {
    InputHtmlDocument htmlDoc = EditorHandler.toHtml(sourceStream);
    // Obtain HTML document content
    String htmlContent = htmlDoc.getContent();
    // Edit html in WYSIWYG-editor...
    // ...
  
    // Save edited html to original document format
    OutputHtmlDocument editedHtmlDoc = OutputHtmlDocument.fromMarkup(htmlContent, CommonUtilities.sourcePath + CommonUtilities.sourceResourcesFolder);
  
    WordsSaveOptions saveOptions = new WordsSaveOptions();
    saveOptions.setOutputFormat(WordFormats.Rtf);
  
    OutputStream outputStream = new FileOutputStream("C:\\output\\edited.docx");
  
    EditorHandler.toDocument(editedHtmlDoc, outputStream, saveOptions);
  
    outputStream.close();
} catch (Exception ex){
    ex.getMessage();
}

// close stream object to release file for other methods.
inputStream.close();
```

**New coding style**

```java
String documentPath = "C://sample.docx";
try {
    Editor editor = new Editor(documentPath);

    // Obtain editable document from original DOCX document
    EditableDocument editableDocument = editor.edit();
    String htmlContent = editableDocument.getEmbeddedHtml();
    // Pass htmlContent to WYSIWYG editor and edit there...
    // ...

    // Save edited EditableDocument object to some WordProcessing format - DOC for example
    WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
    editor.save(editableDocument, "C:\\output\\edited.docx", saveOptions);

} catch (Exception ex) {
    ex.getMessage();
}
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "editor/java/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-editor/GroupDocs.Editor-for-Java) samples and showcases.

---

## Migration Notes

Path: /editor/net/migration-notes/

## Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Editor for .NET since version 19.9:

* **Editor** class introduced as a **single entry point** to manage the document editing process to any supported file format (instead of **EditorHander** class from previous versions).
* Product architecture was redesigned from scratch in order to **decreased memory usage** (from 10% to 400% approx. depending on document type).
* Document **editing** and **saving options simplified** so it’s easy to instantiate proper options class and control over document editing and saving processes.

## How To Migrate?

Here is a brief comparison of how to edit document in HTML form using old and new API.  

**Old coding style**

```csharp
string documentPath = @"C:\sample.docx"; 
// Obtain document stream
Stream sourceStream = File.Open(documentPath, FileMode.Open, FileAccess.Read);

using (InputHtmlDocument htmlDoc = EditorHandler.ToHtml(sourceStream))
{
    // Obtain HTML document content
    string htmlContent = htmlDoc.GetContent();
  
    // Edit html in WYSIWYG-editor...
    // ...
  
    // Save edited html to original document format
    using (OutputHtmlDocument editedHtmlDoc = OutputHtmlDocument.FromMarkup(htmlContent, Path.Combine(Common.sourcePath, Common.resultResourcesFolder)))
    {
        using (System.IO.FileStream outputStream = System.IO.File.Create(@"C:\output\edited.docx"))
        {
            WordProcessingSaveOptions  saveOptions = new WordProcessingSaveOptions();
            EditorHandler.ToDocument(editedHtmlDoc, outputStream, saveOptions);
        }
    }
}

// close stream object to release file for other methods.
sourceStream.Close();
```

**New coding style**

```csharp
string documentPath = @"C:\sample.docx"; 
using (Editor editor = new Editor(documentPath))
{
    // Obtain editable document from original DOCX document
    EditableDocument editableDocument = editor.Edit();
    string htmlContent = editableDocument.GetEmbeddedHtml();
    // Pass htmlContent to WYSIWYG editor and edit there...
    // ...
  
    // Save edited EditableDocument object to some WordProcessing format - DOC for example
    WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(Formats.WordProcessingFormats.Docx);
    editor.Save(editableDocument, @"C:\output\edited.docx", saveOptions);
}
```

For more code examples and specific use cases please refer to our [Developer Guide]({{< ref "editor/net/developer-guide/_index.md" >}}) documentation or [GitHub](https://github.com/groupdocs-editor/GroupDocs.Editor-for-.NET) samples and showcases.

---

## 

Path: /conversion/java/_includes/supported-conversions/audio/

| From | To |
| --- | --- |
| AAC | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| AC3 | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| AIFF | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| FLAC | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| M4A | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| MP3 | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| OGG | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| WAV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |
| WMA | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/cad/

| From | To |
| --- | --- |
| CF2 | CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DGN | CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWF | CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWFX | CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWG | CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWT | CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DXF | CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| IFC | CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| IGS | CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PLT | CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| STL | CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/compression/

| From | To |
| --- | --- |
| 7Z | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| BZ2 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CAB | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CPIO | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GZIP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| LZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| LZMA | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| RAR | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TAR | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| Z | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ZIP | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/database/

| From | To |
| --- | --- |
| LOG | Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| NSF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SQL | Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/diagram/

| From | To |
| --- | --- |
| VDX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSD | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSDM | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSDX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSS | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSSM | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSSX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VST | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSTM | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSTX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VTX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/ebook/

| From | To |
| --- | --- |
| AZW3 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EPUB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MOBI | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/email-and-outlook/

| From | To |
| --- | --- |
| EML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMLX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MBOX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MSG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OST | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PST | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VCF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/font/

| From | To |
| --- | --- |
| CFF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| EOT | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| OTF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| PFB | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| TTF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| WOFF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| WOFF2 | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/formats-brief/

## CAD
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CF2](/conversion/java/convert/cad/) | Common File Format File |<!--Load--> ✅ |<!--Save-->  |
| [DGN](/conversion/java/convert/cad/) | MicroStation Design File |<!--Load--> ✅ |<!--Save-->  |
| [DWF](/conversion/java/convert/cad/) | Design Web Format File |<!--Load--> ✅ |<!--Save-->  |
| [DWFX](/conversion/java/convert/cad/) | Design Web Format File |<!--Load--> ✅ |<!--Save-->  |
| [DWG](/conversion/java/convert/cad/) | AutoCAD Drawing Database File |<!--Load--> ✅ |<!--Save-->  |
| [DWT](/conversion/java/convert/cad/) | AutoCAD Drawing Template |<!--Load--> ✅ |<!--Save-->  |
| [DXF](/conversion/java/convert/cad/) | Drawing Exchange Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [IFC](/conversion/java/convert/cad/) | Industry Foundation Classes File |<!--Load--> ✅ |<!--Save-->  |
| [IGS](/conversion/java/convert/cad/) | Initial Graphics Exchange Specification (IGES) |<!--Load--> ✅ |<!--Save-->  |
| [PLT](/conversion/java/convert/cad/) | PLT (HPGL) |<!--Load--> ✅ |<!--Save-->  |
| [STL](/conversion/java/convert/cad/) | Stereolithography File |<!--Load--> ✅ |<!--Save-->  |

## Compression
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [7Z](/conversion/java/convert/compression/) | 7-Zip Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [BZ2](/conversion/java/convert/compression/) | Bzip2 Compressed File |<!--Load--> ✅ |<!--Save-->  |
| [CAB](/conversion/java/convert/compression/) | Windows Cabinet File |<!--Load--> ✅ |<!--Save-->  |
| [CPIO](/conversion/java/convert/compression/) | CPIO Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [GZ](/conversion/java/convert/compression/) | Gnu Zipped Archive |<!--Load--> ✅ |<!--Save-->  |
| [GZIP](/conversion/java/convert/compression/) | Gzip Compressed File |<!--Load--> ✅ |<!--Save-->  |
| [LZ](/conversion/java/convert/compression/) | Lzip Compressed File |<!--Load--> ✅ |<!--Save-->  |
| [LZMA](/conversion/java/convert/compression/) | LZMA Compressed File |<!--Load--> ✅ |<!--Save-->  |
| [RAR](/conversion/java/convert/compression/) | RAR Compressed Archive |<!--Load--> ✅ |<!--Save-->  |
| [TAR](/conversion/java/convert/compression/) | Consolidated Unix File Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [XZ](/conversion/java/convert/compression/) | Xz Compressed File |<!--Load--> ✅ |<!--Save-->  |
| [Z](/conversion/java/convert/compression/) | Unix Compressed File |<!--Load--> ✅ |<!--Save-->  |
| [ZIP](/conversion/java/convert/compression/) | ZIP Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |

## Database
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [LOG](/conversion/java/convert/database/) | Log File |<!--Load--> ✅ |<!--Save-->  |
| [NSF](/conversion/java/convert/database/) | Lotus Notes Storage Format |<!--Load--> ✅ |<!--Save-->  |
| [SQL](/conversion/java/convert/database/) | Sql File |<!--Load--> ✅ |<!--Save-->  |

## Diagram
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [VDX](/conversion/java/convert/diagram/) | Visio Drawing XML File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSD](/conversion/java/convert/diagram/) | Visio Drawing File |<!--Load--> ✅ |<!--Save-->  |
| [VSDM](/conversion/java/convert/diagram/) | Visio Macro-Enabled Drawing |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSDX](/conversion/java/convert/diagram/) | Visio Drawing File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSS](/conversion/java/convert/diagram/) | Visio Stencil File |<!--Load--> ✅ |<!--Save-->  |
| [VSSM](/conversion/java/convert/diagram/) | Visio Macro-Enabled Stencil File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSSX](/conversion/java/convert/diagram/) | Visio Stencil File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VST](/conversion/java/convert/diagram/) | Visio Drawing Template |<!--Load--> ✅ |<!--Save-->  |
| [VSTM](/conversion/java/convert/diagram/) | Visio Macro-Enabled Drawing Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSTX](/conversion/java/convert/diagram/) | Visio Drawing Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSX](/conversion/java/convert/diagram/) | Visio Stencil XML File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VTX](/conversion/java/convert/diagram/) | Visio Template XML File |<!--Load--> ✅ |<!--Save--> ✅ |

## eBook
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [AZW3](/conversion/java/convert/ebook/) | Amazon Kindle’s proprietary e-book file format |<!--Load--> ✅ |<!--Save--> ✅ |
| [EPUB](/conversion/java/convert/ebook/) | Open eBook File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MOBI](/conversion/java/convert/ebook/) | Mobipocket eBook |<!--Load--> ✅ |<!--Save--> ✅ |

## Email and Outlook
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [EML](/conversion/java/convert/email/) | E-Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| [EMLX](/conversion/java/convert/email/) | Apple Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| [MBOX](/conversion/java/convert/email/) | Mbox document format |<!--Load--> ✅ |<!--Save-->  |
| [MSG](/conversion/java/convert/email/) | Outlook Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| [OST](/conversion/java/convert/email/) | Outlook Offline Data File |<!--Load--> ✅ |<!--Save-->  |
| [PST](/conversion/java/convert/email/) | Outlook Personal Information Store File |<!--Load--> ✅ |<!--Save-->  |
| [VCF](/conversion/java/convert/email/) | Vcf document format |<!--Load--> ✅ |<!--Save-->  |

## Font
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CFF](/conversion/java/convert/font/) | Compact Font Format |<!--Load--> ✅ |<!--Save-->  |
| [EOT](/conversion/java/convert/font/) | Embedded OpenType Font Format |<!--Load--> ✅ |<!--Save-->  |
| [OTF](/conversion/java/convert/font/) | OpenType font |<!--Load--> ✅ |<!--Save-->  |
| [PFB](/conversion/java/convert/font/) | PostScript Fonts |<!--Load--> ✅ |<!--Save-->  |
| [TTF](/conversion/java/convert/font/) | TrueType Font |<!--Load--> ✅ |<!--Save--> ✅ |
| [WOFF](/conversion/java/convert/font/) | Web Open Font Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [WOFF2](/conversion/java/convert/font/) | Web Open Font Format 2 |<!--Load--> ✅ |<!--Save--> ✅ |

## Image
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [AI](/conversion/java/convert/image/) | Adobe Illustrator Artwork |<!--Load--> ✅ |<!--Save-->  |
| [BMP](/conversion/java/convert/image/) | Bitmap Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| [CDR](/conversion/java/convert/image/) | CorelDraw Vector Graphic Drawing |<!--Load--> ✅ |<!--Save-->  |
| [CMX](/conversion/java/convert/image/) | Corel Metafile Exchange |<!--Load--> ✅ |<!--Save-->  |
| [DCM](/conversion/java/convert/image/) | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [DIB](/conversion/java/convert/image/) | Device Independent Bitmap File |<!--Load--> ✅ |<!--Save-->  |
| [DICOM](/conversion/java/convert/image/) | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [DJVU](/conversion/java/convert/image/) | DjVu Image |<!--Load--> ✅ |<!--Save-->  |
| [DNG](/conversion/java/convert/image/) | Digital Negative Specification |<!--Load--> ✅ |<!--Save-->  |
| [EMF](/conversion/java/convert/image/) | Enhanced Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [EMZ](/conversion/java/convert/image/) | Windows Compressed Enhanced Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [FODG](/conversion/java/convert/image/) | Flat XML ODF Template |<!--Load--> ✅ |<!--Save-->  |
| [GIF](/conversion/java/convert/image/) | Graphical Interchange Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ICO](/conversion/java/convert/image/) | Icon File |<!--Load--> ✅ |<!--Save--> ✅ |
| [J2C](/conversion/java/convert/image/) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [J2K](/conversion/java/convert/image/) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [JP2](/conversion/java/convert/image/) | JPEG 2000 Core Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPC](/conversion/java/convert/image/) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [JPEG](/conversion/java/convert/image/) | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPF](/conversion/java/convert/image/) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [JPG](/conversion/java/convert/image/) | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPM](/conversion/java/convert/image/) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [JPX](/conversion/java/convert/image/) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [ODG](/conversion/java/convert/image/) | OpenDocument Graphic File |<!--Load--> ✅ |<!--Save-->  |
| [OTG](/conversion/java/convert/image/) | OpenDocument Graphic Template |<!--Load--> ✅ |<!--Save-->  |
| [PNG](/conversion/java/convert/image/) | Portable Network Graphic |<!--Load--> ✅ |<!--Save--> ✅ |
| [PSB](/conversion/java/convert/image/) | Adobe Photoshop Big |<!--Load--> ✅ |<!--Save--> ✅ |
| [PSD](/conversion/java/convert/image/) | Adobe Photoshop Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [SVGZ](/conversion/java/convert/image/) | Compressed Scalable Vector Graphics File |<!--Load--> ✅ |<!--Save--> ✅ |
| [TGA](/conversion/java/convert/image/) | Truevision TGA (TARGA) |<!--Load--> ✅ |<!--Save--> ✅ |
| [TIF](/conversion/java/convert/image/) | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [TIFF](/conversion/java/convert/image/) | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [WEBP](/conversion/java/convert/image/) | WebP Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMF](/conversion/java/convert/image/) | Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMZ](/conversion/java/convert/image/) | Compressed Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |

## Note
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [ONE](/conversion/java/convert/note/) | OneNote Document |<!--Load--> ✅ |<!--Save-->  |

## Page Description Language
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CGM](/conversion/java/convert/page-layout/) | Computer Graphics Metafile |<!--Load--> ✅ |<!--Save-->  |
| [EPS](/conversion/java/convert/page-layout/) | Encapsulated PostScript File |<!--Load--> ✅ |<!--Save-->  |
| [OXPS](/conversion/java/convert/page-layout/) | XML Paper Specification File |<!--Load--> ✅ |<!--Save-->  |
| [PCL](/conversion/java/convert/page-layout/) | Printer Command Language Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [PS](/conversion/java/convert/page-layout/) | PostScript File |<!--Load--> ✅ |<!--Save--> ✅ |
| [SVG](/conversion/java/convert/page-layout/) | Scalable Vector Graphics File |<!--Load--> ✅ |<!--Save--> ✅ |
| [TEX](/conversion/java/convert/page-layout/) | LaTeX Source Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [XPS](/conversion/java/convert/page-layout/) | XML Paper Specification File |<!--Load--> ✅ |<!--Save--> ✅ |

## PDF
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [PDF](/conversion/java/convert/pdf/) | Portable Document Format File |<!--Load--> ✅ |<!--Save--> ✅ |

## Presentation
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [FODP](/conversion/java/convert/presentation/) | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [ODP](/conversion/java/convert/presentation/) | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTP](/conversion/java/convert/presentation/) | OpenDocument Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POT](/conversion/java/convert/presentation/) | PowerPoint Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POTM](/conversion/java/convert/presentation/) | PowerPoint Open XML Macro-Enabled Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POTX](/conversion/java/convert/presentation/) | PowerPoint Open XML Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPS](/conversion/java/convert/presentation/) | PowerPoint Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPSM](/conversion/java/convert/presentation/) | PowerPoint Open XML Macro-Enabled Slide |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPSX](/conversion/java/convert/presentation/) | PowerPoint Open XML Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPT](/conversion/java/convert/presentation/) | PowerPoint Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPTM](/conversion/java/convert/presentation/) | PowerPoint Open XML Macro-Enabled Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPTX](/conversion/java/convert/presentation/) | PowerPoint Open XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |

## Project Management
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [MPP](/conversion/java/convert/project-management/) | Microsoft Project File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MPT](/conversion/java/convert/project-management/) | Microsoft Project Template |<!--Load--> ✅ |<!--Save-->  |
| [MPX](/conversion/java/convert/project-management/) | Microsoft Project Exchange File |<!--Load--> ✅ |<!--Save--> ✅ |
| [XER](/conversion/java/convert/project-management/) | Primavera XER format |<!--Load--> ✅ |<!--Save--> ✅ |

## Publisher
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [PUB](/conversion/java/convert/publisher/) | Microsoft Publisher format |<!--Load--> ✅ |<!--Save-->  |

## Spreadsheet
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CSV](/conversion/java/convert/spreadsheet/) | Csv document format |<!--Load--> ✅ |<!--Save--> ✅ |
| [FODS](/conversion/java/convert/spreadsheet/) | OpenDocument Flat XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [NUMBERS](/conversion/java/convert/spreadsheet/) | Apple iWork Numbers |<!--Load--> ✅ |<!--Save-->  |
| [ODS](/conversion/java/convert/spreadsheet/) | OpenDocument Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTS](/conversion/java/convert/spreadsheet/) | OpenDocument Spreadsheet Template |<!--Load--> ✅ |<!--Save-->  |
| [SXC](/conversion/java/convert/spreadsheet/) | StarOffice Calc Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [TSV](/conversion/java/convert/spreadsheet/) | Tab Separated Values File |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLAM](/conversion/java/convert/spreadsheet/) | Microsoft Excel Add-in |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLS](/conversion/java/convert/spreadsheet/) | Excel Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSB](/conversion/java/convert/spreadsheet/) | Excel Binary Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSM](/conversion/java/convert/spreadsheet/) | Excel Open XML Macro-Enabled Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSX](/conversion/java/convert/spreadsheet/) | Microsoft Excel Open XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLT](/conversion/java/convert/spreadsheet/) | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLTM](/conversion/java/convert/spreadsheet/) | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLTX](/conversion/java/convert/spreadsheet/) | Excel Open XML Spreadsheet Template |<!--Load--> ✅ |<!--Save--> ✅ |

## Web
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CHM](/conversion/java/convert/web/) | CHM File |<!--Load--> ✅ |<!--Save-->  |
| [HTM](/conversion/java/convert/web/) | Hypertext Markup Language File |<!--Load--> ✅ |<!--Save--> ✅ |
| [HTML](/conversion/java/convert/web/) | Hypertext Markup Language File |<!--Load--> ✅ |<!--Save--> ✅ |
| [JSON](/conversion/java/convert/web/) | Json File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MHT](/conversion/java/convert/web/) | MHTML Web Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [MHTML](/conversion/java/convert/web/) | MIME HTML File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VDW](/conversion/java/convert/web/) | Visio Web Drawing |<!--Load--> ✅ |<!--Save-->  |
| [XML](/conversion/java/convert/web/) | XML File |<!--Load--> ✅ |<!--Save--> ✅ |

## Word Processing
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [DOC](/conversion/java/convert/wordprocessing/) | Microsoft Word Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOCM](/conversion/java/convert/wordprocessing/) | Word Open XML Macro-Enabled Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOCX](/conversion/java/convert/wordprocessing/) | Microsoft Word Open XML Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOT](/conversion/java/convert/wordprocessing/) | Word Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOTM](/conversion/java/convert/wordprocessing/) | Word Open XML Macro-Enabled Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOTX](/conversion/java/convert/wordprocessing/) | Word Open XML Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [MD](/conversion/java/convert/wordprocessing/) | Markdown Documentation File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ODT](/conversion/java/convert/wordprocessing/) | OpenDocument Text Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTT](/conversion/java/convert/wordprocessing/) | OpenDocument Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [RTF](/conversion/java/convert/wordprocessing/) | Rich Text Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [TXT](/conversion/java/convert/wordprocessing/) | Plain Text File |<!--Load--> ✅ |<!--Save--> ✅ |


---

## 

Path: /conversion/java/_includes/supported-conversions/image/

| From | To |
| --- | --- |
| AI | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| BMP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CDR | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CMX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DIB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DICOM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DJVU | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ICO | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2C | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2K | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JP2 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPEG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SVGZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TGA | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIFF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WEBP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/note/

| From | To |
| --- | --- |
| ONE | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/page-description-language/

| From | To |
| --- | --- |
| CGM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OXPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PCL | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SVG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TEX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/pdf/

| From | To |
| --- | --- |
| PDF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/presentation/

| From | To |
| --- | --- |
| FODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/project-management/

| From | To |
| --- | --- |
| MPP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MPT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XER | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/publisher/

| From | To |
| --- | --- |
| PUB | PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/spreadsheet/

| From | To |
| --- | --- |
| CSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| NUMBERS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SXC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLAM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/video/

| From | To |
| --- | --- |
| AVI | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| FLV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| MKV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| MOV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| MP4 | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| WEBM | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| WMV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/web/

| From | To |
| --- | --- |
| CHM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| HTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| HTML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JSON | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MHT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MHTML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VDW | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/java/_includes/supported-conversions/word-processing/

| From | To |
| --- | --- |
| DOC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| RTF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TXT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/net/_includes/supported-conversions/3d/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| 3DS | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| 3MF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| AMF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| ASE | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| DAE | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| DRC | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| FBX | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| GLB | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| GLTF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| JT | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| MA | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| MB | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| OBJ | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| PLY | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| RVM | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| U3D | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| USD | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| USDZ | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| VRML | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| X | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [3MF](https://docs.fileformat.com/3d/3mf/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/), [USD](https://docs.fileformat.com/3d/usd/), [USDZ](https://docs.fileformat.com/3d/usdz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/audio/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| AAC | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| AC3 | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| AIFF | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| FLAC | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| M4A | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| MP3 | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| OGG | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| WAV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/) <br/>  |
| WMA | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/cad/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| CF2 | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DGN | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWFX | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWG | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWT | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DXF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| IFC | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat
| IGS | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PLT | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLB](https://docs.fileformat.com/3d/glb/), [OBJ](https://docs.fileformat.com/3d/obj/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| STL | CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/), [IFC](https://docs.fileformat.com/cad/ifc/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/compression/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| 7Z | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| BZ2 | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| CAB | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| CPIO | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| GZ | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| GZIP | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| ISO | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| LHA | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| LZ | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| LZ4 | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| LZMA | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| RAR | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| TAR | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| UUE | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| XZ | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| Z | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| ZIP | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [CPIO](https://docs.fileformat.com/compression/cpio/), [ISO](https://docs.fileformat.com/compression/iso/), [TAR](https://docs.fileformat.com/compression/tar/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ZST | Compression: [BZ2](https://docs.fileformat.com/compression/bz2/), [GZ](https://docs.fileformat.com/compression/gz/), [GZIP](https://docs.fileformat.com/compression/gzip/), [LZ](https://docs.fileformat.com/compression/lz/), [LZ4](https://docs.fileformat.com/compression/lz4/), [LZMA](https://docs.fileformat.com/compression/lzma/), [UUE](https://docs.fileformat.com/compression/uue/), [XZ](https://docs.fileformat.com/compression/xz/), [Z](https://docs.fileformat.com/compression/z/), [ZST](https://docs.fileformat.com/compression/zst/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/database/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| LOG | Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| NSF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SQL | Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/diagram/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| VDW | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VDX | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSD | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSDM | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSDX | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSS | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSSM | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.file
| VSSX | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VST | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSTM | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSTX | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSX | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VTX | Diagram: [VDX](https://docs.fileformat.com/diagram/vdx/), [VSD](https://docs.fileformat.com/diagram/vsd/), [VSDM](https://docs.fileformat.com/diagram/vsdm/), [VSDX](https://docs.fileformat.com/diagram/vsdx/), [VSSM](https://docs.fileformat.com/diagram/vssm/), [VSSX](https://docs.fileformat.com/diagram/vssx/), [VSTM](https://docs.fileformat.com/diagram/vstm/), [VSTX](https://docs.fileformat.com/diagram/vstx/), [VSX](https://docs.fileformat.com/diagram/vsx/), [VTX](https://docs.fileformat.com/diagram/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/ebook/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| AZW3 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EPUB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MOBI | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/email-and-outlook/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| EML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMLX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ICS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MBOX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MSG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OLM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OST | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PST | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VCF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/finance/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| IXBRL | Finance: [IXBRL](https://docs.fileformat.com/finance/ixbrl/), [XBRL](https://docs.fileformat.com/finance/xbrl/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/>  |
| XBRL | Finance: [IXBRL](https://docs.fileformat.com/finance/ixbrl/), [XBRL](https://docs.fileformat.com/finance/xbrl/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/font/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| CFF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), [WOFF2](https://docs.fileformat.com/font/woff2/)<br/>  |
| EOT | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), [WOFF2](https://docs.fileformat.com/font/woff2/)<br/>  |
| OTF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), [WOFF2](https://docs.fileformat.com/font/woff2/)<br/>  |
| PFB | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), [WOFF2](https://docs.fileformat.com/font/woff2/)<br/>  |
| TTF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), [WOFF2](https://docs.fileformat.com/font/woff2/)<br/>  |
| WOFF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), [WOFF2](https://docs.fileformat.com/font/woff2/)<br/>  |
| WOFF2 | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), [WOFF2](https://docs.fileformat.com/font/woff2/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/formats-brief/

---
GeekdocHidden: true
---
## 3D
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [3DS](/conversion/net/convert/3d/) | 3D Studio |<!--Load--> ✅ |<!--Save--> ✅ |
| [3MF](/conversion/net/convert/3d/) | Microsoft 3D Manufacturing Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [AMF](/conversion/net/convert/3d/) | Additive manufacturing file format |<!--Load--> ✅ |<!--Save--> ✅ |
| [ASE](/conversion/net/convert/3d/) | 3D Studio Max’s ASCII Scene Exporter format |<!--Load--> ✅ |<!--Save-->  |
| [DAE](/conversion/net/convert/3d/) | Collada |<!--Load--> ✅ |<!--Save--> ✅ |
| [DRC](/conversion/net/convert/3d/) | Google Draco |<!--Load--> ✅ |<!--Save--> ✅ |
| [FBX](/conversion/net/convert/3d/) | FilmBox format |<!--Load--> ✅ |<!--Save--> ✅ |
| [GLB](/conversion/net/convert/3d/) | GLB file |<!--Load--> ✅ |<!--Save--> ✅ |
| [GLTF](/conversion/net/convert/3d/) | Khronos Group’s glTF |<!--Load--> ✅ |<!--Save--> ✅ |
| [JT](/conversion/net/convert/3d/) | Siemens JT File |<!--Load--> ✅ |<!--Save-->  |
| [MA](/conversion/net/convert/3d/) | Autodesk Maya ASCII |<!--Load--> ✅ |<!--Save-->  |
| [MB](/conversion/net/convert/3d/) | Autodesk Maya Binary |<!--Load--> ✅ |<!--Save-->  |
| [OBJ](/conversion/net/convert/3d/) | Wavefront Obj |<!--Load--> ✅ |<!--Save--> ✅ |
| [PLY](/conversion/net/convert/3d/) | Polygon File Format or Stanford Triangle Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [RVM](/conversion/net/convert/3d/) | AVEVA Plant Design Management System Model |<!--Load--> ✅ |<!--Save--> ✅ |
| [U3D](/conversion/net/convert/3d/) | Universal3D |<!--Load--> ✅ |<!--Save--> ✅ |
| [USD](/conversion/net/convert/3d/) | Universal Scene Description |<!--Load--> ✅ |<!--Save--> ✅ |
| [USDZ](/conversion/net/convert/3d/) | Universal Scene Description Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [VRML](/conversion/net/convert/3d/) | The Virtual Reality Modeling Language |<!--Load--> ✅ |<!--Save-->  |
| [X](/conversion/net/convert/3d/) | DirectX’s X file |<!--Load--> ✅ |<!--Save-->  |

## Audio
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [AAC](/conversion/net/convert/audio/) | Advanced Audio Coding File |<!--Load--> ✅ |<!--Save--> ✅ |
| [AC3](/conversion/net/convert/audio/) | Audio Codec 3 File |<!--Load--> ✅ |<!--Save--> ✅ |
| [AIFF](/conversion/net/convert/audio/) | Audio Interchange File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [FLAC](/conversion/net/convert/audio/) | Free Lossless Audio Codec File |<!--Load--> ✅ |<!--Save--> ✅ |
| [M4A](/conversion/net/convert/audio/) | MPEG-4 Audio File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MP3](/conversion/net/convert/audio/) | MP3 Audio File |<!--Load--> ✅ |<!--Save--> ✅ |
| [OGG](/conversion/net/convert/audio/) | Ogg Vorbis Audio File |<!--Load--> ✅ |<!--Save--> ✅ |
| [WAV](/conversion/net/convert/audio/) | WAVE Audio File |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMA](/conversion/net/convert/audio/) | Windows Media Audio File |<!--Load--> ✅ |<!--Save--> ✅ |

## CAD
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CF2](/conversion/net/convert/cad/) | Common File Format File |<!--Load--> ✅ |<!--Save-->  |
| [DGN](/conversion/net/convert/cad/) | MicroStation Design File |<!--Load--> ✅ |<!--Save-->  |
| [DWF](/conversion/net/convert/cad/) | Design Web Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [DWFX](/conversion/net/convert/cad/) | Design Web Format File |<!--Load--> ✅ |<!--Save-->  |
| [DWG](/conversion/net/convert/cad/) | AutoCAD Drawing Database File |<!--Load--> ✅ |<!--Save-->  |
| [DWT](/conversion/net/convert/cad/) | AutoCAD Drawing Template |<!--Load--> ✅ |<!--Save-->  |
| [DXF](/conversion/net/convert/cad/) | Drawing Exchange Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [IFC](/conversion/net/convert/cad/) | Industry Foundation Classes File |<!--Load--> ✅ |<!--Save--> ✅ |
| [IGS](/conversion/net/convert/cad/) | Initial Graphics Exchange Specification (IGES) |<!--Load--> ✅ |<!--Save-->  |
| [PLT](/conversion/net/convert/cad/) | PLT (HPGL) |<!--Load--> ✅ |<!--Save-->  |
| [STL](/conversion/net/convert/cad/) | Stereolithography File |<!--Load--> ✅ |<!--Save-->  |

## Compression
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [7Z](/conversion/net/convert/compression/) | 7-Zip Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [BZ2](/conversion/net/convert/compression/) | Bzip2 Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [CAB](/conversion/net/convert/compression/) | Windows Cabinet File |<!--Load--> ✅ |<!--Save-->  |
| [CPIO](/conversion/net/convert/compression/) | CPIO Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [GZ](/conversion/net/convert/compression/) | Gnu Zipped Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [GZIP](/conversion/net/convert/compression/) | Gzip Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ISO](/conversion/net/convert/compression/) | ISO File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [LHA](/conversion/net/convert/compression/) | LHA/LZH archive |<!--Load--> ✅ |<!--Save-->  |
| [LZ](/conversion/net/convert/compression/) | Lzip Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [LZ4](/conversion/net/convert/compression/) | LZ4 archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [LZMA](/conversion/net/convert/compression/) | LZMA Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [RAR](/conversion/net/convert/compression/) | RAR Compressed Archive |<!--Load--> ✅ |<!--Save-->  |
| [TAR](/conversion/net/convert/compression/) | Consolidated Unix File Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [UUE](/conversion/net/convert/compression/) | Uuencoded archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [XZ](/conversion/net/convert/compression/) | Xz Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [Z](/conversion/net/convert/compression/) | Unix Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ZIP](/conversion/net/convert/compression/) | ZIP Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ZST](/conversion/net/convert/compression/) | Zstandard (Zstd) Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |

## Database
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [LOG](/conversion/net/convert/database/) | Log File |<!--Load--> ✅ |<!--Save-->  |
| [NSF](/conversion/net/convert/database/) | Lotus Notes Storage Format |<!--Load--> ✅ |<!--Save-->  |
| [SQL](/conversion/net/convert/database/) | Sql File |<!--Load--> ✅ |<!--Save-->  |

## Diagram
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [VDW](/conversion/net/convert/diagram/) | Visio Web Drawing |<!--Load--> ✅ |<!--Save-->  |
| [VDX](/conversion/net/convert/diagram/) | Visio Drawing XML File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSD](/conversion/net/convert/diagram/) | Visio Drawing File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSDM](/conversion/net/convert/diagram/) | Visio Macro-Enabled Drawing |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSDX](/conversion/net/convert/diagram/) | Visio Drawing File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSS](/conversion/net/convert/diagram/) | Visio Stencil File |<!--Load--> ✅ |<!--Save-->  |
| [VSSM](/conversion/net/convert/diagram/) | Visio Macro-Enabled Stencil File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSSX](/conversion/net/convert/diagram/) | Visio Stencil File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VST](/conversion/net/convert/diagram/) | Visio Drawing Template |<!--Load--> ✅ |<!--Save-->  |
| [VSTM](/conversion/net/convert/diagram/) | Visio Macro-Enabled Drawing Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSTX](/conversion/net/convert/diagram/) | Visio Drawing Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [VSX](/conversion/net/convert/diagram/) | Visio Stencil XML File |<!--Load--> ✅ |<!--Save--> ✅ |
| [VTX](/conversion/net/convert/diagram/) | Visio Template XML File |<!--Load--> ✅ |<!--Save--> ✅ |

## eBook
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [AZW3](/conversion/net/convert/ebook/) | Amazon Kindle’s proprietary e-book file format |<!--Load--> ✅ |<!--Save--> ✅ |
| [EPUB](/conversion/net/convert/ebook/) | Open eBook File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MOBI](/conversion/net/convert/ebook/) | Mobipocket eBook |<!--Load--> ✅ |<!--Save--> ✅ |

## Email and Outlook
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [EML](/conversion/net/convert/email/) | E-Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| [EMLX](/conversion/net/convert/email/) | Apple Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| [ICS](/conversion/net/convert/email/) | iCalendar File |<!--Load--> ✅ |<!--Save-->  |
| [MBOX](/conversion/net/convert/email/) | Mbox document format |<!--Load--> ✅ |<!--Save-->  |
| [MSG](/conversion/net/convert/email/) | Outlook Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| [OLM](/conversion/net/convert/email/) | Microsoft Outlook file for Mac Operating System. |<!--Load--> ✅ |<!--Save-->  |
| [OST](/conversion/net/convert/email/) | Outlook Offline Data File |<!--Load--> ✅ |<!--Save-->  |
| [PST](/conversion/net/convert/email/) | Outlook Personal Information Store File |<!--Load--> ✅ |<!--Save-->  |
| [VCF](/conversion/net/convert/email/) | Vcf document format |<!--Load--> ✅ |<!--Save-->  |

## Finance
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [IXBRL](/conversion/net/convert/finance/) | Inline XBRL. |<!--Load--> ✅ |<!--Save--> ✅ |
| [XBRL](/conversion/net/convert/finance/) | Extensible Business Reporting Language. |<!--Load--> ✅ |<!--Save--> ✅ |

## Font
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CFF](/conversion/net/convert/font/) | Compact Font Format |<!--Load--> ✅ |<!--Save-->  |
| [EOT](/conversion/net/convert/font/) | Embedded OpenType Font Format |<!--Load--> ✅ |<!--Save-->  |
| [OTF](/conversion/net/convert/font/) | OpenType font |<!--Load--> ✅ |<!--Save-->  |
| [PFB](/conversion/net/convert/font/) | PostScript Fonts |<!--Load--> ✅ |<!--Save-->  |
| [TTF](/conversion/net/convert/font/) | TrueType Font |<!--Load--> ✅ |<!--Save--> ✅ |
| [WOFF](/conversion/net/convert/font/) | Web Open Font Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [WOFF2](/conversion/net/convert/font/) | Web Open Font Format 2 |<!--Load--> ✅ |<!--Save--> ✅ |

## GIS
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [GEOJSON](/conversion/net/convert/gis/) | JSON based Geographic File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [GML](/conversion/net/convert/gis/) | Geography Markup Language File Format |<!--Load--> ✅ |<!--Save-->  |
| [GPX](/conversion/net/convert/gis/) | GPS Exchange File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [KML](/conversion/net/convert/gis/) | Keyhole Markup Language |<!--Load--> ✅ |<!--Save--> ✅ |
| [OSM](/conversion/net/convert/gis/) | OpenStreetMap File Format |<!--Load--> ✅ |<!--Save-->  |
| [TOPOJSON](/conversion/net/convert/gis/) | JSON based Topology File Format |<!--Load--> ✅ |<!--Save--> ✅ |

## Image
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [AI](/conversion/net/convert/image/) | Adobe Illustrator Artwork |<!--Load--> ✅ |<!--Save-->  |
| [AVIF](/conversion/net/convert/image/) | Avif File Format |<!--Load--> ✅ |<!--Save-->  |
| [BMP](/conversion/net/convert/image/) | Bitmap Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| [CDR](/conversion/net/convert/image/) | CorelDraw Vector Graphic Drawing |<!--Load--> ✅ |<!--Save-->  |
| [CMX](/conversion/net/convert/image/) | Corel Metafile Exchange |<!--Load--> ✅ |<!--Save-->  |
| [DCM](/conversion/net/convert/image/) | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [DIB](/conversion/net/convert/image/) | Device Independent Bitmap File |<!--Load--> ✅ |<!--Save-->  |
| [DICOM](/conversion/net/convert/image/) | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [DJVU](/conversion/net/convert/image/) | DjVu Image |<!--Load--> ✅ |<!--Save-->  |
| [DNG](/conversion/net/convert/image/) | Digital Negative Specification |<!--Load--> ✅ |<!--Save-->  |
| [EMF](/conversion/net/convert/image/) | Enhanced Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [EMZ](/conversion/net/convert/image/) | Windows Compressed Enhanced Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [FODG](/conversion/net/convert/image/) | Flat XML ODF Template |<!--Load--> ✅ |<!--Save-->  |
| [GIF](/conversion/net/convert/image/) | Graphical Interchange Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [HEIC](/conversion/net/convert/image/) | HEIC File Format |<!--Load--> ✅ |<!--Save-->  |
| [ICO](/conversion/net/convert/image/) | Icon File |<!--Load--> ✅ |<!--Save--> ✅ |
| [J2C](/conversion/net/convert/image/) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [J2K](/conversion/net/convert/image/) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save--> ✅ |
| [JFIF](/conversion/net/convert/image/) | JPEG File Interchange Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [JP2](/conversion/net/convert/image/) | JPEG 2000 Core Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPC](/conversion/net/convert/image/) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [JPEG](/conversion/net/convert/image/) | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPF](/conversion/net/convert/image/) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [JPG](/conversion/net/convert/image/) | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPM](/conversion/net/convert/image/) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [JPX](/conversion/net/convert/image/) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [ODG](/conversion/net/convert/image/) | OpenDocument Graphic File |<!--Load--> ✅ |<!--Save-->  |
| [OTG](/conversion/net/convert/image/) | OpenDocument Graphic Template |<!--Load--> ✅ |<!--Save-->  |
| [PNG](/conversion/net/convert/image/) | Portable Network Graphic |<!--Load--> ✅ |<!--Save--> ✅ |
| [PSB](/conversion/net/convert/image/) | Adobe Photoshop Big |<!--Load--> ✅ |<!--Save--> ✅ |
| [PSD](/conversion/net/convert/image/) | Adobe Photoshop Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [TGA](/conversion/net/convert/image/) | Truevision TGA (TARGA) |<!--Load--> ✅ |<!--Save--> ✅ |
| [TIF](/conversion/net/convert/image/) | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [TIFF](/conversion/net/convert/image/) | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [WEBP](/conversion/net/convert/image/) | WebP Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMF](/conversion/net/convert/image/) | Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMZ](/conversion/net/convert/image/) | Compressed Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |

## Note
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [ONE](/conversion/net/convert/note/) | OneNote Document |<!--Load--> ✅ |<!--Save-->  |

## Page Description Language
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CGM](/conversion/net/convert/page-layout/) | Computer Graphics Metafile |<!--Load--> ✅ |<!--Save-->  |
| [EPS](/conversion/net/convert/page-layout/) | Encapsulated PostScript File |<!--Load--> ✅ |<!--Save--> ✅ |
| [OXPS](/conversion/net/convert/page-layout/) | XML Paper Specification File |<!--Load--> ✅ |<!--Save-->  |
| [PCL](/conversion/net/convert/page-layout/) | Printer Command Language Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [PS](/conversion/net/convert/page-layout/) | PostScript File |<!--Load--> ✅ |<!--Save--> ✅ |
| [SVG](/conversion/net/convert/page-layout/) | Scalable Vector Graphics File |<!--Load--> ✅ |<!--Save--> ✅ |
| [SVGZ](/conversion/net/convert/page-layout/) | Compressed Scalable Vector Graphics File |<!--Load--> ✅ |<!--Save--> ✅ |
| [TEX](/conversion/net/convert/page-layout/) | LaTeX Source Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [XPS](/conversion/net/convert/page-layout/) | XML Paper Specification File |<!--Load--> ✅ |<!--Save--> ✅ |

## PDF
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [PDF](/conversion/net/convert/pdf/) | Portable Document Format File |<!--Load--> ✅ |<!--Save--> ✅ |

## Presentation
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [FODP](/conversion/net/convert/presentation/) | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [ODP](/conversion/net/convert/presentation/) | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTP](/conversion/net/convert/presentation/) | OpenDocument Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POT](/conversion/net/convert/presentation/) | PowerPoint Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POTM](/conversion/net/convert/presentation/) | PowerPoint Open XML Macro-Enabled Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POTX](/conversion/net/convert/presentation/) | PowerPoint Open XML Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPS](/conversion/net/convert/presentation/) | PowerPoint Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPSM](/conversion/net/convert/presentation/) | PowerPoint Open XML Macro-Enabled Slide |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPSX](/conversion/net/convert/presentation/) | PowerPoint Open XML Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPT](/conversion/net/convert/presentation/) | PowerPoint Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPTM](/conversion/net/convert/presentation/) | PowerPoint Open XML Macro-Enabled Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPTX](/conversion/net/convert/presentation/) | PowerPoint Open XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |

## Project Management
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [MPP](/conversion/net/convert/project-management/) | Microsoft Project File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MPT](/conversion/net/convert/project-management/) | Microsoft Project Template |<!--Load--> ✅ |<!--Save-->  |
| [MPX](/conversion/net/convert/project-management/) | Microsoft Project Exchange File |<!--Load--> ✅ |<!--Save--> ✅ |
| [XER](/conversion/net/convert/project-management/) | Primavera XER format |<!--Load--> ✅ |<!--Save--> ✅ |

## Publisher
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [PUB](/conversion/net/convert/publisher/) | Microsoft Publisher format |<!--Load--> ✅ |<!--Save-->  |

## Spreadsheet
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CSV](/conversion/net/convert/spreadsheet/) | Csv document format |<!--Load--> ✅ |<!--Save--> ✅ |
| [DIF](/conversion/net/convert/spreadsheet/) | Patch File |<!--Load-->  |<!--Save--> ✅ |
| [FODS](/conversion/net/convert/spreadsheet/) | OpenDocument Flat XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [FOPCS](/conversion/net/convert/spreadsheet/) | Flat OPC Excel Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [NUMBERS](/conversion/net/convert/spreadsheet/) | Apple iWork Numbers |<!--Load--> ✅ |<!--Save-->  |
| [ODS](/conversion/net/convert/spreadsheet/) | OpenDocument Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTS](/conversion/net/convert/spreadsheet/) | OpenDocument Spreadsheet Template |<!--Load--> ✅ |<!--Save-->  |
| [SXC](/conversion/net/convert/spreadsheet/) | StarOffice Calc Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [TSV](/conversion/net/convert/spreadsheet/) | Tab Separated Values File |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLAM](/conversion/net/convert/spreadsheet/) | Microsoft Excel Add-in |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLS](/conversion/net/convert/spreadsheet/) | Excel Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSB](/conversion/net/convert/spreadsheet/) | Excel Binary Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSM](/conversion/net/convert/spreadsheet/) | Excel Open XML Macro-Enabled Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSX](/conversion/net/convert/spreadsheet/) | Microsoft Excel Open XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLT](/conversion/net/convert/spreadsheet/) | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLTM](/conversion/net/convert/spreadsheet/) | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLTX](/conversion/net/convert/spreadsheet/) | Excel Open XML Spreadsheet Template |<!--Load--> ✅ |<!--Save--> ✅ |

## Video
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [AVI](/conversion/net/convert/video/) | Audio Video Interleave File |<!--Load--> ✅ |<!--Save--> ✅ |
| [FLV](/conversion/net/convert/video/) | Flash Video File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MKV](/conversion/net/convert/video/) | Matroska Video File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MOV](/conversion/net/convert/video/) | Apple QuickTime Movie |<!--Load--> ✅ |<!--Save--> ✅ |
| [MP4](/conversion/net/convert/video/) | MPEG-4 Video File |<!--Load--> ✅ |<!--Save--> ✅ |
| [WEBM](/conversion/net/convert/video/) | WebM Video File |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMV](/conversion/net/convert/video/) | Windows Media Video |<!--Load--> ✅ |<!--Save--> ✅ |

## Web
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CHM](/conversion/net/convert/web/) | CHM File |<!--Load--> ✅ |<!--Save-->  |
| [HTM](/conversion/net/convert/web/) | Hypertext Markup Language File |<!--Load--> ✅ |<!--Save--> ✅ |
| [HTML](/conversion/net/convert/web/) | Hypertext Markup Language File |<!--Load--> ✅ |<!--Save--> ✅ |
| [JSON](/conversion/net/convert/web/) | Json File |<!--Load--> ✅ |<!--Save--> ✅ |
| [MHT](/conversion/net/convert/web/) | MHTML Web Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| [MHTML](/conversion/net/convert/web/) | MIME HTML File |<!--Load--> ✅ |<!--Save--> ✅ |
| [XML](/conversion/net/convert/web/) | XML File |<!--Load--> ✅ |<!--Save--> ✅ |

## Word Processing
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [DOC](/conversion/net/convert/wordprocessing/) | Microsoft Word Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOCM](/conversion/net/convert/wordprocessing/) | Word Open XML Macro-Enabled Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOCX](/conversion/net/convert/wordprocessing/) | Microsoft Word Open XML Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOT](/conversion/net/convert/wordprocessing/) | Word Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOTM](/conversion/net/convert/wordprocessing/) | Word Open XML Macro-Enabled Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOTX](/conversion/net/convert/wordprocessing/) | Word Open XML Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [FOPCT](/conversion/net/convert/wordprocessing/) | Flat OPC Word Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [MD](/conversion/net/convert/wordprocessing/) | Markdown Documentation File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ODT](/conversion/net/convert/wordprocessing/) | OpenDocument Text Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTT](/conversion/net/convert/wordprocessing/) | OpenDocument Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [RTF](/conversion/net/convert/wordprocessing/) | Rich Text Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [TXT](/conversion/net/convert/wordprocessing/) | Plain Text File |<!--Load--> ✅ |<!--Save--> ✅ |
---

## 

Path: /conversion/net/_includes/supported-conversions/gis/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| GEOJSON | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), [TOPOJSON](https://docs.fileformat.com/gis/topojson/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), [TOPOJSON](https://docs.fileformat.com/gis/topojson/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), [TOPOJSON](https://docs.fileformat.com/gis/topojson/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| KML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), [TOPOJSON](https://docs.fileformat.com/gis/topojson/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), [TOPOJSON](https://docs.fileformat.com/gis/topojson/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TOPOJSON | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), [TOPOJSON](https://docs.fileformat.com/gis/topojson/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/image/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| AI | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| AVIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| BMP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CDR | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CMX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DIB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DICOM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DJVU | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| HEIC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ICO | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2C | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2K | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JFIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JP2 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPEG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/diff/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TGA | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIFF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WEBP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/note/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| ONE | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/page-description-language/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| CGM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| EPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| OXPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| PCL | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| PS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| SVG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| SVGZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| TEX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| XPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/pdf/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| PDF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/presentation/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| FODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| ODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| OTP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| POT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| POTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| POTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| PPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| PPSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/page-layout/), [PCL](https://docs.fileformat.com/page-description-language/page-layout/), [PS](https://docs.fileformat.com/page-description-language/page-layout/), [SVG](https://docs.fileformat.com/page-description-language/page-layout/), [SVGZ](https://docs.fileformat.com/page-description-language/page-layout/), [TEX](https://docs.fileformat.com/page-description-language/page-layout/), [XPS](https://docs.fileformat.com/page-description-language/page-layout/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/presentation/), [OTP](https://docs.fileformat.com/presentation/presentation/), [POT](https://docs.fileformat.com/presentation/presentation/), [POTM](https://docs.fileformat.com/presentation/presentation/), [POTX](https://docs.fileformat.com/presentation/presentation/), [PPS](https://docs.fileformat.com/presentation/presentation/), [PPSM](https://docs.fileformat.com/presentation/presentation/), [PPSX](https://docs.fileformat.com/presentation/presentation/), [PPT](https://docs.fileformat.com/presentation/presentation/), [PPTM](https://docs.fileformat.com/presentation/presentation/), [PPTX](https://docs.fileformat.com/presentation/presentation/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [DIF](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [FOPCS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [ODS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [SXC](https://docs.fileformat.com/spreadsheet/spreadsheet/), [TSV](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLAM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLS](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSB](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLSX](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLT](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTM](https://docs.fileformat.com/spreadsheet/spreadsheet/), [XLTX](https://docs.fileformat.com/spreadsheet/spreadsheet/)<br/> Video: [AVI](https://docs.fileformat.com/video/video/), [FLV](https://docs.fileformat.com/video/video/), [MKV](https://docs.fileformat.com/video/video/), [MOV](https://docs.fileformat.com/video/video/), [MP4](https://docs.fileformat.com/video/video/), [WEBM](https://docs.fileformat.com/video/video/), [WMV](https://docs.fileformat.com/video/video/)<br/> Web: [HTM](https://docs.fileformat.com/web/web/), [HTML](https://docs.fileformat.com/web/web/), [MHT](https://docs.fileformat.com/web/web/), [MHTML](https://docs.fileformat.com/web/web/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOCX](https://docs.fileformat.com/word-processing/wordprocessing/), [DOT](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTM](https://docs.fileformat.com/word-processing/wordprocessing/), [DOTX](https://docs.fileformat.com/word-processing/wordprocessing/), [FOPCT](https://docs.fileformat.com/word-processing/wordprocessing/), [MD](https://docs.fileformat.com/word-processing/wordprocessing/), [ODT](https://docs.fileformat.com/word-processing/wordprocessing/), [OTT](https://docs.fileformat.com/word-processing/wordprocessing/), [RTF](https://docs.fileformat.com/word-processing/wordprocessing/), [TXT](https://docs.fileformat.com/word-processing/wordprocessing/)<br/>  |
| PPSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/project-management/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| MPP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MPT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XER | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/publisher/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| PUB | PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/spreadsheet/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| CSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| FODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| FOPCS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| NUMBERS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| ODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| OTS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| SXC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| TSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/pdf/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/wordprocessing/doc/), [DOCM](https://docs.fileformat.com/wordprocessing/docm/), [DOCX](https://docs.fileformat.com/wordprocessing/docx/), [DOT](https://docs.fileformat.com/wordprocessing/dot/), [DOTM](https://docs.fileformat.com/wordprocessing/dotm/), [DOTX](https://docs.fileformat.com/wordprocessing/dotx/), [FOPCT](https://docs.fileformat.com/wordprocessing/fopct/), [MD](https://docs.fileformat.com/wordprocessing/md/), [ODT](https://docs.fileformat.com/wordprocessing/odt/), [OTT](https://docs.fileformat.com/wordprocessing/ott/), [RTF](https://docs.fileformat.com/wordprocessing/rtf/), [TXT](https://docs.fileformat.com/wordprocessing/txt/)<br/>  |
| XLAM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/video/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| AVI | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| FLV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| MKV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| MOV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| MP4 | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| WEBM | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |
| WMV | Audio: [AAC](https://docs.fileformat.com/audio/aac/), [AC3](https://docs.fileformat.com/audio/ac3/), [AIFF](https://docs.fileformat.com/audio/aiff/), [FLAC](https://docs.fileformat.com/audio/flac/), [M4A](https://docs.fileformat.com/audio/m4a/), [MP3](https://docs.fileformat.com/audio/mp3/), [OGG](https://docs.fileformat.com/audio/ogg/), [WAV](https://docs.fileformat.com/audio/wav/), [WMA](https://docs.fileformat.com/audio/wma/)<br/> Video: [AVI](https://docs.fileformat.com/video/avi/), [FLV](https://docs.fileformat.com/video/flv/), [MKV](https://docs.fileformat.com/video/mkv/), [MOV](https://docs.fileformat.com/video/mov/), [MP4](https://docs.fileformat.com/video/mp4/), [WEBM](https://docs.fileformat.com/video/webm/), [WMV](https://docs.fileformat.com/video/wmv/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/web/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| CHM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| HTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| HTML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JSON | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MHT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MHTML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/net/_includes/supported-conversions/word-processing/

---
GeekdocHidden: true
---
| From | To |
| --- | --- |
| DOC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/diff/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FOPCT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [SVGZ](https://docs.fileformat.com/page-description-language/svgz/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| RTF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TXT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), J2K, JFIF, [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-layout/eps/), [PCL](https://docs.fileformat.com/page-layout/pcl/), [PS](https://docs.fileformat.com/page-layout/ps/), [SVG](https://docs.fileformat.com/page-layout/svg/), [SVGZ](https://docs.fileformat.com/page-layout/svgz/), [TEX](https://docs.fileformat.com/page-layout/tex/), [XPS](https://docs.fileformat.com/page-layout/xps/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [FOPCS](https://docs.fileformat.com/spreadsheet/fopcs/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [FOPCT](https://docs.fileformat.com/word-processing/fopct/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |

---

## 

Path: /conversion/nodejs-java/_includes/supported-conversions/formats-brief/

## Image
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [AI](#) | Adobe Illustrator Artwork |<!--Load--> ✅ |<!--Save-->  |
| [BMP](#) | Bitmap Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| [CDR](#) | CorelDraw Vector Graphic Drawing |<!--Load--> ✅ |<!--Save-->  |
| [CMX](#) | Corel Metafile Exchange |<!--Load--> ✅ |<!--Save-->  |
| [DCM](#) | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [DIB](#) | Device Independent Bitmap File |<!--Load--> ✅ |<!--Save-->  |
| [DICOM](#) | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [DJVU](#) | DjVu Image |<!--Load--> ✅ |<!--Save-->  |
| [DNG](#) | Digital Negative Specification |<!--Load--> ✅ |<!--Save-->  |
| [EMF](#) | Enhanced Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [EMZ](#) | Windows Compressed Enhanced Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [FODG](#) | Flat XML ODF Template |<!--Load--> ✅ |<!--Save-->  |
| [GIF](#) | Graphical Interchange Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ICO](#) | Icon File |<!--Load--> ✅ |<!--Save--> ✅ |
| [J2C](#) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [J2K](#) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [JP2](#) | JPEG 2000 Core Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPC](#) | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| [JPEG](#) | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPF](#) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [JPG](#) | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [JPM](#) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [JPX](#) | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| [ODG](#) | OpenDocument Graphic File |<!--Load--> ✅ |<!--Save-->  |
| [OTG](#) | OpenDocument Graphic Template |<!--Load--> ✅ |<!--Save-->  |
| [PNG](#) | Portable Network Graphic |<!--Load--> ✅ |<!--Save--> ✅ |
| [PSB](#) | Adobe Photoshop Big |<!--Load--> ✅ |<!--Save--> ✅ |
| [PSD](#) | Adobe Photoshop Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [SVGZ](#) | Compressed Scalable Vector Graphics File |<!--Load--> ✅ |<!--Save--> ✅ |
| [TGA](#) | Truevision TGA (TARGA) |<!--Load--> ✅ |<!--Save--> ✅ |
| [TIF](#) | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [TIFF](#) | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| [WEBP](#) | WebP Image |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMF](#) | Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| [WMZ](#) | Compressed Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |

## PDF
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [PDF](#) | Portable Document Format File |<!--Load--> ✅ |<!--Save--> ✅ |

## Presentation
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [FODP](#) | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [ODP](#) | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTP](#) | OpenDocument Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POT](#) | PowerPoint Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POTM](#) | PowerPoint Open XML Macro-Enabled Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [POTX](#) | PowerPoint Open XML Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPS](#) | PowerPoint Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPSM](#) | PowerPoint Open XML Macro-Enabled Slide |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPSX](#) | PowerPoint Open XML Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPT](#) | PowerPoint Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPTM](#) | PowerPoint Open XML Macro-Enabled Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| [PPTX](#) | PowerPoint Open XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |

## Spreadsheet
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [CSV](#) | Csv document format |<!--Load--> ✅ |<!--Save--> ✅ |
| [FODS](#) | OpenDocument Flat XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [NUMBERS](#) | Apple iWork Numbers |<!--Load--> ✅ |<!--Save-->  |
| [ODS](#) | OpenDocument Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTS](#) | OpenDocument Spreadsheet Template |<!--Load--> ✅ |<!--Save-->  |
| [SXC](#) | StarOffice Calc Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [TSV](#) | Tab Separated Values File |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLAM](#) | Microsoft Excel Add-in |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLS](#) | Excel Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSB](#) | Excel Binary Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSM](#) | Excel Open XML Macro-Enabled Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLSX](#) | Microsoft Excel Open XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLT](#) | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLTM](#) | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [XLTX](#) | Excel Open XML Spreadsheet Template |<!--Load--> ✅ |<!--Save--> ✅ |

## Word Processing
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| [DOC](#) | Microsoft Word Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOCM](#) | Word Open XML Macro-Enabled Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOCX](#) | Microsoft Word Open XML Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOT](#) | Word Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOTM](#) | Word Open XML Macro-Enabled Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [DOTX](#) | Word Open XML Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [MD](#) | Markdown Documentation File |<!--Load--> ✅ |<!--Save--> ✅ |
| [ODT](#) | OpenDocument Text Document |<!--Load--> ✅ |<!--Save--> ✅ |
| [OTT](#) | OpenDocument Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| [RTF](#) | Rich Text Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| [TXT](#) | Plain Text File |<!--Load--> ✅ |<!--Save--> ✅ |


---

## 

Path: /conversion/nodejs-java/_includes/supported-conversions/image/

| From | To |
| --- | --- |
| AI | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| BMP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CDR | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CMX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DIB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DICOM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DJVU | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ICO | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2C | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2K | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JP2 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPEG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SVGZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TGA | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIFF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WEBP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/nodejs-java/_includes/supported-conversions/pdf/

| From | To |
| --- | --- |
| PDF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/nodejs-java/_includes/supported-conversions/presentation/

| From | To |
| --- | --- |
| FODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/nodejs-java/_includes/supported-conversions/spreadsheet/

| From | To |
| --- | --- |
| CSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| NUMBERS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SXC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLAM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/nodejs-java/_includes/supported-conversions/word-processing/

| From | To |
| --- | --- |
| DOC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| RTF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TXT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/3d/

| From | To |
| --- | --- |
| 3DS | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| 3MF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| AMF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| ASE | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| DAE | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| DRC | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| FBX | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| GLTF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| JT | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| OBJ | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| PLY | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| RVM | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| U3D | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| USD | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| USDZ | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| VRML | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |
| X | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/cad/

| From | To |
| --- | --- |
| CF2 | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DGN | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWFX | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWG | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DWT | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DXF | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| IFC | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| IGS | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PLT | 3D: [3DS](https://docs.fileformat.com/3d/3ds/), [AMF](https://docs.fileformat.com/3d/amf/), [DAE](https://docs.fileformat.com/3d/dae/), [DRC](https://docs.fileformat.com/3d/drc/), [FBX](https://docs.fileformat.com/3d/fbx/), [GLTF](https://docs.fileformat.com/3d/gltf/), [OBJ](https://docs.fileformat.com/3d/obj/), [PLY](https://docs.fileformat.com/3d/ply/), [RVM](https://docs.fileformat.com/3d/rvm/), [U3D](https://docs.fileformat.com/3d/u3d/)<br/> CAD: [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| STL | CAD: [DWF](https://docs.fileformat.com/cad/dwf/), [DXF](https://docs.fileformat.com/cad/dxf/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/compression/

| From | To |
| --- | --- |
| 7Z | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| BZ2 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CAB | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CPIO | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GZIP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| LZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| LZMA | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| RAR | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TAR | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| Z | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ZIP | Compression: [7Z](https://docs.fileformat.com/compression/7z/), [BZ2](https://docs.fileformat.com/compression/bz2/), CPIO, [GZ](https://docs.fileformat.com/compression/gz/), GZIP, [LZ](https://docs.fileformat.com/compression/lz/), [TAR](https://docs.fileformat.com/compression/tar/), XZ, [Z](https://docs.fileformat.com/compression/z/), [ZIP](https://docs.fileformat.com/compression/zip/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/database/

| From | To |
| --- | --- |
| LOG | Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| NSF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SQL | Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/diagram/

| From | To |
| --- | --- |
| VDX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSD | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSDM | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSDX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSS | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSSM | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSSX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VST | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSTM | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSTX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VSX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VTX | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/ebook/

| From | To |
| --- | --- |
| AZW3 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EPUB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MOBI | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/email-and-outlook/

| From | To |
| --- | --- |
| EML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMLX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MBOX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MSG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OLM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OST | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PST | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Email and Outlook: [EML](https://docs.fileformat.com/email/eml/), [EMLX](https://docs.fileformat.com/email/emlx/), [MSG](https://docs.fileformat.com/email/msg/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VCF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/finance/

| From | To |
| --- | --- |
| IXBRL | Finance: [IXBRL](https://docs.fileformat.com/web/ixbrl/), [XBRL](https://docs.fileformat.com/web/xbrl/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/>  |
| XBRL | Finance: [IXBRL](https://docs.fileformat.com/web/ixbrl/), [XBRL](https://docs.fileformat.com/web/xbrl/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/font/

| From | To |
| --- | --- |
| CFF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| EOT | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| OTF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| PFB | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| TTF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| WOFF | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |
| WOFF2 | Font: [TTF](https://docs.fileformat.com/font/ttf/), [WOFF](https://docs.fileformat.com/font/woff/), WOFF2<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/formats-brief/

## 3D
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| 3DS | 3D Studio |<!--Load--> ✅ |<!--Save--> ✅ |
| 3MF | Microsoft 3D Manufacturing Format |<!--Load--> ✅ |<!--Save-->  |
| AMF | Additive manufacturing file format |<!--Load--> ✅ |<!--Save--> ✅ |
| ASE | 3D Studio Max’s ASCII Scene Exporter format |<!--Load--> ✅ |<!--Save-->  |
| DAE | Collada |<!--Load--> ✅ |<!--Save--> ✅ |
| DRC | Google Draco |<!--Load--> ✅ |<!--Save--> ✅ |
| FBX | FilmBox format |<!--Load--> ✅ |<!--Save--> ✅ |
| GLTF | Khronos Group’s glTF |<!--Load--> ✅ |<!--Save--> ✅ |
| JT | Siemens JT File |<!--Load--> ✅ |<!--Save-->  |
| OBJ | Wavefront Obj |<!--Load--> ✅ |<!--Save--> ✅ |
| PLY | Polygon File Format or Stanford Triangle Format |<!--Load--> ✅ |<!--Save--> ✅ |
| RVM | AVEVA Plant Design Management System Model |<!--Load--> ✅ |<!--Save--> ✅ |
| U3D | Universal3D |<!--Load--> ✅ |<!--Save--> ✅ |
| USD | Universal Scene Description |<!--Load--> ✅ |<!--Save-->  |
| USDZ | Universal Scene Description Archive |<!--Load--> ✅ |<!--Save-->  |
| VRML | The Virtual Reality Modeling Language |<!--Load--> ✅ |<!--Save-->  |
| X | DirectX’s X file |<!--Load--> ✅ |<!--Save-->  |

## CAD
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| CF2 | Common File Format File |<!--Load--> ✅ |<!--Save-->  |
| DGN | MicroStation Design File |<!--Load--> ✅ |<!--Save-->  |
| DWF | Design Web Format File |<!--Load--> ✅ |<!--Save-->  |
| DWFX | Design Web Format File |<!--Load--> ✅ |<!--Save-->  |
| DWG | AutoCAD Drawing Database File |<!--Load--> ✅ |<!--Save-->  |
| DWT | AutoCAD Drawing Template |<!--Load--> ✅ |<!--Save-->  |
| DXF | Drawing Exchange Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| IFC | Industry Foundation Classes File |<!--Load--> ✅ |<!--Save-->  |
| IGS | Initial Graphics Exchange Specification (IGES) |<!--Load--> ✅ |<!--Save-->  |
| PLT | PLT (HPGL) |<!--Load--> ✅ |<!--Save-->  |
| STL | Stereolithography File |<!--Load--> ✅ |<!--Save-->  |

## Compression
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| 7Z | 7-Zip Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| BZ2 | Bzip2 Compressed File |<!--Load--> ✅ |<!--Save-->  |
| CAB | Windows Cabinet File |<!--Load--> ✅ |<!--Save-->  |
| CPIO | CPIO Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |
| GZ | Gnu Zipped Archive |<!--Load--> ✅ |<!--Save-->  |
| GZIP | Gzip Compressed File |<!--Load--> ✅ |<!--Save-->  |
| LZ | Lzip Compressed File |<!--Load--> ✅ |<!--Save-->  |
| LZMA | LZMA Compressed File |<!--Load--> ✅ |<!--Save-->  |
| RAR | RAR Compressed Archive |<!--Load--> ✅ |<!--Save-->  |
| TAR | Consolidated Unix File Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| XZ | Xz Compressed File |<!--Load--> ✅ |<!--Save-->  |
| Z | Unix Compressed File |<!--Load--> ✅ |<!--Save-->  |
| ZIP | ZIP Compressed File |<!--Load--> ✅ |<!--Save--> ✅ |

## Database
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| LOG | Log File |<!--Load--> ✅ |<!--Save-->  |
| NSF | Lotus Notes Storage Format |<!--Load--> ✅ |<!--Save-->  |
| SQL | Sql File |<!--Load--> ✅ |<!--Save-->  |

## Diagram
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| VDX | Visio Drawing XML File |<!--Load--> ✅ |<!--Save--> ✅ |
| VSD | Visio Drawing File |<!--Load--> ✅ |<!--Save-->  |
| VSDM | Visio Macro-Enabled Drawing |<!--Load--> ✅ |<!--Save--> ✅ |
| VSDX | Visio Drawing File |<!--Load--> ✅ |<!--Save--> ✅ |
| VSS | Visio Stencil File |<!--Load--> ✅ |<!--Save-->  |
| VSSM | Visio Macro-Enabled Stencil File |<!--Load--> ✅ |<!--Save--> ✅ |
| VSSX | Visio Stencil File |<!--Load--> ✅ |<!--Save--> ✅ |
| VST | Visio Drawing Template |<!--Load--> ✅ |<!--Save-->  |
| VSTM | Visio Macro-Enabled Drawing Template |<!--Load--> ✅ |<!--Save--> ✅ |
| VSTX | Visio Drawing Template |<!--Load--> ✅ |<!--Save--> ✅ |
| VSX | Visio Stencil XML File |<!--Load--> ✅ |<!--Save--> ✅ |
| VTX | Visio Template XML File |<!--Load--> ✅ |<!--Save--> ✅ |

## eBook
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| AZW3 | Amazon Kindle’s proprietary e-book file format |<!--Load--> ✅ |<!--Save--> ✅ |
| EPUB | Open eBook File |<!--Load--> ✅ |<!--Save--> ✅ |
| MOBI | Mobipocket eBook |<!--Load--> ✅ |<!--Save--> ✅ |

## Email and Outlook
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| EML | E-Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| EMLX | Apple Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| MBOX | Mbox document format |<!--Load--> ✅ |<!--Save-->  |
| MSG | Outlook Mail Message |<!--Load--> ✅ |<!--Save--> ✅ |
| OLM | Microsoft Outlook file for Mac Operating System. |<!--Load--> ✅ |<!--Save-->  |
| OST | Outlook Offline Data File |<!--Load--> ✅ |<!--Save-->  |
| PST | Outlook Personal Information Store File |<!--Load--> ✅ |<!--Save-->  |
| VCF | Vcf document format |<!--Load--> ✅ |<!--Save-->  |

## Finance
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| IXBRL | Inline XBRL. |<!--Load--> ✅ |<!--Save--> ✅ |
| XBRL | Extensible Business Reporting Language. |<!--Load--> ✅ |<!--Save--> ✅ |

## Font
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| CFF | Compact Font Format |<!--Load--> ✅ |<!--Save-->  |
| EOT | Embedded OpenType Font Format |<!--Load--> ✅ |<!--Save-->  |
| OTF | OpenType font |<!--Load--> ✅ |<!--Save-->  |
| PFB | PostScript Fonts |<!--Load--> ✅ |<!--Save-->  |
| TTF | TrueType Font |<!--Load--> ✅ |<!--Save--> ✅ |
| WOFF | Web Open Font Format |<!--Load--> ✅ |<!--Save--> ✅ |
| WOFF2 | Web Open Font Format 2 |<!--Load--> ✅ |<!--Save--> ✅ |

## GIS
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| GEOJSON | JSON based Geographic File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| GML | Geography Markup Language File Format |<!--Load--> ✅ |<!--Save-->  |
| GPX | GPS Exchange File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| KML | Keyhole Markup Language |<!--Load--> ✅ |<!--Save--> ✅ |
| OSM | OpenStreetMap File Format |<!--Load--> ✅ |<!--Save-->  |
| TOPOJSON | JSON based Topology File Format |<!--Load--> ✅ |<!--Save--> ✅ |

## Image
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| AI | Adobe Illustrator Artwork |<!--Load--> ✅ |<!--Save-->  |
| BMP | Bitmap Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| CDR | CorelDraw Vector Graphic Drawing |<!--Load--> ✅ |<!--Save-->  |
| CMX | Corel Metafile Exchange |<!--Load--> ✅ |<!--Save-->  |
| DCM | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| DIB | Device Independent Bitmap File |<!--Load--> ✅ |<!--Save-->  |
| DICOM | DICOM Image |<!--Load--> ✅ |<!--Save--> ✅ |
| DJVU | DjVu Image |<!--Load--> ✅ |<!--Save-->  |
| DNG | Digital Negative Specification |<!--Load--> ✅ |<!--Save-->  |
| EMF | Enhanced Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| EMZ | Windows Compressed Enhanced Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| FODG | Flat XML ODF Template |<!--Load--> ✅ |<!--Save-->  |
| GIF | Graphical Interchange Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| ICO | Icon File |<!--Load--> ✅ |<!--Save--> ✅ |
| J2C | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| J2K | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| JP2 | JPEG 2000 Core Image File |<!--Load--> ✅ |<!--Save--> ✅ |
| JPC | JPEG 2000 Code Stream |<!--Load--> ✅ |<!--Save-->  |
| JPEG | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| JPF | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| JPG | JPEG Image |<!--Load--> ✅ |<!--Save--> ✅ |
| JPM | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| JPX | JPEG 2000 Image File |<!--Load--> ✅ |<!--Save-->  |
| ODG | OpenDocument Graphic File |<!--Load--> ✅ |<!--Save-->  |
| OTG | OpenDocument Graphic Template |<!--Load--> ✅ |<!--Save-->  |
| PNG | Portable Network Graphic |<!--Load--> ✅ |<!--Save--> ✅ |
| PSB | Adobe Photoshop Big |<!--Load--> ✅ |<!--Save--> ✅ |
| PSD | Adobe Photoshop Document |<!--Load--> ✅ |<!--Save--> ✅ |
| SVGZ | Compressed Scalable Vector Graphics File |<!--Load--> ✅ |<!--Save--> ✅ |
| TGA | Truevision TGA (TARGA) |<!--Load--> ✅ |<!--Save--> ✅ |
| TIF | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| TIFF | Tagged Image File Format |<!--Load--> ✅ |<!--Save--> ✅ |
| WEBP | WebP Image |<!--Load--> ✅ |<!--Save--> ✅ |
| WMF | Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |
| WMZ | Compressed Windows Metafile |<!--Load--> ✅ |<!--Save--> ✅ |

## Note
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| ONE | OneNote Document |<!--Load--> ✅ |<!--Save-->  |

## Page Description Language
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| CGM | Computer Graphics Metafile |<!--Load--> ✅ |<!--Save-->  |
| EPS | Encapsulated PostScript File |<!--Load--> ✅ |<!--Save--> ✅ |
| OXPS | XML Paper Specification File |<!--Load--> ✅ |<!--Save-->  |
| PCL | Printer Command Language Document |<!--Load--> ✅ |<!--Save--> ✅ |
| PS | PostScript File |<!--Load--> ✅ |<!--Save--> ✅ |
| SVG | Scalable Vector Graphics File |<!--Load--> ✅ |<!--Save--> ✅ |
| TEX | LaTeX Source Document |<!--Load--> ✅ |<!--Save--> ✅ |
| XPS | XML Paper Specification File |<!--Load--> ✅ |<!--Save--> ✅ |

## PDF
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| PDF | Portable Document Format File |<!--Load--> ✅ |<!--Save--> ✅ |

## Presentation
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| FODP | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| ODP | OpenDocument Flat XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| OTP | OpenDocument Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| POT | PowerPoint Template |<!--Load--> ✅ |<!--Save--> ✅ |
| POTM | PowerPoint Open XML Macro-Enabled Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| POTX | PowerPoint Open XML Presentation Template |<!--Load--> ✅ |<!--Save--> ✅ |
| PPS | PowerPoint Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| PPSM | PowerPoint Open XML Macro-Enabled Slide |<!--Load--> ✅ |<!--Save--> ✅ |
| PPSX | PowerPoint Open XML Slide Show |<!--Load--> ✅ |<!--Save--> ✅ |
| PPT | PowerPoint Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| PPTM | PowerPoint Open XML Macro-Enabled Presentation |<!--Load--> ✅ |<!--Save--> ✅ |
| PPTX | PowerPoint Open XML Presentation |<!--Load--> ✅ |<!--Save--> ✅ |

## Project Management
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| MPP | Microsoft Project File |<!--Load--> ✅ |<!--Save--> ✅ |
| MPT | Microsoft Project Template |<!--Load--> ✅ |<!--Save-->  |
| MPX | Microsoft Project Exchange File |<!--Load--> ✅ |<!--Save--> ✅ |
| XER | Primavera XER format |<!--Load--> ✅ |<!--Save--> ✅ |

## Publisher
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| PUB | Microsoft Publisher format |<!--Load--> ✅ |<!--Save-->  |

## Spreadsheet
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| CSV | Csv document format |<!--Load--> ✅ |<!--Save--> ✅ |
| FODS | OpenDocument Flat XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| NUMBERS | Apple iWork Numbers |<!--Load--> ✅ |<!--Save-->  |
| ODS | OpenDocument Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| OTS | OpenDocument Spreadsheet Template |<!--Load--> ✅ |<!--Save-->  |
| SXC | StarOffice Calc Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| TSV | Tab Separated Values File |<!--Load--> ✅ |<!--Save--> ✅ |
| XLAM | Microsoft Excel Add-in |<!--Load--> ✅ |<!--Save--> ✅ |
| XLS | Excel Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| XLSB | Excel Binary Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| XLSM | Excel Open XML Macro-Enabled Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| XLSX | Microsoft Excel Open XML Spreadsheet |<!--Load--> ✅ |<!--Save--> ✅ |
| XLT | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| XLTM | Microsoft Excel Macro-Enabled Template |<!--Load--> ✅ |<!--Save--> ✅ |
| XLTX | Excel Open XML Spreadsheet Template |<!--Load--> ✅ |<!--Save--> ✅ |

## Web
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| CHM | CHM File |<!--Load--> ✅ |<!--Save-->  |
| HTM | Hypertext Markup Language File |<!--Load--> ✅ |<!--Save--> ✅ |
| HTML | Hypertext Markup Language File |<!--Load--> ✅ |<!--Save--> ✅ |
| JSON | Json File |<!--Load--> ✅ |<!--Save--> ✅ |
| MHT | MHTML Web Archive |<!--Load--> ✅ |<!--Save--> ✅ |
| MHTML | MIME HTML File |<!--Load--> ✅ |<!--Save--> ✅ |
| VDW | Visio Web Drawing |<!--Load--> ✅ |<!--Save-->  |
| XML | XML File |<!--Load--> ✅ |<!--Save--> ✅ |

## Word Processing
| From | Description | Load | Save |
| --- | --- | :---: | :---: |
| DOC | Microsoft Word Document |<!--Load--> ✅ |<!--Save--> ✅ |
| DOCM | Word Open XML Macro-Enabled Document |<!--Load--> ✅ |<!--Save--> ✅ |
| DOCX | Microsoft Word Open XML Document |<!--Load--> ✅ |<!--Save--> ✅ |
| DOT | Word Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| DOTM | Word Open XML Macro-Enabled Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| DOTX | Word Open XML Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| MD | Markdown Documentation File |<!--Load--> ✅ |<!--Save--> ✅ |
| ODT | OpenDocument Text Document |<!--Load--> ✅ |<!--Save--> ✅ |
| OTT | OpenDocument Document Template |<!--Load--> ✅ |<!--Save--> ✅ |
| RTF | Rich Text Format File |<!--Load--> ✅ |<!--Save--> ✅ |
| TXT | Plain Text File |<!--Load--> ✅ |<!--Save--> ✅ |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/gis/

| From | To |
| --- | --- |
| GEOJSON | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), TOPOJSON<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), TOPOJSON<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), TOPOJSON<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| KML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), TOPOJSON<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), TOPOJSON<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TOPOJSON | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> GIS: [GEOJSON](https://docs.fileformat.com/gis/geojson/), [GPX](https://docs.fileformat.com/gis/gpx/), [KML](https://docs.fileformat.com/gis/kml/), TOPOJSON<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/image/

| From | To |
| --- | --- |
| AI | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| BMP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CDR | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| CMX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DIB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DICOM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DJVU | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| GIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ICO | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2C | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| J2K | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JP2 | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPEG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PNG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PSD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SVGZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TGA | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TIFF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WEBP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| WMZ | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/note/

| From | To |
| --- | --- |
| ONE | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/page-description-language/

| From | To |
| --- | --- |
| CGM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| EPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OXPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PCL | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SVG | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TEX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/pdf/

| From | To |
| --- | --- |
| PDF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/presentation/

| From | To |
| --- | --- |
| FODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| POTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| PPTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/project-management/

| From | To |
| --- | --- |
| MPP | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MPT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MPX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XER | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Project Management: [MPP](https://docs.fileformat.com/project-management/mpp/), [MPX](https://docs.fileformat.com/project-management/mpx/), [XER](https://docs.fileformat.com/project-management/xer/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/publisher/

| From | To |
| --- | --- |
| PUB | PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/spreadsheet/

| From | To |
| --- | --- |
| CSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| FODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| NUMBERS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| SXC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TSV | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLAM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLS | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSB | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLSX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XLTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/web/

| From | To |
| --- | --- |
| CHM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| HTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| HTML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| JSON | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MHT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MHTML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| VDW | Diagram: [VDX](https://docs.fileformat.com/image/vdx/), [VSDM](https://docs.fileformat.com/image/vsdm/), [VSDX](https://docs.fileformat.com/image/vsdx/), [VSSM](https://docs.fileformat.com/image/vssm/), [VSSX](https://docs.fileformat.com/image/vssx/), [VSTM](https://docs.fileformat.com/image/vstm/), [VSTX](https://docs.fileformat.com/image/vstx/), [VSX](https://docs.fileformat.com/image/vsx/), [VTX](https://docs.fileformat.com/image/vtx/)<br/> eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| XML | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [JSON](https://docs.fileformat.com/web/json/), [XML](https://docs.fileformat.com/web/xml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /conversion/python-net/_includes/supported-conversions/word-processing/

| From | To |
| --- | --- |
| DOC | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOCX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTM | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| DOTX | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| MD | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| ODT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| OTT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| RTF | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |
| TXT | eBook: [AZW3](https://docs.fileformat.com/ebook/azw3/), [EPUB](https://docs.fileformat.com/ebook/epub/), [MOBI](https://docs.fileformat.com/ebook/mobi/)<br/> Image: [BMP](https://docs.fileformat.com/image/bmp/), [DCM](https://docs.fileformat.com/image/dcm/), [DICOM](https://docs.fileformat.com/image/dicom/), [EMF](https://docs.fileformat.com/image/emf/), [EMZ](https://docs.fileformat.com/image/emz/), [GIF](https://docs.fileformat.com/image/gif/), [ICO](https://docs.fileformat.com/image/ico/), [JP2](https://docs.fileformat.com/image/jp2/), [JPEG](https://docs.fileformat.com/image/jpeg/), JPG, [PNG](https://docs.fileformat.com/image/png/), [PSB](https://docs.fileformat.com/image/psb/), [PSD](https://docs.fileformat.com/image/psd/), [SVGZ](https://docs.fileformat.com/image/svgz/), [TGA](https://docs.fileformat.com/image/tga/), TIF, [TIFF](https://docs.fileformat.com/image/tiff/), [WEBP](https://docs.fileformat.com/image/webp/), [WMF](https://docs.fileformat.com/image/wmf/), [WMZ](https://docs.fileformat.com/image/wmz/)<br/> Page Description Language: [EPS](https://docs.fileformat.com/page-description-language/eps/), [PCL](https://docs.fileformat.com/page-description-language/pcl/), [PS](https://docs.fileformat.com/page-description-language/ps/), [SVG](https://docs.fileformat.com/page-description-language/svg/), [TEX](https://docs.fileformat.com/page-description-language/tex/), [XPS](https://docs.fileformat.com/page-description-language/xps/)<br/> PDF: [PDF](https://docs.fileformat.com/view/pdf/)<br/> Presentation: FODP, [ODP](https://docs.fileformat.com/presentation/odp/), [OTP](https://docs.fileformat.com/presentation/otp/), [POT](https://docs.fileformat.com/presentation/pot/), [POTM](https://docs.fileformat.com/presentation/potm/), [POTX](https://docs.fileformat.com/presentation/potx/), [PPS](https://docs.fileformat.com/presentation/pps/), [PPSM](https://docs.fileformat.com/presentation/ppsm/), [PPSX](https://docs.fileformat.com/presentation/ppsx/), [PPT](https://docs.fileformat.com/presentation/ppt/), [PPTM](https://docs.fileformat.com/presentation/pptm/), [PPTX](https://docs.fileformat.com/presentation/pptx/)<br/> Spreadsheet: [CSV](https://docs.fileformat.com/spreadsheet/csv/), [DIF](https://docs.fileformat.com/spreadsheet/dif/), [FODS](https://docs.fileformat.com/spreadsheet/fods/), [ODS](https://docs.fileformat.com/spreadsheet/ods/), [SXC](https://docs.fileformat.com/spreadsheet/sxc/), [TSV](https://docs.fileformat.com/spreadsheet/tsv/), [XLAM](https://docs.fileformat.com/spreadsheet/xlam/), [XLS](https://docs.fileformat.com/spreadsheet/xls/), [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/), [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/), [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/), [XLT](https://docs.fileformat.com/spreadsheet/xlt/), [XLTM](https://docs.fileformat.com/spreadsheet/xltm/), [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)<br/> Web: [HTM](https://docs.fileformat.com/web/htm/), [HTML](https://docs.fileformat.com/web/html/), [MHT](https://docs.fileformat.com/web/mht/), [MHTML](https://docs.fileformat.com/web/mhtml/)<br/> Word Processing: [DOC](https://docs.fileformat.com/word-processing/doc/), [DOCM](https://docs.fileformat.com/word-processing/docm/), [DOCX](https://docs.fileformat.com/word-processing/docx/), [DOT](https://docs.fileformat.com/word-processing/dot/), [DOTM](https://docs.fileformat.com/word-processing/dotm/), [DOTX](https://docs.fileformat.com/word-processing/dotx/), [MD](https://docs.fileformat.com/word-processing/md/), [ODT](https://docs.fileformat.com/word-processing/odt/), [OTT](https://docs.fileformat.com/word-processing/ott/), [RTF](https://docs.fileformat.com/word-processing/rtf/), [TXT](https://docs.fileformat.com/word-processing/txt/)<br/>  |


---

## 

Path: /parser/net/developer-guide/advanced-usage/extract-data-from-various-formats/extract-data-from-html-documents/search-text-in-html-documents/


id: search-text-in-html-documents
url: parser/net/search-text-in-html-documents
title: Search text in HTML documents
weight: 2
description: "To search a keyword in HTML documents Search(String) method is used. This method returns the collection of SearchResult objects."
keywords: search a keyword, search a keyword in HTML
productName: GroupDocs.Parser for .NET
hideChildren: False
toc: true

To search a keyword in HTML documents [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method is used. This method returns the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects. For details, see [Search Text]({{< ref "parser/net/developer-guide/advanced-usage/working-with-text/search-text.md" >}}).

{{< alert style="warning" >}}
Parsing does not execute JavaScript or fetch external content; for dynamically generated HTML, pre-render or extract the actual text content before searching.
{{< /alert >}}

Here are the steps to search a keyword in HTML document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Call [Search(string)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

{{< alert style="warning" >}}
[Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null* value if search isn't supported for the document. For example, text extraction isn't supported for Zip archive. Therefore, for Zip archive [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns *null*. For empty HTML document [Search(String)](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser/methods/search) method returns an empty collection.
{{< /alert >}}

The following example shows how to find a keyword in HTML document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search a keyword:
    IEnumerable<SearchResult> sr = parser.Search("page number");
   
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

[Search(String, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) is used for the advanced search in HTML documents - like search with regular expressions. [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) parameter is used to customize a search.

Here are the steps to search with a regular expression in HTML document:

*   Instantiate [Parser](https://reference.groupdocs.com/net/parser/groupdocs.parser/parser) object for the initial document;
*   Instantiate [SearchOptions](https://reference.groupdocs.com/net/parser/groupdocs.parser.options/searchoptions) object with the parameters for the search;
*   Call [Search(string, SearchOptions)](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method and obtain the collection of [SearchResult](https://reference.groupdocs.com/net/parser/groupdocs.parser.data/searchresult) objects;
*   Iterate through the collection and get the position and text.

The following example shows how to search with a regular expression in HTML document:

```csharp
// Create an instance of Parser class
using(Parser parser = new Parser(filePath))
{
    // Search with a regular expression with case matching
    IEnumerable<SearchResult> sr = parser.Search("page number: [0-9]+", new SearchOptions(true, false, true));
    // Iterate over search results
    foreach(SearchResult s in sr)
    {
        // Print an index and found text:
        Console.WriteLine(string.Format("At {0}: {1}", s.Position, s.Text));
    }
}
```

### Null vs. Empty Collection Results

The [Search()](https://reference.groupdocs.com/net/parser/groupdocs.parser.parser/search/methods/1) method behaves differently depending on the document type and its text content:

- **Returns `null`** → when the document type does not support searching (e.g., ZIP archives, images, or other non-text formats).  
- **Returns an empty collection** → when the document supports searching (like HTML) but contains no searchable text.  


### Example 1: Search in a non-searchable document (returns `null`)
```csharp
using (Parser parser = new Parser("sample.zip")) // ZIP archives are not searchable
{
    var results = parser.Search("example");    
    
    if (results == null)
        Console.WriteLine("Search returned null: document type does not support searching.");
}
```

### Example 2: Search in an empty HTML file (returns empty collection)
```csharp
using (Parser parser = new Parser("empty.html")) // Empty HTML without text
{
    var results = parser.Search("example");
    if (results != null && results.Count == 0)
        Console.WriteLine("Search returned empty collection: no text found in the document.");
}
```

### Example 3: Search in a valid HTML file (returns results)
```csharp
using (Parser parser = new Parser("sample.html")) // Contains text
{
    var results = parser.Search("example");
    if (results != null)
    {
        foreach (var result in results)
            Console.WriteLine($"Found: '{result.Text}' at position {result.Position}");
    }
}
```

## Preprocessing Recommendations

GroupDocs.Parser works with the **raw text content** of HTML documents.  
It does **not** execute JavaScript or load external resources (such as CSS, images, or scripts).  
If your HTML file relies on JavaScript to generate content dynamically, the parser may return an empty collection.

To improve results, consider the following preprocessing steps:

### 1. Use Pre-rendered HTML
Ensure that the HTML file you provide already contains the visible text content.  
If your HTML is generated by a web application, save or export the **fully rendered** version of the page before passing it to the parser.

### 2. Remove Unnecessary Markup
If possible, simplify your HTML by removing scripts, styles, or metadata that do not affect the visible text.  
This reduces noise and makes search results more accurate.

### 3. Normalize Encodings
Verify that the HTML file uses a standard encoding (such as UTF-8).  
Unexpected or inconsistent encodings may cause missing or unreadable text when searching.

### 4. Validate Text Presence
If search results are empty, open the HTML file in a text editor to confirm whether actual text is present in the markup.  
If the content only appears after running JavaScript in a browser, it will not be searchable.

**Summary**:  
Provide **static, text-based HTML** whenever possible.  
Dynamic or script-driven HTML will not yield results unless converted into plain text or pre-rendered before parsing.


## More resources

### GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

*   [GroupDocs.Parser for .NET examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-.NET)    
*   [GroupDocs.Parser for Java examples](https://github.com/groupdocs-parser/GroupDocs.Parser-for-Java)    

### Free online document parser App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online [Free Online Document Parser App](https://products.groupdocs.app/parser).
---

## 

Path: /signature/python-net/_includes/supported-signature/formats-brief/


| Format                                       | Description                                 | Barcode | Digital | FormField | Image  | Metadata | QR‑code | Stamp  | Text   |
|----------------------------------------------|---------------------------------------------|:-------:|:-------:|:---------:|:------:|:--------:|:-------:|:------:|:------:|
| [BMP](https://docs.fileformat.com/image/bmp/)               | Bitmap Picture (BMP)                       | ✅      |         |           | ✅     |          | ✅      | ✅     | ✅     |
| [CDR](https://docs.fileformat.com/image/cdr/)               | CorelDraw Vector Graphic Drawing (CDR)     | ✅      |         |           | ✅     |          | ✅      | ✅     | ✅     |
| [CMX](https://docs.fileformat.com/image/cmx/)               | Corel Metafile eXchange Image              | ✅      |         |           | ✅     |          | ✅      | ✅     | ✅     |
| [DJVU](https://docs.fileformat.com/image/djvu/)            | Deja Vu (DjVu)                             | ✅      |         |           | ✅     |          | ✅      | ✅     | ✅     |
| [GIF](https://docs.fileformat.com/image/gif/)               | Graphics Interchange Format (GIF)          | ✅      |         |           | ✅     |          | ✅      | ✅     | ✅     |
| [JPG/JPEG](https://docs.fileformat.com/image/jpeg/)         | Joint Photographic Experts Group (JPEG)    | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PNG](https://docs.fileformat.com/image/png/)               | Portable Network Graphics (PNG)            | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PSD](https://docs.fileformat.com/image/psd/)               | Adobe Photoshop Document (PSD)             | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [SVG](https://docs.fileformat.com/page-description-language/svg/) | Scalable Vector Graphics (SVG)       | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [TIF/TIFF](https://docs.fileformat.com/specification/image/tiff/) | Tagged Image File Format (TIFF)      | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [WEBP](https://docs.fileformat.com/image/webp/)            | WebP Image                                  | ✅      |         |           | ✅     |          | ✅      | ✅     | ✅     |
| [WMF](https://docs.fileformat.com/image/wmf/)               | Windows Metafile (WMF)                     | ✅      |         |           | ✅     |          | ✅      | ✅     | ✅     |
| [PDF](https://docs.fileformat.com/pdf/)                     | Adobe Portable Document Format (PDF)       | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [ODP](https://docs.fileformat.com/presentation/odp/)         | OpenDocument Presentation                  | ✅      |         | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [OTP](https://docs.fileformat.com/presentation/otp/)         | OpenDocument Presentation Template         | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [POTM](https://docs.fileformat.com/presentation/potm/)       | PowerPoint Macro‑Enabled Template (POTM)   | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [POTX](https://docs.fileformat.com/presentation/potx/)       | PowerPoint Template (POTX)                 | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PPS](https://docs.fileformat.com/presentation/pps/)         | PowerPoint 97‑2003 Slide Show (PPS)        | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PPSM](https://docs.fileformat.com/presentation/ppsm/)       | Macro‑Enabled Slide Show (PPSM)            | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PPSX](https://docs.fileformat.com/presentation/ppsx/)       | Slide Show (PPSX)                          | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PPT](https://docs.fileformat.com/presentation/ppt/)         | PowerPoint 97‑2003 Presentation (PPT)      | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PPTM](https://docs.fileformat.com/presentation/pptm/)       | Macro‑Enabled Presentation (PPTM)          | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [PPTX](https://docs.fileformat.com/presentation/pptx/)       | Presentation (PPTX)                        | ✅      |         |           | ✅     | ✅       | ✅      | ✅     | ✅     |
| [ODS](https://docs.fileformat.com/spreadsheet/ods/)         | OpenDocument Spreadsheet                   | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [OTS](https://docs.fileformat.com/spreadsheet/ots/)         | ODS Template (OTS)                         | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [XLSX](https://docs.fileformat.com/spreadsheet/xlsx/)       | Microsoft Excel Worksheet (XLSX)           | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [XLS](https://docs.fileformat.com/spreadsheet/xls/)         | Excel 97‑2003 Worksheet (XLS)              | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [XLSB](https://docs.fileformat.com/spreadsheet/xlsb/)       | Excel Binary Worksheet (XLSB)              | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [XLSM](https://docs.fileformat.com/spreadsheet/xlsm/)       | Macro‑Enabled Worksheet (XLSM)             | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [XLTX](https://docs.fileformat.com/spreadsheet/xltx/)       | Excel Template (XLTX)                      | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [XLTM](https://docs.fileformat.com/spreadsheet/xltm/)       | Macro‑Enabled Template (XLTM)              | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [DOC](https://docs.fileformat.com/word-processing/doc/)     | Word 97‑2003 Document (DOC)                | ✅      | ✅      | ✅        | ✅     | ✅       | ✅      | ✅     | ✅     |
| [DOCM](https://docs.fileformat.com/word-processing/docm/)   | Macro‑Enabled Document (DOCM)              | ✅      | ✅      | ✅        | ✅     |

---

## Quick start guide

Path: /markdown/net/quick-start-guide/


This guide shows you how to convert documents to Markdown with GroupDocs.Markdown for .NET. You'll have working code in under 2 minutes.

### How it works

{{< mermaid class="text-center" >}}
flowchart LR
    A["Input Document\n(DOCX, PDF, XLSX, EPUB, ...)"]
    B["MarkdownConverter"]
    C["Markdown Output\n(.md file or string)"]
    A --> B --> C
{{< /mermaid >}}

### Prerequisites

1. Install the NuGet package:

```bash
dotnet add package GroupDocs.Markdown
```

2. Add the namespace:
```csharp
using GroupDocs.Markdown;
```

### Example 1: Convert Word to Markdown

The simplest conversion — one line of code:

{{< tabs "qs-word-to-md">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

// Convert a Word document to Markdown
string markdown = MarkdownConverter.ToMarkdown("business-plan.docx");

// Or save directly to a file
MarkdownConverter.ToFile("business-plan.docx", "qs-word-to-md.md");
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}
{{< tab-text >}}
`business-plan.docx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "qs-word-to-md.md" >}}  
```text
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/getting-started/quick-start-guide/QsWordToMd/qs-word-to-md.md)
{{< /tab >}}
{{< /tabs >}}

### Example 2: Convert PDF with image export

Save a PDF to Markdown with images extracted to a folder:

{{< tabs "qs-pdf-with-images">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    ImageExportStrategy = new ExportImagesToFileSystemStrategy("output/images")
    {
        ImagesRelativePath = "images"
    }
};

MarkdownConverter.ToFile("business-plan.pdf", "output/report.md", options);
// Images saved to output/images/
// Markdown references: ![](images/img-001.png)
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}
{{< tab-text >}}
`business-plan.pdf` is a sample file used in this example. Click [here](/markdown/net/_sample_files/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "qs-pdf-with-images.zip" >}}  
```text
output/images/img-001.png (3 KB)
output/images/img-002.jpg (73 KB)
output/images/img-003.jpg (76 KB)
output/report.md (7 KB)
```
[Download full output](/markdown/net/_output_files/getting-started/quick-start-guide/QsPdfWithImages/qs-pdf-with-images.zip)
{{< /tab >}}
{{< /tabs >}}

### Example 3: Convert Excel with options

Convert a spreadsheet with column truncation and front matter:

{{< tabs "qs-excel-options">}}
{{< tab "C#" >}}
```csharp
using GroupDocs.Markdown;

var options = new ConvertOptions
{
    MaxColumns = 8,
    MaxRows = 50,
    IncludeFrontMatter = true,
    Flavor = MarkdownFlavor.GitHub
};

using var converter = new MarkdownConverter("cost-analysis.xlsx");

// Inspect before converting
DocumentInfo info = converter.GetDocumentInfo();
Console.WriteLine($"Worksheets: {info.PageCount}");

// Convert
ConvertResult result = converter.Convert("qs-excel-options.md", options);

// Check warnings
foreach (string w in result.Warnings)
    Console.WriteLine($"Warning: {w}");
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}
{{< tab-text >}}
`cost-analysis.xlsx` is a sample file used in this example. Click [here](/markdown/net/_sample_files/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "qs-excel-options.md" >}}  
```text
---
format: Xlsx
pages: 4
---


## Summary

| Category | FY2024 | FY2025 | FY2026 |
| --- | --- | --- | --- |
[TRUNCATED]
```
[Download full output](/markdown/net/_output_files/getting-started/quick-start-guide/QsExcelOptions/qs-excel-options.md)
{{< /tab >}}
{{< /tabs >}}

### What's next?

- [Supported document formats]({{< ref "markdown/net/getting-started/supported-document-formats.md" >}}) — full list of input formats
- [Image handling strategies]({{< ref "markdown/net/developer-guide/advanced-usage/strategy" >}}) — Base64, file system, skip, custom
- [Markdown flavor control]({{< ref "markdown/net/developer-guide/advanced-usage/markdown-flavor.md" >}}) — GitHub vs CommonMark
- [YAML front matter]({{< ref "markdown/net/developer-guide/advanced-usage/front-matter.md" >}}) — for static site generators

---

## Quick start guide

Path: /markdown/python-net/quick-start-guide/


This guide shows you how to convert documents to Markdown with GroupDocs.Markdown for Python via .NET. You'll have working code in under 2 minutes.

### How it works

{{< mermaid class="text-center" >}}
flowchart LR
    A["Input Document\n(DOCX, PDF, XLSX, EPUB, ...)"]
    B["MarkdownConverter"]
    C["Markdown Output\n(.md file or string)"]
    A --> B --> C
{{< /mermaid >}}

### Prerequisites

1. Install the package from PyPI:

```bash
pip install groupdocs-markdown-net
```

2. Import the module:

{{< tabs "import-module">}}
{{< tab "import_module.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter
```
{{< /tab >}}
{{< /tabs >}}

### Example 1: Convert Word to Markdown

The simplest conversion -- one line of code:

{{< tabs "quick-start-word">}}
{{< tab "convert_word_to_markdown.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter

def convert_word_to_markdown():
    """Convert a Word document to Markdown in one line of code."""

    # Step 1: Convert a DOCX file to a Markdown string
    markdown = MarkdownConverter.to_markdown("business-plan.docx")

    # Step 2: Or save the result directly to a .md file
    MarkdownConverter.to_file("business-plan.docx", "convert-word.md")

if __name__ == "__main__":
    convert_word_to_markdown()
```
{{< /tab >}}
{{< tab "business-plan.docx" >}}  
{{< tab-text >}}
`business-plan.docx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/getting-started/business-plan.docx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "convert-word.txt" >}}  
```text
| HOME BASED |  |  |
| --- | --- | --- |
|  |  |  |
| PROFESSIONAL SERVICES |  |  |
|  | Business Plan |  |



|  | TABLE OF CONTENTS TOC \o "1-3" \h \z \u  HYPERLINK \l "_Toc9437451" Introduction	 PAGEREF _Toc9437451 \h 3  HYPERLINK \l "_Toc9437452" 1.	Executive Summary	 PAGEREF _Toc9437452 \h 5  HYPERLINK \l "_Toc9437453" 2.	Company Overview	 PAGEREF _Toc9437453 \h 6  HYPERLINK \l "_Toc9437454" 3.	Business Description	 PAGEREF _Toc9437454 \h 7  HYPERLINK \l "_Toc9437
...
```
[Download full output](/markdown/python-net/_output_files/getting-started/quick-start-guide/convert_word_to_markdown/convert-word.txt)
{{< /tab >}}
{{< tab "convert-word.txt" >}}  
```text
| ![Woman with laptop and business documents](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAHyAqYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIW
[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/getting-started/quick-start-guide/convert_word_to_markdown/convert-word.txt)
{{< /tab >}}
{{< /tabs >}}

### Example 2: Convert PDF with image export

Save a PDF to Markdown with images extracted to a folder:

{{< tabs "quick-start-pdf">}}
{{< tab "convert_pdf_with_images.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, ExportImagesToFileSystemStrategy

def convert_pdf_with_images():
    """Convert a PDF to Markdown with images exported to a folder on disk."""

    # Step 1: Configure image export with relative paths
    strategy = ExportImagesToFileSystemStrategy("output/images")
    strategy.images_relative_path = "images"

    # Step 2: Assign the strategy to conversion options
    options = ConvertOptions()
    options.image_export_strategy = strategy

    # Step 3: Convert and save using keyword argument for options
    MarkdownConverter.to_file("business-plan.pdf", "output/report.md", convert_options=options)
    # Images saved to output/images/
    # Markdown references: ![](images/img-001.png)

if __name__ == "__main__":
    import os
    os.makedirs("output/images", exist_ok=True)
    convert_pdf_with_images()
```
{{< /tab >}}
{{< tab "business-plan.pdf" >}}  
{{< tab-text >}}
`business-plan.pdf` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/getting-started/business-plan.pdf) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "convert-pdf-with-images.zip" >}}  
```text
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
output/images/img-010.png (438 bytes)
... (35 files total)
```
[Download full output](/markdown/python-net/_output_files/getting-started/quick-start-guide/convert_pdf_with_images/convert-pdf-with-images.zip)
{{< /tab >}}
{{< tab "convert-pdf-with-images.zip" >}}  
```text
output/images/img-001.jpg (60 KB)
output/images/img-002.png (470 bytes)
output/images/img-003.png (2 KB)
output/images/img-004.jpg (56 KB)
output/images/img-005.png (330 bytes)
output/images/img-006.png (438 bytes)
output/images/img-007.png (438 bytes)
output/images/img-008.png (438 bytes)
output/images/img-009.png (438 bytes)
output/images/img-010.png (438 bytes)
[TRUNCATED] (35 files total)
```
[Download full output](/markdown/python-net/_output_files/getting-started/quick-start-guide/convert_pdf_with_images/convert-pdf-with-images.zip)
{{< /tab >}}
{{< /tabs >}}

### Example 3: Convert Excel with options

Convert a spreadsheet with column truncation and front matter:

{{< tabs "quick-start-excel">}}
{{< tab "convert_excel_with_options.py" >}}  
```python
from groupdocs.markdown import MarkdownConverter, ConvertOptions, MarkdownFlavor

def convert_excel_with_options():
    """Convert an Excel spreadsheet with column/row limits, front matter, and GFM flavor."""

    # Step 1: Configure spreadsheet-specific conversion options
    options = ConvertOptions()
    options.max_columns = 8              # limit to first 8 columns
    options.max_rows = 50                # limit to first 50 data rows
    options.include_front_matter = True  # add YAML metadata block
    options.flavor = MarkdownFlavor.GIT_HUB  # GitHub Flavored Markdown

    # Step 2: Open the spreadsheet with a context manager
    with MarkdownConverter("cost-analysis.xlsx") as converter:
        # Step 3: Inspect document metadata before converting
        info = converter.get_document_info()
        print(f"Worksheets: {info.page_count}")

        # Step 4: Convert using keyword argument for options
        result = converter.convert("convert-excel-options.md", convert_options=options)

        # Step 5: Check for non-fatal conversion warnings
        for w in result.warnings:
            print(f"Warning: {w}")

if __name__ == "__main__":
    convert_excel_with_options()
```
{{< /tab >}}
{{< tab "cost-analysis.xlsx" >}}  
{{< tab-text >}}
`cost-analysis.xlsx` is sample file used in this example. Click [here](/markdown/python-net/_sample_files/getting-started/cost-analysis.xlsx) to download it.
{{< /tab-text >}}
{{< /tab >}}
{{< tab "convert-excel-options.txt" >}}  
```text
---
title: "Cost Analysis"
author: "GroupDocs"
format: Xlsx
pages: 1
---


## Cost data and chart

...
```
[Download full output](/markdown/python-net/_output_files/getting-started/quick-start-guide/convert_excel_with_options/convert-excel-options.txt)
{{< /tab >}}
{{< tab "convert-excel-options.txt" >}}  
```text
---
title: "Cost Analysis"
author: "GroupDocs"
format: Xlsx
pages: 1
---


## Cost data and chart

[TRUNCATED]
```
[Download full output](/markdown/python-net/_output_files/getting-started/quick-start-guide/convert_excel_with_options/convert-excel-options.txt)
{{< /tab >}}
{{< /tabs >}}

### What's next?

- [Supported document formats]({{< ref "markdown/python-net/getting-started/supported-document-formats.md" >}}) -- full list of input formats
- [Image handling strategies]({{< ref "markdown/python-net/developer-guide/advanced-usage/strategy" >}}) -- Base64, file system, skip, custom
- [Markdown flavor control]({{< ref "markdown/python-net/developer-guide/advanced-usage/markdown-flavor.md" >}}) -- GitHub vs CommonMark
- [YAML front matter]({{< ref "markdown/python-net/developer-guide/advanced-usage/front-matter.md" >}}) -- for static site generators

---

## Search index location

Path: /search/net/search-index-location/

This page contains information about index creation methods.

The GroupDocs.Search for .NET search index can be created and stored on disk or entirely in RAM. All changes to the on-disk index are automatically saved and available after it is loaded again. The in-memory index is faster, but uses more RAM and is completely destroyed when you finish working with it.

To create an in-memory index, you must use a constructor that does not have a path to the index folder in its parameter list. The created in-memory index can be converted to an on-disk index using the [SaveTo](https://reference.groupdocs.com/search/net/groupdocs.search/index/saveto/) method. This is useful when an in-memory index becomes too large and can no longer reside in RAM alone. After saving to disk, the index can then be loaded from disk as usual. Note that a regular index can be saved to disk in a different folder in the same way. Below is an example of creating an in-memory index and converting it to an on-disk index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating an in-memory index
Index index = new Index();

// Indexing documents from the specified folder
index.Add(documentsFolder);

// Saving the index to disk
index.SaveTo(indexFolder);

// Closing the in-memory index
index.Dispose();

// Opening the index from disk
index = new Index(indexFolder);

// Searching in the index
string query = "focus";
SearchResult result = index.Search(query);
```

To create or load an on-disk index, you must pass the path to the index folder through the constructor parameter. The created on-disk index can be converted to an in-memory index using the [LoadIntoMemoryCompletely](https://reference.groupdocs.com/search/net/groupdocs.search/index/loadintomemorycompletely/#loadintomemorycompletely) method. After the index is completely loaded into memory, no changes to it are automatically saved to disk. You must explicitly call the [SaveTo](https://reference.groupdocs.com/search/net/groupdocs.search/index/saveto/) method to save any changes to the index. Below is an example of creating an on-disk index and converting it to an in-memory index.

**C#**

```csharp
string indexFolder = @"c:\MyIndex\";
string documentsFolder = @"c:\MyDocuments\";

// Creating a regular index on disk
Index index = new Index(indexFolder);

// Indexing documents from the specified folder
index.Add(documentsFolder);

// Closing the regular index
index.Dispose();

// Loading the index entirely in memory for increased performance
Index inMemoryIndex = Index.LoadIntoMemoryCompletely(indexFolder);

// Searching in the index
string query = "focus";
SearchResult result = inMemoryIndex.Search(query);
```

## More resources

### GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

*   [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET)
    
*   [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java)
    

### Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).